@typecad/ui 1.0.0-alpha.13 → 1.0.0-alpha.15

package/src/ui-engine/runtime-header/tick/scroll-canvas-phase.ts

@@ -1,30 +1,30 @@
-// Slice of the C++ runtime header (original source lines 5279-5287).
-// scrollbar + buffered scroll canvas push.
-// See docs/superpowers/specs/2026-07-12-split-runtime-header-design.md.
-export function emitTickScrollCanvasPhase(): string {
-  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;`;
-}
+// Slice of the C++ runtime header (original source lines 5279-5287).
+// scrollbar + buffered scroll canvas push.
+// See docs/superpowers/specs/2026-07-12-split-runtime-header-design.md.
+export function emitTickScrollCanvasPhase(): string {
+  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/src/ui-engine/runtime-header/touch-keyboard-fwd.ts

@@ -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/src/ui-engine/runtime-header/types-defines.ts

@@ -1,116 +1,116 @@
-// Slice of the C++ runtime header (original source lines 17-89).
-// Guard open, includes, and #define knobs.
-// See docs/superpowers/specs/2026-07-12-split-runtime-header-design.md.
-export function emitTypesDefines(): string {
-  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
-`;
-}
+// Slice of the C++ runtime header (original source lines 17-89).
+// Guard open, includes, and #define knobs.
+// See docs/superpowers/specs/2026-07-12-split-runtime-header-design.md.
+export function emitTypesDefines(): string {
+  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/src/ui-engine/shadcn-kit.ts

@@ -136,6 +136,10 @@ export const SHADCN_KIT_CSS = `/* ----------------------------------------------
   padding: 10px 16px;
   font-weight: bold;
   transition: background 80ms;
+  /* Reset the UA's browser-default button border (shadcn's button reset):
+     ghost must be truly borderless — variants that want one (outline)
+     re-declare it themselves. */
+  border: none;
 }
 .btn:pressed { transform: translateY(1px); }
 .btn-primary { background: var(--primary); color: var(--primary-foreground); }

package/src/ui-engine/ui-lowering.ts

@@ -60,6 +60,7 @@ export function lowerUIToCpp(
   allScreens: StyledNode[] = [],
   imageAssetIds: Map<string, number> = new Map(),
   keyframeSets: KeyframeSetModel[] = [],
+  keyframeNs: string = "",
 ): LoweredUI {
   void storage;
   const model = lowerUIToModel(root, boxes, colorFormat, display, fontAssets, allScreens, imageAssetIds, keyframeSets);
@@ -114,7 +115,7 @@ export function lowerUIToCpp(
 
   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: [] };
 }
 
@@ -424,7 +425,7 @@ function emitTransitionTable(model: UIProgram): string {
 }
 
 /** Emit keyframe stop arrays + keyframe set index + animation table. */
-function emitKeyframeTables(model: UIProgram): string {
+function emitKeyframeTables(model: UIProgram, keyframeNs: string = ""): string {
   if (model.keyframeSets.length === 0 && model.animations.length === 0) {
     return [
       `const UIKeyframeSet __ui_keyframe_sets[] = {};`,
@@ -435,8 +436,14 @@ function emitKeyframeTables(model: UIProgram): string {
   }
   const lines: string[] = [];
   // 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<string>();
   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} },`);
@@ -446,7 +453,8 @@ function emitKeyframeTables(model: UIProgram): string {
   // 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/src/ui-engine/ui-registry.ts

@@ -237,7 +237,8 @@ export function lowerOnMount(htmlPath: string, opts: LowerOptions): LoweredUI {
 
   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
@@ -332,6 +333,13 @@ export function hasUIModule(htmlPath: string): boolean {
   return modules.has(path.resolve(htmlPath));
 }
 
+/** Stable short per-module namespace for generated symbols (link-level dedup). */
+function hashlibLike(absPath: string): string {
+  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(): UIModule[] {
   return [...modules.values()];