@wildwinter/app-shell 0.48.0 → 0.50.0

package/dist/{property-list-BgZlkcbz.d.cts → property-list-DlpxIkv6.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 {
@@ -149,6 +162,15 @@ interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControl
     extraDetails?: (decl: T, index: number) => (HTMLElement | null)[];
     /** Offer the Purpose field. Default true. */
     purpose?: boolean;
+    /** What a row declares, in the row's own words ("Field name", "What this field is for", "Delete
+     *  field"). Default "property". */
+    noun?: string;
+    /**
+     * The rule a name follows. `"property"` (default): the property-name rules, bound and gated, since an
+     * expression must be able to reach it. `"free"`: any name, only duplicates refused, for a declaration no
+     * expression reads (a Patterpad game-data field's name is the host's word).
+     */
+    names?: "property" | "free";
     /**
      * A quality's stage was renamed in place (the declaration's own default
      * already follows it). Given, the rename is handed here INSTEAD of

package/dist/{property-list-BgZlkcbz.d.ts → property-list-DlpxIkv6.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 {
@@ -149,6 +162,15 @@ interface PropertyListOptions<T extends PropertyDeclLike> extends DefaultControl
     extraDetails?: (decl: T, index: number) => (HTMLElement | null)[];
     /** Offer the Purpose field. Default true. */
     purpose?: boolean;
+    /** What a row declares, in the row's own words ("Field name", "What this field is for", "Delete
+     *  field"). Default "property". */
+    noun?: string;
+    /**
+     * The rule a name follows. `"property"` (default): the property-name rules, bound and gated, since an
+     * expression must be able to reach it. `"free"`: any name, only duplicates refused, for a declaration no
+     * expression reads (a Patterpad game-data field's name is the host's word).
+     */
+    names?: "property" | "free";
     /**
      * A quality's stage was renamed in place (the declaration's own default
      * already follows it). Given, the rename is handed here INSTEAD of

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;
@@ -737,24 +764,32 @@ function mountPropertyList(host, decls, opts = {}) {
   const types = opts.types ?? PROPERTY_TYPES;
   const list = el("div", "set-list");
   const keep = (parts) => (parts ?? []).filter((p) => p !== null);
+  const noun = opts.noun ?? "property";
+  const Noun = noun.charAt(0).toUpperCase() + noun.slice(1);
+  const freeNames = opts.names === "free";
   const row = (p, i) => {
     const name = el("input", "field set-name");
     name.type = "text";
-    name.placeholder = "Property name";
+    name.placeholder = `${Noun} name`;
     name.value = p.name;
     name.spellcheck = false;
-    name.dataset["tip"] = PROPERTY_NAME_HINT;
-    bindPropertyName(name, (v) => {
-      p.name = v;
+    if (freeNames) name.addEventListener("input", () => {
+      p.name = name.value;
       changed();
-    }, { hint: PROPERTY_NAME_HINT });
+    });
+    else {
+      name.dataset["tip"] = PROPERTY_NAME_HINT;
+      bindPropertyName(name, (v) => {
+        p.name = v;
+        changed();
+      }, { hint: PROPERTY_NAME_HINT });
+    }
     guard.track(name);
     const type = el("select", "field set-type");
     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 ??= [];
@@ -781,7 +816,7 @@ function mountPropertyList(host, decls, opts = {}) {
         changed();
       }
     }, i === decls.length - 1);
-    const del = iconBtn("close", "Delete property", () => {
+    const del = iconBtn("close", `Delete ${noun}`, () => {
       decls.splice(i, 1);
       render();
       changed();
@@ -806,7 +841,7 @@ function mountPropertyList(host, decls, opts = {}) {
     if (opts.purpose !== false) {
       const purpose = el("input", "field set-purpose");
       purpose.type = "text";
-      purpose.placeholder = "What this property is for";
+      purpose.placeholder = `What this ${noun} is for`;
       purpose.value = p.purpose ?? "";
       purpose.addEventListener("input", () => {
         if (purpose.value.trim()) p.purpose = purpose.value;
@@ -836,9 +871,9 @@ function mountPropertyList(host, decls, opts = {}) {
   host.append(list, add);
   return {
     firstDuplicate: () => guard.firstDuplicate(),
-    firstIllegalName: () => firstIllegalPropertyName(host),
+    firstIllegalName: () => freeNames ? null : firstIllegalPropertyName(host),
     // The Save gate takes both faults; the field's own rollover says which.
-    firstInvalid: () => guard.firstDuplicate() ?? firstIllegalPropertyName(host),
+    firstInvalid: () => guard.firstDuplicate() ?? (freeNames ? null : firstIllegalPropertyName(host)),
     render
   };
 }