@wildwinter/app-shell 0.48.0 → 0.49.0

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

@@ -117,17 +117,30 @@ interface PropertyDeclLike {
 declare const PROPERTY_TYPES: ReadonlyArray<readonly [PropertyListType, string]>;
 interface DefaultControlOptions {
     /**
-     * How the default is stored. `false` (default): the string the field shows,
-     * "" for none (Storyletter's DTO). `true`: a typed value (boolean, number,
-     * string), and none DELETES the key (Patterpad's model).
+     * How the default is stored. `false` (default): the string the field shows
+     * (Storyletter's DTO). `true`: a typed value (boolean, number, string)
+     * (Patterpad's model). Either way, no default given DELETES the key: a
+     * default is optional in source, and the type's holds (the family's rule,
+     * ruled 2026-10-18).
      */
     typed?: boolean;
+    /**
+     * An enum may hold "" (none chosen), as a field's may: the select then
+     * offers "(none)" beside "default (x)". Off for a property, whose value is
+     * always one of its values.
+     */
+    noneChosen?: boolean;
+    /** What the blank says instead of the type's default, where something else holds when none is given
+     *  here: a tag's starting value falls back to its group's default, say. */
+    unsetLabel?: string;
 }
 /**
  * The type-appropriate control for a declaration's DEFAULT: a true / false
  * picker for a boolean, the value list for an enum, the stage list for a
- * quality (blank = the first rung), a note for flags (a set starts empty), a
- * number or text field otherwise. The one label for "no default" is "(none)".
+ * quality, a note for flags (a set starts empty), a number or text field
+ * otherwise. Leaving it blank gives no default, and the blank says what holds
+ * then, "default (x)" (`defaultLabel`): a default is optional, and the type's
+ * fills in.
  */
 declare function defaultControl(p: PropertyDeclLike, onChange?: () => void, opts?: DefaultControlOptions): HTMLElement;
 interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControlOptions {

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

@@ -117,17 +117,30 @@ interface PropertyDeclLike {
 declare const PROPERTY_TYPES: ReadonlyArray<readonly [PropertyListType, string]>;
 interface DefaultControlOptions {
     /**
-     * How the default is stored. `false` (default): the string the field shows,
-     * "" for none (Storyletter's DTO). `true`: a typed value (boolean, number,
-     * string), and none DELETES the key (Patterpad's model).
+     * How the default is stored. `false` (default): the string the field shows
+     * (Storyletter's DTO). `true`: a typed value (boolean, number, string)
+     * (Patterpad's model). Either way, no default given DELETES the key: a
+     * default is optional in source, and the type's holds (the family's rule,
+     * ruled 2026-10-18).
      */
     typed?: boolean;
+    /**
+     * An enum may hold "" (none chosen), as a field's may: the select then
+     * offers "(none)" beside "default (x)". Off for a property, whose value is
+     * always one of its values.
+     */
+    noneChosen?: boolean;
+    /** What the blank says instead of the type's default, where something else holds when none is given
+     *  here: a tag's starting value falls back to its group's default, say. */
+    unsetLabel?: string;
 }
 /**
  * The type-appropriate control for a declaration's DEFAULT: a true / false
  * picker for a boolean, the value list for an enum, the stage list for a
- * quality (blank = the first rung), a note for flags (a set starts empty), a
- * number or text field otherwise. The one label for "no default" is "(none)".
+ * quality, a note for flags (a set starts empty), a number or text field
+ * otherwise. Leaving it blank gives no default, and the blank says what holds
+ * then, "default (x)" (`defaultLabel`): a default is optional, and the type's
+ * fills in.
  */
 declare function defaultControl(p: PropertyDeclLike, onChange?: () => void, opts?: DefaultControlOptions): HTMLElement;
 interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControlOptions {

package/dist/property-list.cjs

@@ -671,6 +671,31 @@ function firstIllegalPropertyName(host) {
   return host.querySelector("input.illegal");
 }
 
+// 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)})`;
+
 // src/property-list.ts
 var PROPERTY_TYPES = [
   ["number", "Number"],
@@ -686,35 +711,37 @@ var option = (value, label, 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 current = 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, current === ""), option("true", "True", current === "true"), option("false", "False", current === "false"));
+    sel.append(option("", unsetLabel, current === ""), option("true", "True", current === "true"), option("false", "False", current === "false"));
     sel.addEventListener("change", () => write(sel.value));
     return sel;
   }
   if (p.type === "enum") {
     const sel = el("select", "field set-default");
-    sel.append(option("", NONE, current === ""));
+    const none = opts.noneChosen === true && p.default === "";
+    sel.append(option("", unsetLabel, current === "" && !none));
+    if (opts.noneChosen) sel.append(option(NONE_CHOSEN, "(none)", none));
     for (const v of p.values ?? []) sel.append(option(v, v, current === 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)", current === ""));
+    sel.append(option("", unsetLabel, current === ""));
     for (const v of p.stages ?? []) sel.append(option(v, v, current === v));
     sel.addEventListener("change", () => write(sel.value));
     return sel;
@@ -726,7 +753,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 = current;
   input.addEventListener("input", () => write(input.value));
   return input;
@@ -753,8 +780,7 @@ function mountPropertyList(host, decls, opts = {}) {
     for (const [v, label] of types) type.append(option(v, label, 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 ??= [];