@threadlabs/looma 0.41.2 → 0.43.0

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 (279) hide show
  1. package/components/ui-action-bar/ui-action-bar.html +1 -7
  2. package/components/ui-affordance-scope/ui-affordance-scope.html +4 -4
  3. package/components/ui-avatar/ui-avatar.html +0 -22
  4. package/components/ui-avatar-group/ui-avatar-group.html +1 -11
  5. package/components/ui-badge/ui-badge.html +57 -78
  6. package/components/ui-button/ui-button.html +66 -90
  7. package/components/ui-button/ui-button.js +2 -2
  8. package/components/ui-callout/ui-callout.html +31 -69
  9. package/components/ui-card/ui-card.html +47 -21
  10. package/components/ui-checkbox/ui-checkbox.html +2 -16
  11. package/components/ui-cluster/ui-cluster.html +1 -7
  12. package/components/ui-combobox/ui-combobox.html +7 -70
  13. package/components/ui-container/ui-container.html +2 -12
  14. package/components/ui-context-menu/ui-context-menu.html +1 -23
  15. package/components/ui-dialog/ui-dialog.html +9 -41
  16. package/components/ui-disclosure/ui-disclosure.html +1 -15
  17. package/components/ui-editor-mention-menu/ui-editor-mention-menu.html +1 -1
  18. package/components/ui-editor-mention-menu-item/ui-editor-mention-menu-item.html +1 -1
  19. package/components/ui-editor-table-context-menu/ui-editor-table-context-menu.html +1 -1
  20. package/components/ui-editor-table-overlay/ui-editor-table-overlay.html +2 -2
  21. package/components/ui-editor-table-toolbar/ui-editor-table-toolbar.html +2 -2
  22. package/components/ui-floating-action-button/ui-floating-action-button.html +0 -14
  23. package/components/ui-form-field/ui-form-field.html +2 -32
  24. package/components/ui-grid/ui-grid.html +1 -11
  25. package/components/ui-icon/ui-icon.html +1 -12
  26. package/components/ui-icon-button/ui-icon-button.html +94 -94
  27. package/components/ui-input/ui-input.html +5 -55
  28. package/components/ui-input-group/ui-input-group.html +1 -13
  29. package/components/ui-light-editor/ui-light-editor.html +1 -1
  30. package/components/ui-list/ui-list.html +0 -10
  31. package/components/ui-list-item/ui-list-item.html +1 -19
  32. package/components/ui-listbox/ui-listbox.html +0 -21
  33. package/components/ui-menu/ui-menu.html +8 -32
  34. package/components/ui-menu-item/ui-menu-item.html +1 -27
  35. package/components/ui-meter/ui-meter.html +11 -6
  36. package/components/ui-nav-item/ui-nav-item.html +0 -18
  37. package/components/ui-popover/ui-popover.html +9 -41
  38. package/components/ui-radio/ui-radio.html +58 -12
  39. package/components/ui-radio-group/ui-radio-group.html +0 -5
  40. package/components/ui-reel/ui-reel.html +1 -11
  41. package/components/ui-search-result-row/ui-search-result-row.html +0 -34
  42. package/components/ui-search-shell/ui-search-shell.html +1 -43
  43. package/components/ui-section/ui-section.html +1 -1
  44. package/components/ui-select/ui-select.html +0 -42
  45. package/components/ui-separator/ui-separator.html +0 -6
  46. package/components/ui-sidebar/ui-sidebar.html +2 -24
  47. package/components/ui-site-header/ui-site-header.html +0 -25
  48. package/components/ui-skeleton/ui-skeleton.html +0 -9
  49. package/components/ui-stack/ui-stack.html +6 -11
  50. package/components/ui-status-message/ui-status-message.html +1 -1
  51. package/components/ui-swatch/ui-swatch.html +0 -5
  52. package/components/ui-switch/ui-switch.html +6 -17
  53. package/components/ui-switcher/ui-switcher.html +1 -11
  54. package/components/ui-tabs/ui-tabs.html +4 -22
  55. package/components/ui-text/ui-text.html +20 -7
  56. package/components/ui-textarea/ui-textarea.html +0 -50
  57. package/components/ui-toast/ui-toast.html +12 -27
  58. package/components/ui-toast-region/ui-toast-region.html +13 -34
  59. package/components/ui-tooltip/ui-tooltip.html +9 -53
  60. package/components/ui-top-bar/ui-top-bar.html +1 -31
  61. package/components/ui-tree/ui-tree.html +1 -16
  62. package/components/ui-tree-item/ui-tree-item.html +1 -23
  63. package/components/ui-tree-item/ui-tree-item.js +0 -1
  64. package/dist/index.js +1 -1
  65. package/docs/README.md +15 -9
  66. package/docs/catalog.json +973 -186
  67. package/docs/customizer-render.mjs +25 -9
  68. package/docs/customizer.js +42 -2
  69. package/docs/fonts.mjs +1 -1
  70. package/docs/palette.mjs +5 -4
  71. package/docs/theme.mjs +214 -51
  72. package/docs/value-editors.mjs +2 -1
  73. package/package.json +2 -2
  74. package/styles/ui-action-bar.css +3 -11
  75. package/styles/ui-affordance-scope.css +4 -4
  76. package/styles/ui-avatar-group.css +3 -15
  77. package/styles/ui-avatar.css +2 -26
  78. package/styles/ui-badge.css +56 -80
  79. package/styles/ui-button.css +65 -92
  80. package/styles/ui-callout.css +33 -73
  81. package/styles/ui-card.css +42 -18
  82. package/styles/ui-checkbox.css +4 -20
  83. package/styles/ui-cluster.css +2 -10
  84. package/styles/ui-combobox.css +7 -140
  85. package/styles/ui-container.css +2 -14
  86. package/styles/ui-context-menu.css +3 -27
  87. package/styles/ui-dialog.css +22 -88
  88. package/styles/ui-disclosure.css +3 -19
  89. package/styles/ui-editor-mention-menu-item.css +1 -1
  90. package/styles/ui-editor-mention-menu.css +1 -1
  91. package/styles/ui-editor-table-context-menu.css +1 -1
  92. package/styles/ui-editor-table-overlay.css +2 -2
  93. package/styles/ui-editor-table-toolbar.css +2 -2
  94. package/styles/ui-floating-action-button.css +2 -18
  95. package/styles/ui-form-field.css +4 -36
  96. package/styles/ui-grid.css +2 -14
  97. package/styles/ui-icon-button.css +93 -96
  98. package/styles/ui-icon.css +3 -16
  99. package/styles/ui-input-group.css +2 -14
  100. package/styles/ui-input.css +6 -57
  101. package/styles/ui-light-editor.css +2 -2
  102. package/styles/ui-list-item.css +3 -23
  103. package/styles/ui-list.css +2 -14
  104. package/styles/ui-listbox.css +2 -44
  105. package/styles/ui-menu-item.css +3 -31
  106. package/styles/ui-menu.css +11 -37
  107. package/styles/ui-meter.css +8 -4
  108. package/styles/ui-nav-item.css +2 -22
  109. package/styles/ui-popover.css +12 -46
  110. package/styles/ui-radio-group.css +1 -6
  111. package/styles/ui-radio.css +68 -15
  112. package/styles/ui-reel.css +2 -14
  113. package/styles/ui-search-result-row.css +2 -38
  114. package/styles/ui-search-shell.css +3 -47
  115. package/styles/ui-section.css +1 -1
  116. package/styles/ui-select.css +2 -46
  117. package/styles/ui-separator.css +2 -10
  118. package/styles/ui-sidebar.css +4 -28
  119. package/styles/ui-site-header.css +1 -26
  120. package/styles/ui-skeleton.css +2 -12
  121. package/styles/ui-stack.css +4 -12
  122. package/styles/ui-status-message.css +1 -1
  123. package/styles/ui-swatch.css +1 -6
  124. package/styles/ui-switch.css +8 -21
  125. package/styles/ui-switcher.css +2 -14
  126. package/styles/ui-tabs.css +6 -26
  127. package/styles/ui-text.css +11 -3
  128. package/styles/ui-textarea.css +2 -54
  129. package/styles/ui-toast-region.css +29 -73
  130. package/styles/ui-toast.css +24 -54
  131. package/styles/ui-tooltip.css +12 -58
  132. package/styles/ui-top-bar.css +3 -35
  133. package/styles/ui-tree-item.css +5 -51
  134. package/styles/ui-tree.css +3 -20
  135. package/theme-system.css +16 -10
  136. package/tokens.css +75 -18
  137. package/vanilla/UiBadge.d.ts +1 -1
  138. package/vanilla/UiBadge.js +1 -1
  139. package/vanilla/UiButton.d.ts +1 -1
  140. package/vanilla/UiButton.js +1 -1
  141. package/vanilla/UiCard.d.ts +1 -1
  142. package/vanilla/UiCard.js +1 -1
  143. package/vanilla/UiIconButton.d.ts +1 -1
  144. package/vanilla/UiIconButton.js +1 -1
  145. package/vanilla/UiMeter.d.ts +1 -1
  146. package/vanilla/UiMeter.js +1 -1
  147. package/vanilla/UiStack.js +1 -1
  148. package/vanilla/UiText.d.ts +1 -1
  149. package/vanilla/UiText.js +1 -1
  150. package/vue/UiActionBar.vue +3 -9
  151. package/vue/UiAffordanceScope.vue +4 -4
  152. package/vue/UiAvatar.vue +1 -28
  153. package/vue/UiAvatarGroup.vue +1 -11
  154. package/vue/UiBadge.d.ts +2 -2
  155. package/vue/UiBadge.vue +84 -81
  156. package/vue/UiButton.d.ts +2 -2
  157. package/vue/UiButton.vue +120 -106
  158. package/vue/UiCallout.vue +31 -72
  159. package/vue/UiCard.d.ts +2 -2
  160. package/vue/UiCard.vue +77 -32
  161. package/vue/UiCheckbox.vue +2 -16
  162. package/vue/UiCluster.vue +1 -10
  163. package/vue/UiCombobox.vue +13 -72
  164. package/vue/UiContainer.vue +1 -13
  165. package/vue/UiContextMenu.vue +1 -30
  166. package/vue/UiDialog.vue +23 -77
  167. package/vue/UiDisclosure.vue +1 -15
  168. package/vue/UiEditorMentionMenu.vue +1 -1
  169. package/vue/UiEditorMentionMenuItem.vue +1 -1
  170. package/vue/UiEditorTableContextMenu.vue +1 -1
  171. package/vue/UiEditorTableOverlay.vue +2 -2
  172. package/vue/UiEditorTableToolbar.vue +2 -2
  173. package/vue/UiFloatingActionButton.vue +0 -22
  174. package/vue/UiFormField.vue +6 -33
  175. package/vue/UiGrid.vue +1 -13
  176. package/vue/UiIcon.vue +1 -16
  177. package/vue/UiIconButton.d.ts +2 -2
  178. package/vue/UiIconButton.vue +145 -106
  179. package/vue/UiInput.vue +1 -54
  180. package/vue/UiInputGroup.vue +8 -20
  181. package/vue/UiLightEditor.vue +2 -2
  182. package/vue/UiList.vue +2 -12
  183. package/vue/UiListItem.vue +8 -26
  184. package/vue/UiListbox.vue +0 -23
  185. package/vue/UiMenu.vue +12 -44
  186. package/vue/UiMenuItem.vue +1 -27
  187. package/vue/UiMeter.d.ts +2 -2
  188. package/vue/UiMeter.vue +47 -12
  189. package/vue/UiNavItem.vue +3 -21
  190. package/vue/UiPopover.vue +12 -53
  191. package/vue/UiRadio.vue +58 -12
  192. package/vue/UiRadioGroup.vue +0 -11
  193. package/vue/UiReel.vue +1 -11
  194. package/vue/UiSearchResultRow.vue +0 -35
  195. package/vue/UiSearchShell.vue +1 -53
  196. package/vue/UiSection.vue +1 -1
  197. package/vue/UiSelect.vue +0 -42
  198. package/vue/UiSeparator.vue +0 -7
  199. package/vue/UiSidebar.vue +3 -26
  200. package/vue/UiSiteHeader.vue +0 -24
  201. package/vue/UiSkeleton.vue +0 -9
  202. package/vue/UiStack.vue +6 -11
  203. package/vue/UiStatusMessage.vue +1 -1
  204. package/vue/UiSwatch.vue +1 -6
  205. package/vue/UiSwitch.vue +6 -17
  206. package/vue/UiSwitcher.vue +1 -14
  207. package/vue/UiTabs.vue +4 -22
  208. package/vue/UiText.d.ts +2 -2
  209. package/vue/UiText.vue +30 -5
  210. package/vue/UiTextarea.vue +0 -50
  211. package/vue/UiToast.vue +26 -34
  212. package/vue/UiToastRegion.vue +26 -55
  213. package/vue/UiTooltip.vue +12 -64
  214. package/vue/UiTopBar.vue +1 -34
  215. package/vue/UiTree.vue +2 -17
  216. package/vue/UiTreeItem.vue +2 -28
  217. package/vue/chunks/UiActionBar.js +1 -1
  218. package/vue/chunks/UiAffordanceScope.js +1 -1
  219. package/vue/chunks/UiAvatar.js +1 -1
  220. package/vue/chunks/UiAvatarGroup.js +1 -1
  221. package/vue/chunks/UiBadge.js +4 -2
  222. package/vue/chunks/UiButton.js +4 -2
  223. package/vue/chunks/UiCallout.js +1 -1
  224. package/vue/chunks/UiCard.js +5 -3
  225. package/vue/chunks/UiCheckbox.js +1 -1
  226. package/vue/chunks/UiCluster.js +2 -2
  227. package/vue/chunks/UiCombobox.js +3 -3
  228. package/vue/chunks/UiContainer.js +2 -2
  229. package/vue/chunks/UiContextMenu.js +1 -1
  230. package/vue/chunks/UiDialog.js +1 -1
  231. package/vue/chunks/UiDisclosure.js +1 -1
  232. package/vue/chunks/UiEditorMentionMenu.js +1 -1
  233. package/vue/chunks/UiEditorMentionMenuItem.js +1 -1
  234. package/vue/chunks/UiEditorTableContextMenu.js +1 -1
  235. package/vue/chunks/UiEditorTableOverlay.js +1 -1
  236. package/vue/chunks/UiEditorTableToolbar.js +1 -1
  237. package/vue/chunks/UiFloatingActionButton.js +1 -1
  238. package/vue/chunks/UiFormField.js +1 -1
  239. package/vue/chunks/UiGrid.js +2 -2
  240. package/vue/chunks/UiIcon.js +1 -1
  241. package/vue/chunks/UiIconButton.js +4 -2
  242. package/vue/chunks/UiInput.js +1 -1
  243. package/vue/chunks/UiInputGroup.js +1 -1
  244. package/vue/chunks/UiLightEditor.js +1 -1
  245. package/vue/chunks/UiList.js +1 -1
  246. package/vue/chunks/UiListItem.js +1 -1
  247. package/vue/chunks/UiListbox.js +1 -1
  248. package/vue/chunks/UiMenu.js +1 -1
  249. package/vue/chunks/UiMenuItem.js +1 -1
  250. package/vue/chunks/UiMeter.js +4 -2
  251. package/vue/chunks/UiNavItem.js +1 -1
  252. package/vue/chunks/UiPopover.js +1 -1
  253. package/vue/chunks/UiRadio.js +1 -1
  254. package/vue/chunks/UiRadioGroup.js +1 -1
  255. package/vue/chunks/UiReel.js +2 -2
  256. package/vue/chunks/UiSearchResultRow.js +1 -1
  257. package/vue/chunks/UiSearchShell.js +1 -1
  258. package/vue/chunks/UiSection.js +1 -1
  259. package/vue/chunks/UiSelect.js +1 -1
  260. package/vue/chunks/UiSeparator.js +1 -1
  261. package/vue/chunks/UiSidebar.js +1 -1
  262. package/vue/chunks/UiSiteHeader.js +1 -1
  263. package/vue/chunks/UiSkeleton.js +1 -1
  264. package/vue/chunks/UiStack.js +3 -3
  265. package/vue/chunks/UiStatusMessage.js +1 -1
  266. package/vue/chunks/UiSwatch.js +1 -1
  267. package/vue/chunks/UiSwitch.js +1 -1
  268. package/vue/chunks/UiSwitcher.js +2 -2
  269. package/vue/chunks/UiTabs.js +1 -1
  270. package/vue/chunks/UiText.js +4 -2
  271. package/vue/chunks/UiTextarea.js +1 -1
  272. package/vue/chunks/UiToast.js +1 -1
  273. package/vue/chunks/UiToastRegion.js +1 -1
  274. package/vue/chunks/UiTooltip.js +1 -1
  275. package/vue/chunks/UiTopBar.js +1 -1
  276. package/vue/chunks/UiTree.js +1 -1
  277. package/vue/chunks/UiTreeItem.js +1 -1
  278. package/vue/components.css +857 -2184
  279. package/vue/editor/index.js +8 -2
package/docs/README.md CHANGED
@@ -12,12 +12,12 @@ In a project with a `package.json`, install Looma and its documentation tools:
12
12
 
13
13
  ```sh
14
14
  pnpm add @threadlabs/looma @nextwebwg/html-next@1.0.0-alpha.69
15
- pnpm add -D 'markupress@>=0.10.0 <1' '@threadlabs/markupkit@>=0.2.0 <1' vite
15
+ pnpm add -D 'markupress@>=0.10.2 <1' '@threadlabs/markupkit@>=0.2.0 <1' vite
16
16
  pnpm exec looma-docs init --title "The Fellowship"
17
17
  pnpm exec looma-docs dev
18
18
  ```
19
19
 
20
- Use the tool versions accepted by Looma's optional peer dependencies. Markupress 0.10 and later compatible 0.x releases supply the current documentation theme, including one appearance button that cycles Automatic, Light and Dark. Regular component imports do not load the documentation server. Vue and Tiptap remain optional; install them when your own authored documentation mounts the Vue editor.
20
+ Use the tool versions accepted by Looma's optional peer dependencies. Markupress 0.10.2 and later compatible 0.x releases supply the shared Looma site header, mobile home-page navigation, and one appearance button that cycles Automatic, Light and Dark. Regular component imports do not load the documentation server. Vue and Tiptap remain optional; install them when your own authored documentation mounts the Vue editor.
21
21
 
22
22
  Initialization creates three project-owned files:
23
23
 
@@ -34,7 +34,7 @@ The CSS includes generated derivation rules as well as values. Re-export or save
34
34
  Open the local address printed by `dev`, choose **Customize**, and save your theme. Saving updates those shared theme files and rebuilds the documentation. Your application consumes the same CSS import. A static or public site instead offers CSS and recipe downloads.
35
35
 
36
36
  Starting points set a complete identity across color, typography, shape, spacing,
37
- material and motion. Palette and material refinements then change only their own
37
+ material and motion. Looma is the default identity; Gold pairs a warm action color with Lato/Fraunces and restrained polished surfaces. Clear remains a neutral starting point. Palette and material refinements then change only their own
38
38
  families. The compact sampler includes heading, body and supporting text beside
39
39
  the controls. Search components searches your whole discovered catalog; nine
40
40
  previews render initially, and **Show more components** reveals the next group.
@@ -82,11 +82,15 @@ under `theme`; changing a site title does not require renaming those files.
82
82
 
83
83
  The authoring model groups shared decisions as Colour, Type, Size & spacing, Material and Motion. The controls expose shared intent: control roominess relative to text, rhythm, spacing, corners, inner and outer depth, and response pace.
84
84
 
85
- The generated values follow rules. The medium control height is base text size times control roominess; small and large heights follow the size ratio. Touch does not inflate the visible size ladder. Hit-area guidance is contextual and adjustable; 44px is a comfort preference for expanded targets, not a mandatory visible height. Invisible targets must not steal neighbouring controls. Rhythm coordinates gaps and unitless line-height multipliers. Spacing fine-tunes gaps independently of text ratios. Spacing derives from base text independently of control roominess and follows its own curve: linear at 1, increasingly curved toward 2, with stable endpoints so the largest gaps do not grow without bound. Depth generates families of shadows; it does not add motion amplitude. Fields and buttons with the same size setting use the same box height, while content can still grow when it needs more room.
85
+ The generated values follow rules. The medium control height is base text size times control roominess; small and large heights follow the size ratio. Touch does not inflate the visible size ladder. Hit-area guidance is contextual and adjustable; 44px is a comfort preference for expanded targets, not a mandatory visible height. Invisible targets must not steal neighbouring controls. Rhythm coordinates vertical Stack gaps and unitless line-height multipliers. It leaves horizontal navigation and control-row gaps alone. Spacing adjusts gaps and padding independently of text ratios. Spacing derives from base text independently of control roominess and follows its own curve: linear at 1, increasingly curved toward 2, with stable endpoints so the largest gaps do not grow without bound. Depth generates families of shadows; it does not add motion amplitude. Fields and buttons with the same size setting use the same box height, while content can still grow when it needs more room.
86
86
 
87
- Choose a coordinated palette, then refine surface warmth, color intensity and palette relationship. Warmth runs from cool to warm paper and ink, with 0.5 neutral; intensity runs from quiet to vivid, with 0.5 retaining original seed intensity. Keep my colors preserves the base hues; Related colors and Contrasting colors tint quiet surfaces toward neighboring and opposite hues. These decisions regenerate paired light/dark colors through Oklab/OKLCH operations, gamut repair and readability checks. They do not transform existing CSS colors live. Four Base colors remain visible for precise edits; the light/dark range previews and resolved values explain adjustments.
87
+ Choose a coordinated palette, then refine surface warmth, color intensity and palette relationship. Warmth runs from cool to warm paper and ink, with 0.5 neutral; intensity runs from quiet to vivid, with 0.5 retaining original seed intensity. Keep my colors preserves the base hues; Related colors and Contrasting colors tint quiet surfaces toward neighboring and opposite hues. These decisions regenerate paired light/dark colors through Oklab/OKLCH operations, gamut repair and readability checks. They do not transform existing CSS colors live. Four base colors remain visible for precise edits. Supporting accents optionally adds second and third brand seeds. They feed `tone="accent-secondary"` and `tone="accent-tertiary"` on Button, IconButton, Badge, Card, Meter and Text, with the same derived readable text, states and material response as the primary. Unset supporting accents follow primary; the primary remains the normal action voice.
88
88
 
89
- Documentation navigation stays out of the customization workspace. **Material & light** opens a movable light source, real component samples and bounded surface controls. **Palette** opens the coordinated light/dark ranges and their four Base colors. Each editor changes the same persistent theme. Returning to the overview, navigating to a component, or reloading keeps the result.
89
+ Palette details expose relationships rather than arbitrary status colors. **Neutrals & shared borders** derives restrained neutrals from text, an accent family or untinted gray, with fill strength and a shared minimum boundary contrast (default 2:1). Neutral solid/outline actions and form fields all consume `--ui-control-border` and its hover role. **Status colors** lets each role retain its semantic hue, harmonize toward the primary hue by at most 15 degrees, or use one of the three brand families. Perceptual saturation is coordinated with the primary; readability and material stops are resolved for both modes. Dark derivation separates canvas and content elevations, compensates quiet neutral fills and borders, and derives selection washes from readable contextual pigment. Subtle badges, toned cards, callouts, toasts and generated notifications share semantic background, foreground and border roles. Composed Text inherits the containing foreground; the document root supplies the normal body color. These roles provide paler light fills and visible dark tints. Optional overlay group overrides remain explicit choices instead of masking semantic defaults. There are no per-status color pickers. Words and icons preserve meaning when all statuses use one family. **Accent assignments** selects families for links, focus rings and selected rows. Light/dark specimens show these roles together, including an actual field beside the shared neutral actions.
90
+
91
+ Documentation navigation stays out of the customization workspace. **Material & light** opens a movable light source, real component samples and bounded surface controls. **Palette** opens light/dark specimens, base seeds and advanced relationship controls. Each editor changes the same persistent theme. Returning to the overview, navigating to a component, or reloading keeps the result.
92
+
93
+ Material starts with Finish, Transparency and Frosting. Advanced material contains the light source and its color, edge light, glow, depth and decorative rim extent. The quiet grid stays fixed across the customizer while the page scrolls; content plates remain opaque.
90
94
 
91
95
  A refined preset keeps its name with “customized” beside it. **Reset material** resets only material and light; **Reset palette** resets only the palette. These family choices are recorded in the recipe's optional `presets` mapping. The `values` mapping remains the complete source of the generated theme; a preset is a named combination of those values.
92
96
 
@@ -99,7 +103,7 @@ material, typography, spacing and motion. Open a summary to edit that subject; u
99
103
  **Overview** to return to the same dashboard position. Only the active editor shows
100
104
  its controls. Precise adjustments sit inside the relevant editor's detail sections.
101
105
 
102
- Typography pairs font selection with headings and body text. Size & spacing shows
106
+ Typography pairs font selection with headings and body text. Field labels follow body size by default; choose a separate label size to keep labels independent while help stays smaller. Size & spacing shows
103
107
  the shared control ladder and grouped content. Motion keeps a replayable study and
104
108
  a real popover beside duration and curve editing; the study follows the shared
105
109
  curve, travels at three times the feedback duration, and respects reduced motion.
@@ -125,8 +129,8 @@ The [public token reference](https://github.com/threadlabs-studio/looma/blob/mai
125
129
  | Family | Recipe decisions → CSS properties |
126
130
  | --- | --- |
127
131
  | Base colors | `action` → `--ui-accent`; `canvas` → `--ui-surface`; `surface` → `--ui-surface-raised`; `text` → `--ui-text` |
128
- | Palette generation (recipe only) | `warmth`, `color-intensity`, `palette-relationship`; compiled into resolved color roles, with no matching CSS custom properties |
129
- | Type | `body-font` → `--ui-font-sans`; `display-font` → `--ui-font-display`; `text-size` → `--ui-font-size`; `text-weight` → `--ui-font-medium` |
132
+ | Palette generation (recipe only) | `warmth`, `color-intensity`, `palette-relationship`, optional `secondary-action`/`tertiary-action`, `neutral-source`, `neutral-strength`, `neutral-border-contrast`, `status-chroma`, each status’s `*-source`, and `selection-accent`/`focus-accent`/`link-accent`; compiled into resolved color roles, with no matching CSS custom properties |
133
+ | Type | `body-font` → `--ui-font-sans`; `display-font` → `--ui-font-display`; `text-size` → `--ui-font-size`; `label-size` → `--ui-field-label-font-size` (`inherit` follows body); `text-weight` → `--ui-font-medium` |
130
134
  | Rhythm & spacing | `rhythm` → `--ui-rhythm`; `control-roominess` → `--ui-control-roominess`; `spacing` → `--ui-spacing`; `scale-contrast` → `--ui-scale-ratio`; `space-curve` → `--ui-space-curve`; `corner-roundness` → `--ui-radius-md`; `line-weight` → `--ui-border-width` |
131
135
  | Depth and transmission | `outer-depth` → `--ui-outer-depth`; `inner-depth` → `--ui-inner-depth`; `glassiness` → `--ui-glassiness`; `surface-separation` → `--ui-surface-separation`; `translucency` → `--ui-overlay-translucency` |
132
136
  | Finish and illumination | `finish` → `--ui-finish`; `edge-light` → `--ui-edge-light`; `glow` → `--ui-glow`; `light-x` → `--ui-light-x`; `light-y` → `--ui-light-y`; `light-spread` → `--ui-light-spread`; `light-strength` → `--ui-light-strength` |
@@ -261,3 +265,5 @@ The local editor writes only the configured recipe and CSS inside the project. I
261
265
  The writer stages complete files, serializes saves with a project lock, and rolls back the recipe if replacing the CSS fails. If a process stops during a save or build, close the old editor before removing its `.looma/theme-write.lock` or `.looma/docs-build.lock`; restart and save the loaded recipe to regenerate a consistent pair. Change the server base, output directory or theme-file paths by restarting `dev`.
262
266
 
263
267
  Preset choices use the styled, searchable dropdown already used for fonts and component examples. Palette choices include four color swatches for the accent, neutral fill, canvas and text; the selected field previews the current theme. An inherited default keeps muted text while its options remain readable.
268
+
269
+ Filled-action colors keep their supplied pigment. Readable on-fill ink is chosen independently from contextual text, outlines and focus. Neutral action and field boundaries derive from one contrast decision against their surfaces; their quiet fills are independent of primary pigment. Supporting brand families are separate from neutral secondary actions. Reflection preserves chromatic light and shade within that chosen foreground’s readability bounds.