@llui/dom 0.0.11 → 0.0.14

package/dist/addressed.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentDef } from './types';
+import type { ComponentDef } from './types.js';
 export interface AddressedEffect {
     __addressed: true;
     __targetKey: string | number;

package/dist/addressed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addressed.d.ts","sourceRoot":"","sources":["../src/addressed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,IAAI,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,KAAK,EAAE,OAAO,CAAA;CACf;AAKD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG,IAAI,CAEhG;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAYD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,eAAe,CAM5E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GAAG,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,eAAe,CAAC,CAavD"}
+{"version":3,"file":"addressed.d.ts","sourceRoot":"","sources":["../src/addressed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,IAAI,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,KAAK,EAAE,OAAO,CAAA;CACf;AAKD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG,IAAI,CAEhG;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAYD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,eAAe,CAM5E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GAAG,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,eAAe,CAAC,CAavD"}

package/dist/addressed.js

@@ -1,4 +1,4 @@
-import { setAddressedDispatcher } from './update-loop';
+import { setAddressedDispatcher } from './update-loop.js';
 // Global component registry — keyed by child key
 const registry = new Map();
 export function registerChild(key, inst) {

package/dist/addressed.js.map

@@ -1 +1 @@
-{"version":3,"file":"addressed.js","sourceRoot":"","sources":["../src/addressed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAQtD,iDAAiD;AACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqD,CAAA;AAE7E,MAAM,UAAU,aAAa,CAAC,GAAoB,EAAE,IAAsC;IACxF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAoB;IAClD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AACtB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAwD;IACjF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,sBAAsB,CAAC,iBAAiB,CAAC,CAAA;AAEzC,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACd,MAA0B,CAAC,WAAW,KAAK,IAAI,CACjD,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,GAA0B,EAC1B,GAAoB;IAEpB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAA;IAC7B,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IAExB,MAAM,OAAO,GAA0D,EAAE,CAAA;IACzE,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAgB,EAAE,EAAE,CAAC,CAAC;YACrC,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;SACvB,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"addressed.js","sourceRoot":"","sources":["../src/addressed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAQzD,iDAAiD;AACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqD,CAAA;AAE7E,MAAM,UAAU,aAAa,CAAC,GAAoB,EAAE,IAAsC;IACxF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAoB;IAClD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;AACtB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAwD;IACjF,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAC/C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,sBAAsB,CAAC,iBAAiB,CAAC,CAAA;AAEzC,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACd,MAA0B,CAAC,WAAW,KAAK,IAAI,CACjD,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,GAA0B,EAC1B,GAAoB;IAEpB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAA;IAC7B,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAA;IAExB,MAAM,OAAO,GAA0D,EAAE,CAAA;IACzE,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAgB,EAAE,EAAE,CAAC,CAAC;YACrC,WAAW,EAAE,IAAI;YACjB,WAAW,EAAE,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;SACvB,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["import type { ComponentDef } from './types.js'\nimport { setAddressedDispatcher } from './update-loop.js'\n\nexport interface AddressedEffect {\n  __addressed: true\n  __targetKey: string | number\n  __msg: unknown\n}\n\n// Global component registry — keyed by child key\nconst registry = new Map<string | number, { send: (msg: unknown) => void }>()\n\nexport function registerChild(key: string | number, inst: { send: (msg: unknown) => void }): void {\n  registry.set(key, inst)\n}\n\nexport function unregisterChild(key: string | number): void {\n  registry.delete(key)\n}\n\nfunction dispatchAddressed(effect: { __targetKey: string | number; __msg: unknown }): void {\n  const target = registry.get(effect.__targetKey)\n  if (target) {\n    target.send(effect.__msg)\n  }\n}\n\n// Register the dispatcher — this runs when addressed.ts is first imported\nsetAddressedDispatcher(dispatchAddressed)\n\nexport function isAddressedEffect(effect: unknown): effect is AddressedEffect {\n  return (\n    typeof effect === 'object' &&\n    effect !== null &&\n    (effect as AddressedEffect).__addressed === true\n  )\n}\n\n/**\n * Build a typed address builder from a component definition's `receives` map.\n */\nexport function addressOf<S, M, E>(\n  def: ComponentDef<S, M, E>,\n  key: string | number,\n): Record<string, (params?: unknown) => AddressedEffect> {\n  const receives = def.receives\n  if (!receives) return {}\n\n  const builder: Record<string, (params?: unknown) => AddressedEffect> = {}\n  for (const [name, handler] of Object.entries(receives)) {\n    builder[name] = (params?: unknown) => ({\n      __addressed: true,\n      __targetKey: key,\n      __msg: handler(params),\n    })\n  }\n  return builder\n}\n"]}

package/dist/binding.d.ts

@@ -1,4 +1,4 @@
-import type { Scope, Binding, BindingKind } from './types';
+import type { Scope, Binding, BindingKind } from './types.js';
 export interface CreateBindingOpts {
     mask: number;
     accessor: (state: never) => unknown;

package/dist/binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACnC,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAID,wBAAgB,eAAe,IAAI,OAAO,EAAE,GAAG,IAAI,CAElD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAiB5E;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,KAAK,EAAE,OAAO,GACb,IAAI,CAwCN"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACnC,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,IAAI,CAAA;IACV,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CACjB;AAID,wBAAgB,eAAe,IAAI,OAAO,EAAE,GAAG,IAAI,CAElD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAiB5E;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,KAAK,EAAE,OAAO,GACb,IAAI,CAyDN"}

package/dist/binding.js

@@ -1,4 +1,4 @@
-import { addBinding } from './scope';
+import { addBinding } from './scope.js';
 let flatBindings = null;
 export function getFlatBindings() {
     return flatBindings;
@@ -24,6 +24,20 @@ export function createBinding(scope, opts) {
     return binding;
 }
 export function applyBinding(target, value) {
+    // Defensive guard: if a reactive accessor leaks through as a raw
+    // function value, emitting its `.toString()` into the DOM (e.g. as
+    // an attribute) would be a silent correctness bug that only surfaces
+    // on server-rendered pages. Throw loudly so the callsite is obvious.
+    // Event handlers (onXxx → 'prop' kind) are NOT handled here; events
+    // are registered via addEventListener in the element helpers, not
+    // via applyBinding.
+    if (typeof value === 'function') {
+        throw new TypeError(`[LLui] applyBinding(${target.kind}${target.key ? `, '${target.key}'` : ''}) received ` +
+            `a function as its value. This means an accessor wasn't invoked before ` +
+            `reaching the binding layer — usually a bug in a compiled binding tuple or ` +
+            `in a helper that forwards props without calling them. The arrow's source ` +
+            `would have been serialized into the DOM otherwise. Offender: ${value.toString().slice(0, 120)}`);
+    }
     switch (target.kind) {
         case 'text':
             target.node.nodeValue = String(value);

package/dist/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAWpC,IAAI,YAAY,GAAqB,IAAI,CAAA;AAEzC,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAqB;IACnD,YAAY,GAAG,GAAG,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,IAAuB;IACjE,MAAM,OAAO,GAAY;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAuC;QACtD,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,KAAK;KACZ,CAAA;IAED,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC1B,IAAI,YAAY;QAAE,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAE5C,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAuD,EACvD,KAAc;IAEd,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,MAAM,CAAC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;YACrC,MAAK;QAEP,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,GAAG,MAAM,CAAC,IAAmB,CAEpC;YAAC,EAAU,CAAC,MAAM,CAAC,GAAI,CAAC,GAAG,KAAK,CAAA;YACjC,MAAK;QACP,CAAC;QAED,KAAK,MAAM;YACT,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC,IAAgB,CAAC,eAAe,CAAC,MAAM,CAAC,GAAI,CAAC,CAAA;YACxD,CAAC;iBAAM,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC3B,4DAA4D;gBAC5D,IAAI,MAAM,CAAC,GAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACpC,CAAC;oBAAC,MAAM,CAAC,IAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,GAAI,EAAE,OAAO,CAAC,CAAA;gBAC9D,CAAC;qBAAM,CAAC;oBACN,CAAC;oBAAC,MAAM,CAAC,IAAgB,CAAC,eAAe,CAAC,MAAM,CAAC,GAAI,CAAC,CAAA;gBACxD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,CAAC;gBAAC,MAAM,CAAC,IAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,GAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACpE,CAAC;YACD,MAAK;QAEP,KAAK,OAAO;YACV,CAAC;YAAC,MAAM,CAAC,IAAgB,CAAC,YAAY,CAAC,OAAO,EAAE,KAAe,CAAC,CAAA;YAChE,MAAK;QAEP,KAAK,OAAO;YACV,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBAClB,CAAC;gBAAC,MAAM,CAAC,IAAoB,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,GAAI,CAAC,CAAA;YACjE,CAAC;iBAAM,CAAC;gBACN,CAAC;gBAAC,MAAM,CAAC,IAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,GAAI,EAAE,KAAe,CAAC,CAAA;YAC/E,CAAC;YACD,MAAK;IACT,CAAC;AACH,CAAC"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../src/binding.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Scope, Binding, BindingKind } from './types.js'\nimport { addBinding } from './scope.js'\n\nexport interface CreateBindingOpts {\n  mask: number\n  accessor: (state: never) => unknown\n  kind: BindingKind\n  node: Node\n  key?: string\n  perItem: boolean\n}\n\nlet flatBindings: Binding[] | null = null\n\nexport function getFlatBindings(): Binding[] | null {\n  return flatBindings\n}\n\nexport function setFlatBindings(arr: Binding[] | null): void {\n  flatBindings = arr\n}\n\nexport function createBinding(scope: Scope, opts: CreateBindingOpts): Binding {\n  const binding: Binding = {\n    mask: opts.mask,\n    accessor: opts.accessor as (state: unknown) => unknown,\n    lastValue: undefined,\n    kind: opts.kind,\n    node: opts.node,\n    key: opts.key,\n    ownerScope: scope,\n    perItem: opts.perItem,\n    dead: false,\n  }\n\n  addBinding(scope, binding)\n  if (flatBindings) flatBindings.push(binding)\n\n  return binding\n}\n\nexport function applyBinding(\n  target: { kind: BindingKind; node: Node; key?: string },\n  value: unknown,\n): void {\n  // Defensive guard: if a reactive accessor leaks through as a raw\n  // function value, emitting its `.toString()` into the DOM (e.g. as\n  // an attribute) would be a silent correctness bug that only surfaces\n  // on server-rendered pages. Throw loudly so the callsite is obvious.\n  // Event handlers (onXxx → 'prop' kind) are NOT handled here; events\n  // are registered via addEventListener in the element helpers, not\n  // via applyBinding.\n  if (typeof value === 'function') {\n    throw new TypeError(\n      `[LLui] applyBinding(${target.kind}${target.key ? `, '${target.key}'` : ''}) received ` +\n        `a function as its value. This means an accessor wasn't invoked before ` +\n        `reaching the binding layer — usually a bug in a compiled binding tuple or ` +\n        `in a helper that forwards props without calling them. The arrow's source ` +\n        `would have been serialized into the DOM otherwise. Offender: ${value.toString().slice(0, 120)}`,\n    )\n  }\n\n  switch (target.kind) {\n    case 'text':\n      target.node.nodeValue = String(value)\n      break\n\n    case 'prop': {\n      const el = target.node as HTMLElement\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(el as any)[target.key!] = value\n      break\n    }\n\n    case 'attr':\n      if (value == null) {\n        ;(target.node as Element).removeAttribute(target.key!)\n      } else if (value === false) {\n        // ARIA attributes need explicit \"false\"; others are removed\n        if (target.key!.startsWith('aria-')) {\n          ;(target.node as Element).setAttribute(target.key!, 'false')\n        } else {\n          ;(target.node as Element).removeAttribute(target.key!)\n        }\n      } else {\n        ;(target.node as Element).setAttribute(target.key!, String(value))\n      }\n      break\n\n    case 'class':\n      ;(target.node as Element).setAttribute('class', value as string)\n      break\n\n    case 'style':\n      if (value == null) {\n        ;(target.node as HTMLElement).style.removeProperty(target.key!)\n      } else {\n        ;(target.node as HTMLElement).style.setProperty(target.key!, value as string)\n      }\n      break\n  }\n}\n"]}

package/dist/component.d.ts

@@ -1,3 +1,3 @@
-import type { ComponentDef } from './types';
+import type { ComponentDef } from './types.js';
 export declare function component<S, M, E = never, D = void>(def: ComponentDef<S, M, E, D>): ComponentDef<S, M, E, D>;
 //# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,EACjD,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC5B,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAE1B"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,EACjD,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC5B,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAE1B"}

package/dist/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CACvB,GAA6B;IAE7B,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CACvB,GAA6B;IAE7B,OAAO,GAAG,CAAA;AACZ,CAAC","sourcesContent":["import type { ComponentDef } from './types.js'\n\nexport function component<S, M, E = never, D = void>(\n  def: ComponentDef<S, M, E, D>,\n): ComponentDef<S, M, E, D> {\n  return def\n}\n"]}

package/dist/compose.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Type-level utilities + runtime helper for composing multiple child
+ * component modules into a parent's State and Msg types.
+ *
+ * Eliminates the manual State/Msg union declarations for each embedded
+ * sub-component. The developer declares the children map once, and
+ * `ChildState` / `ChildMsg` derive the wrapper types.
+ *
+ * ```ts
+ * import type { ChildState, ChildMsg } from '@llui/dom'
+ * import { childHandlers } from '@llui/dom'
+ * import { dialog } from '@llui/components/dialog'
+ * import { sortable } from '@llui/components/sortable'
+ *
+ * const children = { dialog, sort: sortable } as const
+ *
+ * type State = ChildState<typeof children> & { items: string[] }
+ * type Msg = ChildMsg<typeof children> | { type: 'addItem'; text: string }
+ *
+ * const update = mergeHandlers<State, Msg, never>(
+ *   childHandlers(children),
+ *   appUpdate,
+ * )
+ * ```
+ */
+/**
+ * Extract the state type from a component module's update function.
+ * Works with both property and method syntax.
+ */
+export type ModuleState<T> = T extends {
+    update: (state: infer S, msg: infer _M) => [infer _S2, infer _E];
+} ? S : never;
+/**
+ * Extract the message type from a component module's update function.
+ */
+export type ModuleMsg<T> = T extends {
+    update: (state: infer _S, msg: infer M) => [infer _S2, infer _E];
+} ? M : never;
+/**
+ * Given a record of component modules, derive the combined child state.
+ * Each key maps to its module's state type.
+ *
+ * ```ts
+ * const children = { dialog, sort: sortable } as const
+ * type CS = ChildState<typeof children>
+ * // → { dialog: DialogState; sort: SortableState }
+ * ```
+ */
+export type ChildState<T extends Record<string, unknown>> = {
+    [K in keyof T]: ModuleState<T[K]>;
+};
+/**
+ * Given a record of component modules, derive the combined child message
+ * union. Each module's messages are wrapped in `{ type: key; msg: SubMsg }`.
+ *
+ * ```ts
+ * const children = { dialog, sort: sortable } as const
+ * type CM = ChildMsg<typeof children>
+ * // → { type: 'dialog'; msg: DialogMsg } | { type: 'sort'; msg: SortableMsg }
+ * ```
+ */
+export type ChildMsg<T extends Record<string, unknown>> = {
+    [K in keyof T]: {
+        type: K;
+        msg: ModuleMsg<T[K]>;
+    };
+}[keyof T];
+/**
+ * Create a merged handler from a map of component modules. Each module's
+ * update is wired via `sliceHandler(key, module.update)` convention:
+ * state[key] holds the sub-state, messages match `{ type: key; msg: SubMsg }`.
+ *
+ * Returns a handler compatible with `mergeHandlers`.
+ */
+export declare function childHandlers<S, M, E>(modules: Record<string, {
+    update: (state: never, msg: never) => [unknown, unknown[]];
+}>): (state: S, msg: M) => [S, E[]] | null;
+//# sourceMappingURL=compose.d.ts.map

package/dist/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IACrC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;CACjE,GACG,CAAC,GACD,KAAK,CAAA;AAET;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;CACjE,GACG,CAAC,GACD,KAAK,CAAA;AAET;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACzD,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;KACvD,CAAC,IAAI,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;CAClD,CAAC,MAAM,CAAC,CAAC,CAAA;AAEV;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,GACtF,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAWvC"}

package/dist/compose.js

@@ -0,0 +1,47 @@
+/**
+ * Type-level utilities + runtime helper for composing multiple child
+ * component modules into a parent's State and Msg types.
+ *
+ * Eliminates the manual State/Msg union declarations for each embedded
+ * sub-component. The developer declares the children map once, and
+ * `ChildState` / `ChildMsg` derive the wrapper types.
+ *
+ * ```ts
+ * import type { ChildState, ChildMsg } from '@llui/dom'
+ * import { childHandlers } from '@llui/dom'
+ * import { dialog } from '@llui/components/dialog'
+ * import { sortable } from '@llui/components/sortable'
+ *
+ * const children = { dialog, sort: sortable } as const
+ *
+ * type State = ChildState<typeof children> & { items: string[] }
+ * type Msg = ChildMsg<typeof children> | { type: 'addItem'; text: string }
+ *
+ * const update = mergeHandlers<State, Msg, never>(
+ *   childHandlers(children),
+ *   appUpdate,
+ * )
+ * ```
+ */
+/**
+ * Create a merged handler from a map of component modules. Each module's
+ * update is wired via `sliceHandler(key, module.update)` convention:
+ * state[key] holds the sub-state, messages match `{ type: key; msg: SubMsg }`.
+ *
+ * Returns a handler compatible with `mergeHandlers`.
+ */
+export function childHandlers(modules) {
+    const keys = Object.keys(modules);
+    return (state, msg) => {
+        const m = msg;
+        if (!m.type || !('msg' in m))
+            return null;
+        if (!keys.includes(m.type))
+            return null;
+        const mod = modules[m.type];
+        const slice = state[m.type];
+        const [nextSlice, effects] = mod.update(slice, m.msg);
+        return [{ ...state, [m.type]: nextSlice }, effects];
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAiDH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAuF;IAEvF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACjC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,CAAC,GAAG,GAAsC,CAAA;QAChD,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAA;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QACvC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAE,CAAA;QAC5B,MAAM,KAAK,GAAI,KAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACxD,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAc,EAAE,CAAC,CAAC,GAAY,CAAC,CAAA;QACvE,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAO,EAAE,OAAc,CAAC,CAAA;IACjE,CAAC,CAAA;AACH,CAAC","sourcesContent":["/**\n * Type-level utilities + runtime helper for composing multiple child\n * component modules into a parent's State and Msg types.\n *\n * Eliminates the manual State/Msg union declarations for each embedded\n * sub-component. The developer declares the children map once, and\n * `ChildState` / `ChildMsg` derive the wrapper types.\n *\n * ```ts\n * import type { ChildState, ChildMsg } from '@llui/dom'\n * import { childHandlers } from '@llui/dom'\n * import { dialog } from '@llui/components/dialog'\n * import { sortable } from '@llui/components/sortable'\n *\n * const children = { dialog, sort: sortable } as const\n *\n * type State = ChildState<typeof children> & { items: string[] }\n * type Msg = ChildMsg<typeof children> | { type: 'addItem'; text: string }\n *\n * const update = mergeHandlers<State, Msg, never>(\n *   childHandlers(children),\n *   appUpdate,\n * )\n * ```\n */\n\n/**\n * Extract the state type from a component module's update function.\n * Works with both property and method syntax.\n */\nexport type ModuleState<T> = T extends {\n  update: (state: infer S, msg: infer _M) => [infer _S2, infer _E]\n}\n  ? S\n  : never\n\n/**\n * Extract the message type from a component module's update function.\n */\nexport type ModuleMsg<T> = T extends {\n  update: (state: infer _S, msg: infer M) => [infer _S2, infer _E]\n}\n  ? M\n  : never\n\n/**\n * Given a record of component modules, derive the combined child state.\n * Each key maps to its module's state type.\n *\n * ```ts\n * const children = { dialog, sort: sortable } as const\n * type CS = ChildState<typeof children>\n * // → { dialog: DialogState; sort: SortableState }\n * ```\n */\nexport type ChildState<T extends Record<string, unknown>> = {\n  [K in keyof T]: ModuleState<T[K]>\n}\n\n/**\n * Given a record of component modules, derive the combined child message\n * union. Each module's messages are wrapped in `{ type: key; msg: SubMsg }`.\n *\n * ```ts\n * const children = { dialog, sort: sortable } as const\n * type CM = ChildMsg<typeof children>\n * // → { type: 'dialog'; msg: DialogMsg } | { type: 'sort'; msg: SortableMsg }\n * ```\n */\nexport type ChildMsg<T extends Record<string, unknown>> = {\n  [K in keyof T]: { type: K; msg: ModuleMsg<T[K]> }\n}[keyof T]\n\n/**\n * Create a merged handler from a map of component modules. Each module's\n * update is wired via `sliceHandler(key, module.update)` convention:\n * state[key] holds the sub-state, messages match `{ type: key; msg: SubMsg }`.\n *\n * Returns a handler compatible with `mergeHandlers`.\n */\nexport function childHandlers<S, M, E>(\n  modules: Record<string, { update: (state: never, msg: never) => [unknown, unknown[]] }>,\n): (state: S, msg: M) => [S, E[]] | null {\n  const keys = Object.keys(modules)\n  return (state, msg) => {\n    const m = msg as { type: string; msg?: unknown }\n    if (!m.type || !('msg' in m)) return null\n    if (!keys.includes(m.type)) return null\n    const mod = modules[m.type]!\n    const slice = (state as Record<string, unknown>)[m.type]\n    const [nextSlice, effects] = mod.update(slice as never, m.msg as never)\n    return [{ ...state, [m.type]: nextSlice } as S, effects as E[]]\n  }\n}\n"]}

package/dist/devtools.d.ts

@@ -6,9 +6,25 @@
  */
 export declare function enableDevTools(): void;
 /**
- * Connect to a local MCP server's WebSocket and forward tool calls to
- * `window.__lluiDebug`. Auto-reconnects on close. Safe to call multiple times
- * (only the first call actually runs).
+ * Register the MCP relay for this page.
+ *
+ * Discovery happens in two phases:
+ *
+ * 1. **Status endpoint** (preferred): fetches `/__llui_mcp_status`,
+ *    which the Vite plugin serves from the active marker file written
+ *    by `@llui/mcp`. If the MCP server is running, the response gives
+ *    us the actual port — we connect immediately. This avoids the race
+ *    where HMR events fire before the listener registers, and handles
+ *    cases where MCP runs on a non-default port.
+ * 2. **Compile-time fallback**: if the status endpoint is unavailable
+ *    (404, network error, non-Vite environment), we attempt a single
+ *    connection to the compiled-in `port` parameter as a best-effort.
+ *
+ * Either way: no retry loop. If both fail, `window.__lluiConnect(port?)`
+ * is exposed so the developer can connect manually from the console
+ * when the MCP server starts. The Vite plugin also dispatches an
+ * `llui:mcp-ready` HMR custom event when the marker file appears later,
+ * which the compiler-injected dev code forwards to `__lluiConnect`.
  */
 export declare function startRelay(port?: number): void;
 export interface MessageRecord {

package/dist/devtools.d.ts.map

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

package/dist/devtools.js

@@ -1,5 +1,5 @@
-import { flushInstance, _forceState } from './update-loop';
-import { _setDevToolsInstall } from './mount';
+import { flushInstance, _forceState } from './update-loop.js';
+import { _setDevToolsInstall } from './mount.js';
 /**
  * Enable devtools auto-installation for every mountApp call. Called by
  * compiler-generated dev code — never imported in production builds.
@@ -12,86 +12,143 @@ export function enableDevTools() {
 // ── MCP WebSocket Relay ─────────────────────────────────────────────
 // Forwards method calls from an out-of-process MCP server to the
 // current __lluiDebug API. Dev-mode only — compiler injects startRelay(port).
-let relayStarted = false;
+//
+// On-demand: tries a SINGLE connection on page load. If it succeeds
+// (MCP server is already running), the relay stays open and reconnects
+// on drop. If it fails, no retry loop — just registers
+// `window.__lluiConnect(port?)` so the developer can connect later
+// from the console or when the MCP server starts.
+let relayPort = 5200;
+let relayConnected = false;
+function handleMessage(ws, event) {
+    let req;
+    try {
+        req = JSON.parse(String(event.data));
+    }
+    catch {
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const g = globalThis;
+    if (req.method === '__listComponents') {
+        const keys = g.__lluiComponents ? Object.keys(g.__lluiComponents) : [];
+        const active = g.__lluiDebug && g.__lluiComponents
+            ? (Object.entries(g.__lluiComponents).find(([, v]) => v === g.__lluiDebug)?.[0] ?? null)
+            : null;
+        ws.send(JSON.stringify({ id: req.id, result: { components: keys, active } }));
+        return;
+    }
+    if (req.method === '__selectComponent') {
+        const key = req.args?.[0] ?? '';
+        const entry = g.__lluiComponents?.[key];
+        if (!entry) {
+            ws.send(JSON.stringify({ id: req.id, error: `unknown component: ${key}` }));
+            return;
+        }
+        g.__lluiDebug = entry;
+        ws.send(JSON.stringify({ id: req.id, result: { active: key } }));
+        return;
+    }
+    const api = g.__lluiDebug;
+    if (!api) {
+        ws.send(JSON.stringify({ id: req.id, error: '__lluiDebug not available' }));
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const fn = api[req.method];
+    if (typeof fn !== 'function') {
+        ws.send(JSON.stringify({ id: req.id, error: `unknown method: ${req.method}` }));
+        return;
+    }
+    try {
+        const result = fn.apply(api, req.args ?? []);
+        ws.send(JSON.stringify({ id: req.id, result: result ?? null }));
+    }
+    catch (e) {
+        ws.send(JSON.stringify({ id: req.id, error: e instanceof Error ? e.message : String(e) }));
+    }
+}
+function connectRelay(port, isInitial) {
+    if (typeof WebSocket === 'undefined')
+        return;
+    let ws;
+    try {
+        ws = new WebSocket(`ws://127.0.0.1:${port}`);
+    }
+    catch {
+        if (!isInitial)
+            console.warn(`[LLui MCP] failed to connect to ws://127.0.0.1:${port}`);
+        return;
+    }
+    ws.onopen = () => {
+        relayConnected = true;
+        console.log(`[LLui MCP] connected to ws://127.0.0.1:${port}`);
+    };
+    ws.onmessage = (event) => handleMessage(ws, event);
+    ws.onclose = () => {
+        if (relayConnected) {
+            relayConnected = false;
+            console.log('[LLui MCP] disconnected — call __lluiConnect() to reconnect');
+        }
+    };
+    ws.onerror = () => {
+        // onclose fires after onerror — nothing to do here
+    };
+}
 /**
- * Connect to a local MCP server's WebSocket and forward tool calls to
- * `window.__lluiDebug`. Auto-reconnects on close. Safe to call multiple times
- * (only the first call actually runs).
+ * Register the MCP relay for this page.
+ *
+ * Discovery happens in two phases:
+ *
+ * 1. **Status endpoint** (preferred): fetches `/__llui_mcp_status`,
+ *    which the Vite plugin serves from the active marker file written
+ *    by `@llui/mcp`. If the MCP server is running, the response gives
+ *    us the actual port — we connect immediately. This avoids the race
+ *    where HMR events fire before the listener registers, and handles
+ *    cases where MCP runs on a non-default port.
+ * 2. **Compile-time fallback**: if the status endpoint is unavailable
+ *    (404, network error, non-Vite environment), we attempt a single
+ *    connection to the compiled-in `port` parameter as a best-effort.
+ *
+ * Either way: no retry loop. If both fail, `window.__lluiConnect(port?)`
+ * is exposed so the developer can connect manually from the console
+ * when the MCP server starts. The Vite plugin also dispatches an
+ * `llui:mcp-ready` HMR custom event when the marker file appears later,
+ * which the compiler-injected dev code forwards to `__lluiConnect`.
  */
 export function startRelay(port = 5200) {
-    if (relayStarted)
-        return;
-    relayStarted = true;
+    relayPort = port;
     if (typeof WebSocket === 'undefined')
         return;
-    function connect() {
-        let ws;
-        try {
-            ws = new WebSocket(`ws://127.0.0.1:${port}`);
-        }
-        catch {
-            // Unable to open — retry later
-            setTimeout(connect, 3000);
-            return;
-        }
-        ws.onmessage = (event) => {
-            let req;
-            try {
-                req = JSON.parse(String(event.data));
-            }
-            catch {
-                return;
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const g = globalThis;
-            // Registry introspection methods work even when __lluiDebug isn't set
-            if (req.method === '__listComponents') {
-                const keys = g.__lluiComponents ? Object.keys(g.__lluiComponents) : [];
-                const active = g.__lluiDebug && g.__lluiComponents
-                    ? (Object.entries(g.__lluiComponents).find(([, v]) => v === g.__lluiDebug)?.[0] ?? null)
-                    : null;
-                ws.send(JSON.stringify({ id: req.id, result: { components: keys, active } }));
-                return;
-            }
-            if (req.method === '__selectComponent') {
-                const key = req.args?.[0] ?? '';
-                const entry = g.__lluiComponents?.[key];
-                if (!entry) {
-                    ws.send(JSON.stringify({ id: req.id, error: `unknown component: ${key}` }));
-                    return;
-                }
-                g.__lluiDebug = entry;
-                ws.send(JSON.stringify({ id: req.id, result: { active: key } }));
-                return;
-            }
-            const api = g.__lluiDebug;
-            if (!api) {
-                ws.send(JSON.stringify({ id: req.id, error: '__lluiDebug not available' }));
-                return;
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const fn = api[req.method];
-            if (typeof fn !== 'function') {
-                ws.send(JSON.stringify({ id: req.id, error: `unknown method: ${req.method}` }));
-                return;
-            }
-            try {
-                const result = fn.apply(api, req.args ?? []);
-                ws.send(JSON.stringify({ id: req.id, result: result ?? null }));
+    // Expose manual connect for on-demand use
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const g = globalThis;
+    g.__lluiConnect = (p) => {
+        connectRelay(p ?? relayPort, false);
+    };
+    // Try the Vite middleware first (knows the actual port from the marker file)
+    if (typeof fetch !== 'undefined') {
+        fetch('/__llui_mcp_status')
+            .then((res) => (res.ok ? res.json() : null))
+            .then((data) => {
+            if (data && typeof data.port === 'number') {
+                relayPort = data.port;
+                connectRelay(data.port, true);
             }
-            catch (e) {
-                ws.send(JSON.stringify({ id: req.id, error: e instanceof Error ? e.message : String(e) }));
+            else {
+                // Endpoint replied 404 — MCP not running. Don't fall back to the
+                // compile-time port; the HMR event will fire if MCP starts later.
             }
-        };
-        ws.onclose = () => {
-            // Retry until the MCP server is up
-            setTimeout(connect, 2000);
-        };
-        ws.onerror = () => {
-            // onclose will fire and handle retry
-        };
+        })
+            .catch(() => {
+            // Network error or non-Vite environment — fall back to compile-time port
+            connectRelay(port, true);
+        });
+    }
+    else {
+        // No fetch available — use the compile-time port directly
+        connectRelay(port, true);
     }
-    connect();
 }
 const MAX_HISTORY = 1000;
 export function installDevTools(inst) {