micra.js 2.2.0 → 2.3.0

package/CHANGELOG.md

@@ -4,6 +4,94 @@ All notable changes to Micra.js will be documented in this file. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning follows
 [SemVer](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.0] — 2026-05-30
+
+### TypeScript — type-safe event bus
+
+- **New augmentable `MicraEvents` interface.** Declare your app's events
+  once and `Micra.emit` / `Micra.on` / `this.emit` / `this.on` enforce
+  payload types and arity at the call site:
+
+  ```ts
+  declare module 'micra.js' {
+    interface MicraEvents {
+      'cart:updated': { count: number }
+      'modal:close':  void
+    }
+  }
+
+  Micra.emit('cart:updated', { count: 3 })   // ✓
+  Micra.emit('cart:updated', { count: '3' }) // ✗ type error
+  Micra.emit('modal:close')                  // ✓ void → no args
+  ```
+
+- Events that are NOT declared in `MicraEvents` keep the previous
+  behaviour — payload typed as `unknown`, optional argument. Untyped
+  code keeps compiling unchanged.
+- New exported types: `MicraEvents`, `EventPayload<K>`, `EmitArgs<K>`.
+- Bundle stays at **5.4 KB gzip** — types only, no runtime change.
+
+### Breaking — types only
+
+- The legacy `on<T>(event, handler)` generic now infers `T` as the
+  event *key*, not the handler payload. Code that explicitly passed a
+  payload type via the generic (`Micra.on<User>('user:updated', h)`)
+  still compiles, but `h`'s parameter falls back to `unknown` unless
+  the event is declared in `MicraEvents`. Migration: register the
+  event via `declare module 'micra.js'` and drop the explicit generic.
+  No runtime impact.
+
+### Performance — non-keyed `data-each` now reuses DOM nodes
+
+- **Non-keyed `<template data-each>` no longer re-renders the whole list
+  on every update.** The new path keeps the first `min(prev, next)` row
+  nodes in place — only the length delta is touched (tail removed when
+  the list shrinks, new rows cloned when it grows). Each retained row
+  gets a fresh `itemState` and a re-applied directive pass through its
+  cached `__micraScan`, so content updates correctly without the
+  remove/re-clone overhead.
+- Row identity is now stable across renders for the no-key path: event
+  listeners bound via `data-on` / `@event` / `data-model` survive
+  re-renders without re-binding, and DOM-level state (focus, scroll,
+  CSS transitions) is preserved on retained rows.
+- Items that didn't change (same reference + same index) skip
+  `applyDirectives` entirely when only the `data-each` source array is
+  the trigger for this render cycle — same `canSkipUnchanged`
+  optimisation the keyed path already had.
+- Bundle: **5.5 KB gzip** (raised guard from 5.4 → 5.5 to give the
+  shared row-creation helper room; net code is slightly smaller after
+  factoring `createRowNode` out of both keyed and non-keyed paths).
+
+### Breaking — non-keyed multi-root rows now wrap in `<micra-each-item>`
+
+- Templates whose `data-each` content has more than one top-level node
+  now render each row inside a `<micra-each-item style="display:contents">`
+  wrapper, mirroring the keyed path's existing behaviour. The wrapper is
+  visually inert (CSS `display:contents` opts out of the box model) but
+  it does add one node to the parse tree.
+- Impact:
+  - **CSS:** child selectors that targeted `parent > .row` will now
+    match `parent > micra-each-item` instead. Use descendant selectors
+    (`parent .row`) or update the rules.
+  - **Invalid HTML contexts:** templates whose rows are `<tr>` / `<td>` /
+    `<li>` inside `<tbody>` / `<tr>` / `<ul>` cannot legally have a
+    wrapper between the parent and the row. Hoist the wrapper into the
+    template (so the row is single-rooted) or use a `data-key`.
+- Single-root templates are unchanged — by far the common case.
+
+## [2.2.1] — 2026-05-28
+
+### Performance — batched first list render
+
+- **First render of a keyed `data-each` list now inserts in a single DOM
+  operation.** `renderKeyed` previously appended each new row with an
+  individual `anchor.after(node)` call — N insertions for an N-row list. On the
+  initial render (no previous rows to diff against), all freshly-cloned rows are
+  now collected into one `DocumentFragment` and inserted with a single
+  `marker.after()`, skipping the LIS reorder pass entirely. The update, swap, and
+  reorder paths are unchanged.
+- No public-API change. Bundle stays at **5.4 KB gzip**.
+
 ## [2.2.0] — 2026-05-27
 
 ### Performance — single-pass DOM scan

package/README.md

@@ -182,6 +182,7 @@ this.on(event, handler)
 - Recipes:
   - [Todo app](./docs/recipes/todo-app.md)
   - [Server-sent events (SSE)](./docs/recipes/sse.md)
+  - [htmx bridge](./docs/recipes/htmx.md)
 
 ## Code generation with LLMs
 

package/dist/core/bus.d.ts

@@ -10,23 +10,25 @@
  * Component instances subscribe via `instance.on()` which auto-registers
  * the unsub token in `instance.__micraSubs` for cleanup on destroy().
  */
-import type { EventHandler, UnsubFn } from '../types';
+import type { EmitArgs, EventPayload, UnsubFn } from '../types';
 /**
  * Subscribe to a named event. Returns an unsubscribe function.
+ * Payload is typed via the `MicraEvents` interface (augmentable).
  *
  * @example
  * const unsub = on('user:login', (user) => console.log(user))
  * unsub()  // stop listening
  */
-export declare function on<T = unknown>(event: string, handler: EventHandler<T>): UnsubFn;
+export declare function on<K extends string>(event: K, handler: (payload: EventPayload<K>) => void): UnsubFn;
 /**
  * Unsubscribe a specific handler from an event.
  */
-export declare function off(event: string, handler: EventHandler): void;
+export declare function off<K extends string>(event: K, handler: (payload: EventPayload<K>) => void): void;
 /**
  * Publish an event to all subscribers. Errors are caught per-handler.
+ * Payload is typed via the `MicraEvents` interface (augmentable).
  *
  * @example
  * emit('user:updated', { id: 1, name: 'Alice' })
  */
-export declare function emit(event: string, payload?: unknown): void;
+export declare function emit<K extends string>(event: K, ...args: EmitArgs<K>): void;

package/dist/core/reactive.d.ts

@@ -18,7 +18,7 @@ import type { StateRecord } from '../types';
  * const state = createReactiveState(raw, render)
  * state.count = 5  // triggers render() in next microtask
  */
-export declare function createReactiveState<S extends StateRecord>(obj: S, schedule: () => void): S;
+export declare function createReactiveState<S extends StateRecord>(obj: S, schedule: () => void, onKey?: (key: string) => void): S;
 /**
  * Return a debounce function that defers `render` to the next microtask.
  * Multiple calls within the same tick collapse to a single render.

package/dist/dom/each.d.ts

@@ -4,7 +4,8 @@
  * Responsibilities:
  *   - Process `<template data-each="items" data-key="id">` elements
  *   - Keyed diff: reuse/reorder DOM nodes by key — O(n) with a Map
- *   - Non-keyed fallback: full replace (no key → warn in dev, full re-render)
+ *   - Non-keyed fallback: length-based positional reuse — min(old, new) rows
+ *     are kept as-is, the tail is removed or new rows are appended
  *   - Apply directives to each row with a scoped itemState
  *
  * LLM NOTE: renderList() is called on every render cycle AFTER applyDirectives().
@@ -12,16 +13,19 @@
  * Each row node gets its own ScanIndex cached on `node.__micraScan` so
  * re-renders of that row don't re-walk the DOM.
  * Keyed mode (data-key present) mutates the DOM in-place — nodes are
- * created once and reused. Non-keyed mode removes all nodes and re-clones.
+ * created once and reused. Non-keyed mode also reuses existing nodes
+ * positionally: only the length delta is touched, the rest gets a fresh
+ * itemState and re-applies directives.
  */
 import type { InternalInstance, StateRecord } from '../types';
 /**
  * Process all `<template data-each>` elements found by the scanner.
  * Scoped itemState makes `item`, `index`, `$index` available in row expressions.
  *
- * @param templates - Pre-scanned list of <template data-each> elements
- * @param state     - Expression state (proxy merging rawState + instance)
- * @param rawState  - Raw (non-proxy) state — used for model binding
- * @param instance  - Component instance (for event binding)
+ * @param templates  - Pre-scanned list of <template data-each> elements
+ * @param state      - Expression state (proxy merging rawState + instance)
+ * @param rawState   - Raw (non-proxy) state — used for model binding
+ * @param instance   - Component instance (for event binding)
+ * @param triggerKey - Which state key triggered this render (null = initial, 'MULTIPLE' = batch)
  */
-export declare function renderList<S extends StateRecord>(templates: Element[], state: StateRecord, rawState: StateRecord, instance: InternalInstance<S>): void;
+export declare function renderList<S extends StateRecord>(templates: Element[], state: StateRecord, rawState: StateRecord, instance: InternalInstance<S>, triggerKey: string | null | 'MULTIPLE'): void;

package/dist/dom/scan.d.ts

@@ -10,7 +10,8 @@
  *     even *visit* those nodes.
  *   - <template> contents are not visited (browser TreeWalker default).
  *     `<template data-each>` itself IS visited and classified into scan.each;
- *     its children are processed by each.ts on every render via scanFragment.
+ *     its children are processed by each.ts on every render — fresh rows
+ *     are wrapped in a per-row element and scanned via scanComponent.
  *
  * Hot-path notes:
  *   - We read `el.attributes` once and switch by suffix. No allocations per
@@ -27,8 +28,3 @@ import type { ScanIndex } from "../types";
  * are free.
  */
 export declare function scanComponent(root: Element): ScanIndex;
-/**
- * Scan a DocumentFragment (no-key each clone). Not cached — these fragments
- * are temporary and re-cloned every render.
- */
-export declare function scanFragment(frag: DocumentFragment): ScanIndex;

package/dist/index.d.ts

@@ -21,7 +21,7 @@
  *
  * @module Micra
  */
-export type { StateRecord, UnsubFn, EventHandler, FetchOptions, ComponentMethods, ComponentBuiltins, ComponentInstance, ComponentDefinition, } from './types';
+export type { StateRecord, UnsubFn, EventHandler, EventPayload, EmitArgs, MicraEvents, FetchOptions, ComponentMethods, ComponentBuiltins, ComponentInstance, ComponentDefinition, } from './types';
 export { FetchError } from './utils/fetch';
 export { define, defineComponent, instances, registry, debug } from './core/registry';
 export { mount } from './core/mount';

package/dist/micra.cjs.js

@@ -1,4 +1,4 @@
-/* Micra.js v2.2.0 — https://github.com/micra-js/micra — MIT */
+/* Micra.js v2.3.0 — https://github.com/micra-js/micra — MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -176,27 +176,32 @@ function safeStateHas(state, key) {
   return false;
 }
 function evalExpr(expr, state) {
-  if (SIMPLE_PATH.test(expr)) {
-    const parts = expr.split(".");
-    if (!safeStateHas(state, parts[0])) return void 0;
-    return parts.reduce(
+  let cached = exprCache.get(expr);
+  if (!cached) {
+    if (SIMPLE_PATH.test(expr)) {
+      cached = { kind: "path", parts: expr.split(".") };
+    } else {
+      try {
+        cached = {
+          kind: "fn",
+          fn: new Function("$s", "$safe", `with($safe){with($s){return (${expr})}}`)
+        };
+      } catch {
+        warn(`invalid expression "${expr}"`);
+        cached = { kind: "fn", fn: () => void 0 };
+      }
+    }
+    exprCache.set(expr, cached);
+  }
+  if (cached.kind === "path") {
+    if (!safeStateHas(state, cached.parts[0])) return void 0;
+    return cached.parts.reduce(
       (obj, key) => obj != null ? obj[key] : void 0,
       state
     );
   }
-  if (!exprCache.has(expr)) {
-    try {
-      exprCache.set(
-        expr,
-        new Function("$s", "$safe", `with($safe){with($s){return (${expr})}}`)
-      );
-    } catch {
-      warn(`invalid expression "${expr}"`);
-      exprCache.set(expr, () => void 0);
-    }
-  }
   try {
-    return exprCache.get(expr)(safeStateWrap(state), SAFE_OUTER);
+    return cached.fn(safeStateWrap(state), SAFE_OUTER);
   } catch (e) {
     if (!warnedRuntime.has(expr)) {
       warnedRuntime.add(expr);
@@ -222,8 +227,9 @@ function off(event, handler) {
   set.delete(handler);
   if (set.size === 0) _bus.delete(event);
 }
-function emit(event, payload) {
+function emit(event, ...args) {
   var _a;
+  const payload = args[0];
   (_a = _bus.get(event)) == null ? void 0 : _a.forEach((h) => {
     try {
       h(payload);
@@ -234,11 +240,12 @@ function emit(event, payload) {
 }
 
 // src/core/reactive.ts
-function createReactiveState(obj, schedule) {
+function createReactiveState(obj, schedule, onKey) {
   return new Proxy(obj, {
     set(target, key, value) {
       ;
       target[key] = value;
+      onKey == null ? void 0 : onKey(key);
       schedule();
       return true;
     }
@@ -264,7 +271,8 @@ function applyText(el, expr, state) {
 }
 function applyHtml(el, expr, state) {
   var _a;
-  el.innerHTML = String((_a = evalExpr(expr, state)) != null ? _a : "");
+  const html = String((_a = evalExpr(expr, state)) != null ? _a : "");
+  if (el.innerHTML !== html) el.innerHTML = html;
 }
 function applyIf(binding, state) {
   const el = binding.el;
@@ -281,7 +289,9 @@ function applyIf(binding, state) {
   }
 }
 function applyShow(el, expr, state) {
-  el.style.display = evalExpr(expr, state) ? "" : "none";
+  const desired = evalExpr(expr, state) ? "" : "none";
+  const htmlEl = el;
+  if (htmlEl.style.display !== desired) htmlEl.style.display = desired;
 }
 function applyBind(el, pairs, state) {
   for (const [attr, valExpr] of pairs) {
@@ -526,23 +536,9 @@ function scanComponent(root) {
   }
   return scan;
 }
-function scanFragment(frag) {
-  const scan = emptyScan();
-  const walker = document.createTreeWalker(
-    frag,
-    NodeFilter.SHOW_ELEMENT,
-    NESTED_COMPONENT_FILTER
-  );
-  let node = walker.nextNode();
-  while (node) {
-    classify(node, scan);
-    node = walker.nextNode();
-  }
-  return scan;
-}
 
 // src/dom/each.ts
-function renderList(templates, state, rawState, instance) {
+function renderList(templates, state, rawState, instance, triggerKey) {
   var _a;
   for (const tmplEl of templates) {
     if (tmplEl.tagName !== "TEMPLATE") continue;
@@ -559,22 +555,40 @@ function renderList(templates, state, rawState, instance) {
     }
     const marker = tmpl.__micraMarker;
     const keyMap = tmpl.__micraNodes;
-    const parent = marker.parentNode;
-    if (!parent) continue;
+    if (!marker.parentNode) continue;
     if (!Array.isArray(items)) {
       tmpl.__micraList.forEach((n) => n.remove());
       tmpl.__micraList = [];
       keyMap.clear();
       continue;
     }
+    const canSkipUnchanged = triggerKey !== null && triggerKey !== "MULTIPLE" && triggerKey === itemsExpr;
     if (keyAttr) {
-      renderKeyed(tmpl, items, keyAttr, marker, keyMap, parent, state, rawState, instance);
+      renderKeyed(tmpl, items, keyAttr, marker, keyMap, state, rawState, instance, canSkipUnchanged);
     } else {
-      renderNoKey(tmpl, items, marker, parent, state, rawState, instance);
+      renderNoKey(tmpl, items, marker, state, rawState, instance, canSkipUnchanged);
     }
   }
 }
-function renderKeyed(tmpl, items, keyAttr, marker, keyMap, parent, state, rawState, instance) {
+function createRowNode(tmpl, state, instance) {
+  const frag = tmpl.content.cloneNode(true);
+  let node;
+  if (frag.childNodes.length === 1) {
+    node = frag.firstElementChild;
+  } else {
+    node = document.createElement("micra-each-item");
+    node.style.display = "contents";
+    node.append(frag);
+  }
+  const rowScan = scanComponent(node);
+  node.__micraScan = rowScan;
+  node._itemState = Object.create(state);
+  bindDataOn(rowScan.on, instance);
+  bindAtEvents(rowScan.atEvents, instance);
+  bindModels(rowScan.model, instance);
+  return node;
+}
+function renderKeyed(tmpl, items, keyAttr, marker, keyMap, state, rawState, instance, canSkipUnchanged) {
   var _a;
   const nextKeys = /* @__PURE__ */ new Set();
   const nextNodes = [];
@@ -593,26 +607,19 @@ function renderKeyed(tmpl, items, keyAttr, marker, keyMap, parent, state, rawSta
     nextKeys.add(key);
     let node = keyMap.get(key);
     if (!node) {
-      const frag = tmpl.content.cloneNode(true);
-      if (frag.childNodes.length === 1) {
-        node = frag.firstElementChild;
-      } else {
-        node = document.createElement("micra-each-item");
-        node.style.display = "contents";
-        node.append(frag);
-      }
+      node = createRowNode(tmpl, state, instance);
       node.__micraKey = key;
       keyMap.set(key, node);
-      const rowScan2 = scanComponent(node);
-      node.__micraScan = rowScan2;
-      bindDataOn(rowScan2.on, instance);
-      bindAtEvents(rowScan2.atEvents, instance);
-      bindModels(rowScan2.model, instance);
+    } else if (canSkipUnchanged && node.__micraItem === item && node.__micraIndex === index) {
+      nextNodes.push(node);
+      continue;
     }
-    const itemState = Object.assign(
-      Object.create(state),
-      { item, index, $index: index }
-    );
+    node.__micraItem = item;
+    node.__micraIndex = index;
+    const itemState = node._itemState;
+    itemState.item = item;
+    itemState.index = index;
+    itemState.$index = index;
     const rowScan = (_a = node.__micraScan) != null ? _a : node.__micraScan = scanComponent(node);
     applyDirectives(rowScan, itemState, rawState, instance);
     nextNodes.push(node);
@@ -623,40 +630,113 @@ function renderKeyed(tmpl, items, keyAttr, marker, keyMap, parent, state, rawSta
       keyMap.delete(key);
     }
   }
-  let cursor = marker;
-  for (const node of nextNodes) {
-    if (cursor.nextSibling !== node) parent.insertBefore(node, cursor.nextSibling);
-    cursor = node;
+  const prevList = tmpl.__micraList;
+  if (prevList.length === 0) {
+    if (nextNodes.length) {
+      const frag = document.createDocumentFragment();
+      for (const node of nextNodes) frag.append(node);
+      marker.after(frag);
+    }
+  } else {
+    let orderChanged = nextNodes.length !== prevList.length;
+    if (!orderChanged) {
+      for (let i = 0; i < nextNodes.length; i++) {
+        if (nextNodes[i] !== prevList[i]) {
+          orderChanged = true;
+          break;
+        }
+      }
+    }
+    if (orderChanged) reorderKeyed(nextNodes, prevList, marker);
   }
   tmpl.__micraList = nextNodes;
 }
-function renderNoKey(tmpl, items, marker, parent, state, rawState, instance) {
-  tmpl.__micraList.forEach((n) => n.remove());
-  tmpl.__micraList = [];
-  const frag = document.createDocumentFragment();
-  for (const [index, item] of items.entries()) {
-    const clone = tmpl.content.cloneNode(true);
-    const itemState = Object.assign(
-      Object.create(state),
-      { item, index, $index: index }
-    );
-    const fragScan = scanFragment(clone);
-    applyDirectives(fragScan, itemState, rawState, instance);
-    bindDataOn(fragScan.on, instance);
-    bindAtEvents(fragScan.atEvents, instance);
-    bindModels(fragScan.model, instance);
-    const nodes = Array.from(clone.childNodes);
-    nodes.forEach((n) => {
-      n.__micraEach = true;
-      frag.append(n);
-    });
-    tmpl.__micraList.push(...nodes);
+function reorderKeyed(nextNodes, prevList, marker) {
+  const prevPos = /* @__PURE__ */ new Map();
+  for (let i = 0; i < prevList.length; i++) prevPos.set(prevList[i], i);
+  const n = nextNodes.length;
+  const tails = [];
+  const tailIdx = [];
+  const prev = new Array(n).fill(-1);
+  for (let i = 0; i < n; i++) {
+    const p = prevPos.get(nextNodes[i]);
+    if (p === void 0) continue;
+    let lo = 0, hi = tails.length;
+    while (lo < hi) {
+      const m = lo + hi >> 1;
+      tails[m] < p ? lo = m + 1 : hi = m;
+    }
+    if (lo > 0) prev[i] = tailIdx[lo - 1];
+    tails[lo] = p;
+    tailIdx[lo] = i;
+  }
+  const stable = /* @__PURE__ */ new Set();
+  let idx = tailIdx[tails.length - 1];
+  while (idx >= 0) {
+    stable.add(idx);
+    idx = prev[idx];
+  }
+  let anchor = marker;
+  for (let i = 0; i < n; i++) {
+    const node = nextNodes[i];
+    if (stable.has(i)) {
+      anchor = node;
+      continue;
+    }
+    anchor.after(node);
+    anchor = node;
+  }
+}
+function renderNoKey(tmpl, items, marker, state, rawState, instance, canSkipUnchanged) {
+  const prevList = tmpl.__micraList;
+  const prevLen = prevList.length;
+  const nextLen = items.length;
+  const reuseLen = nextLen < prevLen ? nextLen : prevLen;
+  const nextList = new Array(nextLen);
+  for (let i = 0; i < reuseLen; i++) {
+    const node = prevList[i];
+    const item = items[i];
+    if (canSkipUnchanged && node.__micraItem === item && node.__micraIndex === i) {
+      nextList[i] = node;
+      continue;
+    }
+    node.__micraItem = item;
+    node.__micraIndex = i;
+    const itemState = node._itemState;
+    itemState.item = item;
+    itemState.index = i;
+    itemState.$index = i;
+    applyDirectives(node.__micraScan, itemState, rawState, instance);
+    nextList[i] = node;
+  }
+  for (let i = nextLen; i < prevLen; i++) {
+    prevList[i].remove();
+  }
+  if (nextLen > prevLen) {
+    const frag = document.createDocumentFragment();
+    for (let i = prevLen; i < nextLen; i++) {
+      const node = createRowNode(tmpl, state, instance);
+      const item = items[i];
+      const itemState = node._itemState;
+      itemState.item = item;
+      itemState.index = i;
+      itemState.$index = i;
+      node.__micraEach = true;
+      node.__micraItem = item;
+      node.__micraIndex = i;
+      applyDirectives(node.__micraScan, itemState, rawState, instance);
+      nextList[i] = node;
+      frag.append(node);
+    }
+    const anchor = prevLen > 0 ? nextList[prevLen - 1] : marker;
+    anchor.after(frag);
   }
-  parent.insertBefore(frag, marker.nextSibling);
+  tmpl.__micraList = nextList;
 }
 
 // src/dom/refs.ts
 function collectRefs(els, instance) {
+  if (!els.length) return;
   instance.refs = {};
   for (const el of els) {
     const name = el.dataset["ref"];
@@ -699,8 +779,12 @@ function mount(selector, definition) {
     return unsub;
   };
   let isRendering = false;
+  let _triggerKey = null;
   const schedule = createScheduler(() => instance.render());
-  instance.state = createReactiveState(rawState, schedule);
+  instance.state = createReactiveState(rawState, schedule, (key) => {
+    if (_triggerKey === null) _triggerKey = key;
+    else if (_triggerKey !== key) _triggerKey = "MULTIPLE";
+  });
   const boundMethods = /* @__PURE__ */ new Map();
   const exprState = new Proxy(rawState, {
     get(target, key) {
@@ -724,6 +808,8 @@ function mount(selector, definition) {
   instance.render = function() {
     var _a2;
     if (instance.__micraDestroyed) return;
+    const triggerKey = _triggerKey;
+    _triggerKey = null;
     if (isRendering) {
       if (!warnedReentry) {
         warn(
@@ -738,7 +824,7 @@ function mount(selector, definition) {
       const mRoot2 = root;
       const scan = (_a2 = mRoot2.__micraScan) != null ? _a2 : mRoot2.__micraScan = scanComponent(root);
       applyDirectives(scan, exprState, rawState, instance);
-      renderList(scan.each, exprState, rawState, instance);
+      renderList(scan.each, exprState, rawState, instance, triggerKey);
       bindDataOn(scan.on, instance);
       bindAtEvents(scan.atEvents, instance);
       bindModels(scan.model, instance);