@kurot/core 2.5.4 → 2.6.0

package/dist/kurot/player/SystemTicker.js

@@ -32,9 +32,19 @@ export class SystemTicker {
         this._lastCount = this._frameInterval = Math.round(60000 / this._frameRate);
     }
     // ── Getters / Setters ─────────────────────────────────────────────────────
+    /**
+     * Requested rendered frame rate in frames per second, initially 30 for a
+     * standalone ticker. createPlayer() normally sets the shared rate to 60.
+     * Actual frame scheduling caps at 60 and remains browser-timing dependent.
+     */
     get frameRate() {
         return this._frameRate;
     }
+    /**
+     * Updates the requested frame rate in frames per second. Returns false for
+     * values <= 0 or an unchanged value; scheduling caps at 60 even when the
+     * reported requested value is larger. Supply a finite positive number.
+     */
     setFrameRate(value) {
         if (value <= 0 || this._frameRate === value)
             return false;
@@ -54,19 +64,52 @@ export class SystemTicker {
         if (i !== -1)
             this._players.splice(i, 1);
     }
+    /**
+     * Registers a callback receiving absolute milliseconds from getTimer(), not
+     * a delta or seconds. Returning true requests rendering. The callback and
+     * thisObject pair is deduplicated and must match when calling stopTick().
+     * Registration does not start the requestAnimationFrame loop by itself.
+     *
+     * @example
+     * ```ts
+     * import { ticker } from '@kurot/core';
+     *
+     * let previous: number | undefined;
+     * const onTick = (now: number): boolean => {
+     *   const deltaSeconds = previous === undefined ? 0 : (now - previous) / 1000;
+     *   previous = now;
+     *   console.log(deltaSeconds);
+     *   return false;
+     * };
+     * ticker.startTick(onTick, undefined);
+     * ticker.stopTick(onTick, undefined);
+     * ```
+     */
     startTick(callback, thisObject) {
         if (this.getTickIndex(callback, thisObject) !== -1)
             return;
         this._ticks.push({ callback, thisObject });
     }
+    /**
+     * Detaches the exact callback/thisObject pair passed to startTick().
+     * A missing pair is harmless; a newly bound callback is a different identity.
+     */
     stopTick(callback, thisObject) {
         const i = this.getTickIndex(callback, thisObject);
         if (i !== -1)
             this._ticks.splice(i, 1);
     }
+    /**
+     * Queues work for the next render preparation while a Player is registered.
+     * This has no cancellation handle; guard callbacks owned by a disposed view.
+     */
     callLater(fn, ...args) {
         this._callLaterList.push({ fn, args });
     }
+    /**
+     * Starts the requestAnimationFrame loop; repeated starts are harmless.
+     * This is shared scheduling, so stopping it affects all users of this ticker.
+     */
     start() {
         if (this._running)
             return;
@@ -74,6 +117,11 @@ export class SystemTicker {
         this._lastTimeStamp = getTimer();
         this._rafId = requestAnimationFrame(this.onFrame);
     }
+    /**
+     * Cancels the requestAnimationFrame loop without clearing players, tick
+     * callbacks, deferred calls or pause state. Registration owners must detach
+     * their own callbacks; stop() alone does not dispose them.
+     */
     stop() {
         this._running = false;
         if (this._rafId) {
@@ -81,9 +129,17 @@ export class SystemTicker {
             this._rafId = 0;
         }
     }
+    /**
+     * Pauses callback execution and rendering while keeping the frame loop and
+     * registrations. This is a ticker-wide pause, affecting every registered user.
+     */
     pause() {
         this._isPaused = true;
     }
+    /**
+     * Clears the ticker-wide pause flag. This does not start a stopped frame loop
+     * or individually resume Tweens that were explicitly paused by their owner.
+     */
     resume() {
         this._isPaused = false;
     }

package/dist/kurot/player/SystemTicker.js.map

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

package/dist/kurot/player/canvas-stage-options.d.ts

@@ -0,0 +1,9 @@
+import type { KurotOptions } from './KurotOptions.js';
+type StageOptions = Required<Pick<KurotOptions, 'contentWidth' | 'contentHeight' | 'scaleMode' | 'orientation' | 'frameRate'>>;
+/**
+ * Read startup defaults once, before allocating Player resources. Explicit
+ * options bypass their corresponding attributes, including malformed ones.
+ */
+export declare function resolveCanvasStageOptions(options: KurotOptions): StageOptions;
+export {};
+//# sourceMappingURL=canvas-stage-options.d.ts.map

package/dist/kurot/player/canvas-stage-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-stage-options.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/canvas-stage-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,KAAK,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC;AAE/H;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAS7E"}

package/dist/kurot/player/canvas-stage-options.js

@@ -0,0 +1,39 @@
+import { OrientationMode } from '../display/enums/OrientationMode.js';
+import { StageScaleMode } from '../display/enums/StageScaleMode.js';
+/**
+ * Read startup defaults once, before allocating Player resources. Explicit
+ * options bypass their corresponding attributes, including malformed ones.
+ */
+export function resolveCanvasStageOptions(options) {
+    const { canvas } = options;
+    return {
+        contentWidth: options.contentWidth ?? numberAttribute(canvas, 'data-content-width') ?? (canvas.width || 640),
+        contentHeight: options.contentHeight ?? numberAttribute(canvas, 'data-content-height') ?? (canvas.height || 1136),
+        frameRate: options.frameRate ?? numberAttribute(canvas, 'data-frame-rate', true) ?? 60,
+        scaleMode: options.scaleMode ?? enumAttribute(canvas, 'data-scale-mode', Object.values(StageScaleMode)) ?? StageScaleMode.SHOW_ALL,
+        orientation: options.orientation ?? enumAttribute(canvas, 'data-orientation', Object.values(OrientationMode)) ?? OrientationMode.AUTO,
+    };
+}
+function numberAttribute(canvas, name, integer = false) {
+    const raw = canvas.getAttribute(name);
+    if (raw === null) {
+        return undefined;
+    }
+    const value = Number(raw);
+    if (!raw.trim() || !Number.isFinite(value) || value <= 0 || (integer && !Number.isInteger(value))) {
+        throw new Error(`Invalid canvas ${name}: expected a positive ${integer ? 'integer' : 'finite number'}, got '${raw}'.`);
+    }
+    return value;
+}
+function enumAttribute(canvas, name, values) {
+    const raw = canvas.getAttribute(name);
+    if (raw === null) {
+        return undefined;
+    }
+    const value = values.find(candidate => candidate === raw.trim());
+    if (value === undefined) {
+        throw new Error(`Invalid canvas ${name}: expected ${values.join(', ')}, got '${raw}'.`);
+    }
+    return value;
+}
+//# sourceMappingURL=canvas-stage-options.js.map

package/dist/kurot/player/canvas-stage-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-stage-options.js","sourceRoot":"","sources":["../../../src/kurot/player/canvas-stage-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKpE;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAqB;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,OAAO;QACN,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,eAAe,CAAC,MAAM,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC;QAC5G,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,eAAe,CAAC,MAAM,EAAE,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;QACjH,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE;QACtF,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,cAAc,CAAC,QAAQ;QAClI,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,eAAe,CAAC,IAAI;KACrI,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAyB,EAAE,IAAY,EAAE,OAAO,GAAG,KAAK;IAChF,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnG,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,yBAAyB,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,UAAU,GAAG,IAAI,CAAC,CAAC;IACxH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAmB,MAAyB,EAAE,IAAY,EAAE,MAAoB;IACrG,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,cAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/kurot/player/createPlayer.d.ts

@@ -4,18 +4,39 @@ import { Player } from './Player.js';
 import { TouchHandler } from './TouchHandler.js';
 import { ScreenAdapter } from './ScreenAdapter.js';
 import type { KurotOptions } from './KurotOptions.js';
+/**
+ * Owns one Player, its stage, canvas input and browser lifecycle bindings.
+ * Only one live Kurot application is supported at a time.
+ */
 export interface KurotApp {
     player: Player;
     stage: Stage;
     touchHandler: TouchHandler;
     screenAdapter: ScreenAdapter;
+    /**
+     * Starts rendering and optionally attaches the root display object.
+     * Throws after destroy(); create a new application to mount again.
+     */
     start(root?: DisplayObject): void;
+    /**
+     * Stops this Player without releasing input or lifecycle bindings.
+     * Application-owned ticker callbacks and Tweens require their own cleanup.
+     */
     stop(): void;
+    /**
+     * Idempotently destroys the Player and detaches canvas input, sizing and
+     * lifecycle bindings. Remove application-owned handlers, ticker callbacks
+     * and Tweens separately; this does not dispose every resource in a scene.
+     */
     destroy(): void;
 }
 /**
  * Creates and initializes a Kurot player from the given options.
  * This is the main entry point for starting a Kurot application.
+ * Use a single live application and call destroy() when its page/view closes.
+ * Stage settings resolve per field from explicit options, then canvas data-*
+ * attributes, then existing defaults. CLI pages can call createPlayer({ canvas }).
+ * Invalid consumed attributes throw before Player resources are allocated.
  *
  * ```ts
  * import { createPlayer, Sprite } from '@kurot/core';

package/dist/kurot/player/createPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createPlayer.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAqE5D"}
+{"version":3,"file":"createPlayer.d.ts","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC;IACb;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAiE5D"}

package/dist/kurot/player/createPlayer.js

@@ -1,6 +1,4 @@
 import { Stage } from '../display/Stage.js';
-import { StageScaleMode } from '../display/enums/StageScaleMode.js';
-import { OrientationMode } from '../display/enums/OrientationMode.js';
 import { RenderTexture } from '../display/texture/RenderTexture.js';
 import { Matrix } from '../geom/Matrix.js';
 import { Player } from './Player.js';
@@ -9,9 +7,14 @@ import { ScreenAdapter } from './ScreenAdapter.js';
 import { setupLifecycle } from './SystemTicker.js';
 import { CanvasRenderer, CanvasBuffer } from './canvas/index.js';
 import { Capabilities } from '../system/Capabilities.js';
+import { resolveCanvasStageOptions } from './canvas-stage-options.js';
 /**
  * Creates and initializes a Kurot player from the given options.
  * This is the main entry point for starting a Kurot application.
+ * Use a single live application and call destroy() when its page/view closes.
+ * Stage settings resolve per field from explicit options, then canvas data-*
+ * attributes, then existing defaults. CLI pages can call createPlayer({ canvas }).
+ * Invalid consumed attributes throw before Player resources are allocated.
  *
  * ```ts
  * import { createPlayer, Sprite } from '@kurot/core';
@@ -29,6 +32,7 @@ import { Capabilities } from '../system/Capabilities.js';
  * ```
  */
 export function createPlayer(options) {
+    const { contentWidth, contentHeight, scaleMode, orientation, frameRate } = resolveCanvasStageOptions(options);
     Capabilities._init();
     if (!RenderTexture.renderer) {
         const _renderer = new CanvasRenderer();
@@ -40,7 +44,7 @@ export function createPlayer(options) {
             return buffer.surface;
         };
     }
-    const { canvas, frameRate = 60, scaleMode = StageScaleMode.SHOW_ALL, contentWidth = canvas.width || 640, contentHeight = canvas.height || 1136, resolution = Math.min(window.devicePixelRatio || 1, 2), orientation = OrientationMode.AUTO, maxTouches = 99, background, } = options;
+    const { canvas, resolution = Math.min(window.devicePixelRatio || 1, 2), maxTouches = 99, background, } = options;
     if (background) {
         canvas.style.backgroundColor = background;
     }

package/dist/kurot/player/createPlayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"createPlayer.js","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createPlayer.js","sourceRoot":"","sources":["../../../src/kurot/player/createPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AA6BtE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAqB;IACjD,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC9G,YAAY,CAAC,KAAK,EAAE,CAAC;IAErB,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;QACvC,aAAa,CAAC,QAAQ,GAAG,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YAC3E,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC;YACvB,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9B,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,OAAO,MAAM,CAAC,OAAO,CAAC;QACvB,CAAC,CAAC;IACH,CAAC;IACD,MAAM,EACL,MAAM,EACN,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC,CAAC,EACtD,UAAU,GAAG,EAAE,EACf,UAAU,GACV,GAAG,OAAO,CAAC;IAEZ,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,UAAU,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAE5B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,IAAI,aAAa,CACtC,MAAM,EACN,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,CACV,CAAC;IACF,MAAM,gBAAgB,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO;QACN,MAAM;QACN,KAAK;QACL,YAAY;QACZ,aAAa;QACb,KAAK,CAAC,IAAoB;YACzB,IAAI,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC9E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI;YACH,MAAM,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;QACD,OAAO;YACN,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,CAAC,OAAO,EAAE,CAAC;YACvB,aAAa,CAAC,OAAO,EAAE,CAAC;YACxB,gBAAgB,EAAE,CAAC;QACpB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/kurot/resource/Resource.d.ts

@@ -13,7 +13,7 @@ export type ResourceEventListener = (event: ResourceEvent) => void;
  *
  * @example
  * ```ts
- * import { resource } from '@kurot/core';
+ * import { resource, type Texture } from '@kurot/core';
  *
  * await resource.loadConfig('resource.json', 'assets/');
  * await resource.loadGroup('preload');
@@ -32,6 +32,8 @@ export declare class Resource {
      * Load and parse a resource configuration file.
      * @param url URL of the resource.json file
      * @param folder Base URL prefix for resource files (default: '')
+     * Resource URLs are prefixed with folder, independently of the config URL.
+     * Network and JSON/config errors reject the returned promise.
      */
     loadConfig(url: string, folder?: string): Promise<void>;
     /**
@@ -61,10 +63,16 @@ export declare class Resource {
      * @param groupName Name of the group to load
      * @param priority Reserved for future prioritized loading; currently unused by `ResourceLoader`
      * @param onProgress Optional progress callback
+     * @throws When the group is absent/empty or any item exhausts its retries.
+     * Already cached items are skipped; an entirely cached group resolves
+     * without emitting a new progress event. Successfully loaded items remain
+     * cached if another item fails.
      */
     loadGroup(groupName: string, priority?: number, onProgress?: ProgressCallback): Promise<void>;
     /**
      * Load a single resource by name. Returns the cached data.
+     * Rejects for an unknown name, unsupported type or failed load. The type
+     * parameter describes expected data; it does not validate downloaded JSON.
      */
     load<T = unknown>(name: string): Promise<T>;
     /**
@@ -85,10 +93,15 @@ export declare class Resource {
     getGroupNames(): string[];
     /**
      * Destroy a single cached resource by name.
+     * Returns false if no analyzer owns that cached entry. This does not cancel
+     * an in-flight request; a later completion may populate the cache again.
+     * Callers sharing the entry must coordinate ownership before destroying it.
      */
     destroy(name: string): boolean;
     /**
      * Destroy all resources in a group.
+     * Configuration remains registered. Shared entries are also removed for
+     * other groups that refer to them; pending loads are not cancelled.
      */
     destroyGroup(groupName: string): void;
     /**
@@ -97,6 +110,8 @@ export declare class Resource {
     destroyAll(): void;
     /**
      * Listen for resource events.
+     * Listeners persist until off() receives the same callback and event type.
+     * Resource uses this API rather than EventDispatcher.addEventListener().
      */
     on(type: ResourceEventType, listener: ResourceEventListener): void;
     /**
@@ -104,8 +119,10 @@ export declare class Resource {
      */
     off(type: ResourceEventType, listener: ResourceEventListener): void;
     /**
-     * Listen for loading progress on the next loadGroup/load call.
-     * Convenience method — shorthand for on(ResourceEventType.GROUP_PROGRESS, ...).
+     * Adds a persistent listener for GROUP_PROGRESS events from group loads.
+     * This does not track load() and is not limited to the next group. The
+     * wrapper has no removal handle; prefer loadGroup's callback for one batch,
+     * or on()/off() with the same listener when detachable tracking is needed.
      */
     onProgress(callback: ProgressCallback): void;
     /**

package/dist/kurot/resource/Resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../../src/kurot/resource/Resource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAY3D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IAGpB,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAA8D;IACjF,OAAO,CAAC,cAAc,CAA0F;IAChH,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,cAAc,CAAuC;;IAU7D;;;;OAIG;IACU,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhE;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM1E;;;;;;;;;;;;;;;;;;;OAmBG;IACU,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrG;;OAEG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBxD;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQpD;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOpC;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACI,aAAa,IAAI,MAAM,EAAE;IAMhC;;OAEG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUrC;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACI,UAAU,IAAI,IAAI;IAUzB;;OAEG;IACI,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IASzE;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAO1E;;;OAGG;IACI,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAQnD;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAOnE,OAAO,CAAC,wBAAwB;YAuBlB,WAAW;IAkDzB,OAAO,CAAC,gBAAgB;IAmExB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,IAAI;CAUZ;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAyB,CAAC"}
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../../src/kurot/resource/Resource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAY3D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IAGpB,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAA8D;IACjF,OAAO,CAAC,cAAc,CAA0F;IAChH,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,cAAc,CAAuC;;IAU7D;;;;;;OAMG;IACU,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhE;;OAEG;IACI,WAAW,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM1E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACU,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrG;;;;OAIG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAyBxD;;OAEG;IACI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAQpD;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOpC;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACI,aAAa,IAAI,MAAM,EAAE;IAMhC;;;;;OAKG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUrC;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACI,UAAU,IAAI,IAAI;IAUzB;;;;OAIG;IACI,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IASzE;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAO1E;;;;;OAKG;IACI,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAQnD;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAOnE,OAAO,CAAC,wBAAwB;YAuBlB,WAAW;IAkDzB,OAAO,CAAC,gBAAgB;IAmExB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,IAAI;CAUZ;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAyB,CAAC"}

package/dist/kurot/resource/Resource.js

@@ -17,7 +17,7 @@ import { IOErrorEvent } from '../events/IOErrorEvent.js';
  *
  * @example
  * ```ts
- * import { resource } from '@kurot/core';
+ * import { resource, type Texture } from '@kurot/core';
  *
  * await resource.loadConfig('resource.json', 'assets/');
  * await resource.loadGroup('preload');
@@ -41,6 +41,8 @@ export class Resource {
      * Load and parse a resource configuration file.
      * @param url URL of the resource.json file
      * @param folder Base URL prefix for resource files (default: '')
+     * Resource URLs are prefixed with folder, independently of the config URL.
+     * Network and JSON/config errors reject the returned promise.
      */
     async loadConfig(url, folder = '') {
         const data = await this.fetchConfig(url);
@@ -78,6 +80,10 @@ export class Resource {
      * @param groupName Name of the group to load
      * @param priority Reserved for future prioritized loading; currently unused by `ResourceLoader`
      * @param onProgress Optional progress callback
+     * @throws When the group is absent/empty or any item exhausts its retries.
+     * Already cached items are skipped; an entirely cached group resolves
+     * without emitting a new progress event. Successfully loaded items remain
+     * cached if another item fails.
      */
     async loadGroup(groupName, priority = 0, onProgress) {
         const items = this.config.getGroupByName(groupName);
@@ -97,6 +103,8 @@ export class Resource {
     // ── Single resource loading ──────────────────────────────────────────────
     /**
      * Load a single resource by name. Returns the cached data.
+     * Rejects for an unknown name, unsupported type or failed load. The type
+     * parameter describes expected data; it does not validate downloaded JSON.
      */
     async load(name) {
         const cached = this.get(name);
@@ -154,6 +162,9 @@ export class Resource {
     // ── Resource destruction ─────────────────────────────────────────────────
     /**
      * Destroy a single cached resource by name.
+     * Returns false if no analyzer owns that cached entry. This does not cancel
+     * an in-flight request; a later completion may populate the cache again.
+     * Callers sharing the entry must coordinate ownership before destroying it.
      */
     destroy(name) {
         for (const analyzer of this.analyzerMap.values()) {
@@ -166,6 +177,8 @@ export class Resource {
     }
     /**
      * Destroy all resources in a group.
+     * Configuration remains registered. Shared entries are also removed for
+     * other groups that refer to them; pending loads are not cancelled.
      */
     destroyGroup(groupName) {
         const items = this.config.getGroupByName(groupName);
@@ -186,6 +199,8 @@ export class Resource {
     // ── Events ───────────────────────────────────────────────────────────────
     /**
      * Listen for resource events.
+     * Listeners persist until off() receives the same callback and event type.
+     * Resource uses this API rather than EventDispatcher.addEventListener().
      */
     on(type, listener) {
         let set = this.eventListeners.get(type);
@@ -205,8 +220,10 @@ export class Resource {
         }
     }
     /**
-     * Listen for loading progress on the next loadGroup/load call.
-     * Convenience method — shorthand for on(ResourceEventType.GROUP_PROGRESS, ...).
+     * Adds a persistent listener for GROUP_PROGRESS events from group loads.
+     * This does not track load() and is not limited to the next group. The
+     * wrapper has no removal handle; prefer loadGroup's callback for one batch,
+     * or on()/off() with the same listener when detachable tracking is needed.
      */
     onProgress(callback) {
         this.on(ResourceEventType.GROUP_PROGRESS, event => {

package/dist/kurot/resource/Resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../../src/kurot/resource/Resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAqD,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAsB,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAYzD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,QAAQ;IACpB,8EAA8E;IAEtE,MAAM,GAAmB,IAAI,cAAc,EAAE,CAAC;IAC9C,MAAM,GAAmB,IAAI,cAAc,EAAE,CAAC;IAC9C,WAAW,GAA8B,IAAI,GAAG,EAAwB,CAAC;IACzE,cAAc,GAA4C,IAAI,GAAG,EAAsC,CAAC;IACxG,WAAW,GAAgB,IAAI,GAAG,EAAU,CAAC;IAC7C,cAAc,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAE7D,4EAA4E;IAE5E;QACC,IAAI,CAAC,wBAAwB,EAAE,CAAC;IACjC,CAAC;IAED,4EAA4E;IAE5E;;;;OAIG;IACI,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,MAAM,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,iBAAiB,CAAC,eAAe;YACvC,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,CAAC;YACd,UAAU,EAAE,CAAC;SACb,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,GAAgD;QAClE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAA0B,CAAC,CAAC;IACjD,CAAC;IAED,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;;;OAmBG;IACI,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,QAAQ,GAAG,CAAC,EAAE,UAA6B;QACpF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mBAAmB,SAAS,0BAA0B,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,GAAG,GAAG,GAAkB,EAAE;YAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACvE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACvE,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,4EAA4E;IAE5E;;OAEG;IACI,KAAK,CAAC,IAAI,CAAc,IAAY;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAI,IAAI,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAExC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,wBAAwB,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,WAAW,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,GAAG,CAAI,IAAI,CAAE,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAE5E;;OAEG;IACI,GAAG,CAAc,IAAY;QACnC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAI,IAAI,CAAC,CAAC;YACtC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;QACrC,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,IAAY;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QACxC,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,aAAa;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC;IAED,4EAA4E;IAE5E;;OAEG;IACI,OAAO,CAAC,IAAY;QAC1B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,SAAiB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACF,CAAC;IAED;;OAEG;IACI,UAAU;QAChB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAE5E;;OAEG;IACI,EAAE,CAAC,IAAuB,EAAE,QAA+B;QACjE,IAAI,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,CAAC;YACV,GAAG,GAAG,IAAI,GAAG,EAAyB,CAAC;YACvC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,GAAG,CAAC,IAAuB,EAAE,QAA+B;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,QAA0B;QAC3C,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE;YACjD,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,4EAA4E;IAE5E;;OAEG;IACI,gBAAgB,CAAC,IAAY,EAAE,QAAsB;QAC3D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,4EAA4E;IAEpE,wBAAwB;QAC/B,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACxC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QAExC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAEtD,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC/D,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,GAAW;QACpC,OAAO,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1D,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,OAAO,CAAC,YAAY,GAAG,gBAAgB,CAAC,IAAI,CAAC;YAE7C,MAAM,UAAU,GAAG,GAAS,EAAE;gBAC7B,OAAO,EAAE,CAAC;gBACV,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAkB,CAAC;gBAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACf,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,+BAA+B,GAAG,GAAG,CAAC,CAAC;oBAC/D,IAAI,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,iBAAiB,CAAC,iBAAiB;wBACzC,SAAS,EAAE,EAAE;wBACb,WAAW,EAAE,CAAC;wBACd,UAAU,EAAE,CAAC;qBACb,CAAC,CAAC;oBACH,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,OAAO;gBACR,CAAC;gBACD,IAAI,CAAC;oBACJ,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC/B,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,MAAM,CAAC,CAAC,CAAC,CAAC;gBACX,CAAC;YACF,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAS,EAAE;gBAC1B,OAAO,EAAE,CAAC;gBACV,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,gCAAgC,GAAG,GAAG,CAAC,CAAC;gBAChE,IAAI,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,iBAAiB,CAAC,iBAAiB;oBACzC,SAAS,EAAE,EAAE;oBACb,WAAW,EAAE,CAAC;oBACd,UAAU,EAAE,CAAC;iBACb,CAAC,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,CAAC;YACf,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAS,EAAE;gBAC1B,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBACxD,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC,CAAC;YAEF,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACrD,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;IACJ,CAAC;IAEO,gBAAgB,CACvB,IAAoB,EACpB,SAAiB,EACjB,SAAiB,EACjB,UAA6B;QAE7B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5C,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;YAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAEnC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,IAAkB,EAAQ,EAAE;gBACrD,WAAW,EAAE,CAAC;gBACd,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,iBAAiB,CAAC,cAAc;oBACtC,SAAS;oBACT,IAAI;oBACJ,WAAW,EAAE,WAAW;oBACxB,UAAU,EAAE,UAAU;iBACtB,CAAC,CAAC;gBACH,IAAI,UAAU,EAAE,CAAC;oBAChB,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;gBACrC,CAAC;YACF,CAAC,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,IAAkB,EAAQ,EAAE;gBAClD,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,iBAAiB,CAAC,eAAe;oBACvC,SAAS;oBACT,IAAI;oBACJ,WAAW,EAAE,WAAW;oBACxB,UAAU,EAAE,UAAU;iBACtB,CAAC,CAAC;YACJ,CAAC,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,OAAe,EAAE,MAAc,EAAQ,EAAE,GAAE,CAAC,CAAC;YAEvE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC7B,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,SAAS,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;gBAEnC,IAAI,QAAQ,EAAE,CAAC;oBACd,IAAI,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,iBAAiB,CAAC,gBAAgB;wBACxC,SAAS;wBACT,WAAW,EAAE,WAAW;wBACxB,UAAU,EAAE,UAAU;qBACtB,CAAC,CAAC;oBACH,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,SAAS,IAAI,CAAC,CAAC,CAAC;gBAC7E,CAAC;qBAAM,CAAC;oBACP,IAAI,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,iBAAiB,CAAC,cAAc;wBACtC,SAAS;wBACT,WAAW,EAAE,WAAW;wBACxB,UAAU,EAAE,UAAU;qBACtB,CAAC,CAAC;oBACH,OAAO,EAAE,CAAC;gBACX,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAEO,gBAAgB,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,IAAI,CAAC,KAAoB;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,GAAG,EAAE,CAAC;YACT,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACJ,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC;YACX,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAa,IAAI,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"Resource.js","sourceRoot":"","sources":["../../../src/kurot/resource/Resource.ts"],"names":[],"mappings":"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"}

package/dist/kurot/text/BitmapText.d.ts

@@ -23,34 +23,95 @@ export declare class BitmapText extends DisplayObject {
     private _multiline;
     private _layout?;
     constructor();
+    /**
+     * Logical layout width, automatically measured until assigned. NaN restores
+     * automatic width. Negative/non-finite values other than NaN throw RangeError;
+     * a finite width constrains wrapping while multiline is enabled.
+     */
     get width(): number;
     set width(value: number);
+    /**
+     * Logical layout height, automatically measured until assigned. NaN restores
+     * automatic height. Negative/non-finite values other than NaN throw RangeError;
+     * verticalAlign positions the bitmap-font line block in this frame.
+     */
     get height(): number;
     set height(value: number);
+    /**
+     * Text to lay out, initially ''. Missing glyphs are skipped rather than loaded
+     * or replaced automatically; space can use the font's fallback advance.
+     */
     get text(): string;
     set text(value: string);
+    /**
+     * Borrowed BitmapFont, initially undefined (empty layout). Clearing or replacing
+     * it does not dispose font textures. The resource/view owner coordinates font
+     * lifetime across all BitmapText instances that share it.
+     */
     get font(): BitmapFont | undefined;
     set font(value: BitmapFont | undefined);
+    /**
+     * Extra logical pixels between rows, initially 0. Negative or non-finite
+     * values throw RangeError; font-native row metrics remain in effect.
+     */
     get lineSpacing(): number;
     set lineSpacing(value: number);
+    /**
+     * Additional logical pixels between glyph advances, initially 0.
+     * Negative spacing is allowed; non-finite values throw RangeError.
+     */
     get letterSpacing(): number;
     set letterSpacing(value: number);
+    /**
+     * Line alignment inside the logical width, initially 'left'. Invalid values
+     * throw RangeError. This does not position the display object in its parent.
+     */
     get textAlign(): 'left' | 'center' | 'right';
     set textAlign(value: 'left' | 'center' | 'right');
+    /**
+     * Bitmap-font line-block alignment inside the logical height, initially
+     * 'middle'. Invalid values throw RangeError; glyph/line metrics come from the font.
+     */
     get verticalAlign(): 'top' | 'middle' | 'bottom';
     set verticalAlign(value: 'top' | 'middle' | 'bottom');
+    /**
+     * Whether glyph textures use smoothed sampling, true by default.
+     * Set false for nearest-neighbor pixel art; this does not change layout metrics.
+     */
     get smoothing(): boolean;
     set smoothing(value: boolean);
+    /**
+     * Whether hard breaks and width wrapping are enabled, true by default.
+     * false uses one unwrapped line; it does not choose vertical alignment.
+     */
     get multiline(): boolean;
     set multiline(value: boolean);
+    /**
+     * Current bitmap-font layout width in logical units, or 0 without a font.
+     * This reports layout content rather than transformed screen-space width.
+     */
     get textWidth(): number;
+    /**
+     * Current bitmap-font layout height in logical units, or 0 without a font.
+     * This is independent of an explicitly assigned height.
+     */
     get textHeight(): number;
+    /**
+     * Returns the cached layout for current text/font/constraints, or an empty
+     * layout without a font. Treat returned layout data as read-only; it is shared
+     * with rendering until a property invalidates the cache.
+     */
     getLayout(): BitmapTextLayout;
     /**
      * Measures with independent constraints without changing the rendered field.
      * NaN means unconstrained; font, spacing, alignment and multiline are retained.
      */
     measureText(width?: number, height?: number): BitmapTextLayout;
+    /**
+     * Read-only glyph placements from the current cached layout. Coordinates are
+     * local logical units; do not mutate or retain them as a live subscription to
+     * future text changes.
+     */
     getGlyphs(): readonly PositionedBitmapGlyph[];
     getTextLines(): string[];
     getTextLinesWidth(): number[];

package/dist/kurot/text/BitmapText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BitmapText.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/BitmapText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAoB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,aAAa;IAE5C;;;OAGG;IACH,OAAc,YAAY,SAAQ;IAGlC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAmB;;IASnC,IAAoB,KAAK,IAAI,MAAM,CAElC;IACD,IAAoB,KAAK,CAAC,KAAK,EAAE,MAAM,EAKtC;IACD,IAAoB,MAAM,IAAI,MAAM,CAEnC;IACD,IAAoB,MAAM,CAAC,KAAK,EAAE,MAAM,EAKvC;IACD,IAAW,IAAI,IAAI,MAAM,CAExB;IACD,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAI5B;IACD,IAAW,IAAI,IAAI,UAAU,GAAG,SAAS,CAExC;IACD,IAAW,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAI5C;IACD,IAAW,WAAW,IAAI,MAAM,CAE/B;IACD,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAKnC;IACD,IAAW,aAAa,IAAI,MAAM,CAEjC;IACD,IAAW,aAAa,CAAC,KAAK,EAAE,MAAM,EAKrC;IACD,IAAW,SAAS,IAAI,MAAM,GAAG,QAAQ,GAAG,OAAO,CAElD;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,EAKtD;IACD,IAAW,aAAa,IAAI,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAEtD;IACD,IAAW,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EAK1D;IACD,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAIlC;IACD,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAIlC;IACD,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD,IAAW,UAAU,IAAI,MAAM,CAE9B;IAGM,SAAS,IAAI,gBAAgB;IAIpC;;;OAGG;IACI,WAAW,CAAC,KAAK,GAAE,MAAY,EAAE,MAAM,GAAE,MAAY,GAAG,gBAAgB;IAaxE,SAAS,IAAI,SAAS,qBAAqB,EAAE;IAG7C,YAAY,IAAI,MAAM,EAAE;IAGxB,iBAAiB,IAAI,MAAM,EAAE;IAG7B,cAAc,IAAI,MAAM,EAAE;IAG1B,aAAa,IAAI,MAAM;IAGvB,aAAa,IAAI,MAAM;IAKd,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAM9D,OAAO,CAAC,WAAW;CAKnB"}
+{"version":3,"file":"BitmapText.d.ts","sourceRoot":"","sources":["../../../src/kurot/text/BitmapText.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAoB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,aAAa;IAE5C;;;OAGG;IACH,OAAc,YAAY,SAAQ;IAGlC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAmB;;IASnC;;;;OAIG;IACH,IAAoB,KAAK,IAAI,MAAM,CAElC;IACD,IAAoB,KAAK,CAAC,KAAK,EAAE,MAAM,EAKtC;IACD;;;;OAIG;IACH,IAAoB,MAAM,IAAI,MAAM,CAEnC;IACD,IAAoB,MAAM,CAAC,KAAK,EAAE,MAAM,EAKvC;IACD;;;OAGG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IACD,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAI5B;IACD;;;;OAIG;IACH,IAAW,IAAI,IAAI,UAAU,GAAG,SAAS,CAExC;IACD,IAAW,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,EAI5C;IACD;;;OAGG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IACD,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAKnC;IACD;;;OAGG;IACH,IAAW,aAAa,IAAI,MAAM,CAEjC;IACD,IAAW,aAAa,CAAC,KAAK,EAAE,MAAM,EAKrC;IACD;;;OAGG;IACH,IAAW,SAAS,IAAI,MAAM,GAAG,QAAQ,GAAG,OAAO,CAElD;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,EAKtD;IACD;;;OAGG;IACH,IAAW,aAAa,IAAI,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAEtD;IACD,IAAW,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EAK1D;IACD;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAIlC;IACD;;;OAGG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD,IAAW,SAAS,CAAC,KAAK,EAAE,OAAO,EAIlC;IACD;;;OAGG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IACD;;;OAGG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;IAGD;;;;OAIG;IACI,SAAS,IAAI,gBAAgB;IAIpC;;;OAGG;IACI,WAAW,CAAC,KAAK,GAAE,MAAY,EAAE,MAAM,GAAE,MAAY,GAAG,gBAAgB;IAa/E;;;;OAIG;IACI,SAAS,IAAI,SAAS,qBAAqB,EAAE;IAG7C,YAAY,IAAI,MAAM,EAAE;IAGxB,iBAAiB,IAAI,MAAM,EAAE;IAG7B,cAAc,IAAI,MAAM,EAAE;IAG1B,aAAa,IAAI,MAAM;IAGvB,aAAa,IAAI,MAAM;IAKd,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAM9D,OAAO,CAAC,WAAW;CAKnB"}