@vexcms/core 0.0.20 → 0.1.0-alpha.3

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

@@ -0,0 +1,132 @@
+import { ADMIN_FIELDS } from "../constants";
+import { BaseField, BaseFieldInput, FieldAdminConfig } from "../baseTypes";
+/**
+ * Configuration input for a `text()` field.
+ *
+ * Text fields store short, single-line string values — titles, slugs, URLs,
+ * email addresses, status labels, etc. All properties are optional; unset
+ * properties fall back to the defaults listed below.
+ *
+ * **Defaults applied by `text()`:**
+ * ```ts
+ * {
+ *   type:     "text",
+ *   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",  // text aligned left in the data table column
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Minimal — label is inferred from the key ("Title")
+ * title: text()
+ *
+ * // Required slug with length validation and a database index
+ * slug: text({ required: true, min: { value: 3 }, max: { value: 100 }, index: "by_slug" })
+ *
+ * // Author name with a placeholder hint shown in the admin form
+ * authorName: text({
+ *   required: true,
+ *   admin: { width: "half", placeholder: "e.g. Jane Smith" }
+ * })
+ *
+ * // Pre-filled default for a URL field
+ * canonicalUrl: text({ defaultValue: "https://example.com" })
+ * ```
+ *
+ * @see {@link BaseFieldInput} for shared properties (`label`, `description`, `required`, `admin`, `index`, `searchIndex`)
+ */
+export interface TextFieldInput<TFieldMeta extends {} = {}> extends BaseFieldInput<TFieldMeta> {
+    /**
+     * Pre-filled value shown in the admin form when creating a new field.
+     * Does not apply to database values
+     *
+     */
+    defaultValue?: string;
+    /** Minimum character length config. */
+    min?: {
+        /** Minimum character length value. */
+        value: number;
+        /** Minimum character length error message. */
+        error?: string;
+    };
+    /** Maximum character length config. */
+    max?: {
+        /** Maximum character length value. */
+        value: number;
+        /** Maximum character length error message. */
+        error?: string;
+    };
+    /**
+     * Create a full-text search index on this field.
+     * The field this is defined on becomes the `searchField`.
+     *
+     * @example
+     * ```ts
+     * title: {
+     *   type: "text",
+     *   searchIndex: { name: "search_title", filterFields: ["status", "author"] },
+     * }
+     * // Generates: .searchIndex("search_title", { searchField: "title", filterFields: ["status", "author"] })
+     * ```
+     */
+    searchIndex?: {
+        /** Search index name (must be unique within the collection). */
+        name: string;
+        /**
+         * Fields to filter search results by.
+         * String array — validated at runtime against collection field names.
+         */
+        filterFields: string[];
+    };
+}
+/**
+ * Resolved configuration for a `text()` field, after all defaults are applied.
+ *
+ * This is the type that framework adapters and field components receive —
+ * `fieldDef` in `InputComponentProps<TextField>` and `CellComponentProps<TextField>`
+ * is this type.
+ *
+ * @see {@link TextFieldInput} for the user-facing input type
+ * @see {@link text} for the config function that produces this type
+ */
+export interface TextField<TFieldMeta extends {} = {}> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.text.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 value shown in the admin form when creating a new field. */
+    defaultValue: string;
+    /** Minimum allowed character length config. */
+    min?: {
+        /** Minimum allowed character length value. */
+        value: number;
+        /** Minimum allowed character length error message. */
+        error?: string;
+    };
+    /** Maximum allowed character length config. */
+    max?: {
+        /** Maximum allowed character length value. */
+        value: number;
+        /** Maximum allowed character length error message. */
+        error?: string;
+    };
+    /** Full-text search index configuration for this field. */
+    searchIndex?: {
+        /** Search index name — must be unique within the collection. */
+        name: string;
+        /** Fields to filter search results by. */
+        filterFields: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fields/text/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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,cAAc,CAC7B,UAAU,SAAS,EAAE,GAAG,EAAE,CAC1B,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,GAAG,CAAC,EAAE;QACJ,sCAAsC;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,8CAA8C;QAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,uCAAuC;IACvC,GAAG,CAAC,EAAE;QACJ,sCAAsC;QACtC,KAAK,EAAE,MAAM,CAAC;QACd,8CAA8C;QAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE;QACZ,gEAAgE;QAChE,IAAI,EAAE,MAAM,CAAC;QACb;;;WAGG;QACH,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,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,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,GAAG,CAAC,EAAE;QACJ,8CAA8C;QAC9C,KAAK,EAAE,MAAM,CAAC;QACd,sDAAsD;QACtD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,+CAA+C;IAC/C,GAAG,CAAC,EAAE;QACJ,8CAA8C;QAC9C,KAAK,EAAE,MAAM,CAAC;QACd,sDAAsD;QACtD,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,2DAA2D;IAC3D,WAAW,CAAC,EAAE;QACZ,gEAAgE;QAChE,IAAI,EAAE,MAAM,CAAC;QACb,0CAA0C;QAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH"}

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

@@ -0,0 +1,39 @@
+import type { TextField } from "./types";
+/**
+ * Converts a text field definition to a Convex schema validator.
+ *
+ * Generates the appropriate v.string() or v.optional(v.string()) 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 - textFieldToValidator() input props
+ * @param props.field - The text field definition
+ * @returns Convex value type string: "v.string()" or "v.optional(v.string())"
+ *
+ * @example
+ * ```ts
+ * const field1 = text({ required: true })
+ * textToValidatorString({ field: field1 })  // "v.string()"
+ *
+ * const field2 = text({ required: false })
+ * textToValidatorString({ field: field2 })  // "v.optional(v.string())"
+ *
+ * const field3 = text({ min: { value: 3 }, max: { value: 100 } })
+ * textToValidatorString({ field: field3 })  // "v.optional(v.string())"
+ * // Note: Length constraints don't affect schema, handled at validation layer
+ * ```
+ *
+ * @internal - Used by schema generation, not typically called by users
+ */
+export declare function textFieldToValidator(props: {
+    field: TextField;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

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

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

package/dist/fields/types.d.ts

@@ -0,0 +1,135 @@
+import { NumberField } from "./number";
+import { TextField } from "./text";
+import { CheckboxField } from "./checkbox";
+import { DateField } from "./date";
+import { TDocument } from "../api/convex";
+import { CollectionConfig } from "../collections";
+import { Row } from "@tanstack/react-table";
+import { SelectField } from "./select";
+import { UrlField } from "./url";
+import { ColorField } from "./color";
+import { RelationshipField } from "./relationship";
+import { ArrayField, ArrayType } from "./array";
+import { GroupField } from "./group";
+import { BlocksField } from "./blocks";
+import { UploadField } from "./upload";
+import { GlobalConfig } from "../globals";
+export * from "./text/types";
+export * from "./number/types";
+export * from "./checkbox/types";
+export * from "./blocks/types";
+/**
+ * BaseFieldMeta - empty object
+ */
+export type BaseFieldMeta = {};
+/**
+ * CollectionFieldMeta - default metadata
+ * added to all fields via defineCollection, defineMediaCollection, etc
+ */
+export type CollectionFieldMeta = BaseFieldMeta & {
+    collectionSlug: string;
+};
+/**
+ * Discriminated union of all field types in VexCMS.
+ *
+ * Switch on `field.type` to narrow to a specific field type and access
+ * its type-specific properties.
+ *
+ * Currently includes:
+ * - `TextField` — single-line text input
+ * - `NumberField` — numeric value (price, quantity, rating, etc.)
+ * - `CheckboxField` — boolean toggle (published state, feature flag, opt-in, etc.)
+ * - `DateField` — Unix ms timestamp (publish date, expiry date, event time, etc.)
+ * - `SelectField` — single-choice from a predefined set of options
+ * - `UrlField` — validated URL string
+ * - `ColorField` — CSS colour string, or a `var(--token)` reference when `themeColors` is on
+ * - `RelationshipField` — Convex `Id` reference to a document in another collection
+ *
+ * @example
+ * ```ts
+ * function handleField(field: AdminField) {
+ *   switch (field.type) {
+ *     case "text":
+ *       // field is TextField
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+export type AdminField<TFieldMeta extends BaseFieldMeta = BaseFieldMeta> = TextField<TFieldMeta> | NumberField<TFieldMeta> | CheckboxField<TFieldMeta> | DateField<TFieldMeta> | SelectField<TFieldMeta> | UrlField<TFieldMeta> | ColorField<TFieldMeta> | ArrayField<ArrayType, TFieldMeta> | RelationshipField<TFieldMeta> | UploadField<TFieldMeta> | BlocksField<TFieldMeta> | GroupField<TFieldMeta>;
+/**
+ * Props passed to field input components rendered in the document edit form.
+ *
+ * Every input component registered in a framework adapter's `fields` map must
+ * accept these props. The `TField` generic narrows `fieldDef` to the specific
+ * field type (e.g. `TextField`) so type-specific properties are accessible
+ * with autocomplete.
+ *
+ * In React, use `createFieldInput<TValue, TField>` to build components that
+ * accept these props — it handles TanStack Form wiring automatically.
+ *
+ * @example
+ * ```tsx
+ * // React — using createFieldInput
+ * export const TextFieldInput = createFieldInput<string, TextField>(
+ *   ({ name, fieldDef, readOnly, field }) => (
+ *     <input
+ *       value={field.state.value ?? ""}
+ *       onChange={(e) => field.handleChange(e.target.value)}
+ *       readOnly={readOnly}
+ *       placeholder={fieldDef.admin.placeholder}
+ *     />
+ *   ),
+ * );
+ * ```
+ *
+ * @see {@link CellComponentProps} for the data table equivalent
+ * @see {@link FieldComponentMap} for how components are registered
+ */
+export interface InputComponentProps<TFieldMeta extends BaseFieldMeta = BaseFieldMeta, TField extends AdminField<TFieldMeta> = AdminField<TFieldMeta>> {
+    /** The field key name from the collection config, e.g. `"title"`. Used as the form field name. */
+    name: string;
+    /** The resolved field definition — narrows to the specific field type via `TField`. */
+    fieldDef: TField;
+    /** Whether the field is non-editable — derived from `fieldDef.admin.readOnly` or permission checks. */
+    readOnly: boolean;
+    index?: number;
+    /** The config for the collection this field is attached to. */
+    collection: CollectionConfig | GlobalConfig;
+}
+/**
+ * Props passed to field cell components rendered in the data table list view.
+ *
+ * Every cell component registered in a framework adapter's `fields` map must
+ * accept these props. The `TField` generic narrows `fieldDef` to the specific
+ * field type so type-specific properties are accessible.
+ *
+ * `value` is typed as `TField["defaultValue"]` which resolves to the field's
+ * stored value type (e.g. `string` for `TextField`).
+ *
+ * @example
+ * ```tsx
+ * export function TextFieldCell(props: CellComponentProps<TextField>) {
+ *   if (!props.value) return <span>—</span>;
+ *   return <span>{props.value}</span>;
+ * }
+ * ```
+ *
+ * @see {@link InputComponentProps} for the edit form equivalent
+ * @see {@link FieldComponentMap} for how components are registered
+ */
+export interface CellComponentProps<TField extends AdminField = AdminField, TData extends TDocument = TDocument, TCollectionConfig extends CollectionConfig = CollectionConfig> {
+    /** The raw field value from the document — typed to the field's value type. */
+    value: TField["defaultValue"];
+    /** The full document row, for cases where the cell needs to read other fields. */
+    row: Row<TData>;
+    /** The resolved field definition — narrows to the specific field type via `TField`. */
+    fieldDef: TField;
+    /** The resolved field key on the collection for this column. */
+    fieldKey: string;
+    /** Whether this cell is the field designated as `useAsTitle` — used to render a clickable edit link. */
+    isTitleField: boolean;
+    /** The parent collection config — used by title cells to build the edit link `href`. */
+    collection: TCollectionConfig;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,24 @@
+import { BaseFieldMeta } from "../types";
+import type { UploadFieldInput, UploadField } from "./types";
+/**
+ * Creates an upload field that stores a reference to a media document.
+ *
+ * The `to` parameter specifies which media collection receives uploaded files.
+ * At config validation time, the `to` slug is checked against the media
+ * collections returned by all configured storage adapters.
+ *
+ * @param options — Upload field configuration. `to` is required.
+ * @returns Resolved upload field definition.
+ *
+ * @throws {Error} If `to` is empty or not a valid slug (`/^[a-zA-Z][a-zA-Z0-9_-]*$/`).
+ *
+ * @example
+ * ```ts
+ * defineCollection({
+ *   fields: {
+ *     featuredImage: upload({ to: "images", label: "Featured Image" }),
+ *   },
+ * });
+ */
+export declare function upload<TFieldMeta extends BaseFieldMeta = BaseFieldMeta>(options: UploadFieldInput<TFieldMeta>): UploadField<TFieldMeta>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/fields/upload/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,UAAU,SAAS,aAAa,GAAG,aAAa,EACrE,OAAO,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACpC,WAAW,CAAC,UAAU,CAAC,CA+BzB"}

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

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

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

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

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

@@ -0,0 +1,17 @@
+import { type ZodType } from "zod";
+import type { UploadField } from "./types";
+/**
+ * Generates the Zod input schema for an upload field.
+ *
+ * The form stores a media document ID string. The upload component validates
+ * that the ID points to an existing media document at the UI level (by querying
+ * the media collection), but the Zod schema is a simple string check.
+ *
+ * @param props — Input schema generation options.
+ * @param props.field — The resolved upload field definition.
+ * @returns Zod schema for the form field value.
+ */
+export declare function uploadFieldToInputSchema(props: {
+    field: UploadField;
+}): ZodType;
+//# sourceMappingURL=inputSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputSchema.d.ts","sourceRoot":"","sources":["../../../src/fields/upload/inputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GAAG,OAAO,CAG/E"}

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

@@ -0,0 +1,78 @@
+import type { BaseField, BaseFieldInput } from "../baseTypes";
+import type { MediaCollectionSlug } from "../../types/generated";
+import { ADMIN_FIELDS } from "../constants";
+import { BaseFieldMeta } from "../types";
+/**
+ * Input configuration for an `upload()` field — the `to` parameter is required
+ * and references the target media collection slug.
+ */
+export interface UploadFieldInput<TFieldMeta extends BaseFieldMeta = BaseFieldMeta> extends BaseFieldInput<TFieldMeta> {
+    /**
+     * The slug of the media collection that stores uploaded files for this field.
+     *
+     * Must match a media collection defined via a storage adapter's
+     * `defineMediaCollection()`. After running `vex generate`, this is typed as
+     * `MediaCollectionSlug` — a union of all media collection slugs in the project.
+     * Before generation, it falls back to `string`.
+     *
+     * Config validation (in `media/config.ts`) also checks at runtime that the
+     * slug exists in `VexConfig.mediaCollections`.
+     *
+     * @example
+     * ```ts
+     * upload({ to: "images", label: "Featured Image" })
+     */
+    to: MediaCollectionSlug;
+    /**
+     * The min number of files allowed.
+     */
+    min?: number;
+    /**
+     * The max number of files allowed.
+     */
+    max?: number;
+    /**
+     * Whether this input accepts multiple files or only one.
+     */
+    hasMany?: boolean;
+    /**
+     * Pre-filled value shown in the admin form when creating a new document.
+     */
+    defaultValue?: string[];
+    /**
+     * Restrict files that can be uploaded by mimeType.
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/accept
+     * @example 'image/*'
+     * @example 'image/*, audio/mp4'
+     * @example 'image/webp, audio/mp3'
+     */
+    accept?: string;
+}
+/**
+ * Resolved upload field definition after defaults are applied.
+ */
+export interface UploadField<TFieldMeta extends BaseFieldMeta = BaseFieldMeta> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.upload.type;
+    to: MediaCollectionSlug;
+    /**
+     * Whether this input accepts multiple files or only one.
+     */
+    hasMany: boolean;
+    /**
+     * The min number of files allowed.
+     */
+    min: number;
+    /**
+     * The max number of files allowed.
+     */
+    max?: number;
+    /**
+     * Pre-filled value shown in the admin form when creating a new document.
+     */
+    defaultValue?: string[];
+    /**
+     * Restrict files that can be uploaded by mimeType.
+     */
+    accept: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/fields/upload/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAC/B,UAAU,SAAS,aAAa,GAAG,aAAa,CAChD,SAAQ,cAAc,CAAC,UAAU,CAAC;IAClC;;;;;;;;;;;;;;OAcG;IACH,EAAE,EAAE,mBAAmB,CAAC;IACxB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAC1B,UAAU,SAAS,aAAa,GAAG,aAAa,CAChD,SAAQ,SAAS,CAAC,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;IAC/C,EAAE,EAAE,mBAAmB,CAAC;IACxB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}

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

@@ -0,0 +1,16 @@
+import type { UploadField } from "./types";
+/**
+ * Generates the Convex schema validator for an upload field.
+ *
+ * Stores a media document ID: `v.id("<to-slug>")`. The `to` slug is the
+ * media collection name — schema generation validates that the collection exists.
+ *
+ * @param props — Validator generation options.
+ * @param props.field — The resolved upload field definition.
+ * @returns Convex validator string, e.g. `"v.id(\"images\")"` or
+ *   `"v.optional(v.id(\"images\"))"`.
+ */
+export declare function uploadFieldToValidator(props: {
+    field: UploadField;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

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

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

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

@@ -0,0 +1,49 @@
+import { BaseFieldMeta } from "../types";
+import type { UrlFieldInput, UrlField } from "./types";
+/**
+ * Creates a URL field with all defaults applied.
+ *
+ * URL fields store absolute URLs as strings and render them as clickable
+ * links in the admin data table. Common uses: website links, canonical
+ * URLs, external resource references, social profile URLs.
+ *
+ * Accepts {@link UrlFieldInput} (all optional) and returns {@link UrlField} 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 - URL field configuration. All properties are optional.
+ * @returns Resolved URL field definition with all defaults applied.
+ *
+ * @example
+ * ```ts
+ * import { url, defineCollection } from '@vexcms/core'
+ *
+ * pages: defineCollection({
+ *   fields: {
+ *     // Minimal — label inferred from key ("Canonical Url")
+ *     canonicalUrl: url(),
+ *
+ *     // Required website URL with a length cap and database index
+ *     website: url({ required: true, max: { value: 2048 }, index: "by_website" }),
+ *
+ *     // Social profile URL with a placeholder hint
+ *     twitterUrl: url({
+ *       required: false,
+ *       admin: { width: "half", placeholder: "https://twitter.com/username" },
+ *     }),
+ *   }
+ * })
+ * ```
+ *
+ * @see {@link UrlFieldInput} for the full input type
+ * @see {@link UrlField} for the resolved output type
+ */
+export declare function url<TFieldMeta extends BaseFieldMeta = BaseFieldMeta>(options?: UrlFieldInput<TFieldMeta>): UrlField<TFieldMeta>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/fields/url/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,GAAG,CAAC,UAAU,SAAS,aAAa,GAAG,aAAa,EAClE,OAAO,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,GAClC,QAAQ,CAAC,UAAU,CAAC,CA0BtB"}

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

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

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

@@ -0,0 +1,31 @@
+import { type ZodType } from "zod";
+import { UrlField } from "./types";
+/**
+ * Builds a Zod schema for validating a URL field value in the admin form.
+ *
+ * Enforces URL format via `z.url()`. Required fields add a `.min(1)` check.
+ * `.default(field.defaultValue)` is applied only when `defaultValue` is explicitly
+ * set on the field — unlike `text()`, the url field has no implicit empty-string
+ * default. Wraps in `.optional()` for non-required fields via
+ * `applyBaseInputSchemaMeta`.
+ *
+ * @param props - Input props.
+ * @param props.field - The resolved URL field definition.
+ * @returns A Zod URL schema. Optional fields are wrapped in `.optional()`. A
+ * `.default()` is only added when `field.defaultValue` is not `undefined`.
+ *
+ * @example
+ * ```ts
+ * // Required — rejects empty string and non-URLs
+ * urlFieldToInputSchema({ field: url({ required: true }) })
+ * // → z.url().min(1, "This field is required.").optional() — no default
+ *
+ * // Optional with explicit default
+ * urlFieldToInputSchema({ field: url({ required: false, defaultValue: "https://example.com" }) })
+ * // → z.url().default("https://example.com").optional()
+ * ```
+ */
+export declare function urlFieldToInputSchema(props: {
+    field: UrlField;
+}): ZodType;
+//# sourceMappingURL=inputSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputSchema.d.ts","sourceRoot":"","sources":["../../../src/fields/url/inputSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AACpG,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,GAAG,OAAO,CAiBzE"}

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

@@ -0,0 +1,70 @@
+import { ADMIN_FIELDS } from "../constants";
+import { BaseField, BaseFieldInput } from "../baseTypes";
+/**
+ * Configuration input for a `url()` field.
+ *
+ * URL fields store absolute URLs as strings. All properties are optional;
+ * unset properties fall back to the defaults listed below.
+ *
+ * **Defaults applied by `url()`:**
+ * ```ts
+ * {
+ *   type:     "url",
+ *   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",  // text aligned left in the data table column
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Minimal — label is inferred from the key ("Canonical Url")
+ * canonicalUrl: url()
+ *
+ * // Required website URL with a length cap and a database index
+ * website: url({ required: true, max: { value: 2048 }, index: "by_website" })
+ *
+ * // Social profile URL with a placeholder hint
+ * twitterUrl: url({
+ *   required: false,
+ *   admin: { width: "half", placeholder: "https://twitter.com/username" }
+ * })
+ *
+ * // Pre-filled default URL
+ * homepageUrl: url({ defaultValue: "https://example.com" })
+ * ```
+ *
+ * @see {@link BaseFieldInput} for shared properties (`label`, `description`, `required`, `admin`, `index`, `searchIndex`)
+ */
+export interface UrlFieldInput<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;
+}
+/**
+ * Resolved configuration for a `url()` field, after all defaults are applied.
+ *
+ * This is the type that framework adapters and field components receive —
+ * `fieldDef` in `InputComponentProps<UrlField>` and `CellComponentProps<UrlField>`
+ * is this type.
+ *
+ * @see {@link UrlFieldInput} for the user-facing input type
+ * @see {@link url} for the config function that produces this type
+ */
+export interface UrlField<TFieldMeta extends {} = {}> extends BaseField<TFieldMeta> {
+    readonly type: typeof ADMIN_FIELDS.url.type;
+    /**
+     * Pre-filled value shown in the admin form when creating a new document.
+     * `undefined` means no default is applied — the input starts empty.
+     */
+    defaultValue?: string;
+}
+//# sourceMappingURL=types.d.ts.map