gjendje 0.1.0

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts"],"names":["state","useSyncExternalStore","useCallback","useReactState","useEffect","collection"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useCallback, useEffect, useState as useReactState, useSyncExternalStore } from 'react'\nimport type { BucketOptions, CollectionInstance, StateInstance, StateOptions } from '../index.js'\nimport { collection, state } from '../index.js'\n\n// ---------------------------------------------------------------------------\n// useStore — primary hook\n//\n// Returns [value, setter] just like React's useState, but scoped and\n// persistent. The same key + scope returns the same instance everywhere —\n// safe to call from multiple components simultaneously.\n//\n// For bucket scope, the hook starts with the default value and updates\n// automatically once the bucket has initialized.\n//\n// ```tsx\n// const [theme, setTheme] = useStore('theme', {\n//   default: 'light',\n//   scope: 'local',\n// })\n//\n// // With storage bucket — isolated, expirable storage\n// const [prefs, setPrefs] = useStore('prefs', {\n//   default: { theme: 'light' },\n//   scope: 'bucket',\n//   bucket: { name: 'user-prefs', expires: '30d', persisted: true },\n// })\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useStore<T>(\n\tkey: string,\n\toptions: StateOptions<T>,\n): [T, (value: T | ((prev: T) => T)) => void] {\n\tconst instance = state(key, options)\n\n\tconst value = useSyncExternalStore(\n\t\tuseCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),\n\t\t() => instance.get(),\n\t\t() => options.default,\n\t)\n\n\tconst set = useCallback(\n\t\t(valueOrUpdater: T | ((prev: T) => T)) => {\n\t\t\tinstance.set(valueOrUpdater)\n\t\t},\n\t\t[instance],\n\t)\n\n\treturn [value, set]\n}\n\n// ---------------------------------------------------------------------------\n// useStateInstance — access the full instance\n//\n// Use when you need peek(), watch(), reset(), ready, or want to pass\n// the instance to child components or utility functions.\n// ---------------------------------------------------------------------------\n\nexport function useStateInstance<T>(key: string, options: StateOptions<T>): StateInstance<T> {\n\tconst instance = state(key, options)\n\n\tuseSyncExternalStore(\n\t\tuseCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),\n\t\t() => instance.get(),\n\t\t() => options.default,\n\t)\n\n\treturn instance\n}\n\n// ---------------------------------------------------------------------------\n// useSharedState — consume a module-level instance\n//\n// The recommended pattern for app-wide shared state. Define once at\n// module level, consume anywhere.\n//\n// ```ts\n// // state.ts\n// export const themeState = state('theme', {\n//   default: 'light',\n//   scope: 'local',\n// })\n//\n// // ThemeToggle.tsx\n// const [theme, setTheme] = useSharedState(themeState)\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useSharedState<T>(\n\tinstance: StateInstance<T>,\n): [T, (value: T | ((prev: T) => T)) => void] {\n\tconst value = useSyncExternalStore(\n\t\tuseCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),\n\t\t() => instance.get(),\n\t\t() => instance.get(),\n\t)\n\n\tconst set = useCallback(\n\t\t(valueOrUpdater: T | ((prev: T) => T)) => {\n\t\t\tinstance.set(valueOrUpdater)\n\t\t},\n\t\t[instance],\n\t)\n\n\treturn [value, set]\n}\n\n// ---------------------------------------------------------------------------\n// useWatch — subscribe to a specific key within object state\n//\n// Only triggers a re-render when the watched key changes, not on every\n// update to the parent object.\n//\n// ```tsx\n// const theme = useWatch(prefsState, 'theme')\n// // re-renders only when prefs.theme changes\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useWatch<T extends object, K extends keyof T>(\n\tinstance: StateInstance<T>,\n\tkey: K,\n): T[K] {\n\tconst getSnapshot = useCallback(() => instance.get()[key], [instance, key])\n\n\treturn useSyncExternalStore(\n\t\tuseCallback(\n\t\t\t(onStoreChange) => {\n\t\t\t\t// biome-ignore lint/suspicious/noExplicitAny: conditional keyof type doesn't narrow here\n\t\t\t\treturn (instance.watch as any)(key, onStoreChange)\n\t\t\t},\n\t\t\t[instance, key],\n\t\t),\n\t\tgetSnapshot,\n\t)\n}\n\n// ---------------------------------------------------------------------------\n// useReady — resolves to true once an async scope (e.g. bucket) is ready\n//\n// Useful for showing loading states while a bucket initializes.\n//\n// ```tsx\n// const isReady = useReady(prefsState)\n//\n// if (!isReady) return <Skeleton />\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useReady(instance: StateInstance<unknown>): boolean {\n\tconst [isReady, setIsReady] = useReactState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\n\t\tinstance.ready\n\t\t\t.then(() => {\n\t\t\t\tif (!cancelled) setIsReady(true)\n\t\t\t})\n\t\t\t.catch(() => {})\n\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [instance])\n\n\treturn isReady\n}\n\n// ---------------------------------------------------------------------------\n// useSettled — resolves to true once the most recent write has persisted\n//\n// ```tsx\n// const isSettled = useSettled(prefsState)\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useSettled(instance: StateInstance<unknown>): boolean {\n\tconst [isSettled, setIsSettled] = useReactState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\n\t\tsetIsSettled(false)\n\n\t\tinstance.settled\n\t\t\t.then(() => {\n\t\t\t\tif (!cancelled) setIsSettled(true)\n\t\t\t})\n\t\t\t.catch(() => {})\n\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [instance])\n\n\treturn isSettled\n}\n\n// ---------------------------------------------------------------------------\n// useHydrated — resolves to true once SSR hydration is complete\n//\n// ```tsx\n// const isHydrated = useHydrated(themeState)\n//\n// if (!isHydrated) return <Skeleton />\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useHydrated(instance: StateInstance<unknown>): boolean {\n\tconst [isHydrated, setIsHydrated] = useReactState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\n\t\tinstance.hydrated\n\t\t\t.then(() => {\n\t\t\t\tif (!cancelled) setIsHydrated(true)\n\t\t\t})\n\t\t\t.catch(() => {})\n\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [instance])\n\n\treturn isHydrated\n}\n\n// ---------------------------------------------------------------------------\n// useBucket — open a named storage bucket and get state bound to it\n//\n// A convenience hook that combines useStore with bucket scope, making\n// the bucket options co-located with the component that needs them.\n//\n// Returns [value, setter, isReady] — isReady is false until the bucket\n// has initialized and real stored values are available.\n//\n// ```tsx\n// const [prefs, setPrefs, isReady] = useBucket('prefs', {\n//   default: { theme: 'light', fontSize: 14 },\n//   bucket: { name: 'user-prefs', expires: '30d', persisted: true },\n// })\n//\n// if (!isReady) return <Skeleton />\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useBucket<T>(\n\tkey: string,\n\toptions: Omit<StateOptions<T>, 'scope'> & { bucket: BucketOptions },\n): [T, (value: T | ((prev: T) => T)) => void, boolean] {\n\tconst mergedOptions = { ...options, scope: 'bucket' as const }\n\n\t// state() returns the same instance for the same key+scope via the registry\n\tconst instance = state(key, mergedOptions)\n\n\tconst [value, set] = useStore(key, mergedOptions)\n\n\tconst isReady = useReady(instance as StateInstance<unknown>)\n\n\treturn [value, set, isReady]\n}\n\n// ---------------------------------------------------------------------------\n// useCollection — reactive array state with mutation methods\n//\n// Returns the full CollectionInstance so add, remove, update etc. are\n// all directly available. Re-renders when the array changes.\n//\n// ```tsx\n// const todos = useCollection('todos', {\n//   default: [] as Todo[],\n//   scope: 'local',\n// })\n//\n// todos.add({ id: '1', text: 'hello', done: false })\n// todos.remove((t) => t.done)\n// todos.get()  // Todo[]\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useCollection<T>(key: string, options: StateOptions<T[]>): CollectionInstance<T> {\n\tconst col = collection(key, options)\n\n\tuseSyncExternalStore(\n\t\tuseCallback((onStoreChange) => col.subscribe(onStoreChange), [col]),\n\t\t() => col.get(),\n\t\t() => options.default,\n\t)\n\n\treturn col\n}\n\n// ---------------------------------------------------------------------------\n// Re-exports\n// ---------------------------------------------------------------------------\n\nexport type {\n\tBucketOptions,\n\tReadonlyInstance,\n\tScope,\n\tStateInstance,\n\tStateOptions,\n} from '../index.js'\nexport { batch, collection, computed, effect, state, withServerSession } from '../index.js'\n"]}

package/dist/react/index.d.cts

@@ -0,0 +1,16 @@
+import { f as StateOptions, a as BucketOptions, C as CollectionInstance, e as StateInstance } from '../factory-CIj-6WlO.cjs';
+export { R as ReadonlyInstance, S as Scope, g as batch, h as collection, i as computed, j as effect, s as state, w as withServerSession } from '../factory-CIj-6WlO.cjs';
+
+declare function useStore<T>(key: string, options: StateOptions<T>): [T, (value: T | ((prev: T) => T)) => void];
+declare function useStateInstance<T>(key: string, options: StateOptions<T>): StateInstance<T>;
+declare function useSharedState<T>(instance: StateInstance<T>): [T, (value: T | ((prev: T) => T)) => void];
+declare function useWatch<T extends object, K extends keyof T>(instance: StateInstance<T>, key: K): T[K];
+declare function useReady(instance: StateInstance<unknown>): boolean;
+declare function useSettled(instance: StateInstance<unknown>): boolean;
+declare function useHydrated(instance: StateInstance<unknown>): boolean;
+declare function useBucket<T>(key: string, options: Omit<StateOptions<T>, 'scope'> & {
+    bucket: BucketOptions;
+}): [T, (value: T | ((prev: T) => T)) => void, boolean];
+declare function useCollection<T>(key: string, options: StateOptions<T[]>): CollectionInstance<T>;
+
+export { BucketOptions, StateInstance, StateOptions, useBucket, useCollection, useHydrated, useReady, useSettled, useSharedState, useStateInstance, useStore, useWatch };

package/dist/react/index.d.ts

@@ -0,0 +1,16 @@
+import { f as StateOptions, a as BucketOptions, C as CollectionInstance, e as StateInstance } from '../factory-CIj-6WlO.js';
+export { R as ReadonlyInstance, S as Scope, g as batch, h as collection, i as computed, j as effect, s as state, w as withServerSession } from '../factory-CIj-6WlO.js';
+
+declare function useStore<T>(key: string, options: StateOptions<T>): [T, (value: T | ((prev: T) => T)) => void];
+declare function useStateInstance<T>(key: string, options: StateOptions<T>): StateInstance<T>;
+declare function useSharedState<T>(instance: StateInstance<T>): [T, (value: T | ((prev: T) => T)) => void];
+declare function useWatch<T extends object, K extends keyof T>(instance: StateInstance<T>, key: K): T[K];
+declare function useReady(instance: StateInstance<unknown>): boolean;
+declare function useSettled(instance: StateInstance<unknown>): boolean;
+declare function useHydrated(instance: StateInstance<unknown>): boolean;
+declare function useBucket<T>(key: string, options: Omit<StateOptions<T>, 'scope'> & {
+    bucket: BucketOptions;
+}): [T, (value: T | ((prev: T) => T)) => void, boolean];
+declare function useCollection<T>(key: string, options: StateOptions<T[]>): CollectionInstance<T>;
+
+export { BucketOptions, StateInstance, StateOptions, useBucket, useCollection, useHydrated, useReady, useSettled, useSharedState, useStateInstance, useStore, useWatch };

package/dist/react/index.js

@@ -0,0 +1,117 @@
+import { state, collection } from '../chunk-347V4L7H.js';
+export { batch, collection, computed, effect, state, withServerSession } from '../chunk-347V4L7H.js';
+import { useSyncExternalStore, useCallback, useState, useEffect } from 'react';
+
+function useStore(key, options) {
+  const instance = state(key, options);
+  const value = useSyncExternalStore(
+    useCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),
+    () => instance.get(),
+    () => options.default
+  );
+  const set = useCallback(
+    (valueOrUpdater) => {
+      instance.set(valueOrUpdater);
+    },
+    [instance]
+  );
+  return [value, set];
+}
+function useStateInstance(key, options) {
+  const instance = state(key, options);
+  useSyncExternalStore(
+    useCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),
+    () => instance.get(),
+    () => options.default
+  );
+  return instance;
+}
+function useSharedState(instance) {
+  const value = useSyncExternalStore(
+    useCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),
+    () => instance.get(),
+    () => instance.get()
+  );
+  const set = useCallback(
+    (valueOrUpdater) => {
+      instance.set(valueOrUpdater);
+    },
+    [instance]
+  );
+  return [value, set];
+}
+function useWatch(instance, key) {
+  const getSnapshot = useCallback(() => instance.get()[key], [instance, key]);
+  return useSyncExternalStore(
+    useCallback(
+      (onStoreChange) => {
+        return instance.watch(key, onStoreChange);
+      },
+      [instance, key]
+    ),
+    getSnapshot
+  );
+}
+function useReady(instance) {
+  const [isReady, setIsReady] = useState(false);
+  useEffect(() => {
+    let cancelled = false;
+    instance.ready.then(() => {
+      if (!cancelled) setIsReady(true);
+    }).catch(() => {
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [instance]);
+  return isReady;
+}
+function useSettled(instance) {
+  const [isSettled, setIsSettled] = useState(false);
+  useEffect(() => {
+    let cancelled = false;
+    setIsSettled(false);
+    instance.settled.then(() => {
+      if (!cancelled) setIsSettled(true);
+    }).catch(() => {
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [instance]);
+  return isSettled;
+}
+function useHydrated(instance) {
+  const [isHydrated, setIsHydrated] = useState(false);
+  useEffect(() => {
+    let cancelled = false;
+    instance.hydrated.then(() => {
+      if (!cancelled) setIsHydrated(true);
+    }).catch(() => {
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [instance]);
+  return isHydrated;
+}
+function useBucket(key, options) {
+  const mergedOptions = { ...options, scope: "bucket" };
+  const instance = state(key, mergedOptions);
+  const [value, set] = useStore(key, mergedOptions);
+  const isReady = useReady(instance);
+  return [value, set, isReady];
+}
+function useCollection(key, options) {
+  const col = collection(key, options);
+  useSyncExternalStore(
+    useCallback((onStoreChange) => col.subscribe(onStoreChange), [col]),
+    () => col.get(),
+    () => options.default
+  );
+  return col;
+}
+
+export { useBucket, useCollection, useHydrated, useReady, useSettled, useSharedState, useStateInstance, useStore, useWatch };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/index.ts"],"names":["useReactState"],"mappings":"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","file":"index.js","sourcesContent":["import { useCallback, useEffect, useState as useReactState, useSyncExternalStore } from 'react'\nimport type { BucketOptions, CollectionInstance, StateInstance, StateOptions } from '../index.js'\nimport { collection, state } from '../index.js'\n\n// ---------------------------------------------------------------------------\n// useStore — primary hook\n//\n// Returns [value, setter] just like React's useState, but scoped and\n// persistent. The same key + scope returns the same instance everywhere —\n// safe to call from multiple components simultaneously.\n//\n// For bucket scope, the hook starts with the default value and updates\n// automatically once the bucket has initialized.\n//\n// ```tsx\n// const [theme, setTheme] = useStore('theme', {\n//   default: 'light',\n//   scope: 'local',\n// })\n//\n// // With storage bucket — isolated, expirable storage\n// const [prefs, setPrefs] = useStore('prefs', {\n//   default: { theme: 'light' },\n//   scope: 'bucket',\n//   bucket: { name: 'user-prefs', expires: '30d', persisted: true },\n// })\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useStore<T>(\n\tkey: string,\n\toptions: StateOptions<T>,\n): [T, (value: T | ((prev: T) => T)) => void] {\n\tconst instance = state(key, options)\n\n\tconst value = useSyncExternalStore(\n\t\tuseCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),\n\t\t() => instance.get(),\n\t\t() => options.default,\n\t)\n\n\tconst set = useCallback(\n\t\t(valueOrUpdater: T | ((prev: T) => T)) => {\n\t\t\tinstance.set(valueOrUpdater)\n\t\t},\n\t\t[instance],\n\t)\n\n\treturn [value, set]\n}\n\n// ---------------------------------------------------------------------------\n// useStateInstance — access the full instance\n//\n// Use when you need peek(), watch(), reset(), ready, or want to pass\n// the instance to child components or utility functions.\n// ---------------------------------------------------------------------------\n\nexport function useStateInstance<T>(key: string, options: StateOptions<T>): StateInstance<T> {\n\tconst instance = state(key, options)\n\n\tuseSyncExternalStore(\n\t\tuseCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),\n\t\t() => instance.get(),\n\t\t() => options.default,\n\t)\n\n\treturn instance\n}\n\n// ---------------------------------------------------------------------------\n// useSharedState — consume a module-level instance\n//\n// The recommended pattern for app-wide shared state. Define once at\n// module level, consume anywhere.\n//\n// ```ts\n// // state.ts\n// export const themeState = state('theme', {\n//   default: 'light',\n//   scope: 'local',\n// })\n//\n// // ThemeToggle.tsx\n// const [theme, setTheme] = useSharedState(themeState)\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useSharedState<T>(\n\tinstance: StateInstance<T>,\n): [T, (value: T | ((prev: T) => T)) => void] {\n\tconst value = useSyncExternalStore(\n\t\tuseCallback((onStoreChange) => instance.subscribe(onStoreChange), [instance]),\n\t\t() => instance.get(),\n\t\t() => instance.get(),\n\t)\n\n\tconst set = useCallback(\n\t\t(valueOrUpdater: T | ((prev: T) => T)) => {\n\t\t\tinstance.set(valueOrUpdater)\n\t\t},\n\t\t[instance],\n\t)\n\n\treturn [value, set]\n}\n\n// ---------------------------------------------------------------------------\n// useWatch — subscribe to a specific key within object state\n//\n// Only triggers a re-render when the watched key changes, not on every\n// update to the parent object.\n//\n// ```tsx\n// const theme = useWatch(prefsState, 'theme')\n// // re-renders only when prefs.theme changes\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useWatch<T extends object, K extends keyof T>(\n\tinstance: StateInstance<T>,\n\tkey: K,\n): T[K] {\n\tconst getSnapshot = useCallback(() => instance.get()[key], [instance, key])\n\n\treturn useSyncExternalStore(\n\t\tuseCallback(\n\t\t\t(onStoreChange) => {\n\t\t\t\t// biome-ignore lint/suspicious/noExplicitAny: conditional keyof type doesn't narrow here\n\t\t\t\treturn (instance.watch as any)(key, onStoreChange)\n\t\t\t},\n\t\t\t[instance, key],\n\t\t),\n\t\tgetSnapshot,\n\t)\n}\n\n// ---------------------------------------------------------------------------\n// useReady — resolves to true once an async scope (e.g. bucket) is ready\n//\n// Useful for showing loading states while a bucket initializes.\n//\n// ```tsx\n// const isReady = useReady(prefsState)\n//\n// if (!isReady) return <Skeleton />\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useReady(instance: StateInstance<unknown>): boolean {\n\tconst [isReady, setIsReady] = useReactState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\n\t\tinstance.ready\n\t\t\t.then(() => {\n\t\t\t\tif (!cancelled) setIsReady(true)\n\t\t\t})\n\t\t\t.catch(() => {})\n\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [instance])\n\n\treturn isReady\n}\n\n// ---------------------------------------------------------------------------\n// useSettled — resolves to true once the most recent write has persisted\n//\n// ```tsx\n// const isSettled = useSettled(prefsState)\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useSettled(instance: StateInstance<unknown>): boolean {\n\tconst [isSettled, setIsSettled] = useReactState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\n\t\tsetIsSettled(false)\n\n\t\tinstance.settled\n\t\t\t.then(() => {\n\t\t\t\tif (!cancelled) setIsSettled(true)\n\t\t\t})\n\t\t\t.catch(() => {})\n\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [instance])\n\n\treturn isSettled\n}\n\n// ---------------------------------------------------------------------------\n// useHydrated — resolves to true once SSR hydration is complete\n//\n// ```tsx\n// const isHydrated = useHydrated(themeState)\n//\n// if (!isHydrated) return <Skeleton />\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useHydrated(instance: StateInstance<unknown>): boolean {\n\tconst [isHydrated, setIsHydrated] = useReactState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\n\t\tinstance.hydrated\n\t\t\t.then(() => {\n\t\t\t\tif (!cancelled) setIsHydrated(true)\n\t\t\t})\n\t\t\t.catch(() => {})\n\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [instance])\n\n\treturn isHydrated\n}\n\n// ---------------------------------------------------------------------------\n// useBucket — open a named storage bucket and get state bound to it\n//\n// A convenience hook that combines useStore with bucket scope, making\n// the bucket options co-located with the component that needs them.\n//\n// Returns [value, setter, isReady] — isReady is false until the bucket\n// has initialized and real stored values are available.\n//\n// ```tsx\n// const [prefs, setPrefs, isReady] = useBucket('prefs', {\n//   default: { theme: 'light', fontSize: 14 },\n//   bucket: { name: 'user-prefs', expires: '30d', persisted: true },\n// })\n//\n// if (!isReady) return <Skeleton />\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useBucket<T>(\n\tkey: string,\n\toptions: Omit<StateOptions<T>, 'scope'> & { bucket: BucketOptions },\n): [T, (value: T | ((prev: T) => T)) => void, boolean] {\n\tconst mergedOptions = { ...options, scope: 'bucket' as const }\n\n\t// state() returns the same instance for the same key+scope via the registry\n\tconst instance = state(key, mergedOptions)\n\n\tconst [value, set] = useStore(key, mergedOptions)\n\n\tconst isReady = useReady(instance as StateInstance<unknown>)\n\n\treturn [value, set, isReady]\n}\n\n// ---------------------------------------------------------------------------\n// useCollection — reactive array state with mutation methods\n//\n// Returns the full CollectionInstance so add, remove, update etc. are\n// all directly available. Re-renders when the array changes.\n//\n// ```tsx\n// const todos = useCollection('todos', {\n//   default: [] as Todo[],\n//   scope: 'local',\n// })\n//\n// todos.add({ id: '1', text: 'hello', done: false })\n// todos.remove((t) => t.done)\n// todos.get()  // Todo[]\n// ```\n// ---------------------------------------------------------------------------\n\nexport function useCollection<T>(key: string, options: StateOptions<T[]>): CollectionInstance<T> {\n\tconst col = collection(key, options)\n\n\tuseSyncExternalStore(\n\t\tuseCallback((onStoreChange) => col.subscribe(onStoreChange), [col]),\n\t\t() => col.get(),\n\t\t() => options.default,\n\t)\n\n\treturn col\n}\n\n// ---------------------------------------------------------------------------\n// Re-exports\n// ---------------------------------------------------------------------------\n\nexport type {\n\tBucketOptions,\n\tReadonlyInstance,\n\tScope,\n\tStateInstance,\n\tStateOptions,\n} from '../index.js'\nexport { batch, collection, computed, effect, state, withServerSession } from '../index.js'\n"]}

package/package.json

@@ -0,0 +1,103 @@
+{
+	"name": "gjendje",
+	"version": "0.1.0",
+	"description": "gjendje brings state management to multiple storage backends through one consistent API",
+	"keywords": [
+		"state",
+		"storage",
+		"reactive",
+		"persistence",
+		"typescript",
+		"localStorage",
+		"storageBuckets",
+		"react"
+	],
+	"author": "Charlie Beckstrand",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/charliebeckstrand/gjendje.git"
+	},
+	"homepage": "https://github.com/charliebeckstrand/gjendje#readme",
+	"bugs": {
+		"url": "https://github.com/charliebeckstrand/gjendje/issues"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"packageManager": "pnpm@9.0.0",
+	"type": "module",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		},
+		"./react": {
+			"import": {
+				"types": "./dist/react/index.d.ts",
+				"default": "./dist/react/index.js"
+			},
+			"require": {
+				"types": "./dist/react/index.d.cts",
+				"default": "./dist/react/index.cjs"
+			}
+		}
+	},
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"format": "biome format --write src/ __tests__/",
+		"lint": "biome check src/ __tests__/",
+		"lint:check": "biome ci src/ __tests__/",
+		"lint:fix": "biome check src/ __tests__/ --fix",
+		"prepare": "lefthook install",
+		"prepublishOnly": "pnpm typecheck && pnpm lint:check && pnpm test && pnpm build && pnpm publint",
+		"release": "pnpm build && pnpm changeset publish",
+		"size": "size-limit",
+		"test": "vitest run",
+		"test:coverage": "vitest run --coverage",
+		"test:watch": "vitest",
+		"typecheck": "tsc --project tsconfig.test.json --skipLibCheck"
+	},
+	"peerDependencies": {
+		"react": "^18.0.0 || ^19.0.0"
+	},
+	"peerDependenciesMeta": {
+		"react": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.6",
+		"@changesets/cli": "^2.27.0",
+		"@size-limit/preset-small-lib": "^11.0.0",
+		"@testing-library/react": "^16.0.0",
+		"@types/node": "^20.0.0",
+		"@types/react": "^19.0.0",
+		"@types/react-dom": "^19.0.0",
+		"@vitest/coverage-v8": "^4.0.0",
+		"happy-dom": "^14.0.0",
+		"publint": "^0.3.0",
+		"react": "^19.0.0",
+		"react-dom": "^19.0.0",
+		"size-limit": "^11.0.0",
+		"tsup": "^8.0.0",
+		"typescript": "^5.4.0",
+		"vite": "^6.0.0",
+		"vitest": "^4.0.0",
+		"lefthook": "^1.6.0"
+	}
+}