@yakocloud/state-vocab 4.0.0 → 4.0.1

package/README.md

@@ -359,7 +359,7 @@ export default async function Page() {
 
   return (
     <StateVocabProvider
-      value={serverStorage({
+      value={serverStorage.set({
         user: { name: user.name, role: user.role },
         person: { address: { city: user.city } },
       })}
@@ -398,21 +398,21 @@ export default function UserInfoClient() {
 
 #### `serverify(storage)`
 
-Converts a storage tree into its server-side counterpart. Each leaf gains a `.getState()` method that reads the value seeded into the nearest `StateVocabProvider`. All namespace nodes become callable functions that build the `value` shape expected by `StateVocabProvider`.
+Converts a storage tree into its server-side counterpart. Each leaf gains a `.getState()` method that reads the value seeded into the nearest `StateVocabProvider`. Each namespace node (including the root) gains a `.set()` method that returns the input wrapped under its full ancestor path, ready for `StateVocabProvider`'s `value` prop.
 
-**Namespace callable syntax:**
+**`.set()` syntax:**
 
 ```ts
-// Full tree at once — root call is identity (returns input as-is)
-serverStorage({ user: { name: 'Alice', role: 'Admin' } })
+// Full tree at once — root .set() returns input as-is
+serverStorage.set({ user: { name: 'Alice', role: 'Admin' } })
 // → { user: { name: 'Alice', role: 'Admin' } }
 
 // Single namespace — wraps input under its key
-serverStorage.user({ name: 'Alice', role: 'Admin' })
+serverStorage.user.set({ name: 'Alice', role: 'Admin' })
 // → { user: { name: 'Alice', role: 'Admin' } }
 
 // Nested namespace — wraps up to the root
-serverStorage.person.address({ city: 'NY' })
+serverStorage.person.address.set({ city: 'NY' })
 // → { person: { address: { city: 'NY' } } }
 ```
 
@@ -421,8 +421,8 @@ All three forms return a value ready to pass as `StateVocabProvider`'s `value` p
 ```tsx
 <StateVocabProvider
   value={{
-    ...serverStorage.user({ name: 'Alice', role: 'Admin' }),
-    ...serverStorage.person.address({ city: 'NY' }),
+    ...serverStorage.user.set({ name: 'Alice', role: 'Admin' }),
+    ...serverStorage.person.address.set({ city: 'NY' }),
   }}
 >
 ```
@@ -649,7 +649,7 @@ A React context provider that initializes a `VocabStore` for its subtree. Requir
 Accepts an optional `value` prop (imported from `@yakocloud/state-vocab/server` in RSC contexts) to pre-seed the store with server-fetched data:
 
 ```tsx
-<StateVocabProvider value={serverStorage({ user: { name: 'Alice' } })}>
+<StateVocabProvider value={serverStorage.set({ user: { name: 'Alice' } })}>
   <App />
 </StateVocabProvider>
 ```
@@ -658,16 +658,16 @@ Accepts an optional `value` prop (imported from `@yakocloud/state-vocab/server`
 
 Converts a storage tree to its server-side counterpart. Available from `@yakocloud/state-vocab/server`.
 
-Each leaf gains `.getState()` — reads the value from the nearest `StateVocabProvider`. Each namespace node becomes callable, returning the input wrapped under its full ancestor path (ready for `StateVocabProvider`'s `value` prop).
+Each leaf gains `.getState()` — reads the value from the nearest `StateVocabProvider`. Each namespace node gains `.set()`, which returns the input wrapped under its full ancestor path (ready for `StateVocabProvider`'s `value` prop).
 
 ```ts
 import { serverify } from '@yakocloud/state-vocab/server'
 const serverStorage = serverify(storage)
 
-serverStorage.user.name.getState()           // reads "user.name" from context
-serverStorage.user({ name: 'Alice' })        // → { user: { name: 'Alice' } }
-serverStorage.person.address({ city: 'NY' }) // → { person: { address: { city: 'NY' } } }
-serverStorage({ user: { name: 'Alice' } })   // → { user: { name: 'Alice' } } (identity)
+serverStorage.user.name.getState()                  // reads "user.name" from context
+serverStorage.user.set({ name: 'Alice' })           // → { user: { name: 'Alice' } }
+serverStorage.person.address.set({ city: 'NY' })    // → { person: { address: { city: 'NY' } } }
+serverStorage.set({ user: { name: 'Alice' } })      // → { user: { name: 'Alice' } } (identity)
 ```
 
 ### `clientify<T>(storage: T)`

package/dist/server.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react/jsx-runtime"),v=require("react"),b=require("node:async_hooks"),y=require("./provider.client--OPImdtY.js"),u=require("./utils-33NqsZoR.js");function g(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const n=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,n.get?n:{enumerable:!0,get:()=>e[r]})}}return t.default=e,Object.freeze(t)}const P=g(b),l=e=>{if(v.useState)throw new Error(`${e} only intended for Server Components`)};let i=null;try{l("StateVocabServerContext"),i=new P.AsyncLocalStorage}catch{i=null}const h=({value:e})=>(i?.enterWith({value:e}),null),j=({children:e})=>e,x=async e=>{l("StateVocabServerContext.Provider");const{value:t,children:r}=e;return c.jsxs(c.Fragment,{children:[c.jsx(h,{value:t}),r]})},V=()=>(l("getStateVocab"),i?.getStore()?.value),m={Provider:i?x:j},p=({value:e,children:t})=>c.jsx(m.Provider,{value:e,children:t});function w(e){const{children:t,value:r={}}=e;return c.jsx(p,{value:r,children:c.jsx(y.StateVocabClientProvider,{value:r,children:t})})}function O(){const e=this[u.STATE_PATH],t=V();if(!t)throw new Error("Make sure your component is wrapped in StateVocabProvider");return u.get(t,e)}function f(e,t){return new Proxy(e,{get(r,n,o){return n in t?Reflect.get(t,n,o):Reflect.get(r,n,o)},has(r,n){return n in t||n in r}})}function k(e){return typeof e=="object"&&e!==null&&"serverSlot"in e}function S(e,t){const r={};for(const n in e){const o=e[n];if(k(o))r[n]=o.serverSlot({getState(...s){return O.apply(this,s)}}),delete r[n].serverSlot,delete r[n].clientSlot;else if(o!==null&&typeof o=="object"){const s=a=>t({[n]:a}),d=S(o,s);r[n]=f(a=>s(a),d)}else r[n]=o}return f(n=>t(n),r)}function C(e){return S(e,t=>t)}exports.StateVocabProvider=w;exports.serverify=C;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react/jsx-runtime"),d=require("react"),v=require("node:async_hooks"),f=require("./provider.client--OPImdtY.js"),l=require("./utils-33NqsZoR.js");function b(e){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const r in e)if(r!=="default"){const o=Object.getOwnPropertyDescriptor(e,r);Object.defineProperty(t,r,o.get?o:{enumerable:!0,get:()=>e[r]})}}return t.default=e,Object.freeze(t)}const y=b(v),a=e=>{if(d.useState)throw new Error(`${e} only intended for Server Components`)};let s=null;try{a("StateVocabServerContext"),s=new y.AsyncLocalStorage}catch{s=null}const p=({value:e})=>(s?.enterWith({value:e}),null),g=({children:e})=>e,P=async e=>{a("StateVocabServerContext.Provider");const{value:t,children:r}=e;return c.jsxs(c.Fragment,{children:[c.jsx(p,{value:t}),r]})},h=()=>(a("getStateVocab"),s?.getStore()?.value),j={Provider:s?P:g},V=({value:e,children:t})=>c.jsx(j.Provider,{value:e,children:t});function m(e){const{children:t,value:r={}}=e;return c.jsx(V,{value:r,children:c.jsx(f.StateVocabClientProvider,{value:r,children:t})})}function x(){const e=this[l.STATE_PATH],t=h();if(!t)throw new Error("Make sure your component is wrapped in StateVocabProvider");return l.get(t,e)}function O(e){return typeof e=="object"&&e!==null&&"serverSlot"in e}function u(e,t){const r={};for(const o in e){const n=e[o];if(O(n))r[o]=n.serverSlot({getState(...i){return x.apply(this,i)}}),delete r[o].serverSlot,delete r[o].clientSlot;else if(n!==null&&typeof n=="object"){const i=S=>t({[o]:S});r[o]=u(n,i)}else r[o]=n}return r.set=o=>t(o),r}function k(e){return u(e,t=>t)}exports.StateVocabProvider=m;exports.serverify=k;

package/dist/server.es.js

@@ -1,77 +1,64 @@
-import { jsxs as v, Fragment as d, jsx as a } from "react/jsx-runtime";
-import h from "react";
-import * as y from "node:async_hooks";
-import { S as b } from "./provider.client-CtAC9tPr.mjs";
-import { S as g, g as m } from "./utils-t8tYdd6B.mjs";
-const l = (e) => {
-  if (h.useState)
+import { jsxs as u, Fragment as v, jsx as s } from "react/jsx-runtime";
+import f from "react";
+import * as d from "node:async_hooks";
+import { S as p } from "./provider.client-CtAC9tPr.mjs";
+import { S as h, g as m } from "./utils-t8tYdd6B.mjs";
+const i = (e) => {
+  if (f.useState)
     throw new Error(`${e} only intended for Server Components`);
 };
 let c = null;
 try {
-  l("StateVocabServerContext"), c = new y.AsyncLocalStorage();
+  i("StateVocabServerContext"), c = new d.AsyncLocalStorage();
 } catch {
   c = null;
 }
-const P = ({ value: e }) => (c?.enterWith({ value: e }), null), V = ({ children: e }) => e, x = async (e) => {
-  l("StateVocabServerContext.Provider");
-  const { value: t, children: n } = e;
-  return /* @__PURE__ */ v(d, { children: [
-    /* @__PURE__ */ a(P, { value: t }),
-    n
+const y = ({ value: e }) => (c?.enterWith({ value: e }), null), b = ({ children: e }) => e, P = async (e) => {
+  i("StateVocabServerContext.Provider");
+  const { value: t, children: r } = e;
+  return /* @__PURE__ */ u(v, { children: [
+    /* @__PURE__ */ s(y, { value: t }),
+    r
   ] });
-}, w = () => (l("getStateVocab"), c?.getStore()?.value), C = {
-  Provider: c ? x : V
-}, p = ({ value: e, children: t }) => /* @__PURE__ */ a(C.Provider, { value: e, children: t });
-function H(e) {
-  const { children: t, value: n = {} } = e;
-  return /* @__PURE__ */ a(p, { value: n, children: /* @__PURE__ */ a(b, { value: n, children: t }) });
+}, g = () => (i("getStateVocab"), c?.getStore()?.value), V = {
+  Provider: c ? P : b
+}, x = ({ value: e, children: t }) => /* @__PURE__ */ s(V.Provider, { value: e, children: t });
+function T(e) {
+  const { children: t, value: r = {} } = e;
+  return /* @__PURE__ */ s(x, { value: r, children: /* @__PURE__ */ s(p, { value: r, children: t }) });
 }
-function j() {
-  const e = this[g], t = w();
+function C() {
+  const e = this[h], t = g();
   if (!t)
     throw new Error("Make sure your component is wrapped in StateVocabProvider");
   return m(t, e);
 }
-function u(e, t) {
-  return new Proxy(e, {
-    get(n, r, o) {
-      return r in t ? Reflect.get(t, r, o) : Reflect.get(n, r, o);
-    },
-    has(n, r) {
-      return r in t || r in n;
-    }
-  });
-}
-function k(e) {
+function w(e) {
   return typeof e == "object" && e !== null && "serverSlot" in e;
 }
-function S(e, t) {
-  const n = {};
-  for (const r in e) {
-    const o = e[r];
-    if (k(o))
-      n[r] = o.serverSlot({
+function l(e, t) {
+  const r = {};
+  for (const o in e) {
+    const n = e[o];
+    if (w(n))
+      r[o] = n.serverSlot({
         // Slot definition
-        getState(...i) {
-          return j.apply(this, i);
+        getState(...a) {
+          return C.apply(this, a);
         }
-      }), delete n[r].serverSlot, delete n[r].clientSlot;
-    else if (o !== null && typeof o == "object") {
-      const i = (s) => t({ [r]: s }), f = S(o, i);
-      n[r] = u(
-        (s) => i(s),
-        f
-      );
+      }), delete r[o].serverSlot, delete r[o].clientSlot;
+    else if (n !== null && typeof n == "object") {
+      const a = (S) => t({ [o]: S });
+      r[o] = l(n, a);
     } else
-      n[r] = o;
+      r[o] = n;
   }
-  return u((r) => t(r), n);
+  return r.set = (o) => t(o), r;
 }
-function W(e) {
-  return S(e, (t) => t);
+function H(e) {
+  return l(e, (t) => t);
 }
 export {
-  H as StateVocabProvider,
-  W as serverify
+  T as StateVocabProvider,
+  H as serverify
 };

package/dist/types/setup.server.d.ts

@@ -8,10 +8,14 @@ type Slot<V> = {
 type ServerifiedValue<R> = {
     [K in keyof R]?: R[K] extends Slot<infer V> ? V : R[K] extends object ? ServerifiedValue<R[K]> : R[K];
 };
-type Serverified<R> = R extends Slot<infer TValue> ? Placeholder<TValue> : R extends object ? ((input: ServerifiedValue<R>) => Vocab) & {
+type Serverified<R> = R extends Slot<infer TValue> ? Placeholder<TValue> : R extends object ? {
+    set(input: ServerifiedValue<R>): Vocab;
+} & {
     [K in keyof R]: Serverified<R[K]>;
 } : R;
-type ServerifyResult<R extends object> = ((input: ServerifiedValue<R>) => Vocab) & {
+type ServerifyResult<R extends object> = {
+    set(input: ServerifiedValue<R>): Vocab;
+} & {
     [K in keyof R]: Serverified<R[K]>;
 };
 export declare function serverify<R extends object>(tree: R): ServerifyResult<R>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yakocloud/state-vocab",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
   "types": "dist/types/index.d.ts",