@patterkit/dialect 0.1.9 → 0.2.0

package/dist/index.cjs

@@ -20,6 +20,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ENGINE_SCOPES: () => ENGINE_SCOPES,
+  EXTERNAL_SCOPES: () => EXTERNAL_SCOPES,
   buildSchema: () => buildSchema,
   dialectWithForeignScopes: () => dialectWithForeignScopes,
   extractSlots: () => extractSlots,
@@ -28,9 +30,18 @@ __export(index_exports, {
   patterDialect: () => patterDialect,
   renderSlotValue: () => renderSlotValue,
   splitRef: () => splitRef,
-  stripCaptions: () => stripCaptions
+  stripCaptions: () => stripCaptions,
+  withEngineScopes: () => withEngineScopes
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/engine-scopes.ts
+var ENGINE_SCOPES = [
+  { token: "patter", engine: "Patterplay", means: "Patter's shared globals" },
+  { token: "story", engine: "Storylet Engine", means: "the Storylet Engine's shared @story properties" }
+];
+
+// src/index.ts
 var import_expr = require("@wildwinter/expr");
 function host(h) {
   return h.ctx.host ?? {};
@@ -128,8 +139,15 @@ var patterDialect = {
     }
   }
 };
-function dialectWithForeignScopes(spec) {
-  if (!spec || spec.scopes.length === 0) return patterDialect;
+var EXTERNAL_SCOPES = ENGINE_SCOPES.map((s) => s.token).filter((t) => t !== "patter" && t !== "scene");
+function withEngineScopes(spec) {
+  const present = new Set((spec?.scopes ?? []).map((s) => s.token));
+  const extra = EXTERNAL_SCOPES.filter((t) => !present.has(t)).map((token) => ({ token }));
+  return { version: spec?.version ?? 1, scopes: [...spec?.scopes ?? [], ...extra] };
+}
+function dialectWithForeignScopes(given) {
+  const spec = withEngineScopes(given);
+  if (spec.scopes.length === 0) return patterDialect;
   const known = new Set(patterDialect.scopes.map((s) => s.token));
   const extra = spec.scopes.filter((s) => !known.has(s.token)).map((s) => ({ token: s.token }));
   if (extra.length === 0) return patterDialect;
@@ -363,6 +381,8 @@ function interpolate(text, resolve) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ENGINE_SCOPES,
+  EXTERNAL_SCOPES,
   buildSchema,
   dialectWithForeignScopes,
   extractSlots,
@@ -371,5 +391,6 @@ function interpolate(text, resolve) {
   patterDialect,
   renderSlotValue,
   splitRef,
-  stripCaptions
+  stripCaptions,
+  withEngineScopes
 });

package/dist/index.d.cts

@@ -2,8 +2,34 @@ import { ExpressionSchema, Dialect, ScalarValue } from '@wildwinter/expr';
 import { ScopeRegistrySpec } from '@wildwinter/scoperegistry';
 import { ProjectFile, PropertyDecl, HostScopeRegistry } from '@patterkit/model';
 
+/** Every engine's game-wide scope token across the family. A compiler accepts every token here
+ *  that is not its own engine's, unchecked: the other engine owns those names and types. */
+interface EngineScope {
+    token: string;
+    engine: string;
+    means: string;
+}
+declare const ENGINE_SCOPES: readonly EngineScope[];
+
 /** The Patter dialect: scopes patter/scene + built-in functions. */
 declare const patterDialect: Dialect;
+/**
+ * Other engines' game-wide scopes a Patter expression may name, from the family's
+ * shared list (expr/family/engine-scopes.json): `@story.act` reads the Storylet
+ * Engine's shared @story in a game that runs both. On by default, with no project
+ * setting, so combining the engines needs no wiring. They are opaque here (the
+ * other engine owns their names and types), never self-backed, and the engine
+ * reports at run time when the game has not registered one.
+ */
+declare const EXTERNAL_SCOPES: readonly string[];
+/**
+ * A foreign-scope spec with the family's other engines added as OPAQUE scopes
+ * (no declarations), unless the spec already declares them: a project that
+ * imported the Storylet Engine's spec keeps its checked declarations. For
+ * compiling and validating only; a bundle's own scopeRegistry never carries
+ * these, because the runtime self-backs what it lists.
+ */
+declare function withEngineScopes(spec?: ScopeRegistrySpec): ScopeRegistrySpec;
 /**
  * A Patter dialect extended with FOREIGN scope tokens imported from another
  * owner's `scopeRegistrySpec` (e.g. a storylet's `@world` / `@player` / `@system`).
@@ -12,7 +38,7 @@ declare const patterDialect: Dialect;
  * Foreign scopes use the default missing policy (graceful-false). With no spec
  * (or an empty one) this returns the base `patterDialect` unchanged.
  */
-declare function dialectWithForeignScopes(spec?: ScopeRegistrySpec): Dialect;
+declare function dialectWithForeignScopes(given?: ScopeRegistrySpec): Dialect;
 /**
  * Split a property ref ("@name" / "@scope.name") into scope + name - THE one
  * ref grammar, shared by the compiler's validators and the runtime so they
@@ -81,4 +107,4 @@ declare function stripCaptions(text: string, open: string, close: string): strin
  */
 declare function interpolate(text: string, resolve: (ref: string) => ScalarValue | undefined): string;
 
-export { type Slot, buildSchema, dialectWithForeignScopes, extractSlots, hostScopesToSpec, interpolate, patterDialect, renderSlotValue, splitRef, stripCaptions };
+export { ENGINE_SCOPES, EXTERNAL_SCOPES, type EngineScope, type Slot, buildSchema, dialectWithForeignScopes, extractSlots, hostScopesToSpec, interpolate, patterDialect, renderSlotValue, splitRef, stripCaptions, withEngineScopes };

package/dist/index.d.ts

@@ -2,8 +2,34 @@ import { ExpressionSchema, Dialect, ScalarValue } from '@wildwinter/expr';
 import { ScopeRegistrySpec } from '@wildwinter/scoperegistry';
 import { ProjectFile, PropertyDecl, HostScopeRegistry } from '@patterkit/model';
 
+/** Every engine's game-wide scope token across the family. A compiler accepts every token here
+ *  that is not its own engine's, unchecked: the other engine owns those names and types. */
+interface EngineScope {
+    token: string;
+    engine: string;
+    means: string;
+}
+declare const ENGINE_SCOPES: readonly EngineScope[];
+
 /** The Patter dialect: scopes patter/scene + built-in functions. */
 declare const patterDialect: Dialect;
+/**
+ * Other engines' game-wide scopes a Patter expression may name, from the family's
+ * shared list (expr/family/engine-scopes.json): `@story.act` reads the Storylet
+ * Engine's shared @story in a game that runs both. On by default, with no project
+ * setting, so combining the engines needs no wiring. They are opaque here (the
+ * other engine owns their names and types), never self-backed, and the engine
+ * reports at run time when the game has not registered one.
+ */
+declare const EXTERNAL_SCOPES: readonly string[];
+/**
+ * A foreign-scope spec with the family's other engines added as OPAQUE scopes
+ * (no declarations), unless the spec already declares them: a project that
+ * imported the Storylet Engine's spec keeps its checked declarations. For
+ * compiling and validating only; a bundle's own scopeRegistry never carries
+ * these, because the runtime self-backs what it lists.
+ */
+declare function withEngineScopes(spec?: ScopeRegistrySpec): ScopeRegistrySpec;
 /**
  * A Patter dialect extended with FOREIGN scope tokens imported from another
  * owner's `scopeRegistrySpec` (e.g. a storylet's `@world` / `@player` / `@system`).
@@ -12,7 +38,7 @@ declare const patterDialect: Dialect;
  * Foreign scopes use the default missing policy (graceful-false). With no spec
  * (or an empty one) this returns the base `patterDialect` unchanged.
  */
-declare function dialectWithForeignScopes(spec?: ScopeRegistrySpec): Dialect;
+declare function dialectWithForeignScopes(given?: ScopeRegistrySpec): Dialect;
 /**
  * Split a property ref ("@name" / "@scope.name") into scope + name - THE one
  * ref grammar, shared by the compiler's validators and the runtime so they
@@ -81,4 +107,4 @@ declare function stripCaptions(text: string, open: string, close: string): strin
  */
 declare function interpolate(text: string, resolve: (ref: string) => ScalarValue | undefined): string;
 
-export { type Slot, buildSchema, dialectWithForeignScopes, extractSlots, hostScopesToSpec, interpolate, patterDialect, renderSlotValue, splitRef, stripCaptions };
+export { ENGINE_SCOPES, EXTERNAL_SCOPES, type EngineScope, type Slot, buildSchema, dialectWithForeignScopes, extractSlots, hostScopesToSpec, interpolate, patterDialect, renderSlotValue, splitRef, stripCaptions, withEngineScopes };

package/dist/index.js

@@ -1,3 +1,9 @@
+// src/engine-scopes.ts
+var ENGINE_SCOPES = [
+  { token: "patter", engine: "Patterplay", means: "Patter's shared globals" },
+  { token: "story", engine: "Storylet Engine", means: "the Storylet Engine's shared @story properties" }
+];
+
 // src/index.ts
 import { EvalError } from "@wildwinter/expr";
 function host(h) {
@@ -96,8 +102,15 @@ var patterDialect = {
     }
   }
 };
-function dialectWithForeignScopes(spec) {
-  if (!spec || spec.scopes.length === 0) return patterDialect;
+var EXTERNAL_SCOPES = ENGINE_SCOPES.map((s) => s.token).filter((t) => t !== "patter" && t !== "scene");
+function withEngineScopes(spec) {
+  const present = new Set((spec?.scopes ?? []).map((s) => s.token));
+  const extra = EXTERNAL_SCOPES.filter((t) => !present.has(t)).map((token) => ({ token }));
+  return { version: spec?.version ?? 1, scopes: [...spec?.scopes ?? [], ...extra] };
+}
+function dialectWithForeignScopes(given) {
+  const spec = withEngineScopes(given);
+  if (spec.scopes.length === 0) return patterDialect;
   const known = new Set(patterDialect.scopes.map((s) => s.token));
   const extra = spec.scopes.filter((s) => !known.has(s.token)).map((s) => ({ token: s.token }));
   if (extra.length === 0) return patterDialect;
@@ -330,6 +343,8 @@ function interpolate(text, resolve) {
   return out;
 }
 export {
+  ENGINE_SCOPES,
+  EXTERNAL_SCOPES,
   buildSchema,
   dialectWithForeignScopes,
   extractSlots,
@@ -338,5 +353,6 @@ export {
   patterDialect,
   renderSlotValue,
   splitRef,
-  stripCaptions
+  stripCaptions,
+  withEngineScopes
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/dialect",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "The Patter dialect for @wildwinter/expr (scopes shared/scene/flow, built-in functions), an ExpressionSchema builder from property declarations, and the inline {@ref} interpolation helpers (spec §16).",
   "type": "module",
   "license": "MIT",
@@ -34,8 +34,8 @@
     "build": "tsup src/index.ts --format esm,cjs --dts --clean"
   },
   "dependencies": {
-    "@patterkit/model": "0.5.0",
+    "@patterkit/model": "0.6.0",
     "@wildwinter/expr": "^0.5.0",
-    "@wildwinter/scoperegistry": "^0.6.0"
+    "@wildwinter/scoperegistry": "^0.7.0"
   }
 }