@adeu/core 1.25.0 → 1.26.0

package/dist/index.d.cts

@@ -67,6 +67,7 @@ interface TextSpan {
     comment_ids?: string[];
     part_index: number;
     is_image_marker?: boolean;
+    run_offset?: number;
 }
 declare class DocumentMapper {
     doc: DocumentObject;
@@ -393,6 +394,18 @@ declare class RedlineEngine {
      */
     private _build_tracked_ins_for_line;
     private _parse_markdown_style;
+    /**
+     * True when this edit's target or replacement text carries explicit
+     * bold/italic markers, making the markers AUTHORITATIVE for the inserted
+     * runs' formatting. Replacing `**X**` with `_X_` must yield italic-only
+     * text, and replacing `**X**` with `X` must yield plain text — inheriting
+     * the replaced span's run properties on top of (or instead of) the
+     * requested markers silently produces the wrong document while the report
+     * claims success (QA 2026-07-19 F-02). Plain-text edits (no markers on
+     * either side) keep inheriting the context style so partial replacements
+     * inside a styled span never lose formatting.
+     */
+    private _edit_declares_emphasis;
     private _parse_inline_markdown;
     private _apply_run_props;
     /**
@@ -509,6 +522,16 @@ declare function generate_structured_edits(text_orig: string, struct_orig: Extra
     edits: DiffEdit[];
     warnings: string[];
 };
+/**
+ * Compares embedded media bytes (word/media/*) between two DOCX packages.
+ * Adeu's diff is a text comparison: two documents whose images differ but
+ * whose projections agree produce an empty diff, which reads as "visually
+ * identical" unless the caller says otherwise (QA 2026-07-19 F-04). Returns
+ * warning strings describing changed/added/removed media members; empty when
+ * the media sets are byte-identical (or either package is unreadable — the
+ * caller has already surfaced package-level errors).
+ */
+declare function collect_media_difference_warnings(original_docx: Uint8Array, modified_docx: Uint8Array): string[];
 declare function create_unified_diff(original_text: string, modified_text: string, context_lines?: number): string;
 declare function create_word_patch_diff(original_text: string, modified_text: string, original_path?: string, modified_path?: string): string;
 
@@ -621,4 +644,4 @@ declare function userSearch(pattern: string, text: string, flags?: string): {
 
 declare function identifyEngine(): string;
 
-export { BatchValidationError, type DiffEdit, DocumentMapper, DocumentObject, type ExtractStructure, type FinalizeOptions, type FinalizeResult, type MarkupEditReport, type OutlineNode, type PageInfo, type PaginationResult, RedlineEngine, RegexTimeoutError, type RowGeometry, type TableGeometry, type TextSpan, USER_PATTERN_TIMEOUT_MS, _extractTextFromDoc, apply_edits_to_markdown, create_unified_diff, create_word_patch_diff, describe_illegal_control_chars, extractTextFromBuffer, extract_outline, finalize_document, generate_edits_from_text, generate_structured_edits, identifyEngine, paginate, split_structural_appendix, trim_common_context, userFindAllMatches, userSearch, validate_edit_strings };
+export { BatchValidationError, type DiffEdit, DocumentMapper, DocumentObject, type ExtractStructure, type FinalizeOptions, type FinalizeResult, type MarkupEditReport, type OutlineNode, type PageInfo, type PaginationResult, RedlineEngine, RegexTimeoutError, type RowGeometry, type TableGeometry, type TextSpan, USER_PATTERN_TIMEOUT_MS, _extractTextFromDoc, apply_edits_to_markdown, collect_media_difference_warnings, create_unified_diff, create_word_patch_diff, describe_illegal_control_chars, extractTextFromBuffer, extract_outline, finalize_document, generate_edits_from_text, generate_structured_edits, identifyEngine, paginate, split_structural_appendix, trim_common_context, userFindAllMatches, userSearch, validate_edit_strings };

package/dist/index.d.ts

@@ -67,6 +67,7 @@ interface TextSpan {
     comment_ids?: string[];
     part_index: number;
     is_image_marker?: boolean;
+    run_offset?: number;
 }
 declare class DocumentMapper {
     doc: DocumentObject;
@@ -393,6 +394,18 @@ declare class RedlineEngine {
      */
     private _build_tracked_ins_for_line;
     private _parse_markdown_style;
+    /**
+     * True when this edit's target or replacement text carries explicit
+     * bold/italic markers, making the markers AUTHORITATIVE for the inserted
+     * runs' formatting. Replacing `**X**` with `_X_` must yield italic-only
+     * text, and replacing `**X**` with `X` must yield plain text — inheriting
+     * the replaced span's run properties on top of (or instead of) the
+     * requested markers silently produces the wrong document while the report
+     * claims success (QA 2026-07-19 F-02). Plain-text edits (no markers on
+     * either side) keep inheriting the context style so partial replacements
+     * inside a styled span never lose formatting.
+     */
+    private _edit_declares_emphasis;
     private _parse_inline_markdown;
     private _apply_run_props;
     /**
@@ -509,6 +522,16 @@ declare function generate_structured_edits(text_orig: string, struct_orig: Extra
     edits: DiffEdit[];
     warnings: string[];
 };
+/**
+ * Compares embedded media bytes (word/media/*) between two DOCX packages.
+ * Adeu's diff is a text comparison: two documents whose images differ but
+ * whose projections agree produce an empty diff, which reads as "visually
+ * identical" unless the caller says otherwise (QA 2026-07-19 F-04). Returns
+ * warning strings describing changed/added/removed media members; empty when
+ * the media sets are byte-identical (or either package is unreadable — the
+ * caller has already surfaced package-level errors).
+ */
+declare function collect_media_difference_warnings(original_docx: Uint8Array, modified_docx: Uint8Array): string[];
 declare function create_unified_diff(original_text: string, modified_text: string, context_lines?: number): string;
 declare function create_word_patch_diff(original_text: string, modified_text: string, original_path?: string, modified_path?: string): string;
 
@@ -621,4 +644,4 @@ declare function userSearch(pattern: string, text: string, flags?: string): {
 
 declare function identifyEngine(): string;
 
-export { BatchValidationError, type DiffEdit, DocumentMapper, DocumentObject, type ExtractStructure, type FinalizeOptions, type FinalizeResult, type MarkupEditReport, type OutlineNode, type PageInfo, type PaginationResult, RedlineEngine, RegexTimeoutError, type RowGeometry, type TableGeometry, type TextSpan, USER_PATTERN_TIMEOUT_MS, _extractTextFromDoc, apply_edits_to_markdown, create_unified_diff, create_word_patch_diff, describe_illegal_control_chars, extractTextFromBuffer, extract_outline, finalize_document, generate_edits_from_text, generate_structured_edits, identifyEngine, paginate, split_structural_appendix, trim_common_context, userFindAllMatches, userSearch, validate_edit_strings };
+export { BatchValidationError, type DiffEdit, DocumentMapper, DocumentObject, type ExtractStructure, type FinalizeOptions, type FinalizeResult, type MarkupEditReport, type OutlineNode, type PageInfo, type PaginationResult, RedlineEngine, RegexTimeoutError, type RowGeometry, type TableGeometry, type TextSpan, USER_PATTERN_TIMEOUT_MS, _extractTextFromDoc, apply_edits_to_markdown, collect_media_difference_warnings, create_unified_diff, create_word_patch_diff, describe_illegal_control_chars, extractTextFromBuffer, extract_outline, finalize_document, generate_edits_from_text, generate_structured_edits, identifyEngine, paginate, split_structural_appendix, trim_common_context, userFindAllMatches, userSearch, validate_edit_strings };