superdoc 2.4.0-next.7 → 2.4.0-next.9

package/dist/superdoc/src/core/types/index.d.ts

@@ -843,6 +843,97 @@ export type LinkPopoverResolution = {
  * default popover.
  */
 export type LinkPopoverResolver = (ctx: LinkPopoverContext) => LinkPopoverResolution | null | undefined;
+/**
+ * Canonical presentation settings for the built-in comments UI.
+ *
+ * Presentation only, and deliberately not the whole of `modules.comments`.
+ * That block also carries `readOnly` and `allowResolve`, which resolve through
+ * `interaction.comments`, and `permissionResolver`, which is read off
+ * `modules.comments` or the top-level `Config`. All three are stripped from
+ * this bag: policy outlives the built-in UI, so an application drawing its own
+ * comment surface still has to honor it. See the fields themselves, which are
+ * rejected by name with the spelling that applies to each.
+ *
+ * Open on purpose, for the same reason `modules.comments` is: the runtime
+ * merges this bag over that block and spreads the result through the comments
+ * store, which accepts pass-through keys. Closing it would reject working
+ * configurations, which is a worse failure than the missing autocomplete it
+ * would buy. The named fields are the ones the shell reads.
+ */
+export type CommentsConfig = {
+    /** How comments present themselves as the surface narrows. */
+    displayMode?: 'auto' | 'sidebar' | 'inline';
+    /** CSS selector for an explicit width measurement target in `auto` mode. */
+    compactMeasurementSelector?: string;
+    /** Fixed compact-mode breakpoint override, in pixels. */
+    compactBreakpointPx?: number;
+    /** Comment highlight colors (internal/external and active overrides). */
+    highlightColors?: {
+        /** Base highlight color for internal comments. */
+        internal?: string;
+        /** Base highlight color for external comments. */
+        external?: string;
+        /** Active highlight color override for internal comments. */
+        activeInternal?: string;
+        /** Active highlight color override for external comments. */
+        activeExternal?: string;
+    };
+    /** Comment highlight opacity, active and inactive. */
+    highlightOpacity?: {
+        /** Opacity for the active comment highlight. */
+        active?: number;
+        /** Opacity for inactive comment highlights. */
+        inactive?: number;
+    };
+    /** Highlight color used while hovering a comment. */
+    highlightHoverColor?: string;
+    /** Tracked-change highlight colors. */
+    trackChangeHighlightColors?: TrackChangeHighlightColors;
+    /** Active tracked-change highlight colors (defaults to the above). */
+    trackChangeActiveHighlightColors?: TrackChangeHighlightColors;
+    /**
+     * Policy, not presentation. `normalizeUiConfig` strips all three from this
+     * bag before anything reads it, so accepting them here would advertise a
+     * setting that is silently discarded.
+     *
+     * `readOnly` and `allowResolve` belong on `interaction.comments`, where they
+     * resolve and keep applying to an application drawing its own comment
+     * surface.
+     *
+     * `permissionResolver` is collaboration wiring rather than policy, and has
+     * no `ui` spelling at all. `pickResolver` takes the first of
+     * `modules.comments.permissionResolver` and the top-level
+     * `Config.permissionResolver`, in that order, so either works and the
+     * comments-scoped one wins.
+     */
+    readOnly?: never;
+    allowResolve?: never;
+    permissionResolver?: never;
+} & Record<string, unknown>;
+/** Border and background colors for one tracked-change highlight state. */
+export interface TrackChangeHighlightColors {
+    /** Border color for inserted text. */
+    insertBorder?: string;
+    /** Background color for inserted text. */
+    insertBackground?: string;
+    /** Border color for deleted text. */
+    deleteBorder?: string;
+    /** Background color for deleted text. */
+    deleteBackground?: string;
+    /** Border color for a format change. */
+    formatBorder?: string;
+}
+/**
+ * Canonical configuration for the chrome drawn around content controls.
+ *
+ * `chrome` is the whole option bag this surface has. `'default'` and `'none'`
+ * are the only values the painter and the v2 host accept; anything else is
+ * coerced back to `'default'`.
+ */
+export interface ContentControlsConfig {
+    /** Whether SuperDoc draws its own chrome around each content control. */
+    chrome?: 'default' | 'none';
+}
 /**
  * Canonical configuration for the built-in link popover.
  *
@@ -1664,6 +1755,17 @@ export interface FindReplaceConfig {
         width?: number | string;
         maxWidth?: number | string;
         maxHeight?: number | string;
+        /**
+         * Focus the find input when the surface opens. Defaults to `true`; set
+         * `false` to leave focus wherever the user had it.
+         *
+         * Honored but undeclared until #1094: `useFindReplace` spreads this whole
+         * bag into the surface request, and `SurfaceManager` applies it last, over
+         * the `modules.surfaces.floating` defaults.
+         */
+        autoFocus?: boolean;
+        /** Close the surface on a pointer press outside it. Defaults to `false`. */
+        closeOnOutsidePointerDown?: boolean;
     };
 }
 /**
@@ -2668,7 +2770,7 @@ export interface UIConfig {
         showTableOfContentsButton?: boolean;
     };
     /** Built-in comments UI. Enabled by default. */
-    comments?: boolean | Record<string, unknown>;
+    comments?: boolean | CommentsConfig;
     /** Built-in right-click and slash context menu. Enabled by default. */
     contextMenu?: boolean | ContextMenuConfig;
     /**
@@ -2676,7 +2778,7 @@ export interface UIConfig {
      * SuperDoc intercept Cmd+F / Ctrl+F; `editor.ui.search` stays available to
      * custom UI either way.
      */
-    search?: boolean | Record<string, unknown>;
+    search?: boolean | FindReplaceConfig;
     /**
      * Built-in popover shown when a link is clicked. It renders by default;
      * pass `false` (or `ui: false`) to suppress it. Supplying a
@@ -2689,7 +2791,7 @@ export interface UIConfig {
         container?: string | HTMLElement;
     };
     /** Built-in chrome drawn around content controls. Enabled by default. */
-    contentControls?: boolean | Record<string, unknown>;
+    contentControls?: boolean | ContentControlsConfig;
 }
 /**
  * What the user is permitted to do, as distinct from what SuperDoc draws.

package/dist/superdoc/src/public/index.d.cts

@@ -9,10 +9,12 @@ import type { BorrowedSuperDocUI as __Cjs_BorrowedSuperDocUI } from './index.js'
 import type { CanPerformPermissionParams as __Cjs_CanPerformPermissionParams } from './index.js' with { "resolution-mode": "import" };
 import type { CollaborationConfig as __Cjs_CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentAddress as __Cjs_CommentAddress } from './index.js' with { "resolution-mode": "import" };
+import type { CommentsConfig as __Cjs_CommentsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentsType as __Cjs_CommentsType } from './index.js' with { "resolution-mode": "import" };
 import type { Config as __Cjs_Config } from './index.js' with { "resolution-mode": "import" };
 import type { ContentControlActiveChangePayload as __Cjs_ContentControlActiveChangePayload } from './index.js' with { "resolution-mode": "import" };
 import type { ContentControlClickPayload as __Cjs_ContentControlClickPayload } from './index.js' with { "resolution-mode": "import" };
+import type { ContentControlsConfig as __Cjs_ContentControlsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuConfig as __Cjs_ContextMenuConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuContext as __Cjs_ContextMenuContext } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuItem as __Cjs_ContextMenuItem } from './index.js' with { "resolution-mode": "import" };
@@ -165,6 +167,7 @@ import type { TextAddress as __Cjs_TextAddress } from './index.js' with { "resol
 import type { TextSegment as __Cjs_TextSegment } from './index.js' with { "resolution-mode": "import" };
 import type { TextTarget as __Cjs_TextTarget } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangeAuthor as __Cjs_TrackChangeAuthor } from './index.js' with { "resolution-mode": "import" };
+import type { TrackChangeHighlightColors as __Cjs_TrackChangeHighlightColors } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesAuthorColorsConfig as __Cjs_TrackChangesAuthorColorsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesModuleConfig as __Cjs_TrackChangesModuleConfig } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesSemanticColorsConfig as __Cjs_TrackChangesSemanticColorsConfig } from './index.js' with { "resolution-mode": "import" };
@@ -189,11 +192,13 @@ export declare const buildTheme: typeof import('./index.js', { with: { "resoluti
 export type { __Cjs_CanPerformPermissionParams as CanPerformPermissionParams };
 export type { __Cjs_CollaborationConfig as CollaborationConfig };
 export type { __Cjs_CommentAddress as CommentAddress };
+export type { __Cjs_CommentsConfig as CommentsConfig };
 export type { __Cjs_CommentsType as CommentsType };
 export declare const compareVersions: typeof import('./index.js', { with: { "resolution-mode": "import" } }).compareVersions;
 export type { __Cjs_Config as Config };
 export type { __Cjs_ContentControlActiveChangePayload as ContentControlActiveChangePayload };
 export type { __Cjs_ContentControlClickPayload as ContentControlClickPayload };
+export type { __Cjs_ContentControlsConfig as ContentControlsConfig };
 export type { __Cjs_ContextMenuConfig as ContextMenuConfig };
 export type { __Cjs_ContextMenuContext as ContextMenuContext };
 export type { __Cjs_ContextMenuItem as ContextMenuItem };
@@ -353,6 +358,7 @@ export type { __Cjs_TextAddress as TextAddress };
 export type { __Cjs_TextSegment as TextSegment };
 export type { __Cjs_TextTarget as TextTarget };
 export type { __Cjs_TrackChangeAuthor as TrackChangeAuthor };
+export type { __Cjs_TrackChangeHighlightColors as TrackChangeHighlightColors };
 export type { __Cjs_TrackChangesAuthorColorsConfig as TrackChangesAuthorColorsConfig };
 export type { __Cjs_TrackChangesModuleConfig as TrackChangesModuleConfig };
 export type { __Cjs_TrackChangesSemanticColorsConfig as TrackChangesSemanticColorsConfig };

package/dist/superdoc/src/public/index.d.ts

@@ -72,6 +72,9 @@ export type { SuperDocLayoutEngineOptions as LayoutEngineOptions } from '../core
 export type { FlowBlock, FlowMode, Layout, Fragment as LayoutFragment, Page as LayoutPage } from '../../../layout-engine/contracts/src/index.js';
 export type { LayoutMetrics } from '../../../layout-engine/layout-bridge/src/index.js';
 export type { LayoutMode } from '../../../layout-engine/painters/dom/src/index.js';
+export type { CommentsConfig } from '../core/types/index.js';
+export type { TrackChangeHighlightColors } from '../core/types/index.js';
+export type { ContentControlsConfig } from '../core/types/index.js';
 export type { LinkPopoverConfig } from '../core/types/index.js';
 export type { LinkPopoverContext } from '../core/types/index.js';
 export type { LinkPopoverResolution } from '../core/types/index.js';

package/dist/superdoc/src/public/ui/types.d.ts

@@ -837,7 +837,19 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
     list(query?: CommentsListQuery): readonly CommentInfo[];
     /** Resolve a single comment by id from the best-known loaded state. */
     getById(commentId: string): CommentInfo | null;
-    /** Create a comment from a frozen selection capture. */
+    /**
+     * Create a comment from a frozen selection capture.
+     *
+     * A capture carrying neither `target` nor `selectionTarget` fails closed with
+     * the same `NO_SELECTION` receipt {@link createFromSelection} mints for an
+     * empty selection, because both describe the same user-visible mistake:
+     * commenting with nothing selected. A capture that *has* a target which no
+     * longer resolves is a different failure, and keeps the Document API's own
+     * receipt so the reason stays specific.
+     *
+     * `capturedAt` is provenance for the consumer, not an expiry. A capture stays
+     * usable while its target resolves; elapsed time alone never invalidates it.
+     */
     createFromCapture(capture: CommentAnchorCapture, input: {
         text: string;
     }): WorkflowReceipt;
@@ -853,6 +865,18 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
     reply(commentId: string, input: {
         text: string;
     }): WorkflowReceipt;
+    /**
+     * Replace a comment's body text through the Document API
+     * (`comments.patch({ commentId, text })`).
+     *
+     * Gated by the comments `readOnly` policy like every other comment write.
+     * `allowResolve` is deliberately NOT consulted: that policy forbids only the
+     * resolve/reopen transition, and an application that may not resolve threads
+     * can still let an author correct their own wording.
+     */
+    edit(commentId: string, input: {
+        text: string;
+    }): WorkflowReceipt;
     /** Mark a comment resolved. */
     resolve(commentId: string): WorkflowReceipt;
     /** Reopen a resolved comment. */

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-DP8RUPW-.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-DqY4aSMf.cjs");
 const require_uuid = require("./chunks/uuid-CFp0WGVU.cjs");
 const require_jszip = require("./chunks/jszip-Cs9JBLlJ.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-sMXbYzhs.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-ByvmsAAG.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-CZ1Nl59K.cjs");
 const require_constants = require("./chunks/constants-D7TNtyJd.cjs");
 let vue = require("vue");
@@ -15409,7 +15409,7 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 			} else {
 				let FindReplaceSurface;
 				try {
-					FindReplaceSurface = (await Promise.resolve().then(() => require("./chunks/FindReplaceSurface-C-I4GcRE.cjs"))).default;
+					FindReplaceSurface = (await Promise.resolve().then(() => require("./chunks/FindReplaceSurface-9VkPw_-X.cjs"))).default;
 				} catch {
 					opening = false;
 					return;
@@ -39357,7 +39357,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.7";
+		this.version = "2.4.0-next.9";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -3,7 +3,7 @@ import { t as blank_default } from "./chunks/blank-docx-XRX6Ker2.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-Bt2s0X0a.es.js";
 import { t as v4_default } from "./chunks/uuid-B2Sqk-3p.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-C8srOKAO.es.js";
-import { a as createV2ReviewMutationReconciler, c as DOM_CLASS_NAMES, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, s as composeAuthorColorResolver, t as createSuperDocUI } from "./chunks/create-super-doc-ui-BquF8bnZ.es.js";
+import { a as createV2ReviewMutationReconciler, c as DOM_CLASS_NAMES, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, s as composeAuthorColorResolver, t as createSuperDocUI } from "./chunks/create-super-doc-ui-DBXOhHdW.es.js";
 import { t as __plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-DSMAhhwD.es.js";
 import { n as PDF_TO_CSS_UNITS } from "./chunks/constants-BfH0br5u.es.js";
 import * as Vue from "vue";
@@ -15383,7 +15383,7 @@ function useFindReplace({ getSurfaceManager, getActiveEditor, activeEditorRef, g
 			} else {
 				let FindReplaceSurface;
 				try {
-					FindReplaceSurface = (await import("./chunks/FindReplaceSurface-B_1Ksbr0.es.js")).default;
+					FindReplaceSurface = (await import("./chunks/FindReplaceSurface-BuvaIrQ5.es.js")).default;
 				} catch {
 					opening = false;
 					return;
@@ -39290,7 +39290,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.7";
+		this.version = "2.4.0-next.9";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4_default();
 		this.colors = this.config.colors ?? [];