@wildwinter/app-shell 0.50.0 → 0.52.0

package/dist/property-list.js

@@ -1,5 +1,5 @@
-export { PROPERTY_TYPES, defaultControl, mountPropertyList } from './chunk-TETY2BTN.js';
-import './chunk-JOFRUWTP.js';
+export { PROPERTY_TYPES, defaultControl, mountPropertyList } from './chunk-NGLZUDOT.js';
+import './chunk-4QDD6GF3.js';
 import './chunk-W4WC4FO5.js';
 //# sourceMappingURL=property-list.js.map
 //# sourceMappingURL=property-list.js.map

package/dist/value-control.cjs

@@ -452,6 +452,23 @@ function rungStrip(opts) {
   }
   return strip;
 }
+function valueHelpText(decl, value) {
+  const help = decl.valueHelp;
+  if (help === void 0) return "";
+  const said = (v) => Object.prototype.hasOwnProperty.call(help, v) ? help[v] : void 0;
+  if (decl.type === "enum" || decl.type === "quality") {
+    const held = typeof value === "string" && value !== "" ? value : typeof decl.default === "string" && decl.default !== "" ? decl.default : decl.type === "enum" ? decl.values?.[0] : decl.stages?.[0];
+    return held === void 0 ? "" : said(held) ?? "";
+  }
+  if (decl.type === "flags") {
+    const held = Array.isArray(value) ? value.map(String) : Array.isArray(decl.default) ? decl.default.map(String) : [];
+    return held.flatMap((v) => {
+      const h = said(v);
+      return h === void 0 ? [] : [`${v}: ${h}`];
+    }).join("\n");
+  }
+  return "";
+}
 var fallbackFlags = (decl) => Array.isArray(decl.default) ? decl.default.filter((v) => typeof v === "string") : [];
 function fieldValueProblem(decl, value) {
   if (value === void 0 || value === null || value === "") return "";
@@ -492,6 +509,7 @@ function fieldRow(initial) {
   caption.id = `shell-fr-${Math.random().toString(36).slice(2, 9)}`;
   const body = el("div", "shell-fieldrow-body");
   const purpose = el("p", "shell-fieldrow-purpose");
+  const valueHelp = el("p", "shell-fieldrow-purpose shell-fieldrow-valuehelp");
   const problem = el("p", "shell-fieldrow-problem");
   problem.setAttribute("role", "status");
   row.append(caption, body);
@@ -512,6 +530,9 @@ function fieldRow(initial) {
   purpose.id = `${caption.id}-p`;
   problem.id = `${caption.id}-m`;
   const sayProblem = () => {
+    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 !== "");
     problem.textContent = words.join(" ");
     problem.hidden = words.length === 0;
@@ -701,7 +722,7 @@ function fieldRow(initial) {
     purpose.textContent = decl.purpose ?? "";
     if (decl.purpose) body.append(purpose);
     else purpose.remove();
-    body.append(problem);
+    body.append(valueHelp, problem);
     sayProblem();
   };
   draw(initial);
@@ -775,6 +796,10 @@ var keeper = /* @__PURE__ */ (() => {
     holds: (row) => memos.has(row)
   };
 })();
+var fieldRowFocus = {
+  settle: (row) => keeper.settle(row),
+  restore: (row) => keeper.restore(row)
+};
 function fieldRows() {
   const rows = /* @__PURE__ */ new Map();
   return {
@@ -803,9 +828,11 @@ function fieldRows() {
 exports.defaultLabel = defaultLabel;
 exports.fallbackText = fallbackText;
 exports.fieldRow = fieldRow;
+exports.fieldRowFocus = fieldRowFocus;
 exports.fieldRows = fieldRows;
 exports.fieldValueProblem = fieldValueProblem;
 exports.rungStrip = rungStrip;
 exports.stageGateNote = stageGateNote;
+exports.valueHelpText = valueHelpText;
 //# sourceMappingURL=value-control.cjs.map
 //# sourceMappingURL=value-control.cjs.map