@clipbus/plugin-sdk 0.8.4 → 0.8.5

package/dist/preview/index.d.cts

@@ -0,0 +1,46 @@
+/**
+ * @clipbus/plugin-sdk/preview
+ *
+ * Framework-neutral development-time preview harness.
+ * Provides a minimal bidirectional fake host for iterating on plugin UIs
+ * without a real macOS host process.
+ *
+ * Usage:
+ * ```ts
+ * import { createPreviewWorkbench } from '@clipbus/plugin-sdk/preview';
+ *
+ * createPreviewWorkbench(document.getElementById('app')!, {
+ *   scenarios,
+ *   mount(slotEl, { scenario }) {
+ *     const app = createApp(MyPlugin);
+ *     app.mount(slotEl);
+ *     return () => app.unmount();
+ *   },
+ * });
+ * ```
+ */
+import type { PreviewWorkbenchOptions } from './types.js';
+export type { PreviewViewport, PreviewScenario, PreviewWorkbenchOptions } from './types.js';
+export type { WirePayloads } from './wire.js';
+export type { PreviewThemePreset } from './theme.js';
+export { computeWirePayloads, injectWire, applyThemeCssVars, THEME_CSS_VAR_NAMES } from './wire.js';
+export { installFakeHost } from './fakeHost.js';
+export type { FakeHostHooks } from './fakeHost.js';
+export { defaultDarkTheme, defaultLightTheme } from './theme.js';
+export { previewThemePresets, DEFAULT_THEME_KEY, getThemePreset, } from './theme.js';
+export { groupScenariosByMode, resolveViewportWidth, clampWidth } from './chrome.js';
+export { PLUGIN_CALL_HANDLER_NAME, WINDOW_SET_HEIGHT_METHOD, } from '../generated/wireConstants.generated.js';
+/**
+ * Mount a preview workbench into `root`.
+ *
+ * Orchestration order:
+ *   1. Inject workbench styles.
+ *   2. Install fake host (hooks → log panel + viewport height).
+ *   3. Render chrome (selectors, viewport, card shell, button strip, log panel).
+ *   4. On each scenario activation:
+ *      a. computeWirePayloads(scenario, presetKey) → injectWire (host→plugin bootstrap).
+ *      b. Call opts.mount(slotEl, { scenario }) → get cleanup fn.
+ *   5. On theme change: re-inject wire (no remount) so theme subscribers restyle.
+ *   6. On scenario switch: cleanup previous → repeat step 4.
+ */
+export declare function createPreviewWorkbench(root: HTMLElement, opts: PreviewWorkbenchOptions): void;

package/dist/preview/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @clipbus/plugin-sdk/preview
+ *
+ * Framework-neutral development-time preview harness.
+ * Provides a minimal bidirectional fake host for iterating on plugin UIs
+ * without a real macOS host process.
+ *
+ * Usage:
+ * ```ts
+ * import { createPreviewWorkbench } from '@clipbus/plugin-sdk/preview';
+ *
+ * createPreviewWorkbench(document.getElementById('app')!, {
+ *   scenarios,
+ *   mount(slotEl, { scenario }) {
+ *     const app = createApp(MyPlugin);
+ *     app.mount(slotEl);
+ *     return () => app.unmount();
+ *   },
+ * });
+ * ```
+ */
+import type { PreviewWorkbenchOptions } from './types.js';
+export type { PreviewViewport, PreviewScenario, PreviewWorkbenchOptions } from './types.js';
+export type { WirePayloads } from './wire.js';
+export type { PreviewThemePreset } from './theme.js';
+export { computeWirePayloads, injectWire, applyThemeCssVars, THEME_CSS_VAR_NAMES } from './wire.js';
+export { installFakeHost } from './fakeHost.js';
+export type { FakeHostHooks } from './fakeHost.js';
+export { defaultDarkTheme, defaultLightTheme } from './theme.js';
+export { previewThemePresets, DEFAULT_THEME_KEY, getThemePreset, } from './theme.js';
+export { groupScenariosByMode, resolveViewportWidth, clampWidth } from './chrome.js';
+export { PLUGIN_CALL_HANDLER_NAME, WINDOW_SET_HEIGHT_METHOD, } from '../generated/wireConstants.generated.js';
+/**
+ * Mount a preview workbench into `root`.
+ *
+ * Orchestration order:
+ *   1. Inject workbench styles.
+ *   2. Install fake host (hooks → log panel + viewport height).
+ *   3. Render chrome (selectors, viewport, card shell, button strip, log panel).
+ *   4. On each scenario activation:
+ *      a. computeWirePayloads(scenario, presetKey) → injectWire (host→plugin bootstrap).
+ *      b. Call opts.mount(slotEl, { scenario }) → get cleanup fn.
+ *   5. On theme change: re-inject wire (no remount) so theme subscribers restyle.
+ *   6. On scenario switch: cleanup previous → repeat step 4.
+ */
+export declare function createPreviewWorkbench(root: HTMLElement, opts: PreviewWorkbenchOptions): void;