open-agreements 0.7.6 → 0.8.0

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-styles.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentStyles, DocumentViewNode, FormattingFingerprint } from './document_view-types.js';
+export type { DocumentStyleInfo, DocumentStyles, FormattingFingerprint } from './document_view-types.js';
+export declare function fingerprintKey(fp: FormattingFingerprint): string;
+/**
+ * v0.3: Compact style fingerprint token.
+ * Concatenates style name, list level, alignment, and indentation for token-efficient LLM context.
+ * Example: "Normal:L-1:LEFT:I0:H0"
+ */
+export declare function computeFingerprintToken(fp: FormattingFingerprint, styleId?: string): string;
+export declare function discoverStyles(nodes: DocumentViewNode[]): DocumentStyles;
+//# sourceMappingURL=document_view-styles.d.ts.map

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_view-styles.d.ts","sourceRoot":"","sources":["../../src/primitives/document_view-styles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,cAAc,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAE3H,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAIzG,wBAAgB,cAAc,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3F;AA6CD,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,cAAc,CAsCxE"}

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-styles.js

@@ -0,0 +1,104 @@
+import { LabelType } from './list_labels.js';
+const STYLE_EXAMPLE_TEXT_PREVIEW_LENGTH = 50;
+export function fingerprintKey(fp) {
+    // Stable JSON-ish key used for Map lookups.
+    return `${fp.list_level}|${fp.left_indent_pt.toFixed(1)}|${fp.first_line_indent_pt.toFixed(1)}|${fp.style_name}|${fp.alignment}`;
+}
+/**
+ * v0.3: Compact style fingerprint token.
+ * Concatenates style name, list level, alignment, and indentation for token-efficient LLM context.
+ * Example: "Normal:L-1:LEFT:I0:H0"
+ */
+export function computeFingerprintToken(fp, styleId) {
+    const name = styleId || fp.style_name || 'body';
+    const level = `L${fp.list_level}`;
+    const align = fp.alignment;
+    const indent = `I${Math.round(fp.left_indent_pt)}`;
+    const hanging = `H${Math.round(fp.first_line_indent_pt)}`;
+    return `${name}:${level}:${align}:${indent}:${hanging}`;
+}
+function inferSemanticName(params) {
+    const { fp, nodes } = params;
+    // Find first label_type if present.
+    let labelType = null;
+    for (const n of nodes) {
+        if (n.list_metadata.label_type) {
+            labelType = n.list_metadata.label_type;
+            break;
+        }
+    }
+    const listLevel = fp.list_level;
+    if (listLevel >= 0) {
+        if (listLevel === 0) {
+            if (labelType === LabelType.ARTICLE)
+                return { base_id: 'article', display_name: 'Article Heading' };
+            if (labelType === LabelType.SECTION)
+                return { base_id: 'section', display_name: 'Section Heading' };
+            if (labelType === LabelType.ROMAN)
+                return { base_id: 'roman_section', display_name: 'Roman Numeral Section' };
+            return { base_id: 'top_level', display_name: 'Top-Level List Item' };
+        }
+        if (listLevel === 1) {
+            if (labelType === LabelType.LETTER)
+                return { base_id: 'subsection', display_name: 'Subsection (a)/(A)' };
+            if (labelType === LabelType.NUMBER)
+                return { base_id: 'subsection_number', display_name: 'Numbered Subsection' };
+            if (labelType === LabelType.ROMAN)
+                return { base_id: 'subsection_roman', display_name: 'Roman Subsection' };
+            return { base_id: 'level_1', display_name: `Level ${listLevel} List Item` };
+        }
+        if (labelType === LabelType.ROMAN)
+            return { base_id: `level_${listLevel}_roman`, display_name: `Level ${listLevel} Roman` };
+        if (labelType === LabelType.LETTER)
+            return { base_id: `level_${listLevel}_letter`, display_name: `Level ${listLevel} Letter` };
+        return { base_id: `level_${listLevel}`, display_name: `Level ${listLevel} List Item` };
+    }
+    // Non-list.
+    const styleName = fp.style_name.toLowerCase().replace(/\s+/g, '_');
+    if (fp.left_indent_pt > 0)
+        return { base_id: 'indent_block', display_name: 'Indented Block' };
+    if (styleName.includes('heading') || styleName.includes('title'))
+        return { base_id: 'heading', display_name: 'Heading' };
+    if (styleName.includes('quote') || styleName.includes('block'))
+        return { base_id: 'block_quote', display_name: 'Block Quote' };
+    return { base_id: 'body', display_name: 'Body Text' };
+}
+export function discoverStyles(nodes) {
+    const groups = new Map();
+    for (const n of nodes) {
+        const key = fingerprintKey(n.style_fingerprint);
+        const g = groups.get(key);
+        if (g)
+            g.nodes.push(n);
+        else
+            groups.set(key, { fp: n.style_fingerprint, nodes: [n] });
+    }
+    const used = {};
+    const styles = new Map();
+    const fpToStyle = new Map();
+    for (const [fpKey, g] of groups.entries()) {
+        const { base_id, display_name } = inferSemanticName({ fp: g.fp, nodes: g.nodes });
+        let styleId = base_id;
+        if (used[base_id] !== undefined) {
+            used[base_id] += 1;
+            styleId = `${base_id}_${used[base_id]}`;
+        }
+        else {
+            used[base_id] = 0;
+        }
+        const median = g.nodes[Math.floor(g.nodes.length / 2)];
+        const info = {
+            style_id: styleId,
+            display_name,
+            fingerprint: g.fp,
+            example_node_id: median.id,
+            example_text: median.clean_text.slice(0, STYLE_EXAMPLE_TEXT_PREVIEW_LENGTH),
+            count: g.nodes.length,
+            dominant_alignment: g.fp.alignment,
+        };
+        styles.set(styleId, info);
+        fpToStyle.set(fpKey, styleId);
+    }
+    return { styles, fingerprint_to_style: fpToStyle };
+}
+//# sourceMappingURL=document_view-styles.js.map

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_view-styles.js","sourceRoot":"","sources":["../../src/primitives/document_view-styles.ts"],"names":[],"mappings":"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"}

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-toon.d.ts

@@ -0,0 +1,37 @@
+import type { DocumentViewNode, ToonCommentMarkerMap } from './document_view-types.js';
+/**
+ * Format a single toon data line for one DocumentViewNode.
+ * Handles table-context-aware style (th/td) and header stripping.
+ */
+export declare function formatToonDataLine(n: DocumentViewNode, options?: {
+    compact?: boolean;
+    commentMarkers?: ToonCommentMarkerMap;
+}): string;
+/**
+ * Collect table marker info (dimensions) from nodes for #TABLE markers.
+ * Column headers are NOT included in the marker — they appear once in the th() rows.
+ */
+export declare function collectTableMarkerInfo(nodes: readonly Pick<DocumentViewNode, 'table_context'>[]): Map<number, {
+    id: string;
+    totalRows: number;
+    totalCols: number;
+}>;
+/**
+ * Format a #TABLE marker line from collected table info.
+ * Headers are omitted — they appear exactly once in the th(0,N) data rows.
+ */
+export declare function formatTableMarker(info: {
+    id: string;
+    totalRows: number;
+    totalCols: number;
+}): string;
+export declare function formatToonCommentLines(node: Pick<DocumentViewNode, 'id' | 'comments'>): string[];
+export declare function formatToonCommentEndnoteLines(node: Pick<DocumentViewNode, 'id' | 'comments'>): string[];
+export declare function formatToonCommentsEndnotesBlock(nodes: readonly Pick<DocumentViewNode, 'id' | 'comments'>[]): string[];
+export declare function renderToon(nodes: DocumentViewNode[], options?: {
+    compact?: boolean;
+}): string;
+export declare function renderToonWithCommentEndnotes(nodes: DocumentViewNode[], options?: {
+    compact?: boolean;
+}): string;
+//# sourceMappingURL=document_view-toon.d.ts.map

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-toon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_view-toon.d.ts","sourceRoot":"","sources":["../../src/primitives/document_view-toon.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAuB,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAyB5G;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,gBAAgB,EACnB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,oBAAoB,CAAA;CAAE,GACrE,MAAM,CAkDR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,EAAE,GACxD,GAAG,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAcnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEpG;AAgCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,CAAC,GAAG,MAAM,EAAE,CAEhG;AAoBD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,CAAC,GAAG,MAAM,EAAE,CAEvG;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,UAAU,CAAC,EAAE,GAC1D,MAAM,EAAE,CAKV;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAqCjG;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,gBAAgB,EAAE,EACzB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,MAAM,CA+BR"}

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-toon.js

@@ -0,0 +1,199 @@
+import { collectInlineCommentMarkers, countVisibleTextCharacters, injectToonCommentMarkers } from './document_view-comments.js';
+import { computeFingerprintToken } from './document_view-styles.js';
+function headerStripFromText(params) {
+    // Mirrors Python TOONRenderer header stripping.
+    const { header } = params;
+    let { text } = params;
+    if (!header)
+        return text;
+    const headerNorm = header.trim().toLowerCase();
+    const textLower = text.toLowerCase();
+    for (const punct of [':', '.', '-', ';', '']) {
+        const testPrefix = `${headerNorm}${punct}`;
+        if (textLower.startsWith(testPrefix)) {
+            text = text.slice(testPrefix.length).trimStart();
+            return text;
+        }
+    }
+    if (text.startsWith(header)) {
+        text = text.slice(header.length).replace(/^[.:\-;]+/, '').trimStart();
+    }
+    return text;
+}
+/**
+ * Format a single toon data line for one DocumentViewNode.
+ * Handles table-context-aware style (th/td) and header stripping.
+ */
+export function formatToonDataLine(n, options) {
+    let text = n.tagged_text;
+    let header = n.header;
+    let strippedPrefixVisibleLength = 0;
+    if (header) {
+        const strippedText = headerStripFromText({ header, text });
+        strippedPrefixVisibleLength = Math.max(0, countVisibleTextCharacters(text) - countVisibleTextCharacters(strippedText));
+        text = strippedText;
+    }
+    if (header && !text) {
+        text = header;
+        header = '';
+        strippedPrefixVisibleLength = 0;
+    }
+    const commentMarkers = options?.commentMarkers?.get(n.id);
+    if (commentMarkers && commentMarkers.length > 0) {
+        // Comment marker offsets are computed against the FULL paragraph visible text (raw
+        // run/char counting in `getComments()`). To translate to `tagged_text` positions we
+        // subtract:
+        //  1. `visible_offset_correction` — chars stripped at build time when extracting the
+        //     manual list label and trimming following whitespace.
+        //  2. `strippedPrefixVisibleLength` — chars stripped at format time by the run-in-header
+        //     extraction above.
+        const totalCorrection = (n.visible_offset_correction ?? 0) + strippedPrefixVisibleLength;
+        text = injectToonCommentMarkers(text, commentMarkers.map(({ offset, marker }) => ({
+            offset: Math.max(0, offset - totalCorrection),
+            marker,
+        })));
+    }
+    const tc = n.table_context;
+    let style;
+    if (tc) {
+        style = tc.is_header_row
+            ? `th(${tc.row_index},${tc.col_index})`
+            : `td(${tc.row_index},${tc.col_index})`;
+    }
+    else {
+        style = options?.compact
+            ? computeFingerprintToken(n.style_fingerprint, n.style)
+            : n.style;
+    }
+    return `${n.id} | ${n.list_label} | ${header} | ${style} | ${text}`;
+}
+/**
+ * Collect table marker info (dimensions) from nodes for #TABLE markers.
+ * Column headers are NOT included in the marker — they appear once in the th() rows.
+ */
+export function collectTableMarkerInfo(nodes) {
+    const info = new Map();
+    for (const n of nodes) {
+        const tc = n.table_context;
+        if (!tc)
+            continue;
+        if (!info.has(tc.table_index)) {
+            info.set(tc.table_index, {
+                id: tc.table_id,
+                totalRows: tc.total_rows,
+                totalCols: tc.total_cols,
+            });
+        }
+    }
+    return info;
+}
+/**
+ * Format a #TABLE marker line from collected table info.
+ * Headers are omitted — they appear exactly once in the th(0,N) data rows.
+ */
+export function formatTableMarker(info) {
+    return `#TABLE ${info.id} | ${info.totalRows} rows × ${info.totalCols} cols`;
+}
+function escapeToonCommentField(value) {
+    return value
+        .replaceAll('\r\n', '\\n')
+        .replaceAll('\r', '\\r')
+        .replaceAll('\n', '\\n')
+        .replaceAll('|', '\\|');
+}
+function formatCommentDate(date) {
+    return date ?? '-';
+}
+function collectToonCommentLines(comment, paragraphId, parentId) {
+    const author = escapeToonCommentField(comment.author || '-');
+    const date = formatCommentDate(comment.date);
+    const text = escapeToonCommentField(comment.text);
+    const line = parentId == null
+        ? `#COMMENT ${paragraphId} c${comment.id} ${author} ${date} | ${text}`
+        : `#REPLY c${comment.id} -> c${parentId} ${author} ${date} | ${text}`;
+    return [
+        line,
+        ...comment.replies.flatMap((reply) => collectToonCommentLines(reply, paragraphId, comment.id)),
+    ];
+}
+export function formatToonCommentLines(node) {
+    return node.comments?.flatMap((comment) => collectToonCommentLines(comment, node.id)) ?? [];
+}
+function collectToonCommentEndnoteLines(comment, paragraphId, parentId) {
+    const author = escapeToonCommentField(comment.author || '-');
+    const date = formatCommentDate(comment.date);
+    const text = escapeToonCommentField(comment.text);
+    const line = parentId == null
+        ? `c${comment.id} @ ${paragraphId} ${author} ${date} | ${text}`
+        : `c${comment.id} -> c${parentId} ${author} ${date} | ${text}`;
+    return [
+        line,
+        ...comment.replies.flatMap((reply) => collectToonCommentEndnoteLines(reply, paragraphId, comment.id)),
+    ];
+}
+export function formatToonCommentEndnoteLines(node) {
+    return node.comments?.flatMap((comment) => collectToonCommentEndnoteLines(comment, node.id)) ?? [];
+}
+export function formatToonCommentsEndnotesBlock(nodes) {
+    const commentLines = nodes.flatMap((node) => formatToonCommentEndnoteLines(node));
+    return commentLines.length > 0
+        ? ['#COMMENTS', ...commentLines]
+        : [];
+}
+export function renderToon(nodes, options = {}) {
+    const lines = ['#SCHEMA id | list_label | header | style | text'];
+    const commentMarkers = collectInlineCommentMarkers(nodes);
+    const lineOptions = { ...options, commentMarkers };
+    // Pre-scan: collect table marker info for #TABLE lines
+    const tableInfo = collectTableMarkerInfo(nodes);
+    let currentTableIndex = null;
+    for (const n of nodes) {
+        const tc = n.table_context;
+        const nodeTableIndex = tc ? tc.table_index : null;
+        // Close previous table if we left it or moved to a different table
+        if (currentTableIndex !== null && nodeTableIndex !== currentTableIndex) {
+            lines.push('#END_TABLE');
+            currentTableIndex = null;
+        }
+        // Open new table if entering one
+        if (nodeTableIndex !== null && currentTableIndex === null) {
+            const info = tableInfo.get(nodeTableIndex);
+            if (info)
+                lines.push(formatTableMarker(info));
+            currentTableIndex = nodeTableIndex;
+        }
+        lines.push(formatToonDataLine(n, lineOptions));
+        lines.push(...formatToonCommentLines(n));
+    }
+    // Close any open table at end
+    if (currentTableIndex !== null) {
+        lines.push('#END_TABLE');
+    }
+    return lines.join('\n');
+}
+export function renderToonWithCommentEndnotes(nodes, options = {}) {
+    const lines = ['#SCHEMA id | list_label | header | style | text'];
+    const tableInfo = collectTableMarkerInfo(nodes);
+    let currentTableIndex = null;
+    for (const n of nodes) {
+        const tc = n.table_context;
+        const nodeTableIndex = tc ? tc.table_index : null;
+        if (currentTableIndex !== null && nodeTableIndex !== currentTableIndex) {
+            lines.push('#END_TABLE');
+            currentTableIndex = null;
+        }
+        if (nodeTableIndex !== null && currentTableIndex === null) {
+            const info = tableInfo.get(nodeTableIndex);
+            if (info)
+                lines.push(formatTableMarker(info));
+            currentTableIndex = nodeTableIndex;
+        }
+        lines.push(formatToonDataLine(n, options));
+    }
+    if (currentTableIndex !== null) {
+        lines.push('#END_TABLE');
+    }
+    lines.push(...formatToonCommentsEndnotesBlock(nodes));
+    return lines.join('\n');
+}
+//# sourceMappingURL=document_view-toon.js.map

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-toon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_view-toon.js","sourceRoot":"","sources":["../../src/primitives/document_view-toon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAChI,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,SAAS,mBAAmB,CAAC,MAAwC;IACnE,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAU,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,GAAG,UAAU,GAAG,KAAK,EAAE,CAAC;QAC3C,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,CAAmB,EACnB,OAAsE;IAEtE,IAAI,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC;IACzB,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,2BAA2B,GAAG,CAAC,CAAC;IAEpC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,YAAY,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,2BAA2B,GAAG,IAAI,CAAC,GAAG,CACpC,CAAC,EACD,0BAA0B,CAAC,IAAI,CAAC,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAC5E,CAAC;QACF,IAAI,GAAG,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,IAAI,GAAG,MAAM,CAAC;QACd,MAAM,GAAG,EAAE,CAAC;QACZ,2BAA2B,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,mFAAmF;QACnF,oFAAoF;QACpF,YAAY;QACZ,qFAAqF;QACrF,2DAA2D;QAC3D,yFAAyF;QACzF,wBAAwB;QACxB,MAAM,eAAe,GAAG,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,CAAC,GAAG,2BAA2B,CAAC;QACzF,IAAI,GAAG,wBAAwB,CAC7B,IAAI,EACJ,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC;YAC7C,MAAM;SACP,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC;IAC3B,IAAI,KAAa,CAAC;IAClB,IAAI,EAAE,EAAE,CAAC;QACP,KAAK,GAAG,EAAE,CAAC,aAAa;YACtB,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,GAAG;YACvC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,GAAG,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,OAAO,EAAE,OAAO;YACtB,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC;YACvD,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,UAAU,MAAM,MAAM,MAAM,KAAK,MAAM,IAAI,EAAE,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAyD;IAEzD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAgE,CAAC;IACrF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC;QAC3B,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE;gBACvB,EAAE,EAAE,EAAE,CAAC,QAAQ;gBACf,SAAS,EAAE,EAAE,CAAC,UAAU;gBACxB,SAAS,EAAE,EAAE,CAAC,UAAU;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA0D;IAC1F,OAAO,UAAU,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,CAAC;AAC/E,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,KAAK;SACT,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC;SACzB,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;SACvB,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAmB;IAC5C,OAAO,IAAI,IAAI,GAAG,CAAC;AACrB,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAA4B,EAC5B,WAAmB,EACnB,QAAiB;IAEjB,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI;QAC3B,CAAC,CAAC,YAAY,WAAW,KAAK,OAAO,CAAC,EAAE,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE;QACtE,CAAC,CAAC,WAAW,OAAO,CAAC,EAAE,QAAQ,QAAQ,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,CAAC;IAExE,OAAO;QACL,IAAI;QACJ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;KAC/F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAA+C;IACpF,OAAO,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9F,CAAC;AAED,SAAS,8BAA8B,CACrC,OAA4B,EAC5B,WAAmB,EACnB,QAAiB;IAEjB,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAI;QAC3B,CAAC,CAAC,IAAI,OAAO,CAAC,EAAE,MAAM,WAAW,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE;QAC/D,CAAC,CAAC,IAAI,OAAO,CAAC,EAAE,QAAQ,QAAQ,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,CAAC;IAEjE,OAAO;QACL,IAAI;QACJ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;KACtG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAA+C;IAC3F,OAAO,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAA2D;IAE3D,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC;QAChC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAyB,EAAE,UAAiC,EAAE;IACvF,MAAM,KAAK,GAAa,CAAC,iDAAiD,CAAC,CAAC;IAC5E,MAAM,cAAc,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,CAAC;IAEnD,uDAAuD;IACvD,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAEhD,IAAI,iBAAiB,GAAkB,IAAI,CAAC;IAE5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC;QAC3B,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QAElD,mEAAmE;QACnE,IAAI,iBAAiB,KAAK,IAAI,IAAI,cAAc,KAAK,iBAAiB,EAAE,CAAC;YACvE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,iBAAiB,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,iCAAiC;QACjC,IAAI,cAAc,KAAK,IAAI,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC3C,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,iBAAiB,GAAG,cAAc,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,8BAA8B;IAC9B,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAyB,EACzB,UAAiC,EAAE;IAEnC,MAAM,KAAK,GAAa,CAAC,iDAAiD,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAEhD,IAAI,iBAAiB,GAAkB,IAAI,CAAC;IAE5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC;QAC3B,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QAElD,IAAI,iBAAiB,KAAK,IAAI,IAAI,cAAc,KAAK,iBAAiB,EAAE,CAAC;YACvE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,iBAAiB,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,cAAc,KAAK,IAAI,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC3C,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,iBAAiB,GAAG,cAAc,CAAC;QACrC,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-types.d.ts

@@ -0,0 +1,165 @@
+import type { LabelType } from './list_labels.js';
+import type { ParagraphAlignment, RunFormatting } from './styles.js';
+export type HeaderFormatting = {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+};
+export type HeadingSource = 'word_style' | 'run_in_header' | 'title_with_period' | 'title_with_colon' | 'title_caps_centered' | 'title_bare';
+export type HeuristicHeadingSource = Exclude<HeadingSource, 'word_style'>;
+export type HeadingValue = {
+    /**
+     * Heading label text. Semantics depend on `source`:
+     * - `word_style`: the full paragraph text (the entire paragraph IS the heading).
+     * - All heuristic sources (`run_in_header`, `title_with_period`, `title_with_colon`,
+     *   `title_caps_centered`, `title_bare`): only the extracted heading prefix.
+     *   For example, on `"Indemnification. The Company shall …"` the value is
+     *   `"Indemnification"`, not the whole paragraph.
+     */
+    text: string;
+    source: HeadingSource;
+    level: number | null;
+};
+export type FormattingFingerprint = {
+    list_level: number;
+    left_indent_pt: number;
+    first_line_indent_pt: number;
+    style_name: string;
+    alignment: ParagraphAlignment;
+};
+export type DocumentStyleInfo = {
+    style_id: string;
+    display_name: string;
+    fingerprint: FormattingFingerprint;
+    example_node_id: string;
+    example_text: string;
+    count: number;
+    dominant_alignment: ParagraphAlignment;
+};
+export type DocumentStyles = {
+    styles: Map<string, DocumentStyleInfo>;
+    fingerprint_to_style: Map<string, string>;
+};
+export type DocumentViewCommentRange = {
+    startParagraphId: string;
+    endParagraphId: string;
+    startRunIndex?: number;
+    startCharOffset?: number;
+    endRunIndex?: number;
+    endCharOffset?: number;
+};
+export type DocumentViewComment = {
+    id: number;
+    author: string;
+    date: string | null;
+    initials: string;
+    text: string;
+    replies: DocumentViewComment[];
+    range?: DocumentViewCommentRange;
+};
+export type ToonCommentMarker = {
+    offset: number;
+    marker: string;
+};
+export type ToonCommentMarkerMap = Map<string, ToonCommentMarker[]>;
+/** A single token produced by {@link tokenizeToonInline}. */
+export type ToonInlineToken = {
+    kind: 'tag';
+    value: string;
+} | {
+    kind: 'text';
+    value: string;
+};
+export type ListMetadata = {
+    list_level: number;
+    label_type: LabelType | null;
+    label_string: string;
+    header_text: string | null;
+    header_style: HeuristicHeadingSource | null;
+    header_formatting: HeaderFormatting | null;
+    is_auto_numbered: boolean;
+};
+export type TableContext = {
+    table_id: string;
+    table_index: number;
+    row_index: number;
+    col_index: number;
+    col_header: string;
+    total_rows: number;
+    total_cols: number;
+    is_header_row: boolean;
+    para_in_cell: number;
+    cell_para_count: number;
+};
+export type DocumentViewNode = {
+    id: string;
+    list_label: string;
+    header: string;
+    style: string;
+    text: string;
+    clean_text: string;
+    /**
+     * Raw visible paragraph text (field codes stripped) BEFORE CR/LF removal,
+     * trimming, and manual-list-label stripping — i.e. exactly `getParagraphText(p)`.
+     * This is the coordinate system that `replaceParagraphTextRange` /
+     * `DocxDocument.replaceTextAtRange` operate in. Selector patterns are authored
+     * against `clean_text`; {@link buildCleanToRawOffsetMap} uses `raw_text` +
+     * `clean_text` to translate a matched clean-text span back to raw offsets so
+     * mutation lands on the right characters.
+     *
+     * Optional only so legacy test fixtures that hand-build nodes stay valid; the
+     * real builder (`buildNodesForDocumentView`) always populates it.
+     */
+    raw_text?: string;
+    tagged_text: string;
+    list_metadata: ListMetadata;
+    style_fingerprint: FormattingFingerprint;
+    paragraph_style_id: string | null;
+    paragraph_style_name: string;
+    paragraph_alignment: ParagraphAlignment;
+    paragraph_indents_pt: {
+        left: number;
+        first_line: number;
+    };
+    numbering: {
+        num_id: string | null;
+        ilvl: number | null;
+        is_auto_numbered: boolean;
+    };
+    heading?: HeadingValue;
+    /**
+     * Footnote references this paragraph visibly anchors, in document order, each
+     * with the display number assigned by the view's numbering authority (the
+     * sequential scan of `document.xml` references, reserved separator IDs
+     * skipped). References inside field code (between `w:fldChar` begin and
+     * separate) are hidden text and excluded. This is the single derivation of
+     * "which footnotes does this paragraph reference" — consumers render from it
+     * instead of re-walking the paragraph DOM. Omitted when empty, matching the
+     * `heading` convention.
+     * @see #393
+     */
+    footnote_refs?: Array<{
+        id: number;
+        display: number;
+    }>;
+    header_formatting: HeaderFormatting | null;
+    body_run_formatting: RunFormatting | null;
+    table_context?: TableContext;
+    comments?: DocumentViewComment[];
+    /**
+     * Number of visible characters stripped from the head of the raw paragraph text when
+     * extracting a manual list label (and trimming the trailing whitespace). Used by the
+     * inline-comment-marker injector to translate run/offset positions (which are computed
+     * against the FULL paragraph visible text by `getComments()`) into positions within
+     * `tagged_text` (which has the label stripped).
+     *
+     * Auto-numbered list paragraphs do NOT have their text stripped — their label lives in
+     * the `list_label` field separately — so this stays 0 for them. Run-in header stripping
+     * is handled separately at format time and is not included here.
+     */
+    visible_offset_correction?: number;
+};
+export type BuildDocumentViewOptions = {
+    include_semantic_tags?: boolean;
+};
+//# sourceMappingURL=document_view-types.d.ts.map

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_view-types.d.ts","sourceRoot":"","sources":["../../src/primitives/document_view-types.ts"],"names":[],"mappings":"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"}

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document_view-types.js.map

package/node_modules/@usejunior/docx-core/dist/primitives/document_view-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_view-types.js","sourceRoot":"","sources":["../../src/primitives/document_view-types.ts"],"names":[],"mappings":""}