@vexcms/core 0.0.20 → 0.1.0-alpha.3

package/dist/fields/array/types.d.ts

@@ -0,0 +1,127 @@
+import { ADMIN_FIELDS } from "../constants";
+import { BaseField, BaseFieldInput, FieldAdminConfig } from "../baseTypes";
+import { AdminField, BaseFieldMeta } from "../types";
+/**
+ * Union of all types allowed as array item values.
+ *
+ * Supports the four JSON-compatible scalar types plus nested objects.
+ * Nested arrays are created by passing `array({ items: array({ items: ... }) })`.
+ */
+export type ArrayType = string | number | boolean | object;
+/**
+ * Configuration input for an `array()` field.
+ *
+ * Array fields store ordered lists of values — strings, numbers, booleans,
+ * or nested objects. The `items` property defines the type of each element
+ * using any VexCMS field builder (including nested `array()` for multi-dimensional
+ * arrays). All properties are optional; unset properties fall back to the
+ * defaults listed below.
+ *
+ * **Defaults applied by `array()`:**
+ * ```ts
+ * {
+ *   type:            "array",
+ *   label:           "",       // inferred from the field key by defineCollection
+ *   labels:          { singular: "Item", plural: "Items" },
+ *   required:        false,    // field is optional by default
+ *   defaultValue:    [],       // empty array shown in admin form
+ *   admin: {
+ *     hidden:        false,   // visible in the admin form
+ *     readOnly:      false,   // editable by default
+ *     position:      "main",  // placed in the main content column, not the sidebar
+ *     width:         "full",  // spans the full form width, not half
+ *     cellAlignment: "left",  // item count aligned left in the data table column
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // String tags — label inferred from key ("Tags")
+ * tags: array({ items: text() })
+ *
+ * // Required number array with max length
+ * scores: array({ required: true, items: number(), max: { value: 10 } })
+ *
+ * // Nested array — array of arrays of numbers (2D matrix)
+ * matrix: array({ items: array({ items: number() }) })
+ *
+ * // Object items — each item is a structured sub-document
+ * links: array({
+ *   items: object({
+ *     label: text(),
+ *     href: url(),
+ *   }),
+ * })
+ * ```
+ *
+ * @see {@link BaseFieldInput} for shared properties (`label`, `description`, `required`, `admin`, `index`, `searchIndex`)
+ */
+export interface ArrayFieldInput<TArrayType extends ArrayType = string, TFieldMeta extends {} = {}> extends BaseFieldInput<TFieldMeta> {
+    labels?: {
+        singular: string;
+        plural: string;
+    };
+    /**
+     * Pre-filled value shown in the admin form when creating a new field.
+     * Does not apply to database values
+     *
+     */
+    defaultValue?: TArrayType[];
+    items: AdminField;
+    /** Minimum array length config. */
+    min?: {
+        /** Minimum array length. */
+        value: number;
+        /** Minimum array length error message. */
+        error?: string;
+    };
+    /** Maximum array length config. */
+    max?: {
+        /** Maximum array length. */
+        value: number;
+        /** Maximum array length error message. */
+        error?: string;
+    };
+}
+/**
+ * Resolved configuration for an `array()` field, after all defaults are applied.
+ *
+ * This is the type that framework adapters and field components receive —
+ * `fieldDef` in `InputComponentProps<ArrayField<ArrayType>>` and
+ * `CellComponentProps<ArrayField<ArrayType>>` is this type.
+ *
+ * @see {@link ArrayFieldInput} for the user-facing input type
+ * @see {@link array} for the config function that produces this type
+ */
+export interface ArrayField<TArrayType extends ArrayType = string, TFieldMeta extends BaseFieldMeta = BaseFieldMeta> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.array.type;
+    /** Display label shown in the admin form. Always set — inferred from the field key if not provided. */
+    label: string;
+    labels: {
+        singular: string;
+        plural: string;
+    };
+    /** Whether this field is required in the database schema. */
+    required: boolean;
+    /** Resolved admin UI configuration with all defaults applied. */
+    admin: FieldAdminConfig;
+    /** Pre-filled value shown in the admin form when creating a new field. */
+    defaultValue: TArrayType[];
+    items: AdminField;
+    /** Minimum allowed array length config. */
+    min?: {
+        /** Minimum allowed array length. */
+        value: number;
+        /** Minimum allowed array length error message. */
+        error?: string;
+    };
+    /** Maximum allowed array length config. */
+    max?: {
+        /** Maximum allowed array length. */
+        value: number;
+        /** Maximum allowed array length error message. */
+        error?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/fields/array/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fields/array/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAErD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,WAAW,eAAe,CAC9B,UAAU,SAAS,SAAS,GAAG,MAAM,EACrC,UAAU,SAAS,EAAE,GAAG,EAAE,CAC1B,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClC,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;;;OAIG;IACH,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,mCAAmC;IACnC,GAAG,CAAC,EAAE;QACJ,4BAA4B;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,0CAA0C;QAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,mCAAmC;IACnC,GAAG,CAAC,EAAE;QACJ,4BAA4B;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,0CAA0C;QAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU,CACzB,UAAU,SAAS,SAAS,GAAG,MAAM,EACrC,UAAU,SAAS,aAAa,GAAG,aAAa,CAChD,SAAQ,SAAS,CAAC,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9C,uGAAuG;IACvG,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,gBAAgB,CAAC;IACxB,0EAA0E;IAC1E,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,2CAA2C;IAC3C,GAAG,CAAC,EAAE;QACJ,oCAAoC;QACpC,KAAK,EAAE,MAAM,CAAC;QACd,kDAAkD;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,2CAA2C;IAC3C,GAAG,CAAC,EAAE;QACJ,oCAAoC;QACpC,KAAK,EAAE,MAAM,CAAC;QACd,kDAAkD;QAClD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}

package/dist/fields/array/validator.d.ts

@@ -0,0 +1,30 @@
+import type { ArrayField, ArrayType } from "./types";
+/**
+ * Converts an array field definition to a Convex schema validator.
+ *
+ * Generates `v.array(itemValidator)` wrapped in `v.optional(…)` if the field
+ * is not required. The item validator is derived from the nested `field.items`
+ * field definition using `adminFieldToValidator`.
+ *
+ * @param props - Input props
+ * @param props.field - The array field definition
+ * @returns Convex value type string: `"v.array(v.string())"` or `"v.optional(v.array(v.string()))"`
+ *
+ * @example
+ * ```ts
+ * const field1 = array({ items: text(), required: true })
+ * arrayFieldToValidator({ field: field1 })  // "v.array(v.string())"
+ *
+ * const field2 = array({ items: number(), required: false })
+ * arrayFieldToValidator({ field: field2 })  // "v.optional(v.array(v.number()))"
+ *
+ * const field3 = array({ items: array({ items: number() }) })
+ * arrayFieldToValidator({ field: field3 })  // "v.array(v.array(v.number()))"
+ * ```
+ *
+ * @internal - Used by CLI schema generation
+ */
+export declare function arrayFieldToValidator<TArrayType extends ArrayType = ArrayType, TFieldMeta extends {} = {}>(props: {
+    field: ArrayField<TArrayType, TFieldMeta>;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/fields/array/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/fields/array/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,UAAU,SAAS,EAAE,GAAG,EAAE,EAC1B,KAAK,EAAE;IAAE,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;CAAE,GAAG,MAAM,CAM9D"}

package/dist/fields/baseTypes.d.ts

@@ -0,0 +1,251 @@
+/**
+ * Content alignment for data table cells.
+ */
+export type Alignment = "left" | "right" | "center";
+/**
+ * Labels for items saved in numbers, collections, blocks, etc
+ */
+export type Labels = {
+    singular: string;
+    plural: string;
+};
+/**
+ * Higher-kinded type interface for framework-specific component constructors.
+ *
+ * Frameworks implement this to map a props type to their component type.
+ *
+ * @example
+ * ```ts
+ * interface ReactHKT extends ComponentHKT {
+ *   component: React.ComponentType<this['_props']>;
+ * }
+ * ```
+ */
+export interface ComponentHKT {
+    readonly _props: unknown;
+    readonly _extra: Record<string, unknown>;
+    readonly component: unknown;
+}
+/**
+ * Applies a ComponentHKT to specific props, resolving to the framework's component type.
+ */
+export type ApplyComponent<F extends ComponentHKT, P, E extends Record<string, unknown> = Record<string, never>> = (F & {
+    readonly _props: P;
+    readonly _extra: E;
+})["component"];
+/**
+ * Opaque runtime shape stored in the field config for a custom component.
+ * Created via a framework-specific factory (e.g. `fieldComponent()` in `@vex/react`).
+ */
+export type ComponentEntry = {
+    component: (props: any) => unknown;
+    props: Record<string, unknown>;
+};
+/**
+ * Configuration input for a field's admin panel behavior.
+ *
+ * Controls how the field appears and behaves in the admin UI — visibility,
+ * layout, input styling, and data table presentation. All properties are
+ * optional; unset properties fall back to the defaults listed below.
+ *
+ * **Defaults applied by field config functions** (e.g., `text()`, `number()`):
+ * ```ts
+ * {
+ *   hidden:        false,   // field is visible in the admin form
+ *   readOnly:      false,   // field is editable by default
+ *   position:      "main",  // placed in the main content column, not the sidebar
+ *   width:         "full",  // spans the full form width, not half
+ *   cellAlignment: "left",  // text aligned left in data table cells
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Basic usage — all defaults applied
+ * title: text({ admin: { width: "half" } })
+ *
+ * // Sidebar metadata field
+ * publishedAt: date({
+ *   description: "Scheduled publish time",
+ *   admin: { position: "sidebar" },
+ * })
+ *
+ * // Read-only computed field
+ * createdAt: date({
+ *   required: true,
+ *   admin: { readOnly: true, hidden: false }
+ * })
+ *
+ * // Right-aligned number column in table
+ * price: number({
+ *   admin: {
+ *     cellAlignment: "right",
+ *     placeholder: "0.00"
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link FieldAdminConfig} for the resolved type after defaults are applied
+ */
+export interface FieldAdminConfigInput {
+    /**
+     * Hide this field from the admin form.
+     * Hidden fields are still stored in the database.
+     *
+     * Default: `false`
+     */
+    hidden?: boolean;
+    /**
+     * Make this field read-only in the admin form.
+     * The value is displayed but cannot be edited.
+     *
+     * Default: `false`
+     */
+    readOnly?: boolean;
+    /**
+     * Position of the field in the form layout.
+     *
+     * - `"main"` — placed in the main content area
+     * - `"sidebar"` — placed in the sidebar panel
+     *
+     * Default: `"main"`
+     */
+    position?: "main" | "sidebar";
+    /**
+     * Width of the field within its row.
+     *
+     * - `"full"` — spans the full width
+     * - `"half"` — spans half the width (two fields per row)
+     *
+     * Default: `"full"`
+     */
+    width?: "full" | "half";
+    /**
+     * Placeholder text shown in the input when empty.
+     */
+    placeholder?: string;
+    /**
+     * Content alignment in data table cells. 'left' | 'right' | 'center'
+     */
+    cellAlignment?: Alignment;
+}
+/**
+ * Resolved admin configuration for a field, returned after defaults are applied.
+ *
+ * Properties with defaults (`hidden`, `readOnly`, `position`, `width`, `cellAlignment`)
+ * are always present. Properties that are meaningless when absent (`placeholder`)
+ * remain optional — `undefined` means the user did not configure them.
+ *
+ * @see {@link FieldAdminConfigInput} for the user-facing input type
+ */
+export interface FieldAdminConfig {
+    /** Whether the field is hidden from the admin form. */
+    hidden: boolean;
+    /** Whether the field is read-only in the admin form. */
+    readOnly: boolean;
+    /** Position of the field in the form layout — `"main"` or `"sidebar"`. */
+    position: "main" | "sidebar";
+    /** Width of the field within its row — `"full"` or `"half"`. */
+    width: "full" | "half";
+    /** Text alignment for this field's column in the data table. */
+    cellAlignment: Alignment;
+    /** Placeholder text shown in the input when empty. */
+    placeholder?: string;
+}
+/**
+ * Properties shared by all field types.
+ *
+ * Every field type (text, number, checkbox, etc.) extends this interface
+ * with its own `type` discriminant and type-specific options. These base
+ * properties control labeling, validation, admin UI behavior, and database
+ * indexing.
+ *
+ * **Defaults applied by field config functions:**
+ * ```ts
+ * {
+ *   label:    "",     // inferred from the field key by defineCollection
+ *   required: false,  // field is optional in the database schema
+ *   admin:    { ... } // see FieldAdminConfigInput for admin defaults
+ * }
+ * ```
+ *
+ * @see {@link BaseField} for the resolved type after defaults are applied
+ */
+export interface BaseFieldInput<TFieldMeta extends {} = {}> {
+    /** Display label for the field in the admin form. */
+    label?: string;
+    /**
+     * Semantic description of the field. Used in three places:
+     * 1. Helper text rendered below the field input in the admin form UI.
+     * 2. As the Zod `.meta({ description })` value for form validation.
+     * 3. As the JSDoc comment on the generated document interface property.
+     *
+     * To write a separate JSDoc comment, use `interfaceDescription` in addition.
+     */
+    description?: string;
+    /** The JSDoc comment on the generated document interface property */
+    interfaceDescription?: string;
+    /**
+     * Whether this field is required.
+     *
+     * Default: `false`
+     */
+    required?: boolean;
+    /**
+     * Pre-filled value shown in the admin form when creating a new field.
+     * Does not apply to database values
+     */
+    defaultValue?: unknown;
+    /** Admin UI configuration for this field. */
+    admin?: FieldAdminConfigInput;
+    /**
+     * Create a database index on this field.
+     * The string value becomes the index name in Convex.
+     *
+     * @example
+     * ```ts
+     * slug: { type: "text", index: "by_slug", required: true }
+     * // Generates: .index("by_slug", ["slug"])
+     * ```
+     */
+    index?: string;
+    meta?: TFieldMeta;
+}
+/**
+ * Resolved base field definition, after defaults are applied by the field config function.
+ *
+ * Properties with defaults are always present. Properties that are meaningless
+ * when absent (`description`, `index`, `searchIndex`) remain optional.
+ *
+ * @see {@link BaseFieldInput} for the user-facing input type
+ */
+export interface BaseField<TFieldMeta extends {} = {}> {
+    /** Display label shown in the admin form. Always set — inferred from the field key if not provided. */
+    label: string;
+    /** Whether this field is required in the database schema. */
+    required: boolean;
+    /**
+     * Pre-filled value shown in the admin form when creating a new field.
+     * Does not apply to database values
+     */
+    defaultValue?: unknown;
+    /** Resolved admin UI configuration with all defaults applied. */
+    admin: FieldAdminConfig;
+    /**
+     * Semantic description of the field. Used in three places:
+     * 1. Helper text rendered below the field input in the admin form UI.
+     * 2. As the Zod `.meta({ description })` value for form validation.
+     * 3. As the JSDoc comment on the generated document interface property.
+     *
+     * To write a separate JSDoc comment, use `interfaceDescription` in addition.
+     */
+    description?: string;
+    /** The JSDoc comment on the generated document interface property */
+    interfaceDescription?: string;
+    /** Convex index name for this field. */
+    index?: string;
+    /** TypeScript type string written to generated document interfaces (e.g. `"string"`, `"number"`, `"string[]"`). */
+    interfaceType: string;
+    meta: TFieldMeta;
+}
+//# sourceMappingURL=baseTypes.d.ts.map

package/dist/fields/baseTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseTypes.d.ts","sourceRoot":"","sources":["../../src/fields/baseTypes.ts"],"names":[],"mappings":"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"}

package/dist/fields/blocks/config.d.ts

@@ -0,0 +1,63 @@
+import type { BlockConfigInput, BlockConfig, BlocksFieldInput, BlocksField } from "./types";
+import { BaseFieldMeta } from "../types";
+/**
+ * Defines a single block type for use in a `blocks()` field.
+ *
+ * Validates that the slug is a valid identifier and that no field name
+ * collides with framework-reserved names (`blockType`, `blockName`, `id`).
+ * Computes `interfaceType` — the TypeScript object-type string including
+ * all three framework keys plus user fields.
+ *
+ * @param options - Block definition. `slug`, `label`, and `fields` are required.
+ * @returns Resolved `BlockDef` with all defaults applied.
+ *
+ * @throws {Error} If `slug` does not match `/^[a-zA-Z][a-zA-Z0-9_-]*$/`.
+ * @throws {Error} If any field name is in `RESERVED_BLOCK_FIELD_NAMES`.
+ *
+ * @example
+ * ```ts
+ * const headingBlock = defineBlock({
+ *   slug:  "heading",
+ *   label: "Heading",
+ *   admin: { icon: "heading" },
+ *   fields: { text: text({ required: true }) },
+ * })
+ * ```
+ *
+ * @see {@link BlockConfigInput} for the full input type
+ * @see {@link BlockConfig} for the resolved output type
+ */
+export declare function defineBlock(options: BlockConfigInput): BlockConfig;
+/**
+ * Creates a blocks field with all defaults applied.
+ *
+ * Validates that all block slugs are unique within this field. Each item
+ * stored in Convex carries `blockType`, `blockName`, and `id` in addition
+ * to the block's own fields.
+ *
+ * @param options - Blocks field configuration. `blocks` is required.
+ * @returns Resolved blocks field definition.
+ *
+ * @throws {Error} If two or more block definitions share the same slug.
+ *
+ * @example
+ * ```ts
+ * const heading   = defineBlock({ slug: "heading",   label: "Heading",   fields: { text: text({ required: true }) } })
+ * const paragraph = defineBlock({ slug: "paragraph", label: "Paragraph", fields: { content: text({ required: true }) } })
+ *
+ * defineCollection({
+ *   fields: {
+ *     body: blocks({
+ *       label:  "Body",
+ *       blocks: [heading, paragraph],
+ *       labels: { singular: "section", plural: "sections" },
+ *     }),
+ *   },
+ * })
+ * ```
+ *
+ * @see {@link BlocksFieldInput} for the full input type
+ * @see {@link BlocksField} for the resolved output type
+ */
+export declare function blocks<TFieldMeta extends BaseFieldMeta = BaseFieldMeta>(options: BlocksFieldInput<TFieldMeta>): BlocksField<TFieldMeta>;
+//# sourceMappingURL=config.d.ts.map

package/dist/fields/blocks/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/fields/blocks/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG5F,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAgClE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CAAC,UAAU,SAAS,aAAa,GAAG,aAAa,EACrE,OAAO,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACpC,WAAW,CAAC,UAAU,CAAC,CAwCzB"}

package/dist/fields/blocks/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./config";
+export * from "./types";
+export * from "./validator";
+export * from "./inputSchema";
+//# sourceMappingURL=index.d.ts.map

package/dist/fields/blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fields/blocks/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/fields/blocks/inputSchema.d.ts

@@ -0,0 +1,22 @@
+import { ZodType } from "zod";
+import type { BlocksField } from "./types";
+/**
+ * Builds a Zod schema for validating a blocks field value in the admin form.
+ *
+ * Each block type becomes a `z.object()` with `blockType: z.literal(slug)`,
+ * `blockName: z.string().optional()`, and `id: z.string()` as framework
+ * keys, plus the block's own sub-field schemas from `adminFieldToInputSchema`.
+ * Multiple block types use `z.discriminatedUnion("blockType", [...])`. A single
+ * block type uses a plain `z.array(z.object(...))`. `min`/`max` are enforced on
+ * the outer array when set.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved blocks field definition.
+ * @returns A Zod array schema with discriminated-union items.
+ *
+ * @internal — Used by admin form schema construction via `adminFieldToInputSchema`.
+ */
+export declare function blocksFieldToInputSchema<TFieldMeta extends {} = {}>(props: {
+    field: BlocksField<TFieldMeta>;
+}): ZodType;
+//# sourceMappingURL=inputSchema.d.ts.map

package/dist/fields/blocks/inputSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputSchema.d.ts","sourceRoot":"","sources":["../../../src/fields/blocks/inputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE;IAC1E,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CAChC,GAAG,OAAO,CAqCV"}