@invinite-org/chartlang-host-worker 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,228 @@
+# @invinite-org/chartlang-host-worker
+
+## 1.0.1
+
+### Patch Changes
+
+- d1de692: Fix end-user-blocking Node-ESM packaging bug. Every published `dist/index.js` previously failed to load under Node's strict ESM resolver because `tsc` had been configured with `moduleResolution: "Bundler"` and emitted relative specifiers verbatim, so `dist/index.js` carried `from "./api"` (extensionless) and Node rejected the resolution. Workspace consumers never saw this because tsx / vitest / Vite resolve loosely, but `npm install @invinite-org/chartlang-compiler` followed by `import` failed immediately for any Node consumer, and `examples/react-demo/vite.config.ts`'s server-side compile plugin broke at dev-config-load time.
+
+  This release switches `tsconfig.base.json` to `module: "NodeNext"` / `moduleResolution: "NodeNext"`, and rewrites every relative import / export / dynamic-import / `typeof import("…")` specifier across all packages' source to carry an explicit `.js` (or `/index.js`) suffix. The new resolution mode also surfaces this bug class as a compile error rather than runtime breakage, so it cannot regress.
+
+  No behavioural change for runtime consumers — the rewritten specifiers resolve to the same TypeScript sources at build time and the same `dist/<path>.js` files at consumer-load time.
+
+- 4d44a9c: Three host-robustness fixes discovered during real end-user testing:
+
+  - **`host-worker`**: `createWorkerHost().load(...)` no longer hangs forever when the underlying `Worker` fails to boot (module fetch fails, exception during construction, OS-level crash). The host now subscribes to the worker's `error` event and rejects any in-flight (or subsequent) `load()` call with `worker failed to boot: <message>`. A new `HostLimits.maxLoadTimeoutMs` (default `30_000`) bounds the wait independently — a silently-dead worker that never fires `error` also can't hang a consumer. `MessagePort`-backed `WorkerLike` test seams remain compatible: the `error` subscription is silently ignored by ports that don't deliver that event.
+  - **`host-worker`**: Added a `./worker-boot` subpath export so Vite consumers can write `new Worker(new URL("@invinite-org/chartlang-host-worker/worker-boot", import.meta.url), { type: "module" })` instead of digging into `dist/`. The bundle is regenerated by `pnpm build` and now ships a minimal `.d.ts` next to it so NodeNext type-checking does not error on the bare specifier.
+  - **`host-quickjs`**: Added an in-process freshness gate (`dispatcherFreshness.test.ts`) that rebundles `src/dispatcher.ts` in memory via the same `bundleDispatcher()` function `pnpm build:dispatcher` uses, hashes both sides, and fails with a "run `pnpm build`" hint when the committed `dist/dispatcher.js` is stale. Prevents the "source fix landed but tests still pass against the old dispatcher" failure mode.
+
+- Updated dependencies [4d44a9c]
+- Updated dependencies [98599b2]
+- Updated dependencies [d1de692]
+- Updated dependencies [98599b2]
+  - @invinite-org/chartlang-adapter-kit@1.1.0
+  - @invinite-org/chartlang-runtime@1.0.1
+  - @invinite-org/chartlang-core@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- chartlang `1.0.0` -- the `apiVersion: 1` standard.
+
+  - `apiVersion: 1` frozen: compiler accepts only the frozen language
+    version; `STATEFUL_PRIMITIVES` locked at 172 entries by exact
+    name-set; every shipping export `@stable`; pre-1.0 deprecations
+    removed (`PHASE_1_SCENARIOS`).
+  - Canonical language spec published (`docs/spec/`): grammar,
+    semantics, manifest, emissions, versioning -- self-contained for
+    alternate implementations. The `v1.0.0` tag is the frozen spec
+    snapshot.
+  - Public conformance reports: `pnpm conformance --report` emits
+    `CONFORMANCE.md` + `conformance-report.json`; canvas2d reference
+    report published and drift-gated.
+  - Adapter-author path proven end-to-end: scaffolded adapters ship a
+    wired conformance test; full writing-an-adapter tutorial +
+    Lightweight Charts porting walkthrough.
+  - Pine migration guide finalised with a pattern-coverage matrix
+    audited against the top ~50 Pine scripts.
+
+### Minor Changes
+
+- d14a034: Add phase 5 server alerts, multi-timeframe request handling, runtime persistence, QuickJS hosting, expanded plot and table rendering, color helpers, alert conditions, and volume profile primitives.
+
+### Patch Changes
+
+- Pre-1.0 surface cleanup: remove the deprecated `PHASE_1_SCENARIOS`
+  alias (use `ALL_SCENARIOS`) and promote every shipping export from
+  `@experimental` to `@stable` ahead of the `apiVersion: 1` freeze.
+- Updated dependencies [d14a034]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies [3cfff10]
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+  - @invinite-org/chartlang-adapter-kit@1.0.0
+  - @invinite-org/chartlang-core@1.0.0
+  - @invinite-org/chartlang-runtime@1.0.0
+
+## 0.5.0
+
+### Phase 5
+
+#### Minor Changes
+
+- Add the `@invinite-org/chartlang-host-worker/idb` subpath with an
+  IndexedDB-backed `PersistentStateStore` for browser warm starts, per PLAN.md
+  §6.9 and §8.2.
+- Replace the Phase 4 `request.security` NaN-only path with real
+  multi-timeframe secondary stream alignment per PLAN.md §6.8 and §7.2.
+  Adapters can route tagged `CandleEvent.streamKey` candles, the worker
+  host dispatches them through `ScriptRunner.push`, conformance includes
+  MTF scenarios, and the private canvas2d reference adapter now declares
+  `multiTimeframe: true`.
+
+#### Patch Changes
+
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+  - @invinite-org/chartlang-core@0.5.0
+  - @invinite-org/chartlang-adapter-kit@0.5.0
+  - @invinite-org/chartlang-runtime@0.5.0
+
+## 0.4.0
+
+### Minor Changes
+
+- 3f3ce38: Phase-1 walking-skeleton: ship the canvas2d reference adapter
+  (`examples/canvas2d-adapter`). The private example package now
+  exports `createCanvas2dAdapter`, `runRendererLoop`,
+  `CANVAS2D_CAPABILITIES`, `DEFAULT_PALETTE`, plus a
+  `./testing` sub-path entry carrying `MockCanvas2DContext` +
+  `hashCallLog` for sibling-package conformance tests (Task 12).
+
+  Two cross-package adjustments rode along:
+
+  - `@invinite-org/chartlang-host-worker` adds `createWorkerBoot`
+    and `WorkerBootScope` to its public barrel so consumer-repo
+    tests (and Task 10's integration test) can pair the worker host
+    against a `MessageChannel`-backed scope. The boot factory was
+    always testable from within the package; this exposes it as a
+    stable surface.
+  - `@invinite-org/chartlang-runtime`'s `makeSeriesView` Proxy now
+    defines a `has` trap so `"current" in series` (and
+    `"length" in series`, `"<n>" in series`) returns `true`. This
+    unblocks `runtime/src/emit/plot.ts`'s `isSeriesNumber` check —
+    previously the Proxy reported `false` for `in`, so calls like
+    `plot(ta.ema(...))` with the real runtime Series threw the
+    "outside an active script step" sentinel. Discovered via Task
+    10's end-to-end integration test driving an EMA-cross bundle
+    through the worker host into the canvas2d renderer.
+
+- 3f3ce38: Land the Phase-1 browser-default `ScriptHost`. `createWorkerHost`
+  boots a Web Worker, loads a compiled chartlang bundle via a
+  `data:` URL dynamic import, and round-trips `CandleEvent` /
+  `RunnerEmissions` over a structured-clone-safe postMessage
+  protocol (`HostToWorker` / `WorkerToHost`). The `load` frame
+  carries the adapter's `Capabilities` bag and the host's
+  `HostLimits`; the worker boot is stateless about both. A
+  measurement-only watchdog times every `candleEvent` dispatch
+  against `maxCpuMsPerStep` and posts `step-overshoot` (no
+  preemption — real interrupt-based caps land with the QuickJS
+  host in Phase 5). Drains validate every plot / alert through
+  `adapter-kit`'s `validateEmission` before posting; malformed
+  emissions become `malformed-emission` diagnostics. Replaces the
+  Phase-0 `PACKAGE_VERSION` placeholder.
+- Resolve runtime `input.*` overrides at mount, add adapter input resolver wiring, and audit universal `ta.*` offset support.
+
+### Patch Changes
+
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [3f3ce38]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [38fb475]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies [b0d296b]
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+- Updated dependencies
+  - @invinite-org/chartlang-adapter-kit@0.4.0
+  - @invinite-org/chartlang-runtime@0.4.0
+  - @invinite-org/chartlang-core@0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Invinite
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @invinite-org/chartlang-host-worker
+
+`experimental`
+
+Browser-default `ScriptHost` for chartlang. Boots a Web Worker, loads a
+compiled script bundle, and round-trips `CandleEvent` / `RunnerEmissions`
+across a structured-clone-safe postMessage protocol.
+
+## Install
+
+```bash
+pnpm add @invinite-org/chartlang-host-worker
+```
+
+## Public surface
+
+- `createWorkerHost(opts) → ScriptHost` — main-side factory; the canvas2d
+  reference adapter (Task 10) consumes the returned host.
+- `DEFAULT_LIMITS` — Phase-1 `HostLimits` defaults
+  (`maxCpuMsPerStep: 50`, `maxHeapBytes: 64 MiB`, `maxRingBufferBars: 5000`,
+  `maxLoadTimeoutMs: 30000`).
+- `idbStateStore(opts)` from `@invinite-org/chartlang-host-worker/idb` —
+  IndexedDB `PersistentStateStore` for browser warm starts.
+- Persists one snapshot per `StateStoreKey`; default cap is 50 MiB.
+- Oldest snapshots are evicted first when writes exceed the cap.
+- `@invinite-org/chartlang-host-worker/worker-boot` — bundled worker entry
+  for Vite / bundler `new Worker(new URL(...))` patterns. Side-effect only.
+- Types: `ScriptHost`, `HostLimits`, `WorkerLike`, `HostCompiledScript`,
+  `HostToWorker`, `WorkerToHost`, `CreateWorkerHostOpts`.
+
+## Minimum-viable API call
+
+```ts
+import { createWorkerHost } from "@invinite-org/chartlang-host-worker";
+// host: ScriptHost — passed to an adapter at construction time.
+```
+
+### Vite worker URL
+
+```ts
+const url = new URL(
+    "@invinite-org/chartlang-host-worker/worker-boot",
+    import.meta.url,
+);
+const worker = new Worker(url, { type: "module" });
+const host = createWorkerHost({ capabilities, workerLike: worker });
+```
+
+## Stability
+
+Phase 1 ships the postMessage wire protocol + a measurement-based CPU
+watchdog (`step-overshoot` reports observed elapsed ms; no preemption).
+Deferred to Phase 5 (per PLAN §19):
+
+- Worker-side CSP enforcement.
+- Hard heap caps (`maxHeapBytes` is advisory today — no browser API
+  exposes a reliable per-worker heap limit).
+- Real preemption via `setInterruptHandler` (lands with the QuickJS
+  host).
+- Fingerprint-only globals (`Math.random`, `Date.now`, …) — Phase 1
+  relies on the compiler's `forbiddenConstructs` pass to scrub these
+  from the bundle before it ever reaches a worker.
+
+## Docs
+
+See [`docs/hosts/worker.md`](../../docs/hosts/worker.md).
+
+## License
+
+MIT

package/dist/createWorkerBoot.d.ts

@@ -0,0 +1,45 @@
+import type { HostToWorker, WorkerToHost } from "./protocol.js";
+/**
+ * Duck-typed slice of the worker global scope the boot factory needs. Lets
+ * tests drive `createWorkerBoot` against a `MessageChannel` port without
+ * faking the full `WorkerGlobalScope`.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     const scope: WorkerBootScope = {
+ *         addEventListener: () => {},
+ *         postMessage: () => {},
+ *     };
+ *     void scope;
+ */
+export type WorkerBootScope = {
+    addEventListener(type: "message", listener: (ev: MessageEvent<HostToWorker>) => void): void;
+    postMessage(msg: WorkerToHost): void;
+};
+/**
+ * Wire `scope` to the host-worker postMessage protocol. Lazily imports the
+ * compiled module via a `data:` URL so the same code path runs inside a real
+ * browser `Worker` and inside Node tests (`MessageChannel`-backed).
+ *
+ * Lifecycle:
+ *
+ * - `load` → dynamic import → `createScriptRunner(...)` → cache `limits`.
+ *   Posts `loaded` on success or `loadError` on failure.
+ * - `candleEvent` → wrap dispatch in `watchStep(...)`; post `step-overshoot`
+ *   when over budget. Errors map to `fatal`.
+ * - `drain` → validate every plot / alert emission; sink malformed ones into
+ *   the diagnostics array; post `emissions` with the original nonce.
+ * - `dispose` → release the runner; subsequent messages map to `fatal`.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     // import { createWorkerBoot } from "@invinite-org/chartlang-host-worker";
+ *     // const scope = self;
+ *     // createWorkerBoot(scope);
+ *     const fn: typeof createWorkerBoot = createWorkerBoot;
+ *     void fn;
+ */
+export declare function createWorkerBoot(scope: WorkerBootScope): void;
+//# sourceMappingURL=createWorkerBoot.d.ts.map

package/dist/createWorkerBoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWorkerBoot.d.ts","sourceRoot":"","sources":["../src/createWorkerBoot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGhE;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,YAAY,CAAC,YAAY,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5F,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAC;CACxC,CAAC;AAiBF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAkF7D"}

package/dist/createWorkerBoot.js

@@ -0,0 +1,122 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { createScriptRunner } from "@invinite-org/chartlang-runtime";
+import { filterEmissions } from "./filterEmissions.js";
+import { watchStep } from "./limits.js";
+async function importCompiledModule(moduleSource) {
+    // `encodeURIComponent` preserves multi-byte UTF-8 across the data URL
+    // without the Annex-B `unescape` round-trip. ESM `import("data:…")`
+    // accepts percent-encoded text/javascript directly in both browsers
+    // and Node 20+.
+    const url = `data:text/javascript;charset=utf-8,${encodeURIComponent(moduleSource)}`;
+    return (await import(/* @vite-ignore */ url));
+}
+function isFrame(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const k = value.kind;
+    return typeof k === "string";
+}
+/**
+ * Wire `scope` to the host-worker postMessage protocol. Lazily imports the
+ * compiled module via a `data:` URL so the same code path runs inside a real
+ * browser `Worker` and inside Node tests (`MessageChannel`-backed).
+ *
+ * Lifecycle:
+ *
+ * - `load` → dynamic import → `createScriptRunner(...)` → cache `limits`.
+ *   Posts `loaded` on success or `loadError` on failure.
+ * - `candleEvent` → wrap dispatch in `watchStep(...)`; post `step-overshoot`
+ *   when over budget. Errors map to `fatal`.
+ * - `drain` → validate every plot / alert emission; sink malformed ones into
+ *   the diagnostics array; post `emissions` with the original nonce.
+ * - `dispose` → release the runner; subsequent messages map to `fatal`.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     // import { createWorkerBoot } from "@invinite-org/chartlang-host-worker";
+ *     // const scope = self;
+ *     // createWorkerBoot(scope);
+ *     const fn: typeof createWorkerBoot = createWorkerBoot;
+ *     void fn;
+ */
+export function createWorkerBoot(scope) {
+    let runner = null;
+    let limits = null;
+    scope.addEventListener("message", async (ev) => {
+        const msg = ev.data;
+        if (!isFrame(msg)) {
+            scope.postMessage({
+                kind: "fatal",
+                message: "malformed host frame: not a plain object with a string 'kind'",
+            });
+            return;
+        }
+        if (msg.kind === "load") {
+            try {
+                const mod = await importCompiledModule(msg.compiled.moduleSource);
+                runner = createScriptRunner({
+                    compiled: mod.default,
+                    capabilities: msg.capabilities,
+                    ...(msg.symInfo !== undefined ? { symInfo: msg.symInfo } : {}),
+                    ...(msg.inputOverrides !== undefined
+                        ? { inputOverrides: msg.inputOverrides }
+                        : {}),
+                });
+                limits = msg.limits;
+                scope.postMessage({ kind: "loaded" });
+            }
+            catch (err) {
+                scope.postMessage({
+                    kind: "loadError",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+            return;
+        }
+        try {
+            switch (msg.kind) {
+                case "candleEvent": {
+                    if (runner === null || limits === null) {
+                        throw new Error("candleEvent before load");
+                    }
+                    const r = runner;
+                    const { overshoot } = await watchStep(() => r.push(msg.event), limits.maxCpuMsPerStep);
+                    if (overshoot > 0) {
+                        scope.postMessage({ kind: "step-overshoot", observedMs: overshoot });
+                    }
+                    break;
+                }
+                case "drain": {
+                    if (runner === null) {
+                        throw new Error("drain before load");
+                    }
+                    const cleaned = filterEmissions(runner.drain());
+                    scope.postMessage({
+                        kind: "emissions",
+                        nonce: msg.nonce,
+                        emissions: cleaned,
+                    });
+                    break;
+                }
+                case "dispose": {
+                    await runner?.dispose();
+                    runner = null;
+                    limits = null;
+                    break;
+                }
+                default: {
+                    throw new Error(`unknown frame kind: ${msg.kind}`);
+                }
+            }
+        }
+        catch (err) {
+            scope.postMessage({
+                kind: "fatal",
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+}
+//# sourceMappingURL=createWorkerBoot.js.map

package/dist/createWorkerBoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWorkerBoot.js","sourceRoot":"","sources":["../src/createWorkerBoot.ts"],"names":[],"mappings":"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"}

package/dist/createWorkerHost.d.ts

@@ -0,0 +1,55 @@
+import type { AdapterSymInfo, Capabilities } from "@invinite-org/chartlang-adapter-kit";
+import type { HostLimits, ScriptHost, WorkerLike } from "./types.js";
+/**
+ * Constructor options for {@link createWorkerHost}.
+ *
+ * - `capabilities` — the adapter's declared capability bag. Bolted onto every
+ *   `load` postMessage; the worker boot never falls back to a default.
+ * - `symInfo` — optional adapter-supplied metadata for runtime `syminfo.*`.
+ * - `resolveInputs` — optional adapter callback. The host resolves it during
+ *   `load()` and sends the plain override record to the worker.
+ * - `workerLike` — injection seam for tests. Production callers omit it; the
+ *   host then constructs a real `Worker` via {@link defaultWorkerFactory}.
+ * - `limits` — partial `HostLimits` overrides; missing fields fall through to
+ *   {@link DEFAULT_LIMITS}.
+ * - `onWorkerError` — called when the worker posts `step-overshoot` or
+ *   `fatal`. The host does not synthesize diagnostics into the next
+ *   `drain()` — Phase 1 keeps overshoot surfacing on the adapter.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     const opts: CreateWorkerHostOpts = {
+ *         capabilities: {} as Capabilities,
+ *     };
+ *     void opts;
+ */
+export type CreateWorkerHostOpts = {
+    readonly capabilities: Capabilities;
+    readonly symInfo?: AdapterSymInfo;
+    readonly resolveInputs?: (scriptId: string) => Readonly<Record<string, unknown>>;
+    readonly workerLike?: WorkerLike;
+    readonly limits?: Partial<HostLimits>;
+    readonly onWorkerError?: (message: string) => void;
+};
+/**
+ * Build a browser-default `ScriptHost` around a Web Worker. The host
+ * round-trips `load` / `push` / `drain` / `dispose` calls across the worker
+ * boundary via structured-clone-safe postMessage frames defined in
+ * {@link HostToWorker} / {@link WorkerToHost}.
+ *
+ * The host owns the `nonce` counter for `drain` correlation, the in-flight
+ * `load` promise, and the in-flight drain registry. `dispose` posts the
+ * tear-down message, calls `terminate()` when the underlying `WorkerLike`
+ * supports it, and clears the pending-drain map.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { createWorkerHost } from "@invinite-org/chartlang-host-worker";
+ *     // const host = createWorkerHost({ capabilities });
+ *     const fn: typeof createWorkerHost = createWorkerHost;
+ *     void fn;
+ */
+export declare function createWorkerHost(opts: CreateWorkerHostOpts): ScriptHost;
+//# sourceMappingURL=createWorkerHost.d.ts.map

package/dist/createWorkerHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWorkerHost.d.ts","sourceRoot":"","sources":["../src/createWorkerHost.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,cAAc,EACd,YAAY,EAEf,MAAM,qCAAqC,CAAC;AAK7C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD,CAAC;AAaF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,UAAU,CA+IvE"}