@wildwinter/app-shell 0.52.0 → 0.54.0

package/dist/value-control.d.cts

@@ -74,6 +74,9 @@ interface FieldRowOptions {
     disabled?: boolean;
     /** A message of the app's own about this value (a check the row cannot make), shown under the control. */
     problem?: string;
+    /** The app's own sentence INSTEAD of the row's (a renamed stage said better than "not one of the stages").
+     *  Given, it is the whole message; `problem` is ignored. */
+    replaceProblem?: string;
     /** The caption; default the field's name. */
     label?: string | Node;
     /** Added to the row and its caption, so a row sits in its app's layout. */

package/dist/value-control.d.ts

@@ -74,6 +74,9 @@ interface FieldRowOptions {
     disabled?: boolean;
     /** A message of the app's own about this value (a check the row cannot make), shown under the control. */
     problem?: string;
+    /** The app's own sentence INSTEAD of the row's (a renamed stage said better than "not one of the stages").
+     *  Given, it is the whole message; `problem` is ignored. */
+    replaceProblem?: string;
     /** The caption; default the field's name. */
     label?: string | Node;
     /** Added to the row and its caption, so a row sits in its app's layout. */

package/dist/value-control.js

@@ -1,4 +1,4 @@
-export { defaultLabel, fallbackText, fieldRow, fieldRowFocus, fieldRows, fieldValueProblem, rungStrip, stageGateNote, valueHelpText } from './chunk-4QDD6GF3.js';
+export { defaultLabel, fallbackText, fieldRow, fieldRowFocus, fieldRows, fieldValueProblem, rungStrip, stageGateNote, valueHelpText } from './chunk-XJM733E6.js';
 import './chunk-W4WC4FO5.js';
 //# sourceMappingURL=value-control.js.map
 //# sourceMappingURL=value-control.js.map

package/dist/value-rows.cjs

@@ -559,7 +559,7 @@ function fieldRow(initial) {
     const help = valueHelpText(opts.decl, opts.value);
     valueHelp.textContent = help;
     valueHelp.hidden = help === "";
-    const words = [typing || fieldValueProblem(opts.decl, opts.value), opts.problem ?? ""].filter((w) => w !== "");
+    const words = opts.replaceProblem !== void 0 ? [opts.replaceProblem].filter((w) => w !== "") : [typing || fieldValueProblem(opts.decl, opts.value), opts.problem ?? ""].filter((w) => w !== "");
     problem.textContent = words.join(" ");
     problem.hidden = words.length === 0;
     row.classList.toggle("has-problem", words.length > 0);
@@ -837,13 +837,20 @@ var nameOf = (decl) => decl.label ?? decl.name;
 var asDecl = (d, name) => ({ ...d, name: d.name ?? name });
 function ownProblems(decl, value, adapter) {
   if (value === void 0) return "";
-  const exists = adapter ? (kind, id) => nodeLabel(adapter, kind, id) !== void 0 : void 0;
-  return extensions.valueProblems(decl, value, exists ? { exists } : {}).filter((p) => p.path === "" && p.severity === "error" && p.code !== "not-a-value" && p.code !== "not-a-stage").map((p) => `${p.message.replace(/^the value/, "The value")}.`).join(" ");
+  return extensions.valueProblems(decl, value, contextOf(adapter)).filter((p) => p.path === "" && (p.severity === "error" || p.code === "pick-ambiguous") && p.code !== "not-a-value" && p.code !== "not-a-stage").map((p) => `${p.message.replace(/^the value/, "The value")}.`).join(" ");
+}
+function contextOf(adapter) {
+  if (!adapter) return {};
+  return {
+    exists: (kind, id) => nodeLabel(adapter, kind, id) !== void 0,
+    ...adapter.list ? { list: (name) => adapter.list(name) } : {}
+  };
 }
 function valueRow(initial) {
   const decl = initial.decl;
   if (SCALARS.has(decl.type)) return scalarRow(initial);
   if (decl.type === "reference") return referenceRow(initial);
+  if (decl.type === "pick") return pickRow(initial);
   return structuredRow(initial);
 }
 function scalarRow(initial) {
@@ -856,6 +863,7 @@ function scalarRow(initial) {
       ...o.onCommit ? { onCommit: (v) => o.onCommit(v) } : {},
       ...o.disabled !== void 0 ? { disabled: o.disabled } : {},
       ...problem !== "" ? { problem } : {},
+      ...o.replaceProblem !== void 0 ? { replaceProblem: o.replaceProblem } : {},
       label: o.label ?? nameOf(o.decl),
       ...o.className !== void 0 ? { className: o.className } : {},
       ...o.labelClassName !== void 0 ? { labelClassName: o.labelClassName } : {},
@@ -914,7 +922,87 @@ function referenceRow(initial) {
     sel.disabled = o.onCommit === void 0 || o.disabled === true;
     help.textContent = o.decl.help ?? o.decl.purpose ?? "";
     help.hidden = help.textContent === "";
-    const words = [ownProblems(o.decl, o.value, o.adapter), o.problem ?? ""].filter((w) => w !== "").join(" ");
+    const words = o.replaceProblem ?? [ownProblems(o.decl, o.value, o.adapter), o.problem ?? ""].filter((w) => w !== "").join(" ");
+    problem.textContent = words;
+    problem.hidden = words === "";
+    row.classList.toggle("has-problem", words !== "");
+  };
+  draw(initial);
+  return { el: row, update: draw };
+}
+function pickRow(initial) {
+  let opts = initial;
+  if (!opts.adapter && (opts.decl.from ?? []).some((s) => !("words" in s))) {
+    const inner = scalarRow({ ...opts, decl: { ...opts.decl, type: "text" } });
+    return { el: inner.el, update: (o) => {
+      opts = o;
+      inner.update({ ...o, decl: { ...o.decl, type: "text" } });
+    } };
+  }
+  const row = el("div", "shell-fieldrow shell-valuerow-pick");
+  const caption = el("span", "shell-fieldrow-label");
+  const body = el("div", "shell-fieldrow-body");
+  const sel = el("select", "field shell-fieldrow-select");
+  const help = el("p", "shell-fieldrow-purpose");
+  const problem = el("p", "shell-fieldrow-problem");
+  problem.setAttribute("role", "status");
+  body.append(sel, help, problem);
+  row.append(caption, body);
+  sel.addEventListener("change", () => {
+    const v = sel.value === "" ? void 0 : sel.value;
+    opts = { ...opts, value: v };
+    draw(opts);
+    opts.onCommit?.(v);
+  });
+  const groupName = (s) => "to" in s ? s.to === "cast" ? "Cast" : s.to.charAt(0).toUpperCase() + s.to.slice(1) : "list" in s ? s.list : void 0;
+  const draw = (o) => {
+    opts = o;
+    row.className = `shell-fieldrow shell-valuerow-pick${o.className ? ` ${o.className}` : ""}`;
+    const label = o.label ?? nameOf(o.decl);
+    if (typeof label === "string") caption.textContent = label;
+    else caption.replaceChildren(label);
+    if (o.controlClassName) sel.className = `shell-fieldrow-select ${o.controlClassName}`;
+    const adapter = o.adapter;
+    const choices = extensions.pickChoices(o.decl, {
+      ...adapter ? { nodes: (kind) => adapter.nodes(kind) } : {},
+      ...adapter?.list ? { list: (name) => adapter.list(name) } : {}
+    });
+    const held = typeof o.value === "string" ? o.value : "";
+    sel.replaceChildren();
+    const option = (v, text) => {
+      const opt = el("option", void 0, text);
+      opt.value = v;
+      return opt;
+    };
+    sel.append(option("", "auto"));
+    const offered = /* @__PURE__ */ new Set();
+    let group;
+    for (const c of choices) {
+      if (offered.has(c.value)) continue;
+      offered.add(c.value);
+      const name = groupName(c.source);
+      if (name === void 0) {
+        group = void 0;
+        sel.append(option(c.value, c.label));
+        continue;
+      }
+      if (group?.source !== c.source) {
+        const og = el("optgroup");
+        og.setAttribute("label", name);
+        sel.append(og);
+        group = { source: c.source, el: og };
+      }
+      group.el.append(option(c.value, c.label));
+    }
+    if (held !== "" && !offered.has(held)) {
+      const named = (o.decl.from ?? []).map((s) => "to" in s && adapter ? adapter.label?.(s.to, held) : void 0).find((n) => n !== void 0);
+      sel.append(option(held, named ?? `${held} (missing)`));
+    }
+    sel.value = held;
+    sel.disabled = o.onCommit === void 0 || o.disabled === true;
+    help.textContent = o.decl.help ?? o.decl.purpose ?? "";
+    help.hidden = help.textContent === "";
+    const words = o.replaceProblem ?? [ownProblems(o.decl, o.value, o.adapter), o.problem ?? ""].filter((w) => w !== "").join(" ");
     problem.textContent = words;
     problem.hidden = words === "";
     row.classList.toggle("has-problem", words !== "");
@@ -1091,7 +1179,7 @@ function structuredRow(initial) {
     if (decl.type !== "record" && editable()) body.append(adder);
     help.textContent = decl.help ?? decl.purpose ?? "";
     if (help.textContent !== "") body.append(help);
-    const words = [ownProblems(decl, o.value, o.adapter), o.problem ?? ""].filter((w) => w !== "").join(" ");
+    const words = o.replaceProblem ?? [ownProblems(decl, o.value, o.adapter), o.problem ?? ""].filter((w) => w !== "").join(" ");
     problem.textContent = words;
     problem.hidden = words === "";
     body.append(problem);