wordinweb 0.1.10 → 0.1.12

package/README.md

@@ -119,7 +119,7 @@ The object passed to `onReady`. Every command operates on the current selection
 - `insertBlankPage()` — inserts a complete blank page at the caret.
 - `insertCoverPage({ title, subtitle?, author? })` — prepends an editable, styled cover page.
 - `setLineNumbering(patch, scope?)`, `getLineNumbering()`.
-- `openHeaderFooter("header" | "footer")`, `closeHeaderFooter()` — create or directly enter page header/footer editing; Escape closes it.
+- `openHeaderFooter("header" | "footer")`, `closeHeaderFooter()` — create or directly enter the repeating page layer; shapes and lines inserted there repeat on the pages using that header/footer. Escape closes it.
 
 **Tables**
 - `insertTable(rows, cols)`.
@@ -128,7 +128,7 @@ The object passed to `onReady`. Every command operates on the current selection
 **Images**
 - `insertImage(file)` — inserts a raster image or editable SVG icon inline at the caret, clamped to the column width (TIFF/WMF/EMF are decoded to something the browser can paint).
 - `insertScreenshot()` — opens the browser screen/window/tab picker and inserts the captured frame as an editable PNG picture.
-- `insertModel3D(file, poster?)` — packages a GLB as a native Office 3D model with an editable poster fallback.
+- `insertModel3D(file, poster?)` — packages a GLB as a native Office 3D model; editable documents show a drag-to-rotate viewport and save the orientation back to Word.
 - `insertOnlineVideo(url)` — inserts Word online-video metadata with a safe browser poster; double-click opens the validated HTTP(S) URL.
 - `insertEmbeddedObject(file, filename?)` — embeds any file as a native OLE Package; double-click safely downloads the original file in the browser.
 
@@ -139,7 +139,7 @@ The object passed to `onReady`. Every command operates on the current selection
 - `insertField(instruction, cachedResult?)`, `insertDateTime("date" | "time", picture?)` — live Word fields.
 - `addBookmark(name)`, `listBookmarks()`, `insertCrossReference(name, "text" | "page")` — named bookmark targets and live `REF` / `PAGEREF` fields.
 - `insertEquation(linear)`, `insertSymbol(symbol)` — native editable OMML equations and arbitrary Unicode symbols.
-- `insertShape(preset, text?)` — floating editable DrawingML rectangles, rounded rectangles, ellipses, diamonds, and text boxes. Advanced mode also exposes Text Box as its own Insert control.
+- `insertShape(preset, text?)` — floating editable DrawingML lines, rectangles, rounded rectangles, ellipses, diamonds, and text boxes. Selected objects expose exact page position, size, outline, wrapping, and layer controls.
 - `insertWordArt(text, preset?)` — editable DrawingML WordArt with plain, arch, wave, and chevron presets.
 - `insertChart(data)`, `updateSelectedChart(data)` — native editable ChartML with its embedded workbook.
 - `insertSmartArt(data)`, `updateSelectedSmartArt(data)` — native editable SmartArt data, layout, style, colors, and cached drawing parts.
@@ -167,6 +167,10 @@ The object passed to `onReady`. Every command operates on the current selection
 
 A ready-made formatting toolbar for an editable `DocxView`. Use `mode="simple"` for the basic Home editing strip or `mode="advanced"` for the full Home / Insert / Draw / Layout ribbon supported by the installed version.
 Layout includes Word-style paper presets plus a custom width/height dialog; both document and current-section scope emit native page-size properties.
+Editable text also has a right-click menu for clipboard, formatting, links,
+comments, lists, and alignment. Word-style shortcuts include heading levels,
+page breaks, links, comments, lists, and paragraph alignment in addition to the
+standard formatting and history commands.
 
 | Prop | Type | What it does |
 | --- | --- | --- |

package/dist/index.d.ts

@@ -109,6 +109,11 @@ interface RunProps {
     smallCaps?: boolean;
     /** Letter spacing px (w:spacing, twips in OOXML). */
     letterSpacing?: number;
+    /** Minimum font size in px at which w:kern enables pair kerning; null is
+     * the explicit w:kern=0 override. */
+    kerningThreshold?: number | null;
+    /** Paint-only letter spacing when layout advances intentionally differ. */
+    paintLetterSpacing?: number;
     /** w:w horizontal character scaling as a fraction (1.5 = 150%). */
     textScale?: number;
     /** w:fitText target width in px: the run's advances scale so its text
@@ -284,6 +289,12 @@ interface ImageContent {
 interface Model3DReference {
     part: string;
     posterPart: string;
+    /** Native Office model orientation, in degrees around the X/Y/Z axes. */
+    rotation?: {
+        x: number;
+        y: number;
+        z: number;
+    };
 }
 interface WebVideoReference {
     url: string;
@@ -376,6 +387,9 @@ interface MathContent {
      * display-style layout - larger n-ary operators with limits stacked
      * above/below, and full-size fraction numerators/denominators. */
     display?: boolean;
+    /** Display group with several direct equations. Word leaves a small
+     * advance after script clusters in these grouped displays. */
+    multiEquationDisplay?: boolean;
     /** m:oMathParaPr/m:jc - display-equation justification. Absent: the
      * document default (settings m:mathPr/m:defJc, itself "centerGroup" when
      * unset). */
@@ -521,13 +535,11 @@ interface ShapeWordArt {
     /** Clockwise degrees. */
     rotation: number;
     behind?: boolean;
-    /** The v:textpath font-size (px). Only used when the text is NOT fit to the
-     * shape (see noFit). */
+    /** The source v:textpath font-size (px). */
     fontSize?: number;
     /** The referenced v:shapetype has a malformed text-guide path (missing
-     * coordinates), so Word cannot compute the fitshape scale and falls back to
-     * drawing the string at its nominal font-size — a near-invisible mark rather
-     * than a box-filling watermark. Render at fontSize, unstretched, to match. */
+     * coordinates), so Word collapses its horizontal glyph outlines into a thin
+     * vertical band instead of painting a box-filling watermark. */
     noFit?: boolean;
     /** Source VML shape element (v:shape / v:rect) for interactive editing:
      * the v:textpath string, fill/opacity, and rotation live under it. */
@@ -724,6 +736,8 @@ interface DrawingTextShape {
     };
     /** Vertical anchoring of the text inside the box (bodyPr anchor). */
     textAnchor?: "top" | "middle" | "bottom";
+    /** DrawingML cached text paint-only baseline adjustment in px. */
+    paintOffsetY?: number;
 }
 interface DrawingPath {
     /** Position/size inside the drawing, px. */
@@ -803,6 +817,8 @@ interface Paragraph {
 interface TableCellProps {
     /** Preferred width px (from tcW when dxa). */
     width?: number;
+    /** The source explicitly declares tcW type="auto" (distinct from no tcW). */
+    widthAuto?: boolean;
     gridSpan: number;
     vMerge?: "restart" | "continue";
     borders?: {
@@ -1140,6 +1156,9 @@ declare class DocxDocument {
     /** Note content by note id (render-only; sources stripped). */
     readonly footnotes: Map<number, Block[]>;
     readonly endnotes: Map<number, Block[]>;
+    /** The separator paragraph controls the gap between its rule and the first
+     * footnote. */
+    readonly footnoteSeparator: Block[];
     /** `_Ref` cross-reference bookmark ranges (name → captured runs). REF
      * fields re-render the referenced text from these — Word recomputes REF on
      * open, so the cached field result in the file is stale. */
@@ -1228,6 +1247,10 @@ declare class DocxDocument {
      * single-threaded and sequential per section. */
     charGridEa: boolean;
     private constructor();
+    /** Resolve content controls mapped to standard package core properties.
+     * Word refreshes these bindings on open, so the serialized sdtContent can
+     * be stale even though the visible value comes from docProps/core.xml. */
+    private hydrateCorePropertyControls;
     /** Repair only objects emitted by older WordInWeb builds that Word rejects. */
     private repairLegacyWordInWebObjects;
     /**
@@ -1422,6 +1445,8 @@ interface FontSpec {
     size: number;
     bold: boolean;
     italic: boolean;
+    /** Pair kerning is active because the run met its w:kern size threshold. */
+    kerning?: boolean;
     /** Optional PAINT-only family tried before `family` in the CSS stack, without
      * affecting metrics or width lookups (keyed by `family`). Used for CJK: the
      * line-pitch profile stays keyed by the macOS substitute face while the real
@@ -1686,10 +1711,10 @@ interface WordArtItem {
     /** Clockwise degrees. */
     rotation: number;
     behind?: boolean;
-    /** v:textpath font-size (px), used only when noFit is set. */
+    /** Source v:textpath font-size (px). */
     fontSize?: number;
-    /** Malformed shapetype guide path: render at nominal fontSize, unstretched
-     * (Word can't fitshape, so it draws a near-invisible mark). */
+    /** Malformed shapetype guide path: Word collapses the fitted glyph outlines
+     * into a thin vertical band. */
     noFit?: boolean;
     /** Source VML shape element (v:shape / v:rect), for interactive select/edit. */
     src?: XmlElement;