@rasamjs/tools 0.0.0-stage → 0.1.0

package/dist/snapping/snapper.js

@@ -0,0 +1,140 @@
+import { Guards } from '@rasamjs/core/advanced';
+import { boxLines, targetLines } from './lines.js';
+import { assertPoint, resolveOptions } from './options.js';
+import { createSession, resizeLines } from './session.js';
+import { measureTargets, movingBox, validateNodes } from './targets.js';
+import { guideReader } from './guides.js';
+import { GuideOverlay } from './overlay.js';
+import { createSpacing } from './spacing.js';
+/** Owns snapping state for one mounted drawing. */
+export class Snapper {
+    drawing;
+    enabledState = true;
+    overlay;
+    stopDisposal;
+    options;
+    active = null;
+    sessionVersion = 0;
+    disposed = false;
+    constructor(drawing, options = {}) {
+        this.drawing = drawing;
+        if (!Guards.isTransformable(drawing) ||
+            drawing.isDestroyed ||
+            drawing.el.localName !== 'svg' ||
+            !drawing.el.isConnected ||
+            !drawing.el.ownerDocument.defaultView)
+            throw new TypeError('Snapper needs a live, mounted rasam SVG drawing');
+        this.options = resolveOptions(options);
+        this.overlay = new GuideOverlay(drawing, this.options.stroke, this.options.gapStroke);
+        this.stopDisposal = drawing.onDispose(() => this.destroy());
+    }
+    get isDestroyed() {
+        return this.disposed;
+    }
+    get enabled() {
+        return this.enabledState;
+    }
+    set enabled(value) {
+        if (typeof value !== 'boolean')
+            throw new TypeError('enabled must be a boolean');
+        this.enabledState = value;
+        if (!value)
+            this.overlay.clear();
+    }
+    update() {
+        if (!this.disposed)
+            this.overlay.update();
+        return this;
+    }
+    begin(request) {
+        const version = ++this.sessionVersion;
+        this.active?.end();
+        if (this.disposed || !this.enabled)
+            return null;
+        if (!request || !['move', 'resize', 'point'].includes(request.kind))
+            throw new TypeError('Unknown snap request kind');
+        assertPoint(request.client, 'Start pointer');
+        if (request.kind !== 'point')
+            validateNodes(request.nodes, this.drawing);
+        const start = this.drawing.fromClient(request.client);
+        if (!start)
+            return null;
+        const geometry = this.geometry(request, start);
+        if (!geometry)
+            return null;
+        const nodes = Object.freeze(request.kind === 'point' ? [] : [...new Set(request.nodes)]);
+        const targets = targetLines(this.options.shapes || this.options.spacing
+            ? measureTargets(this.drawing, nodes, this.options)
+            : []);
+        if (version !== this.sessionVersion || this.disposed || !this.enabled)
+            return null;
+        const spacing = this.options.spacing
+            ? createSpacing({
+                ...geometry,
+                targets: targets.boxes,
+                kind: request.kind,
+                centered: request.kind === 'resize' && request.centered,
+            })
+            : null;
+        if (!this.options.grid &&
+            !(this.options.shapes && (targets.x.length || targets.y.length)) &&
+            !spacing)
+            return null;
+        const read = guideReader(this.drawing, request, targets.boxes);
+        this.active = createSession({
+            start: { x: start.x, y: start.y },
+            features: geometry.features,
+            spacing,
+            targets,
+            mapping: this.drawing,
+            options: this.options,
+            isEnabled: () => this.enabled && !this.disposed,
+            onEnd: () => {
+                this.active = null;
+                this.overlay.clear();
+            },
+            onSnap: (matches, point) => {
+                if (version !== this.sessionVersion || this.disposed)
+                    return;
+                if (!point || !matches.some((match) => match))
+                    this.overlay.clear();
+                else
+                    this.overlay.show(() => read(matches, point));
+            },
+        });
+        return this.active;
+    }
+    geometry(request, start) {
+        const box = request.kind === 'point'
+            ? { ...start, width: 0, height: 0 }
+            : movingBox(request.nodes, this.drawing);
+        if (!box)
+            return null;
+        if (request.kind !== 'resize')
+            return { box, features: boxLines(box) };
+        if (!request.anchor ||
+            ![0, 0.5, 1].includes(request.anchor.x) ||
+            ![0, 0.5, 1].includes(request.anchor.y) ||
+            (request.anchor.x === 0.5 && request.anchor.y === 0.5))
+            throw new TypeError('Resize snapping needs a unit-frame edge or corner anchor');
+        if (!Array.isArray(request.corners) || request.corners.length !== 4)
+            throw new TypeError('Resize snapping needs four frame corners');
+        const corners = request.corners.map((point) => {
+            assertPoint(point, 'Frame corner');
+            return this.drawing.fromClient(point);
+        });
+        const features = corners.every((point) => point !== null)
+            ? resizeLines(corners, request.anchor)
+            : null;
+        return features ? { box, features } : null;
+    }
+    destroy() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.active?.end();
+        this.overlay.destroy();
+        this.stopDisposal();
+    }
+}
+//# sourceMappingURL=snapper.js.map

package/dist/snapping/snapper.js.map

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

package/dist/snapping/spacing.d.ts

@@ -0,0 +1,27 @@
+import type { Box, Point } from '@rasamjs/core';
+import type { Features, Match } from './lines.js';
+type Axis = 'x' | 'y';
+export interface Gap {
+    readonly from: number;
+    readonly to: number;
+    readonly at: number;
+    readonly moving?: 'from' | 'to';
+    readonly neighbor?: number;
+}
+interface Setup {
+    readonly box: Box;
+    readonly targets: readonly Box[];
+    readonly features: Features;
+    readonly kind: 'move' | 'resize' | 'point';
+    readonly centered?: boolean;
+}
+export type Spacing = (request: {
+    readonly axis: Axis;
+    readonly offset: Point;
+    readonly tolerance: number;
+    readonly centered?: boolean;
+}) => Match | null;
+/** Snapshot once; pointer queries scan cached boxes/gaps without any DOM reads. */
+export declare function createSpacing(input: Setup): Spacing | null;
+export {};
+//# sourceMappingURL=spacing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../src/snapping/spacing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGlD,KAAK,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAStB,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AACD,UAAU,KAAK;IACb,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,EAAE,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AACD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B,KAAK,KAAK,GAAG,IAAI,CAAC;AA+DnB,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,CA4D1D"}

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,6 @@
+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 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,cAAc,CAC5B,OAAO,EAAE,GAAG,EACZ,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,OAAO,EAAE,eAAe,GACvB,GAAG,EAAE,CA6BP"}

package/dist/snapping/targets.js

@@ -0,0 +1,67 @@
+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 measureTargets(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);
+    const boxes = [];
+    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":"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"}

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,55 @@
 {
   "name": "@rasamjs/tools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.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"
+    }
+  },
+  "sideEffects": false,
+  "peerDependencies": {
+    "@rasamjs/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@rasamjs/core": "0.1.1",
+    "@rasamjs/history": "0.1.0",
+    "@rasamjs/selection": "0.2.0",
+    "@rasamjs/transformer": "0.3.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"
+  }
+}