@wildwinter/app-shell 0.48.0 → 0.49.0

package/dist/index.cjs

@@ -3120,6 +3120,85 @@ function mountLinkStatus(host, opts) {
   };
 }
 
+// src/value-control.ts
+function fallbackText(decl) {
+  const d = decl.default;
+  if (d !== void 0 && d !== null) {
+    if (typeof d === "boolean") return d ? "True" : "False";
+    if (Array.isArray(d)) return d.length === 0 ? "none" : d.join(", ");
+    return d === "" ? "none" : String(d);
+  }
+  switch (decl.type) {
+    case "boolean":
+      return "False";
+    case "number":
+      return "0";
+    case "enum":
+      return decl.values?.[0] ?? "none";
+    case "quality":
+      return decl.stages?.[0] ?? "first stage";
+    case "flags":
+      return "none";
+    default:
+      return "empty";
+  }
+}
+var defaultLabel = (decl) => `default (${fallbackText(decl)})`;
+function stageGateNote(gates) {
+  if (gates <= 0) return "";
+  return gates === 1 ? "1 gate compares against this ladder, and it now reads the new order." : `${gates} gates compare against this ladder, and each now reads the new order.`;
+}
+function rungStrip(opts) {
+  const make = opts.doc === void 0 ? el : (tag, props) => {
+    const node2 = opts.doc.createElement(tag);
+    node2.className = props.className;
+    if (props.text !== void 0) node2.textContent = props.text;
+    if (props.tip !== void 0) {
+      node2.title = props.tip;
+      node2.setAttribute("aria-label", props.tip);
+    }
+    if (props.onClick) node2.addEventListener("click", props.onClick);
+    if (tag === "button") node2.type = "button";
+    return node2;
+  };
+  const strip = make("span", { className: "seg shell-rungs" });
+  const decl = opts.decl ?? { type: "quality", stages: opts.stages };
+  const unset = opts.value === void 0;
+  const fallback = typeof decl.default === "string" && opts.stages.includes(decl.default) ? decl.default : opts.stages[0];
+  const readOnly = opts.onPick === void 0;
+  if (opts.onClear) {
+    strip.append(make("button", {
+      className: `seg-opt shell-rung shell-rung-default${unset ? " on" : ""}`,
+      text: defaultLabel(decl),
+      tip: unset ? "Not set here: the declared default holds" : "Clear the value, back to the default",
+      onClick: () => {
+        if (!unset) opts.onClear();
+      }
+    }));
+  }
+  for (const stage of opts.stages) {
+    const current3 = opts.value === stage;
+    const falls = unset && stage === fallback;
+    const rung = make(readOnly ? "span" : "button", {
+      className: `seg-opt shell-rung${current3 ? " on" : ""}${falls ? " fallback" : ""}`,
+      text: stage,
+      tip: current3 ? "The current stage" : falls ? "The stage it falls back to" : readOnly ? stage : opts.pickTip?.(stage) ?? `Set to "${stage}"`,
+      ...readOnly ? {} : { onClick: () => {
+        if (!current3) opts.onPick(stage);
+      } }
+    });
+    strip.append(rung);
+  }
+  if (!unset && !opts.stages.includes(opts.value)) {
+    strip.append(make("span", {
+      className: "seg-opt shell-rung stray on",
+      text: opts.value,
+      tip: `"${opts.value}" is not one of the stages: pick the one it belongs at now`
+    }));
+  }
+  return strip;
+}
+
 // src/property-list.ts
 var PROPERTY_TYPES = [
   ["number", "Number"],
@@ -3135,35 +3214,37 @@ var option = (value, label2, selected) => {
   o.selected = selected;
   return o;
 };
-var NONE = "(none)";
+var NONE_CHOSEN = "\0none";
 function defaultControl(p, onChange, opts = {}) {
   const typed = opts.typed === true;
   const write = (raw) => {
-    if (raw === "") {
-      if (typed) delete p.default;
-      else p.default = "";
-    } else if (typed && p.type === "boolean") p.default = raw === "true";
+    if (raw === "") delete p.default;
+    else if (raw === NONE_CHOSEN) p.default = "";
+    else if (typed && p.type === "boolean") p.default = raw === "true";
     else if (typed && p.type === "number") p.default = Number(raw);
     else p.default = raw;
     onChange?.();
   };
   const current3 = p.default === void 0 || p.default === null ? "" : String(p.default);
+  const unsetLabel = opts.unsetLabel ?? defaultLabel({ ...p, default: void 0 });
   if (p.type === "boolean") {
     const sel = el("select", "field set-default");
-    sel.append(option("", NONE, current3 === ""), option("true", "True", current3 === "true"), option("false", "False", current3 === "false"));
+    sel.append(option("", unsetLabel, current3 === ""), option("true", "True", current3 === "true"), option("false", "False", current3 === "false"));
     sel.addEventListener("change", () => write(sel.value));
     return sel;
   }
   if (p.type === "enum") {
     const sel = el("select", "field set-default");
-    sel.append(option("", NONE, current3 === ""));
+    const none = opts.noneChosen === true && p.default === "";
+    sel.append(option("", unsetLabel, current3 === "" && !none));
+    if (opts.noneChosen) sel.append(option(NONE_CHOSEN, "(none)", none));
     for (const v of p.values ?? []) sel.append(option(v, v, current3 === v));
     sel.addEventListener("change", () => write(sel.value));
     return sel;
   }
   if (p.type === "quality") {
     const sel = el("select", "field set-default");
-    sel.append(option("", "(first stage)", current3 === ""));
+    sel.append(option("", unsetLabel, current3 === ""));
     for (const v of p.stages ?? []) sel.append(option(v, v, current3 === v));
     sel.addEventListener("change", () => write(sel.value));
     return sel;
@@ -3175,7 +3256,7 @@ function defaultControl(p, onChange, opts = {}) {
   }
   const input = el("input", "field set-default");
   input.type = p.type === "number" ? "number" : "text";
-  input.placeholder = "Default";
+  input.placeholder = p.type === "number" ? `Default (${fallbackText({ type: "number" })})` : "Default";
   input.value = current3;
   input.addEventListener("input", () => write(input.value));
   return input;
@@ -3202,8 +3283,7 @@ function mountPropertyList(host, decls, opts = {}) {
     for (const [v, label2] of types) type.append(option(v, label2, v === p.type));
     type.addEventListener("change", () => {
       p.type = type.value;
-      if (opts.typed) delete p.default;
-      else p.default = "";
+      delete p.default;
       if (p.type === "enum" || p.type === "flags") p.values ??= [];
       else delete p.values;
       if (p.type === "quality") p.stages ??= [];
@@ -3390,6 +3470,7 @@ exports.createNavHistory = createNavHistory;
 exports.createSaveController = createSaveController;
 exports.debounce = debounce;
 exports.defaultControl = defaultControl;
+exports.defaultLabel = defaultLabel;
 exports.defaultProblemCopy = defaultProblemCopy;
 exports.describeProblem = describeProblem;
 exports.dialogFrame = dialogFrame;
@@ -3397,6 +3478,7 @@ exports.dismissToast = dismissToast;
 exports.dupGuard = dupGuard;
 exports.el = el;
 exports.expandableRow = expandableRow;
+exports.fallbackText = fallbackText;
 exports.feedUpdaterDownloadProgress = feedUpdaterDownloadProgress;
 exports.firstIllegalPropertyName = firstIllegalPropertyName;
 exports.focusNewRow = focusNewRow;
@@ -3462,11 +3544,13 @@ exports.renderStepperBar = renderStepperBar;
 exports.revalidatePropertyRefs = revalidatePropertyRefs;
 exports.revealRow = revealRow;
 exports.revealRowWhenReady = revealRowWhenReady;
+exports.rungStrip = rungStrip;
 exports.saveIndicator = saveIndicator;
 exports.setKeyPlatform = setKeyPlatform;
 exports.showAbout = showAbout;
 exports.showUpdaterDialog = showUpdaterDialog;
 exports.stageChips = stageChips;
+exports.stageGateNote = stageGateNote;
 exports.staleBar = staleBar;
 exports.tagChips = tagChips;
 exports.tipAt = tipAt;