lintje 0.2.0 → 0.3.0

package/dist-elements/types/components/feedback/error-page/error-page.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `<lintje-error-page>` — the page in place of the one the reader asked for: not found, no
+ * access, a failure, or not available.
+ *
+ * It says why in words and shows the way onward. The server sends the HTTP status and the
+ * document's `<title>`; the element only draws. The default slot takes what helps under the text,
+ * such as a search field. Below 768 px the actions stand under each other, and a `lintje-button`
+ * with `block` fills the width.
+ *
+ * Events: `lintje-navigate` `{ href }` (a plain click on one of `links`).
+ */
+import { type PropertyDeclarations, type TemplateResult } from 'lit';
+import { LintjeElement } from '../../../core/element.js';
+import '../../actions/copy-button/copy-button.js';
+import '../../tables/description-list/description-list.js';
+export interface ErrorPageLink {
+    label: string;
+    href: string;
+}
+export declare class LintjeErrorPage extends LintjeElement {
+    static styles: import("lit").CSSResult[];
+    static properties: PropertyDeclarations;
+    /**
+     * The HTTP status as the server sent it ("404"): a small line above the heading, with the lock
+     * for 401 and 403 and the outage mark for a 5xx. Without it there is no code line.
+     */
+    code?: string;
+    /** What is the matter, in words: "Deze pagina bestaat niet". */
+    heading?: string;
+    /** Why, and what the reader can do. */
+    text?: string;
+    /** 2 in `lintje-shell`, whose `name` is the page's h1; 1 for a page outside the shell. */
+    level: 1 | 2;
+    /** "Verder naar": the pages a reader most likely wanted instead. */
+    links: ErrorPageLink[];
+    /** The code the service desk looks the failure up by, with a copy button. */
+    reference?: string;
+    /** When it happened, as the host wrote it ("11 oktober 2026, 14.32 uur"). */
+    occurred?: string;
+    hasActions: boolean;
+    private follow;
+    private renderCode;
+    private renderHeading;
+    private renderReference;
+    private renderLinks;
+    protected render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lintje-error-page': LintjeErrorPage;
+    }
+}

package/dist-elements/types/components/feedback/job-list/job-list.d.ts

@@ -1,23 +1,20 @@
 /**
- * `<lintje-job-list>` — the queue of long tasks: what runs, what is done and what went wrong. Its
- * rows are the work list's rows (`lintje-list`): the state as a word, the progress as a bar, one
- * action in plain sight per state, and a row with an `href` opening it: a done job's result, or
- * what runs where it can be followed (a live recording). "Verwijderen" is behind a done job's ⋮. Where every job is done, "Klaar" is left out: in a list of finished work alone
- * the state is noise.
+ * `<lintje-job-list>` — the queue of long tasks: what runs, what is done and what went wrong, in
+ * the work list's rows (`lintje-list`).
  *
- * A job that changes state is read out once, as a sentence ("Rapport.docx is mislukt. Het
- * bestand is beschadigd."), from a status region of its own; the list itself is not live, so a
- * moving percentage does not chatter. It never fetches: the host sets `jobs` again when a job
- * moves. When the last job goes with the focus on it, the focus goes to that region.
+ * It never fetches: the host sets `jobs` again when a job moves. A job that changes state is read
+ * out once, as a sentence, from a status region of its own; the list itself is not live. A row
+ * with an `href` opens a done job's result, or what runs where it can be followed.
  *
- * Events: `lintje-job-cancel`, `lintje-job-retry`, `lintje-job-resume`, `lintje-job-remove`
- * (detail: the job's id), `lintje-navigate` `{ href }` (a row with an `href`; cancel it to route).
+ * Events: `lintje-job-cancel`, `lintje-job-retry`, `lintje-job-resume`, `lintje-job-remove`, each
+ * `string` (the job's id), `lintje-navigate` `{ href }` (a row with an `href`; cancel it to route).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
 import '../../tables/list/list.js';
 import type { ListItem } from '../../tables/list/list.js';
-export type JobState = 'queued' | 'busy' | 'paused' | 'done' | 'error' | 'cancelled';
+import { type WorkState } from '../../../primitives/shared/tone.js';
+export type JobState = WorkState;
 export interface Job {
     id: string;
     name: string;

package/dist-elements/types/components/feedback/level-meter/level-meter.d.ts

@@ -1,11 +1,9 @@
 /**
  * `<lintje-level-meter>` — how loud the sound comes in, as bars with a word beside them: before a
- * recording to show the microphone works, during it to show it still does. The host measures and
- * sets `level` as often as it likes; the bars follow, without motion under reduced motion.
+ * recording to show the microphone works, during it to show it still does.
  *
- * `null` is not measured yet: flat bars and a dash, never "Stil" (rule 15).
- *
- * Events: none.
+ * The host measures and sets `level` as often as it likes; the bars follow, without motion under
+ * reduced motion.
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -14,7 +12,7 @@ export declare function levelWord(level: number): string;
 export declare class LintjeLevelMeter extends LintjeElement {
     static styles: import("lit").CSSResult;
     static properties: PropertyDeclarations;
-    /** The sound coming in, 0 to 1; `null` before it is measured. */
+    /** The sound coming in, 0 to 1; `null` before it is measured: flat bars, a dash, never "Stil". */
     level?: number | null;
     /** Draw the word beside the bars; without, the host says it (it is still the bars' name). */
     words: boolean;

package/dist-elements/types/components/feedback/recording-status/recording-status.d.ts

@@ -1,11 +1,10 @@
 /**
- * `<lintje-recording-status>` — how a running recording is doing, in the description list's cells:
- * how long it runs, how the sound comes in and, for a recording made elsewhere (a phone), how the
- * connection holds. Each meter has its word beside it, so the colour never speaks alone (rule 13).
+ * `<lintje-recording-status>` — how a running recording is doing, in the description list's
+ * cells: how long it runs, how the sound comes in and, for a recording made elsewhere (a phone),
+ * how the connection holds.
  *
- * The host measures; the element only shows. A value it does not have is a dash, never zero.
- *
- * Events: none.
+ * The host measures; the element only shows. Each meter has its word beside it, and a value it
+ * does not have is a dash, never zero.
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/feedback/streaming-text/streaming-text.d.ts

@@ -1,11 +1,11 @@
 /**
- * `<lintje-streaming-text>` — text that streams in while the server writes it. Plain text, never
- * HTML; a host wanting prose slots a `<lintje-prose>` once the stream is `done`. A screen reader
- * hears it per sentence from a polite live region; the visible box is `aria-busy` until the end.
- * The host owns the connection and sets `text` and `state`. `variant="plain"` drops the box and
- * takes the type of where it stands, for a surface that frames the text itself.
+ * `<lintje-streaming-text>` — text that streams in while the server writes it.
  *
- * Events: `lintje-stop` ("Stoppen"), `lintje-retry` ("Opnieuw").
+ * The host owns the connection and sets `text` and `state`. Plain text, never HTML: a host that
+ * wants prose slots a `<lintje-prose>` once the stream is `done`. A screen reader hears it per
+ * sentence.
+ *
+ * Events: `lintje-stop` ("Stoppen" was pressed), `lintje-retry` ("Opnieuw" was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -22,7 +22,10 @@ export declare class LintjeStreamingText extends LintjeElement {
     /** What happened, for `error`. Without it: the connection dropped and the text is not done. */
     message?: string;
     label: string;
-    /** `box` (default): the text in a framed box; `plain`: no box, the type of where it stands. */
+    /**
+     * `box` (default): the text in a framed box. `plain`: no box and the type of where it stands, for
+     * a surface that frames the text itself.
+     */
     variant: 'box' | 'plain';
     spoken: string[];
     private said;

package/dist-elements/types/components/feedback/toast/toast.d.ts

@@ -1,22 +1,21 @@
 /**
- * `<lintje-toast>` — the toast: a glyph carries the meaning, so colour is not the only signal
- * (rule 13). An error, and a toast with an action, stay until closed. A plain `ok` toast closes
- * after six seconds; the pointer on it or the focus in it holds it, and its six seconds start
- * again when both have left. Closing with the focus inside, it gives the focus back first.
+ * `<lintje-toast>` — a short message about what just happened; a glyph carries its meaning.
  *
- * It is a `role="status"` region drawn empty first, its content going in on the next frame: a
- * region that arrives together with its text is not announced, one that is filled is.
+ * The host owns whether it exists. A toast that closes by itself is held while the pointer is on
+ * it or the focus in it, and its six seconds start again when both have left. Closing with the
+ * focus inside, it gives the focus back first.
  *
- * Events: `lintje-close` (timed out or closed), `lintje-action`. The host owns whether it exists.
+ * Events: `lintje-close` (timed out or closed), `lintje-action` (its action was pressed).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
+export type ToastKind = 'ok' | 'error' | 'info' | 'warning';
 export declare class LintjeToast extends LintjeElement {
     #private;
     static styles: import("lit").CSSResult[];
     static properties: PropertyDeclarations;
-    /** `ok` closes itself after six seconds, unless it has an action; `error` stays. */
-    kind: 'ok' | 'error';
+    /** `ok` and `info` close after six seconds unless they have an action; `error` and `warning` stay. */
+    kind: ToastKind;
     /** The label of the one action, e.g. "Ongedaan maken". Without it there is none. */
     action?: string;
     filled: boolean;

package/dist-elements/types/components/filters/filter-bar/filter-bar.d.ts

@@ -1,8 +1,13 @@
 /**
- * `<lintje-filter-bar>` — the host's declared filters in the filter zone and, below 768 px,
- * the sheet. Values cross as the canonical strings the host writes to the URL. A change in the
- * bar commits at once; the sheet commits on "Toepassen". The host confirms with the next
- * `data`. Put one filter bar on a page: two would both write the count and own the sheet.
+ * `<lintje-filter-bar>` — the host's declared filters in the filter zone and, below 768 px, the
+ * sheet.
+ *
+ * Values cross as the canonical strings the host writes to the URL. A change in the bar commits at
+ * once, the sheet on "Toepassen"; the host confirms with the next `data`. Put one filter bar on a
+ * page: two would both write the count and own the sheet.
+ *
+ * Events: `lintje-values-change` `{ [key]: value }` (the filters that commit),
+ * `lintje-filters-open-change` `boolean` (the reader shows or hides the controls).
  */
 import { type PropertyDeclarations, type TemplateResult, type PropertyValues } from 'lit';
 import { LintjeElement, type FrameSettings } from '../../../core/element.js';

package/dist-elements/types/components/filters/filter-sheet/filter-sheet.d.ts

@@ -1,10 +1,10 @@
 /**
- * `<lintje-filter-sheet>` — the filters below 768 px. Nothing applies before "Toepassen"; the
- * owner keeps the draft and supplies the controls. Escape in an open popover closes only that
- * popover. Focus is trapped while open (`FocusTrap`).
+ * `<lintje-filter-sheet>` — the filters below 768 px, in a sheet that traps the focus while open.
  *
- * Events (bubbling, not composed): `lintje-filters-apply`, `lintje-sheet-close`,
- * `lintje-filters-reset`.
+ * Nothing applies before "Toepassen": the owner keeps the draft and supplies the controls. Escape
+ * in an open popover closes only that popover.
+ *
+ * Events: `lintje-filters-apply`, `lintje-sheet-close`, `lintje-filters-reset`.
  */
 import { nothing, type PropertyDeclarations, type TemplateResult, type PropertyValues } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/filters/filter-zone/filter-zone.d.ts

@@ -1,11 +1,11 @@
 /**
  * `<lintje-filter-zone>` — the filter bar: one place for everything that narrows the numbers.
  *
- * Expanded, scrolled (a sticky summary bar) and mobile (sentence only) states: see `zone-state.ts`.
- * The controls come in through the slot, the sentence as parts; the owner keeps the state.
+ * The controls come in through the slot and the sentence as parts; the owner keeps the state. The
+ * zone is expanded, scrolled (a sticky summary bar) or, below 768 px, the sentence only.
  *
- * Events (bubbling, not composed): `lintje-filters-reset`, `lintje-zone-open-change` (boolean),
- * `lintje-zone-scrolled-change` (boolean).
+ * Events: `lintje-filters-reset`, `lintje-zone-open-change` `boolean`,
+ * `lintje-zone-scrolled-change` `boolean`.
  */
 import { type PropertyDeclarations, type TemplateResult, type PropertyValues } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/forms/error-summary/error-summary.d.ts

@@ -1,13 +1,11 @@
 /**
  * `<lintje-error-summary>` — the error summary above a form, with a link to each field.
  *
- * With nothing to show it draws nothing. A link focuses the field, found by `name` or `id` in
- * the summary's own tree and, from a shadow root, in its host's light DOM (where `lintje-form`
- * draws it). The field is scrolled to the middle of the view, clear of a sticky top bar and of the
- * action bar below, however deep it stands in the form.
- * It never validates. `focus()` puts the focus on the frame (`tabindex="-1"`).
+ * It never validates, and with nothing to show it draws nothing. A link focuses the field, found
+ * by `name` or `id` in the summary's own tree or, from a shadow root, in its host's light DOM, and
+ * scrolls it into view clear of a sticky top bar and the form's action bar.
  *
- * Events: `lintje-retry` from the "Opnieuw proberen" button.
+ * Events: `lintje-retry` ("Opnieuw proberen" was pressed).
  */
 import { nothing, type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -33,6 +31,7 @@ export declare class LintjeErrorSummary extends LintjeElement {
     /** The label of the retry button under `message`; without it there is none. */
     retry?: string;
     get hasErrors(): boolean;
+    /** Puts the focus on the frame (`tabindex="-1"`). */
     focus(options?: FocusOptions): void;
     private goTo;
     protected render(): TemplateResult | typeof nothing;

package/dist-elements/types/components/forms/form/form.d.ts

@@ -2,12 +2,12 @@
  * `<lintje-form>` — collects the values of its light-DOM fields, keeps the draft, asks for one
  * submit and puts the host's errors under their fields.
  *
- * Its `<form>` is in the shadow root, so slotted fields have no form owner: the form's own key
- * and click handlers are the one submit. `lintje-values-change` is stopped so form input never
- * reaches the URL.
+ * Its `<form>` is in the shadow root, so slotted fields have no form owner: Enter and a submit
+ * button reach it through the element's own handlers, once. It stops `lintje-values-change`, so
+ * form input never reaches the URL.
  *
- * Events: `lintje-submit` `{ values }`, `lintje-invalid` (the errors), `lintje-dirty-change`
- * (boolean).
+ * Events: `lintje-submit` `{ values }`, `lintje-invalid` `FormErrors`, `lintje-dirty-change`
+ * `boolean`.
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/forms/form-actions/form-actions.d.ts

@@ -1,10 +1,9 @@
 /**
- * `<lintje-form-actions>` — the sticky action bar of a form: draft status left, slotted
- * `lintje-button`s right (the last, primary one). On `busy` the primary button turns `busy` and
- * the others `disabled`; leaving `busy` restores what each had. No shadow while stuck:
- * `--shadow-sticky` falls downwards, off-screen under a bottom bar. While connected it reserves
- * its height as the page scroller's `scroll-padding-bottom`, so a field the focus scrolls to is
- * not hidden behind it (WCAG 2.4.11). Events: none.
+ * `<lintje-form-actions>` — the sticky action bar of a form: the draft status on the left, the
+ * slotted `lintje-button`s on the right, the last one primary.
+ *
+ * While connected it reserves its height as the page scroller's `scroll-padding-bottom`, so a
+ * field the focus scrolls to is not hidden behind it.
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -16,7 +15,10 @@ export declare class LintjeFormActions extends LintjeElement {
     #private;
     static styles: import("lit").CSSResult[];
     static properties: PropertyDeclarations;
-    /** Set by the surrounding `lintje-form` (with `saved-at`); standing alone, the host sets it. */
+    /**
+     * Set by the surrounding `lintje-form` (with `saved-at`); standing alone, the host sets it. On
+     * `busy` the primary button turns `busy` and the others `disabled`; after, each has what it had.
+     */
     state: FormActionsState;
     /** When it was saved: "10:42" or anything `Date` parses. */
     savedAt?: string;

package/dist-elements/types/components/forms/form-section/form-section.d.ts

@@ -1,10 +1,6 @@
 /**
  * `<lintje-form-section>` — a group of fields with a heading and an explanation: a `<fieldset>`
- * with its `<legend>`, which holds an `<h3>` so the heading is in the page's outline. Bare inside
- * a tile, or a tile itself (`variant="tile"`).
- *
- * `disabled` sets `disabled` on every slotted control itself and hands back what each had: a
- * `<fieldset disabled>` in a shadow root disables nothing slotted.
+ * whose legend holds an `<h3>`, so the heading is in the page's outline.
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -16,7 +12,12 @@ export declare class LintjeFormSection extends LintjeElement {
     /** The legend; as a tile, the tile title. */
     heading: string;
     description?: string;
+    /** `plain`: bare, inside a tile; `tile`: a tile itself. */
     variant: FormSectionVariant;
+    /**
+     * Sets `disabled` on every slotted control and hands back what each had: a
+     * `<fieldset disabled>` in a shadow root disables nothing slotted.
+     */
     disabled: boolean;
     protected updated(changed: PropertyValues<this>): void;
     disconnectedCallback(): void;

package/dist-elements/types/components/forms/repeater/repeater.d.ts

@@ -1,12 +1,13 @@
 /**
- * `<lintje-repeater>` — a group of fields that repeats. The host writes the rows and owns the
- * list; the repeater asks, numbers and names the rows, and bounds them by `min` and `max`.
- * After an add, focus goes to the new row's first field; after a remove, to the remove button
- * of the row above (the add button when none is left). A live region says both.
- * It keeps no values and draws no undo toast.
+ * `<lintje-repeater>` — a group of fields that repeats.
  *
- * Events: `lintje-row-add` (detail: the index the new row gets) from the repeater, and
- * `lintje-row-remove` (detail: the row's index) from the row; both bubble and are composed.
+ * The host writes the rows and owns the list; the repeater asks, numbers and names the rows, and
+ * bounds them by `min` and `max`. It keeps no values and draws no undo toast. After an add the
+ * focus goes to the new row's first field, after a remove to the remove button of the row above,
+ * else the add button.
+ *
+ * Events: `lintje-row-add` `number` (the index the new row gets), `lintje-row-remove` `number`
+ * (the row's index, from the row).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -14,6 +15,11 @@ import '../../../primitives/button/button.js';
 import '../../../primitives/icon-button/icon-button.js';
 /** The first focusable control inside an element, through the shadow roots on the way. */
 export declare function firstFocusable(root: Element): HTMLElement | null;
+/**
+ * `<lintje-repeater-row>` — one row of a `lintje-repeater`, which numbers and names it.
+ *
+ * Events: `lintje-row-remove` `number` (the row's index).
+ */
 export declare class LintjeRepeaterRow extends LintjeElement {
     static styles: import("lit").CSSResult;
     static properties: PropertyDeclarations;

package/dist-elements/types/components/forms/stepper/stepper.d.ts

@@ -1,9 +1,10 @@
 /**
  * `<lintje-stepper>` — the steps of a form that takes more than one screen, or the phases of a
- * process. A line joins the markers: drawn through up to the current step, dashed after it. A
- * step still to come does nothing: jumping ahead is not possible. The host decides which step is
- * current; the element never reads the URL. A plain click on a done step is sent as
- * `lintje-navigate`, which a host that routes cancels; a modified click is the browser's.
+ * process.
+ *
+ * The host decides which step is current; the element never reads the URL. A step still to come
+ * does nothing: jumping ahead is not possible. A plain click on a done step is sent as
+ * `lintje-navigate`, which a host that routes cancels.
  *
  * Events: `lintje-navigate` `{ href }`.
  */

package/dist-elements/types/components/frame/app-search/app-search.d.ts

@@ -1,14 +1,13 @@
 /**
  * `<lintje-app-search>` — one search field over everything in an application, opened with `/`.
  *
- * The owner holds `open`, `groups` and `loading`. A dialog on the shared focus-trap stack. The
- * field is a native `<input>`: `aria-controls` and `aria-activedescendant` cannot cross a root.
+ * The host holds `open`, `groups` and `loading`: the element asks to be opened and closed, and
+ * searches nothing itself. It is a dialog that traps the focus; below 768 px it opens from below
+ * as a sheet.
  *
- * Below 768 px it opens from below as a sheet, with the filter sheet's head — its name and a close
- * button — and the line of keys goes.
- *
- * Events: `lintje-open`, `lintje-search` (the term), `lintje-navigate` `{ href }`, `lintje-action`
- * (the id), `lintje-close` `{ reason: 'escape' | 'scrim' | 'button' | 'choice' }`.
+ * Events: `lintje-open`, `lintje-search` `string` (the term), `lintje-navigate` `{ href }`,
+ * `lintje-action` `string` (the row's id),
+ * `lintje-close` `{ reason: 'escape' | 'scrim' | 'button' | 'choice' }`.
  */
 import { nothing, type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/frame/breadcrumbs/breadcrumbs.d.ts

@@ -1,8 +1,8 @@
 /**
  * `<lintje-breadcrumbs>` — the breadcrumb trail above a page's title.
  *
- * The last item is the current page (`aria-current`), never a link. Past `MAX_LEVELS` the middle
- * collapses into a "…" menu. It never reads the URL: the host passes the levels.
+ * The last item is the current page, never a link. Past four levels the middle collapses into a
+ * "…" menu. It never reads the URL: the host passes the levels.
  *
  * Events: `lintje-navigate` `{ href }`.
  */

package/dist-elements/types/components/frame/footer/footer.d.ts

@@ -1,10 +1,11 @@
 /**
  * `<lintje-footer>` — the foot of a site or an application: a line that says what it is, columns
  * of links under a heading, and a row of the links every page carries (privacy, accessibility).
+ *
  * It stands on the menu's own fill and runs edge to edge; in `lintje-shell` it goes in the
  * `footer` slot. Below 768 px the columns stand under each other.
  *
- * Events: `lintje-navigate` `{ href }` for a plain click on a link.
+ * Events: `lintje-navigate` `{ href }` (a plain click on a link).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -26,7 +27,7 @@ export interface FooterData {
     note?: string;
 }
 export declare class LintjeFooter extends LintjeElement {
-    static styles: import("lit").CSSResult;
+    static styles: import("lit").CSSResult[];
     static properties: PropertyDeclarations;
     data?: FooterData;
     private onLink;

package/dist-elements/types/components/frame/hero/hero.d.ts

@@ -1,16 +1,14 @@
 /**
  * `<lintje-hero>` — the opening band of a start page: a large title, a line of introduction and
- * one way onward, on the theme's wash. It runs from edge to edge; its text keeps to the
- * content column. In `lintje-shell` it goes in the `full` slot, above the page's content.
+ * one way onward, on the theme's wash.
  *
- * The title is an h2, as the page header's: the page's h1 is the shell's `name`.
- * Slots: the default slot under the description (a search field, a short form); `status` above
- * the title (a badge); `aside` for one picture beside the text (an emblem, an illustration), left
- * out below 1024 px; `panel` for content beside the text (what is said now in a running
- * recording), half the band from 1024 px and under the text below it; `overlap` for what stands
- * half over the band's lower edge, such as a panel of tabs.
+ * It runs from edge to edge, its text in the content column; in `lintje-shell` it goes in the
+ * `full` slot. The title is an h2: the page's h1 is the shell's `name`. The default slot takes a
+ * search field or a short form under the introduction, `aside` one picture beside the text (left
+ * out below 1024 px), `panel` content beside the text, and `overlap` what stands half over the
+ * band's lower edge, such as a panel of tabs.
  *
- * Events: `lintje-navigate` `{ href }` for the action.
+ * Events: `lintje-navigate` `{ href }` (the action).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/frame/notifications/notifications.d.ts

@@ -1,16 +1,12 @@
 /**
  * `<lintje-notifications>` — the bell with its unread counter, and the panel it opens.
  *
- * An unread item has the selected surface, a bold title and a dot, so colour is never the only
- * carrier (rule 13). A new counter pops in; a figure that replaces another rises in, as a KPI tile
- * does. Above 768 px the panel is a non-modal popover; below it a full-screen modal sheet on the
- * focus-trap stack. It fetches and marks nothing: the host sets `.items`.
+ * It fetches and marks nothing: the host sets `items`. More unread items than before are spoken
+ * from a status region beside the bell. Above 768 px the panel is a popover; below, a full-screen
+ * sheet that traps the focus.
  *
- * More unread items than before are spoken from a status region beside the bell ("2 nieuwe
- * meldingen"). When "Alles gelezen" goes with the focus on it, the focus moves to the first item.
- *
- * Events: `lintje-notification-open` `{ id, href? }` — a plain click on a title with an `href`
- * is cancelled and left to the host —, `lintje-notifications-read` ("Alles gelezen").
+ * Events: `lintje-notification-open` `{ id, href? }` (a title was clicked; with an `href`, cancel
+ * it to route), `lintje-notifications-read` ("Alles gelezen" was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/frame/page-header/page-header.d.ts

@@ -1,38 +1,35 @@
 /**
  * `<lintje-page-header>` — the title zone of a page, with an announcement above it.
  *
- * The title is an h2: the page's h1 is the shell's `name`.
- * Slots: `breadcrumbs` above the title, `actions` on its right.
+ * The title is an h2: the page's h1 is the shell's `name`. Actions that do not fit on one line go
+ * into one menu, "Meer": the first goes first, the last never, and a chosen row clicks its button,
+ * so the host's own listener sees the click. In the page's content it is a band that tells the
+ * shell when the title scrolls under the top bar.
  *
- * In the page's content it is a band, and tells the shell through the shared store when the
- * title scrolls under the top bar. The observer watches the title itself: a sentinel element in
- * this column would pick up the gap and push the page down 6 px.
- *
- * In `lintje-shell`'s `header` slot it stands flush in the shell's content column, as an
- * application's title row: no band, the description at every width, no observer.
- *
- * `editable` puts a pencil beside the title, shown while the title is pointed at or focused: the
- * way to rename what the page is about. The page renames; the header only asks.
- *
- * Events: `lintje-title-edit` (the pencil was pressed).
+ * Events: `lintje-title-edit` (the pencil was pressed: the page renames, the header only asks).
  */
 import { nothing, type PropertyDeclarations, type TemplateResult, type PropertyValues } from 'lit';
 import { LintjeElement, type FrameSettings } from '../../../core/element.js';
 import '../../feedback/announcement/announcement.js';
+import '../../actions/menu-button/menu-button.js';
 import '../../../primitives/icon-button/icon-button.js';
 import type { PageHeaderData } from '../../../types.js';
 export declare class LintjePageHeader extends LintjeElement {
     static styles: import("lit").CSSResult;
     static properties: PropertyDeclarations;
     data?: PageHeaderData | null;
-    /** In `lintje-shell`'s `header` slot: an application's title row, with no top bar to tell. */
+    /**
+     * In `lintje-shell`'s `header` slot: an application's title row, flush in the content column,
+     * with no band, the description at every width and no top bar to tell.
+     */
     inShell: boolean;
     /** An empty actions slot takes no place, so a long title never wraps onto an empty line. */
     hasActions: boolean;
-    /** A pencil beside the title asks to rename it. */
+    /** A pencil beside the title, shown while it is pointed at or focused, asks to rename it. */
     editable: boolean;
     protected get dataSettings(): FrameSettings | undefined;
     private readonly mobile;
+    private readonly overflow;
     private observer;
     connectedCallback(): void;
     disconnectedCallback(): void;