@yakocloud/state-vocab 1.0.1

package/README.md

@@ -0,0 +1,273 @@
+# state-vocab
+
+A lightweight React state management library that synchronizes component state with any `Storage`-compatible (localStorage, sessionStorage, custom).
+
+## Installation
+
+```bash
+npm install state-vocab
+```
+
+## Quick Start
+
+```tsx
+import { setupStorage, defineState, StorageProvider } from 'state-vocab'
+
+const storage = setupStorage({
+  path: {
+    to: {
+      theme: defineState<'Dark' | 'White' | 'System'>({
+        storage: localStorage,
+        defaultValue: 'Dark',
+      })
+    },
+  },
+})
+
+function App() {
+  return (
+    <StorageProvider>
+      <Settings />
+    </StorageProvider>
+  )
+}
+
+function Settings() {
+  const [theme, setTheme] = storage.path.to.theme.useState()
+
+  return (
+    <select value={theme} onChange={(e) => setTheme(e.target.value)}>
+      <option value="Dark">Dark</option>
+      <option value="White">White</option>
+      <option value="System">System</option>
+    </select>
+  )
+}
+```
+
+## Core Concepts
+
+### `defineState(options?)`
+
+Defines a state node. Options:
+
+| Option | Type | Description |
+|---|---|---|
+| `storage` | `Storage` | Where to persist the value. Omit for in-memory only. |
+| `defaultValue` | `T` | Value used when storage has no entry. |
+| `serialize` | `(v: T) => string` | Custom serializer. Default: `JSON.stringify`. |
+| `deserialize` | `(v: string) => T` | Custom deserializer. Default: `JSON.parse`. |
+
+```ts
+// In-memory (no persistence)
+const counter = defineState({ defaultValue: 0 })
+
+// localStorage with custom type
+const theme = defineState<'Dark' | 'White'>({
+  storage: localStorage,
+  defaultValue: 'Dark',
+})
+
+// localStorage with custom serialization
+const birthday = defineState({
+  storage: localStorage,
+  deserialize: (raw) => new Date(JSON.parse(raw)),
+})
+```
+
+### `setupStorage(tree)`
+
+Wraps a nested object of `defineState()` nodes and injects dot-separated paths into each leaf. The returned object mirrors your tree structure.
+
+```ts
+const storage = setupStorage({
+  user: {
+    name: defineState({ storage: localStorage }),
+    age: defineState({ defaultValue: 0 }),
+  },
+})
+
+// Access paths:
+storage.user.name  // → path: "user.name"
+storage.user.age   // → path: "user.age"
+```
+
+### `StorageProvider`
+
+A React context provider that must wrap all components using `useState()` from any state node. Place it once near the top of your tree.
+
+```tsx
+createRoot(document.getElementById('root')!).render(
+  <StorageProvider>
+    <App />
+  </StorageProvider>
+)
+```
+
+## `useState` Hook
+
+Each state node exposes a `.useState()` method that works like React's built-in `useState` but adds persistence and callbacks.
+
+```ts
+const [value, setValue, resetValue] = storage.path.to.node.useState(
+  defaultValue?,
+  options?
+)
+```
+
+### Arguments
+
+**`defaultValue`** — overrides the `defineState`-level default for this usage. Accepts a value or initializer function:
+
+```ts
+const [alarm] = storage.alarm.useState(() => new Date())
+```
+
+**`options.delayedSet`** — debounce the `onSet` callback by N milliseconds:
+
+```ts
+const [note, setNote] = storage.note.useState('', {
+  delayedSet: 1000,
+  onSet: (value) => saveToServer(value),
+})
+```
+
+**`options.onSet`** — called after every state change with `(nextValue, prevValue)`:
+
+```ts
+const [counter, setCounter] = storage.counter.useState(0, {
+  onSet(next, prev) {
+    console.log(`Changed from ${prev} to ${next}`)
+  },
+})
+```
+
+### Return value
+
+```ts
+const [value, setValue, resetValue] = storage.node.useState()
+```
+
+- **`value`** — current state
+- **`setValue(nextValue | updater)`** — set state; accepts a value or `(prev) => next` function
+- **`resetValue()`** — restores the default value
+
+## Custom Storage
+
+Any object implementing the [Web Storage API](https://developer.mozilla.org/en-US/docs/Web/API/Storage) works as a backend:
+
+```ts
+const storage = setupStorage({
+  server: defineState({
+    storage: {
+      length: 0,
+      getItem: (key) => cache[key] ?? null,
+      setItem: (key, value) => api.save(key, value),
+      removeItem: (key) => { delete cache[key] },
+      clear: () => {},
+      key: () => null,
+    },
+  }),
+})
+```
+
+## Full Example
+
+```tsx
+import { setupStorage, defineState, StorageProvider } from 'state-vocab'
+
+type Theme = 'Dark' | 'White' | 'System'
+
+const storage = setupStorage({
+  preference: {
+    theme: defineState<Theme>({ storage: localStorage, defaultValue: 'Dark' }),
+    nightMode: defineState({ storage: sessionStorage }),
+  },
+  stats: {
+    counter: defineState({ defaultValue: 0 }),
+  },
+  personal: {
+    note: defineState({ storage: localStorage }),
+    birthday: defineState({
+      storage: localStorage,
+      deserialize: (raw) => {
+        try { return new Date(JSON.parse(raw)) } catch { return null }
+      },
+    }),
+  },
+})
+
+function Dashboard() {
+  const [theme, setTheme] = storage.preference.theme.useState()
+  const [nightMode, setNightMode] = storage.preference.nightMode.useState(false)
+  const [counter, setCounter, resetCounter] = storage.stats.counter.useState(0)
+  const [note, setNote] = storage.personal.note.useState('', {
+    delayedSet: 500,
+    onSet: (v) => console.log('Saving note:', v),
+  })
+
+  return (
+    <div>
+      <select value={theme ?? ''} onChange={(e) => setTheme(e.target.value as Theme)}>
+        <option value="Dark">Dark</option>
+        <option value="White">White</option>
+        <option value="System">System</option>
+      </select>
+
+      <input
+        type="checkbox"
+        checked={!!nightMode}
+        onChange={(e) => setNightMode(e.target.checked)}
+      />
+
+      <input
+        type="number"
+        value={counter}
+        onChange={(e) => setCounter(+e.target.value)}
+      />
+      <button onClick={resetCounter}>Reset</button>
+
+      <input
+        type="text"
+        value={note}
+        onChange={(e) => setNote(e.target.value)}
+      />
+    </div>
+  )
+}
+
+createRoot(document.getElementById('root')!).render(
+  <StorageProvider>
+    <Dashboard />
+  </StorageProvider>
+)
+```
+
+## API Reference
+
+### `defineState<T>(options?)`
+
+| Option | Type | Default |
+|---|---|---|
+| `storage` | `Storage \| undefined` | `undefined` (in-memory) |
+| `defaultValue` | `T \| undefined` | `undefined` |
+| `serialize` | `(v: T) => string` | `JSON.stringify` |
+| `deserialize` | `(v: string) => T` | `JSON.parse` |
+
+### `setupStorage<T>(tree: T): T`
+
+Returns a proxied copy of `tree` with paths injected into all leaf nodes.
+
+### `StorageProvider`
+
+React context provider. Must be an ancestor of any component using `.useState()`.
+
+### `node.useState<D>(defaultValue?, options?)`
+
+| Parameter | Type | Description |
+|---|---|---|
+| `defaultValue` | `D \| (() => D) \| undefined` | Local default, overrides `defineState` default |
+| `options.delayedSet` | `number \| undefined` | Debounce delay for `onSet` in ms |
+| `options.onSet` | `(next: D, prev: D) => void \| undefined` | Callback after state change |
+
+Returns `[value, setValue, resetValue]`.

package/dist/state-vocab.cjs.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const D=require("react"),De=Symbol("state-def"),B=Symbol("state-path");function yr(d,i,c){if(!i)return d;const g=i.split(".");let l=d;for(const m of g)if(l!==null&&typeof l=="object"&&m in l)l=l[m];else return c;return l===void 0?c:l}function br(d,i,c){const g=i.replace(/\[(\d+)\]/g,".$1").split(".");let l=d;for(let m=0;m<g.length-1;m++){const R=g[m],y=g[m+1];(l[R]===void 0||l[R]===null)&&(l[R]=/^\d+$/.test(y)?[]:{}),l=l[R]}return l[g[g.length-1]]=c,d}function hr(d,i=0){let c;return function(...g){c!==void 0&&clearTimeout(c),c=setTimeout(()=>{c=void 0,d.apply(this,g)},i)}}function Er(d,i,c=[]){return D.useMemo(()=>hr(d,i),c)}var K={exports:{}},Y={};var Ce;function mr(){if(Ce)return Y;Ce=1;var d=D,i=Symbol.for("react.element"),c=Symbol.for("react.fragment"),g=Object.prototype.hasOwnProperty,l=d.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner,m={key:!0,ref:!0,__self:!0,__source:!0};function R(y,f,v){var p,_={},w=null,k=null;v!==void 0&&(w=""+v),f.key!==void 0&&(w=""+f.key),f.ref!==void 0&&(k=f.ref);for(p in f)g.call(f,p)&&!m.hasOwnProperty(p)&&(_[p]=f[p]);if(y&&y.defaultProps)for(p in f=y.defaultProps,f)_[p]===void 0&&(_[p]=f[p]);return{$$typeof:i,type:y,key:w,ref:k,props:_,_owner:l.current}}return Y.Fragment=c,Y.jsx=R,Y.jsxs=R,Y}var L={};var we;function Rr(){return we||(we=1,process.env.NODE_ENV!=="production"&&(function(){var d=D,i=Symbol.for("react.element"),c=Symbol.for("react.portal"),g=Symbol.for("react.fragment"),l=Symbol.for("react.strict_mode"),m=Symbol.for("react.profiler"),R=Symbol.for("react.provider"),y=Symbol.for("react.context"),f=Symbol.for("react.forward_ref"),v=Symbol.for("react.suspense"),p=Symbol.for("react.suspense_list"),_=Symbol.for("react.memo"),w=Symbol.for("react.lazy"),k=Symbol.for("react.offscreen"),j=Symbol.iterator,P="@@iterator";function E(e){if(e===null||typeof e!="object")return null;var r=j&&e[j]||e[P];return typeof r=="function"?r:null}var S=d.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;function T(e){{for(var r=arguments.length,t=new Array(r>1?r-1:0),n=1;n<r;n++)t[n-1]=arguments[n];Ie("error",e,t)}}function Ie(e,r,t){{var n=S.ReactDebugCurrentFrame,u=n.getStackAddendum();u!==""&&(r+="%s",t=t.concat([u]));var s=t.map(function(o){return String(o)});s.unshift("Warning: "+r),Function.prototype.apply.call(console[e],console,s)}}var Ve=!1,$e=!1,We=!1,Me=!1,Ye=!1,te;te=Symbol.for("react.module.reference");function Le(e){return!!(typeof e=="string"||typeof e=="function"||e===g||e===m||Ye||e===l||e===v||e===p||Me||e===k||Ve||$e||We||typeof e=="object"&&e!==null&&(e.$$typeof===w||e.$$typeof===_||e.$$typeof===R||e.$$typeof===y||e.$$typeof===f||e.$$typeof===te||e.getModuleId!==void 0))}function Ne(e,r,t){var n=e.displayName;if(n)return n;var u=r.displayName||r.name||"";return u!==""?t+"("+u+")":t}function ne(e){return e.displayName||"Context"}function A(e){if(e==null)return null;if(typeof e.tag=="number"&&T("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),typeof e=="function")return e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case g:return"Fragment";case c:return"Portal";case m:return"Profiler";case l:return"StrictMode";case v:return"Suspense";case p:return"SuspenseList"}if(typeof e=="object")switch(e.$$typeof){case y:var r=e;return ne(r)+".Consumer";case R:var t=e;return ne(t._context)+".Provider";case f:return Ne(e,e.render,"ForwardRef");case _:var n=e.displayName||null;return n!==null?n:A(e.type)||"Memo";case w:{var u=e,s=u._payload,o=u._init;try{return A(o(s))}catch{return null}}}return null}var F=Object.assign,W=0,ae,oe,ie,ue,se,ce,fe;function le(){}le.__reactDisabledLog=!0;function Ue(){{if(W===0){ae=console.log,oe=console.info,ie=console.warn,ue=console.error,se=console.group,ce=console.groupCollapsed,fe=console.groupEnd;var e={configurable:!0,enumerable:!0,value:le,writable:!0};Object.defineProperties(console,{info:e,log:e,warn:e,error:e,group:e,groupCollapsed:e,groupEnd:e})}W++}}function Je(){{if(W--,W===0){var e={configurable:!0,enumerable:!0,writable:!0};Object.defineProperties(console,{log:F({},e,{value:ae}),info:F({},e,{value:oe}),warn:F({},e,{value:ie}),error:F({},e,{value:ue}),group:F({},e,{value:se}),groupCollapsed:F({},e,{value:ce}),groupEnd:F({},e,{value:fe})})}W<0&&T("disabledDepth fell below zero. This is a bug in React. Please file an issue.")}}var z=S.ReactCurrentDispatcher,G;function N(e,r,t){{if(G===void 0)try{throw Error()}catch(u){var n=u.stack.trim().match(/\n( *(at )?)/);G=n&&n[1]||""}return`
+`+G+e}}var X=!1,U;{var qe=typeof WeakMap=="function"?WeakMap:Map;U=new qe}function de(e,r){if(!e||X)return"";{var t=U.get(e);if(t!==void 0)return t}var n;X=!0;var u=Error.prepareStackTrace;Error.prepareStackTrace=void 0;var s;s=z.current,z.current=null,Ue();try{if(r){var o=function(){throw Error()};if(Object.defineProperty(o.prototype,"props",{set:function(){throw Error()}}),typeof Reflect=="object"&&Reflect.construct){try{Reflect.construct(o,[])}catch(C){n=C}Reflect.construct(e,[],o)}else{try{o.call()}catch(C){n=C}e.call(o.prototype)}}else{try{throw Error()}catch(C){n=C}e()}}catch(C){if(C&&n&&typeof C.stack=="string"){for(var a=C.stack.split(`
+`),O=n.stack.split(`
+`),b=a.length-1,h=O.length-1;b>=1&&h>=0&&a[b]!==O[h];)h--;for(;b>=1&&h>=0;b--,h--)if(a[b]!==O[h]){if(b!==1||h!==1)do if(b--,h--,h<0||a[b]!==O[h]){var x=`
+`+a[b].replace(" at new "," at ");return e.displayName&&x.includes("<anonymous>")&&(x=x.replace("<anonymous>",e.displayName)),typeof e=="function"&&U.set(e,x),x}while(b>=1&&h>=0);break}}}finally{X=!1,z.current=s,Je(),Error.prepareStackTrace=u}var $=e?e.displayName||e.name:"",I=$?N($):"";return typeof e=="function"&&U.set(e,I),I}function Ke(e,r,t){return de(e,!1)}function Be(e){var r=e.prototype;return!!(r&&r.isReactComponent)}function J(e,r,t){if(e==null)return"";if(typeof e=="function")return de(e,Be(e));if(typeof e=="string")return N(e);switch(e){case v:return N("Suspense");case p:return N("SuspenseList")}if(typeof e=="object")switch(e.$$typeof){case f:return Ke(e.render);case _:return J(e.type,r,t);case w:{var n=e,u=n._payload,s=n._init;try{return J(s(u),r,t)}catch{}}}return""}var M=Object.prototype.hasOwnProperty,ve={},pe=S.ReactDebugCurrentFrame;function q(e){if(e){var r=e._owner,t=J(e.type,e._source,r?r.type:null);pe.setExtraStackFrame(t)}else pe.setExtraStackFrame(null)}function ze(e,r,t,n,u){{var s=Function.call.bind(M);for(var o in e)if(s(e,o)){var a=void 0;try{if(typeof e[o]!="function"){var O=Error((n||"React class")+": "+t+" type `"+o+"` is invalid; it must be a function, usually from the `prop-types` package, but received `"+typeof e[o]+"`.This often happens because of typos such as `PropTypes.function` instead of `PropTypes.func`.");throw O.name="Invariant Violation",O}a=e[o](r,o,n,t,null,"SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED")}catch(b){a=b}a&&!(a instanceof Error)&&(q(u),T("%s: type specification of %s `%s` is invalid; the type checker function must return `null` or an `Error` but returned a %s. You may have forgotten to pass an argument to the type checker creator (arrayOf, instanceOf, objectOf, oneOf, oneOfType, and shape all require an argument).",n||"React class",t,o,typeof a),q(null)),a instanceof Error&&!(a.message in ve)&&(ve[a.message]=!0,q(u),T("Failed %s type: %s",t,a.message),q(null))}}}var Ge=Array.isArray;function H(e){return Ge(e)}function Xe(e){{var r=typeof Symbol=="function"&&Symbol.toStringTag,t=r&&e[Symbol.toStringTag]||e.constructor.name||"Object";return t}}function He(e){try{return ge(e),!1}catch{return!0}}function ge(e){return""+e}function ye(e){if(He(e))return T("The provided key is an unsupported type %s. This value must be coerced to a string before before using it here.",Xe(e)),ge(e)}var be=S.ReactCurrentOwner,Ze={key:!0,ref:!0,__self:!0,__source:!0},he,Ee;function Qe(e){if(M.call(e,"ref")){var r=Object.getOwnPropertyDescriptor(e,"ref").get;if(r&&r.isReactWarning)return!1}return e.ref!==void 0}function er(e){if(M.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function rr(e,r){typeof e.ref=="string"&&be.current}function tr(e,r){{var t=function(){he||(he=!0,T("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)",r))};t.isReactWarning=!0,Object.defineProperty(e,"key",{get:t,configurable:!0})}}function nr(e,r){{var t=function(){Ee||(Ee=!0,T("%s: `ref` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)",r))};t.isReactWarning=!0,Object.defineProperty(e,"ref",{get:t,configurable:!0})}}var ar=function(e,r,t,n,u,s,o){var a={$$typeof:i,type:e,key:r,ref:t,props:o,_owner:s};return a._store={},Object.defineProperty(a._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:!1}),Object.defineProperty(a,"_self",{configurable:!1,enumerable:!1,writable:!1,value:n}),Object.defineProperty(a,"_source",{configurable:!1,enumerable:!1,writable:!1,value:u}),Object.freeze&&(Object.freeze(a.props),Object.freeze(a)),a};function or(e,r,t,n,u){{var s,o={},a=null,O=null;t!==void 0&&(ye(t),a=""+t),er(r)&&(ye(r.key),a=""+r.key),Qe(r)&&(O=r.ref,rr(r,u));for(s in r)M.call(r,s)&&!Ze.hasOwnProperty(s)&&(o[s]=r[s]);if(e&&e.defaultProps){var b=e.defaultProps;for(s in b)o[s]===void 0&&(o[s]=b[s])}if(a||O){var h=typeof e=="function"?e.displayName||e.name||"Unknown":e;a&&tr(o,h),O&&nr(o,h)}return ar(e,a,O,u,n,be.current,o)}}var Z=S.ReactCurrentOwner,me=S.ReactDebugCurrentFrame;function V(e){if(e){var r=e._owner,t=J(e.type,e._source,r?r.type:null);me.setExtraStackFrame(t)}else me.setExtraStackFrame(null)}var Q;Q=!1;function ee(e){return typeof e=="object"&&e!==null&&e.$$typeof===i}function Re(){{if(Z.current){var e=A(Z.current.type);if(e)return`
+
+Check the render method of \``+e+"`."}return""}}function ir(e){return""}var _e={};function ur(e){{var r=Re();if(!r){var t=typeof e=="string"?e:e.displayName||e.name;t&&(r=`
+
+Check the top-level render call using <`+t+">.")}return r}}function Se(e,r){{if(!e._store||e._store.validated||e.key!=null)return;e._store.validated=!0;var t=ur(r);if(_e[t])return;_e[t]=!0;var n="";e&&e._owner&&e._owner!==Z.current&&(n=" It was passed a child from "+A(e._owner.type)+"."),V(e),T('Each child in a list should have a unique "key" prop.%s%s See https://reactjs.org/link/warning-keys for more information.',t,n),V(null)}}function Te(e,r){{if(typeof e!="object")return;if(H(e))for(var t=0;t<e.length;t++){var n=e[t];ee(n)&&Se(n,r)}else if(ee(e))e._store&&(e._store.validated=!0);else if(e){var u=E(e);if(typeof u=="function"&&u!==e.entries)for(var s=u.call(e),o;!(o=s.next()).done;)ee(o.value)&&Se(o.value,r)}}}function sr(e){{var r=e.type;if(r==null||typeof r=="string")return;var t;if(typeof r=="function")t=r.propTypes;else if(typeof r=="object"&&(r.$$typeof===f||r.$$typeof===_))t=r.propTypes;else return;if(t){var n=A(r);ze(t,e.props,"prop",n,e)}else if(r.PropTypes!==void 0&&!Q){Q=!0;var u=A(r);T("Component %s declared `PropTypes` instead of `propTypes`. Did you misspell the property assignment?",u||"Unknown")}typeof r.getDefaultProps=="function"&&!r.getDefaultProps.isReactClassApproved&&T("getDefaultProps is only used on classic React.createClass definitions. Use a static property named `defaultProps` instead.")}}function cr(e){{for(var r=Object.keys(e.props),t=0;t<r.length;t++){var n=r[t];if(n!=="children"&&n!=="key"){V(e),T("Invalid prop `%s` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.",n),V(null);break}}e.ref!==null&&(V(e),T("Invalid attribute `ref` supplied to `React.Fragment`."),V(null))}}var Oe={};function Pe(e,r,t,n,u,s){{var o=Le(e);if(!o){var a="";(e===void 0||typeof e=="object"&&e!==null&&Object.keys(e).length===0)&&(a+=" You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.");var O=ir();O?a+=O:a+=Re();var b;e===null?b="null":H(e)?b="array":e!==void 0&&e.$$typeof===i?(b="<"+(A(e.type)||"Unknown")+" />",a=" Did you accidentally export a JSX literal instead of a component?"):b=typeof e,T("React.jsx: type is invalid -- expected a string (for built-in components) or a class/function (for composite components) but got: %s.%s",b,a)}var h=or(e,r,t,u,s);if(h==null)return h;if(o){var x=r.children;if(x!==void 0)if(n)if(H(x)){for(var $=0;$<x.length;$++)Te(x[$],e);Object.freeze&&Object.freeze(x)}else T("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else Te(x,e)}if(M.call(r,"key")){var I=A(e),C=Object.keys(r).filter(function(gr){return gr!=="key"}),re=C.length>0?"{key: someKey, "+C.join(": ..., ")+": ...}":"{key: someKey}";if(!Oe[I+re]){var pr=C.length>0?"{"+C.join(": ..., ")+": ...}":"{}";T(`A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`,re,I,pr,I),Oe[I+re]=!0}}return e===g?cr(h):sr(h),h}}function fr(e,r,t){return Pe(e,r,t,!0)}function lr(e,r,t){return Pe(e,r,t,!1)}var dr=lr,vr=fr;L.Fragment=g,L.jsx=dr,L.jsxs=vr})()),L}var xe;function _r(){return xe||(xe=1,process.env.NODE_ENV==="production"?K.exports=mr():K.exports=Rr()),K.exports}var Sr=_r();const Ae=D.createContext({stateVocab:{},setStateVocab:()=>{}});function Tr(){return D.useContext(Ae)}const Or=({children:d})=>{const[i,c]=D.useState({});return console.log(i),Sr.jsx(Ae.Provider,{value:{stateVocab:i,setStateVocab:c},children:d})};function Pr(d={}){const{storage:i,serialize:c=JSON.stringify,deserialize:g=JSON.parse,defaultValue:l}=d;return{[De]:!0,[B]:"",useState(m,R){R??={};const y=Er(R.onSet??(()=>{}),R.delayedSet,[]),f=Tr(),v=this[B],p=()=>typeof m=="function"?m():m??l,_=D.useMemo(()=>{if(!i)return;const P=i.getItem(v);let E;if(P===null){const S=p();if(typeof S>"u")return;E=S}else E=g(P);return E},[v]),w=D.useMemo(()=>yr(f.stateVocab,v,_??p()),[f.stateVocab,_,v]),k=P=>E=>{const S={...E};return br(S,v,P),S};D.useEffect(()=>{!i||!_||f.setStateVocab(k(_))},[_]);const j=D.useRef(w);return[w,function(E){const S=typeof E=="function"?E(j.current):E;f.setStateVocab(k(S)),y(S,j.current),i&&i.setItem(v,c(S)),j.current=S},function(){const E=p();if(typeof E>"u"){i?.removeItem(v);return}f.setStateVocab(k(E)),y(E,j.current),j.current=E,i&&i.setItem(v,c(E))}]},toString(){return this[B]}}}const je=new WeakMap,ke=new WeakMap;function Fe(d,i=""){let c=je.get(d);c||(c=new Map,je.set(d,c));const g=c.get(i);if(g)return g;const l=new Proxy(d,{get(m,R){const y=m[R],f=i?`${i}.${String(R)}`:String(R);if(y&&typeof y=="object"&&De in y){const v=y;let p=ke.get(v);p||(p=new Map,ke.set(v,p));const _=p.get(f);if(_)return _;const w=Reflect.ownKeys(v).filter(P=>typeof v[P]=="function"),k=Object.fromEntries(w.map(P=>[P,(...E)=>v[P].call({...v,[B]:f},...E)])),j={...v,...k};return p.set(f,j),j}return y&&typeof y=="object"?Fe(y,f):y}});return c.set(i,l),l}function Cr(d){return Fe(d)}exports.StorageProvider=Or;exports.defineState=Pr;exports.setupStorage=Cr;

package/dist/state-vocab.es.js

@@ -0,0 +1,786 @@
+import De, { useMemo as re, createContext as br, useState as hr, useContext as Er, useEffect as mr, useRef as Rr } from "react";
+const Ae = Symbol("state-def"), K = Symbol("state-path");
+function _r(d, i, c) {
+  if (!i)
+    return d;
+  const g = i.split(".");
+  let l = d;
+  for (const m of g)
+    if (l !== null && typeof l == "object" && m in l)
+      l = l[m];
+    else
+      return c;
+  return l === void 0 ? c : l;
+}
+function Sr(d, i, c) {
+  const g = i.replace(/\[(\d+)\]/g, ".$1").split(".");
+  let l = d;
+  for (let m = 0; m < g.length - 1; m++) {
+    const R = g[m], y = g[m + 1];
+    (l[R] === void 0 || l[R] === null) && (l[R] = /^\d+$/.test(y) ? [] : {}), l = l[R];
+  }
+  return l[g[g.length - 1]] = c, d;
+}
+function Tr(d, i = 0) {
+  let c;
+  return function(...g) {
+    c !== void 0 && clearTimeout(c), c = setTimeout(() => {
+      c = void 0, d.apply(this, g);
+    }, i);
+  };
+}
+function Or(d, i, c = []) {
+  return re(
+    () => Tr(d, i),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    c
+  );
+}
+var q = { exports: {} }, Y = {};
+var Ce;
+function Pr() {
+  if (Ce) return Y;
+  Ce = 1;
+  var d = De, i = Symbol.for("react.element"), c = Symbol.for("react.fragment"), g = Object.prototype.hasOwnProperty, l = d.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner, m = { key: !0, ref: !0, __self: !0, __source: !0 };
+  function R(y, f, v) {
+    var p, _ = {}, w = null, k = null;
+    v !== void 0 && (w = "" + v), f.key !== void 0 && (w = "" + f.key), f.ref !== void 0 && (k = f.ref);
+    for (p in f) g.call(f, p) && !m.hasOwnProperty(p) && (_[p] = f[p]);
+    if (y && y.defaultProps) for (p in f = y.defaultProps, f) _[p] === void 0 && (_[p] = f[p]);
+    return { $$typeof: i, type: y, key: w, ref: k, props: _, _owner: l.current };
+  }
+  return Y.Fragment = c, Y.jsx = R, Y.jsxs = R, Y;
+}
+var M = {};
+var we;
+function Cr() {
+  return we || (we = 1, process.env.NODE_ENV !== "production" && (function() {
+    var d = De, i = Symbol.for("react.element"), c = Symbol.for("react.portal"), g = Symbol.for("react.fragment"), l = Symbol.for("react.strict_mode"), m = Symbol.for("react.profiler"), R = Symbol.for("react.provider"), y = Symbol.for("react.context"), f = Symbol.for("react.forward_ref"), v = Symbol.for("react.suspense"), p = Symbol.for("react.suspense_list"), _ = Symbol.for("react.memo"), w = Symbol.for("react.lazy"), k = Symbol.for("react.offscreen"), j = Symbol.iterator, P = "@@iterator";
+    function E(e) {
+      if (e === null || typeof e != "object")
+        return null;
+      var r = j && e[j] || e[P];
+      return typeof r == "function" ? r : null;
+    }
+    var S = d.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
+    function T(e) {
+      {
+        for (var r = arguments.length, t = new Array(r > 1 ? r - 1 : 0), n = 1; n < r; n++)
+          t[n - 1] = arguments[n];
+        Ve("error", e, t);
+      }
+    }
+    function Ve(e, r, t) {
+      {
+        var n = S.ReactDebugCurrentFrame, u = n.getStackAddendum();
+        u !== "" && (r += "%s", t = t.concat([u]));
+        var s = t.map(function(o) {
+          return String(o);
+        });
+        s.unshift("Warning: " + r), Function.prototype.apply.call(console[e], console, s);
+      }
+    }
+    var $e = !1, We = !1, Ye = !1, Me = !1, Le = !1, te;
+    te = Symbol.for("react.module.reference");
+    function Ne(e) {
+      return !!(typeof e == "string" || typeof e == "function" || e === g || e === m || Le || e === l || e === v || e === p || Me || e === k || $e || We || Ye || typeof e == "object" && e !== null && (e.$$typeof === w || e.$$typeof === _ || e.$$typeof === R || e.$$typeof === y || e.$$typeof === f || // This needs to include all possible module reference object
+      // types supported by any Flight configuration anywhere since
+      // we don't know which Flight build this will end up being used
+      // with.
+      e.$$typeof === te || e.getModuleId !== void 0));
+    }
+    function Ue(e, r, t) {
+      var n = e.displayName;
+      if (n)
+        return n;
+      var u = r.displayName || r.name || "";
+      return u !== "" ? t + "(" + u + ")" : t;
+    }
+    function ne(e) {
+      return e.displayName || "Context";
+    }
+    function D(e) {
+      if (e == null)
+        return null;
+      if (typeof e.tag == "number" && T("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."), typeof e == "function")
+        return e.displayName || e.name || null;
+      if (typeof e == "string")
+        return e;
+      switch (e) {
+        case g:
+          return "Fragment";
+        case c:
+          return "Portal";
+        case m:
+          return "Profiler";
+        case l:
+          return "StrictMode";
+        case v:
+          return "Suspense";
+        case p:
+          return "SuspenseList";
+      }
+      if (typeof e == "object")
+        switch (e.$$typeof) {
+          case y:
+            var r = e;
+            return ne(r) + ".Consumer";
+          case R:
+            var t = e;
+            return ne(t._context) + ".Provider";
+          case f:
+            return Ue(e, e.render, "ForwardRef");
+          case _:
+            var n = e.displayName || null;
+            return n !== null ? n : D(e.type) || "Memo";
+          case w: {
+            var u = e, s = u._payload, o = u._init;
+            try {
+              return D(o(s));
+            } catch {
+              return null;
+            }
+          }
+        }
+      return null;
+    }
+    var A = Object.assign, $ = 0, ae, oe, ie, ue, se, ce, fe;
+    function le() {
+    }
+    le.__reactDisabledLog = !0;
+    function Je() {
+      {
+        if ($ === 0) {
+          ae = console.log, oe = console.info, ie = console.warn, ue = console.error, se = console.group, ce = console.groupCollapsed, fe = console.groupEnd;
+          var e = {
+            configurable: !0,
+            enumerable: !0,
+            value: le,
+            writable: !0
+          };
+          Object.defineProperties(console, {
+            info: e,
+            log: e,
+            warn: e,
+            error: e,
+            group: e,
+            groupCollapsed: e,
+            groupEnd: e
+          });
+        }
+        $++;
+      }
+    }
+    function qe() {
+      {
+        if ($--, $ === 0) {
+          var e = {
+            configurable: !0,
+            enumerable: !0,
+            writable: !0
+          };
+          Object.defineProperties(console, {
+            log: A({}, e, {
+              value: ae
+            }),
+            info: A({}, e, {
+              value: oe
+            }),
+            warn: A({}, e, {
+              value: ie
+            }),
+            error: A({}, e, {
+              value: ue
+            }),
+            group: A({}, e, {
+              value: se
+            }),
+            groupCollapsed: A({}, e, {
+              value: ce
+            }),
+            groupEnd: A({}, e, {
+              value: fe
+            })
+          });
+        }
+        $ < 0 && T("disabledDepth fell below zero. This is a bug in React. Please file an issue.");
+      }
+    }
+    var B = S.ReactCurrentDispatcher, z;
+    function L(e, r, t) {
+      {
+        if (z === void 0)
+          try {
+            throw Error();
+          } catch (u) {
+            var n = u.stack.trim().match(/\n( *(at )?)/);
+            z = n && n[1] || "";
+          }
+        return `
+` + z + e;
+      }
+    }
+    var G = !1, N;
+    {
+      var Ke = typeof WeakMap == "function" ? WeakMap : Map;
+      N = new Ke();
+    }
+    function de(e, r) {
+      if (!e || G)
+        return "";
+      {
+        var t = N.get(e);
+        if (t !== void 0)
+          return t;
+      }
+      var n;
+      G = !0;
+      var u = Error.prepareStackTrace;
+      Error.prepareStackTrace = void 0;
+      var s;
+      s = B.current, B.current = null, Je();
+      try {
+        if (r) {
+          var o = function() {
+            throw Error();
+          };
+          if (Object.defineProperty(o.prototype, "props", {
+            set: function() {
+              throw Error();
+            }
+          }), typeof Reflect == "object" && Reflect.construct) {
+            try {
+              Reflect.construct(o, []);
+            } catch (C) {
+              n = C;
+            }
+            Reflect.construct(e, [], o);
+          } else {
+            try {
+              o.call();
+            } catch (C) {
+              n = C;
+            }
+            e.call(o.prototype);
+          }
+        } else {
+          try {
+            throw Error();
+          } catch (C) {
+            n = C;
+          }
+          e();
+        }
+      } catch (C) {
+        if (C && n && typeof C.stack == "string") {
+          for (var a = C.stack.split(`
+`), O = n.stack.split(`
+`), b = a.length - 1, h = O.length - 1; b >= 1 && h >= 0 && a[b] !== O[h]; )
+            h--;
+          for (; b >= 1 && h >= 0; b--, h--)
+            if (a[b] !== O[h]) {
+              if (b !== 1 || h !== 1)
+                do
+                  if (b--, h--, h < 0 || a[b] !== O[h]) {
+                    var x = `
+` + a[b].replace(" at new ", " at ");
+                    return e.displayName && x.includes("<anonymous>") && (x = x.replace("<anonymous>", e.displayName)), typeof e == "function" && N.set(e, x), x;
+                  }
+                while (b >= 1 && h >= 0);
+              break;
+            }
+        }
+      } finally {
+        G = !1, B.current = s, qe(), Error.prepareStackTrace = u;
+      }
+      var V = e ? e.displayName || e.name : "", F = V ? L(V) : "";
+      return typeof e == "function" && N.set(e, F), F;
+    }
+    function Be(e, r, t) {
+      return de(e, !1);
+    }
+    function ze(e) {
+      var r = e.prototype;
+      return !!(r && r.isReactComponent);
+    }
+    function U(e, r, t) {
+      if (e == null)
+        return "";
+      if (typeof e == "function")
+        return de(e, ze(e));
+      if (typeof e == "string")
+        return L(e);
+      switch (e) {
+        case v:
+          return L("Suspense");
+        case p:
+          return L("SuspenseList");
+      }
+      if (typeof e == "object")
+        switch (e.$$typeof) {
+          case f:
+            return Be(e.render);
+          case _:
+            return U(e.type, r, t);
+          case w: {
+            var n = e, u = n._payload, s = n._init;
+            try {
+              return U(s(u), r, t);
+            } catch {
+            }
+          }
+        }
+      return "";
+    }
+    var W = Object.prototype.hasOwnProperty, ve = {}, pe = S.ReactDebugCurrentFrame;
+    function J(e) {
+      if (e) {
+        var r = e._owner, t = U(e.type, e._source, r ? r.type : null);
+        pe.setExtraStackFrame(t);
+      } else
+        pe.setExtraStackFrame(null);
+    }
+    function Ge(e, r, t, n, u) {
+      {
+        var s = Function.call.bind(W);
+        for (var o in e)
+          if (s(e, o)) {
+            var a = void 0;
+            try {
+              if (typeof e[o] != "function") {
+                var O = Error((n || "React class") + ": " + t + " type `" + o + "` is invalid; it must be a function, usually from the `prop-types` package, but received `" + typeof e[o] + "`.This often happens because of typos such as `PropTypes.function` instead of `PropTypes.func`.");
+                throw O.name = "Invariant Violation", O;
+              }
+              a = e[o](r, o, n, t, null, "SECRET_DO_NOT_PASS_THIS_OR_YOU_WILL_BE_FIRED");
+            } catch (b) {
+              a = b;
+            }
+            a && !(a instanceof Error) && (J(u), T("%s: type specification of %s `%s` is invalid; the type checker function must return `null` or an `Error` but returned a %s. You may have forgotten to pass an argument to the type checker creator (arrayOf, instanceOf, objectOf, oneOf, oneOfType, and shape all require an argument).", n || "React class", t, o, typeof a), J(null)), a instanceof Error && !(a.message in ve) && (ve[a.message] = !0, J(u), T("Failed %s type: %s", t, a.message), J(null));
+          }
+      }
+    }
+    var Xe = Array.isArray;
+    function X(e) {
+      return Xe(e);
+    }
+    function He(e) {
+      {
+        var r = typeof Symbol == "function" && Symbol.toStringTag, t = r && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        return t;
+      }
+    }
+    function Ze(e) {
+      try {
+        return ge(e), !1;
+      } catch {
+        return !0;
+      }
+    }
+    function ge(e) {
+      return "" + e;
+    }
+    function ye(e) {
+      if (Ze(e))
+        return T("The provided key is an unsupported type %s. This value must be coerced to a string before before using it here.", He(e)), ge(e);
+    }
+    var be = S.ReactCurrentOwner, Qe = {
+      key: !0,
+      ref: !0,
+      __self: !0,
+      __source: !0
+    }, he, Ee;
+    function er(e) {
+      if (W.call(e, "ref")) {
+        var r = Object.getOwnPropertyDescriptor(e, "ref").get;
+        if (r && r.isReactWarning)
+          return !1;
+      }
+      return e.ref !== void 0;
+    }
+    function rr(e) {
+      if (W.call(e, "key")) {
+        var r = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (r && r.isReactWarning)
+          return !1;
+      }
+      return e.key !== void 0;
+    }
+    function tr(e, r) {
+      typeof e.ref == "string" && be.current;
+    }
+    function nr(e, r) {
+      {
+        var t = function() {
+          he || (he = !0, T("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)", r));
+        };
+        t.isReactWarning = !0, Object.defineProperty(e, "key", {
+          get: t,
+          configurable: !0
+        });
+      }
+    }
+    function ar(e, r) {
+      {
+        var t = function() {
+          Ee || (Ee = !0, T("%s: `ref` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://reactjs.org/link/special-props)", r));
+        };
+        t.isReactWarning = !0, Object.defineProperty(e, "ref", {
+          get: t,
+          configurable: !0
+        });
+      }
+    }
+    var or = function(e, r, t, n, u, s, o) {
+      var a = {
+        // This tag allows us to uniquely identify this as a React Element
+        $$typeof: i,
+        // Built-in properties that belong on the element
+        type: e,
+        key: r,
+        ref: t,
+        props: o,
+        // Record the component responsible for creating this element.
+        _owner: s
+      };
+      return a._store = {}, Object.defineProperty(a._store, "validated", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: !1
+      }), Object.defineProperty(a, "_self", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !1,
+        value: n
+      }), Object.defineProperty(a, "_source", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !1,
+        value: u
+      }), Object.freeze && (Object.freeze(a.props), Object.freeze(a)), a;
+    };
+    function ir(e, r, t, n, u) {
+      {
+        var s, o = {}, a = null, O = null;
+        t !== void 0 && (ye(t), a = "" + t), rr(r) && (ye(r.key), a = "" + r.key), er(r) && (O = r.ref, tr(r, u));
+        for (s in r)
+          W.call(r, s) && !Qe.hasOwnProperty(s) && (o[s] = r[s]);
+        if (e && e.defaultProps) {
+          var b = e.defaultProps;
+          for (s in b)
+            o[s] === void 0 && (o[s] = b[s]);
+        }
+        if (a || O) {
+          var h = typeof e == "function" ? e.displayName || e.name || "Unknown" : e;
+          a && nr(o, h), O && ar(o, h);
+        }
+        return or(e, a, O, u, n, be.current, o);
+      }
+    }
+    var H = S.ReactCurrentOwner, me = S.ReactDebugCurrentFrame;
+    function I(e) {
+      if (e) {
+        var r = e._owner, t = U(e.type, e._source, r ? r.type : null);
+        me.setExtraStackFrame(t);
+      } else
+        me.setExtraStackFrame(null);
+    }
+    var Z;
+    Z = !1;
+    function Q(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === i;
+    }
+    function Re() {
+      {
+        if (H.current) {
+          var e = D(H.current.type);
+          if (e)
+            return `
+
+Check the render method of \`` + e + "`.";
+        }
+        return "";
+      }
+    }
+    function ur(e) {
+      return "";
+    }
+    var _e = {};
+    function sr(e) {
+      {
+        var r = Re();
+        if (!r) {
+          var t = typeof e == "string" ? e : e.displayName || e.name;
+          t && (r = `
+
+Check the top-level render call using <` + t + ">.");
+        }
+        return r;
+      }
+    }
+    function Se(e, r) {
+      {
+        if (!e._store || e._store.validated || e.key != null)
+          return;
+        e._store.validated = !0;
+        var t = sr(r);
+        if (_e[t])
+          return;
+        _e[t] = !0;
+        var n = "";
+        e && e._owner && e._owner !== H.current && (n = " It was passed a child from " + D(e._owner.type) + "."), I(e), T('Each child in a list should have a unique "key" prop.%s%s See https://reactjs.org/link/warning-keys for more information.', t, n), I(null);
+      }
+    }
+    function Te(e, r) {
+      {
+        if (typeof e != "object")
+          return;
+        if (X(e))
+          for (var t = 0; t < e.length; t++) {
+            var n = e[t];
+            Q(n) && Se(n, r);
+          }
+        else if (Q(e))
+          e._store && (e._store.validated = !0);
+        else if (e) {
+          var u = E(e);
+          if (typeof u == "function" && u !== e.entries)
+            for (var s = u.call(e), o; !(o = s.next()).done; )
+              Q(o.value) && Se(o.value, r);
+        }
+      }
+    }
+    function cr(e) {
+      {
+        var r = e.type;
+        if (r == null || typeof r == "string")
+          return;
+        var t;
+        if (typeof r == "function")
+          t = r.propTypes;
+        else if (typeof r == "object" && (r.$$typeof === f || // Note: Memo only checks outer props here.
+        // Inner props are checked in the reconciler.
+        r.$$typeof === _))
+          t = r.propTypes;
+        else
+          return;
+        if (t) {
+          var n = D(r);
+          Ge(t, e.props, "prop", n, e);
+        } else if (r.PropTypes !== void 0 && !Z) {
+          Z = !0;
+          var u = D(r);
+          T("Component %s declared `PropTypes` instead of `propTypes`. Did you misspell the property assignment?", u || "Unknown");
+        }
+        typeof r.getDefaultProps == "function" && !r.getDefaultProps.isReactClassApproved && T("getDefaultProps is only used on classic React.createClass definitions. Use a static property named `defaultProps` instead.");
+      }
+    }
+    function fr(e) {
+      {
+        for (var r = Object.keys(e.props), t = 0; t < r.length; t++) {
+          var n = r[t];
+          if (n !== "children" && n !== "key") {
+            I(e), T("Invalid prop `%s` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.", n), I(null);
+            break;
+          }
+        }
+        e.ref !== null && (I(e), T("Invalid attribute `ref` supplied to `React.Fragment`."), I(null));
+      }
+    }
+    var Oe = {};
+    function Pe(e, r, t, n, u, s) {
+      {
+        var o = Ne(e);
+        if (!o) {
+          var a = "";
+          (e === void 0 || typeof e == "object" && e !== null && Object.keys(e).length === 0) && (a += " You likely forgot to export your component from the file it's defined in, or you might have mixed up default and named imports.");
+          var O = ur();
+          O ? a += O : a += Re();
+          var b;
+          e === null ? b = "null" : X(e) ? b = "array" : e !== void 0 && e.$$typeof === i ? (b = "<" + (D(e.type) || "Unknown") + " />", a = " Did you accidentally export a JSX literal instead of a component?") : b = typeof e, T("React.jsx: type is invalid -- expected a string (for built-in components) or a class/function (for composite components) but got: %s.%s", b, a);
+        }
+        var h = ir(e, r, t, u, s);
+        if (h == null)
+          return h;
+        if (o) {
+          var x = r.children;
+          if (x !== void 0)
+            if (n)
+              if (X(x)) {
+                for (var V = 0; V < x.length; V++)
+                  Te(x[V], e);
+                Object.freeze && Object.freeze(x);
+              } else
+                T("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");
+            else
+              Te(x, e);
+        }
+        if (W.call(r, "key")) {
+          var F = D(e), C = Object.keys(r).filter(function(yr) {
+            return yr !== "key";
+          }), ee = C.length > 0 ? "{key: someKey, " + C.join(": ..., ") + ": ...}" : "{key: someKey}";
+          if (!Oe[F + ee]) {
+            var gr = C.length > 0 ? "{" + C.join(": ..., ") + ": ...}" : "{}";
+            T(`A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`, ee, F, gr, F), Oe[F + ee] = !0;
+          }
+        }
+        return e === g ? fr(h) : cr(h), h;
+      }
+    }
+    function lr(e, r, t) {
+      return Pe(e, r, t, !0);
+    }
+    function dr(e, r, t) {
+      return Pe(e, r, t, !1);
+    }
+    var vr = dr, pr = lr;
+    M.Fragment = g, M.jsx = vr, M.jsxs = pr;
+  })()), M;
+}
+var xe;
+function wr() {
+  return xe || (xe = 1, process.env.NODE_ENV === "production" ? q.exports = Pr() : q.exports = Cr()), q.exports;
+}
+var xr = wr();
+const Fe = br({
+  stateVocab: {},
+  setStateVocab: () => {
+  }
+});
+function jr() {
+  return Er(Fe);
+}
+const Dr = ({ children: d }) => {
+  const [i, c] = hr({});
+  return console.log(i), /* @__PURE__ */ xr.jsx(Fe.Provider, { value: { stateVocab: i, setStateVocab: c }, children: d });
+};
+function Ar(d = {}) {
+  const {
+    storage: i,
+    serialize: c = JSON.stringify,
+    deserialize: g = JSON.parse,
+    defaultValue: l
+  } = d;
+  return {
+    [Ae]: !0,
+    // marks this object as a leaf in the router tree
+    [K]: "",
+    // placeholder; injected at runtime by injectPaths()
+    useState(m, R) {
+      R ??= {};
+      const y = Or(
+        R.onSet ?? (() => {
+        }),
+        R.delayedSet,
+        []
+      ), f = jr(), v = this[K], p = () => typeof m == "function" ? m() : m ?? l, _ = re(
+        () => {
+          if (!i)
+            return;
+          const P = i.getItem(v);
+          let E;
+          if (P === null) {
+            const S = p();
+            if (typeof S > "u")
+              return;
+            E = S;
+          } else
+            E = g(P);
+          return E;
+        },
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+        [v]
+      ), w = re(
+        () => _r(
+          f.stateVocab,
+          v,
+          _ ?? p()
+        ),
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+        [
+          f.stateVocab,
+          _,
+          v
+        ]
+      ), k = (P) => (E) => {
+        const S = { ...E };
+        return Sr(S, v, P), S;
+      };
+      mr(
+        () => {
+          !i || !_ || f.setStateVocab(k(_));
+        },
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+        [_]
+      );
+      const j = Rr(w);
+      return [
+        w,
+        function(E) {
+          const S = typeof E == "function" ? E(j.current) : E;
+          f.setStateVocab(k(S)), y(S, j.current), i && i.setItem(v, c(S)), j.current = S;
+        },
+        function() {
+          const E = p();
+          if (typeof E > "u") {
+            i?.removeItem(v);
+            return;
+          }
+          f.setStateVocab(k(E)), y(E, j.current), j.current = E, i && i.setItem(v, c(E));
+        }
+      ];
+    },
+    /** Returns the fully qualified job name (dot-separated path). */
+    toString() {
+      return this[K];
+    }
+  };
+}
+const je = /* @__PURE__ */ new WeakMap(), ke = /* @__PURE__ */ new WeakMap();
+function Ie(d, i = "") {
+  let c = je.get(d);
+  c || (c = /* @__PURE__ */ new Map(), je.set(d, c));
+  const g = c.get(i);
+  if (g)
+    return g;
+  const l = new Proxy(d, {
+    get(m, R) {
+      const y = m[R], f = i ? `${i}.${String(R)}` : String(R);
+      if (y && typeof y == "object" && Ae in y) {
+        const v = y;
+        let p = ke.get(v);
+        p || (p = /* @__PURE__ */ new Map(), ke.set(v, p));
+        const _ = p.get(f);
+        if (_)
+          return _;
+        const w = Reflect.ownKeys(v).filter(
+          (P) => typeof v[P] == "function"
+        ), k = Object.fromEntries(
+          w.map((P) => [
+            P,
+            (...E) => v[P].call(
+              { ...v, [K]: f },
+              ...E
+            )
+          ])
+        ), j = { ...v, ...k };
+        return p.set(f, j), j;
+      }
+      return y && typeof y == "object" ? Ie(y, f) : y;
+    }
+  });
+  return c.set(i, l), l;
+}
+function Fr(d) {
+  return Ie(d);
+}
+export {
+  Dr as StorageProvider,
+  Ar as defineState,
+  Fr as setupStorage
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@yakocloud/state-vocab",
+  "version": "1.0.1",
+  "main": "dist/state-vocab.cjs.js",
+  "module": "dist/state-vocab.es.js",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "build:types": "tsc --project tsconfig.types.json"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4"
+  }
+}