refactor: replace as any type assertions with specific types across packages

Eliminate 18 problematic or improvable type assertions:
- Replace `as any` with `Record<string, unknown>`, specific interfaces, or type guards
- Add `RawContemberFieldDef` interface for SchemaRegistry normalization
- Use explicit generics on `analyzeChildren().getAll<T>()` instead of casting results
- Make `BlockDefinition.render` ref parameter nullable instead of casting undefined
- Return real collector proxy from `collectorProxy.getById()` instead of empty `as any`
- Introduce `CachedRelationHandle`/`CachedFieldHandle` interfaces in EntityHandle
- Use `as Partial<SlateElement>` for editor list transforms instead of `as any`

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: matej21

packages/bindx-client/src/schema/SchemaRegistry.ts

@@ -248,6 +248,14 @@ export class SchemaRegistry<TModels extends Record<string, object> = Record<stri
 	}
 }
 
+/** Raw field format from Contember SchemaNames (column/one/many with entity). */
+interface RawContemberFieldDef {
+	readonly type: string
+	readonly entity?: string
+	readonly target?: string
+	readonly inverse?: string
+}
+
 /**
  * Normalizes field definitions from Contember SchemaNames format
  * (column/one/many with entity) to bindx FieldDef format (scalar/hasOne/hasMany with target).
@@ -257,24 +265,23 @@ function normalizeEntityDef(entityDef: EntitySchemaDef): EntitySchemaDef {
 	let needsNormalization = false
 
 	for (const [fieldName, fieldDef] of Object.entries(entityDef.fields)) {
-		const raw = fieldDef as unknown as Record<string, unknown>
-		const type = raw['type'] as string
+		const raw = fieldDef as RawContemberFieldDef
 
-		if (type === 'column') {
+		if (raw.type === 'column') {
 			fields[fieldName] = { type: 'scalar' }
 			needsNormalization = true
-		} else if (type === 'one') {
+		} else if (raw.type === 'one') {
 			fields[fieldName] = {
 				type: 'hasOne',
-				target: (raw['entity'] as string) ?? (raw['target'] as string),
-				inverse: raw['inverse'] as string | undefined,
+				target: (raw.entity ?? raw.target)!,
+				inverse: raw.inverse,
 			}
 			needsNormalization = true
-		} else if (type === 'many') {
+		} else if (raw.type === 'many') {
 			fields[fieldName] = {
 				type: 'hasMany',
-				target: (raw['entity'] as string) ?? (raw['target'] as string),
-				inverse: raw['inverse'] as string | undefined,
+				target: (raw.entity ?? raw.target)!,
+				inverse: raw.inverse,
 			}
 			needsNormalization = true
 		} else {

packages/bindx-dataview/src/HasManyDataGrid.tsx

@@ -206,7 +206,7 @@ function HasManyDataGridImpl<TEntity extends object>({
 
 				const relationData = (result.data[alias] ?? result.data[fieldName]) as Array<Record<string, unknown>> | undefined
 				const totalCount = Array.isArray(relationData) && 'totalCount' in relationData
-					? (relationData as unknown as { totalCount: number }).totalCount
+					? (relationData as Array<Record<string, unknown>> & { totalCount: number }).totalCount
 					: undefined
 
 				if (!Array.isArray(relationData)) {

packages/bindx-dataview/src/columnTypes.ts

@@ -57,8 +57,7 @@ export function defineColumnType<TValue, TFilterArtifact extends FilterArtifact>
  */
 export function accessField(accessor: EntityAccessor<object>, fieldName: string): unknown {
 	// EntityAccessor is a Proxy — bracket access goes through the get trap
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	return (accessor as any)[fieldName]
+	return (accessor as unknown as Record<string, unknown>)[fieldName]
 }
 
 function extractScalarValue<T>(accessor: EntityAccessor<object>, fieldName: string): T | null {

packages/bindx-dataview/src/select/SelectDataView.tsx

@@ -86,7 +86,7 @@ function SelectDataViewImpl({
 
 	const { selection, queryKey } = useMemo(() => {
 		const scope = new SelectionScope()
-		const collector = createCollectorProxy<object>(scope, entityType, schemaRegistry ?? undefined) as unknown as EntityAccessor<object>
+		const collector = createCollectorProxy<object>(scope, entityType, schemaRegistry ?? undefined) as EntityAccessor<object>
 
 		if (selectionDefinerRef.current) {
 			const jsx = selectionDefinerRef.current(collector)

packages/bindx-dataview/src/useDataGridSetup.ts

@@ -102,14 +102,15 @@ export function useDataGridSetup<TEntity extends object>({
 	// ---- Phase 1: Collection ----
 	const { childrenJsx, columns, selection, queryKey, toolbarContent, layoutRenders, layoutElements, effectiveLayouts } = useMemo(() => {
 		const scope = new SelectionScope()
-		const collector = createCollectorProxy<TEntity>(scope, entityType, schemaRegistry ?? undefined) as unknown as EntityAccessor<TEntity>
+		// Collector proxy satisfies EntityAccessor interface at runtime for selection collection
+		const collector = createCollectorProxy<TEntity>(scope, entityType, schemaRegistry ?? undefined) as EntityAccessor<TEntity>
 
 		const jsx = children(collector)
 		const analysis = analyzeChildren(jsx, MARKER_TYPES)
 
-		const cols = analysis.getAll(ColumnLeaf) as unknown as ColumnLeafProps[]
-		const toolbarMarker = analysis.getFirst(DataGridToolbarContent) as DataGridToolbarContentProps | undefined
-		const layoutMarkers = analysis.getAll(DataGridLayout) as unknown as DataGridLayoutProps[]
+		const cols = analysis.getAll<ColumnLeafProps>(ColumnLeaf)
+		const toolbarMarker = analysis.getFirst<DataGridToolbarContentProps>(DataGridToolbarContent)
+		const layoutMarkers = analysis.getAll<DataGridLayoutProps>(DataGridLayout)
 
 		for (const col of cols) {
 			col.collectSelection?.(collector)
@@ -119,13 +120,13 @@ export function useDataGridSetup<TEntity extends object>({
 		const elements = new Map<string, readonly DataViewElementData[]>()
 		for (const marker of layoutMarkers) {
 			const layoutCallback = marker.children as (item: EntityAccessor<object>) => ReactNode
-			const layoutJsx = layoutCallback(collector as unknown as EntityAccessor<object>)
+			const layoutJsx = layoutCallback(collector as EntityAccessor<object>)
 			const layoutSel = collectSelection(layoutJsx)
 			mergeSelections(scope.toSelectionMeta(), layoutSel)
 			renders.set(marker.name, layoutCallback)
 
 			const elementAnalysis = analyzeChildren(layoutJsx, ELEMENT_MARKER_TYPES)
-			const elementProps = elementAnalysis.getAll(DataViewElement) as unknown as DataViewElementProps[]
+			const elementProps = elementAnalysis.getAll<DataViewElementProps>(DataViewElement)
 			if (elementProps.length > 0) {
 				elements.set(marker.name, elementProps.map(it => ({ name: it.name, label: it.label, fallback: it.fallback })))
 			}

packages/bindx-editor/src/components/BlockEditor.tsx

@@ -225,7 +225,7 @@ function BlockElementRenderer<
 		return <BlockElementWithRef block={block} renderProps={renderProps} />
 	}
 
-	return <>{block.render({ ...renderProps, isVoid: block.isVoid }, undefined as unknown as EntityAccessor<TEntity, TSelected, TBrand, TEntityName, TSchema>)}</>
+	return <>{block.render({ ...renderProps, isVoid: block.isVoid }, null)}</>
 }
 
 function BlockElementWithRef<

packages/bindx-editor/src/editor/createEditorWithEssentials.tsx

@@ -22,7 +22,7 @@ export const createEditorWithEssentials = ({ defaultElementType }: { defaultElem
 		slate: Slate,
 		formatVersion: 1,
 		defaultElementType,
-		isDefaultElement: element => 'type' in element && (element as any).type === defaultElementType,
+		isDefaultElement: element => 'type' in element && (element as Record<string, unknown>)['type'] === defaultElementType,
 		createDefaultElement: children => ({
 			type: defaultElementType,
 			children,

packages/bindx-editor/src/internal/hooks/useBlockEditorReferences.ts

@@ -71,10 +71,10 @@ export function useBlockEditorReferences<
 			const tempId = references.add()
 			const entityAccessor = references.getById(tempId)
 
-			// Set discrimination field
-			const fieldHandle = entityAccessor as unknown as { field: (name: string) => { setValue: (v: unknown) => void } }
-			if ('field' in fieldHandle) {
-				fieldHandle.field(discriminationField).setValue(name)
+			// Set discrimination field via proxy (EntityAccessor proxy resolves string keys to field handles)
+			const fieldRef = (entityAccessor as Record<string, unknown>)[discriminationField]
+			if (fieldRef && typeof fieldRef === 'object' && 'setValue' in fieldRef) {
+				(fieldRef as { setValue: (v: unknown) => void }).setValue(name)
 			}
 
 			init?.(entityAccessor)

packages/bindx-editor/src/plugins/attributes/alignment/alignButton.ts

@@ -15,7 +15,7 @@ export const createAlignHandler = (direction: AlignDirection): {
 		return Array.from(Editor.nodes(editor, { match: it => isAlignTarget(editor, it, direction) })).length > 0
 	},
 	isActive: ({ editor }) => {
-		return Array.from(Editor.nodes(editor, { match: it => isAlignTarget(editor, it, direction) && (it as any).align === direction })).length > 0
+		return Array.from(Editor.nodes(editor, { match: it => isAlignTarget(editor, it, direction) && 'align' in it && (it as Record<string, unknown>)['align'] === direction })).length > 0
 	},
 	toggle: ({ editor }) => {
 		Transforms.setNodes(editor, {

packages/bindx-editor/src/plugins/element/lists/transforms/dedentListItem.ts

@@ -35,7 +35,7 @@ export const dedentListItem = (
 	const parentAndGrandParentAreCompatible = BindxEditor.isElementType(
 		grandParentListElement,
 		parentListElement.type,
-		parentListElementSpecifics as any,
+		parentListElementSpecifics as Partial<SlateElement>,
 	)
 
 	// TODO we need to handle following siblings!!!