@questpie/admin 1.1.0 → 2.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-renderer.mjs","names":["React","result: any","content: React.ReactNode"],"sources":["../../../../src/client/views/collection/field-renderer.tsx"],"sourcesContent":["/**\n * FieldRenderer Component\n *\n * Renders a single form field using FieldDefinition.\n * Shared between AutoFormFields and BlockEditor.\n */\n\nimport * as React from \"react\";\nimport { useFormContext, useWatch } from \"react-hook-form\";\nimport type { ComponentRegistry } from \"../../builder\";\nimport type { FieldDefinition } from \"../../builder/field/field\";\nimport { useAdminConfig } from \"../../hooks/use-admin-config\";\nimport { useCollectionMeta } from \"../../hooks/use-collection-meta\";\nimport { useFieldHooks } from \"../../hooks/use-field-hooks\";\nimport { useGlobalMeta } from \"../../hooks/use-global-meta\";\nimport { useResolveText } from \"../../i18n/hooks\";\nimport { useScopedLocale } from \"../../runtime\";\nimport {\n\tbuildComponentProps,\n\ttype FieldContext,\n\tgetFieldContext,\n\tgetFieldOptions,\n\tgetFullFieldName,\n} from \"./field-context\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface FieldRendererProps {\n\tfieldName: string;\n\tfieldDef?: FieldDefinition;\n\tcollection: string;\n\t/** Entity type - determines which meta hook to use */\n\tmode?: \"collection\" | \"global\";\n\tregistry?: ComponentRegistry;\n\tfieldPrefix?: string;\n\tclassName?: string;\n\t/**\n\t * Callback to render embedded collection fields.\n\t * Required for embedded fields to work (handles recursive AutoFormFields).\n\t */\n\trenderEmbeddedFields?: (params: {\n\t\tembeddedCollection: string;\n\t\tembeddedCollectionConfig: any;\n\t\tfullFieldName: string;\n\t\tindex: number;\n\t}) => React.ReactNode;\n\t/**\n\t * All collection configs (for embedded collections)\n\t */\n\tallCollectionsConfig?: Record<string, any>;\n\t/**\n\t * Entity metadata from backend (for inferring localized fields)\n\t */\n\tentityMeta?: { localizedFields?: string[] };\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction renderConfigError(message: string) {\n\treturn (\n\t\t<div className=\"border border-destructive/40 bg-destructive/5 p-3 text-sm text-destructive rounded\">\n\t\t\t{message}\n\t\t</div>\n\t);\n}\n\nfunction stripFieldUiOptions(options: Record<string, any>) {\n\tconst {\n\t\tlabel,\n\t\tdescription,\n\t\tplaceholder,\n\t\trequired,\n\t\tdisabled,\n\t\treadOnly,\n\t\tvisible,\n\t\tlocalized,\n\t\tlocale,\n\t\t...rest\n\t} = options;\n\n\treturn rest;\n}\n\n/**\n * Render field using FieldDefinition.field.component\n *\n * This is the primary rendering method. Field components receive:\n * - Base props (name, value, onChange, label, etc.) from componentProps\n * - Field-specific options from FieldDefinition[\"~options\"]\n */\nfunction renderDefinitionComponent({\n\tcontext,\n\tcomponentProps,\n\tblocks,\n}: {\n\tcontext: FieldContext;\n\tcomponentProps: ReturnType<typeof buildComponentProps>;\n\tblocks?: Record<string, any>;\n}) {\n\tconst Component = context.component;\n\tif (!Component) return null;\n\n\t// Get field-specific options from FieldDefinition\n\tconst options = stripFieldUiOptions(getFieldOptions(context.fieldDef));\n\n\t// For blocks field, inject the blocks registry from admin state\n\tif (context.type === \"blocks\" && blocks) {\n\t\treturn <Component {...componentProps} {...options} blocks={blocks} />;\n\t}\n\n\treturn <Component {...componentProps} {...options} />;\n}\n\n/**\n * Render embedded collection field\n *\n * Embedded fields need special handling because they require:\n * 1. Access to allCollectionsConfig for the embedded collection's config\n * 2. A renderFields callback that recursively renders AutoFormFields\n */\nfunction renderEmbeddedField({\n\tcontext,\n\tregistry,\n\tallCollectionsConfig,\n\tcomponentProps,\n\trenderEmbeddedFields,\n}: {\n\tcontext: FieldContext;\n\tregistry?: ComponentRegistry;\n\tallCollectionsConfig?: Record<string, any>;\n\tcomponentProps: ReturnType<typeof buildComponentProps>;\n\trenderEmbeddedFields?: FieldRendererProps[\"renderEmbeddedFields\"];\n}) {\n\tif (context.type !== \"embedded\") return null;\n\n\tconst options = stripFieldUiOptions(getFieldOptions(context.fieldDef));\n\tconst embeddedCollection = options.collection;\n\n\tif (!embeddedCollection) {\n\t\treturn renderConfigError(\n\t\t\t`Missing collection for embedded field \"${context.fieldName}\".`,\n\t\t);\n\t}\n\n\tconst embeddedCollectionConfig = allCollectionsConfig?.[embeddedCollection];\n\n\t// Use the component from FieldDefinition, or fall back to registry/default\n\tconst EmbeddedComponent =\n\t\tcontext.component ||\n\t\t(registry?.fields?.embedded as React.ComponentType<any>);\n\n\tif (!EmbeddedComponent) {\n\t\treturn renderConfigError(\n\t\t\t`No component found for embedded field \"${context.fieldName}\".`,\n\t\t);\n\t}\n\n\treturn (\n\t\t<EmbeddedComponent\n\t\t\t{...componentProps}\n\t\t\t{...options}\n\t\t\tvalue={context.fieldValue || []}\n\t\t\tcollection={embeddedCollection}\n\t\t\trenderFields={(index: number) =>\n\t\t\t\trenderEmbeddedFields?.({\n\t\t\t\t\tembeddedCollection,\n\t\t\t\t\tembeddedCollectionConfig,\n\t\t\t\t\tfullFieldName: context.fullFieldName,\n\t\t\t\t\tindex,\n\t\t\t\t})\n\t\t\t}\n\t\t/>\n\t);\n}\n\n// ============================================================================\n// FieldRenderer Component\n// ============================================================================\n\n/**\n * Render a single field with conditional logic\n *\n * Rendering priority:\n * 1. Embedded fields (need special handling for recursive AutoFormFields)\n * 2. FieldDefinition.field.component (registry-first approach)\n * 3. Error message if no component registered\n */\nexport function FieldRenderer({\n\tfieldName,\n\tfieldDef,\n\tcollection,\n\tmode = \"collection\",\n\tregistry,\n\tfieldPrefix,\n\tallCollectionsConfig,\n\trenderEmbeddedFields,\n\tclassName,\n\tentityMeta: entityMetaProp,\n}: FieldRendererProps) {\n\tconst form = useFormContext() as any;\n\t// Use scoped locale (from LocaleScopeProvider in ResourceSheet) or global locale\n\tconst { locale } = useScopedLocale();\n\tconst resolveText = useResolveText();\n\tconst { data: adminConfig } = useAdminConfig();\n\n\t// Use useWatch hook (React pattern) instead of form.getValues() method\n\t// This ensures reactive updates when form values change\n\t// Watch all form values - the fieldPrefix scoping is handled by getFieldContext\n\tconst watchedValues = useWatch({ control: form.control });\n\tconst fullFieldName = getFullFieldName(fieldName, fieldPrefix);\n\tconst watchedFieldValue = useWatch({\n\t\tcontrol: form.control,\n\t\tname: fullFieldName,\n\t} as any);\n\n\t// Extract the scoped values if fieldPrefix is provided\n\tconst formValues = React.useMemo(() => {\n\t\tif (!watchedValues) return {};\n\t\tif (!fieldPrefix) return watchedValues as Record<string, any>;\n\t\t// Navigate to the nested path\n\t\tconst parts = fieldPrefix.split(\".\");\n\t\tlet result: any = watchedValues;\n\t\tfor (const part of parts) {\n\t\t\tresult = result?.[part];\n\t\t\tif (result === undefined) return {};\n\t\t}\n\t\treturn (result ?? {}) as Record<string, any>;\n\t}, [watchedValues, fieldPrefix]);\n\n\t// Fetch entity metadata for inferring localized fields\n\t// Use prop if provided, otherwise fetch from backend based on mode\n\tconst { data: fetchedCollectionMeta } = useCollectionMeta(collection, {\n\t\tenabled: !entityMetaProp && mode === \"collection\",\n\t});\n\tconst { data: fetchedGlobalMeta } = useGlobalMeta(collection, {\n\t\tenabled: !entityMetaProp && mode === \"global\",\n\t});\n\n\tconst entityMeta =\n\t\tentityMetaProp ??\n\t\t(mode === \"global\" ? fetchedGlobalMeta : fetchedCollectionMeta);\n\n\tconst context = getFieldContext({\n\t\tfieldName,\n\t\tfieldDef,\n\t\tcollection,\n\t\tform,\n\t\tfieldPrefix,\n\t\tlocale,\n\t\tentityMeta,\n\t\tformValues, // Pass pre-watched values to avoid calling form.watch() internally\n\t});\n\n\t// Get field options for hooks\n\tconst fieldOptions = getFieldOptions(fieldDef);\n\n\t// Check if compute is client-side (function) vs server-side (object with handler)\n\t// Server-side compute is handled by useReactiveFields in form-view.tsx\n\tconst clientSideCompute =\n\t\ttypeof fieldOptions.compute === \"function\"\n\t\t\t? fieldOptions.compute\n\t\t\t: undefined;\n\n\t// Use field hooks for compute, onChange, loadOptions\n\tconst {\n\t\thandleChange,\n\t\tcomputedValue,\n\t\tisComputed,\n\t\toptions: hookOptions,\n\t\toptionsLoading,\n\t} = useFieldHooks({\n\t\tfieldName,\n\t\tfullFieldName: context.fullFieldName,\n\t\tlocale,\n\t\tcompute: clientSideCompute,\n\t\tonChange: fieldOptions.onChange,\n\t\tdefaultValue: fieldOptions.defaultValue,\n\t\tloadOptions: fieldOptions.loadOptions,\n\t\tstaticOptions: context.options,\n\t});\n\n\t// Hidden fields are not rendered\n\tif (context.isHidden) return null;\n\n\t// Field not found in config\n\tif (!fieldDef) {\n\t\tconst entityType = mode === \"global\" ? \"global\" : \"collection\";\n\t\treturn renderConfigError(\n\t\t\t`Field \"${fieldName}\" not found in ${entityType} \"${collection}\" config.`,\n\t\t);\n\t}\n\n\t// Use hook options if available, otherwise use context options\n\tconst resolvedOptions = hookOptions ?? context.options;\n\n\t// Build props and resolve I18nText labels to strings\n\tconst rawComponentProps = buildComponentProps(context);\n\n\t// For computed fields, use computed value instead of form value\n\tconst fieldValue = isComputed\n\t\t? computedValue\n\t\t: watchedFieldValue === undefined\n\t\t\t? rawComponentProps.value\n\t\t\t: watchedFieldValue;\n\n\tconst componentProps = {\n\t\t...rawComponentProps,\n\t\t// Use computed value if field is computed\n\t\tvalue: fieldValue,\n\t\t// Use handleChange from hooks instead of context.updateValue\n\t\tonChange: handleChange,\n\t\t// Use resolved options\n\t\toptions: resolvedOptions,\n\t\t// Pass loading state for async options\n\t\toptionsLoading,\n\t\t// Computed fields are always readonly\n\t\treadOnly: rawComponentProps.readOnly || isComputed,\n\t\tlabel: resolveText(rawComponentProps.label, \"\", formValues),\n\t\tdescription: resolveText(rawComponentProps.description, \"\", formValues),\n\t\tplaceholder: resolveText(rawComponentProps.placeholder, \"\", formValues),\n\t};\n\n\t// Render content based on priority\n\tlet content: React.ReactNode = null;\n\n\t// 1. Embedded fields need special handling for recursive rendering\n\tif (context.type === \"embedded\") {\n\t\tcontent = renderEmbeddedField({\n\t\t\tcontext,\n\t\t\tregistry,\n\t\t\tallCollectionsConfig,\n\t\t\tcomponentProps,\n\t\t\trenderEmbeddedFields,\n\t\t});\n\t}\n\n\t// 2. Use FieldDefinition.field.component (registry-first approach)\n\tif (!content && context.component) {\n\t\tcontent = renderDefinitionComponent({\n\t\t\tcontext,\n\t\t\tcomponentProps,\n\t\t\tblocks: adminConfig?.blocks,\n\t\t});\n\t}\n\n\t// 3. No component found - show error (all fields should have registered components)\n\tif (!content) {\n\t\tcontent = renderConfigError(\n\t\t\t`No component registered for field type \"${context.type}\" (field: \"${context.fieldName}\").`,\n\t\t);\n\t}\n\n\t// Wrap with className if provided\n\tif (className) {\n\t\treturn <div className={className}>{content}</div>;\n\t}\n\n\treturn <>{content}</>;\n}\n"],"mappings":"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"}

package/dist/client/views/collection/form-view.d.mts

@@ -0,0 +1,112 @@
+import { ComponentRegistry, FormViewConfig } from "../../builder/types/field-types.mjs";
+import { CollectionBuilderState } from "../../builder/types/collection-types.mjs";
+import * as React$1 from "react";
+
+//#region src/client/views/collection/form-view.d.ts
+
+/**
+ * Form view configuration from registry.
+ *
+ * Re-exports FormViewConfig for type consistency between builder and component.
+ */
+type FormViewRegistryConfig = FormViewConfig;
+/**
+ * Props for FormView component
+ */
+interface FormViewProps {
+  /**
+   * Collection name
+   */
+  collection: string;
+  /**
+   * Item ID (undefined for create, string for edit)
+   */
+  id?: string;
+  /**
+   * Collection configuration from admin builder
+   * Accepts CollectionBuilderState or any compatible config object
+   */
+  config?: Partial<CollectionBuilderState> | Record<string, any>;
+  /**
+   * View-specific configuration from registry
+   */
+  viewConfig?: FormViewRegistryConfig;
+  /**
+   * Navigate function for routing
+   */
+  navigate: (path: string) => void;
+  /**
+   * Base path for admin routes (e.g., "/admin")
+   */
+  basePath?: string;
+  /**
+   * Default values for create mode (from URL prefill params)
+   */
+  defaultValues?: Record<string, any>;
+  /**
+   * Component registry for custom field types
+   */
+  registry?: ComponentRegistry;
+  /**
+   * All collections config (for embedded collections)
+   */
+  allCollectionsConfig?: Record<string, Partial<CollectionBuilderState> | Record<string, any>>;
+  /**
+   * Show metadata (ID, created/updated dates)
+   * @default true
+   */
+  showMeta?: boolean;
+  /**
+   * Custom header actions (in addition to default Save button)
+   */
+  headerActions?: React$1.ReactNode;
+  /**
+   * Callback on successful save
+   */
+  onSuccess?: (data: any) => void;
+  /**
+   * Callback on error
+   */
+  onError?: (error: Error) => void;
+}
+/**
+ * FormView - Default form-based edit/create view for collections
+ *
+ * Features:
+ * - Auto-generates form fields from collection config
+ * - Supports tabs, sections, and sidebar layout
+ * - Auto-detects M:N relations
+ * - Keyboard shortcut (Cmd+S) to save
+ * - Field-level validation errors from API
+ *
+ * @example
+ * ```tsx
+ * // Used automatically via registry when navigating to /admin/collections/:name/:id
+ * // Can also be used directly:
+ * <FormView
+ *   collection="posts"
+ *   id="123"
+ *   config={postsConfig}
+ *   navigate={navigate}
+ *   basePath="/admin"
+ * />
+ * ```
+ */
+declare function FormView({
+  collection,
+  id,
+  config,
+  viewConfig,
+  navigate,
+  basePath,
+  defaultValues: defaultValuesProp,
+  registry,
+  allCollectionsConfig,
+  showMeta,
+  headerActions,
+  onSuccess,
+  onError
+}: FormViewProps): React$1.ReactElement;
+//#endregion
+export { FormView, FormViewProps, FormViewRegistryConfig };
+//# sourceMappingURL=form-view.d.mts.map

package/dist/client/views/collection/form-view.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-view.d.mts","names":[],"sources":["../../../../src/client/views/collection/form-view.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAmNE,KApDU,sBAAA,GAAyB,cAoDnC;;;;AAsBiB,UArEF,aAAA,CAqEE;EAAK;AACvB;;EA+BA,UAAA,EAAA,MAAA;EACA;;;EAGA,EAAA,CAAA,EAAA,MAAA;EACe;;;;EAIf,MAAA,CAAA,EA/FS,OA+FT,CA/FiB,sBA+FjB,CAAA,GA/F2C,MA+F3C,CAAA,MAAA,EAAA,GAAA,CAAA;EACA;;;EAEkB,UAAM,CAAA,EA7FX,sBA6FW;EAAY;;;;;;;;;;;kBA9EpB;;;;aAKL;;;;yBAKY,eAEtB,QAAQ,0BAA0B;;;;;;;;;kBAYnB,OAAA,CAAM;;;;;;;;oBAUJ;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BK,QAAA;;;;;;;iBAOR;;;;;;;GAOb,gBAAgB,OAAA,CAAM"}