superdoc 2.29.0 → 2.30.0-next.9

package/package.json

@@ -1,8 +1,17 @@
 {
   "name": "superdoc",
   "type": "module",
-  "version": "2.29.0",
-  "description": "The document engine for DOCX files. Open, edit, and render Word documents in the browser.",
+  "version": "2.30.0-next.9",
+  "description": "Browser DOCX editor for reviewing, filling, and editing Word documents.",
+  "keywords": [
+    "docx editor",
+    "docx",
+    "ms word",
+    "docx api",
+    "docx agent",
+    "docx sdk",
+    "headless"
+  ],
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -97,7 +106,7 @@
   "main": "./dist/superdoc.cjs",
   "module": "./dist/superdoc.es.js",
   "dependencies": {
-    "@superdoc/docx-engine": "0.28.0",
+    "@superdoc/docx-engine": "0.29.0-next.9",
     "@types/ws": "^8.18.1",
     "eventemitter3": "^5.0.1",
     "konva": "^10.2.0",

package/dist/document-api/src/diff/index.d.ts

@@ -1,3 +0,0 @@
-export type { DiffAdapter, DiffApi } from './diff.js';
-export { executeDiffCapture, executeDiffCompare, executeDiffApply } from './diff.js';
-export type { DiffSnapshot, DiffPayload, DiffPartChange, DiffApplyResult, DiffSummary, DiffCoverage, DiffEngineId, DiffCompareInput, DiffApplyInput, DiffApplyOptions, DiffChangeMode, DiffApplyOperationReceipt, DiffApplyReviewItem, DiffApplyEligibility, DiffApplyModeEligibility, DiffApplyEligibilityBlocker, DiffApplyEligibilityBlockerCode, } from './diff.types.js';

package/dist/document-api/src/write/locator.d.ts

@@ -1,24 +0,0 @@
-/**
- * Shared internal locator types for friendly target resolution.
- *
- * Point locators are used by insert. Range locators are used by replace,
- * delete, format.apply, comments.create, and comments.patch. Block-ID shorthand
- * is used by create.* and lists.*.
- *
- * NOT exported from the package root: internal use only.
- */
-/** Block-relative point locator: a block ID with an optional character offset. Used by insert. */
-export interface BlockRelativeLocator {
-    blockId: string;
-    offset?: number;
-}
-/** Block-relative range locator: a block ID with start and end offsets. Used by replace, delete, format.apply, comments.create/patch. */
-export interface BlockRelativeRange {
-    blockId: string;
-    start: number;
-    end: number;
-}
-/** Block-ID shorthand: a bare node ID that the adapter resolves to a full address. Used by create.*, lists.*. */
-export interface BlockIdShorthand {
-    nodeId: string;
-}

package/dist/layout-engine/painters/dom/src/features/feature-registry.d.ts

@@ -1,41 +0,0 @@
-/**
- * Rendering Feature Registry
- *
- * Maps OOXML elements to their rendering feature modules.
- * This is the primary lookup table for agents and developers.
- *
- * To find where an OOXML element renders: search this file.
- * To add a new rendering feature: add an entry here first.
- *
- * Each entry specifies:
- * - feature: human-readable feature name (matches folder name)
- * - module: import path relative to this file
- * - handles: list of OOXML element paths this feature renders
- * - spec: ECMA-376 section reference
- */
-export declare const RENDERING_FEATURES: {
-    readonly 'w:pBdr': {
-        readonly feature: "paragraph/borders";
-        readonly module: "../paragraph/borders";
-        readonly handles: readonly ["w:pBdr/w:top", "w:pBdr/w:bottom", "w:pBdr/w:left", "w:pBdr/w:right", "w:pBdr/w:between", "w:pBdr/w:bar"];
-        readonly spec: "§17.3.1.24";
-    };
-    readonly 'w:shd': {
-        readonly feature: "paragraph/borders";
-        readonly module: "../paragraph/borders";
-        readonly handles: readonly ["w:shd/@w:fill", "w:shd/@w:val", "w:shd/@w:color"];
-        readonly spec: "§17.3.1.31";
-    };
-    readonly 'w:bidi': {
-        readonly feature: "inline-direction";
-        readonly module: "./inline-direction";
-        readonly handles: readonly ["w:pPr/w:bidi", "w:rPr/w:rtl"];
-        readonly spec: "§17.3.1.1";
-    };
-    readonly 'm:oMath': {
-        readonly feature: "math";
-        readonly module: "./math";
-        readonly handles: readonly ["m:oMath", "m:oMathPara", "m:r", "m:t", "m:f", "m:rad", "m:sSup", "m:sSub", "m:sSubSup", "m:sPre", "m:d", "m:nary", "m:acc", "m:bar", "m:groupChr", "m:limLow", "m:limUpp", "m:func", "m:m", "m:eqArr", "m:borderBox", "m:box", "m:phant"];
-        readonly spec: "§22.1";
-    };
-};

package/dist/superdoc/src/internal/toolbar/built-in/format-negation.d.ts

@@ -1,11 +0,0 @@
-type MarkAttrs = Record<string, unknown>;
-/**
- * Normalize "off" values used by cascade-aware formatting marks.
- */
-export declare const isOffValue: (value: unknown) => boolean;
-export declare const negationChecks: Record<string, (attrs?: MarkAttrs) => boolean>;
-/**
- * Determine whether a mark is currently negated (explicitly turning formatting off).
- */
-export declare const isNegatedMark: (name: string, attrs?: MarkAttrs) => boolean;
-export default isNegatedMark;

package/dist/word-layout/src/tab-layout.d.ts

@@ -1,193 +0,0 @@
-import { ParagraphIndent, ResolvedTabStop } from './types.js';
-/**
- * Tab alignment type supporting all Word-compatible alignment modes.
- * Used throughout tab stop processing to ensure type safety.
- */
-export type TabAlignment = 'start' | 'center' | 'end' | 'decimal' | 'bar' | 'num';
-/**
- * Raw tab stop data as received from various document parsers.
- *
- * Different parsers may use different property names for the same concepts:
- * - `val`, `align`, `alignment`, or `type` for alignment mode
- * - `originalPos` for positions already in twips (no conversion needed)
- * - `pos`, `position`, or `offset` for positions in pixels (require conversion to twips)
- * - `leader` for the optional leader character style
- *
- * This flexible structure allows the normalization functions to handle
- * tab stop data from multiple sources without requiring parser-specific code.
- */
-export type RawTabStop = {
-    val?: string;
-    align?: string;
-    alignment?: string;
-    type?: string;
-    originalPos?: number;
-    pos?: number;
-    position?: number;
-    offset?: number;
-    leader?: 'none' | 'dot' | 'heavy' | 'hyphen' | 'middleDot' | 'underscore';
-};
-/**
- * Normalized tab stop with positions standardized to twips.
- *
- * This is the intermediate format used during tab stop processing.
- * All position values are guaranteed to be in twips (1/1440 inch),
- * allowing consistent calculations regardless of the original source format.
- * The alignment is validated and normalized to standard values.
- */
-export type NormalizedTabStopTwips = {
-    alignment: TabAlignment;
-    positionTwips: number;
-    leader?: RawTabStop['leader'];
-};
-/**
- * Options for computing the final set of tab stops.
- *
- * Controls whether to use explicit tab stops or generate default stops,
- * and how to position default stops when generated.
- */
-export type ComputeTabStopsOptions = {
-    /** Pre-normalized explicit tab stops to use instead of generating defaults */
-    explicitStops?: NormalizedTabStopTwips[];
-    /** Interval between default tab stops in twips (typically 720 = 0.5 inch) */
-    defaultTabIntervalTwips?: number;
-    /** Starting offset for default tab stop calculation (e.g., left indent) */
-    startTwips?: number;
-};
-/**
- * Options for building the complete effective tab stop set.
- *
- * Integrates tab stops from multiple sources: paragraph-level explicit stops,
- * paragraph-level defaults, and document-level defaults. Also handles
- * decimal separator configuration for decimal-aligned tabs.
- */
-export type BuildEffectiveTabStopsOptions = {
-    /** Raw tab stops defined explicitly on the paragraph */
-    explicitStops?: RawTabStop[];
-    /** Paragraph indentation affecting tab stop positioning */
-    paragraphIndent?: ParagraphIndent;
-    /** Paragraph-level default tab interval (overrides document default) */
-    paragraphTabIntervalTwips?: number;
-    /** Document-level default tab interval */
-    defaultTabIntervalTwips?: number;
-    /** Character to use for decimal alignment (e.g., '.' or ',') */
-    decimalSeparator?: string;
-};
-/**
- * Normalizes alignment values from various formats to standard alignment types.
- *
- * Handles case-insensitive alignment names, legacy alignment values (left/right),
- * and unknown values by mapping them to standard alignment types. This ensures
- * consistent alignment handling across different document formats.
- *
- * @param value - Alignment value from document source (may be undefined, empty, or unknown)
- * @returns Normalized TabAlignment, null if no valid alignment provided, or 'start' for unknown values
- *
- * @example
- * ```typescript
- * normalizeAlignment('LEFT')    // returns 'start'
- * normalizeAlignment('Right')   // returns 'end'
- * normalizeAlignment('decimal') // returns 'decimal'
- * normalizeAlignment('')        // returns null
- * normalizeAlignment('unknown') // returns 'start' (fallback)
- * normalizeAlignment(undefined) // returns null
- * ```
- */
-export declare const normalizeAlignment: (value?: string) => TabAlignment | null;
-/**
- * Normalizes raw tab stop data into a consistent format with positions in twips.
- *
- * This function processes various tab stop representations (which may use different
- * property names and units) into a standardized format suitable for layout calculations.
- * It handles alignment normalization, position unit conversion, and sorting.
- *
- * @param candidateStops - Array of raw tab stop objects from document parsing.
- *   May be null, undefined, or contain malformed entries.
- * @returns Array of normalized tab stops sorted by position, with positions in twips
- *
- * @example
- * ```typescript
- * const stops = normalizeExplicitTabStops([
- *   { val: 'left', pos: 48 },           // Position in pixels
- *   { val: 'right', originalPos: 1440 }, // Position in twips
- *   { val: 'decimal', pos: 96, leader: 'dot' }
- * ]);
- *
- * console.log(stops);
- * // [
- * //   { alignment: 'start', positionTwips: 720, leader: undefined },
- * //   { alignment: 'end', positionTwips: 1440, leader: undefined },
- * //   { alignment: 'decimal', positionTwips: 1440, leader: 'dot' }
- * // ]
- * ```
- */
-export declare const normalizeExplicitTabStops: (candidateStops?: RawTabStop[] | null) => NormalizedTabStopTwips[];
-/**
- * Computes the final list of tab stops, using either explicit stops or generating
- * default stops at regular intervals.
- *
- * When explicit tab stops are provided, they are used directly. Otherwise, this function
- * generates a default set of equally-spaced tab stops based on the default interval.
- *
- * @param options - Configuration for tab stop computation
- * @param options.explicitStops - Pre-normalized explicit tab stops to use
- * @param options.defaultTabIntervalTwips - Interval between default tab stops in twips
- * @param options.startTwips - Starting offset for default tab stop calculation
- * @returns Array of tab stops sorted by position
- *
- * @example
- * ```typescript
- * // Using explicit stops
- * const explicit = computeTabStops({
- *   explicitStops: [
- *     { alignment: 'start', positionTwips: 720 },
- *     { alignment: 'end', positionTwips: 1440 }
- *   ]
- * });
- *
- * // Generating default stops
- * const defaults = computeTabStops({
- *   defaultTabIntervalTwips: 720,
- *   startTwips: 0
- * });
- * // Returns 12 stops at 720, 1440, 2160, ... twips
- * ```
- */
-export declare const computeTabStops: (options: ComputeTabStopsOptions) => NormalizedTabStopTwips[];
-/**
- * Builds the complete set of effective tab stops in pixels, accounting for paragraph
- * indentation and document defaults.
- *
- * This is the primary tab stop resolution function that integrates all sources of tab
- * configuration: explicit paragraph tab stops, paragraph-level defaults, and document-level
- * defaults. It also handles decimal separator characters for decimal-aligned tabs.
- *
- * @param options - Options for building effective tab stops
- * @param options.explicitStops - Raw tab stops defined on the paragraph
- * @param options.paragraphIndent - Paragraph indentation that affects tab stop positioning
- * @param options.paragraphTabIntervalTwips - Paragraph-level default tab interval
- * @param options.defaultTabIntervalTwips - Document-level default tab interval
- * @param options.decimalSeparator - Character to use for decimal alignment (e.g., '.' or ',')
- * @returns Array of resolved tab stops with positions in pixels
- *
- * @example
- * ```typescript
- * const stops = buildEffectiveTabStopsPx({
- *   explicitStops: [
- *     { val: 'decimal', pos: 96, leader: 'dot' }
- *   ],
- *   paragraphIndent: { left: 24 },
- *   defaultTabIntervalTwips: 720,
- *   decimalSeparator: ','
- * });
- *
- * console.log(stops[0]);
- * // {
- * //   alignment: 'decimal',
- * //   position: 96,
- * //   leader: 'dot',
- * //   decimalChar: ','
- * // }
- * ```
- */
-export declare const buildEffectiveTabStopsPx: (options: BuildEffectiveTabStopsOptions) => ResolvedTabStop[];