@docen/utils 0.0.9 → 0.0.10

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";const DOCX_DPI=96;function convertTwipToPixels(r){return Math.round(r*96/1440)}function convertTwipToCssString(r){return`${convertTwipToPixels(r)}px`}function convertPixelsToTwip(r){return Math.round(r*(1440/96))}function convertEmuToPixels(r){return Math.round(r/(914400/96))}function convertPixelsToEmu(r){return Math.round(r*(914400/96))}function convertEmuStringToPixels(r){const n=parseInt(r,10);if(!isNaN(n))return convertEmuToPixels(n)}const i=/^([\d.]+)(px|pt|em|rem|%|)?$/,s={px:1,pt:1.333,em:16,rem:16,"%":.16};function convertCssLengthToPixels(r){if(!r)return 0;r=r.trim();const n=r.match(i);if(!n)return 0;const e=parseFloat(n[1]);if(isNaN(e))return 0;const t=n[2]||"px",o=s[t]??1;return Math.round(e*o)}const c=/^([\d.]+)(in|mm|cm|pt|pc|pi)$/,m={in:1,mm:1/25.4,cm:1/2.54,pt:1/72,pc:1/6,pi:1/6};function convertMeasureToInches(r){if(typeof r=="number")return r;const n=r.match(c);if(n){const t=parseFloat(n[1]),o=n[2],u=m[o];return u!==void 0?t*u:t}const e=parseFloat(r);return isNaN(e)?6.5:e}function convertMeasureToPixels(r){if(typeof r=="number")return r;const n=convertMeasureToInches(r);return Math.round(n*96)}const COLOR_NAME_TO_HEX={black:"#000000",white:"#FFFFFF",red:"#FF0000",green:"#008000",blue:"#0000FF",yellow:"#FFFF00",orange:"#FFA500",purple:"#800080",pink:"#FFC0CB",brown:"#A52A2A",gray:"#808080",grey:"#808080",cyan:"#00FFFF",magenta:"#FF00FF",lime:"#00FF00",navy:"#000080",teal:"#008080",maroon:"#800000",olive:"#808000",silver:"#C0C0C0",gold:"#FFD700",indigo:"#4B0082",violet:"#EE82EE",aqua:"#00FFFF",fuchsia:"#FF00FF",darkblue:"#00008B",darkcyan:"#008B8B",darkgrey:"#A9A9A9",darkgreen:"#006400",darkkhaki:"#BDB76B",darkmagenta:"#8B008B",darkolivegreen:"#556B2F",darkorange:"#FF8C00",darkorchid:"#9932CC",darkred:"#8B0000",darksalmon:"#E9967A",darkviolet:"#9400D3",lightblue:"#ADD8E6",lightcyan:"#E0FFFF",lightgreen:"#90EE90",lightgrey:"#D3D3D3",lightpink:"#FFB6C1",lightyellow:"#FFFFE0"};function convertColorToHex(r){if(r)return r.startsWith("#")?r:COLOR_NAME_TO_HEX[r.toLowerCase()]||r}function normalizeHexColor(r){return r.startsWith("#")?r:`#${r}`}function findChild(r,n){if(!r.children)return null;for(const e of r.children)if(e.type==="element"&&e.name===n)return e;return null}function findDeepChild(r,n){if(!r.children)return null;for(const e of r.children)if(e.type==="element"){if(e.name===n)return e;const t=findDeepChild(e,n);if(t)return t}return null}function findDeepChildren(r,n){const e=[];if(!r.children)return e;for(const t of r.children)t.type==="element"&&(t.name===n&&e.push(t),e.push(...findDeepChildren(t,n)));return e}function parseTwipAttr(r,n){const e=r[n];if(!e)return;const t=parseInt(e,10);if(!isNaN(t))return e}exports.COLOR_NAME_TO_HEX=COLOR_NAME_TO_HEX,exports.DOCX_DPI=96,exports.convertColorToHex=convertColorToHex,exports.convertCssLengthToPixels=convertCssLengthToPixels,exports.convertEmuStringToPixels=convertEmuStringToPixels,exports.convertEmuToPixels=convertEmuToPixels,exports.convertMeasureToInches=convertMeasureToInches,exports.convertMeasureToPixels=convertMeasureToPixels,exports.convertPixelsToEmu=convertPixelsToEmu,exports.convertPixelsToTwip=convertPixelsToTwip,exports.convertTwipToCssString=convertTwipToCssString,exports.convertTwipToPixels=convertTwipToPixels,exports.findChild=findChild,exports.findDeepChild=findDeepChild,exports.findDeepChildren=findDeepChildren,exports.normalizeHexColor=normalizeHexColor,exports.parseTwipAttr=parseTwipAttr;
+"use strict";const DOCX_DPI=96,TWIPS_PER_INCH=1440,EMUS_PER_INCH=914400,HALF_POINTS_PER_PIXEL=1.5,PIXELS_PER_HALF_POINT=.6666666666666666,DEFAULT_CODE_FONT="Consolas",CHECKBOX_SYMBOLS={checked:"\u2611",unchecked:"\u2610"},DOCX_STYLE_NAMES={CODE_BLOCK:"CodeBlock",CODE_PREFIX:"Code"},TEXT_ALIGN_MAP={tiptapToDocx:{left:"left",right:"right",center:"center",justify:"both"},docxToTipTap:{left:"left",right:"right",center:"center",both:"justify"}},PAGE_DIMENSIONS={A4_WIDTH_TWIP:11906,DEFAULT_MARGIN_TWIP:1440},o=96;function convertTwipToPixels(e){return Math.round(e*o/1440)}function convertTwipToCssString(e){return`${convertTwipToPixels(e)}px`}function convertPixelsToTwip(e){return Math.round(e*(1440/o))}function convertEmuToPixels(e){return Math.round(e/(914400/o))}function convertPixelsToEmu(e){return Math.round(e*(914400/o))}function convertEmuStringToPixels(e){const r=parseInt(e,10);if(!isNaN(r))return convertEmuToPixels(r)}const p=/^(-?[\d.]+)(px|pt|em|rem|%|)?$/,f={px:1,pt:1.333,em:16,rem:16,"%":.16};function convertCssLengthToPixels(e){if(!e)return 0;e=e.trim();const r=e.match(p);if(!r)return 0;const t=parseFloat(r[1]);if(isNaN(t))return 0;const n=r[2]||"px",i=f[n]??1;return Math.round(t*i)}const a=/^([\d.]+)(in|mm|cm|pt|pc|pi)$/,x={in:1,mm:1/25.4,cm:1/2.54,pt:1/72,pc:1/6,pi:1/6};function convertMeasureToInches(e){if(typeof e=="number")return e;const r=e.match(a);if(r){const n=parseFloat(r[1]),i=r[2],s=x[i];return s!==void 0?n*s:n}const t=parseFloat(e);return isNaN(t)?6.5:t}function convertMeasureToPixels(e){if(typeof e=="number")return e;const r=convertMeasureToInches(e);return Math.round(r*96)}const COLOR_NAME_TO_HEX={black:"#000000",white:"#FFFFFF",red:"#FF0000",green:"#008000",blue:"#0000FF",yellow:"#FFFF00",orange:"#FFA500",purple:"#800080",pink:"#FFC0CB",brown:"#A52A2A",gray:"#808080",grey:"#808080",cyan:"#00FFFF",magenta:"#FF00FF",lime:"#00FF00",navy:"#000080",teal:"#008080",maroon:"#800000",olive:"#808000",silver:"#C0C0C0",gold:"#FFD700",indigo:"#4B0082",violet:"#EE82EE",aqua:"#00FFFF",fuchsia:"#FF00FF",darkblue:"#00008B",darkcyan:"#008B8B",darkgrey:"#A9A9A9",darkgreen:"#006400",darkkhaki:"#BDB76B",darkmagenta:"#8B008B",darkolivegreen:"#556B2F",darkorange:"#FF8C00",darkorchid:"#9932CC",darkred:"#8B0000",darksalmon:"#E9967A",darkviolet:"#9400D3",lightblue:"#ADD8E6",lightcyan:"#E0FFFF",lightgreen:"#90EE90",lightgrey:"#D3D3D3",lightpink:"#FFB6C1",lightyellow:"#FFFFE0"};function convertColorToHex(e){if(e)return e.startsWith("#")?e:COLOR_NAME_TO_HEX[e.toLowerCase()]||e}function normalizeHexColor(e){return e.startsWith("#")?e:`#${e}`}function findChild(e,r){if(!e.children)return null;for(const t of e.children)if(t.type==="element"&&t.name===r)return t;return null}function findDeepChild(e,r){if(!e.children)return null;for(const t of e.children)if(t.type==="element"){if(t.name===r)return t;const n=findDeepChild(t,r);if(n)return n}return null}function findDeepChildren(e,r){const t=[];if(!e.children)return t;for(const n of e.children)n.type==="element"&&(n.name===r&&t.push(n),t.push(...findDeepChildren(n,r)));return t}function parseTwipAttr(e,r){const t=e[r];if(!t)return;const n=parseInt(t,10);if(!isNaN(n))return t}function createStringValidator(e){return r=>e.includes(r)}exports.CHECKBOX_SYMBOLS=CHECKBOX_SYMBOLS,exports.COLOR_NAME_TO_HEX=COLOR_NAME_TO_HEX,exports.DEFAULT_CODE_FONT=DEFAULT_CODE_FONT,exports.DOCX_DPI=96,exports.DOCX_STYLE_NAMES=DOCX_STYLE_NAMES,exports.EMUS_PER_INCH=914400,exports.HALF_POINTS_PER_PIXEL=1.5,exports.PAGE_DIMENSIONS=PAGE_DIMENSIONS,exports.PIXELS_PER_HALF_POINT=PIXELS_PER_HALF_POINT,exports.TEXT_ALIGN_MAP=TEXT_ALIGN_MAP,exports.TWIPS_PER_INCH=1440,exports.convertColorToHex=convertColorToHex,exports.convertCssLengthToPixels=convertCssLengthToPixels,exports.convertEmuStringToPixels=convertEmuStringToPixels,exports.convertEmuToPixels=convertEmuToPixels,exports.convertMeasureToInches=convertMeasureToInches,exports.convertMeasureToPixels=convertMeasureToPixels,exports.convertPixelsToEmu=convertPixelsToEmu,exports.convertPixelsToTwip=convertPixelsToTwip,exports.convertTwipToCssString=convertTwipToCssString,exports.convertTwipToPixels=convertTwipToPixels,exports.createStringValidator=createStringValidator,exports.findChild=findChild,exports.findDeepChild=findDeepChild,exports.findDeepChildren=findDeepChildren,exports.normalizeHexColor=normalizeHexColor,exports.parseTwipAttr=parseTwipAttr;

package/dist/index.d.cts

@@ -4,11 +4,6 @@ import { Root, Element } from 'E:\\tiptap-extension\\node_modules\\.pnpm\\@types
  * Unit conversion utilities for DOCX processing
  * Handles conversions between TWIPs, EMUs, pixels, and other units
  */
-/**
- * DOCX DPI (dots per inch) for pixel conversions
- * Word uses 96 DPI internally
- */
-declare const DOCX_DPI = 96;
 /**
  * Convert TWIPs to CSS pixels (returns number)
  * @param twip - Value in TWIPs (1 inch = 1440 TWIPs)
@@ -75,6 +70,7 @@ declare function convertEmuStringToPixels(emuStr: string): number | undefined;
  * convertCssLengthToPixels("20px") // returns 20
  * convertCssLengthToPixels("1.5em") // returns 24
  * convertCssLengthToPixels("100%") // returns 16
+ * convertCssLengthToPixels("20") // returns 20 (unitless treated as px)
  */
 declare function convertCssLengthToPixels(value: string): number;
 /**
@@ -188,5 +184,97 @@ declare function parseTwipAttr(attributes: Record<string, any> | {
     [key: string]: string | undefined;
 }, name: string): string | undefined;
 
-export { COLOR_NAME_TO_HEX, DOCX_DPI, convertColorToHex, convertCssLengthToPixels, convertEmuStringToPixels, convertEmuToPixels, convertMeasureToInches, convertMeasureToPixels, convertPixelsToEmu, convertPixelsToTwip, convertTwipToCssString, convertTwipToPixels, findChild, findDeepChild, findDeepChildren, normalizeHexColor, parseTwipAttr };
+/**
+ * Shared constants for DOCX processing
+ * Used across @docen/export-docx and @docen/import-docx packages
+ */
+/**
+ * DOCX DPI (dots per inch) for pixel conversions
+ * Word uses 96 DPI internally
+ */
+declare const DOCX_DPI = 96;
+/**
+ * TWIP (Twentieth of a Point) conversion constants
+ * 1 inch = 1440 TWIPs
+ */
+declare const TWIPS_PER_INCH = 1440;
+/**
+ * EMU (English Metric Unit) conversion constants
+ * 1 inch = 914400 EMUs
+ */
+declare const EMUS_PER_INCH = 914400;
+/**
+ * Font size conversion factors
+ * DOCX uses half-points, TipTap uses pixels
+ * 1px ≈ 0.75pt, 1pt = 2 half-points
+ * So: px * 0.75 * 2 = px * 1.5
+ */
+declare const HALF_POINTS_PER_PIXEL = 1.5;
+declare const PIXELS_PER_HALF_POINT: number;
+/**
+ * Default code font family
+ */
+declare const DEFAULT_CODE_FONT = "Consolas";
+/**
+ * Checkbox symbols for task lists
+ */
+declare const CHECKBOX_SYMBOLS: {
+    readonly checked: "☑";
+    readonly unchecked: "☐";
+};
+/**
+ * DOCX style names
+ */
+declare const DOCX_STYLE_NAMES: {
+    readonly CODE_BLOCK: "CodeBlock";
+    readonly CODE_PREFIX: "Code";
+};
+/**
+ * Text alignment mappings
+ */
+declare const TEXT_ALIGN_MAP: {
+    /** TipTap to DOCX alignment mapping */
+    readonly tiptapToDocx: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly justify: "both";
+    };
+    /** DOCX to TipTap alignment mapping */
+    readonly docxToTipTap: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly both: "justify";
+    };
+};
+/**
+ * Common page dimensions in TWIPs
+ */
+declare const PAGE_DIMENSIONS: {
+    /** A4 width in TWIPs (8.27 inches = 11906 TWIPs) */
+    readonly A4_WIDTH_TWIP: 11906;
+    /** Default 1 inch margin in TWIPs */
+    readonly DEFAULT_MARGIN_TWIP: 1440;
+};
+
+/**
+ * Type guard utilities for DOCX processing
+ */
+/**
+ * Type guard factory function
+ * Creates a type guard function that checks if a value is one of the valid values
+ *
+ * @param validValues - Readonly array of valid string values
+ * @returns Type guard function
+ *
+ * @example
+ * const isValidAlign = createStringValidator(["left", "right", "center"] as const);
+ * if (isValidAlign(value)) {
+ *   // value is typed as "left" | "right" | "center"
+ * }
+ */
+declare function createStringValidator<T extends string>(validValues: readonly T[]): (value: string) => value is T;
+
+export { CHECKBOX_SYMBOLS, COLOR_NAME_TO_HEX, DEFAULT_CODE_FONT, DOCX_DPI, DOCX_STYLE_NAMES, EMUS_PER_INCH, HALF_POINTS_PER_PIXEL, PAGE_DIMENSIONS, PIXELS_PER_HALF_POINT, TEXT_ALIGN_MAP, TWIPS_PER_INCH, convertColorToHex, convertCssLengthToPixels, convertEmuStringToPixels, convertEmuToPixels, convertMeasureToInches, convertMeasureToPixels, convertPixelsToEmu, convertPixelsToTwip, convertTwipToCssString, convertTwipToPixels, createStringValidator, findChild, findDeepChild, findDeepChildren, normalizeHexColor, parseTwipAttr };
 export type { PositiveUniversalMeasure };

package/dist/index.d.mts

@@ -4,11 +4,6 @@ import { Root, Element } from 'E:\\tiptap-extension\\node_modules\\.pnpm\\@types
  * Unit conversion utilities for DOCX processing
  * Handles conversions between TWIPs, EMUs, pixels, and other units
  */
-/**
- * DOCX DPI (dots per inch) for pixel conversions
- * Word uses 96 DPI internally
- */
-declare const DOCX_DPI = 96;
 /**
  * Convert TWIPs to CSS pixels (returns number)
  * @param twip - Value in TWIPs (1 inch = 1440 TWIPs)
@@ -75,6 +70,7 @@ declare function convertEmuStringToPixels(emuStr: string): number | undefined;
  * convertCssLengthToPixels("20px") // returns 20
  * convertCssLengthToPixels("1.5em") // returns 24
  * convertCssLengthToPixels("100%") // returns 16
+ * convertCssLengthToPixels("20") // returns 20 (unitless treated as px)
  */
 declare function convertCssLengthToPixels(value: string): number;
 /**
@@ -188,5 +184,97 @@ declare function parseTwipAttr(attributes: Record<string, any> | {
     [key: string]: string | undefined;
 }, name: string): string | undefined;
 
-export { COLOR_NAME_TO_HEX, DOCX_DPI, convertColorToHex, convertCssLengthToPixels, convertEmuStringToPixels, convertEmuToPixels, convertMeasureToInches, convertMeasureToPixels, convertPixelsToEmu, convertPixelsToTwip, convertTwipToCssString, convertTwipToPixels, findChild, findDeepChild, findDeepChildren, normalizeHexColor, parseTwipAttr };
+/**
+ * Shared constants for DOCX processing
+ * Used across @docen/export-docx and @docen/import-docx packages
+ */
+/**
+ * DOCX DPI (dots per inch) for pixel conversions
+ * Word uses 96 DPI internally
+ */
+declare const DOCX_DPI = 96;
+/**
+ * TWIP (Twentieth of a Point) conversion constants
+ * 1 inch = 1440 TWIPs
+ */
+declare const TWIPS_PER_INCH = 1440;
+/**
+ * EMU (English Metric Unit) conversion constants
+ * 1 inch = 914400 EMUs
+ */
+declare const EMUS_PER_INCH = 914400;
+/**
+ * Font size conversion factors
+ * DOCX uses half-points, TipTap uses pixels
+ * 1px ≈ 0.75pt, 1pt = 2 half-points
+ * So: px * 0.75 * 2 = px * 1.5
+ */
+declare const HALF_POINTS_PER_PIXEL = 1.5;
+declare const PIXELS_PER_HALF_POINT: number;
+/**
+ * Default code font family
+ */
+declare const DEFAULT_CODE_FONT = "Consolas";
+/**
+ * Checkbox symbols for task lists
+ */
+declare const CHECKBOX_SYMBOLS: {
+    readonly checked: "☑";
+    readonly unchecked: "☐";
+};
+/**
+ * DOCX style names
+ */
+declare const DOCX_STYLE_NAMES: {
+    readonly CODE_BLOCK: "CodeBlock";
+    readonly CODE_PREFIX: "Code";
+};
+/**
+ * Text alignment mappings
+ */
+declare const TEXT_ALIGN_MAP: {
+    /** TipTap to DOCX alignment mapping */
+    readonly tiptapToDocx: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly justify: "both";
+    };
+    /** DOCX to TipTap alignment mapping */
+    readonly docxToTipTap: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly both: "justify";
+    };
+};
+/**
+ * Common page dimensions in TWIPs
+ */
+declare const PAGE_DIMENSIONS: {
+    /** A4 width in TWIPs (8.27 inches = 11906 TWIPs) */
+    readonly A4_WIDTH_TWIP: 11906;
+    /** Default 1 inch margin in TWIPs */
+    readonly DEFAULT_MARGIN_TWIP: 1440;
+};
+
+/**
+ * Type guard utilities for DOCX processing
+ */
+/**
+ * Type guard factory function
+ * Creates a type guard function that checks if a value is one of the valid values
+ *
+ * @param validValues - Readonly array of valid string values
+ * @returns Type guard function
+ *
+ * @example
+ * const isValidAlign = createStringValidator(["left", "right", "center"] as const);
+ * if (isValidAlign(value)) {
+ *   // value is typed as "left" | "right" | "center"
+ * }
+ */
+declare function createStringValidator<T extends string>(validValues: readonly T[]): (value: string) => value is T;
+
+export { CHECKBOX_SYMBOLS, COLOR_NAME_TO_HEX, DEFAULT_CODE_FONT, DOCX_DPI, DOCX_STYLE_NAMES, EMUS_PER_INCH, HALF_POINTS_PER_PIXEL, PAGE_DIMENSIONS, PIXELS_PER_HALF_POINT, TEXT_ALIGN_MAP, TWIPS_PER_INCH, convertColorToHex, convertCssLengthToPixels, convertEmuStringToPixels, convertEmuToPixels, convertMeasureToInches, convertMeasureToPixels, convertPixelsToEmu, convertPixelsToTwip, convertTwipToCssString, convertTwipToPixels, createStringValidator, findChild, findDeepChild, findDeepChildren, normalizeHexColor, parseTwipAttr };
 export type { PositiveUniversalMeasure };

package/dist/index.d.ts

@@ -4,11 +4,6 @@ import { Root, Element } from 'E:\\tiptap-extension\\node_modules\\.pnpm\\@types
  * Unit conversion utilities for DOCX processing
  * Handles conversions between TWIPs, EMUs, pixels, and other units
  */
-/**
- * DOCX DPI (dots per inch) for pixel conversions
- * Word uses 96 DPI internally
- */
-declare const DOCX_DPI = 96;
 /**
  * Convert TWIPs to CSS pixels (returns number)
  * @param twip - Value in TWIPs (1 inch = 1440 TWIPs)
@@ -75,6 +70,7 @@ declare function convertEmuStringToPixels(emuStr: string): number | undefined;
  * convertCssLengthToPixels("20px") // returns 20
  * convertCssLengthToPixels("1.5em") // returns 24
  * convertCssLengthToPixels("100%") // returns 16
+ * convertCssLengthToPixels("20") // returns 20 (unitless treated as px)
  */
 declare function convertCssLengthToPixels(value: string): number;
 /**
@@ -188,5 +184,97 @@ declare function parseTwipAttr(attributes: Record<string, any> | {
     [key: string]: string | undefined;
 }, name: string): string | undefined;
 
-export { COLOR_NAME_TO_HEX, DOCX_DPI, convertColorToHex, convertCssLengthToPixels, convertEmuStringToPixels, convertEmuToPixels, convertMeasureToInches, convertMeasureToPixels, convertPixelsToEmu, convertPixelsToTwip, convertTwipToCssString, convertTwipToPixels, findChild, findDeepChild, findDeepChildren, normalizeHexColor, parseTwipAttr };
+/**
+ * Shared constants for DOCX processing
+ * Used across @docen/export-docx and @docen/import-docx packages
+ */
+/**
+ * DOCX DPI (dots per inch) for pixel conversions
+ * Word uses 96 DPI internally
+ */
+declare const DOCX_DPI = 96;
+/**
+ * TWIP (Twentieth of a Point) conversion constants
+ * 1 inch = 1440 TWIPs
+ */
+declare const TWIPS_PER_INCH = 1440;
+/**
+ * EMU (English Metric Unit) conversion constants
+ * 1 inch = 914400 EMUs
+ */
+declare const EMUS_PER_INCH = 914400;
+/**
+ * Font size conversion factors
+ * DOCX uses half-points, TipTap uses pixels
+ * 1px ≈ 0.75pt, 1pt = 2 half-points
+ * So: px * 0.75 * 2 = px * 1.5
+ */
+declare const HALF_POINTS_PER_PIXEL = 1.5;
+declare const PIXELS_PER_HALF_POINT: number;
+/**
+ * Default code font family
+ */
+declare const DEFAULT_CODE_FONT = "Consolas";
+/**
+ * Checkbox symbols for task lists
+ */
+declare const CHECKBOX_SYMBOLS: {
+    readonly checked: "☑";
+    readonly unchecked: "☐";
+};
+/**
+ * DOCX style names
+ */
+declare const DOCX_STYLE_NAMES: {
+    readonly CODE_BLOCK: "CodeBlock";
+    readonly CODE_PREFIX: "Code";
+};
+/**
+ * Text alignment mappings
+ */
+declare const TEXT_ALIGN_MAP: {
+    /** TipTap to DOCX alignment mapping */
+    readonly tiptapToDocx: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly justify: "both";
+    };
+    /** DOCX to TipTap alignment mapping */
+    readonly docxToTipTap: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly both: "justify";
+    };
+};
+/**
+ * Common page dimensions in TWIPs
+ */
+declare const PAGE_DIMENSIONS: {
+    /** A4 width in TWIPs (8.27 inches = 11906 TWIPs) */
+    readonly A4_WIDTH_TWIP: 11906;
+    /** Default 1 inch margin in TWIPs */
+    readonly DEFAULT_MARGIN_TWIP: 1440;
+};
+
+/**
+ * Type guard utilities for DOCX processing
+ */
+/**
+ * Type guard factory function
+ * Creates a type guard function that checks if a value is one of the valid values
+ *
+ * @param validValues - Readonly array of valid string values
+ * @returns Type guard function
+ *
+ * @example
+ * const isValidAlign = createStringValidator(["left", "right", "center"] as const);
+ * if (isValidAlign(value)) {
+ *   // value is typed as "left" | "right" | "center"
+ * }
+ */
+declare function createStringValidator<T extends string>(validValues: readonly T[]): (value: string) => value is T;
+
+export { CHECKBOX_SYMBOLS, COLOR_NAME_TO_HEX, DEFAULT_CODE_FONT, DOCX_DPI, DOCX_STYLE_NAMES, EMUS_PER_INCH, HALF_POINTS_PER_PIXEL, PAGE_DIMENSIONS, PIXELS_PER_HALF_POINT, TEXT_ALIGN_MAP, TWIPS_PER_INCH, convertColorToHex, convertCssLengthToPixels, convertEmuStringToPixels, convertEmuToPixels, convertMeasureToInches, convertMeasureToPixels, convertPixelsToEmu, convertPixelsToTwip, convertTwipToCssString, convertTwipToPixels, createStringValidator, findChild, findDeepChild, findDeepChildren, normalizeHexColor, parseTwipAttr };
 export type { PositiveUniversalMeasure };

package/dist/index.mjs

@@ -1 +1 @@
-const f=96;function u(r){return Math.round(r*96/1440)}function d(r){return`${u(r)}px`}function p(r){return Math.round(r*(1440/96))}function c(r){return Math.round(r/(914400/96))}function h(r){return Math.round(r*(914400/96))}function m(r){const e=parseInt(r,10);if(!isNaN(e))return c(e)}const g=/^([\d.]+)(px|pt|em|rem|%|)?$/,C={px:1,pt:1.333,em:16,rem:16,"%":.16};function k(r){if(!r)return 0;r=r.trim();const e=r.match(g);if(!e)return 0;const n=parseFloat(e[1]);if(isNaN(n))return 0;const t=e[2]||"px",o=C[t]??1;return Math.round(n*o)}const v=/^([\d.]+)(in|mm|cm|pt|pc|pi)$/,y={in:1,mm:1/25.4,cm:1/2.54,pt:1/72,pc:1/6,pi:1/6};function a(r){if(typeof r=="number")return r;const e=r.match(v);if(e){const t=parseFloat(e[1]),o=e[2],i=y[o];return i!==void 0?t*i:t}const n=parseFloat(r);return isNaN(n)?6.5:n}function E(r){if(typeof r=="number")return r;const e=a(r);return Math.round(e*96)}const l={black:"#000000",white:"#FFFFFF",red:"#FF0000",green:"#008000",blue:"#0000FF",yellow:"#FFFF00",orange:"#FFA500",purple:"#800080",pink:"#FFC0CB",brown:"#A52A2A",gray:"#808080",grey:"#808080",cyan:"#00FFFF",magenta:"#FF00FF",lime:"#00FF00",navy:"#000080",teal:"#008080",maroon:"#800000",olive:"#808000",silver:"#C0C0C0",gold:"#FFD700",indigo:"#4B0082",violet:"#EE82EE",aqua:"#00FFFF",fuchsia:"#FF00FF",darkblue:"#00008B",darkcyan:"#008B8B",darkgrey:"#A9A9A9",darkgreen:"#006400",darkkhaki:"#BDB76B",darkmagenta:"#8B008B",darkolivegreen:"#556B2F",darkorange:"#FF8C00",darkorchid:"#9932CC",darkred:"#8B0000",darksalmon:"#E9967A",darkviolet:"#9400D3",lightblue:"#ADD8E6",lightcyan:"#E0FFFF",lightgreen:"#90EE90",lightgrey:"#D3D3D3",lightpink:"#FFB6C1",lightyellow:"#FFFFE0"};function T(r){if(r)return r.startsWith("#")?r:l[r.toLowerCase()]||r}function x(r){return r.startsWith("#")?r:`#${r}`}function B(r,e){if(!r.children)return null;for(const n of r.children)if(n.type==="element"&&n.name===e)return n;return null}function s(r,e){if(!r.children)return null;for(const n of r.children)if(n.type==="element"){if(n.name===e)return n;const t=s(n,e);if(t)return t}return null}function F(r,e){const n=[];if(!r.children)return n;for(const t of r.children)t.type==="element"&&(t.name===e&&n.push(t),n.push(...F(t,e)));return n}function D(r,e){const n=r[e];if(!n)return;const t=parseInt(n,10);if(!isNaN(t))return n}export{l as COLOR_NAME_TO_HEX,f as DOCX_DPI,T as convertColorToHex,k as convertCssLengthToPixels,m as convertEmuStringToPixels,c as convertEmuToPixels,a as convertMeasureToInches,E as convertMeasureToPixels,h as convertPixelsToEmu,p as convertPixelsToTwip,d as convertTwipToCssString,u as convertTwipToPixels,B as findChild,s as findDeepChild,F as findDeepChildren,x as normalizeHexColor,D as parseTwipAttr};
+const d=96,h=1440,p=914400,E=1.5,_=.6666666666666666,C="Consolas",T={checked:"\u2611",unchecked:"\u2610"},m={CODE_BLOCK:"CodeBlock",CODE_PREFIX:"Code"},P={tiptapToDocx:{left:"left",right:"right",center:"center",justify:"both"},docxToTipTap:{left:"left",right:"right",center:"center",both:"justify"}},g={A4_WIDTH_TWIP:11906,DEFAULT_MARGIN_TWIP:1440},o=96;function u(r){return Math.round(r*o/1440)}function I(r){return`${u(r)}px`}function D(r){return Math.round(r*(1440/o))}function a(r){return Math.round(r/(914400/o))}function N(r){return Math.round(r*(914400/o))}function A(r){const n=parseInt(r,10);if(!isNaN(n))return a(n)}const k=/^(-?[\d.]+)(px|pt|em|rem|%|)?$/,v={px:1,pt:1.333,em:16,rem:16,"%":.16};function x(r){if(!r)return 0;r=r.trim();const n=r.match(k);if(!n)return 0;const e=parseFloat(n[1]);if(isNaN(e))return 0;const t=n[2]||"px",i=v[t]??1;return Math.round(e*i)}const y=/^([\d.]+)(in|mm|cm|pt|pc|pi)$/,B={in:1,mm:1/25.4,cm:1/2.54,pt:1/72,pc:1/6,pi:1/6};function l(r){if(typeof r=="number")return r;const n=r.match(y);if(n){const t=parseFloat(n[1]),i=n[2],c=B[i];return c!==void 0?t*c:t}const e=parseFloat(r);return isNaN(e)?6.5:e}function M(r){if(typeof r=="number")return r;const n=l(r);return Math.round(n*96)}const s={black:"#000000",white:"#FFFFFF",red:"#FF0000",green:"#008000",blue:"#0000FF",yellow:"#FFFF00",orange:"#FFA500",purple:"#800080",pink:"#FFC0CB",brown:"#A52A2A",gray:"#808080",grey:"#808080",cyan:"#00FFFF",magenta:"#FF00FF",lime:"#00FF00",navy:"#000080",teal:"#008080",maroon:"#800000",olive:"#808000",silver:"#C0C0C0",gold:"#FFD700",indigo:"#4B0082",violet:"#EE82EE",aqua:"#00FFFF",fuchsia:"#FF00FF",darkblue:"#00008B",darkcyan:"#008B8B",darkgrey:"#A9A9A9",darkgreen:"#006400",darkkhaki:"#BDB76B",darkmagenta:"#8B008B",darkolivegreen:"#556B2F",darkorange:"#FF8C00",darkorchid:"#9932CC",darkred:"#8B0000",darksalmon:"#E9967A",darkviolet:"#9400D3",lightblue:"#ADD8E6",lightcyan:"#E0FFFF",lightgreen:"#90EE90",lightgrey:"#D3D3D3",lightpink:"#FFB6C1",lightyellow:"#FFFFE0"};function O(r){if(r)return r.startsWith("#")?r:s[r.toLowerCase()]||r}function S(r){return r.startsWith("#")?r:`#${r}`}function H(r,n){if(!r.children)return null;for(const e of r.children)if(e.type==="element"&&e.name===n)return e;return null}function F(r,n){if(!r.children)return null;for(const e of r.children)if(e.type==="element"){if(e.name===n)return e;const t=F(e,n);if(t)return t}return null}function f(r,n){const e=[];if(!r.children)return e;for(const t of r.children)t.type==="element"&&(t.name===n&&e.push(t),e.push(...f(t,n)));return e}function L(r,n){const e=r[n];if(!e)return;const t=parseInt(e,10);if(!isNaN(t))return e}function R(r){return n=>r.includes(n)}export{T as CHECKBOX_SYMBOLS,s as COLOR_NAME_TO_HEX,C as DEFAULT_CODE_FONT,d as DOCX_DPI,m as DOCX_STYLE_NAMES,p as EMUS_PER_INCH,E as HALF_POINTS_PER_PIXEL,g as PAGE_DIMENSIONS,_ as PIXELS_PER_HALF_POINT,P as TEXT_ALIGN_MAP,h as TWIPS_PER_INCH,O as convertColorToHex,x as convertCssLengthToPixels,A as convertEmuStringToPixels,a as convertEmuToPixels,l as convertMeasureToInches,M as convertMeasureToPixels,N as convertPixelsToEmu,D as convertPixelsToTwip,I as convertTwipToCssString,u as convertTwipToPixels,R as createStringValidator,H as findChild,F as findDeepChild,f as findDeepChildren,S as normalizeHexColor,L as parseTwipAttr};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docen/utils",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Shared utility functions for DOCX processing, including unit conversions, color transformations, and XML helpers",
   "keywords": [
     "color",