@vexcms/core 0.0.20 → 0.1.0-alpha.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fields/date/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,WAAW,cAAc,CAC7B,UAAU,SAAS,EAAE,GAAG,EAAE,CAC1B,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE;QACL;;;;WAIG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB;;;;WAIG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B;;;WAGG;QACH,UAAU,CAAC,EAAE;YACX,+CAA+C;YAC/C,IAAI,EAAE,OAAO,CAAC;YACd,iDAAiD;YACjD,MAAM,EAAE,OAAO,CAAC;YAChB,mDAAmD;YACnD,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,CAAE,SAAQ,SAAS,CAAC,UAAU,CAAC;IAClF,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7C,uGAAuG;IACvG,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,gBAAgB,CAAC;IACxB,qGAAqG;IACrG,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,EAAE;QACJ,yFAAyF;QACzF,MAAM,EAAE,OAAO,CAAC;QAChB,8FAA8F;QAC9F,eAAe,EAAE,OAAO,CAAC;QACzB,8DAA8D;QAC9D,UAAU,EAAE;YACV,0CAA0C;YAC1C,IAAI,EAAE,OAAO,CAAC;YACd,4CAA4C;YAC5C,MAAM,EAAE,OAAO,CAAC;YAChB,6CAA6C;YAC7C,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;KACH,CAAC;CACH"}

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

@@ -0,0 +1,34 @@
+import type { DateField } from "./types";
+/**
+ * Converts a date field definition to a Convex schema validator.
+ *
+ * Generates the appropriate `v.number()` or `v.optional(v.number())` code
+ * for the Convex schema based on the field's required property.
+ * Date values are stored as Unix timestamps in milliseconds.
+ *
+ * **Important notes:**
+ * - The `time` property is a UI concern only — it does NOT affect the schema type
+ * - The index property is handled separately by index collection logic
+ *
+ * This function is used by the CLI during schema generation to build
+ * the Convex schema file.
+ *
+ * @param props - dateFieldToValidator() input props
+ * @param props.field - The date field definition
+ * @returns Convex value type string: `"v.number()"` or `"v.optional(v.number())"`
+ *
+ * @example
+ * ```ts
+ * const field1 = date({ required: true })
+ * dateFieldToValidator({ field: field1 })  // "v.number()"
+ *
+ * const field2 = date({ required: false })
+ * dateFieldToValidator({ field: field2 })  // "v.optional(v.number())"
+ * ```
+ *
+ * @internal - Used by schema generation, not typically called by users
+ */
+export declare function dateFieldToValidator(props: {
+    field: DateField;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/fields/date/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,MAAM,CAKxE"}

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

@@ -0,0 +1,47 @@
+import { BaseFieldMeta } from "../types";
+import type { GroupFieldInput, GroupField } from "./types";
+/**
+ * Creates a group field with all defaults applied.
+ *
+ * Group fields store a named set of sub-fields as a single nested Convex
+ * `v.object({...})`. Each sub-field respects its own `required` setting —
+ * required sub-fields emit bare validators (e.g. `v.string()`); optional
+ * ones emit `v.optional(v.string())`.
+ *
+ * **Defaults applied:**
+ * - `label` — `""` (inferred from the field key by `defineCollection`)
+ * - `required` — `false`
+ * - `defaultValue` — `{}`
+ * - `admin.hidden` — `false`
+ * - `admin.readOnly` — `false`
+ * - `admin.position` — `"main"`
+ * - `admin.width` — `"full"`
+ * - `admin.cellAlignment` — `"left"`
+ *
+ * @param options - Group field configuration. `fields` is required; all other
+ *   properties are optional.
+ * @returns Resolved group field definition with all defaults applied.
+ *
+ * @example
+ * ```ts
+ * import { group, text, url } from "@vexcms/core"
+ *
+ * posts: defineCollection({
+ *   fields: {
+ *     seo: group({
+ *       label: "SEO",
+ *       fields: {
+ *         title:       text({ required: true }),
+ *         description: text(),
+ *         ogImage:     url(),
+ *       },
+ *     }),
+ *   },
+ * })
+ * ```
+ *
+ * @see {@link GroupFieldInput} for the full input type
+ * @see {@link GroupField} for the resolved output type
+ */
+export declare function group<TFieldMeta extends BaseFieldMeta = BaseFieldMeta>(options: GroupFieldInput<TFieldMeta>): GroupField<TFieldMeta>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/fields/group/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,KAAK,CAAC,UAAU,SAAS,aAAa,GAAG,aAAa,EACpE,OAAO,EAAE,eAAe,CAAC,UAAU,CAAC,GACnC,UAAU,CAAC,UAAU,CAAC,CA8BxB"}

package/dist/fields/group/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/group/index.d.ts.map

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

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

@@ -0,0 +1,27 @@
+import { ZodType } from "zod";
+import type { GroupField } from "./types";
+/**
+ * Builds a Zod schema for validating a group field value in the admin form.
+ *
+ * Constructs a `z.object({...})` where each key maps to the sub-field's own
+ * Zod schema via `adminFieldToInputSchema`. Sub-field defaults and optionality
+ * are handled recursively. The outer object receives `.optional()` when
+ * `field.required` is `false` via `applyBaseInputSchemaMeta`.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved group field definition.
+ * @returns A Zod object schema with a `.default({})` and optionality applied.
+ *
+ * @example
+ * ```ts
+ * const field = group({ fields: { title: text({ required: true }), body: text() } })
+ * groupFieldToInputSchema({ field })
+ * // → z.object({ title: z.string(), body: z.string().optional() }).optional().default({})
+ * ```
+ *
+ * @internal — Used by admin form schema construction via `adminFieldToInputSchema`.
+ */
+export declare function groupFieldToInputSchema<TFieldMeta extends {} = {}>(props: {
+    field: GroupField<TFieldMeta>;
+}): ZodType;
+//# sourceMappingURL=inputSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputSchema.d.ts","sourceRoot":"","sources":["../../../src/fields/group/inputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAGjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE;IACzE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;CAC/B,GAAG,OAAO,CAaV"}

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

@@ -0,0 +1,105 @@
+import { ADMIN_FIELDS } from "../constants";
+import { BaseField, BaseFieldInput, FieldAdminConfig } from "../baseTypes";
+import { AdminField } from "../types";
+/**
+ * Configuration input for a `group()` field.
+ *
+ * Group fields store a named set of sub-fields as a single nested object.
+ * All properties except `fields` are optional; unset properties fall back
+ * to the defaults applied by `group()`.
+ *
+ * **Defaults applied by `group()`:**
+ * ```ts
+ * {
+ *   type:        "group",
+ *   label:       "",      // inferred from the field key by defineCollection
+ *   required:    false,
+ *   defaultOpen: true,
+ *   defaultValue: {},
+ *   admin: {
+ *     hidden:        false,
+ *     readOnly:      false,
+ *     position:      "main",
+ *     width:         "full",
+ *     cellAlignment: "left",
+ *   }
+ * }
+ *
+ * @example
+ * ```ts
+ * seo: group({
+ *   label: "SEO",
+ *   fields: {
+ *     title:       text({ required: true }),
+ *     description: text(),
+ *   },
+ *   defaultOpen: false,  // accordion starts collapsed
+ * })
+ *
+ * @see {@link GroupField} for the resolved output type
+ * @see {@link group} for the config function that produces this type
+ */
+export interface GroupFieldInput<TFieldMeta extends {} = {}> extends BaseFieldInput<TFieldMeta> {
+    /**
+     * Sub-fields that form the object's shape.
+     *
+     * Accepts any `AdminField` value, including nested `group()` or `array()`.
+     * Each sub-field uses its own `required` setting for both Zod validation
+     * and Convex schema generation.
+     */
+    fields: Record<string, AdminField>;
+    /** Pre-filled value shown when creating a new document. Defaults to `{}`. */
+    defaultValue?: Record<string, unknown>;
+    /**
+     * Whether the accordion fieldset starts open in the admin form.
+     *
+     * Defaults to `true`. Set `false` for secondary or rarely-edited groups
+     * (e.g. SEO metadata on a page) to reduce visual noise on load.
+     */
+    defaultOpen?: boolean;
+    interfaceName?: string;
+}
+/**
+ * Resolved configuration for a `group()` field, after all defaults are applied.
+ *
+ * This is the type field input components and validator functions receive.
+ * `interfaceType` is a computed TypeScript object-type string built from the
+ * sub-fields (e.g. `"{ title: string; description?: string }"`), used by
+ * `generateVexTypes` to emit accurately-typed document interfaces.
+ *
+ * @see {@link GroupFieldInput} for the user-facing input type
+ * @see {@link group} for the config function that produces this type
+ */
+export interface GroupField<TFieldMeta extends {} = {}> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.group.type;
+    /** Display label shown in the admin form. Always set — inferred from field key if not provided. */
+    label: string;
+    /** Whether this field is required in the database schema. */
+    required: boolean;
+    /** Resolved admin UI configuration with all defaults applied. */
+    admin: FieldAdminConfig;
+    /**
+     * Sub-fields that form the object's shape.
+     *
+     * Each sub-field retains its own `required`, `label`, and admin settings.
+     * Convex and Zod validators are generated per-field respecting those settings.
+     */
+    fields: Record<string, AdminField>;
+    /**
+     * Computed TypeScript object-type string for `generateVexTypes`.
+     *
+     * Built from sub-fields in `group()` — e.g. `"{ title: string; description?: string }"`.
+     * Automatically reflects nested groups or arrays within the sub-fields.
+     */
+    interfaceType: string;
+    interfaceName?: string;
+    /** Pre-filled value shown when creating a new document. */
+    defaultValue: Record<string, unknown>;
+    /**
+     * Whether the accordion fieldset starts open in the admin form.
+     *
+     * Resolved value after defaults — always `true` unless explicitly set `false`.
+     */
+    defaultOpen: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fields/group/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,MAAM,UAAU,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,eAAe,CAC9B,UAAU,SAAS,EAAE,GAAG,EAAE,CAC1B,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClC;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU,CACzB,UAAU,SAAS,EAAE,GAAG,EAAE,CAC1B,SAAQ,SAAS,CAAC,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9C,mGAAmG;IACnG,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB"}

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

@@ -0,0 +1,41 @@
+import type { GroupField } from "./types";
+/**
+ * Converts a group field definition to a Convex schema validator string.
+ *
+ * Generates `v.object({ key: validator, ... })` where each sub-field's
+ * validator is built by the existing `adminFieldToValidator` dispatch.
+ * Sub-fields respect their own `required` setting — required sub-fields
+ * emit bare validators; optional ones emit `v.optional(...)`.
+ *
+ * The outer object is wrapped in `v.optional(...)` when `field.required`
+ * is `false`.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved group field definition.
+ * @returns A Convex validator string.
+ *
+ * @example
+ * ```ts
+ * const field = group({
+ *   fields: { title: text({ required: true }), body: text() },
+ * })
+ * groupFieldToValidator({ field })
+ * // → 'v.optional(v.object({ title: v.string(), body: v.optional(v.string()) }))'
+ * ```
+ *
+ * @example
+ * ```ts
+ * const field = group({
+ *   required: true,
+ *   fields: { score: number({ required: true }) },
+ * })
+ * groupFieldToValidator({ field })
+ * // → 'v.object({ score: v.number() })'
+ * ```
+ *
+ * @internal — Used by CLI schema generation via `adminFieldToValidator`.
+ */
+export declare function groupFieldToValidator<TFieldMeta extends {} = {}>(props: {
+    field: GroupField<TFieldMeta>;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/fields/group/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE;IACvE,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;CAC/B,GAAG,MAAM,CAcT"}

package/dist/fields/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./constants";
+export * from "./baseTypes";
+export * from "./types";
+export * from "./validators";
+export * from "./inputSchemas";
+export * from "./interfaceGen";
+export * from "./utils";
+export * from "./text";
+export * from "./select";
+export * from "./relationship";
+export * from "./number";
+export * from "./checkbox";
+export * from "./date";
+export * from "./url";
+export * from "./color";
+export * from "./array";
+export * from "./group";
+export * from "./blocks";
+export * from "./upload";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AAExB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,23 @@
+import { AdminField } from "../types";
+/**
+ * Converts any field definition to its form input schema using zod.
+ *
+ * Dispatches to the field-type-specific input schema function based on `field.type`.
+ * Used by the admin panel while form rendering to build the form input for individual fields, collections, blocks, and globals.
+ *
+ * @param props Input props
+ * @param props.field - The resolved field definition to convert
+ * @returns A ZodType (e.g. `z.string()`, `z.boolean().optional().default(false)`)
+ * @throws An Error if an unrecognized field type is given. Reaching this is a
+ * compile error: the default arm binds the exhausted union to `never`, so a new
+ * member of `AdminField` fails typecheck here until a case is added
+ *
+ * @see {@link textFieldToInputSchema} for the text field implementation
+ * @see {@link numberFieldToInputSchema} for the number field implementation
+ * @see {@link checkboxFieldToInputSchema} for the checkbox field implementation
+ * @internal
+ */
+export declare function adminFieldToInputSchema(props: {
+    field: AdminField;
+}): import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fields/inputSchemas/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AActC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,sGAqCnE"}

package/dist/fields/inputSchemas/utils.d.ts

@@ -0,0 +1,25 @@
+import type { ZodType } from "zod";
+import type { AdminField } from "../types";
+/**
+ * Attaches field metadata and wraps in `.optional()` for non-required fields.
+ *
+ * Used during form schema generation to apply the correct Zod validator based on
+ * whether the field is marked as required in its config.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved field definition, used to check `required` and `defaultValue`
+ * @param props.inputSchema - The base Zod schema for the field (e.g. `z.string()`)
+ * @returns The schema with `.meta(fieldMeta)` for required fields, or `.meta(fieldMeta).optional()` for non-required fields. No `.default()` is applied — each field's own schema is responsible for baking in a default value.
+ *
+ * @example
+ * ```ts
+ * applyBaseInputSchemaMeta({ field: textField, inputSchema: z.string() })
+ * // required field  → z.string().meta({ label, description })
+ * // optional field  → z.string().meta({ label, description }).optional()
+ * ```
+ */
+export declare function applyBaseInputSchemaMeta(props: {
+    field: AdminField;
+    inputSchema: ZodType;
+}): ZodType;
+//# sourceMappingURL=utils.d.ts.map

package/dist/fields/inputSchemas/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/fields/inputSchemas/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAWV"}

package/dist/fields/interfaceGen.d.ts

@@ -0,0 +1,15 @@
+import { CollectionConfig } from "../types";
+/**
+ * Recursively collects `export type` declarations for every group field that
+ * carries an `interfaceName`, at any depth in the field tree.
+ *
+ * Traversal is depth-first so nested named types are always declared before
+ * the parent types that reference them. Both direct group sub-fields and
+ * group items inside array fields are visited.
+ *
+ * @param fields - The field map to walk (collection-level or group sub-fields).
+ * @returns Ordered list of `export type Name = ...` strings, ready to prepend
+ *   to the generated interface block.
+ */
+export declare function getFieldInterfaces(fields: CollectionConfig["fields"]): string[];
+//# sourceMappingURL=interfaceGen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaceGen.d.ts","sourceRoot":"","sources":["../../src/fields/interfaceGen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE,CAuC/E"}

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

@@ -0,0 +1,48 @@
+import type { NumberFieldInput, NumberField } from "./types";
+/**
+ * Creates a number field with all defaults applied.
+ *
+ * Number fields store numeric values.
+ * Common uses: prices, quantities, ratings, ages, counts.
+ *
+ * Accepts {@link NumberFieldInput} (all optional) and returns {@link NumberField} with all defaults applied.
+ *
+ * **Defaults applied:**
+ * - `label` — `""` (inferred from the field key by `defineCollection`)
+ * - `required` — `false`
+ * - `admin.hidden` — `false`
+ * - `admin.readOnly` — `false`
+ * - `admin.position` — `"main"`
+ * - `admin.width` — `"full"`
+ * - `admin.cellAlignment` — `"left"`
+ *
+ * @param options - Number field configuration. All properties are optional.
+ * @returns Resolved number field definition with all defaults applied.
+ *
+ * @example
+ * ```ts
+ * import { number, defineCollection } from '@vexcms/core'
+ *
+ * products: defineCollection({
+ *   fields: {
+ *     // Minimal — label inferred from key ("Price")
+ *     price: number(),
+ *
+ *     // Required quantity with a minimum of 1 and a database index
+ *     quantity: number({ required: true, min: { value: 1 }, index: "by_quantity" }),
+ *
+ *     // Rating capped between 0 and 5
+ *     rating: number({
+ *       min: { value: 0, error: "Rating cannot be negative" },
+ *       max: { value: 5, error: "Rating cannot exceed 5" },
+ *       admin: { width: "half" },
+ *     }),
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link NumberFieldInput} for the full input type
+ * @see {@link NumberField} for the resolved output type
+ */
+export declare function number<TFieldMeta extends {} = {}>(options?: NumberFieldInput<TFieldMeta>): NumberField<TFieldMeta>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/fields/number/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,MAAM,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,EAC/C,OAAO,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACrC,WAAW,CAAC,UAAU,CAAC,CAgCzB"}

package/dist/fields/number/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/number/index.d.ts.map

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

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

@@ -0,0 +1,23 @@
+import { ZodType } from "zod";
+import { NumberField } from "./types";
+/**
+ * Builds a Zod schema for validating a number field value in the admin form.
+ *
+ * Applies `min` and `max` constraints when configured, then wraps in
+ * `.optional()` for non-required fields via `applyBaseInputSchemaMeta`.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved number field definition
+ * @returns A Zod number schema with range constraints, a baked-in `.default(field.defaultValue)`, and optionality applied
+ *
+ * @example
+ * ```ts
+ * const field = number({ required: true, min: { value: 0 }, max: { value: 100 } })
+ * numberFieldToInputSchema({ field })
+ * // → z.number().min(0).max(100).default(0)
+ * ```
+ */
+export declare function numberFieldToInputSchema(props: {
+    field: NumberField;
+}): ZodType;
+//# sourceMappingURL=inputSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputSchema.d.ts","sourceRoot":"","sources":["../../../src/fields/number/inputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,WAAW,CAAC;CACpB,GAAG,OAAO,CAuCV"}

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

@@ -0,0 +1,100 @@
+import { ADMIN_FIELDS } from "../constants";
+import { BaseField, BaseFieldInput, FieldAdminConfig } from "../baseTypes";
+/**
+ * Configuration input for a `number()` field.
+ *
+ * Number fields store numeric values — prices, quantities, ratings, ages, counts, etc.
+ * All properties are optional; unset properties fall back to the defaults listed below.
+ *
+ * **Defaults applied by `number()`:**
+ * ```ts
+ * {
+ *   type:     "number",
+ *   label:    "",       // inferred from the field key by defineCollection
+ *   required: false,    // field is optional by default
+ *   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",  // value aligned left in the data table column
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Minimal — label is inferred from the key ("Price")
+ * price: number()
+ *
+ * // Required quantity with a minimum of 1 and a database index
+ * quantity: number({ required: true, min: { value: 1 }, index: "by_quantity" })
+ *
+ * // Rating capped between 0 and 5 with custom error messages
+ * rating: number({
+ *   min: { value: 0, error: "Rating cannot be negative" },
+ *   max: { value: 5, error: "Rating cannot exceed 5" },
+ *   admin: { width: "half" },
+ * })
+ *
+ * // Pre-filled default for a score field
+ * score: number({ defaultValue: 100 })
+ * ```
+ *
+ * @see {@link NumberField} for the resolved type after defaults are applied
+ * @see {@link number} for the config function that applies defaults
+ * @see {@link BaseFieldInput} for shared properties (`label`, `description`, `required`, `admin`, `index`, `searchIndex`)
+ */
+export interface NumberFieldInput<TFieldMeta extends {} = {}> extends BaseFieldInput<TFieldMeta> {
+    /**
+     * Pre-filled value shown in the admin form when creating a new document.
+     * Does not affect database values — only the form's initial state.
+     */
+    defaultValue?: number;
+    /** Minimum allowed numeric value config. */
+    min?: {
+        /** Minimum allowed numeric value. */
+        value: number;
+        /** Error message shown when the value is below the minimum. */
+        error?: string;
+    };
+    /** Maximum allowed numeric value config. */
+    max?: {
+        /** Maximum allowed numeric value. */
+        value: number;
+        /** Error message shown when the value exceeds the maximum. */
+        error?: string;
+    };
+}
+/**
+ * Resolved configuration for a `number()` field, after all defaults are applied.
+ *
+ * @see {@link NumberFieldInput} for the user-facing input type
+ * @see {@link number} for the config function that produces this type
+ */
+export interface NumberField<TFieldMeta extends {} = {}> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.number.type;
+    /** 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;
+    /** Resolved admin UI configuration with all defaults applied. */
+    admin: FieldAdminConfig;
+    /** Pre-filled numeric value shown in the admin form when creating a new document. */
+    defaultValue: number;
+    /** Minimum allowed numeric value config. */
+    min?: {
+        /** Minimum allowed numeric value. */
+        value: number;
+        /** Error message shown when the value is below the minimum. */
+        error?: string;
+    };
+    /** Maximum allowed numeric value config. */
+    max?: {
+        /** Maximum allowed numeric value. */
+        value: number;
+        /** Error message shown when the value exceeds the maximum. */
+        error?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fields/number/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,WAAW,gBAAgB,CAC/B,UAAU,SAAS,EAAE,GAAG,EAAE,CAC1B,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,GAAG,CAAC,EAAE;QACJ,qCAAqC;QACrC,KAAK,EAAE,MAAM,CAAC;QACd,+DAA+D;QAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,4CAA4C;IAC5C,GAAG,CAAC,EAAE;QACJ,qCAAqC;QACrC,KAAK,EAAE,MAAM,CAAC;QACd,8DAA8D;QAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,CAAE,SAAQ,SAAS,CAAC,UAAU,CAAC;IACpF,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;IAC/C,uGAAuG;IACvG,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,KAAK,EAAE,gBAAgB,CAAC;IACxB,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,GAAG,CAAC,EAAE;QACJ,qCAAqC;QACrC,KAAK,EAAE,MAAM,CAAC;QACd,+DAA+D;QAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,4CAA4C;IAC5C,GAAG,CAAC,EAAE;QACJ,qCAAqC;QACrC,KAAK,EAAE,MAAM,CAAC;QACd,8DAA8D;QAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}

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

@@ -0,0 +1,39 @@
+import type { NumberField } from "./types";
+/**
+ * Converts a number field definition to a Convex schema validator.
+ *
+ * Generates the appropriate v.number() or v.optional(v.number()) code
+ * for the Convex schema based on the field's required property.
+ *
+ * **Important notes:**
+ * - min/max are runtime validation constraints, NOT schema constraints
+ * - They don't affect the generated Convex value type
+ * - Validation happens in the admin panel and mutation handlers
+ * - The index property is handled separately by index collection logic
+ *
+ * This function is used by the CLI during schema generation to build
+ * the Convex schema file.
+ *
+ * @param props - numberFieldToValidator() input props
+ * @param props.field - The number field definition
+ * @returns Convex value type string: "v.number()" or "v.optional(v.number())"
+ *
+ * @example
+ * ```ts
+ * const field1 = number({ required: true })
+ * numberFieldToValidator({ field: field1 })  // "v.number()"
+ *
+ * const field2 = number({ required: false })
+ * numberFieldToValidator({ field: field2 })  // "v.optional(v.number())"
+ *
+ * const field3 = number({ min: { value: 0 }, max: { value: 100 } })
+ * numberFieldToValidator({ field: field3 })  // "v.optional(v.number())"
+ * // Note: Range constraints don't affect schema, handled at validation layer
+ * ```
+ *
+ * @internal - Used by schema generation, not typically called by users
+ */
+export declare function numberFieldToValidator(props: {
+    field: NumberField;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/fields/number/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG,MAAM,CAK5E"}