@zeke-02/docx-editor-core 0.1.0

package/dist/utils/units.d.mts

@@ -0,0 +1,91 @@
+/**
+ * Unit Conversion Utilities - Convert OOXML units to CSS/pixels
+ *
+ * OOXML uses various unit systems that need conversion for rendering:
+ * - Twips: 1/20 of a point (1440 twips = 1 inch)
+ * - EMUs (English Metric Units): 914400 EMUs = 1 inch
+ * - Half-points: 1/2 of a point (144 half-points = 1 inch)
+ * - Points: 72 points = 1 inch
+ * - Eighths of a point: 1/8 of a point (576 eighths = 1 inch)
+ *
+ * Standard assumption: 96 DPI (pixels per inch)
+ * @packageDocumentation
+ * @public
+ */
+/** Twips per inch (1 inch = 1440 twips) */
+declare const TWIPS_PER_INCH = 1440;
+/** Pixels per inch at standard DPI */
+declare const PIXELS_PER_INCH = 96;
+/**
+ * Convert twips to pixels (at 96 DPI)
+ *
+ * 1 inch = 1440 twips = 96 pixels
+ * → 1 twip = 96/1440 pixels = 1/15 pixels
+ */
+declare function twipsToPixels(twips: number): number;
+/**
+ * Convert pixels to twips
+ */
+declare function pixelsToTwips(px: number): number;
+/**
+ * Convert EMUs to pixels (at 96 DPI)
+ *
+ * 1 inch = 914400 EMUs = 96 pixels
+ * Returns 0 for null/undefined/NaN inputs.
+ */
+declare function emuToPixels(emu: number | undefined | null): number;
+/**
+ * Convert pixels to EMUs.
+ * EMU coordinates in OOXML are integer-typed (xs:long); rounding here keeps
+ * floating-point drift (e.g. 52 px → 495299.99999999994) out of the document.
+ */
+declare function pixelsToEmu(px: number): number;
+/**
+ * Convert EMUs to twips
+ */
+declare function emuToTwips(emu: number): number;
+/**
+ * Convert twips to EMUs
+ */
+declare function twipsToEmu(twips: number): number;
+/**
+ * Convert points to pixels (at 96 DPI)
+ *
+ * 1 inch = 72 points = 96 pixels
+ * → 1 point = 96/72 pixels = 4/3 pixels
+ */
+declare function pointsToPixels(points: number): number;
+/**
+ * Convert half-points to pixels (at 96 DPI)
+ *
+ * Half-points are commonly used for font sizes in OOXML (w:sz).
+ */
+declare function halfPointsToPixels(halfPoints: number): number;
+/**
+ * Convert half-points to points
+ */
+declare function halfPointsToPoints(halfPoints: number): number;
+/**
+ * Convert points to half-points
+ */
+declare function pointsToHalfPoints(points: number): number;
+/**
+ * Convert eighths of a point to pixels (at 96 DPI)
+ *
+ * Eighths of a point are used for border widths in OOXML.
+ */
+declare function eighthsToPixels(eighths: number): number;
+/**
+ * Round a pixel value to avoid sub-pixel rendering issues
+ */
+declare function roundPixels(px: number, decimalPlaces?: number): number;
+/**
+ * Clamp a value between min and max
+ */
+declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Format a pixel value as CSS string
+ */
+declare function formatPx(px: number): string;
+
+export { PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels };

package/dist/utils/units.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Unit Conversion Utilities - Convert OOXML units to CSS/pixels
+ *
+ * OOXML uses various unit systems that need conversion for rendering:
+ * - Twips: 1/20 of a point (1440 twips = 1 inch)
+ * - EMUs (English Metric Units): 914400 EMUs = 1 inch
+ * - Half-points: 1/2 of a point (144 half-points = 1 inch)
+ * - Points: 72 points = 1 inch
+ * - Eighths of a point: 1/8 of a point (576 eighths = 1 inch)
+ *
+ * Standard assumption: 96 DPI (pixels per inch)
+ * @packageDocumentation
+ * @public
+ */
+/** Twips per inch (1 inch = 1440 twips) */
+declare const TWIPS_PER_INCH = 1440;
+/** Pixels per inch at standard DPI */
+declare const PIXELS_PER_INCH = 96;
+/**
+ * Convert twips to pixels (at 96 DPI)
+ *
+ * 1 inch = 1440 twips = 96 pixels
+ * → 1 twip = 96/1440 pixels = 1/15 pixels
+ */
+declare function twipsToPixels(twips: number): number;
+/**
+ * Convert pixels to twips
+ */
+declare function pixelsToTwips(px: number): number;
+/**
+ * Convert EMUs to pixels (at 96 DPI)
+ *
+ * 1 inch = 914400 EMUs = 96 pixels
+ * Returns 0 for null/undefined/NaN inputs.
+ */
+declare function emuToPixels(emu: number | undefined | null): number;
+/**
+ * Convert pixels to EMUs.
+ * EMU coordinates in OOXML are integer-typed (xs:long); rounding here keeps
+ * floating-point drift (e.g. 52 px → 495299.99999999994) out of the document.
+ */
+declare function pixelsToEmu(px: number): number;
+/**
+ * Convert EMUs to twips
+ */
+declare function emuToTwips(emu: number): number;
+/**
+ * Convert twips to EMUs
+ */
+declare function twipsToEmu(twips: number): number;
+/**
+ * Convert points to pixels (at 96 DPI)
+ *
+ * 1 inch = 72 points = 96 pixels
+ * → 1 point = 96/72 pixels = 4/3 pixels
+ */
+declare function pointsToPixels(points: number): number;
+/**
+ * Convert half-points to pixels (at 96 DPI)
+ *
+ * Half-points are commonly used for font sizes in OOXML (w:sz).
+ */
+declare function halfPointsToPixels(halfPoints: number): number;
+/**
+ * Convert half-points to points
+ */
+declare function halfPointsToPoints(halfPoints: number): number;
+/**
+ * Convert points to half-points
+ */
+declare function pointsToHalfPoints(points: number): number;
+/**
+ * Convert eighths of a point to pixels (at 96 DPI)
+ *
+ * Eighths of a point are used for border widths in OOXML.
+ */
+declare function eighthsToPixels(eighths: number): number;
+/**
+ * Round a pixel value to avoid sub-pixel rendering issues
+ */
+declare function roundPixels(px: number, decimalPlaces?: number): number;
+/**
+ * Clamp a value between min and max
+ */
+declare function clamp(value: number, min: number, max: number): number;
+/**
+ * Format a pixel value as CSS string
+ */
+declare function formatPx(px: number): string;
+
+export { PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels };

package/dist/utils/units.js

@@ -0,0 +1 @@
+'use strict';var chunk4Q2IP5FW_js=require('../chunk-4Q2IP5FW.js');require('../chunk-DC7S76ZX.js');Object.defineProperty(exports,"PIXELS_PER_INCH",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.b}});Object.defineProperty(exports,"TWIPS_PER_INCH",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.a}});Object.defineProperty(exports,"clamp",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.o}});Object.defineProperty(exports,"eighthsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.m}});Object.defineProperty(exports,"emuToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.e}});Object.defineProperty(exports,"emuToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.g}});Object.defineProperty(exports,"formatPx",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.p}});Object.defineProperty(exports,"halfPointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.j}});Object.defineProperty(exports,"halfPointsToPoints",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.k}});Object.defineProperty(exports,"pixelsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.f}});Object.defineProperty(exports,"pixelsToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.d}});Object.defineProperty(exports,"pointsToHalfPoints",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.l}});Object.defineProperty(exports,"pointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.i}});Object.defineProperty(exports,"roundPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.n}});Object.defineProperty(exports,"twipsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.h}});Object.defineProperty(exports,"twipsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.c}});

package/dist/utils/units.mjs

@@ -0,0 +1 @@
+export{b as PIXELS_PER_INCH,a as TWIPS_PER_INCH,o as clamp,m as eighthsToPixels,e as emuToPixels,g as emuToTwips,p as formatPx,j as halfPointsToPixels,k as halfPointsToPoints,f as pixelsToEmu,d as pixelsToTwips,l as pointsToHalfPoints,i as pointsToPixels,n as roundPixels,h as twipsToEmu,c as twipsToPixels}from'../chunk-VW22RZ6C.mjs';import'../chunk-QYUPLKLP.mjs';

package/dist/variableDetector-DF3-nxUC.d.mts

@@ -0,0 +1,115 @@
+import { Document } from './types/document.mjs';
+import { c as DocumentBody, P as Paragraph } from './content-5Mrz6w_b.mjs';
+
+/**
+ * Variable Detector Utility
+ *
+ * Scans a DOCX document for template variables in the format {variable_name}
+ * (standard docxtemplater syntax).
+ * Returns a unique, sorted list of variable names found in the document.
+ */
+
+/**
+ * Result of variable detection
+ */
+interface VariableDetectionResult {
+    /** Unique variable names sorted alphabetically */
+    variables: string[];
+    /** Total count of variable occurrences */
+    totalOccurrences: number;
+    /** Variables by location */
+    byLocation: {
+        body: string[];
+        headers: string[];
+        footers: string[];
+        footnotes: string[];
+        endnotes: string[];
+        textBoxes: string[];
+    };
+    /** Variable occurrences with positions */
+    occurrences: VariableOccurrence[];
+}
+/**
+ * A single variable occurrence with location info
+ */
+interface VariableOccurrence {
+    /** Variable name (without braces) */
+    name: string;
+    /** Location type */
+    location: 'body' | 'header' | 'footer' | 'footnote' | 'endnote' | 'textBox';
+    /** Paragraph index within location */
+    paragraphIndex?: number;
+    /** Section index (for headers/footers) */
+    sectionIndex?: number;
+}
+/**
+ * Detect all template variables in a document
+ *
+ * @param doc - The parsed document
+ * @returns Array of unique variable names sorted alphabetically
+ */
+declare function detectVariables(doc: Document): string[];
+/**
+ * Detect variables with detailed information
+ *
+ * @param doc - The parsed document
+ * @returns Detailed detection result
+ */
+declare function detectVariablesDetailed(doc: Document): VariableDetectionResult;
+/**
+ * Detect variables in document body
+ */
+declare function detectVariablesInBody(body: DocumentBody): string[];
+/**
+ * Detect variables in a paragraph
+ */
+declare function detectVariablesInParagraph(paragraph: Paragraph): string[];
+/**
+ * Extract variable names from text
+ *
+ * @param text - The text to search
+ * @returns Array of variable names (without braces)
+ */
+declare function extractVariablesFromText(text: string): string[];
+/**
+ * Check if text contains template variables
+ */
+declare function hasTemplateVariables(text: string): boolean;
+/**
+ * Check if a variable name is valid
+ */
+declare function isValidVariableName(name: string): boolean;
+/**
+ * Sanitize a variable name
+ */
+declare function sanitizeVariableName(name: string): string;
+/**
+ * Format a variable name with braces (standard docxtemplater syntax)
+ */
+declare function formatVariable(name: string): string;
+/**
+ * Parse a variable string to get the name
+ */
+declare function parseVariable(variable: string): string | null;
+/**
+ * Replace variables in text with values
+ *
+ * @param text - The text containing variables
+ * @param values - Map of variable name to replacement value
+ * @returns Text with variables replaced
+ */
+declare function replaceVariables(text: string, values: Record<string, string>): string;
+/**
+ * Replace all variables in text with a placeholder
+ *
+ * @param text - The text containing variables
+ * @param placeholder - Placeholder to use (default: empty string)
+ * @returns Text with variables replaced
+ */
+declare function removeVariables(text: string, placeholder?: string): string;
+/**
+ * Check if document has any template variables
+ */
+declare function documentHasVariables(doc: Document): boolean;
+
+export { type VariableDetectionResult as V, type VariableOccurrence as a, detectVariablesDetailed as b, detectVariablesInBody as c, detectVariables as d, detectVariablesInParagraph as e, documentHasVariables as f, extractVariablesFromText as g, formatVariable as h, hasTemplateVariables as i, isValidVariableName as j, replaceVariables as k, parseVariable as p, removeVariables as r, sanitizeVariableName as s };

package/dist/variableDetector-sBkgVh3f.d.ts

@@ -0,0 +1,115 @@
+import { Document } from './types/document.js';
+import { c as DocumentBody, P as Paragraph } from './content-CmqAwdFL.js';
+
+/**
+ * Variable Detector Utility
+ *
+ * Scans a DOCX document for template variables in the format {variable_name}
+ * (standard docxtemplater syntax).
+ * Returns a unique, sorted list of variable names found in the document.
+ */
+
+/**
+ * Result of variable detection
+ */
+interface VariableDetectionResult {
+    /** Unique variable names sorted alphabetically */
+    variables: string[];
+    /** Total count of variable occurrences */
+    totalOccurrences: number;
+    /** Variables by location */
+    byLocation: {
+        body: string[];
+        headers: string[];
+        footers: string[];
+        footnotes: string[];
+        endnotes: string[];
+        textBoxes: string[];
+    };
+    /** Variable occurrences with positions */
+    occurrences: VariableOccurrence[];
+}
+/**
+ * A single variable occurrence with location info
+ */
+interface VariableOccurrence {
+    /** Variable name (without braces) */
+    name: string;
+    /** Location type */
+    location: 'body' | 'header' | 'footer' | 'footnote' | 'endnote' | 'textBox';
+    /** Paragraph index within location */
+    paragraphIndex?: number;
+    /** Section index (for headers/footers) */
+    sectionIndex?: number;
+}
+/**
+ * Detect all template variables in a document
+ *
+ * @param doc - The parsed document
+ * @returns Array of unique variable names sorted alphabetically
+ */
+declare function detectVariables(doc: Document): string[];
+/**
+ * Detect variables with detailed information
+ *
+ * @param doc - The parsed document
+ * @returns Detailed detection result
+ */
+declare function detectVariablesDetailed(doc: Document): VariableDetectionResult;
+/**
+ * Detect variables in document body
+ */
+declare function detectVariablesInBody(body: DocumentBody): string[];
+/**
+ * Detect variables in a paragraph
+ */
+declare function detectVariablesInParagraph(paragraph: Paragraph): string[];
+/**
+ * Extract variable names from text
+ *
+ * @param text - The text to search
+ * @returns Array of variable names (without braces)
+ */
+declare function extractVariablesFromText(text: string): string[];
+/**
+ * Check if text contains template variables
+ */
+declare function hasTemplateVariables(text: string): boolean;
+/**
+ * Check if a variable name is valid
+ */
+declare function isValidVariableName(name: string): boolean;
+/**
+ * Sanitize a variable name
+ */
+declare function sanitizeVariableName(name: string): string;
+/**
+ * Format a variable name with braces (standard docxtemplater syntax)
+ */
+declare function formatVariable(name: string): string;
+/**
+ * Parse a variable string to get the name
+ */
+declare function parseVariable(variable: string): string | null;
+/**
+ * Replace variables in text with values
+ *
+ * @param text - The text containing variables
+ * @param values - Map of variable name to replacement value
+ * @returns Text with variables replaced
+ */
+declare function replaceVariables(text: string, values: Record<string, string>): string;
+/**
+ * Replace all variables in text with a placeholder
+ *
+ * @param text - The text containing variables
+ * @param placeholder - Placeholder to use (default: empty string)
+ * @returns Text with variables replaced
+ */
+declare function removeVariables(text: string, placeholder?: string): string;
+/**
+ * Check if document has any template variables
+ */
+declare function documentHasVariables(doc: Document): boolean;
+
+export { type VariableDetectionResult as V, type VariableOccurrence as a, detectVariablesDetailed as b, detectVariablesInBody as c, detectVariables as d, detectVariablesInParagraph as e, documentHasVariables as f, extractVariablesFromText as g, formatVariable as h, hasTemplateVariables as i, isValidVariableName as j, replaceVariables as k, parseVariable as p, removeVariables as r, sanitizeVariableName as s };