mvc-kit 2.12.4 → 2.13.0

package/dist/Resource.js

@@ -1,175 +1,167 @@
-import { Collection } from "./Collection.js";
 import { walkPrototypeChain } from "./walkPrototypeChain.js";
 import { wrapAsyncMethods } from "./wrapAsyncMethods.js";
-const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
-const DEFAULT_TASK_STATE = Object.freeze({ loading: false, error: null, errorCode: null });
-const RESERVED_ASYNC_KEYS = ["async", "subscribeAsync"];
-const LIFECYCLE_HOOKS = /* @__PURE__ */ new Set(["onInit", "onDispose"]);
-class Resource extends Collection {
-  _external = null;
-  _initialized = false;
-  // ── Async tracking fields ──
-  _asyncStates = /* @__PURE__ */ new Map();
-  _asyncSnapshots = /* @__PURE__ */ new Map();
-  _asyncListeners = /* @__PURE__ */ new Set();
-  _asyncProxy = null;
-  _activeOps = null;
-  /** DEV-only timeout (ms) for detecting ghost async operations after dispose. */
-  static GHOST_TIMEOUT = 3e3;
-  constructor(collectionOrItems) {
-    const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);
-    super(isExternal ? [] : collectionOrItems ?? []);
-    if (isExternal) {
-      this._external = collectionOrItems;
-      if (__DEV__) {
-        const Ctor = this.constructor;
-        if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) {
-          console.warn(
-            `[mvc-kit] Resource "${Ctor.name}" has MAX_SIZE or TTL set but uses an injected Collection. Configure these on the Collection instead.`
-          );
-        }
-      }
-    }
-    this._guardReservedKeys();
-  }
-  // ── Lifecycle ─────────────────────────────────────────────────
-  /** Whether init() has been called. */
-  get initialized() {
-    return this._initialized;
-  }
-  /** Initializes the instance. Called automatically by React hooks after mount. */
-  init() {
-    if (this._initialized || this.disposed) return;
-    this._initialized = true;
-    if (__DEV__) {
-      this._activeOps = /* @__PURE__ */ new Map();
-    }
-    wrapAsyncMethods({
-      instance: this,
-      stopPrototype: Resource.prototype,
-      reservedKeys: RESERVED_ASYNC_KEYS,
-      lifecycleHooks: LIFECYCLE_HOOKS,
-      isDisposed: () => this.disposed,
-      isInitialized: () => this._initialized,
-      asyncStates: this._asyncStates,
-      asyncSnapshots: this._asyncSnapshots,
-      asyncListeners: this._asyncListeners,
-      notifyAsync: () => this._notifyAsync(),
-      addCleanup: (fn) => this.addCleanup(fn),
-      ghostTimeout: this.constructor.GHOST_TIMEOUT,
-      className: "Resource",
-      activeOps: this._activeOps
-    });
-    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;
-  }
-  add(...items) {
-    this._external ? this._external.add(...items) : super.add(...items);
-  }
-  upsert(...items) {
-    this._external ? this._external.upsert(...items) : super.upsert(...items);
-  }
-  update(id, changes) {
-    this._external ? this._external.update(id, changes) : super.update(id, changes);
-  }
-  remove(...ids) {
-    this._external ? this._external.remove(...ids) : super.remove(...ids);
-  }
-  reset(items) {
-    this._external ? this._external.reset(items) : super.reset(items);
-  }
-  clear() {
-    this._external ? this._external.clear() : super.clear();
-  }
-  optimistic(callback) {
-    return this._external ? this._external.optimistic(callback) : super.optimistic(callback);
-  }
-  get(id) {
-    return this._external ? this._external.get(id) : super.get(id);
-  }
-  has(id) {
-    return this._external ? this._external.has(id) : super.has(id);
-  }
-  find(predicate) {
-    return this._external ? this._external.find(predicate) : super.find(predicate);
-  }
-  filter(predicate) {
-    return this._external ? this._external.filter(predicate) : super.filter(predicate);
-  }
-  sorted(compareFn) {
-    return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);
-  }
-  map(fn) {
-    return this._external ? this._external.map(fn) : super.map(fn);
-  }
-  subscribe(listener) {
-    if (this.disposed) return () => {
-    };
-    return this._external ? this._external.subscribe(listener) : super.subscribe(listener);
-  }
-  // ── Async tracking API ────────────────────────────────────────
-  /** Proxy providing `TaskState` (loading, error, errorCode) per async method. */
-  get async() {
-    if (!this._asyncProxy) {
-      const self = this;
-      this._asyncProxy = new Proxy({}, {
-        get(_, prop) {
-          return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;
-        },
-        has(_, prop) {
-          return self._asyncSnapshots.has(prop);
-        },
-        ownKeys() {
-          return Array.from(self._asyncSnapshots.keys());
-        },
-        getOwnPropertyDescriptor(_, prop) {
-          if (self._asyncSnapshots.has(prop)) {
-            return { configurable: true, enumerable: true, value: self._asyncSnapshots.get(prop) };
-          }
-          return void 0;
-        }
-      });
-    }
-    return this._asyncProxy;
-  }
-  /** Subscribes to async state changes. Used by `useInstance` for React integration. */
-  subscribeAsync(listener) {
-    if (this.disposed) return () => {
-    };
-    this._asyncListeners.add(listener);
-    return () => {
-      this._asyncListeners.delete(listener);
-    };
-  }
-  // ── Private: async tracking internals ─────────────────────────
-  _notifyAsync() {
-    for (const listener of this._asyncListeners) {
-      listener();
-    }
-  }
-  _guardReservedKeys() {
-    walkPrototypeChain(this, Resource.prototype, (key) => {
-      if (RESERVED_ASYNC_KEYS.includes(key)) {
-        throw new Error(
-          `[mvc-kit] "${key}" is a reserved property on Resource and cannot be overridden.`
-        );
-      }
-    });
-  }
-}
-export {
-  Resource
+import { Collection } from "./Collection.js";
+//#region src/Resource.ts
+var __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+var DEFAULT_TASK_STATE = Object.freeze({
+	loading: false,
+	error: null,
+	errorCode: null
+});
+var RESERVED_ASYNC_KEYS = ["async", "subscribeAsync"];
+var LIFECYCLE_HOOKS = new Set(["onInit", "onDispose"]);
+/**
+* Collection + async tracking toolkit. Extends Collection with lifecycle
+* (init/dispose) and automatic async method tracking. Optionally delegates
+* to an external Collection for shared data scenarios.
+*/
+var Resource = class Resource extends Collection {
+	_external = null;
+	_initialized = false;
+	_asyncStates = /* @__PURE__ */ new Map();
+	_asyncSnapshots = /* @__PURE__ */ new Map();
+	_asyncListeners = /* @__PURE__ */ new Set();
+	_asyncProxy = null;
+	_activeOps = null;
+	/** DEV-only timeout (ms) for detecting ghost async operations after dispose. */
+	static GHOST_TIMEOUT = 3e3;
+	constructor(collectionOrItems) {
+		const isExternal = collectionOrItems != null && !Array.isArray(collectionOrItems);
+		super(isExternal ? [] : collectionOrItems ?? []);
+		if (isExternal) {
+			this._external = collectionOrItems;
+			if (__DEV__) {
+				const Ctor = this.constructor;
+				if (Ctor.MAX_SIZE > 0 || Ctor.TTL > 0) console.warn(`[mvc-kit] Resource "${Ctor.name}" has MAX_SIZE or TTL set but uses an injected Collection. Configure these on the Collection instead.`);
+			}
+		}
+		this._guardReservedKeys();
+	}
+	/** Whether init() has been called. */
+	get initialized() {
+		return this._initialized;
+	}
+	/** Initializes the instance. Called automatically by React hooks after mount. */
+	init() {
+		if (this._initialized || this.disposed) return;
+		this._initialized = true;
+		if (__DEV__) this._activeOps = /* @__PURE__ */ new Map();
+		wrapAsyncMethods({
+			instance: this,
+			stopPrototype: Resource.prototype,
+			reservedKeys: RESERVED_ASYNC_KEYS,
+			lifecycleHooks: LIFECYCLE_HOOKS,
+			isDisposed: () => this.disposed,
+			isInitialized: () => this._initialized,
+			asyncStates: this._asyncStates,
+			asyncSnapshots: this._asyncSnapshots,
+			asyncListeners: this._asyncListeners,
+			notifyAsync: () => this._notifyAsync(),
+			addCleanup: (fn) => this.addCleanup(fn),
+			ghostTimeout: this.constructor.GHOST_TIMEOUT,
+			className: "Resource",
+			activeOps: this._activeOps
+		});
+		return this.onInit?.();
+	}
+	/** 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;
+	}
+	add(...items) {
+		this._external ? this._external.add(...items) : super.add(...items);
+	}
+	upsert(...items) {
+		this._external ? this._external.upsert(...items) : super.upsert(...items);
+	}
+	update(id, changes) {
+		this._external ? this._external.update(id, changes) : super.update(id, changes);
+	}
+	remove(...ids) {
+		this._external ? this._external.remove(...ids) : super.remove(...ids);
+	}
+	reset(items) {
+		this._external ? this._external.reset(items) : super.reset(items);
+	}
+	clear() {
+		this._external ? this._external.clear() : super.clear();
+	}
+	optimistic(callback) {
+		return this._external ? this._external.optimistic(callback) : super.optimistic(callback);
+	}
+	get(id) {
+		return this._external ? this._external.get(id) : super.get(id);
+	}
+	has(id) {
+		return this._external ? this._external.has(id) : super.has(id);
+	}
+	find(predicate) {
+		return this._external ? this._external.find(predicate) : super.find(predicate);
+	}
+	filter(predicate) {
+		return this._external ? this._external.filter(predicate) : super.filter(predicate);
+	}
+	sorted(compareFn) {
+		return this._external ? this._external.sorted(compareFn) : super.sorted(compareFn);
+	}
+	map(fn) {
+		return this._external ? this._external.map(fn) : super.map(fn);
+	}
+	subscribe(listener) {
+		if (this.disposed) return () => {};
+		return this._external ? this._external.subscribe(listener) : super.subscribe(listener);
+	}
+	/** Proxy providing `TaskState` (loading, error, errorCode) per async method. */
+	get async() {
+		if (!this._asyncProxy) {
+			const self = this;
+			this._asyncProxy = new Proxy({}, {
+				get(_, prop) {
+					return self._asyncSnapshots.get(prop) ?? DEFAULT_TASK_STATE;
+				},
+				has(_, prop) {
+					return self._asyncSnapshots.has(prop);
+				},
+				ownKeys() {
+					return Array.from(self._asyncSnapshots.keys());
+				},
+				getOwnPropertyDescriptor(_, prop) {
+					if (self._asyncSnapshots.has(prop)) return {
+						configurable: true,
+						enumerable: true,
+						value: self._asyncSnapshots.get(prop)
+					};
+				}
+			});
+		}
+		return this._asyncProxy;
+	}
+	/** Subscribes to async state changes. Used by `useInstance` for React integration. */
+	subscribeAsync(listener) {
+		if (this.disposed) return () => {};
+		this._asyncListeners.add(listener);
+		return () => {
+			this._asyncListeners.delete(listener);
+		};
+	}
+	_notifyAsync() {
+		for (const listener of this._asyncListeners) listener();
+	}
+	_guardReservedKeys() {
+		walkPrototypeChain(this, Resource.prototype, (key) => {
+			if (RESERVED_ASYNC_KEYS.includes(key)) throw new Error(`[mvc-kit] "${key}" is a reserved property on Resource and cannot be overridden.`);
+		});
+	}
 };
-//# sourceMappingURL=Resource.js.map
+//#endregion
+export { Resource };
+
+//# sourceMappingURL=Resource.js.map

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  /** 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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"}
+{"version":3,"file":"Resource.js","names":[],"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"],"mappings":";;;;AAMA,IAAM,UAAU,OAAO,oBAAoB,eAAe;AAI1D,IAAM,qBAAgC,OAAO,OAAO;CAAE,SAAS;CAAO,OAAO;CAAM,WAAW;CAAM,CAAC;AAUrG,IAAM,sBAAsB,CAAC,SAAS,iBAAiB;AACvD,IAAM,kBAAkB,IAAI,IAAI,CAAC,UAAU,YAAY,CAAC;;;;;;AASxD,IAAa,WAAb,MAAa,iBAAoD,WAAc;CAC7E,YAA0C;CAC1C,eAAuB;CAGvB,+BAAuB,IAAI,KAAgC;CAC3D,kCAA0B,IAAI,KAAwB;CACtD,kCAA0B,IAAI,KAAiB;CAC/C,cAAqD;CACrD,aAAiD;;CAGjD,OAAO,gBAAgB;CAEvB,YAAY,mBAAyC;EACnD,MAAM,aAAa,qBAAqB,QAAQ,CAAC,MAAM,QAAQ,kBAAkB;AACjF,QAAM,aAAa,EAAE,GAAI,qBAA6B,EAAE,CAAC;AAEzD,MAAI,YAAY;AACd,QAAK,YAAY;AAEjB,OAAI,SAAS;IACX,MAAM,OAAO,KAAK;AAClB,QAAI,KAAK,WAAW,KAAK,KAAK,MAAM,EAClC,SAAQ,KACN,uBAAuB,KAAK,KAAK,uGAElC;;;AAKP,OAAK,oBAAoB;;;CAM3B,IAAI,cAAuB;AACzB,SAAO,KAAK;;;CAId,OAA6B;AAC3B,MAAI,KAAK,gBAAgB,KAAK,SAAU;AACxC,OAAK,eAAe;AAEpB,MAAI,QACF,MAAK,6BAAa,IAAI,KAAK;AAG7B,mBAAiB;GACf,UAAU;GACV,eAAe,SAAS;GACxB,cAAc;GACd,gBAAgB;GAChB,kBAAkB,KAAK;GACvB,qBAAqB,KAAK;GAC1B,aAAa,KAAK;GAClB,gBAAgB,KAAK;GACrB,gBAAgB,KAAK;GACrB,mBAAmB,KAAK,cAAc;GACtC,aAAa,OAAO,KAAK,WAAW,GAAG;GACvC,cAAe,KAAK,YAAgC;GACpD,WAAW;GACX,WAAW,KAAK;GACjB,CAAC;AAEF,SAAO,KAAK,UAAU;;;CASxB,IAAI,QAAa;AACf,SAAO,KAAK,YAAY,KAAK,UAAU,QAAQ,MAAM;;;CAIvD,IAAI,QAAa;AACf,SAAO,KAAK,YAAY,KAAK,UAAU,QAAQ,MAAM;;;CAIvD,IAAI,SAAiB;AACnB,SAAO,KAAK,YAAY,KAAK,UAAU,SAAS,MAAM;;CAGxD,IAAI,GAAG,OAAkB;AACvB,OAAK,YAAY,KAAK,UAAU,IAAI,GAAG,MAAM,GAAG,MAAM,IAAI,GAAG,MAAM;;CAGrE,OAAO,GAAG,OAAkB;AAC1B,OAAK,YAAY,KAAK,UAAU,OAAO,GAAG,MAAM,GAAG,MAAM,OAAO,GAAG,MAAM;;CAG3E,OAAO,IAAa,SAA2B;AAC7C,OAAK,YAAY,KAAK,UAAU,OAAO,IAAI,QAAQ,GAAG,MAAM,OAAO,IAAI,QAAQ;;CAGjF,OAAO,GAAG,KAAsB;AAC9B,OAAK,YAAY,KAAK,UAAU,OAAO,GAAG,IAAI,GAAG,MAAM,OAAO,GAAG,IAAI;;CAGvE,MAAM,OAAkB;AACtB,OAAK,YAAY,KAAK,UAAU,MAAM,MAAM,GAAG,MAAM,MAAM,MAAM;;CAGnE,QAAc;AACZ,OAAK,YAAY,KAAK,UAAU,OAAO,GAAG,MAAM,OAAO;;CAGzD,WAAW,UAAkC;AAC3C,SAAO,KAAK,YAAY,KAAK,UAAU,WAAW,SAAS,GAAG,MAAM,WAAW,SAAS;;CAG1F,IAAI,IAA4B;AAC9B,SAAO,KAAK,YAAY,KAAK,UAAU,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG;;CAGhE,IAAI,IAAsB;AACxB,SAAO,KAAK,YAAY,KAAK,UAAU,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG;;CAGhE,KAAK,WAAgD;AACnD,SAAO,KAAK,YAAY,KAAK,UAAU,KAAK,UAAU,GAAG,MAAM,KAAK,UAAU;;CAGhF,OAAO,WAAsC;AAC3C,SAAO,KAAK,YAAY,KAAK,UAAU,OAAO,UAAU,GAAG,MAAM,OAAO,UAAU;;CAGpF,OAAO,WAAwC;AAC7C,SAAO,KAAK,YAAY,KAAK,UAAU,OAAO,UAAU,GAAG,MAAM,OAAO,UAAU;;CAGpF,IAAO,IAAyB;AAC9B,SAAO,KAAK,YAAY,KAAK,UAAU,IAAI,GAAG,GAAG,MAAM,IAAI,GAAG;;CAGhE,UAAU,UAAqC;AAC7C,MAAI,KAAK,SAAU,cAAa;AAChC,SAAO,KAAK,YAAY,KAAK,UAAU,UAAU,SAAS,GAAG,MAAM,UAAU,SAAS;;;CAMxF,IAAI,QAAgC;AAClC,MAAI,CAAC,KAAK,aAAa;GACrB,MAAM,OAAO;AACb,QAAK,cAAc,IAAI,MAAM,EAAE,EAA4B;IACzD,IAAI,GAAG,MAAc;AACnB,YAAO,KAAK,gBAAgB,IAAI,KAAK,IAAI;;IAE3C,IAAI,GAAG,MAAc;AACnB,YAAO,KAAK,gBAAgB,IAAI,KAAK;;IAEvC,UAAU;AACR,YAAO,MAAM,KAAK,KAAK,gBAAgB,MAAM,CAAC;;IAEhD,yBAAyB,GAAG,MAAc;AACxC,SAAI,KAAK,gBAAgB,IAAI,KAAK,CAChC,QAAO;MAAE,cAAc;MAAM,YAAY;MAAM,OAAO,KAAK,gBAAgB,IAAI,KAAK;MAAE;;IAI3F,CAAC;;AAEJ,SAAO,KAAK;;;CAId,eAAe,UAAkC;AAC/C,MAAI,KAAK,SAAU,cAAa;AAChC,OAAK,gBAAgB,IAAI,SAAS;AAClC,eAAa;AAAE,QAAK,gBAAgB,OAAO,SAAS;;;CAKtD,eAA6B;AAC3B,OAAK,MAAM,YAAY,KAAK,gBAC1B,WAAU;;CAId,qBAAmC;AACjC,qBAAmB,MAAM,SAAS,YAAY,QAAQ;AACpD,OAAI,oBAAoB,SAAS,IAAW,CAC1C,OAAM,IAAI,MACR,cAAc,IAAI,gEACnB;IAEH"}

package/dist/Selection.cjs

@@ -1,95 +1,85 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const Trackable = require("./Trackable.cjs");
-class Selection extends Trackable.Trackable {
-  _selected = /* @__PURE__ */ new Set();
-  _readonlyView = this._selected;
-  constructor() {
-    super();
-  }
-  // ── 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)));
-  }
-  // ── Internal ──
-  _publish() {
-    this._readonlyView = new Set(this._selected);
-    this.notify();
-  }
-}
+const require_Trackable = require("./Trackable.cjs");
+//#region src/Selection.ts
+/**
+* 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.
+*/
+var Selection = class extends require_Trackable.Trackable {
+	_selected = /* @__PURE__ */ new Set();
+	_readonlyView = this._selected;
+	constructor() {
+		super();
+	}
+	/** 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;
+	}
+	/** Check whether a specific key is selected. */
+	isSelected(key) {
+		return this._selected.has(key);
+	}
+	/** 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) {
+		if (allKeys.length > 0 && allKeys.every((k) => this._selected.has(k))) 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();
+	}
+	/** Filter an array to only items whose key is in the selection. */
+	selectedFrom(items, keyOf) {
+		return items.filter((item) => this._selected.has(keyOf(item)));
+	}
+	_publish() {
+		this._readonlyView = new Set(this._selected);
+		this.notify();
+	}
+};
+//#endregion
 exports.Selection = Selection;
-//# sourceMappingURL=Selection.cjs.map
+
+//# sourceMappingURL=Selection.cjs.map

package/dist/Selection.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"Selection.cjs","sources":["../src/Selection.ts"],"sourcesContent":["import { Trackable } from './Trackable';\n\n/**\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> extends Trackable {\n  private _selected: Set<K> = new Set();\n  private _readonlyView: ReadonlySet<K> = this._selected;\n\n  constructor() {\n    super();\n  }\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  // ── Internal ──\n\n  private _publish(): void {\n    // Replace readonlyView so reference equality changes (needed for React)\n    this._readonlyView = new Set(this._selected);\n    this.notify();\n  }\n}\n"],"names":["Trackable"],"mappings":";;;AAOO,MAAM,kBAA+DA,UAAAA,UAAU;AAAA,EAC5E,gCAAwB,IAAA;AAAA,EACxB,gBAAgC,KAAK;AAAA,EAE7C,cAAc;AACZ,UAAA;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,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,EAIQ,WAAiB;AAEvB,SAAK,gBAAgB,IAAI,IAAI,KAAK,SAAS;AAC3C,SAAK,OAAA;AAAA,EACP;AACF;;"}
+{"version":3,"file":"Selection.cjs","names":[],"sources":["../src/Selection.ts"],"sourcesContent":["import { Trackable } from './Trackable';\n\n/**\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> extends Trackable {\n  private _selected: Set<K> = new Set();\n  private _readonlyView: ReadonlySet<K> = this._selected;\n\n  constructor() {\n    super();\n  }\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  // ── Internal ──\n\n  private _publish(): void {\n    // Replace readonlyView so reference equality changes (needed for React)\n    this._readonlyView = new Set(this._selected);\n    this.notify();\n  }\n}\n"],"mappings":";;;;;;;AAOA,IAAa,YAAb,cAA4E,kBAAA,UAAU;CACpF,4BAA4B,IAAI,KAAK;CACrC,gBAAwC,KAAK;CAE7C,cAAc;AACZ,SAAO;;;CAMT,IAAI,WAA2B;AAC7B,SAAO,KAAK;;;CAId,IAAI,QAAgB;AAClB,SAAO,KAAK,UAAU;;;CAIxB,IAAI,eAAwB;AAC1B,SAAO,KAAK,UAAU,OAAO;;;CAM/B,WAAW,KAAiB;AAC1B,SAAO,KAAK,UAAU,IAAI,IAAI;;;CAMhC,OAAO,KAAc;AACnB,MAAI,KAAK,UAAU,IAAI,IAAI,CACzB,MAAK,UAAU,OAAO,IAAI;MAE1B,MAAK,UAAU,IAAI,IAAI;AAEzB,OAAK,UAAU;;;CAIjB,OAAO,GAAG,MAAiB;EACzB,IAAI,UAAU;AACd,OAAK,MAAM,OAAO,KAChB,KAAI,CAAC,KAAK,UAAU,IAAI,IAAI,EAAE;AAC5B,QAAK,UAAU,IAAI,IAAI;AACvB,aAAU;;AAGd,MAAI,QAAS,MAAK,UAAU;;;CAI9B,SAAS,GAAG,MAAiB;EAC3B,IAAI,UAAU;AACd,OAAK,MAAM,OAAO,KAChB,KAAI,KAAK,UAAU,IAAI,IAAI,EAAE;AAC3B,QAAK,UAAU,OAAO,IAAI;AAC1B,aAAU;;AAGd,MAAI,QAAS,MAAK,UAAU;;;CAI9B,UAAU,SAAoB;AAE5B,MADoB,QAAQ,SAAS,KAAK,QAAQ,OAAM,MAAK,KAAK,UAAU,IAAI,EAAE,CAAC,CAEjF,MAAK,UAAU,OAAO;MAEtB,MAAK,MAAM,OAAO,QAAS,MAAK,UAAU,IAAI,IAAI;AAEpD,OAAK,UAAU;;;CAIjB,IAAI,GAAG,MAAiB;AAEtB,MAAI,KAAK,WAAW,KAAK,UAAU,QAAQ,KAAK,OAAM,MAAK,KAAK,UAAU,IAAI,EAAE,CAAC,CAAE;AACnF,OAAK,UAAU,OAAO;AACtB,OAAK,MAAM,OAAO,KAAM,MAAK,UAAU,IAAI,IAAI;AAC/C,OAAK,UAAU;;;CAIjB,QAAc;AACZ,MAAI,KAAK,UAAU,SAAS,EAAG;AAC/B,OAAK,UAAU,OAAO;AACtB,OAAK,UAAU;;;CAMjB,aAAgB,OAAY,OAA4B;AACtD,SAAO,MAAM,QAAO,SAAQ,KAAK,UAAU,IAAI,MAAM,KAAK,CAAC,CAAC;;CAK9D,WAAyB;AAEvB,OAAK,gBAAgB,IAAI,IAAI,KAAK,UAAU;AAC5C,OAAK,QAAQ"}