superdoc 2.28.0-next.1 → 2.28.0-next.10

package/dist/document-api/src/replace/replace.d.ts

@@ -7,7 +7,10 @@ import { BodyStoryLocator, StoryLocator } from '../types/story.types.js';
 import { BlockNodeAddress } from '../types/base.js';
 import { NestingPolicy } from '../types/placement.js';
 import { SelectionMutationAdapter } from '../selection-mutation.js';
-export type TextReplacementGranularity = 'word' | 'phrase' | 'range';
+export declare const TEXT_REPLACEMENT_GRANULARITIES: readonly ["word", "phrase", "range"];
+export type TextReplacementGranularity = (typeof TEXT_REPLACEMENT_GRANULARITIES)[number];
+export declare function isTextReplacementGranularity(value: unknown): value is TextReplacementGranularity;
+export declare function isSingleParagraphVisibleTextSelection(target: unknown): target is SelectionTarget;
 /** Text replacement input: uses SelectionTarget / ref, or the complete main body. */
 export type TextReplaceInput = {
     target: SelectionTarget;

package/dist/document-api/src/types/mutation-plan.types.d.ts

@@ -6,6 +6,7 @@ import { InlineRunPatch } from '../format/inline-run-patch.js';
 import { SDFragment } from './fragment.js';
 import { Placement, NestingPolicy } from './placement.js';
 import { AffectedRef, ReceiptSuccess } from './receipt.js';
+import { TextReplacementGranularity } from '../replace/replace.js';
 import { ChangeMode } from '../write/write.js';
 import { StoryLocator } from './story.types.js';
 export type SelectWhere = {
@@ -70,6 +71,7 @@ export type TextRewriteStep = {
         replacementMode?: 'literal' | 'regex-template';
         /** Preserve the matched text's casing pattern instead of using replacement casing verbatim. */
         caseHandling?: 'exact' | 'preserve-match';
+        replacementGranularity?: TextReplacementGranularity;
         /**
          * Style policy for the replacement text.
          * When omitted, uses the native preserve policy:

package/dist/document-api/src/types/track-changes.types.d.ts

@@ -579,7 +579,15 @@ export interface TrackChangeInfo {
     author?: string;
     authorEmail?: string;
     authorImage?: string;
-    /** Author initials (spec §3 required field, when provided by the source). */
+    /**
+     * Author initials (spec §3 required field, when known). Read from the revision
+     * wrapper: SuperDoc writes them as `initials` in the `urn:superdoc:tracked-change:1`
+     * namespace (behind `mc:Ignorable`, like `authorEmail`), so they survive save, reopen
+     * and collaboration; a `w:initials` attribute from an older source file is also read.
+     * When the wrapper carries neither, the initials of a comment by the same author
+     * name in the document are used. SuperDoc never writes `w:initials` on revision
+     * wrappers; source wrappers it keeps verbatim are left as they are.
+     */
     initials?: string;
     date?: string;
     /**
@@ -714,7 +722,7 @@ export interface TrackChangeDomain {
     author?: string;
     authorEmail?: string;
     authorImage?: string;
-    /** Author initials. */
+    /** Author initials, resolved as on {@link TrackChangeInfo.initials}. */
     initials?: string;
     date?: string;
     excerpt?: string;

package/dist/layout-engine/contracts/src/index.d.ts

@@ -312,6 +312,7 @@ export type RunMarks = {
     bold?: boolean;
     /** Italic text styling. */
     italic?: boolean;
+    smallCaps?: boolean;
     /** Additional letter spacing in pixels (positive for expanded, negative for condensed). */
     letterSpacing?: number;
     /** Horizontal glyph scale as a unitless multiplier (`1` = 100%, `0.9` = 90%). */
@@ -1960,6 +1961,7 @@ export type WordLayoutMarker = {
  * ```
  */
 export type WordLayoutConfig = {
+    textStartMode?: 'paragraph';
     /**
      * Whether this list uses first-line indent mode (true for input-rule-created lists).
      * When true, text positioning uses textStartPx instead of standard hanging indent calculations.

package/dist/layout-engine/contracts/src/resolved-layout.d.ts

@@ -470,6 +470,7 @@ export type ResolvedHeaderFooterLayout = {
 };
 /** Resolved list marker rendering data with pre-computed positioning. */
 export type ResolvedListMarkerItem = {
+    textStartPx?: number;
     /** Marker text content (e.g., "1.", "a)", bullet). */
     text: string;
     /** Horizontal justification. */

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D1eOhAjv.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-B4c55pFy.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 let use_sync_external_store_shim = require("use-sync-external-store/shim");

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B29zw5qD.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C4Ka5Ph3.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D1eOhAjv.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-B4c55pFy.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B29zw5qD.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C4Ka5Ph3.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D1eOhAjv.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-B4c55pFy.cjs");
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/public/ui.es.js

@@ -1,4 +1,4 @@
-import { f as shallowEqual, o as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-B29zw5qD.es.js";
+import { p as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C4Ka5Ph3.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/shared/common/list-marker-utils.d.ts

@@ -96,6 +96,9 @@ export type MinimalMarker = {
  * Contains the subset of word layout properties needed to determine text positioning.
  */
 export type MinimalWordLayout = {
+    textStartMode?: 'paragraph';
+    firstLinePx?: number;
+    hangingPx?: number;
     /** Whether this list uses first-line indent mode (input-rule created lists) */
     firstLineIndentMode?: boolean;
     /** Pre-calculated horizontal position where text should start */