lintje 0.2.0 → 0.3.0

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

@@ -1,24 +1,22 @@
 /**
- * `<lintje-shell>` — the frame around a page: the Rijkshuisstijl header above it (`layout`
- * `top`, the default) or the menu beside it (`side`), the mobile header and menu below 768 px,
- * and a `<main>` with the host's content.
+ * `<lintje-shell>` — the frame around a page: the Rijkshuisstijl header above it or the menu
+ * beside it, the mobile header and menu below 768 px, and a `<main>` with the host's content.
  *
- * It never fetches and never reads the URL: the active page (`active`) and the reader's settings
- * (`view`, `menu`, `layout`) are the host's. A change goes out as `lintje-view-change` and comes
- * back as data. `name` is the page's one `h1`.
+ * It never fetches and never reads the URL: the active page and the reader's settings are the
+ * host's, and a change goes out as `lintje-view-change` and comes back as data. `full` runs edge
+ * to edge above the content, `header` holds the `lintje-page-header` and `footer` the
+ * `lintje-footer`. The events of its parts (`lintje-action`, `lintje-logout`,
+ * `lintje-notification-open`, `lintje-notifications-read`) reach the host as they are.
  *
- * Slots: `full` runs edge to edge above the content (a hero, a filter bar, a conversation); `header`
- * holds the page's title (`lintje-page-header`); the default slot the content, at the page's
- * width and padding; `footer` runs edge to edge under it all (`lintje-footer`).
- *
- * Events: `lintje-navigate` `{ href }`, `lintje-view-change`, `lintje-search-open`; from its
- * parts `lintje-action`, `lintje-logout`, `lintje-notification-open`, `lintje-notifications-read`.
+ * Events: `lintje-navigate` `{ href }`, `lintje-view-change` `ShellViewChange`,
+ * `lintje-search-open`.
  */
 import { nothing, type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement, type FrameSettings } from '../../../core/element.js';
 import '../../../primitives/button/button.js';
 import '../../actions/logo/logo.js';
 import '../../feedback/toast/toast.js';
+import type { ToastKind } from '../../feedback/toast/toast.js';
 import '../../actions/qr-code/qr-code.js';
 import '../notifications/notifications.js';
 import '../user-menu/user-menu.js';
@@ -58,6 +56,7 @@ export declare class LintjeShell extends LintjeElement {
     /** The `header` or default slot holds something; without, `full` takes the room. */
     hasContent: boolean;
     toast?: string | null;
+    toastKind: ToastKind;
     readonly wide: MediaController;
     readonly mobile: MediaController;
     readonly submenu: SubmenuController;
@@ -88,7 +87,7 @@ export declare class LintjeShell extends LintjeElement {
     /** Closes "Weergave" or "Delen" with the focus on its tool, in the bar that shows: each bar has
      * one, and below 768 px the top bar's is hidden. A `lintje-button` hands the focus inside. */
     closePanel(tool: string): void;
-    showToast(text: string): void;
+    showToast(text: string, kind?: ToastKind): void;
     /** The main region lies under the bars that stay; the page scrolls it up to just below them. */
     skipToContent(event: Event): void;
     renderSearch(): TemplateResult | typeof nothing;
@@ -97,6 +96,8 @@ export declare class LintjeShell extends LintjeElement {
     renderUserMenu(inline: boolean): TemplateResult | typeof nothing;
     private renderSkipLink;
     private renderLogo;
+    /** Paper has no bars: the logo, the application's name and the environment say what it is. */
+    private renderPrintHead;
     private renderNavEnd;
     /** The slot of the nav bar keeps its height while the bar itself is pinned to the viewport. */
     private renderTop;

package/dist-elements/types/components/frame/sub-nav/sub-nav.d.ts

@@ -1,12 +1,11 @@
 /**
  * `<lintje-sub-nav>` — the navigation within one part of an application, beside its content.
  *
- * Groups of links, optionally under a label, and one action below them ("Nieuw …"). The host
- * marks the reader's page with `active`; an item's `items` show while it or one of them is active.
- * Below 768 px it is one button with the reader's page, which opens the list in place. It never
- * reads the URL.
+ * Groups of links and one action below them ("Nieuw …"). The host marks the reader's page with
+ * `active`; the element never reads the URL. Below 768 px it is one button with the reader's
+ * page, which opens the list in place.
  *
- * Events: `lintje-navigate` `{ href }`, `lintje-action` `{ value }` (the action).
+ * Events: `lintje-navigate` `{ href }`, `lintje-action` `{ value }` (the action was pressed).
  */
 import { nothing, type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -25,7 +24,7 @@ export interface SubNavItem {
     };
     /** The page exists but the reader may not open it: struck through, with a lock. */
     noAccess?: boolean;
-    /** The level below, shown while this item or one of them is active. */
+    /** The level below, shown while this item or one of them is active, or with `expanded`. */
     items?: SubNavItem[];
 }
 export interface SubNavGroup {
@@ -55,6 +54,11 @@ export declare class LintjeSubNav extends LintjeElement {
     action?: SubNavAction;
     /** The navigation's accessible name: "Instellingen". */
     label: string;
+    /**
+     * Every level shows, not only the one on the reader's path: for the list of a long page's
+     * sections, which must not shift while it is read.
+     */
+    expanded: boolean;
     /** Whether the phone's list is open. */
     open: boolean;
     private follow;

package/dist-elements/types/components/frame/user-menu/user-menu.d.ts

@@ -1,14 +1,12 @@
 /**
  * `<lintje-user-menu>` — the user's avatar in the navigation bar and the menu it opens: name and
- * role, the host's rows (`MenuEntry`, as `lintje-menu-button`), "Afmelden", the version.
+ * role, the host's rows (`MenuEntry`), "Afmelden" and the version.
  *
- * A menu, not a dialog: no trap, and an Escape pressed in a dialog opened over it is the
- * dialog's. With `logout-action` "Afmelden" is a real `<form method="post">` with the CSRF
- * token in a hidden `csrf_token` field: signing out leaves the page, which a fetch cannot do.
- * `inline` draws the content without button and popover, for the shell's mobile sheet.
+ * A menu, not a dialog: it traps no focus, and an Escape in a dialog opened over it is the
+ * dialog's.
  *
- * Events: `lintje-action` (the row's value), `lintje-navigate` `{ href }` for a link row,
- * `lintje-logout` (only without `logout-action`).
+ * Events: `lintje-action` `string` (the row's value), `lintje-navigate` `{ href }` (a link row),
+ * `lintje-logout` (without `logout-action`).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';
@@ -24,11 +22,14 @@ export declare class LintjeUserMenu extends LintjeElement {
     items: MenuEntry[];
     /** Shown at the bottom: "Versie 2.4.1". */
     version?: string;
-    /** The URL "Afmelden" posts to; without it "Afmelden" sends `lintje-logout`. */
+    /**
+     * The URL "Afmelden" posts a real `<form>` to: signing out leaves the page, which a fetch
+     * cannot do. Without it "Afmelden" sends `lintje-logout`.
+     */
     logoutAction?: string;
-    /** The session's CSRF token, posted with "Afmelden". */
+    /** The session's CSRF token, posted with "Afmelden" in a hidden `csrf_token` field. */
     csrf: string;
-    /** The content without button and popover, on the navigation's colours. */
+    /** The content without button and popover, on the navigation's colours: for the mobile sheet. */
     inline: boolean;
     open: boolean;
     private get trigger();

package/dist-elements/types/components/index.d.ts

@@ -30,6 +30,7 @@ import './content/prose/prose.js';
 import './feedback/toast/toast.js';
 import './overlays/toggletip/toggletip.js';
 import './inputs/checkbox/checkbox.js';
+import './inputs/checkbox-group/checkbox-group.js';
 import './inputs/number-input/number-input.js';
 import './inputs/radio-group/radio-group.js';
 import './inputs/text-input/text-input.js';
@@ -47,7 +48,7 @@ import './forms/form/form.js';
 import './forms/form-section/form-section.js';
 import './forms/error-summary/error-summary.js';
 import './forms/form-actions/form-actions.js';
-import './overlays/confirm-dialog/confirm-dialog.js';
+import './overlays/dialog/dialog.js';
 import './inputs/textarea/textarea.js';
 import './inputs/file-upload/file-upload.js';
 import './inputs/combobox/combobox.js';
@@ -78,6 +79,7 @@ import './tables/tree-view/tree-view.js';
 import './tables/sortable-list/sortable-list.js';
 import './tables/description-list/description-list.js';
 import './feedback/empty-state/empty-state.js';
+import './feedback/error-page/error-page.js';
 import './tables/activity-log/activity-log.js';
 import './actions/copy-button/copy-button.js';
 import './actions/qr-code/qr-code.js';
@@ -91,8 +93,6 @@ import './content/transcript/transcript.js';
 import './content/document-viewer/document-viewer.js';
 import './feedback/conflict-alert/conflict-alert.js';
 import './frame/app-search/app-search.js';
-import './frame/shortcuts/shortcuts.js';
-import './frame/session-expiry/session-expiry.js';
 import './frame/notifications/notifications.js';
 export { LintjeAnnouncement } from './feedback/announcement/announcement.js';
 export { LintjeChart } from './charts/chart/chart.js';
@@ -126,6 +126,7 @@ export type { ToggletipPlacement } from './overlays/toggletip/toggletip.js';
 export { LintjeInputElement } from './inputs/shared/input.js';
 export type { InputValue } from './inputs/shared/input.js';
 export { LintjeCheckbox } from './inputs/checkbox/checkbox.js';
+export { LintjeCheckboxGroup } from './inputs/checkbox-group/checkbox-group.js';
 export { LintjeNumberInput } from './inputs/number-input/number-input.js';
 export { LintjeRadioGroup } from './inputs/radio-group/radio-group.js';
 export { LintjeTextInput } from './inputs/text-input/text-input.js';
@@ -150,8 +151,8 @@ export { LintjeErrorSummary } from './forms/error-summary/error-summary.js';
 export type { ErrorSummaryItem } from './forms/error-summary/error-summary.js';
 export { LintjeFormActions } from './forms/form-actions/form-actions.js';
 export type { FormActionsState } from './forms/form-actions/form-actions.js';
-export { LintjeConfirmDialog } from './overlays/confirm-dialog/confirm-dialog.js';
-export type { ConfirmTone, ConfirmCloseReason } from './overlays/confirm-dialog/confirm-dialog.js';
+export { LintjeDialog } from './overlays/dialog/dialog.js';
+export type { DialogCloseReason } from './overlays/dialog/dialog.js';
 export { LintjeTextarea } from './inputs/textarea/textarea.js';
 export { LintjeFileUpload } from './inputs/file-upload/file-upload.js';
 export type { UploadFile } from './inputs/file-upload/file-upload.js';
@@ -201,6 +202,8 @@ export type { SortableItem } from './tables/sortable-list/sortable-list.js';
 export { LintjeDescriptionList } from './tables/description-list/description-list.js';
 export type { DescriptionItem, DescriptionAction } from './tables/description-list/description-list.js';
 export { LintjeEmptyState } from './feedback/empty-state/empty-state.js';
+export { LintjeErrorPage } from './feedback/error-page/error-page.js';
+export type { ErrorPageLink } from './feedback/error-page/error-page.js';
 export { LintjeActivityLog } from './tables/activity-log/activity-log.js';
 export type { ActivityEntry } from './tables/activity-log/activity-log.js';
 export { LintjeCopyButton } from './actions/copy-button/copy-button.js';
@@ -225,10 +228,6 @@ export { LintjeDocumentViewer } from './content/document-viewer/document-viewer.
 export type { ZoomLevel } from './content/document-viewer/document-viewer.js';
 export { LintjeAppSearch } from './frame/app-search/app-search.js';
 export type { SearchGroup, SearchResult, AppSearchCloseReason } from './frame/app-search/app-search.js';
-export { LintjeShortcuts } from './frame/shortcuts/shortcuts.js';
-export type { ShortcutsCloseReason } from './frame/shortcuts/shortcuts.js';
-export { LintjeSessionExpiry } from './frame/session-expiry/session-expiry.js';
-export type { SessionPhase, RestoredReason } from './frame/session-expiry/session-expiry.js';
 export { LintjeNotifications } from './frame/notifications/notifications.js';
 export type { NotificationItem } from './frame/notifications/notifications.js';
 export { MediaController, MOBILE, WIDE } from '../core/media.js';

package/dist-elements/types/components/inputs/checkbox/checkbox.d.ts

@@ -1,15 +1,15 @@
 /**
- * `<lintje-checkbox>` — a checkbox; `indeterminate` shows a dash. The value is `checked`, a
- * boolean, not `value` (the string a native checkbox submits). `lintje-values-change` goes out
- * only with a `name`, so `lintje-multiselect`'s unnamed rows leak nothing to the host.
+ * `<lintje-checkbox>` — a checkbox; `indeterminate` shows a dash.
  *
- * Events: `lintje-change` with the boolean; with a `name` also `lintje-values-change`.
+ * Events: `lintje-change` `boolean`, `lintje-values-change` `{ [name]: value }` (with a `name`),
+ * `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';
 export declare class LintjeCheckbox extends LintjeInputElement {
     static styles: import("lit").CSSResult[];
     static properties: PropertyDeclarations;
+    /** The value: a boolean, not `value` (the string a native checkbox submits). */
     checked: boolean;
     indeterminate: boolean;
     private change;

package/dist-elements/types/components/inputs/checkbox-group/checkbox-group.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `<lintje-checkbox-group>` — several options under one label, a checkbox per line, with one hint
+ * and one message for the group.
+ *
+ * Only the group tells the host: its rows carry no `name`. `required` draws nothing and sets no
+ * ARIA, since a group cannot carry `aria-required`: the host's message says what is missing.
+ *
+ * Events: `lintje-change` `string[]` (the checked values), `lintje-values-change`
+ * `{ [name]: value }` (with a `name`), `lintje-reset` (the reset link was pressed).
+ */
+import { type PropertyDeclarations, type TemplateResult } from 'lit';
+import { LintjeInputElement } from '../shared/input.js';
+import '../checkbox/checkbox.js';
+import type { FilterOption } from '../../../types.js';
+export declare class LintjeCheckboxGroup extends LintjeInputElement {
+    static styles: import("lit").CSSResult[];
+    static properties: PropertyDeclarations;
+    /** A `description` stands under its option. */
+    options?: FilterOption[];
+    /**
+     * The checked values, in the order of `options`; a value the options do not hold is kept after
+     * them. A property, not an attribute: a server-rendered page sets it as data.
+     */
+    selected: string[];
+    private toggle;
+    protected focusControl(options?: FocusOptions): void;
+    protected render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lintje-checkbox-group': LintjeCheckboxGroup;
+    }
+}

package/dist-elements/types/components/inputs/combobox/combobox.d.ts

@@ -1,11 +1,13 @@
 /**
- * `<lintje-combobox>` — search while typing and choose one value. Typing narrows `.options`
- * itself; with `remote` it sends `lintje-search` after typing stops and shows a busy row until
- * the host sets new `.options` (it never fetches). Text that matches no option is never a value;
- * emptying the field commits `null`. Escape closes and restores the previous value.
+ * `<lintje-combobox>` — search while typing and choose one value.
  *
- * Events: `lintje-change`; with a `name` also the composed `lintje-values-change`. With
- * `remote`: composed `lintje-search` `{ query }`.
+ * Typing narrows `options` itself, unless `remote`; the element never fetches. Text that matches
+ * no option is never a value, and emptying the field commits `null`. Escape closes and restores
+ * the previous value.
+ *
+ * Events: `lintje-change` `string | null`, `lintje-values-change` `{ [name]: value }` (with a
+ * `name`), `lintje-reset` (the reset link was pressed), `lintje-search` `{ query }` (with
+ * `remote`, after typing stops).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import '../../../primitives/popover/popover.js';
@@ -21,6 +23,10 @@ export declare class LintjeCombobox extends LintjeInputElement {
     value: string | null;
     options?: FilterOption[];
     placeholder: string;
+    /**
+     * The host searches: `lintje-search` goes out after typing stops, and a busy row shows until
+     * the host sets new `options`.
+     */
     remote: boolean;
     loadingLabel: string;
     emptyLabel: string;

package/dist-elements/types/components/inputs/date-input/date-input.d.ts

@@ -1,12 +1,12 @@
 /**
  * `<lintje-date-input>` — one day, typed or picked in a calendar popover.
  *
- * The field shows `dd-mm-jjjj`; what crosses is ISO, or `null` when empty. Typed text is read on
- * leaving the field or Enter (`date-format.ts`). The element checks its own text and shows a
- * message in place of the hint; a host's `error` wins. A calendar day is no time zone. Tab out of
- * the element closes the calendar, so it does not cover the next field.
+ * The field shows `dd-mm-jjjj`; what crosses is ISO, or `null` when empty. The element reads typed
+ * text on leaving the field or Enter, checks it and shows a message in place of the hint; a host's
+ * `error` wins. A calendar day knows no time zone. Tab out of the element closes the calendar.
  *
- * Events: `lintje-change` with the ISO day or `null`; with a `name` also `lintje-values-change`.
+ * Events: `lintje-change` `string | null` (the ISO day), `lintje-values-change`
+ * `{ [name]: value }` (with a `name`), `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';

package/dist-elements/types/components/inputs/date-range/date-range.d.ts

@@ -1,12 +1,12 @@
 /**
  * `<lintje-date-range>` — the date range picker: a field and a popover with a calendar, presets
- * and "Wissen"/"Toepassen". Dates cross as `dd-mm-yyyy`; a change carries `{from, to}`.
+ * and "Wissen"/"Toepassen".
  *
- * `accessible-name` names the field inside, which `aria-label` on the host would not; the field's
- * name ends in the chosen range. The calendar is one tab stop, walked with the date input's keys.
- * Escape closes only the popover (`ownsEscape`); it and "Toepassen" give the focus back to the
- * field. Tab out of the element closes the popover. Events: `lintje-change`; with a `name` also
- * `lintje-values-change` (`shared/input.ts`).
+ * Escape closes only the popover; it and "Toepassen" give the focus back to the field. Tab out of
+ * the element closes the popover.
+ *
+ * Events: `lintje-change` `{ from, to }`, `lintje-values-change` `{ [name]: value }` (with a
+ * `name`), `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';
@@ -28,9 +28,14 @@ export declare function formatDate(date: Date): string;
 export declare class LintjeDateRange extends LintjeInputElement {
     static styles: import("lit").CSSResult[];
     static properties: PropertyDeclarations;
+    /**
+     * Names the field inside, which `aria-label` on the host would not; the name ends in the
+     * chosen range.
+     */
     accessibleName: string;
     stacked: boolean;
     open: boolean;
+    /** The chosen days, as `dd-mm-yyyy`. */
     range: DateRange;
     /** A form gets the days as the URL does: ISO. */
     protected get postedValue(): unknown;

package/dist-elements/types/components/inputs/field/field.d.ts

@@ -1,7 +1,9 @@
 /**
- * `<lintje-field>` — the label above a filter control. No `for`: a `<label for>` cannot name a
- * control in another shadow root, so each control carries its own `aria-label`; a click on the
- * label focuses the first slotted control that takes focus.
+ * `<lintje-field>` — the label above a filter control.
+ *
+ * A click on the label focuses the first slotted control that takes focus. There is no `for`: a
+ * `<label for>` cannot name a control in another shadow root, so each control carries its own
+ * `aria-label`.
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeElement } from '../../../core/element.js';

package/dist-elements/types/components/inputs/file-upload/file-upload.d.ts

@@ -1,15 +1,13 @@
 /**
  * `<lintje-file-upload>` — choose or drop files, and see per file how far it is and how it ended.
- * It never uploads: it checks files against `accept` and `max-size`, sends the ones that pass
- * with `lintje-files-add`, and draws the rows from `.files`. A file it refuses itself never
- * reaches the host. Its value is the ids of the rows that are done.
  *
- * The button is the one control: it carries the label in its name and the types, the size and
- * the hint or error as its description. When a row with the focus goes, the focus moves to the
- * row in its place, else the one before, else the button.
+ * It never uploads: it checks files against `accept` and `max-size`, sends the ones that pass with
+ * `lintje-files-add` and draws the rows from `files`. A file it refuses never reaches the host.
+ * Its value is the ids of the rows that are done.
  *
- * Events: `lintje-files-add` (the `File[]`), `lintje-file-remove` `{ id }`, `lintje-file-cancel`
- * `{ id }` — composed; `lintje-change` and, with a `name`, `lintje-values-change`.
+ * Events: `lintje-files-add` `File[]`, `lintje-file-remove` `{ id }`, `lintje-file-cancel`
+ * `{ id }`, `lintje-change` `string[]`, `lintje-values-change` `{ [name]: value }` (with a
+ * `name`), `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import '../../../primitives/button/button.js';

package/dist-elements/types/components/inputs/multiselect/multiselect.d.ts

@@ -2,13 +2,11 @@
  * `<lintje-multiselect>` — several values in one field: chips in the field, a search and a
  * checkbox list in the popover.
  *
- * Rows are `<lintje-checkbox>` without a `name`, so no filter change escapes the popover. The
- * popover is a dialog, not a listbox: it holds a search field and buttons besides the rows. It is
- * fixed to the viewport and anchored to the field: an absolute one is cut off by the scrolling
- * filter bar and sheet around it. Escape closes only the popover (`ownsEscape`) and gives the
- * focus back to the field; so does Tab out of the element, without taking the focus back.
+ * The popover is fixed to the viewport, so a scrolling filter bar or sheet around it does not cut
+ * it off. Escape and Tab out of the element close only the popover.
  *
- * Events: `lintje-change`; with a `name` also `lintje-values-change` (`shared/input.ts`).
+ * Events: `lintje-change` `string[]`, `lintje-values-change` `{ [name]: value }` (with a `name`),
+ * `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';

package/dist-elements/types/components/inputs/number-input/number-input.d.ts

@@ -1,11 +1,12 @@
 /**
- * `<lintje-number-input>` — a −/+ stepper around a centred value, or a unit on the right
- * without the stepper. Commits on `change`; a press on − or + commits at once.
+ * `<lintje-number-input>` — a −/+ stepper around a centred value, or a unit on the right without
+ * the stepper.
  *
- * `stepper` defaults to `true`, so it can only be turned off as a property: `?stepper=${false}`
- * removes an attribute that was never there. A shown unit describes the field. At `min` or `max`
- * the step is `aria-disabled`, not disabled, so the focus on it stays. Events: `lintje-change`,
- * and `lintje-values-change` with a `name`.
+ * It commits on `change`; a press on − or + commits at once. At `min` or `max` the step stays
+ * focusable but does nothing.
+ *
+ * Events: `lintje-change` `number | null`, `lintje-values-change` `{ [name]: value }` (with a
+ * `name`), `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeFormInputElement } from '../shared/input.js';
@@ -17,7 +18,7 @@ export declare class LintjeNumberInput extends LintjeFormInputElement {
     min?: number;
     max?: number;
     step: number;
-    /** The unit on the right, e.g. "min"; shown only without the stepper. */
+    /** The unit on the right, e.g. "min", which describes the field; only without the stepper. */
     unit?: string;
     /** The −/+ buttons. Bind as `.stepper=${false}`, never `?stepper=`. */
     stepper: boolean;

package/dist-elements/types/components/inputs/radio-group/radio-group.d.ts

@@ -1,10 +1,8 @@
 /**
  * `<lintje-radio-group>` — one option per line, for options that do not fit `lintje-segmented`.
- * Options are `FilterOption[]`. Arrow keys are the browser's: the inputs share one `name` inside
- * this shadow root, so two groups never collide. `variant="cards"` draws each option as a card in
- * a grid, its `description` under the label, the chosen one quiet as in `lintje-segmented`.
  *
- * Events: `lintje-change`; with a `name` also `lintje-values-change` (`shared/input.ts`).
+ * Events: `lintje-change` `string`, `lintje-values-change` `{ [name]: value }` (with a `name`),
+ * `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';

package/dist-elements/types/components/inputs/range/range.d.ts

@@ -1,13 +1,12 @@
 /**
  * `<lintje-range>` — one track, one or two handles, over labeled steps.
  *
- * Two handles: `from` and `to` are indexes into `steps`, and a change is `[from, to]`. With
- * `single`, `value` is the step itself, not its index, and a change is that step. A drag commits
- * when the pointer is let go (`draft`/`draftPair` show it meanwhile); a key press commits at once.
- * With two handles only the thumbs take the pointer, so a press on the track moves the nearer
- * handle there; on stacked handles the side of the press decides.
+ * With two handles `from` and `to` are indexes into `steps`, and a change is `[from, to]`; with
+ * `single`, `value` is the step itself, and a change is that step. A drag commits when the pointer
+ * is let go, a key press at once.
  *
- * Events: `lintje-change`; with a `name` also `lintje-values-change` (`shared/input.ts`).
+ * Events: `lintje-change` `[number, number] | number | string`, `lintje-values-change`
+ * `{ [name]: value }` (with a `name`), `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';

package/dist-elements/types/components/inputs/segmented/segmented.d.ts

@@ -1,11 +1,14 @@
 /**
- * `<lintje-segmented>` — one row of options, the chosen one marked. A row wider than its room
- * stands as a column instead, each option a row of its own.
- * In a filter bar it is `hide-label` and nameless; the bar decides what to commit.
+ * `<lintje-segmented>` — one row of options, the chosen one marked; a row wider than its room
+ * stands as a column.
  *
- * Events: `lintje-change`; with a `name` also the composed `lintje-values-change`.
+ * In a filter bar it is `hide-label` and nameless: the bar decides what to commit.
+ *
+ * Events: `lintje-change` `string`, `lintje-values-change` `{ [name]: value }` (with a `name`),
+ * `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
+import '../../../primitives/badge/badge.js';
 import { LintjeInputElement } from '../shared/input.js';
 import type { FilterOption } from '../../../types.js';
 export declare class LintjeSegmented extends LintjeInputElement {

package/dist-elements/types/components/inputs/select/select.d.ts

@@ -1,9 +1,11 @@
 /**
  * `<lintje-select>` — a select, bold once the value differs from the default.
- * The filter bar passes no `name` and sets `hide-label`. The width is the host's, not inline,
- * so `filter-layout.css` can narrow it from outside.
  *
- * Events: `lintje-change`; with a `name` also the composed `lintje-values-change`.
+ * In a filter bar it is `hide-label` and nameless. Its width is the host's, so the filter layout
+ * can narrow it from outside.
+ *
+ * Events: `lintje-change` `string`, `lintje-values-change` `{ [name]: value }` (with a `name`),
+ * `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';
@@ -12,6 +14,7 @@ export declare class LintjeSelect extends LintjeInputElement {
     static styles: import("lit").CSSResult[];
     static properties: PropertyDeclarations;
     value: string;
+    /** Bold the value, as a modified filter does. */
     bold: boolean;
     stacked: boolean;
     options?: FilterOption[];

package/dist-elements/types/components/inputs/slot-picker/slot-picker.d.ts

@@ -1,11 +1,12 @@
 /**
  * `<lintje-slot-picker>` — a time for an appointment: days side by side, each with its times as
- * options. One radio group over every day, so the arrow keys walk the times and Tab stops once;
- * a time's name carries its day. A full time stays, disabled, with the word "Vol" beside it
- * (rule 13), and a day without times says so. The days are the host's: it sends the ones it
- * offers, and pages them itself.
+ * options.
  *
- * Events: `lintje-change` with the chosen time's `value`; with a `name` also `lintje-values-change`.
+ * The days are the host's: it sends the ones it offers, and pages them itself. One radio group
+ * spans every day, so Tab stops once. A full time stays, disabled, with the word "Vol" beside it.
+ *
+ * Events: `lintje-change` `string` (the chosen time's `value`), `lintje-values-change`
+ * `{ [name]: value }` (with a `name`), `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';

package/dist-elements/types/components/inputs/tag-input/tag-input.d.ts

@@ -1,10 +1,12 @@
 /**
- * `<lintje-tag-input>` — free keywords as chips in one field. Enter, a comma, a paste with commas
- * or leaving the field makes chips; a duplicate lights up its chip and is said instead of being
- * added. With `.options` it also suggests options, and still takes a word that is not among them.
- * A chip's cross is its one control: the arrows walk the crosses, Backspace and Delete remove.
+ * `<lintje-tag-input>` — free keywords as chips in one field.
  *
- * Events: `lintje-change`; with a `name` also the composed `lintje-values-change`.
+ * Enter, a comma, a paste with commas or leaving the field makes chips; a duplicate is pointed out
+ * instead of added. With `options` it also suggests, and still takes a word that is not among
+ * them.
+ *
+ * Events: `lintje-change` `string[]`, `lintje-values-change` `{ [name]: value }` (with a `name`),
+ * `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import '../../../primitives/popover/popover.js';

package/dist-elements/types/components/inputs/text-editor/text-editor.d.ts

@@ -1,11 +1,11 @@
 /**
- * `<lintje-text-editor>` — formatted text (bold, italic, one heading, a bullet list, a link);
- * the value is markdown (`markdown.ts`). Formatting uses `document.execCommand`, the one API
- * every browser has for a `contenteditable` selection; the markdown writer reads only the five
- * formats from whatever markup it leaves. Commits when the surface loses focus, if changed.
- * A link is http(s), mailto, tel or relative; any other scheme is dropped.
+ * `<lintje-text-editor>` — formatted text: bold, italic, one heading, a bullet list and a link.
  *
- * Events: `lintje-change` with the markdown; with a `name` also the composed `lintje-values-change`.
+ * The value is markdown, committed when the surface loses focus, if changed. A link is http(s),
+ * mailto, tel or relative; any other scheme is dropped.
+ *
+ * Events: `lintje-change` `string` (the markdown), `lintje-values-change` `{ [name]: value }`
+ * (with a `name`), `lintje-reset` (the reset link was pressed).
  */
 import { type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import { LintjeInputElement } from '../shared/input.js';

package/dist-elements/types/components/inputs/text-input/text-input.d.ts

@@ -1,10 +1,12 @@
 /**
- * `<lintje-text-input>` — a text field: `clearable`, `error`, `readonly`, and `type` text,
- * search, password or email. It checks nothing itself; the host sets `error`.
+ * `<lintje-text-input>` — a text field: text, search, password or email.
  *
- * It commits on `change` (leaving the field, Enter), since every commit is a URL change and a
- * tile reload. `commit="input"` bundles keystrokes and commits 300 ms after the last. The same
- * value is never committed twice. Events: `lintje-change`, and `lintje-values-change` with `name`.
+ * It checks nothing itself: the host sets `error`. It commits on `change` (leaving the field,
+ * Enter), since every commit is a URL change and a tile reload, and never commits the same value
+ * twice.
+ *
+ * Events: `lintje-change` `string`, `lintje-values-change` `{ [name]: value }` (with a `name`),
+ * `lintje-reset` (the reset link was pressed).
  */
 import { nothing, type PropertyDeclarations, type PropertyValues, type TemplateResult } from 'lit';
 import '../../../primitives/button/button.js';
@@ -22,7 +24,10 @@ export declare class LintjeTextInput extends LintjeFormInputElement {
     clearable: boolean;
     stacked: boolean;
     type: TextInputType;
-    /** The attribute `commit`; `commit()` is the method every input commits through. */
+    /**
+     * The attribute `commit`; `commit()` is the method every input commits through. `input`
+     * bundles keystrokes and commits 300 ms after the last.
+     */
     commitOn: CommitOn;
     /** Passed to the native input as is. */
     autocomplete: string;