@thebes/cadmus 0.3.0 → 0.4.0

package/dist/hono/index.d.cts

@@ -1,4 +1,4 @@
-import { at as LocalApi } from "../index-BRZrCTsN.cjs";
+import { bt as LocalApi } from "../index-sB3YOadC.cjs";
 import { Context, Hono } from "hono";
 
 //#region src/hono/client.d.ts

package/dist/hono/index.d.ts

@@ -1,4 +1,4 @@
-import { at as LocalApi } from "../index-BRZrCTsN.js";
+import { bt as LocalApi } from "../index-sB3YOadC.js";
 import { Context, Hono } from "hono";
 
 //#region src/hono/client.d.ts

package/dist/{index-BRZrCTsN.d.ts → index-sB3YOadC.d.cts}

@@ -180,6 +180,72 @@ declare class CadmusApiError extends CadmusError {
   constructor(message: string, status: number, body: unknown);
 }
 //#endregion
+//#region src/cms/patch.d.ts
+/**
+ * Patch model + field-level diff (issue #14) — adopts Sanity's mutation/patch
+ * idea (pattern, not code): represent a content change as a small set of
+ * field operations, and compute a field-level diff between two document
+ * snapshots. Underpins version-history display (what changed between two
+ * versions) and the content-migration runner (#18), which expresses a
+ * transform's effect as a {@link Patch} and applies it.
+ *
+ * Scope: operations are keyed by **top-level field** (a document's own
+ * fields), matching "field-level diff" — a changed `blocks` array reads as
+ * one changed field, not a deep per-node diff. Deep/array-aware diffing is a
+ * deliberate later extension, not built here.
+ */
+/** A single field operation. `set` writes a value; `unset` removes the field. */
+type PatchOp = {
+  op: "set";
+  path: string;
+  value: JsonValue;
+} | {
+  op: "unset";
+  path: string;
+};
+/** An ordered set of field operations transforming one document into another. */
+type Patch = PatchOp[];
+type FieldChangeKind = "added" | "removed" | "changed";
+/** One field's difference between two document snapshots. */
+interface FieldChange {
+  /** Top-level field key. */
+  path: string;
+  kind: FieldChangeKind;
+  /** Value in the "before" snapshot (absent for `added`). */
+  before?: JsonValue;
+  /** Value in the "after" snapshot (absent for `removed`). */
+  after?: JsonValue;
+}
+type Doc$1 = Record<string, JsonValue>;
+interface DiffOptions {
+  /**
+   * Restrict the diff to these field keys. Omit to diff the union of both
+   * documents' own keys. Useful for ignoring bookkeeping columns
+   * (`id`/`createdAt`/`publishedVersionId`) in a version-history view.
+   */
+  fields?: readonly string[];
+  /** Field keys to skip (e.g. `["id", "createdAt"]`). */
+  ignore?: readonly string[];
+}
+/**
+ * Field-level diff between two document snapshots — the per-field
+ * added/removed/changed list a version-history UI renders. Values are
+ * compared structurally (deep-equal), so a field only shows as `changed`
+ * when its content actually differs.
+ */
+declare function diffDocuments(before: Doc$1, after: Doc$1, options?: DiffOptions): FieldChange[];
+/**
+ * The {@link Patch} that transforms `before` into `after`: `set` for each
+ * added/changed field, `unset` for each removed field. `applyPatch(before,
+ * computePatch(before, after))` deep-equals `after`.
+ */
+declare function computePatch(before: Doc$1, after: Doc$1): Patch;
+/**
+ * Apply a {@link Patch} to a document, returning a new document (the input is
+ * never mutated). Unknown ops are ignored defensively.
+ */
+declare function applyPatch(doc: Doc$1, patch: Patch): Doc$1;
+//#endregion
 //#region src/cms/localApi.d.ts
 type AnyTable$1 = SQLiteTableWithColumns<any>;
 /**
@@ -322,6 +388,13 @@ interface VersionedLocalApi<TTable extends AnyTable$1, TVersionsTable extends An
   publish(context: TContext, versionId: number): Promise<InferSelectModel<TTable>>;
   /** Clears the main row's published pointer; the row's data is untouched. */
   unpublish(context: TContext, id: number): Promise<InferSelectModel<TTable>>;
+  /**
+   * Field-level diff (issue #14) between two version snapshots' `versionData`
+   * — the per-field added/removed/changed list a version-history UI renders.
+   * Both versions must belong to the same parent. Bookkeeping keys
+   * (`id`/`createdAt`/`status`/`publishedVersionId`) are ignored.
+   */
+  diffVersions(context: TContext, fromVersionId: number, toVersionId: number): Promise<FieldChange[]>;
 }
 declare function createVersionedLocalApi<TTable extends AnyTable$1, TVersionsTable extends AnyTable$1, TContext = unknown>(db: BaseSQLiteDatabase<"async", unknown>, table: TTable, versionsTable: TVersionsTable, config: CollectionConfig, registry?: CmsRegistry): VersionedLocalApi<TTable, TVersionsTable, TContext>;
 //#endregion
@@ -987,6 +1060,62 @@ interface CollectionMeta {
 }
 declare function getCollectionsMeta(config: CmsConfig): CollectionMeta[];
 //#endregion
+//#region src/cms/migrate.d.ts
+/**
+ * Content-migration runner (issue #18) — adopts Sanity's `sanity/migrate`
+ * idea (pattern, not code): a versioned, repeatable transform over a
+ * collection's stored documents, for reshaping content when a block/field
+ * type changes (distinct from Drizzle *schema* migrations, which only touch
+ * columns — this reshapes the JSON content inside them).
+ *
+ * A migration declares a per-document `document(doc)` transform; the runner
+ * streams every document, computes the {@link Patch} from old→new (reusing
+ * #14's patch model), and either reports it (`dryRun`) or applies it via the
+ * collection's Local API. Idempotent by construction: a transform that's
+ * already been applied produces an empty patch, so re-running changes
+ * nothing.
+ */
+type Doc = Record<string, JsonValue>;
+interface Migration<TDoc extends Doc = Doc> {
+  /** Stable identifier — name the checked-in migration file after this. */
+  name: string;
+  /**
+   * Transform one document. Return the reshaped document, or `undefined`
+   * (or the unchanged doc) to leave it as-is. Must be pure and idempotent —
+   * applying it twice yields the same result as once.
+   */
+  document: (doc: TDoc) => TDoc | undefined | Promise<TDoc | undefined>;
+}
+/** Identity helper — gives a migration definition its type + a greppable call site. */
+declare function defineMigration<TDoc extends Doc = Doc>(migration: Migration<TDoc>): Migration<TDoc>;
+interface MigrationChange {
+  id: number;
+  patch: Patch;
+}
+interface MigrationResult {
+  migration: string;
+  dryRun: boolean;
+  scanned: number;
+  changed: number;
+  /** Per-document patches (always populated — the dry-run report). */
+  changes: MigrationChange[];
+  errors: string[];
+}
+interface RunMigrationOptions<TContext> {
+  api: LocalApi<any, TContext>;
+  /** Context passed to the Local API's read/update (access + hooks). */
+  context: TContext;
+  /** When true, compute + report patches but write nothing. Default false. */
+  dryRun?: boolean;
+}
+/**
+ * Run a migration over every document in a collection. Reads all documents
+ * through `api.find`, applies `migration.document`, and (unless `dryRun`)
+ * writes the resulting patch through `api.update`. Returns a report of what
+ * changed — run it `dryRun` first, then apply.
+ */
+declare function runMigration<TContext>(migration: Migration, options: RunMigrationOptions<TContext>): Promise<MigrationResult>;
+//#endregion
 //#region src/cms/schema-gen.d.ts
 declare function generateSchemaSource(config: CmsConfig): string;
 //#endregion
@@ -1070,6 +1199,69 @@ interface BuildStudioStructureOptions {
  */
 declare function buildStudioStructure(config: CmsConfig, options?: BuildStudioStructureOptions): StudioStructureGroup[];
 //#endregion
+//#region src/cms/visual-editing.d.ts
+/**
+ * Visual editing / click-to-edit (issue #15) — adopts Sanity's
+ * Presentation/visual-editing idea (pattern, not code): the rendered page
+ * (in a preview context) tags editable regions with the source field they
+ * came from, and an overlay turns those regions into click targets that tell
+ * the studio which field to focus.
+ *
+ * This module ships the two reusable, framework-agnostic primitives:
+ * 1. **Encoding** — `editAttr({ collection, id, field })` produces a data
+ *    attribute the server renderer spreads onto an element; `decodeEditRef`
+ *    reads it back. Pure, testable.
+ * 2. **Overlay** — `mountVisualEditing()` (browser-only; references `document`
+ *    lazily, so importing it server-side is harmless) highlights tagged
+ *    elements on hover and, on click, calls `onSelect` and `postMessage`s the
+ *    ref to the parent window (the studio shell hosting the preview iframe).
+ *
+ * The studio side listens for that message and navigates to
+ * `/admin/<collection>/<id>` (and may focus `<field>`); that wiring is
+ * consumer-side and not prescribed here.
+ */
+/** A reference from a rendered region back to the field that produced it. */
+interface EditRef {
+  collection: string;
+  id: number;
+  field: string;
+}
+/** The data attribute editable regions are tagged with. */
+declare const EDIT_ATTR = "data-cadmus-edit";
+/** `postMessage` payload type for a click-to-edit selection. */
+declare const VISUAL_EDIT_MESSAGE = "cadmus:visual-edit";
+declare function encodeEditRef(ref: EditRef): string;
+/** Parse an {@link EditRef} string, or null if malformed. */
+declare function decodeEditRef(value: string): EditRef | null;
+/**
+ * Attribute object to spread onto a rendered element so the overlay can map
+ * it back to its source field, e.g. `<h1 {...editAttr({collection:'pages',
+ * id, field:'title'})}>`.
+ */
+declare function editAttr(ref: EditRef): Record<string, string>;
+interface VisualEditingMessage {
+  type: typeof VISUAL_EDIT_MESSAGE;
+  ref: EditRef;
+}
+interface VisualEditingOptions {
+  /** Called with the decoded ref when an editable region is clicked. */
+  onSelect?: (ref: EditRef, element: Element) => void;
+  /**
+   * Origin to `postMessage` the selection to the parent window. Default
+   * `"*"`. Set to the studio origin in production.
+   */
+  targetOrigin?: string;
+  /** Outline color for the hover highlight. Default a teal accent. */
+  highlightColor?: string;
+}
+/**
+ * Mount the click-to-edit overlay. Browser-only — call from a preview page's
+ * client script. Highlights `[data-cadmus-edit]` elements on hover and, on
+ * click, calls `onSelect` and posts a {@link VisualEditingMessage} to the
+ * parent window. Returns a cleanup function that removes the listeners.
+ */
+declare function mountVisualEditing(options?: VisualEditingOptions): () => void;
+//#endregion
 //#region src/cms/webhooks.d.ts
 interface WebhookConfig {
   /** Endpoint this webhook POSTs to on every matching event. */
@@ -1108,5 +1300,5 @@ declare function createWebhookHook(queue: Queue<WebhookMessage>, config: Webhook
  */
 declare function deliverWebhookMessage(message: WebhookMessage): Promise<void>;
 //#endregion
-export { ValidationSeverity as $, CollectionConfig as A, RichTextFieldConfig as B, ArrayFieldConfig as C, CadmusValidationError as Ct, CmsConfig as D, StringBlockRenderer as Dt, CheckboxFieldConfig as E, PortableBlockLike as Et, JsonFieldConfig as F, flattenFields as G, TextFieldConfig as H, JsonValue as I, CustomValidatorResult as J, nestDoc as K, NumberFieldConfig as L, DateFieldConfig as M, FieldConfig as N, CollectionAccess as O, createBlockRegistry as Ot, GroupFieldConfig as P, ValidationFieldContext as Q, RelationshipDepth as R, AccessFn as S, CadmusStorageError as St, CadmeaPlugin as T, BlockRegistry as Tt, UploadFieldConfig as U, SelectFieldConfig as V, flattenDoc as W, ValidateDocumentOptions as X, Rule as Y, ValidationBuilder as Z, collectionSearchTableSQL as _, CadmusEmailError as _t, BuildStudioStructureOptions as a, LocalApi as at, extractSearchText as b, CadmusRateLimitError as bt, StudioStructureItem as c, createLocalApi as ct, CollectionMeta as d, CadmusAccessDeniedError as dt, assertValid as et, getCollectionsMeta as f, CadmusApiError as ft, collectionSearchTableName as g, CadmusDbError as gt, cmsConfigToSchema as h, CadmusCmsError as ht, deliverWebhookMessage as i, CmsRegistry as it, CollectionHooks as j, CollectionAdminConfig as k, renderBlocksToString as kt, buildStudioStructure as l, createVersionedLocalApi as lt, defineCollection as m, CadmusCacheError as mt, WebhookMessage as n, rule as nt, DEFAULT_STUDIO_GROUP as o, VersionedLocalApi as ot, defineCmsConfig as p, CadmusAuthError as pt, CustomValidator as q, createWebhookHook as r, validateDocument as rt, StudioStructureGroup as s, can as st, WebhookConfig as t, defineField as tt, generateSchemaSource as u, getRegisteredApi as ut, collectionToTable as v, CadmusError as vt, BaseFieldConfig as w, ValidationViolation as wt, relationshipJoinTables as x, CadmusSessionError as xt, collectionVersionsTable as y, CadmusQueueError as yt, RelationshipFieldConfig as z };
-//# sourceMappingURL=index-BRZrCTsN.d.ts.map
+export { RelationshipDepth as $, cmsConfigToSchema as A, PatchOp as At, CadmeaPlugin as B, CadmusEmailError as Bt, RunMigrationOptions as C, createLocalApi as Ct, getCollectionsMeta as D, FieldChange as Dt, CollectionMeta as E, DiffOptions as Et, extractSearchText as F, CadmusApiError as Ft, CollectionConfig as G, CadmusStorageError as Gt, CmsConfig as H, CadmusQueueError as Ht, relationshipJoinTables as I, CadmusAuthError as It, FieldConfig as J, BlockRegistry as Jt, CollectionHooks as K, CadmusValidationError as Kt, AccessFn as L, CadmusCacheError as Lt, collectionSearchTableSQL as M, computePatch as Mt, collectionToTable as N, diffDocuments as Nt, defineCmsConfig as O, FieldChangeKind as Ot, collectionVersionsTable as P, CadmusAccessDeniedError as Pt, NumberFieldConfig as Q, renderBlocksToString as Qt, ArrayFieldConfig as R, CadmusCmsError as Rt, MigrationResult as S, can as St, runMigration as T, getRegisteredApi as Tt, CollectionAccess as U, CadmusRateLimitError as Ut, CheckboxFieldConfig as V, CadmusError as Vt, CollectionAdminConfig as W, CadmusSessionError as Wt, JsonFieldConfig as X, StringBlockRenderer as Xt, GroupFieldConfig as Y, PortableBlockLike as Yt, JsonValue as Z, createBlockRegistry as Zt, StudioStructureItem as _, rule as _t, EDIT_ATTR as a, flattenDoc as at, Migration as b, LocalApi as bt, VisualEditingMessage as c, CustomValidator as ct, editAttr as d, ValidateDocumentOptions as dt, RelationshipFieldConfig as et, encodeEditRef as f, ValidationBuilder as ft, StudioStructureGroup as g, defineField as gt, DEFAULT_STUDIO_GROUP as h, assertValid as ht, deliverWebhookMessage as i, UploadFieldConfig as it, collectionSearchTableName as j, applyPatch as jt, defineCollection as k, Patch as kt, VisualEditingOptions as l, CustomValidatorResult as lt, BuildStudioStructureOptions as m, ValidationSeverity as mt, WebhookMessage as n, SelectFieldConfig as nt, EditRef as o, flattenFields as ot, mountVisualEditing as p, ValidationFieldContext as pt, DateFieldConfig as q, ValidationViolation as qt, createWebhookHook as r, TextFieldConfig as rt, VISUAL_EDIT_MESSAGE as s, nestDoc as st, WebhookConfig as t, RichTextFieldConfig as tt, decodeEditRef as u, Rule as ut, buildStudioStructure as v, validateDocument as vt, defineMigration as w, createVersionedLocalApi as wt, MigrationChange as x, VersionedLocalApi as xt, generateSchemaSource as y, CmsRegistry as yt, BaseFieldConfig as z, CadmusDbError as zt };
+//# sourceMappingURL=index-sB3YOadC.d.cts.map

package/dist/index-sB3YOadC.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-sB3YOadC.d.cts","names":[],"sources":["../src/cms/blocks.ts","../src/errors.ts","../src/cms/patch.ts","../src/cms/localApi.ts","../src/cms/validation.ts","../src/cms/types.ts","../src/cms/codegen.ts","../src/cms/defineCollection.ts","../src/cms/meta.ts","../src/cms/migrate.ts","../src/cms/schema-gen.ts","../src/cms/structure.ts","../src/cms/visual-editing.ts","../src/cms/webhooks.ts"],"mappings":"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"}

package/dist/{index-BRZrCTsN.d.cts → index-sB3YOadC.d.ts}

@@ -180,6 +180,72 @@ declare class CadmusApiError extends CadmusError {
   constructor(message: string, status: number, body: unknown);
 }
 //#endregion
+//#region src/cms/patch.d.ts
+/**
+ * Patch model + field-level diff (issue #14) — adopts Sanity's mutation/patch
+ * idea (pattern, not code): represent a content change as a small set of
+ * field operations, and compute a field-level diff between two document
+ * snapshots. Underpins version-history display (what changed between two
+ * versions) and the content-migration runner (#18), which expresses a
+ * transform's effect as a {@link Patch} and applies it.
+ *
+ * Scope: operations are keyed by **top-level field** (a document's own
+ * fields), matching "field-level diff" — a changed `blocks` array reads as
+ * one changed field, not a deep per-node diff. Deep/array-aware diffing is a
+ * deliberate later extension, not built here.
+ */
+/** A single field operation. `set` writes a value; `unset` removes the field. */
+type PatchOp = {
+  op: "set";
+  path: string;
+  value: JsonValue;
+} | {
+  op: "unset";
+  path: string;
+};
+/** An ordered set of field operations transforming one document into another. */
+type Patch = PatchOp[];
+type FieldChangeKind = "added" | "removed" | "changed";
+/** One field's difference between two document snapshots. */
+interface FieldChange {
+  /** Top-level field key. */
+  path: string;
+  kind: FieldChangeKind;
+  /** Value in the "before" snapshot (absent for `added`). */
+  before?: JsonValue;
+  /** Value in the "after" snapshot (absent for `removed`). */
+  after?: JsonValue;
+}
+type Doc$1 = Record<string, JsonValue>;
+interface DiffOptions {
+  /**
+   * Restrict the diff to these field keys. Omit to diff the union of both
+   * documents' own keys. Useful for ignoring bookkeeping columns
+   * (`id`/`createdAt`/`publishedVersionId`) in a version-history view.
+   */
+  fields?: readonly string[];
+  /** Field keys to skip (e.g. `["id", "createdAt"]`). */
+  ignore?: readonly string[];
+}
+/**
+ * Field-level diff between two document snapshots — the per-field
+ * added/removed/changed list a version-history UI renders. Values are
+ * compared structurally (deep-equal), so a field only shows as `changed`
+ * when its content actually differs.
+ */
+declare function diffDocuments(before: Doc$1, after: Doc$1, options?: DiffOptions): FieldChange[];
+/**
+ * The {@link Patch} that transforms `before` into `after`: `set` for each
+ * added/changed field, `unset` for each removed field. `applyPatch(before,
+ * computePatch(before, after))` deep-equals `after`.
+ */
+declare function computePatch(before: Doc$1, after: Doc$1): Patch;
+/**
+ * Apply a {@link Patch} to a document, returning a new document (the input is
+ * never mutated). Unknown ops are ignored defensively.
+ */
+declare function applyPatch(doc: Doc$1, patch: Patch): Doc$1;
+//#endregion
 //#region src/cms/localApi.d.ts
 type AnyTable$1 = SQLiteTableWithColumns<any>;
 /**
@@ -322,6 +388,13 @@ interface VersionedLocalApi<TTable extends AnyTable$1, TVersionsTable extends An
   publish(context: TContext, versionId: number): Promise<InferSelectModel<TTable>>;
   /** Clears the main row's published pointer; the row's data is untouched. */
   unpublish(context: TContext, id: number): Promise<InferSelectModel<TTable>>;
+  /**
+   * Field-level diff (issue #14) between two version snapshots' `versionData`
+   * — the per-field added/removed/changed list a version-history UI renders.
+   * Both versions must belong to the same parent. Bookkeeping keys
+   * (`id`/`createdAt`/`status`/`publishedVersionId`) are ignored.
+   */
+  diffVersions(context: TContext, fromVersionId: number, toVersionId: number): Promise<FieldChange[]>;
 }
 declare function createVersionedLocalApi<TTable extends AnyTable$1, TVersionsTable extends AnyTable$1, TContext = unknown>(db: BaseSQLiteDatabase<"async", unknown>, table: TTable, versionsTable: TVersionsTable, config: CollectionConfig, registry?: CmsRegistry): VersionedLocalApi<TTable, TVersionsTable, TContext>;
 //#endregion
@@ -987,6 +1060,62 @@ interface CollectionMeta {
 }
 declare function getCollectionsMeta(config: CmsConfig): CollectionMeta[];
 //#endregion
+//#region src/cms/migrate.d.ts
+/**
+ * Content-migration runner (issue #18) — adopts Sanity's `sanity/migrate`
+ * idea (pattern, not code): a versioned, repeatable transform over a
+ * collection's stored documents, for reshaping content when a block/field
+ * type changes (distinct from Drizzle *schema* migrations, which only touch
+ * columns — this reshapes the JSON content inside them).
+ *
+ * A migration declares a per-document `document(doc)` transform; the runner
+ * streams every document, computes the {@link Patch} from old→new (reusing
+ * #14's patch model), and either reports it (`dryRun`) or applies it via the
+ * collection's Local API. Idempotent by construction: a transform that's
+ * already been applied produces an empty patch, so re-running changes
+ * nothing.
+ */
+type Doc = Record<string, JsonValue>;
+interface Migration<TDoc extends Doc = Doc> {
+  /** Stable identifier — name the checked-in migration file after this. */
+  name: string;
+  /**
+   * Transform one document. Return the reshaped document, or `undefined`
+   * (or the unchanged doc) to leave it as-is. Must be pure and idempotent —
+   * applying it twice yields the same result as once.
+   */
+  document: (doc: TDoc) => TDoc | undefined | Promise<TDoc | undefined>;
+}
+/** Identity helper — gives a migration definition its type + a greppable call site. */
+declare function defineMigration<TDoc extends Doc = Doc>(migration: Migration<TDoc>): Migration<TDoc>;
+interface MigrationChange {
+  id: number;
+  patch: Patch;
+}
+interface MigrationResult {
+  migration: string;
+  dryRun: boolean;
+  scanned: number;
+  changed: number;
+  /** Per-document patches (always populated — the dry-run report). */
+  changes: MigrationChange[];
+  errors: string[];
+}
+interface RunMigrationOptions<TContext> {
+  api: LocalApi<any, TContext>;
+  /** Context passed to the Local API's read/update (access + hooks). */
+  context: TContext;
+  /** When true, compute + report patches but write nothing. Default false. */
+  dryRun?: boolean;
+}
+/**
+ * Run a migration over every document in a collection. Reads all documents
+ * through `api.find`, applies `migration.document`, and (unless `dryRun`)
+ * writes the resulting patch through `api.update`. Returns a report of what
+ * changed — run it `dryRun` first, then apply.
+ */
+declare function runMigration<TContext>(migration: Migration, options: RunMigrationOptions<TContext>): Promise<MigrationResult>;
+//#endregion
 //#region src/cms/schema-gen.d.ts
 declare function generateSchemaSource(config: CmsConfig): string;
 //#endregion
@@ -1070,6 +1199,69 @@ interface BuildStudioStructureOptions {
  */
 declare function buildStudioStructure(config: CmsConfig, options?: BuildStudioStructureOptions): StudioStructureGroup[];
 //#endregion
+//#region src/cms/visual-editing.d.ts
+/**
+ * Visual editing / click-to-edit (issue #15) — adopts Sanity's
+ * Presentation/visual-editing idea (pattern, not code): the rendered page
+ * (in a preview context) tags editable regions with the source field they
+ * came from, and an overlay turns those regions into click targets that tell
+ * the studio which field to focus.
+ *
+ * This module ships the two reusable, framework-agnostic primitives:
+ * 1. **Encoding** — `editAttr({ collection, id, field })` produces a data
+ *    attribute the server renderer spreads onto an element; `decodeEditRef`
+ *    reads it back. Pure, testable.
+ * 2. **Overlay** — `mountVisualEditing()` (browser-only; references `document`
+ *    lazily, so importing it server-side is harmless) highlights tagged
+ *    elements on hover and, on click, calls `onSelect` and `postMessage`s the
+ *    ref to the parent window (the studio shell hosting the preview iframe).
+ *
+ * The studio side listens for that message and navigates to
+ * `/admin/<collection>/<id>` (and may focus `<field>`); that wiring is
+ * consumer-side and not prescribed here.
+ */
+/** A reference from a rendered region back to the field that produced it. */
+interface EditRef {
+  collection: string;
+  id: number;
+  field: string;
+}
+/** The data attribute editable regions are tagged with. */
+declare const EDIT_ATTR = "data-cadmus-edit";
+/** `postMessage` payload type for a click-to-edit selection. */
+declare const VISUAL_EDIT_MESSAGE = "cadmus:visual-edit";
+declare function encodeEditRef(ref: EditRef): string;
+/** Parse an {@link EditRef} string, or null if malformed. */
+declare function decodeEditRef(value: string): EditRef | null;
+/**
+ * Attribute object to spread onto a rendered element so the overlay can map
+ * it back to its source field, e.g. `<h1 {...editAttr({collection:'pages',
+ * id, field:'title'})}>`.
+ */
+declare function editAttr(ref: EditRef): Record<string, string>;
+interface VisualEditingMessage {
+  type: typeof VISUAL_EDIT_MESSAGE;
+  ref: EditRef;
+}
+interface VisualEditingOptions {
+  /** Called with the decoded ref when an editable region is clicked. */
+  onSelect?: (ref: EditRef, element: Element) => void;
+  /**
+   * Origin to `postMessage` the selection to the parent window. Default
+   * `"*"`. Set to the studio origin in production.
+   */
+  targetOrigin?: string;
+  /** Outline color for the hover highlight. Default a teal accent. */
+  highlightColor?: string;
+}
+/**
+ * Mount the click-to-edit overlay. Browser-only — call from a preview page's
+ * client script. Highlights `[data-cadmus-edit]` elements on hover and, on
+ * click, calls `onSelect` and posts a {@link VisualEditingMessage} to the
+ * parent window. Returns a cleanup function that removes the listeners.
+ */
+declare function mountVisualEditing(options?: VisualEditingOptions): () => void;
+//#endregion
 //#region src/cms/webhooks.d.ts
 interface WebhookConfig {
   /** Endpoint this webhook POSTs to on every matching event. */
@@ -1108,5 +1300,5 @@ declare function createWebhookHook(queue: Queue<WebhookMessage>, config: Webhook
  */
 declare function deliverWebhookMessage(message: WebhookMessage): Promise<void>;
 //#endregion
-export { ValidationSeverity as $, CollectionConfig as A, RichTextFieldConfig as B, ArrayFieldConfig as C, CadmusValidationError as Ct, CmsConfig as D, StringBlockRenderer as Dt, CheckboxFieldConfig as E, PortableBlockLike as Et, JsonFieldConfig as F, flattenFields as G, TextFieldConfig as H, JsonValue as I, CustomValidatorResult as J, nestDoc as K, NumberFieldConfig as L, DateFieldConfig as M, FieldConfig as N, CollectionAccess as O, createBlockRegistry as Ot, GroupFieldConfig as P, ValidationFieldContext as Q, RelationshipDepth as R, AccessFn as S, CadmusStorageError as St, CadmeaPlugin as T, BlockRegistry as Tt, UploadFieldConfig as U, SelectFieldConfig as V, flattenDoc as W, ValidateDocumentOptions as X, Rule as Y, ValidationBuilder as Z, collectionSearchTableSQL as _, CadmusEmailError as _t, BuildStudioStructureOptions as a, LocalApi as at, extractSearchText as b, CadmusRateLimitError as bt, StudioStructureItem as c, createLocalApi as ct, CollectionMeta as d, CadmusAccessDeniedError as dt, assertValid as et, getCollectionsMeta as f, CadmusApiError as ft, collectionSearchTableName as g, CadmusDbError as gt, cmsConfigToSchema as h, CadmusCmsError as ht, deliverWebhookMessage as i, CmsRegistry as it, CollectionHooks as j, CollectionAdminConfig as k, renderBlocksToString as kt, buildStudioStructure as l, createVersionedLocalApi as lt, defineCollection as m, CadmusCacheError as mt, WebhookMessage as n, rule as nt, DEFAULT_STUDIO_GROUP as o, VersionedLocalApi as ot, defineCmsConfig as p, CadmusAuthError as pt, CustomValidator as q, createWebhookHook as r, validateDocument as rt, StudioStructureGroup as s, can as st, WebhookConfig as t, defineField as tt, generateSchemaSource as u, getRegisteredApi as ut, collectionToTable as v, CadmusError as vt, BaseFieldConfig as w, ValidationViolation as wt, relationshipJoinTables as x, CadmusSessionError as xt, collectionVersionsTable as y, CadmusQueueError as yt, RelationshipFieldConfig as z };
-//# sourceMappingURL=index-BRZrCTsN.d.cts.map
+export { RelationshipDepth as $, cmsConfigToSchema as A, PatchOp as At, CadmeaPlugin as B, CadmusEmailError as Bt, RunMigrationOptions as C, createLocalApi as Ct, getCollectionsMeta as D, FieldChange as Dt, CollectionMeta as E, DiffOptions as Et, extractSearchText as F, CadmusApiError as Ft, CollectionConfig as G, CadmusStorageError as Gt, CmsConfig as H, CadmusQueueError as Ht, relationshipJoinTables as I, CadmusAuthError as It, FieldConfig as J, BlockRegistry as Jt, CollectionHooks as K, CadmusValidationError as Kt, AccessFn as L, CadmusCacheError as Lt, collectionSearchTableSQL as M, computePatch as Mt, collectionToTable as N, diffDocuments as Nt, defineCmsConfig as O, FieldChangeKind as Ot, collectionVersionsTable as P, CadmusAccessDeniedError as Pt, NumberFieldConfig as Q, renderBlocksToString as Qt, ArrayFieldConfig as R, CadmusCmsError as Rt, MigrationResult as S, can as St, runMigration as T, getRegisteredApi as Tt, CollectionAccess as U, CadmusRateLimitError as Ut, CheckboxFieldConfig as V, CadmusError as Vt, CollectionAdminConfig as W, CadmusSessionError as Wt, JsonFieldConfig as X, StringBlockRenderer as Xt, GroupFieldConfig as Y, PortableBlockLike as Yt, JsonValue as Z, createBlockRegistry as Zt, StudioStructureItem as _, rule as _t, EDIT_ATTR as a, flattenDoc as at, Migration as b, LocalApi as bt, VisualEditingMessage as c, CustomValidator as ct, editAttr as d, ValidateDocumentOptions as dt, RelationshipFieldConfig as et, encodeEditRef as f, ValidationBuilder as ft, StudioStructureGroup as g, defineField as gt, DEFAULT_STUDIO_GROUP as h, assertValid as ht, deliverWebhookMessage as i, UploadFieldConfig as it, collectionSearchTableName as j, applyPatch as jt, defineCollection as k, Patch as kt, VisualEditingOptions as l, CustomValidatorResult as lt, BuildStudioStructureOptions as m, ValidationSeverity as mt, WebhookMessage as n, SelectFieldConfig as nt, EditRef as o, flattenFields as ot, mountVisualEditing as p, ValidationFieldContext as pt, DateFieldConfig as q, ValidationViolation as qt, createWebhookHook as r, TextFieldConfig as rt, VISUAL_EDIT_MESSAGE as s, nestDoc as st, WebhookConfig as t, RichTextFieldConfig as tt, decodeEditRef as u, Rule as ut, buildStudioStructure as v, validateDocument as vt, defineMigration as w, createVersionedLocalApi as wt, MigrationChange as x, VersionedLocalApi as xt, generateSchemaSource as y, CmsRegistry as yt, BaseFieldConfig as z, CadmusDbError as zt };
+//# sourceMappingURL=index-sB3YOadC.d.ts.map

package/dist/index-sB3YOadC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-sB3YOadC.d.ts","names":[],"sources":["../src/cms/blocks.ts","../src/errors.ts","../src/cms/patch.ts","../src/cms/localApi.ts","../src/cms/validation.ts","../src/cms/types.ts","../src/cms/codegen.ts","../src/cms/defineCollection.ts","../src/cms/meta.ts","../src/cms/migrate.ts","../src/cms/schema-gen.ts","../src/cms/structure.ts","../src/cms/visual-editing.ts","../src/cms/webhooks.ts"],"mappings":"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"}

package/dist/index.cjs

@@ -23,9 +23,12 @@ exports.CadmusSessionError = require_errors.CadmusSessionError;
 exports.CadmusStorageError = require_errors.CadmusStorageError;
 exports.CadmusValidationError = require_errors.CadmusValidationError;
 exports.DEFAULT_STUDIO_GROUP = require_cms_index.DEFAULT_STUDIO_GROUP;
+exports.EDIT_ATTR = require_cms_index.EDIT_ATTR;
 exports.IMAGE_MIME_WHITELIST = require_storage_index.IMAGE_MIME_WHITELIST;
 exports.MAX_IMAGE_UPLOAD_BYTES = require_storage_index.MAX_IMAGE_UPLOAD_BYTES;
 exports.Rule = require_cms_index.Rule;
+exports.VISUAL_EDIT_MESSAGE = require_cms_index.VISUAL_EDIT_MESSAGE;
+exports.applyPatch = require_cms_index.applyPatch;
 exports.assertValid = require_cms_index.assertValid;
 exports.buildStudioStructure = require_cms_index.buildStudioStructure;
 exports.can = require_cms_index.can;
@@ -35,17 +38,23 @@ exports.collectionSearchTableName = require_cms_index.collectionSearchTableName;
 exports.collectionSearchTableSQL = require_cms_index.collectionSearchTableSQL;
 exports.collectionToTable = require_cms_index.collectionToTable;
 exports.collectionVersionsTable = require_cms_index.collectionVersionsTable;
+exports.computePatch = require_cms_index.computePatch;
 exports.createBlockRegistry = require_cms_index.createBlockRegistry;
 exports.createLocalApi = require_cms_index.createLocalApi;
 exports.createSession = require_session_index.createSession;
 exports.createVersionedLocalApi = require_cms_index.createVersionedLocalApi;
 exports.createWebhookHook = require_cms_index.createWebhookHook;
 exports.db = require_db_index.db;
+exports.decodeEditRef = require_cms_index.decodeEditRef;
 exports.defineCmsConfig = require_cms_index.defineCmsConfig;
 exports.defineCollection = require_cms_index.defineCollection;
 exports.defineField = require_cms_index.defineField;
+exports.defineMigration = require_cms_index.defineMigration;
 exports.deleteSession = require_session_index.deleteSession;
 exports.deliverWebhookMessage = require_cms_index.deliverWebhookMessage;
+exports.diffDocuments = require_cms_index.diffDocuments;
+exports.editAttr = require_cms_index.editAttr;
+exports.encodeEditRef = require_cms_index.encodeEditRef;
 exports.enqueue = require_queues_index.enqueue;
 exports.extractSearchText = require_cms_index.extractSearchText;
 exports.flattenDoc = require_cms_index.flattenDoc;
@@ -57,12 +66,14 @@ exports.getCollectionsMeta = require_cms_index.getCollectionsMeta;
 exports.getRegisteredApi = require_cms_index.getRegisteredApi;
 exports.getSession = require_session_index.getSession;
 exports.hashToken = require_auth_index.hashToken;
+exports.mountVisualEditing = require_cms_index.mountVisualEditing;
 exports.nestDoc = require_cms_index.nestDoc;
 exports.processBatch = require_queues_index.processBatch;
 exports.purgeCache = require_cache_index.purgeCache;
 exports.relationshipJoinTables = require_cms_index.relationshipJoinTables;
 exports.renderBlocksToString = require_cms_index.renderBlocksToString;
 exports.rule = require_cms_index.rule;
+exports.runMigration = require_cms_index.runMigration;
 exports.sendEmail = require_email_index.sendEmail;
 exports.signSession = require_auth_index.signSession;
 exports.validateDocument = require_cms_index.validateDocument;

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import { generateSessionId, generateToken, hashToken, signSession, verifySession } from "./auth/index.cjs";
 import { purgeCache } from "./cache/index.cjs";
-import { $ as ValidationSeverity, A as CollectionConfig, B as RichTextFieldConfig, C as ArrayFieldConfig, Ct as CadmusValidationError, D as CmsConfig, Dt as StringBlockRenderer, E as CheckboxFieldConfig, Et as PortableBlockLike, F as JsonFieldConfig, G as flattenFields, H as TextFieldConfig, I as JsonValue, J as CustomValidatorResult, K as nestDoc, L as NumberFieldConfig, M as DateFieldConfig, N as FieldConfig, O as CollectionAccess, Ot as createBlockRegistry, P as GroupFieldConfig, Q as ValidationFieldContext, R as RelationshipDepth, S as AccessFn, St as CadmusStorageError, T as CadmeaPlugin, Tt as BlockRegistry, U as UploadFieldConfig, V as SelectFieldConfig, W as flattenDoc, X as ValidateDocumentOptions, Y as Rule, Z as ValidationBuilder, _ as collectionSearchTableSQL, _t as CadmusEmailError, a as BuildStudioStructureOptions, at as LocalApi, b as extractSearchText, bt as CadmusRateLimitError, c as StudioStructureItem, ct as createLocalApi, d as CollectionMeta, dt as CadmusAccessDeniedError, et as assertValid, f as getCollectionsMeta, ft as CadmusApiError, g as collectionSearchTableName, gt as CadmusDbError, h as cmsConfigToSchema, ht as CadmusCmsError, i as deliverWebhookMessage, it as CmsRegistry, j as CollectionHooks, k as CollectionAdminConfig, kt as renderBlocksToString, l as buildStudioStructure, lt as createVersionedLocalApi, m as defineCollection, mt as CadmusCacheError, n as WebhookMessage, nt as rule, o as DEFAULT_STUDIO_GROUP, ot as VersionedLocalApi, p as defineCmsConfig, pt as CadmusAuthError, q as CustomValidator, r as createWebhookHook, rt as validateDocument, s as StudioStructureGroup, st as can, t as WebhookConfig, tt as defineField, u as generateSchemaSource, ut as getRegisteredApi, v as collectionToTable, vt as CadmusError, w as BaseFieldConfig, wt as ValidationViolation, x as relationshipJoinTables, xt as CadmusSessionError, y as collectionVersionsTable, yt as CadmusQueueError, z as RelationshipFieldConfig } from "./index-BRZrCTsN.cjs";
+import { $ as RelationshipDepth, A as cmsConfigToSchema, At as PatchOp, B as CadmeaPlugin, Bt as CadmusEmailError, C as RunMigrationOptions, Ct as createLocalApi, D as getCollectionsMeta, Dt as FieldChange, E as CollectionMeta, Et as DiffOptions, F as extractSearchText, Ft as CadmusApiError, G as CollectionConfig, Gt as CadmusStorageError, H as CmsConfig, Ht as CadmusQueueError, I as relationshipJoinTables, It as CadmusAuthError, J as FieldConfig, Jt as BlockRegistry, K as CollectionHooks, Kt as CadmusValidationError, L as AccessFn, Lt as CadmusCacheError, M as collectionSearchTableSQL, Mt as computePatch, N as collectionToTable, Nt as diffDocuments, O as defineCmsConfig, Ot as FieldChangeKind, P as collectionVersionsTable, Pt as CadmusAccessDeniedError, Q as NumberFieldConfig, Qt as renderBlocksToString, R as ArrayFieldConfig, Rt as CadmusCmsError, S as MigrationResult, St as can, T as runMigration, Tt as getRegisteredApi, U as CollectionAccess, Ut as CadmusRateLimitError, V as CheckboxFieldConfig, Vt as CadmusError, W as CollectionAdminConfig, Wt as CadmusSessionError, X as JsonFieldConfig, Xt as StringBlockRenderer, Y as GroupFieldConfig, Yt as PortableBlockLike, Z as JsonValue, Zt as createBlockRegistry, _ as StudioStructureItem, _t as rule, a as EDIT_ATTR, at as flattenDoc, b as Migration, bt as LocalApi, c as VisualEditingMessage, ct as CustomValidator, d as editAttr, dt as ValidateDocumentOptions, et as RelationshipFieldConfig, f as encodeEditRef, ft as ValidationBuilder, g as StudioStructureGroup, gt as defineField, h as DEFAULT_STUDIO_GROUP, ht as assertValid, i as deliverWebhookMessage, it as UploadFieldConfig, j as collectionSearchTableName, jt as applyPatch, k as defineCollection, kt as Patch, l as VisualEditingOptions, lt as CustomValidatorResult, m as BuildStudioStructureOptions, mt as ValidationSeverity, n as WebhookMessage, nt as SelectFieldConfig, o as EditRef, ot as flattenFields, p as mountVisualEditing, pt as ValidationFieldContext, q as DateFieldConfig, qt as ValidationViolation, r as createWebhookHook, rt as TextFieldConfig, s as VISUAL_EDIT_MESSAGE, st as nestDoc, t as WebhookConfig, tt as RichTextFieldConfig, u as decodeEditRef, ut as Rule, v as buildStudioStructure, vt as validateDocument, w as defineMigration, wt as createVersionedLocalApi, x as MigrationChange, xt as VersionedLocalApi, y as generateSchemaSource, yt as CmsRegistry, z as BaseFieldConfig, zt as CadmusDbError } from "./index-sB3YOadC.cjs";
 import { db } from "./db/index.cjs";
 import { SendEmailInput, sendEmail } from "./email/index.cjs";
 import { QueueMessageHandler, enqueue, processBatch } from "./queues/index.cjs";
 import { RateLimitResult, checkRateLimit } from "./rate-limit/index.cjs";
 import { createSession, deleteSession, getSession } from "./session/index.cjs";
-import { IMAGE_MIME_WHITELIST, ImageService, MAX_IMAGE_UPLOAD_BYTES, RenderedImage, validateImageFile } from "./storage/index.cjs";
+import { IMAGE_MIME_WHITELIST, ImageCrop, ImageHotspot, ImageService, MAX_IMAGE_UPLOAD_BYTES, RenderedImage, validateImageFile } from "./storage/index.cjs";
 
 //#region src/index.d.ts
 interface CadmusEnv {
@@ -17,5 +17,5 @@ interface CadmusEnv {
   SESSION_SECRET: string;
 }
 //#endregion
-export { AccessFn, ArrayFieldConfig, BaseFieldConfig, BlockRegistry, BuildStudioStructureOptions, CadmeaPlugin, CadmusAccessDeniedError, CadmusApiError, CadmusAuthError, CadmusCacheError, CadmusCmsError, CadmusDbError, CadmusEmailError, CadmusEnv, CadmusError, CadmusQueueError, CadmusRateLimitError, CadmusSessionError, CadmusStorageError, CadmusValidationError, CheckboxFieldConfig, CmsConfig, CmsRegistry, CollectionAccess, CollectionAdminConfig, CollectionConfig, CollectionHooks, CollectionMeta, CustomValidator, CustomValidatorResult, DEFAULT_STUDIO_GROUP, DateFieldConfig, FieldConfig, GroupFieldConfig, IMAGE_MIME_WHITELIST, ImageService, JsonFieldConfig, JsonValue, LocalApi, MAX_IMAGE_UPLOAD_BYTES, NumberFieldConfig, PortableBlockLike, QueueMessageHandler, RateLimitResult, RelationshipDepth, RelationshipFieldConfig, RenderedImage, RichTextFieldConfig, Rule, SelectFieldConfig, SendEmailInput, StringBlockRenderer, StudioStructureGroup, StudioStructureItem, TextFieldConfig, UploadFieldConfig, ValidateDocumentOptions, ValidationBuilder, ValidationFieldContext, ValidationSeverity, ValidationViolation, VersionedLocalApi, WebhookConfig, WebhookMessage, assertValid, buildStudioStructure, can, checkRateLimit, cmsConfigToSchema, collectionSearchTableName, collectionSearchTableSQL, collectionToTable, collectionVersionsTable, createBlockRegistry, createLocalApi, createSession, createVersionedLocalApi, createWebhookHook, db, defineCmsConfig, defineCollection, defineField, deleteSession, deliverWebhookMessage, enqueue, extractSearchText, flattenDoc, flattenFields, generateSchemaSource, generateSessionId, generateToken, getCollectionsMeta, getRegisteredApi, getSession, hashToken, nestDoc, processBatch, purgeCache, relationshipJoinTables, renderBlocksToString, rule, sendEmail, signSession, validateDocument, validateImageFile, verifySession };
+export { AccessFn, ArrayFieldConfig, BaseFieldConfig, BlockRegistry, BuildStudioStructureOptions, CadmeaPlugin, CadmusAccessDeniedError, CadmusApiError, CadmusAuthError, CadmusCacheError, CadmusCmsError, CadmusDbError, CadmusEmailError, CadmusEnv, CadmusError, CadmusQueueError, CadmusRateLimitError, CadmusSessionError, CadmusStorageError, CadmusValidationError, CheckboxFieldConfig, CmsConfig, CmsRegistry, CollectionAccess, CollectionAdminConfig, CollectionConfig, CollectionHooks, CollectionMeta, CustomValidator, CustomValidatorResult, DEFAULT_STUDIO_GROUP, DateFieldConfig, DiffOptions, EDIT_ATTR, EditRef, FieldChange, FieldChangeKind, FieldConfig, GroupFieldConfig, IMAGE_MIME_WHITELIST, ImageCrop, ImageHotspot, ImageService, JsonFieldConfig, JsonValue, LocalApi, MAX_IMAGE_UPLOAD_BYTES, Migration, MigrationChange, MigrationResult, NumberFieldConfig, Patch, PatchOp, PortableBlockLike, QueueMessageHandler, RateLimitResult, RelationshipDepth, RelationshipFieldConfig, RenderedImage, RichTextFieldConfig, Rule, RunMigrationOptions, SelectFieldConfig, SendEmailInput, StringBlockRenderer, StudioStructureGroup, StudioStructureItem, TextFieldConfig, UploadFieldConfig, VISUAL_EDIT_MESSAGE, ValidateDocumentOptions, ValidationBuilder, ValidationFieldContext, ValidationSeverity, ValidationViolation, VersionedLocalApi, VisualEditingMessage, VisualEditingOptions, WebhookConfig, WebhookMessage, applyPatch, assertValid, buildStudioStructure, can, checkRateLimit, cmsConfigToSchema, collectionSearchTableName, collectionSearchTableSQL, collectionToTable, collectionVersionsTable, computePatch, createBlockRegistry, createLocalApi, createSession, createVersionedLocalApi, createWebhookHook, db, decodeEditRef, defineCmsConfig, defineCollection, defineField, defineMigration, deleteSession, deliverWebhookMessage, diffDocuments, editAttr, encodeEditRef, enqueue, extractSearchText, flattenDoc, flattenFields, generateSchemaSource, generateSessionId, generateToken, getCollectionsMeta, getRegisteredApi, getSession, hashToken, mountVisualEditing, nestDoc, processBatch, purgeCache, relationshipJoinTables, renderBlocksToString, rule, runMigration, sendEmail, signSession, validateDocument, validateImageFile, verifySession };
 //# sourceMappingURL=index.d.cts.map