@wildwinter/app-shell 0.49.0 → 0.51.0

package/dist/property-list.d.cts

@@ -1 +1 @@
-export { D as DefaultControlOptions, P as PROPERTY_TYPES, b as PropertyDeclLike, c as PropertyListHandle, d as PropertyListOptions, e as PropertyListType, i as defaultControl, m as mountPropertyList } from './property-list-BPGU3rhF.cjs';
+export { D as DefaultControlOptions, P as PROPERTY_TYPES, b as PropertyDeclLike, c as PropertyListHandle, d as PropertyListOptions, e as PropertyListType, i as defaultControl, m as mountPropertyList } from './property-list-DlpxIkv6.cjs';

package/dist/property-list.d.ts

@@ -1 +1 @@
-export { D as DefaultControlOptions, P as PROPERTY_TYPES, b as PropertyDeclLike, c as PropertyListHandle, d as PropertyListOptions, e as PropertyListType, i as defaultControl, m as mountPropertyList } from './property-list-BPGU3rhF.js';
+export { D as DefaultControlOptions, P as PROPERTY_TYPES, b as PropertyDeclLike, c as PropertyListHandle, d as PropertyListOptions, e as PropertyListType, i as defaultControl, m as mountPropertyList } from './property-list-DlpxIkv6.js';

package/dist/property-list.js

@@ -1,5 +1,5 @@
-export { PROPERTY_TYPES, defaultControl, mountPropertyList } from './chunk-FGAPO4N5.js';
-import './chunk-EAE7UWQ5.js';
+export { PROPERTY_TYPES, defaultControl, mountPropertyList } from './chunk-B56FWJ5Y.js';
+import './chunk-ELEDQRZ7.js';
 import './chunk-W4WC4FO5.js';
 //# sourceMappingURL=property-list.js.map
 //# sourceMappingURL=property-list.js.map

package/dist/value-control.cjs

@@ -124,6 +124,194 @@ function initTooltips(opts = {}) {
   window.addEventListener("blur", () => hide());
 }
 
+// src/icons.ts
+var icon = {
+  // --- dismissing and revealing ---------------------------------------------
+  /** Close a panel, a dialog, a popover. Patterpad's, twelve times over. */
+  close: "\u2715",
+  /** The overflow menu on a document or a row: "more about this". */
+  more: "\u22EF",
+  /** Collapsed disclosure, pointing at what would open. */
+  collapsed: "\u25B8",
+  /** Expanded disclosure. */
+  expanded: "\u25BE",
+  /** A dropdown's affordance, where it is not a real <select>. */
+  dropdown: "\u25BE",
+  // --- moving through things ------------------------------------------------
+  /** Back / previous, in a breadcrumb or a stepper. */
+  back: "\u2039",
+  /** Forward / next. */
+  forward: "\u203A",
+  /** Up one, in a list. */
+  up: "\u2191",
+  /** Down one. */
+  down: "\u2193",
+  // --- state ----------------------------------------------------------------
+  /** Done, applied, agreed. */
+  tick: "\u2713",
+  /** Somebody else holds this: the version-control lock. */
+  locked: "\u2298",
+  /** Read-only on disk with no other holder: the resting state of everything
+   *  in a lock-based working copy that nobody has checked out yet. */
+  readOnly: "\u25CB",
+  /** YOU hold this one: checked out / opened by the current user, still yours to
+   *  edit. Shares its glyph with `note`, which the table permits: an entry is a
+   *  MEANING, and two meanings may draw the same shape. */
+  checkedOut: "\u270E",
+  /** Tracked, with local changes not yet committed. */
+  modified: "\u25CF",
+  /** Not in version control yet: new since the last commit. */
+  untracked: "+",
+  /** Something needs attention but is not fatal. */
+  warning: "\u203C",
+  /** A live thing: the running position, an active marker. */
+  dot: "\u25CF",
+  /** Play, in the sense of "run this". */
+  play: "\u25B6",
+  /** Start the thing again from the top: a play session, a sweep. Named for the
+   *  act, not the arrow, which is the table's rule. */
+  restart: "\u27F2",
+  /** The three ways a collection can be shown. Named by what you get rather than
+   *  by the glyph, so a second app can pick the same three without copying
+   *  somebody's taste in symbols. */
+  viewCards: "\u25A6",
+  viewTable: "\u2630",
+  viewNode: "\u25C8",
+  // --- handling -------------------------------------------------------------
+  /** The drag grip on a reorderable row. */
+  grip: "\u283F",
+  /** Add one of whatever this list holds. */
+  add: "+",
+  // --- annotation -----------------------------------------------------------
+  /** Documentation notes: the pencil. Both apps had chosen it independently,
+   *  which is the happiest way for a vocabulary entry to arrive. */
+  note: "\u270E",
+  /** A comment thread. Speech, not a pencil: documentation states the reason,
+   *  comments are the conversation, and the two must never look alike. */
+  comment: "\u275D"
+};
+var STROKE = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.571" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">';
+var FILL = '<svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">';
+var stroked = (inner) => `${STROKE}${inner}</svg>`;
+var filled = (inner) => `${FILL}${inner}</svg>`;
+var DISC = filled('<circle cx="12" cy="12" r="6"/>');
+var DISC_LARGE = filled('<circle cx="12" cy="12" r="9"/>');
+var DRAWN = {
+  // --- dismissing and revealing ---------------------------------------------
+  /** Close a panel, a dialog, a popover. (x) */
+  close: stroked('<path d="M18 6 6 18"/><path d="m6 6 12 12"/>'),
+  /** The overflow menu on a document or a row: "more about this". (ellipsis) */
+  more: stroked('<circle cx="12" cy="12" r="1"/><circle cx="19" cy="12" r="1"/><circle cx="5" cy="12" r="1"/>'),
+  /** Collapsed disclosure, pointing at what would open. (chevron-right) */
+  collapsed: stroked('<path d="m9 18 6-6-6-6"/>'),
+  /** Expanded disclosure. (chevron-down) */
+  expanded: stroked('<path d="m6 9 6 6 6-6"/>'),
+  /** A dropdown's affordance, where it is not a real <select>. (chevron-down) */
+  dropdown: stroked('<path d="m6 9 6 6 6-6"/>'),
+  // --- moving through things ------------------------------------------------
+  /** Back / previous, in a breadcrumb or a stepper. (chevron-left) */
+  back: stroked('<path d="m15 18-6-6 6-6"/>'),
+  /** Forward / next. (chevron-right) */
+  forward: stroked('<path d="m9 18 6-6-6-6"/>'),
+  /** Up one, in a list. (arrow-up) */
+  up: stroked('<path d="m5 12 7-7 7 7"/><path d="M12 19V5"/>'),
+  /** Down one. (arrow-down) */
+  down: stroked('<path d="M12 5v14"/><path d="m19 12-7 7-7-7"/>'),
+  /** History back. (arrow-left) */
+  arrowLeft: stroked('<path d="m12 19-7-7 7-7"/><path d="M19 12H5"/>'),
+  /** History forward; "go there". (arrow-right) */
+  arrowRight: stroked('<path d="M5 12h14"/><path d="m12 5 7 7-7 7"/>'),
+  // --- state ----------------------------------------------------------------
+  /** Done, applied, agreed. (check) */
+  tick: stroked('<path d="M20 6 9 17l-5-5"/>'),
+  /** Somebody else holds this: the version-control lock. (lock) */
+  locked: stroked('<rect width="18" height="11" x="3" y="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4"/>'),
+  /** Read-only on disk with no other holder. (lock-open) An open lock rather
+   *  than a struck-out eye: this state is not a prohibition. Nobody holds the
+   *  file, saving checks it out, and it is the resting state of everything the
+   *  author has not touched yet under a lock-based VCS. eye-off would say "you
+   *  cannot", which is false here; the open lock says "not held", beside
+   *  `locked`, which is the shut one, so the two read as a pair. */
+  readOnly: stroked('<rect width="18" height="11" x="3" y="11" rx="2" ry="2"/><path d="M7 11V7a5 5 0 0 1 9.9-1"/>'),
+  /** YOU hold this one: checked out, still yours to edit. (pencil) */
+  checkedOut: stroked('<path d="M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z"/><path d="m15 5 4 4"/>'),
+  /** Tracked, with local changes not yet committed. (a disc; see DISC) */
+  modified: DISC,
+  /** Not in version control yet: new since the last commit. (plus) */
+  untracked: stroked('<path d="M5 12h14"/><path d="M12 5v14"/>'),
+  /** Something needs attention but is not fatal. (triangle-alert) */
+  warning: stroked('<path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3"/><path d="M12 9v4"/><path d="M12 17h.01"/>'),
+  /** A live thing: the running position, an active marker. (a disc) */
+  dot: DISC,
+  /** Play, in the sense of "run this". (play) */
+  play: stroked('<path d="M5 5a2 2 0 0 1 3.008-1.728l11.997 6.998a2 2 0 0 1 .003 3.458l-12 7A2 2 0 0 1 5 19z"/>'),
+  /** Start the thing again from the top: a play session, a sweep. (rotate-ccw) */
+  restart: stroked('<path d="M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8"/><path d="M3 3v5h5"/>'),
+  /** The three ways a collection can be shown, named by what you get. */
+  /** Cards. (layout-grid) */
+  viewCards: stroked('<rect width="7" height="7" x="3" y="3" rx="1"/><rect width="7" height="7" x="14" y="3" rx="1"/><rect width="7" height="7" x="14" y="14" rx="1"/><rect width="7" height="7" x="3" y="14" rx="1"/>'),
+  /** A table. (rows-3: a ruled box, which is a table. `list` is bullets, and
+   *  the view is not a list.) */
+  viewTable: stroked('<rect width="18" height="18" x="3" y="3" rx="2"/><path d="M21 9H3"/><path d="M21 15H3"/>'),
+  /** A node graph. (waypoints: four nodes on edges reads as a graph.
+   *  `git-fork` reads as version control, which this family also draws, and
+   *  a picture that means two things is the fault this table exists to
+   *  prevent.) */
+  viewNode: stroked('<path d="m10.586 5.414-5.172 5.172"/><path d="m18.586 13.414-5.172 5.172"/><path d="M6 12h12"/><circle cx="12" cy="20" r="2"/><circle cx="12" cy="4" r="2"/><circle cx="20" cy="12" r="2"/><circle cx="4" cy="12" r="2"/>'),
+  /** Record: the disc, in whatever colour the button is. (a disc; see DISC_LARGE) */
+  record: DISC_LARGE,
+  /** Sound: play with audio. (volume-2: the cone and two waves. Patterpad's
+   *  hand-drawn one had a single wave, which at 14px reads as quiet rather
+   *  than as sound.) */
+  speaker: stroked('<path d="M11 4.702a.705.705 0 0 0-1.203-.498L6.413 7.587A1.4 1.4 0 0 1 5.416 8H3a1 1 0 0 0-1 1v6a1 1 0 0 0 1 1h2.416a1.4 1.4 0 0 1 .997.413l3.383 3.384A.705.705 0 0 0 11 19.298z"/><path d="M16 9a5 5 0 0 1 0 6"/><path d="M19.364 18.364a9 9 0 0 0 0-12.728"/>'),
+  // --- handling -------------------------------------------------------------
+  /** The drag grip on a reorderable row. (grip-vertical) */
+  grip: stroked('<circle cx="9" cy="12" r="1"/><circle cx="9" cy="5" r="1"/><circle cx="9" cy="19" r="1"/><circle cx="15" cy="12" r="1"/><circle cx="15" cy="5" r="1"/><circle cx="15" cy="19" r="1"/>'),
+  /** Add one of whatever this list holds. (plus) */
+  add: stroked('<path d="M5 12h14"/><path d="M12 5v14"/>'),
+  /** Copy this to the clipboard. (copy: the front sheet whole, the back
+   *  sheet showing round two of its sides) */
+  copy: stroked('<rect width="14" height="14" x="8" y="8" rx="2" ry="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/>'),
+  /** Connect: to a server, a live link, a running game. (plug) */
+  connect: stroked('<path d="M12 22v-5"/><path d="M15 8V2"/><path d="M17 8a1 1 0 0 1 1 1v4a4 4 0 0 1-4 4h-4a4 4 0 0 1-4-4V9a1 1 0 0 1 1-1z"/><path d="M9 8V2"/>'),
+  /** Search. (search) */
+  search: stroked('<path d="m21 21-4.34-4.34"/><circle cx="11" cy="11" r="8"/>'),
+  /** Keep this window on top. (pin) */
+  pin: stroked('<path d="M12 17v5"/><path d="M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H8a2 2 0 0 0 0 4 1 1 0 0 1 1 1z"/>'),
+  /** Settings. (settings) */
+  settings: stroked('<path d="M9.671 4.136a2.34 2.34 0 0 1 4.659 0 2.34 2.34 0 0 0 3.319 1.915 2.34 2.34 0 0 1 2.33 4.033 2.34 2.34 0 0 0 0 3.831 2.34 2.34 0 0 1-2.33 4.033 2.34 2.34 0 0 0-3.319 1.915 2.34 2.34 0 0 1-4.659 0 2.34 2.34 0 0 0-3.32-1.915 2.34 2.34 0 0 1-2.33-4.033 2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915"/><circle cx="12" cy="12" r="3"/>'),
+  // --- annotation -----------------------------------------------------------
+  /** Documentation notes: a document with lines on it. (file-text) The glyph
+   *  table drew a pencil and shared it with `checkedOut`; the drawn set gives
+   *  the two meanings two shapes, and notes get the document, which is what
+   *  the shell's own noteFilled/noteOutline pair had always drawn. */
+  note: stroked('<path d="M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z"/><path d="M14 2v5a1 1 0 0 0 1 1h5"/><path d="M10 9H8"/><path d="M16 13H8"/><path d="M16 17H8"/>'),
+  /** A comment thread. Speech, not a document: documentation states the
+   *  reason, comments are the conversation, and the two must never look
+   *  alike. (message-square) */
+  comment: stroked('<path d="M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z"/>')
+};
+var ICON_SIZE = 14;
+var templates = /* @__PURE__ */ new Map();
+function iconNode(name, size = ICON_SIZE) {
+  let tpl = templates.get(name);
+  if (!tpl) {
+    const holder = document.createElement("template");
+    holder.innerHTML = DRAWN[name];
+    tpl = holder.content.firstElementChild;
+    tpl.setAttribute("data-icon", name);
+    templates.set(name, tpl);
+  }
+  const node = tpl.cloneNode(true);
+  node.setAttribute("width", String(size));
+  node.setAttribute("height", String(size));
+  return node;
+}
+var BY_GLYPH = /* @__PURE__ */ new Map();
+for (const [name, glyph] of Object.entries(icon)) {
+  if (!BY_GLYPH.has(glyph)) BY_GLYPH.set(glyph, name);
+}
+
 // src/dom.ts
 function el(tag, classNameOrProps, ...children) {
   const node = document.createElement(tag);
@@ -144,6 +332,47 @@ function el(tag, classNameOrProps, ...children) {
   checkTooltipHost();
   return node;
 }
+var CHIP_ICON = 10;
+function tagChips(holder, onChange) {
+  const wrap = el("div", "shell-tags");
+  const input = el("input", "shell-tag-input");
+  input.type = "text";
+  input.placeholder = "Add value";
+  input.spellcheck = false;
+  const makeChip = (v) => {
+    const chip = el("span", "shell-tag", v);
+    const x = el("button", "shell-tag-x", iconNode("close", CHIP_ICON));
+    x.type = "button";
+    x.dataset["tip"] = `Remove ${v}`;
+    x.setAttribute("aria-label", `Remove ${v}`);
+    x.addEventListener("click", () => {
+      holder.values = (holder.values ?? []).filter((o) => o !== v);
+      chip.remove();
+      onChange?.();
+    });
+    chip.append(x);
+    return chip;
+  };
+  const commit = () => {
+    const v = input.value.trim();
+    if (v && !(holder.values ?? []).includes(v)) {
+      (holder.values ??= []).push(v);
+      wrap.insertBefore(makeChip(v), input);
+      onChange?.();
+    }
+    input.value = "";
+  };
+  input.addEventListener("keydown", (e) => {
+    if (e.key === "Enter" || e.key === ",") {
+      e.preventDefault();
+      commit();
+    }
+  });
+  input.addEventListener("blur", commit);
+  for (const v of holder.values ?? []) wrap.append(makeChip(v));
+  wrap.append(input);
+  return wrap;
+}
 
 // src/value-control.ts
 function fallbackText(decl) {
@@ -223,9 +452,364 @@ function rungStrip(opts) {
   }
   return strip;
 }
+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 "";
+  switch (decl.type) {
+    case "number":
+      return typeof value === "number" && Number.isFinite(value) ? "" : "Not a number.";
+    case "boolean":
+      return typeof value === "boolean" ? "" : "Not True or False.";
+    case "enum":
+      return decl.values && !decl.values.includes(String(value)) ? `"${String(value)}" is not one of the values.` : "";
+    case "quality":
+      return decl.stages && !decl.stages.includes(String(value)) ? `"${String(value)}" is not one of the stages.` : "";
+    case "flags": {
+      if (!Array.isArray(value)) return "Not a list of flags.";
+      const strays = decl.values ? value.filter((v) => !decl.values.includes(String(v))) : [];
+      if (strays.length === 0) return "";
+      return strays.length === 1 ? `"${String(strays[0])}" is not one of the values.` : `${strays.map((s) => `"${String(s)}"`).join(", ")} are not among the values.`;
+    }
+    default:
+      return "";
+  }
+}
+var isTextual = (type) => type !== "boolean" && type !== "enum" && type !== "flags" && type !== "quality";
+var controlShape = (o) => JSON.stringify([
+  o.decl.type,
+  o.decl.values ?? null,
+  o.decl.stages ?? null,
+  o.decl.default ?? null,
+  o.onCommit === void 0,
+  o.disabled === true,
+  o.controlClassName ?? "",
+  o.decl.type === "quality" && (o.decl.stages?.length ?? 0) === 0
+]);
+function fieldRow(initial) {
+  let opts = initial;
+  const row = el("div", `shell-fieldrow${opts.className ? ` ${opts.className}` : ""}`);
+  const caption = el("span", `shell-fieldrow-label${opts.labelClassName ? ` ${opts.labelClassName}` : ""}`);
+  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 problem = el("p", "shell-fieldrow-problem");
+  problem.setAttribute("role", "status");
+  row.append(caption, body);
+  let shape = "";
+  let show2 = () => {
+  };
+  let typing = "";
+  const commit = (v) => {
+    opts.onCommit?.(v);
+  };
+  const editable = () => opts.onCommit !== void 0 && opts.disabled !== true;
+  const ctl = (base) => opts.controlClassName ? `${base.replace(/^field /, "")} ${opts.controlClassName}` : base;
+  const labelledBy = (node) => {
+    node.setAttribute("aria-labelledby", caption.id);
+    const described = [purpose.id, problem.id].filter(Boolean).join(" ");
+    if (described) node.setAttribute("aria-describedby", described);
+  };
+  purpose.id = `${caption.id}-p`;
+  problem.id = `${caption.id}-m`;
+  const sayProblem = () => {
+    const words = [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);
+    row.classList.toggle("shell-fieldrow-textual", isTextual(opts.decl.type));
+  };
+  const build = () => {
+    const decl = opts.decl;
+    typing = "";
+    if (decl.type === "quality" && (decl.stages?.length ?? 0) > 0) {
+      const holder = el("span", "shell-fieldrow-rungs");
+      show2 = (value) => {
+        holder.replaceChildren(rungStrip({
+          stages: decl.stages,
+          value: typeof value === "string" && value !== "" ? value : void 0,
+          decl,
+          ...editable() ? { onPick: (stage) => {
+            opts = { ...opts, value: stage };
+            show2(stage);
+            sayProblem();
+            commit(stage);
+          }, onClear: () => {
+            opts = { ...opts, value: void 0 };
+            show2(void 0);
+            sayProblem();
+            commit(void 0);
+          } } : {}
+        }));
+        const strip = holder.firstElementChild;
+        if (strip) {
+          strip.setAttribute("role", "group");
+          labelledBy(strip);
+        }
+      };
+      return holder;
+    }
+    if (decl.type === "boolean" || decl.type === "enum") {
+      const sel = el("select", ctl("field shell-fieldrow-select"));
+      labelledBy(sel);
+      sel.disabled = !editable();
+      const choices = decl.type === "boolean" ? [["true", "True"], ["false", "False"]] : (decl.values ?? []).map((v) => [v, v]);
+      show2 = (value) => {
+        const current = value === void 0 || value === null || value === "" ? "" : String(value);
+        sel.replaceChildren();
+        const add = (v, label) => {
+          const o = el("option", void 0, label);
+          o.value = v;
+          sel.append(o);
+        };
+        add("", defaultLabel(decl));
+        for (const [v, label] of choices) add(v, label);
+        if (current !== "" && !choices.some(([v]) => v === current)) add(current, current);
+        sel.value = current;
+      };
+      sel.addEventListener("change", () => {
+        const raw = sel.value;
+        const v = raw === "" ? void 0 : decl.type === "boolean" ? raw === "true" : raw;
+        opts = { ...opts, value: v };
+        sayProblem();
+        commit(v);
+      });
+      return sel;
+    }
+    if (decl.type === "flags" && (decl.values?.length ?? 0) > 0) {
+      const holder = el("span", "shell-flags");
+      holder.setAttribute("role", "group");
+      labelledBy(holder);
+      show2 = (value) => {
+        const unset = !Array.isArray(value);
+        const held = unset ? fallbackFlags(decl) : value.map(String);
+        holder.replaceChildren();
+        const chip = (text, cls, pressed, tip2, onClick) => {
+          const b = el(onClick && editable() ? "button" : "span", { className: `shell-flag${cls}`, text, tip: tip2 });
+          b.setAttribute("aria-label", `${text}: ${tip2}`);
+          if (b instanceof HTMLButtonElement) {
+            b.type = "button";
+            b.addEventListener("click", onClick);
+          }
+          if (pressed !== void 0) b.setAttribute("aria-pressed", String(pressed));
+          holder.append(b);
+        };
+        const set = (next) => {
+          opts = { ...opts, value: next };
+          show2(next);
+          sayProblem();
+          commit(next);
+        };
+        chip(
+          defaultLabel(decl),
+          ` shell-flag-default${unset ? " on" : ""}`,
+          void 0,
+          unset ? "Not set here: the declared default holds" : "Clear the value, back to the default",
+          unset ? void 0 : () => set(void 0)
+        );
+        for (const v of decl.values) {
+          const on = held.includes(v);
+          chip(
+            v,
+            `${on ? " on" : ""}${on && unset ? " fallback" : ""}`,
+            on,
+            on ? `Unset ${v}` : `Set ${v}`,
+            () => set(on ? held.filter((x) => x !== v) : decl.values.filter((x) => x === v || held.includes(x)).concat(held.filter((x) => !decl.values.includes(x))))
+          );
+        }
+        for (const v of held.filter((x) => !decl.values.includes(x))) {
+          chip(v, " stray on", true, `"${v}" is not one of the values: click to drop it`, () => set(held.filter((x) => x !== v)));
+        }
+      };
+      return holder;
+    }
+    if (decl.type === "flags") {
+      const holder = el("span", "shell-fieldrow-chips");
+      show2 = (value) => {
+        const box = { values: Array.isArray(value) ? value.map(String) : [] };
+        const chips = tagChips(box, () => {
+          const next = box.values.length > 0 ? [...box.values] : void 0;
+          opts = { ...opts, value: next };
+          sayProblem();
+          commit(next);
+        });
+        const input = chips.querySelector("input");
+        if (input) {
+          labelledBy(input);
+          input.placeholder = Array.isArray(value) ? "Add value" : defaultLabel(decl);
+          input.disabled = !editable();
+        }
+        chips.querySelectorAll("button").forEach((b) => {
+          b.disabled = !editable();
+        });
+        holder.replaceChildren(chips);
+      };
+      return holder;
+    }
+    const multiline = decl.type === "multiline";
+    const field = multiline ? el("textarea", ctl("field shell-fieldrow-text")) : el("input", ctl("field shell-fieldrow-text"));
+    if (field instanceof HTMLInputElement) {
+      field.type = "text";
+      if (decl.type === "number") field.inputMode = "decimal";
+    } else field.rows = 3;
+    labelledBy(field);
+    field.placeholder = defaultLabel(decl);
+    field.disabled = !editable();
+    const asText = (value) => value === void 0 || value === null ? "" : Array.isArray(value) ? value.join(", ") : String(value);
+    const read = (raw) => {
+      if (raw.trim() === "") return {};
+      if (decl.type !== "number") return { value: raw };
+      const n = Number(raw.trim());
+      return Number.isFinite(n) ? { value: n } : { bad: "Not a number." };
+    };
+    let atFocus = "";
+    show2 = (value) => {
+      if (field.ownerDocument.activeElement === field || keeper.restoring(field) || keeper.holds(row)) return;
+      field.value = asText(value);
+    };
+    const take = () => {
+      const r = read(field.value);
+      typing = r.bad ?? "";
+      if (r.bad === void 0) opts = { ...opts, value: r.value };
+      sayProblem();
+      if (r.bad === void 0) commit(r.value);
+    };
+    field.addEventListener("focus", () => {
+      if (!keeper.restoring(field)) atFocus = field.value;
+    });
+    field.addEventListener("input", take);
+    field.addEventListener("keydown", (e) => {
+      if (e.key !== "Escape" || field.value === atFocus) return;
+      field.value = atFocus;
+      take();
+    });
+    return field;
+  };
+  const draw = (next) => {
+    const decl = next.decl;
+    const label = next.label ?? decl.name;
+    if (typeof label === "string") caption.textContent = label;
+    else caption.replaceChildren(label);
+    caption.className = `shell-fieldrow-label${next.labelClassName ? ` ${next.labelClassName}` : ""}`;
+    row.className = `shell-fieldrow${next.className ? ` ${next.className}` : ""}`;
+    const nextShape = controlShape(next);
+    opts = next;
+    if (nextShape !== shape) {
+      shape = nextShape;
+      body.replaceChildren(build());
+    }
+    show2(next.value);
+    purpose.textContent = decl.purpose ?? "";
+    if (decl.purpose) body.append(purpose);
+    else purpose.remove();
+    body.append(problem);
+    sayProblem();
+  };
+  draw(initial);
+  keeper.watch(row);
+  return { el: row, update: draw };
+}
+var keeper = /* @__PURE__ */ (() => {
+  const memos = /* @__PURE__ */ new WeakMap();
+  const restoringNow = /* @__PURE__ */ new WeakSet();
+  const redrawn = /* @__PURE__ */ new WeakMap();
+  const put = (row) => {
+    const memo = memos.get(row);
+    if (!memo) return;
+    const doc = row.ownerDocument;
+    const active2 = doc.activeElement;
+    if (!row.isConnected || !memo.field.isConnected || !row.contains(memo.field)) return;
+    if (active2 && active2 !== doc.body && !row.contains(active2)) {
+      memos.delete(row);
+      return;
+    }
+    if (active2 === memo.field && memo.field.matches(":focus")) return;
+    restoringNow.add(memo.field);
+    try {
+      memo.field.focus({ preventScroll: true });
+      if (!(memo.field instanceof HTMLSelectElement) && memo.start !== null) memo.field.setSelectionRange(memo.start, memo.end ?? memo.start);
+    } finally {
+      restoringNow.delete(memo.field);
+    }
+  };
+  return {
+    watch(row) {
+      const note = (e) => {
+        const t = e.target;
+        if (!(t instanceof HTMLInputElement || t instanceof HTMLTextAreaElement || t instanceof HTMLSelectElement)) return;
+        const text = !(t instanceof HTMLSelectElement);
+        memos.set(row, { field: t, start: text ? t.selectionStart : null, end: text ? t.selectionEnd : null });
+      };
+      row.addEventListener("focusin", note);
+      row.addEventListener("input", note);
+      row.addEventListener("keyup", note);
+      row.addEventListener("mouseup", note);
+      row.addEventListener("focusout", (e) => {
+        const at = performance.now();
+        const late = e.relatedTarget === null && at - (redrawn.get(row) ?? -Infinity) < 250;
+        if (late && memos.has(row)) {
+          queueMicrotask(() => put(row));
+          return;
+        }
+        queueMicrotask(() => {
+          if ((redrawn.get(row) ?? -Infinity) >= at) {
+            put(row);
+            return;
+          }
+          if (row.isConnected && !row.contains(row.ownerDocument.activeElement)) memos.delete(row);
+        });
+      });
+    },
+    /** Give the focus back to the row, if the author was in it and has not gone anywhere else since. */
+    restore(row) {
+      if (!memos.has(row)) return;
+      redrawn.set(row, performance.now());
+      queueMicrotask(() => put(row));
+    },
+    restoring: (field) => restoringNow.has(field),
+    /** Forget the row's focus if the author has since gone somewhere else (before the row is redrawn). */
+    settle(row) {
+      const active2 = row.ownerDocument.activeElement;
+      if (active2 && active2 !== row.ownerDocument.body && !row.contains(active2)) memos.delete(row);
+    },
+    /** The row the author is in (before a redraw takes it out). */
+    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 {
+    row(key, opts) {
+      const had = rows.get(key);
+      if (had) {
+        had.used = true;
+        keeper.settle(had.handle.el);
+        had.handle.update(opts);
+        keeper.restore(had.handle.el);
+        return had.handle.el;
+      }
+      const handle = fieldRow(opts);
+      rows.set(key, { handle, used: true });
+      return handle.el;
+    },
+    sweep() {
+      for (const [key, entry] of rows) {
+        if (!entry.used) rows.delete(key);
+        else entry.used = false;
+      }
+    }
+  };
+}
 
 exports.defaultLabel = defaultLabel;
 exports.fallbackText = fallbackText;
+exports.fieldRow = fieldRow;
+exports.fieldRowFocus = fieldRowFocus;
+exports.fieldRows = fieldRows;
+exports.fieldValueProblem = fieldValueProblem;
 exports.rungStrip = rungStrip;
 exports.stageGateNote = stageGateNote;
 //# sourceMappingURL=value-control.cjs.map