@wordinweb/agent 0.2.4 → 0.2.6

package/dist/cli.js

@@ -7,7 +7,7 @@ import {
   isSuggestable,
   isSuggestableTableOp,
   stretchShareCode
-} from "./chunk-JK7OGOJB.js";
+} from "./chunk-32YIZ3LI.js";
 
 // src/cli.ts
 import { webcrypto } from "crypto";

package/dist/index.d.ts

@@ -1,13 +1,3 @@
-/**
- * Minimal, fast XML parser producing a lightweight element tree.
- *
- * OOXML parts are machine-generated, namespace-prefixed, well-formed XML with
- * no DTDs. This parser handles exactly that subset: elements, attributes,
- * text, CDATA, comments, processing instructions, and the built-in + numeric
- * character entities. Namespace prefixes are kept verbatim (`w:p`), and
- * lookups match on either the full name or the local name, which is robust
- * for every mainstream producer (Word, LibreOffice, Google Docs export).
- */
 interface XmlElement {
     name: string;
     attrs: Record<string, string>;
@@ -45,6 +35,8 @@ interface Border {
      * sz-4 rule contributes 0.5pt, not the floored 0.5625pt (phase23 p66:
      * 45 rows drift 2.5px down without it). */
     rawWidth?: number;
+    /** w:shadow: a strip outside the right and bottom borders. */
+    shadow?: boolean;
 }
 interface ParagraphBorders {
     top?: Border;
@@ -139,6 +131,8 @@ interface RunProps {
     /** Character style id (w:rStyle). */
     styleId?: string;
     lang?: string;
+    /** w:lang w:bidi — the language of the run's complex-script text (Arabic, Hebrew, Indic, Thai, ...). */
+    langBidi?: string;
 }
 interface NumberingRef {
     numId: number;
@@ -324,6 +318,11 @@ type MathNode = ({
     /** m:func function name (cos, log, …): Word kerns a thin space on
      * both sides of the name. */
     fname?: boolean;
+    /** The run's w:rPr color (hex, no #), strike and underline, when set:
+     * a redline marks an equation's runs with them. */
+    color?: string;
+    strike?: boolean;
+    underline?: string;
 } | {
     t: "sup" | "sub";
     base: MathNode[];
@@ -417,6 +416,9 @@ interface FieldContent {
     kind: "field";
     /** Raw field instruction, e.g. ` PAGE \\* MERGEFORMAT `. */
     instruction: string;
+    /** Instruction text and nested fields in source order. `instruction` uses
+     * their stored results; layout evaluates these parts to build the code. */
+    instructionParts?: (string | FieldContent)[];
     /** Last cached result text from the file, used for unsupported fields. */
     cachedResult: string;
     /** When this field is a legacy FORMCHECKBOX, the source `w:checkBox` element
@@ -478,6 +480,8 @@ interface ShapeTextbox {
     pctHeightRel?: "page" | "margin";
     /** Vertical anchoring of the text INSIDE the box (v-text-anchor). */
     textAnchor?: "top" | "middle" | "bottom";
+    /** Text direction: clockwise top-to-bottom or counter-clockwise bottom-to-top. */
+    vert?: "vert" | "vert270";
     /** How body text flows around a DrawingML textbox (wp:wrap*). */
     wrap?: WrapMode;
     /** behindDoc: paint under the body text, never displace it. */
@@ -607,8 +611,8 @@ interface ShapeArt {
     behind?: boolean;
     /** a:xfrm rotation, degrees clockwise. */
     rotation?: number;
-    /** wp:wrapSquare/.../wrapTopAndBottom on the anchor. Only FRAME stories
-     * (header/footer/cell) act on it - body flow ignores art wrap, as before. */
+    /** wp:wrapSquare/.../wrapTopAndBottom on the anchor (w10:wrap on a VML
+     * group): text wraps around the art as around a text box. */
     wrap?: WrapMode;
     /** wp:anchor dist* in px, used with `wrap`. */
     dist?: {
@@ -670,6 +674,14 @@ interface ShapeImage {
 type Shape = (ShapeLine | ShapeTextbox | ShapeImage | ShapeArt | ShapeWordArt) & {
     /** wp:anchor relativeHeight, used for object stacking order. */
     z?: number;
+    /** Print with markup only: the shape's run is a tracked change, so the
+     * layout frames the shape's box in the author's color, struck through
+     * when the change is a deletion or a move away. The balloon and the
+     * change bar come from the run's changes, at the anchor's line. */
+    revision?: {
+        color: string;
+        struck: boolean;
+    };
 };
 /**
  * Floating/anchored object: does not occupy inline space; positioned against
@@ -915,12 +927,34 @@ interface RubyContent {
     align?: "center" | "distributeLetter" | "distributeSpace" | "left" | "right" | "rightVertical";
 }
 type RunContent = MathContent | TextContent | BreakContent | TabContent | PTabContent | ImageContent | FieldContent | AnchorContent | DrawingContent | NoteRefContent | RubyContent;
+/**
+ * A tracked change a printed markup page shows beside its text (see
+ * pdf/comments.ts): what it is, in Word's words, and who made it when.
+ * Set only when the document is parsed for print with author colors.
+ */
+interface Revision {
+    /** Unique over the document: the element's kind and w:id. */
+    id: string;
+    kind: "ins" | "del" | "moveTo" | "moveFrom" | "format";
+    author: string;
+    /** w:date, verbatim: Word writes local time there (see word-date.ts). */
+    date?: string;
+    /** True UTC time from the w16du:dateUtc attribute, when present. */
+    dateUtc?: string;
+    /** The balloon's text: "Inserted", "Deleted", "Moved from", "Moved to",
+     * "Inserted row", "Deleted row", "Formatted: Font: Bold", ... */
+    label: string;
+}
 interface Run {
     type: "run";
     props: RunProps;
     content: RunContent[];
     /** Source w:r element. */
     src?: XmlElement;
+    /** The tracked changes this run is part of, or whose balloon anchors at
+     * it (a paragraph's, row's or table's format change is put on each of its
+     * runs). Print with markup only. */
+    changes?: Revision[];
     /** Element whose children array contains src (w:p, w:hyperlink, …). */
     srcParent?: XmlElement;
 }
@@ -928,6 +962,8 @@ interface Hyperlink {
     type: "hyperlink";
     href?: string;
     anchor?: string;
+    /** Complex HYPERLINK whose target contains nested fields. */
+    field?: FieldContent;
     runs: Run[];
 }
 type ParaChild = Run | Hyperlink;
@@ -942,6 +978,18 @@ interface Paragraph {
     /** Final revision view: the paragraph mark AND all content are tracked
      * deletions — the paragraph does not exist (no line, no numbering). */
     revisionHidden?: boolean;
+    /** Markup view: the paragraph mark itself is a tracked insertion or
+     * deletion (a suggested line break, or a suggested merge). Layout draws it
+     * as a pilcrow in the revision's colors after the paragraph's content; it is
+     * not text, so find, word count and the like never see it. */
+    markRevision?: "ins" | "del";
+    /** The mark's pilcrow color when the markup is printed with author colors. */
+    markRevisionColor?: string;
+    /** Print with markup only: the tracked changes anchored at the paragraph
+     * mark, which the layout's mark run carries so they get a balloon and a
+     * change bar — the mark's own insertion or deletion, and the body's final
+     * section change (w:sectPrChange) on the last paragraph. */
+    markChanges?: Revision[];
     /** Source w:p element. */
     src?: XmlElement;
 }
@@ -978,6 +1026,12 @@ interface TableCell {
     blocks: Block[];
 }
 interface TableRowProps {
+    /** Empty grid columns before/after the row's cells. */
+    gridBefore?: number;
+    gridAfter?: number;
+    /** Preferred widths in px of the omitted columns (wBefore/wAfter). */
+    widthBefore?: number;
+    widthAfter?: number;
     /** px; undefined = auto */
     height?: number;
     heightRule?: "auto" | "atLeast" | "exact";
@@ -1160,8 +1214,10 @@ interface DocComment {
     id: string;
     author: string;
     initials?: string;
-    /** ISO timestamp from w:date, verbatim. */
+    /** w:date, verbatim: Word writes local time there (see word-date.ts). */
     date?: string;
+    /** True UTC time from commentsExtensible.xml (w16cex:dateUtc), when present. */
+    dateUtc?: string;
     /** Plain text of the comment body (paragraphs joined with newlines). */
     text: string;
     /** w14:paraId of the comment's last body paragraph (threading key). */
@@ -1173,6 +1229,26 @@ interface DocComment {
      * thread parent; Word grays the whole thread from the parent's flag. */
     resolved?: boolean;
 }
+/** A reviewer from word/people.xml (w15:person): the display name, and the
+ * identity the presence provider knows them by (w15:presenceInfo). */
+interface DocPerson {
+    author: string;
+    providerId?: string;
+    userId?: string;
+}
+/** A font file the package embeds (word/fonts/*.odttf), from fontTable.xml:
+ * a w:font's w:embedRegular, w:embedBold, w:embedItalic or w:embedBoldItalic. */
+interface DocEmbeddedFont {
+    /** The family the document names (w:font w:name). */
+    family: string;
+    bold: boolean;
+    italic: boolean;
+    /** The package part that holds the file. */
+    part: string;
+    /** The w:fontKey GUID the file is obfuscated with (ECMA-376 Part 1
+     * §17.8.1); absent when the file is a plain font. */
+    key?: string;
+}
 interface HeaderFooter {
     blocks: Block[];
 }
@@ -1263,6 +1339,11 @@ interface Theme {
 /** A read-only view over the OPC (zip) package inside a .docx file. */
 declare class Package {
     private files;
+    /** Every entry is held to ZipBudget before any is inflated. fflate
+     * inflates an entry into a buffer of the size the directory gives, so an
+     * entry whose data holds more stops there: memory stays within the
+     * budget, and the entry fails, or comes out cut short (an XML part then
+     * fails to parse). */
     constructor(data: Uint8Array);
     static from(data: ArrayBuffer | Uint8Array): Package;
     /** A package over an already-unzipped entry map (DocxDocument.clone). */
@@ -1407,6 +1488,18 @@ declare class StableIds {
     } | null;
 }
 
+interface ParseContext {
+    theme?: Theme;
+    /** Tracked-changes display: "final" hides deletions and shows insertions
+     * plain (default); "markup" colors both. */
+    revisionView?: "final" | "markup";
+    /** Markup printed with Word's author colors: each author's color, in the
+     * order the authors first appear; a run in a change records the change
+     * (Run.changes). Absent, the markup view colors insertions green and
+     * deletions red for every author, as the editor shows them. */
+    revisionColor?: (author: string) => string;
+}
+
 interface Relationship {
     id: string;
     type: string;
@@ -1415,13 +1508,41 @@ interface Relationship {
 }
 type Relationships = Map<string, Relationship>;
 
+interface DocParseContext extends ParseContext {
+    rels: Relationships;
+    /** Text boxes parsed from a header/footer part edit as independent stories. */
+    independentTextboxStories?: boolean;
+    /** Read another package part's XML (SmartArt cached drawings live in
+     * word/diagrams/drawing*.xml, reachable only through the data part). */
+    readPart?: (part: string) => XmlElement | undefined;
+    /** Cross-reference bookmark capture: Word's Insert-Cross-Reference targets
+     * are `_RefNNN` bookmarks whose range delimits the referenced text (e.g. a
+     * caption's "Figure " + SEQ field). REF fields re-render that text at
+     * layout time — the docx cache is stale. `open` is keyed by bookmark id
+     * while the range is unclosed; `byName` keeps the finished run lists. */
+    refBookmarks?: {
+        open: Map<string, Run[]>;
+        byName: Map<string, Run[]>;
+    };
+}
+
 /** The two note parts a document can carry — see notePartsHolding. */
 type NotePart = "footnotes" | "endnotes";
-/**
- * A fully parsed .docx: sections of blocks, styles, numbering, theme, and
- * header/footer parts, with helpers to resolve effective formatting.
- */
-declare class DocxDocument {
+interface FromFilesOptions {
+    /** Build the header and footer block models (`headers`, `footers`). Default true. */
+    headerFooterBlocks?: boolean;
+    /** Tracked-changes display from the start, so the parts parsed at load
+     * (headers, footers, notes) follow it too. Default "final". */
+    revisionView?: "final" | "markup";
+    /** Print markup: each author's changes in Word's color for that author,
+     * and every change recorded on its runs (see Revision). */
+    revisionColors?: boolean;
+    /** With revisionColors: false gives every author's changes the first
+     * color, red, so that no color tells one author from another (print
+     * without authors). Default true. */
+    revisionAuthors?: boolean;
+}
+declare class DocxDocument$1 {
     /** Changes whenever refresh() rebuilds the parsed model. Plain in-place text
      * edits can keep this stable so incremental layout reuses model-only caches. */
     private _modelVersion;
@@ -1434,15 +1555,20 @@ declare class DocxDocument {
     styles: Styles;
     numbering: Numbering;
     sections: Section[];
-    /** Header/footer parts keyed by relationship id from document.xml.rels. */
+    /** Header/footer parts keyed by relationship id from document.xml.rels.
+     * Empty when the document was opened without them (fromFiles). */
     readonly headers: Map<string, HeaderFooter>;
     readonly footers: Map<string, HeaderFooter>;
+    private readonly headerFooterBlocks;
     /** Note content by note id. */
     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[];
+    /** The w:continuationSeparator footnote: it opens a note area that starts
+     * with a note continued from the previous page. */
+    readonly footnoteContinuationSeparator: 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. */
@@ -1494,12 +1620,18 @@ declare class DocxDocument {
     /** Review comments from word/comments.xml (empty when the part is absent).
      * Re-derived from the retained comments XML on every refresh(). */
     comments: DocComment[];
+    /** The reviewers word/people.xml names (empty when the part is absent). */
+    readonly people: DocPerson[];
+    /** The font files the package embeds, as fontTable.xml lists them (empty when it embeds none). */
+    readonly embeddedFonts: DocEmbeddedFont[];
     /** Retained comments.xml tree (editing + save round-trip), when present. */
     private commentsPart;
     private commentsRoot;
     /** Retained commentsExtended.xml tree (comment threading), when present. */
     private commentsExtPart;
     private commentsExtRoot;
+    /** True UTC comment times from commentsExtensible.xml, by the comment's last w14:paraId. */
+    private readonly commentDateUtc;
     private commentsExtDirty;
     /** Conditional table formats per table style id, keyed by the Styles object
      * so re-parsing styles.xml (edits) naturally invalidates the cache. */
@@ -1559,12 +1691,18 @@ declare class DocxDocument {
     private readonly ctxBase;
     /** Tracked-changes display mode; refresh() re-derives after changes. */
     revisionView: "final" | "markup";
+    /** The revision authors in the order they first appeared, for revisionColor. */
+    private readonly revisionAuthors;
+    /** FromFilesOptions.revisionAuthors. */
+    private revisionAuthorColors;
     private readonly relsPath;
     private relsRoot;
     private contentTypesRoot;
-    /** Canonical XML as first parsed from each always-modeled package part.
-     * If the retained tree still matches on save, keep the part's original
-     * bytes instead of replacing producer formatting such as CRLF line ends. */
+    /** A fingerprint of the canonical XML first parsed from each always-modeled
+     * package part. If the retained tree still matches on save, keep the part's
+     * original bytes instead of replacing producer formatting such as CRLF line
+     * ends. A fingerprint and not the XML itself: the XML was a second copy of
+     * every document part, 30 MB for a 0.85 MB .docx. */
     private readonly originalModeledXml;
     private docPrIdCounter;
     /** Transient layout state: set by the engine while laying out a docGrid
@@ -1573,7 +1711,11 @@ declare class DocxDocument {
      * section. Safe as document-scoped mutable state because layout is
      * single-threaded and sequential per section. */
     charGridEa: boolean;
-    private constructor();
+    protected constructor(pkg: Package, options?: FromFilesOptions);
+    private readonly coreProperties;
+    /** Resolve the content controls under `root` as the document's own were
+     * resolved when it loaded, for body XML parsed outside it (stream/body.ts). */
+    hydrateControls(root: XmlElement): void;
     /** 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. */
@@ -1584,6 +1726,12 @@ declare class DocxDocument {
      * Re-derive the document model from the retained XML trees. Called after
      * edit commands mutate the XML.
      */
+    /** An author's revision color: Word's "by author" palette, given out in
+     * the order the authors first appear (the parts parsed at load, headers,
+     * footers and notes, before the body), the ninth author taking the first
+     * color again. Without authors (FromFilesOptions.revisionAuthors), the
+     * first color for all. */
+    revisionColor(author: string): string;
     /** Switch tracked-changes display and re-derive the model. */
     setRevisionView(view: "final" | "markup"): void;
     /** Invalidated on refresh; see layoutGlobalSig. */
@@ -1764,6 +1912,13 @@ declare class DocxDocument {
      * type keep it — and its part's content. True when anything was added.
      */
     ensureHfVariantParts(type: "first" | "even"): boolean;
+    /**
+     * A new empty header or footer part, referenced as `type` from `sectPr`
+     * alone. Returns the part's target, as headerFooterRoot and
+     * relationshipsOf take it. compareDocuments gives a header the revised
+     * document lost one of these, to hold the original's content struck.
+     */
+    addHfPart(kind: "header" | "footer", type: "default" | "first" | "even", sectPr: XmlElement): string;
     /** Create and register a new empty header/footer part — package part,
      * document relationship, content-type override, hfParts entry — with no
      * section references of its own; the caller decides which sectPrs point at
@@ -1912,7 +2067,13 @@ declare class DocxDocument {
      * copy of the revised document, and the round trip through the zip was a
      * third of its time on a document that had not changed at all.
      */
-    clone(): DocxDocument;
+    clone(): DocxDocument$1;
+    /**
+     * The package's parts as save() writes them, before they are zipped: a
+     * writer that streams the zip to disk (compare-cli) takes them one at a
+     * time, without a zip of them all in memory and its unzip.
+     */
+    saveFiles(): Record<string, Uint8Array>;
     saveAsync(): Promise<Uint8Array>;
     private buildPackage;
     private buildPackageFiles;
@@ -1964,7 +2125,7 @@ declare class DocxDocument {
      * its w:drawing, and without its image part the result's reject-all
      * brought the picture back as an empty frame.
      */
-    adoptRelFrom(source: DocxDocument, relId: string, scope?: {
+    adoptRelFrom(source: DocxDocument$1, relId: string, scope?: {
         from?: string | null;
         into?: string | null;
     }): string | null;
@@ -2024,7 +2185,21 @@ declare class DocxDocument {
         colorsRelId: string;
         drawingRelId: string;
     };
-    static load(data: ArrayBuffer | Uint8Array): DocxDocument;
+    /** A document from .docx bytes, including Strict Open XML packages. */
+    static load(data: ArrayBuffer | Uint8Array): DocxDocument$1;
+    /** A document over parts already unzipped (stream/body.ts's shell). */
+    /**
+     * A document over an already-unzipped entry map. With `headerFooterBlocks`
+     * false, `headers` and `footers` stay empty: their XML is still read,
+     * compared and saved, but no block models are built from it (about 1 KB a
+     * paragraph), for a caller that compares the document and never lays it out
+     * (compare-cli).
+     */
+    static fromFiles(files: Record<string, Uint8Array>, options?: FromFilesOptions): DocxDocument$1;
+    /** The context the body's blocks are parsed with, for a caller that keeps
+     * the body outside the document (stream/body.ts). Its REF bookmark capture
+     * starts empty; the caller decides whether `refBookmarks` reads from it. */
+    bodyParseContext(): DocParseContext;
     media(part: string): Uint8Array | undefined;
     /**
      * Pending-media registry (plan doc 05 change 1 / doc 16 §6): parts whose
@@ -2096,6 +2271,17 @@ declare class DocxDocument {
     numberingInstance(numId: number): NumInstance | undefined;
     private findDocumentPart;
     private readXmlOptional;
+    /** A part Word prints (the document, a header or footer, the notes, the
+     * comments), refused when it holds a w:altChunk anywhere. */
+    private readPrintedXml;
+}
+
+/** Word documents, including binary .doc and the oldest Word formats. */
+declare class DocxDocument extends DocxDocument$1 {
+    private constructor();
+    static load(data: ArrayBuffer | Uint8Array): DocxDocument;
+    static fromFiles(files: Record<string, Uint8Array>, options?: FromFilesOptions): DocxDocument;
+    clone(): DocxDocument;
 }
 
 /** Outline/shadow for an ordinary run — Word's Home-tab "Text Effects and

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   validateAgentComposeRequest,
   validateAgentOperationShape,
   validateIntent
-} from "./chunk-JK7OGOJB.js";
+} from "./chunk-32YIZ3LI.js";
 
 // src/session.ts
 var LocalDocumentSession = class {

package/dist/{wmf-KUCU4S75.js → wmf-AG7P5P7E.js}

@@ -60,6 +60,9 @@ function isMathTypeEscape(bytes, offset, length) {
   const name = [77, 97, 116, 104, 84, 121, 112, 101];
   return name.every((value, i) => bytes[offset + 10 + i] === value);
 }
+function isEmbeddedEmfEscape(view, params, end) {
+  return params + 8 <= end && view.getUint16(params, true) === 15 && view.getUint32(params + 4, true) === 1128680791;
+}
 function hasMathTypeEscapes(bytes) {
   const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
   let offset = 18;
@@ -129,7 +132,7 @@ function prepareWmf(input) {
         }
         append(copy);
       }
-    } else if (fn === META_ESCAPE && mathType) {
+    } else if (fn === META_ESCAPE && (mathType || !isEmbeddedEmfEscape(view, params, offset + length))) {
     } else if (fn !== META_SETBKCOLOR) {
       append(bytes.slice(offset, offset + length));
     }
@@ -190,4 +193,4 @@ export {
   prepareWmf,
   renderWmf
 };
-//# sourceMappingURL=wmf-KUCU4S75.js.map
+//# sourceMappingURL=wmf-AG7P5P7E.js.map

package/dist/wmf-AG7P5P7E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../core/src/render/wmf.ts"],"sourcesContent":["import * as WmfModule from \"wmf\";\n\nconst WMF = (WmfModule.default ?? WmfModule) as typeof WmfModule.default;\n\nconst META_EOF = 0x0000;\nconst META_SETBKCOLOR = 0x0201;\nconst META_SETTEXTALIGN = 0x012e;\nconst META_MOVETO = 0x0214;\nconst META_LINETO = 0x0213;\nconst META_POLYLINE = 0x0325;\nconst META_ESCAPE = 0x0626;\nconst META_EXTTEXTOUT = 0x0a32;\nconst PLACEABLE_KEY = 0x9ac6cdd7;\n\nconst SYMBOL_TEXT: Record<string, string> = {\n  p: \"π\",\n  \"¥\": \"∞\",\n  \"¶\": \"∂\",\n  å: \"∑\",\n  D: \"Δ\",\n};\n\nexport function decodeWmfText(text: string, family: string): { text: string; family: string } {\n  if (family === \"Symbol\") {\n    return { text: [...text].map((char) => SYMBOL_TEXT[char] ?? char).join(\"\"), family };\n  }\n  if (family === \"ËÎÌå\") {\n    return { text: text.replace(/£¨/g, \"（\").replace(/£©/g, \"）\"), family: \"SimSun\" };\n  }\n  return { text, family };\n}\n\nfunction record(fn: number, params: Uint8Array): Uint8Array {\n  const length = 6 + params.length + (params.length & 1);\n  const out = new Uint8Array(length);\n  const view = new DataView(out.buffer);\n  view.setUint32(0, length / 2, true);\n  view.setUint16(4, fn, true);\n  out.set(params, 6);\n  return out;\n}\n\nfunction polyline(from: [number, number], to: [number, number]): Uint8Array {\n  const params = new Uint8Array(10);\n  const view = new DataView(params.buffer);\n  view.setUint16(0, 2, true);\n  view.setInt16(2, from[0], true);\n  view.setInt16(4, from[1], true);\n  view.setInt16(6, to[0], true);\n  view.setInt16(8, to[1], true);\n  return record(META_POLYLINE, params);\n}\n\nfunction textRecord(char: number, x: number, y: number, advance: number): Uint8Array {\n  const params = new Uint8Array(12);\n  const view = new DataView(params.buffer);\n  view.setInt16(0, y, true);\n  view.setInt16(2, x, true);\n  view.setUint16(4, 1, true);\n  params[8] = char;\n  view.setInt16(10, advance, true);\n  return record(META_EXTTEXTOUT, params);\n}\n\nfunction isMathTypeEscape(bytes: Uint8Array, offset: number, length: number): boolean {\n  if (length < 18) return false;\n  const name = [0x4d, 0x61, 0x74, 0x68, 0x54, 0x79, 0x70, 0x65];\n  return name.every((value, i) => bytes[offset + 10 + i] === value);\n}\n\n/** A META_ESCAPE MFCOMMENT that carries part of an embedded EMF (comment identifier \"WMFC\"). */\nfunction isEmbeddedEmfEscape(view: DataView, params: number, end: number): boolean {\n  return params + 8 <= end && view.getUint16(params, true) === 0x000f && view.getUint32(params + 4, true) === 0x43464d57;\n}\n\nfunction hasMathTypeEscapes(bytes: Uint8Array): boolean {\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  let offset = 18;\n  while (offset + 6 <= bytes.length) {\n    const length = view.getUint32(offset, true) * 2;\n    if (length < 6 || offset + length > bytes.length) return false;\n    const fn = view.getUint16(offset + 4, true);\n    if (fn === META_ESCAPE && isMathTypeEscape(bytes, offset, length)) return true;\n    offset += length;\n    if (fn === META_EOF) break;\n  }\n  return false;\n}\n\n/**\n * Make MathType's legacy WMF records consumable by the small `wmf` renderer.\n * MathType positions text through TA_UPDATECP + MOVETO and draws fraction bars\n * with LINETO. The dependency does not implement those records, so translate\n * them to the equivalent absolute EXTTEXTOUT and POLYLINE records first.\n */\nexport function prepareWmf(input: Uint8Array): Uint8Array | null {\n  let bytes = input;\n  if (bytes.length >= 22 && new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint32(0, true) === PLACEABLE_KEY) {\n    bytes = bytes.subarray(22);\n  }\n  if (bytes.length < 18) return null;\n\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  const mathType = hasMathTypeEscapes(bytes);\n  const parts: Uint8Array[] = [bytes.slice(0, 18)];\n  let offset = 18;\n  let textAlign = 0;\n  let current: [number, number] = [0, 0];\n  let maxRecordWords = 0;\n\n  const append = (part: Uint8Array) => {\n    parts.push(part);\n    maxRecordWords = Math.max(maxRecordWords, part.length / 2);\n  };\n\n  while (offset + 6 <= bytes.length) {\n    const length = view.getUint32(offset, true) * 2;\n    if (length < 6 || offset + length > bytes.length) return null;\n    const fn = view.getUint16(offset + 4, true);\n    const params = offset + 6;\n\n    if (fn === META_SETTEXTALIGN) {\n      textAlign = view.getUint16(params, true);\n      append(bytes.slice(offset, offset + length));\n    } else if (fn === META_MOVETO) {\n      current = [view.getInt16(params + 2, true), view.getInt16(params, true)];\n    } else if (fn === META_LINETO) {\n      const next: [number, number] = [view.getInt16(params + 2, true), view.getInt16(params, true)];\n      append(polyline(current, next));\n      current = next;\n    } else if (fn === META_EXTTEXTOUT) {\n      const y = view.getInt16(params, true);\n      const x = view.getInt16(params + 2, true);\n      const count = view.getUint16(params + 4, true);\n      const options = view.getUint16(params + 6, true);\n      let charsAt = params + 8 + (options & 6 ? 8 : 0);\n      const advancesAt = charsAt + count + (count & 1);\n      const hasAdvances = options === 0 && advancesAt + count * 2 <= offset + length;\n\n      if (hasAdvances) {\n        let position: [number, number] = textAlign & 1 ? current : [x, y];\n        for (let i = 0; i < count; i++) {\n          const advance = view.getInt16(advancesAt + i * 2, true);\n          append(textRecord(bytes[charsAt + i], position[0], position[1], advance));\n          position = [position[0] + advance, position[1]];\n        }\n        if (textAlign & 1) current = position;\n      } else {\n        const copy = bytes.slice(offset, offset + length);\n        if (textAlign & 1) {\n          const copyView = new DataView(copy.buffer, copy.byteOffset, copy.byteLength);\n          copyView.setInt16(6, current[1], true);\n          copyView.setInt16(8, current[0], true);\n        }\n        append(copy);\n      }\n    } else if (fn === META_ESCAPE && (mathType || !isEmbeddedEmfEscape(view, params, offset + length))) {\n      // An escape other than an embedded EMF (MathType metadata, printer\n      // escapes, other comments) is not a drawing command. The dependency\n      // otherwise rejects the whole image on it.\n    } else if (fn !== META_SETBKCOLOR) {\n      append(bytes.slice(offset, offset + length));\n    }\n\n    offset += length;\n    if (fn === META_EOF) break;\n  }\n\n  const total = parts.reduce((sum, part) => sum + part.length, 0);\n  const out = new Uint8Array(total);\n  let at = 0;\n  for (const part of parts) {\n    out.set(part, at);\n    at += part.length;\n  }\n  const outView = new DataView(out.buffer);\n  outView.setUint32(6, total / 2, true);\n  outView.setUint32(12, maxRecordWords, true);\n  return out;\n}\n\nexport function renderWmf(bytes: Uint8Array, width: number, height: number): string | null {\n  try {\n    const prepared = prepareWmf(bytes);\n    if (!prepared) return null;\n    const [rawWidth, rawHeight] = WMF.image_size(prepared).map(Math.abs);\n    if (!rawWidth || !rawHeight) return null;\n\n    const scale = Math.max(1, window.devicePixelRatio || 1);\n    const canvas = document.createElement(\"canvas\");\n    canvas.width = Math.max(1, Math.round(width * scale));\n    canvas.height = Math.max(1, Math.round(height * scale));\n    const ctx = canvas.getContext(\"2d\");\n    if (!ctx) return null;\n    ctx.fillStyle = \"#fff\";\n    ctx.fillRect(0, 0, canvas.width, canvas.height);\n    ctx.fillStyle = \"#000\";\n    ctx.scale(canvas.width / rawWidth, canvas.height / rawHeight);\n\n    const actions = WMF.get_actions(prepared);\n    for (const action of actions) {\n      if (!action.s) continue;\n      delete action.s.Extent;\n      if (action.t === \"text\" && action.v !== undefined && action.s.Font) {\n        const decoded = decodeWmfText(action.v, action.s.Font.Name);\n        action.v = decoded.text;\n        action.s.Font.Name = decoded.family;\n      }\n      if (action.t === \"poly\") {\n        action.s.Pen ??= { Style: 0, Width: 1, Color: 0 };\n        action.s.Brush ??= { Style: 1, Color: 0 };\n      }\n    }\n    WMF.render_canvas(actions, canvas);\n    return canvas.toDataURL(\"image/png\");\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wordinweb/agent",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Complete, schema-enforced DOCX creation, inspection, and editing tools for AI agents",
   "license": "MIT",
   "repository": {