@wildwinter/app-shell 0.39.0 → 0.40.1

package/dist/problems.cjs

@@ -0,0 +1,61 @@
+'use strict';
+
+// src/problems.ts
+function problemName(p, dangling = false) {
+  if (p.title) return `\u201C${p.title}\u201D`;
+  if (dangling && p.where) return `(id ${p.where})`;
+  return "This";
+}
+function describeProblem(problem, table = {}) {
+  const entry = problem.code ? table[problem.code] : void 0;
+  if (entry) {
+    const copy = entry(problem);
+    const text = copy.dangling && !problem.title && problem.where && !copy.text.includes(`(id ${problem.where})`) ? `${copy.text} (id ${problem.where})` : copy.text;
+    return copy.next ? { text, next: copy.next } : { text };
+  }
+  const message = problem.message.replace(/\s*\[[^\]]*\]\s*$/, "").trim();
+  return { text: problem.title ? `${problem.title}: ${message}` : message };
+}
+function problemLine(problem, table) {
+  const { text, next } = describeProblem(problem, table);
+  return next ? `${text} ${next}` : text;
+}
+var defaultProblemCopy = {
+  "duplicate-gameid": (p) => ({
+    text: `The Game ID on ${problemName(p)} is already used elsewhere.`,
+    next: "Each one must be unique; change one of them."
+  }),
+  "invalid-gameid": (p) => ({
+    text: `The Game ID on ${problemName(p)} isn't valid.`,
+    next: "Use lowercase letters, digits and hyphens."
+  }),
+  "dangling-reference": (p) => ({
+    text: `${problemName(p, true)} points at something that no longer exists.`,
+    next: "Choose where it goes.",
+    dangling: true
+  }),
+  "unknown-property": (p) => ({
+    text: `${problemName(p)} uses a property that isn't set up yet.`,
+    next: "Declare it in the project settings, or fix the name."
+  }),
+  "missing-name": (p) => ({ text: `${problemName(p)} needs a name.` }),
+  "empty": (p) => ({
+    text: `${problemName(p)} is empty.`,
+    next: "Add something inside it, or remove it."
+  }),
+  "stale-build": (p) => ({
+    text: `Your playable build${p.path ? ` (${p.path})` : ""} is out of date.`,
+    next: "It refreshes the next time you publish."
+  }),
+  "merge-conflict": (p) => ({
+    text: `${p.path ?? "This file"} still has an unresolved merge conflict in it.`,
+    next: "Resolve it in your version control tool, then reopen the project."
+  })
+};
+
+exports.defaultProblemCopy = defaultProblemCopy;
+exports.describeProblem = describeProblem;
+exports.problemLine = problemLine;
+exports.problemName = problemName;
+//# sourceMappingURL=problems.cjs.map
+//# sourceMappingURL=problems.cjs.map

package/dist/problems.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/problems.ts"],"names":[],"mappings":"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","file":"problems.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// Problem copy: a validator's diagnostic rewritten for the person at the\n// keyboard, through a table the app fills.\n//\n// Patterpad's `humanizeProblem` (its renderer.ts) proved the shape: a dozen\n// validator categories each mapped to a plain sentence with a next step, naming\n// things by their title, and a fallback that softens the technical residue.\n// Storyletter showed the raw compiler string and labelled it `path [where]`\n// (ui-review-2026-09, finding 17), the bracketed id that \"Diagnostics name what\n// the author can see\" (design-language.md) rules out for anything but a\n// DANGLING reference. This module is the translator; the tables are the\n// apps', because the codes are theirs. `defaultProblemCopy` covers the handful\n// of codes both validators raise in some form, as a floor an app spreads into\n// its own table.\n// ---------------------------------------------------------------------------\n\n/** What a translator needs to know about a problem. `code` is the app's own\n *  category (Patterpad's `detail`, or a code Storyletter derives from its\n *  compiler message); `title` is the author-facing name of the thing the\n *  problem is about, when the app can resolve one; `where` is the raw\n *  reference (an id) for when it cannot. */\nexport interface ProblemLike {\n  code?: string;\n  message: string;\n  path?: string;\n  where?: string;\n  title?: string;\n}\n\nexport interface ProblemCopy {\n  /** The sentence: what is wrong, in the author's words. */\n  text: string;\n  /** What to do about it, when there is one thing to do. */\n  next?: string;\n  /** The reference this problem is about no longer has a name to give, so the\n   *  raw id may be shown, written `(id ...)` so it cannot be mistaken for a\n   *  name. Set by the table entry; the translator never guesses it. */\n  dangling?: boolean;\n}\n\nexport type ProblemCopyEntry = (problem: ProblemLike) => ProblemCopy;\nexport type ProblemCopyTable = Record<string, ProblemCopyEntry>;\n\n/** The name to call the thing a problem is about: its title in curly quotes,\n *  \"(id ...)\" only when the reference dangles and there is nothing else,\n *  and \"This\" otherwise, because the bar's \"go to\" shows the reader what\n *  \"this\" is and an id is not something they can look for. */\nexport function problemName(p: ProblemLike, dangling = false): string {\n  if (p.title) return `“${p.title}”`;\n  if (dangling && p.where) return `(id ${p.where})`;\n  return \"This\";\n}\n\n/**\n * Translate `problem` through `table`. A matching entry decides the copy; with\n * no entry the raw message is kept and prefixed by the title when there is one\n * (\"Burner Rig: duplicate id\"). Nothing here ever writes `[where]`; an id\n * appears only as `(id ...)`, only when the entry says the reference dangles,\n * and only when there is no title to say instead.\n */\nexport function describeProblem(problem: ProblemLike, table: ProblemCopyTable = {}): ProblemCopy {\n  const entry = problem.code ? table[problem.code] : undefined;\n  if (entry) {\n    const copy = entry(problem);\n    const text = copy.dangling && !problem.title && problem.where && !copy.text.includes(`(id ${problem.where})`)\n      ? `${copy.text} (id ${problem.where})`\n      : copy.text;\n    return copy.next ? { text, next: copy.next } : { text };\n  }\n  const message = problem.message.replace(/\\s*\\[[^\\]]*\\]\\s*$/, \"\").trim();\n  return { text: problem.title ? `${problem.title}: ${message}` : message };\n}\n\n/** `describeProblem` as one line for a bar that has room for one: the sentence,\n *  then the next step after a space. */\nexport function problemLine(problem: ProblemLike, table?: ProblemCopyTable): string {\n  const { text, next } = describeProblem(problem, table);\n  return next ? `${text} ${next}` : text;\n}\n\n/**\n * The codes both validators raise in some form, in the family's voice. An app\n * spreads this into its own table and adds its own codes over it; a code an\n * app does not raise costs nothing.\n *\n *   duplicate-gameid    two things share one Game ID\n *   invalid-gameid      a Game ID that breaks the address rule\n *   dangling-reference  a jump / tag / property points at something gone\n *   unknown-property    a condition or effect names an undeclared property\n *   missing-name        a thing that needs a name has none\n *   empty               a container with nothing in it\n *   stale-build         the playable build is older than the source\n *   merge-conflict      a file still carries conflict markers\n */\nexport const defaultProblemCopy: ProblemCopyTable = {\n  \"duplicate-gameid\": (p) => ({\n    text: `The Game ID on ${problemName(p)} is already used elsewhere.`,\n    next: \"Each one must be unique; change one of them.\",\n  }),\n  \"invalid-gameid\": (p) => ({\n    text: `The Game ID on ${problemName(p)} isn't valid.`,\n    next: \"Use lowercase letters, digits and hyphens.\",\n  }),\n  \"dangling-reference\": (p) => ({\n    text: `${problemName(p, true)} points at something that no longer exists.`,\n    next: \"Choose where it goes.\",\n    dangling: true,\n  }),\n  \"unknown-property\": (p) => ({\n    text: `${problemName(p)} uses a property that isn't set up yet.`,\n    next: \"Declare it in the project settings, or fix the name.\",\n  }),\n  \"missing-name\": (p) => ({ text: `${problemName(p)} needs a name.` }),\n  \"empty\": (p) => ({\n    text: `${problemName(p)} is empty.`,\n    next: \"Add something inside it, or remove it.\",\n  }),\n  \"stale-build\": (p) => ({\n    text: `Your playable build${p.path ? ` (${p.path})` : \"\"} is out of date.`,\n    next: \"It refreshes the next time you publish.\",\n  }),\n  \"merge-conflict\": (p) => ({\n    text: `${p.path ?? \"This file\"} still has an unresolved merge conflict in it.`,\n    next: \"Resolve it in your version control tool, then reopen the project.\",\n  }),\n};\n"]}

package/dist/problems.d.cts

@@ -0,0 +1,57 @@
+/** What a translator needs to know about a problem. `code` is the app's own
+ *  category (Patterpad's `detail`, or a code Storyletter derives from its
+ *  compiler message); `title` is the author-facing name of the thing the
+ *  problem is about, when the app can resolve one; `where` is the raw
+ *  reference (an id) for when it cannot. */
+interface ProblemLike {
+    code?: string;
+    message: string;
+    path?: string;
+    where?: string;
+    title?: string;
+}
+interface ProblemCopy {
+    /** The sentence: what is wrong, in the author's words. */
+    text: string;
+    /** What to do about it, when there is one thing to do. */
+    next?: string;
+    /** The reference this problem is about no longer has a name to give, so the
+     *  raw id may be shown, written `(id ...)` so it cannot be mistaken for a
+     *  name. Set by the table entry; the translator never guesses it. */
+    dangling?: boolean;
+}
+type ProblemCopyEntry = (problem: ProblemLike) => ProblemCopy;
+type ProblemCopyTable = Record<string, ProblemCopyEntry>;
+/** The name to call the thing a problem is about: its title in curly quotes,
+ *  "(id ...)" only when the reference dangles and there is nothing else,
+ *  and "This" otherwise, because the bar's "go to" shows the reader what
+ *  "this" is and an id is not something they can look for. */
+declare function problemName(p: ProblemLike, dangling?: boolean): string;
+/**
+ * Translate `problem` through `table`. A matching entry decides the copy; with
+ * no entry the raw message is kept and prefixed by the title when there is one
+ * ("Burner Rig: duplicate id"). Nothing here ever writes `[where]`; an id
+ * appears only as `(id ...)`, only when the entry says the reference dangles,
+ * and only when there is no title to say instead.
+ */
+declare function describeProblem(problem: ProblemLike, table?: ProblemCopyTable): ProblemCopy;
+/** `describeProblem` as one line for a bar that has room for one: the sentence,
+ *  then the next step after a space. */
+declare function problemLine(problem: ProblemLike, table?: ProblemCopyTable): string;
+/**
+ * The codes both validators raise in some form, in the family's voice. An app
+ * spreads this into its own table and adds its own codes over it; a code an
+ * app does not raise costs nothing.
+ *
+ *   duplicate-gameid    two things share one Game ID
+ *   invalid-gameid      a Game ID that breaks the address rule
+ *   dangling-reference  a jump / tag / property points at something gone
+ *   unknown-property    a condition or effect names an undeclared property
+ *   missing-name        a thing that needs a name has none
+ *   empty               a container with nothing in it
+ *   stale-build         the playable build is older than the source
+ *   merge-conflict      a file still carries conflict markers
+ */
+declare const defaultProblemCopy: ProblemCopyTable;
+
+export { type ProblemCopy, type ProblemCopyEntry, type ProblemCopyTable, type ProblemLike, defaultProblemCopy, describeProblem, problemLine, problemName };

package/dist/problems.d.ts

@@ -0,0 +1,57 @@
+/** What a translator needs to know about a problem. `code` is the app's own
+ *  category (Patterpad's `detail`, or a code Storyletter derives from its
+ *  compiler message); `title` is the author-facing name of the thing the
+ *  problem is about, when the app can resolve one; `where` is the raw
+ *  reference (an id) for when it cannot. */
+interface ProblemLike {
+    code?: string;
+    message: string;
+    path?: string;
+    where?: string;
+    title?: string;
+}
+interface ProblemCopy {
+    /** The sentence: what is wrong, in the author's words. */
+    text: string;
+    /** What to do about it, when there is one thing to do. */
+    next?: string;
+    /** The reference this problem is about no longer has a name to give, so the
+     *  raw id may be shown, written `(id ...)` so it cannot be mistaken for a
+     *  name. Set by the table entry; the translator never guesses it. */
+    dangling?: boolean;
+}
+type ProblemCopyEntry = (problem: ProblemLike) => ProblemCopy;
+type ProblemCopyTable = Record<string, ProblemCopyEntry>;
+/** The name to call the thing a problem is about: its title in curly quotes,
+ *  "(id ...)" only when the reference dangles and there is nothing else,
+ *  and "This" otherwise, because the bar's "go to" shows the reader what
+ *  "this" is and an id is not something they can look for. */
+declare function problemName(p: ProblemLike, dangling?: boolean): string;
+/**
+ * Translate `problem` through `table`. A matching entry decides the copy; with
+ * no entry the raw message is kept and prefixed by the title when there is one
+ * ("Burner Rig: duplicate id"). Nothing here ever writes `[where]`; an id
+ * appears only as `(id ...)`, only when the entry says the reference dangles,
+ * and only when there is no title to say instead.
+ */
+declare function describeProblem(problem: ProblemLike, table?: ProblemCopyTable): ProblemCopy;
+/** `describeProblem` as one line for a bar that has room for one: the sentence,
+ *  then the next step after a space. */
+declare function problemLine(problem: ProblemLike, table?: ProblemCopyTable): string;
+/**
+ * The codes both validators raise in some form, in the family's voice. An app
+ * spreads this into its own table and adds its own codes over it; a code an
+ * app does not raise costs nothing.
+ *
+ *   duplicate-gameid    two things share one Game ID
+ *   invalid-gameid      a Game ID that breaks the address rule
+ *   dangling-reference  a jump / tag / property points at something gone
+ *   unknown-property    a condition or effect names an undeclared property
+ *   missing-name        a thing that needs a name has none
+ *   empty               a container with nothing in it
+ *   stale-build         the playable build is older than the source
+ *   merge-conflict      a file still carries conflict markers
+ */
+declare const defaultProblemCopy: ProblemCopyTable;
+
+export { type ProblemCopy, type ProblemCopyEntry, type ProblemCopyTable, type ProblemLike, defaultProblemCopy, describeProblem, problemLine, problemName };

package/dist/problems.js

@@ -0,0 +1,3 @@
+export { defaultProblemCopy, describeProblem, problemLine, problemName } from './chunk-4OAORWEM.js';
+//# sourceMappingURL=problems.js.map
+//# sourceMappingURL=problems.js.map

package/dist/problems.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"problems.js"}