@silverpoint/core 0.6.0 → 0.8.0

package/dist/types-D5ys35fF.d.ts

@@ -0,0 +1,576 @@
+import { G as Geometry, n as Seed, t as GroundRef, u as SubstrateName, q as InkMode, au as Palette, az as ToneLevel } from './props-BZ9CcrGv.js';
+
+type UiFrameKind = 'control' | 'pill' | 'box' | 'card' | 'round';
+/**
+ * Each frame kind is drawn once in a square box and cut into slices for the grounds build
+ * (DD-022): four corners of `slice` px, and four edges between them when `size > 2 * slice`.
+ * `round` and `box` have no edges; they frame fixed-size squares.
+ */
+declare const UI_FRAME_KINDS: Readonly<Record<UiFrameKind, Readonly<{
+    size: number;
+    slice: number;
+    radius: number;
+}>>>;
+/**
+ * The frame variant of a component: from `seed`, else `id`, by the charts' seed rule; `0` with
+ * neither (REQ-307, I-21). Never from mount order, randomness or time (Art. 4). `variants` is read
+ * as an integer in 1..6.
+ */
+declare function uiFrameVariant(seed: Seed | undefined, id: string | undefined, variants: number): number;
+/**
+ * The exact outline of a frame kind: the input the grounds build inks, once per variant, into the
+ * pieces of `ui.css` (DD-022). It is an `ornament` stroke —a frame carries no value (Art. 1, as
+ * amended)— so the ground's inker may draw it by hand, with its vertices preserved. Build time only.
+ */
+declare function uiFrameOutline(kind: UiFrameKind): Geometry;
+
+/** Control size; heights come from the ground's `ui.controlHeight` (Data Model §3.8). */
+type UiSize = 'sm' | 'md' | 'lg';
+/** Props every UI component takes, as `CommonChartProps` does for charts (API Spec §3). */
+interface CommonUiProps {
+    /** The frame variant and every related id derive from it (REQ-307, REQ-329). */
+    id?: string;
+    /** Overrides `id` for the frame variant only. */
+    seed?: Seed;
+    /** Style ground. Defaults to the dashboard's, then the app provider's, or `silverpoint` (REQ-311). */
+    ground?: GroundRef;
+    /** Prepared substrate within the ground (REQ-046). */
+    substrate?: SubstrateName;
+    /** `ink` by default; `precision` disables inking (REQ-021, REQ-306). */
+    mode?: InkMode;
+    /** Colours over the ground's, merged over the dashboard's and the provider's (REQ-461, REQ-462). */
+    palette?: Palette;
+    /** Default `'md'`. */
+    size?: UiSize;
+    /** Added to the component's root element, after its own classes. */
+    className?: string;
+}
+/** An item of Tabs, Segmented or RadioGroup; keys are unique (REQ-325). */
+interface UiItem {
+    key: string;
+    label: string;
+    disabled?: boolean;
+}
+type StepStatus = 'wait' | 'process' | 'finish' | 'error';
+interface StepItem {
+    key: string;
+    title: string;
+    description?: string;
+    /** Derived from `current` when omitted; `'error'` must be explicit. */
+    status?: StepStatus;
+}
+/** Button emphasis. Not a tone: `tone` names only a level 1-4 of the ground's ramp (A-07). */
+type UiVariant = 'default' | 'primary' | 'danger';
+type AlertKind = 'info' | 'success' | 'warning' | 'error';
+type UiOrientation = 'horizontal' | 'vertical';
+/** A tonal level a component may ask for; 0 (no fill) is not one. */
+type UiToneLevel = Exclude<ToneLevel, 0>;
+interface SpButtonProps extends CommonUiProps {
+    /** Default `'default'`; `danger` also draws the exact ✕ glyph (REQ-310). */
+    variant?: UiVariant;
+    /** Default `'button'`. */
+    type?: 'button' | 'submit' | 'reset';
+    /** Not focusable, not submitted; drawn with the disabled tone. */
+    disabled?: boolean;
+    /** Accessible name of an icon-only button (REQ-319). */
+    label?: string;
+    /** Fills the width of its container. */
+    block?: boolean;
+    /** Renders an `<a>`. */
+    href?: string;
+}
+interface SpInputProps extends CommonUiProps {
+    /** Native input type. Default `'text'`. */
+    type?: 'text' | 'search' | 'email' | 'url' | 'tel' | 'password' | 'number';
+    /** Hint shown while empty; not a substitute for the accessible name. */
+    placeholder?: string;
+    /** Form field name; the native input submits under it (REQ-323). */
+    name?: string;
+    /** Not focusable and not submitted. */
+    disabled?: boolean;
+    /** Focusable and submitted, but not editable. */
+    readOnly?: boolean;
+    /** Sets `aria-invalid` and draws the exact ⚠ glyph (REQ-334). */
+    invalid?: boolean;
+    /** Help or error text under the control, referenced by `aria-describedby` (REQ-334). */
+    message?: string;
+    /** Accessible name, when no `<label for>` names the control. */
+    label?: string;
+}
+interface SpCheckboxProps extends CommonUiProps {
+    /** The visible text and accessible name. */
+    label: string;
+    /** Form field name; submitted as `on` when checked. */
+    name?: string;
+    /** Not focusable and not submitted. */
+    disabled?: boolean;
+    /** Draws the exact dash and sets the native `indeterminate` state. */
+    indeterminate?: boolean;
+}
+interface SpRadioGroupProps extends CommonUiProps {
+    /** The choices; each a native radio. Keys are unique (REQ-325). */
+    items: readonly UiItem[];
+    /** Required: the native radios submit under it (REQ-323). */
+    name: string;
+    /** The group's name, its `<legend>`. */
+    label: string;
+    /** Default `'vertical'`. */
+    orientation?: UiOrientation;
+}
+interface SpSwitchProps extends CommonUiProps {
+    /** The visible text and accessible name. */
+    label: string;
+    /** Form field name; submitted as `on` when on. */
+    name?: string;
+    /** Not focusable and not submitted. */
+    disabled?: boolean;
+}
+interface SpSliderProps extends CommonUiProps {
+    /** Accessible name of the native range input. */
+    label: string;
+    /** Default `0`. */
+    min?: number;
+    /** Default `100`. */
+    max?: number;
+    /** Default `1`. */
+    step?: number;
+    /** Form field name; the native input submits under it. */
+    name?: string;
+    /** Not focusable and not submitted. */
+    disabled?: boolean;
+    /** Values on the rail that get a labelled mark. */
+    marks?: readonly number[];
+}
+interface SpRateProps extends CommonUiProps {
+    /** The group's name, its `<legend>`. */
+    label: string;
+    /** Default `5`, in 1..10; each mark an exact lozenge. */
+    count?: number;
+    /** Form field name; the native radios submit under it. */
+    name?: string;
+    /** Not focusable and not submitted. */
+    disabled?: boolean;
+    /** Shows the value; the keyboard and the pointer do not change it. */
+    readOnly?: boolean;
+}
+interface SpSegmentedProps extends CommonUiProps {
+    /** The options; each a native radio. Keys are unique (REQ-325). */
+    items: readonly UiItem[];
+    /** The control's name, its `<legend>`. */
+    label: string;
+    /** Form field name; the native radios submit under it. */
+    name?: string;
+    /** Fills the width of its container. */
+    block?: boolean;
+}
+interface SpTabsProps extends CommonUiProps {
+    /** The tabs; a disabled one is skipped by the arrows. Keys are unique (REQ-325). */
+    items: readonly UiItem[];
+    /** Accessible name of the tab list. */
+    label?: string;
+    /** Default `'horizontal'`. */
+    orientation?: UiOrientation;
+    /** Default `'automatic'`: a tab is selected as focus reaches it. */
+    activation?: 'automatic' | 'manual';
+}
+interface SpStepsProps extends CommonUiProps {
+    /** The steps, in order; a status is derived from `current` unless set. */
+    items: readonly StepItem[];
+    /** 0-based. */
+    current: number;
+    /** Default `'horizontal'`. */
+    orientation?: UiOrientation;
+    /** Accessible name of the list. */
+    label?: string;
+}
+interface SpCardProps extends CommonUiProps {
+    /** Heading of the card; without it the card is a plain container. */
+    title?: string;
+    /** Default `3`. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}
+interface SpTagProps extends CommonUiProps {
+    /** Tonal level, default `1`. */
+    tone?: UiToneLevel;
+    /** Adds a native close button; each adapter raises its close event. */
+    closable?: boolean;
+    /** Accessible name of the close button. Default `Remove <text>`. */
+    closeLabel?: string;
+}
+interface SpBadgeProps extends CommonUiProps {
+    /** The number shown, up to `max`. */
+    count?: number;
+    /** Default `99`; above it the badge reads `99+`. */
+    max?: number;
+    /** A dot with no number. */
+    dot?: boolean;
+    /** Accessible text of the badge, e.g. `unread messages`. */
+    label?: string;
+}
+interface SpDividerProps extends CommonUiProps {
+    /** Default `'horizontal'`. */
+    orientation?: UiOrientation;
+    /** A caption set in the rule. */
+    text?: string;
+    /** Default `'center'`. */
+    align?: 'start' | 'center' | 'end';
+}
+interface SpProgressProps extends CommonUiProps {
+    /** 0..100; omitted, the progress is indeterminate. */
+    value?: number;
+    /** Default `'line'`. */
+    shape?: 'line' | 'circle';
+    /** Accessible name (REQ-318). */
+    label: string;
+    /** Default `true`. */
+    showValue?: boolean;
+}
+interface SpAlertProps extends CommonUiProps {
+    /** Default `'info'`. */
+    kind?: AlertKind;
+    /** Bold first line of the alert. */
+    title?: string;
+    /** Adds a native close button; each adapter raises its close event. */
+    closable?: boolean;
+    /** Accessible name of the close button. Default `'Close'`. */
+    closeLabel?: string;
+}
+interface SpSkeletonProps extends CommonUiProps {
+    /** Default `3`, in 1..8. */
+    lines?: number;
+    /** Draws an avatar placeholder before the lines. */
+    avatar?: boolean;
+    /** Default `'Loading'`. */
+    label?: string;
+}
+interface SpSurfaceProps extends CommonUiProps {
+    /** The element, a lowercase HTML tag name. Default `'div'`. */
+    as?: string;
+    /** Adds the class `sp-<name>`, a lowercase ident. */
+    name?: string;
+    /** Draws a frame of that kind. */
+    frame?: UiFrameKind;
+    /** Lays a tone: a level 1-4 of the ramp, or a state (`selected`, `primary`…). */
+    tone?: UiToneLevel | string;
+}
+interface SpGlyphProps extends CommonUiProps {
+    /** A key of `UI_GLYPHS`. */
+    glyph: string;
+}
+interface TableColumn {
+    readonly key: string;
+    /** The key when omitted. */
+    readonly title?: string;
+    readonly align?: 'start' | 'center' | 'end';
+    readonly sortable?: boolean;
+    /** CSS length; written as an inline width on the header cell. */
+    readonly width?: string;
+}
+interface SpTableProps extends CommonUiProps {
+    /** The columns, in order; each names the key it reads from a row. */
+    columns: readonly TableColumn[];
+    /** The rows, drawn as given: the consumer sorts them (DD-040). */
+    data: readonly Readonly<Record<string, unknown>>[];
+    /** The table's `<caption>`, its accessible name. */
+    caption?: string;
+    /** A sortable column's key; another key sorts nothing, silently. */
+    sortKey?: string;
+    /** Default `'asc'`. */
+    sortOrder?: 'asc' | 'desc';
+    /** Default `false`. */
+    striped?: boolean;
+    /** Default `true`. */
+    hoverable?: boolean;
+    /** Default `true`. */
+    bordered?: boolean;
+    /** Default `'No data'`. */
+    emptyText?: string;
+    /** The column whose value keys each row. */
+    rowKey?: string;
+}
+interface SpPaginationProps extends CommonUiProps {
+    /** The number of items paged over. */
+    total: number;
+    /** Default `10`. */
+    pageSize?: number;
+    /** Pages shown on each side of the current one. Default `1`. */
+    siblings?: number;
+    /** Default `false`. */
+    showTotal?: boolean;
+    /** Default `'{start}–{end} of {total}'`. */
+    totalTemplate?: string;
+    /** Default `'Pagination'`. */
+    label?: string;
+    /** Default `'Previous page'`. */
+    previousLabel?: string;
+    /** Default `'Next page'`. */
+    nextLabel?: string;
+    /** Default `'Page'`. */
+    pageLabel?: string;
+    /** Every page button disabled. */
+    disabled?: boolean;
+}
+interface BreadcrumbItem {
+    readonly key?: string;
+    readonly label: string;
+    readonly href?: string;
+}
+interface SpBreadcrumbProps extends CommonUiProps {
+    /** The last item is the current page. */
+    items: readonly BreadcrumbItem[];
+    /** Default `'Breadcrumb'`. */
+    label?: string;
+}
+interface SpAvatarProps extends CommonUiProps {
+    /** An image; the initials are drawn without one. */
+    src?: string;
+    /** The person's name: the accessible name and the source of the initials. */
+    name?: string;
+    /** Overrides the initials derived from `name`. */
+    initials?: string;
+    /** Overrides `name` as the accessible name. */
+    alt?: string;
+    /** Default `'circle'`. */
+    shape?: 'circle' | 'square';
+    /** Side length in px; the ground's control height when omitted. */
+    pixelSize?: number;
+}
+interface SpAvatarGroupProps extends CommonUiProps {
+    label?: string;
+}
+interface SpStatisticProps extends CommonUiProps {
+    /** The label above the value. */
+    title: string;
+    /** Printed as given. */
+    value: string | number;
+    /** Printed before the value (`$`). */
+    prefix?: string;
+    /** Printed after the value (`%`). */
+    suffix?: string;
+    /** Draws the exact ↑ or ↓ glyph beside the delta. */
+    trend?: 'up' | 'down';
+    /** The change, as text (`+4.2%`). */
+    delta?: string;
+}
+interface DescriptionItem {
+    readonly key?: string;
+    readonly label: string;
+    readonly value: string;
+}
+interface SpDescriptionsProps extends CommonUiProps {
+    /** The label–value pairs, a `<dl>`. Keys, when given, are unique (REQ-325). */
+    items: readonly DescriptionItem[];
+    /** A heading above the list, at `headingLevel`. */
+    title?: string;
+    /** Default `3`, in 1..6. */
+    columns?: number;
+    /** Default `true`. */
+    bordered?: boolean;
+    /** Default `3`. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}
+interface TimelineListItem {
+    readonly key?: string;
+    readonly title: string;
+    readonly time?: string;
+    readonly description?: string;
+    /** Default `'done'`; at most one `current`. */
+    readonly status?: 'done' | 'current' | 'pending' | 'error';
+}
+interface SpTimelineListProps extends CommonUiProps {
+    /** The events, in reading order. */
+    items: readonly TimelineListItem[];
+    /** Accessible name of the list. */
+    label?: string;
+}
+interface SpCollapseProps extends CommonUiProps {
+    /** One item open at a time, natively (`<details name>`). Default `false`. */
+    accordion?: boolean;
+    /** Default `true`. */
+    bordered?: boolean;
+}
+interface SpCollapseItemProps extends CommonUiProps {
+    title: string;
+    disabled?: boolean;
+}
+interface SpEmptyProps extends CommonUiProps {
+    /** Default `'No data'`. */
+    description?: string;
+}
+interface SpResultProps extends CommonUiProps {
+    /** Default `'info'`. */
+    status?: AlertKind;
+    /** The heading, at `headingLevel`. */
+    title: string;
+    /** A paragraph under the title. */
+    subtitle?: string;
+    /** Default `3`. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}
+interface SpTextareaProps extends CommonUiProps {
+    /** Default `3`. */
+    rows?: number;
+    /** Hint shown while empty; not a substitute for the accessible name. */
+    placeholder?: string;
+    /** Accessible name, when no `<label for>` names the control. */
+    label?: string;
+    /** Help or error text under the control, referenced by `aria-describedby` (REQ-334). */
+    message?: string;
+    /** Sets `aria-invalid` and draws the exact ⚠ glyph (REQ-334). */
+    invalid?: boolean;
+    /** Not focusable and not submitted. */
+    disabled?: boolean;
+    /** Focusable and submitted, but not editable. */
+    readOnly?: boolean;
+    /** The native limit; the counter shows it with `showCount`. */
+    maxLength?: number;
+    /** Default `false`. */
+    showCount?: boolean;
+    /** Form field name; the native textarea submits under it (REQ-323). */
+    name?: string;
+}
+interface SpInputNumberProps extends CommonUiProps {
+    /** The lowest value; the value is clamped to it (REQ-485). */
+    min?: number;
+    /** The highest value; the value is clamped to it (REQ-485). */
+    max?: number;
+    /** Default `1`. */
+    step?: number;
+    /** Decimals. */
+    precision?: number;
+    /** Hint shown while empty; not a substitute for the accessible name. */
+    placeholder?: string;
+    /** Accessible name, when no `<label for>` names the control. */
+    label?: string;
+    /** Help or error text under the control, referenced by `aria-describedby` (REQ-334). */
+    message?: string;
+    /** Sets `aria-invalid` and draws the exact ⚠ glyph (REQ-334). */
+    invalid?: boolean;
+    /** Not focusable and not submitted; the steppers are disabled too. */
+    disabled?: boolean;
+    /** Focusable and submitted, but not editable. */
+    readOnly?: boolean;
+    /** Form field name; the native input submits under it (REQ-323). */
+    name?: string;
+    /** Default `'Decrease'`. */
+    decrementLabel?: string;
+    /** Default `'Increase'`. */
+    incrementLabel?: string;
+}
+interface SpModalProps extends CommonUiProps {
+    /** The heading, `${id}--title`, that names the dialog. */
+    title?: string;
+    /** A paragraph, `${id}--description`, that describes the dialog. */
+    description?: string;
+    /** Accessible name without a title (REQ-501). */
+    label?: string;
+    /** Default `true`. */
+    closable?: boolean;
+    /** Default `'Close'`. */
+    closeLabel?: string;
+    /** CSS length. Default `'520px'` (from `ui.css`). */
+    width?: string;
+    /** Escape and a backdrop click close it. Default `true`. */
+    dismissible?: boolean;
+}
+interface SpDrawerProps extends Omit<SpModalProps, 'width'> {
+    /** Default `'end'`. */
+    side?: 'start' | 'end' | 'top' | 'bottom';
+    /** CSS length across the side. Default `'380px'` (start/end) or `'320px'` (top/bottom). */
+    extent?: string;
+    /** `false` opens with `show()`. Default `true`. */
+    modal?: boolean;
+}
+interface SpPopoverProps extends CommonUiProps {
+    /** A heading that names the popover. */
+    title?: string;
+    /** Accessible name without a title. */
+    label?: string;
+    /** Default `'bottom'`. */
+    side?: 'top' | 'end' | 'bottom' | 'start';
+    /** Default `'center'`. */
+    align?: 'start' | 'center' | 'end';
+    /** Default `6`. */
+    offset?: number;
+    /** Default `false`. */
+    closable?: boolean;
+    /** Default `'Close'`. */
+    closeLabel?: string;
+    /** CSS length. Default `'320px'` (from `ui.css`). */
+    width?: string;
+}
+interface SpTooltipProps extends CommonUiProps {
+    /** The tooltip, the trigger's accessible description. */
+    text: string;
+    /** Default `'top'`. */
+    side?: 'top' | 'end' | 'bottom' | 'start';
+    /** Default `'center'`. */
+    align?: 'start' | 'center' | 'end';
+    /** Default `6`. */
+    offset?: number;
+    /** Default `300` ms. */
+    delay?: number;
+}
+interface SpSelectProps extends CommonUiProps {
+    /** A string is its own key and label. */
+    items: readonly (string | UiItem)[];
+    /** Default `'Select…'`. */
+    placeholder?: string;
+    /** Accessible name of the combobox. */
+    label: string;
+    /** Not focusable and not submitted. */
+    disabled?: boolean;
+    /** Sets `aria-required` on the combobox. */
+    required?: boolean;
+    /** Submits the key under this name, from a hidden input (REQ-323). */
+    name?: string;
+    /** CSS length. Default `'180px'` (from `ui.css`). */
+    width?: string;
+}
+type MenuEntry = {
+    readonly key: string;
+    readonly label: string;
+    readonly shortcut?: string;
+    readonly disabled?: boolean;
+    readonly danger?: boolean;
+    readonly type?: 'item';
+} | {
+    readonly type: 'separator';
+    readonly key: string;
+} | {
+    readonly type: 'label';
+    readonly key: string;
+    readonly label: string;
+};
+interface SpDropdownMenuProps extends CommonUiProps {
+    /** Items, separators and labels, in order. Keys are unique (REQ-325). */
+    items: readonly MenuEntry[];
+    /** The menu's accessible name and the trigger's text when no trigger slot. */
+    label: string;
+    /** Default `'bottom'`. */
+    side?: 'top' | 'end' | 'bottom' | 'start';
+    /** Default `'start'`. */
+    align?: 'start' | 'center' | 'end';
+}
+interface SpToastProps extends CommonUiProps {
+    /** The toast's first line. */
+    title: string;
+    /** A line under the title. */
+    description?: string;
+    /** Default `'info'`. */
+    kind?: AlertKind;
+    /** ms, at least 1000, or `Infinity`; the toaster's when omitted. */
+    duration?: number;
+    /** Default `'Dismiss'`. */
+    closeLabel?: string;
+}
+interface SpToasterProps extends CommonUiProps {
+    /** Default `'bottom-end'`. */
+    position?: 'bottom-end' | 'bottom-start' | 'top-end' | 'top-start';
+    /** Default `5000` ms. */
+    duration?: number;
+    /** Default `'Notifications'`. */
+    label?: string;
+}
+
+export { type UiFrameKind as $, type SpTableProps as A, type SpTextareaProps as B, type CommonUiProps as C, type SpTimelineListProps as D, type SpDrawerProps as E, type SpDropdownMenuProps as F, type SpModalProps as G, type SpPopoverProps as H, type SpSelectProps as I, type SpToastProps as J, type SpToasterProps as K, type SpTooltipProps as L, type MenuEntry as M, type AlertKind as N, type BreadcrumbItem as O, type DescriptionItem as P, type SpButtonProps as Q, type SpCardProps as R, type StepStatus as S, type SpCheckboxProps as T, type UiOrientation as U, type SpDividerProps as V, type SpInputProps as W, type SpSwitchProps as X, type TableColumn as Y, type TimelineListItem as Z, UI_FRAME_KINDS as _, type StepItem as a, type UiSize as a0, type UiToneLevel as a1, type UiVariant as a2, uiFrameOutline as a3, uiFrameVariant as a4, type UiItem as b, type SpRadioGroupProps as c, type SpRateProps as d, type SpSegmentedProps as e, type SpSliderProps as f, type SpTabsProps as g, type SpAlertProps as h, type SpBadgeProps as i, type SpProgressProps as j, type SpSkeletonProps as k, type SpStepsProps as l, type SpTagProps as m, type SpAvatarGroupProps as n, type SpAvatarProps as o, type SpBreadcrumbProps as p, type SpCollapseProps as q, type SpCollapseItemProps as r, type SpDescriptionsProps as s, type SpEmptyProps as t, type SpGlyphProps as u, type SpInputNumberProps as v, type SpPaginationProps as w, type SpResultProps as x, type SpStatisticProps as y, type SpSurfaceProps as z };

package/dist/types-DHBJ0PzV.d.ts

@@ -0,0 +1,57 @@
+import { C as CommonUiProps } from './types-D5ys35fF.js';
+
+/** A TimelineJS date: only `year` is required. */
+interface TimelineDate {
+    readonly year: number;
+    readonly month?: number;
+    readonly day?: number;
+    readonly hour?: number;
+    readonly minute?: number;
+    readonly second?: number;
+    readonly display_date?: string;
+}
+/** A slide's text: `text` is HTML, as TimelineJS reads it. */
+interface TimelineText {
+    readonly headline?: string;
+    readonly text?: string;
+}
+interface TimelineSlide {
+    readonly start_date: TimelineDate;
+    readonly end_date?: TimelineDate;
+    readonly text?: TimelineText;
+    readonly unique_id?: string;
+    readonly group?: string;
+    readonly display_date?: string;
+    readonly media?: Readonly<Record<string, unknown>>;
+    readonly background?: Readonly<Record<string, unknown>>;
+}
+interface TimelineEra {
+    readonly start_date: TimelineDate;
+    readonly end_date: TimelineDate;
+    readonly text?: TimelineText;
+}
+/** TimelineJS's JSON (API delta §2, the timeline). */
+interface TimelineData {
+    readonly title?: Omit<TimelineSlide, 'start_date'> & {
+        readonly start_date?: TimelineDate;
+    };
+    readonly events: readonly TimelineSlide[];
+    readonly eras?: readonly TimelineEra[];
+    readonly scale?: 'human' | 'cosmological';
+}
+interface SpTimelineProps extends CommonUiProps {
+    /** TimelineJS's JSON: a `title` slide, the `events`, optional `eras` and `scale`. */
+    data: TimelineData;
+    /** TimelineJS options; `font` and `theme` are ignored, the skin sets both. */
+    options?: Readonly<Record<string, unknown>>;
+    /** A plain CSS length. Default `'600px'`. */
+    height?: string;
+    /** Lays the ground's frames and tones on TimelineJS's pieces (REQ-512). Default `true`. */
+    inkedFrames?: boolean;
+    /** Frames the whole timeline as a card. Default `true`. */
+    card?: boolean;
+    /** The region's accessible name; the title's headline when omitted. */
+    label?: string;
+}
+
+export type { SpTimelineProps as S, TimelineData as T, TimelineDate as a, TimelineEra as b, TimelineSlide as c, TimelineText as d };

package/dist/ui-demos.d.ts

@@ -1,3 +1,7 @@
+import { T as TimelineData } from './types-DHBJ0PzV.js';
+import './types-D5ys35fF.js';
+import './props-BZ9CcrGv.js';
+
 /**
  * The props of one demo state: the component's own props (`Sp<Name>Props`), plus `value` for a
  * value component and `content` for the text it holds. Plain data; each adapter binds it.
@@ -9,9 +13,16 @@ type UiDemoProps = Readonly<Record<string, unknown> & {
 type UiDemos = Readonly<Record<string, Readonly<Record<string, UiDemoProps>>>>;
 /**
  * The reference states of the 17 components, drawn from the concept for `0.3.0` (feature-002
- * `concept.png`): one per declared state of `UI_COMPONENTS` (45), shared by the fixtures, the
- * example apps' UI page and the documentation. Frozen (I-9). Cards hold text only (C-5).
+ * `concept.png`), then of the 21 of feature-004: one per declared state of `UI_COMPONENTS` (45 +
+ * 35), shared by the fixtures, the example apps' pages and the documentation. Frozen (I-9). Cards
+ * hold text only (C-5). Overlays are demoed open, with `trigger` the text of their trigger button.
  */
 declare const UI_DEMOS: UiDemos;
 
-export { UI_DEMOS, type UiDemoProps, type UiDemos };
+/**
+ * The timeline page's data (Data Model delta §4): the life of a silverpoint drawing in TimelineJS
+ * JSON, eight events and two eras, no external media. Deep-frozen (I-9).
+ */
+declare const TIMELINE_DEMO: TimelineData;
+
+export { TIMELINE_DEMO, UI_DEMOS, type UiDemoProps, type UiDemos };