@vibesdotdev/host-bun 0.0.0-stage → 1.0.0-rc.2

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 VIBES DEV LLC
+
+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

@@ -1,3 +1,223 @@
-# Temporary Holding Version
+# @vibesdotdev/host-bun
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Bun host bindings for the Vibes runtime. A host selects this provider once;
+reusable features receive the runtime and resolve its environment, execution,
+loader, paths and sockets through their public kinds.
+
+This package is part of the public Vibes framework package set. The source repository is private while the public repository split is being prepared, so package documentation is published on the Vibes docs site.
+
+## Native protocol networking
+
+The environment warms `host.native-network`. Resolve it with
+`getVibesClient<NativeNetworkClient>('host.native-network', runtime)`, importing
+the type from `@vibesdotdev/host-bun/native-network`. Native hosts composing
+their own environment can register `bunNativeNetworkPlugin` from
+`@vibesdotdev/host-bun/native-network/plugin`.
+
+The client creates raw HTTP servers, SSH servers, real WebSocket servers and
+outbound WebSockets, and verifies SSH signed blobs with ssh2's key verifier.
+Native compatibility types and `WebSocketState` are available on the same
+subpath. Caller-owned host keys and protocol limits pass through explicitly.
+Resources remain caller-closeable; runtime disposal drains and joins them,
+forcing stalled peers after its declared shutdown budget. Native cloud Bun
+hosts have the same networking and SQLite admission as consumer Bun hosts.
+Browser surfaces and non-native loader substrates refuse these capabilities.
+
+## Install
+
+```sh
+bun add @vibesdotdev/host-bun
+# or
+npm install @vibesdotdev/host-bun
+```
+
+## Boot a Bun host
+
+```ts
+import { bootstrapVibesRuntime } from '@vibesdotdev/kernel';
+import { createRuntimeEnvironmentBunPlugin } from '@vibesdotdev/host-bun';
+import { getPathRoots } from '@vibesdotdev/paths';
+
+const runtime = await bootstrapVibesRuntime({
+  environment: createRuntimeEnvironmentBunPlugin({
+    scope: {
+      surface: 'cli',
+      hardware: 'consumer',
+      purpose: 'direct',
+      lifecycle: 'finite',
+      hosting: { mode: 'local', owner: 'consumer', venue: 'user-device' },
+      capabilities: { interactiveSession: true },
+      qualifiers: { dev: false, environmentTier: 'local' }
+    }
+  }),
+  composition: { kind: 'literal', plugins: [] },
+  binding: 'owned'
+});
+
+try {
+  console.log(getPathRoots(runtime).activeHome);
+} finally {
+  await runtime.dispose();
+}
+```
+
+Declare the host's actual scope. There is no default environment plugin.
+The configured plugin registers the `runtime-environment-bun` documentation
+topic beneath Runtime in the Docs catalog.
+`workspace.root` declares the workspace to capture; `host.root` declares the
+resolution root for filesystem plugin composition. They serve different
+purposes. Path layout overrides belong to the factory's `paths` option and
+are validated by `@vibesdotdev/paths`.
+
+For multiple runtimes in one process, create one `createBunHostResources()`
+from `./services/standard-output` and pass it as `hostResources` to each factory.
+Use `createBunStandardOutput(hostResources)` for output before boot and after
+failed boot. `setOutputPlaneFormatter(formatter, hostResources)` selects its
+renderer before registration. The last runtime release drains output, restores
+console/stream hooks and detaches native observers; it preserves the formatter
+for later reporting. Each runtime resolves its own `bun-host` semantic client
+through `getVibesClient('bun-host', runtime)`; disposal attempts every native
+transport cleanup and reports failures together. With `hostResources` omitted,
+each runtime constructs and releases its own resources, including when the same
+plugin is reused. `BunHostClient` and `bunHostClientDescriptor` are exported for
+`getVibesClient<BunHostClient>('bun-host', runtime)` and synchronous
+`tryGetVibesClient` from `@vibesdotdev/kernel/client` after activation.
+
+Independent stdin owners detach only their own branch; retiring either owner
+preserves byte delivery to the survivor. Independent output owners preserve the
+surviving formatter and restore the original hooks on final retirement, through
+execution-local's canonical output-plane base. No host-local registry or
+replacement output-plane implementation is introduced.
+
+The client's `resources` property exposes its explicit owner.
+`createBunStandardOutput(runtime)` uses `tryGetVibesClient` synchronously;
+an unavailable client refuses `UNAVAILABLE bun-host-client-unavailable`.
+Direct stdio construction borrows the activated client's resources, or owns
+and disposes its resources when there is no client. Direct signal construction
+owns and detaches its native fatal source unless a source is supplied.
+`captureBunCliProcessHost(resources)` accepts the same explicit output owner.
+
+Legacy no-owner output and process-fatal helpers resolve the activated
+`bun-host` client on every call. The facade holds no resources. Before boot
+and after disposal, executable owners must pass explicit resources through
+formatter selection, environment construction, reporting, flush and disposal.
+External migration remains for surface-cli's Bun host, cli-bin's monolith,
+shield-cli's entry and cli's bootstrap.
+The root socket class export remains for
+`workspace/src/daemon/__tests__/owned.ts`; new concrete imports use
+`./services/runtime-socket`, and generic consumers resolve `runtime/socket`.
+
+The environment captures argv, cwd, environment variables and user/temp roots
+at construction. Child environments are composed from the handed runtime;
+later changes to `process.env` do not alter that host. Bun's asynchronous
+invocation store keeps concurrent actors, tenants and workspaces separate.
+
+The factory composes the canonical local execution plugin. Optional
+`restrictedExecution`, `heldLaunch` and `nativeLaunch` declarations go to that
+owner. An existing local plugin cannot silently replace an explicit admission.
+Without a held/native artifact declaration, ordinary execution remains available
+and resource-enforced launches refuse rather than guessing an artifact.
+
+Identity helpers use the activated client or explicit resources. Share one
+resource owner to pin physical executable evidence while retaining each
+environment's stable classification and source reference. Pre-boot callers pass
+`resources.classifier` to identity helpers and `resources.executable` to
+`executableHostFactsOf(runtime, executable)`. Missing environments refuse
+`INTERNAL/environment-unregistered`; missing activated or explicit owners
+refuse `UNAVAILABLE/bun-host-client-unavailable`. No ambient identity cache is used.
+
+Graph pins belong to `client.graph`. Before boot, own
+`createBunGraphFreshness()` from `./services/graph-freshness` and pass that
+owner to graph capture, lookup and freshness helpers. The standalone HTTP
+plugin reuses the host listener or resolves its own `bun-http-listener`
+client, which the kernel disposes.
+
+## Public surfaces
+
+| Import | Use |
+| --- | --- |
+| Package root | Configured environment factory, semantic client and compatibility host helpers |
+| `./loader` | Bun host module import, public export resolution and filesystem port |
+| `./local-execution` | Canonical local execution composition (`bunProcessHost`, which builds on this host's own `bunNativeProcessHost()`, its spawn and command discovery over `runtime-execution-local`'s bases and its PTY adapter, and adds buffered capture, the restricted macOS adapter and held launch over the `bun:ffi` artifact binding; `bunLocalExecutionPlugin`) and native manifest selection |
+| `./native/held-launch/abi`, `./native/held-launch/<target>` | The held-launch ABI manifest and the staged native artifact manifest for each of `aarch64-apple-darwin`, `x86_64-apple-darwin`, `aarch64-unknown-linux-gnu`, `x86_64-unknown-linux-gnu` (file exports; built by `bun run build:native`) |
+| `./buffered-capture` | The Bun file-backed buffered-capture backend `LocalExecution` retries through |
+| `./package-plugins` | This host's `runtime/package-plugins` (`createBunRuntimePackagePlugins`) and its primitives for the kernel's scope base (`createBunPackagePluginsHost`, `bunPackagePluginWrites`, `bunPackageManifestJsonc`); package-graph read admission (`planPackageReadAdmission`, `verifyPackageReadAdmission`). Plugin composition and the scope readers and writers are the kernel's (`@vibesdotdev/kernel/bootstrap`) |
+| `./host-credentials` | The CLI's pre-runtime `hasLiveHostCredentials` declaration (the manifest grammar and liveness verdict live in `@vibesdotdev/kernel`) |
+| `./services/runtime-path` | Native path mechanics over captured facts |
+| `./services/runtime-socket` | Local socket endpoint, listen, connect and readiness mechanics |
+| `./services/self-spawn` | Declared compiled/source re-entry argv |
+| `./services/workspace-env` | Workspace child environment composition |
+| `./services/process-action-lifetime` | Host signal admission and awaited cleanup |
+| `./services/user-environment` | Native user environment/profile discovery |
+| `./services/host-identity` | Captured host identity and executable shape |
+| `./services/executable-identity` | Replaced executable detection |
+| `./services/graph-freshness` | Per-runtime graph pin and freshness verdict |
+| `./test-tooling/svelte-compiler`, `./test-tooling/svelte-client-preload`, `./test-tooling/svelte-server-preload` | Test tooling: a Bun plugin that compiles `*.svelte.ts` modules and `*.svelte` components with the real Svelte compiler (`registerSvelteCompiler({ generate })`); packages wire a preload from their `bunfig.toml` (`preload = ["@vibesdotdev/host-bun/test-tooling/svelte-server-preload"]`) so no test imports `bun`. `svelte` is an optional peer. |
+| `./test-tooling/unix-http` | Test tooling: Bun HTTP over declared Unix sockets for one isolated test realm (`createUnixHttpServer`, `createUnixHttpFetch`, `installUnixHttpTransport`); refuses undeclared origins and overlapping fetch owners with `test-unix-http-*` reasons. Re-exported by `@vibesdotdev/testing/bun/http`. |
+| `./test-tooling/lazy-environment` | Test tooling: the environment, local-execution and HTTP-listener plugin factories with their root signatures, plus `createBunTestExecutionEnvironment({ scope, home })`, each loading this host on its first call. The door's graph excludes the restricted-execution supervisor, so a composition root can import it from any runner. Re-exported by `@vibesdotdev/testing/test-environment`. |
+
+These are Bun host APIs. Generic consumers use the Runtime and Paths contracts
+with their handed runtime so another selected provider remains usable.
+The selected stdio context supports an exclusive stdout-or-stderr/console capture lease
+through `getRuntimeStdioCapture(runtime)` (the lease's `target` names the stream),
+and a bounded stdin read through `getRuntimeStdin(runtime)`. It preserves native byte forwarding,
+backpressure and callback completion, and restores its owned hooks on close or
+Runtime disposal. The calling feature supplies framing and rendering policy.
+`getBunEnvironment` is for code that owns a Bun host; it intentionally refuses a
+different environment with `UNAVAILABLE bun-environment-unavailable`. The
+package's publish load probe runs under Bun.
+
+Workspace MCP identity belongs to the synchronous, runtime-neutral
+`@vibesdotdev/paths/workspace-mcp-host` contract. Its Shared hashing
+implementation needs no native environment binding.
+
+Plugin selection uses declared public exports and installed workspace links.
+It never installs packages at startup or scans source for an implementation.
+Writers preserve JSONC comments and sibling keys, refuse malformed input before
+editing, and refresh member resolution after successful link/unlink writes.
+
+Freshness has three outcomes: replaced, verified unchanged, and unknown.
+Unreadable evidence is unknown. Process-table failures propagate, and missing
+host facts produce typed refusals rather than an ambient fallback.
+
+See [SPEC.md](SPEC.md) for the owner contract, [the package guide](https://docs.vibes.dev/runtime-environment-bun)
+and [Vibes docs](https://docs.vibes.dev) for the framework contracts.
+
+## Verification
+
+Buffered fallback scenarios resolve execution through an owned composed runtime,
+the public execution plugin and Bun process ports. Direct backend checks remain.
+The zero-timeout success assertion is preserved: kernel's
+`src/execution/schemas/execute.ts:102` currently rejects zero with `.positive()`
+before native spawn. Its owner must admit nonnegative integral timeouts;
+execution-local already treats zero as no deadline. No host-side policy bypass
+is installed. Pre-runtime reporting requires the explicit resources described above.
+
+
+`bun run check` checks all source and tests through the no-emit `tsconfig.json`
+and scripts through `tsconfig.check.json`. `bun run build` emits production JS
+and declarations with `tsconfig.build.json` and stages native artifacts.
+`bun run test` prepares native fixtures and runs the suites. `bun run test:native`
+also compiles and runs the real bundled-host identity fixture outside the unit suite. The public package
+contract test imports source entrypoints in-process and checks schemas, inferred
+types, refusals, supervisor hash, ABI declarations and publication patterns;
+it does not prove distributed tarball bytes. Release preflight owns that proof.
+Native account-home scenarios select Darwin or Linux explicitly; PTY ownership
+selects those supported hosts, with unsupported-host refusals in the adapter suite.
+Pipe stdin cases run everywhere; POSIX device/closed-descriptor cases require POSIX.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+
+## Native images without a host boot
+
+Compose `nativeImagePlugin` from `@vibesdotdev/host-bun/native-image/plugin`
+on a consumer runtime, then resolve `host/native-image`. The public
+`@vibesdotdev/host-bun/native-image` contract exposes schemas and `NativeImage`:
+`metadata({ data, maxPixels, autoOrient })` returns dimensions;
+`encode(...)` applies validated native options and returns bytes plus readback
+dimensions. No Bun objects cross the boundary and no unrelated host services
+boot. See SPEC for fixed refusals and cause preservation. Media-bun composes
+this plugin automatically and owns its domain policy.

package/dist/applet-serve-host/applet-serve-host.impl.bun.d.ts

@@ -0,0 +1,6 @@
+import type { AppletServeHost } from '@vibesdotdev/kernel/kinds/applet-serve-host.kind';
+/** Transpile one TypeScript source to JavaScript (browser-servable; the host's `runtime/transpiler` too). */
+export declare function transpileTypeScriptSource(source: string): string;
+/** The Bun host's `applet/serve-host` implementation. */
+export declare function createBunAppletServeHost(): AppletServeHost;
+//# sourceMappingURL=applet-serve-host.impl.bun.d.ts.map

package/dist/applet-serve-host/applet-serve-host.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applet-serve-host.impl.bun.d.ts","sourceRoot":"","sources":["../../src/applet-serve-host/applet-serve-host.impl.bun.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACX,eAAe,EAGf,MAAM,kDAAkD,CAAC;AAqB1D,6GAA6G;AAC7G,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAmBD,yDAAyD;AACzD,wBAAgB,wBAAwB,IAAI,eAAe,CAsB1D"}

package/dist/applet-serve-host/applet-serve-host.impl.bun.js

@@ -0,0 +1,80 @@
+/**
+ * The Bun host's applet serve-host bindings (`applet/serve-host`, host `bun`).
+ *
+ * `Bun.serve` binds the local applet origin synchronously, `Bun.Transpiler`
+ * strips types from served project sources and lexes import specifiers, and
+ * `Bun.resolveSync` resolves bare package specifiers the way the module
+ * system does (exports maps and conditions), so the serve layer never guesses
+ * at paths. An unresolvable specifier traces one operator line
+ * (`VIBES_DEBUG_RUNTIME`) and resolves to `null`, per the kind contract.
+ */
+import { settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import { createStylesheetCompiler } from "./stylesheet.compiler.js";
+/** A bound local applet http host. */
+function startAppletServeHost(options) {
+    const server = Bun.serve({
+        port: options.port,
+        hostname: options.hostname,
+        async fetch(request, server) {
+            const response = await options.fetch(request);
+            if (response.headers.get('content-type')?.split(';', 1)[0]?.trim().toLowerCase() === 'text/event-stream') {
+                server.timeout(request, 0);
+            }
+            return response;
+        }
+    });
+    return {
+        port: server.port ?? options.port,
+        stop: () => server.stop(true)
+    };
+}
+/** Transpile one TypeScript source to JavaScript (browser-servable; the host's `runtime/transpiler` too). */
+export function transpileTypeScriptSource(source) {
+    return new Bun.Transpiler({ loader: 'ts' }).transformSync(source);
+}
+/** Every import/export/dynamic-import specifier in a JavaScript module. */
+function scanModuleSpecifiers(code) {
+    const seen = new Set();
+    for (const entry of new Bun.Transpiler({ loader: 'js' }).scanImports(code))
+        seen.add(entry.path);
+    return [...seen];
+}
+/** Resolve a bare specifier from a directory to an absolute file path, or null. */
+function resolveModuleSpecifier(specifier, fromDir, runtime) {
+    const settled = settleNow(() => Bun.resolveSync(specifier, fromDir));
+    if (settled.ok)
+        return settled.value;
+    // Declared contract: an unresolvable specifier is `null`, not a failure.
+    const failure = valueFreeFailure(settled.cause);
+    runtime.diagnostics.trace(`applet-serve-host: module specifier did not resolve (${specifier} from ${fromDir}; ${failure.code ?? failure.name})`);
+    return null;
+}
+/** The Bun host's `applet/serve-host` implementation. */
+export function createBunAppletServeHost() {
+    const stylesheets = createStylesheetCompiler();
+    // This binding serves local development modules, including libraries published as Svelte source.
+    const modules = new Bun.Transpiler({ loader: 'ts', define: {
+            'import.meta.env.DEV': 'true', 'process.env.NODE_ENV': '"development"'
+        } });
+    return {
+        compileStylesheet: options => stylesheets.compile(options),
+        startAppletServeHost(options) {
+            const listener = startAppletServeHost(options);
+            return {
+                port: listener.port,
+                stop() {
+                    try {
+                        listener.stop();
+                    }
+                    finally {
+                        stylesheets.clear();
+                    }
+                }
+            };
+        },
+        transpileTypeScriptSource: source => modules.transformSync(source),
+        scanModuleSpecifiers,
+        resolveModuleSpecifier
+    };
+}
+//# sourceMappingURL=applet-serve-host.impl.bun.js.map

package/dist/applet-serve-host/applet-serve-host.impl.bun.js.map

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

package/dist/applet-serve-host/applet-serve-host.plugin.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Registers the Bun host's applet serve-host bindings under the runtime's
+ * `applet/serve-host` kind. The host owns the kind's registration on the
+ * runtimes it builds (as it owns the SQLite driver's): the kind is the
+ * runtime's frozen definition, so a second registration of it is a no-op.
+ * The bindings module loads only when the kind is first resolved.
+ */
+import { type RuntimePlugin, type RuntimeRef } from '@vibesdotdev/kernel';
+/** The Bun serve-host's descriptor. */
+export declare const bunAppletServeHostDescriptor: {
+    id: string;
+    kind: "applet/serve-host";
+    name: string;
+    description: string;
+    host: string;
+    hardware: string[];
+};
+/** Register the kind (when absent), the Bun serve-host's descriptor and its lazy loader on `runtime`. */
+export declare function registerBunAppletServeHost(runtime: RuntimeRef): void;
+/** The same registration as a plugin, for a host composed from plugins. */
+export declare const bunAppletServeHostPlugin: RuntimePlugin;
+//# sourceMappingURL=applet-serve-host.plugin.d.ts.map

package/dist/applet-serve-host/applet-serve-host.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applet-serve-host.plugin.d.ts","sourceRoot":"","sources":["../../src/applet-serve-host/applet-serve-host.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAoD,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG5H,uCAAuC;AACvC,eAAO,MAAM,4BAA4B;;;;;;;CAOxC,CAAC;AAEF,yGAAyG;AACzG,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAYpE;AAED,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,EAAE,aAMrC,CAAC"}

package/dist/applet-serve-host/applet-serve-host.plugin.js

@@ -0,0 +1,42 @@
+/**
+ * Registers the Bun host's applet serve-host bindings under the runtime's
+ * `applet/serve-host` kind. The host owns the kind's registration on the
+ * runtimes it builds (as it owns the SQLite driver's): the kind is the
+ * runtime's frozen definition, so a second registration of it is a no-op.
+ * The bindings module loads only when the kind is first resolved.
+ */
+import { createRuntimeImplementation, createRuntimePlugin } from '@vibesdotdev/kernel';
+import { APPLET_SERVE_HOST_KIND, appletServeHostKind } from '@vibesdotdev/kernel/kinds/applet-serve-host.kind';
+/** The Bun serve-host's descriptor. */
+export const bunAppletServeHostDescriptor = {
+    id: 'applet-serve-host-bun',
+    kind: APPLET_SERVE_HOST_KIND,
+    name: 'Bun applet serve host',
+    description: 'Applet serve-host bindings over Bun.serve, Bun.Transpiler and Bun.resolveSync',
+    host: 'bun',
+    hardware: ['consumer']
+};
+/** Register the kind (when absent), the Bun serve-host's descriptor and its lazy loader on `runtime`. */
+export function registerBunAppletServeHost(runtime) {
+    if (!runtime.hasKind(APPLET_SERVE_HOST_KIND))
+        runtime.registerKind(appletServeHostKind);
+    runtime.registerDescriptor(APPLET_SERVE_HOST_KIND, bunAppletServeHostDescriptor);
+    runtime.registerLoader(APPLET_SERVE_HOST_KIND, bunAppletServeHostDescriptor.id, async () => {
+        const { createBunAppletServeHost } = await import("./applet-serve-host.impl.bun.js");
+        return createRuntimeImplementation({
+            kind: APPLET_SERVE_HOST_KIND,
+            id: bunAppletServeHostDescriptor.id,
+            constraint: { hardware: ['consumer'] },
+            implementation: createBunAppletServeHost()
+        });
+    });
+}
+/** The same registration as a plugin, for a host composed from plugins. */
+export const bunAppletServeHostPlugin = createRuntimePlugin({
+    id: 'applet-serve-host-bun',
+    name: 'Bun applet serve host',
+    onRegister(runtime) {
+        registerBunAppletServeHost(runtime);
+    }
+});
+//# sourceMappingURL=applet-serve-host.plugin.js.map

package/dist/applet-serve-host/applet-serve-host.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applet-serve-host.plugin.js","sourceRoot":"","sources":["../../src/applet-serve-host/applet-serve-host.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAuC,MAAM,qBAAqB,CAAC;AAC5H,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAE/G,uCAAuC;AACvC,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC3C,EAAE,EAAE,uBAAuB;IAC3B,IAAI,EAAE,sBAAsB;IAC5B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,+EAA+E;IAC5F,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,CAAC,UAAU,CAAC;CACtB,CAAC;AAEF,yGAAyG;AACzG,MAAM,UAAU,0BAA0B,CAAC,OAAmB;IAC7D,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC;QAAE,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACxF,OAAO,CAAC,kBAAkB,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,CAAC;IACjF,OAAO,CAAC,cAAc,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC1F,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;QACrF,OAAO,2BAA2B,CAAC;YAClC,IAAI,EAAE,sBAAsB;YAC5B,EAAE,EAAE,4BAA4B,CAAC,EAAE;YACnC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;YACtC,cAAc,EAAE,wBAAwB,EAAE;SAC1C,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAkB,mBAAmB,CAAC;IAC1E,EAAE,EAAE,uBAAuB;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,UAAU,CAAC,OAAO;QACjB,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;CACD,CAAC,CAAC"}

package/dist/applet-serve-host/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The Bun host's implementation of the runtime's applet serve-host kind
+ * (`applet/serve-host`) and the plugin that registers it.
+ */
+export { createBunAppletServeHost } from './applet-serve-host.impl.bun.ts';
+export { bunAppletServeHostDescriptor, bunAppletServeHostPlugin, registerBunAppletServeHost } from './applet-serve-host.plugin.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/applet-serve-host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/applet-serve-host/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/applet-serve-host/index.js

@@ -0,0 +1,7 @@
+/**
+ * The Bun host's implementation of the runtime's applet serve-host kind
+ * (`applet/serve-host`) and the plugin that registers it.
+ */
+export { createBunAppletServeHost } from "./applet-serve-host.impl.bun.js";
+export { bunAppletServeHostDescriptor, bunAppletServeHostPlugin, registerBunAppletServeHost } from "./applet-serve-host.plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/applet-serve-host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/applet-serve-host/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/applet-serve-host/stylesheet.compiler.d.ts

@@ -0,0 +1,7 @@
+import { type AppletStylesheetCompileOptions } from '@vibesdotdev/kernel/kinds/applet-serve-host.kind';
+/** One selected host's cache, released with its listener. Compiler libraries load only on use. */
+export declare function createStylesheetCompiler(): {
+    clear(): void;
+    compile(options: AppletStylesheetCompileOptions): Promise<string>;
+};
+//# sourceMappingURL=stylesheet.compiler.d.ts.map

package/dist/applet-serve-host/stylesheet.compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylesheet.compiler.d.ts","sourceRoot":"","sources":["../../src/applet-serve-host/stylesheet.compiler.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,8BAA8B,EAEnC,MAAM,kDAAkD,CAAC;AA0B1D,kGAAkG;AAClG,wBAAgB,wBAAwB;;qBAKf,8BAA8B,GAAG,OAAO,CAAC,MAAM,CAAC;EA4CxE"}

package/dist/applet-serve-host/stylesheet.compiler.js

@@ -0,0 +1,63 @@
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { AppletStyleContentSchema, AppletStylesheetSourceSchema } from '@vibesdotdev/kernel/kinds/applet-serve-host.kind';
+function sameSheet(left, right) {
+    return left.path === right.path && left.base === right.base && left.content === right.content;
+}
+function sameSources(left, right) {
+    return left.length === right.length && left.every((source, index) => {
+        const next = right[index];
+        return next !== undefined && source.path === next.path && source.extension === next.extension && source.content === next.content;
+    });
+}
+/** One selected host's cache, released with its listener. Compiler libraries load only on use. */
+export function createStylesheetCompiler() {
+    const cache = new Map();
+    return {
+        clear() { cache.clear(); },
+        async compile(options) {
+            const entry = AppletStylesheetSourceSchema.parse(options.entry);
+            const sources = options.sources.map(source => AppletStyleContentSchema.parse(source));
+            const held = cache.get(entry.path);
+            if (held && sameSheet(held.entry, entry) && sameSources(held.sources, sources)) {
+                const current = await Promise.all(held.imports.map(async (imported) => {
+                    const source = AppletStylesheetSourceSchema.parse(await options.loadStylesheet(imported.id, imported.base));
+                    return sameSheet(imported.source, source);
+                }));
+                if (current.every(Boolean))
+                    return held.css;
+            }
+            try {
+                const [{ compile }, { Scanner }] = await Promise.all([import('tailwindcss'), import('@tailwindcss/oxide')]);
+                const imports = [];
+                const compiler = await compile(entry.content, {
+                    base: entry.base,
+                    from: entry.path,
+                    async loadStylesheet(id, base) {
+                        const source = AppletStylesheetSourceSchema.parse(await options.loadStylesheet(id, base));
+                        imports.push({ id, base, source });
+                        return source;
+                    },
+                    async loadModule(id) {
+                        throw new CapabilityError('The applet stylesheet compiler does not support JavaScript plugins or configuration modules.', 'UNAVAILABLE', {
+                            reason: 'applet-stylesheet-plugin-unsupported', details: { id }
+                        });
+                    }
+                });
+                // scanFiles receives supplied texts only. @source directives never trigger host filesystem scans.
+                const candidates = new Scanner({ sources: [] }).scanFiles(sources.map(({ content, extension }) => ({ content, extension })));
+                const css = compiler.build(candidates);
+                cache.set(entry.path, { entry, sources, imports, css });
+                return css;
+            }
+            catch (cause) {
+                const failure = CaughtFailureSchema.parse(cause);
+                if (isCapabilityError(failure))
+                    throw failure;
+                throw new CapabilityError('The admitted applet stylesheet could not be compiled.', 'INVALID_INPUT', {
+                    reason: 'applet-stylesheet-invalid', cause: failure
+                });
+            }
+        }
+    };
+}
+//# sourceMappingURL=stylesheet.compiler.js.map

package/dist/applet-serve-host/stylesheet.compiler.js.map

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

package/dist/atlas-migrations/register-atlas-host-migrations.d.ts

@@ -0,0 +1,21 @@
+import { CapabilityError, type RuntimeRef } from '@vibesdotdev/kernel';
+export interface AtlasMigrationNamespaceEvidence {
+    expectedMigrationIds: string[];
+    registeredMigrationIds: string[];
+    missingMigrationIds: string[];
+    isStrictSubset: boolean;
+    repairAttempted?: boolean;
+}
+export declare class AtlasMigrationNamespacePoisonedError extends CapabilityError {
+    readonly evidence: AtlasMigrationNamespaceEvidence;
+    constructor(evidence: AtlasMigrationNamespaceEvidence);
+}
+/**
+ * Register the declared Atlas migrations on this host.
+ *
+ * No kind, or no `workspace.atlas-migrations` descriptor, is absence: the host
+ * has nothing to register and does not refuse. Called from the Bun plugin's
+ * `onActivate`, after discovery, so a later feature plugin's descriptor is visible.
+ */
+export declare function registerBunAtlasMigrations(runtime: RuntimeRef): void;
+//# sourceMappingURL=register-atlas-host-migrations.d.ts.map

package/dist/atlas-migrations/register-atlas-host-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-atlas-host-migrations.d.ts","sourceRoot":"","sources":["../../src/atlas-migrations/register-atlas-host-migrations.ts"],"names":[],"mappings":"AAeA,OAAO,EACN,eAAe,EAIf,KAAK,UAAU,EACf,MAAM,qBAAqB,CAAC;AAW7B,MAAM,WAAW,+BAA+B;IAC/C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,oCAAqC,SAAQ,eAAe;IACxE,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;gBAEvC,QAAQ,EAAE,+BAA+B;CAsBrD;AAgGD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAiCpE"}