@ultralabs/glass 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/CHANGELOG.md +326 -0
  2. package/DESIGN.md +682 -0
  3. package/LICENSE +21 -0
  4. package/README.md +690 -2
  5. package/dist/esm/index.js +20991 -0
  6. package/dist/types/src/charts/ULCartesianChart.d.ts +177 -0
  7. package/dist/types/src/charts/ULDonutChart.d.ts +65 -0
  8. package/dist/types/src/charts/ULFunnelChart.d.ts +64 -0
  9. package/dist/types/src/charts/ULHeatmapChart.d.ts +40 -0
  10. package/dist/types/src/charts/ULRadarChart.d.ts +19 -0
  11. package/dist/types/src/charts/ULRadialChart.d.ts +48 -0
  12. package/dist/types/src/charts/ULScatterChart.d.ts +49 -0
  13. package/dist/types/src/charts/core.d.ts +287 -0
  14. package/dist/types/src/charts/decimate.d.ts +8 -0
  15. package/dist/types/src/charts/nav.d.ts +368 -0
  16. package/dist/types/src/charts/quadtree.d.ts +9 -0
  17. package/dist/types/src/charts/scales.d.ts +59 -0
  18. package/dist/types/src/charts/timeseries.d.ts +56 -0
  19. package/dist/types/src/components/ULAnchoredSurface/ULAnchoredSurface.d.ts +72 -0
  20. package/dist/types/src/components/ULBatch2/carousel.d.ts +31 -0
  21. package/dist/types/src/components/ULBatch2/hovercard.d.ts +40 -0
  22. package/dist/types/src/components/ULBatch2/layout.d.ts +16 -0
  23. package/dist/types/src/components/ULBatch2/menubar.d.ts +29 -0
  24. package/dist/types/src/components/ULBatch2/navmenu.d.ts +51 -0
  25. package/dist/types/src/components/ULBatch2/resizable.d.ts +48 -0
  26. package/dist/types/src/components/ULBatch2/typography.d.ts +55 -0
  27. package/dist/types/src/components/ULButton/ULButton.d.ts +87 -0
  28. package/dist/types/src/components/ULContainers/ULCard.d.ts +54 -0
  29. package/dist/types/src/components/ULContainers/ULDialog.d.ts +57 -0
  30. package/dist/types/src/components/ULContainers/ULLayout.d.ts +81 -0
  31. package/dist/types/src/components/ULContainers/ULMenu.d.ts +99 -0
  32. package/dist/types/src/components/ULContainers/ULOverlays.d.ts +113 -0
  33. package/dist/types/src/components/ULContainers/contextTarget.d.ts +91 -0
  34. package/dist/types/src/components/ULData/ULData.d.ts +225 -0
  35. package/dist/types/src/components/ULData/ULKpi.d.ts +159 -0
  36. package/dist/types/src/components/ULField/ULField.d.ts +93 -0
  37. package/dist/types/src/components/ULForms/fieldContext.d.ts +39 -0
  38. package/dist/types/src/components/ULForms/forms.d.ts +143 -0
  39. package/dist/types/src/components/ULIsland/ULIsland.d.ts +39 -0
  40. package/dist/types/src/components/ULIsland/headerConfig.d.ts +43 -0
  41. package/dist/types/src/components/ULIsland/navIndicator.d.ts +26 -0
  42. package/dist/types/src/components/ULListbox/ULListbox.d.ts +75 -0
  43. package/dist/types/src/components/ULPickers/ULPickers.d.ts +141 -0
  44. package/dist/types/src/components/ULSegmented/ULSegmented.d.ts +50 -0
  45. package/dist/types/src/components/ULSelection/ULSelection.d.ts +71 -0
  46. package/dist/types/src/components/ULSlider/ULSlider.d.ts +43 -0
  47. package/dist/types/src/components/ULSpinner/ULSpinner.d.ts +8 -0
  48. package/dist/types/src/components/ULStructure/kbd.d.ts +22 -0
  49. package/dist/types/src/components/ULStructure/structure.d.ts +154 -0
  50. package/dist/types/src/components/ULTabs/ULTabs.d.ts +28 -0
  51. package/dist/types/src/components/ULTooltip/anchoredTooltip.d.ts +22 -0
  52. package/dist/types/src/components/actions/actions.d.ts +175 -0
  53. package/dist/types/src/components/actions/core.d.ts +346 -0
  54. package/dist/types/src/components/dashboard/blocks.d.ts +583 -0
  55. package/dist/types/src/components/dashboard/blocks2.d.ts +297 -0
  56. package/dist/types/src/components/dashboard/columnsDrag.d.ts +27 -0
  57. package/dist/types/src/components/shared/ULCheckMark.d.ts +9 -0
  58. package/dist/types/src/components/shared/dev.d.ts +13 -0
  59. package/dist/types/src/components/shared/icons.d.ts +23 -0
  60. package/dist/types/src/glass/ULGlass.d.ts +78 -0
  61. package/dist/types/src/glass/ULGlassGroup.d.ts +16 -0
  62. package/dist/types/src/glass/accent.d.ts +31 -0
  63. package/dist/types/src/glass/contrast.d.ts +78 -0
  64. package/dist/types/src/glass/engine.d.ts +177 -0
  65. package/dist/types/src/glass/glassDebug.d.ts +27 -0
  66. package/dist/types/src/glass/material.d.ts +49 -0
  67. package/dist/types/src/glass/radius.d.ts +2 -0
  68. package/dist/types/src/hooks/useAnchoredMorph.d.ts +20 -0
  69. package/dist/types/src/hooks/usePointerLight.d.ts +6 -0
  70. package/dist/types/src/hooks/useReducedMotion.d.ts +3 -0
  71. package/dist/types/src/index.d.ts +150 -0
  72. package/dist/types/src/island/sectionAccent.d.ts +18 -0
  73. package/dist/types/src/live/ULLiveStatus.d.ts +18 -0
  74. package/dist/types/src/live/liveQueue.d.ts +13 -0
  75. package/dist/types/src/live/liveSource.d.ts +149 -0
  76. package/dist/types/src/live/liveStore.d.ts +72 -0
  77. package/dist/types/src/motion/anchoredMorph.d.ts +175 -0
  78. package/dist/types/src/motion/goo.d.ts +3 -0
  79. package/dist/types/src/motion/lensBubble.d.ts +143 -0
  80. package/dist/types/src/motion/lensSelect.d.ts +31 -0
  81. package/dist/types/src/motion/overlayStack.d.ts +13 -0
  82. package/dist/types/src/motion/placement.d.ts +18 -0
  83. package/dist/types/src/motion/spring.d.ts +20 -0
  84. package/dist/types/src/motion/topLayer.d.ts +13 -0
  85. package/dist/types/src/motion/viewSwap.d.ts +33 -0
  86. package/dist/types/src/motion/virtualAnchor.d.ts +28 -0
  87. package/dist/ul-glass.css +10519 -0
  88. package/dist/ul-glass.js +21034 -0
  89. package/dist/ul-glass.min.js +14 -0
  90. package/dist/ul-glass.min.js.map +7 -0
  91. package/icons/arrow-up-down.svg +5 -0
  92. package/icons/bell.svg +3 -0
  93. package/icons/bold.svg +2 -0
  94. package/icons/calendar.svg +5 -0
  95. package/icons/check.svg +2 -0
  96. package/icons/chevron-down.svg +2 -0
  97. package/icons/chevron-left.svg +2 -0
  98. package/icons/chevron-right.svg +2 -0
  99. package/icons/chevrons-right.svg +3 -0
  100. package/icons/circle-check.svg +3 -0
  101. package/icons/circle-x.svg +4 -0
  102. package/icons/circle.svg +2 -0
  103. package/icons/copy.svg +3 -0
  104. package/icons/ellipsis.svg +4 -0
  105. package/icons/eye.svg +3 -0
  106. package/icons/filter.svg +2 -0
  107. package/icons/flags/LICENSE.md +2 -0
  108. package/icons/flags/cs.svg +1 -0
  109. package/icons/flags/de.svg +1 -0
  110. package/icons/flags/en.svg +1 -0
  111. package/icons/flags/sk.svg +1 -0
  112. package/icons/folder-kanban.svg +5 -0
  113. package/icons/icons.json +1 -0
  114. package/icons/inbox.svg +3 -0
  115. package/icons/info.svg +4 -0
  116. package/icons/layout-dashboard.svg +5 -0
  117. package/icons/layout-grid.svg +5 -0
  118. package/icons/loader-circle.svg +2 -0
  119. package/icons/lock.svg +3 -0
  120. package/icons/mail.svg +3 -0
  121. package/icons/menu.svg +4 -0
  122. package/icons/minus.svg +2 -0
  123. package/icons/panel-left-close.svg +4 -0
  124. package/icons/plus.svg +3 -0
  125. package/icons/refresh-cw.svg +5 -0
  126. package/icons/search.svg +3 -0
  127. package/icons/shield-check.svg +3 -0
  128. package/icons/shopping-bag.svg +4 -0
  129. package/icons/sparkles.svg +6 -0
  130. package/icons/trash-2.svg +6 -0
  131. package/icons/triangle-alert.svg +4 -0
  132. package/icons/upload.svg +4 -0
  133. package/icons/users.svg +5 -0
  134. package/icons/x.svg +3 -0
  135. package/package.json +65 -4
  136. package/tokens/tokens.css +799 -0
  137. package/tokens/tokens.json +1017 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,326 @@
1
+ # Changelog
2
+
3
+ ## 0.1.1 — 2026-11-22
4
+ ### Fixed
5
+ - Menus, selects and popovers no longer flash after their open animation settles (UL-635). Cause: the surface switched its `backdrop-filter` to an SVG `url(#ul-refraction-…)` filter at settle, and Chrome paints such a filter with no backdrop at all until it has built it (about 0.5 s on the first open while the displacement map decodes, one frame afterwards). Anchored overlays (`.ul-anchored`) now always use the lite material (CSS blur + colour, built instantly), and their morph carries the blur on a separate shell element that hands over to the settled surface (the island → dialog pattern).
6
+ - Button labels keep descenders (g, j, p, y) when a consumer clips the label for an ellipsis: `.ul-btn` has `line-height: 1`, the label now has `.2em` block padding with a matching negative margin (layout unchanged).
7
+ - Listbox inside an anchored surface: the scroll area reaches the surface edge, so the floating selection indicator is no longer cut off above the first item.
8
+ ### Changed
9
+ - Anchored overlays never refract (see above). Use refraction on in-flow surfaces; for a large surface that must refract regardless of the area budget, pass `quality="full"`.
10
+
11
+ ## 0.1.0 — 2026-11-10
12
+ Not tagged, not published (owner: docs/release-checklist.md). Earlier per-task records below are kept as history.
13
+ ### Added
14
+ - `ULProvider` with `material`: "glass" | "flat" or per category `{ default?, inputs?, controls?, surfaces?, overlays?, chrome? }`. Nearest provider wins per category.
15
+ - Instance prop `material` ("glass" | "flat") on ULGlass (+ `materialCategory`), ULButton, ULSwitch, ULTextField, ULTextArea, ULNumberField, ULOtpField, ULTagField, ULSelect, ULCombobox, ULNativeSelect, ULInputGroup, ULCopyField, ULDatePicker, ULDateRangePicker, ULColorPicker, ULTimeRange.
16
+ - Non-React path: `data-ul-material="glass|flat"` on any element (nearest attribute wins; engine + CSS).
17
+ - Exports: `useMaterial`, `resolveMaterial`, `mergeMaterialScope`, `MATERIAL_DEFAULTS`, `MATERIAL_CATEGORIES`, `isFlatMaterial`; types `Material`, `MaterialCategory`, `MaterialConfig`, `ULProviderProps`.
18
+ - Package entry points for consumers: `.` → `dist/esm/index.js` (ESM, React external) with types `dist/types/src/index.d.ts` (types first in the exports map); `./package.json`. Scripts `build:esm`, `build:types` (tsconfig.build.json), `build:release`. Verified 2026-11-10; `build:types` post-processes dist/types (`scripts/fix-dts-extensions.mjs`) so `.d.ts` imports use `.js`.
19
+ - `npm run check:api` (scripts/api-surface.mjs, snapshot docs/api-surface.txt: 674 exports on `.`, same surface on `./dist` and `./dist/min`) and `npm run check:pack` (scripts/check-pack.mjs).
20
+ - examples/vite-smoke (not published) for the post-publish install test.
21
+ ### Changed
22
+ - Inputs default to flat. Visible change: date / date-range / colour picker triggers (and ULTimeRange's custom range trigger) render the field inset well instead of glass; field wells (text, textarea, number, tag, combobox) lose the pointer light. Select, native select, OTP, input group and copy field were already flat wells: no visible change. Picker / select / combobox popovers stay glass.
23
+ - Flat primary / destructive buttons keep their accent fill (shared flat rule in ULGlass.css; was the grey deep-accent plate). Secondary and ghost unchanged; reduced-transparency look unchanged.
24
+ - Flat picker triggers (date, date range, colour, ULTimeRange custom range) use the text / select inset well instead of a solid plate. Popovers stay glass.
25
+ - ULOtpField sizes to its container (cells 48 → min 36px, gap 8 → 4px); fixes the sixth cell overflowing narrow cards. Normal width unchanged.
26
+ - OTP: only the focused box shows the focus ring (all six lit before). --ul-field-rim .14 → .18 (rim vs page 2.83 → 3.11:1).
27
+ - Tests: material card + flat-primary, picker-well; new card otplayout (375 / 480 / 720).
28
+ - ULTable row actions ⋯: icon-only on hover / focus (no background, no rim; the icon brightens to --ul-color-text); glass only while its menu is open.
29
+ - Callback naming, no aliases (breaking vs pre-release): ULDateRangePicker, ULFilterBar, ULTimeRange `onChange` → `onValueChange`; ULColumnsMenu `state` / `onChange` → `value` / `onValueChange`; ULToggleIconButton `onChange` → `onPressedChange`; useColumnsState and observeSectionAccent option `onChange` → `onValueChange`. Added ULCheckbox `onCheckedChange`.
30
+ - `ULChartV1` removed; use `ULChart` (same props).
31
+ - peerDependencies react / react-dom `^19.0.0` (the tested range; was `>=18.3 <20`).
32
+ - package.json: `.` no longer points at `src/index.ts`; `src` is not published (dist/esm + dist/types replace it). `sideEffects` = CSS + the two window.UL bundles. `main` / `module` / `types` point at the ESM build.
33
+ ### Fixed
34
+ - ULOtpField sixth cell overflowing narrow cards; only the focused OTP box shows the ring.
35
+ - Context menus: open immediately when closed or closing, re-aim only when open; a pending re-aim is cancelled by any close (interrupt jump, leftover surface).
36
+ - ULSwitch flick velocity decays over 60 ms (documented value); ULFilterBar saved view without onApplyView threw (called removed `onChange`).
37
+ - ULGlass `pressScale` reaches the engine (picker triggers press at .98 again); ULMenuButton forwards `closeOnSelect`; ULIsland HEADER_DEFAULTS.poppers = ['lang'].
38
+ - ULTable overlay horizontal scrollbar covered the last row (reserves --ul-table-hscroll-room); ULCalendar month / year selects 44px; ULMenu focus on every open; ULPagination arrow-key focus; ULTabs aria-controls only for rendered panels.
39
+ - ULCodeBlock multi-line block comments; bash `#` only at line start / after whitespace.
40
+ ### Known limits
41
+ - OTP cells shrink to 36px wide at a 280px container; the hitarea card only tests the normal width.
42
+ - Flat vs reduced transparency differ for primary / destructive buttons (flat keeps the accent fill, reduced transparency stays a dark deep-accent plate).
43
+ - --ul-field-rim raised .14 → .18 (3.11:1); this also affects the field border in glass.
44
+ - Timing / fps cards are valid only on a ≥ 100 Hz display in Chrome; Safari runs rAF at 60 Hz.
45
+ - Dark-only in v1; no RTL (plan in docs/rtl-audit.md). JSDoc 85 % overall, 33 % in the "other" family (v0.1.1).
46
+ - v0.2: ULMenubar re-anchor, header megamenu → ULNavigationMenu, lazy-loaded action icons.
47
+ - Copy field well has no hover / invalid / disabled state (no props for them).
48
+ - 1 moderate npm audit finding, package not yet identified.
49
+
50
+ ## Pre-release record: 0.1.0 Unreleased (step 4A–4C+)
51
+ ### Added (public API)
52
+ - `ULProvider` with `material`: "glass" | "flat" or per category `{ default?, inputs?, controls?, surfaces?, overlays?, chrome? }`. Nearest provider wins per category.
53
+ - Instance prop `material` ("glass" | "flat") on ULGlass (+ `materialCategory`), ULButton, ULSwitch, ULTextField, ULTextArea, ULNumberField, ULOtpField, ULTagField, ULSelect, ULCombobox, ULNativeSelect, ULInputGroup, ULCopyField, ULDatePicker, ULDateRangePicker, ULColorPicker, ULTimeRange.
54
+ - Non-React path: `data-ul-material="glass|flat"` on any element (nearest attribute wins; engine + CSS).
55
+ - Exports: `useMaterial`, `resolveMaterial`, `mergeMaterialScope`, `MATERIAL_DEFAULTS`, `MATERIAL_CATEGORIES`, `isFlatMaterial`; types `Material`, `MaterialCategory`, `MaterialConfig`, `ULProviderProps`.
56
+ ### Changed (default look)
57
+ - Inputs default to flat. Visible change: date / date-range / colour picker triggers (and ULTimeRange's custom range trigger) render the field inset well instead of glass; field wells (text, textarea, number, tag, combobox) lose the pointer light. Select, native select, OTP, input group and copy field were already flat wells: no visible change. Picker / select / combobox popovers stay glass.
58
+ - Flat primary / destructive buttons keep their accent fill (shared flat rule in ULGlass.css; was the grey deep-accent plate). Secondary and ghost unchanged; reduced-transparency look unchanged.
59
+ - Flat picker triggers (date, date range, colour, ULTimeRange custom range) use the text / select inset well instead of a solid plate. Popovers stay glass.
60
+ - ULOtpField sizes to its container (cells 48 → min 36px, gap 8 → 4px); fixes the sixth cell overflowing narrow cards. Normal width unchanged.
61
+ - OTP: only the focused box shows the focus ring (all six lit before). --ul-field-rim .14 → .18 (rim vs page 2.83 → 3.11:1).
62
+ - Tests: material card + flat-primary, picker-well; new card otplayout (375 / 480 / 720).
63
+ - ULTable row actions ⋯: icon-only on hover / focus (no background, no rim; the icon brightens to --ul-color-text); glass only while its menu is open.
64
+
65
+ ## Pre-release record: pre-freeze audit and fixes
66
+ ### Pre-freeze fixes
67
+ - package: peerDependencies react / react-dom ">=18.3 <20"; devDependencies @types/react ^19, @types/react-dom ^19. ULIsland HEADER_DEFAULTS.poppers = ['lang'] (stale 'acct' rendered a second language button in the fallback tools).
68
+ - Typecheck pass (unverified until the owner reruns tsc): ULActionButton family omits the native `onError` (onError = action error callback); ULCopyButton omits native `onCopy` (onCopy(text) kept); ULSubmitButton omits native `onSubmit` (action kept). ULAnchoredSurface types `accent` / `accentStrength` (already forwarded at runtime). ULGlass: `pressScale` now reaches the engine (was leaking to the DOM; picker triggers press at .98 again) and ULGlassProps types the forwarded `type` / `disabled` / `name` / `form` / `href` / `target` / `rel` / `download` / `hrefLang`. ULMenuButton forwards `closeOnSelect` (the columns menu stays open while toggling). ULFilterBar saved view without onApplyView called a removed `onChange` (ReferenceError) → onValueChange. Charts: splitChartCtx generic over the props and inferred target type.
69
+ - Focused runs (fixes 3): context menus (ULContextMenu + useContextMenuTarget) open immediately when closed or closing and re-aim on the next frame only when open; a pending re-aim is cancelled by any close (fixes the interrupt jump and the leftover surface after rapid cycles). ULSwitch flick: velocity decays over 60 ms (as documented, was 40) and the flick threshold applies to the gesture speed. ULCodeBlock: multi-line block comments highlighted; bash # only at line start / after whitespace. Tests: limits relative to the measured refresh (p95 ≤ 1.15 × period, fps ≥ 0.9 × rate), segmented well check skips on fallback tiers, one hit-area probe for hitarea + a11ystatic, harness charts marked data-ul-illustration, kbdaudit initialFocus-null fixture flag. showcase/focused-runs.dc.html (owner launcher), lens-tests ?card=<id>, probe-ctx.dc.html.
70
+ - Hit area (fixes 2): overlay horizontal scrollbar of ULTable covered the last row's bottom 4px → ULTable reserves --ul-table-hscroll-room (16px, new token) below the table only when it scrolls horizontally with an overlay scrollbar; hit layer in table cells capped to the row height (--ul-hit-size); "+n" tag chip gets the vertical hit layer. showcase/probe-cells.dc.html. hitarea PASS (1,086 controls, 0 effective < 44).
71
+ - Visual: ULCalendar month / year native selects 44px tall (were 36px); shot docs/shots/4-calendar-dropdowns.png.
72
+ - Decisions recorded (DESIGN "Decisions"): 7 callback renames accepted as breaking for 0.1.0; 27 unused tokens reserved (docs/tokens-reserved.md); calendar day grid = documented 44px exception (43px, WCAG 2.5.8 ≥ 24px).
73
+ - JSDoc defaults: scripts/check-jsdoc-defaults.mjs (part of check:jsdoc): 299 checked, 195 matched, 40 docs corrected, 104 reviewed by hand, 0 mismatch.
74
+ - 0: typecheck skipped (no tsc output pasted).
75
+ - 5: viewport-tests: one frame at a time (`?frame=1280|924|375`; without it the frames run in sequence, only one iframe mounted); vt-frame loads the minified bundle + harness only, every step loads its demos and mounts fixtures lazily; steps toast → radius → narrow → submenu → layout (overflow, icons, control text) → charts (3A + 3B) → batch 1 / 2, sequential with progress, per-step timeout = NEEDS HEALTHY PREVIEW. All three frames PASS in this preview.
76
+ - 4: JSDoc on every public prop of actions, fields + pickers, selection, overlays, data and charts (100 % each; overall 26 % → 85 %); scripts/check-jsdoc.mjs + `npm run check:jsdoc` (per-family coverage, `--list` for gaps). Comments only, no behaviour change.
77
+ - 3: token integrity: scripts/check-tokens.mjs + `npm run check:tokens` (in build): 268 files, 5,801 reads, 809 names, 0 undefined, 27 tokens unused (docs/_unused-tokens.txt). New tokens (values = the code's former fallbacks): tooltip.bg / tooltip.ink, fgroup.min, ease.spring, field.well-shadow, glass.fringe-w / glass.fringe, color.ink, z.veil. Restored from the DESIGN 3B record: --ul-chart-ring .52 (was re-derived as .50). Chart contrast re-run (shared tool): 8,800 rows, 0 fail. Shots docs/shots/4-chart-colours-*.
78
+ - 2: callback naming applied (list under breaking); migrated src, showcase (10 demo files), landing SiteHeader; guard scripts/check-callbacks.mjs + `npm run check:callbacks` (in build / build:min): 237 files checked, 0 violations.
79
+ - 1: shared hit layer src/components/shared/hit.css (.ul-hit / .ul-hit-y / .ul-hit-layer, test hook html[data-ul-hit="off"]); replaces five per-component layers; ULSelect trigger gets the layer; ULCalendar month / year native selects 44px min. Card hitarea (guard; motion-test ?norun&card=hitarea, probe-charts ?cards=hitarea): 1,027 library controls, 550 visually < 44; effective < 44: 466 with the layer off → 1 with it (ULCellId copy button in a table cell, open), 0 neighbour overlaps, lens geometry identical.
80
+ ### Breaking vs pre-release (listed in 0.1.0 Changed)
81
+ - Callback naming (pre-freeze fixes, item 2), no aliases: ULDateRangePicker `onChange` → `onValueChange`; ULFilterBar `onChange` → `onValueChange`; ULColumnsMenu `state` → `value`, `onChange` → `onValueChange`; ULTimeRange `onChange` → `onValueChange`; ULToggleIconButton `onChange` → `onPressedChange`; useColumnsState option `onChange` → `onValueChange`; observeSectionAccent option `onChange` → `onValueChange`. Added: ULCheckbox `onCheckedChange` (the inherited native `onChange` event is still forwarded). Same payloads, no meaning change.
82
+ - `ULChartV1` export removed (deprecated 2d chart body). Migration: use `ULChart` — same props (`ULChartProps`, `ChartSeries`, `ChartTargetData` unchanged); no ULChart prop changed meaning.
83
+ ### Audit
84
+ - 0: static pass (no tsc output pasted): 0 missing relative imports, 0 file-level import cycles (3 folder-level two-way edges: ULContainers↔ULStructure, ULForms↔actions, ULButton stories↔index), 69 exports not imported anywhere (37 story exports, 16 types, 16 helpers exported for tests/internal use; none removed), 9 `any` in src (no public prop typed any).
85
+ - 1: ULChartV1 + private niceMax removed from ULData.tsx and index.ts; grep: no reference in src, showcase, landing, apps; dist rebuilt (ul-glass.js 1,608,854 B · css 272,154 B · min 1,042,501 B).
86
+ - 2: ULScatterChart `renderer` 'auto' | 'svg' | 'canvas' (auto above --ul-chart-canvas-at); canvas keeps shapes, trends, selection dimming, tooltip, keys, brush, ctx targets, table. Card scattercanvas (demos-3d.js; motion-test + probe-charts ?cards=scattercanvas). Shots docs/shots/2-scatter-svg-vs-canvas.jpg.
87
+ - 3: ULColumnsMenu drag reorder (columnsDrag.ts; grip icon grip-vertical; tokens --ul-cols-drag-bg, --ul-cols-drag-shadow, --ul-cols-grip-ink; strings moved / dragCancel EN·SK·DE·CS). Test hooks reorderKeys, dragSlot, columnsDragStats (@internal). Card colsdrag.
88
+ - 4: kbdaudit card (showcase/demos-kbd.js). Fixes: ULMenu moves focus into the menu on every open (cold first open, context-menu reopen) with a per-frame retry + morph-end retry; ULPagination arrow keys keep focus on the selected page (segment values = page numbers).
89
+ - 5: forced reduced transparency (`?transparency=reduce`, `html[data-ul-transparency="reduce"]`); card fallback; docs/fallback-audit.md (0 failures in lite / flat / reduced transparency).
90
+ - 6: docs/component-inventory.md (170 components, status, API audit).
91
+ - 7: docs/contrast-matrix-v0.1.md (20,400 checks, 0 fail). Restored 23 chart tokens missing from tokens.json (heatmap / calendar / treemap scales, radar ring, brush, track, cell ink, danger ink, live pulse, canvas switch point); --ul-chart-danger-ink oklch(0.88 0.075 25).
92
+ - 8: card a11ystatic; ULTabs aria-controls only points at a rendered panel; dead CSS removed (old chart / pagination / modal head classes); no module-level listeners in blocks.tsx / charts core; docs/a11y-size-sweep.md (bundle numbers, sideEffects proposal).
93
+ - 9: viewport frames load the batch 1 / batch 2 / advanced chart demos; docs/freeze-readiness.md; BRIEF / CLAUDE.md updated. Version not bumped, not tagged.
94
+
95
+ ## 2026-11-09 (Task 3D — shadcn batch 2)
96
+ - 0: locked-timing guard. scripts/locked-timings.json lists all 42 locked names (lens 23, switch 3, selection-switch 4, tabs 2, slider 1, pop 6, springs 3); scripts/check-locked.mjs compares tokens.json, tokens.css (:root) and DESIGN.md and prints "42 checked, N differences". Runs in build-tokens, build-bundle and `npm run check:locked`. Current: 42 checked, 0 differences.
97
+ - 1: ULHoverCard (src/components/ULBatch2/hovercard.tsx) on ULPopover; tokens --ul-hovercard-open-delay / -close-delay / -w; demos-3h.js (ULDemos.Batch2), Components → "Navigation + layout (3D)" tab, probe-forms ?only=batch2, test card hovercard (demos-3i.js, f3d_hovercard).
98
+ - 2: ULMenubar (menubar.tsx) + tokens --ul-menubar-*; menu shortcuts render with ULKbd (ULKbd moved to ULStructure/kbd.tsx, re-exported); card menubar (f3d_menubar). scripts/rebuild-all-in-browser.js (tokens → check → bundle → min).
99
+ - 3: ULNavigationMenu (navmenu.tsx) + --ul-navmenu-panel-w; panel swap on one surface via runViewSwap; sheet + drill-in below 640px; card navmenu (f3d_navmenu).
100
+ - 4: ULNativeSelect + ULSelect `native` (ULListbox.tsx), ULCalendar (ULPickers.tsx), ULAspectRatio (ULBatch2/layout.tsx); tokens --ul-calendar-*; cards nativeselect, calendar, aspect.
101
+ - 5: ULResizablePanelGroup / ULResizablePanel / ULResizableHandle (resizable.tsx) + --ul-resizable-*; card resizable (f3d_resizable).
102
+ - 6: ULCarousel (carousel.tsx) + --ul-carousel-*; icons pause / play / external; card carousel (f3d_carousel).
103
+ - 7: typography tokens --ul-type-* + ULHeading, ULText, ULCode, ULBlockquote, ULList, ULLink, ULProse (typography.tsx / .css); card typography (f3d_typography).
104
+ - 8: RTL audit (showcase/probe-rtl.dc.html + demos-rtl.js, docs/rtl-audit.md; RTL unsupported in v0.1). Guards extended to the 3D demos and overlays (PASS at 1280×800, 924×540, 375×667; fixes: calendar day cells shrink in narrow containers, horizontal scrollers marked data-ul-allow-overflow). Contrast card contrast3d (350 rows, 0 fail). motion-test cases f3d*. dist rebuilt (1,623,783 B; min 1,051,387 B). Locked: 42 checked, 0 differences.
105
+
106
+ ## 2026-11-09 (Task 3C — contrast tool, forms, feedback, coverage)
107
+ - Owner fixes: morph stage uses the fractional content size (no text re-wrap during any overlay morph); action buttons inside overlays reset to idle when the overlay closes; ULSelect trigger = field well; accent-tinted field wells and rims (--ul-field-accent-mix, --ul-field-rim-accent-mix + hover).
108
+ - 0a: one shared contrast tool showcase/ul-contrast.js (waits for stylesheets / fonts / tokens, CSS Color 4 parsing + gamut mapping, compositing, throws on unresolved). Chart report rewritten on it (per chart type) + new action-button report (probe-charts ?contrast / ?actions).
109
+ - 0b: Components → Charts has a lazily mounted "Charts (advanced)" section (same demos as probe-charts ?adv).
110
+ - 1: docs/shadcn-coverage.md (shadcn/ui reference list → UL names, status, 3D proposals).
111
+ - 2: ULField, ULLabel, ULFieldError, ULFieldGroup, ULFieldSet, ULInputGroup (+ ULInputGroupInput, ULInputGroupButton), field / group context (ULTextField, ULTextArea, ULNumberField, ULOtpField, ULTagField, ULSelect and ULCopyButton read it), ULKbd (needed by input groups). README form recipe.
112
+ - 3: ULAlert, ULAlertDialog (+ useAlertDialog push, ULConfirmPopover), ULToggleGroup, ULSeparator, ULKbd, ULItem (+ ULItemGroup), ULCollapsible, ULScrollArea (+ scrollThumb). ULTypeToConfirm shared with ULConfirmAction. ULBanner reads --ul-tone-*. Icons info, warning, circle-check.
113
+ - Tokens 3C: --ul-kbd-*, --ul-sep-*, --ul-scroll-*, --ul-item-*, --ul-tone-*, --ul-alert-*, --ul-collapsible-* (aliases of the colour-picker expansion timings).
114
+ - 4: Components → Forms and Feedback tabs (lazy); probe-forms.dc.html; 12 test cards (motion-test f3c_*), guard cards extended (3C demos + kbd / toggle / addon / separator / collapsible selectors); contrast fixes --ul-field-error-text 44 %, --ul-scroll-thumb .6 / hover .78, --ul-alert-desc-ink = text.
115
+ - Tokens: --ul-chart-bar-fade 0.88 (bar bottom stop, was .72), --ul-chart-spk-bar-opacity 0.88 (was .78), --ul-chart-win / --ul-chart-loss. Chart matrix 8800 rows 0 fail, action matrix 2340 rows 0 fail.
116
+
117
+ ## 2026-11-09 (Task 3B — advanced charts, zoom, streaming, linking)
118
+ - motion-test: minified bundle, fixtures mount lazily (ensureFixtures), `?card=` never starts the suite, load meter (showcase/load-meter.js). Loads in ≈ 1.2 s (was: timeout).
119
+ - New: ULRadialChart, ULGaugeChart, ULRadarChart, ULScatterChart (+ quadtree, brush), ULHeatmapChart, ULCalendarHeatmap, ULFunnelChart, ULHistogramChart (binValues, quantile), ULTreemapChart (squarify, drill-in).
120
+ - Shared: src/charts/nav.tsx (useMarkNav, ChartBaseProps, ChartAxes, useBrush, colorScale + ColorLegend, useCellIndicator, advText), ChartSkeleton shapes gauge / radar / scatter / grid / funnel / treemap, SeriesKey / LegendItem `shape`, useChartTween `enabled`.
121
+ - ULCartesianChart: `zoom`, `range`, `onRangeChange`, `highlight`, `renderer`, `decimate`, `xDomain`, `liveBead`, `animate`; time hover uses binary search; tick labels anchor at the plot edges.
122
+ - Streaming: createChartStream, ULStreamChart; lttb, canvasThreshold.
123
+ - Fixes: ULProgress ring cap had no CSS (rendered black) → shared .ul-gloss-cap; chart empty / error states have a 160px floor (short heatmaps overflowed); ULBreadcrumbs `embedded` (flat lens inside a panel) and `Crumb.onSelect`.
124
+ - Tokens: --ul-chart-track, --ul-chart-ring, --ul-chart-seq-0…6, --ul-chart-div-0…6, --ul-chart-cell-ink-dark / -light, --ul-chart-cell-empty, --ul-chart-danger-ink, --ul-chart-brush / -edge, --ul-chart-trend, --ul-chart-overview-h, --ul-chart-live-pulse, --ul-chart-canvas-at.
125
+ - Contrast: 4480 rows, 0 fail. Guards: PASS at 1280×800, 924×540, 375×667 (30 panels).
126
+
127
+ ## 2026-11-08 (Task 3B — chart polish and verification)
128
+ - `patterns` prop (auto | on | off) on every chart; usePatternPolicy; legend swatches mirror patterns; --ul-chart-pattern-opacity.
129
+ - Contrast measured (2060 combinations, 0 fail) after chart-token fixes: --ul-chart-l-min, lighter s1/s3/s5, white pattern ink, --ul-chart-ref-neutral/success/warning/danger, --ul-chart-ref-label, --ul-chart-stale-ink/-bg; threshold bands get tone edges.
130
+ - Fixes: table toggle exposes aria-pressed; hidden crosshair band no longer overflows the panel; pinned tooltip clamps to the live plot width.
131
+ - Tests: chart part of layoutoverflow / iconsize / ctrltext; ten chart cards; probe-charts ?guard / ?cards; showcase/chart-contrast.js; chartStats test hook.
132
+
133
+ ## 2026-11-08 (Task 3A — charts)
134
+ - New shared chart core `src/charts/`: scales (linear, log, band, point, time), nice ticks, locale formats (EN/SK/DE/CS, compact, tabular), monotone / linear paths with null gaps, arcs.
135
+ - ULCartesianChart + ULLineChart / ULAreaChart / ULBarChart / ULComboChart; ULDonutChart / ULPieChart; ULSparkChart (line, area, bars, winloss). ULKpiCard `trend`.
136
+ - ChartFrame: lite glass panel, title / description, CSV (ULDownloadButton), copy (ULCopyButton), "View as table", legend chips (ULCheckMark), loading / empty / error / stale states, sr summary + polite live region.
137
+ - Snapped value tooltip (slider-tooltip shape, opaque), one positioner transform per frame; keyboard navigation, pin / Esc, touch tap, contextMenu targets point / series / plot.
138
+ - ULChart keeps its 2d props and renders through the core; the old implementation (ULChartV1) was removed in the pre-freeze audit; no ULChart prop changed.
139
+ - Tokens: --ul-chart-pad, -draw, -morph, -fade, -bead-ms, -tick-ink, -tick-size, -band-opacity, -pattern-ink, -dim. Palette --ul-chart-s0…s5 derived from the accent in charts.css.
140
+ - Showcase: Components → Charts tab, showcase/probe-charts.dc.html; probe pages load dist/ul-glass.min.js (scripts/minify-in-browser.js).
141
+ ## 2026-11-08 (Task 2F)
142
+ - ULIcon: size token scale --ul-icon-xs/sm/md/lg/max, explicit box (fixes the stretched chevron in ULErrorState and the refresh interval button). Inline svgs migrated; charts / sparkline / progress ring marked data-ul-illustration.
143
+ - ULErrorState relaid out + `embedded`; ULFilterBar chip one line (--ul-control-chip-h), truncated value with tooltip; ULCopyField grid + container query; .ul-btn-label one line.
144
+ - ULNotificationCenter covered by default (`anchorVisibility`), close button; ULPopover `anchorVisibility` / `closeButton` / `closeLabel`; ULAnchoredSurface `overlapAnchor`; computePlacement `cover`; MorphOptions `overlap` (poses always contain the anchor).
145
+ - Popover content width rule; top-layer popovers keep their max-width. ULCopyButton `buttonVariant`; ULCellId copy button plain (no glass per row). ULActionButton: no forced layout per instance on mount.
146
+ - Tokens: --ul-icon-*, --ul-control-chip-h, --ul-popover-cover-inset.
147
+ - Showcase: demo-lazy.js (lazy sections, live demos only while visible), Components ?tab=, probe-blocks.dc.html (debug: ?which=a|b, skip=, nocell=, rows=, trace); motion-test guard cards layoutoverflow, iconsize, ctrltext, coveredanchor; viewport-tests runs layoutoverflow per frame.
148
+
149
+ ## 2026-11-08 (Part 11)
150
+ - ULInlineEdit, ULNotificationCenter, ULActivityFeed, ULCodeBlock (+ tokenizeLine), ULJsonViewer; useLiveQueue / useThrottledAnnounce; icons bell, edit, more, wrap, mail.
151
+ - ULSaveButton forwards actionRef.
152
+ - Tokens: --ul-ntf-ring-duration / -gap / -angle, --ul-code-bg / -hl / -str / -num / -kw / -key / -flag.
153
+ - Showcase: Components → Dashboard blocks (Blocks2, live table + filter bar at 20 updates / s); motion-test cards inlineedit, notif, feed, codejson.
154
+
155
+ ## 2026-11-08 (Part 10)
156
+ - engine: decideGlassTier (tier fixed before an open morph); decoded-map crossfade held until the morph settles; one decode listener per map.
157
+ - AnchoredMorph: interrupted runs keep held tiers; reopen cancels the close's scrim fade.
158
+ - ULAnchoredSurface: covered surfaces re-promoted to the top layer on every open.
159
+ - motion-test: ?norun&card=<id>; covered card adds alert dialog + drawer left, first-failing-frame report.
160
+
161
+ ## Pre-release record: stages 2a–2d
162
+
163
+ ### 2D fixes (2026-11-08, latest)
164
+ - Pickers: roving focus target is always an enabled date (enabledNear) for the initial and on-open focus; keyboard moves stay date-based.
165
+ - New token --ul-success-ring (success + success-ink edge); the success ring passes 3:1 on light, mid and dark backdrops.
166
+ - New: setActionTimeScale / getActionTimeScale (action animations only); Components → Actions has a 1× / 0.5× / 0.25× control.
167
+ - Tests: card Run buttons ignored while a suite runs; slider follow harness on the frame clock; repeat ×5 lists failing check keys.
168
+
169
+ ### Leftover popper, scroll freeze, nested menu gap, covered modals (2026-11-08, later)
170
+ - Fixed: row actions menu left a 236×16 surface after closing (anchor ref and items cleared on close; the exit never ran). useAnchoredMorph keeps the last anchor and always exits; ULAnchoredSurface freezes content while closing; AnchoredMorph.destroy clears its inline styles; place() re-measures sizes below the minimum in a detached container (dev error).
171
+ - Fixed: glass flashed red / green / blue while scrolling. Engine scroll freeze (tier, IntersectionObserver results, governor, map regeneration, hover, pointer light queued until 150ms after the last scroll; running crossfades pause), one-viewport IntersectionObserver margin, filter definitions never removed while in use (pooled, recycled), maps decoded before a filter references them, transitionend limited to accent properties, island accent commits when idle. New: `isGlassScrolling`, `prewarmGlass`, `configureGlass({ bisect })` (diagnostics).
172
+ - Nested menus open beside the parent surface with `--ul-submenu-gap` 2px, first row aligned to the trigger row, flip / shift, hover bridge.
173
+ - ULAnchoredSurface `anchorVisibility` above | covered; modal overlays default to covered (top layer from frame 0, opaque base `--ul-modal-covered-backing`, first map after the first frame, prewarm on idle / hover).
174
+ - Tests: `showcase/demos-2f.js` (leftover surfaces ×30 per overlay incl. 200-row table, nested menus, covered modals, scroll invariance), `showcase/glass-scroll-harness.js` (frame-invariance harness for any page). viewport-tests also runs the nested menu card.
175
+ - Tokens: `submenu.gap`, `modal.covered-backing`. Locked timings unchanged.
176
+
177
+ ### Pickers, check mark, item radius, sheet drag, glass arrow map, test pages (2026-11-08)
178
+ - New: ULDateRangePicker (two months, presets, clearable two-segment trigger, band preview, beads, ripple, swap, restart, Esc cancel, locales EN / SK / DE / CS, bottom sheet below 640px). Shared CalendarGrid (div grid, 6 rows) for ULDatePicker and ULDateRangePicker; ULDatePicker gains `isDateDisabled`.
179
+ - New: ULCheckMark + `animateCheck` (draw-in enter, fade / scale exit, 40ms handover). Used by ULSelect, ULCombobox, ULMenu checkbox / radio items, range presets and colour swatches. Selected row wash fades with it.
180
+ - ULColorPicker: the hex field became a "Custom color" expander (2D field with a flattened lens bead, hue ULSlider, hex, eyedropper). Height morphs to the measured size; Esc collapses, then closes. Custom colours pass `guardAccent` (new, contrast.ts) and are clamped into `--ul-accent-custom-*` when they would fail; "Adjusted for contrast" note. Also exported: `toOklch`, `fromOklch`.
181
+ - Item radius: `--ul-item-radius` on every anchored surface = clamp(`--ul-menu-item-radius-min` 12px, popper radius − padding, `--ul-menu-item-radius-max` 22px); rows and the shared hover lens read it. Landing language popper rows + lens: max(12px, popper 20 − 6) = 14px.
182
+ - Mobile bottom sheet: drag to dismiss on the grabber and the nav bar (velocity projection, rubber band, overshoot spring back, click swallowed after a drag). Desktop sheets have no drag. The old unused ULOverlays sheet-drag hook was removed.
183
+ - Engine: `MapOptions.arrow` (body ∪ arrow outline: bezel + rim bend into the arrow base), only for priority overlay in the refract tier, keyed into the shared map cache (position bucketed), never built mid-morph. `mapCost` export.
184
+ - Fixed: liquid glass flashed olive / green for a frame when it entered the viewport (lite colorize ran with hue 0 before the engine had the accent hue). `--ul-lite-ready` gate set together with `--ul-lite-hue`.
185
+ - Toasts: right stacks pour from a point near the right edge; ≤ 480px from the centre with `--ul-toast-overshoot-reserve` (4px) per side, so the locked pop overshoot never reaches into the 16px margin.
186
+ - Tests: `showcase/lens-tests.dc.html` (lens / thumb cards on their own page, same reset, Repeat ×5), `showcase/viewport-tests.dc.html` + `vt-frame.dc.html` + `viewport-harness.js` (iframes 1280×800, 924×540, 375×667), `showcase/demos-2e.js` (fixtures + cards: date range, colour expand, check mark, radius, arrow, keyboard walkthrough, blur-only). motion-test keeps overlay / container cards, prints live vs virtual and the flaky list, shows a foreground-tab banner. Scroll bench mounts the 2e fixtures.
187
+ - Tokens: `menu.item-radius-min / -max`, `check.*`, `range.*`, `colorpicker.*`, `accent-custom.*`, `toast.overshoot-reserve`. Locked timings unchanged.
188
+
189
+ ### Test reliability, dialog context, toast placement, sidebar indicator (2026-11-07, later)
190
+ - New: ULDialogProvider, ULDialogSurface, useDialog (push / replace / pop / close in one surface, persistent nav bar, measured size morph, staggered content, focus + state + scroll restore, dirty guard). ULModal / ULSheet / ULDrawer use it; the stacked-modal demo and fixture are now pushes.
191
+ - AnchoredMorph: `anchorOnTop` (auto false for triggers inside a dialog surface), `setFinalRect`, `finalFor`. Tokens: `--ul-dialog-*`.
192
+ - Fixed: toast stack surfaces were position:fixed under their slots (child selector never matched): the newest toast hung off screen. Stack now follows the visual viewport and shows fewer toasts when it would not fit.
193
+ - createNavIndicator: `setLayoutFollow` (rigid during container morphs), scroll offset in measurement. Sidebar: rigid indicator during collapse / expand, nav padding so the lens is never clipped.
194
+ - Tests: frame clock = document timeline, px/ms limits with worst-frame print, WARN state for live FAIL / virtual PASS, per-card reset + leak list, deterministic mode (HUD off, unlimited budget), Repeat ×5 with FLAKY; new cards: dialog push / pop, toast placement, sidebar layout-follow.
195
+
196
+ ### Stage 2c containers + overlays, narrowed 2d data (2026-11-07)
197
+ - New: ULCard, ULPanel (glass | calm | well), ULModal, ULSheet, ULDrawer, ULPopover (arrow, reading), ULTooltip (React wrapper of createAnchoredTooltip), ULToast, ULToastProvider + useToast, ULAccordion, ULSidebar, ULToolbar, ULMenu, ULMenuButton, ULContextMenu, ULCommandPalette (+ fuzzyScore).
198
+ - New (2d): ULStatTile, ULTable, ULChart, ULBadge, ULAvatar, ULAvatarGroup, ULProgress, ULSkeleton, ULEmptyState, ULBreadcrumbs, ULPagination (+ pageRange).
199
+ - AnchoredMorph: `layout` (center / edges), `scrim` part (opacity on the timeline, hole cut while morphing), `shiftFinal` (dragged sheets / toasts), `nextExitFade` (swipe dismiss), padding moves onto the stage while morphing so 0 × 0 anchors work, virtual anchors are never treated as "anchor gone". Exported `overshootEase`.
200
+ - New modules: `motion/virtualAnchor.ts`, `motion/overlayStack.ts` (top-layer Esc / outside, focus trap, stacked modals).
201
+ - ULAnchoredSurface: layout, scrim, modal, initialFocus, returnFocus, manual, stack, arrow, surfaceRef, morphRef; per-depth z-index (`--ul-depth`).
202
+ - ULTabs: `keepMounted` (panels stay lazy; indicator code untouched). createAnchoredTooltip: side left / right (collapsed sidebar).
203
+ - FAB: right / centred placements add `--ul-scroll-lock-gap`. Toast stack right edge too.
204
+ - Tokens: scrim, modal, sheet, drawer, popover, toast, card, panel, accordion, sidebar, toolbar, menu, palette, data, table, chart, skeleton, progress, avatar, badge. Locked timings unchanged (table in DESIGN.md).
205
+ - Tests: 12 new motion-test rows (modal, stacked modal, sheet, drawers, popover, anchored toast, toast stack, menu, submenu, context menu, palette) + "2c overlays: scroll" row; scroll-bench mounts the real 2c overlays. Harness: virtual anchors skip the hit test, centred / edge layouts must keep the trigger clickable only while morphing, lead check needs a ≥ 25 % size change, a failing live run is re-measured on the virtual clock (both shown).
206
+
207
+ ### Slower bubble shrink after release (2026-11-07)
208
+ - Shrink 2× slower, same start: `--ul-lens-release-linger` 380 → 570ms (switch, tabs, segmented), `--ul-lens-shrink-duration` 300 → 600ms (slider). Bench defaults updated.
209
+
210
+ ### Release linger (2026-11-07)
211
+ - LensBubble `earlyShrink` + `onFrame` (switch, tabs, segmented): elastic settle `--ul-lens-settle-duration` 420ms, shrink starts at `--ul-lens-shrink-start` 0.45, hard cap `--ul-lens-release-linger` 380ms; the switch knob rides the settle spring. Slider unchanged.
212
+ - Tests: linger, settle ±15 %, overshoot, no double edge, key path. Bench: settle, shrink start, linger sliders.
213
+ - Scroll leftovers: anchored toasts (role status / alert) default to "fixed"; `--ul-scroll-lock-gap` for right-pinned fixed chrome.
214
+
215
+ ### Timing fixes + overlay scroll behavior (2026-11-07)
216
+ - Shrink 480 → 300ms, settle hold 120 → 60ms, shrink spring ×0.9; grow 570ms kept; ζ floor 0.55 → 0.64 (one grow spring for all controls).
217
+ - A2 cause: not the switch. The switch grow honoured the token (probe: within 2 % at ≈ 540ms); the test took the first RISING pass through the ±2 % band as "settled" (248ms). The test now uses the last entry into the band. The real difference was the slider's ζ 0.55 vs the switch's 0.64 (scale-dependent), fixed by the ζ floor.
218
+ - Tabs / segmented: `--ul-tabs-glide` 300ms (new), press glide 400 → 280ms, follow 110 → 80ms; glide speed cap 1.8 %/frame. Dev warning when an ancestor would clip the indicator's overgrow.
219
+ - AnchoredMorph: scrollBehavior (lock / follow / fixed / close), onAnchorHidden (keep / hide / close), onRequestClose; `lockPageScroll` / `unlockPageScroll` / `isPageScrollLocked`. ULAnchoredSurface: scrollBehavior, scrollLock, onAnchorHidden; menus pass lock. Tooltip: follow + hide.
220
+ - Tests: scroll-harness.js (follow ≤ 1px over 600px / 60 frames, tooltip hide, fixed, flip, layout shift, nested container, reduced motion, menu lock: wheel / touch / keys / scrollbar, no shift, exact restore, inner scroll). Timing card: grow and shrink ±15 %. Bench: showcase/scroll-bench.dc.html; Lens bench defaults updated.
221
+
222
+ ### Polish: switch proportions, slower motion, one indicator (2026-11-07)
223
+ - Switch retuned from the iOS 26 screenshots: 64×28 / thumb 37.2×24 (1.55) / inset 2 / bubble ×1.3, overgrow 2 → 62×27 / thumb 36.1×23 (1.57) / inset 2 / bubble ×1.55 (55×36.5), overgrow 5.
224
+ - Grow 380 → 570ms, shrink 320 → 480ms, settle hold 70 → 120ms, ζ floor 0.55. New `--ul-switch-toggle-duration` 560ms (click), key / programmatic 70 %.
225
+ - Tabs / segmented: one persistent indicator node (rest capsule = bubble), separate hover indicator removed; press glide (`--ul-tabs-press-glide` 400ms) and follow spring (`--ul-lens-follow` 110ms); segmented is a non-glass well.
226
+ - LensBubble: `mount: 'host'`, `follow`, `glide()`, `toggle()`, `rest()`, per-kind scale token.
227
+ - Tests: timing card, one-indicator / no-teleport / follow cards. Bench: grow, shrink, toggle sliders.
228
+ - Not done in this pass: overlay scroll behavior (section 4) and its bench / tests.
229
+
230
+ ### Lens bubble rework, switch drag-to-set, slider follow, tabs (2026-11-07)
231
+ - Shared `LensBubble` rewritten: rounded rectangle, concentric radius, overgrow tokens, root-level layer (never clipped), two-edge elastic drag model, settle-then-shrink, pooled elements, reduced-motion crossfade. Supersedes the scaled-circle bubble.
232
+ - `createLensSelect`: press-hold-drag selection with the bubble for ULSegmentedControl and the new ULTabs.
233
+ - ULSwitch: capsule thumb (ratio 1.55), track 64×28, drag to set with release logic (midpoint + flick, click threshold, Esc / pointercancel), one change event per release, fill preview.
234
+ - ULSlider / ULRangeSlider: capsule thumbs, value vs visual split (follow spring), one rAF loop, transform / clip-path only, no React render per pointermove, cached geometry. Stutter cause: step quantisation (282/355 stalled frames → 0).
235
+ - createNavIndicator: same overshoot spring as the bubble.
236
+ - Engine: `wakeGlass`. Tokens: lens.*, switch.*, slider.*, switch 64×28 / inset 2, slider thumb 24.
237
+ - Tests: thumb-harness rewritten (shape, overgrow, press ≤ 100ms, stretch side, overshoot + settle, bounds, stalls, shrink-after-settle, switch release logic + event count, slider follow + tooltip + drag bench, range merge, tabs / segmented hold-drag-release, reduced motion). HUD: Drag bench.
238
+ - Showcase: Lens bubble bench (switch states incl. in glass, sliders, range, segmented, tabs, slow motion, bubble on/off, sliders for ratio, overgrow, scale, stretch, overshoot, magnification, follow).
239
+
240
+ ### Motion fixes + slider tooltip + lens bubble (2026-11-07)
241
+ - AnchoredMorph: an interruption starts from the surface's current visual rect and blends into the new timeline (no jump when the anchor or final rect changed). Harness: stricter reversal check (first frames after a reversal ≤ pre-reversal velocity + 3px), hit-test misses are logged per frame (phase, frame, ms, elementFromPoint, clip state), runs are serialised. The earlier island / colour-picker failures did not reproduce in 3 live runs; the failing run had twice the frame count, most likely two overlapping runs (page auto-run + a manual or HUD run) toggling the same overlays.
242
+ - ULSlider rewritten on one position write per frame (`--ul-p0/--ul-p1`, fill `--ul-f0/--ul-f1`); value tooltip is a child of the thumb (no anchored-tooltip loop, no hover delay), clamp + flip, tabular numbers, hide delay; range merge/split; `orientation="vertical"`; keyboard, click-to-jump and programmatic changes travel on the snappy spring.
243
+ - Lens bubble (`LensBubble`, shared/lens.css) on ULSwitch and ULSlider; thumbs are flat at rest; `lens` prop; switch travel now on the snappy spring.
244
+ - Engine: `setGlassHot(el, on)`.
245
+ - Tokens: lens.*, tooltip.hide-delay, selection.slider-length.
246
+ - Tests: thumb-harness.js (tooltip offset per frame, range merge/split, lens bubble incl. reduced motion). Components: Lens bubble bench. Perf HUD: drag scenario.
247
+
248
+ ### Anchored motion fix (2026-11-07)
249
+ - Cause: every portalled overlay (ULSelect, ULCombobox, ULDatePicker, ULColorPicker, ULSplitButton menu, ULIsland notification) already went through ULAnchoredSurface and animated (getAnimations() = 1 running, geometry moving), but `raise()` lifted the anchor's stacking-context ancestors, including the page root, above `--ul-z-overlay`, so the morph played behind the page and the surface appeared at the end. Not the cause: missing morph, mount at final size, quality tiers, reduced motion.
250
+ - Layering is now an even-odd `clip-path` hole at the anchor (keyframed with the pose); no z-index changes. `[data-ul-morph-occluder]` widens the hole to an ancestor (island pill). SiteHeader and ULIsland mark the pill.
251
+ - Content fades + slides in after the surface clears the anchor (stage opacity / translate in the same keyframes).
252
+ - Explicit `startTime` per run: a composited stage animation could hold the surface on its t=0 pose for hundreds of ms on a busy frame.
253
+ - Tier freeze: `applyTier` holds changes while `data-ul-morphing`; new `releaseGlassTier(el)` applies them when the morph ends.
254
+ - `ul:morph` events; `configureMorph({ reducedMotion })`; `isMorphReduced()`.
255
+ - Motion test: `showcase/motion-harness.js`, `showcase/motion-test.dc.html`, `landing/chrome/motion-test.dc.html`, HUD button "Motion test".
256
+ - ULColorPicker: per-preset `disabled` (`presets: (string | { value, disabled?, label? })[]`), shown crossed out and skipped by arrow keys. Components showcase: emerald disabled.
257
+ - 2b decisions recorded: stepper stays a step indicator; EN dates stay day-month, Monday first.
258
+
259
+ ### Phase 2b — selection
260
+ - `ULCheckbox`, `ULRadio` / `ULRadioGroup`, `ULSwitch` (lens thumb grows on press, magnifies the textured track), `ULSlider` / `ULRangeSlider` (lens thumbs, shared anchored tooltip while dragging), `ULSegmentedControl` (shared floating indicator), `ULStepper` (step indicator), `ULSelect` / `ULCombobox` (anchored listbox, typeahead, activedescendant, empty / loading), `ULDatePicker` (EN/SK/DE/CS, grid keys), `ULColorPicker` (accent presets + hex).
261
+ - Tokens `selection.*`; icons chevron-left / chevron-right / check / calendar / layout-grid / menu in the component icon set.
262
+ - Showcase: Selection tab; contrast rows for 2b.
263
+
264
+ ### Fixes after the performance review
265
+ - Governor budget is refracted AREA per viewport (`--ul-perf-refraction-area` 150 000 px²) + count cap (`--ul-perf-refraction-max-count` 30); small controls stay full, big surfaces drop first. `getGlassStats()` reports `areaUsed`, `refractCount`.
266
+ - Small lenses: bezel ≤ 35 % of the shorter side, minimum edge shift 8 px, exact-size maps under 16 000 px², 3-pass aberration on hovered small controls.
267
+ - Lite tier: CSS colorize hue solved numerically through the filter matrices (reds no longer drift to orange), fake lensing (rim hairline, edge shading, bevels).
268
+ - Focus ring on glass buttons is a child element (`.ul-btn-ring`); an outline was bent by the lens.
269
+ - Displacement maps follow per-corner radii (split button).
270
+ - Fields on a busy backdrop get a helper / error backing (`--ul-field-msg-backing`); dev-only warnings for plain buttons and bare fields (`isDev`, `surfaceBehind`; off when `window.__UL_PROD__`).
271
+ - Perf HUD: tier outlines (Shift+T), tier counts, refracted area. `configureGlass({ light })` for measurement.
272
+ - Icons: C2PA metadata stripped (342 KB → 15 KB for 42 SVGs); originals in `_archive/icons-original/`.
273
+ - `npm run build:min` → `dist/ul-glass.min.js` + source map (not run yet).
274
+ - Landing header: pill priority island, megamenu and contact morph priority overlay.
275
+
276
+ ### Performance (before Stage 2b)
277
+ - Glass quality tiers: `quality` prop / option `full | lite | flat | auto` (default auto) and `priority` (`overlay | island | normal`; role=dialog and anchored surfaces default to overlay). New mode `lite`: blur + saturate + CSS colorize (grayscale → sepia → accent hue), no SVG filter.
278
+ - Hover / focus promotion to full with `--ul-perf-demote-delay` and a `--ul-perf-crossfade` ramp of lens + colorize against the lite body (`--ul-lite`), so nothing pops.
279
+ - Shared displacement maps (LRU, sizes quantized up to `--ul-perf-size-bucket`) and shared SVG filters for surfaces at rest with identical params; private filters only while a surface animates. Map regeneration debounced (~100 ms) and never during an animation. Chromatic aberration (3 passes) only on full surfaces ≥ `--ul-perf-aberration-min-area`; otherwise 1 pass.
280
+ - One shared IntersectionObserver: surfaces beyond `--ul-perf-offscreen-margin` go flat and drop their ResizeObserver and press listener.
281
+ - Pointer loop: light / elasticity only on refracted surfaces in view plus the hovered element and its glass ancestor; rect reads batched before writes; light fades out instead of snapping; no pointer listener on touch-only devices; rest-state springs skip style writes.
282
+ - Tokens `perf.*`. Showcase: `perf-hud.js` (Shift+P), `ambient-bg.js` (pausable animated background), Components split into tabs with a static background by default and a budget tweak.
283
+
284
+ ### Added
285
+ - Phase 2a: `ULButton` (primary, secondary, tinted, plain, destructive; sm/md/lg; capsule, rounded, circle; icon-only; link; loading; toggle), `ULToggleButton`, `ULButtonGroup`, `ULSplitButton`, `ULFab`, `ULSpinner`.
286
+ - Phase 2a: `ULTextField` (text, email, password with reveal, search capsule with clear and expand-on-focus, url, tel), `ULTextArea` (auto-grow), `ULNumberField` (stepper), `ULOtpField`, `ULTagField`; floating labels, helper and error text, leading / trailing icons, inset well.
287
+ - Tokens: `control.*`, `field.*`, `focus.color|width|offset`, `spinner.*`, `mobile.*`.
288
+ - `ULAnchoredSurface`: `portal` (default true) and `backdrop`.
289
+ - `createAnchoredTooltip`, `STUDIO_URL`, header config `studioLink`, `isMobileGlass`, `configureGlass({ forceMobile })`.
290
+ - `dist/ul-glass.css` next to `dist/ul-glass.js`; `scripts/build-in-browser.js`.
291
+ - `showcase/Components.dc.html`.
292
+
293
+ ### Changed
294
+ - Showcase loads `dist/ul-glass.js` instead of the in-browser transpile loader.
295
+ - The bundle waits for `window.ReactDOM` as well as `window.React`.
296
+
297
+ ### Removed
298
+ - Header account popper and `sessionAware` (archived outside the library).
299
+
300
+ ## 2026-11-08 · Part 3
301
+ - Rolling number: one static glyph per cell at rest, whole-cell strips only while rolling, one non-wrapping line, KPI value scales with the tile. Fixes half digits and wrapped values (Live tab).
302
+ - Context menus: `contextMenu` / `rowMenu` / `contextMenuHeader` / `contextMenuCell` on ULTable; `contextMenu` on ULKpiCard, ULStatTile, ULChart, ULCard, ULPanel, ULBadge, ULAvatar, ULTabs, ULSidebar, ULAccordion, ULBreadcrumbs, ULTagField, ULToast; `ULContextTarget`, `useContextMenuTarget`. MenuItem `hidden`.
303
+ - Live layer (createLiveSource, websocket / sse / polling / mock, useLiveStore, ULLiveStatus), KPI cards, data glass levels, Live tab in Components.
304
+ - Glass: single displacement pass + CSS bezel fringe; no content-visibility around glass (dev warning); `?glass=full|lite|flat`, `?glassdebug` panel with a pointer / wheel write recorder.
305
+ - Tokens: --ul-modal-glass-backing 0.55; --ul-scrim-mid-subtle / -vivid 0.66; tokens.json repaired to match tokens.css (root scrim thresholds, tabs glide group).
306
+ - Toast stack re-promotion keeps focus. Motion-test harness: virtual edge anchors count as covered under modal surfaces.
307
+ - New motion-test cards: rolling number, context menu, pointer glass stability, drill-in 375px, toast over modal + backing, KPI states, live source, live table, data glass.
308
+
309
+ ## 2026-11-08 · Part 4
310
+ - Actions: useAsyncAction, ULActionButton, ULCopyButton (+ copyText), ULSaveButton, ULSaveStatus, useUnsavedChangesGuard, ULSubmitButton, ULConfirmAction (inline / hold / type), ULDownloadButton, ULExportButton, ULRefreshButton, ULToggleIconButton, ULShareButton, ULUndoToast, announce, actionText (EN / SK / DE / CS). Tokens --ul-action-*. Icons: copy, refresh, download, star, heart, pin, bookmark, share, save, undo, volume, volume-x, trash, send.
311
+ - Pointer light: ≤ 4 nearest surfaces per frame, one rAF batch with the spring sim, threshold, no writes while scrolling + 150ms (token --ul-glass-light-max).
312
+ - Anchored ULToast stays above modals (keepOnTop).
313
+ - ULButton passes aria-busy / aria-disabled from props.
314
+ - Tests: NEEDS FOCUS status; viewport-tests narrow submenu uses the same-surface drill-in; new action cards; pointer glass card follows the 4-surface rule. Components: Actions tab; copy buttons in the 200-row table.
315
+
316
+ ## 2026-11-08 · Part 6
317
+ - useCoalescedAction + coalesce / debounceMs / maxWaitMs on useAsyncAction; ULToggleIconButton coalesced (trailing) with status idle | pending | saving | error, flushRef, flushOnBlur; ULRefreshButton leading-trailing.
318
+ - Hold-to-confirm fill across the whole button (fx layer); success ripple from the centre (successEffect), success tone (successTone, --ul-success, --ul-success-soft); ULPublishButton. ULButton `layers` prop.
319
+ - Dashboard blocks: ULBulkActionBar, ULColumnsMenu (+ columnsMenuItems, applyColumns, useColumnsState), ULFilterBar (+ filtersToQuery / filtersFromQuery / applyFilters), cell renderers, ULTimeAgo / ULTimestamp, ULTimeRange, ULRefreshControl, ULCopyField, ULStatusDot / ULStatusPill, ULBanner / ULBannerQueue, ULUsageMeter, ULErrorState, ULDescriptionList / ULKeyValue, ULTruncatedText. ULTable: column pin, pinSelection.
320
+ - Lens tests: frame-pacing cards report NEEDS FOCUS when the page has no focus or the frame gaps are irregular, with the gaps printed.
321
+ - Tokens: --ul-action-debounce-ms, -debounce-max-wait-ms, -hold-ms (replaces -hold), -hold-release-ms, -ripple-ms, -ripple-fade-ms, -ripple-delay; --ul-success, --ul-success-soft, --ul-success-ink.
322
+
323
+ ## 2026-11-08 · Part 7 (partial)
324
+ - Success wave: circular, from the centre (or the click point) to the farthest corner, trailing wavelets, registered radius properties; successOrigin prop; --ul-action-ripple-ms 620ms.
325
+ - Success check: ink on a --ul-success-soft disc (contrast fix).
326
+ - ULDateRangePicker / CalendarGrid: the picked day takes focus and the roving focus follows it (Esc while picking now cancels after a pointer pick). ULColorPicker: the expand button keeps focus on toggle.