@wildwinter/app-shell 0.46.4 → 0.47.0

package/dist/{property-list-D3VZCJzi.d.cts → property-list-5mS4J2uy.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. */

package/dist/{property-list-D3VZCJzi.d.ts → property-list-5mS4J2uy.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. */

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;