@loadbare/app 0.26.0 → 0.27.0

package/docs/comparison.md

@@ -209,9 +209,9 @@ observable, and no client cache that answers a request.
   to place rows again when the user makes a choice.  Nothing else is read
   from it in place of asking the server.
 - The hub keeps a little state of its own: the name of the current page,
-  the user's choices for it as the row of its query `lb-choices`, the live
-  row each form is pointed at, the refusals on show, and, until a request
-  completes, the form it gathered from.
+  the user's order and filters for it as the rows of `lb-sort` and
+  `lb-filters`, the live row each form is pointed at, the refusals on show,
+  and, until a request completes, the form it gathered from.
 
 The server is the source of truth for everything else.  A query takes no
 argument from the browser; its only input is `ctx`, which the application
@@ -254,7 +254,7 @@ At run time the hub performs a closed set of operations:
 
 | Trigger                                              | Operation                                                                                                                                         |
 | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Navigation                                           | Clone the page's `<template>` into `<main>`, land `lb-url`, land `lb-choices` empty                                                               |
+| Navigation                                           | Clone the page's `<template>` into `<main>`, land `lb-url`, land `lb-sort` and `lb-filters` empty                                                               |
 | A value for a control                                | Set `value`, and stamp `lb-column-value`                                                                                                          |
 | A value for another native element                   | Set `textContent`, and stamp `lb-column-value`                                                                                                    |
 | A value for a custom element that is not a control   | Stamp `lb-column-value`                                                                                                                           |
@@ -264,9 +264,11 @@ At run time the hub performs a closed set of operations:
 | All rows                                             | Place every row by the query's order, or the user's; remove rows whose keys did not arrive                                                        |
 | An answer to a request, under `lb-manual`            | Leave the rows already showing where they stand, stamp `lb-row-unplaced` on each out of place                                                     |
 | A patch                                              | Upsert the rows named, remove the keys named, leave other rows in place                                                                           |
+| A group template                                     | Build a group where the order breaks, keep it while its run goes on, remove it with its last row                                                  |
+| An aggregate (`lb-aggregate`)                        | Set the element from the rows showing in its group, or in the whole list                                                                          |
 | A row changes, moves or leaves                       | Stamp `lb-row-created`, `lb-row-changed`, `lb-row-moved`, `lb-row-requested` or `lb-row-leaving`; remove a leaving row once its animations finish |
 | After rows land                                      | Stamp `lb-query-row-count`, `lb-query-unplaced-count` and `lb-query-order`                                                                        |
-| The user makes a choice                              | Land `lb-choices`, place and filter the rows already held again, tell the server                                                                  |
+| The user makes a sort or a filter                    | Land `lb-sort` and `lb-filters`, place and filter the rows already held again, tell the server                                                                  |
 | A row the user's filter does not pass                | Set `hidden` on it                                                                                                                                |
 | An `lb-show` column                                  | Move the element into, or out of, a `<template lb-show>`                                                                                          |
 | A `commandfor` button with `--lb-edit` or `--lb-new` | Fill the form from the held row, or empty it; stamp `lb-key-value` and `lb-row-editing`; open its `<dialog>`                                      |
@@ -320,7 +322,7 @@ There are two kinds of placeholder, and they run at different times.
   a whole attribute value or a whole text node.  The tag supplies it with an
   `exp-name` attribute.  An unsupplied placeholder with no default drops the
   attribute.  The value becomes permanent in the shipped HTML.
-- Run time.  Data lands through `lb-column`,
+- Run time.  Data lands through `lb-column`, `lb-aggregate`,
   `lb-query` with a row or group `<template>`, and `lb-show`.  There is no
   run-time interpolation into attribute values or text.
 
@@ -492,7 +494,8 @@ query declared.
 
 A column holds one value.  A set of values is a query of its own.  A row
 never contains rows.  Master-detail is a row and rows answered under two
-names.  Many masters with their details is one `rows` query of joined rows.
+names.  Many masters with their details is one `rows` query of joined rows,
+shown in groups by a group template.
 
 The application designs no endpoints, routes or serialization format.  The
 names in the markup are the keys in the page's `.queries.ts` and
@@ -687,8 +690,8 @@ for the mechanisms by project.
 - The query string rides on every round trip, and the server hands its parms
   to `contextFor`.
 - The user's order and filters for rows already on the page are not query
-  parms.  They are choices, the row of the hub's query `lb-choices`, and
-  hold until the page changes.
+  parms.  They are the rows of the hub's queries `lb-sort` and `lb-filters`,
+  and hold until the page changes.
 - The application must be served from the origin root.  The hub reaches
   `/lb` by absolute path, and the chrome links `/client.js` and `/app.css`.
 - The hub sets `document.title` from `lb-page-label`.  On entering a page,
@@ -753,7 +756,7 @@ Checked at build time, as errors:
   the browser's lifecycle callbacks
 - a chrome without exactly one `<lb-hub>` and one empty `<main>` inside it,
   and a page carrying either
-- an `lb-` attribute in markup that is not one of the eighteen a developer
+- an `lb-` attribute in markup that is not one of the ten a developer
   writes; the rest are stamps, and script never assigns them
 - an `lb-request` value beginning with `lb-` that is not one of the three
   requests Loadbare provides
@@ -763,14 +766,18 @@ Checked at build time, as errors:
   `<lb-hub>`
 - `lb-show` on a `<template>`, on a row template's root, with no `lb-query`
   around it, or written `!` or `!!column`
-- `lb-order` or `lb-filter` on an element not carrying `lb-query`, or naming
+- `lb-group` on anything but a `<template>` holding a `<template>`, and
+  `lb-aggregate` on a `<template>`, naming no function it knows, or naming
+  no column for any but `count`
+- `lb-filter` on an element not carrying `lb-query`, or naming
   no column
 - a `command` beginning `--lb-` that is not one of the three, and one of the
   three with no `commandfor`
 - an `lb-query` naming a query the page does not declare, an `lb-request`
   naming a request it does not declare under `handlers`, and one of the
   three requests for a query whose `crud` entry lacks it.  The chrome names
-  only `lb-url` and `lb-choices`.  The builder reads the declarations by
+  only `lb-url`, `lb-sort`, `lb-filters` and `lb-hub-status`.  The builder
+  reads the declarations by
   loading the page modules, so their import-time code runs during the build.
 - a `.queries.ts` or `.requests.ts` with no matching page
 
@@ -817,8 +824,8 @@ Nothing is scoped, renamed, added or removed.
   `lb-request-error` and `lb-request-refused`.  An empty `rows` query is
   styled with `[lb-query-row-count="0"]`.
 - Every change the hub makes to a list is stamped: `lb-row-created`,
-  `lb-row-changed`, `lb-row-moved`, `lb-row-requested` and
-  `lb-row-leaving`, and a row an answer left out of place carries
+  `lb-row-changed`, `lb-row-moved`, `lb-row-requested`, `lb-row-leaving` and
+  `lb-group-leaving`, and a row an answer left out of place carries
   `lb-row-unplaced`.  A leaving row is removed once its animations finish,
   so an application animates rows with CSS alone.
 
@@ -842,7 +849,7 @@ Nothing is scoped, renamed, added or removed.
 Loadbare/app ships no server.  It ships:
 
 - `createHub(pages)`, an engine with no HTTP code, in `@loadbare/app/server`,
-  beside `row`, `rows`, `patch`, `url`, `choices` and `refusal`
+  beside `row`, `rows`, `patch`, `url`, `sort`, `filters` and `refusal`
 - `hubRoutes(hub, contextFor, options)`, an Express 5 router, in
   `@loadbare/app/express`.  Express is an optional peer dependency.
 - `pages.ts`, generated by the builder, which imports every page's queries
@@ -979,8 +986,8 @@ cross-reference.
 
 | Owned                                | Count | Names                                                                                                                                                                                                                                                                                                                                                                       |
 | ------------------------------------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `lb-*` attributes a developer writes | 11    | `lb-query`, `lb-column`, `lb-show`, `lb-order`, `lb-filter`, `lb-manual`, `lb-request`, `lb-url-link`, `lb-url-parm`, `lb-url-push`, `lb-url-unknown`                                                                                                                                                                     |
-| `lb-*` stamps                        | 23    | `lb-column-value`, `lb-key-value`, `lb-row-live`, `lb-query-row-count`, `lb-query-unplaced-count`, `lb-query-order`, `lb-row-created`, `lb-row-changed`, `lb-row-moved`, `lb-row-requested`, `lb-row-unplaced`, `lb-row-leaving`, `lb-row-editing`, `lb-request-pending`, `lb-request-error`, `lb-request-refused`, `lb-page`, `lb-page-title`, and on `<lb-hub>` `lb-load-state`, `lb-server-state`, `lb-error`, `lb-pending`, `lb-as-of` |
+| `lb-*` attributes a developer writes | 12    | `lb-query`, `lb-column`, `lb-show`, `lb-group`, `lb-aggregate`, `lb-filter`, `lb-manual`, `lb-request`, `lb-url-link`, `lb-url-parm`, `lb-url-push`, `lb-url-unknown`                                                                                                                                                                     |
+| `lb-*` stamps                        | 27    | `lb-column-value`, `lb-key-value`, `lb-row-live`, `lb-query-row-count`, `lb-query-unplaced-count`, `lb-query-order`, `lb-group-live`, `lb-group-column`, `lb-group-value`, `lb-row-created`, `lb-row-changed`, `lb-row-moved`, `lb-row-requested`, `lb-row-unplaced`, `lb-row-leaving`, `lb-group-leaving`, `lb-row-editing`, `lb-request-pending`, `lb-request-error`, `lb-request-refused`, `lb-page`, `lb-page-title`, and on `<lb-hub>` `lb-load-state`, `lb-server-state`, `lb-error`, `lb-pending`, `lb-as-of` |
 | `lb-*` build-time attributes         | 2     | `lb-exp-slot`, `lb-exp-template`                                                                                                                                                                                                                                                                                                                                            |
 | Requests Loadbare provides           | 3     | `lb-row-insert`, `lb-row-update`, `lb-row-delete`                                                                                                                                                                                                                                                                                                                           |
 | Commands for `commandfor`            | 4     | `--lb-edit`, `--lb-new`, `--lb-release`, `--lb-place`                                                                                                                                                                                                                                                                                                                                   |
@@ -988,11 +995,11 @@ cross-reference.
 | Attribute namespace for expansion    | 1     | `exp-*`                                                                                                                                                                                                                                                                                                                                                                     |
 | Reserved tags                        | 1     | `<lb-hub>`                                                                                                                                                                                                                                                                                                                                                                  |
 | Reserved events                      | 2     | `lb-request`, `lb-request-done`                                                                                                                                                                                                                                                                                                                                             |
-| Queries the hub serves               | 3     | `lb-url`, with columns `lb-path`, `lb-page-label`; `lb-choices`, keyed by `lb-path`; `lb-hub-status`, with columns `lb-load-state`, `lb-server-state`, `lb-error`, `lb-pending`, `lb-as-of` |
+| Queries the hub serves               | 4     | `lb-url`, with columns `lb-path`, `lb-page-label`; `lb-sort` and `lb-filters`, keyed by the query's name; `lb-hub-status`, with columns `lb-load-state`, `lb-server-state`, `lb-error`, `lb-pending`, `lb-as-of` |
 | Builder flags                        | 3     | `--src`, `--out`, `--minify`                                                                                                                                                                                                                                                                                                                                                |
 | Reserved file names and patterns     | 8     | `chrome.html`, `imports.ts`, `*.page.html`, `*.queries.ts`, `*.requests.ts`, `<tag>.html`, `<tag>.browser.ts`, `*.css`                                                                                                                                                                                                                                                      |
 | Reserved `package.json` keys         | 1     | `loadbare.widgets`                                                                                                                                                                                                                                                                                                                                                          |
-| Server functions                     | 8     | `row`, `rows`, `patch`, `url`, `choices`, `refusal`, `createHub`, `hubRoutes`                                                                                                                                                                                                                                                                                               |
+| Server functions                     | 9     | `row`, `rows`, `patch`, `url`, `sort`, `filters`, `refusal`, `createHub`, `hubRoutes`                                                                                                                                                                                                                                                                                               |
 | Browser exports                      | 2     | `applyRow`, `applyResponse`                                                                                                                                                                                                                                                                                                                                                 |
 
 Theory states that the whole vocabulary fits in one technical reference,
@@ -1141,7 +1148,7 @@ Each is current behavior or an open item named in the
 | File inputs                         | Not landed and not gathered.                                                                                                                         |
 | Field validation                    | No per-keystroke mechanism.  A handler's refusal lands on each control through the browser's own validity; validation placement is an open question. |
 | Concurrent writers                  | No version or conflict check.  Open question.                                                                                                        |
-| Chrome-level queries                | The chrome names only `lb-url` and `lb-choices`; an application query there is a build error.  On the roadmap.                                       |
+| Chrome-level queries                | The chrome names only `lb-url`, `lb-sort`, `lb-filters` and `lb-hub-status`; an application query there is a build error.  On the roadmap.                                       |
 | A widget receiving a whole row      | Not available.  On the roadmap.                                                                                                                      |
 | Compound foreign keys               | A picker offers the same choices on every row; a choice restricted by another column of its row cannot be expressed.  Roadmap.                       |
 | Configurable request deadline       | Fixed at ten seconds.                                                                                                                                |
@@ -1401,8 +1408,8 @@ Each equivalent is approximate.
 | `lb-exp-slot`, `lb-exp-template`      | Default slot and named slots; `ng-content` with `select`                                                 |
 | `lbRowsLanded`                        | An effect after a list renders                                                                           |
 | `lbAttached`, `lbDetached`            | Mount and unmount; `onMounted` and `onUnmounted` (Vue); `onMount` and `onDestroy` (Svelte)               |
-| `order`                              | `ORDER BY` with report-writer control breaks (`BREAK ON`, group bands)                                   |
-| `lb-choices`, `lb-order`, `lb-filter` | A data grid's sort and filter model                                                                      |
+| `order`, `lb-group`                  | `ORDER BY` with report-writer control breaks (`BREAK ON`, group bands)                                   |
+| `lb-sort`, `lb-filters`, `lb-filter` | A data grid's sort and filter model                                                                      |
 | `ctx` / `HubContext`                  | `event.locals` (SvelteKit); loader `context` (React Router 7); request-scoped dependency injection       |
 | `imports.ts`                          | Installing and registering a component library                                                           |
 | `pages.ts`                            | Generated route manifest                                                                                 |

package/docs/miswarts.md

@@ -68,7 +68,7 @@ gathered.
 ## Rows hidden by a filter
 
 **What.**  A row that does not pass the user's filter gets the `hidden`
-attribute.
+attribute, and so does a group whose rows are all hidden.
 
 **Rule broken.**  The hub writes only its own stamps, which always
 begin with `lb-`.
@@ -78,7 +78,7 @@ over rows already on the page needs no round trip, and `hidden` is HTML's
 own word for an element that is present but not shown.  A stamp of our
 own would make every stylesheet restate what the browser already does.
 
-**Why it terminates.**  It applies only to live rows under a
+**Why it terminates.**  It applies only to live rows and groups under a
 filter.
 
 ## Leaving rows are inert

package/docs/opinions.md

@@ -109,8 +109,8 @@ every link and every query parm follows this rule.  See
 
 What the framework itself keeps is presented as rows.  The URL is the
 query `lb-url`, of kind `row`, and lands like any server query.  User
-preferences and choices on a page are sent as `lb-row-update` for `lb-choices`,
-and can land anywhere on the page.
+preferences and choices on a page are sent as `lb-row-update` for `lb-sort`
+and `lb-filters`, and can land anywhere on the page.
 
 Most frameworks keep their own state in a store with its own interface.
 In Loadbare/app, a developer shows the current page's label or a

package/docs/reference/chrome.md

@@ -101,7 +101,6 @@ server's row lands, so a chrome shows where the page is with no code:
 |-------------------|---------------------------------------------------------|
 | `lb-path`         | The path, such as `/members`. The row's key             |
 | `lb-page-label`   | The page's title, or its stub when it has none          |
-| `lb-page-unknown` | `true` when no page's stub matches the path             |
 | Any other name    | The query parm of that name, or empty when it is absent |
 
 The path names a page, never a resource: `/accounts/42` is not a way to
@@ -116,9 +115,9 @@ page file carries; see [page files](./page-files.md#the-page-title). The hub
 sets the document title to `lb-page-label` whenever it is not null, so the
 tab and the browser history show the page.
 
-`lb-url` is one of two queries a page may use that the server does not
-declare. The other is [`lb-choices`](./data-binding.md#choices). A page
-names either the same way, anywhere inside the hub.
+`lb-url` is one of the queries a page may use that the server does not
+declare. The others are `lb-sort`, `lb-filters` and `lb-hub-status`. A page
+names any the same way, anywhere inside the hub.
 
 ### Where focus starts
 
@@ -223,8 +222,8 @@ pushes one instead when the element carrying `lb-request` also carries
 The hub answers the request itself, with no round trip, then reloads the
 page's queries at the new URL. The page stays in place, and rows that come
 back keep their place. A request that leaves the URL as it was does
-nothing. `lb-page-label` and `lb-page-unknown` are the hub's, and a request
-never sets them.
+nothing. `lb-page-label` is the hub's, and a request
+never sets it.
 
 A request that gives `lb-path` a new value enters that page, pushes a
 history entry, and the new URL carries only the query parms the request
@@ -288,8 +287,8 @@ it; a per-session database role means an id outside the caller's reach
 finds nothing.
 
 An order or a filter the hub applies to rows the page already holds is not
-a query parm. It is a [choice](./data-binding.md#choices), which holds until
-the page changes.
+a query parm. It is a [sort or a filter](./data-binding.md#sort-and-filters),
+which holds until the page changes.
 
 The hub sends the query parms with every round trip, and the server hands
 them to `contextFor`; see [the Express server](./server.md#database-layer).
@@ -308,8 +307,7 @@ show the path:
 </dialog>
 ```
 
-When no page's stub matches the path, `lb-page-unknown` is `true`,
-`lb-page-label` is null, `<main>` keeps the page it had, the hub calls
+When the path names a page that does not exist, `lb-page-label` is null, `<main>` keeps the page it had, the hub calls
 `showModal()` on the dialog, and reports the path to the console. A chrome
 with no dialog shows nothing. `lb-url` lands before the page is looked up,
 so the dialog shows the path by naming it like any other element.

package/docs/reference/css.md

@@ -91,6 +91,17 @@ is not one of the list's rows.
 See [Rows](./data-binding.md#rows)
 and [Editing a row in one form](./data-binding.md#editing-a-row-in-one-form).
 
+### A group
+
+Each top-level element of a group carries `lb-group-live`, the column it
+breaks on as `lb-group-column`, and its value there as `lb-group-value`:
+
+```css
+[lb-group-column="category"][lb-group-value="Income"] { color: var(--income); }
+```
+
+See [Groups](./data-binding.md#groups).
+
 ### What just happened to a row
 
 The hub stamps what its last landing did, so a stylesheet animates with
@@ -102,7 +113,7 @@ nothing else:
 | `[lb-row-changed]`             | A row whose values changed                     |
 | `[lb-row-moved]`               | A row whose values changed and now stands elsewhere; it carries `lb-row-changed` too |
 | `[lb-row-requested]`           | Any of the three, done by this page's request, as `created`, `changed` or `moved` |
-| `[lb-row-leaving]` | A row on its way out; the hub removes it when its animations end |
+| `[lb-row-leaving]`, `[lb-group-leaving]` | A row or group on its way out; the hub removes it when its animations end |
 
 ```css
 [lb-row-created] { animation: arrive 200ms; }
@@ -166,18 +177,19 @@ form:not([lb-key-value=""]) .save-new { display: none; }
 
 See [Editing a row in one form](./data-binding.md#editing-a-row-in-one-form).
 
-### The user's choices
+### The user's order and filters
 
-An order or a filter the user chose is a column of `lb-choices`, so the
-element showing it carries it as `lb-column-value`.  Style anything else by
-it with `:has()`:
+The order the user chose is the `order` column of `lb-sort`, and a filter
+is a column of `lb-filters`, so the element showing either carries it as
+`lb-column-value`. Style anything else by it with `:has()`:
 
 ```css
-table:has([lb-column="accounts_order"][lb-column-value="-balance"])
-  th.balance::after { content: "▼"; }
+:has([lb-column="name"][lb-column-value="^=Amazon"]) th.name::after {
+  content: "🔍";
+}
 ```
 
-See [Choices](./data-binding.md#choices).
+See [Sort and filters](./data-binding.md#sort-and-filters).
 
 ### Content shown by condition
 

package/docs/reference/custom-elements.md

@@ -268,7 +268,7 @@ Each direction has one mechanism for each kind of message:
 
 | Direction      | What                                       | How                         | Today |
 |----------------|--------------------------------------------|-----------------------------|-------|
-| Hub to element | State that lasts                           | An attribute the hub stamps | `lb-column-value`, `lb-key-value`, `lb-query-row-count`, `lb-query-unplaced-count`, `lb-query-order`, `lb-row-*`, `lb-request-pending`, `lb-request-error`, `lb-request-refused` |
+| Hub to element | State that lasts                           | An attribute the hub stamps | `lb-column-value`, `lb-key-value`, `lb-query-row-count`, `lb-query-unplaced-count`, `lb-query-order`, `lb-group-*`, `lb-row-*`, `lb-request-pending`, `lb-request-error`, `lb-request-refused` |
 | Hub to element | State the platform already names           | A property                  | A control's `value` |
 | Hub to element | What the hub did                           | An optional `lb` method     | `lbAttached`, `lbRowsLanded`, `lbRequestDone`, `lbDetached` |
 | Hub to element | A moment an element started                | A bubbling event            | `lb-request-done` |
@@ -315,11 +315,11 @@ customElements.define("note-popup", NotePopup);
 | `lbRequestDone(detail, origin)` | After a request committed by the element, or inside it, has finished |
 | `lbDetached()`                  | Once, after it removes the element                                |
 
-The hub places an element when it starts up the chrome, shows a page, or
-creates a live row. It places the chrome and a page as
+The hub places an element when it starts up the chrome, shows a page,
+creates a live row, or builds a group. It places the chrome and a page as
 the page's first answer lands, or once that round trip fails, so an element
 in either hears `lbAttached` with the page's data in place. It removes an
-element when a live row has finished leaving, and when it shows
+element when a live row or a group has finished leaving, and when it shows
 another page in place of the one holding it. Write setup in `lbAttached` and its undoing in
 `lbDetached`; the two pair exactly, so neither guards against running
 twice.
@@ -572,18 +572,21 @@ missing a field its name needs, and stamps the dispatching element with
 
 Let the event bubble, so an ancestor can stop it before the hub sends it.
 
-A request with `lb-row-update` for `lb-url` or `lb-choices` is keyed by the
-path, so an element anywhere on the page may set a query parm or make a
-[choice](./data-binding.md#choices) without sitting inside the query:
+A request with `lb-row-update` for `lb-url` is keyed by the path; one for
+`lb-sort` or `lb-filters` is keyed by the query's name. An element anywhere
+on the page may set a query parm or make a
+[sort or a filter](./data-binding.md#sort-and-filters) without sitting
+inside the query:
 
 ```ts
-import { CHOICES_QUERY, LB_EVENT_NAME, REQUEST_ROW_UPDATE } from "@loadbare/app/constants";
+import { SORT_QUERY, LB_EVENT_NAME, REQUEST_ROW_UPDATE } from "@loadbare/app/constants";
 import type { HubRequest } from "@loadbare/app/types";
 
 const detail: HubRequest = {
   name: REQUEST_ROW_UPDATE,
-  query: CHOICES_QUERY,
-  values: { ledger_order: "-amount" },
+  query: SORT_QUERY,
+  key: "ledger",
+  values: { order: "-amount" },
 };
 this.dispatchEvent(new CustomEvent(LB_EVENT_NAME, { bubbles: true, detail }));
 ```
@@ -616,8 +619,8 @@ listener. Import its name as `LB_DONE_EVENT_NAME`.
 `items` is every response item that landed because of the request, in
 order. `refusal` is set beside `error` when the handler refused the
 request, holding its `message` and `columns`. An answer that moved the URL contributes its `lb-url` item, which
-carries a key only the server knew, and the page load. A choice contributes
-the row of `lb-choices` it made. `error` is set when
+carries a key only the server knew, and the page load. A sort or a filter contributes
+the row of `lb-sort` or `lb-filters` it made. `error` is set when
 the round trip failed, and then nothing landed. A new row's key is in the
 answer only when the handler returned it in a patch: a refresh sends all
 rows, and nothing marks which one is new.
@@ -633,7 +636,8 @@ had there hears the event, and no custom element the hub has removed hears
 
 The hub lands every row template itself, places every row by the query's
 order (see [Placing by hand](./data-binding.md#placing-by-hand)
-for when it does not). A
+for when it does not), and builds every group the markup's group templates describe; see
+[Order](./data-binding.md#order) and [Groups](./data-binding.md#groups). A
 plain element carrying `lb-query` with a row template inside it needs no
 code, so a custom element holds rows only to do something with them once
 they land.
@@ -661,7 +665,8 @@ Everything else is the hub's:
 | Cloning     | Clones the row template once per new key                 |
 | Matching    | Fills the live row already showing that key, when its values changed |
 | Placing     | Places every live row by the user's order or the query's, and leaves them where they stand for an answer under `lb-manual` |
-| Filtering   | Hides a row the user's filter does not pass |
+| Filtering   | Hides a row the user's filter does not pass, and a group whose rows are all hidden |
+| Grouping    | Builds a group where the order breaks, keeps it while its run goes on, and removes it with its last row |
 | Removing    | Marks the live rows the response says are gone as leaving, and removes them |
 | Stamping    | Stamps each live row with `lb-row-live`, `lb-key-value`, and what happened to it |
 | Counting    | Stamps `lb-query-row-count` with the number of live rows showing, `lb-query-unplaced-count` with the number out of place, and `lb-query-order` with the order placing them |