mvc-kit 2.5.3 → 2.5.4

package/dist/react/use-local.js

@@ -0,0 +1,64 @@
+import { useRef, useEffect } from "react";
+import { isInitializable, isSubscribable } from "./guards.js";
+import { useInstance } from "./use-instance.js";
+function depsChanged(prev, next) {
+  if (prev === void 0) return false;
+  if (prev.length !== next.length) return true;
+  for (let i = 0; i < prev.length; i++) {
+    if (!Object.is(prev[i], next[i])) return true;
+  }
+  return false;
+}
+function useLocal(classOrFactory, ...rest) {
+  let args;
+  let deps;
+  if (rest.length > 0 && Array.isArray(rest[rest.length - 1])) {
+    deps = rest[rest.length - 1];
+    args = rest.slice(0, -1);
+  } else {
+    args = rest;
+    deps = void 0;
+  }
+  const instanceRef = useRef(null);
+  const mountedRef = useRef(false);
+  const prevDepsRef = useRef(void 0);
+  if (deps !== void 0 && depsChanged(prevDepsRef.current, deps)) {
+    instanceRef.current?.dispose();
+    instanceRef.current = null;
+  }
+  if (deps !== void 0) {
+    prevDepsRef.current = deps;
+  }
+  if (!instanceRef.current || instanceRef.current.disposed) {
+    const isClass = typeof classOrFactory === "function" && classOrFactory.prototype && classOrFactory.prototype.constructor === classOrFactory;
+    if (isClass) {
+      instanceRef.current = new classOrFactory(...args);
+    } else {
+      instanceRef.current = classOrFactory();
+    }
+  }
+  useEffect(() => {
+    const instance = instanceRef.current;
+    mountedRef.current = true;
+    if (isInitializable(instance)) {
+      instance.init();
+    }
+    return () => {
+      mountedRef.current = false;
+      setTimeout(() => {
+        if (!mountedRef.current) {
+          instance.dispose();
+        }
+      }, 0);
+    };
+  }, deps ?? []);
+  if (isSubscribable(instanceRef.current)) {
+    const state = useInstance(instanceRef.current);
+    return [state, instanceRef.current];
+  }
+  return instanceRef.current;
+}
+export {
+  useLocal
+};
+//# sourceMappingURL=use-local.js.map

package/dist/react/use-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-local.js","sources":["../../src/react/use-local.ts"],"sourcesContent":["import { useRef, useEffect } from 'react';\nimport type { DependencyList } from 'react';\nimport type { Subscribable, Disposable } from '../types';\nimport { isSubscribable, isInitializable } from './guards';\nimport { useInstance } from './use-instance';\nimport type { StateOf } from './types';\n\nfunction depsChanged(prev: DependencyList | undefined, next: DependencyList): boolean {\n  if (prev === undefined) return false;\n  if (prev.length !== next.length) return true;\n  for (let i = 0; i < prev.length; i++) {\n    if (!Object.is(prev[i], next[i])) return true;\n  }\n  return false;\n}\n\n// ── With deps (class + initialState + deps) ────────────────────────\n\n/**\n * Create component-scoped Subscribable instance, auto-disposed on unmount.\n * Disposes and recreates when deps change.\n * Returns [state, instance] tuple.\n */\nexport function useLocal<T extends Subscribable<any> & Disposable>(\n  Class: new (initialState: StateOf<T>) => T,\n  initialState: StateOf<T>,\n  deps: DependencyList,\n): [StateOf<T>, T];\n\n/**\n * Create component-scoped Subscribable instance via factory, auto-disposed on unmount.\n * Disposes and recreates when deps change.\n * Returns [state, instance] tuple.\n */\nexport function useLocal<T extends Subscribable<S> & Disposable, S = StateOf<T>>(\n  factory: () => T,\n  deps: DependencyList,\n): [S, T];\n\n/**\n * Create component-scoped Disposable instance via factory (non-Subscribable), auto-disposed on unmount.\n * Disposes and recreates when deps change.\n * Returns the instance directly.\n */\nexport function useLocal<T extends Disposable>(\n  factory: () => T,\n  deps: DependencyList,\n): T;\n\n// ── Without deps (existing overloads, unchanged) ───────────────────\n\n/**\n * Create component-scoped Subscribable instance, auto-disposed on unmount.\n * Returns [state, instance] tuple.\n */\nexport function useLocal<\n  T extends Subscribable<S> & Disposable,\n  S = StateOf<T>,\n  Args extends unknown[] = unknown[]\n>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): [S, T];\n\n/**\n * Create component-scoped Disposable instance (non-Subscribable), auto-disposed on unmount.\n * Returns the instance directly.\n */\nexport function useLocal<T extends Disposable, Args extends unknown[] = unknown[]>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): T;\n\n/**\n * Create component-scoped Subscribable instance via factory, auto-disposed on unmount.\n * Returns [state, instance] tuple.\n */\nexport function useLocal<T extends Subscribable<S> & Disposable, S = StateOf<T>>(\n  factory: () => T\n): [S, T];\n\n/**\n * Create component-scoped Disposable instance via factory (non-Subscribable), auto-disposed on unmount.\n * Returns the instance directly.\n */\nexport function useLocal<T extends Disposable>(factory: () => T): T;\n\n// ── Implementation ─────────────────────────────────────────────────\n\nexport function useLocal<T extends Disposable, S = StateOf<T>>(\n  classOrFactory: (new (...args: unknown[]) => T) | (() => T),\n  ...rest: unknown[]\n): [S, T] | T {\n  // ── Detect deps: last arg is an array → treat as deps ──\n  let args: unknown[];\n  let deps: DependencyList | undefined;\n\n  if (rest.length > 0 && Array.isArray(rest[rest.length - 1])) {\n    deps = rest[rest.length - 1] as DependencyList;\n    args = rest.slice(0, -1);\n  } else {\n    args = rest;\n    deps = undefined;\n  }\n\n  const instanceRef = useRef<T | null>(null);\n  const mountedRef = useRef(false);\n  const prevDepsRef = useRef<DependencyList | undefined>(undefined);\n\n  // ── Render phase: dep-change detection ──\n  if (deps !== undefined && depsChanged(prevDepsRef.current, deps)) {\n    instanceRef.current?.dispose();\n    instanceRef.current = null;\n  }\n  if (deps !== undefined) {\n    prevDepsRef.current = deps;\n  }\n\n  // ── Create instance if needed ──\n  if (!instanceRef.current || instanceRef.current.disposed) {\n    const isClass =\n      typeof classOrFactory === 'function' &&\n      classOrFactory.prototype &&\n      classOrFactory.prototype.constructor === classOrFactory;\n\n    if (isClass) {\n      instanceRef.current = new (classOrFactory as new (...a: unknown[]) => T)(...args);\n    } else {\n      instanceRef.current = (classOrFactory as () => T)();\n    }\n  }\n\n  // ── Effect: init + deferred cleanup ──\n  useEffect(() => {\n    const instance = instanceRef.current!; // capture for cleanup closure\n    mountedRef.current = true;\n    if (isInitializable(instance)) {\n      instance.init();\n    }\n    return () => {\n      mountedRef.current = false;\n      setTimeout(() => {\n        if (!mountedRef.current) {\n          instance.dispose();\n        }\n      }, 0);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps ?? []);\n\n  // ── Subscribe to state if Subscribable ──\n  if (isSubscribable(instanceRef.current)) {\n    const state = useInstance(instanceRef.current as unknown as Subscribable<S>);\n    return [state, instanceRef.current];\n  }\n\n  return instanceRef.current;\n}\n"],"names":[],"mappings":";;;AAOA,SAAS,YAAY,MAAkC,MAA+B;AACpF,MAAI,SAAS,OAAW,QAAO;AAC/B,MAAI,KAAK,WAAW,KAAK,OAAQ,QAAO;AACxC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,QAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,EAAG,QAAO;AAAA,EAC3C;AACA,SAAO;AACT;AA2EO,SAAS,SACd,mBACG,MACS;AAEZ,MAAI;AACJ,MAAI;AAEJ,MAAI,KAAK,SAAS,KAAK,MAAM,QAAQ,KAAK,KAAK,SAAS,CAAC,CAAC,GAAG;AAC3D,WAAO,KAAK,KAAK,SAAS,CAAC;AAC3B,WAAO,KAAK,MAAM,GAAG,EAAE;AAAA,EACzB,OAAO;AACL,WAAO;AACP,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,OAAiB,IAAI;AACzC,QAAM,aAAa,OAAO,KAAK;AAC/B,QAAM,cAAc,OAAmC,MAAS;AAGhE,MAAI,SAAS,UAAa,YAAY,YAAY,SAAS,IAAI,GAAG;AAChE,gBAAY,SAAS,QAAA;AACrB,gBAAY,UAAU;AAAA,EACxB;AACA,MAAI,SAAS,QAAW;AACtB,gBAAY,UAAU;AAAA,EACxB;AAGA,MAAI,CAAC,YAAY,WAAW,YAAY,QAAQ,UAAU;AACxD,UAAM,UACJ,OAAO,mBAAmB,cAC1B,eAAe,aACf,eAAe,UAAU,gBAAgB;AAE3C,QAAI,SAAS;AACX,kBAAY,UAAU,IAAK,eAA8C,GAAG,IAAI;AAAA,IAClF,OAAO;AACL,kBAAY,UAAW,eAAA;AAAA,IACzB;AAAA,EACF;AAGA,YAAU,MAAM;AACd,UAAM,WAAW,YAAY;AAC7B,eAAW,UAAU;AACrB,QAAI,gBAAgB,QAAQ,GAAG;AAC7B,eAAS,KAAA;AAAA,IACX;AACA,WAAO,MAAM;AACX,iBAAW,UAAU;AACrB,iBAAW,MAAM;AACf,YAAI,CAAC,WAAW,SAAS;AACvB,mBAAS,QAAA;AAAA,QACX;AAAA,MACF,GAAG,CAAC;AAAA,IACN;AAAA,EAEF,GAAG,QAAQ,EAAE;AAGb,MAAI,eAAe,YAAY,OAAO,GAAG;AACvC,UAAM,QAAQ,YAAY,YAAY,OAAqC;AAC3E,WAAO,CAAC,OAAO,YAAY,OAAO;AAAA,EACpC;AAEA,SAAO,YAAY;AACrB;"}

package/dist/react/use-model.cjs

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const guards = require("./guards.cjs");
+function useModel(factory) {
+  const modelRef = react.useRef(null);
+  const mountedRef = react.useRef(false);
+  if (!modelRef.current || modelRef.current.disposed) {
+    modelRef.current = factory();
+  }
+  react.useSyncExternalStore(
+    (onStoreChange) => modelRef.current.subscribe(onStoreChange),
+    () => modelRef.current.state,
+    () => modelRef.current.state
+  );
+  react.useEffect(() => {
+    mountedRef.current = true;
+    if (guards.isInitializable(modelRef.current)) {
+      modelRef.current.init();
+    }
+    return () => {
+      mountedRef.current = false;
+      setTimeout(() => {
+        if (!mountedRef.current) {
+          modelRef.current?.dispose();
+        }
+      }, 0);
+    };
+  }, []);
+  const model = modelRef.current;
+  return {
+    state: model.state,
+    errors: model.errors,
+    valid: model.valid,
+    dirty: model.dirty,
+    model
+  };
+}
+function useField(model, field) {
+  const getSnapshot = react.useCallback(() => {
+    return {
+      value: model.state[field],
+      error: model.errors[field]
+    };
+  }, [model, field]);
+  const cachedRef = react.useRef(getSnapshot());
+  const subscribe = react.useCallback(
+    (onStoreChange) => {
+      return model.subscribe(() => {
+        const next = getSnapshot();
+        const current = cachedRef.current;
+        if (next.value !== current.value || next.error !== current.error) {
+          cachedRef.current = next;
+          onStoreChange();
+        }
+      });
+    },
+    [model, getSnapshot]
+  );
+  const snapshot = react.useSyncExternalStore(
+    subscribe,
+    () => cachedRef.current,
+    () => cachedRef.current
+  );
+  const set = react.useCallback(
+    (value) => {
+      const partial = { [field]: value };
+      model.set(partial);
+    },
+    [model, field]
+  );
+  return {
+    value: snapshot.value,
+    error: snapshot.error,
+    set
+  };
+}
+exports.useField = useField;
+exports.useModel = useModel;
+//# sourceMappingURL=use-model.cjs.map

package/dist/react/use-model.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-model.cjs","sources":["../../src/react/use-model.ts"],"sourcesContent":["import { useRef, useEffect, useSyncExternalStore, useCallback } from 'react';\nimport type { Model } from '../Model';\nimport type { ValidationErrors } from '../types';\nimport type { StateOf } from './types';\nimport { isInitializable } from './guards';\n\n/** Return type of `useModel`, providing state, validation, and model access. */\nexport interface ModelHandle<S extends object, M extends Model<S>> {\n  state: S;\n  errors: ValidationErrors<S>;\n  valid: boolean;\n  dirty: boolean;\n  model: M;\n}\n\n/**\n * Bind to a component-scoped Model with validation and dirty state exposed.\n */\nexport function useModel<M extends Model<any>>(\n  factory: () => M\n): ModelHandle<StateOf<M>, M> {\n  const modelRef = useRef<M | null>(null);\n  const mountedRef = useRef(false);\n\n  if (!modelRef.current || modelRef.current.disposed) {\n    modelRef.current = factory();\n  }\n\n  useSyncExternalStore(\n    (onStoreChange) => modelRef.current!.subscribe(onStoreChange),\n    () => modelRef.current!.state,\n    () => modelRef.current!.state,\n  );\n\n  useEffect(() => {\n    mountedRef.current = true;\n    if (isInitializable(modelRef.current)) {\n      modelRef.current.init();\n    }\n    return () => {\n      mountedRef.current = false;\n      setTimeout(() => {\n        if (!mountedRef.current) {\n          modelRef.current?.dispose();\n        }\n      }, 0);\n    };\n  }, []);\n\n  const model = modelRef.current;\n\n  return {\n    state: model.state,\n    errors: model.errors,\n    valid: model.valid,\n    dirty: model.dirty,\n    model,\n  };\n}\n\n/** Return type of `useField`, providing a single field's value, error, and setter. */\nexport interface FieldHandle<V> {\n  value: V;\n  error: string | undefined;\n  set: (value: V) => void;\n}\n\n/**\n * Bind to a single Model field with surgical re-renders.\n */\nexport function useField<S extends object, K extends keyof S>(\n  model: Model<S>,\n  field: K\n): FieldHandle<S[K]> {\n  // Track the field value and error for comparison\n  const getSnapshot = useCallback(() => {\n    return {\n      value: model.state[field],\n      error: model.errors[field],\n    };\n  }, [model, field]);\n\n  // Use object comparison for subscription\n  const cachedRef = useRef(getSnapshot());\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      return model.subscribe(() => {\n        const next = getSnapshot();\n        const current = cachedRef.current;\n\n        // Only trigger re-render if field value or error changed\n        if (next.value !== current.value || next.error !== current.error) {\n          cachedRef.current = next;\n          onStoreChange();\n        }\n      });\n    },\n    [model, getSnapshot]\n  );\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => cachedRef.current,\n    () => cachedRef.current\n  );\n\n  const set = useCallback(\n    (value: S[K]) => {\n      // Access the protected set method through type assertion\n      // The Model subclass should expose a setter method\n      const partial: Partial<S> = { [field]: value } as unknown as Partial<S>;\n      (model as unknown as { set: (partial: Partial<S>) => void }).set(partial);\n    },\n    [model, field]\n  );\n\n  return {\n    value: snapshot.value,\n    error: snapshot.error,\n    set,\n  };\n}\n"],"names":["useRef","useSyncExternalStore","useEffect","isInitializable","useCallback"],"mappings":";;;;AAkBO,SAAS,SACd,SAC4B;AAC5B,QAAM,WAAWA,MAAAA,OAAiB,IAAI;AACtC,QAAM,aAAaA,MAAAA,OAAO,KAAK;AAE/B,MAAI,CAAC,SAAS,WAAW,SAAS,QAAQ,UAAU;AAClD,aAAS,UAAU,QAAA;AAAA,EACrB;AAEAC,QAAAA;AAAAA,IACE,CAAC,kBAAkB,SAAS,QAAS,UAAU,aAAa;AAAA,IAC5D,MAAM,SAAS,QAAS;AAAA,IACxB,MAAM,SAAS,QAAS;AAAA,EAAA;AAG1BC,QAAAA,UAAU,MAAM;AACd,eAAW,UAAU;AACrB,QAAIC,OAAAA,gBAAgB,SAAS,OAAO,GAAG;AACrC,eAAS,QAAQ,KAAA;AAAA,IACnB;AACA,WAAO,MAAM;AACX,iBAAW,UAAU;AACrB,iBAAW,MAAM;AACf,YAAI,CAAC,WAAW,SAAS;AACvB,mBAAS,SAAS,QAAA;AAAA,QACpB;AAAA,MACF,GAAG,CAAC;AAAA,IACN;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,QAAQ,SAAS;AAEvB,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb,QAAQ,MAAM;AAAA,IACd,OAAO,MAAM;AAAA,IACb,OAAO,MAAM;AAAA,IACb;AAAA,EAAA;AAEJ;AAYO,SAAS,SACd,OACA,OACmB;AAEnB,QAAM,cAAcC,MAAAA,YAAY,MAAM;AACpC,WAAO;AAAA,MACL,OAAO,MAAM,MAAM,KAAK;AAAA,MACxB,OAAO,MAAM,OAAO,KAAK;AAAA,IAAA;AAAA,EAE7B,GAAG,CAAC,OAAO,KAAK,CAAC;AAGjB,QAAM,YAAYJ,aAAO,aAAa;AAEtC,QAAM,YAAYI,MAAAA;AAAAA,IAChB,CAAC,kBAA8B;AAC7B,aAAO,MAAM,UAAU,MAAM;AAC3B,cAAM,OAAO,YAAA;AACb,cAAM,UAAU,UAAU;AAG1B,YAAI,KAAK,UAAU,QAAQ,SAAS,KAAK,UAAU,QAAQ,OAAO;AAChE,oBAAU,UAAU;AACpB,wBAAA;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,CAAC,OAAO,WAAW;AAAA,EAAA;AAGrB,QAAM,WAAWH,MAAAA;AAAAA,IACf;AAAA,IACA,MAAM,UAAU;AAAA,IAChB,MAAM,UAAU;AAAA,EAAA;AAGlB,QAAM,MAAMG,MAAAA;AAAAA,IACV,CAAC,UAAgB;AAGf,YAAM,UAAsB,EAAE,CAAC,KAAK,GAAG,MAAA;AACtC,YAA4D,IAAI,OAAO;AAAA,IAC1E;AAAA,IACA,CAAC,OAAO,KAAK;AAAA,EAAA;AAGf,SAAO;AAAA,IACL,OAAO,SAAS;AAAA,IAChB,OAAO,SAAS;AAAA,IAChB;AAAA,EAAA;AAEJ;;;"}

package/dist/react/use-model.js

@@ -0,0 +1,80 @@
+import { useCallback, useRef, useSyncExternalStore, useEffect } from "react";
+import { isInitializable } from "./guards.js";
+function useModel(factory) {
+  const modelRef = useRef(null);
+  const mountedRef = useRef(false);
+  if (!modelRef.current || modelRef.current.disposed) {
+    modelRef.current = factory();
+  }
+  useSyncExternalStore(
+    (onStoreChange) => modelRef.current.subscribe(onStoreChange),
+    () => modelRef.current.state,
+    () => modelRef.current.state
+  );
+  useEffect(() => {
+    mountedRef.current = true;
+    if (isInitializable(modelRef.current)) {
+      modelRef.current.init();
+    }
+    return () => {
+      mountedRef.current = false;
+      setTimeout(() => {
+        if (!mountedRef.current) {
+          modelRef.current?.dispose();
+        }
+      }, 0);
+    };
+  }, []);
+  const model = modelRef.current;
+  return {
+    state: model.state,
+    errors: model.errors,
+    valid: model.valid,
+    dirty: model.dirty,
+    model
+  };
+}
+function useField(model, field) {
+  const getSnapshot = useCallback(() => {
+    return {
+      value: model.state[field],
+      error: model.errors[field]
+    };
+  }, [model, field]);
+  const cachedRef = useRef(getSnapshot());
+  const subscribe = useCallback(
+    (onStoreChange) => {
+      return model.subscribe(() => {
+        const next = getSnapshot();
+        const current = cachedRef.current;
+        if (next.value !== current.value || next.error !== current.error) {
+          cachedRef.current = next;
+          onStoreChange();
+        }
+      });
+    },
+    [model, getSnapshot]
+  );
+  const snapshot = useSyncExternalStore(
+    subscribe,
+    () => cachedRef.current,
+    () => cachedRef.current
+  );
+  const set = useCallback(
+    (value) => {
+      const partial = { [field]: value };
+      model.set(partial);
+    },
+    [model, field]
+  );
+  return {
+    value: snapshot.value,
+    error: snapshot.error,
+    set
+  };
+}
+export {
+  useField,
+  useModel
+};
+//# sourceMappingURL=use-model.js.map

package/dist/react/use-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-model.js","sources":["../../src/react/use-model.ts"],"sourcesContent":["import { useRef, useEffect, useSyncExternalStore, useCallback } from 'react';\nimport type { Model } from '../Model';\nimport type { ValidationErrors } from '../types';\nimport type { StateOf } from './types';\nimport { isInitializable } from './guards';\n\n/** Return type of `useModel`, providing state, validation, and model access. */\nexport interface ModelHandle<S extends object, M extends Model<S>> {\n  state: S;\n  errors: ValidationErrors<S>;\n  valid: boolean;\n  dirty: boolean;\n  model: M;\n}\n\n/**\n * Bind to a component-scoped Model with validation and dirty state exposed.\n */\nexport function useModel<M extends Model<any>>(\n  factory: () => M\n): ModelHandle<StateOf<M>, M> {\n  const modelRef = useRef<M | null>(null);\n  const mountedRef = useRef(false);\n\n  if (!modelRef.current || modelRef.current.disposed) {\n    modelRef.current = factory();\n  }\n\n  useSyncExternalStore(\n    (onStoreChange) => modelRef.current!.subscribe(onStoreChange),\n    () => modelRef.current!.state,\n    () => modelRef.current!.state,\n  );\n\n  useEffect(() => {\n    mountedRef.current = true;\n    if (isInitializable(modelRef.current)) {\n      modelRef.current.init();\n    }\n    return () => {\n      mountedRef.current = false;\n      setTimeout(() => {\n        if (!mountedRef.current) {\n          modelRef.current?.dispose();\n        }\n      }, 0);\n    };\n  }, []);\n\n  const model = modelRef.current;\n\n  return {\n    state: model.state,\n    errors: model.errors,\n    valid: model.valid,\n    dirty: model.dirty,\n    model,\n  };\n}\n\n/** Return type of `useField`, providing a single field's value, error, and setter. */\nexport interface FieldHandle<V> {\n  value: V;\n  error: string | undefined;\n  set: (value: V) => void;\n}\n\n/**\n * Bind to a single Model field with surgical re-renders.\n */\nexport function useField<S extends object, K extends keyof S>(\n  model: Model<S>,\n  field: K\n): FieldHandle<S[K]> {\n  // Track the field value and error for comparison\n  const getSnapshot = useCallback(() => {\n    return {\n      value: model.state[field],\n      error: model.errors[field],\n    };\n  }, [model, field]);\n\n  // Use object comparison for subscription\n  const cachedRef = useRef(getSnapshot());\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      return model.subscribe(() => {\n        const next = getSnapshot();\n        const current = cachedRef.current;\n\n        // Only trigger re-render if field value or error changed\n        if (next.value !== current.value || next.error !== current.error) {\n          cachedRef.current = next;\n          onStoreChange();\n        }\n      });\n    },\n    [model, getSnapshot]\n  );\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => cachedRef.current,\n    () => cachedRef.current\n  );\n\n  const set = useCallback(\n    (value: S[K]) => {\n      // Access the protected set method through type assertion\n      // The Model subclass should expose a setter method\n      const partial: Partial<S> = { [field]: value } as unknown as Partial<S>;\n      (model as unknown as { set: (partial: Partial<S>) => void }).set(partial);\n    },\n    [model, field]\n  );\n\n  return {\n    value: snapshot.value,\n    error: snapshot.error,\n    set,\n  };\n}\n"],"names":[],"mappings":";;AAkBO,SAAS,SACd,SAC4B;AAC5B,QAAM,WAAW,OAAiB,IAAI;AACtC,QAAM,aAAa,OAAO,KAAK;AAE/B,MAAI,CAAC,SAAS,WAAW,SAAS,QAAQ,UAAU;AAClD,aAAS,UAAU,QAAA;AAAA,EACrB;AAEA;AAAA,IACE,CAAC,kBAAkB,SAAS,QAAS,UAAU,aAAa;AAAA,IAC5D,MAAM,SAAS,QAAS;AAAA,IACxB,MAAM,SAAS,QAAS;AAAA,EAAA;AAG1B,YAAU,MAAM;AACd,eAAW,UAAU;AACrB,QAAI,gBAAgB,SAAS,OAAO,GAAG;AACrC,eAAS,QAAQ,KAAA;AAAA,IACnB;AACA,WAAO,MAAM;AACX,iBAAW,UAAU;AACrB,iBAAW,MAAM;AACf,YAAI,CAAC,WAAW,SAAS;AACvB,mBAAS,SAAS,QAAA;AAAA,QACpB;AAAA,MACF,GAAG,CAAC;AAAA,IACN;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,QAAQ,SAAS;AAEvB,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb,QAAQ,MAAM;AAAA,IACd,OAAO,MAAM;AAAA,IACb,OAAO,MAAM;AAAA,IACb;AAAA,EAAA;AAEJ;AAYO,SAAS,SACd,OACA,OACmB;AAEnB,QAAM,cAAc,YAAY,MAAM;AACpC,WAAO;AAAA,MACL,OAAO,MAAM,MAAM,KAAK;AAAA,MACxB,OAAO,MAAM,OAAO,KAAK;AAAA,IAAA;AAAA,EAE7B,GAAG,CAAC,OAAO,KAAK,CAAC;AAGjB,QAAM,YAAY,OAAO,aAAa;AAEtC,QAAM,YAAY;AAAA,IAChB,CAAC,kBAA8B;AAC7B,aAAO,MAAM,UAAU,MAAM;AAC3B,cAAM,OAAO,YAAA;AACb,cAAM,UAAU,UAAU;AAG1B,YAAI,KAAK,UAAU,QAAQ,SAAS,KAAK,UAAU,QAAQ,OAAO;AAChE,oBAAU,UAAU;AACpB,wBAAA;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,CAAC,OAAO,WAAW;AAAA,EAAA;AAGrB,QAAM,WAAW;AAAA,IACf;AAAA,IACA,MAAM,UAAU;AAAA,IAChB,MAAM,UAAU;AAAA,EAAA;AAGlB,QAAM,MAAM;AAAA,IACV,CAAC,UAAgB;AAGf,YAAM,UAAsB,EAAE,CAAC,KAAK,GAAG,MAAA;AACtC,YAA4D,IAAI,OAAO;AAAA,IAC1E;AAAA,IACA,CAAC,OAAO,KAAK;AAAA,EAAA;AAGf,SAAO;AAAA,IACL,OAAO,SAAS;AAAA,IAChB,OAAO,SAAS;AAAA,IAChB;AAAA,EAAA;AAEJ;"}

package/dist/react/use-singleton.cjs

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const singleton = require("../singleton.cjs");
+const useInstance = require("./use-instance.cjs");
+const guards = require("./guards.cjs");
+function useSingleton(Class, ...args) {
+  const instance = singleton.singleton(Class, ...args);
+  react.useEffect(() => {
+    if (guards.isInitializable(instance)) {
+      instance.init();
+    }
+  }, [instance]);
+  if (guards.isSubscribable(instance)) {
+    const state = useInstance.useInstance(instance);
+    return [state, instance];
+  }
+  return instance;
+}
+exports.useSingleton = useSingleton;
+//# sourceMappingURL=use-singleton.cjs.map

package/dist/react/use-singleton.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-singleton.cjs","sources":["../../src/react/use-singleton.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport type { Subscribable, Disposable } from '../types';\nimport { singleton } from '../singleton';\nimport { useInstance } from './use-instance';\nimport { isSubscribable, isInitializable } from './guards';\nimport type { StateOf } from './types';\n\n/**\n * Get singleton Subscribable instance and subscribe to its state.\n * Returns [state, instance] tuple.\n */\nexport function useSingleton<\n  T extends Subscribable<S> & Disposable,\n  S = StateOf<T>,\n  Args extends unknown[] = unknown[]\n>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): [S, T];\n\n/**\n * Get singleton Disposable instance (non-Subscribable).\n * Returns the instance directly.\n */\nexport function useSingleton<T extends Disposable, Args extends unknown[] = unknown[]>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): T;\n\n// Implementation\nexport function useSingleton<T extends Disposable, S = StateOf<T>, Args extends unknown[] = unknown[]>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): [S, T] | T {\n  const instance = singleton(Class, ...args);\n\n  useEffect(() => {\n    if (isInitializable(instance)) {\n      instance.init();\n    }\n  }, [instance]);\n\n  if (isSubscribable(instance)) {\n    const state = useInstance(instance) as S;\n    return [state, instance];\n  }\n\n  return instance;\n}\n"],"names":["singleton","useEffect","isInitializable","isSubscribable","useInstance"],"mappings":";;;;;;AA8BO,SAAS,aACd,UACG,MACS;AACZ,QAAM,WAAWA,UAAAA,UAAU,OAAO,GAAG,IAAI;AAEzCC,QAAAA,UAAU,MAAM;AACd,QAAIC,OAAAA,gBAAgB,QAAQ,GAAG;AAC7B,eAAS,KAAA;AAAA,IACX;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AAEb,MAAIC,OAAAA,eAAe,QAAQ,GAAG;AAC5B,UAAM,QAAQC,YAAAA,YAAY,QAAQ;AAClC,WAAO,CAAC,OAAO,QAAQ;AAAA,EACzB;AAEA,SAAO;AACT;;"}

package/dist/react/use-singleton.js

@@ -0,0 +1,21 @@
+import { useEffect } from "react";
+import { singleton } from "../singleton.js";
+import { useInstance } from "./use-instance.js";
+import { isInitializable, isSubscribable } from "./guards.js";
+function useSingleton(Class, ...args) {
+  const instance = singleton(Class, ...args);
+  useEffect(() => {
+    if (isInitializable(instance)) {
+      instance.init();
+    }
+  }, [instance]);
+  if (isSubscribable(instance)) {
+    const state = useInstance(instance);
+    return [state, instance];
+  }
+  return instance;
+}
+export {
+  useSingleton
+};
+//# sourceMappingURL=use-singleton.js.map

package/dist/react/use-singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-singleton.js","sources":["../../src/react/use-singleton.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport type { Subscribable, Disposable } from '../types';\nimport { singleton } from '../singleton';\nimport { useInstance } from './use-instance';\nimport { isSubscribable, isInitializable } from './guards';\nimport type { StateOf } from './types';\n\n/**\n * Get singleton Subscribable instance and subscribe to its state.\n * Returns [state, instance] tuple.\n */\nexport function useSingleton<\n  T extends Subscribable<S> & Disposable,\n  S = StateOf<T>,\n  Args extends unknown[] = unknown[]\n>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): [S, T];\n\n/**\n * Get singleton Disposable instance (non-Subscribable).\n * Returns the instance directly.\n */\nexport function useSingleton<T extends Disposable, Args extends unknown[] = unknown[]>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): T;\n\n// Implementation\nexport function useSingleton<T extends Disposable, S = StateOf<T>, Args extends unknown[] = unknown[]>(\n  Class: new (...args: Args) => T,\n  ...args: Args\n): [S, T] | T {\n  const instance = singleton(Class, ...args);\n\n  useEffect(() => {\n    if (isInitializable(instance)) {\n      instance.init();\n    }\n  }, [instance]);\n\n  if (isSubscribable(instance)) {\n    const state = useInstance(instance) as S;\n    return [state, instance];\n  }\n\n  return instance;\n}\n"],"names":[],"mappings":";;;;AA8BO,SAAS,aACd,UACG,MACS;AACZ,QAAM,WAAW,UAAU,OAAO,GAAG,IAAI;AAEzC,YAAU,MAAM;AACd,QAAI,gBAAgB,QAAQ,GAAG;AAC7B,eAAS,KAAA;AAAA,IACX;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AAEb,MAAI,eAAe,QAAQ,GAAG;AAC5B,UAAM,QAAQ,YAAY,QAAQ;AAClC,WAAO,CAAC,OAAO,QAAQ;AAAA,EACzB;AAEA,SAAO;AACT;"}

package/dist/react/use-teardown.cjs

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const singleton = require("../singleton.cjs");
+function useTeardown(...Classes) {
+  const mountedRef = react.useRef(false);
+  react.useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      setTimeout(() => {
+        if (!mountedRef.current) {
+          for (const Class of Classes) {
+            singleton.teardown(Class);
+          }
+        }
+      }, 0);
+    };
+  }, []);
+}
+exports.useTeardown = useTeardown;
+//# sourceMappingURL=use-teardown.cjs.map

package/dist/react/use-teardown.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-teardown.cjs","sources":["../../src/react/use-teardown.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\nimport type { Disposable } from '../types';\nimport { teardown } from '../singleton';\n\n/**\n * Teardown singleton class(es) on unmount.\n * Uses deferred disposal to handle StrictMode's double-mount cycle.\n */\nexport function useTeardown(\n  ...Classes: Array<new (...args: unknown[]) => Disposable>\n): void {\n  const mountedRef = useRef(false);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n      setTimeout(() => {\n        if (!mountedRef.current) {\n          for (const Class of Classes) {\n            teardown(Class);\n          }\n        }\n      }, 0);\n    };\n  }, []);  // eslint-disable-line react-hooks/exhaustive-deps\n}\n"],"names":["useRef","useEffect","teardown"],"mappings":";;;;AAQO,SAAS,eACX,SACG;AACN,QAAM,aAAaA,MAAAA,OAAO,KAAK;AAE/BC,QAAAA,UAAU,MAAM;AACd,eAAW,UAAU;AACrB,WAAO,MAAM;AACX,iBAAW,UAAU;AACrB,iBAAW,MAAM;AACf,YAAI,CAAC,WAAW,SAAS;AACvB,qBAAW,SAAS,SAAS;AAC3BC,sBAAAA,SAAS,KAAK;AAAA,UAChB;AAAA,QACF;AAAA,MACF,GAAG,CAAC;AAAA,IACN;AAAA,EACF,GAAG,CAAA,CAAE;AACP;;"}

package/dist/react/use-teardown.js

@@ -0,0 +1,22 @@
+import { useRef, useEffect } from "react";
+import { teardown } from "../singleton.js";
+function useTeardown(...Classes) {
+  const mountedRef = useRef(false);
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      setTimeout(() => {
+        if (!mountedRef.current) {
+          for (const Class of Classes) {
+            teardown(Class);
+          }
+        }
+      }, 0);
+    };
+  }, []);
+}
+export {
+  useTeardown
+};
+//# sourceMappingURL=use-teardown.js.map

package/dist/react/use-teardown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-teardown.js","sources":["../../src/react/use-teardown.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\nimport type { Disposable } from '../types';\nimport { teardown } from '../singleton';\n\n/**\n * Teardown singleton class(es) on unmount.\n * Uses deferred disposal to handle StrictMode's double-mount cycle.\n */\nexport function useTeardown(\n  ...Classes: Array<new (...args: unknown[]) => Disposable>\n): void {\n  const mountedRef = useRef(false);\n\n  useEffect(() => {\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n      setTimeout(() => {\n        if (!mountedRef.current) {\n          for (const Class of Classes) {\n            teardown(Class);\n          }\n        }\n      }, 0);\n    };\n  }, []);  // eslint-disable-line react-hooks/exhaustive-deps\n}\n"],"names":[],"mappings":";;AAQO,SAAS,eACX,SACG;AACN,QAAM,aAAa,OAAO,KAAK;AAE/B,YAAU,MAAM;AACd,eAAW,UAAU;AACrB,WAAO,MAAM;AACX,iBAAW,UAAU;AACrB,iBAAW,MAAM;AACf,YAAI,CAAC,WAAW,SAAS;AACvB,qBAAW,SAAS,SAAS;AAC3B,qBAAS,KAAK;AAAA,UAChB;AAAA,QACF;AAAA,MACF,GAAG,CAAC;AAAA,IACN;AAAA,EACF,GAAG,CAAA,CAAE;AACP;"}

package/dist/react-native/NativeCollection.cjs

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const PersistentCollection = require("../PersistentCollection.cjs");
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+let _adapter = null;
+class NativeCollection extends PersistentCollection.PersistentCollection {
+  /**
+   * Configure the default storage adapter for all NativeCollection subclasses.
+   * Call once at app startup. Per-class method overrides take priority.
+   */
+  static configure(adapter) {
+    _adapter = adapter;
+  }
+  /** Reset the configured adapter (for testing). */
+  static resetAdapter() {
+    _adapter = null;
+  }
+  // ── Per-class override points ──
+  getItem(key) {
+    if (_adapter) return _adapter.getItem(key);
+    if (__DEV__) {
+      throw new Error(
+        `[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`
+      );
+    }
+    throw new Error("[mvc-kit] No storage adapter configured.");
+  }
+  setItem(key, value) {
+    if (_adapter) return _adapter.setItem(key, value);
+    if (__DEV__) {
+      throw new Error(
+        `[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`
+      );
+    }
+    throw new Error("[mvc-kit] No storage adapter configured.");
+  }
+  removeItem(key) {
+    if (_adapter) return _adapter.removeItem(key);
+    if (__DEV__) {
+      throw new Error(
+        `[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`
+      );
+    }
+    throw new Error("[mvc-kit] No storage adapter configured.");
+  }
+  // ── Persist interface (blob strategy) ──
+  async persistGetAll() {
+    const raw = await this.getItem(this.storageKey);
+    if (!raw) return [];
+    try {
+      return this.deserialize(raw);
+    } catch {
+      if (__DEV__) {
+        console.warn(
+          `[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`
+        );
+      }
+      return [];
+    }
+  }
+  async persistGet(id) {
+    const all = await this.persistGetAll();
+    return all.find((i) => i.id === id) ?? null;
+  }
+  async persistSet(_items) {
+    await this.setItem(this.storageKey, this.serialize([...this.items]));
+  }
+  async persistRemove(_ids) {
+    await this.setItem(this.storageKey, this.serialize([...this.items]));
+  }
+  async persistClear() {
+    await this.removeItem(this.storageKey);
+  }
+}
+exports.NativeCollection = NativeCollection;
+//# sourceMappingURL=NativeCollection.cjs.map

package/dist/react-native/NativeCollection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeCollection.cjs","sources":["../../src/react-native/NativeCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\ninterface StorageAdapter {\n  getItem(key: string): Promise<string | null>;\n  setItem(key: string, value: string): Promise<void>;\n  removeItem(key: string): Promise<void>;\n}\n\nlet _adapter: StorageAdapter | null = null;\n\n/**\n * PersistentCollection for React Native, backed by any async key-value store.\n * Uses blob strategy (full state as a single JSON string under `storageKey`).\n *\n * **Requires manual `hydrate()` call** (async storage).\n *\n * ## Setup (once at app startup)\n *\n * ```ts\n * import { NativeCollection } from 'mvc-kit/react-native';\n * import AsyncStorage from '@react-native-async-storage/async-storage';\n *\n * NativeCollection.configure({\n *   getItem: (key) => AsyncStorage.getItem(key),\n *   setItem: (key, value) => AsyncStorage.setItem(key, value),\n *   removeItem: (key) => AsyncStorage.removeItem(key),\n * });\n * ```\n *\n * ## Usage\n *\n * ```ts\n * class TodosCollection extends NativeCollection<Todo> {\n *   protected readonly storageKey = 'todos';\n * }\n * ```\n *\n * ## Per-class override (edge cases)\n *\n * ```ts\n * class SecureCollection extends NativeCollection<Secret> {\n *   protected readonly storageKey = 'secrets';\n *   protected async getItem(key: string) { return SecureStore.getItem(key); }\n *   protected async setItem(key: string, value: string) { await SecureStore.setItem(key, value); }\n *   protected async removeItem(key: string) { await SecureStore.removeItem(key); }\n * }\n * ```\n */\nexport abstract class NativeCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /**\n   * Configure the default storage adapter for all NativeCollection subclasses.\n   * Call once at app startup. Per-class method overrides take priority.\n   */\n  static configure(adapter: StorageAdapter): void {\n    _adapter = adapter;\n  }\n\n  /** Reset the configured adapter (for testing). */\n  static resetAdapter(): void {\n    _adapter = null;\n  }\n\n  // ── Per-class override points ──\n\n  protected getItem(key: string): Promise<string | null> {\n    if (_adapter) return _adapter.getItem(key);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  protected setItem(key: string, value: string): Promise<void> {\n    if (_adapter) return _adapter.setItem(key, value);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  protected removeItem(key: string): Promise<void> {\n    if (_adapter) return _adapter.removeItem(key);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  // ── Persist interface (blob strategy) ──\n\n  protected async persistGetAll(): Promise<T[]> {\n    const raw = await this.getItem(this.storageKey);\n    if (!raw) return [];\n    try {\n      return this.deserialize(raw);\n    } catch {\n      if (__DEV__) {\n        console.warn(\n          `[mvc-kit] Corrupted data in storage key \"${this.storageKey}\". Ignoring stored data.`,\n        );\n      }\n      return [];\n    }\n  }\n\n  protected async persistGet(id: T['id']): Promise<T | null> {\n    const all = await this.persistGetAll();\n    return all.find((i) => i.id === id) ?? null;\n  }\n\n  protected async persistSet(_items: T[]): Promise<void> {\n    await this.setItem(this.storageKey, this.serialize([...this.items]));\n  }\n\n  protected async persistRemove(_ids: T['id'][]): Promise<void> {\n    await this.setItem(this.storageKey, this.serialize([...this.items]));\n  }\n\n  protected async persistClear(): Promise<void> {\n    await this.removeItem(this.storageKey);\n  }\n}\n"],"names":["PersistentCollection"],"mappings":";;;AAEA,MAAM,UAAU,OAAO,oBAAoB,eAAe;AAQ1D,IAAI,WAAkC;AAwC/B,MAAe,yBAEZA,qBAAAA,qBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKhC,OAAO,UAAU,SAA+B;AAC9C,eAAW;AAAA,EACb;AAAA;AAAA,EAGA,OAAO,eAAqB;AAC1B,eAAW;AAAA,EACb;AAAA;AAAA,EAIU,QAAQ,KAAqC;AACrD,QAAI,SAAU,QAAO,SAAS,QAAQ,GAAG;AACzC,QAAI,SAAS;AACX,YAAM,IAAI;AAAA,QACR,gDAAgD,KAAK,YAAY,IAAI;AAAA,MAAA;AAAA,IAGzE;AACA,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AAAA,EAEU,QAAQ,KAAa,OAA8B;AAC3D,QAAI,SAAU,QAAO,SAAS,QAAQ,KAAK,KAAK;AAChD,QAAI,SAAS;AACX,YAAM,IAAI;AAAA,QACR,gDAAgD,KAAK,YAAY,IAAI;AAAA,MAAA;AAAA,IAGzE;AACA,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AAAA,EAEU,WAAW,KAA4B;AAC/C,QAAI,SAAU,QAAO,SAAS,WAAW,GAAG;AAC5C,QAAI,SAAS;AACX,YAAM,IAAI;AAAA,QACR,gDAAgD,KAAK,YAAY,IAAI;AAAA,MAAA;AAAA,IAGzE;AACA,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AAAA;AAAA,EAIA,MAAgB,gBAA8B;AAC5C,UAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,UAAU;AAC9C,QAAI,CAAC,IAAK,QAAO,CAAA;AACjB,QAAI;AACF,aAAO,KAAK,YAAY,GAAG;AAAA,IAC7B,QAAQ;AACN,UAAI,SAAS;AACX,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAE/D;AACA,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAgB,WAAW,IAAgC;AACzD,UAAM,MAAM,MAAM,KAAK,cAAA;AACvB,WAAO,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK;AAAA,EACzC;AAAA,EAEA,MAAgB,WAAW,QAA4B;AACrD,UAAM,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,EACrE;AAAA,EAEA,MAAgB,cAAc,MAAgC;AAC5D,UAAM,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,EACrE;AAAA,EAEA,MAAgB,eAA8B;AAC5C,UAAM,KAAK,WAAW,KAAK,UAAU;AAAA,EACvC;AACF;;"}

package/dist/react-native/NativeCollection.js

@@ -0,0 +1,76 @@
+import { PersistentCollection } from "../PersistentCollection.js";
+const __DEV__ = typeof __MVC_KIT_DEV__ !== "undefined" && __MVC_KIT_DEV__;
+let _adapter = null;
+class NativeCollection extends PersistentCollection {
+  /**
+   * Configure the default storage adapter for all NativeCollection subclasses.
+   * Call once at app startup. Per-class method overrides take priority.
+   */
+  static configure(adapter) {
+    _adapter = adapter;
+  }
+  /** Reset the configured adapter (for testing). */
+  static resetAdapter() {
+    _adapter = null;
+  }
+  // ── Per-class override points ──
+  getItem(key) {
+    if (_adapter) return _adapter.getItem(key);
+    if (__DEV__) {
+      throw new Error(
+        `[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`
+      );
+    }
+    throw new Error("[mvc-kit] No storage adapter configured.");
+  }
+  setItem(key, value) {
+    if (_adapter) return _adapter.setItem(key, value);
+    if (__DEV__) {
+      throw new Error(
+        `[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`
+      );
+    }
+    throw new Error("[mvc-kit] No storage adapter configured.");
+  }
+  removeItem(key) {
+    if (_adapter) return _adapter.removeItem(key);
+    if (__DEV__) {
+      throw new Error(
+        `[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`
+      );
+    }
+    throw new Error("[mvc-kit] No storage adapter configured.");
+  }
+  // ── Persist interface (blob strategy) ──
+  async persistGetAll() {
+    const raw = await this.getItem(this.storageKey);
+    if (!raw) return [];
+    try {
+      return this.deserialize(raw);
+    } catch {
+      if (__DEV__) {
+        console.warn(
+          `[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`
+        );
+      }
+      return [];
+    }
+  }
+  async persistGet(id) {
+    const all = await this.persistGetAll();
+    return all.find((i) => i.id === id) ?? null;
+  }
+  async persistSet(_items) {
+    await this.setItem(this.storageKey, this.serialize([...this.items]));
+  }
+  async persistRemove(_ids) {
+    await this.setItem(this.storageKey, this.serialize([...this.items]));
+  }
+  async persistClear() {
+    await this.removeItem(this.storageKey);
+  }
+}
+export {
+  NativeCollection
+};
+//# sourceMappingURL=NativeCollection.js.map

package/dist/react-native/NativeCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeCollection.js","sources":["../../src/react-native/NativeCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\ninterface StorageAdapter {\n  getItem(key: string): Promise<string | null>;\n  setItem(key: string, value: string): Promise<void>;\n  removeItem(key: string): Promise<void>;\n}\n\nlet _adapter: StorageAdapter | null = null;\n\n/**\n * PersistentCollection for React Native, backed by any async key-value store.\n * Uses blob strategy (full state as a single JSON string under `storageKey`).\n *\n * **Requires manual `hydrate()` call** (async storage).\n *\n * ## Setup (once at app startup)\n *\n * ```ts\n * import { NativeCollection } from 'mvc-kit/react-native';\n * import AsyncStorage from '@react-native-async-storage/async-storage';\n *\n * NativeCollection.configure({\n *   getItem: (key) => AsyncStorage.getItem(key),\n *   setItem: (key, value) => AsyncStorage.setItem(key, value),\n *   removeItem: (key) => AsyncStorage.removeItem(key),\n * });\n * ```\n *\n * ## Usage\n *\n * ```ts\n * class TodosCollection extends NativeCollection<Todo> {\n *   protected readonly storageKey = 'todos';\n * }\n * ```\n *\n * ## Per-class override (edge cases)\n *\n * ```ts\n * class SecureCollection extends NativeCollection<Secret> {\n *   protected readonly storageKey = 'secrets';\n *   protected async getItem(key: string) { return SecureStore.getItem(key); }\n *   protected async setItem(key: string, value: string) { await SecureStore.setItem(key, value); }\n *   protected async removeItem(key: string) { await SecureStore.removeItem(key); }\n * }\n * ```\n */\nexport abstract class NativeCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /**\n   * Configure the default storage adapter for all NativeCollection subclasses.\n   * Call once at app startup. Per-class method overrides take priority.\n   */\n  static configure(adapter: StorageAdapter): void {\n    _adapter = adapter;\n  }\n\n  /** Reset the configured adapter (for testing). */\n  static resetAdapter(): void {\n    _adapter = null;\n  }\n\n  // ── Per-class override points ──\n\n  protected getItem(key: string): Promise<string | null> {\n    if (_adapter) return _adapter.getItem(key);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  protected setItem(key: string, value: string): Promise<void> {\n    if (_adapter) return _adapter.setItem(key, value);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  protected removeItem(key: string): Promise<void> {\n    if (_adapter) return _adapter.removeItem(key);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  // ── Persist interface (blob strategy) ──\n\n  protected async persistGetAll(): Promise<T[]> {\n    const raw = await this.getItem(this.storageKey);\n    if (!raw) return [];\n    try {\n      return this.deserialize(raw);\n    } catch {\n      if (__DEV__) {\n        console.warn(\n          `[mvc-kit] Corrupted data in storage key \"${this.storageKey}\". Ignoring stored data.`,\n        );\n      }\n      return [];\n    }\n  }\n\n  protected async persistGet(id: T['id']): Promise<T | null> {\n    const all = await this.persistGetAll();\n    return all.find((i) => i.id === id) ?? null;\n  }\n\n  protected async persistSet(_items: T[]): Promise<void> {\n    await this.setItem(this.storageKey, this.serialize([...this.items]));\n  }\n\n  protected async persistRemove(_ids: T['id'][]): Promise<void> {\n    await this.setItem(this.storageKey, this.serialize([...this.items]));\n  }\n\n  protected async persistClear(): Promise<void> {\n    await this.removeItem(this.storageKey);\n  }\n}\n"],"names":[],"mappings":";AAEA,MAAM,UAAU,OAAO,oBAAoB,eAAe;AAQ1D,IAAI,WAAkC;AAwC/B,MAAe,yBAEZ,qBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKhC,OAAO,UAAU,SAA+B;AAC9C,eAAW;AAAA,EACb;AAAA;AAAA,EAGA,OAAO,eAAqB;AAC1B,eAAW;AAAA,EACb;AAAA;AAAA,EAIU,QAAQ,KAAqC;AACrD,QAAI,SAAU,QAAO,SAAS,QAAQ,GAAG;AACzC,QAAI,SAAS;AACX,YAAM,IAAI;AAAA,QACR,gDAAgD,KAAK,YAAY,IAAI;AAAA,MAAA;AAAA,IAGzE;AACA,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AAAA,EAEU,QAAQ,KAAa,OAA8B;AAC3D,QAAI,SAAU,QAAO,SAAS,QAAQ,KAAK,KAAK;AAChD,QAAI,SAAS;AACX,YAAM,IAAI;AAAA,QACR,gDAAgD,KAAK,YAAY,IAAI;AAAA,MAAA;AAAA,IAGzE;AACA,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AAAA,EAEU,WAAW,KAA4B;AAC/C,QAAI,SAAU,QAAO,SAAS,WAAW,GAAG;AAC5C,QAAI,SAAS;AACX,YAAM,IAAI;AAAA,QACR,gDAAgD,KAAK,YAAY,IAAI;AAAA,MAAA;AAAA,IAGzE;AACA,UAAM,IAAI,MAAM,0CAA0C;AAAA,EAC5D;AAAA;AAAA,EAIA,MAAgB,gBAA8B;AAC5C,UAAM,MAAM,MAAM,KAAK,QAAQ,KAAK,UAAU;AAC9C,QAAI,CAAC,IAAK,QAAO,CAAA;AACjB,QAAI;AACF,aAAO,KAAK,YAAY,GAAG;AAAA,IAC7B,QAAQ;AACN,UAAI,SAAS;AACX,gBAAQ;AAAA,UACN,4CAA4C,KAAK,UAAU;AAAA,QAAA;AAAA,MAE/D;AACA,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAgB,WAAW,IAAgC;AACzD,UAAM,MAAM,MAAM,KAAK,cAAA;AACvB,WAAO,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK;AAAA,EACzC;AAAA,EAEA,MAAgB,WAAW,QAA4B;AACrD,UAAM,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,EACrE;AAAA,EAEA,MAAgB,cAAc,MAAgC;AAC5D,UAAM,KAAK,QAAQ,KAAK,YAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC;AAAA,EACrE;AAAA,EAEA,MAAgB,eAA8B;AAC5C,UAAM,KAAK,WAAW,KAAK,UAAU;AAAA,EACvC;AACF;"}

package/dist/react-native.cjs

@@ -1,2 +1,5 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./PersistentCollection-B8kNECDj.cjs"),r=typeof __MVC_KIT_DEV__<"u"&&__MVC_KIT_DEV__;let e=null;class a extends s.PersistentCollection{static configure(t){e=t}static resetAdapter(){e=null}getItem(t){if(e)return e.getItem(t);throw r?new Error(`[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`):new Error("[mvc-kit] No storage adapter configured.")}setItem(t,i){if(e)return e.setItem(t,i);throw r?new Error(`[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`):new Error("[mvc-kit] No storage adapter configured.")}removeItem(t){if(e)return e.removeItem(t);throw r?new Error(`[mvc-kit] No storage adapter configured for "${this.constructor.name}". Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`):new Error("[mvc-kit] No storage adapter configured.")}async persistGetAll(){const t=await this.getItem(this.storageKey);if(!t)return[];try{return this.deserialize(t)}catch{return r&&console.warn(`[mvc-kit] Corrupted data in storage key "${this.storageKey}". Ignoring stored data.`),[]}}async persistGet(t){return(await this.persistGetAll()).find(o=>o.id===t)??null}async persistSet(t){await this.setItem(this.storageKey,this.serialize([...this.items]))}async persistRemove(t){await this.setItem(this.storageKey,this.serialize([...this.items]))}async persistClear(){await this.removeItem(this.storageKey)}}exports.NativeCollection=a;
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const NativeCollection = require("./react-native/NativeCollection.cjs");
+exports.NativeCollection = NativeCollection.NativeCollection;
 //# sourceMappingURL=react-native.cjs.map

package/dist/react-native.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"react-native.cjs","sources":["../src/react-native/NativeCollection.ts"],"sourcesContent":["import { PersistentCollection } from '../PersistentCollection';\n\nconst __DEV__ = typeof __MVC_KIT_DEV__ !== 'undefined' && __MVC_KIT_DEV__;\n\ninterface StorageAdapter {\n  getItem(key: string): Promise<string | null>;\n  setItem(key: string, value: string): Promise<void>;\n  removeItem(key: string): Promise<void>;\n}\n\nlet _adapter: StorageAdapter | null = null;\n\n/**\n * PersistentCollection for React Native, backed by any async key-value store.\n * Uses blob strategy (full state as a single JSON string under `storageKey`).\n *\n * **Requires manual `hydrate()` call** (async storage).\n *\n * ## Setup (once at app startup)\n *\n * ```ts\n * import { NativeCollection } from 'mvc-kit/react-native';\n * import AsyncStorage from '@react-native-async-storage/async-storage';\n *\n * NativeCollection.configure({\n *   getItem: (key) => AsyncStorage.getItem(key),\n *   setItem: (key, value) => AsyncStorage.setItem(key, value),\n *   removeItem: (key) => AsyncStorage.removeItem(key),\n * });\n * ```\n *\n * ## Usage\n *\n * ```ts\n * class TodosCollection extends NativeCollection<Todo> {\n *   protected readonly storageKey = 'todos';\n * }\n * ```\n *\n * ## Per-class override (edge cases)\n *\n * ```ts\n * class SecureCollection extends NativeCollection<Secret> {\n *   protected readonly storageKey = 'secrets';\n *   protected async getItem(key: string) { return SecureStore.getItem(key); }\n *   protected async setItem(key: string, value: string) { await SecureStore.setItem(key, value); }\n *   protected async removeItem(key: string) { await SecureStore.removeItem(key); }\n * }\n * ```\n */\nexport abstract class NativeCollection<\n  T extends { id: string | number },\n> extends PersistentCollection<T> {\n  /**\n   * Configure the default storage adapter for all NativeCollection subclasses.\n   * Call once at app startup. Per-class method overrides take priority.\n   */\n  static configure(adapter: StorageAdapter): void {\n    _adapter = adapter;\n  }\n\n  /** Reset the configured adapter (for testing). */\n  static resetAdapter(): void {\n    _adapter = null;\n  }\n\n  // ── Per-class override points ──\n\n  protected getItem(key: string): Promise<string | null> {\n    if (_adapter) return _adapter.getItem(key);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  protected setItem(key: string, value: string): Promise<void> {\n    if (_adapter) return _adapter.setItem(key, value);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  protected removeItem(key: string): Promise<void> {\n    if (_adapter) return _adapter.removeItem(key);\n    if (__DEV__) {\n      throw new Error(\n        `[mvc-kit] No storage adapter configured for \"${this.constructor.name}\". ` +\n          `Call NativeCollection.configure() at app startup, or override getItem/setItem/removeItem.`,\n      );\n    }\n    throw new Error('[mvc-kit] No storage adapter configured.');\n  }\n\n  // ── Persist interface (blob strategy) ──\n\n  protected async persistGetAll(): Promise<T[]> {\n    const raw = await this.getItem(this.storageKey);\n    if (!raw) return [];\n    try {\n      return this.deserialize(raw);\n    } catch {\n      if (__DEV__) {\n        console.warn(\n          `[mvc-kit] Corrupted data in storage key \"${this.storageKey}\". Ignoring stored data.`,\n        );\n      }\n      return [];\n    }\n  }\n\n  protected async persistGet(id: T['id']): Promise<T | null> {\n    const all = await this.persistGetAll();\n    return all.find((i) => i.id === id) ?? null;\n  }\n\n  protected async persistSet(_items: T[]): Promise<void> {\n    await this.setItem(this.storageKey, this.serialize([...this.items]));\n  }\n\n  protected async persistRemove(_ids: T['id'][]): Promise<void> {\n    await this.setItem(this.storageKey, this.serialize([...this.items]));\n  }\n\n  protected async persistClear(): Promise<void> {\n    await this.removeItem(this.storageKey);\n  }\n}\n"],"names":["__DEV__","_adapter","NativeCollection","PersistentCollection","adapter","key","value","raw","id","i","_items","_ids"],"mappings":"uIAEMA,EAAU,OAAO,gBAAoB,KAAe,gBAQ1D,IAAIC,EAAkC,KAwC/B,MAAeC,UAEZC,EAAAA,oBAAwB,CAKhC,OAAO,UAAUC,EAA+B,CAC9CH,EAAWG,CACb,CAGA,OAAO,cAAqB,CAC1BH,EAAW,IACb,CAIU,QAAQI,EAAqC,CACrD,GAAIJ,EAAU,OAAOA,EAAS,QAAQI,CAAG,EACzC,MAAIL,EACI,IAAI,MACR,gDAAgD,KAAK,YAAY,IAAI,8FAAA,EAInE,IAAI,MAAM,0CAA0C,CAC5D,CAEU,QAAQK,EAAaC,EAA8B,CAC3D,GAAIL,EAAU,OAAOA,EAAS,QAAQI,EAAKC,CAAK,EAChD,MAAIN,EACI,IAAI,MACR,gDAAgD,KAAK,YAAY,IAAI,8FAAA,EAInE,IAAI,MAAM,0CAA0C,CAC5D,CAEU,WAAWK,EAA4B,CAC/C,GAAIJ,EAAU,OAAOA,EAAS,WAAWI,CAAG,EAC5C,MAAIL,EACI,IAAI,MACR,gDAAgD,KAAK,YAAY,IAAI,8FAAA,EAInE,IAAI,MAAM,0CAA0C,CAC5D,CAIA,MAAgB,eAA8B,CAC5C,MAAMO,EAAM,MAAM,KAAK,QAAQ,KAAK,UAAU,EAC9C,GAAI,CAACA,EAAK,MAAO,CAAA,EACjB,GAAI,CACF,OAAO,KAAK,YAAYA,CAAG,CAC7B,MAAQ,CACN,OAAIP,GACF,QAAQ,KACN,4CAA4C,KAAK,UAAU,0BAAA,EAGxD,CAAA,CACT,CACF,CAEA,MAAgB,WAAWQ,EAAgC,CAEzD,OADY,MAAM,KAAK,cAAA,GACZ,KAAMC,GAAMA,EAAE,KAAOD,CAAE,GAAK,IACzC,CAEA,MAAgB,WAAWE,EAA4B,CACrD,MAAM,KAAK,QAAQ,KAAK,WAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CACrE,CAEA,MAAgB,cAAcC,EAAgC,CAC5D,MAAM,KAAK,QAAQ,KAAK,WAAY,KAAK,UAAU,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CACrE,CAEA,MAAgB,cAA8B,CAC5C,MAAM,KAAK,WAAW,KAAK,UAAU,CACvC,CACF"}
+{"version":3,"file":"react-native.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}