@adeu/core 1.27.0 → 1.29.0

package/dist/index.d.cts

@@ -128,6 +128,23 @@ declare class DocumentMapper {
      * characters are excluded.
      */
     private _find_plain_projection_matches;
+    /**
+     * True when no run-backed span overlaps [start, start+length): the range
+     * covers only virtual projection text — meta bubbles (change/comment
+     * headers, timestamps), style markers, list prefixes. Such text does not
+     * exist in the document, so it can neither satisfy a match nor count
+     * toward ambiguity (QA 2026-07-19 ADEU-QA-002 C): an edit targeting "4"
+     * used to be rejected as "appears 8 times" because a comment bubble's
+     * timestamp matched.
+     *
+     * Anchor tokens ({#Bookmark}, {#cell:paraId}) are the exception: they are
+     * deliberate virtual TARGETING surfaces (empty-cell writes, bookmark
+     * anchors) and must stay matchable.
+     */
+    range_is_virtual_only(start: number, length: number): boolean;
+    /** Filters find_all_match_indices output down to matches that touch at
+     * least one run-backed span. See range_is_virtual_only. */
+    drop_virtual_only_matches(matches: [number, number][]): [number, number][];
     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[];
@@ -291,7 +308,12 @@ declare class RedlineEngine {
     private _build_edit_context_previews;
     private _scan_existing_ids;
     private _get_heading_path_and_page;
-    accept_all_revisions(): void;
+    accept_all_revisions(): {
+        accepted_insertions: number;
+        accepted_deletions: number;
+        accepted_formatting: number;
+        removed_comments: number;
+    };
     /**
      * Revert every tracked change, returning the document to the state it had
      * before any revision was proposed. The exact inverse of
@@ -386,6 +408,7 @@ declare class RedlineEngine {
      *
      * Does NOT attach comments; callers handle that.
      */
+    private _clone_pPr_scrubbing_headings;
     private _track_insert_multiline;
     /**
      * Builds a single tracked-insert wrapper (<w:ins>) containing one or more
@@ -431,7 +454,10 @@ declare class RedlineEngine {
      * actions, so it can be stale mid-batch. Returns null if not found.
      */
     private _get_comment_author;
+    /** Returns how many comment BODIES were actually deleted (see below: only
+     *  our own are; foreign ones keep their body and lose only the anchor). */
     private _clean_wrapping_comments;
+    /** Returns how many comment bodies were deleted. */
     private _delete_comments_in_element;
     validate_edits(edits: any[], index_offset?: number): string[];
     /**
@@ -451,7 +477,42 @@ declare class RedlineEngine {
     process_batch(changes: DocumentChange[], dry_run?: boolean): any;
     private _process_batch_internal;
     apply_edits(edits: any[], page_offsets?: number[]): [number, number];
-    apply_review_actions(actions: any[]): [number, number];
+    /**
+     * True when the paragraph still carries visible content (w:t text, w:tab,
+     * w:br) that is NOT wrapped in a tracked deletion — i.e. the paragraph
+     * would render non-empty in the accepted document.
+     */
+    private _paragraph_has_visible_content;
+    /**
+     * All contiguous same-author w:ins/w:del siblings that form one logical
+     * modification block with `node` (a replacement's del+ins pair). Mirrors
+     * the Python engine's _get_paired_nodes: comment range markers and
+     * rPr/pPr are transparent; a different author or any other element breaks
+     * the group.
+     */
+    private _get_paired_nodes;
+    /**
+     * All revision ids that resolve as ONE unit with `target_id`: the ids of
+     * every contiguous same-author w:ins/w:del sibling of its elements (a
+     * replacement's del+ins pair), plus the id itself.
+     */
+    private _resolution_group_ids;
+    /**
+     * Document-aware validation (QA 2026-07-19 ADEU-QA-004): a replacement's
+     * del+ins pair carries two distinct ids but resolves as one unit, so a
+     * batch that accepts one side and rejects the other is contradictory.
+     * Rejecting it up front — before any action mutates the document — keeps
+     * the batch transactional.
+     */
+    validate_action_pairing(actions: any[]): string[];
+    /**
+     * Returns [applied, skipped, already_resolved]. `applied` counts actions
+     * that caused an observable state transition; an action naming an id an
+     * earlier action of this batch already resolved (via its replacement pair)
+     * is counted in `already_resolved` instead — never as applied
+     * (QA 2026-07-19 ADEU-QA-004).
+     */
+    apply_review_actions(actions: any[]): [number, number, number];
     private _apply_table_edit;
     private _pre_resolve_heuristic_edit;
     /**

package/dist/index.d.ts

@@ -128,6 +128,23 @@ declare class DocumentMapper {
      * characters are excluded.
      */
     private _find_plain_projection_matches;
+    /**
+     * True when no run-backed span overlaps [start, start+length): the range
+     * covers only virtual projection text — meta bubbles (change/comment
+     * headers, timestamps), style markers, list prefixes. Such text does not
+     * exist in the document, so it can neither satisfy a match nor count
+     * toward ambiguity (QA 2026-07-19 ADEU-QA-002 C): an edit targeting "4"
+     * used to be rejected as "appears 8 times" because a comment bubble's
+     * timestamp matched.
+     *
+     * Anchor tokens ({#Bookmark}, {#cell:paraId}) are the exception: they are
+     * deliberate virtual TARGETING surfaces (empty-cell writes, bookmark
+     * anchors) and must stay matchable.
+     */
+    range_is_virtual_only(start: number, length: number): boolean;
+    /** Filters find_all_match_indices output down to matches that touch at
+     * least one run-backed span. See range_is_virtual_only. */
+    drop_virtual_only_matches(matches: [number, number][]): [number, number][];
     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[];
@@ -291,7 +308,12 @@ declare class RedlineEngine {
     private _build_edit_context_previews;
     private _scan_existing_ids;
     private _get_heading_path_and_page;
-    accept_all_revisions(): void;
+    accept_all_revisions(): {
+        accepted_insertions: number;
+        accepted_deletions: number;
+        accepted_formatting: number;
+        removed_comments: number;
+    };
     /**
      * Revert every tracked change, returning the document to the state it had
      * before any revision was proposed. The exact inverse of
@@ -386,6 +408,7 @@ declare class RedlineEngine {
      *
      * Does NOT attach comments; callers handle that.
      */
+    private _clone_pPr_scrubbing_headings;
     private _track_insert_multiline;
     /**
      * Builds a single tracked-insert wrapper (<w:ins>) containing one or more
@@ -431,7 +454,10 @@ declare class RedlineEngine {
      * actions, so it can be stale mid-batch. Returns null if not found.
      */
     private _get_comment_author;
+    /** Returns how many comment BODIES were actually deleted (see below: only
+     *  our own are; foreign ones keep their body and lose only the anchor). */
     private _clean_wrapping_comments;
+    /** Returns how many comment bodies were deleted. */
     private _delete_comments_in_element;
     validate_edits(edits: any[], index_offset?: number): string[];
     /**
@@ -451,7 +477,42 @@ declare class RedlineEngine {
     process_batch(changes: DocumentChange[], dry_run?: boolean): any;
     private _process_batch_internal;
     apply_edits(edits: any[], page_offsets?: number[]): [number, number];
-    apply_review_actions(actions: any[]): [number, number];
+    /**
+     * True when the paragraph still carries visible content (w:t text, w:tab,
+     * w:br) that is NOT wrapped in a tracked deletion — i.e. the paragraph
+     * would render non-empty in the accepted document.
+     */
+    private _paragraph_has_visible_content;
+    /**
+     * All contiguous same-author w:ins/w:del siblings that form one logical
+     * modification block with `node` (a replacement's del+ins pair). Mirrors
+     * the Python engine's _get_paired_nodes: comment range markers and
+     * rPr/pPr are transparent; a different author or any other element breaks
+     * the group.
+     */
+    private _get_paired_nodes;
+    /**
+     * All revision ids that resolve as ONE unit with `target_id`: the ids of
+     * every contiguous same-author w:ins/w:del sibling of its elements (a
+     * replacement's del+ins pair), plus the id itself.
+     */
+    private _resolution_group_ids;
+    /**
+     * Document-aware validation (QA 2026-07-19 ADEU-QA-004): a replacement's
+     * del+ins pair carries two distinct ids but resolves as one unit, so a
+     * batch that accepts one side and rejects the other is contradictory.
+     * Rejecting it up front — before any action mutates the document — keeps
+     * the batch transactional.
+     */
+    validate_action_pairing(actions: any[]): string[];
+    /**
+     * Returns [applied, skipped, already_resolved]. `applied` counts actions
+     * that caused an observable state transition; an action naming an id an
+     * earlier action of this batch already resolved (via its replacement pair)
+     * is counted in `already_resolved` instead — never as applied
+     * (QA 2026-07-19 ADEU-QA-004).
+     */
+    apply_review_actions(actions: any[]): [number, number, number];
     private _apply_table_edit;
     private _pre_resolve_heuristic_edit;
     /**