@vexcms/core 0.0.20 → 0.1.0-alpha.3

package/dist/fields/color/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../../src/fields/color/formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;QAGtB,iFAAiF;;;;;QAKjF,oDAAoD;;;;;QAMpD,0DAA0D;;;;;QAM1D,kEAAkE;;;CAI5D,CAAC;AAEX,6FAA6F;AAC7F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEvF,gEAAgE;AAChE,eAAO,MAAM,qBAAqB,UAAqD,CAAC;AAExF,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,QAA8B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,29 @@
+import { type ZodType } from "zod";
+import { ColorField } from "./types";
+/**
+ * Builds a Zod schema for validating a colour field value in the admin form.
+ *
+ * Accepts hex, `rgb()`, `hsl()` and `oklch()` notation — plus `var(--token)`
+ * when the field enables `themeColors`. Required fields add a `.min(1)` check so
+ * an empty field reports "required" rather than a notation complaint. Optional
+ * fields accept the empty string, since `color()` defaults `defaultValue` to
+ * `""` and a cleared picker must round-trip.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved colour field definition.
+ * @returns A Zod string schema. Optional fields are wrapped in `.optional()` by
+ * `applyBaseInputSchemaMeta` and carry `.default(field.defaultValue)`.
+ *
+ * @example
+ * ```ts
+ * // Required — rejects "", "#fff" and "var(--primary)"
+ * colorFieldToInputSchema({ field: color({ required: true }) })
+ *
+ * // themeColors — additionally accepts "var(--primary)"
+ * colorFieldToInputSchema({ field: color({ required: true, themeColors: true }) })
+ * ```
+ */
+export declare function colorFieldToInputSchema(props: {
+    field: ColorField;
+}): ZodType;
+//# sourceMappingURL=inputSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputSchema.d.ts","sourceRoot":"","sources":["../../../src/fields/color/inputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkDrC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAkB7E"}

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

@@ -0,0 +1,100 @@
+import { ADMIN_FIELDS } from "../constants";
+import { BaseField, BaseFieldInput } from "../baseTypes";
+import type { ColorFormat } from "./formats";
+/**
+ * Configuration input for a `color()` field.
+ *
+ * Colour fields store a CSS colour string. `format` decides which notation the
+ * picker writes — `"hex"` (default), `"rgb"`, `"hsl"` or `"oklch"`. With
+ * `themeColors` the field may instead store a CSS custom-property reference,
+ * `var(--primary)`, which resolves per colour scheme at render time.
+ *
+ * **Defaults applied by `color()`:**
+ * ```ts
+ * {
+ *   type:        "color",
+ *   label:       "",       // inferred from the field key by defineCollection
+ *   required:    false,    // field is optional by default
+ *   format:      "hex",    // picker writes #RRGGBB / #RRGGBBAA
+ *   themeColors: false,    // picker shows the custom swatch only
+ *   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",  // swatch aligned left in the data table column
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Minimal — label inferred from the key ("Brand Color"), stored as hex
+ * brandColor: color()
+ *
+ * // Stored as oklch, ready to interpolate straight into a CSS custom property
+ * primaryLight: color({ format: "oklch", required: true, defaultValue: "oklch(65.7% 0.179 40.9)" })
+ *
+ * // Half-width, and offer the host app's design tokens as a second tab
+ * overlayTint: color({ themeColors: true, admin: { width: "half" } })
+ * ```
+ *
+ * @see {@link BaseFieldInput} for shared properties (`label`, `description`, `required`, `admin`, `index`, `searchIndex`)
+ */
+export interface ColorFieldInput<TFieldMeta extends {} = {}> extends BaseFieldInput<TFieldMeta> {
+    /**
+     * Pre-filled value shown in the admin form when creating a new document.
+     * Does not affect existing database values.
+     */
+    defaultValue?: string;
+    /**
+     * The CSS notation the picker writes.
+     *
+     * Validation is deliberately wider than this: every supported notation is
+     * accepted on save, so changing `format` never invalidates existing
+     * documents. `format` governs new writes, not stored history.
+     *
+     * Pick the notation the front end consumes. A theme collection feeding CSS
+     * custom properties should use `"oklch"` so values interpolate directly with
+     * no conversion step.
+     *
+     * @defaultValue `"hex"`
+     */
+    format?: ColorFormat;
+    /**
+     * When `true`, the picker gains a **Theme** tab listing the CSS custom
+     * properties declared by the host application's stylesheet, and selecting one
+     * stores a `var(--token)` reference instead of a literal colour.
+     *
+     * The admin panel renders inside the host app, so those tokens are the site's
+     * own tokens. Leave this `false` on the fields that *define* the tokens: a
+     * field whose value is written back out as `--primary: var(--primary)` is a
+     * custom-property cycle, which CSS discards at computed-value time.
+     *
+     * @defaultValue `false`
+     */
+    themeColors?: boolean;
+}
+/**
+ * Resolved configuration for a `color()` field, after all defaults are applied.
+ *
+ * This is the type framework adapters and field components receive —
+ * `fieldDef` in `InputComponentProps<ColorField>` and
+ * `CellComponentProps<ColorField>` is this type.
+ *
+ * @see {@link ColorFieldInput} for the user-facing input type
+ * @see {@link color} for the config function that produces this type
+ */
+export interface ColorField<TFieldMeta extends {} = {}> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.color.type;
+    /**
+     * Pre-filled value shown in the admin form when creating a new document.
+     * Defaults to `""` — an empty picker.
+     */
+    defaultValue?: string;
+    /** The CSS notation the picker writes. */
+    format: ColorFormat;
+    /** Whether the picker offers the host app's design tokens as a second tab. */
+    themeColors: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fields/color/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,eAAe,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,CACzD,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU,CAAC,UAAU,SAAS,EAAE,GAAG,EAAE,CACpD,SAAQ,SAAS,CAAC,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;IAC9C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,MAAM,EAAE,WAAW,CAAC;IACpB,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;CACtB"}

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

@@ -0,0 +1,100 @@
+/**
+ * Theme field key → CSS custom property, for the 32 shadcn design tokens.
+ *
+ * This map is the theming system's contract. `themeColorFields` derives the
+ * collection's colour fields from it, and `buildThemeCss` emits one declaration
+ * per entry — so a token cannot exist in the stored document without also being
+ * applied, or vice versa. The names are exactly the custom properties shadcn
+ * components consume and exactly the set tweakcn exports, so a preset maps
+ * across with no gaps.
+ */
+export declare const THEME_COLOR_TOKENS: {
+    readonly background: "--background";
+    readonly foreground: "--foreground";
+    readonly card: "--card";
+    readonly cardForeground: "--card-foreground";
+    readonly popover: "--popover";
+    readonly popoverForeground: "--popover-foreground";
+    readonly primary: "--primary";
+    readonly primaryForeground: "--primary-foreground";
+    readonly secondary: "--secondary";
+    readonly secondaryForeground: "--secondary-foreground";
+    readonly muted: "--muted";
+    readonly mutedForeground: "--muted-foreground";
+    readonly accent: "--accent";
+    readonly accentForeground: "--accent-foreground";
+    readonly destructive: "--destructive";
+    readonly destructiveForeground: "--destructive-foreground";
+    readonly border: "--border";
+    readonly input: "--input";
+    readonly ring: "--ring";
+    readonly chart1: "--chart-1";
+    readonly chart2: "--chart-2";
+    readonly chart3: "--chart-3";
+    readonly chart4: "--chart-4";
+    readonly chart5: "--chart-5";
+    readonly sidebar: "--sidebar";
+    readonly sidebarForeground: "--sidebar-foreground";
+    readonly sidebarPrimary: "--sidebar-primary";
+    readonly sidebarPrimaryForeground: "--sidebar-primary-foreground";
+    readonly sidebarAccent: "--sidebar-accent";
+    readonly sidebarAccentForeground: "--sidebar-accent-foreground";
+    readonly sidebarBorder: "--sidebar-border";
+    readonly sidebarRing: "--sidebar-ring";
+};
+/** One of the 32 shadcn colour-token keys, camelCased: `"cardForeground"`, `"chart1"`. */
+export type ThemeColorTokenKey = keyof typeof THEME_COLOR_TOKENS;
+/**
+ * Scheme-independent fields, read from the theme document root.
+ *
+ * `--font-sans` is commonly also set by the host's font loader (e.g.
+ * `next/font`) as a class on `<html>`; both are specificity (0,1,0), so the
+ * later declaration wins. A stack naming a font the app has not loaded degrades
+ * to the next entry rather than breaking.
+ */
+export declare const THEME_SHARED_TOKENS: {
+    readonly radius: "--radius";
+    readonly fontFamily: "--font-sans";
+};
+/** Where a theme's CSS applies. */
+export type ThemeScope = "admin" | "site";
+/**
+ * Stark × Ember — this repo's house palette, lifted verbatim from the `:root`
+ * block of `globals.css`. A freshly created theme starts from these values, so
+ * "new theme" means "fork the current look", not "32 empty pickers".
+ */
+export declare const EMBER_LIGHT: Record<ThemeColorTokenKey, string>;
+/** Stark × Ember dark-mode values, from `globals.css`'s `.dark` block. */
+export declare const EMBER_DARK: Record<ThemeColorTokenKey, string>;
+/**
+ * Builds the stylesheet text applying a theme document at a scope.
+ *
+ * Values are written through verbatim — a `color()` field storing
+ * `oklch(60.5% 0.175 42)` needs no conversion, because custom properties accept
+ * any colour notation. `.dark` is assumed to sit on `<html>`, which *is*
+ * `:root`, so the dark selector is a compound, never a descendant.
+ *
+ * The two scopes form a specificity ladder that no injection order can upset:
+ * site light `:root` (0,1,0) < site dark `.dark` (0,1,0, later) < admin light
+ * `:root:root` (0,2,0) < admin dark `.dark:root:root` (0,3,0). Emit the site
+ * theme once for the whole document and the admin theme from the admin route
+ * only, and the admin block wins exactly where it renders.
+ *
+ * @param props - Input props.
+ * @param props.theme - The theme document — `light`/`dark` colour groups plus
+ * root-level `radius` and `fontFamily`, i.e. the shape `themeColorFields`
+ * stores.
+ * @param props.scope - `"site"` emits `:root`; `"admin"` emits `:root:root`.
+ * @returns The stylesheet text, or `""` when the theme sets nothing.
+ *
+ * @example
+ * ```ts
+ * const css = buildThemeCss({ theme, scope: "site" });
+ * // ":root {\n  --background: oklch(96.1% 0 0);\n  …\n}\n\n.dark {\n  …\n}"
+ * ```
+ */
+export declare function buildThemeCss(props: {
+    theme: Record<string, unknown>;
+    scope: ThemeScope;
+}): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/fields/color/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCrB,CAAC;AAEX,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,mCAAmC;AACnC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAiC1D,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAiCzD,CAAC;AAuBF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,MAAM,CAqBT"}

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

@@ -0,0 +1,27 @@
+import type { ColorField } from "./types";
+/**
+ * Converts a colour field definition to a Convex schema validator string.
+ *
+ * Colour fields are stored as plain strings in Convex — the notation (and the
+ * `var(--token)` alternative allowed by `themeColors`) is enforced at the admin
+ * form layer, not in the database schema. This function generates only the type
+ * constraint, so changing `format` never triggers a schema migration.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved colour field definition.
+ * @returns Convex validator string: `"v.string()"` for required fields,
+ * `"v.optional(v.string())"` for optional fields.
+ *
+ * @example
+ * ```ts
+ * colorFieldToValidator({ field: color({ required: true }) })   // "v.string()"
+ * colorFieldToValidator({ field: color({ required: false }) })  // "v.optional(v.string())"
+ * ```
+ *
+ * @see {@link colorFieldToInputSchema} for the admin-form Zod schema that enforces the notation
+ * @internal Used by schema generation, not typically called directly.
+ */
+export declare function colorFieldToValidator(props: {
+    field: ColorField;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/fields/color/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,MAAM,CAK1E"}

package/dist/fields/constants.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Convex schema value type constants for field types.
+ *
+ * These constants define the base Convex validator strings for each field type.
+ * They're used by schema generation logic to build the Convex schema.
+ *
+ * @internal
+ */
+/** Convex schema metadata for each supported field type, keyed by field type name. */
+export declare const ADMIN_FIELDS: {
+    readonly text: {
+        readonly type: "text";
+        readonly interfaceType: "string";
+        readonly validator: "v.string()";
+        readonly defaultValue: "";
+    };
+    readonly url: {
+        readonly type: "url";
+        readonly interfaceType: "string";
+        readonly validator: "v.string()";
+        readonly defaultValue: "";
+    };
+    readonly color: {
+        readonly type: "color";
+        readonly interfaceType: "string";
+        readonly validator: "v.string()";
+        readonly defaultValue: "";
+    };
+    readonly number: {
+        readonly type: "number";
+        readonly interfaceType: "number";
+        readonly validator: "v.number()";
+        readonly defaultValue: 0;
+    };
+    readonly checkbox: {
+        readonly type: "checkbox";
+        readonly interfaceType: "boolean";
+        readonly validator: "v.boolean()";
+        readonly defaultValue: false;
+    };
+    readonly date: {
+        readonly type: "date";
+        readonly interfaceType: "number";
+        readonly validator: "v.number()";
+        readonly defaultValue: undefined;
+    };
+    readonly select: {
+        readonly type: "select";
+        readonly interfaceType: "string[]";
+        readonly validator: "v.array(\nv.string()\n)";
+        readonly defaultValue: string[];
+    };
+    readonly relationship: {
+        readonly type: "relationship";
+        readonly interfaceType: "Id<CollectionSlug>[]";
+        readonly validator: "v.array(\nv.string()\n)";
+        readonly defaultValue: string[];
+    };
+    readonly array: {
+        readonly type: "array";
+        readonly interfaceType: "unknown[]";
+        readonly validator: "v.array(\nv.any()\n)";
+        readonly defaultValue: readonly [];
+    };
+    readonly group: {
+        readonly type: "group";
+        readonly interfaceType: "Record<string, any>";
+        readonly validator: "v.object({})";
+        readonly defaultValue: Record<string, any>;
+    };
+    readonly blocks: {
+        readonly type: "blocks";
+        readonly interfaceType: "Record<string, any>[]";
+        readonly validator: "v.array(v.any())";
+        readonly defaultValue: readonly [];
+    };
+    readonly upload: {
+        readonly type: "upload";
+        readonly interfaceType: "Id<MediaCollectionSlug>[]";
+        readonly validator: "v.array(\nv.string()\n)";
+        readonly defaultValue: undefined;
+    };
+};
+/** Union of all supported field type name strings (e.g. `"text"` | `"number"` | `"checkbox"` | ...). */
+export type AdminFieldType = (typeof ADMIN_FIELDS)[keyof typeof ADMIN_FIELDS]["type"];
+/** Union of all Convex validator strings for the supported field types (e.g. `"v.string()"` | `"v.number()"` | ...). */
+export type AdminFieldValidator = (typeof ADMIN_FIELDS)[keyof typeof ADMIN_FIELDS]["validator"];
+/** Union of all TypeScript type strings corresponding to the supported field types (e.g. `"string"` | `"number"` | ...). */
+export type AdminFieldTsType = (typeof ADMIN_FIELDS)[keyof typeof ADMIN_FIELDS]["interfaceType"];
+/** Literal type `"text"` — the discriminant value on {@link TextField}. */
+export type TextFieldType = typeof ADMIN_FIELDS.text.type;
+/** Literal type `"url"` — the discriminant value on {@link UrlField}. */
+export type UrlFieldType = typeof ADMIN_FIELDS.url.type;
+/** Literal type `"color"` — the discriminant value on {@link ColorField}. */
+export type ColorFieldType = typeof ADMIN_FIELDS.color.type;
+/** Literal type `"number"` — the discriminant value on {@link NumberField}. */
+export type NumberFieldType = typeof ADMIN_FIELDS.number.type;
+/** Literal type `"checkbox"` — the discriminant value on {@link CheckboxField}. */
+export type CheckboxFieldType = typeof ADMIN_FIELDS.checkbox.type;
+/** Literal type `"date"` — the discriminant value on {@link DateField}. */
+export type DateFieldType = typeof ADMIN_FIELDS.date.type;
+/** Literal type `"select"` — the discriminant value on {@link SelectField}. */
+export type SelectFieldType = typeof ADMIN_FIELDS.select.type;
+/** Literal type `"relationship"` — the discriminant value on {@link RelationshipField}. */
+export type RelationshipFieldType = typeof ADMIN_FIELDS.relationship.type;
+/** Literal type `"array"` — the discriminant value on {@link ArrayField}. */
+export type ArrayFieldType = typeof ADMIN_FIELDS.array.type;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/fields/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,sFAAsF;AACtF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAyCD,MAAM,EAAE;;;;;;+BAMR,MAAM,EAAE;;;;;;;;;;;;+BAaR,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;;;;;;;;;;;CAmBjC,CAAC;AACX,wGAAwG;AACxG,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACtF,wHAAwH;AACxH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC,WAAW,CAAC,CAAC;AAChG,4HAA4H;AAC5H,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC;AAEjG,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;AAE1D,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;AAExD,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;AAE9D,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;AAElE,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;AAE1D,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;AAE9D,2FAA2F;AAC3F,MAAM,MAAM,qBAAqB,GAAG,OAAO,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC;AAE1E,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC"}

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

@@ -0,0 +1,57 @@
+import { BaseFieldMeta } from "../types";
+import type { DateFieldInput, DateField } from "./types";
+/**
+ * Creates a date field with all defaults applied.
+ *
+ * Date fields store a Unix timestamp in milliseconds.
+ * Common uses: published dates, expiry dates, event times, timestamps.
+ *
+ * Accepts {@link DateFieldInput} (all optional) and returns {@link DateField} with all defaults applied.
+ *
+ * **Defaults applied:**
+ * - `label` — `""` (inferred from the field key by `defineCollection`)
+ * - `required` — `false`
+ * - `time.hidden` — `false` (time picker is visible)
+ * - `time.use12HourFormat` — `true` (AM/PM format)
+ * - `time.timePicker.hour` — `true`
+ * - `time.timePicker.minute` — `true`
+ * - `time.timePicker.second` — `false`
+ * - `admin.hidden` — `false`
+ * - `admin.readOnly` — `false`
+ * - `admin.position` — `"main"`
+ * - `admin.width` — `"full"`
+ * - `admin.cellAlignment` — `"left"`
+ *
+ * @param options - Date field configuration. All properties are optional.
+ * @returns Resolved date field definition with all defaults applied.
+ *
+ * @example
+ * ```ts
+ * import { date, defineCollection } from '@vexcms/core'
+ *
+ * posts: defineCollection({
+ *   fields: {
+ *     // Minimal — label inferred from key ("Published At")
+ *     publishedAt: date(),
+ *
+ *     // Required event date with a database index
+ *     eventDate: date({ required: true, index: "by_event_date" }),
+ *
+ *     // Date-only picker (hide the time UI)
+ *     expiresOn: date({ time: { hidden: true } }),
+ *
+ *     // Appointment in 24-hour format, shown in the sidebar
+ *     appointmentAt: date({
+ *       required: true,
+ *       time: { use12HourFormat: false },
+ *       admin: { position: "sidebar", width: "half" },
+ *     }),
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link DateFieldInput} for the full input type
+ * @see {@link DateField} for the resolved output type
+ */
+export declare function date<TFieldMeta extends BaseFieldMeta = BaseFieldMeta>(options?: DateFieldInput<TFieldMeta>): DateField<TFieldMeta>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/fields/date/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,IAAI,CAAC,UAAU,SAAS,aAAa,GAAG,aAAa,EACnE,OAAO,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACnC,SAAS,CAAC,UAAU,CAAC,CAsCvB"}

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

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

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

@@ -0,0 +1,29 @@
+import { ZodType } from "zod";
+import { DateField } from "./types";
+/**
+ * Builds a Zod schema for validating a date field value in the admin form.
+ *
+ * Date values are Unix timestamps in milliseconds, so the base schema is
+ * `z.number()`. For required fields a `.default(Date.now())` is applied so
+ * the picker always has an initial value. Non-required fields are wrapped
+ * in `.optional()` via `applyBaseInputSchemaMeta`.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved date field definition
+ * @returns A Zod number schema with optionality applied
+ *
+ * @example
+ * ```ts
+ * const field = date({ required: true })
+ * dateFieldToInputSchema({ field })
+ * // → z.number().default(<now>)
+ *
+ * const optField = date({ required: false })
+ * dateFieldToInputSchema({ field: optField })
+ * // → z.number().optional()
+ * ```
+ */
+export declare function dateFieldToInputSchema(props: {
+    field: DateField;
+}): ZodType;
+//# sourceMappingURL=inputSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputSchema.d.ts","sourceRoot":"","sources":["../../../src/fields/date/inputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,OAAO,EAAyB,MAAM,KAAK,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,OAAO,CAS3E"}

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

@@ -0,0 +1,147 @@
+import { ADMIN_FIELDS } from "../constants";
+import { BaseField, BaseFieldInput, FieldAdminConfig } from "../baseTypes";
+/**
+ * Configuration input for a `date()` field.
+ *
+ * Date fields store a Unix timestamp in milliseconds — event dates, publish
+ * dates, expiry times, etc. All properties are optional; unset properties fall
+ * back to the defaults listed below.
+ *
+ * **Defaults applied by `date()`:**
+ * ```ts
+ * {
+ *   type:     "date",
+ *   label:    "",       // inferred from the field key by defineCollection
+ *   required: false,    // field is optional by default
+ *   time: {
+ *     hidden:         false, // time picker is visible alongside the calendar
+ *     use12HourFormat: true, // AM/PM format (set false for 24-hour)
+ *     timePicker: {
+ *       hour:   true,  // hour selector shown
+ *       minute: true,  // minute selector shown
+ *       second: false, // seconds hidden
+ *     },
+ *   },
+ *   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",  // text aligned left in the data table column
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Minimal — label is inferred from the key ("Published At")
+ * publishedAt: date()
+ *
+ * // Required event date with a database index
+ * eventDate: date({ required: true, index: "by_event_date" })
+ *
+ * // Appointment with 24-hour format and seconds hidden (overrides defaults)
+ * appointmentAt: date({
+ *   required: true,
+ *   time: { use12HourFormat: false },
+ * })
+ *
+ * // Date-only picker (hide the time UI entirely)
+ * expiresOn: date({ time: { hidden: true } })
+ *
+ * // Pre-filled default (Unix ms timestamp for 2025-01-01T00:00:00Z)
+ * startsAt: date({ defaultValue: 1735689600000 })
+ * ```
+ *
+ * @see {@link DateField} for the resolved type after defaults are applied
+ * @see {@link date} for the config function that applies defaults
+ * @see {@link BaseFieldInput} for shared properties (`label`, `description`, `required`, `admin`, `index`)
+ */
+export interface DateFieldInput<TFieldMeta extends {} = {}> extends BaseFieldInput<TFieldMeta> {
+    /**
+     * Pre-filled Unix timestamp (milliseconds) shown in the admin form when creating a new document.
+     * Does not apply to existing database values.
+     */
+    defaultValue?: number | undefined;
+    /** Minimum allowed Unix timestamp (milliseconds). Validated in the input schema. */
+    min?: number;
+    /** Maximum allowed Unix timestamp (milliseconds). Validated in the input schema. */
+    max?: number;
+    /**
+     * Date/time picker display configuration. Each key is optional — omitted keys
+     * fall back to the defaults applied by `date()`. The `time` object is always
+     * fully resolved on `DateField` after defaults are merged.
+     */
+    time?: {
+        /**
+         * Hide the time-of-day picker, showing only the calendar date selector.
+         *
+         * Default: `false` (time picker is visible)
+         */
+        hidden?: boolean;
+        /**
+         * Display time in 12-hour AM/PM format instead of 24-hour.
+         *
+         * Default: `true`
+         */
+        use12HourFormat?: boolean;
+        /**
+         * Control which time units are shown in the time picker.
+         * Each unit defaults to `true` for `hour` and `minute`, `false` for `second`.
+         */
+        timePicker?: {
+            /** Show the hour selector. Default: `true`. */
+            hour: boolean;
+            /** Show the minute selector. Default: `true`. */
+            minute: boolean;
+            /** Show the seconds selector. Default: `false`. */
+            second: boolean;
+        };
+    };
+}
+/**
+ * Resolved configuration for a `date()` field, after all defaults are applied.
+ *
+ * This is the type that framework adapters and field components receive —
+ * `fieldDef` in `InputComponentProps<DateField>` and `CellComponentProps<DateField>`
+ * is this type.
+ *
+ * @see {@link DateFieldInput} for the user-facing input type
+ * @see {@link date} for the config function that produces this type
+ */
+export interface DateField<TFieldMeta extends {} = {}> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.date.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 Unix timestamp (milliseconds) shown in the admin form when creating a new document. */
+    defaultValue: number | undefined;
+    /** Minimum allowed Unix timestamp (milliseconds). */
+    min?: number;
+    /** Maximum allowed Unix timestamp (milliseconds). */
+    max?: number;
+    /**
+     * Resolved date/time picker display configuration — all keys always present after defaults are applied.
+     *
+     * @see {@link DateFieldInput} for the user-facing input type where each key is optional
+     */
+    time: {
+        /** Whether the time-of-day picker is hidden, leaving only the calendar date selector. */
+        hidden: boolean;
+        /** Whether time is displayed in 12-hour AM/PM format (`true`) or 24-hour format (`false`). */
+        use12HourFormat: boolean;
+        /** Which time unit selectors are shown in the time picker. */
+        timePicker: {
+            /** Whether the hour selector is shown. */
+            hour: boolean;
+            /** Whether the minute selector is shown. */
+            minute: boolean;
+            /** Whether the seconds selector is shown. */
+            second: boolean;
+        };
+    };
+}
+//# sourceMappingURL=types.d.ts.map