@questpie/admin 1.1.1 → 2.0.0

package/dist/client/builder/field/field.d.mts

@@ -0,0 +1,229 @@
+import { BaseFieldConfigProps, BaseFieldProps, MaybeLazyComponent } from "../types/common.mjs";
+import { FieldHookContext, SelectOption } from "../types/field-types.mjs";
+import { SetProperty } from "questpie/shared";
+import React from "react";
+import { z } from "zod";
+
+//#region src/client/builder/field/field.d.ts
+
+/**
+ * Context provided to createZod callbacks for building nested schemas
+ */
+interface ZodBuildContext {
+  /**
+   * Recursively builds a Zod schema for any field definition.
+   * Use this for nested fields in object/array types.
+   */
+  buildSchema: (fieldDef: FieldDefinition) => z.ZodTypeAny;
+  /**
+   * Field registry for resolving nested fields callbacks.
+   * Used to create the `r` proxy in `fields: ({ r }) => ({...})`
+   */
+  registry: Record<string, FieldBuilder<any>>;
+}
+/**
+ * Function type for creating Zod schema from field options
+ */
+type CreateZodFn<TOptions = any> = (opts: TOptions, ctx: ZodBuildContext) => z.ZodTypeAny;
+/**
+ * Field state options (readOnly, disabled, hidden)
+ */
+interface FieldStateOptions {
+  /**
+   * Whether field is read-only (can be dynamic based on form values).
+   * Read-only fields look normal but cannot be edited.
+   * Note: Fields with `compute` are automatically read-only.
+   */
+  readOnly?: boolean | ((values: Record<string, any>) => boolean);
+  /**
+   * Whether field is disabled (can be dynamic based on form values).
+   * Disabled fields appear grayed out and cannot be edited.
+   */
+  disabled?: boolean | ((values: Record<string, any>) => boolean);
+  /**
+   * Whether field is hidden (can be dynamic based on form values).
+   * Hidden fields are not rendered. Default is false (visible).
+   *
+   * Note: undefined/false = visible, true = hidden
+   * This follows JavaScript falsy semantics for better DX.
+   */
+  hidden?: boolean | ((values: Record<string, any>) => boolean);
+}
+/**
+ * Hook options for field interactivity
+ */
+interface FieldHookOptions {
+  /**
+   * Compute field value from other fields (proxy-tracked dependencies).
+   * Makes the field read-only and virtual (not submitted to backend).
+   *
+   * Dependencies are automatically detected via Proxy tracking.
+   * Works in both forms (reactive) and tables (static).
+   *
+   * @example
+   * ```ts
+   * pricePerMinute: r.number({
+   *   compute: (values) => values.price / values.duration,
+   * })
+   * ```
+   */
+  compute?: (values: Record<string, any>) => any;
+  /**
+   * Called when field value changes.
+   * Use for side effects like updating other fields.
+   * Can be async for API calls.
+   *
+   * @example
+   * ```ts
+   * name: r.text({
+   *   onChange: (value, { setValue }) => {
+   *     setValue('slug', slugify(value));
+   *   },
+   * })
+   * ```
+   */
+  onChange?: (value: any, ctx: FieldHookContext) => void | Promise<void>;
+  /**
+   * Dynamic default value for new records.
+   * Can be a static value, sync function, or async function.
+   * Only evaluated when creating new records (not on edit).
+   *
+   * @example
+   * ```ts
+   * status: r.select({
+   *   defaultValue: 'draft',
+   *   // or dynamic:
+   *   defaultValue: async () => fetchDefaultStatus(),
+   * })
+   * ```
+   */
+  defaultValue?: any | ((values: Record<string, any>) => any) | ((values: Record<string, any>) => Promise<any>);
+  /**
+   * Async options loader for select-type fields.
+   * Dependencies are automatically detected via Proxy tracking.
+   *
+   * @example
+   * ```ts
+   * subcategory: r.select({
+   *   loadOptions: async (values) => {
+   *     // Automatically re-fetches when values.category changes
+   *     return fetchSubcategories(values.category);
+   *   },
+   * })
+   * ```
+   */
+  loadOptions?: (values: Record<string, any>) => Promise<SelectOption[]>;
+}
+/**
+ * UI options that can be set when defining a field in a collection.
+ * These are the "soft" options from BaseFieldProps that make sense in config.
+ */
+type FieldUIOptions = Partial<Pick<BaseFieldConfigProps, "label" | "description" | "placeholder" | "required"> & Pick<BaseFieldProps, "localized">> & FieldStateOptions & FieldHookOptions;
+/**
+ * Field definition - stored in admin registry
+ */
+interface FieldDefinition<TName extends string = string, TOptions = any> {
+  readonly name: TName;
+  readonly "~options": TOptions;
+  field: {
+    component: MaybeLazyComponent;
+  };
+  cell?: {
+    component: MaybeLazyComponent;
+  };
+  /**
+   * Creates a Zod schema from field options.
+   * If not provided, a generic schema based on field type will be used.
+   */
+  createZod?: CreateZodFn<TOptions>;
+}
+/**
+ * Field builder state
+ */
+interface FieldBuilderState {
+  readonly name: string;
+  readonly "~options": any;
+  readonly component: MaybeLazyComponent;
+  readonly cellComponent?: MaybeLazyComponent;
+  readonly createZod?: CreateZodFn;
+}
+/**
+ * Field builder class
+ *
+ * Also implements FieldDefinition interface so it can be used directly in registries.
+ */
+declare class FieldBuilder<TState extends FieldBuilderState> implements FieldDefinition<TState["name"], TState["~options"]> {
+  readonly state: TState;
+  constructor(state: TState);
+  get name(): TState["name"];
+  get "~options"(): TState["~options"];
+  get field(): {
+    component: MaybeLazyComponent;
+  };
+  get cell(): {
+    component: MaybeLazyComponent;
+  } | undefined;
+  get createZod(): CreateZodFn<TState["~options"]> | undefined;
+  /**
+   * Override options - returns new builder with updated state
+   */
+  $options<TNewOptions>(options: TNewOptions): FieldBuilder<SetProperty<TState, "~options", TNewOptions>>;
+  /**
+   * Set cell component for table views
+   */
+  withCell<TNewCellComponent extends MaybeLazyComponent>(component: TNewCellComponent): FieldBuilder<SetProperty<TState, "cellComponent", TNewCellComponent>>;
+}
+/**
+ * Inferred options type for a field
+ */
+type InferFieldOptions<TConfig extends Record<string, any>, TComponent extends MaybeLazyComponent> = [TConfig] extends [Record<string, never>] ? ExtractComponentOptions<TComponent> : TConfig & FieldUIOptions;
+/**
+ * Create a field definition
+ *
+ * @param name - Field type name (e.g. "text", "relation")
+ * @param config - Component and optional config type
+ *
+ * @example
+ * ```ts
+ * // With explicit config type and createZod
+ * const relationField = field("relation", {
+ *   component: RelationField,
+ *   config: {} as RelationFieldConfig,
+ *   createZod: (opts, ctx) => z.string(),
+ * });
+ *
+ * // Without config (infers from component props)
+ * const textField = field("text", {
+ *   component: TextField,
+ *   createZod: (opts) => {
+ *     let schema = z.string();
+ *     if (opts.maxLength) schema = schema.max(opts.maxLength);
+ *     return opts.required ? schema : schema.optional().nullable();
+ *   },
+ * });
+ * ```
+ */
+declare function field<TName extends string, TConfig extends Record<string, any> = Record<string, never>, TComponent extends MaybeLazyComponent = MaybeLazyComponent, TCellComponent extends MaybeLazyComponent | undefined = undefined>(name: TName, options: {
+  component: TComponent;
+  cell?: TCellComponent;
+  config?: TConfig;
+  /**
+   * Creates a Zod schema from field options.
+   * Called during form validation schema generation.
+   */
+  createZod?: CreateZodFn<InferFieldOptions<TConfig, TComponent>>;
+}): FieldBuilder<{
+  name: TName;
+  "~options": InferFieldOptions<TConfig, TComponent>;
+  component: TComponent;
+  cellComponent: TCellComponent;
+  createZod: typeof options.createZod;
+}>;
+/**
+ * Extract field-specific options from component props.
+ * Omits BaseFieldProps to get only field-specific config.
+ */
+type ExtractComponentOptions<TComponent> = TComponent extends React.ComponentType<infer TProps> ? Omit<TProps, keyof BaseFieldProps> & FieldUIOptions : Record<string, never>;
+//#endregion
+export { CreateZodFn, FieldBuilder, FieldBuilderState, FieldDefinition, FieldHookOptions, FieldStateOptions, FieldUIOptions, ZodBuildContext, field };
+//# sourceMappingURL=field.d.mts.map

package/dist/client/builder/field/field.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.mts","names":[],"sources":["../../../../src/client/builder/field/field.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAwCY,UAjBK,eAAA,CAiBM;EACf;;;;EAOS,WAAA,EAAA,CAAA,QAAiB,EApBR,eAoBQ,EAAA,GApBY,CAAA,CAAE,UAoBd;EAMD;;;;EAqBhB,QAAA,EAzCL,MAyCK,CAAA,MAAgB,EAzCN,YAyCM,CAAA,GAAA,CAAA,CAAA;;;;;AAkDjB,KArFJ,WAqFI,CAAA,WAAA,GAAA,CAAA,GAAA,CAAA,IAAA,EApFR,QAoFQ,EAAA,GAAA,EAnFT,eAmFS,EAAA,GAlFX,CAAA,CAAE,UAkFS;;;;AAgBiC,UA7FhC,iBAAA,CA6FgC;EAAO;AAOxD;;;;EAKI,QAAA,CAAA,EAAA,OAAA,GAAA,CAAA,CAAA,MAAA,EAnG6B,MAmG7B,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,GAAA,OAAA,CAAA;EALyB;;;;EAaZ,QAAA,CAAA,EAAA,OAAe,GAAA,CAAA,CAAA,MAAA,EArGC,MAqGD,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,GAAA,OAAA,CAAA;EAIf;;;;;;;EAcA,MAAA,CAAA,EAAA,OAAA,GAAA,CAAiB,CAAA,MAAA,EA9GH,MA8GG,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,GAAA,OAAA,CAAA;;;;;AAarB,UArHI,gBAAA,CAqHQ;EACR;;;;;;;;;;;;;;EAgCC,OAAA,CAAA,EAAA,CAAA,MAAA,EAvIG,MAuIH,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,GAAA,GAAA;EAAb;;;;;;;;;AAkBJ;;;;;EAS2B,QAAA,CAAA,EAAA,CAAA,KAAA,EAAA,GAAA,EAAA,GAAA,EAlJG,gBAkJH,EAAA,GAAA,IAAA,GAlJ+B,OAkJ/B,CAAA,IAAA,CAAA;EAAxB;;;;AA6BJ;;;;;;;;;;EAe8C,YAAA,CAAA,EAAA,GAAA,GAAA,CAAA,CAAA,MAAA,EA5K9B,MA4K8B,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,GAAA,GAAA,CAAA,GAAA,CAAA,CAAA,MAAA,EA3K9B,MA2K8B,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,GA3KN,OA2KM,CAAA,GAAA,CAAA,CAAA;EAAS;;;;;;;;;;;;AAgBtD;;EAOoB,WAAM,CAAA,EAAA,CAAA,MAAA,EAlLF,MAkLE,CAAA,MAAA,EAAA,GAAA,CAAA,EAAA,GAlLsB,OAkLtB,CAlL8B,YAkL9B,EAAA,CAAA;;;;;;AAEf,KA7KA,cAAA,GAAiB,OA6KjB,CA5KV,IA4KU,CA3KR,oBA2KQ,EAAA,OAAA,GAAA,aAAA,GAAA,aAAA,GAAA,UAAA,CAAA,GAxKR,IAwKQ,CAxKH,cAwKG,EAAA,WAAA,CAAA,CAAA,GAtKV,iBAsKU,GArKV,gBAqKU;;;;UAhKK;iBAIA;uBACM;;eACD;;;eACA;;;;;;cAKR,YAAY;;;;;UAMT,iBAAA;;;sBAGK;2BACK;uBACJ;;;;;;;cAQV,4BACI,8BACJ,gBAAgB,gBAAgB;kBACR;qBAAA;cAGvB;oBAIM;;;;;;;mBAcD,YAAY;;;;iCAQlB,cACR,aAAa,YAAY,oBAAoB;;;;qCAUb,+BACtB,oBACV,aAAa,YAAY,yBAAyB;;;;;KAWlD,kCACa,wCACG,uBAChB,kBAAkB,yBACnB,wBAAwB,cACxB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BE,4CAEE,sBAAsB,0CACnB,qBAAqB,2CACjB,kDAEjB;aAEO;SACJ;WACE;;;;;cAKG,YAAY,kBAAkB,SAAS;IAEpD;QACK;cACM,kBAAkB,SAAS;aAC5B;iBACI;oBACG,OAAA,CAAQ;;;;;;KAevB,sCACH,mBAAmB,KAAA,CAAM,8BACrB,KAAK,cAAc,kBAAkB,iBACrC"}

package/dist/client/builder/field/field.mjs

@@ -0,0 +1,83 @@
+//#region src/client/builder/field/field.ts
+/**
+* Field builder class
+*
+* Also implements FieldDefinition interface so it can be used directly in registries.
+*/
+var FieldBuilder = class FieldBuilder {
+	constructor(state) {
+		this.state = state;
+	}
+	get name() {
+		return this.state.name;
+	}
+	get "~options"() {
+		return this.state["~options"];
+	}
+	get field() {
+		return { component: this.state.component };
+	}
+	get cell() {
+		return this.state.cellComponent ? { component: this.state.cellComponent } : void 0;
+	}
+	get createZod() {
+		return this.state.createZod;
+	}
+	/**
+	* Override options - returns new builder with updated state
+	*/
+	$options(options) {
+		return new FieldBuilder({
+			...this.state,
+			"~options": options
+		});
+	}
+	/**
+	* Set cell component for table views
+	*/
+	withCell(component) {
+		return new FieldBuilder({
+			...this.state,
+			cellComponent: component
+		});
+	}
+};
+/**
+* Create a field definition
+*
+* @param name - Field type name (e.g. "text", "relation")
+* @param config - Component and optional config type
+*
+* @example
+* ```ts
+* // With explicit config type and createZod
+* const relationField = field("relation", {
+*   component: RelationField,
+*   config: {} as RelationFieldConfig,
+*   createZod: (opts, ctx) => z.string(),
+* });
+*
+* // Without config (infers from component props)
+* const textField = field("text", {
+*   component: TextField,
+*   createZod: (opts) => {
+*     let schema = z.string();
+*     if (opts.maxLength) schema = schema.max(opts.maxLength);
+*     return opts.required ? schema : schema.optional().nullable();
+*   },
+* });
+* ```
+*/
+function field(name, options) {
+	return new FieldBuilder({
+		name,
+		"~options": {},
+		component: options.component,
+		cellComponent: options.cell,
+		createZod: options.createZod
+	});
+}
+
+//#endregion
+export { FieldBuilder, field };
+//# sourceMappingURL=field.mjs.map

package/dist/client/builder/field/field.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.mjs","names":["state: TState"],"sources":["../../../../src/client/builder/field/field.ts"],"sourcesContent":["/**\n * Field Builder\n *\n * Defines reusable field types with form and cell components.\n */\n\nimport type { SetProperty } from \"questpie/shared\";\nimport type React from \"react\";\nimport type { z } from \"zod\";\nimport type {\n  BaseFieldConfigProps,\n  BaseFieldProps,\n  MaybeLazyComponent,\n} from \"../types/common\";\nimport type { FieldHookContext, SelectOption } from \"../types/field-types\";\n\n// ============================================================================\n// Zod Schema Building Context\n// ============================================================================\n\n/**\n * Context provided to createZod callbacks for building nested schemas\n */\nexport interface ZodBuildContext {\n  /**\n   * Recursively builds a Zod schema for any field definition.\n   * Use this for nested fields in object/array types.\n   */\n  buildSchema: (fieldDef: FieldDefinition) => z.ZodTypeAny;\n\n  /**\n   * Field registry for resolving nested fields callbacks.\n   * Used to create the `r` proxy in `fields: ({ r }) => ({...})`\n   */\n  registry: Record<string, FieldBuilder<any>>;\n}\n\n/**\n * Function type for creating Zod schema from field options\n */\nexport type CreateZodFn<TOptions = any> = (\n  opts: TOptions,\n  ctx: ZodBuildContext,\n) => z.ZodTypeAny;\n\n/**\n * Field state options (readOnly, disabled, hidden)\n */\nexport interface FieldStateOptions {\n  /**\n   * Whether field is read-only (can be dynamic based on form values).\n   * Read-only fields look normal but cannot be edited.\n   * Note: Fields with `compute` are automatically read-only.\n   */\n  readOnly?: boolean | ((values: Record<string, any>) => boolean);\n\n  /**\n   * Whether field is disabled (can be dynamic based on form values).\n   * Disabled fields appear grayed out and cannot be edited.\n   */\n  disabled?: boolean | ((values: Record<string, any>) => boolean);\n\n  /**\n   * Whether field is hidden (can be dynamic based on form values).\n   * Hidden fields are not rendered. Default is false (visible).\n   *\n   * Note: undefined/false = visible, true = hidden\n   * This follows JavaScript falsy semantics for better DX.\n   */\n  hidden?: boolean | ((values: Record<string, any>) => boolean);\n}\n\n/**\n * Hook options for field interactivity\n */\nexport interface FieldHookOptions {\n  /**\n   * Compute field value from other fields (proxy-tracked dependencies).\n   * Makes the field read-only and virtual (not submitted to backend).\n   *\n   * Dependencies are automatically detected via Proxy tracking.\n   * Works in both forms (reactive) and tables (static).\n   *\n   * @example\n   * ```ts\n   * pricePerMinute: r.number({\n   *   compute: (values) => values.price / values.duration,\n   * })\n   * ```\n   */\n  compute?: (values: Record<string, any>) => any;\n\n  /**\n   * Called when field value changes.\n   * Use for side effects like updating other fields.\n   * Can be async for API calls.\n   *\n   * @example\n   * ```ts\n   * name: r.text({\n   *   onChange: (value, { setValue }) => {\n   *     setValue('slug', slugify(value));\n   *   },\n   * })\n   * ```\n   */\n  onChange?: (value: any, ctx: FieldHookContext) => void | Promise<void>;\n\n  /**\n   * Dynamic default value for new records.\n   * Can be a static value, sync function, or async function.\n   * Only evaluated when creating new records (not on edit).\n   *\n   * @example\n   * ```ts\n   * status: r.select({\n   *   defaultValue: 'draft',\n   *   // or dynamic:\n   *   defaultValue: async () => fetchDefaultStatus(),\n   * })\n   * ```\n   */\n  defaultValue?:\n    | any\n    | ((values: Record<string, any>) => any)\n    | ((values: Record<string, any>) => Promise<any>);\n\n  /**\n   * Async options loader for select-type fields.\n   * Dependencies are automatically detected via Proxy tracking.\n   *\n   * @example\n   * ```ts\n   * subcategory: r.select({\n   *   loadOptions: async (values) => {\n   *     // Automatically re-fetches when values.category changes\n   *     return fetchSubcategories(values.category);\n   *   },\n   * })\n   * ```\n   */\n  loadOptions?: (values: Record<string, any>) => Promise<SelectOption[]>;\n}\n\n/**\n * UI options that can be set when defining a field in a collection.\n * These are the \"soft\" options from BaseFieldProps that make sense in config.\n */\nexport type FieldUIOptions = Partial<\n  Pick<\n    BaseFieldConfigProps,\n    \"label\" | \"description\" | \"placeholder\" | \"required\"\n  > &\n    Pick<BaseFieldProps, \"localized\">\n> &\n  FieldStateOptions &\n  FieldHookOptions;\n\n/**\n * Field definition - stored in admin registry\n */\nexport interface FieldDefinition<\n  TName extends string = string,\n  TOptions = any,\n> {\n  readonly name: TName;\n  readonly \"~options\": TOptions;\n  field: { component: MaybeLazyComponent };\n  cell?: { component: MaybeLazyComponent };\n  /**\n   * Creates a Zod schema from field options.\n   * If not provided, a generic schema based on field type will be used.\n   */\n  createZod?: CreateZodFn<TOptions>;\n}\n\n/**\n * Field builder state\n */\nexport interface FieldBuilderState {\n  readonly name: string;\n  readonly \"~options\": any;\n  readonly component: MaybeLazyComponent;\n  readonly cellComponent?: MaybeLazyComponent;\n  readonly createZod?: CreateZodFn;\n}\n\n/**\n * Field builder class\n *\n * Also implements FieldDefinition interface so it can be used directly in registries.\n */\nexport class FieldBuilder<\n  TState extends FieldBuilderState,\n> implements FieldDefinition<TState[\"name\"], TState[\"~options\"]> {\n  constructor(public readonly state: TState) {}\n\n  // Implement FieldDefinition interface via getters\n  get name(): TState[\"name\"] {\n    return this.state.name;\n  }\n\n  get \"~options\"(): TState[\"~options\"] {\n    return this.state[\"~options\"];\n  }\n\n  get field() {\n    return { component: this.state.component };\n  }\n\n  get cell() {\n    return this.state.cellComponent\n      ? { component: this.state.cellComponent }\n      : undefined;\n  }\n\n  get createZod(): CreateZodFn<TState[\"~options\"]> | undefined {\n    return this.state.createZod;\n  }\n\n  /**\n   * Override options - returns new builder with updated state\n   */\n  $options<TNewOptions>(\n    options: TNewOptions,\n  ): FieldBuilder<SetProperty<TState, \"~options\", TNewOptions>> {\n    return new FieldBuilder({\n      ...this.state,\n      \"~options\": options,\n    } as any);\n  }\n\n  /**\n   * Set cell component for table views\n   */\n  withCell<TNewCellComponent extends MaybeLazyComponent>(\n    component: TNewCellComponent,\n  ): FieldBuilder<SetProperty<TState, \"cellComponent\", TNewCellComponent>> {\n    return new FieldBuilder({\n      ...this.state,\n      cellComponent: component,\n    } as any);\n  }\n}\n\n/**\n * Inferred options type for a field\n */\ntype InferFieldOptions<\n  TConfig extends Record<string, any>,\n  TComponent extends MaybeLazyComponent,\n> = [TConfig] extends [Record<string, never>]\n  ? ExtractComponentOptions<TComponent>\n  : TConfig & FieldUIOptions;\n\n/**\n * Create a field definition\n *\n * @param name - Field type name (e.g. \"text\", \"relation\")\n * @param config - Component and optional config type\n *\n * @example\n * ```ts\n * // With explicit config type and createZod\n * const relationField = field(\"relation\", {\n *   component: RelationField,\n *   config: {} as RelationFieldConfig,\n *   createZod: (opts, ctx) => z.string(),\n * });\n *\n * // Without config (infers from component props)\n * const textField = field(\"text\", {\n *   component: TextField,\n *   createZod: (opts) => {\n *     let schema = z.string();\n *     if (opts.maxLength) schema = schema.max(opts.maxLength);\n *     return opts.required ? schema : schema.optional().nullable();\n *   },\n * });\n * ```\n */\nexport function field<\n  TName extends string,\n  TConfig extends Record<string, any> = Record<string, never>,\n  TComponent extends MaybeLazyComponent = MaybeLazyComponent,\n  TCellComponent extends MaybeLazyComponent | undefined = undefined,\n>(\n  name: TName,\n  options: {\n    component: TComponent;\n    cell?: TCellComponent;\n    config?: TConfig;\n    /**\n     * Creates a Zod schema from field options.\n     * Called during form validation schema generation.\n     */\n    createZod?: CreateZodFn<InferFieldOptions<TConfig, TComponent>>;\n  },\n): FieldBuilder<{\n  name: TName;\n  \"~options\": InferFieldOptions<TConfig, TComponent>;\n  component: TComponent;\n  cellComponent: TCellComponent;\n  createZod: typeof options.createZod;\n}> {\n  return new FieldBuilder({\n    name,\n    \"~options\": {} as any,\n    component: options.component,\n    cellComponent: options.cell,\n    createZod: options.createZod,\n  } as any);\n}\n\n/**\n * Extract field-specific options from component props.\n * Omits BaseFieldProps to get only field-specific config.\n */\ntype ExtractComponentOptions<TComponent> =\n  TComponent extends React.ComponentType<infer TProps>\n    ? Omit<TProps, keyof BaseFieldProps> & FieldUIOptions\n    : Record<string, never>;\n"],"mappings":";;;;;;AAgMA,IAAa,eAAb,MAAa,aAEoD;CAC/D,YAAY,AAAgBA,OAAe;EAAf;;CAG5B,IAAI,OAAuB;AACzB,SAAO,KAAK,MAAM;;CAGpB,IAAI,aAAiC;AACnC,SAAO,KAAK,MAAM;;CAGpB,IAAI,QAAQ;AACV,SAAO,EAAE,WAAW,KAAK,MAAM,WAAW;;CAG5C,IAAI,OAAO;AACT,SAAO,KAAK,MAAM,gBACd,EAAE,WAAW,KAAK,MAAM,eAAe,GACvC;;CAGN,IAAI,YAAyD;AAC3D,SAAO,KAAK,MAAM;;;;;CAMpB,SACE,SAC4D;AAC5D,SAAO,IAAI,aAAa;GACtB,GAAG,KAAK;GACR,YAAY;GACb,CAAQ;;;;;CAMX,SACE,WACuE;AACvE,SAAO,IAAI,aAAa;GACtB,GAAG,KAAK;GACR,eAAe;GAChB,CAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCb,SAAgB,MAMd,MACA,SAgBC;AACD,QAAO,IAAI,aAAa;EACtB;EACA,YAAY,EAAE;EACd,WAAW,QAAQ;EACnB,eAAe,QAAQ;EACvB,WAAW,QAAQ;EACpB,CAAQ"}

package/dist/client/builder/index.d.mts

@@ -0,0 +1,36 @@
+import { I18nContext, I18nText } from "../i18n/types.mjs";
+import { BaseFieldProps, IconComponent, MaybeLazyComponent } from "./types/common.mjs";
+import { ActionContext, ActionDefinition, ActionDialogProps, ActionFormConfig, ActionHandler, ActionHelpers, ActionVariant, ActionsConfig, ApiHandler, ConfirmationConfig, CustomHandler, DialogHandler, FormHandler, HeaderActionsConfig, NavigateHandler } from "./types/action-types.mjs";
+import { ArrayFieldConfig, ComponentRegistry, EmbeddedFieldConfig, FieldComponentProps, FieldHookContext, FieldLayoutItem, FieldUIConfig, FieldValidationConfig, FormSidebarConfig, FormViewConfig, LayoutMode, RelationFieldConfig, RichTextConfig, SectionLayout, SelectOption, TabConfig, TabsLayout, WrapperMode } from "./types/field-types.mjs";
+import { CreateZodFn, FieldBuilder, FieldBuilderState, FieldDefinition as FieldDefinition$1, FieldHookOptions, FieldStateOptions, FieldUIOptions, ZodBuildContext, field as field$1 } from "./field/field.mjs";
+import { PageBuilder, PageBuilderState, PageDefinition, page } from "./page/page.mjs";
+import { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, GenericWidgetConfig, ProgressWidgetConfig, QuickActionItem, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetColumn, TableWidgetColumnConfig, TableWidgetConfig, TimelineItem, TimelineWidgetConfig, ValueWidgetClassNames, ValueWidgetConfig, ValueWidgetResult, ValueWidgetTrend, WidgetAction, WidgetCardVariant, WidgetComponentProps, WidgetConfig, WidgetDataSource } from "./types/widget-types.mjs";
+import { DashboardAction, DashboardConfig, DashboardLayoutItem, DashboardSection, DashboardTabConfig, DashboardTabs, LocaleConfig } from "./types/ui-config.mjs";
+import { AutoSaveConfig, CollectionBuilderState, ColumnConfig, ColumnConfigObject, ListViewConfig, PreviewConfig } from "./types/collection-types.mjs";
+import { DefaultViewsConfig } from "./types/views.mjs";
+import { EditViewBuilder, EditViewBuilderState, EditViewDefinition, ListViewBuilder, ListViewBuilderState, ListViewDefinition, editView, listView } from "./view/view.mjs";
+import { WidgetBuilder, WidgetBuilderState, WidgetDefinition, widget } from "./widget/widget.mjs";
+import { AdminBuilderState } from "./admin-types.mjs";
+import { AdminBuilder } from "./admin-builder.mjs";
+import { AdminTypeRegistry, IsRegistered, RegisteredAdmin, RegisteredCMS, RegisteredCollectionNames, RegisteredGlobalNames } from "./registry.mjs";
+import { Admin, AdminInput, AppAdmin, InferAdminCMS } from "./admin.mjs";
+import "./types/action-registry.mjs";
+import { GlobalBuilderState } from "./types/global-types.mjs";
+import { qa } from "./qa.mjs";
+import "./validation.mjs";
+import { QuestpieClient } from "questpie/client";
+import { CollectionInfer, Questpie } from "questpie";
+
+//#region src/client/builder/index.d.ts
+
+/**
+ * Extract collection names from backend Questpie app
+ */
+type CollectionNames<TApp extends Questpie<any>> = keyof TApp["config"]["collections"] & string;
+/**
+ * Extract global names from backend Questpie app
+ */
+type GlobalNames<TApp extends Questpie<any>> = TApp extends Questpie<infer TConfig> ? keyof TConfig["globals"] & string : never;
+//#endregion
+export { CollectionNames, GlobalNames };
+//# sourceMappingURL=index.d.mts.map

package/dist/client/builder/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/client/builder/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqNY,6BAA6B,uBAClC;;;;KAIK,yBAAyB,iBACpC,aAAa,gCACJ"}

package/dist/client/builder/page/page.d.mts

@@ -0,0 +1,36 @@
+import { MaybeLazyComponent } from "../types/common.mjs";
+import { SetProperty } from "questpie/shared";
+
+//#region src/client/builder/page/page.d.ts
+
+interface PageDefinition<TName extends string = string> {
+  readonly name: TName;
+  readonly component: any;
+  readonly path?: string;
+}
+interface PageBuilderState {
+  readonly name: string;
+  readonly component: any;
+  readonly path?: string;
+  readonly showInNav?: boolean;
+}
+declare class PageBuilder<TState extends PageBuilderState> {
+  readonly state: TState;
+  constructor(state: TState);
+  path(path: string): PageBuilder<SetProperty<TState, "path", string>>;
+}
+/**
+ * Create a custom page
+ */
+declare function page<TName extends string, TComponent extends MaybeLazyComponent>(name: TName, config: {
+  component: TComponent;
+  showInNav?: boolean;
+}): PageBuilder<{
+  name: TName;
+  component: TComponent;
+  path: undefined;
+  showInNav: boolean | undefined;
+}>;
+//#endregion
+export { PageBuilder, PageBuilderState, PageDefinition, page };
+//# sourceMappingURL=page.d.mts.map

package/dist/client/builder/page/page.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.mts","names":[],"sources":["../../../../src/client/builder/page/page.ts"],"sourcesContent":[],"mappings":";;;;;AAsBwC,UAbvB,cAauB,CAAA,cAAA,MAAA,GAAA,MAAA,CAAA,CAAA;EACH,SAAA,IAAA,EAbpB,KAaoB;EAAA,SAAA,SAAA,EAAA,GAAA;EAES,SAAA,IAAA,CAAA,EAAA,MAAA;;AAAxB,UAVL,gBAAA,CAUK;EAAW,SAAA,IAAA,EAAA,MAAA;EAWjB,SAAI,SAAA,EAAA,GAAA;EAEC,SAAA,IAAA,CAAA,EAAA,MAAA;EAEb,SAAA,SAAA,CAAA,EAAA,OAAA;;AAGA,cArBK,WAqBL,CAAA,eArBgC,gBAqBhC,CAAA,CAAA;EACK,SAAA,KAAA,EArBwB,MAqBxB;EAFV,WAAA,CAAA,KAAA,EAnBkC,MAmBlC;EAAW,IAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAjBQ,WAiBR,CAjBoB,WAiBpB,CAjBgC,MAiBhC,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;;;;iBANE,8CAEK,0BAEb;aACe;;IACpB;QACK;aACK"}

package/dist/client/builder/page/page.mjs

@@ -0,0 +1,27 @@
+//#region src/client/builder/page/page.ts
+var PageBuilder = class PageBuilder {
+	constructor(state) {
+		this.state = state;
+	}
+	path(path) {
+		return new PageBuilder({
+			...this.state,
+			path
+		});
+	}
+};
+/**
+* Create a custom page
+*/
+function page(name, config) {
+	return new PageBuilder({
+		name,
+		component: config.component,
+		path: void 0,
+		showInNav: config.showInNav
+	});
+}
+
+//#endregion
+export { page };
+//# sourceMappingURL=page.mjs.map

package/dist/client/builder/page/page.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.mjs","names":["state: TState"],"sources":["../../../../src/client/builder/page/page.ts"],"sourcesContent":["/**\n * Page Builder\n *\n * Defines custom admin pages outside of collections/globals.\n */\n\nimport type { SetProperty } from \"questpie/shared\";\nimport type { MaybeLazyComponent } from \"../types/common\";\n\nexport interface PageDefinition<TName extends string = string> {\n  readonly name: TName;\n  readonly component: any;\n  readonly path?: string;\n}\n\nexport interface PageBuilderState {\n  readonly name: string;\n  readonly component: any;\n  readonly path?: string;\n  readonly showInNav?: boolean;\n}\n\nexport class PageBuilder<TState extends PageBuilderState> {\n  constructor(public readonly state: TState) {}\n\n  path(path: string): PageBuilder<SetProperty<TState, \"path\", string>> {\n    return new PageBuilder({\n      ...this.state,\n      path,\n    } as any);\n  }\n}\n\n/**\n * Create a custom page\n */\nexport function page<\n  TName extends string,\n  TComponent extends MaybeLazyComponent,\n>(\n  name: TName,\n  config: { component: TComponent; showInNav?: boolean },\n): PageBuilder<{\n  name: TName;\n  component: TComponent;\n  path: undefined;\n  showInNav: boolean | undefined;\n}> {\n  return new PageBuilder({\n    name,\n    component: config.component,\n    path: undefined,\n    showInNav: config.showInNav,\n  } as any);\n}\n"],"mappings":";AAsBA,IAAa,cAAb,MAAa,YAA6C;CACxD,YAAY,AAAgBA,OAAe;EAAf;;CAE5B,KAAK,MAAgE;AACnE,SAAO,IAAI,YAAY;GACrB,GAAG,KAAK;GACR;GACD,CAAQ;;;;;;AAOb,SAAgB,KAId,MACA,QAMC;AACD,QAAO,IAAI,YAAY;EACrB;EACA,WAAW,OAAO;EAClB,MAAM;EACN,WAAW,OAAO;EACnB,CAAQ"}

package/dist/client/builder/proxies.d.mts

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

package/dist/client/builder/proxies.mjs

@@ -0,0 +1,24 @@
+//#region src/client/builder/proxies.ts
+/**
+* Creates a field registry proxy at runtime
+*/
+function createFieldRegistryProxy(fields) {
+	const proxy = {};
+	for (const key in fields) proxy[key] = (options) => {
+		const fieldDef = fields[key];
+		return {
+			name: fieldDef.name,
+			"~options": {
+				...fieldDef["~options"],
+				...options
+			},
+			field: fieldDef.field,
+			cell: fieldDef.cell
+		};
+	};
+	return proxy;
+}
+
+//#endregion
+export { createFieldRegistryProxy };
+//# sourceMappingURL=proxies.mjs.map

package/dist/client/builder/proxies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxies.mjs","names":[],"sources":["../../../src/client/builder/proxies.ts"],"sourcesContent":["/**\n * Proxy Types for Type-Safe Builder APIs\n *\n * These provide autocomplete and type safety in builder callbacks.\n */\n\nimport type { FieldDefinition } from \"./field/field\";\nimport type { EditViewDefinition, ListViewDefinition } from \"./view/view\";\n\n// ============================================================================\n// Field Proxies\n// ============================================================================\n\n/**\n * Field Proxy - Maps field names to themselves for autocomplete\n *\n * Usage: ({ f }) => ({ columns: [f.name, f.email] })\n */\nexport type FieldProxy<TFields extends Record<string, any>> = {\n\t[K in keyof TFields]: K;\n};\n\n/**\n * Creates a field proxy at runtime\n */\nexport function createFieldProxy<TFields extends Record<string, any>>(\n\tfields?: TFields,\n): FieldProxy<TFields> {\n\tif (!fields || Object.keys(fields).length === 0) {\n\t\treturn new Proxy(\n\t\t\t{},\n\t\t\t{\n\t\t\t\tget: (_target, prop) => {\n\t\t\t\t\tif (typeof prop !== \"string\") return undefined;\n\t\t\t\t\treturn prop;\n\t\t\t\t},\n\t\t\t},\n\t\t) as FieldProxy<TFields>;\n\t}\n\n\tconst proxy = {} as any;\n\tfor (const key in fields) {\n\t\tproxy[key] = key;\n\t}\n\treturn proxy;\n}\n\n/**\n * Helper type to inject field registry into nested callbacks.\n *\n * When a config type has `fields` or `item` callbacks (like ObjectFieldConfig, ArrayFieldConfig),\n * this replaces the `any` or generic `r` parameter with the actual field registry type.\n * This enables type-safe autocomplete in nested field definitions.\n */\ntype InjectFieldRegistry<\n\tTConfig,\n\tTFields extends Record<string, FieldDefinition<any, any>>,\n> = TConfig extends {\n\tfields?: (ctx: { r: any }) => any;\n}\n\t? Omit<TConfig, \"fields\"> & {\n\t\t\tfields?: (ctx: {\n\t\t\t\tr: FieldRegistryProxy<TFields>;\n\t\t\t}) => ReturnType<NonNullable<TConfig[\"fields\"]>>;\n\t\t}\n\t: TConfig extends { item?: (ctx: { r: any }) => any }\n\t\t? Omit<TConfig, \"item\"> & {\n\t\t\t\titem?: (ctx: {\n\t\t\t\t\tr: FieldRegistryProxy<TFields>;\n\t\t\t\t}) => ReturnType<NonNullable<TConfig[\"item\"]>>;\n\t\t\t}\n\t\t: TConfig;\n\n/**\n * Field Registry Proxy - Type-safe field builder methods\n *\n * Usage: ({ r }) => ({ name: r.text({ maxLength: 100 }) })\n *\n * For fields with nested callbacks (object, array), the registry type\n * is automatically injected so nested `r` has full autocomplete.\n *\n * Note: Blocks are now server-only, so `allowedBlocks` is just string[]\n * without client-side type checking. Server validates block names.\n *\n * @typeParam TFields - Field definitions from admin registry\n */\nexport type FieldRegistryProxy<\n\tTFields extends Record<string, FieldDefinition<any, any>>,\n> = {\n\t[K in keyof TFields]: TFields[K] extends FieldDefinition<\n\t\tinfer TName,\n\t\tinfer TFieldOptions\n\t>\n\t\t? (\n\t\t\t\toptions?: InjectFieldRegistry<TFieldOptions, TFields>,\n\t\t\t) => FieldDefinition<TName, InjectFieldRegistry<TFieldOptions, TFields>>\n\t\t: never;\n};\n\n/**\n * Creates a field registry proxy at runtime\n */\nexport function createFieldRegistryProxy<\n\tTFields extends Record<string, FieldDefinition<any, any>>,\n>(fields: TFields): FieldRegistryProxy<TFields> {\n\tconst proxy = {} as any;\n\tfor (const key in fields) {\n\t\tproxy[key] = (options?: any) => {\n\t\t\tconst fieldDef = fields[key];\n\t\t\t// Important: Access getters explicitly to ensure they're evaluated\n\t\t\t// FieldBuilder uses getters for 'name', 'field', 'cell', '~options'\n\t\t\treturn {\n\t\t\t\tname: fieldDef.name,\n\t\t\t\t\"~options\": { ...fieldDef[\"~options\"], ...options },\n\t\t\t\tfield: fieldDef.field,\n\t\t\t\tcell: fieldDef.cell,\n\t\t\t} as FieldDefinition;\n\t\t};\n\t}\n\treturn proxy;\n}\n\n// ============================================================================\n// View Proxies\n// ============================================================================\n\n/**\n * Helper type to make config optional when it's unknown or empty object\n */\ntype ViewConfigArg<TConfig> = unknown extends TConfig\n\t? TConfig | undefined\n\t: TConfig;\n\n/**\n * View Registry Proxy - Type-safe view builder methods\n *\n * Usage: ({ v, f }) => v.table({ columns: [f.name] })\n *\n * The config parameter is typed based on what the view component expects.\n * If the component has `viewConfig?: TableViewConfig`, you get autocomplete\n * for `TableViewConfig` properties.\n *\n * @example\n * ```ts\n * .list(({ v, f }) => v.table({\n *   columns: [f.name, f.email],  // <- typed from TableViewConfig\n *   searchable: true,\n * }))\n * ```\n */\nexport type ViewRegistryProxy<TViews extends Record<string, any>> = {\n\t[K in keyof TViews]: TViews[K] extends ListViewDefinition<\n\t\tany,\n\t\tinfer TListConfig\n\t>\n\t\t? (config?: ViewConfigArg<TListConfig>) => TViews[K]\n\t\t: TViews[K] extends EditViewDefinition<any, infer TEditConfig>\n\t\t\t? (config?: ViewConfigArg<TEditConfig>) => TViews[K]\n\t\t\t: never;\n};\n\n/**\n * Creates a view registry proxy at runtime\n */\nexport function createViewRegistryProxy<TViews extends Record<string, any>>(\n\tviews: TViews,\n): ViewRegistryProxy<TViews> {\n\tconst proxy = {} as any;\n\tfor (const key in views) {\n\t\tproxy[key] = (config?: any) => {\n\t\t\tconst view = views[key];\n\t\t\t// Access state directly to avoid getter issues with class instances\n\t\t\tconst existingConfig = view.state?.[\"~config\"] ?? view[\"~config\"] ?? {};\n\t\t\treturn {\n\t\t\t\tname: view.name,\n\t\t\t\tkind: view.kind,\n\t\t\t\tcomponent: view.component,\n\t\t\t\tstate: view.state,\n\t\t\t\t\"~config\": { ...existingConfig, ...config },\n\t\t\t};\n\t\t};\n\t}\n\treturn proxy;\n}\n"],"mappings":";;;;AAsGA,SAAgB,yBAEd,QAA8C;CAC/C,MAAM,QAAQ,EAAE;AAChB,MAAK,MAAM,OAAO,OACjB,OAAM,QAAQ,YAAkB;EAC/B,MAAM,WAAW,OAAO;AAGxB,SAAO;GACN,MAAM,SAAS;GACf,YAAY;IAAE,GAAG,SAAS;IAAa,GAAG;IAAS;GACnD,OAAO,SAAS;GAChB,MAAM,SAAS;GACf;;AAGH,QAAO"}

package/dist/client/builder/qa.d.mts

@@ -0,0 +1,50 @@
+import { field } from "./field/field.mjs";
+import { page } from "./page/page.mjs";
+import { editView, listView } from "./view/view.mjs";
+import { widget } from "./widget/widget.mjs";
+import { AdminBuilder } from "./admin-builder.mjs";
+
+//#region src/client/builder/qa.d.ts
+
+/**
+ * Create admin builder (starts empty)
+ *
+ * @example
+ * ```ts
+ * // Without backend types
+ * const admin = qa().use(coreAdminModule);
+ *
+ * // With backend types for autocomplete
+ * import type { AppCMS } from './server/cms';
+ * const admin = qa<AppCMS>().use(coreAdminModule);
+ * ```
+ */
+declare function qaFactory<TApp = any>(): AdminBuilder<{
+  "~app": TApp;
+  fields: {};
+  components: {};
+  listViews: {};
+  editViews: {};
+  pages: {};
+  widgets: {};
+  blocks: {};
+  translations: {};
+  locale: {
+    default: string;
+    supported: string[];
+  };
+  defaultViews: {};
+}>;
+/**
+ * QA namespace with helpers
+ */
+declare const qa: typeof qaFactory & {
+  field: typeof field;
+  listView: typeof listView;
+  editView: typeof editView;
+  widget: typeof widget;
+  page: typeof page;
+};
+//#endregion
+export { qa };
+//# sourceMappingURL=qa.d.mts.map

package/dist/client/builder/qa.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa.d.mts","names":[],"sources":["../../../src/client/builder/qa.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;iBAyBS,yBAAoB;UAAX;;;;;;;;;;;;;;;;;;cAOL,WAAE"}

package/dist/client/builder/qa.mjs

@@ -0,0 +1,42 @@
+import { page } from "./page/page.mjs";
+import { widget } from "./widget/widget.mjs";
+import { AdminBuilder } from "./admin-builder.mjs";
+import { field } from "./field/field.mjs";
+import { editView, listView } from "./view/view.mjs";
+
+//#region src/client/builder/qa.ts
+/**
+* QA Namespace
+*
+* Main entry point for admin builder API.
+*/
+/**
+* Create admin builder (starts empty)
+*
+* @example
+* ```ts
+* // Without backend types
+* const admin = qa().use(coreAdminModule);
+*
+* // With backend types for autocomplete
+* import type { AppCMS } from './server/cms';
+* const admin = qa<AppCMS>().use(coreAdminModule);
+* ```
+*/
+function qaFactory() {
+	return AdminBuilder.empty();
+}
+/**
+* QA namespace with helpers
+*/
+const qa = Object.assign(qaFactory, {
+	field,
+	listView,
+	editView,
+	widget,
+	page
+});
+
+//#endregion
+export { qa };
+//# sourceMappingURL=qa.mjs.map

package/dist/client/builder/qa.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa.mjs","names":[],"sources":["../../../src/client/builder/qa.ts"],"sourcesContent":["/**\n * QA Namespace\n *\n * Main entry point for admin builder API.\n */\n\nimport { AdminBuilder } from \"./admin-builder\";\nimport { field } from \"./field/field\";\nimport { page } from \"./page/page\";\nimport { editView, listView } from \"./view/view\";\nimport { widget } from \"./widget/widget\";\n\n/**\n * Create admin builder (starts empty)\n *\n * @example\n * ```ts\n * // Without backend types\n * const admin = qa().use(coreAdminModule);\n *\n * // With backend types for autocomplete\n * import type { AppCMS } from './server/cms';\n * const admin = qa<AppCMS>().use(coreAdminModule);\n * ```\n */\nfunction qaFactory<TApp = any>() {\n\treturn AdminBuilder.empty<TApp>();\n}\n\n/**\n * QA namespace with helpers\n */\nexport const qa = Object.assign(qaFactory, {\n\t// Primitive definition helpers (for advanced use)\n\tfield,\n\tlistView,\n\teditView,\n\twidget,\n\tpage,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,SAAS,YAAwB;AAChC,QAAO,aAAa,OAAa;;;;;AAMlC,MAAa,KAAK,OAAO,OAAO,WAAW;CAE1C;CACA;CACA;CACA;CACA;CACA,CAAC"}