@scenar/sdk 0.1.19 → 0.1.20

package/index.d.ts

@@ -4,5 +4,5 @@ export { loadScenarioFromProto } from "./proto/load-scenario.js";
 export type { LoadScenarioOptions } from "./proto/load-scenario.js";
 export { InvalidScenarioError } from "./proto/errors.js";
 export { PROTO_ACTION_TYPE } from "./proto/proto-types.js";
-export type { ProtoActionTypeValue, ProtoScenario, ProtoStep, ProtoStepAction, ProtoStepActionConfig, ProtoViewportConfig, } from "./proto/proto-types.js";
+export type { ProtoActionTypeValue, ProtoScenarioSpec, ProtoStep, ProtoStepAction, ProtoStepActionConfig, ProtoViewportConfig, } from "./proto/proto-types.js";
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,aAAa,EACb,OAAO,GACR,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,SAAS,EACT,aAAa,EACb,OAAO,GACR,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenar/sdk",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Typed authoring surface for Scenar scenarios — createScenario() builder and proto adapter.",
   "license": "Apache-2.0",
   "type": "module",
@@ -28,6 +28,6 @@
     }
   },
   "dependencies": {
-    "@scenar/core": "0.1.19"
+    "@scenar/core": "0.1.20"
   }
 }

package/proto/load-scenario.d.ts

@@ -1,5 +1,5 @@
 import type { AuthoredScenario, ViewRegistry } from "../author/types.js";
-import type { ProtoScenario } from "./proto-types.js";
+import type { ProtoScenarioSpec } from "./proto-types.js";
 /**
  * Options for {@link loadScenarioFromProto}.
  */
@@ -8,10 +8,10 @@ export interface LoadScenarioOptions<Views extends ViewRegistry> {
     readonly views: Views;
 }
 /**
- * Convert a proto `Scenario` message into an `AuthoredScenario`
+ * Convert a proto `ScenarioSpec` message into an `AuthoredScenario`
  * ready for `<ScenarioPlayer>`.
  *
- * This is the YAML ingestion path: a scenario parsed from protobuf
+ * This is the YAML ingestion path: a scenario spec parsed from protobuf
  * (or proto-JSON) enters here and comes out as the same shape that
  * `createScenario()` produces.
  *
@@ -21,5 +21,5 @@ export interface LoadScenarioOptions<Views extends ViewRegistry> {
  * @throws {InvalidScenarioError} with a path and reason on any
  *   structural or semantic validation failure.
  */
-export declare function loadScenarioFromProto<Views extends ViewRegistry>(scenario: ProtoScenario, options: LoadScenarioOptions<Views>): AuthoredScenario<Views>;
+export declare function loadScenarioFromProto<Views extends ViewRegistry>(spec: ProtoScenarioSpec, options: LoadScenarioOptions<Views>): AuthoredScenario<Views>;
 //# sourceMappingURL=load-scenario.d.ts.map

package/proto/load-scenario.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-scenario.d.ts","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,YAAY;IAC7D,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,YAAY,EAC9D,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAClC,gBAAgB,CAAC,KAAK,CAAC,CA6CzB"}
+{"version":3,"file":"load-scenario.d.ts","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,KAAK,SAAS,YAAY;IAC7D,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,YAAY,EAC9D,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAClC,gBAAgB,CAAC,KAAK,CAAC,CA6CzB"}

package/proto/load-scenario.js

@@ -1,10 +1,10 @@
 import { InvalidScenarioError } from "./errors.js";
 import { mapProtoAction } from "./action-mapper.js";
 /**
- * Convert a proto `Scenario` message into an `AuthoredScenario`
+ * Convert a proto `ScenarioSpec` message into an `AuthoredScenario`
  * ready for `<ScenarioPlayer>`.
  *
- * This is the YAML ingestion path: a scenario parsed from protobuf
+ * This is the YAML ingestion path: a scenario spec parsed from protobuf
  * (or proto-JSON) enters here and comes out as the same shape that
  * `createScenario()` produces.
  *
@@ -14,14 +14,14 @@ import { mapProtoAction } from "./action-mapper.js";
  * @throws {InvalidScenarioError} with a path and reason on any
  *   structural or semantic validation failure.
  */
-export function loadScenarioFromProto(scenario, options) {
-    if (scenario.steps.length === 0) {
+export function loadScenarioFromProto(spec, options) {
+    if (spec.steps.length === 0) {
         throw new InvalidScenarioError("steps", "steps array must not be empty.");
     }
     const viewNames = new Set(Object.keys(options.views));
     const steps = [];
-    for (let i = 0; i < scenario.steps.length; i++) {
-        const protoStep = scenario.steps[i];
+    for (let i = 0; i < spec.steps.length; i++) {
+        const protoStep = spec.steps[i];
         const stepPath = `steps[${i}]`;
         if (!protoStep.view) {
             throw new InvalidScenarioError(`${stepPath}.view`, "view is required.");
@@ -43,7 +43,7 @@ export function loadScenarioFromProto(scenario, options) {
         });
     }
     return {
-        viewport: scenario.viewport ? { width: scenario.viewport.width, height: scenario.viewport.height } : undefined,
+        viewport: spec.viewport ? { width: spec.viewport.width, height: spec.viewport.height } : undefined,
         views: options.views,
         steps,
     };

package/proto/load-scenario.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-scenario.js","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUpD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAuB,EACvB,OAAmC;IAEnC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAA4C,EAAE,CAAC;IAE1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC;QAE/B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAAC,GAAG,QAAQ,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,oBAAoB,CAC5B,GAAG,QAAQ,OAAO,EAClB,IAAI,SAAS,CAAC,IAAI,kCAAkC;gBACpD,qBAAqB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClD,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CACjE,cAAc,CAAC,WAAW,EAAE,GAAG,QAAQ,iBAAiB,CAAC,GAAG,CAAC,CAC9D,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,KAAK,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAqC;aACxC;YAC5B,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS;YACvC,SAAS,EAAE,SAAS,CAAC,aAAa,IAAI,SAAS;YAC/C,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QAC9G,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"load-scenario.js","sourceRoot":"","sources":["../../src/proto/load-scenario.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUpD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB,EACvB,OAAmC;IAEnC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAA4C,EAAE,CAAC;IAE1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC;QAE/B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,oBAAoB,CAAC,GAAG,QAAQ,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,oBAAoB,CAC5B,GAAG,QAAQ,OAAO,EAClB,IAAI,SAAS,CAAC,IAAI,kCAAkC;gBACpD,qBAAqB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClD,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CACjE,cAAc,CAAC,WAAW,EAAE,GAAG,QAAQ,iBAAiB,CAAC,GAAG,CAAC,CAC9D,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,KAAK,EAAE,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAqC;aACxC;YAC5B,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,SAAS;YACvC,SAAS,EAAE,SAAS,CAAC,aAAa,IAAI,SAAS;YAC/C,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;SACjE,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QAClG,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK;KACN,CAAC;AACJ,CAAC"}

package/proto/proto-types.d.ts

@@ -89,8 +89,8 @@ export interface ProtoStep {
     readonly props?: Record<string, unknown>;
     readonly interactions: readonly ProtoStepAction[];
 }
-/** Structural shape of the proto `Scenario` message. */
-export interface ProtoScenario {
+/** Structural shape of the proto `ScenarioSpec` message. */
+export interface ProtoScenarioSpec {
     readonly viewport?: ProtoViewportConfig;
     readonly steps: readonly ProtoStep[];
 }

package/proto/proto-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proto-types.d.ts","sourceRoot":"","sources":["../../src/proto/proto-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE9F,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,6BAA6B,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3C,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;CACnD;AAED,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC"}
+{"version":3,"file":"proto-types.d.ts","sourceRoot":"","sources":["../../src/proto/proto-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,kDAAkD;AAClD,eAAO,MAAM,iBAAiB;;;;;;;;;;CAUpB,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE9F,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,KAAK,EAAE,6BAA6B,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3C,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;CACnD;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC"}

package/src/__tests__/load-scenario.test.ts

@@ -1,7 +1,10 @@
 import { describe, expect, it } from "vitest";
 import { loadScenarioFromProto } from "../proto/load-scenario.js";
 import { InvalidScenarioError } from "../proto/errors.js";
-import { PROTO_ACTION_TYPE, type ProtoScenario } from "../proto/proto-types.js";
+import {
+  PROTO_ACTION_TYPE,
+  type ProtoScenarioSpec,
+} from "../proto/proto-types.js";
 
 interface SettingsProps {
   readonly org: string;
@@ -21,7 +24,7 @@ function FormView(_props: FormProps): unknown {
 
 const views = { settings: SettingsView, form: FormView };
 
-function makeValidScenario(): ProtoScenario {
+function makeValidScenario(): ProtoScenarioSpec {
   return {
     viewport: { width: 896, height: 540 },
     steps: [
@@ -86,7 +89,7 @@ describe("loadScenarioFromProto", () => {
   it("defaults props to empty object when proto props is undefined", () => {
     const proto = makeValidScenario();
     const step = { ...proto.steps[0]!, props: undefined };
-    const modified: ProtoScenario = {
+    const modified: ProtoScenarioSpec = {
       ...proto,
       steps: [step],
     };
@@ -97,7 +100,7 @@ describe("loadScenarioFromProto", () => {
 
   it("handles scenario with no viewport", () => {
     const proto = makeValidScenario();
-    const modified: ProtoScenario = {
+    const modified: ProtoScenarioSpec = {
       ...proto,
       viewport: undefined,
     };
@@ -107,7 +110,7 @@ describe("loadScenarioFromProto", () => {
   });
 
   it("throws when steps array is empty", () => {
-    const proto: ProtoScenario = { steps: [] };
+    const proto: ProtoScenarioSpec = { steps: [] };
 
     expect(() => loadScenarioFromProto(proto, { views })).toThrow(
       /steps array must not be empty/,
@@ -115,7 +118,7 @@ describe("loadScenarioFromProto", () => {
   });
 
   it("throws when a step references an unregistered view", () => {
-    const modified: ProtoScenario = {
+    const modified: ProtoScenarioSpec = {
       steps: [
         {
           view: "unknown-view",
@@ -141,7 +144,7 @@ describe("loadScenarioFromProto", () => {
 
   it("throws when an action has unspecified type", () => {
     const proto = makeValidScenario();
-    const modified: ProtoScenario = {
+    const modified: ProtoScenarioSpec = {
       ...proto,
       steps: [
         {
@@ -168,7 +171,7 @@ describe("loadScenarioFromProto", () => {
   });
 
   it("omits empty narration and caption strings", () => {
-    const modified: ProtoScenario = {
+    const modified: ProtoScenarioSpec = {
       steps: [
         {
           view: "settings",

package/src/index.ts

@@ -22,7 +22,7 @@ export { InvalidScenarioError } from "./proto/errors.js";
 export { PROTO_ACTION_TYPE } from "./proto/proto-types.js";
 export type {
   ProtoActionTypeValue,
-  ProtoScenario,
+  ProtoScenarioSpec,
   ProtoStep,
   ProtoStepAction,
   ProtoStepActionConfig,

package/src/proto/load-scenario.ts

@@ -5,7 +5,7 @@ import type {
   ViewRegistry,
 } from "../author/types.js";
 import { InvalidScenarioError } from "./errors.js";
-import type { ProtoScenario } from "./proto-types.js";
+import type { ProtoScenarioSpec } from "./proto-types.js";
 import { mapProtoAction } from "./action-mapper.js";
 
 /**
@@ -17,10 +17,10 @@ export interface LoadScenarioOptions<Views extends ViewRegistry> {
 }
 
 /**
- * Convert a proto `Scenario` message into an `AuthoredScenario`
+ * Convert a proto `ScenarioSpec` message into an `AuthoredScenario`
  * ready for `<ScenarioPlayer>`.
  *
- * This is the YAML ingestion path: a scenario parsed from protobuf
+ * This is the YAML ingestion path: a scenario spec parsed from protobuf
  * (or proto-JSON) enters here and comes out as the same shape that
  * `createScenario()` produces.
  *
@@ -31,18 +31,18 @@ export interface LoadScenarioOptions<Views extends ViewRegistry> {
  *   structural or semantic validation failure.
  */
 export function loadScenarioFromProto<Views extends ViewRegistry>(
-  scenario: ProtoScenario,
+  spec: ProtoScenarioSpec,
   options: LoadScenarioOptions<Views>,
 ): AuthoredScenario<Views> {
-  if (scenario.steps.length === 0) {
+  if (spec.steps.length === 0) {
     throw new InvalidScenarioError("steps", "steps array must not be empty.");
   }
 
   const viewNames = new Set(Object.keys(options.views));
   const steps: ScenarioStep<AuthoredStepData<Views>>[] = [];
 
-  for (let i = 0; i < scenario.steps.length; i++) {
-    const protoStep = scenario.steps[i]!;
+  for (let i = 0; i < spec.steps.length; i++) {
+    const protoStep = spec.steps[i]!;
     const stepPath = `steps[${i}]`;
 
     if (!protoStep.view) {
@@ -74,7 +74,7 @@ export function loadScenarioFromProto<Views extends ViewRegistry>(
   }
 
   return {
-    viewport: scenario.viewport ? { width: scenario.viewport.width, height: scenario.viewport.height } : undefined,
+    viewport: spec.viewport ? { width: spec.viewport.width, height: spec.viewport.height } : undefined,
     views: options.views,
     steps,
   };

package/src/proto/proto-types.ts

@@ -86,8 +86,8 @@ export interface ProtoStep {
   readonly interactions: readonly ProtoStepAction[];
 }
 
-/** Structural shape of the proto `Scenario` message. */
-export interface ProtoScenario {
+/** Structural shape of the proto `ScenarioSpec` message. */
+export interface ProtoScenarioSpec {
   readonly viewport?: ProtoViewportConfig;
   readonly steps: readonly ProtoStep[];
 }