@wildwinter/app-shell 0.46.5 → 0.48.0

package/dist/{property-list-D3VZCJzi.d.cts → property-list-BgZlkcbz.d.cts}

@@ -78,8 +78,14 @@ interface SettingsDialogOptions {
     sections: SettingsSection[];
     /** Fired when Save is clicked and every section validates. The app reads its
      *  own section state and persists. May be async; the dialog stays open until
-     *  it resolves, then closes. */
-    onSave: () => void | Promise<void>;
+     *  it resolves, then closes.
+     *
+     *  Return `false` (or a Promise of it) when the save was REFUSED, a version
+     *  control lock say, and the dialog stays open with the author's edits in it
+     *  for another try; saying why is the app's (a toast, usually). A throw, or a
+     *  rejected Promise, is treated the same way rather than surfacing as an
+     *  unhandled rejection. Anything else closes the dialog, as it always has. */
+    onSave: () => void | boolean | Promise<void | boolean>;
 }
 interface SettingsDialog {
     /** Open (optionally on a given tab id). Sections re-mount from current data. */
@@ -143,6 +149,17 @@ interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControl
     extraDetails?: (decl: T, index: number) => (HTMLElement | null)[];
     /** Offer the Purpose field. Default true. */
     purpose?: boolean;
+    /**
+     * A quality's stage was renamed in place (the declaration's own default
+     * already follows it). Given, the rename is handed here INSTEAD of
+     * `onChange`, so the caller can carry every value that names the stage in
+     * the same edit as the declaration; absent, it is an ordinary change.
+     */
+    onStageRename?: (decl: T, from: string, to: string) => void;
+    /** A quality's stages were reordered (after `onChange`). `note` is a quiet
+     *  line under the stages for the caller to fill, such as how many gates
+     *  compare against the ladder. */
+    onStageReorder?: (decl: T, note: HTMLElement) => void;
 }
 interface PropertyListHandle extends SettingsSectionHandle {
     /** Both faults, for the Save gate: a duplicate first, then an illegal name. */

package/dist/{property-list-D3VZCJzi.d.ts → property-list-BgZlkcbz.d.ts}

@@ -78,8 +78,14 @@ interface SettingsDialogOptions {
     sections: SettingsSection[];
     /** Fired when Save is clicked and every section validates. The app reads its
      *  own section state and persists. May be async; the dialog stays open until
-     *  it resolves, then closes. */
-    onSave: () => void | Promise<void>;
+     *  it resolves, then closes.
+     *
+     *  Return `false` (or a Promise of it) when the save was REFUSED, a version
+     *  control lock say, and the dialog stays open with the author's edits in it
+     *  for another try; saying why is the app's (a toast, usually). A throw, or a
+     *  rejected Promise, is treated the same way rather than surfacing as an
+     *  unhandled rejection. Anything else closes the dialog, as it always has. */
+    onSave: () => void | boolean | Promise<void | boolean>;
 }
 interface SettingsDialog {
     /** Open (optionally on a given tab id). Sections re-mount from current data. */
@@ -143,6 +149,17 @@ interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControl
     extraDetails?: (decl: T, index: number) => (HTMLElement | null)[];
     /** Offer the Purpose field. Default true. */
     purpose?: boolean;
+    /**
+     * A quality's stage was renamed in place (the declaration's own default
+     * already follows it). Given, the rename is handed here INSTEAD of
+     * `onChange`, so the caller can carry every value that names the stage in
+     * the same edit as the declaration; absent, it is an ordinary change.
+     */
+    onStageRename?: (decl: T, from: string, to: string) => void;
+    /** A quality's stages were reordered (after `onChange`). `note` is a quiet
+     *  line under the stages for the caller to fill, such as how many gates
+     *  compare against the ladder. */
+    onStageReorder?: (decl: T, note: HTMLElement) => void;
 }
 interface PropertyListHandle extends SettingsSectionHandle {
     /** Both faults, for the Save gate: a duplicate first, then an illegal name. */

package/dist/property-list.cjs

@@ -260,11 +260,18 @@ var DRAWN = {
   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) */
@@ -345,16 +352,17 @@ function iconBtn(name, title, onClick, disabled = false, danger = false) {
   b.addEventListener("click", onClick);
   return b;
 }
-function labelled(label, control) {
+function labelled(label, control, hint) {
   const target = control.matches("input, select, textarea") ? control : control.querySelector("input:not([type=button]):not([type=submit]), select, textarea");
   const w = el(target ? "label" : "div", "shell-labelled");
   w.append(el("span", "shell-fieldcap", label), control);
   if (target) {
-    if (!target.id) target.id = `shell-f-${Math.random().toString(36).slice(2, 9)}`;
+    if (!target.id) target.id = uid();
     w.htmlFor = target.id;
   }
   return w;
 }
+var uid = () => `shell-f-${Math.random().toString(36).slice(2, 9)}`;
 function moveItem(arr, i, delta) {
   const j = i + delta;
   if (j < 0 || j >= arr.length) return false;
@@ -402,7 +410,7 @@ function tagChips(holder, onChange) {
   wrap.append(input);
   return wrap;
 }
-function stageChips(holder, onChange) {
+function stageChips(holder, onChange, opts = {}) {
   const wrap = el("div", "shell-tags shell-stages");
   const input = el("input", "shell-tag-input");
   input.type = "text";
@@ -417,35 +425,79 @@ function stageChips(holder, onChange) {
     b.addEventListener("click", onClick);
     return b;
   };
+  const nameLabel = (chip, v, i) => {
+    const label = el("span", "shell-tag-label", `${i + 1}. ${v}`);
+    label.setAttribute("role", "button");
+    label.tabIndex = 0;
+    label.dataset["tip"] = `Rename ${v}`;
+    const edit = () => {
+      const field = el("input", "shell-tag-input shell-stage-rename");
+      field.type = "text";
+      field.value = v;
+      field.spellcheck = false;
+      field.setAttribute("aria-label", `Rename ${v}`);
+      let done = false;
+      const finish = (keep) => {
+        if (done) return;
+        done = true;
+        const to = field.value.trim();
+        const stages = holder.stages ?? [];
+        if (keep && to !== "" && to !== v && !stages.includes(to)) {
+          stages[stages.indexOf(v)] = to;
+          rebuild();
+          if (opts.onRename) opts.onRename(v, to);
+          else onChange?.();
+        } else {
+          rebuild();
+        }
+      };
+      field.addEventListener("keydown", (e) => {
+        if (e.key === "Enter") {
+          e.preventDefault();
+          finish(true);
+        } else if (e.key === "Escape") {
+          e.preventDefault();
+          e.stopPropagation();
+          finish(false);
+        }
+      });
+      field.addEventListener("blur", () => finish(true));
+      label.replaceWith(field);
+      chip.classList.add("editing");
+      field.focus();
+      field.select();
+    };
+    label.addEventListener("click", (e) => {
+      e.preventDefault();
+      edit();
+    });
+    label.addEventListener("keydown", (e) => {
+      if (e.key === "Enter" || e.key === " ") {
+        e.preventDefault();
+        edit();
+      }
+    });
+    return label;
+  };
+  const moved = () => {
+    rebuild();
+    onChange?.();
+    opts.onReorder?.();
+  };
   const rebuild = () => {
     for (const c of Array.from(wrap.children)) if (c !== input) c.remove();
     const stages = holder.stages ?? [];
     stages.forEach((v, i) => {
-      const chip = el("span", "shell-tag", `${i + 1}. ${v}`);
+      const chip = el("span", "shell-tag");
       chip.dataset["stage"] = v;
       chip.append(
-        control(
-          "back",
-          `Move ${v} earlier`,
-          i === 0,
-          () => {
-            if (moveItem(stages, i, -1)) {
-              rebuild();
-              onChange?.();
-            }
-          }
-        ),
-        control(
-          "forward",
-          `Move ${v} later`,
-          i === stages.length - 1,
-          () => {
-            if (moveItem(stages, i, 1)) {
-              rebuild();
-              onChange?.();
-            }
-          }
-        )
+        nameLabel(chip, v, i),
+        control("back", `Move ${v} earlier`, i === 0, () => {
+          if (moveItem(stages, i, -1)) moved();
+        }),
+        control("forward", `Move ${v} later`, i === stages.length - 1, () => {
+          if (moveItem(stages, i, 1)) moved();
+        })
       );
       const x = el("button", "shell-tag-x", iconNode("close", CHIP_ICON));
       x.type = "button";
@@ -736,7 +788,21 @@ function mountPropertyList(host, decls, opts = {}) {
     }, false, true);
     const details = keep(opts.extraDetails?.(p, i));
     if (p.type === "enum" || p.type === "flags") details.push(labelled("Values", tagChips(p, refreshDefault)));
-    if (p.type === "quality") details.push(labelled("Stages (in order)", stageChips(p, refreshDefault)));
+    if (p.type === "quality") {
+      const note = el("p", "shell-stage-note");
+      const stages = stageChips(p, refreshDefault, {
+        onRename: (from, to) => {
+          if (p.default === from) p.default = to;
+          const fresh = defaultControl(p, changed, opts);
+          def.replaceWith(fresh);
+          def = fresh;
+          if (opts.onStageRename) opts.onStageRename(p, from, to);
+          else changed();
+        },
+        onReorder: () => opts.onStageReorder?.(p, note)
+      });
+      details.push(labelled("Stages (in order)", stages), note);
+    }
     if (opts.purpose !== false) {
       const purpose = el("input", "field set-purpose");
       purpose.type = "text";