@blinkk/root-cms 3.0.1-alpha.0 → 3.0.1-alpha.1

package/dist/cli.js

@@ -5,7 +5,7 @@ import {
   RootCMSClient,
   getCmsPlugin,
   unmarshalData
-} from "./chunk-YMUZ5H5C.js";
+} from "./chunk-SNZ4S4IC.js";
 import "./chunk-MLKGABMK.js";
 
 // cli/cli.ts

package/dist/{client-cP6yMgT8.d.ts → client-DdB4xpM6.d.ts}

@@ -1,7 +1,7 @@
 import { RootConfig, Plugin, Request } from '@blinkk/root';
 import { App } from 'firebase-admin/app';
 import { Firestore, WriteBatch, Timestamp, Query } from 'firebase-admin/firestore';
-import { C as Collection } from './schema-D7MOj-YC.js';
+import { C as Collection } from './schema-rjBOZk-j.js';
 
 /**
  * Supported Root AI models. Defaults to 'gemini-3-flash-preview'.
@@ -54,6 +54,105 @@ interface CMSCheck {
     run: (ctx: CheckContext) => Promise<CheckResult>;
 }
 
+/**
+ * Base shape for a service registered with the CMS plugin.
+ *
+ * Services are extension points that let plugins provide capabilities
+ * (e.g. email delivery, cache, translations) that root-cms can call into.
+ * Every service shares the same identifying fields — `id`, `label`, optional
+ * `icon` — and is registered via the `services` option on `cmsPlugin()`.
+ *
+ * Concrete service interfaces (e.g. `CMSEmailService`,
+ * `CMSTranslationService`) extend this base and add the handler functions
+ * specific to their capability.
+ */
+interface CMSService {
+    /** Unique ID for the service (e.g. `'sendgrid'`, `'crowdin'`). */
+    id: string;
+    /** Human-readable label displayed in the UI (e.g. "SendGrid"). */
+    label: string;
+    /**
+     * Optional icon URL displayed in the UI next to the label. Similar to the
+     * sidebar tools `icon` option, this should be a URL to an image.
+     */
+    icon?: string;
+}
+/**
+ * Base context passed to service handler functions. Concrete services may
+ * extend this with additional fields specific to the call site (e.g. the
+ * translation context adds `docId`, `collectionId`, etc.).
+ */
+interface CMSServiceContext {
+    /** The Root.js config. */
+    rootConfig: RootConfig;
+    /** The Root CMS client for accessing the database. */
+    cmsClient: RootCMSClient;
+    /**
+     * Email of the user that triggered the action, if any. Some service calls
+     * are initiated by the system rather than a user, in which case this is
+     * undefined.
+     */
+    user?: {
+        email: string;
+    };
+}
+
+/** Result returned by a notification service `onAction` handler. */
+interface NotificationResult {
+    /**
+     * Delivery status.
+     * - `'success'`: the notification was delivered.
+     * - `'error'`: delivery failed; `message` should describe why.
+     * - `'info'` (default): the service handled the action but did not
+     *   deliver a notification (e.g. the action was filtered out).
+     */
+    status?: 'success' | 'info' | 'error';
+    /** Optional human-readable message describing the result. */
+    message?: string;
+}
+/** Context passed to notification service handler functions. */
+interface NotificationServiceContext extends CMSServiceContext {
+}
+/**
+ * Configuration for defining a CMS notification service.
+ *
+ * Notification services react to actions in the CMS (publishes, schema
+ * changes, comments, etc.) and dispatch them to an external channel.
+ * Initially this is intended for email, with Slack, webhooks, and other
+ * transports planned.
+ *
+ * Multiple notification services may be registered; each independently
+ * decides whether and how to handle a given action.
+ *
+ * Example:
+ * ```ts
+ * cmsPlugin({
+ *   services: {
+ *     notifications: [
+ *       {
+ *         id: 'sendgrid',
+ *         label: 'SendGrid',
+ *         onAction: async (ctx, action) => {
+ *           if (action.action === 'doc.publish') {
+ *             await sendgrid.send({ ... });
+ *           }
+ *         },
+ *       },
+ *     ],
+ *   },
+ * });
+ * ```
+ */
+interface CMSNotificationService extends CMSService {
+    /**
+     * Async function called when an action occurs in the CMS. Receives the
+     * action and may dispatch a notification (e.g. send email, post to Slack)
+     * via the service's underlying transport. Can optionally return a
+     * `NotificationResult` describing delivery status.
+     */
+    onAction?: (ctx: NotificationServiceContext, action: Action) => Promise<void | NotificationResult>;
+}
+
 /** A row of translation data keyed by locale. */
 interface TranslationRow {
     /** The source string. */
@@ -64,11 +163,7 @@ interface TranslationRow {
     description?: string;
 }
 /** Context passed to translation service import/export functions. */
-interface TranslationServiceContext {
-    /** The Root.js config. */
-    rootConfig: RootConfig;
-    /** The Root CMS client for accessing the database. */
-    cmsClient: RootCMSClient;
+interface TranslationServiceContext extends CMSServiceContext {
     /** The document ID, e.g. `Pages/index`. */
     docId: string;
     /** The collection ID, e.g. `Pages`. */
@@ -125,16 +220,7 @@ interface TranslationImportResult {
     status?: 'success' | 'info' | 'error';
 }
 /** Configuration for defining a CMS translation service. */
-interface CMSTranslationService {
-    /** Unique ID for the translation service. */
-    id: string;
-    /** Human-readable label displayed in the UI (e.g. "Crowdin"). */
-    label: string;
-    /**
-     * Optional icon URL displayed in the UI next to the label. Similar to the
-     * sidebar tools `icon` option, this should be a URL to an image.
-     */
-    icon?: string;
+interface CMSTranslationService extends CMSService {
     /**
      * Async function to import translations from the service. Should return an
      * array of translation rows that will be merged into the CMS translations
@@ -166,7 +252,7 @@ declare function translationsCheck(options?: TranslationsCheckOptions): CMSCheck
 /**
  * Built-in sidebar tools that can be toggled on/off in the CMS UI.
  */
-type CMSBuiltInSidebarTool = 'home' | 'content' | 'releases' | 'data' | 'assets' | 'translations' | 'ai' | 'settings';
+type CMSBuiltInSidebarTool = 'home' | 'content' | 'tasks' | 'releases' | 'data' | 'assets' | 'translations' | 'ai' | 'settings';
 interface CMSUser {
     email: string;
 }
@@ -367,6 +453,29 @@ type CMSPluginOptions = {
      * ```
      */
     translations?: CMSTranslationService[];
+    /**
+     * Notification services that react to CMS actions and dispatch them to
+     * external channels (email, Slack, webhooks, etc.). Each service defines
+     * an optional server-side `onAction` handler.
+     *
+     * Example:
+     * ```ts
+     * cmsPlugin({
+     *   notifications: [
+     *     {
+     *       id: 'sendgrid',
+     *       label: 'SendGrid',
+     *       onAction: async (ctx, action) => {
+     *         if (action.action === 'doc.publish') {
+     *           await sendgrid.send({ ... });
+     *         }
+     *       },
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    notifications?: CMSNotificationService[];
 };
 type CMSPlugin = Plugin & {
     name: 'root-cms';
@@ -1256,4 +1365,4 @@ declare class BatchResponse {
     private getTranslationsMap;
 }
 
-export { type CMSAIConfig as $, type Action as A, type BatchRequestOptions as B, type CronUnit as C, type DocMode as D, type TranslationsDoc as E, BatchRequest as F, type GetDocOptions as G, type HttpMethod as H, BatchResponse as I, type Locale as J, type SourceString as K, type LoadTranslationsOptions as L, type TranslatedString as M, type TranslationsDocMode as N, type TranslationsLocaleDocHashMap as O, type TranslationsLocaleDocEntry as P, type MultiLocaleTranslationsMap as Q, RootCMSClient as R, type SetDocOptions as S, type TranslationsMap as T, type UserRole as U, type SingleLocaleTranslationsMap as V, TranslationsManager as W, buildTranslationsDbPath as X, buildTranslationsLocaleDocDbPath as Y, type CMSBuiltInSidebarTool as Z, type CMSUser as _, type LocaleTranslations as a, type CMSSidebarTool as a0, type CMSPluginOptions as a1, type CMSPlugin as a2, cmsPlugin as a3, type CMSCheck as a4, type CheckResult as a5, type CheckContext as a6, type CheckStatus as a7, translationsCheck as a8, type TranslationsCheckOptions as a9, type CMSTranslationService as aa, type TranslationExportResult as ab, type TranslationImportResult as ac, type TranslationRow as ad, type TranslationServiceContext as ae, type Doc as b, type DataSourceCron as c, type DataSource as d, type DataSourceData as e, type DataSourceMode as f, type SaveDraftOptions as g, type UpdateDraftOptions as h, type ListDocsOptions as i, type GetCountOptions as j, type Translation as k, type Release as l, type ListActionsOptions as m, isRichTextData as n, getCmsPlugin as o, marshalData as p, normalizeData as q, type ArrayObject as r, marshalArray as s, toArrayObject as t, unmarshalData as u, unmarshalArray as v, translationsForLocale as w, parseDocId as x, type BatchRequestQuery as y, type BatchRequestQueryOptions as z };
+export { type CMSAIConfig as $, type Action as A, type BatchRequestOptions as B, type CronUnit as C, type DocMode as D, type TranslationsDoc as E, BatchRequest as F, type GetDocOptions as G, type HttpMethod as H, BatchResponse as I, type Locale as J, type SourceString as K, type LoadTranslationsOptions as L, type TranslatedString as M, type TranslationsDocMode as N, type TranslationsLocaleDocHashMap as O, type TranslationsLocaleDocEntry as P, type MultiLocaleTranslationsMap as Q, RootCMSClient as R, type SetDocOptions as S, type TranslationsMap as T, type UserRole as U, type SingleLocaleTranslationsMap as V, TranslationsManager as W, buildTranslationsDbPath as X, buildTranslationsLocaleDocDbPath as Y, type CMSBuiltInSidebarTool as Z, type CMSUser as _, type LocaleTranslations as a, type CMSSidebarTool as a0, type CMSPluginOptions as a1, type CMSPlugin as a2, cmsPlugin as a3, type CMSCheck as a4, type CheckResult as a5, type CheckContext as a6, type CheckStatus as a7, translationsCheck as a8, type TranslationsCheckOptions as a9, type CMSService as aa, type CMSServiceContext as ab, type CMSNotificationService as ac, type NotificationResult as ad, type NotificationServiceContext as ae, type CMSTranslationService as af, type TranslationExportResult as ag, type TranslationImportResult as ah, type TranslationRow as ai, type TranslationServiceContext as aj, type Doc as b, type DataSourceCron as c, type DataSource as d, type DataSourceData as e, type DataSourceMode as f, type SaveDraftOptions as g, type UpdateDraftOptions as h, type ListDocsOptions as i, type GetCountOptions as j, type Translation as k, type Release as l, type ListActionsOptions as m, isRichTextData as n, getCmsPlugin as o, marshalData as p, normalizeData as q, type ArrayObject as r, marshalArray as s, toArrayObject as t, unmarshalData as u, unmarshalArray as v, translationsForLocale as w, parseDocId as x, type BatchRequestQuery as y, type BatchRequestQueryOptions as z };

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import '@blinkk/root';
 import 'firebase-admin/app';
 import 'firebase-admin/firestore';
-export { A as Action, r as ArrayObject, F as BatchRequest, B as BatchRequestOptions, y as BatchRequestQuery, z as BatchRequestQueryOptions, I as BatchResponse, C as CronUnit, d as DataSource, c as DataSourceCron, e as DataSourceData, f as DataSourceMode, b as Doc, D as DocMode, j as GetCountOptions, G as GetDocOptions, H as HttpMethod, m as ListActionsOptions, i as ListDocsOptions, L as LoadTranslationsOptions, a as LocaleTranslations, l as Release, R as RootCMSClient, g as SaveDraftOptions, S as SetDocOptions, k as Translation, E as TranslationsDoc, T as TranslationsMap, h as UpdateDraftOptions, U as UserRole, o as getCmsPlugin, n as isRichTextData, s as marshalArray, p as marshalData, q as normalizeData, x as parseDocId, t as toArrayObject, w as translationsForLocale, v as unmarshalArray, u as unmarshalData } from './client-cP6yMgT8.js';
-import './schema-D7MOj-YC.js';
+export { A as Action, r as ArrayObject, F as BatchRequest, B as BatchRequestOptions, y as BatchRequestQuery, z as BatchRequestQueryOptions, I as BatchResponse, C as CronUnit, d as DataSource, c as DataSourceCron, e as DataSourceData, f as DataSourceMode, b as Doc, D as DocMode, j as GetCountOptions, G as GetDocOptions, H as HttpMethod, m as ListActionsOptions, i as ListDocsOptions, L as LoadTranslationsOptions, a as LocaleTranslations, l as Release, R as RootCMSClient, g as SaveDraftOptions, S as SetDocOptions, k as Translation, E as TranslationsDoc, T as TranslationsMap, h as UpdateDraftOptions, U as UserRole, o as getCmsPlugin, n as isRichTextData, s as marshalArray, p as marshalData, q as normalizeData, x as parseDocId, t as toArrayObject, w as translationsForLocale, v as unmarshalArray, u as unmarshalData } from './client-DdB4xpM6.js';
+import './schema-rjBOZk-j.js';

package/dist/client.js

@@ -12,7 +12,7 @@ import {
   translationsForLocale,
   unmarshalArray,
   unmarshalData
-} from "./chunk-YMUZ5H5C.js";
+} from "./chunk-SNZ4S4IC.js";
 import "./chunk-MLKGABMK.js";
 export {
   BatchRequest,

package/dist/core.d.ts

@@ -1,8 +1,8 @@
-import { R as RootCMSClient, D as DocMode, L as LoadTranslationsOptions, T as TranslationsMap, a as LocaleTranslations } from './client-cP6yMgT8.js';
-export { A as Action, r as ArrayObject, F as BatchRequest, B as BatchRequestOptions, y as BatchRequestQuery, z as BatchRequestQueryOptions, I as BatchResponse, C as CronUnit, d as DataSource, c as DataSourceCron, e as DataSourceData, f as DataSourceMode, b as Doc, j as GetCountOptions, G as GetDocOptions, H as HttpMethod, m as ListActionsOptions, i as ListDocsOptions, J as Locale, Q as MultiLocaleTranslationsMap, l as Release, g as SaveDraftOptions, S as SetDocOptions, V as SingleLocaleTranslationsMap, K as SourceString, M as TranslatedString, k as Translation, E as TranslationsDoc, N as TranslationsDocMode, P as TranslationsLocaleDocEntry, O as TranslationsLocaleDocHashMap, W as TranslationsManager, h as UpdateDraftOptions, U as UserRole, X as buildTranslationsDbPath, Y as buildTranslationsLocaleDocDbPath, o as getCmsPlugin, n as isRichTextData, s as marshalArray, p as marshalData, q as normalizeData, x as parseDocId, t as toArrayObject, w as translationsForLocale, v as unmarshalArray, u as unmarshalData } from './client-cP6yMgT8.js';
+import { R as RootCMSClient, D as DocMode, L as LoadTranslationsOptions, T as TranslationsMap, a as LocaleTranslations } from './client-DdB4xpM6.js';
+export { A as Action, r as ArrayObject, F as BatchRequest, B as BatchRequestOptions, y as BatchRequestQuery, z as BatchRequestQueryOptions, I as BatchResponse, C as CronUnit, d as DataSource, c as DataSourceCron, e as DataSourceData, f as DataSourceMode, b as Doc, j as GetCountOptions, G as GetDocOptions, H as HttpMethod, m as ListActionsOptions, i as ListDocsOptions, J as Locale, Q as MultiLocaleTranslationsMap, l as Release, g as SaveDraftOptions, S as SetDocOptions, V as SingleLocaleTranslationsMap, K as SourceString, M as TranslatedString, k as Translation, E as TranslationsDoc, N as TranslationsDocMode, P as TranslationsLocaleDocEntry, O as TranslationsLocaleDocHashMap, W as TranslationsManager, h as UpdateDraftOptions, U as UserRole, X as buildTranslationsDbPath, Y as buildTranslationsLocaleDocDbPath, o as getCmsPlugin, n as isRichTextData, s as marshalArray, p as marshalData, q as normalizeData, x as parseDocId, t as toArrayObject, w as translationsForLocale, v as unmarshalArray, u as unmarshalData } from './client-DdB4xpM6.js';
 import { Request, RootConfig, Response, RouteParams, GetStaticProps, GetStaticPaths } from '@blinkk/root';
 import { Query } from 'firebase-admin/firestore';
-export { s as schema } from './schema-D7MOj-YC.js';
+export { s as schema } from './schema-rjBOZk-j.js';
 import 'firebase-admin/app';
 
 /**

package/dist/core.js

@@ -16,7 +16,7 @@ import {
   translationsForLocale,
   unmarshalArray,
   unmarshalData
-} from "./chunk-YMUZ5H5C.js";
+} from "./chunk-SNZ4S4IC.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";
@@ -480,6 +480,7 @@ __export(schema_exports, {
   datetime: () => datetime,
   define: () => define,
   defineCollection: () => defineCollection,
+  definePreset: () => definePreset,
   defineSchema: () => defineSchema,
   file: () => file,
   glob: () => glob,
@@ -488,6 +489,7 @@ __export(schema_exports, {
   number: () => number,
   object: () => object,
   oneOf: () => oneOf,
+  preset: () => preset,
   reference: () => reference,
   references: () => references,
   richtext: () => richtext,
@@ -560,6 +562,10 @@ function defineSchema(schema) {
   return schema;
 }
 var define = defineSchema;
+function definePreset(preset2) {
+  return preset2;
+}
+var preset = definePreset;
 function defineCollection(collection2) {
   return collection2;
 }

package/dist/functions.js

@@ -1,7 +1,7 @@
 import {
   runCronJobs
-} from "./chunk-H6ZKML2S.js";
-import "./chunk-YMUZ5H5C.js";
+} from "./chunk-UTSL2E2P.js";
+import "./chunk-SNZ4S4IC.js";
 import "./chunk-MLKGABMK.js";
 
 // core/functions.ts

package/dist/plugin.d.ts

@@ -1,5 +1,5 @@
 import '@blinkk/root';
 import 'firebase-admin/app';
 import 'firebase-admin/firestore';
-export { $ as CMSAIConfig, Z as CMSBuiltInSidebarTool, a4 as CMSCheck, a2 as CMSPlugin, a1 as CMSPluginOptions, a0 as CMSSidebarTool, aa as CMSTranslationService, _ as CMSUser, a6 as CheckContext, a5 as CheckResult, a7 as CheckStatus, ab as TranslationExportResult, ac as TranslationImportResult, ad as TranslationRow, ae as TranslationServiceContext, a9 as TranslationsCheckOptions, a3 as cmsPlugin, a8 as translationsCheck } from './client-cP6yMgT8.js';
-import './schema-D7MOj-YC.js';
+export { $ as CMSAIConfig, Z as CMSBuiltInSidebarTool, a4 as CMSCheck, ac as CMSNotificationService, a2 as CMSPlugin, a1 as CMSPluginOptions, aa as CMSService, ab as CMSServiceContext, a0 as CMSSidebarTool, af as CMSTranslationService, _ as CMSUser, a6 as CheckContext, a5 as CheckResult, a7 as CheckStatus, ad as NotificationResult, ae as NotificationServiceContext, ag as TranslationExportResult, ah as TranslationImportResult, ai as TranslationRow, aj as TranslationServiceContext, a9 as TranslationsCheckOptions, a3 as cmsPlugin, a8 as translationsCheck } from './client-DdB4xpM6.js';
+import './schema-rjBOZk-j.js';

package/dist/plugin.js

@@ -4,15 +4,16 @@ import {
 } from "./chunk-T5UK2H24.js";
 import {
   getServerVersion
-} from "./chunk-N4Z3O53K.js";
+} from "./chunk-BBOESYH7.js";
 import {
+  SearchIndexService,
   runCronJobs
-} from "./chunk-H6ZKML2S.js";
+} from "./chunk-UTSL2E2P.js";
 import {
   RootCMSClient,
   parseDocId,
   unmarshalData
-} from "./chunk-YMUZ5H5C.js";
+} from "./chunk-SNZ4S4IC.js";
 import "./chunk-MLKGABMK.js";
 
 // core/plugin.ts
@@ -160,13 +161,96 @@ function api(server, options) {
   });
   server.use("/cms/api/cron.run", async (req, res) => {
     try {
-      await runCronJobs(req.rootConfig);
+      await runCronJobs(req.rootConfig, {
+        loadSchema: (collectionId) => getCollectionSchema(req, collectionId)
+      });
       res.status(200).json({ success: true });
     } catch (err) {
       console.error(err);
       res.status(500).json({ success: false });
     }
   });
+  const searchRebuildJobs = /* @__PURE__ */ new Map();
+  server.use("/cms/api/search.query", async (req, res) => {
+    if (req.method !== "POST" || !String(req.get("content-type")).startsWith("application/json")) {
+      res.status(400).json({ success: false, error: "BAD_REQUEST" });
+      return;
+    }
+    if (!req.user?.email) {
+      res.status(401).json({ success: false, error: "UNAUTHORIZED" });
+      return;
+    }
+    const body = req.body || {};
+    const q = typeof body.q === "string" ? body.q : "";
+    const limit = typeof body.limit === "number" ? body.limit : 25;
+    try {
+      const service = new SearchIndexService(req.rootConfig);
+      const result = await service.search(q, { limit });
+      res.setHeader("Cache-Control", "no-store");
+      res.status(200).json({ success: true, ...result });
+    } catch (err) {
+      console.error(err.stack || err);
+      res.status(500).json({ success: false, error: "UNKNOWN" });
+    }
+  });
+  server.use("/cms/api/search.status", async (req, res) => {
+    if (!req.user?.email) {
+      res.status(401).json({ success: false, error: "UNAUTHORIZED" });
+      return;
+    }
+    try {
+      const cmsClient = new RootCMSClient(req.rootConfig);
+      const service = new SearchIndexService(req.rootConfig);
+      const status = await service.getStatus();
+      const running = searchRebuildJobs.has(cmsClient.projectId);
+      res.setHeader("Cache-Control", "no-store");
+      res.status(200).json({ success: true, status, running });
+    } catch (err) {
+      console.error(err.stack || err);
+      res.status(500).json({ success: false, error: "UNKNOWN" });
+    }
+  });
+  server.use("/cms/api/search.rebuild", async (req, res) => {
+    if (req.method !== "POST") {
+      res.status(400).json({ success: false, error: "BAD_REQUEST" });
+      return;
+    }
+    if (!req.user?.email) {
+      res.status(401).json({ success: false, error: "UNAUTHORIZED" });
+      return;
+    }
+    const cmsClient = new RootCMSClient(req.rootConfig);
+    try {
+      const role = await cmsClient.getUserRole(req.user.email);
+      if (role !== "ADMIN") {
+        res.status(403).json({ success: false, error: "FORBIDDEN" });
+        return;
+      }
+    } catch (err) {
+      console.error(err.stack || err);
+      res.status(500).json({ success: false, error: "UNKNOWN" });
+      return;
+    }
+    const body = req.body || {};
+    const force = !!body.force;
+    const projectId = cmsClient.projectId;
+    if (searchRebuildJobs.has(projectId)) {
+      res.status(202).json({ success: true, alreadyRunning: true });
+      return;
+    }
+    const service = new SearchIndexService(
+      req.rootConfig,
+      (collectionId) => getCollectionSchema(req, collectionId)
+    );
+    const job = service.rebuildIndex({ force }).catch((err) => {
+      console.error("search.rebuild failed:", err.stack || err);
+      throw err;
+    }).finally(() => {
+      searchRebuildJobs.delete(projectId);
+    });
+    searchRebuildJobs.set(projectId, job);
+    res.status(202).json({ success: true, started: true, force });
+  });
   server.use("/cms/api/csv.download", (req, res) => {
     if (req.method !== "POST" || !String(req.get("content-type")).startsWith("application/json")) {
       res.status(400).json({ success: false, error: "BAD_REQUEST" });

package/dist/project.d.ts

@@ -1,10 +1,10 @@
-import { S as Schema, C as Collection } from './schema-D7MOj-YC.js';
+import { S as Schema, C as Collection } from './schema-rjBOZk-j.js';
 
 /**
  * Loads various files or configurations from the project.
  *
  * NOTE: This file needs to be loaded through vite's ssrLoadModule so that
- * `import.meta.glob()` calls are resolved.
+ * virtual modules are resolved.
  */
 
 interface SchemaModule {

package/dist/project.js

@@ -3,7 +3,7 @@ import {
   getCollectionSchema,
   getProjectSchemas,
   resolveOneOfPatterns
-} from "./chunk-MSJGHSR6.js";
+} from "./chunk-R4LKO3EZ.js";
 import "./chunk-MLKGABMK.js";
 export {
   SCHEMA_MODULES,

package/dist/{schema-D7MOj-YC.d.ts → schema-rjBOZk-j.d.ts}

@@ -174,6 +174,13 @@ interface SchemaPattern {
 }
 type OneOfField = CommonFieldProps & {
     type: 'oneof';
+    /**
+     * UI variant for the oneOf field.
+     * - `dropdown` (default): A `Select` dropdown for choosing the type.
+     * - `picker`: A `Button` that opens a modal with searchable cards. Use this
+     *   variant when types declare presets or thumbnail images.
+     */
+    variant?: 'dropdown' | 'picker';
     /**
      * Schema types to include in the oneOf field. Can be:
      * - An array of Schema objects
@@ -226,6 +233,25 @@ type Field = StringField | NumberField | DateField | DateTimeField | BooleanFiel
  */
 type FieldWithId = Field;
 type ObjectLikeField = ImageField | FileField | ObjectField | OneOfField | ReferenceField;
+interface SchemaPreset<T = Record<string, any>> {
+    /** Unique identifier for the preset within the schema. */
+    id: string;
+    /** Display title for the preset. Defaults to the preset id. */
+    label?: string;
+    /** Description shown below the title in the picker. */
+    description?: string;
+    /** Thumbnail image (URL or absolute /-path) for the picker. */
+    image?: string;
+    /**
+     * Field values to prefill. Deep-merged into the schema's default value
+     * (preset values override defaults). `_type` is set automatically. The
+     * preset id is NOT persisted — presets are purely a prefill mechanism.
+     *
+     * Pass a generated fields type as the generic parameter `T` to
+     * type-check the keys against the schema's fields.
+     */
+    data?: T;
+}
 interface Schema {
     /** The name of the content type. Used as the field key. */
     name: string;
@@ -233,6 +259,19 @@ interface Schema {
     label?: string;
     /** The description of the content type. Appears in CMS menus. */
     description?: string;
+    /**
+     * Optional thumbnail image (URL or absolute /-path) used to represent this
+     * schema in the picker UI for `oneof` fields with `variant: 'picker'`.
+     */
+    image?: string;
+    /**
+     * Optional preset prefill configurations for use in the picker UI.
+     *
+     * Each preset appears in the picker as a separate selectable card alongside
+     * the schema's "blank" card. Selecting a preset sets `_type` to the schema's
+     * `name` and merges `data` over the schema's default field values.
+     */
+    presets?: SchemaPreset<any>[];
     /** Fields describe the structure of the content. */
     fields: FieldWithId[];
     /** Defines the preview displayed within the CMS UI. Overrides the `preview` definition for the `array` field. */
@@ -267,6 +306,24 @@ type SchemaWithTypes = Schema & {
 declare function defineSchema(schema: Schema): Schema;
 /** Defines the schema for a collection or reusable component. */
 declare const define: typeof defineSchema;
+/**
+ * Defines a preset for use within `schema.define({presets: [...]})`. The
+ * optional generic parameter `T` constrains the shape of the preset's `data`
+ * field. Pass an auto-generated fields type to enable type-safety:
+ *
+ * ```ts
+ * import type {HeroFields} from './generated/types.d.ts';
+ *
+ * schema.definePreset<HeroFields>({
+ *   id: 'big',
+ *   label: 'Big hero',
+ *   data: {title: 'Welcome'},
+ * });
+ * ```
+ */
+declare function definePreset<T = Record<string, any>>(preset: SchemaPreset<T>): SchemaPreset<T>;
+/** Alias for {@link definePreset}. */
+declare const preset: typeof definePreset;
 type Collection = SchemaWithTypes & {
     /**
      * The ID of the collection. This comes from the schema filename, e.g
@@ -410,6 +467,7 @@ type schema_ReferencesField = ReferencesField;
 type schema_RichTextField = RichTextField;
 type schema_Schema = Schema;
 type schema_SchemaPattern = SchemaPattern;
+type schema_SchemaPreset<T = Record<string, any>> = SchemaPreset<T>;
 type schema_SchemaWithTypes = SchemaWithTypes;
 type schema_SelectField = SelectField;
 type schema_StringField = StringField;
@@ -420,6 +478,7 @@ declare const schema_date: typeof date;
 declare const schema_datetime: typeof datetime;
 declare const schema_define: typeof define;
 declare const schema_defineCollection: typeof defineCollection;
+declare const schema_definePreset: typeof definePreset;
 declare const schema_defineSchema: typeof defineSchema;
 declare const schema_file: typeof file;
 declare const schema_glob: typeof glob;
@@ -428,13 +487,14 @@ declare const schema_multiselect: typeof multiselect;
 declare const schema_number: typeof number;
 declare const schema_object: typeof object;
 declare const schema_oneOf: typeof oneOf;
+declare const schema_preset: typeof preset;
 declare const schema_reference: typeof reference;
 declare const schema_references: typeof references;
 declare const schema_richtext: typeof richtext;
 declare const schema_select: typeof select;
 declare const schema_string: typeof string;
 declare namespace schema {
-  export { type schema_ArrayField as ArrayField, type schema_BooleanField as BooleanField, type schema_Collection as Collection, type schema_CommonFieldProps as CommonFieldProps, type schema_DateField as DateField, type schema_DateTimeField as DateTimeField, type schema_Field as Field, type schema_FieldWithId as FieldWithId, type schema_FileField as FileField, type schema_GlobOptions as GlobOptions, type schema_ImageField as ImageField, type schema_MultiSelectField as MultiSelectField, type schema_NumberField as NumberField, type schema_ObjectField as ObjectField, type schema_ObjectLikeField as ObjectLikeField, type schema_OneOfField as OneOfField, type schema_ReferenceField as ReferenceField, type schema_ReferencesField as ReferencesField, type schema_RichTextField as RichTextField, type schema_Schema as Schema, type schema_SchemaPattern as SchemaPattern, type schema_SchemaWithTypes as SchemaWithTypes, type schema_SelectField as SelectField, type schema_StringField as StringField, schema_array as array, schema_boolean as boolean, schema_collection as collection, schema_date as date, schema_datetime as datetime, schema_define as define, schema_defineCollection as defineCollection, schema_defineSchema as defineSchema, schema_file as file, schema_glob as glob, schema_image as image, schema_multiselect as multiselect, schema_number as number, schema_object as object, schema_oneOf as oneOf, schema_reference as reference, schema_references as references, schema_richtext as richtext, schema_select as select, schema_string as string };
+  export { type schema_ArrayField as ArrayField, type schema_BooleanField as BooleanField, type schema_Collection as Collection, type schema_CommonFieldProps as CommonFieldProps, type schema_DateField as DateField, type schema_DateTimeField as DateTimeField, type schema_Field as Field, type schema_FieldWithId as FieldWithId, type schema_FileField as FileField, type schema_GlobOptions as GlobOptions, type schema_ImageField as ImageField, type schema_MultiSelectField as MultiSelectField, type schema_NumberField as NumberField, type schema_ObjectField as ObjectField, type schema_ObjectLikeField as ObjectLikeField, type schema_OneOfField as OneOfField, type schema_ReferenceField as ReferenceField, type schema_ReferencesField as ReferencesField, type schema_RichTextField as RichTextField, type schema_Schema as Schema, type schema_SchemaPattern as SchemaPattern, type schema_SchemaPreset as SchemaPreset, type schema_SchemaWithTypes as SchemaWithTypes, type schema_SelectField as SelectField, type schema_StringField as StringField, schema_array as array, schema_boolean as boolean, schema_collection as collection, schema_date as date, schema_datetime as datetime, schema_define as define, schema_defineCollection as defineCollection, schema_definePreset as definePreset, schema_defineSchema as defineSchema, schema_file as file, schema_glob as glob, schema_image as image, schema_multiselect as multiselect, schema_number as number, schema_object as object, schema_oneOf as oneOf, schema_preset as preset, schema_reference as reference, schema_references as references, schema_richtext as richtext, schema_select as select, schema_string as string };
 }
 
 export { type Collection as C, type Schema as S, schema as s };