@patterkit/model 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -56,8 +56,13 @@ interface GameEventBeat {
 }
 type Beat = LineBeat | TextBeat | GameEventBeat;
 type Selector = "run" | "branch" | "sequence" | "choice";
-/** How a `sequence` walks its children. */
-type SelectorOrder = "sequential" | "shuffle";
+/** How a `sequence` walks its children. `specificity` = **Best match**: pick the eligible
+ *  child whose condition most specifically fits the current state (the most atomic constraints
+ *  actively holding it true); equally-specific ties break by the seeded shuffle. A child with no
+ *  condition scores zero, so it acts as the filler that wins only when nothing more specific is
+ *  eligible. Composes with `exhaust`: `repeat` re-scores every visit (re-pickable, the Best-match
+ *  default), `once` uses each pick up so the group slides down to the filler (graceful degradation). */
+type SelectorOrder = "sequential" | "shuffle" | "specificity";
 /** What a `sequence` does after one full pass through its children. */
 type SelectorExhaust = "once" | "repeat" | "stick";
 /**
@@ -470,6 +475,12 @@ interface ProjectFile {
     /** Autosave: periodically persist the edited scene without an explicit Save. Default ON (omitted ===
      *  enabled); set `false` to require manual saves. */
     autosave?: boolean;
+    /** Auto Rebuild: recompile the `.patterc` bundle automatically after edits (debounced), so the on-disk
+     *  build stays current without a manual Publish Bundle. Editor-only; never reaches the bundle. Default OFF
+     *  (omitted === off) - opt-in, since it writes the bundle on every real change (poor fit if you commit the
+     *  bundle to a lock-based VCS). The rebuild is deduped (skipped when the compiled bundle is unchanged) and
+     *  a mid-edit invalid project silently keeps the last good build. */
+    autoRebuild?: boolean;
     /** Closed captions (#214): the delimiter pair that wraps non-spoken caption cues inside DIALOGUE
      *  lines (e.g. `(sigh)` in `Oh dear. (sigh) What now?`). A game can turn captions off at runtime
      *  (`setClosedCaptions(false)`), and the runtime then strips every `open…close` span - delimiters and

package/dist/index.d.ts

@@ -56,8 +56,13 @@ interface GameEventBeat {
 }
 type Beat = LineBeat | TextBeat | GameEventBeat;
 type Selector = "run" | "branch" | "sequence" | "choice";
-/** How a `sequence` walks its children. */
-type SelectorOrder = "sequential" | "shuffle";
+/** How a `sequence` walks its children. `specificity` = **Best match**: pick the eligible
+ *  child whose condition most specifically fits the current state (the most atomic constraints
+ *  actively holding it true); equally-specific ties break by the seeded shuffle. A child with no
+ *  condition scores zero, so it acts as the filler that wins only when nothing more specific is
+ *  eligible. Composes with `exhaust`: `repeat` re-scores every visit (re-pickable, the Best-match
+ *  default), `once` uses each pick up so the group slides down to the filler (graceful degradation). */
+type SelectorOrder = "sequential" | "shuffle" | "specificity";
 /** What a `sequence` does after one full pass through its children. */
 type SelectorExhaust = "once" | "repeat" | "stick";
 /**
@@ -470,6 +475,12 @@ interface ProjectFile {
     /** Autosave: periodically persist the edited scene without an explicit Save. Default ON (omitted ===
      *  enabled); set `false` to require manual saves. */
     autosave?: boolean;
+    /** Auto Rebuild: recompile the `.patterc` bundle automatically after edits (debounced), so the on-disk
+     *  build stays current without a manual Publish Bundle. Editor-only; never reaches the bundle. Default OFF
+     *  (omitted === off) - opt-in, since it writes the bundle on every real change (poor fit if you commit the
+     *  bundle to a lock-based VCS). The rebuild is deduped (skipped when the compiled bundle is unchanged) and
+     *  a mid-edit invalid project silently keeps the last good build. */
+    autoRebuild?: boolean;
     /** Closed captions (#214): the delimiter pair that wraps non-spoken caption cues inside DIALOGUE
      *  lines (e.g. `(sigh)` in `Oh dear. (sigh) What now?`). A game can turn captions off at runtime
      *  (`setClosedCaptions(false)`), and the runtime then strips every `open…close` span - delimiters and

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "@patterkit/model",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Patter data-model types: source (scene/block/group/snippet/beat/jump), project, locale, authoring. The shape source-of-truth.",
   "type": "module",
   "license": "MIT",
   "author": "Ian Thomas",
   "homepage": "https://patterkit.dev",
-  "repository": { "type": "git", "url": "git+https://github.com/patterkit/patter.git", "directory": "packages/model" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/patterkit/patter.git",
+    "directory": "packages/model"
+  },
   "bugs": "https://github.com/patterkit/patter/issues",
-  "publishConfig": { "access": "public" },
+  "publishConfig": {
+    "access": "public"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -19,7 +25,10 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "sideEffects": false,
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean"