@caperjs/core 0.2.4 → 0.4.0

package/src/plugins/input/touch/VirtualControls.ts

@@ -1,25 +1,20 @@
 import { bindAllMethods } from '../../../utils';
-import type { ControlsActionMap, JoystickControlsScheme, TouchControlsMap, TouchControlsScheme } from '../types';
+import type { ControlsActionMap, JoystickControlsScheme, TouchControlsMap } from '../types';
 
 import { JoystickDirection } from '..';
-import { Application } from '../../../core/Application';
-import { WithSignals } from '../../../mixins/signals';
+import type { SignalConnection } from '../../../signals';
 import type { IButton, IJoystick } from '../../../ui';
 import type { Action } from '../../actions';
 import { AbstractControls } from '../AbstractControls';
+import { evaluateCombinations } from '../controlsCore';
 
-export class VirtualControls extends WithSignals(AbstractControls) {
+export class VirtualControls extends AbstractControls {
   protected scheme: Partial<TouchControlsMap>;
+  protected readonly logLabel = 'VirtualControls';
   private _buttons: Set<IButton> = new Set();
-  private _joystickMap: Partial<JoystickControlsScheme>;
-  private _buttonDownMap: Partial<TouchControlsScheme>;
-  private _buttonUpMap: Partial<TouchControlsScheme>;
-  private _combinations: string[][] = [];
   private _singleDownButtons: Set<string> = new Set();
   private _activeJoystickDirections: Map<JoystickDirection, Action> = new Map();
-  private _activeButtonDownIds: Map<string, Action> = new Map();
-  private _activeButtonUpIds: Map<string, Action> = new Map();
-  private _combinationsMap: Map<string[], Action> = new Map();
+  private _buttonConnections: Map<IButton, SignalConnection[]> = new Map();
 
   constructor() {
     super();
@@ -36,20 +31,18 @@ export class VirtualControls extends WithSignals(AbstractControls) {
     this._joystick = value;
   }
 
-  get app() {
-    return Application.getInstance();
-  }
-
   addButton(button: IButton) {
     if (!button || this._buttons.has(button)) {
       return;
     }
-    this.addSignalConnection(
+    const connections = [
       button.onDown.connect(() => this._handleButtonDown(button)),
       button.onUp.connect(() => this._handleButtonUp(button)),
       button.onUpOutside.connect(() => this._handleButtonUp(button)),
       button.onDestroy.connect(() => this.removeButton(button)),
-    );
+    ];
+    this.addSignalConnection(...connections);
+    this._buttonConnections.set(button, connections);
     this._buttons.add(button);
   }
 
@@ -57,104 +50,49 @@ export class VirtualControls extends WithSignals(AbstractControls) {
     if (!button || !this._buttons.has(button)) {
       return;
     }
-    button.onDown.disconnect(() => this._handleButtonDown(button));
-    button.onUp.disconnect(() => this._handleButtonUp(button));
-    button.onUpOutside.disconnect(() => this._handleButtonUp(button));
-    button.onDestroy.disconnect(() => this.removeButton(button));
+    // signals disconnect by identity — disconnect the connections made in addButton
+    this._buttonConnections.get(button)?.forEach((connection) => connection.disconnect());
+    this._buttonConnections.delete(button);
+    this._singleDownButtons.delete(button.id!);
     this._buttons.delete(button);
   }
 
   public initialize(scheme: Partial<TouchControlsMap>): void {
     super.initialize(scheme as Partial<ControlsActionMap>);
-    this._buttonDownMap = scheme.down || {};
-    this._buttonUpMap = scheme.up || {};
-    this._joystickMap = scheme.joystick || {};
-    this.app.signal.onActionContextChanged.connect(this._sortActions);
-    this._sortActions();
-  }
-
-  public connect() {
-    this.app.ticker.add(this._update);
   }
 
   isActionActive(action: Action): boolean {
     const buttonAction = this.scheme['down']?.[action] ?? null;
     if (buttonAction) {
-      if (Array.isArray(buttonAction)) {
-        return this._combinationsMap.has(buttonAction);
+      return super.isActionActive(action);
+    }
+    const joystickAction = this.scheme['joystick']?.[action] ?? null;
+    if (this._joystick && joystickAction) {
+      if (Array.isArray(joystickAction)) {
+        return joystickAction.includes(this._joystick.direction);
       } else {
-        return this._singleDownButtons.has(buttonAction);
-      }
-    } else {
-      const joystickAction = this.scheme['joystick']?.[action] ?? null;
-      if (this._joystick && joystickAction) {
-        if (Array.isArray(joystickAction)) {
-          return joystickAction.includes(this._joystick.direction);
-        } else {
-          return joystickAction === this._joystick?.direction;
-        }
+        return joystickAction === this._joystick?.direction;
       }
     }
     return false;
   }
 
-  private _sortActions() {
-    const actions = this.app.actionsPlugin.getActions();
-    this._combinations = [];
-    this._combinationsMap.clear();
-    this._activeJoystickDirections.clear();
-    this._activeButtonDownIds.clear();
-    this._activeButtonUpIds.clear();
-
-    let buttons = Object.keys(this._buttonDownMap);
-    buttons.forEach((key) => {
-      const item = this._buttonDownMap[key];
-      const action = actions[key];
-      if (
-        action.context !== '*' &&
-        action.context !== this.app.actionContext &&
-        !action.context.includes(this.app.actionContext)
-      ) {
-        return;
-      }
-      let input = item;
-      if (input) {
-        if (!Array.isArray(input)) {
-          input = [input];
-        }
-        input.forEach((inputString) => {
-          if (inputString.includes('+')) {
-            const combo = inputString.split('+');
-            this._combinations.push(combo);
-            this._combinationsMap.set(combo, key as Action);
-          } else {
-            this._activeButtonDownIds.set(inputString, key as Action);
-          }
-        });
-      }
-    });
+  protected isInputDown(id: string): boolean {
+    return this._singleDownButtons.has(id);
+  }
 
-    // sort them from the largest to smallest
-    this._combinations.sort((a, b) => b.length - a.length);
-
-    buttons = Object.keys(this._buttonUpMap);
-    buttons.forEach((key) => {
-      const item = this._buttonUpMap[key];
-      const action = actions[key];
-      if (
-        action.context !== '*' &&
-        action.context !== this.app.actionContext &&
-        !action.context.includes(this.app.actionContext)
-      ) {
-        return;
-      }
-      this._activeButtonUpIds.set(item as string, key as Action);
-    });
+  /** A joystick direction can take part in a combination, but never stands alone. */
+  protected isComboPartDown(id: string): boolean {
+    return this._singleDownButtons.has(id) || this._joystick?.direction === id;
+  }
 
-    const joystickActions = Object.keys(this._joystickMap);
-    joystickActions.forEach((key) => {
-      const item = this._joystickMap[key];
-      let input = item;
+  protected _sortActions(): void {
+    super._sortActions();
+
+    this._activeJoystickDirections.clear();
+    const joystickMap: Partial<JoystickControlsScheme> = this.scheme.joystick || {};
+    Object.keys(joystickMap).forEach((key) => {
+      let input = joystickMap[key];
       if (input) {
         if (!Array.isArray(input)) {
           input = [input];
@@ -172,7 +110,7 @@ export class VirtualControls extends WithSignals(AbstractControls) {
 
   private _handleButtonUp(button: IButton): void {
     this._singleDownButtons.delete(button.id!);
-    const action = this._activeButtonUpIds.get(button.id!);
+    const action = this.activeUpInputs.get(button.id!);
     if (action) {
       this.app.action(action, {
         combination: false,
@@ -182,30 +120,25 @@ export class VirtualControls extends WithSignals(AbstractControls) {
     }
   }
 
-  private _update() {
+  protected _update() {
     const joystickDirection = this._joystick?.direction ?? null;
     const buttonsDown = this._singleDownButtons;
-    const eliminated = new Set<string>();
-    // this._combinations is already sorted from largest to smallest
-    for (let i = 0; i < this._combinations.length; i++) {
-      const combination = this._combinations[i];
-      // check if all of the keys in the combination are down
-      if (combination.some((key) => eliminated.has(key))) {
-        continue;
-      }
-      if (combination.every((key) => buttonsDown.has(key) || joystickDirection === key)) {
-        combination.forEach((key) => eliminated.add(key));
-        // send the action
-        const action = this._combinationsMap.get(combination);
-        if (action) {
-          this.app.action(action, {
-            button: combination,
-            combination: true,
-            inputState: 'down',
-          });
-        }
+
+    // this.combinations is already sorted from largest to smallest
+    const { fired, eliminated } = evaluateCombinations(
+      this.combinations,
+      (key) => buttonsDown.has(key) || joystickDirection === key,
+    );
+    fired.forEach((combination) => {
+      const action = this.combinationsMap.get(combination);
+      if (action) {
+        this.app.action(action, {
+          button: combination,
+          combination: true,
+          inputState: 'down',
+        });
       }
-    }
+    });
 
     // order doesn't matter here
     this._singleDownButtons.forEach((id) => {
@@ -213,7 +146,7 @@ export class VirtualControls extends WithSignals(AbstractControls) {
         return;
       }
       if (buttonsDown.has(id)) {
-        const action = this._activeButtonDownIds.get(id);
+        const action = this.activeDownInputs.get(id);
         if (action) {
           this.app.action(action, {
             button: id,

package/src/plugins/spine/SpinePlugin.ts

@@ -1,6 +1,6 @@
 import { extensions } from 'pixi.js';
 import { Plugin } from '../Plugin';
-import { Spine, spineLoaderExtension, SpinePipe, spineTextureAtlasLoader } from './pixi-spine';
+import { Spine, spineLoaderExtension, spineTextureAtlasLoader } from './pixi-spine';
 
 export class SpinePlugin extends Plugin {
   public readonly id = 'SpinePlugin';
@@ -8,7 +8,7 @@ export class SpinePlugin extends Plugin {
   public async initialize() {
     extensions.add(spineTextureAtlasLoader);
     extensions.add(spineLoaderExtension);
-    extensions.add(SpinePipe);
+    // SpinePipe and DarkTintBatcher register themselves at module scope in ./pixi-spine
     (window as any).Spine = Spine;
   }
 }

package/src/store/Store.test.ts

@@ -143,4 +143,19 @@ describe('Store', () => {
     expect(saveA).toHaveBeenCalledWith('k', 1);
     expect(saveB).toHaveBeenCalledWith('k', 1);
   });
+
+  it('save with "*" anywhere in an adapter array fans out to every storage-capable plugin', async () => {
+    const saveA = vi.fn(async () => 'a');
+    const saveB = vi.fn(async () => 'b');
+    const store = new Store().initialize(
+      makeApp([
+        { id: 'a', save: saveA, load: async () => undefined },
+        { id: 'b', save: saveB, load: async () => undefined },
+        { id: 'c' }, // not storage-capable → must be skipped
+      ]),
+    );
+    await store.save(['a', '*'] as never, 'k', 1);
+    expect(saveA).toHaveBeenCalledWith('k', 1);
+    expect(saveB).toHaveBeenCalledWith('k', 1);
+  });
 });

package/src/store/Store.ts

@@ -126,7 +126,10 @@ export class Store implements IStore {
       keys = adapterId as string[] | Partial<AdapterSaveConfig>[];
     }
 
-    if ((keys[0] as string) === '*' || (keys[0] as Partial<AdapterSaveConfig>)?.adapterId === '*') {
+    const hasStarKey = keys.some(
+      (k) => (k as string) === '*' || (k as Partial<AdapterSaveConfig>)?.adapterId === '*',
+    );
+    if (hasStarKey) {
       keys = this.allAdapterIds();
     }
 

package/src/ui/Button.test.ts

@@ -147,6 +147,18 @@ describe('Button press-state machine', () => {
     expect(onClick).toHaveBeenCalledTimes(1);
   });
 
+  it('dispatches a click action with no data without throwing, attaching the button to the payload', () => {
+    const button = makeButton();
+    (button as any).config.actions = { click: { id: 'foo' } };
+    const action = vi.fn();
+    Object.defineProperty(button, 'app', { value: { action }, configurable: true });
+
+    (button as any).handlePointerDown({ pointerId: 1 });
+    expect(() => (button as any).handleClick({ pointerId: 1 })).not.toThrow();
+
+    expect(action).toHaveBeenCalledWith('foo', { button });
+  });
+
   it('still clicks for a synthetic keyboard activation (no pointerId)', () => {
     const button = makeButton();
     const onClick = vi.fn();

package/src/ui/Button.ts

@@ -461,6 +461,7 @@ export class Button extends _Button implements IButton {
     if (typeof action === 'function') {
       void action();
     } else {
+      action.data ??= {};
       if (!action.data.button) {
         action.data.button = this;
       }

package/src/ui/UICanvas.test.ts

@@ -1,12 +1,29 @@
-import { describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { Container as PIXIContainer } from 'pixi.js';
 
 // UICanvas transitively imports Application → Pixi display graph. Stub it — the
-// pure padding helper needs none of it.
-vi.mock('../core/Application', () => ({
-  Application: { getInstance: () => ({}) },
-}));
+// pure padding helper needs none of it. The "element reordering" describe block
+// below constructs real UICanvas instances, which internally build FlexContainer
+// and Container children; those classes read `Application.getInstance()` for
+// their own `app` getter (independent of UICanvas's own `app` override), so the
+// stub needs a minimal shape (`config.useLayout`) satisfying their constructors too.
+vi.mock('../core/Application', async () => {
+  const { Signal } = await import('../signals');
+  const fakeApp = {
+    config: { useLayout: true },
+    renderer: { layout: undefined },
+    ticker: { addOnce: () => {} },
+    onResize: new Signal(),
+  };
+  return { Application: { getInstance: () => fakeApp } };
+});
 
-import { computeEffectivePadding } from './UICanvas';
+// Registers the factory method table `Factory()` (part of Container's mixin
+// chain) reads from — must be imported before any display/ui class is
+// constructed. See importOrder.containerFirst.test.ts.
+import '../mixins/factory/const';
+import { Signal } from '../signals';
+import { computeEffectivePadding, UICanvas } from './UICanvas';
 
 const zero = { top: 0, right: 0, bottom: 0, left: 0 };
 
@@ -33,3 +50,89 @@ describe('computeEffectivePadding', () => {
     expect(computeEffectivePadding(base, safeArea).top).toBe(54);
   });
 });
+
+describe('UICanvas element reordering', () => {
+  let app: any;
+  let originalAppDescriptor: PropertyDescriptor | undefined;
+
+  beforeEach(() => {
+    app = {
+      config: { useLayout: true },
+      size: { width: 800, height: 600 },
+      onResize: new Signal<() => void>(),
+      ticker: { addOnce: vi.fn() },
+    };
+    originalAppDescriptor = Object.getOwnPropertyDescriptor(UICanvas.prototype, 'app');
+    Object.defineProperty(UICanvas.prototype, 'app', { get: () => app, configurable: true });
+  });
+
+  afterEach(() => {
+    if (originalAppDescriptor) {
+      Object.defineProperty(UICanvas.prototype, 'app', originalAppDescriptor);
+    } else {
+      delete (UICanvas.prototype as any).app;
+    }
+  });
+
+  function addThree(canvas: UICanvas) {
+    const a = new PIXIContainer({ label: 'a' });
+    const b = new PIXIContainer({ label: 'b' });
+    const c = new PIXIContainer({ label: 'c' });
+    canvas.addElement(a, { align: 'top left' });
+    canvas.addElement(b, { align: 'top left' });
+    canvas.addElement(c, { align: 'top left' });
+    const container = (canvas as any)._childMap.get(a);
+    return { a, b, c, container };
+  }
+
+  it('reorderElement moves an element within its region', () => {
+    const canvas = new UICanvas({});
+    const { a, b, c, container } = addThree(canvas);
+
+    canvas.reorderElement(a, 2);
+
+    expect(container.children.indexOf(a)).toBeGreaterThanOrEqual(0);
+    expect([b, c, a].every((child, i) => container.children[i] === child)).toBe(true);
+  });
+
+  it('bringToFront moves an element to the last index in its region', () => {
+    const canvas = new UICanvas({});
+    const { a, b, c, container } = addThree(canvas);
+
+    canvas.bringToFront(a);
+
+    expect([b, c, a].every((child, i) => container.children[i] === child)).toBe(true);
+  });
+
+  it('sendToBack moves an element to the first index in its region', () => {
+    const canvas = new UICanvas({});
+    const { a, b, c, container } = addThree(canvas);
+
+    canvas.sendToBack(c);
+
+    expect([c, a, b].every((child, i) => container.children[i] === child)).toBe(true);
+  });
+
+  it('reorderElement throws when the child was never added via addElement', () => {
+    const canvas = new UICanvas({});
+    const neverAdded = new PIXIContainer({ label: 'never-added' });
+
+    expect(() => canvas.reorderElement(neverAdded, 0)).toThrow(/Cannot reorder element/);
+    expect(() => canvas.reorderElement(neverAdded, 0)).toThrow(/not added via addElement/);
+  });
+
+  it('bringToFront and sendToBack throw when the child was never added via addElement', () => {
+    const canvas = new UICanvas({});
+    const neverAdded = new PIXIContainer({ label: 'never-added' });
+
+    expect(() => canvas.bringToFront(neverAdded)).toThrow(/Cannot reorder element/);
+    expect(() => canvas.sendToBack(neverAdded)).toThrow(/Cannot reorder element/);
+  });
+
+  it('setChildIndex throws a guard error instead of the old Pixi passthrough', () => {
+    const canvas = new UICanvas({});
+    const { a } = addThree(canvas);
+
+    expect(() => canvas.setChildIndex(a, 0)).toThrow(/Do not call setChildIndex/);
+  });
+});

package/src/ui/UICanvas.ts

@@ -490,9 +490,11 @@ export class UICanvas extends _UICanvas {
   /**
    * Sets the index of the child in the container
    */
-  public setChildIndex = <U extends PIXIContainer>(child: U, index: number): void => {
-    super.setChildIndex(child, index);
-    this._updateLayout();
+  public setChildIndex = <U extends PIXIContainer>(_child: U, _index: number): void => {
+    throw new Error(
+      `UICanvas: Do not call setChildIndex() directly. Use reorderElement(child, index), bringToFront(child), or sendToBack(child) instead.\n` +
+        `Example: uiCanvas.reorderElement(myChild, 0)`,
+    );
   };
 
   /**
@@ -668,6 +670,42 @@ export class UICanvas extends _UICanvas {
     return child;
   }
 
+  /**
+   * Reorders an element within its region container, changing its position in
+   * the flex layout and paint order.
+   */
+  public reorderElement<U extends PIXIContainer>(child: U, index: number): U {
+    const container = this._childMap.get(child);
+    if (!container) {
+      throw new Error(
+        `UICanvas: Cannot reorder element — it was not added via addElement().\n` +
+          `Child label: "${child.label ?? '(unlabeled)'}"`,
+      );
+    }
+
+    container.setChildIndex(child, index);
+    this._updateLayout();
+    return child;
+  }
+
+  /** Moves an element to the last index (painted/laid-out last) within its region. */
+  public bringToFront<U extends PIXIContainer>(child: U): U {
+    const container = this._childMap.get(child);
+    if (!container) {
+      throw new Error(
+        `UICanvas: Cannot reorder element — it was not added via addElement().\n` +
+          `Child label: "${child.label ?? '(unlabeled)'}"`,
+      );
+    }
+
+    return this.reorderElement(child, container.children.length - 1);
+  }
+
+  /** Moves an element to the first index (painted/laid-out first) within its region. */
+  public sendToBack<U extends PIXIContainer>(child: U): U {
+    return this.reorderElement(child, 0);
+  }
+
   private _childAdded(child: PIXIContainer) {
     if (this.config.autoLayoutChildren) {
       if (!child.layout) {

package/src/utils/color.test.ts

@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest';
+import { Color } from './color';
+
+describe('Color.rgbToHexString', () => {
+  it('rounds fractional rgb components to a valid 2-digit hex pair', () => {
+    expect(Color.rgbToHexString(127.5)).toBe('80');
+    expect(Color.rgbToHexString(0.4)).toBe('00');
+    expect(Color.rgbToHexString(254.9)).toBe('ff');
+  });
+
+  it('produces a valid 6-digit hex string from fractional rgb components', () => {
+    const hex = Color.rgbToFullHexString(127.5, 0.4, 254.9);
+    expect(hex).toMatch(/^[0-9a-f]{6}$/);
+    expect(hex).toBe('8000ff');
+  });
+});

package/src/utils/color.ts

@@ -64,7 +64,8 @@ export class Color {
   }
 
   public static rgbToHexString(pNumber: number): string {
-    let hex = Number(pNumber).toString(16);
+    const clamped = Math.max(0, Math.min(255, Math.round(Number(pNumber))));
+    let hex = clamped.toString(16);
     if (hex.length < 2) {
       hex = '0' + hex;
     }

package/src/utils/platform.ts

@@ -20,7 +20,7 @@ export const isRetina =
  */
 export const isTouch: boolean =
   typeof window !== 'undefined'
-    ? 'ontouchstart' in window || navigator.maxTouchPoints > 0 || navigator?.maxTouchPoints > 0
+    ? 'ontouchstart' in window || navigator.maxTouchPoints > 0
     : false;
 
 /**

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is auto-generated during the build process.
-export const version: string = '0.2.4';
+export const version: string = '0.4.0';
 export const pixiVersion: string = '8.19.0';

package/lib/DataAdapter-DS-twowe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DataAdapter-DS-twowe.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  }\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      localStorage.clear();\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 (parseError) {\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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"}