@exponential-at/ui 0.0.0-stage → 0.1.0

package/dist/types/src/web/host-types.d.ts

@@ -0,0 +1,119 @@
+import type { FunctionCallInfo, MediaOptions, MediaRequest, ThemeIssue, UiNode, UrlPolicy } from "@exponential-at/ui";
+import type { ClientFunction } from "./data.js";
+/** A registry name → the renderer's icon component (a map or a lookup). */
+export type IconMap<Icon = unknown> = Record<string, Icon | undefined> | ((name: string) => Icon | undefined);
+/** A user action: a node's `on.<event>` with an `event` action, resolved. */
+export interface SurfaceActionEvent {
+    surfaceId: string;
+    /** The catalog event (`press`, `change`, `select`, `submit`…). */
+    event: string;
+    /** The action's `event.name`. */
+    name: string;
+    componentId: string;
+    context: Record<string, unknown>;
+    /** What the component adds (a Select's `value`, a Tabs' `value`…). */
+    payload?: Record<string, unknown>;
+    timestamp: string;
+}
+/** A host-owned input edit. `change` fires debounced while typing with a
+ *  monotonically increasing `revision`; `commit` on blur / Enter. The host's
+ *  echo (a data model write at `path`) is applied only while no newer
+ *  revision is outstanding and the field is not focused. */
+export interface SurfaceInputEvent {
+    surfaceId: string;
+    componentId: string;
+    /** The input's `name` prop. */
+    name: string;
+    /** The bound data model pointer, when `value` is a binding. */
+    path?: string;
+    value: unknown;
+    revision: number;
+    kind: `change` | `commit`;
+}
+/** A painter that failed: the surface, the component, why. */
+export interface PaintError {
+    surfaceId: string;
+    componentId: string;
+    message: string;
+}
+/** One option a host source supplies (the catalog's `option` shape). */
+export interface SourceOption {
+    label: string;
+    value: string;
+    icon?: string;
+    disabled?: boolean;
+}
+export interface HostPlugin<Icon = unknown, Markdown = unknown> {
+    /** The icon registry: the catalog's `Icon` names → components. */
+    icons?: IconMap<Icon>;
+    /** Server events. Returning a promise keeps the source control in its
+     *  optimistic pending state until it settles. */
+    onAction?: (event: SurfaceActionEvent) => void | Promise<void>;
+    /** Host-owned input edits. Returning a promise acknowledges the revision
+     *  when it settles; a sync host acknowledges at once. */
+    onInput?: (event: SurfaceInputEvent) => void | Promise<void>;
+    /** Opens an href the URL policy allowed (`openUrl`, `Link`); default
+     *  `window.open(url, "_blank")`. */
+    openUrl?: (url: string) => void;
+    /** The URL policy EVERY href passes (Link, markdown links, FileUpload
+     *  file urls, openUrl): `catalog/host.json` urls. Unset = the default
+     *  schemes; relative urls resolve against `baseUrl`, else `media.baseUrl`,
+     *  else the document's. A denied href paints as text. */
+    urls?: UrlPolicy;
+    /** The media policy every src passes when there is no `mediaRequest`
+     *  (schemes, hosts, private opt-ins, base, header rules):
+     *  `catalog/host.json` media. */
+    media?: MediaOptions;
+    /** Extra or overriding client functions, web renderers only (`{call,
+     *  args}` in a prop; an action naming one runs it). Any OTHER action
+     *  function name goes to onFunctionCall (the portable host functions). */
+    functions?: Record<string, ClientFunction>;
+    /** An action `functionCall` to a name outside the built-ins (the host
+     *  function registry + its policy gate, `ExponentialHost.callFunction`).
+     *  A promise keeps the source control pending until it settles. */
+    onFunctionCall?: (call: FunctionCallInfo) => unknown | Promise<unknown>;
+    /** The media loader's request for a source (absolute url + headers, e.g.
+     *  auth for /api/attachments); null = denied. A request WITH headers is
+     *  fetched (under the media limits) and shown as a blob url; without, its
+     *  url is used as is. Its url is re-checked against `media`'s schemes,
+     *  hosts and private opt-ins. */
+    mediaRequest?: (src: string) => MediaRequest | null;
+    /** Video/Audio (`catalog/host.json` media: the byte limits do not apply,
+     *  they stream): a url the browser's player loads WITHOUT headers for a
+     *  request that carries some (a signed or cookie-authed url), so the
+     *  player streams and seeks. Its result passes the media policy again.
+     *  Unset = the request is fetched whole into a blob url under the media
+     *  byte cap and timeout for the WHOLE download (VAPP-107), so a long
+     *  video needs this hook. */
+    mediaStreamUrl?: (request: MediaRequest) => string | Promise<string>;
+    /** A richer markdown renderer than the built-in one (a component taking
+     *  `{text, className}` in the renderer's framework). */
+    Markdown?: Markdown;
+    /** Rewrites a media src BEFORE the media policy (signed URLs). */
+    resolveUrl?: (src: string) => string;
+    /** `onPaintError` (`catalog/host.json` paint): a component's painter
+     *  failed; it paints an empty box. `hostPlugin(host)` forwards it to the
+     *  agent as an A2UI `RENDER_FAILED` error. */
+    onPaintError?: (error: PaintError) => void;
+    /** Called with the node for every Unknown placeholder painted. */
+    onUnknown?: (node: UiNode) => void;
+    /** Round 4 (VAPP-103): the `theme` prop was unusable (an unknown built-in
+     *  id, a theme file with issues). The surface never throws: it paints
+     *  with the default theme and reports why here. */
+    onThemeIssues?: (issues: ThemeIssue[]) => void;
+    /** Round 1, FileUpload: the picked/dropped files' BYTES (the `upload`
+     *  event carries only `{name, size, type}`). Return a promise to keep the
+     *  drop zone busy until it settles. */
+    onUpload?: (files: File[], target: {
+        nodeId: string;
+        name: string;
+    }) => void | Promise<void>;
+    /** Round 1, Select `source`: a host list id (`exp:statuses`) → its
+     *  options for a query (`""` when not searchable). */
+    optionSource?: (source: string, query: string) => SourceOption[] | Promise<SourceOption[]>;
+}
+/** Any renderer's plugin (what the framework-free helpers take). */
+export type AnyHostPlugin = HostPlugin<unknown, unknown>;
+/** A registry lookup: the host's map (or function) first, then the
+ *  renderer's own fallbacks. */
+export declare function lookupIcon<Icon>(icons: IconMap<Icon> | undefined, name: string, fallbacks?: Readonly<Record<string, Icon>>): Icon | undefined;

package/dist/types/src/web/index.d.ts

@@ -0,0 +1,28 @@
+export { compileTheme, compiledTheme, globalsCss, themeScope, partClass, propAttribute, tokenVar, tokenVarName, cssValue, declarations, animationDeclarations, shimmerRule, rule, ruleSelectors, isMacroComponent, STATE_SELECTORS, LAYERS } from "./theme-css.js";
+export type { CompiledTheme } from "./theme-css.js";
+export { nodeSheet, compileNodeSheet, nodeSheetBatches, dynamicStyleEntries, queryToken, nodeClass, surfaceClass, walkNodes, cssEscape, resolvedMediaKey, styleDirection } from "./box-css.js";
+export type { NodeSheet, NodeSheetBatch, DynamicStyleEntry } from "./box-css.js";
+export { BASE_CSS } from "./base-css.js";
+export { getPointer, setPointer, pointerTokens, absolutePath, resolveValue, resolveProps, resolveNodeProps, resolveVisible, resolveAccessibility, ariaAttributes, bindTree, boundPath, hostPath, isBinding, isCall, hasDynamic, memoFormatter, formatterOf, viewOf, CLIENT_FUNCTIONS, LITERAL_ROWS_ROOT } from "./data.js";
+export type { DataModel, DataBinding, FunctionCall, ClientFunction, ResolveContext } from "./data.js";
+export { linkHref, mediaRequestOf, mediaUrlAllowed, openAllowed, ownPrivateHosts, urlPolicyOf } from "./urls.js";
+export { lookupIcon } from "./host-types.js";
+export type { HostPlugin, AnyHostPlugin, IconMap, PaintError, SourceOption, SurfaceActionEvent, SurfaceInputEvent } from "./host-types.js";
+export { str, num, bool, arr, objects, phrase, formatFileSize, acceptsFile, failingChecks, failingCheck, builtinIconName, joinIds } from "./coerce.js";
+export { sortRows } from "./table.js";
+export type { TableColumn, TableSort } from "./table.js";
+export { isoDate, parseIsoDate, addDays, addMonths, sameDay, monthGrid, calendarStop } from "./dates.js";
+export { DEBOUNCE_MS, HostOwnedController, parseLocaleNumber } from "./inputs.js";
+export type { HostOwnedControllerOptions, HostOwnedSend } from "./inputs.js";
+export { MEDIA_CACHE_IDLE_MAX, acquireMedia, releaseMedia, mediaCacheKey, mediaCacheStats, clearMediaCache, openMediaSource, streamEntry, fetchStream, fetchLimited } from "./media.js";
+export type { MediaKind, MediaCacheEntry, MediaSourcePlan } from "./media.js";
+export { MAX_LINK_NESTING, MAX_LINK_DEST, MAX_BLOCK_NESTING, LIST_ITEM, linkAt, wholeImage, parseInline, parseList, parseMarkdown } from "./markdown.js";
+export type { MarkdownInline, MarkdownBlock, MarkdownList, MarkdownListItem } from "./markdown.js";
+export { FormRegistry, documentOrder, fieldErrorsVisible, validateOnDefault } from "./form.js";
+export type { FormField, FormError, FormCheck } from "./form.js";
+export { scrollParent, listViewport } from "./list.js";
+export type { ListAxis } from "./list.js";
+export { nextEnabledIndex, typeaheadStep, TYPEAHEAD_RESET_MS } from "./listbox.js";
+export type { TypeaheadBuffer } from "./listbox.js";
+export { PLACED, placedPartId } from "./parts.js";
+export { share } from "./share.js";

package/dist/types/src/web/inputs.d.ts

@@ -0,0 +1,55 @@
+export declare const DEBOUNCE_MS = 150;
+export type HostOwnedSend<T> = (value: T, revision: number, kind: `change` | `commit`) => void | Promise<void>;
+export interface HostOwnedControllerOptions<T> {
+    /** The value the host holds when the field mounts. */
+    initial: T;
+    /** Sends an edit; a returned promise acknowledges the revision on settle. */
+    send: HostOwnedSend<T>;
+    /** Optional local write-through (the bound data model path). */
+    writeLocal?: (value: T) => void;
+    debounceMs?: number;
+    /** Called after every change of `value`, `pending` or `focused`. */
+    onChange?: () => void;
+}
+export declare class HostOwnedController<T> {
+    /** The field's value (the last edit, or the last adopted host push). */
+    value: T;
+    /** The newest revision sent or scheduled. */
+    revision: number;
+    /** True while a revision the host has not acknowledged exists. */
+    pending: boolean;
+    focused: boolean;
+    private acked;
+    private timer;
+    private live;
+    private send;
+    private writeLocal?;
+    private debounceMs;
+    private readonly onChange?;
+    constructor(options: HostOwnedControllerOptions<T>);
+    /** The latest callbacks (a re-render may hand new closures). */
+    configure(options: Pick<HostOwnedControllerOptions<T>, `send` | `writeLocal` | `debounceMs`>): void;
+    /** A local edit: bump the revision, write through, debounce a `change`. */
+    edit(next: T): void;
+    /** Flush the debounce and send a `commit`. */
+    commit(): void;
+    focus(): void;
+    /** Blur commits. */
+    blur(): void;
+    /** The host's push: adopted only when idle and fully acknowledged.
+     *  Returns whether it was adopted. */
+    push(external: T): boolean;
+    /** (Re)attach after `dispose` (a remount). */
+    attach(): void;
+    /** Unmount: the pending debounce is dropped, acknowledgements no longer
+     *  notify. */
+    dispose(): void;
+    private clearTimer;
+    private notify;
+    private ack;
+    private dispatch;
+}
+/** A typed number in the surface locale (its group and decimal separators
+ *  AND its digits; ASCII digits are always accepted too) → the number, or
+ *  null. */
+export declare function parseLocaleNumber(text: string, locale: string): number | null;

package/dist/types/src/web/list.d.ts

@@ -0,0 +1,13 @@
+export type ListAxis = `vertical` | `horizontal`;
+/** The nearest ancestor that scrolls on `axis`: overflow auto/scroll AND a
+ *  box shorter than its content (a content-sized `overflow: auto` box is not
+ *  a viewport). Null = the document scrolls (the window). */
+export declare function scrollParent(el: HTMLElement | null, axis?: ListAxis): HTMLElement | null;
+/** Where the list's content starts relative to the viewport's start on the
+ *  axis (the scroll offset in list coordinates) and the viewport length.
+ *  `known` = the scroller already found (null = the window). */
+export declare function listViewport(el: HTMLElement, axis: ListAxis, rtl: boolean, known?: HTMLElement | null): {
+    scroll: number;
+    viewport: number;
+    scroller: HTMLElement | null;
+};

package/dist/types/src/web/listbox.d.ts

@@ -0,0 +1,14 @@
+/** The TYPE-AHEAD buffer resets after this pause (ms). */
+export declare const TYPEAHEAD_RESET_MS = 700;
+/** The next enabled index `delta` steps from `from` (wrapping), or -1. */
+export declare function nextEnabledIndex(count: number, from: number, delta: number, isDisabled?: (index: number) => boolean): number;
+export interface TypeaheadBuffer {
+    text: string;
+    at: number;
+}
+/** One printable key typed: the new buffer and the index it lands on (-1 =
+ *  no label starts with the buffer; the active option stays). */
+export declare function typeaheadStep(buffer: TypeaheadBuffer, key: string, now: number, active: number, count: number, isDisabled: (index: number) => boolean, labelOf: (index: number) => string): {
+    buffer: TypeaheadBuffer;
+    index: number;
+};

package/dist/types/src/web/markdown.d.ts

@@ -0,0 +1,96 @@
+/** Link labels nest at most this deep (×4): a link inside 32 enclosing link
+ *  labels is its text. */
+export declare const MAX_LINK_NESTING = 32;
+/** A link / image destination longer than this (UTF-16 units) is no link. */
+export declare const MAX_LINK_DEST = 8192;
+/** `[label](dest)` / `![alt](dest)` starting at `s[at]` (the `[`): the label
+ *  (brackets balanced), the destination (`<…>` or balanced parentheses, no
+ *  whitespace) and the end index. An optional `"title"` is skipped. */
+export declare function linkAt(s: string, at: number): {
+    label: string;
+    dest: string;
+    end: number;
+} | null;
+/** A paragraph that is exactly one `![alt](src)` → its alt + src (a BLOCK
+ *  image, as every renderer paints it; an image inside running text is its
+ *  alt text). */
+export declare function wholeImage(text: string): {
+    alt: string;
+    src: string;
+} | null;
+/** An inline run's tree: text, code, strong/em (nested), strike, a link
+ *  (raw `dest`, label nested). */
+export type MarkdownInline = string | {
+    type: `code`;
+    text: string;
+} | {
+    type: `strong`;
+    children: MarkdownInline[];
+} | {
+    type: `em`;
+    children: MarkdownInline[];
+} | {
+    type: `del`;
+    text: string;
+} | {
+    type: `link`;
+    dest: string;
+    children: MarkdownInline[];
+};
+export type MarkdownBlock = {
+    type: `paragraph`;
+    children: MarkdownInline[];
+}
+/** A paragraph that is exactly one image. */
+ | {
+    type: `image`;
+    alt: string;
+    src: string;
+} | {
+    type: `codeBlock`;
+    lang?: string;
+    text: string;
+} | {
+    type: `heading`;
+    level: number;
+    children: MarkdownInline[];
+} | {
+    type: `quote`;
+    children: MarkdownBlock[];
+} | {
+    type: `list`;
+    list: MarkdownList;
+} | {
+    type: `table`;
+    align: (`start` | `center` | `end` | undefined)[];
+    head: MarkdownInline[][];
+    rows: MarkdownInline[][][];
+} | {
+    type: `rule`;
+};
+/** One inline run, linear in its length: the link geometry is precomputed
+ *  (LinkScanner), the simple spans come off one global regex that never
+ *  rescans, and link labels recurse at most MAX_LINK_NESTING deep. */
+export declare function parseInline(text: string, depth?: number): MarkdownInline[];
+export declare const LIST_ITEM: RegExp;
+export interface MarkdownListItem {
+    /** The item's raw text (its inline markdown). */
+    text: string;
+    /** `text` parsed. */
+    content: MarkdownInline[];
+    /** A task item: done (`[x]`) or not (`[ ]`). */
+    task?: boolean;
+    children: MarkdownList[];
+}
+export interface MarkdownList {
+    indent: number;
+    ordered: boolean;
+    items: MarkdownListItem[];
+}
+/** Consecutive list item lines → a list tree: an item whose marker is
+ *  indented 2+ columns past its list's nests under the previous item. */
+export declare function parseList(lines: readonly string[]): MarkdownList;
+/** Block quotes and lists nest at most this deep (deeper = text). */
+export declare const MAX_BLOCK_NESTING = 32;
+/** Markdown text → its block tree. */
+export declare function parseMarkdown(text: string): MarkdownBlock[];

package/dist/types/src/web/media.d.ts

@@ -0,0 +1,62 @@
+import type { AnyHostPlugin as HostPlugin } from "./host-types.js";
+/** What a source feeds: an image (the limits hold) or a player stream. */
+export type MediaKind = `image` | `stream`;
+/** How many fetched media nobody shows stay cached (their blob urls live). */
+export declare const MEDIA_CACHE_IDLE_MAX = 64;
+export interface MediaCacheEntry {
+    promise: Promise<string>;
+    /** Set once the fetch resolved. */
+    url?: string;
+    /** Mounted consumers. */
+    refs: number;
+}
+export declare function mediaCacheKey(url: string, headers: Record<string, string>): string;
+export declare function acquireMedia(k: string, load: () => Promise<string>): MediaCacheEntry;
+export declare function releaseMedia(k: string, e: MediaCacheEntry): void;
+/** The cache's size (tests). */
+export declare function mediaCacheStats(): {
+    entries: number;
+    inUse: number;
+};
+/** Drop every idle entry and revoke its url (tests, a host that logs out). */
+export declare function clearMediaCache(): void;
+/** One source, planned: `direct` = the url to use as is (no headers, or
+ *  undefined when the policy denies it), `denied` = the policy refused a
+ *  non-empty src, `key` = the cache identity of a FETCHED source ('' when
+ *  direct), `open()` = start (or join) its load: the url promise and the
+ *  release a consumer calls when it unmounts. */
+export interface MediaSourcePlan {
+    fetched: boolean;
+    key: string;
+    direct: string | undefined;
+    denied: boolean;
+    open: () => {
+        promise: Promise<string>;
+        release: () => void;
+    };
+}
+export declare function openMediaSource(host: HostPlugin, src: string, kind?: MediaKind): MediaSourcePlan;
+/** A host stream url (never cached here, never revoked: the host owns
+ *  it), re-checked against the media policy. */
+export declare function streamEntry(host: HostPlugin, req: {
+    url: string;
+    headers: Record<string, string>;
+}): MediaCacheEntry;
+/** A Video/Audio fetch (no `mediaStreamUrl`): the whole body into a blob
+ *  under `maxBytes` (Content-Length up front, then as it streams) and
+ *  `timeoutMs` for the WHOLE download (VAPP-107); no pixel check. */
+export declare function fetchStream(url: string, headers: Record<string, string>, limits?: {
+    maxBytes: number;
+    timeoutMs: number;
+}): Promise<Blob>;
+/** A fetch under `MEDIA_LIMITS`: the whole request within `timeoutMs`, the
+ *  body (Content-Length up front, then as it streams) within `maxBytes`, an
+ *  image's width × height × frames within `maxPixels` before any decode
+ *  (`mediaImageWithinLimits`: SVG sizes count, an unreadable raster is
+ *  refused; `image = false` skips that check: a stream's bytes are not
+ *  an image). */
+export declare function fetchLimited(url: string, headers: Record<string, string>, limits?: {
+    maxBytes: number;
+    timeoutMs: number;
+    maxPixels: number;
+}, image?: boolean): Promise<Blob>;

package/dist/types/src/web/parts.d.ts

@@ -0,0 +1,4 @@
+export declare const PLACED: Readonly<Record<string, readonly string[]>>;
+/** The painted id of a SINGLE part (`<domId>.<part>`), or null when the
+ *  component does not place it. */
+export declare function placedPartId(component: string, part: string, domId: string): string | null;

package/dist/types/src/web/primitives/alert-dialog.d.ts

@@ -0,0 +1,10 @@
+export declare const ALERT_DIALOG_CLASSES: {
+    readonly overlay: "fixed inset-0 z-50 bg-black/50 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:duration-fast data-[state=closed]:ease-accelerate data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:duration-standard data-[state=open]:ease-decelerate";
+    readonly content: "fixed top-[50%] left-[50%] z-50 grid w-full max-w-[calc(100%-2rem)] translate-x-[-50%] translate-y-[-50%] gap-4 rounded-lg border bg-background p-6 shadow-lg motion-dialog sm:max-w-lg";
+    readonly header: "flex flex-col gap-2 text-center sm:text-left";
+    readonly footer: "flex flex-col-reverse gap-2 sm:flex-row sm:justify-end";
+    readonly title: "text-lg font-semibold";
+    readonly description: "text-sm text-muted-foreground";
+    readonly action: string;
+    readonly cancel: string;
+};

package/dist/types/src/web/primitives/alert.d.ts

@@ -0,0 +1,9 @@
+import { type VariantProps } from "class-variance-authority";
+export declare const alertVariants: (props?: ({
+    variant?: "default" | "destructive" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type AlertVariantProps = VariantProps<typeof alertVariants>;
+export declare const ALERT_CLASSES: {
+    readonly title: "col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight";
+    readonly description: "col-start-2 grid justify-items-start gap-1 text-sm [&_p]:leading-relaxed";
+};

package/dist/types/src/web/primitives/avatar-color.d.ts

@@ -0,0 +1,2 @@
+export declare const AVATAR_HUE_COUNT = 8;
+export declare function avatarHueIndex(userId: string | null | undefined): number;

package/dist/types/src/web/primitives/avatar.d.ts

@@ -0,0 +1,13 @@
+export declare const AVATAR_CLASSES: {
+    readonly root: "relative flex size-8 shrink-0 overflow-hidden rounded-full select-none";
+    readonly image: "aspect-square size-full";
+    readonly fallback: "flex size-full items-center justify-center rounded-full text-sm";
+    /** The fallback without a `userId`: the muted chrome. */
+    readonly fallbackMuted: "bg-muted text-muted-foreground";
+};
+export declare function avatarFallbackHue(userId: string | null | undefined): string | undefined;
+/** The inline colours of a hued fallback. */
+export declare function avatarFallbackColors(hue: string): {
+    backgroundColor: string;
+    color: string;
+};

package/dist/types/src/web/primitives/badge.d.ts

@@ -0,0 +1,10 @@
+export type BadgeTone = `muted` | `primary`;
+export declare const BADGE_CLASSES: {
+    readonly root: "pointer-events-none inline-flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full px-1 text-[10px] leading-none font-semibold tabular-nums";
+    readonly tones: {
+        readonly primary: "bg-primary text-primary-foreground";
+        readonly muted: "bg-muted text-muted-foreground";
+    };
+};
+/** What the badge prints for `count` (zero and below render nothing). */
+export declare function badgeLabel(count: number, max?: number): string;

package/dist/types/src/web/primitives/breadcrumb.d.ts

@@ -0,0 +1,10 @@
+export declare const BREADCRUMB_CLASSES: {
+    readonly list: "flex list-none flex-wrap items-center gap-1.5 text-sm break-words text-muted-foreground sm:gap-2.5";
+    readonly item: "inline-flex items-center gap-1.5";
+    readonly link: "transition-colors hover:text-foreground";
+    readonly page: "font-normal text-foreground";
+    readonly separator: "[&>svg]:size-3.5";
+    readonly ellipsis: "flex size-9 items-center justify-center";
+    readonly ellipsisIcon: "size-4";
+    readonly srOnly: "sr-only";
+};

package/dist/types/src/web/primitives/button.d.ts

@@ -0,0 +1,6 @@
+import { type VariantProps } from "class-variance-authority";
+export declare const buttonVariants: (props?: ({
+    variant?: "link" | "text" | "default" | "secondary" | "outline" | "ghost" | "destructive" | "glass" | null | undefined;
+    size?: "icon" | "default" | "sm" | "lg" | "xs" | "icon-sm" | "icon-xs" | "inline" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type ButtonVariantProps = VariantProps<typeof buttonVariants>;

package/dist/types/src/web/primitives/calendar.d.ts

@@ -0,0 +1,43 @@
+export declare const CALENDAR_CLASSES: {
+    readonly root: string;
+    readonly classNames: {
+        readonly root: "w-fit";
+        readonly months: "relative flex flex-col gap-4 md:flex-row";
+        readonly month: "flex w-full flex-col gap-4";
+        readonly nav: "absolute inset-x-0 top-0 flex w-full items-center justify-between gap-1";
+        readonly button_previous: "size-(--cell-size) p-0 select-none aria-disabled:opacity-50";
+        readonly button_next: "size-(--cell-size) p-0 select-none aria-disabled:opacity-50";
+        readonly month_caption: "flex h-(--cell-size) w-full items-center justify-center px-(--cell-size)";
+        readonly dropdowns: "flex h-(--cell-size) w-full items-center justify-center gap-1.5 text-sm font-medium";
+        readonly dropdown_root: "relative rounded-md border border-input shadow-xs has-focus:border-ring has-focus:ring-[3px] has-focus:ring-ring/50";
+        readonly dropdown: "absolute inset-0 bg-popover opacity-0";
+        readonly caption_label: "font-medium select-none";
+        readonly table: "w-full border-collapse";
+        readonly weekdays: "flex";
+        readonly weekday: "flex-1 rounded-md text-[0.8rem] font-normal text-muted-foreground select-none";
+        readonly week: "mt-2 flex w-full";
+        readonly week_number_header: "w-(--cell-size) select-none";
+        readonly week_number: "text-[0.8rem] text-muted-foreground select-none";
+        readonly day: "group/day relative aspect-square h-full w-full p-0 text-center select-none [&:last-child[data-selected=true]_button]:rounded-r-md";
+        readonly range_start: "rounded-l-md bg-accent";
+        readonly range_middle: "rounded-none";
+        readonly range_end: "rounded-r-md bg-accent";
+        readonly today: "rounded-md bg-accent text-accent-foreground data-[selected=true]:rounded-none";
+        readonly outside: "text-muted-foreground aria-selected:text-muted-foreground";
+        readonly disabled: "text-muted-foreground opacity-50";
+        readonly hidden: "invisible";
+    };
+    /** `caption_label` per `captionLayout`: `label`, else a dropdown. */
+    readonly captionLabel: {
+        readonly label: "text-sm";
+        readonly dropdown: "flex h-8 items-center gap-1 rounded-md pr-1 pl-2 text-sm [&>svg]:size-3.5 [&>svg]:text-muted-foreground";
+    };
+    /** The `day` cell's first-selected corner, with or without week numbers. */
+    readonly dayFirst: {
+        readonly weekNumbers: "[&:nth-child(2)[data-selected=true]_button]:rounded-l-md";
+        readonly plain: "[&:first-child[data-selected=true]_button]:rounded-l-md";
+    };
+    readonly chevron: "size-4";
+    readonly weekNumber: "flex size-(--cell-size) items-center justify-center text-center";
+    readonly dayButton: "flex aspect-square size-auto w-full min-w-(--cell-size) flex-col gap-1 leading-none font-normal group-data-[focused=true]/day:relative group-data-[focused=true]/day:z-10 group-data-[focused=true]/day:border-ring group-data-[focused=true]/day:ring-[3px] group-data-[focused=true]/day:ring-ring/50 data-[range-end=true]:rounded-md data-[range-end=true]:rounded-r-md data-[range-end=true]:bg-primary data-[range-end=true]:text-primary-foreground data-[range-middle=true]:rounded-none data-[range-middle=true]:bg-accent data-[range-middle=true]:text-accent-foreground data-[range-start=true]:rounded-md data-[range-start=true]:rounded-l-md data-[range-start=true]:bg-primary data-[range-start=true]:text-primary-foreground data-[selected-single=true]:bg-primary data-[selected-single=true]:text-primary-foreground dark:hover:text-accent-foreground [&>span]:text-xs [&>span]:opacity-70";
+};

package/dist/types/src/web/primitives/card.d.ts

@@ -0,0 +1,9 @@
+export declare const CARD_CLASSES: {
+    readonly root: "rounded-xl border border-glass-stroke-card bg-glass-card-opaque flex flex-col gap-6 backdrop-blur-md py-6 text-card-foreground shadow-sm";
+    readonly header: "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-2 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6";
+    readonly title: "leading-none font-semibold";
+    readonly description: "text-sm text-muted-foreground";
+    readonly action: "col-start-2 row-span-2 row-start-1 self-start justify-self-end";
+    readonly content: "px-6";
+    readonly footer: "flex items-center px-6 [.border-t]:pt-6";
+};

package/dist/types/src/web/primitives/checkbox.d.ts

@@ -0,0 +1,5 @@
+export declare const CHECKBOX_CLASSES: {
+    readonly root: "peer size-4 shrink-0 rounded-sm border border-glass-stroke-strong bg-glass-row shadow-none transition-shadow outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 data-[state=checked]:border-primary data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground dark:aria-invalid:ring-destructive/40 dark:data-[state=checked]:bg-primary";
+    readonly indicator: "grid place-content-center text-current transition-none";
+    readonly icon: "size-3.5";
+};

package/dist/types/src/web/primitives/choice-tiles.d.ts

@@ -0,0 +1,32 @@
+export interface ChoiceTileOption {
+    value: string;
+    label: string;
+    description?: string | null;
+    /** The picture's url (a relative `/api/attachments/{id}` resolves in the
+     *  app through `renderImage`). */
+    image?: string | null;
+    disabled?: boolean;
+}
+/** `columns` clamped to 1–4 (default 2). */
+export declare function choiceColumns(columns: unknown): number;
+/** The values a comma-joined eUI `value` picks (single: the whole string). */
+export declare function choiceValues(value: unknown, multiple: boolean): string[];
+/** A press on `value`: single picks it; multiple toggles it, the list kept in
+ *  OPTION order (fixtures/interactions-round1.json `choiceTiles`). */
+export declare function choiceToggle(picked: readonly string[], value: string, multiple: boolean, order: readonly string[]): string[];
+export interface TileState {
+    index: number;
+    selected: boolean;
+    disabled: boolean;
+}
+export declare const CHOICE_TILES_CLASSES: {
+    readonly root: "gap-[8px]";
+    readonly tile: "flex min-w-0 cursor-pointer flex-col gap-[4px] rounded-[10px] border-[1px] border-border bg-card p-[8px] text-start outline-none transition-colors hover:bg-secondary focus-visible:border-ring disabled:cursor-not-allowed disabled:opacity-50";
+    readonly tileSelected: "border-[2px] border-primary bg-accent p-[7px] hover:bg-accent";
+    readonly tileInvalid: "border-destructive";
+    readonly picture: "relative flex aspect-[1.6] w-full shrink-0 items-center justify-center overflow-hidden rounded-[6px] bg-muted text-muted-foreground";
+    readonly image: "absolute inset-0 size-full object-cover";
+    readonly placeholder: "size-[20px] opacity-60";
+    readonly label: "min-w-0 text-sm leading-5 font-medium text-foreground";
+    readonly description: "min-w-0 text-xs leading-4 text-muted-foreground";
+};

package/dist/types/src/web/primitives/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function getInitials(value: string): string;

package/dist/types/src/web/primitives/code-block.d.ts

@@ -0,0 +1,24 @@
+import { type VariantProps } from "class-variance-authority";
+export declare const codeBlockVariants: (props?: ({
+    variant?: "default" | "destructive" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type CodeBlockVariantProps = VariantProps<typeof codeBlockVariants>;
+/** The catalog's `codeToken` kinds, painted with the app's code palette
+ *  (`--hljs-*`, the diff view's and the editor's); a destructive block drops
+ *  the colours for its own. */
+export declare const CODE_TOKEN_CLASS: Record<string, string>;
+export declare const codeBlockLineVariants: (props?: ({
+    variant?: "default" | "added" | "removed" | "highlighted" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type CodeBlockLineVariantProps = VariantProps<typeof codeBlockLineVariants>;
+export declare const CODE_BLOCK_CLASSES: {
+    readonly header: "flex min-w-0 shrink-0 items-center gap-2 px-3 pt-3 text-muted-foreground group-data-[size=sm]/code-block:px-2.5 group-data-[size=sm]/code-block:pt-2.5 group-data-[variant=destructive]/code-block:text-destructive *:has-[>[data-slot=code-block-title]]:min-w-0";
+    readonly title: "min-w-0 truncate font-sans text-sm font-medium text-foreground group-data-[size=sm]/code-block:text-xs group-data-[variant=destructive]/code-block:text-destructive [&_svg]:pointer-events-none [&_svg]:inline-block [&_svg]:align-middle [&_svg:not([class*='size-'])]:size-3.5 *:[svg]:me-1.5";
+    readonly actions: "-my-1 ms-auto -me-1 flex shrink-0 items-center gap-1 [[data-slot=code-block]>&]:absolute [[data-slot=code-block]>&]:end-2 [[data-slot=code-block]>&]:top-2 [[data-slot=code-block]>&]:z-10 [[data-slot=code-block]>&]:m-0 [[data-slot=code-block]>&]:opacity-0 [[data-slot=code-block]>&]:transition-opacity [[data-slot=code-block]>&]:group-focus-within/code-block:opacity-100 [[data-slot=code-block]>&]:group-hover/code-block:opacity-100 group-data-[size=sm]/code-block:[[data-slot=code-block]>&]:end-1.5 group-data-[size=sm]/code-block:[[data-slot=code-block]>&]:top-1.5 [[data-slot=code-block]>&]:pointer-coarse:opacity-100 [[data-slot=code-block]>&]:*:[button]:bg-background [[data-slot=code-block]>&]:*:[button]:ring-1 [[data-slot=code-block]>&]:*:[button]:ring-foreground/10";
+    readonly srOnly: "sr-only";
+    readonly content: "min-h-0 min-w-0 scroll-fade-x overflow-auto overscroll-contain px-3 py-3 text-start font-mono leading-relaxed outline-none [--code-block-pad:calc(var(--spacing)*6)] group-has-data-[slot=code-block-footer]/code-block:pb-2 group-has-data-[slot=code-block-header]/code-block:pt-2 group-has-data-[slot=code-block-header]/code-block:[--code-block-pad:calc(var(--spacing)*5)] group-data-[size=sm]/code-block:px-2.5 group-data-[size=sm]/code-block:py-2.5 group-data-[size=sm]/code-block:[--code-block-pad:calc(var(--spacing)*5)] group-data-[size=sm]/code-block:group-has-data-[slot=code-block-header]/code-block:pt-1.5 group-data-[size=sm]/code-block:group-has-data-[slot=code-block-header]/code-block:[--code-block-pad:calc(var(--spacing)*4)] data-wrap:scroll-fade-y data-wrap:wrap-break-word data-wrap:whitespace-pre-wrap";
+    readonly code: "grid min-h-lh min-w-max content-start in-data-numbered:grid-cols-[auto_1fr] in-data-wrap:min-w-0";
+    readonly token: "group-data-[variant=destructive]/code-block:text-current";
+    readonly lineContent: "min-w-0";
+    readonly footer: "flex min-w-0 shrink-0 items-center gap-2 px-3 pb-3 text-muted-foreground group-data-[size=sm]/code-block:px-2.5 group-data-[size=sm]/code-block:pb-2.5";
+};