@vibesdotdev/applets 0.0.0-stage → 1.0.0-rc.2

package/dist/cli/commands/serve.command.descriptor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `vibes applet serve` descriptor — ONE local web server for all applets.
+ *
+ * Single origin on 127.0.0.1: index at `/`, each applet at `/applet/{id}/`,
+ * shared svelte runtime, schema-validated JSON (serve.schemas.ts). A second
+ * invocation reuses a running server via the health probe. Consumer-hardware
+ * only: no network egress, no runtime session required for the viewport.
+ */
+export declare const appletServeCommandDescriptor: {
+    readonly kind: "cli/command";
+    readonly id: "applet.serve";
+    readonly name: "serve";
+    readonly description: "Start (or reuse) the single local applet web server on 127.0.0.1. Index lists every project; /applet/{id}/ serves one. Wire schemas in serve.schemas.ts.";
+    readonly group: "applet";
+    readonly arguments: [{
+        readonly name: "id";
+        readonly description: "Optional applet id to highlight (server still serves all)";
+    }];
+    readonly options: [{
+        readonly flags: "--port <port>";
+        readonly type: "number";
+        readonly description: "Port (default 5190)";
+    }, {
+        readonly flags: "--root <path>";
+        readonly description: "Workspace whose .vibes/applets is served (default: the runtime workspace)";
+    }];
+    readonly surfaces: ["cli"];
+    readonly hardware: readonly ["consumer"];
+    readonly nonTtyBehavior: "service";
+    readonly enabled: true;
+    readonly examples: [{
+        readonly command: "vibes applet serve";
+        readonly description: "Serve every local applet on one origin";
+        readonly expectExit: 0;
+    }, {
+        readonly command: "vibes applet serve file-viewer";
+        readonly description: "Reuse the running server and print the direct link";
+        readonly expectExit: 0;
+    }];
+};
+export default appletServeCommandDescriptor;
+//# sourceMappingURL=serve.command.descriptor.d.ts.map

package/dist/cli/commands/serve.command.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.command.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/serve.command.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCvC,CAAC;AAEH,eAAe,4BAA4B,CAAC"}

package/dist/cli/commands/serve.command.descriptor.js

@@ -0,0 +1,46 @@
+/**
+ * `vibes applet serve` descriptor — ONE local web server for all applets.
+ *
+ * Single origin on 127.0.0.1: index at `/`, each applet at `/applet/{id}/`,
+ * shared svelte runtime, schema-validated JSON (serve.schemas.ts). A second
+ * invocation reuses a running server via the health probe. Consumer-hardware
+ * only: no network egress, no runtime session required for the viewport.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export const appletServeCommandDescriptor = createRuntimeAsset({
+    kind: 'cli/command',
+    id: 'applet.serve',
+    name: 'serve',
+    description: 'Start (or reuse) the single local applet web server on 127.0.0.1. Index lists every project; /applet/{id}/ serves one. Wire schemas in serve.schemas.ts.',
+    group: 'applet',
+    arguments: [{ name: 'id', description: 'Optional applet id to highlight (server still serves all)' }],
+    options: [
+        { flags: '--port <port>', type: 'number', description: 'Port (default 5190)' },
+        // `run()` has always honoured an explicit root ("a managed process names
+        // its workspace") but nothing on the CLI could name one: the ONLY caller
+        // was `applet-serve.pm.process.ts`, which bypassed the CLI entirely with
+        // `bun -e "import('./src/cli/commands/serve.command.impl.ts')…"`. WU-11
+        // deleted that bypass, so the flag the bypass was standing in for has to
+        // exist on the blessed surface.
+        {
+            flags: '--root <path>',
+            description: 'Workspace whose .vibes/applets is served (default: the runtime workspace)'
+        }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    // `applet serve` binds 127.0.0.1:5190 and runs until it is killed, so it
+    // never returns under a piped stdin. Declaring it keeps every non-TTY
+    // contract check from executing it bare — the alternative is a web server
+    // started inside a test suite. Surfaced (not caused) by the WU-10 flip: the
+    // thin host mounts the applets CLI group that the monolith's baked config
+    // never did.
+    nonTtyBehavior: 'service',
+    enabled: true,
+    examples: [
+        { command: 'vibes applet serve', description: 'Serve every local applet on one origin', expectExit: 0 },
+        { command: 'vibes applet serve file-viewer', description: 'Reuse the running server and print the direct link', expectExit: 0 }
+    ]
+});
+export default appletServeCommandDescriptor;
+//# sourceMappingURL=serve.command.descriptor.js.map

package/dist/cli/commands/serve.command.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.command.descriptor.js","sourceRoot":"","sources":["../../../src/cli/commands/serve.command.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,CAAC,MAAM,4BAA4B,GAAG,kBAAkB,CAAC;IAC9D,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,OAAO;IACb,WAAW,EACV,0JAA0J;IAC3J,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,2DAA2D,EAAE,CAAC;IACrG,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;QAC9E,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,wEAAwE;QACxE,yEAAyE;QACzE,gCAAgC;QAChC;YACC,KAAK,EAAE,eAAe;YACtB,WAAW,EACV,2EAA2E;SAC5E;KACD;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,yEAAyE;IACzE,sEAAsE;IACtE,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,aAAa;IACb,cAAc,EAAE,SAAS;IACzB,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE;QACT,EAAE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,wCAAwC,EAAE,UAAU,EAAE,CAAC,EAAE;QACvG,EAAE,OAAO,EAAE,gCAAgC,EAAE,WAAW,EAAE,oDAAoD,EAAE,UAAU,EAAE,CAAC,EAAE;KAC/H;CACD,CAAC,CAAC;AAEH,eAAe,4BAA4B,CAAC"}

package/dist/cli/commands/serve.command.impl.d.ts

@@ -0,0 +1,110 @@
+import type { CommandContext, CommandOptions } from '@vibesdotdev/cli';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type AppletStylesheetSource } from '@vibesdotdev/kernel/kinds/applet-serve-host.kind';
+import { type AppletProjectHost } from '../project-files.ts';
+interface ServeOptions {
+    port?: number;
+    /** Workspace root holding `.vibes/applets`; the runtime's bound workspace when absent. */
+    root?: string;
+}
+export interface ModuleTools {
+    scan: (code: string) => string[];
+    resolve: (specifier: string, fromDir: string) => string | null;
+    transpile: (source: string) => string;
+    compileStyle?: (entry: AppletStylesheetSource) => Promise<string>;
+}
+export interface RewriteContext {
+    tools: ModuleTools;
+    /** The runtime kinds every file and path answer comes from. */
+    host: AppletProjectHost;
+    /** Directories to resolve bare specifiers from, in order. */
+    fromDirs: string[];
+    /** For applet project modules: resolve relative imports against the project inventory. */
+    project?: {
+        id: string;
+        sources: Record<string, string>;
+        files: readonly string[];
+        importer: string;
+    };
+    /**
+     * Called with every file a bare specifier resolved to. Serving admits that
+     * file's package: a workspace-linked package resolves through its symlink to
+     * a real path outside the served workspace and outside any `node_modules`.
+     */
+    admitResolved?: (absolutePath: string) => Promise<void>;
+}
+/** Rewrite every specifier in a served module to a URL this server answers. */
+export declare function rewriteModule(code: string, ctx: RewriteContext): Promise<string>;
+/**
+ * One applet's page. The applet mounts with its root surface as the `vibes`
+ * prop (the delivery contract in `browser-runtime.ts`); it used to mount with
+ * empty props, so a local applet had no runtime surface at all.
+ */
+export declare function hostPage(id: string, surfaceClientUrl: string): string;
+export interface LoadedProject {
+    id: string;
+    entry: string;
+    sources: Record<string, string>;
+    /** The project's whole inventory: compiled sources plus companions of every type. */
+    files: readonly string[];
+    compiledEntry: string;
+}
+/** Load one project from disk and compile its entry for the browser. */
+export declare function loadProject(workspaceRoot: string, id: string, ctx: Omit<RewriteContext, 'project'>, svelteUrl: string): Promise<LoadedProject | null>;
+/**
+ * One companion route for one loaded project — the body of the applet-scoped
+ * module and asset routes.
+ *
+ * A2b: companions resolve relative to the importing file. Compiled modules are
+ * addressed by their SOURCE path plus a `.js` suffix, so `x.svelte`, rune
+ * `x.svelte.ts` and rune `x.svelte.js` never collide under one route table.
+ * Everything else — css, md, svg, images — is served as BYTES with its declared
+ * media type. Returns null when no branch matches; the caller answers 404.
+ *
+ * Exported so a test can drive the REAL route pipeline without a socket.
+ */
+export declare function serveAppletCompanion(input: {
+    workspaceRoot: string;
+    id: string;
+    project: LoadedProject;
+    rest: string;
+    tools: ModuleTools;
+    host: AppletProjectHost;
+    resolveDirs: string[];
+    admitResolved?: RewriteContext['admitResolved'];
+}): Promise<Response | null>;
+export interface ServePackageRoots {
+    kitRoot: string;
+    /** Kit's published `./styles.css` export, resolved through its exports map; null when the kit declares none. */
+    kitStylesheet: string | null;
+    resolveDirs: string[];
+    svelteEntry: string;
+    svelteUrl: string;
+    twAnimateRoot: string | null;
+    packageSourceDir: string;
+    surfaceClientUrl: string;
+}
+/**
+ * Everything `run` must resolve before it can listen: the kit, the svelte
+ * runtime, the optional animation sheet, and this package's own served
+ * sources. Exported so a test can drive the REAL startup resolution without
+ * a socket.
+ */
+export declare function resolveServePackageRoots(input: {
+    host: AppletProjectHost;
+    runtime: VibesRuntime;
+    tools: ModuleTools;
+    workspaceRoot: string;
+    /** Directory whose `node_modules` is the fallback when the workspace has none. */
+    packageDir: string;
+    /** This package's own sources, served to the page. */
+    packageSourcePath: string;
+    surfaceClientPath: string;
+}): Promise<ServePackageRoots>;
+export declare function run(runtime: VibesRuntime, id: string | undefined, options?: ServeOptions): Promise<void>;
+export declare function execute(args: CommandOptions, options: CommandOptions, context: CommandContext): Promise<void>;
+declare const _default: {
+    execute: typeof execute;
+};
+export default _default;
+//# sourceMappingURL=serve.command.impl.d.ts.map

package/dist/cli/commands/serve.command.impl.d.ts.map

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