@proteus-vue/render-backend 0.3.0-beta.11 → 0.3.0-beta.23

package/dist/app-navigation.js

@@ -0,0 +1,3017 @@
+// ../router/src/app-stack.ts
+function paramKey(params) {
+  if (!params) return "";
+  return Object.keys(params).sort().filter((k) => params[k] !== void 0).map((k) => `${k}=${String(params[k])}`).join("&");
+}
+function createAppStack(opts) {
+  const screens = opts.screens;
+  const policy = {
+    nodeBudget: null,
+    keepWindow: 3,
+    defaultScreenNodes: 64,
+    ...opts.policy
+  };
+  const stack = [];
+  const commands = [];
+  const handlers = [];
+  let seq = 0;
+  let freezeCount = 0;
+  let rebuildCount = 0;
+  let overBudget = false;
+  let activeNodeCount = 0;
+  let frozenPrefix = 0;
+  const emit = (e) => {
+    for (const h of handlers) h(e);
+  };
+  function specOf2(name) {
+    const s = screens[name];
+    if (!s) {
+      throw new Error(`[app-stack] \u672A\u6CE8\u518C\u7684\u5C4F "${name}"\uFF08\u53EF\u7528\uFF1A${Object.keys(screens).join(", ") || "\uFF08\u7A7A\u6CE8\u518C\u8868\uFF09"}\uFF09`);
+    }
+    return s;
+  }
+  function makeRecord(name, params, transition) {
+    const spec = specOf2(name);
+    return {
+      screenId: `${name}#${++seq}`,
+      name,
+      path: spec.path,
+      params: params ?? {},
+      transition: transition ?? spec.transition,
+      state: "hidden",
+      // 调用方按角色置可见性（仅栈顶 mounted）
+      needsRebuild: false,
+      budgetNodes: spec.budgetNodes ?? policy.defaultScreenNodes
+    };
+  }
+  function pushMount(rec, rebuild) {
+    commands.push({ op: "mount", screenId: rec.screenId, name: rec.name, path: rec.path, params: rec.params, rebuild });
+  }
+  function activeNodes() {
+    return activeNodeCount;
+  }
+  function applyMemoryPolicy() {
+    overBudget = false;
+    const budget = policy.nodeBudget;
+    if (budget == null) return;
+    if (activeNodeCount <= budget) return;
+    const protectFrom = Math.max(0, stack.length - policy.keepWindow);
+    while (activeNodeCount > budget) {
+      let frozenOne = false;
+      for (let i = frozenPrefix; i < protectFrom; i++) {
+        const r = stack[i];
+        if (r.state !== "hidden") continue;
+        r.state = "frozen";
+        r.needsRebuild = true;
+        freezeCount++;
+        commands.push({ op: "unmount", screenId: r.screenId, reason: "freeze" });
+        activeNodeCount -= r.budgetNodes;
+        while (frozenPrefix < stack.length && stack[frozenPrefix].state === "frozen") frozenPrefix++;
+        emit({ type: "freeze", screenId: r.screenId, name: r.name, depth: stack.length });
+        frozenOne = true;
+        break;
+      }
+      if (!frozenOne) break;
+    }
+    overBudget = activeNodeCount > budget;
+    if (overBudget) emit({ type: "over-budget", activeNodes: activeNodeCount, nodeBudget: budget });
+  }
+  function activateTop() {
+    const top = stack[stack.length - 1];
+    if (!top || top.state === "mounted") return;
+    const rebuild = top.state === "frozen";
+    top.state = "mounted";
+    if (rebuild) {
+      rebuildCount++;
+      activeNodeCount += top.budgetNodes;
+      pushMount(top, true);
+      emit({ type: "restore", screenId: top.screenId, name: top.name, depth: stack.length });
+    }
+    commands.push({ op: "enter", screenId: top.screenId, transition: top.transition });
+  }
+  function deactivate(oldTop, transition) {
+    if (!oldTop || oldTop.state !== "mounted") return;
+    oldTop.state = "hidden";
+    commands.push({ op: "exit", screenId: oldTop.screenId, transition });
+  }
+  function suspend(opts2) {
+    const top = stack[stack.length - 1] ?? null;
+    deactivate(top, opts2?.transition);
+  }
+  function resume() {
+    if (stack.length === 0) return;
+    activateTop();
+  }
+  function releaseTrees() {
+    let released = 0;
+    for (const r of stack) {
+      if (r.state === "frozen") continue;
+      if (r.state === "mounted") r.state = "hidden";
+      activeNodeCount -= r.budgetNodes;
+      r.state = "frozen";
+      r.needsRebuild = true;
+      freezeCount++;
+      commands.push({ op: "unmount", screenId: r.screenId, reason: "freeze" });
+      released++;
+    }
+    while (frozenPrefix < stack.length && stack[frozenPrefix].state === "frozen") frozenPrefix++;
+    if (released > 0) emit({ type: "release", screens: released, depth: stack.length });
+    return released;
+  }
+  function frames() {
+    return stack.map((r) => {
+      const f = { name: r.name };
+      if (Object.keys(r.params).length > 0) f.params = { ...r.params };
+      if (r.transition) f.transition = r.transition;
+      return f;
+    });
+  }
+  function push(name, params, o) {
+    const oldTop = stack[stack.length - 1] ?? null;
+    const rec = makeRecord(name, params, o?.transition);
+    const t = rec.transition;
+    deactivate(oldTop, t);
+    pushMount(rec, false);
+    rec.state = "mounted";
+    stack.push(rec);
+    activeNodeCount += rec.budgetNodes;
+    commands.push({ op: "enter", screenId: rec.screenId, transition: t });
+    applyMemoryPolicy();
+    emit({ type: "push", name, depth: stack.length });
+  }
+  function popToIndex(targetIdx, exitTransition) {
+    if (stack.length - 1 <= targetIdx) return null;
+    const removed = [];
+    while (stack.length - 1 > targetIdx) removed.push(stack.pop());
+    commands.push({ op: "exit", screenId: removed[0].screenId, transition: exitTransition });
+    for (const r of removed) {
+      if (r.state !== "frozen") activeNodeCount -= r.budgetNodes;
+      r.state = "destroyed";
+      commands.push({ op: "unmount", screenId: r.screenId, reason: "pop" });
+    }
+    if (frozenPrefix > stack.length) frozenPrefix = stack.length;
+    activateTop();
+    return removed[0];
+  }
+  function pop(delta = 1) {
+    const target = Math.max(0, stack.length - 1 - Math.max(1, delta));
+    const oldTop = stack[stack.length - 1] ?? null;
+    const removed = popToIndex(target, oldTop?.transition);
+    if (!removed) return;
+    applyMemoryPolicy();
+    emit({ type: "pop", name: removed.name, depth: stack.length });
+  }
+  function replace(name, params, o) {
+    const oldTop = stack[stack.length - 1] ?? null;
+    if (oldTop) {
+      commands.push({ op: "exit", screenId: oldTop.screenId, transition: o?.transition ?? oldTop.transition });
+      commands.push({ op: "unmount", screenId: oldTop.screenId, reason: "pop" });
+      stack.pop();
+      if (oldTop.state !== "frozen") activeNodeCount -= oldTop.budgetNodes;
+      oldTop.state = "destroyed";
+      if (frozenPrefix > stack.length) frozenPrefix = stack.length;
+    }
+    const rec = makeRecord(name, params, o?.transition);
+    pushMount(rec, false);
+    rec.state = "mounted";
+    stack.push(rec);
+    activeNodeCount += rec.budgetNodes;
+    commands.push({ op: "enter", screenId: rec.screenId, transition: rec.transition });
+    applyMemoryPolicy();
+    emit({ type: "replace", name, depth: stack.length });
+  }
+  function removeByName(name) {
+    const removedIdx = [];
+    for (let i = stack.length - 1; i >= 0; i--) {
+      if (stack[i].name === name) removedIdx.push(i);
+    }
+    if (removedIdx.length === 0) return 0;
+    const topIdx = stack.length - 1;
+    const removedMounted = removedIdx.some((i) => stack[i].state === "mounted");
+    const removedWasTop = removedIdx.includes(topIdx);
+    for (const i of removedIdx) {
+      const r = stack[i];
+      if (r.state !== "frozen") activeNodeCount -= r.budgetNodes;
+      r.state = "destroyed";
+      commands.push({ op: "unmount", screenId: r.screenId, reason: "pop" });
+    }
+    for (const i of removedIdx) stack.splice(i, 1);
+    if (frozenPrefix > stack.length) frozenPrefix = stack.length;
+    if (removedMounted && removedWasTop && stack.length > 0) {
+      const top = stack[stack.length - 1];
+      if (top.state !== "mounted") {
+        const rebuild = top.state === "frozen";
+        top.state = "mounted";
+        if (rebuild) {
+          rebuildCount++;
+          activeNodeCount += top.budgetNodes;
+          pushMount(top, true);
+          emit({ type: "restore", screenId: top.screenId, name: top.name, depth: stack.length });
+        }
+        commands.push({ op: "enter", screenId: top.screenId, transition: top.transition });
+      }
+    }
+    emit({ type: "pop", name, depth: stack.length });
+    return removedIdx.length;
+  }
+  function moveToTop(name) {
+    const idx = stack.findIndex((r) => r.name === name);
+    if (idx < 0) {
+      throw new Error(
+        `[app-stack] moveToTop("${name}")\uFF1A\u6808\u4E2D\u4E0D\u5B58\u5728\u8BE5\u5C4F\uFF08\u5F53\u524D\u6808\uFF1A${stack.map((r) => r.name).join(" \u2192 ") || "\u7A7A"}\uFF09`
+      );
+    }
+    const target = stack[idx];
+    if (idx === stack.length - 1) return;
+    const oldTop = stack[stack.length - 1];
+    deactivate(oldTop, target.transition);
+    stack.splice(idx, 1);
+    stack.push(target);
+    if (target.state !== "mounted") {
+      const rebuild = target.state === "frozen";
+      target.state = "mounted";
+      if (rebuild) {
+        rebuildCount++;
+        activeNodeCount += target.budgetNodes;
+        pushMount(target, true);
+        emit({ type: "restore", screenId: target.screenId, name: target.name, depth: stack.length });
+      }
+    }
+    commands.push({ op: "enter", screenId: target.screenId, transition: target.transition });
+    emit({ type: "push", name, depth: stack.length });
+  }
+  function popTo(name) {
+    let idx = -1;
+    for (let i = stack.length - 1; i >= 0; i--) {
+      if (stack[i].name === name) {
+        idx = i;
+        break;
+      }
+    }
+    if (idx < 0) throw new Error(`[app-stack] popTo("${name}")\uFF1A\u6808\u4E2D\u4E0D\u5B58\u5728\u8BE5\u5C4F\uFF08\u5F53\u524D\u6808\uFF1A${stack.map((r) => r.name).join(" \u2192 ") || "\u7A7A"}\uFF09`);
+    const oldTop = stack[stack.length - 1] ?? null;
+    const removed = popToIndex(idx, oldTop?.transition);
+    if (!removed) return;
+    applyMemoryPolicy();
+    emit({ type: "pop", name: removed.name, depth: stack.length });
+  }
+  function popToRoot() {
+    const oldTop = stack[stack.length - 1] ?? null;
+    if (stack.length <= 1) return;
+    const removed = popToIndex(0, oldTop?.transition);
+    if (!removed) return;
+    applyMemoryPolicy();
+    emit({ type: "pop", name: removed.name, depth: stack.length });
+  }
+  function resetTo(name, params) {
+    while (stack.length) {
+      const r = stack.pop();
+      if (r.state !== "frozen") activeNodeCount -= r.budgetNodes;
+      r.state = "destroyed";
+      commands.push({ op: "unmount", screenId: r.screenId, reason: "reset" });
+    }
+    frozenPrefix = 0;
+    const rec = makeRecord(name, params);
+    pushMount(rec, false);
+    rec.state = "mounted";
+    stack.push(rec);
+    activeNodeCount += rec.budgetNodes;
+    commands.push({ op: "enter", screenId: rec.screenId, transition: rec.transition });
+    applyMemoryPolicy();
+    emit({ type: "reset", name, depth: stack.length });
+  }
+  function navigate(frames2) {
+    for (const f of frames2) specOf2(f.name);
+    if (frames2.length === 0) {
+      if (stack.length > 0) {
+        resetEmpty();
+      }
+      return;
+    }
+    if (frames2.length === stack.length && frames2.every((f, i) => stack[i].name === f.name && paramKey(stack[i].params) === paramKey(f.params))) {
+      return;
+    }
+    let common = 0;
+    while (common < stack.length && common < frames2.length && stack[common].name === frames2[common].name && paramKey(stack[common].params) === paramKey(frames2[common].params)) {
+      common++;
+    }
+    const oldTop = stack[stack.length - 1] ?? null;
+    let popRemoved = null;
+    let pushCount = 0;
+    if (stack.length > common) {
+      const removed = [];
+      while (stack.length > common) removed.push(stack.pop());
+      const t = frames2[common]?.transition ?? removed[0].transition;
+      commands.push({ op: "exit", screenId: removed[0].screenId, transition: t });
+      for (const r of removed) {
+        if (r.state !== "frozen") activeNodeCount -= r.budgetNodes;
+        r.state = "destroyed";
+        commands.push({ op: "unmount", screenId: r.screenId, reason: "pop" });
+      }
+      popRemoved = removed[0];
+      if (frozenPrefix > stack.length) frozenPrefix = stack.length;
+    }
+    if (oldTop && oldTop.state === "mounted" && stack[stack.length - 1] !== oldTop) {
+      deactivate(oldTop, frames2[common]?.transition ?? oldTop.transition);
+    }
+    for (let i = common; i < frames2.length; i++) {
+      const rec = makeRecord(frames2[i].name, frames2[i].params, frames2[i].transition);
+      pushMount(rec, false);
+      stack.push(rec);
+      activeNodeCount += rec.budgetNodes;
+      pushCount++;
+    }
+    activateTop();
+    applyMemoryPolicy();
+    if (popRemoved) emit({ type: "pop", name: popRemoved.name, depth: stack.length });
+    if (pushCount > 0) {
+      const top = stack[stack.length - 1];
+      if (top) emit({ type: "push", name: top.name, depth: stack.length });
+    }
+  }
+  function resetEmpty() {
+    while (stack.length) {
+      const r = stack.pop();
+      if (r.state !== "frozen") activeNodeCount -= r.budgetNodes;
+      r.state = "destroyed";
+      commands.push({ op: "unmount", screenId: r.screenId, reason: "reset" });
+    }
+    frozenPrefix = 0;
+    emit({ type: "reset", name: "", depth: 0 });
+  }
+  return {
+    push,
+    pop,
+    replace,
+    popTo,
+    removeByName,
+    moveToTop,
+    popToRoot,
+    tab: resetTo,
+    reset: resetTo,
+    navigate,
+    markRebuilt(screenId) {
+      const r = stack.find((s) => s.screenId === screenId);
+      if (r) r.needsRebuild = false;
+    },
+    drainCommands() {
+      const out = commands.slice();
+      commands.length = 0;
+      return out;
+    },
+    suspend,
+    resume,
+    releaseTrees,
+    frames,
+    current() {
+      return stack[stack.length - 1] ?? null;
+    },
+    get stack() {
+      return stack.slice();
+    },
+    get depth() {
+      return stack.length;
+    },
+    stats() {
+      let mounted = 0;
+      let hidden = 0;
+      let frozen = 0;
+      for (const r of stack) {
+        if (r.state === "mounted") mounted++;
+        else if (r.state === "hidden") hidden++;
+        else frozen++;
+      }
+      return {
+        depth: stack.length,
+        mounted,
+        hidden,
+        frozen,
+        activeNodes: activeNodes(),
+        nodeBudget: policy.nodeBudget,
+        overBudget,
+        freezeCount,
+        rebuildCount
+      };
+    },
+    on(handler) {
+      handlers.push(handler);
+      return () => {
+        const i = handlers.indexOf(handler);
+        if (i >= 0) handlers.splice(i, 1);
+      };
+    }
+  };
+}
+
+// ../router/src/app-adapter.ts
+function normPath(p) {
+  return p.replace(/^\/+/, "").replace(/\/+$/, "");
+}
+function parseRouterUrl(url) {
+  const [rawPath, rawQuery = ""] = url.split("?");
+  const params = {};
+  if (rawQuery) {
+    for (const pair of rawQuery.split("&")) {
+      if (!pair) continue;
+      const eq = pair.indexOf("=");
+      const k = eq < 0 ? pair : pair.slice(0, eq);
+      const v = eq < 0 ? "" : pair.slice(eq + 1);
+      params[decodeURIComponent(k)] = decodeURIComponent(v);
+    }
+  }
+  return { path: rawPath ?? "", params };
+}
+function createAppNavigationAdapter(opts) {
+  const { stack, pump, screens } = opts;
+  const byPath = /* @__PURE__ */ new Map();
+  for (const spec of Object.values(screens)) byPath.set(normPath(spec.path), spec.name);
+  if (byPath.size === 0) {
+    throw new Error("[app-adapter] \u5C4F\u6CE8\u518C\u8868\u4E3A\u7A7A\u2014\u2014App \u7AEF\u5BFC\u822A\u9700\u8981 screens\uFF08\u4E0E createAppStack \u540C\u6E90\uFF09");
+  }
+  const resolveName = (urlPath) => {
+    const name = byPath.get(normPath(urlPath));
+    if (!name) {
+      throw new Error(
+        `[app-adapter] \u672A\u77E5\u8DEF\u5F84 "${urlPath}"\uFF08\u5C4F\u6CE8\u518C\u8868\u65E0\u6B64\u5C4F\uFF09\u2014\u2014\u68C0\u67E5\u8DEF\u7531\u8868\u4E0E\u5C4F\u6CE8\u518C\u8868\u540C\u6E90\uFF1A\u53EF\u7528\u8DEF\u5F84 ${[...byPath.keys()].slice(0, 8).join(", ")}${byPath.size > 8 ? " \u2026" : ""}`
+      );
+    }
+    return name;
+  };
+  let chain = Promise.resolve();
+  const fire = () => {
+    chain = chain.then(() => pump()).catch((e) => {
+      console.error("[app-adapter] \u6CF5\u5931\u8D25\uFF1A", e);
+    });
+    return chain;
+  };
+  const flush = () => chain;
+  const doUrl = (url) => {
+    const { path, params } = parseRouterUrl(url);
+    return { name: resolveName(path), params };
+  };
+  return {
+    isMP: false,
+    getCurrentPages() {
+      return stack.stack.map((rec) => ({
+        route: rec.path,
+        query: Object.fromEntries(Object.entries(rec.params).map(([k, v]) => [k, String(v ?? "")]))
+      }));
+    },
+    async navigateTo({ url }) {
+      const { name, params } = doUrl(url);
+      stack.push(name, params);
+      await fire();
+    },
+    async redirectTo({ url }) {
+      const { name, params } = doUrl(url);
+      stack.replace(name, params);
+      await fire();
+    },
+    async reLaunch({ url }) {
+      const { name, params } = doUrl(url);
+      stack.reset(name, params);
+      await fire();
+    },
+    async switchTab({ url }) {
+      const { name, params } = doUrl(url);
+      stack.tab(name, params);
+      await fire();
+    },
+    navigateBack({ delta }) {
+      stack.pop(delta);
+      void fire();
+    },
+    // ★★★（2026-10-02 · 启示 3）**App 专属栈原语**——Web/MP 受平台栈语义限制，App 虚拟栈完整支持
+    //   （"App 端可解除 Skyline 硬限制"的又一兑现：按名回退/移除/提顶都不需要平台配合）
+    popTo(name) {
+      stack.popTo(name);
+      void fire();
+    },
+    removeByName(name) {
+      const n = stack.removeByName(name);
+      void fire();
+      return n;
+    },
+    moveToTop(name) {
+      stack.moveToTop(name);
+      void fire();
+    },
+    flush
+  };
+}
+function screensFromRoutes(routes) {
+  const out = {};
+  for (const r of routes) {
+    if (!r.name) {
+      throw new Error(`[app-adapter] \u8DEF\u7531\u8868\u6761\u76EE\u7F3A name\uFF08path="${r.path}"\uFF09\u2014\u2014\u68C0\u67E5 gen-routes \u4EA7\u7269`);
+    }
+    const spec = { name: r.name, path: r.path };
+    const t = r.meta?.transition;
+    if (typeof t === "string") spec.transition = t;
+    const b = r.meta?.budgetNodes;
+    if (typeof b === "number" && b > 0) spec.budgetNodes = b;
+    const ka = r.meta?.branch?.keepAlive;
+    if (ka === "none" || ka === "active" || ka === "all") spec.keepAlive = ka;
+    out[r.name] = spec;
+  }
+  return out;
+}
+
+// ../contracts/src/layers.ts
+var LAYER_PRIMITIVES = ["layer-content", "layer-navigation", "layer-mask", "layer-popout"];
+
+// ../contracts/src/mount-layers.ts
+var MOUNT_LAYERS = ["global", "page", "overlay"];
+var MOUNT_LAYER_ORDER = {
+  global: 0,
+  page: 1,
+  overlay: 2
+};
+var MOUNT_LAYER_NODE_OFFSET = {
+  global: 1,
+  page: 2,
+  overlay: 3
+};
+function mountLayerContainerPlans() {
+  return [...MOUNT_LAYERS].sort((a, b) => MOUNT_LAYER_ORDER[a] - MOUNT_LAYER_ORDER[b]).map((layer) => ({
+    layer,
+    nodeOffset: MOUNT_LAYER_NODE_OFFSET[layer],
+    order: MOUNT_LAYER_ORDER[layer],
+    frame: "fullscreen"
+  }));
+}
+
+// ../contracts/src/scroll.ts
+var DOCK_REQUIRES_LAYER = LAYER_PRIMITIVES.includes("layer-navigation");
+
+// src/screen-executor.ts
+function createScreenExecutor(opts) {
+  const { host, anim, plan, contentOf, onScreenMounted, onEvent } = opts;
+  const nodes = /* @__PURE__ */ new Map();
+  const stats = {
+    commands: 0,
+    transitions: 0,
+    forward: 0,
+    back: 0,
+    skippedNone: 0,
+    destroyed: { pop: 0, reset: 0, freeze: 0 },
+    visibility: { shown: 0, hidden: 0 },
+    mounts: { first: 0, rebuild: 0 },
+    errors: []
+  };
+  let txn = { exiting: null, mounted: /* @__PURE__ */ new Map() };
+  const emit = (type, screenId, detail) => {
+    onEvent?.({ type, screenId, detail });
+  };
+  async function runCommand(cmd) {
+    stats.commands++;
+    switch (cmd.op) {
+      case "mount": {
+        const rebuild = cmd.rebuild === true;
+        const name = cmd.name ?? cmd.screenId;
+        const path = cmd.path ?? "";
+        const content = contentOf?.({ name, path });
+        const node = await host.mountScreen({
+          screenId: cmd.screenId,
+          name,
+          path,
+          params: cmd.params ?? null,
+          rebuild,
+          ...content ? { content } : {},
+          // ★GP3-c：三层容器计划（由**契约**算，宿主只消费——偏移量而非绝对 id，见类型注释）
+          layerContainers: mountLayerContainerPlans()
+        });
+        nodes.set(cmd.screenId, node);
+        txn.mounted.set(cmd.screenId, rebuild);
+        if (rebuild) stats.mounts.rebuild++;
+        else stats.mounts.first++;
+        emit("mount", cmd.screenId, { rebuild, node, contentNodes: content?.nodes.length ?? 0 });
+        onScreenMounted?.(cmd.screenId, rebuild);
+        return;
+      }
+      case "exit": {
+        txn.exiting = { screenId: cmd.screenId, transition: cmd.transition, destroy: null };
+        emit("exit", cmd.screenId, { transition: cmd.transition });
+        return;
+      }
+      case "unmount": {
+        const reason = cmd.reason ?? "pop";
+        if (txn.exiting && txn.exiting.screenId === cmd.screenId) {
+          txn.exiting.destroy = reason;
+          emit("unmount-deferred", cmd.screenId, { reason });
+          return;
+        }
+        await host.destroyScreen(cmd.screenId, reason, nodes.get(cmd.screenId));
+        nodes.delete(cmd.screenId);
+        stats.destroyed[reason]++;
+        emit("destroy", cmd.screenId, { reason });
+        return;
+      }
+      case "enter": {
+        const incomingNode = nodes.get(cmd.screenId);
+        if (incomingNode === void 0) {
+          stats.errors.push(`enter(${cmd.screenId})\uFF1A\u5C4F\u5B50\u6811\u4E0D\u5B58\u5728\uFF08mount \u672A\u6267\u884C\uFF1F\uFF09`);
+          emit("error", cmd.screenId, "enter-without-subtree");
+          return;
+        }
+        const exiting = txn.exiting;
+        const outgoingNode = exiting ? nodes.get(exiting.screenId) : void 0;
+        const mountedHere = txn.mounted.get(cmd.screenId);
+        const direction = mountedHere === false ? "forward" : "back";
+        const transition = cmd.transition;
+        const batch = plan(transition, { incoming: incomingNode, outgoing: outgoingNode }, { direction });
+        const normalized = typeof transition === "string" ? transition : "none";
+        await host.setScreenVisible(cmd.screenId, true, incomingNode);
+        stats.visibility.shown++;
+        emit("visible", cmd.screenId, true);
+        const hasAnims = batch.incoming.anims.length > 0 || batch.outgoing.anims.length > 0;
+        if (hasAnims) {
+          await anim.playRouteTransition(batch, { direction, transition: normalized });
+          stats.transitions++;
+          if (direction === "forward") stats.forward++;
+          else stats.back++;
+          emit("transition", cmd.screenId, { direction, transition: normalized, anims: batch.incoming.anims.length + batch.outgoing.anims.length });
+        } else {
+          stats.skippedNone++;
+          emit("transition-skipped", cmd.screenId, { transition: normalized });
+        }
+        if (exiting) {
+          if (exiting.destroy !== null) {
+            await host.destroyScreen(exiting.screenId, exiting.destroy, outgoingNode);
+            nodes.delete(exiting.screenId);
+            stats.destroyed[exiting.destroy]++;
+            emit("destroy", exiting.screenId, { reason: exiting.destroy, deferred: true });
+          } else if (outgoingNode !== void 0) {
+            await host.setScreenVisible(exiting.screenId, false, outgoingNode);
+            stats.visibility.hidden++;
+            emit("visible", exiting.screenId, false);
+          }
+        }
+        txn = { exiting: null, mounted: /* @__PURE__ */ new Map() };
+        return;
+      }
+    }
+  }
+  let queue = Promise.resolve();
+  return {
+    applyCommands(commands) {
+      queue = queue.then(async () => {
+        for (const c of commands) await runCommand(c);
+      });
+      return queue;
+    },
+    stats: () => JSON.parse(JSON.stringify(stats)),
+    subtreeNode: (screenId) => nodes.get(screenId)
+  };
+}
+
+// src/screen-executor-host.ts
+var SCREEN_ANIM_DONE_KEY = "__proteusHostScreenAnimDone";
+var instSeq = 0;
+function call(channel, method, args) {
+  const raw = channel(method, JSON.stringify(args ?? null));
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (e) {
+    throw new Error(`[screen-host] ${method} \u56DE\u6267\u975E JSON\uFF1A${String(raw).slice(0, 120)}`);
+  }
+  if (parsed && parsed.ok === false) {
+    throw new Error(`[screen-host] ${method} \u5931\u8D25${parsed.missing ? "\uFF08\u672A\u5B9E\u73B0\uFF09" : ""}\uFF1A${parsed.reason ?? "\u65E0\u539F\u56E0"}`);
+  }
+  return parsed && typeof parsed === "object" && "data" in parsed ? parsed.data : parsed;
+}
+function createHostScreenPorts(opts) {
+  const channel = opts.invoke;
+  const pending = /* @__PURE__ */ new Map();
+  let tokenSeq = 0;
+  let hookInstalled = false;
+  const INSTANCE_ID = `s${++instSeq}-`;
+  const resolveOne = (token, payload) => {
+    const r = pending.get(token);
+    if (!r) return false;
+    pending.delete(token);
+    r(payload);
+    return true;
+  };
+  if (opts.installAnimDoneHook !== false) {
+    const g = globalThis;
+    const REGISTRY_KEY = `${SCREEN_ANIM_DONE_KEY}__registry`;
+    let registry = g[REGISTRY_KEY];
+    if (!Array.isArray(registry)) {
+      registry = [];
+      g[REGISTRY_KEY] = registry;
+    }
+    const handler = (token, resultJson) => {
+      if (typeof token !== "string") return "bad-token";
+      const r = registry;
+      for (let i = 0; i < r.length; i++) {
+        if (r[i](token, resultJson)) return "ok";
+      }
+      return "unknown-token";
+    };
+    registry.push((token, payload) => resolveOne(token, payload));
+    try {
+      g[SCREEN_ANIM_DONE_KEY] = handler;
+      hookInstalled = true;
+    } catch {
+      try {
+        Object.defineProperty(g, SCREEN_ANIM_DONE_KEY, { value: handler, writable: true, configurable: true });
+        hookInstalled = true;
+      } catch {
+      }
+    }
+  }
+  const tree = {
+    mountScreen(screen) {
+      const d = call(channel, "screen.mount", {
+        screenId: screen.screenId,
+        name: screen.name,
+        path: screen.path,
+        params: screen.params,
+        rebuild: screen.rebuild,
+        // ★★★GP3-c：**三层容器计划**随 mount 下发（宿主照此建树——偏移量，宿主加到自己分配的根 id 上）。
+        //   执行器已按契约算好（见 screen-executor.ts）；本层只做**透传**（不再重复计算——
+        //   本仓纪律：同一件事两份实现 = 修一份等于没修）。
+        ...screen.layerContainers ? { layerContainers: screen.layerContainers } : {},
+        // ★★★阶段 1（2026-10-04 · App 三端对齐 B1+B2）：**屏内容**（真实页面渲染产物）透传。
+        //   执行器按 `contentOf` 提供者解析后放入 mountScreen 入参；本层只做转发（与上方同款纪律）。
+        ...screen.content ? { content: screen.content } : {}
+      });
+      const rootNodeId = Number(d?.rootNodeId ?? 0);
+      if (!rootNodeId) {
+        throw new Error(`[screen-host] screen.mount \u672A\u8FD4\u56DE rootNodeId\uFF08${JSON.stringify(d)}\uFF09\u2014\u2014\u5BBF\u4E3B\u5B9E\u73B0\u4E0D\u5B8C\u6574`);
+      }
+      return rootNodeId;
+    },
+    setScreenVisible(screenId, visible, rootNodeId) {
+      call(channel, "screen.visible", { screenId, visible, rootNodeId });
+    },
+    destroyScreen(screenId, reason, rootNodeId) {
+      call(channel, "screen.destroy", { screenId, reason, rootNodeId });
+    }
+  };
+  const anim = {
+    playRouteTransition(plan, ctx) {
+      const anims = [...plan.incoming.anims, ...plan.outgoing.anims];
+      if (anims.length === 0) return;
+      const token = `${INSTANCE_ID}screen-anim-${++tokenSeq}`;
+      const d = call(channel, "screen.anim", {
+        anims,
+        durationMs: plan.durationMs,
+        direction: ctx.direction,
+        transition: ctx.transition,
+        token
+      });
+      if (d?.immediate === true) return;
+      return new Promise((resolve) => {
+        pending.set(token, () => resolve());
+      });
+    }
+  };
+  return {
+    tree,
+    anim,
+    shared: {
+      async rect(screenId, nodeId) {
+        const d = call(channel, "screen.rect", { screenId, nodeId });
+        if (!d || typeof d.x !== "number") {
+          throw new Error(`[screen-host] screen.rect \u672A\u8FD4\u56DE\u51E0\u4F55\uFF08${JSON.stringify(d)}\uFF09`);
+        }
+        return { x: d.x, y: d.y ?? 0, w: d.width ?? 0, h: d.height ?? 0 };
+      },
+      fly(opts2) {
+        const token = `screen-shared-${++tokenSeq}`;
+        const d = call(channel, "screen.shared", { ...opts2, token });
+        if (!d || (d.started ?? 0) < 1) {
+          return Promise.reject(new Error(`[screen-host] screen.shared \u672A\u542F\u52A8\uFF08${JSON.stringify(d)}\uFF09`));
+        }
+        const geom = { fromRect: d.fromRect, toRect: d.toRect };
+        return new Promise((resolve) => {
+          pending.set(token, (v) => {
+            let extra = {};
+            if (typeof v === "string") {
+              try {
+                const o = JSON.parse(v);
+                if (o && typeof o === "object") extra = o;
+              } catch {
+              }
+            } else if (v && typeof v === "object") {
+              extra = v;
+            }
+            resolve({ ...geom, ...extra });
+          });
+        });
+      }
+    },
+    get pendingAnimations() {
+      return pending.size;
+    },
+    get animDoneHookInstalled() {
+      return hookInstalled;
+    }
+  };
+}
+
+// ../animation/dist/index.js
+var AnimKind = {
+  TRANSLATE_X: 0,
+  TRANSLATE_Y: 1,
+  SCALE: 2,
+  ROTATE: 3,
+  OPACITY: 4,
+  // ★★颜色（2026-10-01）：用户面**一个** `color` 声明，内核面**四个标量通道**（kind 5..8）。
+  //   分解的理由见内核 `anim.rs::AnimKind` 头注（求值机器全是标量的 ⇒ 零改动复用）。
+  //   ★对外**不暴露**通道号（`ANIM_KIND_ID` 里也没有它们）——那是编译内部的事。
+  COLOR_R: 5,
+  COLOR_G: 6,
+  COLOR_B: 7,
+  COLOR_A: 8,
+  // ★★文字色（2026-10-01）：与底色**同一条数学、不同的样式槽**（`text_color` vs `bg`）。
+  //   分成两组编号（而不是复用 5..8）的唯一原因：内核 `write()` 必须知道**往哪个槽写**——
+  //   用同一批编号无法区分（会在"同时动底色与文字色"时互相覆盖）。
+  TEXT_COLOR_R: 9,
+  TEXT_COLOR_G: 10,
+  TEXT_COLOR_B: 11,
+  TEXT_COLOR_A: 12,
+  // ★★3D 旋转（2026-10-01 · B 批）：与 `rotate`（Z 轴）并列的两个轴。
+  //   走 tick 路径（不进平台零参与——iOS/Android 的 3D 插值语义不同，跨端一致优先；
+  //   见内核 is_composited 注释）。
+  ROTATE_X: 13,
+  ROTATE_Y: 14,
+  // ★★裁剪形状参数（2026-10-01 · C1）：最多 16 条标量通道（与颜色同源的分解法）。
+  //   含义按节点声明的**形状类型**解释（见 `ClipShape`）；类型静态、参数可动画（CSS 同规）。
+  CLIP0: 15,
+  CLIP1: 16,
+  CLIP2: 17,
+  CLIP3: 18,
+  CLIP4: 19,
+  CLIP5: 20,
+  CLIP6: 21,
+  CLIP7: 22,
+  CLIP8: 23,
+  CLIP9: 24,
+  CLIP10: 25,
+  CLIP11: 26,
+  CLIP12: 27,
+  CLIP13: 28,
+  CLIP14: 29,
+  CLIP15: 30,
+  /** ★★SVG 描边进度（2026-10-01 · C2）：0..1 = 沿路径弧长画到哪（"手写字"动效） */
+  STROKE_PROGRESS: 31,
+  /** ★★渐变混合因子（2026-10-01 · 渐变 v2）：0..1 = A 态（fillGradient）→ B 态（fillGradientTo） */
+  GRADIENT_MIX: 32,
+  /** ★★路径变形因子（2026-10-01 · 路径变形 v1）：0..1 = A 态（svgPath）→ B 态（svgPathTo） */
+  PATH_MORPH: 33,
+  /** ★★发光强度（2026-10-01 · glow v1）：0..1 乘子（1 = 按声明全额发光） */
+  GLOW_INTENSITY: 34,
+  /** ★★遮罩进度（2026-10-01 · mask v1）：0..1 = 软边揭示的进度（0=全隐 / 1=全显） */
+  MASK_PROGRESS: 35,
+  /** ★★倾斜 X（2026-10-01 · skew v1；度） */
+  SKEW_X: 36,
+  /** ★★倾斜 Y（2026-10-01 · skew v1；度） */
+  SKEW_Y: 37
+};
+var ANIM_KIND_ID = {
+  translateX: AnimKind.TRANSLATE_X,
+  translateY: AnimKind.TRANSLATE_Y,
+  scale: AnimKind.SCALE,
+  rotate: AnimKind.ROTATE,
+  opacity: AnimKind.OPACITY,
+  // ★`color` 的编号是**名义值**：编译期会把它展开成 4 条通道指令（见 `compileOne`）。
+  //   这里给 COLOR_R 是为了让 `ANIM_KIND_ID` 保持"每个名字都有编号"的完备形状——
+  //   直接消费它会少写 3 个通道，故 `compileOne` 有专门的 `color` 分支（不读这个值）。
+  color: AnimKind.COLOR_R,
+  // ★`textColor` 同理（名义值 = 文字色 R 通道 9；编译期展开成 4 条）
+  textColor: AnimKind.TEXT_COLOR_R,
+  // ★3D 旋转（单通道——无数值展开）
+  rotateX: AnimKind.ROTATE_X,
+  rotateY: AnimKind.ROTATE_Y,
+  // ★`clip` 的编号是**名义值**（= 参数槽 0 的 15）：编译期按参数个数展开成 N 条参数通道
+  //   （见 `isClipDecl` 分支——它不读这个值）。给名义值是为了 `ANIM_KIND_ID` 的完备形状。
+  clip: AnimKind.CLIP0,
+  // ★描边进度是**单通道**（31——与内核同号）
+  strokeProgress: AnimKind.STROKE_PROGRESS,
+  // ★渐变混合是**单通道**（32——与内核同号）
+  gradientMix: AnimKind.GRADIENT_MIX,
+  // ★路径变形是**单通道**（33——与内核同号）
+  pathMorph: AnimKind.PATH_MORPH,
+  // ★发光强度是**单通道**（34——与内核同号）
+  glowIntensity: AnimKind.GLOW_INTENSITY,
+  // ★遮罩进度是**单通道**（35——与内核同号）
+  maskProgress: AnimKind.MASK_PROGRESS,
+  // ★倾斜是**两条单通道**（36/37——与内核同号；X/Y 各一条：可独立动或一起动）
+  skewX: AnimKind.SKEW_X,
+  skewY: AnimKind.SKEW_Y
+};
+var Curve = {
+  LINEAR: 0,
+  EASE_OUT: 1,
+  EASE_IN: 2,
+  EASE_IN_OUT: 3,
+  /** 阻尼振荡近似（查表）；**与真弹簧不同**——需要物理语义时用 `spring` */
+  SPRING_APPROX: 4
+};
+var CURVE_ID = {
+  linear: Curve.LINEAR,
+  easeOut: Curve.EASE_OUT,
+  easeIn: Curve.EASE_IN,
+  easeInOut: Curve.EASE_IN_OUT,
+  springApprox: Curve.SPRING_APPROX
+};
+function parseColorToChannels(css) {
+  if (typeof css !== "string") {
+    throw new Error(`\u989C\u8272\u5FC5\u987B\u662F\u5B57\u7B26\u4E32\uFF08\u6536\u5230 ${typeof css}\uFF09\u2014\u2014\u7528 '#RRGGBB' \u5F62\u6001`);
+  }
+  const s = css.trim();
+  if (!s.startsWith("#")) {
+    throw new Error(`\u989C\u8272 "${s}" \u4E0D\u652F\u6301\uFF1A\u53EA\u63A5\u53D7 #RGB / #RRGGBB / #RRGGBBAA \u5341\u516D\u8FDB\u5236\u5F62\u6001`);
+  }
+  const hex = s.slice(1);
+  if (!/^[0-9a-fA-F]+$/.test(hex)) {
+    throw new Error(`\u989C\u8272 "${s}" \u4E0D\u662F\u5408\u6CD5\u5341\u516D\u8FDB\u5236\uFF08\u5E94\u4E3A #RGB / #RRGGBB / #RRGGBBAA\uFF09`);
+  }
+  switch (hex.length) {
+    case 3: {
+      return {
+        r: parseInt(hex[0] + hex[0], 16),
+        g: parseInt(hex[1] + hex[1], 16),
+        b: parseInt(hex[2] + hex[2], 16),
+        a: 255
+      };
+    }
+    case 6:
+      return {
+        r: parseInt(hex.slice(0, 2), 16),
+        g: parseInt(hex.slice(2, 4), 16),
+        b: parseInt(hex.slice(4, 6), 16),
+        a: 255
+      };
+    case 8:
+      return {
+        r: parseInt(hex.slice(0, 2), 16),
+        g: parseInt(hex.slice(2, 4), 16),
+        b: parseInt(hex.slice(4, 6), 16),
+        a: parseInt(hex.slice(6, 8), 16)
+      };
+    default:
+      throw new Error(
+        `\u989C\u8272 "${s}" \u4F4D\u6570\u975E\u6CD5\uFF08${hex.length} \u4F4D\uFF09\u2014\u2014\u53EA\u63A5\u53D7 #RGB\uFF083\uFF09/ #RRGGBB\uFF086\uFF09/ #RRGGBBAA\uFF088\uFF09`
+      );
+  }
+}
+var COMPOSITED_KINDS = [
+  "translateX",
+  "translateY",
+  "scale",
+  "rotate",
+  "opacity"
+];
+var TICK_ONLY_KINDS = [
+  "rotateX",
+  "rotateY",
+  // ★★C1（2026-10-01）：裁剪形状是绘制期约束（canvas.clipPath / CALayer.mask）——
+  //   Android RenderNode 无"可动画裁剪形状"属性 ⇒ 两端统一 tick 路径。
+  "clip",
+  // ★★C2（2026-10-01）：SVG 描边进度同样非合成（改占位层/重画路径）⇒ tick 路径。
+  "strokeProgress",
+  // ★★渐变 v2（2026-10-01）：色标混合是 paint 状态（改 shader/渐变层），且 lerp 只在
+  //   内核一处 ⇒ 两端一致走 tick（与颜色同类决策）。
+  "gradientMix",
+  // ★★路径变形 v1（2026-10-01）：改的是**几何**（宿主每帧重建平台 path），且 lerp 只在
+  //   内核一处（宿主只翻译变形后的段）⇒ 必走 tick（与描边同族但更重）。
+  "pathMorph",
+  // ★★发光强度（glow v1）：改的是 paint 状态（分层描边 alpha）——非合成，走 tick。
+  "glowIntensity",
+  // ★★遮罩进度（mask v1）：改的是**合成状态**（layer.mask / saveLayer+DST_IN）——非合成，走 tick。
+  "maskProgress",
+  // ★★倾斜（skew v1）：两端都不是"一等属性"（Android 无 setSkewX / iOS 无倾斜属性）
+  //   ⇒ 平台插值器无从谈起 ⇒ 统一 tick（与 rotateX/Y 同一推理）。
+  "skewX",
+  "skewY"
+];
+function isTickOnly(kind) {
+  return TICK_ONLY_KINDS.includes(kind);
+}
+function isComposited(kind) {
+  return COMPOSITED_KINDS.includes(kind);
+}
+function checkCurveBezier(d, i, issues) {
+  const cb = d.curveBezier;
+  if (cb === void 0) return;
+  if (!Array.isArray(cb) || cb.length !== 4) {
+    issues.push({
+      index: i,
+      code: "invalid-range",
+      message: `\`curveBezier\` \u9700\u8981 4 \u4E2A\u63A7\u5236\u70B9 [x1,y1,x2,y2]\uFF0C\u6536\u5230 ${JSON.stringify(cb)}`,
+      hint: "\u4F8B\uFF1AcurveBezier: [0.34, 1.56, 0.64, 1]\uFF08\u56DE\u5F39\uFF09\u6216 [0.2, 0, 0, 1]"
+    });
+    return;
+  }
+  const bad = cb.some((v) => typeof v !== "number" || !Number.isFinite(v));
+  if (bad) {
+    issues.push({ index: i, code: "invalid-range", message: `\`curveBezier\` \u542B\u975E\u6709\u9650\u6570\uFF1A${JSON.stringify(cb)}`, hint: "\u7ED9\u5177\u4F53\u6570\u503C" });
+    return;
+  }
+  if (cb[0] < 0 || cb[0] > 1 || cb[2] < 0 || cb[2] > 1) {
+    issues.push({
+      index: i,
+      code: "invalid-range",
+      message: `\`curveBezier\` \u7684 x1/x2 \u5FC5\u987B\u5728 [0,1]\uFF08\u65F6\u95F4\u8F74\u5355\u8C03\u2014\u2014\u5426\u5219\u7ED9\u5B9A\u8FDB\u5EA6\u6C42\u503C\u4E0D\u552F\u4E00\uFF09\uFF1Ax1=${cb[0]}, x2=${cb[2]}`,
+      hint: "y1/y2 \u53EF\u4EE5\u4EFB\u610F\uFF08> 1 \u6216 < 0 \u662F\u56DE\u5F39/\u9884\u671F\u6548\u679C\uFF09\uFF1B\u53EA\u6709 x \u53D7\u9650\uFF08CSS cubic-bezier \u540C\u89C4\uFF09"
+    });
+  }
+  if (d.curve !== void 0) {
+    issues.push({
+      index: i,
+      code: "conflicting-easing",
+      message: "`curveBezier` \u4E0E `curve` \u5E76\u5B58 \u2014\u2014 \u4E24\u5904\u90FD\u63CF\u8FF0\u7F13\u52A8\uFF0C\u5FC5\u987B\u552F\u4E00",
+      hint: "\u5220\u6389 `curve`\uFF08\u5C01\u95ED\u96C6\u5FEB\u6377\u540D\uFF09\uFF0C\u53EA\u7559 `curveBezier`"
+    });
+  }
+  if (d.spring !== void 0) {
+    issues.push({
+      index: i,
+      code: "conflicting-easing",
+      message: "`curveBezier` \u4E0E `spring` \u5E76\u5B58 \u2014\u2014 \u6C42\u503C\u6A21\u5F0F\u5FC5\u987B\u552F\u4E00",
+      hint: "\u4E8C\u9009\u4E00\uFF1A\u8981\u7269\u7406\u624B\u611F\u7528 `spring`\uFF0C\u8981\u786E\u5B9A\u66F2\u7EBF\u7528 `curveBezier`"
+    });
+  }
+  if (d.keyframes !== void 0) {
+    issues.push({
+      index: i,
+      code: "conflicting-easing",
+      message: "`curveBezier` \u4E0E `keyframes` \u5E76\u5B58 \u2014\u2014 \u6BB5\u7EA7\u66F2\u7EBF\u76EE\u524D\u53EA\u7528\u5C01\u95ED\u96C6\uFF08\u8BDA\u5B9E\u8FB9\u754C\uFF09",
+      hint: "\u5220\u6389 `curveBezier`\uFF08\u591A\u6BB5\u5E8F\u5217\u91CC\u6BCF\u6BB5\u7528 `curve` \u5C01\u95ED\u96C6\uFF09\uFF0C\u6216\u6539\u7528\u5355\u6BB5 + `curveBezier`"
+    });
+  }
+}
+function validateAnimations(decls) {
+  const issues = [];
+  if (decls.length === 0) {
+    issues.push({
+      index: -1,
+      code: "empty",
+      message: "\u52A8\u753B\u58F0\u660E\u4E3A\u7A7A",
+      hint: '\u81F3\u5C11\u7ED9\u4E00\u6761\u58F0\u660E\uFF1B\u82E5\u672C\u610F\u662F"\u505C\u6389\u52A8\u753B"\uFF0C\u8BF7\u8C03 stopAnimations \u800C\u4E0D\u662F\u7F16\u8BD1\u7A7A\u6279\u6B21'
+    });
+    return issues;
+  }
+  decls.forEach((d, i) => {
+    if (d.kind === "color" || d.kind === "textColor") {
+      if (d.from === void 0) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: '`color` \u52A8\u753B\u7684 `from` \u662F**\u5FC5\u586B**\uFF08\u5185\u6838\u6CA1\u6709"\u7F3A\u7701 = \u8282\u70B9\u5F53\u524D\u5E95\u8272"\u8BED\u4E49\uFF09',
+          hint: "\u663E\u5F0F\u7ED9\u8D77\u70B9\uFF0C\u5982 from: '#2f6fed'\uFF08\u901A\u5E38\u53D6\u8BE5\u8282\u70B9\u7684 backgroundColor\uFF09"
+        });
+      }
+      for (const [key, val] of [
+        ["from", d.from],
+        ["to", d.to]
+      ]) {
+        if (val === void 0) continue;
+        try {
+          parseColorToChannels(val);
+        } catch (e) {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: `\`color\` \u7684 \`${key}\` \u975E\u6CD5\uFF1A${e.message}`,
+            hint: "\u7528\u5341\u516D\u8FDB\u5236\uFF1A'#RGB' / '#RRGGBB' / '#RRGGBBAA'\uFF08CSS4 \u5E8F\uFF0C\u6700\u540E\u4E24\u4F4D\u662F alpha\uFF09"
+          });
+        }
+      }
+      if (d.keyframes) {
+        const kf = d.keyframes;
+        if (kf.length === 0) {
+          issues.push({
+            index: i,
+            code: "empty",
+            message: "`keyframes` \u4E3A\u7A7A\u6570\u7EC4\uFF08\u5E8F\u5217\u81F3\u5C11\u8981\u4E00\u6BB5\uFF1B\u5355\u6BB5\u8BF7\u76F4\u63A5\u7528 `curve`\uFF09",
+            hint: "\u53BB\u6389 `keyframes` \u7528\u5355\u6BB5\u58F0\u660E\uFF0C\u6216\u8865\u4E0A\u81F3\u5C11\u4E00\u6BB5 `{ to, durationMs }`"
+          });
+        }
+        const sum = kf.reduce((acc, seg) => acc + (Number.isFinite(seg.durationMs) ? seg.durationMs : 0), 0);
+        kf.forEach((seg, j) => {
+          try {
+            parseColorToChannels(seg.to);
+          } catch (e) {
+            issues.push({
+              index: i,
+              code: "invalid-range",
+              message: `\u989C\u8272\u5E8F\u5217\u7B2C ${j} \u6BB5 \`to\` \u975E\u6CD5\uFF1A${e.message}`,
+              hint: "\u6BCF\u6BB5\u7EC8\u70B9\u90FD\u8981\u662F\u989C\u8272\uFF1A'#RGB' / '#RRGGBB' / '#RRGGBBAA'"
+            });
+          }
+          if (!Number.isFinite(seg.durationMs) || seg.durationMs < 0) {
+            issues.push({
+              index: i,
+              code: "invalid-range",
+              message: `\u989C\u8272\u5E8F\u5217\u7B2C ${j} \u6BB5 \`durationMs\` \u975E\u6CD5\uFF1A${seg.durationMs}`,
+              hint: "\u7ED9\u975E\u8D1F\u6BEB\u79D2\u6570\uFF080 = \u8BE5\u6BB5\u77AC\u53D8\uFF0C\u5408\u6CD5\u4F46\u901A\u5E38\u4E0D\u662F\u672C\u610F\uFF09"
+            });
+          }
+          if (seg.curve !== void 0 && !(seg.curve in CURVE_ID)) {
+            issues.push({
+              index: i,
+              code: "invalid-range",
+              message: `\u989C\u8272\u5E8F\u5217\u7B2C ${j} \u6BB5\u66F2\u7EBF\u672A\u77E5\uFF1A${seg.curve}`,
+              hint: "\u7528 Curve \u5C01\u95ED\u96C6\u91CC\u7684\u540D\u5B57"
+            });
+          }
+        });
+        if (sum <= 0) {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: "\u989C\u8272\u5E8F\u5217\u603B\u65F6\u957F\u4E3A 0 \u2014\u2014 \u52A8\u753B\u4F1A**\u77AC\u95F4\u8DF3\u5230\u672B\u6BB5\u7EC8\u70B9**",
+            hint: '\u81F3\u5C11\u7ED9\u4E00\u6BB5\u6B63\u65F6\u957F\uFF1B\u96F6\u65F6\u957F\u5E8F\u5217\u5728\u771F\u673A\u4E0A\u770B\u8D77\u6765\u5C31\u662F"\u6CA1\u505A\u52A8\u753B"'
+          });
+        }
+        if (d.spring !== void 0) {
+          issues.push({
+            index: i,
+            code: "conflicting-easing",
+            message: "`keyframes` \u4E0E `spring` \u5E76\u5B58 \u2014\u2014 \u6C42\u503C\u6A21\u5F0F\u5FC5\u987B\u552F\u4E00",
+            hint: "\u5E8F\u5217\u91CC\u8981\u5F39\u6027\u624B\u611F\uFF0C\u628A\u67D0\u4E00\u6BB5\u7528\u66F2\u7EBF\u8FD1\u4F3C\uFF08\u5982 springApprox\uFF09\uFF0C\u6216\u6574\u6761\u6539\u7528 spring"
+          });
+        }
+        if (d.curve !== void 0) {
+          issues.push({
+            index: i,
+            code: "conflicting-easing",
+            message: "`keyframes` \u4E0E `curve` \u5E76\u5B58 \u2014\u2014 \u6BB5\u5185\u66F2\u7EBF\u7531\u6BCF\u6BB5\u81EA\u5DF1\u7684 `curve` \u51B3\u5B9A",
+            hint: "\u5220\u6389\u5916\u5C42\u7684 `curve`\uFF08\u5B83\u53EA\u5BF9\u5355\u6BB5\u6A21\u5F0F\u6709\u610F\u4E49\uFF09"
+          });
+        }
+        const last = kf[kf.length - 1];
+        if (last && last.to.toLowerCase() !== d.to.toLowerCase()) {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: `\u672B\u6BB5 \`to\`(${last.to}) \u4E0E\u58F0\u660E \`to\`(${d.to}) \u4E0D\u4E00\u81F4 \u2014\u2014 \u4E24\u5904\u90FD\u63CF\u8FF0"\u7EC8\u70B9"`,
+            hint: "\u8BA9\u4E8C\u8005\u76F8\u7B49\uFF08\u7F16\u8BD1\u5668\u4EE5\u58F0\u660E `to` \u4E3A\u51C6\u505A\u7AEF\u70B9\u9489\u6B7B\uFF0C\u4E0D\u4E00\u81F4\u4F1A\u8BA9\u7EC8\u503C\u4E0E\u4F60\u5199\u7684\u4E0D\u7B26\uFF09"
+          });
+        }
+      }
+      if (d.curve !== void 0 && d.spring !== void 0) {
+        issues.push({
+          index: i,
+          code: "conflicting-easing",
+          message: "\u540C\u65F6\u58F0\u660E\u4E86 `curve` \u4E0E `spring` \u2014\u2014 \u6C42\u503C\u6A21\u5F0F\u5FC5\u987B\u552F\u4E00",
+          hint: "\u4E8C\u9009\u4E00\uFF1A\u8981\u7269\u7406\u624B\u611F\u7528 `spring`\uFF0C\u8981\u786E\u5B9A\u66F2\u7EBF\u7528 `curve`"
+        });
+      }
+      if (d.spring) {
+        const s = d.spring;
+        const bad = !Number.isFinite(s.stiffness) || s.stiffness <= 0 || !Number.isFinite(s.damping) || s.damping < 0 || s.mass !== void 0 && (!Number.isFinite(s.mass) || s.mass <= 0);
+        if (bad) {
+          issues.push({
+            index: i,
+            code: "invalid-spring",
+            message: `\u5F39\u7C27\u53C2\u6570\u975E\u6CD5\uFF1A${JSON.stringify(s)}\uFF08\u8981\u6C42 stiffness>0 \xB7 damping\u22650 \xB7 mass>0\uFF09`,
+            hint: "\u7528\u9884\u8BBE\uFF08presets.easing.snappy / smooth\uFF09\u907F\u514D\u624B\u8C03\uFF1B\u5185\u6838\u6709 10s \u5B89\u5168\u4E0A\u9650\u515C\u5E95\u4F46\u90A3\u662F\u515C\u5E95\u4E0D\u662F\u8BBE\u8BA1"
+          });
+        }
+      }
+      if (d.durationMs !== void 0 && (!Number.isFinite(d.durationMs) || d.durationMs < 0)) {
+        issues.push({ index: i, code: "invalid-range", message: `\`durationMs\` \u975E\u6CD5\uFF1A${d.durationMs}`, hint: "\u7ED9\u975E\u8D1F\u6BEB\u79D2\u6570" });
+      }
+      if (d.delayMs !== void 0 && (!Number.isFinite(d.delayMs) || d.delayMs < 0)) {
+        issues.push({ index: i, code: "invalid-range", message: `\`delayMs\` \u975E\u6CD5\uFF1A${d.delayMs}`, hint: "\u7ED9\u975E\u8D1F\u6BEB\u79D2\u6570" });
+      }
+      if (d.scroll) {
+        const { from, to } = d.scroll;
+        if (!Number.isFinite(from) || !Number.isFinite(to)) {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: `\u6EDA\u52A8\u7A97\u53E3\u542B\u975E\u6709\u9650\u503C\uFF1A${JSON.stringify(d.scroll)}`,
+            hint: "\u7A97\u53E3\u4E24\u7AEF\u90FD\u8981\u662F\u5177\u4F53\u7684\u6EDA\u52A8\u4F4D\u7F6E\uFF08px\uFF09"
+          });
+        } else if (to <= from) {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: `\u6EDA\u52A8\u7A97\u53E3\u9000\u5316\uFF08to=${to} <= from=${from}\uFF09\u2014\u2014\u8FDB\u5EA6\u5C06\u6052\u4E3A 1\uFF0C\u52A8\u753B\u4E00\u5F00\u59CB\u5C31\u505C\u5728\u7EC8\u70B9`,
+            hint: "\u68C0\u67E5 from/to \u662F\u5426\u5199\u53CD\uFF1B\u7A97\u53E3\u8DE8\u5EA6\u5E94\u4E3A\u6B63\u6570\uFF08\u5982 from: 0, to: 120\uFF09"
+          });
+        }
+      }
+      checkCurveBezier(d, i, issues);
+      {
+        const dd = d;
+        if (dd.repeat !== void 0) {
+          const badNum = typeof dd.repeat === "number" && (!Number.isFinite(dd.repeat) || dd.repeat < 1);
+          if (dd.repeat !== "infinite" && (typeof dd.repeat !== "number" || badNum)) {
+            issues.push({
+              index: i,
+              code: "invalid-range",
+              message: `\`repeat\` \u975E\u6CD5\uFF1A${JSON.stringify(dd.repeat)}\uFF08\u5E94 \u2265 1 \u7684\u6570\u5B57\uFF0C\u6216 'infinite'\uFF09`,
+              hint: "\u4F8B\uFF1Arepeat: 3 \xB7 repeat: 'infinite'\uFF08\u547C\u5438\u706F\u7684\u5E95\u8272\u5FAA\u73AF\uFF09"
+            });
+          }
+          if ((dd.repeat === "infinite" || typeof dd.repeat === "number" && dd.repeat > 1) && dd.scroll) {
+            issues.push({
+              index: i,
+              code: "conflicting-easing",
+              message: '`repeat` \u4E0E `scroll` \u5E76\u5B58 \u2014\u2014 \u6EDA\u52A8\u9A71\u52A8\u7684\u8FDB\u5EA6\u6765\u81EA\u4F4D\u7F6E\uFF0C\u6CA1\u6709"\u8F6E"\u7684\u6982\u5FF5',
+              hint: "\u53BB\u6389 `repeat`"
+            });
+          }
+        }
+        if (dd.direction !== void 0 && dd.direction !== "normal" && dd.direction !== "alternate") {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: `\`direction\` \u975E\u6CD5\uFF1A${JSON.stringify(dd.direction)}`,
+            hint: "yoyo \u5F80\u590D\u7528 direction: 'alternate'"
+          });
+        }
+      }
+      return;
+    }
+    if (d.kind === "clip" && d.scroll) {
+      const { from: sfrom, to: sto } = d.scroll;
+      if (!Number.isFinite(sfrom) || !Number.isFinite(sto)) {
+        issues.push({ index: i, code: "invalid-range", message: "\u6EDA\u52A8\u7A97\u53E3\u542B\u975E\u6709\u9650\u6570", hint: "from/to \u90FD\u5E94\u662F\u6709\u9650 px" });
+      } else if (sto <= sfrom) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: `\u6EDA\u52A8\u7A97\u53E3\u9000\u5316\uFF08to=${sto} <= from=${sfrom}\uFF09\u2014\u2014\u8FDB\u5EA6\u5C06\u6052\u4E3A 1`,
+          hint: "\u68C0\u67E5 from/to \u662F\u5426\u5199\u53CD\uFF1B\u7A97\u53E3\u8DE8\u5EA6\u5E94\u4E3A\u6B63\u6570"
+        });
+      }
+    }
+    if (d.kind === "clip") {
+      const cd = d;
+      const n = cd.to?.length ?? 0;
+      if (!Array.isArray(cd.to) || n === 0) {
+        issues.push({
+          index: i,
+          code: "empty",
+          message: "`clip` \u58F0\u660E\u7684 `to` \u4E3A\u7A7A\u2014\u2014\u81F3\u5C11\u7ED9\u4E00\u4E2A\u53C2\u6570",
+          hint: "inset 4 \u4E2A\uFF08top/right/bottom/left\uFF09\xB7 circle 3 \u4E2A\uFF08cx/cy/r\uFF09\xB7 polygon \u5076\u6570\u4E2A\uFF08\u226416\uFF0C\u6700\u591A 8 \u70B9\uFF09"
+        });
+      } else if (n > 16) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: `\`clip\` \u53C2\u6570\u8FC7\u591A\uFF1A${n} \u4E2A\uFF08\u6700\u591A 16 = 8 \u4E2A\u9876\u70B9\uFF09\u2014\u2014\u5185\u6838\u53EA\u6709 16 \u4E2A\u53C2\u6570\u69FD`,
+          hint: "polygon \u6700\u591A 8 \u4E2A\u9876\u70B9\uFF0816 \u4E2A\u6570\uFF09\uFF1B\u66F4\u590D\u6742\u7684\u5F62\u72B6\u8BF7\u62C6\u6210\u591A\u4E2A\u8282\u70B9\u6216\u8D70\u9003\u751F\u53E3\u767B\u8BB0"
+        });
+      }
+      if (!Array.isArray(cd.from) || cd.from.length < n) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: `\`clip\` \u7684 \`from\` \u53C2\u6570\u4E0D\u8DB3\uFF1A\u9700\u8981 ${n} \u4E2A\uFF08\u4E0E \`to\` \u5BF9\u9F50\uFF09\uFF0C\u6536\u5230 ${cd.from?.length ?? 0} \u4E2A`,
+          hint: '\u5185\u6838\u6CA1\u6709"\u7F3A\u7701 = \u5F53\u524D\u503C"\u8BED\u4E49\uFF08\u4E0E\u989C\u8272\u540C\u4E00\u6761\u7EAA\u5F8B\uFF09\u2014\u2014\u8D77\u70B9\u5FC5\u987B\u663E\u5F0F\u7ED9\u51FA'
+        });
+      }
+      const badNum = (arr) => Array.isArray(arr) && arr.some((v) => typeof v !== "number" || !Number.isFinite(v));
+      if (badNum(cd.from) || badNum(cd.to)) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: "`clip` \u53C2\u6570\u542B\u975E\u6709\u9650\u6570\uFF08NaN / Infinity\uFF09",
+          hint: "\u53C2\u6570\u662F\u76D2\u5206\u6570\uFF080..1 \u5E38\u89C1\uFF0C\u53EF\u8D1F = \u5916\u6269\uFF09\u2014\u2014\u7ED9\u5177\u4F53\u6570\u503C"
+        });
+      }
+      if (cd.keyframes) {
+        for (const [j, seg] of cd.keyframes.entries()) {
+          if (!Array.isArray(seg.to) || seg.to.length < n) {
+            issues.push({
+              index: i,
+              code: "invalid-range",
+              message: `\`clip\` \u5E8F\u5217\u7B2C ${j} \u6BB5\u53C2\u6570\u4E0D\u8DB3\uFF1A\u9700\u8981 ${n} \u4E2A\uFF0C\u6536\u5230 ${seg.to?.length ?? 0} \u4E2A`,
+              hint: "\u6BCF\u6BB5 `to` \u90FD\u662F\u5B8C\u6574\u7684\u53C2\u6570\u6570\u7EC4\uFF08\u4E0E\u58F0\u660E `to` \u5BF9\u9F50\uFF09"
+            });
+          }
+        }
+      }
+      checkCurveBezier(d, i, issues);
+      if (d.curve !== void 0 && d.spring !== void 0) {
+        issues.push({
+          index: i,
+          code: "conflicting-easing",
+          message: "`clip` \u7684 `curve` \u4E0E `spring` \u5E76\u5B58 \u2014\u2014 \u6C42\u503C\u6A21\u5F0F\u5FC5\u987B\u552F\u4E00",
+          hint: "\u4E8C\u9009\u4E00\uFF1A\u8981\u7269\u7406\u624B\u611F\u7528 `spring`\uFF0C\u8981\u786E\u5B9A\u66F2\u7EBF\u7528 `curve`"
+        });
+      }
+      if (cd.keyframes && d.spring !== void 0) {
+        issues.push({
+          index: i,
+          code: "conflicting-easing",
+          message: "`clip` \u7684 `keyframes` \u4E0E `spring` \u5E76\u5B58 \u2014\u2014 \u6C42\u503C\u6A21\u5F0F\u5FC5\u987B\u552F\u4E00",
+          hint: "\u4E8C\u9009\u4E00\uFF08\u4E0E\u6807\u91CF/\u989C\u8272\u540C\u89C4\u5219\uFF09"
+        });
+      }
+      return;
+    }
+    checkCurveBezier(d, i, issues);
+    {
+      const dd = d;
+      if (dd.repeat !== void 0) {
+        const badNum = typeof dd.repeat === "number" && (!Number.isFinite(dd.repeat) || dd.repeat < 1);
+        if (dd.repeat !== "infinite" && (typeof dd.repeat !== "number" || badNum)) {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: `\`repeat\` \u975E\u6CD5\uFF1A${JSON.stringify(dd.repeat)}\uFF08\u5E94 \u2265 1 \u7684\u6570\u5B57\uFF0C\u6216 'infinite'\uFF09`,
+            hint: "\u4F8B\uFF1Arepeat: 3\uFF08\u64AD\u4E09\u904D\uFF09\xB7 repeat: 'infinite'\uFF08\u65E0\u9650\uFF09"
+          });
+        }
+        if ((dd.repeat === "infinite" || typeof dd.repeat === "number" && dd.repeat > 1) && dd.scroll) {
+          issues.push({
+            index: i,
+            code: "conflicting-easing",
+            message: '`repeat` \u4E0E `scroll` \u5E76\u5B58 \u2014\u2014 \u6EDA\u52A8\u9A71\u52A8\u7684\u8FDB\u5EA6\u6765\u81EA\u4F4D\u7F6E\uFF0C\u6CA1\u6709"\u8F6E"\u7684\u6982\u5FF5',
+            hint: "\u53BB\u6389 `repeat`\uFF08\u6EDA\u52A8\u8054\u52A8\u5929\u7136\u968F\u4F4D\u7F6E\u5F80\u590D\uFF09"
+          });
+        }
+      }
+      if (dd.direction !== void 0 && dd.direction !== "normal" && dd.direction !== "alternate") {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: `\`direction\` \u975E\u6CD5\uFF1A${JSON.stringify(dd.direction)}\uFF08\u5E94 'normal' / 'alternate'\uFF09`,
+          hint: "yoyo \u5F80\u590D\u7528 direction: 'alternate'"
+        });
+      }
+    }
+    const dup = decls.slice(0, i).find((p) => p.kind === d.kind);
+    if (dup) {
+      issues.push({
+        index: i,
+        code: "duplicate-kind",
+        message: `\u540C\u4E00\u6279\u6B21\u91CC \`${d.kind}\` \u51FA\u73B0\u4E86\u591A\u6B21\uFF08\u5185\u6838\u5BF9\u540C (\u8282\u70B9,\u5C5E\u6027) \u662F**\u66FF\u6362**\u8BED\u4E49 \u21D2 \u540E\u8005\u4F1A\u9759\u9ED8\u66FF\u6362\u524D\u8005\uFF09`,
+        hint: "\u591A\u6BB5\u5E8F\u5217\u8BF7\u7528 `keyframes`\uFF08\u4E00\u6761\u52A8\u753B\u5185\u5206\u6BB5\uFF0C\u5185\u6838 AnimMode::Keyframes\uFF09\uFF1B\u6216\u62C6\u6210\u4E24\u6B21\u8C03\u7528\uFF1B\u6216\u6539\u7528\u4E0D\u540C\u5C5E\u6027\u7EC4\u5408\uFF08\u5982 scale + opacity \u540C\u65F6\u8FDB\u884C\uFF09"
+      });
+    }
+    if (d.keyframes) {
+      const kf = d.keyframes;
+      if (kf.length === 0) {
+        issues.push({
+          index: i,
+          code: "empty",
+          message: "`keyframes` \u4E3A\u7A7A\u6570\u7EC4\uFF08\u5E8F\u5217\u81F3\u5C11\u8981\u4E00\u6BB5\uFF1B\u5355\u6BB5\u8BF7\u76F4\u63A5\u7528 `curve`\uFF09",
+          hint: "\u53BB\u6389 `keyframes` \u7528\u5355\u6BB5\u58F0\u660E\uFF0C\u6216\u8865\u4E0A\u81F3\u5C11\u4E00\u6BB5 `{ to, durationMs }`"
+        });
+      }
+      const sum = kf.reduce((acc, s) => acc + (Number.isFinite(s.durationMs) ? s.durationMs : 0), 0);
+      kf.forEach((s, j) => {
+        if (!Number.isFinite(s.to)) {
+          issues.push({ index: i, code: "invalid-range", message: `\u5E8F\u5217\u7B2C ${j} \u6BB5 \`to\` \u975E\u6709\u9650\u6570`, hint: "\u7ED9\u5177\u4F53\u6570\u503C" });
+        }
+        if (!Number.isFinite(s.durationMs) || s.durationMs < 0) {
+          issues.push({
+            index: i,
+            code: "invalid-range",
+            message: `\u5E8F\u5217\u7B2C ${j} \u6BB5 \`durationMs\` \u975E\u6CD5\uFF1A${s.durationMs}`,
+            hint: "\u7ED9\u975E\u8D1F\u6BEB\u79D2\u6570\uFF080 = \u8BE5\u6BB5\u77AC\u53D8\uFF0C\u5408\u6CD5\u4F46\u901A\u5E38\u4E0D\u662F\u672C\u610F\uFF09"
+          });
+        }
+        if (s.curve !== void 0 && !(s.curve in CURVE_ID)) {
+          issues.push({ index: i, code: "invalid-range", message: `\u5E8F\u5217\u7B2C ${j} \u6BB5\u66F2\u7EBF\u672A\u77E5\uFF1A${s.curve}`, hint: "\u7528 Curve \u5C01\u95ED\u96C6\u91CC\u7684\u540D\u5B57" });
+        }
+      });
+      if (sum <= 0) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: "\u5E8F\u5217\u603B\u65F6\u957F\u4E3A 0 \u2014\u2014 \u52A8\u753B\u4F1A**\u77AC\u95F4\u8DF3\u5230\u672B\u6BB5\u7EC8\u70B9**",
+          hint: '\u81F3\u5C11\u7ED9\u4E00\u6BB5\u6B63\u65F6\u957F\uFF1B\u96F6\u65F6\u957F\u5E8F\u5217\u5728\u771F\u673A\u4E0A\u770B\u8D77\u6765\u5C31\u662F"\u6CA1\u505A\u52A8\u753B"'
+        });
+      }
+      if (d.spring !== void 0) {
+        issues.push({
+          index: i,
+          code: "conflicting-easing",
+          message: "`keyframes` \u4E0E `spring` \u5E76\u5B58 \u2014\u2014 \u6C42\u503C\u6A21\u5F0F\u5FC5\u987B\u552F\u4E00",
+          hint: "\u5E8F\u5217\u91CC\u8981\u5F39\u6027\u624B\u611F\uFF0C\u628A\u67D0\u4E00\u6BB5\u7528\u66F2\u7EBF\u8FD1\u4F3C\uFF08\u5982 springApprox\uFF09\uFF0C\u6216\u6574\u6761\u6539\u7528 spring"
+        });
+      }
+      if (d.curve !== void 0) {
+        issues.push({
+          index: i,
+          code: "conflicting-easing",
+          message: "`keyframes` \u4E0E `curve` \u5E76\u5B58 \u2014\u2014 \u6BB5\u5185\u66F2\u7EBF\u7531\u6BCF\u6BB5\u81EA\u5DF1\u7684 `curve` \u51B3\u5B9A",
+          hint: "\u5220\u6389\u5916\u5C42\u7684 `curve`\uFF08\u5B83\u53EA\u5BF9\u5355\u6BB5\u6A21\u5F0F\u6709\u610F\u4E49\uFF09"
+        });
+      }
+      const last = kf[kf.length - 1];
+      if (last && Number.isFinite(last.to) && Number.isFinite(d.to) && last.to !== d.to) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: `\u672B\u6BB5 \`to\`(${last.to}) \u4E0E\u58F0\u660E \`to\`(${d.to}) \u4E0D\u4E00\u81F4 \u2014\u2014 \u4E24\u5904\u90FD\u63CF\u8FF0"\u7EC8\u70B9"`,
+          hint: "\u8BA9\u4E8C\u8005\u76F8\u7B49\uFF08\u7F16\u8BD1\u5668\u4EE5\u58F0\u660E `to` \u4E3A\u51C6\u505A\u7AEF\u70B9\u9489\u6B7B\uFF0C\u4E0D\u4E00\u81F4\u4F1A\u8BA9\u7EC8\u503C\u4E0E\u4F60\u5199\u7684\u4E0D\u7B26\uFF09"
+        });
+      }
+    }
+    if (!isComposited(d.kind) && !isTickOnly(d.kind)) {
+      issues.push({
+        index: i,
+        code: "non-composited",
+        message: `\`${d.kind}\` \u4E0D\u662F\u5408\u6210\u5C5E\u6027 \u2014\u2014 \u4F1A\u89E6\u53D1\u5E73\u53F0\u5E03\u5C40\u94FE\u8DEF\uFF08requestLayout / \u5E03\u5C40\u91CD\u7B97\uFF09\uFF0C\u5E73\u53F0\u6E32\u67D3\u7EBF\u7A0B\u7684\u5F02\u6B65\u7EA2\u5229**\u5B8C\u5168\u5931\u6548**`,
+        hint: '\u6539\u7528\u5408\u6210\u5C5E\u6027\uFF1A\u4F4D\u79FB\u7528 translateX/Y\u3001\u7F29\u653E\u7528 scale\u3001\u65CB\u8F6C\u7528 rotate\u3001\u900F\u660E\u5EA6\u7528 opacity\uFF1B\u5982\u679C\u8981\u52A8\u7684\u662F"\u5E03\u5C40\u8BA9\u4F4D"\uFF0C\u8BF7\u8D70 FLIP\uFF08presets.list.shift\uFF09'
+      });
+    }
+    if (!Number.isFinite(d.to)) {
+      issues.push({ index: i, code: "invalid-range", message: "`to` \u4E0D\u662F\u6709\u9650\u6570", hint: "\u7ED9\u4E00\u4E2A\u5177\u4F53\u7684\u6570\u503C\u76EE\u6807" });
+    }
+    if (d.from !== void 0 && !Number.isFinite(d.from)) {
+      issues.push({ index: i, code: "invalid-range", message: "`from` \u4E0D\u662F\u6709\u9650\u6570", hint: "\u7701\u7565 `from` \u8BA9\u5185\u6838\u53D6\u8282\u70B9\u5F53\u524D\u503C" });
+    }
+    const isSpring = d.spring !== void 0;
+    if (isSpring && d.curve !== void 0) {
+      issues.push({
+        index: i,
+        code: "conflicting-easing",
+        message: "\u540C\u65F6\u58F0\u660E\u4E86 `curve` \u4E0E `spring` \u2014\u2014 \u6C42\u503C\u6A21\u5F0F\u5FC5\u987B\u552F\u4E00",
+        hint: "\u4E8C\u9009\u4E00\uFF1A\u8981\u7269\u7406\u624B\u611F\u7528 `spring`\uFF0C\u8981\u786E\u5B9A\u66F2\u7EBF\u7528 `curve`"
+      });
+    }
+    if (d.durationMs !== void 0 && (!Number.isFinite(d.durationMs) || d.durationMs < 0)) {
+      issues.push({ index: i, code: "invalid-range", message: `\`durationMs\` \u975E\u6CD5\uFF1A${d.durationMs}`, hint: "\u7ED9\u975E\u8D1F\u6BEB\u79D2\u6570" });
+    }
+    if (d.delayMs !== void 0 && (!Number.isFinite(d.delayMs) || d.delayMs < 0)) {
+      issues.push({ index: i, code: "invalid-range", message: `\`delayMs\` \u975E\u6CD5\uFF1A${d.delayMs}`, hint: "\u7ED9\u975E\u8D1F\u6BEB\u79D2\u6570" });
+    }
+    if (isSpring) {
+      const s = d.spring;
+      const bad = !Number.isFinite(s.stiffness) || s.stiffness <= 0 || !Number.isFinite(s.damping) || s.damping < 0 || s.mass !== void 0 && (!Number.isFinite(s.mass) || s.mass <= 0);
+      if (bad) {
+        issues.push({
+          index: i,
+          code: "invalid-spring",
+          message: `\u5F39\u7C27\u53C2\u6570\u975E\u6CD5\uFF1A${JSON.stringify(s)}\uFF08\u8981\u6C42 stiffness>0 \xB7 damping\u22650 \xB7 mass>0\uFF09`,
+          hint: "\u7528\u9884\u8BBE\uFF08presets.easing.snappy / smooth\uFF09\u907F\u514D\u624B\u8C03\uFF1B\u5185\u6838\u6709 10s \u5B89\u5168\u4E0A\u9650\u515C\u5E95\u4F46\u90A3\u662F\u515C\u5E95\u4E0D\u662F\u8BBE\u8BA1"
+        });
+      }
+    }
+    if (d.scroll) {
+      const { from, to } = d.scroll;
+      if (!Number.isFinite(from) || !Number.isFinite(to)) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: `\u6EDA\u52A8\u7A97\u53E3\u542B\u975E\u6709\u9650\u503C\uFF1A${JSON.stringify(d.scroll)}`,
+          hint: "\u7A97\u53E3\u4E24\u7AEF\u90FD\u8981\u662F\u5177\u4F53\u7684\u6EDA\u52A8\u4F4D\u7F6E\uFF08px\uFF09"
+        });
+      } else if (to <= from) {
+        issues.push({
+          index: i,
+          code: "invalid-range",
+          message: `\u6EDA\u52A8\u7A97\u53E3\u9000\u5316\uFF08to=${to} <= from=${from}\uFF09\u2014\u2014\u8FDB\u5EA6\u5C06\u6052\u4E3A 1\uFF0C\u52A8\u753B\u4E00\u5F00\u59CB\u5C31\u505C\u5728\u7EC8\u70B9`,
+          hint: "\u68C0\u67E5 from/to \u662F\u5426\u5199\u53CD\uFF1B\u7A97\u53E3\u8DE8\u5EA6\u5E94\u4E3A\u6B63\u6570\uFF08\u5982 from: 0, to: 120\uFF09"
+        });
+      }
+    }
+    if (d.scroll && d.spring) {
+      issues.push({
+        index: i,
+        code: "conflicting-easing",
+        message: "\u6EDA\u52A8\u9A71\u52A8\u4E0E\u5F39\u7C27\u7269\u7406\u5E76\u5B58 \u2014\u2014 \u5F39\u7C27\u7684\u8FDB\u5EA6\u53C2\u6570\u5728\u6EDA\u52A8\u9A71\u52A8\u4E0B\u65E0\u610F\u4E49\uFF08\u5185\u6838\u6309\u4F4D\u7F6E\u6362\u7B97\u8FDB\u5EA6\u540E\u8D70\u66F2\u7EBF\u6C42\u503C\uFF09",
+        hint: "\u6EDA\u52A8\u8054\u52A8\u8BF7\u7528 `curve`\uFF08\u5982 easeOut / linear\uFF09\uFF1B\u5F39\u7C27\u7559\u7ED9\u65F6\u95F4\u9A71\u52A8\u7684\u52A8\u753B"
+      });
+    }
+  });
+  return issues;
+}
+function compileAnimations(decls, targets, opts) {
+  const issues = validateAnimations(decls);
+  if (issues.length > 0) {
+    const detail = issues.map((i) => `[${i.code}] #${i.index} ${i.message} \u2192 ${i.hint}`).join("; ");
+    throw new Error(
+      `Morpheus \u52A8\u753B\u58F0\u660E\u6821\u9A8C\u5931\u8D25\uFF1A${detail}
+  \u21D2 \u82E5\u5C01\u95ED\u96C6\u786E\u5B9E\u8868\u8FBE\u4E0D\u4E86\uFF0C\u8D70**\u663E\u5F0F\u9003\u751F\u53E3**\uFF08\`escapes.register({kind, detail, reason, behaviorRisk})\`\uFF09\u2014\u2014\u53EF\u7528\u4F46\u5FC5\u987B\u767B\u8BB0\u5E76\u63A5\u53D7 degraded \u98CE\u9669\uFF08Morpheus \xA74.2\uFF09\uFF0C\u4E0D\u8981\u7ED5\u8FC7\u6846\u67B6\u3002`
+    );
+  }
+  const anims = decls.flatMap((d) => compileOne(d, targets));
+  opts?.escapes?.noteDeclarative(anims.length);
+  const kindNames = new Set(decls.map((d) => d.kind));
+  const composited = [...kindNames].every((k) => isComposited(k));
+  return {
+    anims,
+    composited,
+    // ★颜色两类（color / textColor）都是 paint-only 非合成 ⇒ 如实列进清单
+    nonComposited: composited ? [] : [...kindNames].filter((k) => !isComposited(k))
+  };
+}
+function isColorDecl(d) {
+  return d.kind === "color" || d.kind === "textColor";
+}
+function isClipDecl(d) {
+  return d.kind === "clip";
+}
+function compileOne(d, targets) {
+  const easing2 = resolveEasing(d);
+  if (isClipDecl(d)) {
+    const n = Math.min(16, d.to.length);
+    if (n === 0) {
+      throw new Error("\u88C1\u526A\u58F0\u660E `to` \u4E3A\u7A7A\u2014\u2014\u81F3\u5C11\u7ED9\u4E00\u4E2A\u53C2\u6570\uFF08inset\u22654 / circle\u22653 / polygon \u5076\u6570\u4E2A\uFF09");
+    }
+    const from = d.from;
+    if (from.length < n) {
+      throw new Error(
+        `\u88C1\u526A\u58F0\u660E \`from\` \u53C2\u6570\u4E0D\u8DB3\uFF1A\u9700\u8981 ${n} \u4E2A\uFF08\u4E0E \`to\` \u5BF9\u9F50\uFF09\uFF0C\u6536\u5230 ${from.length} \u4E2A\uFF08\u5185\u6838\u6CA1\u6709"\u7F3A\u7701 = \u5F53\u524D\u503C"\u8BED\u4E49\u2014\u2014\u8D77\u70B9\u5FC5\u987B\u663E\u5F0F\u7ED9\u51FA\uFF09`
+      );
+    }
+    const kf = d.keyframes?.map((seg) => ({ seg, to: seg.to.length >= n ? seg.to : seg.to }));
+    const mkClip = (slot) => ({
+      nodeId: targets.nodeId,
+      // ★通道编号 = 15 + 槽位（契约：CLIP0 = 15，见 types.ts AnimKind）
+      kind: 15 + slot,
+      curve: easing2.curve,
+      clipSlot: slot,
+      ...d.curveBezier ? { curveBezier: d.curveBezier } : {},
+      from: from[slot] ?? 0,
+      to: d.to[slot] ?? 0,
+      durMs: easing2.durMs,
+      delayMs: d.delayMs ?? 0,
+      // ★★滚动驱动（长卷探索补）：与标量/颜色同字段同语义（内核 `start_scroll` 支持任意 kind）
+      drive: d.drive === "progress" ? 1 : 0,
+      ...d.scroll ? { scrollFrom: d.scroll.from, scrollTo: d.scroll.to } : {},
+      takeover: d.takeover !== false,
+      ...d.spring ? { spring: { stiffness: d.spring.stiffness, damping: d.spring.damping, mass: d.spring.mass ?? 1 } } : {},
+      ...kf ? {
+        keyframes: kf.map(({ seg }) => ({
+          to: seg.to[slot] ?? 0,
+          durMs: seg.durationMs,
+          curve: CURVE_ID[seg.curve ?? "easeOut"]
+        }))
+      } : {},
+      ...d.repeat !== void 0 ? {
+        repeat: d.repeat === "infinite" ? -1 : d.repeat,
+        ...d.direction === "alternate" ? { alternate: true } : {}
+      } : {}
+    });
+    const out = [];
+    for (let slot = 0; slot < n; slot++) out.push(mkClip(slot));
+    return out;
+  }
+  if (isColorDecl(d)) {
+    const from = parseColorToChannels(d.from);
+    const to = parseColorToChannels(d.to);
+    const base = d.kind === "color" ? [AnimKind.COLOR_R, AnimKind.COLOR_G, AnimKind.COLOR_B, AnimKind.COLOR_A] : [AnimKind.TEXT_COLOR_R, AnimKind.TEXT_COLOR_G, AnimKind.TEXT_COLOR_B, AnimKind.TEXT_COLOR_A];
+    const kf = d.keyframes?.map((seg) => {
+      const ch = parseColorToChannels(seg.to);
+      return { ch, durMs: seg.durationMs, curve: CURVE_ID[seg.curve ?? "easeOut"] };
+    });
+    const mc = d;
+    const mk = (kind, idx) => {
+      const f = [from.r, from.g, from.b, from.a][idx];
+      const t = [to.r, to.g, to.b, to.a][idx];
+      return {
+        nodeId: targets.nodeId,
+        kind,
+        curve: easing2.curve,
+        // ★自定义贝塞尔：**展开到四条通道**（同一控制点 ⇒ 同一条曲线——颜色不能分通道变缓动）
+        ...mc.curveBezier ? { curveBezier: mc.curveBezier } : {},
+        from: f,
+        to: t,
+        durMs: easing2.durMs,
+        delayMs: d.delayMs ?? 0,
+        drive: d.drive === "progress" ? 1 : 0,
+        takeover: d.takeover !== false,
+        ...d.spring ? { spring: { stiffness: d.spring.stiffness, damping: d.spring.damping, mass: d.spring.mass ?? 1 } } : {},
+        ...kf ? {
+          keyframes: kf.map(({ ch, durMs, curve }) => ({
+            to: [ch.r, ch.g, ch.b, ch.a][idx],
+            durMs,
+            curve
+          }))
+        } : {},
+        ...d.scroll ? { scrollFrom: d.scroll.from, scrollTo: d.scroll.to } : {},
+        // ★A2 循环：四条通道**都要带**（少一条通道不循环 = 颜色分叉——经典静默缺陷）
+        ...d.repeat !== void 0 ? {
+          repeat: d.repeat === "infinite" ? -1 : d.repeat,
+          ...d.direction === "alternate" ? { alternate: true } : {}
+        } : {}
+      };
+    };
+    return [mk(base[0], 0), mk(base[1], 1), mk(base[2], 2), mk(base[3], 3)];
+  }
+  return [
+    {
+      nodeId: targets.nodeId,
+      kind: ANIM_KIND_ID[d.kind],
+      curve: easing2.curve,
+      // ★自定义贝塞尔（给了它内核求值优先于 `curve` id——见内核 `Anim::curve_at`）
+      ...d.curveBezier ? { curveBezier: d.curveBezier } : {},
+      from: d.from ?? 0,
+      to: d.to,
+      durMs: easing2.durMs,
+      delayMs: d.delayMs ?? 0,
+      drive: d.drive === "progress" ? 1 : 0,
+      takeover: d.takeover !== false,
+      ...d.spring ? { spring: { stiffness: d.spring.stiffness, damping: d.spring.damping, mass: d.spring.mass ?? 1 } } : {},
+      // ★MA6：序列（每段曲线在编译期落定；durMs = 各段之和 ⇒ 内核用它做时间→进度换算）
+      ...d.keyframes ? {
+        keyframes: d.keyframes.map((s) => ({
+          to: s.to,
+          durMs: s.durationMs,
+          curve: CURVE_ID[s.curve ?? "easeOut"]
+        }))
+      } : {},
+      // ★MA5：滚动窗口（内核据 scrollTo > scrollFrom 判定为滚动驱动）
+      ...d.scroll ? { scrollFrom: d.scroll.from, scrollTo: d.scroll.to } : {},
+      // ★A2 循环（`'infinite'` → -1 哨兵；`direction` 只在有 repeat 时下发——不污染线格式）
+      ...d.repeat !== void 0 ? {
+        repeat: d.repeat === "infinite" ? -1 : d.repeat,
+        ...d.direction === "alternate" ? { alternate: true } : {}
+      } : {}
+    }
+  ];
+}
+function resolveEasing(d) {
+  if (d.keyframes) {
+    const sum = d.keyframes.reduce((acc, s) => acc + s.durationMs, 0);
+    return { curve: CURVE_ID[d.curve ?? "easeOut"], durMs: d.durationMs ?? sum };
+  }
+  if (d.spring) {
+    return { curve: CURVE_ID.easeOut, durMs: d.durationMs ?? 1e3 };
+  }
+  return { curve: CURVE_ID[d.curve ?? "easeOut"], durMs: d.durationMs ?? 300 };
+}
+var easing = {
+  /** 快速、微回弹（对齐 iOS `.snappy`） */
+  snappy: { stiffness: 320, damping: 30, mass: 1 },
+  /** 顺滑、几乎无回弹（对齐 iOS `.smooth`） */
+  smooth: { stiffness: 180, damping: 26, mass: 1 }
+};
+var FONT_5X7 = {
+  A: [".###.", "#...#", "#...#", "#####", "#...#", "#...#", "#...#"],
+  B: ["####.", "#...#", "#...#", "####.", "#...#", "#...#", "####."],
+  C: [".###.", "#...#", "#....", "#....", "#....", "#...#", ".###."],
+  D: ["####.", "#...#", "#...#", "#...#", "#...#", "#...#", "####."],
+  E: ["#####", "#....", "#....", "####.", "#....", "#....", "#####"],
+  F: ["#####", "#....", "#....", "####.", "#....", "#....", "#...."],
+  G: [".###.", "#...#", "#....", "#.###", "#...#", "#...#", ".###."],
+  H: ["#...#", "#...#", "#...#", "#####", "#...#", "#...#", "#...#"],
+  I: ["#####", "..#..", "..#..", "..#..", "..#..", "..#..", "#####"],
+  J: ["..###", "...#.", "...#.", "...#.", "...#.", "#..#.", ".##.."],
+  K: ["#...#", "#..#.", "#.#..", "##...", "#.#..", "#..#.", "#...#"],
+  L: ["#....", "#....", "#....", "#....", "#....", "#....", "#####"],
+  M: ["#...#", "##.##", "#.#.#", "#.#.#", "#...#", "#...#", "#...#"],
+  N: ["#...#", "##..#", "#.#.#", "#..##", "#...#", "#...#", "#...#"],
+  O: [".###.", "#...#", "#...#", "#...#", "#...#", "#...#", ".###."],
+  P: ["####.", "#...#", "#...#", "####.", "#....", "#....", "#...."],
+  Q: [".###.", "#...#", "#...#", "#...#", "#.#.#", "#..#.", ".##.#"],
+  R: ["####.", "#...#", "#...#", "####.", "#.#..", "#..#.", "#...#"],
+  S: [".####", "#....", "#....", ".###.", "....#", "....#", "####."],
+  T: ["#####", "..#..", "..#..", "..#..", "..#..", "..#..", "..#.."],
+  U: ["#...#", "#...#", "#...#", "#...#", "#...#", "#...#", ".###."],
+  V: ["#...#", "#...#", "#...#", "#...#", "#...#", ".#.#.", "..#.."],
+  W: ["#...#", "#...#", "#...#", "#.#.#", "#.#.#", "##.##", "#...#"],
+  X: ["#...#", "#...#", ".#.#.", "..#..", ".#.#.", "#...#", "#...#"],
+  Y: ["#...#", "#...#", ".#.#.", "..#..", "..#..", "..#..", "..#.."],
+  Z: ["#####", "....#", "...#.", "..#..", ".#...", "#....", "#####"],
+  "0": [".###.", "#...#", "#..##", "#.#.#", "##..#", "#...#", ".###."],
+  "1": ["..#..", ".##..", "..#..", "..#..", "..#..", "..#..", ".###."],
+  "2": [".###.", "#...#", "....#", "...#.", "..#..", ".#...", "#####"],
+  "3": ["#####", "...#.", "..#..", "...#.", "....#", "#...#", ".###."],
+  "4": ["...#.", "..##.", ".#.#.", "#..#.", "#####", "...#.", "...#."],
+  "5": ["#####", "#....", "####.", "....#", "....#", "#...#", ".###."],
+  "6": ["..##.", ".#...", "#....", "####.", "#...#", "#...#", ".###."],
+  "7": ["#####", "....#", "...#.", "..#..", ".#...", ".#...", ".#..."],
+  "8": [".###.", "#...#", "#...#", ".###.", "#...#", "#...#", ".###."],
+  "9": [".###.", "#...#", "#...#", ".####", "....#", "...#.", ".##.."],
+  " ": [".....", ".....", ".....", ".....", ".....", ".....", "....."],
+  "-": [".....", ".....", ".....", "#####", ".....", ".....", "....."],
+  "!": ["..#..", "..#..", "..#..", "..#..", "..#..", ".....", "..#.."],
+  "?": [".###.", "#...#", "....#", "...#.", "..#..", ".....", "..#.."]
+};
+var GLYPH_ADVANCE = 6;
+var GLYPH_HEIGHT = 7;
+var LINE_GAP = 1;
+function textBitmap(text) {
+  const up = text.toUpperCase();
+  const lines = up.split("\n");
+  const lineWidth = (s) => (Math.max(s.length, 1) - 1) * GLYPH_ADVANCE + 5;
+  const widths = lines.map(lineWidth);
+  const width = Math.max(...widths, 5);
+  const height = lines.length * GLYPH_HEIGHT + (lines.length - 1) * LINE_GAP;
+  const lit = [];
+  lines.forEach((line, li) => {
+    const xBase = Math.floor((width - widths[li]) / 2);
+    const yBase = li * (GLYPH_HEIGHT + LINE_GAP);
+    for (let ci = 0; ci < line.length; ci++) {
+      const ch = line[ci];
+      const glyph = FONT_5X7[ch] ?? FONT_5X7[" "];
+      const x0 = xBase + ci * GLYPH_ADVANCE;
+      for (let y = 0; y < GLYPH_HEIGHT; y++) {
+        const row = glyph[y] ?? ".....";
+        for (let x = 0; x < 5; x++) {
+          if (row[x] === "#") lit.push({ x: x0 + x, y: yBase + y });
+        }
+      }
+    }
+  });
+  return { width, height, lit, text: up };
+}
+function staggerRanks(n, cols, order = "index") {
+  const ranks = new Array(n);
+  if (n === 0) return ranks;
+  const c = Math.max(1, cols);
+  const rowOf = (i) => Math.floor(i / c);
+  const colOf = (i) => i % c;
+  switch (order) {
+    case "index":
+      for (let i = 0; i < n; i++) ranks[i] = i;
+      return ranks;
+    case "diagonal": {
+      const keyed = Array.from({ length: n }, (_, i) => ({ i, key: rowOf(i) + colOf(i) }));
+      keyed.sort((a, b) => a.key - b.key || a.i - b.i);
+      keyed.forEach((e, k) => ranks[e.i] = k);
+      return ranks;
+    }
+    case "serpentine": {
+      const rows = Math.ceil(n / c);
+      let k = 0;
+      for (let r = 0; r < rows; r++) {
+        const lo = r * c;
+        const hi = Math.min(lo + c, n);
+        if (r % 2 === 0) {
+          for (let i = lo; i < hi; i++) ranks[i] = k++;
+        } else {
+          for (let i = hi - 1; i >= lo; i--) ranks[i] = k++;
+        }
+      }
+      return ranks;
+    }
+    case "radialOut":
+    case "radialIn": {
+      const rows = Math.ceil(n / c);
+      const cx = (c - 1) / 2;
+      const cy = (rows - 1) / 2;
+      const keyed = Array.from({ length: n }, (_, i) => ({
+        i,
+        key: Math.hypot(colOf(i) - cx, rowOf(i) - cy)
+      }));
+      keyed.sort(
+        (a, b) => order === "radialOut" ? a.key - b.key || a.i - b.i : b.key - a.key || a.i - b.i
+      );
+      keyed.forEach((e, k) => ranks[e.i] = k);
+      return ranks;
+    }
+    case "alternate": {
+      const half = Math.ceil(n / 2);
+      let even = 0;
+      let odd = half;
+      for (let i = 0; i < n; i++) ranks[i] = i % 2 === 0 ? even++ : odd++;
+      return ranks;
+    }
+  }
+}
+function compileChoreography(spec) {
+  const { ids, canvas, make } = spec;
+  const n = ids.length;
+  const c = Math.max(1, canvas.cols);
+  const ranks = staggerRanks(n, c, spec.order ?? "index");
+  const staggerMs = spec.staggerMs ?? 0;
+  const out = [];
+  for (let i = 0; i < n; i++) {
+    const nth = ranks[i] ?? i;
+    const delayMs = nth * staggerMs;
+    const ctx = {
+      i,
+      n,
+      row: Math.floor(i / c),
+      col: i % c,
+      nth,
+      delayMs,
+      at: canvas.centers?.[i] ?? { x: 0, y: 0 }
+    };
+    const decls = make(ctx).map((d) => ({ ...d, delayMs: (d.delayMs ?? 0) + delayMs }));
+    try {
+      out.push(...compileAnimations(decls, { nodeId: ids[i] }).anims);
+    } catch (e) {
+      throw new Error(`\u7F16\u6392\u7B2C ${i} \u7247\uFF08nodeId=${ids[i]}\uFF09\u7F16\u8BD1\u5931\u8D25\uFF1A${e.message}`);
+    }
+  }
+  return out;
+}
+function hash01(seed) {
+  const s = Math.sin(seed * 127.1 + 311.7) * 43758.5453;
+  return s - Math.floor(s);
+}
+function viewCenter(view) {
+  return { x: view.width / 2, y: view.height / 2 };
+}
+function needCenters(canvas, who) {
+  const cs = canvas.centers;
+  if (!cs || cs.length === 0) {
+    throw new Error(
+      `${who} \u9700\u8981 \`canvas.centers\`\uFF08\u6BCF\u7247\u5F53\u524D\u4E2D\u5FC3\uFF09\u2014\u2014\u4F4D\u79FB\u91CF = \u76EE\u6807 \u2212 \u5F53\u524D\uFF0C\u5F15\u64CE\u4E0D\u731C\u5F53\u524D\u5728\u54EA\u3002\u8BF7\u5148\u4ECE\u5185\u6838\u51E0\u4F55\u8BFB\u56DE\uFF08\u5BBF\u4E3B \`rects()\`\uFF09\u518D\u4F20\u5165\u3002`
+    );
+  }
+  return cs;
+}
+var specOf = (scene) => (make) => ({
+  ids: scene.ids,
+  canvas: scene.canvas,
+  order: scene.order,
+  staggerMs: scene.staggerMs,
+  make
+});
+var choreograph = {
+  /**
+   * **波浪**：每片从 `from` 偏移处弹回布局位（spring 物理），随相位错峰扫过。
+   * 方向由 `dir` 决定（`down` = 从上方向下扫；`up` = 从下方向上托）。
+   */
+  wave(scene) {
+    const mag = scene.magnitude ?? 260;
+    const from = scene.dir === "up" ? mag : -mag;
+    const spring = scene.spring ?? easing.smooth;
+    const fadeMs = scene.fadeMs ?? 220;
+    return compileChoreography(
+      specOf(scene)(() => [
+        { kind: "translateY", from, to: 0, spring },
+        { kind: "opacity", from: 0, to: 1, curve: "easeOut", durationMs: fadeMs }
+      ])
+    );
+  },
+  /**
+   * **涟漪**：从中心向外逐圈脉冲——scale（放大回弹）+ opacity（压暗回暖），
+   * `radialOut` 相位天然形成"一圈圈推出去"的节奏。
+   */
+  ripple(scene) {
+    const peak = scene.peak ?? 1.35;
+    const dip = scene.dip ?? 0.5;
+    const half = (scene.durationMs ?? 760) / 2;
+    return compileChoreography(
+      specOf(scene)(() => [
+        {
+          kind: "scale",
+          from: 1,
+          to: 1,
+          keyframes: [
+            { to: peak, durationMs: half, curve: "easeOut" },
+            { to: 1, durationMs: half, curve: "easeInOut" }
+          ]
+        },
+        {
+          kind: "opacity",
+          from: 1,
+          to: 1,
+          keyframes: [
+            { to: dip, durationMs: half, curve: "easeOut" },
+            { to: 1, durationMs: half, curve: "easeInOut" }
+          ]
+        }
+      ])
+    );
+  },
+  /**
+   * **漩涡**：每片沿渐开线收向视口中心（`turns` 圈），同时旋转 + 缩小。
+   * 位移量 = 目标 − **当前**（centers 由调用方从内核几何读回——重排之后也能算对）。
+   */
+  spiral(scene) {
+    const turns = scene.turns ?? 3;
+    const rMin = scene.rMin ?? 0.05;
+    const rMax = scene.rMax ?? 0.9;
+    const toScale = scene.toScale ?? 0.35;
+    const durationMs = scene.durationMs ?? 900;
+    const curve = scene.curve ?? "easeInOut";
+    const view = scene.canvas.view;
+    const centers = needCenters(scene.canvas, "choreograph.spiral");
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const center = viewCenter(view);
+        const rad0 = Math.min(view.width, view.height) / 2;
+        const ang = c.i / Math.max(1, c.n) * Math.PI * 2 * turns;
+        const rad = rad0 * (rMin + (rMax - rMin) * (c.i / Math.max(1, c.n)));
+        const tx = center.x + Math.cos(ang) * rad - centers[c.i].x;
+        const ty = center.y + Math.sin(ang) * rad - centers[c.i].y;
+        return [
+          { kind: "translateX", from: 0, to: tx, curve, durationMs },
+          { kind: "translateY", from: 0, to: ty, curve, durationMs },
+          {
+            kind: "rotate",
+            from: 0,
+            to: (c.i % 2 === 0 ? 1 : -1) * (180 + c.i / Math.max(1, c.n) * 540),
+            curve,
+            durationMs
+          },
+          { kind: "scale", from: 1, to: toScale, curve, durationMs }
+        ];
+      })
+    );
+  },
+  /**
+   * **归位**：一切变换回到"布局位"（translate/rotate → 0、scale → 1），按相位错峰。
+   * 幕间清理用它——把上一幕留下的姿态收干净。
+   *
+   * ★起点来自 `canvas.attitudes`（**必须提供**）：内核的 `from` 是必填量，缺省落 0——
+   *   若不给当前姿态，"归位"会**瞬移归零**（不是收回去）。传 `attitudes: []`（空数组）
+   *   等价于"已在基线"（此时本预设等于无操作，调用方可跳过）。
+   */
+  settle(scene) {
+    const durationMs = scene.durationMs ?? 700;
+    const curve = scene.curve ?? "easeInOut";
+    const attitudes = scene.canvas.attitudes;
+    if (!attitudes) {
+      throw new Error(
+        "choreograph.settle \u9700\u8981 `canvas.attitudes`\uFF08\u6BCF\u7247\u5F53\u524D\u59FF\u6001\uFF09\u2014\u2014\u5185\u6838\u7684 `from` \u662F\u5FC5\u586B\u91CF\uFF0C\u4E0D\u7ED9\u5F53\u524D\u59FF\u6001\u4F1A**\u77AC\u79FB\u5F52\u96F6**\u800C\u4E0D\u662F\u6536\u56DE\u3002\u8BF7\u4F20\u5165\u4E0A\u4E00\u5E55\u7684\u7EC8\u6001\uFF08\u8BB0\u8D26\u6216\u5B9E\u8BFB\uFF1B\u89C1 `ChoreoAttitude` \u6CE8\u91CA\uFF09\u3002"
+      );
+    }
+    const withOpacity = scene.opacity ?? true;
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const a = attitudes[c.i] ?? {};
+        const decls = [
+          { kind: "translateX", from: a.tx ?? 0, to: 0, curve, durationMs },
+          { kind: "translateY", from: a.ty ?? 0, to: 0, curve, durationMs },
+          { kind: "rotate", from: a.rotate ?? 0, to: 0, curve, durationMs },
+          { kind: "scale", from: a.scale ?? 1, to: 1, curve, durationMs }
+        ];
+        if (withOpacity) {
+          decls.push({ kind: "opacity", from: a.opacity ?? 1, to: 1, curve, durationMs });
+        }
+        return decls;
+      })
+    );
+  },
+  /**
+   * **多米诺**：每片"翻过去再弹回"（rotate 用 keyframes 两段；奇偶反向），
+   * `serpentine` 相位形成掠过感。
+   */
+  domino(scene) {
+    const tilt = scene.tilt ?? 26;
+    const fallMs = scene.fallMs ?? 150;
+    const riseMs = scene.riseMs ?? 430;
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const dir = c.i % 2 === 0 ? 1 : -1;
+        return [
+          {
+            kind: "rotate",
+            from: 0,
+            to: 0,
+            keyframes: [
+              { to: dir * tilt, durationMs: fallMs, curve: "easeIn" },
+              { to: 0, durationMs: riseMs, curve: "springApprox" }
+            ]
+          },
+          {
+            kind: "scale",
+            from: 1,
+            to: 1,
+            keyframes: [
+              { to: 0.82, durationMs: fallMs, curve: "easeIn" },
+              { to: 1, durationMs: riseMs, curve: "springApprox" }
+            ]
+          }
+        ];
+      })
+    );
+  },
+  /**
+   * ★★**聚字**：把元素聚成点阵文字（`bitmap-font.ts` 的 5×7 字形；支持 `\n` 多行）。
+   *
+   * 分工：前 `lit.length` 片各就一个**亮像素**（放大显示）；其余成为**星尘**
+   * （确定性散布在文字四周的椭圆环上——同输入同画面）。
+   * 元素数 < 亮像素数时按序取前几片（文字会缺笔画——由调用方保证规模，
+   * 判据端有"亮像素数 ≤ 元素数"的检查）。
+   *
+   * ★**点距与点大小**（真机截图两轮打磨的结果）：
+   *   · 点距 `gap = min(宽比/矩阵宽, 高比/矩阵高)`——**受限于较紧的一边**；
+   *     单行 9 字（53 列）时点距只有 ~6.6px（整屏才 390px）⇒ 想要"字大"要么少字、要么**分两行**；
+   *   · 点尺寸给了 `elemPx`（元素原始边长）时**自动**按 `fill×gap` 推导（默认 80% 填充度）——
+   *     手填 `pixelScale` 时点会随点距变化忽大忽小（点距 6.6 时 0.42 几乎粘连、
+   *     点距 20 时又变成一盘散沙——两轮真机截图都抓到了）。
+   */
+  text(scene) {
+    const bm = textBitmap(scene.text);
+    if (bm.lit.length === 0) throw new Error(`choreograph.text\uFF1A\u6587\u672C "${scene.text}" \u6CA1\u6709\u4EFB\u4F55\u4EAE\u50CF\u7D20\uFF08\u5B57\u7B26\u5168\u5728\u5B57\u5E93\u5916\uFF1F\uFF09`);
+    const view = scene.canvas.view;
+    const centers = needCenters(scene.canvas, "choreograph.text");
+    const widthRatio = scene.widthRatio ?? 0.9;
+    const heightRatio = scene.heightRatio ?? 0.5;
+    const durationMs = scene.durationMs ?? 900;
+    const curve = scene.curve ?? "easeInOut";
+    const gap = Math.min(
+      view.width * widthRatio / Math.max(1, bm.width),
+      view.height * heightRatio / Math.max(1, bm.height)
+    );
+    const fill = scene.fill ?? 0.8;
+    const pixelScale = scene.pixelScale ?? (scene.elemPx && scene.elemPx > 0 ? Math.max(0.12, Math.min(1, fill * gap / scene.elemPx)) : 0.42);
+    const x0 = (view.width - (bm.width - 1) * gap) / 2;
+    const y0 = (view.height - (bm.height - 1) * gap) / 2;
+    const center = viewCenter(view);
+    const lit = bm.lit.length;
+    return compileChoreography(
+      specOf(scene)((c) => {
+        let target;
+        let scale;
+        let opacity;
+        if (c.i < lit) {
+          const p = bm.lit[c.i];
+          target = { x: x0 + p.x * gap, y: y0 + p.y * gap };
+          scale = pixelScale;
+          opacity = 1;
+        } else {
+          const h1 = hash01(c.i);
+          const h2 = hash01(c.i + 977);
+          const h3 = hash01(c.i + 1543);
+          const ang = h1 * Math.PI * 2;
+          const rx = view.width * (0.36 + 0.06 * h2);
+          const ry = view.height * (0.26 + 0.05 * h3);
+          target = { x: center.x + Math.cos(ang) * rx, y: center.y + Math.sin(ang) * ry };
+          scale = Math.max(0.14, pixelScale * (0.42 + 0.3 * h2));
+          opacity = 0.14 + 0.26 * h3;
+        }
+        return [
+          { kind: "translateX", from: 0, to: target.x - centers[c.i].x, curve, durationMs },
+          { kind: "translateY", from: 0, to: target.y - centers[c.i].y, curve, durationMs },
+          { kind: "scale", from: 1, to: scale, curve, durationMs },
+          { kind: "opacity", from: 1, to: opacity, curve, durationMs }
+        ];
+      })
+    );
+  },
+  /**
+   * **汇聚**：每片沿"屏心 → 自己"的径向外推 `spread` 倍后飞回（开场"星尘凝聚"；
+   * `spread` ≥ 2 时起点已在屏外）。spring 物理。
+   */
+  gather(scene) {
+    const spread = scene.spread ?? 2.6;
+    const spring = scene.spring ?? easing.smooth;
+    const fadeMs = scene.fadeMs ?? 260;
+    const centers = needCenters(scene.canvas, "choreograph.gather");
+    const center = viewCenter(scene.canvas.view);
+    return compileChoreography(
+      specOf(scene)((c) => [
+        { kind: "translateX", from: (centers[c.i].x - center.x) * spread, to: 0, spring },
+        { kind: "translateY", from: (centers[c.i].y - center.y) * spread, to: 0, spring },
+        { kind: "opacity", from: 0, to: 1, curve: "easeOut", durationMs: fadeMs }
+      ])
+    );
+  },
+  /**
+   * **风暴**：五属性并发（位移抖动 + 大幅旋转 + 收放 + 呼吸），`alternate` 相位两班倒。
+   * 这是单帧负载最重的一幕（800×5 = 4000 条指令并发）——压力上限的代表。
+   */
+  storm(scene) {
+    const durationMs = scene.durationMs ?? 900;
+    const spread = scene.spread ?? 90;
+    const shrink = scene.shrink ?? 0.45;
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const h1 = hash01(c.i * 1.7);
+        const h2 = hash01(c.i * 2.3 + 11);
+        const h3 = hash01(c.i * 3.1 + 29);
+        return [
+          { kind: "translateX", from: 0, to: (h1 - 0.5) * spread, curve: "easeInOut", durationMs },
+          { kind: "translateY", from: 0, to: (h2 - 0.5) * spread, curve: "easeInOut", durationMs },
+          {
+            kind: "rotate",
+            from: 0,
+            to: (c.i % 2 === 0 ? 1 : -1) * (360 + h3 * 360),
+            curve: "easeInOut",
+            durationMs
+          },
+          { kind: "scale", from: 1, to: shrink + h1 * 0.3, curve: "easeInOut", durationMs },
+          { kind: "opacity", from: 1, to: 0.72, curve: "easeInOut", durationMs }
+        ];
+      })
+    );
+  },
+  /* ────────────────────────── 颜色编排（2026-10-01 · 灯光秀抽出） ──────────────────────────
+   *
+   * 【为什么这批是**通用预设**（而不是节目单私有的循环）】它们全部走 `compileChoreography`
+   *   的 make 回调——与 wave/ripple 同一形态、同一编译链（同一份校验/线格式）。
+   *   灯光秀是第一个消费面，但"颜色 + 相位编排"是通用需求（霓虹标题/状态灯/节奏带），
+   *   收敛到本包 = 一份实现（纪律 #22：第 N 份手写相位循环 = 下一个静默缺陷）。
+   *   ★颜色声明按通道展开（一次声明 → 4 条标量指令）由 `compileAnimations` 保证。 */
+  /**
+   * **闪烁**：`from →（峰值闪）→ to` 一次往返，附 scale 脉冲（"灯亮起"的物理感）。
+   *
+   * 相位错峰由 `order × staggerMs` 决定——`radialOut` = 从中心向外逐个点亮（点火），
+   * `serpentine` = 蛇形扫过（斜扫）。
+   */
+  flash(scene) {
+    const peak = scene.peak ?? "#ffffff";
+    const flashMs = scene.flashMs ?? 160;
+    const fallMs = scene.fallMs ?? 620;
+    const pulse = scene.pulse ?? 1.18;
+    const dur = flashMs + fallMs;
+    return compileChoreography(
+      specOf(scene)(() => {
+        const decls = [
+          {
+            kind: "color",
+            from: scene.from,
+            to: scene.to,
+            durationMs: dur,
+            keyframes: [
+              { to: peak, durationMs: flashMs, curve: "easeOut" },
+              { to: scene.to, durationMs: fallMs, curve: "easeInOut" }
+            ]
+          }
+        ];
+        if (pulse !== 1) {
+          decls.push({
+            kind: "scale",
+            from: 1,
+            to: 1,
+            durationMs: dur,
+            keyframes: [
+              { to: pulse, durationMs: flashMs, curve: "easeOut" },
+              { to: 1, durationMs: fallMs, curve: "easeInOut" }
+            ]
+          });
+        }
+        return decls;
+      })
+    );
+  },
+  /**
+   * **色环**：每片走同一个多段色序列（`from → colors… → to`），相位错峰形成流动色带。
+   *
+   * `staggerMs = 0` 时全场同步（"呼吸"：`colors = [亮, 暗, 亮, 暗]`）；
+   * 错峰时是流动的彩虹（灯光秀 rainbow 幕）。
+   */
+  cycle(scene) {
+    const segMs = scene.segMs ?? 240;
+    return compileChoreography(
+      specOf(scene)(() => [
+        {
+          kind: "color",
+          from: scene.from,
+          to: scene.to,
+          durationMs: segMs * scene.colors.length,
+          keyframes: scene.colors.map((c) => ({ to: c, durationMs: segMs, curve: "easeInOut" }))
+        }
+      ])
+    );
+  },
+  /**
+   * **极光带**：整行同色、行间错峰（行内 0 相位）——横向光带自上而下流过。
+   *
+   * 与 `cycle` 的差别：相位**按行**（同一行的灯严格同拍）而不是按片的 `order` 名次——
+   * 行内错峰会打散"光带"的横线形态。行色缺省是 青→蓝→紫 三角波（冷色调）。
+   */
+  aurora(scene) {
+    const rowMs = scene.rowMs ?? 40;
+    const hold = scene.holdMs ?? 900;
+    const rows = Math.max(1, scene.rows);
+    const colorAt = scene.colorAt ?? defaultAuroraColor;
+    return compileChoreography({
+      ids: scene.ids,
+      canvas: scene.canvas,
+      order: "index",
+      staggerMs: 0,
+      make: (c) => {
+        const d = c.row * rowMs;
+        const rowColor = colorAt(c.row, rows);
+        return [
+          {
+            kind: "color",
+            from: scene.from,
+            to: scene.from,
+            durationMs: hold * 2,
+            delayMs: d,
+            keyframes: [
+              { to: rowColor, durationMs: hold, curve: "easeInOut" },
+              { to: scene.from, durationMs: hold, curve: "easeInOut" }
+            ]
+          }
+        ];
+      }
+    });
+  },
+  /**
+   * **染色**：纯颜色补间（`from → to`），相位错峰——"全场变某色"的一句话。
+   * 聚字/归位幕常与位置预设**同批**使用（各自独立声明，颜色与位置互不干扰）。
+   */
+  paint(scene) {
+    const durationMs = scene.durationMs ?? 700;
+    const curve = scene.curve ?? "easeInOut";
+    return compileChoreography(
+      specOf(scene)(() => [{ kind: "color", from: scene.from, to: scene.to, durationMs, curve }])
+    );
+  },
+  /* ────────────────────────── 灯阵模式（2026-10-01 · 灯光秀重构抽出） ──────────────────────────
+   *
+   * 【与上面"颜色编排"的本质差别】那批是"每片同一种色变化"（靠 `order` 相位错峰）；
+   *   这批是**灯阵语义**：每颗灯的亮/灭/色由它的**位置**（行/列/角度）决定，灯**一颗不动**——
+   *   整场演出只是"亮灯和灭灯"（真实灯光秀与 LED 矩阵屏的工作方式，用户语义修正的落点）。
+   *   ★所有预设只产出**颜色指令**（kind 5..8），不产出任何位移/缩放/旋转/透明度。
+   *   ★仍走 `compileChoreography` 同一编译链（同一份校验/线格式）。 */
+  /**
+   * ★★**灯阵点字**（"亮灯成字"——LED 矩阵屏的经典节目）：
+   *   把 `text`（5×7 点阵）渲染到灯阵上——**亮的灯** = `on` 色，**灭的灯** = `off` 色（暗盘）。
+   *   灯位保持不变，全靠亮灭组成文字。
+   *
+   * 布局：点阵水平居中；`\n` 多行纵向堆叠。每行最多 `floor((cols+1)/6)` 个字（5 列字宽 + 1 列间隔）。
+   * `blinks` > 0 时亮灯先闪烁（灭→亮交替）再定格——"霓虹招牌"的观感。
+   */
+  matrixText(scene) {
+    const on = scene.on ?? "#ffffff";
+    const resolveMs = scene.resolveMs ?? 420;
+    const bm = textBitmap(scene.text);
+    const cols = Math.max(1, scene.canvas.cols);
+    const rows = Math.max(1, Math.ceil(scene.ids.length / cols));
+    const x0 = Math.floor((cols - bm.width) / 2);
+    const y0 = Math.floor((rows - bm.height) / 2);
+    const cells = /* @__PURE__ */ new Set();
+    for (const pt of bm.lit) cells.add(pt.y * 4096 + pt.x);
+    const litOf = (i) => {
+      const gx = i % cols - x0;
+      const gy = Math.floor(i / cols) - y0;
+      return gx >= 0 && gy >= 0 && gx < bm.width && gy < bm.height && cells.has(gy * 4096 + gx);
+    };
+    const cur = (i) => scene.currentOf?.(i) ?? scene.from ?? scene.off;
+    return compileChoreography({
+      ids: scene.ids,
+      canvas: scene.canvas,
+      // ★相位错峰由 order × staggerMs 推出（compileChoreography 自动叠加 delayMs）——
+      //   波形扫过：灯一颗颗（按对角名次）解析成字，而不是整屏同时跳变
+      order: scene.order ?? "diagonal",
+      staggerMs: scene.staggerMs ?? 6,
+      make: (c) => [
+        {
+          kind: "color",
+          from: cur(c.i),
+          to: litOf(c.i) ? on : scene.off,
+          durationMs: resolveMs,
+          curve: "easeInOut"
+        }
+      ]
+    });
+  },
+  /**
+   * ★★**灯阵图案帧**（纯计算，不产出指令）：给定文本与网格，返回**每颗灯的目标色**数组——
+   *   亮盘 = `on`、灭盘 = `off`。调用方用它算下一幕的 `currentOf`（逐灯起点色）：
+   *   `matrixFrame('800', cols, n, {on, off})` 的终态 = 下一幕（如 `matrixText('LIG\nHTS')`）
+   *   `currentOf` 的输入 ⇒ **串幕零跳变**（灯从"它此刻真实的颜色"出发）。
+   */
+  matrixFrame(text, cols, n, colors) {
+    const bm = textBitmap(text);
+    const cc = Math.max(1, cols);
+    const rows = Math.max(1, Math.ceil(n / cc));
+    const x0 = Math.floor((cc - bm.width) / 2);
+    const y0 = Math.floor((rows - bm.height) / 2);
+    const cells = /* @__PURE__ */ new Set();
+    for (const pt of bm.lit) cells.add(pt.y * 4096 + pt.x);
+    const out = [];
+    for (let i = 0; i < n; i++) {
+      const gx = i % cc - x0;
+      const gy = Math.floor(i / cc) - y0;
+      const lit = gx >= 0 && gy >= 0 && gx < bm.width && gy < bm.height && cells.has(gy * 4096 + gx);
+      out.push(lit ? colors.on : colors.off);
+    }
+    return out;
+  },
+  /**
+   * **跑马灯**（边框追逐——灯会实景最常见的节目）：灯阵**外圈**的灯按顺时针次序
+   * 逐颗点亮（亮白 → 回落），内部灯保持灭。相位名次 = 沿边框的序号。
+   */
+  perimeterChase(scene) {
+    const on = scene.on ?? "#ffffff";
+    const staggerMs = scene.staggerMs ?? 16;
+    const holdMs = scene.holdMs ?? 260;
+    const from = scene.from ?? scene.off;
+    const cols = Math.max(1, scene.canvas.cols);
+    const rows = Math.max(1, Math.ceil(scene.ids.length / cols));
+    const rankOf = (i) => {
+      const r = Math.floor(i / cols);
+      const c = i % cols;
+      if (r === 0) return c;
+      if (c === cols - 1) return cols - 1 + r;
+      if (r === rows - 1) return cols - 1 + rows - 1 + (cols - 1 - c);
+      if (c === 0) return cols - 1 + rows - 1 + cols - 1 + (rows - 1 - r);
+      return -1;
+    };
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const rank = rankOf(c.i);
+        if (rank < 0) {
+          return [{ kind: "color", from, to: scene.off, durationMs: staggerMs, curve: "linear" }];
+        }
+        return [
+          {
+            kind: "color",
+            from,
+            to: scene.off,
+            durationMs: rank * staggerMs + holdMs,
+            // 等到自己那一棒：先灭着（或保持起点色），轮到时亮白，再回落
+            keyframes: [
+              { to: scene.off, durationMs: Math.max(1, rank * staggerMs), curve: "linear" },
+              { to: on, durationMs: holdMs, curve: "easeOut" },
+              { to: scene.off, durationMs: 1, curve: "linear" }
+            ]
+          }
+        ];
+      })
+    );
+  },
+  /**
+   * **光扇**（旋转光束——灯会实景的另一招牌）：一束光绕屏心**旋转扫过**，
+   * 被扫到的灯亮白、扫过即灭（角度由灯在阵中的位置推出）。
+   *
+   * 每颗灯的关键帧 = **按"该灯被光束照到的时间区间"归并**（通常 2–4 段，不是 steps 段）——
+   * 800 颗灯的总指令仍是每灯 4 条颜色通道（四通道展开）。`steps` × `stepMs` = 转一整圈的时长。
+   */
+  fan(scene) {
+    const on = scene.on ?? "#ffffff";
+    const steps = Math.max(3, scene.steps ?? 12);
+    const widthDeg = scene.widthDeg ?? 60;
+    const stepMs = scene.stepMs ?? 150;
+    const from = scene.from ?? scene.off;
+    const cols = Math.max(1, scene.canvas.cols);
+    const rows = Math.max(1, Math.ceil(scene.ids.length / cols));
+    const angOf = (i) => {
+      const r = Math.floor(i / cols);
+      const c = i % cols;
+      const x = c + 0.5 - cols / 2;
+      const y = r + 0.5 - rows / 2;
+      const a = Math.atan2(y, x) * 180 / Math.PI;
+      return (a + 360) % 360;
+    };
+    const diff = (a, b) => {
+      const d = Math.abs(a - b) % 360;
+      return d > 180 ? 360 - d : d;
+    };
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const ang = angOf(c.i);
+        const status = [];
+        for (let k2 = 0; k2 < steps; k2++) {
+          const beam = k2 * 360 / steps;
+          status.push(diff(ang, beam) <= widthDeg / 2);
+        }
+        const kf = [];
+        let k = 0;
+        while (k < steps) {
+          const s0 = status[k];
+          let j = k;
+          while (j < steps && status[j] === s0) j++;
+          kf.push({ to: s0 ? on : scene.off, durationMs: (j - k) * stepMs, curve: "linear" });
+          k = j;
+        }
+        if (kf.length === 0 || kf[kf.length - 1].to !== scene.off) {
+          kf.push({ to: scene.off, durationMs: stepMs, curve: "linear" });
+        }
+        const dur = kf.reduce((acc, x) => acc + x.durationMs, 0);
+        return [{ kind: "color", from, to: scene.off, durationMs: dur, keyframes: kf }];
+      })
+    );
+  },
+  /**
+   * **棋盘翻转**（矩阵屏经典）：亮灭按 (行+列) 的奇偶交替成棋盘格，整体**翻转 `flips` 次**
+   * 后收为全灭。
+   */
+  checker(scene) {
+    const on = scene.on ?? "#ffffff";
+    const flips = Math.max(1, scene.flips ?? 4);
+    const segMs = scene.segMs ?? 240;
+    const from = scene.from ?? scene.off;
+    const cols = Math.max(1, scene.canvas.cols);
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const kf = [];
+        for (let k = 0; k < flips; k++) {
+          const onPhase = (c.row + c.col + k) % 2 === 0;
+          kf.push({ to: onPhase ? on : scene.off, durationMs: segMs, curve: "linear" });
+        }
+        kf.push({ to: scene.off, durationMs: segMs, curve: "linear" });
+        const dur = kf.reduce((acc, x) => acc + x.durationMs, 0);
+        return [{ kind: "color", from, to: scene.off, durationMs: dur, keyframes: kf }];
+      })
+    );
+  },
+  /**
+   * **星火**（确定性闪烁）：每颗灯按确定性伪随机走 `segments` 段霓虹色，
+   * 最后收灭——"满屏灯在闪"的压力形态（800 灯 × 多段 keyframes）。
+   */
+  sparkle(scene) {
+    const palette = scene.palette.length > 0 ? scene.palette : ["#ffffff"];
+    const segments = Math.max(2, scene.segments ?? 6);
+    const segMs = scene.segMs ?? 200;
+    const from = scene.from ?? scene.off;
+    return compileChoreography(
+      specOf(scene)((c) => {
+        const kf = [];
+        for (let k = 0; k < segments; k++) {
+          const pick = palette[Math.floor(hash01(c.i * 31.7 + k * 7.3) * palette.length) % palette.length];
+          kf.push({ to: pick, durationMs: segMs, curve: "linear" });
+        }
+        kf.push({ to: scene.off, durationMs: segMs, curve: "linear" });
+        const dur = kf.reduce((acc, x) => acc + x.durationMs, 0);
+        return [{ kind: "color", from, to: scene.off, durationMs: dur, keyframes: kf }];
+      })
+    );
+  },
+  /**
+   * **扫描光幕**：一条"暗带"先自上而下压过（灯逐行暗下），紧接着"亮带"再自下而上
+   * 点亮（灯逐行亮起）——真实舞台常见的"灯光窗帘"。每行整行同拍、行间错峰 `rowMs`。
+   */
+  rowSweep(scene) {
+    const rowMs = scene.rowMs ?? 30;
+    const holdMs = scene.holdMs ?? 240;
+    const cols = Math.max(1, scene.canvas.cols);
+    return compileChoreography(
+      specOf(scene)((c) => [
+        {
+          kind: "color",
+          from: scene.from,
+          to: scene.from,
+          durationMs: c.row * rowMs + holdMs,
+          delayMs: 1,
+          keyframes: [
+            { to: scene.dim, durationMs: Math.max(1, c.row * rowMs), curve: "linear" },
+            { to: scene.from, durationMs: holdMs, curve: "easeOut" }
+          ]
+        }
+      ])
+    );
+  }
+};
+function defaultAuroraColor(row, rows) {
+  const t = row / Math.max(1, rows - 1);
+  const tri = t < 0.5 ? t * 2 : (1 - t) * 2;
+  const a = [34, 211, 238];
+  const b = [59, 130, 246];
+  const c = [168, 85, 247];
+  const mix = (x, y, u) => {
+    const f = (p, q) => Math.round(p + (q - p) * u).toString(16).padStart(2, "0");
+    return `#${f(x[0], y[0])}${f(x[1], y[1])}${f(x[2], y[2])}`;
+  };
+  return tri < 0.5 ? mix(a, b, tri * 2) : mix(b, c, (tri - 0.5) * 2);
+}
+var DUR = 300;
+var route = {
+  /**
+   * **半屏弹窗**（从底部滑入）—— 对齐 `wx://bottom-sheet`
+   *
+   * ★为什么"只动进场页"：弹窗场景下旧页面**保持不动**（背景被遮罩压暗即可）——
+   *   动它反而会让用户误以为页面在跳。这与微信 `wx://bottom-sheet` 的行为一致。
+   */
+  bottomSheet(opts = {}) {
+    const dist = opts.distance ?? 400;
+    const dur = opts.durationMs ?? DUR;
+    const enter = opts.spring ? [{ kind: "translateY", from: dist, to: 0, spring: easing.smooth }] : [{ kind: "translateY", from: dist, to: 0, curve: "easeOut", durationMs: dur }];
+    return { name: "bottomSheet", wxRouteType: "wx://bottom-sheet", enter, exit: [], opaque: false, durationMs: dur };
+  },
+  /**
+   * **全屏向上推入**（新页从下方推入，旧页被推出）—— 对齐 `wx://upwards`
+   */
+  slideUp(opts = {}) {
+    const dist = opts.distance ?? 800;
+    const dur = opts.durationMs ?? DUR;
+    const parallax = opts.exitParallax ?? 0.3;
+    return {
+      name: "slideUp",
+      wxRouteType: "wx://upwards",
+      enter: [{ kind: "translateY", from: dist, to: 0, curve: "easeOut", durationMs: dur }],
+      // 旧页向反方向让位（视差）+ 轻微淡出——这是"推入"的层次感来源
+      exit: [
+        { kind: "translateY", from: 0, to: -dist * parallax, curve: "easeOut", durationMs: dur },
+        { kind: "opacity", from: 1, to: 1 - parallax, curve: "easeOut", durationMs: dur }
+      ],
+      opaque: true,
+      durationMs: dur
+    };
+  },
+  /**
+   * **下滑关闭**（dismiss：当前页向下滑出，露出下层页）—— 对齐统一枚举的 `slideDown`
+   *
+   * 【与 `slideUp` 的方向关系】`slideUp` 是"推入"（新页从下往上），`slideDown` 是"弹出/关闭"
+   *   （当前页从上往下）——两者是**相反**的位移方向，对应统一枚举 `RouteTransition` 的两个成员
+   *   （Web 侧 `WEB_TRANSITION_MAP.slideDown = 'slide-down'`、MP 侧 `routeType: 'slideDown'`）。
+   *
+   * ★注意 `enter`/`exit` 的语义：本预设描述的是**被关闭页（exit）下滑**；
+   *   `enter` 留空（下层页本就静止——动它会让"关闭"看起来像"又推了一页"）。
+   */
+  slideDown(opts = {}) {
+    const dist = opts.distance ?? 800;
+    const dur = opts.durationMs ?? 300;
+    return {
+      name: "slideDown",
+      wxRouteType: null,
+      // ★诚实边界：微信 routeType 里没有"下滑关闭"这个预设（dismiss 由导航栈语义表达）
+      // ★★`role: 'dismiss'`（退场型）——`exit` 描述的是**被关闭页**的下滑动作（pop 语义）。
+      //   没有它时 back 推导会把 `exit` 反向绑给"返回目标页"⇒ 视觉变成"下层页升上来"（方向反了）。
+      role: "dismiss",
+      enter: [],
+      exit: [
+        { kind: "translateY", from: 0, to: dist, curve: "easeIn", durationMs: dur },
+        { kind: "opacity", from: 1, to: 0.8, curve: "easeIn", durationMs: dur }
+      ],
+      opaque: false,
+      // 下滑时下层页可见
+      durationMs: dur
+    };
+  },
+  /**
+   * **缩放下沉**（新页从底部放大进入，旧页下沉）—— 对齐 `wx://zoom`
+   */
+  zoom(opts = {}) {
+    const dur = opts.durationMs ?? DUR;
+    const sc = opts.fromScale ?? 0.92;
+    const offY = opts.fromOffsetY ?? 60;
+    return {
+      name: "zoom",
+      wxRouteType: "wx://zoom",
+      enter: [
+        { kind: "scale", from: sc, to: 1, curve: "easeOut", durationMs: dur },
+        { kind: "translateY", from: offY, to: 0, curve: "easeOut", durationMs: dur },
+        { kind: "opacity", from: 0.6, to: 1, curve: "easeOut", durationMs: dur }
+      ],
+      // 旧页"下沉"（缩小 + 变暗）——视觉上像被压到下面
+      exit: [
+        { kind: "scale", from: 1, to: 0.96, curve: "easeOut", durationMs: dur },
+        { kind: "opacity", from: 1, to: 0.7, curve: "easeOut", durationMs: dur }
+      ],
+      opaque: true,
+      durationMs: dur
+    };
+  },
+  /**
+   * **iOS 风格模态**（从底部滑入 + 轻微缩放）—— 对齐 `wx://cupertino-modal`
+   *
+   * 与 `bottomSheet` 的差别：模态是**全屏**（距离 = 屏幕高），且**带阻尼感**（弹簧）。
+   */
+  cupertinoModal(opts = {}) {
+    const dist = opts.distance ?? 800;
+    return {
+      name: "cupertinoModal",
+      wxRouteType: "wx://cupertino-modal",
+      enter: [{ kind: "translateY", from: dist, to: 0, spring: easing.smooth }],
+      exit: [{ kind: "scale", from: 1, to: 0.92, curve: "easeInOut", durationMs: 250 }],
+      opaque: true,
+      durationMs: 350
+    };
+  }
+};
+var list = {
+  /**
+   * ★★**列表项增删让位**（Morpheus §5 的招牌能力）
+   *
+   * 【为什么这一条最值钱】传统 FLIP 要**前后各读一次几何**（跨边界查询，VDOM 框架里很贵）；
+   *   而本仓几何本来就在 Rust 内核 ⇒ 两次快照都是内部读，**零跨边界、零 JS**。
+   *   配合 0.08ms 全量重排，"列表增删时其他项平滑让位"几乎白送。
+   *
+   * 用法（一句话）：
+   * ```ts
+   * const spec = presets.list.shift()          // 默认 300ms easeOut、无交错
+   * engine.flipCapture()                        // 变更前记快照
+   * applyListMutation()                         // 增删数据 → 布局变
+   * engine.flipStart(spec)                      // 启动补间
+   * ```
+   */
+  shift(opts = {}) {
+    return {
+      name: "listShift",
+      durationMs: opts.durationMs ?? 300,
+      curve: opts.curve ?? "easeOut",
+      staggerMs: opts.staggerMs ?? 0
+    };
+  }
+};
+var element = {
+  /** **淡入**（透明度 0 → 1；可加轻微上移，避免"平淡地出现"） */
+  fadeIn(opts = {}) {
+    const dur = opts.durationMs ?? 240;
+    const rise = opts.risePx ?? 0;
+    const decls = [
+      { kind: "opacity", from: 0, to: 1, curve: "easeOut", durationMs: dur, delayMs: opts.delayMs }
+    ];
+    if (rise > 0) {
+      decls.push({ kind: "translateY", from: rise, to: 0, curve: "easeOut", durationMs: dur, delayMs: opts.delayMs });
+    }
+    return { name: "fadeIn", decls, durationMs: dur };
+  },
+  /**
+   * ★★**翻牌 / 3D 旋入**（2026-10-01 · B 批）——`rotateX` / `rotateY` + 透视。
+   *
+   * `axis: 'x' | 'y'` 决定绕哪个轴翻；`from` 是起始角度（度，正 = 朝观察者翻起/右缘向内）。
+   * 常配 `perspective`（在**节点样式**上声明：`perspective: 1200`——CSS 语义）。
+   *
+   * ★**为什么走 tick 路径（诚实标注）**：两端平台插值器的 3D 语义不同（iOS 完整 4×4
+   *   矩阵 vs Android rotationX/Y + Camera）⇒ 统一走内核逐帧求值（跨端一致优先，与 color 同源）。
+   *   实测余量充足（120Hz p95 2ms / 预算 8.3ms）。
+   */
+  flipIn(opts = {}) {
+    const axis = opts.axis ?? "y";
+    const from = opts.fromDeg ?? -90;
+    const dur = opts.durationMs ?? 420;
+    const decls = [
+      {
+        kind: axis === "x" ? "rotateX" : "rotateY",
+        from,
+        to: 0,
+        curve: opts.curve ?? "easeOut",
+        durationMs: dur,
+        delayMs: opts.delayMs
+      },
+      // ★翻入常配淡入（纯旋转在无背面的元素上观感单调）——与 3D 同批下发（不同属性不冲突）
+      { kind: "opacity", from: 0.6, to: 1, curve: "easeOut", durationMs: dur, delayMs: opts.delayMs }
+    ];
+    return { name: `flipIn-${axis}`, decls, durationMs: dur };
+  },
+  /**
+   * ★★**3D 翻面**（`rotateY` 0→180 或 `rotateX`）——卡片翻到"背面"。
+   *
+   * `flips: 1` 翻一次停住；与 `repeat`/`direction` 组合可做"持续翻转"
+   * （`{ kind: 'rotateY', repeat: 'infinite', direction: 'alternate' }` 一句话 = 来回翻转）。
+   */
+  flip3D(opts = {}) {
+    const axis = opts.axis ?? "y";
+    const to = opts.toDeg ?? 180;
+    const dur = opts.durationMs ?? 500;
+    return {
+      name: `flip3D-${axis}`,
+      decls: [
+        {
+          kind: axis === "x" ? "rotateX" : "rotateY",
+          from: 0,
+          to,
+          curve: opts.curve ?? "easeInOut",
+          durationMs: dur,
+          ...opts.repeat !== void 0 ? { repeat: opts.repeat } : {},
+          ...opts.direction !== void 0 ? { direction: opts.direction } : {}
+        }
+      ],
+      durationMs: dur
+    };
+  },
+  /**
+   * **按压反馈**（松手弹回：`from` 是按下时的缩放，弹回 1）
+   *
+   * ★**诚实边界（引擎能力决定形态）**：内核对同 (节点,属性) 是**替换**语义 ⇒
+   *   "按下 → 弹回"**两段序列**在一个批次里表达不了（第二条会替换第一条）。
+   *   ⇒ 本预设只做**弹回段**；按下段由调用方在 `pressStart` 时单独启动
+   *   （或直接用 `spring` 从按下值弹回——这也是最常用的用法）。
+   *   ★序列编排（sequence）是已知缺口，见 README「未做」一节。
+   */
+  pressRelease(opts = {}) {
+    const sc = opts.fromScale ?? 0.96;
+    return {
+      name: "pressRelease",
+      decls: [{ kind: "scale", from: sc, to: 1, spring: easing.snappy }],
+      durationMs: 400
+    };
+  },
+  /**
+   * ★★**按压反馈（两段序列）**——按下后回弹，**一条动画**表达完整序列（MA6 起）
+   *
+   * 【这条预设是"序列编排"的存在理由】此前只能做"弹回段"（`pressRelease`），
+   *   因为内核对同 (节点,属性) 是替换语义、两条 scale 会互相覆盖；
+   *   MA6 的 `keyframes` 让"下压 → 回弹"收敛在**一条**动画里，且提交平台路径时仍是**一条**
+   *   `CAKeyframeAnimation`（不额外增加提交次数）。
+   */
+  press(opts = {}) {
+    const sc = opts.fromScale ?? 0.94;
+    const downMs = opts.downMs ?? 90;
+    const upMs = opts.upMs ?? 260;
+    return {
+      name: "pressSequence",
+      decls: [
+        {
+          kind: "scale",
+          from: 1,
+          to: 1,
+          keyframes: [
+            { to: sc, durationMs: downMs, curve: opts.downCurve ?? "easeOut" },
+            { to: 1, durationMs: upMs, curve: opts.upCurve ?? "springApprox" }
+          ]
+        }
+      ],
+      durationMs: downMs + upMs
+    };
+  },
+  /**
+   * **抖动（错误提示）**——水平往复三段，末段回到起点
+   *
+   * ★为什么"末段必须回 0"：抖动是**扰动**，不是位移；末段不回 0 会让元素永久偏移
+   *   （这是"看起来对、实际错位"的典型）。预设已保证末段 `to: 0`。
+   */
+  shake(opts = {}) {
+    const amp = opts.amplitude ?? 10;
+    const dur = opts.durationMs ?? 360;
+    const seg = dur / 3;
+    return {
+      name: "shake",
+      decls: [
+        {
+          kind: "translateX",
+          from: 0,
+          to: 0,
+          keyframes: [
+            { to: -amp, durationMs: seg, curve: "easeOut" },
+            { to: amp, durationMs: seg, curve: "easeInOut" },
+            { to: 0, durationMs: seg, curve: "easeOut" }
+          ]
+        }
+      ],
+      durationMs: dur
+    };
+  },
+  /**
+   * ★★**共享元素**（跨元素/跨页面飞行）——Morpheus §6.1 清单最后一项
+   *
+   * 【与 `sharedElementFlyIn` 的本质差别】那个是"**在落点上**做缩放+淡入"（不需要源几何）；
+   *   本条是**真·共享元素**：从**源矩形**飞到目标位置再归位——需要"源"的稳态几何。
+   *
+   * 【源有两种，覆盖两种场景】
+   *   - `fromNodeId`：**同树节点**（同页面内的共享元素，如列表项 → 扩展卡）；
+   *   - `fromRect`：**系统坐标矩形**（跨页面/跨稳态，如"上一页的缩略图位置"——
+   *     该几何由调用方注入：静态布局（tab/宫格/固定 header）可在**编译期**算出、随指令一起下发，
+   *     只有真正运行期才知道的才由宿主上报）。
+   *
+   * 【几何数学在内核，本预设只是"声明"】编译产物带 `shared: {sourceRect | sourceNodeId}`，
+   *   由宿主交 `proteus_layout_shared_element` 处理（中心差 + 宽度比 + 缓动都在内核）。
+   *
+   * ★诚实边界（见 README「未做」）：内核只有**等比** scale ⇒ 以宽度比为准，
+   *   源/目标宽高比不一致时高度按目标比例推出。
+   */
+  sharedElement(opts = {}) {
+    if (!opts.fromRect && opts.fromNodeId === void 0) {
+      throw new Error("sharedElement \u9700\u8981\u6E90\uFF1A\u7ED9 fromRect\uFF08\u7CFB\u7EDF\u5750\u6807\uFF09\u6216 fromNodeId\uFF08\u540C\u6811\u8282\u70B9\uFF09");
+    }
+    if (opts.fromRect && opts.fromNodeId !== void 0) {
+      throw new Error("sharedElement \u7684\u6E90\u53EA\u80FD\u7ED9\u4E00\u4E2A\uFF1AfromRect \u4E0E fromNodeId \u4E8C\u9009\u4E00");
+    }
+    return {
+      name: "sharedElement",
+      durationMs: opts.durationMs ?? 400,
+      fadeIn: opts.fadeIn !== false,
+      ...opts.fromRect ? { fromRect: opts.fromRect } : { fromNodeId: opts.fromNodeId }
+    };
+  },
+  /** **共享元素飞入**（在同树落点上做缩放+淡入——不需要源几何的简化形态） */
+  sharedElementFlyIn(opts = {}) {
+    const dur = opts.durationMs ?? 400;
+    const sc = opts.fromScale ?? 0.4;
+    return {
+      name: "sharedElementFlyIn",
+      decls: [
+        { kind: "scale", from: sc, to: 1, spring: easing.smooth },
+        { kind: "opacity", from: 0, to: 1, curve: "easeOut", durationMs: dur }
+      ],
+      durationMs: dur
+    };
+  }
+};
+var scroll = {
+  /**
+   * **吸顶**（滚过 `pinAt` 后头部固定：用反向位移抵消继续滚动）
+   *
+   * ★实现说明：本引擎只写**合成属性**（translate/opacity）⇒ 吸顶表达为
+   *   `translateY: 0 → -(scrollSpan)` 的窗口动画，配合布局让位实现"钉住"观感；
+   *   真·改变定位（position: sticky）属布局属性，不在本引擎属性面上（编译期会拦）。
+   */
+  sticky(opts = {}) {
+    const pinAt = opts.pinAt ?? 80;
+    const span = opts.span ?? 120;
+    return {
+      name: "scrollSticky",
+      decls: [{ kind: "translateY", from: 0, to: -span, curve: "linear", scroll: { from: pinAt, to: pinAt + span } }],
+      window: { from: pinAt, to: pinAt + span }
+    };
+  },
+  /**
+   * **视差**（背景层随滚动反向慢移；`factor` 0..1 = 慢移比例）
+   *
+   * `factor=0.4` ⇒ 滚过 100px 时背景只上移 40px（相对前景的"景深感"）。
+   */
+  parallax(opts = {}) {
+    const factor = opts.factor ?? 0.4;
+    const from = opts.from ?? 0;
+    const to = opts.to ?? 400;
+    return {
+      name: "scrollParallax",
+      decls: [
+        {
+          kind: "translateY",
+          from: 0,
+          to: -(to - from) * factor,
+          curve: "linear",
+          scroll: { from, to }
+        }
+      ],
+      window: { from, to }
+    };
+  },
+  /**
+   * **渐显**（滚入 `from..to` 区间内透明度 0 → 1；可叠加轻微上移）
+   *
+   * ★`from/to` 通常取"元素进入视口"的滚动位置区间（由布局计算给出，预设不猜）。
+   */
+  fadeIn(opts) {
+    const rise = opts.risePx ?? 0;
+    const decls = [
+      { kind: "opacity", from: 0, to: 1, curve: "easeOut", scroll: { from: opts.from, to: opts.to } }
+    ];
+    if (rise > 0) {
+      decls.push({ kind: "translateY", from: rise, to: 0, curve: "easeOut", scroll: { from: opts.from, to: opts.to } });
+    }
+    return { name: "scrollFadeIn", decls, window: { from: opts.from, to: opts.to } };
+  }
+};
+var presets = { route, list, element, easing, scroll, choreograph };
+var APP_TRANSITION_MAP = {
+  // 推入（新页从下往上）—— 与 Web `slide-up` / MP `routeType: 'slideUp'` 同语义
+  slideUp: presets.route.slideUp(),
+  // 下滑关闭（当前页往下滑出，露出下层）—— 与 Web `slide-down` / MP `slideDown` 同语义
+  slideDown: presets.route.slideDown(),
+  // 半屏（弹窗从底部滑入，下层不动）—— 与 Web `halfscreen` / MP `halfScreen` 同语义
+  halfScreen: presets.route.bottomSheet(),
+  // 缩放下沉（新页放大进入 + 旧页下沉）—— 与 Web `scale` / MP `scaleDown` 同语义
+  scaleDown: presets.route.zoom(),
+  // 无转场（瞬切）
+  none: {
+    name: "none",
+    wxRouteType: null,
+    enter: [],
+    exit: [],
+    opaque: true,
+    durationMs: 0
+  }
+};
+function appTransition(transition, opts) {
+  const spec = APP_TRANSITION_MAP[transition];
+  if (!spec) return APP_TRANSITION_MAP.none;
+  if (!opts || opts.distance === void 0 && opts.durationMs === void 0) return spec;
+  const p = opts.distance;
+  const d = opts.durationMs;
+  switch (transition) {
+    case "slideUp":
+      return presets.route.slideUp({ distance: p, durationMs: d });
+    case "slideDown":
+      return presets.route.slideDown({ distance: p, durationMs: d });
+    case "halfScreen":
+      return presets.route.bottomSheet({ distance: p, durationMs: d });
+    case "scaleDown":
+      return presets.route.zoom({ durationMs: d, fromOffsetY: p });
+    default:
+      return spec;
+  }
+}
+function reverseDecls(decls) {
+  return decls.map((d) => {
+    if (isColorDecl(d)) {
+      const { from: from2, ...rest2 } = d;
+      return { ...rest2, from: d.to, to: from2 };
+    }
+    if (isClipDecl(d)) {
+      const { from: from2, ...rest2 } = d;
+      return { ...rest2, from: d.to, to: from2 };
+    }
+    const { from, ...rest } = d;
+    return { ...rest, from: d.to, to: from ?? 0 };
+  });
+}
+var EMPTY_BATCH = { anims: [], composited: true, nonComposited: [] };
+function routeTransitionBatches(transition, targets, opts) {
+  const spec = appTransition(transition, opts);
+  const direction = opts?.direction ?? "forward";
+  const role = spec.role ?? "push";
+  const effective = role === "dismiss" ? { enter: spec.enter, exit: spec.exit, durationMs: spec.durationMs, opaque: spec.opaque } : direction === "back" ? { enter: reverseDecls(spec.exit), exit: reverseDecls(spec.enter), durationMs: spec.durationMs, opaque: spec.opaque } : { enter: spec.enter, exit: spec.exit, durationMs: spec.durationMs, opaque: spec.opaque };
+  const name = Object.keys(APP_TRANSITION_MAP).includes(transition) ? transition : "none";
+  const incoming = targets.incoming !== void 0 && effective.enter.length > 0 ? compileAnimations(effective.enter, { nodeId: targets.incoming }) : EMPTY_BATCH;
+  const outgoing = targets.outgoing !== void 0 && effective.exit.length > 0 ? compileAnimations(effective.exit, { nodeId: targets.outgoing }) : EMPTY_BATCH;
+  return { incoming, outgoing, durationMs: spec.durationMs, opaque: spec.opaque, direction, transition: name, role };
+}
+var ESCAPE_KINDS = [
+  "custom-easing",
+  "external-driver",
+  "layout-property",
+  "cross-property-timeline",
+  "platform-mixing",
+  "other"
+];
+var ESCAPE_RATIO_TARGET = 0.05;
+var EscapeRegistry = class {
+  constructor() {
+    this.records = [];
+    this.declarativeCount = 0;
+  }
+  /** 登记一条逃生口（**三要素缺失当场抛错**——"没有理由的逃生口"是设计泄漏，不许静默通过） */
+  register(r) {
+    if (!r || typeof r !== "object") throw new Error("\u9003\u751F\u53E3\u767B\u8BB0\u9700\u8981\u5BF9\u8C61\uFF08{kind, detail, reason, behaviorRisk}\uFF09");
+    if (!ESCAPE_KINDS.includes(r.kind)) {
+      throw new Error(`\u672A\u77E5\u9003\u751F\u53E3\u7C7B\u522B \`${r.kind}\`\uFF08\u5408\u6CD5\u503C\uFF1A${ESCAPE_KINDS.join(" / ")}\uFF09`);
+    }
+    for (const f of ["detail", "reason", "behaviorRisk"]) {
+      const v = r[f];
+      if (typeof v !== "string" || v.trim().length === 0) {
+        throw new Error(
+          `\u9003\u751F\u53E3\u767B\u8BB0\u7F3A\u5C11 \`${f}\`\uFF08${r.kind}\uFF09\u2014\u2014` + (f === "behaviorRisk" ? '\xA74.2 \u8981\u6C42\u5199\u660E"\u884C\u4E3A\u53EF\u80FD\u4E0D\u4E00\u81F4"\u7684\u5177\u4F53\u5F62\u6001\uFF08degraded \u7684\u5B9A\u4E49\uFF09' : f === "reason" ? '\u6CA1\u6709\u7406\u7531\u7684\u9003\u751F\u53E3\u662F\u8BBE\u8BA1\u6CC4\u6F0F\uFF0C\u5FC5\u987B\u5199\u6E05"\u4E3A\u4EC0\u4E48\u5C01\u95ED\u96C6\u4E0D\u591F"' : '\u5FC5\u987B\u5199\u6E05"\u5177\u4F53\u5728\u505A\u4EC0\u4E48"')
+        );
+      }
+    }
+    this.records.push({ ...r });
+  }
+  /** 记录声明式使用量（由 `compileAnimations` 在**注入本注册表**时调用） */
+  noteDeclarative(n) {
+    if (Number.isFinite(n) && n > 0) this.declarativeCount += n;
+  }
+  /** 全部登记（只读视图） */
+  list() {
+    return this.records;
+  }
+  /** ★聚合（degraded 单列；**全部类别都出现**，零值也列出——不给人留"未归类"的想象空间） */
+  summary() {
+    const byKind = Object.fromEntries(ESCAPE_KINDS.map((k) => [k, 0]));
+    for (const r of this.records) byKind[r.kind] += 1;
+    const total = this.records.length;
+    const denom = this.declarativeCount + total;
+    return {
+      total,
+      declaratives: this.declarativeCount,
+      byKind,
+      // §4.2：degraded 是**最高危险度**，单列（不与其它类别混）——这里就是那条单列表
+      degraded: this.records.slice(),
+      ratio: denom > 0 ? total / denom : 0
+    };
+  }
+  /** ★可读报告（degraded **单独一节**，不与类别汇总混排） */
+  format() {
+    const s = this.summary();
+    const lines = [];
+    lines.push("\u2550\u2550\u2550 Morpheus \u9003\u751F\u53E3\u62A5\u544A \u2550\u2550\u2550");
+    lines.push(
+      `\u58F0\u660E\u5F0F ${s.declaratives} \u6761 \xB7 \u9003\u751F\u53E3 ${s.total} \u6761 \xB7 \u7387 ${s.total === 0 ? "0%" : `${(s.ratio * 100).toFixed(1)}%`}\uFF08\u76EE\u6807 < ${(ESCAPE_RATIO_TARGET * 100).toFixed(0)}%\uFF09`
+    );
+    lines.push("");
+    if (s.total === 0) {
+      lines.push("\u65E0\u9003\u751F\u53E3\u767B\u8BB0\uFF08\u5168\u90E8\u8D70\u58F0\u660E\u5F0F\u8DEF\u5F84\uFF09\u3002");
+    } else {
+      lines.push("\u2605 degraded\uFF08\u884C\u4E3A\u53EF\u80FD\u4E0E\u58F0\u660E\u5F0F\u8DEF\u5F84\u4E0D\u4E00\u81F4\u2014\u2014\xA74.2 \u6700\u9AD8\u5371\u9669\u5EA6\uFF0C\u5355\u5217\uFF09:");
+      for (const r of s.degraded) {
+        lines.push(`  \xB7 [${r.kind}] ${r.detail}`);
+        lines.push(`      \u7406\u7531\uFF1A${r.reason}`);
+        lines.push(`      \u98CE\u9669\uFF1A${r.behaviorRisk}`);
+        if (r.site) lines.push(`      \u51FA\u5904\uFF1A${r.site}`);
+      }
+      lines.push("");
+    }
+    lines.push('\u6309\u7C7B\u522B\u6C47\u603B\uFF08\u542B\u96F6\u503C\u2014\u2014"\u672A\u5F52\u7C7B"\u4E0D\u5B58\u5728\uFF0C\u53EA\u6709 other \u515C\u5E95\uFF09:');
+    for (const k of ESCAPE_KINDS) lines.push(`  \xB7 ${k}: ${s.byKind[k]}`);
+    if (s.ratio > ESCAPE_RATIO_TARGET) {
+      lines.push("");
+      lines.push(`\u26A0 \u9003\u751F\u53E3\u7387 ${(s.ratio * 100).toFixed(1)}% \u8D85\u8FC7\u76EE\u6807 ${(ESCAPE_RATIO_TARGET * 100).toFixed(0)}%\u2014\u2014\u4F18\u5148\u770B\u80FD\u5426\u628A\u9AD8\u9891\u7C7B\u522B\u8865\u6210\u9884\u8BBE\uFF08\u9884\u8BBE\u4F18\u5148\u4E8E\u9003\u751F\u53E3\uFF09`);
+    }
+    return lines.join("\n");
+  }
+  /** 清空（**测试隔离用**——跨用例共享状态必须可归零，本仓纪律） */
+  reset() {
+    this.records = [];
+    this.declarativeCount = 0;
+  }
+};
+var escapes = new EscapeRegistry();
+
+// src/app-navigation.ts
+function createAppNavigation(opts) {
+  if (!opts.screens && !opts.routes) {
+    throw new Error("[app-navigation] \u9700\u8981 screens \u6216 routes \u4E4B\u4E00\uFF08\u5C4F\u6CE8\u518C\u8868\u7684\u6765\u6E90\u2014\u2014\u4E0D\u731C\uFF09");
+  }
+  const screens = opts.screens ?? screensFromRoutes(opts.routes);
+  if (Object.keys(screens).length === 0) {
+    throw new Error("[app-navigation] \u5C4F\u6CE8\u518C\u8868\u4E3A\u7A7A\u2014\u2014\u68C0\u67E5 routes/screens \u662F\u5426\u4E3A\u7A7A");
+  }
+  const stack = createAppStack({ screens, ...opts.policy ? { policy: opts.policy } : {} });
+  const ports = createHostScreenPorts({ invoke: opts.invoke });
+  const executor = createScreenExecutor({
+    host: ports.tree,
+    anim: ports.anim,
+    ...opts.contentOf ? { contentOf: opts.contentOf } : {},
+    plan: (t, targets, o) => routeTransitionBatches(t, targets, o ?? {}),
+    onScreenMounted: opts.onScreenMounted ?? ((id) => stack.markRebuilt(id)),
+    ...opts.onEvent ? { onEvent: opts.onEvent } : {}
+  });
+  const autoPump = opts.autoPump !== false;
+  const adapter = createAppNavigationAdapter({
+    stack,
+    screens,
+    pump: autoPump ? () => executor.applyCommands(stack.drainCommands()) : async () => {
+    }
+  });
+  return {
+    stack,
+    executor,
+    adapter,
+    flush: () => adapter.flush(),
+    hostStats: () => {
+      try {
+        return JSON.parse(opts.invoke("screen.stats", "null"));
+      } catch (e) {
+        return { error: String(e) };
+      }
+    }
+  };
+}
+export {
+  createAppNavigation
+};