@contember/bindx-dataview 0.1.0

package/src/columnLeaf.ts

@@ -0,0 +1,148 @@
+/**
+ * ColumnLeaf — the data carrier for extracted column metadata.
+ *
+ * `ColumnLeaf` is a marker React component (returns null) whose props carry
+ * all column metadata. `analyzeChildren()` walks a JSX element tree,
+ * resolving components with `staticRender` and collecting props from registered
+ * marker types — a lightweight equivalent of contember-oss's ChildrenAnalyzer.
+ */
+
+import React from 'react'
+import type { FieldRefBase, FilterHandler, FilterArtifact, EntityAccessor } from '@contember/bindx'
+
+// ============================================================================
+// ColumnLeaf Props — the new ColumnMeta
+// ============================================================================
+
+// ============================================================================
+// Column Leaf Props
+// ============================================================================
+
+/** All known column type literals for type narrowing */
+export type ColumnType = 'text' | 'number' | 'date' | 'dateTime' | 'boolean' | 'uuid' | 'isDefined' | 'enum' | 'enumList' | 'hasOne' | 'hasMany' | 'action' | (string & {})
+
+export interface ColumnLeafProps {
+	// ── Core ──
+	readonly name: string
+	readonly fieldName: string | null
+	readonly fieldRef: FieldRefBase<unknown> | null
+	readonly sortingField: string | null
+	readonly filterName: string | null
+	readonly filterHandler: FilterHandler<FilterArtifact> | undefined
+	readonly isTextSearchable: boolean
+	readonly columnType?: ColumnType
+	readonly collectSelection?: (collectorProxy: unknown) => void
+
+	// ── Enum ──
+	/** Enum type name for resolving options from context (e.g. 'DeploymentStatus') */
+	readonly enumName?: string
+	/** Explicit enum options — value → label (overrides context-resolved options) */
+	readonly enumOptions?: Readonly<Record<string, React.ReactNode>>
+
+	// ── Relation ──
+	readonly relatedEntityName?: string
+	readonly relatedSelection?: import('@contember/bindx').SelectionMeta
+	readonly renderFilterItem?: (accessor: EntityAccessor<object>) => React.ReactNode
+
+	// ── UI ──
+	readonly header?: React.ReactNode
+	readonly renderCell: (accessor: EntityAccessor<object>) => React.ReactNode
+	readonly renderFilter?: (props: { artifact: FilterArtifact; setArtifact: (artifact: FilterArtifact) => void }) => React.ReactNode
+	readonly renderCellWrapper?: (content: React.ReactNode, item: EntityAccessor<object>) => React.ReactNode
+}
+
+/** Type guard for relation columns */
+export function isRelationColumn(col: ColumnLeafProps): col is ColumnLeafProps & { columnType: 'hasOne' | 'hasMany'; relatedEntityName: string; renderFilterItem: (accessor: EntityAccessor<object>) => React.ReactNode } {
+	return (col.columnType === 'hasOne' || col.columnType === 'hasMany') && !!col.relatedEntityName && !!col.renderFilterItem
+}
+
+/**
+ * Marker component — returns null at runtime.
+ * Its props are the column metadata extracted by `analyzeChildren()`.
+ */
+export function ColumnLeaf(_props: ColumnLeafProps): null {
+	return null
+}
+
+// ============================================================================
+// Generalized Children Analyzer
+// ============================================================================
+
+interface ComponentWithStaticRender {
+	staticRender: (props: Record<string, unknown>) => React.ReactNode
+}
+
+function hasStaticRender(type: unknown): type is ComponentWithStaticRender {
+	return typeof type === 'function' && 'staticRender' in type
+}
+
+/**
+ * Result of analyzing a JSX element tree for marker components.
+ */
+export interface ChildrenAnalysisResult {
+	/** Get all collected props for a given marker type */
+	getAll<TProps>(marker: React.ComponentType<TProps>): TProps[]
+	/** Get the first collected props for a given marker type, or undefined */
+	getFirst<TProps>(marker: React.ComponentType<TProps>): TProps | undefined
+}
+
+/**
+ * Walk a JSX element tree and collect props from registered marker types.
+ *
+ * For each element:
+ * 1. If its type is in `markerTypes` → collect its props
+ * 2. If it's a `React.Fragment` → recurse into children
+ * 3. If it has a `staticRender` static method → call it and recurse into result
+ * 4. Otherwise → skip (renders normally at runtime)
+ */
+export function analyzeChildren(
+	elements: React.ReactNode,
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	markerTypes: ReadonlySet<React.ComponentType<any>>,
+): ChildrenAnalysisResult {
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	const collected = new Map<React.ComponentType<any>, unknown[]>()
+	for (const type of markerTypes) {
+		collected.set(type, [])
+	}
+
+	walkTree(elements, markerTypes, collected)
+
+	return {
+		getAll<TProps>(marker: React.ComponentType<TProps>): TProps[] {
+			return (collected.get(marker) ?? []) as TProps[]
+		},
+		getFirst<TProps>(marker: React.ComponentType<TProps>): TProps | undefined {
+			const items = collected.get(marker)
+			return items?.[0] as TProps | undefined
+		},
+	}
+}
+
+function walkTree(
+	elements: React.ReactNode,
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	markerTypes: ReadonlySet<React.ComponentType<any>>,
+	// eslint-disable-next-line @typescript-eslint/no-explicit-any
+	collected: Map<React.ComponentType<any>, unknown[]>,
+): void {
+	React.Children.forEach(elements, (child) => {
+		if (!React.isValidElement(child)) return
+
+		if (markerTypes.has(child.type as React.ComponentType)) {
+			collected.get(child.type as React.ComponentType)!.push(child.props)
+		} else if (child.type === React.Fragment) {
+			walkTree((child.props as { children?: React.ReactNode }).children, markerTypes, collected)
+		} else if (hasStaticRender(child.type)) {
+			const rendered = child.type.staticRender(child.props as Record<string, unknown>)
+			walkTree(rendered, markerTypes, collected)
+		}
+	})
+}
+
+/**
+ * Convenience wrapper: extract `ColumnLeafProps` from a JSX element tree.
+ */
+export function extractColumnLeaves(elements: React.ReactNode): ColumnLeafProps[] {
+	return analyzeChildren(elements, new Set([ColumnLeaf])).getAll(ColumnLeaf)
+}

package/src/columnTypes.ts

@@ -0,0 +1,160 @@
+/**
+ * Column type definitions — headless behavior layer for DataGrid columns.
+ *
+ * Each column type defines how to extract values, create filter handlers,
+ * and whether sorting/text search is supported by default.
+ *
+ * These are framework-agnostic — no React dependency.
+ */
+
+import type { FilterHandler, FilterArtifact, EntityAccessor } from '@contember/bindx'
+import type {
+	TextFilterArtifact,
+	NumberRangeFilterArtifact,
+	DateFilterArtifact,
+	BooleanFilterArtifact,
+	EnumFilterArtifact,
+	EnumListFilterArtifact,
+	IsDefinedFilterArtifact,
+	RelationFilterArtifact,
+} from '@contember/bindx'
+import {
+	createTextFilterHandler,
+	createNumberRangeFilterHandler,
+	createDateFilterHandler,
+	createBooleanFilterHandler,
+	createEnumFilterHandler,
+	createEnumListFilterHandler,
+	createIsDefinedFilterHandler,
+	createRelationFilterHandler,
+} from '@contember/bindx'
+
+// ============================================================================
+// Column Type Definition Interface
+// ============================================================================
+
+export interface ColumnTypeDef<TValue = unknown, TFilterArtifact extends FilterArtifact = FilterArtifact> {
+	readonly name: string
+	readonly defaultSortable: boolean
+	readonly isTextSearchable: boolean
+	readonly createFilterHandler: (fieldName: string) => FilterHandler<TFilterArtifact>
+	readonly extractValue: (accessor: EntityAccessor<object>, fieldName: string) => TValue
+}
+
+export function defineColumnType<TValue, TFilterArtifact extends FilterArtifact>(
+	def: ColumnTypeDef<TValue, TFilterArtifact>,
+): ColumnTypeDef<TValue, TFilterArtifact> {
+	return def
+}
+
+// ============================================================================
+// Value Extractors
+// ============================================================================
+
+/**
+ * Access a field on an EntityAccessor by name.
+ * EntityAccessor is a Proxy — bracket notation triggers the proxy get trap.
+ */
+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]
+}
+
+function extractScalarValue<T>(accessor: EntityAccessor<object>, fieldName: string): T | null {
+	const fieldRef = accessField(accessor, fieldName) as { value?: unknown } | null
+	if (!fieldRef || typeof fieldRef !== 'object') return null
+	return (fieldRef.value ?? null) as T | null
+}
+
+// ============================================================================
+// Built-in Column Type Definitions
+// ============================================================================
+
+export const textColumnDef: ColumnTypeDef<string | null, TextFilterArtifact> = defineColumnType({
+	name: 'text',
+	defaultSortable: true,
+	isTextSearchable: true,
+	createFilterHandler: createTextFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<string>(accessor, fieldName),
+})
+
+export const numberColumnDef: ColumnTypeDef<number | null, NumberRangeFilterArtifact> = defineColumnType({
+	name: 'number',
+	defaultSortable: true,
+	isTextSearchable: false,
+	createFilterHandler: createNumberRangeFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<number>(accessor, fieldName),
+})
+
+export const dateColumnDef: ColumnTypeDef<string | null, DateFilterArtifact> = defineColumnType({
+	name: 'date',
+	defaultSortable: true,
+	isTextSearchable: false,
+	createFilterHandler: createDateFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<string>(accessor, fieldName),
+})
+
+export const dateTimeColumnDef: ColumnTypeDef<string | null, DateFilterArtifact> = defineColumnType({
+	name: 'dateTime',
+	defaultSortable: true,
+	isTextSearchable: false,
+	createFilterHandler: createDateFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<string>(accessor, fieldName),
+})
+
+export const booleanColumnDef: ColumnTypeDef<boolean | null, BooleanFilterArtifact> = defineColumnType({
+	name: 'boolean',
+	defaultSortable: false,
+	isTextSearchable: false,
+	createFilterHandler: createBooleanFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<boolean>(accessor, fieldName),
+})
+
+export const enumColumnDef: ColumnTypeDef<string | null, EnumFilterArtifact> = defineColumnType({
+	name: 'enum',
+	defaultSortable: true,
+	isTextSearchable: false,
+	createFilterHandler: createEnumFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<string>(accessor, fieldName),
+})
+
+export const enumListColumnDef: ColumnTypeDef<readonly string[] | null, EnumListFilterArtifact> = defineColumnType({
+	name: 'enumList',
+	defaultSortable: false,
+	isTextSearchable: false,
+	createFilterHandler: createEnumListFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<readonly string[]>(accessor, fieldName),
+})
+
+export const uuidColumnDef: ColumnTypeDef<string | null, TextFilterArtifact> = defineColumnType({
+	name: 'uuid',
+	defaultSortable: false,
+	isTextSearchable: false,
+	createFilterHandler: createTextFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<string>(accessor, fieldName),
+})
+
+export const isDefinedColumnDef: ColumnTypeDef<unknown, IsDefinedFilterArtifact> = defineColumnType({
+	name: 'isDefined',
+	defaultSortable: false,
+	isTextSearchable: false,
+	createFilterHandler: createIsDefinedFilterHandler,
+	extractValue: (accessor, fieldName) => extractScalarValue<unknown>(accessor, fieldName),
+})
+
+export const hasOneColumnDef: ColumnTypeDef<unknown, RelationFilterArtifact> = defineColumnType({
+	name: 'hasOne',
+	defaultSortable: false,
+	isTextSearchable: false,
+	createFilterHandler: createRelationFilterHandler,
+	extractValue: (accessor, fieldName) => accessField(accessor, fieldName) ?? null,
+})
+
+export const hasManyColumnDef: ColumnTypeDef<unknown, RelationFilterArtifact> = defineColumnType({
+	name: 'hasMany',
+	defaultSortable: false,
+	isTextSearchable: false,
+	createFilterHandler: createRelationFilterHandler,
+	extractValue: (accessor, fieldName) => accessField(accessor, fieldName) ?? null,
+})

package/src/columns.tsx

@@ -0,0 +1,306 @@
+/**
+ * DataGrid column components.
+ *
+ * These are "metadata" components — they are not rendered directly.
+ * Instead, they carry `staticRender` methods that produce `ColumnLeaf`
+ * elements, which the DataGrid extracts for column metadata.
+ *
+ * Scalar columns are built via `createColumn()` + column type defs.
+ * Relation/action/generic columns use manual `staticRender`.
+ */
+
+import React, { ReactNode } from 'react'
+import type { FieldRefBase, HasOneRef, HasManyRef, FilterHandler, FilterArtifact, EntityAccessor, EnumFilterArtifact, EnumListFilterArtifact, SelectionMeta } from '@contember/bindx'
+import { SelectionScope } from '@contember/bindx'
+import { FIELD_REF_META, createCollectorProxy } from '@contember/bindx-react'
+import { createColumn, type ColumnRenderProps } from './createColumn.js'
+import { accessField } from './columnTypes.js'
+import { createRelationColumn, hasOneCellConfig, hasManyCellConfig, type RelationColumnProps } from './createRelationColumn.jsx'
+import {
+	textColumnDef,
+	numberColumnDef,
+	dateColumnDef,
+	dateTimeColumnDef,
+	booleanColumnDef,
+	enumColumnDef,
+	enumListColumnDef,
+	uuidColumnDef,
+	isDefinedColumnDef,
+	hasOneColumnDef,
+	hasManyColumnDef,
+} from './columnTypes.js'
+import { ColumnLeaf, type ColumnLeafProps } from './columnLeaf.js'
+
+// ============================================================================
+// Re-export ColumnLeafProps as ColumnMeta for compatibility
+// ============================================================================
+
+export type ColumnMeta = ColumnLeafProps
+
+// ============================================================================
+// Extraction Helpers
+// ============================================================================
+
+interface FieldRefMetaCarrier {
+	readonly [FIELD_REF_META]: {
+		readonly entityType: string
+		readonly fieldName: string
+		readonly isArray: boolean
+		readonly isRelation: boolean
+		readonly enumName?: string
+	}
+}
+
+/** Type guard: checks if a value carries FIELD_REF_META symbol. */
+export function hasFieldRefMeta(ref: unknown): ref is FieldRefMetaCarrier {
+	return ref != null && typeof ref === 'object' && FIELD_REF_META in ref
+}
+
+/** Extract field name from a field ref (works in both collector and runtime proxies). */
+export function extractFieldName(ref: unknown): string | null {
+	return hasFieldRefMeta(ref) ? ref[FIELD_REF_META].fieldName : null
+}
+
+/** Extract enum name from a field ref (if field is an enum). */
+export function extractEnumName(ref: unknown): string | undefined {
+	return hasFieldRefMeta(ref) ? ref[FIELD_REF_META].enumName : undefined
+}
+
+/** Extract related entity type name from a relation field ref. */
+export function extractRelatedEntityName(ref: unknown): string | null {
+	if (!hasFieldRefMeta(ref)) return null
+	const meta = ref[FIELD_REF_META]
+	return meta.entityType || null
+}
+
+/**
+ * Access a related entity accessor from a parent row accessor by field name.
+ * EntityAccessor is a Proxy — bracket notation triggers the get trap.
+ */
+export function getRelatedAccessor(item: EntityAccessor<object>, fieldName: string): EntityAccessor<object> | null {
+	return accessField(item, fieldName) as EntityAccessor<object> | null
+}
+
+// ============================================================================
+// Default Cell Renderers
+// ============================================================================
+
+function renderScalarDefault({ value }: ColumnRenderProps<unknown>): React.ReactNode {
+	return value != null ? String(value) : ''
+}
+
+function renderBooleanDefault({ value }: ColumnRenderProps<boolean | null>): React.ReactNode {
+	return value != null ? String(value) : ''
+}
+
+function renderIsDefinedDefault({ value }: ColumnRenderProps<unknown>): React.ReactNode {
+	return value != null ? '✓' : '✗'
+}
+
+function renderDateTimeDefault({ value }: ColumnRenderProps<string | null>): React.ReactNode {
+	if (typeof value !== 'string') return ''
+	const date = new Date(value)
+	if (isNaN(date.getTime())) return value
+	return date.toLocaleString()
+}
+
+function renderEnumListDefault({ value }: ColumnRenderProps<readonly string[] | null>): React.ReactNode {
+	if (!Array.isArray(value)) return ''
+	return value.join(', ')
+}
+
+// ============================================================================
+// Scalar Column Props
+// ============================================================================
+
+interface DataGridScalarColumnPropsBase<T> {
+	field: FieldRefBase<T> | FieldRefBase<T | undefined>
+	header?: React.ReactNode
+	sortable?: boolean
+	filter?: boolean
+	children?: (value: T | null) => React.ReactNode
+}
+
+export interface DataGridTextColumnProps<T> extends DataGridScalarColumnPropsBase<T> {}
+export interface DataGridNumberColumnProps<T> extends DataGridScalarColumnPropsBase<T> {}
+export interface DataGridDateColumnProps<T> extends DataGridScalarColumnPropsBase<T> {}
+export interface DataGridDateTimeColumnProps<T> extends DataGridScalarColumnPropsBase<T> {}
+export interface DataGridBooleanColumnProps<T> extends DataGridScalarColumnPropsBase<T> {}
+export interface DataGridUuidColumnProps<T> extends DataGridScalarColumnPropsBase<T> {}
+export interface DataGridIsDefinedColumnProps<T> extends DataGridScalarColumnPropsBase<T> {}
+
+interface EnumExtraProps<T extends string> {
+	options: readonly T[] | Record<T, ReactNode>
+}
+
+export interface DataGridEnumColumnProps<T extends string> extends DataGridScalarColumnPropsBase<T>, EnumExtraProps<NoInfer<T>> {}
+
+export interface DataGridEnumListColumnProps<T extends string> extends DataGridScalarColumnPropsBase<T>, EnumExtraProps<NoInfer<T>> {}
+
+// ============================================================================
+// Scalar Columns via createColumn()
+//
+// createColumn handles `children` (custom cell renderer) and `options` (enum)
+// natively — no monkey-patching needed.
+// ============================================================================
+
+export const DataGridTextColumn = createColumn(textColumnDef, {
+	renderCell: renderScalarDefault,
+})
+
+export const DataGridNumberColumn = createColumn(numberColumnDef, {
+	renderCell: renderScalarDefault,
+})
+
+export const DataGridDateColumn = createColumn(dateColumnDef, {
+	renderCell: renderScalarDefault,
+})
+
+export const DataGridDateTimeColumn = createColumn(dateTimeColumnDef, {
+	renderCell: renderDateTimeDefault,
+})
+
+export const DataGridBooleanColumn = createColumn(booleanColumnDef, {
+	renderCell: renderBooleanDefault,
+})
+
+export const DataGridEnumColumn = createColumn<string | null, EnumFilterArtifact, EnumExtraProps<string>>(enumColumnDef, {
+	renderCell: renderScalarDefault,
+}) as <TValue extends string>(props: DataGridEnumColumnProps<TValue>) => ReactNode
+
+export const DataGridEnumListColumn = createColumn<readonly string[] | null, EnumListFilterArtifact, EnumExtraProps<string>>(enumListColumnDef, {
+	renderCell: renderEnumListDefault,
+}) as <TValue extends string>(props: DataGridEnumListColumnProps<TValue>) => ReactNode
+
+export const DataGridUuidColumn = createColumn(uuidColumnDef, {
+	renderCell: renderScalarDefault,
+})
+
+export const DataGridIsDefinedColumn = createColumn(isDefinedColumnDef, {
+	renderCell: renderIsDefinedDefault,
+})
+
+// ============================================================================
+// Relation Column Props & Components
+// ============================================================================
+
+export interface DataGridHasOneColumnProps<TEntity, TSelected> extends RelationColumnProps<TEntity, TSelected> {
+	field: HasOneRef<TEntity, TSelected>
+}
+
+/** Headless HasOne column — no filter UI or cell tooltip. Use @contember/bindx-ui for styled version. */
+const _DataGridHasOneColumn = createRelationColumn(hasOneColumnDef, hasOneCellConfig)
+export const DataGridHasOneColumn: {
+	<TEntity, TSelected>(props: DataGridHasOneColumnProps<TEntity, TSelected>): null
+	staticRender: typeof _DataGridHasOneColumn.staticRender
+	buildLeaf: typeof _DataGridHasOneColumn.buildLeaf
+} = _DataGridHasOneColumn
+
+// ============================================================================
+// HasMany Column
+// ============================================================================
+
+export interface DataGridHasManyColumnProps<TEntity, TSelected> extends RelationColumnProps<TEntity, TSelected> {
+	field: HasManyRef<TEntity, TSelected>
+}
+
+/** Headless HasMany column — no filter UI or cell tooltip. Use @contember/bindx-ui for styled version. */
+const _DataGridHasManyColumn = createRelationColumn(hasManyColumnDef, hasManyCellConfig)
+export const DataGridHasManyColumn: {
+	<TEntity, TSelected>(props: DataGridHasManyColumnProps<TEntity, TSelected>): null
+	staticRender: typeof _DataGridHasManyColumn.staticRender
+	buildLeaf: typeof _DataGridHasManyColumn.buildLeaf
+} = _DataGridHasManyColumn
+
+// ============================================================================
+// Action Column
+// ============================================================================
+
+export interface DataGridActionColumnProps {
+	children: React.ReactNode | ((entity: EntityAccessor<object>) => React.ReactNode)
+	header?: React.ReactNode
+}
+
+export const DataGridActionColumn = Object.assign(
+	function DataGridActionColumn(_props: DataGridActionColumnProps): null {
+		return null
+	},
+	{
+		staticRender: (props: Record<string, unknown>): React.ReactNode => {
+			const header = (props['header'] as React.ReactNode) ?? ''
+			const children = props['children']
+			const cellRenderer = typeof children === 'function'
+				? children as (value: unknown) => React.ReactNode
+				: () => children as React.ReactNode
+
+			const leafProps: ColumnLeafProps = {
+				columnType: 'action',
+				name: `action-${Math.random().toString(36).slice(2, 8)}`,
+				fieldName: null,
+				fieldRef: null,
+				sortingField: null,
+				filterName: null,
+				filterHandler: undefined,
+				isTextSearchable: false,
+				header,
+				renderCell: (accessor: EntityAccessor<object>) => cellRenderer(accessor),
+			}
+
+			return React.createElement(ColumnLeaf, leafProps as ColumnLeafProps)
+		},
+	},
+)
+
+// ============================================================================
+// Generic Column
+// ============================================================================
+
+export interface DataGridColumnProps<T> {
+	field?: FieldRefBase<T>
+	header?: React.ReactNode
+	sortable?: boolean
+	filter?: boolean
+	filterHandler?: FilterHandler<FilterArtifact>
+	children?: (value: T | null, accessor: EntityAccessor<object>) => React.ReactNode
+}
+
+export const DataGridColumn = Object.assign(
+	function DataGridColumn<T>(_props: DataGridColumnProps<T>): null {
+		return null
+	},
+	{
+		staticRender: (props: Record<string, unknown>): React.ReactNode => {
+			const fieldRef = props['field'] as FieldRefBase<unknown> | undefined
+			const fieldName = fieldRef ? extractFieldName(fieldRef) : null
+			const header = props['header'] as React.ReactNode | undefined
+			const sortable = (props['sortable'] as boolean | undefined) ?? false
+			const filterEnabled = (props['filter'] as boolean | undefined) ?? true
+			const customHandler = props['filterHandler'] as FilterHandler<FilterArtifact> | undefined
+			const children = props['children'] as ((value: unknown, accessor: EntityAccessor<object>) => React.ReactNode) | undefined
+
+			const leafProps: ColumnLeafProps = {
+				name: fieldName ?? `col-${Math.random().toString(36).slice(2, 8)}`,
+				fieldName,
+				fieldRef: fieldRef ?? null,
+				sortingField: sortable && fieldName ? fieldName : null,
+				filterName: filterEnabled && fieldName ? fieldName : null,
+				filterHandler: filterEnabled && fieldName
+					? (customHandler ?? textColumnDef.createFilterHandler(fieldName) as FilterHandler<FilterArtifact>)
+					: undefined,
+				isTextSearchable: false,
+				header,
+				renderCell: (accessor: EntityAccessor<object>) => {
+					if (!fieldName) return null
+					const ref = (accessor as unknown as Record<string, unknown>)[fieldName]
+					const value = ref && typeof ref === 'object' && 'value' in ref
+						? (ref as { value: unknown }).value ?? null
+						: null
+					if (children) return children(value, accessor)
+					return value != null ? String(value) : ''
+				},
+			}
+
+			return React.createElement(ColumnLeaf, leafProps as ColumnLeafProps)
+		},
+	},
+)