@betteroffice/docx 0.0.3 → 0.1.0

package/dist/{formatting-D1EPSaJP.d.mts → formatting-BqrFPeev.d.mts}

@@ -1,239 +1,113 @@
-/**
- * Theme parsing — colors and fonts from a DrawingML theme part
- * (e.g. word/theme/theme1.xml, ppt/theme/theme1.xml).
- *
- * Extracts color scheme (dk1, lt1, dk2, lt2, accent1-6, hlink, folHlink)
- * and font scheme (majorFont, minorFont) from the theme.
- *
- * OOXML Reference:
- * - Uses DrawingML namespace (a:)
- * - Colors can be srgbClr, sysClr, or schemeClr
- */
-
-/**
- * Theme color scheme (a:clrScheme)
- *
- * @public
- */
+/** DrawingML value contracts retained by the DOCX host. */
+type ThemeColorSlot = 'dk1' | 'lt1' | 'dk2' | 'lt2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hlink' | 'folHlink' | 'background1' | 'text1' | 'background2' | 'text2';
+interface ColorValue {
+    rgb?: string;
+    themeColor?: ThemeColorSlot;
+    themeTint?: string;
+    themeShade?: string;
+    auto?: boolean;
+}
 interface ThemeColorScheme {
-    /** Dark 1 color (usually black) */
     dk1?: string;
-    /** Light 1 color (usually white) */
     lt1?: string;
-    /** Dark 2 color */
     dk2?: string;
-    /** Light 2 color */
     lt2?: string;
-    /** Accent colors 1-6 */
     accent1?: string;
     accent2?: string;
     accent3?: string;
     accent4?: string;
     accent5?: string;
     accent6?: string;
-    /** Hyperlink color */
     hlink?: string;
-    /** Followed hyperlink color */
     folHlink?: string;
 }
-/**
- * Theme font (with script variants)
- *
- * @public
- */
 interface ThemeFont {
-    /** Latin font */
     latin?: string;
-    /** East Asian font */
     ea?: string;
-    /** Complex script font */
     cs?: string;
-    /** Script-specific fonts */
     fonts?: Record<string, string>;
 }
-/**
- * Theme font scheme (a:fontScheme)
- *
- * @public
- */
 interface ThemeFontScheme {
-    /** Major font (headings) */
     majorFont?: ThemeFont;
-    /** Minor font (body text) */
     minorFont?: ThemeFont;
 }
-/**
- * Theme (from a theme1.xml part)
- *
- * @public
- */
 interface Theme {
-    /** Theme name */
     name?: string;
-    /** Color scheme */
     colorScheme?: ThemeColorScheme;
-    /** Font scheme */
     fontScheme?: ThemeFontScheme;
-    /** Format scheme (fills, lines, effects) - simplified */
     formatScheme?: {
         name?: string;
     };
 }
-
-/**
- * Color primitives and math shared across OOXML formats.
- *
- * Handles theme color slot references (accent1, dk1, ...), RGB hex values,
- * tint/shade modifiers, and the derived color helpers (lighten/darken/blend/
- * contrast) built on top of them.
- *
- * Tint/Shade Calculations (ECMA-376 §17.3.2.41):
- * - Tint makes a color lighter (per-channel interpolation toward white)
- * - Shade makes a color darker (per-channel interpolation toward black)
- * - The wire value is a hex byte (00-FF) meaning "how much color to keep"
- */
-
-/**
- * Theme color slots from a theme's clrScheme (plus the WordprocessingML
- * alias slots background1/text1/background2/text2).
- *
- * @public
- */
-type ThemeColorSlot = 'dk1' | 'lt1' | 'dk2' | 'lt2' | 'accent1' | 'accent2' | 'accent3' | 'accent4' | 'accent5' | 'accent6' | 'hlink' | 'folHlink' | 'background1' | 'text1' | 'background2' | 'text2';
-/**
- * ECMA-376 color reference — either a direct RGB hex, a theme slot
- * reference (with optional tint/shade), or `auto` for context-dependent
- * defaults (usually black for text on light backgrounds). When both
- * `rgb` and `themeColor` are set, the theme wins on Word import and the
- * `rgb` acts as a fallback for renderers without theme support.
- *
- * See ECMA-376 §17.18.39 (`ST_ThemeColor`).
- *
- * @public
- */
-interface ColorValue {
-    /** RGB hex value without # (e.g., "FF0000") */
-    rgb?: string;
-    /** Theme color slot reference */
-    themeColor?: ThemeColorSlot;
-    /** Tint modifier (0-255 as hex string, e.g., "80") - makes color lighter */
-    themeTint?: string;
-    /** Shade modifier (0-255 as hex string) - makes color darker */
-    themeShade?: string;
-    /** Auto color - context-dependent (usually black for text) */
-    auto?: boolean;
+type ShapeType = 'rect' | 'roundRect' | 'ellipse' | 'triangle' | 'rtTriangle' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'hexagon' | 'heptagon' | 'octagon' | 'decagon' | 'dodecagon' | 'star4' | 'star5' | 'star6' | 'star7' | 'star8' | 'star10' | 'star12' | 'star16' | 'star24' | 'star32' | 'line' | 'straightConnector1' | 'bentConnector2' | 'bentConnector3' | 'bentConnector4' | 'bentConnector5' | 'curvedConnector2' | 'curvedConnector3' | 'curvedConnector4' | 'curvedConnector5' | 'rightArrow' | 'leftArrow' | 'upArrow' | 'downArrow' | 'leftRightArrow' | 'upDownArrow' | 'quadArrow' | 'leftRightUpArrow' | 'bentArrow' | 'uturnArrow' | 'leftUpArrow' | 'bentUpArrow' | 'curvedRightArrow' | 'curvedLeftArrow' | 'curvedUpArrow' | 'curvedDownArrow' | 'stripedRightArrow' | 'notchedRightArrow' | 'homePlate' | 'chevron' | 'rightArrowCallout' | 'downArrowCallout' | 'leftArrowCallout' | 'upArrowCallout' | 'leftRightArrowCallout' | 'quadArrowCallout' | 'circularArrow' | 'flowChartProcess' | 'flowChartAlternateProcess' | 'flowChartDecision' | 'flowChartInputOutput' | 'flowChartPredefinedProcess' | 'flowChartInternalStorage' | 'flowChartDocument' | 'flowChartMultidocument' | 'flowChartTerminator' | 'flowChartPreparation' | 'flowChartManualInput' | 'flowChartManualOperation' | 'flowChartConnector' | 'flowChartOffpageConnector' | 'flowChartPunchedCard' | 'flowChartPunchedTape' | 'flowChartSummingJunction' | 'flowChartOr' | 'flowChartCollate' | 'flowChartSort' | 'flowChartExtract' | 'flowChartMerge' | 'flowChartOnlineStorage' | 'flowChartDelay' | 'flowChartMagneticTape' | 'flowChartMagneticDisk' | 'flowChartMagneticDrum' | 'flowChartDisplay' | 'wedgeRectCallout' | 'wedgeRoundRectCallout' | 'wedgeEllipseCallout' | 'cloudCallout' | 'borderCallout1' | 'borderCallout2' | 'borderCallout3' | 'accentCallout1' | 'accentCallout2' | 'accentCallout3' | 'callout1' | 'callout2' | 'callout3' | 'accentBorderCallout1' | 'accentBorderCallout2' | 'accentBorderCallout3' | 'actionButtonBlank' | 'actionButtonHome' | 'actionButtonHelp' | 'actionButtonInformation' | 'actionButtonBackPrevious' | 'actionButtonForwardNext' | 'actionButtonBeginning' | 'actionButtonEnd' | 'actionButtonReturn' | 'actionButtonDocument' | 'actionButtonSound' | 'actionButtonMovie' | 'irregularSeal1' | 'irregularSeal2' | 'frame' | 'halfFrame' | 'corner' | 'diagStripe' | 'chord' | 'arc' | 'bracketPair' | 'bracePair' | 'leftBracket' | 'rightBracket' | 'leftBrace' | 'rightBrace' | 'can' | 'cube' | 'bevel' | 'donut' | 'noSmoking' | 'blockArc' | 'foldedCorner' | 'smileyFace' | 'heart' | 'lightningBolt' | 'sun' | 'moon' | 'cloud' | 'snip1Rect' | 'snip2SameRect' | 'snip2DiagRect' | 'snipRoundRect' | 'round1Rect' | 'round2SameRect' | 'round2DiagRect' | 'plaque' | 'teardrop' | 'mathPlus' | 'mathMinus' | 'mathMultiply' | 'mathDivide' | 'mathEqual' | 'mathNotEqual' | 'gear6' | 'gear9' | 'funnel' | 'pieWedge' | 'pie' | 'leftCircularArrow' | 'leftRightCircularArrow' | 'swooshArrow' | 'textBox';
+interface ShapeFill {
+    type: 'none' | 'solid' | 'gradient' | 'pattern' | 'picture';
+    color?: ColorValue;
+    gradient?: {
+        type: 'linear' | 'radial' | 'rectangular' | 'path';
+        angle?: number;
+        stops: Array<{
+            position: number;
+            color: ColorValue;
+        }>;
+    };
 }
-/**
- * Resolve a ColorValue to a CSS color string
- *
- * @param color - ColorValue object with rgb, themeColor, tint/shade, or auto
- * @param theme - Theme for resolving theme colors
- * @param defaultColor - Default color if auto or undefined (default: black)
- * @returns CSS color string (e.g., "#FF0000" or "inherit")
- *
- * @public
- */
-declare function resolveColor(color: ColorValue | undefined | null, theme: Theme | null | undefined, defaultColor?: string): string;
-/**
- * Resolve any ColorValue (text, fill/shading, border, underline) to a 6-char
- * uppercase hex string — or `undefined` if transparent/unset/unresolvable.
- *
- * Shared display-side resolver. Prefer this over reading `.rgb` directly so
- * that `themeColor` + `themeTint`/`themeShade` are honored consistently across
- * all render paths.
- *
- * When a themed color is present but `theme` is null/undefined, falls back to
- * `color.rgb` if Word wrote one for compat; otherwise returns `undefined`.
- *
- * @returns 6-char uppercase hex without `#`, or `undefined`.
- *
- * @public
- */
-declare function resolveColorToHex(color: ColorValue | undefined | null, theme: Theme | null | undefined): string | undefined;
-/**
- * Get contrasting text color for a background
- *
- * @param backgroundColor - Background ColorValue
- * @param theme - Theme for resolving theme colors
- * @returns Black or white hex color for best contrast
- *
- * @public
- */
-declare function getContrastingColor(backgroundColor: ColorValue | undefined | null, theme: Theme | null | undefined): string;
-/**
- * Darken a color by a percentage
- *
- * @param color - ColorValue to darken
- * @param theme - Theme for resolving
- * @param percent - Percentage to darken (0-100)
- * @returns CSS color string
- *
- * @public
- */
-declare function darkenColor(color: ColorValue | undefined | null, theme: Theme | null | undefined, percent: number): string;
-/**
- * Lighten a color by a percentage
- *
- * @param color - ColorValue to lighten
- * @param theme - Theme for resolving
- * @param percent - Percentage to lighten (0-100)
- * @returns CSS color string
- *
- * @public
- */
-declare function lightenColor(color: ColorValue | undefined | null, theme: Theme | null | undefined, percent: number): string;
-/**
- * Blend two colors together
- *
- * @param color1 - First color
- * @param color2 - Second color
- * @param ratio - Blend ratio (0 = all color1, 1 = all color2)
- * @param theme - Theme for resolving
- * @returns CSS color string
- *
- * @public
- */
-declare function blendColors(color1: ColorValue | undefined | null, color2: ColorValue | undefined | null, ratio: number, theme: Theme | null | undefined): string;
-/**
- * Theme color matrix cell
- *
- * @public
- */
-interface ThemeMatrixCell {
-    /** Resolved hex color (6 chars, no #) */
-    hex: string;
-    /** Theme color slot */
-    themeSlot: ThemeColorSlot;
-    /** Tint hex modifier if applicable (e.g., "CC") */
-    tint?: string;
-    /** Shade hex modifier if applicable (e.g., "BF") */
-    shade?: string;
-    /** Human-readable label (e.g., "Accent 1, Lighter 60%") */
-    label: string;
+interface ShapeOutline {
+    width?: number;
+    color?: ColorValue;
+    style?: 'solid' | 'dot' | 'dash' | 'lgDash' | 'dashDot' | 'lgDashDot' | 'lgDashDotDot' | 'sysDot' | 'sysDash' | 'sysDashDot' | 'sysDashDotDot';
+    cap?: 'flat' | 'round' | 'square';
+    join?: 'bevel' | 'miter' | 'round';
+    headEnd?: {
+        type: 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
+        width?: 'sm' | 'med' | 'lg';
+        length?: 'sm' | 'med' | 'lg';
+    };
+    tailEnd?: {
+        type: 'none' | 'triangle' | 'stealth' | 'diamond' | 'oval' | 'arrow';
+        width?: 'sm' | 'med' | 'lg';
+        length?: 'sm' | 'med' | 'lg';
+    };
 }
-/**
- * Compute a single tinted or shaded hex color from a base color.
- *
- * @param baseHex - 6-character hex color (no #)
- * @param type - 'tint' to lighten, 'shade' to darken
- * @param fraction - Amount (0-1). For tint: 0=no change, 1=white. For shade: 0=black, 1=no change.
- * @returns 6-character hex color (no #)
- *
- * @public
- */
-declare function getThemeTintShadeHex(baseHex: string, type: 'tint' | 'shade', fraction: number): string;
-/**
- * Generate the 10×6 theme color matrix for an advanced color picker.
- *
- * Columns: lt1, dk1, lt2, dk2, accent1-6 (matches Word's order)
- * Rows: base, 80% tint, 60% tint, 40% tint, 25% shade, 50% shade
- *
- * @param colorScheme - Theme color scheme (falls back to Office 2016 defaults)
- * @returns 6 rows × 10 columns of ThemeMatrixCell
- *
- * @public
- */
-declare function generateThemeTintShadeMatrix(colorScheme?: ThemeColorScheme | null): ThemeMatrixCell[][];
+interface ShapeTextBody<TContent = unknown> {
+    vertical?: boolean;
+    rotation?: number;
+    anchor?: 'top' | 'middle' | 'bottom' | 'distributed' | 'justified';
+    anchorCenter?: boolean;
+    autoFit?: 'none' | 'normal' | 'shape';
+    margins?: {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+    };
+    content: TContent[];
+}
+type PresetGeometryPathCommand = {
+    type: 'move';
+    x: number;
+    y: number;
+} | {
+    type: 'line';
+    x: number;
+    y: number;
+} | {
+    type: 'quad';
+    cpx: number;
+    cpy: number;
+    x: number;
+    y: number;
+} | {
+    type: 'cubic';
+    cp1x: number;
+    cp1y: number;
+    cp2x: number;
+    cp2y: number;
+    x: number;
+    y: number;
+} | {
+    type: 'close';
+};
 
 /**
  * Color & Styling Primitives
@@ -537,6 +411,14 @@ interface ParagraphFormatting {
     indentFirstLine?: number;
     /** Whether first line is hanging indent */
     hangingIndent?: boolean;
+    /** Left indent in hundredths of a character (w:ind/@w:leftChars) */
+    indentLeftChars?: number;
+    /** Right indent in hundredths of a character (w:ind/@w:rightChars) */
+    indentRightChars?: number;
+    /** First line indent in hundredths of a character - negative for hanging (w:ind/@w:firstLineChars or @w:hangingChars) */
+    indentFirstLineChars?: number;
+    /** Whether the character first-line indent is hanging; the sign of a zero does not survive JSON */
+    hangingIndentChars?: boolean;
     /** Paragraph borders (w:pBdr) */
     borders?: {
         top?: BorderSpec;
@@ -820,4 +702,4 @@ interface TableCellFormatting {
     conditionalFormat?: ConditionalFormatStyle;
 }
 
-export { generateThemeTintShadeMatrix as A, type BorderSpec as B, type ColorValue as C, getContrastingColor as D, type EmphasisMark as E, type FloatingTableProperties as F, getThemeTintShadeHex as G, lightenColor as H, resolveColor as I, resolveColorToHex as J, type LineSpacingRule as L, type ParagraphFormatting as P, type RunFontHint as R, type ShadingProperties as S, type TextModernEffects as T, type UnderlineStyle as U, type TextFormatting as a, type TableFormatting as b, type TableRowFormatting as c, type TableCellFormatting as d, type Theme as e, type ThemeColorSlot as f, type CellMargins as g, type ConditionalFormatStyle as h, type ParagraphAlignment as i, type RunLanguage as j, type TabLeader as k, type TabStop as l, type TabStopAlignment as m, type TableBorders as n, type TableLook as o, type TableMeasurement as p, type TableStyleCascade as q, type TableStyleRegion as r, type TableWidthType as s, type TextEffect as t, type ThemeColorScheme as u, type ThemeFont as v, type ThemeFontScheme as w, type ThemeMatrixCell as x, blendColors as y, darkenColor as z };
+export type { ThemeFontScheme as A, BorderSpec as B, ColorValue as C, ShapeTextBody as D, EmphasisMark as E, FloatingTableProperties as F, LineSpacingRule as L, PresetGeometryPathCommand as P, RunFontHint as R, ShadingProperties as S, TextModernEffects as T, UnderlineStyle as U, ParagraphFormatting as a, TextFormatting as b, TableFormatting as c, TableRowFormatting as d, TableCellFormatting as e, Theme as f, CellMargins as g, ConditionalFormatStyle as h, ParagraphAlignment as i, RunLanguage as j, ShapeFill as k, ShapeOutline as l, ShapeType as m, TabLeader as n, TabStop as o, TabStopAlignment as p, TableBorders as q, TableLook as r, TableMeasurement as s, TableStyleCascade as t, TableStyleRegion as u, TableWidthType as v, TextEffect as w, ThemeColorScheme as x, ThemeColorSlot as y, ThemeFont as z };

package/dist/{frameDelta-D965X8yK.d.mts → frameDelta-DMgR8n13.d.mts}

@@ -1,5 +1,5 @@
-import { D as DrawingScene, d as ShapeTextBodyProperties } from './content-MOZ6hKP4.mjs';
-import { T as TextModernEffects } from './formatting-D1EPSaJP.mjs';
+import { T as TextModernEffects } from './formatting-BqrFPeev.mjs';
+import { D as DrawingScene, d as ShapeTextBodyProperties } from './content-DrqzbIr7.mjs';
 
 interface DisplayList {
     /** Contract version. Undefined reads as legacy version 0. */
@@ -57,7 +57,7 @@ interface NoteRegion {
     primitives?: DisplayPrimitive[];
     noteIds?: number[];
     /**
-     * Per-note backlink metadata (W17): the body-doc PM range of each note's
+     * Per-note backlink metadata (W17): the body-doc range of each note's
      * reference mark plus its formatted label, so the a11y mirror can wire
      * note ↔ reference associations (doc-noteref / doc-backlink). Parallel to
      * `noteIds`; undefined = legacy region without backlink data.
@@ -67,7 +67,7 @@ interface NoteRegion {
 /** Backlink metadata for one note in a NoteRegion. */
 interface NoteRegionNote {
     id?: number;
-    /** Body-doc PM range of the reference mark anchoring this note. */
+    /** Body-doc range of the reference mark anchoring this note. */
     anchorDocStart?: number;
     anchorDocEnd?: number;
     /** Formatted reference label (display number / custom mark). File-derived. */
@@ -168,6 +168,11 @@ interface DisplayClipGroupMetadata {
     };
     opacity?: number;
 }
+/** Horizontal paint slot for text laid out with guessed metrics. */
+interface DisplayPaintClip {
+    x: number;
+    w: number;
+}
 interface StructuralRevision {
     scope: 'pmark' | 'table' | 'row' | 'cell';
     author: string;
@@ -221,6 +226,8 @@ interface DocAttrs {
     paraId?: string;
     fromLine?: number;
     toLine?: number;
+    /** Resolved line index within the owning paragraph. */
+    lineIndex?: number;
     /**
      * Table cell the primitive paints inside, when any. The a11y mirror builds
      * real ARIA table semantics (role table/row/cell, aria-row/colindex) from
@@ -288,10 +295,7 @@ interface DocAttrs {
     groupId?: string;
     /** Review presentation for comment-associated primitives. */
     comment?: DisplayCommentMetadata;
-    /**
-     * Scoped clip/group membership. Undefined = ungrouped. Kept as metadata
-     * until the canvas/mirror batch activates `ClipGroupPrimitive` in the union.
-     */
+    /** Scoped clip/group membership. Undefined = ungrouped. */
     clipGroup?: DisplayClipGroupMetadata;
     /** Enclosing table-fragment identity and accessibility semantics. */
     table?: DisplayTableMetadata;
@@ -302,6 +306,7 @@ interface TextRunPrimitive extends DocAttrs {
     x: number;
     baselineY: number;
     width: number;
+    paintClip?: DisplayPaintClip;
     font: string;
     color: string;
     letterSpacing?: number;
@@ -319,7 +324,7 @@ interface TextRunPrimitive extends DocAttrs {
     smallCaps?: boolean;
     /** Hidden run shown in editing view as dimmed/dotted, matching the DOM painter. */
     hidden?: boolean;
-    /** CSS-like shadow effect ported from run formatting. */
+    /** CSS-like shadow effect from run formatting. */
     textShadow?: 'shadow' | 'emboss' | 'imprint';
     /** Outlined / hollow text. */
     textOutline?: boolean;
@@ -343,6 +348,7 @@ interface PositionedGlyph {
     /** Bidi embedding level for this cluster. */
     bidiLevel?: number;
 }
+/** Shaped glyph run with source text for accessibility. */
 interface GlyphRunPrimitive extends DocAttrs {
     kind: 'glyphRun';
     fontId: number;
@@ -350,6 +356,7 @@ interface GlyphRunPrimitive extends DocAttrs {
     color: string;
     text: string;
     glyphs: PositionedGlyph[];
+    paintClip?: DisplayPaintClip;
     fallbackFont?: string;
     wordSpacing?: number;
     rtl?: boolean;
@@ -365,7 +372,7 @@ interface GlyphRunPrimitive extends DocAttrs {
     smallCaps?: boolean;
     /** Hidden run shown in editing view as dimmed/dotted, matching the DOM painter. */
     hidden?: boolean;
-    /** CSS-like shadow effect ported from run formatting. */
+    /** CSS-like shadow effect from run formatting. */
     textShadow?: 'shadow' | 'emboss' | 'imprint';
     /** Outlined / hollow text. */
     textOutline?: boolean;