@loadbare/widgets 0.6.0 → 0.8.0

package/README.md

@@ -16,6 +16,7 @@ Inventory:
 | [`lb-form`](docs/lb-form.md) | a form over one row, which saves per control once the row is on record |
 | [`lb-insert-dialog`](docs/lb-insert-dialog.md) | a row entered in a modal dialog, chosen in the picker that opened it |
 | [`lb-master`](docs/lb-master.md) | a set, one of its rows, and the buttons that act on the set |
+| [`lb-checkbox`](docs/lb-checkbox.md) | a checkbox and its label, as markup to style |
 
 ## Installing
 

package/dist/control.d.ts

@@ -1,3 +1,4 @@
+import type { HubLifecycle } from "@loadbare/app/types";
 /**
  * A form-associated custom element wrapping one native control, which makes
  * the widget itself the control: the hub sets its `value` when a column
@@ -12,7 +13,7 @@
  * a consumer's builder passes it over, and each widget that extends it
  * brings it along.
  */
-export declare abstract class WrappedControl extends HTMLElement {
+export declare abstract class WrappedControl extends HTMLElement implements HubLifecycle {
     static formAssociated: boolean;
     /** The tag of the native control this widget wraps. */
     protected abstract inner: string;
@@ -22,20 +23,14 @@ export declare abstract class WrappedControl extends HTMLElement {
      * leaves it out.
      */
     private internals;
-    /** Whether the widget has connected once. */
-    private connected;
     constructor();
     /**
-     * A value that landed before this widget's definition did is only a
-     * stamp, since the hub sets `value` on a control and the element was not
-     * one yet. It is taken up the first time the widget connects, and never
-     * again: after that the hub sets `value` itself, and a later move must not
-     * undo an edit.
-     *
      * The native control follows the widget's `form` attribute, so a form
-     * this widget joins by id resets the control inside it too.
+     * this widget joins by id resets the control inside it too. An element
+     * around this one that joins it to a form does so in its own
+     * `lbAttached`, which the hub calls first.
      */
-    connectedCallback(): void;
+    lbAttached(): void;
     /** The native control this widget wraps, once it is there. */
     protected get control(): HTMLInputElement | HTMLSelectElement | null;
     get value(): string;
@@ -46,6 +41,17 @@ export declare abstract class WrappedControl extends HTMLElement {
      * form its value once the control has been reset.
      */
     formResetCallback(): void;
+    /**
+     * A message the hub sets when a handler refuses this control's column. It
+     * goes on the native control inside, which is what the form checks before
+     * it submits, what the browser shows the message beside, and what takes
+     * focus when it is reported.
+     */
+    setCustomValidity(message: string): void;
+    /** Show the native control's message, and focus it. */
+    reportValidity(): boolean;
+    /** The native control's message, empty when it has none. */
+    get validationMessage(): string;
     /** The inner control changed, before the widget fires its own `change`. */
     protected changed(): void;
     /** Tell the form owner the value, where the implementation allows it. */

package/dist/control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../widgets/control.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,8BAAsB,cAAe,SAAQ,WAAW;IACtD,MAAM,CAAC,cAAc,UAAQ;IAE7B,uDAAuD;IACvD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAqB;IAEtC,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAAS;;IAY1B;;;;;;;;;OASG;IACH,iBAAiB,IAAI,IAAI;IASzB,8DAA8D;IAC9D,SAAS,KAAK,OAAO,IAAI,gBAAgB,GAAG,iBAAiB,GAAG,IAAI,CAEnE;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAUtB;IAED;;;;OAIG;IACH,iBAAiB,IAAI,IAAI;IAIzB,2EAA2E;IAC3E,SAAS,CAAC,OAAO,IAAI,IAAI;IAIzB,yEAAyE;IACzE,SAAS,CAAC,SAAS,IAAI,IAAI;CAG5B"}
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../widgets/control.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,8BAAsB,cACpB,SAAQ,WACR,YAAW,YAAY;IAEvB,MAAM,CAAC,cAAc,UAAQ;IAE7B,uDAAuD;IACvD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEjC;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAqB;;IAYtC;;;;;OAKG;IACH,UAAU,IAAI,IAAI;IAKlB,8DAA8D;IAC9D,SAAS,KAAK,OAAO,IAAI,gBAAgB,GAAG,iBAAiB,GAAG,IAAI,CAEnE;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAUtB;IAED;;;;OAIG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC,uDAAuD;IACvD,cAAc,IAAI,OAAO;IAIzB,4DAA4D;IAC5D,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,2EAA2E;IAC3E,SAAS,CAAC,OAAO,IAAI,IAAI;IAIzB,yEAAyE;IACzE,SAAS,CAAC,SAAS,IAAI,IAAI;CAG5B"}

package/dist/control.js

@@ -1,5 +1,4 @@
 /// <reference lib="dom" />
-import { ATTR_COLUMN_VALUE } from "@loadbare/app/constants";
 /**
  * A form-associated custom element wrapping one native control, which makes
  * the widget itself the control: the hub sets its `value` when a column
@@ -22,8 +21,6 @@ export class WrappedControl extends HTMLElement {
      * leaves it out.
      */
     internals = internalsOf(this);
-    /** Whether the widget has connected once. */
-    connected = false;
     constructor() {
         super();
         this.addEventListener("change", (e) => {
@@ -35,25 +32,15 @@ export class WrappedControl extends HTMLElement {
         });
     }
     /**
-     * A value that landed before this widget's definition did is only a
-     * stamp, since the hub sets `value` on a control and the element was not
-     * one yet. It is taken up the first time the widget connects, and never
-     * again: after that the hub sets `value` itself, and a later move must not
-     * undo an edit.
-     *
      * The native control follows the widget's `form` attribute, so a form
-     * this widget joins by id resets the control inside it too.
+     * this widget joins by id resets the control inside it too. An element
+     * around this one that joins it to a form does so in its own
+     * `lbAttached`, which the hub calls first.
      */
-    connectedCallback() {
+    lbAttached() {
         const form = this.getAttribute("form");
         if (form !== null)
             this.control?.setAttribute("form", form);
-        if (this.connected)
-            return;
-        this.connected = true;
-        const stamped = this.getAttribute(ATTR_COLUMN_VALUE);
-        if (stamped !== null)
-            this.value = stamped;
     }
     /** The native control this widget wraps, once it is there. */
     get control() {
@@ -79,6 +66,23 @@ export class WrappedControl extends HTMLElement {
     formResetCallback() {
         queueMicrotask(() => this.formValue());
     }
+    /**
+     * A message the hub sets when a handler refuses this control's column. It
+     * goes on the native control inside, which is what the form checks before
+     * it submits, what the browser shows the message beside, and what takes
+     * focus when it is reported.
+     */
+    setCustomValidity(message) {
+        this.control?.setCustomValidity(message);
+    }
+    /** Show the native control's message, and focus it. */
+    reportValidity() {
+        return this.control?.reportValidity() ?? true;
+    }
+    /** The native control's message, empty when it has none. */
+    get validationMessage() {
+        return this.control?.validationMessage ?? "";
+    }
     /** The inner control changed, before the widget fires its own `change`. */
     changed() {
         this.formValue();

package/dist/control.js.map

@@ -1 +1 @@
-{"version":3,"file":"control.js","sourceRoot":"","sources":["../widgets/control.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,cAAe,SAAQ,WAAW;IACtD,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAK7B;;;;OAIG;IACK,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEtC,6CAA6C;IACrC,SAAS,GAAG,KAAK,CAAC;IAE1B;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC3D,CAAC,CAAC,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QACrD,IAAI,OAAO,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;IAC7C,CAAC;IAED,8DAA8D;IAC9D,IAAc,OAAO;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,GAAG,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,KAAK,wBAAwB,CAC7D,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,2EAA2E;IACjE,OAAO;QACf,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IAC/D,SAAS;QACjB,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;;AAGH,SAAS,WAAW,CAAC,EAAe;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;QACvC,OAAO,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { ATTR_COLUMN_VALUE } from \"@loadbare/app/constants\";\n\n/**\n * A form-associated custom element wrapping one native control, which makes\n * the widget itself the control: the hub sets its `value` when a column\n * lands, reads it back when a request gathers, and commits it on `change`\n * when it carries `lb-request`. Nothing about a request is the widget's.\n *\n * The native control inside is an implementation detail. Its `change` is\n * stopped and fired again on the widget, so a listener sees one control and\n * one event per edit.\n *\n * Not a widget itself, so the file carries no `.browser` and no `lb-` name:\n * a consumer's builder passes it over, and each widget that extends it\n * brings it along.\n */\nexport abstract class WrappedControl extends HTMLElement {\n  static formAssociated = true;\n\n  /** The tag of the native control this widget wraps. */\n  protected abstract inner: string;\n\n  /**\n   * Null where the DOM implementation offers no form value, which includes\n   * jsdom: the widget still works as a control, and a native form submission\n   * leaves it out.\n   */\n  private internals = internalsOf(this);\n\n  /** Whether the widget has connected once. */\n  private connected = false;\n\n  constructor() {\n    super();\n    this.addEventListener(\"change\", (e) => {\n      if (e.target === this || e.target !== this.control) return;\n      e.stopPropagation();\n      this.changed();\n      this.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    });\n  }\n\n  /**\n   * A value that landed before this widget's definition did is only a\n   * stamp, since the hub sets `value` on a control and the element was not\n   * one yet. It is taken up the first time the widget connects, and never\n   * again: after that the hub sets `value` itself, and a later move must not\n   * undo an edit.\n   *\n   * The native control follows the widget's `form` attribute, so a form\n   * this widget joins by id resets the control inside it too.\n   */\n  connectedCallback(): void {\n    const form = this.getAttribute(\"form\");\n    if (form !== null) this.control?.setAttribute(\"form\", form);\n    if (this.connected) return;\n    this.connected = true;\n    const stamped = this.getAttribute(ATTR_COLUMN_VALUE);\n    if (stamped !== null) this.value = stamped;\n  }\n\n  /** The native control this widget wraps, once it is there. */\n  protected get control(): HTMLInputElement | HTMLSelectElement | null {\n    return this.querySelector(this.inner);\n  }\n\n  get value(): string {\n    return this.control?.value ?? \"\";\n  }\n\n  set value(value: string) {\n    const control = this.control;\n    if (!control) {\n      console.error(\n        `${this.localName}: no <${this.inner}> to receive the value`,\n      );\n      return;\n    }\n    control.value = value ?? \"\";\n    this.formValue();\n  }\n\n  /**\n   * The native control is the form's too, and the form resets it by HTML's\n   * own algorithm. This widget comes first in tree order, so it tells the\n   * form its value once the control has been reset.\n   */\n  formResetCallback(): void {\n    queueMicrotask(() => this.formValue());\n  }\n\n  /** The inner control changed, before the widget fires its own `change`. */\n  protected changed(): void {\n    this.formValue();\n  }\n\n  /** Tell the form owner the value, where the implementation allows it. */\n  protected formValue(): void {\n    this.internals?.setFormValue(this.value);\n  }\n}\n\nfunction internalsOf(el: HTMLElement): ElementInternals | null {\n  try {\n    const internals = el.attachInternals();\n    return typeof internals.setFormValue === \"function\" ? internals : null;\n  } catch {\n    return null;\n  }\n}\n"]}
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../widgets/control.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAI3B;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,cACpB,SAAQ,WAAW;IAGnB,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;IAK7B;;;;OAIG;IACK,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEtC;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC3D,CAAC,CAAC,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,8DAA8D;IAC9D,IAAc,OAAO;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,GAAG,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,KAAK,wBAAwB,CAC7D,CAAC;YACF,OAAO;QACT,CAAC;QACD,OAAO,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,cAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,OAAe;QAC/B,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,uDAAuD;IACvD,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,IAAI,CAAC;IAChD,CAAC;IAED,4DAA4D;IAC5D,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,EAAE,iBAAiB,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,2EAA2E;IACjE,OAAO;QACf,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,yEAAyE;IAC/D,SAAS;QACjB,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;;AAGH,SAAS,WAAW,CAAC,EAAe;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC;QACvC,OAAO,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport type { HubLifecycle } from \"@loadbare/app/types\";\n\n/**\n * A form-associated custom element wrapping one native control, which makes\n * the widget itself the control: the hub sets its `value` when a column\n * lands, reads it back when a request gathers, and commits it on `change`\n * when it carries `lb-request`. Nothing about a request is the widget's.\n *\n * The native control inside is an implementation detail. Its `change` is\n * stopped and fired again on the widget, so a listener sees one control and\n * one event per edit.\n *\n * Not a widget itself, so the file carries no `.browser` and no `lb-` name:\n * a consumer's builder passes it over, and each widget that extends it\n * brings it along.\n */\nexport abstract class WrappedControl\n  extends HTMLElement\n  implements HubLifecycle\n{\n  static formAssociated = true;\n\n  /** The tag of the native control this widget wraps. */\n  protected abstract inner: string;\n\n  /**\n   * Null where the DOM implementation offers no form value, which includes\n   * jsdom: the widget still works as a control, and a native form submission\n   * leaves it out.\n   */\n  private internals = internalsOf(this);\n\n  constructor() {\n    super();\n    this.addEventListener(\"change\", (e) => {\n      if (e.target === this || e.target !== this.control) return;\n      e.stopPropagation();\n      this.changed();\n      this.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    });\n  }\n\n  /**\n   * The native control follows the widget's `form` attribute, so a form\n   * this widget joins by id resets the control inside it too. An element\n   * around this one that joins it to a form does so in its own\n   * `lbAttached`, which the hub calls first.\n   */\n  lbAttached(): void {\n    const form = this.getAttribute(\"form\");\n    if (form !== null) this.control?.setAttribute(\"form\", form);\n  }\n\n  /** The native control this widget wraps, once it is there. */\n  protected get control(): HTMLInputElement | HTMLSelectElement | null {\n    return this.querySelector(this.inner);\n  }\n\n  get value(): string {\n    return this.control?.value ?? \"\";\n  }\n\n  set value(value: string) {\n    const control = this.control;\n    if (!control) {\n      console.error(\n        `${this.localName}: no <${this.inner}> to receive the value`,\n      );\n      return;\n    }\n    control.value = value ?? \"\";\n    this.formValue();\n  }\n\n  /**\n   * The native control is the form's too, and the form resets it by HTML's\n   * own algorithm. This widget comes first in tree order, so it tells the\n   * form its value once the control has been reset.\n   */\n  formResetCallback(): void {\n    queueMicrotask(() => this.formValue());\n  }\n\n  /**\n   * A message the hub sets when a handler refuses this control's column. It\n   * goes on the native control inside, which is what the form checks before\n   * it submits, what the browser shows the message beside, and what takes\n   * focus when it is reported.\n   */\n  setCustomValidity(message: string): void {\n    this.control?.setCustomValidity(message);\n  }\n\n  /** Show the native control's message, and focus it. */\n  reportValidity(): boolean {\n    return this.control?.reportValidity() ?? true;\n  }\n\n  /** The native control's message, empty when it has none. */\n  get validationMessage(): string {\n    return this.control?.validationMessage ?? \"\";\n  }\n\n  /** The inner control changed, before the widget fires its own `change`. */\n  protected changed(): void {\n    this.formValue();\n  }\n\n  /** Tell the form owner the value, where the implementation allows it. */\n  protected formValue(): void {\n    this.internals?.setFormValue(this.value);\n  }\n}\n\nfunction internalsOf(el: HTMLElement): ElementInternals | null {\n  try {\n    const internals = el.attachInternals();\n    return typeof internals.setFormValue === \"function\" ? internals : null;\n  } catch {\n    return null;\n  }\n}\n"]}

package/dist/index.d.ts

@@ -4,6 +4,5 @@ import "./lb-options.browser.js";
 import "./lb-table.browser.js";
 import "./lb-picker.browser.js";
 import "./lb-confirm.browser.js";
-import "./lb-form.browser.js";
 import "./lb-insert-dialog.browser.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../widgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../widgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,+BAA+B,CAAC"}

package/dist/index.js

@@ -4,6 +4,5 @@ import "./lb-options.browser.js";
 import "./lb-table.browser.js";
 import "./lb-picker.browser.js";
 import "./lb-confirm.browser.js";
-import "./lb-form.browser.js";
 import "./lb-insert-dialog.browser.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../widgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,+BAA+B,CAAC","sourcesContent":["import \"./lb-input.browser.js\";\nimport \"./lb-select.browser.js\";\nimport \"./lb-options.browser.js\";\nimport \"./lb-table.browser.js\";\nimport \"./lb-picker.browser.js\";\nimport \"./lb-confirm.browser.js\";\nimport \"./lb-form.browser.js\";\nimport \"./lb-insert-dialog.browser.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../widgets/index.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AACjC,OAAO,+BAA+B,CAAC","sourcesContent":["import \"./lb-input.browser.js\";\nimport \"./lb-select.browser.js\";\nimport \"./lb-options.browser.js\";\nimport \"./lb-table.browser.js\";\nimport \"./lb-picker.browser.js\";\nimport \"./lb-confirm.browser.js\";\nimport \"./lb-insert-dialog.browser.js\";\n"]}

package/dist/lb-checkbox.html

@@ -0,0 +1,13 @@
+<!--
+  A checkbox with its label, as markup alone. The hub treats a native
+  checkbox as a control, so there is nothing for script to do: the widget
+  gives the box and its text one element an application styles.
+
+  The column and request go on the checkbox inside, since that is the
+  control, so they arrive as exp-column and exp-request rather than as
+  lb-column and lb-request on the tag.
+-->
+<label>
+  <input type="checkbox" lb-column="{{column}}" lb-request="{{request}}" />
+  <span>{{label}}</span>
+</label>

package/dist/lb-confirm.browser.js

@@ -1,5 +1,4 @@
 /// <reference lib="dom" />
-import { LB_DONE_EVENT_NAME } from "@loadbare/app/constants";
 /**
  * Opens and closes its own dialog, and nothing else.
  *
@@ -8,8 +7,8 @@ import { LB_DONE_EVENT_NAME } from "@loadbare/app/constants";
  * own `commandfor` would open it with no script, but only by id.
  *
  * The confirm button carries `lb-request`, and the hub commits it. This code
- * never touches the request; it closes the dialog when `lb-request-done` says
- * the request succeeded. A refused request leaves the dialog open, with the
+ * never touches the request; it closes the dialog when the hub says the
+ * request succeeded. A refused request leaves the dialog open, with the
  * hub's `lb-request-error` on the confirm button, so the user sees the
  * refusal where they asked and can cancel or try again.
  */
@@ -23,14 +22,15 @@ class LbConfirm extends HTMLElement {
             else if (target.closest("[data-close]"))
                 this.dialog.close();
         });
-        this.addEventListener(LB_DONE_EVENT_NAME, (e) => {
-            if (!e.detail.error)
-                this.dialog.close();
-        });
+    }
+    lbRequestDone({ error }) {
+        if (!error)
+            this.dialog.close();
     }
     get dialog() {
         return this.querySelector("dialog");
     }
 }
 customElements.define("lb-confirm", LbConfirm);
+export {};
 //# sourceMappingURL=lb-confirm.browser.js.map

package/dist/lb-confirm.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"lb-confirm.browser.js","sourceRoot":"","sources":["../widgets/lb-confirm.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;;;;;;;;;;;GAYG;AACH,MAAM,SAAU,SAAQ,WAAW;IACjC;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAiB,CAAC;YACnC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;iBACtD,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC9C,IAAI,CAAE,CAAiC,CAAC,MAAM,CAAC,KAAK;gBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAE,CAAC;IACvC,CAAC;CACF;AAED,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { LB_DONE_EVENT_NAME } from \"@loadbare/app/constants\";\nimport type { HubRequestDone } from \"@loadbare/app/types\";\n\n/**\n * Opens and closes its own dialog, and nothing else.\n *\n * The dialog is found by position rather than by id, because ids repeat when\n * the tag sits in a row template and the hub clones it once per row. HTML's\n * own `commandfor` would open it with no script, but only by id.\n *\n * The confirm button carries `lb-request`, and the hub commits it. This code\n * never touches the request; it closes the dialog when `lb-request-done` says\n * the request succeeded. A refused request leaves the dialog open, with the\n * hub's `lb-request-error` on the confirm button, so the user sees the\n * refusal where they asked and can cancel or try again.\n */\nclass LbConfirm extends HTMLElement {\n  constructor() {\n    super();\n    this.addEventListener(\"click\", (e) => {\n      const target = e.target as Element;\n      if (target.closest(\"[data-open]\")) this.dialog.showModal();\n      else if (target.closest(\"[data-close]\")) this.dialog.close();\n    });\n    this.addEventListener(LB_DONE_EVENT_NAME, (e) => {\n      if (!(e as CustomEvent<HubRequestDone>).detail.error) this.dialog.close();\n    });\n  }\n\n  private get dialog(): HTMLDialogElement {\n    return this.querySelector(\"dialog\")!;\n  }\n}\n\ncustomElements.define(\"lb-confirm\", LbConfirm);\n"]}
+{"version":3,"file":"lb-confirm.browser.js","sourceRoot":"","sources":["../widgets/lb-confirm.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAI3B;;;;;;;;;;;;GAYG;AACH,MAAM,SAAU,SAAQ,WAAW;IACjC;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAiB,CAAC;YACnC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;iBACtD,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,EAAE,KAAK,EAAkB;QACrC,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAED,IAAY,MAAM;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAE,CAAC;IACvC,CAAC;CACF;AAED,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport type { HubLifecycle, HubRequestDone } from \"@loadbare/app/types\";\n\n/**\n * Opens and closes its own dialog, and nothing else.\n *\n * The dialog is found by position rather than by id, because ids repeat when\n * the tag sits in a row template and the hub clones it once per row. HTML's\n * own `commandfor` would open it with no script, but only by id.\n *\n * The confirm button carries `lb-request`, and the hub commits it. This code\n * never touches the request; it closes the dialog when the hub says the\n * request succeeded. A refused request leaves the dialog open, with the\n * hub's `lb-request-error` on the confirm button, so the user sees the\n * refusal where they asked and can cancel or try again.\n */\nclass LbConfirm extends HTMLElement implements HubLifecycle {\n  constructor() {\n    super();\n    this.addEventListener(\"click\", (e) => {\n      const target = e.target as Element;\n      if (target.closest(\"[data-open]\")) this.dialog.showModal();\n      else if (target.closest(\"[data-close]\")) this.dialog.close();\n    });\n  }\n\n  lbRequestDone({ error }: HubRequestDone): void {\n    if (!error) this.dialog.close();\n  }\n\n  private get dialog(): HTMLDialogElement {\n    return this.querySelector(\"dialog\")!;\n  }\n}\n\ncustomElements.define(\"lb-confirm\", LbConfirm);\n"]}

package/dist/lb-insert-dialog.browser.js

@@ -1,17 +1,15 @@
 /// <reference lib="dom" />
-import { LB_DONE_EVENT_NAME } from "@loadbare/app/constants";
 /**
  * Two rules. Closing the dialog resets the form, and the row the form creates
  * is chosen in the picker the dialog was opened from.
  *
- * Save closes the dialog when `lb-request-done` says the insert succeeded,
- * so there is a row to show for it, and a refusal leaves the entry open to
- * correct. Cancel and Escape close it, and throw away what was typed.
+ * Save closes the dialog when the hub says the insert succeeded, so there
+ * is a row to show for it, and a refusal leaves the entry open to correct. Cancel and Escape close it, and throw away what was typed.
  *
  * The picker is the nearest `lb-options` around the button that opened the
  * dialog, which a `command` event names as its `source`. The new row's key is
- * in the patch the insert answers with, and by the time `lb-request-done`
- * reaches here that row is among the picker's options. Choosing it fires
+ * in the patch the insert answers with, and by the time the hub calls
+ * `lbRequestDone` that row is among the picker's options. Choosing it fires
  * `change`, so a picker that saves its own column saves it, and one in a ghost
  * row or a new record holds it until Save.
  *
@@ -26,17 +24,15 @@ class LbInsertDialog extends HTMLElement {
         this.addEventListener("command", (e) => {
             this.opener = e.source ?? null;
         }, true);
-        this.addEventListener(LB_DONE_EVENT_NAME, (e) => {
-            const { request, items, error } = e
-                .detail;
-            if (error)
-                return;
-            const item = items.find((i) => i.query === request.query);
-            const created = item?.patch?.rows?.[0];
-            if (created)
-                this.choose(String(created[item.key]));
-            this.querySelector("dialog")?.close();
-        });
+    }
+    lbRequestDone({ request, items, error }) {
+        if (error)
+            return;
+        const item = items.find((i) => i.query === request.query);
+        const created = item?.patch?.rows?.[0];
+        if (created)
+            this.choose(String(created[item.key]));
+        this.querySelector("dialog")?.close();
     }
     choose(key) {
         const picker = pickerNear(this.opener);
@@ -56,4 +52,5 @@ function pickerNear(el) {
     return null;
 }
 customElements.define("lb-insert-dialog", LbInsertDialog);
+export {};
 //# sourceMappingURL=lb-insert-dialog.browser.js.map

package/dist/lb-insert-dialog.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"lb-insert-dialog.browser.js","sourceRoot":"","sources":["../widgets/lb-insert-dialog.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,cAAe,SAAQ,WAAW;IACtC,8CAA8C;IACtC,MAAM,GAAmB,IAAI,CAAC;IAEtC;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CACnB,OAAO,EACP,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EACzC,IAAI,CACL,CAAC;QACF,IAAI,CAAC,gBAAgB,CACnB,SAAS,EACT,CAAC,CAAC,EAAE,EAAE;YACJ,IAAI,CAAC,MAAM,GAAI,CAAyC,CAAC,MAAM,IAAI,IAAI,CAAC;QAC1E,CAAC,EACD,IAAI,CACL,CAAC;QACF,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC9C,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAI,CAAiC;iBACjE,MAAM,CAAC;YACV,IAAI,KAAK;gBAAE,OAAO;YAClB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,OAAO;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACnB,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,qEAAqE;AACrE,SAAS,UAAU,CACjB,EAAkB;IAElB,KAAK,IAAI,IAAI,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,KAAK;YAAE,OAAO,KAAwC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,cAAc,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { LB_DONE_EVENT_NAME } from \"@loadbare/app/constants\";\nimport type { HubRequestDone } from \"@loadbare/app/types\";\n\n/**\n * Two rules. Closing the dialog resets the form, and the row the form creates\n * is chosen in the picker the dialog was opened from.\n *\n * Save closes the dialog when `lb-request-done` says the insert succeeded,\n * so there is a row to show for it, and a refusal leaves the entry open to\n * correct. Cancel and Escape close it, and throw away what was typed.\n *\n * The picker is the nearest `lb-options` around the button that opened the\n * dialog, which a `command` event names as its `source`. The new row's key is\n * in the patch the insert answers with, and by the time `lb-request-done`\n * reaches here that row is among the picker's options. Choosing it fires\n * `change`, so a picker that saves its own column saves it, and one in a ghost\n * row or a new record holds it until Save.\n *\n * `close` and `command` do not bubble, so they are heard in capture.\n */\nclass LbInsertDialog extends HTMLElement {\n  /** The button that last opened the dialog. */\n  private opener: Element | null = null;\n\n  constructor() {\n    super();\n    this.addEventListener(\n      \"close\",\n      () => this.querySelector(\"form\")?.reset(),\n      true,\n    );\n    this.addEventListener(\n      \"command\",\n      (e) => {\n        this.opener = (e as Event & { source?: Element | null }).source ?? null;\n      },\n      true,\n    );\n    this.addEventListener(LB_DONE_EVENT_NAME, (e) => {\n      const { request, items, error } = (e as CustomEvent<HubRequestDone>)\n        .detail;\n      if (error) return;\n      const item = items.find((i) => i.query === request.query);\n      const created = item?.patch?.rows?.[0];\n      if (created) this.choose(String(created[item!.key]));\n      this.querySelector(\"dialog\")?.close();\n    });\n  }\n\n  private choose(key: string): void {\n    const picker = pickerNear(this.opener);\n    if (!picker) return;\n    picker.value = key;\n    picker.dispatchEvent(new Event(\"change\", { bubbles: true }));\n  }\n}\n\n/** The nearest `lb-options` around an element, searching outward. */\nfunction pickerNear(\n  el: Element | null,\n): (HTMLElement & { value: string }) | null {\n  for (let node = el?.parentElement; node; node = node.parentElement) {\n    const found = node.querySelector(\"lb-options\");\n    if (found) return found as HTMLElement & { value: string };\n  }\n  return null;\n}\n\ncustomElements.define(\"lb-insert-dialog\", LbInsertDialog);\n"]}
+{"version":3,"file":"lb-insert-dialog.browser.js","sourceRoot":"","sources":["../widgets/lb-insert-dialog.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAI3B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,cAAe,SAAQ,WAAW;IACtC,8CAA8C;IACtC,MAAM,GAAmB,IAAI,CAAC;IAEtC;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CACnB,OAAO,EACP,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EACzC,IAAI,CACL,CAAC;QACF,IAAI,CAAC,gBAAgB,CACnB,SAAS,EACT,CAAC,CAAC,EAAE,EAAE;YACJ,IAAI,CAAC,MAAM,GAAI,CAAyC,CAAC,MAAM,IAAI,IAAI,CAAC;QAC1E,CAAC,EACD,IAAI,CACL,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAkB;QACrD,IAAI,KAAK;YAAE,OAAO;QAClB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;QACnB,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,qEAAqE;AACrE,SAAS,UAAU,CACjB,EAAkB;IAElB,KAAK,IAAI,IAAI,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,KAAK;YAAE,OAAO,KAAwC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,cAAc,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport type { HubLifecycle, HubRequestDone } from \"@loadbare/app/types\";\n\n/**\n * Two rules. Closing the dialog resets the form, and the row the form creates\n * is chosen in the picker the dialog was opened from.\n *\n * Save closes the dialog when the hub says the insert succeeded, so there\n * is a row to show for it, and a refusal leaves the entry open to correct. Cancel and Escape close it, and throw away what was typed.\n *\n * The picker is the nearest `lb-options` around the button that opened the\n * dialog, which a `command` event names as its `source`. The new row's key is\n * in the patch the insert answers with, and by the time the hub calls\n * `lbRequestDone` that row is among the picker's options. Choosing it fires\n * `change`, so a picker that saves its own column saves it, and one in a ghost\n * row or a new record holds it until Save.\n *\n * `close` and `command` do not bubble, so they are heard in capture.\n */\nclass LbInsertDialog extends HTMLElement implements HubLifecycle {\n  /** The button that last opened the dialog. */\n  private opener: Element | null = null;\n\n  constructor() {\n    super();\n    this.addEventListener(\n      \"close\",\n      () => this.querySelector(\"form\")?.reset(),\n      true,\n    );\n    this.addEventListener(\n      \"command\",\n      (e) => {\n        this.opener = (e as Event & { source?: Element | null }).source ?? null;\n      },\n      true,\n    );\n  }\n\n  lbRequestDone({ request, items, error }: HubRequestDone): void {\n    if (error) return;\n    const item = items.find((i) => i.query === request.query);\n    const created = item?.patch?.rows?.[0];\n    if (created) this.choose(String(created[item!.key]));\n    this.querySelector(\"dialog\")?.close();\n  }\n\n  private choose(key: string): void {\n    const picker = pickerNear(this.opener);\n    if (!picker) return;\n    picker.value = key;\n    picker.dispatchEvent(new Event(\"change\", { bubbles: true }));\n  }\n}\n\n/** The nearest `lb-options` around an element, searching outward. */\nfunction pickerNear(\n  el: Element | null,\n): (HTMLElement & { value: string }) | null {\n  for (let node = el?.parentElement; node; node = node.parentElement) {\n    const found = node.querySelector(\"lb-options\");\n    if (found) return found as HTMLElement & { value: string };\n  }\n  return null;\n}\n\ncustomElements.define(\"lb-insert-dialog\", LbInsertDialog);\n"]}

package/dist/lb-master.html

@@ -9,8 +9,10 @@
   belongs to.
 
   The standard bar is [New] [Copy] [Delete] [Save new] [Cancel].
-  - New is not here: a button cannot write a query parm, only a control's
-    change can. Choosing the picker's blank does the same today.
+  - New is a request the page declares, `new`. Which row shows is a query
+    parm, and a button writes none, so the page's handler returns url()
+    emptying the parm, and the row query answers a row not yet entered.
+    It pushes a history entry, so Back returns to the row on record.
   - Copy is a request the page declares, `copy`. It goes to the server by
     design rather than filling the form for Save new: a copy is a new row in
     the set, and only the server can bring its children along. What comes
@@ -25,6 +27,9 @@
   <div class="lb-master-row" lb-query="{{row}}">
     <lb-form exp-id="{{form-id|master-form}}" lb-exp-slot></lb-form>
     <div class="lb-master-buttons">
+      <button type="button" lb-request="new" lb-url-push data-mode="on-record">
+        New
+      </button>
       <button type="button" lb-request="copy" data-mode="on-record">Copy</button>
       <lb-confirm
         exp-label="Delete"

package/dist/lb-options.browser.d.ts

@@ -1,4 +1,4 @@
-import type { RowsHost } from "@loadbare/app/types";
+import type { HubLifecycle } from "@loadbare/app/types";
 import { WrappedControl } from "./control.js";
 /**
  * A `<select>` whose choices are the rows of the query it names.
@@ -26,7 +26,7 @@ import { WrappedControl } from "./control.js";
  * Exported because `lb-picker` is this widget with its row template supplied
  * by the definition instead of by the page.
  */
-export declare class LbOptions extends WrappedControl implements RowsHost {
+export declare class LbOptions extends WrappedControl implements HubLifecycle {
     protected inner: string;
     /**
      * The value last set or chosen, which the options may not include yet.

package/dist/lb-options.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lb-options.browser.d.ts","sourceRoot":"","sources":["../widgets/lb-options.browser.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,qBAAa,SAAU,SAAQ,cAAe,YAAW,QAAQ;IAC/D,SAAS,CAAC,KAAK,SAAY;IAE3B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAuB;IAErC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAGtB;IAED,iBAAiB,IAAI,IAAI;IAKzB,SAAS,CAAC,OAAO,IAAI,IAAI;IAKzB,0EAA0E;IAC1E,YAAY,IAAI,IAAI;CAcrB"}
+{"version":3,"file":"lb-options.browser.d.ts","sourceRoot":"","sources":["../widgets/lb-options.browser.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,qBAAa,SAAU,SAAQ,cAAe,YAAW,YAAY;IACnE,SAAS,CAAC,KAAK,SAAY;IAE3B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAuB;IAErC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAGtB;IAED,iBAAiB,IAAI,IAAI;IAKzB,SAAS,CAAC,OAAO,IAAI,IAAI;IAKzB,0EAA0E;IAC1E,YAAY,IAAI,IAAI;CAcrB"}

package/dist/lb-options.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"lb-options.browser.js","sourceRoot":"","sources":["../widgets/lb-options.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,QAAQ,GACT,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,OAAO,SAAU,SAAQ,cAAc;IACjC,KAAK,GAAG,QAAQ,CAAC;IAE3B;;;OAGG;IACK,MAAM,GAAkB,IAAI,CAAC;IAErC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;IAES,OAAO;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;QAC1C,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED,0EAA0E;IAC1E,YAAY;QACV,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,SAAS,QAAQ,EAAE,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,cAAc,CAAE,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CACvC,WAAW,UAAU,EAAE,CACxB,EAAE,CAAC;YACF,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC3D,CAAC;QACD,iEAAiE;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;CACF;AAED,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport {\n  ATTR_GROUP_VALUE,\n  ATTR_KEY_VALUE,\n  LIVE_GROUP,\n  LIVE_ROW,\n} from \"@loadbare/app/constants\";\nimport type { RowsHost } from \"@loadbare/app/types\";\nimport { WrappedControl } from \"./control.js\";\n\n/**\n * A `<select>` whose choices are the rows of the query it names.\n *\n * The hub places the options by the query's order, and a group template\n * holding an `<optgroup>` puts them in groups. What landing does not give an\n * `<optgroup>` is its label, so the widget sets it from the `lb-group-value`\n * the hub stamps on it.\n *\n * The identity of a row is the value of its option, so the `lb-key-value` the\n * hub stamps on each option is copied to its `value`. The key column is the\n * one the server declared for the query; the page never names it.\n *\n * It is two things at once, and the hub keeps them apart: its own `lb-query`\n * names the rows it offers, and its `lb-column` is a column of the row around\n * it, which is what it holds and what it sends. As a control it is\n * form-associated, with a `value` and a `change` of its own, so the hub lands\n * that column on `value` and commits `lb-request` on `change`.\n *\n * The value is held here as well as on the select. A `<select>` does not hold\n * a value it has no option for: it selects nothing and forgets it. The value\n * and the choices are two answers that land in either order, so the held\n * value is put on the select again whenever rows land.\n *\n * Exported because `lb-picker` is this widget with its row template supplied\n * by the definition instead of by the page.\n */\n\nexport class LbOptions extends WrappedControl implements RowsHost {\n  protected inner = \"select\";\n\n  /**\n   * The value last set or chosen, which the options may not include yet.\n   * Null when nothing chose one, so the select's own default stands.\n   */\n  private chosen: string | null = null;\n\n  get value(): string {\n    return this.chosen ?? super.value;\n  }\n\n  set value(value: string) {\n    this.chosen = value === null || value === undefined ? null : String(value);\n    super.value = value;\n  }\n\n  formResetCallback(): void {\n    this.chosen = null;\n    super.formResetCallback();\n  }\n\n  protected changed(): void {\n    this.chosen = this.control?.value ?? null;\n    super.changed();\n  }\n\n  /** Everything derived from the rows, once the whole answer has landed. */\n  lbRowsLanded(): void {\n    for (const option of this.querySelectorAll(`option${LIVE_ROW}`)) {\n      option.setAttribute(\"value\", option.getAttribute(ATTR_KEY_VALUE)!);\n    }\n    for (const group of this.querySelectorAll<HTMLOptGroupElement>(\n      `optgroup${LIVE_GROUP}`,\n    )) {\n      group.label = group.getAttribute(ATTR_GROUP_VALUE) ?? \"\";\n    }\n    // After the values above, since the select matches against them.\n    const select = this.querySelector(\"select\");\n    if (select && this.chosen !== null) select.value = this.chosen;\n    this.formValue();\n  }\n}\n\ncustomElements.define(\"lb-options\", LbOptions);\n"]}
+{"version":3,"file":"lb-options.browser.js","sourceRoot":"","sources":["../widgets/lb-options.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,QAAQ,GACT,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,OAAO,SAAU,SAAQ,cAAc;IACjC,KAAK,GAAG,QAAQ,CAAC;IAE3B;;;OAGG;IACK,MAAM,GAAkB,IAAI,CAAC;IAErC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,CAAC,KAAa;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;IAES,OAAO;QACf,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC;QAC1C,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAED,0EAA0E;IAC1E,YAAY;QACV,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,SAAS,QAAQ,EAAE,CAAC,EAAE,CAAC;YAChE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,cAAc,CAAE,CAAC,CAAC;QACrE,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CACvC,WAAW,UAAU,EAAE,CACxB,EAAE,CAAC;YACF,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;QAC3D,CAAC;QACD,iEAAiE;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;CACF;AAED,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport {\n  ATTR_GROUP_VALUE,\n  ATTR_KEY_VALUE,\n  LIVE_GROUP,\n  LIVE_ROW,\n} from \"@loadbare/app/constants\";\nimport type { HubLifecycle } from \"@loadbare/app/types\";\nimport { WrappedControl } from \"./control.js\";\n\n/**\n * A `<select>` whose choices are the rows of the query it names.\n *\n * The hub places the options by the query's order, and a group template\n * holding an `<optgroup>` puts them in groups. What landing does not give an\n * `<optgroup>` is its label, so the widget sets it from the `lb-group-value`\n * the hub stamps on it.\n *\n * The identity of a row is the value of its option, so the `lb-key-value` the\n * hub stamps on each option is copied to its `value`. The key column is the\n * one the server declared for the query; the page never names it.\n *\n * It is two things at once, and the hub keeps them apart: its own `lb-query`\n * names the rows it offers, and its `lb-column` is a column of the row around\n * it, which is what it holds and what it sends. As a control it is\n * form-associated, with a `value` and a `change` of its own, so the hub lands\n * that column on `value` and commits `lb-request` on `change`.\n *\n * The value is held here as well as on the select. A `<select>` does not hold\n * a value it has no option for: it selects nothing and forgets it. The value\n * and the choices are two answers that land in either order, so the held\n * value is put on the select again whenever rows land.\n *\n * Exported because `lb-picker` is this widget with its row template supplied\n * by the definition instead of by the page.\n */\n\nexport class LbOptions extends WrappedControl implements HubLifecycle {\n  protected inner = \"select\";\n\n  /**\n   * The value last set or chosen, which the options may not include yet.\n   * Null when nothing chose one, so the select's own default stands.\n   */\n  private chosen: string | null = null;\n\n  get value(): string {\n    return this.chosen ?? super.value;\n  }\n\n  set value(value: string) {\n    this.chosen = value === null || value === undefined ? null : String(value);\n    super.value = value;\n  }\n\n  formResetCallback(): void {\n    this.chosen = null;\n    super.formResetCallback();\n  }\n\n  protected changed(): void {\n    this.chosen = this.control?.value ?? null;\n    super.changed();\n  }\n\n  /** Everything derived from the rows, once the whole answer has landed. */\n  lbRowsLanded(): void {\n    for (const option of this.querySelectorAll(`option${LIVE_ROW}`)) {\n      option.setAttribute(\"value\", option.getAttribute(ATTR_KEY_VALUE)!);\n    }\n    for (const group of this.querySelectorAll<HTMLOptGroupElement>(\n      `optgroup${LIVE_GROUP}`,\n    )) {\n      group.label = group.getAttribute(ATTR_GROUP_VALUE) ?? \"\";\n    }\n    // After the values above, since the select matches against them.\n    const select = this.querySelector(\"select\");\n    if (select && this.chosen !== null) select.value = this.chosen;\n    this.formValue();\n  }\n}\n\ncustomElements.define(\"lb-options\", LbOptions);\n"]}

package/dist/lb-table.browser.js

@@ -1,5 +1,5 @@
 /// <reference lib="dom" />
-import { ATTR_COLUMN, ATTR_ROW_REQUESTED, LB_DONE_EVENT_NAME, REQUEST_ROW_INSERT, REQUESTED_CREATED, REQUESTED_MOVED, } from "@loadbare/app/constants";
+import { ATTR_COLUMN, ATTR_ROW_REQUESTED, REQUEST_ROW_INSERT, REQUESTED_CREATED, REQUESTED_MOVED, } from "@loadbare/app/constants";
 /**
  * A table that owns its own scaffolding.
  *
@@ -36,27 +36,9 @@ const GHOST = "data-ghost";
 /** Ghost row forms need ids for the `form` attribute; any unique one will do. */
 let ghostForms = 0;
 class LbTable extends HTMLElement {
-    /**
-     * A ghost row is for entering the next row, so once one is saved the
-     * cursor goes back to the start of it. `lb-request-done` comes after the
-     * response items have landed, so nothing the hub places afterwards takes
-     * the focus away again. A refused insert leaves the cursor where the user
-     * left it.
-     */
-    constructor() {
-        super();
-        this.addEventListener(LB_DONE_EVENT_NAME, (e) => {
-            const { request, error } = e.detail;
-            if (error || request.name !== REQUEST_ROW_INSERT)
-                return;
-            const row = e.target.closest(`[${GHOST}]`);
-            if (row)
-                firstControl(row)?.focus();
-        });
-    }
-    connectedCallback() {
+    lbAttached() {
         const ghost = this.querySelector(`tbody[${GHOST}]`);
-        if (!ghost?.firstElementChild || this.ghostForm())
+        if (!ghost?.firstElementChild)
             return;
         const form = document.createElement("form");
         form.id = `ghost-row-${++ghostForms}`;
@@ -71,9 +53,19 @@ class LbTable extends HTMLElement {
         this.querySelector(`[${ATTR_ROW_REQUESTED}="${REQUESTED_CREATED}"], ` +
             `[${ATTR_ROW_REQUESTED}="${REQUESTED_MOVED}"]`)?.scrollIntoView({ block: "nearest" });
     }
-    /** The ghost row's form, once this table has made it. */
-    ghostForm() {
-        return this.querySelector(":scope > form");
+    /**
+     * A ghost row is for entering the next row, so once one is saved the
+     * cursor goes back to the start of it. The hub calls this after the
+     * response items have landed, so nothing it places afterwards takes the
+     * focus away again. A refused insert leaves the cursor where the user left
+     * it.
+     */
+    lbRequestDone({ request, error }, origin) {
+        if (error || request.name !== REQUEST_ROW_INSERT)
+            return;
+        const row = origin.closest(`[${GHOST}]`);
+        if (row)
+            firstControl(row)?.focus();
     }
 }
 /**

package/dist/lb-table.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"lb-table.browser.js","sourceRoot":"","sources":["../widgets/lb-table.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,KAAK,GAAG,YAAY,CAAC;AAE3B,iFAAiF;AACjF,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,MAAM,OAAQ,SAAQ,WAAW;IAC/B;;;;;;OAMG;IACH;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC9C,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAI,CAAiC,CAAC,MAAM,CAAC;YACrE,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB;gBAAE,OAAO;YACzD,MAAM,GAAG,GAAI,CAAC,CAAC,MAAkB,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;YACxD,IAAI,GAAG;gBAAE,YAAY,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,iBAAiB,IAAI,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAE1D,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,GAAG,aAAa,EAAE,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,gBAAgB,CAAC,IAAI,WAAW,WAAW,CAAC,EAAE,CAAC;YACpE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,YAAY;QACV,IAAI,CAAC,aAAa,CAChB,IAAI,kBAAkB,KAAK,iBAAiB,MAAM;YAChD,IAAI,kBAAkB,KAAK,eAAe,IAAI,CACjD,EAAE,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,yDAAyD;IACjD,SAAS;QACf,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;IAC7C,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAY;IAChC,OAAO;QACL,GAAG,GAAG,CAAC,gBAAgB,CACrB,8CAA8C,CAC/C;KACF,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,eAAe,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport {\n  ATTR_COLUMN,\n  ATTR_ROW_REQUESTED,\n  LB_DONE_EVENT_NAME,\n  REQUEST_ROW_INSERT,\n  REQUESTED_CREATED,\n  REQUESTED_MOVED,\n} from \"@loadbare/app/constants\";\nimport type { HubRequestDone, RowsHost } from \"@loadbare/app/types\";\n\n/**\n * A table that owns its own scaffolding.\n *\n * A plain `<table lb-query>` with a row template inside it needs no widget at\n * all. This one supplies the table, and the developer writes what only the\n * page knows: the heading row and the row template. That division is forced\n * rather than chosen — a `<thead>` written inside a custom element is not\n * inside a table, so the parser drops the tag and keeps the text. A\n * `<template>` survives anywhere, so the heading row arrives wrapped and\n * expansion unwraps it into the `lb-exp-template` destination beside the slot.\n *\n * Placement and groups are the hub's, by the query's order and the page's\n * group templates. What this widget adds at run time is the ghost row, and\n * scrolling to the row the page's own request created or moved.\n *\n * The `foot` destination needs no code here. A `<tfoot>` is a place on the\n * page, not a row the hub delivers, so what lands in it is an aggregate or a\n * `row` query of its own, named on its `<tr>`.\n */\n\n/**\n * The ghost row's `<tbody>`, a blank row for entering a new one, between the\n * rows and the footer. The page writes it as the `ghost` template, so it\n * ships in the document like the heading and the footer, and the hub lands\n * on whatever in it names a query. It is not a live row: the hub never\n * reconciles it and never counts it.\n *\n * A `<form>` cannot wrap a `<tr>`, so the widget makes one outside the table\n * and joins the row's controls and buttons to it with the HTML `form`\n * attribute. Sending is the page's: a button in the row carrying\n * `lb-row-insert` submits that form, and the hub gathers what the form owns.\n * The hub resets the form once the insert succeeds.\n */\nconst GHOST = \"data-ghost\";\n\n/** Ghost row forms need ids for the `form` attribute; any unique one will do. */\nlet ghostForms = 0;\n\nclass LbTable extends HTMLElement implements RowsHost {\n  /**\n   * A ghost row is for entering the next row, so once one is saved the\n   * cursor goes back to the start of it. `lb-request-done` comes after the\n   * response items have landed, so nothing the hub places afterwards takes\n   * the focus away again. A refused insert leaves the cursor where the user\n   * left it.\n   */\n  constructor() {\n    super();\n    this.addEventListener(LB_DONE_EVENT_NAME, (e) => {\n      const { request, error } = (e as CustomEvent<HubRequestDone>).detail;\n      if (error || request.name !== REQUEST_ROW_INSERT) return;\n      const row = (e.target as Element).closest(`[${GHOST}]`);\n      if (row) firstControl(row)?.focus();\n    });\n  }\n\n  connectedCallback(): void {\n    const ghost = this.querySelector(`tbody[${GHOST}]`);\n    if (!ghost?.firstElementChild || this.ghostForm()) return;\n\n    const form = document.createElement(\"form\");\n    form.id = `ghost-row-${++ghostForms}`;\n    form.hidden = true;\n    this.append(form);\n    for (const el of ghost.querySelectorAll(`[${ATTR_COLUMN}], button`)) {\n      el.setAttribute(\"form\", form.id);\n    }\n  }\n\n  /** The row this page's request created or moved, brought into view. */\n  lbRowsLanded(): void {\n    this.querySelector(\n      `[${ATTR_ROW_REQUESTED}=\"${REQUESTED_CREATED}\"], ` +\n        `[${ATTR_ROW_REQUESTED}=\"${REQUESTED_MOVED}\"]`,\n    )?.scrollIntoView({ block: \"nearest\" });\n  }\n\n  /** The ghost row's form, once this table has made it. */\n  private ghostForm(): HTMLFormElement | null {\n    return this.querySelector(\":scope > form\");\n  }\n}\n\n/**\n * The first control in a row the user can type into or choose from. A\n * control a widget wraps is found inside it, since the wrapper takes no focus.\n */\nfunction firstControl(row: Element): HTMLElement | undefined {\n  return [\n    ...row.querySelectorAll<HTMLElement>(\n      'input:not([type=\"hidden\"]), select, textarea',\n    ),\n  ].find((el) => !el.matches(\":disabled\") && el.checkVisibility?.() !== false);\n}\n\ncustomElements.define(\"lb-table\", LbTable);\n"]}
+{"version":3,"file":"lb-table.browser.js","sourceRoot":"","sources":["../widgets/lb-table.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,KAAK,GAAG,YAAY,CAAC;AAE3B,iFAAiF;AACjF,IAAI,UAAU,GAAG,CAAC,CAAC;AAEnB,MAAM,OAAQ,SAAQ,WAAW;IAC/B,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,iBAAiB;YAAE,OAAO;QAEtC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,GAAG,aAAa,EAAE,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,gBAAgB,CAAC,IAAI,WAAW,WAAW,CAAC,EAAE,CAAC;YACpE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,YAAY;QACV,IAAI,CAAC,aAAa,CAChB,IAAI,kBAAkB,KAAK,iBAAiB,MAAM;YAChD,IAAI,kBAAkB,KAAK,eAAe,IAAI,CACjD,EAAE,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,EAAE,KAAK,EAAkB,EAAE,MAAe;QAC/D,IAAI,KAAK,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB;YAAE,OAAO;QACzD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,YAAY,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAY;IAChC,OAAO;QACL,GAAG,GAAG,CAAC,gBAAgB,CACrB,8CAA8C,CAC/C;KACF,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,eAAe,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport {\n  ATTR_COLUMN,\n  ATTR_ROW_REQUESTED,\n  REQUEST_ROW_INSERT,\n  REQUESTED_CREATED,\n  REQUESTED_MOVED,\n} from \"@loadbare/app/constants\";\nimport type { HubLifecycle, HubRequestDone } from \"@loadbare/app/types\";\n\n/**\n * A table that owns its own scaffolding.\n *\n * A plain `<table lb-query>` with a row template inside it needs no widget at\n * all. This one supplies the table, and the developer writes what only the\n * page knows: the heading row and the row template. That division is forced\n * rather than chosen — a `<thead>` written inside a custom element is not\n * inside a table, so the parser drops the tag and keeps the text. A\n * `<template>` survives anywhere, so the heading row arrives wrapped and\n * expansion unwraps it into the `lb-exp-template` destination beside the slot.\n *\n * Placement and groups are the hub's, by the query's order and the page's\n * group templates. What this widget adds at run time is the ghost row, and\n * scrolling to the row the page's own request created or moved.\n *\n * The `foot` destination needs no code here. A `<tfoot>` is a place on the\n * page, not a row the hub delivers, so what lands in it is an aggregate or a\n * `row` query of its own, named on its `<tr>`.\n */\n\n/**\n * The ghost row's `<tbody>`, a blank row for entering a new one, between the\n * rows and the footer. The page writes it as the `ghost` template, so it\n * ships in the document like the heading and the footer, and the hub lands\n * on whatever in it names a query. It is not a live row: the hub never\n * reconciles it and never counts it.\n *\n * A `<form>` cannot wrap a `<tr>`, so the widget makes one outside the table\n * and joins the row's controls and buttons to it with the HTML `form`\n * attribute. Sending is the page's: a button in the row carrying\n * `lb-row-insert` submits that form, and the hub gathers what the form owns.\n * The hub resets the form once the insert succeeds.\n */\nconst GHOST = \"data-ghost\";\n\n/** Ghost row forms need ids for the `form` attribute; any unique one will do. */\nlet ghostForms = 0;\n\nclass LbTable extends HTMLElement implements HubLifecycle {\n  lbAttached(): void {\n    const ghost = this.querySelector(`tbody[${GHOST}]`);\n    if (!ghost?.firstElementChild) return;\n\n    const form = document.createElement(\"form\");\n    form.id = `ghost-row-${++ghostForms}`;\n    form.hidden = true;\n    this.append(form);\n    for (const el of ghost.querySelectorAll(`[${ATTR_COLUMN}], button`)) {\n      el.setAttribute(\"form\", form.id);\n    }\n  }\n\n  /** The row this page's request created or moved, brought into view. */\n  lbRowsLanded(): void {\n    this.querySelector(\n      `[${ATTR_ROW_REQUESTED}=\"${REQUESTED_CREATED}\"], ` +\n        `[${ATTR_ROW_REQUESTED}=\"${REQUESTED_MOVED}\"]`,\n    )?.scrollIntoView({ block: \"nearest\" });\n  }\n\n  /**\n   * A ghost row is for entering the next row, so once one is saved the\n   * cursor goes back to the start of it. The hub calls this after the\n   * response items have landed, so nothing it places afterwards takes the\n   * focus away again. A refused insert leaves the cursor where the user left\n   * it.\n   */\n  lbRequestDone({ request, error }: HubRequestDone, origin: Element): void {\n    if (error || request.name !== REQUEST_ROW_INSERT) return;\n    const row = origin.closest(`[${GHOST}]`);\n    if (row) firstControl(row)?.focus();\n  }\n}\n\n/**\n * The first control in a row the user can type into or choose from. A\n * control a widget wraps is found inside it, since the wrapper takes no focus.\n */\nfunction firstControl(row: Element): HTMLElement | undefined {\n  return [\n    ...row.querySelectorAll<HTMLElement>(\n      'input:not([type=\"hidden\"]), select, textarea',\n    ),\n  ].find((el) => !el.matches(\":disabled\") && el.checkVisibility?.() !== false);\n}\n\ncustomElements.define(\"lb-table\", LbTable);\n"]}

package/docs/lb-checkbox.md

@@ -0,0 +1,63 @@
+# `lb-checkbox`
+
+> Status: a barebones starter.  Iterative use will drive improvements.
+
+A checkbox and its label as one element, for an application to style.  A
+definition only, with no script: the hub treats a native checkbox as a
+control, so the widget adds nothing but the markup.
+
+Requires `exp-column` and `exp-label`.
+
+```html
+<div lb-query="people">
+  <template>
+    <div>
+      <lb-checkbox exp-column="active" exp-label="Active" exp-request="lb-row-update"></lb-checkbox>
+    </div>
+  </template>
+</div>
+```
+
+## Expansion Attributes
+
+| Parameter     | Fills                                           |
+| ------------- | ----------------------------------------------- |
+| `exp-column`  | the checkbox's `lb-column`                      |
+| `exp-label`   | the label's text                                |
+| `exp-request` | the checkbox's `lb-request`, none when absent   |
+
+The column and request go on the checkbox inside, since it is the control,
+so they are expansion attributes here rather than `lb-column` and
+`lb-request` on the tag.
+
+## Why it is not like `lb-input`
+
+`lb-input` has a script that makes the tag itself the control, so the page
+writes `lb-column` on the tag.  `lb-checkbox` cannot do the same.  A value
+that lands before a widget's script has loaded reaches it only as the
+`lb-column-value` stamp, a string, and a checkbox's state is a boolean.  A
+script `lb-checkbox` would read the stamp `"false"` as checked, since no
+string is read.  The native checkbox has no such gap: the hub sets `checked`
+on it directly.
+
+`lb-input` could equally be markup alone; its script is a convention, kept
+for now.
+
+## The control
+
+The checkbox is checked when its column is anything but `false` or null, and
+sends `"true"` or `"false"`.  See
+[checkboxes](../../app/docs/reference/data-binding.md#checkboxes).
+
+## Styling
+
+The definition is a `<label>` holding the `<input type="checkbox">` and a
+`<span>` with the text:
+
+```css
+lb-checkbox label {
+  display: inline-flex;
+  gap: 0.5em;
+  align-items: center;
+}
+```

package/docs/lb-confirm.md

@@ -37,8 +37,7 @@ sits in, so the request carries that row's query and key, and the message
 can show the row's columns with `lb-column`.
 
 Cancel comes first and takes focus, so Enter on a dialog opened by accident
-sends nothing.  The widget closes the dialog when `lb-request-done` says the
-request succeeded.  A refused request leaves it open, with the hub's
+sends nothing.  The widget closes the dialog when the request succeeds.  A refused request leaves it open, with the hub's
 `lb-request-error` on the confirm button.
 
 The dialog is found by its place in the tag, not by id, so the tag works in a

package/docs/lb-form.md

@@ -25,9 +25,11 @@ Requires `exp-id`.
 
 A row with a key is on record, and each control saves its own column on
 `change` with `lb-request="lb-row-update"`.  A row whose key is empty is a new
-one not yet entered: there is nothing to update, so the widget stops an
-`lb-row-update` that carries an empty key, and the controls only hold what a
-submit will gather.
+one not yet entered: the hub sends no update for it, so the controls only
+hold what a submit will gather.  See
+[a row not yet entered](../../app/docs/reference/data-binding.md#a-row-not-yet-entered).
+
+A definition only, with no script of its own.
 
 A button that acts on the row as a whole, such as one adding it to the set,
 belongs to whatever holds the set, and reaches the form by `form="<id>"`.

package/docs/lb-input.md

@@ -45,10 +45,6 @@ sets the value of the `<input>` inside it, and it fires `change` on itself when
 that `<input>` fires `change`.  A form reset returns the `<input>` to its
 default.
 
-A value that lands on a live row before the row's elements upgrade reaches the
-widget as `lb-column-value`, and the widget takes it up when it first
-connects.
-
 ## Inside a form
 
 An `lb-input` inside an `lb-row-insert` or `lb-row-update` form carries no

package/docs/lb-insert-dialog.md

@@ -39,8 +39,7 @@ the control it serves.
 
 ## What it does
 
-Save is the form's `lb-row-insert`.  When `lb-request-done` says it
-succeeded, the widget chooses the new row in the nearest `lb-options` around
+Save is the form's `lb-row-insert`.  When it succeeds, the widget chooses the new row in the nearest `lb-options` around
 the button that opened the dialog, fires `change` on it, and closes the
 dialog.  The new key comes from the patch the insert answers with, so the
 handler answers with the row it created.  A picker that saves its own column

package/docs/lb-master.md

@@ -39,15 +39,27 @@ Requires `exp-row`.
 
 | Button   | Shows             | Does                                          |
 | -------- | ----------------- | --------------------------------------------- |
+| New      | A row on record   | Sends `new`, a request the page declares, and pushes a history entry |
 | Copy     | A row on record   | Sends `copy`, a request the page declares     |
 | Delete   | A row on record   | Asks, then sends `lb-row-delete`              |
 | Save new | A new row         | Submits the form as `lb-row-insert`, and pushes a history entry |
 | Cancel   | A new row         | Resets the form                               |
 
 Each carries `data-mode`, `on-record` or `new`, and the stylesheet shows each
-only in its mode.  A new row is one whose key is empty.  New is not a button:
-a button cannot write a query parm, so choosing the picker's blank starts a
-new row.
+only in its mode.  A new row is one whose key is empty, a
+[row not yet entered](../../app/docs/reference/data-binding.md#a-row-not-yet-entered).
+
+Which row shows is a query parm, and only the page knows its name, so New is
+a request the page declares.  Its handler empties the parm, and the row
+query answers a row with an empty key:
+
+```ts
+handlers: {
+  new: { run: async () => url({ acct: "" }), refresh: [] },
+},
+```
+
+Choosing the picker's blank does the same.
 
 Copy goes to the server rather than filling the form, because a copy is a new
 row in the set, and only the server can bring its children along.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loadbare/widgets",
-  "description": "The basic widget set for @loadbare/app: input, select, options, picker, table, unknown-page, confirm, form, insert-dialog, master",
-  "version": "0.6.0",
+  "description": "The basic widget set for @loadbare/app: input, select, options, picker, table, unknown-page, confirm, form, insert-dialog, master, checkbox",
+  "version": "0.8.0",
   "type": "module",
   "files": [
     "dist",
@@ -49,10 +49,10 @@
     "node": ">=22"
   },
   "peerDependencies": {
-    "@loadbare/app": ">=0.13.0 <1.0.0"
+    "@loadbare/app": ">=0.15.0 <1.0.0"
   },
   "devDependencies": {
-    "@loadbare/app": ">=0.13.0 <1.0.0",
+    "@loadbare/app": ">=0.15.0 <1.0.0",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^22.0.0",
     "jsdom": "^25.0.0",

package/dist/lb-form.browser.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=lb-form.browser.d.ts.map

package/dist/lb-form.browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lb-form.browser.d.ts","sourceRoot":"","sources":["../widgets/lb-form.browser.ts"],"names":[],"mappings":""}

package/dist/lb-form.browser.js

@@ -1,28 +0,0 @@
-/// <reference lib="dom" />
-import { LB_EVENT_NAME, REQUEST_ROW_UPDATE } from "@loadbare/app/constants";
-/**
- * A form over one row, in one of two modes that the row decides.
- *
- * A row with a key is on record, and each control saves its own column on
- * `change`: the page writes `lb-request="lb-row-update"` on every control.
- * A row with an empty key is a new one not yet entered, and a change saves
- * nothing, because there is nothing to update; the controls only hold what
- * will be gathered when something submits the form.
- *
- * So the form stops an update whose key came back empty. The hub completes a
- * request on the way down, before any ancestor sees it, so the key is already
- * in `detail` when the event bubbles through here.
- */
-class LbForm extends HTMLElement {
-    constructor() {
-        super();
-        this.addEventListener(LB_EVENT_NAME, (e) => {
-            const request = e.detail;
-            if (request.name === REQUEST_ROW_UPDATE && request.key === "") {
-                e.stopPropagation();
-            }
-        });
-    }
-}
-customElements.define("lb-form", LbForm);
-//# sourceMappingURL=lb-form.browser.js.map

package/dist/lb-form.browser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lb-form.browser.js","sourceRoot":"","sources":["../widgets/lb-form.browser.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAE3B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG5E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAO,SAAQ,WAAW;IAC9B;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;YACzC,MAAM,OAAO,GAAI,CAA6B,CAAC,MAAM,CAAC;YACtD,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,IAAI,OAAO,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;gBAC9D,CAAC,CAAC,eAAe,EAAE,CAAC;YACtB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC","sourcesContent":["/// <reference lib=\"dom\" />\n\nimport { LB_EVENT_NAME, REQUEST_ROW_UPDATE } from \"@loadbare/app/constants\";\nimport type { HubRequest } from \"@loadbare/app/types\";\n\n/**\n * A form over one row, in one of two modes that the row decides.\n *\n * A row with a key is on record, and each control saves its own column on\n * `change`: the page writes `lb-request=\"lb-row-update\"` on every control.\n * A row with an empty key is a new one not yet entered, and a change saves\n * nothing, because there is nothing to update; the controls only hold what\n * will be gathered when something submits the form.\n *\n * So the form stops an update whose key came back empty. The hub completes a\n * request on the way down, before any ancestor sees it, so the key is already\n * in `detail` when the event bubbles through here.\n */\nclass LbForm extends HTMLElement {\n  constructor() {\n    super();\n    this.addEventListener(LB_EVENT_NAME, (e) => {\n      const request = (e as CustomEvent<HubRequest>).detail;\n      if (request.name === REQUEST_ROW_UPDATE && request.key === \"\") {\n        e.stopPropagation();\n      }\n    });\n  }\n}\n\ncustomElements.define(\"lb-form\", LbForm);\n"]}