@rasamjs/tools 0.0.0-stage → 0.2.0

package/dist/snapping/spacing.js

@@ -0,0 +1,127 @@
+import { lowerBound } from './lines.js';
+const extent = { x: 'width', y: 'height' };
+const end = (box, axis) => box[axis] + box[extent[axis]];
+const across = (axis) => (axis === 'x' ? 'y' : 'x');
+const overlaps = (a, b, axis) => a[axis] <= end(b, axis) && b[axis] <= end(a, axis);
+const middle = (a, b, axis) => (Math.max(a[axis], b[axis]) + Math.min(end(a, axis), end(b, axis))) / 2;
+/**
+ * Only gaps after the furthest preceding overlapping box are unobstructed. Boxes that
+ * contain the next box on this axis are backgrounds, not obstructions.
+ */
+function referenceGaps(targets, axis) {
+    const gaps = [];
+    // Far edges ascending; equal edges scan the earliest document target first.
+    const ordered = targets
+        .map((box, order) => ({ box, order, value: end(box, axis) }))
+        .sort((a, b) => a.value - b.value || b.order - a.order);
+    for (const next of targets)
+        for (let index = lowerBound(ordered, end(next, axis)) - 1; index >= 0; index--) {
+            const previous = ordered[index];
+            if (previous.box[axis] >= next[axis] || !overlaps(previous.box, next, across(axis)))
+                continue;
+            if (previous.value < next[axis])
+                gaps.push({
+                    from: previous.value,
+                    to: next[axis],
+                    at: middle(previous.box, next, across(axis)),
+                });
+            break;
+        }
+    return gaps;
+}
+function projectedBox(setup, offset, centered = setup.centered) {
+    const box = { ...setup.box };
+    for (const axis of ['x', 'y']) {
+        if (setup.kind !== 'resize') {
+            box[axis] += offset[axis];
+            continue;
+        }
+        const feature = setup.features[axis][0];
+        if (!feature)
+            continue;
+        const start = setup.box[axis], finish = end(setup.box, axis);
+        const fixed = Math.abs(feature.value - start) < Math.abs(feature.value - finish) ? finish : start;
+        const opposite = fixed - (centered ? offset[axis] : 0), active = feature.value + offset[axis];
+        box[axis] = Math.min(active, opposite);
+        box[extent[axis]] = Math.abs(active - opposite);
+    }
+    return box;
+}
+/** Targets that contain the box on this axis (backgrounds, panels) are not neighbors. */
+function neighbors(box, targets, axis) {
+    let left = -1, right = -1;
+    targets.forEach((target, index) => {
+        if (!overlaps(box, target, across(axis)))
+            return;
+        const before = target[axis] <= box[axis], after = end(target, axis) >= end(box, axis);
+        if (before && after)
+            return;
+        if (before && (left < 0 || end(target, axis) > end(targets[left], axis)))
+            left = index;
+        if (after && (right < 0 || target[axis] < targets[right][axis]))
+            right = index;
+    });
+    return [left, right];
+}
+/** Snapshot once; pointer queries scan cached boxes/gaps without any DOM reads. */
+export function createSpacing(input) {
+    const setup = {
+        ...input,
+        box: { ...input.box },
+        targets: input.targets.map((box) => ({ ...box })),
+    };
+    const references = { x: referenceGaps(setup.targets, 'x'), y: referenceGaps(setup.targets, 'y') };
+    if (!references.x.length && !references.y.length)
+        return null;
+    return ({ axis, offset, tolerance, centered = setup.centered }) => {
+        const resizing = setup.kind === 'resize', feature = setup.features[axis][0];
+        if (resizing && !feature)
+            return null;
+        const box = projectedBox(setup, offset, centered), [left, right] = neighbors(box, setup.targets, axis);
+        const active = feature && feature.value + offset[axis];
+        const dragged = resizing && active > box[axis] ? 'after' : 'before';
+        let best = null;
+        const mark = (next, side) => {
+            const index = side === 'before' ? left : right, neighbor = setup.targets[index];
+            return {
+                from: side === 'before' ? end(neighbor, axis) : end(next, axis),
+                to: side === 'before' ? next[axis] : neighbor[axis],
+                at: middle(next, neighbor, across(axis)),
+                moving: side === 'before' ? 'to' : 'from',
+                neighbor: index,
+            };
+        };
+        const offer = (delta, side, reference) => {
+            if (Math.abs(delta) > tolerance || (best && Math.abs(delta) >= Math.abs(best.delta)))
+                return;
+            const next = projectedBox(setup, { ...offset, [axis]: offset[axis] + delta }, centered);
+            const target = side === 'before' ? next[axis] : end(next, axis);
+            if (resizing && Math.abs(active + delta - target) > 1e-7)
+                return;
+            const gaps = reference
+                ? [reference, mark(next, side)]
+                : [mark(next, 'before'), mark(next, 'after')];
+            const length = gaps[0].to - gaps[0].from;
+            if (length <= 0 ||
+                gaps.some((gap) => Math.abs(gap.to - gap.from - length) > 1e-7 * Math.max(1, length)))
+                return;
+            best = { delta, target, order: side === 'before' ? left : right, grid: false, gaps };
+        };
+        if (left >= 0 && right >= 0 && left !== right) {
+            const before = box[axis] - end(setup.targets[left], axis), after = setup.targets[right][axis] - end(box, axis);
+            let delta = (after - before) / 2;
+            if (resizing)
+                delta = centered ? 0 : after - before;
+            offer(delta, dragged);
+        }
+        for (const reference of references[axis]) {
+            const length = reference.to - reference.from;
+            if (left >= 0 && (!resizing || dragged === 'before'))
+                offer(end(setup.targets[left], axis) + length - box[axis], 'before', reference);
+            if (right >= 0 && (!resizing || dragged === 'after'))
+                offer(setup.targets[right][axis] - length - end(box, axis), 'after', reference);
+        }
+        return best;
+    };
+}
+//# sourceMappingURL=spacing.js.map

package/dist/snapping/spacing.js.map

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

package/dist/snapping/targets.d.ts

@@ -0,0 +1,7 @@
+import type { AnyNode, Box, Svg } from '@rasamjs/core';
+import type { ResolvedOptions } from './options.js';
+export declare function validateNodes(nodes: readonly AnyNode[], drawing: Svg): void;
+export declare function movingBox(nodes: readonly AnyNode[], drawing: Svg): Box | null;
+export declare function targetNodes(drawing: Svg, nodes: readonly AnyNode[], options: ResolvedOptions): AnyNode[];
+export declare function measureTargets(drawing: Svg, nodes: readonly AnyNode[], options: ResolvedOptions): Box[];
+//# sourceMappingURL=targets.d.ts.map

package/dist/snapping/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/snapping/targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAW3E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAgB7E;AAWD,wBAAgB,WAAW,CACzB,OAAO,EAAE,GAAG,EACZ,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,OAAO,EAAE,eAAe,GACvB,OAAO,EAAE,CAwBX;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,GAAG,EACZ,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,OAAO,EAAE,eAAe,GACvB,GAAG,EAAE,CAQP"}

package/dist/snapping/targets.js

@@ -0,0 +1,71 @@
+import { Guards } from '@rasamjs/core/advanced';
+import { boundsIn } from '@rasamjs/core/viewport';
+export function validateNodes(nodes, drawing) {
+    if (!Array.isArray(nodes))
+        throw new TypeError('Snap nodes must be an array');
+    for (const node of nodes)
+        if (!Guards.isTransformable(node) ||
+            node.isDestroyed ||
+            node === drawing ||
+            node.context !== drawing.context ||
+            !drawing.el.contains(node.el))
+            throw new TypeError('Snap nodes must be live shapes inside this drawing');
+}
+export function movingBox(nodes, drawing) {
+    let left = Infinity, top = Infinity, right = -Infinity, bottom = -Infinity;
+    for (const node of nodes) {
+        const bounds = boundsIn(node, drawing);
+        if (bounds.status === 'unavailable')
+            return null;
+        if (!('box' in bounds))
+            continue;
+        const box = bounds.box;
+        left = Math.min(left, box.x);
+        top = Math.min(top, box.y);
+        right = Math.max(right, box.x + box.width);
+        bottom = Math.max(bottom, box.y + box.height);
+    }
+    return left === Infinity ? null : { x: left, y: top, width: right - left, height: bottom - top };
+}
+function visible(node) {
+    const view = node.el.ownerDocument.defaultView;
+    const visibility = view.getComputedStyle(node.el).visibility;
+    if (visibility === 'hidden' || visibility === 'collapse')
+        return false;
+    for (let element = node.el; element; element = element.parentElement)
+        if (view.getComputedStyle(element).display === 'none')
+            return false;
+    return true;
+}
+export function targetNodes(drawing, nodes, options) {
+    const candidates = options.targets
+        ? options.targets(nodes)
+        : nodes.length
+            ? nodes.flatMap((node) => node.parent?.children ?? [])
+            : drawing.children;
+    const eligible = new Set();
+    for (const node of candidates) {
+        if (!Guards.isTransformable(node) ||
+            node.isDestroyed ||
+            node.context !== drawing.context ||
+            !drawing.el.contains(node.el) ||
+            nodes.some((selected) => node.el.contains(selected.el) || selected.el.contains(node.el)) ||
+            !visible(node))
+            continue;
+        eligible.add(node);
+    }
+    // All eligible nodes are attached to the same document; bit 4 means FOLLOWING.
+    const ordered = [...eligible].sort((a, b) => a === b ? 0 : a.el.compareDocumentPosition(b.el) & 4 ? -1 : 1);
+    return ordered;
+}
+export function measureTargets(drawing, nodes, options) {
+    const boxes = [];
+    const ordered = targetNodes(drawing, nodes, options);
+    for (const node of ordered) {
+        const bounds = boundsIn(node, drawing);
+        if ('box' in bounds)
+            boxes.push(bounds.box);
+    }
+    return boxes;
+}
+//# sourceMappingURL=targets.js.map

package/dist/snapping/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/snapping/targets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,UAAU,aAAa,CAAC,KAAyB,EAAE,OAAY;IACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;IAC9E,KAAK,MAAM,IAAI,IAAI,KAAK;QACtB,IACE,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC;YAC7B,IAAI,CAAC,WAAW;YAChB,IAAI,KAAK,OAAO;YAChB,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;YAChC,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAE7B,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAyB,EAAE,OAAY;IAC/D,IAAI,IAAI,GAAG,QAAQ,EACjB,GAAG,GAAG,QAAQ,EACd,KAAK,GAAG,CAAC,QAAQ,EACjB,MAAM,GAAG,CAAC,QAAQ,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC;YAAE,SAAS;QACjC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACvB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7B,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC;AACnG,CAAC;AAED,SAAS,OAAO,CAAC,IAAa;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,WAAY,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IAC7D,IAAI,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACvE,KAAK,IAAI,OAAO,GAAmB,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa;QAClF,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAY,EACZ,KAAyB,EACzB,OAAwB;IAExB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO;QAChC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QACxB,CAAC,CAAC,KAAK,CAAC,MAAM;YACZ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,EAAE,CAAC;YACtD,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACvB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IACE,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC;YAC7B,IAAI,CAAC,WAAW;YAChB,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;YAChC,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxF,CAAC,OAAO,CAAC,IAAI,CAAC;YAEd,SAAS;QACX,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,+EAA+E;IAC/E,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC1C,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC9D,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAY,EACZ,KAAyB,EACzB,OAAwB;IAExB,MAAM,KAAK,GAAU,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,IAAI,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/snapping/types.d.ts

@@ -0,0 +1,35 @@
+import type { AnyNode, Point } from '@rasamjs/core';
+export interface SnapperOptions {
+    readonly tolerance?: number;
+    readonly shapes?: boolean;
+    readonly spacing?: boolean;
+    readonly grid?: number | {
+        readonly size: number;
+        readonly origin?: Point;
+    } | null;
+    readonly targets?: (nodes: readonly AnyNode[]) => Iterable<AnyNode>;
+    readonly modifier?: 'ctrl' | 'none';
+    readonly style?: {
+        readonly stroke?: string;
+        readonly gapStroke?: string;
+    };
+}
+export type SnapRequest = {
+    readonly kind: 'point';
+    readonly client: Point;
+} | {
+    readonly kind: 'move' | 'resize';
+    readonly nodes: readonly AnyNode[];
+    readonly client: Point;
+    readonly corners: readonly Point[];
+    readonly anchor?: Point;
+    readonly centered?: boolean;
+};
+export interface SnapSession {
+    snap(client: Point, modifiers: {
+        readonly ignore: boolean;
+        readonly centered?: boolean;
+    }): Point;
+    end(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/snapping/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/snapping/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,IAAI,CAAC;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAA;CAAE,GAClD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK,CAAC;IACjG,GAAG,IAAI,IAAI,CAAC;CACb"}

package/dist/snapping/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/snapping/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/snapping/types.ts"],"names":[],"mappings":""}

package/dist/snapping.d.ts

@@ -0,0 +1,4 @@
+/** Opt-in snapping tools for rasam drawings. */
+export { Snapper } from './snapping/snapper.js';
+export type { SnapperOptions, SnapRequest, SnapSession } from './snapping/types.js';
+//# sourceMappingURL=snapping.d.ts.map

package/dist/snapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapping.d.ts","sourceRoot":"","sources":["../src/snapping.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/snapping.js

@@ -0,0 +1,3 @@
+/** Opt-in snapping tools for rasam drawings. */
+export { Snapper } from './snapping/snapper.js';
+//# sourceMappingURL=snapping.js.map

package/dist/snapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapping.js","sourceRoot":"","sources":["../src/snapping.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "@rasamjs/tools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Opt-in editing tools for rasam SVG drawings.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hdevlop/rasam.git",
+    "directory": "packages/tools"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "API.md",
+    "CHANGELOG.md",
+    "RELEASING.md",
+    "LICENSE"
+  ],
+  "exports": {
+    "./snapping": {
+      "rasam-source": "./src/snapping.ts",
+      "types": "./dist/snapping.d.ts",
+      "import": "./dist/snapping.js"
+    },
+    "./snapping/advanced": {
+      "rasam-source": "./src/snapping/advanced.ts",
+      "types": "./dist/snapping/advanced.d.ts",
+      "import": "./dist/snapping/advanced.js"
+    },
+    "./grid": {
+      "rasam-source": "./src/grid.ts",
+      "types": "./dist/grid.d.ts",
+      "import": "./dist/grid.js"
+    },
+    "./rulers": {
+      "rasam-source": "./src/rulers.ts",
+      "types": "./dist/rulers.d.ts",
+      "import": "./dist/rulers.js"
+    },
+    "./drawing": {
+      "rasam-source": "./src/drawing.ts",
+      "types": "./dist/drawing.d.ts",
+      "import": "./dist/drawing.js"
+    }
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@rasamjs/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@rasamjs/core": "0.1.2",
+    "@rasamjs/history": "0.1.0",
+    "@rasamjs/selection": "0.3.0",
+    "@rasamjs/transformer": "0.4.0",
+    "@rasamjs/viewport": "0.1.0"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "typecheck": "tsc -p tsconfig.check.json",
+    "test": "vitest run",
+    "test:browser": "playwright test",
+    "dev": "vite --host 127.0.0.1",
+    "format": "prettier --write src tests scripts fixtures examples *.json *.ts *.md",
+    "format:check": "prettier --check src tests scripts fixtures examples *.json *.ts *.md",
+    "check:consumer": "node scripts/check-consumer.mjs",
+    "check:docs": "node scripts/check-docs.mjs",
+    "check:size": "node scripts/check-size.mjs",
+    "release:check": "node scripts/check-release.mjs",
+    "api:check": "node scripts/check-api.mjs",
+    "api:update": "node scripts/check-api.mjs --update",
+    "bench:drag": "node scripts/benchmark-drag.mjs"
+  }
+}

package/src/advanced/context.ts

@@ -0,0 +1,15 @@
+import type { Svg } from '@rasamjs/core';
+import type { ResolvedOptions } from '../snapping/options.js';
+import type { GuideOverlay } from '../snapping/overlay.js';
+import type { AdvancedSnapperOptions } from './types.js';
+
+export interface SessionContext<Request> {
+  readonly drawing: Svg;
+  readonly options: ResolvedOptions;
+  readonly advanced: AdvancedSnapperOptions;
+  readonly overlay: GuideOverlay;
+  readonly request: Request;
+  readonly isEnabled: () => boolean;
+  readonly isCurrent: () => boolean;
+  readonly onEnd: () => void;
+}

package/src/advanced/curves.ts

@@ -0,0 +1,65 @@
+import { PathArray } from '@rasamjs/core';
+import type { AnyNode, Svg, PathCommand } from '@rasamjs/core';
+import { Guards } from '@rasamjs/core/advanced';
+import { clientMatrix } from './geometry.js';
+import type { Segment } from './geometry.js';
+
+function subpaths(geometry: SVGGeometryElement): SVGGeometryElement[] {
+  if (geometry.localName !== 'path') return [geometry];
+  const parts: PathCommand[][] = [];
+  for (const command of new PathArray(geometry.getAttribute('d') ?? '').toArray()) {
+    if (command[0] === 'M') parts.push([]);
+    parts.at(-1)!.push(command);
+  }
+  return parts.map((commands) => {
+    const path = geometry.cloneNode(false) as SVGGeometryElement;
+    path.setAttribute('d', new PathArray(commands).toString());
+    return path;
+  });
+}
+
+/** Detached geometry is sampled once: target edits never change an active session. */
+export function curveSegments(
+  drawing: Svg,
+  nodes: readonly AnyNode[],
+  resolution: number,
+): Segment[] {
+  const root = drawing.worldMatrix().inverse(),
+    screen = clientMatrix(drawing);
+  if (!root || !screen) return [];
+  const segments: Segment[] = [];
+  for (const node of nodes) {
+    if (!Guards.isTransformable(node)) continue;
+    if (!['path', 'line', 'polyline', 'polygon', 'circle', 'ellipse'].includes(node.el.localName))
+      continue;
+    node.flush();
+    const geometry = node.el.cloneNode(false) as SVGGeometryElement;
+    if (typeof geometry.getTotalLength !== 'function') continue;
+    const matrix = root.multiply(node.worldMatrix());
+    const pixels = screen.multiply(matrix);
+    const stretch = Math.hypot(pixels.a, pixels.b, pixels.c, pixels.d);
+    let parts: SVGGeometryElement[];
+    try {
+      parts = subpaths(geometry);
+    } catch {
+      continue;
+    }
+    for (const part of parts) {
+      let length: number;
+      try {
+        length = part.getTotalLength();
+      } catch {
+        continue;
+      }
+      if (!Number.isFinite(length) || length <= 0) continue;
+      const count = Math.max(1, Math.min(8192, Math.ceil((length * stretch) / resolution)));
+      let previous = matrix.apply(part.getPointAtLength(0));
+      for (let index = 1; index <= count; index++) {
+        const next = matrix.apply(part.getPointAtLength((length * index) / count));
+        segments.push([previous, next]);
+        previous = next;
+      }
+    }
+  }
+  return segments;
+}

package/src/advanced/geometry.ts

@@ -0,0 +1,74 @@
+import { Matrix } from '@rasamjs/core';
+import type { Point, Svg } from '@rasamjs/core';
+
+export type Segment = readonly [Point, Point];
+export const add = (a: Point, b: Point): Point => ({ x: a.x + b.x, y: a.y + b.y });
+export const subtract = (a: Point, b: Point): Point => ({ x: a.x - b.x, y: a.y - b.y });
+export const scale = (p: Point, value: number): Point => ({ x: p.x * value, y: p.y * value });
+const cross = (a: Point, b: Point) => a.x * b.y - a.y * b.x;
+
+/** The closest point on cached segments, optionally restricted to a resize line. */
+export function nearestOnSegments(
+  point: Point,
+  segments: readonly Segment[],
+  direction?: Point,
+): Point | null {
+  let best: Point | null = null,
+    distance = Infinity;
+  for (const [a, b] of segments) {
+    const edge = subtract(b, a),
+      relative = subtract(a, point);
+    let candidate: Point;
+    const determinant = direction && cross(direction, edge);
+    if (direction && Math.abs(determinant!) > 1e-12) {
+      const along = cross(relative, direction) / determinant!;
+      if (along < 0 || along > 1) continue;
+      candidate = add(point, scale(direction, cross(relative, edge) / determinant!));
+    } else {
+      if (direction && Math.abs(cross(relative, direction)) > 1e-9) continue;
+      const length = edge.x * edge.x + edge.y * edge.y;
+      const t = length
+        ? Math.max(0, Math.min(1, ((point.x - a.x) * edge.x + (point.y - a.y) * edge.y) / length))
+        : 0;
+      candidate = add(a, scale(edge, t));
+    }
+    const next = Math.hypot(candidate.x - point.x, candidate.y - point.y);
+    if (next < distance) {
+      best = candidate;
+      distance = next;
+    }
+  }
+  return best;
+}
+
+/** Root-to-client mapping is read once per sample, never once per target segment. */
+export function clientMatrix(drawing: Svg): Matrix | null {
+  const a = drawing.toClient({ x: 0, y: 0 });
+  const b = drawing.toClient({ x: 1, y: 0 });
+  const c = drawing.toClient({ x: 0, y: 1 });
+  return a && b && c ? new Matrix(b.x - a.x, b.y - a.y, c.x - a.x, c.y - a.y, a.x, a.y) : null;
+}
+
+export function frameConstraint(corners: readonly Point[], anchor: Point) {
+  const [a, b, , d] = corners;
+  const u = subtract(b, a),
+    v = subtract(d, a);
+  const inverse = new Matrix(u.x, u.y, v.x, v.y, 0, 0).inverse();
+  if (!inverse) return null;
+  const point = add(a, add(scale(u, anchor.x), scale(v, anchor.y)));
+  const direction = anchor.x === 0.5 ? v : anchor.y === 0.5 ? u : undefined;
+  return {
+    point,
+    direction,
+    project(delta: Point): Point {
+      const unit = inverse.apply(delta);
+      return add(
+        point,
+        add(scale(u, anchor.x === 0.5 ? 0 : unit.x), scale(v, anchor.y === 0.5 ? 0 : unit.y)),
+      );
+    },
+  };
+}
+
+export const angleDifference = (a: number, b: number, period = 360): number =>
+  ((((a - b + period * 1.5) % period) + period) % period) - period / 2;

package/src/advanced/rotation.ts

@@ -0,0 +1,93 @@
+import { Matrix } from '@rasamjs/core';
+import type { Point } from '@rasamjs/core';
+import { Guards } from '@rasamjs/core/advanced';
+import { assertPoint } from '../snapping/options.js';
+import { targetNodes, validateNodes } from '../snapping/targets.js';
+import { add, subtract, angleDifference } from './geometry.js';
+import type { SessionContext } from './context.js';
+import type { RotationSnapRequest, RotationSnapSession } from './types.js';
+
+export function createRotationSession(
+  context: SessionContext<RotationSnapRequest>,
+): RotationSnapSession | null {
+  const { request } = context;
+  validateNodes(request.nodes, context.drawing);
+  assertPoint(request.client);
+  assertPoint(request.pivot);
+  if (request.corners.length !== 4) throw new TypeError('Rotation needs four corners');
+  const root = context.drawing.worldMatrix().inverse();
+  const pivot = context.drawing.fromClient(request.pivot),
+    start = context.drawing.fromClient(request.client);
+  const corners = request.corners.map((p) => context.drawing.fromClient(p));
+  if (!root || !pivot || !start || corners.some((p) => !p)) return null;
+  const parent =
+    request.nodes.length === 1 && Guards.isTransformable(request.nodes[0].parent)
+      ? root.multiply(request.nodes[0].parent.worldMatrix())
+      : Matrix.identity();
+  const inverse = parent.inverse();
+  if (!inverse) return null;
+  const vector = (p: Point) => subtract(inverse.apply(add(p, pivot)), inverse.apply(pivot));
+  const first = vector(subtract(corners[1]!, corners[0]!));
+  const startAngle = Math.atan2(vector(subtract(start, pivot)).y, vector(subtract(start, pivot)).x);
+  const frameAngle = Math.atan2(first.y, first.x);
+  const angles = targetNodes(context.drawing, request.nodes, context.options).flatMap((node) => {
+    if (!Guards.isTransformable(node)) return [];
+    const matrix = root.multiply(node.worldMatrix());
+    return [Math.atan2(matrix.b, matrix.a)];
+  });
+  if (!angles.length || !context.isCurrent() || !context.isEnabled()) return null;
+  let ended = false,
+    snapped = false;
+  const session: RotationSnapSession = {
+    get angleSnapped() {
+      return snapped;
+    },
+    snap: (client, modifiers) => {
+      assertPoint(client);
+      snapped = false;
+      if (
+        ended ||
+        !context.isEnabled() ||
+        (modifiers.ignore && context.options.modifier !== 'none')
+      )
+        return client;
+      const current = context.drawing.fromClient(client);
+      if (!current) return client;
+      const local = vector(subtract(current, pivot));
+      const proposed = frameAngle + Math.atan2(local.y, local.x) - startAngle;
+      const mapped = subtract(
+        parent.apply({ x: Math.cos(proposed), y: Math.sin(proposed) }),
+        parent.apply({ x: 0, y: 0 }),
+      );
+      const visual = Math.atan2(mapped.y, mapped.x);
+      let best: number | null = null,
+        distance = ((context.advanced.angleTolerance ?? 5) * Math.PI) / 180;
+      for (const target of angles) {
+        const next = Math.abs(angleDifference(target, visual, Math.PI));
+        if (next <= distance) {
+          distance = next;
+          best = target;
+        }
+      }
+      if (best === null) return client;
+      const target = vector({ x: Math.cos(best), y: Math.sin(best) });
+      const correction = angleDifference(Math.atan2(target.y, target.x), proposed, Math.PI);
+      const rotated = {
+        x: local.x * Math.cos(correction) - local.y * Math.sin(correction),
+        y: local.x * Math.sin(correction) + local.y * Math.cos(correction),
+      };
+      const offset = subtract(parent.apply(rotated), parent.apply({ x: 0, y: 0 }));
+      const result = context.drawing.toClient(add(pivot, offset));
+      snapped = !!result;
+      return result ?? client;
+    },
+    end: () => {
+      if (!ended) {
+        ended = true;
+        snapped = false;
+        context.onEnd();
+      }
+    },
+  };
+  return session;
+}