@pixi-ui-editor/runtime-pixi 0.3.0 → 0.5.0

package/README.md

@@ -17,12 +17,12 @@ import { loadPrefabView } from "@pixi-ui-editor/runtime-pixi";
 import { materializedPrefabNodeId } from "@pixi-ui-editor/schema";
 
 const configured = scene.nodes.find(
-  (node) => node.type === "prefab-instance" && node.binding === "rewardCardTemplate",
+  (node) => node.type === "prefab-instance" && node.bindingKey === "rewardCardTemplate",
 );
 if (configured?.type !== "prefab-instance") throw new Error("Configured preset instance is missing.");
 const labelDefinitionNodeId = document.prefabs
   .find((prefab) => prefab.id === configured.prefabId)!
-  .nodes.find((node) => node.binding === "label")!.id;
+  .nodes.find((node) => node.bindingKey === "label")!.id;
 
 const mounted = await loadPrefabView(
   document,
@@ -44,3 +44,82 @@ const labelView = mounted.nodeViews.get(
 
 Omit the last argument to instantiate the prefab definition defaults. `nodeViews` contains the outer
 instance plus deterministic instance-scoped IDs for inherited children and stable IDs for local children.
+
+The lookup above is two-step on purpose, and it is the contract: a `bindingKey` is unique within the scope
+it resolves against, not across the whole document. A key on a scene node — including a preset instance
+itself — is unique within that scene. A key inside a preset definition is unique within that definition and
+resolves against one instance, which is what makes it usable for presets you spawn many times: a hundred
+symbol views can each carry `"spine"` without colliding. So you find the instance by its scene-level key,
+then find the node inside it by its definition-level key.
+
+## Reuse parsed assets across loads
+
+`loadPrefabView` and `loadSceneView` fetch and parse every asset a scene references. Spawning presets one
+by one — a symbol view per reel stop, a card per deal — repeats that work for each call: the skeleton JSON
+is re-parsed, the atlas is rebuilt, and every texture becomes a separate GPU upload of the same file.
+
+Pass an `assetCache` you own to share the parsed results. Its lifetime is yours: keep one per scene session
+and drop it with the scene.
+
+```ts
+import { createSceneAssetCache, loadPrefabView } from "@pixi-ui-editor/runtime-pixi";
+
+const assetCache = createSceneAssetCache();
+
+const mounted = await loadPrefabView(document, prefabId, "desktop", resolveFileUrl, {
+  interaction: "runtime",
+  assetCache,
+});
+```
+
+Each map is keyed by the asset file's URI, so the same file assigned to different assets loads once. Without
+`assetCache` every call starts from empty maps, which is fine for a single scene load and wasteful for
+anything spawned repeatedly. The lower-level `loadSceneTextures` / `loadSceneSpines` / `loadSceneFonts` /
+`loadSceneSounds` take the individual maps directly if you drive loading yourself.
+
+## Scene viewport
+
+`buildSceneView` and `loadSceneView` return a runtime-owned `SceneViewport` as `root`. With
+`interaction: "runtime"`, that object clips content to the authored reference viewport and owns the
+only contain-fit calculation used by Preview and consuming applications:
+
+```ts
+const { root } = await loadSceneView(document, sceneId, profile, resolveFileUrl, {
+  interaction: "runtime",
+});
+
+app.stage.addChild(root);
+root.resize({ width: app.screen.width, height: app.screen.height });
+```
+
+Call `root.resize(...)` after the Pixi renderer changes size. It applies one uniform scale and centers
+the unchanged authored viewport; letterbox and pillarbox space never reveal off-viewport content.
+Profile selection remains shared through `resolveProfileForViewport`, and crossing its breakpoint
+requires building the scene again with the newly selected profile. Hosts must not reproduce the fit
+formula or add their own viewport mask. Spawned prefab views stay unclipped because they are scene
+content rather than player-screen boundaries.
+
+## Localization
+
+`buildSceneView`, `loadSceneView`, `buildPrefabView` and `loadPrefabView` return a `SceneLocalization`
+next to `root` and `nodeViews`. A `Text` node that carries a `textKey` already renders its base-locale
+translation without any extra call; a document without keys behaves exactly as before.
+
+```ts
+const { root, localization } = await loadSceneView(document, sceneId, "desktop", resolveFileUrl, {
+  interaction: "runtime",
+});
+
+localization.setLocale("pt-BR");
+// Values ship as a flat Record<string, string> in locales/<locale>.json, so any dictionary works.
+localization.setTranslate((key, { locale }) => dictionaries[locale]?.[key]);
+// `{amount}` inside a translation is a runtime parameter, not a second key.
+localization.setParams({ amount: 48 });
+// An immutable editor/game store hands over a new document copy without rebuilding the scene.
+localization.syncDocument(nextDocument);
+```
+
+Resolution order is `translate` → requested locale → base locale → `Text.text` → the key itself; a
+`translate` returning `undefined` keeps the chain going. Every call mutates the existing `TextNodeView`
+objects: the scene root, `NodeView` identity and live control state are preserved, and re-rendering the
+same string does no work at all.

package/dist/SceneViewport.d.ts

@@ -0,0 +1,17 @@
+import { Container } from "pixi.js";
+import { type FittedViewport, type LayoutSize } from "./layout.js";
+/**
+ * The single host boundary for a built scene.
+ *
+ * Runtime scenes are clipped to the authored reference viewport and can only be fitted with one
+ * uniform scale. Authoring scenes use the same wrapper without clipping so the editor can expose
+ * off-viewport content while arranging it.
+ */
+export declare class SceneViewport extends Container {
+    readonly referenceViewport: LayoutSize;
+    readonly content: Container;
+    constructor(content: Container, referenceViewport: LayoutSize, clip: boolean);
+    /** Uniformly contains and centers this authored viewport inside the physical host. */
+    resize(host: LayoutSize): FittedViewport;
+}
+//# sourceMappingURL=SceneViewport.d.ts.map

package/dist/SceneViewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneViewport.d.ts","sourceRoot":"","sources":["../src/SceneViewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAqB,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtF;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,SAAS;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;gBAEhB,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;IAiB5E,sFAAsF;IACtF,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc;CAMzC"}

package/dist/SceneViewport.js

@@ -0,0 +1,35 @@
+import { Container, Graphics } from "pixi.js";
+import { fitViewportToHost } from "./layout.js";
+/**
+ * The single host boundary for a built scene.
+ *
+ * Runtime scenes are clipped to the authored reference viewport and can only be fitted with one
+ * uniform scale. Authoring scenes use the same wrapper without clipping so the editor can expose
+ * off-viewport content while arranging it.
+ */
+export class SceneViewport extends Container {
+    referenceViewport;
+    content;
+    constructor(content, referenceViewport, clip) {
+        super();
+        this.content = content;
+        this.referenceViewport = { ...referenceViewport };
+        if (clip) {
+            const viewportMask = new Graphics()
+                .rect(0, 0, referenceViewport.width, referenceViewport.height)
+                .fill(0xffffff);
+            viewportMask.eventMode = "none";
+            content.mask = viewportMask;
+            this.addChild(viewportMask);
+        }
+        this.addChild(content);
+    }
+    /** Uniformly contains and centers this authored viewport inside the physical host. */
+    resize(host) {
+        const fitted = fitViewportToHost(this.referenceViewport, host);
+        this.scale.set(fitted.scale);
+        this.position.set(fitted.x, fitted.y);
+        return fitted;
+    }
+}
+//# sourceMappingURL=SceneViewport.js.map

package/dist/SceneViewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneViewport.js","sourceRoot":"","sources":["../src/SceneViewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAwC,MAAM,aAAa,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IACjC,iBAAiB,CAAa;IAC9B,OAAO,CAAY;IAE5B,YAAY,OAAkB,EAAE,iBAA6B,EAAE,IAAa;QAC1E,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,iBAAiB,GAAG,EAAE,GAAG,iBAAiB,EAAE,CAAC;QAElD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,YAAY,GAAG,IAAI,QAAQ,EAAE;iBAChC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC;iBAC7D,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClB,YAAY,CAAC,SAAS,GAAG,MAAM,CAAC;YAChC,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,IAAgB;QACrB,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/assets/bitmapFonts.d.ts

@@ -0,0 +1,22 @@
+import type { Asset, ProjectDocument } from "@pixi-ui-editor/schema";
+import { BitmapFont, type Texture } from "pixi.js";
+import type { FileUrlResolver } from "./textures.js";
+type BitmapFontAsset = Extract<Asset, {
+    type: "bitmapFont";
+}>;
+/**
+ * Loads scene bitmap fonts before views are built, mirroring `loadSceneFonts`. Unlike a regular
+ * `FontFace`, PixiJS resolves a `BitmapText`'s font by looking up `Cache` for `${fontFamily}-bitmap`
+ * (see `BitmapFontManager.getFont`), so loading here means parsing the XML, building one `BitmapFont`
+ * from the already-fetched texture, and registering it in that cache — there is no URL-based loader
+ * to delegate to, since our XML and texture live at unrelated asset URIs, not a fixed relative pair.
+ */
+export declare function loadSceneBitmapFonts(document: ProjectDocument, sceneId: string, resolveFileUrl: FileUrlResolver, cache?: Map<string, Promise<BitmapFont | undefined>>): Promise<Map<string, string>>;
+/**
+ * Resolves one glyph's already-cropped `Texture` from a bitmap font asset, for reuse as a plain image
+ * asset (an Image node, a Button/Checkbox state, ...) — see `BitmapFontAsset.frames`. `BitmapFont`
+ * builds one `Texture` per character up front (see its constructor), so this is a lookup, not a crop.
+ */
+export declare function loadBitmapFontGlyphTexture(asset: BitmapFontAsset, glyph: string, resolveFileUrl: FileUrlResolver, cache?: Map<string, Promise<BitmapFont | undefined>>): Promise<Texture | undefined>;
+export {};
+//# sourceMappingURL=bitmapFonts.d.ts.map

package/dist/assets/bitmapFonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFonts.d.ts","sourceRoot":"","sources":["../../src/assets/bitmapFonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAU,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAoC,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAMrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,KAAK,eAAe,GAAG,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AAqC9D;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAyB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAYjO;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAyB,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAGlO"}

package/dist/assets/bitmapFonts.js

@@ -0,0 +1,75 @@
+import { BitmapFont, Cache, bitmapFontXMLStringParser } from "pixi.js";
+import { collectRenderedNodes } from "../scene.js";
+import { sharedBitmapFontCache } from "./cache.js";
+import { loadTexture } from "./loadTexture.js";
+const keyOf = (asset) => `${asset.files.xml.uri}#${asset.files.texture.uri}`;
+/**
+ * The synthetic family every loaded font installs under — never whatever `<info face>` its XML
+ * declares. Two uploaded bitmap fonts could share the same exporter-generated face name, and the
+ * asset id is the only identity PixiJS's `${fontFamily}-bitmap` Cache key is guaranteed not to collide on.
+ */
+const familyOf = (assetId) => `bitmap-font-${assetId}`;
+const fromNodes = (nodes) => nodes.flatMap((node) => (node.type === "bitmap-text" ? [node.assetId] : []));
+/**
+ * Shared by `loadSceneFonts`'s reasoning (see `sharedFontCache`): a loaded `BitmapFont` registers into
+ * PixiJS's own global `Cache`, so re-parsing the same asset under a caller-scoped cache would still
+ * collide there. `cache` defaults to that shared map but accepts a `SceneAssetCache.bitmapFonts` from
+ * the caller, the same override every other scene asset loader takes.
+ */
+function loadFont(asset, resolveFileUrl, cache) {
+    const key = keyOf(asset);
+    let pending = cache.get(key);
+    if (pending === undefined) {
+        pending = (async () => {
+            const xmlUrl = resolveFileUrl(asset.files.xml.uri);
+            const textureUrl = resolveFileUrl(asset.files.texture.uri);
+            if (xmlUrl === undefined || textureUrl === undefined)
+                return undefined;
+            try {
+                const [xml, texture] = await Promise.all([fetch(xmlUrl).then((response) => response.text()), loadTexture(textureUrl)]);
+                const font = new BitmapFont({ data: bitmapFontXMLStringParser.parse(xml), textures: [texture] });
+                Cache.set(`${familyOf(asset.id)}-bitmap`, font);
+                return font;
+            }
+            catch (error) {
+                console.warn(`Unable to load bitmap font asset '${asset.id}'. Text using it will not render.`, error);
+                return undefined;
+            }
+        })();
+        cache.set(key, pending);
+    }
+    return pending;
+}
+/**
+ * Loads scene bitmap fonts before views are built, mirroring `loadSceneFonts`. Unlike a regular
+ * `FontFace`, PixiJS resolves a `BitmapText`'s font by looking up `Cache` for `${fontFamily}-bitmap`
+ * (see `BitmapFontManager.getFont`), so loading here means parsing the XML, building one `BitmapFont`
+ * from the already-fetched texture, and registering it in that cache — there is no URL-based loader
+ * to delegate to, since our XML and texture live at unrelated asset URIs, not a fixed relative pair.
+ */
+export async function loadSceneBitmapFonts(document, sceneId, resolveFileUrl, cache = sharedBitmapFontCache) {
+    const scene = document.scenes.find((item) => item.id === sceneId);
+    if (scene === undefined)
+        throw new Error(`Scene '${sceneId}' does not exist in the project document.`);
+    const ids = new Set(fromNodes(collectRenderedNodes(document, scene)));
+    const fonts = new Map();
+    await Promise.all([...ids].map(async (id) => {
+        const asset = document.assets.find((item) => item.id === id);
+        if (asset?.type !== "bitmapFont")
+            return;
+        const font = await loadFont(asset, resolveFileUrl, cache);
+        if (font !== undefined)
+            fonts.set(id, familyOf(asset.id));
+    }));
+    return fonts;
+}
+/**
+ * Resolves one glyph's already-cropped `Texture` from a bitmap font asset, for reuse as a plain image
+ * asset (an Image node, a Button/Checkbox state, ...) — see `BitmapFontAsset.frames`. `BitmapFont`
+ * builds one `Texture` per character up front (see its constructor), so this is a lookup, not a crop.
+ */
+export async function loadBitmapFontGlyphTexture(asset, glyph, resolveFileUrl, cache = sharedBitmapFontCache) {
+    const font = await loadFont(asset, resolveFileUrl, cache);
+    return font?.chars[glyph]?.texture;
+}
+//# sourceMappingURL=bitmapFonts.js.map

package/dist/assets/bitmapFonts.js.map

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

package/dist/assets/cache.d.ts

@@ -0,0 +1,31 @@
+import type { SkeletonData } from "@esotericsoftware/spine-pixi-v8";
+import type { Sound } from "@pixi/sound";
+import type { BitmapFont, Spritesheet, Texture } from "pixi.js";
+/**
+ * Разобранные ассеты, переиспользуемые между загрузками сцен и пресетов. Каждая карта ключуется URI
+ * файла ассета, а не его id: один и тот же файл, назначенный разным ассетам, скачивается и парсится один раз.
+ *
+ * Владелец кэша — вызывающая сторона: время жизни задаёт она (сессия сцены в игре, открытый проект в
+ * редакторе), поэтому глобального состояния и скрытого сброса здесь нет.
+ */
+export interface SceneAssetCache {
+    textures: Map<string, Texture>;
+    spritesheets: Map<string, Spritesheet>;
+    spines: Map<string, SkeletonData>;
+    /** Обещание, а не готовое имя family: параллельные загрузки одного файла должны ждать один и тот же `FontFace.load()`. */
+    fonts: Map<string, Promise<string | undefined>>;
+    /** Обещание, а не готовый `BitmapFont`: по той же причине, что `fonts` — см. ниже. */
+    bitmapFonts: Map<string, Promise<BitmapFont | undefined>>;
+    sounds: Map<string, Sound>;
+}
+/**
+ * Шрифты кэшируются глобально, потому что `loadSceneFonts` регистрирует `FontFace` в общем для документа
+ * `document.fonts`: повторная загрузка того же файла добавила бы туда дубликат, независимо от того, чей
+ * это кэш. Остальные ассеты живут в GPU-памяти вызывающей стороны и такого общего реестра не имеют.
+ */
+export declare const sharedFontCache: Map<string, Promise<string | undefined>>;
+/** Та же причина, что у `sharedFontCache`: `loadSceneBitmapFonts` регистрирует шрифт в общем PixiJS `Cache`. */
+export declare const sharedBitmapFontCache: Map<string, Promise<BitmapFont | undefined>>;
+/** Создаёт пустой кэш ассетов. Шрифты по умолчанию разделяются со всеми остальными кэшами — см. `sharedFontCache`. */
+export declare function createSceneAssetCache(): SceneAssetCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/assets/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/assets/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,0HAA0H;IAC1H,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAChD,sFAAsF;IACtF,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC;IAC1D,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,0CAAiD,CAAC;AAE9E,gHAAgH;AAChH,eAAO,MAAM,qBAAqB,8CAAqD,CAAC;AAExF,sHAAsH;AACtH,wBAAgB,qBAAqB,IAAI,eAAe,CASvD"}

package/dist/assets/cache.js

@@ -0,0 +1,20 @@
+/**
+ * Шрифты кэшируются глобально, потому что `loadSceneFonts` регистрирует `FontFace` в общем для документа
+ * `document.fonts`: повторная загрузка того же файла добавила бы туда дубликат, независимо от того, чей
+ * это кэш. Остальные ассеты живут в GPU-памяти вызывающей стороны и такого общего реестра не имеют.
+ */
+export const sharedFontCache = new Map();
+/** Та же причина, что у `sharedFontCache`: `loadSceneBitmapFonts` регистрирует шрифт в общем PixiJS `Cache`. */
+export const sharedBitmapFontCache = new Map();
+/** Создаёт пустой кэш ассетов. Шрифты по умолчанию разделяются со всеми остальными кэшами — см. `sharedFontCache`. */
+export function createSceneAssetCache() {
+    return {
+        textures: new Map(),
+        spritesheets: new Map(),
+        spines: new Map(),
+        fonts: sharedFontCache,
+        bitmapFonts: sharedBitmapFontCache,
+        sounds: new Map(),
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/assets/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/assets/cache.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuC,CAAC;AAE9E,gHAAgH;AAChH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAA2C,CAAC;AAExF,sHAAsH;AACtH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,YAAY,EAAE,IAAI,GAAG,EAAE;QACvB,MAAM,EAAE,IAAI,GAAG,EAAE;QACjB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qBAAqB;QAClC,MAAM,EAAE,IAAI,GAAG,EAAE;KAClB,CAAC;AACJ,CAAC"}

package/dist/assets/fonts.d.ts

@@ -1,5 +1,5 @@
 import type { ProjectDocument } from "@pixi-ui-editor/schema";
 import type { FileUrlResolver } from "./textures.js";
 /** Loads scene fonts before views are built. A load failure is a warning and keeps system fallback usable. */
-export declare function loadSceneFonts(document: ProjectDocument, sceneId: string, resolveFileUrl: FileUrlResolver): Promise<Map<string, string>>;
+export declare function loadSceneFonts(document: ProjectDocument, sceneId: string, resolveFileUrl: FileUrlResolver, cache?: Map<string, Promise<string | undefined>>): Promise<Map<string, string>>;
 //# sourceMappingURL=fonts.d.ts.map

package/dist/assets/fonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/assets/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,eAAe,EAAU,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAYrD,8GAA8G;AAC9G,wBAAsB,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsB9I"}
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/assets/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,eAAe,EAAU,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAYrD,8GAA8G;AAC9G,wBAAsB,cAAc,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,eAAe,EAC/B,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAmB,GAChE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsB9B"}

package/dist/assets/fonts.js

@@ -1,5 +1,5 @@
+import { sharedFontCache } from "./cache.js";
 import { collectRenderedNodes } from "../scene.js";
-const cache = new Map();
 const keyOf = (asset) => `${asset.source.uri}#${asset.source.version ?? ""}`;
 const fromNodes = (nodes) => nodes.flatMap((node) => {
     if (node.type === "text" && node.style?.fontAssetId)
@@ -11,7 +11,7 @@ const fromNodes = (nodes) => nodes.flatMap((node) => {
     return [];
 });
 /** Loads scene fonts before views are built. A load failure is a warning and keeps system fallback usable. */
-export async function loadSceneFonts(document, sceneId, resolveFileUrl) {
+export async function loadSceneFonts(document, sceneId, resolveFileUrl, cache = sharedFontCache) {
     const scene = document.scenes.find((item) => item.id === sceneId);
     if (scene === undefined)
         throw new Error(`Scene '${sceneId}' does not exist in the project document.`);

package/dist/assets/fonts.js.map

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

package/dist/assets/loadTexture.d.ts

@@ -0,0 +1,9 @@
+import { Texture } from "pixi.js";
+/**
+ * Its own module (not `textures.ts`) so `textures.ts` and `bitmapFonts.ts` can both depend on it
+ * without importing from each other: `textures.ts` resolves bitmap font glyph frames through
+ * `bitmapFonts.ts`, which itself needs this same texture loader.
+ */
+/** Loads one texture from a data URI or a regular URL. */
+export declare function loadTexture(url: string): Promise<Texture>;
+//# sourceMappingURL=loadTexture.d.ts.map

package/dist/assets/loadTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTexture.d.ts","sourceRoot":"","sources":["../../src/assets/loadTexture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;GAIG;AAEH,0DAA0D;AAC1D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/D"}

package/dist/assets/loadTexture.js

@@ -0,0 +1,14 @@
+import { Texture } from "pixi.js";
+/**
+ * Its own module (not `textures.ts`) so `textures.ts` and `bitmapFonts.ts` can both depend on it
+ * without importing from each other: `textures.ts` resolves bitmap font glyph frames through
+ * `bitmapFonts.ts`, which itself needs this same texture loader.
+ */
+/** Loads one texture from a data URI or a regular URL. */
+export async function loadTexture(url) {
+    const image = new Image();
+    image.src = url;
+    await image.decode();
+    return Texture.from(image);
+}
+//# sourceMappingURL=loadTexture.js.map

package/dist/assets/loadTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadTexture.js","sourceRoot":"","sources":["../../src/assets/loadTexture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;GAIG;AAEH,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;IACrB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/assets/textures.d.ts

@@ -1,15 +1,14 @@
 import { type Asset, type ProjectDocument } from "@pixi-ui-editor/schema";
-import { Spritesheet, Texture } from "pixi.js";
+import { Spritesheet, type BitmapFont, type Texture } from "pixi.js";
+import { loadTexture } from "./loadTexture.js";
 export type AssetUrlResolver = (asset: Asset) => string | undefined;
 export type FileUrlResolver = (uri: string) => string | undefined;
 type AtlasAsset = Extract<Asset, {
     type: "atlas";
 }>;
-/** Loads one texture from a data URI or a regular URL. */
-export declare function loadTexture(url: string): Promise<Texture>;
+export { loadTexture };
 /** Loads and parses one atlas's Spritesheet, sharing the parse by the JSON file's URI. */
 export declare function loadAtlasSpritesheet(asset: AtlasAsset, resolveFileUrl: FileUrlResolver, cache?: Map<string, Spritesheet>): Promise<Spritesheet>;
 /** Loads textures for image nodes in a scene, resolving atlas frame ids through their Spritesheet. Leaves failed assets for placeholder rendering. */
-export declare function loadSceneTextures(document: ProjectDocument, sceneId: string, resolveAssetUrl: AssetUrlResolver, resolveFileUrl: FileUrlResolver, cache?: Map<string, Texture>, spritesheetCache?: Map<string, Spritesheet>): Promise<Map<string, Texture>>;
-export {};
+export declare function loadSceneTextures(document: ProjectDocument, sceneId: string, resolveAssetUrl: AssetUrlResolver, resolveFileUrl: FileUrlResolver, cache?: Map<string, Texture>, spritesheetCache?: Map<string, Spritesheet>, bitmapFontCache?: Map<string, Promise<BitmapFont | undefined>>): Promise<Map<string, Texture>>;
 //# sourceMappingURL=textures.d.ts.map

package/dist/assets/textures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textures.d.ts","sourceRoot":"","sources":["../../src/assets/textures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,OAAO,EAAwB,MAAM,SAAS,CAAC;AAIrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAClE,KAAK,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEpD,0DAA0D;AAC1D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/D;AAED,0FAA0F;AAC1F,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,eAAe,EAC/B,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAa,GAC1C,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED,sJAAsJ;AACtJ,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,gBAAgB,EACjC,cAAc,EAAE,eAAe,EAC/B,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAa,EACvC,gBAAgB,GAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAa,GACrD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgD/B"}
+{"version":3,"file":"textures.d.ts","sourceRoot":"","sources":["../../src/assets/textures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAwB,MAAM,SAAS,CAAC;AAK3F,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAClE,KAAK,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,0FAA0F;AAC1F,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,eAAe,EAC/B,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAa,GAC1C,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED,sJAAsJ;AACtJ,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,gBAAgB,EACjC,cAAc,EAAE,eAAe,EAC/B,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAa,EACvC,gBAAgB,GAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAa,EACtD,eAAe,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAyB,GACpF,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsD/B"}

package/dist/assets/textures.js

@@ -1,14 +1,11 @@
 import { collectEffectAssetIds } from "@pixi-ui-editor/schema";
-import { Spritesheet, Texture } from "pixi.js";
+import { Spritesheet } from "pixi.js";
 import { collectRenderedNodes } from "../scene.js";
 import { collectNodeAssetIds } from "../views/createNodeView.js";
-/** Loads one texture from a data URI or a regular URL. */
-export async function loadTexture(url) {
-    const image = new Image();
-    image.src = url;
-    await image.decode();
-    return Texture.from(image);
-}
+import { loadBitmapFontGlyphTexture } from "./bitmapFonts.js";
+import { sharedBitmapFontCache } from "./cache.js";
+import { loadTexture } from "./loadTexture.js";
+export { loadTexture };
 /** Loads and parses one atlas's Spritesheet, sharing the parse by the JSON file's URI. */
 export async function loadAtlasSpritesheet(asset, resolveFileUrl, cache = new Map()) {
     const cached = cache.get(asset.files.json.uri);
@@ -28,17 +25,21 @@ export async function loadAtlasSpritesheet(asset, resolveFileUrl, cache = new Ma
     return sheet;
 }
 /** Loads textures for image nodes in a scene, resolving atlas frame ids through their Spritesheet. Leaves failed assets for placeholder rendering. */
-export async function loadSceneTextures(document, sceneId, resolveAssetUrl, resolveFileUrl, cache = new Map(), spritesheetCache = new Map()) {
+export async function loadSceneTextures(document, sceneId, resolveAssetUrl, resolveFileUrl, cache = new Map(), spritesheetCache = new Map(), bitmapFontCache = sharedBitmapFontCache) {
     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 assetsById = new Map(document.assets.map((asset) => [asset.id, asset]));
     const framesById = new Map();
     for (const asset of document.assets) {
-        if (asset.type !== "atlas")
-            continue;
-        for (const [frameName, frameId] of Object.entries(asset.frames))
-            framesById.set(frameId, { atlas: asset, frameName });
+        if (asset.type === "atlas") {
+            for (const [frameName, frameId] of Object.entries(asset.frames))
+                framesById.set(frameId, { kind: "atlas", atlas: asset, frameName });
+        }
+        else if (asset.type === "bitmapFont") {
+            for (const [frameName, frameId] of Object.entries(asset.frames ?? {}))
+                framesById.set(frameId, { kind: "bitmapFont", bitmapFont: asset, frameName });
+        }
     }
     const textures = new Map();
     for (const node of collectRenderedNodes(document, scene)) {
@@ -68,16 +69,26 @@ export async function loadSceneTextures(document, sceneId, resolveAssetUrl, reso
             if (frame === undefined)
                 continue;
             try {
-                const sheet = await loadAtlasSpritesheet(frame.atlas, resolveFileUrl, spritesheetCache);
-                const frameTexture = sheet.textures[frame.frameName];
-                if (frameTexture === undefined) {
-                    console.warn(`Atlas '${frame.atlas.id}' has no frame '${frame.frameName}'.`);
-                    continue;
+                if (frame.kind === "atlas") {
+                    const sheet = await loadAtlasSpritesheet(frame.atlas, resolveFileUrl, spritesheetCache);
+                    const frameTexture = sheet.textures[frame.frameName];
+                    if (frameTexture === undefined) {
+                        console.warn(`Atlas '${frame.atlas.id}' has no frame '${frame.frameName}'.`);
+                        continue;
+                    }
+                    textures.set(assetId, frameTexture);
+                }
+                else {
+                    const glyphTexture = await loadBitmapFontGlyphTexture(frame.bitmapFont, frame.frameName, resolveFileUrl, bitmapFontCache);
+                    if (glyphTexture === undefined) {
+                        console.warn(`Bitmap font '${frame.bitmapFont.id}' has no glyph '${frame.frameName}'.`);
+                        continue;
+                    }
+                    textures.set(assetId, glyphTexture);
                 }
-                textures.set(assetId, frameTexture);
             }
             catch (error) {
-                console.warn(`Unable to load atlas frame texture for '${assetId}'.`, error);
+                console.warn(`Unable to load frame texture for '${assetId}'.`, error);
             }
         }
     }

package/dist/assets/textures.js.map

@@ -1 +1 @@
-{"version":3,"file":"textures.js","sourceRoot":"","sources":["../../src/assets/textures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAoC,MAAM,wBAAwB,CAAC;AACjG,OAAO,EAAE,WAAW,EAAE,OAAO,EAAwB,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAMjE,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;IACrB,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAiB,EACjB,cAA+B,EAC/B,QAAkC,IAAI,GAAG,EAAE;IAE3C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAExC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,OAAO,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAErI,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAA8B,CAAC;QAC9E,WAAW,CAAC,UAAU,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACpB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sJAAsJ;AACtJ,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAyB,EACzB,OAAe,EACf,eAAiC,EACjC,cAA+B,EAC/B,QAA8B,IAAI,GAAG,EAAE,EACvC,mBAA6C,IAAI,GAAG,EAAE;IAEtD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC5E,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,OAAO,2CAA2C,CAAC,CAAC;IAEvG,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoD,CAAC;IAC/E,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACrC,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACxH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnI,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACrH,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAS;YAEpC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACnC,IAAI,GAAG,KAAK,SAAS;oBAAE,SAAS;gBAChC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;oBACtE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;oBACrC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBAClC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,IAAI,CAAC,qCAAqC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;gBACzE,CAAC;gBACD,SAAS;YACX,CAAC;YACD,gHAAgH;YAChH,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAElC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,gBAAgB,CAAC,CAAC;gBACxF,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACrD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAAC,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,EAAE,mBAAmB,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBAC3H,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,2CAA2C,OAAO,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"textures.js","sourceRoot":"","sources":["../../src/assets/textures.ts"],"names":[],"mappings":"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"}

package/dist/controls.d.ts

@@ -1,5 +1,5 @@
 import { type SkeletonData } from "@esotericsoftware/spine-pixi-v8";
-import { type ButtonStateKey } from "@pixi-ui-editor/schema";
+import { type ButtonStateKey, type LayoutPadding } from "@pixi-ui-editor/schema";
 import { Container } from "pixi.js";
 /** Reads the current 1-based animation frame for an editor Spine node. */
 export declare function getSpineViewPlayback(view: Container, skeletonData: SkeletonData, animation: string): {
@@ -10,6 +10,14 @@ export declare function getSpineViewPlayback(view: Container, skeletonData: Skel
 export declare function setSpineViewFrame(view: Container, frame: number, skeletonData: SkeletonData, animation: string): void;
 /** Forces an editor-only button state; the node's serialized `enabled` and states stay untouched. */
 export declare function setButtonViewState(view: Container, state: ButtonStateKey): void;
+/** Forces an editor-only checkbox checked state; the node's serialized `defaultChecked` stays untouched. */
+export declare function setCheckboxViewChecked(view: Container, checked: boolean): void;
+/** Forces an editor-only staged button preview stage; the document's `stages`/current stage stay untouched. */
+export declare function setStagedButtonViewStage(view: Container, index: number): void;
+/** Forces an editor-only staged button visual state; the node's serialized `enabled` stays untouched. */
+export declare function setStagedButtonViewState(view: Container, state: ButtonStateKey): void;
+/** Live-previews nine-slice border edits while dragging the canvas gizmo; commits only on release. */
+export declare function previewNineSlice(view: Container, nineSlice: LayoutPadding): void;
 /** Applies an editor-only slider preview value without touching the document. */
 export declare function setSliderViewValue(view: Container, value: number): void;
 /** Applies an editor-only progress preview without touching the document. */

package/dist/controls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../src/controls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAUpC,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CASnJ;AAED,kHAAkH;AAClH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CASrH;AAED,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAE/E;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvE;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElF;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAG7E"}
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../src/controls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAapC,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CASnJ;AAED,kHAAkH;AAClH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CASrH;AAED,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAE/E;AAED,4GAA4G;AAC5G,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAE9E;AAED,+GAA+G;AAC/G,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7E;AAED,yGAAyG;AACzG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CAEhF;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEvE;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElF;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAG7E"}