mvc-kit 2.8.0 → 2.9.0

package/dist/Resource.d.ts.map

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

package/dist/Resource.js

@@ -63,12 +63,15 @@ class Resource extends Collection {
     return this.onInit?.();
   }
   // ── Collection delegation ─────────────────────────────────────
+  /** Current items array. Delegates to external Collection when injected. */
   get state() {
     return this._external ? this._external.state : super.state;
   }
+  /** The raw array of items. Delegates to external Collection when injected. */
   get items() {
     return this._external ? this._external.items : super.items;
   }
+  /** Number of items. Delegates to external Collection when injected. */
   get length() {
     return this._external ? this._external.length : super.length;
   }

package/dist/Resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"Resource.js","sources":["../src/Resource.ts"],"sourcesContent":["import { Collection } from './Collection';\nimport { walkPrototypeChain } from './walkPrototypeChain';\nimport { wrapAsyncMethods } from './wrapAsyncMethods';\nimport type { InternalTaskState } from './wrapAsyncMethods';\nimport type { Listener, TaskState } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Async tracking types ────────────────────────────────────────\n\nconst DEFAULT_TASK_STATE: TaskState = Object.freeze({ loading: false, error: null, errorCode: null });\n\nexport type ResourceAsyncMethodKeys<T> = {\n  [K in Exclude<keyof T, keyof Resource<any>>]: T[K] extends (...args: any[]) => Promise<any> ? K : never;\n}[Exclude<keyof T, keyof Resource<any>>];\n\ntype ResourceAsyncMap<T> = {\n  readonly [K in ResourceAsyncMethodKeys<T>]: TaskState;\n};\n\nconst RESERVED_ASYNC_KEYS = ['async', 'subscribeAsync'] as const;\nconst LIFECYCLE_HOOKS = new Set(['onInit', 'onDispose']);\n\n// ── Resource ────────────────────────────────────────────────────\n\n/**\n * Collection + async tracking toolkit. Extends Collection with lifecycle\n * (init/dispose) and automatic async method tracking. Optionally delegates\n * to an external Collection for shared data scenarios.\n */\nexport class Resource<T extends { id: string | number }> extends Collection<T> {\n  private _external: Collection<T> | null = null;\n  private _initialized = false;\n\n  // ── Async tracking fields ──\n  private _asyncStates = new Map<string, InternalTaskState>();\n  private _asyncSnapshots = new Map<string, TaskState>();\n  private _asyncListeners = new Set<() => void>();\n  private _asyncProxy: ResourceAsyncMap<this> | null = null;\n  private _activeOps: Map<string, number> | null = null;\n\n  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */\n  static GHOST_TIMEOUT = 3000;\n\n  constructor(collectionOrItems?: Collection<T> | T[]) {\n    const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);\n    super(isExternal ? [] : (collectionOrItems as T[]) ?? []);\n\n    if (isExternal) {\n      this._external = collectionOrItems as Collection<T>;\n\n      if (__DEV__) {\n        const Ctor = this.constructor as typeof Resource;\n        if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) {\n          console.warn(\n            `[mvc-kit] Resource \"${Ctor.name}\" has MAX_SIZE or TTL set but uses an ` +\n            `injected Collection. Configure these on the Collection instead.`\n          );\n        }\n      }\n    }\n\n    this._guardReservedKeys();\n  }\n\n  // ── Lifecycle ─────────────────────────────────────────────────\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this.disposed) return;\n    this._initialized = true;\n\n    if (__DEV__) {\n      this._activeOps = new Map();\n    }\n\n    wrapAsyncMethods({\n      instance: this,\n      stopPrototype: Resource.prototype,\n      reservedKeys: RESERVED_ASYNC_KEYS,\n      lifecycleHooks: LIFECYCLE_HOOKS,\n      isDisposed: () => this.disposed,\n      isInitialized: () => this._initialized,\n      asyncStates: this._asyncStates,\n      asyncSnapshots: this._asyncSnapshots,\n      asyncListeners: this._asyncListeners,\n      notifyAsync: () => this._notifyAsync(),\n      addCleanup: (fn) => this.addCleanup(fn),\n      ghostTimeout: (this.constructor as typeof Resource).GHOST_TIMEOUT,\n      className: 'Resource',\n      activeOps: this._activeOps,\n    });\n\n    return this.onInit?.();\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n\n  // ── Collection delegation ─────────────────────────────────────\n\n  get state(): T[] {\n    return this._external ? this._external.state : super.state;\n  }\n\n  get items(): T[] {\n    return this._external ? this._external.items : super.items;\n  }\n\n  get length(): number {\n    return this._external ? this._external.length : super.length;\n  }\n\n  add(...items: T[]): void {\n    this._external ? this._external.add(...items) : super.add(...items);\n  }\n\n  upsert(...items: T[]): void {\n    this._external ? this._external.upsert(...items) : super.upsert(...items);\n  }\n\n  update(id: T['id'], changes: Partial<T>): void {\n    this._external ? this._external.update(id, changes) : super.update(id, changes);\n  }\n\n  remove(...ids: T['id'][]): void {\n    this._external ? this._external.remove(...ids) : super.remove(...ids);\n  }\n\n  reset(items: T[]): void {\n    this._external ? this._external.reset(items) : super.reset(items);\n  }\n\n  clear(): void {\n    this._external ? this._external.clear() : super.clear();\n  }\n\n  optimistic(callback: () => void): () => void {\n    return this._external ? this._external.optimistic(callback) : super.optimistic(callback);\n  }\n\n  get(id: T['id']): T | undefined {\n    return this._external ? this._external.get(id) : super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    return this._external ? this._external.has(id) : super.has(id);\n  }\n\n  find(predicate: (item: T) => boolean): T | undefined {\n    return this._external ? this._external.find(predicate) : super.find(predicate);\n  }\n\n  filter(predicate: (item: T) => boolean): T[] {\n    return this._external ? this._external.filter(predicate) : super.filter(predicate);\n  }\n\n  sorted(compareFn: (a: T, b: T) => number): T[] {\n    return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);\n  }\n\n  map<U>(fn: (item: T) => U): U[] {\n    return this._external ? this._external.map(fn) : super.map(fn);\n  }\n\n  subscribe(listener: Listener<T[]>): () => void {\n    if (this.disposed) return () => {};\n    return this._external ? this._external.subscribe(listener) : super.subscribe(listener);\n  }\n\n  // ── Async tracking API ────────────────────────────────────────\n\n  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */\n  get async(): ResourceAsyncMap<this> {\n    if (!this._asyncProxy) {\n      const self = this;\n      this._asyncProxy = new Proxy({} as ResourceAsyncMap<this>, {\n        get(_, prop: string) {\n          return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;\n        },\n        has(_, prop: string) {\n          return self._asyncSnapshots.has(prop);\n        },\n        ownKeys() {\n          return Array.from(self._asyncSnapshots.keys());\n        },\n        getOwnPropertyDescriptor(_, prop: string) {\n          if (self._asyncSnapshots.has(prop)) {\n            return { configurable: true, enumerable: true, value: self._asyncSnapshots.get(prop) };\n          }\n          return undefined;\n        },\n      });\n    }\n    return this._asyncProxy;\n  }\n\n  /** Subscribes to async state changes. Used by `useInstance` for React integration. */\n  subscribeAsync(listener: () => void): () => void {\n    if (this.disposed) return () => {};\n    this._asyncListeners.add(listener);\n    return () => { this._asyncListeners.delete(listener); };\n  }\n\n  // ── Private: async tracking internals ─────────────────────────\n\n  private _notifyAsync(): void {\n    for (const listener of this._asyncListeners) {\n      listener();\n    }\n  }\n\n  private _guardReservedKeys(): void {\n    walkPrototypeChain(this, Resource.prototype, (key) => {\n      if (RESERVED_ASYNC_KEYS.includes(key as any)) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on Resource and cannot be overridden.`\n        );\n      }\n    });\n  }\n\n}\n"],"names":[],"mappings":";;;AAMA,MAAM,UAAU,OAAO,oBAAoB,eAAe;AAI1D,MAAM,qBAAgC,OAAO,OAAO,EAAE,SAAS,OAAO,OAAO,MAAM,WAAW,MAAM;AAUpG,MAAM,sBAAsB,CAAC,SAAS,gBAAgB;AACtD,MAAM,kBAAkB,oBAAI,IAAI,CAAC,UAAU,WAAW,CAAC;AAShD,MAAM,iBAAoD,WAAc;AAAA,EACrE,YAAkC;AAAA,EAClC,eAAe;AAAA;AAAA,EAGf,mCAAmB,IAAA;AAAA,EACnB,sCAAsB,IAAA;AAAA,EACtB,sCAAsB,IAAA;AAAA,EACtB,cAA6C;AAAA,EAC7C,aAAyC;AAAA;AAAA,EAGjD,OAAO,gBAAgB;AAAA,EAEvB,YAAY,mBAAyC;AACnD,UAAM,aAAa,qBAAqB,QAAQ,CAAC,MAAM,QAAQ,iBAAiB;AAChF,UAAM,aAAa,KAAM,qBAA6B,CAAA,CAAE;AAExD,QAAI,YAAY;AACd,WAAK,YAAY;AAEjB,UAAI,SAAS;AACX,cAAM,OAAO,KAAK;AAClB,YAAI,KAAK,WAAW,KAAK,KAAK,MAAM,GAAG;AACrC,kBAAQ;AAAA,YACN,uBAAuB,KAAK,IAAI;AAAA,UAAA;AAAA,QAGpC;AAAA,MACF;AAAA,IACF;AAEA,SAAK,mBAAA;AAAA,EACP;AAAA;AAAA;AAAA,EAKA,IAAI,cAAuB;AACzB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,OAA6B;AAC3B,QAAI,KAAK,gBAAgB,KAAK,SAAU;AACxC,SAAK,eAAe;AAEpB,QAAI,SAAS;AACX,WAAK,iCAAiB,IAAA;AAAA,IACxB;AAEA,qBAAiB;AAAA,MACf,UAAU;AAAA,MACV,eAAe,SAAS;AAAA,MACxB,cAAc;AAAA,MACd,gBAAgB;AAAA,MAChB,YAAY,MAAM,KAAK;AAAA,MACvB,eAAe,MAAM,KAAK;AAAA,MAC1B,aAAa,KAAK;AAAA,MAClB,gBAAgB,KAAK;AAAA,MACrB,gBAAgB,KAAK;AAAA,MACrB,aAAa,MAAM,KAAK,aAAA;AAAA,MACxB,YAAY,CAAC,OAAO,KAAK,WAAW,EAAE;AAAA,MACtC,cAAe,KAAK,YAAgC;AAAA,MACpD,WAAW;AAAA,MACX,WAAW,KAAK;AAAA,IAAA,CACjB;AAED,WAAO,KAAK,SAAA;AAAA,EACd;AAAA;AAAA,EAOA,IAAI,QAAa;AACf,WAAO,KAAK,YAAY,KAAK,UAAU,QAAQ,MAAM;AAAA,EACvD;AAAA,EAEA,IAAI,QAAa;AACf,WAAO,KAAK,YAAY,KAAK,UAAU,QAAQ,MAAM;AAAA,EACvD;AAAA,EAEA,IAAI,SAAiB;AACnB,WAAO,KAAK,YAAY,KAAK,UAAU,SAAS,MAAM;AAAA,EACxD;AAAA,EAEA,OAAO,OAAkB;AACvB,SAAK,YAAY,KAAK,UAAU,IAAI,GAAG,KAAK,IAAI,MAAM,IAAI,GAAG,KAAK;AAAA,EACpE;AAAA,EAEA,UAAU,OAAkB;AAC1B,SAAK,YAAY,KAAK,UAAU,OAAO,GAAG,KAAK,IAAI,MAAM,OAAO,GAAG,KAAK;AAAA,EAC1E;AAAA,EAEA,OAAO,IAAa,SAA2B;AAC7C,SAAK,YAAY,KAAK,UAAU,OAAO,IAAI,OAAO,IAAI,MAAM,OAAO,IAAI,OAAO;AAAA,EAChF;AAAA,EAEA,UAAU,KAAsB;AAC9B,SAAK,YAAY,KAAK,UAAU,OAAO,GAAG,GAAG,IAAI,MAAM,OAAO,GAAG,GAAG;AAAA,EACtE;AAAA,EAEA,MAAM,OAAkB;AACtB,SAAK,YAAY,KAAK,UAAU,MAAM,KAAK,IAAI,MAAM,MAAM,KAAK;AAAA,EAClE;AAAA,EAEA,QAAc;AACZ,SAAK,YAAY,KAAK,UAAU,MAAA,IAAU,MAAM,MAAA;AAAA,EAClD;AAAA,EAEA,WAAW,UAAkC;AAC3C,WAAO,KAAK,YAAY,KAAK,UAAU,WAAW,QAAQ,IAAI,MAAM,WAAW,QAAQ;AAAA,EACzF;AAAA,EAEA,IAAI,IAA4B;AAC9B,WAAO,KAAK,YAAY,KAAK,UAAU,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE;AAAA,EAC/D;AAAA,EAEA,IAAI,IAAsB;AACxB,WAAO,KAAK,YAAY,KAAK,UAAU,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE;AAAA,EAC/D;AAAA,EAEA,KAAK,WAAgD;AACnD,WAAO,KAAK,YAAY,KAAK,UAAU,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;AAAA,EAC/E;AAAA,EAEA,OAAO,WAAsC;AAC3C,WAAO,KAAK,YAAY,KAAK,UAAU,OAAO,SAAS,IAAI,MAAM,OAAO,SAAS;AAAA,EACnF;AAAA,EAEA,OAAO,WAAwC;AAC7C,WAAO,KAAK,YAAY,KAAK,UAAU,OAAO,SAAS,IAAI,MAAM,OAAO,SAAS;AAAA,EACnF;AAAA,EAEA,IAAO,IAAyB;AAC9B,WAAO,KAAK,YAAY,KAAK,UAAU,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE;AAAA,EAC/D;AAAA,EAEA,UAAU,UAAqC;AAC7C,QAAI,KAAK,SAAU,QAAO,MAAM;AAAA,IAAC;AACjC,WAAO,KAAK,YAAY,KAAK,UAAU,UAAU,QAAQ,IAAI,MAAM,UAAU,QAAQ;AAAA,EACvF;AAAA;AAAA;AAAA,EAKA,IAAI,QAAgC;AAClC,QAAI,CAAC,KAAK,aAAa;AACrB,YAAM,OAAO;AACb,WAAK,cAAc,IAAI,MAAM,IAA8B;AAAA,QACzD,IAAI,GAAG,MAAc;AACnB,iBAAO,KAAK,gBAAgB,IAAI,IAAI,KAAK;AAAA,QAC3C;AAAA,QACA,IAAI,GAAG,MAAc;AACnB,iBAAO,KAAK,gBAAgB,IAAI,IAAI;AAAA,QACtC;AAAA,QACA,UAAU;AACR,iBAAO,MAAM,KAAK,KAAK,gBAAgB,MAAM;AAAA,QAC/C;AAAA,QACA,yBAAyB,GAAG,MAAc;AACxC,cAAI,KAAK,gBAAgB,IAAI,IAAI,GAAG;AAClC,mBAAO,EAAE,cAAc,MAAM,YAAY,MAAM,OAAO,KAAK,gBAAgB,IAAI,IAAI,EAAA;AAAA,UACrF;AACA,iBAAO;AAAA,QACT;AAAA,MAAA,CACD;AAAA,IACH;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,eAAe,UAAkC;AAC/C,QAAI,KAAK,SAAU,QAAO,MAAM;AAAA,IAAC;AACjC,SAAK,gBAAgB,IAAI,QAAQ;AACjC,WAAO,MAAM;AAAE,WAAK,gBAAgB,OAAO,QAAQ;AAAA,IAAG;AAAA,EACxD;AAAA;AAAA,EAIQ,eAAqB;AAC3B,eAAW,YAAY,KAAK,iBAAiB;AAC3C,eAAA;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,qBAA2B;AACjC,uBAAmB,MAAM,SAAS,WAAW,CAAC,QAAQ;AACpD,UAAI,oBAAoB,SAAS,GAAU,GAAG;AAC5C,cAAM,IAAI;AAAA,UACR,cAAc,GAAG;AAAA,QAAA;AAAA,MAErB;AAAA,IACF,CAAC;AAAA,EACH;AAEF;"}
+{"version":3,"file":"Resource.js","sources":["../src/Resource.ts"],"sourcesContent":["import { Collection } from './Collection';\nimport { walkPrototypeChain } from './walkPrototypeChain';\nimport { wrapAsyncMethods } from './wrapAsyncMethods';\nimport type { InternalTaskState } from './wrapAsyncMethods';\nimport type { Listener, TaskState } from './types';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\n// ── Async tracking types ────────────────────────────────────────\n\nconst DEFAULT_TASK_STATE: TaskState = Object.freeze({ loading: false, error: null, errorCode: null });\n\nexport type ResourceAsyncMethodKeys<T> = {\n  [K in Exclude<keyof T, keyof Resource<any>>]: T[K] extends (...args: any[]) => Promise<any> ? K : never;\n}[Exclude<keyof T, keyof Resource<any>>];\n\ntype ResourceAsyncMap<T> = {\n  readonly [K in ResourceAsyncMethodKeys<T>]: TaskState;\n};\n\nconst RESERVED_ASYNC_KEYS = ['async', 'subscribeAsync'] as const;\nconst LIFECYCLE_HOOKS = new Set(['onInit', 'onDispose']);\n\n// ── Resource ────────────────────────────────────────────────────\n\n/**\n * Collection + async tracking toolkit. Extends Collection with lifecycle\n * (init/dispose) and automatic async method tracking. Optionally delegates\n * to an external Collection for shared data scenarios.\n */\nexport class Resource<T extends { id: string | number }> extends Collection<T> {\n  private _external: Collection<T> | null = null;\n  private _initialized = false;\n\n  // ── Async tracking fields ──\n  private _asyncStates = new Map<string, InternalTaskState>();\n  private _asyncSnapshots = new Map<string, TaskState>();\n  private _asyncListeners = new Set<() => void>();\n  private _asyncProxy: ResourceAsyncMap<this> | null = null;\n  private _activeOps: Map<string, number> | null = null;\n\n  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */\n  static GHOST_TIMEOUT = 3000;\n\n  constructor(collectionOrItems?: Collection<T> | T[]) {\n    const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);\n    super(isExternal ? [] : (collectionOrItems as T[]) ?? []);\n\n    if (isExternal) {\n      this._external = collectionOrItems as Collection<T>;\n\n      if (__DEV__) {\n        const Ctor = this.constructor as typeof Resource;\n        if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) {\n          console.warn(\n            `[mvc-kit] Resource \"${Ctor.name}\" has MAX_SIZE or TTL set but uses an ` +\n            `injected Collection. Configure these on the Collection instead.`\n          );\n        }\n      }\n    }\n\n    this._guardReservedKeys();\n  }\n\n  // ── Lifecycle ─────────────────────────────────────────────────\n\n  /** Whether init() has been called. */\n  get initialized(): boolean {\n    return this._initialized;\n  }\n\n  /** Initializes the instance. Called automatically by React hooks after mount. */\n  init(): void | Promise<void> {\n    if (this._initialized || this.disposed) return;\n    this._initialized = true;\n\n    if (__DEV__) {\n      this._activeOps = new Map();\n    }\n\n    wrapAsyncMethods({\n      instance: this,\n      stopPrototype: Resource.prototype,\n      reservedKeys: RESERVED_ASYNC_KEYS,\n      lifecycleHooks: LIFECYCLE_HOOKS,\n      isDisposed: () => this.disposed,\n      isInitialized: () => this._initialized,\n      asyncStates: this._asyncStates,\n      asyncSnapshots: this._asyncSnapshots,\n      asyncListeners: this._asyncListeners,\n      notifyAsync: () => this._notifyAsync(),\n      addCleanup: (fn) => this.addCleanup(fn),\n      ghostTimeout: (this.constructor as typeof Resource).GHOST_TIMEOUT,\n      className: 'Resource',\n      activeOps: this._activeOps,\n    });\n\n    return this.onInit?.();\n  }\n\n  /** Lifecycle hook called at the end of init(). Override to load initial data. @protected */\n  protected onInit?(): void | Promise<void>;\n\n  // ── Collection delegation ─────────────────────────────────────\n\n  /** Current items array. Delegates to external Collection when injected. */\n  get state(): T[] {\n    return this._external ? this._external.state : super.state;\n  }\n\n  /** The raw array of items. Delegates to external Collection when injected. */\n  get items(): T[] {\n    return this._external ? this._external.items : super.items;\n  }\n\n  /** Number of items. Delegates to external Collection when injected. */\n  get length(): number {\n    return this._external ? this._external.length : super.length;\n  }\n\n  add(...items: T[]): void {\n    this._external ? this._external.add(...items) : super.add(...items);\n  }\n\n  upsert(...items: T[]): void {\n    this._external ? this._external.upsert(...items) : super.upsert(...items);\n  }\n\n  update(id: T['id'], changes: Partial<T>): void {\n    this._external ? this._external.update(id, changes) : super.update(id, changes);\n  }\n\n  remove(...ids: T['id'][]): void {\n    this._external ? this._external.remove(...ids) : super.remove(...ids);\n  }\n\n  reset(items: T[]): void {\n    this._external ? this._external.reset(items) : super.reset(items);\n  }\n\n  clear(): void {\n    this._external ? this._external.clear() : super.clear();\n  }\n\n  optimistic(callback: () => void): () => void {\n    return this._external ? this._external.optimistic(callback) : super.optimistic(callback);\n  }\n\n  get(id: T['id']): T | undefined {\n    return this._external ? this._external.get(id) : super.get(id);\n  }\n\n  has(id: T['id']): boolean {\n    return this._external ? this._external.has(id) : super.has(id);\n  }\n\n  find(predicate: (item: T) => boolean): T | undefined {\n    return this._external ? this._external.find(predicate) : super.find(predicate);\n  }\n\n  filter(predicate: (item: T) => boolean): T[] {\n    return this._external ? this._external.filter(predicate) : super.filter(predicate);\n  }\n\n  sorted(compareFn: (a: T, b: T) => number): T[] {\n    return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);\n  }\n\n  map<U>(fn: (item: T) => U): U[] {\n    return this._external ? this._external.map(fn) : super.map(fn);\n  }\n\n  subscribe(listener: Listener<T[]>): () => void {\n    if (this.disposed) return () => {};\n    return this._external ? this._external.subscribe(listener) : super.subscribe(listener);\n  }\n\n  // ── Async tracking API ────────────────────────────────────────\n\n  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */\n  get async(): ResourceAsyncMap<this> {\n    if (!this._asyncProxy) {\n      const self = this;\n      this._asyncProxy = new Proxy({} as ResourceAsyncMap<this>, {\n        get(_, prop: string) {\n          return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;\n        },\n        has(_, prop: string) {\n          return self._asyncSnapshots.has(prop);\n        },\n        ownKeys() {\n          return Array.from(self._asyncSnapshots.keys());\n        },\n        getOwnPropertyDescriptor(_, prop: string) {\n          if (self._asyncSnapshots.has(prop)) {\n            return { configurable: true, enumerable: true, value: self._asyncSnapshots.get(prop) };\n          }\n          return undefined;\n        },\n      });\n    }\n    return this._asyncProxy;\n  }\n\n  /** Subscribes to async state changes. Used by `useInstance` for React integration. */\n  subscribeAsync(listener: () => void): () => void {\n    if (this.disposed) return () => {};\n    this._asyncListeners.add(listener);\n    return () => { this._asyncListeners.delete(listener); };\n  }\n\n  // ── Private: async tracking internals ─────────────────────────\n\n  private _notifyAsync(): void {\n    for (const listener of this._asyncListeners) {\n      listener();\n    }\n  }\n\n  private _guardReservedKeys(): void {\n    walkPrototypeChain(this, Resource.prototype, (key) => {\n      if (RESERVED_ASYNC_KEYS.includes(key as any)) {\n        throw new Error(\n          `[mvc-kit] \"${key}\" is a reserved property on Resource and cannot be overridden.`\n        );\n      }\n    });\n  }\n\n}\n"],"names":[],"mappings":"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"}

package/dist/Selection.cjs

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class Selection {
+  _selected = /* @__PURE__ */ new Set();
+  _listeners = /* @__PURE__ */ new Set();
+  _readonlyView = this._selected;
+  // ── Readable state ──
+  /** Read-only view of currently selected keys. */
+  get selected() {
+    return this._readonlyView;
+  }
+  /** Number of currently selected items. */
+  get count() {
+    return this._selected.size;
+  }
+  /** Whether any items are currently selected. */
+  get hasSelection() {
+    return this._selected.size > 0;
+  }
+  // ── Query ──
+  /** Check whether a specific key is selected. */
+  isSelected(key) {
+    return this._selected.has(key);
+  }
+  // ── Actions ──
+  /** Toggle a key's selection state (select if unselected, deselect if selected). */
+  toggle(key) {
+    if (this._selected.has(key)) {
+      this._selected.delete(key);
+    } else {
+      this._selected.add(key);
+    }
+    this._publish();
+  }
+  /** Add one or more keys to the selection. */
+  select(...keys) {
+    let changed = false;
+    for (const key of keys) {
+      if (!this._selected.has(key)) {
+        this._selected.add(key);
+        changed = true;
+      }
+    }
+    if (changed) this._publish();
+  }
+  /** Remove one or more keys from the selection. */
+  deselect(...keys) {
+    let changed = false;
+    for (const key of keys) {
+      if (this._selected.has(key)) {
+        this._selected.delete(key);
+        changed = true;
+      }
+    }
+    if (changed) this._publish();
+  }
+  /** If all selected → deselect all, else select all. */
+  toggleAll(allKeys) {
+    const allSelected = allKeys.length > 0 && allKeys.every((k) => this._selected.has(k));
+    if (allSelected) {
+      this._selected.clear();
+    } else {
+      for (const key of allKeys) this._selected.add(key);
+    }
+    this._publish();
+  }
+  /** Replace the entire selection atomically. Single notification. */
+  set(...keys) {
+    if (keys.length === this._selected.size && keys.every((k) => this._selected.has(k))) return;
+    this._selected.clear();
+    for (const key of keys) this._selected.add(key);
+    this._publish();
+  }
+  /** Remove all items from the selection. */
+  clear() {
+    if (this._selected.size === 0) return;
+    this._selected.clear();
+    this._publish();
+  }
+  // ── Utility ──
+  /** Filter an array to only items whose key is in the selection. */
+  selectedFrom(items, keyOf) {
+    return items.filter((item) => this._selected.has(keyOf(item)));
+  }
+  // ── Subscribable interface ──
+  /** Subscribe to selection changes. Returns an unsubscribe function. */
+  subscribe(cb) {
+    this._listeners.add(cb);
+    return () => {
+      this._listeners.delete(cb);
+    };
+  }
+  _publish() {
+    this._readonlyView = new Set(this._selected);
+    for (const cb of this._listeners) cb();
+  }
+}
+exports.Selection = Selection;
+//# sourceMappingURL=Selection.cjs.map

package/dist/Selection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Selection.cjs","sources":["../src/Selection.ts"],"sourcesContent":["/**\n * Key-based selection set with toggle and select-all support.\n * Tracks which items are selected by their key (id).\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Selection<K extends string | number = string | number> {\n  private _selected: Set<K> = new Set();\n  private _listeners = new Set<() => void>();\n  private _readonlyView: ReadonlySet<K> = this._selected;\n\n  // ── Readable state ──\n\n  /** Read-only view of currently selected keys. */\n  get selected(): ReadonlySet<K> {\n    return this._readonlyView;\n  }\n\n  /** Number of currently selected items. */\n  get count(): number {\n    return this._selected.size;\n  }\n\n  /** Whether any items are currently selected. */\n  get hasSelection(): boolean {\n    return this._selected.size > 0;\n  }\n\n  // ── Query ──\n\n  /** Check whether a specific key is selected. */\n  isSelected(key: K): boolean {\n    return this._selected.has(key);\n  }\n\n  // ── Actions ──\n\n  /** Toggle a key's selection state (select if unselected, deselect if selected). */\n  toggle(key: K): void {\n    if (this._selected.has(key)) {\n      this._selected.delete(key);\n    } else {\n      this._selected.add(key);\n    }\n    this._publish();\n  }\n\n  /** Add one or more keys to the selection. */\n  select(...keys: K[]): void {\n    let changed = false;\n    for (const key of keys) {\n      if (!this._selected.has(key)) {\n        this._selected.add(key);\n        changed = true;\n      }\n    }\n    if (changed) this._publish();\n  }\n\n  /** Remove one or more keys from the selection. */\n  deselect(...keys: K[]): void {\n    let changed = false;\n    for (const key of keys) {\n      if (this._selected.has(key)) {\n        this._selected.delete(key);\n        changed = true;\n      }\n    }\n    if (changed) this._publish();\n  }\n\n  /** If all selected → deselect all, else select all. */\n  toggleAll(allKeys: K[]): void {\n    const allSelected = allKeys.length > 0 && allKeys.every(k => this._selected.has(k));\n    if (allSelected) {\n      this._selected.clear();\n    } else {\n      for (const key of allKeys) this._selected.add(key);\n    }\n    this._publish();\n  }\n\n  /** Replace the entire selection atomically. Single notification. */\n  set(...keys: K[]): void {\n    // Check if anything actually changed\n    if (keys.length === this._selected.size && keys.every(k => this._selected.has(k))) return;\n    this._selected.clear();\n    for (const key of keys) this._selected.add(key);\n    this._publish();\n  }\n\n  /** Remove all items from the selection. */\n  clear(): void {\n    if (this._selected.size === 0) return;\n    this._selected.clear();\n    this._publish();\n  }\n\n  // ── Utility ──\n\n  /** Filter an array to only items whose key is in the selection. */\n  selectedFrom<T>(items: T[], keyOf: (item: T) => K): T[] {\n    return items.filter(item => this._selected.has(keyOf(item)));\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribe to selection changes. Returns an unsubscribe function. */\n  subscribe(cb: () => void): () => void {\n    this._listeners.add(cb);\n    return () => { this._listeners.delete(cb); };\n  }\n\n  private _publish(): void {\n    // Replace readonlyView so reference equality changes (needed for React)\n    this._readonlyView = new Set(this._selected);\n    for (const cb of this._listeners) cb();\n  }\n}\n"],"names":[],"mappings":";;AAKO,MAAM,UAAuD;AAAA,EAC1D,gCAAwB,IAAA;AAAA,EACxB,iCAAiB,IAAA;AAAA,EACjB,gBAAgC,KAAK;AAAA;AAAA;AAAA,EAK7C,IAAI,WAA2B;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA;AAAA,EAGA,IAAI,eAAwB;AAC1B,WAAO,KAAK,UAAU,OAAO;AAAA,EAC/B;AAAA;AAAA;AAAA,EAKA,WAAW,KAAiB;AAC1B,WAAO,KAAK,UAAU,IAAI,GAAG;AAAA,EAC/B;AAAA;AAAA;AAAA,EAKA,OAAO,KAAc;AACnB,QAAI,KAAK,UAAU,IAAI,GAAG,GAAG;AAC3B,WAAK,UAAU,OAAO,GAAG;AAAA,IAC3B,OAAO;AACL,WAAK,UAAU,IAAI,GAAG;AAAA,IACxB;AACA,SAAK,SAAA;AAAA,EACP;AAAA;AAAA,EAGA,UAAU,MAAiB;AACzB,QAAI,UAAU;AACd,eAAW,OAAO,MAAM;AACtB,UAAI,CAAC,KAAK,UAAU,IAAI,GAAG,GAAG;AAC5B,aAAK,UAAU,IAAI,GAAG;AACtB,kBAAU;AAAA,MACZ;AAAA,IACF;AACA,QAAI,cAAc,SAAA;AAAA,EACpB;AAAA;AAAA,EAGA,YAAY,MAAiB;AAC3B,QAAI,UAAU;AACd,eAAW,OAAO,MAAM;AACtB,UAAI,KAAK,UAAU,IAAI,GAAG,GAAG;AAC3B,aAAK,UAAU,OAAO,GAAG;AACzB,kBAAU;AAAA,MACZ;AAAA,IACF;AACA,QAAI,cAAc,SAAA;AAAA,EACpB;AAAA;AAAA,EAGA,UAAU,SAAoB;AAC5B,UAAM,cAAc,QAAQ,SAAS,KAAK,QAAQ,MAAM,CAAA,MAAK,KAAK,UAAU,IAAI,CAAC,CAAC;AAClF,QAAI,aAAa;AACf,WAAK,UAAU,MAAA;AAAA,IACjB,OAAO;AACL,iBAAW,OAAO,QAAS,MAAK,UAAU,IAAI,GAAG;AAAA,IACnD;AACA,SAAK,SAAA;AAAA,EACP;AAAA;AAAA,EAGA,OAAO,MAAiB;AAEtB,QAAI,KAAK,WAAW,KAAK,UAAU,QAAQ,KAAK,MAAM,CAAA,MAAK,KAAK,UAAU,IAAI,CAAC,CAAC,EAAG;AACnF,SAAK,UAAU,MAAA;AACf,eAAW,OAAO,KAAM,MAAK,UAAU,IAAI,GAAG;AAC9C,SAAK,SAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAc;AACZ,QAAI,KAAK,UAAU,SAAS,EAAG;AAC/B,SAAK,UAAU,MAAA;AACf,SAAK,SAAA;AAAA,EACP;AAAA;AAAA;AAAA,EAKA,aAAgB,OAAY,OAA4B;AACtD,WAAO,MAAM,OAAO,CAAA,SAAQ,KAAK,UAAU,IAAI,MAAM,IAAI,CAAC,CAAC;AAAA,EAC7D;AAAA;AAAA;AAAA,EAKA,UAAU,IAA4B;AACpC,SAAK,WAAW,IAAI,EAAE;AACtB,WAAO,MAAM;AAAE,WAAK,WAAW,OAAO,EAAE;AAAA,IAAG;AAAA,EAC7C;AAAA,EAEQ,WAAiB;AAEvB,SAAK,gBAAgB,IAAI,IAAI,KAAK,SAAS;AAC3C,eAAW,MAAM,KAAK,WAAY,IAAA;AAAA,EACpC;AACF;;"}

package/dist/Selection.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Key-based selection set with toggle and select-all support.
+ * Tracks which items are selected by their key (id).
+ * Subscribable — auto-tracked when used as a ViewModel property.
+ */
+export declare class Selection<K extends string | number = string | number> {
+    private _selected;
+    private _listeners;
+    private _readonlyView;
+    /** Read-only view of currently selected keys. */
+    get selected(): ReadonlySet<K>;
+    /** Number of currently selected items. */
+    get count(): number;
+    /** Whether any items are currently selected. */
+    get hasSelection(): boolean;
+    /** Check whether a specific key is selected. */
+    isSelected(key: K): boolean;
+    /** Toggle a key's selection state (select if unselected, deselect if selected). */
+    toggle(key: K): void;
+    /** Add one or more keys to the selection. */
+    select(...keys: K[]): void;
+    /** Remove one or more keys from the selection. */
+    deselect(...keys: K[]): void;
+    /** If all selected → deselect all, else select all. */
+    toggleAll(allKeys: K[]): void;
+    /** Replace the entire selection atomically. Single notification. */
+    set(...keys: K[]): void;
+    /** Remove all items from the selection. */
+    clear(): void;
+    /** Filter an array to only items whose key is in the selection. */
+    selectedFrom<T>(items: T[], keyOf: (item: T) => K): T[];
+    /** Subscribe to selection changes. Returns an unsubscribe function. */
+    subscribe(cb: () => void): () => void;
+    private _publish;
+}
+//# sourceMappingURL=Selection.d.ts.map

package/dist/Selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Selection.d.ts","sourceRoot":"","sources":["../src/Selection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAChE,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,aAAa,CAAkC;IAIvD,iDAAiD;IACjD,IAAI,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,CAE7B;IAED,0CAA0C;IAC1C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,gDAAgD;IAChD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAID,gDAAgD;IAChD,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAM3B,mFAAmF;IACnF,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IASpB,6CAA6C;IAC7C,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IAW1B,kDAAkD;IAClD,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IAW5B,uDAAuD;IACvD,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI;IAU7B,oEAAoE;IACpE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IAQvB,2CAA2C;IAC3C,KAAK,IAAI,IAAI;IAQb,mEAAmE;IACnE,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IAMvD,uEAAuE;IACvE,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKrC,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/Selection.js

@@ -0,0 +1,99 @@
+class Selection {
+  _selected = /* @__PURE__ */ new Set();
+  _listeners = /* @__PURE__ */ new Set();
+  _readonlyView = this._selected;
+  // ── Readable state ──
+  /** Read-only view of currently selected keys. */
+  get selected() {
+    return this._readonlyView;
+  }
+  /** Number of currently selected items. */
+  get count() {
+    return this._selected.size;
+  }
+  /** Whether any items are currently selected. */
+  get hasSelection() {
+    return this._selected.size > 0;
+  }
+  // ── Query ──
+  /** Check whether a specific key is selected. */
+  isSelected(key) {
+    return this._selected.has(key);
+  }
+  // ── Actions ──
+  /** Toggle a key's selection state (select if unselected, deselect if selected). */
+  toggle(key) {
+    if (this._selected.has(key)) {
+      this._selected.delete(key);
+    } else {
+      this._selected.add(key);
+    }
+    this._publish();
+  }
+  /** Add one or more keys to the selection. */
+  select(...keys) {
+    let changed = false;
+    for (const key of keys) {
+      if (!this._selected.has(key)) {
+        this._selected.add(key);
+        changed = true;
+      }
+    }
+    if (changed) this._publish();
+  }
+  /** Remove one or more keys from the selection. */
+  deselect(...keys) {
+    let changed = false;
+    for (const key of keys) {
+      if (this._selected.has(key)) {
+        this._selected.delete(key);
+        changed = true;
+      }
+    }
+    if (changed) this._publish();
+  }
+  /** If all selected → deselect all, else select all. */
+  toggleAll(allKeys) {
+    const allSelected = allKeys.length > 0 && allKeys.every((k) => this._selected.has(k));
+    if (allSelected) {
+      this._selected.clear();
+    } else {
+      for (const key of allKeys) this._selected.add(key);
+    }
+    this._publish();
+  }
+  /** Replace the entire selection atomically. Single notification. */
+  set(...keys) {
+    if (keys.length === this._selected.size && keys.every((k) => this._selected.has(k))) return;
+    this._selected.clear();
+    for (const key of keys) this._selected.add(key);
+    this._publish();
+  }
+  /** Remove all items from the selection. */
+  clear() {
+    if (this._selected.size === 0) return;
+    this._selected.clear();
+    this._publish();
+  }
+  // ── Utility ──
+  /** Filter an array to only items whose key is in the selection. */
+  selectedFrom(items, keyOf) {
+    return items.filter((item) => this._selected.has(keyOf(item)));
+  }
+  // ── Subscribable interface ──
+  /** Subscribe to selection changes. Returns an unsubscribe function. */
+  subscribe(cb) {
+    this._listeners.add(cb);
+    return () => {
+      this._listeners.delete(cb);
+    };
+  }
+  _publish() {
+    this._readonlyView = new Set(this._selected);
+    for (const cb of this._listeners) cb();
+  }
+}
+export {
+  Selection
+};
+//# sourceMappingURL=Selection.js.map

package/dist/Selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Selection.js","sources":["../src/Selection.ts"],"sourcesContent":["/**\n * Key-based selection set with toggle and select-all support.\n * Tracks which items are selected by their key (id).\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Selection<K extends string | number = string | number> {\n  private _selected: Set<K> = new Set();\n  private _listeners = new Set<() => void>();\n  private _readonlyView: ReadonlySet<K> = this._selected;\n\n  // ── Readable state ──\n\n  /** Read-only view of currently selected keys. */\n  get selected(): ReadonlySet<K> {\n    return this._readonlyView;\n  }\n\n  /** Number of currently selected items. */\n  get count(): number {\n    return this._selected.size;\n  }\n\n  /** Whether any items are currently selected. */\n  get hasSelection(): boolean {\n    return this._selected.size > 0;\n  }\n\n  // ── Query ──\n\n  /** Check whether a specific key is selected. */\n  isSelected(key: K): boolean {\n    return this._selected.has(key);\n  }\n\n  // ── Actions ──\n\n  /** Toggle a key's selection state (select if unselected, deselect if selected). */\n  toggle(key: K): void {\n    if (this._selected.has(key)) {\n      this._selected.delete(key);\n    } else {\n      this._selected.add(key);\n    }\n    this._publish();\n  }\n\n  /** Add one or more keys to the selection. */\n  select(...keys: K[]): void {\n    let changed = false;\n    for (const key of keys) {\n      if (!this._selected.has(key)) {\n        this._selected.add(key);\n        changed = true;\n      }\n    }\n    if (changed) this._publish();\n  }\n\n  /** Remove one or more keys from the selection. */\n  deselect(...keys: K[]): void {\n    let changed = false;\n    for (const key of keys) {\n      if (this._selected.has(key)) {\n        this._selected.delete(key);\n        changed = true;\n      }\n    }\n    if (changed) this._publish();\n  }\n\n  /** If all selected → deselect all, else select all. */\n  toggleAll(allKeys: K[]): void {\n    const allSelected = allKeys.length > 0 && allKeys.every(k => this._selected.has(k));\n    if (allSelected) {\n      this._selected.clear();\n    } else {\n      for (const key of allKeys) this._selected.add(key);\n    }\n    this._publish();\n  }\n\n  /** Replace the entire selection atomically. Single notification. */\n  set(...keys: K[]): void {\n    // Check if anything actually changed\n    if (keys.length === this._selected.size && keys.every(k => this._selected.has(k))) return;\n    this._selected.clear();\n    for (const key of keys) this._selected.add(key);\n    this._publish();\n  }\n\n  /** Remove all items from the selection. */\n  clear(): void {\n    if (this._selected.size === 0) return;\n    this._selected.clear();\n    this._publish();\n  }\n\n  // ── Utility ──\n\n  /** Filter an array to only items whose key is in the selection. */\n  selectedFrom<T>(items: T[], keyOf: (item: T) => K): T[] {\n    return items.filter(item => this._selected.has(keyOf(item)));\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribe to selection changes. Returns an unsubscribe function. */\n  subscribe(cb: () => void): () => void {\n    this._listeners.add(cb);\n    return () => { this._listeners.delete(cb); };\n  }\n\n  private _publish(): void {\n    // Replace readonlyView so reference equality changes (needed for React)\n    this._readonlyView = new Set(this._selected);\n    for (const cb of this._listeners) cb();\n  }\n}\n"],"names":[],"mappings":"AAKO,MAAM,UAAuD;AAAA,EAC1D,gCAAwB,IAAA;AAAA,EACxB,iCAAiB,IAAA;AAAA,EACjB,gBAAgC,KAAK;AAAA;AAAA;AAAA,EAK7C,IAAI,WAA2B;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA;AAAA,EAGA,IAAI,eAAwB;AAC1B,WAAO,KAAK,UAAU,OAAO;AAAA,EAC/B;AAAA;AAAA;AAAA,EAKA,WAAW,KAAiB;AAC1B,WAAO,KAAK,UAAU,IAAI,GAAG;AAAA,EAC/B;AAAA;AAAA;AAAA,EAKA,OAAO,KAAc;AACnB,QAAI,KAAK,UAAU,IAAI,GAAG,GAAG;AAC3B,WAAK,UAAU,OAAO,GAAG;AAAA,IAC3B,OAAO;AACL,WAAK,UAAU,IAAI,GAAG;AAAA,IACxB;AACA,SAAK,SAAA;AAAA,EACP;AAAA;AAAA,EAGA,UAAU,MAAiB;AACzB,QAAI,UAAU;AACd,eAAW,OAAO,MAAM;AACtB,UAAI,CAAC,KAAK,UAAU,IAAI,GAAG,GAAG;AAC5B,aAAK,UAAU,IAAI,GAAG;AACtB,kBAAU;AAAA,MACZ;AAAA,IACF;AACA,QAAI,cAAc,SAAA;AAAA,EACpB;AAAA;AAAA,EAGA,YAAY,MAAiB;AAC3B,QAAI,UAAU;AACd,eAAW,OAAO,MAAM;AACtB,UAAI,KAAK,UAAU,IAAI,GAAG,GAAG;AAC3B,aAAK,UAAU,OAAO,GAAG;AACzB,kBAAU;AAAA,MACZ;AAAA,IACF;AACA,QAAI,cAAc,SAAA;AAAA,EACpB;AAAA;AAAA,EAGA,UAAU,SAAoB;AAC5B,UAAM,cAAc,QAAQ,SAAS,KAAK,QAAQ,MAAM,CAAA,MAAK,KAAK,UAAU,IAAI,CAAC,CAAC;AAClF,QAAI,aAAa;AACf,WAAK,UAAU,MAAA;AAAA,IACjB,OAAO;AACL,iBAAW,OAAO,QAAS,MAAK,UAAU,IAAI,GAAG;AAAA,IACnD;AACA,SAAK,SAAA;AAAA,EACP;AAAA;AAAA,EAGA,OAAO,MAAiB;AAEtB,QAAI,KAAK,WAAW,KAAK,UAAU,QAAQ,KAAK,MAAM,CAAA,MAAK,KAAK,UAAU,IAAI,CAAC,CAAC,EAAG;AACnF,SAAK,UAAU,MAAA;AACf,eAAW,OAAO,KAAM,MAAK,UAAU,IAAI,GAAG;AAC9C,SAAK,SAAA;AAAA,EACP;AAAA;AAAA,EAGA,QAAc;AACZ,QAAI,KAAK,UAAU,SAAS,EAAG;AAC/B,SAAK,UAAU,MAAA;AACf,SAAK,SAAA;AAAA,EACP;AAAA;AAAA;AAAA,EAKA,aAAgB,OAAY,OAA4B;AACtD,WAAO,MAAM,OAAO,CAAA,SAAQ,KAAK,UAAU,IAAI,MAAM,IAAI,CAAC,CAAC;AAAA,EAC7D;AAAA;AAAA;AAAA,EAKA,UAAU,IAA4B;AACpC,SAAK,WAAW,IAAI,EAAE;AACtB,WAAO,MAAM;AAAE,WAAK,WAAW,OAAO,EAAE;AAAA,IAAG;AAAA,EAC7C;AAAA,EAEQ,WAAiB;AAEvB,SAAK,gBAAgB,IAAI,IAAI,KAAK,SAAS;AAC3C,eAAW,MAAM,KAAK,WAAY,IAAA;AAAA,EACpC;AACF;"}

package/dist/Sorting.cjs

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class Sorting {
+  _sorts;
+  _listeners = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this._sorts = Object.freeze(options?.sorts?.map((s) => ({ ...s })) ?? []);
+  }
+  // ── Readable state ──
+  /** Current list of active sort descriptors, in priority order. */
+  get sorts() {
+    return this._sorts;
+  }
+  /** Primary sort key (first descriptor), or null when empty. */
+  get key() {
+    return this._sorts.length > 0 ? this._sorts[0].key : null;
+  }
+  /** Primary sort direction. Defaults to 'asc' when empty. */
+  get direction() {
+    return this._sorts.length > 0 ? this._sorts[0].direction : "asc";
+  }
+  // ── Query ──
+  /** Whether the given key is currently sorted. */
+  isSorted(key) {
+    return this._sorts.some((s) => s.key === key);
+  }
+  /** Returns the sort direction for a key, or null if not sorted. */
+  directionOf(key) {
+    const found = this._sorts.find((s) => s.key === key);
+    return found ? found.direction : null;
+  }
+  /** Returns the priority index of a sorted key, or -1 if not sorted. */
+  indexOf(key) {
+    return this._sorts.findIndex((s) => s.key === key);
+  }
+  // ── Actions ──
+  /** 3-click cycle: not sorted → asc → desc → removed. */
+  toggle(key) {
+    const idx = this.indexOf(key);
+    if (idx === -1) {
+      this._sorts = Object.freeze([...this._sorts, { key, direction: "asc" }]);
+    } else if (this._sorts[idx].direction === "asc") {
+      const next = this._sorts.map(
+        (s, i) => i === idx ? { key: s.key, direction: "desc" } : s
+      );
+      this._sorts = Object.freeze(next);
+    } else {
+      this._sorts = Object.freeze(this._sorts.filter((_, i) => i !== idx));
+    }
+    this._notify();
+  }
+  /** Replace all with a single sort. */
+  setSort(key, direction) {
+    this._sorts = Object.freeze([{ key, direction }]);
+    this._notify();
+  }
+  /** Replace all sorts. */
+  setSorts(sorts) {
+    this._sorts = Object.freeze(sorts.map((s) => ({ ...s })));
+    this._notify();
+  }
+  /** Clear all sort descriptors. */
+  reset() {
+    this._sorts = Object.freeze([]);
+    this._notify();
+  }
+  // ── Pipeline ──
+  /** Sort an array using the current descriptors. Returns a new sorted array. */
+  apply(items, compareFn) {
+    if (this._sorts.length === 0) return items;
+    const sorted = items.slice();
+    const sorts = this._sorts;
+    sorted.sort((a, b) => {
+      for (const { key, direction } of sorts) {
+        let cmp;
+        if (compareFn) {
+          cmp = compareFn(a, b, key, direction);
+        } else {
+          cmp = defaultCompare(a, b, key);
+        }
+        if (direction === "desc") cmp = -cmp;
+        if (cmp !== 0) return cmp;
+      }
+      return 0;
+    });
+    return sorted;
+  }
+  // ── Subscribable interface ──
+  /** Subscribe to sort state changes. Returns an unsubscribe function. */
+  subscribe(cb) {
+    this._listeners.add(cb);
+    return () => {
+      this._listeners.delete(cb);
+    };
+  }
+  _notify() {
+    for (const cb of this._listeners) cb();
+  }
+}
+function defaultCompare(a, b, key) {
+  const aVal = a[key];
+  const bVal = b[key];
+  if (aVal == null && bVal == null) return 0;
+  if (aVal == null) return -1;
+  if (bVal == null) return 1;
+  if (typeof aVal === "string" && typeof bVal === "string") {
+    return aVal.localeCompare(bVal);
+  }
+  if (aVal < bVal) return -1;
+  if (aVal > bVal) return 1;
+  return 0;
+}
+exports.Sorting = Sorting;
+//# sourceMappingURL=Sorting.cjs.map

package/dist/Sorting.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sorting.cjs","sources":["../src/Sorting.ts"],"sourcesContent":["/** Describes a single sort column with key and direction. */\nexport interface SortDescriptor {\n  key: string;\n  direction: 'asc' | 'desc';\n}\n\n/**\n * Multi-column sort state manager with a comparator pipeline.\n * Maintains an ordered list of sort descriptors and applies them to arrays.\n * Subscribable — auto-tracked when used as a ViewModel property.\n */\nexport class Sorting<T = any> {\n  private _sorts: readonly SortDescriptor[];\n  private _listeners = new Set<() => void>();\n\n  constructor(options?: { sorts?: SortDescriptor[] }) {\n    this._sorts = Object.freeze(options?.sorts?.map(s => ({ ...s })) ?? []);\n  }\n\n  // ── Readable state ──\n\n  /** Current list of active sort descriptors, in priority order. */\n  get sorts(): readonly SortDescriptor[] {\n    return this._sorts;\n  }\n\n  /** Primary sort key (first descriptor), or null when empty. */\n  get key(): string | null {\n    return this._sorts.length > 0 ? this._sorts[0].key : null;\n  }\n\n  /** Primary sort direction. Defaults to 'asc' when empty. */\n  get direction(): 'asc' | 'desc' {\n    return this._sorts.length > 0 ? this._sorts[0].direction : 'asc';\n  }\n\n  // ── Query ──\n\n  /** Whether the given key is currently sorted. */\n  isSorted(key: string): boolean {\n    return this._sorts.some(s => s.key === key);\n  }\n\n  /** Returns the sort direction for a key, or null if not sorted. */\n  directionOf(key: string): 'asc' | 'desc' | null {\n    const found = this._sorts.find(s => s.key === key);\n    return found ? found.direction : null;\n  }\n\n  /** Returns the priority index of a sorted key, or -1 if not sorted. */\n  indexOf(key: string): number {\n    return this._sorts.findIndex(s => s.key === key);\n  }\n\n  // ── Actions ──\n\n  /** 3-click cycle: not sorted → asc → desc → removed. */\n  toggle(key: string): void {\n    const idx = this.indexOf(key);\n    if (idx === -1) {\n      // Add as asc\n      this._sorts = Object.freeze([...this._sorts, { key, direction: 'asc' as const }]);\n    } else if (this._sorts[idx].direction === 'asc') {\n      // Flip to desc\n      const next = this._sorts.map((s, i) =>\n        i === idx ? { key: s.key, direction: 'desc' as const } : s\n      );\n      this._sorts = Object.freeze(next);\n    } else {\n      // Remove\n      this._sorts = Object.freeze(this._sorts.filter((_, i) => i !== idx));\n    }\n    this._notify();\n  }\n\n  /** Replace all with a single sort. */\n  setSort(key: string, direction: 'asc' | 'desc'): void {\n    this._sorts = Object.freeze([{ key, direction }]);\n    this._notify();\n  }\n\n  /** Replace all sorts. */\n  setSorts(sorts: SortDescriptor[]): void {\n    this._sorts = Object.freeze(sorts.map(s => ({ ...s })));\n    this._notify();\n  }\n\n  /** Clear all sort descriptors. */\n  reset(): void {\n    this._sorts = Object.freeze([]);\n    this._notify();\n  }\n\n  // ── Pipeline ──\n\n  /** Sort an array using the current descriptors. Returns a new sorted array. */\n  apply(\n    items: T[],\n    compareFn?: (a: T, b: T, key: string, dir: 'asc' | 'desc') => number,\n  ): T[] {\n    if (this._sorts.length === 0) return items;\n    const sorted = items.slice();\n    const sorts = this._sorts;\n    sorted.sort((a, b) => {\n      for (const { key, direction } of sorts) {\n        let cmp: number;\n        if (compareFn) {\n          cmp = compareFn(a, b, key, direction);\n        } else {\n          cmp = defaultCompare(a, b, key);\n        }\n        if (direction === 'desc') cmp = -cmp;\n        if (cmp !== 0) return cmp;\n      }\n      return 0;\n    });\n    return sorted;\n  }\n\n  // ── Subscribable interface ──\n\n  /** Subscribe to sort state changes. Returns an unsubscribe function. */\n  subscribe(cb: () => void): () => void {\n    this._listeners.add(cb);\n    return () => { this._listeners.delete(cb); };\n  }\n\n  private _notify(): void {\n    for (const cb of this._listeners) cb();\n  }\n}\n\nfunction defaultCompare(a: any, b: any, key: string): number {\n  const aVal = a[key];\n  const bVal = b[key];\n  if (aVal == null && bVal == null) return 0;\n  if (aVal == null) return -1;\n  if (bVal == null) return 1;\n  if (typeof aVal === 'string' && typeof bVal === 'string') {\n    return aVal.localeCompare(bVal);\n  }\n  if (aVal < bVal) return -1;\n  if (aVal > bVal) return 1;\n  return 0;\n}\n"],"names":[],"mappings":"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"}

package/dist/Sorting.d.ts

@@ -0,0 +1,43 @@
+/** Describes a single sort column with key and direction. */
+export interface SortDescriptor {
+    key: string;
+    direction: 'asc' | 'desc';
+}
+/**
+ * Multi-column sort state manager with a comparator pipeline.
+ * Maintains an ordered list of sort descriptors and applies them to arrays.
+ * Subscribable — auto-tracked when used as a ViewModel property.
+ */
+export declare class Sorting<T = any> {
+    private _sorts;
+    private _listeners;
+    constructor(options?: {
+        sorts?: SortDescriptor[];
+    });
+    /** Current list of active sort descriptors, in priority order. */
+    get sorts(): readonly SortDescriptor[];
+    /** Primary sort key (first descriptor), or null when empty. */
+    get key(): string | null;
+    /** Primary sort direction. Defaults to 'asc' when empty. */
+    get direction(): 'asc' | 'desc';
+    /** Whether the given key is currently sorted. */
+    isSorted(key: string): boolean;
+    /** Returns the sort direction for a key, or null if not sorted. */
+    directionOf(key: string): 'asc' | 'desc' | null;
+    /** Returns the priority index of a sorted key, or -1 if not sorted. */
+    indexOf(key: string): number;
+    /** 3-click cycle: not sorted → asc → desc → removed. */
+    toggle(key: string): void;
+    /** Replace all with a single sort. */
+    setSort(key: string, direction: 'asc' | 'desc'): void;
+    /** Replace all sorts. */
+    setSorts(sorts: SortDescriptor[]): void;
+    /** Clear all sort descriptors. */
+    reset(): void;
+    /** Sort an array using the current descriptors. Returns a new sorted array. */
+    apply(items: T[], compareFn?: (a: T, b: T, key: string, dir: 'asc' | 'desc') => number): T[];
+    /** Subscribe to sort state changes. Returns an unsubscribe function. */
+    subscribe(cb: () => void): () => void;
+    private _notify;
+}
+//# sourceMappingURL=Sorting.d.ts.map

package/dist/Sorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sorting.d.ts","sourceRoot":"","sources":["../src/Sorting.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,GAAG;IAC1B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAyB;gBAE/B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE;IAMlD,kEAAkE;IAClE,IAAI,KAAK,IAAI,SAAS,cAAc,EAAE,CAErC;IAED,+DAA+D;IAC/D,IAAI,GAAG,IAAI,MAAM,GAAG,IAAI,CAEvB;IAED,4DAA4D;IAC5D,IAAI,SAAS,IAAI,KAAK,GAAG,MAAM,CAE9B;IAID,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI9B,mEAAmE;IACnE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI;IAK/C,uEAAuE;IACvE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAM5B,wDAAwD;IACxD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAkBzB,sCAAsC;IACtC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAKrD,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAKvC,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAOb,+EAA+E;IAC/E,KAAK,CACH,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,MAAM,KAAK,MAAM,GACnE,CAAC,EAAE;IAsBN,wEAAwE;IACxE,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKrC,OAAO,CAAC,OAAO;CAGhB"}

package/dist/Sorting.js

@@ -0,0 +1,114 @@
+class Sorting {
+  _sorts;
+  _listeners = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this._sorts = Object.freeze(options?.sorts?.map((s) => ({ ...s })) ?? []);
+  }
+  // ── Readable state ──
+  /** Current list of active sort descriptors, in priority order. */
+  get sorts() {
+    return this._sorts;
+  }
+  /** Primary sort key (first descriptor), or null when empty. */
+  get key() {
+    return this._sorts.length > 0 ? this._sorts[0].key : null;
+  }
+  /** Primary sort direction. Defaults to 'asc' when empty. */
+  get direction() {
+    return this._sorts.length > 0 ? this._sorts[0].direction : "asc";
+  }
+  // ── Query ──
+  /** Whether the given key is currently sorted. */
+  isSorted(key) {
+    return this._sorts.some((s) => s.key === key);
+  }
+  /** Returns the sort direction for a key, or null if not sorted. */
+  directionOf(key) {
+    const found = this._sorts.find((s) => s.key === key);
+    return found ? found.direction : null;
+  }
+  /** Returns the priority index of a sorted key, or -1 if not sorted. */
+  indexOf(key) {
+    return this._sorts.findIndex((s) => s.key === key);
+  }
+  // ── Actions ──
+  /** 3-click cycle: not sorted → asc → desc → removed. */
+  toggle(key) {
+    const idx = this.indexOf(key);
+    if (idx === -1) {
+      this._sorts = Object.freeze([...this._sorts, { key, direction: "asc" }]);
+    } else if (this._sorts[idx].direction === "asc") {
+      const next = this._sorts.map(
+        (s, i) => i === idx ? { key: s.key, direction: "desc" } : s
+      );
+      this._sorts = Object.freeze(next);
+    } else {
+      this._sorts = Object.freeze(this._sorts.filter((_, i) => i !== idx));
+    }
+    this._notify();
+  }
+  /** Replace all with a single sort. */
+  setSort(key, direction) {
+    this._sorts = Object.freeze([{ key, direction }]);
+    this._notify();
+  }
+  /** Replace all sorts. */
+  setSorts(sorts) {
+    this._sorts = Object.freeze(sorts.map((s) => ({ ...s })));
+    this._notify();
+  }
+  /** Clear all sort descriptors. */
+  reset() {
+    this._sorts = Object.freeze([]);
+    this._notify();
+  }
+  // ── Pipeline ──
+  /** Sort an array using the current descriptors. Returns a new sorted array. */
+  apply(items, compareFn) {
+    if (this._sorts.length === 0) return items;
+    const sorted = items.slice();
+    const sorts = this._sorts;
+    sorted.sort((a, b) => {
+      for (const { key, direction } of sorts) {
+        let cmp;
+        if (compareFn) {
+          cmp = compareFn(a, b, key, direction);
+        } else {
+          cmp = defaultCompare(a, b, key);
+        }
+        if (direction === "desc") cmp = -cmp;
+        if (cmp !== 0) return cmp;
+      }
+      return 0;
+    });
+    return sorted;
+  }
+  // ── Subscribable interface ──
+  /** Subscribe to sort state changes. Returns an unsubscribe function. */
+  subscribe(cb) {
+    this._listeners.add(cb);
+    return () => {
+      this._listeners.delete(cb);
+    };
+  }
+  _notify() {
+    for (const cb of this._listeners) cb();
+  }
+}
+function defaultCompare(a, b, key) {
+  const aVal = a[key];
+  const bVal = b[key];
+  if (aVal == null && bVal == null) return 0;
+  if (aVal == null) return -1;
+  if (bVal == null) return 1;
+  if (typeof aVal === "string" && typeof bVal === "string") {
+    return aVal.localeCompare(bVal);
+  }
+  if (aVal < bVal) return -1;
+  if (aVal > bVal) return 1;
+  return 0;
+}
+export {
+  Sorting
+};
+//# sourceMappingURL=Sorting.js.map