docxmlater 10.4.0 → 11.0.4

package/dist/esm/utils/textDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textDiff.js","sourceRoot":"","sources":["../../../src/utils/textDiff.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,OAAe;IAEvD,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IAGD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IAGD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAGD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,OAAO,SAAS,GAAG,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,SAAS,EAAE,CAAC;IACd,CAAC;IAGD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,OACE,SAAS,GAAG,SAAS;QACrB,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,EACnF,CAAC;QACD,SAAS,EAAE,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAGnC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IAGD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAEvE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAGD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAMD,MAAM,UAAU,qBAAqB,CAAC,QAAuB;IAC3D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;AAClD,CAAC","sourcesContent":["/**\n * Text diff utility for character-level granular tracked changes.\n *\n * Uses a prefix/suffix diff algorithm to compute minimal edit operations\n * between two strings. This allows tracked changes to show only the\n * actual differences instead of marking entire runs as deleted/inserted.\n */\n\n/**\n * Represents a segment of a diff result.\n */\nexport interface DiffSegment {\n  /** Whether this segment is unchanged, deleted, or inserted */\n  type: 'equal' | 'delete' | 'insert';\n  /** The text content of this segment */\n  text: string;\n}\n\n/**\n * Computes minimal diff segments between two strings.\n *\n * Algorithm: Find common prefix, then common suffix from the remaining text,\n * then the middle portion is a delete (from old) + insert (from new).\n *\n * This handles the most common edit patterns optimally:\n * - Space removal: \"word  word\" → \"word word\" → [equal \"word \", delete \" \", equal \"word\"]\n * - Word replacement: \"The quick fox\" → \"The slow fox\" → [equal \"The \", delete \"quick\", insert \"slow\", equal \" fox\"]\n * - Prefix change: \"Hello World\" → \"Goodbye World\" → [delete \"Hello\", insert \"Goodbye\", equal \" World\"]\n * - Suffix change: \"Hello World\" → \"Hello Earth\" → [equal \"Hello \", delete \"World\", insert \"Earth\"]\n *\n * @param oldText - The original text\n * @param newText - The new text\n * @returns Array of diff segments\n */\nexport function diffText(oldText: string, newText: string): DiffSegment[] {\n  // Identical strings — no changes\n  if (oldText === newText) {\n    return oldText.length > 0 ? [{ type: 'equal', text: oldText }] : [];\n  }\n\n  // Empty old — entire new text is an insertion\n  if (oldText.length === 0) {\n    return newText.length > 0 ? [{ type: 'insert', text: newText }] : [];\n  }\n\n  // Empty new — entire old text is a deletion\n  if (newText.length === 0) {\n    return [{ type: 'delete', text: oldText }];\n  }\n\n  // Find common prefix length\n  let prefixLen = 0;\n  const minLen = Math.min(oldText.length, newText.length);\n  while (prefixLen < minLen && oldText[prefixLen] === newText[prefixLen]) {\n    prefixLen++;\n  }\n\n  // Find common suffix length (not overlapping with prefix)\n  let suffixLen = 0;\n  const maxSuffix = minLen - prefixLen;\n  while (\n    suffixLen < maxSuffix &&\n    oldText[oldText.length - 1 - suffixLen] === newText[newText.length - 1 - suffixLen]\n  ) {\n    suffixLen++;\n  }\n\n  const segments: DiffSegment[] = [];\n\n  // Common prefix\n  if (prefixLen > 0) {\n    segments.push({ type: 'equal', text: oldText.slice(0, prefixLen) });\n  }\n\n  // Middle portion — what changed\n  const oldMiddle = oldText.slice(prefixLen, oldText.length - suffixLen);\n  const newMiddle = newText.slice(prefixLen, newText.length - suffixLen);\n\n  if (oldMiddle.length > 0) {\n    segments.push({ type: 'delete', text: oldMiddle });\n  }\n  if (newMiddle.length > 0) {\n    segments.push({ type: 'insert', text: newMiddle });\n  }\n\n  // Common suffix\n  if (suffixLen > 0) {\n    segments.push({ type: 'equal', text: oldText.slice(oldText.length - suffixLen) });\n  }\n\n  return segments;\n}\n\n/**\n * Checks whether a diff result has any unchanged (equal) portions.\n * If false, the entire text was replaced (no benefit from granular tracking).\n */\nexport function diffHasUnchangedParts(segments: DiffSegment[]): boolean {\n  return segments.some((s) => s.type === 'equal');\n}\n"]}

package/dist/esm/utils/units.js

@@ -0,0 +1,152 @@
+export const STANDARD_DPI = 96;
+export const UNITS = {
+    EMUS_PER_INCH: 914400,
+    TWIPS_PER_INCH: 1440,
+    POINTS_PER_INCH: 72,
+    TWIPS_PER_POINT: 20,
+    EMUS_PER_TWIP: 635,
+    EMUS_PER_POINT: 12700,
+    EMUS_PER_CM: 360000,
+    INCHES_PER_CM: 0.393701,
+    CM_PER_INCH: 2.54,
+    HALF_POINTS_PER_POINT: 2,
+};
+export function twipsToPoints(twips) {
+    return twips / UNITS.TWIPS_PER_POINT;
+}
+export function twipsToInches(twips) {
+    return twips / UNITS.TWIPS_PER_INCH;
+}
+export function twipsToCm(twips) {
+    return twipsToInches(twips) * UNITS.CM_PER_INCH;
+}
+export function twipsToEmus(twips) {
+    return Math.round(twips * UNITS.EMUS_PER_TWIP);
+}
+export function emusToTwips(emus) {
+    return Math.round(emus / UNITS.EMUS_PER_TWIP);
+}
+export function emusToInches(emus) {
+    return emus / UNITS.EMUS_PER_INCH;
+}
+export function emusToCm(emus) {
+    return emus / UNITS.EMUS_PER_CM;
+}
+export function emusToPoints(emus) {
+    return emus / UNITS.EMUS_PER_POINT;
+}
+export function emusToPixels(emus, dpi = STANDARD_DPI) {
+    return Math.round((emus / UNITS.EMUS_PER_INCH) * dpi);
+}
+export function pointsToTwips(points) {
+    return points * UNITS.TWIPS_PER_POINT;
+}
+export function pointsToEmus(points) {
+    return Math.round(points * UNITS.EMUS_PER_POINT);
+}
+export function pointsToInches(points) {
+    return points / UNITS.POINTS_PER_INCH;
+}
+export function pointsToCm(points) {
+    return pointsToInches(points) * UNITS.CM_PER_INCH;
+}
+export function pointsToHalfPoints(points) {
+    return Math.round(points * UNITS.HALF_POINTS_PER_POINT);
+}
+export function halfPointsToPoints(halfPoints) {
+    return halfPoints / UNITS.HALF_POINTS_PER_POINT;
+}
+export function inchesToTwips(inches) {
+    return Math.round(inches * UNITS.TWIPS_PER_INCH);
+}
+export function inchesToEmus(inches) {
+    return Math.round(inches * UNITS.EMUS_PER_INCH);
+}
+export function inchesToPoints(inches) {
+    return inches * UNITS.POINTS_PER_INCH;
+}
+export function inchesToCm(inches) {
+    return inches * UNITS.CM_PER_INCH;
+}
+export function inchesToPixels(inches, dpi = STANDARD_DPI) {
+    return Math.round(inches * dpi);
+}
+export function cmToTwips(cm) {
+    return inchesToTwips(cm * UNITS.INCHES_PER_CM);
+}
+export function cmToEmus(cm) {
+    return Math.round(cm * UNITS.EMUS_PER_CM);
+}
+export function cmToInches(cm) {
+    return cm * UNITS.INCHES_PER_CM;
+}
+export function cmToPoints(cm) {
+    return inchesToPoints(cmToInches(cm));
+}
+export function cmToPixels(cm, dpi = STANDARD_DPI) {
+    return inchesToPixels(cmToInches(cm), dpi);
+}
+export function pixelsToEmus(pixels, dpi = STANDARD_DPI) {
+    return Math.round((pixels / dpi) * UNITS.EMUS_PER_INCH);
+}
+export function pixelsToInches(pixels, dpi = STANDARD_DPI) {
+    return pixels / dpi;
+}
+export function pixelsToTwips(pixels, dpi = STANDARD_DPI) {
+    return inchesToTwips(pixelsToInches(pixels, dpi));
+}
+export function pixelsToCm(pixels, dpi = STANDARD_DPI) {
+    return pixelsToInches(pixels, dpi) * UNITS.CM_PER_INCH;
+}
+export function pixelsToPoints(pixels, dpi = STANDARD_DPI) {
+    return inchesToPoints(pixelsToInches(pixels, dpi));
+}
+export const PAGE_SIZES = {
+    LETTER: {
+        width: 12240,
+        height: 15840,
+    },
+    A4: {
+        width: 11906,
+        height: 16838,
+    },
+    LEGAL: {
+        width: 12240,
+        height: 20160,
+    },
+    TABLOID: {
+        width: 15840,
+        height: 24480,
+    },
+    A3: {
+        width: 16838,
+        height: 23811,
+    },
+};
+export const COMMON_MARGINS = {
+    NORMAL: {
+        top: 1440,
+        bottom: 1440,
+        left: 1440,
+        right: 1440,
+    },
+    NARROW: {
+        top: 720,
+        bottom: 720,
+        left: 720,
+        right: 720,
+    },
+    WIDE: {
+        top: 1440,
+        bottom: 1440,
+        left: 2880,
+        right: 2880,
+    },
+    MODERATE: {
+        top: 1440,
+        bottom: 1440,
+        left: 1080,
+        right: 1080,
+    },
+};
+//# sourceMappingURL=units.js.map

package/dist/esm/utils/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../../../src/utils/units.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Unit Conversion Utilities\n *\n * Word documents use multiple measurement units:\n * - Twips: 1/20th of a point (used for most measurements like margins, indents)\n * - EMUs: English Metric Units (used for DrawingML, images)\n * - Points: Typography unit (72 points = 1 inch)\n * - Pixels: Screen measurement (depends on DPI)\n * - Inches/Centimeters: Human-readable units\n *\n * Conversion factors:\n * - 1 inch = 72 points = 1440 twips = 914,400 EMUs\n * - 1 cm = 0.393701 inches = 360,000 EMUs\n * - 1 point = 20 twips = 12,700 EMUs\n */\n\n/**\n * Standard DPI (dots per inch) for screen displays\n */\nexport const STANDARD_DPI = 96;\n\n/**\n * Conversion constants\n */\nexport const UNITS = {\n  /** EMUs per inch */\n  EMUS_PER_INCH: 914400,\n  /** Twips per inch */\n  TWIPS_PER_INCH: 1440,\n  /** Points per inch */\n  POINTS_PER_INCH: 72,\n  /** Twips per point */\n  TWIPS_PER_POINT: 20,\n  /** EMUs per twip */\n  EMUS_PER_TWIP: 635,\n  /** EMUs per point */\n  EMUS_PER_POINT: 12700,\n  /** EMUs per centimeter */\n  EMUS_PER_CM: 360000,\n  /** Inches per centimeter */\n  INCHES_PER_CM: 0.393701,\n  /** Centimeters per inch */\n  CM_PER_INCH: 2.54,\n  /** Half-points per point (Word uses half-points for font sizes) */\n  HALF_POINTS_PER_POINT: 2,\n} as const;\n\n// ============================================================================\n// Twips Conversions\n// ============================================================================\n\n/**\n * Converts twips to points\n * @param twips Value in twips\n * @returns Value in points\n */\nexport function twipsToPoints(twips: number): number {\n  return twips / UNITS.TWIPS_PER_POINT;\n}\n\n/**\n * Converts twips to inches\n * @param twips Value in twips\n * @returns Value in inches\n */\nexport function twipsToInches(twips: number): number {\n  return twips / UNITS.TWIPS_PER_INCH;\n}\n\n/**\n * Converts twips to centimeters\n * @param twips Value in twips\n * @returns Value in centimeters\n */\nexport function twipsToCm(twips: number): number {\n  return twipsToInches(twips) * UNITS.CM_PER_INCH;\n}\n\n/**\n * Converts twips to EMUs\n * @param twips Value in twips\n * @returns Value in EMUs\n */\nexport function twipsToEmus(twips: number): number {\n  return Math.round(twips * UNITS.EMUS_PER_TWIP);\n}\n\n// ============================================================================\n// EMUs Conversions\n// ============================================================================\n\n/**\n * Converts EMUs to twips\n * @param emus Value in EMUs\n * @returns Value in twips\n */\nexport function emusToTwips(emus: number): number {\n  return Math.round(emus / UNITS.EMUS_PER_TWIP);\n}\n\n/**\n * Converts EMUs to inches\n * @param emus Value in EMUs\n * @returns Value in inches\n */\nexport function emusToInches(emus: number): number {\n  return emus / UNITS.EMUS_PER_INCH;\n}\n\n/**\n * Converts EMUs to centimeters\n * @param emus Value in EMUs\n * @returns Value in centimeters\n */\nexport function emusToCm(emus: number): number {\n  return emus / UNITS.EMUS_PER_CM;\n}\n\n/**\n * Converts EMUs to points\n * @param emus Value in EMUs\n * @returns Value in points\n */\nexport function emusToPoints(emus: number): number {\n  return emus / UNITS.EMUS_PER_POINT;\n}\n\n/**\n * Converts EMUs to pixels\n * @param emus Value in EMUs\n * @param dpi Dots per inch (default: 96)\n * @returns Value in pixels\n */\nexport function emusToPixels(emus: number, dpi: number = STANDARD_DPI): number {\n  return Math.round((emus / UNITS.EMUS_PER_INCH) * dpi);\n}\n\n// ============================================================================\n// Points Conversions\n// ============================================================================\n\n/**\n * Converts points to twips\n * @param points Value in points\n * @returns Value in twips\n */\nexport function pointsToTwips(points: number): number {\n  return points * UNITS.TWIPS_PER_POINT;\n}\n\n/**\n * Converts points to EMUs\n * @param points Value in points\n * @returns Value in EMUs\n */\nexport function pointsToEmus(points: number): number {\n  return Math.round(points * UNITS.EMUS_PER_POINT);\n}\n\n/**\n * Converts points to inches\n * @param points Value in points\n * @returns Value in inches\n */\nexport function pointsToInches(points: number): number {\n  return points / UNITS.POINTS_PER_INCH;\n}\n\n/**\n * Converts points to centimeters\n * @param points Value in points\n * @returns Value in centimeters\n */\nexport function pointsToCm(points: number): number {\n  return pointsToInches(points) * UNITS.CM_PER_INCH;\n}\n\n// ============================================================================\n// Half-Points Conversions (Word uses half-points for font sizes)\n// ============================================================================\n\n/**\n * Converts points to half-points (for Word font size storage)\n * @param points Value in points\n * @returns Value in half-points\n */\nexport function pointsToHalfPoints(points: number): number {\n  // Round to nearest integer — w:sz/w:szCs require ST_HpsMeasure (unsigned integer)\n  return Math.round(points * UNITS.HALF_POINTS_PER_POINT);\n}\n\n/**\n * Converts half-points to points (from Word font size storage)\n * @param halfPoints Value in half-points\n * @returns Value in points\n */\nexport function halfPointsToPoints(halfPoints: number): number {\n  return halfPoints / UNITS.HALF_POINTS_PER_POINT;\n}\n\n// ============================================================================\n// Inches Conversions\n// ============================================================================\n\n/**\n * Converts inches to twips\n * @param inches Value in inches\n * @returns Value in twips\n */\nexport function inchesToTwips(inches: number): number {\n  return Math.round(inches * UNITS.TWIPS_PER_INCH);\n}\n\n/**\n * Converts inches to EMUs\n * @param inches Value in inches\n * @returns Value in EMUs\n */\nexport function inchesToEmus(inches: number): number {\n  return Math.round(inches * UNITS.EMUS_PER_INCH);\n}\n\n/**\n * Converts inches to points\n * @param inches Value in inches\n * @returns Value in points\n */\nexport function inchesToPoints(inches: number): number {\n  return inches * UNITS.POINTS_PER_INCH;\n}\n\n/**\n * Converts inches to centimeters\n * @param inches Value in inches\n * @returns Value in centimeters\n */\nexport function inchesToCm(inches: number): number {\n  return inches * UNITS.CM_PER_INCH;\n}\n\n/**\n * Converts inches to pixels\n * @param inches Value in inches\n * @param dpi Dots per inch (default: 96)\n * @returns Value in pixels\n */\nexport function inchesToPixels(inches: number, dpi: number = STANDARD_DPI): number {\n  return Math.round(inches * dpi);\n}\n\n// ============================================================================\n// Centimeters Conversions\n// ============================================================================\n\n/**\n * Converts centimeters to twips\n * @param cm Value in centimeters\n * @returns Value in twips\n */\nexport function cmToTwips(cm: number): number {\n  return inchesToTwips(cm * UNITS.INCHES_PER_CM);\n}\n\n/**\n * Converts centimeters to EMUs\n * @param cm Value in centimeters\n * @returns Value in EMUs\n */\nexport function cmToEmus(cm: number): number {\n  return Math.round(cm * UNITS.EMUS_PER_CM);\n}\n\n/**\n * Converts centimeters to inches\n * @param cm Value in centimeters\n * @returns Value in inches\n */\nexport function cmToInches(cm: number): number {\n  return cm * UNITS.INCHES_PER_CM;\n}\n\n/**\n * Converts centimeters to points\n * @param cm Value in centimeters\n * @returns Value in points\n */\nexport function cmToPoints(cm: number): number {\n  return inchesToPoints(cmToInches(cm));\n}\n\n/**\n * Converts centimeters to pixels\n * @param cm Value in centimeters\n * @param dpi Dots per inch (default: 96)\n * @returns Value in pixels\n */\nexport function cmToPixels(cm: number, dpi: number = STANDARD_DPI): number {\n  return inchesToPixels(cmToInches(cm), dpi);\n}\n\n// ============================================================================\n// Pixels Conversions\n// ============================================================================\n\n/**\n * Converts pixels to EMUs\n * @param pixels Value in pixels\n * @param dpi Dots per inch (default: 96)\n * @returns Value in EMUs\n */\nexport function pixelsToEmus(pixels: number, dpi: number = STANDARD_DPI): number {\n  return Math.round((pixels / dpi) * UNITS.EMUS_PER_INCH);\n}\n\n/**\n * Converts pixels to inches\n * @param pixels Value in pixels\n * @param dpi Dots per inch (default: 96)\n * @returns Value in inches\n */\nexport function pixelsToInches(pixels: number, dpi: number = STANDARD_DPI): number {\n  return pixels / dpi;\n}\n\n/**\n * Converts pixels to twips\n * @param pixels Value in pixels\n * @param dpi Dots per inch (default: 96)\n * @returns Value in twips\n */\nexport function pixelsToTwips(pixels: number, dpi: number = STANDARD_DPI): number {\n  return inchesToTwips(pixelsToInches(pixels, dpi));\n}\n\n/**\n * Converts pixels to centimeters\n * @param pixels Value in pixels\n * @param dpi Dots per inch (default: 96)\n * @returns Value in centimeters\n */\nexport function pixelsToCm(pixels: number, dpi: number = STANDARD_DPI): number {\n  return pixelsToInches(pixels, dpi) * UNITS.CM_PER_INCH;\n}\n\n/**\n * Converts pixels to points\n * @param pixels Value in pixels\n * @param dpi Dots per inch (default: 96)\n * @returns Value in points\n */\nexport function pixelsToPoints(pixels: number, dpi: number = STANDARD_DPI): number {\n  return inchesToPoints(pixelsToInches(pixels, dpi));\n}\n\n// ============================================================================\n// Common Document Sizes (in twips)\n// ============================================================================\n\n/**\n * Common page sizes in twips\n */\nexport const PAGE_SIZES = {\n  /** Letter (8.5\" x 11\") */\n  LETTER: {\n    width: 12240, // 8.5 inches\n    height: 15840, // 11 inches\n  },\n  /** A4 (21cm x 29.7cm) */\n  A4: {\n    width: 11906, // 21cm\n    height: 16838, // 29.7cm\n  },\n  /** Legal (8.5\" x 14\") */\n  LEGAL: {\n    width: 12240, // 8.5 inches\n    height: 20160, // 14 inches\n  },\n  /** Tabloid (11\" x 17\") */\n  TABLOID: {\n    width: 15840, // 11 inches\n    height: 24480, // 17 inches\n  },\n  /** A3 (29.7cm x 42cm) */\n  A3: {\n    width: 16838, // 29.7cm\n    height: 23811, // 42cm\n  },\n} as const;\n\n/**\n * Common margin sizes in twips\n */\nexport const COMMON_MARGINS = {\n  /** Normal margins (1 inch all around) */\n  NORMAL: {\n    top: 1440,\n    bottom: 1440,\n    left: 1440,\n    right: 1440,\n  },\n  /** Narrow margins (0.5 inch all around) */\n  NARROW: {\n    top: 720,\n    bottom: 720,\n    left: 720,\n    right: 720,\n  },\n  /** Wide margins (2 inches left/right, 1 inch top/bottom) */\n  WIDE: {\n    top: 1440,\n    bottom: 1440,\n    left: 2880,\n    right: 2880,\n  },\n  /** Moderate margins (1 inch top/bottom, 0.75 inch left/right) */\n  MODERATE: {\n    top: 1440,\n    bottom: 1440,\n    left: 1080,\n    right: 1080,\n  },\n} as const;\n"]}

package/dist/esm/utils/validation.js

@@ -0,0 +1,285 @@
+import { REQUIRED_DOCX_FILES } from '../zip/types.js';
+import { MissingRequiredFileError } from '../zip/errors.js';
+import { defaultLogger } from './logger.js';
+export function validateDocxStructure(filePaths) {
+    const fileSet = new Set(filePaths);
+    for (const requiredFile of REQUIRED_DOCX_FILES) {
+        if (!fileSet.has(requiredFile)) {
+            throw new MissingRequiredFileError(requiredFile);
+        }
+    }
+}
+export function isBinaryFile(filePath) {
+    const binaryExtensions = [
+        '.png',
+        '.jpg',
+        '.jpeg',
+        '.gif',
+        '.bmp',
+        '.tiff',
+        '.ico',
+        '.emf',
+        '.wmf',
+        '.bin',
+        '.dat',
+        '.ttf',
+        '.otf',
+        '.woff',
+    ];
+    const extension = filePath.substring(filePath.lastIndexOf('.')).toLowerCase();
+    return binaryExtensions.includes(extension);
+}
+export function normalizePath(path) {
+    const normalized = path.replace(/\\/g, '/').replace(/^\/+/, '');
+    if (/%2[eE]|%2[fF]|%5[cC]/.test(path)) {
+        throw new Error(`Invalid file path: "${path}" contains URL-encoded characters (%2E, %2F, %5C). ` +
+            `This could be an attempt to bypass path validation. ` +
+            `Only plain characters are allowed in DOCX file paths.`);
+    }
+    if (normalized.includes('../') || normalized.includes('/..') || normalized === '..') {
+        throw new Error(`Invalid file path: "${path}" contains path traversal sequence (..). ` +
+            `This could be a malicious DOCX file attempting directory traversal. ` +
+            `DOCX archives must only contain relative paths within the archive.`);
+    }
+    if (/^[a-zA-Z]:/.test(normalized)) {
+        throw new Error(`Invalid file path: "${path}" appears to be an absolute Windows path. ` +
+            `Absolute paths are not allowed in DOCX archives. ` +
+            `Only relative paths within the archive are permitted.`);
+    }
+    if (path.startsWith('/') && normalized.startsWith('/')) {
+        throw new Error(`Invalid file path: "${path}" appears to be an absolute Unix path. ` +
+            `Only relative paths are allowed in DOCX archives.`);
+    }
+    return normalized;
+}
+export function isValidZipBuffer(buffer) {
+    if (buffer.length < 4) {
+        return false;
+    }
+    return (buffer[0] === 0x50 &&
+        buffer[1] === 0x4b &&
+        ((buffer[2] === 0x03 && buffer[3] === 0x04) || (buffer[2] === 0x05 && buffer[3] === 0x06)));
+}
+export function isTextContent(content) {
+    if (typeof content === 'string') {
+        return true;
+    }
+    try {
+        const text = content.toString('utf8');
+        return !text.includes('\0');
+    }
+    catch {
+        return false;
+    }
+}
+export function validateTwips(value, fieldName = 'value') {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${fieldName} must be a finite number, got ${value}`);
+    }
+    const MIN_TWIPS = -31680;
+    const MAX_TWIPS = 31680;
+    if (value < MIN_TWIPS || value > MAX_TWIPS) {
+        throw new Error(`${fieldName} out of range: ${value} twips (allowed: ${MIN_TWIPS} to ${MAX_TWIPS}, ±22 inches)`);
+    }
+}
+export function normalizeColor(color) {
+    const hex = color.replace(/^#/, '');
+    if (!/^[0-9A-Fa-f]{3}$|^[0-9A-Fa-f]{6}$/.test(hex)) {
+        throw new Error(`Invalid color format: "${color}". Expected 3 or 6-character hex ` +
+            `(e.g., "FF0000", "#FF0000", "F00", or "#F00")`);
+    }
+    if (hex.length === 3) {
+        return (hex.charAt(0) +
+            hex.charAt(0) +
+            hex.charAt(1) +
+            hex.charAt(1) +
+            hex.charAt(2) +
+            hex.charAt(2)).toUpperCase();
+    }
+    return hex.toUpperCase();
+}
+export function validateColor(color, fieldName = 'color') {
+    if (typeof color !== 'string') {
+        throw new Error(`${fieldName} must be a string, got ${typeof color}`);
+    }
+    const cleanColor = color.startsWith('#') ? color.substring(1) : color;
+    if (!/^[0-9A-Fa-f]{6}$/.test(cleanColor)) {
+        throw new Error(`${fieldName} must be a 6-digit hex color (e.g., 'FF0000' or '#FF0000'), got '${color}'`);
+    }
+}
+export const validateHexColor = validateColor;
+export function validateNumberingId(numId, fieldName = 'numbering ID') {
+    if (!Number.isInteger(numId)) {
+        throw new Error(`${fieldName} must be an integer, got ${numId}`);
+    }
+    if (numId < 0) {
+        throw new Error(`${fieldName} must be non-negative, got ${numId}`);
+    }
+    const MAX_NUM_ID = 2147483647;
+    if (numId > MAX_NUM_ID) {
+        throw new Error(`${fieldName} exceeds maximum value ${MAX_NUM_ID}, got ${numId}`);
+    }
+}
+export function validateLevel(level, fieldName = 'level', maxLevel = 8) {
+    if (!Number.isInteger(level)) {
+        throw new Error(`${fieldName} must be an integer, got ${level}`);
+    }
+    if (level < 0 || level > maxLevel) {
+        throw new Error(`${fieldName} must be between 0 and ${maxLevel}, got ${level}`);
+    }
+}
+export function validateAlignment(alignment, allowed, fieldName = 'alignment') {
+    if (typeof alignment !== 'string') {
+        throw new Error(`${fieldName} must be a string, got ${typeof alignment}`);
+    }
+    if (!allowed.includes(alignment)) {
+        throw new Error(`Invalid ${fieldName}: '${alignment}' (allowed: ${allowed.join(', ')})`);
+    }
+}
+export function validateFontSize(size, fieldName = 'font size') {
+    if (!Number.isFinite(size)) {
+        throw new Error(`${fieldName} must be a finite number, got ${size}`);
+    }
+    if (!Number.isInteger(size)) {
+        throw new Error(`${fieldName} must be an integer (in half-points), got ${size}`);
+    }
+    const MIN_SIZE = 2;
+    const MAX_SIZE = 1638;
+    if (size < MIN_SIZE || size > MAX_SIZE) {
+        throw new Error(`${fieldName} out of range: ${size} half-points (allowed: ${MIN_SIZE}-${MAX_SIZE}, or ${MIN_SIZE / 2}-${MAX_SIZE / 2} points)`);
+    }
+}
+export function validateNonEmptyString(value, fieldName = 'value') {
+    if (typeof value !== 'string') {
+        throw new Error(`${fieldName} must be a string, got ${typeof value}`);
+    }
+    if (value.trim().length === 0) {
+        throw new Error(`${fieldName} cannot be empty`);
+    }
+}
+export function validatePercentage(value, fieldName = 'percentage') {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${fieldName} must be a finite number, got ${value}`);
+    }
+    if (value < 0 || value > 100) {
+        throw new Error(`${fieldName} must be between 0 and 100, got ${value}`);
+    }
+}
+export function validateEmus(value, fieldName = 'EMUs') {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${fieldName} must be a finite number, got ${value}`);
+    }
+    if (!Number.isInteger(value)) {
+        throw new Error(`${fieldName} must be an integer, got ${value}`);
+    }
+    if (value < 0) {
+        throw new Error(`${fieldName} must be non-negative, got ${value}`);
+    }
+    const MAX_EMUS = 50000000;
+    if (value > MAX_EMUS) {
+        throw new Error(`${fieldName} exceeds maximum ${MAX_EMUS} (about 55 inches), got ${value}`);
+    }
+}
+export function detectXmlInText(text, context) {
+    const warnings = [];
+    let hasXmlPatterns = false;
+    const xmlElementPattern = /<\/?w:[^>]+>|<w:[^>]+\/>/g;
+    const escapedXmlPattern = /&lt;.*?&gt;|&quot;|&apos;/g;
+    const problematicPatterns = [
+        /<w:t\s+xml:space="preserve">/,
+        /<w:t\s+xml:space=["']preserve["']>/,
+        /<\/w:t>/,
+        /&lt;w:t\s+xml:space=&quot;preserve&quot;&gt;/,
+    ];
+    if (xmlElementPattern.test(text)) {
+        hasXmlPatterns = true;
+        const contextStr = context ? ` in ${context}` : '';
+        warnings.push(`Text${contextStr} contains XML-like markup: "${text.substring(0, 100)}${text.length > 100 ? '...' : ''}". ` +
+            `This will be displayed as literal text in the document. ` +
+            `If you intended to add formatting, use the appropriate API methods instead.`);
+    }
+    if (escapedXmlPattern.test(text)) {
+        hasXmlPatterns = true;
+        const contextStr = context ? ` in ${context}` : '';
+        warnings.push(`Text${contextStr} contains escaped XML entities (e.g., &lt;, &gt;, &quot;). ` +
+            `These will appear as literal characters in the document.`);
+    }
+    for (const pattern of problematicPatterns) {
+        if (pattern.test(text)) {
+            hasXmlPatterns = true;
+            const contextStr = context ? ` in ${context}` : '';
+            warnings.push(`Text${contextStr} contains a known problematic XML pattern that suggests ` +
+                `the text may have been corrupted by previous processing.`);
+            break;
+        }
+    }
+    return {
+        isValid: true,
+        hasXmlPatterns,
+        warnings,
+    };
+}
+export function cleanXmlFromText(text, aggressive = false) {
+    let cleaned = text;
+    cleaned = cleaned
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&');
+    cleaned = cleaned.replace(/<w:[^>]+>/g, '');
+    cleaned = cleaned.replace(/<\/w:[^>]+>/g, '');
+    if (aggressive) {
+        cleaned = cleaned.replace(/<[^>]+>/g, '');
+    }
+    cleaned = cleaned.replace(/\s+/g, ' ').trim();
+    return cleaned;
+}
+export function validateRunText(text, options = {}) {
+    const { context, autoClean = false, aggressive = false, warnToConsole = true } = options;
+    const result = detectXmlInText(text, context);
+    if (autoClean && result.hasXmlPatterns) {
+        result.cleanedText = cleanXmlFromText(text, aggressive);
+        result.warnings.push(`Text has been automatically cleaned. ` +
+            `Original: "${text.substring(0, 50)}${text.length > 50 ? '...' : ''}" ` +
+            `Cleaned: "${result.cleanedText.substring(0, 50)}${result.cleanedText.length > 50 ? '...' : ''}"`);
+    }
+    if (warnToConsole && result.warnings.length > 0 && typeof console !== 'undefined') {
+        const contextStr = context ? ` [${context}]` : '';
+        defaultLogger.warn(`DocXML Text Validation Warning${contextStr}:`);
+        result.warnings.forEach((warning) => defaultLogger.warn(`  - ${warning}`));
+    }
+    return result;
+}
+export function sanitizeHyperlinkUrl(url) {
+    if (!url)
+        return null;
+    const fixes = [];
+    let sanitized = url;
+    const extensionPrefixes = [
+        { pattern: /^chrome-extension:\/\/[a-z]{32}\//i, name: 'Chrome extension' },
+        {
+            pattern: /^moz-extension:\/\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\//i,
+            name: 'Firefox extension',
+        },
+        { pattern: /^extension:\/\/[a-z0-9]{32}\//i, name: 'Edge extension' },
+    ];
+    for (const { pattern, name } of extensionPrefixes) {
+        const match = pattern.exec(sanitized);
+        if (match) {
+            sanitized = sanitized.substring(match[0].length);
+            fixes.push(`Stripped ${name} URL prefix`);
+            break;
+        }
+    }
+    const brokenProtocol = /^(https?:\/)([^/])/i.exec(sanitized);
+    if (brokenProtocol) {
+        sanitized =
+            brokenProtocol[1] + '/' + brokenProtocol[2] + sanitized.substring(brokenProtocol[0].length);
+        fixes.push('Fixed broken protocol (added missing slash)');
+    }
+    if (fixes.length === 0)
+        return null;
+    return { url: sanitized, fixes };
+}
+//# sourceMappingURL=validation.js.map

package/dist/esm/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validation utilities for DOCX files\n */\n\nimport { REQUIRED_DOCX_FILES } from '../zip/types.js';\nimport { MissingRequiredFileError } from '../zip/errors.js';\nimport { defaultLogger } from './logger.js';\n\n/**\n * Validates that all required DOCX files are present\n * @param filePaths - Array of file paths in the archive\n * @throws {MissingRequiredFileError} If a required file is missing\n */\nexport function validateDocxStructure(filePaths: string[]): void {\n  const fileSet = new Set(filePaths);\n\n  for (const requiredFile of REQUIRED_DOCX_FILES) {\n    if (!fileSet.has(requiredFile)) {\n      throw new MissingRequiredFileError(requiredFile);\n    }\n  }\n}\n\n/**\n * Checks if a file path represents a binary file based on extension\n * @param filePath - The file path to check\n * @returns True if the file is likely binary\n */\nexport function isBinaryFile(filePath: string): boolean {\n  const binaryExtensions = [\n    '.png',\n    '.jpg',\n    '.jpeg',\n    '.gif',\n    '.bmp',\n    '.tiff',\n    '.ico',\n    '.emf',\n    '.wmf',\n    '.bin',\n    '.dat',\n    '.ttf',\n    '.otf',\n    '.woff',\n  ];\n\n  const extension = filePath.substring(filePath.lastIndexOf('.')).toLowerCase();\n  return binaryExtensions.includes(extension);\n}\n\n/**\n * Normalizes a file path for consistent comparisons\n * Converts backslashes to forward slashes and removes leading slashes\n * Also validates against path traversal attacks\n *\n * **Security:** This function validates paths to prevent:\n * - Path traversal attacks (../, ..\\, URL-encoded variants)\n * - Absolute paths (C:\\, /etc/, etc.)\n * - Malicious DOCX files attempting directory escape\n *\n * @param path - The path to normalize\n * @returns Normalized path\n * @throws {Error} If path contains path traversal sequences, absolute paths, or URL-encoded attacks\n */\nexport function normalizePath(path: string): string {\n  // First convert all backslashes to forward slashes for consistent checking\n  const normalized = path.replace(/\\\\/g, '/').replace(/^\\/+/, '');\n\n  // Security: Reject URL-encoded path traversal attempts\n  // Attackers might try: %2e%2e%2f (%2e = . and %2f = /)\n  if (/%2[eE]|%2[fF]|%5[cC]/.test(path)) {\n    throw new Error(\n      `Invalid file path: \"${path}\" contains URL-encoded characters (%2E, %2F, %5C). ` +\n        `This could be an attempt to bypass path validation. ` +\n        `Only plain characters are allowed in DOCX file paths.`\n    );\n  }\n\n  // Security: Prevent path traversal attacks\n  // Check AFTER normalization when all paths use forward slashes\n  // This catches: ../, /.., or standalone \"..\"\n  if (normalized.includes('../') || normalized.includes('/..') || normalized === '..') {\n    throw new Error(\n      `Invalid file path: \"${path}\" contains path traversal sequence (..). ` +\n        `This could be a malicious DOCX file attempting directory traversal. ` +\n        `DOCX archives must only contain relative paths within the archive.`\n    );\n  }\n\n  // Security: Prevent absolute paths (Windows drive letters)\n  // Examples: C:/, C:\\, D:, etc.\n  if (/^[a-zA-Z]:/.test(normalized)) {\n    throw new Error(\n      `Invalid file path: \"${path}\" appears to be an absolute Windows path. ` +\n        `Absolute paths are not allowed in DOCX archives. ` +\n        `Only relative paths within the archive are permitted.`\n    );\n  }\n\n  // Security: Prevent Unix absolute paths\n  // After removing leading slashes, if it starts with / it's suspicious\n  if (path.startsWith('/') && normalized.startsWith('/')) {\n    throw new Error(\n      `Invalid file path: \"${path}\" appears to be an absolute Unix path. ` +\n        `Only relative paths are allowed in DOCX archives.`\n    );\n  }\n\n  return normalized;\n}\n\n/**\n * Validates that a buffer contains a valid ZIP file signature\n * ZIP files start with the signature 'PK' (0x50 0x4B)\n * @param buffer - The buffer to validate\n * @returns True if the buffer appears to be a ZIP file\n */\nexport function isValidZipBuffer(buffer: Buffer): boolean {\n  if (buffer.length < 4) {\n    return false;\n  }\n\n  // Check for ZIP signature: PK\\x03\\x04 or PK\\x05\\x06 (for empty archives)\n  return (\n    buffer[0] === 0x50 &&\n    buffer[1] === 0x4b &&\n    ((buffer[2] === 0x03 && buffer[3] === 0x04) || (buffer[2] === 0x05 && buffer[3] === 0x06))\n  );\n}\n\n/**\n * Checks if a string is valid UTF-8 text\n * @param content - The content to check\n * @returns True if the content is valid text\n */\nexport function isTextContent(content: Buffer | string): boolean {\n  if (typeof content === 'string') {\n    return true;\n  }\n\n  // Try to decode as UTF-8 and check for null bytes\n  try {\n    const text = content.toString('utf8');\n    // Binary files often contain null bytes\n    return !text.includes('\\0');\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Validates a twips value (used for spacing, indentation, margins)\n * Twips: 1/20th of a point, 1440 twips = 1 inch\n * Reasonable range: -31680 to 31680 (±22 inches)\n * @param value - The twips value to validate\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the value is invalid\n */\nexport function validateTwips(value: number, fieldName = 'value'): void {\n  if (!Number.isFinite(value)) {\n    throw new Error(`${fieldName} must be a finite number, got ${value}`);\n  }\n\n  // Reasonable range: ±22 inches (31680 twips)\n  const MIN_TWIPS = -31680;\n  const MAX_TWIPS = 31680;\n\n  if (value < MIN_TWIPS || value > MAX_TWIPS) {\n    throw new Error(\n      `${fieldName} out of range: ${value} twips (allowed: ${MIN_TWIPS} to ${MAX_TWIPS}, ±22 inches)`\n    );\n  }\n}\n\n/**\n * Normalizes a color to uppercase 6-character hex format\n * Accepts 3-character or 6-character hex colors with or without '#' prefix\n * Follows Microsoft Word convention of uppercase hex colors\n *\n * @param color - Color to normalize (e.g., '#F00', 'FF0000', '#FF0000', 'f00')\n * @returns Normalized color (e.g., 'FF0000')\n * @throws Error if color format is invalid\n *\n * @example\n * ```typescript\n * normalizeColor('#F00')      // Returns: 'FF0000'\n * normalizeColor('FF0000')    // Returns: 'FF0000'\n * normalizeColor('#ff0000')   // Returns: 'FF0000'\n * normalizeColor('f00')       // Returns: 'FF0000'\n * ```\n */\nexport function normalizeColor(color: string): string {\n  const hex = color.replace(/^#/, '');\n\n  // Validate hex format\n  if (!/^[0-9A-Fa-f]{3}$|^[0-9A-Fa-f]{6}$/.test(hex)) {\n    throw new Error(\n      `Invalid color format: \"${color}\". Expected 3 or 6-character hex ` +\n        `(e.g., \"FF0000\", \"#FF0000\", \"F00\", or \"#F00\")`\n    );\n  }\n\n  // Expand 3-character to 6-character\n  if (hex.length === 3) {\n    return (\n      hex.charAt(0) +\n      hex.charAt(0) +\n      hex.charAt(1) +\n      hex.charAt(1) +\n      hex.charAt(2) +\n      hex.charAt(2)\n    ).toUpperCase();\n  }\n\n  return hex.toUpperCase();\n}\n\n/**\n * Validates a hexadecimal color value\n * Must be 6 characters (RRGGBB format)\n * @param color - The color hex string to validate (without #)\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the color is invalid\n */\nexport function validateColor(color: string, fieldName = 'color'): void {\n  if (typeof color !== 'string') {\n    throw new Error(`${fieldName} must be a string, got ${typeof color}`);\n  }\n\n  // Allow both with and without # prefix\n  const cleanColor = color.startsWith('#') ? color.substring(1) : color;\n\n  if (!/^[0-9A-Fa-f]{6}$/.test(cleanColor)) {\n    throw new Error(\n      `${fieldName} must be a 6-digit hex color (e.g., 'FF0000' or '#FF0000'), got '${color}'`\n    );\n  }\n}\n\n/**\n * Alias for validateColor for backwards compatibility\n */\nexport const validateHexColor = validateColor;\n\n/**\n * Validates a numbering ID (must be non-negative integer)\n * @param numId - The numbering ID to validate\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the ID is invalid\n */\nexport function validateNumberingId(numId: number, fieldName = 'numbering ID'): void {\n  if (!Number.isInteger(numId)) {\n    throw new Error(`${fieldName} must be an integer, got ${numId}`);\n  }\n\n  if (numId < 0) {\n    throw new Error(`${fieldName} must be non-negative, got ${numId}`);\n  }\n\n  // Word supports numbering IDs up to 2147483647\n  const MAX_NUM_ID = 2147483647;\n  if (numId > MAX_NUM_ID) {\n    throw new Error(`${fieldName} exceeds maximum value ${MAX_NUM_ID}, got ${numId}`);\n  }\n}\n\n/**\n * Validates a numbering level (0-8 for Word)\n * @param level - The level to validate\n * @param fieldName - Name of the field (for error messages)\n * @param maxLevel - Maximum allowed level (default 8)\n * @throws {Error} If the level is invalid\n */\nexport function validateLevel(level: number, fieldName = 'level', maxLevel = 8): void {\n  if (!Number.isInteger(level)) {\n    throw new Error(`${fieldName} must be an integer, got ${level}`);\n  }\n\n  if (level < 0 || level > maxLevel) {\n    throw new Error(`${fieldName} must be between 0 and ${maxLevel}, got ${level}`);\n  }\n}\n\n/**\n * Validates an alignment value against allowed values\n * @param alignment - The alignment value to validate\n * @param allowed - Array of allowed alignment values\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the alignment is invalid\n */\nexport function validateAlignment(\n  alignment: string,\n  allowed: readonly string[],\n  fieldName = 'alignment'\n): void {\n  if (typeof alignment !== 'string') {\n    throw new Error(`${fieldName} must be a string, got ${typeof alignment}`);\n  }\n\n  if (!allowed.includes(alignment)) {\n    throw new Error(`Invalid ${fieldName}: '${alignment}' (allowed: ${allowed.join(', ')})`);\n  }\n}\n\n/**\n * Validates a font size (in half-points for Word)\n * Reasonable range: 2-1638 (1-819 points)\n * @param size - The font size in half-points to validate\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the size is invalid\n */\nexport function validateFontSize(size: number, fieldName = 'font size'): void {\n  if (!Number.isFinite(size)) {\n    throw new Error(`${fieldName} must be a finite number, got ${size}`);\n  }\n\n  if (!Number.isInteger(size)) {\n    throw new Error(`${fieldName} must be an integer (in half-points), got ${size}`);\n  }\n\n  // Reasonable range: 2-1638 half-points (1-819 points)\n  const MIN_SIZE = 2;\n  const MAX_SIZE = 1638;\n\n  if (size < MIN_SIZE || size > MAX_SIZE) {\n    throw new Error(\n      `${fieldName} out of range: ${size} half-points (allowed: ${MIN_SIZE}-${MAX_SIZE}, or ${MIN_SIZE / 2}-${MAX_SIZE / 2} points)`\n    );\n  }\n}\n\n/**\n * Validates that a string is not empty\n * @param value - The string to validate\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the string is empty or not a string\n */\nexport function validateNonEmptyString(value: string, fieldName = 'value'): void {\n  if (typeof value !== 'string') {\n    throw new Error(`${fieldName} must be a string, got ${typeof value}`);\n  }\n\n  if (value.trim().length === 0) {\n    throw new Error(`${fieldName} cannot be empty`);\n  }\n}\n\n/**\n * Validates a percentage value (0-100)\n * @param value - The percentage to validate\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the percentage is invalid\n */\nexport function validatePercentage(value: number, fieldName = 'percentage'): void {\n  if (!Number.isFinite(value)) {\n    throw new Error(`${fieldName} must be a finite number, got ${value}`);\n  }\n\n  if (value < 0 || value > 100) {\n    throw new Error(`${fieldName} must be between 0 and 100, got ${value}`);\n  }\n}\n\n/**\n * Validates EMUs (English Metric Units) value\n * Used for image dimensions: 914400 EMUs = 1 inch\n * Reasonable range: 0 to 50 million (about 55 inches)\n * @param value - The EMUs value to validate\n * @param fieldName - Name of the field (for error messages)\n * @throws {Error} If the value is invalid\n */\nexport function validateEmus(value: number, fieldName = 'EMUs'): void {\n  if (!Number.isFinite(value)) {\n    throw new Error(`${fieldName} must be a finite number, got ${value}`);\n  }\n\n  if (!Number.isInteger(value)) {\n    throw new Error(`${fieldName} must be an integer, got ${value}`);\n  }\n\n  if (value < 0) {\n    throw new Error(`${fieldName} must be non-negative, got ${value}`);\n  }\n\n  // Reasonable maximum: 50 million EMUs (about 55 inches)\n  const MAX_EMUS = 50000000;\n  if (value > MAX_EMUS) {\n    throw new Error(`${fieldName} exceeds maximum ${MAX_EMUS} (about 55 inches), got ${value}`);\n  }\n}\n\n/**\n * Result of text validation for XML-like content\n */\nexport interface TextValidationResult {\n  isValid: boolean;\n  hasXmlPatterns: boolean;\n  warnings: string[];\n  cleanedText?: string;\n}\n\n/**\n * Detects XML-like patterns in text that might cause display issues\n *\n * This function checks for patterns that look like XML markup which,\n * when properly escaped in XML output, will display as literal text\n * in Word documents rather than being interpreted as markup.\n *\n * @param text - The text to validate\n * @param context - Optional context for better warning messages (e.g., \"hyperlink text\")\n * @returns Validation result with warnings and optional cleaned text\n */\nexport function detectXmlInText(text: string, context?: string): TextValidationResult {\n  const warnings: string[] = [];\n  let hasXmlPatterns = false;\n\n  // Check for common XML element patterns\n  const xmlElementPattern = /<\\/?w:[^>]+>|<w:[^>]+\\/>/g;\n  const escapedXmlPattern = /&lt;.*?&gt;|&quot;|&apos;/g;\n\n  // Check for specific problematic patterns we've seen\n  const problematicPatterns = [\n    /<w:t\\s+xml:space=\"preserve\">/,\n    /<w:t\\s+xml:space=[\"']preserve[\"']>/,\n    /<\\/w:t>/,\n    /&lt;w:t\\s+xml:space=&quot;preserve&quot;&gt;/,\n  ];\n\n  // Check for any XML-like tags\n  if (xmlElementPattern.test(text)) {\n    hasXmlPatterns = true;\n    const contextStr = context ? ` in ${context}` : '';\n    warnings.push(\n      `Text${contextStr} contains XML-like markup: \"${text.substring(0, 100)}${text.length > 100 ? '...' : ''}\". ` +\n        `This will be displayed as literal text in the document. ` +\n        `If you intended to add formatting, use the appropriate API methods instead.`\n    );\n  }\n\n  // Check for already-escaped XML entities\n  if (escapedXmlPattern.test(text)) {\n    hasXmlPatterns = true;\n    const contextStr = context ? ` in ${context}` : '';\n    warnings.push(\n      `Text${contextStr} contains escaped XML entities (e.g., &lt;, &gt;, &quot;). ` +\n        `These will appear as literal characters in the document.`\n    );\n  }\n\n  // Check for specific known problematic patterns\n  for (const pattern of problematicPatterns) {\n    if (pattern.test(text)) {\n      hasXmlPatterns = true;\n      const contextStr = context ? ` in ${context}` : '';\n      warnings.push(\n        `Text${contextStr} contains a known problematic XML pattern that suggests ` +\n          `the text may have been corrupted by previous processing.`\n      );\n      break;\n    }\n  }\n\n  return {\n    isValid: true, // Text is always \"valid\" - we just warn about potential issues\n    hasXmlPatterns,\n    warnings,\n  };\n}\n\n/**\n * Cleans XML-like patterns from text\n *\n * This function removes or cleans various XML patterns that might\n * appear in text content, typically from corrupted or improperly\n * processed documents.\n *\n * @param text - The text to clean\n * @param aggressive - If true, removes all angle brackets; if false, only removes clear XML tags\n * @returns Cleaned text with XML patterns removed\n */\nexport function cleanXmlFromText(text: string, aggressive = false): string {\n  let cleaned = text;\n\n  // First, unescape any HTML/XML entities\n  cleaned = cleaned\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&apos;/g, \"'\")\n    .replace(/&amp;/g, '&');\n\n  // Remove specific Word XML patterns\n  // This targets patterns like <w:t xml:space=\"preserve\">\n  cleaned = cleaned.replace(/<w:[^>]+>/g, '');\n  cleaned = cleaned.replace(/<\\/w:[^>]+>/g, '');\n\n  // Remove any remaining XML-like tags if aggressive mode\n  if (aggressive) {\n    cleaned = cleaned.replace(/<[^>]+>/g, '');\n  }\n\n  // Clean up any double spaces left behind\n  cleaned = cleaned.replace(/\\s+/g, ' ').trim();\n\n  return cleaned;\n}\n\n/**\n * Validates text for use in Run or Hyperlink elements\n *\n * This is the main validation function that should be called when\n * setting text content in Run or Hyperlink elements. It provides\n * warnings about problematic content and optionally cleans the text.\n *\n * @param text - The text to validate\n * @param options - Validation options\n * @returns Validation result with warnings and optionally cleaned text\n */\nexport function validateRunText(\n  text: string,\n  options: {\n    context?: string;\n    autoClean?: boolean;\n    aggressive?: boolean;\n    warnToConsole?: boolean;\n  } = {}\n): TextValidationResult {\n  const { context, autoClean = false, aggressive = false, warnToConsole = true } = options;\n\n  // Detect XML patterns\n  const result = detectXmlInText(text, context);\n\n  // If auto-cleaning is enabled and XML patterns were found\n  if (autoClean && result.hasXmlPatterns) {\n    result.cleanedText = cleanXmlFromText(text, aggressive);\n\n    // Add a note about cleaning\n    result.warnings.push(\n      `Text has been automatically cleaned. ` +\n        `Original: \"${text.substring(0, 50)}${text.length > 50 ? '...' : ''}\" ` +\n        `Cleaned: \"${result.cleanedText.substring(0, 50)}${result.cleanedText.length > 50 ? '...' : ''}\"`\n    );\n  }\n\n  // Log warnings to console in development if requested\n  if (warnToConsole && result.warnings.length > 0 && typeof console !== 'undefined') {\n    const contextStr = context ? ` [${context}]` : '';\n    defaultLogger.warn(`DocXML Text Validation Warning${contextStr}:`);\n    result.warnings.forEach((warning) => defaultLogger.warn(`  - ${warning}`));\n  }\n\n  return result;\n}\n\n/**\n * Result of URL sanitization\n */\nexport interface SanitizeHyperlinkUrlResult {\n  /** The sanitized URL */\n  url: string;\n  /** List of fixes that were applied */\n  fixes: string[];\n}\n\n/**\n * Sanitizes hyperlink URLs by removing browser extension prefixes and fixing\n * broken protocols that result from the stripping.\n *\n * Known corruptions:\n * - Chrome extensions (e.g. Adobe Acrobat) wrap URLs with `chrome-extension://[id]/`\n * - Firefox extensions wrap URLs with `moz-extension://[uuid]/`\n * - Edge extensions wrap URLs with `extension://[id]/`\n * - After stripping, protocol may be broken (`https:/` instead of `https://`)\n *\n * @param url - The URL to sanitize\n * @returns Object with sanitized URL and list of fixes, or null if no changes needed\n */\nexport function sanitizeHyperlinkUrl(url: string): SanitizeHyperlinkUrlResult | null {\n  if (!url) return null;\n\n  const fixes: string[] = [];\n  let sanitized = url;\n\n  // Strip known browser extension URL prefixes\n  const extensionPrefixes = [\n    { pattern: /^chrome-extension:\\/\\/[a-z]{32}\\//i, name: 'Chrome extension' },\n    {\n      pattern: /^moz-extension:\\/\\/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\//i,\n      name: 'Firefox extension',\n    },\n    { pattern: /^extension:\\/\\/[a-z0-9]{32}\\//i, name: 'Edge extension' },\n  ];\n\n  for (const { pattern, name } of extensionPrefixes) {\n    const match = pattern.exec(sanitized);\n    if (match) {\n      sanitized = sanitized.substring(match[0].length);\n      fixes.push(`Stripped ${name} URL prefix`);\n      break;\n    }\n  }\n\n  // Fix broken protocol after stripping (https:/ -> https://, http:/ -> http://)\n  const brokenProtocol = /^(https?:\\/)([^/])/i.exec(sanitized);\n  if (brokenProtocol) {\n    sanitized =\n      brokenProtocol[1] + '/' + brokenProtocol[2] + sanitized.substring(brokenProtocol[0].length);\n    fixes.push('Fixed broken protocol (added missing slash)');\n  }\n\n  if (fixes.length === 0) return null;\n\n  return { url: sanitized, fixes };\n}\n"]}

package/dist/esm/utils/xmlSanitization.js

@@ -0,0 +1,54 @@
+import { getGlobalLogger } from './logger.js';
+const INVALID_XML_CHAR_REGEX = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
+export function removeInvalidXmlChars(text, logWarning = true) {
+    INVALID_XML_CHAR_REGEX.lastIndex = 0;
+    if (logWarning && INVALID_XML_CHAR_REGEX.test(text)) {
+        INVALID_XML_CHAR_REGEX.lastIndex = 0;
+        const invalidChars = findInvalidXmlChars(text);
+        const hexCodes = invalidChars
+            .map((c) => `0x${c.toString(16).toUpperCase().padStart(2, '0')}`)
+            .join(', ');
+        getGlobalLogger().warn(`[XMLSanitization] Removing invalid XML control characters: ${hexCodes}`);
+    }
+    INVALID_XML_CHAR_REGEX.lastIndex = 0;
+    return text.replace(INVALID_XML_CHAR_REGEX, '');
+}
+export function findInvalidXmlChars(text) {
+    const invalid = [];
+    for (let i = 0; i < text.length; i++) {
+        const code = text.charCodeAt(i);
+        if ((code >= 0x00 && code <= 0x08) ||
+            (code >= 0x0b && code <= 0x0c) ||
+            (code >= 0x0e && code <= 0x1f) ||
+            code === 0x7f) {
+            if (!invalid.includes(code)) {
+                invalid.push(code);
+            }
+        }
+    }
+    return invalid;
+}
+export function hasInvalidXmlChars(text) {
+    INVALID_XML_CHAR_REGEX.lastIndex = 0;
+    return INVALID_XML_CHAR_REGEX.test(text);
+}
+export const XML_CONTROL_CHARS = {
+    NULL: 0x00,
+    SOH: 0x01,
+    STX: 0x02,
+    ETX: 0x03,
+    EOT: 0x04,
+    ENQ: 0x05,
+    ACK: 0x06,
+    BEL: 0x07,
+    BS: 0x08,
+    TAB: 0x09,
+    LF: 0x0a,
+    VT: 0x0b,
+    FF: 0x0c,
+    CR: 0x0d,
+    SO: 0x0e,
+    US: 0x1f,
+    DEL: 0x7f,
+};
+//# sourceMappingURL=xmlSanitization.js.map

package/dist/esm/utils/xmlSanitization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlSanitization.js","sourceRoot":"","sources":["../../../src/utils/xmlSanitization.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,MAAM,sBAAsB,GAAG,mCAAmC,CAAC;AA4BnE,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,UAAU,GAAG,IAAI;IAEnE,sBAAsB,CAAC,SAAS,GAAG,CAAC,CAAC;IAErC,IAAI,UAAU,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAEpD,sBAAsB,CAAC,SAAS,GAAG,CAAC,CAAC;QAErC,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,YAAY;aAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;aAChE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,eAAe,EAAE,CAAC,IAAI,CACpB,8DAA8D,QAAQ,EAAE,CACzE,CAAC;IACJ,CAAC;IAGD,sBAAsB,CAAC,SAAS,GAAG,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAoBD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAGhC,IACE,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC;YAC9B,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC;YAC9B,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC;YAC9B,IAAI,KAAK,IAAI,EACb,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAkBD,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAE7C,sBAAsB,CAAC,SAAS,GAAG,CAAC,CAAC;IACrC,OAAO,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAKD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAE/B,IAAI,EAAE,IAAI;IAEV,GAAG,EAAE,IAAI;IAET,GAAG,EAAE,IAAI;IAET,GAAG,EAAE,IAAI;IAET,GAAG,EAAE,IAAI;IAET,GAAG,EAAE,IAAI;IAET,GAAG,EAAE,IAAI;IAET,GAAG,EAAE,IAAI;IAET,EAAE,EAAE,IAAI;IAER,GAAG,EAAE,IAAI;IAET,EAAE,EAAE,IAAI;IAER,EAAE,EAAE,IAAI;IAER,EAAE,EAAE,IAAI;IAER,EAAE,EAAE,IAAI;IAER,EAAE,EAAE,IAAI;IAER,EAAE,EAAE,IAAI;IAER,GAAG,EAAE,IAAI;CACD,CAAC","sourcesContent":["/**\n * XML Sanitization Utilities\n *\n * Provides functions for validating and sanitizing text content per XML 1.0 specification.\n * Per XML 1.0, certain control characters are invalid and must be removed before\n * including text in XML documents.\n *\n * Valid characters in XML 1.0:\n * - 0x09 (tab), 0x0A (newline), 0x0D (carriage return)\n * - 0x20-0xD7FF, 0xE000-0xFFFD, 0x10000-0x10FFFF\n *\n * Invalid characters (control characters that must be removed):\n * - 0x00-0x08 (NULL through BACKSPACE)\n * - 0x0B-0x0C (VERTICAL TAB and FORM FEED)\n * - 0x0E-0x1F (SHIFT OUT through UNIT SEPARATOR)\n * - 0x7F (DELETE)\n *\n * @module xmlSanitization\n */\n\nimport { getGlobalLogger } from './logger.js';\n\n/**\n * Regular expression matching invalid XML 1.0 control characters.\n * Matches: 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F, 0x7F\n * Does NOT match valid chars: 0x09 (tab), 0x0A (newline), 0x0D (CR)\n */\nconst INVALID_XML_CHAR_REGEX = /[\\x00-\\x08\\x0B\\x0C\\x0E-\\x1F\\x7F]/g;\n\n/**\n * Removes invalid XML 1.0 control characters from text.\n *\n * Per XML 1.0 spec, characters 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F, 0x7F are invalid\n * and cannot appear in XML documents. This function removes them.\n *\n * Valid control characters are preserved:\n * - Tab (0x09)\n * - Line Feed / Newline (0x0A)\n * - Carriage Return (0x0D)\n *\n * @param text - Input text to sanitize\n * @param logWarning - If true, logs a warning when invalid chars are found (default: true)\n * @returns Sanitized text with invalid control characters removed\n *\n * @example\n * ```typescript\n * // Remove NULL byte from text\n * const clean = removeInvalidXmlChars(\"Hello\\x00World\");\n * // Returns: \"HelloWorld\"\n *\n * // Tab and newline are preserved\n * const preserved = removeInvalidXmlChars(\"Hello\\tWorld\\n\");\n * // Returns: \"Hello\\tWorld\\n\"\n * ```\n */\nexport function removeInvalidXmlChars(text: string, logWarning = true): string {\n  // Reset regex lastIndex for global regex\n  INVALID_XML_CHAR_REGEX.lastIndex = 0;\n\n  if (logWarning && INVALID_XML_CHAR_REGEX.test(text)) {\n    // Reset regex lastIndex after test\n    INVALID_XML_CHAR_REGEX.lastIndex = 0;\n\n    const invalidChars = findInvalidXmlChars(text);\n    const hexCodes = invalidChars\n      .map((c) => `0x${c.toString(16).toUpperCase().padStart(2, '0')}`)\n      .join(', ');\n    getGlobalLogger().warn(\n      `[XMLSanitization] Removing invalid XML control characters: ${hexCodes}`\n    );\n  }\n\n  // Reset regex lastIndex before replace\n  INVALID_XML_CHAR_REGEX.lastIndex = 0;\n  return text.replace(INVALID_XML_CHAR_REGEX, '');\n}\n\n/**\n * Finds all invalid XML 1.0 control characters in text.\n *\n * Returns an array of unique character codes that are invalid per XML 1.0 spec.\n * This is useful for diagnostics and error reporting.\n *\n * @param text - Text to scan for invalid characters\n * @returns Array of unique invalid character codes found, or empty array if text is valid\n *\n * @example\n * ```typescript\n * const invalid = findInvalidXmlChars(\"Hello\\x00\\x08World\");\n * // Returns: [0, 8] - NULL and BACKSPACE codes\n *\n * const valid = findInvalidXmlChars(\"Hello\\tWorld\");\n * // Returns: [] - tab is valid\n * ```\n */\nexport function findInvalidXmlChars(text: string): number[] {\n  const invalid: number[] = [];\n\n  for (let i = 0; i < text.length; i++) {\n    const code = text.charCodeAt(i);\n\n    // Check if character is in invalid ranges\n    if (\n      (code >= 0x00 && code <= 0x08) || // NULL through BACKSPACE\n      (code >= 0x0b && code <= 0x0c) || // VERTICAL TAB and FORM FEED\n      (code >= 0x0e && code <= 0x1f) || // SHIFT OUT through UNIT SEPARATOR\n      code === 0x7f // DELETE\n    ) {\n      // Only add unique codes\n      if (!invalid.includes(code)) {\n        invalid.push(code);\n      }\n    }\n  }\n\n  return invalid;\n}\n\n/**\n * Checks if text contains any invalid XML 1.0 control characters.\n *\n * This is a fast check that returns true/false without identifying specific characters.\n * Use `findInvalidXmlChars()` if you need to know which characters are invalid.\n *\n * @param text - Text to check\n * @returns true if text contains invalid characters, false otherwise\n *\n * @example\n * ```typescript\n * hasInvalidXmlChars(\"Hello\\x00World\");  // true - NULL byte\n * hasInvalidXmlChars(\"Hello\\tWorld\");    // false - tab is valid\n * hasInvalidXmlChars(\"Normal text\");     // false\n * ```\n */\nexport function hasInvalidXmlChars(text: string): boolean {\n  // Reset regex lastIndex for global regex\n  INVALID_XML_CHAR_REGEX.lastIndex = 0;\n  return INVALID_XML_CHAR_REGEX.test(text);\n}\n\n/**\n * Character code constants for documentation and testing.\n */\nexport const XML_CONTROL_CHARS = {\n  /** NULL (0x00) - Invalid */\n  NULL: 0x00,\n  /** Start of Heading (0x01) - Invalid */\n  SOH: 0x01,\n  /** Start of Text (0x02) - Invalid */\n  STX: 0x02,\n  /** End of Text (0x03) - Invalid */\n  ETX: 0x03,\n  /** End of Transmission (0x04) - Invalid */\n  EOT: 0x04,\n  /** Enquiry (0x05) - Invalid */\n  ENQ: 0x05,\n  /** Acknowledge (0x06) - Invalid */\n  ACK: 0x06,\n  /** Bell (0x07) - Invalid */\n  BEL: 0x07,\n  /** Backspace (0x08) - Invalid */\n  BS: 0x08,\n  /** Horizontal Tab (0x09) - VALID */\n  TAB: 0x09,\n  /** Line Feed / Newline (0x0A) - VALID */\n  LF: 0x0a,\n  /** Vertical Tab (0x0B) - Invalid */\n  VT: 0x0b,\n  /** Form Feed (0x0C) - Invalid */\n  FF: 0x0c,\n  /** Carriage Return (0x0D) - VALID */\n  CR: 0x0d,\n  /** Shift Out (0x0E) - Invalid */\n  SO: 0x0e,\n  /** Unit Separator (0x1F) - Invalid */\n  US: 0x1f,\n  /** Delete (0x7F) - Invalid */\n  DEL: 0x7f,\n} as const;\n"]}