@pixi-ui-editor/runtime-pixi 0.1.0

package/dist/particles.test.js

@@ -0,0 +1,210 @@
+import { describe, expect, it } from "vitest";
+import { ParticlePool, ParticleSimulator } from "./particles.js";
+function definition(overrides = {}) {
+    return {
+        id: "effect-1", name: "Effect", type: "particles", maxParticles: 8, seed: 42,
+        emission: { delay: 0, duration: 10, loop: true, rate: 0, bursts: [] },
+        particle: {
+            lifetime: { min: 0.5, max: 0.5 },
+            spawnShape: { type: "point" },
+            movement: { speed: { min: 0, max: 0 }, directionDegrees: 0, spreadDegrees: 0, accelerationX: 0, accelerationY: 0, drag: 0 },
+            visual: {
+                source: { type: "single", assetId: "asset-1" },
+                alpha: { start: 1, end: 0 },
+                scale: { start: { min: 1, max: 1 }, end: { min: 1, max: 1 } },
+                tint: { start: "#FFFFFF", end: "#FFFFFF" },
+                rotation: { initialDegrees: { min: 0, max: 0 }, angularVelocityDegrees: { min: 0, max: 0 } },
+                blendMode: "normal",
+            },
+        },
+        ...overrides,
+    };
+}
+function makeHooks() {
+    const created = [];
+    const destroyed = [];
+    const hooks = {
+        createRender: () => { const render = { visible: false }; created.push(render); return render; },
+        hideRender: (render) => { render.visible = false; },
+        destroyRender: (render) => { destroyed.push(render); },
+        getWorldTransform: () => ({ a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 }),
+    };
+    return { hooks, created, destroyed };
+}
+const area = { width: 100, height: 100, space: "local" };
+describe("ParticlePool", () => {
+    it("prewarms exactly capacity slots, never calls the factory on acquire/release, and reuses released identity", () => {
+        let created = 0;
+        const pool = new ParticlePool(() => ({ id: created++ }), 3);
+        expect(created).toBe(3);
+        const a = pool.acquire();
+        pool.acquire();
+        expect(created).toBe(3);
+        pool.release(a);
+        expect(pool.acquire()).toBe(a);
+        expect(created).toBe(3);
+    });
+    it("increments dropped and never exceeds capacity on exhaustion", () => {
+        const pool = new ParticlePool(() => ({}), 1);
+        pool.acquire();
+        expect(pool.acquire()).toBeUndefined();
+        expect(pool.dropped).toBe(1);
+    });
+    it("creates only the delta on growth and drains active slots beyond a shrunk capacity without recycling them", () => {
+        const destroyed = [];
+        let created = 0;
+        const pool = new ParticlePool(() => created++, 2, (value) => destroyed.push(value));
+        const a = pool.acquire(), b = pool.acquire();
+        pool.resize(4);
+        expect(created).toBe(4);
+        pool.resize(1);
+        expect(destroyed).toHaveLength(2); // the two idle free slots are destroyed immediately
+        pool.release(a); // still over the new capacity: destroyed instead of recycled
+        expect(destroyed).toHaveLength(3);
+        pool.release(b); // back at capacity: recycled normally
+        expect(destroyed).toHaveLength(3);
+        expect(pool.acquire()).toBe(b);
+    });
+});
+describe("ParticleSimulator determinism", () => {
+    it("gives the same active-slot state at fixed-step boundaries regardless of how render delta is split", () => {
+        const def = definition({ emission: { delay: 0, duration: 10, loop: true, rate: 30, bursts: [] } });
+        const simA = new ParticleSimulator(def, makeHooks().hooks);
+        const simB = new ParticleSimulator(def, makeHooks().hooks);
+        simA.play();
+        simB.play();
+        // Total stays comfortably under the 8-step catch-up cap for both splits, so the cap itself
+        // never becomes the variable under test — only the splitting is.
+        simA.update(0.1, area);
+        for (const chunk of [0.03, 0.02, 0.05])
+            simB.update(chunk, area);
+        const snapshot = (sim) => [...sim.activeSlots]
+            .map((slot) => ({ age: Math.round(slot.age * 1e6), x: Math.round(slot.x * 1e6), y: Math.round(slot.y * 1e6) }))
+            .sort((p, q) => p.age - q.age);
+        expect(snapshot(simA)).toEqual(snapshot(simB));
+        expect(simA.getDiagnostics()).toEqual(simB.getDiagnostics());
+    });
+});
+describe("ParticleSimulator burst scheduling", () => {
+    it("fires a burst with time 0 on the very first fixed step after start", () => {
+        const def = definition({ emission: { delay: 0, duration: 0.2, loop: true, rate: 0, bursts: [{ time: 0, count: 3 }] } });
+        def.particle.lifetime = { min: 100, max: 100 };
+        const sim = new ParticleSimulator(def, makeHooks().hooks);
+        sim.play();
+        sim.step(area);
+        expect(sim.activeSlots.size).toBe(3);
+    });
+    it("fires a non-loop burst exactly once even when stepped well past its trigger and duration", () => {
+        const def = definition({ emission: { delay: 0, duration: 0.5, loop: false, rate: 0, bursts: [{ time: 0.1, count: 2 }] } });
+        def.particle.lifetime = { min: 100, max: 100 };
+        const sim = new ParticleSimulator(def, makeHooks().hooks);
+        sim.play();
+        for (let i = 0; i < 4; i++)
+            sim.step(area); // well before the 0.1s trigger
+        expect(sim.activeSlots.size).toBe(0);
+        for (let i = 0; i < 4; i++)
+            sim.step(area); // now solidly past the trigger (8/60 ≈ 0.133s)
+        expect(sim.activeSlots.size).toBe(2);
+        for (let i = 0; i < 60; i++)
+            sim.step(area); // well past duration and beyond
+        expect(sim.activeSlots.size).toBe(2);
+    });
+    it("fires a loop burst again on the next cycle, including across the cycle boundary", () => {
+        const def = definition({ emission: { delay: 0, duration: 0.1, loop: true, rate: 0, bursts: [{ time: 0, count: 1 }] } });
+        def.particle.lifetime = { min: 100, max: 100 };
+        const sim = new ParticleSimulator(def, makeHooks().hooks);
+        sim.play();
+        sim.step(area); // first fixed step: elapsed ≈ 1/60, burst fires
+        expect(sim.activeSlots.size).toBe(1);
+        for (let i = 0; i < 3; i++)
+            sim.step(area); // elapsed ≈ 4/60, still inside the first cycle
+        expect(sim.activeSlots.size).toBe(1);
+        for (let i = 0; i < 3; i++)
+            sim.step(area); // elapsed ≈ 7/60, solidly past the 0.1s cycle boundary
+        expect(sim.activeSlots.size).toBe(2);
+    });
+});
+describe("ParticleSimulator lifecycle", () => {
+    it("stop() blocks new spawns while already-emitted particles drain to active === 0", () => {
+        const def = definition({ emission: { delay: 0, duration: 10, loop: true, rate: 0, bursts: [{ time: 0, count: 4 }] } });
+        def.particle.lifetime = { min: 2 / 60, max: 2 / 60 };
+        const sim = new ParticleSimulator(def, makeHooks().hooks);
+        sim.play();
+        sim.step(area);
+        expect(sim.activeSlots.size).toBe(4);
+        sim.stop();
+        expect(sim.getDiagnostics()).toMatchObject({ playing: false, stopped: true });
+        sim.step(area); // still simulating: ages toward death but hasn't reached lifetime yet
+        expect(sim.activeSlots.size).toBe(4);
+        sim.step(area); // lifetime reached; particles die and are not replaced because spawning is blocked
+        expect(sim.activeSlots.size).toBe(0);
+    });
+    it("dispose() immediately clears every slot, is idempotent, and excludes the simulator from further updates", () => {
+        const { hooks, created, destroyed } = makeHooks();
+        const def = definition({ maxParticles: 5, emission: { delay: 0, duration: 10, loop: true, rate: 0, bursts: [{ time: 0, count: 2 }] } });
+        const sim = new ParticleSimulator(def, hooks);
+        sim.play();
+        sim.step(area);
+        expect(sim.activeSlots.size).toBe(2);
+        sim.dispose();
+        expect(sim.activeSlots.size).toBe(0);
+        expect(destroyed).toHaveLength(created.length);
+        expect(sim.getDiagnostics()).toMatchObject({ active: 0, disposed: true });
+        sim.dispose(); // idempotent
+        sim.play();
+        sim.step(area);
+        sim.restart();
+        expect(sim.activeSlots.size).toBe(0);
+        expect(sim.getDiagnostics().disposed).toBe(true);
+    });
+    it("pause() freezes state, step() advances one fixed step regardless, and restart() replays the initial sequence and resets dropped", () => {
+        const def = definition({ maxParticles: 2, emission: { delay: 0, duration: 10, loop: true, rate: 0, bursts: [{ time: 0, count: 3 }] } });
+        const sim = new ParticleSimulator(def, makeHooks().hooks);
+        sim.play();
+        sim.step(area); // burst of 3 into a pool of 2: one dropped
+        expect(sim.getDiagnostics()).toMatchObject({ active: 2, dropped: 1 });
+        sim.pause();
+        sim.update(1, area); // paused: no time passes, no state changes
+        expect(sim.getDiagnostics()).toMatchObject({ active: 2, dropped: 1, playing: false, stopped: false }); // paused is distinct from stopped
+        sim.step(area); // step still advances one fixed tick even while paused
+        expect(sim.getDiagnostics().playing).toBe(false); // ...without leaving pause
+        sim.restart();
+        expect(sim.getDiagnostics()).toMatchObject({ active: 0, dropped: 0, playing: true });
+        sim.step(area);
+        expect(sim.getDiagnostics()).toMatchObject({ active: 2, dropped: 1 });
+    });
+});
+describe("ParticleSimulator incremental sync", () => {
+    it("never restarts on an unrelated clone or a seed edit", () => {
+        const def = definition({ maxParticles: 3, seed: 7, emission: { delay: 0, duration: 10, loop: true, rate: 0, bursts: [{ time: 0, count: 2 }] } });
+        const sim = new ParticleSimulator(def, makeHooks().hooks);
+        sim.play();
+        sim.step(area);
+        expect(sim.activeSlots.size).toBe(2);
+        const renamed = structuredClone(def);
+        renamed.name = "Renamed";
+        sim.syncEffect(renamed);
+        expect(sim.activeSlots.size).toBe(2);
+        const reseeded = structuredClone(renamed);
+        reseeded.seed = 999;
+        sim.syncEffect(reseeded);
+        expect(sim.activeSlots.size).toBe(2); // seed only applies at the next explicit restart()
+    });
+    it("resizes the pool live on a maxParticles change without disturbing existing particles", () => {
+        const def = definition({ maxParticles: 2, emission: { delay: 0, duration: 10, loop: true, rate: 60, bursts: [] } });
+        const sim = new ParticleSimulator(def, makeHooks().hooks);
+        sim.play();
+        sim.step(area);
+        sim.step(area);
+        sim.step(area); // 3 spawns attempted at 1/tick, pool holds 2, 1 dropped
+        expect(sim.getDiagnostics()).toMatchObject({ active: 2, dropped: 1 });
+        const grown = structuredClone(def);
+        grown.maxParticles = 4;
+        sim.syncEffect(grown);
+        expect(sim.getDiagnostics()).toMatchObject({ active: 2, dropped: 1 }); // sync itself changes nothing
+        sim.step(area);
+        sim.step(area); // 2 more spawns now fit in the grown pool
+        expect(sim.getDiagnostics()).toMatchObject({ active: 4, dropped: 1 });
+    });
+});
+//# sourceMappingURL=particles.test.js.map

package/dist/particles.test.js.map

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

package/dist/scene.d.ts

@@ -0,0 +1,41 @@
+import { type SkeletonData } from "@esotericsoftware/spine-pixi-v8";
+import { type EffectDefinition, type LayoutProfileId, type ProjectDocument, type Scene, type UINode } from "@pixi-ui-editor/schema";
+import { Container, Texture } from "pixi.js";
+import { type FileUrlResolver } from "./assets/textures.js";
+import { type LayoutSize } from "./layout.js";
+import { type SceneInteractionMode } from "./views/NodeView.js";
+import type { Sound } from "@pixi/sound";
+export type BuildSceneViewOptions = {
+    /** Explicit: an editor canvas must pass "authoring", Preview and the consuming app "runtime". */
+    interaction: SceneInteractionMode;
+    textures?: ReadonlyMap<string, Texture>;
+    spines?: ReadonlyMap<string, SkeletonData>;
+    fonts?: ReadonlyMap<string, string>;
+    sounds?: ReadonlyMap<string, Sound>;
+    /** Called after Yoga changes a managed rectangle; authoring hosts use it to refresh overlays. */
+    onLayout?: () => void;
+};
+/** Builds a PixiJS display tree for a scene without depending on DOM or editor state. */
+export declare function buildSceneView(document: ProjectDocument, sceneId: string, profile: LayoutProfileId, options: BuildSceneViewOptions): {
+    root: Container;
+    nodeViews: Map<string, Container>;
+};
+/**
+ * Applies a node's resolved transform, visibility, and content to an existing display object,
+ * so editors can update views in place without rebuilding the scene tree.
+ */
+export declare function updateNodeView(view: Container, node: UINode, profile: LayoutProfileId, parentSize?: LayoutSize, parentNode?: UINode, effect?: EffectDefinition): void;
+/** Previews a resolved editor rectangle without consulting content bounds or rebuilding the view. */
+export declare function previewNodeView(view: Container, node: UINode, profile: LayoutProfileId, transform: UINode["transform"]): void;
+/** Hosts call this from their own Application ticker; runtime never subscribes to Ticker.shared. */
+export declare function updateParticleEmitters(root: Container, deltaSeconds: number): void;
+/** Lists the nodes a scene renders, including nodes of prefab definitions its prefab instances expand to. */
+export declare function collectRenderedNodes(document: ProjectDocument, scene: Scene): UINode[];
+/** Loads a scene's textures and Spine data, then builds its display tree in one call. */
+export declare function loadSceneView(document: ProjectDocument, sceneId: string, profile: LayoutProfileId, resolveFileUrl: FileUrlResolver, options: {
+    interaction: SceneInteractionMode;
+}): Promise<{
+    root: Container;
+    nodeViews: Map<string, Container>;
+}>;
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAmC,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrK,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE7C,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAAqD,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAY,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAM1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG;IAClC,iGAAiG;IACjG,WAAW,EAAE,oBAAoB,CAAC;IAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,qBAAqB,GAC7B;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAE,CA2ExD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAYrK;AAED,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI,CAG7H;AAED,oGAAoG;AACpG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAGlF;AAED,6GAA6G;AAC7G,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAgBtF;AAED,yFAAyF;AACzF,wBAAsB,aAAa,CACjC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE;IAAE,WAAW,EAAE,oBAAoB,CAAA;CAAE,GAC7C,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAE,CAAC,CAOjE"}

package/dist/scene.js

@@ -0,0 +1,147 @@
+import { isLayoutGroup, isParticleEffect } from "@pixi-ui-editor/schema";
+import { Container } from "pixi.js";
+import { loadSceneSpines } from "./assets/spine.js";
+import { loadSceneTextures } from "./assets/textures.js";
+import { loadSceneFonts } from "./assets/fonts.js";
+import { resolveAnchoredTransform, resolveProfileTransform } from "./layout.js";
+import { NodeView } from "./views/NodeView.js";
+import { createNodeView } from "./views/createNodeView.js";
+import { applyLayoutGroup, applyLayoutItem, createGridLineBreak, initializePixiLayout, LayoutItemContainer } from "./layoutGroups.js";
+import { LayoutGroupNodeView } from "./views/basic.js";
+import { ScrollItemContainer } from "./scrollView.js";
+import { ScrollViewNodeView } from "./views/ScrollViewNodeView.js";
+/** Builds a PixiJS display tree for a scene without depending on DOM or editor state. */
+export function buildSceneView(document, sceneId, profile, options) {
+    initializePixiLayout();
+    const { interaction, textures, spines, fonts, sounds, onLayout } = options;
+    const scene = document.scenes.find((candidate) => candidate.id === sceneId);
+    if (scene === undefined) {
+        throw new Error(`Scene '${sceneId}' does not exist in the project document.`);
+    }
+    const nodeViews = new Map();
+    // Views раскрытых prefab-определений не регистрируются в nodeViews: инстанс редактируется как единое целое.
+    const buildOwner = (owner, registerViews, expandingPrefabIds, rootSize) => {
+        const nodesById = new Map(owner.nodes.map((node) => [node.id, node]));
+        const buildNode = (nodeId, parentSize) => {
+            const node = nodesById.get(nodeId);
+            if (node === undefined) {
+                throw new Error(`Scene '${sceneId}' references missing node '${nodeId}'.`);
+            }
+            const resolved = resolveProfileTransform(node, profile);
+            const transform = resolveAnchoredTransform(resolved.transform, parentSize);
+            const view = createNodeView(node, interaction, textures, spines, (prefabId) => {
+                const prefab = document.prefabs.find((candidate) => candidate.id === prefabId);
+                if (prefab === undefined || expandingPrefabIds.has(prefabId))
+                    return undefined;
+                return buildOwner(prefab, false, new Set([...expandingPrefabIds, prefabId]), { width: transform.width, height: transform.height });
+            }, fonts, sounds, node.type === "particle-emitter" ? document.effects.find((effect) => effect.id === node.effectId && isParticleEffect(effect)) : undefined);
+            if (isLayoutGroup(node))
+                applyLayoutGroup(view, node, profile, parentSize);
+            // Yoga owns only the group's inner layoutContent; the outer NodeView keeps authored transform.
+            view.update(node, profile, parentSize);
+            if (registerViews)
+                nodeViews.set(node.id, view);
+            const childSize = owner === scene && node.parentId === null
+                ? rootSize
+                : { width: transform.width, height: transform.height };
+            for (const [childIndex, childId] of node.children.entries()) {
+                const childNode = nodesById.get(childId);
+                const childView = buildNode(childId, childSize);
+                if (isLayoutGroup(node) && childNode !== undefined && view instanceof LayoutGroupNodeView) {
+                    const layoutItem = new LayoutItemContainer(childView, onLayout);
+                    applyLayoutItem(layoutItem, childNode, node, profile);
+                    view.addLayoutChild(layoutItem);
+                }
+                else if (node.type === "scroll-view" && childNode !== undefined && view instanceof ScrollViewNodeView) {
+                    const scrollItem = new ScrollItemContainer(childView, onLayout);
+                    // Как и у layout-item: собственный (не растянутый якорями) размер ребёнка — List не
+                    // предоставляет per-item override размера, в отличие от Yoga flexGrow/cellSize.
+                    const own = resolveProfileTransform(childNode, profile).transform;
+                    scrollItem.sync(childNode, profile, { width: own.width, height: own.height });
+                    view.addScrollItem(scrollItem);
+                }
+                else {
+                    view.addChild(childView);
+                }
+                if (node.type === "grid-layout") {
+                    const settings = node.layoutGroup.overrides?.[profile] === undefined ? node.layoutGroup.base : { ...node.layoutGroup.base, ...node.layoutGroup.overrides[profile] };
+                    if (settings.constraint !== "flexible" && settings.constraintCount !== undefined && (childIndex + 1) % settings.constraintCount === 0 && childIndex + 1 < node.children.length) {
+                        const lineBreak = createGridLineBreak(node, profile);
+                        if (lineBreak !== undefined && view instanceof LayoutGroupNodeView)
+                            view.addLayoutChild(lineBreak);
+                    }
+                }
+            }
+            return view;
+        };
+        const ownerRoot = new Container();
+        for (const rootNodeId of owner.rootNodeIds) {
+            ownerRoot.addChild(buildNode(rootNodeId, rootSize));
+        }
+        return ownerRoot;
+    };
+    return { root: buildOwner(scene, true, new Set(), scene.layout.referenceViewports[profile]), nodeViews };
+}
+/**
+ * Applies a node's resolved transform, visibility, and content to an existing display object,
+ * so editors can update views in place without rebuilding the scene tree.
+ */
+export function updateNodeView(view, node, profile, parentSize, parentNode, effect) {
+    if (isLayoutGroup(node))
+        applyLayoutGroup(view, node, profile, parentSize);
+    if (!(view instanceof NodeView))
+        return;
+    if (node.type === "particle-emitter" && effect !== undefined && isParticleEffect(effect) && "syncEffect" in view && typeof view.syncEffect === "function")
+        view.syncEffect(effect);
+    if (parentNode !== undefined && isLayoutGroup(parentNode) && view.parent instanceof LayoutItemContainer) {
+        applyLayoutItem(view.parent, node, parentNode, profile);
+    }
+    else if (parentNode !== undefined && parentNode.type === "scroll-view" && view.parent instanceof ScrollItemContainer) {
+        const own = resolveProfileTransform(node, profile).transform;
+        view.parent.sync(node, profile, { width: own.width, height: own.height });
+    }
+    else {
+        view.update(node, profile, parentSize);
+    }
+}
+/** Previews a resolved editor rectangle without consulting content bounds or rebuilding the view. */
+export function previewNodeView(view, node, profile, transform) {
+    if (isLayoutGroup(node))
+        applyLayoutGroup(view, node, profile, undefined, { width: transform.width, height: transform.height });
+    if (view instanceof NodeView)
+        view.preview(node, transform, resolveProfileTransform(node, profile).visible);
+}
+/** Hosts call this from their own Application ticker; runtime never subscribes to Ticker.shared. */
+export function updateParticleEmitters(root, deltaSeconds) {
+    const visit = (view) => { if ("updateParticles" in view && typeof view.updateParticles === "function")
+        view.updateParticles(deltaSeconds); view.children.forEach(visit); };
+    visit(root);
+}
+/** Lists the nodes a scene renders, including nodes of prefab definitions its prefab instances expand to. */
+export function collectRenderedNodes(document, scene) {
+    const nodes = [];
+    const expandedPrefabIds = new Set();
+    const visit = (list) => {
+        for (const node of list) {
+            nodes.push(node);
+            if (node.type !== "prefab-instance" || expandedPrefabIds.has(node.prefabId))
+                continue;
+            expandedPrefabIds.add(node.prefabId);
+            const prefab = document.prefabs.find((candidate) => candidate.id === node.prefabId);
+            if (prefab !== undefined)
+                visit(prefab.nodes);
+        }
+    };
+    visit(scene.nodes);
+    return nodes;
+}
+/** Loads a scene's textures and Spine data, then builds its display tree in one call. */
+export async function loadSceneView(document, sceneId, profile, resolveFileUrl, options) {
+    const [textures, spines, fonts] = await Promise.all([
+        loadSceneTextures(document, sceneId, (asset) => (asset.type === "image" ? resolveFileUrl(asset.source.uri) : undefined), resolveFileUrl),
+        loadSceneSpines(document, sceneId, resolveFileUrl),
+        loadSceneFonts(document, sceneId, resolveFileUrl),
+    ]);
+    return buildSceneView(document, sceneId, profile, { interaction: options.interaction, textures, spines, fonts });
+}
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

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

package/dist/scrollView.d.ts

@@ -0,0 +1,28 @@
+import { type LayoutProfileId, type ScrollViewNode, type UINode } from "@pixi-ui-editor/schema";
+import type { ListType } from "@pixi/ui";
+import { Container } from "pixi.js";
+import type { LayoutSize } from "./layout.js";
+import { NodeView } from "./views/NodeView.js";
+/** `@pixi/ui`'s `List` only knows "vertical" | "horizontal" | "bidirectional". */
+export declare const SCROLL_DIRECTION_TO_LIST_TYPE: Record<ScrollViewNode["scrollView"]["direction"], ListType>;
+/**
+ * Runtime-only position owner for one direct scroll-view child. `@pixi/ui`'s `List` arranges items
+ * by reading `Container.width`/`height` and writing `x`/`y` directly; a bare `NodeView` reports 0 for
+ * both when it renders nothing (same issue the base grab-rectangle works around for hit testing), so
+ * this wrapper reports the child's own logical rectangle instead. `List` owns only this wrapper's
+ * position — the wrapped `NodeView` keeps its own pivot/rotation/scale/visibility contract via
+ * `updateManaged`, exactly like a layout group's `LayoutItemContainer`.
+ */
+export declare class ScrollItemContainer extends Container {
+    readonly nodeView: NodeView;
+    private readonly onResized?;
+    private itemWidth;
+    private itemHeight;
+    constructor(nodeView: NodeView, onResized?: (() => void) | undefined);
+    get width(): number;
+    set width(value: number);
+    get height(): number;
+    set height(value: number);
+    sync(node: UINode, profile: LayoutProfileId, size: LayoutSize): void;
+}
+//# sourceMappingURL=scrollView.d.ts.map

package/dist/scrollView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollView.d.ts","sourceRoot":"","sources":["../src/scrollView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,kFAAkF;AAClF,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,CAIrG,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IAIpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAHpE,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;gBAEF,QAAQ,EAAE,QAAQ,EAAmB,SAAS,CAAC,GAAE,MAAM,IAAI,aAAA;IAKhF,IAAa,KAAK,IAAI,MAAM,CAA2B;IACvD,IAAa,KAAK,CAAC,KAAK,EAAE,MAAM,EAA6B;IAC7D,IAAa,MAAM,IAAI,MAAM,CAA4B;IACzD,IAAa,MAAM,CAAC,KAAK,EAAE,MAAM,EAA8B;IAE/D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;CAMrE"}

package/dist/scrollView.js

@@ -0,0 +1,38 @@
+import { Container } from "pixi.js";
+/** `@pixi/ui`'s `List` only knows "vertical" | "horizontal" | "bidirectional". */
+export const SCROLL_DIRECTION_TO_LIST_TYPE = {
+    vertical: "vertical",
+    horizontal: "horizontal",
+    both: "bidirectional",
+};
+/**
+ * Runtime-only position owner for one direct scroll-view child. `@pixi/ui`'s `List` arranges items
+ * by reading `Container.width`/`height` and writing `x`/`y` directly; a bare `NodeView` reports 0 for
+ * both when it renders nothing (same issue the base grab-rectangle works around for hit testing), so
+ * this wrapper reports the child's own logical rectangle instead. `List` owns only this wrapper's
+ * position — the wrapped `NodeView` keeps its own pivot/rotation/scale/visibility contract via
+ * `updateManaged`, exactly like a layout group's `LayoutItemContainer`.
+ */
+export class ScrollItemContainer extends Container {
+    nodeView;
+    onResized;
+    itemWidth = 0;
+    itemHeight = 0;
+    constructor(nodeView, onResized) {
+        super();
+        this.nodeView = nodeView;
+        this.onResized = onResized;
+        super.addChild(nodeView);
+    }
+    get width() { return this.itemWidth; }
+    set width(value) { this.itemWidth = value; }
+    get height() { return this.itemHeight; }
+    set height(value) { this.itemHeight = value; }
+    sync(node, profile, size) {
+        this.itemWidth = size.width;
+        this.itemHeight = size.height;
+        this.nodeView.updateManaged(node, profile, size);
+        this.onResized?.();
+    }
+}
+//# sourceMappingURL=scrollView.js.map

package/dist/scrollView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollView.js","sourceRoot":"","sources":["../src/scrollView.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIpC,kFAAkF;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAgE;IACxG,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,eAAe;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAI3B;IAAqC;IAHlD,SAAS,GAAG,CAAC,CAAC;IACd,UAAU,GAAG,CAAC,CAAC;IAEvB,YAAqB,QAAkB,EAAmB,SAAsB;QAC9E,KAAK,EAAE,CAAC;QADW,aAAQ,GAAR,QAAQ,CAAU;QAAmB,cAAS,GAAT,SAAS,CAAa;QAE9E,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,IAAa,KAAK,KAAa,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACvD,IAAa,KAAK,CAAC,KAAa,IAAI,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7D,IAAa,MAAM,KAAa,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACzD,IAAa,MAAM,CAAC,KAAa,IAAI,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC;IAE/D,IAAI,CAAC,IAAY,EAAE,OAAwB,EAAE,IAAgB;QAC3D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/test.setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.setup.d.ts.map

package/dist/test.setup.d.ts.map

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

package/dist/test.setup.js

@@ -0,0 +1,6 @@
+Object.defineProperty(globalThis, "navigator", {
+    configurable: true,
+    value: { userAgent: "node" },
+});
+export {};
+//# sourceMappingURL=test.setup.js.map

package/dist/test.setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.setup.js","sourceRoot":"","sources":["../src/test.setup.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE;IAC7C,YAAY,EAAE,IAAI;IAClB,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;CAC7B,CAAC,CAAC"}

package/dist/views/ButtonNodeView.d.ts

@@ -0,0 +1,36 @@
+import { type ButtonStateKey, type UINode } from "@pixi-ui-editor/schema";
+import { FancyButton } from "@pixi/ui";
+import type { Sound } from "@pixi/sound";
+import { Texture } from "pixi.js";
+import { NodeView, type SceneInteractionMode } from "./NodeView.js";
+export type ButtonNode = Extract<UINode, {
+    type: "button";
+}>;
+/**
+ * Adapts a button node to `@pixi/ui`'s `FancyButton`, which owns the pointer state machine —
+ * this class never reimplements it. Optional states fall back to the normal image, and runtime
+ * changes to `enabled` or the current state stay in the view: they never touch the document.
+ */
+export declare class ButtonNodeView extends NodeView {
+    private readonly button;
+    private readonly stateViews;
+    private readonly interaction;
+    private readonly sounds;
+    private soundAssetIds;
+    private enabledState;
+    constructor(node: ButtonNode, textures: ReadonlyMap<string, Texture> | undefined, interaction: SceneInteractionMode, sounds?: ReadonlyMap<string, Sound>);
+    /** In authoring mode `enabled` may only drive the visuals: `FancyButton` couples it to `eventMode`. */
+    private applyEnabled;
+    protected syncContent(node: UINode, transform: UINode["transform"]): void;
+    get enabled(): boolean;
+    set enabled(value: boolean);
+    get state(): ButtonStateKey;
+    /** Forces a visual state without changing `enabled`, so a disabled button still emits no press. */
+    setState(state: ButtonStateKey): void;
+    get onPress(): FancyButton["onPress"];
+    get onDown(): FancyButton["onDown"];
+    get onUp(): FancyButton["onUp"];
+    get onHover(): FancyButton["onHover"];
+    get onOut(): FancyButton["onOut"];
+}
+//# sourceMappingURL=ButtonNodeView.d.ts.map

package/dist/views/ButtonNodeView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ButtonNodeView.d.ts","sourceRoot":"","sources":["../../src/views/ButtonNodeView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAA+B,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAK7D;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAAU;gBAElB,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC;IAiCxJ,uGAAuG;IACvG,OAAO,CAAC,YAAY;IAMpB,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,IAAI;IAsBzE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED,IAAI,KAAK,IAAI,cAAc,CAE1B;IAED,mGAAmG;IACnG,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAIrC,IAAI,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,CAAgC;IACrE,IAAI,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,CAA+B;IAClE,IAAI,IAAI,IAAI,WAAW,CAAC,MAAM,CAAC,CAA6B;IAC5D,IAAI,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,CAAgC;IACrE,IAAI,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAA8B;CAChE"}