@patterkit/core 0.6.1 → 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ian Thomas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -388,6 +388,20 @@ function validateProject(input) {
       });
     }
   }
+  const labelled = (project.cast ?? []).filter((c) => c.qualifierLabels && typeof c.qualifierLabels === "object");
+  const usedPairs = labelled.length === 0 ? /* @__PURE__ */ new Set() : new Set((0, import_model.usedSpeakerPairs)(scenes.filter((sc) => Array.isArray(sc?.blocks) && sc.blocks.every((b) => Array.isArray(b?.children)))).map((p) => `${p.character}\0${p.qualifier}`));
+  for (const c of labelled) {
+    const labels = c.qualifierLabels;
+    if (!labels || typeof labels !== "object") continue;
+    for (const q of Object.keys(labels)) {
+      if (usedPairs.has(`${c.name}\0${q}`)) continue;
+      issues.push({
+        code: "unused-speaker-label",
+        severity: "warning",
+        message: `'${c.name}' has its own label with the qualifier '${q}', but no line has that speaker with that qualifier`
+      });
+    }
+  }
   return issues;
 }
 function isQualifierEntry(q) {
@@ -468,6 +482,21 @@ function validateProjectFile(project, issues) {
     }
     if (typeof q.gameId === "string") seenQualifiers.add(q.gameId);
   }
+  const pattern = project.speakerPattern;
+  if (pattern !== void 0 && typeof pattern !== "string") {
+    issues.push({ code: "invalid-speaker-label", message: "the speaker pattern must be text" });
+  }
+  for (const c of project.cast ?? []) {
+    const labels = c.qualifierLabels;
+    if (labels === void 0) continue;
+    if (!labels || typeof labels !== "object" || Array.isArray(labels)) {
+      issues.push({ code: "invalid-speaker-label", message: `'${c.name}' qualifier labels must map a qualifier to its label` });
+      continue;
+    }
+    for (const [q, label] of Object.entries(labels)) {
+      if (typeof label !== "string") issues.push({ code: "invalid-speaker-label", message: `'${c.name}' label with the qualifier '${q}' must be text` });
+    }
+  }
   for (const [kind, fields] of Object.entries(project.gameDataFields ?? {})) {
     const seen = /* @__PURE__ */ new Set();
     for (const f of fields ?? []) {

package/dist/index.d.cts

@@ -26,7 +26,7 @@ interface StringifyOptions {
 declare function canonicalStringify(value: unknown, opts?: StringifyOptions): string;
 
 interface ValidationIssue {
-    code: "duplicate-id" | "missing-id" | "malformed-node" | "missing-name" | "empty-scene" | "empty-snippet" | "empty-container" | "dangling-jump" | "jump-into-non-addressable" | "invalid-gameid" | "duplicate-gameid" | "unknown-character" | "unknown-qualifier" | "invalid-qualifier" | "invalid-pad" | "pad-overlaps-seam" | "prompt-pad-without-beat" | "qualifier-without-speaker" | "invalid-temporary" | "invalid-declaration" | "invalid-status-ladder" | "invalid-locales" | "invalid-captions" | "missing-prompt" | "invalid-prompt" | "multiple-fallbacks" | "choice-can-empty" | "invalid-status-value" | "unknown-doc-class" | "invalid-tag" | "invalid-gamedata-field" | "jump-cycle";
+    code: "duplicate-id" | "missing-id" | "malformed-node" | "missing-name" | "empty-scene" | "empty-snippet" | "empty-container" | "dangling-jump" | "jump-into-non-addressable" | "invalid-gameid" | "duplicate-gameid" | "unknown-character" | "unknown-qualifier" | "invalid-qualifier" | "invalid-pad" | "pad-overlaps-seam" | "prompt-pad-without-beat" | "qualifier-without-speaker" | "invalid-speaker-label" | "unused-speaker-label" | "invalid-temporary" | "invalid-declaration" | "invalid-status-ladder" | "invalid-locales" | "invalid-captions" | "missing-prompt" | "invalid-prompt" | "multiple-fallbacks" | "choice-can-empty" | "invalid-status-value" | "unknown-doc-class" | "invalid-tag" | "invalid-gamedata-field" | "jump-cycle";
     message: string;
     /** Id of the offending node/beat, where applicable. */
     id?: string;

package/dist/index.d.ts

@@ -26,7 +26,7 @@ interface StringifyOptions {
 declare function canonicalStringify(value: unknown, opts?: StringifyOptions): string;
 
 interface ValidationIssue {
-    code: "duplicate-id" | "missing-id" | "malformed-node" | "missing-name" | "empty-scene" | "empty-snippet" | "empty-container" | "dangling-jump" | "jump-into-non-addressable" | "invalid-gameid" | "duplicate-gameid" | "unknown-character" | "unknown-qualifier" | "invalid-qualifier" | "invalid-pad" | "pad-overlaps-seam" | "prompt-pad-without-beat" | "qualifier-without-speaker" | "invalid-temporary" | "invalid-declaration" | "invalid-status-ladder" | "invalid-locales" | "invalid-captions" | "missing-prompt" | "invalid-prompt" | "multiple-fallbacks" | "choice-can-empty" | "invalid-status-value" | "unknown-doc-class" | "invalid-tag" | "invalid-gamedata-field" | "jump-cycle";
+    code: "duplicate-id" | "missing-id" | "malformed-node" | "missing-name" | "empty-scene" | "empty-snippet" | "empty-container" | "dangling-jump" | "jump-into-non-addressable" | "invalid-gameid" | "duplicate-gameid" | "unknown-character" | "unknown-qualifier" | "invalid-qualifier" | "invalid-pad" | "pad-overlaps-seam" | "prompt-pad-without-beat" | "qualifier-without-speaker" | "invalid-speaker-label" | "unused-speaker-label" | "invalid-temporary" | "invalid-declaration" | "invalid-status-ladder" | "invalid-locales" | "invalid-captions" | "missing-prompt" | "invalid-prompt" | "multiple-fallbacks" | "choice-can-empty" | "invalid-status-value" | "unknown-doc-class" | "invalid-tag" | "invalid-gamedata-field" | "jump-cycle";
     message: string;
     /** Id of the offending node/beat, where applicable. */
     id?: string;

package/dist/index.js

@@ -55,7 +55,7 @@ ${indent}}`;
 }
 
 // src/validate.ts
-import { walkNodes, DEFAULT_WRITING_STATUSES, DEFAULT_RECORDING_STATUSES, DEFAULT_DOCUMENTATION_CLASSES, projectQualifiers, PAD_AFTER_MIN, PAD_AFTER_MAX } from "@patterkit/model";
+import { walkNodes, DEFAULT_WRITING_STATUSES, DEFAULT_RECORDING_STATUSES, DEFAULT_DOCUMENTATION_CLASSES, projectQualifiers, usedSpeakerPairs, PAD_AFTER_MIN, PAD_AFTER_MAX } from "@patterkit/model";
 import { isValidGameId, effectiveGameId } from "@patterkit/model";
 import { isValidPropertyName, propertyNameify, RESERVED_PROPERTY_NAMES } from "@patterkit/model";
 function choiceLoopsBack(choice, ...targets) {
@@ -350,6 +350,20 @@ function validateProject(input) {
       });
     }
   }
+  const labelled = (project.cast ?? []).filter((c) => c.qualifierLabels && typeof c.qualifierLabels === "object");
+  const usedPairs = labelled.length === 0 ? /* @__PURE__ */ new Set() : new Set(usedSpeakerPairs(scenes.filter((sc) => Array.isArray(sc?.blocks) && sc.blocks.every((b) => Array.isArray(b?.children)))).map((p) => `${p.character}\0${p.qualifier}`));
+  for (const c of labelled) {
+    const labels = c.qualifierLabels;
+    if (!labels || typeof labels !== "object") continue;
+    for (const q of Object.keys(labels)) {
+      if (usedPairs.has(`${c.name}\0${q}`)) continue;
+      issues.push({
+        code: "unused-speaker-label",
+        severity: "warning",
+        message: `'${c.name}' has its own label with the qualifier '${q}', but no line has that speaker with that qualifier`
+      });
+    }
+  }
   return issues;
 }
 function isQualifierEntry(q) {
@@ -430,6 +444,21 @@ function validateProjectFile(project, issues) {
     }
     if (typeof q.gameId === "string") seenQualifiers.add(q.gameId);
   }
+  const pattern = project.speakerPattern;
+  if (pattern !== void 0 && typeof pattern !== "string") {
+    issues.push({ code: "invalid-speaker-label", message: "the speaker pattern must be text" });
+  }
+  for (const c of project.cast ?? []) {
+    const labels = c.qualifierLabels;
+    if (labels === void 0) continue;
+    if (!labels || typeof labels !== "object" || Array.isArray(labels)) {
+      issues.push({ code: "invalid-speaker-label", message: `'${c.name}' qualifier labels must map a qualifier to its label` });
+      continue;
+    }
+    for (const [q, label] of Object.entries(labels)) {
+      if (typeof label !== "string") issues.push({ code: "invalid-speaker-label", message: `'${c.name}' label with the qualifier '${q}' must be text` });
+    }
+  }
   for (const [kind, fields] of Object.entries(project.gameDataFields ?? {})) {
     const seen = /* @__PURE__ */ new Set();
     for (const f of fields ?? []) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/core",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Patter core: stable id generation, readable-handle computation, canonical (de)serialisation, and the structural validator.",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,7 @@
     "build": "tsup src/index.ts --format esm,cjs --dts --clean"
   },
   "dependencies": {
-    "@patterkit/model": "0.13.0",
+    "@patterkit/model": "0.14.0",
     "@wildwinter/toolkit": "^0.1.0",
     "json5": "^2.2.3"
   }