@buffercreations/levelsui 0.1.1 → 0.1.4

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 (580) hide show
  1. package/01. Elements/actions/controls/button/button.definition.json +38 -4
  2. package/01. Elements/actions/controls/button/docs/README.md +67 -0
  3. package/01. Elements/actions/controls/button/{api.json → docs/api.json } +14 -5
  4. package/01. Elements/actions/controls/button/examples/contexts/code.html +1 -3
  5. package/01. Elements/actions/controls/button/examples/contexts/preview.html +8 -2
  6. package/01. Elements/actions/controls/button/examples/icon-only/code.html +3 -0
  7. package/01. Elements/actions/controls/button/examples/icon-only/preview.html +17 -0
  8. package/01. Elements/actions/controls/button/examples/icons/code.html +2 -4
  9. package/01. Elements/actions/controls/button/examples/icons/preview.html +12 -3
  10. package/01. Elements/actions/controls/button/examples/index.json +9 -2
  11. package/01. Elements/actions/controls/button/examples/native-default/code.html +0 -8
  12. package/01. Elements/actions/controls/button/examples/native-default/preview.html +0 -4
  13. package/01. Elements/actions/controls/button/examples/states/code.html +1 -1
  14. package/01. Elements/actions/controls/button/examples/states/preview.html +2 -2
  15. package/01. Elements/actions/controls/button/src/button.scss +215 -0
  16. package/01. Elements/actions/controls/button-lumen-shift/button-lumen-shift.definition.json +95 -0
  17. package/01. Elements/actions/controls/button-lumen-shift/docs/README.md +85 -0
  18. package/01. Elements/actions/controls/button-lumen-shift/docs/api.json +134 -0
  19. package/01. Elements/actions/controls/button-lumen-shift/examples/basic/code.html +3 -0
  20. package/01. Elements/actions/controls/button-lumen-shift/examples/basic/preview.html +3 -0
  21. package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/code.html +1 -0
  22. package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/preview.html +9 -0
  23. package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/code.html +3 -0
  24. package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/preview.html +14 -0
  25. package/01. Elements/actions/controls/button-lumen-shift/examples/icons/code.html +4 -0
  26. package/01. Elements/actions/controls/button-lumen-shift/examples/icons/preview.html +14 -0
  27. package/01. Elements/actions/controls/button-lumen-shift/examples/index.json +66 -0
  28. package/01. Elements/actions/controls/button-lumen-shift/examples/links/code.html +3 -0
  29. package/01. Elements/actions/controls/button-lumen-shift/examples/links/preview.html +3 -0
  30. package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/code.html +1 -0
  31. package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/preview.html +6 -0
  32. package/01. Elements/actions/controls/button-lumen-shift/examples/states/code.html +1 -0
  33. package/01. Elements/actions/controls/button-lumen-shift/examples/states/preview.html +4 -0
  34. package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/code.html +1 -0
  35. package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/preview.html +5 -0
  36. package/01. Elements/actions/controls/button-lumen-shift/src/button-lumen-shift.scss +543 -0
  37. package/01. Elements/feedback/tooltip/docs/README.md +49 -0
  38. package/01. Elements/feedback/tooltip/docs/api.json +78 -0
  39. package/01. Elements/feedback/tooltip/examples/arrow/code.html +4 -0
  40. package/01. Elements/feedback/tooltip/examples/arrow/preview.html +4 -0
  41. package/01. Elements/feedback/tooltip/examples/comfortable/code.html +4 -0
  42. package/01. Elements/feedback/tooltip/examples/comfortable/preview.html +4 -0
  43. package/01. Elements/feedback/tooltip/examples/default/code.html +4 -0
  44. package/01. Elements/feedback/tooltip/examples/default/preview.html +4 -0
  45. package/01. Elements/feedback/tooltip/examples/delays/code.html +4 -0
  46. package/01. Elements/feedback/tooltip/examples/delays/preview.html +4 -0
  47. package/01. Elements/feedback/tooltip/examples/disabled/code.html +6 -0
  48. package/01. Elements/feedback/tooltip/examples/disabled/preview.html +6 -0
  49. package/01. Elements/feedback/tooltip/examples/index.json +66 -0
  50. package/01. Elements/feedback/tooltip/examples/multiple/code.html +8 -0
  51. package/01. Elements/feedback/tooltip/examples/multiple/preview.html +8 -0
  52. package/01. Elements/feedback/tooltip/examples/shortcut/code.html +4 -0
  53. package/01. Elements/feedback/tooltip/examples/shortcut/preview.html +4 -0
  54. package/01. Elements/feedback/tooltip/examples/sides/code.html +4 -0
  55. package/01. Elements/feedback/tooltip/examples/sides/preview.html +16 -0
  56. package/01. Elements/feedback/tooltip/src/tooltip.js +233 -0
  57. package/01. Elements/feedback/tooltip/src/tooltip.scss +117 -0
  58. package/01. Elements/feedback/tooltip/tooltip.definition.json +42 -0
  59. package/01. Elements/forms/selection/checkbox/checkbox.definition.json +65 -0
  60. package/01. Elements/forms/selection/checkbox/docs/README.md +46 -0
  61. package/01. Elements/forms/selection/checkbox/docs/api.json +102 -0
  62. package/01. Elements/forms/selection/checkbox/examples/basic/code.html +7 -0
  63. package/01. Elements/forms/selection/checkbox/examples/basic/preview.html +4 -0
  64. package/01. Elements/forms/selection/checkbox/examples/description/code.html +7 -0
  65. package/01. Elements/forms/selection/checkbox/examples/description/preview.html +7 -0
  66. package/01. Elements/forms/selection/checkbox/examples/group/code.html +9 -0
  67. package/01. Elements/forms/selection/checkbox/examples/group/preview.html +6 -0
  68. package/01. Elements/forms/selection/checkbox/examples/index.json +44 -0
  69. package/01. Elements/forms/selection/checkbox/examples/sizes/code.html +6 -0
  70. package/01. Elements/forms/selection/checkbox/examples/sizes/preview.html +5 -0
  71. package/01. Elements/forms/selection/checkbox/examples/states/code.html +6 -0
  72. package/01. Elements/forms/selection/checkbox/examples/states/preview.html +7 -0
  73. package/01. Elements/forms/selection/checkbox/examples/table/code.html +1 -0
  74. package/01. Elements/forms/selection/checkbox/examples/table/preview.html +8 -0
  75. package/01. Elements/forms/selection/checkbox/src/checkbox.scss +157 -0
  76. package/01. Elements/forms/selection/select/docs/README.md +37 -0
  77. package/01. Elements/forms/selection/select/docs/api.json +105 -0
  78. package/01. Elements/forms/selection/select/examples/default/code.html +12 -0
  79. package/01. Elements/forms/selection/select/examples/default/preview.html +12 -0
  80. package/01. Elements/forms/selection/select/examples/disabled/code.html +12 -0
  81. package/01. Elements/forms/selection/select/examples/disabled/preview.html +12 -0
  82. package/01. Elements/forms/selection/select/examples/index.json +74 -0
  83. package/01. Elements/forms/selection/select/examples/invalid/code.html +12 -0
  84. package/01. Elements/forms/selection/select/examples/invalid/preview.html +12 -0
  85. package/01. Elements/forms/selection/select/examples/leading-avatar/code.html +12 -0
  86. package/01. Elements/forms/selection/select/examples/leading-avatar/preview.html +12 -0
  87. package/01. Elements/forms/selection/select/examples/leading-icon/code.html +12 -0
  88. package/01. Elements/forms/selection/select/examples/leading-icon/preview.html +12 -0
  89. package/01. Elements/forms/selection/select/examples/native/code.html +12 -0
  90. package/01. Elements/forms/selection/select/examples/native/preview.html +12 -0
  91. package/01. Elements/forms/selection/select/examples/search/code.html +12 -0
  92. package/01. Elements/forms/selection/select/examples/search/preview.html +12 -0
  93. package/01. Elements/forms/selection/select/examples/sizes/code.html +12 -0
  94. package/01. Elements/forms/selection/select/examples/sizes/preview.html +36 -0
  95. package/01. Elements/forms/selection/select/examples/status-dot/code.html +12 -0
  96. package/01. Elements/forms/selection/select/examples/status-dot/preview.html +12 -0
  97. package/01. Elements/forms/selection/select/select.definition.json +69 -0
  98. package/01. Elements/forms/selection/select/src/select.js +477 -0
  99. package/01. Elements/forms/selection/select/src/select.scss +312 -0
  100. package/01. Elements/media/identity/avatar/avatar.definition.json +48 -5
  101. package/01. Elements/media/identity/avatar/docs/README.md +61 -0
  102. package/01. Elements/media/identity/avatar/docs/api.json +96 -0
  103. package/01. Elements/media/identity/avatar/examples/badge/code.html +7 -0
  104. package/01. Elements/media/identity/avatar/examples/badge/preview.html +7 -0
  105. package/01. Elements/media/identity/avatar/examples/badge-icon/code.html +7 -0
  106. package/01. Elements/media/identity/avatar/examples/badge-icon/preview.html +7 -0
  107. package/01. Elements/media/identity/avatar/examples/basic/code.html +6 -0
  108. package/01. Elements/media/identity/avatar/examples/basic/preview.html +6 -0
  109. package/01. Elements/media/identity/avatar/examples/dropdown/code.html +8 -0
  110. package/01. Elements/media/identity/avatar/examples/dropdown/preview.html +6 -0
  111. package/01. Elements/media/identity/avatar/examples/fallback/code.html +5 -0
  112. package/01. Elements/media/identity/avatar/examples/fallback/preview.html +5 -0
  113. package/01. Elements/media/identity/avatar/examples/index.json +68 -23
  114. package/01. Elements/media/identity/avatar/examples/notification-count/code.html +6 -0
  115. package/01. Elements/media/identity/avatar/examples/notification-count/preview.html +7 -0
  116. package/01. Elements/media/identity/avatar/examples/notification-dot/code.html +6 -0
  117. package/01. Elements/media/identity/avatar/examples/notification-dot/preview.html +7 -0
  118. package/01. Elements/media/identity/avatar/examples/sizes/code.html +2 -2
  119. package/01. Elements/media/identity/avatar/examples/sizes/preview.html +19 -26
  120. package/01. Elements/media/identity/avatar/examples/square/code.html +5 -0
  121. package/01. Elements/media/identity/avatar/examples/square/preview.html +5 -0
  122. package/01. Elements/media/identity/avatar/examples/status-contexts/code.html +6 -0
  123. package/01. Elements/media/identity/avatar/examples/status-contexts/preview.html +13 -0
  124. package/01. Elements/media/identity/avatar/src/avatar.js +42 -0
  125. package/01. Elements/media/identity/avatar/src/avatar.scss +172 -0
  126. package/01. Elements/navigation/items/navigation-item/docs/README.md +52 -0
  127. package/01. Elements/navigation/items/navigation-item/docs/api.json +84 -0
  128. package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/code.html +9 -0
  129. package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/preview.html +18 -0
  130. package/01. Elements/navigation/items/navigation-item/examples/collapsible/code.html +9 -0
  131. package/01. Elements/navigation/items/navigation-item/examples/collapsible/preview.html +18 -0
  132. package/01. Elements/navigation/items/navigation-item/examples/icon-label/code.html +6 -0
  133. package/01. Elements/navigation/items/navigation-item/examples/icon-label/preview.html +1 -0
  134. package/01. Elements/navigation/items/navigation-item/examples/icon-only/code.html +7 -0
  135. package/01. Elements/navigation/items/navigation-item/examples/icon-only/preview.html +1 -0
  136. package/01. Elements/navigation/items/navigation-item/examples/index.json +45 -0
  137. package/01. Elements/navigation/items/navigation-item/examples/label-only/code.html +3 -0
  138. package/01. Elements/navigation/items/navigation-item/examples/label-only/preview.html +1 -0
  139. package/01. Elements/navigation/items/navigation-item/examples/states/code.html +9 -0
  140. package/01. Elements/navigation/items/navigation-item/examples/states/preview.html +17 -0
  141. package/01. Elements/navigation/items/navigation-item/navigation-item.definition.json +40 -0
  142. package/01. Elements/navigation/items/navigation-item/src/navigation-item.scss +185 -0
  143. package/01. Elements/status/indicators/badge/badge.definition.json +55 -0
  144. package/01. Elements/status/indicators/badge/docs/README.md +40 -0
  145. package/01. Elements/status/indicators/badge/docs/api.json +112 -0
  146. package/01. Elements/status/indicators/badge/examples/content/code.html +1 -0
  147. package/01. Elements/status/indicators/badge/examples/content/preview.html +3 -0
  148. package/01. Elements/status/indicators/badge/examples/contexts/code.html +1 -0
  149. package/01. Elements/status/indicators/badge/examples/contexts/preview.html +3 -0
  150. package/01. Elements/status/indicators/badge/examples/icons/code.html +1 -0
  151. package/01. Elements/status/indicators/badge/examples/icons/preview.html +3 -0
  152. package/01. Elements/status/indicators/badge/examples/index.json +58 -0
  153. package/01. Elements/status/indicators/badge/examples/links/code.html +1 -0
  154. package/01. Elements/status/indicators/badge/examples/links/preview.html +3 -0
  155. package/01. Elements/status/indicators/badge/examples/loading/code.html +1 -0
  156. package/01. Elements/status/indicators/badge/examples/loading/preview.html +3 -0
  157. package/01. Elements/status/indicators/badge/examples/sizes/code.html +1 -0
  158. package/01. Elements/status/indicators/badge/examples/sizes/preview.html +3 -0
  159. package/01. Elements/status/indicators/badge/examples/status/code.html +1 -0
  160. package/01. Elements/status/indicators/badge/examples/status/preview.html +3 -0
  161. package/01. Elements/status/indicators/badge/examples/treatments/code.html +1 -0
  162. package/01. Elements/status/indicators/badge/examples/treatments/preview.html +3 -0
  163. package/01. Elements/status/indicators/badge/src/badge.scss +109 -0
  164. package/02. Layouts/REFINEMENT-REVIEW.md +82 -0
  165. package/02. Layouts/UTILITY-RECIPES.md +97 -9
  166. package/02. Layouts/application/app-shell/app-shell.definition.json +7 -6
  167. package/02. Layouts/application/app-shell/docs/README.md +64 -0
  168. package/02. Layouts/application/app-shell/docs/api.json +125 -0
  169. package/02. Layouts/application/app-shell/examples/complete/code.html +19 -0
  170. package/02. Layouts/application/app-shell/examples/complete/preview.html +28 -0
  171. package/02. Layouts/application/app-shell/examples/dual/code.html +13 -0
  172. package/02. Layouts/application/app-shell/examples/dual/preview.html +26 -0
  173. package/02. Layouts/application/app-shell/examples/header-main/code.html +10 -0
  174. package/02. Layouts/application/app-shell/examples/header-main/preview.html +19 -0
  175. package/02. Layouts/application/app-shell/examples/index.json +51 -15
  176. package/02. Layouts/application/app-shell/examples/main-only/code.html +7 -0
  177. package/02. Layouts/application/app-shell/examples/main-only/preview.html +18 -0
  178. package/02. Layouts/application/app-shell/examples/right/code.html +16 -0
  179. package/02. Layouts/application/app-shell/examples/right/preview.html +25 -0
  180. package/02. Layouts/application/app-shell/examples/sizes/code.html +16 -0
  181. package/02. Layouts/application/app-shell/examples/sizes/preview.html +27 -0
  182. package/02. Layouts/application/app-shell/examples/standard/code.html +13 -0
  183. package/02. Layouts/application/app-shell/examples/standard/preview.html +22 -0
  184. package/02. Layouts/application/app-shell/examples/sticky/code.html +16 -0
  185. package/02. Layouts/application/app-shell/examples/sticky/preview.html +23 -0
  186. package/02. Layouts/application/app-shell/src/app-shell.scss +119 -0
  187. package/02. Layouts/application/page-frame/docs/README.md +13 -0
  188. package/02. Layouts/application/page-frame/docs/api.json +33 -0
  189. package/02. Layouts/application/page-frame/examples/footer/code.html +8 -0
  190. package/02. Layouts/application/page-frame/examples/footer/preview.html +11 -0
  191. package/02. Layouts/application/page-frame/examples/header/code.html +8 -0
  192. package/02. Layouts/application/page-frame/examples/header/preview.html +11 -0
  193. package/02. Layouts/application/page-frame/examples/index.json +30 -0
  194. package/02. Layouts/application/page-frame/examples/main/code.html +5 -0
  195. package/02. Layouts/application/page-frame/examples/main/preview.html +10 -0
  196. package/02. Layouts/application/page-frame/examples/standard/code.html +11 -0
  197. package/02. Layouts/application/page-frame/examples/standard/preview.html +12 -0
  198. package/02. Layouts/application/page-frame/page-frame.definition.json +24 -0
  199. package/02. Layouts/application/page-frame/src/page-frame.html +11 -0
  200. package/02. Layouts/composition/cluster/cluster.definition.json +24 -0
  201. package/02. Layouts/composition/cluster/docs/README.md +45 -0
  202. package/02. Layouts/composition/cluster/docs/api.json +29 -0
  203. package/02. Layouts/composition/cluster/examples/basic/code.html +3 -0
  204. package/02. Layouts/composition/cluster/examples/basic/preview.html +6 -0
  205. package/02. Layouts/composition/cluster/examples/index.json +9 -0
  206. package/02. Layouts/composition/cluster/src/cluster.html +3 -0
  207. package/02. Layouts/composition/inline/docs/README.md +45 -0
  208. package/02. Layouts/composition/inline/docs/api.json +28 -0
  209. package/02. Layouts/composition/inline/examples/basic/code.html +3 -0
  210. package/02. Layouts/composition/inline/examples/basic/preview.html +4 -0
  211. package/02. Layouts/composition/inline/examples/index.json +16 -0
  212. package/02. Layouts/composition/inline/examples/scrolling/code.html +3 -0
  213. package/02. Layouts/composition/inline/examples/scrolling/preview.html +14 -0
  214. package/02. Layouts/composition/inline/inline.definition.json +24 -0
  215. package/02. Layouts/composition/inline/src/inline.html +3 -0
  216. package/02. Layouts/composition/overlap/docs/README.md +47 -0
  217. package/02. Layouts/composition/overlap/docs/api.json +59 -0
  218. package/02. Layouts/composition/overlap/examples/basic/code.html +8 -0
  219. package/02. Layouts/composition/overlap/examples/basic/preview.html +9 -0
  220. package/02. Layouts/composition/overlap/examples/index.json +44 -0
  221. package/02. Layouts/composition/overlap/examples/size-2xs/code.html +8 -0
  222. package/02. Layouts/composition/overlap/examples/size-2xs/preview.html +9 -0
  223. package/02. Layouts/composition/overlap/examples/size-lg/code.html +8 -0
  224. package/02. Layouts/composition/overlap/examples/size-lg/preview.html +9 -0
  225. package/02. Layouts/composition/overlap/examples/size-sm/code.html +8 -0
  226. package/02. Layouts/composition/overlap/examples/size-sm/preview.html +9 -0
  227. package/02. Layouts/composition/overlap/examples/size-xl/code.html +8 -0
  228. package/02. Layouts/composition/overlap/examples/size-xl/preview.html +9 -0
  229. package/02. Layouts/composition/overlap/examples/size-xs/code.html +8 -0
  230. package/02. Layouts/composition/overlap/examples/size-xs/preview.html +9 -0
  231. package/02. Layouts/composition/overlap/overlap.definition.json +26 -0
  232. package/02. Layouts/composition/overlap/src/overlap.scss +51 -0
  233. package/02. Layouts/composition/sidebar/docs/README.md +84 -0
  234. package/02. Layouts/composition/sidebar/docs/api.json +70 -0
  235. package/02. Layouts/composition/sidebar/examples/basic/code.html +8 -0
  236. package/02. Layouts/composition/sidebar/examples/basic/preview.html +14 -0
  237. package/02. Layouts/composition/sidebar/examples/index.json +37 -0
  238. package/02. Layouts/composition/sidebar/examples/large/code.html +8 -0
  239. package/02. Layouts/composition/sidebar/examples/large/preview.html +14 -0
  240. package/02. Layouts/composition/sidebar/examples/size-2xs/code.html +8 -0
  241. package/02. Layouts/composition/sidebar/examples/size-2xs/preview.html +14 -0
  242. package/02. Layouts/composition/sidebar/examples/size-xs/code.html +8 -0
  243. package/02. Layouts/composition/sidebar/examples/size-xs/preview.html +14 -0
  244. package/02. Layouts/composition/sidebar/examples/small/code.html +8 -0
  245. package/02. Layouts/composition/sidebar/examples/small/preview.html +14 -0
  246. package/02. Layouts/{sections → composition}/sidebar/sidebar.definition.json +6 -5
  247. package/02. Layouts/composition/sidebar/src/sidebar.scss +38 -0
  248. package/02. Layouts/composition/split/docs/README.md +56 -0
  249. package/02. Layouts/composition/split/docs/api.json +51 -0
  250. package/02. Layouts/composition/split/examples/basic/code.html +8 -0
  251. package/02. Layouts/composition/split/examples/basic/preview.html +10 -0
  252. package/02. Layouts/composition/split/examples/index.json +23 -0
  253. package/02. Layouts/composition/split/examples/wide-end/code.html +8 -0
  254. package/02. Layouts/composition/split/examples/wide-end/preview.html +10 -0
  255. package/02. Layouts/composition/split/examples/wide-start/code.html +8 -0
  256. package/02. Layouts/composition/split/examples/wide-start/preview.html +10 -0
  257. package/02. Layouts/{content → composition}/split/split.definition.json +6 -5
  258. package/02. Layouts/composition/split/src/split.scss +29 -0
  259. package/02. Layouts/composition/stack/docs/README.md +48 -0
  260. package/02. Layouts/composition/stack/docs/api.json +61 -0
  261. package/02. Layouts/composition/stack/examples/basic/code.html +1 -2
  262. package/02. Layouts/composition/stack/examples/basic/preview.html +12 -2
  263. package/02. Layouts/composition/stack/examples/compact/code.html +3 -0
  264. package/02. Layouts/composition/stack/examples/compact/preview.html +14 -0
  265. package/02. Layouts/composition/stack/examples/index.json +44 -1
  266. package/02. Layouts/composition/stack/examples/size-2xs/code.html +3 -0
  267. package/02. Layouts/composition/stack/examples/size-2xs/preview.html +14 -0
  268. package/02. Layouts/composition/stack/examples/size-lg/code.html +3 -0
  269. package/02. Layouts/composition/stack/examples/size-lg/preview.html +14 -0
  270. package/02. Layouts/composition/stack/examples/size-xl/code.html +3 -0
  271. package/02. Layouts/composition/stack/examples/size-xl/preview.html +14 -0
  272. package/02. Layouts/composition/stack/examples/size-xs/code.html +3 -0
  273. package/02. Layouts/composition/stack/examples/size-xs/preview.html +14 -0
  274. package/02. Layouts/composition/stack/{stack.html → src/stack.html } +1 -2
  275. package/02. Layouts/composition/stack/stack.definition.json +22 -5
  276. package/02. Layouts/composition/switcher/docs/README.md +51 -0
  277. package/02. Layouts/composition/switcher/docs/api.json +37 -0
  278. package/02. Layouts/composition/switcher/examples/basic/code.html +3 -0
  279. package/02. Layouts/composition/switcher/examples/basic/preview.html +14 -0
  280. package/02. Layouts/composition/switcher/examples/index.json +9 -0
  281. package/02. Layouts/composition/switcher/src/switcher.scss +24 -0
  282. package/02. Layouts/composition/switcher/switcher.definition.json +26 -0
  283. package/02. Layouts/content/grid/docs/README.md +77 -0
  284. package/02. Layouts/content/grid/docs/api.json +67 -0
  285. package/02. Layouts/content/grid/examples/basic/code.html +2 -4
  286. package/02. Layouts/content/grid/examples/basic/preview.html +13 -4
  287. package/02. Layouts/content/grid/examples/dense/code.html +3 -0
  288. package/02. Layouts/content/grid/examples/dense/preview.html +18 -0
  289. package/02. Layouts/content/grid/examples/index.json +30 -2
  290. package/02. Layouts/content/grid/examples/large/code.html +3 -0
  291. package/02. Layouts/content/grid/examples/large/preview.html +14 -0
  292. package/02. Layouts/content/grid/examples/size-2xs/code.html +3 -0
  293. package/02. Layouts/content/grid/examples/size-2xs/preview.html +14 -0
  294. package/02. Layouts/content/grid/examples/size-xs/code.html +3 -0
  295. package/02. Layouts/content/grid/examples/size-xs/preview.html +14 -0
  296. package/02. Layouts/content/grid/grid.definition.json +5 -4
  297. package/02. Layouts/content/grid/src/grid.scss +32 -0
  298. package/02. Layouts/content/reel/docs/README.md +81 -0
  299. package/02. Layouts/content/reel/docs/api.json +67 -0
  300. package/02. Layouts/content/reel/examples/basic/code.html +3 -0
  301. package/02. Layouts/content/reel/examples/basic/preview.html +14 -0
  302. package/02. Layouts/content/reel/examples/index.json +30 -0
  303. package/02. Layouts/content/reel/examples/size-2xs/code.html +3 -0
  304. package/02. Layouts/content/reel/examples/size-2xs/preview.html +14 -0
  305. package/02. Layouts/content/reel/examples/size-xs/code.html +3 -0
  306. package/02. Layouts/content/reel/examples/size-xs/preview.html +14 -0
  307. package/02. Layouts/content/reel/examples/small/code.html +3 -0
  308. package/02. Layouts/content/reel/examples/small/preview.html +14 -0
  309. package/02. Layouts/content/reel/reel.definition.json +26 -0
  310. package/02. Layouts/content/reel/src/reel.scss +40 -0
  311. package/02. Layouts/primitives/center/center.definition.json +24 -0
  312. package/02. Layouts/primitives/center/docs/README.md +44 -0
  313. package/02. Layouts/primitives/center/docs/api.json +28 -0
  314. package/02. Layouts/primitives/center/examples/basic/code.html +3 -0
  315. package/02. Layouts/primitives/center/examples/basic/preview.html +4 -0
  316. package/02. Layouts/primitives/center/examples/index.json +16 -0
  317. package/02. Layouts/primitives/center/examples/minimum-height/code.html +3 -0
  318. package/02. Layouts/primitives/center/examples/minimum-height/preview.html +4 -0
  319. package/02. Layouts/primitives/center/src/center.html +3 -0
  320. package/02. Layouts/primitives/container/container.definition.json +24 -0
  321. package/02. Layouts/primitives/container/docs/README.md +44 -0
  322. package/02. Layouts/primitives/container/docs/api.json +28 -0
  323. package/02. Layouts/primitives/container/examples/basic/code.html +3 -0
  324. package/02. Layouts/primitives/container/examples/basic/preview.html +6 -0
  325. package/02. Layouts/primitives/container/examples/index.json +16 -0
  326. package/02. Layouts/primitives/container/examples/reading/code.html +3 -0
  327. package/02. Layouts/primitives/container/examples/reading/preview.html +4 -0
  328. package/02. Layouts/primitives/container/src/container.html +3 -0
  329. package/02. Layouts/primitives/frame/docs/README.md +45 -0
  330. package/02. Layouts/primitives/frame/docs/api.json +29 -0
  331. package/02. Layouts/primitives/frame/examples/basic/code.html +3 -0
  332. package/02. Layouts/primitives/frame/examples/basic/preview.html +6 -0
  333. package/02. Layouts/primitives/frame/examples/index.json +16 -0
  334. package/02. Layouts/primitives/frame/examples/square/code.html +3 -0
  335. package/02. Layouts/primitives/frame/examples/square/preview.html +6 -0
  336. package/02. Layouts/primitives/frame/frame.definition.json +24 -0
  337. package/02. Layouts/primitives/frame/src/frame.html +3 -0
  338. package/02. Layouts/sections/bleed/bleed.definition.json +24 -0
  339. package/02. Layouts/sections/bleed/docs/README.md +45 -0
  340. package/02. Layouts/sections/bleed/docs/api.json +33 -0
  341. package/02. Layouts/sections/bleed/examples/basic/code.html +11 -0
  342. package/02. Layouts/sections/bleed/examples/basic/preview.html +14 -0
  343. package/02. Layouts/sections/bleed/examples/index.json +16 -0
  344. package/02. Layouts/sections/bleed/examples/reading/code.html +11 -0
  345. package/02. Layouts/sections/bleed/examples/reading/preview.html +14 -0
  346. package/02. Layouts/sections/bleed/src/bleed.html +11 -0
  347. package/02. Layouts/sections/content-grid/content-grid.definition.json +26 -0
  348. package/02. Layouts/sections/content-grid/docs/README.md +59 -0
  349. package/02. Layouts/sections/content-grid/docs/api.json +38 -0
  350. package/02. Layouts/sections/content-grid/examples/basic/code.html +11 -0
  351. package/02. Layouts/sections/content-grid/examples/basic/preview.html +10 -0
  352. package/02. Layouts/sections/content-grid/examples/index.json +9 -0
  353. package/02. Layouts/sections/content-grid/src/content-grid.scss +16 -0
  354. package/02. Layouts/sections/cover/cover.definition.json +26 -0
  355. package/02. Layouts/sections/cover/docs/README.md +60 -0
  356. package/02. Layouts/sections/cover/docs/api.json +50 -0
  357. package/02. Layouts/sections/cover/examples/basic/code.html +11 -0
  358. package/02. Layouts/sections/cover/examples/basic/preview.html +8 -0
  359. package/02. Layouts/sections/cover/examples/compact/code.html +11 -0
  360. package/02. Layouts/sections/cover/examples/compact/preview.html +8 -0
  361. package/02. Layouts/sections/cover/examples/index.json +16 -0
  362. package/02. Layouts/sections/cover/src/cover.scss +41 -0
  363. package/02. Layouts/sections/section/docs/README.md +52 -0
  364. package/02. Layouts/sections/section/docs/api.json +63 -0
  365. package/02. Layouts/sections/section/examples/basic/code.html +2 -2
  366. package/02. Layouts/sections/section/examples/basic/preview.html +5 -2
  367. package/02. Layouts/sections/section/examples/index.json +37 -2
  368. package/02. Layouts/sections/section/examples/size-2xs/code.html +5 -0
  369. package/02. Layouts/sections/section/examples/size-2xs/preview.html +8 -0
  370. package/02. Layouts/sections/section/examples/size-md/code.html +5 -0
  371. package/02. Layouts/sections/section/examples/size-md/preview.html +8 -0
  372. package/02. Layouts/sections/section/examples/size-sm/code.html +5 -0
  373. package/02. Layouts/sections/section/examples/size-sm/preview.html +8 -0
  374. package/02. Layouts/sections/section/examples/size-xl/code.html +5 -0
  375. package/02. Layouts/sections/section/examples/size-xl/preview.html +8 -0
  376. package/02. Layouts/sections/section/examples/size-xs/code.html +5 -0
  377. package/02. Layouts/sections/section/examples/size-xs/preview.html +8 -0
  378. package/02. Layouts/sections/section/section.definition.json +8 -6
  379. package/02. Layouts/sections/section/src/section.html +5 -0
  380. package/03. Components/cards/card/card.definition.json +36 -0
  381. package/03. Components/cards/card/docs/README.md +27 -0
  382. package/03. Components/cards/card/docs/api.json +64 -0
  383. package/03. Components/cards/card/examples/badge-status/code.html +9 -0
  384. package/03. Components/cards/card/examples/badge-status/preview.html +9 -0
  385. package/03. Components/cards/card/examples/basic/code.html +6 -0
  386. package/03. Components/cards/card/examples/basic/preview.html +6 -0
  387. package/03. Components/cards/card/examples/button-action/code.html +11 -0
  388. package/03. Components/cards/card/examples/button-action/preview.html +11 -0
  389. package/03. Components/cards/card/examples/header-footer/code.html +13 -0
  390. package/03. Components/cards/card/examples/header-footer/preview.html +13 -0
  391. package/03. Components/cards/card/examples/index.json +48 -0
  392. package/03. Components/cards/card/examples/media/code.html +9 -0
  393. package/03. Components/cards/card/examples/media/preview.html +9 -0
  394. package/03. Components/cards/card/src/card.scss +56 -0
  395. package/03. Components/cards/card-disclosure/card-disclosure.definition.json +27 -0
  396. package/03. Components/cards/card-disclosure/docs/README.md +24 -0
  397. package/03. Components/cards/card-disclosure/docs/api.json +58 -0
  398. package/03. Components/cards/card-disclosure/examples/basic/code.html +16 -0
  399. package/03. Components/cards/card-disclosure/examples/basic/preview.html +16 -0
  400. package/03. Components/cards/card-disclosure/examples/expanded/code.html +16 -0
  401. package/03. Components/cards/card-disclosure/examples/expanded/preview.html +16 -0
  402. package/03. Components/cards/card-disclosure/examples/index.json +17 -0
  403. package/03. Components/cards/card-disclosure/src/card-disclosure.html +16 -0
  404. package/03. Components/cards/card-utility-summary/card-utility-summary.definition.json +24 -0
  405. package/03. Components/cards/card-utility-summary/docs/README.md +23 -0
  406. package/03. Components/cards/card-utility-summary/docs/api.json +33 -0
  407. package/03. Components/cards/card-utility-summary/examples/basic/code.html +13 -0
  408. package/03. Components/cards/card-utility-summary/examples/basic/preview.html +13 -0
  409. package/03. Components/cards/card-utility-summary/examples/compact/code.html +8 -0
  410. package/03. Components/cards/card-utility-summary/examples/compact/preview.html +8 -0
  411. package/03. Components/cards/card-utility-summary/examples/index.json +17 -0
  412. package/03. Components/cards/card-utility-summary/src/card-utility-summary.html +13 -0
  413. package/03. Components/data-display/statistics/stat-card/docs/README.md +104 -0
  414. package/03. Components/data-display/statistics/stat-card/docs/api.json +153 -0
  415. package/03. Components/data-display/statistics/stat-card/examples/action/code.html +8 -0
  416. package/03. Components/data-display/statistics/stat-card/examples/action/preview.html +21 -0
  417. package/03. Components/data-display/statistics/stat-card/examples/coloured-values/code.html +4 -0
  418. package/03. Components/data-display/statistics/stat-card/examples/coloured-values/preview.html +14 -0
  419. package/03. Components/data-display/statistics/stat-card/examples/icon-led/code.html +13 -0
  420. package/03. Components/data-display/statistics/stat-card/examples/icon-led/preview.html +27 -0
  421. package/03. Components/data-display/statistics/stat-card/examples/icons/code.html +8 -0
  422. package/03. Components/data-display/statistics/stat-card/examples/icons/preview.html +27 -0
  423. package/03. Components/data-display/statistics/stat-card/examples/index.json +117 -0
  424. package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/code.html +8 -0
  425. package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/preview.html +18 -0
  426. package/03. Components/data-display/statistics/stat-card/examples/long-value/code.html +5 -0
  427. package/03. Components/data-display/statistics/stat-card/examples/long-value/preview.html +7 -0
  428. package/03. Components/data-display/statistics/stat-card/examples/minimal/code.html +4 -0
  429. package/03. Components/data-display/statistics/stat-card/examples/minimal/preview.html +14 -0
  430. package/03. Components/data-display/statistics/stat-card/examples/sentiments/code.html +11 -0
  431. package/03. Components/data-display/statistics/stat-card/examples/sentiments/preview.html +26 -0
  432. package/03. Components/data-display/statistics/stat-card/examples/sizes/code.html +4 -0
  433. package/03. Components/data-display/statistics/stat-card/examples/sizes/preview.html +14 -0
  434. package/03. Components/data-display/statistics/stat-card/examples/standard/code.html +8 -0
  435. package/03. Components/data-display/statistics/stat-card/examples/standard/preview.html +23 -0
  436. package/03. Components/data-display/statistics/stat-card/examples/states/code.html +5 -0
  437. package/03. Components/data-display/statistics/stat-card/examples/states/preview.html +17 -0
  438. package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/code.html +8 -0
  439. package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/preview.html +18 -0
  440. package/03. Components/data-display/statistics/stat-card/src/stat-card.scss +253 -0
  441. package/03. Components/data-display/statistics/stat-card/stat-card.definition.json +49 -0
  442. package/03. Components/media/identity/avatar-group/avatar-group.definition.json +39 -0
  443. package/03. Components/media/identity/avatar-group/docs/README.md +37 -0
  444. package/03. Components/media/identity/avatar-group/docs/api.json +99 -0
  445. package/03. Components/media/identity/avatar-group/examples/count/code.html +19 -0
  446. package/03. Components/media/identity/avatar-group/examples/count/preview.html +19 -0
  447. package/03. Components/media/identity/avatar-group/examples/count-icon/code.html +19 -0
  448. package/03. Components/media/identity/avatar-group/examples/count-icon/preview.html +19 -0
  449. package/03. Components/media/identity/avatar-group/examples/group/code.html +18 -0
  450. package/03. Components/media/identity/avatar-group/examples/group/preview.html +18 -0
  451. package/03. Components/media/identity/avatar-group/examples/index.json +38 -0
  452. package/03. Components/media/identity/avatar-group/examples/rtl/code.html +19 -0
  453. package/03. Components/media/identity/avatar-group/examples/rtl/preview.html +19 -0
  454. package/03. Components/media/identity/avatar-group/examples/sizes/code.html +14 -0
  455. package/03. Components/media/identity/avatar-group/examples/sizes/preview.html +27 -0
  456. package/03. Components/media/identity/avatar-group/src/avatar-group.scss +72 -0
  457. package/03. Components/navigation/menus/navigation-menu/docs/README.md +34 -0
  458. package/03. Components/navigation/menus/navigation-menu/docs/api.json +70 -0
  459. package/03. Components/navigation/menus/navigation-menu/examples/groups/code.html +27 -0
  460. package/03. Components/navigation/menus/navigation-menu/examples/groups/preview.html +27 -0
  461. package/03. Components/navigation/menus/navigation-menu/examples/horizontal/code.html +19 -0
  462. package/03. Components/navigation/menus/navigation-menu/examples/horizontal/preview.html +19 -0
  463. package/03. Components/navigation/menus/navigation-menu/examples/icon-links/code.html +36 -0
  464. package/03. Components/navigation/menus/navigation-menu/examples/icon-links/preview.html +36 -0
  465. package/03. Components/navigation/menus/navigation-menu/examples/index.json +45 -0
  466. package/03. Components/navigation/menus/navigation-menu/examples/nested/code.html +21 -0
  467. package/03. Components/navigation/menus/navigation-menu/examples/nested/preview.html +21 -0
  468. package/03. Components/navigation/menus/navigation-menu/examples/separators/code.html +22 -0
  469. package/03. Components/navigation/menus/navigation-menu/examples/separators/preview.html +22 -0
  470. package/03. Components/navigation/menus/navigation-menu/examples/vertical/code.html +19 -0
  471. package/03. Components/navigation/menus/navigation-menu/examples/vertical/preview.html +19 -0
  472. package/03. Components/navigation/menus/navigation-menu/navigation-menu.definition.json +38 -0
  473. package/03. Components/navigation/menus/navigation-menu/src/navigation-menu.scss +78 -0
  474. package/03. Components/navigation/sidebars/floating-sidebar/docs/README.md +48 -0
  475. package/03. Components/navigation/sidebars/floating-sidebar/docs/api.json +58 -0
  476. package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/code.html +42 -0
  477. package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/preview.html +42 -0
  478. package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/code.html +43 -0
  479. package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/preview.html +43 -0
  480. package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/code.html +50 -0
  481. package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/preview.html +50 -0
  482. package/03. Components/navigation/sidebars/floating-sidebar/examples/index.json +50 -0
  483. package/03. Components/navigation/sidebars/floating-sidebar/examples/long/code.html +66 -0
  484. package/03. Components/navigation/sidebars/floating-sidebar/examples/long/preview.html +66 -0
  485. package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/code.html +51 -0
  486. package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/preview.html +51 -0
  487. package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/code.html +42 -0
  488. package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/preview.html +42 -0
  489. package/03. Components/navigation/sidebars/floating-sidebar/floating-sidebar.definition.json +52 -0
  490. package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.js +73 -0
  491. package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.scss +163 -0
  492. package/README.md +60 -11
  493. package/dist/catalogue.json +442 -0
  494. package/dist/components/app-shell.css +76 -64
  495. package/dist/components/avatar-group.css +69 -0
  496. package/dist/components/avatar.css +98 -176
  497. package/dist/components/badge.css +118 -0
  498. package/dist/components/button-lumen-shift.css +388 -0
  499. package/dist/components/button.css +58 -28
  500. package/dist/components/card.css +47 -0
  501. package/dist/components/checkbox.css +129 -0
  502. package/dist/components/content-grid.css +16 -0
  503. package/dist/components/cover.css +41 -0
  504. package/dist/components/floating-sidebar.css +163 -0
  505. package/dist/components/grid.css +23 -13
  506. package/dist/components/navigation-item.css +169 -0
  507. package/dist/components/navigation-menu.css +74 -0
  508. package/dist/components/overlap.css +51 -0
  509. package/dist/components/reel.css +40 -0
  510. package/dist/components/select.css +288 -0
  511. package/dist/components/sidebar.css +33 -17
  512. package/dist/components/split.css +23 -16
  513. package/dist/components/stat-card.css +219 -0
  514. package/dist/components/switcher.css +24 -0
  515. package/dist/components/tooltip.css +101 -0
  516. package/package.json +7 -4
  517. package/schemas/reusable-ui.schema.json +145 -2
  518. package/tooling/cli/asset-organisation.mjs +126 -0
  519. package/tooling/cli/build.mjs +14 -7
  520. package/tooling/cli/cli.mjs +46 -19
  521. package/tooling/cli/commands.mjs +10 -0
  522. package/tooling/cli/configuration.mjs +60 -0
  523. package/tooling/cli/migrate.mjs +7 -4
  524. package/tooling/cli/project.mjs +188 -20
  525. package/tooling/registry/catalogue-index.mjs +54 -0
  526. package/tooling/registry/categories.mjs +3 -0
  527. package/tooling/registry/definitions.mjs +86 -9
  528. package/tooling/registry/native.mjs +32 -0
  529. package/tools/build-css.mjs +84 -30
  530. package/01. Elements/actions/controls/button/button.scss +0 -80
  531. package/01. Elements/actions/controls/button/docs.md +0 -41
  532. package/01. Elements/media/identity/avatar/api.json +0 -126
  533. package/01. Elements/media/identity/avatar/avatar.scss +0 -80
  534. package/01. Elements/media/identity/avatar/docs.md +0 -64
  535. package/01. Elements/media/identity/avatar/examples/badges/code.html +0 -10
  536. package/01. Elements/media/identity/avatar/examples/badges/preview.html +0 -29
  537. package/01. Elements/media/identity/avatar/examples/fallbacks/code.html +0 -5
  538. package/01. Elements/media/identity/avatar/examples/fallbacks/preview.html +0 -23
  539. package/01. Elements/media/identity/avatar/examples/presence/code.html +0 -6
  540. package/01. Elements/media/identity/avatar/examples/presence/preview.html +0 -26
  541. package/01. Elements/media/identity/avatar/examples/shapes/code.html +0 -5
  542. package/01. Elements/media/identity/avatar/examples/shapes/preview.html +0 -17
  543. package/02. Layouts/application/app-shell/api.json +0 -46
  544. package/02. Layouts/application/app-shell/app-shell.scss +0 -68
  545. package/02. Layouts/application/app-shell/docs.md +0 -31
  546. package/02. Layouts/application/app-shell/examples/basic/code.html +0 -17
  547. package/02. Layouts/application/app-shell/examples/basic/preview.html +0 -17
  548. package/02. Layouts/application/app-shell/examples/collapsed/code.html +0 -17
  549. package/02. Layouts/application/app-shell/examples/collapsed/preview.html +0 -17
  550. package/02. Layouts/application/app-shell/examples/hidden/code.html +0 -17
  551. package/02. Layouts/application/app-shell/examples/hidden/preview.html +0 -17
  552. package/02. Layouts/composition/stack/api.json +0 -1
  553. package/02. Layouts/composition/stack/docs.md +0 -5
  554. package/02. Layouts/content/grid/api.json +0 -23
  555. package/02. Layouts/content/grid/docs.md +0 -19
  556. package/02. Layouts/content/grid/grid.scss +0 -5
  557. package/02. Layouts/content/split/api.json +0 -23
  558. package/02. Layouts/content/split/docs.md +0 -18
  559. package/02. Layouts/content/split/examples/basic/code.html +0 -4
  560. package/02. Layouts/content/split/examples/basic/preview.html +0 -4
  561. package/02. Layouts/content/split/examples/index.json +0 -9
  562. package/02. Layouts/content/split/split.scss +0 -7
  563. package/02. Layouts/primitives/overlay/api.json +0 -23
  564. package/02. Layouts/primitives/overlay/docs.md +0 -19
  565. package/02. Layouts/primitives/overlay/examples/basic/code.html +0 -5
  566. package/02. Layouts/primitives/overlay/examples/basic/preview.html +0 -5
  567. package/02. Layouts/primitives/overlay/examples/index.json +0 -9
  568. package/02. Layouts/primitives/overlay/overlay.definition.json +0 -25
  569. package/02. Layouts/primitives/overlay/overlay.scss +0 -4
  570. package/02. Layouts/sections/section/api.json +0 -23
  571. package/02. Layouts/sections/section/docs.md +0 -19
  572. package/02. Layouts/sections/section/section.scss +0 -4
  573. package/02. Layouts/sections/sidebar/api.json +0 -23
  574. package/02. Layouts/sections/sidebar/docs.md +0 -18
  575. package/02. Layouts/sections/sidebar/examples/basic/code.html +0 -4
  576. package/02. Layouts/sections/sidebar/examples/basic/preview.html +0 -4
  577. package/02. Layouts/sections/sidebar/examples/index.json +0 -9
  578. package/02. Layouts/sections/sidebar/sidebar.scss +0 -7
  579. package/dist/components/overlay.css +0 -17
  580. package/dist/components/section.css +0 -14
@@ -0,0 +1,46 @@
1
+ # Checkbox
2
+
3
+ Level 01 / Elements · Forms / Selection / Checkbox
4
+
5
+ A native checkbox with a compact BufferCore design. Use it for independent boolean options, multi-option groups and table-row selection. Select and Radio are separate controls; Checkbox does not impose single-selection behaviour.
6
+
7
+ ## Usage
8
+
9
+ ```html
10
+ <label class="bce-checkbox-field">
11
+ <input class="bce-checkbox" type="checkbox" name="terms" required>
12
+ <span class="bce-checkbox-field__content">
13
+ <span class="bce-checkbox-field__label">Agree to the terms</span>
14
+ <span class="bce-checkbox-field__description">Read the terms before continuing.</span>
15
+ </span>
16
+ </label>
17
+ ```
18
+
19
+ When native Element defaults are activated, `input[type="checkbox"]` gets the same control styling without the `bce-checkbox` class. The explicit class remains available for integrations. Labels and descriptions are ordinary HTML, not generated by JavaScript.
20
+
21
+ ## Sizes and states
22
+
23
+ Use `bce-checkbox--sm`, `bce-checkbox--md` (default), or `bce-checkbox--lg` for control sizing. Native `checked`, `disabled`, and `required` attributes work normally. Set `aria-invalid="true"` for invalid styling and associate error text using `aria-describedby`.
24
+
25
+ **Mixed/indeterminate is a native JavaScript property, not an HTML attribute:**
26
+
27
+ ```js
28
+ const checkbox = document.querySelector('#select-all');
29
+ checkbox.indeterminate = true;
30
+ ```
31
+
32
+ When clicked, the native checkbox clears its mixed state. The optional `data-indeterminate="true"` is only a **static Studio visual representation**; never rely on it for application state or form submission. The actual check state remains `checkbox.checked`.
33
+
34
+ ## Group and table usage
35
+
36
+ Use `<fieldset>` and `<legend>` for related preferences. Tables should keep their checkbox accessible names (such as `aria-label="Select Sarah Chen"`) and own "select all" synchronisation in application code. Never implement a second keyboard or checked-state controller in LevelsUI.
37
+
38
+ ## Styling and integration
39
+
40
+ Styles use BufferCore Semantic tokens, context mappings, named sizes and scoped `--bce-checkbox-*` hooks. The checked fill responds to the inherited context while the default unchecked surface stays neutral. No hard-coded colours, `!important`, inline style attributes, JavaScript module, Runtime or Behaviour dependencies are required.
41
+
42
+ Use Core layout utilities for page or form arrangements; `bce-checkbox-field` is only a reusable label/content anatomy. No RTL-specific examples are included.
43
+
44
+ ## Native ownership and disabled presentation
45
+
46
+ In a new CLI project, installation and activation do not select native ownership. Run `levelsui default checkbox checkbox` to style class-free checkboxes, or retain explicit `.bce-checkbox` classes. Disabled control/field presentation consumes `--bc-interaction-disabled-opacity`; native disabled behaviour remains browser-owned.
@@ -0,0 +1,102 @@
1
+ {
2
+ "variants": [
3
+ {
4
+ "id": "default",
5
+ "className": "bce-checkbox",
6
+ "default": true
7
+ }
8
+ ],
9
+ "sizes": [
10
+ {
11
+ "id": "sm",
12
+ "className": "bce-checkbox--sm"
13
+ },
14
+ {
15
+ "id": "md",
16
+ "className": "bce-checkbox--md",
17
+ "default": true
18
+ },
19
+ {
20
+ "id": "lg",
21
+ "className": "bce-checkbox--lg"
22
+ }
23
+ ],
24
+ "anatomy": [
25
+ "native checkbox input",
26
+ "associated label (recommended)",
27
+ "description (optional)",
28
+ "fieldset and legend (for a related group)"
29
+ ],
30
+ "properties": [
31
+ {
32
+ "name": "Native default",
33
+ "type": "HTML element selector",
34
+ "default": "project-selected",
35
+ "description": "Select with levelsui default checkbox checkbox after installation and activation. New projects have no native owner until selected; .bce-checkbox remains the explicit alternative."
36
+ },
37
+ {
38
+ "name": "Checked",
39
+ "type": "native property/attribute",
40
+ "default": "false",
41
+ "description": "Use checked/defaultChecked or set input.checked; native change events notify the consumer."
42
+ },
43
+ {
44
+ "name": "Indeterminate",
45
+ "type": "native JavaScript property",
46
+ "default": "false",
47
+ "description": "Set input.indeterminate = true; the browser does not provide an HTML indeterminate attribute. Use data-indeterminate only for a static preview representation."
48
+ },
49
+ {
50
+ "name": "Disabled",
51
+ "type": "native attribute",
52
+ "default": "false",
53
+ "description": "Disabled options cannot be focused or submitted; avoid aria-disabled as a substitute."
54
+ },
55
+ {
56
+ "name": "Required",
57
+ "type": "native attribute",
58
+ "default": "false",
59
+ "description": "Use required with a meaningful accessible label and application-side validation messages."
60
+ },
61
+ {
62
+ "name": "Invalid",
63
+ "type": "ARIA attribute",
64
+ "default": "false",
65
+ "description": "Set aria-invalid=\"true\" on the input; associate error text using aria-describedby."
66
+ },
67
+ {
68
+ "name": "Sizes",
69
+ "type": "CSS modifier",
70
+ "default": "md",
71
+ "description": "Available sm, md and lg, applied to the input element."
72
+ },
73
+ {
74
+ "name": "Colour context",
75
+ "type": "inherited class",
76
+ "default": "inherited",
77
+ "description": "Selected fill uses BufferCore Semantic context tokens; neutral control surface stays independent of theme context."
78
+ }
79
+ ],
80
+ "accessibility": [
81
+ "Use a native input type=\"checkbox\" and a correctly linked label.",
82
+ "For grouped choices use fieldset and legend.",
83
+ "Support focus-visible, checked, indeterminate, disabled and invalid states.",
84
+ "Indeterminate is neither checked nor submitted as checked unless input.checked is true.",
85
+ "Avoid replacing native events or implementing custom keyboard toggling."
86
+ ],
87
+ "tags": [
88
+ "forms",
89
+ "selection",
90
+ "checkbox",
91
+ "states",
92
+ "application-ui",
93
+ "native",
94
+ "standard"
95
+ ],
96
+ "notes": [
97
+ "CSS-only Element: checked, focus, keyboard, form submission and validation remain native.",
98
+ "For full-row click targets wrap the native checkbox and text in a label.",
99
+ "For indeterminate at runtime set input.indeterminate = true; data-indeterminate is a Studio-only static visual aid and not a replacement for the property.",
100
+ "No RTL-specific logic or examples."
101
+ ]
102
+ }
@@ -0,0 +1,7 @@
1
+ <label class="bce-checkbox-field">
2
+ <input type="checkbox" name="terms" required>
3
+ <span class="bce-checkbox-field__content">
4
+ <span class="bce-checkbox-field__label">Agree to terms</span>
5
+ <span class="bce-checkbox-field__description">By clicking, you agree to the terms and conditions.</span>
6
+ </span>
7
+ </label>
@@ -0,0 +1,4 @@
1
+ <div class="bc-flex bc-flex-col bc-gap-sm">
2
+ <label class="bce-checkbox-field"><input type="checkbox" name="newsletter"><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Email updates</span><span class="bce-checkbox-field__description">Send me occasional product news.</span></span></label>
3
+ <label class="bce-checkbox-field"><input type="checkbox" name="terms" checked><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Agree to terms</span><span class="bce-checkbox-field__description">I have read and accept the terms and conditions.</span></span></label>
4
+ </div>
@@ -0,0 +1,7 @@
1
+ <label class="bce-checkbox-field">
2
+ <input class="bce-checkbox" type="checkbox" name="digest">
3
+ <span class="bce-checkbox-field__content">
4
+ <span class="bce-checkbox-field__label">Weekly digest</span>
5
+ <span class="bce-checkbox-field__description">Receive one summary of activity each Friday.</span>
6
+ </span>
7
+ </label>
@@ -0,0 +1,7 @@
1
+ <label class="bce-checkbox-field">
2
+ <input class="bce-checkbox" type="checkbox" name="digest">
3
+ <span class="bce-checkbox-field__content">
4
+ <span class="bce-checkbox-field__label">Weekly digest</span>
5
+ <span class="bce-checkbox-field__description">Receive one summary of activity each Friday.</span>
6
+ </span>
7
+ </label>
@@ -0,0 +1,9 @@
1
+ <fieldset>
2
+ <legend>Show on desktop</legend>
3
+ <label class="bce-checkbox-field">
4
+ <input class="bce-checkbox" type="checkbox" name="widgets" value="calendar" checked>
5
+ <span class="bce-checkbox-field__content">
6
+ <span class="bce-checkbox-field__label">Calendar</span>
7
+ </span>
8
+ </label>
9
+ </fieldset>
@@ -0,0 +1,6 @@
1
+ <fieldset class="bc-flex bc-flex-col bc-gap-sm">
2
+ <legend>Show on desktop</legend>
3
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="widgets" value="calendar" checked><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Calendar</span></span></label>
4
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="widgets" value="weather" checked><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Weather</span></span></label>
5
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="widgets" value="news"><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">News</span></span></label>
6
+ </fieldset>
@@ -0,0 +1,44 @@
1
+ [
2
+ {
3
+ "id": "basic",
4
+ "title": "Basic",
5
+ "description": "Native checkbox with a clickable label and a short description",
6
+ "preview": "examples/basic/preview.html",
7
+ "code": "examples/basic/code.html"
8
+ },
9
+ {
10
+ "id": "states",
11
+ "title": "States",
12
+ "description": "Checked, unchecked, disabled, invalid and mixed states",
13
+ "preview": "examples/states/preview.html",
14
+ "code": "examples/states/code.html"
15
+ },
16
+ {
17
+ "id": "sizes",
18
+ "title": "Sizes",
19
+ "description": "Three named checkbox sizes",
20
+ "preview": "examples/sizes/preview.html",
21
+ "code": "examples/sizes/code.html"
22
+ },
23
+ {
24
+ "id": "description",
25
+ "title": "Description",
26
+ "description": "Multi-line text paired with the checkbox",
27
+ "preview": "examples/description/preview.html",
28
+ "code": "examples/description/code.html"
29
+ },
30
+ {
31
+ "id": "group",
32
+ "title": "Checkbox group",
33
+ "description": "Multiple independent selections inside a fieldset",
34
+ "preview": "examples/group/preview.html",
35
+ "code": "examples/group/code.html"
36
+ },
37
+ {
38
+ "id": "table",
39
+ "title": "Table selection",
40
+ "description": "Native row selection controls with accessible names",
41
+ "preview": "examples/table/preview.html",
42
+ "code": "examples/table/code.html"
43
+ }
44
+ ]
@@ -0,0 +1,6 @@
1
+ <label class="bce-checkbox-field">
2
+ <input class="bce-checkbox bce-checkbox--sm" type="checkbox" name="compact" checked>
3
+ <span class="bce-checkbox-field__content">
4
+ <span class="bce-checkbox-field__label">Compact</span>
5
+ </span>
6
+ </label>
@@ -0,0 +1,5 @@
1
+ <div class="bc-flex bc-flex-col bc-gap-sm">
2
+ <label class="bce-checkbox-field"><input class="bce-checkbox bce-checkbox--sm" type="checkbox" checked><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Small</span></span></label>
3
+ <label class="bce-checkbox-field"><input class="bce-checkbox bce-checkbox--md" type="checkbox" checked><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Medium (default)</span></span></label>
4
+ <label class="bce-checkbox-field"><input class="bce-checkbox bce-checkbox--lg" type="checkbox" checked><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Large</span></span></label>
5
+ </div>
@@ -0,0 +1,6 @@
1
+ <label class="bce-checkbox-field">
2
+ <input class="bce-checkbox" type="checkbox" name="alerts" checked>
3
+ <span class="bce-checkbox-field__content">
4
+ <span class="bce-checkbox-field__label">Notifications enabled</span>
5
+ </span>
6
+ </label>
@@ -0,0 +1,7 @@
1
+ <div class="bc-flex bc-flex-col bc-gap-sm">
2
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="state-unchecked"><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Unchecked</span></span></label>
3
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="state-checked" checked><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Checked</span></span></label>
4
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="state-mixed" data-indeterminate="true" aria-checked="mixed"><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Mixed (static preview)</span></span></label>
5
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="state-disabled" disabled><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Disabled</span></span></label>
6
+ <label class="bce-checkbox-field"><input class="bce-checkbox" type="checkbox" name="state-invalid" aria-invalid="true" aria-describedby="checkbox-example-error"><span class="bce-checkbox-field__content"><span class="bce-checkbox-field__label">Invalid</span><span class="bce-checkbox-field__description" id="checkbox-example-error">Select this option before continuing.</span></span></label>
7
+ </div>
@@ -0,0 +1 @@
1
+ <input class="bce-checkbox" type="checkbox" name="selected-users" value="sarah" aria-label="Select Sarah Chen">
@@ -0,0 +1,8 @@
1
+ <table>
2
+ <thead><tr><th scope="col"><input class="bce-checkbox" type="checkbox" aria-label="Select all users"></th><th scope="col">Name</th><th scope="col">Role</th></tr></thead>
3
+ <tbody>
4
+ <tr><td><input class="bce-checkbox" type="checkbox" aria-label="Select Sarah Chen"></td><td>Sarah Chen</td><td>Admin</td></tr>
5
+ <tr><td><input class="bce-checkbox" type="checkbox" aria-label="Select Marcus Rodriguez"></td><td>Marcus Rodriguez</td><td>User</td></tr>
6
+ <tr><td><input class="bce-checkbox" type="checkbox" aria-label="Select Priya Patel"></td><td>Priya Patel</td><td>Editor</td></tr>
7
+ </tbody>
8
+ </table>
@@ -0,0 +1,157 @@
1
+ $levelsui-selector: ":where(input[type=\"checkbox\"], .bce-checkbox)" !default;
2
+
3
+ //
4
+ // Checkbox — Level 01 / Elements
5
+ //
6
+ // Native input owns the checked value, keyboard activation and form lifecycle.
7
+ // BufferCore Semantics provide colour, typography-adjacent sizing and motion.
8
+ // No JavaScript, custom Behaviour or hard-coded colour is required.
9
+ //
10
+ #{$levelsui-selector} {
11
+ --bce-checkbox-size: var(--bc-size-ui-20);
12
+ --bce-checkbox-border: var(--bc-color-border-neutral-strong);
13
+ --bce-checkbox-background: var(--bc-color-surface-general-primary);
14
+ --bce-checkbox-checked-background: var(--bc-color-fill-context-strong);
15
+ --bce-checkbox-checked-border: var(--bc-color-fill-context-strong);
16
+ --bce-checkbox-indicator-colour: var(--bc-color-text-inverse);
17
+ --bce-checkbox-focus-colour: var(--bc-color-border-context-bold);
18
+ --bce-checkbox-radius: var(--bc-radius-xs);
19
+
20
+ appearance: none;
21
+ box-sizing: border-box;
22
+ display: inline-grid;
23
+ flex: none;
24
+ place-content: center;
25
+ width: var(--bce-checkbox-size);
26
+ height: var(--bce-checkbox-size);
27
+ margin: 0;
28
+ border: var(--bc-border-width-xs) solid var(--bce-checkbox-border);
29
+ border-radius: var(--bce-checkbox-radius);
30
+ background: var(--bce-checkbox-background);
31
+ color: var(--bce-checkbox-indicator-colour);
32
+ vertical-align: middle;
33
+ cursor: pointer;
34
+ transition: background-color var(--bc-motion-interaction), border-color var(--bc-motion-interaction);
35
+ }
36
+
37
+ //
38
+ // Indicator
39
+ //
40
+ // The tick uses currentColor so checked contexts remain consumer-configurable.
41
+ // A compact dash uses the same native indeterminate selector.
42
+ //
43
+ #{$levelsui-selector}::after {
44
+ content: "";
45
+ display: block;
46
+ box-sizing: border-box;
47
+ width: 44%;
48
+ height: 68%;
49
+ border: solid currentColor;
50
+ border-width: 0 var(--bc-border-width-sm) var(--bc-border-width-sm) 0;
51
+ transform: translateY(-8%) rotate(45deg);
52
+ opacity: 0;
53
+ }
54
+
55
+ #{$levelsui-selector}:checked,
56
+ #{$levelsui-selector}:indeterminate,
57
+ #{$levelsui-selector}[data-indeterminate="true"] {
58
+ border-color: var(--bce-checkbox-checked-border);
59
+ background: var(--bce-checkbox-checked-background);
60
+ }
61
+
62
+ #{$levelsui-selector}:checked::after,
63
+ #{$levelsui-selector}:indeterminate::after,
64
+ #{$levelsui-selector}[data-indeterminate="true"]::after {
65
+ opacity: 1;
66
+ }
67
+
68
+ #{$levelsui-selector}:indeterminate::after,
69
+ #{$levelsui-selector}[data-indeterminate="true"]::after {
70
+ width: 54%;
71
+ height: 0;
72
+ border-width: 0 0 var(--bc-border-width-sm);
73
+ transform: none;
74
+ }
75
+
76
+ //
77
+ // Sizes
78
+ //
79
+ .bce-checkbox--sm {
80
+ --bce-checkbox-size: var(--bc-size-ui-16);
81
+ }
82
+
83
+ .bce-checkbox--md {
84
+ --bce-checkbox-size: var(--bc-size-ui-20);
85
+ }
86
+
87
+ .bce-checkbox--lg {
88
+ --bce-checkbox-size: var(--bc-size-ui-24);
89
+ }
90
+
91
+ //
92
+ // Interaction and validation
93
+ //
94
+ #{$levelsui-selector}:focus-visible {
95
+ outline: var(--bc-border-width-sm) solid var(--bce-checkbox-focus-colour);
96
+ outline-offset: var(--bc-size-ui-2);
97
+ }
98
+
99
+ #{$levelsui-selector}:is(:hover, :active):not(:disabled) {
100
+ border-color: var(--bc-color-border-context-bold);
101
+ }
102
+
103
+ #{$levelsui-selector}[aria-invalid="true"] {
104
+ --bce-checkbox-border: var(--bc-color-border-error-strong);
105
+ --bce-checkbox-focus-colour: var(--bc-color-border-error-bold);
106
+ }
107
+
108
+ #{$levelsui-selector}:disabled {
109
+ opacity: var(--bc-interaction-disabled-opacity);
110
+ cursor: not-allowed;
111
+ }
112
+
113
+ //
114
+ // Content composition
115
+ //
116
+ // Label and help copy use native semantics and Core's typography utilities.
117
+ // This optional root aligns rows without creating a second custom control.
118
+ //
119
+ .bce-checkbox-field {
120
+ display: flex;
121
+ align-items: flex-start;
122
+ gap: var(--bc-size-ui-8);
123
+ max-width: 100%;
124
+ cursor: pointer;
125
+ }
126
+
127
+ .bce-checkbox-field__content {
128
+ display: grid;
129
+ gap: var(--bc-size-ui-2);
130
+ min-width: 0;
131
+ }
132
+
133
+ .bce-checkbox-field__label {
134
+ font-family: var(--bc-type-label-3-font-family);
135
+ font-size: var(--bc-type-label-3-font-size);
136
+ font-weight: var(--bc-type-label-3-font-weight);
137
+ line-height: var(--bc-type-label-3-line-height);
138
+ letter-spacing: var(--bc-type-label-3-letter-spacing);
139
+ color: var(--bc-color-text);
140
+ }
141
+
142
+ .bce-checkbox-field__description {
143
+ font-family: var(--bc-type-label-4-font-family);
144
+ font-size: var(--bc-type-label-4-font-size);
145
+ font-weight: var(--bc-type-label-4-font-weight);
146
+ line-height: var(--bc-type-label-4-line-height);
147
+ letter-spacing: var(--bc-type-label-4-letter-spacing);
148
+ color: var(--bc-color-text-muted);
149
+ }
150
+
151
+ .bce-checkbox-field:has(input:disabled) {
152
+ cursor: not-allowed;
153
+ }
154
+
155
+ .bce-checkbox-field:has(input:disabled) .bce-checkbox-field__content {
156
+ opacity: var(--bc-interaction-disabled-opacity);
157
+ }
@@ -0,0 +1,37 @@
1
+ # Select
2
+
3
+ A single-choice form Element with native form value and optional rich presentation. Supports Standard and Searchable configurations. The reference design informs the compact proportions and list presentation; the implementation uses BufferCore Semantics, sizing, typography and shared Behaviours.
4
+
5
+ ## Markup and usage
6
+
7
+ Create a `.bce-select` wrapper containing a labelled native `<select class="bce-select__native">` and actual `<option>` values. The original select works without JavaScript. Add `data-native` to leave one instance native even when the application mounts other enhanced Select fields. Import `mountSelect` from this Asset's JS entry and call `mountSelect(root)` explicitly when rich dropdown options are desired. It returns `{ destroy() }`. Do not mount the same element with multiple independent runtimes.
8
+
9
+ Use `data-searchable` on the wrapper to include a filter input inside the expanded dropdown. Search is single-choice; a multi-select or tag control is a different Asset family. Use `data-supporting`, `data-icon`, `data-avatar` or `data-dot` on an `<option>` to supply optional row content. `data-icon` must be an Iconify identifier such as `hugeicons:user-02`; plain glyph characters are not supported. Labels and supporting text use text nodes, never untrusted HTML. The application must load Iconify for icon-enabled enhanced Select examples.
10
+
11
+ ## Styles
12
+
13
+ - Medium is the default. Small and large use `bce-select--sm` and `bce-select--lg`.
14
+ - Field and menu use neutral Semantic surfaces and foregrounds, independent of the active colour context. Option labels and supporting text sit alongside one another in compact rows. Context colour is not used as the menu fill.
15
+ - All dimensions, text and border styles use verified BufferCore Semantic and UI-size tokens.
16
+ - The dropdown defaults to the lighter `--bc-shadow-soft-fallen` Semantic recipe, rather than the much heavier contextual resting/floating shadows. Projects can set `--bce-select-menu-shadow: none` for flat surfaces. Theme/Flavour customisation occurs through documented `--bce-select-*` variables.
17
+ - No inline CSS, raw Primitive tokens or application-specific branding.
18
+
19
+ ## Data, state and behaviours
20
+
21
+ The native select owns `value`, `required`, `disabled`, form submission, reset and native `input`/`change` events. The application owns fetching, option updates and any business rules. Enhanced JS builds visual rows from `<option>` and observes option metadata changes. A consumer updating `select.value` should also dispatch `change` to synchronise the enhanced trigger.
22
+
23
+ Core `createDisclosure` owns open/close and topmost outside/Escape dismissal. Core `createTypeahead` supplies buffered character matching and repeated-character cycling. Asset-owned code handles active-option projection, arrow navigation and filtering; Roving Focus is unsuitable because focus stays on the combobox rather than moving into option rows. There is no new Foundation Behaviour and no second selection store. Destroy the mount on application teardown.
24
+
25
+ ## Accessibility and testing
26
+
27
+ Use a real `<label for>` and unique `<select id>`. Provide a meaningful empty `<option value="">` for required fields. Disabled options use native `disabled`. Keyboard: arrows/Home/End navigate, Enter selects, Escape dismisses. Standard mode supports buffered typeahead and repeated-character cycling; searchable mode filters via its labelled search input. Test native fallback, required validation, reset, dynamic options and multiple instances in a real browser.
28
+
29
+ ## Studio examples
30
+
31
+ Default, sizes, disabled, leading icons, avatars, status dots, searchable filtering, required/invalid and native fallback. The Preview is interactive when the Asset JS is mounted; the Code tab contains concise reusable markup.
32
+
33
+ ## Enhanced accessibility and updates
34
+
35
+ Enhancement keeps native form submission and validation while making the generated combobox the single keyboard stop. Native label clicks and validation focus are forwarded to it. Its `aria-controls` targets the listbox; native accessible labels, descriptions, required state and validity are projected to the trigger. Destroy restores the original native tabindex and aria-hidden attributes. Changes to native required/disabled attributes and option content/metadata are observed locally; changes to `.value` still require native input/change dispatch. This option projection observer is not Runtime lifecycle observation or automatic configuration loading.
36
+
37
+ The menu cap uses `--bc-size-ui-320` and the floating layer uses `--bc-layer-floating`. Empty filtered results show ?No results found?; fetching and network loading/error feedback remain application-owned.
@@ -0,0 +1,105 @@
1
+ {
2
+ "variants": [
3
+ {
4
+ "id": "standard",
5
+ "className": "bce-select",
6
+ "default": true
7
+ },
8
+ {
9
+ "id": "searchable",
10
+ "className": "bce-select",
11
+ "description": "Add data-searchable to the field; JS enhancement is required."
12
+ }
13
+ ],
14
+ "sizes": [
15
+ {
16
+ "id": "sm",
17
+ "className": "bce-select--sm"
18
+ },
19
+ {
20
+ "id": "md",
21
+ "className": "bce-select",
22
+ "default": true
23
+ },
24
+ {
25
+ "id": "lg",
26
+ "className": "bce-select--lg"
27
+ }
28
+ ],
29
+ "anatomy": [
30
+ ".bce-select",
31
+ ".bce-select__label (optional)",
32
+ "select.bce-select__native",
33
+ ".bce-select__hint (optional)",
34
+ "trigger, listbox and search generated when mounted"
35
+ ],
36
+ "properties": [
37
+ {
38
+ "name": "name and value",
39
+ "type": "native select attributes",
40
+ "description": "Native option value and form submission remain authoritative."
41
+ },
42
+ {
43
+ "name": "required and disabled",
44
+ "type": "native select attributes",
45
+ "description": "Native validation and disabled states."
46
+ },
47
+ {
48
+ "name": "data-searchable",
49
+ "type": "attribute on .bce-select",
50
+ "default": false,
51
+ "description": "Adds filtering search inside the enhanced menu; single choice only."
52
+ },
53
+ {
54
+ "name": "data-placeholder",
55
+ "type": "attribute on .bce-select",
56
+ "description": "Displayed when the native selection has no value."
57
+ },
58
+ {
59
+ "name": "data-native",
60
+ "type": "attribute on .bce-select",
61
+ "default": false,
62
+ "description": "Opt out of JS enhancement for one field; use the native select UI."
63
+ },
64
+ {
65
+ "name": "data-supporting",
66
+ "type": "attribute on option",
67
+ "description": "Secondary label shown with enhanced options."
68
+ },
69
+ {
70
+ "name": "data-icon / data-avatar / data-dot",
71
+ "type": "attributes on option",
72
+ "description": "Optional leading visuals. Avatar takes precedence over icon and dot."
73
+ },
74
+ {
75
+ "name": "mountSelect(root)",
76
+ "type": "JavaScript function",
77
+ "description": "Explicit enhancement; returns destroy() and does not double mount."
78
+ },
79
+ {
80
+ "name": "selection updates",
81
+ "type": "native input/change events",
82
+ "description": "App owns the data; update select.value and dispatch change to sync rich UI."
83
+ }
84
+ ],
85
+ "accessibility": [
86
+ "Native select works without JavaScript.",
87
+ "Enhanced trigger supports ArrowUp/Down, Home, End, Enter, Escape and Core buffered typeahead.",
88
+ "Search mode places focus in a labelled search field, filters the option list and announces active option with aria-activedescendant.",
89
+ "Disabled options are not selectable; selection updates native input/change.",
90
+ "Do not rely on a colour alone for selection or validity."
91
+ ],
92
+ "tags": [
93
+ "forms",
94
+ "selection",
95
+ "select",
96
+ "single-choice",
97
+ "search"
98
+ ],
99
+ "notes": [
100
+ "Uses direct @buffercreations/buffercore/behaviours/disclosure import; no separate declarative disclosure dependency.",
101
+ "No multi-select or tag selection.",
102
+ "Menu surfaces are neutral by default; consumer Flavours can override explicit bce-select variables.",
103
+ "Core Typeahead is imported directly; native focus/tabindex and accessible descriptions are handed to the generated combobox and restored on destroy."
104
+ ]
105
+ }
@@ -0,0 +1,12 @@
1
+ <div class="bce-select" data-placeholder="Select team member">
2
+ <label class="bce-select__label" for="select-default">Team member <span class="bce-select__required" aria-hidden="true">*</span></label>
3
+ <select class="bce-select__native" id="select-default" name="team-member" required aria-describedby="select-default-hint">
4
+ <option value="">Select team member</option>
5
+ <option value="phoenix" data-supporting="@phoenix">Phoenix Baker</option>
6
+ <option value="olivia" data-supporting="@olivia">Olivia Rhye</option>
7
+ <option value="lana" data-supporting="@lana" disabled>Lana Steiner</option>
8
+ <option value="demi" data-supporting="@demi">Demi Wilkinson</option>
9
+ <option value="candice" data-supporting="@candice">Candice Wu</option>
10
+ </select>
11
+ <small class="bce-select__hint" id="select-default-hint">Select a team member for this task.</small>
12
+ </div>
@@ -0,0 +1,12 @@
1
+ <div class="bce-select" data-placeholder="Select team member">
2
+ <label class="bce-select__label" for="select-default">Team member <span class="bce-select__required" aria-hidden="true">*</span></label>
3
+ <select class="bce-select__native" id="select-default" name="team-member" required aria-describedby="select-default-hint">
4
+ <option value="">Select team member</option>
5
+ <option value="phoenix" data-supporting="@phoenix">Phoenix Baker</option>
6
+ <option value="olivia" data-supporting="@olivia">Olivia Rhye</option>
7
+ <option value="lana" data-supporting="@lana" disabled>Lana Steiner</option>
8
+ <option value="demi" data-supporting="@demi">Demi Wilkinson</option>
9
+ <option value="candice" data-supporting="@candice">Candice Wu</option>
10
+ </select>
11
+ <small class="bce-select__hint" id="select-default-hint">Select a team member for this task.</small>
12
+ </div>
@@ -0,0 +1,12 @@
1
+ <div class="bce-select" data-placeholder="Select team member">
2
+ <label class="bce-select__label" for="select-disabled">Team member <span class="bce-select__required" aria-hidden="true">*</span></label>
3
+ <select class="bce-select__native" id="select-disabled" name="team-member" required aria-describedby="select-disabled-hint" disabled>
4
+ <option value="">Select team member</option>
5
+ <option value="phoenix" data-supporting="@phoenix">Phoenix Baker</option>
6
+ <option value="olivia" data-supporting="@olivia">Olivia Rhye</option>
7
+ <option value="lana" data-supporting="@lana" disabled>Lana Steiner</option>
8
+ <option value="demi" data-supporting="@demi">Demi Wilkinson</option>
9
+ <option value="candice" data-supporting="@candice">Candice Wu</option>
10
+ </select>
11
+ <small class="bce-select__hint" id="select-disabled-hint">Select a team member for this task.</small>
12
+ </div>