gjendje 0.6.0 → 0.7.0

package/README.md

@@ -2,7 +2,7 @@
 
 # gjendje
 
-Every app juggles localStorage, sessionStorage, URL params, and in-memory state — each with its own API. **gjendje** replaces it all with a single primitive. Choose where state lives. The rest is handled.
+Every app juggles localStorage, sessionStorage, URL params, and in-memory state. gjendje replaces that all with a unified API. Choose where state lives. The rest is handled.
 
 ## Install
 
@@ -12,35 +12,30 @@ npm install gjendje
 
 ## Quick start
 
-```ts
-import { local, session, url, bucket, server } from 'gjendje'
-
-// localStorage — survives refresh, works across tabs
-const theme = local({ theme: 'light' })
+You can pass the scope as an option:
 
-// sessionStorage — survives refresh, gone when tab closes
-const draft = session({ draft: '' })
+```ts
+import { state } from 'gjendje'
 
-// URL params — shareable via address bar
-const filters = url({ q: '' })
+const theme = state({ theme: 'light' }, { scope: 'local' })
+```
 
-// Storage Bucket — isolated, quota-managed, expirable
-const cache = bucket({ cache: [] }, { bucket: { name: 'app-cache', expires: '7d' } })
+Or use dot notation as a shorthand:
 
-// AsyncLocalStorage — server-side, session-scoped
-const user = server({ user: null })
+```ts
+const theme = state.local({ theme: 'light' })
 ```
 
-For in-memory state that doesn't persist, use `state` directly:
+For in-memory state that doesn't persist, call `state` without a scope:
 
 ```ts
-import { state } from 'gjendje'
-
 const counter = state({ counter: 0 })
 
 counter.set((prev) => prev + 1)
 ```
 
+[See all scopes and examples](https://github.com/charliebeckstrand/gjendje/blob/main/docs/scopes.md)
+
 ## Configure
 
 Sets global defaults for all state instances.
@@ -64,20 +59,20 @@ theme.scope // 'local' — derived from configure
 
 ## Scopes
 
-| Scope    | Backend              | Shortcut    |
-|----------|----------------------|-------------|
-| `memory` | In-memory            | `state()`   |
-| `local`  | `localStorage`       | `local()`   |
-| `tab`    | `sessionStorage`     | `session()` |
-| `url`    | `URLSearchParams`    | `url()`     |
-| `bucket` | Storage Buckets API  | `bucket()`  |
-| `server` | `AsyncLocalStorage`  | `server()`  |
+| Scope    | Backend              | Shortcut           |
+|----------|----------------------|--------------------|
+| `memory`  | In-memory            | `state()`          |
+| `local`   | `localStorage`       | `state.local()`    |
+| `session` | `sessionStorage`     | `state.session()`  |
+| `url`     | `URLSearchParams`    | `state.url()`      |
+| `bucket`  | Storage Buckets API  | `state.bucket()`   |
+| `server`  | `AsyncLocalStorage`  | `state.server()`   |
 
 [Scope decision guide](https://github.com/charliebeckstrand/gjendje/blob/main/docs/scopes.md)
 
 ## API
 
-Every primitive — `state`, `local`, `session`, `url`, `bucket`, and `server` — shares the same core API: `get`, `set`, `reset`, `subscribe`, `watch`, `intercept`, and more.
+Every scope — `state.local`, `state.session`, `state.url`, `state.bucket`, and `state.server` — shares the same core API: `get`, `set`, `reset`, `subscribe`, `watch`, `intercept`, and more.
 
 [Full API reference](https://github.com/charliebeckstrand/gjendje/blob/main/docs/api.md) · [Persistence reference](https://github.com/charliebeckstrand/gjendje/blob/main/docs/persistence.md)
 

package/dist/{chunk-5J2W34MR.js → chunk-G6M5RUNT.js}

@@ -590,7 +590,7 @@ function createUrlAdapter(key, defaultValue, serializer, persist) {
 function isServer() {
   return typeof window === "undefined" || typeof document === "undefined";
 }
-var BROWSER_SCOPES = /* @__PURE__ */ new Set(["tab", "local", "url", "bucket"]);
+var BROWSER_SCOPES = /* @__PURE__ */ new Set(["session", "tab", "local", "url", "bucket"]);
 function afterHydration(fn) {
   if (isServer()) return Promise.resolve();
   return new Promise((resolve) => {
@@ -615,7 +615,7 @@ var _serverAdapterFactory;
 function registerServerAdapter(factory) {
   _serverAdapterFactory = factory;
 }
-var PERSISTENT_SCOPES = /* @__PURE__ */ new Set(["local", "tab", "bucket"]);
+var PERSISTENT_SCOPES = /* @__PURE__ */ new Set(["local", "session", "tab", "bucket"]);
 var SYNCABLE_SCOPES = /* @__PURE__ */ new Set(["local", "bucket"]);
 var RESOLVED2 = Promise.resolve();
 var RENDER_SHIM = {
@@ -636,6 +636,7 @@ function resolveAdapter(storageKey, scope, options) {
     case "memory":
     case "render":
       return createRenderAdapter(options.default);
+    case "session":
     case "tab":
       if (typeof sessionStorage === "undefined") {
         throw new Error(
@@ -995,7 +996,7 @@ function createBase(key, options) {
     );
   }
   const rawScope = options.scope ?? config.scope ?? "render";
-  const scope = rawScope === "memory" ? "render" : rawScope;
+  const scope = rawScope === "memory" ? "render" : rawScope === "session" ? "tab" : rawScope;
   const rKey = scopedKey(key, scope);
   const existing = getRegistered(rKey);
   if (existing && !existing.isDestroyed) return existing;

package/dist/{chunk-IC7SQVDX.cjs → chunk-PP6KNY6S.cjs}

@@ -592,7 +592,7 @@ function createUrlAdapter(key, defaultValue, serializer, persist) {
 function isServer() {
   return typeof window === "undefined" || typeof document === "undefined";
 }
-var BROWSER_SCOPES = /* @__PURE__ */ new Set(["tab", "local", "url", "bucket"]);
+var BROWSER_SCOPES = /* @__PURE__ */ new Set(["session", "tab", "local", "url", "bucket"]);
 function afterHydration(fn) {
   if (isServer()) return Promise.resolve();
   return new Promise((resolve) => {
@@ -617,7 +617,7 @@ var _serverAdapterFactory;
 function registerServerAdapter(factory) {
   _serverAdapterFactory = factory;
 }
-var PERSISTENT_SCOPES = /* @__PURE__ */ new Set(["local", "tab", "bucket"]);
+var PERSISTENT_SCOPES = /* @__PURE__ */ new Set(["local", "session", "tab", "bucket"]);
 var SYNCABLE_SCOPES = /* @__PURE__ */ new Set(["local", "bucket"]);
 var RESOLVED2 = Promise.resolve();
 var RENDER_SHIM = {
@@ -638,6 +638,7 @@ function resolveAdapter(storageKey, scope, options) {
     case "memory":
     case "render":
       return createRenderAdapter(options.default);
+    case "session":
     case "tab":
       if (typeof sessionStorage === "undefined") {
         throw new Error(
@@ -997,7 +998,7 @@ function createBase(key, options) {
     );
   }
   const rawScope = options.scope ?? config.scope ?? "render";
-  const scope = rawScope === "memory" ? "render" : rawScope;
+  const scope = rawScope === "memory" ? "render" : rawScope === "session" ? "tab" : rawScope;
   const rKey = scopedKey(key, scope);
   const existing = getRegistered(rKey);
   if (existing && !existing.isDestroyed) return existing;

package/dist/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkIC7SQVDX_cjs = require('./chunk-IC7SQVDX.cjs');
+var chunkPP6KNY6S_cjs = require('./chunk-PP6KNY6S.cjs');
 
 // src/collection.ts
 function collection(key, options) {
-  const base = chunkIC7SQVDX_cjs.createBase(key, options);
+  const base = chunkPP6KNY6S_cjs.createBase(key, options);
   const watchers = /* @__PURE__ */ new Map();
   let prevItems = base.get();
   const unsubscribe = base.subscribe((next) => {
@@ -139,7 +139,7 @@ function collection(key, options) {
 // src/computed.ts
 var computedCounter = 0;
 function computed(deps, fn, options) {
-  const listeners = chunkIC7SQVDX_cjs.createListeners();
+  const listeners = chunkPP6KNY6S_cjs.createListeners();
   const instanceKey = options?.key ?? `computed:${computedCounter++}`;
   let cached;
   let isDirty = true;
@@ -164,7 +164,7 @@ function computed(deps, fn, options) {
   };
   const markDirty = () => {
     isDirty = true;
-    chunkIC7SQVDX_cjs.notify(notifyListeners);
+    chunkPP6KNY6S_cjs.notify(notifyListeners);
   };
   const unsubscribers = new Array(depLen);
   for (let i = 0; i < depLen; i++) {
@@ -224,7 +224,7 @@ function computed(deps, fn, options) {
 
 // src/devtools.ts
 function snapshot() {
-  const registry = chunkIC7SQVDX_cjs.getRegistry();
+  const registry = chunkPP6KNY6S_cjs.getRegistry();
   const result = [];
   for (const instance of registry.values()) {
     result.push({
@@ -407,7 +407,7 @@ function withWatch(instance) {
 // src/previous.ts
 var previousCounter = 0;
 function previous(source, options) {
-  const listeners = chunkIC7SQVDX_cjs.createListeners();
+  const listeners = chunkPP6KNY6S_cjs.createListeners();
   const instanceKey = options?.key ?? `previous:${previousCounter++}`;
   let prev;
   let current = source.get();
@@ -417,7 +417,7 @@ function previous(source, options) {
     prev = current;
     current = next;
     if (old !== prev) {
-      chunkIC7SQVDX_cjs.notify(() => listeners.notify(prev));
+      chunkPP6KNY6S_cjs.notify(() => listeners.notify(prev));
     }
   });
   let destroyedPromise;
@@ -479,7 +479,7 @@ function readonly(instance) {
 // src/select.ts
 var selectCounter = 0;
 function select(source, fn, options) {
-  const listeners = chunkIC7SQVDX_cjs.createListeners();
+  const listeners = chunkPP6KNY6S_cjs.createListeners();
   const instanceKey = options?.key ?? `select:${selectCounter++}`;
   let cached;
   let isDirty = true;
@@ -498,7 +498,7 @@ function select(source, fn, options) {
   };
   const markDirty = () => {
     isDirty = true;
-    chunkIC7SQVDX_cjs.notify(notifyListeners);
+    chunkPP6KNY6S_cjs.notify(notifyListeners);
   };
   const unsubscribe = source.subscribe(markDirty);
   recompute();
@@ -553,34 +553,34 @@ function createState(key, options) {
   if (!key) {
     throw new Error("[state] key must be a non-empty string.");
   }
-  const config = chunkIC7SQVDX_cjs.getConfig();
+  const config = chunkPP6KNY6S_cjs.getConfig();
   if (config.keyPattern && !config.keyPattern.test(key)) {
     throw new Error(
       `[gjendje] Key "${key}" does not match the configured keyPattern ${config.keyPattern}.`
     );
   }
   const rawScope = options.scope ?? config.scope ?? "render";
-  const scope = rawScope === "memory" ? "render" : rawScope;
-  const rKey = chunkIC7SQVDX_cjs.scopedKey(key, scope);
-  const existing = chunkIC7SQVDX_cjs.getRegistered(rKey);
+  const scope = rawScope === "memory" ? "render" : rawScope === "session" ? "tab" : rawScope;
+  const rKey = chunkPP6KNY6S_cjs.scopedKey(key, scope);
+  const existing = chunkPP6KNY6S_cjs.getRegistered(rKey);
   if (existing && !existing.isDestroyed) {
     if (config.warnOnDuplicate) {
-      chunkIC7SQVDX_cjs.log("warn", `Duplicate state("${key}") with scope "${scope}". Returning cached instance.`);
+      chunkPP6KNY6S_cjs.log("warn", `Duplicate state("${key}") with scope "${scope}". Returning cached instance.`);
     }
     return existing;
   }
   if (scope === "render" && !options.ssr && !config.ssr) {
     if (options.sync) {
-      chunkIC7SQVDX_cjs.log(
+      chunkPP6KNY6S_cjs.log(
         "warn",
         `sync: true is ignored for scope "render". Only "local" and "bucket" scopes support cross-tab sync.`
       );
     }
-    const instance = chunkIC7SQVDX_cjs.createRenderState(key, rKey, options, config);
-    chunkIC7SQVDX_cjs.registerByKey(rKey, key, scope, instance, config);
+    const instance = chunkPP6KNY6S_cjs.createRenderState(key, rKey, options, config);
+    chunkPP6KNY6S_cjs.registerByKey(rKey, key, scope, instance, config);
     return instance;
   }
-  return chunkIC7SQVDX_cjs.createBase(key, options);
+  return chunkPP6KNY6S_cjs.createBase(key, options);
 }
 
 // src/shortcuts.ts
@@ -594,7 +594,35 @@ function extractEntry(entry) {
   const key = keys[0];
   return [key, entry[key]];
 }
-function state(keyOrEntry, optionsOrDefault, extraOptions) {
+var _deprecationWarned = /* @__PURE__ */ new Set();
+function warnDeprecated(name) {
+  if (_deprecationWarned.has(name)) return;
+  _deprecationWarned.add(name);
+  console.warn(
+    `[gjendje] ${name}() is deprecated and will be removed in the next major version. Use state.${name}() instead. Example: state.${name}({ key: value })`
+  );
+}
+function _local(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "local" });
+}
+function _session(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "session" });
+}
+function _url(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "url" });
+}
+function _server(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "server" });
+}
+function _bucket(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "bucket" });
+}
+function _state(keyOrEntry, optionsOrDefault, extraOptions) {
   let key;
   let options;
   if (typeof keyOrEntry === "object") {
@@ -607,38 +635,44 @@ function state(keyOrEntry, optionsOrDefault, extraOptions) {
   }
   return createState(key, options);
 }
+_state.local = _local;
+_state.session = _session;
+_state.url = _url;
+_state.bucket = _bucket;
+_state.server = _server;
+var state = _state;
 function local(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "local" });
+  warnDeprecated("local");
+  return _local(entry, options);
 }
 function session(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "tab" });
+  warnDeprecated("session");
+  return _session(entry, options);
 }
 function url(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "url" });
+  warnDeprecated("url");
+  return _url(entry, options);
 }
 function server(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "server" });
+  warnDeprecated("server");
+  return _server(entry, options);
 }
 function bucket(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "bucket" });
+  warnDeprecated("bucket");
+  return _bucket(entry, options);
 }
 
 Object.defineProperty(exports, "batch", {
   enumerable: true,
-  get: function () { return chunkIC7SQVDX_cjs.batch; }
+  get: function () { return chunkPP6KNY6S_cjs.batch; }
 });
 Object.defineProperty(exports, "configure", {
   enumerable: true,
-  get: function () { return chunkIC7SQVDX_cjs.configure; }
+  get: function () { return chunkPP6KNY6S_cjs.configure; }
 });
 Object.defineProperty(exports, "shallowEqual", {
   enumerable: true,
-  get: function () { return chunkIC7SQVDX_cjs.shallowEqual; }
+  get: function () { return chunkPP6KNY6S_cjs.shallowEqual; }
 });
 exports.bucket = bucket;
 exports.collection = collection;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { B as BaseInstance, U as Unsubscribe, S as StateOptions, R as ReadonlyInstance, a as Scope, b as StateInstance } from './types-CmmPImmo.cjs';
-export { A as Adapter, c as BucketOptions, E as Enhancer, L as Listener, d as Serializer } from './types-CmmPImmo.cjs';
+import { B as BaseInstance, U as Unsubscribe, S as StateOptions, R as ReadonlyInstance, a as Scope, b as StateInstance } from './types-DoZ6OB8U.cjs';
+export { A as Adapter, c as BucketOptions, E as Enhancer, L as Listener, d as Serializer } from './types-DoZ6OB8U.cjs';
 
 /**
  * Runs all state updates inside fn as a single batch.
@@ -367,66 +367,72 @@ declare function select<TSource, TResult>(source: ReadonlyInstance<TSource>, fn:
 type Widen<T> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T;
 type ShortcutOptions<T> = Omit<StateOptions<T>, 'default' | 'scope'>;
 type BucketShortcutOptions<T> = Omit<StateOptions<T>, 'default' | 'scope' | 'bucket'> & Pick<StateOptions<T>, 'bucket'>;
+/** state function with dot-notation scope shortcuts */
+interface StateFunction {
+    /** Create in-memory state (default scope) */
+    <T>(entry: Record<string, T>, options?: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
+    <T>(key: string, options: StateOptions<T>): StateInstance<T>;
+    <T>(key: string, defaultValue: T, options: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
+    <T extends string | number | boolean | null | undefined>(key: string, defaultValue: T): StateInstance<Widen<T>>;
+    /** Create state stored in `localStorage` */
+    local: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in `sessionStorage` */
+    session: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in `URLSearchParams` */
+    url: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in a Storage Bucket */
+    bucket: <T>(entry: Record<string, T>, options: BucketShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in server-side `AsyncLocalStorage` */
+    server: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+}
+declare const state: StateFunction;
 /**
- * Create a stateful value.
- *
- * Preferred — entry object form (key derived from property name):
+ * @deprecated Use `state.local()` instead. Will be removed in the next major version.
  *
- * ```ts
- * const counter = state({ counter: 0 })
- * const theme = state({ theme: 'light' }, { scope: 'local' })
- * ```
- *
- * Alternative — string key forms:
- *
- * ```ts
- * const theme = state('theme', { default: 'light', scope: 'local' })
- * const synced = state('theme', 'light', { scope: 'local', sync: true })
- * const counter = state('counter', 0)
- * ```
- */
-declare function state<T>(entry: Record<string, T>, options?: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
-declare function state<T>(key: string, options: StateOptions<T>): StateInstance<T>;
-declare function state<T>(key: string, defaultValue: T, options: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
-declare function state<T extends string | number | boolean | null | undefined>(key: string, defaultValue: T): StateInstance<Widen<T>>;
-/**
  * Create state stored in `localStorage`.
  *
  * ```ts
- * const theme = local({ theme: 'light' })
- * const synced = local({ theme: 'dark' }, { sync: true })
+ * const theme = state.local({ theme: 'light' })
  * ```
  */
 declare function local<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.session()` instead. Will be removed in the next major version.
+ *
  * Create state stored in `sessionStorage`.
  *
  * ```ts
- * const draft = session({ draft: '' })
+ * const draft = state.session({ draft: '' })
  * ```
  */
 declare function session<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.url()` instead. Will be removed in the next major version.
+ *
  * Create state stored in `URLSearchParams`.
  *
  * ```ts
- * const filters = url({ filters: { q: '' } })
+ * const filters = state.url({ q: '' })
  * ```
  */
 declare function url<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.server()` instead. Will be removed in the next major version.
+ *
  * Create state stored in server-side `AsyncLocalStorage`.
  *
  * ```ts
- * const user = server({ user: null })
+ * const user = state.server({ user: null })
  * ```
  */
 declare function server<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.bucket()` instead. Will be removed in the next major version.
+ *
  * Create state stored in a Storage Bucket.
  *
  * ```ts
- * const data = bucket({ cache: [] }, { bucket: { name: 'my-bucket' } })
+ * const data = state.bucket({ cache: [] }, { bucket: { name: 'my-bucket' } })
  * ```
  */
 declare function bucket<T>(entry: Record<string, T>, options: BucketShortcutOptions<T>): StateInstance<T>;
@@ -437,4 +443,4 @@ declare function bucket<T>(entry: Record<string, T>, options: BucketShortcutOpti
  */
 declare function shallowEqual(a: unknown, b: unknown): boolean;
 
-export { BaseInstance, type CollectionInstance, type ComputedInstance, type ComputedOptions, type DestroyContext, type EffectHandle, type ErrorContext, type GjendjeConfig, type HistoryOptions, type HydrateContext, type LogLevel, type MigrateContext, type PreviousInstance, type PreviousOptions, type QuotaExceededContext, ReadonlyInstance, type RegisterContext, Scope, type SelectInstance, type SelectOptions, StateInstance, StateOptions, type StateSnapshot, type SyncContext, Unsubscribe, type WithHistoryInstance, type WithWatch, batch, bucket, collection, computed, configure, effect, local, previous, readonly, select, server, session, shallowEqual, snapshot, state, url, withHistory, withWatch };
+export { BaseInstance, type CollectionInstance, type ComputedInstance, type ComputedOptions, type DestroyContext, type EffectHandle, type ErrorContext, type GjendjeConfig, type HistoryOptions, type HydrateContext, type LogLevel, type MigrateContext, type PreviousInstance, type PreviousOptions, type QuotaExceededContext, ReadonlyInstance, type RegisterContext, Scope, type SelectInstance, type SelectOptions, type StateFunction, StateInstance, StateOptions, type StateSnapshot, type SyncContext, Unsubscribe, type WithHistoryInstance, type WithWatch, batch, bucket, collection, computed, configure, effect, local, previous, readonly, select, server, session, shallowEqual, snapshot, state, url, withHistory, withWatch };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BaseInstance, U as Unsubscribe, S as StateOptions, R as ReadonlyInstance, a as Scope, b as StateInstance } from './types-CmmPImmo.js';
-export { A as Adapter, c as BucketOptions, E as Enhancer, L as Listener, d as Serializer } from './types-CmmPImmo.js';
+import { B as BaseInstance, U as Unsubscribe, S as StateOptions, R as ReadonlyInstance, a as Scope, b as StateInstance } from './types-DoZ6OB8U.js';
+export { A as Adapter, c as BucketOptions, E as Enhancer, L as Listener, d as Serializer } from './types-DoZ6OB8U.js';
 
 /**
  * Runs all state updates inside fn as a single batch.
@@ -367,66 +367,72 @@ declare function select<TSource, TResult>(source: ReadonlyInstance<TSource>, fn:
 type Widen<T> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T;
 type ShortcutOptions<T> = Omit<StateOptions<T>, 'default' | 'scope'>;
 type BucketShortcutOptions<T> = Omit<StateOptions<T>, 'default' | 'scope' | 'bucket'> & Pick<StateOptions<T>, 'bucket'>;
+/** state function with dot-notation scope shortcuts */
+interface StateFunction {
+    /** Create in-memory state (default scope) */
+    <T>(entry: Record<string, T>, options?: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
+    <T>(key: string, options: StateOptions<T>): StateInstance<T>;
+    <T>(key: string, defaultValue: T, options: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
+    <T extends string | number | boolean | null | undefined>(key: string, defaultValue: T): StateInstance<Widen<T>>;
+    /** Create state stored in `localStorage` */
+    local: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in `sessionStorage` */
+    session: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in `URLSearchParams` */
+    url: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in a Storage Bucket */
+    bucket: <T>(entry: Record<string, T>, options: BucketShortcutOptions<T>) => StateInstance<T>;
+    /** Create state stored in server-side `AsyncLocalStorage` */
+    server: <T>(entry: Record<string, T>, options?: ShortcutOptions<T>) => StateInstance<T>;
+}
+declare const state: StateFunction;
 /**
- * Create a stateful value.
- *
- * Preferred — entry object form (key derived from property name):
+ * @deprecated Use `state.local()` instead. Will be removed in the next major version.
  *
- * ```ts
- * const counter = state({ counter: 0 })
- * const theme = state({ theme: 'light' }, { scope: 'local' })
- * ```
- *
- * Alternative — string key forms:
- *
- * ```ts
- * const theme = state('theme', { default: 'light', scope: 'local' })
- * const synced = state('theme', 'light', { scope: 'local', sync: true })
- * const counter = state('counter', 0)
- * ```
- */
-declare function state<T>(entry: Record<string, T>, options?: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
-declare function state<T>(key: string, options: StateOptions<T>): StateInstance<T>;
-declare function state<T>(key: string, defaultValue: T, options: Omit<StateOptions<T>, 'default'>): StateInstance<T>;
-declare function state<T extends string | number | boolean | null | undefined>(key: string, defaultValue: T): StateInstance<Widen<T>>;
-/**
  * Create state stored in `localStorage`.
  *
  * ```ts
- * const theme = local({ theme: 'light' })
- * const synced = local({ theme: 'dark' }, { sync: true })
+ * const theme = state.local({ theme: 'light' })
  * ```
  */
 declare function local<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.session()` instead. Will be removed in the next major version.
+ *
  * Create state stored in `sessionStorage`.
  *
  * ```ts
- * const draft = session({ draft: '' })
+ * const draft = state.session({ draft: '' })
  * ```
  */
 declare function session<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.url()` instead. Will be removed in the next major version.
+ *
  * Create state stored in `URLSearchParams`.
  *
  * ```ts
- * const filters = url({ filters: { q: '' } })
+ * const filters = state.url({ q: '' })
  * ```
  */
 declare function url<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.server()` instead. Will be removed in the next major version.
+ *
  * Create state stored in server-side `AsyncLocalStorage`.
  *
  * ```ts
- * const user = server({ user: null })
+ * const user = state.server({ user: null })
  * ```
  */
 declare function server<T>(entry: Record<string, T>, options?: ShortcutOptions<T>): StateInstance<T>;
 /**
+ * @deprecated Use `state.bucket()` instead. Will be removed in the next major version.
+ *
  * Create state stored in a Storage Bucket.
  *
  * ```ts
- * const data = bucket({ cache: [] }, { bucket: { name: 'my-bucket' } })
+ * const data = state.bucket({ cache: [] }, { bucket: { name: 'my-bucket' } })
  * ```
  */
 declare function bucket<T>(entry: Record<string, T>, options: BucketShortcutOptions<T>): StateInstance<T>;
@@ -437,4 +443,4 @@ declare function bucket<T>(entry: Record<string, T>, options: BucketShortcutOpti
  */
 declare function shallowEqual(a: unknown, b: unknown): boolean;
 
-export { BaseInstance, type CollectionInstance, type ComputedInstance, type ComputedOptions, type DestroyContext, type EffectHandle, type ErrorContext, type GjendjeConfig, type HistoryOptions, type HydrateContext, type LogLevel, type MigrateContext, type PreviousInstance, type PreviousOptions, type QuotaExceededContext, ReadonlyInstance, type RegisterContext, Scope, type SelectInstance, type SelectOptions, StateInstance, StateOptions, type StateSnapshot, type SyncContext, Unsubscribe, type WithHistoryInstance, type WithWatch, batch, bucket, collection, computed, configure, effect, local, previous, readonly, select, server, session, shallowEqual, snapshot, state, url, withHistory, withWatch };
+export { BaseInstance, type CollectionInstance, type ComputedInstance, type ComputedOptions, type DestroyContext, type EffectHandle, type ErrorContext, type GjendjeConfig, type HistoryOptions, type HydrateContext, type LogLevel, type MigrateContext, type PreviousInstance, type PreviousOptions, type QuotaExceededContext, ReadonlyInstance, type RegisterContext, Scope, type SelectInstance, type SelectOptions, type StateFunction, StateInstance, StateOptions, type StateSnapshot, type SyncContext, Unsubscribe, type WithHistoryInstance, type WithWatch, batch, bucket, collection, computed, configure, effect, local, previous, readonly, select, server, session, shallowEqual, snapshot, state, url, withHistory, withWatch };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { createBase, createListeners, getRegistry, notify, getConfig, scopedKey, getRegistered, log, createRenderState, registerByKey } from './chunk-5J2W34MR.js';
-export { batch, configure, shallowEqual } from './chunk-5J2W34MR.js';
+import { createBase, createListeners, getRegistry, notify, getConfig, scopedKey, getRegistered, log, createRenderState, registerByKey } from './chunk-G6M5RUNT.js';
+export { batch, configure, shallowEqual } from './chunk-G6M5RUNT.js';
 
 // src/collection.ts
 function collection(key, options) {
@@ -559,7 +559,7 @@ function createState(key, options) {
     );
   }
   const rawScope = options.scope ?? config.scope ?? "render";
-  const scope = rawScope === "memory" ? "render" : rawScope;
+  const scope = rawScope === "memory" ? "render" : rawScope === "session" ? "tab" : rawScope;
   const rKey = scopedKey(key, scope);
   const existing = getRegistered(rKey);
   if (existing && !existing.isDestroyed) {
@@ -593,7 +593,35 @@ function extractEntry(entry) {
   const key = keys[0];
   return [key, entry[key]];
 }
-function state(keyOrEntry, optionsOrDefault, extraOptions) {
+var _deprecationWarned = /* @__PURE__ */ new Set();
+function warnDeprecated(name) {
+  if (_deprecationWarned.has(name)) return;
+  _deprecationWarned.add(name);
+  console.warn(
+    `[gjendje] ${name}() is deprecated and will be removed in the next major version. Use state.${name}() instead. Example: state.${name}({ key: value })`
+  );
+}
+function _local(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "local" });
+}
+function _session(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "session" });
+}
+function _url(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "url" });
+}
+function _server(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "server" });
+}
+function _bucket(entry, options) {
+  const [key, defaultValue] = extractEntry(entry);
+  return createState(key, { ...options, default: defaultValue, scope: "bucket" });
+}
+function _state(keyOrEntry, optionsOrDefault, extraOptions) {
   let key;
   let options;
   if (typeof keyOrEntry === "object") {
@@ -606,25 +634,31 @@ function state(keyOrEntry, optionsOrDefault, extraOptions) {
   }
   return createState(key, options);
 }
+_state.local = _local;
+_state.session = _session;
+_state.url = _url;
+_state.bucket = _bucket;
+_state.server = _server;
+var state = _state;
 function local(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "local" });
+  warnDeprecated("local");
+  return _local(entry, options);
 }
 function session(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "tab" });
+  warnDeprecated("session");
+  return _session(entry, options);
 }
 function url(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "url" });
+  warnDeprecated("url");
+  return _url(entry, options);
 }
 function server(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "server" });
+  warnDeprecated("server");
+  return _server(entry, options);
 }
 function bucket(entry, options) {
-  const [key, defaultValue] = extractEntry(entry);
-  return createState(key, { ...options, default: defaultValue, scope: "bucket" });
+  warnDeprecated("bucket");
+  return _bucket(entry, options);
 }
 
 export { bucket, collection, computed, effect, local, previous, readonly, select, server, session, snapshot, state, url, withHistory, withWatch };

package/dist/server.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkIC7SQVDX_cjs = require('./chunk-IC7SQVDX.cjs');
+var chunkPP6KNY6S_cjs = require('./chunk-PP6KNY6S.cjs');
 var async_hooks = require('async_hooks');
 
 var als = new async_hooks.AsyncLocalStorage();
@@ -9,7 +9,7 @@ async function withServerSession(fn) {
   return als.run(store, fn);
 }
 function createServerAdapter(key, defaultValue) {
-  const listeners = chunkIC7SQVDX_cjs.createListeners();
+  const listeners = chunkPP6KNY6S_cjs.createListeners();
   function getStore() {
     return als.getStore();
   }
@@ -31,7 +31,7 @@ function createServerAdapter(key, defaultValue) {
       }
       store.set(key, value);
       lastNotifiedValue = value;
-      chunkIC7SQVDX_cjs.notify(notifyListeners);
+      chunkPP6KNY6S_cjs.notify(notifyListeners);
     },
     subscribe: listeners.subscribe,
     destroy() {
@@ -39,7 +39,7 @@ function createServerAdapter(key, defaultValue) {
     }
   };
 }
-chunkIC7SQVDX_cjs.registerServerAdapter(createServerAdapter);
+chunkPP6KNY6S_cjs.registerServerAdapter(createServerAdapter);
 
 exports.createServerAdapter = createServerAdapter;
 exports.withServerSession = withServerSession;

package/dist/server.d.cts

@@ -1,4 +1,4 @@
-import { A as Adapter } from './types-CmmPImmo.cjs';
+import { A as Adapter } from './types-DoZ6OB8U.cjs';
 
 declare function withServerSession<T>(fn: () => T): Promise<T>;
 declare function createServerAdapter<T>(key: string, defaultValue: T): Adapter<T>;

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { A as Adapter } from './types-CmmPImmo.js';
+import { A as Adapter } from './types-DoZ6OB8U.js';
 
 declare function withServerSession<T>(fn: () => T): Promise<T>;
 declare function createServerAdapter<T>(key: string, defaultValue: T): Adapter<T>;

package/dist/server.js

@@ -1,4 +1,4 @@
-import { registerServerAdapter, createListeners, notify } from './chunk-5J2W34MR.js';
+import { registerServerAdapter, createListeners, notify } from './chunk-G6M5RUNT.js';
 import { AsyncLocalStorage } from 'async_hooks';
 
 var als = new AsyncLocalStorage();

package/dist/{types-CmmPImmo.d.cts → types-DoZ6OB8U.d.cts}

@@ -1,4 +1,4 @@
-type Scope = 'memory' | 'render' | 'tab' | 'local' | 'url' | 'server' | 'bucket';
+type Scope = 'memory' | 'render' | 'session' | 'tab' | 'local' | 'url' | 'server' | 'bucket';
 interface Adapter<T> {
     get(): T;
     set(value: T): void;
@@ -95,7 +95,7 @@ interface BucketOptions {
      * Scope to use if the Storage Buckets API is not available.
      * Defaults to 'local'.
      */
-    fallback?: 'local' | 'tab';
+    fallback?: 'local' | 'session' | 'tab';
 }
 interface StateOptions<T> {
     /** Initial / default value */

package/dist/{types-CmmPImmo.d.ts → types-DoZ6OB8U.d.ts}

@@ -1,4 +1,4 @@
-type Scope = 'memory' | 'render' | 'tab' | 'local' | 'url' | 'server' | 'bucket';
+type Scope = 'memory' | 'render' | 'session' | 'tab' | 'local' | 'url' | 'server' | 'bucket';
 interface Adapter<T> {
     get(): T;
     set(value: T): void;
@@ -95,7 +95,7 @@ interface BucketOptions {
      * Scope to use if the Storage Buckets API is not available.
      * Defaults to 'local'.
      */
-    fallback?: 'local' | 'tab';
+    fallback?: 'local' | 'session' | 'tab';
 }
 interface StateOptions<T> {
     /** Initial / default value */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gjendje",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "TypeScript state management",
   "keywords": [
     "state",