@keemakr/ui-sdk 1.5.0 → 1.6.0-dev-20261026112734

package/dist/edit.js

@@ -0,0 +1,60 @@
+// Renderer-side helpers for editing one block in place (`edit` on text, markdown, details and a
+// table column). They live in the SDK because core and every client draw the edit: what Save
+// posts, what a field starts with, and which cells can be edited must be one rule, or the web
+// saves a field the phone would have left alone.
+/** The edit control's accessible name and tooltip when the module gave no `label`. */
+export const INLINE_EDIT_DEFAULT_LABEL = 'Edit';
+/** The edit control's accessible name and tooltip: the module's `label`, or "Edit". */
+export function inlineEditLabel(edit) {
+    return edit.label?.trim() || INLINE_EDIT_DEFAULT_LABEL;
+}
+/**
+ * The ONE action press Save posts: the edit's `action`, its `input`, and each field's key set to
+ * its new value. A value wins over `input` on the same key, because it is what the reader just
+ * typed.
+ */
+export function inlineEditPress(edit, values) {
+    return { kind: 'action', action: edit.action, input: { ...edit.input, ...values } };
+}
+/**
+ * Save for one table cell: `row` is the row's key, and the column's key holds the new value.
+ */
+export function tableCellEditPress(edit, column, rowKey, value) {
+    return inlineEditPress(edit, { row: rowKey, [column]: value });
+}
+/** True for a cell an editable column lets the reader change: a `text` or `badge` cell. */
+export function cellEditable(cell) {
+    return cell?.kind === 'text' || cell?.kind === 'badge';
+}
+/**
+ * What a field starts with. An explicit `start` (a details item's `edit.value`) wins. With
+ * options, the option whose value or label is the shown text (a badge shows the label), or the
+ * first option. Without, the shown text.
+ */
+export function inlineEditStart(shown, options, start) {
+    if (start !== undefined)
+        return start;
+    if (!options || options.length === 0)
+        return shown;
+    return (options.find((o) => o.value === shown)?.value ??
+        options.find((o) => o.label === shown)?.value ??
+        options[0].value);
+}
+/**
+ * What each field of an editable `details` block starts with, by field key. Items without `edit`
+ * (and date items, which cannot be edited) are left out.
+ */
+export function detailsEditStart(items) {
+    const start = {};
+    for (const item of items) {
+        if (!item.edit || !cellEditable(item.value))
+            continue;
+        const shown = typeof item.value.value === 'string' ? item.value.value : '';
+        start[item.edit.field] = inlineEditStart(shown, item.edit.options, item.edit.value);
+    }
+    return start;
+}
+/** True when any field differs from what it started with: an edit that holds the screen still. */
+export function inlineEditDirty(start, draft) {
+    return Object.keys({ ...start, ...draft }).some((key) => (start[key] ?? '') !== (draft[key] ?? ''));
+}

package/dist/filters.d.ts

@@ -0,0 +1,54 @@
+import type { ValuePress } from './schema.js';
+/**
+ * How long a search box waits after the last keystroke before it fires. The
+ * renderer decides this, not the module, so every app feels the same.
+ */
+export declare const SEARCH_DEBOUNCE_MS = 300;
+/**
+ * The shortest non-empty query a pause fires. One letter matches most of a
+ * list and costs a reload; Enter fires any length, and clearing always fires.
+ */
+export declare const SEARCH_MIN_LENGTH = 2;
+/** "red,amber" → ['red', 'amber']. Empty or absent → []. Blank parts are dropped. */
+export declare function splitValues(param: string | null | undefined): string[];
+/**
+ * The set of chips that are on after `value` is pressed: added when it was off,
+ * removed when it was on. Kept in option order, so the same set always joins
+ * to the same param (one URL per filter, whatever order the chips were pressed).
+ */
+export declare function toggleValue(values: readonly string[], value: string, options: ReadonlyArray<{
+    value: string;
+}>): string[];
+/**
+ * The press a set of chips fires: the declared press with the whole set merged
+ * in under `name` — comma-joined into `params` for a navigate ('' when none is
+ * on), an array of strings into `input` for an action.
+ */
+export declare function pressWithValues(press: ValuePress, name: string, values: readonly string[]): ValuePress;
+/** What a renderer needs of a form to treat it as a live search box. */
+export interface LiveSearchFormLike {
+    fields: ReadonlyArray<{
+        kind: string;
+        name: string;
+        label: string;
+        value?: string;
+    }>;
+    onChange?: ValuePress;
+}
+/**
+ * The one text field of a live search form, or undefined when the form is not
+ * one (no `onChange`, or not exactly one text field), so the renderer draws it
+ * as an ordinary form.
+ */
+export declare function liveSearchField<F extends LiveSearchFormLike>(form: F): F['fields'][number] | undefined;
+/** What made a search box want to fire. */
+export type SearchTrigger = 'pause' | 'enter' | 'clear';
+/**
+ * Whether a search box fires `text` now, given the query it last sent (or the
+ * one the screen was loaded with). Nothing fires when the trimmed text is the
+ * query already applied. A pause does not fire a non-empty query shorter than
+ * SEARCH_MIN_LENGTH; Enter and the clear button always fire a change.
+ */
+export declare function searchFires(text: string, sent: string, trigger: SearchTrigger): boolean;
+/** The press a live search form fires for `text`: trimmed, under the field's name. */
+export declare function searchPress(form: LiveSearchFormLike, text: string): ValuePress | undefined;

package/dist/filters.js

@@ -0,0 +1,81 @@
+// Renderer-side helpers for a live filter bar: toggle chips (a `multiple`
+// select) and a live search box (a `form` with `onChange`). They live in the
+// SDK, not in a renderer, because core and every client draw these controls:
+// how several chosen values travel in a string-only params map, and when a
+// search box fires, must be one rule, or the same screen filters differently on
+// web and in core.
+import { pressWithValue } from './pager.js';
+/**
+ * How long a search box waits after the last keystroke before it fires. The
+ * renderer decides this, not the module, so every app feels the same.
+ */
+export const SEARCH_DEBOUNCE_MS = 300;
+/**
+ * The shortest non-empty query a pause fires. One letter matches most of a
+ * list and costs a reload; Enter fires any length, and clearing always fires.
+ */
+export const SEARCH_MIN_LENGTH = 2;
+/** "red,amber" → ['red', 'amber']. Empty or absent → []. Blank parts are dropped. */
+export function splitValues(param) {
+    if (!param)
+        return [];
+    return param
+        .split(',')
+        .map((part) => part.trim())
+        .filter((part) => part !== '');
+}
+/**
+ * The set of chips that are on after `value` is pressed: added when it was off,
+ * removed when it was on. Kept in option order, so the same set always joins
+ * to the same param (one URL per filter, whatever order the chips were pressed).
+ */
+export function toggleValue(values, value, options) {
+    const on = new Set(values);
+    if (on.has(value))
+        on.delete(value);
+    else
+        on.add(value);
+    return options.map((option) => option.value).filter((v) => on.has(v));
+}
+/**
+ * The press a set of chips fires: the declared press with the whole set merged
+ * in under `name` — comma-joined into `params` for a navigate ('' when none is
+ * on), an array of strings into `input` for an action.
+ */
+export function pressWithValues(press, name, values) {
+    if (press.kind === 'navigate')
+        return pressWithValue(press, name, values.join(','));
+    return { ...press, input: { ...press.input, [name]: [...values] } };
+}
+/**
+ * The one text field of a live search form, or undefined when the form is not
+ * one (no `onChange`, or not exactly one text field), so the renderer draws it
+ * as an ordinary form.
+ */
+export function liveSearchField(form) {
+    if (!form.onChange || form.fields.length !== 1)
+        return undefined;
+    const only = form.fields[0];
+    return only && only.kind === 'text' ? only : undefined;
+}
+/**
+ * Whether a search box fires `text` now, given the query it last sent (or the
+ * one the screen was loaded with). Nothing fires when the trimmed text is the
+ * query already applied. A pause does not fire a non-empty query shorter than
+ * SEARCH_MIN_LENGTH; Enter and the clear button always fire a change.
+ */
+export function searchFires(text, sent, trigger) {
+    const query = text.trim();
+    if (query === sent.trim())
+        return false;
+    if (trigger === 'pause' && query.length > 0 && query.length < SEARCH_MIN_LENGTH)
+        return false;
+    return true;
+}
+/** The press a live search form fires for `text`: trimmed, under the field's name. */
+export function searchPress(form, text) {
+    const field = liveSearchField(form);
+    if (!field || !form.onChange)
+        return undefined;
+    return pressWithValue(form.onChange, field.name, text.trim());
+}

package/dist/form.d.ts

@@ -1,4 +1,5 @@
-export type FormFieldKind = 'text' | 'textarea' | 'select' | 'number' | 'date' | 'datetime' | 'checkbox' | 'multiselect' | 'combobox' | 'list';
+import type { Press } from './schema.js';
+export type FormFieldKind = 'text' | 'textarea' | 'select' | 'number' | 'date' | 'datetime' | 'checkbox' | 'multiselect' | 'combobox' | 'list' | 'radio';
 export interface FormFieldLike {
     kind: FormFieldKind;
     value?: string;
@@ -17,3 +18,46 @@ export declare function localInputToIso(local: string): string;
 export declare function initialDraft(field: FormFieldLike): FormDraft;
 /** What the module receives for a field. See the form schema for each kind. */
 export declare function postedValue(field: Pick<FormFieldLike, 'kind'>, draft: FormDraft): string | number | boolean | string[] | null;
+/** One send button of a form: its `submit` or one of its `secondary`. */
+export interface FormSubmit {
+    label: string;
+    action: string;
+    input?: Record<string, unknown>;
+    confirm?: string;
+    /** Check required fields before posting. */
+    validate: boolean;
+    /** The form's own `submit`: Enter presses it, and it is drawn as the main button. */
+    primary: boolean;
+    /** Drawn in its place but refuses the press, as a disabled button does. */
+    disabled: boolean;
+    /** Why it is disabled; present only while it is. */
+    disabledReason?: string;
+}
+interface SendLike {
+    label: string;
+    action: string;
+    confirm?: string;
+    disabled?: boolean;
+    disabledReason?: string;
+}
+/** Every send button of a form in drawing order: `submit` first, then `secondary`. */
+export declare function formSubmits(form: {
+    submit: SendLike;
+    secondary?: ReadonlyArray<SendLike & {
+        input?: Record<string, unknown>;
+        validate?: boolean;
+    }>;
+}): FormSubmit[];
+/**
+ * The send a submit of the form presses, or null when it must not post: the button the reader
+ * pressed (`at`, its index in `formSubmits`), or the primary for Enter in a field. A disabled send
+ * posts nothing, and Enter with a disabled primary does not fall through to a secondary.
+ */
+export declare function chosenSubmit(submits: readonly FormSubmit[], at: number | null | undefined): FormSubmit | null;
+/**
+ * The press a form's send button fires: its action, with its own static input
+ * under the posted field values (a field wins over a same-named key), and its
+ * confirm.
+ */
+export declare function formPress(submit: Pick<FormSubmit, 'action' | 'input' | 'confirm'>, values: Record<string, unknown>): Press;
+export {};

package/dist/form.js

@@ -51,3 +51,42 @@ export function postedValue(field, draft) {
             return typeof draft === 'string' ? draft : '';
     }
 }
+/** Every send button of a form in drawing order: `submit` first, then `secondary`. */
+export function formSubmits(form) {
+    // A reason is only for a disabled send, as on a button: an enabled one says nothing.
+    const state = ({ disabled, disabledReason, ...rest }) => ({
+        ...rest,
+        disabled: disabled === true,
+        ...(disabled && disabledReason ? { disabledReason } : {}),
+    });
+    return [
+        { ...state(form.submit), validate: true, primary: true },
+        ...(form.secondary ?? []).map(({ validate, ...more }) => ({
+            ...state(more),
+            validate: validate ?? true,
+            primary: false,
+        })),
+    ];
+}
+/**
+ * The send a submit of the form presses, or null when it must not post: the button the reader
+ * pressed (`at`, its index in `formSubmits`), or the primary for Enter in a field. A disabled send
+ * posts nothing, and Enter with a disabled primary does not fall through to a secondary.
+ */
+export function chosenSubmit(submits, at) {
+    const chosen = (at == null ? undefined : submits[at]) ?? submits[0];
+    return chosen && !chosen.disabled ? chosen : null;
+}
+/**
+ * The press a form's send button fires: its action, with its own static input
+ * under the posted field values (a field wins over a same-named key), and its
+ * confirm.
+ */
+export function formPress(submit, values) {
+    return {
+        kind: 'action',
+        action: submit.action,
+        input: { ...submit.input, ...values },
+        ...(submit.confirm ? { confirm: submit.confirm } : {}),
+    };
+}

package/dist/heatmap.d.ts

@@ -0,0 +1,36 @@
+/** The parts of a heatmap node the scale reads. */
+export interface HeatmapLike {
+    rows: ReadonlyArray<{
+        values: ReadonlyArray<number | null>;
+    }>;
+    min?: number;
+    max?: number;
+}
+/** The two ends of a heatmap's scale. */
+export interface HeatmapRange {
+    low: number;
+    high: number;
+}
+/**
+ * The ends of the scale: the node's `min` and `max`, and where either is left off, the smallest
+ * or largest value present. A grid with no values at all gets 0 to 1.
+ */
+export declare function heatmapRange(node: HeatmapLike): HeatmapRange;
+/**
+ * How strongly a cell is shaded, from 0 (the low end) to 1 (the high end), or null for a cell
+ * with no data. A value outside the range takes the nearer end. When every value is the same,
+ * each cell is shaded fully.
+ */
+export declare function heatmapIntensity(value: number | null, range: HeatmapRange): number | null;
+/**
+ * The share of the tone a cell's background mixes in, as a percent: 8 at the low end so a low
+ * value still reads as a cell with data, 80 at the high end.
+ */
+export declare function heatmapMixPercent(intensity: number): number;
+/**
+ * Whether a cell's number is written in the surface colour the tone is mixed into (the card's),
+ * rather than the page's text colour: on a strong shade that is what contrasts, in either theme.
+ */
+export declare function heatmapStrong(intensity: number): boolean;
+/** A cell's words: "92%", or "No data" for null. */
+export declare function heatmapCellText(value: number | null, suffix?: string): string;

package/dist/heatmap.js

@@ -0,0 +1,56 @@
+// How a heatmap cell is shaded and written, shared by core and the clients so every renderer
+// shades the same number the same way.
+/**
+ * The ends of the scale: the node's `min` and `max`, and where either is left off, the smallest
+ * or largest value present. A grid with no values at all gets 0 to 1.
+ */
+export function heatmapRange(node) {
+    let low = Infinity;
+    let high = -Infinity;
+    for (const row of node.rows) {
+        for (const value of row.values) {
+            if (value === null)
+                continue;
+            if (value < low)
+                low = value;
+            if (value > high)
+                high = value;
+        }
+    }
+    if (low === Infinity) {
+        low = 0;
+        high = 1;
+    }
+    return { low: node.min ?? low, high: node.max ?? high };
+}
+/**
+ * How strongly a cell is shaded, from 0 (the low end) to 1 (the high end), or null for a cell
+ * with no data. A value outside the range takes the nearer end. When every value is the same,
+ * each cell is shaded fully.
+ */
+export function heatmapIntensity(value, range) {
+    if (value === null)
+        return null;
+    const span = range.high - range.low;
+    if (!(span > 0))
+        return 1;
+    return Math.min(1, Math.max(0, (value - range.low) / span));
+}
+/**
+ * The share of the tone a cell's background mixes in, as a percent: 8 at the low end so a low
+ * value still reads as a cell with data, 80 at the high end.
+ */
+export function heatmapMixPercent(intensity) {
+    return Math.round(8 + intensity * 72);
+}
+/**
+ * Whether a cell's number is written in the surface colour the tone is mixed into (the card's),
+ * rather than the page's text colour: on a strong shade that is what contrasts, in either theme.
+ */
+export function heatmapStrong(intensity) {
+    return intensity >= 0.6;
+}
+/** A cell's words: "92%", or "No data" for null. */
+export function heatmapCellText(value, suffix) {
+    return value === null ? 'No data' : `${value}${suffix ?? ''}`;
+}

package/dist/icon.d.ts

@@ -0,0 +1,20 @@
+/** The icon names a heading, a section title and a button take. Each is a Lucide icon on web. */
+export declare const UI_ICONS: readonly ["phone", "mail", "message", "calendar", "user", "building", "bot", "wrench", "note", "pencil", "stethoscope", "clipboard", "camera", "image", "check", "alert", "clock", "plus", "trash"];
+export type UiIcon = (typeof UI_ICONS)[number];
+/** The button fields `buttonIcon` reads. Loose, so a client whose installed SDK predates them can pass its own node. */
+export interface IconButtonLike {
+    label?: string;
+    icon?: string;
+    iconOnly?: boolean;
+}
+/**
+ * How a renderer draws a button's icon: `icon` is a name from the list or undefined (an unknown
+ * name draws nothing), and `iconOnly` is true only with an icon and a label to name it by, so a
+ * button is never drawn as a bare glyph nobody can name.
+ */
+export declare function buttonIcon(button: IconButtonLike): {
+    icon?: UiIcon;
+    iconOnly: boolean;
+};
+/** A name from the list, or undefined. */
+export declare function uiIconOf(value: unknown): UiIcon | undefined;

package/dist/icon.js

@@ -0,0 +1,43 @@
+// The icons a `heading`, a `section` title and a `button` may carry. A closed list, not free text,
+// like the timeline's: every renderer (core, web, mobile) maps each name to its own drawing, so a
+// name outside the list would draw nothing on one platform and something on another. Add a name
+// here only with a drawing on every renderer.
+//
+// It starts from the timeline's icons, so a module uses one vocabulary, and adds the glyphs a
+// clinic screen needs to tell its parts apart at a glance: a note's five blocks (assessment,
+// plan, photos, follow-up, alerts), an edit pencil, a camera.
+//
+// On a heading or a section title the icon is decorative: the words say what the part is, so it
+// is hidden from screen readers. On an icon-only button the label is still required: it is the
+// button's accessible name and its tooltip, and what an app that predates `icon` shows instead.
+import { TIMELINE_ICONS } from './timeline.js';
+/** The icon names a heading, a section title and a button take. Each is a Lucide icon on web. */
+export const UI_ICONS = [
+    ...TIMELINE_ICONS,
+    'pencil',
+    'stethoscope',
+    'clipboard',
+    'camera',
+    'image',
+    'check',
+    'alert',
+    'clock',
+    'plus',
+    'trash',
+];
+/**
+ * How a renderer draws a button's icon: `icon` is a name from the list or undefined (an unknown
+ * name draws nothing), and `iconOnly` is true only with an icon and a label to name it by, so a
+ * button is never drawn as a bare glyph nobody can name.
+ */
+export function buttonIcon(button) {
+    const icon = uiIconOf(button.icon);
+    const named = typeof button.label === 'string' && button.label.trim() !== '';
+    return { ...(icon ? { icon } : {}), iconOnly: !!icon && button.iconOnly === true && named };
+}
+/** A name from the list, or undefined. */
+export function uiIconOf(value) {
+    return typeof value === 'string' && UI_ICONS.includes(value)
+        ? value
+        : undefined;
+}

package/dist/index.d.ts

@@ -1,15 +1,48 @@
-export { UI_SCHEMA_VERSION, pressSchema, buttonSchema, cellSchema, nodeSchema, screenPresentationSchema, screenTreeSchema, actionResultSchema, screenLoadRequestSchema, screenLoadResponseSchema, screenActionRequestSchema, interfaceFamilySchema, surfaceDefinitionSchema, surfaceSchema, screenRegistrationSchema, uiManifestSchema, jobIdSchema, jobStatusSchema, screenJobRequestSchema, mediaPathSchema, } from './schema.js';
-export type { Press, ScreenPresentation, ScreenNode, ScreenRootNode, ScreenTree, ActionResult, InterfaceFamily, SurfaceDefinition, Surface, ScreenRegistration, UiManifest, ScreenTreeInput, ActionResultInput, JobStatus, JobStatusInput, } from './schema.js';
+export { UI_SCHEMA_VERSION, pressSchema, chatPressSchema, valuePressSchema, NAVIGATE_OPENS, buttonSchema, cellSchema, tableCellSchema, dateFormatSchema, nodeSchema, screenPresentationSchema, screenTreeSchema, actionResultSchema, screenLoadRequestSchema, screenLoadResponseSchema, screenActionRequestSchema, interfaceFamilySchema, surfaceDefinitionSchema, surfaceSchema, screenRegistrationSchema, uiManifestSchema, jobIdSchema, jobStatusSchema, screenJobRequestSchema, mediaPathSchema, seekPointSchema, seekPressSchema, BADGE_COUNT_MAX, surfaceBadgeSchema, screenBadgesRequestSchema, screenBadgesResponseSchema, TABS_MAX, } from './schema.js';
+export type { Press, ChatPress, SeekPress, SeekPoint, ValuePress, NavigatePress, NavigateOpen, ScreenPresentation, ScreenNode, ScreenRootNode, ScreenTree, ActionResult, InterfaceFamily, SurfaceDefinition, Surface, ScreenRegistration, UiManifest, ScreenTreeInput, ActionResultInput, JobStatus, JobStatusInput, SurfaceBadge, SurfaceBadgeInput, ScreenBadgesRequest, ScreenBadgesResponse, } from './schema.js';
+export { BADGE_DISPLAY_MAX, answerBadges, badgeSpokenLabel, badgeText, defineBadges, parseScreenBadges, } from './badges.js';
+export type { BadgesHandler } from './badges.js';
+export { CHART_POINTS_MAX, thinChart, thinnedIndices } from './chart.js';
+export { TABS_MAX_1_4_0, foldTabs, onlyTabParamsDiffer, openingTab, tabParamsOf } from './tabs.js';
 export { childNodesOf, KNOWN_CONTAINERS, KNOWN_NODE_TYPES } from './nodes.js';
 export type { ContainerChild, ContainerNodeType, KnownNodeType } from './nodes.js';
 export { pageRangeLabel, pageWindow, pressWithValue } from './pager.js';
+export { MARKDOWN_LINKS_MAX, SCREEN_LINK_SCHEME, isScreenLink, resolveScreenLink, screenLinkRef, withoutScreenLinks, } from './markdown-links.js';
+export { foldTableCell, isNewerTableCell, meterLabel, meterPercent } from './cells.js';
+export { opensInDrawer, screenPlace } from './drawer.js';
+export type { ScreenPlace } from './drawer.js';
+export { SEARCH_DEBOUNCE_MS, SEARCH_MIN_LENGTH, liveSearchField, pressWithValues, searchFires, searchPress, splitValues, toggleValue, } from './filters.js';
+export type { LiveSearchFormLike, SearchTrigger } from './filters.js';
+export { CHANNEL_BUILDS, CLIENT_RELEASES, CORE_DRAWN_NODE_TYPES, CURRENT_SCHEMA_CLAIM, CURRENT_UI_SDK_SNAPSHOT, FLOOR_NODE_SET, GENERIC_FALLBACK_TEXT, SAFETY_FALLBACK_TEXT, UI_SDK_SNAPSHOTS, fallbackNode, isChatPress, latestRelease, negotiateTree, nodeSetForClaim, nodeSetForClient, uiSchemaClaimOf, } from './negotiate.js';
+export type { ChannelBuild, ClientRelease, ClientTarget, Fallback, NegotiatedTree, NodeSet, UiFeature, UiSchemaClaim, UiSdkSnapshot, } from './negotiate.js';
+export { PUBLISHED_PARSERS, type PublishedParser } from './published/index.js';
 export { MEDIA_CONTENT_TYPES, mediaContentType, mediaPathOf } from './media.js';
-export { initialDraft, isoToLocalInput, localInputToIso, postedValue } from './form.js';
-export type { FormDraft, FormFieldKind, FormFieldLike } from './form.js';
+export { PLAYBACK_RATES, SEEK_AT_MAX, formatPlayhead, isSeekPress, nextPlaybackRate, playbackRateLabel, playheadWords, seekTarget, seeksIn, } from './player.js';
+export type { PlaybackRate, PlayerKey, SeekReference } from './player.js';
+export { heatmapCellText, heatmapIntensity, heatmapMixPercent, heatmapRange, heatmapStrong, } from './heatmap.js';
+export type { HeatmapLike, HeatmapRange } from './heatmap.js';
+export { chosenSubmit, formPress, formSubmits, initialDraft, isoToLocalInput, localInputToIso, postedValue, } from './form.js';
+export type { FormDraft, FormFieldKind, FormFieldLike, FormSubmit } from './form.js';
+export { stackedBarParts, stackedBarValue } from './stacked-bar.js';
+export type { StackedBarLike, StackedBarParts, StackedBarSegmentPart } from './stacked-bar.js';
+export { statTrend } from './stat.js';
+export type { StatTrend, StatTrendFeel, StatTrendLike } from './stat.js';
+export { createSectionMemory, sectionBadge, sectionCollapsible, sectionColumnWeights, sectionGridTemplate, sectionScrollHeight, } from './section.js';
+export type { SectionBadge, SectionLike, SectionMemory, SectionScrollHeight } from './section.js';
+export { tableRowEmphasis } from './table-row.js';
+export type { TableRowEmphasis, TableRowLike, TableRowTone } from './table-row.js';
+export { TIMELINE_ICONS, timelineIconWord } from './timeline.js';
+export type { TimelineIcon } from './timeline.js';
+export { cellEditable, detailsEditStart, INLINE_EDIT_DEFAULT_LABEL, inlineEditDirty, inlineEditLabel, inlineEditPress, inlineEditStart, tableCellEditPress, } from './edit.js';
+export type { EditableCellLike, EditableDetailsItemLike, InlineEditLike, InlineEditOption, InlineEditPress, } from './edit.js';
+export { UI_ICONS, buttonIcon, uiIconOf } from './icon.js';
+export type { IconButtonLike, UiIcon } from './icon.js';
 export { composerPress, composerShortcut } from './composer.js';
 export type { ComposerKey, ComposerShortcut } from './composer.js';
 export { addDays, calendarDays, dayStartMs, entriesOnDay, intlTimeZone, isTimeZone, placeEntries, shiftCalendarDate, slotIsFree, slotTimes, todayIn, } from './calendar.js';
 export type { CalendarEntryLike, CalendarView, CalendarZone, PlacedEntry } from './calendar.js';
+export { dateTimeFormatOptions, formatMoment, isDateLocale, mergeDateFormat, } from './date-format.js';
+export type { DateFormat, MomentStyle } from './date-format.js';
 export { DATASET_FIELD_ROLES, DATASET_FIELD_TYPES, DATASET_LIMITS, answerDatasetCreate, answerDatasetQuery, datasetCreateInput, datasetCreateRequestSchema, datasetCreateResponseSchema, datasetDeclarationSchema, datasetFieldSchema, datasetManifestSchema, datasetQueryRequestSchema, datasetQueryResponseSchema, datasetRequestIssues, datasetResponseIssues, datasetRowSchema, defineDataset, } from './dataset.js';
 export type { DatasetCell, DatasetCreateCheck, DatasetCreateHandler, DatasetCreateRequest, DatasetCreateResponse, DatasetCreateResponseInput, DatasetDeclaration, DatasetDeclarationInput, DatasetDefinition, DatasetField, DatasetFieldRole, DatasetFieldType, DatasetQueryHandler, DatasetQueryRequest, DatasetQueryRequestInput, DatasetQueryResponse, DatasetQueryResponseInput, DatasetRow, } from './dataset.js';
 export { DATASET_CREATE_ACTION, DATASET_LAYOUTS, DATASET_MAX_PAGE, DATASET_NEW_PARAM, DATASET_RECORD_SECTION, compileDatasetCreate, compileDatasetNode, compileDatasetRecord, compileDatasetRecordPanel, datasetCell, datasetNodeIssues, datasetNodeSchema, datasetPage, datasetQueryFor, datasetRecordKey, datasetRecordQuery, } from './dataset-view.js';

package/dist/index.js

@@ -6,13 +6,32 @@
 //                    platform components, proxies load/action with a grant
 //
 // Module code never ships to the browser. UI is data, not code.
-export { UI_SCHEMA_VERSION, pressSchema, buttonSchema, cellSchema, nodeSchema, screenPresentationSchema, screenTreeSchema, actionResultSchema, screenLoadRequestSchema, screenLoadResponseSchema, screenActionRequestSchema, interfaceFamilySchema, surfaceDefinitionSchema, surfaceSchema, screenRegistrationSchema, uiManifestSchema, jobIdSchema, jobStatusSchema, screenJobRequestSchema, mediaPathSchema, } from './schema.js';
+export { UI_SCHEMA_VERSION, pressSchema, chatPressSchema, valuePressSchema, NAVIGATE_OPENS, buttonSchema, cellSchema, tableCellSchema, dateFormatSchema, nodeSchema, screenPresentationSchema, screenTreeSchema, actionResultSchema, screenLoadRequestSchema, screenLoadResponseSchema, screenActionRequestSchema, interfaceFamilySchema, surfaceDefinitionSchema, surfaceSchema, screenRegistrationSchema, uiManifestSchema, jobIdSchema, jobStatusSchema, screenJobRequestSchema, mediaPathSchema, seekPointSchema, seekPressSchema, BADGE_COUNT_MAX, surfaceBadgeSchema, screenBadgesRequestSchema, screenBadgesResponseSchema, TABS_MAX, } from './schema.js';
+export { BADGE_DISPLAY_MAX, answerBadges, badgeSpokenLabel, badgeText, defineBadges, parseScreenBadges, } from './badges.js';
+export { CHART_POINTS_MAX, thinChart, thinnedIndices } from './chart.js';
+export { TABS_MAX_1_4_0, foldTabs, onlyTabParamsDiffer, openingTab, tabParamsOf } from './tabs.js';
 export { childNodesOf, KNOWN_CONTAINERS, KNOWN_NODE_TYPES } from './nodes.js';
 export { pageRangeLabel, pageWindow, pressWithValue } from './pager.js';
+export { MARKDOWN_LINKS_MAX, SCREEN_LINK_SCHEME, isScreenLink, resolveScreenLink, screenLinkRef, withoutScreenLinks, } from './markdown-links.js';
+export { foldTableCell, isNewerTableCell, meterLabel, meterPercent } from './cells.js';
+export { opensInDrawer, screenPlace } from './drawer.js';
+export { SEARCH_DEBOUNCE_MS, SEARCH_MIN_LENGTH, liveSearchField, pressWithValues, searchFires, searchPress, splitValues, toggleValue, } from './filters.js';
+export { CHANNEL_BUILDS, CLIENT_RELEASES, CORE_DRAWN_NODE_TYPES, CURRENT_SCHEMA_CLAIM, CURRENT_UI_SDK_SNAPSHOT, FLOOR_NODE_SET, GENERIC_FALLBACK_TEXT, SAFETY_FALLBACK_TEXT, UI_SDK_SNAPSHOTS, fallbackNode, isChatPress, latestRelease, negotiateTree, nodeSetForClaim, nodeSetForClient, uiSchemaClaimOf, } from './negotiate.js';
+export { PUBLISHED_PARSERS } from './published/index.js';
 export { MEDIA_CONTENT_TYPES, mediaContentType, mediaPathOf } from './media.js';
-export { initialDraft, isoToLocalInput, localInputToIso, postedValue } from './form.js';
+export { PLAYBACK_RATES, SEEK_AT_MAX, formatPlayhead, isSeekPress, nextPlaybackRate, playbackRateLabel, playheadWords, seekTarget, seeksIn, } from './player.js';
+export { heatmapCellText, heatmapIntensity, heatmapMixPercent, heatmapRange, heatmapStrong, } from './heatmap.js';
+export { chosenSubmit, formPress, formSubmits, initialDraft, isoToLocalInput, localInputToIso, postedValue, } from './form.js';
+export { stackedBarParts, stackedBarValue } from './stacked-bar.js';
+export { statTrend } from './stat.js';
+export { createSectionMemory, sectionBadge, sectionCollapsible, sectionColumnWeights, sectionGridTemplate, sectionScrollHeight, } from './section.js';
+export { tableRowEmphasis } from './table-row.js';
+export { TIMELINE_ICONS, timelineIconWord } from './timeline.js';
+export { cellEditable, detailsEditStart, INLINE_EDIT_DEFAULT_LABEL, inlineEditDirty, inlineEditLabel, inlineEditPress, inlineEditStart, tableCellEditPress, } from './edit.js';
+export { UI_ICONS, buttonIcon, uiIconOf } from './icon.js';
 export { composerPress, composerShortcut } from './composer.js';
 export { addDays, calendarDays, dayStartMs, entriesOnDay, intlTimeZone, isTimeZone, placeEntries, shiftCalendarDate, slotIsFree, slotTimes, todayIn, } from './calendar.js';
+export { dateTimeFormatOptions, formatMoment, isDateLocale, mergeDateFormat, } from './date-format.js';
 export { DATASET_FIELD_ROLES, DATASET_FIELD_TYPES, DATASET_LIMITS, answerDatasetCreate, answerDatasetQuery, datasetCreateInput, datasetCreateRequestSchema, datasetCreateResponseSchema, datasetDeclarationSchema, datasetFieldSchema, datasetManifestSchema, datasetQueryRequestSchema, datasetQueryResponseSchema, datasetRequestIssues, datasetResponseIssues, datasetRowSchema, defineDataset, } from './dataset.js';
 export { DATASET_CREATE_ACTION, DATASET_LAYOUTS, DATASET_MAX_PAGE, DATASET_NEW_PARAM, DATASET_RECORD_SECTION, compileDatasetCreate, compileDatasetNode, compileDatasetRecord, compileDatasetRecordPanel, datasetCell, datasetNodeIssues, datasetNodeSchema, datasetPage, datasetQueryFor, datasetRecordKey, datasetRecordQuery, } from './dataset-view.js';
 export { CHAT_BLOCK_EXAMPLES, CHAT_BLOCK_FENCE, CHAT_BLOCK_LIMITS, CHAT_BLOCK_TYPES, chatBlocksGuide, checkChatBlocks, findChatBlockFences, parseChatBlocks, settleChatBlocks, } from './chat-blocks.js';

package/dist/markdown-links.d.ts

@@ -0,0 +1,29 @@
+/** The scheme a link to a screen is written with: `[words](screen:ref)`. */
+export declare const SCREEN_LINK_SCHEME = "screen:";
+/** The most refs one markdown node's `links` map holds. */
+export declare const MARKDOWN_LINKS_MAX = 50;
+/**
+ * True for any link written with the `screen:` scheme, in any case and with any spaces around
+ * it. A renderer never hands such a link to the browser or the phone as a URL: it is either a
+ * ref in the node's map (a press) or plain text.
+ */
+export declare function isScreenLink(href: string | null | undefined): boolean;
+/** The ref a `screen:` link names, or null when it is not exactly `screen:<slug>`. */
+export declare function screenLinkRef(href: string | null | undefined): string | null;
+/**
+ * The press a `screen:` link opens: the entry of `links` its ref names, or null. Only the map's
+ * own entries count (never `constructor` or anything else an object inherits), and only an entry
+ * that is a navigate press, so a renderer that is handed a loosely typed map still opens nothing
+ * else. Null means: draw the link's words as plain text.
+ */
+export declare function resolveScreenLink<P extends {
+    kind: string;
+}>(href: string | null | undefined, links: Readonly<Record<string, P>> | null | undefined): P | null;
+/**
+ * The markdown with every `screen:` link turned into its words, for a client that does not draw
+ * them (negotiate.ts, `markdown.links`). An older renderer would draw such a link as a broken link
+ * or as the raw `[words](screen:ref)`; this way it reads as the sentence the module wrote. Inline
+ * links, autolinks and reference definitions (with the links that use them) are folded; code is
+ * left as written. Pure; returns the same string when there is nothing to fold.
+ */
+export declare function withoutScreenLinks(value: string): string;