@vnejs/contracts.core.scenario 0.1.7 → 0.1.9

package/dist/commands.d.ts

@@ -1,3 +1,24 @@
+/**
+ * Positional argument slot after `$/% <name>` (and optional action).
+ * Consumed by editor tooling; not used at runtime.
+ */
+export type ScenarioArg = {
+    kind: "id";
+    optional?: boolean;
+    /**
+     * When true, only `{…}` / `"…"` / `'…'` tokens match
+     * (e.g. optional sprite variation between position and transition).
+     */
+    delimited?: boolean;
+} | {
+    kind: "number";
+    optional?: boolean;
+} | {
+    kind: "enum";
+    /** Stable key → scenario literal (same shape as EXEC_ACTIONS). */
+    values: Record<string, string>;
+    optional?: boolean;
+};
 /**
  * Declarative .vne command surface contributed by a plugin contract.
  * Tooling (editor, validation) aggregates these; not registered in VNE at runtime.
@@ -7,8 +28,22 @@ export type ScenarioCommandEntry = {
      * Named actions after `$ <module>` / `% <block>`.
      * Keys are stable identifiers; values are the literals used in scenario lines
      * (typically the same object as EXEC_ACTIONS).
+     *
+     * Used for action-first commands (`$ stack jump …`). For name-first commands
+     * (`$ flag <name> set`, `$ counter <name> ++`) prefer `args` and omit relying
+     * on first-token action matching.
      */
     actions?: Record<string, string>;
+    /**
+     * Positional args when the first token is not an action
+     * (e.g. `$ text.meet <speaker>`, `$ flag <name> [set|unset]`).
+     */
+    args?: readonly ScenarioArg[];
+    /**
+     * Positional args after a matched action literal
+     * (e.g. `$ ul.sprite show <id> <position>`).
+     */
+    argsByAction?: Record<string, readonly ScenarioArg[]>;
 };
 export type ScenarioCommandsManifest = {
     /** Handlers registered via LINE_EXEC_REG `{ module }` → `$ <name> …` */

package/dist/const.d.ts

@@ -1,11 +1,8 @@
 export declare const OTHER_MODULE: "other";
 export declare const LINE_KEYWORDS: {
-    readonly GLOBAL: "global";
     readonly SKIP_IF_POSSIBLE: "skip-if-possible";
     readonly ASYNC: "async";
-    readonly EXTEND: "extend";
     readonly AUTONEXT: "autonext";
-    readonly DANGEROUS: "dangerous";
 };
 export declare const LINE_PREFIXES: {
     readonly MODULE: "$";
@@ -22,12 +19,9 @@ export declare const LOGS_ACTIONS: {
 export declare const CONSTANTS: {
     readonly OTHER_MODULE: "other";
     readonly LINE_KEYWORDS: {
-        readonly GLOBAL: "global";
         readonly SKIP_IF_POSSIBLE: "skip-if-possible";
         readonly ASYNC: "async";
-        readonly EXTEND: "extend";
         readonly AUTONEXT: "autonext";
-        readonly DANGEROUS: "dangerous";
     };
     readonly LINE_PREFIXES: {
         readonly MODULE: "$";

package/dist/const.js

@@ -1,11 +1,8 @@
 export const OTHER_MODULE = "other";
 export const LINE_KEYWORDS = {
-    GLOBAL: "global",
     SKIP_IF_POSSIBLE: "skip-if-possible",
     ASYNC: "async",
-    EXTEND: "extend",
     AUTONEXT: "autonext",
-    DANGEROUS: "dangerous",
 };
 export const LINE_PREFIXES = {
     MODULE: "$",

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export type PluginName = typeof PLUGIN_NAME;
 export { CONSTANTS };
 export type { Constants } from "./const.js";
 export { SCENARIO_COMMANDS };
-export type { ScenarioCommandEntry, ScenarioCommands, ScenarioCommandsManifest } from "./commands.js";
+export type { ScenarioArg, ScenarioCommandEntry, ScenarioCommands, ScenarioCommandsManifest, } from "./commands.js";
 export { SUBSCRIBE_EVENTS };
 export type { SubscribeEvents } from "./events.js";
 export { PARAMS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vnejs/contracts.core.scenario",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Contracts for @vnejs/plugins.core.scenario",
   "type": "module",
   "main": "dist/index.js",

package/src/commands.ts

@@ -1,5 +1,27 @@
 import { EXEC_ACTIONS } from "./const.js";
 
+/**
+ * Positional argument slot after `$/% <name>` (and optional action).
+ * Consumed by editor tooling; not used at runtime.
+ */
+export type ScenarioArg =
+  | {
+      kind: "id";
+      optional?: boolean;
+      /**
+       * When true, only `{…}` / `"…"` / `'…'` tokens match
+       * (e.g. optional sprite variation between position and transition).
+       */
+      delimited?: boolean;
+    }
+  | { kind: "number"; optional?: boolean }
+  | {
+      kind: "enum";
+      /** Stable key → scenario literal (same shape as EXEC_ACTIONS). */
+      values: Record<string, string>;
+      optional?: boolean;
+    };
+
 /**
  * Declarative .vne command surface contributed by a plugin contract.
  * Tooling (editor, validation) aggregates these; not registered in VNE at runtime.
@@ -9,8 +31,22 @@ export type ScenarioCommandEntry = {
    * Named actions after `$ <module>` / `% <block>`.
    * Keys are stable identifiers; values are the literals used in scenario lines
    * (typically the same object as EXEC_ACTIONS).
+   *
+   * Used for action-first commands (`$ stack jump …`). For name-first commands
+   * (`$ flag <name> set`, `$ counter <name> ++`) prefer `args` and omit relying
+   * on first-token action matching.
    */
   actions?: Record<string, string>;
+  /**
+   * Positional args when the first token is not an action
+   * (e.g. `$ text.meet <speaker>`, `$ flag <name> [set|unset]`).
+   */
+  args?: readonly ScenarioArg[];
+  /**
+   * Positional args after a matched action literal
+   * (e.g. `$ ul.sprite show <id> <position>`).
+   */
+  argsByAction?: Record<string, readonly ScenarioArg[]>;
 };
 
 export type ScenarioCommandsManifest = {

package/src/const.ts

@@ -1,12 +1,9 @@
 export const OTHER_MODULE = "other" as const;
 
 export const LINE_KEYWORDS = {
-  GLOBAL: "global",
   SKIP_IF_POSSIBLE: "skip-if-possible",
   ASYNC: "async",
-  EXTEND: "extend",
   AUTONEXT: "autonext",
-  DANGEROUS: "dangerous",
 } as const;
 
 export const LINE_PREFIXES = {

package/src/index.ts

@@ -17,7 +17,12 @@ export type PluginName = typeof PLUGIN_NAME;
 export { CONSTANTS };
 export type { Constants } from "./const.js";
 export { SCENARIO_COMMANDS };
-export type { ScenarioCommandEntry, ScenarioCommands, ScenarioCommandsManifest } from "./commands.js";
+export type {
+  ScenarioArg,
+  ScenarioCommandEntry,
+  ScenarioCommands,
+  ScenarioCommandsManifest,
+} from "./commands.js";
 export { SUBSCRIBE_EVENTS };
 export type { SubscribeEvents } from "./events.js";
 export { PARAMS };