@loadbare/app 0.11.0 → 0.13.0

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

@@ -30,7 +30,7 @@ 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;
 /**
  * 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,26 +38,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;
 /**
- * Land response items. Every answer arrives through here.
- *
- * `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.
+ * 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().
+ */
+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 applyResponse(root: ParentNode, items: ResponseItem[], quiet?: readonly string[]): void;
+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":"AAoCA,OAAO,EAEL,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,CAgBvE;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;AAyBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,GAAE,SAAS,MAAM,EAAO,GAC5B,IAAI,CAWN"}
+{"version":3,"file":"lb-apply.d.ts","sourceRoot":"","sources":["../../hub/lb-apply.ts"],"names":[],"mappings":"AAsEA,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,GAAG,EAER,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AA0B7B,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;AA6DD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAMjE;AAoED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,GAAG,EACR,OAAO,UAAQ,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAuBN;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"}