@outsidedata/dolex 0.1.0

package/dist/src/renderers/html/sizing.js

@@ -0,0 +1,126 @@
+/**
+ * Content-appropriate height calculation for visualization specs.
+ *
+ * Returns a pixel height based on pattern type, data shape, and container width.
+ */
+// ─── HELPERS ─────────────────────────────────────────────────────────────────
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, Math.round(value)));
+}
+/** Count unique values for a given field in the data array. */
+function uniqueValues(data, field) {
+    const seen = new Set();
+    for (const row of data) {
+        if (row[field] !== undefined && row[field] !== null) {
+            seen.add(row[field]);
+        }
+    }
+    return seen.size || 1;
+}
+/** Count unique series from the color encoding field. */
+function seriesCount(spec) {
+    const colorField = spec.encoding.color?.field;
+    if (colorField) {
+        return uniqueValues(spec.data, colorField);
+    }
+    // No color encoding — treat as single series
+    return 1;
+}
+/** Count unique categories from the y encoding field (or fall back to data length). */
+function categoryCount(spec) {
+    const yField = spec.encoding.y?.field;
+    if (yField) {
+        return uniqueValues(spec.data, yField);
+    }
+    // Fall back: count rows as proxy for categories
+    return spec.data.length;
+}
+/** Extract unique years from the x (temporal) encoding field. */
+function yearCount(spec) {
+    const xField = spec.encoding.x?.field;
+    if (!xField)
+        return 1;
+    const years = new Set();
+    for (const row of spec.data) {
+        const val = row[xField];
+        if (val != null) {
+            const parsed = new Date(val);
+            if (!isNaN(parsed.getTime())) {
+                years.add(parsed.getFullYear());
+            }
+        }
+    }
+    return years.size || 1;
+}
+// ─── PATTERN SETS ────────────────────────────────────────────────────────────
+const SQUARE_PATTERNS = new Set(['treemap', 'circle-pack', 'sunburst', 'donut']);
+const WIDE_PATTERNS = new Set(['parallel-coordinates', 'radar']);
+const FLOW_PATTERNS = new Set(['sankey', 'alluvial', 'chord', 'funnel']);
+const ALWAYS_HORIZONTAL = new Set(['lollipop', 'bullet']);
+// ─── MAIN FUNCTION ───────────────────────────────────────────────────────────
+/**
+ * Calculate the preferred height for a visualization based on its pattern,
+ * data shape, and available container width.
+ */
+export function getPreferredHeight(spec, containerWidth) {
+    const { pattern, data, config } = spec;
+    // Empty data — safe fallback
+    if (!data || data.length === 0) {
+        return 300;
+    }
+    // ── Metric: compact fixed height ──────────────────────────────────
+    if (pattern === 'metric') {
+        return 120;
+    }
+    // ── Sparkline-grid: 80px per series ───────────────────────────────
+    if (pattern === 'sparkline-grid') {
+        const count = seriesCount(spec);
+        return clamp(count * 80 + 60, 200, 600);
+    }
+    // ── Horizontal bar-like: 28px per category ────────────────────────
+    if (ALWAYS_HORIZONTAL.has(pattern) || config?.orientation === 'horizontal') {
+        const count = categoryCount(spec);
+        return clamp(count * 28 + 100, 300, 800);
+    }
+    // ── Square layouts: match container width ─────────────────────────
+    if (SQUARE_PATTERNS.has(pattern)) {
+        return clamp(containerWidth, 300, 700);
+    }
+    // ── Heatmap: 30px per unique y value ──────────────────────────────
+    if (pattern === 'heatmap') {
+        const count = categoryCount(spec);
+        return clamp(count * 30 + 100, 300, 800);
+    }
+    // ── Calendar-heatmap: 160px per unique year ───────────────────────
+    if (pattern === 'calendar-heatmap') {
+        const count = yearCount(spec);
+        return clamp(count * 160 + 60, 300, 800);
+    }
+    // ── Wide charts: fixed 450px ──────────────────────────────────────
+    if (WIDE_PATTERNS.has(pattern)) {
+        return 450;
+    }
+    // ── Flow charts: 600 if dense ─────────────────────────────────────
+    if (FLOW_PATTERNS.has(pattern)) {
+        return data.length > 20 ? 600 : 500;
+    }
+    // ── Ridgeline: 60px per group ─────────────────────────────────────
+    if (pattern === 'ridgeline') {
+        const count = categoryCount(spec);
+        return clamp(count * 60 + 80, 300, 800);
+    }
+    // ── Small-multiples: rows of 3 cols at 200px each ────────────────
+    if (pattern === 'small-multiples') {
+        const count = seriesCount(spec);
+        const rows = Math.ceil(count / 3);
+        return clamp(rows * 200 + 60, 300, 900);
+    }
+    // ── Horizon-chart: 80px per series ────────────────────────────────
+    if (pattern === 'horizon-chart') {
+        const count = seriesCount(spec);
+        return clamp(count * 80 + 60, 250, 600);
+    }
+    // ── Default: standard chart height ────────────────────────────────
+    return 500;
+}
+//# sourceMappingURL=sizing.js.map

package/dist/src/renderers/html/sizing.js.map

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

package/dist/src/renderers/html/template.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Self-contained HTML template builder for Dolex visualization specs.
+ *
+ * Produces a complete HTML document string that can be rendered inside
+ * a sandboxed iframe in MCP Apps (Claude Desktop, ChatGPT, VS Code).
+ *
+ * Each document embeds:
+ *   - D3 v7 via CDN
+ *   - All shared rendering utilities (scales, axes, tooltips, colors)
+ *   - The visualization spec as inline JSON
+ *   - Pattern-specific rendering code
+ */
+import type { VisualizationSpec } from '../../types.js';
+export declare function buildHtml(spec: VisualizationSpec, renderFunctionBody: string): string;
+/**
+ * Build a complete, self-contained HTML document from a pre-bundled renderer.
+ *
+ * Unlike `buildHtml()`, this does NOT inject `SHARED_UTILITIES_JS` because the
+ * bundled code already contains all shared utilities (inlined by esbuild).
+ * The bundle exposes `renderChart` as a global function.
+ *
+ * @param spec - The VisualizationSpec describing the chart
+ * @param bundleCode - Self-contained IIFE string from _generated/bundles.ts
+ * @param options - Extra scripts (e.g. topojson CDN for geo patterns)
+ * @returns A complete HTML document string
+ */
+export declare function buildHtmlFromBundle(spec: VisualizationSpec, bundleCode: string, options?: {
+    extraScripts?: string[];
+}): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/src/renderers/html/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../src/renderers/html/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA+iBxD,wBAAgB,SAAS,CAAC,IAAI,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CA4FrF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACpC,MAAM,CA2FR"}