open-agreements 0.7.7 → 0.8.0

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

@@ -1,116 +1,49 @@
-import { LabelType } from './list_labels.js';
-import { type ParagraphAlignment, type RunFormatting } from './styles.js';
+import { deriveTableContext } from './table_context.js';
 import { type FormattingMode } from './formatting_tags.js';
 import type { RelsMap } from './relationships.js';
-export type HeaderFormatting = {
-    bold: boolean;
-    italic: boolean;
-    underline: boolean;
-};
-export type ListMetadata = {
-    list_level: number;
-    label_type: LabelType | null;
-    label_string: string;
-    header_text: string | null;
-    header_style: string | null;
-    header_formatting: HeaderFormatting | null;
-    is_auto_numbered: boolean;
-};
-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 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;
-    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;
-    };
-    header_formatting: HeaderFormatting | null;
-    body_run_formatting: RunFormatting | null;
-    table_context?: TableContext;
-};
-export declare function discoverStyles(nodes: DocumentViewNode[]): DocumentStyles;
-/**
- * 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;
-}): string;
+import type { BuildDocumentViewOptions, DocumentStyles, DocumentViewNode, TableContext } from './document_view-types.js';
+export type { BuildDocumentViewOptions, DocumentViewNode, ListMetadata, TableContext } from './document_view-types.js';
+export type { HeaderFormatting, HeadingSource, HeadingValue, HeuristicHeadingSource } from './document_view-headings.js';
+export { discoverStyles } from './document_view-styles.js';
+export type { DocumentStyleInfo, DocumentStyles, FormattingFingerprint } from './document_view-styles.js';
+export { INLINE_COMMENT_MARKER_RUNTIME, TOON_INLINE_TAG_RE, collectInlineCommentMarkers, tokenizeToonInline } from './document_view-comments.js';
+export type { DocumentViewComment, DocumentViewCommentRange, ToonCommentMarker, ToonCommentMarkerMap, ToonInlineToken } from './document_view-comments.js';
+export { collectTableMarkerInfo, formatTableMarker, formatToonCommentEndnoteLines, formatToonCommentLines, formatToonCommentsEndnotesBlock, formatToonDataLine, renderToon, renderToonWithCommentEndnotes, } from './document_view-toon.js';
 /**
- * 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.
+ * Collect the bookmarked paragraphs of a document, each with its derived table
+ * context, in document order. This is the shared paragraph-collection core used
+ * by BOTH `DocxDocument.buildDocumentView()` and the free `buildDocumentView()`
+ * so the two produce identical node sets.
+ *
+ * Only paragraphs carrying a `_bk_*` bookmark id are included (the document view
+ * addresses nodes by that id). This function does NOT insert bookmarks — a
+ * consumer operating on un-bookmarked source DOCX MUST call
+ * `DocxDocument.insertParagraphBookmarks()` first, or the result is empty.
  */
-export declare function collectTableMarkerInfo(nodes: readonly Pick<DocumentViewNode, 'table_context'>[]): Map<number, {
+export declare function collectViewParagraphs(documentXml: Document): Array<{
     id: string;
-    totalRows: number;
-    totalCols: number;
+    p: Element;
+    tableContext?: ReturnType<typeof deriveTableContext>;
 }>;
 /**
- * Format a #TABLE marker line from collected table info.
- * Headers are omitted — they appear exactly once in the th(0,N) data rows.
+ * Free function form of the document-view builder. Delegates to the same shared
+ * core (`collectViewParagraphs` + `buildNodesForDocumentView`) as
+ * `DocxDocument.buildDocumentView()`, so it returns populated nodes — one per
+ * bookmarked paragraph — rather than the empty stub it used to be.
+ *
+ * Like the method, it includes only paragraphs carrying a `_bk_*` bookmark id
+ * and does NOT insert bookmarks itself.
  */
-export declare function formatTableMarker(info: {
-    id: string;
-    totalRows: number;
-    totalCols: number;
-}): string;
-export declare function renderToon(nodes: DocumentViewNode[], options?: {
-    compact?: boolean;
-}): string;
-export type BuildDocumentViewOptions = {
-    include_semantic_tags?: boolean;
-};
 export declare function buildDocumentView(params: {
     documentXml: Document;
     stylesXml: Document | null;
     numberingXml: Document | null;
-    opts?: BuildDocumentViewOptions;
+    footnotesXml?: Document | null;
+    relsMap?: RelsMap;
+    opts?: BuildDocumentViewOptions & {
+        show_formatting?: boolean;
+        formatting_mode?: FormattingMode;
+    };
 }): {
     nodes: DocumentViewNode[];
     styles: DocumentStyles;
@@ -133,4 +66,20 @@ export declare function buildNodesForDocumentView(params: {
     nodes: DocumentViewNode[];
     styles: DocumentStyles;
 };
+/**
+ * Build a `clean_text → raw_text` offset map for a node. The returned array has
+ * length `clean_text.length + 1`: index `o` (a clean-text offset, `0..length`)
+ * holds the corresponding raw-text offset. A clean span `[cs, ce)` therefore
+ * maps to the raw span `[map[cs], map[ce])`, ready for `replaceTextAtRange`.
+ *
+ * When `node.raw_text` is absent (legacy hand-built fixtures), the map is the
+ * identity — callers operating on real builder output always have `raw_text`.
+ */
+export declare function buildCleanToRawOffsetMap(node: Pick<DocumentViewNode, 'clean_text' | 'raw_text'>): number[];
+/**
+ * Translate a single `clean_text` offset to its `raw_text` offset for a node.
+ * Convenience wrapper over {@link buildCleanToRawOffsetMap}; for translating
+ * many offsets on one node, build the map once and index it directly.
+ */
+export declare function cleanToRawOffset(node: Pick<DocumentViewNode, 'clean_text' | 'raw_text'>, cleanOffset: number): number;
 //# sourceMappingURL=document_view.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"document_view.d.ts","sourceRoot":"","sources":["../../src/primitives/document_view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"document_view.d.ts","sourceRoot":"","sources":["../../src/primitives/document_view.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAK3E,OAAO,EAA8C,KAAK,cAAc,EAA6F,MAAM,sBAAsB,CAAC;AAClM,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAWlD,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EAIhB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACvH,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjJ,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC3J,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,+BAA+B,EAC/B,kBAAkB,EAClB,UAAU,EACV,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AAuCjC;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,QAAQ,GACpB,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;CAAE,CAAC,CAazF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,WAAW,EAAE,QAAQ,CAAC;IACtB,SAAS,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,wBAAwB,GAAG;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;CACnG,GAAG;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAgBxD;AA6QD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAC3E,SAAS,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,YAAY,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC,GAAG;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAuXxD;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,UAAU,CAAC,GAAG,MAAM,EAAE,CAkD1G;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,UAAU,CAAC,EACvD,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR"}