@llui/vite-plugin 0.0.28 → 0.0.30

package/README.md

@@ -23,9 +23,15 @@ export default defineConfig({
 ```ts
 llui({
   mcpPort: 5200, // MCP debug server port (default: 5200, false to disable)
+  agent: true, // Emit LLui Agent metadata in prod builds (default: false)
 })
 ```
 
+- `mcpPort` — MCP debug bridge port. Default `5200`. Set to `false` to disable.
+- `agent` — Opt into emitting schemas + binding descriptors in prod builds.
+  Required when the app is deployed with `@llui/agent/client`. Default `false`
+  (metadata is dev-only to keep production bundle size minimal).
+
 ## What It Does
 
 The compiler runs 3 passes over every `.ts`/`.tsx` file using the TypeScript Compiler API:

package/dist/binding-descriptors.d.ts

@@ -0,0 +1,23 @@
+export type BindingDescriptor = {
+    variant: string;
+};
+/**
+ * Walk the `view` arrow function of every top-level `component({...})` call
+ * in the source and collect every `send({type: '...'})` call site's variant
+ * literal. Returns them in encounter order.
+ *
+ * False positives: any call of the form `identifier({ type: 'x', ... })` —
+ * we don't verify the callee resolves to the destructured `send` from the
+ * view argument, because that level of scope tracking is beyond the budget
+ * of this MVP extractor. Apps that call other identifiers with similarly
+ * shaped literals would see those in the output. In practice, the pattern
+ * is uncommon enough that false positives are rare.
+ *
+ * Missing: non-literal `type` values (e.g. `send({type: nextStep})`) are
+ * skipped. This is the correct behavior — we can only record statically-
+ * known variants.
+ *
+ * @see agent spec §5.2, §12.2
+ */
+export declare function extractBindingDescriptors(source: string): BindingDescriptor[];
+//# sourceMappingURL=binding-descriptors.d.ts.map

package/dist/binding-descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-descriptors.d.ts","sourceRoot":"","sources":["../src/binding-descriptors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA2D7E"}

package/dist/binding-descriptors.js

@@ -0,0 +1,82 @@
+import ts from 'typescript';
+/**
+ * Walk the `view` arrow function of every top-level `component({...})` call
+ * in the source and collect every `send({type: '...'})` call site's variant
+ * literal. Returns them in encounter order.
+ *
+ * False positives: any call of the form `identifier({ type: 'x', ... })` —
+ * we don't verify the callee resolves to the destructured `send` from the
+ * view argument, because that level of scope tracking is beyond the budget
+ * of this MVP extractor. Apps that call other identifiers with similarly
+ * shaped literals would see those in the output. In practice, the pattern
+ * is uncommon enough that false positives are rare.
+ *
+ * Missing: non-literal `type` values (e.g. `send({type: nextStep})`) are
+ * skipped. This is the correct behavior — we can only record statically-
+ * known variants.
+ *
+ * @see agent spec §5.2, §12.2
+ */
+export function extractBindingDescriptors(source) {
+    const sf = ts.createSourceFile('view.ts', source, ts.ScriptTarget.Latest, true);
+    const out = [];
+    function visitComponentConfig(config) {
+        for (const prop of config.properties) {
+            if (!ts.isPropertyAssignment(prop))
+                continue;
+            if (!prop.name || !ts.isIdentifier(prop.name) || prop.name.text !== 'view')
+                continue;
+            const viewExpr = prop.initializer;
+            if (!ts.isArrowFunction(viewExpr) && !ts.isFunctionExpression(viewExpr))
+                continue;
+            collectSendCalls(viewExpr.body);
+        }
+    }
+    function collectSendCalls(node) {
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            const first = node.arguments[0];
+            if (callee && ts.isIdentifier(callee) && first && ts.isObjectLiteralExpression(first)) {
+                const variant = readTypeLiteral(first);
+                if (variant !== null) {
+                    out.push({ variant });
+                }
+            }
+        }
+        ts.forEachChild(node, collectSendCalls);
+    }
+    function readTypeLiteral(obj) {
+        for (const prop of obj.properties) {
+            if (!ts.isPropertyAssignment(prop))
+                continue;
+            if (!prop.name)
+                continue;
+            const nameOk = (ts.isIdentifier(prop.name) && prop.name.text === 'type') ||
+                (ts.isStringLiteral(prop.name) && prop.name.text === 'type');
+            if (!nameOk)
+                continue;
+            const init = prop.initializer;
+            if (ts.isStringLiteral(init))
+                return init.text;
+            if (ts.isNoSubstitutionTemplateLiteral(init))
+                return init.text;
+        }
+        return null;
+    }
+    function visitTopLevel(node) {
+        if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            const calleeName = ts.isIdentifier(callee) ? callee.text : null;
+            if (calleeName === 'component' && node.arguments.length > 0) {
+                const firstArg = node.arguments[0];
+                if (firstArg && ts.isObjectLiteralExpression(firstArg)) {
+                    visitComponentConfig(firstArg);
+                }
+            }
+        }
+        ts.forEachChild(node, visitTopLevel);
+    }
+    ts.forEachChild(sf, visitTopLevel);
+    return out;
+}
+//# sourceMappingURL=binding-descriptors.js.map

package/dist/binding-descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-descriptors.js","sourceRoot":"","sources":["../src/binding-descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAM3B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,MAAM,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/E,MAAM,GAAG,GAAwB,EAAE,CAAA;IAEnC,SAAS,oBAAoB,CAAC,MAAkC;QAC9D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAQ;YACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAA;YACjC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC;gBAAE,SAAQ;YACjF,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAED,SAAS,gBAAgB,CAAC,IAAa;QACrC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAA;YAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;YAC/B,IAAI,MAAM,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtF,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;gBACtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;oBACrB,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;IACzC,CAAC;IAED,SAAS,eAAe,CAAC,GAA+B;QACtD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAC5C,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,SAAQ;YACxB,MAAM,MAAM,GACV,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;gBACzD,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;YAC9D,IAAI,CAAC,MAAM;gBAAE,SAAQ;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAA;YAC7B,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAA;YAC9C,IAAI,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAA;QAChE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,SAAS,aAAa,CAAC,IAAa;QAClC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAA;YAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;YAC/D,IAAI,UAAU,KAAK,WAAW,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;gBAClC,IAAI,QAAQ,IAAI,EAAE,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACvD,oBAAoB,CAAC,QAAQ,CAAC,CAAA;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QACD,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IACtC,CAAC;IAED,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,aAAa,CAAC,CAAA;IAClC,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["import ts from 'typescript'\n\nexport type BindingDescriptor = {\n  variant: string\n}\n\n/**\n * Walk the `view` arrow function of every top-level `component({...})` call\n * in the source and collect every `send({type: '...'})` call site's variant\n * literal. Returns them in encounter order.\n *\n * False positives: any call of the form `identifier({ type: 'x', ... })` —\n * we don't verify the callee resolves to the destructured `send` from the\n * view argument, because that level of scope tracking is beyond the budget\n * of this MVP extractor. Apps that call other identifiers with similarly\n * shaped literals would see those in the output. In practice, the pattern\n * is uncommon enough that false positives are rare.\n *\n * Missing: non-literal `type` values (e.g. `send({type: nextStep})`) are\n * skipped. This is the correct behavior — we can only record statically-\n * known variants.\n *\n * @see agent spec §5.2, §12.2\n */\nexport function extractBindingDescriptors(source: string): BindingDescriptor[] {\n  const sf = ts.createSourceFile('view.ts', source, ts.ScriptTarget.Latest, true)\n  const out: BindingDescriptor[] = []\n\n  function visitComponentConfig(config: ts.ObjectLiteralExpression): void {\n    for (const prop of config.properties) {\n      if (!ts.isPropertyAssignment(prop)) continue\n      if (!prop.name || !ts.isIdentifier(prop.name) || prop.name.text !== 'view') continue\n      const viewExpr = prop.initializer\n      if (!ts.isArrowFunction(viewExpr) && !ts.isFunctionExpression(viewExpr)) continue\n      collectSendCalls(viewExpr.body)\n    }\n  }\n\n  function collectSendCalls(node: ts.Node): void {\n    if (ts.isCallExpression(node)) {\n      const callee = node.expression\n      const first = node.arguments[0]\n      if (callee && ts.isIdentifier(callee) && first && ts.isObjectLiteralExpression(first)) {\n        const variant = readTypeLiteral(first)\n        if (variant !== null) {\n          out.push({ variant })\n        }\n      }\n    }\n    ts.forEachChild(node, collectSendCalls)\n  }\n\n  function readTypeLiteral(obj: ts.ObjectLiteralExpression): string | null {\n    for (const prop of obj.properties) {\n      if (!ts.isPropertyAssignment(prop)) continue\n      if (!prop.name) continue\n      const nameOk =\n        (ts.isIdentifier(prop.name) && prop.name.text === 'type') ||\n        (ts.isStringLiteral(prop.name) && prop.name.text === 'type')\n      if (!nameOk) continue\n      const init = prop.initializer\n      if (ts.isStringLiteral(init)) return init.text\n      if (ts.isNoSubstitutionTemplateLiteral(init)) return init.text\n    }\n    return null\n  }\n\n  function visitTopLevel(node: ts.Node): void {\n    if (ts.isCallExpression(node)) {\n      const callee = node.expression\n      const calleeName = ts.isIdentifier(callee) ? callee.text : null\n      if (calleeName === 'component' && node.arguments.length > 0) {\n        const firstArg = node.arguments[0]\n        if (firstArg && ts.isObjectLiteralExpression(firstArg)) {\n          visitComponentConfig(firstArg)\n        }\n      }\n    }\n    ts.forEachChild(node, visitTopLevel)\n  }\n\n  ts.forEachChild(sf, visitTopLevel)\n  return out\n}\n"]}

package/dist/compiler-cache.d.ts

@@ -0,0 +1,20 @@
+export interface BindingSourceEntry {
+    bindingIndex: number;
+    file: string;
+    line: number;
+    column: number;
+}
+export interface CompilerCacheEntry {
+    preSource: string;
+    postSource: string;
+    msgMaskMap: Record<string, number>;
+    bindingSources: BindingSourceEntry[];
+}
+export declare class CompilerCache {
+    private readonly cache;
+    set(componentName: string, entry: CompilerCacheEntry): void;
+    get(componentName: string): CompilerCacheEntry | undefined;
+    has(componentName: string): boolean;
+}
+export declare const compilerCache: CompilerCache;
+//# sourceMappingURL=compiler-cache.d.ts.map

package/dist/compiler-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-cache.d.ts","sourceRoot":"","sources":["../src/compiler-cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,cAAc,EAAE,kBAAkB,EAAE,CAAA;CACrC;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;IAE9D,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAQ3D,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI1D,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;CAGpC;AAED,eAAO,MAAM,aAAa,eAAsB,CAAA"}

package/dist/compiler-cache.js

@@ -0,0 +1,20 @@
+const MAX_ENTRIES = 50;
+export class CompilerCache {
+    cache = new Map();
+    set(componentName, entry) {
+        if (this.cache.has(componentName))
+            this.cache.delete(componentName);
+        this.cache.set(componentName, entry);
+        if (this.cache.size > MAX_ENTRIES) {
+            this.cache.delete(this.cache.keys().next().value);
+        }
+    }
+    get(componentName) {
+        return this.cache.get(componentName);
+    }
+    has(componentName) {
+        return this.cache.has(componentName);
+    }
+}
+export const compilerCache = new CompilerCache();
+//# sourceMappingURL=compiler-cache.js.map

package/dist/compiler-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler-cache.js","sourceRoot":"","sources":["../src/compiler-cache.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,GAAG,EAAE,CAAA;AAEtB,MAAM,OAAO,aAAa;IACP,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAA;IAE9D,GAAG,CAAC,aAAqB,EAAE,KAAyB;QAClD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QACnE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAA;QACpD,CAAC;IACH,CAAC;IAED,GAAG,CAAC,aAAqB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,CAAC;IAED,GAAG,CAAC,aAAqB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IACtC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAA","sourcesContent":["export interface BindingSourceEntry {\n  bindingIndex: number\n  file: string\n  line: number\n  column: number\n}\n\nexport interface CompilerCacheEntry {\n  preSource: string\n  postSource: string\n  msgMaskMap: Record<string, number>\n  bindingSources: BindingSourceEntry[]\n}\n\nconst MAX_ENTRIES = 50\n\nexport class CompilerCache {\n  private readonly cache = new Map<string, CompilerCacheEntry>()\n\n  set(componentName: string, entry: CompilerCacheEntry): void {\n    if (this.cache.has(componentName)) this.cache.delete(componentName)\n    this.cache.set(componentName, entry)\n    if (this.cache.size > MAX_ENTRIES) {\n      this.cache.delete(this.cache.keys().next().value!)\n    }\n  }\n\n  get(componentName: string): CompilerCacheEntry | undefined {\n    return this.cache.get(componentName)\n  }\n\n  has(componentName: string): boolean {\n    return this.cache.has(componentName)\n  }\n}\n\nexport const compilerCache = new CompilerCache()\n"]}

package/dist/index.d.ts

@@ -47,6 +47,32 @@ export interface LluiPluginOptions {
      * template-clone to `elSplit`. Off by default.
      */
     verbose?: boolean;
+    /**
+     * Enables two things together when set:
+     *
+     *   1. Emits schemas + binding descriptors in prod builds so the
+     *      @llui/agent runtime has metadata to advertise over its WS hello
+     *      frame (see agent spec §7.4).
+     *   2. Auto-mounts `@llui/agent/server`'s router at `/agent/*` and its
+     *      WS upgrade handler at `/agent/ws` on the Vite dev server — so
+     *      plain `vite dev` has working agent endpoints with no extra
+     *      server.ts wiring. Requires `@llui/agent` installed; if it isn't,
+     *      the plugin warns and skips dev mounting (prod emission still
+     *      works from Plan 3b).
+     *
+     * Pass `true` for defaults (random signing key per dev session;
+     * `identityResolver` returns `'dev-user'`). Pass an object to customize.
+     * Default `false` — metadata is dev-only, no agent endpoints.
+     */
+    agent?: boolean | AgentPluginConfig;
 }
+export type AgentPluginConfig = {
+    /**
+     * HMAC signing key for tokens. ≥32 bytes. Rotation invalidates all
+     * tokens. Falls back to `process.env.AGENT_SIGNING_KEY`, then to a
+     * per-session random key (dev-only).
+     */
+    signingKey?: string;
+};
 export default function llui(options?: LluiPluginOptions): Plugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAOjD,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEhE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAqBtD,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAExB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IAE5C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAsCD,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA4SpE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAOjD,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEhE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAqBtD,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAExB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IAE5C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAmLD,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA6UpE"}

package/dist/index.js

@@ -62,6 +62,119 @@ function resolveMcpCliPath(root) {
         return null;
     }
 }
+/**
+ * Dynamically load @llui/agent/server relative to the app root and
+ * construct an agent server instance. Returns null if @llui/agent isn't
+ * installed — the plugin degrades to "prod schema emission only" mode.
+ */
+async function loadAgentServer(appRoot, cfg) {
+    let serverModule;
+    try {
+        // Walk up from the app root to find node_modules/@llui/agent. Works
+        // for both pnpm workspace and regular npm installs. Direct file-system
+        // walk avoids "exports" / "subpath './package.json'" gymnastics that
+        // require.resolve and Node's module resolver disagree on.
+        const pkgDir = findPackageDir(appRoot, '@llui/agent');
+        if (!pkgDir)
+            throw new Error('not found in any ancestor node_modules');
+        const pkg = JSON.parse(readFileSync(resolve(pkgDir, 'package.json'), 'utf8'));
+        const serverExport = pkg.exports?.['./server'];
+        const rel = typeof serverExport === 'string' ? serverExport : serverExport?.import;
+        if (!rel)
+            throw new Error('missing ./server export in package.json');
+        const modUrl = new URL(`file://${resolve(pkgDir, rel)}`).href;
+        serverModule = (await import(modUrl));
+    }
+    catch (e) {
+        console.warn('[llui] agent: true is set but `@llui/agent` could not be loaded: ' +
+            (e instanceof Error ? e.message : String(e)));
+        return null;
+    }
+    const { randomBytes } = await import('node:crypto');
+    const signingKey = cfg.signingKey ?? process.env['AGENT_SIGNING_KEY'] ?? randomBytes(32).toString('base64url');
+    return serverModule.createLluiAgentServer({
+        signingKey,
+        identityResolver: async () => 'dev-user',
+    });
+}
+/**
+ * Register the agent middleware + WS upgrade on the Vite dev server.
+ * Must be called synchronously from configureServer so registration
+ * happens BEFORE Vite installs its catch-all SPA fallback.
+ */
+function registerAgentMiddleware(server, agent) {
+    // Connect-style middleware. Vite's middleware chain runs in order, so
+    // synchronous registration during configureServer places us ahead of
+    // Vite's catch-all fallback.
+    server.middlewares.use((req, res, next) => {
+        const url = req.url ?? '/';
+        if (!url.startsWith('/agent/') && url !== '/agent') {
+            next();
+            return;
+        }
+        void handleAgentRequest(req, res, agent.router).catch((e) => {
+            console.error('[llui] agent middleware error:', e);
+            next(e);
+        });
+    });
+    // WS upgrade: only /agent/ws goes to the agent. Vite's own HMR upgrade
+    // uses a different path and runs as a separate listener on the same
+    // event, so this filter keeps both coexisting.
+    server.httpServer?.on('upgrade', (req, socket, head) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        if (url.pathname === '/agent/ws') {
+            agent.wsUpgrade(req, socket, head);
+        }
+    });
+    console.info('[llui] agent dev endpoints active: POST /agent/mint, WS /agent/ws, LAP /agent/lap/v1/*');
+}
+/**
+ * Walk up from `start` looking for `node_modules/<pkgName>`. Returns the
+ * absolute path to the package directory, or null if not found.
+ */
+function findPackageDir(start, pkgName) {
+    let dir = resolve(start);
+    while (true) {
+        const candidate = resolve(dir, 'node_modules', pkgName);
+        if (existsSync(resolve(candidate, 'package.json')))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/** Convert a Node http req → Web Request, call router, write the response. */
+async function handleAgentRequest(req, res, router) {
+    const method = req.method ?? 'GET';
+    const url = req.url ?? '/';
+    const headers = {};
+    for (const [k, v] of Object.entries(req.headers)) {
+        if (v === undefined)
+            continue;
+        headers[k] = Array.isArray(v) ? v.join(', ') : v;
+    }
+    let body;
+    if (!['GET', 'HEAD'].includes(method)) {
+        const chunks = [];
+        for await (const chunk of req)
+            chunks.push(chunk);
+        if (chunks.length > 0)
+            body = new Uint8Array(Buffer.concat(chunks));
+    }
+    const origin = `http://${req.headers.host ?? 'localhost'}`;
+    const webReq = new Request(`${origin}${url}`, { method, headers, body });
+    const webRes = await router(webReq);
+    if (!webRes) {
+        res.statusCode = 404;
+        res.end();
+        return;
+    }
+    res.statusCode = webRes.status;
+    webRes.headers.forEach((v, k) => res.setHeader(k, v));
+    const buf = Buffer.from(await webRes.arrayBuffer());
+    res.end(buf);
+}
 export default function llui(options = {}) {
     let devMode = false;
     // `mcpPort` + `mcpMode` are resolved lazily in `configResolved` so we
@@ -77,6 +190,12 @@ export default function llui(options = {}) {
     const failOnWarning = options.failOnWarning === true;
     const disabledWarnings = new Set(options.disabledWarnings ?? []);
     const verbose = options.verbose === true;
+    const agent = options.agent ?? false;
+    const agentConfig = typeof agent === 'object' ? agent : {};
+    // Agent server instance — loaded in configResolved (async), registered
+    // in configureServer (sync). Null until loaded, or if @llui/agent isn't
+    // installed.
+    let agentServer = null;
     // File-based handshake with @llui/mcp. The MCP server writes a marker
     // file when its bridge starts; we watch it and send a Vite HMR custom
     // event so the browser can call __lluiConnect() automatically — without
@@ -137,8 +256,14 @@ export default function llui(options = {}) {
     return {
         name: 'llui',
         enforce: 'pre',
-        configResolved(config) {
+        async configResolved(config) {
             devMode = config.command === 'serve' || config.mode === 'development';
+            // Load @llui/agent here (async) so we can register middleware
+            // synchronously in configureServer — which must happen BEFORE Vite
+            // installs its catch-all SPA/fallback middleware.
+            if (agent && devMode) {
+                agentServer = await loadAgentServer(config.root, agentConfig);
+            }
             if (options.mcpPort === false) {
                 mcpMode = 'disabled';
                 mcpPort = null;
@@ -164,6 +289,12 @@ export default function llui(options = {}) {
             }
         },
         configureServer(server) {
+            // Agent dev endpoints — runs regardless of mcp state. Must be before
+            // any early-returns below. Registration is synchronous because
+            // agentServer was preloaded in configResolved.
+            if (agentServer) {
+                registerAgentMiddleware(server, agentServer);
+            }
             if (mcpPort === null) {
                 // #3 diagnostic: MCP server is running but the plugin is opted
                 // out. Users in this state usually don't realize the mismatch —
@@ -298,6 +429,12 @@ export default function llui(options = {}) {
                 // absent.
                 notifyMcpReady(server);
             });
+            // ── Agent dev endpoints ──────────────────────────────────────
+            // When `agent: true` (or `agent: {...}`), auto-mount /agent/* on
+            // the Vite dev server so `pnpm dev` has working agent endpoints.
+            // Users with a custom server.ts (SSR apps) mount createLluiAgentServer
+            // themselves — configureServer also fires in middleware mode, but
+            // there server.httpServer is null so the upgrade hook is a no-op.
         },
         transform(code, id, options) {
             if (!id.endsWith('.ts') && !id.endsWith('.tsx'))
@@ -339,7 +476,7 @@ export default function llui(options = {}) {
                     }
                 }
             }
-            const result = transformLlui(code, id, devMode, mcpPort, verbose);
+            const result = transformLlui(code, id, devMode, Boolean(agent), mcpPort, verbose);
             if (!result)
                 return undefined;
             // Apply per-statement edits via MagicString for accurate source maps.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,IAAI,OAAO,EAAkB,MAAM,SAAS,CAAA;AACnG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAuB,MAAM,kBAAkB,CAAA;AAIhE;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,QAAgB,OAAO,CAAC,GAAG,EAAE;IACtD,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACxB,IAAI,eAAe,GAAkB,IAAI,CAAA;IACzC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QAC/D,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QAChD,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,eAAe,GAAG,GAAG,CAAA;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,eAAe,IAAI,KAAK,CAAA;QACnD,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAqDD;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACxD,GAAG,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;QACrC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACxD,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAE3D,CAAA;QACD,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAA;QAC1F,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAA;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,UAA6B,EAAE;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,sEAAsE;IACtE,mEAAmE;IACnE,8CAA8C;IAC9C,yEAAyE;IACzE,2EAA2E;IAC3E,8CAA8C;IAC9C,IAAI,OAAO,GAAkB,IAAI,CAAA;IACjC,IAAI,OAAO,GAAkC,UAAU,CAAA;IACvD,IAAI,UAAU,GAAkB,IAAI,CAAA;IACpC,IAAI,QAAQ,GAAwB,IAAI,CAAA;IACxC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,IAAI,CAAA;IACpD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAA;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAA;IAExC,sEAAsE;IACtE,sEAAsE;IACtE,wEAAwE;IACxE,+DAA+D;IAC/D,MAAM,cAAc,GAAG,OAAO,CAAC,iBAAiB,EAAE,EAAE,0CAA0C,CAAC,CAAA;IAC/F,IAAI,UAAU,GAAqB,IAAI,CAAA;IACvC,IAAI,UAAU,GAAqB,IAAI,CAAA;IACvC,oEAAoE;IACpE,uEAAuE;IACvE,kEAAkE;IAClE,kEAAkE;IAClE,IAAI,YAAY,GAAkB,IAAI,CAAA;IAEtC,SAAS,aAAa;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAA;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAG3D,CAAA;YACD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;YAC9C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,WAAW;QAClB,IAAI,YAAY,KAAK,IAAI;YAAE,OAAM;QACjC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,OAAM;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAA4B,CAAA;YAC1F,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY;gBAAE,OAAM;YAC1C,MAAM,CAAC,MAAM,GAAG,YAAY,CAAA;YAC5B,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;IACH,CAAC;IAED,SAAS,cAAc,CAAC,MAAqB;QAC3C,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;QAC9B,IAAI,MAAM,KAAK,IAAI;YAAE,OAAM;QAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC3E,CAAC;IAED,SAAS,gBAAgB,CAAC,MAAqB;QAC7C,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;IACzE,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,KAAK;QAEd,cAAc,CAAC,MAAM;YACnB,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,CAAA;YACrE,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBAC9B,OAAO,GAAG,UAAU,CAAA;gBACpB,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;iBAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC/C,OAAO,GAAG,MAAM,CAAA;gBAChB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;YAC3B,CAAC;iBAAM,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAC3C,IAAI,UAAU,EAAE,CAAC;oBACf,OAAO,GAAG,OAAO,CAAA;oBACjB,OAAO,GAAG,IAAI,CAAA;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,MAAM,CAAA;oBAChB,OAAO,GAAG,IAAI,CAAA;gBAChB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,UAAU,CAAA;gBACpB,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;QACH,CAAC;QAED,eAAe,CAAC,MAAM;YACpB,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,+DAA+D;gBAC/D,gEAAgE;gBAChE,iEAAiE;gBACjE,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC/B,OAAO,CAAC,IAAI,CACV,iDAAiD,cAAc,IAAI;wBACjE,iEAAiE;wBACjE,gEAAgE;wBAChE,gEAAgE;wBAChE,qDAAqD,CACxD,CAAA;gBACH,CAAC;gBACD,OAAM;YACR,CAAC;YAED,6DAA6D;YAC7D,kEAAkE;YAClE,kEAAkE;YAClE,+DAA+D;YAC/D,kCAAkC;YAClC,IAAI,OAAO,KAAK,OAAO,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC9E,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE;oBAC1E,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;oBACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;iBACxD,CAAC,CAAA;gBACF,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;oBAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;gBACjD,CAAC,CAAC,CAAA;gBACF,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;oBAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;gBACjD,CAAC,CAAC,CAAA;gBACF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC3B,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBAChC,OAAO,CAAC,IAAI,CAAC,2CAA2C,IAAI,EAAE,CAAC,CAAA;oBACjE,CAAC;oBACD,QAAQ,GAAG,IAAI,CAAA;gBACjB,CAAC,CAAC,CAAA;gBACF,MAAM,SAAS,GAAG,GAAS,EAAE;oBAC3B,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM;wBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAC5D,CAAC,CAAA;gBACD,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;gBACzC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;YACjC,CAAC;YAED,kEAAkE;YAClE,iEAAiE;YACjE,gEAAgE;YAChE,gEAAgE;YAChE,mEAAmE;YACnE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBACzD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;gBAC9B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAA;oBACpB,GAAG,CAAC,GAAG,EAAE,CAAA;oBACT,OAAM;gBACR,CAAC;gBACD,GAAG,CAAC,UAAU,GAAG,GAAG,CAAA;gBACpB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;gBACjD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;YAChD,CAAC,CAAC,CAAA;YAEF,kEAAkE;YAClE,+DAA+D;YAC/D,0BAA0B;YAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;YACnC,IAAI,CAAC;gBACH,wEAAwE;gBACxE,MAAM,QAAQ,GAAG,GAAS,EAAE;oBAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;wBAAE,OAAM;oBAC5B,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;wBAC7C,IAAI,QAAQ,KAAK,aAAa;4BAAE,OAAM;wBACtC,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;4BAC/B,yDAAyD;4BACzD,wDAAwD;4BACxD,wDAAwD;4BACxD,gCAAgC;4BAChC,WAAW,EAAE,CAAA;4BACb,cAAc,CAAC,MAAM,CAAC,CAAA;wBACxB,CAAC;6BAAM,CAAC;4BACN,gBAAgB,CAAC,MAAM,CAAC,CAAA;wBAC1B,CAAC;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC,CAAA;gBACD,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpB,QAAQ,EAAE,CAAA;gBACZ,CAAC;qBAAM,CAAC;oBACN,2DAA2D;oBAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;wBAC5B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;4BACpB,aAAa,CAAC,IAAI,CAAC,CAAA;4BACnB,QAAQ,EAAE,CAAA;wBACZ,CAAC;oBACH,CAAC,EAAE,IAAI,CAAC,CAAA;oBACR,2DAA2D;oBAC3D,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;gBAC3D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;YAED,kEAAkE;YAClE,+CAA+C;YAC/C,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;gBAC9B,IAAI,UAAU,CAAC,cAAc,CAAC;oBAAE,cAAc,CAAC,MAAM,CAAC,CAAA;YACxD,CAAC,CAAC,CAAA;YAEF,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAClC,UAAU,EAAE,KAAK,EAAE,CAAA;gBACnB,UAAU,EAAE,KAAK,EAAE,CAAA;gBACnB,UAAU,GAAG,IAAI,CAAA;gBACjB,UAAU,GAAG,IAAI,CAAA;YACnB,CAAC,CAAC,CAAA;YAEF,oEAAoE;YACpE,uDAAuD;YACvD,qEAAqE;YACrE,oEAAoE;YACpE,kEAAkE;YAClE,qCAAqC;YACrC,qEAAqE;YACrE,oEAAoE;YACpE,0DAA0D;YAC1D,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;gBACxC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,CAAA;gBAC5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;oBAAE,OAAM;gBACnD,MAAM,IAAI,GACR,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAA;gBAC3F,YAAY,GAAG,UAAU,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAA;gBAC/C,WAAW,EAAE,CAAA;gBACb,+DAA+D;gBAC/D,+DAA+D;gBAC/D,UAAU;gBACV,cAAc,CAAC,MAAM,CAAC,CAAA;YACxB,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO;YACzB,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAM;YAEvD,kEAAkE;YAClE,8DAA8D;YAC9D,kEAAkE;YAClE,kDAAkD;YAClD,IAAI,OAAO,EAAE,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;gBAC9C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;oBACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;oBAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;oBAC/C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;wBACtC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,KAAK,OAAO,EAAE,CAAC,CAAA;oBACrC,CAAC;oBACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAA;gBACvD,CAAC;YACH,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,8DAA8D;gBAC9D,gEAAgE;gBAChE,gEAAgE;gBAChE,wCAAwC;gBACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;gBACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;gBAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;gBAC/C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;oBAC5B,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;wBAAE,SAAQ;oBAC1C,MAAM,OAAO,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;oBAC5E,IAAI,aAAa,EAAE,CAAC;wBAClB,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;oBAC5E,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;oBACxD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YACjE,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAA;YAE7B,sEAAsE;YACtE,sDAAsD;YACtD,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAA;YAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC5B,sEAAsE;oBACtE,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM;wBAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;;wBACrD,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;gBAClD,CAAC;qBAAM,CAAC;oBACN,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;gBACrD,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAClB,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;aACtE,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { Plugin, ViteDevServer } from 'vite'\nimport MagicString from 'magic-string'\nimport { existsSync, readFileSync, writeFileSync, watch as fsWatch, type FSWatcher } from 'node:fs'\nimport { dirname, relative, resolve } from 'node:path'\nimport { createRequire } from 'node:module'\nimport { spawn, type ChildProcess } from 'node:child_process'\nimport { transformLlui, transformUseClientSsr, hasUseClientDirective } from './transform.js'\nimport { diagnose, type DiagnosticRule } from './diagnostics.js'\n\nexport type { DiagnosticRule } from './diagnostics.js'\n\n/**\n * Locate the workspace root so we share the MCP active marker file\n * with @llui/mcp regardless of which subdirectory the dev server runs in.\n * Mirrors `findWorkspaceRoot` from @llui/mcp — duplicated to avoid a\n * vite-plugin → mcp dependency cycle. The contract must stay in sync.\n */\nfunction findWorkspaceRoot(start: string = process.cwd()): string {\n  let dir = resolve(start)\n  let lastPackageJson: string | null = null\n  while (true) {\n    if (existsSync(resolve(dir, 'pnpm-workspace.yaml'))) return dir\n    if (existsSync(resolve(dir, '.git'))) return dir\n    if (existsSync(resolve(dir, 'package.json'))) lastPackageJson = dir\n    const parent = dirname(dir)\n    if (parent === dir) return lastPackageJson ?? start\n    dir = parent\n  }\n}\n\nexport interface LluiPluginOptions {\n  /**\n   * Port for the MCP debug bridge. In dev mode, the runtime relay connects\n   * to `ws://127.0.0.1:<port>` so an external `llui-mcp` server can forward\n   * tool calls into the running app.\n   *\n   * When omitted, the plugin checks whether `@llui/mcp` is resolvable from\n   * the Vite project root. If yes → defaults to `5200`. If no → stays\n   * disabled. This means installing `@llui/mcp` (+ starting its server)\n   * Just Works without an explicit config entry. Pass an explicit `false`\n   * to opt out even when `@llui/mcp` is installed; pass a number to use\n   * a non-default port. When enabled but the MCP server isn't running,\n   * the plugin returns 404 from its discovery endpoint and the browser\n   * silently skips the connection — no retry noise.\n   */\n  mcpPort?: number | false\n\n  /**\n   * Treat every compiler diagnostic as a build error.\n   *\n   * Default `false` — diagnostics are emitted via rollup's `this.warn` and\n   * can be ignored. Set to `true` in CI so lint-style regressions (namespace\n   * imports, bitmask overflow, spread-in-children, `.map()` on state, etc.)\n   * fail the build without requiring a custom `build.rollupOptions.onwarn`\n   * handler.\n   */\n  failOnWarning?: boolean\n\n  /**\n   * Silence specific diagnostic rules without disabling the whole lint\n   * pass. Each message is tagged with a rule name (shown in brackets at\n   * the start of every warning, e.g. `[spread-in-children]`). Listing\n   * a rule here drops all diagnostics with that tag before rollup sees\n   * them — so they don't fire via `this.warn` and don't fail the build\n   * even when `failOnWarning` is enabled.\n   *\n   * The valid rule names are enumerated by the `DiagnosticRule` type\n   * re-exported from this module. Unknown rule names are ignored.\n   */\n  disabledWarnings?: readonly DiagnosticRule[]\n\n  /**\n   * Emit `[llui]`-prefixed `console.info` logs for every transformed\n   * component file — state-path bit assignments, mask injections, and\n   * helper compile/bail counts. Useful when diagnosing why a binding\n   * isn't gated the way you expect, or why a call fell back from\n   * template-clone to `elSplit`. Off by default.\n   */\n  verbose?: boolean\n}\n\n/**\n * Does `@llui/mcp` resolve from `root`'s node_modules? Uses\n * `require.resolve` so monorepo workspaces and hoisted installs both\n * work. Catches failures silently — the only consequence is that we\n * leave `mcpPort` disabled, which is the safe default.\n */\nfunction hasMcpPackage(root: string): boolean {\n  try {\n    const req = createRequire(resolve(root, 'package.json'))\n    req.resolve('@llui/mcp/package.json')\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Resolve the path to the llui-mcp CLI entry. Reads `bin.llui-mcp`\n * from @llui/mcp's package.json and joins it against the package\n * directory. Returns null if @llui/mcp isn't resolvable.\n */\nfunction resolveMcpCliPath(root: string): string | null {\n  try {\n    const req = createRequire(resolve(root, 'package.json'))\n    const pkgJsonPath = req.resolve('@llui/mcp/package.json')\n    const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf8')) as {\n      bin?: string | Record<string, string>\n    }\n    const binEntry = typeof pkgJson.bin === 'string' ? pkgJson.bin : pkgJson.bin?.['llui-mcp']\n    if (!binEntry) return null\n    return resolve(dirname(pkgJsonPath), binEntry)\n  } catch {\n    return null\n  }\n}\n\nexport default function llui(options: LluiPluginOptions = {}): Plugin {\n  let devMode = false\n  // `mcpPort` + `mcpMode` are resolved lazily in `configResolved` so we\n  // can check for @llui/mcp in the consuming project's node_modules.\n  //   - `options.mcpPort === false`  → disabled\n  //   - explicit number              → wire-only (user manages the server)\n  //   - undefined + @llui/mcp found  → spawn (plugin starts llui-mcp --http)\n  //   - undefined + no @llui/mcp     → disabled\n  let mcpPort: number | null = null\n  let mcpMode: 'disabled' | 'wire' | 'spawn' = 'disabled'\n  let mcpCliPath: string | null = null\n  let mcpChild: ChildProcess | null = null\n  const failOnWarning = options.failOnWarning === true\n  const disabledWarnings = new Set<string>(options.disabledWarnings ?? [])\n  const verbose = options.verbose === true\n\n  // File-based handshake with @llui/mcp. The MCP server writes a marker\n  // file when its bridge starts; we watch it and send a Vite HMR custom\n  // event so the browser can call __lluiConnect() automatically — without\n  // retry spam, regardless of whether MCP or Vite started first.\n  const activeFilePath = resolve(findWorkspaceRoot(), 'node_modules/.cache/llui-mcp/active.json')\n  let mcpWatcher: FSWatcher | null = null\n  let dirWatcher: FSWatcher | null = null\n  // Cached once Vite's HTTP server emits `listening`. `stampDevUrl()`\n  // uses this to write the URL into the marker file — either immediately\n  // (if MCP already started and wrote one) or later when the marker\n  // appears via the directory watcher (MCP-starts-after-Vite path).\n  let cachedDevUrl: string | null = null\n\n  function readMcpMarker(): { port: number; devUrl?: string } | null {\n    try {\n      if (!existsSync(activeFilePath)) return null\n      const data = JSON.parse(readFileSync(activeFilePath, 'utf8')) as {\n        port?: number\n        devUrl?: string\n      }\n      if (typeof data.port !== 'number') return null\n      return { port: data.port, ...(data.devUrl ? { devUrl: data.devUrl } : {}) }\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Idempotently write `cachedDevUrl` into the marker file. No-op if the\n   * URL hasn't been captured yet (Vite hasn't emitted `listening`) or if\n   * the marker file doesn't exist (MCP hasn't started yet). Covers both\n   * orderings — the listening hook calls this after caching, and the\n   * directory watcher calls it when the marker appears later.\n   */\n  function stampDevUrl(): void {\n    if (cachedDevUrl === null) return\n    if (!existsSync(activeFilePath)) return\n    try {\n      const marker = JSON.parse(readFileSync(activeFilePath, 'utf8')) as Record<string, unknown>\n      if (marker.devUrl === cachedDevUrl) return\n      marker.devUrl = cachedDevUrl\n      writeFileSync(activeFilePath, JSON.stringify(marker))\n    } catch {\n      // Best-effort — failure to update the marker should not crash Vite\n    }\n  }\n\n  function notifyMcpReady(server: ViteDevServer): void {\n    const marker = readMcpMarker()\n    if (marker === null) return\n    server.ws.send({ type: 'custom', event: 'llui:mcp-ready', data: marker })\n  }\n\n  function notifyMcpOffline(server: ViteDevServer): void {\n    server.ws.send({ type: 'custom', event: 'llui:mcp-offline', data: {} })\n  }\n\n  return {\n    name: 'llui',\n    enforce: 'pre',\n\n    configResolved(config) {\n      devMode = config.command === 'serve' || config.mode === 'development'\n      if (options.mcpPort === false) {\n        mcpMode = 'disabled'\n        mcpPort = null\n      } else if (typeof options.mcpPort === 'number') {\n        mcpMode = 'wire'\n        mcpPort = options.mcpPort\n      } else if (hasMcpPackage(config.root)) {\n        mcpCliPath = resolveMcpCliPath(config.root)\n        if (mcpCliPath) {\n          mcpMode = 'spawn'\n          mcpPort = 5200\n        } else {\n          mcpMode = 'wire'\n          mcpPort = 5200\n        }\n      } else {\n        mcpMode = 'disabled'\n        mcpPort = null\n      }\n    },\n\n    configureServer(server) {\n      if (mcpPort === null) {\n        // #3 diagnostic: MCP server is running but the plugin is opted\n        // out. Users in this state usually don't realize the mismatch —\n        // loud-and-early log saves the \"why isn't my MCP attached\" hunt.\n        if (existsSync(activeFilePath)) {\n          console.warn(\n            `[llui] @llui/mcp server is running (marker at ${activeFilePath}) ` +\n              `but the Vite plugin is opted out (mcpPort: false, or @llui/mcp ` +\n              `isn't a dep of this project). Add \\`llui({ mcpPort: 5200 })\\` ` +\n              `to vite.config to wire them up, or remove the marker file and ` +\n              `stop the MCP server if the mismatch was unintended.`,\n          )\n        }\n        return\n      }\n\n      // Spawn mode: plugin launches llui-mcp as a child process so\n      // `pnpm dev` handles the whole stack. Skip spawning when a marker\n      // already exists — something (usually a separate llui-mcp process\n      // started before Vite) is already listening. The existing wire\n      // behavior takes over from there.\n      if (mcpMode === 'spawn' && mcpCliPath !== null && !existsSync(activeFilePath)) {\n        mcpChild = spawn(process.execPath, [mcpCliPath, '--http', String(mcpPort)], {\n          stdio: ['ignore', 'pipe', 'pipe'],\n          env: { ...process.env, LLUI_MCP_PORT: String(mcpPort) },\n        })\n        mcpChild.stdout?.on('data', (buf: Buffer) => {\n          process.stdout.write(`[mcp] ${buf.toString()}`)\n        })\n        mcpChild.stderr?.on('data', (buf: Buffer) => {\n          process.stderr.write(`[mcp] ${buf.toString()}`)\n        })\n        mcpChild.on('exit', (code) => {\n          if (code !== 0 && code !== null) {\n            console.warn(`[llui] @llui/mcp child exited with code ${code}`)\n          }\n          mcpChild = null\n        })\n        const killChild = (): void => {\n          if (mcpChild && !mcpChild.killed) mcpChild.kill('SIGTERM')\n        }\n        server.httpServer?.on('close', killChild)\n        process.once('exit', killChild)\n      }\n\n      // HTTP endpoint: the browser fetches this on load to discover the\n      // current MCP port. Avoids the race where HMR events sent before\n      // the import.meta.hot listener registers get dropped — and lets\n      // the browser connect to the actual port (which may differ from\n      // the compile-time default if MCP was started with LLUI_MCP_PORT).\n      server.middlewares.use('/__llui_mcp_status', (_req, res) => {\n        const marker = readMcpMarker()\n        if (marker === null) {\n          res.statusCode = 404\n          res.end()\n          return\n        }\n        res.statusCode = 200\n        res.setHeader('content-type', 'application/json')\n        res.end(JSON.stringify({ port: marker.port }))\n      })\n\n      // Watch the marker file for create/delete. fs.watch on the parent\n      // directory catches both events; the file itself may not exist\n      // when we start watching.\n      const dir = dirname(activeFilePath)\n      try {\n        // Watch the parent directory for the marker file appearing/disappearing\n        const watchDir = (): void => {\n          if (!existsSync(dir)) return\n          dirWatcher = fsWatch(dir, (_event, filename) => {\n            if (filename !== 'active.json') return\n            if (existsSync(activeFilePath)) {\n              // Stamp BEFORE notifying so the `llui:mcp-ready` payload\n              // carries the cached devUrl. This is the MCP-after-Vite\n              // path: listening already fired and cached the URL; the\n              // marker is only now appearing.\n              stampDevUrl()\n              notifyMcpReady(server)\n            } else {\n              notifyMcpOffline(server)\n            }\n          })\n        }\n        if (existsSync(dir)) {\n          watchDir()\n        } else {\n          // Parent directory doesn't exist yet — poll for it briefly\n          const poll = setInterval(() => {\n            if (existsSync(dir)) {\n              clearInterval(poll)\n              watchDir()\n            }\n          }, 1000)\n          // Clean up the poller if vite shuts down before MCP starts\n          server.httpServer?.on('close', () => clearInterval(poll))\n        }\n      } catch {\n        // fs.watch can fail on some filesystems — degrade silently\n      }\n\n      // Re-send the ready event when a new HMR client connects, in case\n      // the page loads while MCP is already running.\n      server.ws.on('connection', () => {\n        if (existsSync(activeFilePath)) notifyMcpReady(server)\n      })\n\n      server.httpServer?.on('close', () => {\n        mcpWatcher?.close()\n        dirWatcher?.close()\n        mcpWatcher = null\n        dirWatcher = null\n      })\n\n      // Once Vite's HTTP server is listening, cache our dev URL and stamp\n      // it into the marker file. Two orderings are possible:\n      //   (a) MCP started FIRST → marker exists now → stampDevUrl() writes\n      //       it, and we broadcast llui:mcp-ready so the browser picks up\n      //       the devUrl without relying on an incidental fs.watch tick\n      //       (which can miss on NFS/SMB).\n      //   (b) MCP will start LATER → marker doesn't exist yet → stamp is a\n      //       no-op. When MCP eventually writes the marker, the directory\n      //       watcher fires, calls stampDevUrl(), and notifies.\n      server.httpServer?.once('listening', () => {\n        const address = server.httpServer?.address()\n        if (!address || typeof address !== 'object') return\n        const host =\n          address.address === '::' || address.address === '0.0.0.0' ? 'localhost' : address.address\n        cachedDevUrl = `http://${host}:${address.port}`\n        stampDevUrl()\n        // Broadcast after stamping so the payload carries devUrl. Only\n        // fires in case (a) — notifyMcpReady no-ops when the marker is\n        // absent.\n        notifyMcpReady(server)\n      })\n    },\n\n    transform(code, id, options) {\n      if (!id.endsWith('.ts') && !id.endsWith('.tsx')) return\n\n      // `'use client'` directive — SSR builds replace the module with a\n      // stub so top-level imports and side effects never run on the\n      // server. Client builds pass through to the normal transform; the\n      // directive is effectively a no-op on the client.\n      if (options?.ssr && hasUseClientDirective(code)) {\n        const result = transformUseClientSsr(code, id)\n        if (result) {\n          const cwd = process.cwd()\n          const rel = relative(cwd, id)\n          const display = rel.startsWith('..') ? id : rel\n          for (const warning of result.warnings) {\n            this.warn(`${display}: ${warning}`)\n          }\n          return { code: result.output, map: { mappings: '' } }\n        }\n      }\n\n      const diagnostics = diagnose(code)\n      if (diagnostics.length > 0) {\n        // Prefix every diagnostic with `<file>:<line>:<col>` plus the\n        // `[rule-name]` tag so consumers logging `warning.message` in a\n        // custom onwarn handler see both the location and the rule they\n        // could silence via `disabledWarnings`.\n        const cwd = process.cwd()\n        const rel = relative(cwd, id)\n        const display = rel.startsWith('..') ? id : rel\n        for (const d of diagnostics) {\n          if (disabledWarnings.has(d.rule)) continue\n          const message = `${display}:${d.line}:${d.column}: [${d.rule}] ${d.message}`\n          if (failOnWarning) {\n            this.error({ message, loc: { line: d.line, column: d.column, file: id } })\n          } else {\n            this.warn(message, { line: d.line, column: d.column })\n          }\n        }\n      }\n\n      const result = transformLlui(code, id, devMode, mcpPort, verbose)\n      if (!result) return undefined\n\n      // Apply per-statement edits via MagicString for accurate source maps.\n      // Untouched statements keep their original positions.\n      const s = new MagicString(code)\n      for (const edit of result.edits) {\n        if (edit.start === edit.end) {\n          // Insert at position — appendRight for middle, append for end-of-file\n          if (edit.start === code.length) s.append(edit.replacement)\n          else s.appendRight(edit.start, edit.replacement)\n        } else {\n          s.overwrite(edit.start, edit.end, edit.replacement)\n        }\n      }\n\n      return {\n        code: s.toString(),\n        map: s.generateMap({ source: id, includeContent: true, hires: true }),\n      }\n    },\n  }\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,IAAI,OAAO,EAAkB,MAAM,SAAS,CAAA;AACnG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAuB,MAAM,kBAAkB,CAAA;AAIhE;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,QAAgB,OAAO,CAAC,GAAG,EAAE;IACtD,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACxB,IAAI,eAAe,GAAkB,IAAI,CAAA;IACzC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QAC/D,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QAChD,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,eAAe,GAAG,GAAG,CAAA;QACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,eAAe,IAAI,KAAK,CAAA;QACnD,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAiFD;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACxD,GAAG,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;QACrC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACxD,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAE3D,CAAA;QACD,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAA;QAC1F,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAA;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAWD;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,GAAsB;IAEtB,IAAI,YAKH,CAAA;IACD,IAAI,CAAC;QACH,oEAAoE;QACpE,uEAAuE;QACvE,qEAAqE;QACrE,0DAA0D;QAC1D,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QACrD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE3E,CAAA;QACD,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAA;QAC9C,MAAM,GAAG,GAAG,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,CAAA;QAClF,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;QACpE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAA;QAC7D,YAAY,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAwB,CAAA;IAC9D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,mEAAmE;YACjE,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAC/C,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;IACnD,MAAM,UAAU,GACd,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAE7F,OAAO,YAAY,CAAC,qBAAqB,CAAC;QACxC,UAAU;QACV,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU;KACzC,CAAC,CAAA;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,uBAAuB,CAAC,MAAqB,EAAE,KAA0B;IAChF,sEAAsE;IACtE,qEAAqE;IACrE,6BAA6B;IAC7B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACxC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAA;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnD,IAAI,EAAE,CAAA;YACN,OAAM;QACR,CAAC;QACD,KAAK,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1D,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,CAAC,CAAC,CAAA;YAClD,IAAI,CAAC,CAAC,CAAC,CAAA;QACT,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,uEAAuE;IACvE,oEAAoE;IACpE,+CAA+C;IAC/C,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAA;QACvD,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACjC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAA;QACpC,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,IAAI,CACV,wFAAwF,CACzF,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAa,EAAE,OAAe;IACpD,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACxB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;QACvD,IAAI,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,SAAS,CAAA;QACpE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC/B,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,KAAK,UAAU,kBAAkB,CAC/B,GAAmC,EACnC,GAAkC,EAClC,MAAkD;IAElD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAA;IAClC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAA;IAC1B,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,SAAS;YAAE,SAAQ;QAC7B,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAClD,CAAC;IACD,IAAI,IAA0B,CAAA;IAC9B,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAA;QAC3D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IACrE,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAA;IAC1D,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,GAAG,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IACxE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAA;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,GAAG,CAAC,UAAU,GAAG,GAAG,CAAA;QACpB,GAAG,CAAC,GAAG,EAAE,CAAA;QACT,OAAM;IACR,CAAC;IACD,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAA;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;IACnD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,UAA6B,EAAE;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,sEAAsE;IACtE,mEAAmE;IACnE,8CAA8C;IAC9C,yEAAyE;IACzE,2EAA2E;IAC3E,8CAA8C;IAC9C,IAAI,OAAO,GAAkB,IAAI,CAAA;IACjC,IAAI,OAAO,GAAkC,UAAU,CAAA;IACvD,IAAI,UAAU,GAAkB,IAAI,CAAA;IACpC,IAAI,QAAQ,GAAwB,IAAI,CAAA;IACxC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,KAAK,IAAI,CAAA;IACpD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAA;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI,CAAA;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;IACpC,MAAM,WAAW,GAAsB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7E,uEAAuE;IACvE,wEAAwE;IACxE,aAAa;IACb,IAAI,WAAW,GAOJ,IAAI,CAAA;IAEf,sEAAsE;IACtE,sEAAsE;IACtE,wEAAwE;IACxE,+DAA+D;IAC/D,MAAM,cAAc,GAAG,OAAO,CAAC,iBAAiB,EAAE,EAAE,0CAA0C,CAAC,CAAA;IAC/F,IAAI,UAAU,GAAqB,IAAI,CAAA;IACvC,IAAI,UAAU,GAAqB,IAAI,CAAA;IACvC,oEAAoE;IACpE,uEAAuE;IACvE,kEAAkE;IAClE,kEAAkE;IAClE,IAAI,YAAY,GAAkB,IAAI,CAAA;IAEtC,SAAS,aAAa;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAA;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAG3D,CAAA;YACD,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;YAC9C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,WAAW;QAClB,IAAI,YAAY,KAAK,IAAI;YAAE,OAAM;QACjC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,OAAM;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAA4B,CAAA;YAC1F,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY;gBAAE,OAAM;YAC1C,MAAM,CAAC,MAAM,GAAG,YAAY,CAAA;YAC5B,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;IACH,CAAC;IAED,SAAS,cAAc,CAAC,MAAqB;QAC3C,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;QAC9B,IAAI,MAAM,KAAK,IAAI;YAAE,OAAM;QAC3B,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC3E,CAAC;IAED,SAAS,gBAAgB,CAAC,MAAqB;QAC7C,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;IACzE,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,KAAK;QAEd,KAAK,CAAC,cAAc,CAAC,MAAM;YACzB,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,CAAA;YACrE,8DAA8D;YAC9D,mEAAmE;YACnE,kDAAkD;YAClD,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;gBACrB,WAAW,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;YAC/D,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;gBAC9B,OAAO,GAAG,UAAU,CAAA;gBACpB,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;iBAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC/C,OAAO,GAAG,MAAM,CAAA;gBAChB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;YAC3B,CAAC;iBAAM,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBAC3C,IAAI,UAAU,EAAE,CAAC;oBACf,OAAO,GAAG,OAAO,CAAA;oBACjB,OAAO,GAAG,IAAI,CAAA;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,MAAM,CAAA;oBAChB,OAAO,GAAG,IAAI,CAAA;gBAChB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,UAAU,CAAA;gBACpB,OAAO,GAAG,IAAI,CAAA;YAChB,CAAC;QACH,CAAC;QAED,eAAe,CAAC,MAAM;YACpB,qEAAqE;YACrE,+DAA+D;YAC/D,+CAA+C;YAC/C,IAAI,WAAW,EAAE,CAAC;gBAChB,uBAAuB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;YAC9C,CAAC;YAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,+DAA+D;gBAC/D,gEAAgE;gBAChE,iEAAiE;gBACjE,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC/B,OAAO,CAAC,IAAI,CACV,iDAAiD,cAAc,IAAI;wBACjE,iEAAiE;wBACjE,gEAAgE;wBAChE,gEAAgE;wBAChE,qDAAqD,CACxD,CAAA;gBACH,CAAC;gBACD,OAAM;YACR,CAAC;YAED,6DAA6D;YAC7D,kEAAkE;YAClE,kEAAkE;YAClE,+DAA+D;YAC/D,kCAAkC;YAClC,IAAI,OAAO,KAAK,OAAO,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC9E,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE;oBAC1E,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;oBACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE;iBACxD,CAAC,CAAA;gBACF,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;oBAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;gBACjD,CAAC,CAAC,CAAA;gBACF,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;oBAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;gBACjD,CAAC,CAAC,CAAA;gBACF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;oBAC3B,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;wBAChC,OAAO,CAAC,IAAI,CAAC,2CAA2C,IAAI,EAAE,CAAC,CAAA;oBACjE,CAAC;oBACD,QAAQ,GAAG,IAAI,CAAA;gBACjB,CAAC,CAAC,CAAA;gBACF,MAAM,SAAS,GAAG,GAAS,EAAE;oBAC3B,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM;wBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAC5D,CAAC,CAAA;gBACD,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;gBACzC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;YACjC,CAAC;YAED,kEAAkE;YAClE,iEAAiE;YACjE,gEAAgE;YAChE,gEAAgE;YAChE,mEAAmE;YACnE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBACzD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;gBAC9B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAA;oBACpB,GAAG,CAAC,GAAG,EAAE,CAAA;oBACT,OAAM;gBACR,CAAC;gBACD,GAAG,CAAC,UAAU,GAAG,GAAG,CAAA;gBACpB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;gBACjD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;YAChD,CAAC,CAAC,CAAA;YAEF,kEAAkE;YAClE,+DAA+D;YAC/D,0BAA0B;YAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;YACnC,IAAI,CAAC;gBACH,wEAAwE;gBACxE,MAAM,QAAQ,GAAG,GAAS,EAAE;oBAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;wBAAE,OAAM;oBAC5B,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;wBAC7C,IAAI,QAAQ,KAAK,aAAa;4BAAE,OAAM;wBACtC,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;4BAC/B,yDAAyD;4BACzD,wDAAwD;4BACxD,wDAAwD;4BACxD,gCAAgC;4BAChC,WAAW,EAAE,CAAA;4BACb,cAAc,CAAC,MAAM,CAAC,CAAA;wBACxB,CAAC;6BAAM,CAAC;4BACN,gBAAgB,CAAC,MAAM,CAAC,CAAA;wBAC1B,CAAC;oBACH,CAAC,CAAC,CAAA;gBACJ,CAAC,CAAA;gBACD,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpB,QAAQ,EAAE,CAAA;gBACZ,CAAC;qBAAM,CAAC;oBACN,2DAA2D;oBAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;wBAC5B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;4BACpB,aAAa,CAAC,IAAI,CAAC,CAAA;4BACnB,QAAQ,EAAE,CAAA;wBACZ,CAAC;oBACH,CAAC,EAAE,IAAI,CAAC,CAAA;oBACR,2DAA2D;oBAC3D,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;gBAC3D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;YAC7D,CAAC;YAED,kEAAkE;YAClE,+CAA+C;YAC/C,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;gBAC9B,IAAI,UAAU,CAAC,cAAc,CAAC;oBAAE,cAAc,CAAC,MAAM,CAAC,CAAA;YACxD,CAAC,CAAC,CAAA;YAEF,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAClC,UAAU,EAAE,KAAK,EAAE,CAAA;gBACnB,UAAU,EAAE,KAAK,EAAE,CAAA;gBACnB,UAAU,GAAG,IAAI,CAAA;gBACjB,UAAU,GAAG,IAAI,CAAA;YACnB,CAAC,CAAC,CAAA;YAEF,oEAAoE;YACpE,uDAAuD;YACvD,qEAAqE;YACrE,oEAAoE;YACpE,kEAAkE;YAClE,qCAAqC;YACrC,qEAAqE;YACrE,oEAAoE;YACpE,0DAA0D;YAC1D,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;gBACxC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,CAAA;gBAC5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;oBAAE,OAAM;gBACnD,MAAM,IAAI,GACR,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAA;gBAC3F,YAAY,GAAG,UAAU,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAA;gBAC/C,WAAW,EAAE,CAAA;gBACb,+DAA+D;gBAC/D,+DAA+D;gBAC/D,UAAU;gBACV,cAAc,CAAC,MAAM,CAAC,CAAA;YACxB,CAAC,CAAC,CAAA;YAEF,gEAAgE;YAChE,iEAAiE;YACjE,iEAAiE;YACjE,uEAAuE;YACvE,kEAAkE;YAClE,kEAAkE;QACpE,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO;YACzB,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAM;YAEvD,kEAAkE;YAClE,8DAA8D;YAC9D,kEAAkE;YAClE,kDAAkD;YAClD,IAAI,OAAO,EAAE,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;gBAC9C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;oBACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;oBAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;oBAC/C,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;wBACtC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,KAAK,OAAO,EAAE,CAAC,CAAA;oBACrC,CAAC;oBACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAA;gBACvD,CAAC;YACH,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,8DAA8D;gBAC9D,gEAAgE;gBAChE,gEAAgE;gBAChE,wCAAwC;gBACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;gBACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;gBAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;gBAC/C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;oBAC5B,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;wBAAE,SAAQ;oBAC1C,MAAM,OAAO,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;oBAC5E,IAAI,aAAa,EAAE,CAAC;wBAClB,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;oBAC5E,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;oBACxD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YACjF,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAA;YAE7B,sEAAsE;YACtE,sDAAsD;YACtD,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAA;YAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC5B,sEAAsE;oBACtE,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM;wBAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;;wBACrD,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;gBAClD,CAAC;qBAAM,CAAC;oBACN,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;gBACrD,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;gBAClB,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;aACtE,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { Plugin, ViteDevServer } from 'vite'\nimport MagicString from 'magic-string'\nimport { existsSync, readFileSync, writeFileSync, watch as fsWatch, type FSWatcher } from 'node:fs'\nimport { dirname, relative, resolve } from 'node:path'\nimport { createRequire } from 'node:module'\nimport { spawn, type ChildProcess } from 'node:child_process'\nimport { transformLlui, transformUseClientSsr, hasUseClientDirective } from './transform.js'\nimport { diagnose, type DiagnosticRule } from './diagnostics.js'\n\nexport type { DiagnosticRule } from './diagnostics.js'\n\n/**\n * Locate the workspace root so we share the MCP active marker file\n * with @llui/mcp regardless of which subdirectory the dev server runs in.\n * Mirrors `findWorkspaceRoot` from @llui/mcp — duplicated to avoid a\n * vite-plugin → mcp dependency cycle. The contract must stay in sync.\n */\nfunction findWorkspaceRoot(start: string = process.cwd()): string {\n  let dir = resolve(start)\n  let lastPackageJson: string | null = null\n  while (true) {\n    if (existsSync(resolve(dir, 'pnpm-workspace.yaml'))) return dir\n    if (existsSync(resolve(dir, '.git'))) return dir\n    if (existsSync(resolve(dir, 'package.json'))) lastPackageJson = dir\n    const parent = dirname(dir)\n    if (parent === dir) return lastPackageJson ?? start\n    dir = parent\n  }\n}\n\nexport interface LluiPluginOptions {\n  /**\n   * Port for the MCP debug bridge. In dev mode, the runtime relay connects\n   * to `ws://127.0.0.1:<port>` so an external `llui-mcp` server can forward\n   * tool calls into the running app.\n   *\n   * When omitted, the plugin checks whether `@llui/mcp` is resolvable from\n   * the Vite project root. If yes → defaults to `5200`. If no → stays\n   * disabled. This means installing `@llui/mcp` (+ starting its server)\n   * Just Works without an explicit config entry. Pass an explicit `false`\n   * to opt out even when `@llui/mcp` is installed; pass a number to use\n   * a non-default port. When enabled but the MCP server isn't running,\n   * the plugin returns 404 from its discovery endpoint and the browser\n   * silently skips the connection — no retry noise.\n   */\n  mcpPort?: number | false\n\n  /**\n   * Treat every compiler diagnostic as a build error.\n   *\n   * Default `false` — diagnostics are emitted via rollup's `this.warn` and\n   * can be ignored. Set to `true` in CI so lint-style regressions (namespace\n   * imports, bitmask overflow, spread-in-children, `.map()` on state, etc.)\n   * fail the build without requiring a custom `build.rollupOptions.onwarn`\n   * handler.\n   */\n  failOnWarning?: boolean\n\n  /**\n   * Silence specific diagnostic rules without disabling the whole lint\n   * pass. Each message is tagged with a rule name (shown in brackets at\n   * the start of every warning, e.g. `[spread-in-children]`). Listing\n   * a rule here drops all diagnostics with that tag before rollup sees\n   * them — so they don't fire via `this.warn` and don't fail the build\n   * even when `failOnWarning` is enabled.\n   *\n   * The valid rule names are enumerated by the `DiagnosticRule` type\n   * re-exported from this module. Unknown rule names are ignored.\n   */\n  disabledWarnings?: readonly DiagnosticRule[]\n\n  /**\n   * Emit `[llui]`-prefixed `console.info` logs for every transformed\n   * component file — state-path bit assignments, mask injections, and\n   * helper compile/bail counts. Useful when diagnosing why a binding\n   * isn't gated the way you expect, or why a call fell back from\n   * template-clone to `elSplit`. Off by default.\n   */\n  verbose?: boolean\n\n  /**\n   * Enables two things together when set:\n   *\n   *   1. Emits schemas + binding descriptors in prod builds so the\n   *      @llui/agent runtime has metadata to advertise over its WS hello\n   *      frame (see agent spec §7.4).\n   *   2. Auto-mounts `@llui/agent/server`'s router at `/agent/*` and its\n   *      WS upgrade handler at `/agent/ws` on the Vite dev server — so\n   *      plain `vite dev` has working agent endpoints with no extra\n   *      server.ts wiring. Requires `@llui/agent` installed; if it isn't,\n   *      the plugin warns and skips dev mounting (prod emission still\n   *      works from Plan 3b).\n   *\n   * Pass `true` for defaults (random signing key per dev session;\n   * `identityResolver` returns `'dev-user'`). Pass an object to customize.\n   * Default `false` — metadata is dev-only, no agent endpoints.\n   */\n  agent?: boolean | AgentPluginConfig\n}\n\nexport type AgentPluginConfig = {\n  /**\n   * HMAC signing key for tokens. ≥32 bytes. Rotation invalidates all\n   * tokens. Falls back to `process.env.AGENT_SIGNING_KEY`, then to a\n   * per-session random key (dev-only).\n   */\n  signingKey?: string\n}\n\n/**\n * Does `@llui/mcp` resolve from `root`'s node_modules? Uses\n * `require.resolve` so monorepo workspaces and hoisted installs both\n * work. Catches failures silently — the only consequence is that we\n * leave `mcpPort` disabled, which is the safe default.\n */\nfunction hasMcpPackage(root: string): boolean {\n  try {\n    const req = createRequire(resolve(root, 'package.json'))\n    req.resolve('@llui/mcp/package.json')\n    return true\n  } catch {\n    return false\n  }\n}\n\n/**\n * Resolve the path to the llui-mcp CLI entry. Reads `bin.llui-mcp`\n * from @llui/mcp's package.json and joins it against the package\n * directory. Returns null if @llui/mcp isn't resolvable.\n */\nfunction resolveMcpCliPath(root: string): string | null {\n  try {\n    const req = createRequire(resolve(root, 'package.json'))\n    const pkgJsonPath = req.resolve('@llui/mcp/package.json')\n    const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf8')) as {\n      bin?: string | Record<string, string>\n    }\n    const binEntry = typeof pkgJson.bin === 'string' ? pkgJson.bin : pkgJson.bin?.['llui-mcp']\n    if (!binEntry) return null\n    return resolve(dirname(pkgJsonPath), binEntry)\n  } catch {\n    return null\n  }\n}\n\ntype AgentServerInstance = {\n  router: (req: Request) => Promise<Response | null>\n  wsUpgrade: (\n    req: import('http').IncomingMessage,\n    socket: import('stream').Duplex,\n    head: Buffer,\n  ) => void\n}\n\n/**\n * Dynamically load @llui/agent/server relative to the app root and\n * construct an agent server instance. Returns null if @llui/agent isn't\n * installed — the plugin degrades to \"prod schema emission only\" mode.\n */\nasync function loadAgentServer(\n  appRoot: string,\n  cfg: AgentPluginConfig,\n): Promise<AgentServerInstance | null> {\n  let serverModule: {\n    createLluiAgentServer: (opts: {\n      signingKey: string\n      identityResolver?: (req: Request) => Promise<string | null>\n    }) => AgentServerInstance\n  }\n  try {\n    // Walk up from the app root to find node_modules/@llui/agent. Works\n    // for both pnpm workspace and regular npm installs. Direct file-system\n    // walk avoids \"exports\" / \"subpath './package.json'\" gymnastics that\n    // require.resolve and Node's module resolver disagree on.\n    const pkgDir = findPackageDir(appRoot, '@llui/agent')\n    if (!pkgDir) throw new Error('not found in any ancestor node_modules')\n    const pkg = JSON.parse(readFileSync(resolve(pkgDir, 'package.json'), 'utf8')) as {\n      exports?: Record<string, { import?: string } | string>\n    }\n    const serverExport = pkg.exports?.['./server']\n    const rel = typeof serverExport === 'string' ? serverExport : serverExport?.import\n    if (!rel) throw new Error('missing ./server export in package.json')\n    const modUrl = new URL(`file://${resolve(pkgDir, rel)}`).href\n    serverModule = (await import(modUrl)) as typeof serverModule\n  } catch (e) {\n    console.warn(\n      '[llui] agent: true is set but `@llui/agent` could not be loaded: ' +\n        (e instanceof Error ? e.message : String(e)),\n    )\n    return null\n  }\n\n  const { randomBytes } = await import('node:crypto')\n  const signingKey: string =\n    cfg.signingKey ?? process.env['AGENT_SIGNING_KEY'] ?? randomBytes(32).toString('base64url')\n\n  return serverModule.createLluiAgentServer({\n    signingKey,\n    identityResolver: async () => 'dev-user',\n  })\n}\n\n/**\n * Register the agent middleware + WS upgrade on the Vite dev server.\n * Must be called synchronously from configureServer so registration\n * happens BEFORE Vite installs its catch-all SPA fallback.\n */\nfunction registerAgentMiddleware(server: ViteDevServer, agent: AgentServerInstance): void {\n  // Connect-style middleware. Vite's middleware chain runs in order, so\n  // synchronous registration during configureServer places us ahead of\n  // Vite's catch-all fallback.\n  server.middlewares.use((req, res, next) => {\n    const url = req.url ?? '/'\n    if (!url.startsWith('/agent/') && url !== '/agent') {\n      next()\n      return\n    }\n    void handleAgentRequest(req, res, agent.router).catch((e) => {\n      console.error('[llui] agent middleware error:', e)\n      next(e)\n    })\n  })\n\n  // WS upgrade: only /agent/ws goes to the agent. Vite's own HMR upgrade\n  // uses a different path and runs as a separate listener on the same\n  // event, so this filter keeps both coexisting.\n  server.httpServer?.on('upgrade', (req, socket, head) => {\n    const url = new URL(req.url ?? '/', 'http://localhost')\n    if (url.pathname === '/agent/ws') {\n      agent.wsUpgrade(req, socket, head)\n    }\n  })\n\n  console.info(\n    '[llui] agent dev endpoints active: POST /agent/mint, WS /agent/ws, LAP /agent/lap/v1/*',\n  )\n}\n\n/**\n * Walk up from `start` looking for `node_modules/<pkgName>`. Returns the\n * absolute path to the package directory, or null if not found.\n */\nfunction findPackageDir(start: string, pkgName: string): string | null {\n  let dir = resolve(start)\n  while (true) {\n    const candidate = resolve(dir, 'node_modules', pkgName)\n    if (existsSync(resolve(candidate, 'package.json'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir) return null\n    dir = parent\n  }\n}\n\n/** Convert a Node http req → Web Request, call router, write the response. */\nasync function handleAgentRequest(\n  req: import('http').IncomingMessage,\n  res: import('http').ServerResponse,\n  router: (req: Request) => Promise<Response | null>,\n): Promise<void> {\n  const method = req.method ?? 'GET'\n  const url = req.url ?? '/'\n  const headers: Record<string, string> = {}\n  for (const [k, v] of Object.entries(req.headers)) {\n    if (v === undefined) continue\n    headers[k] = Array.isArray(v) ? v.join(', ') : v\n  }\n  let body: BodyInit | undefined\n  if (!['GET', 'HEAD'].includes(method)) {\n    const chunks: Buffer[] = []\n    for await (const chunk of req) chunks.push(chunk as Buffer)\n    if (chunks.length > 0) body = new Uint8Array(Buffer.concat(chunks))\n  }\n  const origin = `http://${req.headers.host ?? 'localhost'}`\n  const webReq = new Request(`${origin}${url}`, { method, headers, body })\n  const webRes = await router(webReq)\n  if (!webRes) {\n    res.statusCode = 404\n    res.end()\n    return\n  }\n  res.statusCode = webRes.status\n  webRes.headers.forEach((v, k) => res.setHeader(k, v))\n  const buf = Buffer.from(await webRes.arrayBuffer())\n  res.end(buf)\n}\n\nexport default function llui(options: LluiPluginOptions = {}): Plugin {\n  let devMode = false\n  // `mcpPort` + `mcpMode` are resolved lazily in `configResolved` so we\n  // can check for @llui/mcp in the consuming project's node_modules.\n  //   - `options.mcpPort === false`  → disabled\n  //   - explicit number              → wire-only (user manages the server)\n  //   - undefined + @llui/mcp found  → spawn (plugin starts llui-mcp --http)\n  //   - undefined + no @llui/mcp     → disabled\n  let mcpPort: number | null = null\n  let mcpMode: 'disabled' | 'wire' | 'spawn' = 'disabled'\n  let mcpCliPath: string | null = null\n  let mcpChild: ChildProcess | null = null\n  const failOnWarning = options.failOnWarning === true\n  const disabledWarnings = new Set<string>(options.disabledWarnings ?? [])\n  const verbose = options.verbose === true\n  const agent = options.agent ?? false\n  const agentConfig: AgentPluginConfig = typeof agent === 'object' ? agent : {}\n  // Agent server instance — loaded in configResolved (async), registered\n  // in configureServer (sync). Null until loaded, or if @llui/agent isn't\n  // installed.\n  let agentServer: {\n    router: (req: Request) => Promise<Response | null>\n    wsUpgrade: (\n      req: import('http').IncomingMessage,\n      socket: import('stream').Duplex,\n      head: Buffer,\n    ) => void\n  } | null = null\n\n  // File-based handshake with @llui/mcp. The MCP server writes a marker\n  // file when its bridge starts; we watch it and send a Vite HMR custom\n  // event so the browser can call __lluiConnect() automatically — without\n  // retry spam, regardless of whether MCP or Vite started first.\n  const activeFilePath = resolve(findWorkspaceRoot(), 'node_modules/.cache/llui-mcp/active.json')\n  let mcpWatcher: FSWatcher | null = null\n  let dirWatcher: FSWatcher | null = null\n  // Cached once Vite's HTTP server emits `listening`. `stampDevUrl()`\n  // uses this to write the URL into the marker file — either immediately\n  // (if MCP already started and wrote one) or later when the marker\n  // appears via the directory watcher (MCP-starts-after-Vite path).\n  let cachedDevUrl: string | null = null\n\n  function readMcpMarker(): { port: number; devUrl?: string } | null {\n    try {\n      if (!existsSync(activeFilePath)) return null\n      const data = JSON.parse(readFileSync(activeFilePath, 'utf8')) as {\n        port?: number\n        devUrl?: string\n      }\n      if (typeof data.port !== 'number') return null\n      return { port: data.port, ...(data.devUrl ? { devUrl: data.devUrl } : {}) }\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * Idempotently write `cachedDevUrl` into the marker file. No-op if the\n   * URL hasn't been captured yet (Vite hasn't emitted `listening`) or if\n   * the marker file doesn't exist (MCP hasn't started yet). Covers both\n   * orderings — the listening hook calls this after caching, and the\n   * directory watcher calls it when the marker appears later.\n   */\n  function stampDevUrl(): void {\n    if (cachedDevUrl === null) return\n    if (!existsSync(activeFilePath)) return\n    try {\n      const marker = JSON.parse(readFileSync(activeFilePath, 'utf8')) as Record<string, unknown>\n      if (marker.devUrl === cachedDevUrl) return\n      marker.devUrl = cachedDevUrl\n      writeFileSync(activeFilePath, JSON.stringify(marker))\n    } catch {\n      // Best-effort — failure to update the marker should not crash Vite\n    }\n  }\n\n  function notifyMcpReady(server: ViteDevServer): void {\n    const marker = readMcpMarker()\n    if (marker === null) return\n    server.ws.send({ type: 'custom', event: 'llui:mcp-ready', data: marker })\n  }\n\n  function notifyMcpOffline(server: ViteDevServer): void {\n    server.ws.send({ type: 'custom', event: 'llui:mcp-offline', data: {} })\n  }\n\n  return {\n    name: 'llui',\n    enforce: 'pre',\n\n    async configResolved(config) {\n      devMode = config.command === 'serve' || config.mode === 'development'\n      // Load @llui/agent here (async) so we can register middleware\n      // synchronously in configureServer — which must happen BEFORE Vite\n      // installs its catch-all SPA/fallback middleware.\n      if (agent && devMode) {\n        agentServer = await loadAgentServer(config.root, agentConfig)\n      }\n      if (options.mcpPort === false) {\n        mcpMode = 'disabled'\n        mcpPort = null\n      } else if (typeof options.mcpPort === 'number') {\n        mcpMode = 'wire'\n        mcpPort = options.mcpPort\n      } else if (hasMcpPackage(config.root)) {\n        mcpCliPath = resolveMcpCliPath(config.root)\n        if (mcpCliPath) {\n          mcpMode = 'spawn'\n          mcpPort = 5200\n        } else {\n          mcpMode = 'wire'\n          mcpPort = 5200\n        }\n      } else {\n        mcpMode = 'disabled'\n        mcpPort = null\n      }\n    },\n\n    configureServer(server) {\n      // Agent dev endpoints — runs regardless of mcp state. Must be before\n      // any early-returns below. Registration is synchronous because\n      // agentServer was preloaded in configResolved.\n      if (agentServer) {\n        registerAgentMiddleware(server, agentServer)\n      }\n\n      if (mcpPort === null) {\n        // #3 diagnostic: MCP server is running but the plugin is opted\n        // out. Users in this state usually don't realize the mismatch —\n        // loud-and-early log saves the \"why isn't my MCP attached\" hunt.\n        if (existsSync(activeFilePath)) {\n          console.warn(\n            `[llui] @llui/mcp server is running (marker at ${activeFilePath}) ` +\n              `but the Vite plugin is opted out (mcpPort: false, or @llui/mcp ` +\n              `isn't a dep of this project). Add \\`llui({ mcpPort: 5200 })\\` ` +\n              `to vite.config to wire them up, or remove the marker file and ` +\n              `stop the MCP server if the mismatch was unintended.`,\n          )\n        }\n        return\n      }\n\n      // Spawn mode: plugin launches llui-mcp as a child process so\n      // `pnpm dev` handles the whole stack. Skip spawning when a marker\n      // already exists — something (usually a separate llui-mcp process\n      // started before Vite) is already listening. The existing wire\n      // behavior takes over from there.\n      if (mcpMode === 'spawn' && mcpCliPath !== null && !existsSync(activeFilePath)) {\n        mcpChild = spawn(process.execPath, [mcpCliPath, '--http', String(mcpPort)], {\n          stdio: ['ignore', 'pipe', 'pipe'],\n          env: { ...process.env, LLUI_MCP_PORT: String(mcpPort) },\n        })\n        mcpChild.stdout?.on('data', (buf: Buffer) => {\n          process.stdout.write(`[mcp] ${buf.toString()}`)\n        })\n        mcpChild.stderr?.on('data', (buf: Buffer) => {\n          process.stderr.write(`[mcp] ${buf.toString()}`)\n        })\n        mcpChild.on('exit', (code) => {\n          if (code !== 0 && code !== null) {\n            console.warn(`[llui] @llui/mcp child exited with code ${code}`)\n          }\n          mcpChild = null\n        })\n        const killChild = (): void => {\n          if (mcpChild && !mcpChild.killed) mcpChild.kill('SIGTERM')\n        }\n        server.httpServer?.on('close', killChild)\n        process.once('exit', killChild)\n      }\n\n      // HTTP endpoint: the browser fetches this on load to discover the\n      // current MCP port. Avoids the race where HMR events sent before\n      // the import.meta.hot listener registers get dropped — and lets\n      // the browser connect to the actual port (which may differ from\n      // the compile-time default if MCP was started with LLUI_MCP_PORT).\n      server.middlewares.use('/__llui_mcp_status', (_req, res) => {\n        const marker = readMcpMarker()\n        if (marker === null) {\n          res.statusCode = 404\n          res.end()\n          return\n        }\n        res.statusCode = 200\n        res.setHeader('content-type', 'application/json')\n        res.end(JSON.stringify({ port: marker.port }))\n      })\n\n      // Watch the marker file for create/delete. fs.watch on the parent\n      // directory catches both events; the file itself may not exist\n      // when we start watching.\n      const dir = dirname(activeFilePath)\n      try {\n        // Watch the parent directory for the marker file appearing/disappearing\n        const watchDir = (): void => {\n          if (!existsSync(dir)) return\n          dirWatcher = fsWatch(dir, (_event, filename) => {\n            if (filename !== 'active.json') return\n            if (existsSync(activeFilePath)) {\n              // Stamp BEFORE notifying so the `llui:mcp-ready` payload\n              // carries the cached devUrl. This is the MCP-after-Vite\n              // path: listening already fired and cached the URL; the\n              // marker is only now appearing.\n              stampDevUrl()\n              notifyMcpReady(server)\n            } else {\n              notifyMcpOffline(server)\n            }\n          })\n        }\n        if (existsSync(dir)) {\n          watchDir()\n        } else {\n          // Parent directory doesn't exist yet — poll for it briefly\n          const poll = setInterval(() => {\n            if (existsSync(dir)) {\n              clearInterval(poll)\n              watchDir()\n            }\n          }, 1000)\n          // Clean up the poller if vite shuts down before MCP starts\n          server.httpServer?.on('close', () => clearInterval(poll))\n        }\n      } catch {\n        // fs.watch can fail on some filesystems — degrade silently\n      }\n\n      // Re-send the ready event when a new HMR client connects, in case\n      // the page loads while MCP is already running.\n      server.ws.on('connection', () => {\n        if (existsSync(activeFilePath)) notifyMcpReady(server)\n      })\n\n      server.httpServer?.on('close', () => {\n        mcpWatcher?.close()\n        dirWatcher?.close()\n        mcpWatcher = null\n        dirWatcher = null\n      })\n\n      // Once Vite's HTTP server is listening, cache our dev URL and stamp\n      // it into the marker file. Two orderings are possible:\n      //   (a) MCP started FIRST → marker exists now → stampDevUrl() writes\n      //       it, and we broadcast llui:mcp-ready so the browser picks up\n      //       the devUrl without relying on an incidental fs.watch tick\n      //       (which can miss on NFS/SMB).\n      //   (b) MCP will start LATER → marker doesn't exist yet → stamp is a\n      //       no-op. When MCP eventually writes the marker, the directory\n      //       watcher fires, calls stampDevUrl(), and notifies.\n      server.httpServer?.once('listening', () => {\n        const address = server.httpServer?.address()\n        if (!address || typeof address !== 'object') return\n        const host =\n          address.address === '::' || address.address === '0.0.0.0' ? 'localhost' : address.address\n        cachedDevUrl = `http://${host}:${address.port}`\n        stampDevUrl()\n        // Broadcast after stamping so the payload carries devUrl. Only\n        // fires in case (a) — notifyMcpReady no-ops when the marker is\n        // absent.\n        notifyMcpReady(server)\n      })\n\n      // ── Agent dev endpoints ──────────────────────────────────────\n      // When `agent: true` (or `agent: {...}`), auto-mount /agent/* on\n      // the Vite dev server so `pnpm dev` has working agent endpoints.\n      // Users with a custom server.ts (SSR apps) mount createLluiAgentServer\n      // themselves — configureServer also fires in middleware mode, but\n      // there server.httpServer is null so the upgrade hook is a no-op.\n    },\n\n    transform(code, id, options) {\n      if (!id.endsWith('.ts') && !id.endsWith('.tsx')) return\n\n      // `'use client'` directive — SSR builds replace the module with a\n      // stub so top-level imports and side effects never run on the\n      // server. Client builds pass through to the normal transform; the\n      // directive is effectively a no-op on the client.\n      if (options?.ssr && hasUseClientDirective(code)) {\n        const result = transformUseClientSsr(code, id)\n        if (result) {\n          const cwd = process.cwd()\n          const rel = relative(cwd, id)\n          const display = rel.startsWith('..') ? id : rel\n          for (const warning of result.warnings) {\n            this.warn(`${display}: ${warning}`)\n          }\n          return { code: result.output, map: { mappings: '' } }\n        }\n      }\n\n      const diagnostics = diagnose(code)\n      if (diagnostics.length > 0) {\n        // Prefix every diagnostic with `<file>:<line>:<col>` plus the\n        // `[rule-name]` tag so consumers logging `warning.message` in a\n        // custom onwarn handler see both the location and the rule they\n        // could silence via `disabledWarnings`.\n        const cwd = process.cwd()\n        const rel = relative(cwd, id)\n        const display = rel.startsWith('..') ? id : rel\n        for (const d of diagnostics) {\n          if (disabledWarnings.has(d.rule)) continue\n          const message = `${display}:${d.line}:${d.column}: [${d.rule}] ${d.message}`\n          if (failOnWarning) {\n            this.error({ message, loc: { line: d.line, column: d.column, file: id } })\n          } else {\n            this.warn(message, { line: d.line, column: d.column })\n          }\n        }\n      }\n\n      const result = transformLlui(code, id, devMode, Boolean(agent), mcpPort, verbose)\n      if (!result) return undefined\n\n      // Apply per-statement edits via MagicString for accurate source maps.\n      // Untouched statements keep their original positions.\n      const s = new MagicString(code)\n      for (const edit of result.edits) {\n        if (edit.start === edit.end) {\n          // Insert at position — appendRight for middle, append for end-of-file\n          if (edit.start === code.length) s.append(edit.replacement)\n          else s.appendRight(edit.start, edit.replacement)\n        } else {\n          s.overwrite(edit.start, edit.end, edit.replacement)\n        }\n      }\n\n      return {\n        code: s.toString(),\n        map: s.generateMap({ source: id, includeContent: true, hires: true }),\n      }\n    },\n  }\n}\n"]}

package/dist/msg-annotations.d.ts

@@ -0,0 +1,23 @@
+export type MessageAnnotations = {
+    intent: string | null;
+    alwaysAffordable: boolean;
+    requiresConfirm: boolean;
+    humanOnly: boolean;
+};
+/**
+ * Walk a Msg-like discriminated-union type alias and extract JSDoc
+ * annotations attached to each union member. Returns null if no
+ * recognizable union is found so callers can skip emission cleanly.
+ *
+ * Expected JSDoc grammar (order-independent):
+ *   @intent("human readable")
+ *   @alwaysAffordable
+ *   @requiresConfirm
+ *   @humanOnly
+ *
+ * Unknown tags are ignored; malformed @intent (no quoted string) is
+ * treated as "no intent". The four flags are booleans; any occurrence
+ * of the tag sets it true.
+ */
+export declare function extractMsgAnnotations(source: string): Record<string, MessageAnnotations> | null;
+//# sourceMappingURL=msg-annotations.d.ts.map

package/dist/msg-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-annotations.d.ts","sourceRoot":"","sources":["../src/msg-annotations.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,gBAAgB,EAAE,OAAO,CAAA;IACzB,eAAe,EAAE,OAAO,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;CACnB,CAAA;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,IAAI,CA2B/F"}