@stream-mdx/worker 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# @stream-mdx/worker
+
+## 0.0.3
+
+### Patch Changes
+
+- 47d1374: Add opt-in streaming format anticipation and an optional Mermaid diagram addon for ` ```mermaid ` code blocks.
+- 7c79f09: Port the docs demo page to match the ql-homepage streaming UI, and fix several streaming parser/rendering edge cases (hard line breaks and display-math handling) while keeping the hosted worker bundle self-contained for static hosting.
+- Updated dependencies [47d1374]
+- Updated dependencies [7c79f09]
+  - @stream-mdx/core@0.0.3
+  - @stream-mdx/plugins@0.0.3
+
+## 0.0.2
+
+### Patch Changes
+
+- 9e94660: Docs and release-quality improvements: ship package READMEs/CHANGELOGs, add pack+install smoke tests, expose MDX parity helper entrypoints, and add a deployable docs site workflow.
+- Updated dependencies [9e94660]
+  - @stream-mdx/core@0.0.2
+  - @stream-mdx/plugins@0.0.2
+
+## 0.0.1
+
+### Patch Changes
+
+- Release maintenance: CI/build fixes, missing runtime deps (e.g. `rehype-katex`), and improved docs/README wiring for the `stream-mdx` package page.
+- Updated dependencies
+  - @stream-mdx/core@0.0.1
+  - @stream-mdx/plugins@0.0.1

package/README.md

@@ -1,6 +1,8 @@
 # `@stream-mdx/worker`
 
-Web Worker entry point for the streaming renderer. Handles markdown parsing (Lezer), inline enrichment, Shiki highlighting, MDX detection, and patch emission. Consumers rarely interact with this package directly unless they need explicit control over worker instantiation or CSP compliance.
+Worker client utilities and hosted worker bundle used by StreamMDX.
+
+Most consumers interact with this package indirectly via `<StreamingMarkdown />`. You only need `@stream-mdx/worker` directly if you want explicit control over worker instantiation, MDX compilation parity helpers, or strict CSP setups.
 
 ## Install
 
@@ -8,53 +10,43 @@ Web Worker entry point for the streaming renderer. Handles markdown parsing (Lez
 npm install @stream-mdx/worker
 ```
 
-## Usage
+## Hosted worker bundle (recommended)
 
-```ts
-import { MarkdownWorkerClient } from "@stream-mdx/worker";
+For production, host the worker bundle from static assets (avoids `blob:` CSP requirements):
 
-const client = new MarkdownWorkerClient({
-  // For CSP-restricted environments, host the worker and point to it here:
-  workerUrl: "/workers/markdown-worker.js",
-});
+```bash
+mkdir -p public/workers
+cp node_modules/@stream-mdx/worker/dist/hosted/markdown-worker.js public/workers/markdown-worker.js
+```
 
-client.onMessage((msg) => {
-  if (msg.type === "PATCH") {
-    // apply patches
-  }
-});
+Then point StreamMDX at it:
 
-client.init("# Hello");
+```tsx
+<StreamingMarkdown worker="/workers/markdown-worker.js" />
 ```
 
-`MarkdownWorkerClient` will try `createDefaultWorker()` first (Blob/inline), then fall back to a hosted worker URL (`/workers/markdown-worker.js` by default).
+## Node / CLI worker threads
 
-> Keep `docPlugins` in sync with the renderer when enabling math+MDX. Follow the [cookbook recipe](../../docs/STREAMING_MARKDOWN_PLUGINS_COOKBOOK.md#5-math--mdx-workerrenderer-registration); the worker and React packages now ship tests enforcing it.
+To run the hosted worker bundle in Node (e.g., Ink TUIs), use:
 
-## Message unions
+```ts
+import { createWorkerThread } from "@stream-mdx/worker/node";
+```
 
-| Type | Direction | Payload |
-| --- | --- | --- |
-| `INIT` | Main → Worker | `{ text?: string; stream?: boolean; prewarmLangs?: string[]; plugins?: PluginConfig }` |
-| `APPEND` | Main → Worker | `{ chunk: string }` |
-| `FINALIZE` | Main → Worker | Flush + emit remaining patches. |
-| `RESET` | Main → Worker | Clear state (used on restart). |
-| `PATCH` | Worker → Main | `{ tx, at, patches: Patch[], notes }` |
-| `METRICS` | Worker → Main | Parse/highlight timings, block stats. |
-| `INITIALIZED`, `ERROR`, `DEBUG` | Worker → Main | Lifecycle events. |
+This spawns a `worker_threads` worker and installs WebWorker-like shims so the hosted bundle can run under Node.
 
-Exact shapes live in `@stream-mdx/core` (`WorkerMessageIn`, `WorkerMessageOut`).
+## MDX compilation parity helper
 
-## Hosting guidance
+If you compile MDX on the server (e.g. Next.js API route), use the same compilation logic as the worker:
 
-- **Blob (default):** easiest for local dev, but CSP must allow `blob:` execution.
-- **Hosted URL:** build the hosted worker bundle and copy it into your app’s static assets (e.g. `public/workers/markdown-worker.js`).
-- **Build hosted worker:** from the repo root, run `npm run worker:build`.
+```ts
+import { compileMdxContent } from "@stream-mdx/worker/mdx-compile";
+```
 
-For CSP-restricted environments, prehost the worker and set `Cross-Origin-Embedder-Policy` / `Cross-Origin-Opener-Policy` headers if you rely on SharedArrayBuffers.
+See `docs/REACT_INTEGRATION_GUIDE.md` for the full wiring and parity notes.
 
-## Troubleshooting
+## Docs
 
-- **`setStreamLimit` missing** – ensure you updated the demo automation shim; the worker no longer exports legacy control messages.
-- **Import errors in worker bundle** – verify your bundler targets `type: "module"` workers and preserves ESM syntax. When in doubt, use the prebuilt `public/workers/markdown-worker.js`.
-- **MDX compilation issues** – match the worker’s plugin registry with the React side, and confirm you set `mdxCompileMode="worker"` if you expect in-worker compilation.
+- React integration guide: `docs/REACT_INTEGRATION_GUIDE.md`
+- Security model / CSP: `docs/SECURITY_MODEL.md`
+- Plugins & custom worker bundles: `docs/STREAMING_MARKDOWN_PLUGINS_COOKBOOK.md`