@patterkit/play-helpers 0.3.0 → 0.3.2

package/dist/index.cjs

@@ -204,6 +204,10 @@ function createDebugLink(opts) {
       post({ t: "flowClose", flow: flowId });
     },
     observe(flowId, sceneId, beatId, type, choiceId) {
+      if (!flows.has(flowId)) {
+        flows.add(flowId);
+        post({ t: "flowOpen", flow: flowId });
+      }
       post({ t: "frame", flow: flowId, sceneId, beatId, type, choiceId });
     },
     setBuild(next) {
@@ -352,9 +356,9 @@ function createPropertyInspector(engine, opts = {}) {
       read = () => {
         if (!focused(inp)) inp.value = String(engine.getProperty(row2.ref) ?? "");
       };
-    } else if (row2.type === "enum") {
+    } else if (row2.type === "enum" || row2.type === "quality") {
       const sel = doc.createElement("select");
-      for (const v of row2.values ?? []) {
+      for (const v of (row2.type === "quality" ? row2.stages : row2.values) ?? []) {
         const o = doc.createElement("option");
         o.value = v;
         o.textContent = v;

package/dist/index.d.cts

@@ -213,7 +213,7 @@ interface SequenceOptions {
 }
 /** An option's prompt beat (spec §5): a single line | text beat - the choice text. */
 type PromptBeat = LineBeat | TextBeat;
-type PropertyType = "boolean" | "number" | "string" | "flags" | "enum";
+type PropertyType = "boolean" | "number" | "string" | "flags" | "enum" | "quality";
 interface PropertyDecl {
     name: string;
     type: PropertyType;
@@ -237,6 +237,11 @@ interface PropertyDecl {
     temporary?: boolean;
     /** For enum / flags. */
     values?: string[];
+    /** For quality: the ORDERED ladder of stage names (the shared engine's quality type, expr 0.4.0).
+     *  Ordering operators compare by position in this list and `advance()` steps along it, so the order
+     *  is the meaning - unlike `values`, whose order is presentation only. Default seeds to the first
+     *  stage when no `default` is declared. */
+    stages?: string[];
     /** Free-text author note documenting what this property is for (authoring only; shown as a hint). */
     purpose?: string;
 }
@@ -251,6 +256,8 @@ interface HostScopeDecl {
     name: string;
     type: PropertyType;
     values?: string[];
+    /** For quality: the ordered stage ladder (see `PropertyDecl.stages`). */
+    stages?: string[];
     default?: ScalarValue;
     writable?: boolean;
     /** Free-text author note documenting the property (authoring only; shown as a hint). */

package/dist/index.d.ts

@@ -213,7 +213,7 @@ interface SequenceOptions {
 }
 /** An option's prompt beat (spec §5): a single line | text beat - the choice text. */
 type PromptBeat = LineBeat | TextBeat;
-type PropertyType = "boolean" | "number" | "string" | "flags" | "enum";
+type PropertyType = "boolean" | "number" | "string" | "flags" | "enum" | "quality";
 interface PropertyDecl {
     name: string;
     type: PropertyType;
@@ -237,6 +237,11 @@ interface PropertyDecl {
     temporary?: boolean;
     /** For enum / flags. */
     values?: string[];
+    /** For quality: the ORDERED ladder of stage names (the shared engine's quality type, expr 0.4.0).
+     *  Ordering operators compare by position in this list and `advance()` steps along it, so the order
+     *  is the meaning - unlike `values`, whose order is presentation only. Default seeds to the first
+     *  stage when no `default` is declared. */
+    stages?: string[];
     /** Free-text author note documenting what this property is for (authoring only; shown as a hint). */
     purpose?: string;
 }
@@ -251,6 +256,8 @@ interface HostScopeDecl {
     name: string;
     type: PropertyType;
     values?: string[];
+    /** For quality: the ordered stage ladder (see `PropertyDecl.stages`). */
+    stages?: string[];
     default?: ScalarValue;
     writable?: boolean;
     /** Free-text author note documenting the property (authoring only; shown as a hint). */

package/dist/index.js

@@ -163,6 +163,10 @@ function createDebugLink(opts) {
       post({ t: "flowClose", flow: flowId });
     },
     observe(flowId, sceneId, beatId, type, choiceId) {
+      if (!flows.has(flowId)) {
+        flows.add(flowId);
+        post({ t: "flowOpen", flow: flowId });
+      }
       post({ t: "frame", flow: flowId, sceneId, beatId, type, choiceId });
     },
     setBuild(next) {
@@ -311,9 +315,9 @@ function createPropertyInspector(engine, opts = {}) {
       read = () => {
         if (!focused(inp)) inp.value = String(engine.getProperty(row2.ref) ?? "");
       };
-    } else if (row2.type === "enum") {
+    } else if (row2.type === "enum" || row2.type === "quality") {
       const sel = doc.createElement("select");
-      for (const v of row2.values ?? []) {
+      for (const v of (row2.type === "quality" ? row2.stages : row2.values) ?? []) {
         const o = doc.createElement("option");
         o.value = v;
         o.textContent = v;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/play-helpers",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Thin game-integration helpers around @patterkit/runtime: save/load serialisation, runtime property setters, a state logger, the Patterpad Live Link client + hot reload, a property inspector, and audio resolution. The Patterplay JS companion.",
   "type": "module",
   "license": "MIT",
@@ -34,6 +34,6 @@
     "build": "tsup src/index.ts --format esm,cjs --dts --clean"
   },
   "dependencies": {
-    "@patterkit/runtime": "0.4.3"
+    "@patterkit/runtime": "0.7.0"
   }
 }