@patterkit/core 0.2.3 → 0.2.4

package/dist/index.cjs

@@ -25,6 +25,7 @@ __export(index_exports, {
   gameIdify: () => import_model4.gameIdify,
   hash32: () => hash32,
   hash4: () => hash4,
+  humanizeNodeRefs: () => humanizeNodeRefs,
   isValidGameId: () => import_model4.isValidGameId,
   newId: () => import_toolkit.newId,
   parseSource: () => import_toolkit3.parseSource,
@@ -52,6 +53,12 @@ function hash32(input) {
 // src/index.ts
 var import_model4 = require("@patterkit/model");
 
+// src/noderefs.ts
+var VISIT_FN_RE = /\b(patter_visits|patter_seen|visits|seen)\s*\(\s*(?:(['"])(.*?)\2|([A-Za-z_]\w*))\s*\)/g;
+function humanizeNodeRefs(cond, label) {
+  return cond.replace(VISIT_FN_RE, (_m, fn, _q, quoted, bare) => `${fn}(${label(quoted ?? bare ?? "")})`);
+}
+
 // src/serialize.ts
 var import_json5 = require("json5");
 var import_toolkit3 = require("@wildwinter/toolkit");
@@ -472,6 +479,7 @@ function defaultMatchesType(value, decl) {
   gameIdify,
   hash32,
   hash4,
+  humanizeNodeRefs,
   isValidGameId,
   newId,
   parseSource,

package/dist/index.d.cts

@@ -9,6 +9,13 @@ declare function hash4(input: string): string;
 /** Deterministic 7-char base-36 hash of a string (full FNV-1a 32-bit width) - e.g. content hashes. */
 declare function hash32(input: string): string;
 
+/**
+ * Rewrite every `visits(id)` / `seen(id)` in `cond` with `label(id)` in place of the id, leaving the
+ * rest of the expression untouched. `label` returns the id itself for anything it cannot name, so an
+ * id that no longer resolves still reads as it always did rather than vanishing.
+ */
+declare function humanizeNodeRefs(cond: string, label: (id: string) => string): string;
+
 /** Options for {@link canonicalStringify}. */
 interface StringifyOptions {
     /** Emit a trailing comma after the last item/entry (the canonical SOURCE form).
@@ -33,4 +40,4 @@ interface ProjectInput {
 /** Validate a project's structural invariants. Returns an empty array when valid. */
 declare function validateProject(input: ProjectInput): ValidationIssue[];
 
-export { type ProjectInput, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, slug, validateProject };
+export { type ProjectInput, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, humanizeNodeRefs, slug, validateProject };

package/dist/index.d.ts

@@ -9,6 +9,13 @@ declare function hash4(input: string): string;
 /** Deterministic 7-char base-36 hash of a string (full FNV-1a 32-bit width) - e.g. content hashes. */
 declare function hash32(input: string): string;
 
+/**
+ * Rewrite every `visits(id)` / `seen(id)` in `cond` with `label(id)` in place of the id, leaving the
+ * rest of the expression untouched. `label` returns the id itself for anything it cannot name, so an
+ * id that no longer resolves still reads as it always did rather than vanishing.
+ */
+declare function humanizeNodeRefs(cond: string, label: (id: string) => string): string;
+
 /** Options for {@link canonicalStringify}. */
 interface StringifyOptions {
     /** Emit a trailing comma after the last item/entry (the canonical SOURCE form).
@@ -33,4 +40,4 @@ interface ProjectInput {
 /** Validate a project's structural invariants. Returns an empty array when valid. */
 declare function validateProject(input: ProjectInput): ValidationIssue[];
 
-export { type ProjectInput, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, slug, validateProject };
+export { type ProjectInput, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, humanizeNodeRefs, slug, validateProject };

package/dist/index.js

@@ -17,6 +17,12 @@ function hash32(input) {
 // src/index.ts
 import { gameIdify, isValidGameId as isValidGameId2, effectiveGameId as effectiveGameId2 } from "@patterkit/model";
 
+// src/noderefs.ts
+var VISIT_FN_RE = /\b(patter_visits|patter_seen|visits|seen)\s*\(\s*(?:(['"])(.*?)\2|([A-Za-z_]\w*))\s*\)/g;
+function humanizeNodeRefs(cond, label) {
+  return cond.replace(VISIT_FN_RE, (_m, fn, _q, quoted, bare) => `${fn}(${label(quoted ?? bare ?? "")})`);
+}
+
 // src/serialize.ts
 import "json5";
 import { parseSource } from "@wildwinter/toolkit";
@@ -436,6 +442,7 @@ export {
   gameIdify,
   hash32,
   hash4,
+  humanizeNodeRefs,
   isValidGameId2 as isValidGameId,
   newId,
   parseSource,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/core",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Patter core: stable id generation, readable-handle computation, canonical (de)serialisation, and the structural validator.",
   "type": "module",
   "license": "MIT",