@docen/utils 0.0.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Demo Macro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +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;

package/dist/index.d.cts

@@ -0,0 +1,192 @@
+import { Root, Element } from 'E:\\tiptap-extension\\node_modules\\.pnpm\\@types+xast@2.0.4\\node_modules\\@types\\xast\\index.d.ts';
+
+/**
+ * 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)
+ * @returns Number value in pixels
+ *
+ * @example
+ * convertTwipToPixels(1440) // returns 96
+ */
+declare function convertTwipToPixels(twip: number): number;
+/**
+ * Convert TWIPs to CSS string (returns "px" string)
+ * @param twip - Value in TWIPs
+ * @returns CSS value string in pixels (e.g., "20px")
+ *
+ * @example
+ * convertTwipToCssString(1440) // returns "96px"
+ */
+declare function convertTwipToCssString(twip: number): string;
+/**
+ * Convert pixels to TWIPs
+ * @param px - Value in pixels
+ * @returns Value in TWIPs
+ *
+ * @example
+ * convertPixelsToTwip(96) // returns 1440
+ */
+declare function convertPixelsToTwip(px: number): number;
+/**
+ * Convert EMUs to pixels
+ * EMU = English Metric Unit (1 inch = 914400 EMUs)
+ * @param emu - Value in EMUs
+ * @returns Value in pixels
+ *
+ * @example
+ * convertEmuToPixels(914400) // returns 96
+ */
+declare function convertEmuToPixels(emu: number): number;
+/**
+ * Convert pixels to EMUs
+ * @param px - Value in pixels
+ * @returns Value in EMUs
+ *
+ * @example
+ * convertPixelsToEmu(96) // returns 914400
+ */
+declare function convertPixelsToEmu(px: number): number;
+/**
+ * Convert EMU string to pixels
+ * @param emuStr - EMU value as string
+ * @returns Pixel value or undefined if invalid
+ *
+ * @example
+ * convertEmuStringToPixels("914400") // returns 96
+ * convertEmuStringToPixels("invalid") // returns undefined
+ */
+declare function convertEmuStringToPixels(emuStr: string): number | undefined;
+/**
+ * Parse CSS length value to pixels
+ * Supports: px, pt, em, rem, %, and unitless values
+ * @param value - CSS length value (e.g., "20px", "1.5em", "100%")
+ * @returns Value in pixels
+ *
+ * @example
+ * convertCssLengthToPixels("20px") // returns 20
+ * convertCssLengthToPixels("1.5em") // returns 24
+ * convertCssLengthToPixels("100%") // returns 16
+ */
+declare function convertCssLengthToPixels(value: string): number;
+/**
+ * Type for universal measure values in DOCX
+ * Can be a number (already in inches) or a string with unit suffix
+ */
+type PositiveUniversalMeasure = `${number}${"in" | "mm" | "cm" | "pt" | "pc" | "pi"}`;
+/**
+ * Convert universal measure to inches
+ * Compatible with docx.js UniversalMeasure type
+ * @param value - Value in various units (number or string)
+ * @returns Value in inches
+ *
+ * @example
+ * convertMeasureToInches(6.5) // returns 6.5
+ * convertMeasureToInches("1in") // returns 1
+ * convertMeasureToInches("25.4mm") // returns ~1
+ */
+declare function convertMeasureToInches(value: number | PositiveUniversalMeasure): number;
+/**
+ * Convert universal measure to pixels
+ * Compatible with docx.js UniversalMeasure type
+ * @param value - Value in various units (number or string)
+ * @returns Value in pixels
+ *
+ * @example
+ * convertMeasureToPixels("1in") // returns 96
+ * convertMeasureToPixels(6.5) // returns 624
+ */
+declare function convertMeasureToPixels(value: number | PositiveUniversalMeasure): number;
+
+/**
+ * Color conversion utilities for DOCX processing
+ * Handles conversion between color names and hex values
+ */
+/**
+ * Color name to hex value mapping
+ * Includes common HTML/CSS color names
+ */
+declare const COLOR_NAME_TO_HEX: Record<string, string>;
+/**
+ * Convert color name or hex to normalized hex value
+ * @param color - Color as name (e.g., "red") or hex (e.g., "#FF0000" or "FF0000")
+ * @returns Normalized hex color string (e.g., "#FF0000") or undefined if invalid
+ *
+ * @example
+ * convertColorToHex("red") // returns "#FF0000"
+ * convertColorToHex("#FF0000") // returns "#FF0000"
+ * convertColorToHex("FF0000") // returns "#FF0000"
+ * convertColorToHex("invalid") // returns undefined
+ */
+declare function convertColorToHex(color?: string): string | undefined;
+/**
+ * Normalize hex color to ensure it has a # prefix
+ * @param color - Color value with or without # prefix
+ * @returns Hex color with # prefix
+ *
+ * @example
+ * normalizeHexColor("FF0000") // returns "#FF0000"
+ * normalizeHexColor("#FF0000") // returns "#FF0000"
+ */
+declare function normalizeHexColor(color: string): string;
+
+/**
+ * XML utility functions for DOCX processing
+ * Provides helper functions for traversing and parsing XML trees (xast)
+ */
+
+/**
+ * Find direct child element with specified name
+ * @param node - Parent XML element or root node
+ * @param name - Child element name to find (can include namespace prefix, e.g., "w:p")
+ * @returns Child element if found, null otherwise
+ *
+ * @example
+ * const paragraph = findChild(document, "w:p");
+ */
+declare function findChild(node: Root | Element, name: string): Element | null;
+/**
+ * Find deep descendant element with specified name (recursive)
+ * Searches through all descendants, not just direct children
+ * @param node - Root XML element
+ * @param name - Descendant element name to find
+ * @returns Descendant element if found, null otherwise
+ *
+ * @example
+ * const textElement = findDeepChild(run, "w:t");
+ */
+declare function findDeepChild(node: Root | Element, name: string): Element | null;
+/**
+ * Find all deep descendant elements with specified name (recursive)
+ * @param node - Root XML element
+ * @param name - Descendant element name to find
+ * @returns Array of matching descendant elements
+ *
+ * @example
+ * const allTextRuns = findDeepChildren(paragraph, "w:r");
+ */
+declare function findDeepChildren(node: Root | Element, name: string): Element[];
+/**
+ * Parse TWIP attribute value from element attributes
+ * TWIP = Twentieth of a Point (1 inch = 1440 TWIPs)
+ * @param attributes - Element attributes object
+ * @param name - Attribute name to parse
+ * @returns TWIP value as string, or undefined if not found
+ *
+ * @example
+ * const leftIndent = parseTwipAttr(pPr.attributes, "w:left");
+ */
+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 };
+export type { PositiveUniversalMeasure };

package/dist/index.d.mts

@@ -0,0 +1,192 @@
+import { Root, Element } from 'E:\\tiptap-extension\\node_modules\\.pnpm\\@types+xast@2.0.4\\node_modules\\@types\\xast\\index.d.ts';
+
+/**
+ * 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)
+ * @returns Number value in pixels
+ *
+ * @example
+ * convertTwipToPixels(1440) // returns 96
+ */
+declare function convertTwipToPixels(twip: number): number;
+/**
+ * Convert TWIPs to CSS string (returns "px" string)
+ * @param twip - Value in TWIPs
+ * @returns CSS value string in pixels (e.g., "20px")
+ *
+ * @example
+ * convertTwipToCssString(1440) // returns "96px"
+ */
+declare function convertTwipToCssString(twip: number): string;
+/**
+ * Convert pixels to TWIPs
+ * @param px - Value in pixels
+ * @returns Value in TWIPs
+ *
+ * @example
+ * convertPixelsToTwip(96) // returns 1440
+ */
+declare function convertPixelsToTwip(px: number): number;
+/**
+ * Convert EMUs to pixels
+ * EMU = English Metric Unit (1 inch = 914400 EMUs)
+ * @param emu - Value in EMUs
+ * @returns Value in pixels
+ *
+ * @example
+ * convertEmuToPixels(914400) // returns 96
+ */
+declare function convertEmuToPixels(emu: number): number;
+/**
+ * Convert pixels to EMUs
+ * @param px - Value in pixels
+ * @returns Value in EMUs
+ *
+ * @example
+ * convertPixelsToEmu(96) // returns 914400
+ */
+declare function convertPixelsToEmu(px: number): number;
+/**
+ * Convert EMU string to pixels
+ * @param emuStr - EMU value as string
+ * @returns Pixel value or undefined if invalid
+ *
+ * @example
+ * convertEmuStringToPixels("914400") // returns 96
+ * convertEmuStringToPixels("invalid") // returns undefined
+ */
+declare function convertEmuStringToPixels(emuStr: string): number | undefined;
+/**
+ * Parse CSS length value to pixels
+ * Supports: px, pt, em, rem, %, and unitless values
+ * @param value - CSS length value (e.g., "20px", "1.5em", "100%")
+ * @returns Value in pixels
+ *
+ * @example
+ * convertCssLengthToPixels("20px") // returns 20
+ * convertCssLengthToPixels("1.5em") // returns 24
+ * convertCssLengthToPixels("100%") // returns 16
+ */
+declare function convertCssLengthToPixels(value: string): number;
+/**
+ * Type for universal measure values in DOCX
+ * Can be a number (already in inches) or a string with unit suffix
+ */
+type PositiveUniversalMeasure = `${number}${"in" | "mm" | "cm" | "pt" | "pc" | "pi"}`;
+/**
+ * Convert universal measure to inches
+ * Compatible with docx.js UniversalMeasure type
+ * @param value - Value in various units (number or string)
+ * @returns Value in inches
+ *
+ * @example
+ * convertMeasureToInches(6.5) // returns 6.5
+ * convertMeasureToInches("1in") // returns 1
+ * convertMeasureToInches("25.4mm") // returns ~1
+ */
+declare function convertMeasureToInches(value: number | PositiveUniversalMeasure): number;
+/**
+ * Convert universal measure to pixels
+ * Compatible with docx.js UniversalMeasure type
+ * @param value - Value in various units (number or string)
+ * @returns Value in pixels
+ *
+ * @example
+ * convertMeasureToPixels("1in") // returns 96
+ * convertMeasureToPixels(6.5) // returns 624
+ */
+declare function convertMeasureToPixels(value: number | PositiveUniversalMeasure): number;
+
+/**
+ * Color conversion utilities for DOCX processing
+ * Handles conversion between color names and hex values
+ */
+/**
+ * Color name to hex value mapping
+ * Includes common HTML/CSS color names
+ */
+declare const COLOR_NAME_TO_HEX: Record<string, string>;
+/**
+ * Convert color name or hex to normalized hex value
+ * @param color - Color as name (e.g., "red") or hex (e.g., "#FF0000" or "FF0000")
+ * @returns Normalized hex color string (e.g., "#FF0000") or undefined if invalid
+ *
+ * @example
+ * convertColorToHex("red") // returns "#FF0000"
+ * convertColorToHex("#FF0000") // returns "#FF0000"
+ * convertColorToHex("FF0000") // returns "#FF0000"
+ * convertColorToHex("invalid") // returns undefined
+ */
+declare function convertColorToHex(color?: string): string | undefined;
+/**
+ * Normalize hex color to ensure it has a # prefix
+ * @param color - Color value with or without # prefix
+ * @returns Hex color with # prefix
+ *
+ * @example
+ * normalizeHexColor("FF0000") // returns "#FF0000"
+ * normalizeHexColor("#FF0000") // returns "#FF0000"
+ */
+declare function normalizeHexColor(color: string): string;
+
+/**
+ * XML utility functions for DOCX processing
+ * Provides helper functions for traversing and parsing XML trees (xast)
+ */
+
+/**
+ * Find direct child element with specified name
+ * @param node - Parent XML element or root node
+ * @param name - Child element name to find (can include namespace prefix, e.g., "w:p")
+ * @returns Child element if found, null otherwise
+ *
+ * @example
+ * const paragraph = findChild(document, "w:p");
+ */
+declare function findChild(node: Root | Element, name: string): Element | null;
+/**
+ * Find deep descendant element with specified name (recursive)
+ * Searches through all descendants, not just direct children
+ * @param node - Root XML element
+ * @param name - Descendant element name to find
+ * @returns Descendant element if found, null otherwise
+ *
+ * @example
+ * const textElement = findDeepChild(run, "w:t");
+ */
+declare function findDeepChild(node: Root | Element, name: string): Element | null;
+/**
+ * Find all deep descendant elements with specified name (recursive)
+ * @param node - Root XML element
+ * @param name - Descendant element name to find
+ * @returns Array of matching descendant elements
+ *
+ * @example
+ * const allTextRuns = findDeepChildren(paragraph, "w:r");
+ */
+declare function findDeepChildren(node: Root | Element, name: string): Element[];
+/**
+ * Parse TWIP attribute value from element attributes
+ * TWIP = Twentieth of a Point (1 inch = 1440 TWIPs)
+ * @param attributes - Element attributes object
+ * @param name - Attribute name to parse
+ * @returns TWIP value as string, or undefined if not found
+ *
+ * @example
+ * const leftIndent = parseTwipAttr(pPr.attributes, "w:left");
+ */
+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 };
+export type { PositiveUniversalMeasure };

package/dist/index.d.ts

@@ -0,0 +1,192 @@
+import { Root, Element } from 'E:\\tiptap-extension\\node_modules\\.pnpm\\@types+xast@2.0.4\\node_modules\\@types\\xast\\index.d.ts';
+
+/**
+ * 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)
+ * @returns Number value in pixels
+ *
+ * @example
+ * convertTwipToPixels(1440) // returns 96
+ */
+declare function convertTwipToPixels(twip: number): number;
+/**
+ * Convert TWIPs to CSS string (returns "px" string)
+ * @param twip - Value in TWIPs
+ * @returns CSS value string in pixels (e.g., "20px")
+ *
+ * @example
+ * convertTwipToCssString(1440) // returns "96px"
+ */
+declare function convertTwipToCssString(twip: number): string;
+/**
+ * Convert pixels to TWIPs
+ * @param px - Value in pixels
+ * @returns Value in TWIPs
+ *
+ * @example
+ * convertPixelsToTwip(96) // returns 1440
+ */
+declare function convertPixelsToTwip(px: number): number;
+/**
+ * Convert EMUs to pixels
+ * EMU = English Metric Unit (1 inch = 914400 EMUs)
+ * @param emu - Value in EMUs
+ * @returns Value in pixels
+ *
+ * @example
+ * convertEmuToPixels(914400) // returns 96
+ */
+declare function convertEmuToPixels(emu: number): number;
+/**
+ * Convert pixels to EMUs
+ * @param px - Value in pixels
+ * @returns Value in EMUs
+ *
+ * @example
+ * convertPixelsToEmu(96) // returns 914400
+ */
+declare function convertPixelsToEmu(px: number): number;
+/**
+ * Convert EMU string to pixels
+ * @param emuStr - EMU value as string
+ * @returns Pixel value or undefined if invalid
+ *
+ * @example
+ * convertEmuStringToPixels("914400") // returns 96
+ * convertEmuStringToPixels("invalid") // returns undefined
+ */
+declare function convertEmuStringToPixels(emuStr: string): number | undefined;
+/**
+ * Parse CSS length value to pixels
+ * Supports: px, pt, em, rem, %, and unitless values
+ * @param value - CSS length value (e.g., "20px", "1.5em", "100%")
+ * @returns Value in pixels
+ *
+ * @example
+ * convertCssLengthToPixels("20px") // returns 20
+ * convertCssLengthToPixels("1.5em") // returns 24
+ * convertCssLengthToPixels("100%") // returns 16
+ */
+declare function convertCssLengthToPixels(value: string): number;
+/**
+ * Type for universal measure values in DOCX
+ * Can be a number (already in inches) or a string with unit suffix
+ */
+type PositiveUniversalMeasure = `${number}${"in" | "mm" | "cm" | "pt" | "pc" | "pi"}`;
+/**
+ * Convert universal measure to inches
+ * Compatible with docx.js UniversalMeasure type
+ * @param value - Value in various units (number or string)
+ * @returns Value in inches
+ *
+ * @example
+ * convertMeasureToInches(6.5) // returns 6.5
+ * convertMeasureToInches("1in") // returns 1
+ * convertMeasureToInches("25.4mm") // returns ~1
+ */
+declare function convertMeasureToInches(value: number | PositiveUniversalMeasure): number;
+/**
+ * Convert universal measure to pixels
+ * Compatible with docx.js UniversalMeasure type
+ * @param value - Value in various units (number or string)
+ * @returns Value in pixels
+ *
+ * @example
+ * convertMeasureToPixels("1in") // returns 96
+ * convertMeasureToPixels(6.5) // returns 624
+ */
+declare function convertMeasureToPixels(value: number | PositiveUniversalMeasure): number;
+
+/**
+ * Color conversion utilities for DOCX processing
+ * Handles conversion between color names and hex values
+ */
+/**
+ * Color name to hex value mapping
+ * Includes common HTML/CSS color names
+ */
+declare const COLOR_NAME_TO_HEX: Record<string, string>;
+/**
+ * Convert color name or hex to normalized hex value
+ * @param color - Color as name (e.g., "red") or hex (e.g., "#FF0000" or "FF0000")
+ * @returns Normalized hex color string (e.g., "#FF0000") or undefined if invalid
+ *
+ * @example
+ * convertColorToHex("red") // returns "#FF0000"
+ * convertColorToHex("#FF0000") // returns "#FF0000"
+ * convertColorToHex("FF0000") // returns "#FF0000"
+ * convertColorToHex("invalid") // returns undefined
+ */
+declare function convertColorToHex(color?: string): string | undefined;
+/**
+ * Normalize hex color to ensure it has a # prefix
+ * @param color - Color value with or without # prefix
+ * @returns Hex color with # prefix
+ *
+ * @example
+ * normalizeHexColor("FF0000") // returns "#FF0000"
+ * normalizeHexColor("#FF0000") // returns "#FF0000"
+ */
+declare function normalizeHexColor(color: string): string;
+
+/**
+ * XML utility functions for DOCX processing
+ * Provides helper functions for traversing and parsing XML trees (xast)
+ */
+
+/**
+ * Find direct child element with specified name
+ * @param node - Parent XML element or root node
+ * @param name - Child element name to find (can include namespace prefix, e.g., "w:p")
+ * @returns Child element if found, null otherwise
+ *
+ * @example
+ * const paragraph = findChild(document, "w:p");
+ */
+declare function findChild(node: Root | Element, name: string): Element | null;
+/**
+ * Find deep descendant element with specified name (recursive)
+ * Searches through all descendants, not just direct children
+ * @param node - Root XML element
+ * @param name - Descendant element name to find
+ * @returns Descendant element if found, null otherwise
+ *
+ * @example
+ * const textElement = findDeepChild(run, "w:t");
+ */
+declare function findDeepChild(node: Root | Element, name: string): Element | null;
+/**
+ * Find all deep descendant elements with specified name (recursive)
+ * @param node - Root XML element
+ * @param name - Descendant element name to find
+ * @returns Array of matching descendant elements
+ *
+ * @example
+ * const allTextRuns = findDeepChildren(paragraph, "w:r");
+ */
+declare function findDeepChildren(node: Root | Element, name: string): Element[];
+/**
+ * Parse TWIP attribute value from element attributes
+ * TWIP = Twentieth of a Point (1 inch = 1440 TWIPs)
+ * @param attributes - Element attributes object
+ * @param name - Attribute name to parse
+ * @returns TWIP value as string, or undefined if not found
+ *
+ * @example
+ * const leftIndent = parseTwipAttr(pPr.attributes, "w:left");
+ */
+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 };
+export type { PositiveUniversalMeasure };

package/dist/index.mjs

@@ -0,0 +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};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@docen/utils",
+  "version": "0.0.9",
+  "description": "Shared utility functions for DOCX processing, including unit conversions, color transformations, and XML helpers",
+  "keywords": [
+    "color",
+    "conversion",
+    "docen",
+    "docx",
+    "unit-conversion",
+    "utilities",
+    "xml"
+  ],
+  "homepage": "https://github.com/DemoMacro/docen#readme",
+  "bugs": {
+    "url": "https://github.com/DemoMacro/docen/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Demo Macro",
+    "email": "abc@imst.xyz",
+    "url": "https://imst.xyz/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DemoMacro/docen.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "devDependencies": {
+    "@types/xast": "2.0.4"
+  },
+  "scripts": {
+    "dev": "unbuild --stub",
+    "build": "unbuild"
+  }
+}