@outsidedata/dolex 0.1.0

package/dist/src/utils/export.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SVG Export Utilities — extract, inline, and download charts.
+ *
+ * Provides functions to serialize SVG elements to strings, inline
+ * computed styles for portability, and trigger browser downloads
+ * as SVG or PNG. All functions are DOM-dependent (browser only).
+ */
+/**
+ * Serialize an SVG element to a string.
+ *
+ * @param svgElement - The SVG DOM element
+ * @returns SVG markup string
+ */
+export declare function svgToString(svgElement: SVGSVGElement): string;
+/**
+ * Inline computed styles on all SVG child elements.
+ *
+ * This makes the SVG portable — it will look the same when opened
+ * outside the original page context (e.g., in Illustrator, Figma).
+ *
+ * @param svgElement - The SVG DOM element to process (mutated in place)
+ */
+export declare function inlineStyles(svgElement: SVGSVGElement): void;
+/**
+ * Trigger a browser download of an SVG element as an .svg file.
+ *
+ * @param svgElement - The SVG DOM element
+ * @param filename - Download filename (default 'chart.svg')
+ * @param options - Optional: whether to inline styles first
+ */
+export declare function downloadSvg(svgElement: SVGSVGElement, filename?: string, options?: {
+    inlineStyles?: boolean;
+}): void;
+/**
+ * Convert an SVG element to a PNG data URL via canvas.
+ *
+ * @param svgElement - The SVG DOM element
+ * @param scale - Resolution multiplier (default 2 for retina)
+ * @returns Promise resolving to a PNG data URL string
+ */
+export declare function svgToPng(svgElement: SVGSVGElement, scale?: number): Promise<string>;
+//# sourceMappingURL=export.d.ts.map

package/dist/src/utils/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/utils/export.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAa7D;AAmBD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAY5D;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,aAAa,EACzB,QAAQ,SAAc,EACtB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,IAAI,CAgBN;AAID;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAqC9E"}

package/dist/src/utils/export.js

@@ -0,0 +1,124 @@
+/**
+ * SVG Export Utilities — extract, inline, and download charts.
+ *
+ * Provides functions to serialize SVG elements to strings, inline
+ * computed styles for portability, and trigger browser downloads
+ * as SVG or PNG. All functions are DOM-dependent (browser only).
+ */
+// ─── SVG TO STRING ───────────────────────────────────────────────────────────
+/**
+ * Serialize an SVG element to a string.
+ *
+ * @param svgElement - The SVG DOM element
+ * @returns SVG markup string
+ */
+export function svgToString(svgElement) {
+    const serializer = new XMLSerializer();
+    let svgString = serializer.serializeToString(svgElement);
+    // Ensure XML declaration and namespace
+    if (!svgString.startsWith('<?xml')) {
+        svgString = '<?xml version="1.0" encoding="UTF-8"?>\n' + svgString;
+    }
+    if (!svgString.includes('xmlns="http://www.w3.org/2000/svg"')) {
+        svgString = svgString.replace('<svg', '<svg xmlns="http://www.w3.org/2000/svg"');
+    }
+    return svgString;
+}
+// ─── INLINE STYLES ───────────────────────────────────────────────────────────
+/** CSS properties to inline for portability */
+const INLINE_PROPS = [
+    'fill',
+    'stroke',
+    'stroke-width',
+    'stroke-dasharray',
+    'opacity',
+    'font-family',
+    'font-size',
+    'font-weight',
+    'text-anchor',
+    'dominant-baseline',
+    'transform',
+];
+/**
+ * Inline computed styles on all SVG child elements.
+ *
+ * This makes the SVG portable — it will look the same when opened
+ * outside the original page context (e.g., in Illustrator, Figma).
+ *
+ * @param svgElement - The SVG DOM element to process (mutated in place)
+ */
+export function inlineStyles(svgElement) {
+    const elements = svgElement.querySelectorAll('*');
+    elements.forEach((el) => {
+        const computed = getComputedStyle(el);
+        const style = el.style;
+        for (const prop of INLINE_PROPS) {
+            const value = computed.getPropertyValue(prop);
+            if (value && value !== 'none' && value !== 'normal' && value !== '0px') {
+                style.setProperty(prop, value);
+            }
+        }
+    });
+}
+// ─── DOWNLOAD SVG ────────────────────────────────────────────────────────────
+/**
+ * Trigger a browser download of an SVG element as an .svg file.
+ *
+ * @param svgElement - The SVG DOM element
+ * @param filename - Download filename (default 'chart.svg')
+ * @param options - Optional: whether to inline styles first
+ */
+export function downloadSvg(svgElement, filename = 'chart.svg', options) {
+    if (options?.inlineStyles !== false) {
+        inlineStyles(svgElement);
+    }
+    const svgString = svgToString(svgElement);
+    const blob = new Blob([svgString], { type: 'image/svg+xml;charset=utf-8' });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement('a');
+    link.href = url;
+    link.download = filename;
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+}
+// ─── SVG TO PNG ──────────────────────────────────────────────────────────────
+/**
+ * Convert an SVG element to a PNG data URL via canvas.
+ *
+ * @param svgElement - The SVG DOM element
+ * @param scale - Resolution multiplier (default 2 for retina)
+ * @returns Promise resolving to a PNG data URL string
+ */
+export function svgToPng(svgElement, scale = 2) {
+    return new Promise((resolve, reject) => {
+        inlineStyles(svgElement);
+        const svgString = svgToString(svgElement);
+        const width = svgElement.width.baseVal.value || 800;
+        const height = svgElement.height.baseVal.value || 500;
+        const canvas = document.createElement('canvas');
+        canvas.width = width * scale;
+        canvas.height = height * scale;
+        const ctx = canvas.getContext('2d');
+        if (!ctx) {
+            reject(new Error('Canvas 2D context not available'));
+            return;
+        }
+        ctx.scale(scale, scale);
+        const img = new Image();
+        const blob = new Blob([svgString], { type: 'image/svg+xml;charset=utf-8' });
+        const url = URL.createObjectURL(blob);
+        img.onload = () => {
+            ctx.drawImage(img, 0, 0, width, height);
+            URL.revokeObjectURL(url);
+            resolve(canvas.toDataURL('image/png'));
+        };
+        img.onerror = () => {
+            URL.revokeObjectURL(url);
+            reject(new Error('Failed to load SVG into image'));
+        };
+        img.src = url;
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/src/utils/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../../src/utils/export.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dolex Utilities — barrel export.
+ */
+export { measureText, truncateLabel, abbreviate, avoidCollisions, labelStrategy, } from './labels.js';
+export type { LabelPosition, ResolvedLabel, LabelStrategyMode, LabelStrategyResult, } from './labels.js';
+export { getContainerMode, responsiveMargins, responsiveFontSize, responsiveTicks, } from './responsive.js';
+export type { ContainerMode, ChartMargins, } from './responsive.js';
+export { svgToString, inlineStyles, downloadSvg, svgToPng, } from './export.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Dolex Utilities — barrel export.
+ */
+export { measureText, truncateLabel, abbreviate, avoidCollisions, labelStrategy, } from './labels.js';
+export { getContainerMode, responsiveMargins, responsiveFontSize, responsiveTicks, } from './responsive.js';
+export { svgToString, inlineStyles, downloadSvg, svgToPng, } from './export.js';
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,aAAa,CAAC;AASrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/src/utils/labels.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Smart Label Utilities — the biggest differentiator.
+ *
+ * Every chart renderer benefits from intelligent label placement:
+ * truncation, collision avoidance, abbreviation, and adaptive
+ * strategies based on available space.
+ */
+/**
+ * Approximate text width in pixels using character-count heuristics.
+ * Works without a DOM (server-side safe). Uses average character widths
+ * for common sans-serif fonts at the given size.
+ *
+ * @param text - The string to measure
+ * @param fontSize - Font size in pixels (default 12)
+ * @returns Approximate width in pixels
+ */
+export declare function measureText(text: string, fontSize?: number): number;
+/**
+ * Truncate a label to fit within a given pixel width.
+ *
+ * @param text - The label text
+ * @param maxWidth - Maximum allowed width in pixels
+ * @param fontSize - Font size in pixels (default 12)
+ * @param ellipsis - Ellipsis string (default '…')
+ * @returns Truncated text with ellipsis if needed
+ */
+export declare function truncateLabel(text: string, maxWidth: number, fontSize?: number, ellipsis?: string): string;
+/**
+ * Apply common abbreviation rules to shorten a label.
+ *
+ * @param text - The label text
+ * @returns Abbreviated text
+ */
+export declare function abbreviate(text: string): string;
+export interface LabelPosition {
+    x: number;
+    y: number;
+    text: string;
+    width?: number;
+    height?: number;
+}
+export interface ResolvedLabel extends LabelPosition {
+    originalY: number;
+    hidden: boolean;
+}
+/**
+ * Resolve label collisions by nudging overlapping labels apart vertically.
+ *
+ * Labels are sorted by y position, then any overlapping pair is spread
+ * apart symmetrically. Labels that still can't fit are marked `hidden`.
+ *
+ * @param labels - Array of label positions
+ * @param fontSize - Font size for height estimation (default 12)
+ * @param padding - Minimum vertical gap between labels in pixels (default 2)
+ * @param bounds - Optional vertical bounds { top, bottom }
+ * @returns Resolved labels with adjusted y positions and hidden flags
+ */
+export declare function avoidCollisions(labels: LabelPosition[], fontSize?: number, padding?: number, bounds?: {
+    top: number;
+    bottom: number;
+}): ResolvedLabel[];
+export type LabelStrategyMode = 'full' | 'abbreviated' | 'truncated' | 'rotated' | 'hidden';
+export interface LabelStrategyResult {
+    mode: LabelStrategyMode;
+    labels: string[];
+    rotation?: number;
+    fontSize: number;
+}
+/**
+ * Determine the best labeling strategy given labels and available space.
+ *
+ * Tries strategies in order: full → abbreviated → truncated → rotated → hidden.
+ * Returns the first strategy where all labels fit.
+ *
+ * @param labels - Array of label strings
+ * @param availableWidth - Total available width in pixels
+ * @param fontSize - Base font size (default 12)
+ * @returns The recommended strategy with transformed labels
+ */
+export declare function labelStrategy(labels: string[], availableWidth: number, fontSize?: number): LabelStrategyResult;
+//# sourceMappingURL=labels.d.ts.map

package/dist/src/utils/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/utils/labels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAa/D;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAK,EACb,QAAQ,SAAM,GACb,MAAM,CAoBR;AAgCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAID,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EAAE,EACvB,QAAQ,SAAK,EACb,OAAO,SAAI,EACX,MAAM,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC,aAAa,EAAE,CA6CjB;AAID,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE5F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EAAE,EAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,SAAK,GACZ,mBAAmB,CA4CrB"}

package/dist/src/utils/labels.js

@@ -0,0 +1,208 @@
+/**
+ * Smart Label Utilities — the biggest differentiator.
+ *
+ * Every chart renderer benefits from intelligent label placement:
+ * truncation, collision avoidance, abbreviation, and adaptive
+ * strategies based on available space.
+ */
+// ─── TEXT MEASUREMENT ────────────────────────────────────────────────────────
+/**
+ * Approximate text width in pixels using character-count heuristics.
+ * Works without a DOM (server-side safe). Uses average character widths
+ * for common sans-serif fonts at the given size.
+ *
+ * @param text - The string to measure
+ * @param fontSize - Font size in pixels (default 12)
+ * @returns Approximate width in pixels
+ */
+export function measureText(text, fontSize = 12) {
+    // Average character width ratios for sans-serif (Inter-like) at 1px font-size
+    // Narrow chars: i, l, 1, :, . ~0.3
+    // Wide chars: m, w, M, W ~0.7
+    // Average: ~0.52
+    const narrow = /[il1:.,;!|']/g;
+    const wide = /[mwMWGOQD@]/g;
+    const narrowCount = (text.match(narrow) || []).length;
+    const wideCount = (text.match(wide) || []).length;
+    const normalCount = text.length - narrowCount - wideCount;
+    const avgWidth = (narrowCount * 0.33 + normalCount * 0.52 + wideCount * 0.72) * fontSize;
+    return Math.ceil(avgWidth);
+}
+// ─── TRUNCATION ──────────────────────────────────────────────────────────────
+/**
+ * Truncate a label to fit within a given pixel width.
+ *
+ * @param text - The label text
+ * @param maxWidth - Maximum allowed width in pixels
+ * @param fontSize - Font size in pixels (default 12)
+ * @param ellipsis - Ellipsis string (default '…')
+ * @returns Truncated text with ellipsis if needed
+ */
+export function truncateLabel(text, maxWidth, fontSize = 12, ellipsis = '…') {
+    if (measureText(text, fontSize) <= maxWidth)
+        return text;
+    const ellipsisWidth = measureText(ellipsis, fontSize);
+    const targetWidth = maxWidth - ellipsisWidth;
+    if (targetWidth <= 0)
+        return ellipsis;
+    // Binary search for the right truncation point
+    let lo = 0;
+    let hi = text.length;
+    while (lo < hi) {
+        const mid = Math.ceil((lo + hi) / 2);
+        if (measureText(text.slice(0, mid), fontSize) <= targetWidth) {
+            lo = mid;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    return text.slice(0, lo) + ellipsis;
+}
+// ─── ABBREVIATION ────────────────────────────────────────────────────────────
+/** Common abbreviation rules for chart labels */
+const ABBREVIATIONS = [
+    [/\bJanuary\b/gi, 'Jan'],
+    [/\bFebruary\b/gi, 'Feb'],
+    [/\bMarch\b/gi, 'Mar'],
+    [/\bApril\b/gi, 'Apr'],
+    [/\bJune\b/gi, 'Jun'],
+    [/\bJuly\b/gi, 'Jul'],
+    [/\bAugust\b/gi, 'Aug'],
+    [/\bSeptember\b/gi, 'Sep'],
+    [/\bOctober\b/gi, 'Oct'],
+    [/\bNovember\b/gi, 'Nov'],
+    [/\bDecember\b/gi, 'Dec'],
+    [/\bQuarter\b/gi, 'Q'],
+    [/\bDepartment\b/gi, 'Dept'],
+    [/\bManagement\b/gi, 'Mgmt'],
+    [/\bInternational\b/gi, "Int'l"],
+    [/\bManufacturing\b/gi, 'Mfg'],
+    [/\bEngineering\b/gi, 'Eng'],
+    [/\bTechnology\b/gi, 'Tech'],
+    [/\bDevelopment\b/gi, 'Dev'],
+    [/\bUnited States\b/gi, 'US'],
+    [/\bUnited Kingdom\b/gi, 'UK'],
+    [/\bMillions?\b/gi, 'M'],
+    [/\bBillions?\b/gi, 'B'],
+    [/\bThousands?\b/gi, 'K'],
+];
+/**
+ * Apply common abbreviation rules to shorten a label.
+ *
+ * @param text - The label text
+ * @returns Abbreviated text
+ */
+export function abbreviate(text) {
+    let result = text;
+    for (const [pattern, replacement] of ABBREVIATIONS) {
+        result = result.replace(pattern, replacement);
+    }
+    return result;
+}
+/**
+ * Resolve label collisions by nudging overlapping labels apart vertically.
+ *
+ * Labels are sorted by y position, then any overlapping pair is spread
+ * apart symmetrically. Labels that still can't fit are marked `hidden`.
+ *
+ * @param labels - Array of label positions
+ * @param fontSize - Font size for height estimation (default 12)
+ * @param padding - Minimum vertical gap between labels in pixels (default 2)
+ * @param bounds - Optional vertical bounds { top, bottom }
+ * @returns Resolved labels with adjusted y positions and hidden flags
+ */
+export function avoidCollisions(labels, fontSize = 12, padding = 2, bounds) {
+    const labelHeight = fontSize * 1.2;
+    const minGap = labelHeight + padding;
+    // Create resolved copies sorted by y
+    const resolved = labels
+        .map((l) => ({
+        ...l,
+        width: l.width ?? measureText(l.text, fontSize),
+        height: l.height ?? labelHeight,
+        originalY: l.y,
+        hidden: false,
+    }))
+        .sort((a, b) => a.y - b.y);
+    // Push overlapping labels apart
+    for (let pass = 0; pass < 5; pass++) {
+        let moved = false;
+        for (let i = 1; i < resolved.length; i++) {
+            const prev = resolved[i - 1];
+            const curr = resolved[i];
+            if (prev.hidden || curr.hidden)
+                continue;
+            const overlap = prev.y + minGap - curr.y;
+            if (overlap > 0) {
+                const shift = overlap / 2;
+                prev.y -= shift;
+                curr.y += shift;
+                moved = true;
+            }
+        }
+        if (!moved)
+            break;
+    }
+    // Clamp to bounds and hide if out of range
+    if (bounds) {
+        for (const label of resolved) {
+            if (label.y < bounds.top || label.y > bounds.bottom) {
+                label.hidden = true;
+            }
+            label.y = Math.max(bounds.top, Math.min(bounds.bottom, label.y));
+        }
+    }
+    return resolved;
+}
+/**
+ * Determine the best labeling strategy given labels and available space.
+ *
+ * Tries strategies in order: full → abbreviated → truncated → rotated → hidden.
+ * Returns the first strategy where all labels fit.
+ *
+ * @param labels - Array of label strings
+ * @param availableWidth - Total available width in pixels
+ * @param fontSize - Base font size (default 12)
+ * @returns The recommended strategy with transformed labels
+ */
+export function labelStrategy(labels, availableWidth, fontSize = 12) {
+    const perLabel = availableWidth / Math.max(labels.length, 1);
+    // Strategy 1: Full labels fit
+    const maxFullWidth = Math.max(...labels.map((l) => measureText(l, fontSize)));
+    if (maxFullWidth <= perLabel) {
+        return { mode: 'full', labels, fontSize };
+    }
+    // Strategy 2: Abbreviated labels
+    const abbreviated = labels.map(abbreviate);
+    const maxAbbrWidth = Math.max(...abbreviated.map((l) => measureText(l, fontSize)));
+    if (maxAbbrWidth <= perLabel) {
+        return { mode: 'abbreviated', labels: abbreviated, fontSize };
+    }
+    // Strategy 3: Truncated labels
+    const truncated = labels.map((l) => truncateLabel(l, perLabel, fontSize));
+    const maxTruncWidth = Math.max(...truncated.map((l) => measureText(l, fontSize)));
+    if (maxTruncWidth <= perLabel) {
+        return { mode: 'truncated', labels: truncated, fontSize };
+    }
+    // Strategy 4: Rotated at 45° (effective width = height ≈ fontSize)
+    // At 45° rotation, the effective horizontal footprint is roughly fontSize * 1.2
+    const rotatedFootprint = fontSize * 1.2;
+    if (rotatedFootprint <= perLabel) {
+        return { mode: 'rotated', labels: abbreviated, rotation: -45, fontSize };
+    }
+    // Strategy 5: Smaller font + rotation
+    const smallFontSize = Math.max(9, fontSize - 2);
+    const smallRotatedFootprint = smallFontSize * 1.2;
+    if (smallRotatedFootprint <= perLabel) {
+        return {
+            mode: 'rotated',
+            labels: labels.map((l) => truncateLabel(l, perLabel * 2, smallFontSize)),
+            rotation: -45,
+            fontSize: smallFontSize,
+        };
+    }
+    // Strategy 6: Hide labels (too many to show)
+    return { mode: 'hidden', labels: [], fontSize };
+}
+//# sourceMappingURL=labels.js.map

package/dist/src/utils/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../src/utils/labels.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/responsive.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Responsive Utilities — adaptive sizing for different container dimensions.
+ *
+ * Provides container-aware breakpoints, margin calculations, font sizing,
+ * and tick count recommendations so charts look good at any size.
+ */
+export type ContainerMode = 'compact' | 'default' | 'wide' | 'large';
+/**
+ * Determine the container mode based on width and height.
+ *
+ * @param width - Container width in pixels
+ * @param height - Container height in pixels (optional)
+ * @returns The container mode
+ */
+export declare function getContainerMode(width: number, height?: number): ContainerMode;
+export interface ChartMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * Calculate responsive margins based on container dimensions.
+ *
+ * Smaller containers get tighter margins to maximize chart area.
+ * Larger containers get roomier margins for labels and legends.
+ *
+ * @param width - Container width in pixels
+ * @param height - Container height in pixels
+ * @param options - Optional overrides
+ * @returns Calculated margins
+ */
+export declare function responsiveMargins(width: number, height: number, options?: {
+    hasTitle?: boolean;
+    hasXLabel?: boolean;
+    hasYLabel?: boolean;
+    hasLegend?: boolean;
+}): ChartMargins;
+/**
+ * Calculate responsive font size based on container width.
+ *
+ * @param width - Container width in pixels
+ * @param role - The text role determining base size
+ * @returns Font size in pixels
+ */
+export declare function responsiveFontSize(width: number, role?: 'title' | 'axisLabel' | 'tickLabel' | 'annotation' | 'legend'): number;
+/**
+ * Calculate the recommended number of axis ticks based on available axis length.
+ *
+ * @param axisLength - Length of the axis in pixels
+ * @param isCategory - Whether this is a categorical (band) axis
+ * @returns Recommended tick count
+ */
+export declare function responsiveTicks(axisLength: number, isCategory?: boolean): number;
+//# sourceMappingURL=responsive.d.ts.map

package/dist/src/utils/responsive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive.d.ts","sourceRoot":"","sources":["../../../src/utils/responsive.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAK9E;AAID,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACA,YAAY,CAmBd;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,QAAsB,GAChF,MAAM,CAYR;AAID;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,MAAM,CAU9E"}

package/dist/src/utils/responsive.js

@@ -0,0 +1,91 @@
+/**
+ * Responsive Utilities — adaptive sizing for different container dimensions.
+ *
+ * Provides container-aware breakpoints, margin calculations, font sizing,
+ * and tick count recommendations so charts look good at any size.
+ */
+/**
+ * Determine the container mode based on width and height.
+ *
+ * @param width - Container width in pixels
+ * @param height - Container height in pixels (optional)
+ * @returns The container mode
+ */
+export function getContainerMode(width, height) {
+    if (width < 320)
+        return 'compact';
+    if (width < 600)
+        return 'default';
+    if (width < 1000)
+        return 'wide';
+    return 'large';
+}
+/**
+ * Calculate responsive margins based on container dimensions.
+ *
+ * Smaller containers get tighter margins to maximize chart area.
+ * Larger containers get roomier margins for labels and legends.
+ *
+ * @param width - Container width in pixels
+ * @param height - Container height in pixels
+ * @param options - Optional overrides
+ * @returns Calculated margins
+ */
+export function responsiveMargins(width, height, options) {
+    const mode = getContainerMode(width);
+    const opts = options ?? {};
+    const base = {
+        compact: { top: 24, right: 12, bottom: 30, left: 36 },
+        default: { top: 36, right: 24, bottom: 44, left: 52 },
+        wide: { top: 40, right: 30, bottom: 50, left: 60 },
+        large: { top: 48, right: 40, bottom: 56, left: 70 },
+    };
+    const m = { ...base[mode] };
+    if (opts.hasTitle)
+        m.top += mode === 'compact' ? 8 : 12;
+    if (opts.hasXLabel)
+        m.bottom += mode === 'compact' ? 10 : 16;
+    if (opts.hasYLabel)
+        m.left += mode === 'compact' ? 10 : 16;
+    if (opts.hasLegend)
+        m.right += mode === 'compact' ? 40 : 80;
+    return m;
+}
+// ─── RESPONSIVE FONT SIZE ────────────────────────────────────────────────────
+/**
+ * Calculate responsive font size based on container width.
+ *
+ * @param width - Container width in pixels
+ * @param role - The text role determining base size
+ * @returns Font size in pixels
+ */
+export function responsiveFontSize(width, role = 'tickLabel') {
+    const mode = getContainerMode(width);
+    const sizes = {
+        title: { compact: 11, default: 13, wide: 14, large: 16 },
+        axisLabel: { compact: 9, default: 11, wide: 12, large: 13 },
+        tickLabel: { compact: 8, default: 10, wide: 11, large: 12 },
+        annotation: { compact: 8, default: 10, wide: 11, large: 12 },
+        legend: { compact: 8, default: 10, wide: 11, large: 11 },
+    };
+    return sizes[role][mode];
+}
+// ─── RESPONSIVE TICKS ────────────────────────────────────────────────────────
+/**
+ * Calculate the recommended number of axis ticks based on available axis length.
+ *
+ * @param axisLength - Length of the axis in pixels
+ * @param isCategory - Whether this is a categorical (band) axis
+ * @returns Recommended tick count
+ */
+export function responsiveTicks(axisLength, isCategory = false) {
+    if (isCategory) {
+        // For categories, show every label up to a threshold, then skip
+        const maxVisible = Math.floor(axisLength / 60);
+        return Math.max(2, maxVisible);
+    }
+    // Quantitative/temporal: target ~80px per tick
+    const tickCount = Math.max(2, Math.floor(axisLength / 80));
+    return Math.min(tickCount, 12);
+}
+//# sourceMappingURL=responsive.js.map