@questpie/admin 2.0.0 → 3.0.0

package/dist/server/block/index.d.mts

@@ -1,3 +1,4 @@
-import { AnyBlockBuilder, AnyBlockDefinition, BlockBuilder, BlockBuilderState, BlockDefinition, BlockPrefetchContext, BlockPrefetchFn, BlockPrefetchWith, BlockPrefetchWithOptions, ExpandWithResult, ExpandedRecord, InferBlockData, InferBlockValues, block } from "./block-builder.mjs";
-import { BlockSchema, getBlocksByCategory, introspectBlock, introspectBlocks } from "./introspection.mjs";
-import { BlocksPrefetchContext, createBlocksPrefetchHook, processBlocksDocument, processDocumentBlocksPrefetch } from "./prefetch.mjs";
+import { AnyBlockBuilder, AnyBlockDefinition, BlockBuilder, BlockBuilderState, BlockDefinition, BlockPrefetchContext, BlockPrefetchFn, BlockPrefetchWith, BlockPrefetchWithOptions, ExpandWithResult, ExpandedRecord, InferBlockData, InferBlockValues, block } from "../modules/admin/block/block-builder.mjs";
+import { BlockSchema, getBlocksByCategory, introspectBlock, introspectBlocks } from "../modules/admin/block/introspection.mjs";
+import { BlocksPrefetchContext, createBlocksPrefetchHook, processBlocksDocument, processDocumentBlocksPrefetch } from "../modules/admin/block/prefetch.mjs";
+import "../modules/admin/block/index.mjs";

package/dist/server/codegen/admin-client-template.mjs

@@ -0,0 +1,93 @@
+//#region src/server/codegen/admin-client-template.ts
+/**
+* Generate the admin client config file.
+*
+* Called by `runAllTargets()` for the `admin-client` target.
+* Iterates `ctx.discovered.categories` generically — no hardcoded category names.
+* Any plugin can add categories, any user can add files in any category.
+*/
+function generateAdminClientTemplate(ctx) {
+	const lines = [];
+	const modulesFile = ctx.discovered.singles.get("modules") ?? null;
+	lines.push("/**");
+	lines.push(" * Admin Client Config");
+	lines.push(" *");
+	lines.push(" * Auto-generated by questpie codegen — do not edit.");
+	lines.push(" *");
+	lines.push(" * Pass this directly to <AdminLayoutProvider admin={admin} />");
+	lines.push(" */");
+	lines.push("");
+	if (modulesFile) lines.push(generateImportLine(modulesFile));
+	const categoryFiles = /* @__PURE__ */ new Map();
+	for (const [cat, fileMap] of ctx.discovered.categories) if (fileMap.size > 0) {
+		const sorted = [...fileMap.values()].sort((a, b) => a.key.localeCompare(b.key));
+		categoryFiles.set(cat, sorted);
+		for (const file of sorted) lines.push(generateImportLine(file));
+	}
+	const singleFiles = /* @__PURE__ */ new Map();
+	for (const [key, file] of ctx.discovered.singles) {
+		if (key === "modules") continue;
+		singleFiles.set(key, file);
+		lines.push(generateImportLine(file));
+	}
+	for (const imp of ctx.extraImports) lines.push(`import ${imp.name} from "${imp.path}";`);
+	lines.push("");
+	const hasAnyUserFiles = categoryFiles.size > 0 || singleFiles.size > 0;
+	const hasExtraCode = ctx.extraRuntimeCode.length > 0;
+	const allCategories = /* @__PURE__ */ new Set();
+	for (const cat of ctx.discovered.categories.keys()) allCategories.add(cat);
+	if (ctx.target.categories) for (const cat of Object.keys(ctx.target.categories)) allCategories.add(cat);
+	if (!hasAnyUserFiles && !hasExtraCode && !modulesFile) lines.push("const admin = {};");
+	else if (!hasAnyUserFiles && !hasExtraCode && modulesFile) lines.push(`const admin = ${modulesFile.varName};`);
+	else {
+		lines.push("const admin = {");
+		for (const cat of allCategories) {
+			const files = categoryFiles.get(cat);
+			const catDecl = ctx.target.categories?.[cat];
+			if (modulesFile && files && files.length > 0) {
+				const entries = generateCategoryEntries(files, catDecl);
+				lines.push(`\t${cat}: { ...${modulesFile.varName}.${cat}, ${entries} },`);
+			} else if (modulesFile && (!files || files.length === 0)) lines.push(`\t${cat}: { ...${modulesFile.varName}.${cat} },`);
+			else if (files && files.length > 0) {
+				const entries = generateCategoryEntries(files, catDecl);
+				lines.push(`\t${cat}: { ${entries} },`);
+			}
+		}
+		for (const [key, file] of singleFiles) lines.push(`\t${key}: ${file.varName},`);
+		for (const code of ctx.extraRuntimeCode) lines.push(`\t${code}`);
+		lines.push("};");
+	}
+	if (ctx.extraTypeDeclarations.length > 0) {
+		lines.push("");
+		for (const decl of ctx.extraTypeDeclarations) lines.push(decl);
+	}
+	lines.push("");
+	lines.push("export default admin;");
+	lines.push("");
+	return { code: lines.join("\n") };
+}
+/**
+* Generate category entries string based on the category's key strategy.
+*
+* When `keyFromProperty` is set (e.g., views with `keyFromProperty: "name"`),
+* uses runtime property as key: `[_view_kanban.name]: _view_kanban`.
+*
+* Otherwise uses the file-derived key: `"bookingCta": _block_bookingCta`.
+*/
+function generateCategoryEntries(files, catDecl) {
+	const keyProp = catDecl?.keyFromProperty;
+	return files.map((f) => {
+		if (keyProp) return `[${f.varName}.${keyProp}]: ${f.varName}`;
+		return `${JSON.stringify(f.key)}: ${f.varName}`;
+	}).join(", ");
+}
+/**
+* Generate an import line for a discovered file.
+*/
+function generateImportLine(file) {
+	if (file.exportType === "named" && file.namedExportName) return `import { ${file.namedExportName} as ${file.varName} } from "${file.importPath}";`;
+	return `import ${file.varName} from "${file.importPath}";`;
+}
+
+//#endregion
+export { generateAdminClientTemplate };

package/dist/server/codegen/projection-validator.mjs

@@ -0,0 +1,67 @@
+//#region src/server/codegen/projection-validator.ts
+/**
+* Category projections to validate between server and admin-client.
+*
+* Each entry describes a server-side category whose discovered keys
+* must have a corresponding key in the admin-client target.
+*
+* `serverCategory` = category name in the "server" target discovery
+* `clientCategory` = category name in the "admin-client" target discovery
+* `suggestedDir`   = where the user should create the missing file
+*/
+const PROJECTION_CHECKS = [
+	{
+		serverCategory: "blocks",
+		clientCategory: "blocks",
+		suggestedDir: "questpie/admin/blocks",
+		label: "block renderer"
+	},
+	{
+		serverCategory: "views",
+		clientCategory: "views",
+		suggestedDir: "questpie/admin/views",
+		label: "view definition"
+	},
+	{
+		serverCategory: "components",
+		clientCategory: "components",
+		suggestedDir: "questpie/admin/components",
+		label: "component definition"
+	}
+];
+/**
+* Create a cross-target validator for admin projection checks.
+*
+* Compares discovered file keys between the "server" and "admin-client"
+* targets. Any key present in the server target but missing from the
+* admin-client target produces an error.
+*
+* @returns A `CrossTargetValidator` function
+*/
+function createAdminProjectionValidator() {
+	return (targets) => {
+		const serverResult = targets.get("server");
+		const adminClientResult = targets.get("admin-client");
+		if (!serverResult || !adminClientResult) return [];
+		const errors = [];
+		for (const check of PROJECTION_CHECKS) {
+			const serverFiles = serverResult.discovered.categories.get(check.serverCategory);
+			const clientFiles = adminClientResult.discovered.categories.get(check.clientCategory);
+			if (!serverFiles || serverFiles.size === 0) continue;
+			const clientKeys = /* @__PURE__ */ new Set();
+			if (clientFiles) for (const key of clientFiles.keys()) clientKeys.add(key);
+			for (const [key, file] of serverFiles) if (!clientKeys.has(key)) errors.push({
+				severity: "error",
+				category: check.serverCategory,
+				key,
+				sourceTarget: "server",
+				consumerTarget: "admin-client",
+				message: `Server defines ${check.serverCategory}/${file.key} but no matching ${check.label} was found in the admin client. Create a file at ${check.suggestedDir}/${file.key}.tsx to fix this.`
+			});
+		}
+		return errors;
+	};
+}
+
+//#endregion
+export { createAdminProjectionValidator };

package/dist/server/fields/blocks.d.mts

@@ -1,7 +1,5 @@
-import { AnyBlockDefinition } from "../block/block-builder.mjs";
-import { z } from "zod";
-import * as questpie18982 from "questpie";
-import { BaseFieldConfig, ContextualOperators, FieldMetadataBase } from "questpie";
+import { DefaultFieldState, Field } from "questpie";
+import { PgJsonbBuilder } from "drizzle-orm/pg-core";
 
 //#region src/server/fields/blocks.d.ts
 
@@ -53,87 +51,21 @@ interface BlocksFieldMeta {
   /** Phantom property to prevent interface collapse - enables module augmentation */
   _?: never;
 }
-/**
- * Blocks field configuration options.
- */
-interface BlocksFieldConfig extends BaseFieldConfig {
-  /** Field-specific metadata, augmentable by external packages. */
-  meta?: BlocksFieldMeta;
-  /**
-   * Allowed block types.
-   * If specified, only these block types can be added.
-   * Block types must be registered via `.blocks()` on the CMS builder.
-   */
-  allowedBlocks?: string[];
-  /**
-   * Minimum number of blocks required.
-   */
-  minBlocks?: number;
-  /**
-   * Maximum number of blocks allowed.
-   */
-  maxBlocks?: number;
-  /**
-   * Allow nesting blocks (blocks with children).
-   * @default true
-   */
-  allowNesting?: boolean;
-  /**
-   * Maximum nesting depth for blocks.
-   * Only applies when allowNesting is true.
-   * @default 3
-   */
-  maxDepth?: number;
-  /**
-   * Placeholder text shown when no blocks exist.
-   */
-  placeholder?: string;
-  /**
-   * Block definitions injected at build time by `.blocks()` patch.
-   * Used for per-block field validation in toZodSchema().
-   * @internal
-   */
-  _blockDefinitions?: Record<string, AnyBlockDefinition>;
-}
 /**
  * Blocks field factory.
  * Creates a visual block editor field for page builder functionality.
  *
  * @example
  * ```ts
- * // Basic blocks field
- * const content = blocksField({ label: "Content" });
- *
- * // With allowed blocks
- * const pageContent = blocksField({
- *   label: "Page Sections",
- *   allowedBlocks: ["hero", "features", "testimonials", "cta"],
- *   minBlocks: 1,
- *   maxBlocks: 20,
- * });
- *
- * // With nesting disabled
- * const simpleBlocks = blocksField({
- *   label: "Components",
- *   allowNesting: false,
- * });
+ * // In collection fields callback:
+ * sections: f.blocks().required()
  * ```
  */
-declare const blocksField: {
-  readonly type: "blocks";
-  readonly _value: BlocksDocument;
-  readonly toColumn: (_name: string, config: BlocksFieldConfig) => any;
-  readonly toZodSchema: (config: BlocksFieldConfig) => z.ZodType<BlocksDocument | null | undefined, unknown, z.core.$ZodTypeInternals<BlocksDocument | null | undefined, unknown>>;
-  readonly getOperators: <TApp>() => ContextualOperators<questpie18982.OperatorMap, questpie18982.OperatorMap>;
-  readonly getMetadata: (config: BlocksFieldConfig) => FieldMetadataBase & {
-    allowedBlocks?: string[];
-    minBlocks?: number;
-    maxBlocks?: number;
-    allowNesting: boolean;
-    maxDepth: number;
-    placeholder?: string;
-  };
+type BlocksFieldState = DefaultFieldState & {
+  type: "blocks";
+  data: BlocksDocument;
+  column: PgJsonbBuilder;
 };
+declare function blocks(): Field<BlocksFieldState>;
 //#endregion
-export { BlockNode, BlockValues, BlocksDocument, BlocksFieldConfig, BlocksFieldMeta, blocksField };
-//# sourceMappingURL=blocks.d.mts.map
+export { BlockNode, BlockValues, BlocksDocument, BlocksFieldMeta, BlocksFieldState, blocks };

package/dist/server/fields/blocks.mjs

@@ -1,20 +1,9 @@
+import { processBlocksDocument } from "../modules/admin/block/prefetch.mjs";
 import { z } from "zod";
-import { field, isNotNull, isNull, jsonb, sql } from "questpie";
+import { field, fieldType, getContext, isNotNull, isNull, jsonb, sql } from "questpie";
 
 //#region src/server/fields/blocks.ts
 /**
-* Blocks Field Type
-*
-* Visual block editor field stored as JSONB.
-* Provides a tree-based structure for page builder functionality.
-*
-* The blocks field stores data in a normalized format:
-* - _tree: Array of block nodes with id, type, and children
-* - _values: Record mapping block id to field values
-*
-* This field type is only available when using adminModule.
-*/
-/**
 * Get operators for blocks field.
 * Provides operators for querying block content.
 */
@@ -79,114 +68,84 @@ function getBlocksOperators() {
 	};
 }
 /**
-* Blocks field factory.
-* Creates a visual block editor field for page builder functionality.
+* Create a blocks field.
 *
 * @example
 * ```ts
-* // Basic blocks field
-* const content = blocksField({ label: "Content" });
-*
-* // With allowed blocks
-* const pageContent = blocksField({
-*   label: "Page Sections",
-*   allowedBlocks: ["hero", "features", "testimonials", "cta"],
-*   minBlocks: 1,
-*   maxBlocks: 20,
-* });
-*
-* // With nesting disabled
-* const simpleBlocks = blocksField({
-*   label: "Components",
-*   allowNesting: false,
-* });
+* sections: f.blocks().required()
 * ```
 */
-const blocksField = field()({
-	type: "blocks",
-	_value: void 0,
-	toColumn(_name, config) {
-		let column = jsonb();
-		if (config.required && config.nullable !== true) column = column.notNull();
-		if (config.default !== void 0) {
-			const defaultValue = typeof config.default === "function" ? config.default() : config.default;
-			column = column.default(defaultValue);
-		}
-		return column;
-	},
-	toZodSchema(config) {
-		const blockNodeSchema = z.lazy(() => z.object({
-			id: z.string(),
-			type: z.string(),
-			children: z.array(blockNodeSchema).default([])
-		}));
-		let docSchema = z.object({
-			_tree: z.array(blockNodeSchema),
-			_values: z.record(z.string(), z.record(z.string(), z.any()))
-		});
-		if (config.minBlocks !== void 0 || config.maxBlocks !== void 0) docSchema = docSchema.refine((doc) => {
-			const count = doc._tree.length;
-			if (config.minBlocks !== void 0 && count < config.minBlocks) return false;
-			if (config.maxBlocks !== void 0 && count > config.maxBlocks) return false;
-			return true;
-		}, { message: config.minBlocks !== void 0 && config.maxBlocks !== void 0 ? `Must have between ${config.minBlocks} and ${config.maxBlocks} blocks` : config.minBlocks !== void 0 ? `Must have at least ${config.minBlocks} blocks` : `Must have at most ${config.maxBlocks} blocks` });
-		if (config._blockDefinitions && Object.keys(config._blockDefinitions).length > 0) {
-			const blockDefs = config._blockDefinitions;
-			docSchema = docSchema.superRefine((doc, ctx) => {
-				const allNodes = [];
-				const collectNodes = (nodes) => {
-					for (const node of nodes) {
-						allNodes.push(node);
-						if (node.children.length > 0) collectNodes(node.children);
-					}
-				};
-				collectNodes(doc._tree);
-				for (const node of allNodes) {
-					const blockDef = blockDefs[node.type];
-					if (!blockDef?.state.fields) continue;
-					const blockValues = doc._values[node.id] || {};
-					for (const [fieldName, fieldDef] of Object.entries(blockDef.state.fields)) if (fieldDef && typeof fieldDef === "object" && "toZodSchema" in fieldDef && typeof fieldDef.toZodSchema === "function") {
-						const result = fieldDef.toZodSchema().safeParse(blockValues[fieldName]);
-						if (!result.success) for (const issue of result.error.issues) ctx.addIssue({
-							...issue,
-							path: [
-								"_values",
-								node.id,
-								fieldName,
-								...issue.path
-							],
-							message: `Block "${node.type}" field "${fieldName}": ${issue.message}`
-						});
-					}
-				}
+/**
+* Blocks field runtime state factory.
+* Shared between the legacy `blocks()` function and the new `blocksFieldType`.
+*/
+function createBlocksState() {
+	return {
+		type: "blocks",
+		columnFactory: (name) => jsonb(name),
+		schemaFactory: () => {
+			const blockNodeSchema = z.lazy(() => z.object({
+				id: z.string(),
+				type: z.string(),
+				children: z.array(blockNodeSchema).default([])
+			}));
+			return z.object({
+				_tree: z.array(blockNodeSchema),
+				_values: z.record(z.string(), z.record(z.string(), z.any()))
 			});
-		}
-		if (!config.required && config.nullable !== false) return docSchema.nullish();
-		return docSchema;
-	},
-	getOperators() {
-		return getBlocksOperators();
-	},
-	getMetadata(config) {
-		return {
+		},
+		operatorSet: {
+			jsonbCast: null,
+			column: getBlocksOperators().column
+		},
+		metadataFactory: (state) => ({
 			type: "blocks",
-			label: config.label,
-			description: config.description,
-			required: config.required ?? false,
-			localized: config.localized ?? false,
-			readOnly: config.input === false,
-			writeOnly: config.output === false,
-			meta: config.meta,
-			allowedBlocks: config.allowedBlocks,
-			minBlocks: config.minBlocks,
-			maxBlocks: config.maxBlocks,
-			allowNesting: config.allowNesting ?? true,
-			maxDepth: config.maxDepth ?? 3,
-			placeholder: config.placeholder
-		};
-	}
-});
+			label: state.label,
+			description: state.description,
+			required: state.notNull ?? false,
+			localized: state.localized ?? false,
+			readOnly: state.input === false ? true : void 0,
+			writeOnly: state.output === false ? true : void 0,
+			meta: state.extensions?.admin
+		}),
+		hooks: { afterRead: async (value) => {
+			if (!value || typeof value !== "object") return value;
+			const doc = value;
+			if (!doc._tree || !doc._values) return value;
+			try {
+				const { app, db, locale } = getContext();
+				const blockDefs = app.state?.blocks;
+				if (!blockDefs || Object.keys(blockDefs).length === 0) return value;
+				return await processBlocksDocument(doc, blockDefs, {
+					app,
+					db,
+					locale,
+					collections: app.collections,
+					globals: app.globals
+				});
+			} catch {
+				return value;
+			}
+		} },
+		notNull: false,
+		hasDefault: false,
+		localized: false,
+		virtual: false,
+		input: true,
+		output: true,
+		isArray: false
+	};
+}
+function blocks() {
+	return field(createBlocksState());
+}
+/**
+* Blocks field type definition (v3 API).
+*
+* Use this with the `fieldType()` discovery system instead of the
+* legacy `blocks()` factory function.
+*/
+const blocksFieldType = fieldType("blocks", { create: createBlocksState });
 
 //#endregion
-export { blocksField };
-//# sourceMappingURL=blocks.mjs.map
+export { blocks };

package/dist/server/fields/index.d.mts

@@ -1,48 +1,15 @@
-import { BlockNode, BlockValues, BlocksDocument, BlocksFieldConfig, BlocksFieldMeta, blocksField } from "./blocks.mjs";
-import { RichTextFeature, RichTextFieldConfig, RichTextFieldMeta, TipTapDocument, TipTapNode, richTextField } from "./rich-text.mjs";
-import * as zod1802 from "zod";
-import * as questpie10338 from "questpie";
-import * as better_auth201 from "better-auth";
+import { BlockNode, BlockValues, BlocksDocument, BlocksFieldMeta, BlocksFieldState, blocks } from "./blocks.mjs";
+import { RichTextFeature, RichTextFieldMeta, RichTextFieldState, TipTapDocument, TipTapNode, richText } from "./rich-text.mjs";
 
 //#region src/server/fields/index.d.ts
 
 /**
  * Admin field types to be registered with the field registry.
- * These are automatically registered when adminModule is used.
+ * These are V2 factory functions — callable in `.fields()` callbacks.
  */
 declare const adminFields: {
-  readonly richText: {
-    readonly type: "richText";
-    readonly _value: TipTapDocument;
-    readonly toColumn: (_name: string, config: RichTextFieldConfig) => any;
-    readonly toZodSchema: (config: RichTextFieldConfig) => any;
-    readonly getOperators: <TApp>() => questpie10338.ContextualOperators<questpie10338.OperatorMap, questpie10338.OperatorMap>;
-    readonly getMetadata: (config: RichTextFieldConfig) => questpie10338.FieldMetadataBase & {
-      maxCharacters?: number;
-      minCharacters?: number;
-      features: RichTextFeature[];
-      headingLevels: (1 | 2 | 3 | 4 | 5 | 6)[];
-      placeholder?: string;
-      allowImages?: boolean;
-      imageCollection?: string;
-    };
-  };
-  readonly blocks: {
-    readonly type: "blocks";
-    readonly _value: BlocksDocument;
-    readonly toColumn: (_name: string, config: BlocksFieldConfig) => any;
-    readonly toZodSchema: (config: BlocksFieldConfig) => zod1802.ZodType<BlocksDocument | null | undefined, unknown, better_auth201.$ZodTypeInternals<BlocksDocument | null | undefined, unknown>>;
-    readonly getOperators: <TApp>() => questpie10338.ContextualOperators<questpie10338.OperatorMap, questpie10338.OperatorMap>;
-    readonly getMetadata: (config: BlocksFieldConfig) => questpie10338.FieldMetadataBase & {
-      allowedBlocks?: string[];
-      minBlocks?: number;
-      maxBlocks?: number;
-      allowNesting: boolean;
-      maxDepth: number;
-      placeholder?: string;
-    };
-  };
+  readonly richText: typeof richText;
+  readonly blocks: typeof blocks;
 };
 //#endregion
-export { adminFields };
-//# sourceMappingURL=index.d.mts.map
+export { adminFields };

package/dist/server/fields/index.mjs

@@ -1,16 +1,15 @@
-import { blocksField } from "./blocks.mjs";
-import { richTextField } from "./rich-text.mjs";
+import { blocks } from "./blocks.mjs";
+import { richText } from "./rich-text.mjs";
 
 //#region src/server/fields/index.ts
 /**
 * Admin field types to be registered with the field registry.
-* These are automatically registered when adminModule is used.
+* These are V2 factory functions — callable in `.fields()` callbacks.
 */
 const adminFields = {
-	richText: richTextField,
-	blocks: blocksField
+	richText,
+	blocks
 };
 
 //#endregion
-export { adminFields };
-//# sourceMappingURL=index.mjs.map
+export { adminFields };

package/dist/server/fields/rich-text.d.mts

@@ -1,5 +1,5 @@
-import * as questpie18984 from "questpie";
-import { BaseFieldConfig, ContextualOperators, FieldMetadataBase } from "questpie";
+import { DefaultFieldState, Field } from "questpie";
+import { PgJsonbBuilder } from "drizzle-orm/pg-core";
 
 //#region src/server/fields/rich-text.d.ts
 
@@ -48,88 +48,21 @@ interface RichTextFieldMeta {
  * Available rich text editor features.
  */
 type RichTextFeature = "bold" | "italic" | "underline" | "strike" | "code" | "subscript" | "superscript" | "heading" | "bulletList" | "orderedList" | "taskList" | "blockquote" | "codeBlock" | "horizontalRule" | "link" | "image" | "table" | "textAlign" | "textColor" | "highlight" | "mention";
-/**
- * Rich text field configuration options.
- */
-interface RichTextFieldConfig extends BaseFieldConfig {
-  /** Field-specific metadata, augmentable by external packages. */
-  meta?: RichTextFieldMeta;
-  /**
-   * Maximum character count (excluding formatting).
-   * When set, shows character counter in editor.
-   */
-  maxCharacters?: number;
-  /**
-   * Minimum character count (excluding formatting).
-   */
-  minCharacters?: number;
-  /**
-   * Enabled editor features.
-   * If not specified, uses a sensible default set.
-   * @default ["bold", "italic", "link", "heading", "bulletList", "orderedList"]
-   */
-  features?: RichTextFeature[];
-  /**
-   * Allowed heading levels when heading feature is enabled.
-   * @default [1, 2, 3]
-   */
-  headingLevels?: (1 | 2 | 3 | 4 | 5 | 6)[];
-  /**
-   * Placeholder text shown when editor is empty.
-   */
-  placeholder?: string;
-  /**
-   * Allow uploading/embedding images.
-   * Requires storage configuration.
-   */
-  allowImages?: boolean;
-  /**
-   * Collection to use for image uploads.
-   * Defaults to "assets" if storage is configured.
-   */
-  imageCollection?: string;
-}
 /**
  * Rich text field factory.
  * Creates a TipTap-based rich text editor field.
  *
  * @example
  * ```ts
- * // Basic rich text
- * const content = richTextField({ label: "Content" });
- *
- * // With all features
- * const richContent = richTextField({
- *   label: "Article Content",
- *   features: ["bold", "italic", "underline", "heading", "bulletList", "orderedList", "link", "image", "blockquote", "codeBlock"],
- *   maxCharacters: 50000,
- *   allowImages: true,
- * });
- *
- * // Minimal editor
- * const bio = richTextField({
- *   label: "Bio",
- *   features: ["bold", "italic", "link"],
- *   maxCharacters: 500,
- * });
+ * // In collection fields callback:
+ * content: f.richText().required().localized()
  * ```
  */
-declare const richTextField: {
-  readonly type: "richText";
-  readonly _value: TipTapDocument;
-  readonly toColumn: (_name: string, config: RichTextFieldConfig) => any;
-  readonly toZodSchema: (config: RichTextFieldConfig) => any;
-  readonly getOperators: <TApp>() => ContextualOperators<questpie18984.OperatorMap, questpie18984.OperatorMap>;
-  readonly getMetadata: (config: RichTextFieldConfig) => FieldMetadataBase & {
-    maxCharacters?: number;
-    minCharacters?: number;
-    features: RichTextFeature[];
-    headingLevels: (1 | 2 | 3 | 4 | 5 | 6)[];
-    placeholder?: string;
-    allowImages?: boolean;
-    imageCollection?: string;
-  };
+type RichTextFieldState = DefaultFieldState & {
+  type: "richText";
+  data: TipTapDocument;
+  column: PgJsonbBuilder;
 };
+declare function richText(): Field<RichTextFieldState>;
 //#endregion
-export { RichTextFeature, RichTextFieldConfig, RichTextFieldMeta, TipTapDocument, TipTapNode, richTextField };
-//# sourceMappingURL=rich-text.d.mts.map
+export { RichTextFeature, RichTextFieldMeta, RichTextFieldState, TipTapDocument, TipTapNode, richText };