@questpie/admin 1.1.1 → 2.0.0

package/dist/client/views/collection/columns/build-columns.mjs

@@ -0,0 +1,156 @@
+import { useResolveText } from "../../../i18n/hooks.mjs";
+import { useSafeContentLocales } from "../../../runtime/content-locales-provider.mjs";
+import { useScopedLocale } from "../../../runtime/locale-scope.mjs";
+import { LocaleSwitcher } from "../../../components/locale-switcher.mjs";
+import { normalizeColumnConfig } from "../../../builder/types/collection-types.mjs";
+import { DefaultCell, TextCell } from "../cells/primitive-cells.mjs";
+import { computeDefaultColumns, formatHeader } from "./column-defaults.mjs";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/client/views/collection/columns/build-columns.tsx
+/**
+* Column header component that resolves I18nText labels
+*/
+function ColumnHeader({ label, fallback, localized }) {
+	const resolveText = useResolveText();
+	const contentLocales = useSafeContentLocales();
+	const { locale: contentLocale, setLocale: setContentLocale } = useScopedLocale();
+	const resolvedLocale = contentLocale ?? contentLocales?.defaultLocale ?? contentLocales?.locales[0]?.code;
+	const localeOptions = contentLocales?.locales?.length ? contentLocales.locales : resolvedLocale ? [{ code: resolvedLocale }] : [];
+	const showLocaleSwitcher = localized && localeOptions.length > 0;
+	return /* @__PURE__ */ jsxs("span", {
+		className: "inline-flex items-center gap-1.5",
+		children: [/* @__PURE__ */ jsx("span", { children: resolveText(label, fallback) }), showLocaleSwitcher && /* @__PURE__ */ jsx(LocaleSwitcher, {
+			locales: localeOptions,
+			value: resolvedLocale,
+			onChange: setContentLocale,
+			labelMode: "code"
+		})]
+	});
+}
+/**
+* Field types that need fieldDef passed to their cell component
+* (for nested field definitions, labels, etc.)
+*/
+const FIELD_TYPES_NEEDING_FIELD_DEF = new Set([
+	"object",
+	"array",
+	"relation",
+	"reverseRelation"
+]);
+/**
+* Build column definitions from collection config
+*
+* Simplified cell resolution:
+* 1. Custom from .list() config
+* 2. From field registry (.cell)
+* 3. Ultra-simple DefaultCell fallback
+*
+* NO getCellForFieldType() switch statement needed!
+*
+* @param options - Build options with config and fallbacks
+* @returns Array of TanStack Table column definitions
+*
+* @example
+* ```tsx
+* const columns = buildColumns({
+*   config: collectionsConfig.posts,
+*   fallbackColumns: ['id', 'title', 'createdAt'],
+*   meta: collectionMeta,
+* });
+*
+* <CollectionList collection="posts" columns={columns} />
+* ```
+*/
+function buildColumns(options) {
+	const { config, fallbackColumns = ["id"], buildAllColumns = false, meta } = options;
+	const fields = config?.fields ?? {};
+	const listConfig = config?.list;
+	const isLocalizedField = (field, definition) => {
+		const fieldOptions = definition?.["~options"] ?? {};
+		return fieldOptions.localized !== void 0 ? !!fieldOptions.localized : meta?.localizedFields?.includes(field) ?? false;
+	};
+	const titleFieldName = meta?.title?.fieldName;
+	const titleType = meta?.title?.type;
+	const titleColumn = titleType === "field" && titleFieldName ? titleFieldName : "_title";
+	let columnConfigs;
+	if (buildAllColumns) {
+		const allFields = Object.keys(fields);
+		columnConfigs = [titleColumn, ...titleColumn === "_title" ? allFields : allFields.filter((f) => f !== titleColumn)];
+	} else if (listConfig?.columns && listConfig.columns.length > 0) columnConfigs = listConfig.columns;
+	else if (Object.keys(fields).length > 0) columnConfigs = computeDefaultColumns(fields, { meta });
+	else columnConfigs = [titleColumn, ...fallbackColumns.filter((c) => c !== titleColumn && c !== "_title")];
+	return columnConfigs.map((colConfig) => {
+		const normalized = normalizeColumnConfig(colConfig);
+		const fieldName = normalized.field;
+		const fieldDef = fields[fieldName];
+		if (fieldName === "_title") {
+			titleFieldName && isLocalizedField(titleFieldName, fields[titleFieldName]);
+			let titleLabel = "Title";
+			let titleFallback = "Title";
+			if (titleType === "virtual" && titleFieldName && fields[titleFieldName]) {
+				titleLabel = (fields[titleFieldName]?.["~options"] ?? {}).label;
+				titleFallback = formatHeader(titleFieldName);
+			}
+			return {
+				accessorKey: "_title",
+				header: normalized.header ? () => /* @__PURE__ */ jsx(ColumnHeader, {
+					label: normalized.header,
+					fallback: "Title"
+				}) : () => /* @__PURE__ */ jsx(ColumnHeader, {
+					label: titleLabel,
+					fallback: titleFallback
+				}),
+				cell: ({ row }) => {
+					return /* @__PURE__ */ jsx(TextCell, { value: row.getValue("_title") });
+				},
+				enableSorting: false
+			};
+		}
+		const fieldType = fieldDef?.name ?? "text";
+		const fieldOptions = fieldDef?.["~options"] ?? {};
+		isLocalizedField(fieldName, fieldDef);
+		let CellComponent;
+		if (normalized.cell) CellComponent = normalized.cell;
+		else if (fieldDef?.cell?.component) CellComponent = fieldDef.cell.component;
+		else CellComponent = DefaultCell;
+		const needsFieldDef = FIELD_TYPES_NEEDING_FIELD_DEF.has(fieldType);
+		const accessorKey = fieldType === "relation" && fieldOptions.relationName ? fieldOptions.relationName : fieldName;
+		const headerLabel = normalized.header ?? fieldOptions.label;
+		const headerFallback = formatHeader(fieldName);
+		const computeFn = fieldOptions.compute;
+		const isComputed = typeof computeFn === "function";
+		const columnDef = {
+			id: fieldName,
+			accessorKey: isComputed ? void 0 : accessorKey,
+			header: () => /* @__PURE__ */ jsx(ColumnHeader, {
+				label: headerLabel,
+				fallback: headerFallback
+			}),
+			cell: ({ row, getValue }) => {
+				const value = isComputed ? computeFn(row.original) : getValue();
+				return needsFieldDef ? /* @__PURE__ */ jsx(CellComponent, {
+					value,
+					row,
+					fieldDef
+				}) : /* @__PURE__ */ jsx(CellComponent, {
+					value,
+					row
+				});
+			},
+			enableSorting: isComputed ? false : normalized.sortable !== false
+		};
+		if (normalized.width) columnDef.size = typeof normalized.width === "number" ? normalized.width : Number.parseInt(normalized.width, 10) || void 0;
+		if (normalized.minWidth) columnDef.minSize = typeof normalized.minWidth === "number" ? normalized.minWidth : Number.parseInt(normalized.minWidth, 10) || void 0;
+		if (normalized.maxWidth) columnDef.maxSize = typeof normalized.maxWidth === "number" ? normalized.maxWidth : Number.parseInt(normalized.maxWidth, 10) || void 0;
+		if (normalized.align || normalized.className) columnDef.meta = {
+			align: normalized.align,
+			className: normalized.className
+		};
+		return columnDef;
+	});
+}
+
+//#endregion
+export { buildColumns };
+//# sourceMappingURL=build-columns.mjs.map

package/dist/client/views/collection/columns/build-columns.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-columns.mjs","names":["columnConfigs: ColumnConfig<string>[]","titleLabel: I18nText","CellComponent: React.ComponentType<{\n      value: unknown;\n      row?: unknown;\n      fieldDef?: FieldDefinition;\n    }>","accessorKey: string","columnDef: ColumnDef<TData>"],"sources":["../../../../../src/client/views/collection/columns/build-columns.tsx"],"sourcesContent":["/**\n * Column Builder\n *\n * Generates TanStack Table column definitions from collection config.\n * Simplified version - uses field registry or DefaultCell fallback.\n */\n\nimport type { ColumnDef } from \"@tanstack/react-table\";\nimport type * as React from \"react\";\nimport {\n  type ColumnConfig,\n  normalizeColumnConfig,\n} from \"../../../builder/types/collection-types\";\nimport type { FieldDefinition } from \"../../../builder/field/field\";\nimport { LocaleSwitcher } from \"../../../components/locale-switcher\";\nimport { useResolveText } from \"../../../i18n/hooks\";\nimport type { I18nText } from \"../../../i18n/types\";\nimport { useSafeContentLocales, useScopedLocale } from \"../../../runtime\";\nimport { DefaultCell, TextCell } from \"../cells\";\nimport { computeDefaultColumns, formatHeader } from \"./column-defaults\";\nimport type { BuildColumnsOptions } from \"./types\";\n\n// ============================================================================\n// Header Component with I18nText Resolution\n// ============================================================================\n\n/**\n * Column header component that resolves I18nText labels\n */\nfunction ColumnHeader({\n  label,\n  fallback,\n  localized,\n}: {\n  label: I18nText | undefined;\n  fallback: string;\n  localized?: boolean;\n}) {\n  const resolveText = useResolveText();\n  const contentLocales = useSafeContentLocales();\n  // Use scoped locale (from LocaleScopeProvider in ResourceSheet) or global locale\n  const { locale: contentLocale, setLocale: setContentLocale } =\n    useScopedLocale();\n  const resolvedLocale =\n    contentLocale ??\n    contentLocales?.defaultLocale ??\n    contentLocales?.locales[0]?.code;\n  const localeOptions = contentLocales?.locales?.length\n    ? contentLocales.locales\n    : resolvedLocale\n      ? [{ code: resolvedLocale }]\n      : [];\n  const showLocaleSwitcher = localized && localeOptions.length > 0;\n\n  return (\n    <span className=\"inline-flex items-center gap-1.5\">\n      <span>{resolveText(label, fallback)}</span>\n      {showLocaleSwitcher && (\n        <LocaleSwitcher\n          locales={localeOptions}\n          value={resolvedLocale}\n          onChange={setContentLocale}\n          labelMode=\"code\"\n        />\n      )}\n    </span>\n  );\n}\n\n// ============================================================================\n// Field Types Needing fieldDef\n// ============================================================================\n\n/**\n * Field types that need fieldDef passed to their cell component\n * (for nested field definitions, labels, etc.)\n */\nconst FIELD_TYPES_NEEDING_FIELD_DEF = new Set([\n  \"object\",\n  \"array\",\n  \"relation\",\n  \"reverseRelation\",\n]);\n\n// ============================================================================\n// Column Builder\n// ============================================================================\n\n/**\n * Build column definitions from collection config\n *\n * Simplified cell resolution:\n * 1. Custom from .list() config\n * 2. From field registry (.cell)\n * 3. Ultra-simple DefaultCell fallback\n *\n * NO getCellForFieldType() switch statement needed!\n *\n * @param options - Build options with config and fallbacks\n * @returns Array of TanStack Table column definitions\n *\n * @example\n * ```tsx\n * const columns = buildColumns({\n *   config: collectionsConfig.posts,\n *   fallbackColumns: ['id', 'title', 'createdAt'],\n *   meta: collectionMeta,\n * });\n *\n * <CollectionList collection=\"posts\" columns={columns} />\n * ```\n */\nexport function buildColumns<TData extends Record<string, unknown>>(\n  options: BuildColumnsOptions,\n): ColumnDef<TData>[] {\n  const {\n    config,\n    fallbackColumns = [\"id\"],\n    buildAllColumns = false,\n    meta,\n  } = options;\n  const fields = config?.fields ?? {};\n  const listConfig = config?.list;\n\n  const isLocalizedField = (\n    field: string,\n    definition?: FieldDefinition,\n  ): boolean => {\n    const fieldOptions = definition?.[\"~options\"] ?? {};\n    return fieldOptions.localized !== undefined\n      ? !!fieldOptions.localized\n      : (meta?.localizedFields?.includes(field) ?? false);\n  };\n\n  // Determine title column based on meta\n  // If meta says title is a real \"field\", use that field instead of _title\n  const titleFieldName = meta?.title?.fieldName;\n  const titleType = meta?.title?.type;\n  const titleColumn =\n    titleType === \"field\" && titleFieldName ? titleFieldName : \"_title\";\n\n  // Determine which columns to build\n  let columnConfigs: ColumnConfig<string>[];\n\n  if (buildAllColumns) {\n    // Build ALL columns for all fields (used when user can toggle visibility)\n    // Include title column (real field or _title) first, then all other fields\n    const allFields = Object.keys(fields);\n    // If title is a real field, don't duplicate it\n    const otherFields =\n      titleColumn === \"_title\"\n        ? allFields\n        : allFields.filter((f) => f !== titleColumn);\n    columnConfigs = [titleColumn, ...otherFields];\n  } else if (listConfig?.columns && listConfig.columns.length > 0) {\n    // Use explicitly defined columns\n    columnConfigs = listConfig.columns;\n  } else if (Object.keys(fields).length > 0) {\n    // Use sane defaults - limited content fields + createdAt\n    columnConfigs = computeDefaultColumns(fields, { meta });\n  } else {\n    // Use fallback - include title column first\n    columnConfigs = [\n      titleColumn,\n      ...fallbackColumns.filter((c) => c !== titleColumn && c !== \"_title\"),\n    ];\n  }\n\n  // Build column definitions\n  return columnConfigs.map((colConfig) => {\n    const normalized = normalizeColumnConfig(colConfig);\n    const fieldName = normalized.field;\n    const fieldDef = fields[fieldName];\n\n    // Special handling for _title virtual field (computed by backend)\n    if (fieldName === \"_title\") {\n      const titleIsLocalized = titleFieldName\n        ? isLocalizedField(titleFieldName, fields[titleFieldName])\n        : false;\n      // Determine the label for _title column\n      // For virtual titles, use the virtual field's label instead of generic \"Title\"\n      let titleLabel: I18nText = \"Title\";\n      let titleFallback = \"Title\";\n      if (titleType === \"virtual\" && titleFieldName && fields[titleFieldName]) {\n        const virtualFieldDef = fields[titleFieldName];\n        const virtualFieldOptions = virtualFieldDef?.[\"~options\"] ?? {};\n        titleLabel = virtualFieldOptions.label;\n        titleFallback = formatHeader(titleFieldName);\n      }\n\n      const columnDef: ColumnDef<TData> = {\n        accessorKey: \"_title\",\n        header: normalized.header\n          ? () => <ColumnHeader label={normalized.header} fallback=\"Title\" />\n          : () => <ColumnHeader label={titleLabel} fallback={titleFallback} />,\n        cell: ({ row }) => {\n          const value = row.getValue(\"_title\");\n          return <TextCell value={value} />;\n        },\n        enableSorting: false, // _title is virtual, can't sort on it directly\n      };\n      return columnDef;\n    }\n\n    const fieldType = fieldDef?.name ?? \"text\";\n    const fieldOptions = fieldDef?.[\"~options\"] ?? {};\n    const isLocalized = isLocalizedField(fieldName, fieldDef);\n\n    // ========== SIMPLIFIED CELL RESOLUTION ==========\n    // Priority chain - just 3 lines!\n    let CellComponent: React.ComponentType<{\n      value: unknown;\n      row?: unknown;\n      fieldDef?: FieldDefinition;\n    }>;\n\n    if (normalized.cell) {\n      // 1. Custom cell from .list() config\n      CellComponent = normalized.cell as React.ComponentType<{\n        value: unknown;\n        row?: unknown;\n        fieldDef?: FieldDefinition;\n      }>;\n    } else if (fieldDef?.cell?.component) {\n      // 2. Cell from field registry (most common)\n      CellComponent = fieldDef.cell.component as React.ComponentType<{\n        value: unknown;\n        row?: unknown;\n        fieldDef?: FieldDefinition;\n      }>;\n    } else {\n      // 3. Ultra-simple DefaultCell fallback\n      CellComponent = DefaultCell;\n    }\n\n    // Check if this field type needs fieldDef passed to the cell\n    const needsFieldDef = FIELD_TYPES_NEEDING_FIELD_DEF.has(fieldType);\n\n    // For relation fields, use relationName as accessor if specified\n    // This allows fetching expanded relation data (e.g., row.customer) instead of FK (row.customerId)\n    // If relationName is not specified, we use the field name (which shows the raw FK value)\n    const accessorKey: string =\n      fieldType === \"relation\" && fieldOptions.relationName\n        ? fieldOptions.relationName\n        : fieldName;\n\n    // Build column def\n    // Use fieldName as id (for lookup in visibleColumns) and accessorKey for data access\n    const headerLabel = normalized.header ?? fieldOptions.label;\n    const headerFallback = formatHeader(fieldName);\n    // Check if field is computed\n    const computeFn = fieldOptions.compute as\n      | ((values: Record<string, any>) => any)\n      | undefined;\n    const isComputed = typeof computeFn === \"function\";\n\n    const columnDef: ColumnDef<TData> = {\n      id: fieldName, // Always use field name as id for consistent lookup\n      accessorKey: isComputed ? undefined : accessorKey, // Computed fields don't have accessor\n      header: () => (\n        <ColumnHeader label={headerLabel} fallback={headerFallback} />\n      ),\n      cell: ({ row, getValue }) => {\n        // For computed fields, compute value from row data\n        const value = isComputed\n          ? computeFn(row.original as Record<string, any>)\n          : getValue();\n        // Pass fieldDef for object/array/relation types to enable advanced rendering\n        return needsFieldDef ? (\n          <CellComponent value={value} row={row} fieldDef={fieldDef} />\n        ) : (\n          <CellComponent value={value} row={row} />\n        );\n      },\n      // Computed fields are not sortable (no DB column)\n      enableSorting: isComputed ? false : normalized.sortable !== false,\n    };\n\n    // Add size config if specified\n    if (normalized.width) {\n      (columnDef as any).size =\n        typeof normalized.width === \"number\"\n          ? normalized.width\n          : Number.parseInt(normalized.width, 10) || undefined;\n    }\n    if (normalized.minWidth) {\n      (columnDef as any).minSize =\n        typeof normalized.minWidth === \"number\"\n          ? normalized.minWidth\n          : Number.parseInt(normalized.minWidth, 10) || undefined;\n    }\n    if (normalized.maxWidth) {\n      (columnDef as any).maxSize =\n        typeof normalized.maxWidth === \"number\"\n          ? normalized.maxWidth\n          : Number.parseInt(normalized.maxWidth, 10) || undefined;\n    }\n\n    // Add meta for alignment/className\n    if (normalized.align || normalized.className) {\n      (columnDef as any).meta = {\n        align: normalized.align,\n        className: normalized.className,\n      };\n    }\n\n    return columnDef;\n  });\n}\n"],"mappings":";;;;;;;;;;;;;AA6BA,SAAS,aAAa,EACpB,OACA,UACA,aAKC;CACD,MAAM,cAAc,gBAAgB;CACpC,MAAM,iBAAiB,uBAAuB;CAE9C,MAAM,EAAE,QAAQ,eAAe,WAAW,qBACxC,iBAAiB;CACnB,MAAM,iBACJ,iBACA,gBAAgB,iBAChB,gBAAgB,QAAQ,IAAI;CAC9B,MAAM,gBAAgB,gBAAgB,SAAS,SAC3C,eAAe,UACf,iBACE,CAAC,EAAE,MAAM,gBAAgB,CAAC,GAC1B,EAAE;CACR,MAAM,qBAAqB,aAAa,cAAc,SAAS;AAE/D,QACE,qBAAC;EAAK,WAAU;aACd,oBAAC,oBAAM,YAAY,OAAO,SAAS,GAAQ,EAC1C,sBACC,oBAAC;GACC,SAAS;GACT,OAAO;GACP,UAAU;GACV,WAAU;IACV;GAEC;;;;;;AAYX,MAAM,gCAAgC,IAAI,IAAI;CAC5C;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;AA8BF,SAAgB,aACd,SACoB;CACpB,MAAM,EACJ,QACA,kBAAkB,CAAC,KAAK,EACxB,kBAAkB,OAClB,SACE;CACJ,MAAM,SAAS,QAAQ,UAAU,EAAE;CACnC,MAAM,aAAa,QAAQ;CAE3B,MAAM,oBACJ,OACA,eACY;EACZ,MAAM,eAAe,aAAa,eAAe,EAAE;AACnD,SAAO,aAAa,cAAc,SAC9B,CAAC,CAAC,aAAa,YACd,MAAM,iBAAiB,SAAS,MAAM,IAAI;;CAKjD,MAAM,iBAAiB,MAAM,OAAO;CACpC,MAAM,YAAY,MAAM,OAAO;CAC/B,MAAM,cACJ,cAAc,WAAW,iBAAiB,iBAAiB;CAG7D,IAAIA;AAEJ,KAAI,iBAAiB;EAGnB,MAAM,YAAY,OAAO,KAAK,OAAO;AAMrC,kBAAgB,CAAC,aAAa,GAH5B,gBAAgB,WACZ,YACA,UAAU,QAAQ,MAAM,MAAM,YAAY,CACH;YACpC,YAAY,WAAW,WAAW,QAAQ,SAAS,EAE5D,iBAAgB,WAAW;UAClB,OAAO,KAAK,OAAO,CAAC,SAAS,EAEtC,iBAAgB,sBAAsB,QAAQ,EAAE,MAAM,CAAC;KAGvD,iBAAgB,CACd,aACA,GAAG,gBAAgB,QAAQ,MAAM,MAAM,eAAe,MAAM,SAAS,CACtE;AAIH,QAAO,cAAc,KAAK,cAAc;EACtC,MAAM,aAAa,sBAAsB,UAAU;EACnD,MAAM,YAAY,WAAW;EAC7B,MAAM,WAAW,OAAO;AAGxB,MAAI,cAAc,UAAU;AACD,qBACrB,iBAAiB,gBAAgB,OAAO,gBAAgB;GAI5D,IAAIC,aAAuB;GAC3B,IAAI,gBAAgB;AACpB,OAAI,cAAc,aAAa,kBAAkB,OAAO,iBAAiB;AAGvE,kBAFwB,OAAO,kBACe,eAAe,EAAE,EAC9B;AACjC,oBAAgB,aAAa,eAAe;;AAc9C,UAXoC;IAClC,aAAa;IACb,QAAQ,WAAW,eACT,oBAAC;KAAa,OAAO,WAAW;KAAQ,UAAS;MAAU,SAC3D,oBAAC;KAAa,OAAO;KAAY,UAAU;MAAiB;IACtE,OAAO,EAAE,UAAU;AAEjB,YAAO,oBAAC,YAAS,OADH,IAAI,SAAS,SAAS,GACH;;IAEnC,eAAe;IAChB;;EAIH,MAAM,YAAY,UAAU,QAAQ;EACpC,MAAM,eAAe,WAAW,eAAe,EAAE;AAC7B,mBAAiB,WAAW,SAAS;EAIzD,IAAIC;AAMJ,MAAI,WAAW,KAEb,iBAAgB,WAAW;WAKlB,UAAU,MAAM,UAEzB,iBAAgB,SAAS,KAAK;MAO9B,iBAAgB;EAIlB,MAAM,gBAAgB,8BAA8B,IAAI,UAAU;EAKlE,MAAMC,cACJ,cAAc,cAAc,aAAa,eACrC,aAAa,eACb;EAIN,MAAM,cAAc,WAAW,UAAU,aAAa;EACtD,MAAM,iBAAiB,aAAa,UAAU;EAE9C,MAAM,YAAY,aAAa;EAG/B,MAAM,aAAa,OAAO,cAAc;EAExC,MAAMC,YAA8B;GAClC,IAAI;GACJ,aAAa,aAAa,SAAY;GACtC,cACE,oBAAC;IAAa,OAAO;IAAa,UAAU;KAAkB;GAEhE,OAAO,EAAE,KAAK,eAAe;IAE3B,MAAM,QAAQ,aACV,UAAU,IAAI,SAAgC,GAC9C,UAAU;AAEd,WAAO,gBACL,oBAAC;KAAqB;KAAY;KAAe;MAAY,GAE7D,oBAAC;KAAqB;KAAY;MAAO;;GAI7C,eAAe,aAAa,QAAQ,WAAW,aAAa;GAC7D;AAGD,MAAI,WAAW,MACb,CAAC,UAAkB,OACjB,OAAO,WAAW,UAAU,WACxB,WAAW,QACX,OAAO,SAAS,WAAW,OAAO,GAAG,IAAI;AAEjD,MAAI,WAAW,SACb,CAAC,UAAkB,UACjB,OAAO,WAAW,aAAa,WAC3B,WAAW,WACX,OAAO,SAAS,WAAW,UAAU,GAAG,IAAI;AAEpD,MAAI,WAAW,SACb,CAAC,UAAkB,UACjB,OAAO,WAAW,aAAa,WAC3B,WAAW,WACX,OAAO,SAAS,WAAW,UAAU,GAAG,IAAI;AAIpD,MAAI,WAAW,SAAS,WAAW,UACjC,CAAC,UAAkB,OAAO;GACxB,OAAO,WAAW;GAClB,WAAW,WAAW;GACvB;AAGH,SAAO;GACP"}

package/dist/client/views/collection/columns/column-defaults.d.mts

@@ -0,0 +1,2 @@
+import "../../../builder/field/field.mjs";
+import "./types.mjs";

package/dist/client/views/collection/columns/column-defaults.mjs

@@ -0,0 +1,108 @@
+import { formatFieldLabel } from "../cells/shared/cell-helpers.mjs";
+
+//#region src/client/views/collection/columns/column-defaults.ts
+/**
+* System fields that are typically auto-generated and not user-editable
+*/
+const SYSTEM_FIELDS = new Set([
+	"id",
+	"createdAt",
+	"updatedAt",
+	"deletedAt",
+	"createdBy",
+	"updatedBy"
+]);
+/**
+* Compute sane default visible columns for a collection
+*
+* Default columns are selected with the following logic:
+* 1. If configuredColumns is provided (from .list()), use those + title
+* 2. Otherwise, auto-detect:
+*    - Title field first
+*    - Up to 4 content fields (non-system, non-relation, non-upload)
+*    - `createdAt` at the end (if timestamps enabled)
+*
+* @param fields - Field definitions from collection config
+* @param options - Optional metadata and configured columns
+* @returns Array of field names for default visible columns
+*/
+function computeDefaultColumns(fields, options) {
+	const titleFieldName = options?.meta?.title?.fieldName;
+	const useTitleField = options?.meta?.title?.type === "field" && titleFieldName;
+	const titleColumn = useTitleField ? titleFieldName : "_title";
+	if (options?.configuredColumns && options.configuredColumns.length > 0) {
+		const configuredNames = options.configuredColumns.map((col) => typeof col === "string" ? col : col.field);
+		const defaultCols$1 = [titleColumn];
+		for (const colName of configuredNames) if (colName !== titleColumn) defaultCols$1.push(colName);
+		return defaultCols$1;
+	}
+	const defaultCols = [titleColumn];
+	if (!fields || Object.keys(fields).length === 0) return defaultCols;
+	const contentFields = [];
+	const systemFields = [];
+	for (const [key, fieldDef] of Object.entries(fields)) {
+		if (useTitleField && key === titleFieldName) continue;
+		if (SYSTEM_FIELDS.has(key)) systemFields.push(key);
+		else contentFields.push(key);
+	}
+	defaultCols.push(...contentFields);
+	if ((options?.meta?.timestamps ?? !!fields.createdAt) && fields.createdAt && !defaultCols.includes("createdAt")) defaultCols.push("createdAt");
+	return defaultCols;
+}
+/**
+* Get all available fields for the column picker
+*
+* Includes all fields (both content and system fields) so users can
+* choose to display any field in their view.
+*
+* @param fields - Field definitions from collection config
+* @param options - Optional metadata from backend
+* @returns Array of available field info for the column picker
+*/
+function getAllAvailableFields(fields, options) {
+	const availableFields = [];
+	const titleFieldName = options?.meta?.title?.fieldName;
+	const titleType = options?.meta?.title?.type;
+	if (!(titleType === "field" && titleFieldName)) if (titleType === "virtual" && titleFieldName && fields?.[titleFieldName]) {
+		const titleLabel = (fields[titleFieldName]?.["~options"] ?? {}).label ?? formatFieldLabel(titleFieldName);
+		availableFields.push({
+			name: "_title",
+			label: titleLabel,
+			type: "text",
+			isSystem: false,
+			options: void 0
+		});
+	} else availableFields.push({
+		name: "_title",
+		label: "Title",
+		type: "text",
+		isSystem: false,
+		options: void 0
+	});
+	if (!fields) return availableFields;
+	for (const [key, fieldDef] of Object.entries(fields)) {
+		if (titleType === "virtual" && key === titleFieldName) continue;
+		const fieldType = fieldDef?.name ?? "text";
+		const fieldOptions = fieldDef?.["~options"] ?? {};
+		const label = fieldOptions.label ?? formatFieldLabel(key);
+		const isSystem = SYSTEM_FIELDS.has(key);
+		availableFields.push({
+			name: key,
+			label,
+			type: fieldType,
+			isSystem,
+			options: fieldOptions
+		});
+	}
+	return availableFields;
+}
+/**
+* Format field name as header (camelCase to Title Case)
+*/
+function formatHeader(fieldName) {
+	return formatFieldLabel(fieldName);
+}
+
+//#endregion
+export { computeDefaultColumns, formatHeader, getAllAvailableFields };
+//# sourceMappingURL=column-defaults.mjs.map

package/dist/client/views/collection/columns/column-defaults.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-defaults.mjs","names":["defaultCols: string[]","defaultCols","contentFields: string[]","systemFields: string[]","availableFields: ColumnField[]"],"sources":["../../../../../src/client/views/collection/columns/column-defaults.ts"],"sourcesContent":["/**\n * Column Defaults Computation\n *\n * Functions for computing default visible columns and available fields\n * Extracted from build-columns.tsx\n */\n\nimport type { FieldDefinition } from \"../../../builder/field/field\";\nimport { formatFieldLabel } from \"../cells/shared/cell-helpers\";\nimport type { ColumnField, ComputeDefaultColumnsOptions } from \"./types\";\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/**\n * System fields that are typically auto-generated and not user-editable\n */\nexport const SYSTEM_FIELDS = new Set([\n\t\"id\",\n\t\"createdAt\",\n\t\"updatedAt\",\n\t\"deletedAt\",\n\t\"createdBy\",\n\t\"updatedBy\",\n]);\n\n/**\n * Field types that are typically not shown by default in list view\n * (too complex or take up too much space)\n */\nexport const EXCLUDED_DEFAULT_FIELD_TYPES = new Set([\n\t\"relation\",\n\t\"reverseRelation\",\n\t\"upload\",\n\t\"uploadMany\",\n\t\"json\",\n\t\"object\",\n\t\"richText\",\n\t\"textarea\",\n]);\n\n/**\n * Maximum number of content fields to show by default\n */\nexport const MAX_DEFAULT_CONTENT_FIELDS = 4;\n\n// ============================================================================\n// Default Column Computation\n// ============================================================================\n\n/**\n * Compute sane default visible columns for a collection\n *\n * Default columns are selected with the following logic:\n * 1. If configuredColumns is provided (from .list()), use those + title\n * 2. Otherwise, auto-detect:\n *    - Title field first\n *    - Up to 4 content fields (non-system, non-relation, non-upload)\n *    - `createdAt` at the end (if timestamps enabled)\n *\n * @param fields - Field definitions from collection config\n * @param options - Optional metadata and configured columns\n * @returns Array of field names for default visible columns\n */\nexport function computeDefaultColumns(\n\tfields?: Record<string, FieldDefinition>,\n\toptions?: ComputeDefaultColumnsOptions,\n): string[] {\n\t// Determine the title column to use\n\tconst titleFieldName = options?.meta?.title?.fieldName;\n\tconst titleType = options?.meta?.title?.type;\n\tconst useTitleField = titleType === \"field\" && titleFieldName;\n\tconst titleColumn = useTitleField ? titleFieldName : \"_title\";\n\n\t// If columns are explicitly configured in .list(), use those\n\tif (options?.configuredColumns && options.configuredColumns.length > 0) {\n\t\tconst configuredNames = options.configuredColumns.map((col) =>\n\t\t\ttypeof col === \"string\" ? col : col.field,\n\t\t);\n\n\t\t// Always include title column first, then configured columns (excluding title to avoid dupe)\n\t\tconst defaultCols: string[] = [titleColumn];\n\t\tfor (const colName of configuredNames) {\n\t\t\tif (colName !== titleColumn) {\n\t\t\t\tdefaultCols.push(colName);\n\t\t\t}\n\t\t}\n\t\treturn defaultCols;\n\t}\n\n\t// No configured columns - show ALL fields by default\n\t// This ensures users see everything when no explicit column config is provided\n\tconst defaultCols: string[] = [titleColumn];\n\n\tif (!fields || Object.keys(fields).length === 0) {\n\t\treturn defaultCols;\n\t}\n\n\t// Add all content fields (non-system fields first, then system fields)\n\tconst contentFields: string[] = [];\n\tconst systemFields: string[] = [];\n\n\tfor (const [key, fieldDef] of Object.entries(fields)) {\n\t\t// Skip the title field if we're already showing it\n\t\tif (useTitleField && key === titleFieldName) continue;\n\n\t\tif (SYSTEM_FIELDS.has(key)) {\n\t\t\tsystemFields.push(key);\n\t\t} else {\n\t\t\tcontentFields.push(key);\n\t\t}\n\t}\n\n\t// Add all content fields\n\tdefaultCols.push(...contentFields);\n\n\t// Add createdAt at the end if timestamps enabled (from meta or field existence)\n\tconst hasTimestamps = options?.meta?.timestamps ?? !!fields.createdAt;\n\tif (hasTimestamps && fields.createdAt && !defaultCols.includes(\"createdAt\")) {\n\t\tdefaultCols.push(\"createdAt\");\n\t}\n\n\treturn defaultCols;\n}\n\n// ============================================================================\n// Available Fields\n// ============================================================================\n\n/**\n * Get all available fields for the column picker\n *\n * Includes all fields (both content and system fields) so users can\n * choose to display any field in their view.\n *\n * @param fields - Field definitions from collection config\n * @param options - Optional metadata from backend\n * @returns Array of available field info for the column picker\n */\nexport function getAllAvailableFields(\n\tfields?: Record<string, FieldDefinition>,\n\toptions?: ComputeDefaultColumnsOptions,\n): ColumnField[] {\n\tconst availableFields: ColumnField[] = [];\n\n\t// Determine title field from meta\n\tconst titleFieldName = options?.meta?.title?.fieldName;\n\tconst titleType = options?.meta?.title?.type;\n\tconst useTitleField = titleType === \"field\" && titleFieldName;\n\n\t// Only add _title as an option if title is NOT a real field\n\t// (i.e., title is virtual/computed, so _title is the way to access it)\n\tif (!useTitleField) {\n\t\t// For virtual titles, show the virtual field's label instead of generic \"Title\"\n\t\tif (titleType === \"virtual\" && titleFieldName && fields?.[titleFieldName]) {\n\t\t\tconst titleFieldDef = fields[titleFieldName];\n\t\t\tconst titleFieldOptions = titleFieldDef?.[\"~options\"] ?? {};\n\t\t\tconst titleLabel =\n\t\t\t\ttitleFieldOptions.label ?? formatFieldLabel(titleFieldName);\n\t\t\tavailableFields.push({\n\t\t\t\tname: \"_title\",\n\t\t\t\tlabel: titleLabel,\n\t\t\t\ttype: \"text\",\n\t\t\t\tisSystem: false,\n\t\t\t\toptions: undefined,\n\t\t\t});\n\t\t} else {\n\t\t\t// Fallback to generic \"Title\" when no title defined or field not found\n\t\t\tavailableFields.push({\n\t\t\t\tname: \"_title\",\n\t\t\t\tlabel: \"Title\",\n\t\t\t\ttype: \"text\",\n\t\t\t\tisSystem: false,\n\t\t\t\toptions: undefined,\n\t\t\t});\n\t\t}\n\t}\n\n\tif (!fields) return availableFields;\n\n\t// Add all fields from config (except virtual title field to avoid duplication)\n\tfor (const [key, fieldDef] of Object.entries(fields)) {\n\t\t// Skip the virtual title field since we already added _title for it\n\t\tif (titleType === \"virtual\" && key === titleFieldName) continue;\n\n\t\tconst fieldType = fieldDef?.name ?? \"text\";\n\t\tconst fieldOptions = fieldDef?.[\"~options\"] ?? {};\n\t\tconst label = fieldOptions.label ?? formatFieldLabel(key);\n\t\tconst isSystem = SYSTEM_FIELDS.has(key);\n\n\t\tavailableFields.push({\n\t\t\tname: key,\n\t\t\tlabel,\n\t\t\ttype: fieldType,\n\t\t\tisSystem,\n\t\t\toptions: fieldOptions,\n\t\t});\n\t}\n\n\treturn availableFields;\n}\n\n/**\n * Format field name as header (camelCase to Title Case)\n */\nexport function formatHeader(fieldName: string): string {\n\treturn formatFieldLabel(fieldName);\n}\n"],"mappings":";;;;;;AAkBA,MAAa,gBAAgB,IAAI,IAAI;CACpC;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;;;;;;;;;;;;;;;AAwCF,SAAgB,sBACf,QACA,SACW;CAEX,MAAM,iBAAiB,SAAS,MAAM,OAAO;CAE7C,MAAM,gBADY,SAAS,MAAM,OAAO,SACJ,WAAW;CAC/C,MAAM,cAAc,gBAAgB,iBAAiB;AAGrD,KAAI,SAAS,qBAAqB,QAAQ,kBAAkB,SAAS,GAAG;EACvE,MAAM,kBAAkB,QAAQ,kBAAkB,KAAK,QACtD,OAAO,QAAQ,WAAW,MAAM,IAAI,MACpC;EAGD,MAAMA,gBAAwB,CAAC,YAAY;AAC3C,OAAK,MAAM,WAAW,gBACrB,KAAI,YAAY,YACf,eAAY,KAAK,QAAQ;AAG3B,SAAOC;;CAKR,MAAMD,cAAwB,CAAC,YAAY;AAE3C,KAAI,CAAC,UAAU,OAAO,KAAK,OAAO,CAAC,WAAW,EAC7C,QAAO;CAIR,MAAME,gBAA0B,EAAE;CAClC,MAAMC,eAAyB,EAAE;AAEjC,MAAK,MAAM,CAAC,KAAK,aAAa,OAAO,QAAQ,OAAO,EAAE;AAErD,MAAI,iBAAiB,QAAQ,eAAgB;AAE7C,MAAI,cAAc,IAAI,IAAI,CACzB,cAAa,KAAK,IAAI;MAEtB,eAAc,KAAK,IAAI;;AAKzB,aAAY,KAAK,GAAG,cAAc;AAIlC,MADsB,SAAS,MAAM,cAAc,CAAC,CAAC,OAAO,cACvC,OAAO,aAAa,CAAC,YAAY,SAAS,YAAY,CAC1E,aAAY,KAAK,YAAY;AAG9B,QAAO;;;;;;;;;;;;AAiBR,SAAgB,sBACf,QACA,SACgB;CAChB,MAAMC,kBAAiC,EAAE;CAGzC,MAAM,iBAAiB,SAAS,MAAM,OAAO;CAC7C,MAAM,YAAY,SAAS,MAAM,OAAO;AAKxC,KAAI,EAJkB,cAAc,WAAW,gBAM9C,KAAI,cAAc,aAAa,kBAAkB,SAAS,iBAAiB;EAG1E,MAAM,cAFgB,OAAO,kBACa,eAAe,EAAE,EAExC,SAAS,iBAAiB,eAAe;AAC5D,kBAAgB,KAAK;GACpB,MAAM;GACN,OAAO;GACP,MAAM;GACN,UAAU;GACV,SAAS;GACT,CAAC;OAGF,iBAAgB,KAAK;EACpB,MAAM;EACN,OAAO;EACP,MAAM;EACN,UAAU;EACV,SAAS;EACT,CAAC;AAIJ,KAAI,CAAC,OAAQ,QAAO;AAGpB,MAAK,MAAM,CAAC,KAAK,aAAa,OAAO,QAAQ,OAAO,EAAE;AAErD,MAAI,cAAc,aAAa,QAAQ,eAAgB;EAEvD,MAAM,YAAY,UAAU,QAAQ;EACpC,MAAM,eAAe,WAAW,eAAe,EAAE;EACjD,MAAM,QAAQ,aAAa,SAAS,iBAAiB,IAAI;EACzD,MAAM,WAAW,cAAc,IAAI,IAAI;AAEvC,kBAAgB,KAAK;GACpB,MAAM;GACN;GACA,MAAM;GACN;GACA,SAAS;GACT,CAAC;;AAGH,QAAO;;;;;AAMR,SAAgB,aAAa,WAA2B;AACvD,QAAO,iBAAiB,UAAU"}

package/dist/client/views/collection/columns/index.d.mts

@@ -0,0 +1,3 @@
+import "./types.mjs";
+import "./build-columns.mjs";
+import "./column-defaults.mjs";

package/dist/client/views/collection/columns/types.d.mts

@@ -0,0 +1,2 @@
+import "../../../builder/field/field.mjs";
+import "../../../builder/types/collection-types.mjs";

package/dist/client/views/collection/field-context.mjs

@@ -0,0 +1,127 @@
+//#region src/client/views/collection/field-context.ts
+/**
+* Get field type from FieldDefinition
+* FieldDefinition.name contains the type name (e.g., "text", "relation")
+*/
+function getFieldType(fieldDef) {
+	if (!fieldDef) return void 0;
+	return fieldDef.name;
+}
+/**
+* Get field options from FieldDefinition
+* Options are stored in "~options" property
+*/
+function getFieldOptions(fieldDef) {
+	if (!fieldDef) return {};
+	return fieldDef["~options"] || {};
+}
+/**
+* Get field component from FieldDefinition
+* Component is stored in field.component
+*/
+function getFieldComponent(fieldDef) {
+	if (!fieldDef?.field?.component) return void 0;
+	return fieldDef.field.component;
+}
+function resolveValue(value, formValues, defaultValue) {
+	if (value === void 0) return defaultValue;
+	if (typeof value === "function") return value(formValues);
+	return value;
+}
+/**
+* Get form values for conditional field logic.
+*
+* @deprecated This is a legacy fallback. All callers should now use useWatch()
+* hook in their component and pass the watched values to getFieldContext via
+* the `formValues` parameter. This function uses form.watch() which doesn't
+* properly integrate with React's render cycle.
+*
+* Best practice pattern:
+* ```tsx
+* const watchedValues = useWatch({ control: form.control });
+* const context = getFieldContext({ ..., formValues: watchedValues });
+* ```
+*/
+function getFormValues(form, fieldPrefix) {
+	if (!form?.watch) return {};
+	return (fieldPrefix ? form.watch(fieldPrefix) : form.watch()) ?? {};
+}
+function getFullFieldName(fieldName, fieldPrefix) {
+	return fieldPrefix ? `${fieldPrefix}.${fieldName}` : fieldName;
+}
+/**
+* Create a FieldContext object from field definition and form context.
+* Contains all information needed to render a field component.
+*/
+function getFieldContext({ fieldName, fieldDef, collection, form, fieldPrefix, locale, formValues: formValuesProp, entityMeta }) {
+	const formValues = formValuesProp ?? getFormValues(form, fieldPrefix);
+	const fullFieldName = getFullFieldName(fieldName, fieldPrefix);
+	const fieldError = (form?.getFieldState ? form.getFieldState(fullFieldName) : void 0)?.error?.message;
+	const fieldValue = formValues[fieldName];
+	const options = getFieldOptions(fieldDef);
+	const type = getFieldType(fieldDef);
+	const component = getFieldComponent(fieldDef);
+	const label = options.label;
+	const description = options.description;
+	const placeholder = options.placeholder;
+	const isHidden = resolveValue(options.hidden, formValues, false);
+	const isComputed = typeof options.compute === "function";
+	const isReadOnly = isComputed || resolveValue(options.readOnly, formValues, false);
+	const isDisabled = resolveValue(options.disabled, formValues, false);
+	const isRequired = resolveValue(options.required, formValues, false);
+	const isLocalized = options.localized !== void 0 ? !!options.localized : entityMeta?.localizedFields?.includes(fieldName) ?? false;
+	const selectOptions = options.options ? typeof options.options === "function" ? options.options(formValues) : options.options : void 0;
+	const updateValue = (nextValue) => {
+		if (form?.setValue) form.setValue(fullFieldName, nextValue, {
+			shouldDirty: true,
+			shouldTouch: true
+		});
+	};
+	return {
+		fieldName,
+		fullFieldName,
+		collection,
+		fieldDef,
+		fieldValue,
+		label,
+		description,
+		placeholder,
+		options: selectOptions,
+		isHidden,
+		isReadOnly,
+		isDisabled,
+		isRequired,
+		isLocalized,
+		isComputed,
+		locale,
+		fieldError,
+		updateValue,
+		type,
+		component,
+		compute: options.compute
+	};
+}
+/**
+* Build props for a FieldDefinition component (field.component).
+* Returns raw props with I18nText - resolve before passing to component.
+*/
+function buildComponentProps(context) {
+	return {
+		name: context.fullFieldName,
+		value: context.fieldValue,
+		onChange: context.updateValue,
+		label: context.label,
+		description: context.description,
+		placeholder: context.placeholder,
+		required: context.isRequired,
+		disabled: context.isDisabled,
+		readOnly: context.isReadOnly,
+		error: context.fieldError,
+		localized: context.isLocalized,
+		locale: context.locale
+	};
+}
+
+//#endregion
+export { buildComponentProps, getFieldContext, getFieldOptions, getFullFieldName, resolveValue };
+//# sourceMappingURL=field-context.mjs.map

package/dist/client/views/collection/field-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-context.mjs","names":[],"sources":["../../../../src/client/views/collection/field-context.ts"],"sourcesContent":["/**\n * Field Context\n *\n * Provides context and utilities for rendering form fields.\n * Extracted from auto-form-fields.tsx for better modularity.\n */\n\nimport type React from \"react\";\nimport type { FieldDefinition } from \"../../builder/field/field\";\nimport type { DynamicI18nText } from \"../../builder/types/common\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Context object containing all information needed to render a field.\n * Note: label, description, placeholder can be I18nText - resolve them before passing to components.\n */\nexport type FieldContext = {\n\tfieldName: string;\n\tfullFieldName: string;\n\tcollection: string;\n\tfieldDef?: FieldDefinition;\n\tfieldValue: any;\n\t/** Can be I18nText - must be resolved before passing to component */\n\tlabel?: DynamicI18nText;\n\t/** Can be I18nText - must be resolved before passing to component */\n\tdescription?: DynamicI18nText;\n\t/** Can be I18nText - must be resolved before passing to component */\n\tplaceholder?: DynamicI18nText;\n\toptions?: Array<{ label: string; value: any }>;\n\t/** Whether field is hidden (not rendered). Default false. */\n\tisHidden: boolean;\n\t/** Whether field is read-only (normal look, not editable). Computed fields are always readonly. */\n\tisReadOnly: boolean;\n\t/** Whether field is disabled (grayed out). */\n\tisDisabled: boolean;\n\tisRequired: boolean;\n\tisLocalized: boolean;\n\t/** Whether field has a compute function */\n\tisComputed: boolean;\n\tlocale?: string;\n\tfieldError?: string;\n\tupdateValue: (nextValue: any) => void;\n\ttype?: string;\n\tcomponent?: React.ComponentType<any>;\n\t/** Compute function if field is computed */\n\tcompute?: (values: Record<string, any>) => any;\n};\n\n// ============================================================================\n// Helper Functions - Field Definition Access\n// ============================================================================\n\n/**\n * Get field type from FieldDefinition\n * FieldDefinition.name contains the type name (e.g., \"text\", \"relation\")\n */\nexport function getFieldType(\n\tfieldDef: FieldDefinition | undefined,\n): string | undefined {\n\tif (!fieldDef) return undefined;\n\t// FieldDefinition stores the field type in 'name' property\n\t// This comes from field(\"text\", ...) where \"text\" is the type\n\treturn fieldDef.name;\n}\n\n/**\n * Get field options from FieldDefinition\n * Options are stored in \"~options\" property\n */\nexport function getFieldOptions(\n\tfieldDef: FieldDefinition | undefined,\n): Record<string, any> {\n\tif (!fieldDef) return {};\n\treturn (fieldDef as any)[\"~options\"] || {};\n}\n\n/**\n * Get field component from FieldDefinition\n * Component is stored in field.component\n */\nexport function getFieldComponent(\n\tfieldDef: FieldDefinition | undefined,\n): React.ComponentType<any> | undefined {\n\tif (!fieldDef?.field?.component) return undefined;\n\treturn fieldDef.field.component as React.ComponentType<any>;\n}\n\n// ============================================================================\n// Helper Functions - Value Resolution\n// ============================================================================\n\ntype ValueResolver<T> = T | ((values: any) => T);\n\nexport function resolveValue<T>(\n\tvalue: ValueResolver<T> | undefined,\n\tformValues: any,\n\tdefaultValue: T,\n): T {\n\tif (value === undefined) return defaultValue;\n\tif (typeof value === \"function\") {\n\t\treturn (value as (values: any) => T)(formValues);\n\t}\n\treturn value;\n}\n\n/**\n * Get form values for conditional field logic.\n *\n * @deprecated This is a legacy fallback. All callers should now use useWatch()\n * hook in their component and pass the watched values to getFieldContext via\n * the `formValues` parameter. This function uses form.watch() which doesn't\n * properly integrate with React's render cycle.\n *\n * Best practice pattern:\n * ```tsx\n * const watchedValues = useWatch({ control: form.control });\n * const context = getFieldContext({ ..., formValues: watchedValues });\n * ```\n */\nexport function getFormValues(form: any, fieldPrefix?: string) {\n\tif (!form?.watch) return {};\n\tconst values = fieldPrefix ? form.watch(fieldPrefix) : form.watch();\n\treturn values ?? {};\n}\n\nexport function getFullFieldName(fieldName: string, fieldPrefix?: string) {\n\treturn fieldPrefix ? `${fieldPrefix}.${fieldName}` : fieldName;\n}\n\n// ============================================================================\n// Field Context Factory\n// ============================================================================\n\nexport interface GetFieldContextParams {\n\tfieldName: string;\n\tfieldDef?: FieldDefinition;\n\tcollection: string;\n\tform: any;\n\tfieldPrefix?: string;\n\tlocale?: string;\n\t/** Entity metadata from backend (for inferring localized fields) */\n\tentityMeta?: { localizedFields?: string[] };\n\t/**\n\t * Pre-watched form values from useWatch hook.\n\t * If provided, avoids calling form.watch() internally.\n\t * This is the preferred pattern for better React integration.\n\t */\n\tformValues?: Record<string, any>;\n}\n\n/**\n * Create a FieldContext object from field definition and form context.\n * Contains all information needed to render a field component.\n */\nexport function getFieldContext({\n\tfieldName,\n\tfieldDef,\n\tcollection,\n\tform,\n\tfieldPrefix,\n\tlocale,\n\tformValues: formValuesProp,\n\tentityMeta,\n}: GetFieldContextParams): FieldContext {\n\t// Use pre-watched values if provided (preferred), otherwise fall back to form.watch()\n\tconst formValues = formValuesProp ?? getFormValues(form, fieldPrefix);\n\tconst fullFieldName = getFullFieldName(fieldName, fieldPrefix);\n\tconst fieldState = form?.getFieldState\n\t\t? form.getFieldState(fullFieldName)\n\t\t: undefined;\n\tconst fieldError = fieldState?.error?.message;\n\tconst fieldValue = formValues[fieldName];\n\n\t// Get options from FieldDefinition\n\tconst options = getFieldOptions(fieldDef);\n\tconst type = getFieldType(fieldDef);\n\tconst component = getFieldComponent(fieldDef);\n\n\tconst label = options.label;\n\tconst description = options.description;\n\tconst placeholder = options.placeholder;\n\n\t// hidden: false/undefined = visible, true = hidden\n\tconst isHidden = resolveValue(options.hidden, formValues, false);\n\t// compute implies readonly\n\tconst isComputed = typeof options.compute === \"function\";\n\tconst isReadOnly =\n\t\tisComputed || resolveValue(options.readOnly, formValues, false);\n\tconst isDisabled = resolveValue(options.disabled, formValues, false);\n\tconst isRequired = resolveValue(options.required, formValues, false);\n\n\t// Check if field is localized: explicit config takes priority, fallback to BE metadata\n\tconst isLocalized =\n\t\toptions.localized !== undefined\n\t\t\t? !!options.localized\n\t\t\t: (entityMeta?.localizedFields?.includes(fieldName) ?? false);\n\n\t// Resolve dynamic options for select fields\n\tconst selectOptions = options.options\n\t\t? typeof options.options === \"function\"\n\t\t\t? options.options(formValues)\n\t\t\t: options.options\n\t\t: undefined;\n\n\tconst updateValue = (nextValue: any) => {\n\t\tif (form?.setValue) {\n\t\t\tform.setValue(fullFieldName, nextValue, {\n\t\t\t\tshouldDirty: true,\n\t\t\t\tshouldTouch: true,\n\t\t\t});\n\t\t}\n\t};\n\n\treturn {\n\t\tfieldName,\n\t\tfullFieldName,\n\t\tcollection,\n\t\tfieldDef,\n\t\tfieldValue,\n\t\tlabel,\n\t\tdescription,\n\t\tplaceholder,\n\t\toptions: selectOptions,\n\t\tisHidden,\n\t\tisReadOnly,\n\t\tisDisabled,\n\t\tisRequired,\n\t\tisLocalized,\n\t\tisComputed,\n\t\tlocale,\n\t\tfieldError,\n\t\tupdateValue,\n\t\ttype,\n\t\tcomponent,\n\t\tcompute: options.compute,\n\t};\n}\n\n// ============================================================================\n// Component Props Builders\n// ============================================================================\n\n/**\n * Raw component props with I18nText (needs resolution before passing to components)\n */\nexport type RawComponentProps = {\n\tname: string;\n\tvalue: any;\n\tonChange: (value: any) => void;\n\tlabel?: DynamicI18nText;\n\tdescription?: DynamicI18nText;\n\tplaceholder?: DynamicI18nText;\n\trequired: boolean;\n\tdisabled: boolean;\n\treadOnly: boolean;\n\terror?: string;\n\tlocalized: boolean;\n\tlocale?: string;\n};\n\n/**\n * Build props for a FieldDefinition component (field.component).\n * Returns raw props with I18nText - resolve before passing to component.\n */\nexport function buildComponentProps(context: FieldContext): RawComponentProps {\n\treturn {\n\t\tname: context.fullFieldName,\n\t\tvalue: context.fieldValue,\n\t\tonChange: context.updateValue,\n\t\tlabel: context.label,\n\t\tdescription: context.description,\n\t\tplaceholder: context.placeholder,\n\t\trequired: context.isRequired,\n\t\tdisabled: context.isDisabled,\n\t\treadOnly: context.isReadOnly,\n\t\terror: context.fieldError,\n\t\tlocalized: context.isLocalized,\n\t\tlocale: context.locale,\n\t};\n}\n"],"mappings":";;;;;AA2DA,SAAgB,aACf,UACqB;AACrB,KAAI,CAAC,SAAU,QAAO;AAGtB,QAAO,SAAS;;;;;;AAOjB,SAAgB,gBACf,UACsB;AACtB,KAAI,CAAC,SAAU,QAAO,EAAE;AACxB,QAAQ,SAAiB,eAAe,EAAE;;;;;;AAO3C,SAAgB,kBACf,UACuC;AACvC,KAAI,CAAC,UAAU,OAAO,UAAW,QAAO;AACxC,QAAO,SAAS,MAAM;;AASvB,SAAgB,aACf,OACA,YACA,cACI;AACJ,KAAI,UAAU,OAAW,QAAO;AAChC,KAAI,OAAO,UAAU,WACpB,QAAQ,MAA6B,WAAW;AAEjD,QAAO;;;;;;;;;;;;;;;;AAiBR,SAAgB,cAAc,MAAW,aAAsB;AAC9D,KAAI,CAAC,MAAM,MAAO,QAAO,EAAE;AAE3B,SADe,cAAc,KAAK,MAAM,YAAY,GAAG,KAAK,OAAO,KAClD,EAAE;;AAGpB,SAAgB,iBAAiB,WAAmB,aAAsB;AACzE,QAAO,cAAc,GAAG,YAAY,GAAG,cAAc;;;;;;AA4BtD,SAAgB,gBAAgB,EAC/B,WACA,UACA,YACA,MACA,aACA,QACA,YAAY,gBACZ,cACuC;CAEvC,MAAM,aAAa,kBAAkB,cAAc,MAAM,YAAY;CACrE,MAAM,gBAAgB,iBAAiB,WAAW,YAAY;CAI9D,MAAM,cAHa,MAAM,gBACtB,KAAK,cAAc,cAAc,GACjC,SAC4B,OAAO;CACtC,MAAM,aAAa,WAAW;CAG9B,MAAM,UAAU,gBAAgB,SAAS;CACzC,MAAM,OAAO,aAAa,SAAS;CACnC,MAAM,YAAY,kBAAkB,SAAS;CAE7C,MAAM,QAAQ,QAAQ;CACtB,MAAM,cAAc,QAAQ;CAC5B,MAAM,cAAc,QAAQ;CAG5B,MAAM,WAAW,aAAa,QAAQ,QAAQ,YAAY,MAAM;CAEhE,MAAM,aAAa,OAAO,QAAQ,YAAY;CAC9C,MAAM,aACL,cAAc,aAAa,QAAQ,UAAU,YAAY,MAAM;CAChE,MAAM,aAAa,aAAa,QAAQ,UAAU,YAAY,MAAM;CACpE,MAAM,aAAa,aAAa,QAAQ,UAAU,YAAY,MAAM;CAGpE,MAAM,cACL,QAAQ,cAAc,SACnB,CAAC,CAAC,QAAQ,YACT,YAAY,iBAAiB,SAAS,UAAU,IAAI;CAGzD,MAAM,gBAAgB,QAAQ,UAC3B,OAAO,QAAQ,YAAY,aAC1B,QAAQ,QAAQ,WAAW,GAC3B,QAAQ,UACT;CAEH,MAAM,eAAe,cAAmB;AACvC,MAAI,MAAM,SACT,MAAK,SAAS,eAAe,WAAW;GACvC,aAAa;GACb,aAAa;GACb,CAAC;;AAIJ,QAAO;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS;EACT;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,SAAS,QAAQ;EACjB;;;;;;AA6BF,SAAgB,oBAAoB,SAA0C;AAC7E,QAAO;EACN,MAAM,QAAQ;EACd,OAAO,QAAQ;EACf,UAAU,QAAQ;EAClB,OAAO,QAAQ;EACf,aAAa,QAAQ;EACrB,aAAa,QAAQ;EACrB,UAAU,QAAQ;EAClB,UAAU,QAAQ;EAClB,UAAU,QAAQ;EAClB,OAAO,QAAQ;EACf,WAAW,QAAQ;EACnB,QAAQ,QAAQ;EAChB"}

package/dist/client/views/collection/field-renderer.mjs

@@ -0,0 +1,171 @@
+import { useResolveText } from "../../i18n/hooks.mjs";
+import { useScopedLocale } from "../../runtime/locale-scope.mjs";
+import { buildComponentProps, getFieldContext, getFieldOptions, getFullFieldName } from "./field-context.mjs";
+import { useAdminConfig } from "../../hooks/use-admin-config.mjs";
+import { useCollectionMeta } from "../../hooks/use-collection-meta.mjs";
+import { useFieldHooks } from "../../hooks/use-field-hooks.mjs";
+import { useGlobalMeta } from "../../hooks/use-global-meta.mjs";
+import * as React$1 from "react";
+import { useFormContext, useWatch } from "react-hook-form";
+import { Fragment, jsx } from "react/jsx-runtime";
+
+//#region src/client/views/collection/field-renderer.tsx
+/**
+* FieldRenderer Component
+*
+* Renders a single form field using FieldDefinition.
+* Shared between AutoFormFields and BlockEditor.
+*/
+function renderConfigError(message) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive rounded",
+		children: message
+	});
+}
+function stripFieldUiOptions(options) {
+	const { label, description, placeholder, required, disabled, readOnly, visible, localized, locale, ...rest } = options;
+	return rest;
+}
+/**
+* Render field using FieldDefinition.field.component
+*
+* This is the primary rendering method. Field components receive:
+* - Base props (name, value, onChange, label, etc.) from componentProps
+* - Field-specific options from FieldDefinition["~options"]
+*/
+function renderDefinitionComponent({ context, componentProps, blocks }) {
+	const Component = context.component;
+	if (!Component) return null;
+	const options = stripFieldUiOptions(getFieldOptions(context.fieldDef));
+	if (context.type === "blocks" && blocks) return /* @__PURE__ */ jsx(Component, {
+		...componentProps,
+		...options,
+		blocks
+	});
+	return /* @__PURE__ */ jsx(Component, {
+		...componentProps,
+		...options
+	});
+}
+/**
+* Render embedded collection field
+*
+* Embedded fields need special handling because they require:
+* 1. Access to allCollectionsConfig for the embedded collection's config
+* 2. A renderFields callback that recursively renders AutoFormFields
+*/
+function renderEmbeddedField({ context, registry, allCollectionsConfig, componentProps, renderEmbeddedFields }) {
+	if (context.type !== "embedded") return null;
+	const options = stripFieldUiOptions(getFieldOptions(context.fieldDef));
+	const embeddedCollection = options.collection;
+	if (!embeddedCollection) return renderConfigError(`Missing collection for embedded field "${context.fieldName}".`);
+	const embeddedCollectionConfig = allCollectionsConfig?.[embeddedCollection];
+	const EmbeddedComponent = context.component || registry?.fields?.embedded;
+	if (!EmbeddedComponent) return renderConfigError(`No component found for embedded field "${context.fieldName}".`);
+	return /* @__PURE__ */ jsx(EmbeddedComponent, {
+		...componentProps,
+		...options,
+		value: context.fieldValue || [],
+		collection: embeddedCollection,
+		renderFields: (index) => renderEmbeddedFields?.({
+			embeddedCollection,
+			embeddedCollectionConfig,
+			fullFieldName: context.fullFieldName,
+			index
+		})
+	});
+}
+/**
+* Render a single field with conditional logic
+*
+* Rendering priority:
+* 1. Embedded fields (need special handling for recursive AutoFormFields)
+* 2. FieldDefinition.field.component (registry-first approach)
+* 3. Error message if no component registered
+*/
+function FieldRenderer({ fieldName, fieldDef, collection, mode = "collection", registry, fieldPrefix, allCollectionsConfig, renderEmbeddedFields, className, entityMeta: entityMetaProp }) {
+	const form = useFormContext();
+	const { locale } = useScopedLocale();
+	const resolveText = useResolveText();
+	const { data: adminConfig } = useAdminConfig();
+	const watchedValues = useWatch({ control: form.control });
+	const fullFieldName = getFullFieldName(fieldName, fieldPrefix);
+	const watchedFieldValue = useWatch({
+		control: form.control,
+		name: fullFieldName
+	});
+	const formValues = React$1.useMemo(() => {
+		if (!watchedValues) return {};
+		if (!fieldPrefix) return watchedValues;
+		const parts = fieldPrefix.split(".");
+		let result = watchedValues;
+		for (const part of parts) {
+			result = result?.[part];
+			if (result === void 0) return {};
+		}
+		return result ?? {};
+	}, [watchedValues, fieldPrefix]);
+	const { data: fetchedCollectionMeta } = useCollectionMeta(collection, { enabled: !entityMetaProp && mode === "collection" });
+	const { data: fetchedGlobalMeta } = useGlobalMeta(collection, { enabled: !entityMetaProp && mode === "global" });
+	const context = getFieldContext({
+		fieldName,
+		fieldDef,
+		collection,
+		form,
+		fieldPrefix,
+		locale,
+		entityMeta: entityMetaProp ?? (mode === "global" ? fetchedGlobalMeta : fetchedCollectionMeta),
+		formValues
+	});
+	const fieldOptions = getFieldOptions(fieldDef);
+	const clientSideCompute = typeof fieldOptions.compute === "function" ? fieldOptions.compute : void 0;
+	const { handleChange, computedValue, isComputed, options: hookOptions, optionsLoading } = useFieldHooks({
+		fieldName,
+		fullFieldName: context.fullFieldName,
+		locale,
+		compute: clientSideCompute,
+		onChange: fieldOptions.onChange,
+		defaultValue: fieldOptions.defaultValue,
+		loadOptions: fieldOptions.loadOptions,
+		staticOptions: context.options
+	});
+	if (context.isHidden) return null;
+	if (!fieldDef) return renderConfigError(`Field "${fieldName}" not found in ${mode === "global" ? "global" : "collection"} "${collection}" config.`);
+	const resolvedOptions = hookOptions ?? context.options;
+	const rawComponentProps = buildComponentProps(context);
+	const fieldValue = isComputed ? computedValue : watchedFieldValue === void 0 ? rawComponentProps.value : watchedFieldValue;
+	const componentProps = {
+		...rawComponentProps,
+		value: fieldValue,
+		onChange: handleChange,
+		options: resolvedOptions,
+		optionsLoading,
+		readOnly: rawComponentProps.readOnly || isComputed,
+		label: resolveText(rawComponentProps.label, "", formValues),
+		description: resolveText(rawComponentProps.description, "", formValues),
+		placeholder: resolveText(rawComponentProps.placeholder, "", formValues)
+	};
+	let content = null;
+	if (context.type === "embedded") content = renderEmbeddedField({
+		context,
+		registry,
+		allCollectionsConfig,
+		componentProps,
+		renderEmbeddedFields
+	});
+	if (!content && context.component) content = renderDefinitionComponent({
+		context,
+		componentProps,
+		blocks: adminConfig?.blocks
+	});
+	if (!content) content = renderConfigError(`No component registered for field type "${context.type}" (field: "${context.fieldName}").`);
+	if (className) return /* @__PURE__ */ jsx("div", {
+		className,
+		children: content
+	});
+	return /* @__PURE__ */ jsx(Fragment, { children: content });
+}
+
+//#endregion
+export { FieldRenderer };
+//# sourceMappingURL=field-renderer.mjs.map