@wildwinter/toolkit 0.2.7 → 0.3.1

package/dist/extensions.cjs

@@ -14,13 +14,11 @@ var MANIFEST_FILE_SUFFIX = ".extension.json";
 var HOSTS = {
   patter: {
     kinds: ["scene", "block", "snippet", "line", "text", "gameEvent", "option", "project"],
-    references: ["cast", "scene", "block", "snippet", "line"],
-    claimable: ["scene", "block", "snippet", "line", "text", "gameEvent", "option"]
+    references: ["cast", "scene", "block", "snippet", "line"]
   },
   storylets: {
     kinds: ["box", "tagGroup", "tag", "deck", "card", "outcome", "handTemplate", "hand", "project"],
-    references: ["box", "deck", "card", "outcome", "tag"],
-    claimable: ["card", "outcome"]
+    references: ["box", "deck", "card", "outcome", "tag"]
   }
 };
 var SCALAR_TYPES = ["text", "multiline", "number", "boolean", "enum", "flags", "quality"];
@@ -367,10 +365,15 @@ var ID = /^[a-z][a-z0-9-]*$/;
 var VERSION = /^\d+\.\d+\.\d+$/;
 var NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var TYPE_KEYS = ["type", "values", "stages", "renamedStages", "to", "from", "fields", "key", "of", "id", "min", "max", "valueHelp", "default"];
-var FIELD_KEYS = /* @__PURE__ */ new Set([...TYPE_KEYS, "name", "label", "help", "required", "group", "editorOnly"]);
-var CLAIM_KEYS = /* @__PURE__ */ new Set([...TYPE_KEYS, "setting", "label", "help", "required"]);
+var FIELD_KEYS = /* @__PURE__ */ new Set([...TYPE_KEYS, "name", "label", "help", "required", "group", "editorOnly", "editor"]);
 var BARE_KEYS = new Set(TYPE_KEYS);
-var MANIFEST_KEYS = /* @__PURE__ */ new Set(["schema", "id", "name", "version", "docs", "settings", "targets", "views", "reads"]);
+var MANIFEST_KEYS = /* @__PURE__ */ new Set(["schema", "id", "name", "version", "docs", "targets", "views", "reads", "requires"]);
+var REMOVED_MANIFEST_KEYS = {
+  settings: "settings were removed with claims; declare the extension's own fields, or a project field for a project-wide value"
+};
+var REMOVED_TARGET_KEYS = {
+  claims: "claims on host fields were removed; declare a field of the extension's own, which the runtimes hand the game"
+};
 var VIEW_KEYS = /* @__PURE__ */ new Set(["id", "name", "entry", "element", "hosts"]);
 var ELEMENT = /^[a-z][a-z0-9._]*-[a-z0-9._-]*$/;
 var err2 = (code, path, message) => ({ severity: "error", code, path, message });
@@ -381,7 +384,7 @@ function manifestProblems(manifest) {
   const out = [];
   if (!isObject(manifest)) return [err2("not-an-object", "", "a manifest is a JSON object")];
   const m = manifest;
-  unknownKeys(m, MANIFEST_KEYS, "", out);
+  unknownKeys(m, MANIFEST_KEYS, "", out, REMOVED_MANIFEST_KEYS);
   if (m["schema"] !== MANIFEST_SCHEMA) {
     out.push(err2("schema", "schema", `the schema tag is ${JSON.stringify(m["schema"])}, not "${MANIFEST_SCHEMA}"`));
   }
@@ -393,9 +396,9 @@ function manifestProblems(manifest) {
     out.push(err2("version", "version", "the version is major.minor.patch, such as 1.0.0"));
   }
   if (m["docs"] !== void 0 && typeof m["docs"] !== "string") out.push(err2("docs", "docs", "docs is a link, as text"));
-  const settings = settingsProblems(m["settings"], out);
   viewsProblems(m["views"], m["targets"], out);
   readsProblems(m["reads"], m["id"], out);
+  requiresProblems(m["requires"], m["id"], out);
   const targets = m["targets"];
   if (!isObject(targets) || Object.keys(targets).length === 0) {
     out.push(err2("no-targets", "targets", "the manifest targets no host"));
@@ -418,9 +421,10 @@ function manifestProblems(manifest) {
         out.push(err2("unknown-kind", kindPath, `"${kind}" is not a node kind of ${host}; it has ${spec.kinds.join(", ")}`));
         continue;
       }
-      targetProblems(host, kind, target, kindPath, settings, out);
+      targetProblems(host, target, kindPath, out);
     }
     pickListProblems(kinds, hostPath, out);
+    editorProblems(host, kinds, m["views"], Object.keys(targets), hostPath, out);
   }
   return out;
 }
@@ -560,85 +564,75 @@ function readsProblems(reads, self, out) {
     else seen.add(r);
   });
 }
+function requiresProblems(requires, self, out) {
+  if (requires === void 0) return;
+  if (!Array.isArray(requires)) {
+    out.push(err2("not-a-list", "requires", "requires is a list of extension ids"));
+    return;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  requires.forEach((r, i) => {
+    const at = atIndex("requires", i);
+    if (typeof r !== "string" || !ID.test(r)) out.push(err2("requires-id", at, "a required extension is named by its id: lower case letters, digits and hyphens"));
+    else if (r === self) out.push(err2("requires-self", at, "an extension can't require itself"));
+    else if (seen.has(r)) out.push(err2("requires-duplicate", at, `"${r}" is listed twice`));
+    else seen.add(r);
+  });
+}
+function missingRequirements(manifest, taken) {
+  const have = new Set(taken);
+  const out = [];
+  for (const r of Array.isArray(manifest.requires) ? manifest.requires : []) {
+    if (typeof r === "string" && ID.test(r) && r !== manifest.id && !have.has(r) && !out.includes(r)) out.push(r);
+  }
+  return out;
+}
+function editorProblems(host, kinds, views, targeted, hostPath, out) {
+  const declared = Array.isArray(views) ? views.filter((v) => isObject(v) && typeof v["id"] === "string") : [];
+  for (const [kind, target] of Object.entries(kinds)) {
+    if (!isObject(target) || !Array.isArray(target["fields"])) continue;
+    target["fields"].forEach((f, i) => {
+      if (!isObject(f) || f["editor"] === void 0) return;
+      const at = atKey(atIndex(atKey(atKey(hostPath, kind), "fields"), i), "editor");
+      const editor = f["editor"];
+      const view = typeof editor === "string" ? declared.find((v) => v["id"] === editor) : void 0;
+      if (view === void 0) {
+        out.push(err2("editor-view", at, typeof editor === "string" ? `the manifest declares no view called "${editor}"; an editor names one of its views by id` : "an editor names one of the manifest's views by its id"));
+        return;
+      }
+      const opensIn = Array.isArray(view["hosts"]) ? view["hosts"] : targeted;
+      if (!opensIn.includes(host)) {
+        out.push(err2("editor-host", at, `the view "${editor}" doesn't open in ${host}`));
+        return;
+      }
+      const d = f;
+      if (!(d.type === "map" && isObject(d.of) && d.of.type === "record")) {
+        out.push({ severity: "warning", code: "editor-ignored", path: at, message: "only a map of records opens in an editor; this field is edited in place, so the editor is ignored" });
+      }
+    });
+  }
+}
 function viewsFor(manifest, host) {
   const targeted = Object.keys(manifest.targets ?? {});
   return (Array.isArray(manifest.views) ? manifest.views : []).filter((v) => isObject(v) && typeof v.id === "string" && ID.test(v.id) && typeof v.name === "string" && isViewEntry(v.entry) && typeof v.element === "string" && ELEMENT.test(v.element) && (v.hosts === void 0 ? targeted.includes(host) : Array.isArray(v.hosts) && v.hosts.includes(host)));
 }
-function unknownKeys(obj, known, path, out) {
+function unknownKeys(obj, known, path, out, removed = {}) {
   for (const k of Object.keys(obj)) {
-    if (!known.has(k)) {
+    if (own(removed, k)) {
+      out.push({ severity: "warning", code: "removed-key", path: atKey(path, k), message: `"${k}" is ignored: ${removed[k]}` });
+    } else if (!known.has(k)) {
       out.push({ severity: "warning", code: "unknown-key", path: atKey(path, k), message: `"${k}" means nothing here; it is ignored` });
     }
   }
 }
-function settingsProblems(settings, out) {
-  const names = /* @__PURE__ */ new Set();
-  if (settings === void 0) return names;
-  if (!Array.isArray(settings)) {
-    out.push(err2("not-a-list", "settings", "settings are a list"));
-    return names;
-  }
-  settings.forEach((s, i) => {
-    const at = atIndex("settings", i);
-    if (!isObject(s)) {
-      out.push(err2("not-an-object", at, "a setting is an object"));
-      return;
-    }
-    const name = s["name"];
-    if (typeof name !== "string" || !NAME.test(name)) {
-      out.push(err2("setting-name", atKey(at, "name"), "a setting's name is an identifier"));
-    } else if (names.has(name)) {
-      out.push(err2("setting-duplicate", atKey(at, "name"), `setting "${name}" is declared twice`));
-    } else {
-      names.add(name);
-    }
-    const dflt = s.default;
-    if (typeof dflt !== "string" || !NAME.test(dflt)) {
-      out.push(err2("setting-default", atKey(at, "default"), "a setting names a host field by default, so its default is a field name"));
-    }
-  });
-  return names;
-}
-function targetProblems(host, kind, target, path, settings, out) {
+function targetProblems(host, target, path, out) {
   if (!isObject(target)) {
     out.push(err2("not-an-object", path, "a target is an object"));
     return;
   }
-  unknownKeys(target, /* @__PURE__ */ new Set(["fields", "claims"]), path, out);
+  unknownKeys(target, /* @__PURE__ */ new Set(["fields"]), path, out, REMOVED_TARGET_KEYS);
   const t = target;
   if (t.fields !== void 0) fieldListProblems(host, t.fields, atKey(path, "fields"), true, out);
-  if (t.claims === void 0) return;
-  if (!Array.isArray(t.claims)) {
-    out.push(err2("not-a-list", atKey(path, "claims"), "claims are a list"));
-    return;
-  }
-  const claimable = HOSTS[host].claimable.includes(kind);
-  const claimed = /* @__PURE__ */ new Set();
-  t.claims.forEach((c, i) => {
-    const at = atIndex(atKey(path, "claims"), i);
-    if (!claimable) {
-      out.push(err2("claim-kind", at, `a ${kind} has no host fields to claim; ${host} has them on ${HOSTS[host].claimable.join(", ")}`));
-      return;
-    }
-    if (!isObject(c)) {
-      out.push(err2("not-an-object", at, "a claim is an object"));
-      return;
-    }
-    const claim = c;
-    unknownKeys(c, CLAIM_KEYS, at, out);
-    if (!SCALAR_TYPES.includes(claim.type)) {
-      out.push(err2("claim-type", atKey(at, "type"), "a claim presents a host field, which is a scalar"));
-    } else {
-      typeProblems(host, claim, at, false, out, true);
-    }
-    if (typeof claim.setting !== "string" || !settings.has(claim.setting)) {
-      out.push(err2("claim-setting", atKey(at, "setting"), `a claim names its field through a setting, and "${String(claim.setting)}" is not one of the manifest's settings`));
-    } else if (claimed.has(claim.setting)) {
-      out.push(err2("claim-duplicate", atKey(at, "setting"), `setting "${claim.setting}" is claimed twice for one kind`));
-    } else {
-      claimed.add(claim.setting);
-    }
-  });
 }
 function fieldListProblems(host, fields, path, topLevel, out) {
   if (!Array.isArray(fields)) {
@@ -665,6 +659,9 @@ function fieldListProblems(host, fields, path, topLevel, out) {
     if (field.editorOnly !== void 0 && !topLevel) {
       out.push(err2("editor-only-nested", atKey(at, "editorOnly"), "only a target's own fields can be editor-only, not a record's"));
     }
+    if (field.editor !== void 0 && !topLevel) {
+      out.push(err2("editor-nested", atKey(at, "editor"), "only a target's own fields open in a view, not a record's"));
+    }
     for (const flag of ["required", "editorOnly"]) {
       if (field[flag] !== void 0 && typeof field[flag] !== "boolean") {
         out.push(err2("not-a-boolean", atKey(at, flag), `${flag} is true or false`));
@@ -672,7 +669,7 @@ function fieldListProblems(host, fields, path, topLevel, out) {
     }
   });
 }
-function typeProblems(host, decl, path, named, out, claim = false) {
+function typeProblems(host, decl, path, named, out) {
   const typeAt = atKey(path, "type");
   if (decl.type === "string") {
     out.push(err2("string-type", typeAt, 'the text type is spelled "text"'));
@@ -688,7 +685,6 @@ function typeProblems(host, decl, path, named, out, claim = false) {
     case "enum":
     case "flags": {
       const values = decl.values;
-      if (claim && values === void 0) break;
       if (!Array.isArray(values) || values.length === 0) {
         out.push(err2("values-empty", at("values"), `an ${decl.type === "enum" ? "enum" : "flags field"} lists its values`));
         sound = false;
@@ -707,7 +703,6 @@ function typeProblems(host, decl, path, named, out, claim = false) {
       break;
     }
     case "quality": {
-      if (claim && decl.stages === void 0) break;
       for (const p of expr.qualityDeclarationProblems(decl.stages)) {
         out.push(err2(
           `quality-${p.kind === "default-not-a-stage" ? "default" : p.kind}`,
@@ -770,11 +765,7 @@ function typeProblems(host, decl, path, named, out, claim = false) {
     }
   }
   if (decl.renamedStages !== void 0) renamedStagesProblems(decl, at("renamedStages"), out);
-  if (decl.valueHelp !== void 0 && claim) {
-    if (!isObject(decl.valueHelp) || !["enum", "flags", "quality"].includes(decl.type)) {
-      out.push(err2("value-help", at("valueHelp"), "value help describes the values of an enum or flags field, or a quality's stages"));
-    }
-  } else if (decl.valueHelp !== void 0) {
+  if (decl.valueHelp !== void 0) {
     const vocabulary = decl.type === "quality" ? decl.stages : decl.type === "enum" || decl.type === "flags" ? decl.values : decl.type === "pick" ? pickWords(decl.from) : void 0;
     if (vocabulary === void 0 || !isObject(decl.valueHelp)) {
       out.push(err2("value-help", at("valueHelp"), "value help describes the values of an enum or flags field, a quality's stages, or a pick's words"));
@@ -815,56 +806,10 @@ function renamedStagesProblems(decl, path, out) {
     }
   }
 }
-function settingValues(manifest, chosen) {
-  const out = {};
-  for (const s of manifest.settings ?? []) {
-    const v = chosen !== void 0 && own(chosen, s.name) ? chosen[s.name] : void 0;
-    out[s.name] = typeof v === "string" && v !== "" ? v : s.default;
-  }
-  return out;
-}
-function resolvedClaims(manifest, host, chosen) {
-  const settings = settingValues(manifest, chosen);
-  const out = [];
-  for (const [kind, target] of Object.entries(manifest.targets[host] ?? {})) {
-    for (const claim of target.claims ?? []) {
-      const field = settings[claim.setting];
-      if (field !== void 0) out.push({ extension: manifest.id, host, kind, field, claim });
-    }
-  }
-  return out;
-}
-function claimClashes(claims) {
-  const out = [];
-  const first = /* @__PURE__ */ new Map();
-  for (const c of claims) {
-    const key = `${c.host}\0${c.kind}\0${c.field}`;
-    const prior = first.get(key);
-    if (prior === void 0) {
-      first.set(key, c);
-      continue;
-    }
-    if (prior.extension === c.extension) continue;
-    out.push(err2(
-      "claim-clash",
-      `${c.kind}.${c.field}`,
-      `extensions "${prior.extension}" and "${c.extension}" both claim the ${c.kind} field "${c.field}"`
-    ));
-  }
-  return out;
-}
 function targetOf(manifest, host, kind) {
   const kinds = manifest?.targets[host];
   return kinds !== void 0 && own(kinds, kind) ? kinds[kind] : void 0;
 }
-function effectiveClaim(claim, hostDecl) {
-  return {
-    ...claim,
-    ...claim.values === void 0 && hostDecl.values !== void 0 ? { values: hostDecl.values } : {},
-    ...claim.stages === void 0 && hostDecl.stages !== void 0 ? { stages: hostDecl.stages } : {},
-    ...claim.default === void 0 && hostDecl.default !== void 0 ? { default: hostDecl.default } : {}
-  };
-}
 
 // src/extensions/merge.ts
 var ATOMIC = { kind: "atomic" };
@@ -1214,11 +1159,9 @@ exports.UNRESOLVED_KEY = UNRESOLVED_KEY;
 exports.VALUE_TYPES = VALUE_TYPES;
 exports.atIndex = atIndex;
 exports.atKey = atKey;
-exports.claimClashes = claimClashes;
 exports.compileEntry = compileEntry;
 exports.compiledTarget = compiledTarget;
 exports.defaultOf = defaultOf;
-exports.effectiveClaim = effectiveClaim;
 exports.entryProblems = entryProblems;
 exports.extensionDataStrategy = extensionDataStrategy;
 exports.isTextList = isTextList;
@@ -1230,6 +1173,7 @@ exports.markUnresolved = markUnresolved;
 exports.mergeComments = mergeComments;
 exports.mergeExtensionData = mergeExtensionData;
 exports.mergeTree = mergeTree;
+exports.missingRequirements = missingRequirements;
 exports.objectOf = objectOf;
 exports.orphanedEntries = orphanedEntries;
 exports.parseManifest = parseManifest;
@@ -1237,8 +1181,6 @@ exports.pickChoices = pickChoices;
 exports.pickClashes = pickClashes;
 exports.pickLists = pickLists;
 exports.renameStages = renameStages;
-exports.resolvedClaims = resolvedClaims;
-exports.settingValues = settingValues;
 exports.stableStringify = stableStringify;
 exports.strategyForTarget = strategyForTarget;
 exports.strategyForType = strategyForType;