typebulb 0.7.2 → 0.9.0

package/dist/render.d.ts

@@ -0,0 +1,28 @@
+export interface RenderBulbResult {
+  /** Complete standalone HTML document, ready for an iframe srcdoc. */
+  html?: string
+  /** Set instead of `html` when the source couldn't be rendered. */
+  error?: string
+}
+
+/** Compile a bulb source string to a standalone HTML document (client-only).
+ *  Pass `theme` to force the embed's light/dark mode (e.g. match the host). */
+export declare function renderBulb(source: string, opts?: { theme?: 'light' | 'dark' }): Promise<RenderBulbResult>
+
+export interface BulbFrameOptions {
+  /** Force light/dark. Omit to inherit the host's `data-theme` automatically. */
+  theme?: 'light' | 'dark'
+  /** Floor for auto-height; the frame grows past it but never shrinks below. Default 320. */
+  minHeight?: number
+  /** Ceiling for auto-height; bounds an absurd height from a buggy/hostile embed. Default 100000. */
+  maxHeight?: number
+  /** Called with a message when the embed throws at runtime (post-mount). */
+  onError?: (message: string) => void
+  /** Abort to remove the frame's host-side `message` listener (host owns lifecycle). */
+  signal?: AbortSignal
+}
+
+/** Render a bulb and return a ready-to-mount, sandboxed iframe: owns the
+ *  `allow-scripts` sandbox policy and the host<->embed protocol (auto-height +
+ *  runtime-error forwarding). Rejects if the bulb can't compile. */
+export declare function createBulbFrame(source: string, opts?: BulbFrameOptions): Promise<HTMLIFrameElement>