@wildwinter/scoperegistry 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ian Thomas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @wildwinter/scoperegistry
+
+The scope registry / runtime state container that sits on top of
+[`@wildwinter/expr`](../expr). expr is a stateless calculator; this package is
+the **state layer**.
+
+It owns the world state as a set of named **scopes**, each either:
+
+- **owned** — a property bag this registry stores, seeds from declaration
+  defaults, and serializes via `save`/`load`; or
+- **foreign** — host- or other-engine-resolved at runtime through a
+  `{ get, set? }` resolver, never stored here (read-only if there's no setter).
+
+It then produces the two things expr consumes:
+
+- **`toEvalContext()`** → the `EvalContext` for `evaluate` (owned bags + foreign
+  resolvers).
+- **`toSchema()`** → the `ExpressionSchema` for `validateExpr` (from declarations;
+  undeclared scopes are opaque and unflagged).
+
+Plus **`readScopeRegistrySpec(json)`** — extract a `scopeRegistrySpec` (the
+interop format) from any JSON value (a `.storyworld` bundle, or a standalone
+manifest), so one owner's scope declarations can be imported for validation by
+another engine.
+
+`expr` never depends on this; this depends one-way on `expr`. Read-only is
+settable per scope (a resolver with no `set`) and per property
+(`writable: false`), enforced by `set`.
+
+```ts
+import { ScopeRegistry } from "@wildwinter/scoperegistry";
+
+const reg = new ScopeRegistry()
+  .defineOwned("patter", [{ name: "hp", type: "number", default: 10 }])
+  .defineForeign("game", { get: (n) => host.read(n), set: (n, v) => host.write(n, v) });
+
+evaluate(ast, reg.toEvalContext(), dialect);   // reads owned + foreign
+validateExpr(ast, reg.toSchema(), dialect);    // checks declared scopes
+const blob = reg.save();                        // owned scopes only
+```
+
+Design rationale: `design/scope-registry.md` in the Patter repo.

package/dist/index.cjs

@@ -0,0 +1,162 @@
+'use strict';
+
+// src/index.ts
+var SUPPORTED_SPEC_VERSIONS = [1];
+function readScopeRegistrySpec(source) {
+  if (!source || typeof source !== "object") return null;
+  const raw = source.scopeRegistrySpec;
+  if (raw === void 0) return null;
+  if (typeof raw !== "object" || raw === null) throw new Error("scopeRegistrySpec must be an object");
+  const spec = raw;
+  if (typeof spec.version !== "number") throw new Error("scopeRegistrySpec.version must be a number");
+  if (!SUPPORTED_SPEC_VERSIONS.includes(spec.version)) {
+    throw new Error(`unsupported scopeRegistrySpec version ${spec.version} (supported: ${SUPPORTED_SPEC_VERSIONS.join(", ")})`);
+  }
+  if (!Array.isArray(spec.scopes)) throw new Error("scopeRegistrySpec.scopes must be an array");
+  for (const s of spec.scopes) {
+    if (!s || typeof s !== "object" || typeof s.token !== "string") {
+      throw new Error("each scopeRegistrySpec scope needs a string token");
+    }
+  }
+  return spec;
+}
+var ScopeRegistry = class {
+  scopes = /* @__PURE__ */ new Map();
+  /**
+   * Register a scope this registry **owns and stores**. Its bag is seeded from
+   * each declaration's `default` (or a type default). Owned scopes are
+   * type-checked (declarations) and serialized by `save`/`load`.
+   */
+  defineOwned(token, declarations) {
+    this.assertFree(token);
+    const bag = {};
+    const decls = /* @__PURE__ */ new Map();
+    for (const d of declarations) {
+      const name = d.name.toLowerCase();
+      decls.set(name, d);
+      bag[name] = d.default ?? defaultFor(d);
+    }
+    this.scopes.set(token, { kind: "owned", bag, decls });
+    return this;
+  }
+  /**
+   * Re-initialise an existing **owned** scope's bag from new declarations,
+   * clearing its current values. For scope-local state that resets on a context
+   * change (e.g. entering a new scene / site / deck) without disturbing other
+   * scopes. Mutates the bag in place, so an `EvalContext` already built from this
+   * registry stays valid.
+   */
+  reseedOwned(token, declarations) {
+    const e = this.scopes.get(token);
+    if (!e || e.kind !== "owned") throw new Error(`'@${token}' is not an owned scope`);
+    for (const k of Object.keys(e.bag)) delete e.bag[k];
+    e.decls.clear();
+    for (const d of declarations) {
+      const name = d.name.toLowerCase();
+      e.decls.set(name, d);
+      e.bag[name] = d.default ?? defaultFor(d);
+    }
+    return this;
+  }
+  /**
+   * Register a **foreign** scope backed by a host `{ get, set? }` resolver. The
+   * values live in the host/other engine and are never stored or saved here.
+   * `declarations` (optional, e.g. imported from a `scopeRegistrySpec`) are used
+   * only for validation; omit them for an opaque scope.
+   */
+  defineForeign(token, resolver, declarations = [], scopeWritable = true) {
+    this.assertFree(token);
+    const decls = /* @__PURE__ */ new Map();
+    for (const d of declarations) decls.set(d.name.toLowerCase(), d);
+    this.scopes.set(token, { kind: "foreign", resolver, decls, scopeWritable });
+    return this;
+  }
+  has(token) {
+    return this.scopes.has(token);
+  }
+  /** Read a property; undefined if the scope or property is not present. */
+  get(scope, name) {
+    const e = this.scopes.get(scope);
+    if (!e) return void 0;
+    const n = name.toLowerCase();
+    return e.kind === "owned" ? e.bag[n] : e.resolver.get(n);
+  }
+  /** Write a property. Throws on an unknown or read-only scope/property. */
+  set(scope, name, value) {
+    const e = this.scopes.get(scope);
+    if (!e) throw new Error(`unknown scope '@${scope}'`);
+    const n = name.toLowerCase();
+    if (!this.writable(e, n)) throw new Error(`'@${scope}.${name}' is read-only`);
+    if (e.kind === "owned") e.bag[n] = value;
+    else e.resolver.set(n, value);
+  }
+  writable(e, name) {
+    if (e.kind === "owned") return e.decls.get(name)?.writable ?? true;
+    if (!e.resolver.set) return false;
+    return e.decls.get(name)?.writable ?? e.scopeWritable;
+  }
+  /**
+   * Build the `EvalContext` expr's `evaluate` consumes: owned scopes as static
+   * bags, foreign scopes as their resolvers. `host` carries dialect-function
+   * callbacks (PRNG, tag lookups) and is passed through untouched.
+   */
+  toEvalContext(host) {
+    const scopes = {};
+    for (const [token, e] of this.scopes) {
+      scopes[token] = e.kind === "owned" ? e.bag : e.resolver;
+    }
+    return { scopes, host };
+  }
+  /**
+   * Build the `ExpressionSchema` expr's validator consumes. Scopes with no
+   * declarations are **omitted** (opaque - references into them are not flagged);
+   * declared scopes contribute their property types for validation.
+   */
+  toSchema() {
+    const properties = /* @__PURE__ */ new Map();
+    for (const [token, e] of this.scopes) {
+      if (e.decls.size === 0) continue;
+      const m = /* @__PURE__ */ new Map();
+      for (const [name, d] of e.decls) m.set(name, { type: d.type, enumValues: d.values });
+      properties.set(token, m);
+    }
+    return { properties };
+  }
+  /** Serialize **owned** scopes only (foreign scopes are host-owned, host-saved). */
+  save() {
+    const out = {};
+    for (const [token, e] of this.scopes) if (e.kind === "owned") out[token] = { ...e.bag };
+    return out;
+  }
+  /** Restore owned-scope values from a `save` blob. Unknown/foreign scopes are ignored. */
+  load(blob) {
+    for (const [token, vals] of Object.entries(blob)) {
+      const e = this.scopes.get(token);
+      if (e?.kind === "owned") Object.assign(e.bag, vals);
+    }
+  }
+  assertFree(token) {
+    if (this.scopes.has(token)) throw new Error(`scope '@${token}' is already registered`);
+  }
+};
+function defaultFor(d) {
+  if (d.default !== void 0) return d.default;
+  switch (d.type) {
+    case "boolean":
+      return false;
+    case "number":
+      return 0;
+    case "string":
+      return "";
+    case "enum":
+      return d.values?.[0] ?? "";
+    case "flags":
+      return [];
+  }
+}
+
+exports.SUPPORTED_SPEC_VERSIONS = SUPPORTED_SPEC_VERSIONS;
+exports.ScopeRegistry = ScopeRegistry;
+exports.readScopeRegistrySpec = readScopeRegistrySpec;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// @wildwinter/scoperegistry - the scope registry / runtime state container that\n// sits on top of @wildwinter/expr.\n//\n// expr is a stateless calculator: given an AST, an EvalContext (the state), and\n// a Dialect, it computes. This package is the *state* layer: it owns the world\n// state as a set of named scopes - each either an **owned** scope (a property\n// bag this registry stores and saves) or a **foreign** scope (host- or\n// other-engine-resolved at runtime, never stored here) - and produces the\n// `EvalContext` (for evaluation) and `ExpressionSchema` (for validation) that\n// expr consumes. Plus the `scopeRegistrySpec` interop format for importing a\n// foreign owner's scope declarations.\n//\n// Design: design/scope-registry.md (in the patter repo). expr never depends on\n// this; this depends one-way on expr.\n// ---------------------------------------------------------------------------\n\nimport type {\n  EvalContext, ExpressionSchema, PropertyType, ScalarValue, ScopeResolver,\n} from \"@wildwinter/expr\";\n\nexport type { EvalContext, ExpressionSchema, PropertyType, ScalarValue, ScopeResolver } from \"@wildwinter/expr\";\n\n// ---------------------------------------------------------------------------\n// Declarations + the scopeRegistrySpec interop format\n// ---------------------------------------------------------------------------\n\n/**\n * A property declaration. `default` is used by an *owned* scope to seed its bag\n * (foreign scopes ignore it - the host owns the value). `writable: false` makes\n * a property read-only; default is read/write. (`type`/`values` feed validation.)\n */\nexport interface ScopeDeclaration {\n  name: string;\n  type: PropertyType;\n  values?: string[];        // for enum / flags\n  default?: ScalarValue;    // owned scopes: seed value\n  writable?: boolean;       // default true\n}\n\n/** One scope in a `scopeRegistrySpec`: a token + (optional) declarations. */\nexport interface ScopeSpec {\n  token: string;\n  /** Scope-level read/write default for its declarations (default true). */\n  writable?: boolean;\n  /** Property declarations; omit for an opaque scope (any name, unchecked). */\n  declarations?: ScopeDeclaration[];\n}\n\n/**\n * The interop format an owner (Storylet Studio, a host game) exports so another\n * engine can validate references into its scopes. Carried under the well-known\n * `scopeRegistrySpec` JSON key (inside a `.storyworld`, or a standalone file).\n */\nexport interface ScopeRegistrySpec {\n  version: number;\n  scopes: ScopeSpec[];\n}\n\n/** The spec versions this build understands. */\nexport const SUPPORTED_SPEC_VERSIONS = [1] as const;\n\n/**\n * Extract + validate a `scopeRegistrySpec` from any JSON value (a parsed\n * `.storyworld` bundle, or a vanilla `{ scopeRegistrySpec: ... }` manifest).\n * Returns null when the key is absent (so callers can probe arbitrary files);\n * throws on a malformed or unsupported-version spec.\n */\nexport function readScopeRegistrySpec(source: unknown): ScopeRegistrySpec | null {\n  if (!source || typeof source !== \"object\") return null;\n  const raw = (source as Record<string, unknown>).scopeRegistrySpec;\n  if (raw === undefined) return null;\n  if (typeof raw !== \"object\" || raw === null) throw new Error(\"scopeRegistrySpec must be an object\");\n  const spec = raw as Record<string, unknown>;\n  if (typeof spec.version !== \"number\") throw new Error(\"scopeRegistrySpec.version must be a number\");\n  if (!(SUPPORTED_SPEC_VERSIONS as readonly number[]).includes(spec.version)) {\n    throw new Error(`unsupported scopeRegistrySpec version ${spec.version} (supported: ${SUPPORTED_SPEC_VERSIONS.join(\", \")})`);\n  }\n  if (!Array.isArray(spec.scopes)) throw new Error(\"scopeRegistrySpec.scopes must be an array\");\n  for (const s of spec.scopes) {\n    if (!s || typeof s !== \"object\" || typeof (s as ScopeSpec).token !== \"string\") {\n      throw new Error(\"each scopeRegistrySpec scope needs a string token\");\n    }\n  }\n  return spec as unknown as ScopeRegistrySpec;\n}\n\n// ---------------------------------------------------------------------------\n// The registry / state container\n// ---------------------------------------------------------------------------\n\ninterface OwnedScope {\n  kind: \"owned\";\n  bag: Record<string, ScalarValue>;\n  decls: Map<string, ScopeDeclaration>;\n}\ninterface ForeignScope {\n  kind: \"foreign\";\n  resolver: ScopeResolver;\n  decls: Map<string, ScopeDeclaration>;\n  scopeWritable: boolean;\n}\ntype Entry = OwnedScope | ForeignScope;\n\nexport class ScopeRegistry {\n  private readonly scopes = new Map<string, Entry>();\n\n  /**\n   * Register a scope this registry **owns and stores**. Its bag is seeded from\n   * each declaration's `default` (or a type default). Owned scopes are\n   * type-checked (declarations) and serialized by `save`/`load`.\n   */\n  defineOwned(token: string, declarations: ScopeDeclaration[]): this {\n    this.assertFree(token);\n    const bag: Record<string, ScalarValue> = {};\n    const decls = new Map<string, ScopeDeclaration>();\n    for (const d of declarations) {\n      const name = d.name.toLowerCase();\n      decls.set(name, d);\n      bag[name] = d.default ?? defaultFor(d);\n    }\n    this.scopes.set(token, { kind: \"owned\", bag, decls });\n    return this;\n  }\n\n  /**\n   * Re-initialise an existing **owned** scope's bag from new declarations,\n   * clearing its current values. For scope-local state that resets on a context\n   * change (e.g. entering a new scene / site / deck) without disturbing other\n   * scopes. Mutates the bag in place, so an `EvalContext` already built from this\n   * registry stays valid.\n   */\n  reseedOwned(token: string, declarations: ScopeDeclaration[]): this {\n    const e = this.scopes.get(token);\n    if (!e || e.kind !== \"owned\") throw new Error(`'@${token}' is not an owned scope`);\n    for (const k of Object.keys(e.bag)) delete e.bag[k];\n    e.decls.clear();\n    for (const d of declarations) {\n      const name = d.name.toLowerCase();\n      e.decls.set(name, d);\n      e.bag[name] = d.default ?? defaultFor(d);\n    }\n    return this;\n  }\n\n  /**\n   * Register a **foreign** scope backed by a host `{ get, set? }` resolver. The\n   * values live in the host/other engine and are never stored or saved here.\n   * `declarations` (optional, e.g. imported from a `scopeRegistrySpec`) are used\n   * only for validation; omit them for an opaque scope.\n   */\n  defineForeign(\n    token: string,\n    resolver: ScopeResolver,\n    declarations: ScopeDeclaration[] = [],\n    scopeWritable = true,\n  ): this {\n    this.assertFree(token);\n    const decls = new Map<string, ScopeDeclaration>();\n    for (const d of declarations) decls.set(d.name.toLowerCase(), d);\n    this.scopes.set(token, { kind: \"foreign\", resolver, decls, scopeWritable });\n    return this;\n  }\n\n  has(token: string): boolean {\n    return this.scopes.has(token);\n  }\n\n  /** Read a property; undefined if the scope or property is not present. */\n  get(scope: string, name: string): ScalarValue | undefined {\n    const e = this.scopes.get(scope);\n    if (!e) return undefined;\n    const n = name.toLowerCase();\n    return e.kind === \"owned\" ? e.bag[n] : e.resolver.get(n);\n  }\n\n  /** Write a property. Throws on an unknown or read-only scope/property. */\n  set(scope: string, name: string, value: ScalarValue): void {\n    const e = this.scopes.get(scope);\n    if (!e) throw new Error(`unknown scope '@${scope}'`);\n    const n = name.toLowerCase();\n    if (!this.writable(e, n)) throw new Error(`'@${scope}.${name}' is read-only`);\n    if (e.kind === \"owned\") e.bag[n] = value;\n    else e.resolver.set!(n, value);\n  }\n\n  private writable(e: Entry, name: string): boolean {\n    if (e.kind === \"owned\") return e.decls.get(name)?.writable ?? true;\n    if (!e.resolver.set) return false;                 // no setter => read-only scope\n    return e.decls.get(name)?.writable ?? e.scopeWritable;\n  }\n\n  /**\n   * Build the `EvalContext` expr's `evaluate` consumes: owned scopes as static\n   * bags, foreign scopes as their resolvers. `host` carries dialect-function\n   * callbacks (PRNG, tag lookups) and is passed through untouched.\n   */\n  toEvalContext(host?: Record<string, unknown>): EvalContext {\n    const scopes: EvalContext[\"scopes\"] = {};\n    for (const [token, e] of this.scopes) {\n      scopes[token] = e.kind === \"owned\" ? e.bag : e.resolver;\n    }\n    return { scopes, host };\n  }\n\n  /**\n   * Build the `ExpressionSchema` expr's validator consumes. Scopes with no\n   * declarations are **omitted** (opaque - references into them are not flagged);\n   * declared scopes contribute their property types for validation.\n   */\n  toSchema(): ExpressionSchema {\n    const properties = new Map<string, Map<string, { type: PropertyType; enumValues?: string[] }>>();\n    for (const [token, e] of this.scopes) {\n      if (e.decls.size === 0) continue;\n      const m = new Map<string, { type: PropertyType; enumValues?: string[] }>();\n      for (const [name, d] of e.decls) m.set(name, { type: d.type, enumValues: d.values });\n      properties.set(token, m);\n    }\n    return { properties };\n  }\n\n  /** Serialize **owned** scopes only (foreign scopes are host-owned, host-saved). */\n  save(): Record<string, Record<string, ScalarValue>> {\n    const out: Record<string, Record<string, ScalarValue>> = {};\n    for (const [token, e] of this.scopes) if (e.kind === \"owned\") out[token] = { ...e.bag };\n    return out;\n  }\n\n  /** Restore owned-scope values from a `save` blob. Unknown/foreign scopes are ignored. */\n  load(blob: Record<string, Record<string, ScalarValue>>): void {\n    for (const [token, vals] of Object.entries(blob)) {\n      const e = this.scopes.get(token);\n      if (e?.kind === \"owned\") Object.assign(e.bag, vals);\n    }\n  }\n\n  private assertFree(token: string): void {\n    if (this.scopes.has(token)) throw new Error(`scope '@${token}' is already registered`);\n  }\n}\n\nfunction defaultFor(d: ScopeDeclaration): ScalarValue {\n  if (d.default !== undefined) return d.default;\n  switch (d.type) {\n    case \"boolean\": return false;\n    case \"number\": return 0;\n    case \"string\": return \"\";\n    case \"enum\": return d.values?.[0] ?? \"\";\n    case \"flags\": return [];\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,90 @@
+import { PropertyType, ScalarValue, ScopeResolver, EvalContext, ExpressionSchema } from '@wildwinter/expr';
+export { EvalContext, ExpressionSchema, PropertyType, ScalarValue, ScopeResolver } from '@wildwinter/expr';
+
+/**
+ * A property declaration. `default` is used by an *owned* scope to seed its bag
+ * (foreign scopes ignore it - the host owns the value). `writable: false` makes
+ * a property read-only; default is read/write. (`type`/`values` feed validation.)
+ */
+interface ScopeDeclaration {
+    name: string;
+    type: PropertyType;
+    values?: string[];
+    default?: ScalarValue;
+    writable?: boolean;
+}
+/** One scope in a `scopeRegistrySpec`: a token + (optional) declarations. */
+interface ScopeSpec {
+    token: string;
+    /** Scope-level read/write default for its declarations (default true). */
+    writable?: boolean;
+    /** Property declarations; omit for an opaque scope (any name, unchecked). */
+    declarations?: ScopeDeclaration[];
+}
+/**
+ * The interop format an owner (Storylet Studio, a host game) exports so another
+ * engine can validate references into its scopes. Carried under the well-known
+ * `scopeRegistrySpec` JSON key (inside a `.storyworld`, or a standalone file).
+ */
+interface ScopeRegistrySpec {
+    version: number;
+    scopes: ScopeSpec[];
+}
+/** The spec versions this build understands. */
+declare const SUPPORTED_SPEC_VERSIONS: readonly [1];
+/**
+ * Extract + validate a `scopeRegistrySpec` from any JSON value (a parsed
+ * `.storyworld` bundle, or a vanilla `{ scopeRegistrySpec: ... }` manifest).
+ * Returns null when the key is absent (so callers can probe arbitrary files);
+ * throws on a malformed or unsupported-version spec.
+ */
+declare function readScopeRegistrySpec(source: unknown): ScopeRegistrySpec | null;
+declare class ScopeRegistry {
+    private readonly scopes;
+    /**
+     * Register a scope this registry **owns and stores**. Its bag is seeded from
+     * each declaration's `default` (or a type default). Owned scopes are
+     * type-checked (declarations) and serialized by `save`/`load`.
+     */
+    defineOwned(token: string, declarations: ScopeDeclaration[]): this;
+    /**
+     * Re-initialise an existing **owned** scope's bag from new declarations,
+     * clearing its current values. For scope-local state that resets on a context
+     * change (e.g. entering a new scene / site / deck) without disturbing other
+     * scopes. Mutates the bag in place, so an `EvalContext` already built from this
+     * registry stays valid.
+     */
+    reseedOwned(token: string, declarations: ScopeDeclaration[]): this;
+    /**
+     * Register a **foreign** scope backed by a host `{ get, set? }` resolver. The
+     * values live in the host/other engine and are never stored or saved here.
+     * `declarations` (optional, e.g. imported from a `scopeRegistrySpec`) are used
+     * only for validation; omit them for an opaque scope.
+     */
+    defineForeign(token: string, resolver: ScopeResolver, declarations?: ScopeDeclaration[], scopeWritable?: boolean): this;
+    has(token: string): boolean;
+    /** Read a property; undefined if the scope or property is not present. */
+    get(scope: string, name: string): ScalarValue | undefined;
+    /** Write a property. Throws on an unknown or read-only scope/property. */
+    set(scope: string, name: string, value: ScalarValue): void;
+    private writable;
+    /**
+     * Build the `EvalContext` expr's `evaluate` consumes: owned scopes as static
+     * bags, foreign scopes as their resolvers. `host` carries dialect-function
+     * callbacks (PRNG, tag lookups) and is passed through untouched.
+     */
+    toEvalContext(host?: Record<string, unknown>): EvalContext;
+    /**
+     * Build the `ExpressionSchema` expr's validator consumes. Scopes with no
+     * declarations are **omitted** (opaque - references into them are not flagged);
+     * declared scopes contribute their property types for validation.
+     */
+    toSchema(): ExpressionSchema;
+    /** Serialize **owned** scopes only (foreign scopes are host-owned, host-saved). */
+    save(): Record<string, Record<string, ScalarValue>>;
+    /** Restore owned-scope values from a `save` blob. Unknown/foreign scopes are ignored. */
+    load(blob: Record<string, Record<string, ScalarValue>>): void;
+    private assertFree;
+}
+
+export { SUPPORTED_SPEC_VERSIONS, type ScopeDeclaration, ScopeRegistry, type ScopeRegistrySpec, type ScopeSpec, readScopeRegistrySpec };

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+import { PropertyType, ScalarValue, ScopeResolver, EvalContext, ExpressionSchema } from '@wildwinter/expr';
+export { EvalContext, ExpressionSchema, PropertyType, ScalarValue, ScopeResolver } from '@wildwinter/expr';
+
+/**
+ * A property declaration. `default` is used by an *owned* scope to seed its bag
+ * (foreign scopes ignore it - the host owns the value). `writable: false` makes
+ * a property read-only; default is read/write. (`type`/`values` feed validation.)
+ */
+interface ScopeDeclaration {
+    name: string;
+    type: PropertyType;
+    values?: string[];
+    default?: ScalarValue;
+    writable?: boolean;
+}
+/** One scope in a `scopeRegistrySpec`: a token + (optional) declarations. */
+interface ScopeSpec {
+    token: string;
+    /** Scope-level read/write default for its declarations (default true). */
+    writable?: boolean;
+    /** Property declarations; omit for an opaque scope (any name, unchecked). */
+    declarations?: ScopeDeclaration[];
+}
+/**
+ * The interop format an owner (Storylet Studio, a host game) exports so another
+ * engine can validate references into its scopes. Carried under the well-known
+ * `scopeRegistrySpec` JSON key (inside a `.storyworld`, or a standalone file).
+ */
+interface ScopeRegistrySpec {
+    version: number;
+    scopes: ScopeSpec[];
+}
+/** The spec versions this build understands. */
+declare const SUPPORTED_SPEC_VERSIONS: readonly [1];
+/**
+ * Extract + validate a `scopeRegistrySpec` from any JSON value (a parsed
+ * `.storyworld` bundle, or a vanilla `{ scopeRegistrySpec: ... }` manifest).
+ * Returns null when the key is absent (so callers can probe arbitrary files);
+ * throws on a malformed or unsupported-version spec.
+ */
+declare function readScopeRegistrySpec(source: unknown): ScopeRegistrySpec | null;
+declare class ScopeRegistry {
+    private readonly scopes;
+    /**
+     * Register a scope this registry **owns and stores**. Its bag is seeded from
+     * each declaration's `default` (or a type default). Owned scopes are
+     * type-checked (declarations) and serialized by `save`/`load`.
+     */
+    defineOwned(token: string, declarations: ScopeDeclaration[]): this;
+    /**
+     * Re-initialise an existing **owned** scope's bag from new declarations,
+     * clearing its current values. For scope-local state that resets on a context
+     * change (e.g. entering a new scene / site / deck) without disturbing other
+     * scopes. Mutates the bag in place, so an `EvalContext` already built from this
+     * registry stays valid.
+     */
+    reseedOwned(token: string, declarations: ScopeDeclaration[]): this;
+    /**
+     * Register a **foreign** scope backed by a host `{ get, set? }` resolver. The
+     * values live in the host/other engine and are never stored or saved here.
+     * `declarations` (optional, e.g. imported from a `scopeRegistrySpec`) are used
+     * only for validation; omit them for an opaque scope.
+     */
+    defineForeign(token: string, resolver: ScopeResolver, declarations?: ScopeDeclaration[], scopeWritable?: boolean): this;
+    has(token: string): boolean;
+    /** Read a property; undefined if the scope or property is not present. */
+    get(scope: string, name: string): ScalarValue | undefined;
+    /** Write a property. Throws on an unknown or read-only scope/property. */
+    set(scope: string, name: string, value: ScalarValue): void;
+    private writable;
+    /**
+     * Build the `EvalContext` expr's `evaluate` consumes: owned scopes as static
+     * bags, foreign scopes as their resolvers. `host` carries dialect-function
+     * callbacks (PRNG, tag lookups) and is passed through untouched.
+     */
+    toEvalContext(host?: Record<string, unknown>): EvalContext;
+    /**
+     * Build the `ExpressionSchema` expr's validator consumes. Scopes with no
+     * declarations are **omitted** (opaque - references into them are not flagged);
+     * declared scopes contribute their property types for validation.
+     */
+    toSchema(): ExpressionSchema;
+    /** Serialize **owned** scopes only (foreign scopes are host-owned, host-saved). */
+    save(): Record<string, Record<string, ScalarValue>>;
+    /** Restore owned-scope values from a `save` blob. Unknown/foreign scopes are ignored. */
+    load(blob: Record<string, Record<string, ScalarValue>>): void;
+    private assertFree;
+}
+
+export { SUPPORTED_SPEC_VERSIONS, type ScopeDeclaration, ScopeRegistry, type ScopeRegistrySpec, type ScopeSpec, readScopeRegistrySpec };

package/dist/index.js

@@ -0,0 +1,158 @@
+// src/index.ts
+var SUPPORTED_SPEC_VERSIONS = [1];
+function readScopeRegistrySpec(source) {
+  if (!source || typeof source !== "object") return null;
+  const raw = source.scopeRegistrySpec;
+  if (raw === void 0) return null;
+  if (typeof raw !== "object" || raw === null) throw new Error("scopeRegistrySpec must be an object");
+  const spec = raw;
+  if (typeof spec.version !== "number") throw new Error("scopeRegistrySpec.version must be a number");
+  if (!SUPPORTED_SPEC_VERSIONS.includes(spec.version)) {
+    throw new Error(`unsupported scopeRegistrySpec version ${spec.version} (supported: ${SUPPORTED_SPEC_VERSIONS.join(", ")})`);
+  }
+  if (!Array.isArray(spec.scopes)) throw new Error("scopeRegistrySpec.scopes must be an array");
+  for (const s of spec.scopes) {
+    if (!s || typeof s !== "object" || typeof s.token !== "string") {
+      throw new Error("each scopeRegistrySpec scope needs a string token");
+    }
+  }
+  return spec;
+}
+var ScopeRegistry = class {
+  scopes = /* @__PURE__ */ new Map();
+  /**
+   * Register a scope this registry **owns and stores**. Its bag is seeded from
+   * each declaration's `default` (or a type default). Owned scopes are
+   * type-checked (declarations) and serialized by `save`/`load`.
+   */
+  defineOwned(token, declarations) {
+    this.assertFree(token);
+    const bag = {};
+    const decls = /* @__PURE__ */ new Map();
+    for (const d of declarations) {
+      const name = d.name.toLowerCase();
+      decls.set(name, d);
+      bag[name] = d.default ?? defaultFor(d);
+    }
+    this.scopes.set(token, { kind: "owned", bag, decls });
+    return this;
+  }
+  /**
+   * Re-initialise an existing **owned** scope's bag from new declarations,
+   * clearing its current values. For scope-local state that resets on a context
+   * change (e.g. entering a new scene / site / deck) without disturbing other
+   * scopes. Mutates the bag in place, so an `EvalContext` already built from this
+   * registry stays valid.
+   */
+  reseedOwned(token, declarations) {
+    const e = this.scopes.get(token);
+    if (!e || e.kind !== "owned") throw new Error(`'@${token}' is not an owned scope`);
+    for (const k of Object.keys(e.bag)) delete e.bag[k];
+    e.decls.clear();
+    for (const d of declarations) {
+      const name = d.name.toLowerCase();
+      e.decls.set(name, d);
+      e.bag[name] = d.default ?? defaultFor(d);
+    }
+    return this;
+  }
+  /**
+   * Register a **foreign** scope backed by a host `{ get, set? }` resolver. The
+   * values live in the host/other engine and are never stored or saved here.
+   * `declarations` (optional, e.g. imported from a `scopeRegistrySpec`) are used
+   * only for validation; omit them for an opaque scope.
+   */
+  defineForeign(token, resolver, declarations = [], scopeWritable = true) {
+    this.assertFree(token);
+    const decls = /* @__PURE__ */ new Map();
+    for (const d of declarations) decls.set(d.name.toLowerCase(), d);
+    this.scopes.set(token, { kind: "foreign", resolver, decls, scopeWritable });
+    return this;
+  }
+  has(token) {
+    return this.scopes.has(token);
+  }
+  /** Read a property; undefined if the scope or property is not present. */
+  get(scope, name) {
+    const e = this.scopes.get(scope);
+    if (!e) return void 0;
+    const n = name.toLowerCase();
+    return e.kind === "owned" ? e.bag[n] : e.resolver.get(n);
+  }
+  /** Write a property. Throws on an unknown or read-only scope/property. */
+  set(scope, name, value) {
+    const e = this.scopes.get(scope);
+    if (!e) throw new Error(`unknown scope '@${scope}'`);
+    const n = name.toLowerCase();
+    if (!this.writable(e, n)) throw new Error(`'@${scope}.${name}' is read-only`);
+    if (e.kind === "owned") e.bag[n] = value;
+    else e.resolver.set(n, value);
+  }
+  writable(e, name) {
+    if (e.kind === "owned") return e.decls.get(name)?.writable ?? true;
+    if (!e.resolver.set) return false;
+    return e.decls.get(name)?.writable ?? e.scopeWritable;
+  }
+  /**
+   * Build the `EvalContext` expr's `evaluate` consumes: owned scopes as static
+   * bags, foreign scopes as their resolvers. `host` carries dialect-function
+   * callbacks (PRNG, tag lookups) and is passed through untouched.
+   */
+  toEvalContext(host) {
+    const scopes = {};
+    for (const [token, e] of this.scopes) {
+      scopes[token] = e.kind === "owned" ? e.bag : e.resolver;
+    }
+    return { scopes, host };
+  }
+  /**
+   * Build the `ExpressionSchema` expr's validator consumes. Scopes with no
+   * declarations are **omitted** (opaque - references into them are not flagged);
+   * declared scopes contribute their property types for validation.
+   */
+  toSchema() {
+    const properties = /* @__PURE__ */ new Map();
+    for (const [token, e] of this.scopes) {
+      if (e.decls.size === 0) continue;
+      const m = /* @__PURE__ */ new Map();
+      for (const [name, d] of e.decls) m.set(name, { type: d.type, enumValues: d.values });
+      properties.set(token, m);
+    }
+    return { properties };
+  }
+  /** Serialize **owned** scopes only (foreign scopes are host-owned, host-saved). */
+  save() {
+    const out = {};
+    for (const [token, e] of this.scopes) if (e.kind === "owned") out[token] = { ...e.bag };
+    return out;
+  }
+  /** Restore owned-scope values from a `save` blob. Unknown/foreign scopes are ignored. */
+  load(blob) {
+    for (const [token, vals] of Object.entries(blob)) {
+      const e = this.scopes.get(token);
+      if (e?.kind === "owned") Object.assign(e.bag, vals);
+    }
+  }
+  assertFree(token) {
+    if (this.scopes.has(token)) throw new Error(`scope '@${token}' is already registered`);
+  }
+};
+function defaultFor(d) {
+  if (d.default !== void 0) return d.default;
+  switch (d.type) {
+    case "boolean":
+      return false;
+    case "number":
+      return 0;
+    case "string":
+      return "";
+    case "enum":
+      return d.values?.[0] ?? "";
+    case "flags":
+      return [];
+  }
+}
+
+export { SUPPORTED_SPEC_VERSIONS, ScopeRegistry, readScopeRegistrySpec };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// ---------------------------------------------------------------------------\n// @wildwinter/scoperegistry - the scope registry / runtime state container that\n// sits on top of @wildwinter/expr.\n//\n// expr is a stateless calculator: given an AST, an EvalContext (the state), and\n// a Dialect, it computes. This package is the *state* layer: it owns the world\n// state as a set of named scopes - each either an **owned** scope (a property\n// bag this registry stores and saves) or a **foreign** scope (host- or\n// other-engine-resolved at runtime, never stored here) - and produces the\n// `EvalContext` (for evaluation) and `ExpressionSchema` (for validation) that\n// expr consumes. Plus the `scopeRegistrySpec` interop format for importing a\n// foreign owner's scope declarations.\n//\n// Design: design/scope-registry.md (in the patter repo). expr never depends on\n// this; this depends one-way on expr.\n// ---------------------------------------------------------------------------\n\nimport type {\n  EvalContext, ExpressionSchema, PropertyType, ScalarValue, ScopeResolver,\n} from \"@wildwinter/expr\";\n\nexport type { EvalContext, ExpressionSchema, PropertyType, ScalarValue, ScopeResolver } from \"@wildwinter/expr\";\n\n// ---------------------------------------------------------------------------\n// Declarations + the scopeRegistrySpec interop format\n// ---------------------------------------------------------------------------\n\n/**\n * A property declaration. `default` is used by an *owned* scope to seed its bag\n * (foreign scopes ignore it - the host owns the value). `writable: false` makes\n * a property read-only; default is read/write. (`type`/`values` feed validation.)\n */\nexport interface ScopeDeclaration {\n  name: string;\n  type: PropertyType;\n  values?: string[];        // for enum / flags\n  default?: ScalarValue;    // owned scopes: seed value\n  writable?: boolean;       // default true\n}\n\n/** One scope in a `scopeRegistrySpec`: a token + (optional) declarations. */\nexport interface ScopeSpec {\n  token: string;\n  /** Scope-level read/write default for its declarations (default true). */\n  writable?: boolean;\n  /** Property declarations; omit for an opaque scope (any name, unchecked). */\n  declarations?: ScopeDeclaration[];\n}\n\n/**\n * The interop format an owner (Storylet Studio, a host game) exports so another\n * engine can validate references into its scopes. Carried under the well-known\n * `scopeRegistrySpec` JSON key (inside a `.storyworld`, or a standalone file).\n */\nexport interface ScopeRegistrySpec {\n  version: number;\n  scopes: ScopeSpec[];\n}\n\n/** The spec versions this build understands. */\nexport const SUPPORTED_SPEC_VERSIONS = [1] as const;\n\n/**\n * Extract + validate a `scopeRegistrySpec` from any JSON value (a parsed\n * `.storyworld` bundle, or a vanilla `{ scopeRegistrySpec: ... }` manifest).\n * Returns null when the key is absent (so callers can probe arbitrary files);\n * throws on a malformed or unsupported-version spec.\n */\nexport function readScopeRegistrySpec(source: unknown): ScopeRegistrySpec | null {\n  if (!source || typeof source !== \"object\") return null;\n  const raw = (source as Record<string, unknown>).scopeRegistrySpec;\n  if (raw === undefined) return null;\n  if (typeof raw !== \"object\" || raw === null) throw new Error(\"scopeRegistrySpec must be an object\");\n  const spec = raw as Record<string, unknown>;\n  if (typeof spec.version !== \"number\") throw new Error(\"scopeRegistrySpec.version must be a number\");\n  if (!(SUPPORTED_SPEC_VERSIONS as readonly number[]).includes(spec.version)) {\n    throw new Error(`unsupported scopeRegistrySpec version ${spec.version} (supported: ${SUPPORTED_SPEC_VERSIONS.join(\", \")})`);\n  }\n  if (!Array.isArray(spec.scopes)) throw new Error(\"scopeRegistrySpec.scopes must be an array\");\n  for (const s of spec.scopes) {\n    if (!s || typeof s !== \"object\" || typeof (s as ScopeSpec).token !== \"string\") {\n      throw new Error(\"each scopeRegistrySpec scope needs a string token\");\n    }\n  }\n  return spec as unknown as ScopeRegistrySpec;\n}\n\n// ---------------------------------------------------------------------------\n// The registry / state container\n// ---------------------------------------------------------------------------\n\ninterface OwnedScope {\n  kind: \"owned\";\n  bag: Record<string, ScalarValue>;\n  decls: Map<string, ScopeDeclaration>;\n}\ninterface ForeignScope {\n  kind: \"foreign\";\n  resolver: ScopeResolver;\n  decls: Map<string, ScopeDeclaration>;\n  scopeWritable: boolean;\n}\ntype Entry = OwnedScope | ForeignScope;\n\nexport class ScopeRegistry {\n  private readonly scopes = new Map<string, Entry>();\n\n  /**\n   * Register a scope this registry **owns and stores**. Its bag is seeded from\n   * each declaration's `default` (or a type default). Owned scopes are\n   * type-checked (declarations) and serialized by `save`/`load`.\n   */\n  defineOwned(token: string, declarations: ScopeDeclaration[]): this {\n    this.assertFree(token);\n    const bag: Record<string, ScalarValue> = {};\n    const decls = new Map<string, ScopeDeclaration>();\n    for (const d of declarations) {\n      const name = d.name.toLowerCase();\n      decls.set(name, d);\n      bag[name] = d.default ?? defaultFor(d);\n    }\n    this.scopes.set(token, { kind: \"owned\", bag, decls });\n    return this;\n  }\n\n  /**\n   * Re-initialise an existing **owned** scope's bag from new declarations,\n   * clearing its current values. For scope-local state that resets on a context\n   * change (e.g. entering a new scene / site / deck) without disturbing other\n   * scopes. Mutates the bag in place, so an `EvalContext` already built from this\n   * registry stays valid.\n   */\n  reseedOwned(token: string, declarations: ScopeDeclaration[]): this {\n    const e = this.scopes.get(token);\n    if (!e || e.kind !== \"owned\") throw new Error(`'@${token}' is not an owned scope`);\n    for (const k of Object.keys(e.bag)) delete e.bag[k];\n    e.decls.clear();\n    for (const d of declarations) {\n      const name = d.name.toLowerCase();\n      e.decls.set(name, d);\n      e.bag[name] = d.default ?? defaultFor(d);\n    }\n    return this;\n  }\n\n  /**\n   * Register a **foreign** scope backed by a host `{ get, set? }` resolver. The\n   * values live in the host/other engine and are never stored or saved here.\n   * `declarations` (optional, e.g. imported from a `scopeRegistrySpec`) are used\n   * only for validation; omit them for an opaque scope.\n   */\n  defineForeign(\n    token: string,\n    resolver: ScopeResolver,\n    declarations: ScopeDeclaration[] = [],\n    scopeWritable = true,\n  ): this {\n    this.assertFree(token);\n    const decls = new Map<string, ScopeDeclaration>();\n    for (const d of declarations) decls.set(d.name.toLowerCase(), d);\n    this.scopes.set(token, { kind: \"foreign\", resolver, decls, scopeWritable });\n    return this;\n  }\n\n  has(token: string): boolean {\n    return this.scopes.has(token);\n  }\n\n  /** Read a property; undefined if the scope or property is not present. */\n  get(scope: string, name: string): ScalarValue | undefined {\n    const e = this.scopes.get(scope);\n    if (!e) return undefined;\n    const n = name.toLowerCase();\n    return e.kind === \"owned\" ? e.bag[n] : e.resolver.get(n);\n  }\n\n  /** Write a property. Throws on an unknown or read-only scope/property. */\n  set(scope: string, name: string, value: ScalarValue): void {\n    const e = this.scopes.get(scope);\n    if (!e) throw new Error(`unknown scope '@${scope}'`);\n    const n = name.toLowerCase();\n    if (!this.writable(e, n)) throw new Error(`'@${scope}.${name}' is read-only`);\n    if (e.kind === \"owned\") e.bag[n] = value;\n    else e.resolver.set!(n, value);\n  }\n\n  private writable(e: Entry, name: string): boolean {\n    if (e.kind === \"owned\") return e.decls.get(name)?.writable ?? true;\n    if (!e.resolver.set) return false;                 // no setter => read-only scope\n    return e.decls.get(name)?.writable ?? e.scopeWritable;\n  }\n\n  /**\n   * Build the `EvalContext` expr's `evaluate` consumes: owned scopes as static\n   * bags, foreign scopes as their resolvers. `host` carries dialect-function\n   * callbacks (PRNG, tag lookups) and is passed through untouched.\n   */\n  toEvalContext(host?: Record<string, unknown>): EvalContext {\n    const scopes: EvalContext[\"scopes\"] = {};\n    for (const [token, e] of this.scopes) {\n      scopes[token] = e.kind === \"owned\" ? e.bag : e.resolver;\n    }\n    return { scopes, host };\n  }\n\n  /**\n   * Build the `ExpressionSchema` expr's validator consumes. Scopes with no\n   * declarations are **omitted** (opaque - references into them are not flagged);\n   * declared scopes contribute their property types for validation.\n   */\n  toSchema(): ExpressionSchema {\n    const properties = new Map<string, Map<string, { type: PropertyType; enumValues?: string[] }>>();\n    for (const [token, e] of this.scopes) {\n      if (e.decls.size === 0) continue;\n      const m = new Map<string, { type: PropertyType; enumValues?: string[] }>();\n      for (const [name, d] of e.decls) m.set(name, { type: d.type, enumValues: d.values });\n      properties.set(token, m);\n    }\n    return { properties };\n  }\n\n  /** Serialize **owned** scopes only (foreign scopes are host-owned, host-saved). */\n  save(): Record<string, Record<string, ScalarValue>> {\n    const out: Record<string, Record<string, ScalarValue>> = {};\n    for (const [token, e] of this.scopes) if (e.kind === \"owned\") out[token] = { ...e.bag };\n    return out;\n  }\n\n  /** Restore owned-scope values from a `save` blob. Unknown/foreign scopes are ignored. */\n  load(blob: Record<string, Record<string, ScalarValue>>): void {\n    for (const [token, vals] of Object.entries(blob)) {\n      const e = this.scopes.get(token);\n      if (e?.kind === \"owned\") Object.assign(e.bag, vals);\n    }\n  }\n\n  private assertFree(token: string): void {\n    if (this.scopes.has(token)) throw new Error(`scope '@${token}' is already registered`);\n  }\n}\n\nfunction defaultFor(d: ScopeDeclaration): ScalarValue {\n  if (d.default !== undefined) return d.default;\n  switch (d.type) {\n    case \"boolean\": return false;\n    case \"number\": return 0;\n    case \"string\": return \"\";\n    case \"enum\": return d.values?.[0] ?? \"\";\n    case \"flags\": return [];\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@wildwinter/scoperegistry",
+  "version": "0.1.0",
+  "description": "Scope registry / runtime state container for @wildwinter/expr: owned property scopes + foreign (host-resolved) scopes, save/load, and the scopeRegistrySpec interop format. Produces the EvalContext and ExpressionSchema that expr consumes.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Ian Thomas",
+  "repository": { "type": "git", "url": "git+https://github.com/wildwinter/expr.git", "directory": "packages/scoperegistry" },
+  "keywords": ["expression", "scope", "registry", "state", "wildwinter"],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "sideEffects": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@wildwinter/expr": "^0.3.0"
+  }
+}