docgen-utils 1.0.18 → 1.0.20

package/dist/packages/slides/parse.d.ts

@@ -8,29 +8,7 @@
  * The main export is `parseSlideHtml(doc)` which walks the DOM tree and returns
  * a `ParsedSlide` intermediate representation consumed by the rendering layer.
  */
-import type { GradientFillProps } from './vendor/pptxgen.d.ts';
 import type { ParsedSlide } from './common';
-/** Convert pixel value to inches. */
-export declare function pxToInch(px: number): number;
-/** Convert a CSS pixel string (e.g. "16px") to points. */
-export declare function pxToPoints(pxStr: string): number;
-/**
- * Convert an `rgb()` / `rgba()` color string to a 6-char hex string.
- * Returns `'FFFFFF'` for transparent or unparseable values.
- */
-export declare function rgbToHex(rgbStr: string): string;
-/**
- * Extract transparency percentage from an `rgba()` string.
- * Returns `null` for opaque or non-rgba values, otherwise 0-100.
- */
-export declare function extractAlpha(rgbStr: string): number | null;
-/**
- * Parse a CSS gradient string (`linear-gradient(...)` or `radial-gradient(...)`)
- * into a PptxGenJS-compatible `GradientFillProps` object.
- *
- * Returns `null` if the string does not contain a recognized gradient.
- */
-export declare function parseCssGradient(gradientStr: string): GradientFillProps | null;
 /**
  * Parse a live browser DOM `Document` into a `ParsedSlide` intermediate
  * representation.

package/dist/packages/slides/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../packages/slides/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,WAAW,EAuBZ,MAAM,UAAU,CAAC;AAqBlB,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAU/C;AAgBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK1D;AAiTD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAmK9E;AAi3CD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAytEzD"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../packages/slides/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EACV,WAAW,EAgBZ,MAAM,UAAU,CAAC;AAk5DlB;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAytEzD"}

package/dist/packages/slides/parse.js

@@ -19,21 +19,21 @@ const PX_PER_IN = 96;
 // ---------------------------------------------------------------------------
 const SINGLE_WEIGHT_FONTS = ['impact'];
 // ---------------------------------------------------------------------------
-// Exported helper functions
+// Internal helper functions
 // ---------------------------------------------------------------------------
 /** Convert pixel value to inches. */
-export function pxToInch(px) {
+function pxToInch(px) {
     return px / PX_PER_IN;
 }
 /** Convert a CSS pixel string (e.g. "16px") to points. */
-export function pxToPoints(pxStr) {
+function pxToPoints(pxStr) {
     return parseFloat(pxStr) * PT_PER_PX;
 }
 /**
  * Convert an `rgb()` / `rgba()` color string to a 6-char hex string.
  * Returns `'FFFFFF'` for transparent or unparseable values.
  */
-export function rgbToHex(rgbStr) {
+function rgbToHex(rgbStr) {
     // Remove !important suffix if present
     rgbStr = rgbStr.replace(/\s*!important\s*$/i, '').trim();
     if (rgbStr === 'rgba(0, 0, 0, 0)' || rgbStr === 'transparent')
@@ -64,7 +64,7 @@ function isFullyTransparent(colorStr) {
  * Extract transparency percentage from an `rgba()` string.
  * Returns `null` for opaque or non-rgba values, otherwise 0-100.
  */
-export function extractAlpha(rgbStr) {
+function extractAlpha(rgbStr) {
     const match = rgbStr.match(/rgba\((\d+),\s*(\d+),\s*(\d+),\s*([\d.]+)\)/);
     if (!match || !match[4])
         return null;
@@ -354,7 +354,7 @@ function renderRepeatingGradientPatternAsImage(bgImage, bgSize, bgPosition, widt
     }
 }
 // ---------------------------------------------------------------------------
-// parseCssGradient  (exported, used by other modules)
+// parseCssGradient  (internal, used within this module)
 // ---------------------------------------------------------------------------
 /**
  * Parse a CSS gradient string (`linear-gradient(...)` or `radial-gradient(...)`)
@@ -362,7 +362,7 @@ function renderRepeatingGradientPatternAsImage(bgImage, bgSize, bgPosition, widt
  *
  * Returns `null` if the string does not contain a recognized gradient.
  */
-export function parseCssGradient(gradientStr) {
+function parseCssGradient(gradientStr) {
     const colorToHex = (colorStr) => {
         colorStr = colorStr.trim().toLowerCase();
         // Remove !important suffix if present
@@ -444,10 +444,30 @@ export function parseCssGradient(gradientStr) {
         }
         return null;
     };
+    // Shared helper: parse color stops from a gradient parts array.
+    // Prevents divide-by-zero when there is only one color stop.
+    const parseColorStops = (colorStops) => {
+        return colorStops.map((stop, idx) => {
+            const posMatch = stop.match(/([\d.]+)%\s*$/);
+            const position = posMatch
+                ? parseFloat(posMatch[1])
+                : (idx / Math.max(colorStops.length - 1, 1)) * 100;
+            const colorPart = posMatch
+                ? stop.replace(/([\d.]+)%\s*$/, '').trim()
+                : stop.trim();
+            const stopData = { color: colorToHex(colorPart), position };
+            const transparency = extractTransparency(colorPart);
+            if (transparency !== null)
+                stopData.transparency = transparency;
+            return stopData;
+        });
+    };
     // Try linear-gradient
     const linearContent = extractGradientContent(gradientStr, 'linear-gradient(');
     if (linearContent) {
         const parts = splitGradientParts(linearContent);
+        if (parts.length === 0)
+            return null;
         let cssAngle = 180;
         let colorStops = parts;
         const angleMatch = parts[0].match(/^([\d.]+)deg$/);
@@ -474,26 +494,15 @@ export function parseCssGradient(gradientStr) {
             cssAngle = dirMap[dir] ?? 180;
             colorStops = parts.slice(1);
         }
-        const stops = colorStops.map((stop, idx) => {
-            const posMatch = stop.match(/([\d.]+)%\s*$/);
-            const position = posMatch
-                ? parseFloat(posMatch[1])
-                : (idx / (colorStops.length - 1)) * 100;
-            const colorPart = posMatch
-                ? stop.replace(/([\d.]+)%\s*$/, '').trim()
-                : stop.trim();
-            const stopData = { color: colorToHex(colorPart), position };
-            const transparency = extractTransparency(colorPart);
-            if (transparency !== null)
-                stopData.transparency = transparency;
-            return stopData;
-        });
+        const stops = parseColorStops(colorStops);
         return { type: 'linear', angle: cssAngle, stops };
     }
     // Try radial-gradient
     const radialContent = extractGradientContent(gradientStr, 'radial-gradient(');
     if (radialContent) {
         const parts = splitGradientParts(radialContent);
+        if (parts.length === 0)
+            return null;
         let centerX = 50;
         let centerY = 50;
         let colorStops = parts;
@@ -506,20 +515,7 @@ export function parseCssGradient(gradientStr) {
         else if (parts[0].includes('circle') || parts[0].includes('ellipse')) {
             colorStops = parts.slice(1);
         }
-        const stops = colorStops.map((stop, idx) => {
-            const posMatch2 = stop.match(/([\d.]+)%\s*$/);
-            const position = posMatch2
-                ? parseFloat(posMatch2[1])
-                : (idx / (colorStops.length - 1)) * 100;
-            const colorPart = posMatch2
-                ? stop.replace(/([\d.]+)%\s*$/, '').trim()
-                : stop.trim();
-            const stopData = { color: colorToHex(colorPart), position };
-            const transparency = extractTransparency(colorPart);
-            if (transparency !== null)
-                stopData.transparency = transparency;
-            return stopData;
-        });
+        const stops = parseColorStops(colorStops);
         return { type: 'radial', centerX, centerY, stops };
     }
     return null;
@@ -1611,7 +1607,7 @@ function extractPseudoElements(el, win) {
             continue;
         // Parse gradient(s) — a single background-image property may contain multiple gradients
         let gradient = null;
-        let extraPseudoGradients = [];
+        const extraPseudoGradients = [];
         if (hasGradient) {
             const gradParts = splitCssBackgroundGradients(bgImage);
             if (gradParts.length > 0)
@@ -2597,7 +2593,7 @@ export function parseSlideHtml(doc) {
             }
             const hasBg = computed.backgroundColor && computed.backgroundColor !== 'rgba(0, 0, 0, 0)';
             // Check for clip-path: polygon() — store for custom geometry
-            const clipPathValue = computed.clipPath || computed.webkitClipPath;
+            const clipPathValue = computed.clipPath || computed.webkitClipPath || '';
             const clipPathPolygon = parseClipPathPolygon(clipPathValue);
             // Check for background images or gradients
             const elBgImage = computed.backgroundImage;
@@ -2605,7 +2601,7 @@ export function parseSlideHtml(doc) {
             let bgImageSize = null;
             let bgImagePosition = null;
             let bgGradient = null;
-            let extraDivGradients = [];
+            const extraDivGradients = [];
             if (elBgImage && elBgImage !== 'none') {
                 if (elBgImage.includes('linear-gradient') ||
                     elBgImage.includes('radial-gradient')) {
@@ -2848,7 +2844,7 @@ export function parseSlideHtml(doc) {
                     const alignItems = computed.alignItems;
                     const justifyContent = computed.justifyContent;
                     let valign = 'top';
-                    let align = 'left';
+                    let align;
                     if (isFlexContainer) {
                         const flexDirection = computed.flexDirection || 'row';
                         if (flexDirection === 'row' || flexDirection === 'row-reverse') {
@@ -3587,7 +3583,7 @@ export function parseSlideHtml(doc) {
                 const isLast = idx === liElements.length - 1;
                 const runs = parseInlineFormatting(li, { breakLine: false }, [], (x) => x, win);
                 if (runs.length > 0) {
-                    runs[0].text = runs[0].text.replace(/^[•\-\*\u25AA\u25B8]\s*/, '');
+                    runs[0].text = runs[0].text.replace(/^[•\-*\u25AA\u25B8]\s*/, '');
                     if (hasNativeBullets) {
                         runs[0].options.bullet = { indent: textIndent };
                     }
@@ -3720,7 +3716,7 @@ export function parseSlideHtml(doc) {
             }
         }
         if (el.tagName !== 'LI' &&
-            /^[•\-\*\u25AA\u25B8\u25CB\u25CF\u25C6\u25C7\u25A0\u25A1]\s/.test(text.trimStart())) {
+            /^[•\-*\u25AA\u25B8\u25CB\u25CF\u25C6\u25C7\u25A0\u25A1]\s/.test(text.trimStart())) {
             errors.push(`Text element <${el.tagName.toLowerCase()}> starts with bullet symbol "${text.substring(0, 20)}...". ` +
                 'Use <ul> or <ol> lists instead of manual bullet symbols.');
             return;
@@ -3730,7 +3726,7 @@ export function parseSlideHtml(doc) {
         const fontSizePx = parseFloat(computed.fontSize);
         const lineHeightPx = parseFloat(computed.lineHeight);
         const lineHeightMultiplier = fontSizePx > 0 && !isNaN(lineHeightPx) ? lineHeightPx / fontSizePx : 1.0;
-        let textAlign = computed.textAlign === 'start' ? 'left' : computed.textAlign;
+        const textAlign = computed.textAlign === 'start' ? 'left' : computed.textAlign;
         let valign = null;
         const checkFlexParent = (parent) => {
             if (!parent)