@ambitresearch/genie 1.3.1

package/dist/framework/vue.d.ts

@@ -0,0 +1,99 @@
+import type { Plugin } from "esbuild";
+import { type AdapterFile, type FrameworkAdapter, type Framework, type RenderInput, type Viewport } from "./interface.js";
+/**
+ * v2 tracking issue this adapter was implemented under (kept exported for
+ * provenance and referenced by the conformance suite). Retained now that Vue is
+ * no longer a stub so historical links and the AC3 URL-shape assertion still
+ * resolve.
+ */
+export declare const VUE_TRACKING_ISSUE = "https://github.com/ambitresearch/genie/issues/129";
+/**
+ * The host-provided browser global the preview IIFE resolves Vue from. The M4
+ * preview iframe must load the vendored Vue 3 global build (which self-assigns
+ * `window.Vue`) before the component bundle — see the *Preview host contract*
+ * above. Kept here so the adapter is the single source of truth for the contract.
+ */
+export declare const VUE_HOST_GLOBAL = "Vue";
+/**
+ * esbuild plugin implementing the {@link VUE_HOST_GLOBAL} contract (parity with
+ * React's `hostReactGlobalsPlugin`). It intercepts the bare `vue` specifier every
+ * compiled SFC imports its runtime helpers from and resolves it to an in-memory
+ * virtual module that reads `window.Vue` — so the emitted IIFE contains **no**
+ * `require("vue")` and instead references the host global.
+ *
+ * Vue's compiled output only ever imports from the bare `"vue"` entry (unlike
+ * React's automatic-JSX runtime, which also pulls `react/jsx-runtime`), so a
+ * single specifier rewrite is sufficient.
+ */
+export declare function hostVueGlobalPlugin(): Plugin;
+export declare class VueAdapter implements FrameworkAdapter {
+    readonly framework: Framework;
+    /**
+     * A comfortable default card for a Vue component when the caller has no better
+     * viewport. Matches the React adapter (and the RFC's default preview grid cell,
+     * §7.5) so a framework switch never resizes a card by default.
+     */
+    readonly defaultViewport: Viewport;
+    /**
+     * The framework directive `conjure` injects into the generation prompt (AC4):
+     * name the target framework and the Vue SFC shape the model should emit. Asking
+     * for an **exported** props interface makes {@link extractDts} productive (it
+     * emits the SFC script block's exported declarations), mirroring the React
+     * adapter's "exported interface" guidance.
+     */
+    readonly promptDirective: string;
+    /**
+     * The canonical source file: `<Name>.vue`, carrying the model-authored SFC
+     * verbatim. `text/x-vue` matches the MIME the kit-file classifier already maps
+     * `.vue` to (`store/kit-files.ts`), so an adapter-emitted source and a
+     * store-read source report the same type.
+     */
+    renderSource(input: RenderInput): AdapterFile;
+    /**
+     * Bundle the SFC to a browser-ready **IIFE** exposing the compiled component on
+     * `globalThis.${PREVIEW_GLOBAL_NAME}` (`{ default, <Name> }`). The pipeline
+     * mirrors what `@vitejs/plugin-vue` does — compile the script and the template
+     * as *separate* modules and stitch them — so it renders every SFC shape
+     * (`<script setup>`, options-API `<script>`, and template-only) identically:
+     *
+     *   1. `@vue/compiler-sfc#parse` → SFC descriptor.
+     *   2. `compileScript({ inlineTemplate: false })` lowers `<script setup>` (or a
+     *      plain options-API `<script>`) to the component object, exposing its
+     *      `bindings` so the template can bind setup state correctly. `inlineTemplate`
+     *      is deliberately **off**: it only bakes the template into `<script setup>`
+     *      output — for an options-API `<script>` it silently drops the render
+     *      function, leaving a component that mounts to nothing.
+     *   3. `compileTemplate` compiles `<template>` to a standalone `render`, fed the
+     *      script's `bindings` (so `<script setup>` refs resolve) and the scope id,
+     *      then assigned onto the component. A template-only SFC starts from an empty
+     *      component object; a script-only SFC skips this step.
+     *   4. `<style scoped>` blocks are compiled with the matching scope id and
+     *      inlined as a guarded runtime `<style>` injection so the preview is a
+     *      single self-contained script (the interface returns one file).
+     *   5. esbuild bundles it to an IIFE, rewriting `"vue"` → `window.Vue` via
+     *      {@link hostVueGlobalPlugin} — no `require("vue")` at runtime.
+     *
+     * The SFC compiler, esbuild and ts-morph are all imported lazily so resolving a
+     * `VueAdapter` never pulls them until a preview is actually built.
+     */
+    renderPreview(input: RenderInput): Promise<AdapterFile>;
+    /**
+     * Extract the component's `.d.ts` typings with ts-morph (parity with React), via
+     * an in-memory declaration-only emit so nothing touches disk. Vue's props/emits
+     * live in the SFC's `<script setup>` (and/or `<script>`) block; this feeds those
+     * blocks' TypeScript to ts-morph and emits the **exported** declarations — so a
+     * component that exports its props interface (as the `promptDirective` asks)
+     * yields that interface in its `.d.ts`.
+     *
+     * The `defineProps` / `defineEmits` / `withDefaults` compiler macros are left as
+     * unresolved identifiers, but we never type-check — only emit declarations
+     * (`skipLibCheck` + `emitDeclarationOnly`) — so their presence never blocks the
+     * exported types from surfacing. A source with no exported declarations (inline
+     * prop types, or a template-only SFC) falls back to a valid empty module.
+     *
+     * ts-morph and the SFC parser are imported lazily for the same reason as
+     * {@link renderPreview}: keep resolving the adapter cheap.
+     */
+    extractDts(input: RenderInput): Promise<AdapterFile>;
+}
+//# sourceMappingURL=vue.d.ts.map

package/dist/framework/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/framework/vue.ts"],"names":[],"mappings":"AAmDA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,gBAAgB,CAAC;AAQxB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,sDAAsD,CAAC;AAEtF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAyBrC;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAmCD,qBAAa,UAAW,YAAW,gBAAgB;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAA+B;IAEjE;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAMnB;IAEb;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAQ7C;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAiI7D;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAwC3D"}

package/dist/framework/vue.js

@@ -0,0 +1,375 @@
+/**
+ * `VueAdapter` (M2-08 stub → **v2 · DRO-616**) — the Vue 3 framework adapter.
+ *
+ * Lowers a neutral {@link RenderInput} (the component's `.vue` **single-file
+ * component** source) into the three Vue target artefacts, mirroring
+ * {@link ReactAdapter} method-for-method so `conjure` treats every framework the
+ * same:
+ *   - {@link VueAdapter.renderSource}  → `<Name>.vue` (the canonical SFC source)
+ *   - {@link VueAdapter.renderPreview} → `<Name>.preview.js` — an **esbuild IIFE
+ *     bundle** exposing the compiled component on `globalThis.GenieComponent` for
+ *     the M4 iframe grid to mount with `Vue.createApp(GenieComponent.default)`
+ *   - {@link VueAdapter.extractDts}    → `<Name>.d.ts` — the component's exported
+ *     prop/emit types, extracted with **ts-morph** (declaration-only in-memory emit)
+ *
+ * ── Import-time safety ────────────────────────────────────────────────────────
+ * `@vue/compiler-sfc`, `esbuild` and `ts-morph` are heavy transitive graphs.
+ * None is imported at this module's top level — each is reached through a lazy
+ * `await import(...)` *inside* the one method that needs it. So the registry
+ * (`interface.ts#getAdapter`) can resolve a `VueAdapter` — and `conjure` can read
+ * its `promptDirective` / `defaultViewport` on the generation hot path — without
+ * ever pulling the SFC compiler, the bundler, or the TS compiler, which only load
+ * when a preview / `.d.ts` is actually produced. The only compile-time references
+ * at module scope are `import type`s (erased under `verbatimModuleSyntax`), which
+ * emit no runtime `require(...)` and do not defeat the lazy-load.
+ *
+ * ── Preview host contract (parity with DRO-624's React contract) ──────────────
+ * The `<Name>.preview.js` bundle does **not** carry its own copy of Vue, nor does
+ * it `require("vue")`. Vue's SFC compiler lowers a `<script setup>` / template
+ * into a module that imports its runtime helpers (`defineComponent`, `openBlock`,
+ * `createElementBlock`, `toDisplayString`, …) from the bare specifier `"vue"`.
+ * {@link hostVueGlobalPlugin} rewrites that specifier at bundle time to read a
+ * **host-provided browser global** the preview iframe must define *before* the
+ * bundle's `<script>` runs:
+ *
+ *   - `window.{@link VUE_HOST_GLOBAL}` → the Vue 3 runtime (`window.Vue`)
+ *
+ * exactly as the React adapter rewrites `react` → `window.React`. Per the on-disk
+ * layout (PRD §6.6) the kit vendors the runtime under `_vendor/` (the Vue 3
+ * *global* build — `vue.runtime.global.prod.js` — which self-assigns
+ * `window.Vue`), and the iframe host page `<script>`-includes it ahead of the
+ * component bundle. Marking `vue` esbuild-`external` under `format:"iife"` would
+ * lower the import to a throwing `require("vue")` (the same failure mode DRO-624
+ * fixed for React), so the plugin is the mechanism, not `external`.
+ *
+ * NOTE — **Vue 3 global build**: the contract depends on a runtime that ships a
+ * build defining a `window.Vue` global carrying the full runtime helper surface.
+ * The vendored `_vendor/vue.runtime.global.prod.js` must be a Vue 3 global build
+ * (the adapter's execution test pins the same major).
+ */
+import { createHash } from "node:crypto";
+import { componentPath, } from "./interface.js";
+// The M4 grid's preview-global name is a cross-framework contract; import the
+// single source of truth from the React adapter rather than redeclaring it, so
+// Vue and React cards are mounted through the identical `window.GenieComponent`
+// handle. (react.js has no heavy top-level imports — only `import type` — so
+// this stays cheap and does not pull esbuild/ts-morph.)
+import { PREVIEW_GLOBAL_NAME } from "./react.js";
+/**
+ * v2 tracking issue this adapter was implemented under (kept exported for
+ * provenance and referenced by the conformance suite). Retained now that Vue is
+ * no longer a stub so historical links and the AC3 URL-shape assertion still
+ * resolve.
+ */
+export const VUE_TRACKING_ISSUE = "https://github.com/ambitresearch/genie/issues/129";
+/**
+ * The host-provided browser global the preview IIFE resolves Vue from. The M4
+ * preview iframe must load the vendored Vue 3 global build (which self-assigns
+ * `window.Vue`) before the component bundle — see the *Preview host contract*
+ * above. Kept here so the adapter is the single source of truth for the contract.
+ */
+export const VUE_HOST_GLOBAL = "Vue";
+/**
+ * esbuild namespace the virtual `vue` shim module lives in (kept off the real
+ * filesystem so nothing resolves to an on-disk `node_modules/vue`).
+ */
+const HOST_NAMESPACE = "genie-vue-host-global";
+/** A clear, actionable error when the iframe forgot to load the vendored global. */
+function hostMissingMessage() {
+    return (`genie preview host contract violated: window.${VUE_HOST_GLOBAL} is not defined. ` +
+        `The preview iframe must load the vendored _vendor/vue.runtime.global.prod.js ` +
+        `(Vue 3 global build) before the component bundle — see the preview host contract in vue.ts.`);
+}
+/** CJS body for the virtual `vue` module that re-exports the host global. */
+function hostGlobalModule() {
+    return [
+        `if (!window.${VUE_HOST_GLOBAL}) throw new Error(${JSON.stringify(hostMissingMessage())});`,
+        `module.exports = window.${VUE_HOST_GLOBAL};`,
+    ].join("\n");
+}
+/**
+ * esbuild plugin implementing the {@link VUE_HOST_GLOBAL} contract (parity with
+ * React's `hostReactGlobalsPlugin`). It intercepts the bare `vue` specifier every
+ * compiled SFC imports its runtime helpers from and resolves it to an in-memory
+ * virtual module that reads `window.Vue` — so the emitted IIFE contains **no**
+ * `require("vue")` and instead references the host global.
+ *
+ * Vue's compiled output only ever imports from the bare `"vue"` entry (unlike
+ * React's automatic-JSX runtime, which also pulls `react/jsx-runtime`), so a
+ * single specifier rewrite is sufficient.
+ */
+export function hostVueGlobalPlugin() {
+    return {
+        name: "genie-vue-host-global",
+        setup(build) {
+            build.onResolve({ filter: /^vue$/ }, () => ({ path: "vue", namespace: HOST_NAMESPACE }));
+            build.onLoad({ filter: /.*/, namespace: HOST_NAMESPACE }, () => ({
+                contents: hostGlobalModule(),
+                loader: "js",
+            }));
+        },
+    };
+}
+/**
+ * A deterministic 8-hex scope id derived from the component identity + source, so
+ * a given SFC always compiles to the same `data-v-…` attribute (stable preview
+ * bytes across runs — no `Date.now()`/random). Vue's SFC compiler uses this id to
+ * scope both the template's root attribute and the `<style scoped>` selectors.
+ */
+function scopeHash(input) {
+    return createHash("sha256")
+        .update(`${input.componentName} ${input.source}`)
+        .digest("hex")
+        .slice(0, 8);
+}
+/**
+ * A guarded, idempotent runtime `<style>` injector snippet. `<style scoped>` CSS
+ * is intrinsic to an SFC, so the preview must carry it; the snippet appends one
+ * `<style>` element (keyed by `styleKey` so re-evaluating the bundle never
+ * duplicates it) and is a no-op outside a DOM (SSR / static analysis).
+ */
+function styleInjectorSnippet(css, styleKey) {
+    const elementId = `genie-style-${styleKey}`;
+    return [
+        `(function () {`,
+        `  if (typeof document === "undefined") return;`,
+        `  if (document.getElementById(${JSON.stringify(elementId)})) return;`,
+        `  var __genieStyle = document.createElement("style");`,
+        `  __genieStyle.id = ${JSON.stringify(elementId)};`,
+        `  __genieStyle.textContent = ${JSON.stringify(css)};`,
+        `  document.head.appendChild(__genieStyle);`,
+        `})();`,
+    ].join("\n");
+}
+export class VueAdapter {
+    framework = "vue";
+    /**
+     * A comfortable default card for a Vue component when the caller has no better
+     * viewport. Matches the React adapter (and the RFC's default preview grid cell,
+     * §7.5) so a framework switch never resizes a card by default.
+     */
+    defaultViewport = { width: 400, height: 300 };
+    /**
+     * The framework directive `conjure` injects into the generation prompt (AC4):
+     * name the target framework and the Vue SFC shape the model should emit. Asking
+     * for an **exported** props interface makes {@link extractDts} productive (it
+     * emits the SFC script block's exported declarations), mirroring the React
+     * adapter's "exported interface" guidance.
+     */
+    promptDirective = [
+        "Target framework: vue",
+        'Emit an idiomatic Vue 3 Single File Component (.vue) using <script setup lang="ts">. ' +
+            "Type props by passing an exported interface to defineProps (e.g. " +
+            "`defineProps<ButtonProps>()`) so the component's prop types are recoverable, and " +
+            "declare events with defineEmits.",
+    ].join("\n");
+    /**
+     * The canonical source file: `<Name>.vue`, carrying the model-authored SFC
+     * verbatim. `text/x-vue` matches the MIME the kit-file classifier already maps
+     * `.vue` to (`store/kit-files.ts`), so an adapter-emitted source and a
+     * store-read source report the same type.
+     */
+    renderSource(input) {
+        return {
+            path: componentPath(input, `${input.componentName}.vue`),
+            content: input.source,
+            mimeType: "text/x-vue",
+        };
+    }
+    /**
+     * Bundle the SFC to a browser-ready **IIFE** exposing the compiled component on
+     * `globalThis.${PREVIEW_GLOBAL_NAME}` (`{ default, <Name> }`). The pipeline
+     * mirrors what `@vitejs/plugin-vue` does — compile the script and the template
+     * as *separate* modules and stitch them — so it renders every SFC shape
+     * (`<script setup>`, options-API `<script>`, and template-only) identically:
+     *
+     *   1. `@vue/compiler-sfc#parse` → SFC descriptor.
+     *   2. `compileScript({ inlineTemplate: false })` lowers `<script setup>` (or a
+     *      plain options-API `<script>`) to the component object, exposing its
+     *      `bindings` so the template can bind setup state correctly. `inlineTemplate`
+     *      is deliberately **off**: it only bakes the template into `<script setup>`
+     *      output — for an options-API `<script>` it silently drops the render
+     *      function, leaving a component that mounts to nothing.
+     *   3. `compileTemplate` compiles `<template>` to a standalone `render`, fed the
+     *      script's `bindings` (so `<script setup>` refs resolve) and the scope id,
+     *      then assigned onto the component. A template-only SFC starts from an empty
+     *      component object; a script-only SFC skips this step.
+     *   4. `<style scoped>` blocks are compiled with the matching scope id and
+     *      inlined as a guarded runtime `<style>` injection so the preview is a
+     *      single self-contained script (the interface returns one file).
+     *   5. esbuild bundles it to an IIFE, rewriting `"vue"` → `window.Vue` via
+     *      {@link hostVueGlobalPlugin} — no `require("vue")` at runtime.
+     *
+     * The SFC compiler, esbuild and ts-morph are all imported lazily so resolving a
+     * `VueAdapter` never pulls them until a preview is actually built.
+     */
+    async renderPreview(input) {
+        const { parse, compileScript, compileStyle, compileTemplate } = await import("@vue/compiler-sfc");
+        const esbuild = (await import("esbuild")).default;
+        const filename = `${input.componentName}.vue`;
+        const { descriptor, errors } = parse(input.source, { filename });
+        if (errors.length > 0) {
+            throw new Error(`Vue SFC parse failed for ${filename}: ${errors.map((e) => String(e)).join("; ")}`);
+        }
+        if (!descriptor.scriptSetup && !descriptor.script && !descriptor.template) {
+            throw new Error(`Vue SFC ${filename} has neither a <script> nor a <template> block to render.`);
+        }
+        const id = scopeHash(input);
+        const scopeId = `data-v-${id}`;
+        const hasScoped = descriptor.styles.some((s) => s.scoped);
+        // The identifier the compiled component is bound to before we re-export it —
+        // renaming `export default` (via `genDefaultAs`) lets us attach `render` /
+        // `__scopeId` and re-export under both `default` and the component name.
+        const COMPONENT_BINDING = "__genie_component__";
+        // ── 2. script (setup or options API) → component object + binding metadata ─
+        const moduleParts = [];
+        // `BindingMetadata | undefined` — passed to compileTemplate so a `<script
+        // setup>` binding referenced in the template resolves to the right access.
+        let bindings;
+        if (descriptor.scriptSetup || descriptor.script) {
+            const script = compileScript(descriptor, {
+                id,
+                inlineTemplate: false,
+                genDefaultAs: COMPONENT_BINDING,
+            });
+            bindings = script.bindings;
+            moduleParts.push(script.content);
+        }
+        else {
+            // Template-only SFC: start from a bare component object the render attaches to.
+            moduleParts.push(`const ${COMPONENT_BINDING} = {};`);
+        }
+        // ── 3. template → standalone render, assigned onto the component ───────────
+        if (descriptor.template) {
+            const template = compileTemplate({
+                source: descriptor.template.content,
+                filename,
+                id,
+                scoped: hasScoped,
+                compilerOptions: {
+                    bindingMetadata: bindings,
+                    ...(hasScoped ? { scopeId } : {}),
+                },
+            });
+            if (template.errors.length > 0) {
+                throw new Error(`Vue template compile failed for ${filename}: ` +
+                    template.errors.map((e) => String(e)).join("; "));
+            }
+            // compileTemplate emits `export function render(...)`; drop the `export` so
+            // it is a local we can assign onto the component binding.
+            moduleParts.push(template.code.replace(/\bexport function render/, "function render"));
+            moduleParts.push(`${COMPONENT_BINDING}.render = render;`);
+        }
+        // ── 4. styles (scoped + plain), compiled and concatenated ─────────────────
+        let css = "";
+        for (const style of descriptor.styles) {
+            const compiled = compileStyle({
+                source: style.content,
+                filename,
+                id: scopeId,
+                scoped: style.scoped,
+            });
+            if (compiled.errors.length > 0) {
+                throw new Error(`Vue style compile failed for ${filename}: ` +
+                    compiled.errors.map((e) => String(e)).join("; "));
+            }
+            css += `${compiled.code}\n`;
+        }
+        // ── assemble the esbuild entry ────────────────────────────────────────────
+        const entry = [
+            ...moduleParts,
+            hasScoped ? `${COMPONENT_BINDING}.__scopeId = ${JSON.stringify(scopeId)};` : "",
+            css.trim() ? styleInjectorSnippet(css, id) : "",
+            `export default ${COMPONENT_BINDING};`,
+            `export const ${input.componentName} = ${COMPONENT_BINDING};`,
+        ]
+            .filter(Boolean)
+            .join("\n");
+        // ── 5. bundle to a host-global IIFE ───────────────────────────────────────
+        const result = await esbuild.build({
+            stdin: {
+                contents: entry,
+                loader: "ts",
+                sourcefile: `${input.componentName}.vue.ts`,
+                resolveDir: process.cwd(),
+            },
+            bundle: true,
+            write: false,
+            format: "iife",
+            globalName: PREVIEW_GLOBAL_NAME,
+            platform: "browser",
+            // `vue` is rewritten to the preview host's browser global (window.Vue)
+            // rather than inlined or left as a throwing `require("vue")` — see the
+            // Preview host contract.
+            plugins: [hostVueGlobalPlugin()],
+            logLevel: "silent",
+        });
+        const output = result.outputFiles[0];
+        if (!output) {
+            // esbuild returns at least one output file on success; this guards the
+            // types, it is not an expected runtime branch.
+            throw new Error("esbuild produced no preview output for the Vue component.");
+        }
+        return {
+            path: componentPath(input, `${input.componentName}.preview.js`),
+            content: output.text,
+            mimeType: "text/javascript",
+        };
+    }
+    /**
+     * Extract the component's `.d.ts` typings with ts-morph (parity with React), via
+     * an in-memory declaration-only emit so nothing touches disk. Vue's props/emits
+     * live in the SFC's `<script setup>` (and/or `<script>`) block; this feeds those
+     * blocks' TypeScript to ts-morph and emits the **exported** declarations — so a
+     * component that exports its props interface (as the `promptDirective` asks)
+     * yields that interface in its `.d.ts`.
+     *
+     * The `defineProps` / `defineEmits` / `withDefaults` compiler macros are left as
+     * unresolved identifiers, but we never type-check — only emit declarations
+     * (`skipLibCheck` + `emitDeclarationOnly`) — so their presence never blocks the
+     * exported types from surfacing. A source with no exported declarations (inline
+     * prop types, or a template-only SFC) falls back to a valid empty module.
+     *
+     * ts-morph and the SFC parser are imported lazily for the same reason as
+     * {@link renderPreview}: keep resolving the adapter cheap.
+     */
+    async extractDts(input) {
+        const { parse } = await import("@vue/compiler-sfc");
+        const { Project, ts } = await import("ts-morph");
+        const filename = `${input.componentName}.vue`;
+        const { descriptor } = parse(input.source, { filename });
+        const scriptContent = [descriptor.script?.content, descriptor.scriptSetup?.content]
+            .filter((c) => Boolean(c && c.trim()))
+            .join("\n");
+        const project = new Project({
+            useInMemoryFileSystem: true,
+            // `skipLibCheck` + declaration-only emit means the unresolved compiler
+            // macros / missing libs never block emission; we want the *shape*, not a
+            // clean type-check.
+            compilerOptions: {
+                declaration: true,
+                emitDeclarationOnly: true,
+                skipLibCheck: true,
+                target: ts.ScriptTarget.ES2022,
+                module: ts.ModuleKind.ESNext,
+                moduleResolution: ts.ModuleResolutionKind.Bundler,
+            },
+        });
+        // `.ts` (not `.vue`): we hand ts-morph the extracted script block, which is
+        // plain TypeScript once the SFC wrapper is stripped.
+        project.createSourceFile(`${input.componentName}.ts`, scriptContent, { overwrite: true });
+        const emitted = project.emitToMemory({ emitOnlyDtsFiles: true });
+        const dtsText = emitted.getFiles().find((f) => f.filePath.endsWith(".d.ts"))?.text;
+        // Fallback: a source with no exported declarations — inline prop types
+        // (`defineProps<{…}>()`) or a template-only SFC with no script block — yields
+        // an empty or absent `.d.ts`. Emit a minimal module marker rather than an
+        // empty file so the artefact is always a valid `.d.ts`.
+        const content = dtsText && dtsText.trim().length > 0 ? dtsText : `export {};\n`;
+        return {
+            path: componentPath(input, `${input.componentName}.d.ts`),
+            content,
+            mimeType: "text/plain",
+        };
+    }
+}
+//# sourceMappingURL=vue.js.map

package/dist/framework/vue.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createServer, SERVER_INFO } from "./server.js";
+export { startTransport, isLoopbackHost, normalizeListenHost, formatHttpEndpoint, createStreamableHttpRequestHandler, registerServerDisposer, resolvePreviewLocality, resolveTransport, type TransportKind, type StartOptions, type StreamableHttpHandlerOptions, } from "./transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,kCAAkC,EAClC,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,4BAA4B,GAClC,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createServer, SERVER_INFO } from "./server.js";
+export { startTransport, isLoopbackHost, normalizeListenHost, formatHttpEndpoint, createStreamableHttpRequestHandler, registerServerDisposer, resolvePreviewLocality, resolveTransport, } from "./transport.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,kCAAkC,EAClC,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,GAIjB,MAAM,gBAAgB,CAAC"}

package/dist/llm/client.d.ts

@@ -0,0 +1,81 @@
+/**
+ * LLM client wrapper (M2-01) — genie's single point of contact with the
+ * operator's configured OpenAI-compatible chat-completions endpoint.
+ *
+ * genie calls a **configurable**
+ * OpenAI-compatible endpoint. LiteLLM is the reference gateway, but Ollama /
+ * OpenAI / vLLM / any compatible endpoint work the same way — no provider URL
+ * or API key is ever hardcoded here. Both come from env vars
+ * (`GENIE_LLM_BASE_URL` / `GENIE_LLM_API_KEY`), validated at construction so a
+ * misconfigured deployment fails fast (`MissingLLMConfigError`) rather than
+ * failing confusingly deep inside a generation call.
+ *
+ * All future generation verbs (`conjure` / `refine`, M2-03/M2-04) call through
+ * `createChatCompletion` rather than importing the `openai` SDK directly, so
+ * this module is the one place that knows about env vars, timeouts, and
+ * request logging for LLM calls.
+ *
+ * Out of scope (per the M2-01 issue): retry/backoff (M2-06) — `withRetry` in
+ * a later issue wraps `createChatCompletion` itself — and structured-output
+ * schema validation (M2-07).
+ */
+import OpenAI from "openai";
+/** Base URL of the operator's OpenAI-compatible endpoint. No default (AC3). */
+export declare const GENIE_LLM_BASE_URL_ENV = "GENIE_LLM_BASE_URL";
+/** API key/token for the configured endpoint. No default (AC3). */
+export declare const GENIE_LLM_API_KEY_ENV = "GENIE_LLM_API_KEY";
+/** Per-request timeout override, in milliseconds. */
+export declare const GENIE_LLM_REQUEST_TIMEOUT_MS_ENV = "GENIE_LLM_REQUEST_TIMEOUT_MS";
+/** Default request timeout: 120 000 ms (AC5). */
+export declare const DEFAULT_LLM_REQUEST_TIMEOUT_MS = 120000;
+/**
+ * Thrown when one or both required LLM env vars are unset (AC2). Callers
+ * should let this propagate at startup — there is no safe fallback endpoint
+ * to construct a client against (AC3).
+ */
+export declare class MissingLLMConfigError extends Error {
+    readonly missing: readonly string[];
+    constructor(missing: readonly string[]);
+}
+/**
+ * Resolve `GENIE_LLM_REQUEST_TIMEOUT_MS`, falling back to the 120s default
+ * (AC5) when unset, blank, non-numeric, or non-positive. Mirrors the
+ * established fallback shape of `getPlanTTL` in `plans/index.ts`.
+ */
+export declare function resolveTimeoutMs(env?: NodeJS.ProcessEnv): number;
+/**
+ * Construct an `openai` SDK client from env vars (AC1). Throws
+ * `MissingLLMConfigError` synchronously if `GENIE_LLM_BASE_URL` or
+ * `GENIE_LLM_API_KEY` is unset or blank (AC2/AC3) — no default base URL is
+ * ever substituted.
+ *
+ * Exported as a factory (in addition to the `llmClient` singleton below) so
+ * tests can construct additional clients against a stub server, and so a
+ * future preflight/health-check path can validate config without relying on
+ * module-load side effects.
+ */
+export declare function createLLMClient(env?: NodeJS.ProcessEnv): OpenAI;
+/**
+ * The shared `openai` client every generation verb calls through (AC1).
+ * Constructed once at module load from env vars — a deployment missing
+ * `GENIE_LLM_BASE_URL`/`GENIE_LLM_API_KEY` fails the moment anything imports
+ * this module, rather than partway through a generation request.
+ */
+export declare const llmClient: OpenAI;
+/** Input accepted by {@link createChatCompletion} — a non-streaming chat-completion request. */
+export type ChatCompletionInput = OpenAI.ChatCompletionCreateParamsNonStreaming;
+/** Result returned by {@link createChatCompletion}. */
+export type ChatCompletionResult = OpenAI.ChatCompletion;
+/**
+ * Thin wrapper around `llmClient.chat.completions.create` (AC4). Emits a
+ * structured `{ model, promptTokens, completionTokens, latencyMs }` log line
+ * to **stderr** on success — never stdout, which on the stdio transport *is*
+ * the JSON-RPC protocol stream (see `transport.ts` / `tools/plan.ts`'s audit
+ * log for the same convention).
+ *
+ * Does not retry and does not swallow errors: a rejected `create()` call
+ * propagates to the caller untouched so M2-06's `withRetry(createChatCompletion)`
+ * can wrap this function directly.
+ */
+export declare function createChatCompletion(input: ChatCompletionInput): Promise<ChatCompletionResult>;
+//# sourceMappingURL=client.d.ts.map

package/dist/llm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/llm/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAI5B,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,qDAAqD;AACrD,eAAO,MAAM,gCAAgC,iCAAiC,CAAC;AAE/E,iDAAiD;AACjD,eAAO,MAAM,8BAA8B,SAAU,CAAC;AAItD;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAClB,OAAO,EAAE,SAAS,MAAM,EAAE;gBAA1B,OAAO,EAAE,SAAS,MAAM,EAAE;CASvD;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAS7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CA+B5E;AAID;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,MAA0B,CAAC;AAInD,gGAAgG;AAChG,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,sCAAsC,CAAC;AAChF,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,cAAc,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAgB/B"}