@loadbare/app 0.12.0 → 0.14.0

package/dist/hub/lb-apply.d.ts

@@ -9,11 +9,17 @@ export interface Control extends Element {
  */
 export declare function isFormAssociated(el: Element): boolean;
 /**
- * A control: an `<input>`, `<select>` or `<textarea>`, or a form-associated
- * custom element with a `value` property. Landing and gathering draw the
- * same line, so a value read back is the one that landed there.
+ * A control: an `<input>`, `<select>` or `<textarea>`, a checkbox, or a
+ * form-associated custom element with a `value` property. Landing and
+ * gathering draw the same line, so a value read back is the one that landed
+ * there.
  */
 export declare function isControl(el: Element): el is Control;
+/**
+ * What a control gathers: a checkbox `"true"` or `"false"`, so unchecked
+ * still says so, and any other control its `value`.
+ */
+export declare function controlValue(el: Control): string;
 /**
  * Root if it matches, then every descendant in root's query that does.
  * Gathering finds columns through here. It does not reach into an absent
@@ -21,6 +27,11 @@ export declare function isControl(el: Element): el is Control;
  * showing.
  */
 export declare function within(root: Element, selector: string): Element[];
+/**
+ * Tick or clear an `lb-select` checkbox, and stamp the live row it selects
+ * to match.
+ */
+export declare function select(box: Element, on: boolean): void;
 /**
  * Fill from one row: every `lb-column` and `lb-show` in root's query.
  *
@@ -30,7 +41,13 @@ export declare function within(root: Element, selector: string): Element[];
  * ancestor, so its own `lb-column` reads from the row around it and is left
  * alone here.
  */
-export declare function applyRow(root: Element, row: Row, liveRow?: boolean): void;
+export declare function applyRow(root: Element, row: Row, liveRow?: boolean, stop?: string): void;
+/**
+ * A row naming every column root's query shows, each null: what landing it
+ * leaves is root as it stands with no row. Absent branches are counted, so a
+ * column only an absent element names is cleared too.
+ */
+export declare function blankRow(root: Element): Row;
 /**
  * The row template: the first `<template>` among the element's descendants,
  * outside any nested `lb-query`. A template holding an absent branch is not a
@@ -38,32 +55,54 @@ export declare function applyRow(root: Element, row: Row, liveRow?: boolean): vo
  * live row comes first in document order.
  */
 export declare function templateIn(el: Element): HTMLTemplateElement | null;
+/** How a list of rows lands: in what order, and whether a request asked. */
+export interface RowsOptions {
+    /** The order to place rows by, as an order's text. */
+    order?: string;
+    /** The landing answers a request from this page. */
+    requested?: boolean;
+}
 /**
  * Land rows through a row template.
  *
- * All rows decide membership and order: every row is placed in the order
- * given, and a row whose key did not arrive is gone. A patch disturbs only
- * what it names — a row it did not mention keeps its contents and its
- * position.
+ * All rows decide membership: a row whose key did not arrive leaves. A patch
+ * disturbs only what it names — a row it did not mention keeps its contents,
+ * and keeps its place unless a row the patch named now sorts around it.
  *
- * A custom element that carries `lbPlaceRow` decides where a row goes,
- * because only it knows whether it sorts or groups. Without it a row lands
- * immediately before the template, so rows accumulate in the order they
- * arrive and the template stays put as the insertion marker.
+ * Every live row is placed by the order. With none, all rows show in the
+ * order they arrived, and a patch's new rows go last. A row moves only when
+ * the order put it somewhere else, so landing the same rows again moves
+ * nothing.
  */
-export declare function applyRows(el: Element, template: HTMLTemplateElement, keyColumn: string, result: RowsResult): void;
+export declare function applyRows(el: Element, template: HTMLTemplateElement, keyColumn: string, result: RowsResult, options?: RowsOptions): void;
+/** The answer kept for a query, as all of its rows. */
+export declare function keptAnswer(root: ParentNode, query: string): ResponseItem | undefined;
 /**
  * Drop what landing kept for a root. The hub calls it when it replaces the
  * page, since another page's query of the same name is another query.
  */
 export declare function forget(root: ParentNode): void;
+/** How response items land. */
+export interface LandOptions {
+    /**
+     * Queries that may have nowhere to land without a warning: the hub's own
+     * `lb-url` lands wherever a chrome or page names it, and nowhere otherwise.
+     */
+    quiet?: readonly string[];
+    /** The user's order for a query, which replaces the server's. */
+    orderFor?: (query: string) => string | undefined;
+    /** The items answer a request from this page. */
+    requested?: boolean;
+}
 /**
  * Land response items. Every answer arrives through here, and is kept for
  * `root`, so that what arrives after it is filled from it — see forget().
- *
- * `quiet` names queries that may have nowhere to land without a warning: the
- * hub's own `lb-url` lands wherever a chrome or page names it, and nowhere
- * otherwise.
  */
-export declare function applyResponse(root: ParentNode, items: ResponseItem[], quiet?: readonly string[]): void;
+export declare function applyResponse(root: ParentNode, items: ResponseItem[], options?: LandOptions): void;
+/**
+ * Land a query's kept answer again, as all of its rows: what the hub does
+ * when the user's order for it changes and the rows themselves have not.
+ * False when no answer is kept.
+ */
+export declare function reland(root: ParentNode, query: string): boolean;
 //# sourceMappingURL=lb-apply.d.ts.map

package/dist/hub/lb-apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lb-apply.d.ts","sourceRoot":"","sources":["../../hub/lb-apply.ts"],"names":[],"mappings":"AA6CA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,GAAG,EAER,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAW7B,mEAAmE;AACnE,MAAM,WAAW,OAAQ,SAAQ,OAAO;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAGrD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,OAAO,CAEpD;AAuDD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAMjE;AA8DD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,UAAQ,GAAG,IAAI,CAmBvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAKlE;AA+BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,GACjB,IAAI,CAmEN;AA6CD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE7C;AAwED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,GAAE,SAAS,MAAM,EAAO,GAC5B,IAAI,CAiBN"}
+{"version":3,"file":"lb-apply.d.ts","sourceRoot":"","sources":["../../hub/lb-apply.ts"],"names":[],"mappings":"AAwEA,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,GAAG,EAER,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AA6B7B,mEAAmE;AACnE,MAAM,WAAW,OAAQ,SAAQ,OAAO;IACtC,KAAK,EAAE,MAAM,CAAC;CACf;AA4BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAGrD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,OAAO,CAEpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAEhD;AAkED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAMjE;AA0CD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAGtD;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,GAAG,EACR,OAAO,UAAQ,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAuBN;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAU3C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAKlE;AAshBD,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,WAAgB,GACxB,IAAI,CAkJN;AAmDD,uDAAuD;AACvD,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAE1B;AAOD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE7C;AAyED,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,WAAgB,GACxB,IAAI,CAuBN;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAK/D"}