@brett_lamy/docstream 0.3.5 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brett_lamy/docstream",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "GitBook-aware readonly markdown and AI stream renderer.",
   "type": "module",
   "main": "./src/index.ts",
@@ -75,4 +75,4 @@
     "@types/react": "^18.3.3",
     "typescript": "^5.5.4"
   }
-}
+}

package/src/index.ts

@@ -1,6 +1,7 @@
 export { PlaygroundStreamdown as GitbookStreamdown } from "./playground/PlaygroundStreamdown"
 export type { PlaygroundStreamdownProps as GitbookStreamdownProps } from "./playground/PlaygroundStreamdown"
 export { DocsRenderer, MarkdownContent } from "./docs/DocsRenderer"
+export type { LivePreviewProps, LivePreviewRenderer } from "./docs/DocsRenderer"
 export { ReplayEmbed, ReplayPreview } from "./replay"
 export type {
   ReplayEventsSource,

package/src/playground/ReactCodePreview.tsx

@@ -4,6 +4,7 @@ import {
   createReactDemoFiles,
   type AlmostNodeFiles,
   type AlmostNodeWorkspace,
+  type AlmostNodeWorkspaceOptions,
 } from "./filesystem"
 
 export interface ReactDemoProps {
@@ -21,6 +22,8 @@ export interface ReactDemoProps {
   autoStart?: boolean
   /** iframe sandbox value. The same-origin permission lets the almost-node service worker route the preview. */
   sandbox?: string
+  /** Extra options spread into `createAlmostNodeWorkspace` (e.g. `basePath` for static hosting). */
+  workspaceOptions?: Partial<AlmostNodeWorkspaceOptions>
   className?: string
   onReady?: (url: string) => void
   onError?: (error: Error) => void
@@ -49,6 +52,7 @@ export function ReactDemo({
   title = "Live React preview",
   autoStart = true,
   sandbox = "allow-scripts allow-same-origin allow-forms allow-modals",
+  workspaceOptions,
   className,
   onReady,
   onError,
@@ -77,9 +81,11 @@ export function ReactDemo({
       try {
         const projectFiles = createReactDemoFiles(files, { entry })
         workspace = await createAlmostNodeWorkspace(projectFiles, {
-          env: DETACHED_SERVER_ENV,
-          onServerReady: (_port, serverUrl) => {
+          ...workspaceOptions,
+          env: { ...DETACHED_SERVER_ENV, ...workspaceOptions?.env },
+          onServerReady: (serverPort, serverUrl) => {
             readyUrl = serverUrl.endsWith("/") ? serverUrl : `${serverUrl}/`
+            workspaceOptions?.onServerReady?.(serverPort, serverUrl)
           },
         })
 
@@ -114,7 +120,7 @@ export function ReactDemo({
       cancelled = true
       workspace?.dispose()
     }
-  }, [entry, files, onError, onReady, port, run])
+  }, [entry, files, onError, onReady, port, run, workspaceOptions])
 
   const wrapperClass = className ? `docs-react-demo ${className}` : "docs-react-demo"
   const running = state === "starting"