@prestack/thread-ui 0.1.1 → 0.1.3

package/dist/ui/generators/variants.js

@@ -6,12 +6,12 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { existsSync, readFileSync, writeFileSync } from "@prestack/thread/core/files";
+import { existsSync, readFileSync, writeFileSync } from '@prestack/thread/integrations/disk';
 import { basename, join, resolve } from 'node:path';
 import { argv, stdout } from 'node:process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { exit, invoked } from "@prestack/thread/core/invoked";
-import { findTree, inTree, strayFiles } from "@prestack/thread/core/tree";
+import { exit, invoked } from '@prestack/thread/core/invoked';
+import { findTree, inTree, strayFiles } from '@prestack/thread/core/tree';
 export function nameOf(id) {
     return id.replace(/-/g, '_').toUpperCase();
 }

package/dist/ui/generators/variants.ts

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync, readFileSync, writeFileSync } from '@prestack/thread/core/files'
+import { existsSync, readdirSync, readFileSync, writeFileSync } from '@prestack/thread/integrations/disk'
 import { basename, dirname, join, resolve } from 'node:path'
 import { argv, stdout } from 'node:process'
 import { fileURLToPath, pathToFileURL } from 'node:url'

package/dist/ui/i18n/catalogs/en.js

@@ -1,4 +1,4 @@
-import { defineCatalog, msg } from "../types.js";
+import { defineCatalog, msg } from '../types.js';
 export const en = defineCatalog({
     'errors.auth.unauthenticated.title': 'You need to sign in to do this',
     'errors.auth.invalid_credentials.title': 'That email or password did not match',

package/dist/ui/i18n/format.js

@@ -1,4 +1,4 @@
-import { parseMessage } from "./parse.js";
+import { parseMessage } from './parse.js';
 export class MissingParamError extends Error {
     param;
     constructor(param, message) {

package/dist/ui/i18n/translator.js

@@ -1,5 +1,5 @@
-import { formatMessage } from "./format.js";
-import { entryText } from "./types.js";
+import { formatMessage } from './format.js';
+import { entryText } from './types.js';
 export class UnknownMessageKeyError extends Error {
     key;
     constructor(key, locale) {

package/dist/ui/material.d.ts

@@ -6,15 +6,15 @@ export interface Setting {
     readonly asks?: Readonly<Record<string, string | number>>;
 }
 export declare const BOUND: {
-    readonly background: readonly ["colour", "gradient", "texture", "noise", "img"];
-    readonly backgroundImage: readonly ["gradient", "texture", "noise", "img"];
-    readonly backdropFilter: readonly ["blur"];
-    readonly borderWidth: readonly ["edge"];
-    readonly borderStyle: readonly ["line"];
-    readonly borderColor: readonly ["colour"];
-    readonly boxShadow: readonly ["shadow"];
-    readonly color: readonly ["colour"];
-    readonly opacity: readonly ["opacity"];
+    readonly background: readonly ['colour', 'gradient', 'texture', 'noise', 'img'];
+    readonly backgroundImage: readonly ['gradient', 'texture', 'noise', 'img'];
+    readonly backdropFilter: readonly ['blur'];
+    readonly borderWidth: readonly ['edge'];
+    readonly borderStyle: readonly ['line'];
+    readonly borderColor: readonly ['colour'];
+    readonly boxShadow: readonly ['shadow'];
+    readonly color: readonly ['colour'];
+    readonly opacity: readonly ['opacity'];
 };
 type Property = keyof typeof BOUND;
 type MaterialSettingFor<P extends Property> = {
@@ -39,9 +39,9 @@ export interface Material {
         readonly sets: Readonly<Record<string, readonly MaterialSetting[]>>;
     }[];
 }
-export declare const FREE: readonly ["transition", "outline"];
+export declare const FREE: readonly ['transition', 'outline'];
 export declare const material: <const T extends Material>(one: T & {
-    readonly sets: { readonly [I in keyof T["sets"]]: T["sets"][I] extends {
+    readonly sets: { readonly [I in keyof T['sets']]: T['sets'][I] extends {
         readonly is: infer Said;
     } ? {
         readonly is: Wearing<Said & string>;

package/dist/ui/material.js

@@ -1,4 +1,4 @@
-import { held, naming, sheeted } from "./token.js";
+import { held, naming, sheeted } from './token.js';
 export const BOUND = {
     background: ['colour', 'gradient', 'texture', 'noise', 'img'],
     backgroundImage: ['gradient', 'texture', 'noise', 'img'],

package/dist/ui/materials/mat_bordered.d.ts

@@ -1,22 +1,22 @@
 export declare const BORDERED: {
-    readonly id: "bordered";
+    readonly id: 'bordered';
     readonly sets: readonly [{
-        readonly property: "background";
-        readonly is: "colour-surface";
+        readonly property: 'background';
+        readonly is: 'colour-surface';
     }, {
-        readonly property: "borderWidth";
-        readonly is: "edge-thick";
+        readonly property: 'borderWidth';
+        readonly is: 'edge-thick';
     }, {
-        readonly property: "borderStyle";
-        readonly is: "line-solid";
+        readonly property: 'borderStyle';
+        readonly is: 'line-solid';
     }, {
-        readonly property: "borderColor";
-        readonly is: "colour-ink";
+        readonly property: 'borderColor';
+        readonly is: 'colour-ink';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-hard";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-hard';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
 };

package/dist/ui/materials/mat_bordered.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const BORDERED = material({
     id: 'bordered',
     sets: [

package/dist/ui/materials/mat_ceramic.d.ts

@@ -1,22 +1,22 @@
 export declare const CERAMIC: {
-    readonly id: "ceramic";
+    readonly id: 'ceramic';
     readonly sets: readonly [{
-        readonly property: "backgroundImage";
-        readonly is: "gradient-sheen";
+        readonly property: 'backgroundImage';
+        readonly is: 'gradient-sheen';
     }, {
-        readonly property: "borderWidth";
-        readonly is: "edge-hair";
+        readonly property: 'borderWidth';
+        readonly is: 'edge-hair';
     }, {
-        readonly property: "borderStyle";
-        readonly is: "line-solid";
+        readonly property: 'borderStyle';
+        readonly is: 'line-solid';
     }, {
-        readonly property: "borderColor";
-        readonly is: "colour-edge-ceramic";
+        readonly property: 'borderColor';
+        readonly is: 'colour-edge-ceramic';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-2";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-2';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
 };

package/dist/ui/materials/mat_ceramic.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const CERAMIC = material({
     id: 'ceramic',
     sets: [

package/dist/ui/materials/mat_clay.d.ts

@@ -1,22 +1,22 @@
 export declare const CLAY: {
-    readonly id: "clay";
+    readonly id: 'clay';
     readonly sets: readonly [{
-        readonly property: "background";
-        readonly is: "colour-surface";
+        readonly property: 'background';
+        readonly is: 'colour-surface';
     }, {
-        readonly property: "borderWidth";
-        readonly is: "edge-thin";
+        readonly property: 'borderWidth';
+        readonly is: 'edge-thin';
     }, {
-        readonly property: "borderStyle";
-        readonly is: "line-solid";
+        readonly property: 'borderStyle';
+        readonly is: 'line-solid';
     }, {
-        readonly property: "borderColor";
-        readonly is: "colour-edge-clay";
+        readonly property: 'borderColor';
+        readonly is: 'colour-edge-clay';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-2";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-2';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
 };

package/dist/ui/materials/mat_clay.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const CLAY = material({
     id: 'clay',
     sets: [

package/dist/ui/materials/mat_elevated.d.ts

@@ -1,32 +1,32 @@
 export declare const ELEVATED: {
-    readonly id: "elevated";
+    readonly id: 'elevated';
     readonly sets: readonly [{
-        readonly property: "background";
-        readonly is: "colour-surface";
+        readonly property: 'background';
+        readonly is: 'colour-surface';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-2";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-2';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
     readonly states: readonly [{
         readonly when: readonly ["hover"];
         readonly sets: readonly [{
-            readonly property: "boxShadow";
-            readonly is: "shadow-3";
+            readonly property: 'boxShadow';
+            readonly is: 'shadow-3';
         }];
     }, {
         readonly when: readonly ["active"];
         readonly sets: readonly [{
-            readonly property: "boxShadow";
-            readonly is: "shadow-1";
+            readonly property: 'boxShadow';
+            readonly is: 'shadow-1';
         }];
     }, {
         readonly when: readonly ["active", "hover"];
         readonly sets: readonly [{
-            readonly property: "boxShadow";
-            readonly is: "shadow-1";
+            readonly property: 'boxShadow';
+            readonly is: 'shadow-1';
         }];
     }];
 };

package/dist/ui/materials/mat_elevated.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const ELEVATED = material({
     id: 'elevated',
     sets: [

package/dist/ui/materials/mat_flat.d.ts

@@ -1,50 +1,50 @@
 export declare const FLAT: {
-    readonly id: "flat";
+    readonly id: 'flat';
     readonly sets: readonly [{
-        readonly property: "background";
-        readonly is: "colour-surface";
+        readonly property: 'background';
+        readonly is: 'colour-surface';
     }, {
-        readonly property: "borderWidth";
-        readonly is: "edge-hair";
+        readonly property: 'borderWidth';
+        readonly is: 'edge-hair';
     }, {
-        readonly property: "borderStyle";
-        readonly is: "line-solid";
+        readonly property: 'borderStyle';
+        readonly is: 'line-solid';
     }, {
-        readonly property: "borderColor";
-        readonly is: "colour-edge-faint";
+        readonly property: 'borderColor';
+        readonly is: 'colour-edge-faint';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-1";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-1';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
     readonly states: readonly [{
         readonly when: readonly ["hover"];
         readonly sets: readonly [{
-            readonly property: "boxShadow";
-            readonly is: "shadow-2";
+            readonly property: 'boxShadow';
+            readonly is: 'shadow-2';
         }];
     }, {
         readonly when: readonly ["focus"];
         readonly sets: readonly [{
-            readonly property: "borderColor";
-            readonly is: "colour-accent";
+            readonly property: 'borderColor';
+            readonly is: 'colour-accent';
         }, {
-            readonly property: "borderWidth";
-            readonly is: "edge-thick";
+            readonly property: 'borderWidth';
+            readonly is: 'edge-thick';
         }];
     }, {
         readonly when: readonly ["focus", "hover"];
         readonly sets: readonly [{
-            readonly property: "borderColor";
-            readonly is: "colour-accent";
+            readonly property: 'borderColor';
+            readonly is: 'colour-accent';
         }, {
-            readonly property: "borderWidth";
-            readonly is: "edge-thick";
+            readonly property: 'borderWidth';
+            readonly is: 'edge-thick';
         }, {
-            readonly property: "boxShadow";
-            readonly is: "shadow-2";
+            readonly property: 'boxShadow';
+            readonly is: 'shadow-2';
         }];
     }];
 };

package/dist/ui/materials/mat_flat.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const FLAT = material({
     id: 'flat',
     sets: [

package/dist/ui/materials/mat_glass.d.ts

@@ -1,32 +1,32 @@
 export declare const GLASS: {
-    readonly id: "glass";
+    readonly id: 'glass';
     readonly sets: readonly [{
-        readonly property: "background";
-        readonly is: "colour-glass";
+        readonly property: 'background';
+        readonly is: 'colour-glass';
     }, {
-        readonly property: "backdropFilter";
-        readonly is: "blur-md";
+        readonly property: 'backdropFilter';
+        readonly is: 'blur-md';
     }, {
-        readonly property: "borderWidth";
-        readonly is: "edge-hair";
+        readonly property: 'borderWidth';
+        readonly is: 'edge-hair';
     }, {
-        readonly property: "borderStyle";
-        readonly is: "line-solid";
+        readonly property: 'borderStyle';
+        readonly is: 'line-solid';
     }, {
-        readonly property: "borderColor";
-        readonly is: "colour-edge-glass";
+        readonly property: 'borderColor';
+        readonly is: 'colour-edge-glass';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-3";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-3';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
     readonly states: readonly [{
         readonly when: readonly ["hover"];
         readonly sets: readonly [{
-            readonly property: "backdropFilter";
-            readonly is: "blur-lg";
+            readonly property: 'backdropFilter';
+            readonly is: 'blur-lg';
         }];
     }];
 };

package/dist/ui/materials/mat_glass.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const GLASS = material({
     id: 'glass',
     sets: [

package/dist/ui/materials/mat_lit.d.ts

@@ -1,22 +1,22 @@
 export declare const LIT: {
-    readonly id: "lit";
+    readonly id: 'lit';
     readonly sets: readonly [{
-        readonly property: "background";
-        readonly is: "colour-surface-lit";
+        readonly property: 'background';
+        readonly is: 'colour-surface-lit';
     }, {
-        readonly property: "borderWidth";
-        readonly is: "edge-thin";
+        readonly property: 'borderWidth';
+        readonly is: 'edge-thin';
     }, {
-        readonly property: "borderStyle";
-        readonly is: "line-solid";
+        readonly property: 'borderStyle';
+        readonly is: 'line-solid';
     }, {
-        readonly property: "borderColor";
-        readonly is: "colour-edge-lit";
+        readonly property: 'borderColor';
+        readonly is: 'colour-edge-lit';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-glow";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-glow';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
 };

package/dist/ui/materials/mat_lit.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const LIT = material({
     id: 'lit',
     sets: [

package/dist/ui/materials/mat_moulded.d.ts

@@ -1,16 +1,16 @@
 export declare const MOULDED: {
-    readonly id: "moulded";
+    readonly id: 'moulded';
     readonly sets: readonly [{
-        readonly property: "background";
-        readonly is: "colour-page";
+        readonly property: 'background';
+        readonly is: 'colour-page';
     }, {
-        readonly property: "borderStyle";
-        readonly is: "line-off";
+        readonly property: 'borderStyle';
+        readonly is: 'line-off';
     }, {
-        readonly property: "boxShadow";
-        readonly is: "shadow-moulded";
+        readonly property: 'boxShadow';
+        readonly is: 'shadow-moulded';
     }, {
-        readonly property: "color";
-        readonly is: "colour-ink";
+        readonly property: 'color';
+        readonly is: 'colour-ink';
     }];
 };

package/dist/ui/materials/mat_moulded.js

@@ -1,4 +1,4 @@
-import { material } from "../material.js";
+import { material } from '../material.js';
 export const MOULDED = material({
     id: 'moulded',
     sets: [

package/dist/ui/materials.d.ts

@@ -1,46 +1,46 @@
 import type { Threaded } from '@prestack/thread/core/thread';
 export declare const MATERIALS: {
-    readonly id: "material";
-    readonly at: "thread/ui/materials.ts";
-    readonly files: "ui/mat_*.ts";
-    readonly describes: "A combination of style guide values that gives one specific appearance, worn by any variant that names it: glass, clay, a glaze. It composes and never computes, because every value it sets is a name the style guide holds and never a raw one, which is what lets one material be worn by many variants. Each row names a file prefixed `mat_`, and that file is the material; a file under it that no row names is not a material but a file somebody wrote. An app adds its own to this same list, and a row that goes missing breaks the build, because what the framework offers is not an app’s to withdraw. These are materials and not aesthetics: Neumorphism, Claymorphism and Cyberpunk are templates, and a template is what picks a material.";
+    readonly id: 'material';
+    readonly at: 'thread/ui/materials.ts';
+    readonly files: 'ui/mat_*.ts';
+    readonly describes: 'A combination of style guide values that gives one specific appearance, worn by any variant that names it: glass, clay, a glaze. It composes and never computes, because every value it sets is a name the style guide holds and never a raw one, which is what lets one material be worn by many variants. Each row names a file prefixed `mat_`, and that file is the material; a file under it that no row names is not a material but a file somebody wrote. An app adds its own to this same list, and a row that goes missing breaks the build, because what the framework offers is not an app’s to withdraw. These are materials and not aesthetics: Neumorphism, Claymorphism and Cyberpunk are templates, and a template is what picks a material.';
     readonly version: 1;
     readonly cites: readonly [{
-        readonly on: "2026-08-25";
-        readonly said: "Style guides they can be used for simple pickings that need no thinking. We can pick colours and basic effects for using the app. Materials however are for more complex and detailed work. Materials.ts is a declaration sheet, SSOT, and each row is a file, mat_";
+        readonly on: '2026-08-25';
+        readonly said: 'Style guides they can be used for simple pickings that need no thinking. We can pick colours and basic effects for using the app. Materials however are for more complex and detailed work. Materials.ts is a declaration sheet, SSOT, and each row is a file, mat_';
     }];
     readonly declares: readonly [{
-        readonly id: "glass";
-        readonly at: "thread/ui/materials/mat_glass.ts";
-        readonly describes: "A pane you can see through, with what is behind it softened and desaturation corrected for.";
+        readonly id: 'glass';
+        readonly at: 'thread/ui/materials/mat_glass.ts';
+        readonly describes: 'A pane you can see through, with what is behind it softened and desaturation corrected for.';
     }, {
-        readonly id: "flat";
-        readonly at: "thread/ui/materials/mat_flat.ts";
-        readonly describes: "Paper. A plain filled panel with a hairline and almost no lift — the same tokens as glass, asked more quietly.";
+        readonly id: 'flat';
+        readonly at: 'thread/ui/materials/mat_flat.ts';
+        readonly describes: 'Paper. A plain filled panel with a hairline and almost no lift — the same tokens as glass, asked more quietly.';
     }, {
-        readonly id: "elevated";
-        readonly at: "thread/ui/materials/mat_elevated.ts";
-        readonly describes: "Something lifted off the page, reading by its shadow rather than by any outline.";
+        readonly id: 'elevated';
+        readonly at: 'thread/ui/materials/mat_elevated.ts';
+        readonly describes: 'Something lifted off the page, reading by its shadow rather than by any outline.';
     }, {
-        readonly id: "bordered";
-        readonly at: "thread/ui/materials/mat_bordered.ts";
-        readonly describes: "Ink on paper — a hard outline and a shadow with no blur, offset like a stamp.";
+        readonly id: 'bordered';
+        readonly at: 'thread/ui/materials/mat_bordered.ts';
+        readonly describes: 'Ink on paper — a hard outline and a shadow with no blur, offset like a stamp.';
     }, {
-        readonly id: "moulded";
-        readonly at: "thread/ui/materials/mat_moulded.ts";
-        readonly describes: "Pressed out of the page rather than laid on it. Its fill is the page itself, and its relief is one shadow cast twice in opposite directions.";
+        readonly id: 'moulded';
+        readonly at: 'thread/ui/materials/mat_moulded.ts';
+        readonly describes: 'Pressed out of the page rather than laid on it. Its fill is the page itself, and its relief is one shadow cast twice in opposite directions.';
     }, {
-        readonly id: "clay";
-        readonly at: "thread/ui/materials/mat_clay.ts";
-        readonly describes: "Something soft and inflated, lit from above — an outer shadow it sits in and an inset highlight along its top edge.";
+        readonly id: 'clay';
+        readonly at: 'thread/ui/materials/mat_clay.ts';
+        readonly describes: 'Something soft and inflated, lit from above — an outer shadow it sits in and an inset highlight along its top edge.';
     }, {
-        readonly id: "lit";
-        readonly at: "thread/ui/materials/mat_lit.ts";
-        readonly describes: "Something that emits rather than reflects. Its glow is a shadow cast from nowhere in particular, and it names no colour of its own.";
+        readonly id: 'lit';
+        readonly at: 'thread/ui/materials/mat_lit.ts';
+        readonly describes: 'Something that emits rather than reflects. Its glow is a shadow cast from nowhere in particular, and it names no colour of its own.';
     }, {
-        readonly id: "ceramic";
-        readonly at: "thread/ui/materials/mat_ceramic.ts";
-        readonly describes: "A glazed surface with the light falling down its face. The one material that asks for a gradient rather than a fill.";
+        readonly id: 'ceramic';
+        readonly at: 'thread/ui/materials/mat_ceramic.ts';
+        readonly describes: 'A glazed surface with the light falling down its face. The one material that asks for a gradient rather than a fill.';
     }];
 };
 export declare function nameOf(id: string): string;

package/dist/ui/materials.js

@@ -6,12 +6,12 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { existsSync, readFileSync, writeFileSync } from "@prestack/thread/core/files";
+import { existsSync, readFileSync, writeFileSync } from '@prestack/thread/integrations/disk';
 import { basename, join } from 'node:path';
 import { argv, stdout } from 'node:process';
 import { pathToFileURL } from 'node:url';
-import { exit, invoked } from "@prestack/thread/core/invoked";
-import { findTree, inTree, strayFiles } from "@prestack/thread/core/tree";
+import { exit, invoked } from '@prestack/thread/core/invoked';
+import { findTree, inTree, strayFiles } from '@prestack/thread/core/tree';
 export const MATERIALS = {
     id: 'material',
     at: 'thread/ui/materials.ts',

package/dist/ui/materials.ts

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync, readFileSync, writeFileSync } from '@prestack/thread/core/files'
+import { existsSync, readdirSync, readFileSync, writeFileSync } from '@prestack/thread/integrations/disk'
 import { basename, dirname, join } from 'node:path'
 import { argv, stdout } from 'node:process'
 import { pathToFileURL } from 'node:url'

package/dist/ui/modes.d.ts

@@ -7,9 +7,9 @@ export declare const holds: readonly [Omit<Threaded, "at"> & {
     readonly is: string;
 }];
 export declare const MODES: {
-    readonly id: "mode";
+    readonly id: 'mode';
     readonly at: "thread/ui/modes.ts";
-    readonly describes: "Every way a reader’s own device can ask for a different look, and the query that answers it. A mode is chosen for the app rather than by it, which is what tells it from a theme — and a theme has its own modes, so the two are dimensions rather than one list. A mode changes what the variables hold, never what a material or a variant says.";
+    readonly describes: 'Every way a reader’s own device can ask for a different look, and the query that answers it. A mode is chosen for the app rather than by it, which is what tells it from a theme — and a theme has its own modes, so the two are dimensions rather than one list. A mode changes what the variables hold, never what a material or a variant says.';
     readonly version: 1;
     readonly cites: {
         on: string;