@consciousclouds/operator-shell 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,72 @@
 
 Versioned on the independent frontend-SDK lifecycle (NOT `contract_version`).
 
+## [0.2.0] — 2026-07-05
+
+The first post-publish polish of the AI Region — the Chief window rebuilt to
+the reference operator surface's proven quality. Behavior parity throughout:
+turn lifecycle, routed-directive handling, the in-console guard, ⌘J, and the
+TurnAdapter contract are IDENTICAL — only chrome/UX changed.
+
+### Added
+
+- **Chrome config** (`OperatorShellProps.chrome`) — layout philosophy as
+  DEFAULTS-AND-OVERRIDES (a composition concern, deliberately not Flavor
+  data): `chiefBehavior: 'push' | 'overlay' | 'rail'` (default `push`),
+  `chiefWidth` (default 420), `workspaceChrome: 'framed' | 'edge-to-edge'`
+  (default `framed` — the workspace floats as a rounded container, a sibling
+  card beside the Chief panel, the layout gap animating with the panel).
+- **Push behavior (new default)** — the responsive hybrid, one component:
+  overlay drawer below `lg` (fixed `inset-y-4 right-4`, clickable scrim,
+  300ms translate+opacity), in-flow push panel at `lg+` animating
+  `w-0 → w-(--chief-width)` so the workspace visibly reflows. Closed by
+  default; summoned by the new header **ChiefTrigger** or ⌘J; a
+  dismissible, non-modal peer surface (Esc + outside-click close, composer
+  focused on open, focus returned to the trigger on close — the full
+  assistant-surface option set). `rail` preserves the previous
+  always-visible posture; `overlay` floats at every width.
+- **Suggestion chips** — inert `flavor.chief.suggestions?: string[]`
+  (Declarative-Flavor law); a chip submits its text through the SAME
+  `submitPrompt` the composer uses.
+- **Markdown answers** — `ChiefMarkdown` over react-markdown + remark-gfm
+  (MIT), token-class styled, **sanitized by default** (no raw HTML); pulse
+  cursor ▍ rides the stream; separate color-coded metadata bar; pill
+  composer; `h-12` header bar with icon · title · close ✕.
+- **Personality-display seam (D-Q2)** — `personalityDisplay?:
+  { displayName, iconRef?, accentRef? }` threaded OperatorShell → Chief
+  region: the seam the Factory personality record feeds after the D-Q7
+  split. Precedence `personalityDisplay.displayName > flavor.chief.title >
+  "Chief"` (`resolveChiefTitle`); `iconRef` via the icon registry,
+  `accentRef` via token ROLE names (`resolvePersonalityAccent`) —
+  references only, fail-closed, never raw values.
+- **Notifications slot** — `OperatorShellProps.notifications?:
+  React.ReactNode` (threaded to the header): the product injects its own
+  notifications affordance; absent ⇒ nothing renders. Replaces the previous
+  built-in inert bell button — a missing affordance beats a fake one.
+- **Icon vocabulary grown** — the built-in operator registry now ships the
+  common operator-console nouns (`settings` · `users` · `database` ·
+  `server` · `shield` · `key` · `globe` · `folder` · `file-text` · `search`
+  · `bell` · `layers` · `terminal` · `cpu` · `cloud` · `package` ·
+  `git-branch` · `workflow` · `book` · `chart-line`) alongside the original
+  nine. Unknown names still fail soft to the neutral placeholder; product
+  extensions still override.
+
+### Changed
+
+- `flavor.chief.placement` is **deprecated** (honored as a hint: `rail` →
+  `rail`, `drawer` → `overlay`; the chrome config wins) — layout philosophy
+  moved to the composition root.
+- `ChiefDrawer` is now the floating overlay card (previously the sheet
+  primitive); it keeps a floating corner trigger only when mounted
+  standalone without an external trigger.
+- Default panel width 340 → 420.
+- The header's built-in bell button is REMOVED in favor of the
+  `notifications` slot (it was inert chrome — no notification source ships
+  in the shell).
+- Dependencies: `@consciousclouds/assistant-surface`,
+  `@consciousclouds/canvas-sdk`, `@consciousclouds/canvas-runtime` pinned to
+  `^0.2.1` (published as caret ranges via the workspace protocol).
+
 ## [0.1.0] — 2026-07-04
 
 ### Added

package/README.md

@@ -8,13 +8,16 @@ shadcn/ui registry** (sidebar-16's header-above-sidebar geometry, sidebar-07's
 icon-collapsible rail) over `@consciousclouds/ui` primitives:
 
 - **Frame** — `OperatorShell`: sticky full-width header, icon-collapsible
-  left sidebar (⌘B, mobile sheet), main content, and the AI Region
-  (Chief — invoked with **⌘J/Ctrl+J**, the palette's ⌘K twin).
+  left sidebar (⌘B, mobile sheet), the workspace (framed or edge-to-edge —
+  the `chrome` config), and the AI Region (Chief — summoned by the header
+  trigger or **⌘J/Ctrl+J**, the palette's ⌘K twin; closed-by-default push
+  panel unless the chrome says otherwise).
 - **Header** — brand slot (rendered through the Brand Platform's
   `BrandLogo` + `useBrand`; the shell never bakes an image or a mark string),
-  the search button that opens the command palette, notifications, theme
-  toggle (the Token System's `useTheme`), and a **profile slot** with a
-  neutral default menu.
+  the search button that opens the command palette, a **notifications
+  slot** (`notifications` shell prop — the product injects its own
+  affordance; absent ⇒ nothing renders), theme toggle (the Token System's
+  `useTheme`), and a **profile slot** with a neutral default menu.
 - **Command palette** — `CommandPalette` (mounted by the frame; ⌘K/Ctrl+K
   and the header search button open the one instance; Chief's invocation
   binding sits next to it — **⌘J/Ctrl+J**, see the Chief region) over the registry
@@ -52,8 +55,12 @@ icon-collapsible rail) over `@consciousclouds/ui` primitives:
 - **Icon Platform** — the string-name → icon resolution seam. The Flavor
   declares **inert string names** (`icon: "home"` — never a component,
   Declarative-Flavor law); the shell ships the built-in operator vocabulary
-  (`OPERATOR_ICONS`: `home`, `bot`, `plug`, `activity`, `bar-chart-3`,
-  `waypoints`) and the product **extends** it through the `icons` shell prop
+  (`OPERATOR_ICONS`: the common operator-console nouns — `home`, `bot`,
+  `plug`, `wrench`, `boxes`, `activity`, `bar-chart-3`, `route`,
+  `waypoints`, `settings`, `users`, `database`, `server`, `shield`, `key`,
+  `globe`, `folder`, `file-text`, `search`, `bell`, `layers`, `terminal`,
+  `cpu`, `cloud`, `package`, `git-branch`, `workflow`, `book`,
+  `chart-line`) and the product **extends** it through the `icons` shell prop
   (`IconRegistry`: string name → Lucide component; extensions may
   deliberately override built-ins). Unknown names **fail closed** to the
   exported `UNKNOWN_ICON` — one deterministic neutral glyph for every
@@ -90,10 +97,9 @@ icon-collapsible rail) over `@consciousclouds/ui` primitives:
   and honest: no provider ⇒ no chrome; ONE configured environment ⇒ a
   single-entry **indicator** (not a pretend menu); two or more named targets
   ⇒ a dropdown switcher.
-- **Workspace-switcher seam** — typed + documented, **INERT until backend
-  PRE-1** (per-(project, environment) enrollment keying,
-  `docs/design/ccu-control-plane.md` §8 — the prerequisite for a second
-  workspace existing at all): the Flavor may declare
+- **Workspace-switcher seam** — typed + documented, **INERT** until the
+  platform's control plane keys enrollment per (project, environment) — the
+  prerequisite for a second workspace existing at all: the Flavor may declare
   `workspaces?: OperatorFlavorWorkspace[]` (labels/refs only) and the shell
   ships the `workspaceSwitcher` slot on `OperatorShellProps` (rendered in
   the sidebar header). Products inject nothing today, the shell renders
@@ -137,26 +143,68 @@ icon-collapsible rail) over `@consciousclouds/ui` primitives:
     vocabulary · `displayName` · optional `icon` by NAME · `Component`
     receiving `WorkspaceComponentProps<TInput>`) and include it in your
     `createWorkspaceRegistry` composition alongside the built-ins.
-- **Chief region** — the AI Region. `ChiefRegion` resolves
-  `flavor.chief.placement` (`rail` | `drawer`) to a presentation; BOTH run
-  the identical turn flow (`useChiefTurn` over the injected TurnAdapter) and
-  body (`ChiefSession`), mounted through the headless
+- **Chief region** — the AI Region. `ChiefRegion` resolves a layout
+  **behavior** to a presentation; EVERY behavior runs the identical turn
+  flow (`useChiefTurn` over the injected TurnAdapter) and body
+  (`ChiefSession`), mounted through the headless
   `@consciousclouds/assistant-surface` hook. Turn lifecycle,
   routed-directive handling (directive → href validated against routes
-  **derived from `flavor.nav`**), and streaming/routed/error states. Below
-  the xl breakpoint the rail placement falls back to the drawer — Chief
-  stays reachable. Placement moves the panel and NOTHING else (a Flavor can
-  move Chief's panel; it can never widen Chief's reach).
+  **derived from `flavor.nav`**), and streaming/routed/error states.
+  Behavior moves the panel and NOTHING else — it can never widen Chief's
+  reach.
+  - **Behaviors** (`chrome.chiefBehavior` on `OperatorShell` — layout
+    philosophy is a COMPOSITION concern, deliberately a prop and not Flavor
+    data; the SDK ships the defaults, the app overrides at its composition
+    root): **`push`** (default) — the responsive hybrid, one component:
+    below `lg` a fixed overlay drawer sliding from the right over a
+    clickable scrim; at `lg+` an in-flow peer panel animating `w-0 →
+    w-(--chief-width)` (300ms) so the workspace visibly reflows. Closed by
+    default; summoned by the header **ChiefTrigger** (icon + display name)
+    or ⌘J. A dismissible, non-modal peer surface: Esc + outside-click
+    close, composer focused on open, focus returned to the trigger on
+    close. **`overlay`** — the floating drawer at every width. **`rail`** —
+    the always-visible inflow rail at xl+ (the previous default posture; the
+    overlay below xl keeps Chief reachable). `chrome.chiefWidth` sets the
+    panel width (default 420). The legacy `flavor.chief.placement` is
+    honored as a hint when the chrome declares nothing (`rail` → `rail`,
+    `drawer` → `overlay`); `resolveChiefBehavior` is the pure rule.
+  - **Session body** — the empty state renders the Flavor's hint card plus
+    **suggestion chips** from inert `flavor.chief.suggestions` (strings
+    only, Declarative-Flavor law; a chip submits its text through the SAME
+    `submitPrompt` the composer uses). Streamed answers render as
+    **markdown** (`ChiefMarkdown`: react-markdown + remark-gfm, both MIT;
+    token-class styling; **sanitized by default — raw HTML never renders**)
+    with a pulse cursor ▍ riding the stream; a separate color-coded
+    metadata bar carries routed (`routed → /path · 0 tokens`) /
+    off-console / error outcomes; the composer is a pill input.
+  - **Personality display (the D-Q2 seam)** — `personalityDisplay?:
+    { displayName, iconRef?, accentRef? }` on `OperatorShell`, threaded to
+    the Chief region: the seam the **Factory personality record** will feed
+    after the D-Q7 personality split (the shell renders "the current
+    personality" and never knows which). `displayName` is literal —
+    precedence **`personalityDisplay.displayName` > `flavor.chief.title` >
+    `"Chief"`** (`resolveChiefTitle` is the pure rule). `iconRef` resolves
+    through the **icon registry** (product extensions apply; unknown ⇒ the
+    deterministic fallback) and `accentRef` through the **Token System's
+    role names** (`resolvePersonalityAccent`; unknown role ⇒ the default
+    token classes stand) — **REFERENCES ONLY, never raw assets or hex
+    values**: Brand stays the single owner of appearance.
   **Invocation parity — ⌘J/Ctrl+J** (the palette's ⌘K twin, shell-owned,
   wired where the mounted presentation lives just as ⌘K lives with the
-  palette): on the **rail** it focuses the composer; on the **drawer**
-  (declared, or the rail's below-xl fallback) it toggles open/closed through
-  assistant-surface's one open/close lifecycle. Exactly one presentation
-  mounts at a time (single-surface rule), so exactly one listener is ever
+  palette): on the **rail** it focuses the composer; on **push/overlay** it
+  summons/dismisses through the one open state the trigger, Esc,
+  outside-click, and the scrim all drive. Exactly one presentation mounts
+  at a time (single-surface rule), so exactly one listener is ever
   attached. Shift/alt refuse the match — ⌘⇧J stays the browser's downloads
-  chord; no Flavor field is involved (placement remains the only Chief
-  decoration). `isChiefShortcut` is the exported pure match rule;
+  chord. `isChiefShortcut` is the exported pure match rule;
   `CHIEF_SHORTCUT_LABEL` carries the display copy.
+- **Workspace chrome** — `chrome.workspaceChrome` on `OperatorShell`:
+  **`framed`** (default) renders the workspace inside a rounded floating
+  container (breathing room; a sibling card beside the Chief panel, with
+  the layout gap animating alongside the panel's width) — a generalized
+  mechanism, proven by a product surface that needed it; **`edge-to-edge`**
+  is the flat layout. Future shells (Business / Consumer / Mobile) choose
+  their own defaults over the same mechanism.
 
 **The shell owns the panel; the product owns the wire.** Transport is injected
 via a **TurnAdapter** typed against the published turn vocabulary
@@ -194,8 +242,9 @@ data and mount `BrandProvider`. See `@consciousclouds/brand`'s README.
 **4. Flavor.** Write ONE inert `OperatorFlavor` per surface: the product
 block, nav groups (route strings + icon NAMES + optional permission
 references), `defaultLanding`, optional palette `commands` (references),
-`inspector.entityKinds` (references), and Chief decoration (placement/copy +
-an inert personality reference — never an endpoint).
+`inspector.entityKinds` (references), and Chief decoration (copy +
+`suggestions` strings + an inert personality reference — never an endpoint;
+layout behavior belongs to the shell's `chrome` prop, not the Flavor).
 
 **5. The four injections.** Mount the shell from a **client component**
 (adapters/resolvers are functions — they cannot be serialized from a server
@@ -280,9 +329,8 @@ An `inspect` action needs its entity kind declared in
 your environment targets to light up the environment switcher; wire a
 favicon from your Brand's `favicon` role.
 
-The reference implementation of every step is CCU Admin
-(`platform/frontend/consciousclouds-admin/` — `app/operator-console.tsx`,
-`lib/{brand,flavor,turn-adapter,workspaces,search-sources}.ts`).
+The reference implementation of every step is the platform's own admin
+console — the proving ground every mechanism here graduated from.
 
 ## The membrane gates — what may never enter this package
 
@@ -311,7 +359,8 @@ Runtime: `ui` · `brand` · `assistant-surface` · `conductor-sdk` /
 `conductor-react` (types + directive handling) · `frontend-runtime`
 (environment context — consumed, never rebuilt) · `canvas-runtime` /
 `canvas-sdk` (the canvas workspace type — consumed, never rebuilt) ·
-`lucide-react`. Peers: `react`, `next` (>=15 <17), and
+`lucide-react` · `react-markdown` + `remark-gfm` (MIT — Chief's streamed
+answers; sanitized by default, no raw-HTML plugin). Peers: `react`, `next` (>=15 <17), and
 `@consciousclouds/tokens` — tokens is a peer (not a bundled dep) because
 theme state is token machinery: the app mounts tokens' `ThemeProvider`; the
 shell's theme toggle reads the same single instance through tokens'

package/dist/chief/ChiefDrawer.d.ts

@@ -1,11 +1,43 @@
+import type { CanvasDefinition } from "@consciousclouds/canvas-sdk";
 import type { OperatorFlavor } from "../flavor/types.js";
+import type { IconRegistry } from "../icons/registry.js";
+import { type ChiefWorkspacesRegion } from "./ChiefSession.js";
+import type { ConversationAdapter } from "./conversation-adapter.js";
+import { type PersonalityDisplay } from "./personality-display.js";
 import type { TurnAdapter } from "./turn-adapter.js";
+import { type ComposedMeta } from "./use-chief-turn.js";
 export interface ChiefDrawerProps {
     flavor: OperatorFlavor;
     /** The product's transport (P1-1). The shell owns the panel, never the wire. */
     adapter: TurnAdapter;
-    /** Extra classes on the floating trigger button. */
+    /** Drawer width in px (default 420; never wider than the viewport − 2rem). */
+    width?: number;
+    /** Controlled open state. Omit for uncontrolled (closed by default). */
+    open?: boolean;
+    /** Open-state observer/setter — fires for every open/close, however caused. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * External trigger (e.g. the shell header's ChiefTrigger): excluded from
+     * outside-click dismissal; receives focus back on close. When provided,
+     * the floating fallback trigger does not render.
+     */
+    getTriggerElement?: () => HTMLElement | null;
+    /** Display identity from the Factory personality record (D-Q2 seam). */
+    personalityDisplay?: PersonalityDisplay;
+    /** Icon-registry extensions for `personalityDisplay.iconRef` resolution. */
+    icons?: IconRegistry;
+    /** Brand icon family (read-and-defaulted by the registry). */
+    iconFamily?: string;
+    /** The compose→center seam — forwarded verbatim to useChiefTurn (see ChiefRegion). */
+    onComposed?: (canvas: CanvasDefinition, meta: ComposedMeta) => void;
+    /** Composition activity (real tool events) — forwarded verbatim to useChiefTurn. */
+    onComposeActivity?: (phase: "composing" | "idle") => void;
+    /** The transcript transport — forwarded verbatim to useChiefTurn (fail-closed slot). */
+    conversationAdapter?: ConversationAdapter;
+    /** Kept workspaces for the drawer's Workspaces tab (fail-closed slot). */
+    workspaces?: ChiefWorkspacesRegion;
+    /** Extra classes on the floating fallback trigger button. */
     triggerClassName?: string;
 }
-export declare function ChiefDrawer({ flavor, adapter, triggerClassName }: ChiefDrawerProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChiefDrawer({ flavor, adapter, width, open: openProp, onOpenChange, getTriggerElement, personalityDisplay, icons, iconFamily, onComposed, onComposeActivity, conversationAdapter, workspaces, triggerClassName, }: ChiefDrawerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=ChiefDrawer.d.ts.map

package/dist/chief/ChiefDrawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChiefDrawer.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefDrawer.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC;IACrB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,gBAAgB,2CA0DlF"}
+{"version":3,"file":"ChiefDrawer.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefDrawer.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAgB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGtE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC;IACrB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC7C,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,4EAA4E;IAC5E,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACpE,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,KAAK,IAAI,CAAC;IAC1D,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,0EAA0E;IAC1E,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,OAAO,EACP,KAAW,EACX,IAAI,EAAE,QAAQ,EACd,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,EACL,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,GACjB,EAAE,gBAAgB,2CAgFlB"}

package/dist/chief/ChiefDrawer.js

@@ -1,49 +1,62 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
- * ChiefDrawer — the AI Region's DRAWER placement: the same Chief content
- * (useChiefTurn + ChiefSession, shared verbatim with the rail) mounted
- * through the registry sheet primitive behind a floating trigger, with
- * assistant-surface's open/close lifecycle driving the one open state.
+ * ChiefDrawer — the AI Region's OVERLAY placement: the same Chief content
+ * (useChiefTurn + ChiefSession, shared verbatim with the inflow panel) as a
+ * floating drawer card — `fixed inset-y-4 right-4`, rounded, shadowed,
+ * sliding in from the right (300ms translate + opacity) over a clickable
+ * backdrop scrim — at EVERY viewport width. It is both the standalone
+ * `overlay` behavior and the below-breakpoint fallback of the rail.
  *
- * Division of behavior (no doubled handlers): useAssistantSurface owns the
- * LIFECYCLE — the single-surface registration, open/close state semantics,
- * trigger wiring (aria-haspopup/expanded), and focus restore to the trigger
- * on close; the sheet primitive owns the modal PRESENTATION — portal,
- * overlay, escape/outside-click dismissal, and focus containment — reporting
- * every dismissal back through the same onOpenChange. The hook stays
- * non-modal/non-dismissible so neither layer duplicates the other's job.
+ * A dismissible, non-modal peer surface via assistant-surface's full option
+ * set: Esc + outside-click close, composer focused on open, focus returned
+ * to the trigger on close. When no external trigger is supplied (standalone
+ * mounts outside OperatorShell), a floating corner trigger renders as the
+ * fallback so the drawer stays reachable.
  *
- * The turn state lives OUTSIDE the sheet content (in this component), so
- * closing and reopening the drawer keeps the thread — parity with the
- * always-mounted rail. Transport is the injected TurnAdapter's — the shell
- * never owns the wire (P1-1).
+ * The turn state lives OUTSIDE the animated chrome (in this component), so
+ * closing and reopening keeps the thread. Transport is the injected
+ * TurnAdapter's — the shell never owns the wire (P1-1).
  */
 import * as React from "react";
-import { Sparkles } from "lucide-react";
 import { useAssistantSurface } from "@consciousclouds/assistant-surface";
-import { Button, Sheet, SheetContent, SheetHeader, SheetTitle, cn } from "@consciousclouds/ui";
+import { Button, cn } from "@consciousclouds/ui";
+import { ChiefHeaderBar } from "./ChiefHeaderBar.js";
 import { ChiefSession } from "./ChiefSession.js";
+import { resolvePersonalityAccent, resolvePersonalityIcon, } from "./personality-display.js";
 import { useChiefShortcut } from "./use-chief-shortcut.js";
 import { useChiefTurn } from "./use-chief-turn.js";
-export function ChiefDrawer({ flavor, adapter, triggerClassName }) {
-    const [open, setOpen] = React.useState(false);
-    const session = useChiefTurn({ flavor, adapter });
-    // The shell-owned Chief keybinding (⌘J / Ctrl+J — use-chief-shortcut.ts).
-    // Drawer invocation = toggle, through the SAME setOpen the
-    // assistant-surface lifecycle and the sheet's dismissals drive — one open
-    // state, whoever moves it.
-    useChiefShortcut(() => setOpen((o) => !o));
-    // Assistant-surface lifecycle (same surface id as the rail — one AI Region
-    // per application, whatever its placement). Defaults keep it non-modal and
-    // non-dismissible at the hook level: the sheet primitive supplies the
-    // modal presentation and reports dismissals through onOpenChange.
+import { useControlledOpen } from "./use-controlled-open.js";
+export function ChiefDrawer({ flavor, adapter, width = 420, open: openProp, onOpenChange, getTriggerElement, personalityDisplay, icons, iconFamily, onComposed, onComposeActivity, conversationAdapter, workspaces, triggerClassName, }) {
+    const [open, setOpen] = useControlledOpen(openProp, onOpenChange);
+    const session = useChiefTurn({ flavor, adapter, personalityDisplay, onComposed, onComposeActivity, conversationAdapter });
+    const composerRef = React.useRef(null);
+    const Icon = resolvePersonalityIcon(personalityDisplay, icons, iconFamily);
+    const accentColor = resolvePersonalityAccent(personalityDisplay?.accentRef);
+    // The shell-owned Chief keybinding (⌘J / Ctrl+J): summon/dismiss through
+    // the SAME setOpen the trigger, Esc, outside-click, and the scrim drive —
+    // one open state, whoever moves it.
+    useChiefShortcut(() => setOpen(!open));
+    // Assistant-surface lifecycle (same surface id in every placement — one AI
+    // Region per application): the full dismissible peer-panel option set —
+    // non-modal (no trap, no scroll lock), Esc + outside-click close, composer
+    // focus on open, focus back to the trigger on close.
     const surface = useAssistantSurface({
         open,
         onOpenChange: setOpen,
         surfaceId: "operator-shell-chief",
         "aria-label": session.title,
+        modal: false,
+        dismissible: true,
+        // EXPLICIT-CLOSE (owner): only ✕ / trigger / Esc — never an outside click.
+        closeOnOutsideClick: false,
+        focusOnOpen: () => composerRef.current,
+        getTriggerElement,
     });
-    return (_jsxs(_Fragment, { children: [_jsxs(Button, { type: "button", ref: surface.triggerRef, ...surface.triggerProps, className: cn("fixed right-4 bottom-4 z-40 gap-2 rounded-full shadow-lg", triggerClassName), "aria-label": `Open ${session.title}`, children: [_jsx(Sparkles, { className: "size-4" }), session.title] }), _jsx(Sheet, { open: open, onOpenChange: setOpen, children: _jsx(SheetContent, { side: "right", "aria-describedby": undefined, className: "w-[340px] gap-0 sm:max-w-[340px]", children: _jsxs("div", { ref: surface.surfaceRef, ...surface.surfaceProps, className: "flex h-full min-h-0 flex-col", children: [_jsxs(SheetHeader, { className: "h-12 shrink-0 flex-row items-center gap-2 space-y-0 border-b border-border px-4 py-0", children: [_jsx("div", { className: "flex size-6 items-center justify-center rounded-md bg-primary/10 text-primary", children: _jsx(Sparkles, { className: "size-3.5" }) }), _jsx(SheetTitle, { className: "text-sm font-medium", children: session.title })] }), _jsx(ChiefSession, { session: session })] }) }) })] }));
+    return (_jsxs(_Fragment, { children: [!getTriggerElement && (_jsxs(Button, { type: "button", ref: surface.triggerRef, ...surface.triggerProps, className: cn("fixed right-4 bottom-4 z-40 gap-2 rounded-full shadow-lg", triggerClassName), "aria-label": `Open ${session.title}`, children: [_jsx(Icon, { className: "size-4" }), session.title] })), _jsx("div", { "aria-hidden": true, 
+                // No click-to-close: explicit-close only (✕ / trigger / Esc).
+                className: cn("fixed inset-0 z-40 bg-black/30 transition-opacity duration-(--motion-duration-base)", open ? "opacity-100" : "pointer-events-none opacity-0") }), _jsxs("aside", { ref: surface.surfaceRef, ...surface.surfaceProps, role: "dialog", style: { "--chief-width": `${width}px` }, className: cn("fixed inset-y-4 right-4 z-50 flex w-[min(var(--chief-width),calc(100vw-2rem))] flex-col overflow-hidden rounded-xl bg-muted/50 shadow-2xl backdrop-blur-xl", "transition-all duration-(--motion-duration-base) ease-(--motion-ease-standard)", open
+                    ? "translate-x-0 opacity-100"
+                    : "pointer-events-none invisible translate-x-[calc(100%+1.5rem)] opacity-0"), children: [_jsx(ChiefHeaderBar, { title: session.title, icon: Icon, accentColor: accentColor, onClose: () => setOpen(false) }), _jsx(ChiefSession, { session: session, composerRef: composerRef, accentColor: accentColor, workspaces: workspaces })] })] }));
 }
 //# sourceMappingURL=ChiefDrawer.js.map

package/dist/chief/ChiefDrawer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChiefDrawer.js","sourceRoot":"","sources":["../../src/chief/ChiefDrawer.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAG/F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUnD,MAAM,UAAU,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAoB;IACjF,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAElD,0EAA0E;IAC1E,2DAA2D;IAC3D,0EAA0E;IAC1E,2BAA2B;IAC3B,gBAAgB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3C,2EAA2E;IAC3E,2EAA2E;IAC3E,sEAAsE;IACtE,kEAAkE;IAClE,MAAM,OAAO,GAAG,mBAAmB,CAAC;QAClC,IAAI;QACJ,YAAY,EAAE,OAAO;QACrB,SAAS,EAAE,sBAAsB;QACjC,YAAY,EAAE,OAAO,CAAC,KAAK;KAC5B,CAAC,CAAC;IAEH,OAAO,CACL,8BACE,MAAC,MAAM,IACL,IAAI,EAAC,QAAQ,EACb,GAAG,EAAE,OAAO,CAAC,UAAU,KACnB,OAAO,CAAC,YAAY,EACxB,SAAS,EAAE,EAAE,CAAC,0DAA0D,EAAE,gBAAgB,CAAC,gBAC/E,QAAQ,OAAO,CAAC,KAAK,EAAE,aAEnC,KAAC,QAAQ,IAAC,SAAS,EAAC,QAAQ,GAAG,EAC9B,OAAO,CAAC,KAAK,IACP,EAET,KAAC,KAAK,IAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,YACtC,KAAC,YAAY,IACX,IAAI,EAAC,OAAO,sBACM,SAAS,EAC3B,SAAS,EAAC,kCAAkC,YAE5C,eACE,GAAG,EAAE,OAAO,CAAC,UAAU,KACnB,OAAO,CAAC,YAAY,EACxB,SAAS,EAAC,8BAA8B,aAExC,MAAC,WAAW,IAAC,SAAS,EAAC,sFAAsF,aAC3G,cAAK,SAAS,EAAC,+EAA+E,YAC5F,KAAC,QAAQ,IAAC,SAAS,EAAC,UAAU,GAAG,GAC7B,EACN,KAAC,UAAU,IAAC,SAAS,EAAC,qBAAqB,YAAE,OAAO,CAAC,KAAK,GAAc,IAC5D,EAEd,KAAC,YAAY,IAAC,OAAO,EAAE,OAAO,GAAI,IAC9B,GACO,GACT,IACP,CACJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ChiefDrawer.js","sourceRoot":"","sources":["../../src/chief/ChiefDrawer.tsx"],"names":[],"mappings":"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"}

package/dist/chief/ChiefHeaderBar.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ChiefHeaderBar — the AI Region's shared header chrome: personality icon +
+ * title on the left, an optional close ✕ on the right (`h-12 px-4` over a
+ * soft `border-border/50` rule). Rendered identically by every placement;
+ * the rail simply passes no `onClose` (always-visible mode has nothing to
+ * close). Icon and accent arrive RESOLVED (registry component + token-role
+ * color) — references were resolved upstream, raw values never enter here.
+ */
+import type { LucideIcon } from "lucide-react";
+export interface ChiefHeaderBarProps {
+    title: string;
+    icon: LucideIcon;
+    /** Composable CSS color from a token ROLE (resolvePersonalityAccent). */
+    accentColor?: string;
+    /** Close handler; omitted on the always-visible rail. */
+    onClose?: () => void;
+}
+export declare function ChiefHeaderBar({ title, icon: Icon, accentColor, onClose }: ChiefHeaderBarProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ChiefHeaderBar.d.ts.map

package/dist/chief/ChiefHeaderBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChiefHeaderBar.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefHeaderBar.tsx"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,mBAAmB,2CAuB9F"}

package/dist/chief/ChiefHeaderBar.js

@@ -0,0 +1,7 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { X } from "lucide-react";
+export function ChiefHeaderBar({ title, icon: Icon, accentColor, onClose }) {
+    return (_jsxs("div", { className: "flex h-12 shrink-0 items-center justify-between border-b border-border/50 px-4", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx(Icon, { "aria-hidden": true, className: "size-4 shrink-0 text-primary", style: accentColor ? { color: accentColor } : undefined }), _jsx("span", { className: "truncate text-sm font-semibold tracking-tight", children: title })] }), onClose && (_jsx("button", { type: "button", onClick: onClose, "aria-label": `Close ${title}`, className: "flex size-7 shrink-0 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-background/60 hover:text-foreground", children: _jsx(X, { className: "size-4" }) }))] }));
+}
+//# sourceMappingURL=ChiefHeaderBar.js.map

package/dist/chief/ChiefHeaderBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChiefHeaderBar.js","sourceRoot":"","sources":["../../src/chief/ChiefHeaderBar.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAYb,OAAO,EAAE,CAAC,EAAE,MAAM,cAAc,CAAC;AAWjC,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAuB;IAC7F,OAAO,CACL,eAAK,SAAS,EAAC,gFAAgF,aAC7F,eAAK,SAAS,EAAC,iCAAiC,aAC9C,KAAC,IAAI,yBAEH,SAAS,EAAC,8BAA8B,EACxC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,GACvD,EACF,eAAM,SAAS,EAAC,+CAA+C,YAAE,KAAK,GAAQ,IAC1E,EACL,OAAO,IAAI,CACV,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,gBACJ,SAAS,KAAK,EAAE,EAC5B,SAAS,EAAC,kJAAkJ,YAE5J,KAAC,CAAC,IAAC,SAAS,EAAC,QAAQ,GAAG,GACjB,CACV,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/chief/ChiefMarkdown.d.ts

@@ -0,0 +1,12 @@
+export interface ChiefMarkdownProps {
+    /** The (possibly still-streaming) markdown source. */
+    children: string;
+    /** A turn is in flight — show the pulse cursor at the stream's tail. */
+    streaming?: boolean;
+    /** Fade each newly-revealed word in (the "materializing" edge). Pass while the
+     *  answer is actively revealing; ignored under reduced-motion. Off → plain markdown. */
+    wordFade?: boolean;
+    className?: string;
+}
+export declare function ChiefMarkdown({ children, streaming, wordFade, className, }: ChiefMarkdownProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ChiefMarkdown.d.ts.map

package/dist/chief/ChiefMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChiefMarkdown.d.ts","sourceRoot":"","sources":["../../src/chief/ChiefMarkdown.tsx"],"names":[],"mappings":"AAqKA,MAAM,WAAW,kBAAkB;IACjC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;4FACwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAiB,EACjB,QAAgB,EAChB,SAAS,GACV,EAAE,kBAAkB,2CA2BpB"}

package/dist/chief/ChiefMarkdown.js

@@ -0,0 +1,95 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import Markdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import { motion } from "motion/react";
+import { motionTokens } from "@consciousclouds/tokens";
+import { cn, useReducedMotion } from "@consciousclouds/ui";
+const remarkPlugins = [remarkGfm];
+/** The per-word fade (the "materializing" edge). A rehype plugin wraps each word
+ *  of the answer in a `<span class="cc-stream-word">`, and the span component
+ *  below fades it in ONCE on mount — so as the paced reveal lands a new word, it
+ *  breathes in instead of snapping. Skips code/pre (monospace + whitespace stay
+ *  intact). Enabled only while streaming/revealing (and never on reduced-motion),
+ *  so a settled answer renders as plain, un-wrapped markdown. */
+const CC_STREAM_WORD = "cc-stream-word";
+function rehypeWordFade() {
+    const walk = (node) => {
+        if (!Array.isArray(node.children))
+            return;
+        if (node.type === "element" && (node.tagName === "code" || node.tagName === "pre"))
+            return;
+        const next = [];
+        for (const raw of node.children) {
+            const child = raw;
+            if (child.type === "text" && typeof child.value === "string") {
+                const parts = child.value.match(/\S+|\s+/g);
+                if (!parts) {
+                    next.push(child);
+                    continue;
+                }
+                for (const part of parts) {
+                    if (/\S/.test(part)) {
+                        next.push({
+                            type: "element",
+                            tagName: "span",
+                            properties: { className: [CC_STREAM_WORD] },
+                            children: [{ type: "text", value: part }],
+                        });
+                    }
+                    else {
+                        next.push({ type: "text", value: part });
+                    }
+                }
+            }
+            else {
+                walk(child);
+                next.push(child);
+            }
+        }
+        node.children = next;
+    };
+    return (tree) => walk(tree);
+}
+const wordTransition = { duration: motionTokens.duration.base, ease: motionTokens.easing.standard };
+/** Renders a react-markdown `span`. A word wrapped by rehypeWordFade fades in
+ *  once on mount; any other span renders plain. framer-motion's `initial` runs
+ *  only on mount, so already-revealed words never re-fade as the answer grows. */
+function StreamSpan({ node: _n, className, ...props }) {
+    if (typeof className === "string" && className.includes(CC_STREAM_WORD)) {
+        return (_jsx(motion.span, { initial: { opacity: 0 }, animate: { opacity: 1 }, transition: wordTransition, className: className, ...props }));
+    }
+    return _jsx("span", { className: className, ...props });
+}
+/** Token-class styling for every element the answer stream may produce. */
+const components = {
+    h1: ({ node: _n, className, ...props }) => (_jsx("h3", { className: cn("mt-3 mb-1 text-sm font-semibold first:mt-0", className), ...props })),
+    h2: ({ node: _n, className, ...props }) => (_jsx("h4", { className: cn("mt-3 mb-1 text-sm font-semibold first:mt-0", className), ...props })),
+    h3: ({ node: _n, className, ...props }) => (_jsx("h5", { className: cn("mt-2.5 mb-1 text-[13px] font-semibold first:mt-0", className), ...props })),
+    h4: ({ node: _n, className, ...props }) => (_jsx("h6", { className: cn("mt-2.5 mb-1 text-[13px] font-semibold first:mt-0", className), ...props })),
+    p: ({ node: _n, className, ...props }) => (_jsx("p", { className: cn("my-1.5 first:mt-0 last:mb-0", className), ...props })),
+    a: ({ node: _n, className, ...props }) => (_jsx("a", { className: cn("font-medium text-primary underline underline-offset-2", className), rel: "noreferrer", ...props })),
+    ul: ({ node: _n, className, ...props }) => (_jsx("ul", { className: cn("my-1.5 list-disc space-y-0.5 pl-4", className), ...props })),
+    ol: ({ node: _n, className, ...props }) => (_jsx("ol", { className: cn("my-1.5 list-decimal space-y-0.5 pl-4", className), ...props })),
+    blockquote: ({ node: _n, className, ...props }) => (_jsx("blockquote", { className: cn("my-1.5 border-l-2 border-border pl-3 text-muted-foreground", className), ...props })),
+    // Block code gets the readable panel; the inner <code> chrome resets so
+    // the inline-code styling below never doubles up inside a block.
+    pre: ({ node: _n, className, ...props }) => (_jsx("pre", { className: cn("my-2 overflow-x-auto rounded-md border border-border/60 bg-background/60 p-2.5 font-mono text-xs leading-relaxed", "[&_code]:rounded-none [&_code]:bg-transparent [&_code]:p-0 [&_code]:font-mono [&_code]:text-xs", className), ...props })),
+    code: ({ node: _n, className, ...props }) => (_jsx("code", { className: cn("rounded bg-background/80 px-1 py-0.5 font-mono text-[0.85em]", className), ...props })),
+    hr: ({ node: _n, className, ...props }) => (_jsx("hr", { className: cn("my-2 border-border/60", className), ...props })),
+    // GFM tables scroll inside the bubble instead of blowing the panel width.
+    table: ({ node: _n, className, ...props }) => (_jsx("div", { className: "my-2 overflow-x-auto", children: _jsx("table", { className: cn("w-full border-collapse text-xs", className), ...props }) })),
+    th: ({ node: _n, className, ...props }) => (_jsx("th", { className: cn("border border-border/60 px-2 py-1 text-left font-semibold", className), ...props })),
+    td: ({ node: _n, className, ...props }) => (_jsx("td", { className: cn("border border-border/60 px-2 py-1 align-top", className), ...props })),
+};
+/** The base styling map plus the fading word-span, used while the answer reveals. */
+const fadeComponents = { ...components, span: StreamSpan };
+export function ChiefMarkdown({ children, streaming = false, wordFade = false, className, }) {
+    const reduced = useReducedMotion();
+    const fade = wordFade && !reduced;
+    return (_jsxs("div", { className: cn("min-w-0 [word-break:break-word]", 
+        // While streaming, the last paragraph flows inline so the cursor
+        // sits on the tail of the text instead of a line of its own.
+        streaming && "[&>p:last-child]:inline", className), children: [_jsx(Markdown, { remarkPlugins: remarkPlugins, rehypePlugins: fade ? [rehypeWordFade] : undefined, components: fade ? fadeComponents : components, children: children }), streaming && (_jsx("span", { "aria-hidden": true, className: "ml-0.5 inline-block animate-pulse select-none", children: "\u258D" }))] }));
+}
+//# sourceMappingURL=ChiefMarkdown.js.map

package/dist/chief/ChiefMarkdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChiefMarkdown.js","sourceRoot":"","sources":["../../src/chief/ChiefMarkdown.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAgBb,OAAO,QAA6B,MAAM,gBAAgB,CAAC;AAC3D,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,aAAa,GAAG,CAAC,SAAS,CAAC,CAAC;AAElC;;;;;iEAKiE;AACjE,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAExC,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,CAAC,IAA+E,EAAE,EAAE;QAC/F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC;YAAE,OAAO;QAC3F,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,GAAwC,CAAC;YACvD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACjB,SAAS;gBACX,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBACpB,IAAI,CAAC,IAAI,CAAC;4BACR,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,MAAM;4BACf,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE;4BAC3C,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;yBAC1C,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAiC,CAAC,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC,CAAC;IACF,OAAO,CAAC,IAA8B,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,cAAc,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;AAEpG;;kFAEkF;AAClF,SAAS,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAA0C;IAC3F,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACxE,OAAO,CACL,KAAC,MAAM,CAAC,IAAI,IACV,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EACvB,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EACvB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,SAAS,KAChB,KAAK,GACT,CACH,CAAC;IACJ,CAAC;IACD,OAAO,eAAM,SAAS,EAAE,SAAS,KAAM,KAAK,GAAI,CAAC;AACnD,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,GAAe;IAC7B,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,4CAA4C,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CAC1F;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,4CAA4C,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CAC1F;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,kDAAkD,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CAChG;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,kDAAkD,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CAChG;IACD,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACxC,YAAG,SAAS,EAAE,EAAE,CAAC,6BAA6B,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CAC1E;IACD,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACxC,YACE,SAAS,EAAE,EAAE,CAAC,uDAAuD,EAAE,SAAS,CAAC,EACjF,GAAG,EAAC,YAAY,KACZ,KAAK,GACT,CACH;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,mCAAmC,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CACjF;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,sCAAsC,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CACpF;IACD,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACjD,qBACE,SAAS,EAAE,EAAE,CAAC,4DAA4D,EAAE,SAAS,CAAC,KAClF,KAAK,GACT,CACH;IACD,wEAAwE;IACxE,iEAAiE;IACjE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAC1C,cACE,SAAS,EAAE,EAAE,CACX,kHAAkH,EAClH,gGAAgG,EAChG,SAAS,CACV,KACG,KAAK,GACT,CACH;IACD,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAC3C,eACE,SAAS,EAAE,EAAE,CAAC,8DAA8D,EAAE,SAAS,CAAC,KACpF,KAAK,GACT,CACH;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,uBAAuB,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CACrE;IACD,0EAA0E;IAC1E,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAC5C,cAAK,SAAS,EAAC,sBAAsB,YACnC,gBAAO,SAAS,EAAE,EAAE,CAAC,gCAAgC,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,GAC5E,CACP;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aACE,SAAS,EAAE,EAAE,CAAC,2DAA2D,EAAE,SAAS,CAAC,KACjF,KAAK,GACT,CACH;IACD,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CACzC,aAAI,SAAS,EAAE,EAAE,CAAC,6CAA6C,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CAC3F;CACF,CAAC;AAEF,qFAAqF;AACrF,MAAM,cAAc,GAAe,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAavE,MAAM,UAAU,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAS,GAAG,KAAK,EACjB,QAAQ,GAAG,KAAK,EAChB,SAAS,GACU;IACnB,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,OAAO,CAAC;IAClC,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CACX,iCAAiC;QACjC,iEAAiE;QACjE,6DAA6D;QAC7D,SAAS,IAAI,yBAAyB,EACtC,SAAS,CACV,aAED,KAAC,QAAQ,IACP,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,EAClD,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,YAE7C,QAAQ,GACA,EACV,SAAS,IAAI,CACZ,oCAAkB,SAAS,EAAC,+CAA+C,uBAEpE,CACR,IACG,CACP,CAAC;AACJ,CAAC"}