@adeu/core 1.19.1 → 1.21.0

package/dist/index.d.cts

@@ -75,6 +75,7 @@ declare class DocumentMapper {
     spans: TextSpan[];
     appendix_start_index: number;
     private _text_chunks;
+    private _plain_projection;
     constructor(doc: DocumentObject, clean_view?: boolean, original_view?: boolean);
     private _build_map;
     private _map_blocks;
@@ -86,6 +87,28 @@ declare class DocumentMapper {
     private _add_virtual_text;
     private _replace_smart_quotes;
     private _make_fuzzy_regex;
+    /**
+     * Returns [plain_text, offset_map] where plain_text is full_text with the
+     * VIRTUAL markdown style delimiters (bold/italic markers emitted around
+     * formatted runs) removed, and offset_map[i] is the full_text index of
+     * plain_text[i].
+     *
+     * Formatting run boundaries can fall mid-word (e.g. a paragraph projected
+     * as "**Al**pha"), where neither exact matching nor the whitespace-anchored
+     * fuzzy regex can find the plain target "Alpha". Matching against this
+     * projection and mapping the span back to full_text closes that gap (QA H2).
+     *
+     * Built lazily and invalidated by _build_map(): most batches never need it.
+     */
+    private _get_plain_projection;
+    /**
+     * Matches a markdown-stripped target against the plain projection and maps
+     * each hit back to a [start, length] span in full_text. Interior style
+     * markers end up inside the returned span (so "Alpha" over "**Al**pha"
+     * resolves to the "Al**pha" range); markers just outside the matched
+     * characters are excluded.
+     */
+    private _find_plain_projection_matches;
     find_match_index(target_text: string, is_regex?: boolean): [number, number];
     find_all_match_indices(target_text: string, is_regex?: boolean): [number, number][];
     find_target_runs(target_text: string): Run[];
@@ -207,6 +230,43 @@ declare class RedlineEngine {
      * escalating the regex further.
      */
     private _nearest_match_hint;
+    private static readonly _PREVIEW_WRAPPER_PAIRS;
+    /**
+     * Makes a fixed-width slice of the raw-view projection presentable: drops
+     * complete {>>...<<} meta blocks (annotations of pre-existing changes, not
+     * part of this edit) and any wrapper fragments the window boundary chopped
+     * in half. Without this, previews leak internal scaffolding like
+     * "[Chg:5 delete]" (QA H1). Mirrors the Python engine.
+     */
+    private static _tidy_preview_context;
+    /**
+     * Snapshots the document text around a resolved edit BEFORE anything is
+     * applied. Previews rendered after the batch mutates the DOM cannot slice
+     * full_text at the stored offsets: applied edits shift offsets and inject
+     * tracked-change markup, which produced garbled previews mixing unrelated
+     * edits and internal scaffolding (QA H1).
+     */
+    private _capture_preview_context;
+    /**
+     * Like _capture_preview_context, but snapshots the context around the
+     * ORIGINAL edit's full matched span (stashed by _pre_resolve_heuristic_edit),
+     * so the report preview can present the complete logical change of a
+     * compound modification instead of its first sub-edit.
+     */
+    private _capture_parent_preview_context;
+    /**
+     * Renders the preview from the edit's full matched span. The common
+     * prefix/suffix between matched and replacement text is moved into the
+     * surrounding context so the {--...--}{++...++} block shows the minimal
+     * complete change.
+     */
+    private _build_full_match_preview;
+    /**
+     * The "new text" a batch report should show for an edit. InsertTableRow has
+     * no new_text field — surface its cell contents instead of the misleading
+     * empty string the report used to print (QA M4).
+     */
+    private static _report_new_text;
     private _build_edit_context_previews;
     private _scan_existing_ids;
     private _get_heading_path_and_page;
@@ -328,6 +388,12 @@ declare class RedlineEngine {
     private _clean_wrapping_comments;
     private _delete_comments_in_element;
     validate_edits(edits: any[], index_offset?: number): string[];
+    /**
+     * Number of columns (w:tc elements) in the table row containing the text at
+     * [start, start+length) in `mapper`, or null if that text is not inside a
+     * table row.
+     */
+    private static _column_count_at;
     validate_review_actions(actions: any[]): string[];
     process_batch(changes: DocumentChange[], dry_run?: boolean): any;
     private _process_batch_internal;

package/dist/index.d.ts

@@ -75,6 +75,7 @@ declare class DocumentMapper {
     spans: TextSpan[];
     appendix_start_index: number;
     private _text_chunks;
+    private _plain_projection;
     constructor(doc: DocumentObject, clean_view?: boolean, original_view?: boolean);
     private _build_map;
     private _map_blocks;
@@ -86,6 +87,28 @@ declare class DocumentMapper {
     private _add_virtual_text;
     private _replace_smart_quotes;
     private _make_fuzzy_regex;
+    /**
+     * Returns [plain_text, offset_map] where plain_text is full_text with the
+     * VIRTUAL markdown style delimiters (bold/italic markers emitted around
+     * formatted runs) removed, and offset_map[i] is the full_text index of
+     * plain_text[i].
+     *
+     * Formatting run boundaries can fall mid-word (e.g. a paragraph projected
+     * as "**Al**pha"), where neither exact matching nor the whitespace-anchored
+     * fuzzy regex can find the plain target "Alpha". Matching against this
+     * projection and mapping the span back to full_text closes that gap (QA H2).
+     *
+     * Built lazily and invalidated by _build_map(): most batches never need it.
+     */
+    private _get_plain_projection;
+    /**
+     * Matches a markdown-stripped target against the plain projection and maps
+     * each hit back to a [start, length] span in full_text. Interior style
+     * markers end up inside the returned span (so "Alpha" over "**Al**pha"
+     * resolves to the "Al**pha" range); markers just outside the matched
+     * characters are excluded.
+     */
+    private _find_plain_projection_matches;
     find_match_index(target_text: string, is_regex?: boolean): [number, number];
     find_all_match_indices(target_text: string, is_regex?: boolean): [number, number][];
     find_target_runs(target_text: string): Run[];
@@ -207,6 +230,43 @@ declare class RedlineEngine {
      * escalating the regex further.
      */
     private _nearest_match_hint;
+    private static readonly _PREVIEW_WRAPPER_PAIRS;
+    /**
+     * Makes a fixed-width slice of the raw-view projection presentable: drops
+     * complete {>>...<<} meta blocks (annotations of pre-existing changes, not
+     * part of this edit) and any wrapper fragments the window boundary chopped
+     * in half. Without this, previews leak internal scaffolding like
+     * "[Chg:5 delete]" (QA H1). Mirrors the Python engine.
+     */
+    private static _tidy_preview_context;
+    /**
+     * Snapshots the document text around a resolved edit BEFORE anything is
+     * applied. Previews rendered after the batch mutates the DOM cannot slice
+     * full_text at the stored offsets: applied edits shift offsets and inject
+     * tracked-change markup, which produced garbled previews mixing unrelated
+     * edits and internal scaffolding (QA H1).
+     */
+    private _capture_preview_context;
+    /**
+     * Like _capture_preview_context, but snapshots the context around the
+     * ORIGINAL edit's full matched span (stashed by _pre_resolve_heuristic_edit),
+     * so the report preview can present the complete logical change of a
+     * compound modification instead of its first sub-edit.
+     */
+    private _capture_parent_preview_context;
+    /**
+     * Renders the preview from the edit's full matched span. The common
+     * prefix/suffix between matched and replacement text is moved into the
+     * surrounding context so the {--...--}{++...++} block shows the minimal
+     * complete change.
+     */
+    private _build_full_match_preview;
+    /**
+     * The "new text" a batch report should show for an edit. InsertTableRow has
+     * no new_text field — surface its cell contents instead of the misleading
+     * empty string the report used to print (QA M4).
+     */
+    private static _report_new_text;
     private _build_edit_context_previews;
     private _scan_existing_ids;
     private _get_heading_path_and_page;
@@ -328,6 +388,12 @@ declare class RedlineEngine {
     private _clean_wrapping_comments;
     private _delete_comments_in_element;
     validate_edits(edits: any[], index_offset?: number): string[];
+    /**
+     * Number of columns (w:tc elements) in the table row containing the text at
+     * [start, start+length) in `mapper`, or null if that text is not inside a
+     * table row.
+     */
+    private static _column_count_at;
     validate_review_actions(actions: any[]): string[];
     process_batch(changes: DocumentChange[], dry_run?: boolean): any;
     private _process_batch_internal;