@caperjs/core 0.6.0 → 0.7.0

package/extras/skills/caper/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: caper
-description: Work on a game built with the Caper engine (@caperjs/core, PixiJS v8). Use before touching scenes, entities, popups, UI, plugins, caper.config.ts, assets, generated types, or the dev/verify loop in any app that depends on @caperjs/core. Routes you to the exact section of the shipped reference (llms.txt) instead of the whole engine, and gives the verify loop (typecheck, build, headless automation bridge). Trigger for "caper", "add a scene/entity/popup/plugin", "factory methods", "add.sprite", "defineScene", "actions", "UICanvas", "FlexContainer", "caper.config", "caper-app.d.ts", "assetpack", "window.Caper", or any error mentioning @caperjs.
+description: Work on a game built with the Caper engine (@caperjs/core, PixiJS v8). Use before touching scenes, entities, popups, UI, plugins, caper.config.ts, assets, generated types, or the dev/verify loop in any app that depends on @caperjs/core. Routes you to the exact section of the shipped reference (llms.txt) instead of the whole engine, and gives the verify loop (typecheck, build, headless automation bridge). Trigger for "caper", "add a scene/entity/popup/plugin", "factory methods", "add.sprite", "defineScene", "actions", "UICanvas", "FlexContainer", "caper.config", "caper-app.d.ts", "assetpack", "window.Caper", "compose()", "@caperjs/solid", or any error mentioning @caperjs.
 ---
 
 # Caper — how to work in a Caper app
@@ -33,7 +33,8 @@ sed -n '<start>,<end>p' node_modules/@caperjs/core/extras/llms.txt
 | signals, store, mixins                        | §12                                |
 | generated types, virtual modules              | §14                                |
 | drive the running app headlessly              | §17 Automation bridge              |
-| look up one symbol                            | §18 API index (name → section)     |
+| declare a view with JSX (`@caperjs/solid`)    | §18 Declarative layer              |
+| look up one symbol                            | §19 API index (name → section)     |
 
 Engine source also ships: `node_modules/@caperjs/core/src/`. When the doc is
 not enough, open the one file the doc cites, not the whole tree.
@@ -90,7 +91,54 @@ Then check behaviour live, cheapest first:
   foreground; it never exits. If the human has it running, use it. Otherwise
   ask them to run `pnpm dev` and report.
 
-## 4. Gotchas that cost agents the most time
+## 4. Declarative views (`@caperjs/solid`) — only when installed
+
+Optional package, **not** a plugin: it never appears in `plugins: [...]`. Check
+the app's `package.json` for `@caperjs/solid` before writing any JSX; if it is
+absent, rule 4 of §2 stands and everything is `this.add.*`.
+
+When it is installed, split by shape of the work:
+
+| Work | Write it as |
+| ------------------------------------------- | ------------------------- |
+| UI: state→view bindings, lists, show/hide   | `compose()` JSX           |
+| gameplay: `update()` loops, physics, entities | imperative, unchanged   |
+| one-shot shake / pulse on a node            | imperative via a `ref`    |
+
+Shape: extend `ComposableContainer` / `ComposableScene`, `implements Composes`,
+return JSX from `compose()`. It mounts **once** when the object first hits the
+stage and is disposed in `destroy()`; signals do every update after that. Rule
+of thumb: *`compose()` declares what exists, signals say when state changed,
+`update()` moves things every frame.*
+
+Rules that actually bite:
+
+1. **Scene files in `src/scenes/` must stay JSX-free** — discovery parses them
+   with `jsx: false`. `compose()` returns `SceneView(this)` imported from a
+   sibling `.tsx` directory.
+2. **`draw` functions must be stable references.** Inline `draw={dot(3)}`
+   allocates a new closure whenever any dynamic prop on that element changes and
+   forces a full `clear()` + redraw. Hoist to a module constant.
+3. **Never imperatively remove or reparent a child JSX created.** Solid owns
+   those nodes. Building extra things beside the composed tree is fine.
+4. **Each `compose()` is its own reactive root.** Signals cross roots; Solid
+   *context* does not — pass props or read instance fields.
+5. **`text` defaults to `eventMode: 'none'`** so labels can't swallow taps; an
+   `on*` prop or an explicit `eventMode` overrides it.
+6. **Per-frame bulk motion stays in `update()`** (or `useTick` + a `ref`), not in
+   signals.
+
+Setup, if you are the one adding it: `pnpm add @caperjs/solid solid-js`,
+`caper({ solid: true })` in `vite.config.ts`, and three tsconfig keys —
+`"jsx": "preserve"`, `"jsxFactory": "CaperJSX.h"`, and `"@caperjs/solid/jsx"` in
+`types`. `npx caper doctor` reports a `solid-tsconfig` check listing whatever is
+missing; it reads the app's own `tsconfig.json` and does not follow `extends`.
+
+Reference: llms.txt §18, the package README, and the caper repo's kitchen-sink —
+`src/scenes/SolidJsxScene.ts` (JSX-free scene) with `src/solid-demo/View.tsx`,
+`HealthBar.tsx` and `Orbiter.ts`.
+
+## 5. Gotchas that cost agents the most time
 
 - Out-of-context actions are **dropped by the ActionsPlugin**. That is the
   phase guard; do not add `if (phase !== …)` checks around `sendAction`.

package/lib/{CaptionsPlugin-CDbGZrN9.js → CaptionsPlugin-Boj-gm3A.js}

@@ -1,9 +1,9 @@
-import { Mt as e, Ot as t, U as n, f as r, xt as i } from "./registries-nN_hU44y.js";
+import { Nt as e, St as t, W as n, kt as r, p as i } from "./registries-BmDw_GV1.js";
 import { t as a } from "./padding-1kHDpGlQ.js";
 import { Assets as o, Container as s, Texture as c } from "pixi.js";
 import { gsap as l } from "gsap";
 //#region src/plugins/captions/CaptionsRenderer.ts
-var u = class extends r {
+var u = class extends i {
 	constructor(e) {
 		if (super({ autoResize: !1 }), this.plugin = e, this._size = {
 			width: 0,
@@ -203,10 +203,10 @@ var m = class extends n {
 		if (this._dicts[e]) return;
 		let n = this._options.files.find((t) => e === t.id);
 		if (!n) {
-			t.error(`i18n:: Could not find locale file for ${e}`);
+			r.error(`i18n:: Could not find locale file for ${e}`);
 			return;
 		}
-		this._dicts[e] = n.json ? await o.load(n.json) : await i(n);
+		this._dicts[e] = n.json ? await o.load(n.json) : await t(n);
 	}
 	render() {
 		this.renderer.resize();
@@ -275,4 +275,4 @@ var m = class extends n {
 //#endregion
 export { m as CaptionsPlugin };
 
-//# sourceMappingURL=CaptionsPlugin-CDbGZrN9.js.map
+//# sourceMappingURL=CaptionsPlugin-Boj-gm3A.js.map

package/lib/{CaptionsPlugin-CDbGZrN9.js.map → CaptionsPlugin-Boj-gm3A.js.map}

@@ -1 +1 @@
-{"version":3,"file":"CaptionsPlugin-CDbGZrN9.js","names":[],"sources":["../src/plugins/captions/CaptionsRenderer.ts","../src/plugins/captions/CaptionsPlugin.ts"],"sourcesContent":["import { gsap } from 'gsap';\nimport { BitmapText, Container as PIXIContainer, Sprite, Texture } from 'pixi.js';\nimport { Container } from '../../display/Container';\nimport { type Size } from '../../utils';\nimport { CaptionsPlugin } from './CaptionsPlugin';\n\nexport type CaptionLine = {\n  id: string;\n  start: number;\n  end: number;\n  content: string;\n  speaker?: string;\n};\n\nexport interface ICaptionRenderer extends PIXIContainer {\n  visible: boolean;\n\n  start(): void;\n\n  stop(): void;\n\n  lineBegin(line: CaptionLine): void;\n\n  lineEnd(line: CaptionLine): void;\n\n  resize(size?: Size): void;\n\n  updateSettings(): void;\n\n  destroy(): void;\n}\n\nexport class CaptionsRenderer extends Container implements ICaptionRenderer {\n  private readonly _bg: Sprite;\n  private readonly _text: BitmapText;\n  private readonly _size: Size = { width: 0, height: 0 };\n  private readonly fontSize = 48;\n\n  constructor(private plugin: CaptionsPlugin) {\n    super({ autoResize: false });\n\n    this._bg = this.add.sprite({ asset: Texture.WHITE, anchor: [0.5, 0] });\n    this._bg.tint = this.plugin.options.backgroundColor;\n    this._bg.alpha = 0;\n\n    this._text = this.add.bitmapText({\n      font: plugin.options.fontName,\n      resolution: 2,\n      roundPixels: true,\n      style: {\n        fill: this.plugin.options.textColor,\n        fontSize: this.fontSize * this.getSizeMultiplier(),\n        fontWeight: 'bold',\n        align: 'center',\n        wordWrapWidth: this.plugin.maxWidth,\n        wordWrap: true,\n        lineHeight: this.fontSize * this.getSizeMultiplier() * 2 + 20,\n      },\n    });\n    this._text.style.wordWrap = true;\n    this._text.alpha = 0;\n    this._text.visible = false;\n    this._text.anchor.x = 0.5;\n    this._text.anchor.y = 0;\n    this.addChild(this._text);\n\n    if (this.plugin.debug) {\n      let isTapping = false;\n      this._bg.eventMode = 'static';\n      this._bg.on('pointertap', () => {\n        if (isTapping) {\n          return;\n        }\n        isTapping = true;\n        setTimeout(() => {\n          isTapping = false;\n          void this.app.voiceover.stopVO();\n        }, 100);\n      });\n    }\n  }\n\n  public start(): void {\n    this._text.visible = true;\n    this._bg.visible = true;\n\n    gsap.killTweensOf([this._bg, this._text]);\n    this.animate({ alpha: this.plugin.options.backgroundAlpha, visible: true, duration: 0.2 }, this._bg);\n    this.animate({ alpha: 1, visible: true, duration: 0.2 }, this._text);\n  }\n\n  public stop(): void {\n    gsap.killTweensOf([this._bg, this._text]);\n    this.animate({ alpha: 0, visible: false, duration: 0.2 }, [this._bg, this._text]);\n  }\n\n  public lineBegin(line: CaptionLine): void {\n    let text = line.content\n      .replace(/<[^>]*>/gi, '') // remove html tags\n      .replace(/\\[.*]\\W*/gi, ''); // remove brackets\n    if (line.start === 0) {\n      text = text.charAt(0).toUpperCase() + text.slice(1);\n    }\n    this._text.text = text;\n    this.resize();\n  }\n\n  public lineEnd(_line: CaptionLine): void {}\n\n  public resize(): void {\n    const size = this.app.size;\n    const opts = this.plugin.options;\n\n    this._size.width = size.width;\n    this._size.height = size.height;\n\n    this._text.style.fontSize = this.fontSize * this.getSizeMultiplier();\n    this._text.style.wordWrapWidth = opts.maxWidth * 2;\n    this._text.scale.set(0.5);\n    this._text.position.set(this._size.width * 0.5, 0);\n\n    this._bg.position.set(this._size.width * 0.5, 0);\n\n    let h = this._text.height;\n    if (opts.padding.top) {\n      h += opts.padding.top;\n    }\n    if (opts.padding.bottom) {\n      h += opts.padding.bottom;\n    }\n    this._bg.height = h;\n\n    this._text.y += opts.padding.top;\n\n    if (opts.floating) {\n      let w = this._text.width;\n\n      if (opts.padding.left) {\n        w += opts.padding.left;\n      }\n      if (opts.padding.right) {\n        w += opts.padding.right;\n      }\n\n      this._bg.x += opts.padding.right * 0.5 - opts.padding.left * 0.5;\n      this._bg.width = w;\n    } else {\n      this._bg.width = size.width;\n    }\n\n    if (opts.position === 'top') {\n      this.position.set(-size.width * 0.5, Math.round(-size.height * 0.5));\n      if (opts.floating) {\n        this.position.y += Math.round(opts.distance - this._bg.y);\n      }\n    } else {\n      this.position.set(-size.width * 0.5, Math.round(size.height * 0.5 - this._bg.height));\n      if (opts.floating) {\n        this.position.y -= Math.round(opts.distance + this._bg.y);\n      }\n    }\n  }\n\n  updateSettings() {\n    if (this.plugin.options.enabled) {\n      this._text.style.fill = this.plugin.options.textColor;\n      this._bg.tint = this.plugin.options.backgroundColor;\n      if (this._bg.visible) {\n        this._bg.alpha = this.plugin.options.backgroundAlpha;\n        this.resize();\n      }\n    } else {\n      this.stop();\n      this._bg.visible = false;\n      this._text.visible = false;\n      this._bg.alpha = this._text.alpha = 0;\n    }\n  }\n\n  private getSizeMultiplier(): number {\n    return this.plugin.options.fontSizeMultiplier;\n  }\n}\n","import { Assets, Container, Ticker } from 'pixi.js';\nimport type { ImportListItem, ImportListItemModule, Padding, PointLike } from '../../utils';\nimport { ensurePadding, getDynamicModuleFromImportListItem, isDev, Logger } from '../../utils';\nimport type { IAudioInstance } from '../audio';\nimport type { IPlugin } from '../Plugin';\nimport { Plugin } from '../Plugin';\nimport type { ICaptionRenderer } from './CaptionsRenderer';\nimport { CaptionsRenderer } from './CaptionsRenderer';\n\nconst isDebug = isDev;\n\n/**\n * Type definition for i18n dictionary.\n */\ntype CaptionsDict = Record<string, any>;\n\n/**\n * Type definition for i18n import list item.\n */\ntype CaptionsImportListItem<T> = {\n  id: string;\n  namedExport?: string;\n  options?: any;\n  module?: ImportListItemModule<T>;\n} & {\n  json?: string;\n};\n\ntype CaptionRendererConstructor = new (owner: CaptionsPlugin) => ICaptionRenderer;\n\n/**\n * Type definition for i18n options.\n */\nexport type CaptionsOptions = {\n  renderer: CaptionRendererConstructor;\n  defaultLocale: string;\n  files: CaptionsImportListItem<CaptionsDict>[];\n  fontFile: string;\n  fontName: string;\n  fontSizeMultiplier: number;\n  maxWidth: number;\n  textColor: number;\n  backgroundColor: number;\n  backgroundAlpha: number;\n  enabled: boolean;\n  floating: boolean;\n  distance: number;\n  padding: Padding;\n  position: 'top' | 'bottom';\n};\n\n/**\n * Default options for i18n module.\n */\nconst defaultOptions: Partial<CaptionsOptions> = {\n  renderer: CaptionsRenderer,\n  defaultLocale: 'en',\n  fontFile: './caper/font/Sans.fnt',\n  fontName: 'Sans',\n  fontSizeMultiplier: 1,\n  maxWidth: 0.8,\n  textColor: 0xffffff,\n  backgroundColor: 0x0,\n  backgroundAlpha: 0.4,\n  enabled: true,\n  floating: false,\n  distance: 0,\n  padding: { top: 20, left: 0, bottom: 20, right: 0 },\n  position: 'top',\n};\n\nfunction resolveMaxWidth(value: number, appWidth: number) {\n  if (value <= 0) {\n    return 0;\n  }\n  if (value > 0 && value <= 1) {\n    return appWidth * value;\n  }\n  return value;\n}\n\n/**\n * Interface for i18n module.\n */\nexport interface ICaptionsPlugin extends IPlugin {\n  readonly locale: string;\n  view: Container;\n  enabled: boolean;\n  floating: boolean;\n  distance: number;\n  padding: Padding;\n  position: 'top' | 'bottom';\n  backgroundColor: number;\n  textColor: number;\n  backgroundAlpha: number;\n  fontSizeMultiplier: number;\n  maxWidth: number;\n  options: Partial<CaptionsOptions>;\n\n  setLocale(localeId: string): Promise<string>;\n\n  loadLocale(localeId: string): Promise<void>;\n\n  render(): void;\n}\n\n/**\n * i18n module class.\n */\nexport class CaptionsPlugin extends Plugin<CaptionsOptions> implements ICaptionsPlugin {\n  public readonly id = 'captions';\n  public view: Container = new Container();\n  public renderer: ICaptionRenderer;\n  private _dicts: Record<string, CaptionsDict> = {};\n  private _locales: string[];\n  private _activeCaptionLine = -1;\n  private _activeCaptionTime = 0;\n\n  private _locale: string;\n\n  /**\n   * Getter for locale.\n   */\n  get locale(): string {\n    return this._locale;\n  }\n\n  private _originalOptions: CaptionsOptions;\n\n  get options(): CaptionsOptions {\n    return this._options;\n  }\n\n  set options(value: Partial<CaptionsOptions>) {\n    this._options = { ...this._options, ...value };\n\n    if (value.padding) {\n      this._options.padding = ensurePadding(value.padding);\n    }\n  }\n\n  private _activeCaptionId?: string;\n\n  get activeCaptionId() {\n    return this._activeCaptionId;\n  }\n\n  private _paused: boolean = false;\n\n  get paused(): boolean {\n    return this._paused;\n  }\n\n  set paused(value: boolean) {\n    this._paused = value;\n  }\n\n  get floating(): boolean {\n    return this.options.floating;\n  }\n\n  set floating(value: boolean) {\n    this.options.floating = value;\n    this.updateRenderer();\n  }\n\n  public get enabled(): boolean {\n    return this.options.enabled;\n  }\n\n  set enabled(value: boolean) {\n    this.options.enabled = value;\n    if (this.enabled) {\n      this.view.visible = true;\n    } else {\n      this.view.visible = false;\n    }\n  }\n\n  public get position(): 'top' | 'bottom' {\n    return this.options.position;\n  }\n\n  public set position(value: 'top' | 'bottom') {\n    this.options.position = value;\n    this.renderer.updateSettings();\n  }\n\n  set backgroundColor(value: number) {\n    this.options.backgroundColor = value;\n    this.updateRenderer();\n  }\n\n  set textColor(value: number) {\n    this.options.textColor = value;\n    this.updateRenderer();\n  }\n\n  set backgroundAlpha(value: number) {\n    this.options.backgroundAlpha = value;\n    this.updateRenderer();\n  }\n\n  get padding(): Padding {\n    return this.options.padding;\n  }\n\n  set padding(value: Partial<Padding> | PointLike) {\n    this.options.padding = ensurePadding(value);\n    this.updateRenderer();\n  }\n\n  get distance(): number {\n    return this.options.distance;\n  }\n\n  set distance(value: number) {\n    this.options.distance = value;\n    this.updateRenderer();\n  }\n\n  public get fontSizeMultiplier(): number {\n    return this.options.fontSizeMultiplier;\n  }\n\n  public set fontSizeMultiplier(value: number) {\n    this.options.fontSizeMultiplier = value;\n    this.renderer.resize();\n  }\n\n  public get maxWidth(): number {\n    return this.options.maxWidth;\n  }\n\n  public set maxWidth(value: number) {\n    this.options.maxWidth = resolveMaxWidth(value, this.app.size.width);\n    this.renderer?.resize();\n  }\n\n  get list(): CaptionsDict {\n    return this._dicts[this._locale];\n  }\n\n  get debug(): boolean {\n    return isDebug;\n  }\n\n  /**\n   * Initializes the i18n module.\n   * sets the default locale and loads the locale files.\n   * @param _app\n   * @param options The i18n options.\n   * @returns Promise<void>\n   */\n  public async initialize(options: Partial<CaptionsOptions>): Promise<void> {\n    this._options = {\n      ...defaultOptions,\n      ...options,\n    } as CaptionsOptions;\n\n    this._originalOptions = { ...this._options };\n\n    if (options?.padding) {\n      this._options.padding = ensurePadding(options.padding);\n    }\n\n    this._locale = this.app.i18n.locale;\n    this._locales = this.app.i18n.locales;\n\n    if (this._options.fontFile) {\n      await Assets.load(this._options.fontFile);\n    }\n\n    if (this._options?.files?.length > 0) {\n      const files = this._options.files.filter((file) => this._locales.includes(file.id));\n      for (const file of files) {\n        await this.loadLocale(file.id);\n      }\n    }\n\n    this.addSignalConnection(this.app.onResize.connect(this.handleResize, 'highest'));\n  }\n\n  private handleResize() {\n    this.maxWidth = this._originalOptions.maxWidth;\n  }\n\n  public postInitialize(): void {\n    this.app.i18n.onLocaleChanged.connect(this._handleLocaleChange);\n    this.addSignalConnection(this.app.voiceover.onVoiceOverStart.connect(this._handleVoiceOverStart));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverPaused.connect(this._handleVoiceOverPaused));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverResumed.connect(this._handleVoiceOverResumed));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverComplete.connect(this._handleVoiceoverComplete));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverStopped.connect(this._handleVoiceoverStopped));\n\n    this.app.stage.addChild(this.view);\n    this._options.maxWidth = resolveMaxWidth(this._originalOptions.maxWidth, this.app.size.width);\n    const RendererClass: CaptionRendererConstructor = this.options.renderer;\n    this.renderer = this.view.addChild(new RendererClass(this)) as CaptionsRenderer;\n\n    this.addTickerCallback(this.update);\n    this.app.scenes.onSceneChangeStart.connect(this.stopAllCaptions);\n  }\n\n  /**\n   * Sets the locale.\n   * If the locale is not loaded, it will load it first.\n   * @param localeId The locale id to set.\n   * @returns Promise<string>\n   */\n  async setLocale(localeId: string) {\n    if (this._locale === localeId) {\n      return this._locale;\n    }\n    if (this._activeCaptionId) {\n      this.stopCaption(this._activeCaptionId);\n    }\n    this._activeCaptionId = undefined;\n    await this._loadAndSetLocale(localeId);\n    this._locale = localeId;\n    return this._locale;\n  }\n\n  /**\n   * Loads a locale.\n   * @param localeId The locale id to load.\n   * @returns Promise<void>\n   */\n  async loadLocale(localeId: string) {\n    if (this._dicts[localeId]) {\n      return;\n    }\n    const file = this._options.files.find((file) => localeId === file.id);\n    if (!file) {\n      Logger.error(`i18n:: Could not find locale file for ${localeId}`);\n      return;\n    }\n    this._dicts[localeId] = file.json\n      ? await Assets.load(file.json)\n      : await getDynamicModuleFromImportListItem(file as ImportListItem<CaptionsDict>);\n  }\n\n  render() {\n    this.renderer.resize();\n  }\n\n  update(ticker: Ticker): void {\n    if (this._paused) {\n      return;\n    }\n    const dt: number = ticker.deltaMS / 1000;\n    const id = this._activeCaptionId;\n    if (id) {\n      this._activeCaptionTime += dt;\n      const ms = this._activeCaptionTime * 1000;\n      const cc = this.list[id];\n      const n = cc.length;\n      for (let i = 0; i < n; i++) {\n        if (ms >= cc[i].start && ms < cc[i].end) {\n          if (this._activeCaptionLine !== i) {\n            this.playLine(id, i);\n          }\n          break;\n        }\n      }\n      if (ms >= cc[n - 1].end) {\n        this.playLine(id, -1);\n      }\n    }\n  }\n\n  public playCaption(id: string): void {\n    // remove extension from id\n    id = this._getId(id);\n    this.playLine(id, 0);\n  }\n\n  public stopCaption(id: string): void {\n    // remove extension from id\n    id = this._getId(id);\n    if (this._activeCaptionId === id) {\n      this.playLine(id, -1);\n    }\n  }\n\n  public stopAllCaptions(): void {\n    this.renderer?.stop();\n    this._activeCaptionId = undefined;\n    this._activeCaptionLine = -1;\n  }\n\n  private _getId(id: string) {\n    return id.replace(/\\.[^/.]+$/, '');\n  }\n\n  private updateRenderer() {\n    if (!this.enabled) {\n      return;\n    }\n    this.renderer.updateSettings();\n  }\n\n  private _handleLocaleChange() {\n    void this.setLocale(this.app.i18n.locale);\n  }\n\n  private _handleVoiceOverStart(vo: IAudioInstance) {\n    this.playCaption(vo.id);\n  }\n\n  private _handleVoiceOverPaused() {\n    this.paused = true;\n  }\n\n  private _handleVoiceOverResumed() {\n    this.paused = false;\n  }\n\n  private _handleVoiceoverComplete(vo: IAudioInstance) {\n    const id = this._getId(vo?.id || '');\n    if (this._activeCaptionId === id) {\n      this.stopCaption(id);\n    }\n  }\n\n  private _handleVoiceoverStopped() {\n    this.stopAllCaptions();\n  }\n\n  /**\n   * Loads and sets a locale.\n   * If the locale is not loaded, it will load it first.\n   * @param localeId The locale id to load and set.\n   */\n  private async _loadAndSetLocale(localeId: string) {\n    if (!this._dicts[localeId]) {\n      await this.loadLocale(localeId);\n    }\n  }\n\n  private playLine(id: string, index: number) {\n    const cc = this.list[id];\n    const line = cc ? cc[index] : undefined;\n    if (line) {\n      if (this._activeCaptionId !== id) {\n        this._activeCaptionId = id;\n        this._activeCaptionTime = 0;\n        this._activeCaptionLine = -1;\n        this.renderer?.start();\n      }\n      if (this._activeCaptionLine !== index) {\n        this._activeCaptionLine = index;\n        this.renderer?.lineBegin({\n          id: this._activeCaptionId,\n          ...cc[index],\n        });\n      }\n    } else if (this._activeCaptionId === id && cc) {\n      this.renderer?.lineEnd({\n        id: this._activeCaptionId,\n        ...cc[this._activeCaptionLine],\n      });\n      this.renderer?.stop();\n      this._activeCaptionId = undefined;\n      this._activeCaptionLine = -1;\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"CaptionsPlugin-Boj-gm3A.js","names":[],"sources":["../src/plugins/captions/CaptionsRenderer.ts","../src/plugins/captions/CaptionsPlugin.ts"],"sourcesContent":["import { gsap } from 'gsap';\nimport { BitmapText, Container as PIXIContainer, Sprite, Texture } from 'pixi.js';\nimport { Container } from '../../display/Container';\nimport { type Size } from '../../utils';\nimport { CaptionsPlugin } from './CaptionsPlugin';\n\nexport type CaptionLine = {\n  id: string;\n  start: number;\n  end: number;\n  content: string;\n  speaker?: string;\n};\n\nexport interface ICaptionRenderer extends PIXIContainer {\n  visible: boolean;\n\n  start(): void;\n\n  stop(): void;\n\n  lineBegin(line: CaptionLine): void;\n\n  lineEnd(line: CaptionLine): void;\n\n  resize(size?: Size): void;\n\n  updateSettings(): void;\n\n  destroy(): void;\n}\n\nexport class CaptionsRenderer extends Container implements ICaptionRenderer {\n  private readonly _bg: Sprite;\n  private readonly _text: BitmapText;\n  private readonly _size: Size = { width: 0, height: 0 };\n  private readonly fontSize = 48;\n\n  constructor(private plugin: CaptionsPlugin) {\n    super({ autoResize: false });\n\n    this._bg = this.add.sprite({ asset: Texture.WHITE, anchor: [0.5, 0] });\n    this._bg.tint = this.plugin.options.backgroundColor;\n    this._bg.alpha = 0;\n\n    this._text = this.add.bitmapText({\n      font: plugin.options.fontName,\n      resolution: 2,\n      roundPixels: true,\n      style: {\n        fill: this.plugin.options.textColor,\n        fontSize: this.fontSize * this.getSizeMultiplier(),\n        fontWeight: 'bold',\n        align: 'center',\n        wordWrapWidth: this.plugin.maxWidth,\n        wordWrap: true,\n        lineHeight: this.fontSize * this.getSizeMultiplier() * 2 + 20,\n      },\n    });\n    this._text.style.wordWrap = true;\n    this._text.alpha = 0;\n    this._text.visible = false;\n    this._text.anchor.x = 0.5;\n    this._text.anchor.y = 0;\n    this.addChild(this._text);\n\n    if (this.plugin.debug) {\n      let isTapping = false;\n      this._bg.eventMode = 'static';\n      this._bg.on('pointertap', () => {\n        if (isTapping) {\n          return;\n        }\n        isTapping = true;\n        setTimeout(() => {\n          isTapping = false;\n          void this.app.voiceover.stopVO();\n        }, 100);\n      });\n    }\n  }\n\n  public start(): void {\n    this._text.visible = true;\n    this._bg.visible = true;\n\n    gsap.killTweensOf([this._bg, this._text]);\n    this.animate({ alpha: this.plugin.options.backgroundAlpha, visible: true, duration: 0.2 }, this._bg);\n    this.animate({ alpha: 1, visible: true, duration: 0.2 }, this._text);\n  }\n\n  public stop(): void {\n    gsap.killTweensOf([this._bg, this._text]);\n    this.animate({ alpha: 0, visible: false, duration: 0.2 }, [this._bg, this._text]);\n  }\n\n  public lineBegin(line: CaptionLine): void {\n    let text = line.content\n      .replace(/<[^>]*>/gi, '') // remove html tags\n      .replace(/\\[.*]\\W*/gi, ''); // remove brackets\n    if (line.start === 0) {\n      text = text.charAt(0).toUpperCase() + text.slice(1);\n    }\n    this._text.text = text;\n    this.resize();\n  }\n\n  public lineEnd(_line: CaptionLine): void {}\n\n  public resize(): void {\n    const size = this.app.size;\n    const opts = this.plugin.options;\n\n    this._size.width = size.width;\n    this._size.height = size.height;\n\n    this._text.style.fontSize = this.fontSize * this.getSizeMultiplier();\n    this._text.style.wordWrapWidth = opts.maxWidth * 2;\n    this._text.scale.set(0.5);\n    this._text.position.set(this._size.width * 0.5, 0);\n\n    this._bg.position.set(this._size.width * 0.5, 0);\n\n    let h = this._text.height;\n    if (opts.padding.top) {\n      h += opts.padding.top;\n    }\n    if (opts.padding.bottom) {\n      h += opts.padding.bottom;\n    }\n    this._bg.height = h;\n\n    this._text.y += opts.padding.top;\n\n    if (opts.floating) {\n      let w = this._text.width;\n\n      if (opts.padding.left) {\n        w += opts.padding.left;\n      }\n      if (opts.padding.right) {\n        w += opts.padding.right;\n      }\n\n      this._bg.x += opts.padding.right * 0.5 - opts.padding.left * 0.5;\n      this._bg.width = w;\n    } else {\n      this._bg.width = size.width;\n    }\n\n    if (opts.position === 'top') {\n      this.position.set(-size.width * 0.5, Math.round(-size.height * 0.5));\n      if (opts.floating) {\n        this.position.y += Math.round(opts.distance - this._bg.y);\n      }\n    } else {\n      this.position.set(-size.width * 0.5, Math.round(size.height * 0.5 - this._bg.height));\n      if (opts.floating) {\n        this.position.y -= Math.round(opts.distance + this._bg.y);\n      }\n    }\n  }\n\n  updateSettings() {\n    if (this.plugin.options.enabled) {\n      this._text.style.fill = this.plugin.options.textColor;\n      this._bg.tint = this.plugin.options.backgroundColor;\n      if (this._bg.visible) {\n        this._bg.alpha = this.plugin.options.backgroundAlpha;\n        this.resize();\n      }\n    } else {\n      this.stop();\n      this._bg.visible = false;\n      this._text.visible = false;\n      this._bg.alpha = this._text.alpha = 0;\n    }\n  }\n\n  private getSizeMultiplier(): number {\n    return this.plugin.options.fontSizeMultiplier;\n  }\n}\n","import { Assets, Container, Ticker } from 'pixi.js';\nimport type { ImportListItem, ImportListItemModule, Padding, PointLike } from '../../utils';\nimport { ensurePadding, getDynamicModuleFromImportListItem, isDev, Logger } from '../../utils';\nimport type { IAudioInstance } from '../audio';\nimport type { IPlugin } from '../Plugin';\nimport { Plugin } from '../Plugin';\nimport type { ICaptionRenderer } from './CaptionsRenderer';\nimport { CaptionsRenderer } from './CaptionsRenderer';\n\nconst isDebug = isDev;\n\n/**\n * Type definition for i18n dictionary.\n */\ntype CaptionsDict = Record<string, any>;\n\n/**\n * Type definition for i18n import list item.\n */\ntype CaptionsImportListItem<T> = {\n  id: string;\n  namedExport?: string;\n  options?: any;\n  module?: ImportListItemModule<T>;\n} & {\n  json?: string;\n};\n\ntype CaptionRendererConstructor = new (owner: CaptionsPlugin) => ICaptionRenderer;\n\n/**\n * Type definition for i18n options.\n */\nexport type CaptionsOptions = {\n  renderer: CaptionRendererConstructor;\n  defaultLocale: string;\n  files: CaptionsImportListItem<CaptionsDict>[];\n  fontFile: string;\n  fontName: string;\n  fontSizeMultiplier: number;\n  maxWidth: number;\n  textColor: number;\n  backgroundColor: number;\n  backgroundAlpha: number;\n  enabled: boolean;\n  floating: boolean;\n  distance: number;\n  padding: Padding;\n  position: 'top' | 'bottom';\n};\n\n/**\n * Default options for i18n module.\n */\nconst defaultOptions: Partial<CaptionsOptions> = {\n  renderer: CaptionsRenderer,\n  defaultLocale: 'en',\n  fontFile: './caper/font/Sans.fnt',\n  fontName: 'Sans',\n  fontSizeMultiplier: 1,\n  maxWidth: 0.8,\n  textColor: 0xffffff,\n  backgroundColor: 0x0,\n  backgroundAlpha: 0.4,\n  enabled: true,\n  floating: false,\n  distance: 0,\n  padding: { top: 20, left: 0, bottom: 20, right: 0 },\n  position: 'top',\n};\n\nfunction resolveMaxWidth(value: number, appWidth: number) {\n  if (value <= 0) {\n    return 0;\n  }\n  if (value > 0 && value <= 1) {\n    return appWidth * value;\n  }\n  return value;\n}\n\n/**\n * Interface for i18n module.\n */\nexport interface ICaptionsPlugin extends IPlugin {\n  readonly locale: string;\n  view: Container;\n  enabled: boolean;\n  floating: boolean;\n  distance: number;\n  padding: Padding;\n  position: 'top' | 'bottom';\n  backgroundColor: number;\n  textColor: number;\n  backgroundAlpha: number;\n  fontSizeMultiplier: number;\n  maxWidth: number;\n  options: Partial<CaptionsOptions>;\n\n  setLocale(localeId: string): Promise<string>;\n\n  loadLocale(localeId: string): Promise<void>;\n\n  render(): void;\n}\n\n/**\n * i18n module class.\n */\nexport class CaptionsPlugin extends Plugin<CaptionsOptions> implements ICaptionsPlugin {\n  public readonly id = 'captions';\n  public view: Container = new Container();\n  public renderer: ICaptionRenderer;\n  private _dicts: Record<string, CaptionsDict> = {};\n  private _locales: string[];\n  private _activeCaptionLine = -1;\n  private _activeCaptionTime = 0;\n\n  private _locale: string;\n\n  /**\n   * Getter for locale.\n   */\n  get locale(): string {\n    return this._locale;\n  }\n\n  private _originalOptions: CaptionsOptions;\n\n  get options(): CaptionsOptions {\n    return this._options;\n  }\n\n  set options(value: Partial<CaptionsOptions>) {\n    this._options = { ...this._options, ...value };\n\n    if (value.padding) {\n      this._options.padding = ensurePadding(value.padding);\n    }\n  }\n\n  private _activeCaptionId?: string;\n\n  get activeCaptionId() {\n    return this._activeCaptionId;\n  }\n\n  private _paused: boolean = false;\n\n  get paused(): boolean {\n    return this._paused;\n  }\n\n  set paused(value: boolean) {\n    this._paused = value;\n  }\n\n  get floating(): boolean {\n    return this.options.floating;\n  }\n\n  set floating(value: boolean) {\n    this.options.floating = value;\n    this.updateRenderer();\n  }\n\n  public get enabled(): boolean {\n    return this.options.enabled;\n  }\n\n  set enabled(value: boolean) {\n    this.options.enabled = value;\n    if (this.enabled) {\n      this.view.visible = true;\n    } else {\n      this.view.visible = false;\n    }\n  }\n\n  public get position(): 'top' | 'bottom' {\n    return this.options.position;\n  }\n\n  public set position(value: 'top' | 'bottom') {\n    this.options.position = value;\n    this.renderer.updateSettings();\n  }\n\n  set backgroundColor(value: number) {\n    this.options.backgroundColor = value;\n    this.updateRenderer();\n  }\n\n  set textColor(value: number) {\n    this.options.textColor = value;\n    this.updateRenderer();\n  }\n\n  set backgroundAlpha(value: number) {\n    this.options.backgroundAlpha = value;\n    this.updateRenderer();\n  }\n\n  get padding(): Padding {\n    return this.options.padding;\n  }\n\n  set padding(value: Partial<Padding> | PointLike) {\n    this.options.padding = ensurePadding(value);\n    this.updateRenderer();\n  }\n\n  get distance(): number {\n    return this.options.distance;\n  }\n\n  set distance(value: number) {\n    this.options.distance = value;\n    this.updateRenderer();\n  }\n\n  public get fontSizeMultiplier(): number {\n    return this.options.fontSizeMultiplier;\n  }\n\n  public set fontSizeMultiplier(value: number) {\n    this.options.fontSizeMultiplier = value;\n    this.renderer.resize();\n  }\n\n  public get maxWidth(): number {\n    return this.options.maxWidth;\n  }\n\n  public set maxWidth(value: number) {\n    this.options.maxWidth = resolveMaxWidth(value, this.app.size.width);\n    this.renderer?.resize();\n  }\n\n  get list(): CaptionsDict {\n    return this._dicts[this._locale];\n  }\n\n  get debug(): boolean {\n    return isDebug;\n  }\n\n  /**\n   * Initializes the i18n module.\n   * sets the default locale and loads the locale files.\n   * @param _app\n   * @param options The i18n options.\n   * @returns Promise<void>\n   */\n  public async initialize(options: Partial<CaptionsOptions>): Promise<void> {\n    this._options = {\n      ...defaultOptions,\n      ...options,\n    } as CaptionsOptions;\n\n    this._originalOptions = { ...this._options };\n\n    if (options?.padding) {\n      this._options.padding = ensurePadding(options.padding);\n    }\n\n    this._locale = this.app.i18n.locale;\n    this._locales = this.app.i18n.locales;\n\n    if (this._options.fontFile) {\n      await Assets.load(this._options.fontFile);\n    }\n\n    if (this._options?.files?.length > 0) {\n      const files = this._options.files.filter((file) => this._locales.includes(file.id));\n      for (const file of files) {\n        await this.loadLocale(file.id);\n      }\n    }\n\n    this.addSignalConnection(this.app.onResize.connect(this.handleResize, 'highest'));\n  }\n\n  private handleResize() {\n    this.maxWidth = this._originalOptions.maxWidth;\n  }\n\n  public postInitialize(): void {\n    this.app.i18n.onLocaleChanged.connect(this._handleLocaleChange);\n    this.addSignalConnection(this.app.voiceover.onVoiceOverStart.connect(this._handleVoiceOverStart));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverPaused.connect(this._handleVoiceOverPaused));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverResumed.connect(this._handleVoiceOverResumed));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverComplete.connect(this._handleVoiceoverComplete));\n    this.addSignalConnection(this.app.voiceover.onVoiceOverStopped.connect(this._handleVoiceoverStopped));\n\n    this.app.stage.addChild(this.view);\n    this._options.maxWidth = resolveMaxWidth(this._originalOptions.maxWidth, this.app.size.width);\n    const RendererClass: CaptionRendererConstructor = this.options.renderer;\n    this.renderer = this.view.addChild(new RendererClass(this)) as CaptionsRenderer;\n\n    this.addTickerCallback(this.update);\n    this.app.scenes.onSceneChangeStart.connect(this.stopAllCaptions);\n  }\n\n  /**\n   * Sets the locale.\n   * If the locale is not loaded, it will load it first.\n   * @param localeId The locale id to set.\n   * @returns Promise<string>\n   */\n  async setLocale(localeId: string) {\n    if (this._locale === localeId) {\n      return this._locale;\n    }\n    if (this._activeCaptionId) {\n      this.stopCaption(this._activeCaptionId);\n    }\n    this._activeCaptionId = undefined;\n    await this._loadAndSetLocale(localeId);\n    this._locale = localeId;\n    return this._locale;\n  }\n\n  /**\n   * Loads a locale.\n   * @param localeId The locale id to load.\n   * @returns Promise<void>\n   */\n  async loadLocale(localeId: string) {\n    if (this._dicts[localeId]) {\n      return;\n    }\n    const file = this._options.files.find((file) => localeId === file.id);\n    if (!file) {\n      Logger.error(`i18n:: Could not find locale file for ${localeId}`);\n      return;\n    }\n    this._dicts[localeId] = file.json\n      ? await Assets.load(file.json)\n      : await getDynamicModuleFromImportListItem(file as ImportListItem<CaptionsDict>);\n  }\n\n  render() {\n    this.renderer.resize();\n  }\n\n  update(ticker: Ticker): void {\n    if (this._paused) {\n      return;\n    }\n    const dt: number = ticker.deltaMS / 1000;\n    const id = this._activeCaptionId;\n    if (id) {\n      this._activeCaptionTime += dt;\n      const ms = this._activeCaptionTime * 1000;\n      const cc = this.list[id];\n      const n = cc.length;\n      for (let i = 0; i < n; i++) {\n        if (ms >= cc[i].start && ms < cc[i].end) {\n          if (this._activeCaptionLine !== i) {\n            this.playLine(id, i);\n          }\n          break;\n        }\n      }\n      if (ms >= cc[n - 1].end) {\n        this.playLine(id, -1);\n      }\n    }\n  }\n\n  public playCaption(id: string): void {\n    // remove extension from id\n    id = this._getId(id);\n    this.playLine(id, 0);\n  }\n\n  public stopCaption(id: string): void {\n    // remove extension from id\n    id = this._getId(id);\n    if (this._activeCaptionId === id) {\n      this.playLine(id, -1);\n    }\n  }\n\n  public stopAllCaptions(): void {\n    this.renderer?.stop();\n    this._activeCaptionId = undefined;\n    this._activeCaptionLine = -1;\n  }\n\n  private _getId(id: string) {\n    return id.replace(/\\.[^/.]+$/, '');\n  }\n\n  private updateRenderer() {\n    if (!this.enabled) {\n      return;\n    }\n    this.renderer.updateSettings();\n  }\n\n  private _handleLocaleChange() {\n    void this.setLocale(this.app.i18n.locale);\n  }\n\n  private _handleVoiceOverStart(vo: IAudioInstance) {\n    this.playCaption(vo.id);\n  }\n\n  private _handleVoiceOverPaused() {\n    this.paused = true;\n  }\n\n  private _handleVoiceOverResumed() {\n    this.paused = false;\n  }\n\n  private _handleVoiceoverComplete(vo: IAudioInstance) {\n    const id = this._getId(vo?.id || '');\n    if (this._activeCaptionId === id) {\n      this.stopCaption(id);\n    }\n  }\n\n  private _handleVoiceoverStopped() {\n    this.stopAllCaptions();\n  }\n\n  /**\n   * Loads and sets a locale.\n   * If the locale is not loaded, it will load it first.\n   * @param localeId The locale id to load and set.\n   */\n  private async _loadAndSetLocale(localeId: string) {\n    if (!this._dicts[localeId]) {\n      await this.loadLocale(localeId);\n    }\n  }\n\n  private playLine(id: string, index: number) {\n    const cc = this.list[id];\n    const line = cc ? cc[index] : undefined;\n    if (line) {\n      if (this._activeCaptionId !== id) {\n        this._activeCaptionId = id;\n        this._activeCaptionTime = 0;\n        this._activeCaptionLine = -1;\n        this.renderer?.start();\n      }\n      if (this._activeCaptionLine !== index) {\n        this._activeCaptionLine = index;\n        this.renderer?.lineBegin({\n          id: this._activeCaptionId,\n          ...cc[index],\n        });\n      }\n    } else if (this._activeCaptionId === id && cc) {\n      this.renderer?.lineEnd({\n        id: this._activeCaptionId,\n        ...cc[this._activeCaptionLine],\n      });\n      this.renderer?.stop();\n      this._activeCaptionId = undefined;\n      this._activeCaptionLine = -1;\n    }\n  }\n}\n"],"mappings":"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"}

package/lib/{DataAdapter-BTlNzWqg.js → DataAdapter-Cra9dJ6W.js}

@@ -1,6 +1,6 @@
-import { K as e, U as t, Wt as n, ut as r } from "./registries-nN_hU44y.js";
+import { Gt as e, W as t, dt as n, q as r } from "./registries-BmDw_GV1.js";
 //#region src/plugins/DataAdapter.ts
-var i = /* @__PURE__ */ n({
+var i = /* @__PURE__ */ e({
 	DataAdapter: () => o,
 	defineData: () => a
 });
@@ -8,8 +8,8 @@ function a(e) {
 	return e;
 }
 var o = class extends t {
-	constructor(t = "data") {
-		super(t), this.onDataChange = new e(), this.backupKeys = [], this.backupAll = !1, this.namespace = "", this.overrideWithLocalStorage = !0;
+	constructor(e = "data") {
+		super(e), this.onDataChange = new r(), this.backupKeys = [], this.backupAll = !1, this.namespace = "", this.overrideWithLocalStorage = !0;
 	}
 	getCoreSignals() {
 		return ["onDataChange"];
@@ -28,10 +28,10 @@ var o = class extends t {
 				value: r
 			}), this.data;
 		}
-		let n = e;
-		return t ?? !0 ? this.data = r({ ...this.data }, n) : this.data = n, (this.backupAll || this.backupKeys.length > 0) && this.backupToLocalStorage(this.backupKeys), this.onDataChange.emit({
-			key: Object.keys(n)?.length === 1 ? Object.keys(n)[0] : Object.keys(n),
-			value: n[Object.keys(n)[0]]
+		let r = e;
+		return t ?? !0 ? this.data = n({ ...this.data }, r) : this.data = r, (this.backupAll || this.backupKeys.length > 0) && this.backupToLocalStorage(this.backupKeys), this.onDataChange.emit({
+			key: Object.keys(r)?.length === 1 ? Object.keys(r)[0] : Object.keys(r),
+			value: r[Object.keys(r)[0]]
 		}), this.data;
 	}
 	get(e) {
@@ -86,4 +86,4 @@ var o = class extends t {
 //#endregion
 export { i as n, a as r, o as t };
 
-//# sourceMappingURL=DataAdapter-BTlNzWqg.js.map
+//# sourceMappingURL=DataAdapter-Cra9dJ6W.js.map

package/lib/{DataAdapter-BTlNzWqg.js.map → DataAdapter-Cra9dJ6W.js.map}

@@ -1 +1 @@
-{"version":3,"file":"DataAdapter-BTlNzWqg.js","names":[],"sources":["../src/plugins/DataAdapter.ts"],"sourcesContent":["import { Signal } from '../signals';\nimport { AppTypeOverrides, deepMerge, DeepPartial } from '../utils';\nimport { Plugin } from './Plugin';\n\nexport type DataSchema = {\n  [key: string]: any;\n};\n\n/**\n * Interface for the options of the DataAdapter.\n */\nexport interface IDataAdapterOptions {\n  initial: Partial<AppTypeOverrides['Data']>;\n  /**\n   * The namespace to use for the keys in local storage.\n   */\n  namespace: string;\n  /**\n   * Whether to override the data with the data from local storage.\n   */\n  overrideWithLocalStorage: boolean;\n  /**\n   * Whether to backup all data to local storage.\n   */\n  backupAll: boolean;\n  /**\n   * The keys to backup to local storage.\n   */\n  backupKeys: Array<keyof AppTypeOverrides['Data']>;\n}\n\nexport interface DataChangeSignalDetail {\n  key?: any;\n  value?: any;\n  restore?: boolean;\n  clear?: boolean;\n}\n\ntype DataAdapterType = AppTypeOverrides['Data'];\n\nexport interface IDataAdapter {\n  get(): DataAdapterType;\n  get<K extends keyof DataAdapterType>(key: K): DataAdapterType[K] | undefined;\n  set<K extends keyof DataAdapterType>(key: K, data: DataAdapterType[K]): DataAdapterType;\n  set(data: DeepPartial<DataAdapterType>, merge?: boolean): DataAdapterType;\n  clear(): void;\n  clear<K extends keyof DataAdapterType>(key: K): void;\n  increment<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends number ? P : never }[keyof DataAdapterType],\n  >(\n    key: K,\n    amount?: number,\n  ): DataAdapterType[K];\n  concat<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends any[] ? P : never }[keyof DataAdapterType],\n  >(\n    key: K,\n    value: DataAdapterType[K] extends (infer E)[] ? E | E[] : never,\n  ): DataAdapterType[K];\n  append<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends string ? P : never }[keyof DataAdapterType],\n  >(\n    key: K,\n    value: string,\n    separator?: string,\n  ): DataAdapterType[K];\n  snapshot(): DataAdapterType;\n  snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K];\n  onDataChange: Signal<(detail: DataChangeSignalDetail) => void>;\n  clearOnResume?: boolean;\n}\n\nexport function defineData<T extends DataSchema>(data: T): T {\n  return data;\n}\n\n/**\n * An in-memory game-data plugin with optional localStorage backup.\n *\n * Not `IStorageCapability` — its API (`get`/`set`/`increment`/...) is richer\n * than the generic save/load contract. Accessed directly via `app.data`.\n */\nexport class DataAdapter extends Plugin<Partial<IDataAdapterOptions>> implements IDataAdapter {\n  public data: DataAdapterType;\n\n  public onDataChange: Signal<(detail: DataChangeSignalDetail) => void> = new Signal();\n\n  private backupKeys: Array<keyof DataAdapterType> = [];\n  private backupAll: boolean = false;\n  private namespace: string = '';\n  private overrideWithLocalStorage: boolean = true;\n\n  constructor(id: string = 'data') {\n    super(id);\n  }\n\n  public getCoreSignals(): string[] {\n    return ['onDataChange'];\n  }\n\n  destroy() {\n    this.data = {} as DataAdapterType;\n    super.destroy();\n  }\n\n  public initialize(options?: Partial<IDataAdapterOptions>): void {\n    this.namespace = options?.namespace || this.app.appName;\n    this.data = (options?.initial as DataAdapterType) || ({} as DataAdapterType);\n    this.backupKeys = options?.backupKeys || [];\n    this.backupAll = options?.backupAll || false;\n    this.overrideWithLocalStorage = options?.overrideWithLocalStorage === false ? false : true;\n\n    if (this.backupAll || this.backupKeys.length > 0) {\n      if (this.overrideWithLocalStorage) {\n        this.restoreFromLocalStorage(this.backupKeys);\n      }\n      this.backupToLocalStorage(this.backupKeys);\n    }\n  }\n\n  set<K extends keyof DataAdapterType>(key: K, data: DataAdapterType[K]): DataAdapterType;\n  set(data: DeepPartial<DataAdapterType>, merge?: boolean): DataAdapterType;\n  set<K extends keyof DataAdapterType>(\n    keyOrData: K | DeepPartial<DataAdapterType>,\n    dataOrMerge?: DataAdapterType[K] | boolean,\n  ): DataAdapterType {\n    if (typeof keyOrData === 'string' || typeof keyOrData === 'number' || typeof keyOrData === 'symbol') {\n      const key = keyOrData;\n      const data = dataOrMerge as DataAdapterType[K];\n\n      this.data[key] = data;\n      if (this.backupAll || this.backupKeys.includes(key)) {\n        this.backupToLocalStorage([key]);\n      }\n      this.onDataChange.emit({ key, value: data });\n      return this.data;\n    }\n\n    const data = keyOrData as DeepPartial<DataAdapterType>;\n    const merge = (dataOrMerge as boolean) ?? true;\n\n    if (merge) {\n      this.data = deepMerge({ ...this.data }, data);\n    } else {\n      this.data = data as DataAdapterType;\n    }\n\n    if (this.backupAll || this.backupKeys.length > 0) {\n      this.backupToLocalStorage(this.backupKeys);\n    }\n\n    this.onDataChange.emit({\n      key: Object.keys(data)?.length === 1 ? Object.keys(data)[0] : Object.keys(data),\n      value: data[Object.keys(data)[0]] as DataAdapterType[keyof DataAdapterType],\n    });\n\n    return this.data;\n  }\n\n  get(): DataAdapterType;\n  get<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K] | undefined;\n  get<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K] | DataAdapterType | undefined {\n    if (key === undefined) {\n      return this.data;\n    }\n    return this.data[key];\n  }\n\n  increment<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends number ? P : never }[keyof DataAdapterType],\n  >(key: K, amount: number = 1): DataAdapterType[K] {\n    const currentValue = this.data[key] || 0;\n    const newValue = currentValue + amount;\n    this.set({ [key]: newValue } as DeepPartial<DataAdapterType>);\n    return newValue as DataAdapterType[K];\n  }\n\n  concat<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends any[] ? P : never }[keyof DataAdapterType],\n  >(key: K, value: DataAdapterType[K] extends (infer E)[] ? E | E[] : never): DataAdapterType[K] {\n    const currentValue = this.data[key];\n    const newValue = [...currentValue, ...(Array.isArray(value) ? value : [value])];\n    this.set({ [key]: newValue } as DeepPartial<DataAdapterType>);\n    return newValue as DataAdapterType[K];\n  }\n\n  append<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends string ? P : never }[keyof DataAdapterType],\n  >(key: K, value: string, separator: string = ''): DataAdapterType[K] {\n    const currentValue = this.data[key];\n    let newValue = value;\n    if ((currentValue as string)?.length > 0) {\n      newValue = currentValue + separator + value;\n    }\n    this.set({ [key]: newValue } as DeepPartial<DataAdapterType>);\n    return newValue as DataAdapterType[K];\n  }\n\n  clear(): void;\n  clear<K extends keyof DataAdapterType>(key?: K): void {\n    if (key === undefined) {\n      this.data = {} as DataAdapterType;\n      const prefix = `${this.namespace}-`;\n      for (const storageKey of Object.keys(localStorage).filter((k) => k.startsWith(prefix))) {\n        localStorage.removeItem(storageKey);\n      }\n      this.onDataChange.emit({ key, clear: true });\n    } else {\n      delete this.data[key];\n      localStorage.removeItem(`${this.namespace}-${key as string}`);\n      this.onDataChange.emit({ clear: true });\n    }\n  }\n\n  snapshot(): DataAdapterType;\n  snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K];\n  snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K] | DataAdapterType {\n    if (key === undefined) {\n      return JSON.parse(JSON.stringify(this.data));\n    }\n    return JSON.parse(JSON.stringify(this.data[key]));\n  }\n\n  private backupToLocalStorage(keys?: Array<keyof DataAdapterType>): void {\n    const dataToBackup =\n      keys && keys?.length > 0 ? Object.fromEntries(keys.map((key) => [key, this.data[key]])) : this.data;\n\n    for (const key in dataToBackup) {\n      localStorage.setItem(`${this.namespace}-${key}`, JSON.stringify(dataToBackup[key]));\n    }\n  }\n\n  private restoreFromLocalStorage(keys?: Array<keyof DataAdapterType>): void {\n    const keysToRestore = keys && keys?.length > 0 ? keys : (Object.keys(this.data) as Array<keyof DataAdapterType>);\n    keysToRestore.forEach((key) => {\n      try {\n        const loadedData = localStorage.getItem(`${this.namespace}-${String(key)}`);\n        if (loadedData !== null) {\n          try {\n            const parsedData = JSON.parse(loadedData);\n            this.data[key] = parsedData;\n          } catch {\n            console.warn(\n              `Failed to parse data for key \"${String(key)}\" in namespace \"${this.namespace}\". Using default value.`,\n            );\n          }\n        }\n      } catch (storageError) {\n        console.error(\n          `Error accessing localStorage for key \"${String(key)}\" in namespace \"${this.namespace}\":`,\n          storageError,\n        );\n      }\n    });\n    this.onDataChange.emit({ restore: true });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"DataAdapter-Cra9dJ6W.js","names":[],"sources":["../src/plugins/DataAdapter.ts"],"sourcesContent":["import { Signal } from '../signals';\nimport { AppTypeOverrides, deepMerge, DeepPartial } from '../utils';\nimport { Plugin } from './Plugin';\n\nexport type DataSchema = {\n  [key: string]: any;\n};\n\n/**\n * Interface for the options of the DataAdapter.\n */\nexport interface IDataAdapterOptions {\n  initial: Partial<AppTypeOverrides['Data']>;\n  /**\n   * The namespace to use for the keys in local storage.\n   */\n  namespace: string;\n  /**\n   * Whether to override the data with the data from local storage.\n   */\n  overrideWithLocalStorage: boolean;\n  /**\n   * Whether to backup all data to local storage.\n   */\n  backupAll: boolean;\n  /**\n   * The keys to backup to local storage.\n   */\n  backupKeys: Array<keyof AppTypeOverrides['Data']>;\n}\n\nexport interface DataChangeSignalDetail {\n  key?: any;\n  value?: any;\n  restore?: boolean;\n  clear?: boolean;\n}\n\ntype DataAdapterType = AppTypeOverrides['Data'];\n\nexport interface IDataAdapter {\n  get(): DataAdapterType;\n  get<K extends keyof DataAdapterType>(key: K): DataAdapterType[K] | undefined;\n  set<K extends keyof DataAdapterType>(key: K, data: DataAdapterType[K]): DataAdapterType;\n  set(data: DeepPartial<DataAdapterType>, merge?: boolean): DataAdapterType;\n  clear(): void;\n  clear<K extends keyof DataAdapterType>(key: K): void;\n  increment<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends number ? P : never }[keyof DataAdapterType],\n  >(\n    key: K,\n    amount?: number,\n  ): DataAdapterType[K];\n  concat<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends any[] ? P : never }[keyof DataAdapterType],\n  >(\n    key: K,\n    value: DataAdapterType[K] extends (infer E)[] ? E | E[] : never,\n  ): DataAdapterType[K];\n  append<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends string ? P : never }[keyof DataAdapterType],\n  >(\n    key: K,\n    value: string,\n    separator?: string,\n  ): DataAdapterType[K];\n  snapshot(): DataAdapterType;\n  snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K];\n  onDataChange: Signal<(detail: DataChangeSignalDetail) => void>;\n  clearOnResume?: boolean;\n}\n\nexport function defineData<T extends DataSchema>(data: T): T {\n  return data;\n}\n\n/**\n * An in-memory game-data plugin with optional localStorage backup.\n *\n * Not `IStorageCapability` — its API (`get`/`set`/`increment`/...) is richer\n * than the generic save/load contract. Accessed directly via `app.data`.\n */\nexport class DataAdapter extends Plugin<Partial<IDataAdapterOptions>> implements IDataAdapter {\n  public data: DataAdapterType;\n\n  public onDataChange: Signal<(detail: DataChangeSignalDetail) => void> = new Signal();\n\n  private backupKeys: Array<keyof DataAdapterType> = [];\n  private backupAll: boolean = false;\n  private namespace: string = '';\n  private overrideWithLocalStorage: boolean = true;\n\n  constructor(id: string = 'data') {\n    super(id);\n  }\n\n  public getCoreSignals(): string[] {\n    return ['onDataChange'];\n  }\n\n  destroy() {\n    this.data = {} as DataAdapterType;\n    super.destroy();\n  }\n\n  public initialize(options?: Partial<IDataAdapterOptions>): void {\n    this.namespace = options?.namespace || this.app.appName;\n    this.data = (options?.initial as DataAdapterType) || ({} as DataAdapterType);\n    this.backupKeys = options?.backupKeys || [];\n    this.backupAll = options?.backupAll || false;\n    this.overrideWithLocalStorage = options?.overrideWithLocalStorage === false ? false : true;\n\n    if (this.backupAll || this.backupKeys.length > 0) {\n      if (this.overrideWithLocalStorage) {\n        this.restoreFromLocalStorage(this.backupKeys);\n      }\n      this.backupToLocalStorage(this.backupKeys);\n    }\n  }\n\n  set<K extends keyof DataAdapterType>(key: K, data: DataAdapterType[K]): DataAdapterType;\n  set(data: DeepPartial<DataAdapterType>, merge?: boolean): DataAdapterType;\n  set<K extends keyof DataAdapterType>(\n    keyOrData: K | DeepPartial<DataAdapterType>,\n    dataOrMerge?: DataAdapterType[K] | boolean,\n  ): DataAdapterType {\n    if (typeof keyOrData === 'string' || typeof keyOrData === 'number' || typeof keyOrData === 'symbol') {\n      const key = keyOrData;\n      const data = dataOrMerge as DataAdapterType[K];\n\n      this.data[key] = data;\n      if (this.backupAll || this.backupKeys.includes(key)) {\n        this.backupToLocalStorage([key]);\n      }\n      this.onDataChange.emit({ key, value: data });\n      return this.data;\n    }\n\n    const data = keyOrData as DeepPartial<DataAdapterType>;\n    const merge = (dataOrMerge as boolean) ?? true;\n\n    if (merge) {\n      this.data = deepMerge({ ...this.data }, data);\n    } else {\n      this.data = data as DataAdapterType;\n    }\n\n    if (this.backupAll || this.backupKeys.length > 0) {\n      this.backupToLocalStorage(this.backupKeys);\n    }\n\n    this.onDataChange.emit({\n      key: Object.keys(data)?.length === 1 ? Object.keys(data)[0] : Object.keys(data),\n      value: data[Object.keys(data)[0]] as DataAdapterType[keyof DataAdapterType],\n    });\n\n    return this.data;\n  }\n\n  get(): DataAdapterType;\n  get<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K] | undefined;\n  get<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K] | DataAdapterType | undefined {\n    if (key === undefined) {\n      return this.data;\n    }\n    return this.data[key];\n  }\n\n  increment<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends number ? P : never }[keyof DataAdapterType],\n  >(key: K, amount: number = 1): DataAdapterType[K] {\n    const currentValue = this.data[key] || 0;\n    const newValue = currentValue + amount;\n    this.set({ [key]: newValue } as DeepPartial<DataAdapterType>);\n    return newValue as DataAdapterType[K];\n  }\n\n  concat<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends any[] ? P : never }[keyof DataAdapterType],\n  >(key: K, value: DataAdapterType[K] extends (infer E)[] ? E | E[] : never): DataAdapterType[K] {\n    const currentValue = this.data[key];\n    const newValue = [...currentValue, ...(Array.isArray(value) ? value : [value])];\n    this.set({ [key]: newValue } as DeepPartial<DataAdapterType>);\n    return newValue as DataAdapterType[K];\n  }\n\n  append<\n    K extends keyof DataAdapterType &\n      { [P in keyof DataAdapterType]: DataAdapterType[P] extends string ? P : never }[keyof DataAdapterType],\n  >(key: K, value: string, separator: string = ''): DataAdapterType[K] {\n    const currentValue = this.data[key];\n    let newValue = value;\n    if ((currentValue as string)?.length > 0) {\n      newValue = currentValue + separator + value;\n    }\n    this.set({ [key]: newValue } as DeepPartial<DataAdapterType>);\n    return newValue as DataAdapterType[K];\n  }\n\n  clear(): void;\n  clear<K extends keyof DataAdapterType>(key?: K): void {\n    if (key === undefined) {\n      this.data = {} as DataAdapterType;\n      const prefix = `${this.namespace}-`;\n      for (const storageKey of Object.keys(localStorage).filter((k) => k.startsWith(prefix))) {\n        localStorage.removeItem(storageKey);\n      }\n      this.onDataChange.emit({ key, clear: true });\n    } else {\n      delete this.data[key];\n      localStorage.removeItem(`${this.namespace}-${key as string}`);\n      this.onDataChange.emit({ clear: true });\n    }\n  }\n\n  snapshot(): DataAdapterType;\n  snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K];\n  snapshot<K extends keyof DataAdapterType>(key?: K): DataAdapterType[K] | DataAdapterType {\n    if (key === undefined) {\n      return JSON.parse(JSON.stringify(this.data));\n    }\n    return JSON.parse(JSON.stringify(this.data[key]));\n  }\n\n  private backupToLocalStorage(keys?: Array<keyof DataAdapterType>): void {\n    const dataToBackup =\n      keys && keys?.length > 0 ? Object.fromEntries(keys.map((key) => [key, this.data[key]])) : this.data;\n\n    for (const key in dataToBackup) {\n      localStorage.setItem(`${this.namespace}-${key}`, JSON.stringify(dataToBackup[key]));\n    }\n  }\n\n  private restoreFromLocalStorage(keys?: Array<keyof DataAdapterType>): void {\n    const keysToRestore = keys && keys?.length > 0 ? keys : (Object.keys(this.data) as Array<keyof DataAdapterType>);\n    keysToRestore.forEach((key) => {\n      try {\n        const loadedData = localStorage.getItem(`${this.namespace}-${String(key)}`);\n        if (loadedData !== null) {\n          try {\n            const parsedData = JSON.parse(loadedData);\n            this.data[key] = parsedData;\n          } catch {\n            console.warn(\n              `Failed to parse data for key \"${String(key)}\" in namespace \"${this.namespace}\". Using default value.`,\n            );\n          }\n        }\n      } catch (storageError) {\n        console.error(\n          `Error accessing localStorage for key \"${String(key)}\" in namespace \"${this.namespace}\":`,\n          storageError,\n        );\n      }\n    });\n    this.onDataChange.emit({ restore: true });\n  }\n}\n"],"mappings":"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"}

package/lib/{DebugRenderer-eSVpon4c.js → DebugRenderer-19S58S4h.js}

@@ -1,4 +1,4 @@
-import { Wt as e } from "./registries-nN_hU44y.js";
+import { Gt as e } from "./registries-BmDw_GV1.js";
 import { BigPool as t, Bounds as n, Container as r, Graphics as i, Rectangle as a } from "pixi.js";
 //#region ../../node_modules/.pnpm/yoga-layout@3.2.1/node_modules/yoga-layout/dist/binaries/yoga-wasm-base64-esm.js
 var o = (() => {
@@ -1227,7 +1227,7 @@ async function re() {
 	return ne(await o());
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pixi+layout@3.2.0_@types+react@19.1.8_pixi.js@8.19.0_react@19.1.0_yoga-layout@3.2.1/node_modules/@pixi/layout/dist/core/debug/calculateDebugRegions.mjs
+//#region ../../node_modules/.pnpm/@pixi+layout@3.2.0_@types+react@19.1.8_pixi.js@8.20.0_react@19.1.0_yoga-layout@3.2.1/node_modules/@pixi/layout/dist/core/debug/calculateDebugRegions.mjs
 var w = /* @__PURE__ */ ((e) => (e.Margin = "margin", e.Padding = "padding", e.Border = "border", e.Flex = "flex", e.Content = "content", e))(w || {});
 function T(e, t) {
 	let n = `getComputed${t.charAt(0).toUpperCase() + t.slice(1)}`;
@@ -1259,7 +1259,7 @@ function D(e, t) {
 	l === h.Column || l === h.ColumnReverse ? (s.width = i.outer.width, s.x = i.outer.x) : (s.height = i.outer.height, s.y = i.outer.y), (r = i.inner) == null || r.copyFrom(s.rectangle), t.get("content").outer.copyFrom(s.rectangle);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@pixi+layout@3.2.0_@types+react@19.1.8_pixi.js@8.19.0_react@19.1.0_yoga-layout@3.2.1/node_modules/@pixi/layout/dist/core/debug/DebugNode.mjs
+//#region ../../node_modules/.pnpm/@pixi+layout@3.2.0_@types+react@19.1.8_pixi.js@8.20.0_react@19.1.0_yoga-layout@3.2.1/node_modules/@pixi/layout/dist/core/debug/DebugNode.mjs
 var ie = Object.defineProperty, O = (e, t, n) => t in e ? ie(e, t, {
 	enumerable: !0,
 	configurable: !0,
@@ -1382,4 +1382,4 @@ var se = class extends r {
 //#endregion
 export { s as a, d as c, g as d, _ as f, C as h, re as i, f as l, x as m, w as n, c as o, b as p, E as r, u as s, ce as t, h as u };
 
-//# sourceMappingURL=DebugRenderer-eSVpon4c.js.map
+//# sourceMappingURL=DebugRenderer-19S58S4h.js.map