@mosaicajs/components 0.1.0-rc.4 → 0.1.0

package/dist/mosaica-components.js.LICENSE.txt

@@ -3,7 +3,7 @@ its licence and the licence text it is distributed with.
 
 --------------------------------------------------------------------------------
 
-@deck.gl/aggregation-layers@9.3.7
+@deck.gl/aggregation-layers@9.4.0
 Licence: MIT
 
 Copyright Vis.gl contributors.
@@ -28,7 +28,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@deck.gl/core@9.3.7
+@deck.gl/core@9.4.0
 Licence: MIT
 
 Copyright Vis.gl contributors.
@@ -53,7 +53,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@deck.gl/layers@9.3.7
+@deck.gl/layers@9.4.0
 Licence: MIT
 
 Copyright Vis.gl contributors.
@@ -146,7 +146,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 --------------------------------------------------------------------------------
 
-@loaders.gl/core@4.4.3
+@loaders.gl/core@4.5.4
 Licence: MIT
 
 loaders.gl is licensed under the MIT license
@@ -192,7 +192,7 @@ See the License for the specific language governing permissions and limitations
 
 --------------------------------------------------------------------------------
 
-@loaders.gl/images@4.4.3
+@loaders.gl/images@4.5.4
 Licence: MIT
 
 loaders.gl is licensed under the MIT license
@@ -238,7 +238,7 @@ See the License for the specific language governing permissions and limitations
 
 --------------------------------------------------------------------------------
 
-@loaders.gl/loader-utils@4.4.3
+@loaders.gl/loader-utils@4.5.4
 Licence: MIT
 
 loaders.gl is licensed under the MIT license
@@ -284,7 +284,7 @@ See the License for the specific language governing permissions and limitations
 
 --------------------------------------------------------------------------------
 
-@loaders.gl/worker-utils@4.4.3
+@loaders.gl/worker-utils@4.5.4
 Licence: MIT
 
 loaders.gl is licensed under the MIT license
@@ -330,7 +330,7 @@ See the License for the specific language governing permissions and limitations
 
 --------------------------------------------------------------------------------
 
-@luma.gl/core@9.3.6
+@luma.gl/core@9.4.2
 Licence: MIT
 
 luma.gl is provided under the MIT license
@@ -347,6 +347,11 @@ This software includes adaptations of some postprocessing code from
 THREE.js (https://github.com/mrdoob/three.js/) under MIT license. 
 THREE.js parts Copyright © 2010-2018 three.js authors. 
 
+This software includes adaptations of Gaussian-splat rendering and
+level-of-detail behavior from Spark (https://github.com/sparkjsdev/spark)
+under MIT license.
+Spark parts Copyright © 2025 WORLD LABS TECHNOLOGIES, INC.
+
 Additional attribution given in specific source files. 
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -369,7 +374,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@luma.gl/engine@9.3.6
+@luma.gl/engine@9.4.2
 Licence: MIT
 
 luma.gl is provided under the MIT license
@@ -386,6 +391,11 @@ This software includes adaptations of some postprocessing code from
 THREE.js (https://github.com/mrdoob/three.js/) under MIT license. 
 THREE.js parts Copyright © 2010-2018 three.js authors. 
 
+This software includes adaptations of Gaussian-splat rendering and
+level-of-detail behavior from Spark (https://github.com/sparkjsdev/spark)
+under MIT license.
+Spark parts Copyright © 2025 WORLD LABS TECHNOLOGIES, INC.
+
 Additional attribution given in specific source files. 
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -408,7 +418,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@luma.gl/shadertools@9.3.6
+@luma.gl/gpgpu@9.4.2
 Licence: MIT
 
 luma.gl is provided under the MIT license
@@ -425,6 +435,11 @@ This software includes adaptations of some postprocessing code from
 THREE.js (https://github.com/mrdoob/three.js/) under MIT license. 
 THREE.js parts Copyright © 2010-2018 three.js authors. 
 
+This software includes adaptations of Gaussian-splat rendering and
+level-of-detail behavior from Spark (https://github.com/sparkjsdev/spark)
+under MIT license.
+Spark parts Copyright © 2025 WORLD LABS TECHNOLOGIES, INC.
+
 Additional attribution given in specific source files. 
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -447,7 +462,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@luma.gl/webgl@9.3.6
+@luma.gl/shadertools@9.4.2
 Licence: MIT
 
 luma.gl is provided under the MIT license
@@ -464,6 +479,55 @@ This software includes adaptations of some postprocessing code from
 THREE.js (https://github.com/mrdoob/three.js/) under MIT license. 
 THREE.js parts Copyright © 2010-2018 three.js authors. 
 
+This software includes adaptations of Gaussian-splat rendering and
+level-of-detail behavior from Spark (https://github.com/sparkjsdev/spark)
+under MIT license.
+Spark parts Copyright © 2025 WORLD LABS TECHNOLOGIES, INC.
+
+Additional attribution given in specific source files. 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+@luma.gl/webgl@9.4.2
+Licence: MIT
+
+luma.gl is provided under the MIT license
+
+Copyright (c) 2020 vis.gl contributors
+
+This software includes parts initially developed by Uber and open sourced under MIT license.
+Copyright (c) 2015 Uber Technologies, Inc.
+
+This software includes parts of PhiloGL (https://github.com/philogb/philogl)
+under MIT license. PhiloGL parts Copyright © 2013 Sencha Labs.
+
+This software includes adaptations of some postprocessing code from 
+THREE.js (https://github.com/mrdoob/three.js/) under MIT license. 
+THREE.js parts Copyright © 2010-2018 three.js authors. 
+
+This software includes adaptations of Gaussian-splat rendering and
+level-of-detail behavior from Spark (https://github.com/sparkjsdev/spark)
+under MIT license.
+Spark parts Copyright © 2025 WORLD LABS TECHNOLOGIES, INC.
+
 Additional attribution given in specific source files. 
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -486,7 +550,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@mapbox/tiny-sdf@2.2.0
+@mapbox/tiny-sdf@2.3.0
 Licence: BSD-2-Clause
 
 BSD-2-Clause
@@ -881,7 +945,7 @@ Cesium-derived code can be found in the submodule: modules/3d-tiles
 
 --------------------------------------------------------------------------------
 
-@probe.gl/env@4.1.1
+@probe.gl/env@4.1.2
 Licence: MIT
 
 Copyright Vis.gl contributors.
@@ -906,7 +970,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@probe.gl/log@4.1.1
+@probe.gl/log@4.1.2
 Licence: MIT
 
 Copyright Vis.gl contributors.
@@ -931,7 +995,7 @@ THE SOFTWARE.
 
 --------------------------------------------------------------------------------
 
-@probe.gl/stats@4.1.1
+@probe.gl/stats@4.1.2
 Licence: MIT
 
 Copyright Vis.gl contributors.
@@ -1528,7 +1592,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 --------------------------------------------------------------------------------
 
-mjolnir.js@3.0.1
+mjolnir.js@3.1.1
 Licence: MIT
 
 MIT License

package/dist/mosaica-components.js.sri

@@ -1 +1 @@
-sha384-3y47yHnxIGehfKhPCOex+MV7fQ69B7Uo3ktl9Fhu2g07nIb41lcs7ZUje3H3eqim
+sha384-6EQhQsMgHJEiAjNNj1/HvEuFRrHLIEDd7N47ufKkXI3Zupi3ISVLqPzMNRZTn3ar

package/dist/mosaica-components.json

@@ -1,5 +1,5 @@
 {
   "file": "mosaica-components.js",
-  "bytes": 1718265,
-  "integrity": "sha384-3y47yHnxIGehfKhPCOex+MV7fQ69B7Uo3ktl9Fhu2g07nIb41lcs7ZUje3H3eqim"
+  "bytes": 1955994,
+  "integrity": "sha384-6EQhQsMgHJEiAjNNj1/HvEuFRrHLIEDd7N47ufKkXI3Zupi3ISVLqPzMNRZTn3ar"
 }

package/dist/parts.d.ts

@@ -5,10 +5,9 @@
  * item card's title is `::part(item-card-title)`.
  */
 /**
- * The parts each element may render, by element name without `mosaica-`, as the lists an element
- * forwards with `exportparts`. A host that renders an element inside its own shadow root forwards
- * `PARTS[name]` to style them from outside. Each element's reference page says when each part is
- * rendered.
+ * The parts each element may render, by element name without `mosaica-`. If you render an element
+ * inside your own shadow root, forward `PARTS[name]` with `exportparts` so the page can style those
+ * parts from outside.
  */
 export declare const PARTS: {
     readonly map: readonly ["attribution", "canvas", "controls", "density-key", "note", "overlay", "region-tag", "tooltip", ...string[]];

package/dist/parts.js

@@ -7,10 +7,9 @@
 /** What `renderState` draws, in every element that shows a state. */
 const STATE = ['state', 'refusal', 'reason', 'refresh', 'retry', 'reauthorise'];
 /**
- * The parts each element may render, by element name without `mosaica-`, as the lists an element
- * forwards with `exportparts`. A host that renders an element inside its own shadow root forwards
- * `PARTS[name]` to style them from outside. Each element's reference page says when each part is
- * rendered.
+ * The parts each element may render, by element name without `mosaica-`. If you render an element
+ * inside your own shadow root, forward `PARTS[name]` with `exportparts` so the page can style those
+ * parts from outside.
  */
 export const PARTS = {
     map: ['attribution', 'canvas', 'controls', 'density-key', 'note', 'overlay', 'region-tag', 'tooltip', ...STATE],

package/dist/selection.d.ts

@@ -3,48 +3,42 @@ import { type RegionProjection } from '@mosaicajs/client';
 import { MosaicaElement } from './base.js';
 import './count.js';
 /**
- * The selected region: its counts, the held marks inside it as a list, and its actions. *Shown
- * inside* counts the held marks against the matched count. *Matched inside* and *Visible inside*
- * are the store's counts in view over the shape, the figures the status strip shows, exact unless
- * the server answered for a cover of it; before those land, *Visible inside* appears only while no
- * other filter narrows the view. Clicking a listed mark picks it. *Outside* flips the selection to its
- * complement, and *Clear* drops it.
+ * Use the selection card beside a map so that viewers can see what is inside the region they have
+ * drawn. It reads the store's selected region, or the `region` you set. It counts the items inside
+ * that the filters match, the items the viewer may see there and the marks drawn there. The drawn
+ * marks are listed below the counts, and clicking one picks it.
  *
- * While its counts are not shown and the server cannot be reached or did not answer, the state line
- * says so in the status strip's words, Server unreachable or Server did not answer, in place of
- * Counting or Selection refused. Where the server was too busy to count the selection, it says
- * Server busy, with Retry.
+ * The region acts as a filter, which means the map and every other count narrow to it once it
+ * settles. Outside flips it to everything outside the shape, and Clear removes it. The counts are
+ * approximate when the server had to count an area around the shape, and the state line's tooltip
+ * says when that is so. Export and Save as artifact are shown disabled because they are not
+ * available yet.
  *
- * A selection is a filter: the map and every count narrow to it once it settles. Not built yet:
- * *Export* and *Save as artifact*, which need server routes; their buttons are disabled with the
- * reason on hover.
- *
- * @summary The selected region's counts, marks and actions.
+ * @summary A card showing the counts and marks inside the selected region.
  * @tagname mosaica-selection
  * @category Elements
- * @fires {CustomEvent<MosaicaEventDetails['mosaica-selectchange']>} mosaica-selectchange - Clear
- *   (with `shape` null) or Outside and Inside (with the new shape and `status` `loading`) was
- *   pressed.
+ * @fires {CustomEvent<MosaicaEventDetails['mosaica-selectchange']>} mosaica-selectchange - Clear,
+ *   Outside or Inside was pressed.
  * @csspart title - The heading, with the shape's kind.
- * @csspart state - The state line, with `data-state`; its tooltip says whether the counts are
- *   exact for the shape or for a cover.
+ * @csspart state - The state line, with `data-state`. Its tooltip says whether the counts are exact
+ *   for the shape.
  * @csspart refusal - The words "Selection refused", or "Server busy", with `data-code` set to the
  *   refusal's code.
- * @csspart reason - The server's reason for the refusal, on a line under "Selection refused".
- * @csspart retry - The Retry button, when the selection's count was refused by a server too busy.
+ * @csspart reason - The server's reason for the refusal, under "Selection refused".
+ * @csspart retry - The Retry button, shown if the server was too busy to count the selection.
  * @csspart counts - The counts.
  * @csspart count-served - The `<mosaica-count>` of marks shown inside.
- * @csspart count-matched - The `<mosaica-count>` matched inside (or outside).
- * @csspart count-visible - The `<mosaica-count>` visible inside (or outside).
+ * @csspart count-matched - The `<mosaica-count>` of items the filters match inside (or outside).
+ * @csspart count-visible - The `<mosaica-count>` of items the viewer may see inside (or outside).
  * @csspart label - The heading above the list.
- * @csspart items - The list of held marks inside.
- * @csspart item - One held mark, by `mosaica_id`.
+ * @csspart items - The list of drawn marks inside.
+ * @csspart item - One drawn mark, by `mosaica_id`.
  * @csspart actions - The action buttons.
  * @csspart action - One action button.
  */
 export declare class MosaicaSelection extends MosaicaElement {
     static styles: import("lit").CSSResult[];
-    /** The region to show in place of the store's `region` projection. */
+    /** A region to show instead of the store's `region` projection. */
     accessor region: RegionProjection | null;
     private get shown();
     render(): TemplateResult | typeof nothing;

package/dist/selection.js

@@ -42,42 +42,36 @@ import { reasonOf, refusedState, renderState, stateOf } from './states.js';
 import { chrome, tokens } from './tokens.js';
 import './count.js';
 /**
- * The selected region: its counts, the held marks inside it as a list, and its actions. *Shown
- * inside* counts the held marks against the matched count. *Matched inside* and *Visible inside*
- * are the store's counts in view over the shape, the figures the status strip shows, exact unless
- * the server answered for a cover of it; before those land, *Visible inside* appears only while no
- * other filter narrows the view. Clicking a listed mark picks it. *Outside* flips the selection to its
- * complement, and *Clear* drops it.
+ * Use the selection card beside a map so that viewers can see what is inside the region they have
+ * drawn. It reads the store's selected region, or the `region` you set. It counts the items inside
+ * that the filters match, the items the viewer may see there and the marks drawn there. The drawn
+ * marks are listed below the counts, and clicking one picks it.
  *
- * While its counts are not shown and the server cannot be reached or did not answer, the state line
- * says so in the status strip's words, Server unreachable or Server did not answer, in place of
- * Counting or Selection refused. Where the server was too busy to count the selection, it says
- * Server busy, with Retry.
+ * The region acts as a filter, which means the map and every other count narrow to it once it
+ * settles. Outside flips it to everything outside the shape, and Clear removes it. The counts are
+ * approximate when the server had to count an area around the shape, and the state line's tooltip
+ * says when that is so. Export and Save as artifact are shown disabled because they are not
+ * available yet.
  *
- * A selection is a filter: the map and every count narrow to it once it settles. Not built yet:
- * *Export* and *Save as artifact*, which need server routes; their buttons are disabled with the
- * reason on hover.
- *
- * @summary The selected region's counts, marks and actions.
+ * @summary A card showing the counts and marks inside the selected region.
  * @tagname mosaica-selection
  * @category Elements
- * @fires {CustomEvent<MosaicaEventDetails['mosaica-selectchange']>} mosaica-selectchange - Clear
- *   (with `shape` null) or Outside and Inside (with the new shape and `status` `loading`) was
- *   pressed.
+ * @fires {CustomEvent<MosaicaEventDetails['mosaica-selectchange']>} mosaica-selectchange - Clear,
+ *   Outside or Inside was pressed.
  * @csspart title - The heading, with the shape's kind.
- * @csspart state - The state line, with `data-state`; its tooltip says whether the counts are
- *   exact for the shape or for a cover.
+ * @csspart state - The state line, with `data-state`. Its tooltip says whether the counts are exact
+ *   for the shape.
  * @csspart refusal - The words "Selection refused", or "Server busy", with `data-code` set to the
  *   refusal's code.
- * @csspart reason - The server's reason for the refusal, on a line under "Selection refused".
- * @csspart retry - The Retry button, when the selection's count was refused by a server too busy.
+ * @csspart reason - The server's reason for the refusal, under "Selection refused".
+ * @csspart retry - The Retry button, shown if the server was too busy to count the selection.
  * @csspart counts - The counts.
  * @csspart count-served - The `<mosaica-count>` of marks shown inside.
- * @csspart count-matched - The `<mosaica-count>` matched inside (or outside).
- * @csspart count-visible - The `<mosaica-count>` visible inside (or outside).
+ * @csspart count-matched - The `<mosaica-count>` of items the filters match inside (or outside).
+ * @csspart count-visible - The `<mosaica-count>` of items the viewer may see inside (or outside).
  * @csspart label - The heading above the list.
- * @csspart items - The list of held marks inside.
- * @csspart item - One held mark, by `mosaica_id`.
+ * @csspart items - The list of drawn marks inside.
+ * @csspart item - One drawn mark, by `mosaica_id`.
  * @csspart actions - The action buttons.
  * @csspart action - One action button.
  */
@@ -133,7 +127,7 @@ let MosaicaSelection = (() => {
     `
         ];
         #region_accessor_storage = __runInitializers(this, _region_initializers, null);
-        /** The region to show in place of the store's `region` projection. */
+        /** A region to show instead of the store's `region` projection. */
         get region() { return this.#region_accessor_storage; }
         set region(value) { this.#region_accessor_storage = value; }
         get shown() {

package/dist/states.d.ts

@@ -1,29 +1,24 @@
 import { nothing, type TemplateResult } from 'lit';
 import type { Refusal, Store, StatusProjection } from '@mosaicajs/client';
 /**
- * The ten panel states. Every panel shows its state in one `part="state"` region, with
- * `data-state` set to it, so one rule restyles every panel. Each follows from the store's `status`
- * projection:
+ * The state of a panel. Every element shows its state in its `part="state"` element, with
+ * `data-state` set to one of these, so one CSS rule can style the same state across every panel.
  *
- * | state | from `status` |
+ * | State | Meaning |
  * |---|---|
- * | detached | no store |
- * | loading | `idle` or `loading` |
- * | retrying | `retrying`, or `unreachable` |
- * | shown | `shown` |
- * | empty | `empty` |
- * | refused | `refused` |
- * | unanswered | `refused` with a `5xx` whose body is not a Mosaica error, such as a gateway's `504` |
- * | busy | `refused` with a `429` still answered after the store's retries, whatever its code |
- * | expired | the `expired` flag: `expired-token`, a `bad-credential` on a token this store used, or `expiresAt` passed |
- * | stale | `shown` with `stale` |
+ * | `detached` | The element has no store. |
+ * | `loading` | The store is connecting or fetching. |
+ * | `retrying` | The server cannot be reached, or the store is asking again. What is drawn stays. |
+ * | `shown` | The panel shows the server's answer. |
+ * | `empty` | The server answered, with nothing to show. |
+ * | `refused` | The server refused the request. |
+ * | `unanswered` | The server failed with a `5xx` that is not a Mosaica error, such as a gateway's `504`. |
+ * | `busy` | The server is too busy (`429`), even after the store's retries. |
+ * | `expired` | The session expired: the token is past its expiry, or the server no longer accepts it. |
+ * | `stale` | The panel shows an answer, but the data has changed since it was fetched. Refresh fetches it again. |
  *
- * `expired` is a named refusal and wins over `refused`. While the server cannot be reached the state
- * is `retrying` whatever the last answer was, since the store is asking again; what is drawn stays.
- * `unanswered` is a server error that says nothing about this viewer, so it is not shown as a
- * refusal; the store does not ask again until Retry. `busy` is the server shedding load, which says
- * nothing about this viewer either, and the store does not ask again until Retry.
- * `stale` is `shown` with the picture older than the numbers.
+ * In the `unanswered` and `busy` states the store does not ask again until the viewer presses
+ * Retry.
  */
 export type PanelState = 'detached' | 'loading' | 'retrying' | 'shown' | 'empty' | 'refused' | 'unanswered' | 'busy' | 'expired' | 'stale';
 export declare function stateOf(status: StatusProjection | null | undefined): PanelState;

package/dist/status.d.ts

@@ -2,61 +2,49 @@ import { nothing, type TemplateResult } from 'lit';
 import { MosaicaElement } from './base.js';
 import './count.js';
 /**
- * The view's state and counts on one line: `● | 16,822,190 of 21,406,522 match | 5,390 shown`.
- * The counts are the store's counts in view (`ViewProjection.inView`): over the camera's box, or
- * over the selected region while one is selected, as the selection card counts it. While a
- * highlight is set, a cell reads `N highlighted of M`, M being the matched count, and the
- * match cell is left out unless a filter or selection narrows what matches. While the view is up to
- * date the first cell is a dot alone, titled "Up to date", and while it updates a grey dot alone,
- * titled "Updating", so the strip keeps its width through a pan. Where the viewer can see no item in
- * the view at all, it is a grey dot alone titled "Nothing visible to you", which the map says in
- * words. Otherwise it names the state in two or three words beside its dot (Connecting,
- * Reconnecting, Server unreachable, Server did not answer, Server busy, Nothing in view, Data
- * updated, View refused, Session expired) with the action the state offers: Refresh when the data
- * changed, Retry when the view was refused, the server did not answer or is too busy, and Sign in
- * on expiry where `reauthorise` is set. View refused has the server's reason on a line under it.
- * The counts grey out while they are not current. The strip sizes to its content and does not
- * wrap. `compact` shortens the figures (`16.8M of 21.4M match`) and drops the shown count.
- * `expanded` renders the figures again as a card below the strip.
+ * Use the status line with a map so that viewers know whether what they see is current and how much
+ * of the data it covers. A typical line reads `● | 16,822,190 of 21,406,522 match | 5,390 shown`,
+ * where the first figure is the items the filters match out of those the viewer may see. The
+ * figures count the camera's box, or the selected region while there is one. While a highlight is
+ * set, the counts cell reads `N highlighted of M`.
  *
- * The state cell is an `aria-live` region, so a refusal, an expiry or a change of data is announced;
- * the counts are not, so a pan does not read them out. The
- * state is one of the ten panel states (see `PanelState`); the refusal behind it stays in the
- * store's `status.refusal`, which `mosaica-statechange` carries, and the refusal's code is on the
- * refusal part's `data-code`.
+ * While the view is up to date, the first cell is a dot alone. When something goes wrong, the cell
+ * names the state and offers a button if the viewer can act, such as Retry when the server is busy.
+ * Sign in appears when the session expires only if you have set `reauthorise`.
  *
- * @summary The state and the counts of the view, on one line.
+ * Screen readers announce a refusal or an expiry, because the state cell is an `aria-live` region.
+ * The counts sit outside it, so they are not read out every time the map pans.
+ *
+ * @summary A status line showing whether the map is up to date and how many items it shows.
  * @tagname mosaica-status
  * @category Elements
- * @fires {CustomEvent<MosaicaEventDetails['mosaica-statechange']>} mosaica-statechange - On every
- *   change of panel state, including the first render, with the refusal behind it.
- * @fires {CustomEvent<MosaicaEventDetails['mosaica-expired']>} mosaica-expired - Once each time the
- *   session expires.
+ * @fires {CustomEvent<MosaicaEventDetails['mosaica-statechange']>} mosaica-statechange - The panel
+ *   state changed, including on the first render.
+ * @fires {CustomEvent<MosaicaEventDetails['mosaica-expired']>} mosaica-expired - The session expired.
+ *   Fires once each time.
  * @csspart strip - The one-line strip.
  * @csspart state - The state's dot and words, with `data-state` set to the panel state.
  * @csspart refusal - The words "View refused", or "Server busy", with `data-code` set to the
  *   refusal's code.
- * @csspart reason - The server's reason for a refusal, as it sent it, on a line under "View
- *   refused".
- * @csspart refresh - The Refresh button, when the data changed under the view.
- * @csspart retry - The Retry button, when the view was refused or the server did not answer or is
- *   too busy.
- * @csspart reauthorise - The Sign in button, on expiry where `reauthorise` is set.
+ * @csspart reason - The server's reason for a refusal, under "View refused".
+ * @csspart refresh - The Refresh button, shown when the data has changed.
+ * @csspart retry - The Retry button, after a refusal, no answer or a busy server.
+ * @csspart reauthorise - The Sign in button, shown on expiry if `reauthorise` is set.
  * @csspart count-shown - The `<mosaica-count>` of marks shown.
- * @csspart count-matched - The `<mosaica-count>` matched by the filters.
- * @csspart count-highlighted - The `<mosaica-count>` the highlight matched, while a highlight is set.
+ * @csspart count-matched - The `<mosaica-count>` of items the filters match.
+ * @csspart count-highlighted - The `<mosaica-count>` of highlighted items, while a highlight is set.
  * @csspart count-of - The matched count the highlighted count is out of, while a highlight is set.
  * @csspart count-visible - The `<mosaica-count>` of items the viewer may see here, which the matched
  *   count is out of.
- * @csspart card - The card of figures, under `expanded`.
+ * @csspart card - The card of figures, when `expanded` is set.
  */
 export declare class MosaicaStatus extends MosaicaElement {
     static styles: import("lit").CSSResult[];
-    /** Renders the figures again as a card below the strip. */
+    /** Adds a card of the figures below the strip. */
     accessor expanded: boolean;
-    /** Shortens the figures to one decimal (`16.8M`) and drops the shown count, where room is short. */
+    /** Shortens the figures to one decimal (`16.8M`) and drops the shown count. */
     accessor compact: boolean;
-    /** Called by the Sign in button that the expired state shows; without it, no button. */
+    /** A function the Sign in button calls when the session has expired. Without it there is no Sign in button. */
     accessor reauthorise: (() => void) | null;
     private lastState;
     private expiryFired;