@clipbus/plugin-sdk 0.8.5 → 0.8.7

package/dist/preview/chrome.d.ts

@@ -2,18 +2,18 @@
  * Pure DOM workbench chrome — no framework dependencies.
  *
  * Responsibilities:
- * - Two-level navigation: mode (Renderer / Action) → scenario
- *   - Renderer: native capsule-tab bar (scenario.label as plugin title, accent-
- *     driven selected state; no attachment count / no shortcut hints)
- *   - Action: <select> (native action has no tab)
- * - Four-preset theme selector; applyTheme writes CSS vars to the workbench root
- * - Native card shell around the plugin webview slot
- *   (10 px padding / 8 px radius / 1 px accent border / surfaceElevated bg / no shadow)
- * - Viewport centered in host frame; width controlled by a range slider per mode
+ * - Header: Wire Bench wordmark + controls console
+ *   (Surface toggle, Scenario select, Theme select, Width slider)
+ * - Stage: workspace hero (left) + dock (right, position:sticky)
+ *   - Workspace: ws-head label + ws-surface holding the frozen specimen card
+ *     subtree (card shell → viewport → webview slot) + dims readout + growth floor
+ *   - Dock: IN attachment card (Wire Input mount point) over OUT attachment card
+ *     (Native Calls single-open accordion)
+ * - Viewport centered in workspace; width driven by range slider per mode
  * - Fixed-height viewport driven by setHeight calls
  * - Host button strip; click dispatches host-invoke events
  * - clipbus-plugin-set-buttons listener (updates button strip from plugin)
- * - Call log panel (one entry per native plugin→host call)
+ * - Native Calls OUT panel: single-open accordion, newest auto-opens
  */
 import type { PreviewScenario, PreviewWorkbenchOptions } from './types.js';
 import type { PreviewThemePreset } from './theme.js';
@@ -54,6 +54,11 @@ export interface ChromeHandlers {
 export interface ChromeResult {
     /** The <div> slot where the plugin UI should be mounted. */
     slotEl: HTMLElement;
+    /**
+     * The scroll container of the IN attachment card where renderWireInput()
+     * should mount the Wire Input collapsible sections.
+     */
+    inputContainer: HTMLElement;
     setViewportHeight(height: number): void;
     /** Update the viewport width imperatively (also moves the slider thumb). */
     setViewportWidth(px: number): void;
@@ -83,7 +88,26 @@ export interface ChromeResult {
     destroy(): void;
 }
 /**
- * Render the workbench chrome into `root` and return imperative handles.
+ * Render the Wire Bench chrome into `root` and return imperative handles.
+ *
+ * DOM structure:
+ *   .cbp-wb
+ *     .cbp-wb__header  (brand + controls console)
+ *     .cbp-wb__rule    (separator)
+ *     .cbp-wb__stage
+ *       .cbp-wb__workspace  (hero — fills left column)
+ *         .cbp-wb__ws-head
+ *         .cbp-wb__ws-surface
+ *           .cbp-wb__specimen-wrap
+ *             .cbp-wb__card-shell [frozen]
+ *               .cbp-wb__viewport [frozen]
+ *                 .cbp-wb__webview [frozen slotEl]
+ *               .cbp-wb__strip [frozen]
+ *           .cbp-wb__ws-dims
+ *           .cbp-wb__ws-floor
+ *       .cbp-wb__dock  (sticky right column)
+ *         .cbp-wb__att.cbp-wb__att--in   (Wire Input — inputContainer)
+ *         .cbp-wb__att.cbp-wb__att--out  (Native Calls accordion)
  *
  * @param root - Container element (e.g. document.body or a div).
  * @param scenarios - Full list of scenarios.