@edv4h/usketch-plugin-scatter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EdV4H
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @edv4h/usketch-plugin-scatter
+
+「関連する Shape をぶちまける」— an extensible engine that scatters a seed shape's
+**related** shapes (and/or freshly spawned ones) outward across the canvas, as one
+undoable step, optionally animated.
+
+```ts
+import { createScatterPlugin, getScatterApi } from "@edv4h/usketch-plugin-scatter";
+// register createScatterPlugin() in your app's plugin list.
+
+const api = getScatterApi(app.services);
+await api?.scatter({
+  seedId,                 // defaults to the sole selected shape
+  relation: "connectors", // built-in resolver, or pass items / a RelationResolver
+  pattern: "radial",      // radial | scatter | unoverlap | grid, or a ScatterPattern
+  animate: true,
+});
+```
+
+- **Related = pluggable** — pass explicit `items` (existing ids ∪ new-shape specs) or
+  a `relation` resolver (`connectors`, `children`, or your own via `registerResolver`).
+- **New shapes** — `{ kind: "new", spec: { type, width, height, … } }` items are
+  spawned + placed in the same undoable command.
+- **Patterns** — `radial` / `scatter` (random + rotation) / `unoverlap` (delegates to
+  `findFreePosition`) / `grid`; add more with `registerPattern`.
+- **Animation** — `animate` + `durationMs` + `easing` for a fly-out tween.
+
+UI: registered on the Control HUD (`ぶちまけ設定` + the `関連Shapeをぶちまける` action,
+enabled when exactly one shape is selected).

package/dist/animate.d.ts

@@ -0,0 +1,13 @@
+import type { BoardStore, Point } from "@edv4h/usketch-shared";
+export interface TweenTarget {
+    id: string;
+    from: Point;
+    to: Point;
+}
+/** ease-in-out-cubic — the same feel as the store's viewport animation. */
+export declare function easeInOutCubic(t: number): number;
+export declare function animatePositions(store: BoardStore, targets: TweenTarget[], opts: {
+    durationMs: number;
+    easing: (t: number) => number;
+}): Promise<void>;
+//# sourceMappingURL=animate.d.ts.map

package/dist/animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;CACV;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAQD,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,WAAW,EAAE,EACtB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,GACzD,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/animate.js

@@ -0,0 +1,33 @@
+/** ease-in-out-cubic — the same feel as the store's viewport animation. */
+export function easeInOutCubic(t) {
+    return t < 0.5 ? 4 * t * t * t : 1 - (-2 * t + 2) ** 3 / 2;
+}
+function prefersReducedMotion() {
+    return (typeof matchMedia !== "undefined" && matchMedia("(prefers-reduced-motion: reduce)").matches);
+}
+export function animatePositions(store, targets, opts) {
+    const raf = typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : null;
+    if (!raf || opts.durationMs <= 0 || targets.length === 0 || prefersReducedMotion()) {
+        return Promise.resolve();
+    }
+    const now = () => (typeof performance !== "undefined" ? performance.now() : 0);
+    const start = now();
+    return new Promise((resolve) => {
+        const step = () => {
+            const t = Math.min(1, (now() - start) / opts.durationMs);
+            const e = opts.easing(t);
+            for (const tg of targets) {
+                store.updateShape(tg.id, {
+                    x: tg.from.x + (tg.to.x - tg.from.x) * e,
+                    y: tg.from.y + (tg.to.y - tg.from.y) * e,
+                });
+            }
+            if (t < 1)
+                raf(step);
+            else
+                resolve();
+        };
+        raf(step);
+    });
+}
+//# sourceMappingURL=animate.js.map

package/dist/animate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.js","sourceRoot":"","sources":["../src/animate.ts"],"names":[],"mappings":"AAaA,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,CAAS;IACvC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,oBAAoB;IAC5B,OAAO,CACN,OAAO,UAAU,KAAK,WAAW,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAC3F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,KAAiB,EACjB,OAAsB,EACtB,IAA2D;IAE3D,MAAM,GAAG,GAAG,OAAO,qBAAqB,KAAK,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;IACxF,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,oBAAoB,EAAE,EAAE,CAAC;QACpF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;IACpB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACpC,MAAM,IAAI,GAAG,GAAG,EAAE;YACjB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACzB,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;gBAC1B,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE;oBACxB,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;oBACxC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;iBACxC,CAAC,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC;;gBAChB,OAAO,EAAE,CAAC;QAChB,CAAC,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/command.d.ts

@@ -0,0 +1,3 @@
+import type { BoardStore, Command, ShapeData } from "@edv4h/usketch-shared";
+export declare function createScatterCommand(store: BoardStore, newShapes: ShapeData[], existingBefore: Map<string, ShapeData>, existingAfter: Map<string, Partial<Omit<ShapeData, "id">>>): Command;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQ5E,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EAAE,EACtB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EACtC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,GACxD,OAAO,CAcT"}

package/dist/command.js

@@ -0,0 +1,26 @@
+/** ShapeData without the immutable `id` — the patch shape `updateShape` accepts. */
+function withoutId(shape) {
+    const { id: _id, ...rest } = shape;
+    return rest;
+}
+export function createScatterCommand(store, newShapes, existingBefore, existingAfter) {
+    return {
+        execute() {
+            for (const shape of newShapes) {
+                if (store.getShape(shape.id))
+                    store.updateShape(shape.id, withoutId(shape));
+                else
+                    store.addShape(shape);
+            }
+            for (const [id, patch] of existingAfter)
+                store.updateShape(id, patch);
+        },
+        undo() {
+            for (const shape of newShapes)
+                store.deleteShape(shape.id);
+            for (const [id, before] of existingBefore)
+                store.updateShape(id, withoutId(before));
+        },
+    };
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAOA,oFAAoF;AACpF,SAAS,SAAS,CAAC,KAAgB;IAClC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACnC,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,KAAiB,EACjB,SAAsB,EACtB,cAAsC,EACtC,aAA0D;IAE1D,OAAO;QACN,OAAO;YACN,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBAAE,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;;oBACvE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,aAAa;gBAAE,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC;QACD,IAAI;YACH,KAAK,MAAM,KAAK,IAAI,SAAS;gBAAE,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3D,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,cAAc;gBAAE,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACrF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,7 @@
+import type { ScatterDeps, ScatterRequest, ScatterResult } from "./types.js";
+/**
+ * Scatter a seed shape's related shapes (and/or freshly spawned shapes) across the
+ * canvas using the chosen pattern, as one undoable step. Optionally animated.
+ */
+export declare function scatter(deps: ScatterDeps, request: ScatterRequest): Promise<ScatterResult>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAGX,WAAW,EAEX,cAAc,EACd,aAAa,EACb,MAAM,YAAY,CAAC;AA0JpB;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAmChG"}

package/dist/engine.js

@@ -0,0 +1,173 @@
+// The scatter orchestrator: resolve the seed + related items, run the chosen
+// pattern to place them, spawn any new shapes, and apply everything as ONE
+// undoable command (optionally animated first). Pure over its `deps` — the plugin
+// and the service both call `scatter()`.
+import { generateId, getRotatedAABB, safeRotation, } from "@edv4h/usketch-shared";
+import { animatePositions, easeInOutCubic } from "./animate.js";
+import { createScatterCommand } from "./command.js";
+import { getScatterPattern } from "./patterns.js";
+import { resolveItems } from "./resolvers.js";
+import { hashSeed, mulberry32 } from "./rng.js";
+const DEFAULT_SPACING = 24;
+const DEFAULT_DURATION = 450;
+function boundsOf(deps, shape) {
+    const def = deps.shapes.get(shape.type);
+    return def
+        ? def.getBounds(shape)
+        : { x: shape.x, y: shape.y, width: shape.width, height: shape.height };
+}
+function occupiedAABB(deps, shape) {
+    const b = boundsOf(deps, shape);
+    const rot = safeRotation(shape.rotation);
+    return rot ? getRotatedAABB(b, rot) : b;
+}
+/** The sole selected shape id, or undefined when the selection isn't exactly one. */
+function soleSelection(deps) {
+    const sel = deps.store.getSelection();
+    return sel.size === 1 ? [...sel][0] : undefined;
+}
+/** Build the full plan: pattern placements → new shapes + existing move patches. */
+function planScatter(deps, seedShape, request) {
+    const { store, shapes } = deps;
+    const items = resolveItems({ store }, seedShape.id, request.relation, request.items);
+    const seedBounds = boundsOf(deps, seedShape);
+    const seedCenter = {
+        x: seedBounds.x + seedBounds.width / 2,
+        y: seedBounds.y + seedBounds.height / 2,
+    };
+    // Occupied = every shape that ISN'T a moving item (so items avoid the seed +
+    // unrelated shapes). Used by the `unoverlap` pattern.
+    const movingIds = new Set(items.filter((i) => i.kind === "existing").map((i) => i.id));
+    const occupied = [];
+    for (const [id, s] of store.getShapes()) {
+        if (!movingIds.has(id))
+            occupied.push(occupiedAABB(deps, s));
+    }
+    const patternItems = [];
+    const sources = new Map();
+    const newIds = new Set();
+    items.forEach((it, i) => {
+        if (it.kind === "existing") {
+            const s = store.getShape(it.id);
+            if (!s)
+                return; // stale id — skip
+            const b = boundsOf(deps, s);
+            patternItems.push({ key: it.id, bounds: { x: 0, y: 0, width: b.width, height: b.height } });
+            sources.set(it.id, { kind: "existing", id: it.id });
+        }
+        else {
+            const { width, height } = it.spec;
+            if (!(width > 0) || !(height > 0)) {
+                throw new Error("[scatter] a new shape spec must carry positive width/height");
+            }
+            // Resolve + guard the id up-front so a caller-supplied `spec.id` can never
+            // overwrite an existing shape (addShape overwrites) — which undo would then
+            // wrongly delete — nor collide with another new spec in the same run.
+            const id = typeof it.spec.id === "string" ? it.spec.id : generateId();
+            if (store.getShape(id) || newIds.has(id)) {
+                throw new Error(`[scatter] new shape id collides with an existing/duplicate id: ${id}`);
+            }
+            newIds.add(id);
+            const key = `new:${i}`;
+            patternItems.push({ key, bounds: { x: 0, y: 0, width, height } });
+            sources.set(key, { kind: "new", id, spec: it.spec });
+        }
+    });
+    const patternFn = typeof request.pattern === "function" ? request.pattern : getScatterPattern(request.pattern);
+    if (!patternFn)
+        throw new Error(`[scatter] unknown pattern: ${String(request.pattern)}`);
+    const rng = mulberry32(hashSeed(request.seed ?? Math.floor(Math.random() * 0xffffffff)));
+    const placements = patternFn({
+        seedBounds,
+        seedCenter,
+        items: patternItems,
+        occupied,
+        spacing: request.spacing ?? DEFAULT_SPACING,
+        rng,
+    });
+    const plan = {
+        newShapes: [],
+        newStarts: new Map(),
+        existingBefore: new Map(),
+        existingAfter: new Map(),
+        tweens: [],
+        movedIds: [],
+        createdIds: [],
+    };
+    for (const p of placements) {
+        const src = sources.get(p.key);
+        if (!src)
+            continue;
+        if (src.kind === "existing") {
+            const s = store.getShape(src.id);
+            if (!s)
+                continue;
+            plan.existingBefore.set(src.id, { ...s });
+            const patch = { x: p.x, y: p.y };
+            if (p.rotation !== undefined)
+                patch.rotation = p.rotation;
+            plan.existingAfter.set(src.id, patch);
+            plan.movedIds.push(src.id);
+            plan.tweens.push({ id: src.id, from: { x: s.x, y: s.y }, to: { x: p.x, y: p.y } });
+        }
+        else {
+            const { spec, id } = src;
+            const base = shapes.get(spec.type)?.createDefault({ id, x: p.x, y: p.y });
+            if (!base)
+                throw new Error(`[scatter] unknown shape type: ${spec.type}`);
+            const { id: _sid, type: _stype, width, height, style: specStyle, ...rest } = spec;
+            const shape = {
+                ...base,
+                ...rest,
+                id,
+                type: spec.type,
+                x: p.x,
+                y: p.y,
+                width,
+                height,
+                style: { ...base.style, ...(specStyle ?? {}) },
+            };
+            if (p.rotation !== undefined)
+                shape.rotation = p.rotation;
+            plan.newShapes.push(shape);
+            plan.createdIds.push(id);
+            const start = { x: seedCenter.x - width / 2, y: seedCenter.y - height / 2 };
+            plan.newStarts.set(id, start);
+            plan.tweens.push({ id, from: start, to: { x: p.x, y: p.y } });
+        }
+    }
+    return plan;
+}
+/**
+ * Scatter a seed shape's related shapes (and/or freshly spawned shapes) across the
+ * canvas using the chosen pattern, as one undoable step. Optionally animated.
+ */
+export async function scatter(deps, request) {
+    const seedId = request.seedId ?? soleSelection(deps);
+    if (!seedId) {
+        throw new Error("[scatter] no seed: select exactly one shape or pass request.seedId");
+    }
+    const seedShape = deps.store.getShape(seedId);
+    if (!seedShape)
+        throw new Error(`[scatter] seed shape not found: ${seedId}`);
+    const plan = planScatter(deps, seedShape, request);
+    if (plan.movedIds.length === 0 && plan.createdIds.length === 0) {
+        return { movedIds: [], createdIds: [] };
+    }
+    const command = createScatterCommand(deps.store, plan.newShapes, plan.existingBefore, plan.existingAfter);
+    if (request.animate) {
+        // Spawn new shapes at their START position (raw add — not a command), tween
+        // everything to the target, then commit the command (idempotent) for one undo.
+        for (const shape of plan.newShapes) {
+            const start = plan.newStarts.get(shape.id);
+            deps.store.addShape(start ? { ...shape, x: start.x, y: start.y } : shape);
+        }
+        await animatePositions(deps.store, plan.tweens, {
+            durationMs: request.durationMs ?? DEFAULT_DURATION,
+            easing: request.easing ?? easeInOutCubic,
+        });
+    }
+    deps.commands.execute(command);
+    return { movedIds: plan.movedIds, createdIds: plan.createdIds };
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/hud/register-scatter-hud.d.ts

@@ -0,0 +1,3 @@
+import type { PluginContext } from "@edv4h/usketch-shared";
+export declare function registerScatterHud(ctx: PluginContext): () => void;
+//# sourceMappingURL=register-scatter-hud.d.ts.map

package/dist/hud/register-scatter-hud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-scatter-hud.d.ts","sourceRoot":"","sources":["../../src/hud/register-scatter-hud.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAM3D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,IAAI,CA2DjE"}

package/dist/hud/register-scatter-hud.js

@@ -0,0 +1,60 @@
+import { listScatterPatterns } from "../patterns.js";
+import { listRelationResolvers } from "../resolvers.js";
+import { getScatterApi } from "../scatter-service.js";
+import { scatterStateStore } from "../scatter-state.js";
+export function registerScatterHud(ctx) {
+    const offs = [];
+    offs.push(ctx.hud.registerSettings({
+        id: "usketch-scatter:opts",
+        label: "ぶちまけ設定",
+        fields: [
+            {
+                name: "pattern",
+                label: "パターン",
+                type: "enum",
+                options: listScatterPatterns().map((p) => ({ value: p, label: p })),
+            },
+            {
+                name: "relation",
+                label: "関連",
+                type: "enum",
+                options: listRelationResolvers().map((r) => ({ value: r, label: r })),
+            },
+            { name: "spacing", label: "間隔", type: "number", min: 0, max: 400, step: 4 },
+            { name: "animate", label: "アニメーション", type: "boolean" },
+            { name: "durationMs", label: "時間(ms)", type: "number", min: 0, max: 3000, step: 50 },
+        ],
+        get: (name) => scatterStateStore.get()[name],
+        set: (name, value) => scatterStateStore.set({ [name]: value }),
+        subscribe: scatterStateStore.subscribe,
+    }));
+    offs.push(ctx.actions.register({
+        id: "scatter:spill",
+        group: "ぶちまける",
+        label: "関連Shapeをぶちまける",
+        isEnabled: () => ctx.store.getSelection().size === 1,
+        // Return the Promise so the HUD action runner surfaces failures (e.g. the
+        // seed deleted between selection read and run) in its logs instead of them
+        // becoming unhandled rejections.
+        run: async () => {
+            const api = getScatterApi(ctx.services);
+            const sel = ctx.store.getSelection();
+            if (!api || sel.size !== 1)
+                return;
+            const st = scatterStateStore.get();
+            await api.scatter({
+                seedId: [...sel][0],
+                pattern: st.pattern,
+                relation: st.relation,
+                spacing: st.spacing,
+                animate: st.animate,
+                durationMs: st.durationMs,
+            });
+        },
+    }));
+    return () => {
+        for (const off of offs)
+            off();
+    };
+}
+//# sourceMappingURL=register-scatter-hud.js.map

package/dist/hud/register-scatter-hud.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { animatePositions, easeInOutCubic, type TweenTarget } from "./animate.js";
+export { createScatterCommand } from "./command.js";
+export { scatter } from "./engine.js";
+export { getScatterPattern, gridPattern, listScatterPatterns, radialPattern, registerScatterPattern, scatterPattern, unoverlapPattern, } from "./patterns.js";
+export { createScatterPlugin } from "./plugin.js";
+export { connectorNeighbors, getRelationResolver, listRelationResolvers, parentChildren, registerRelationResolver, resolveItems, } from "./resolvers.js";
+export { hashSeed, mulberry32 } from "./rng.js";
+export { createScatterApi, getScatterApi, type ScatterApi, scatterService, } from "./scatter-service.js";
+export { type ReactiveStore, type ScatterState, scatterStateStore, } from "./scatter-state.js";
+export type { NewShapeSpec, PatternContext, PatternItem, Placement, RelationResolver, ScatterDeps, ScatterItem, ScatterPattern, ScatterRequest, ScatterResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACN,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACN,gBAAgB,EAChB,aAAa,EACb,KAAK,UAAU,EACf,cAAc,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,iBAAiB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { animatePositions, easeInOutCubic } from "./animate.js";
+export { createScatterCommand } from "./command.js";
+export { scatter } from "./engine.js";
+export { getScatterPattern, gridPattern, listScatterPatterns, radialPattern, registerScatterPattern, scatterPattern, unoverlapPattern, } from "./patterns.js";
+export { createScatterPlugin } from "./plugin.js";
+export { connectorNeighbors, getRelationResolver, listRelationResolvers, parentChildren, registerRelationResolver, resolveItems, } from "./resolvers.js";
+export { hashSeed, mulberry32 } from "./rng.js";
+export { createScatterApi, getScatterApi, scatterService, } from "./scatter-service.js";
+export { scatterStateStore, } from "./scatter-state.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAoB,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACN,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACN,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACN,gBAAgB,EAChB,aAAa,EAEb,cAAc,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGN,iBAAiB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/patterns.d.ts

@@ -0,0 +1,17 @@
+import type { ScatterPattern } from "./types.js";
+/** Even ring(s) around the seed centre. Ring radius grows to fit all items without
+ *  overlap (arc length per item ≥ item size + spacing). */
+export declare const radialPattern: ScatterPattern;
+/** Random offsets within a radius + a small random rotation — the chaotic
+ *  "dumped out" look. Deterministic given the seed (uses ctx.rng). */
+export declare const scatterPattern: ScatterPattern;
+/** Non-overlapping cluster: place each item near the seed, then push it to the
+ *  nearest free spot (delegates to findFreePosition), accumulating placed AABBs so
+ *  items don't collide with each other either. */
+export declare const unoverlapPattern: ScatterPattern;
+/** Square-ish grid centred on the seed; cells sized to the largest item + spacing. */
+export declare const gridPattern: ScatterPattern;
+export declare function registerScatterPattern(name: string, pattern: ScatterPattern): () => void;
+export declare function getScatterPattern(name: string): ScatterPattern | undefined;
+export declare function listScatterPatterns(): string[];
+//# sourceMappingURL=patterns.d.ts.map

package/dist/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../src/patterns.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAA0B,cAAc,EAAE,MAAM,YAAY,CAAC;AAsBzE;2DAC2D;AAC3D,eAAO,MAAM,aAAa,EAAE,cAgB3B,CAAC;AAEF;sEACsE;AACtE,eAAO,MAAM,cAAc,EAAE,cAkB5B,CAAC;AAEF;;kDAEkD;AAClD,eAAO,MAAM,gBAAgB,EAAE,cAoB9B,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,WAAW,EAAE,cAczB,CAAC;AASF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAKxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/patterns.js

@@ -0,0 +1,108 @@
+// Layout patterns: pure functions placing the related items around the seed. All
+// take a PatternContext and return Placements (top-left x/y + optional rotation).
+// Registerable so hosts can add their own; built-ins self-register on import.
+import { findFreePosition } from "@edv4h/usketch-shape-utils";
+const TAU = Math.PI * 2;
+/** Largest single item dimension (a lower bound for spacing between items). */
+function maxItemDim(items) {
+    let m = 1;
+    for (const it of items)
+        m = Math.max(m, it.bounds.width, it.bounds.height);
+    return m;
+}
+/** Convert a target CENTER to a top-left placement for an item of these bounds. */
+function atCenter(key, cx, cy, b, rotation) {
+    return { key, x: cx - b.width / 2, y: cy - b.height / 2, rotation };
+}
+/** Even ring(s) around the seed centre. Ring radius grows to fit all items without
+ *  overlap (arc length per item ≥ item size + spacing). */
+export const radialPattern = ({ seedBounds, seedCenter, items, spacing }) => {
+    const n = items.length;
+    if (n === 0)
+        return [];
+    const dim = maxItemDim(items);
+    const seedR = Math.max(seedBounds.width, seedBounds.height) / 2;
+    const circumferenceNeed = n * (dim + spacing);
+    const radius = Math.max(seedR + dim / 2 + spacing, circumferenceNeed / TAU);
+    return items.map((it, i) => {
+        const a = (i / n) * TAU;
+        return atCenter(it.key, seedCenter.x + Math.cos(a) * radius, seedCenter.y + Math.sin(a) * radius, it.bounds);
+    });
+};
+/** Random offsets within a radius + a small random rotation — the chaotic
+ *  "dumped out" look. Deterministic given the seed (uses ctx.rng). */
+export const scatterPattern = ({ seedBounds, seedCenter, items, spacing, rng }) => {
+    const n = items.length;
+    if (n === 0)
+        return [];
+    const dim = maxItemDim(items);
+    const seedR = Math.max(seedBounds.width, seedBounds.height) / 2;
+    const spread = Math.max(seedR * 2 + dim, Math.sqrt(n) * (dim + spacing));
+    return items.map((it) => {
+        const ang = rng() * TAU;
+        const dist = (0.35 + 0.65 * rng()) * spread;
+        const rotation = (rng() * 2 - 1) * 22; // ±22°
+        return atCenter(it.key, seedCenter.x + Math.cos(ang) * dist, seedCenter.y + Math.sin(ang) * dist, it.bounds, rotation);
+    });
+};
+/** Non-overlapping cluster: place each item near the seed, then push it to the
+ *  nearest free spot (delegates to findFreePosition), accumulating placed AABBs so
+ *  items don't collide with each other either. */
+export const unoverlapPattern = ({ seedCenter, items, occupied, spacing }) => {
+    const placed = [...occupied];
+    const out = [];
+    for (const it of items) {
+        const desired = {
+            x: seedCenter.x - it.bounds.width / 2,
+            y: seedCenter.y - it.bounds.height / 2,
+            width: it.bounds.width,
+            height: it.bounds.height,
+        };
+        const free = findFreePosition({
+            desired,
+            occupied: placed,
+            strategy: "ring",
+            step: Math.max(8, spacing),
+        });
+        placed.push(free);
+        out.push({ key: it.key, x: free.x, y: free.y });
+    }
+    return out;
+};
+/** Square-ish grid centred on the seed; cells sized to the largest item + spacing. */
+export const gridPattern = ({ seedCenter, items, spacing }) => {
+    const n = items.length;
+    if (n === 0)
+        return [];
+    const dim = maxItemDim(items);
+    const cell = dim + spacing;
+    const cols = Math.ceil(Math.sqrt(n));
+    const rows = Math.ceil(n / cols);
+    const startX = seedCenter.x - (cols * cell) / 2 + cell / 2;
+    const startY = seedCenter.y - (rows * cell) / 2 + cell / 2;
+    return items.map((it, i) => {
+        const c = i % cols;
+        const r = Math.floor(i / cols);
+        return atCenter(it.key, startX + c * cell, startY + r * cell, it.bounds);
+    });
+};
+const PATTERNS = new Map([
+    ["radial", radialPattern],
+    ["scatter", scatterPattern],
+    ["unoverlap", unoverlapPattern],
+    ["grid", gridPattern],
+]);
+export function registerScatterPattern(name, pattern) {
+    PATTERNS.set(name, pattern);
+    return () => {
+        if (PATTERNS.get(name) === pattern)
+            PATTERNS.delete(name);
+    };
+}
+export function getScatterPattern(name) {
+    return PATTERNS.get(name);
+}
+export function listScatterPatterns() {
+    return [...PATTERNS.keys()];
+}
+//# sourceMappingURL=patterns.js.map

package/dist/patterns.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { UsketchPlugin } from "@edv4h/usketch-shared";
+export declare function createScatterPlugin(): UsketchPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI1E,wBAAgB,mBAAmB,IAAI,aAAa,CAkBnD"}

package/dist/plugin.js

@@ -0,0 +1,18 @@
+import { registerScatterHud } from "./hud/register-scatter-hud.js";
+import { createScatterApi, scatterService } from "./scatter-service.js";
+export function createScatterPlugin() {
+    return {
+        id: "usketch-plugin-scatter",
+        name: "Scatter",
+        setup(ctx) {
+            const unregisterHud = registerScatterHud(ctx);
+            // Provided last so a HUD registration failure can't leak the service.
+            const unprovide = scatterService.provide(ctx.services, createScatterApi({ store: ctx.store, shapes: ctx.shapes, commands: ctx.commands }));
+            return () => {
+                unprovide();
+                unregisterHud();
+            };
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,UAAU,mBAAmB;IAClC,OAAO;QACN,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,SAAS;QAEf,KAAK,CAAC,GAAkB;YACvB,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC9C,sEAAsE;YACtE,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CACvC,GAAG,CAAC,QAAQ,EACZ,gBAAgB,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAClF,CAAC;YACF,OAAO,GAAG,EAAE;gBACX,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,CAAC;YACjB,CAAC,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/resolvers.d.ts

@@ -0,0 +1,15 @@
+import type { RelationResolver, ScatterDeps, ScatterItem } from "./types.js";
+/**
+ * Connector neighbours: every shape joined to the seed by a connector (a shape
+ * carrying `sourceId`/`targetId`) — the connector's OPPOSITE endpoint. Plugin-
+ * agnostic: it just matches the `ConnectableShapeData` field shape.
+ */
+export declare const connectorNeighbors: RelationResolver;
+/** Parent/children: shapes whose `parentId` is the seed (group/frame/container/island members). */
+export declare const parentChildren: RelationResolver;
+export declare function registerRelationResolver(name: string, resolver: RelationResolver): () => void;
+export declare function getRelationResolver(name: string): RelationResolver | undefined;
+export declare function listRelationResolvers(): string[];
+/** Resolve the item set: explicit `items` win; else run the named/function resolver. */
+export declare function resolveItems(deps: Pick<ScatterDeps, "store">, seedId: string, relation: string | RelationResolver | undefined, items: ScatterItem[] | undefined): ScatterItem[];
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../src/resolvers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK7E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAUhC,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,cAAc,EAAE,gBAM5B,CAAC;AAOF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAK7F;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE9E;AAED,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAC3B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,EAC/C,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,GAC9B,WAAW,EAAE,CAMf"}

package/dist/resolvers.js

@@ -0,0 +1,56 @@
+/**
+ * Connector neighbours: every shape joined to the seed by a connector (a shape
+ * carrying `sourceId`/`targetId`) — the connector's OPPOSITE endpoint. Plugin-
+ * agnostic: it just matches the `ConnectableShapeData` field shape.
+ */
+export const connectorNeighbors = ({ store }, seedId) => {
+    const out = new Set();
+    for (const [, shape] of store.getShapes()) {
+        const r = shape;
+        const src = typeof r.sourceId === "string" ? r.sourceId : undefined;
+        const tgt = typeof r.targetId === "string" ? r.targetId : undefined;
+        if (src === seedId && tgt && tgt !== seedId)
+            out.add(tgt);
+        else if (tgt === seedId && src && src !== seedId)
+            out.add(src);
+    }
+    return [...out].map((id) => ({ kind: "existing", id }));
+};
+/** Parent/children: shapes whose `parentId` is the seed (group/frame/container/island members). */
+export const parentChildren = ({ store }, seedId) => {
+    const out = [];
+    for (const [id, shape] of store.getShapes()) {
+        if (shape.parentId === seedId)
+            out.push({ kind: "existing", id });
+    }
+    return out;
+};
+const RESOLVERS = new Map([
+    ["connectors", connectorNeighbors],
+    ["children", parentChildren],
+]);
+export function registerRelationResolver(name, resolver) {
+    RESOLVERS.set(name, resolver);
+    return () => {
+        if (RESOLVERS.get(name) === resolver)
+            RESOLVERS.delete(name);
+    };
+}
+export function getRelationResolver(name) {
+    return RESOLVERS.get(name);
+}
+export function listRelationResolvers() {
+    return [...RESOLVERS.keys()];
+}
+/** Resolve the item set: explicit `items` win; else run the named/function resolver. */
+export function resolveItems(deps, seedId, relation, items) {
+    if (items)
+        return items;
+    if (!relation)
+        return [];
+    const resolver = typeof relation === "function" ? relation : getRelationResolver(relation);
+    if (!resolver)
+        throw new Error(`[scatter] unknown relation resolver: ${String(relation)}`);
+    return resolver(deps, seedId);
+}
+//# sourceMappingURL=resolvers.js.map

package/dist/resolvers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.js","sourceRoot":"","sources":["../src/resolvers.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAqB,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE;IACzE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,KAA2B,CAAC;QACtC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,MAAM;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACrD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,MAAM;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAuB,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAqB,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE;IACrE,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QAC7C,IAAK,KAA4B,CAAC,QAAQ,KAAK,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,GAAG,CAA2B;IACnD,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAClC,CAAC,UAAU,EAAE,cAAc,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,QAA0B;IAChF,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,EAAE;QACX,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ;YAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC/C,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,qBAAqB;IACpC,OAAO,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAC3B,IAAgC,EAChC,MAAc,EACd,QAA+C,EAC/C,KAAgC;IAEhC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC3F,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3F,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/rng.d.ts

@@ -0,0 +1,5 @@
+/** mulberry32: fast, decent-quality seeded PRNG returning floats in [0,1). */
+export declare function mulberry32(seed: number): () => number;
+/** Coerce a user seed (number or string) to a 32-bit unsigned int. */
+export declare function hashSeed(seed: number | string): number;
+//# sourceMappingURL=rng.d.ts.map

package/dist/rng.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng.d.ts","sourceRoot":"","sources":["../src/rng.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CASrD;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQtD"}

package/dist/rng.js

@@ -0,0 +1,26 @@
+// Small seeded PRNG so random scatter patterns are reproducible (same seed → same
+// layout) for tests/repro. Copied from the map plugin's generators/rng.ts (not
+// shared). No external deps.
+/** mulberry32: fast, decent-quality seeded PRNG returning floats in [0,1). */
+export function mulberry32(seed) {
+    let a = seed >>> 0;
+    return () => {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** Coerce a user seed (number or string) to a 32-bit unsigned int. */
+export function hashSeed(seed) {
+    if (typeof seed === "number")
+        return seed >>> 0;
+    let h = 2166136261 >>> 0; // FNV-1a
+    for (let i = 0; i < seed.length; i++) {
+        h ^= seed.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return h >>> 0;
+}
+//# sourceMappingURL=rng.js.map

package/dist/rng.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng.js","sourceRoot":"","sources":["../src/rng.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,+EAA+E;AAC/E,6BAA6B;AAE7B,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,GAAG,EAAE;QACX,CAAC,IAAI,CAAC,CAAC;QACP,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC9C,CAAC,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,IAAqB;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,SAAS;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC;AAChB,CAAC"}

package/dist/scatter-service.d.ts

@@ -0,0 +1,15 @@
+import { type ServiceRegistry } from "@edv4h/usketch-shared";
+import type { RelationResolver, ScatterDeps, ScatterPattern, ScatterRequest, ScatterResult } from "./types.js";
+export interface ScatterApi {
+    scatter(request: ScatterRequest): Promise<ScatterResult>;
+    registerPattern(name: string, pattern: ScatterPattern): () => void;
+    registerResolver(name: string, resolver: RelationResolver): () => void;
+    listPatterns(): string[];
+    listResolvers(): string[];
+}
+export declare const scatterService: import("@edv4h/usketch-shared").ServiceHandle<ScatterApi>;
+export declare function createScatterApi(deps: ScatterDeps): ScatterApi;
+/** Host accessor: `getScatterApi(app.services)?.scatter({...})`. Undefined when the
+ *  scatter plugin isn't active. Works with `ctx.services` too. */
+export declare function getScatterApi(services: ServiceRegistry): ScatterApi | undefined;
+//# sourceMappingURL=scatter-service.d.ts.map

package/dist/scatter-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter-service.d.ts","sourceRoot":"","sources":["../src/scatter-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI5E,OAAO,KAAK,EACX,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,UAAU;IAC1B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzD,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAAC;IACnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;IACvE,YAAY,IAAI,MAAM,EAAE,CAAC;IACzB,aAAa,IAAI,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,cAAc,2DAAsD,CAAC;AAElF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAQ9D;AAED;kEACkE;AAClE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,GAAG,SAAS,CAE/E"}

package/dist/scatter-service.js

@@ -0,0 +1,23 @@
+// Host-facing scatter API, published on the `ctx.services` seam (defineService
+// convention — see usketch-plugin-map/map-service.ts). Lets a host/other plugin
+// run scatters + register custom patterns/resolvers without the Control HUD.
+import { defineService } from "@edv4h/usketch-shared";
+import { scatter } from "./engine.js";
+import { listScatterPatterns, registerScatterPattern } from "./patterns.js";
+import { listRelationResolvers, registerRelationResolver } from "./resolvers.js";
+export const scatterService = defineService("usketch-plugin-scatter");
+export function createScatterApi(deps) {
+    return {
+        scatter: (request) => scatter(deps, request),
+        registerPattern: registerScatterPattern,
+        registerResolver: registerRelationResolver,
+        listPatterns: listScatterPatterns,
+        listResolvers: listRelationResolvers,
+    };
+}
+/** Host accessor: `getScatterApi(app.services)?.scatter({...})`. Undefined when the
+ *  scatter plugin isn't active. Works with `ctx.services` too. */
+export function getScatterApi(services) {
+    return scatterService.get(services);
+}
+//# sourceMappingURL=scatter-service.js.map

package/dist/scatter-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter-service.js","sourceRoot":"","sources":["../src/scatter-service.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,OAAO,EAAE,aAAa,EAAwB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAiBjF,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAa,wBAAwB,CAAC,CAAC;AAElF,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IACjD,OAAO;QACN,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;QAC5C,eAAe,EAAE,sBAAsB;QACvC,gBAAgB,EAAE,wBAAwB;QAC1C,YAAY,EAAE,mBAAmB;QACjC,aAAa,EAAE,qBAAqB;KACpC,CAAC;AACH,CAAC;AAED;kEACkE;AAClE,MAAM,UAAU,aAAa,CAAC,QAAyB;IACtD,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/scatter-state.d.ts

@@ -0,0 +1,16 @@
+export interface ScatterState {
+    /** Registered pattern name (radial | scatter | unoverlap | grid | …). */
+    pattern: string;
+    /** Registered relation resolver name (connectors | children | …). */
+    relation: string;
+    spacing: number;
+    animate: boolean;
+    durationMs: number;
+}
+export interface ReactiveStore<T> {
+    get(): T;
+    set(patch: Partial<T>): void;
+    subscribe(listener: () => void): () => void;
+}
+export declare const scatterStateStore: ReactiveStore<ScatterState>;
+//# sourceMappingURL=scatter-state.d.ts.map

package/dist/scatter-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter-state.d.ts","sourceRoot":"","sources":["../src/scatter-state.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC5B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC/B,GAAG,IAAI,CAAC,CAAC;IACT,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5C;AA4BD,eAAO,MAAM,iBAAiB,6BAM5B,CAAC"}

package/dist/scatter-state.js

@@ -0,0 +1,37 @@
+// Module-scoped reactive store backing the scatter HUD controls. App-local
+// presentation state (never synced), same shape as the map plugin's stores.
+function createReactiveStore(initial) {
+    let state = initial;
+    const listeners = new Set();
+    return {
+        get: () => state,
+        set(patch) {
+            const next = { ...state };
+            let changed = false;
+            for (const k of Object.keys(patch)) {
+                const v = patch[k];
+                if (v !== undefined && v !== state[k]) {
+                    next[k] = v;
+                    changed = true;
+                }
+            }
+            if (!changed)
+                return;
+            state = next;
+            for (const l of listeners)
+                l();
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+export const scatterStateStore = createReactiveStore({
+    pattern: "radial",
+    relation: "connectors",
+    spacing: 24,
+    animate: true,
+    durationMs: 450,
+});
+//# sourceMappingURL=scatter-state.js.map

package/dist/scatter-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scatter-state.js","sourceRoot":"","sources":["../src/scatter-state.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAkB5E,SAAS,mBAAmB,CAAmB,OAAU;IACxD,IAAI,KAAK,GAAG,OAAO,CAAC;IACpB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,OAAO;QACN,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK;QAChB,GAAG,CAAC,KAAK;YACR,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YAC1B,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAgB,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAe,CAAC;oBAC1B,OAAO,GAAG,IAAI,CAAC;gBAChB,CAAC;YACF,CAAC;YACD,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,KAAK,GAAG,IAAI,CAAC;YACb,KAAK,MAAM,CAAC,IAAI,SAAS;gBAAE,CAAC,EAAE,CAAC;QAChC,CAAC;QACD,SAAS,CAAC,QAAQ;YACjB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAe;IAClE,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,YAAY;IACtB,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,GAAG;CACf,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,79 @@
+import type { BoardStore, BoundingBox, CommandRegistry, Point, ShapeData, ShapeRegistry, ShapeStyle } from "@edv4h/usketch-shared";
+/** A brand-new shape to spawn as part of a scatter. The engine assigns an id
+ *  (`generateId()`) + the final x/y from the pattern, builds a valid base via the
+ *  type's `ShapeDefinition.createDefault`, then merges these fields over it. */
+export interface NewShapeSpec {
+    id?: string;
+    type: string;
+    /** Required — the shape isn't in the store yet, so `getBounds` can't be used. */
+    width: number;
+    height: number;
+    style?: Partial<ShapeStyle>;
+    meta?: Record<string, unknown>;
+    /** Intrinsic per-type fields (text, etc.). */
+    [key: string]: unknown;
+}
+/** A scatter item is either an existing shape (moved) or a new shape (spawned). */
+export type ScatterItem = {
+    kind: "existing";
+    id: string;
+} | {
+    kind: "new";
+    spec: NewShapeSpec;
+};
+export interface ScatterDeps {
+    store: BoardStore;
+    shapes: ShapeRegistry;
+    commands: CommandRegistry;
+}
+/** Resolve the seed's related set — pure over the store. Pluggable so "related"
+ *  isn't hardcoded (connector neighbours, parent/children, or a host's own). */
+export type RelationResolver = (deps: Pick<ScatterDeps, "store">, seedId: string) => ScatterItem[];
+/** One item to place, with its INTRINSIC (unrotated, origin-anchored) bounds. */
+export interface PatternItem {
+    key: string;
+    bounds: BoundingBox;
+}
+export interface PatternContext {
+    seedBounds: BoundingBox;
+    seedCenter: Point;
+    items: PatternItem[];
+    /** AABBs to avoid (the seed + non-item shapes) — used by `unoverlap`. */
+    occupied: BoundingBox[];
+    /** Gap between placed items, in world px. */
+    spacing: number;
+    /** Seeded PRNG in [0,1). Patterns MUST use this (never `Math.random`) for repro. */
+    rng: () => number;
+}
+export interface Placement {
+    key: string;
+    x: number;
+    y: number;
+    rotation?: number;
+}
+/** A pure layout function: place the items around the seed. */
+export type ScatterPattern = (ctx: PatternContext) => Placement[];
+export interface ScatterRequest {
+    /** Seed shape id. Defaults to the sole selected shape. */
+    seedId?: string;
+    /** Explicit item set … */
+    items?: ScatterItem[];
+    /** … or derive it from the seed (a registered resolver name or a function). */
+    relation?: string | RelationResolver;
+    /** Layout (a registered pattern name or a function). */
+    pattern: string | ScatterPattern;
+    spacing?: number;
+    /** RNG seed (number or string) for reproducible random patterns. */
+    seed?: number | string;
+    /** Fly-out animation (default `false` = instant). */
+    animate?: boolean;
+    durationMs?: number;
+    easing?: (t: number) => number;
+}
+export interface ScatterResult {
+    movedIds: string[];
+    createdIds: string[];
+}
+/** Convenience alias for a fully-built shape produced by the engine. */
+export type BuiltShape = ShapeData;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,UAAU,EACV,WAAW,EACX,eAAe,EACf,KAAK,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,MAAM,uBAAuB,CAAC;AAE/B;;gFAEgF;AAChF,MAAM,WAAW,YAAY;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,8CAA8C;IAC9C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEjG,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;CAC1B;AAED;gFACgF;AAChF,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;AAEnG,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,WAAW,CAAC;IACxB,UAAU,EAAE,KAAK,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,yEAAyE;IACzE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,GAAG,EAAE,MAAM,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;AAElE,MAAM,WAAW,cAAc;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACrC,wDAAwD;IACxD,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@edv4h/usketch-plugin-scatter",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@edv4h/usketch-shared": "4.12.0",
+    "@edv4h/usketch-shape-utils": "2.2.8"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EdV4H/usketch.git",
+    "directory": "plugins/usketch-plugin-scatter"
+  },
+  "homepage": "https://github.com/EdV4H/usketch#readme",
+  "bugs": {
+    "url": "https://github.com/EdV4H/usketch/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}