valyrian.js 9.0.0 → 9.1.0

package/README.md

@@ -10,17 +10,17 @@
 ![](https://badgen.net/npm/types/valyrian.js)
 [![License](https://img.shields.io/github/license/masquerade-circus/valyrian.js.svg)](https://github.com/masquerade-circus/valyrian.js/blob/main/LICENSE)
 
-![](https://badgen.net/badgesize/normal/masquerade-circus/valyrian.js/main/dist/index.min.js)
-![](https://badgen.net/badgesize/gzip/masquerade-circus/valyrian.js/main/dist/index.min.js)
-![](https://badgen.net/badgesize/brotli/masquerade-circus/valyrian.js/main/dist/index.min.js)
+[![Minified size](assets/badges/size-min.svg)](dist/index.min.js)
+[![Gzip size](assets/badges/size-gzip.svg)](dist/index.min.js)
+[![Brotli size](assets/badges/size-brotli.svg)](dist/index.min.js)
 
-![Travis (.org)](https://img.shields.io/travis/masquerade-circus/valyrian.js)
+[![Test](https://github.com/Masquerade-Circus/valyrian.js/actions/workflows/test.yml/badge.svg)](https://github.com/Masquerade-Circus/valyrian.js/actions/workflows/test.yml)
 ![Libraries.io dependency status for latest release](https://img.shields.io/librariesio/release/npm/valyrian.js)
-[![Maintainability](https://api.codeclimate.com/v1/badges/aa7528a4a6b0d264e4d6/maintainability)](https://codeclimate.com/github/Masquerade-Circus/valyrian.js/maintainability)
+[![CodeQL](https://github.com/Masquerade-Circus/valyrian.js/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/Masquerade-Circus/valyrian.js/actions/workflows/codeql-analysis.yml)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/8d5204c73bdc42089e4cebdb4b4d43e0)](https://www.codacy.com/gh/Masquerade-Circus/valyrian.js/dashboard?utm_source=github.com\&utm_medium=referral\&utm_content=Masquerade-Circus/valyrian.js\&utm_campaign=Badge_Grade)
 
 ![](https://img.shields.io/github/issues/masquerade-circus/valyrian.js.svg)
-[![Coverage Status](https://coveralls.io/repos/github/Masquerade-Circus/valyrian.js/badge.svg?branch=main)](https://coveralls.io/github/Masquerade-Circus/valyrian.js?branch=main)
+[![Coverage](assets/badges/coverage.svg)](https://github.com/Masquerade-Circus/valyrian.js/actions/workflows/test.yml)
 
 </p>
 
@@ -92,7 +92,7 @@ If this works, you already have the core Valyrian mental model.
 * Introduction: [docs/1-introduction.md](docs/1-introduction.md)
 * Getting Started (No-Build First): [docs/2-getting-started.md](docs/2-getting-started.md)
 * The Essentials: [docs/3-the-essentials.md](docs/3-the-essentials.md)
-* Runtime core API reference: [docs/3-runtime-core.md](docs/3-runtime-core.md)
+* Runtime core API reference: [docs/3.1-runtime-core.md](docs/3.1-runtime-core.md)
 * Building Single Page Applications (SPA Hub): [docs/4-building-spa.md](docs/4-building-spa.md)
 * Advanced State Management (Hub): [docs/5-advanced-state-management.md](docs/5-advanced-state-management.md)
 * The Full-Stack Capability (Isomorphism Hub): [docs/7-full-stack-capability.md](docs/7-full-stack-capability.md)
@@ -121,18 +121,21 @@ Not the best fit:
 
 Valyrian.js tests are behavior-first and API-contract driven. Public modules validate happy paths, edge cases, and runtime consistency across browser-like and Node-like environments. Documentation examples are kept aligned with tested behavior.
 
-## Tests
+## Tests (Framework Repository)
 
 ```bash
-npm test
+bun test
 ```
 
-For development mode:
+For development mode in this repository:
 
 ```bash
-npm run dev:test
+bun run dev:test
 ```
 
+These commands are for contributors developing this framework repository.
+For app usage, keep following [docs/2-getting-started.md](docs/2-getting-started.md).
+
 ## More Guides
 
 * Recipes and integrations: [docs/9-recipes-and-integrations.md](docs/9-recipes-and-integrations.md)

package/dist/context/index.js

@@ -0,0 +1,119 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// lib/context/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createContextScope: () => createContextScope,
+  getContext: () => getContext,
+  hasContext: () => hasContext,
+  isServerContextActive: () => isServerContextActive,
+  runWithContext: () => runWithContext,
+  setContext: () => setContext
+});
+module.exports = __toCommonJS(index_exports);
+var import_valyrian = require("valyrian.js");
+var NODE_CONTEXT_STORE_KEY = "__valyrian_context_values__";
+var browserContextStore = /* @__PURE__ */ new Map();
+function createContextScope(name) {
+  return {
+    key: Symbol(name),
+    name
+  };
+}
+function getNodeStoreObject() {
+  if (!import_valyrian.isNodeJs || typeof sessionStorage === "undefined") {
+    return null;
+  }
+  const storage = sessionStorage;
+  if (!storage.store || typeof storage.store !== "object") {
+    return null;
+  }
+  return storage.store;
+}
+function getScopeMap(create = false) {
+  const nodeStore = getNodeStoreObject();
+  if (nodeStore) {
+    const existingMap = nodeStore[NODE_CONTEXT_STORE_KEY];
+    if (existingMap) {
+      return existingMap;
+    }
+    if (create) {
+      const nextMap = /* @__PURE__ */ new Map();
+      nodeStore[NODE_CONTEXT_STORE_KEY] = nextMap;
+      return nextMap;
+    }
+    return null;
+  }
+  if (create) {
+    return browserContextStore;
+  }
+  return browserContextStore.size > 0 ? browserContextStore : null;
+}
+function isServerContextActive() {
+  if (!import_valyrian.isNodeJs || typeof sessionStorage === "undefined") {
+    return false;
+  }
+  const maybeServerStorage = sessionStorage;
+  if (typeof maybeServerStorage.isContextActive === "function") {
+    return Boolean(maybeServerStorage.isContextActive());
+  }
+  return false;
+}
+function getContext(scope) {
+  const map = getScopeMap(false);
+  if (!map) {
+    return void 0;
+  }
+  return map.get(scope.key);
+}
+function hasContext(scope) {
+  const map = getScopeMap(false);
+  if (!map) {
+    return false;
+  }
+  return map.has(scope.key);
+}
+function setContext(scope, value) {
+  const map = getScopeMap(true);
+  const hasPrevious = map.has(scope.key);
+  const previousValue = map.get(scope.key);
+  map.set(scope.key, value);
+  return () => {
+    if (!hasPrevious) {
+      map.delete(scope.key);
+      return;
+    }
+    map.set(scope.key, previousValue);
+  };
+}
+function runWithContext(scope, value, callback) {
+  const restore = setContext(scope, value);
+  try {
+    const result = callback();
+    if (result instanceof Promise) {
+      return result.finally(restore);
+    }
+    restore();
+    return result;
+  } catch (error) {
+    restore();
+    throw error;
+  }
+}

package/dist/context/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../lib/context/index.ts"],
+  "sourcesContent": ["import { isNodeJs } from \"valyrian.js\";\n\ntype ScopeMap = Map<symbol, unknown>;\n\nconst NODE_CONTEXT_STORE_KEY = \"__valyrian_context_values__\";\nconst browserContextStore: ScopeMap = new Map();\n\nexport type ContextScope<T> = {\n  key: symbol;\n  name: string;\n  // Type marker only\n  __type?: T;\n};\n\nexport function createContextScope<T>(name: string): ContextScope<T> {\n  return {\n    key: Symbol(name),\n    name\n  };\n}\n\nfunction getNodeStoreObject(): Record<string | symbol, unknown> | null {\n  if (!isNodeJs || typeof sessionStorage === \"undefined\") {\n    return null;\n  }\n\n  const storage = sessionStorage as Storage & {\n    store?: Record<string | symbol, unknown>;\n  };\n\n  if (!storage.store || typeof storage.store !== \"object\") {\n    return null;\n  }\n\n  return storage.store;\n}\n\nfunction getScopeMap(create = false): ScopeMap | null {\n  const nodeStore = getNodeStoreObject();\n  if (nodeStore) {\n    const existingMap = nodeStore[NODE_CONTEXT_STORE_KEY] as ScopeMap | undefined;\n    if (existingMap) {\n      return existingMap;\n    }\n\n    if (create) {\n      const nextMap: ScopeMap = new Map();\n      nodeStore[NODE_CONTEXT_STORE_KEY] = nextMap;\n      return nextMap;\n    }\n\n    return null;\n  }\n\n  if (create) {\n    return browserContextStore;\n  }\n\n  return browserContextStore.size > 0 ? browserContextStore : null;\n}\n\nexport function isServerContextActive() {\n  if (!isNodeJs || typeof sessionStorage === \"undefined\") {\n    return false;\n  }\n\n  const maybeServerStorage = sessionStorage as Storage & {\n    isContextActive?: () => boolean;\n  };\n\n  if (typeof maybeServerStorage.isContextActive === \"function\") {\n    return Boolean(maybeServerStorage.isContextActive());\n  }\n\n  return false;\n}\n\nexport function getContext<T>(scope: ContextScope<T>): T | undefined {\n  const map = getScopeMap(false);\n  if (!map) {\n    return undefined;\n  }\n\n  return map.get(scope.key) as T | undefined;\n}\n\nexport function hasContext<T>(scope: ContextScope<T>): boolean {\n  const map = getScopeMap(false);\n  if (!map) {\n    return false;\n  }\n\n  return map.has(scope.key);\n}\n\nexport function setContext<T>(scope: ContextScope<T>, value: T): () => void {\n  const map = getScopeMap(true) as ScopeMap;\n  const hasPrevious = map.has(scope.key);\n  const previousValue = map.get(scope.key);\n\n  map.set(scope.key, value);\n\n  return () => {\n    if (!hasPrevious) {\n      map.delete(scope.key);\n      return;\n    }\n    map.set(scope.key, previousValue);\n  };\n}\n\nexport function runWithContext<T, TResult>(scope: ContextScope<T>, value: T, callback: () => TResult): TResult;\nexport function runWithContext<T, TResult>(\n  scope: ContextScope<T>,\n  value: T,\n  callback: () => Promise<TResult>\n): Promise<TResult>;\nexport function runWithContext<T, TResult>(\n  scope: ContextScope<T>,\n  value: T,\n  callback: () => TResult | Promise<TResult>\n) {\n  const restore = setContext(scope, value);\n  try {\n    const result = callback();\n    if (result instanceof Promise) {\n      return result.finally(restore);\n    }\n    restore();\n    return result;\n  } catch (error) {\n    restore();\n    throw error;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAyB;AAIzB,IAAM,yBAAyB;AAC/B,IAAM,sBAAgC,oBAAI,IAAI;AASvC,SAAS,mBAAsB,MAA+B;AACnE,SAAO;AAAA,IACL,KAAK,OAAO,IAAI;AAAA,IAChB;AAAA,EACF;AACF;AAEA,SAAS,qBAA8D;AACrE,MAAI,CAAC,4BAAY,OAAO,mBAAmB,aAAa;AACtD,WAAO;AAAA,EACT;AAEA,QAAM,UAAU;AAIhB,MAAI,CAAC,QAAQ,SAAS,OAAO,QAAQ,UAAU,UAAU;AACvD,WAAO;AAAA,EACT;AAEA,SAAO,QAAQ;AACjB;AAEA,SAAS,YAAY,SAAS,OAAwB;AACpD,QAAM,YAAY,mBAAmB;AACrC,MAAI,WAAW;AACb,UAAM,cAAc,UAAU,sBAAsB;AACpD,QAAI,aAAa;AACf,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ;AACV,YAAM,UAAoB,oBAAI,IAAI;AAClC,gBAAU,sBAAsB,IAAI;AACpC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ;AACV,WAAO;AAAA,EACT;AAEA,SAAO,oBAAoB,OAAO,IAAI,sBAAsB;AAC9D;AAEO,SAAS,wBAAwB;AACtC,MAAI,CAAC,4BAAY,OAAO,mBAAmB,aAAa;AACtD,WAAO;AAAA,EACT;AAEA,QAAM,qBAAqB;AAI3B,MAAI,OAAO,mBAAmB,oBAAoB,YAAY;AAC5D,WAAO,QAAQ,mBAAmB,gBAAgB,CAAC;AAAA,EACrD;AAEA,SAAO;AACT;AAEO,SAAS,WAAc,OAAuC;AACnE,QAAM,MAAM,YAAY,KAAK;AAC7B,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,IAAI,MAAM,GAAG;AAC1B;AAEO,SAAS,WAAc,OAAiC;AAC7D,QAAM,MAAM,YAAY,KAAK;AAC7B,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,IAAI,MAAM,GAAG;AAC1B;AAEO,SAAS,WAAc,OAAwB,OAAsB;AAC1E,QAAM,MAAM,YAAY,IAAI;AAC5B,QAAM,cAAc,IAAI,IAAI,MAAM,GAAG;AACrC,QAAM,gBAAgB,IAAI,IAAI,MAAM,GAAG;AAEvC,MAAI,IAAI,MAAM,KAAK,KAAK;AAExB,SAAO,MAAM;AACX,QAAI,CAAC,aAAa;AAChB,UAAI,OAAO,MAAM,GAAG;AACpB;AAAA,IACF;AACA,QAAI,IAAI,MAAM,KAAK,aAAa;AAAA,EAClC;AACF;AAQO,SAAS,eACd,OACA,OACA,UACA;AACA,QAAM,UAAU,WAAW,OAAO,KAAK;AACvC,MAAI;AACF,UAAM,SAAS,SAAS;AACxB,QAAI,kBAAkB,SAAS;AAC7B,aAAO,OAAO,QAAQ,OAAO;AAAA,IAC/B;AACA,YAAQ;AACR,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACF;",
+  "names": []
+}

package/dist/context/index.min.js

@@ -0,0 +1 @@
+(()=>{"use strict";var e=Object.defineProperty,t=Object.getOwnPropertyDescriptor,n=Object.getOwnPropertyNames,o=Object.prototype.hasOwnProperty,r={};((t,n)=>{for(var o in n)e(t,o,{get:n[o],enumerable:!0})})(r,{createContextScope:()=>a,getContext:()=>p,hasContext:()=>d,isServerContextActive:()=>y,runWithContext:()=>v,setContext:()=>g});var s,i=(s=r,((r,s,i,u)=>{if(s&&"object"==typeof s||"function"==typeof s)for(let c of n(s))o.call(r,c)||c===i||e(r,c,{get:()=>s[c],enumerable:!(u=t(s,c))||u.enumerable});return r})(e({},"__esModule",{value:!0}),s)),u=require("valyrian.js"),c="__valyrian_context_values__",f=new Map;function a(e){return{key:Symbol(e),name:e}}function l(e=!1){const t=function(){if(!u.isNodeJs||"undefined"==typeof sessionStorage)return null;const e=sessionStorage;return e.store&&"object"==typeof e.store?e.store:null}();if(t){const n=t[c];if(n)return n;if(e){const e=new Map;return t[c]=e,e}return null}return e||f.size>0?f:null}function y(){if(!u.isNodeJs||"undefined"==typeof sessionStorage)return!1;const e=sessionStorage;return"function"==typeof e.isContextActive&&Boolean(e.isContextActive())}function p(e){const t=l(!1);if(t)return t.get(e.key)}function d(e){const t=l(!1);return!!t&&t.has(e.key)}function g(e,t){const n=l(!0),o=n.has(e.key),r=n.get(e.key);return n.set(e.key,t),()=>{o?n.set(e.key,r):n.delete(e.key)}}function v(e,t,n){const o=g(e,t);try{const e=n();return e instanceof Promise?e.finally(o):(o(),e)}catch(e){throw o(),e}}"undefined"!=typeof module?module.exports=i:self.ValyrianContext=i})();//# sourceMappingURL=index.min.js.map

package/dist/context/index.min.js.map

@@ -0,0 +1 @@
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJpbmRleF9leHBvcnRzIiwiX19leHBvcnQiLCJjcmVhdGVDb250ZXh0U2NvcGUiLCJnZXRDb250ZXh0IiwiaGFzQ29udGV4dCIsImlzU2VydmVyQ29udGV4dEFjdGl2ZSIsInJ1bldpdGhDb250ZXh0Iiwic2V0Q29udGV4dCIsIl9fRVhQT1JUU19fIiwiaW1wb3J0X3ZhbHlyaWFuIiwicmVxdWlyZSIsIk5PREVfQ09OVEVYVF9TVE9SRV9LRVkiLCJicm93c2VyQ29udGV4dFN0b3JlIiwiTWFwIiwibmFtZSIsImtleSIsIlN5bWJvbCIsImdldFNjb3BlTWFwIiwiY3JlYXRlIiwibm9kZVN0b3JlIiwiaXNOb2RlSnMiLCJzZXNzaW9uU3RvcmFnZSIsInN0b3JhZ2UiLCJzdG9yZSIsImdldE5vZGVTdG9yZU9iamVjdCIsImV4aXN0aW5nTWFwIiwibmV4dE1hcCIsInNpemUiLCJtYXliZVNlcnZlclN0b3JhZ2UiLCJpc0NvbnRleHRBY3RpdmUiLCJCb29sZWFuIiwic2NvcGUiLCJtYXAiLCJnZXQiLCJoYXMiLCJ2YWx1ZSIsImhhc1ByZXZpb3VzIiwicHJldmlvdXNWYWx1ZSIsInNldCIsImRlbGV0ZSIsImNhbGxiYWNrIiwicmVzdG9yZSIsInJlc3VsdCIsIlByb21pc2UiLCJmaW5hbGx5IiwiZXJyb3IiXSwic291cmNlcyI6WyIuLi8uLi9saWIvY29udGV4dC9pbmRleC50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBpc05vZGVKcyB9IGZyb20gXCJ2YWx5cmlhbi5qc1wiO1xuXG50eXBlIFNjb3BlTWFwID0gTWFwPHN5bWJvbCwgdW5rbm93bj47XG5cbmNvbnN0IE5PREVfQ09OVEVYVF9TVE9SRV9LRVkgPSBcIl9fdmFseXJpYW5fY29udGV4dF92YWx1ZXNfX1wiO1xuY29uc3QgYnJvd3NlckNvbnRleHRTdG9yZTogU2NvcGVNYXAgPSBuZXcgTWFwKCk7XG5cbmV4cG9ydCB0eXBlIENvbnRleHRTY29wZTxUPiA9IHtcbiAga2V5OiBzeW1ib2w7XG4gIG5hbWU6IHN0cmluZztcbiAgLy8gVHlwZSBtYXJrZXIgb25seVxuICBfX3R5cGU/OiBUO1xufTtcblxuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZUNvbnRleHRTY29wZTxUPihuYW1lOiBzdHJpbmcpOiBDb250ZXh0U2NvcGU8VD4ge1xuICByZXR1cm4ge1xuICAgIGtleTogU3ltYm9sKG5hbWUpLFxuICAgIG5hbWVcbiAgfTtcbn1cblxuZnVuY3Rpb24gZ2V0Tm9kZVN0b3JlT2JqZWN0KCk6IFJlY29yZDxzdHJpbmcgfCBzeW1ib2wsIHVua25vd24+IHwgbnVsbCB7XG4gIGlmICghaXNOb2RlSnMgfHwgdHlwZW9mIHNlc3Npb25TdG9yYWdlID09PSBcInVuZGVmaW5lZFwiKSB7XG4gICAgcmV0dXJuIG51bGw7XG4gIH1cblxuICBjb25zdCBzdG9yYWdlID0gc2Vzc2lvblN0b3JhZ2UgYXMgU3RvcmFnZSAmIHtcbiAgICBzdG9yZT86IFJlY29yZDxzdHJpbmcgfCBzeW1ib2wsIHVua25vd24+O1xuICB9O1xuXG4gIGlmICghc3RvcmFnZS5zdG9yZSB8fCB0eXBlb2Ygc3RvcmFnZS5zdG9yZSAhPT0gXCJvYmplY3RcIikge1xuICAgIHJldHVybiBudWxsO1xuICB9XG5cbiAgcmV0dXJuIHN0b3JhZ2Uuc3RvcmU7XG59XG5cbmZ1bmN0aW9uIGdldFNjb3BlTWFwKGNyZWF0ZSA9IGZhbHNlKTogU2NvcGVNYXAgfCBudWxsIHtcbiAgY29uc3Qgbm9kZVN0b3JlID0gZ2V0Tm9kZVN0b3JlT2JqZWN0KCk7XG4gIGlmIChub2RlU3RvcmUpIHtcbiAgICBjb25zdCBleGlzdGluZ01hcCA9IG5vZGVTdG9yZVtOT0RFX0NPTlRFWFRfU1RPUkVfS0VZXSBhcyBTY29wZU1hcCB8IHVuZGVmaW5lZDtcbiAgICBpZiAoZXhpc3RpbmdNYXApIHtcbiAgICAgIHJldHVybiBleGlzdGluZ01hcDtcbiAgICB9XG5cbiAgICBpZiAoY3JlYXRlKSB7XG4gICAgICBjb25zdCBuZXh0TWFwOiBTY29wZU1hcCA9IG5ldyBNYXAoKTtcbiAgICAgIG5vZGVTdG9yZVtOT0RFX0NPTlRFWFRfU1RPUkVfS0VZXSA9IG5leHRNYXA7XG4gICAgICByZXR1cm4gbmV4dE1hcDtcbiAgICB9XG5cbiAgICByZXR1cm4gbnVsbDtcbiAgfVxuXG4gIGlmIChjcmVhdGUpIHtcbiAgICByZXR1cm4gYnJvd3NlckNvbnRleHRTdG9yZTtcbiAgfVxuXG4gIHJldHVybiBicm93c2VyQ29udGV4dFN0b3JlLnNpemUgPiAwID8gYnJvd3NlckNvbnRleHRTdG9yZSA6IG51bGw7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBpc1NlcnZlckNvbnRleHRBY3RpdmUoKSB7XG4gIGlmICghaXNOb2RlSnMgfHwgdHlwZW9mIHNlc3Npb25TdG9yYWdlID09PSBcInVuZGVmaW5lZFwiKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG5cbiAgY29uc3QgbWF5YmVTZXJ2ZXJTdG9yYWdlID0gc2Vzc2lvblN0b3JhZ2UgYXMgU3RvcmFnZSAmIHtcbiAgICBpc0NvbnRleHRBY3RpdmU/OiAoKSA9PiBib29sZWFuO1xuICB9O1xuXG4gIGlmICh0eXBlb2YgbWF5YmVTZXJ2ZXJTdG9yYWdlLmlzQ29udGV4dEFjdGl2ZSA9PT0gXCJmdW5jdGlvblwiKSB7XG4gICAgcmV0dXJuIEJvb2xlYW4obWF5YmVTZXJ2ZXJTdG9yYWdlLmlzQ29udGV4dEFjdGl2ZSgpKTtcbiAgfVxuXG4gIHJldHVybiBmYWxzZTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIGdldENvbnRleHQ8VD4oc2NvcGU6IENvbnRleHRTY29wZTxUPik6IFQgfCB1bmRlZmluZWQge1xuICBjb25zdCBtYXAgPSBnZXRTY29wZU1hcChmYWxzZSk7XG4gIGlmICghbWFwKSB7XG4gICAgcmV0dXJuIHVuZGVmaW5lZDtcbiAgfVxuXG4gIHJldHVybiBtYXAuZ2V0KHNjb3BlLmtleSkgYXMgVCB8IHVuZGVmaW5lZDtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIGhhc0NvbnRleHQ8VD4oc2NvcGU6IENvbnRleHRTY29wZTxUPik6IGJvb2xlYW4ge1xuICBjb25zdCBtYXAgPSBnZXRTY29wZU1hcChmYWxzZSk7XG4gIGlmICghbWFwKSB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG5cbiAgcmV0dXJuIG1hcC5oYXMoc2NvcGUua2V5KTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHNldENvbnRleHQ8VD4oc2NvcGU6IENvbnRleHRTY29wZTxUPiwgdmFsdWU6IFQpOiAoKSA9PiB2b2lkIHtcbiAgY29uc3QgbWFwID0gZ2V0U2NvcGVNYXAodHJ1ZSkgYXMgU2NvcGVNYXA7XG4gIGNvbnN0IGhhc1ByZXZpb3VzID0gbWFwLmhhcyhzY29wZS5rZXkpO1xuICBjb25zdCBwcmV2aW91c1ZhbHVlID0gbWFwLmdldChzY29wZS5rZXkpO1xuXG4gIG1hcC5zZXQoc2NvcGUua2V5LCB2YWx1ZSk7XG5cbiAgcmV0dXJuICgpID0+IHtcbiAgICBpZiAoIWhhc1ByZXZpb3VzKSB7XG4gICAgICBtYXAuZGVsZXRlKHNjb3BlLmtleSk7XG4gICAgICByZXR1cm47XG4gICAgfVxuICAgIG1hcC5zZXQoc2NvcGUua2V5LCBwcmV2aW91c1ZhbHVlKTtcbiAgfTtcbn1cblxuZXhwb3J0IGZ1bmN0aW9uIHJ1bldpdGhDb250ZXh0PFQsIFRSZXN1bHQ+KHNjb3BlOiBDb250ZXh0U2NvcGU8VD4sIHZhbHVlOiBULCBjYWxsYmFjazogKCkgPT4gVFJlc3VsdCk6IFRSZXN1bHQ7XG5leHBvcnQgZnVuY3Rpb24gcnVuV2l0aENvbnRleHQ8VCwgVFJlc3VsdD4oXG4gIHNjb3BlOiBDb250ZXh0U2NvcGU8VD4sXG4gIHZhbHVlOiBULFxuICBjYWxsYmFjazogKCkgPT4gUHJvbWlzZTxUUmVzdWx0PlxuKTogUHJvbWlzZTxUUmVzdWx0PjtcbmV4cG9ydCBmdW5jdGlvbiBydW5XaXRoQ29udGV4dDxULCBUUmVzdWx0PihcbiAgc2NvcGU6IENvbnRleHRTY29wZTxUPixcbiAgdmFsdWU6IFQsXG4gIGNhbGxiYWNrOiAoKSA9PiBUUmVzdWx0IHwgUHJvbWlzZTxUUmVzdWx0PlxuKSB7XG4gIGNvbnN0IHJlc3RvcmUgPSBzZXRDb250ZXh0KHNjb3BlLCB2YWx1ZSk7XG4gIHRyeSB7XG4gICAgY29uc3QgcmVzdWx0ID0gY2FsbGJhY2soKTtcbiAgICBpZiAocmVzdWx0IGluc3RhbmNlb2YgUHJvbWlzZSkge1xuICAgICAgcmV0dXJuIHJlc3VsdC5maW5hbGx5KHJlc3RvcmUpO1xuICAgIH1cbiAgICByZXN0b3JlKCk7XG4gICAgcmV0dXJuIHJlc3VsdDtcbiAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICByZXN0b3JlKCk7XG4gICAgdGhyb3cgZXJyb3I7XG4gIH1cbn1cbiJdLCJtYXBwaW5ncyI6ImdKQUFBQSxFQUFBLEcseURBQUFDLENBQUFELEVBQUEsQ0FBQUUsbUJBQUEsSUFBQUEsRUFBQUMsV0FBQSxJQUFBQSxFQUFBQyxXQUFBLElBQUFBLEVBQUFDLHNCQUFBLElBQUFBLEVBQUFDLGVBQUEsSUFBQUEsRUFBQUMsV0FBQSxJQUFBQSxJQUFBLEksRUFBQUMsRyxFQUFBUixFLDBNQUFBUyxFQUF5QkMsUUFBQSxlQUluQkMsRUFBeUIsOEJBQ3pCQyxFQUFnQyxJQUFJQyxJQVNuQyxTQUFTWCxFQUFzQlksR0FDcEMsTUFBTyxDQUNMQyxJQUFLQyxPQUFPRixHQUNaQSxPQUVKLENBa0JBLFNBQVNHLEVBQVlDLEdBQVMsR0FDNUIsTUFBTUMsRUFqQlIsV0FDRSxJQUFLVixFQUFBVyxVQUFzQyxvQkFBbkJDLGVBQ3RCLE9BQU8sS0FHVCxNQUFNQyxFQUFVRCxlQUloQixPQUFLQyxFQUFRQyxPQUFrQyxpQkFBbEJELEVBQVFDLE1BSTlCRCxFQUFRQyxNQUhOLElBSVgsQ0FHb0JDLEdBQ2xCLEdBQUlMLEVBQVcsQ0FDYixNQUFNTSxFQUFjTixFQUFVUixHQUM5QixHQUFJYyxFQUNGLE9BQU9BLEVBR1QsR0FBSVAsRUFBUSxDQUNWLE1BQU1RLEVBQW9CLElBQUliLElBRTlCLE9BREFNLEVBQVVSLEdBQTBCZSxFQUM3QkEsQ0FDVCxDQUVBLE9BQU8sSUFDVCxDQUVBLE9BQUlSLEdBSUdOLEVBQW9CZSxLQUFPLEVBSHpCZixFQUdtRCxJQUM5RCxDQUVPLFNBQVNQLElBQ2QsSUFBS0ksRUFBQVcsVUFBc0Msb0JBQW5CQyxlQUN0QixPQUFPLEVBR1QsTUFBTU8sRUFBcUJQLGVBSTNCLE1BQWtELG1CQUF2Q08sRUFBbUJDLGlCQUNyQkMsUUFBUUYsRUFBbUJDLGtCQUl0QyxDQUVPLFNBQVMxQixFQUFjNEIsR0FDNUIsTUFBTUMsRUFBTWYsR0FBWSxHQUN4QixHQUFLZSxFQUlMLE9BQU9BLEVBQUlDLElBQUlGLEVBQU1oQixJQUN2QixDQUVPLFNBQVNYLEVBQWMyQixHQUM1QixNQUFNQyxFQUFNZixHQUFZLEdBQ3hCLFFBQUtlLEdBSUVBLEVBQUlFLElBQUlILEVBQU1oQixJQUN2QixDQUVPLFNBQVNSLEVBQWN3QixFQUF3QkksR0FDcEQsTUFBTUgsRUFBTWYsR0FBWSxHQUNsQm1CLEVBQWNKLEVBQUlFLElBQUlILEVBQU1oQixLQUM1QnNCLEVBQWdCTCxFQUFJQyxJQUFJRixFQUFNaEIsS0FJcEMsT0FGQWlCLEVBQUlNLElBQUlQLEVBQU1oQixJQUFLb0IsR0FFWixLQUNBQyxFQUlMSixFQUFJTSxJQUFJUCxFQUFNaEIsSUFBS3NCLEdBSGpCTCxFQUFJTyxPQUFPUixFQUFNaEIsS0FLdkIsQ0FRTyxTQUFTVCxFQUNkeUIsRUFDQUksRUFDQUssR0FFQSxNQUFNQyxFQUFVbEMsRUFBV3dCLEVBQU9JLEdBQ2xDLElBQ0UsTUFBTU8sRUFBU0YsSUFDZixPQUFJRSxhQUFrQkMsUUFDYkQsRUFBT0UsUUFBUUgsSUFFeEJBLElBQ09DLEVBQ1QsT0FBU0csR0FFUCxNQURBSixJQUNNSSxDQUNSLENBQ0YsQyJ9

package/dist/context/index.mjs

@@ -0,0 +1,98 @@
+// lib/context/index.ts
+import { isNodeJs } from "valyrian.js";
+var NODE_CONTEXT_STORE_KEY = "__valyrian_context_values__";
+var browserContextStore = /* @__PURE__ */ new Map();
+function createContextScope(name) {
+  return {
+    key: Symbol(name),
+    name
+  };
+}
+function getNodeStoreObject() {
+  if (!isNodeJs || typeof sessionStorage === "undefined") {
+    return null;
+  }
+  const storage = sessionStorage;
+  if (!storage.store || typeof storage.store !== "object") {
+    return null;
+  }
+  return storage.store;
+}
+function getScopeMap(create = false) {
+  const nodeStore = getNodeStoreObject();
+  if (nodeStore) {
+    const existingMap = nodeStore[NODE_CONTEXT_STORE_KEY];
+    if (existingMap) {
+      return existingMap;
+    }
+    if (create) {
+      const nextMap = /* @__PURE__ */ new Map();
+      nodeStore[NODE_CONTEXT_STORE_KEY] = nextMap;
+      return nextMap;
+    }
+    return null;
+  }
+  if (create) {
+    return browserContextStore;
+  }
+  return browserContextStore.size > 0 ? browserContextStore : null;
+}
+function isServerContextActive() {
+  if (!isNodeJs || typeof sessionStorage === "undefined") {
+    return false;
+  }
+  const maybeServerStorage = sessionStorage;
+  if (typeof maybeServerStorage.isContextActive === "function") {
+    return Boolean(maybeServerStorage.isContextActive());
+  }
+  return false;
+}
+function getContext(scope) {
+  const map = getScopeMap(false);
+  if (!map) {
+    return void 0;
+  }
+  return map.get(scope.key);
+}
+function hasContext(scope) {
+  const map = getScopeMap(false);
+  if (!map) {
+    return false;
+  }
+  return map.has(scope.key);
+}
+function setContext(scope, value) {
+  const map = getScopeMap(true);
+  const hasPrevious = map.has(scope.key);
+  const previousValue = map.get(scope.key);
+  map.set(scope.key, value);
+  return () => {
+    if (!hasPrevious) {
+      map.delete(scope.key);
+      return;
+    }
+    map.set(scope.key, previousValue);
+  };
+}
+function runWithContext(scope, value, callback) {
+  const restore = setContext(scope, value);
+  try {
+    const result = callback();
+    if (result instanceof Promise) {
+      return result.finally(restore);
+    }
+    restore();
+    return result;
+  } catch (error) {
+    restore();
+    throw error;
+  }
+}
+export {
+  createContextScope,
+  getContext,
+  hasContext,
+  isServerContextActive,
+  runWithContext,
+  setContext
+};

package/dist/context/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../lib/context/index.ts"],
+  "sourcesContent": ["import { isNodeJs } from \"valyrian.js\";\n\ntype ScopeMap = Map<symbol, unknown>;\n\nconst NODE_CONTEXT_STORE_KEY = \"__valyrian_context_values__\";\nconst browserContextStore: ScopeMap = new Map();\n\nexport type ContextScope<T> = {\n  key: symbol;\n  name: string;\n  // Type marker only\n  __type?: T;\n};\n\nexport function createContextScope<T>(name: string): ContextScope<T> {\n  return {\n    key: Symbol(name),\n    name\n  };\n}\n\nfunction getNodeStoreObject(): Record<string | symbol, unknown> | null {\n  if (!isNodeJs || typeof sessionStorage === \"undefined\") {\n    return null;\n  }\n\n  const storage = sessionStorage as Storage & {\n    store?: Record<string | symbol, unknown>;\n  };\n\n  if (!storage.store || typeof storage.store !== \"object\") {\n    return null;\n  }\n\n  return storage.store;\n}\n\nfunction getScopeMap(create = false): ScopeMap | null {\n  const nodeStore = getNodeStoreObject();\n  if (nodeStore) {\n    const existingMap = nodeStore[NODE_CONTEXT_STORE_KEY] as ScopeMap | undefined;\n    if (existingMap) {\n      return existingMap;\n    }\n\n    if (create) {\n      const nextMap: ScopeMap = new Map();\n      nodeStore[NODE_CONTEXT_STORE_KEY] = nextMap;\n      return nextMap;\n    }\n\n    return null;\n  }\n\n  if (create) {\n    return browserContextStore;\n  }\n\n  return browserContextStore.size > 0 ? browserContextStore : null;\n}\n\nexport function isServerContextActive() {\n  if (!isNodeJs || typeof sessionStorage === \"undefined\") {\n    return false;\n  }\n\n  const maybeServerStorage = sessionStorage as Storage & {\n    isContextActive?: () => boolean;\n  };\n\n  if (typeof maybeServerStorage.isContextActive === \"function\") {\n    return Boolean(maybeServerStorage.isContextActive());\n  }\n\n  return false;\n}\n\nexport function getContext<T>(scope: ContextScope<T>): T | undefined {\n  const map = getScopeMap(false);\n  if (!map) {\n    return undefined;\n  }\n\n  return map.get(scope.key) as T | undefined;\n}\n\nexport function hasContext<T>(scope: ContextScope<T>): boolean {\n  const map = getScopeMap(false);\n  if (!map) {\n    return false;\n  }\n\n  return map.has(scope.key);\n}\n\nexport function setContext<T>(scope: ContextScope<T>, value: T): () => void {\n  const map = getScopeMap(true) as ScopeMap;\n  const hasPrevious = map.has(scope.key);\n  const previousValue = map.get(scope.key);\n\n  map.set(scope.key, value);\n\n  return () => {\n    if (!hasPrevious) {\n      map.delete(scope.key);\n      return;\n    }\n    map.set(scope.key, previousValue);\n  };\n}\n\nexport function runWithContext<T, TResult>(scope: ContextScope<T>, value: T, callback: () => TResult): TResult;\nexport function runWithContext<T, TResult>(\n  scope: ContextScope<T>,\n  value: T,\n  callback: () => Promise<TResult>\n): Promise<TResult>;\nexport function runWithContext<T, TResult>(\n  scope: ContextScope<T>,\n  value: T,\n  callback: () => TResult | Promise<TResult>\n) {\n  const restore = setContext(scope, value);\n  try {\n    const result = callback();\n    if (result instanceof Promise) {\n      return result.finally(restore);\n    }\n    restore();\n    return result;\n  } catch (error) {\n    restore();\n    throw error;\n  }\n}\n"],
+  "mappings": ";AAAA,SAAS,gBAAgB;AAIzB,IAAM,yBAAyB;AAC/B,IAAM,sBAAgC,oBAAI,IAAI;AASvC,SAAS,mBAAsB,MAA+B;AACnE,SAAO;AAAA,IACL,KAAK,OAAO,IAAI;AAAA,IAChB;AAAA,EACF;AACF;AAEA,SAAS,qBAA8D;AACrE,MAAI,CAAC,YAAY,OAAO,mBAAmB,aAAa;AACtD,WAAO;AAAA,EACT;AAEA,QAAM,UAAU;AAIhB,MAAI,CAAC,QAAQ,SAAS,OAAO,QAAQ,UAAU,UAAU;AACvD,WAAO;AAAA,EACT;AAEA,SAAO,QAAQ;AACjB;AAEA,SAAS,YAAY,SAAS,OAAwB;AACpD,QAAM,YAAY,mBAAmB;AACrC,MAAI,WAAW;AACb,UAAM,cAAc,UAAU,sBAAsB;AACpD,QAAI,aAAa;AACf,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ;AACV,YAAM,UAAoB,oBAAI,IAAI;AAClC,gBAAU,sBAAsB,IAAI;AACpC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,MAAI,QAAQ;AACV,WAAO;AAAA,EACT;AAEA,SAAO,oBAAoB,OAAO,IAAI,sBAAsB;AAC9D;AAEO,SAAS,wBAAwB;AACtC,MAAI,CAAC,YAAY,OAAO,mBAAmB,aAAa;AACtD,WAAO;AAAA,EACT;AAEA,QAAM,qBAAqB;AAI3B,MAAI,OAAO,mBAAmB,oBAAoB,YAAY;AAC5D,WAAO,QAAQ,mBAAmB,gBAAgB,CAAC;AAAA,EACrD;AAEA,SAAO;AACT;AAEO,SAAS,WAAc,OAAuC;AACnE,QAAM,MAAM,YAAY,KAAK;AAC7B,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,IAAI,MAAM,GAAG;AAC1B;AAEO,SAAS,WAAc,OAAiC;AAC7D,QAAM,MAAM,YAAY,KAAK;AAC7B,MAAI,CAAC,KAAK;AACR,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,IAAI,MAAM,GAAG;AAC1B;AAEO,SAAS,WAAc,OAAwB,OAAsB;AAC1E,QAAM,MAAM,YAAY,IAAI;AAC5B,QAAM,cAAc,IAAI,IAAI,MAAM,GAAG;AACrC,QAAM,gBAAgB,IAAI,IAAI,MAAM,GAAG;AAEvC,MAAI,IAAI,MAAM,KAAK,KAAK;AAExB,SAAO,MAAM;AACX,QAAI,CAAC,aAAa;AAChB,UAAI,OAAO,MAAM,GAAG;AACpB;AAAA,IACF;AACA,QAAI,IAAI,MAAM,KAAK,aAAa;AAAA,EAClC;AACF;AAQO,SAAS,eACd,OACA,OACA,UACA;AACA,QAAM,UAAU,WAAW,OAAO,KAAK;AACvC,MAAI;AACF,UAAM,SAAS,SAAS;AACxB,QAAI,kBAAkB,SAAS;AAC7B,aAAO,OAAO,QAAQ,OAAO;AAAA,IAC/B;AACA,YAAQ;AACR,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ;AACR,UAAM;AAAA,EACR;AACF;",
+  "names": []
+}

package/dist/forms/index.js

@@ -20,7 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // lib/forms/index.ts
 var index_exports = {};
 __export(index_exports, {
-  FormStore: () => FormStore
+  FormStore: () => FormStore,
+  formSchemaShield: () => formSchemaShield
 });
 module.exports = __toCommonJS(index_exports);
 var import_valyrian = require("valyrian.js");
@@ -1620,8 +1621,8 @@ var SchemaShield = class {
 };
 
 // lib/forms/index.ts
-var controlBindingKey = Symbol("forms-control-binding");
-var formBindingKey = Symbol("forms-form-binding");
+var controlBindingKey = /* @__PURE__ */ Symbol("forms-control-binding");
+var formBindingKey = /* @__PURE__ */ Symbol("forms-form-binding");
 function getTagName(node) {
   return String(node.tagName || "").toUpperCase();
 }
@@ -1679,10 +1680,6 @@ function getRootError(error) {
   }
   return current;
 }
-function cloneStateShallow(state) {
-  const clone = Object.create(Object.getPrototypeOf(state));
-  return Object.assign(clone, state);
-}
 function walkElements(root, visitor) {
   const children = root.childNodes || [];
   for (const child of children) {
@@ -1730,11 +1727,15 @@ var FormStore = class _FormStore {
   #onSubmit;
   #clean;
   #format;
+  #validationMode;
   #pulseStore;
+  static get schemaShield() {
+    return this.#schemaShield;
+  }
   static createSchemaShield() {
     const schemaShield = new SchemaShield({
       failFast: false,
-      immutable: true
+      immutable: false
     });
     schemaShield.addFormat(
       "url",
@@ -1758,27 +1759,35 @@ var FormStore = class _FormStore {
     this.#onSubmit = options.onSubmit || null;
     this.#clean = options.clean || {};
     this.#format = options.format || {};
-    const initialValues = cloneStateShallow(options.state);
+    this.#validationMode = options.validationMode || "safe";
+    const getValidationErrors = (values) => {
+      const valuesToValidate = this.#validationMode === "safe" ? (0, import_utils.deepCloneUnfreeze)(values) : values;
+      const result = this.#validator(valuesToValidate);
+      return result.valid ? {} : this.#mapValidationError(result.error);
+    };
+    const initialValues = (0, import_utils.deepCloneUnfreeze)(options.state);
     this.#pulseStore = (0, import_pulses.createPulseStore)(
       {
-        values: cloneStateShallow(initialValues),
+        values: (0, import_utils.deepCloneUnfreeze)(initialValues),
         errors: {},
         isInflight: false,
         isDirty: false
       },
       {
-        setValue(state, name, value) {
+        setField(state, name, value) {
           state.values[name] = value;
           state.isDirty = true;
+          state.errors = getValidationErrors(state.values);
         },
-        setErrors(state, errors) {
-          state.errors = errors;
+        validate(state) {
+          state.errors = getValidationErrors(state.values);
+          return Object.keys(state.errors).length === 0;
         },
         setInflight(state, inflight) {
           state.isInflight = inflight;
         },
         reset(state) {
-          state.values = cloneStateShallow(initialValues);
+          state.values = (0, import_utils.deepCloneUnfreeze)(initialValues);
           state.errors = {};
           state.isInflight = false;
           state.isDirty = false;
@@ -1815,8 +1824,7 @@ var FormStore = class _FormStore {
   }
   setField(name, rawValue, control = null, event) {
     const cleanedValue = this.#runTransform(this.#clean, name, rawValue, control, event);
-    this.#pulseStore.setValue(name, cleanedValue);
-    this.validate();
+    this.#pulseStore.setField(name, cleanedValue);
   }
   #mapValidationError(error) {
     if (!error) {
@@ -1834,10 +1842,7 @@ var FormStore = class _FormStore {
     return { [fieldName]: message };
   }
   validate() {
-    const result = this.#validator(this.state);
-    const errors = result.valid ? {} : this.#mapValidationError(result.error);
-    this.#pulseStore.setErrors(errors);
-    return Object.keys(errors).length === 0;
+    return this.#pulseStore.validate();
   }
   async submit(event) {
     event?.preventDefault();
@@ -1861,6 +1866,7 @@ var FormStore = class _FormStore {
     this.#pulseStore.reset();
   }
 };
+var formSchemaShield = FormStore.schemaShield;
 function bindControl(formStore, control) {
   const name = getNodeName(control);
   if (name.length === 0) {