@questpie/admin 1.1.0 → 2.0.0

package/dist/_virtual/rolldown_runtime.mjs

@@ -0,0 +1,18 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll };

package/dist/augmentation.d.mts

@@ -0,0 +1,315 @@
+import { ReactiveConfig } from "questpie";
+
+//#region src/augmentation.d.ts
+
+/**
+ * Common admin options shared by all fields.
+ * Each field-specific admin meta extends this.
+ *
+ * Supports reactive configurations for dynamic field states:
+ * - `hidden`, `readOnly`, `disabled` can be boolean or reactive function
+ * - `compute` can auto-generate field values based on other fields
+ */
+interface BaseAdminMeta {
+  /**
+   * Field width in form (CSS value or number for pixels).
+   * @example "100%" | 400 | "50%"
+   */
+  width?: string | number;
+  /**
+   * Column span in grid layout (1-12).
+   * @default 12
+   */
+  colspan?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12;
+  /**
+   * Field group for form organization.
+   */
+  group?: string;
+  /**
+   * Display order within group.
+   */
+  order?: number;
+  /**
+   * Hide the field conditionally.
+   * - `true`: Always hidden
+   * - Function/config: Evaluated on server based on form data
+   *
+   * @example Static
+   * ```ts
+   * hidden: true
+   * ```
+   *
+   * @example Reactive (short syntax)
+   * ```ts
+   * hidden: ({ data }) => !data.showAdvanced
+   * ```
+   *
+   * @example Reactive (full syntax with deps)
+   * ```ts
+   * hidden: {
+   *   handler: ({ data }) => !data.showAdvanced,
+   *   deps: ['showAdvanced'],
+   * }
+   * ```
+   */
+  hidden?: boolean | ReactiveConfig<boolean>;
+  /**
+   * Make field read-only conditionally.
+   * - `true`: Always read-only
+   * - Function/config: Evaluated on server based on form data
+   *
+   * @example Reactive
+   * ```ts
+   * readOnly: ({ data }) => data.status === 'published'
+   * ```
+   */
+  readOnly?: boolean | ReactiveConfig<boolean>;
+  /**
+   * Disable the field conditionally.
+   * - `true`: Always disabled
+   * - Function/config: Evaluated on server based on form data
+   *
+   * @example Reactive
+   * ```ts
+   * disabled: ({ data }) => data.isLocked
+   * ```
+   */
+  disabled?: boolean | ReactiveConfig<boolean>;
+  /**
+   * Compute field value automatically based on other fields.
+   * Handler should return the computed value or undefined to keep current.
+   * Return null to reset field to null/default.
+   *
+   * @example Auto-generate slug from title
+   * ```ts
+   * compute: ({ data }) => slugify(data.title)
+   * ```
+   *
+   * @example With debounce and explicit deps
+   * ```ts
+   * compute: {
+   *   handler: ({ data }) => slugify(data.title),
+   *   deps: ['title'],
+   *   debounce: 300,
+   * }
+   * ```
+   *
+   * @example Reset on parent change
+   * ```ts
+   * compute: ({ data, prev }) => {
+   *   if (data.category !== prev.data.category) {
+   *     return null; // Reset when category changes
+   *   }
+   * }
+   * ```
+   */
+  compute?: ReactiveConfig<any>;
+  /**
+   * Show this field in list view columns.
+   */
+  showInList?: boolean;
+  /**
+   * Column width in list view.
+   */
+  listWidth?: string | number;
+  /**
+   * Enable sorting by this field.
+   */
+  sortable?: boolean;
+  /**
+   * Enable filtering by this field.
+   */
+  filterable?: boolean;
+}
+/**
+ * Text field admin options
+ */
+interface TextFieldAdminMeta extends BaseAdminMeta {
+  placeholder?: string;
+  showCounter?: boolean;
+  prefix?: string;
+  suffix?: string;
+  inputType?: "text" | "email" | "url" | "tel" | "search" | "password";
+}
+/**
+ * Email field admin options
+ */
+interface EmailFieldAdminMeta extends BaseAdminMeta {
+  placeholder?: string;
+  /** Show domain hint (e.g., "@company.com") */
+  domainHint?: string;
+}
+/**
+ * URL field admin options
+ */
+interface UrlFieldAdminMeta extends BaseAdminMeta {
+  placeholder?: string;
+  /** Show protocol dropdown (http/https) */
+  showProtocolDropdown?: boolean;
+  /** Default protocol if not provided */
+  defaultProtocol?: "http" | "https";
+}
+/**
+ * Textarea field admin options
+ */
+interface TextareaFieldAdminMeta extends BaseAdminMeta {
+  placeholder?: string;
+  rows?: number;
+  autoResize?: boolean;
+  richText?: boolean;
+  showCounter?: boolean;
+}
+/**
+ * Number field admin options
+ */
+interface NumberFieldAdminMeta extends BaseAdminMeta {
+  placeholder?: string;
+  showButtons?: boolean;
+  step?: number;
+}
+/**
+ * Boolean field admin options
+ */
+interface BooleanFieldAdminMeta extends BaseAdminMeta {
+  displayAs?: "checkbox" | "switch";
+}
+/**
+ * Date field admin options
+ */
+interface DateFieldAdminMeta extends BaseAdminMeta {
+  placeholder?: string;
+}
+/**
+ * Time field admin options
+ */
+interface TimeFieldAdminMeta extends BaseAdminMeta {
+  placeholder?: string;
+}
+/**
+ * Select field admin options
+ */
+interface SelectFieldAdminMeta extends BaseAdminMeta {
+  displayAs?: "dropdown" | "radio" | "checkbox" | "buttons";
+  searchable?: boolean;
+  creatable?: boolean;
+  clearable?: boolean;
+}
+/**
+ * Relation field admin options
+ */
+interface RelationFieldAdminMeta extends BaseAdminMeta {
+  displayAs?: "select" | "table" | "cards" | "list";
+  displayFields?: string[];
+  titleField?: string;
+  allowCreate?: boolean;
+  allowEdit?: boolean;
+  preload?: boolean;
+  maxItems?: number;
+}
+/**
+ * Object field admin options
+ */
+interface ObjectFieldAdminMeta extends BaseAdminMeta {
+  displayAs?: "card" | "section" | "inline";
+  collapsible?: boolean;
+  defaultCollapsed?: boolean;
+}
+/**
+ * Array field admin options
+ */
+interface ArrayFieldAdminMeta extends BaseAdminMeta {
+  displayAs?: "list" | "table" | "cards";
+  collapsible?: boolean;
+  defaultCollapsed?: boolean;
+  addLabel?: string;
+  emptyMessage?: string;
+  maxItems?: number;
+}
+/**
+ * JSON field admin options
+ */
+interface JsonFieldAdminMeta extends BaseAdminMeta {
+  /** Show as code editor */
+  codeEditor?: boolean;
+}
+/**
+ * Upload field admin options
+ */
+interface UploadFieldAdminMeta extends BaseAdminMeta {
+  accept?: string;
+  dropzoneText?: string;
+}
+/**
+ * Rich text field admin options
+ */
+interface RichTextFieldAdminMeta extends BaseAdminMeta {
+  /** Placeholder text when editor is empty */
+  placeholder?: string;
+  /** Show character count */
+  showCharacterCount?: boolean;
+  /** Maximum characters allowed */
+  maxCharacters?: number;
+  /** Minimum characters required */
+  minCharacters?: number;
+  /** Enable image uploads within editor */
+  enableImages?: boolean;
+  /** Collection to use for image uploads */
+  imageCollection?: string;
+  /** Enable media library integration */
+  enableMediaLibrary?: boolean;
+}
+/**
+ * Blocks field admin options
+ */
+interface BlocksFieldAdminMeta extends BaseAdminMeta {
+  /** Label for add block button */
+  addLabel?: string;
+  /** Message shown when no blocks present */
+  emptyMessage?: string;
+  /** Maximum number of blocks allowed */
+  maxBlocks?: number;
+  /** Minimum number of blocks required */
+  minBlocks?: number;
+  /** Enable drag & drop reordering */
+  sortable?: boolean;
+  /** Show block type selector as dropdown or grid */
+  selectorDisplayAs?: "dropdown" | "grid";
+  /** Default collapsed state for blocks */
+  defaultCollapsed?: boolean;
+}
+type AnyAdminMeta = TextFieldAdminMeta | TextareaFieldAdminMeta | EmailFieldAdminMeta | UrlFieldAdminMeta | NumberFieldAdminMeta | BooleanFieldAdminMeta | DateFieldAdminMeta | TimeFieldAdminMeta | SelectFieldAdminMeta | RelationFieldAdminMeta | ObjectFieldAdminMeta | ArrayFieldAdminMeta | JsonFieldAdminMeta | UploadFieldAdminMeta | RichTextFieldAdminMeta | BlocksFieldAdminMeta;
+/**
+ * Base widget admin meta (common options for all widgets)
+ */
+interface BaseWidgetAdminMeta {
+  /** Default grid span */
+  span?: number;
+  /** Default refresh interval */
+  refreshInterval?: number;
+}
+/**
+ * Registry interface for widget types.
+ * Users can augment this to add custom widget type configs.
+ *
+ * @example
+ * ```ts
+ * declare module "@questpie/admin" {
+ *   interface WidgetTypeRegistry {
+ *     myCustomWidget: { fetchFn: (client: any) => Promise<MyData> };
+ *   }
+ * }
+ * ```
+ */
+interface WidgetTypeRegistry {
+  stats: {};
+  chart: {};
+  recentItems: {};
+  quickActions: {};
+  value: {};
+  table: {};
+  timeline: {};
+  progress: {};
+}
+//#endregion
+export { AnyAdminMeta, ArrayFieldAdminMeta, BaseAdminMeta, BaseWidgetAdminMeta, BooleanFieldAdminMeta, DateFieldAdminMeta, JsonFieldAdminMeta, NumberFieldAdminMeta, ObjectFieldAdminMeta, RelationFieldAdminMeta, SelectFieldAdminMeta, TextFieldAdminMeta, TextareaFieldAdminMeta, TimeFieldAdminMeta, UploadFieldAdminMeta, WidgetTypeRegistry };
+//# sourceMappingURL=augmentation.d.mts.map

package/dist/augmentation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentation.d.mts","names":[],"sources":["../src/augmentation.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;UAoEiB,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8CG;;;;;;;;;;;uBAYE;;;;;;;;;;;uBAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA8BX;;;;;;;;;;;;;;;;;;;;;UA8BM,kBAAA,SAA2B;;;;;;;;;;UAW3B,mBAAA,SAA4B;;;;;;;;UAS5B,iBAAA,SAA0B;;;;;;;;;;UAW1B,sBAAA,SAA+B;;;;;;;;;;UAW/B,oBAAA,SAA6B;;;;;;;;UAS7B,qBAAA,SAA8B;;;;;;UAO9B,kBAAA,SAA2B;;;;;;UAO3B,kBAAA,SAA2B;;;;;;UAO3B,oBAAA,SAA6B;;;;;;;;;UAU7B,sBAAA,SAA+B;;;;;;;;;;;;UAa/B,oBAAA,SAA6B;;;;;;;;UAS7B,mBAAA,SAA4B;;;;;;;;;;;UAY5B,kBAAA,SAA2B;;;;;;;UAQ3B,oBAAA,SAA6B;;;;;;;UAQ7B,sBAAA,SAA+B;;;;;;;;;;;;;;;;;;;UAoB/B,oBAAA,SAA6B;;;;;;;;;;;;;;;;KAqBlC,YAAA,GACT,qBACA,yBACA,sBACA,oBACA,uBACA,wBACA,qBACA,qBACA,uBACA,yBACA,uBACA,sBACA,qBACA,uBACA,yBACA;;;;UASc,mBAAA;;;;;;;;;;;;;;;;;;;UAoBA,kBAAA"}

package/dist/client/blocks/block-registry.d.mts

@@ -0,0 +1,199 @@
+import * as React$1 from "react";
+
+//#region src/client/blocks/block-registry.d.ts
+
+/**
+ * Extract blocks from CMS type.
+ * Handles the state.blocks structure from QuestpieBuilder.
+ */
+type ExtractServerBlocks<TCMS> = TCMS extends {
+  state: {
+    blocks: infer B;
+  };
+} ? B extends Record<string, any> ? B : Record<string, never> : Record<string, never>;
+/**
+ * Get block names from CMS type.
+ */
+type ServerBlockNames<TCMS> = keyof ExtractServerBlocks<TCMS>;
+/**
+ * Extract field values type from a server block definition.
+ * Looks at the block's state.fields and extracts value types.
+ */
+type ExtractBlockFieldValues<TBlock> = TBlock extends {
+  state: {
+    fields: infer TFields;
+  };
+} ? TFields extends Record<string, {
+  $types: {
+    value: infer V;
+  };
+}> ? { [K in keyof TFields]: TFields[K]["$types"]["value"] } : Record<string, unknown> : Record<string, unknown>;
+/**
+ * Extract prefetch data type from a server block definition.
+ * Looks at the block's state.prefetch return type.
+ */
+type ExtractBlockPrefetchData<TBlock> = TBlock extends {
+  state: {
+    prefetch: (params: any) => Promise<infer R>;
+  };
+} ? R : TBlock extends {
+  state: {
+    prefetch: (params: any) => infer R;
+  };
+} ? R : undefined;
+/**
+ * Block values type for a specific block name in a CMS.
+ */
+type BlockValues<TCMS, TBlockName extends keyof ExtractServerBlocks<TCMS>> = ExtractBlockFieldValues<ExtractServerBlocks<TCMS>[TBlockName]>;
+/**
+ * Block prefetch data type for a specific block name in a CMS.
+ */
+type BlockPrefetchData<TCMS, TBlockName extends keyof ExtractServerBlocks<TCMS>> = ExtractBlockPrefetchData<ExtractServerBlocks<TCMS>[TBlockName]>;
+/**
+ * Props passed to block renderer components.
+ */
+interface BlockRendererProps<TValues = Record<string, unknown>, TData = unknown> {
+  /** Block instance ID */
+  id: string;
+  /** Block field values */
+  values: TValues;
+  /** Data from server-side prefetch (if block has prefetch defined) */
+  data: TData;
+  /** Rendered child blocks (for layout blocks) */
+  children?: React$1.ReactNode;
+  /** Whether this block is currently selected in the editor */
+  isSelected?: boolean;
+  /** Whether rendering in preview mode */
+  isPreview?: boolean;
+}
+/**
+ * Block renderer component type.
+ */
+type BlockRendererComponent<TValues = Record<string, unknown>, TData = unknown> = React$1.ComponentType<BlockRendererProps<TValues, TData>>;
+/**
+ * Block renderer definition.
+ */
+interface BlockRendererDefinition<TValues = Record<string, unknown>, TData = unknown> {
+  /** React component for rendering the block */
+  component: BlockRendererComponent<TValues, TData>;
+}
+/**
+ * Type-safe block renderer registry.
+ * Tracks which blocks have been registered for type checking.
+ */
+interface BlockRegistry<TCMS, TRegistered extends Record<string, BlockRendererDefinition<any, any>> = Record<string, never>> {
+  /**
+   * Register a renderer for a block type.
+   *
+   * @param blockName - Name of the block (must match server block definition)
+   * @param definition - Block renderer definition with component
+   * @returns Updated registry with the new block registered
+   *
+   * @example
+   * ```ts
+   * registry.register("hero", {
+   *   component: ({ values, data }) => <HeroSection {...values} data={data} />
+   * })
+   * ```
+   */
+  register<TBlockName extends ServerBlockNames<TCMS> & string>(blockName: TBlockName, definition: BlockRendererDefinition<BlockValues<TCMS, TBlockName>, BlockPrefetchData<TCMS, TBlockName>>): BlockRegistry<TCMS, TRegistered & { [K in TBlockName]: BlockRendererDefinition<BlockValues<TCMS, TBlockName>, BlockPrefetchData<TCMS, TBlockName>> }>;
+  /**
+   * Get the registered renderers.
+   */
+  readonly renderers: TRegistered;
+  /**
+   * Get a renderer by block name (runtime).
+   */
+  getRenderer(blockName: string): BlockRendererDefinition<any, any> | undefined;
+  /**
+   * Check if a block has a registered renderer (runtime).
+   */
+  hasRenderer(blockName: string): boolean;
+  /**
+   * Get all registered block names (runtime).
+   */
+  getBlockNames(): string[];
+  /**
+   * Render a block by name (runtime helper).
+   */
+  renderBlock(blockName: string, props: Omit<BlockRendererProps<any, any>, "children">, children?: React$1.ReactNode): React$1.ReactNode;
+}
+/**
+ * Create a new type-safe block renderer registry.
+ *
+ * The registry infers block value types from the server CMS type,
+ * ensuring type safety without duplicating schema definitions.
+ *
+ * @template TCMS - Server CMS type (e.g., `typeof cms` or `AppCMS`)
+ *
+ * @example
+ * ```ts
+ * import { createBlockRegistry } from "@questpie/admin/client";
+ * import type { AppCMS } from "@/server/cms";
+ *
+ * // Create typed registry
+ * export const blockRenderers = createBlockRegistry<AppCMS>()
+ *   .register("hero", {
+ *     // values is typed: { title: string, subtitle?: string, ... }
+ *     // data is typed from prefetch return type
+ *     component: ({ values, data }) => (
+ *       <section>
+ *         <h1>{values.title}</h1>
+ *         {values.subtitle && <p>{values.subtitle}</p>}
+ *       </section>
+ *     ),
+ *   })
+ *   .register("columns", {
+ *     component: ({ values, children }) => (
+ *       <div className={`grid grid-cols-${values.columnCount}`}>
+ *         {children}
+ *       </div>
+ *     ),
+ *   });
+ *
+ * // Use in BlockRenderer component
+ * function BlockRenderer({ block }: { block: BlockNode }) {
+ *   return blockRenderers.renderBlock(
+ *     block.type,
+ *     { id: block.id, values: blockValues[block.id], data: blockData[block.id] },
+ *     block.children.map(child => <BlockRenderer key={child.id} block={child} />)
+ *   );
+ * }
+ * ```
+ */
+declare function createBlockRegistry<TCMS>(): BlockRegistry<TCMS, Record<string, never>>;
+/**
+ * Extract the component props type for a registered block.
+ * Useful when you need to type component props externally.
+ *
+ * @example
+ * ```ts
+ * type HeroProps = BlockComponentProps<AppCMS, "hero">;
+ * // { id: string; values: HeroValues; data: HeroData; children?: ReactNode; ... }
+ * ```
+ */
+type BlockComponentProps<TCMS, TBlockName extends ServerBlockNames<TCMS>> = BlockRendererProps<BlockValues<TCMS, TBlockName>, BlockPrefetchData<TCMS, TBlockName>>;
+/**
+ * Helper type to get all possible block value types from CMS.
+ * Useful for union types or discriminated unions.
+ *
+ * @example
+ * ```ts
+ * type AnyBlockValues = AllBlockValues<AppCMS>;
+ * // { hero: HeroValues; text: TextValues; columns: ColumnsValues; ... }
+ * ```
+ */
+type AllBlockValues<TCMS> = { [K in ServerBlockNames<TCMS> & string]: BlockValues<TCMS, K> };
+/**
+ * Helper type to get all possible block data types from CMS.
+ *
+ * @example
+ * ```ts
+ * type AnyBlockData = AllBlockData<AppCMS>;
+ * // { hero: HeroData; featuredPosts: { posts: Post[] }; ... }
+ * ```
+ */
+type AllBlockData<TCMS> = { [K in ServerBlockNames<TCMS> & string]: BlockPrefetchData<TCMS, K> };
+//#endregion
+export { AllBlockData, AllBlockValues, BlockComponentProps, BlockPrefetchData, BlockRegistry, BlockRendererComponent, BlockRendererDefinition, BlockRendererProps, BlockValues, ExtractBlockFieldValues, ExtractBlockPrefetchData, ExtractServerBlocks, ServerBlockNames, createBlockRegistry };
+//# sourceMappingURL=block-registry.d.mts.map

package/dist/client/blocks/block-registry.d.mts.map

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

package/dist/client/blocks/block-registry.mjs

@@ -0,0 +1,88 @@
+import { jsx } from "react/jsx-runtime";
+
+//#region src/client/blocks/block-registry.tsx
+/**
+* Internal class implementing BlockRegistry.
+*/
+var BlockRegistryImpl = class BlockRegistryImpl {
+	constructor(renderers = {}) {
+		this.renderers = renderers;
+	}
+	register(blockName, definition) {
+		return new BlockRegistryImpl({
+			...this.renderers,
+			[blockName]: definition
+		});
+	}
+	getRenderer(blockName) {
+		return this.renderers[blockName];
+	}
+	hasRenderer(blockName) {
+		return blockName in this.renderers;
+	}
+	getBlockNames() {
+		return Object.keys(this.renderers);
+	}
+	renderBlock(blockName, props, children) {
+		const renderer = this.getRenderer(blockName);
+		if (!renderer) {
+			console.warn(`No renderer registered for block type: ${blockName}`);
+			return null;
+		}
+		const Component = renderer.component;
+		return /* @__PURE__ */ jsx(Component, {
+			...props,
+			children
+		});
+	}
+};
+/**
+* Create a new type-safe block renderer registry.
+*
+* The registry infers block value types from the server CMS type,
+* ensuring type safety without duplicating schema definitions.
+*
+* @template TCMS - Server CMS type (e.g., `typeof cms` or `AppCMS`)
+*
+* @example
+* ```ts
+* import { createBlockRegistry } from "@questpie/admin/client";
+* import type { AppCMS } from "@/server/cms";
+*
+* // Create typed registry
+* export const blockRenderers = createBlockRegistry<AppCMS>()
+*   .register("hero", {
+*     // values is typed: { title: string, subtitle?: string, ... }
+*     // data is typed from prefetch return type
+*     component: ({ values, data }) => (
+*       <section>
+*         <h1>{values.title}</h1>
+*         {values.subtitle && <p>{values.subtitle}</p>}
+*       </section>
+*     ),
+*   })
+*   .register("columns", {
+*     component: ({ values, children }) => (
+*       <div className={`grid grid-cols-${values.columnCount}`}>
+*         {children}
+*       </div>
+*     ),
+*   });
+*
+* // Use in BlockRenderer component
+* function BlockRenderer({ block }: { block: BlockNode }) {
+*   return blockRenderers.renderBlock(
+*     block.type,
+*     { id: block.id, values: blockValues[block.id], data: blockData[block.id] },
+*     block.children.map(child => <BlockRenderer key={child.id} block={child} />)
+*   );
+* }
+* ```
+*/
+function createBlockRegistry() {
+	return new BlockRegistryImpl();
+}
+
+//#endregion
+export { createBlockRegistry };
+//# sourceMappingURL=block-registry.mjs.map

package/dist/client/blocks/block-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-registry.mjs","names":["renderers: TRegistered"],"sources":["../../../src/client/blocks/block-registry.tsx"],"sourcesContent":["/**\n * Block Renderer Registry\n *\n * Type-safe registry for client-side block renderers that infers\n * value types from server-defined block schemas.\n *\n * Key design principles:\n * 1. Server defines WHAT (block schema, prefetch) - see @questpie/admin/server\n * 2. Client defines HOW (React components for rendering)\n * 3. Types are inferred from server CMS type - no duplication\n *\n * @example\n * ```ts\n * import { createBlockRegistry } from \"@questpie/admin/client\";\n * import type { AppCMS } from \"@/server/cms\";\n *\n * export const blockRenderers = createBlockRegistry<AppCMS>()\n *   .register(\"hero\", {\n *     // Props are inferred from server block schema!\n *     // values: { title: string, subtitle?: string, alignment: \"left\" | \"center\" | \"right\", ... }\n *     // data: Awaited<ReturnType<typeof heroBlock.prefetch>>\n *     component: ({ values, data }) => (\n *       <section className={`hero hero--${values.alignment}`}>\n *         <h1>{values.title}</h1>\n *       </section>\n *     ),\n *   })\n *   .register(\"featuredPosts\", {\n *     component: ({ values, data }) => (\n *       <div className=\"featured-posts\">\n *         {data?.posts?.map(post => <PostCard key={post.id} post={post} />)}\n *       </div>\n *     ),\n *   });\n * ```\n */\n\nimport type * as React from \"react\";\n\n// ============================================================================\n// Server Block Type Extraction\n// ============================================================================\n\n/**\n * Extract blocks from CMS type.\n * Handles the state.blocks structure from QuestpieBuilder.\n */\nexport type ExtractServerBlocks<TCMS> = TCMS extends {\n  state: { blocks: infer B };\n}\n  ? B extends Record<string, any>\n    ? B\n    : Record<string, never>\n  : Record<string, never>;\n\n/**\n * Get block names from CMS type.\n */\nexport type ServerBlockNames<TCMS> = keyof ExtractServerBlocks<TCMS>;\n\n/**\n * Extract field values type from a server block definition.\n * Looks at the block's state.fields and extracts value types.\n */\nexport type ExtractBlockFieldValues<TBlock> = TBlock extends {\n  state: { fields: infer TFields };\n}\n  ? TFields extends Record<string, { $types: { value: infer V } }>\n    ? { [K in keyof TFields]: TFields[K][\"$types\"][\"value\"] }\n    : Record<string, unknown>\n  : Record<string, unknown>;\n\n/**\n * Extract prefetch data type from a server block definition.\n * Looks at the block's state.prefetch return type.\n */\nexport type ExtractBlockPrefetchData<TBlock> = TBlock extends {\n  state: { prefetch: (params: any) => Promise<infer R> };\n}\n  ? R\n  : TBlock extends { state: { prefetch: (params: any) => infer R } }\n    ? R\n    : undefined;\n\n/**\n * Block values type for a specific block name in a CMS.\n */\nexport type BlockValues<\n  TCMS,\n  TBlockName extends keyof ExtractServerBlocks<TCMS>,\n> = ExtractBlockFieldValues<ExtractServerBlocks<TCMS>[TBlockName]>;\n\n/**\n * Block prefetch data type for a specific block name in a CMS.\n */\nexport type BlockPrefetchData<\n  TCMS,\n  TBlockName extends keyof ExtractServerBlocks<TCMS>,\n> = ExtractBlockPrefetchData<ExtractServerBlocks<TCMS>[TBlockName]>;\n\n// ============================================================================\n// Block Renderer Types\n// ============================================================================\n\n/**\n * Props passed to block renderer components.\n */\nexport interface BlockRendererProps<\n  TValues = Record<string, unknown>,\n  TData = unknown,\n> {\n  /** Block instance ID */\n  id: string;\n  /** Block field values */\n  values: TValues;\n  /** Data from server-side prefetch (if block has prefetch defined) */\n  data: TData;\n  /** Rendered child blocks (for layout blocks) */\n  children?: React.ReactNode;\n  /** Whether this block is currently selected in the editor */\n  isSelected?: boolean;\n  /** Whether rendering in preview mode */\n  isPreview?: boolean;\n}\n\n/**\n * Block renderer component type.\n */\nexport type BlockRendererComponent<\n  TValues = Record<string, unknown>,\n  TData = unknown,\n> = React.ComponentType<BlockRendererProps<TValues, TData>>;\n\n/**\n * Block renderer definition.\n */\nexport interface BlockRendererDefinition<\n  TValues = Record<string, unknown>,\n  TData = unknown,\n> {\n  /** React component for rendering the block */\n  component: BlockRendererComponent<TValues, TData>;\n}\n\n// ============================================================================\n// Block Registry\n// ============================================================================\n\n/**\n * Type-safe block renderer registry.\n * Tracks which blocks have been registered for type checking.\n */\nexport interface BlockRegistry<\n  TCMS,\n  TRegistered extends Record<string, BlockRendererDefinition<any, any>> =\n    Record<string, never>,\n> {\n  /**\n   * Register a renderer for a block type.\n   *\n   * @param blockName - Name of the block (must match server block definition)\n   * @param definition - Block renderer definition with component\n   * @returns Updated registry with the new block registered\n   *\n   * @example\n   * ```ts\n   * registry.register(\"hero\", {\n   *   component: ({ values, data }) => <HeroSection {...values} data={data} />\n   * })\n   * ```\n   */\n  register<TBlockName extends ServerBlockNames<TCMS> & string>(\n    blockName: TBlockName,\n    definition: BlockRendererDefinition<\n      BlockValues<TCMS, TBlockName>,\n      BlockPrefetchData<TCMS, TBlockName>\n    >,\n  ): BlockRegistry<\n    TCMS,\n    TRegistered & {\n      [K in TBlockName]: BlockRendererDefinition<\n        BlockValues<TCMS, TBlockName>,\n        BlockPrefetchData<TCMS, TBlockName>\n      >;\n    }\n  >;\n\n  /**\n   * Get the registered renderers.\n   */\n  readonly renderers: TRegistered;\n\n  /**\n   * Get a renderer by block name (runtime).\n   */\n  getRenderer(blockName: string): BlockRendererDefinition<any, any> | undefined;\n\n  /**\n   * Check if a block has a registered renderer (runtime).\n   */\n  hasRenderer(blockName: string): boolean;\n\n  /**\n   * Get all registered block names (runtime).\n   */\n  getBlockNames(): string[];\n\n  /**\n   * Render a block by name (runtime helper).\n   */\n  renderBlock(\n    blockName: string,\n    props: Omit<BlockRendererProps<any, any>, \"children\">,\n    children?: React.ReactNode,\n  ): React.ReactNode;\n}\n\n// ============================================================================\n// Registry Implementation\n// ============================================================================\n\n/**\n * Internal class implementing BlockRegistry.\n */\nclass BlockRegistryImpl<\n  TCMS,\n  TRegistered extends Record<string, BlockRendererDefinition<any, any>>,\n> implements BlockRegistry<TCMS, TRegistered> {\n  constructor(public readonly renderers: TRegistered = {} as TRegistered) {}\n\n  register<TBlockName extends ServerBlockNames<TCMS> & string>(\n    blockName: TBlockName,\n    definition: BlockRendererDefinition<\n      BlockValues<TCMS, TBlockName>,\n      BlockPrefetchData<TCMS, TBlockName>\n    >,\n  ): BlockRegistry<\n    TCMS,\n    TRegistered & {\n      [K in TBlockName]: BlockRendererDefinition<\n        BlockValues<TCMS, TBlockName>,\n        BlockPrefetchData<TCMS, TBlockName>\n      >;\n    }\n  > {\n    return new BlockRegistryImpl({\n      ...this.renderers,\n      [blockName]: definition,\n    } as any);\n  }\n\n  getRenderer(\n    blockName: string,\n  ): BlockRendererDefinition<any, any> | undefined {\n    return (\n      this.renderers as Record<string, BlockRendererDefinition<any, any>>\n    )[blockName];\n  }\n\n  hasRenderer(blockName: string): boolean {\n    return blockName in this.renderers;\n  }\n\n  getBlockNames(): string[] {\n    return Object.keys(this.renderers);\n  }\n\n  renderBlock(\n    blockName: string,\n    props: Omit<BlockRendererProps<any, any>, \"children\">,\n    children?: React.ReactNode,\n  ): React.ReactNode {\n    const renderer = this.getRenderer(blockName);\n    if (!renderer) {\n      console.warn(`No renderer registered for block type: ${blockName}`);\n      return null;\n    }\n    const Component = renderer.component;\n    return <Component {...props} children={children} />;\n  }\n}\n\n// ============================================================================\n// Factory Function\n// ============================================================================\n\n/**\n * Create a new type-safe block renderer registry.\n *\n * The registry infers block value types from the server CMS type,\n * ensuring type safety without duplicating schema definitions.\n *\n * @template TCMS - Server CMS type (e.g., `typeof cms` or `AppCMS`)\n *\n * @example\n * ```ts\n * import { createBlockRegistry } from \"@questpie/admin/client\";\n * import type { AppCMS } from \"@/server/cms\";\n *\n * // Create typed registry\n * export const blockRenderers = createBlockRegistry<AppCMS>()\n *   .register(\"hero\", {\n *     // values is typed: { title: string, subtitle?: string, ... }\n *     // data is typed from prefetch return type\n *     component: ({ values, data }) => (\n *       <section>\n *         <h1>{values.title}</h1>\n *         {values.subtitle && <p>{values.subtitle}</p>}\n *       </section>\n *     ),\n *   })\n *   .register(\"columns\", {\n *     component: ({ values, children }) => (\n *       <div className={`grid grid-cols-${values.columnCount}`}>\n *         {children}\n *       </div>\n *     ),\n *   });\n *\n * // Use in BlockRenderer component\n * function BlockRenderer({ block }: { block: BlockNode }) {\n *   return blockRenderers.renderBlock(\n *     block.type,\n *     { id: block.id, values: blockValues[block.id], data: blockData[block.id] },\n *     block.children.map(child => <BlockRenderer key={child.id} block={child} />)\n *   );\n * }\n * ```\n */\nexport function createBlockRegistry<TCMS>(): BlockRegistry<\n  TCMS,\n  Record<string, never>\n> {\n  return new BlockRegistryImpl<TCMS, Record<string, never>>();\n}\n\n// ============================================================================\n// Utility Types for Advanced Usage\n// ============================================================================\n\n/**\n * Extract the component props type for a registered block.\n * Useful when you need to type component props externally.\n *\n * @example\n * ```ts\n * type HeroProps = BlockComponentProps<AppCMS, \"hero\">;\n * // { id: string; values: HeroValues; data: HeroData; children?: ReactNode; ... }\n * ```\n */\nexport type BlockComponentProps<\n  TCMS,\n  TBlockName extends ServerBlockNames<TCMS>,\n> = BlockRendererProps<\n  BlockValues<TCMS, TBlockName>,\n  BlockPrefetchData<TCMS, TBlockName>\n>;\n\n/**\n * Helper type to get all possible block value types from CMS.\n * Useful for union types or discriminated unions.\n *\n * @example\n * ```ts\n * type AnyBlockValues = AllBlockValues<AppCMS>;\n * // { hero: HeroValues; text: TextValues; columns: ColumnsValues; ... }\n * ```\n */\nexport type AllBlockValues<TCMS> = {\n  [K in ServerBlockNames<TCMS> & string]: BlockValues<TCMS, K>;\n};\n\n/**\n * Helper type to get all possible block data types from CMS.\n *\n * @example\n * ```ts\n * type AnyBlockData = AllBlockData<AppCMS>;\n * // { hero: HeroData; featuredPosts: { posts: Post[] }; ... }\n * ```\n */\nexport type AllBlockData<TCMS> = {\n  [K in ServerBlockNames<TCMS> & string]: BlockPrefetchData<TCMS, K>;\n};\n"],"mappings":";;;;;;AAgOA,IAAM,oBAAN,MAAM,kBAGwC;CAC5C,YAAY,AAAgBA,YAAyB,EAAE,EAAiB;EAA5C;;CAE5B,SACE,WACA,YAYA;AACA,SAAO,IAAI,kBAAkB;GAC3B,GAAG,KAAK;IACP,YAAY;GACd,CAAQ;;CAGX,YACE,WAC+C;AAC/C,SACE,KAAK,UACL;;CAGJ,YAAY,WAA4B;AACtC,SAAO,aAAa,KAAK;;CAG3B,gBAA0B;AACxB,SAAO,OAAO,KAAK,KAAK,UAAU;;CAGpC,YACE,WACA,OACA,UACiB;EACjB,MAAM,WAAW,KAAK,YAAY,UAAU;AAC5C,MAAI,CAAC,UAAU;AACb,WAAQ,KAAK,0CAA0C,YAAY;AACnE,UAAO;;EAET,MAAM,YAAY,SAAS;AAC3B,SAAO,oBAAC;GAAU,GAAI;GAAiB;IAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDvD,SAAgB,sBAGd;AACA,QAAO,IAAI,mBAAgD"}