@questpie/admin 1.1.0 → 2.0.0

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

@@ -0,0 +1,52 @@
+import { BlockContent } from "./types.mjs";
+import * as React$1 from "react";
+import * as react_jsx_runtime24 from "react/jsx-runtime";
+
+//#region src/client/blocks/block-renderer.d.ts
+
+/**
+ * Block renderer function type.
+ * Consumers provide their own renderers mapped by block type.
+ */
+type BlockRendererFn = (props: {
+  id: string;
+  type: string;
+  values: Record<string, unknown>;
+  data?: Record<string, unknown>;
+  children?: React$1.ReactNode;
+}) => React$1.ReactNode;
+/**
+ * Props for BlockRenderer component.
+ */
+type BlockRendererProps = {
+  /** Block content from API (tree + values) */
+  content: BlockContent;
+  /** Block renderers mapped by type */
+  renderers: Record<string, BlockRendererFn>;
+  /** Prefetched data by block ID (optional, for SSR) */
+  data?: Record<string, unknown>;
+  /** Currently selected block ID (for editor mode) */
+  selectedBlockId?: string | null;
+  /** Block click handler (for editor mode) */
+  onBlockClick?: (blockId: string) => void;
+  /** Custom class name for the container */
+  className?: string;
+};
+/**
+ * Renders a tree of blocks.
+ *
+ * Iterates through the block tree and renders each block using its
+ * registered renderer component. Layout blocks receive their rendered
+ * children as the `children` prop.
+ */
+declare function BlockRenderer({
+  content,
+  renderers,
+  data,
+  selectedBlockId,
+  onBlockClick,
+  className
+}: BlockRendererProps): react_jsx_runtime24.JSX.Element | null;
+//#endregion
+export { BlockRenderer, BlockRendererProps };
+//# sourceMappingURL=block-renderer.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block-renderer.d.mts","names":[],"sources":["../../../src/client/blocks/block-renderer.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;KA8BY,eAAA;;;UAGH;SACD;aACI,OAAA,CAAM;MACZ,OAAA,CAAM;;;;KAKA,kBAAA;;WAEF;;aAEE,eAAe;;SAEnB;;;;;;;;;;;;;;;iBAgBQ,aAAA;;;;;;;GAOb,qBAAkB,mBAAA,CAAA,GAAA,CAAA,OAAA"}

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

@@ -0,0 +1,71 @@
+import { BlockScopeProvider } from "../preview/block-scope-context.mjs";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/client/blocks/block-renderer.tsx
+/**
+* Renders a tree of blocks.
+*
+* Iterates through the block tree and renders each block using its
+* registered renderer component. Layout blocks receive their rendered
+* children as the `children` prop.
+*/
+function BlockRenderer({ content, renderers, data = {}, selectedBlockId, onBlockClick, className }) {
+	/**
+	* Recursively render a block node.
+	*/
+	function renderBlock(node) {
+		const renderFn = renderers[node.type];
+		if (!renderFn) {
+			if (process.env.NODE_ENV !== "production") console.warn(`[BlockRenderer] No renderer found for block type "${node.type}"`);
+			return null;
+		}
+		const values = content._values[node.id] || {};
+		const blockData = data[node.id];
+		node.id;
+		const renderedChildren = node.children.length > 0 ? node.children.map(renderBlock) : void 0;
+		const handleClick = onBlockClick ? (e) => {
+			e.stopPropagation();
+			onBlockClick(node.id);
+		} : void 0;
+		const blockElement = /* @__PURE__ */ jsx(BlockScopeProvider, {
+			blockId: node.id,
+			basePath: "content._values",
+			children: renderFn({
+				id: node.id,
+				type: node.type,
+				values,
+				data: blockData,
+				children: renderedChildren
+			})
+		});
+		if (handleClick) return /* @__PURE__ */ jsx("div", {
+			"data-block-id": node.id,
+			"data-block-type": node.type,
+			onClick: handleClick,
+			onKeyDown: (e) => {
+				if (e.key === "Enter" || e.key === " ") {
+					e.preventDefault();
+					onBlockClick?.(node.id);
+				}
+			},
+			role: "button",
+			tabIndex: 0,
+			className: "cursor-pointer",
+			children: blockElement
+		}, node.id);
+		return /* @__PURE__ */ jsx("div", {
+			"data-block-id": node.id,
+			"data-block-type": node.type,
+			children: blockElement
+		}, node.id);
+	}
+	if (!content?._tree?.length) return null;
+	return /* @__PURE__ */ jsx("div", {
+		className,
+		children: content._tree.map(renderBlock)
+	});
+}
+
+//#endregion
+export { BlockRenderer };
+//# sourceMappingURL=block-renderer.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block-renderer.mjs","names":[],"sources":["../../../src/client/blocks/block-renderer.tsx"],"sourcesContent":["/**\n * BlockRenderer Component\n *\n * Renders a tree of blocks using registered block definitions.\n * Each block type has a renderer component that receives the block's values.\n *\n * @example\n * ```tsx\n * import { BlockRenderer } from \"@questpie/admin/client\";\n * import { blocks } from \"~/admin/blocks\";\n *\n * function PageContent({ page }) {\n *   return (\n *     <BlockRenderer\n *       content={page.content}\n *       blocks={blocks}\n *     />\n *   );\n * }\n * ```\n */\n\nimport type * as React from \"react\";\nimport { BlockScopeProvider } from \"../preview/block-scope-context.js\";\nimport type { BlockContent, BlockNode } from \"./types\";\n\n/**\n * Block renderer function type.\n * Consumers provide their own renderers mapped by block type.\n */\nexport type BlockRendererFn = (props: {\n\tid: string;\n\ttype: string;\n\tvalues: Record<string, unknown>;\n\tdata?: Record<string, unknown>;\n\tchildren?: React.ReactNode;\n}) => React.ReactNode;\n\n/**\n * Props for BlockRenderer component.\n */\nexport type BlockRendererProps = {\n\t/** Block content from API (tree + values) */\n\tcontent: BlockContent;\n\t/** Block renderers mapped by type */\n\trenderers: Record<string, BlockRendererFn>;\n\t/** Prefetched data by block ID (optional, for SSR) */\n\tdata?: Record<string, unknown>;\n\t/** Currently selected block ID (for editor mode) */\n\tselectedBlockId?: string | null;\n\t/** Block click handler (for editor mode) */\n\tonBlockClick?: (blockId: string) => void;\n\t/** Custom class name for the container */\n\tclassName?: string;\n};\n\n/**\n * Renders a tree of blocks.\n *\n * Iterates through the block tree and renders each block using its\n * registered renderer component. Layout blocks receive their rendered\n * children as the `children` prop.\n */\nexport function BlockRenderer({\n\tcontent,\n\trenderers,\n\tdata = {},\n\tselectedBlockId,\n\tonBlockClick,\n\tclassName,\n}: BlockRendererProps) {\n\t/**\n\t * Recursively render a block node.\n\t */\n\tfunction renderBlock(node: BlockNode): React.ReactNode {\n\t\tconst renderFn = renderers[node.type];\n\n\t\tif (!renderFn) {\n\t\t\tif (process.env.NODE_ENV !== \"production\") {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[BlockRenderer] No renderer found for block type \"${node.type}\"`,\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn null;\n\t\t}\n\n\t\tconst values = content._values[node.id] || {};\n\t\tconst blockData = data[node.id] as Record<string, unknown> | undefined;\n\t\tconst isSelected = selectedBlockId === node.id;\n\n\t\t// Render children for layout blocks\n\t\tconst renderedChildren =\n\t\t\tnode.children.length > 0 ? node.children.map(renderBlock) : undefined;\n\n\t\tconst handleClick = onBlockClick\n\t\t\t? (e: React.MouseEvent) => {\n\t\t\t\t\te.stopPropagation();\n\t\t\t\t\tonBlockClick(node.id);\n\t\t\t\t}\n\t\t\t: undefined;\n\n\t\tconst blockElement = (\n\t\t\t<BlockScopeProvider blockId={node.id} basePath=\"content._values\">\n\t\t\t\t{renderFn({\n\t\t\t\t\tid: node.id,\n\t\t\t\t\ttype: node.type,\n\t\t\t\t\tvalues,\n\t\t\t\t\tdata: blockData,\n\t\t\t\t\tchildren: renderedChildren,\n\t\t\t\t})}\n\t\t\t</BlockScopeProvider>\n\t\t);\n\n\t\t// Wrap in interactive container when in editor mode\n\t\tif (handleClick) {\n\t\t\treturn (\n\t\t\t\t<div\n\t\t\t\t\tkey={node.id}\n\t\t\t\t\tdata-block-id={node.id}\n\t\t\t\t\tdata-block-type={node.type}\n\t\t\t\t\tonClick={handleClick}\n\t\t\t\t\tonKeyDown={(e) => {\n\t\t\t\t\t\tif (e.key === \"Enter\" || e.key === \" \") {\n\t\t\t\t\t\t\te.preventDefault();\n\t\t\t\t\t\t\tonBlockClick?.(node.id);\n\t\t\t\t\t\t}\n\t\t\t\t\t}}\n\t\t\t\t\trole=\"button\"\n\t\t\t\t\ttabIndex={0}\n\t\t\t\t\tclassName=\"cursor-pointer\"\n\t\t\t\t>\n\t\t\t\t\t{blockElement}\n\t\t\t\t</div>\n\t\t\t);\n\t\t}\n\n\t\treturn (\n\t\t\t<div key={node.id} data-block-id={node.id} data-block-type={node.type}>\n\t\t\t\t{blockElement}\n\t\t\t</div>\n\t\t);\n\t}\n\n\tif (!content?._tree?.length) {\n\t\treturn null;\n\t}\n\n\treturn <div className={className}>{content._tree.map(renderBlock)}</div>;\n}\n\nexport default BlockRenderer;\n"],"mappings":";;;;;;;;;;;AA+DA,SAAgB,cAAc,EAC7B,SACA,WACA,OAAO,EAAE,EACT,iBACA,cACA,aACsB;;;;CAItB,SAAS,YAAY,MAAkC;EACtD,MAAM,WAAW,UAAU,KAAK;AAEhC,MAAI,CAAC,UAAU;AACd,OAAI,QAAQ,IAAI,aAAa,aAC5B,SAAQ,KACP,qDAAqD,KAAK,KAAK,GAC/D;AAEF,UAAO;;EAGR,MAAM,SAAS,QAAQ,QAAQ,KAAK,OAAO,EAAE;EAC7C,MAAM,YAAY,KAAK,KAAK;AACT,EAAoB,KAAK;EAG5C,MAAM,mBACL,KAAK,SAAS,SAAS,IAAI,KAAK,SAAS,IAAI,YAAY,GAAG;EAE7D,MAAM,cAAc,gBAChB,MAAwB;AACzB,KAAE,iBAAiB;AACnB,gBAAa,KAAK,GAAG;MAErB;EAEH,MAAM,eACL,oBAAC;GAAmB,SAAS,KAAK;GAAI,UAAS;aAC7C,SAAS;IACT,IAAI,KAAK;IACT,MAAM,KAAK;IACX;IACA,MAAM;IACN,UAAU;IACV,CAAC;IACkB;AAItB,MAAI,YACH,QACC,oBAAC;GAEA,iBAAe,KAAK;GACpB,mBAAiB,KAAK;GACtB,SAAS;GACT,YAAY,MAAM;AACjB,QAAI,EAAE,QAAQ,WAAW,EAAE,QAAQ,KAAK;AACvC,OAAE,gBAAgB;AAClB,oBAAe,KAAK,GAAG;;;GAGzB,MAAK;GACL,UAAU;GACV,WAAU;aAET;KAdI,KAAK,GAeL;AAIR,SACC,oBAAC;GAAkB,iBAAe,KAAK;GAAI,mBAAiB,KAAK;aAC/D;KADQ,KAAK,GAET;;AAIR,KAAI,CAAC,SAAS,OAAO,OACpB,QAAO;AAGR,QAAO,oBAAC;EAAe;YAAY,QAAQ,MAAM,IAAI,YAAY;GAAO"}

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

@@ -0,0 +1,4 @@
+import { AllBlockData, AllBlockValues, BlockComponentProps, BlockPrefetchData, BlockRegistry, BlockRendererComponent, BlockRendererDefinition, BlockRendererProps, BlockValues, ExtractBlockFieldValues, ExtractBlockPrefetchData, ExtractServerBlocks, ServerBlockNames, createBlockRegistry } from "./block-registry.mjs";
+import { BlockCategory, BlockContent, BlockNode, BlockRendererProps as BlockRendererProps$1, EMPTY_BLOCK_CONTENT, isBlockContent } from "./types.mjs";
+import { BlockRenderer, BlockRendererProps as BlockRendererProps$2 } from "./block-renderer.mjs";
+import { BlockPrefetchContext, BlockPrefetchError, BlockPrefetchParams, BlockPrefetchResult, TypedBlockPrefetch, prefetchBlockData } from "./prefetch.mjs";

package/dist/client/blocks/prefetch.d.mts

@@ -0,0 +1,45 @@
+import { BlockContent } from "./types.mjs";
+
+//#region src/client/blocks/prefetch.d.ts
+
+/**
+ * @deprecated No longer needed. Server auto-expands relation/upload fields.
+ */
+type BlockPrefetchContext<TCms = unknown> = {
+  cms: TCms;
+  locale: string;
+  defaultLocale: string;
+  request?: Request;
+};
+/**
+ * @deprecated No longer needed. Server auto-expands relation/upload fields.
+ */
+type BlockPrefetchParams<TCms = unknown> = BlockPrefetchContext<TCms> & {
+  id: string;
+  values: Record<string, unknown>;
+};
+/**
+ * @deprecated No longer needed. Server auto-expands relation/upload fields.
+ */
+type BlockPrefetchResult = Record<string, unknown>;
+/**
+ * @deprecated No longer needed. Server auto-expands relation/upload fields
+ * and supports manual prefetch via `.blocks({ name: { block, prefetch } })`.
+ */
+declare function prefetchBlockData<TCms = unknown>(content: BlockContent | null | undefined, _blocks: Record<string, unknown>, _context: BlockPrefetchContext<TCms>): Promise<BlockPrefetchResult>;
+/**
+ * @deprecated No longer needed. Server handles block data fetching.
+ */
+declare class BlockPrefetchError extends Error {
+  readonly blockId: string;
+  readonly blockType: string;
+  readonly cause: unknown;
+  constructor(blockId: string, blockType: string, cause: unknown);
+}
+/**
+ * @deprecated No longer needed. Server handles block data fetching.
+ */
+type TypedBlockPrefetch<TData, TCms = unknown> = (params: BlockPrefetchParams<TCms>) => Promise<TData>;
+//#endregion
+export { BlockPrefetchContext, BlockPrefetchError, BlockPrefetchParams, BlockPrefetchResult, TypedBlockPrefetch, prefetchBlockData };
+//# sourceMappingURL=prefetch.d.mts.map

package/dist/client/blocks/prefetch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.d.mts","names":[],"sources":["../../../src/client/blocks/prefetch.ts"],"sourcesContent":[],"mappings":";;;;;;;KA+BY;OACL;;;YAGK;;;;;KAMA,sCAAsC,qBAAqB;;UAE7D;;;;;KAME,mBAAA,GAAsB;;;;;iBAMZ,2CACX,0CACA,mCACC,qBAAqB,QAC9B,QAAQ;;;;cAYE,kBAAA,SAA2B,KAAA;;;;;;;;;KAgB5B,qDACF,oBAAoB,UACzB,QAAQ"}

package/dist/client/blocks/prefetch.mjs

@@ -0,0 +1,26 @@
+//#region src/client/blocks/prefetch.ts
+/**
+* @deprecated No longer needed. Server auto-expands relation/upload fields
+* and supports manual prefetch via `.blocks({ name: { block, prefetch } })`.
+*/
+async function prefetchBlockData(content, _blocks, _context) {
+	console.warn("[prefetchBlockData] Deprecated: Client-side block prefetch is no longer needed. Block data is now automatically fetched by the server afterRead hook. Remove this call — data is available via the `data` prop in block renderers.");
+	return {};
+}
+/**
+* @deprecated No longer needed. Server handles block data fetching.
+*/
+var BlockPrefetchError = class extends Error {
+	constructor(blockId, blockType, cause) {
+		const message = cause instanceof Error ? cause.message : "Unknown prefetch error";
+		super(`Block prefetch failed for "${blockType}" (${blockId}): ${message}`);
+		this.blockId = blockId;
+		this.blockType = blockType;
+		this.cause = cause;
+		this.name = "BlockPrefetchError";
+	}
+};
+
+//#endregion
+export { BlockPrefetchError, prefetchBlockData };
+//# sourceMappingURL=prefetch.mjs.map

package/dist/client/blocks/prefetch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.mjs","names":["blockId: string","blockType: string","cause: unknown"],"sources":["../../../src/client/blocks/prefetch.ts"],"sourcesContent":["/**\n * Client Block Prefetch Utilities\n *\n * @deprecated Client-side block prefetch is no longer needed.\n * Block data is now automatically handled by the server:\n *\n * 1. **Auto-expansion**: Relation/upload fields are automatically expanded\n *    to full records in the afterRead hook. No configuration needed.\n *\n * 2. **Manual prefetch**: For custom data, define prefetch in `.blocks()`:\n *    ```ts\n *    .blocks({\n *      featuredPosts: {\n *        block: featuredPostsBlock,\n *        prefetch: async ({ values, ctx }) => ({ ... }),\n *      },\n *    })\n *    ```\n *\n * Both populate `_data[blockId]` in the API response, which is\n * automatically available as the `data` prop in block renderers.\n *\n * These exports are kept for backwards compatibility but will be\n * removed in a future version.\n */\n\nimport type { BlockContent, BlockNode } from \"./types.js\";\n\n/**\n * @deprecated No longer needed. Server auto-expands relation/upload fields.\n */\nexport type BlockPrefetchContext<TCms = unknown> = {\n  cms: TCms;\n  locale: string;\n  defaultLocale: string;\n  request?: Request;\n};\n\n/**\n * @deprecated No longer needed. Server auto-expands relation/upload fields.\n */\nexport type BlockPrefetchParams<TCms = unknown> = BlockPrefetchContext<TCms> & {\n  id: string;\n  values: Record<string, unknown>;\n};\n\n/**\n * @deprecated No longer needed. Server auto-expands relation/upload fields.\n */\nexport type BlockPrefetchResult = Record<string, unknown>;\n\n/**\n * @deprecated No longer needed. Server auto-expands relation/upload fields\n * and supports manual prefetch via `.blocks({ name: { block, prefetch } })`.\n */\nexport async function prefetchBlockData<TCms = unknown>(\n  content: BlockContent | null | undefined,\n  _blocks: Record<string, unknown>,\n  _context: BlockPrefetchContext<TCms>,\n): Promise<BlockPrefetchResult> {\n  console.warn(\n    \"[prefetchBlockData] Deprecated: Client-side block prefetch is no longer needed. \" +\n      \"Block data is now automatically fetched by the server afterRead hook. \" +\n      \"Remove this call — data is available via the `data` prop in block renderers.\",\n  );\n  return {};\n}\n\n/**\n * @deprecated No longer needed. Server handles block data fetching.\n */\nexport class BlockPrefetchError extends Error {\n  constructor(\n    public readonly blockId: string,\n    public readonly blockType: string,\n    public readonly cause: unknown,\n  ) {\n    const message =\n      cause instanceof Error ? cause.message : \"Unknown prefetch error\";\n    super(`Block prefetch failed for \"${blockType}\" (${blockId}): ${message}`);\n    this.name = \"BlockPrefetchError\";\n  }\n}\n\n/**\n * @deprecated No longer needed. Server handles block data fetching.\n */\nexport type TypedBlockPrefetch<TData, TCms = unknown> = (\n  params: BlockPrefetchParams<TCms>,\n) => Promise<TData>;\n"],"mappings":";;;;;AAuDA,eAAsB,kBACpB,SACA,SACA,UAC8B;AAC9B,SAAQ,KACN,qOAGD;AACD,QAAO,EAAE;;;;;AAMX,IAAa,qBAAb,cAAwC,MAAM;CAC5C,YACE,AAAgBA,SAChB,AAAgBC,WAChB,AAAgBC,OAChB;EACA,MAAM,UACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,QAAM,8BAA8B,UAAU,KAAK,QAAQ,KAAK,UAAU;EAN1D;EACA;EACA;AAKhB,OAAK,OAAO"}

package/dist/client/blocks/types.d.mts

@@ -0,0 +1,69 @@
+import * as React$1 from "react";
+
+//#region src/client/blocks/types.d.ts
+
+/**
+ * Block node in the tree structure.
+ * Represents a single block instance with its position and children.
+ */
+type BlockNode = {
+  /** Unique block instance ID (UUID) */
+  id: string;
+  /** Block type name (e.g., "hero", "columns", "text") */
+  type: string;
+  /** Child blocks (for layout blocks that accept children) */
+  children: BlockNode[];
+};
+/**
+ * Block content structure stored in JSONB.
+ * This is the shape of data stored in the database and passed to BlockRenderer.
+ *
+ * After server-side prefetch (afterRead hook), `_data` is populated with:
+ * - Auto-expanded relation/upload fields
+ * - Manual prefetch data from `.blocks()` registration
+ */
+type BlockContent = {
+  /** Block tree with hierarchy and order */
+  _tree: BlockNode[];
+  /** Block values indexed by block ID */
+  _values: Record<string, Record<string, unknown>>;
+  /** Prefetched data from server (populated by afterRead hook) */
+  _data?: Record<string, Record<string, unknown>>;
+};
+/**
+ * Block category for organization in the block picker.
+ * Categories help users find blocks quickly when adding new content.
+ */
+type BlockCategory = "layout" | "content" | "media" | "sections" | "interactive" | (string & {});
+/**
+ * Props passed to block renderer components.
+ * Each block receives these props when being rendered.
+ *
+ * @template TValues - Block field values type (inferred from `.fields()`)
+ * @template TData - Prefetch data type (inferred from `.prefetch()`)
+ */
+type BlockRendererProps<TValues = Record<string, unknown>, TData = Record<string, unknown>> = {
+  /** Block instance ID */
+  id: string;
+  /** Block field values (merged with i18n for current locale) */
+  values: TValues;
+  /** Data from server prefetch (populated via afterRead hook into _data[blockId]) */
+  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;
+};
+/**
+ * Empty block content for initialization.
+ */
+declare const EMPTY_BLOCK_CONTENT: BlockContent;
+/**
+ * Check if a value is a valid BlockContent structure.
+ */
+declare function isBlockContent(value: unknown): value is BlockContent;
+//#endregion
+export { BlockCategory, BlockContent, BlockNode, BlockRendererProps, EMPTY_BLOCK_CONTENT, isBlockContent };
+//# sourceMappingURL=types.d.mts.map

package/dist/client/blocks/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/client/blocks/types.ts"],"sourcesContent":[],"mappings":";;;;;;;AA4CA;AAeY,KA7CA,SAAA,GA6CA;EACA;EACF,EAAA,EAAA,MAAA;EAKA;EAED,IAAA,EAAA,MAAA;EAEI;EAAe,QAAA,EAlDhB,SAkDgB,EAAA;AAU5B,CAAA;AAQA;;;;;;;;KAzDY,YAAA;;SAEH;;WAEE,eAAe;;UAEhB,eAAe;;;;;;KAOb,aAAA;;;;;;;;KAeA,6BACA,iCACF;;;;UAKA;;SAED;;aAEI,OAAA,CAAM;;;;;;;;;cAUN,qBAAqB;;;;iBAQlB,cAAA,2BAAyC"}

package/dist/client/blocks/types.mjs

@@ -0,0 +1,20 @@
+//#region src/client/blocks/types.ts
+/**
+* Empty block content for initialization.
+*/
+const EMPTY_BLOCK_CONTENT = {
+	_tree: [],
+	_values: {}
+};
+/**
+* Check if a value is a valid BlockContent structure.
+*/
+function isBlockContent(value) {
+	if (value == null || typeof value !== "object") return false;
+	const obj = value;
+	return Array.isArray(obj._tree) && typeof obj._values === "object" && obj._values !== null;
+}
+
+//#endregion
+export { EMPTY_BLOCK_CONTENT, isBlockContent };
+//# sourceMappingURL=types.mjs.map

package/dist/client/blocks/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":["EMPTY_BLOCK_CONTENT: BlockContent"],"sources":["../../../src/client/blocks/types.ts"],"sourcesContent":["/**\n * Block System Types\n *\n * Core types for the visual page building system.\n * Server stores blocks as JSONB with $i18n markers - these types\n * define the client-side structure and rendering.\n */\n\nimport type * as React from \"react\";\n\n/**\n * Block node in the tree structure.\n * Represents a single block instance with its position and children.\n */\nexport type BlockNode = {\n  /** Unique block instance ID (UUID) */\n  id: string;\n  /** Block type name (e.g., \"hero\", \"columns\", \"text\") */\n  type: string;\n  /** Child blocks (for layout blocks that accept children) */\n  children: BlockNode[];\n};\n\n/**\n * Block content structure stored in JSONB.\n * This is the shape of data stored in the database and passed to BlockRenderer.\n *\n * After server-side prefetch (afterRead hook), `_data` is populated with:\n * - Auto-expanded relation/upload fields\n * - Manual prefetch data from `.blocks()` registration\n */\nexport type BlockContent = {\n  /** Block tree with hierarchy and order */\n  _tree: BlockNode[];\n  /** Block values indexed by block ID */\n  _values: Record<string, Record<string, unknown>>;\n  /** Prefetched data from server (populated by afterRead hook) */\n  _data?: Record<string, Record<string, unknown>>;\n};\n\n/**\n * Block category for organization in the block picker.\n * Categories help users find blocks quickly when adding new content.\n */\nexport type BlockCategory =\n  | \"layout\" // Columns, Grid, Container, Section\n  | \"content\" // Text, Heading, List, Quote\n  | \"media\" // Image, Video, Gallery, Audio\n  | \"sections\" // Hero, Features, Testimonials, CTA\n  | \"interactive\" // Form, Accordion, Tabs, Carousel\n  | (string & {}); // Custom categories\n\n/**\n * Props passed to block renderer components.\n * Each block receives these props when being rendered.\n *\n * @template TValues - Block field values type (inferred from `.fields()`)\n * @template TData - Prefetch data type (inferred from `.prefetch()`)\n */\nexport type BlockRendererProps<\n  TValues = Record<string, unknown>,\n  TData = Record<string, unknown>,\n> = {\n  /** Block instance ID */\n  id: string;\n  /** Block field values (merged with i18n for current locale) */\n  values: TValues;\n  /** Data from server prefetch (populated via afterRead hook into _data[blockId]) */\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 * Empty block content for initialization.\n */\nexport const EMPTY_BLOCK_CONTENT: BlockContent = {\n  _tree: [],\n  _values: {},\n};\n\n/**\n * Check if a value is a valid BlockContent structure.\n */\nexport function isBlockContent(value: unknown): value is BlockContent {\n  if (value == null || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  return (\n    Array.isArray(obj._tree) &&\n    typeof obj._values === \"object\" &&\n    obj._values !== null\n  );\n}\n\n"],"mappings":";;;;AAgFA,MAAaA,sBAAoC;CAC/C,OAAO,EAAE;CACT,SAAS,EAAE;CACZ;;;;AAKD,SAAgB,eAAe,OAAuC;AACpE,KAAI,SAAS,QAAQ,OAAO,UAAU,SAAU,QAAO;CACvD,MAAM,MAAM;AACZ,QACE,MAAM,QAAQ,IAAI,MAAM,IACxB,OAAO,IAAI,YAAY,YACvB,IAAI,YAAY"}

package/dist/client/builder/admin-builder.d.mts

@@ -0,0 +1,112 @@
+import { MaybeLazyComponent } from "./types/common.mjs";
+import { PageBuilder } from "./page/page.mjs";
+import { DefaultViewsConfig } from "./types/views.mjs";
+import { WidgetBuilder } from "./widget/widget.mjs";
+import { AdminBuilderState, FilterEditViews, FilterListViews } from "./admin-types.mjs";
+import { Prettify, SetProperty, TypeMerge, UnsetProperty } from "questpie/shared";
+
+//#region src/client/builder/admin-builder.d.ts
+
+declare class AdminBuilder<TState extends AdminBuilderState> {
+  readonly state: TState;
+  constructor(state: TState);
+  static empty<TApp = any>(): AdminBuilder<{
+    "~app": TApp;
+    fields: {};
+    components: {};
+    listViews: {};
+    editViews: {};
+    pages: {};
+    widgets: {};
+    blocks: {};
+    translations: {};
+    locale: {
+      default: string;
+      supported: string[];
+    };
+    defaultViews: {};
+  }>;
+  /**
+   * Register field definitions
+   */
+  fields<TNewFields extends Record<string, any>>(fields: TNewFields): AdminBuilder<SetProperty<TState, "fields", Prettify<TypeMerge<TState["fields"], TNewFields>>>>;
+  /**
+   * Register component implementations
+   */
+  components<TNewComponents extends Record<string, any>>(components: TNewComponents): AdminBuilder<SetProperty<TState, "components", Prettify<TypeMerge<TState["components"], TNewComponents>>>>;
+  /**
+   * Register view definitions (auto-sorted by kind)
+   */
+  views<TNewViews extends Record<string, any>>(views: TNewViews): AdminBuilder<Prettify<TypeMerge<UnsetProperty<TState, "listViews" | "editViews">, {
+    listViews: Prettify<TypeMerge<TState["listViews"], FilterListViews<TNewViews>>>;
+    editViews: Prettify<TypeMerge<TState["editViews"], FilterEditViews<TNewViews>>>;
+  }>>>;
+  /**
+   * Register widget definitions
+   */
+  widgets<TNewWidgets extends Record<string, any>>(widgets: TNewWidgets): AdminBuilder<SetProperty<TState, "widgets", Prettify<TypeMerge<TState["widgets"], TNewWidgets>>>>;
+  /**
+   * Register page definitions
+   */
+  pages<TNewPages extends Record<string, any>>(pages: TNewPages): AdminBuilder<SetProperty<TState, "pages", Prettify<TypeMerge<TState["pages"], TNewPages>>>>;
+  /**
+   * Compose another builder (merge modules)
+   */
+  use<TOther extends AdminBuilder<any>>(other: TOther): AdminBuilder<Prettify<TypeMerge<UnsetProperty<TState, "fields" | "listViews" | "editViews" | "widgets" | "pages" | "components">, {
+    fields: Prettify<TypeMerge<TState["fields"], TOther["state"]["fields"]>>;
+    listViews: Prettify<TypeMerge<TState["listViews"], TOther["state"]["listViews"]>>;
+    editViews: Prettify<TypeMerge<TState["editViews"], TOther["state"]["editViews"]>>;
+    widgets: Prettify<TypeMerge<TState["widgets"], TOther["state"]["widgets"]>>;
+    pages: Prettify<TypeMerge<TState["pages"], TOther["state"]["pages"]>>;
+    components: Prettify<TypeMerge<TState["components"], TOther["state"]["components"]>>;
+  }>>>;
+  /**
+   * Set default views config
+   */
+  defaultViews<TDefaultViews extends DefaultViewsConfig>(config: TDefaultViews): AdminBuilder<SetProperty<TState, "defaultViews", Prettify<TypeMerge<TState["defaultViews"], TDefaultViews>>>>;
+  /**
+   * Create a page definition
+   *
+   * Creates a custom admin page outside of collections/globals.
+   *
+   * @example
+   * ```ts
+   * const builder = qa<AppCMS>().use(adminModule);
+   *
+   * const analyticsPage = builder.page("analytics", {
+   *   component: AnalyticsPage,
+   * })
+   * ```
+   */
+  page<TName extends string, TComponent extends MaybeLazyComponent>(name: TName, config: {
+    component: TComponent;
+  }): PageBuilder<{
+    name: TName;
+    component: TComponent;
+    path: undefined;
+  }>;
+  /**
+   * Create a widget definition
+   *
+   * Creates a dashboard widget.
+   *
+   * @example
+   * ```ts
+   * const builder = qa<AppCMS>().use(adminModule);
+   *
+   * const statsWidget = builder.widget("stats", {
+   *   component: StatsWidget,
+   * })
+   * ```
+   */
+  widget<TName extends string, TComponent extends MaybeLazyComponent>(name: TName, config: {
+    component: TComponent;
+  }): WidgetBuilder<{
+    name: TName;
+    "~config": any;
+    component: TComponent;
+  }>;
+}
+//#endregion
+export { AdminBuilder };
+//# sourceMappingURL=admin-builder.d.mts.map

package/dist/client/builder/admin-builder.d.mts.map

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

package/dist/client/builder/admin-builder.mjs

@@ -0,0 +1,185 @@
+import { page } from "./page/page.mjs";
+import { widget } from "./widget/widget.mjs";
+import { DEFAULT_LOCALE_CONFIG } from "questpie/shared";
+
+//#region src/client/builder/admin-builder.ts
+/**
+* Admin Builder
+*
+* Main builder class - same pattern as QuestpieBuilder.
+* Single generic TState pattern.
+*/
+var AdminBuilder = class AdminBuilder {
+	constructor(state) {
+		this.state = state;
+	}
+	static empty() {
+		return new AdminBuilder({
+			"~app": void 0,
+			fields: {},
+			components: {},
+			listViews: {},
+			editViews: {},
+			pages: {},
+			widgets: {},
+			blocks: {},
+			translations: {},
+			locale: DEFAULT_LOCALE_CONFIG,
+			defaultViews: {}
+		});
+	}
+	/**
+	* Register field definitions
+	*/
+	fields(fields) {
+		return new AdminBuilder({
+			...this.state,
+			fields: {
+				...this.state.fields,
+				...fields
+			}
+		});
+	}
+	/**
+	* Register component implementations
+	*/
+	components(components) {
+		return new AdminBuilder({
+			...this.state,
+			components: {
+				...this.state.components,
+				...components
+			}
+		});
+	}
+	/**
+	* Register view definitions (auto-sorted by kind)
+	*/
+	views(views) {
+		const listViews = {};
+		const editViews = {};
+		for (const [name, def] of Object.entries(views)) {
+			const kind = def.kind;
+			if (kind === "list") listViews[name] = def;
+			else if (kind === "edit") editViews[name] = def;
+		}
+		return new AdminBuilder({
+			...this.state,
+			listViews: {
+				...this.state.listViews,
+				...listViews
+			},
+			editViews: {
+				...this.state.editViews,
+				...editViews
+			}
+		});
+	}
+	/**
+	* Register widget definitions
+	*/
+	widgets(widgets) {
+		return new AdminBuilder({
+			...this.state,
+			widgets: {
+				...this.state.widgets,
+				...widgets
+			}
+		});
+	}
+	/**
+	* Register page definitions
+	*/
+	pages(pages) {
+		return new AdminBuilder({
+			...this.state,
+			pages: {
+				...this.state.pages,
+				...pages
+			}
+		});
+	}
+	/**
+	* Compose another builder (merge modules)
+	*/
+	use(other) {
+		const otherState = other.state;
+		return new AdminBuilder({
+			...this.state,
+			fields: {
+				...this.state.fields,
+				...otherState.fields
+			},
+			listViews: {
+				...this.state.listViews,
+				...otherState.listViews
+			},
+			editViews: {
+				...this.state.editViews,
+				...otherState.editViews
+			},
+			widgets: {
+				...this.state.widgets,
+				...otherState.widgets
+			},
+			pages: {
+				...this.state.pages,
+				...otherState.pages
+			},
+			components: {
+				...this.state.components,
+				...otherState.components
+			}
+		});
+	}
+	/**
+	* Set default views config
+	*/
+	defaultViews(config) {
+		return new AdminBuilder({
+			...this.state,
+			defaultViews: {
+				...this.state.defaultViews || {},
+				...config
+			}
+		});
+	}
+	/**
+	* Create a page definition
+	*
+	* Creates a custom admin page outside of collections/globals.
+	*
+	* @example
+	* ```ts
+	* const builder = qa<AppCMS>().use(adminModule);
+	*
+	* const analyticsPage = builder.page("analytics", {
+	*   component: AnalyticsPage,
+	* })
+	* ```
+	*/
+	page(name, config) {
+		return page(name, config);
+	}
+	/**
+	* Create a widget definition
+	*
+	* Creates a dashboard widget.
+	*
+	* @example
+	* ```ts
+	* const builder = qa<AppCMS>().use(adminModule);
+	*
+	* const statsWidget = builder.widget("stats", {
+	*   component: StatsWidget,
+	* })
+	* ```
+	*/
+	widget(name, config) {
+		return widget(name, config);
+	}
+};
+
+//#endregion
+export { AdminBuilder };
+//# sourceMappingURL=admin-builder.mjs.map