@patterkit/core 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -36,59 +26,35 @@ __export(index_exports, {
   hash32: () => hash32,
   hash4: () => hash4,
   isValidGameId: () => import_model4.isValidGameId,
-  newId: () => newId,
-  parseSource: () => parseSource,
+  newId: () => import_toolkit.newId,
+  parseSource: () => import_toolkit3.parseSource,
   slug: () => slug,
   validateProject: () => validateProject
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/ids.ts
-var ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyz";
-function newId(prefix = "", length = 8) {
-  const limit = 256 - 256 % ALPHABET.length;
-  let token = "";
-  while (token.length < length) {
-    const bytes = new Uint8Array(length * 2);
-    globalThis.crypto.getRandomValues(bytes);
-    for (const b of bytes) {
-      if (b >= limit) continue;
-      token += ALPHABET[b % ALPHABET.length];
-      if (token.length === length) break;
-    }
-  }
-  return prefix ? `${prefix}_${token}` : token;
-}
+var import_toolkit = require("@wildwinter/toolkit");
 
 // src/handle.ts
+var import_toolkit2 = require("@wildwinter/toolkit");
 function slug(name) {
   const s = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
   return s || "_";
 }
-function fnv32(input) {
-  let h = 2166136261;
-  for (let i = 0; i < input.length; i++) {
-    h ^= input.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  return h >>> 0;
-}
 function hash4(input) {
-  return fnv32(input).toString(36).slice(-4).padStart(4, "0");
+  return (0, import_toolkit2.fnv32)(input).toString(36).slice(-4).padStart(4, "0");
 }
 function hash32(input) {
-  return fnv32(input).toString(36).padStart(7, "0");
+  return (0, import_toolkit2.fnv32)(input).toString(36).padStart(7, "0");
 }
 
 // src/index.ts
 var import_model4 = require("@patterkit/model");
 
 // src/serialize.ts
-var import_json5 = __toESM(require("json5"), 1);
-function parseSource(text) {
-  const body = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-  return import_json5.default.parse(body);
-}
+var import_json5 = require("json5");
+var import_toolkit3 = require("@wildwinter/toolkit");
 function canonicalStringify(value, opts) {
   return write(value, "", opts?.trailingComma ?? true) + "\n";
 }
@@ -460,6 +426,21 @@ function checkDecls(decls, where, issues) {
         message: `${where}: '${decl.name}' is ${decl.type} but declares no values`
       });
     }
+    if (decl.type === "quality") {
+      const stages = decl.stages ?? [];
+      if (stages.length < 2) {
+        issues.push({
+          code: "invalid-declaration",
+          message: `${where}: '${decl.name}' is a quality but declares ${stages.length === 0 ? "no stages" : "only one stage"} (a ladder needs at least two)`
+        });
+      }
+      const seenStages = /* @__PURE__ */ new Set();
+      for (const s of stages) {
+        if (!s.trim()) issues.push({ code: "invalid-declaration", message: `${where}: '${decl.name}' has an empty stage name` });
+        else if (seenStages.has(s)) issues.push({ code: "invalid-declaration", message: `${where}: '${decl.name}' declares stage '${s}' more than once` });
+        else seenStages.add(s);
+      }
+    }
     if (decl.default !== void 0 && !defaultMatchesType(decl.default, decl)) {
       issues.push({
         code: "invalid-declaration",
@@ -480,6 +461,8 @@ function defaultMatchesType(value, decl) {
       return typeof value === "string" && (decl.values?.includes(value) ?? true);
     case "flags":
       return Array.isArray(value) && value.every((v) => typeof v === "string" && (decl.values?.includes(v) ?? true));
+    case "quality":
+      return typeof value === "string" && (decl.stages?.includes(value) ?? true);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.d.cts

@@ -1,9 +1,7 @@
+export { newId, parseSource } from '@wildwinter/toolkit';
 import { ProjectFile, Scene, AuthoringFile } from '@patterkit/model';
 export { effectiveGameId, gameIdify, isValidGameId } from '@patterkit/model';
 
-/** Generate a new opaque id, e.g. `newId("scn") -> "scn_8f3kq2z1"`. */
-declare function newId(prefix?: string, length?: number): string;
-
 /** Slugify an author name into a filename- / address-safe segment. */
 declare function slug(name: string): string;
 /** Deterministic 4-char base-36 hash of a string (FNV-1a 32-bit). */
@@ -11,8 +9,6 @@ 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;
 
-/** Parse JSON5 source text (a leading BOM is tolerated). Throws on malformed input. */
-declare function parseSource(text: string): unknown;
 /** Options for {@link canonicalStringify}. */
 interface StringifyOptions {
     /** Emit a trailing comma after the last item/entry (the canonical SOURCE form).
@@ -37,4 +33,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, newId, parseSource, slug, validateProject };
+export { type ProjectInput, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, slug, validateProject };

package/dist/index.d.ts

@@ -1,9 +1,7 @@
+export { newId, parseSource } from '@wildwinter/toolkit';
 import { ProjectFile, Scene, AuthoringFile } from '@patterkit/model';
 export { effectiveGameId, gameIdify, isValidGameId } from '@patterkit/model';
 
-/** Generate a new opaque id, e.g. `newId("scn") -> "scn_8f3kq2z1"`. */
-declare function newId(prefix?: string, length?: number): string;
-
 /** Slugify an author name into a filename- / address-safe segment. */
 declare function slug(name: string): string;
 /** Deterministic 4-char base-36 hash of a string (FNV-1a 32-bit). */
@@ -11,8 +9,6 @@ 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;
 
-/** Parse JSON5 source text (a leading BOM is tolerated). Throws on malformed input. */
-declare function parseSource(text: string): unknown;
 /** Options for {@link canonicalStringify}. */
 interface StringifyOptions {
     /** Emit a trailing comma after the last item/entry (the canonical SOURCE form).
@@ -37,4 +33,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, newId, parseSource, slug, validateProject };
+export { type ProjectInput, type StringifyOptions, type ValidationIssue, canonicalStringify, hash32, hash4, slug, validateProject };

package/dist/index.js

@@ -1,33 +1,12 @@
 // src/ids.ts
-var ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyz";
-function newId(prefix = "", length = 8) {
-  const limit = 256 - 256 % ALPHABET.length;
-  let token = "";
-  while (token.length < length) {
-    const bytes = new Uint8Array(length * 2);
-    globalThis.crypto.getRandomValues(bytes);
-    for (const b of bytes) {
-      if (b >= limit) continue;
-      token += ALPHABET[b % ALPHABET.length];
-      if (token.length === length) break;
-    }
-  }
-  return prefix ? `${prefix}_${token}` : token;
-}
+import { newId } from "@wildwinter/toolkit";
 
 // src/handle.ts
+import { fnv32 } from "@wildwinter/toolkit";
 function slug(name) {
   const s = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
   return s || "_";
 }
-function fnv32(input) {
-  let h = 2166136261;
-  for (let i = 0; i < input.length; i++) {
-    h ^= input.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  return h >>> 0;
-}
 function hash4(input) {
   return fnv32(input).toString(36).slice(-4).padStart(4, "0");
 }
@@ -39,11 +18,8 @@ function hash32(input) {
 import { gameIdify, isValidGameId as isValidGameId2, effectiveGameId as effectiveGameId2 } from "@patterkit/model";
 
 // src/serialize.ts
-import JSON5 from "json5";
-function parseSource(text) {
-  const body = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-  return JSON5.parse(body);
-}
+import "json5";
+import { parseSource } from "@wildwinter/toolkit";
 function canonicalStringify(value, opts) {
   return write(value, "", opts?.trailingComma ?? true) + "\n";
 }
@@ -415,6 +391,21 @@ function checkDecls(decls, where, issues) {
         message: `${where}: '${decl.name}' is ${decl.type} but declares no values`
       });
     }
+    if (decl.type === "quality") {
+      const stages = decl.stages ?? [];
+      if (stages.length < 2) {
+        issues.push({
+          code: "invalid-declaration",
+          message: `${where}: '${decl.name}' is a quality but declares ${stages.length === 0 ? "no stages" : "only one stage"} (a ladder needs at least two)`
+        });
+      }
+      const seenStages = /* @__PURE__ */ new Set();
+      for (const s of stages) {
+        if (!s.trim()) issues.push({ code: "invalid-declaration", message: `${where}: '${decl.name}' has an empty stage name` });
+        else if (seenStages.has(s)) issues.push({ code: "invalid-declaration", message: `${where}: '${decl.name}' declares stage '${s}' more than once` });
+        else seenStages.add(s);
+      }
+    }
     if (decl.default !== void 0 && !defaultMatchesType(decl.default, decl)) {
       issues.push({
         code: "invalid-declaration",
@@ -435,6 +426,8 @@ function defaultMatchesType(value, decl) {
       return typeof value === "string" && (decl.values?.includes(value) ?? true);
     case "flags":
       return Array.isArray(value) && value.every((v) => typeof v === "string" && (decl.values?.includes(v) ?? true));
+    case "quality":
+      return typeof value === "string" && (decl.stages?.includes(value) ?? true);
   }
 }
 export {

package/package.json

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