@usejunior/docx-core 0.0.1 → 0.1.1

package/dist/shared/ooxml/namespaces.js

@@ -0,0 +1,224 @@
+/**
+ * OOXML namespace constants for Word document manipulation.
+ *
+ * Ported from: app/shared/document_primitives/ooxml/namespaces.py
+ *
+ * Central definitions for all WordprocessingML namespaces and qualified element names.
+ * This ensures consistent namespace handling across all XML operations.
+ *
+ * Reference: ECMA-376 Office Open XML File Formats
+ */
+// =============================================================================
+// Namespace URIs
+// =============================================================================
+/** Main WordprocessingML namespace */
+export const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
+/** Relationship namespace (for hyperlinks, etc.) */
+export const R_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/relationships';
+/** Extended properties namespace */
+export const WP_NS = 'http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing';
+/** Drawing namespace */
+export const A_NS = 'http://schemas.openxmlformats.org/drawingml/2006/main';
+/** VML namespace (legacy drawing) */
+export const V_NS = 'urn:schemas-microsoft-com:vml';
+/** Math namespace */
+export const M_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/math';
+// =============================================================================
+// Namespace Map
+// =============================================================================
+export const NSMAP = {
+    w: W_NS,
+    r: R_NS,
+    wp: WP_NS,
+    a: A_NS,
+    v: V_NS,
+    m: M_NS,
+};
+/** Reverse map for looking up prefixes */
+export const PREFIX_MAP = Object.fromEntries(Object.entries(NSMAP).map(([k, v]) => [v, k]));
+// =============================================================================
+// Qualified Element Names (Clark notation)
+// =============================================================================
+// Document structure
+export const W_BODY = `{${W_NS}}body`;
+export const W_DOCUMENT = `{${W_NS}}document`;
+export const W_SECTPR = `{${W_NS}}sectPr`; // Section properties
+// Paragraph elements
+export const W_P = `{${W_NS}}p`; // Paragraph
+export const W_PPR = `{${W_NS}}pPr`; // Paragraph properties
+export const W_PSTYLE = `{${W_NS}}pStyle`; // Paragraph style reference
+export const W_JC = `{${W_NS}}jc`; // Paragraph justification/alignment
+// Run elements
+export const W_R = `{${W_NS}}r`; // Run
+export const W_RPR = `{${W_NS}}rPr`; // Run properties
+export const W_T = `{${W_NS}}t`; // Text
+export const W_BR = `{${W_NS}}br`; // Break
+export const W_TAB = `{${W_NS}}tab`; // Tab character
+// Run formatting
+export const W_B = `{${W_NS}}b`; // Bold
+export const W_B_CS = `{${W_NS}}bCs`; // Bold (complex script)
+export const W_I = `{${W_NS}}i`; // Italic
+export const W_I_CS = `{${W_NS}}iCs`; // Italic (complex script)
+export const W_U = `{${W_NS}}u`; // Underline
+export const W_STRIKE = `{${W_NS}}strike`; // Strikethrough
+export const W_DSTRIKE = `{${W_NS}}dstrike`; // Double strikethrough
+export const W_CAPS = `{${W_NS}}caps`; // All caps
+export const W_SMALLCAPS = `{${W_NS}}smallCaps`; // Small caps
+export const W_VANISH = `{${W_NS}}vanish`; // Hidden text
+// Font properties
+export const W_RFONTS = `{${W_NS}}rFonts`; // Font family
+export const W_SZ = `{${W_NS}}sz`; // Font size (half-points)
+export const W_SZ_CS = `{${W_NS}}szCs`; // Font size complex script
+export const W_COLOR = `{${W_NS}}color`; // Text color
+export const W_HIGHLIGHT = `{${W_NS}}highlight`; // Highlight color
+export const W_SHD = `{${W_NS}}shd`; // Shading (background)
+export const W_RSTYLE = `{${W_NS}}rStyle`; // Character style reference
+// Bookmarks
+export const W_BOOKMARK_START = `{${W_NS}}bookmarkStart`;
+export const W_BOOKMARK_END = `{${W_NS}}bookmarkEnd`;
+// Fields
+export const W_FLDCHAR = `{${W_NS}}fldChar`; // Field character
+export const W_FLDCHARTYPE = `{${W_NS}}fldCharType`; // Field char type attr
+export const W_INSTRTEXT = `{${W_NS}}instrText`; // Instruction text
+export const W_FLDSIMPLE = `{${W_NS}}fldSimple`; // Simple field
+export const W_DIRTY = `{${W_NS}}dirty`; // Field needs update
+// Hyperlinks
+export const W_HYPERLINK = `{${W_NS}}hyperlink`;
+// Lists
+export const W_NUMPR = `{${W_NS}}numPr`; // Numbering properties
+export const W_ILVL = `{${W_NS}}ilvl`; // Indentation level
+export const W_NUMID = `{${W_NS}}numId`; // Numbering ID
+// Tables
+export const W_TBL = `{${W_NS}}tbl`; // Table
+export const W_TR = `{${W_NS}}tr`; // Table row
+export const W_TC = `{${W_NS}}tc`; // Table cell
+export const W_TBLPR = `{${W_NS}}tblPr`; // Table properties
+export const W_TCPR = `{${W_NS}}tcPr`; // Cell properties
+// Headers/Footers
+export const W_SECTTYPE = `{${W_NS}}type`;
+export const W_HEADERREFERENCE = `{${W_NS}}headerReference`;
+export const W_FOOTERREFERENCE = `{${W_NS}}footerReference`;
+// Comments
+export const W_COMMENT_RANGE_START = `{${W_NS}}commentRangeStart`;
+export const W_COMMENT_RANGE_END = `{${W_NS}}commentRangeEnd`;
+// =============================================================================
+// Track Changes Elements (NEW - not in Python original)
+// =============================================================================
+export const W_INS = `{${W_NS}}ins`; // Insertion
+export const W_DEL = `{${W_NS}}del`; // Deletion
+export const W_DELTEXT = `{${W_NS}}delText`; // Deleted text content
+export const W_MOVEFROM = `{${W_NS}}moveFrom`; // Move source
+export const W_MOVETO = `{${W_NS}}moveTo`; // Move destination
+export const W_RPRCHANGE = `{${W_NS}}rPrChange`; // Run properties change
+export const W_PPRCHANGE = `{${W_NS}}pPrChange`; // Paragraph properties change
+// Relationship attributes
+export const R_ID = `{${R_NS}}id`;
+// =============================================================================
+// Common Attribute Names
+// =============================================================================
+// Bookmark attributes
+export const W_ID = `{${W_NS}}id`;
+export const W_NAME = `{${W_NS}}name`;
+// Track changes attributes
+export const W_AUTHOR = `{${W_NS}}author`;
+export const W_DATE = `{${W_NS}}date`;
+// General attributes
+export const W_VAL = `{${W_NS}}val`;
+// Underline types (for w:u/@w:val)
+export const UNDERLINE_NONE = 'none';
+export const UNDERLINE_SINGLE = 'single';
+export const UNDERLINE_DOUBLE = 'double';
+export const UNDERLINE_DOTTED = 'dotted';
+export const UNDERLINE_DASHED = 'dash';
+export const UNDERLINE_WAVY = 'wave';
+export const UNDERLINE_WORDS = 'words';
+// Alignment values (for w:jc/@w:val)
+export const ALIGN_LEFT = 'left';
+export const ALIGN_CENTER = 'center';
+export const ALIGN_RIGHT = 'right';
+export const ALIGN_JUSTIFY = 'both';
+// Field character types (for w:fldChar/@w:fldCharType)
+export const FLDCHAR_BEGIN = 'begin';
+export const FLDCHAR_SEPARATE = 'separate';
+export const FLDCHAR_END = 'end';
+// Highlight color names (for w:highlight/@w:val)
+export const HIGHLIGHT_YELLOW = 'yellow';
+export const HIGHLIGHT_GREEN = 'green';
+export const HIGHLIGHT_CYAN = 'cyan';
+export const HIGHLIGHT_MAGENTA = 'magenta';
+export const HIGHLIGHT_BLUE = 'blue';
+export const HIGHLIGHT_RED = 'red';
+export const HIGHLIGHT_DARK_BLUE = 'darkBlue';
+export const HIGHLIGHT_DARK_CYAN = 'darkCyan';
+export const HIGHLIGHT_DARK_GREEN = 'darkGreen';
+export const HIGHLIGHT_DARK_MAGENTA = 'darkMagenta';
+export const HIGHLIGHT_DARK_RED = 'darkRed';
+export const HIGHLIGHT_DARK_YELLOW = 'darkYellow';
+export const HIGHLIGHT_DARK_GRAY = 'darkGray';
+export const HIGHLIGHT_LIGHT_GRAY = 'lightGray';
+export const HIGHLIGHT_BLACK = 'black';
+export const HIGHLIGHT_NONE = 'none';
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Convert Clark notation to prefixed notation.
+ *
+ * @param clarkName - Element name in Clark notation, e.g., '{http://...}p'
+ * @returns Prefixed name, e.g., 'w:p'
+ *
+ * @example
+ * clarkToPrefixed(W_P) // => 'w:p'
+ */
+export function clarkToPrefixed(clarkName) {
+    if (clarkName.startsWith('{')) {
+        const nsEnd = clarkName.indexOf('}');
+        if (nsEnd !== -1) {
+            const ns = clarkName.slice(1, nsEnd);
+            const local = clarkName.slice(nsEnd + 1);
+            const prefix = PREFIX_MAP[ns];
+            if (prefix) {
+                return `${prefix}:${local}`;
+            }
+        }
+    }
+    return clarkName;
+}
+/**
+ * Convert prefixed notation to Clark notation.
+ *
+ * @param prefixedName - Element name with prefix, e.g., 'w:p'
+ * @returns Clark notation name, e.g., '{http://...}p'
+ *
+ * @example
+ * prefixedToClark('w:p') // => '{http://schemas.openxmlformats.org/wordprocessingml/2006/main}p'
+ */
+export function prefixedToClark(prefixedName) {
+    if (prefixedName.includes(':')) {
+        const [prefix, local] = prefixedName.split(':', 2);
+        const ns = NSMAP[prefix];
+        if (ns) {
+            return `{${ns}}${local}`;
+        }
+    }
+    return prefixedName;
+}
+/**
+ * Extract local name from Clark notation.
+ *
+ * @param clarkName - Element name in Clark notation
+ * @returns Local name without namespace
+ *
+ * @example
+ * localName(W_P) // => 'p'
+ */
+export function localName(clarkName) {
+    if (clarkName.startsWith('{')) {
+        const nsEnd = clarkName.indexOf('}');
+        if (nsEnd !== -1) {
+            return clarkName.slice(nsEnd + 1);
+        }
+    }
+    return clarkName;
+}
+//# sourceMappingURL=namespaces.js.map

package/dist/shared/ooxml/namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../../../src/shared/ooxml/namespaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,sCAAsC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAG,8DAA8D,CAAC;AAEnF,oDAAoD;AACpD,MAAM,CAAC,MAAM,IAAI,GAAG,qEAAqE,CAAC;AAE1F,oCAAoC;AACpC,MAAM,CAAC,MAAM,KAAK,GAAG,wEAAwE,CAAC;AAE9F,wBAAwB;AACxB,MAAM,CAAC,MAAM,IAAI,GAAG,uDAAuD,CAAC;AAE5E,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG,+BAA+B,CAAC;AAEpD,qBAAqB;AACrB,MAAM,CAAC,MAAM,IAAI,GAAG,4DAA4D,CAAC;AAEjF,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,KAAK,GAA2B;IAC3C,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,EAAE,EAAE,KAAK;IACT,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,UAAU,GAA2B,MAAM,CAAC,WAAW,CAClE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC9C,CAAC;AAEF,gFAAgF;AAChF,2CAA2C;AAC3C,gFAAgF;AAEhF,qBAAqB;AACrB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,IAAI,WAAW,CAAC;AAC9C,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,CAAC,qBAAqB;AAEhE,qBAAqB;AACrB,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,YAAY;AAC7C,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,uBAAuB;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,CAAC,4BAA4B;AACvE,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,oCAAoC;AAEvE,eAAe;AACf,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM;AACvC,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,iBAAiB;AACtD,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,OAAO;AACxC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,QAAQ;AAC3C,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,gBAAgB;AAErD,iBAAiB;AACjB,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,OAAO;AACxC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,wBAAwB;AAC9D,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,SAAS;AAC1C,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,0BAA0B;AAChE,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,YAAY;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,CAAC,gBAAgB;AAC3D,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,IAAI,UAAU,CAAC,CAAC,uBAAuB;AACpE,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,WAAW;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,aAAa;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,CAAC,cAAc;AAEzD,kBAAkB;AAClB,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,CAAC,cAAc;AACzD,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,0BAA0B;AAC7D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,2BAA2B;AACnE,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,aAAa;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,kBAAkB;AACnE,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,uBAAuB;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,CAAC,4BAA4B;AAEvE,YAAY;AACZ,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,IAAI,gBAAgB,CAAC;AACzD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,IAAI,cAAc,CAAC;AAErD,SAAS;AACT,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,IAAI,UAAU,CAAC,CAAC,kBAAkB;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,IAAI,cAAc,CAAC,CAAC,uBAAuB;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,mBAAmB;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,eAAe;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,qBAAqB;AAE9D,aAAa;AACb,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,YAAY,CAAC;AAEhD,QAAQ;AACR,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,uBAAuB;AAChE,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,oBAAoB;AAC3D,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,eAAe;AAExD,SAAS;AACT,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,QAAQ;AAC7C,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,YAAY;AAC/C,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,aAAa;AAChD,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,mBAAmB;AAC5D,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,kBAAkB;AAEzD,kBAAkB;AAClB,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,IAAI,OAAO,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,IAAI,kBAAkB,CAAC;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,IAAI,kBAAkB,CAAC;AAE5D,WAAW;AACX,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,IAAI,oBAAoB,CAAC;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,IAAI,kBAAkB,CAAC;AAE9D,gFAAgF;AAChF,wDAAwD;AACxD,gFAAgF;AAEhF,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,YAAY;AACjD,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,WAAW;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,IAAI,UAAU,CAAC,CAAC,uBAAuB;AACpE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,IAAI,WAAW,CAAC,CAAC,cAAc;AAC7D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC,CAAC,mBAAmB;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,wBAAwB;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,8BAA8B;AAE/E,0BAA0B;AAC1B,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC;AAElC,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,sBAAsB;AACtB,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,CAAC;AAEtC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,IAAI,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,CAAC;AAEtC,qBAAqB;AACrB,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,CAAC;AAEpC,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,qCAAqC;AACrC,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAEpC,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAEjC,iDAAiD;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAqB,CAAC;QACvE,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,EAAE,EAAE,CAAC;YACP,OAAO,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/shared/ooxml/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * TypeScript types for OOXML document elements.
+ *
+ * These types represent the object model used during comparison operations.
+ */
+/**
+ * Represents a revision (track change) in the document.
+ */
+export interface Revision {
+    /** Unique ID for this revision */
+    id: number;
+    /** Author of the revision */
+    author: string;
+    /** Timestamp of the revision */
+    date: Date;
+    /** Type of revision */
+    type: 'insertion' | 'deletion' | 'move' | 'format';
+}
+/**
+ * Represents a text run with its properties.
+ */
+export interface RunInfo {
+    /** The text content */
+    text: string;
+    /** Character offset within the paragraph */
+    start: number;
+    /** Character offset of end (exclusive) */
+    end: number;
+    /** Run properties (bold, italic, etc.) */
+    properties?: RunProperties;
+    /** If this run is part of a revision */
+    revision?: Revision;
+}
+/**
+ * Run formatting properties.
+ */
+export interface RunProperties {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: string;
+    strikethrough?: boolean;
+    highlight?: string;
+    color?: string;
+    fontSize?: number;
+    fontFamily?: string;
+}
+/**
+ * Represents a paragraph with its content.
+ */
+export interface ParagraphInfo {
+    /** Unique identifier for correlation */
+    id?: string;
+    /** Plain text content (for comparison) */
+    text: string;
+    /** Individual runs in this paragraph */
+    runs: RunInfo[];
+    /** Paragraph style */
+    style?: string;
+    /** Numbering info if this is a list item */
+    numbering?: NumberingInfo;
+    /** SHA1 hash for correlation */
+    hash?: string;
+}
+/**
+ * Numbering (list) information.
+ */
+export interface NumberingInfo {
+    /** Numbering definition ID */
+    numId: number;
+    /** Indentation level */
+    ilvl: number;
+    /** Rendered label text (e.g., "1.", "a)", "(i)") */
+    label?: string;
+}
+/**
+ * Represents a field (cross-reference, hyperlink, etc.)
+ */
+export interface FieldInfo {
+    /** Field type (REF, HYPERLINK, etc.) */
+    type: string;
+    /** Field instruction code */
+    instruction: string;
+    /** Displayed result text */
+    result: string;
+    /** Character position in paragraph */
+    start: number;
+    end: number;
+}
+/**
+ * Result of paragraph alignment (LCS-based).
+ */
+export interface AlignmentResult {
+    /** Paragraphs that match between documents */
+    matched: Array<{
+        original: ParagraphInfo;
+        revised: ParagraphInfo;
+        similarity: number;
+    }>;
+    /** Paragraphs only in original (deleted) */
+    deleted: ParagraphInfo[];
+    /** Paragraphs only in revised (inserted) */
+    inserted: ParagraphInfo[];
+}
+/**
+ * Diff operation from diff-match-patch.
+ */
+export type DiffOp = [-1 | 0 | 1, string];
+/**
+ * Run-level diff result.
+ */
+export interface RunDiffResult {
+    /** Original runs with deletion markers */
+    originalRuns: RunInfo[];
+    /** Revised runs with insertion markers */
+    revisedRuns: RunInfo[];
+    /** Combined runs with track changes */
+    mergedRuns: RunInfo[];
+}
+/**
+ * Statistics from a comparison operation.
+ */
+export interface ComparisonStats {
+    /** Number of inserted runs/paragraphs */
+    insertions: number;
+    /** Number of deleted runs/paragraphs */
+    deletions: number;
+    /** Number of modified paragraphs */
+    modifications: number;
+    /** Average length of changed spans */
+    avgSpanLength: number;
+    /** Total paragraphs in original */
+    originalParagraphs: number;
+    /** Total paragraphs in revised */
+    revisedParagraphs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/ooxml/types.d.ts.map

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

package/dist/shared/ooxml/types.js

@@ -0,0 +1,7 @@
+/**
+ * TypeScript types for OOXML document elements.
+ *
+ * These types represent the object model used during comparison operations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/ooxml/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/ooxml/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,10 +1,67 @@
 {
   "name": "@usejunior/docx-core",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @usejunior/docx-core",
+  "version": "0.1.1",
+  "description": "OOXML (.docx) core library: primitives, comparison, and track changes",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "clean:dist": "node -e \"const { rmSync } = require('node:fs'); rmSync('dist', { recursive: true, force: true });\"",
+    "build": "npm run clean:dist && tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "node ../../node_modules/vitest/vitest.mjs",
+    "test:run": "node ../../node_modules/vitest/vitest.mjs run",
+    "test:baseline": "node ../../node_modules/vitest/vitest.mjs run -c vitest.baseline.config.ts",
+    "test:coverage": "node ../../node_modules/vitest/vitest.mjs run --coverage --coverage.reporter=text-summary --coverage.reporter=json-summary --coverage.reporter=lcov",
+    "check:spec-coverage": "node scripts/validate_openspec_coverage.mjs && node scripts/validate_primitives_openspec_coverage.mjs",
+    "lint": "tsc --noEmit",
+    "benchmark": "tsx src/benchmark/runner.ts",
+    "cli": "node dist/cli/index.js"
+  },
+  "dependencies": {
+    "@xmldom/xmldom": "^0.8.10",
+    "diff-match-patch": "^1.0.5",
+    "jszip": "^3.10.1"
+  },
+  "devDependencies": {
+    "@types/diff-match-patch": "^1.0.36",
+    "@types/node": "^22.10.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/runner": "^3.2.4",
+    "allure-vitest": "^3.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/UseJunior/safe-docx"
+  },
+  "homepage": "https://github.com/UseJunior/safe-docx/tree/main/packages/docx-core",
+  "bugs": {
+    "url": "https://github.com/UseJunior/safe-docx/issues"
+  },
+  "files": [
+    "dist"
+  ],
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+    "docx",
+    "ooxml",
+    "word",
+    "comparison",
+    "track-changes",
+    "document-editing",
+    "serverless",
+    "cloudflare-workers",
+    "edge",
+    "vercel"
+  ],
+  "license": "MIT",
+  "bin": {
+    "docx-comparison": "dist/cli/index.js",
+    "safe-docx-compare": "dist/cli/index.js"
+  }
 }