@prenta/admin 0.92.0

package/dist/lib/comment-anchor.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Comment anchor helpers — convert between Yjs **relative positions** and
+ * the Base64 wire format the comments REST API speaks.
+ *
+ * Why relative positions: storing absolute offsets (e.g. char 42–58) is
+ * fatal under concurrent editing because someone inserting text before
+ * char 42 silently shifts the meaning of every saved anchor. Yjs ships
+ * `createRelativePositionFromTypeIndex` /
+ * `createAbsolutePositionFromRelativePosition` for exactly this case —
+ * they identify a slot in the CRDT graph that survives concurrent edits.
+ *
+ * The wire shape is `{ from: string; to: string }` where each end is the
+ * Base64 of `Y.encodeRelativePosition(rel)`. The slice 4 server treats
+ * the field as opaque; this module is the only place in the workspace
+ * that interprets it.
+ *
+ * ## Choosing the right Yjs type to anchor against
+ *
+ * `createRelativePositionFromTypeIndex(type, index)` interprets `index`
+ * differently depending on the type:
+ *
+ * - `Y.XmlText` / `Y.Text` — index is the character offset within the
+ *   text. **This is what comment anchors use** because character offsets
+ *   are the natural unit for a text selection.
+ * - `Y.XmlFragment` / `Y.XmlElement` — index counts *children*. Useful
+ *   for "before/after this child" anchors but not what we want here.
+ *
+ * Slice 5's TipTap binding maps a PM selection to the underlying
+ * `Y.XmlText` instance + character offset before calling `encodeAnchor`,
+ * and inverts that mapping after `decodeAnchor` returns. The y-prosemirror
+ * plugin keeps a `mapping` for this conversion; consumers that aren't
+ * using y-prosemirror can talk to the Y types directly.
+ */
+import * as Y from 'yjs';
+import type { CommentAnchor } from './comments-client.js';
+export interface CreateAnchorInput {
+    /** Live Yjs document the editor is bound to. */
+    doc: Y.Doc;
+    /**
+     * Yjs text type the selection lives in. Almost always a `Y.XmlText`
+     * for TipTap; we keep the bound a little loose so plain `Y.Text` works
+     * for non-rich-text editors.
+     */
+    yType: Y.XmlText | Y.Text;
+    /** Character offset (inclusive) of the selection start within `yType`. */
+    from: number;
+    /** Character offset (exclusive) of the selection end within `yType`. */
+    to: number;
+}
+/**
+ * Build a comment anchor from an editor selection. Returns `null` when
+ * the range is empty or inverted — the caller should not save anchors
+ * that would resolve to nothing.
+ */
+export declare function encodeAnchor(input: CreateAnchorInput): CommentAnchor | null;
+export interface ResolveAnchorInput {
+    doc: Y.Doc;
+    anchor: CommentAnchor;
+}
+export interface ResolvedAnchor {
+    /**
+     * The text type the relative position landed on. Comparing identity
+     * (`resolved.yType === editorBoundText`) lets the caller decide
+     * whether a comment is still attached to the expected text node.
+     */
+    yType: Y.AbstractType<unknown>;
+    /** Character offset of the saved selection start, after concurrent edits. */
+    from: number;
+    /** Character offset of the saved selection end. */
+    to: number;
+}
+/**
+ * Resolve a stored anchor back to live editor positions. Returns `null`
+ * when:
+ *
+ * - the anchor bytes are not valid base64 / not a Yjs relative position,
+ * - the relative position cannot be mapped (the anchored content was
+ *   deleted entirely), or
+ * - the two ends collapse to the same offset (text between them was
+ *   deleted, effectively detaching the comment).
+ *
+ * Slice 5 surfaces detached comments in the side panel with a small
+ * "anchor lost" badge so editors can still resolve / discuss them.
+ */
+export declare function decodeAnchor(input: ResolveAnchorInput): ResolvedAnchor | null;
+//# sourceMappingURL=comment-anchor.d.ts.map

package/dist/lib/comment-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-anchor.d.ts","sourceRoot":"","sources":["../../src/lib/comment-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACV;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAA;IACzB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAe3E;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAA;IACV,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IAC9B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,GAAG,IAAI,CAmC7E"}

package/dist/lib/comment-anchor.js

@@ -0,0 +1,139 @@
+/**
+ * Comment anchor helpers — convert between Yjs **relative positions** and
+ * the Base64 wire format the comments REST API speaks.
+ *
+ * Why relative positions: storing absolute offsets (e.g. char 42–58) is
+ * fatal under concurrent editing because someone inserting text before
+ * char 42 silently shifts the meaning of every saved anchor. Yjs ships
+ * `createRelativePositionFromTypeIndex` /
+ * `createAbsolutePositionFromRelativePosition` for exactly this case —
+ * they identify a slot in the CRDT graph that survives concurrent edits.
+ *
+ * The wire shape is `{ from: string; to: string }` where each end is the
+ * Base64 of `Y.encodeRelativePosition(rel)`. The slice 4 server treats
+ * the field as opaque; this module is the only place in the workspace
+ * that interprets it.
+ *
+ * ## Choosing the right Yjs type to anchor against
+ *
+ * `createRelativePositionFromTypeIndex(type, index)` interprets `index`
+ * differently depending on the type:
+ *
+ * - `Y.XmlText` / `Y.Text` — index is the character offset within the
+ *   text. **This is what comment anchors use** because character offsets
+ *   are the natural unit for a text selection.
+ * - `Y.XmlFragment` / `Y.XmlElement` — index counts *children*. Useful
+ *   for "before/after this child" anchors but not what we want here.
+ *
+ * Slice 5's TipTap binding maps a PM selection to the underlying
+ * `Y.XmlText` instance + character offset before calling `encodeAnchor`,
+ * and inverts that mapping after `decodeAnchor` returns. The y-prosemirror
+ * plugin keeps a `mapping` for this conversion; consumers that aren't
+ * using y-prosemirror can talk to the Y types directly.
+ */
+import * as Y from 'yjs';
+/**
+ * Build a comment anchor from an editor selection. Returns `null` when
+ * the range is empty or inverted — the caller should not save anchors
+ * that would resolve to nothing.
+ */
+export function encodeAnchor(input) {
+    if (input.from >= input.to)
+        return null;
+    if (input.from < 0)
+        return null;
+    // `createRelativePositionFromTypeIndex` clamps `index` to `[0, type.length]`
+    // internally, but we surface an explicit failure when the *intent* is
+    // out of bounds so the caller can flag a stale selection.
+    if (input.to > input.yType.length)
+        return null;
+    const relFrom = Y.createRelativePositionFromTypeIndex(input.yType, input.from);
+    const relTo = Y.createRelativePositionFromTypeIndex(input.yType, input.to);
+    return {
+        from: encodeBase64(Y.encodeRelativePosition(relFrom)),
+        to: encodeBase64(Y.encodeRelativePosition(relTo)),
+    };
+}
+/**
+ * Resolve a stored anchor back to live editor positions. Returns `null`
+ * when:
+ *
+ * - the anchor bytes are not valid base64 / not a Yjs relative position,
+ * - the relative position cannot be mapped (the anchored content was
+ *   deleted entirely), or
+ * - the two ends collapse to the same offset (text between them was
+ *   deleted, effectively detaching the comment).
+ *
+ * Slice 5 surfaces detached comments in the side panel with a small
+ * "anchor lost" badge so editors can still resolve / discuss them.
+ */
+export function decodeAnchor(input) {
+    let relFromBytes;
+    let relToBytes;
+    try {
+        relFromBytes = decodeBase64(input.anchor.from);
+        relToBytes = decodeBase64(input.anchor.to);
+    }
+    catch {
+        return null;
+    }
+    let relFrom;
+    let relTo;
+    try {
+        relFrom = Y.decodeRelativePosition(relFromBytes);
+        relTo = Y.decodeRelativePosition(relToBytes);
+    }
+    catch {
+        return null;
+    }
+    const absFrom = Y.createAbsolutePositionFromRelativePosition(relFrom, input.doc);
+    const absTo = Y.createAbsolutePositionFromRelativePosition(relTo, input.doc);
+    if (absFrom === null || absTo === null)
+        return null;
+    // Both ends must land on the same text node — otherwise the user's
+    // original selection has been split across nodes and we cannot paint
+    // a clean highlight without further work in slice 5.
+    if (absFrom.type !== absTo.type)
+        return null;
+    if (absFrom.index >= absTo.index)
+        return null;
+    return {
+        yType: absFrom.type,
+        from: absFrom.index,
+        to: absTo.index,
+    };
+}
+/**
+ * Base64 encode without depending on Node's `Buffer` (the admin bundle
+ * is browser-first). We hand-roll the encode because both `btoa` and
+ * `Buffer` have ergonomic mis-fits for `Uint8Array` payloads.
+ */
+function encodeBase64(bytes) {
+    if (typeof btoa === 'function') {
+        let binary = '';
+        for (let i = 0; i < bytes.byteLength; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return btoa(binary);
+    }
+    const BufferCtor = globalThis.Buffer;
+    if (BufferCtor)
+        return BufferCtor.from(bytes).toString('base64');
+    throw new Error('No base64 encoder available');
+}
+function decodeBase64(s) {
+    if (typeof atob === 'function') {
+        const binary = atob(s);
+        const out = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            out[i] = binary.charCodeAt(i);
+        }
+        return out;
+    }
+    const BufferCtor = globalThis
+        .Buffer;
+    if (BufferCtor)
+        return new Uint8Array(BufferCtor.from(s, 'base64'));
+    throw new Error('No base64 decoder available');
+}
+//# sourceMappingURL=comment-anchor.js.map

package/dist/lib/comment-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-anchor.js","sourceRoot":"","sources":["../../src/lib/comment-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAmBxB;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;QAAE,OAAO,IAAI,CAAA;IACvC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/B,6EAA6E;IAC7E,sEAAsE;IACtE,0DAA0D;IAC1D,IAAI,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAE9C,MAAM,OAAO,GAAG,CAAC,CAAC,mCAAmC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9E,MAAM,KAAK,GAAG,CAAC,CAAC,mCAAmC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IAE1E,OAAO;QACL,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACrD,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;KAClD,CAAA;AACH,CAAC;AAoBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,IAAI,YAAwB,CAAA;IAC5B,IAAI,UAAsB,CAAA;IAC1B,IAAI,CAAC;QACH,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9C,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAA2B,CAAA;IAC/B,IAAI,KAAyB,CAAA;IAC7B,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAA;QAChD,KAAK,GAAG,CAAC,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,CAAC,0CAA0C,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAChF,MAAM,KAAK,GAAG,CAAC,CAAC,0CAA0C,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5E,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEnD,mEAAmE;IACnE,qEAAqE;IACrE,qDAAqD;IACrD,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAE5C,IAAI,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IAE7C,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,IAAI;QACnB,IAAI,EAAE,OAAO,CAAC,KAAK;QACnB,EAAE,EAAE,KAAK,CAAC,KAAK;KAChB,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,KAAiB;IACrC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;IACrB,CAAC;IACD,MAAM,UAAU,GACd,UAGD,CAAC,MAAM,CAAA;IACR,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACtB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC/B,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,MAAM,UAAU,GAAI,UAAwE;SACzF,MAAM,CAAA;IACT,IAAI,UAAU;QAAE,OAAO,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAA;IACnE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;AAChD,CAAC"}

package/dist/lib/comments-client.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Comments REST client — thin, typed wrapper around the
+ * `/documents/:id/comments` + `/comments/:id` endpoints shipped in slice 4
+ * of Phase 3 (see `packages/cms-core/src/realtime/comments.ts`).
+ *
+ * The client lives in `cms-admin` so the side panel, the bubble-menu
+ * "comment on selection" action, and any future MCP/AI hooks all share one
+ * request path, error model, and DTO shape.
+ *
+ * Mirrors the server contract:
+ *   POST   /documents/:documentId/comments     -> { body, anchor?, parentId? }
+ *   GET    /documents/:documentId/comments?…   -> { data: CommentDTO[] }
+ *   PATCH  /comments/:id                       -> { body }
+ *   POST   /comments/:id/resolve               -> 200 with updated DTO
+ *   POST   /comments/:id/reopen                -> 200 with updated DTO
+ *   DELETE /comments/:id                       -> 200 with soft-deleted DTO
+ */
+/**
+ * Yjs relative-position anchor returned by the server. The encoding is
+ * intentionally opaque on the wire (Base64 of `Y.encodeRelativePosition`);
+ * `lib/comment-anchor.ts` handles the round-trip when slice 5 paints a
+ * highlight in the editor.
+ */
+export interface CommentAnchor {
+    from: string;
+    to: string;
+}
+/**
+ * Public DTO returned by every comments endpoint. Mirrors `CommentDTO` in
+ * `@prenta/core/realtime`; we duplicate the shape here so
+ * `cms-admin` doesn't take a hard dependency on the server-side service
+ * layer (which carries Prisma types we don't want pulled into the bundle).
+ */
+export interface Comment {
+    id: string;
+    documentId: string;
+    parentId: string | null;
+    userId: string | null;
+    body: string;
+    anchor: CommentAnchor | null;
+    resolvedAt: string | null;
+    resolvedById: string | null;
+    deletedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    isResolved: boolean;
+}
+export type CommentOutcome<T> = {
+    ok: true;
+    result: T;
+} | {
+    ok: false;
+    error: string;
+    status: number;
+};
+export interface CreateCommentInput {
+    documentId: string;
+    body: string;
+    anchor?: CommentAnchor | null;
+    parentId?: string | null;
+}
+export interface ListCommentsOptions {
+    /** Default: false. Resolved threads are filtered out unless requested. */
+    includeResolved?: boolean;
+    /** Default: false. Admin-only; the server rejects non-admin callers. */
+    includeDeleted?: boolean;
+    /** Default: server-side cap (100). Hard upper bound is 200. */
+    pageSize?: number;
+}
+/**
+ * Create a top-level comment or a reply. Pass `parentId` to thread the
+ * comment under an existing one — the server enforces single-level
+ * threading (replies cannot themselves be parents).
+ */
+export declare function createComment(input: CreateCommentInput): Promise<CommentOutcome<Comment>>;
+/**
+ * List comments for a document. Active comments (not resolved, not deleted)
+ * are returned by default; pass `includeResolved` to keep resolved threads
+ * in the response. The server rejects `includeDeleted` for non-admins.
+ */
+export declare function listComments(documentId: string, opts?: ListCommentsOptions): Promise<CommentOutcome<Comment[]>>;
+/** Edit a comment body. Only the author or an admin is permitted. */
+export declare function updateComment(id: string, body: string): Promise<CommentOutcome<Comment>>;
+/** Resolve a thread. Write-role or the author may resolve. */
+export declare function resolveComment(id: string): Promise<CommentOutcome<Comment>>;
+/** Re-open a resolved thread. Same permission as resolve. */
+export declare function reopenComment(id: string): Promise<CommentOutcome<Comment>>;
+/**
+ * Soft-delete a comment. The row is preserved so its replies don't lose
+ * their thread root — the server simply stops returning it from the list
+ * endpoint unless an admin asks for `includeDeleted`.
+ */
+export declare function deleteComment(id: string): Promise<CommentOutcome<Comment>>;
+/**
+ * Sort comments into thread groups suitable for rendering. Roots are
+ * returned in chronological order; replies are ordered the same way and
+ * attached to their root. Replies whose root is missing (e.g. the root was
+ * filtered out by `includeResolved=false`) are dropped — the UI can fetch
+ * them explicitly if it needs to render orphaned replies.
+ */
+export interface CommentThread {
+    root: Comment;
+    replies: Comment[];
+}
+export declare function groupCommentsIntoThreads(comments: readonly Comment[]): CommentThread[];
+//# sourceMappingURL=comments-client.d.ts.map

package/dist/lib/comments-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments-client.d.ts","sourceRoot":"","sources":["../../src/lib/comments-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACvB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAsBD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAiB/F;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAOpC;AAED,qEAAqE;AACrE,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAU9F;AAED,8DAA8D;AAC9D,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAOjF;AAED,6DAA6D;AAC7D,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAOhF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAMhF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,EAAE,CAAA;CACnB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,aAAa,EAAE,CAgBtF"}

package/dist/lib/comments-client.js

@@ -0,0 +1,138 @@
+/**
+ * Comments REST client — thin, typed wrapper around the
+ * `/documents/:id/comments` + `/comments/:id` endpoints shipped in slice 4
+ * of Phase 3 (see `packages/cms-core/src/realtime/comments.ts`).
+ *
+ * The client lives in `cms-admin` so the side panel, the bubble-menu
+ * "comment on selection" action, and any future MCP/AI hooks all share one
+ * request path, error model, and DTO shape.
+ *
+ * Mirrors the server contract:
+ *   POST   /documents/:documentId/comments     -> { body, anchor?, parentId? }
+ *   GET    /documents/:documentId/comments?…   -> { data: CommentDTO[] }
+ *   PATCH  /comments/:id                       -> { body }
+ *   POST   /comments/:id/resolve               -> 200 with updated DTO
+ *   POST   /comments/:id/reopen                -> 200 with updated DTO
+ *   DELETE /comments/:id                       -> 200 with soft-deleted DTO
+ */
+import { cmsApi } from './api.js';
+function encodeOptions(opts = {}) {
+    const params = new URLSearchParams();
+    if (opts.includeResolved)
+        params.set('includeResolved', 'true');
+    if (opts.includeDeleted)
+        params.set('includeDeleted', 'true');
+    if (opts.pageSize !== undefined)
+        params.set('pageSize', String(opts.pageSize));
+    const qs = params.toString();
+    return qs ? `?${qs}` : '';
+}
+function failure(error, status) {
+    return { ok: false, error, status };
+}
+function envelope(res) {
+    if (res.error || res.data === undefined) {
+        return failure(res.error ?? `Request failed (${res.status})`, res.status);
+    }
+    return { ok: true, result: res.data };
+}
+/**
+ * Create a top-level comment or a reply. Pass `parentId` to thread the
+ * comment under an existing one — the server enforces single-level
+ * threading (replies cannot themselves be parents).
+ */
+export async function createComment(input) {
+    if (typeof input.documentId !== 'string' || input.documentId.length === 0) {
+        return failure('documentId is required', 0);
+    }
+    if (typeof input.body !== 'string' || input.body.trim().length === 0) {
+        return failure('Comment cannot be empty', 0);
+    }
+    const body = { body: input.body.trim() };
+    if (input.anchor)
+        body.anchor = input.anchor;
+    if (input.parentId)
+        body.parentId = input.parentId;
+    const res = await cmsApi(`/documents/${encodeURIComponent(input.documentId)}/comments`, {
+        method: 'POST',
+        body: JSON.stringify(body),
+    });
+    return envelope(res);
+}
+/**
+ * List comments for a document. Active comments (not resolved, not deleted)
+ * are returned by default; pass `includeResolved` to keep resolved threads
+ * in the response. The server rejects `includeDeleted` for non-admins.
+ */
+export async function listComments(documentId, opts = {}) {
+    if (typeof documentId !== 'string' || documentId.length === 0) {
+        return failure('documentId is required', 0);
+    }
+    const path = `/documents/${encodeURIComponent(documentId)}/comments${encodeOptions(opts)}`;
+    const res = await cmsApi(path, { method: 'GET' });
+    return envelope(res);
+}
+/** Edit a comment body. Only the author or an admin is permitted. */
+export async function updateComment(id, body) {
+    if (!id)
+        return failure('comment id is required', 0);
+    if (typeof body !== 'string' || body.trim().length === 0) {
+        return failure('Comment cannot be empty', 0);
+    }
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ body: body.trim() }),
+    });
+    return envelope(res);
+}
+/** Resolve a thread. Write-role or the author may resolve. */
+export async function resolveComment(id) {
+    if (!id)
+        return failure('comment id is required', 0);
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}/resolve`, {
+        method: 'POST',
+        body: '{}',
+    });
+    return envelope(res);
+}
+/** Re-open a resolved thread. Same permission as resolve. */
+export async function reopenComment(id) {
+    if (!id)
+        return failure('comment id is required', 0);
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}/reopen`, {
+        method: 'POST',
+        body: '{}',
+    });
+    return envelope(res);
+}
+/**
+ * Soft-delete a comment. The row is preserved so its replies don't lose
+ * their thread root — the server simply stops returning it from the list
+ * endpoint unless an admin asks for `includeDeleted`.
+ */
+export async function deleteComment(id) {
+    if (!id)
+        return failure('comment id is required', 0);
+    const res = await cmsApi(`/comments/${encodeURIComponent(id)}`, {
+        method: 'DELETE',
+    });
+    return envelope(res);
+}
+export function groupCommentsIntoThreads(comments) {
+    const roots = new Map();
+    const sorted = [...comments].sort((a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt));
+    for (const c of sorted) {
+        if (c.parentId === null) {
+            roots.set(c.id, { root: c, replies: [] });
+        }
+    }
+    for (const c of sorted) {
+        if (c.parentId !== null) {
+            const root = roots.get(c.parentId);
+            if (root)
+                root.replies.push(c);
+        }
+    }
+    return Array.from(roots.values());
+}
+//# sourceMappingURL=comments-client.js.map

package/dist/lib/comments-client.js.map

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

package/dist/lib/cv.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Tiny in-house implementation of the `class-variance-authority` pattern
+ * (a.k.a. `cva` / `tailwind-variants`). We roll our own to avoid a runtime
+ * dependency while keeping the API surface compatible with the shadcn /
+ * cva ecosystem — anyone familiar with cva can read these calls.
+ *
+ * @example
+ *   const button = cv('inline-flex items-center', {
+ *     variants: {
+ *       intent: {
+ *         primary: 'bg-primary text-white',
+ *         secondary: 'bg-secondary text-foreground',
+ *       },
+ *       size: {
+ *         sm: 'px-2 py-1 text-xs',
+ *         md: 'px-4 py-2 text-sm',
+ *       },
+ *     },
+ *     defaultVariants: { intent: 'primary', size: 'md' },
+ *   })
+ *
+ *   button({ intent: 'secondary' })           // -> "inline-flex … bg-secondary …"
+ *   button({ intent: 'secondary', class: 'shadow' })  // append extras
+ */
+type ClassValue = string | undefined | false | null;
+export type VariantsConfig = Record<string, Record<string, ClassValue>>;
+type VariantSelection<V extends VariantsConfig> = {
+    [K in keyof V]?: keyof V[K];
+};
+interface CompoundVariant<V extends VariantsConfig> {
+    [key: string]: keyof V[keyof V] | Array<keyof V[keyof V]> | ClassValue;
+    class?: ClassValue;
+}
+export interface CvConfig<V extends VariantsConfig> {
+    variants: V;
+    defaultVariants?: VariantSelection<V>;
+    compoundVariants?: Array<CompoundVariant<V>>;
+}
+export type VariantProps<F extends (...args: any) => any> = Omit<NonNullable<Parameters<F>[0]>, 'class' | 'className'>;
+/**
+ * Build a variant-aware class generator.
+ *
+ * The returned function accepts the variant selection plus an optional
+ * `class` / `className` escape hatch and returns the combined Tailwind
+ * class string. Compound variants run after the base + per-variant
+ * classes, so they take precedence when the Tailwind ordering matters.
+ */
+export declare function cv<V extends VariantsConfig>(base: ClassValue, config: CvConfig<V>): (props?: VariantSelection<V> & {
+    class?: ClassValue;
+    className?: ClassValue;
+}) => string;
+export {};
+//# sourceMappingURL=cv.d.ts.map

package/dist/lib/cv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cv.d.ts","sourceRoot":"","sources":["../../src/lib/cv.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,KAAK,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAA;AAEnD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;AAEvE,KAAK,gBAAgB,CAAC,CAAC,SAAS,cAAc,IAAI;KAC/C,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAC5B,CAAA;AAED,UAAU,eAAe,CAAC,CAAC,SAAS,cAAc;IAGhD,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,CAAA;IACtE,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,cAAc;IAChD,QAAQ,EAAE,CAAC,CAAA;IACX,eAAe,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IACrC,gBAAgB,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;CAC7C;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,IAAI,IAAI,CAC9D,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAC7B,OAAO,GAAG,WAAW,CACtB,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,IAE9E,QAAQ,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,KAC3E,MAAM,CAsCV"}

package/dist/lib/cv.js

@@ -0,0 +1,47 @@
+import clsx from 'clsx';
+/**
+ * Build a variant-aware class generator.
+ *
+ * The returned function accepts the variant selection plus an optional
+ * `class` / `className` escape hatch and returns the combined Tailwind
+ * class string. Compound variants run after the base + per-variant
+ * classes, so they take precedence when the Tailwind ordering matters.
+ */
+export function cv(base, config) {
+    return function variantClass(props) {
+        // Per the cva contract, an explicit `undefined` for a variant key must
+        // fall back to the default — spreading props naively would clobber the
+        // default and drop the variant's classes entirely (e.g. a Button without
+        // a `size` prop losing all height/padding).
+        const selected = { ...config.defaultVariants };
+        for (const [key, value] of Object.entries(props ?? {})) {
+            if (value !== undefined)
+                selected[key] = value;
+        }
+        const variantClasses = [];
+        for (const [key, valuesMap] of Object.entries(config.variants)) {
+            const value = selected[key];
+            if (value === undefined || value === null)
+                continue;
+            const cls = valuesMap[value];
+            if (cls)
+                variantClasses.push(cls);
+        }
+        const compoundClasses = [];
+        if (config.compoundVariants) {
+            for (const compound of config.compoundVariants) {
+                const { class: cClass, className: _cn, ...match } = compound;
+                const matches = Object.entries(match).every(([k, v]) => {
+                    const current = selected[k];
+                    if (Array.isArray(v))
+                        return v.includes(current);
+                    return current === v;
+                });
+                if (matches && cClass)
+                    compoundClasses.push(cClass);
+            }
+        }
+        return clsx(base, ...variantClasses, ...compoundClasses, (props?.class ?? props?.className));
+    };
+}
+//# sourceMappingURL=cv.js.map

package/dist/lib/cv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cv.js","sourceRoot":"","sources":["../../src/lib/cv.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAqDvB;;;;;;;GAOG;AACH,MAAM,UAAU,EAAE,CAA2B,IAAgB,EAAE,MAAmB;IAChF,OAAO,SAAS,YAAY,CAC1B,KAA4E;QAE5E,uEAAuE;QACvE,uEAAuE;QACvE,yEAAyE;QACzE,4CAA4C;QAC5C,MAAM,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,eAAe,EAA6B,CAAA;QACzE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS;gBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QAChD,CAAC;QAED,MAAM,cAAc,GAAiB,EAAE,CAAA;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;YAC3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAQ;YACnD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAe,CAAC,CAAA;YACtC,IAAI,GAAG;gBAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC;QAED,MAAM,eAAe,GAAiB,EAAE,CAAA;QACxC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC/C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,QAAe,CAAA;gBACnE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;oBACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;oBAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;wBAAE,OAAQ,CAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;oBAC/D,OAAO,OAAO,KAAK,CAAC,CAAA;gBACtB,CAAC,CAAC,CAAA;gBACF,IAAI,OAAO,IAAI,MAAM;oBAAE,eAAe,CAAC,IAAI,CAAC,MAAoB,CAAC,CAAA;YACnE,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CACT,IAAI,EACJ,GAAG,cAAc,EACjB,GAAG,eAAe,EAClB,CAAC,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,SAAS,CAAe,CACjD,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/lib/editor-preview.d.ts

@@ -0,0 +1,4 @@
+import type { AdminEditorConfig } from '@prenta/core';
+/** Resolve whether a section editor should open with Site preview active. */
+export declare function resolveDefaultSitePreview(editor: AdminEditorConfig | undefined, kind: 'pages' | 'posts'): boolean;
+//# sourceMappingURL=editor-preview.d.ts.map

package/dist/lib/editor-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-preview.d.ts","sourceRoot":"","sources":["../../src/lib/editor-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,6EAA6E;AAC7E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,IAAI,EAAE,OAAO,GAAG,OAAO,GACtB,OAAO,CAKT"}

package/dist/lib/editor-preview.js

@@ -0,0 +1,10 @@
+/** Resolve whether a section editor should open with Site preview active. */
+export function resolveDefaultSitePreview(editor, kind) {
+    const setting = editor?.defaultSitePreview;
+    if (setting === true)
+        return true;
+    if (setting == null || setting === false)
+        return false;
+    return kind === 'pages' ? setting.pages === true : setting.posts === true;
+}
+//# sourceMappingURL=editor-preview.js.map

package/dist/lib/editor-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-preview.js","sourceRoot":"","sources":["../../src/lib/editor-preview.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB,CACvC,MAAqC,EACrC,IAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,EAAE,kBAAkB,CAAA;IAC1C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACjC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IACtD,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAA;AAC3E,CAAC"}

package/dist/lib/editor-seo-content.d.ts

@@ -0,0 +1,16 @@
+import { type PageSection } from '@prenta/core/page-sections';
+/** Build an HTML-ish string from editor sections (+ optional post body) for SEO analysis. */
+export declare function buildEditorContentHtml(sections: PageSection[], body?: string): string;
+/** Live 0–100 SEO score from the current in-editor document state. */
+export declare function computeLiveSeoScore(input: {
+    title: string;
+    slug: string;
+    seoTitle: string;
+    seoDescription: string;
+    focusKeyword?: string;
+    sections: PageSection[];
+    bodyHtml?: string;
+}): number;
+/** Top content words for the Insights accordion (excluding common stop words). */
+export declare function prominentWordsFromText(plainText: string, limit?: number): string[];
+//# sourceMappingURL=editor-seo-content.d.ts.map

package/dist/lib/editor-seo-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-seo-content.d.ts","sourceRoot":"","sources":["../../src/lib/editor-seo-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAK7E,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,CASjF;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,CAUT;AA+FD,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAW7E"}