pith-ui 0.0.0-stage → 0.1.0

package/API.md

@@ -0,0 +1,3281 @@
+# Public API reference
+
+Generated for `pith-ui@0.1.0` by `node scripts/api-docs.ts` from TypeScript declaration emit. Do not edit this file by hand. The installed public declarations are authoritative; this reference reproduces every public declaration, including all 73 create/install/mount factories and their state, options, callback and handle types.
+
+Use the [catalog](https://github.com/minifish-org/pith-ui/blob/main/docs/catalog.md) to choose a complete block first, then inspect its exact signature and linked types here. Gallery links are related experiences; adapter APIs may point to their preferred replacement. Source links point to the implementation, not a second usage contract.
+
+Types such as `HTMLElement`, `Node`, `Event`, `Promise` and TypeScript utility types are standard platform types. Named Pith UI references below link to their exact public definitions. Node slots require trusted DOM nodes; there is no arbitrary-HTML extension interface. See [AI.md](./AI.md) for lifecycle, host boundaries and composition rules.
+
+Regenerate: `node scripts/api-docs.ts`. Verify without writing: `node scripts/api-docs.ts --check`.
+
+## Factory index
+
+| Factory | Related gallery |
+|---|---|
+| [`createActions`](#createactions) | [actions](https://minifish-org.github.io/pith-ui/?item=actions) |
+| [`createApprovalPanel`](#createapprovalpanel) | [approval-panel](https://minifish-org.github.io/pith-ui/?item=approval-panel) |
+| [`createArtifactPanel`](#createartifactpanel) | [artifact-panel](https://minifish-org.github.io/pith-ui/?item=artifact-panel) |
+| [`createAttachments`](#createattachments) | [attachments](https://minifish-org.github.io/pith-ui/?item=attachments) |
+| [`createBranchHistory`](#createbranchhistory) | [branch-history](https://minifish-org.github.io/pith-ui/?item=branch-history) |
+| [`createButton`](#createbutton) | [actions](https://minifish-org.github.io/pith-ui/?item=actions), [button](https://minifish-org.github.io/pith-ui/?item=button), [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar) |
+| [`createCheckbox`](#createcheckbox) | [checkbox](https://minifish-org.github.io/pith-ui/?item=checkbox), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion) |
+| [`createCollectionState`](#createcollectionstate) | [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state) |
+| [`createCompletionNotices`](#createcompletionnotices) | [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices) |
+| [`createComposerView`](#createcomposerview) | [composer](https://minifish-org.github.io/pith-ui/?item=composer), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback) |
+| [`createConfirmDialog`](#createconfirmdialog) | [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation) |
+| [`createContextMenu`](#createcontextmenu) | [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu) |
+| [`createConversationView`](#createconversationview) | [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion) |
+| [`createCopyFeedback`](#createcopyfeedback) | [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback) |
+| [`createCostLedger`](#createcostledger) | [cost-ledger](https://minifish-org.github.io/pith-ui/?item=cost-ledger) |
+| [`createCustomConnectionEditor`](#createcustomconnectioneditor) | [custom-connection](https://minifish-org.github.io/pith-ui/?item=custom-connection) |
+| [`createCustomModelRow`](#createcustommodelrow) | [custom-connection](https://minifish-org.github.io/pith-ui/?item=custom-connection), [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel) |
+| [`createDialog`](#createdialog) | [dialog](https://minifish-org.github.io/pith-ui/?item=dialog) |
+| [`createDisclosure`](#createdisclosure) | [disclosure](https://minifish-org.github.io/pith-ui/?item=disclosure) |
+| [`createDivider`](#createdivider) | [divider](https://minifish-org.github.io/pith-ui/?item=divider) |
+| [`createDropFeedback`](#createdropfeedback) | [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback) |
+| [`createFeatureDialogFrame`](#createfeaturedialogframe) | [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog) |
+| [`createFeatureStatus`](#createfeaturestatus) | [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog) |
+| [`createField`](#createfield) | [number-input](https://minifish-org.github.io/pith-ui/?item=number-input), [search-input](https://minifish-org.github.io/pith-ui/?item=search-input), [secret-input](https://minifish-org.github.io/pith-ui/?item=secret-input), [text-area](https://minifish-org.github.io/pith-ui/?item=text-area), [text-input](https://minifish-org.github.io/pith-ui/?item=text-input) |
+| [`createFileActions`](#createfileactions) | [file-actions](https://minifish-org.github.io/pith-ui/?item=file-actions) |
+| [`createFilePreview`](#createfilepreview) | [file-preview](https://minifish-org.github.io/pith-ui/?item=file-preview) |
+| [`createFormSection`](#createformsection) | [form-section](https://minifish-org.github.io/pith-ui/?item=form-section) |
+| [`createFullAccessConfirmation`](#createfullaccessconfirmation) | [full-access-confirmation](https://minifish-org.github.io/pith-ui/?item=full-access-confirmation) |
+| [`createIcon`](#createicon) | [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [icons](https://minifish-org.github.io/pith-ui/?item=icons) |
+| [`createIconButton`](#createiconbutton) | [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar) |
+| [`createImageViewer`](#createimageviewer) | [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer) |
+| [`createKeyValue`](#createkeyvalue) | [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [key-value](https://minifish-org.github.io/pith-ui/?item=key-value) |
+| [`createListRow`](#createlistrow) | [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row) |
+| [`createMCPConnectionList`](#createmcpconnectionlist) | [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections) |
+| [`createMCPConnectionsPanel`](#createmcpconnectionspanel) | [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections) |
+| [`createMenu`](#createmenu) | [menu](https://minifish-org.github.io/pith-ui/?item=menu) |
+| [`createModelEditor`](#createmodeleditor) | [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker) |
+| [`createModelPicker`](#createmodelpicker) | [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker) |
+| [`createNotice`](#createnotice) | [notice](https://minifish-org.github.io/pith-ui/?item=notice) |
+| [`createNumberInput`](#createnumberinput) | [number-input](https://minifish-org.github.io/pith-ui/?item=number-input) |
+| [`createPagedPreview`](#createpagedpreview) | [markdown-content](https://minifish-org.github.io/pith-ui/?item=markdown-content), [paged-preview](https://minifish-org.github.io/pith-ui/?item=paged-preview) |
+| [`createPendingMessages`](#creatependingmessages) | [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages) |
+| [`createPermissionControl`](#createpermissioncontrol) | [permission-control](https://minifish-org.github.io/pith-ui/?item=permission-control) |
+| [`createPopover`](#createpopover) | [popover](https://minifish-org.github.io/pith-ui/?item=popover) |
+| [`createProgress`](#createprogress) | [progress](https://minifish-org.github.io/pith-ui/?item=progress) |
+| [`createProviderActions`](#createprovideractions) | [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions) |
+| [`createProviderLoginPanel`](#createproviderloginpanel) | [provider-login](https://minifish-org.github.io/pith-ui/?item=provider-login) |
+| [`createRenameConversation`](#createrenameconversation) | [rename-conversation](https://minifish-org.github.io/pith-ui/?item=rename-conversation) |
+| [`createResourceActions`](#createresourceactions) | [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel) |
+| [`createResourceEditor`](#createresourceeditor) | [resource-editor](https://minifish-org.github.io/pith-ui/?item=resource-editor) |
+| [`createResourcesPanel`](#createresourcespanel) | [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel) |
+| [`createRuntimePanel`](#createruntimepanel) | [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel) |
+| [`createSDKDialogElements`](#createsdkdialogelements) | [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog) |
+| [`createScrollArea`](#createscrollarea) | [scroll-area](https://minifish-org.github.io/pith-ui/?item=scroll-area) |
+| [`createSearchInput`](#createsearchinput) | [search-input](https://minifish-org.github.io/pith-ui/?item=search-input) |
+| [`createSecretInput`](#createsecretinput) | [secret-input](https://minifish-org.github.io/pith-ui/?item=secret-input) |
+| [`createSelect`](#createselect) | [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [select](https://minifish-org.github.io/pith-ui/?item=select) |
+| [`createSettingsPanel`](#createsettingspanel) | [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel) |
+| [`createStatus`](#createstatus) | [status](https://minifish-org.github.io/pith-ui/?item=status) |
+| [`createTaskFailure`](#createtaskfailure) | [task-failure](https://minifish-org.github.io/pith-ui/?item=task-failure) |
+| [`createTextAction`](#createtextaction) | [text-action](https://minifish-org.github.io/pith-ui/?item=text-action) |
+| [`createTextArea`](#createtextarea) | [foundation-typography](https://minifish-org.github.io/pith-ui/?item=foundation-typography), [text-area](https://minifish-org.github.io/pith-ui/?item=text-area) |
+| [`createTextEditDialog`](#createtexteditdialog) | [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog) |
+| [`createTextInput`](#createtextinput) | [form-section](https://minifish-org.github.io/pith-ui/?item=form-section), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [popover](https://minifish-org.github.io/pith-ui/?item=popover), [text-input](https://minifish-org.github.io/pith-ui/?item=text-input) |
+| [`createToolbar`](#createtoolbar) | [button](https://minifish-org.github.io/pith-ui/?item=button), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [icons](https://minifish-org.github.io/pith-ui/?item=icons), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar) |
+| [`createUpdatePanel`](#createupdatepanel) | [updates](https://minifish-org.github.io/pith-ui/?item=updates) |
+| [`createWelcomeView`](#createwelcomeview) | [welcome](https://minifish-org.github.io/pith-ui/?item=welcome) |
+| [`createWorkspaceNavigation`](#createworkspacenavigation) | [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation) |
+| [`createWorkspacePicker`](#createworkspacepicker) | [workspace-picker](https://minifish-org.github.io/pith-ui/?item=workspace-picker) |
+| [`createWorkspaceShell`](#createworkspaceshell) | [workspace-chat](https://minifish-org.github.io/pith-ui/?item=workspace-chat) |
+| [`installConversationReader`](#installconversationreader) | [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader) |
+| [`installImageViewer`](#installimageviewer) | [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer) |
+| [`mountPagedPreview`](#mountpagedpreview) | [markdown-content](https://minifish-org.github.io/pith-ui/?item=markdown-content), [paged-preview](https://minifish-org.github.io/pith-ui/?item=paged-preview) |
+
+## src/composer.ts
+
+### createAttachments
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L63)
+
+```ts
+export declare function createAttachments(options?: {
+    container?: HTMLElement;
+    onRemove?: (id: string) => void;
+    onOpen?: (image: HTMLImageElement) => void;
+}): UIBlock<AttachmentsState>;
+```
+
+Referenced public types and APIs: [`AttachmentsState`](#attachmentsstate), [`UIBlock`](#uiblock).
+
+Related gallery: [attachments](https://minifish-org.github.io/pith-ui/?item=attachments).
+
+### createDropFeedback
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L53)
+
+```ts
+export declare function createDropFeedback(options: {
+    container: HTMLElement;
+}): UIBlock<{
+    active: boolean;
+    disabled?: boolean;
+}>;
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock).
+
+Related gallery: [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback).
+
+### createPendingMessages
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L10)
+
+```ts
+export declare function createPendingMessages(options?: PendingMessagesOptions): UIBlock<PendingMessagesState>;
+```
+
+Referenced public types and APIs: [`PendingMessagesOptions`](#pendingmessagesoptions), [`PendingMessagesState`](#pendingmessagesstate), [`UIBlock`](#uiblock).
+
+Related gallery: [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages).
+
+### AttachmentItem
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L51)
+
+```ts
+export interface AttachmentItem {
+    id: string;
+    url: string;
+    name: string;
+}
+```
+
+### AttachmentsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L62)
+
+```ts
+export interface AttachmentsState {
+    items: readonly AttachmentItem[];
+    disabled?: boolean;
+}
+```
+
+Referenced public types and APIs: [`AttachmentItem`](#attachmentitem).
+
+### PendingMessage
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L4)
+
+```ts
+export interface PendingMessage {
+    id: string;
+    text: string;
+    mode: string;
+    imageCount?: number;
+}
+```
+
+### PendingMessagesOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L6)
+
+```ts
+export interface PendingMessagesOptions {
+    container?: HTMLElement;
+    onAction?: (action: 'edit' | 'delete' | 'steer', id: string) => void;
+}
+```
+
+### PendingMessagesState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/composer.ts#L5)
+
+```ts
+export interface PendingMessagesState {
+    items: readonly PendingMessage[];
+    running: boolean;
+    busy: boolean;
+}
+```
+
+Referenced public types and APIs: [`PendingMessage`](#pendingmessage).
+
+## src/content/conversation-reader.ts
+
+### installConversationReader
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-reader.ts#L18)
+
+```ts
+export declare function installConversationReader(scroll: HTMLElement, messages: HTMLElement, bar: HTMLElement, latest: HTMLButtonElement, options?: ConversationReaderOptions): {
+    beforeRender(id: string): void;
+    afterRender(): void;
+    prune(ids: string[]): void;
+    followLatest: () => void;
+    openFind: () => void;
+    closeFind: () => void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`ConversationReaderOptions`](#conversationreaderoptions).
+
+Related gallery: [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader).
+
+### ConversationReaderOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-reader.ts#L13)
+
+```ts
+export interface ConversationReaderOptions {
+    keyboardTarget?: EventTarget;
+    isKeyboardBlocked?: () => boolean;
+}
+```
+
+### findRanges
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-reader.ts#L4)
+
+```ts
+export declare function findRanges(text: string, query: string): TextRange[];
+```
+
+Referenced public types and APIs: [`TextRange`](#textrange).
+
+### TextRange
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-reader.ts#L1)
+
+```ts
+export interface TextRange {
+    start: number;
+    end: number;
+}
+```
+
+## src/content/conversation-view.ts
+
+### createConversationView
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L34)
+
+```ts
+export declare function createConversationView(options?: ConversationViewOptions): UIBlock<ConversationViewState>;
+```
+
+Referenced public types and APIs: [`ConversationViewOptions`](#conversationviewoptions), [`ConversationViewState`](#conversationviewstate), [`UIBlock`](#uiblock).
+
+Related gallery: [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion).
+
+### ConversationAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L25)
+
+```ts
+export interface ConversationAction {
+    action: 'copy' | 'edit' | 'branch';
+    messageId: string;
+    branchKey?: string;
+}
+```
+
+### ConversationMessage
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L7)
+
+```ts
+/** UI data only. Hosts decide copy/edit/branch eligibility and resolve images. */
+export interface ConversationMessage {
+    id: string;
+    role: string;
+    text: string;
+    timestamp?: number;
+    toolName?: string;
+    toolCallId?: string;
+    status?: string;
+    images?: Array<{
+        index: number;
+        mimeType?: string;
+    }>;
+    command?: {
+        text: string;
+        cwd: string;
+        exitCode?: number;
+    };
+    actions?: {
+        copy?: boolean | string;
+        edit?: boolean;
+        branch?: {
+            key: string;
+            label?: string;
+        };
+    };
+}
+```
+
+Related gallery: [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader).
+
+### ConversationViewOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L26)
+
+```ts
+export interface ConversationViewOptions {
+    container?: HTMLElement;
+    markdown?: (conversationId: string) => MarkdownOptions;
+    onAction?: (action: ConversationAction) => void;
+    onCopyCode?: (text: string) => void;
+}
+```
+
+Referenced public types and APIs: [`ConversationAction`](#conversationaction), [`MarkdownOptions`](#markdownoptions).
+
+### ConversationViewState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/conversation-view.ts#L19)
+
+```ts
+export interface ConversationViewState {
+    id: string;
+    messages: readonly ConversationMessage[];
+    working: boolean;
+    folds?: ReadonlyMap<string, boolean>;
+}
+```
+
+Referenced public types and APIs: [`ConversationMessage`](#conversationmessage).
+
+## src/content/image-viewer.ts
+
+### createImageViewer
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L8)
+
+```ts
+/** A modal above either a generated-file preview or a conversation attachment. */
+export declare function createImageViewer(options?: ImageViewerOptions): {
+    element: HTMLDialogElement;
+    open(target: HTMLImageElement | ImageViewerInput): void;
+    close: () => void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`ImageViewerInput`](#imageviewerinput), [`ImageViewerOptions`](#imagevieweroptions).
+
+Related gallery: [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer).
+
+### installImageViewer
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L87)
+
+```ts
+export declare function installImageViewer(dialog: HTMLDialogElement): {
+    element: HTMLDialogElement;
+    open(target: HTMLImageElement | ImageViewerInput): void;
+    close: () => void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`ImageViewerInput`](#imageviewerinput).
+
+Related gallery: [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer).
+
+### ImageViewerInput
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L4)
+
+```ts
+export interface ImageViewerInput {
+    src: string;
+    alt?: string;
+    returnFocus?: HTMLElement;
+}
+```
+
+### ImageViewerOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/image-viewer.ts#L3)
+
+```ts
+export interface ImageViewerOptions {
+    dialog?: HTMLDialogElement;
+    headingId?: string;
+}
+```
+
+## src/content/markdown.ts
+
+### LocalContentLink
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/markdown.ts#L5)
+
+```ts
+export interface LocalContentLink {
+    path: string;
+    conversationId: string;
+}
+```
+
+### MarkdownOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/markdown.ts#L6)
+
+```ts
+export interface MarkdownOptions {
+    /** The host validates its own file identity and download permissions. */
+    resolveLocalLink?: (href: string) => LocalContentLink | null;
+}
+```
+
+Referenced public types and APIs: [`LocalContentLink`](#localcontentlink).
+
+### renderDiff
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/markdown.ts#L67)
+
+```ts
+export declare function renderDiff(diff: string): string;
+```
+
+### renderMarkdown
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/markdown.ts#L12)
+
+```ts
+/** Sanitized content only: embedded images, executable markup and forms are excluded. */
+export declare function renderMarkdown(value: string, options?: MarkdownOptions): string;
+```
+
+Referenced public types and APIs: [`MarkdownOptions`](#markdownoptions).
+
+## src/content/paged-preview.ts
+
+### createPagedPreview
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L30)
+
+```ts
+export declare function createPagedPreview(options: PagedPreviewOptions): UIBlock<PagedPreviewState>;
+```
+
+Referenced public types and APIs: [`PagedPreviewOptions`](#pagedpreviewoptions), [`PagedPreviewState`](#pagedpreviewstate), [`UIBlock`](#uiblock).
+
+Related gallery: [markdown-content](https://minifish-org.github.io/pith-ui/?item=markdown-content), [paged-preview](https://minifish-org.github.io/pith-ui/?item=paged-preview).
+
+### mountPagedPreview
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L59)
+
+```ts
+export declare function mountPagedPreview(container: HTMLElement, text: string, kind: PreviewKind): void;
+```
+
+Referenced public types and APIs: [`PreviewKind`](#previewkind).
+
+Related gallery: [markdown-content](https://minifish-org.github.io/pith-ui/?item=markdown-content), [paged-preview](https://minifish-org.github.io/pith-ui/?item=paged-preview).
+
+### PagedPreviewOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L28)
+
+```ts
+export interface PagedPreviewOptions extends PagedPreviewState {
+    container?: HTMLElement;
+    onCopyCode?: (text: string) => void;
+}
+```
+
+Referenced public types and APIs: [`PagedPreviewState`](#pagedpreviewstate).
+
+### PagedPreviewState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L27)
+
+```ts
+export interface PagedPreviewState {
+    text: string;
+    kind: PreviewKind;
+}
+```
+
+Referenced public types and APIs: [`PreviewKind`](#previewkind).
+
+### PreviewKind
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L26)
+
+```ts
+export type PreviewKind = 'text' | 'markdown' | 'diff';
+```
+
+### previewPageBytes
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L6)
+
+```ts
+export declare const previewPageBytes: number;
+```
+
+### previewPageRanges
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/paged-preview.ts#L8)
+
+```ts
+export declare function previewPageRanges(bytes: Uint8Array, window?: number): Array<[
+    number,
+    number
+]>;
+```
+
+## src/content/welcome.ts
+
+### createWelcomeView
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L17)
+
+```ts
+export declare function createWelcomeView(options?: WelcomeOptions): UIBlock<WelcomeState>;
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock), [`WelcomeOptions`](#welcomeoptions), [`WelcomeState`](#welcomestate).
+
+Related gallery: [welcome](https://minifish-org.github.io/pith-ui/?item=welcome).
+
+### WelcomeOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L10)
+
+```ts
+export interface WelcomeOptions {
+    container?: HTMLElement;
+    logo?: Node;
+    onAction?: (action: 'model' | 'settings' | 'workspace') => void;
+    onPrompt?: (text: string) => void;
+}
+```
+
+### WelcomeState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/content/welcome.ts#L4)
+
+```ts
+export interface WelcomeState {
+    workspace?: {
+        name: string;
+        path: string;
+    };
+    hasApiKey: boolean;
+    hasConnections: boolean;
+    modelName: string;
+}
+```
+
+## src/core.ts
+
+### ActionResult
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L8)
+
+```ts
+export type ActionResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+```
+
+### controlDisabled
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L42)
+
+```ts
+/** Combine business availability with pending state owned by the control. */
+export declare function controlDisabled(button: Pick<HTMLButtonElement, 'dataset'>, unavailable: boolean): boolean;
+```
+
+### Density
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L10)
+
+```ts
+export type Density = 'normal' | 'compact';
+```
+
+### Generation
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L14)
+
+```ts
+/** Invalidates UI responses without cancelling an already-started business write. */
+export declare class Generation {
+    private revision;
+    private disposed;
+    next(): number;
+    current(revision: number): boolean;
+    invalidate(): void;
+    destroy(): void;
+}
+```
+
+### Intent
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L11)
+
+```ts
+export type Intent = 'neutral' | 'primary' | 'danger';
+```
+
+### Lifetime
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L24)
+
+```ts
+/** All listeners and observers belong to the instance, including document listeners. */
+export declare class Lifetime {
+    private cleanups;
+    private disposed;
+    add(cleanup: () => void): void;
+    listen(target: EventTarget, type: string, listener: EventListenerOrEventListenerObject, options?: AddEventListenerOptions): void;
+    destroy(): void;
+}
+```
+
+### setControlPending
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L46)
+
+```ts
+export declare function setControlPending(button: HTMLButtonElement, pending: boolean): void;
+```
+
+### UIAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L9)
+
+```ts
+export type UIAction = () => void | ActionResult | Promise<void | ActionResult>;
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult).
+
+### UIBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/core.ts#L2)
+
+```ts
+/** An owned DOM instance. Call destroy before releasing or replacing its host. */
+export interface UIBlock<State> {
+    readonly element: HTMLElement;
+    update(state: Readonly<State>): void;
+    destroy(): void;
+}
+```
+
+## src/dom.ts
+
+### dialogHeading
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L34)
+
+```ts
+export declare function dialogHeading(title: string, id: string, dialogId: string, eyebrow?: string): string;
+```
+
+### DOMChild
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L38)
+
+```ts
+export type DOMChild = Node | string | null | undefined;
+```
+
+### element
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L40)
+
+```ts
+/** Safe DOM construction; strings are always text nodes. */
+export declare function element<K extends keyof HTMLElementTagNameMap>(tag: K, className?: string, ...children: DOMChild[]): HTMLElementTagNameMap[K];
+```
+
+Referenced public types and APIs: [`DOMChild`](#domchild).
+
+Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions), [artifact-panel](https://minifish-org.github.io/pith-ui/?item=artifact-panel), [button](https://minifish-org.github.io/pith-ui/?item=button), [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state), [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices), [composer](https://minifish-org.github.io/pith-ui/?item=composer), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-messages](https://minifish-org.github.io/pith-ui/?item=conversation-messages), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [disclosure](https://minifish-org.github.io/pith-ui/?item=disclosure), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [file-actions](https://minifish-org.github.io/pith-ui/?item=file-actions), [file-preview](https://minifish-org.github.io/pith-ui/?item=file-preview), [form-section](https://minifish-org.github.io/pith-ui/?item=form-section), [foundation-borders](https://minifish-org.github.io/pith-ui/?item=foundation-borders), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [foundation-surfaces](https://minifish-org.github.io/pith-ui/?item=foundation-surfaces), [foundation-typography](https://minifish-org.github.io/pith-ui/?item=foundation-typography), [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [icons](https://minifish-org.github.io/pith-ui/?item=icons), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections), [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker), [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages), [permission-control](https://minifish-org.github.io/pith-ui/?item=permission-control), [popover](https://minifish-org.github.io/pith-ui/?item=popover), [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [resource-editor](https://minifish-org.github.io/pith-ui/?item=resource-editor), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [scroll-area](https://minifish-org.github.io/pith-ui/?item=scroll-area), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar), [updates](https://minifish-org.github.io/pith-ui/?item=updates), [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation).
+
+### escape
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L29)
+
+```ts
+export declare const escape: (value: unknown) => string;
+```
+
+### escapeHTML
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L30)
+
+```ts
+export declare const escapeHTML: (value: unknown) => string;
+```
+
+### focusableElements
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L58)
+
+```ts
+export declare function focusableElements(owner: HTMLElement): HTMLElement[];
+```
+
+### icon
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L32)
+
+```ts
+/** Compatibility markup from a closed, trusted icon registry. */
+export declare const icon: (name: string, className?: string) => string;
+```
+
+Related gallery: [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar).
+
+### iconElement
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L47)
+
+```ts
+export declare function iconElement(name: string): SVGSVGElement;
+```
+
+### setText
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L53)
+
+```ts
+export declare function setText(node: HTMLElement, value: unknown): void;
+```
+
+### showDialogError
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L66)
+
+```ts
+export declare function showDialogError(owner: HTMLElement, message: string): void;
+```
+
+### uniqueId
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/dom.ts#L64)
+
+```ts
+export declare function uniqueId(prefix?: string): string;
+```
+
+Related gallery: [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus).
+
+## src/files/panels.ts
+
+### createArtifactPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L30)
+
+```ts
+export declare function createArtifactPanel(options: ArtifactPanelOptions): {
+    element: HTMLElement;
+    setOpen: (value: boolean, restoreFocus?: boolean) => void;
+    readonly open: boolean;
+    update(state: Readonly<ArtifactPanelState>): void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`ArtifactPanelOptions`](#artifactpaneloptions), [`ArtifactPanelState`](#artifactpanelstate).
+
+Related gallery: [artifact-panel](https://minifish-org.github.io/pith-ui/?item=artifact-panel).
+
+### createFileActions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L16)
+
+```ts
+export declare function createFileActions(options: FileActionOptions): {
+    element: HTMLElement;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`FileActionOptions`](#fileactionoptions).
+
+Related gallery: [file-actions](https://minifish-org.github.io/pith-ui/?item=file-actions).
+
+### createFilePreview
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L153)
+
+```ts
+export declare function createFilePreview(options?: FilePreviewOptions): {
+    element: HTMLElement;
+    clear: () => void;
+    open(input: {
+        name: string;
+        path: string;
+        actions: Node;
+    }): void;
+    update(state: Readonly<FilePreviewState>): void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`FilePreviewOptions`](#filepreviewoptions), [`FilePreviewState`](#filepreviewstate).
+
+Related gallery: [file-preview](https://minifish-org.github.io/pith-ui/?item=file-preview).
+
+### createResourcesPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L94)
+
+```ts
+export declare function createResourcesPanel(options?: ResourcesPanelOptions): {
+    element: HTMLElement;
+    open(workspaceName: string, toolbar: Node): void;
+    setError(message: string): void;
+    update(state: Readonly<ResourcesPanelState>): void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`ResourcesPanelOptions`](#resourcespaneloptions), [`ResourcesPanelState`](#resourcespanelstate).
+
+Related gallery: [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel).
+
+### ArtifactPanelOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L29)
+
+```ts
+export interface ArtifactPanelOptions {
+    container: HTMLElement;
+    control: HTMLElement;
+    toggle: HTMLElement;
+    count: HTMLElement;
+    headingId?: string;
+}
+```
+
+### ArtifactPanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L28)
+
+```ts
+export interface ArtifactPanelState {
+    ownerId: string;
+    files: readonly {
+        name: string;
+        path: string;
+    }[];
+    loading: boolean;
+    error: string;
+    copyMode: 'file' | 'path';
+}
+```
+
+### FileActionOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L5)
+
+```ts
+export interface FileActionOptions {
+    kind: string;
+    ownerId: string;
+    path: string;
+    preview?: boolean;
+    copyMode?: 'file' | 'path' | 'none';
+    onAction?: (action: 'preview' | 'open' | 'reveal' | 'copy' | 'copy-path') => void;
+}
+```
+
+### fileActionsMarkup
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L10)
+
+```ts
+export declare function fileActionsMarkup(options: FileActionOptions): string;
+```
+
+Referenced public types and APIs: [`FileActionOptions`](#fileactionoptions).
+
+### FilePreviewOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L152)
+
+```ts
+export interface FilePreviewOptions {
+    container?: HTMLElement;
+    titleId?: string;
+    dialogId?: string;
+    bodyId?: string;
+    onClose?: () => void;
+}
+```
+
+### FilePreviewState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L151)
+
+```ts
+export interface FilePreviewState {
+    kind: PreviewKind | 'image';
+    text?: string;
+    imageSrc?: string;
+    imageAlt?: string;
+    truncated?: boolean;
+    error?: string;
+}
+```
+
+Referenced public types and APIs: [`PreviewKind`](#previewkind).
+
+### ResourceDisplayEntry
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L88)
+
+```ts
+export interface ResourceDisplayEntry {
+    name: string;
+    path: string;
+    description?: string;
+    content?: string;
+    fileActions?: Node;
+    actions?: Node;
+}
+```
+
+### ResourcesPanelOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L93)
+
+```ts
+export interface ResourcesPanelOptions {
+    container?: HTMLElement;
+    titleId?: string;
+    dialogId?: string;
+    listId?: string;
+    errorId?: string;
+    onClose?: () => void;
+}
+```
+
+### ResourcesPanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/panels.ts#L89)
+
+```ts
+export interface ResourcesPanelState {
+    instructions: readonly ResourceDisplayEntry[];
+    skills: readonly ResourceDisplayEntry[];
+    templates: readonly ResourceDisplayEntry[];
+    diagnostics: readonly string[];
+    createInstructions?: Node;
+}
+```
+
+Referenced public types and APIs: [`ResourceDisplayEntry`](#resourcedisplayentry).
+
+## src/files/systems.ts
+
+### createCompletionNotices
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L120)
+
+```ts
+export declare function createCompletionNotices(options?: {
+    container?: HTMLElement;
+    onOpen?: (id: string) => void;
+    onDismiss?: (runID: string) => void;
+}): UIBlock<readonly CompletionNoticeDisplay[]>;
+```
+
+Referenced public types and APIs: [`CompletionNoticeDisplay`](#completionnoticedisplay), [`UIBlock`](#uiblock).
+
+Related gallery: [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices).
+
+### createCopyFeedback
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L159)
+
+```ts
+export declare function createCopyFeedback(options: {
+    status: HTMLElement;
+    isDisabled: (button: HTMLButtonElement) => boolean;
+    onError: (error: unknown) => void;
+}): {
+    copy(button: HTMLButtonElement, action: () => Promise<void>, announcement: string): Promise<void>;
+    destroy(): void;
+};
+```
+
+Related gallery: [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback).
+
+### createCostLedger
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L21)
+
+```ts
+export declare function createCostLedger(options?: {
+    container?: HTMLElement;
+}): {
+    element: HTMLElement;
+    clear(): void;
+    loading(): void;
+    setError(message: string): void;
+    update(report: Readonly<CostLedgerState>): void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`CostLedgerState`](#costledgerstate).
+
+Related gallery: [cost-ledger](https://minifish-org.github.io/pith-ui/?item=cost-ledger).
+
+### createUpdatePanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L80)
+
+```ts
+export declare function createUpdatePanel(options?: {
+    container?: HTMLElement;
+    productName?: string;
+    onCheck?: () => void;
+    onInstall?: () => void;
+}): {
+    element: HTMLElement;
+    update(value: Readonly<UpdatePanelState>): void;
+    setPending(value: boolean): void;
+    setError(value: string, options?: {
+        allowCheckRetry?: boolean;
+    }): void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`UpdatePanelState`](#updatepanelstate).
+
+Related gallery: [updates](https://minifish-org.github.io/pith-ui/?item=updates).
+
+### CompletionNoticeDisplay
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L113)
+
+```ts
+export interface CompletionNoticeDisplay {
+    id: string;
+    runID: string;
+    title: string;
+    workspace: string;
+}
+```
+
+Related gallery: [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices).
+
+### CostLedgerState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L20)
+
+```ts
+export interface CostLedgerState {
+    unknownRequests: number;
+    requests: readonly CostRequestDisplay[] | null;
+}
+```
+
+Referenced public types and APIs: [`CostRequestDisplay`](#costrequestdisplay).
+
+### CostRequestDisplay
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L15)
+
+```ts
+export interface CostRequestDisplay {
+    id: string;
+    purpose: string;
+    status: string;
+    provider: string;
+    providerName?: string;
+    model: string;
+    modelName?: string;
+    time: string;
+    source: string;
+    price: unknown;
+    known: boolean;
+    usage: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        reasoning?: number;
+        cost: {
+            total: number;
+        };
+    };
+}
+```
+
+### CostSummaryDisplay
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L6)
+
+```ts
+export interface CostSummaryDisplay {
+    unavailable?: boolean;
+    requestCount: number;
+    unknownRequests: number;
+    runRequests: number;
+    runUnknownRequests: number;
+    total: number;
+    runTotal: number;
+}
+```
+
+### formatCost
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L7)
+
+```ts
+export declare function formatCost(cost: CostSummaryDisplay | undefined, latestTask?: boolean): string;
+```
+
+Referenced public types and APIs: [`CostSummaryDisplay`](#costsummarydisplay).
+
+### historyStatusMarkup
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L114)
+
+```ts
+export declare function historyStatusMarkup(status: 'approval' | 'running' | 'unread' | 'idle'): string;
+```
+
+Related gallery: [completion-notices](https://minifish-org.github.io/pith-ui/?item=completion-notices).
+
+### UpdatePanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/files/systems.ts#L79)
+
+```ts
+export interface UpdatePanelState {
+    version: string;
+    enabled: boolean;
+    phase: string;
+    availableVersion: string;
+    progress: number;
+    message: string;
+}
+```
+
+## src/forms/actions.ts
+
+### createProviderActions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L16)
+
+```ts
+export declare function createProviderActions(state: ProviderActionsState, options?: {
+    onAction?: (action: string, target: DOMStringMap) => void;
+}): UIBlock<ProviderActionsState>;
+```
+
+Referenced public types and APIs: [`ProviderActionsState`](#provideractionsstate), [`UIBlock`](#uiblock).
+
+Related gallery: [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions).
+
+### createResourceActions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L17)
+
+```ts
+export declare function createResourceActions(state: ResourceActionsState, options?: {
+    onAction?: (action: string, target: DOMStringMap) => void;
+}): UIBlock<ResourceActionsState>;
+```
+
+Referenced public types and APIs: [`ResourceActionsState`](#resourceactionsstate), [`UIBlock`](#uiblock).
+
+Related gallery: [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel).
+
+### providerActionsMarkup
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L5)
+
+```ts
+export declare function providerActionsMarkup(provider: ProviderActionsState): string;
+```
+
+Referenced public types and APIs: [`ProviderActionsState`](#provideractionsstate).
+
+### ProviderActionsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L3)
+
+```ts
+export interface ProviderActionsState {
+    id: string;
+    oauth: boolean;
+    signedIn: boolean;
+    custom: boolean;
+}
+```
+
+### resourceActionsMarkup
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L6)
+
+```ts
+export declare function resourceActionsMarkup(kind: string, resource: {
+    name: string;
+    path: string;
+}, workspaceId: string): string;
+```
+
+### ResourceActionsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/actions.ts#L4)
+
+```ts
+export interface ResourceActionsState {
+    kind: string;
+    resource: {
+        name: string;
+        path: string;
+    };
+    workspaceId: string;
+}
+```
+
+## src/forms/custom-connection.ts
+
+### createCustomConnectionEditor
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L26)
+
+```ts
+export declare function createCustomConnectionEditor(state: CustomConnectionState, options?: {
+    idPrefix?: string;
+}): UIBlock<CustomConnectionState> & {
+    read(): CustomConnectionDraft;
+    readonly form: HTMLFormElement;
+};
+```
+
+Referenced public types and APIs: [`CustomConnectionDraft`](#customconnectiondraft), [`CustomConnectionState`](#customconnectionstate), [`UIBlock`](#uiblock).
+
+Related gallery: [custom-connection](https://minifish-org.github.io/pith-ui/?item=custom-connection).
+
+### createCustomModelRow
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L11)
+
+```ts
+export declare function createCustomModelRow(model: CustomModelRowState, index?: number): UIBlock<CustomModelRowState> & {
+    read(): CustomModelDraft;
+    reset(model: CustomModelValue): void;
+};
+```
+
+Referenced public types and APIs: [`CustomModelDraft`](#custommodeldraft), [`CustomModelRowState`](#custommodelrowstate), [`CustomModelValue`](#custommodelvalue), [`UIBlock`](#uiblock).
+
+Related gallery: [custom-connection](https://minifish-org.github.io/pith-ui/?item=custom-connection), [provider-resource-actions](https://minifish-org.github.io/pith-ui/?item=provider-resource-actions), [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel).
+
+### CustomConnectionDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L7)
+
+```ts
+export interface CustomConnectionDraft {
+    name: string;
+    baseUrl: string;
+    api: string;
+    apiKey: string;
+    models: CustomModelDraft[];
+}
+```
+
+Referenced public types and APIs: [`CustomModelDraft`](#custommodeldraft).
+
+### CustomConnectionState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L5)
+
+```ts
+export interface CustomConnectionState {
+    name: string;
+    baseUrl: string;
+    api: string;
+    editing: boolean;
+    models: readonly CustomModelValue[];
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+Referenced public types and APIs: [`CustomModelValue`](#custommodelvalue).
+
+### CustomModelDraft
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L6)
+
+```ts
+export interface CustomModelDraft {
+    sourceIndex: number;
+    id: string;
+    name: string;
+    contextWindow: number;
+    maxTokens: number;
+    reasoning: boolean;
+    images: boolean;
+    prices: {
+        input: string;
+        output: string;
+        cacheRead: string;
+        cacheWrite: string;
+    };
+}
+```
+
+### CustomModelRowState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L10)
+
+```ts
+export interface CustomModelRowState extends CustomModelValue {
+    disabled?: boolean;
+    error?: string;
+}
+```
+
+Referenced public types and APIs: [`CustomModelValue`](#custommodelvalue).
+
+### CustomModelValue
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/custom-connection.ts#L4)
+
+```ts
+export interface CustomModelValue {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    maxTokens?: number;
+    reasoning?: boolean;
+    input?: readonly string[];
+    cost?: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+}
+```
+
+## src/forms/dialog-frame.ts
+
+### createFeatureDialogFrame
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L8)
+
+```ts
+export declare function createFeatureDialogFrame(options?: FeatureDialogOptions): UIBlock<FeatureDialogState> & {
+    open(state: FeatureDialogState): void;
+    close(): void;
+    fail(message: string): void;
+};
+```
+
+Referenced public types and APIs: [`FeatureDialogOptions`](#featuredialogoptions), [`FeatureDialogState`](#featuredialogstate), [`UIBlock`](#uiblock).
+
+Related gallery: [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog).
+
+### createFeatureStatus
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L38)
+
+```ts
+export declare function createFeatureStatus(state: {
+    message: string;
+    error?: boolean;
+}): UIBlock<{
+    message: string;
+    error?: boolean;
+}>;
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock).
+
+Related gallery: [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog).
+
+### createSDKDialogElements
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L43)
+
+```ts
+export declare function createSDKDialogElements(options?: {
+    idPrefix?: string;
+}): {
+    dialog: HTMLDialogElement;
+    content: HTMLElement;
+    oauthDialog: HTMLDialogElement;
+    oauthContent: HTMLElement;
+    destroy(): void;
+};
+```
+
+Related gallery: [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog).
+
+### DialogContent
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L5)
+
+```ts
+export interface DialogContent {
+    element: HTMLElement;
+    destroy(): void;
+}
+```
+
+### FeatureDialogOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L7)
+
+```ts
+export interface FeatureDialogOptions {
+    dialog?: HTMLDialogElement;
+    content?: HTMLElement;
+    dialogId?: string;
+    titleId?: string;
+    errorId?: string;
+    eyebrow?: string;
+}
+```
+
+### FeatureDialogState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/dialog-frame.ts#L6)
+
+```ts
+export interface FeatureDialogState {
+    title: string;
+    body: Node | DialogContent;
+}
+```
+
+Referenced public types and APIs: [`DialogContent`](#dialogcontent).
+
+## src/forms/history.ts
+
+### createBranchHistory
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L5)
+
+```ts
+export declare function createBranchHistory(state: BranchHistoryState, options?: {
+    onContinue?: (id: string) => void | Promise<void>;
+}): UIBlock<BranchHistoryState>;
+```
+
+Referenced public types and APIs: [`BranchHistoryState`](#branchhistorystate), [`UIBlock`](#uiblock).
+
+Related gallery: [branch-history](https://minifish-org.github.io/pith-ui/?item=branch-history).
+
+### BranchHistoryNode
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L3)
+
+```ts
+export interface BranchHistoryNode {
+    id: string;
+    role: string;
+    text: string;
+    active: boolean;
+}
+```
+
+### BranchHistoryState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/history.ts#L4)
+
+```ts
+export interface BranchHistoryState {
+    nodes: readonly BranchHistoryNode[] | null;
+    error?: string;
+    loading?: boolean;
+}
+```
+
+Referenced public types and APIs: [`BranchHistoryNode`](#branchhistorynode).
+
+## src/forms/model-editor.ts
+
+### createModelEditor
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L9)
+
+```ts
+export declare function createModelEditor(initial: ModelEditorState, options?: {
+    prefix?: string;
+    element?: HTMLElement;
+    onChange?: (selection: ModelSelection) => void;
+}): UIBlock<ModelEditorState> & {
+    read(): ModelSelection;
+};
+```
+
+Referenced public types and APIs: [`ModelEditorState`](#modeleditorstate), [`ModelSelection`](#modelselection), [`UIBlock`](#uiblock).
+
+Related gallery: [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker).
+
+### ModelEditorState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L6)
+
+```ts
+export interface ModelEditorState {
+    providers: readonly ModelProviderOption[] | null;
+    models: readonly ModelOption[] | null;
+    selection: ModelSelection;
+}
+```
+
+Referenced public types and APIs: [`ModelOption`](#modeloption), [`ModelProviderOption`](#modelprovideroption), [`ModelSelection`](#modelselection).
+
+### ModelOption
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L5)
+
+```ts
+export interface ModelOption {
+    id: string;
+    name: string;
+    provider: string;
+    thinkingLevels?: readonly string[] | null;
+    supportsImages: boolean;
+    contextWindow: number;
+    maxTokens: number;
+}
+```
+
+### ModelProviderOption
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L4)
+
+```ts
+export interface ModelProviderOption {
+    id: string;
+    name: string;
+    model?: string;
+    thinkingLevel?: string;
+}
+```
+
+### ModelSelection
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L7)
+
+```ts
+export interface ModelSelection {
+    provider: string;
+    model: string;
+    thinkingLevel: string;
+}
+```
+
+### thinkingLabel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/model-editor.ts#L8)
+
+```ts
+export declare function thinkingLabel(level: string): string;
+```
+
+## src/forms/panels.ts
+
+### createMCPConnectionList
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L130)
+
+```ts
+export declare function createMCPConnectionList(initial: MCPConnectionListState): UIBlock<MCPConnectionListState>;
+```
+
+Referenced public types and APIs: [`MCPConnectionListState`](#mcpconnectionliststate), [`UIBlock`](#uiblock).
+
+Related gallery: [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections).
+
+### createMCPConnectionsPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L95)
+
+```ts
+export declare function createMCPConnectionsPanel(state?: FormFeedback, options?: FormOptions): MCPConnectionsPanel;
+```
+
+Referenced public types and APIs: [`FormFeedback`](#formfeedback), [`FormOptions`](#formoptions), [`MCPConnectionsPanel`](#mcpconnectionspanel).
+
+Related gallery: [mcp-connections](https://minifish-org.github.io/pith-ui/?item=mcp-connections).
+
+### createModelPicker
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L121)
+
+```ts
+export declare function createModelPicker(state?: FormFeedback, options?: FormOptions): FormDOMBlock<FormFeedback>;
+```
+
+Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`FormFeedback`](#formfeedback), [`FormOptions`](#formoptions).
+
+Related gallery: [model-picker](https://minifish-org.github.io/pith-ui/?item=model-picker).
+
+### createSettingsPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L37)
+
+```ts
+export declare function createSettingsPanel(state: SettingsPanelState, options?: FormOptions): FormDOMBlock<SettingsPanelState>;
+```
+
+Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`FormOptions`](#formoptions), [`SettingsPanelState`](#settingspanelstate).
+
+Related gallery: [settings-panel](https://minifish-org.github.io/pith-ui/?item=settings-panel).
+
+### FormDOMBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L6)
+
+```ts
+export interface FormDOMBlock<State extends FormFeedback> extends UIBlock<State> {
+    field<T extends HTMLElement = HTMLElement>(id: string): T;
+    id(localId: string): string;
+}
+```
+
+Referenced public types and APIs: [`FormFeedback`](#formfeedback), [`UIBlock`](#uiblock).
+
+### FormFeedback
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L5)
+
+```ts
+export interface FormFeedback {
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### FormOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L36)
+
+```ts
+export interface FormOptions {
+    idPrefix?: string;
+}
+```
+
+### MCPConnectionItem
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L124)
+
+```ts
+export interface MCPConnectionItem {
+    name: string;
+    type: string;
+    url?: string;
+    command?: string;
+    args?: readonly string[];
+    enabled: boolean;
+    hasBearerToken?: boolean;
+    status?: string;
+    statusLabel: string;
+    envKeys?: readonly string[];
+    error?: string;
+    oauth?: boolean;
+    signedIn?: boolean;
+}
+```
+
+### MCPConnectionListState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L128)
+
+```ts
+export interface MCPConnectionListState extends FormFeedback {
+    entries: readonly MCPConnectionItem[];
+}
+```
+
+Referenced public types and APIs: [`FormFeedback`](#formfeedback), [`MCPConnectionItem`](#mcpconnectionitem).
+
+### MCPConnectionsPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L94)
+
+```ts
+export interface MCPConnectionsPanel extends FormDOMBlock<FormFeedback> {
+    renderType(): void;
+    edit(value?: MCPEditorValue): void;
+}
+```
+
+Referenced public types and APIs: [`FormDOMBlock`](#formdomblock), [`FormFeedback`](#formfeedback), [`MCPEditorValue`](#mcpeditorvalue).
+
+### MCPEditorValue
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L93)
+
+```ts
+export interface MCPEditorValue {
+    name: string;
+    type: string;
+    url?: string;
+    oauth?: boolean;
+    oauthClientId?: string;
+    oauthScope?: string;
+    command?: string;
+    args?: readonly string[];
+    enabled?: boolean;
+    hasBearerToken?: boolean;
+    envKeys?: readonly string[];
+}
+```
+
+### modelEditorMarkup
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L120)
+
+```ts
+export declare function modelEditorMarkup(prefix: string): string;
+```
+
+### SettingsPanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/panels.ts#L35)
+
+```ts
+export interface SettingsPanelState extends FormFeedback {
+    baseUrl: string;
+    hasApiKey: boolean;
+}
+```
+
+Referenced public types and APIs: [`FormFeedback`](#formfeedback).
+
+## src/forms/provider-login.ts
+
+### createProviderLoginPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/provider-login.ts#L5)
+
+```ts
+export declare function createProviderLoginPanel(initial: ProviderLoginState, options?: {
+    idPrefix?: string;
+    onAnswer?: (answer: string) => void | ActionResult | Promise<void | ActionResult>;
+    onCancel?: () => void;
+    onClose?: () => void;
+}): UIBlock<ProviderLoginState>;
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`ProviderLoginState`](#providerloginstate), [`UIBlock`](#uiblock).
+
+Related gallery: [provider-login](https://minifish-org.github.io/pith-ui/?item=provider-login).
+
+### ProviderLoginState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/provider-login.ts#L4)
+
+```ts
+export interface ProviderLoginState {
+    phase: string;
+    message: string;
+    url?: string;
+    code?: string;
+    prompt?: string;
+    promptType?: string;
+    options?: readonly {
+        id: string;
+        label: string;
+    }[] | null;
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+## src/forms/resource-editor.ts
+
+### createResourceEditor
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/resource-editor.ts#L5)
+
+```ts
+export declare function createResourceEditor(state: ResourceEditorState, options?: {
+    idPrefix?: string;
+}): UIBlock<ResourceEditorState> & {
+    read(): {
+        name: string;
+        content: string;
+    };
+    readonly form: HTMLFormElement;
+    readonly removeButton: HTMLButtonElement | null;
+};
+```
+
+Referenced public types and APIs: [`ResourceEditorState`](#resourceeditorstate), [`UIBlock`](#uiblock).
+
+Related gallery: [resource-editor](https://minifish-org.github.io/pith-ui/?item=resource-editor).
+
+### ResourceEditorState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/forms/resource-editor.ts#L4)
+
+```ts
+export interface ResourceEditorState {
+    workspaceId: string;
+    workspacePath: string;
+    path?: string;
+    kind: string;
+    content: string;
+    editable: boolean;
+    workspaceBusy: boolean;
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+## src/navigation/context-menu.ts
+
+### createContextMenu
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L7)
+
+```ts
+export declare function createContextMenu(options?: {
+    element?: HTMLElement;
+    onDismiss?: (restoreFocus: boolean) => void;
+    onAction?: (item: ContextMenuItem) => void;
+}): UIBlock<ContextMenuState> & {
+    open(trigger: HTMLElement, state: ContextMenuState): void;
+    close(restoreFocus?: boolean): void;
+};
+```
+
+Referenced public types and APIs: [`ContextMenuItem`](#contextmenuitem), [`ContextMenuState`](#contextmenustate), [`UIBlock`](#uiblock).
+
+Related gallery: [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu).
+
+### ContextMenuItem
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L2)
+
+```ts
+export interface ContextMenuItem {
+    label: string;
+    action?: string;
+    sdkAction?: string;
+    danger?: boolean;
+    disabled?: boolean;
+    idle?: {
+        conversationId?: string;
+        workspaceId?: string;
+    };
+}
+```
+
+### ContextMenuState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/context-menu.ts#L6)
+
+```ts
+export interface ContextMenuState {
+    label: string;
+    items: readonly ContextMenuItem[];
+}
+```
+
+Referenced public types and APIs: [`ContextMenuItem`](#contextmenuitem).
+
+## src/navigation/navigation.ts
+
+### createRenameConversation
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L63)
+
+```ts
+export declare function createRenameConversation(initial: RenameConversationState, options?: {
+    idPrefix?: string;
+}): UIBlock<RenameConversationState> & {
+    readonly input: HTMLInputElement;
+    readonly form: HTMLFormElement;
+};
+```
+
+Referenced public types and APIs: [`RenameConversationState`](#renameconversationstate), [`UIBlock`](#uiblock).
+
+Related gallery: [rename-conversation](https://minifish-org.github.io/pith-ui/?item=rename-conversation).
+
+### createWorkspaceNavigation
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L9)
+
+```ts
+export declare function createWorkspaceNavigation(initial: WorkspaceNavigationState, options?: {
+    element?: HTMLElement;
+    idPrefix?: string;
+    onToggle?: (id: string) => void;
+    onSelect?: (id: string) => void;
+}): UIBlock<WorkspaceNavigationState>;
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspaceNavigationState`](#workspacenavigationstate).
+
+Related gallery: [workspace-navigation](https://minifish-org.github.io/pith-ui/?item=workspace-navigation).
+
+### createWorkspacePicker
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L70)
+
+```ts
+export declare function createWorkspacePicker(initial: WorkspacePickerState, options?: {
+    idPrefix?: string;
+}): UIBlock<WorkspacePickerState> & {
+    readonly input: HTMLInputElement;
+    readonly form: HTMLFormElement;
+    readonly pickButton: HTMLButtonElement;
+};
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspacePickerState`](#workspacepickerstate).
+
+Related gallery: [workspace-picker](https://minifish-org.github.io/pith-ui/?item=workspace-picker).
+
+### NavigationConversation
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L4)
+
+```ts
+export interface NavigationConversation {
+    id: string;
+    title?: string;
+    active: boolean;
+    menuOpen?: boolean;
+    status?: Node | null;
+}
+```
+
+### NavigationWorkspace
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L5)
+
+```ts
+export interface NavigationWorkspace {
+    id: string;
+    name: string;
+    path: string;
+    expanded: boolean;
+    selected: boolean;
+    menuOpen?: boolean;
+    children: readonly NavigationConversation[];
+}
+```
+
+Referenced public types and APIs: [`NavigationConversation`](#navigationconversation).
+
+### RenameConversationState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L62)
+
+```ts
+export interface RenameConversationState {
+    id: string;
+    title: string;
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### WorkspaceNavigationState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L6)
+
+```ts
+export interface WorkspaceNavigationState {
+    groups: readonly NavigationWorkspace[];
+    empty: 'workspaces' | 'search' | null;
+    disabled?: boolean;
+}
+```
+
+Referenced public types and APIs: [`NavigationWorkspace`](#navigationworkspace).
+
+### WorkspacePickerState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/navigation/navigation.ts#L69)
+
+```ts
+export interface WorkspacePickerState {
+    workspaces: readonly {
+        id: string;
+        name: string;
+        path: string;
+    }[];
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+## src/primitives.ts
+
+### createActions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L346)
+
+```ts
+export declare function createActions(options?: ActionsState & {
+    children?: readonly Node[];
+}): UIBlock<ActionsState>;
+```
+
+Referenced public types and APIs: [`ActionsState`](#actionsstate), [`UIBlock`](#uiblock).
+
+Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions).
+
+### createButton
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L21)
+
+```ts
+export declare function createButton(options: ButtonOptions): ButtonBlock;
+```
+
+Referenced public types and APIs: [`ButtonBlock`](#buttonblock), [`ButtonOptions`](#buttonoptions).
+
+Related gallery: [actions](https://minifish-org.github.io/pith-ui/?item=actions), [button](https://minifish-org.github.io/pith-ui/?item=button), [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation), [context-menu](https://minifish-org.github.io/pith-ui/?item=context-menu), [conversation-reader](https://minifish-org.github.io/pith-ui/?item=conversation-reader), [copy-feedback](https://minifish-org.github.io/pith-ui/?item=copy-feedback), [dialog](https://minifish-org.github.io/pith-ui/?item=dialog), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback), [feature-dialog](https://minifish-org.github.io/pith-ui/?item=feature-dialog), [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [image-viewer](https://minifish-org.github.io/pith-ui/?item=image-viewer), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row), [resources-panel](https://minifish-org.github.io/pith-ui/?item=resources-panel), [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar).
+
+### createCheckbox
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L294)
+
+```ts
+export declare function createCheckbox(options: CheckboxState & {
+    checked?: boolean;
+    onChange?: (value: boolean) => void;
+}): CheckboxBlock;
+```
+
+Referenced public types and APIs: [`CheckboxBlock`](#checkboxblock), [`CheckboxState`](#checkboxstate).
+
+Related gallery: [checkbox](https://minifish-org.github.io/pith-ui/?item=checkbox), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion).
+
+### createCollectionState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L382)
+
+```ts
+export declare function createCollectionState(options: CollectionState & {
+    content?: Node;
+    onRetry?: UIAction;
+}): UIBlock<CollectionState>;
+```
+
+Referenced public types and APIs: [`CollectionState`](#collectionstate), [`UIAction`](#uiaction), [`UIBlock`](#uiblock).
+
+Related gallery: [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state).
+
+### createConfirmDialog
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L513)
+
+```ts
+export declare function createConfirmDialog(options: ConfirmState & {
+    dialog?: HTMLDialogElement;
+    ids?: {
+        form?: string;
+        error?: string;
+        title?: string;
+        cancel?: string;
+    };
+    unavailable?: () => boolean;
+    onConfirm: () => Promise<ActionResult> | ActionResult;
+    onClose?: () => void;
+}): ConfirmBlock;
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`ConfirmBlock`](#confirmblock), [`ConfirmState`](#confirmstate).
+
+Related gallery: [confirmation](https://minifish-org.github.io/pith-ui/?item=confirmation).
+
+### createDialog
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L404)
+
+```ts
+export declare function createDialog(options: DialogOptions): DialogBlock;
+```
+
+Referenced public types and APIs: [`DialogBlock`](#dialogblock), [`DialogOptions`](#dialogoptions).
+
+Related gallery: [dialog](https://minifish-org.github.io/pith-ui/?item=dialog).
+
+### createDisclosure
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L353)
+
+```ts
+export declare function createDisclosure(options: DisclosureState & {
+    content: Node;
+    open?: boolean;
+    onToggle?: (open: boolean) => void;
+}): DisclosureBlock;
+```
+
+Referenced public types and APIs: [`DisclosureBlock`](#disclosureblock), [`DisclosureState`](#disclosurestate).
+
+Related gallery: [disclosure](https://minifish-org.github.io/pith-ui/?item=disclosure).
+
+### createDivider
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L100)
+
+```ts
+export declare function createDivider(state?: {
+    label?: string;
+}): UIBlock<{
+    label?: string;
+}>;
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock).
+
+Related gallery: [divider](https://minifish-org.github.io/pith-ui/?item=divider).
+
+### createField
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L146)
+
+```ts
+export declare function createField(options: FieldState & {
+    control: FieldBlock['control'];
+}): FieldBlock;
+```
+
+Referenced public types and APIs: [`FieldBlock`](#fieldblock), [`FieldState`](#fieldstate).
+
+Related gallery: [number-input](https://minifish-org.github.io/pith-ui/?item=number-input), [search-input](https://minifish-org.github.io/pith-ui/?item=search-input), [secret-input](https://minifish-org.github.io/pith-ui/?item=secret-input), [text-area](https://minifish-org.github.io/pith-ui/?item=text-area), [text-input](https://minifish-org.github.io/pith-ui/?item=text-input).
+
+### createFormSection
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L338)
+
+```ts
+export declare function createFormSection(options: FormSectionState & {
+    content?: Node;
+}): UIBlock<FormSectionState>;
+```
+
+Referenced public types and APIs: [`FormSectionState`](#formsectionstate), [`UIBlock`](#uiblock).
+
+Related gallery: [form-section](https://minifish-org.github.io/pith-ui/?item=form-section).
+
+### createIcon
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L89)
+
+```ts
+export declare function createIcon(state: IconState): UIBlock<IconState>;
+```
+
+Referenced public types and APIs: [`IconState`](#iconstate), [`UIBlock`](#uiblock).
+
+Related gallery: [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [icons](https://minifish-org.github.io/pith-ui/?item=icons).
+
+### createIconButton
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L67)
+
+```ts
+export declare function createIconButton(options: ButtonOptions & {
+    icon: string;
+}): ButtonBlock;
+```
+
+Referenced public types and APIs: [`ButtonBlock`](#buttonblock), [`ButtonOptions`](#buttonoptions).
+
+Related gallery: [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar).
+
+### createKeyValue
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L107)
+
+```ts
+export declare function createKeyValue(options: KeyValueState): UIBlock<KeyValueState>;
+```
+
+Referenced public types and APIs: [`KeyValueState`](#keyvaluestate), [`UIBlock`](#uiblock).
+
+Related gallery: [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [key-value](https://minifish-org.github.io/pith-ui/?item=key-value).
+
+### createListRow
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L367)
+
+```ts
+export declare function createListRow(options: ListRowState & {
+    actions?: Node;
+}): UIBlock<ListRowState>;
+```
+
+Referenced public types and APIs: [`ListRowState`](#listrowstate), [`UIBlock`](#uiblock).
+
+Related gallery: [collection-state](https://minifish-org.github.io/pith-ui/?item=collection-state), [list-row](https://minifish-org.github.io/pith-ui/?item=list-row).
+
+### createMenu
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L585)
+
+```ts
+export declare function createMenu(options: MenuState): PopoverBlock & UIBlock<MenuState>;
+```
+
+Referenced public types and APIs: [`MenuState`](#menustate), [`PopoverBlock`](#popoverblock), [`UIBlock`](#uiblock).
+
+Related gallery: [menu](https://minifish-org.github.io/pith-ui/?item=menu).
+
+### createNotice
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L310)
+
+```ts
+export declare function createNotice(state: NoticeState): UIBlock<NoticeState>;
+```
+
+Referenced public types and APIs: [`NoticeState`](#noticestate), [`UIBlock`](#uiblock).
+
+Related gallery: [notice](https://minifish-org.github.io/pith-ui/?item=notice).
+
+### createNumberInput
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L225)
+
+```ts
+export declare const createNumberInput: (options: InputOptions) => InputBlock;
+```
+
+Referenced public types and APIs: [`InputBlock`](#inputblock), [`InputOptions`](#inputoptions).
+
+Related gallery: [number-input](https://minifish-org.github.io/pith-ui/?item=number-input).
+
+### createPopover
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L560)
+
+```ts
+export declare function createPopover(options: PopoverState & {
+    content: Node;
+    onToggle?: (open: boolean) => void;
+}): PopoverBlock;
+```
+
+Referenced public types and APIs: [`PopoverBlock`](#popoverblock), [`PopoverState`](#popoverstate).
+
+Related gallery: [popover](https://minifish-org.github.io/pith-ui/?item=popover).
+
+### createProgress
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L327)
+
+```ts
+export declare function createProgress(state: ProgressState): UIBlock<ProgressState>;
+```
+
+Referenced public types and APIs: [`ProgressState`](#progressstate), [`UIBlock`](#uiblock).
+
+Related gallery: [progress](https://minifish-org.github.io/pith-ui/?item=progress).
+
+### createScrollArea
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L129)
+
+```ts
+export declare function createScrollArea(options: ScrollAreaState & {
+    content: Node;
+}): UIBlock<ScrollAreaState>;
+```
+
+Referenced public types and APIs: [`ScrollAreaState`](#scrollareastate), [`UIBlock`](#uiblock).
+
+Related gallery: [scroll-area](https://minifish-org.github.io/pith-ui/?item=scroll-area).
+
+### createSearchInput
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L224)
+
+```ts
+export declare const createSearchInput: (options: InputOptions) => InputBlock;
+```
+
+Referenced public types and APIs: [`InputBlock`](#inputblock), [`InputOptions`](#inputoptions).
+
+Related gallery: [search-input](https://minifish-org.github.io/pith-ui/?item=search-input).
+
+### createSecretInput
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L228)
+
+```ts
+export declare function createSecretInput(options: InputOptions): InputBlock;
+```
+
+Referenced public types and APIs: [`InputBlock`](#inputblock), [`InputOptions`](#inputoptions).
+
+Related gallery: [secret-input](https://minifish-org.github.io/pith-ui/?item=secret-input).
+
+### createSelect
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L256)
+
+```ts
+export declare function createSelect(options: SelectOptions): SelectBlock;
+```
+
+Referenced public types and APIs: [`SelectBlock`](#selectblock), [`SelectOptions`](#selectoptions).
+
+Related gallery: [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [select](https://minifish-org.github.io/pith-ui/?item=select).
+
+### createStatus
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L321)
+
+```ts
+export declare function createStatus(state: StatusState): UIBlock<StatusState>;
+```
+
+Referenced public types and APIs: [`StatusState`](#statusstate), [`UIBlock`](#uiblock).
+
+Related gallery: [status](https://minifish-org.github.io/pith-ui/?item=status).
+
+### createTextAction
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L80)
+
+```ts
+export declare function createTextAction(options: ButtonOptions): ButtonBlock;
+```
+
+Referenced public types and APIs: [`ButtonBlock`](#buttonblock), [`ButtonOptions`](#buttonoptions).
+
+Related gallery: [text-action](https://minifish-org.github.io/pith-ui/?item=text-action).
+
+### createTextArea
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L226)
+
+```ts
+export declare const createTextArea: (options: InputOptions) => InputBlock;
+```
+
+Referenced public types and APIs: [`InputBlock`](#inputblock), [`InputOptions`](#inputoptions).
+
+Related gallery: [foundation-typography](https://minifish-org.github.io/pith-ui/?item=foundation-typography), [text-area](https://minifish-org.github.io/pith-ui/?item=text-area).
+
+### createTextEditDialog
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L462)
+
+```ts
+export declare function createTextEditDialog(options?: TextEditOptions): TextEditBlock;
+```
+
+Referenced public types and APIs: [`TextEditBlock`](#texteditblock), [`TextEditOptions`](#texteditoptions).
+
+Related gallery: [pending-messages](https://minifish-org.github.io/pith-ui/?item=pending-messages), [text-edit-dialog](https://minifish-org.github.io/pith-ui/?item=text-edit-dialog).
+
+### createTextInput
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L223)
+
+```ts
+export declare const createTextInput: (options: InputOptions) => InputBlock;
+```
+
+Referenced public types and APIs: [`InputBlock`](#inputblock), [`InputOptions`](#inputoptions).
+
+Related gallery: [form-section](https://minifish-org.github.io/pith-ui/?item=form-section), [foundation-focus](https://minifish-org.github.io/pith-ui/?item=foundation-focus), [foundation-sizing](https://minifish-org.github.io/pith-ui/?item=foundation-sizing), [popover](https://minifish-org.github.io/pith-ui/?item=popover), [text-input](https://minifish-org.github.io/pith-ui/?item=text-input).
+
+### createToolbar
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L122)
+
+```ts
+export declare function createToolbar(options: ToolbarState & {
+    children?: readonly Node[];
+}): UIBlock<ToolbarState>;
+```
+
+Referenced public types and APIs: [`ToolbarState`](#toolbarstate), [`UIBlock`](#uiblock).
+
+Related gallery: [button](https://minifish-org.github.io/pith-ui/?item=button), [foundation-motion](https://minifish-org.github.io/pith-ui/?item=foundation-motion), [foundation-spacing](https://minifish-org.github.io/pith-ui/?item=foundation-spacing), [icon-button](https://minifish-org.github.io/pith-ui/?item=icon-button), [icons](https://minifish-org.github.io/pith-ui/?item=icons), [toolbar](https://minifish-org.github.io/pith-ui/?item=toolbar).
+
+### ActionsState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L345)
+
+```ts
+export interface ActionsState {
+    align?: 'start' | 'end' | 'between';
+}
+```
+
+### ButtonBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L19)
+
+```ts
+export interface ButtonBlock extends UIBlock<ButtonState> {
+    readonly element: HTMLButtonElement;
+}
+```
+
+Referenced public types and APIs: [`ButtonState`](#buttonstate), [`UIBlock`](#uiblock).
+
+### ButtonOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L14)
+
+```ts
+export interface ButtonOptions extends ButtonState {
+    type?: 'button' | 'submit' | 'reset';
+    onAction?: UIAction;
+    onError?: (message: string) => void;
+}
+```
+
+Referenced public types and APIs: [`ButtonState`](#buttonstate), [`UIAction`](#uiaction).
+
+### ButtonState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L5)
+
+```ts
+export interface ButtonState {
+    label: string;
+    intent?: Intent;
+    density?: Density;
+    disabled?: boolean;
+    pending?: boolean;
+    icon?: string;
+    title?: string;
+}
+```
+
+Referenced public types and APIs: [`Density`](#density), [`Intent`](#intent).
+
+### CheckboxBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L288)
+
+```ts
+export interface CheckboxBlock extends UIBlock<CheckboxState> {
+    readonly control: HTMLInputElement;
+    getValue(): boolean;
+    reset(value: boolean): void;
+    focus(): void;
+}
+```
+
+Referenced public types and APIs: [`CheckboxState`](#checkboxstate), [`UIBlock`](#uiblock).
+
+### CheckboxState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L287)
+
+```ts
+export interface CheckboxState {
+    label: string;
+    description?: string;
+    disabled?: boolean;
+}
+```
+
+### CollectionState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L381)
+
+```ts
+export interface CollectionState {
+    status: 'ready' | 'loading' | 'empty' | 'error';
+    message?: string;
+    retryLabel?: string;
+}
+```
+
+### ConfirmBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L512)
+
+```ts
+export interface ConfirmBlock extends UIBlock<ConfirmState> {
+    readonly element: HTMLDialogElement;
+    readonly confirmButton: HTMLButtonElement;
+    readonly cancelButton: HTMLButtonElement;
+    open(state?: ConfirmState): void;
+    close(): void;
+}
+```
+
+Referenced public types and APIs: [`ConfirmState`](#confirmstate), [`UIBlock`](#uiblock).
+
+### ConfirmState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L511)
+
+```ts
+export interface ConfirmState extends DialogState {
+    message?: string | Node;
+    hint?: string;
+    error?: string;
+    disabled?: boolean;
+    pending?: boolean;
+    confirmLabel?: string;
+}
+```
+
+Referenced public types and APIs: [`DialogState`](#dialogstate).
+
+### DialogBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L398)
+
+```ts
+export interface DialogBlock extends UIBlock<DialogState> {
+    readonly element: HTMLDialogElement;
+    readonly body: HTMLElement;
+    open(): void;
+    close(): void;
+}
+```
+
+Referenced public types and APIs: [`DialogState`](#dialogstate), [`UIBlock`](#uiblock).
+
+### DialogOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L397)
+
+```ts
+export interface DialogOptions extends DialogState {
+    dialog?: HTMLDialogElement;
+    content?: Node;
+    actions?: Node;
+    closeOnBackdrop?: boolean;
+    onClose?: () => void;
+}
+```
+
+Referenced public types and APIs: [`DialogState`](#dialogstate).
+
+### DialogState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L396)
+
+```ts
+export interface DialogState {
+    title: string;
+    description?: string;
+    eyebrow?: string;
+    closeDisabled?: boolean;
+}
+```
+
+### DisclosureBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L352)
+
+```ts
+export interface DisclosureBlock extends UIBlock<DisclosureState> {
+    setOpen(open: boolean): void;
+    isOpen(): boolean;
+}
+```
+
+Referenced public types and APIs: [`DisclosureState`](#disclosurestate), [`UIBlock`](#uiblock).
+
+### DisclosureState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L351)
+
+```ts
+export interface DisclosureState {
+    title: string;
+    description?: string;
+    disabled?: boolean;
+}
+```
+
+### FieldBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L142)
+
+```ts
+export interface FieldBlock extends UIBlock<FieldState> {
+    readonly control: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+}
+```
+
+Referenced public types and APIs: [`FieldState`](#fieldstate), [`UIBlock`](#uiblock).
+
+### FieldState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L135)
+
+```ts
+export interface FieldState {
+    label: string;
+    description?: string;
+    error?: string;
+    required?: boolean;
+    disabled?: boolean;
+}
+```
+
+### FormSectionState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L337)
+
+```ts
+export interface FormSectionState {
+    title: string;
+    description?: string;
+}
+```
+
+### IconState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L88)
+
+```ts
+export interface IconState {
+    name: string;
+    label?: string;
+    size?: 'small' | 'normal';
+}
+```
+
+### InputBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L191)
+
+```ts
+export interface InputBlock extends UIBlock<InputState> {
+    readonly control: HTMLInputElement | HTMLTextAreaElement;
+    getValue(): string;
+    reset(value: string): void;
+    focus(): void;
+}
+```
+
+Referenced public types and APIs: [`InputState`](#inputstate), [`UIBlock`](#uiblock).
+
+### InputOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L182)
+
+```ts
+export interface InputOptions extends InputState {
+    value?: string;
+    onInput?: (value: string, event: Event) => void;
+    onChange?: (value: string, event: Event) => void;
+    autocomplete?: string;
+    min?: number;
+    max?: number;
+    step?: number | 'any';
+}
+```
+
+Referenced public types and APIs: [`InputState`](#inputstate).
+
+### InputState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L177)
+
+```ts
+export interface InputState extends FieldState {
+    placeholder?: string;
+    readOnly?: boolean;
+    density?: Density;
+}
+```
+
+Referenced public types and APIs: [`Density`](#density), [`FieldState`](#fieldstate).
+
+### KeyValueState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L106)
+
+```ts
+export interface KeyValueState {
+    items: readonly {
+        key: string;
+        label: string;
+        value: string;
+    }[];
+}
+```
+
+### ListRowState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L366)
+
+```ts
+export interface ListRowState {
+    title: string;
+    description?: string;
+    meta?: string;
+    selected?: boolean;
+    icon?: string;
+}
+```
+
+### MenuItem
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L583)
+
+```ts
+export interface MenuItem {
+    id: string;
+    label: string;
+    disabled?: boolean;
+    intent?: Intent;
+    checked?: boolean;
+    onAction: UIAction;
+}
+```
+
+Referenced public types and APIs: [`Intent`](#intent), [`UIAction`](#uiaction).
+
+### MenuState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L584)
+
+```ts
+export interface MenuState extends PopoverState {
+    items: readonly MenuItem[];
+}
+```
+
+Referenced public types and APIs: [`MenuItem`](#menuitem), [`PopoverState`](#popoverstate).
+
+### NoticeState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L309)
+
+```ts
+export interface NoticeState {
+    message: string;
+    tone?: 'info' | 'success' | 'warning' | 'error';
+}
+```
+
+### PopoverBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L553)
+
+```ts
+export interface PopoverBlock extends UIBlock<PopoverState> {
+    readonly trigger: HTMLButtonElement;
+    readonly panel: HTMLElement;
+    open(): void;
+    close(): void;
+    isOpen(): boolean;
+}
+```
+
+Referenced public types and APIs: [`PopoverState`](#popoverstate), [`UIBlock`](#uiblock).
+
+### PopoverState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L552)
+
+```ts
+export interface PopoverState {
+    label: string;
+    disabled?: boolean;
+}
+```
+
+### ProgressState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L326)
+
+```ts
+export interface ProgressState {
+    label: string;
+    value?: number;
+    max?: number;
+}
+```
+
+### ScrollAreaState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L128)
+
+```ts
+export interface ScrollAreaState {
+    label: string;
+    size?: 'small' | 'medium' | 'fill';
+}
+```
+
+### SelectBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L250)
+
+```ts
+export interface SelectBlock extends UIBlock<SelectState> {
+    readonly control: HTMLSelectElement;
+    getValue(): string;
+    reset(value: string): void;
+    focus(): void;
+}
+```
+
+Referenced public types and APIs: [`SelectState`](#selectstate), [`UIBlock`](#uiblock).
+
+### SelectOption
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L247)
+
+```ts
+export interface SelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+```
+
+### SelectOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L249)
+
+```ts
+export interface SelectOptions extends SelectState {
+    value?: string;
+    onChange?: (value: string) => void;
+    multiple?: boolean;
+    size?: number;
+}
+```
+
+Referenced public types and APIs: [`SelectState`](#selectstate).
+
+### SelectState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L248)
+
+```ts
+export interface SelectState extends FieldState {
+    options: readonly SelectOption[];
+    density?: Density;
+}
+```
+
+Referenced public types and APIs: [`Density`](#density), [`FieldState`](#fieldstate), [`SelectOption`](#selectoption).
+
+### StatusState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L320)
+
+```ts
+export interface StatusState {
+    label: string;
+    tone?: 'neutral' | 'success' | 'warning' | 'error';
+}
+```
+
+### TextEditBlock
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L453)
+
+```ts
+export interface TextEditBlock extends Omit<UIBlock<TextEditState>, 'element'> {
+    readonly element: HTMLDialogElement;
+    readonly control: HTMLTextAreaElement;
+    readonly submitButton: HTMLButtonElement;
+    open(input: TextEditInput): void;
+    close(): void;
+    getValue(): string;
+    focus(): void;
+}
+```
+
+Referenced public types and APIs: [`TextEditInput`](#texteditinput), [`TextEditState`](#texteditstate), [`UIBlock`](#uiblock).
+
+### TextEditInput
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L444)
+
+```ts
+export interface TextEditInput {
+    value: string;
+    title?: string;
+    description?: string;
+    note?: string;
+}
+```
+
+### TextEditOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L445)
+
+```ts
+export interface TextEditOptions extends Partial<TextEditState> {
+    dialog?: HTMLDialogElement;
+    ids?: {
+        form?: string;
+        control?: string;
+        submit?: string;
+        error?: string;
+        title?: string;
+        cancel?: string;
+    };
+    label?: string;
+    onInput?: (value: string) => void;
+    onSubmit?: (text: string) => Promise<ActionResult> | ActionResult;
+    onClose?: () => void;
+}
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult), [`TextEditState`](#texteditstate).
+
+### TextEditState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L443)
+
+```ts
+export interface TextEditState extends DialogState {
+    error?: string;
+    disabled?: boolean;
+    pending?: boolean;
+    inputDisabled?: boolean;
+    note?: string;
+    submitLabel?: string;
+}
+```
+
+Referenced public types and APIs: [`DialogState`](#dialogstate).
+
+### ToolbarState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/primitives.ts#L121)
+
+```ts
+export interface ToolbarState {
+    label: string;
+    density?: Density;
+}
+```
+
+Referenced public types and APIs: [`Density`](#density).
+
+## src/tasks/approval.ts
+
+### createApprovalPanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L7)
+
+```ts
+export declare function createApprovalPanel(initial: ApprovalPanelState, options?: {
+    element?: HTMLElement;
+    idPrefix?: string;
+    onAction?: (id: string, action: 'deny' | 'always' | 'allow') => void;
+}): UIBlock<ApprovalPanelState>;
+```
+
+Referenced public types and APIs: [`ApprovalPanelState`](#approvalpanelstate), [`UIBlock`](#uiblock).
+
+Related gallery: [approval-panel](https://minifish-org.github.io/pith-ui/?item=approval-panel).
+
+### ApprovalPanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L6)
+
+```ts
+export interface ApprovalPanelState {
+    approval: ApprovalView | null;
+    disabled?: boolean;
+}
+```
+
+Referenced public types and APIs: [`ApprovalView`](#approvalview).
+
+### ApprovalView
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/approval.ts#L5)
+
+```ts
+export interface ApprovalView {
+    id: string;
+    toolName: string;
+    warning?: string;
+    canAlwaysAllow: boolean;
+    argsText: string;
+    preview?: {
+        kind: string;
+        path: string;
+        error?: string;
+        diff?: string;
+        truncated?: boolean;
+    };
+}
+```
+
+## src/tasks/permission.ts
+
+### createFullAccessConfirmation
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L5)
+
+```ts
+export declare function createFullAccessConfirmation(initial: FullAccessState, options?: {
+    idPrefix?: string;
+}): UIBlock<FullAccessState> & {
+    readonly confirmButton: HTMLButtonElement;
+};
+```
+
+Referenced public types and APIs: [`FullAccessState`](#fullaccessstate), [`UIBlock`](#uiblock).
+
+Related gallery: [full-access-confirmation](https://minifish-org.github.io/pith-ui/?item=full-access-confirmation).
+
+### createPermissionControl
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L19)
+
+```ts
+export declare function createPermissionControl(initial: PermissionControlState, options?: {
+    element?: HTMLElement;
+    descriptionElement?: HTMLElement;
+    onChange?: (value: string) => void;
+}): UIBlock<PermissionControlState>;
+```
+
+Referenced public types and APIs: [`PermissionControlState`](#permissioncontrolstate), [`UIBlock`](#uiblock).
+
+Related gallery: [permission-control](https://minifish-org.github.io/pith-ui/?item=permission-control).
+
+### createTaskFailure
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L12)
+
+```ts
+export declare function createTaskFailure(initial: TaskFailureState, options?: {
+    element?: HTMLElement;
+    onContinue?: () => void;
+    onSettings?: () => void;
+    onDiagnostics?: () => void;
+}): UIBlock<TaskFailureState>;
+```
+
+Referenced public types and APIs: [`TaskFailureState`](#taskfailurestate), [`UIBlock`](#uiblock).
+
+Related gallery: [task-failure](https://minifish-org.github.io/pith-ui/?item=task-failure).
+
+### FullAccessState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L4)
+
+```ts
+export interface FullAccessState {
+    title?: string;
+    error?: string;
+    disabled?: boolean;
+}
+```
+
+### PermissionControlState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L18)
+
+```ts
+export interface PermissionControlState {
+    mode: string;
+    description: string;
+    disabled?: boolean;
+}
+```
+
+### TaskFailureState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/permission.ts#L11)
+
+```ts
+export interface TaskFailureState {
+    visible: boolean;
+    message: string;
+    advice: string;
+    canContinue: boolean;
+    workspaceId?: string;
+}
+```
+
+## src/tasks/runtime.ts
+
+### createRuntimePanel
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/runtime.ts#L5)
+
+```ts
+export declare function createRuntimePanel(initial: RuntimePanelState, options?: {
+    element?: HTMLElement;
+    idPrefix?: string;
+    costs?: Node;
+}): UIBlock<RuntimePanelState> & {
+    updateTiming(value: {
+        summary: string;
+        duration: string;
+        speed: string;
+    }): void;
+};
+```
+
+Referenced public types and APIs: [`RuntimePanelState`](#runtimepanelstate), [`UIBlock`](#uiblock).
+
+Related gallery: [runtime-panel](https://minifish-org.github.io/pith-ui/?item=runtime-panel).
+
+### RuntimePanelState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/tasks/runtime.ts#L4)
+
+```ts
+export interface RuntimePanelState {
+    visible: boolean;
+    summary: string;
+    duration: string;
+    speed: string;
+    provider?: string;
+    thinkingLevel?: string;
+    inputTokens: string;
+    outputTokens: string;
+    cacheRead: string;
+    cacheWrite: string;
+    contextTokens: string;
+    contextWindow: string;
+    compactions: string;
+    toolFailures: string;
+    recordedCost: string;
+    latestCost: string;
+}
+```
+
+## src/theme.ts
+
+### Appearance
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/theme.ts#L1)
+
+```ts
+export type Appearance = 'light' | 'dark' | 'system';
+```
+
+### setAppearance
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/theme.ts#L3)
+
+```ts
+/** Scope tokens and styles to an explicit application or preview root. */
+export declare function setAppearance(root: HTMLElement, appearance?: Appearance): void;
+```
+
+Referenced public types and APIs: [`Appearance`](#appearance).
+
+Related gallery: [foundation-colors](https://minifish-org.github.io/pith-ui/?item=foundation-colors), [foundation-surfaces](https://minifish-org.github.io/pith-ui/?item=foundation-surfaces).
+
+## src/workspace.ts
+
+### createComposerView
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L14)
+
+```ts
+export declare function createComposerView(options?: ComposerViewOptions): {
+    element: HTMLFormElement;
+    input: HTMLTextAreaElement;
+    update: (state: ComposerViewState) => void;
+    getValue: () => string;
+    reset(value: string): void;
+    focus: () => void;
+    resize: () => void;
+    destroy(): void;
+};
+```
+
+Referenced public types and APIs: [`ComposerViewOptions`](#composerviewoptions), [`ComposerViewState`](#composerviewstate).
+
+Related gallery: [composer](https://minifish-org.github.io/pith-ui/?item=composer), [drop-feedback](https://minifish-org.github.io/pith-ui/?item=drop-feedback).
+
+### createWorkspaceShell
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L67)
+
+```ts
+export declare function createWorkspaceShell(options: WorkspaceShellOptions): UIBlock<WorkspaceShellState> & {
+    composer: ReturnType<typeof createComposerView>;
+    part<T extends HTMLElement = HTMLElement>(name: string): T;
+};
+```
+
+Referenced public types and APIs: [`UIBlock`](#uiblock), [`WorkspaceShellOptions`](#workspaceshelloptions), [`WorkspaceShellState`](#workspaceshellstate), [`createComposerView`](#createcomposerview).
+
+Related gallery: [workspace-chat](https://minifish-org.github.io/pith-ui/?item=workspace-chat).
+
+### ComposerViewOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L5)
+
+```ts
+export interface ComposerViewOptions {
+    prefix?: string;
+    onSubmit?: (text: string) => void | ActionResult | Promise<void | ActionResult>;
+    onStop?: () => void | ActionResult | Promise<void | ActionResult>;
+    onInput?: (text: string) => void;
+}
+```
+
+Referenced public types and APIs: [`ActionResult`](#actionresult).
+
+### ComposerViewState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L4)
+
+```ts
+export interface ComposerViewState {
+    placeholder?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    action?: 'send' | 'queue' | 'stop';
+    actionDisabled?: boolean;
+}
+```
+
+### WorkspaceShellOptions
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L65)
+
+```ts
+export interface WorkspaceShellOptions {
+    brand: Node;
+    prefix?: string;
+}
+```
+
+### WorkspaceShellState
+
+[Source](https://github.com/minifish-org/pith-ui/blob/main/src/workspace.ts#L66)
+
+```ts
+export interface WorkspaceShellState {
+    workspace?: string;
+    conversation?: string;
+    reconnecting?: boolean;
+}
+```