@makinbakin/sdk 0.0.1-rc.3 → 0.0.1-rc.30

package/README.md

@@ -86,6 +86,7 @@ component for a slot via `registerPlugin({ slots: { 'slot-name': Component } })`
 | `task-assets`         | Task drawer, asset attachments section                   |
 | `task-sidebar`        | Task drawer sidebar (custom panels for a plugin's tasks) |
 | `home-widget`         | Dashboard home widget grid                               |
+| `nav-badge-providers` | Background hook runners (render `null`) that drive `setNavBadge` |
 | `page:/<route>`       | Full-page mount at `<route>`                             |
 
 ## Sub-path imports
@@ -95,16 +96,260 @@ The public npm package exposes these sub-paths:
 | Import path              | What it exposes                              |
 | ------------------------ | -------------------------------------------- |
 | `@makinbakin/sdk` | Plugin registration, route helpers, top-level exports |
-| `@makinbakin/sdk/ui` | Base UI components |
+| `@makinbakin/sdk/ui` | Supported Bakin UI primitives and semantic style helpers |
+| `@makinbakin/sdk/layout` | Canonical page and responsive composition |
+| `@makinbakin/sdk/patterns` | Reusable application-aware UI patterns |
+| `@makinbakin/sdk/charts` | Isolated data-visualization components |
+| `@makinbakin/sdk/conversation` | Isolated conversation UI and models |
+| `@makinbakin/sdk/content` | Opt-in rich content rendering and editing |
 | `@makinbakin/sdk/hooks` | Shared React hooks |
-| `@makinbakin/sdk/components` | Higher-level shell components |
+| `@makinbakin/sdk/components` | Migration-only legacy component barrel |
 | `@makinbakin/sdk/slots` | Slot runtime and provider |
 | `@makinbakin/sdk/types` | TypeScript contract types |
 | `@makinbakin/sdk/utils` | Shared utilities |
 | `@makinbakin/sdk/metadata` | Docs-aware contract metadata helpers |
 | `@makinbakin/sdk/routing` | Typed declarative route helpers |
+| `@makinbakin/sdk/navigation` | Browser links, URL state, history, and dirty-exit guards |
+| `@makinbakin/sdk/testing/ui` | Deterministic browser fixture host for plugin pages and slots |
+| `@makinbakin/sdk/testing/ui/conformance` | Plugin UI test config, reports, CSS gate, and runner |
+| `@makinbakin/sdk/styles.css` | Canonical compiled design-system stylesheet |
 
-Use `@makinbakin/sdk/*` imports for external plugin code.
+Use the focused entrypoints for new plugin UI and browser navigation. Existing
+`@makinbakin/sdk/components` consumers migrate as their replacement exports
+land; do not add new dependencies on that legacy barrel.
+
+## Browser UI fixtures
+
+Use `PluginUiFixtureHost` from `@makinbakin/sdk/testing/ui` to exercise a
+plugin's real client registration without a Bakin account, host database, or
+live service. The browser-only entrypoint mounts registered pages and slots
+through the production route matcher, ownership wrappers, and SDK portal
+roots. It also provides deterministic time, random values, UUIDs, theme,
+motion preferences, routes, and explicit network responses.
+
+```tsx
+import '@makinbakin/sdk/styles.css'
+import { PluginUiFixtureHost } from '@makinbakin/sdk/testing/ui'
+import { pluginRegistration } from './client-registration'
+
+export function PluginPreview() {
+  return (
+    <PluginUiFixtureHost
+      registrations={[pluginRegistration]}
+      fixture={{
+        fixedNow: '2026-01-15T12:00:00.000Z',
+        route: '/bookmarks?tag=release',
+        randomSeed: 'bookmarks-preview',
+        colorScheme: 'dark',
+        reducedMotion: true,
+        viewport: 'desktop',
+        network: [{ path: '/api/plugins/bookmarks', status: 200, json: { bookmarks: [] } }],
+      }}
+      slots={[{ name: 'home-widget', label: 'Home widget contributions' }]}
+    />
+  )
+}
+```
+
+Import the canonical stylesheet exactly once at the preview root; installed
+plugin clients still leave stylesheet loading to Bakin. Apply the matching
+`PLUGIN_UI_VIEWPORTS.desktop` or `.mobile` dimensions in the browser runner—the
+fixture's viewport field freezes responsive preferences and records intent but
+cannot resize the browser from inside React. Unlisted requests fail loudly so
+fixtures cannot silently depend on a developer machine or user state.
+
+Add the one-command conformance suite to a client-bearing plugin package:
+
+```json
+{
+  "scripts": { "test:ui": "bakin-plugin-test-ui" },
+  "devDependencies": {
+    "axe-core": "^4.12.0",
+    "playwright": "^1.60.0"
+  }
+}
+```
+
+Install the browser once with `bunx playwright install chromium`.
+
+Then define the package-root fixture in `bakin.ui-test.ts`:
+
+```ts
+import { definePluginUiConformance } from '@makinbakin/sdk/testing/ui/conformance'
+
+export default definePluginUiConformance({
+  pluginId: 'bookmarks',
+  fixtureEntry: './tests/ui.fixture.tsx',
+})
+```
+
+`bun run test:ui` builds that real fixture, verifies CSS ownership and exactly
+one canonical stylesheet import, then runs axe, keyboard/focus, overflow, and
+browser-error checks in 1440×900 and 320×800 Chromium viewports. It writes
+machine-readable JSON, a self-contained HTML report, and both screenshots to
+`test-results/bakin-ui/`. CSS scope and stylesheet identity are reusable
+package/install blockers; broader browser findings gate CI or release without
+changing runtime installation policy.
+
+The prerelease migration surface is machine-inventoried in
+[`design-system/public-api.json`](https://github.com/markhayden/bakin/blob/main/design-system/public-api.json).
+Any value or type addition, removal, or entrypoint ownership change requires an
+explicit inventory review. The legacy components symbol set is frozen: it may
+shrink during migration but must not receive new exports.
+
+Action and status UI starts with `Button`, `Badge`, `Alert`, and `Progress`.
+Choose their semantic `variant`, `tone`, and `size` props instead of recreating
+colors or dimensions in plugin CSS. The `buttonVariants` and `badgeVariants`
+helpers are supported when a link or render integration needs the same visual
+treatment while preserving its native element semantics.
+
+Routine forms compose `Field`, `FieldLabel`, `FieldDescription`, `FieldError`,
+and SDK controls inside `Form`. Use `Fieldset` for related choices and finish
+with `FormActions` plus `SubmitButton`; the form's `busy` prop marks submission
+and prevents duplicate saves. Form-state libraries may manage values and dirty
+state, but the SDK components continue to own labels, errors, spacing, and
+actions.
+
+Data-driven surfaces use `SystemState` for initial-empty, filtered no-results,
+loading, recoverable or terminal error, and permission-denied states. A
+no-results state requires a clear/adjust action; a recoverable error requires a
+recovery action. Use `Banner` for persistent page context. Plugins call
+`toast()` from `@makinbakin/sdk/hooks` for transient outcomes and leave the
+shell-owned `ToastRegion` to Bakin.
+
+Routed indexes and record pages compose from `@makinbakin/sdk/patterns`.
+`PageHeader` owns the single page heading and its responsive controls/action
+order. Use its `controls` slot for the canonical compact `SearchInput` and peer
+view navigation when they belong beside the primary action; the reserved
+search slot expands without repacking the desktop header row. Longer queries
+remain intact behind an ellipsis, and the pattern supplies its own accessible
+clear action instead of a browser-dependent native cancel control.
+`Page` owns the page canvas (width measure, density, scroll ownership);
+`PageControls` and `PageBody` keep query controls separate from the named
+result/state boundary, and `PageBody layout="aside"` composes a primary flow
+with an optional named `PageAside` that reflows below it. The recipes do not own
+data or routing: keep filters, search, tabs, pagination, and overlays in the
+existing `useQueryState` contract, and use `PluginLink` for client-routed page
+navigation. The host retains the `main` landmark and vertical page scroll.
+
+Settings and overview pages also compose the same archetype. A multi-category
+settings surface keeps a consumer-owned named category `nav` beside a
+`PageBody` region so the active form owns only its own feedback and
+replacement-state boundary. A dashboard is a named `PageBody gap="page"`
+overview canvas that consumers compose with `Section`, `Stack`, and `Grid`.
+Keep settings categories and dashboard view state in the existing query-state
+contract. Values, validation, dirty state, saves, telemetry, and domain actions
+remain consumer owned; avoid equal-weight card walls and nested page scrollers.
+
+Conversation pages use the default `Page` document scroll. Choose
+`scroll="contained"` only inside an explicitly bounded parent; then
+`PageTimeline` is the single named log scroller and the composer
+remains outside it. Render folded turns with `Conversation` from
+`@makinbakin/sdk/conversation`; its default `document` mode avoids creating a
+second scroller inside the page recipe. `mode="contained"` is reserved for a
+standalone conversation with an explicit height boundary. `ConversationEmptyState`
+renders starter suggestions only when their callback is supplied. Put `Composer`
+inside `PageComposer`; its stable `storageKey` scopes browser-local
+draft/history/resize preferences, while the consumer owns routing, upload requests,
+object-URL cleanup, persistence, and send mutations. Attachment `acceptedTypes`
+apply consistently to picker, paste, and drop. Pending uploads hold send, `busy`
+keeps typing live, and a stop control appears only when `onAbort` exists.
+`InspectorPanel` supplies named header/content/footer hierarchy beside a canvas
+or inside `Drawer`. Transport, server persistence, rich text, routing, selection,
+drawer focus, and domain mutations remain consumer owned.
+
+Workflow and action workspaces use `Page density="compact"` with a named
+`PageControls as="toolbar"`, a bounded `PageCanvas`, and a consumer-owned
+named actions group.
+Vertical is the default graph orientation; horizontal is an explicit option.
+The recipe supplies hierarchy and a bounded overflow region without importing
+React Flow or owning nodes, edges, selection, graph commands, persistence,
+drawers, or URL state. Use the existing routing contract for linkable selected
+nodes and view modes, and provide named non-drag actions for required graph
+operations.
+
+Consequential actions and staged drafts use `ConfirmDialog`, `DangerZone`,
+`SaveBar`, and `UnsavedChangesDialog` from `@makinbakin/sdk/patterns`.
+Consumers retain mutation, dirty, persistence, retry, and routing behavior;
+the patterns provide typed confirmation, busy/error presentation, responsive
+action placement, and the save/discard/stay decision. Keep normal links and
+query-only state changes on the existing SDK router contract.
+
+Filtering and view navigation use `FacetFilter`, `AgentFilter`,
+`SegmentedControl`, and `SortableHead` from the same focused patterns
+entrypoint, and page-section tabs use `Tabs` with
+`<TabsList variant="underline">` from `@makinbakin/sdk/ui`. These components
+own searchable counts, clearing, keyboard selection, linked-tab semantics,
+long-label overflow, and table sort semantics. Consumers still own values and routing: connect linkable filters and
+views to `useQueryArrayState` or `useQueryState` from
+`@makinbakin/sdk/hooks`. The public `AgentFilter` accepts presentation-ready
+options; host adapters may add app-owned agent metadata and avatars.
+
+Agent identity and assignment use the same focused patterns entrypoint.
+`AgentAvatar`, `AgentStatus`, and `AgentSelect` accept presentation-ready
+identity, status, agent, and team options; they never fetch the registry or
+team API. Status remains visible in text, and consumers keep assignment state,
+heartbeat timing, URL state, and persistence. Existing official surfaces may
+continue through the migration-only components adapters until fleet migration.
+
+Asset, model, and color choices use `AssetPicker`, `ModelSelect`, and
+`ColorPicker` from the focused patterns entrypoint. `AssetPicker` supports a
+controlled library dialog plus inline grid or list composition with exact
+loading, error, empty, and filtered states. Consumers own asset endpoints,
+uploads, eligibility, attachment mutations, and route state. `ModelSelect`
+groups presentation-ready catalog options by provider and exports the stable
+`DEFAULT_MODEL_VALUE` sentinel; consumers own catalog loading and persistence.
+`ColorPicker` provides labelled radio semantics and enabled-option keyboard
+movement while consumers own palette values and saving. Existing official
+surfaces may remain on the migration-only components adapters until their
+incremental migration.
+
+Schema-driven plugin forms use `PluginSettingsRenderer` from
+`@makinbakin/sdk/patterns`; the settings schema and field types are co-exported
+from that entrypoint. The renderer owns defaults, draft editing, validation,
+list-row controls, and accessible feedback placement. Consumers own loading,
+persistence, retry, route state, and the durable `busy`/`feedback` values that
+describe a save result. Official surfaces may continue through the app-aware
+components adapter until fleet migration.
+
+Compact task and workflow output uses `TurnOutputView`, `TurnToolChip`, and
+`foldTurnChunks` from `@makinbakin/sdk/conversation`. They share the canonical
+conversation fold and tool-row semantics, keep wide code output locally
+scrollable, and expose typed live, terminal, and error evidence. Markdown is
+plain safe text by default; consumers that need rich content provide
+`renderText`, normally with `MarkdownContent` from the opt-in
+`@makinbakin/sdk/content` entrypoint. The compatibility adapter retains the
+host's existing rich-Markdown behavior during migration.
+
+Compact display patterns use `StatusBadge` and `StatTile`. Status labels carry
+meaning without color, while optional icons remain decorative. Focused status
+tones use `attention` and `danger`; the legacy components adapter maps the old
+`warning` and `destructive` names during migration. `StatTile` is low-chrome by
+default, offers an explicit bounded `surface` variant, and exposes labelled
+progress values to assistive technology.
+
+## Stylesheet
+
+Bakin loads one shared copy of `@makinbakin/sdk/styles.css` for the host and all
+installed plugins. Do not import it from a plugin client entry or copy its
+contents into plugin-owned CSS.
+
+Standalone browser previews and test harnesses do not have the Bakin host, so
+they import the public artifact once at their application root:
+
+```ts
+import '@makinbakin/sdk/styles.css'
+```
+
+That package export is the exact compiled stylesheet used by the host and the
+public component catalog. Plugin-owned CSS remains for domain-specific styling
+and should be scoped to the plugin root.
+
+SDK dialogs, sheets, popovers, menus, selects, and tooltips automatically keep
+the host-injected plugin identity when their content is portalled. Plugin code
+uses the normal primitive APIs without adding ownership wrappers or custom
+portal containers for styling. Toast presentation remains host-owned; plugins
+request toasts through the SDK instead of mounting a toast region.
 
 ## Repository
 

package/_internal/app/components/agent-avatar.d.ts

@@ -7,5 +7,6 @@ interface AgentAvatarProps {
     status?: StatusValue;
     className?: string;
 }
-export declare function AgentAvatar({ agentId, size, showStatus, status, className, }: AgentAvatarProps): import("react/jsx-runtime").JSX.Element;
+/** Compatibility adapter that supplies registered-agent identity to the public presentation pattern. */
+export declare function AgentAvatar({ agentId, size, showStatus, status, className }: AgentAvatarProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/_internal/app/components/conversation/attention.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Conversation attention rules — ONE set of pure decisions for every
+ * conversational surface's badge provider (#703): what a turn's done/error
+ * means given where the user is looking. Providers execute the returned
+ * actions (toast/sound/OS notification/seen); this module never touches
+ * the DOM so the rules stay unit-testable. Generalized verbatim from the
+ * chat plugin's attention module (chat re-exports from here).
+ *
+ * Suppression rules (chat spec S6, now kit-wide):
+ * - Reply lands while the user is VIEWING that thread → no toast, no
+ *   sound, no OS notification (the conversation itself is the signal);
+ *   unread is cleared (the view fires seen).
+ * - Reply lands elsewhere in the app → toast + sound; the OS notification
+ *   is also requested — sendBrowserNotification suppresses itself when
+ *   the tab has focus, so it only fires when the user is in another app.
+ * - Aborted turns notify nothing — the user stopped it themselves.
+ */
+export interface ConversationDonePayload {
+    /** The thread key (chat: chatId; projects: projectId; …). */
+    key: string;
+    agentId: string;
+    preview?: string;
+    aborted?: boolean;
+}
+export interface ConversationAttentionContext {
+    /** The thread currently open in the UI, '' when none. */
+    visibleKey: string;
+    settings: {
+        sound: boolean;
+        toasts: boolean;
+    };
+}
+export interface AttentionActions {
+    toast: boolean;
+    sound: boolean;
+    /** Ask browser-notify (it self-suppresses while the tab is focused). */
+    browserNotification: boolean;
+    /** The user is looking at the thread — mark it seen instead of unread. */
+    markSeen: boolean;
+}
+export declare function attentionForDone(payload: ConversationDonePayload, ctx: ConversationAttentionContext): AttentionActions;
+/**
+ * The entity id the user is currently viewing, derived from a
+ * `<base>/<id>` URL path (list and excluded ids — e.g. a `/new` draft
+ * route — view no conversation, so they never suppress attention).
+ */
+export declare function visibleIdFromLocation(pathname: string, base: string, opts?: {
+    exclude?: readonly string[];
+}): string;
+/** Nav badge from unread totals + in-flight turns: count wins, dot while working. */
+export declare function badgeFor(totalUnread: number, inflightCount: number): {
+    count?: number;
+    tone: 'attention' | 'info';
+} | null;
+/** `(N) ` tab-title prefix management (idempotent). */
+export declare function withUnreadPrefix(title: string, totalUnread: number): string;

package/_internal/app/components/conversation/fold.d.ts

@@ -0,0 +1,3 @@
+/** @deprecated Import conversation models and folding from `@makinbakin/sdk/conversation`. */
+export { foldConversation } from '@makinbakin/sdk/conversation';
+export type { ConversationChunk, ConversationMessage, ConversationTextFormat, ConversationToolActivity, ConversationToolCall, ConversationTurn, DisplayAttachment, FoldOptions, TurnItem, TurnStatus, } from '@makinbakin/sdk/conversation';

package/_internal/app/components/conversation/notification-sound.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Reply chime — a soft two-tone WebAudio blip shared by every
+ * conversational surface's attention provider (moved from the chat plugin
+ * in #703; chat re-exports from here). Generated, not an asset: zero
+ * bundle weight, no file to embed, and the volume stays deliberately low
+ * (this is a nudge, not an alarm).
+ */
+export declare function playReplyChime(): void;

package/_internal/app/components/conversation/reply-toast.d.ts

@@ -0,0 +1,15 @@
+export declare function ConversationReplyToast({ agentId, title, preview, to, onNavigate, testId }: {
+    agentId: string;
+    /** e.g. "replied" / "replied in a project brainstorm" — prefixed with the agent's name. */
+    title: string;
+    preview?: string;
+    /** Internal route to navigate to on click (router push, never a reload). */
+    to: string;
+    /** Called before navigation (wire the attention hook's `dismiss` here). */
+    onNavigate?: () => void;
+    /** data-* marker attribute value for tests (e.g. chat sets data-chat-toast). */
+    testId?: {
+        attr: string;
+        value: string;
+    };
+}): import("react/jsx-runtime").JSX.Element;

package/_internal/app/components/conversation/thread-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * conversationThreadId — the adapter-neutral durable thread key for embedded
+ * conversation surfaces: `scope:entityId:agentId`, each part URL-encoded,
+ * empty parts defaulting to 'default'. (The chat plugin uses its own
+ * `chat:<chatId>` scheme; this is for entity-scoped threads like
+ * brainstorms and plan reviews.)
+ */
+export declare function conversationThreadId(scope: string, entityId: string, agentId: string): string;

package/_internal/app/components/conversation/turn-recorder.d.ts

@@ -0,0 +1,37 @@
+/**
+ * createTurnRecorder — server-side helper turning one streamed turn's
+ * RuntimeChatChunks into persisted ConversationMessage rows. ONE
+ * implementation of "what survives a turn" shared by the chat plugin's
+ * stream bridge and embedded surfaces' plugin routes:
+ *
+ * - assistant text accumulates and lands as ONE assistant row (in stream
+ *   position relative to the tool rows around it — earlier text flushes
+ *   when a tool result arrives so replay preserves interleaving)
+ * - only `phase:'result'` tool chunks persist, merged over their call
+ *   phase (summary/previews), previews clipped at honest byte caps with
+ *   a `metadata.truncated` marker
+ * - error chunks persist as error rows (after any partial text)
+ * - status/done chunks never persist
+ */
+import type { ChatChunk as RuntimeChatChunk } from '../../../core/adapters/runtime';
+import type { ConversationMessage } from './fold';
+export declare const SUMMARY_MAX_CHARS = 500;
+export declare const PREVIEW_MAX_CHARS = 2000;
+interface RecorderOptions {
+    turnId: string;
+    agentId?: string;
+    now?: () => string;
+}
+export interface TurnRecorder {
+    ingest: (chunk: RuntimeChatChunk) => void;
+    /**
+     * Rows settled since the last drain (tool results, flushed text) — lets
+     * callers persist incrementally so a crash keeps the partial turn.
+     * Pending (unflushed) text stays buffered until finish().
+     */
+    drain: () => ConversationMessage[];
+    /** Flush trailing text and return the remaining undrained rows; call once at turn end. */
+    finish: () => ConversationMessage[];
+}
+export declare function createTurnRecorder({ turnId, agentId, now }: RecorderOptions): TurnRecorder;
+export {};

package/_internal/app/components/conversation/use-conversation-attention.d.ts

@@ -0,0 +1,64 @@
+/**
+ * useConversationAttention — the provider building block behind every
+ * conversational surface's `nav-badge-providers` slot component (#703).
+ * Mount the consumer's provider outside the router (the host renders the
+ * slot on every page) and call this hook with the surface's wiring; it
+ * keeps the nav badge (unread count / working dot), the optional `(N)`
+ * tab-title prefix, and fires toast + chime + OS notification when a
+ * reply lands while the user is elsewhere — rules in ./attention.ts,
+ * mechanics generalized from chat's ChatBadgeProvider (which now
+ * composes this hook).
+ */
+import { type ReactNode } from 'react';
+import { type PluginEventPayload } from '../../hooks/use-plugin-event';
+import { type ConversationDonePayload } from './attention';
+export interface ConversationAttentionTotals {
+    unreadTotal: number;
+    /** Threads with a server-seeded in-flight turn (kept live by chunk/done events). */
+    inflightKeys: string[];
+}
+export interface ConversationAttentionConfig {
+    pluginId: string;
+    navItemId: string;
+    /**
+     * The surface's bus event names; `refresh` lists extra total-bumping
+     * events — AT MOST TWO (hook-count constraints; extras would be
+     * silently dropped, so the type forbids them).
+     */
+    events: {
+        chunk: string;
+        done: string;
+        error: string;
+        started?: string;
+        refresh?: [string] | [string, string];
+    };
+    keyOf: (payload: PluginEventPayload) => string;
+    /** The thread key currently on screen ('' = none) — read at event time. */
+    visibleKey: () => string;
+    /** Fetch unread + in-flight totals; null keeps the previous totals. */
+    refreshTotals: () => Promise<ConversationAttentionTotals | null>;
+    /** Attention settings at event time. Default: sound + toasts on. */
+    settings?: () => {
+        sound: boolean;
+        toasts: boolean;
+    };
+    /** Reply toast content; `dismiss` closes it (call before in-app navigation). */
+    renderToast: (payload: ConversationDonePayload, dismiss: () => void) => ReactNode | string;
+    /**
+     * OS notification for a reply that landed while the user was elsewhere;
+     * null skips it. Runs only when the done carries a preview (matching
+     * chat: silent settles never notify).
+     */
+    osNotification: (payload: ConversationDonePayload) => {
+        title: string;
+        body: string;
+        href: string;
+    } | null;
+    /** Error toast content when a turn fails off-screen; null skips. */
+    errorToast?: (payload: PluginEventPayload) => string | null;
+    /** Maintain the `(N)` tab-title prefix (chat does; embedded surfaces may skip). */
+    titlePrefix?: boolean;
+    /** Injectable chime (tests); defaults to the kit reply chime. */
+    chime?: () => void;
+}
+export declare function useConversationAttention(config: ConversationAttentionConfig): void;

package/_internal/app/components/drawer.d.ts

@@ -0,0 +1,29 @@
+import { type ReactNode } from 'react';
+declare const MIN_WIDTH = 320;
+declare const MAX_WIDTH = 960;
+declare const DEFAULT_WIDTH = 810;
+declare const DRAWER_WIDTH_STORAGE_KEY = "bakin-drawer-width";
+declare function clampDrawerWidth(width: number): number;
+declare function getDrawerWidthStorageKey(storageKey?: string): string;
+declare function getStoredDrawerWidth(defaultWidth: number, storageKey?: string): number;
+export interface DrawerProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title?: ReactNode;
+    /** Accessible title used when the visible title is intentionally omitted. */
+    ariaLabel?: string;
+    description?: ReactNode;
+    actions?: ReactNode;
+    children: ReactNode;
+    defaultWidth?: number;
+    /** Optional suffix for per-context drawer width persistence. */
+    storageKey?: string;
+    /** When provided, a back action appears left of the title. */
+    onBack?: () => void;
+    /** When true, closing the drawer shows an unsaved-changes confirmation. */
+    dirty?: boolean;
+    /** Prevents escape, outside, close-button, and dirty-confirm dismissal while work is in flight. */
+    busy?: boolean;
+}
+export declare function Drawer({ open, onOpenChange, title, ariaLabel, description, actions, children, defaultWidth, storageKey, onBack, dirty, busy, }: DrawerProps): import("react/jsx-runtime").JSX.Element;
+export { MIN_WIDTH, MAX_WIDTH, DEFAULT_WIDTH, DRAWER_WIDTH_STORAGE_KEY, clampDrawerWidth, getDrawerWidthStorageKey, getStoredDrawerWidth, };

package/_internal/app/components/ui/button.d.ts

@@ -1,8 +1,2 @@
-import { Button as ButtonPrimitive } from "@base-ui/react/button";
-import { type VariantProps } from "class-variance-authority";
-declare const buttonVariants: (props?: ({
-    variant?: "destructive" | "link" | "default" | "outline" | "secondary" | "ghost" | "warning" | "accent" | null | undefined;
-    size?: "default" | "sm" | "lg" | "icon" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-declare function Button({ className, variant, size, ...props }: ButtonPrimitive.Props & VariantProps<typeof buttonVariants>): import("react/jsx-runtime").JSX.Element;
-export { Button, buttonVariants };
+export { Button, buttonVariants } from '../../../host/ui/action-status';
+export type { ButtonProps, ButtonSize, ButtonVariant, ButtonVariantOptions, LegacyButtonSize, LegacyButtonVariant, } from '../../../host/ui/action-status';

package/_internal/app/components/ui/dialog.d.ts

@@ -1,17 +1,2 @@
-import * as React from "react";
-import { Dialog as DialogPrimitive } from "@base-ui/react/dialog";
-declare function Dialog({ ...props }: DialogPrimitive.Root.Props): import("react/jsx-runtime").JSX.Element;
-declare function DialogTrigger({ ...props }: DialogPrimitive.Trigger.Props): import("react/jsx-runtime").JSX.Element;
-declare function DialogPortal({ ...props }: DialogPrimitive.Portal.Props): import("react/jsx-runtime").JSX.Element;
-declare function DialogClose({ ...props }: DialogPrimitive.Close.Props): import("react/jsx-runtime").JSX.Element;
-declare function DialogOverlay({ className, ...props }: DialogPrimitive.Backdrop.Props): import("react/jsx-runtime").JSX.Element;
-declare function DialogContent({ className, children, showCloseButton, ...props }: DialogPrimitive.Popup.Props & {
-    showCloseButton?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
-declare function DialogHeader({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
-declare function DialogFooter({ className, showCloseButton, children, ...props }: React.ComponentProps<"div"> & {
-    showCloseButton?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
-declare function DialogTitle({ className, ...props }: DialogPrimitive.Title.Props): import("react/jsx-runtime").JSX.Element;
-declare function DialogDescription({ className, ...props }: DialogPrimitive.Description.Props): import("react/jsx-runtime").JSX.Element;
-export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, UnsavedChangesDialog, } from '../../../host/ui/modals';
+export type { DialogCloseProps, DialogContentProps, DialogDescriptionProps, DialogFooterProps, DialogHeaderProps, DialogOverlayProps, DialogPortalProps, DialogProps, DialogTitleProps, DialogTriggerProps, UnsavedChangesDialogProps, } from '../../../host/ui/modals';

package/_internal/app/components/ui/sheet.d.ts

@@ -1,14 +1,2 @@
-import * as React from "react";
-import { Dialog as SheetPrimitive } from "@base-ui/react/dialog";
-declare function Sheet({ ...props }: SheetPrimitive.Root.Props): import("react/jsx-runtime").JSX.Element;
-declare function SheetTrigger({ ...props }: SheetPrimitive.Trigger.Props): import("react/jsx-runtime").JSX.Element;
-declare function SheetClose({ ...props }: SheetPrimitive.Close.Props): import("react/jsx-runtime").JSX.Element;
-declare function SheetContent({ className, children, side, showCloseButton, ...props }: SheetPrimitive.Popup.Props & {
-    side?: "top" | "right" | "bottom" | "left";
-    showCloseButton?: boolean;
-}): import("react/jsx-runtime").JSX.Element;
-declare function SheetHeader({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
-declare function SheetFooter({ className, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
-declare function SheetTitle({ className, ...props }: SheetPrimitive.Title.Props): import("react/jsx-runtime").JSX.Element;
-declare function SheetDescription({ className, ...props }: SheetPrimitive.Description.Props): import("react/jsx-runtime").JSX.Element;
-export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription, };
+export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, SheetTitle, SheetTrigger, } from '../../../host/ui/modals';
+export type { SheetCloseProps, SheetContentProps, SheetDescriptionProps, SheetFooterProps, SheetHeaderProps, SheetOverlayProps, SheetPortalProps, SheetProps, SheetSide, SheetTitleProps, SheetTriggerProps, } from '../../../host/ui/modals';