@grafloria/element 0.3.17 → 0.3.19

package/src/libs/renderer/src/export/bounds.js

@@ -0,0 +1,367 @@
+"use strict";
+// Content-tight bounds, export scope, and output-size clamping.
+//
+// WHY A VNODE WALK AND NOT A MODEL WALK
+// -------------------------------------
+// The renderer already had a content bbox (`SVGRenderer.contentViewport`), and it
+// unioned the MODEL: node position/size + routed link points. That is most of the
+// picture — but it is not the picture. What the model does not know:
+//
+//   • link LABELS, which hang off the path at a midpoint + offset and routinely
+//     stick out past every node and every routed point;
+//   • node labels placed OUTSIDE the node box;
+//   • ports, which sit ON the node border and (with an outward offset) past it;
+//   • arrowheads, which extend beyond the last path point;
+//   • the node SHADOW's blur radius.
+//
+// Export with a model-derived bbox and all of those get clipped at the edge of the
+// file. So the bbox is taken from the thing that is actually drawn: the VNode tree.
+// One walk, every drawable, transforms applied — if the renderer draws it, it is in
+// the box.
+//
+// TEXT is the one estimate. There is no font engine here (that is the whole point
+// of a headless exporter), so a `<text>` is measured with the SAME 0.6em-per-char
+// approximation `LabelRenderer.estimateTextWidth` already uses to size its own
+// label backgrounds. Sharing the estimator means the box we reserve and the box the
+// renderer reserved cannot disagree; both are approximations of the same thing.
+//
+// Every other shape is EXACT: paths go through the shared `parsePath` + `pathBounds`,
+// which flatten the curves rather than guessing from control points.
+//
+// Everything here is pure: no DOM, no clock, no randomness.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_OUTPUT_SIZE = exports.scopeKeysFor = exports.AVG_CHAR_WIDTH_EM = void 0;
+exports.vnodeBounds = vnodeBounds;
+exports.clampOutputSize = clampOutputSize;
+exports.padRect = padRect;
+const scope_1 = require("./scope");
+// THE geometry module for this codebase. `canvas/path-geometry.ts` already owns the SVG
+// geometry model — matrices, `parseTransform`, `parsePath` (every command, relative forms,
+// the S/T reflection, and A→cubics), the primitive builders, and `pathBounds`, which
+// FLATTENS curves rather than approximating them by their control points. The canvas
+// renderer draws through it and it has its own suite. Re-deriving any of it here would be a
+// second copy of some very fiddly maths, drifting, with only one copy tested.
+const path_geometry_1 = require("../canvas/path-geometry");
+/** A growable min/max box. `null`-ish until the first point lands in it. */
+class BoxAccumulator {
+    constructor() {
+        this.minX = Infinity;
+        this.minY = Infinity;
+        this.maxX = -Infinity;
+        this.maxY = -Infinity;
+    }
+    addPoint(m, x, y) {
+        if (!Number.isFinite(x) || !Number.isFinite(y))
+            return;
+        const p = (0, path_geometry_1.applyMatrix)(m, { x, y });
+        if (!Number.isFinite(p.x) || !Number.isFinite(p.y))
+            return;
+        this.minX = Math.min(this.minX, p.x);
+        this.minY = Math.min(this.minY, p.y);
+        this.maxX = Math.max(this.maxX, p.x);
+        this.maxY = Math.max(this.maxY, p.y);
+    }
+    /** Add an axis-aligned box by its four CORNERS — under rotation the corners move. */
+    addBox(m, x, y, width, height) {
+        this.addPoint(m, x, y);
+        this.addPoint(m, x + width, y);
+        this.addPoint(m, x, y + height);
+        this.addPoint(m, x + width, y + height);
+    }
+    get empty() {
+        return !Number.isFinite(this.minX) || !Number.isFinite(this.minY);
+    }
+    toRect() {
+        if (this.empty)
+            return null;
+        return {
+            x: this.minX,
+            y: this.minY,
+            width: this.maxX - this.minX,
+            height: this.maxY - this.minY,
+        };
+    }
+}
+/**
+ * The average glyph advance, as a fraction of font-size.
+ *
+ * THE SAME CONSTANT `LabelRenderer.estimateTextWidth` uses. It is a rough mean for
+ * proportional Latin text — and it being rough is fine, because the renderer sizes
+ * label backgrounds with it too. What matters is that the two AGREE: a bbox derived
+ * from a different estimate than the one that placed the text would crop labels the
+ * renderer thought it had left room for.
+ */
+exports.AVG_CHAR_WIDTH_EM = 0.6;
+const DEFAULT_FONT_SIZE = 12;
+/** Elements that paint nothing and whose children are references, not drawings. */
+const NON_PAINTING = new Set(['defs', 'title', 'desc', 'metadata', 'linearGradient', 'radialGradient', 'stop', 'filter', 'marker', 'clipPath', 'mask', 'pattern', 'style']);
+function num(value, fallback = 0) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : fallback;
+}
+/** `"10,20 30,40"` / `"10 20 30 40"` → [[10,20],[30,40]] */
+function parsePoints(points) {
+    if (typeof points !== 'string')
+        return [];
+    const nums = points
+        .trim()
+        .split(/[\s,]+/)
+        .map(Number)
+        .filter(n => Number.isFinite(n));
+    const out = [];
+    for (let i = 0; i + 1 < nums.length; i += 2)
+        out.push([nums[i], nums[i + 1]]);
+    return out;
+}
+/**
+ * Estimate a `<text>` element's ink box.
+ *
+ * Honours `text-anchor` (start/middle/end) and treats `y` as the BASELINE, which is
+ * what SVG does — so the box runs from roughly one ascent above y to one descent
+ * below it. Ascent ≈ 0.8em, descent ≈ 0.2em is the usual rule of thumb and is well
+ * within the error of the width estimate it sits next to.
+ */
+function textBox(vnode) {
+    var _a, _b, _c, _d;
+    const props = (_a = vnode.props) !== null && _a !== void 0 ? _a : {};
+    const content = textContentOf(vnode);
+    if (!content)
+        return null;
+    const fontSize = num((_b = props['fontSize']) !== null && _b !== void 0 ? _b : props['font-size'], DEFAULT_FONT_SIZE);
+    // Multi-line labels render as <tspan> children; the widest line sets the width.
+    const lines = content.split('\n');
+    const longest = lines.reduce((max, line) => Math.max(max, line.length), 0);
+    const width = longest * fontSize * exports.AVG_CHAR_WIDTH_EM;
+    const height = fontSize * lines.length;
+    const x = num(props['x']);
+    const y = num(props['y']);
+    const anchor = String((_d = (_c = props['textAnchor']) !== null && _c !== void 0 ? _c : props['text-anchor']) !== null && _d !== void 0 ? _d : 'start');
+    const left = anchor === 'middle' ? x - width / 2 : anchor === 'end' ? x - width : x;
+    return { x: left, y: y - fontSize * 0.8, width, height };
+}
+/** The text a `<text>` will actually paint — its own prop, or its tspans'. */
+function textContentOf(vnode) {
+    var _a, _b;
+    const own = (_a = vnode.props) === null || _a === void 0 ? void 0 : _a['textContent'];
+    if (typeof own === 'string' && own !== '')
+        return own;
+    const lines = [];
+    for (const child of (_b = vnode.children) !== null && _b !== void 0 ? _b : []) {
+        if (!child || typeof child !== 'object') {
+            if (typeof child === 'string')
+                lines.push(child);
+            continue;
+        }
+        const nested = textContentOf(child);
+        if (nested)
+            lines.push(nested);
+    }
+    return lines.join('\n');
+}
+/**
+ * The VNode `key` is the diagram's identity in the tree: the renderer stamps every
+ * node group with `node-<id>` and every link group with `link-<id>`.
+ *
+ * We match on the KEY and not on a `data-*` prop because the key is the only
+ * identifier that is actually universal. `data-link-id` is present on some link
+ * variants and absent on others, and `data-node-id` DOES NOT EXIST — a selection
+ * filter written against it would have matched nothing and silently exported an
+ * empty box, which is precisely the "config declared but never consumed" failure
+ * this codebase keeps producing.
+ *
+ * ONE definition of the key shapes, shared with the tree prune in `scope.ts`: if the
+ * box and the prune ever disagreed about what a selection IS, an export would crop
+ * to a different set of elements than it contains.
+ */
+var scope_2 = require("./scope");
+Object.defineProperty(exports, "scopeKeysFor", { enumerable: true, get: function () { return scope_2.selectionKeys; } });
+/**
+ * The union box of everything a VNode tree paints, in the tree's own user space.
+ *
+ * Returns `null` for a tree that paints nothing (an empty diagram) — the caller
+ * decides what an empty document should be, because "nothing" is not a rectangle.
+ */
+function vnodeBounds(root, options = {}) {
+    const box = new BoxAccumulator();
+    const scopeKeys = options.includeIds ? (0, scope_1.selectionKeys)(options.includeIds) : undefined;
+    // With no filter every element is in scope from the root down.
+    walk(root, path_geometry_1.IDENTITY, box, scopeKeys, scopeKeys === undefined);
+    return box.toRect();
+}
+/**
+ * @param selected has an ancestor already matched `includeIds`? Once a subtree is
+ *        in scope, everything under it is in scope — a node's label and ports are
+ *        part of the node, and they are not separately id-tagged.
+ */
+function walk(vnode, parent, box, scopeKeys, selected) {
+    var _a, _b;
+    if (!vnode || typeof vnode !== 'object' || typeof vnode.type !== 'string')
+        return;
+    const props = (_a = vnode.props) !== null && _a !== void 0 ? _a : {};
+    // A hidden element paints nothing, so it must not enlarge the box. (`display:
+    // none` on a culled node used to be the sneaky way an off-screen element still
+    // widened an export.)
+    if (props['display'] === 'none')
+        return;
+    // <defs> and friends: their children are REFERENCED, never drawn in place.
+    if (NON_PAINTING.has(vnode.type))
+        return;
+    const here = (0, path_geometry_1.multiply)(parent, (0, path_geometry_1.parseTransform)(props['transform']));
+    // Scope gate. Once a subtree is in scope everything under it is too — a node's
+    // label and ports are PART of the node and carry no id of their own.
+    const inScope = selected || (scopeKeys !== undefined && vnode.key !== undefined && scopeKeys.has(vnode.key));
+    if (inScope) {
+        addGeometry(vnode, here, box);
+    }
+    for (const child of (_b = vnode.children) !== null && _b !== void 0 ? _b : []) {
+        if (child && typeof child === 'object')
+            walk(child, here, box, scopeKeys, inScope);
+    }
+}
+/** `blur(4px)` → 4. The renderer's node shadow declares its blur this way. */
+function blurRadius(filter) {
+    if (typeof filter !== 'string')
+        return 0;
+    const match = /blur\(\s*([\d.]+)/.exec(filter);
+    return match ? Number(match[1]) : 0;
+}
+/** Union THIS element's own geometry (not its children's) into the box. */
+function addGeometry(vnode, m, box) {
+    var _a, _b, _c;
+    const props = (_a = vnode.props) !== null && _a !== void 0 ? _a : {};
+    // A stroke straddles the path: half of it lies outside the geometry. Ignoring it
+    // shaves half a stroke off every edge of the export.
+    const strokeWidth = props['stroke'] && props['stroke'] !== 'none' ? num((_b = props['strokeWidth']) !== null && _b !== void 0 ? _b : props['stroke-width'], 0) : 0;
+    // A BLUR paints outside its geometry — that is what a blur is. The node shadow is
+    // `filter: blur(4px)` on an offset rect, so a tight crop that ignored the blur
+    // would shave the soft edge off the shadow on the right and bottom of the diagram.
+    // Expanding by the radius is a slight over-estimate (the visible tail is shorter),
+    // which is the safe direction for an export box.
+    // The blur may arrive as the SVG attribute OR inside the style object — the
+    // renderer moved the node shadow to `style.filter` (the attribute form never
+    // actually blurred in browsers; only url(#…) applies there).
+    const styleFilter = (_c = props['style']) === null || _c === void 0 ? void 0 : _c['filter'];
+    const pad = strokeWidth / 2 + Math.max(blurRadius(props['filter']), blurRadius(styleFilter));
+    switch (vnode.type) {
+        case 'rect': {
+            const x = num(props['x']);
+            const y = num(props['y']);
+            box.addBox(m, x - pad, y - pad, num(props['width']) + pad * 2, num(props['height']) + pad * 2);
+            break;
+        }
+        case 'circle': {
+            const cx = num(props['cx']);
+            const cy = num(props['cy']);
+            const r = num(props['r']) + pad;
+            box.addBox(m, cx - r, cy - r, r * 2, r * 2);
+            break;
+        }
+        case 'ellipse': {
+            const cx = num(props['cx']);
+            const cy = num(props['cy']);
+            const rx = num(props['rx']) + pad;
+            const ry = num(props['ry']) + pad;
+            box.addBox(m, cx - rx, cy - ry, rx * 2, ry * 2);
+            break;
+        }
+        case 'line': {
+            box.addBox(m, Math.min(num(props['x1']), num(props['x2'])) - pad, Math.min(num(props['y1']), num(props['y2'])) - pad, Math.abs(num(props['x2']) - num(props['x1'])) + pad * 2, Math.abs(num(props['y2']) - num(props['y1'])) + pad * 2);
+            break;
+        }
+        case 'polyline':
+        case 'polygon': {
+            for (const [x, y] of parsePoints(props['points'])) {
+                box.addBox(m, x - pad, y - pad, pad * 2, pad * 2);
+            }
+            break;
+        }
+        case 'path': {
+            const d = props['d'];
+            if (typeof d !== 'string' || d.trim() === '')
+                break;
+            // parsePath turns arcs into cubics and resolves the smooth shorthands; pathBounds
+            // then FLATTENS the curves, so this is the true ink box — not a control-point
+            // over-approximation. (An arc's `large`/`sweep` flags are 0/1, and a naive pairwise
+            // scan of `d` reads them as the point (1,0) and drags the box to the origin. Using
+            // the real parser is what makes that class of bug impossible here.)
+            const bounds = (0, path_geometry_1.pathBounds)((0, path_geometry_1.transformCmds)((0, path_geometry_1.parsePath)(d), m));
+            if (bounds) {
+                box.addPoint(path_geometry_1.IDENTITY, bounds.minX - pad, bounds.minY - pad);
+                box.addPoint(path_geometry_1.IDENTITY, bounds.maxX + pad, bounds.maxY + pad);
+            }
+            break;
+        }
+        case 'text': {
+            const t = textBox(vnode);
+            if (t)
+                box.addBox(m, t.x, t.y, t.width, t.height);
+            break;
+        }
+        case 'image':
+        case 'foreignObject': {
+            box.addBox(m, num(props['x']), num(props['y']), num(props['width']), num(props['height']));
+            break;
+        }
+        // 'g', 'svg', 'tspan' and anything else: no geometry of its own. `tspan`
+        // positions are already covered by the parent <text>'s multi-line estimate.
+        default:
+            break;
+    }
+}
+/** The default cap on an exported raster's pixel size, per side. */
+exports.DEFAULT_MAX_OUTPUT_SIZE = 4000;
+/**
+ * Clamp an export's PIXEL size.
+ *
+ * A 3x export of a big diagram is how you ask a browser for a 30000 × 20000 canvas
+ * and get back a blank image — canvas has a hard area/side limit (~16k on most
+ * engines, less on Safari/mobile), and it fails SILENTLY: `toDataURL` hands you a
+ * blank or throws deep inside the driver. So we cap the output and REDUCE THE SCALE
+ * to fit, rather than emitting a request we know will fail.
+ *
+ * Reducing scale (not cropping) is the right lever: it keeps the whole picture and
+ * only spends fewer pixels on it, which is exactly the trade a caller who asked for
+ * "3x, and it must fit" wants.
+ *
+ * `minSize` floors the result so a tiny diagram still yields a usable image rather
+ * than a 12 × 8 sliver.
+ */
+function clampOutputSize(width, height, requestedScale, maxSize = exports.DEFAULT_MAX_OUTPUT_SIZE, minSize = 1) {
+    const scale = requestedScale > 0 ? requestedScale : 1;
+    const safeMax = maxSize > 0 ? maxSize : exports.DEFAULT_MAX_OUTPUT_SIZE;
+    let outWidth = width * scale;
+    let outHeight = height * scale;
+    // Scale UP a sliver to the floor, keeping the aspect ratio.
+    let effective = scale;
+    const longestMin = Math.max(outWidth, outHeight);
+    if (longestMin > 0 && minSize > 1 && longestMin < minSize) {
+        const up = minSize / longestMin;
+        effective *= up;
+        outWidth *= up;
+        outHeight *= up;
+    }
+    const longest = Math.max(outWidth, outHeight);
+    if (longest <= safeMax) {
+        return { scale: effective, width: outWidth, height: outHeight };
+    }
+    const shrink = safeMax / longest;
+    const clamped = effective * shrink;
+    return {
+        scale: clamped,
+        width: outWidth * shrink,
+        height: outHeight * shrink,
+        warning: `export size ${Math.round(outWidth)}×${Math.round(outHeight)}px exceeds the ${safeMax}px cap — ` +
+            `scale reduced ${effective.toFixed(2)} → ${clamped.toFixed(2)}. Raise options.maxSize to override ` +
+            `(note: browsers refuse very large canvases, often silently).`,
+    };
+}
+/** Grow a rectangle by `padding` on every side. */
+function padRect(rect, padding) {
+    return {
+        x: rect.x - padding,
+        y: rect.y - padding,
+        width: rect.width + padding * 2,
+        height: rect.height + padding * 2,
+    };
+}
+//# sourceMappingURL=bounds.js.map

package/src/libs/renderer/src/export/bounds.js.map

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

package/src/libs/renderer/src/export/capture-host.d.ts

@@ -0,0 +1,39 @@
+import type { Rectangle } from '../types/geometry.types';
+import type { CustomNodeCapture } from './custom-nodes';
+export interface CaptureHostOptions {
+    /**
+     * The camera zoom the html layer is transformed by. Client rects are SCREEN space,
+     * so they are divided by this to get the host-local layout coordinates the export
+     * needs. Defaults to being inferred from the host itself, which is more reliable
+     * than trusting a caller to remember.
+     */
+    scale?: number;
+    /** Safety valve for a pathologically deep host. Default 4000 elements. */
+    maxElements?: number;
+}
+/**
+ * Capture ONE custom node's host into plain data.
+ *
+ * Never throws: an export must not be taken down by a host in a state we did not
+ * anticipate. A failed capture degrades to `fidelity: 'empty'`, which the pure layer
+ * turns into a marked box and a warning — the whole point being that a blank is never
+ * silent.
+ */
+export declare function captureCustomNodeHost(id: string, rect: Rectangle, host: unknown, options?: CaptureHostOptions): CustomNodeCapture;
+/**
+ * The capture-time verdict on an external image, EXPORTED because the async export path
+ * revises it: `await export(…)` fetches external URLs (environment fetch, then
+ * `ExportOptions.assetFetcher`) and STRIPS this warning from any capture whose images it
+ * embedded — see `stripResolvedImageWarnings`. The synchronous entry points cannot fetch,
+ * so for them this text is the whole truth, and it names the way out.
+ */
+export declare const IMAGE_PDF_WARNING: string;
+/** Companion caveat from `resolveImageHref` — same lifecycle as {@link IMAGE_PDF_WARNING}. */
+export declare const IMAGE_NOT_INLINED_WARNING: string;
+/**
+ * Remove the two external-image caveats from a capture's warning — called by the async
+ * export AFTER it embedded every external image the capture held, at which point both
+ * sentences assert a problem that no longer exists (the same defect, mirrored, as
+ * staying silent about one that does). Returns undefined when nothing else remains.
+ */
+export declare function stripResolvedImageWarnings(warning: string | undefined): string | undefined;