@patterkit/runtime 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [34429f0]
+- Updated dependencies [34429f0]
+- Updated dependencies [c61c146]
+  - @patterkit/model@0.2.0
+  - @patterkit/dialect@0.1.3
+
 All notable changes to `@patterkit/runtime` (Patterplay JS) are documented here. The
 Patterplay runtimes - JS, Unity, Unreal, and Godot - are versioned in lockstep: the same
 version number always means the same runtime behaviour. This package is versioned by
@@ -7,9 +17,17 @@ version number always means the same runtime behaviour. This package is versione
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-07-13
+
+### Changed
+- Internal: the Best match (`specificity`) selection metric now uses the shared
+  `@wildwinter/expr-specificity` package instead of a per-engine inline copy. Behaviour is
+  unchanged and conformance-verified across all four engines.
+
 ## [0.2.0] - 2026-07-07
 
 ### Added
+
 - **Best match** selection (a new `sequence` order, `specificity`): among the eligible children,
   play the one whose condition most specifically fits the current state; equally-specific ties break
   by the seeded shuffle, and a condition-less child is the filler that wins only when nothing more
@@ -19,6 +37,7 @@ version number always means the same runtime behaviour. This package is versione
 ## [0.1.0] - 2026-07-04
 
 ### Added
+
 - The Patter runtime in JS/TS: `Engine` + `Flow` over a compiled `.patterc` bundle - scenes,
   blocks, run/choice/branch/sequence selectors, sticky/fallback options, call-return jumps,
   conditions + effects, visit counts, `{@ref}` interpolation, game events, tags, gameData

package/dist/index.cjs

@@ -31,6 +31,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/engine.ts
 var import_expr = require("@wildwinter/expr");
+var import_expr_specificity = require("@wildwinter/expr-specificity");
 var import_scoperegistry = require("@wildwinter/scoperegistry");
 var import_dialect = require("@patterkit/dialect");
 var import_model = require("@patterkit/model");
@@ -1036,21 +1037,8 @@ var Flow = class {
    * node (comparisons, scoped vars, literals, other calls) is an atom, evaluated whole.
    */
   matchedSpec(node, want) {
-    if (node.kind === "binary" && (node.op === "and" || node.op === "or")) {
-      const behaveAsAnd = node.op === "and" === want;
-      const l = this.matchedSpec(node.left, want);
-      const r = this.matchedSpec(node.right, want);
-      return behaveAsAnd ? l > 0 && r > 0 ? l + r : 0 : Math.max(l, r);
-    }
-    if (node.kind === "unary" && node.op === "not") {
-      return this.matchedSpec(node.operand, !want);
-    }
-    if (node.kind === "call" && node.name === "check_flags") {
-      const operands = Math.max(1, node.args.length - 1);
-      const hit = truthy((0, import_expr.evaluate)(node, this.evalCtx, import_dialect.patterDialect));
-      return want ? hit ? operands : 0 : hit ? 0 : 1;
-    }
-    return truthy((0, import_expr.evaluate)(node, this.evalCtx, import_dialect.patterDialect)) === want ? 1 : 0;
+    const evalTruthy = (n) => truthy((0, import_expr.evaluate)(n, this.evalCtx, import_dialect.patterDialect));
+    return (0, import_expr_specificity.matchedSpecificity)(node, evalTruthy, { want });
   }
   /** A selector's cursor state - shared across flows (`group.shared`) or this flow's own. */
   selectorState(group) {