@questpie/admin 1.1.0 → 2.0.0

package/dist/client/builder/validation.mjs

@@ -0,0 +1,208 @@
+import { createFieldRegistryProxy } from "./proxies.mjs";
+import { z } from "zod";
+
+//#region src/client/builder/validation.ts
+/**
+* Client-side Validation Schema Builder
+*
+* Generates Zod schemas from admin field configurations.
+* Uses createZod from field definitions for automatic schema generation.
+* Supports nested fields (object, array) via recursive schema building.
+*/
+/**
+* Build a string schema with validations (fallback)
+*/
+function buildStringSchema(validation) {
+	let schema = z.string();
+	if (validation) {
+		if (validation.minLength !== void 0) schema = schema.min(validation.minLength, `Must be at least ${validation.minLength} characters`);
+		if (validation.maxLength !== void 0) schema = schema.max(validation.maxLength, `Must be at most ${validation.maxLength} characters`);
+		if (validation.email) schema = schema.email("Invalid email address");
+		if (validation.url) schema = schema.url("Invalid URL");
+		if (validation.pattern) {
+			const regex = typeof validation.pattern === "string" ? new RegExp(validation.pattern) : validation.pattern;
+			schema = schema.regex(regex, validation.patternMessage || "Invalid format");
+		}
+	}
+	return schema;
+}
+/**
+* Build a number schema with validations (fallback)
+*/
+function buildNumberSchema(validation) {
+	let schema = z.number();
+	if (validation) {
+		if (validation.min !== void 0) schema = schema.min(validation.min, `Must be at least ${validation.min}`);
+		if (validation.max !== void 0) schema = schema.max(validation.max, `Must be at most ${validation.max}`);
+	}
+	return schema;
+}
+/**
+* Fallback schema builder for fields without createZod
+*/
+function buildFallbackSchema(fieldType, required, validation) {
+	let schema;
+	switch (fieldType) {
+		case "text":
+		case "textarea":
+		case "email":
+		case "password":
+		case "slug":
+		case "code":
+		case "time":
+			schema = buildStringSchema(validation);
+			break;
+		case "number":
+		case "currency":
+			schema = buildNumberSchema(validation);
+			break;
+		case "switch":
+		case "checkbox":
+			schema = z.boolean();
+			break;
+		case "date":
+		case "datetime":
+			schema = z.date().or(z.string());
+			break;
+		case "select":
+			schema = z.string().or(z.number());
+			break;
+		case "relation":
+			schema = z.string().or(z.array(z.string()));
+			break;
+		case "upload":
+			schema = z.string();
+			break;
+		case "uploadMany":
+			schema = z.array(z.string());
+			break;
+		case "array":
+			schema = z.array(z.any());
+			break;
+		case "object":
+			schema = z.record(z.string(), z.any());
+			break;
+		case "json":
+		case "richText":
+			schema = z.any();
+			break;
+		default: schema = z.any();
+	}
+	if (validation?.refine) schema = validation.refine(schema);
+	if (!required) schema = schema.optional().nullable();
+	return schema;
+}
+/**
+* Creates the ZodBuildContext for recursive schema building
+*/
+function createBuildContext(registry) {
+	const ctx = {
+		registry,
+		buildSchema: (fieldDef) => {
+			const opts = fieldDef["~options"] || {};
+			if (fieldDef.createZod) return fieldDef.createZod(opts, ctx);
+			return buildFallbackSchema(fieldDef.name, opts.required, opts.validation);
+		}
+	};
+	return ctx;
+}
+/**
+* Build a Zod schema from admin field definitions
+*
+* Uses createZod from each field definition if available,
+* otherwise falls back to generic schema based on field type.
+*
+* @param fields - Field definitions from admin collection config
+* @param registry - Field registry from admin builder
+* @returns Zod object schema for the collection
+*
+* @example
+* ```ts
+* const schema = buildValidationSchema(collectionConfig.fields, admin.getFields());
+*
+* // Use with react-hook-form
+* const form = useForm({
+*   resolver: zodResolver(schema),
+* });
+* ```
+*/
+function buildValidationSchema(fields, registry) {
+	const ctx = createBuildContext(registry);
+	const shape = {};
+	for (const [name, fieldDef] of Object.entries(fields)) shape[name] = ctx.buildSchema(fieldDef);
+	return z.object(shape);
+}
+/**
+* Build validation schema with custom validation functions
+*
+* This version supports the `validate` callback in FieldValidationConfig
+* which receives form values for cross-field validation.
+*
+* @param fields - Field definitions from admin collection config
+* @param registry - Field registry from admin builder
+* @returns Zod schema with superRefine for custom validators
+*/
+function buildValidationSchemaWithCustom(fields, registry) {
+	const baseSchema = buildValidationSchema(fields, registry);
+	const customValidators = [];
+	for (const [name, fieldDef] of Object.entries(fields)) {
+		const options = fieldDef["~options"] || {};
+		if (options.validation?.validate) customValidators.push({
+			name,
+			validate: options.validation.validate
+		});
+	}
+	if (customValidators.length === 0) return baseSchema;
+	return baseSchema.superRefine((data, ctx) => {
+		for (const { name, validate } of customValidators) {
+			const error = validate(data[name], data);
+			if (error) ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				message: error,
+				path: [name]
+			});
+		}
+	});
+}
+/**
+* Create a Zod validation schema from admin field config
+*
+* Use with @hookform/resolvers/zod for react-hook-form integration.
+*
+* @param fields - Field definitions from admin collection config
+* @param registry - Field registry from admin builder
+* @returns Zod schema for form validation
+*
+* @example
+* ```tsx
+* import { zodResolver } from "@hookform/resolvers/zod";
+* import { createFormSchema } from "@questpie/admin/builder";
+*
+* // From collection config
+* const schema = createFormSchema(collectionConfig.fields, admin.getFields());
+*
+* function MyForm() {
+*   const form = useForm({
+*     resolver: zodResolver(schema),
+*   });
+*   // ...
+* }
+*
+* // Or use the hook
+* import { useCollectionValidation } from "@questpie/admin/hooks";
+*
+* function MyCollectionForm() {
+*   const schema = useCollectionValidation("posts");
+*   const form = useForm({
+*     resolver: schema ? zodResolver(schema) : undefined,
+*   });
+* }
+* ```
+*/
+function createFormSchema(fields, registry) {
+	return buildValidationSchemaWithCustom(fields, registry);
+}
+
+//#endregion
+export { buildValidationSchema, createFormSchema };
+//# sourceMappingURL=validation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.mjs","names":["schema: z.ZodTypeAny","ctx: ZodBuildContext","shape: Record<string, z.ZodTypeAny>","customValidators: Array<{\n    name: string;\n    validate: NonNullable<FieldValidationConfig[\"validate\"]>;\n  }>"],"sources":["../../../src/client/builder/validation.ts"],"sourcesContent":["/**\n * Client-side Validation Schema Builder\n *\n * Generates Zod schemas from admin field configurations.\n * Uses createZod from field definitions for automatic schema generation.\n * Supports nested fields (object, array) via recursive schema building.\n */\n\nimport { z } from \"zod\";\nimport type { FieldDefinition, ZodBuildContext } from \"./field/field\";\nimport type { FieldValidationConfig } from \"./types/field-types\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Collection fields map (from admin config)\n */\ntype FieldsMap = Record<string, FieldDefinition>;\n\n/**\n * Field registry type\n */\ntype FieldRegistry = Record<string, any>;\n\n// ============================================================================\n// Fallback Schema Builders (for fields without createZod)\n// ============================================================================\n\n/**\n * Build a string schema with validations (fallback)\n */\nfunction buildStringSchema(validation?: FieldValidationConfig): z.ZodString {\n  let schema = z.string();\n\n  if (validation) {\n    if (validation.minLength !== undefined) {\n      schema = schema.min(\n        validation.minLength,\n        `Must be at least ${validation.minLength} characters`,\n      );\n    }\n    if (validation.maxLength !== undefined) {\n      schema = schema.max(\n        validation.maxLength,\n        `Must be at most ${validation.maxLength} characters`,\n      );\n    }\n    if (validation.email) {\n      schema = schema.email(\"Invalid email address\");\n    }\n    if (validation.url) {\n      schema = schema.url(\"Invalid URL\");\n    }\n    if (validation.pattern) {\n      const regex =\n        typeof validation.pattern === \"string\"\n          ? new RegExp(validation.pattern)\n          : validation.pattern;\n      schema = schema.regex(\n        regex,\n        validation.patternMessage || \"Invalid format\",\n      );\n    }\n  }\n\n  return schema;\n}\n\n/**\n * Build a number schema with validations (fallback)\n */\nfunction buildNumberSchema(validation?: FieldValidationConfig): z.ZodNumber {\n  let schema = z.number();\n\n  if (validation) {\n    if (validation.min !== undefined) {\n      schema = schema.min(validation.min, `Must be at least ${validation.min}`);\n    }\n    if (validation.max !== undefined) {\n      schema = schema.max(validation.max, `Must be at most ${validation.max}`);\n    }\n  }\n\n  return schema;\n}\n\n/**\n * Fallback schema builder for fields without createZod\n */\nfunction buildFallbackSchema(\n  fieldType: string,\n  required?: boolean,\n  validation?: FieldValidationConfig,\n): z.ZodTypeAny {\n  let schema: z.ZodTypeAny;\n\n  switch (fieldType) {\n    case \"text\":\n    case \"textarea\":\n    case \"email\":\n    case \"password\":\n    case \"slug\":\n    case \"code\":\n    case \"time\":\n      schema = buildStringSchema(validation);\n      break;\n\n    case \"number\":\n    case \"currency\":\n      schema = buildNumberSchema(validation);\n      break;\n\n    case \"switch\":\n    case \"checkbox\":\n      schema = z.boolean();\n      break;\n\n    case \"date\":\n    case \"datetime\":\n      schema = z.date().or(z.string());\n      break;\n\n    case \"select\":\n      schema = z.string().or(z.number());\n      break;\n\n    case \"relation\":\n      schema = z.string().or(z.array(z.string()));\n      break;\n\n    case \"upload\":\n      schema = z.string();\n      break;\n\n    case \"uploadMany\":\n      schema = z.array(z.string());\n      break;\n\n    case \"array\":\n      schema = z.array(z.any());\n      break;\n\n    case \"object\":\n      schema = z.record(z.string(), z.any());\n      break;\n\n    case \"json\":\n    case \"richText\":\n      schema = z.any();\n      break;\n\n    default:\n      schema = z.any();\n  }\n\n  // Apply custom refinement from validation config\n  if (validation?.refine) {\n    schema = validation.refine(schema);\n  }\n\n  // Handle required/optional\n  if (!required) {\n    schema = schema.optional().nullable();\n  }\n\n  return schema;\n}\n\n// ============================================================================\n// Main Schema Builder\n// ============================================================================\n\n/**\n * Creates the ZodBuildContext for recursive schema building\n */\nfunction createBuildContext(registry: FieldRegistry): ZodBuildContext {\n  const ctx: ZodBuildContext = {\n    registry,\n    buildSchema: (fieldDef: FieldDefinition): z.ZodTypeAny => {\n      const opts = fieldDef[\"~options\"] || {};\n\n      // If field has createZod, use it\n      if (fieldDef.createZod) {\n        return fieldDef.createZod(opts, ctx);\n      }\n\n      // Fallback to generic schema based on field type name\n      return buildFallbackSchema(fieldDef.name, opts.required, opts.validation);\n    },\n  };\n\n  return ctx;\n}\n\n/**\n * Build a Zod schema from admin field definitions\n *\n * Uses createZod from each field definition if available,\n * otherwise falls back to generic schema based on field type.\n *\n * @param fields - Field definitions from admin collection config\n * @param registry - Field registry from admin builder\n * @returns Zod object schema for the collection\n *\n * @example\n * ```ts\n * const schema = buildValidationSchema(collectionConfig.fields, admin.getFields());\n *\n * // Use with react-hook-form\n * const form = useForm({\n *   resolver: zodResolver(schema),\n * });\n * ```\n */\nexport function buildValidationSchema(\n  fields: FieldsMap,\n  registry: FieldRegistry,\n): z.ZodObject<Record<string, z.ZodTypeAny>> {\n  const ctx = createBuildContext(registry);\n  const shape: Record<string, z.ZodTypeAny> = {};\n\n  for (const [name, fieldDef] of Object.entries(fields)) {\n    shape[name] = ctx.buildSchema(fieldDef);\n  }\n\n  return z.object(shape);\n}\n\n/**\n * Build validation schema with custom validation functions\n *\n * This version supports the `validate` callback in FieldValidationConfig\n * which receives form values for cross-field validation.\n *\n * @param fields - Field definitions from admin collection config\n * @param registry - Field registry from admin builder\n * @returns Zod schema with superRefine for custom validators\n */\nexport function buildValidationSchemaWithCustom(\n  fields: FieldsMap,\n  registry: FieldRegistry,\n): z.ZodTypeAny {\n  const baseSchema = buildValidationSchema(fields, registry);\n\n  // Collect fields with custom validate functions\n  const customValidators: Array<{\n    name: string;\n    validate: NonNullable<FieldValidationConfig[\"validate\"]>;\n  }> = [];\n\n  for (const [name, fieldDef] of Object.entries(fields)) {\n    const options = fieldDef[\"~options\"] || {};\n    if (options.validation?.validate) {\n      customValidators.push({\n        name,\n        validate: options.validation.validate,\n      });\n    }\n  }\n\n  // If no custom validators, return base schema\n  if (customValidators.length === 0) {\n    return baseSchema;\n  }\n\n  // Apply custom validators via superRefine\n  return baseSchema.superRefine((data, ctx) => {\n    for (const { name, validate } of customValidators) {\n      const error = validate(data[name], data);\n      if (error) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          message: error,\n          path: [name],\n        });\n      }\n    }\n  });\n}\n\n/**\n * Create a Zod validation schema from admin field config\n *\n * Use with @hookform/resolvers/zod for react-hook-form integration.\n *\n * @param fields - Field definitions from admin collection config\n * @param registry - Field registry from admin builder\n * @returns Zod schema for form validation\n *\n * @example\n * ```tsx\n * import { zodResolver } from \"@hookform/resolvers/zod\";\n * import { createFormSchema } from \"@questpie/admin/builder\";\n *\n * // From collection config\n * const schema = createFormSchema(collectionConfig.fields, admin.getFields());\n *\n * function MyForm() {\n *   const form = useForm({\n *     resolver: zodResolver(schema),\n *   });\n *   // ...\n * }\n *\n * // Or use the hook\n * import { useCollectionValidation } from \"@questpie/admin/hooks\";\n *\n * function MyCollectionForm() {\n *   const schema = useCollectionValidation(\"posts\");\n *   const form = useForm({\n *     resolver: schema ? zodResolver(schema) : undefined,\n *   });\n * }\n * ```\n */\nexport function createFormSchema(\n  fields: FieldsMap,\n  registry: FieldRegistry,\n): z.ZodTypeAny {\n  return buildValidationSchemaWithCustom(fields, registry);\n}\n\n// ============================================================================\n// Re-exports for convenience\n// ============================================================================\n\nexport type { ZodBuildContext } from \"./field/field\";\nexport { createFieldRegistryProxy as createRegistryProxy } from \"./proxies\";\n"],"mappings":"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"}

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

@@ -0,0 +1,129 @@
+import { MaybeLazyComponent } from "../types/common.mjs";
+import { SetProperty } from "questpie/shared";
+
+//#region src/client/builder/view/view.d.ts
+
+/**
+ * Extract viewConfig type from a view component's props.
+ *
+ * Looks for `viewConfig?: T` prop and extracts T.
+ * Returns `unknown` if not found (will be refined by $config).
+ */
+type ExtractViewConfigFromComponent<TComponent> = TComponent extends React.ComponentType<infer P> ? P extends {
+  viewConfig?: infer C;
+} ? C : unknown : unknown;
+/**
+ * Extract config from lazy component: () => Promise<{ default: Component }>
+ */
+type ExtractViewConfigFromLazy<TComponent> = TComponent extends (() => Promise<{
+  default: infer C;
+}>) ? ExtractViewConfigFromComponent<C> : ExtractViewConfigFromComponent<TComponent>;
+/**
+ * List view definition
+ */
+interface ListViewDefinition<TName extends string = string, TConfig = unknown> {
+  readonly name: TName;
+  readonly kind: "list";
+  readonly "~config": TConfig;
+  readonly component: MaybeLazyComponent;
+}
+/**
+ * Edit view definition
+ */
+interface EditViewDefinition<TName extends string = string, TConfig = unknown> {
+  readonly name: TName;
+  readonly kind: "edit";
+  readonly "~config": TConfig;
+  readonly component: MaybeLazyComponent;
+}
+interface ListViewBuilderState<TConfig = unknown> {
+  readonly name: string;
+  readonly kind: "list";
+  readonly "~config": TConfig;
+  readonly component: MaybeLazyComponent;
+}
+interface EditViewBuilderState<TConfig = unknown> {
+  readonly name: string;
+  readonly kind: "edit";
+  readonly "~config": TConfig;
+  readonly component: MaybeLazyComponent;
+}
+/**
+ * List view builder - implements ListViewDefinition for unified type handling
+ */
+declare class ListViewBuilder<TState extends ListViewBuilderState> implements ListViewDefinition<TState["name"], TState["~config"]> {
+  readonly state: TState;
+  constructor(state: TState);
+  get name(): TState["name"];
+  get kind(): "list";
+  get "~config"(): TState["~config"];
+  get component(): TState["component"];
+  /**
+   * Set or override config value and type.
+   *
+   * @param config - Optional config value (for runtime) or omit for type-only override
+   */
+  $config<TNewConfig>(config?: TNewConfig): ListViewBuilder<SetProperty<TState, "~config", TNewConfig>>;
+}
+/**
+ * Edit view builder - implements EditViewDefinition for unified type handling
+ */
+declare class EditViewBuilder<TState extends EditViewBuilderState> implements EditViewDefinition<TState["name"], TState["~config"]> {
+  readonly state: TState;
+  constructor(state: TState);
+  get name(): TState["name"];
+  get kind(): "edit";
+  get "~config"(): TState["~config"];
+  get component(): TState["component"];
+  /**
+   * Set or override config value and type.
+   *
+   * @param config - Optional config value (for runtime) or omit for type-only override
+   */
+  $config<TNewConfig>(config?: TNewConfig): EditViewBuilder<SetProperty<TState, "~config", TNewConfig>>;
+}
+/**
+ * Create a list view with automatic config type extraction.
+ *
+ * The config type is extracted from the component's `viewConfig` prop.
+ * If extraction fails, use `.$config<MyConfigType>()` to set it manually.
+ *
+ * @example
+ * ```ts
+ * // Auto-extraction from component props
+ * const tableView = listView("table", { component: TableView });
+ * // ^? ListViewBuilder<{ ~config: TableViewConfig }>
+ *
+ * // Manual config type for lazy imports
+ * const lazyTable = listView("table", { component: () => import('./TableView') })
+ *   .$config<TableViewConfig>();
+ * ```
+ */
+declare function listView<TName extends string, TComponent extends MaybeLazyComponent>(name: TName, config: {
+  component: TComponent;
+}): ListViewBuilder<{
+  name: TName;
+  kind: "list";
+  "~config": ExtractViewConfigFromLazy<TComponent>;
+  component: TComponent;
+}>;
+/**
+ * Create an edit view with automatic config type extraction.
+ *
+ * @example
+ * ```ts
+ * const formView = editView("form", { component: FormView });
+ * // ^? EditViewBuilder<{ ~config: FormViewRegistryConfig }>
+ * ```
+ */
+declare function editView<TName extends string, TComponent extends MaybeLazyComponent>(name: TName, config: {
+  component: TComponent;
+}): EditViewBuilder<{
+  name: TName;
+  kind: "edit";
+  "~config": ExtractViewConfigFromLazy<TComponent>;
+  component: TComponent;
+}>;
+//#endregion
+export { EditViewBuilder, EditViewBuilderState, EditViewDefinition, ListViewBuilder, ListViewBuilderState, ListViewDefinition, editView, listView };
+//# sourceMappingURL=view.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.mts","names":[],"sources":["../../../../src/client/builder/view/view.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/client/builder/view/view.mjs

@@ -0,0 +1,109 @@
+//#region src/client/builder/view/view.ts
+/**
+* List view builder - implements ListViewDefinition for unified type handling
+*/
+var ListViewBuilder = class ListViewBuilder {
+	constructor(state) {
+		this.state = state;
+	}
+	get name() {
+		return this.state.name;
+	}
+	get kind() {
+		return "list";
+	}
+	get "~config"() {
+		return this.state["~config"];
+	}
+	get component() {
+		return this.state.component;
+	}
+	/**
+	* Set or override config value and type.
+	*
+	* @param config - Optional config value (for runtime) or omit for type-only override
+	*/
+	$config(config) {
+		return new ListViewBuilder({
+			...this.state,
+			"~config": config ?? this.state["~config"]
+		});
+	}
+};
+/**
+* Edit view builder - implements EditViewDefinition for unified type handling
+*/
+var EditViewBuilder = class EditViewBuilder {
+	constructor(state) {
+		this.state = state;
+	}
+	get name() {
+		return this.state.name;
+	}
+	get kind() {
+		return "edit";
+	}
+	get "~config"() {
+		return this.state["~config"];
+	}
+	get component() {
+		return this.state.component;
+	}
+	/**
+	* Set or override config value and type.
+	*
+	* @param config - Optional config value (for runtime) or omit for type-only override
+	*/
+	$config(config) {
+		return new EditViewBuilder({
+			...this.state,
+			"~config": config ?? this.state["~config"]
+		});
+	}
+};
+/**
+* Create a list view with automatic config type extraction.
+*
+* The config type is extracted from the component's `viewConfig` prop.
+* If extraction fails, use `.$config<MyConfigType>()` to set it manually.
+*
+* @example
+* ```ts
+* // Auto-extraction from component props
+* const tableView = listView("table", { component: TableView });
+* // ^? ListViewBuilder<{ ~config: TableViewConfig }>
+*
+* // Manual config type for lazy imports
+* const lazyTable = listView("table", { component: () => import('./TableView') })
+*   .$config<TableViewConfig>();
+* ```
+*/
+function listView(name, config) {
+	return new ListViewBuilder({
+		name,
+		kind: "list",
+		"~config": {},
+		component: config.component
+	});
+}
+/**
+* Create an edit view with automatic config type extraction.
+*
+* @example
+* ```ts
+* const formView = editView("form", { component: FormView });
+* // ^? EditViewBuilder<{ ~config: FormViewRegistryConfig }>
+* ```
+*/
+function editView(name, config) {
+	return new EditViewBuilder({
+		name,
+		kind: "edit",
+		"~config": {},
+		component: config.component
+	});
+}
+
+//#endregion
+export { EditViewBuilder, ListViewBuilder, editView, listView };
+//# sourceMappingURL=view.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"view.mjs","names":["state: TState"],"sources":["../../../../src/client/builder/view/view.ts"],"sourcesContent":["/**\n * View Builders (List & Edit)\n *\n * Defines reusable view components for collections.\n */\n\nimport type { SetProperty } from \"questpie/shared\";\nimport type { MaybeLazyComponent } from \"../types/common\";\n\n// ============================================================================\n// Config Extraction Types\n// ============================================================================\n\n/**\n * Extract viewConfig type from a view component's props.\n *\n * Looks for `viewConfig?: T` prop and extracts T.\n * Returns `unknown` if not found (will be refined by $config).\n */\ntype ExtractViewConfigFromComponent<TComponent> =\n  TComponent extends React.ComponentType<infer P>\n    ? P extends { viewConfig?: infer C }\n      ? C\n      : unknown\n    : unknown;\n\n/**\n * Extract config from lazy component: () => Promise<{ default: Component }>\n */\ntype ExtractViewConfigFromLazy<TComponent> = TComponent extends () => Promise<{\n  default: infer C;\n}>\n  ? ExtractViewConfigFromComponent<C>\n  : ExtractViewConfigFromComponent<TComponent>;\n\n// ============================================================================\n// View Definitions\n// ============================================================================\n\n/**\n * List view definition\n */\nexport interface ListViewDefinition<\n  TName extends string = string,\n  TConfig = unknown,\n> {\n  readonly name: TName;\n  readonly kind: \"list\";\n  readonly \"~config\": TConfig;\n  readonly component: MaybeLazyComponent;\n}\n\n/**\n * Edit view definition\n */\nexport interface EditViewDefinition<\n  TName extends string = string,\n  TConfig = unknown,\n> {\n  readonly name: TName;\n  readonly kind: \"edit\";\n  readonly \"~config\": TConfig;\n  readonly component: MaybeLazyComponent;\n}\n\n// ============================================================================\n// Builder State Types\n// ============================================================================\n\nexport interface ListViewBuilderState<TConfig = unknown> {\n  readonly name: string;\n  readonly kind: \"list\";\n  readonly \"~config\": TConfig;\n  readonly component: MaybeLazyComponent;\n}\n\nexport interface EditViewBuilderState<TConfig = unknown> {\n  readonly name: string;\n  readonly kind: \"edit\";\n  readonly \"~config\": TConfig;\n  readonly component: MaybeLazyComponent;\n}\n\n// ============================================================================\n// View Builders\n// ============================================================================\n\n/**\n * List view builder - implements ListViewDefinition for unified type handling\n */\nexport class ListViewBuilder<\n  TState extends ListViewBuilderState,\n> implements ListViewDefinition<TState[\"name\"], TState[\"~config\"]> {\n  constructor(public readonly state: TState) {}\n\n  get name(): TState[\"name\"] {\n    return this.state.name;\n  }\n\n  get kind(): \"list\" {\n    return \"list\";\n  }\n\n  get \"~config\"(): TState[\"~config\"] {\n    return this.state[\"~config\"];\n  }\n\n  get component(): TState[\"component\"] {\n    return this.state.component;\n  }\n\n  /**\n   * Set or override config value and type.\n   *\n   * @param config - Optional config value (for runtime) or omit for type-only override\n   */\n  $config<TNewConfig>(\n    config?: TNewConfig,\n  ): ListViewBuilder<SetProperty<TState, \"~config\", TNewConfig>> {\n    return new ListViewBuilder({\n      ...this.state,\n      \"~config\": config ?? this.state[\"~config\"],\n    } as SetProperty<TState, \"~config\", TNewConfig>);\n  }\n}\n\n/**\n * Edit view builder - implements EditViewDefinition for unified type handling\n */\nexport class EditViewBuilder<\n  TState extends EditViewBuilderState,\n> implements EditViewDefinition<TState[\"name\"], TState[\"~config\"]> {\n  constructor(public readonly state: TState) {}\n\n  get name(): TState[\"name\"] {\n    return this.state.name;\n  }\n\n  get kind(): \"edit\" {\n    return \"edit\";\n  }\n\n  get \"~config\"(): TState[\"~config\"] {\n    return this.state[\"~config\"];\n  }\n\n  get component(): TState[\"component\"] {\n    return this.state.component;\n  }\n\n  /**\n   * Set or override config value and type.\n   *\n   * @param config - Optional config value (for runtime) or omit for type-only override\n   */\n  $config<TNewConfig>(\n    config?: TNewConfig,\n  ): EditViewBuilder<SetProperty<TState, \"~config\", TNewConfig>> {\n    return new EditViewBuilder({\n      ...this.state,\n      \"~config\": config ?? this.state[\"~config\"],\n    } as SetProperty<TState, \"~config\", TNewConfig>);\n  }\n}\n\n// ============================================================================\n// Factory Functions\n// ============================================================================\n\n/**\n * Create a list view with automatic config type extraction.\n *\n * The config type is extracted from the component's `viewConfig` prop.\n * If extraction fails, use `.$config<MyConfigType>()` to set it manually.\n *\n * @example\n * ```ts\n * // Auto-extraction from component props\n * const tableView = listView(\"table\", { component: TableView });\n * // ^? ListViewBuilder<{ ~config: TableViewConfig }>\n *\n * // Manual config type for lazy imports\n * const lazyTable = listView(\"table\", { component: () => import('./TableView') })\n *   .$config<TableViewConfig>();\n * ```\n */\nexport function listView<\n  TName extends string,\n  TComponent extends MaybeLazyComponent,\n>(\n  name: TName,\n  config: { component: TComponent },\n): ListViewBuilder<{\n  name: TName;\n  kind: \"list\";\n  \"~config\": ExtractViewConfigFromLazy<TComponent>;\n  component: TComponent;\n}> {\n  return new ListViewBuilder({\n    name,\n    kind: \"list\",\n    \"~config\": {} as ExtractViewConfigFromLazy<TComponent>,\n    component: config.component,\n  });\n}\n\n/**\n * Create an edit view with automatic config type extraction.\n *\n * @example\n * ```ts\n * const formView = editView(\"form\", { component: FormView });\n * // ^? EditViewBuilder<{ ~config: FormViewRegistryConfig }>\n * ```\n */\nexport function editView<\n  TName extends string,\n  TComponent extends MaybeLazyComponent,\n>(\n  name: TName,\n  config: { component: TComponent },\n): EditViewBuilder<{\n  name: TName;\n  kind: \"edit\";\n  \"~config\": ExtractViewConfigFromLazy<TComponent>;\n  component: TComponent;\n}> {\n  return new EditViewBuilder({\n    name,\n    kind: \"edit\",\n    \"~config\": {} as ExtractViewConfigFromLazy<TComponent>,\n    component: config.component,\n  });\n}\n"],"mappings":";;;;AA0FA,IAAa,kBAAb,MAAa,gBAEsD;CACjE,YAAY,AAAgBA,OAAe;EAAf;;CAE5B,IAAI,OAAuB;AACzB,SAAO,KAAK,MAAM;;CAGpB,IAAI,OAAe;AACjB,SAAO;;CAGT,IAAI,YAA+B;AACjC,SAAO,KAAK,MAAM;;CAGpB,IAAI,YAAiC;AACnC,SAAO,KAAK,MAAM;;;;;;;CAQpB,QACE,QAC6D;AAC7D,SAAO,IAAI,gBAAgB;GACzB,GAAG,KAAK;GACR,WAAW,UAAU,KAAK,MAAM;GACjC,CAA+C;;;;;;AAOpD,IAAa,kBAAb,MAAa,gBAEsD;CACjE,YAAY,AAAgBA,OAAe;EAAf;;CAE5B,IAAI,OAAuB;AACzB,SAAO,KAAK,MAAM;;CAGpB,IAAI,OAAe;AACjB,SAAO;;CAGT,IAAI,YAA+B;AACjC,SAAO,KAAK,MAAM;;CAGpB,IAAI,YAAiC;AACnC,SAAO,KAAK,MAAM;;;;;;;CAQpB,QACE,QAC6D;AAC7D,SAAO,IAAI,gBAAgB;GACzB,GAAG,KAAK;GACR,WAAW,UAAU,KAAK,MAAM;GACjC,CAA+C;;;;;;;;;;;;;;;;;;;;AAyBpD,SAAgB,SAId,MACA,QAMC;AACD,QAAO,IAAI,gBAAgB;EACzB;EACA,MAAM;EACN,WAAW,EAAE;EACb,WAAW,OAAO;EACnB,CAAC;;;;;;;;;;;AAYJ,SAAgB,SAId,MACA,QAMC;AACD,QAAO,IAAI,gBAAgB;EACzB;EACA,MAAM;EACN,WAAW,EAAE;EACb,WAAW,OAAO;EACnB,CAAC"}

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

@@ -0,0 +1,33 @@
+import { MaybeLazyComponent } from "../types/common.mjs";
+import { SetProperty } from "questpie/shared";
+
+//#region src/client/builder/widget/widget.d.ts
+
+interface WidgetDefinition<TName extends string = string, TConfig = any> {
+  readonly name: TName;
+  readonly component: any;
+  readonly "~config"?: TConfig;
+}
+interface WidgetBuilderState {
+  readonly name: string;
+  readonly "~config": any;
+  readonly component: any;
+}
+declare class WidgetBuilder<TState extends WidgetBuilderState> {
+  readonly state: TState;
+  constructor(state: TState);
+  $config<TNewConfig>(config: TNewConfig): WidgetBuilder<SetProperty<TState, "~config", TNewConfig>>;
+}
+/**
+ * Create a dashboard widget
+ */
+declare function widget<TName extends string, TComponent extends MaybeLazyComponent>(name: TName, config: {
+  component: TComponent;
+}): WidgetBuilder<{
+  name: TName;
+  "~config": any;
+  component: TComponent;
+}>;
+//#endregion
+export { WidgetBuilder, WidgetBuilderState, WidgetDefinition, widget };
+//# sourceMappingURL=widget.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.mts","names":[],"sources":["../../../../src/client/builder/widget/widget.ts"],"sourcesContent":[],"mappings":";;;;;AAwB0C,UAfzB,gBAeyB,CAAA,cAAA,MAAA,GAAA,MAAA,EAAA,UAAA,GAAA,CAAA,CAAA;EACL,SAAA,IAAA,EAZpB,KAYoB;EAAA,SAAA,SAAA,EAAA,GAAA;EAGzB,SAAA,SAAA,CAAA,EAbW,OAaX;;AACsC,UAXjC,kBAAA,CAWiC;EAA/B,SAAA,IAAA,EAAA,MAAA;EAAd,SAAA,SAAA,EAAA,GAAA;EAAa,SAAA,SAAA,EAAA,GAAA;AAWlB;AAEqB,cAlBR,aAkBQ,CAAA,eAlBqB,kBAkBrB,CAAA,CAAA;EAEb,SAAA,KAAA,EAnB6B,MAmB7B;EACe,WAAA,CAAA,KAAA,EApBc,MAoBd;EAEf,OAAA,CAAA,UAAA,CAAA,CAAA,MAAA,EAnBI,UAmBJ,CAAA,EAlBH,aAkBG,CAlBW,WAkBX,CAlBuB,MAkBvB,EAAA,SAAA,EAlB0C,UAkB1C,CAAA,CAAA;;;;;iBAPQ,gDAEK,0BAEb;aACe;IACpB;QACK;;aAEK"}

package/dist/client/builder/widget/widget.mjs

@@ -0,0 +1,26 @@
+//#region src/client/builder/widget/widget.ts
+var WidgetBuilder = class WidgetBuilder {
+	constructor(state) {
+		this.state = state;
+	}
+	$config(config) {
+		return new WidgetBuilder({
+			...this.state,
+			"~config": config
+		});
+	}
+};
+/**
+* Create a dashboard widget
+*/
+function widget(name, config) {
+	return new WidgetBuilder({
+		name,
+		"~config": {},
+		component: config.component
+	});
+}
+
+//#endregion
+export { WidgetBuilder, widget };
+//# sourceMappingURL=widget.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"widget.mjs","names":["state: TState"],"sources":["../../../../src/client/builder/widget/widget.ts"],"sourcesContent":["/**\n * Widget Builder\n *\n * Defines dashboard widgets.\n */\n\nimport type { SetProperty } from \"questpie/shared\";\nimport type { MaybeLazyComponent } from \"../types/common\";\n\nexport interface WidgetDefinition<\n  TName extends string = string,\n  TConfig = any,\n> {\n  readonly name: TName;\n  readonly component: any;\n  readonly \"~config\"?: TConfig;\n}\n\nexport interface WidgetBuilderState {\n  readonly name: string;\n  readonly \"~config\": any;\n  readonly component: any;\n}\n\nexport class WidgetBuilder<TState extends WidgetBuilderState> {\n  constructor(public readonly state: TState) {}\n\n  $config<TNewConfig>(\n    config: TNewConfig,\n  ): WidgetBuilder<SetProperty<TState, \"~config\", TNewConfig>> {\n    return new WidgetBuilder({\n      ...this.state,\n      \"~config\": config,\n    } as any);\n  }\n}\n\n/**\n * Create a dashboard widget\n */\nexport function widget<\n  TName extends string,\n  TComponent extends MaybeLazyComponent,\n>(\n  name: TName,\n  config: { component: TComponent },\n): WidgetBuilder<{\n  name: TName;\n  \"~config\": any;\n  component: TComponent;\n}> {\n  return new WidgetBuilder({\n    name,\n    \"~config\": {},\n    component: config.component,\n  } as any);\n}\n"],"mappings":";AAwBA,IAAa,gBAAb,MAAa,cAAiD;CAC5D,YAAY,AAAgBA,OAAe;EAAf;;CAE5B,QACE,QAC2D;AAC3D,SAAO,IAAI,cAAc;GACvB,GAAG,KAAK;GACR,WAAW;GACZ,CAAQ;;;;;;AAOb,SAAgB,OAId,MACA,QAKC;AACD,QAAO,IAAI,cAAc;EACvB;EACA,WAAW,EAAE;EACb,WAAW,OAAO;EACnB,CAAQ"}

package/dist/client/components/actions/action-button.d.mts

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