@forgecart/designer-runtime 1.0.0

package/dist/runtime/region/region-sampler.js

@@ -0,0 +1,100 @@
+import { distanceBetween, padBoundingBox, pointsBoundingBox, } from '../../util/geometry.util.js';
+/** Hard ceiling on covered cells before the sampler coarsens the grid. */
+const CELL_BUDGET = 600;
+/** A region larger than this multiple of the viewport area is rejected. */
+const MAX_VIEWPORT_AREA_FACTOR = 4;
+/** Upper bound on the polyline walk step, in CSS pixels. */
+const MAX_WALK_STEP = 16;
+/**
+ * Pure stroke-to-grid rasterizer for spray selection. The stroke is walked
+ * at a fixed step and every grid cell whose center lies within the spray
+ * radius of a step point is marked. The grid covers the stroke's padded
+ * bounding box; when the marked-cell count blows the budget the cell size is
+ * doubled and the stroke re-rasterized, trading sampling density for a
+ * bounded number of elementsFromPoint calls downstream.
+ */
+export class RegionSampler {
+    sample(stroke, radius, viewport) {
+        const padded = padBoundingBox(pointsBoundingBox(stroke), radius);
+        const viewportArea = viewport.width * viewport.height;
+        if (padded.width * padded.height > MAX_VIEWPORT_AREA_FACTOR * viewportArea) {
+            return { kind: 'too-large' };
+        }
+        const stepPoints = this.walkPolyline(stroke, Math.min(radius, MAX_WALK_STEP));
+        let cellSize = Math.max(8, radius / 2);
+        for (;;) {
+            const centers = this.rasterize(padded, cellSize, stepPoints, radius, viewport);
+            if (centers.length <= CELL_BUDGET)
+                return { kind: 'ok', cellCenters: centers, cellSize };
+            cellSize *= 2;
+        }
+    }
+    /**
+     * Resamples the stroke polyline at `step`-pixel intervals. Both endpoints
+     * of every segment are included; a single-point stroke yields that point,
+     * so a click-without-drag still samples around the click.
+     */
+    walkPolyline(stroke, step) {
+        if (stroke.length === 0)
+            return [];
+        const points = [stroke[0]];
+        for (let i = 1; i < stroke.length; i++) {
+            const from = stroke[i - 1];
+            const to = stroke[i];
+            const segments = Math.max(1, Math.ceil(distanceBetween(from, to) / step));
+            for (let s = 1; s <= segments; s++) {
+                const t = s / segments;
+                points.push({ x: from.x + (to.x - from.x) * t, y: from.y + (to.y - from.y) * t });
+            }
+        }
+        return points;
+    }
+    /**
+     * Marks the cells covered by the stroke. Instead of testing every grid
+     * cell against every step point, each step point only visits the cell
+     * window its radius can reach — O(steps × (radius / cellSize)²) — and the
+     * covered set is deduplicated through linear cell indices.
+     */
+    rasterize(box, cellSize, stepPoints, radius, viewport) {
+        const columns = Math.max(1, Math.ceil(box.width / cellSize));
+        const rows = Math.max(1, Math.ceil(box.height / cellSize));
+        const covered = new Set();
+        for (const point of stepPoints) {
+            const minColumn = this.clampIndex(Math.floor((point.x - radius - box.left) / cellSize), columns);
+            const maxColumn = this.clampIndex(Math.floor((point.x + radius - box.left) / cellSize), columns);
+            const minRow = this.clampIndex(Math.floor((point.y - radius - box.top) / cellSize), rows);
+            const maxRow = this.clampIndex(Math.floor((point.y + radius - box.top) / cellSize), rows);
+            for (let row = minRow; row <= maxRow; row++) {
+                for (let column = minColumn; column <= maxColumn; column++) {
+                    const center = this.cellCenter(box, cellSize, column, row);
+                    if (distanceBetween(center, point) <= radius)
+                        covered.add(row * columns + column);
+                }
+            }
+        }
+        const centers = [];
+        for (const index of covered) {
+            const center = this.cellCenter(box, cellSize, index % columns, Math.floor(index / columns));
+            if (this.isInsideViewport(center, viewport))
+                centers.push(center);
+        }
+        return centers;
+    }
+    cellCenter(box, cellSize, column, row) {
+        return {
+            x: box.left + (column + 0.5) * cellSize,
+            y: box.top + (row + 0.5) * cellSize,
+        };
+    }
+    clampIndex(index, count) {
+        if (index < 0)
+            return 0;
+        if (index > count - 1)
+            return count - 1;
+        return index;
+    }
+    isInsideViewport(point, viewport) {
+        return point.x >= 0 && point.x <= viewport.width && point.y >= 0 && point.y <= viewport.height;
+    }
+}
+//# sourceMappingURL=region-sampler.js.map

package/dist/runtime/region/region-sampler.js.map

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

package/dist/runtime/region/spray-region-resolver.d.ts

@@ -0,0 +1,53 @@
+import type { ElementDescriptor, Point, Rect } from '../../protocol/element.types.js';
+import type { ElementDescriptorExtractor } from '../descriptor/element-descriptor-extractor.js';
+import type { HitTester } from './dom-hit-tester.js';
+import type { ElementFilter } from './element-filter.js';
+import type { RegionSampler } from './region-sampler.js';
+/** A resolved spray region: descriptors plus the region's clamped bounds. */
+export interface RegionResolutionOk {
+    kind: 'ok';
+    elements: ElementDescriptor[];
+    regionBounds: Rect;
+    truncated: boolean;
+}
+/** The stroke's padded bounding box exceeds the region budget. */
+export interface RegionResolutionTooLarge {
+    kind: 'too-large';
+}
+export type RegionResolution = RegionResolutionOk | RegionResolutionTooLarge;
+/**
+ * The REGION_SELECT pipeline: rasterize the stroke into cell centers, stack
+ * hit-test every center, keep the meaningful elements, weigh coverage,
+ * collapse ancestor/descendant stacks, rank, cap and stamp the survivors
+ * with `data-fc-ref` so later HIGHLIGHT_SET / ELEMENT_BOUNDS_QUERY calls can
+ * address them.
+ *
+ * Ref stamps accumulate over the activation — earlier selections keep their
+ * refIds valid for already-open threads — and are stripped wholesale on
+ * DEACTIVATE. An element re-selected by a later spray keeps its existing
+ * stamp, so a refId never silently changes meaning; fresh stamps come from a
+ * per-resolver counter and stay unique across calls.
+ */
+export declare class SprayRegionResolver {
+    private readonly sampler;
+    private readonly hitTester;
+    private readonly filter;
+    private readonly extractor;
+    private readonly doc;
+    private refCounter;
+    constructor(sampler: RegionSampler, hitTester: HitTester, filter: ElementFilter, extractor: ElementDescriptorExtractor, doc: Document);
+    resolve(stroke: readonly Point[], radius: number, maxElements: number | undefined): RegionResolution;
+    /** Stack hit-test every cell center, accumulating cell indices per element. */
+    private collectHits;
+    /**
+     * Filters to meaningful elements and computes per-element coverage: the
+     * fraction of the sampled cell centers inside the element's bounds whose
+     * hit stack actually contained it.
+     */
+    private toCandidates;
+    private countCentersInside;
+    /** Reuses an element's existing ref stamp, or assigns the next unique one. */
+    private stampRef;
+    private getViewport;
+    private toRect;
+}

package/dist/runtime/region/spray-region-resolver.js

@@ -0,0 +1,113 @@
+import { REF_ATTRIBUTE } from '../../protocol/protocol.constant.js';
+import { clampRectToBounds, padBoundingBox, pointsBoundingBox, } from '../../util/geometry.util.js';
+/**
+ * The REGION_SELECT pipeline: rasterize the stroke into cell centers, stack
+ * hit-test every center, keep the meaningful elements, weigh coverage,
+ * collapse ancestor/descendant stacks, rank, cap and stamp the survivors
+ * with `data-fc-ref` so later HIGHLIGHT_SET / ELEMENT_BOUNDS_QUERY calls can
+ * address them.
+ *
+ * Ref stamps accumulate over the activation — earlier selections keep their
+ * refIds valid for already-open threads — and are stripped wholesale on
+ * DEACTIVATE. An element re-selected by a later spray keeps its existing
+ * stamp, so a refId never silently changes meaning; fresh stamps come from a
+ * per-resolver counter and stay unique across calls.
+ */
+export class SprayRegionResolver {
+    sampler;
+    hitTester;
+    filter;
+    extractor;
+    doc;
+    refCounter = 0;
+    constructor(sampler, hitTester, filter, extractor, doc) {
+        this.sampler = sampler;
+        this.hitTester = hitTester;
+        this.filter = filter;
+        this.extractor = extractor;
+        this.doc = doc;
+    }
+    resolve(stroke, radius, maxElements) {
+        const viewport = this.getViewport();
+        const sampled = this.sampler.sample(stroke, radius, viewport);
+        if (sampled.kind === 'too-large')
+            return { kind: 'too-large' };
+        const hits = this.collectHits(sampled.cellCenters);
+        const candidates = this.toCandidates(hits, sampled.cellCenters, viewport);
+        const survivors = this.filter.dedupeAncestors(candidates);
+        const ranked = this.filter.rankAndCap(survivors, maxElements);
+        const elements = ranked.candidates.map((candidate) => this.extractor.extract(candidate.element, this.stampRef(candidate.element), candidate.coverage));
+        return {
+            kind: 'ok',
+            elements,
+            regionBounds: clampRectToBounds(padBoundingBox(pointsBoundingBox(stroke), radius), viewport),
+            truncated: ranked.truncated,
+        };
+    }
+    /** Stack hit-test every cell center, accumulating cell indices per element. */
+    collectHits(cellCenters) {
+        const hits = new Map();
+        for (let index = 0; index < cellCenters.length; index++) {
+            for (const element of this.hitTester.elementsAt(cellCenters[index])) {
+                const cells = hits.get(element);
+                if (cells === undefined) {
+                    hits.set(element, new Set([index]));
+                    continue;
+                }
+                cells.add(index);
+            }
+        }
+        return hits;
+    }
+    /**
+     * Filters to meaningful elements and computes per-element coverage: the
+     * fraction of the sampled cell centers inside the element's bounds whose
+     * hit stack actually contained it.
+     */
+    toCandidates(hits, cellCenters, viewport) {
+        const candidates = [];
+        for (const [element, hitCells] of hits) {
+            if (!this.filter.isMeaningful(element, viewport))
+                continue;
+            const bounds = this.toRect(element.getBoundingClientRect());
+            const centersInside = this.countCentersInside(cellCenters, bounds);
+            candidates.push({
+                element,
+                bounds,
+                hitCells,
+                coverage: hitCells.size / Math.max(1, centersInside),
+            });
+        }
+        return candidates;
+    }
+    countCentersInside(cellCenters, bounds) {
+        let count = 0;
+        for (const center of cellCenters) {
+            if (center.x >= bounds.x &&
+                center.x <= bounds.x + bounds.width &&
+                center.y >= bounds.y &&
+                center.y <= bounds.y + bounds.height) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /** Reuses an element's existing ref stamp, or assigns the next unique one. */
+    stampRef(element) {
+        const existing = element.getAttribute(REF_ATTRIBUTE);
+        if (existing !== null && existing.length > 0)
+            return existing;
+        this.refCounter++;
+        const refId = `fcd-${String(this.refCounter)}`;
+        element.setAttribute(REF_ATTRIBUTE, refId);
+        return refId;
+    }
+    getViewport() {
+        const root = this.doc.documentElement;
+        return { width: root.clientWidth, height: root.clientHeight };
+    }
+    toRect(rect) {
+        return { x: rect.x, y: rect.y, width: rect.width, height: rect.height };
+    }
+}
+//# sourceMappingURL=spray-region-resolver.js.map

package/dist/runtime/region/spray-region-resolver.js.map

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

package/dist/util/geometry.util.d.ts

@@ -0,0 +1,29 @@
+import type { Point, Rect, Viewport } from '../protocol/element.types.js';
+/**
+ * An edge-addressed bounding box. Space-agnostic — works in overlay,
+ * viewport or world coordinates as long as all inputs share one space.
+ */
+export interface BoundingBox {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+/** Bounding box of a list of points in the same coordinate space. */
+export declare function pointsBoundingBox(points: readonly Point[]): BoundingBox;
+/**
+ * Pads a bounding box by `padding` pixels on each side and, when a
+ * `minWidth` / `minHeight` is provided, symmetrically widens the box so it
+ * is at least that large.
+ */
+export declare function padBoundingBox(box: BoundingBox, padding: number, minWidth?: number, minHeight?: number): BoundingBox;
+/** Pythagoras distance between two points. */
+export declare function distanceBetween(a: Point, b: Point): number;
+/**
+ * Clamps a bounding box to `bounds` (origin 0,0) and returns an integer
+ * `Rect` that is at least 1×1 — the shape handed to consumers that cannot
+ * deal with degenerate rectangles.
+ */
+export declare function clampRectToBounds(box: BoundingBox, bounds: Viewport): Rect;

package/dist/util/geometry.util.js

@@ -0,0 +1,68 @@
+/** Bounding box of a list of points in the same coordinate space. */
+export function pointsBoundingBox(points) {
+    if (points.length === 0) {
+        return { left: 0, top: 0, right: 0, bottom: 0, width: 0, height: 0 };
+    }
+    let left = points[0].x;
+    let right = points[0].x;
+    let top = points[0].y;
+    let bottom = points[0].y;
+    for (let i = 1; i < points.length; i++) {
+        const point = points[i];
+        if (point.x < left)
+            left = point.x;
+        if (point.x > right)
+            right = point.x;
+        if (point.y < top)
+            top = point.y;
+        if (point.y > bottom)
+            bottom = point.y;
+    }
+    return { left, top, right, bottom, width: right - left, height: bottom - top };
+}
+/**
+ * Pads a bounding box by `padding` pixels on each side and, when a
+ * `minWidth` / `minHeight` is provided, symmetrically widens the box so it
+ * is at least that large.
+ */
+export function padBoundingBox(box, padding, minWidth = 0, minHeight = 0) {
+    let left = box.left - padding;
+    let right = box.right + padding;
+    let top = box.top - padding;
+    let bottom = box.bottom + padding;
+    const widen = minWidth - (right - left);
+    if (widen > 0) {
+        left -= widen / 2;
+        right += widen / 2;
+    }
+    const heighten = minHeight - (bottom - top);
+    if (heighten > 0) {
+        top -= heighten / 2;
+        bottom += heighten / 2;
+    }
+    return { left, top, right, bottom, width: right - left, height: bottom - top };
+}
+/** Pythagoras distance between two points. */
+export function distanceBetween(a, b) {
+    const dx = a.x - b.x;
+    const dy = a.y - b.y;
+    return Math.sqrt(dx * dx + dy * dy);
+}
+/**
+ * Clamps a bounding box to `bounds` (origin 0,0) and returns an integer
+ * `Rect` that is at least 1×1 — the shape handed to consumers that cannot
+ * deal with degenerate rectangles.
+ */
+export function clampRectToBounds(box, bounds) {
+    const x = Math.max(0, Math.floor(box.left));
+    const y = Math.max(0, Math.floor(box.top));
+    const right = Math.min(bounds.width, Math.ceil(box.right));
+    const bottom = Math.min(bounds.height, Math.ceil(box.bottom));
+    return {
+        x,
+        y,
+        width: Math.max(1, right - x),
+        height: Math.max(1, bottom - y),
+    };
+}
+//# sourceMappingURL=geometry.util.js.map

package/dist/util/geometry.util.js.map

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

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@forgecart/designer-runtime",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "ForgeCart visual-editor guest runtime for tenant storefronts: dormant iframe protocol endpoint, spray-region element resolution, and the Turbopack data-fc-source stamping loader",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js",
+      "default": "./dist/protocol/index.js"
+    },
+    "./turbo-loader": {
+      "types": "./dist/loader-cjs/turbo-loader.d.ts",
+      "require": "./dist/loader-cjs/turbo-loader.js",
+      "default": "./dist/loader-cjs/turbo-loader.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@babel/parser": "^7.29.0",
+    "magic-string": "^0.30.21"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "forgecart",
+    "visual-editor",
+    "designer",
+    "iframe",
+    "turbopack",
+    "loader"
+  ],
+  "author": "ForgeCart",
+  "license": "MIT"
+}