@vexcms/core 0.0.20 → 0.1.0-alpha.3

package/dist/chunk-2IB2DCN7.js

@@ -0,0 +1,75 @@
+// src/api/convex.ts
+import { anyApi } from "convex/server";
+var vexConvexApi = {
+  /**
+   * Finds documents in a collection.
+   * Called by {@link react/src!CollectionListView} in `@vexcms/react`.
+   */
+  find: anyApi.vex.find,
+  /**
+   * Finds documents in a collection with cursor pagination.
+   * Called by {@link react/src!CollectionListView} in `@vexcms/react`.
+   */
+  findPaginated: anyApi.vex.find,
+  /**
+   * Fetches a single document by ID.
+   * Called by {@link react/src!CollectionEditView} in `@vexcms/react` when editing.
+   */
+  get: anyApi.vex.get,
+  /**
+   * Creates a new document. Returns the new document's ID as a string.
+   */
+  create: anyApi.vex.create,
+  /**
+   * Searches documents in a collection by a search index.
+   *
+   * Used by `RelationshipFieldInput` in `@vexcms/react` to populate the
+   * relationship picker combobox. The `searchIndexName` must match the
+   * `.searchIndex()` name in the Convex schema — VexCMS auto-generates
+   * `search_<useAsTitle>` when another collection has a relationship here.
+   * Pass `query: ""` to list recent documents when no search term is entered.
+   *
+   * @see {@link https://docs.convex.dev/text-search} for Convex search docs
+   */
+  search: anyApi.vex.search,
+  /**
+   * Patches an existing document — unspecified fields are left unchanged.
+   */
+  update: anyApi.vex.update,
+  /**
+   * Permanently deletes a document.
+   */
+  remove: anyApi.vex.remove,
+  media: {
+    /**
+     * Generates a URL to upload a file to.
+     * Called by `MediaUploadDropzone` in `@vexcms/react`.
+     */
+    generateUploadUrl: anyApi.vex.media.generateUploadUrl,
+    /**
+     * Creates a media document in Convex after the file is uploaded.
+     * Called by `MediaUploadDropzone` in `@vexcms/react`.
+     */
+    createMediaDocument: anyApi.vex.media.createMediaDocument,
+    /**
+     * Deletes a media document and its file from storage.
+     * Called by `MediaLibrary` in `@vexcms/react`.
+     */
+    deleteMedia: anyApi.vex.media.deleteMedia,
+    /**
+     * Returns a URL for a media file.
+     * Called by `UploadFieldCell` in `@vexcms/react`.
+     */
+    getUrl: anyApi.vex.media.getUrl
+  },
+  globals: {
+    get: anyApi.vex.globals.get,
+    find: anyApi.vex.globals.find,
+    upsert: anyApi.vex.globals.upsert
+  }
+};
+
+export {
+  vexConvexApi
+};
+//# sourceMappingURL=chunk-2IB2DCN7.js.map

package/dist/chunk-2IB2DCN7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/convex.ts"],"sourcesContent":["import { anyApi } from \"convex/server\";\nimport type { FunctionReference } from \"convex/server\";\nimport type { PaginationOptions, PaginationResult, VexApiAuth } from \"./types\";\nimport { CollectionSlug, VexDocumentGlobal } from \"../types\";\n\n/**\n * Base type for all VexCMS documents as returned from Convex queries.\n *\n * All documents include the Convex system fields `_id` and `_creationTime`,\n * plus whatever field values are defined in the collection's schema.\n *\n * Framework adapters use this as the `initialData` type in view component\n * props — the actual field values are accessed via string keys.\n *\n * @example\n * ```ts\n * const title = typeof doc.title === \"string\" ? doc.title : \"\";\n * ```\n *\n * @see {@link vexConvexApi} for the query functions that return this type\n */\nexport interface VexDocument {\n  /** Convex document ID string. */\n  _id: string;\n  /** Unix timestamp (milliseconds) when the document was created. */\n  _creationTime: number;\n  /** Field values defined by the collection schema. */\n  [key: string]: unknown;\n}\n\n/**\n * Alias for `VexDocument` that also satisfies `Record<string, unknown>`.\n *\n * Use this type when a generic `Record` index signature is required alongside\n * the Convex system fields — for example, as the `data` type in TanStack Table\n * or as the form `defaultValues` record.\n *\n * @see {@link VexDocument} for the base type\n */\nexport type TDocument<TShape = {}> = Record<string, unknown> & TShape & VexDocument;\n\n/**\n * Type for media documents returned from Convex queries.\n *\n * Extends `VexDocument` with all required media fields: alt, filename,\n * mimeType, size, storageId, deleted, src (the file URL), and optional\n * width/height. Use this instead of `TDocument` in media collection views to\n * avoid casting fields like `row.original.src as string`.\n *\n * @example\n * ```ts\n * const src = doc.src; // string | undefined, no cast needed\n * const alt = doc.alt ?? \"\";\n * ```\n *\n * @see {@link TDocument} for the base document type with custom shape support\n */\nexport interface VexMediaDocument extends VexDocument {\n  /** Alt text for accessibility and SEO. */\n  alt: string;\n  /** Original filename of the uploaded file. */\n  filename: string;\n  /** MIME type (e.g., \"image/jpeg\", \"application/pdf\"). */\n  mimeType: string;\n  /** File size in bytes. */\n  size: number;\n  /** Storage adapter ID for the uploaded file. */\n  storageId: string;\n  /** Whether this media item has been soft-deleted. */\n  deleted: boolean;\n  /** URL to the file. */\n  src: string;\n  /** Image width in pixels (if applicable). */\n  width?: number;\n  /** Image height in pixels (if applicable). */\n  height?: number;\n}\n\n// ── Collection API types ───────────────────────────────────────\n//\n// Extracted arg/return shapes for the generic Vex API collection endpoints.\n// Used by `vexConvexApi` below and re-exported for user-side `vex.ts` casts\n// to avoid TS2589 from the deep conditional types in `queryApi()`.\n\n/** Args for `api.vex.find`. */\nexport interface VexFindArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  collection: CollectionSlug;\n  populate?: unknown;\n  depth?: number;\n  limit?: number;\n  paginationOpts?: PaginationOptions;\n}\n\n/** Args for `api.vex.find`. */\nexport interface VexFindPaginatedArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  collection: CollectionSlug;\n  populate?: unknown;\n  depth?: number;\n  limit?: number;\n  paginationOpts: PaginationOptions;\n}\n\n/** Args for `api.vex.get`. */\nexport interface VexGetArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  collection: string;\n  id: string;\n  populate?: unknown;\n  depth?: number;\n}\n\n/** Args for `api.vex.search`. */\nexport interface VexSearchArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  collection: string;\n  searchIndexName: string;\n  searchField: string;\n  query: string;\n  limit?: number;\n  populate?: unknown;\n  depth?: number;\n  paginationOpts?: PaginationOptions;\n}\n\n/** Args for `api.vex.create`. */\nexport interface VexCreateArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  collection: string;\n  data: Record<string, unknown>;\n}\n\n/** Args for `api.vex.update`. */\nexport interface VexUpdateArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  collection: string;\n  id: string;\n  data: Record<string, unknown>;\n}\n\n/** Args for `api.vex.remove`. */\nexport interface VexRemoveArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  collection: string;\n  ids: string[];\n  softDelete?: string;\n}\n\n// ── Media API shallow types ──────────────────────────────────────────────\n//\n// Arg and return shapes for the generic media endpoints. These mirror the\n// `VexStorageAdapter` method signatures so the types stay in one place.\n\n/** Args for `api.vex.media.generateUploadUrl`. */\nexport interface VexMediaGenerateUploadUrlArgs {\n  [key: string]: unknown;\n  adapter: string;\n}\n\n/** Return for `api.vex.media.generateUploadUrl`. */\nexport interface VexMediaGenerateUploadUrlReturn {\n  [key: string]: unknown;\n  url: string;\n}\n\n/** Args for `api.vex.media.createMediaDocument`. */\nexport interface VexMediaCreateMediaDocumentArgs {\n  [key: string]: unknown;\n  adapter: string;\n  collectionSlug: string;\n  storageId: string;\n  filename: string;\n  mimeType: string;\n  size: number;\n  alt?: string;\n  adapterFields?: Record<string, unknown>;\n}\n\n/** Return for `api.vex.media.createMediaDocument`. */\nexport type VexMediaCreateMediaDocumentReturn = string;\n\n/** Args for `api.vex.media.deleteMedia`. */\nexport interface VexMediaDeleteMediaArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  adapter: string;\n  mediaId: string;\n  softDelete?: boolean;\n}\n\n/** Return for `api.vex.media.deleteMedia`. */\nexport type VexMediaDeleteMediaReturn = boolean;\n\n/** Args for `api.vex.media.getUrl`. */\nexport interface VexMediaGetUrlArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  adapter: string;\n  mediaId: string;\n}\n\n/** Return for `api.vex.media.getUrl`. */\nexport interface VexMediaGetUrlReturn {\n  [key: string]: unknown;\n  url?: string;\n  error?: string;\n}\n\n// ── Media API shallow types ──────────────────────────────────────────────\n\n/** Args for `api.vex.globals.get`. */\nexport interface VexGlobalsGetArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  slug: string;\n  populate?: Record<string, unknown>;\n}\n\n/** Args for `api.vex.globals.find`. */\nexport interface VexGlobalsFindArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n}\n\n/** Args for `api.vex.globals.update`. */\nexport interface VexGlobalsUpdateArgs {\n  [key: string]: unknown;\n  auth?: VexApiAuth;\n  slug: string;\n  data: Record<string, unknown>;\n}\n\n/**\n * Typed `anyApi` references to the VexCMS generic Convex collection functions.\n *\n * These point to functions that users copy into `convex/vex/collections.ts`\n * in their project. All paths are fixed under `vex.collections.*`.\n *\n * **Required:** copy `convex/vex/collections.ts` from the VexCMS template\n * into your project before these references will resolve at runtime.\n *\n * Used internally by view components in `@vexcms/react`. Framework adapter\n * authors do not need to import this directly unless building custom views.\n *\n * @example\n * ```ts\n * import { convexQuery } from \"@convex-dev/react-query\";\n * import { useQuery } from \"@tanstack/react-query\";\n * import { vexConvexApi } from \"@vexcms/core\";\n *\n * const { data } = useQuery({\n *   ...convexQuery(vexConvexApi.list, { collection: \"posts\" }),\n * });\n * ```\n */\nexport const vexConvexApi = {\n  /**\n   * Finds documents in a collection.\n   * Called by {@link react/src!CollectionListView} in `@vexcms/react`.\n   */\n  find: anyApi.vex.find as FunctionReference<\n    \"query\",\n    \"public\",\n    VexFindArgs,\n    VexDocument[] | PaginationResult<VexDocument>\n  >,\n  /**\n   * Finds documents in a collection with cursor pagination.\n   * Called by {@link react/src!CollectionListView} in `@vexcms/react`.\n   */\n  findPaginated: anyApi.vex.find as FunctionReference<\n    \"query\",\n    \"public\",\n    VexFindPaginatedArgs,\n    PaginationResult<VexDocument>\n  >,\n\n  /**\n   * Fetches a single document by ID.\n   * Called by {@link react/src!CollectionEditView} in `@vexcms/react` when editing.\n   */\n  get: anyApi.vex.get as FunctionReference<\"query\", \"public\", VexGetArgs, VexDocument | null>,\n\n  /**\n   * Creates a new document. Returns the new document's ID as a string.\n   */\n  create: anyApi.vex.create as FunctionReference<\"mutation\", \"public\", VexCreateArgs, string>,\n\n  /**\n   * Searches documents in a collection by a search index.\n   *\n   * Used by `RelationshipFieldInput` in `@vexcms/react` to populate the\n   * relationship picker combobox. The `searchIndexName` must match the\n   * `.searchIndex()` name in the Convex schema — VexCMS auto-generates\n   * `search_<useAsTitle>` when another collection has a relationship here.\n   * Pass `query: \"\"` to list recent documents when no search term is entered.\n   *\n   * @see {@link https://docs.convex.dev/text-search} for Convex search docs\n   */\n  search: anyApi.vex.search as FunctionReference<\n    \"query\",\n    \"public\",\n    VexSearchArgs,\n    VexDocument[] | PaginationResult<VexDocument>\n  >,\n\n  /**\n   * Patches an existing document — unspecified fields are left unchanged.\n   */\n  update: anyApi.vex.update as FunctionReference<\"mutation\", \"public\", VexUpdateArgs, void>,\n\n  /**\n   * Permanently deletes a document.\n   */\n  remove: anyApi.vex.remove as FunctionReference<\"mutation\", \"public\", VexRemoveArgs, void>,\n\n  media: {\n    /**\n     * Generates a URL to upload a file to.\n     * Called by `MediaUploadDropzone` in `@vexcms/react`.\n     */\n    generateUploadUrl: anyApi.vex.media.generateUploadUrl as FunctionReference<\n      \"mutation\",\n      \"public\",\n      VexMediaGenerateUploadUrlArgs,\n      VexMediaGenerateUploadUrlReturn\n    >,\n\n    /**\n     * Creates a media document in Convex after the file is uploaded.\n     * Called by `MediaUploadDropzone` in `@vexcms/react`.\n     */\n    createMediaDocument: anyApi.vex.media.createMediaDocument as FunctionReference<\n      \"mutation\",\n      \"public\",\n      VexMediaCreateMediaDocumentArgs,\n      VexMediaCreateMediaDocumentReturn\n    >,\n\n    /**\n     * Deletes a media document and its file from storage.\n     * Called by `MediaLibrary` in `@vexcms/react`.\n     */\n    deleteMedia: anyApi.vex.media.deleteMedia as FunctionReference<\n      \"mutation\",\n      \"public\",\n      VexMediaDeleteMediaArgs,\n      VexMediaDeleteMediaReturn\n    >,\n\n    /**\n     * Returns a URL for a media file.\n     * Called by `UploadFieldCell` in `@vexcms/react`.\n     */\n    getUrl: anyApi.vex.media.getUrl as FunctionReference<\n      \"query\",\n      \"public\",\n      VexMediaGetUrlArgs,\n      VexMediaGetUrlReturn\n    >,\n  },\n\n  globals: {\n    get: anyApi.vex.globals.get as FunctionReference<\n      \"query\",\n      \"public\",\n      VexGlobalsGetArgs,\n      VexDocumentGlobal | null\n    >,\n    find: anyApi.vex.globals.find as FunctionReference<\n      \"query\",\n      \"public\",\n      VexGlobalsFindArgs,\n      VexDocumentGlobal[]\n    >,\n    upsert: anyApi.vex.globals.upsert as FunctionReference<\n      \"mutation\",\n      \"public\",\n      VexGlobalsUpdateArgs,\n      string\n    >,\n  },\n} as const;\n"],"mappings":";AAAA,SAAS,cAAc;AAuQhB,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA,EAK1B,MAAM,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,EAUjB,eAAe,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,EAW1B,KAAK,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA,EAKhB,QAAQ,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAanB,QAAQ,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA,EAUnB,QAAQ,OAAO,IAAI;AAAA;AAAA;AAAA;AAAA,EAKnB,QAAQ,OAAO,IAAI;AAAA,EAEnB,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA,IAKL,mBAAmB,OAAO,IAAI,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,IAWpC,qBAAqB,OAAO,IAAI,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,IAWtC,aAAa,OAAO,IAAI,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,IAW9B,QAAQ,OAAO,IAAI,MAAM;AAAA,EAM3B;AAAA,EAEA,SAAS;AAAA,IACP,KAAK,OAAO,IAAI,QAAQ;AAAA,IAMxB,MAAM,OAAO,IAAI,QAAQ;AAAA,IAMzB,QAAQ,OAAO,IAAI,QAAQ;AAAA,EAM7B;AACF;","names":[]}

package/dist/collections/config.d.ts

@@ -0,0 +1,28 @@
+import { CollectionFieldMeta, ComponentHKT } from "../fields";
+import { CollectionSlug } from "../types";
+import { CollectionConfigInput, CollectionConfig } from "./types";
+/**
+ * Resolves a raw collection config input into a fully-populated `CollectionConfig`.
+ *
+ * Fills in any missing `labels` by deriving them from the `slug` — converting it
+ * to title case for `singular` and further pluralising it for `plural`.
+ *
+ * @param config - The raw collection configuration supplied by the caller.
+ * @returns The resolved `CollectionConfig` with all defaults applied.
+ *
+ * @example
+ * ```ts
+ * defineCollection({
+ *   slug: "posts",
+ *   fields: {
+ *     title: text({ required: true }),
+ *   },
+ * });
+ * // → { slug: "posts", admin: { useAsTitle: "_id" }, labels: { singular: "Post", plural: "Posts" }, fields: { ... } }
+ * ```
+ *
+ * @see {@link CollectionConfigInput} for the user-facing input type
+ * @see {@link CollectionConfig} for the resolved return type
+ */
+export declare function defineCollection<TFieldMeta extends {} = {}, TCollectionMeta extends {} = {}, TCollectionSlug extends CollectionSlug = CollectionSlug, TFieldSlug extends string = string, TComponent extends ComponentHKT = ComponentHKT>(config: CollectionConfigInput<TFieldMeta, TCollectionMeta, TCollectionSlug, TFieldSlug, TComponent>): CollectionConfig<TFieldMeta & CollectionFieldMeta, TCollectionMeta, TCollectionSlug, TFieldSlug, TComponent>;
+//# sourceMappingURL=config.d.ts.map

package/dist/collections/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/collections/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,mBAAmB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAsClE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,SAAS,EAAE,GAAG,EAAE,EAC1B,eAAe,SAAS,EAAE,GAAG,EAAE,EAC/B,eAAe,SAAS,cAAc,GAAG,cAAc,EACvD,UAAU,SAAS,MAAM,GAAG,MAAM,EAClC,UAAU,SAAS,YAAY,GAAG,YAAY,EAE9C,MAAM,EAAE,qBAAqB,CAC3B,UAAU,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,UAAU,CACX,GACA,gBAAgB,CACjB,UAAU,GAAG,mBAAmB,EAChC,eAAe,EACf,eAAe,EACf,UAAU,EACV,UAAU,CACX,CAoCA"}

package/dist/collections/constants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Built-in Convex system fields that are present on every document.
+ *
+ * Maps logical names to their Convex database field slugs. These slugs are
+ * always valid values for `useAsTitle` in a collection's admin config,
+ * regardless of the collection's own field definitions.
+ */
+export declare const CORE_ADMIN_FIELDS: {
+    /** The document's unique identifier, stored as `_id` in Convex. */
+    readonly id: {
+        readonly slug: "_id";
+    };
+    /** The document's creation timestamp, stored as `_creationTime` in Convex. */
+    readonly createdAt: {
+        readonly slug: "_creationTime";
+    };
+};
+/**
+ * Union of the field slugs for all built-in Convex system fields.
+ *
+ * Resolves to `"_id" | "_creationTime"`. Use this type wherever a value must
+ * refer to a core system field rather than a user-defined collection field.
+ *
+ * @see {@link CORE_ADMIN_FIELDS} for the full map of logical names to slugs
+ */
+export type CoreAdminField = (typeof CORE_ADMIN_FIELDS)[keyof typeof CORE_ADMIN_FIELDS]["slug"];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/collections/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;IAC5B,mEAAmE;;;;IAInE,8EAA8E;;;;CAItE,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACxB,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/collections/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./config";
+export * from "./constants";
+export * from "./types";
+export * from "./utils";
+export * from "./validator";
+export * from "./interfaceGen";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/collections/indexFields.d.ts

@@ -0,0 +1,20 @@
+import { CollectionConfig } from "./types";
+/**
+ * Groups a collection's index-bearing fields by declared index name, in
+ * field declaration order — the same computation `collectionConfigToVexSchema`
+ * uses for its `.index()` chain (`collections/validator.ts:114-118`): an
+ * explicit `field.index`, or an auto `by_<fieldKey>` for every relationship
+ * field. Search indexes are excluded — `withIndex` never targets those.
+ * Two fields declaring the SAME `field.index` value group into one compound
+ * entry, fields in the order they appear on the collection.
+ *
+ * @param props - Input props.
+ * @param props.collection - The collection to read index-bearing fields from.
+ * @returns Map of index name → field keys, in declaration order. Empty when
+ *   the collection declares no indexed fields.
+ * @internal
+ */
+export declare function collectionConfigToIndexFields(props: {
+    collection: CollectionConfig;
+}): Map<string, string[]>;
+//# sourceMappingURL=indexFields.d.ts.map

package/dist/collections/indexFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexFields.d.ts","sourceRoot":"","sources":["../../src/collections/indexFields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,UAAU,EAAE,gBAAgB,CAAC;CAC9B,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAoBxB"}

package/dist/collections/interfaceGen.d.ts

@@ -0,0 +1,59 @@
+import { CollectionConfig } from "./types";
+/**
+ * Converts a resolved `CollectionConfig` to a TypeScript `export interface` source string.
+ *
+ * Each generated interface extends `VexDocument` (inheriting `_id` and `_creationTime`)
+ * and overrides `_id` with the branded Convex `Id<"slug">` type for that collection.
+ * Optional fields (`field.required === false`) are emitted with the `?` modifier.
+ * `select` fields with custom options emit a companion type alias above the interface,
+ * named `<InterfaceName><FieldKey>Option` so the same field key on two collections does
+ * not produce two aliases with one name. Override with the field's `optionInterfaceName`.
+ *
+ * @param props - Input props.
+ * @param props.collection - The resolved collection definition to convert.
+ * @returns A TypeScript source string for one document interface block.
+ *
+ * @example
+ * ```ts
+ * const collection = defineCollection({
+ *   slug: "posts",
+ *   fields: { title: text({ required: true }), excerpt: text({ required: false }) },
+ * });
+ * collectionConfigToInterface({ collection });
+ * // → 'export interface PostsDocument extends VexDocument {\n\t_id: Id<"posts">\n\ttitle: string\n\texcerpt?: string\n}'
+ * ```
+ *
+ * @see {@link generateVexTypes} for the full-file generator that wraps this function
+ */
+export declare function collectionConfigToInterface(props: {
+    collection: CollectionConfig;
+}): string;
+/**
+ * Converts a resolved `CollectionConfig` to the TypeScript source string for its
+ * `CollectionsFieldTypeMap` entry used in the `declare module '@vexcms/core'` block.
+ *
+ * The output maps each field type present in the collection to a union of that
+ * collection's field keys of that type, plus a fixed `id: "_id"` entry. This
+ * lets framework code look up field keys by type at the TypeScript level —
+ * for example, finding all `text` fields on a given collection for search.
+ *
+ * @param props - Input props.
+ * @param props.collection - The resolved collection definition to convert.
+ * @returns A TypeScript source string for one `CollectionsFieldTypeMap` entry (without wrapping braces).
+ *
+ * @example
+ * ```ts
+ * const posts = defineCollection({
+ *   slug: "posts",
+ *   fields: { title: text({ required: true }), author: relationship({ collection: { slug: "authors" } }) },
+ * });
+ * collectionConfigToFieldTypeMap({ collection: posts });
+ * // → '\tposts: {\n\t\tid: "_id"\n\t\ttext: "title"\n\t\trelationship: "author"\n\t}'
+ * ```
+ *
+ * @see {@link generateVexTypes} for the full-file generator that wraps this function
+ */
+export declare function collectionConfigToFieldTypeMap(props: {
+    collection: CollectionConfig;
+}): string;
+//# sourceMappingURL=interfaceGen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaceGen.d.ts","sourceRoot":"","sources":["../../src/collections/interfaceGen.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE,GAAG,MAAM,CA6D3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE,GAAG,MAAM,CAqB9F"}

package/dist/collections/internal/index.d.ts

@@ -0,0 +1,2 @@
+export declare const internalCollections: never[];
+//# sourceMappingURL=index.d.ts.map

package/dist/collections/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/internal/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,SAAK,CAAC"}

package/dist/collections/types.d.ts

@@ -0,0 +1,282 @@
+import { AdminField } from "../fields";
+import { CoreAdminField } from "./constants";
+import type { ApplyComponent, ComponentHKT } from "../fields";
+import type { CollectionSlug } from "../types/generated";
+import { TDocument } from "../api/convex";
+import { LucideIconName } from "../utils";
+/**
+ * Props received by a custom preview component for relationship rendering.
+ *
+ * `TCollectionSlug` is the slug of the doc being rendered. In a picker row, this is the
+ * candidate target doc's slug. In a list-table cell, this is the parent
+ * collection's slug (the table row's `row.original`). In the trigger's
+ * selected-value chip, it is the resolved target doc's slug.
+ *
+ * `fieldKey` is the relationship field's key on the parent collection (e.g.
+ * `"author"`). In picker rows the component may ignore it; in list cells it
+ * gives access to the IDs via `doc[fieldKey]`.
+ *
+ * @typeParam TCollectionSlug - The slug of the doc being rendered.
+ */
+export interface RelationshipPreviewProps<TCollectionSlug extends CollectionSlug = CollectionSlug> {
+    /** The document being previewed. */
+    doc: TDocument;
+    /** The relationship field key on the parent collection. */
+    fieldKey: string;
+    /** The resolved collection config matching `doc`. */
+    config: CollectionConfig<TCollectionSlug>;
+}
+/**
+ * Configuration for data table display and behavior in the admin panel.
+ */
+export interface CollectionTableConfigInput {
+    /**
+     * Default number of items per page.
+     * @default 10
+     */
+    defaultPageSize?: number;
+    /**
+     * Default number of items per page fetch from the server.
+     * @default 100
+     */
+    serverPageSize?: number;
+    /**
+     * Available page size options in the pagination controls.
+     * @default [10, 25, 50, 100]
+     */
+    pageSizeOptions?: number[];
+    /**
+     * Default sort field and order.
+     * Must be an indexed field for performance.
+     * @default { field: "_creationTime", order: "desc" }
+     */
+    defaultSort?: {
+        field: string;
+        order: "asc" | "desc";
+    };
+    /**
+     * Bulk action configuration.
+     */
+    bulkActions?: {
+        /**
+         * Enable bulk delete action.
+         * @default true
+         */
+        delete: boolean;
+    };
+    /**
+     * Default visible columns (by field key).
+     * If not specified, all columns are shown.
+     * NOTE: deferred to column visibility spec.
+     */
+    defaultColumns?: string[];
+}
+/**
+ * Configuration for data table display and behavior in the admin panel.
+ */
+export interface CollectionTableConfig {
+    /**
+     * Default number of items per page on the client.
+     * @default 10
+     */
+    defaultPageSize: number;
+    /**
+     * Default number of items per page fetch from the server.
+     * @default 100
+     */
+    serverPageSize: number;
+    /**
+     * Available page size options in the pagination controls.
+     * @default [10, 25, 50, 100]
+     */
+    pageSizeOptions: number[];
+    /**
+     * Default sort field and order.
+     * Must be an indexed field for performance.
+     * @default { field: "_creationTime", order: "desc" }
+     */
+    defaultSort: {
+        field: string;
+        order: "asc" | "desc";
+    };
+    /**
+     * Bulk action configuration.
+     */
+    bulkActions: {
+        /**
+         * Enable bulk delete action.
+         * @default true
+         */
+        delete: boolean;
+    };
+    /**
+     * Default visible columns (by field key).
+     * If not specified, all columns are shown.
+     * NOTE: deferred to column visibility spec.
+     */
+    defaultColumns: string[];
+}
+/**
+ * Admin panel configuration input for a collection.
+ *
+ * Controls how the collection is presented and queried in the admin panel.
+ * All properties are optional.
+ *
+ * **Defaults applied by `defineCollection()`:**
+ * ```ts
+ * {
+ *   useAsTitle: "_id", // falls back to the Convex document ID if not set
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * defineCollection({
+ *   slug: "posts",
+ *   fields: { title: text({ required: true }) },
+ *   admin: { useAsTitle: "title" },
+ * })
+ * ```
+ *
+ * @see {@link AdminCollectionConfig} for the resolved type after defaults are applied
+ */
+export interface AdminCollectionConfigInput<TFieldSlug extends string = CoreAdminField, TComponent extends ComponentHKT = ComponentHKT> {
+    /**
+     * The field whose value is displayed as the document's human-readable title
+     * throughout the admin panel (list rows, breadcrumbs, relation pickers).
+     *
+     * Accepts any user-defined field slug from this collection, or a built-in
+     * Convex system field (`"_id"` | `"_creationTime"`). Setting a user-defined
+     * field also auto-generates a database index (`by_<field>`) and a search
+     * index (`search_<field>`) for fast admin queries. Omit to fall back to `"_id"`.
+     */
+    useAsTitle?: CoreAdminField | NoInfer<TFieldSlug>;
+    /**
+     * Custom component overrides for rendering this collection's docs in
+     * relationship contexts (picker rows, table cells, selected-value chips).
+     *
+     * Override per-relationship via `RelationshipFieldInput.admin.components.preview`.
+     *
+     * Slot type is `ApplyComponent<F, RelationshipPreviewProps>` — in pure-core
+     * context (`F = ComponentHKT`) this resolves to `unknown`. In React context
+     * (`F = ReactHKT`, exposed via `@vexcms/react`) this resolves to
+     * `ComponentType<RelationshipPreviewProps>`.
+     */
+    components?: {
+        /** Component used to render a doc of this collection as a relationship preview. */
+        preview?: ApplyComponent<TComponent, RelationshipPreviewProps>;
+    };
+    /**
+     * A valid Lucide icon name for this collection in the admin sidebar
+     * See https://lucide.dev/icons/
+     */
+    icon?: LucideIconName;
+    /**
+     * Data table configuration for list view.
+     */
+    table?: CollectionTableConfigInput;
+}
+/**
+ * Resolved admin panel configuration for a collection after defaults are applied.
+ *
+ * @see {@link AdminCollectionConfigInput} for the user-facing input type
+ */
+export interface AdminCollectionConfig<TFieldSlug extends string = CoreAdminField, TComponent extends ComponentHKT = ComponentHKT> {
+    /** The field used as the document's human-readable title in the admin panel. */
+    useAsTitle: CoreAdminField | NoInfer<TFieldSlug>;
+    components: {
+        preview?: ApplyComponent<TComponent, RelationshipPreviewProps>;
+    };
+    icon?: LucideIconName;
+    /**
+     * Data table configuration for list view.
+     */
+    table: CollectionTableConfig;
+}
+/**
+ * Configuration input for a `defineCollection()` call.
+ *
+ * A collection maps to a Convex database table. `slug` becomes the table name,
+ * `fields` defines its shape, and `labels` controls how the collection appears
+ * in the admin panel. Omitted labels are inferred from the slug.
+ *
+ * **Defaults applied by `defineCollection()`:**
+ * ```ts
+ * {
+ *   labels: {
+ *     singular: "Post",   // title-cased from slug ("posts" → "Post")
+ *     plural:   "Posts",  // title-cased + pluralised from slug
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * defineCollection({
+ *   slug: "posts",
+ *   fields: {
+ *     title: text({ required: true }),
+ *     body:  richtext(),
+ *   },
+ * })
+ * ```
+ *
+ * @see {@link CollectionConfig} for the resolved type after defaults are applied
+ * @see {@link defineCollection} for the config function
+ */
+export interface CollectionConfigInput<TFieldMeta extends {} = {}, TCollectionMeta extends {} = {}, TCollectionSlug extends string = string, TFieldSlug extends string = string, TComponent extends ComponentHKT = ComponentHKT> {
+    /** Admin panel behaviour for this collection. All properties are optional. */
+    admin?: AdminCollectionConfigInput<TFieldSlug, TComponent>;
+    /** Convex table name — used as the database table identifier and URL slug in the admin panel. */
+    slug: TCollectionSlug;
+    /**
+     * Display names shown in the admin panel navigation and list views.
+     * Both are inferred from `slug` if omitted.
+     */
+    labels?: {
+        /** Singular display name (e.g. `"Post"`). Inferred from slug if omitted. */
+        singular?: string;
+        /** Plural display name (e.g. `"Posts"`). Inferred from slug if omitted. */
+        plural?: string;
+    };
+    /** Field definitions that make up this collection's document shape. */
+    fields: Record<TFieldSlug, AdminField<TFieldMeta>>;
+    /** Override the PascalCase interface name used in generated TypeScript types. Inferred from `slug` by `defineCollection` if omitted. */
+    interfaceName?: string;
+    /** Index definitions that create indexes on this collection in Convex. */
+    indexes?: {
+        name: string;
+        fields: NoInfer<TFieldSlug>[];
+    }[];
+    meta?: TCollectionMeta;
+}
+/**
+ * Resolved collection configuration after defaults are applied by `defineCollection()`.
+ *
+ * @see {@link CollectionConfigInput} for the user-facing input type
+ * @see {@link defineCollection} for the config function
+ */
+export interface CollectionConfig<TFieldMeta extends {} = {}, TCollectionMeta extends {} = {}, TCollectionSlug extends CollectionSlug = CollectionSlug, TFieldSlug extends string = string, TComponent extends ComponentHKT = ComponentHKT> {
+    /** Resolved admin panel configuration for this collection. */
+    admin: AdminCollectionConfig<TFieldSlug, TComponent>;
+    /** Convex table name for this collection. */
+    slug: TCollectionSlug;
+    /** Display names shown in the admin panel — always present after defaults are applied. */
+    labels: {
+        /** Singular display name (e.g. `"Post"`). */
+        singular: string;
+        /** Plural display name (e.g. `"Posts"`). */
+        plural: string;
+    };
+    /** Resolved field definitions for this collection. */
+    fields: Record<TFieldSlug, AdminField<TFieldMeta>>;
+    /** PascalCase identifier derived from `slug`, used as the TypeScript interface name in generated types (e.g. `"posts"` → `"Posts"`). */
+    interfaceName: string;
+    /** Index definitions that create indexes on this collection in Convex. */
+    indexes?: {
+        name: string;
+        fields: NoInfer<TFieldSlug>[];
+    }[];
+    meta: TCollectionMeta;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/collections/utils.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import type { CollectionConfig } from "./types";
+import type { TDocument } from "../api/convex";
+/**
+ * Builds the `defaultValues` object for a TanStack Form instance from a collection.
+ *
+ * When `document` is provided, uses the document's field values (edit mode).
+ * When omitted, falls back to each field's `defaultValue` (create mode).
+ * The returned object's keys match the collection field keys.
+ *
+ * @param props - Input props.
+ * @param props.collection - The collection whose fields define the form shape.
+ * @param props.document - Optional existing document to populate values from when editing.
+ * @returns A `Record<fieldKey, value>` ready to pass to `useForm({ defaultValues })`.
+ *
+ * @example
+ * ```ts
+ * // New document — uses field defaults
+ * getCollectionDefaultValues({ collection: postsCollection })
+ * // → { title: "", slug: "" }
+ *
+ * // Existing document — uses document values
+ * getCollectionDefaultValues({ collection: postsCollection, document: doc })
+ * // → { title: "Hello world", slug: "hello-world" }
+ * ```
+ */
+export declare function getCollectionDefaultValues(props: {
+    collection: CollectionConfig;
+    document?: TDocument | null;
+}): Record<string, unknown>;
+/**
+ * Builds a Zod object schema for validating all fields in a collection.
+ *
+ * Calls `adminFieldToInputSchema` for each field and combines the results
+ * into a `z.object({...})`. Used by `useCollectionForm` as the TanStack Form
+ * `onSubmitAsync` / `onBlurAsync` validator.
+ *
+ * @param props - Input props.
+ * @param props.collection - The collection whose fields define the schema shape.
+ * @returns A `z.object` schema with one key per collection field.
+ *
+ * @example
+ * ```ts
+ * const schema = getCollectionInputSchema({ collection: postsCollection })
+ * // → z.object({ title: z.string().min(1), slug: z.string().min(3).max(100) })
+ * schema.parse({ title: "Hello", slug: "hello" }) // passes
+ * ```
+ */
+export declare function getCollectionInputSchema(props: {
+    collection: CollectionConfig;
+}): z.ZodObject<{
+    [x: string]: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$strip>;
+/**
+ * Converts a collection slug to a PascalCase identifier for use in type names.
+ *
+ * Splits on underscores and hyphens and capitalizes each segment.
+ *
+ * @param props - Input props.
+ * @param props.slug - The collection slug, e.g. `"blog_posts"`, `"authors"`.
+ * @returns PascalCase string, e.g. `"BlogPosts"`, `"Authors"`.
+ *
+ * @example
+ * ```ts
+ * slugToPascalCase({ slug: "blog_posts" }) // → "BlogPosts"
+ * slugToPascalCase({ slug: "authors" })    // → "Authors"
+ */
+export declare function slugToPascalCase(props: {
+    slug: string;
+}): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/collections/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/collections/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAgB,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAC7B,2BAaA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE;;kBAS/E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKhE"}