@artooi/agents-web-components 0.0.0-stage → 0.1.0

package/dist/ui/transcript/suggestion_chips.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion_chips.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/suggestion_chips.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAcnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAC/B,WAAW,GAAG,IAAI,CAuBpB"}

package/dist/ui/transcript/transcript.d.ts

@@ -0,0 +1,196 @@
+import { type ToolGroupDisplayMode } from "../../constants.js";
+import type { AgUiToolCall } from "../../core/agui_client.js";
+import type { MessageRole } from "../../core/message_role.js";
+import type { ChartRenderer, ClientTool } from "../../tools/client_tool_registry.js";
+import { ThoughtsBlock } from "../progress/thoughts_block.js";
+import { ToolCallCard, type ToolDisplayMode, type ToolPayload } from "../progress/tool_call_card.js";
+import type { UiStrings } from "../ui_strings.js";
+/** What the transcript needs from the element that owns it. */
+export interface TranscriptHost {
+    /** The custom element: its text-animation attribute, and the `data-empty` stamp. */
+    readonly element: HTMLElement;
+    /** The scrolling message list. */
+    readonly messages: HTMLDivElement;
+    /** The empty-state region at the top of the list. */
+    readonly emptyWrap: HTMLDivElement;
+    /** The resolved string table. */
+    readonly strings: () => UiStrings;
+    /** The element's `allowImages`, read per render. */
+    readonly allowImages: () => boolean;
+    /** Resolve a frontend tool by name, for its `x-summary`. */
+    readonly resolveTool: (name: string) => ClientTool | null;
+    /** The element's `toolSummaries`, read per card. */
+    readonly toolSummaries: () => Record<string, string>;
+    /** The server catalog's label for a tool, if it sent one. */
+    readonly serverSummary: (name: string) => string | undefined;
+    /** The element's `formatToolPayload`, asked per region of a card. */
+    readonly formatToolPayload: (payload: ToolPayload) => Node | string | null;
+    /** The element's `toolDisplay`, read per card: it decides whether calls fold into a step group. */
+    readonly toolDisplay: () => ToolDisplayMode;
+    /** The element's `toolGroupDisplay`, read per row: it decides what a lone step offers. */
+    readonly toolGroupDisplay: () => ToolGroupDisplayMode;
+}
+/**
+ * The transcript: the bubbles, the open answer group, the pending dots, the
+ * reasoning region, the tool cards by call id, and the scroller that follows
+ * the foot.
+ *
+ * The hub most other parts of the element draw into, so it holds only the
+ * transcript's own state and asks the element for nothing but configuration.
+ *
+ * Owned one-to-one by an `<ag-ui-chat>`, and holding no state outside the
+ * instance.
+ */
+export declare class Transcript {
+    #private;
+    constructor(host: TranscriptHost);
+    /**
+     * Start following the foot of the list, and wire the jump button to it.
+     * Called while rendering rather than at construction: the viewport has to
+     * exist and the observer has to have something to observe. The button
+     * outlives a connection, so its listener goes under `signal`.
+     */
+    mountScroller(jumpButton: HTMLButtonElement, signal: AbortSignal): void;
+    /** Stop following, when the element leaves the document. */
+    disposeScroller(): void;
+    /** Keep the list at its foot, if the reader is there. */
+    follow(): void;
+    /** Go to the foot, whether or not the reader had scrolled away. */
+    jump(): void;
+    /** Whether the empty-state region is showing, which is when nothing else is. */
+    isEmpty(): boolean;
+    /** The card drawn for a call id, while it is still awaiting execution. */
+    card(callId: string): ToolCallCard | undefined;
+    /** Every card still awaiting execution. */
+    cards(): IterableIterator<ToolCallCard>;
+    /** Stop tracking a call's card as awaiting execution. */
+    forgetCard(callId: string): void;
+    /** Remember the element a call's card is, for a renderer to place itself against. */
+    setCardElement(callId: string, element: HTMLElement): void;
+    /** Record that a call's card was settled from a streamed server-side result. */
+    markServerSettled(callId: string): void;
+    /** Whether a call's card was settled from a streamed server-side result. */
+    isServerSettled(callId: string): boolean;
+    /** Fold the reasoning region away, once the answer has begun. */
+    collapseThoughts(): void;
+    /**
+     * Stop the reasoning region's clock and settle its header, when reasoning
+     * ends or whatever replaces its end arrives first. A no-op without one.
+     */
+    settleThoughts(): void;
+    /**
+     * Close the turn's answer group. Drop it if the turn rendered nothing
+     * (e.g. a server-only round that streamed no text/card) so an opted-in
+     * well leaves no empty box behind.
+     */
+    closeGroup(): void;
+    /**
+     * Let go of the open turn: its group, its reasoning region, its pending dots
+     * and the cards awaiting execution. The first half of wiping the transcript.
+     */
+    releaseTurn(): void;
+    /** Forget which cards settled from the server and where each card is. */
+    forgetCards(): void;
+    /** Remember the card of a call being run, for {@link setAsking}. */
+    holdRunning(callId: string, card: ToolCallCard): void;
+    /**
+     * Say whether a prompt is open on the card of a running call. A call id of
+     * none, or one no card was held for, has no card to say it on.
+     */
+    setAsking(callId: string | undefined, asking: boolean): void;
+    /** Empty the list back to its empty-state region. The last half of wiping it. */
+    empty(): void;
+    /** The bubble behind `AgUiChat.appendMessage`, whose doc is the contract. */
+    append(role: MessageRole, content: string): HTMLDivElement;
+    /**
+     * The open answer group, creating and appending it on first use. Everything a
+     * single assistant turn renders (text, tool cards, the pending indicator)
+     * goes inside it, so the opt-in `data-answer-well` styling can box the whole
+     * turn. Idempotent across the turn's runs — it persists until the run's
+     * settle closes it, see {@link closeGroup}.
+     */
+    ensureGroup(): HTMLDivElement;
+    /**
+     * Word-by-word reveal for the `word` text-animation mode, applied to a
+     * completed assistant bubble. `fade` is pure CSS (no JS); `none` is a no-op.
+     */
+    revealWords(bubble: HTMLDivElement): void;
+    /**
+     * Hide the empty-state region once the message list holds anything else, and
+     * say so on the host as `data-empty`.
+     *
+     * Stamped on the host because the layout has to answer it: where the
+     * composer sits is decided outside the list this region lives in, and no
+     * selector reaches from inside the list back up to the list's siblings. It is
+     * also a documented styling hook for a host's own chrome around a full-page
+     * chat.
+     */
+    updateEmptyState(): void;
+    /** A muted "⏹ Stopped" line in the transcript (distinct from the ⚠️ error bubble). */
+    appendStoppedNote(): void;
+    /**
+     * Show a "thinking" indicator while the agent is being awaited — both the
+     * silent stretch before the first token and the gap after a tool result
+     * while the next round is requested. Idempotent.
+     */
+    showPending(): void;
+    /** Remove the pending indicator if shown. */
+    hidePending(): void;
+    /**
+     * The current turn's thoughts region, creating it (at the top of the answer
+     * group, above any streamed text or tool cards) on first sight. Idempotent
+     * across a turn's reasoning tokens.
+     */
+    showThoughts(): ThoughtsBlock;
+    /**
+     * Render a skill notice for a `load_capability` call; ``true`` when handled.
+     *
+     * Shared by the live stream and history replay so the transcript looks the
+     * same before and after a reload.
+     */
+    noticeIfSkillLoad(call: AgUiToolCall): boolean;
+    /**
+     * An inline notice about something the run did.
+     *
+     * Goes through {@link ensureGroup} like a tool card so it lands *inside* the
+     * assistant turn it annotates rather than floating between turns, and does
+     * the same empty-state and scroll bookkeeping afterwards.
+     *
+     * `undo` is offered only where the agent rearranged the user's own window --
+     * see {@link renderRunNotice} for why a notice may carry that one control and
+     * nothing else.
+     */
+    appendNotice(icon: string, text: string, kind: string, undo?: {
+        readonly label: string;
+        readonly onActivate: () => void;
+    }): void;
+    /**
+     * Place a tool's rendered node against its own card.
+     *
+     * Anchored rather than appended because a client tool's handler does not run
+     * until the round is over: appending would put the node after everything the
+     * model said next, visibly detached from the call that produced it, and in a
+     * different order than the same transcript takes on reload. The card was
+     * created inline, in the right place, so anchoring makes *when* the handler
+     * runs stop mattering.
+     */
+    renderToolOutput(render: ChartRenderer, call: AgUiToolCall): void;
+    /** Update the empty state and follow the foot, after the transcript grew. */
+    afterGrew(): void;
+    /**
+     * The card for ``call``, creating and appending it on first sight.
+     *
+     * The run's tool-call handler creates the card (pending) during the run; the
+     * tool's execution later retrieves the same card to settle it.
+     */
+    cardFor(call: AgUiToolCall): ToolCallCard;
+    /** Redraw every step group's row, for a change of the inner display, which no card announces. */
+    refreshStepGroups(): void;
+    /**
+     * Open the step group ``card`` sits in, at once, ahead of a prompt about to be
+     * drawn inside it. A no-op for a card drawn in a card display mode, which has
+     * no group.
+     */
+    revealStep(card: ToolCallCard): void;
+}
+//# sourceMappingURL=transcript.d.ts.map

package/dist/ui/transcript/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/transcript.ts"],"names":[],"mappings":"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"}

package/dist/ui/transcript/transcript_styles.d.ts

@@ -0,0 +1,2 @@
+export declare const TRANSCRIPT_STYLES: string;
+//# sourceMappingURL=transcript_styles.d.ts.map

package/dist/ui/transcript/transcript_styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript_styles.d.ts","sourceRoot":"","sources":["../../../src/ui/transcript/transcript_styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,EAAE,MAsJ/B,CAAC"}

package/dist/ui/ui_strings.d.ts

@@ -0,0 +1,352 @@
+/**
+ * The flat table of every user-facing string the chat shell renders — labels,
+ * placeholders, `aria-label`s, and `title` tooltips. A localizable seam, not a
+ * framework: a host overrides any subset (via the element's `strings` property
+ * or its `data-strings` JSON attribute) and the rest fall back to the English
+ * defaults.
+ *
+ * Some values are templates carrying `{token}` placeholders the call site fills
+ * in; the token names are noted on each key, and a translation must keep them
+ * verbatim.
+ */
+export interface UiStrings {
+    /** Default header title (the `title-text` attribute overrides per element). */
+    title: string;
+    /** History button + drawer dialog label. */
+    chatHistory: string;
+    /** Dismiss the chat-history list and return to the conversation. */
+    closeHistory: string;
+    /** Placeholder in the conversation-list filter. */
+    searchConversations: string;
+    /** Names the row of messages waiting for the run to finish. */
+    queued: string;
+    /** Drops one waiting message. `{text}` is the message. */
+    removeQueued: string;
+    /** Shown when a filter matches nothing, unlike having no conversations. */
+    noMatches: string;
+    /** Heading over the conversations last active today. */
+    threadsToday: string;
+    /** Heading over the conversations last active in the seven days before today. */
+    threadsPreviousWeek: string;
+    /** Heading over every older conversation, and any with no readable date. */
+    threadsOlder: string;
+    /** Notice text when the agent moved its own panel out of the way. */
+    chatMoved: string;
+    /** Notice text when the agent collapsed its own panel. */
+    chatMinimised: string;
+    /** The one control a run notice may carry. */
+    undo: string;
+    /** New-chat button (header + drawer). */
+    newChat: string;
+    /** Collapse button. */
+    collapse: string;
+    /** Expand affordance (the launcher, and the sidebar rail). */
+    expand: string;
+    /** Header control that grows the open panel; apart from {@link expand}, which opens it. */
+    maximize: string;
+    /** The same control while the panel is maximized. */
+    restore: string;
+    /**
+     * The launcher's label while unread answers wait behind it. Token: `{count}`.
+     * Replaces {@link expand} rather than appending to it, so a translation can
+     * order the two parts as its language needs.
+     */
+    expandUnread: string;
+    /** Built-in header theme toggle (light ⇄ dark). */
+    toggleTheme: string;
+    /**
+     * The greeting over an empty conversation under `placement="page"` (or an
+     * `embedded` panel that opted in). Token: `{name}`, the `user-name` attribute.
+     */
+    greeting: string;
+    /** The same greeting when the host named nobody: no `user-name`, or a blank one. */
+    greetingNoName: string;
+    /** `aria-label` of the scrolling message log. */
+    conversation: string;
+    /** The button offering to return to the foot of the transcript. */
+    jumpToLatest: string;
+    /** Announced when a turn starts. Screen-reader only; never rendered. */
+    announceResponding: string;
+    /** Announced when the answer has finished arriving. Screen-reader only. */
+    announceAnswerReady: string;
+    /** Announced when a card is waiting for the user's decision. Token: `{count}`. */
+    announceAwaitingDecision: string;
+    /** Announced when the user stopped the run. Screen-reader only. */
+    announceStopped: string;
+    /** Announced when the run failed. Screen-reader only. */
+    announceFailed: string;
+    /** `aria-label` of the "thinking" pending indicator, and the thoughts region's
+     * header while the model is still reasoning. */
+    thinking: string;
+    /** The thoughts region's header once reasoning has ended, and its fallback
+     * when the reasoning took under a second, too short to time. */
+    thoughts: string;
+    /** The thoughts region's header once reasoning has ended, naming how long it
+     * took in whole seconds. Token: `{seconds}`. */
+    thoughtFor: string;
+    /** The muted note after a cancelled run. */
+    stopped: string;
+    /** Error shown when the stream drops without a terminal AG-UI event. */
+    connectionLost: string;
+    /**
+     * Tool-result content (and card text) for a call that never produced a result
+     * and that nobody refused: the run was stopped or failed first, the page
+     * reloaded, or no tool here answered it. Sent to the agent, so it must not say
+     * a person declined.
+     */
+    callNotFinished: string;
+    /** Tool-result content when the user declines a confirmed action. */
+    declinedAction: string;
+    /** Tool-result content (and card text) when `confirmPredicate` threw, so the call was refused. */
+    confirmCheckFailed: string;
+    /** A navigating tool's card text while the page reloads. */
+    navigating: string;
+    /** Notice shown when the server replaced the conversation wholesale. */
+    historyReplaced: string;
+    /** Notice shown when a pushed chart could not be drawn and was removed. */
+    chartUndrawable: string;
+    /** Missing-placeholder skill hint. Tokens: `{title}`, `{fields}`. */
+    skillNeeds: string;
+    /** Notice shown when the agent condensed earlier turns. Token: `{count}`. */
+    historyCompacted: string;
+    /** Notice shown when the agent loads an agent skill. Token: `{name}`. */
+    usingSkill: string;
+    /** Notice shown on mount when the previous run never produced a response. */
+    runInterrupted: string;
+    /** Tool-result content (and card text) when the page moved mid-run. */
+    pageMoved: string;
+    /** Notice when Send ran while a file was still uploading. Token: `{n}`. */
+    attachmentsStillUploading: string;
+    /** Notice shown when a message was typed at an element with no `endpoint`. */
+    notConnected: string;
+    /** Composer hint when a run continuation was picked with an empty composer. */
+    continueNeedsTurn: string;
+    /** Composer hint when a run continuation was picked while a run is in flight. */
+    continueWhileRunning: string;
+    /**
+     * Composer hint when a run continuation was picked while the stored
+     * conversation is still loading.
+     */
+    continueWhileLoading: string;
+    /** `aria-label` of the message textarea. */
+    message: string;
+    /** Placeholder of the message textarea. */
+    inputPlaceholder: string;
+    /** Send button (idle composer). */
+    send: string;
+    /** Stop button (composer while a run is in flight). */
+    stop: string;
+    /** Attach-files button. */
+    attachFiles: string;
+    /** Mic button while idle (start recording). */
+    recordVoice: string;
+    /** Mic button while recording (stop + transcribe). */
+    stopRecording: string;
+    /** Mic button while the clip is being transcribed. */
+    transcribing: string;
+    /** Mic button fallback message when transcription fails. */
+    transcriptionFailed: string;
+    /**
+     * Mic button message after a recording hit its length cap and stopped itself.
+     * The clip is kept and transcribed, so this explains the silence rather than
+     * reporting a loss. Token: `{n}` (the cap, in minutes).
+     */
+    recordingLimit: string;
+    /** The place chip's tooltip while the place is sent. Token: `{label}`. */
+    placeShared: string;
+    /** The place chip's tooltip while the user withholds it. Token: `{label}`. */
+    placeWithheld: string;
+    /** The place toggle while the place is sent: pressing it withholds it. */
+    placeStopSharing: string;
+    /** The place toggle while the place is withheld: pressing it sends it again. */
+    placeShareAgain: string;
+    /** Status pill while the call runs. */
+    toolRunning: string;
+    /** Status pill on a gated call the run deferred, waiting on a person. */
+    toolDeferred: string;
+    /** Status pill on success. */
+    toolDone: string;
+    /** Status pill on error. */
+    toolError: string;
+    /** Status pill on a declined call. */
+    toolDeclined: string;
+    /** Status pill on a call that ended without a result nobody refused. */
+    toolInterrupted: string;
+    /** Accessible label on the panel resize handle. */
+    resizePanel: string;
+    /** Note on a tool card whose call a human approved. */
+    decisionApproved: string;
+    /** Note on a tool card whose call a human declined. */
+    decisionDeclined: string;
+    /** Heading over a tool card's arguments region. */
+    argumentsLabel: string;
+    /** Heading over a tool card's result region when the call succeeded. */
+    resultLabel: string;
+    /** Heading over a tool card's result region when the call failed. */
+    errorLabel: string;
+    /** Heading over a tool card's result region when the call was declined. */
+    declinedLabel: string;
+    /** Heading over a tool card's result region when the call did not finish. */
+    interruptedLabel: string;
+    /** Label on the toggle that expands a tool card's body. */
+    details: string;
+    /** The group's label while a step waits on the user. Token: `{count}` (steps). */
+    toolGroupSteps: string;
+    /** The group's label while a step runs. Token: `{count}` (steps). */
+    toolGroupWorking: string;
+    /** The group's label once every step has settled. Token: `{count}` (steps). */
+    toolGroupWorked: string;
+    /** Note on the group's row: steps waiting on the user. Token: `{count}`. */
+    toolGroupWaiting: string;
+    /** Note on the group's row: steps that failed. Token: `{count}`. */
+    toolGroupFailed: string;
+    /** Note on the group's row: steps that were declined. Token: `{count}`. */
+    toolGroupDeclined: string;
+    /**
+     * Set after a step's label when an earlier step in its group has the same
+     * one, so two "Fill field" steps read "Fill field" and "Fill field (2)".
+     * Grouped mode only. Token: `{n}` (which occurrence, from 2).
+     */
+    toolStepRepeat: string;
+    /**
+     * The delegation row's text before the server's own status line lands.
+     *
+     * A fallback, not a state: every announcement carries a pre-rendered `status`,
+     * and this only shows if one arrives unusable. The row is the expander, so it
+     * must never be blank.
+     */
+    subAgentWorking: string;
+    /**
+     * The row's line while a delegation is running. Token: `{agent}`.
+     *
+     * Worded here rather than on the wire, unlike the two step phases. The
+     * protocol's `SUBAGENT_STARTED` carries the sub-agent's `name` and no rendered
+     * status -- which is the better shape for a localised UI, and the reason this
+     * string exists at all.
+     */
+    subAgentDelegatedTo: string;
+    /** The row's line once a delegation completed. Token: `{agent}`. */
+    subAgentFinished: string;
+    /**
+     * The row's line for a delegation that failed and named no agent.
+     *
+     * A fallback only: `SUBAGENT_ERROR` carries a required `message`, which the
+     * server fills with the sub-agent's name and nothing else, and that text is
+     * what the row shows. This covers a server that sent an empty one.
+     */
+    subAgentFailed: string;
+    /** `aria-label` of the region holding the sub-agent's own tool calls. */
+    subAgentSteps: string;
+    /** `aria-label` of the editable arguments field on an approval card. */
+    approvalEditArgs: string;
+    /** Shown when the edited arguments are not valid JSON. */
+    approvalArgsInvalid: string;
+    /** Shown when the edited arguments parse but are not a JSON object. */
+    approvalArgsNotAnObject: string;
+    /** `aria-label` of the follow-up suggestion chips row. */
+    suggestions: string;
+    /** `aria-label` of a message's action row. */
+    messageActions: string;
+    /** The offer that floats beside a selection in the transcript. */
+    quoteSelection: string;
+    /** Copy this message (button `title` / `aria-label`). Its confirmation and
+     * failure text are the code block's `copied` / `copyFailed`, which say the
+     * same thing about the same clipboard. */
+    copyMessage: string;
+    /** Ask for a different answer to the same question. */
+    retryMessage: string;
+    /** Rate this answer as good. */
+    feedbackUp: string;
+    /** Rate this answer as poor. */
+    feedbackDown: string;
+    /** `aria-label` of the inline confirmation card. */
+    confirmAction: string;
+    /** Waive confirmation for this tool for the rest of the session. Token: `{tool}`. */
+    confirmAlways: string;
+    /** Generic confirmation prompt when a tool has no `x-confirm`. Token: `{tool}`. */
+    confirmRun: string;
+    /** Confirm button. */
+    confirm: string;
+    /** Cancel button (confirmation + delete confirm). */
+    cancel: string;
+    /** `aria-label` of the inline server-side-tool approval card. */
+    approveAction: string;
+    /** Fallback approval prompt when the interrupt carries no message. */
+    approvalPrompt: string;
+    /** Approve button (runs the gated server-side tool). */
+    approve: string;
+    /** Deny button (declines the gated server-side tool). */
+    deny: string;
+    /** `aria-label` of the inline question card. */
+    askUserAction: string;
+    /** Radio label for the free-text "other" choice (when custom answers are allowed). */
+    otherOption: string;
+    /** Placeholder for the free-text answer field. */
+    answerPlaceholder: string;
+    /** Submit button for the question card. */
+    submit: string;
+    /** Drawer heading. */
+    chats: string;
+    /** Empty-state line when there are no threads. */
+    noConversations: string;
+    /** Rename row button (`title`). */
+    rename: string;
+    /** Rename row button `aria-label`. */
+    renameConversation: string;
+    /** Delete row button (`title`) + the inline-confirm action. */
+    delete: string;
+    /** Delete row button `aria-label`. */
+    deleteConversation: string;
+    /** Inline delete-confirm prompt. */
+    deletePrompt: string;
+    /** Oversize rejection. Token: `{size}`. */
+    tooLarge: string;
+    /** Disallowed-type rejection. */
+    fileTypeNotAllowed: string;
+    /** Generic upload failure (when the error carries no message). */
+    uploadFailed: string;
+    /** Retry-upload button (`title`). */
+    retry: string;
+    /** Retry-upload button `aria-label`. */
+    retryUpload: string;
+    /** Remove-attachment button (`title`). */
+    remove: string;
+    /** Remove-attachment button `aria-label`. */
+    removeAttachment: string;
+    /** Label on a code block's copy button. */
+    copyCode: string;
+    /** Shown on the copy button after the code reached the clipboard. */
+    copied: string;
+    /** Shown when the clipboard was unavailable or refused the write. */
+    copyFailed: string;
+    /** Title of the checkpoint panel. */
+    checkpoints: string;
+    /** Empty state when no run can be continued. */
+    noCheckpoints: string;
+    /** Action: continue a run from its last checkpoint. */
+    resumeRun: string;
+    /** Action: branch a run without touching the original. */
+    forkRun: string;
+    /** Badge on a run that branched from another. */
+    forkedRun: string;
+    /** Under a minute ago. */
+    justNow: string;
+    /** Minutes ago. Token: `{n}`. */
+    minutesAgo: string;
+    /** Hours ago. Token: `{n}`. */
+    hoursAgo: string;
+    /** Days ago. Token: `{n}`. */
+    daysAgo: string;
+    /** Weeks ago. Token: `{n}`. */
+    weeksAgo: string;
+}
+/** The built-in English strings — the fallback every override merges over. */
+export declare const DEFAULT_UI_STRINGS: UiStrings;
+/**
+ * Merge a partial set of overrides over {@link DEFAULT_UI_STRINGS}, yielding a
+ * complete {@link UiStrings}. Keys whose override is `undefined` keep the
+ * default (so a `data-strings` JSON with only a few keys — or a property carrying
+ * explicit `undefined` — leaves the rest English).
+ */
+export declare function mergeUiStrings(overrides: Partial<UiStrings>): UiStrings;
+//# sourceMappingURL=ui_strings.d.ts.map

package/dist/ui/ui_strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui_strings.d.ts","sourceRoot":"","sources":["../../src/ui/ui_strings.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,EAAE,MAAgB,CAAC"}