@typecad/ui 1.0.0-alpha.14 → 1.0.0-alpha.16

package/dist/ui-engine/runtime-header/tick/scroll-canvas-phase.js

@@ -2,29 +2,29 @@
 // scrollbar + buffered scroll canvas push.
 // See docs/superpowers/specs/2026-07-12-split-runtime-header-design.md.
 export function emitTickScrollCanvasPhase() {
-    return `
-  // ②b Draw scrollbar + push canvas for the buffered scroll container.
-  if (bufferedScrollNode >= 0 && bufferedScrollCanvas) {
-    ui_push_buffered_scroll_canvas(bufferedScrollCanvas, bufferedScrollRepaintCanvas,
-      bufferedScrollNode, bufferedScrollVX, bufferedScrollVY,
-      bufferedScrollRepaintY, bufferedScrollRepaintH, __ui_draw_target);
-  } else if (bufferedScrollNode >= 0 && bufferedScrollBands) {
-    // Band render fallback: the main loop didn't trigger it at the owner's
-    // z-slot (e.g. the owner was filtered out after dispatch). Render now so
-    // the subtree is never left unpainted. ui_render_scroll_bands sets
-    // lastPaintedScrollY itself on success; only the failure fallback (band
-    // canvas wouldn't allocate) needs to record the scrollY here so the next
-    // frame's delta is correct.
-    if (!ui_render_scroll_bands(static_cast<uint16_t>(bufferedScrollNode))) {
-      // No band canvas means there is no coherent frame to submit. Retain the
-      // previous viewport rather than drawing the scrollbar/direct subtree to
-      // the live SPI target, which would reintroduce tearing.
-      if (__ui_scroll_render_locked) __ui_scroll_render_locked[static_cast<uint16_t>(bufferedScrollNode)] = 1;
-      __ui_nodes[bufferedScrollNode].dirty = 0;
-    }
-  } else if (bufferedScrollNode >= 0 && bufferedScrollDirectFull) {
-    // The direct-full path is intentionally disabled for tear-sensitive scroll
-    // rendering. Keep the retained pixels when no compositor is available.
-    if (__ui_scroll_render_locked) __ui_scroll_render_locked[static_cast<uint16_t>(bufferedScrollNode)] = 1;
+    return `
+  // ②b Draw scrollbar + push canvas for the buffered scroll container.
+  if (bufferedScrollNode >= 0 && bufferedScrollCanvas) {
+    ui_push_buffered_scroll_canvas(bufferedScrollCanvas, bufferedScrollRepaintCanvas,
+      bufferedScrollNode, bufferedScrollVX, bufferedScrollVY,
+      bufferedScrollRepaintY, bufferedScrollRepaintH, __ui_draw_target);
+  } else if (bufferedScrollNode >= 0 && bufferedScrollBands) {
+    // Band render fallback: the main loop didn't trigger it at the owner's
+    // z-slot (e.g. the owner was filtered out after dispatch). Render now so
+    // the subtree is never left unpainted. ui_render_scroll_bands sets
+    // lastPaintedScrollY itself on success; only the failure fallback (band
+    // canvas wouldn't allocate) needs to record the scrollY here so the next
+    // frame's delta is correct.
+    if (!ui_render_scroll_bands(static_cast<uint16_t>(bufferedScrollNode))) {
+      // No band canvas means there is no coherent frame to submit. Retain the
+      // previous viewport rather than drawing the scrollbar/direct subtree to
+      // the live SPI target, which would reintroduce tearing.
+      if (__ui_scroll_render_locked) __ui_scroll_render_locked[static_cast<uint16_t>(bufferedScrollNode)] = 1;
+      __ui_nodes[bufferedScrollNode].dirty = 0;
+    }
+  } else if (bufferedScrollNode >= 0 && bufferedScrollDirectFull) {
+    // The direct-full path is intentionally disabled for tear-sensitive scroll
+    // rendering. Keep the retained pixels when no compositor is available.
+    if (__ui_scroll_render_locked) __ui_scroll_render_locked[static_cast<uint16_t>(bufferedScrollNode)] = 1;
     __ui_nodes[bufferedScrollNode].dirty = 0;`;
 }

package/dist/ui-engine/runtime-header/touch-keyboard-fwd.js

@@ -26,7 +26,7 @@ extern const uint16_t __ui_rangechange_handler_count;
 
 // Touch state machine: tracks down → hold → up → click lifecycle
 // Touch node/scroll node state is defined near navigation because ui_navigate resets it.
-static uint32_t __ui_touch_down_time = 0;  // millis() when touch started
+static uint32_t __ui_touch_down_time = 0;  // __tc_now_ms() when touch started
 static int16_t __ui_touch_down_y_pos = 0; // Y position when touch started (for tap vs drag detection)
 static uint32_t __ui_last_touch_time = 0;  // for debounce (updated on touch down only)
 static uint32_t __ui_last_release_time = 0;  // for release debounce
@@ -174,13 +174,13 @@ static void ui_touch_down(int16_t tx, int16_t ty) {
   // option rows. No hit-test/press/scroll while the overlay is open.
   if (__ui_select_menu >= 0) {
     __ui_touch_state = 1;
-    __ui_touch_down_time = millis();
+    __ui_touch_down_time = __tc_now_ms();
     return;
   }
   int16_t node = ui_hit_test(tx, ty);
   __ui_touch_node = node;
   __ui_touch_state = 1;
-  __ui_touch_down_time = millis();
+  __ui_touch_down_time = __tc_now_ms();
   __ui_touch_down_y_pos = ty;
   __ui_drag_start_x = tx;
   __ui_drag_start_y = ty;
@@ -215,7 +215,7 @@ static void ui_touch_down(int16_t tx, int16_t ty) {
       int16_t usable = __ui_nodes[node].box.w - 8;
       if (usable <= 0) usable = 1;
       int16_t nextVal = rMin + (static_cast<int32_t>(relX) * range) / usable;
-      nextVal = constrain(nextVal, rMin, rMax);
+      nextVal = __ui_constrain(nextVal, rMin, rMax);
       if (nextVal != __ui_nodes[node].value) {
         __ui_nodes[node].value = nextVal;
         ui_mark_dirty(node);
@@ -261,7 +261,7 @@ static void ui_touch_up() {
   if (__ui_select_menu >= 0) {
     ui_select_menu_tap(__ui_last_touch_x, __ui_last_touch_y);
     __ui_touch_state = 0;
-    __ui_last_touch_time = millis();
+    __ui_last_touch_time = __tc_now_ms();
     return;
   }
 #if !defined(UI_HIDE_OSK)
@@ -269,11 +269,11 @@ static void ui_touch_up() {
     ui_kb_handle_tap(__ui_last_touch_x, __ui_last_touch_y);
     __ui_kb_bs_held = 0;
     __ui_touch_state = 0;
-    __ui_last_touch_time = millis();
+    __ui_last_touch_time = __tc_now_ms();
     return;
   }
 #endif
-  uint32_t elapsed = millis() - __ui_touch_down_time;
+  uint32_t elapsed = __tc_now_ms() - __ui_touch_down_time;
   // Release the scroll owner: arm a bounded settle (bounce-back / edge-snap).
   // No fling — motion ends with the finger (the settle animation is the only
   // post-lift motion, terminating within UI_SCROLL_SETTLE_MS).
@@ -353,7 +353,7 @@ static void ui_touch_up() {
 // Called each frame from ui_poll_touch when touch is detected.
 // Implements debounce + the down/hold/up/click state machine.
 static inline void ui_handle_touch(int16_t tx, int16_t ty) {
-  uint32_t now = millis();
+  uint32_t now = __tc_now_ms();
   // Track last touch coords for tap-up routing.
   __ui_last_touch_x = tx;
   __ui_last_touch_y = ty;
@@ -404,7 +404,7 @@ static inline void ui_handle_touch(int16_t tx, int16_t ty) {
       int16_t usable = __ui_nodes[__ui_range_node].box.w - 8;
       if (usable <= 0) usable = 1;
       int16_t newVal = rMin + (static_cast<int32_t>(relX) * range) / usable;
-      newVal = constrain(newVal, rMin, rMax);
+      newVal = __ui_constrain(newVal, rMin, rMax);
       if (newVal != __ui_nodes[__ui_range_node].value) {
         __ui_nodes[__ui_range_node].value = newVal;
         ui_mark_dirty(__ui_range_node);
@@ -457,9 +457,9 @@ static inline void ui_handle_no_touch() {
   if (__ui_touch_state != 0) {
     // Debounce: require a gap since the last release before processing another.
     // This prevents crash from rapid touch/no-touch flicker on resistive screens.
-    if (millis() - __ui_last_release_time < UI_TOUCH_DEBOUNCE_MS) return;
+    if (__tc_now_ms() - __ui_last_release_time < UI_TOUCH_DEBOUNCE_MS) return;
     ui_touch_up();
-    __ui_last_release_time = millis();
+    __ui_last_release_time = __tc_now_ms();
   }
 }
 

package/dist/ui-engine/runtime-header/types-defines.js

@@ -2,115 +2,115 @@
 // Guard open, includes, and #define knobs.
 // See docs/superpowers/specs/2026-07-12-split-runtime-header-design.md.
 export function emitTypesDefines() {
-    return `
-// ── Cuttlefish UI runtime (emit once per TU) ──────────────────────────────
-#ifndef __TC_UI_RUNTIME
-#define __TC_UI_RUNTIME
-#include <stdint.h>
-#include <cstring>
-#include <new>
-#define UI_TEXT_BUF 32   // max stored UI text chars, excluding the trailing NUL
-#define UI_TEXT_LINE_BUF 96
-#define UI_WS_NORMAL 0
-#define UI_WS_NOWRAP 1
-#define UI_WS_PRE 2
-#define UI_WS_PRE_LINE 3
-#ifndef UI_MAX_BUFFERED_PAINT_PIXELS
-#define UI_MAX_BUFFERED_PAINT_PIXELS 20000
-#endif
-// Above this many pixels, prefer the band renderer (small ~10KB SRAM canvas,
-// strip-at-a-time) over the repair canvas even when the repair canvas could
-// allocate (e.g. in PSRAM). A large repair canvas (a full-width button is
-// ~15-30KB) has higher alloc/seed/push latency than banding — the per-band
-// push is smaller and the band canvas lives in fast internal SRAM. Set below
-// UI_MAX_BUFFERED_PAINT_PIXELS so large rects band while small repaints keep
-// the fast single-canvas composite. Tune per target; 0 = always prefer the
-// repair canvas when it allocates (the pre-PSRAM behavior).
-#ifndef UI_BAND_PREFER_PIXELS
-#define UI_BAND_PREFER_PIXELS 8000
-#endif
-#ifndef UI_USE_FULL_FRAMEBUFFER
-#define UI_USE_FULL_FRAMEBUFFER 0
-#endif
-#ifndef UI_TRANSITION_SNAP_MS
-#define UI_TRANSITION_SNAP_MS 100
-#endif
-// Scroll physics + capability defaults. The per-TU #define overrides emitted
-// by the UI emitter (from resolveScrollConfig) hit BEFORE this header, so these
-// #ifndef guards adopt the configured values. Spec: 2026-06-28-scroll-engine-rewrite-design.md
-#ifndef UI_SCROLL_MAX_OVERSCROLL
-#define UI_SCROLL_MAX_OVERSCROLL 40
-#endif
-#ifndef UI_SCROLL_STIFFNESS_X10
-#define UI_SCROLL_STIFFNESS_X10 5
-#endif
-#ifndef UI_SCROLL_EDGE_SNAP_PX
-#define UI_SCROLL_EDGE_SNAP_PX 12
-#endif
-#ifndef UI_SCROLL_DRAG_SCALE_X10
-#define UI_SCROLL_DRAG_SCALE_X10 10
-#endif
-#ifndef UI_SCROLL_SETTLE_MS
-#define UI_SCROLL_SETTLE_MS 180
-#endif
-#ifndef UI_SCROLL_DEADBAND_PX
-#define UI_SCROLL_DEADBAND_PX 2
-#endif
-// Capability tier flags (emitted per-TU before this header; defaults = full).
-// The default-on check must run BEFORE the per-flag #ifndef defaults below —
-// after them, all three flags are defined 0 and the fallback would redefine
-// UI_SCROLL_INPUT_TIER_RESISTIVE with a different value (ill-formed).
-#if !defined(UI_SCROLL_INPUT_TIER_CAPACITIVE) && !defined(UI_SCROLL_INPUT_TIER_RESISTIVE) && !defined(UI_SCROLL_INPUT_TIER_NONE)
-#define UI_SCROLL_INPUT_TIER_RESISTIVE 1
-#endif
-#ifndef UI_SCROLL_INPUT_TIER_CAPACITIVE
-#define UI_SCROLL_INPUT_TIER_CAPACITIVE 0
-#endif
-#ifndef UI_SCROLL_INPUT_TIER_RESISTIVE
-#define UI_SCROLL_INPUT_TIER_RESISTIVE 0
-#endif
-#ifndef UI_SCROLL_INPUT_TIER_NONE
-#define UI_SCROLL_INPUT_TIER_NONE 0
-#endif
-#ifndef UI_SCROLL_RENDER_TIER_FULL
-#define UI_SCROLL_RENDER_TIER_FULL 1
-#endif
-#ifndef UI_SCROLL_RENDER_TIER_CONSTRAINED
-#define UI_SCROLL_RENDER_TIER_CONSTRAINED 0
-#endif
-#define UI_SCROLL_HAS_TOUCH (UI_SCROLL_INPUT_TIER_CAPACITIVE || UI_SCROLL_INPUT_TIER_RESISTIVE)
-#define UI_SCROLL_ELASTIC (UI_SCROLL_RENDER_TIER_FULL)
-// Telemetry: emits per-frame scrollY/overscrollPx/dy over Serial when defined.
-#ifndef UI_SCROLL_DEBUG
-#define UI_SCROLL_DEBUG 0
-#endif
-// Band renderer: height (px) of the horizontal band canvas used to composite
-// scroll subtrees tear-free when no viewport canvas fits (no PSRAM / over
-// budget). Each band is vw × UI_STRIP_BAND_HEIGHT. Must be tall enough that a
-// single line of AA text (glyph height ~lineHeight, typically 16-22px at ts=2)
-// fits within one band — if a glyph straddles a band boundary, its anti-
-// aliased edge pixels blend toward the wrong bg in the adjacent band, visible
-// as a clipped/faded text bottom. 32 ensures most fonts fit; at 480px wide
-// that's ~30KB (fits SRAM on most ESP32 targets).
-// Dirty-rect merging (LVGL refresh-cycle technique): several same-frame
-// dirty nodes whose paint rects are near each other composite as one banded
-// region instead of per-node transactions. Regions cap at the band-
-// compositable pixel budget; singleton rects keep the per-node ladder.
-#ifndef UI_MERGE_INFLATE
-#define UI_MERGE_INFLATE 8
-#endif
-#ifndef UI_MERGE_MAX_REGIONS
-#define UI_MERGE_MAX_REGIONS 6
-#endif
-#ifndef UI_MERGE_MAX_NODES
-#define UI_MERGE_MAX_NODES 12
-#endif
-
-#ifndef UI_STRIP_BAND_HEIGHT
-#define UI_STRIP_BAND_HEIGHT 32
-#endif
-#if defined(ESP32) || defined(ESP8266)
-#include <Esp.h>
-#endif
+    return `
+// ── Cuttlefish UI runtime (emit once per TU) ──────────────────────────────
+#ifndef __TC_UI_RUNTIME
+#define __TC_UI_RUNTIME
+#include <stdint.h>
+#include <cstring>
+#include <new>
+#define UI_TEXT_BUF 32   // max stored UI text chars, excluding the trailing NUL
+#define UI_TEXT_LINE_BUF 96
+#define UI_WS_NORMAL 0
+#define UI_WS_NOWRAP 1
+#define UI_WS_PRE 2
+#define UI_WS_PRE_LINE 3
+#ifndef UI_MAX_BUFFERED_PAINT_PIXELS
+#define UI_MAX_BUFFERED_PAINT_PIXELS 20000
+#endif
+// Above this many pixels, prefer the band renderer (small ~10KB SRAM canvas,
+// strip-at-a-time) over the repair canvas even when the repair canvas could
+// allocate (e.g. in PSRAM). A large repair canvas (a full-width button is
+// ~15-30KB) has higher alloc/seed/push latency than banding — the per-band
+// push is smaller and the band canvas lives in fast internal SRAM. Set below
+// UI_MAX_BUFFERED_PAINT_PIXELS so large rects band while small repaints keep
+// the fast single-canvas composite. Tune per target; 0 = always prefer the
+// repair canvas when it allocates (the pre-PSRAM behavior).
+#ifndef UI_BAND_PREFER_PIXELS
+#define UI_BAND_PREFER_PIXELS 8000
+#endif
+#ifndef UI_USE_FULL_FRAMEBUFFER
+#define UI_USE_FULL_FRAMEBUFFER 0
+#endif
+#ifndef UI_TRANSITION_SNAP_MS
+#define UI_TRANSITION_SNAP_MS 100
+#endif
+// Scroll physics + capability defaults. The per-TU #define overrides emitted
+// by the UI emitter (from resolveScrollConfig) hit BEFORE this header, so these
+// #ifndef guards adopt the configured values. Spec: 2026-06-28-scroll-engine-rewrite-design.md
+#ifndef UI_SCROLL_MAX_OVERSCROLL
+#define UI_SCROLL_MAX_OVERSCROLL 40
+#endif
+#ifndef UI_SCROLL_STIFFNESS_X10
+#define UI_SCROLL_STIFFNESS_X10 5
+#endif
+#ifndef UI_SCROLL_EDGE_SNAP_PX
+#define UI_SCROLL_EDGE_SNAP_PX 12
+#endif
+#ifndef UI_SCROLL_DRAG_SCALE_X10
+#define UI_SCROLL_DRAG_SCALE_X10 10
+#endif
+#ifndef UI_SCROLL_SETTLE_MS
+#define UI_SCROLL_SETTLE_MS 180
+#endif
+#ifndef UI_SCROLL_DEADBAND_PX
+#define UI_SCROLL_DEADBAND_PX 2
+#endif
+// Capability tier flags (emitted per-TU before this header; defaults = full).
+// The default-on check must run BEFORE the per-flag #ifndef defaults below —
+// after them, all three flags are defined 0 and the fallback would redefine
+// UI_SCROLL_INPUT_TIER_RESISTIVE with a different value (ill-formed).
+#if !defined(UI_SCROLL_INPUT_TIER_CAPACITIVE) && !defined(UI_SCROLL_INPUT_TIER_RESISTIVE) && !defined(UI_SCROLL_INPUT_TIER_NONE)
+#define UI_SCROLL_INPUT_TIER_RESISTIVE 1
+#endif
+#ifndef UI_SCROLL_INPUT_TIER_CAPACITIVE
+#define UI_SCROLL_INPUT_TIER_CAPACITIVE 0
+#endif
+#ifndef UI_SCROLL_INPUT_TIER_RESISTIVE
+#define UI_SCROLL_INPUT_TIER_RESISTIVE 0
+#endif
+#ifndef UI_SCROLL_INPUT_TIER_NONE
+#define UI_SCROLL_INPUT_TIER_NONE 0
+#endif
+#ifndef UI_SCROLL_RENDER_TIER_FULL
+#define UI_SCROLL_RENDER_TIER_FULL 1
+#endif
+#ifndef UI_SCROLL_RENDER_TIER_CONSTRAINED
+#define UI_SCROLL_RENDER_TIER_CONSTRAINED 0
+#endif
+#define UI_SCROLL_HAS_TOUCH (UI_SCROLL_INPUT_TIER_CAPACITIVE || UI_SCROLL_INPUT_TIER_RESISTIVE)
+#define UI_SCROLL_ELASTIC (UI_SCROLL_RENDER_TIER_FULL)
+// Telemetry: emits per-frame scrollY/overscrollPx/dy over Serial when defined.
+#ifndef UI_SCROLL_DEBUG
+#define UI_SCROLL_DEBUG 0
+#endif
+// Band renderer: height (px) of the horizontal band canvas used to composite
+// scroll subtrees tear-free when no viewport canvas fits (no PSRAM / over
+// budget). Each band is vw × UI_STRIP_BAND_HEIGHT. Must be tall enough that a
+// single line of AA text (glyph height ~lineHeight, typically 16-22px at ts=2)
+// fits within one band — if a glyph straddles a band boundary, its anti-
+// aliased edge pixels blend toward the wrong bg in the adjacent band, visible
+// as a clipped/faded text bottom. 32 ensures most fonts fit; at 480px wide
+// that's ~30KB (fits SRAM on most ESP32 targets).
+// Dirty-rect merging (LVGL refresh-cycle technique): several same-frame
+// dirty nodes whose paint rects are near each other composite as one banded
+// region instead of per-node transactions. Regions cap at the band-
+// compositable pixel budget; singleton rects keep the per-node ladder.
+#ifndef UI_MERGE_INFLATE
+#define UI_MERGE_INFLATE 8
+#endif
+#ifndef UI_MERGE_MAX_REGIONS
+#define UI_MERGE_MAX_REGIONS 6
+#endif
+#ifndef UI_MERGE_MAX_NODES
+#define UI_MERGE_MAX_NODES 12
+#endif
+
+#ifndef UI_STRIP_BAND_HEIGHT
+#define UI_STRIP_BAND_HEIGHT 32
+#endif
+#if defined(ESP32) || defined(ESP8266)
+#include <Esp.h>
+#endif
 `;
 }

package/dist/ui-engine/ui-lowering.d.ts

@@ -27,5 +27,5 @@ export interface LoweredUI {
 }
 type ColorFormat = "rgb565" | "rgb666" | "rgb888" | "mono";
 type Storage = "progmem" | "flash";
-export declare function lowerUIToCpp(root: StyledNode, boxes: Box[], colorFormat: ColorFormat, storage: Storage, keyboards?: KeyboardTemplate[], rules?: CSSRule[], display?: DisplayProfile, fontAssets?: UIFontAssetModel[], allScreens?: StyledNode[], imageAssetIds?: Map<string, number>, keyframeSets?: KeyframeSetModel[]): LoweredUI;
+export declare function lowerUIToCpp(root: StyledNode, boxes: Box[], colorFormat: ColorFormat, storage: Storage, keyboards?: KeyboardTemplate[], rules?: CSSRule[], display?: DisplayProfile, fontAssets?: UIFontAssetModel[], allScreens?: StyledNode[], imageAssetIds?: Map<string, number>, keyframeSets?: KeyframeSetModel[], keyframeNs?: string): LoweredUI;
 export {};

package/dist/ui-engine/ui-lowering.js

@@ -16,7 +16,7 @@ import { resolveColor } from "./color.js";
 import { defaultFontAttribution } from "./default-font.js";
 import { DEFAULT_ALPHA_KEYBOARD, DEFAULT_NUMBER_KEYBOARD } from "./default-keyboards.js";
 import { getListBindings } from "@typecad/cuttlefish/ir/transformers/ui-reactive";
-export function lowerUIToCpp(root, boxes, colorFormat, storage, keyboards = [], rules = [], display, fontAssets = [], allScreens = [], imageAssetIds = new Map(), keyframeSets = []) {
+export function lowerUIToCpp(root, boxes, colorFormat, storage, keyboards = [], rules = [], display, fontAssets = [], allScreens = [], imageAssetIds = new Map(), keyframeSets = [], keyframeNs = "") {
     void storage;
     const model = lowerUIToModel(root, boxes, colorFormat, display, fontAssets, allScreens, imageAssetIds, keyframeSets);
     // Tables are mutable RAM (ui_tick updates bg/dirty/elapsed/active each
@@ -69,7 +69,7 @@ export function lowerUIToCpp(root, boxes, colorFormat, storage, keyboards = [],
         : `void (*__ui_kb_loaders[])() = {};\nconst uint16_t __ui_kb_loader_count = 0;`;
     const screenCount = model.nodes.length > 0 ? Math.max(...model.nodes.map(n => n.screenId)) + 1 : 1;
     const imageTables = "const UIImage __ui_images[] = {};\nconst uint16_t __ui_image_count = 0;";
-    const keyframeTables = emitKeyframeTables(model);
+    const keyframeTables = emitKeyframeTables(model, keyframeNs);
     return { fontTables, nodeTable, transitionTable, typeDecl, keyboardLoaders, keyboardDispatch, screenCount, imageTables, keyframeTables, diagnostics: [] };
 }
 function sanitizedId(id) {
@@ -358,7 +358,7 @@ function emitTransitionTable(model) {
     ].join("\n");
 }
 /** Emit keyframe stop arrays + keyframe set index + animation table. */
-function emitKeyframeTables(model) {
+function emitKeyframeTables(model, keyframeNs = "") {
     if (model.keyframeSets.length === 0 && model.animations.length === 0) {
         return [
             `const UIKeyframeSet __ui_keyframe_sets[] = {};`,
@@ -369,8 +369,15 @@ function emitKeyframeTables(model) {
     }
     const lines = [];
     // Emit one stop array per keyframe set.
+    // `keyframeNs` namespaces symbols per UI module, and shared stylesheets can
+    // register the same animation name into multiple mounted modules — dedupe
+    // by name so identical sets emit once (duplicate static arrays fail to link).
+    const seenKfNames = new Set();
     for (const ks of model.keyframeSets) {
-        const safeName = ks.name.replace(/[^a-zA-Z0-9_]/g, "_");
+        if (seenKfNames.has(ks.name))
+            continue;
+        seenKfNames.add(ks.name);
+        const safeName = (keyframeNs ? keyframeNs + "_" : "") + ks.name.replace(/[^a-zA-Z0-9_]/g, "_");
         lines.push(`static const UIKeyframeStop __ui_kf_${safeName}_stops[] = {`);
         for (const s of ks.stops) {
             lines.push(`  { .percent=${s.percent}, .props=${s.props}, .bg=${hex(s.bg)}, .fg=${hex(s.fg)}, .opacity=${s.opacity}, .transformOffsetX=${s.transformOffsetX}, .transformOffsetY=${s.transformOffsetY}, .translatePctX=${s.translatePctX}, .translatePctY=${s.translatePctY}, .scaleX=${s.scaleX}, .scaleY=${s.scaleY}, .rotateDeg=${s.rotateDeg}, .width=${s.width}, .height=${s.height} },`);
@@ -380,7 +387,9 @@ function emitKeyframeTables(model) {
     // Emit keyframe set index table.
     lines.push(`const UIKeyframeSet __ui_keyframe_sets[] = {`);
     model.keyframeSets.forEach((ks) => {
-        const safeName = ks.name.replace(/[^a-zA-Z0-9_]/g, "_");
+        if (!seenKfNames.has(ks.name))
+            return;
+        const safeName = (keyframeNs ? keyframeNs + "_" : "") + ks.name.replace(/[^a-zA-Z0-9_]/g, "_");
         lines.push(`  { .stopCount=${ks.stops.length}, .stops=__ui_kf_${safeName}_stops },`);
     });
     lines.push(`};`);

package/dist/ui-engine/ui-registry.js

@@ -165,7 +165,8 @@ export function lowerOnMount(htmlPath, opts) {
     const keyframeSets = buildKeyframeSets(mod.rawKeyframes || [], opts.colorFormat);
     // Load image assets before lowering so imgDataId can be set.
     const imageAssets = loadImageAssets(allStyled.length > 0 ? allStyled : [mod.styled], path.dirname(abs));
-    const result = lowerUIToCpp(mod.styled, allBoxes, opts.colorFormat, opts.storage, mod.keyboards, mod.rules, getDisplayProfile(), mod.fontAssets, allStyled, imageAssets.nodeIdToAssetIndex, keyframeSets);
+    const kfNs = hashlibLike(abs);
+    const result = lowerUIToCpp(mod.styled, allBoxes, opts.colorFormat, opts.storage, mod.keyboards, mod.rules, getDisplayProfile(), mod.fontAssets, allStyled, imageAssets.nodeIdToAssetIndex, keyframeSets, kfNs);
     // Layout diagnostics: viewport-overflow (node bottom past the viewport) and
     // text-overflow (node right edge past its parent). Both reference the node by
     // a human-label (#id / <tag "text"> / <tag>) so the author can find it in
@@ -247,6 +248,13 @@ export function getLoweredUIModule(htmlPath) {
 export function hasUIModule(htmlPath) {
     return modules.has(path.resolve(htmlPath));
 }
+/** Stable short per-module namespace for generated symbols (link-level dedup). */
+function hashlibLike(absPath) {
+    let h = 5381;
+    for (let i = 0; i < absPath.length; i++)
+        h = ((h * 33) ^ absPath.charCodeAt(i)) >>> 0;
+    return "m" + h.toString(36);
+}
 /** All loaded UI modules (used by the emitter to inject every mounted tree). */
 export function allUIModules() {
     return [...modules.values()];

package/dist/wizard/display-catalog.d.ts

@@ -31,8 +31,6 @@ export interface DisplayCatalogEntry {
         invert?: boolean;
         antialias?: boolean;
     };
-    /** Arduino libraries the driver needs (for the printed next steps). */
-    arduinoLibraries?: string[];
     /** A wiring note printed with the summary. */
     wiringNote?: string;
 }
@@ -64,7 +62,6 @@ export interface TouchCatalogEntry {
             rx: number;
         };
     };
-    arduinoLibrary?: string;
 }
 export declare const TOUCH_CATALOG: readonly TouchCatalogEntry[];
 /**

package/dist/wizard/display-catalog.js

@@ -1,8 +1,8 @@
 // ---------------------------------------------------------------------------
 // Display + touch hardware catalog for the @typecad/ui integration wizard.
 //
-// Mirrors the built-in display profiles exported by @typecad/framework-arduino
-// (src/displays/*.ts — BUILT_IN_PROFILES) and the TouchLibrary union in
+// Mirrors the built-in display profiles exported by the active framework
+// (BUILT_IN_PROFILES) and the TouchLibrary union in
 // @typecad/cuttlefish's display-profile.ts. The wizard asks questions and
 // fills defaults from these entries; the resulting object literal is written
 // into the project's cuttlefish.config.ts `display` section.
@@ -32,7 +32,6 @@ export const DISPLAY_CATALOG = [
             colorOrder: "rgb",
             antialias: true,
         },
-        arduinoLibraries: ["Adafruit GFX Library", "Adafruit ILI9341"],
         wiringNote: "Defaults assume ESP32 VSPI: SCK=18, MOSI=23, MISO=19.",
     },
     {
@@ -57,10 +56,9 @@ export const DISPLAY_CATALOG = [
             invert: false,
             antialias: true,
         },
-        arduinoLibraries: ["Adafruit GFX Library", "Adafruit ST7735 and ST7789 Library"],
         wiringNote: "Defaults assume ESP32 VSPI: SCK=18, MOSI=23, MISO=19. Adafruit_ST7796S.h comes from the" +
             " Adafruit_ST7735_and_ST7789 fork bundled in the typecode demos (demos/demo-st/lib) —" +
-            " copy it into your sketchbook libraries/ if your Library Manager copy lacks the class.",
+            " copy it into your libraries/ folder if your Library Manager copy lacks the class.",
     },
     {
         id: "ssd1309-i2c",
@@ -75,7 +73,6 @@ export const DISPLAY_CATALOG = [
             rotation: 0,
             antialias: false,
         },
-        arduinoLibraries: ["Adafruit GFX Library", "Adafruit SSD1306"],
     },
     {
         id: "sdl",
@@ -116,7 +113,6 @@ export const TOUCH_CATALOG = [
             // Typical raw-ADC range for 320×240 modules; refine per panel.
             calibration: { xMin: 375, xMax: 3950, yMin: 200, yMax: 3750 },
         },
-        arduinoLibrary: "XPT2046_Touchscreen",
     },
     {
         id: "FT6336U",
@@ -128,7 +124,6 @@ export const TOUCH_CATALOG = [
             i2cFrequency: 400_000,
         },
         // The framework's FT6336U adapter includes RAK14014_FT6336U.h.
-        arduinoLibrary: "RAK14014-FT6336U",
     },
     {
         id: "GT911",
@@ -139,7 +134,6 @@ export const TOUCH_CATALOG = [
             i2cAddress: 0x5d,
             i2cFrequency: 400_000,
         },
-        arduinoLibrary: "GT911",
     },
     {
         id: "CST816S",
@@ -150,7 +144,6 @@ export const TOUCH_CATALOG = [
             i2cAddress: 0x15,
             i2cFrequency: 400_000,
         },
-        arduinoLibrary: "CST816S",
     },
     {
         id: "Adafruit_TouchScreen",
@@ -161,7 +154,6 @@ export const TOUCH_CATALOG = [
             analogPins: { xp: 24, yp: 25, xm: 26, ym: 27, rx: 300 },
             calibration: { xMin: 100, xMax: 900, yMin: 120, yMax: 900 },
         },
-        arduinoLibrary: "Adafruit TouchScreen",
     },
     {
         id: "Adafruit_STMPE610",
@@ -172,7 +164,6 @@ export const TOUCH_CATALOG = [
             cs: 14,
             calibration: { xMin: 375, xMax: 3950, yMin: 200, yMax: 3750 },
         },
-        arduinoLibrary: "Adafruit STMPE610",
     },
     {
         id: "adapter",

package/dist/wizard/integration-wizard.js

@@ -505,18 +505,7 @@ export async function runIntegrationWizard(cwd = process.cwd(), streams = {}) {
         console.log();
         console.log(chalk.cyan("Next steps"));
         console.log();
-        const libraries = [];
-        if (displayEntry.arduinoLibraries)
-            libraries.push(...displayEntry.arduinoLibraries);
-        if (touchEntry?.arduinoLibrary && touchRecord?.library)
-            libraries.push(touchEntry.arduinoLibrary);
-        if (libraries.length > 0) {
-            console.log("  1. Install the display/touch Arduino libraries (once per machine):");
-            console.log();
-            console.log(`     ${chalk.cyan(`arduino-cli lib install ${libraries.map((lib) => `"${lib}"`).join(" ")}`)}`);
-            console.log();
-        }
-        const firstStep = libraries.length > 0 ? 2 : 1;
+        const firstStep = 1;
         console.log(`  ${firstStep}. Preview your UI on the desktop:`);
         console.log();
         console.log(`     ${chalk.cyan(previewCommand ? "npm run preview" : "npx @typecad/cuttlefish preview")}`);
@@ -525,7 +514,7 @@ export async function runIntegrationWizard(cwd = process.cwd(), streams = {}) {
         console.log();
         console.log(`     ${chalk.cyan("npx @typecad/cuttlefish build --compile")}`);
         console.log();
-        console.log(`  ${firstStep + 2}. Flash it (set console.port in the config, or pass --port):`);
+        console.log(`  ${firstStep + 2}. Flash it (pass --port, or set CUTTLEFISH_PORT):`);
         console.log();
         console.log(`     ${chalk.cyan("npx @typecad/cuttlefish build --compile --upload")}`);
         console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typecad/ui",
-  "version": "1.0.0-alpha.14",
+  "version": "1.0.0-alpha.16",
   "description": "TypeCAD UI authoring library — HTML/CSS-driven graphics for microcontrollers",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,7 +44,7 @@
     "assets"
   ],
   "dependencies": {
-    "@typecad/cuttlefish": "1.0.0-alpha.14",
+    "@typecad/cuttlefish": "1.0.0-alpha.16",
     "chalk": "^6.0.0",
     "css-tree": "^3.2.1",
     "decode-ico": "^0.4.1",