@caligo-ui/core 1.0.0 → 1.2.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 (226) hide show
  1. package/CHANGELOG.md +137 -0
  2. package/README.md +6 -5
  3. package/agent/caligo.json +648 -41
  4. package/dist/css/Accordion.css +6 -0
  5. package/dist/css/AccordionSummary.css +2 -0
  6. package/dist/css/Alert.css +8 -0
  7. package/dist/css/AppBar.css +2 -0
  8. package/dist/css/Avatar.css +4 -0
  9. package/dist/css/AvatarGroup.css +6 -0
  10. package/dist/css/Badge.css +6 -0
  11. package/dist/css/Breadcrumb.css +2 -0
  12. package/dist/css/Breadcrumbs.css +2 -0
  13. package/dist/css/Button.css +2 -0
  14. package/dist/css/ButtonGroup.css +4 -0
  15. package/dist/css/Card.css +4 -0
  16. package/dist/css/Checkbox.css +2 -0
  17. package/dist/css/Chip.css +4 -0
  18. package/dist/css/CircularProgress.css +2 -0
  19. package/dist/css/Collapse.css +2 -0
  20. package/dist/css/Collapsible.css +8 -0
  21. package/dist/css/Container.css +2 -0
  22. package/dist/css/Dialog.css +2 -0
  23. package/dist/css/Divider.css +2 -0
  24. package/dist/css/Drawer.css +2 -0
  25. package/dist/css/ErrorPanel.css +6 -0
  26. package/dist/css/FormControl.css +2 -0
  27. package/dist/css/FormControlLabel.css +2 -0
  28. package/dist/css/FormGroup.css +2 -0
  29. package/dist/css/FormHelperText.css +2 -0
  30. package/dist/css/FormLabel.css +2 -0
  31. package/dist/css/Grid.css +2 -0
  32. package/dist/css/Icon.css +4 -0
  33. package/dist/css/IconButton.css +4 -0
  34. package/dist/css/InputAdornment.css +2 -0
  35. package/dist/css/InputBase.css +2 -0
  36. package/dist/css/InputGroup.css +12 -0
  37. package/dist/css/Label.css +2 -0
  38. package/dist/css/LicenseInfo.css +2 -0
  39. package/dist/css/LinearProgress.css +2 -0
  40. package/dist/css/Link.css +2 -0
  41. package/dist/css/List.css +2 -0
  42. package/dist/css/ListItem.css +6 -0
  43. package/dist/css/ListItemAvatar.css +2 -0
  44. package/dist/css/ListItemButton.css +2 -0
  45. package/dist/css/ListItemIcon.css +4 -0
  46. package/dist/css/ListItemText.css +4 -0
  47. package/dist/css/ListSubheader.css +2 -0
  48. package/dist/css/Menu.css +2 -0
  49. package/dist/css/MenuItem.css +2 -0
  50. package/dist/css/MenuList.css +6 -0
  51. package/dist/css/NotificationBadge.css +6 -0
  52. package/dist/css/Pagination.css +6 -0
  53. package/dist/css/PaginationItem.css +4 -0
  54. package/dist/css/Paper.css +2 -0
  55. package/dist/css/Popover.css +2 -0
  56. package/dist/css/PreviewCard.css +4 -0
  57. package/dist/css/Progress.css +4 -0
  58. package/dist/css/Radio.css +2 -0
  59. package/dist/css/RadioGroup.css +2 -0
  60. package/dist/css/ScrollArea.css +2 -0
  61. package/dist/css/Select.css +10 -0
  62. package/dist/css/Separator.css +2 -0
  63. package/dist/css/Sheet.css +2 -0
  64. package/dist/css/Skeleton.css +2 -0
  65. package/dist/css/Slider.css +2 -0
  66. package/dist/css/Snackbar.css +4 -0
  67. package/dist/css/SnackbarContent.css +2 -0
  68. package/dist/css/Spinner.css +2 -0
  69. package/dist/css/Stack.css +2 -0
  70. package/dist/css/Switch.css +2 -0
  71. package/dist/css/Tab.css +2 -0
  72. package/dist/css/Table.css +2 -0
  73. package/dist/css/TableBody.css +2 -0
  74. package/dist/css/TableCell.css +2 -0
  75. package/dist/css/TableContainer.css +2 -0
  76. package/dist/css/TableFooter.css +2 -0
  77. package/dist/css/TableHead.css +2 -0
  78. package/dist/css/TableRow.css +2 -0
  79. package/dist/css/TableSortLabel.css +2 -0
  80. package/dist/css/Tabs.css +2 -0
  81. package/dist/css/Tag.css +4 -0
  82. package/dist/css/TextField.css +10 -0
  83. package/dist/css/Toast.css +4 -0
  84. package/dist/css/ToggleButton.css +2 -0
  85. package/dist/css/ToggleButtonGroup.css +2 -0
  86. package/dist/css/ToggleGroup.css +2 -0
  87. package/dist/css/Toolbar.css +2 -0
  88. package/dist/css/Tooltip.css +2 -0
  89. package/dist/css/Typography.css +2 -0
  90. package/dist/css/VirtualList.css +2 -0
  91. package/dist/esm/Alert/Alert.css +1 -1
  92. package/dist/esm/Alert/Alert2.js +2 -0
  93. package/dist/esm/Alert/Alert2.js.map +1 -1
  94. package/dist/esm/Avatar/Avatar.css +1 -1
  95. package/dist/esm/Avatar/Avatar2.js +33 -39
  96. package/dist/esm/Avatar/Avatar2.js.map +1 -1
  97. package/dist/esm/Breadcrumbs/Breadcrumbs.css +1 -1
  98. package/dist/esm/Button/Button.css +1 -1
  99. package/dist/esm/Button/Button2.js +36 -36
  100. package/dist/esm/Button/Button2.js.map +1 -1
  101. package/dist/esm/Button/buttonClasses.js +1 -1
  102. package/dist/esm/Button/buttonClasses.js.map +1 -1
  103. package/dist/esm/Card/Card.css +1 -1
  104. package/dist/esm/Checkbox/Checkbox.css +1 -1
  105. package/dist/esm/Chip/Chip.css +1 -1
  106. package/dist/esm/Chip/Chip2.js +30 -53
  107. package/dist/esm/Chip/Chip2.js.map +1 -1
  108. package/dist/esm/Dialog/Dialog.css +1 -1
  109. package/dist/esm/Dialog/Dialog2.js.map +1 -1
  110. package/dist/esm/Drawer/Drawer.css +1 -1
  111. package/dist/esm/FormLabel/FormLabel.css +1 -1
  112. package/dist/esm/IconButton/IconButton.css +1 -1
  113. package/dist/esm/IconButton/IconButton2.js +9 -8
  114. package/dist/esm/IconButton/IconButton2.js.map +1 -1
  115. package/dist/esm/InputBase/InputBase.js +52 -0
  116. package/dist/esm/InputBase/InputBase.js.map +1 -0
  117. package/dist/esm/InputBase/index.js +1 -0
  118. package/dist/esm/List/List.css +1 -1
  119. package/dist/esm/Menu/Menu.css +1 -1
  120. package/dist/esm/MenuItem/MenuItem.css +1 -1
  121. package/dist/esm/Paper/Paper.css +1 -1
  122. package/dist/esm/Popover/Popover.css +1 -1
  123. package/dist/esm/Radio/Radio.css +1 -1
  124. package/dist/esm/Radio/Radio2.js +74 -45
  125. package/dist/esm/Radio/Radio2.js.map +1 -1
  126. package/dist/esm/RadioGroup/RadioGroup.js +29 -22
  127. package/dist/esm/RadioGroup/RadioGroup.js.map +1 -1
  128. package/dist/esm/RadioGroup/radioGroupContext.js.map +1 -1
  129. package/dist/esm/ScrollArea/ScrollArea.css +1 -0
  130. package/dist/esm/ScrollArea/ScrollArea2.js +25 -0
  131. package/dist/esm/ScrollArea/ScrollArea2.js.map +1 -0
  132. package/dist/esm/ScrollArea/index.js +1 -0
  133. package/dist/esm/Select/Select.css +1 -1
  134. package/dist/esm/Snackbar/Snackbar.css +1 -1
  135. package/dist/esm/Switch/Switch.css +1 -1
  136. package/dist/esm/Switch/Switch2.js +47 -42
  137. package/dist/esm/Switch/Switch2.js.map +1 -1
  138. package/dist/esm/Tab/Tab.css +1 -1
  139. package/dist/esm/Tab/Tab2.js +29 -24
  140. package/dist/esm/Tab/Tab2.js.map +1 -1
  141. package/dist/esm/Table/Table.css +1 -1
  142. package/dist/esm/TableCell/TableCell.js +6 -6
  143. package/dist/esm/TableCell/TableCell.js.map +1 -1
  144. package/dist/esm/Tabs/Tabs.css +1 -1
  145. package/dist/esm/TextField/TextField.css +1 -1
  146. package/dist/esm/TextField/TextField2.js +106 -86
  147. package/dist/esm/TextField/TextField2.js.map +1 -1
  148. package/dist/esm/TextField/textFieldClasses.js +2 -0
  149. package/dist/esm/TextField/textFieldClasses.js.map +1 -1
  150. package/dist/esm/ToggleButton/ToggleButton.css +1 -1
  151. package/dist/esm/Toolbar/Toolbar.css +1 -1
  152. package/dist/esm/Tooltip/Tooltip.css +1 -1
  153. package/dist/esm/Tooltip/Tooltip2.js +50 -33
  154. package/dist/esm/Tooltip/Tooltip2.js.map +1 -1
  155. package/dist/esm/Typography/Typography.css +1 -1
  156. package/dist/esm/caligo.css +1 -1
  157. package/dist/esm/index.js +65 -63
  158. package/dist/esm/internal/glyphs.js +5 -0
  159. package/dist/esm/internal/glyphs.js.map +1 -1
  160. package/dist/esm/internal/hues.js +23 -0
  161. package/dist/esm/internal/hues.js.map +1 -0
  162. package/dist/esm/internal/inputEvent.js +22 -0
  163. package/dist/esm/internal/inputEvent.js.map +1 -0
  164. package/dist/esm/internal/releaseInfo.js +1 -1
  165. package/dist/esm/internal/releaseInfo.js.map +1 -1
  166. package/dist/esm/mui/index.js.map +1 -1
  167. package/dist/esm/mui/themeValues.js +106 -0
  168. package/dist/esm/mui/themeValues.js.map +1 -1
  169. package/dist/esm/parts/Breadcrumb.js +68 -0
  170. package/dist/esm/parts/Breadcrumb.js.map +1 -0
  171. package/dist/esm/parts/Combobox.js +171 -0
  172. package/dist/esm/parts/Combobox.js.map +1 -0
  173. package/dist/esm/parts/ContextMenu.js +17 -17
  174. package/dist/esm/parts/ContextMenu.js.map +1 -1
  175. package/dist/esm/parts/Menu.js +105 -24
  176. package/dist/esm/parts/Menu.js.map +1 -1
  177. package/dist/esm/parts/Select.js +120 -0
  178. package/dist/esm/parts/Select.js.map +1 -0
  179. package/dist/esm/parts/Toast.js +95 -0
  180. package/dist/esm/parts/Toast.js.map +1 -0
  181. package/dist/esm/parts/Toolbar.js +100 -0
  182. package/dist/esm/parts/Toolbar.js.map +1 -0
  183. package/dist/esm/parts/Tooltip.js +20 -8
  184. package/dist/esm/parts/Tooltip.js.map +1 -1
  185. package/dist/esm/parts/index.js +156 -87
  186. package/dist/esm/parts/index.js.map +1 -1
  187. package/dist/global/caligo-ui.css +1 -1
  188. package/dist/global/caligo-ui.js +1 -1
  189. package/dist/global/caligo-ui.js.map +1 -1
  190. package/dist/types/Alert/Alert.d.ts +7 -2
  191. package/dist/types/Avatar/Avatar.d.ts +38 -3
  192. package/dist/types/Button/Button.d.ts +9 -2
  193. package/dist/types/Button/buttonClasses.d.ts +2 -0
  194. package/dist/types/Chip/Chip.d.ts +21 -0
  195. package/dist/types/Dialog/Dialog.d.ts +1 -0
  196. package/dist/types/IconButton/IconButton.d.ts +6 -0
  197. package/dist/types/InputBase/InputBase.d.ts +64 -0
  198. package/dist/types/InputBase/index.d.ts +2 -0
  199. package/dist/types/Radio/Radio.d.ts +5 -3
  200. package/dist/types/RadioGroup/RadioGroup.d.ts +4 -2
  201. package/dist/types/RadioGroup/radioGroupContext.d.ts +6 -2
  202. package/dist/types/ScrollArea/ScrollArea.d.ts +28 -0
  203. package/dist/types/ScrollArea/index.d.ts +2 -0
  204. package/dist/types/Switch/Switch.d.ts +4 -3
  205. package/dist/types/Tab/Tab.d.ts +7 -0
  206. package/dist/types/TableCell/TableCell.d.ts +6 -0
  207. package/dist/types/TextField/TextField.d.ts +11 -0
  208. package/dist/types/TextField/textFieldClasses.d.ts +4 -0
  209. package/dist/types/Tooltip/Tooltip.d.ts +20 -0
  210. package/dist/types/index.d.ts +2 -0
  211. package/dist/types/internal/glyphs.d.ts +1 -0
  212. package/dist/types/internal/hues.d.ts +10 -0
  213. package/dist/types/internal/inputEvent.d.ts +13 -0
  214. package/dist/types/internal/releaseInfo.d.ts +1 -1
  215. package/dist/types/mui/index.d.ts +2 -0
  216. package/dist/types/mui/themeValues.d.ts +106 -0
  217. package/dist/types/parts/Breadcrumb.d.ts +24 -0
  218. package/dist/types/parts/Combobox.d.ts +88 -0
  219. package/dist/types/parts/ContextMenu.d.ts +2 -2
  220. package/dist/types/parts/Menu.d.ts +44 -0
  221. package/dist/types/parts/Select.d.ts +72 -0
  222. package/dist/types/parts/Toast.d.ts +46 -0
  223. package/dist/types/parts/Toolbar.d.ts +47 -0
  224. package/dist/types/parts/Tooltip.d.ts +6 -0
  225. package/dist/types/parts/index.d.ts +95 -4
  226. package/package.json +13 -2
package/agent/caligo.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "$comment": "Generated by scripts/agent-docs.mjs. Do not edit; change the TypeScript source, agent/guidance/ or docs/ instead.",
3
3
  "formatVersion": 1,
4
4
  "package": "@caligo-ui/core",
5
- "version": "1.0.0",
5
+ "version": "1.2.0",
6
6
  "setup": {
7
7
  "install": "npm install @caligo-ui/core @base-ui/react react react-dom",
8
8
  "styles": "import '@caligo-ui/core/styles.css';",
@@ -198,6 +198,11 @@
198
198
  "InputAdornmentClasses",
199
199
  "InputAdornmentOwnProps",
200
200
  "InputAdornmentProps",
201
+ "InputBase",
202
+ "InputBaseClassKey",
203
+ "InputBaseClasses",
204
+ "InputBaseOwnProps",
205
+ "InputBaseProps",
201
206
  "InputGroup",
202
207
  "InputGroupProps",
203
208
  "LICENSE_CODES",
@@ -300,6 +305,8 @@
300
305
  "RadioPropsColorOverrides",
301
306
  "RadioPropsSizeOverrides",
302
307
  "ScrollAlign",
308
+ "ScrollArea",
309
+ "ScrollAreaProps",
303
310
  "Select",
304
311
  "SelectChangeEvent",
305
312
  "SelectClassKey",
@@ -475,6 +482,7 @@
475
482
  "getIconButtonUtilityClass",
476
483
  "getIconUtilityClass",
477
484
  "getInputAdornmentUtilityClass",
485
+ "getInputBaseUtilityClass",
478
486
  "getLinearProgressUtilityClass",
479
487
  "getLinkUtilityClass",
480
488
  "getListItemIconUtilityClass",
@@ -506,6 +514,7 @@
506
514
  "iconClasses",
507
515
  "icons",
508
516
  "inputAdornmentClasses",
517
+ "inputBaseClasses",
509
518
  "linearProgressClasses",
510
519
  "linkClasses",
511
520
  "listItemIconClasses",
@@ -1279,6 +1288,10 @@
1279
1288
  "PieSeriesType",
1280
1289
  "PieValueType",
1281
1290
  "PlacedEvent",
1291
+ "PlanUsage",
1292
+ "PlanUsageCard",
1293
+ "PlanUsageCardClasses",
1294
+ "PlanUsageCardProps",
1282
1295
  "Pricing",
1283
1296
  "PricingClasses",
1284
1297
  "PricingPlan",
@@ -1300,6 +1313,12 @@
1300
1313
  "ProductOptionValue",
1301
1314
  "ProgressSteps",
1302
1315
  "ProgressStepsProps",
1316
+ "ProjectCard",
1317
+ "ProjectCardClasses",
1318
+ "ProjectCardProps",
1319
+ "ProjectGrid",
1320
+ "ProjectGridClasses",
1321
+ "ProjectGridProps",
1303
1322
  "PromptSuggestion",
1304
1323
  "PromptSuggestions",
1305
1324
  "PromptSuggestionsClasses",
@@ -1394,8 +1413,6 @@
1394
1413
  "SchedulerSlotProps",
1395
1414
  "SchedulerToolbarSlotProps",
1396
1415
  "SchedulerView",
1397
- "ScrollArea",
1398
- "ScrollAreaProps",
1399
1416
  "SearchField",
1400
1417
  "SearchFieldProps",
1401
1418
  "SearchPanel",
@@ -1859,11 +1876,14 @@
1859
1876
  "getPasswordStrengthUtilityClass",
1860
1877
  "getPaymentCardUtilityClass",
1861
1878
  "getPhoneFieldUtilityClass",
1879
+ "getPlanUsageCardUtilityClass",
1862
1880
  "getPricingPlanUtilityClass",
1863
1881
  "getPricingUtilityClass",
1864
1882
  "getProductCardUtilityClass",
1865
1883
  "getProductDetailUtilityClass",
1866
1884
  "getProductGridUtilityClass",
1885
+ "getProjectCardUtilityClass",
1886
+ "getProjectGridUtilityClass",
1867
1887
  "getPromptSuggestionsUtilityClass",
1868
1888
  "getPullToRefreshUtilityClass",
1869
1889
  "getQueryBuilderUtilityClass",
@@ -1964,11 +1984,14 @@
1964
1984
  "phoneCountries",
1965
1985
  "phoneFieldClasses",
1966
1986
  "placeLayoutItem",
1987
+ "planUsageCardClasses",
1967
1988
  "pricingClasses",
1968
1989
  "pricingPlanClasses",
1969
1990
  "productCardClasses",
1970
1991
  "productDetailClasses",
1971
1992
  "productGridClasses",
1993
+ "projectCardClasses",
1994
+ "projectGridClasses",
1972
1995
  "promptSuggestionsClasses",
1973
1996
  "publicEvent",
1974
1997
  "pullToRefreshClasses",
@@ -2990,8 +3013,8 @@
2990
3013
  },
2991
3014
  {
2992
3015
  "name": "color",
2993
- "type": "Severity",
2994
- "description": "Overrides the color that `severity` sets."
3016
+ "type": "Severity | 'neutral' | 'primary'",
3017
+ "description": "Overrides the color that `severity` sets. Caligo extras: `neutral`, a grey note with no status, and `primary`, the theme's accent, for an announcement. The icon and role still follow `severity`."
2995
3018
  },
2996
3019
  {
2997
3020
  "name": "icon",
@@ -4602,7 +4625,7 @@
4602
4625
  {
4603
4626
  "name": "Avatar",
4604
4627
  "category": "Data display",
4605
- "summary": "A picture, initials or icon for a person. Follows Material UI's `Avatar` API: if the image fails, it falls back to the children, then the first letter of `alt`, then a person icon.",
4628
+ "summary": "A picture, initials or icon for a person. Follows Material UI's `Avatar` API: if the image fails, it falls back to the children, then the initials of `alt`, then a person icon.",
4606
4629
  "package": "@caligo-ui/core",
4607
4630
  "import": "import { Avatar } from '@caligo-ui/core';",
4608
4631
  "keywords": [
@@ -4634,7 +4657,7 @@
4634
4657
  {
4635
4658
  "name": "alt",
4636
4659
  "type": "string",
4637
- "description": "The image's alt text, and the fallback letter when it fails."
4660
+ "description": "The image's alt text, and the initials when it fails or there is none: the first letters of the first and last words (\"Ada Lovelace\" shows AL)."
4638
4661
  },
4639
4662
  {
4640
4663
  "name": "children",
@@ -4646,12 +4669,23 @@
4646
4669
  "type": "Partial<AvatarClasses>",
4647
4670
  "description": "Extra class names for the root and inner parts, keyed by part. The keys are listed in the component's `…Classes` export."
4648
4671
  },
4672
+ {
4673
+ "name": "color",
4674
+ "type": "'default' | 'primary' | 'neutral' | 'success' | 'warning' | 'error' | 'info'",
4675
+ "default": "'default'",
4676
+ "description": "Caligo extra: the tint behind initials or an icon, from the theme's soft colours, so a list of people or workspaces can be told apart at a glance. Ignored while an image shows."
4677
+ },
4649
4678
  {
4650
4679
  "name": "component",
4651
4680
  "type": "React.ElementType",
4652
4681
  "default": "'div'",
4653
4682
  "description": "The element or component to render as the root."
4654
4683
  },
4684
+ {
4685
+ "name": "hue",
4686
+ "type": "CaligoHue | 'auto'",
4687
+ "description": "Caligo extra: a hue from the label palette behind initials or an icon (`red` to `pink`, as on Chip), or `auto` for a stable hue picked from `alt`, so the same name always gets the same colour. Takes the place of `color`. Ignored while an image shows."
4688
+ },
4655
4689
  {
4656
4690
  "name": "size",
4657
4691
  "type": "'xsmall' | 'small' | 'medium' | 'large' | 'xlarge'",
@@ -4666,7 +4700,7 @@
4666
4700
  {
4667
4701
  "name": "src",
4668
4702
  "type": "string",
4669
- "description": "The image URL. If it fails to load, the avatar falls back to `children`, then the first letter of `alt`, then a person icon."
4703
+ "description": "The image URL. If it fails to load, the avatar falls back to `children`, then the initials of `alt`, then a person icon."
4670
4704
  },
4671
4705
  {
4672
4706
  "name": "srcSet",
@@ -5187,9 +5221,9 @@
5187
5221
  },
5188
5222
  {
5189
5223
  "name": "color",
5190
- "type": "'info' | 'success' | 'warning' | 'error'",
5224
+ "type": "'info' | 'success' | 'warning' | 'error' | 'neutral' | 'primary'",
5191
5225
  "default": "'info'",
5192
- "description": "The message's tone. `error` also gives the banner `role=\"alert\"`, so screen readers announce it at once; the others get `role=\"status\"`."
5226
+ "description": "The message's tone: a status, `neutral` (a grey note) or `primary` (the theme's accent, for an announcement). `error` also gives the banner `role=\"alert\"`, so screen readers announce it at once; the others get `role=\"status\"`."
5193
5227
  },
5194
5228
  {
5195
5229
  "name": "onClose",
@@ -6385,12 +6419,14 @@
6385
6419
  "Write labels that say what happens, in sentence case: \"Save changes\", \"Delete project\", not \"OK\".",
6386
6420
  "Set `loading` while the action runs: it shows a spinner and disables the button. `color=\"error\"` marks destructive actions.",
6387
6421
  "Add icons with `startIcon` or `endIcon`, such as `<Icon name=\"plus\" />`. Heights by `size`: xsmall 28, small 32, medium 40, large 48px.",
6388
- "`href` renders a real link styled as a button, for navigation."
6422
+ "`href` renders a real link styled as a button, for navigation.",
6423
+ "`variant=\"pill\"` with an arrow `endIcon` is for links that take you somewhere, such as \"All case studies\": an outlined pill that fills on hover, the arrow in a disc that leans forward. `color=\"inherit\"` gives the neutral ink look."
6389
6424
  ],
6390
6425
  "avoid": [
6391
6426
  "Two contained buttons side by side. One main action per view.",
6392
6427
  "A raw <button> or a clickable <div>: use Button, or IconButton for icon-only actions.",
6393
- "Disabling the button and the form with no word on why. Say what is missing in the field's `helperText`."
6428
+ "Disabling the button and the form with no word on why. Say what is missing in the field's `helperText`.",
6429
+ "`variant=\"pill\"` for actions that change data, such as Save or Delete: it reads as navigation. Use `contained` or `outlined`."
6394
6430
  ],
6395
6431
  "related": [
6396
6432
  "IconButton",
@@ -6473,6 +6509,11 @@
6473
6509
  "default": "'center'",
6474
6510
  "description": "Where the spinner shows while `loading`: in place of `startIcon`, in place of `endIcon`, or over the label."
6475
6511
  },
6512
+ {
6513
+ "name": "nativeButton",
6514
+ "type": "boolean",
6515
+ "description": "Whether the rendered element is a native `<button>`. Inferred from `component` (a native button only when there is none); set it when `component` itself renders a `<button>`, such as a dialog's close part or a trigger, so Base UI keeps native semantics instead of adding `role=\"button\"`."
6516
+ },
6476
6517
  {
6477
6518
  "name": "size",
6478
6519
  "type": "OverridableStringUnion<'xsmall' | 'small' | 'medium' | 'large', ButtonPropsSizeOverrides>",
@@ -6486,9 +6527,9 @@
6486
6527
  },
6487
6528
  {
6488
6529
  "name": "variant",
6489
- "type": "OverridableStringUnion<'text' | 'outlined' | 'contained' | 'gradient' | 'link', ButtonPropsVariantOverrides>",
6530
+ "type": "OverridableStringUnion<'text' | 'outlined' | 'contained' | 'gradient' | 'link' | 'pill', ButtonPropsVariantOverrides>",
6490
6531
  "default": "'text'",
6491
- "description": "Material UI's variants, plus Caligo's `gradient` and `link`."
6532
+ "description": "Material UI's variants, plus Caligo's `gradient`, `link` and `pill`. `pill` is an outlined pill that fills on hover, with `endIcon` in a filled disc that leans forward: for links that take you somewhere."
6492
6533
  },
6493
6534
  {
6494
6535
  "name": "target",
@@ -9022,6 +9063,11 @@
9022
9063
  "type": "React.ElementType",
9023
9064
  "description": "The root element. Defaults to `div`, or a button when clickable."
9024
9065
  },
9066
+ {
9067
+ "name": "hue",
9068
+ "type": "CaligoHue",
9069
+ "description": "Caligo extra: a hue from the label palette (`red`, `orange`, `amber`, `yellow`, `green`, `emerald`, `teal`, `cyan`, `blue`, `indigo`, `purple`, `pink`), for labels that need telling apart rather than a meaning. Takes the place of `color` in every variant."
9070
+ },
9025
9071
  {
9026
9072
  "name": "deleteIcon",
9027
9073
  "type": "React.ReactElement",
@@ -9583,7 +9629,7 @@
9583
9629
  {
9584
9630
  "name": "ColorSwatch",
9585
9631
  "category": "Inputs",
9586
- "summary": "A clickable color sample. Caligo extra.",
9632
+ "summary": "A clickable color sample, or with `decorative` a plain one. Caligo extra.",
9587
9633
  "package": "@caligo-ui/pro",
9588
9634
  "import": "import { ColorSwatch } from '@caligo-ui/pro';",
9589
9635
  "paid": true,
@@ -9624,6 +9670,11 @@
9624
9670
  "required": true,
9625
9671
  "description": "Any CSS color."
9626
9672
  },
9673
+ {
9674
+ "name": "decorative",
9675
+ "type": "boolean",
9676
+ "description": "A colour sample that isn't a control, such as the dot beside a label's name: a span hidden from assistive tech, with no pointer or focus. The text beside it names it."
9677
+ },
9627
9678
  {
9628
9679
  "name": "label",
9629
9680
  "type": "string",
@@ -9642,9 +9693,9 @@
9642
9693
  },
9643
9694
  {
9644
9695
  "name": "size",
9645
- "type": "'small' | 'medium' | 'large'",
9696
+ "type": "'xsmall' | 'small' | 'medium' | 'large'",
9646
9697
  "default": "'medium'",
9647
- "description": "Width and height: small 16px, medium 24px, large 32px."
9698
+ "description": "Width and height: xsmall 10px, small 16px, medium 24px, large 32px."
9648
9699
  }
9649
9700
  ],
9650
9701
  "deprecatedProps": [],
@@ -14389,7 +14440,7 @@
14389
14440
  "name": "maxWidth",
14390
14441
  "type": "'xs' | 'sm' | 'md' | 'lg' | 'xl' | false",
14391
14442
  "default": "'sm'",
14392
- "description": "Material UI's widths: xs 444px, sm 600px, md 900px, lg 1200px, xl 1536px. `false` removes the limit."
14443
+ "description": "Material UI's widths: xs 444px, sm 600px, md 900px, lg 1200px, xl 1536px. `false` removes the limit. Each is a token (`--cal-dialog-width-xs` to `--cal-dialog-width-xl`), so an app can change the ladder."
14393
14444
  },
14394
14445
  {
14395
14446
  "name": "onClose",
@@ -18538,6 +18589,11 @@
18538
18589
  "type": "'start' | 'end' | false",
18539
18590
  "description": "Pulls the button out by its padding to line up with the edge of its container."
18540
18591
  },
18592
+ {
18593
+ "name": "selected",
18594
+ "type": "boolean",
18595
+ "description": "Caligo extra: a toggle that is on (a favourite star, a filter, a panel toggle). Sets `aria-pressed` and the `Caligo-selected` class, and a quiet icon button rises to the raised key look while it is on. Leave it out for a plain button: `false` still marks the button as a toggle (`aria-pressed=\"false\"`)."
18596
+ },
18541
18597
  {
18542
18598
  "name": "shape",
18543
18599
  "type": "'rounded' | 'circular'",
@@ -18620,6 +18676,151 @@
18620
18676
  "Omit<React.HTMLAttributes<HTMLDivElement>, keyof InputAdornmentOwnProps>"
18621
18677
  ]
18622
18678
  },
18679
+ {
18680
+ "name": "InputBase",
18681
+ "category": "Inputs",
18682
+ "summary": "A field's box on its own, as Material UI's `InputBase`: Caligo's field look (variant, size, focus, error, disabled) around a bare input, adornments, or your own children. TextField is this box with a label and helper text; use InputBase to build a field TextField doesn't cover, such as a search box with chips or a picker trigger. Focus shows when anything inside it has focus. Give the input a name with `inputProps['aria-label']` or a label.",
18683
+ "package": "@caligo-ui/core",
18684
+ "import": "import { InputBase } from '@caligo-ui/core';",
18685
+ "keywords": [
18686
+ "input base",
18687
+ "field box",
18688
+ "bare input",
18689
+ "input group",
18690
+ "custom field",
18691
+ "picker trigger",
18692
+ "search box with chips",
18693
+ "input",
18694
+ "base"
18695
+ ],
18696
+ "use": [
18697
+ "Build a field TextField doesn't cover: a search box holding chips and a clear button, or a picker's trigger (`component=\"button\"`).",
18698
+ "Put your own content in `children`, or use the built-in input with `startAdornment` and `endAdornment`.",
18699
+ "Name the input: `inputProps={{ 'aria-label': '…' }}`, or a FormLabel tied to it."
18700
+ ],
18701
+ "avoid": [
18702
+ "A plain labelled field: use TextField, which adds the label, helper text and error wiring.",
18703
+ "Nesting interactive controls inside `component=\"button\"`: the box is the one control then."
18704
+ ],
18705
+ "related": [
18706
+ "TextField",
18707
+ "InputAdornment",
18708
+ "SearchField",
18709
+ "Select"
18710
+ ],
18711
+ "example": "import { Chip, Icon, InputAdornment, InputBase } from '@caligo-ui/core';\n\nexport default function Example() {\n return (\n <InputBase\n fullWidth\n placeholder=\"Filter by label\"\n inputProps={{ 'aria-label': 'Filter by label' }}\n startAdornment={<InputAdornment position=\"start\"><Icon name=\"search\" /></InputAdornment>}\n endAdornment={<Chip size=\"small\" label=\"bug\" onDelete={() => {}} />}\n />\n );\n}\n",
18712
+ "guided": true,
18713
+ "props": [
18714
+ {
18715
+ "name": "children",
18716
+ "type": "React.ReactNode",
18717
+ "description": "Your own content in place of the built-in input: icons, chips, a bare `<input>`, a clear button."
18718
+ },
18719
+ {
18720
+ "name": "classes",
18721
+ "type": "Partial<InputBaseClasses>",
18722
+ "description": "Extra class names for the root and inner parts, keyed by part. The keys are listed in the component's `…Classes` export."
18723
+ },
18724
+ {
18725
+ "name": "component",
18726
+ "type": "React.ElementType",
18727
+ "default": "'div'",
18728
+ "description": "The box's element. A `button` makes the whole box one control, such as the trigger of a picker you build yourself."
18729
+ },
18730
+ {
18731
+ "name": "startAdornment",
18732
+ "type": "React.ReactNode",
18733
+ "description": "Before the input, inside the box: usually an InputAdornment."
18734
+ },
18735
+ {
18736
+ "name": "endAdornment",
18737
+ "type": "React.ReactNode",
18738
+ "description": "After the input, inside the box."
18739
+ },
18740
+ {
18741
+ "name": "variant",
18742
+ "type": "'outlined' | 'filled' | 'standard' | 'ghost'",
18743
+ "default": "'outlined'",
18744
+ "description": "The box's look, as on TextField, or Caligo's `ghost`: no edge or fill until hover, for a property row of pickers (assignee, priority, due date) that reads as text until you point at it."
18745
+ },
18746
+ {
18747
+ "name": "size",
18748
+ "type": "'xsmall' | 'small' | 'medium' | 'large'",
18749
+ "default": "'medium'",
18750
+ "description": "The box's height, as on TextField."
18751
+ },
18752
+ {
18753
+ "name": "fullWidth",
18754
+ "type": "boolean",
18755
+ "description": "Takes the width of its container."
18756
+ },
18757
+ {
18758
+ "name": "error",
18759
+ "type": "boolean",
18760
+ "description": "Draws the box in the error colour and sets `aria-invalid` on the input."
18761
+ },
18762
+ {
18763
+ "name": "disabled",
18764
+ "type": "boolean",
18765
+ "description": "Greys the box and disables the input."
18766
+ },
18767
+ {
18768
+ "name": "inputProps",
18769
+ "type": "React.InputHTMLAttributes<HTMLInputElement>",
18770
+ "description": "Props for the built-in input."
18771
+ },
18772
+ {
18773
+ "name": "inputRef",
18774
+ "type": "React.Ref<HTMLInputElement>",
18775
+ "description": "A ref to the built-in input."
18776
+ },
18777
+ {
18778
+ "name": "value",
18779
+ "type": "string | number",
18780
+ "description": "The built-in input's value, as on an `<input>`."
18781
+ },
18782
+ {
18783
+ "name": "defaultValue",
18784
+ "type": "string | number",
18785
+ "description": "The built-in input's starting value."
18786
+ },
18787
+ {
18788
+ "name": "onChange",
18789
+ "type": "React.ChangeEventHandler<HTMLInputElement>",
18790
+ "description": "Called when the built-in input's value changes."
18791
+ },
18792
+ {
18793
+ "name": "placeholder",
18794
+ "type": "string",
18795
+ "description": "The built-in input's placeholder."
18796
+ },
18797
+ {
18798
+ "name": "type",
18799
+ "type": "string",
18800
+ "default": "'text'",
18801
+ "description": "The built-in input's type."
18802
+ },
18803
+ {
18804
+ "name": "name",
18805
+ "type": "string",
18806
+ "description": "The built-in input's name."
18807
+ },
18808
+ {
18809
+ "name": "readOnly",
18810
+ "type": "boolean",
18811
+ "description": "Makes the built-in input read-only."
18812
+ },
18813
+ {
18814
+ "name": "required",
18815
+ "type": "boolean",
18816
+ "description": "Marks the built-in input as required."
18817
+ }
18818
+ ],
18819
+ "deprecatedProps": [],
18820
+ "inherits": [
18821
+ "Omit<React.HTMLAttributes<HTMLElement>, keyof InputBaseOwnProps | 'onChange'>"
18822
+ ]
18823
+ },
18623
18824
  {
18624
18825
  "name": "InputGroup",
18625
18826
  "category": "Inputs",
@@ -22206,7 +22407,8 @@
22206
22407
  "An editor for animation over time: a row (`tracks`) per thing that moves, each with `clips` that have a `start` and `duration` in seconds. Keep the clips in your state and apply `onClipChange`.",
22207
22408
  "Linking: a clip with `followsId` starts when that clip ends. Dropping a clip onto another clip's end reports `follows: { clipId, gap: 0 }`; moving it later keeps the link with a gap; `follows: null` means it now has its own start. Work out `start` for linked clips yourself and pass it back.",
22208
22409
  "`time` and `onTimeChange` are the playhead (the ruler scrubs it); `markers` are named moments; `onClipAdd` with `addOptions` gives each row a menu of clip kinds (an option's `hint` can name the plan it needs; keep such options clickable and explain the lock in your `onClipAdd`, rather than `disabled`, which says nothing); `onClipDuplicate` and `onClipDelete` for Control and D and Delete.",
22209
- "Set `maxHeight` when there can be many rows, so the ruler and row names stay in view. `zoom`/`onZoomChange` (or Control and the wheel) zoom in; the view always fits clips that run past `duration` and shades the time after it."
22410
+ "Set `maxHeight` when there can be many rows, so the ruler and row names stay in view. `zoom`/`onZoomChange` (or Control and the wheel) zoom in; the view always fits clips that run past `duration` and shades the time after it.",
22411
+ "Keyframes: each track's `keyframes` (seconds) are drawn as diamonds. Pass `onKeyframeChange(trackId, from, to)` to let people drag them (snapping like clips) or move them with Alt and the arrows, and `onKeyframeDelete` for Delete; move them in your own state. Without it they are only markers, and a click goes to one."
22210
22412
  ],
22211
22413
  "avoid": [
22212
22414
  "Dates and project plans: use GanttChart.",
@@ -22306,6 +22508,16 @@
22306
22508
  "type": "(trackId: string, clipId: string) => void",
22307
22509
  "description": "Control (or Command) and D on a clip."
22308
22510
  },
22511
+ {
22512
+ "name": "onKeyframeChange",
22513
+ "type": "(trackId: string, from: number, to: number) => void",
22514
+ "description": "A keyframe was dragged, or moved with Alt and the arrow keys, from one time to another (seconds). Move it in `tracks` yourself. Without it keyframes are only drawn, and clicking one moves the playhead there."
22515
+ },
22516
+ {
22517
+ "name": "onKeyframeDelete",
22518
+ "type": "(trackId: string, time: number) => void",
22519
+ "description": "Delete or Backspace on a focused keyframe."
22520
+ },
22309
22521
  {
22310
22522
  "name": "zoom",
22311
22523
  "type": "number",
@@ -23639,7 +23851,7 @@
23639
23851
  "background"
23640
23852
  ],
23641
23853
  "use": [
23642
- "A plain surface on `surface-primary`, for grouping content that is not a Card: a sidebar panel, a toolbar, a form area.",
23854
+ "A plain surface on `--cal-surface-card` (a smidge toward the page, so fields and buttons on it stand out), for grouping content that is not a Card: a sidebar panel, a toolbar, a form area.",
23643
23855
  "`elevation` (0 to 24, default 1) maps onto Caligo's five shadows. `variant=\"outlined\"` swaps the shadow for a border.",
23644
23856
  "`square` removes the rounded corners. `component` changes the element, such as \"section\".",
23645
23857
  "Pad its content with a Stack or a token, such as `style={{ padding: \"var(--cal-spacing-16)\" }}`."
@@ -24403,6 +24615,80 @@
24403
24615
  "Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'color'>"
24404
24616
  ]
24405
24617
  },
24618
+ {
24619
+ "name": "PlanUsageCard",
24620
+ "category": "Data display",
24621
+ "summary": "The plan at the bottom of an app's sidebar, as SaaS apps show it: the plan's name, how much of each limit is used, a note once a limit is reached, and an Upgrade action.",
24622
+ "package": "@caligo-ui/pro",
24623
+ "import": "import { PlanUsageCard } from '@caligo-ui/pro';",
24624
+ "paid": true,
24625
+ "keywords": [
24626
+ "plan",
24627
+ "usage",
24628
+ "quota",
24629
+ "limit",
24630
+ "upgrade",
24631
+ "billing",
24632
+ "subscription",
24633
+ "sidebar footer",
24634
+ "seats",
24635
+ "card"
24636
+ ],
24637
+ "use": [
24638
+ "The plan at the bottom of an app's sidebar: `plan` (\"Free plan\"), `usage` rows ({ label, value, max }) drawn as thin meters, and an Upgrade link or button in `action`.",
24639
+ "`max: null` shows a count without a bar, for plans with no limit. A row at its limit turns its bar to the warning colour.",
24640
+ "`limitNote` shows only once a limit is reached: say what to do (delete something, or upgrade), kindly. `detail` is a short line under the plan, such as the licence key's last characters."
24641
+ ],
24642
+ "avoid": [
24643
+ "A full billing page with invoices and payment methods: use BillingSection.",
24644
+ "Work in progress: use LinearProgress."
24645
+ ],
24646
+ "related": [
24647
+ "Meter",
24648
+ "BillingSection",
24649
+ "Sidebar",
24650
+ "Pricing"
24651
+ ],
24652
+ "example": "import { Button } from '@caligo-ui/core';\nimport { PlanUsageCard } from '@caligo-ui/pro';\n\nexport default function Example() {\n return (\n <div style={{ width: 240 }}>\n <PlanUsageCard\n plan=\"Free plan\"\n usage={[{ label: 'Projects', value: 3, max: 3 }]}\n limitNote=\"Free keeps 3 projects. Delete one to make room, or upgrade for as many as you like.\"\n action={<Button size=\"small\" href=\"/pricing\">Upgrade</Button>}\n />\n </div>\n );\n}\n",
24653
+ "guided": true,
24654
+ "props": [
24655
+ {
24656
+ "name": "action",
24657
+ "type": "React.ReactNode",
24658
+ "description": "An Upgrade button or link, or the control that opens the plan's details."
24659
+ },
24660
+ {
24661
+ "name": "classes",
24662
+ "type": "Partial<PlanUsageCardClasses>",
24663
+ "description": "Extra class names for the root and inner parts, keyed by part. The keys are listed in the component's `…Classes` export."
24664
+ },
24665
+ {
24666
+ "name": "detail",
24667
+ "type": "React.ReactNode",
24668
+ "description": "A short line under the plan, such as the licence key's last characters or the renewal date."
24669
+ },
24670
+ {
24671
+ "name": "limitNote",
24672
+ "type": "React.ReactNode",
24673
+ "description": "Shown under the meters when a limit is reached: what to do about it, said kindly. Left out, nothing is shown."
24674
+ },
24675
+ {
24676
+ "name": "plan",
24677
+ "type": "React.ReactNode",
24678
+ "required": true,
24679
+ "description": "The plan's name, such as \"Free plan\". Required."
24680
+ },
24681
+ {
24682
+ "name": "usage",
24683
+ "type": "PlanUsage[]",
24684
+ "description": "What the plan counts. A row at its limit turns its bar to the warning colour."
24685
+ }
24686
+ ],
24687
+ "deprecatedProps": [],
24688
+ "inherits": [
24689
+ "Omit<React.HTMLAttributes<HTMLDivElement>, 'title'>"
24690
+ ]
24691
+ },
24406
24692
  {
24407
24693
  "name": "Popover",
24408
24694
  "category": "Overlays",
@@ -25741,6 +26027,190 @@
25741
26027
  "Omit<StepperProps, 'children'>"
25742
26028
  ]
25743
26029
  },
26030
+ {
26031
+ "name": "ProjectCard",
26032
+ "category": "Data display",
26033
+ "summary": "One project on a home screen, the way design tools list files: a preview, the name, a line about it, and a menu. The whole card opens the project; the menu sits above it. Lay several out with ProjectGrid.",
26034
+ "package": "@caligo-ui/pro",
26035
+ "import": "import { ProjectCard } from '@caligo-ui/pro';",
26036
+ "paid": true,
26037
+ "keywords": [
26038
+ "project",
26039
+ "file",
26040
+ "document",
26041
+ "home",
26042
+ "dashboard",
26043
+ "recent files",
26044
+ "thumbnail",
26045
+ "card grid",
26046
+ "workspace",
26047
+ "card"
26048
+ ],
26049
+ "use": [
26050
+ "One project on a home screen, as design tools list files: `title`, a preview `image` (or your own `media`), and a `meta` line such as \"Scene · 9:16 · 2 days ago\".",
26051
+ "Use `onOpen` to open the project in the app; the whole card becomes one button named by the title. Add `href` too when the project has its own address, so Ctrl/⌘-click and middle-click open it elsewhere.",
26052
+ "Put a Menu button with Rename, Duplicate and Delete in `actions`: it sits above the card's button, so using it never opens the project. Label the button with the project's name (\"More for Plotline\").",
26053
+ "`mediaRatio` sets the preview box's shape (default 4 / 3); previews of any shape fit inside it whole. `badges` puts small Chips over its corner, such as \"Sample\".",
26054
+ "Set `selected` on the project that is open; it is announced as the current one.",
26055
+ "Lay several out with ProjectGrid."
26056
+ ],
26057
+ "avoid": [
26058
+ "Products for sale: use ProductCard. Files someone attached: use Attachment. Something an assistant made: use ArtifactCard.",
26059
+ "Putting a second button or link inside `title` or `meta`: the card already is one. Use `actions`."
26060
+ ],
26061
+ "related": [
26062
+ "ProjectGrid",
26063
+ "Menu",
26064
+ "Chip",
26065
+ "EmptyState",
26066
+ "ArtifactCard"
26067
+ ],
26068
+ "example": "import * as React from 'react';\nimport { IconButton } from '@caligo-ui/core';\nimport { ProjectCard } from '@caligo-ui/pro';\n\nexport default function Example() {\n return (\n <div style={{ width: 240 }}>\n <ProjectCard\n title=\"Plotline\"\n meta=\"Scene · 9:16 · 2 days ago\"\n image=\"https://picsum.photos/seed/plotline/270/480\"\n mediaRatio=\"4 / 3\"\n onOpen={() => console.log('open Plotline')}\n actions={<IconButton size=\"small\" aria-label=\"More for Plotline\">⋯</IconButton>}\n />\n </div>\n );\n}\n",
26069
+ "guided": true,
26070
+ "props": [
26071
+ {
26072
+ "name": "actions",
26073
+ "type": "React.ReactNode",
26074
+ "description": "A menu button (rename, duplicate, delete) or two. It sits above the card's button, so clicking it never opens the project."
26075
+ },
26076
+ {
26077
+ "name": "badges",
26078
+ "type": "React.ReactNode",
26079
+ "description": "Small labels over the corner of the preview, such as a Chip saying \"Sample\"."
26080
+ },
26081
+ {
26082
+ "name": "classes",
26083
+ "type": "Partial<ProjectCardClasses>",
26084
+ "description": "Extra class names for the root and inner parts, keyed by part. The keys are listed in the component's `…Classes` export."
26085
+ },
26086
+ {
26087
+ "name": "component",
26088
+ "type": "React.ElementType",
26089
+ "default": "'div'",
26090
+ "description": "The element or component to render as the root."
26091
+ },
26092
+ {
26093
+ "name": "href",
26094
+ "type": "string",
26095
+ "description": "Opens the project elsewhere. The title becomes a link that stretches over the card. With `onOpen` too, a plain click calls `onOpen`, and `href` serves middle-click, Ctrl/⌘-click and \"Copy link\"."
26096
+ },
26097
+ {
26098
+ "name": "image",
26099
+ "type": "string",
26100
+ "description": "The preview's address. If it fails to load, `placeholder` shows instead. The image is decorative: the title names the card."
26101
+ },
26102
+ {
26103
+ "name": "media",
26104
+ "type": "React.ReactNode",
26105
+ "description": "Your own preview (a canvas, a video) in place of `image`."
26106
+ },
26107
+ {
26108
+ "name": "mediaRatio",
26109
+ "type": "string",
26110
+ "default": "'4 / 3'",
26111
+ "description": "The preview box's shape, as CSS `aspect-ratio`. Previews of any shape fit inside it whole."
26112
+ },
26113
+ {
26114
+ "name": "meta",
26115
+ "type": "React.ReactNode",
26116
+ "description": "A line under the title, such as \"Scene · 9:16 · 2 days ago\"."
26117
+ },
26118
+ {
26119
+ "name": "onOpen",
26120
+ "type": "(event: React.MouseEvent<HTMLElement>) => void",
26121
+ "description": "Opens the project in the app. The whole card becomes the button."
26122
+ },
26123
+ {
26124
+ "name": "placeholder",
26125
+ "type": "React.ReactNode",
26126
+ "default": "a picture outline",
26127
+ "description": "Shown when there is no `image` or `media`, or the image failed."
26128
+ },
26129
+ {
26130
+ "name": "selected",
26131
+ "type": "boolean",
26132
+ "description": "Marks the card as the chosen one, for example the project that is open."
26133
+ },
26134
+ {
26135
+ "name": "title",
26136
+ "type": "React.ReactNode",
26137
+ "required": true,
26138
+ "description": "The project's name. It becomes the button or link when `onOpen` or `href` is set. A long one ends in an ellipsis and shows whole on hover. Required."
26139
+ }
26140
+ ],
26141
+ "deprecatedProps": [],
26142
+ "inherits": [
26143
+ "Omit<React.HTMLAttributes<HTMLElement>, 'title'>"
26144
+ ]
26145
+ },
26146
+ {
26147
+ "name": "ProjectGrid",
26148
+ "category": "Layout",
26149
+ "summary": "Lays out ProjectCards in as many columns as fit, as a list (screen readers say how many there are). Shows `empty` when there are none.",
26150
+ "package": "@caligo-ui/pro",
26151
+ "import": "import { ProjectGrid } from '@caligo-ui/pro';",
26152
+ "paid": true,
26153
+ "keywords": [
26154
+ "project grid",
26155
+ "card grid",
26156
+ "file grid",
26157
+ "home screen",
26158
+ "gallery",
26159
+ "responsive grid",
26160
+ "dashboard",
26161
+ "project",
26162
+ "grid"
26163
+ ],
26164
+ "use": [
26165
+ "A home screen's projects: ProjectCards in as many columns as fit at `minItemWidth` (default 220 px), stretched to fill each row, `gap` apart (default 16 px).",
26166
+ "It is a list: give it an `aria-label` such as \"Projects\", and screen readers say how many there are. Each child becomes an item.",
26167
+ "Pass `empty` (usually an EmptyState) for when there are no cards, such as a search that matches nothing."
26168
+ ],
26169
+ "avoid": [
26170
+ "Thousands of items: use VirtualGrid. Arbitrary page layout: use Grid or DashboardGrid."
26171
+ ],
26172
+ "related": [
26173
+ "ProjectCard",
26174
+ "EmptyState",
26175
+ "VirtualGrid",
26176
+ "Grid"
26177
+ ],
26178
+ "example": "import * as React from 'react';\nimport { EmptyState, ProjectCard, ProjectGrid } from '@caligo-ui/pro';\n\nconst projects = [\n { id: 'plotline', name: 'Plotline', meta: 'Scene · 9:16 · today' },\n { id: 'tally', name: 'Tally', meta: 'Scene · 16:9 · 3 days ago' },\n];\n\nexport default function Example() {\n return (\n <ProjectGrid aria-label=\"Projects\" minItemWidth={200} empty={<EmptyState title=\"No projects yet\" />}>\n {projects.map((p) => (\n <ProjectCard key={p.id} title={p.name} meta={p.meta} onOpen={() => console.log('open', p.id)} />\n ))}\n </ProjectGrid>\n );\n}\n",
26179
+ "guided": true,
26180
+ "props": [
26181
+ {
26182
+ "name": "children",
26183
+ "type": "React.ReactNode",
26184
+ "description": "ProjectCards. Each one becomes an item of the list."
26185
+ },
26186
+ {
26187
+ "name": "classes",
26188
+ "type": "Partial<ProjectGridClasses>",
26189
+ "description": "Extra class names for the root and inner parts, keyed by part. The keys are listed in the component's `…Classes` export."
26190
+ },
26191
+ {
26192
+ "name": "empty",
26193
+ "type": "React.ReactNode",
26194
+ "description": "Shown in place of the grid when it has no cards, such as an EmptyState saying nothing matches the search."
26195
+ },
26196
+ {
26197
+ "name": "gap",
26198
+ "type": "number",
26199
+ "default": "16",
26200
+ "description": "Space between cards in pixels."
26201
+ },
26202
+ {
26203
+ "name": "minItemWidth",
26204
+ "type": "number",
26205
+ "default": "220",
26206
+ "description": "The narrowest a card gets, in pixels; the grid fits as many columns as it can and stretches them to fill the row."
26207
+ }
26208
+ ],
26209
+ "deprecatedProps": [],
26210
+ "inherits": [
26211
+ "React.HTMLAttributes<HTMLUListElement>"
26212
+ ]
26213
+ },
25744
26214
  {
25745
26215
  "name": "PromptSuggestions",
25746
26216
  "category": "AI and chat",
@@ -26527,7 +26997,7 @@
26527
26997
  {
26528
26998
  "name": "Radio",
26529
26999
  "category": "Inputs",
26530
- "summary": "A radio button. Follows Material UI's `Radio` API: a native radio input under a drawn circle, usually inside a RadioGroup. Label it with FormControlLabel.",
27000
+ "summary": "A radio button. Follows Material UI's `Radio` API and uses Base UI's `Radio` for behavior, as Checkbox and Switch do: the root is the control (`role=\"radio\"`), with a hidden input for forms. Inside a RadioGroup the group holds the value; on its own it is a group of one. `onChange(event, checked)` gets an event whose `target` is the hidden input. Label it with FormControlLabel, or `aria-label` through `slotProps.input`.",
26531
27001
  "package": "@caligo-ui/core",
26532
27002
  "import": "import { Radio } from '@caligo-ui/core';",
26533
27003
  "keywords": [
@@ -26648,7 +27118,7 @@
26648
27118
  {
26649
27119
  "name": "RadioGroup",
26650
27120
  "category": "Inputs",
26651
- "summary": "A set of Radios with one value. Follows Material UI's `RadioGroup` API: a FormGroup with `role=\"radiogroup\"`. Arrow keys move between options, as native radios do.",
27121
+ "summary": "A set of Radios with one value. Follows Material UI's `RadioGroup` API and uses Base UI's `RadioGroup` for behavior, as Checkbox and Switch use Base UI: a FormGroup with `role=\"radiogroup\"`, arrow keys move between options, and the chosen value goes with the form under `name`. `onChange(event, value)` gets an event whose `target` is the chosen radio's hidden input.",
26652
27122
  "package": "@caligo-ui/core",
26653
27123
  "import": "import { RadioGroup } from '@caligo-ui/core';",
26654
27124
  "keywords": [
@@ -26994,7 +27464,7 @@
26994
27464
  "Stack",
26995
27465
  "Divider"
26996
27466
  ],
26997
- "example": "import { useState } from 'react';\nimport { Typography } from '@caligo-ui/core';\nimport { Resizable, ScrollArea } from '@caligo-ui/pro';\n\nexport default function MailLayout() {\n const [width, setWidth] = useState(30);\n return (\n <Resizable value={width} onChange={(_, v) => setWidth(v)} min={20} max={60} handleLabel=\"Resize message list\">\n <ScrollArea aria-label=\"Messages\" height={320}>\n <Typography variant=\"body2\">Inbox · 24 messages</Typography>\n </ScrollArea>\n <Typography variant=\"body2\">Select a message to read it.</Typography>\n </Resizable>\n );\n}\n",
27467
+ "example": "import { useState } from 'react';\nimport { ScrollArea, Typography } from '@caligo-ui/core';\nimport { Resizable } from '@caligo-ui/pro';\n\nexport default function MailLayout() {\n const [width, setWidth] = useState(30);\n return (\n <Resizable value={width} onChange={(_, v) => setWidth(v)} min={20} max={60} handleLabel=\"Resize message list\">\n <ScrollArea aria-label=\"Messages\" height={320}>\n <Typography variant=\"body2\">Inbox · 24 messages</Typography>\n </ScrollArea>\n <Typography variant=\"body2\">Select a message to read it.</Typography>\n </Resizable>\n );\n}\n",
26998
27468
  "guided": true,
26999
27469
  "props": [
27000
27470
  {
@@ -27676,9 +28146,8 @@
27676
28146
  "name": "ScrollArea",
27677
28147
  "category": "Layout",
27678
28148
  "summary": "A box that scrolls with Caligo's thin scrollbar. Caligo's own component. It's focusable, so keyboard users can scroll it; give it an `aria-label` that names the content.",
27679
- "package": "@caligo-ui/pro",
27680
- "import": "import { ScrollArea } from '@caligo-ui/pro';",
27681
- "paid": true,
28149
+ "package": "@caligo-ui/core",
28150
+ "import": "import { ScrollArea } from '@caligo-ui/core';",
27682
28151
  "keywords": [
27683
28152
  "scroll area",
27684
28153
  "scrollable",
@@ -27704,7 +28173,7 @@
27704
28173
  "DataGrid",
27705
28174
  "Drawer"
27706
28175
  ],
27707
- "example": "import { List, ListItem, ListItemText } from '@caligo-ui/core';\nimport { ScrollArea } from '@caligo-ui/pro';\n\nconst releases = ['4.2.0 · Dark mode for charts', '4.1.3 · Faster table sorting', '4.1.2 · Fixed date picker focus', '4.1.0 · Kanban swimlanes', '4.0.0 · New theme tokens'];\n\nexport default function ReleaseNotes() {\n return (\n <ScrollArea aria-label=\"Release notes\" height={160}>\n <List dense>\n {releases.map((r) => (\n <ListItem key={r}>\n <ListItemText primary={r} />\n </ListItem>\n ))}\n </List>\n </ScrollArea>\n );\n}\n",
28176
+ "example": "import { List, ListItem, ListItemText, ScrollArea } from '@caligo-ui/core';\n\nconst releases = ['4.2.0 · Dark mode for charts', '4.1.3 · Faster table sorting', '4.1.2 · Fixed date picker focus', '4.1.0 · Kanban swimlanes', '4.0.0 · New theme tokens'];\n\nexport default function ReleaseNotes() {\n return (\n <ScrollArea aria-label=\"Release notes\" height={160}>\n <List dense>\n {releases.map((r) => (\n <ListItem key={r}>\n <ListItemText primary={r} />\n </ListItem>\n ))}\n </List>\n </ScrollArea>\n );\n}\n",
27708
28177
  "guided": true,
27709
28178
  "props": [
27710
28179
  {
@@ -27722,6 +28191,29 @@
27722
28191
  "name": "width",
27723
28192
  "type": "number | string",
27724
28193
  "description": "Box width. Any CSS length."
28194
+ },
28195
+ {
28196
+ "name": "variant",
28197
+ "type": "'outlined' | 'plain'",
28198
+ "default": "'outlined'",
28199
+ "description": "`outlined` is a bordered box; `plain` has no border or corners, for a pane that scrolls inside a layout (a sidebar, a settings page)."
28200
+ },
28201
+ {
28202
+ "name": "fill",
28203
+ "type": "boolean",
28204
+ "description": "Fills its parent's height (and shrinks inside a flex column), for a pane in a fixed-height layout."
28205
+ },
28206
+ {
28207
+ "name": "scrollbarSize",
28208
+ "type": "'small' | 'medium'",
28209
+ "default": "'small'",
28210
+ "description": "`small` is a thin scrollbar; `medium` the platform's."
28211
+ },
28212
+ {
28213
+ "name": "scrollbarVisibility",
28214
+ "type": "'auto' | 'hover' | 'always'",
28215
+ "default": "'auto'",
28216
+ "description": "`auto` shows the scrollbar when there's more to see; `hover` only while the pointer is over the area; `always` keeps the track."
27725
28217
  }
27726
28218
  ],
27727
28219
  "deprecatedProps": [
@@ -27737,7 +28229,7 @@
27737
28229
  {
27738
28230
  "name": "SearchField",
27739
28231
  "category": "Inputs",
27740
- "summary": "A search TextField with a search icon and an optional loading spinner. Caligo extra, built from TextField and InputAdornment. Give it a `label` or an `aria-label` through `slotProps.htmlInput`.",
28232
+ "summary": "A search TextField with a search icon and an optional loading spinner, and, with `collapsible`, a search icon that opens into it. Caligo extra, built from TextField and InputAdornment. Give it a `label` or an `aria-label` through `slotProps.htmlInput`.",
27741
28233
  "package": "@caligo-ui/pro",
27742
28234
  "import": "import { SearchField } from '@caligo-ui/pro';",
27743
28235
  "paid": true,
@@ -27772,6 +28264,31 @@
27772
28264
  "name": "loading",
27773
28265
  "type": "boolean",
27774
28266
  "description": "Shows a spinner while results load."
28267
+ },
28268
+ {
28269
+ "name": "collapsible",
28270
+ "type": "boolean",
28271
+ "description": "Starts as a search icon button that opens into the field, as in a list's header. The field takes focus when it opens, closes on Escape (which also clears it), and closes when it loses focus empty. Name it with `aria-label` through `slotProps.htmlInput`, or `label`; the button takes the same name."
28272
+ },
28273
+ {
28274
+ "name": "expanded",
28275
+ "type": "boolean",
28276
+ "description": "Whether a collapsible field is open, controlled. Pair it with `onExpandedChange`."
28277
+ },
28278
+ {
28279
+ "name": "defaultExpanded",
28280
+ "type": "boolean",
28281
+ "description": "Whether a collapsible field starts open. It also starts open when it has a value."
28282
+ },
28283
+ {
28284
+ "name": "onExpandedChange",
28285
+ "type": "(expanded: boolean) => void",
28286
+ "description": "Called when a collapsible field opens or closes."
28287
+ },
28288
+ {
28289
+ "name": "clearLabel",
28290
+ "type": "string",
28291
+ "description": "Shows a button that clears the text, while there is text. Its accessible name."
27775
28292
  }
27776
28293
  ],
27777
28294
  "deprecatedProps": [],
@@ -28261,7 +28778,8 @@
28261
28778
  "use": [
28262
28779
  "Compose it: `<Sidebar>` with SidebarHeader, SidebarContent (SidebarGroup with a `label`, holding SidebarItem rows) and SidebarFooter. SidebarItem takes `label`, `icon`, `href`, `selected`, `end` (a count) and nested SidebarItems as children.",
28263
28780
  "`collapsible=\"rail\"` (default) keeps a strip of icons with tooltips; `offcanvas` slides it away. `persistKey` remembers the state, and Ctrl/Cmd+B toggles it.",
28264
- "Below `mobileBreakpoint` it becomes a drawer opened by SidebarTrigger. Inside ApplicationPage the state is shared for you; elsewhere wrap both in SidebarProvider."
28781
+ "Below `mobileBreakpoint` it becomes a drawer opened by SidebarTrigger. Inside ApplicationPage the state is shared for you; elsewhere wrap both in SidebarProvider.",
28782
+ "To fit the space it gets: `railBreakpoint` collapses it to the icon rail (labels become tooltips) below that width, and `mobileBreakpoint` turns it into a drawer behind SidebarTrigger below a smaller one. The person can still expand the rail; that choice is not saved."
28265
28783
  ],
28266
28784
  "avoid": [
28267
28785
  "For a standard app nav from data, use DashboardSidebar.",
@@ -28294,6 +28812,11 @@
28294
28812
  "default": "'md'",
28295
28813
  "description": "Width below which the sidebar becomes a temporary Drawer. Material UI breakpoint or pixels."
28296
28814
  },
28815
+ {
28816
+ "name": "railBreakpoint",
28817
+ "type": "SidebarBreakpoint | number",
28818
+ "description": "Width below which the sidebar collapses on its own (to the rail, or off the canvas), between this and `mobileBreakpoint`, so the content keeps its room. The person can still expand it until the width crosses the breakpoint again; that choice is not saved by `persistKey`. Leave out to collapse only when asked."
28819
+ },
28297
28820
  {
28298
28821
  "name": "mobileOpen",
28299
28822
  "type": "boolean",
@@ -30559,7 +31082,7 @@
30559
31082
  {
30560
31083
  "name": "Switch",
30561
31084
  "category": "Inputs",
30562
- "summary": "An on/off switch. Follows Material UI's `Switch` API: a native checkbox input with `role=\"switch\"` under a drawn track and thumb. Label it with FormControlLabel.",
31085
+ "summary": "An on/off switch. Follows Material UI's `Switch` API and uses Base UI's `Switch` for behavior, as Checkbox and Radio do: the root is the control (`role=\"switch\"`), with a hidden input for forms. `onChange(event, checked)` gets an event whose `target` is that input. Name it through `slotProps.input` (`aria-label`) or a FormControlLabel.",
30563
31086
  "package": "@caligo-ui/core",
30564
31087
  "import": "import { Switch } from '@caligo-ui/core';",
30565
31088
  "keywords": [
@@ -30708,11 +31231,21 @@
30708
31231
  "type": "Partial<TabClasses>",
30709
31232
  "description": "Extra class names for the root and inner parts, keyed by part. The keys are listed in the component's `…Classes` export."
30710
31233
  },
31234
+ {
31235
+ "name": "component",
31236
+ "type": "React.ElementType",
31237
+ "description": "The root element: a `button` by default, or `a` with `href`, or your router's Link, for tabs that go to pages. A link tab keeps `role=\"tab\"` and `aria-selected`, as Material UI's does."
31238
+ },
30711
31239
  {
30712
31240
  "name": "disabled",
30713
31241
  "type": "boolean",
30714
31242
  "description": "Turns off interaction and shows the disabled look."
30715
31243
  },
31244
+ {
31245
+ "name": "href",
31246
+ "type": "string",
31247
+ "description": "Makes the tab a link (an `<a>` unless `component` says otherwise)."
31248
+ },
30716
31249
  {
30717
31250
  "name": "icon",
30718
31251
  "type": "React.ReactElement",
@@ -30960,6 +31493,11 @@
30960
31493
  "type": "'small' | 'medium'",
30961
31494
  "description": "`small` gives tighter padding and smaller text. Leave out to use the Table's `size`."
30962
31495
  },
31496
+ {
31497
+ "name": "pinned",
31498
+ "type": "'start' | 'end'",
31499
+ "description": "Caligo extra: keeps the cell in place while the table scrolls sideways, at the `start` or `end` edge, as a pinned first or last column. Pin the same column's head and body cells; with several pinned, set each one's `style.insetInlineStart` (or End) to the widths before it."
31500
+ },
30963
31501
  {
30964
31502
  "name": "sortDirection",
30965
31503
  "type": "'asc' | 'desc' | false",
@@ -32082,6 +32620,17 @@
32082
32620
  "type": "React.ReactNode",
32083
32621
  "description": "Text under the field. Turns red with `error`."
32084
32622
  },
32623
+ {
32624
+ "name": "description",
32625
+ "type": "React.ReactNode",
32626
+ "description": "Caligo extra: a line under the label that says what the field is for, read with the field (`aria-describedby`). `helperText` is for hints and errors under the box. Not with `select`."
32627
+ },
32628
+ {
32629
+ "name": "orientation",
32630
+ "type": "'vertical' | 'horizontal'",
32631
+ "default": "'vertical'",
32632
+ "description": "Caligo extra: `horizontal` puts the label (and description) beside the box, in a column `--cal-field-label-width` wide (a third of the field), as in a settings form; on a narrow screen it stacks. Not with `select`."
32633
+ },
32085
32634
  {
32086
32635
  "name": "id",
32087
32636
  "type": "string",
@@ -33725,6 +34274,43 @@
33725
34274
  "required": true,
33726
34275
  "description": "One element that can hold a ref, such as a Button. The tooltip describes it."
33727
34276
  },
34277
+ {
34278
+ "name": "sideOffset",
34279
+ "type": "number",
34280
+ "default": "8, or 10 with `arrow`",
34281
+ "description": "Caligo extra: the gap between the element and the tooltip, in px."
34282
+ },
34283
+ {
34284
+ "name": "alignOffset",
34285
+ "type": "number",
34286
+ "description": "Caligo extra: shifts the tooltip along the side it opens on, in px."
34287
+ },
34288
+ {
34289
+ "name": "collisionPadding",
34290
+ "type": "number",
34291
+ "default": "5",
34292
+ "description": "Caligo extra: how far the tooltip keeps from the viewport's edges when it flips or shifts, in px."
34293
+ },
34294
+ {
34295
+ "name": "disabled",
34296
+ "type": "boolean",
34297
+ "description": "Caligo extra: the tooltip never opens; the child renders on its own."
34298
+ },
34299
+ {
34300
+ "name": "followCursor",
34301
+ "type": "boolean",
34302
+ "description": "The tooltip follows the pointer, as in Material UI."
34303
+ },
34304
+ {
34305
+ "name": "onOpenChange",
34306
+ "type": "(open: boolean, details: { event: Event; reason: string }) => void",
34307
+ "description": "Caligo extra: called with Base UI's details (the event and why it opened or closed) when the tooltip opens or closes."
34308
+ },
34309
+ {
34310
+ "name": "shortcut",
34311
+ "type": "string | readonly string[]",
34312
+ "description": "Caligo extra: a keyboard shortcut after the title, drawn as keys. A string is split on `+` and spaces (\"⌘+K\", \"G I\"); an array gives the keys one by one."
34313
+ },
33728
34314
  {
33729
34315
  "name": "classes",
33730
34316
  "type": "Partial<TooltipClasses>",
@@ -35813,7 +36399,7 @@
35813
36399
  "id": "brand-book/color",
35814
36400
  "title": "Color",
35815
36401
  "file": "docs/brand-book.md",
35816
- "body": "Tokens come in three layers. Use them from the top down:\n\n1. **Semantic:** `bg-*`, `surface-*`, `text-*`, `border-*`, `icon-*`, `primary-*`, `state-*`, `link-*`, `chart-*`. Use these in everything you build.\n2. **Theme:** `color-*`. The 14 themes set these, and semantic tokens alias them.\n3. **Primitive:** nine 12-step ramps (`gray`, `primary`, `error`, `warning`, `success`, `blue`, `teal`, `pink`, `orange`, each 25–950) plus `white`, `black` and `brand-*`.\n\nSet the page on `bg-primary`, cards and inputs on `surface-primary`, and body text in `text-primary`. Use `text-secondary` for supporting copy.\n\n**Status** runs on 24 named states, each with four strengths: `state-<name>-base` for dots and strokes, `-light` for borders, `-lighter` for tinted backgrounds and `-dark` for text on that tint. Pair them that way and never pair `-base` text with a `-lighter` fill. The states are: active, away, busy, offline, verified, highlighted, stable, new, pending, archived, completed, failed, in-progress, draft, scheduled, paused, info, neutral, urgent, invited, locked, beta, promoted and expired.\n\n**Contrast.** Text tokens hold 4.5:1 on the grounds their notes name, in all ten Caligo themes, and in Kelvin's (see `docs/quality-pass.md`). To reach that in Caligo's, `color-base-content-secondary`, `color-base-content-tertiary`, hover and pressed primaries and `color-primary-gradient-end` moved slightly from the file where needed, and `color-link` is new. `text-disabled` and `icon-disabled` keep the file's lighter value through `color-base-content-disabled`, because disabled controls are exempt. `*-subtle-text` tokens now use the dark ramp step. For status text, use `state-*-dark` or `*-subtle-text`, never `state-*-base` or `*-default`, which are for fills, dots and strokes. The originals are in `assets/Themes/`."
36402
+ "body": "Tokens come in three layers. Use them from the top down:\n\n1. **Semantic:** `bg-*`, `surface-*`, `text-*`, `border-*`, `icon-*`, `primary-*`, `state-*`, `link-*`, `chart-*`. Use these in everything you build.\n2. **Theme:** `color-*`. The 16 themes set these, and semantic tokens alias them.\n3. **Primitive:** nine 12-step ramps (`gray`, `primary`, `error`, `warning`, `success`, `blue`, `teal`, `pink`, `orange`, each 25–950) plus `white`, `black` and `brand-*`.\n\nSet the page on `bg-primary`, cards on `surface-card` and inputs on `surface-primary`, and body text in `text-primary`. Use `text-secondary` for supporting copy.\n\n**Status** runs on 24 named states, each with four strengths: `state-<name>-base` for dots and strokes, `-light` for borders, `-lighter` for tinted backgrounds and `-dark` for text on that tint. Pair them that way and never pair `-base` text with a `-lighter` fill. The states are: active, away, busy, offline, verified, highlighted, stable, new, pending, archived, completed, failed, in-progress, draft, scheduled, paused, info, neutral, urgent, invited, locked, beta, promoted and expired.\n\n**Contrast.** Text tokens hold 4.5:1 on the grounds their notes name, in all ten Caligo themes, and in Kelvin's (see `docs/quality-pass.md`). To reach that in Caligo's, `color-base-content-secondary`, `color-base-content-tertiary`, hover and pressed primaries and `color-primary-gradient-end` moved slightly from the file where needed, and `color-link` is new. `text-disabled` and `icon-disabled` keep the file's lighter value through `color-base-content-disabled`, because disabled controls are exempt. `*-subtle-text` tokens now use the dark ramp step. For status text, use `state-*-dark` or `*-subtle-text`, never `state-*-base` or `*-default`, which are for fills, dots and strokes. The originals are in `assets/Themes/`."
35817
36403
  },
35818
36404
  {
35819
36405
  "id": "brand-book/type",
@@ -35879,17 +36465,24 @@
35879
36465
  "id": "themes",
35880
36466
  "title": "Themes",
35881
36467
  "file": "docs/themes.md",
35882
- "body": "Caligo ships ten complete themes, plus four that carry Kelvin (72F's app design system) into Caligo. Each one sets the same 120 `color-*` and `component-*` tokens, plus its own corner radii and color scheme. Components read only the semantic names, so switching theme needs no component changes.\n\nSet a theme with `data-theme` on `<html>` or on any container. A nested container can carry a different theme.\n\nA theme sets colours. How surfaces are built (glass, brutalist, neumorphic and others) is a separate setting, `data-style`: see [styles.md](styles.md).\n\n| Theme | `data-theme` | Scheme | Primary | Box / field / selector radius | Character |\n|---|---|---|---|---|---|\n| Caligo Light | `caligo-light` | Light | `#7a65d2` | 8 / 8 / 8 | The default. Neutral grey with soft violet. |\n| Caligo Dark | `caligo-dark` | Dark | `#a48ff8` | 8 / 8 / 8 | The same palette, lightened for dark grounds. |\n| Sakura | `sakura` | Light | `#c75b7a` | 12 / 8 / 20 | Warm rose neutrals with round selectors. |\n| Sahara | `sahara` | Light | `#c06d3a` | 8 / 6 / 8 | Sand neutrals and terracotta, with noise 0.4. |\n| Fjord | `fjord` | Light | `#3a7ca5` | 6 / 4 / 6 | Cool blue-grey and tighter corners. |\n| Moss | `moss` | Light | `#4a7044` | 8 / 6 / 8 | Sage neutrals and deep green, with noise 0.3. |\n| Aurora | `aurora` | Dark | `#50d0a0` | 12 / 8 / 12 | Navy grounds with mint. |\n| Ember | `ember` | Dark | `#e06030` | 4 / 4 / 4 | Charcoal brown with orange, with noise 0.5. |\n| Dusk | `dusk` | Dark | `#9070d0` | 16 / 8 / 24 | Deep violet with the roundest corners. |\n| Obsidian | `obsidian` | Dark | `#a0a0b8` | 2 / 2 / 2 | Near-black and flat: `depth` is 0. |",
36468
+ "body": "Caligo ships twelve complete themes, two of them high-contrast, plus four that carry Kelvin (72F's app design system) into Caligo. Each one sets the same 120 `color-*` and `component-*` tokens, plus its own corner radii and color scheme. Components read only the semantic names, so switching theme needs no component changes.\n\nSet a theme with `data-theme` on `<html>` or on any container. A nested container can carry a different theme.\n\nThe themed element paints the theme's page colour (`--cal-bg-primary`) and text colour (`--cal-text-primary`), as\ndaisyUI's themes do, so a dark theme inside a light page reads as dark, and text and `color=\"inherit\"` buttons in it\ntake the theme's text colour. The rule has no specificity (`:where()`), so any background or colour the app sets on\nthat element wins.\n\nA theme can also set type: four fonts (`--cal-font-display`, `--cal-font-heading`, `--cal-font-sans`, `--cal-font-mono`),\nthe weight of each role (`--cal-weight-display`, `-heading`, `-label`, `-body`) and each Typography variant's size,\nline height and tracking (`--cal-type-h1-size` and so on). None of Caligo's themes sets them; the theme generator's Type\ntab writes them. `src/Typography/Typography.css` lists them with Caligo's values.\n\nTo make a theme of your own, use the theme generator (`theme-generator/`): it starts from any of these, derives every\ntoken the way they do, and gives the CSS. See [theme-generator.md](theme-generator.md).\n\nA theme sets colours. How surfaces are built (glass, brutalist, neumorphic and others) is a separate setting, `data-style`: see [styles.md](styles.md).\n\n| Theme | `data-theme` | Scheme | Primary | Box / field / selector radius | Character |\n|---|---|---|---|---|---|\n| Caligo Light | `caligo-light` | Light | `#7a65d2` | 8 / 8 / 8 | The default. Neutral grey with soft violet. |\n| Caligo Dark | `caligo-dark` | Dark | `#a48ff8` | 8 / 8 / 8 | The same palette, lightened for dark grounds. |\n| Sakura | `sakura` | Light | `#c75b7a` | 12 / 8 / 20 | Warm rose neutrals with round selectors. |\n| Sahara | `sahara` | Light | `#c06d3a` | 8 / 6 / 8 | Sand neutrals and terracotta, with noise 0.4. |\n| Fjord | `fjord` | Light | `#3a7ca5` | 6 / 4 / 6 | Cool blue-grey and tighter corners. |\n| Moss | `moss` | Light | `#4a7044` | 8 / 6 / 8 | Sage neutrals and deep green, with noise 0.3. |\n| Aurora | `aurora` | Dark | `#50d0a0` | 12 / 8 / 12 | Navy grounds with mint. |\n| Ember | `ember` | Dark | `#e06030` | 4 / 4 / 4 | Charcoal brown with orange, with noise 0.5. |\n| Dusk | `dusk` | Dark | `#9070d0` | 16 / 8 / 24 | Deep violet with the roundest corners. |\n| Obsidian | `obsidian` | Dark | `#a0a0b8` | 2 / 2 / 2 | Near-black and flat: `depth` is 0. |\n| Caligo Light Contrast | `caligo-light-contrast` | Light | `#4b3a9e` | 8 / 8 / 8 | Caligo Light at high contrast: black text, 7:1 and up; opaque 3:1 edges; a 3px focus ring. |\n| Caligo Dark Contrast | `caligo-dark-contrast` | Dark | `#c9bcff` | 8 / 8 / 8 | Caligo Dark at high contrast, on a black ground. |",
35883
36469
  "sections": [
36470
+ "themes/an-app-s-own-light-and-dark-switch",
35884
36471
  "themes/kelvin-themes",
35885
36472
  "themes/shadcn-themes"
35886
36473
  ]
35887
36474
  },
36475
+ {
36476
+ "id": "themes/an-app-s-own-light-and-dark-switch",
36477
+ "title": "An app's own light and dark switch",
36478
+ "file": "docs/themes.md",
36479
+ "body": "Most apps already have a dark mode switch, and it doesn't use Caligo's theme names. Caligo answers to the two common\nconventions on any element: `class=\"dark\"` or `data-theme=\"dark\"` gives Caligo Dark, and `class=\"light\"` or\n`data-theme=\"light\"` gives Caligo Light. So shadcn and Tailwind apps (`.dark` on `<html>`), next-themes\n(`data-theme=\"dark\"`) and Plane work without mapping anything. The class form skips an element that also names a\ntheme, so `class=\"dark\" data-theme=\"dusk\"` is Dusk.\n\n`:root` also declares `color-scheme: light`. Caligo's colours use `light-dark()`, which the build compiles to switches\nthat only a `color-scheme` declaration sets; without one, on a page whose `data-theme` wasn't one of Caligo's, menus,\npopovers and dialogs drew no background at all. For any other theme name (Plane's `dark-contrast`, say), copy the\n`caligo-dark` block from `tokens/tokens.css` under your selector, with `color-scheme: dark`."
36480
+ },
35888
36481
  {
35889
36482
  "id": "themes/kelvin-themes",
35890
36483
  "title": "Kelvin themes",
35891
36484
  "file": "docs/themes.md",
35892
- "body": "Kelvin is the design system of 72F's apps (`72F-Kelvin`). These four themes let a Caligo page sit beside a Kelvin app\nand look like the same product: Kelvin's Ember accent, paper canvas with grey wells, its status colours, and its\nshapes. They are generated from Kelvin's `tokens.json`, so they follow Kelvin when its colours change; regenerate rather\nthan editing the values by hand: delete the block from its opening comment to the end of `bundle.css`, then run\n`python3 tools/kelvin_theme.py ../72F-Kelvin/tokens.json components/bundle.css >> components/bundle.css`.\n\n| Theme | `data-theme` | Scheme | Primary | Corners | Character |\n|---|---|---|---|---|---|\n| Kelvin | `kelvin-light` | Light | `#c84400` | Pill controls, 16px fields, 24px cards | Kelvin's Pebble: round, softly lit. |\n| Kelvin Dark | `kelvin-dark` | Dark | `#c84400` | The same | True-black canvas with near-black wells. |\n| Kelvin Flat | `kelvin-flat-light` | Light | `#c84400` | 12px controls and fields, 16px cards | Kelvin's Flat with Firm corners, as 72F Mail draws: nothing raised. |\n| Kelvin Flat Dark | `kelvin-flat-dark` | Dark | `#c84400` | The same | |\n\nThey set `--cal-font-sans` to Onest, Kelvin's type; load it from Google Fonts on the page, or the theme falls back to Inter.\nKelvin's own orange (`#fd5f12`, `#e15606` in dark) is too bright for the white text Kelvin puts on it (2.7–3.1:1), so\nthe four themes use `#c84400` instead: the most vivid orange that keeps white text at 4.5:1 (4.9:1), with a gradient\ntop of `#cf4b00` and deeper hover and pressed shades. It stays above 3:1 against light and dark pages. This override\nlives in `src/styles/styles.css`, so regenerating from Kelvin's tokens doesn't undo it. The Kelvin themes are declared\nat the end of `components/bundle.css`.\n\nThe page's theme switcher holds eight themes. Dusk and Obsidian are declared in `components/bundle.css` and behave identically; try all ten on the Theme Swatches card. The file's original exports are in `assets/Themes/` as DTCG-format JSON. A few text and hover values in the live tokens were adjusted from them for contrast, as the brand book explains.\n\n`depth` and `noise` are exposed as `--cal-depth` and `--cal-noise`. No shipped component reads them yet."
36485
+ "body": "Kelvin is the design system of 72F's apps (`72F-Kelvin`). These four themes let a Caligo page sit beside a Kelvin app\nand look like the same product: Kelvin's Ember accent, paper canvas with grey wells, its status colours, and its\nshapes. They are generated from Kelvin's `tokens.json`, so they follow Kelvin when its colours change; regenerate rather\nthan editing the values by hand: delete the block from its opening comment to the end of `bundle.css`, then run\n`python3 tools/kelvin_theme.py ../72F-Kelvin/tokens.json components/bundle.css >> components/bundle.css`.\n\n| Theme | `data-theme` | Scheme | Primary | Corners | Character |\n|---|---|---|---|---|---|\n| Kelvin | `kelvin-light` | Light | `#c84400` | Pill controls, 16px fields, 24px cards | Kelvin's Pebble: round, softly lit. |\n| Kelvin Dark | `kelvin-dark` | Dark | `#c84400` | The same | True-black canvas with near-black wells. |\n| Kelvin Flat | `kelvin-flat-light` | Light | `#c84400` | 12px controls and fields, 16px cards | Kelvin's Flat with Firm corners, as 72F Mail draws: nothing raised. |\n| Kelvin Flat Dark | `kelvin-flat-dark` | Dark | `#c84400` | The same | |\n\nThey set `--cal-font-sans` to Onest, Kelvin's type; load it from Google Fonts on the page, or the theme falls back to Inter.\nKelvin's own orange (`#fd5f12`, `#e15606` in dark) is too bright for the white text Kelvin puts on it (2.7–3.1:1), so\nthe four themes use `#c84400` instead: the most vivid orange that keeps white text at 4.5:1 (4.9:1), with a gradient\ntop of `#cf4b00` and deeper hover and pressed shades. It stays above 3:1 against light and dark pages. This override\nlives in `src/styles/styles.css`, so regenerating from Kelvin's tokens doesn't undo it. The Kelvin themes are declared\nat the end of `components/bundle.css`.\n\nThe page's theme switcher holds eight themes. Dusk and Obsidian are declared in `components/bundle.css` and behave identically; try all ten on the Theme Swatches card. The two contrast themes are generated into `src/styles/foundation.css` by `scripts/extract-foundation.mjs` from Caligo Light and Dark, with their own text, primary, status and edge colours; text is 7:1 and up, status colours 6:1, edges 3:1 (`test/contrast-themes.test.ts`). They also answer to `data-theme=\"light-contrast\"` and `\"dark-contrast\"`. The file's original exports are in `assets/Themes/` as DTCG-format JSON. A few text and hover values in the live tokens were adjusted from them for contrast, as the brand book explains.\n\n`depth` and `noise` are exposed as `--cal-depth` and `--cal-noise`. No shipped component reads them yet."
35893
36486
  },
35894
36487
  {
35895
36488
  "id": "themes/shadcn-themes",
@@ -35980,7 +36573,7 @@
35980
36573
  "id": "mui-compatibility/phases",
35981
36574
  "title": "Phases",
35982
36575
  "file": "docs/mui-compatibility.md",
35983
- "body": "### Phase 1: Source and build — done\n\n- The components are being rebuilt as TypeScript in `src/`, straight onto Base UI with the new API. The legacy `components/bundle.js` keeps serving the previews until each component is ported.\n- `npm run build` produces all three outputs from the same source:\n - `dist/esm` and `dist/types`: the npm package. Apps import `@caligo-ui/core/styles.css` once, since the JS doesn't import CSS.\n - `dist/global`: `caligo-ui.js` and `caligo-ui.css`, setting `window.CaligoUI`. Needs React 18's UMD files, because React 19 ships none. Base UI is bundled in.\n - `dist/r`: the shadcn registry, built by `shadcn build` from `registry.json`.\n- `test/describeConformance.tsx` checks the section 7 rules. Button passes it, plus 12 behavior tests.\n- `examples/button-next.html` shows every variant, color, size and state with the script build, in any theme.\n\nStill open from this phase:\n\n- **The package name is unconfirmed.** `@caligo-ui/core` is a placeholder, and `package.json` is marked private until the name and the npm scope are confirmed.\n- **The Icon component isn't ported yet.**\n- **Theme variables are still copied.** `scripts/extract-foundation.mjs` copies the variable blocks out of the legacy `bundle.css` into `src/styles/foundation.css`, now inside `@layer caligo`. It goes away when the last legacy component is ported and `src/` becomes the source of the tokens.\n\n### Phase 2: Pilot — done (13 November 2026)\n\n- **Five components on Base UI with the MUI API:** Button, TextField, Checkbox, Dialog (with DialogTitle, DialogContent, DialogContentText and DialogActions) and Tooltip. All five pass `describeConformance`, plus 84 tests in all.\n - TextField: `variant` outlined, filled or standard; `size` xsmall to large; `label`, `helperText`, `error`, `required`, `fullWidth`, `multiline` (replaces TextArea), `inputRef`, and `slotProps` for `input` (with `startAdornment` and `endAdornment`), `htmlInput`, `inputLabel` and `formHelperText`. `onChange(event)`.\n - Checkbox: `onChange(event, checked)`, controlled and uncontrolled, `indeterminate`, the MUI colors plus `default`, sizes small to large, `icon`, `checkedIcon`, `indeterminateIcon`, `inputRef`.\n - Dialog: `open` with `onClose(event, reason)` and MUI's reasons `\"backdropClick\"` and `\"escapeKeyDown\"`; `maxWidth`, `fullWidth`, `fullScreen`, `scroll`, `disableEscapeKeyDown`, `hideBackdrop`, `keepMounted`, `container`, `disablePortal`; `slotProps` for `backdrop`, `container` and `paper`. Root at z-index 1300.\n - Tooltip: `title`, `placement` (MUI's twelve), `arrow`, `open` with `onOpen(event)` and `onClose(event)`, `enterDelay`, `leaveDelay`, `describeChild`, `disableInteractive`; `slotProps` for `popper`, `tooltip` and `arrow`. The ref and other props go to the child, as in MUI. Popper at z-index 1500.\n - `examples/pilot-next.html` shows all of them with the script build, in any theme.\n- **All legacy CSS is in `@layer caligo`:** `tokens/tokens.css`, `components/bundle.css` (after its font `@import`), and the generated `tokens/auto.css` and `src/styles/foundation.css`. `tools/auto_theme.py` and `scripts/extract-foundation.mjs` read and write the layer. Checked by fingerprinting every element's computed style on `examples/basic.html`, the landing page and 20 component previews in caligo-light, caligo-dark, sakura and obsidian, before and after: no differences.\n- **Mixed-app check** (`test/mixed-app.test.tsx` and `examples/mixed-app`, built with `npm run build:mixed`):\n - A Caligo dialog inside an MUI dialog, and an MUI dialog inside a Caligo dialog: focus moves into the inner one, Tab stays there, Escape closes only the inner one, and focus returns to the outer one.\n - In the browser, each nested dialog and each library's tooltip is on top of the other's dialog (MUI's z-index values).\n - Turning Caligo's stylesheet off changes no computed style on the MUI components, and turning MUI's Emotion styles off changes none on the Caligo components. Neither library's classes appear in the other's markup.\n- **Contrast** is checked in a browser with axe's `color-contrast` rule on `examples/pilot-next.html` in four themes: no violations. Axe can't decide fields and contained buttons because of the lit-edge `::after` stroke; measured by hand, field text is 10:1 or better, and the contained primary label is at least 4.55:1 against both gradient stops in every theme.\n- **Registry install:** in a fresh Vite app set up with `shadcn init -b base`, `shadcn add` installs all five items from `dist/r`, the app type-checks under TypeScript 7, and the components render and behave. Tailwind projects declare the layer order once, so Caligo beats Tailwind's preflight reset and Tailwind utilities still override Caligo:\n\n ```css\n @layer theme, base, caligo, components, utilities;\n @import \"tailwindcss\";\n @import \"./components/caligo/styles/tokens.css\";\n @import \"./components/caligo/styles/foundation.css\";\n ```\n\n- **Script build fix:** Base UI's dialog and tooltip bundle CommonJS code that calls `require(\"react\")`. The IIFE build now resolves `react` and `react-dom` to the page's globals through `scripts/react-global.cjs` and `scripts/react-dom-global.cjs` instead of leaving them external.\n\nStill open from this phase:\n\n- **Focus checks in a visible browser window.** Focus and Escape across the two libraries pass in jsdom. The browser checks covered stacking and styles only, because the preview window had no focus.\n- **Checkbox `slotProps.input` isn't supported.** Base UI owns the hidden input; `inputRef`, `name`, `value`, `required` and `id` cover forms.\n- **Tooltip's `disableHoverListener`, `disableFocusListener`, `disableTouchListener` and `followCursor` aren't supported.** Base UI's tooltip doesn't split its triggers; they are left out of the types rather than accepted and ignored.\n- **Each registry item carries its own copy of the shared helpers and theme files.** A dependency between items needs the registry's hosted URL, which doesn't exist yet.\n\n### Phase 3: Port the free core — done (13 November 2026)\n\n- **Every free component is ported** to `src/` on Base UI, in seven committed groups (3a to 3g): field extras, overlays, feedback, navigation, surfaces and layout, tables and timelines, complex inputs, and brand pieces. `src/index.ts` exports 165 names; 25 of them are deprecated aliases that warn once in development.\n- **Material UI and MUI X APIs** where MUI has the component, including Autocomplete (`onChange(event, value, reason)`, `groupBy`, `freeSolo`, `renderInput` read from a TextField), the Table family, MUI Lab's Timeline, and MUI X's DateCalendar, DateRangeCalendar, DatePicker, DateRangePicker, TimePicker and SimpleTreeView. The pickers take plain `Date` values, like MUI X with AdapterDateFns.\n- **Caligo's own components** keep their names and follow the same rules: InputOTP, ColorPicker, CommandPalette, FileUpload, FileUploadDropzone, FileUploadItem, AvatarUpload, Carousel, Resizable, ScrollArea, AspectRatio, StatItem, StatsPanel, NotificationItem, ActivityFeed, ErrorPanel, Logo, SSOButton and AppStoreBadge.\n- **Error states follow the house rule.** Rejected files carry stable codes (`FU-101` too large, `FU-102` wrong type, `FU-103` too many) and a plain message; a failed upload shows its code under \"View more\". ActivityFeed and CommandPalette take an ErrorPanel for their error state.\n- **Conformance:** every exported component runs `describeConformance`, which now also checks that it reads default props from `CaligoProvider`. 1,031 tests pass, with axe on each component.\n- **`CaligoProvider`** sets default props per component, keyed `\"Button\"` or `\"MuiButton\"`, so a Material UI theme's `components` object can be reused. Own props win, then a ButtonGroup's, then the provider's. It also takes `localeText` (all 30 built-in strings), `locale` for the pickers, and `direction`. `useTheme` and `useMediaQuery` match Material UI's.\n- **Right to left:** component CSS uses logical properties, Badge and Switch mirror their transforms, direction-sensitive icons mirror, and arrow keys follow reading order in Tabs, Toolbar, the calendars, Resizable and the tree. Set `dir=\"rtl\"` on `<html>` or a wrapper; the provider's `direction` also reaches Base UI.\n- **Codemod:** `codemod/` (to publish as `@caligo-ui/codemod`; `npm run codemod -- <files>` here) applies the renames in section 2 and the prop changes in section 3, in JSX and in `h(C.Button, {…})` calls, inside `.js`, `.jsx`, `.ts`, `.tsx` and inline HTML scripts. It also wraps labelled switches in FormControlLabel and turns Card `title`/`description` into CardHeader and CardContent. Structural cases it can't rewrite safely (Accordion `items`, ListItem `leading`, Tree, ProgressSteps and others) are listed with line numbers, and keep working through their aliases. `examples/basic.html` migrates with nothing left to do by hand and renders on the new build with no warnings; `examples/basic-migrated.html` is the result.\n- **Generated API docs:** `npm run docs:api` writes `docs/api/` from the prop interfaces and their JSDoc, with defaults and deprecations. `npm test` fails when they're out of date (`test/api-docs.test.ts`, or `npm run docs:api:check`).\n- **Asset links:** in HTML the codemod also points `components/bundle.{js,css}` at `dist/global/caligo-ui.{js,css}` and drops the separate `tokens.css` link, since the tokens are inside. `--assets <folder or URL>` points them somewhere else, such as a CDN.\n- **Gallery:** `examples/components-next.html` shows every Phase 3 component in any theme.\n\nNot done in this phase:\n\n- **ThemeSwatches** stays a reference card, as its README says. It was never shipped in the bundle.\n- **DatePicker has no year or month view.** Months page with the arrows and PageUp/PageDown (Shift for years). The field types in the locale's order; MUI X's sectioned field isn't copied.\n- **Focus in a visible browser window** still needs a manual pass. Focus moves were checked in jsdom and in the hidden preview pane, which doesn't always paint.\n\n**Done when** every free component passes conformance and the codemod migrates `examples/basic.html` cleanly. Both are met.\n\n### Phase 4: Paid set and theme bridge — done (14 November 2026), except the admin steps below\n\n- Port the chat and AI set, DataTable and charts, behind a license key.\n- Build `createCaligoTheme()` so Material UI components in the same app match Caligo.\n- Build the app shells and templates, and line the Figma kit up with the shipped API.\n\n**Done when** the paid components pass conformance, an invalid or missing license key shows a clear notice in development, and the theme bridge styles a Material UI Button and Dialog to match.\n\nProgress (13 November 2026):\n\n- **Theme bridge — done.** `import { createCaligoTheme } from '@caligo-ui/core/mui'` returns a Material UI theme with every Caligo theme as a colour scheme, keyed by its name and read from the same `data-theme` attribute, so one switch changes both libraries. The palette uses resolved colours per theme (`scripts/extract-theme-values.mjs`), because Material UI does colour maths on it; Button and Dialog overrides read Caligo's variables directly. `@mui/material` is an optional peer dependency, used only by this entry. In the mixed-app page, a Material UI Button matches Caligo's height, radius, font, gradient, border and shadow, and a Material UI Dialog paper matches Caligo's radius, background, border and shadow, in light and dark (`test/mui-bridge.test.tsx`, `examples/mixed-app`; add `?bridge=0` to compare against Material UI's own look).\n- **License keys — done in code.** `LicenseInfo.setLicenseKey(key)` (`src/internal/license.ts`, exported from `@caligo-ui/core`) checks a signed key offline, with no call home. A key is `CAL1.<payload>.<signature>`: the payload holds the order, plan, `perpetual` or `subscription`, and an end date; the signature is Ed25519, and only the public key ships. A perpetual key covers every release dated up to its end date (pay once); a subscription works until its end date.\n - Paid components keep working without a key. They show a small corner notice whose \"View more\" gives the code, and log the reason once per code: `LIC-100` missing, `LIC-101` malformed, `LIC-102` bad signature, `LIC-103` release newer than a perpetual key covers, `LIC-104` subscription ended, `LIC-105` plan doesn't include the paid set.\n - Missing, malformed, forged and wrong-plan keys show the notice everywhere, as MUI X does. An expired subscription or a release past a perpetual key's end shows it in development only, so a live site never changes overnight. Browsers that can't check Ed25519 are treated as licensed, so paying customers are never nagged.\n - `scripts/license.mjs` makes the signing keypair (`keygen`, private key outside the repo), issues keys (`issue`), checks them (`check`) and stamps the release date (`stamp`). Tests sign with a throwaway keypair (`test/license.ts`).\n- **Paid set — done.** All ported to `src/` with conformance and axe tests, behind the license hook:\n - Chat and AI: ChatPanel, ChatMessageList, ChatBubble, ChatMessageGroup, Composer, ComposerInput, ToolCallCard, ReasoningCard, AgentStatusPanel, MultiAgentPanel, Trace, Questionnaire, ApprovalDialog, ArtifactCard, Attachment, SourceCard, PromptSuggestions, SuggestionChip, TypingIndicator, VoiceInputBar, ContextIndicator, ConversationItem, AISidebar. Trace and Questionnaire are new.\n - Data: DataGrid (MUI X DataGrid with the Pro and Premium features most asked for: column pinning, multi-sort, row and column virtualisation, column reordering, tree data, row grouping, aggregation, pinned rows, cell editing, CSV and print export), FilterBar, LineChart, BarChart, PieChart, RadarChart, Gauge, ActivityGauge, SparkLineChart, Heatmap, Treemap, SankeyChart, ChartsLegend, ChartsReferenceLine (dual axes, log scale, zoom and pan), Metrics, DashboardWidget, AnalyticsPanel. Every chart has a text summary, a data-table fallback, and keyboard reach to each point.\n - App shells: ApplicationPage, DashboardHeader, DashboardSidebar, SettingsPanel, NotificationCenter, UserProfilePanel, FileBrowser, SearchPanel, BillingSection, AuthPage, ErrorPage.\n - Page templates: Hero, CTA, FeatureGrid, FeatureComparison, Pricing, FAQ, Testimonials, LogoCloud, StatsSection, Team, Newsletter, Contact, Cover, Blog, BlogIndexPage, MarketingPage, ProductCard, ProductGrid, ProductDetail, CartSummary, CheckoutSection, CommercePage, with the item pieces (FeatureCard, PricingPlan, FAQItem, TestimonialCard, TeamMember, BlogPostCard, DeviceFrame) and MarketingSection free.\n - New and paid, from what people ask for (`docs/component-demand.md`): Scheduler (month, week, day, agenda, resources, recurring events), GanttChart (dependencies of all four types, 5,000 rows), Kanban (multi-select, WIP limits), DashboardGrid (per-breakpoint layouts).\n- **Free additions** (also from `docs/component-demand.md`): Menubar, NavigationMenu, AppBar, Sidebar, BottomNavigation, YearCalendar, MonthCalendar, DateField, TimeField, DateTimeField, DigitalClock, DateTimePicker, TimeRangePicker, DateTimeRangePicker, DurationField, FormWizard, PhoneField, MentionsInput, TreeSelect, QueryBuilder, RichTextEditor, EmojiPicker, VirtualList, VirtualGrid, SortableList, Tour, CodeBlock, JsonViewer, DiffViewer, VideoPlayer, PullToRefresh. DatePicker gained year and month views; Autocomplete and Select gained `virtualized`.\n- **Translations:** `CaligoProvider localeText` also takes component-keyed packs, `{ Composer: { sendLabel: 'Senden' }, DataGrid: { localeText: { … } } }`, merged one level deep. `enUS` (generated by `scripts/locale-pack.mjs` from the components' own defaults) lists every built-in English string, so a translation starts from a complete list.\n- **Codemod:** `Chat`, `Bubble`, `Header` and `DataTable` move to `ChatPanel`, `ChatBubble`, `AppBar` and `DataGrid`, with their prop changes; structural cases (AreaChart, MultiAgentPanel, page `type` props and others) are listed for hand edits.\n- **Errors** follow the house rule everywhere, with stable codes per stage: `CH-` (chat), `CHT-` (charts), `DG-`, `DW-`, `AP-`, `SCH-`, `GNT-`, `AUTH-`, `PG-`, `NC-`, `UP-`, `FB-`, `SR-`, `BIL-`, `NL-`, `CT-`, `CO-`, `FW-`, `MI-`, `RTE-`, `CODE-`, `JSON-`, `VID-`, `PTR-`, `LIC-`. `docs/error-codes.md` lists all 112 codes and where each is raised; `scripts/sync-components.mjs` regenerates it.\n- **Checked:** all tests pass, and the project type-checks. Each gallery (`examples/{chat,data,shells,marketing,time,inputs,content,components}-next.html`) was run through axe in the browser in six to ten themes; the contrast, label-in-name and focus findings were fixed. What's left is page-level structure in the demo pages themselves and a disabled field's label, which WCAG exempts.\n- **Second round (14 November 2026):**\n - DataGrid: master-detail (`getDetailPanelContent`, `getDetailPanelHeight` with `'auto'`, controlled `detailPanelExpandedRowIds`), row reordering by pointer and keyboard with announcements (`rowReordering`, `onRowOrderChange`), and `.xlsx` export with no dependencies (`exportDataAsExcel`, `DG-403`, `DG-404`).\n - Scheduler: a `timezone` prop and per-event zones, correct across DST changes, plus `rdate`, EXDATE and iCalendar recurrence lines (`SCH-103`, `SCH-104`). GanttChart: `lag` and lead on all four dependency types, and `autoSchedule` pushes successors along, stopping on a loop (`GNT-103`, `GNT-204`).\n - BarChart zooms and pans on its category axis like LineChart, through a shared `useAxisZoom`. Charts also gained two-finger pinch.\n - ChatMessageList virtualises past 100 messages, keeping stick-to-bottom, scroll position when older messages load, and screen reader announcements.\n - RichTextEditor tables (size picker, header row, add and remove rows and columns, Tab between cells, sanitised paste). PhoneField checks number ranges per country and reports `mobile` or `fixedLine`, with `validateOnBlur`.\n- **Third round (14 November 2026):** Scheduler reads and writes `.ics` files (`parseICalendar`, `toICalendar`, Import and Export in the toolbar, edited single occurrences as RECURRENCE-ID, Google and Outlook time zone names, `SCH-105` to `SCH-111`), and draws correctly when the browser's own zone changes clocks on the same day. RichTextEditor reads and writes Markdown with GFM tables (`format=\"markdown\"`, `getMarkdown`, `setMarkdown`, Markdown paste, `RTE-102`, `RTE-301`). Chart zoom announcements and summaries are translatable (`zoomAnnouncementText`, `zoomedSummaryText`). DataGrid detail rows count in `aria-rowcount` and `aria-rowindex`. A flaky license test was fixed: it tampered with the signature's last character, which holds padding bits.\n- **Bugs fixed along the way:** Drawer and Carousel slid the wrong way in right-to-left; the Accordion chevron never turned; Tooltip doubled its child's classes; inherit-coloured Buttons used `currentColor` through a variable; upcoming Stepper labels were faded to 1.7:1; the Google SSO blue was 3.6:1 with white (now Google's #1a73e8); moss's filled success badge was 4.2:1; several components read token names that don't exist.\n\nAdmin steps left for 72F (not code):\n\n1. **Make the signing keypair:** `node scripts/license.mjs keygen`. Until then the public key in `src/internal/license.ts` is empty and every key fails with `LIC-102`. Back the private key up; every issued license depends on it.\n2. **Publish the license page** the notices link to, `https://caligo.72fstudio.in/docs/license/#LIC-1xx`. It's written: `docs/guides/license.md` has one section per code (a test keeps it in step with `src/internal/license.ts`), and the docs site in the 72FStudio-site repo renders it. Add a contact address to its \"Still stuck\" section.\n3. **Plans.** Decided 15 November 2026: Caligo is sold per major version, one-time, on Polar: Pro v1 for one developer at $199, and Team v1 for up to five developers at $699; Enterprise by contact. No Figma tier: a Figma (or Penpot) kit is being reconsidered and may come later. A v1 key (`\"m\": 1` in its payload) covers every 1.x release and the 0.x previews, forever; 2.0 will be a new product and a paid upgrade (LIC-103 says so). The code still accepts `pro`, `team` and `enterprise`.\n4. **Keys at checkout — wired.** Polar's license-key benefit puts a Polar key on the receipt. The buyer swaps it for a Caligo key at `caligo.72fstudio.in/docs/get-key` (72FStudio-site: `lib/caligo-license.ts`, `app/api/caligo-license`), which checks the Polar key with Polar, maps its benefit to a major version, and signs with the Worker secret `CALIGO_LICENSE_SIGNING_KEY`. Failures have codes `CLK-100` to `CLK-302`. By hand: `node scripts/license.mjs issue --order <id> --major 1`. Run `stamp` when cutting each release; it sets the release's date and major version.\n5. **Confirm the package names and npm scope**: `@caligo-ui/core` (public, MIT) and `@caligo-ui/pro` (private). See [open-core.md](open-core.md) for where each is published.\n6. **Redraw the Figma kit** for the new components.\n\nNot done in this phase:\n\n- No manual pass yet with a real screen reader, touch device, IME (Japanese or Chinese input) or full screen / picture-in-picture. The automated checks pass, and these need hands.\n- The `.xlsx` export opens in LibreOffice; it hasn't been opened in Excel itself. The `.ics` export hasn't been through an outside validator or imported into Google Calendar or Outlook.\n- Scheduler: all-day and month cells still go by local dates, so a zone that skips midnight itself (Santiago, Havana) could put an all-day event on the wrong day. iCalendar `VALUE=PERIOD` dates, EXRULE, attendees and alarms are skipped on import, with a warning.\n- PhoneField can't tell mobile from landline in the US and Canada, Denmark or Mexico (their numbers don't encode it), and India's split is approximate.\n- RichTextEditor's Markdown drops what the editor can't hold: thematic breaks, code-fence languages, ordered-list start numbers, underline.\n\n### Phase 5: Launch and measure\n\n- Publish 1.0 to npm and the registry, and publish the Radix CSS layer and its recipes.\n- At checkout, ask \"How do you install Caligo?\" (npm, shadcn registry, Radix CSS, script tag), and record the answer with the license.\n- Track registry installs and npm downloads each week.\n\n**Done when** sales have been tracked by install method for three months.\n\n### Phase 6: shadcn-native — built early (14 and 15 November 2026)\n\nThe plan was to wait for three months of sales, and to build a shadcn-native version only if enough paid revenue came\nthrough the shadcn registry. 72F decided on 14 November 2026 to build it now, since its own apps will use it.\n\nWhat was built is the Tailwind build (`docs/tailwind.md`): Tailwind classes, class merging, Base UI and the same tokens,\nfor all 291 components. It is generated from the CSS build's source, so it is not a second codebase; that is why the\ncost that made this phase wait no longer applied.\n\n- **Part-based components** (`Dialog.Trigger`, `Dialog.Content`) were added the next day, for eleven components:\n the overlays, Tabs, Accordion and Collapsible (`docs/parts.md`). They are a second shape over the same classes, in\n their own entry (`@caligo-ui/core/parts`), so Material UI's API in the main entry is unchanged. The rest keep\n Material UI's props only.\n- **Still open: the measure.** Phase 5's question at checkout (\"How do you install Caligo?\") now has one more answer,\n the Tailwind registry, and still decides where effort goes next."
36576
+ "body": "### Phase 1: Source and build — done\n\n- The components are being rebuilt as TypeScript in `src/`, straight onto Base UI with the new API. The legacy `components/bundle.js` keeps serving the previews until each component is ported.\n- `npm run build` produces all three outputs from the same source:\n - `dist/esm` and `dist/types`: the npm package. Apps import `@caligo-ui/core/styles.css` once, since the JS doesn't import CSS.\n - `dist/global`: `caligo-ui.js` and `caligo-ui.css`, setting `window.CaligoUI`. Needs React 18's UMD files, because React 19 ships none. Base UI is bundled in.\n - `dist/r`: the shadcn registry, built by `shadcn build` from `registry.json`.\n- `test/describeConformance.tsx` checks the section 7 rules. Button passes it, plus 12 behavior tests.\n- `examples/button-next.html` shows every variant, color, size and state with the script build, in any theme.\n\nStill open from this phase:\n\n- **The package name is unconfirmed.** `@caligo-ui/core` is a placeholder, and `package.json` is marked private until the name and the npm scope are confirmed.\n- **The Icon component isn't ported yet.**\n- **Theme variables are still copied.** `scripts/extract-foundation.mjs` copies the variable blocks out of the legacy `bundle.css` into `src/styles/foundation.css`, now inside `@layer caligo`. It goes away when the last legacy component is ported and `src/` becomes the source of the tokens.\n\n### Phase 2: Pilot — done (13 November 2026)\n\n- **Five components on Base UI with the MUI API:** Button, TextField, Checkbox, Dialog (with DialogTitle, DialogContent, DialogContentText and DialogActions) and Tooltip. All five pass `describeConformance`, plus 84 tests in all.\n - TextField: `variant` outlined, filled or standard; `size` xsmall to large; `label`, `helperText`, `error`, `required`, `fullWidth`, `multiline` (replaces TextArea), `inputRef`, and `slotProps` for `input` (with `startAdornment` and `endAdornment`), `htmlInput`, `inputLabel` and `formHelperText`. `onChange(event)`.\n - Checkbox: `onChange(event, checked)`, controlled and uncontrolled, `indeterminate`, the MUI colors plus `default`, sizes small to large, `icon`, `checkedIcon`, `indeterminateIcon`, `inputRef`.\n - Dialog: `open` with `onClose(event, reason)` and MUI's reasons `\"backdropClick\"` and `\"escapeKeyDown\"`; `maxWidth`, `fullWidth`, `fullScreen`, `scroll`, `disableEscapeKeyDown`, `hideBackdrop`, `keepMounted`, `container`, `disablePortal`; `slotProps` for `backdrop`, `container` and `paper`. Root at z-index 1300.\n - Tooltip: `title`, `placement` (MUI's twelve), `arrow`, `open` with `onOpen(event)` and `onClose(event)`, `enterDelay`, `leaveDelay`, `describeChild`, `disableInteractive`; `slotProps` for `popper`, `tooltip` and `arrow`. The ref and other props go to the child, as in MUI. Popper at z-index 1500.\n - `examples/pilot-next.html` shows all of them with the script build, in any theme.\n- **All legacy CSS is in `@layer caligo`:** `tokens/tokens.css`, `components/bundle.css` (after its font `@import`), and the generated `tokens/auto.css` and `src/styles/foundation.css`. `tools/auto_theme.py` and `scripts/extract-foundation.mjs` read and write the layer. Checked by fingerprinting every element's computed style on `examples/basic.html`, the landing page and 20 component previews in caligo-light, caligo-dark, sakura and obsidian, before and after: no differences.\n- **Mixed-app check** (`test/mixed-app.test.tsx` and `examples/mixed-app`, built with `npm run build:mixed`):\n - A Caligo dialog inside an MUI dialog, and an MUI dialog inside a Caligo dialog: focus moves into the inner one, Tab stays there, Escape closes only the inner one, and focus returns to the outer one.\n - In the browser, each nested dialog and each library's tooltip is on top of the other's dialog (MUI's z-index values).\n - Turning Caligo's stylesheet off changes no computed style on the MUI components, and turning MUI's Emotion styles off changes none on the Caligo components. Neither library's classes appear in the other's markup.\n- **Contrast** is checked in a browser with axe's `color-contrast` rule on `examples/pilot-next.html` in four themes: no violations. Axe can't decide fields and contained buttons because of the lit-edge `::after` stroke; measured by hand, field text is 10:1 or better, and the contained primary label is at least 4.55:1 against both gradient stops in every theme.\n- **Registry install:** in a fresh Vite app set up with `shadcn init -b base`, `shadcn add` installs all five items from `dist/r`, the app type-checks under TypeScript 7, and the components render and behave. Tailwind projects declare the layer order once, so Caligo beats Tailwind's preflight reset and Tailwind utilities still override Caligo:\n\n ```css\n @layer theme, base, caligo, components, utilities;\n @import \"tailwindcss\";\n @import \"./components/caligo/styles/tokens.css\";\n @import \"./components/caligo/styles/foundation.css\";\n ```\n\n- **Script build fix:** Base UI's dialog and tooltip bundle CommonJS code that calls `require(\"react\")`. The IIFE build now resolves `react` and `react-dom` to the page's globals through `scripts/react-global.cjs` and `scripts/react-dom-global.cjs` instead of leaving them external.\n\nStill open from this phase:\n\n- **Focus checks in a visible browser window.** Focus and Escape across the two libraries pass in jsdom. The browser checks covered stacking and styles only, because the preview window had no focus.\n- **Checkbox `slotProps.input` isn't supported.** Base UI owns the hidden input; `inputRef`, `name`, `value`, `required` and `id` cover forms.\n- **Radio, RadioGroup and Switch are on Base UI too (17 November 2026, Plane battletest gap #25),** so the three\n choice controls compose the same way with Base UI's Field and Form. As with Checkbox, the element with the role\n (`radio`, `switch`) is the component's root, not a native input: read `aria-checked` in tests, not `.checked`.\n `slotProps.input`'s `aria-*`, `data-*` and `title` go to that element; `name`, `value`, `id` and `inputRef` reach\n Base UI's hidden input, and `onChange(event, …)` gets an event whose `target` is that input, so\n `event.target.checked` and `event.target.value` read as they do in Material UI. A Radio outside a RadioGroup is a\n group of one.\n- **Tooltip's `disableHoverListener`, `disableFocusListener` and `disableTouchListener` aren't supported.** Base UI's\n tooltip doesn't split its triggers; they are left out of the types rather than accepted and ignored. `followCursor`\n is supported (Base UI's cursor tracking), and `disabled` turns the tooltip off.\n- **Each registry item carries its own copy of the shared helpers and theme files.** A dependency between items needs the registry's hosted URL, which doesn't exist yet.\n\n### Phase 3: Port the free core — done (13 November 2026)\n\n- **Every free component is ported** to `src/` on Base UI, in seven committed groups (3a to 3g): field extras, overlays, feedback, navigation, surfaces and layout, tables and timelines, complex inputs, and brand pieces. `src/index.ts` exports 165 names; 25 of them are deprecated aliases that warn once in development.\n- **Material UI and MUI X APIs** where MUI has the component, including Autocomplete (`onChange(event, value, reason)`, `groupBy`, `freeSolo`, `renderInput` read from a TextField), the Table family, MUI Lab's Timeline, and MUI X's DateCalendar, DateRangeCalendar, DatePicker, DateRangePicker, TimePicker and SimpleTreeView. The pickers take plain `Date` values, like MUI X with AdapterDateFns.\n- **Caligo's own components** keep their names and follow the same rules: InputOTP, ColorPicker, CommandPalette, FileUpload, FileUploadDropzone, FileUploadItem, AvatarUpload, Carousel, Resizable, ScrollArea, AspectRatio, StatItem, StatsPanel, NotificationItem, ActivityFeed, ErrorPanel, Logo, SSOButton and AppStoreBadge.\n- **Error states follow the house rule.** Rejected files carry stable codes (`FU-101` too large, `FU-102` wrong type, `FU-103` too many) and a plain message; a failed upload shows its code under \"View more\". ActivityFeed and CommandPalette take an ErrorPanel for their error state.\n- **Conformance:** every exported component runs `describeConformance`, which now also checks that it reads default props from `CaligoProvider`. 1,031 tests pass, with axe on each component.\n- **`CaligoProvider`** sets default props per component, keyed `\"Button\"` or `\"MuiButton\"`, so a Material UI theme's `components` object can be reused. Own props win, then a ButtonGroup's, then the provider's. It also takes `localeText` (all 30 built-in strings), `locale` for the pickers, and `direction`. `useTheme` and `useMediaQuery` match Material UI's.\n- **Right to left:** component CSS uses logical properties, Badge and Switch mirror their transforms, direction-sensitive icons mirror, and arrow keys follow reading order in Tabs, Toolbar, the calendars, Resizable and the tree. Set `dir=\"rtl\"` on `<html>` or a wrapper; the provider's `direction` also reaches Base UI.\n- **Codemod:** `codemod/` (to publish as `@caligo-ui/codemod`; `npm run codemod -- <files>` here) applies the renames in section 2 and the prop changes in section 3, in JSX and in `h(C.Button, {…})` calls, inside `.js`, `.jsx`, `.ts`, `.tsx` and inline HTML scripts. It also wraps labelled switches in FormControlLabel and turns Card `title`/`description` into CardHeader and CardContent. Structural cases it can't rewrite safely (Accordion `items`, ListItem `leading`, Tree, ProgressSteps and others) are listed with line numbers, and keep working through their aliases. `examples/basic.html` migrates with nothing left to do by hand and renders on the new build with no warnings; `examples/basic-migrated.html` is the result.\n- **Generated API docs:** `npm run docs:api` writes `docs/api/` from the prop interfaces and their JSDoc, with defaults and deprecations. `npm test` fails when they're out of date (`test/api-docs.test.ts`, or `npm run docs:api:check`).\n- **Asset links:** in HTML the codemod also points `components/bundle.{js,css}` at `dist/global/caligo-ui.{js,css}` and drops the separate `tokens.css` link, since the tokens are inside. `--assets <folder or URL>` points them somewhere else, such as a CDN.\n- **Gallery:** `examples/components-next.html` shows every Phase 3 component in any theme.\n\nNot done in this phase:\n\n- **ThemeSwatches** stays a reference card, as its README says. It was never shipped in the bundle.\n- **DatePicker has no year or month view.** Months page with the arrows and PageUp/PageDown (Shift for years). The field types in the locale's order; MUI X's sectioned field isn't copied.\n- **Focus in a visible browser window** still needs a manual pass. Focus moves were checked in jsdom and in the hidden preview pane, which doesn't always paint.\n\n**Done when** every free component passes conformance and the codemod migrates `examples/basic.html` cleanly. Both are met.\n\n### Phase 4: Paid set and theme bridge — done (14 November 2026), except the admin steps below\n\n- Port the chat and AI set, DataTable and charts, behind a license key.\n- Build `createCaligoTheme()` so Material UI components in the same app match Caligo.\n- Build the app shells and templates, and line the Figma kit up with the shipped API.\n\n**Done when** the paid components pass conformance, an invalid or missing license key shows a clear notice in development, and the theme bridge styles a Material UI Button and Dialog to match.\n\nProgress (13 November 2026):\n\n- **Theme bridge — done.** `import { createCaligoTheme } from '@caligo-ui/core/mui'` returns a Material UI theme with every Caligo theme as a colour scheme, keyed by its name and read from the same `data-theme` attribute, so one switch changes both libraries. The palette uses resolved colours per theme (`scripts/extract-theme-values.mjs`), because Material UI does colour maths on it; Button and Dialog overrides read Caligo's variables directly. `@mui/material` is an optional peer dependency, used only by this entry. In the mixed-app page, a Material UI Button matches Caligo's height, radius, font, gradient, border and shadow, and a Material UI Dialog paper matches Caligo's radius, background, border and shadow, in light and dark (`test/mui-bridge.test.tsx`, `examples/mixed-app`; add `?bridge=0` to compare against Material UI's own look).\n- **License keys — done in code.** `LicenseInfo.setLicenseKey(key)` (`src/internal/license.ts`, exported from `@caligo-ui/core`) checks a signed key offline, with no call home. A key is `CAL1.<payload>.<signature>`: the payload holds the order, plan, `perpetual` or `subscription`, and an end date; the signature is Ed25519, and only the public key ships. A perpetual key covers every release dated up to its end date (pay once); a subscription works until its end date.\n - Paid components keep working without a key. They show a small corner notice whose \"View more\" gives the code, and log the reason once per code: `LIC-100` missing, `LIC-101` malformed, `LIC-102` bad signature, `LIC-103` release newer than a perpetual key covers, `LIC-104` subscription ended, `LIC-105` plan doesn't include the paid set.\n - Missing, malformed, forged and wrong-plan keys show the notice everywhere, as MUI X does. An expired subscription or a release past a perpetual key's end shows it in development only, so a live site never changes overnight. Browsers that can't check Ed25519 are treated as licensed, so paying customers are never nagged.\n - `scripts/license.mjs` makes the signing keypair (`keygen`, private key outside the repo), issues keys (`issue`), checks them (`check`) and stamps the release date (`stamp`). Tests sign with a throwaway keypair (`test/license.ts`).\n- **Paid set — done.** All ported to `src/` with conformance and axe tests, behind the license hook:\n - Chat and AI: ChatPanel, ChatMessageList, ChatBubble, ChatMessageGroup, Composer, ComposerInput, ToolCallCard, ReasoningCard, AgentStatusPanel, MultiAgentPanel, Trace, Questionnaire, ApprovalDialog, ArtifactCard, Attachment, SourceCard, PromptSuggestions, SuggestionChip, TypingIndicator, VoiceInputBar, ContextIndicator, ConversationItem, AISidebar. Trace and Questionnaire are new.\n - Data: DataGrid (MUI X DataGrid with the Pro and Premium features most asked for: column pinning, multi-sort, row and column virtualisation, column reordering, tree data, row grouping, aggregation, pinned rows, cell editing, CSV and print export), FilterBar, LineChart, BarChart, PieChart, RadarChart, Gauge, ActivityGauge, SparkLineChart, Heatmap, Treemap, SankeyChart, ChartsLegend, ChartsReferenceLine (dual axes, log scale, zoom and pan), Metrics, DashboardWidget, AnalyticsPanel. Every chart has a text summary, a data-table fallback, and keyboard reach to each point.\n - App shells: ApplicationPage, DashboardHeader, DashboardSidebar, SettingsPanel, NotificationCenter, UserProfilePanel, FileBrowser, SearchPanel, BillingSection, AuthPage, ErrorPage.\n - Page templates: Hero, CTA, FeatureGrid, FeatureComparison, Pricing, FAQ, Testimonials, LogoCloud, StatsSection, Team, Newsletter, Contact, Cover, Blog, BlogIndexPage, MarketingPage, ProductCard, ProductGrid, ProductDetail, CartSummary, CheckoutSection, CommercePage, with the item pieces (FeatureCard, PricingPlan, FAQItem, TestimonialCard, TeamMember, BlogPostCard, DeviceFrame) and MarketingSection free.\n - New and paid, from what people ask for (`docs/component-demand.md`): Scheduler (month, week, day, agenda, resources, recurring events), GanttChart (dependencies of all four types, 5,000 rows), Kanban (multi-select, WIP limits), DashboardGrid (per-breakpoint layouts).\n- **Free additions** (also from `docs/component-demand.md`): Menubar, NavigationMenu, AppBar, Sidebar, BottomNavigation, YearCalendar, MonthCalendar, DateField, TimeField, DateTimeField, DigitalClock, DateTimePicker, TimeRangePicker, DateTimeRangePicker, DurationField, FormWizard, PhoneField, MentionsInput, TreeSelect, QueryBuilder, RichTextEditor, EmojiPicker, VirtualList, VirtualGrid, SortableList, Tour, CodeBlock, JsonViewer, DiffViewer, VideoPlayer, PullToRefresh. DatePicker gained year and month views; Autocomplete and Select gained `virtualized`.\n- **Translations:** `CaligoProvider localeText` also takes component-keyed packs, `{ Composer: { sendLabel: 'Senden' }, DataGrid: { localeText: { … } } }`, merged one level deep. `enUS` (generated by `scripts/locale-pack.mjs` from the components' own defaults) lists every built-in English string, so a translation starts from a complete list.\n- **Codemod:** `Chat`, `Bubble`, `Header` and `DataTable` move to `ChatPanel`, `ChatBubble`, `AppBar` and `DataGrid`, with their prop changes; structural cases (AreaChart, MultiAgentPanel, page `type` props and others) are listed for hand edits.\n- **Errors** follow the house rule everywhere, with stable codes per stage: `CH-` (chat), `CHT-` (charts), `DG-`, `DW-`, `AP-`, `SCH-`, `GNT-`, `AUTH-`, `PG-`, `NC-`, `UP-`, `FB-`, `SR-`, `BIL-`, `NL-`, `CT-`, `CO-`, `FW-`, `MI-`, `RTE-`, `CODE-`, `JSON-`, `VID-`, `PTR-`, `LIC-`. `docs/error-codes.md` lists all 112 codes and where each is raised; `scripts/sync-components.mjs` regenerates it.\n- **Checked:** all tests pass, and the project type-checks. Each gallery (`examples/{chat,data,shells,marketing,time,inputs,content,components}-next.html`) was run through axe in the browser in six to ten themes; the contrast, label-in-name and focus findings were fixed. What's left is page-level structure in the demo pages themselves and a disabled field's label, which WCAG exempts.\n- **Second round (14 November 2026):**\n - DataGrid: master-detail (`getDetailPanelContent`, `getDetailPanelHeight` with `'auto'`, controlled `detailPanelExpandedRowIds`), row reordering by pointer and keyboard with announcements (`rowReordering`, `onRowOrderChange`), and `.xlsx` export with no dependencies (`exportDataAsExcel`, `DG-403`, `DG-404`).\n - Scheduler: a `timezone` prop and per-event zones, correct across DST changes, plus `rdate`, EXDATE and iCalendar recurrence lines (`SCH-103`, `SCH-104`). GanttChart: `lag` and lead on all four dependency types, and `autoSchedule` pushes successors along, stopping on a loop (`GNT-103`, `GNT-204`).\n - BarChart zooms and pans on its category axis like LineChart, through a shared `useAxisZoom`. Charts also gained two-finger pinch.\n - ChatMessageList virtualises past 100 messages, keeping stick-to-bottom, scroll position when older messages load, and screen reader announcements.\n - RichTextEditor tables (size picker, header row, add and remove rows and columns, Tab between cells, sanitised paste). PhoneField checks number ranges per country and reports `mobile` or `fixedLine`, with `validateOnBlur`.\n- **Third round (14 November 2026):** Scheduler reads and writes `.ics` files (`parseICalendar`, `toICalendar`, Import and Export in the toolbar, edited single occurrences as RECURRENCE-ID, Google and Outlook time zone names, `SCH-105` to `SCH-111`), and draws correctly when the browser's own zone changes clocks on the same day. RichTextEditor reads and writes Markdown with GFM tables (`format=\"markdown\"`, `getMarkdown`, `setMarkdown`, Markdown paste, `RTE-102`, `RTE-301`). Chart zoom announcements and summaries are translatable (`zoomAnnouncementText`, `zoomedSummaryText`). DataGrid detail rows count in `aria-rowcount` and `aria-rowindex`. A flaky license test was fixed: it tampered with the signature's last character, which holds padding bits.\n- **Bugs fixed along the way:** Drawer and Carousel slid the wrong way in right-to-left; the Accordion chevron never turned; Tooltip doubled its child's classes; inherit-coloured Buttons used `currentColor` through a variable; upcoming Stepper labels were faded to 1.7:1; the Google SSO blue was 3.6:1 with white (now Google's #1a73e8); moss's filled success badge was 4.2:1; several components read token names that don't exist.\n\nAdmin steps left for 72F (not code):\n\n1. **Make the signing keypair:** `node scripts/license.mjs keygen`. Until then the public key in `src/internal/license.ts` is empty and every key fails with `LIC-102`. Back the private key up; every issued license depends on it.\n2. **Publish the license page** the notices link to, `https://caligo.72fstudio.in/docs/license/#LIC-1xx`. It's written: `docs/guides/license.md` has one section per code (a test keeps it in step with `src/internal/license.ts`), and the docs site in the 72FStudio-site repo renders it. Add a contact address to its \"Still stuck\" section.\n3. **Plans.** Decided 15 November 2026: Caligo is sold per major version, one-time, on Polar: Pro v1 for one developer at $199, and Team v1 for up to five developers at $699; Enterprise by contact. No Figma tier: a Figma (or Penpot) kit is being reconsidered and may come later. A v1 key (`\"m\": 1` in its payload) covers every 1.x release and the 0.x previews, forever; 2.0 will be a new product and a paid upgrade (LIC-103 says so). The code still accepts `pro`, `team` and `enterprise`.\n4. **Keys at checkout — wired.** Polar's license-key benefit puts a Polar key on the receipt. The buyer swaps it for a Caligo key at `caligo.72fstudio.in/docs/get-key` (72FStudio-site: `lib/caligo-license.ts`, `app/api/caligo-license`), which checks the Polar key with Polar, maps its benefit to a major version, and signs with the Worker secret `CALIGO_LICENSE_SIGNING_KEY`. Failures have codes `CLK-100` to `CLK-302`. By hand: `node scripts/license.mjs issue --order <id> --major 1`. Run `stamp` when cutting each release; it sets the release's date and major version.\n5. **Confirm the package names and npm scope**: `@caligo-ui/core` (public, MIT) and `@caligo-ui/pro` (private). See [open-core.md](open-core.md) for where each is published.\n6. **Redraw the Figma kit** for the new components.\n\nNot done in this phase:\n\n- No manual pass yet with a real screen reader, touch device, IME (Japanese or Chinese input) or full screen / picture-in-picture. The automated checks pass, and these need hands.\n- The `.xlsx` export opens in LibreOffice; it hasn't been opened in Excel itself. The `.ics` export hasn't been through an outside validator or imported into Google Calendar or Outlook.\n- Scheduler: all-day and month cells still go by local dates, so a zone that skips midnight itself (Santiago, Havana) could put an all-day event on the wrong day. iCalendar `VALUE=PERIOD` dates, EXRULE, attendees and alarms are skipped on import, with a warning.\n- PhoneField can't tell mobile from landline in the US and Canada, Denmark or Mexico (their numbers don't encode it), and India's split is approximate.\n- RichTextEditor's Markdown drops what the editor can't hold: thematic breaks, code-fence languages, ordered-list start numbers, underline.\n\n### Phase 5: Launch and measure\n\n- Publish 1.0 to npm and the registry, and publish the Radix CSS layer and its recipes.\n- At checkout, ask \"How do you install Caligo?\" (npm, shadcn registry, Radix CSS, script tag), and record the answer with the license.\n- Track registry installs and npm downloads each week.\n\n**Done when** sales have been tracked by install method for three months.\n\n### Phase 6: shadcn-native — built early (14 and 15 November 2026)\n\nThe plan was to wait for three months of sales, and to build a shadcn-native version only if enough paid revenue came\nthrough the shadcn registry. 72F decided on 14 November 2026 to build it now, since its own apps will use it.\n\nWhat was built is the Tailwind build (`docs/tailwind.md`): Tailwind classes, class merging, Base UI and the same tokens,\nfor all 291 components. It is generated from the CSS build's source, so it is not a second codebase; that is why the\ncost that made this phase wait no longer applied.\n\n- **Part-based components** (`Dialog.Trigger`, `Dialog.Content`) were added the next day, for eleven components:\n the overlays, Tabs, Accordion and Collapsible (`docs/parts.md`). They are a second shape over the same classes, in\n their own entry (`@caligo-ui/core/parts`), so Material UI's API in the main entry is unchanged. The rest keep\n Material UI's props only.\n- **Still open: the measure.** Phase 5's question at checkout (\"How do you install Caligo?\") now has one more answer,\n the Tailwind registry, and still decides where effort goes next."
35984
36577
  },
35985
36578
  {
35986
36579
  "id": "tailwind",
@@ -36025,7 +36618,7 @@
36025
36618
  "id": "tailwind/how-it-is-checked",
36026
36619
  "title": "How it is checked",
36027
36620
  "file": "docs/tailwind.md",
36028
- "body": "- `test/tailwind.test.ts` covers the converter, the transform and the runtime, and converts every stylesheet.\n- The generated tree is type-checked (`tsconfig.tailwind.json`).\n- **Side by side in a browser.** `dist/parity/index.html` loads each gallery in `examples/` twice, once on each build,\n and compares the computed style of every element and its `::before` and `::after`, including transitions. On\n 15 November 2026 it found no differences: 32,070 elements across the eleven galleries, the same in both builds.\n It ignores only what can't be seen or isn't styling: the style and colour of a border with no width, the width of\n an outline with no style, a repeated value written once (`0.1s` for `0.1s, 0.1s`), and a value a component's\n script sets on the element itself, such as the Scheduler's now-line, which is placed from the clock.\n- **Hover, focus and pressed.** A script can't put the pointer on an element, so every rule that uses `:hover`,\n `:active`, `:focus`, `:focus-visible` or `:focus-within` gets a twin right after it with a class in the\n pseudo-class's place, in both builds alike. Setting that class on an element and its ancestors is the state. Two\n of each kind of element such a rule reaches are tried: 2,466 cases, no differences.\n- **The npm stylesheet against the script bundle's.** `?with=npm` puts the package's stylesheet on the right. The two\n CSS builds order their stylesheets differently, so this finds every rule that wins only by which file comes last.\n Same eleven galleries and the same states: no differences.\n\n- **Installed into a fresh app.** `npm run test:registry` scaffolds a new shadcn/ui app with the shadcn CLI, adds\n components from each registry through a `@caligo` name, as a user would, and runs that app's own build: its strict\n type-check, then its bundler. It needs the network, so it is run before publishing, not with the tests.\n\nThe comparisons found rules in the CSS that won only by where they sat, or that the package's stylesheet didn't\nhave at all. All are fixed in the source, so the CSS build no longer depends on order there either:\n\n- Icons in an input adornment inside an icon button, `Metrics` over `StatItem`, and the large `AppBar`'s padding over\n the narrow-screen rule before it (the first comparison).\n- A focused `Select` showed no ring whenever `TextField`'s stylesheet came last, which it did in the npm package.\n- A `DataGrid` cell lost its focus ring after a pinned column. The on-primary button in `MarketingSection` lost its\n pressed state.\n- The npm stylesheet left out the six shared stylesheets in `src/internal` (chat, code, pickers, time fields,\n right-to-left). `src/caligo.css` listed component folders; it is now assembled from the import graph, in the order\n the modules import their stylesheets. Before that, three galleries differed on 3,028 elements.\n- In the Tailwind build, a rule lifted over its equals overtook one that outranked it (a featured column's header in\n `FeatureComparison`), and a hovered `GanttChart` row tied across two classes. The converter settles lifts together\n now (\"How it is generated\").\n\n### What the first install found\n\nThe registries had never been installed into a real project. Doing it on 15 November 2026, into an app made with\n`shadcn init` (Vite, then Next.js; Base UI, the `nova` preset), turned up five things, all fixed:\n\n- **The CSS registry's items left out files.** They listed files by folder, which missed internal `.tsx` and `.css`\n files and stylesheets imported from another component, so an install didn't compile. Both registries now list\n exactly what each component reaches through its imports (`scripts/lib/reach.mjs`).\n- **Nine unused names in Caligo's source** failed the fresh app's type-check, which rejects unused locals and\n parameters. They are gone.\n- **One helper named Node's `process`** without declaring it, and a fresh Vite app has no Node types. It declares it\n now. The generated tree is type-checked the way a fresh app checks its own source (unused names are errors, no Node\n or test globals), so neither of these can come back unnoticed.\n- **No file said it was a client module.** Next.js only lets a module use hooks or context when it starts with\n `'use client'`, as shadcn/ui's own components do. Both registries now add it at build time to the modules that\n use React and leave plain helpers alone (`scripts/lib/client-directive.mjs`), and the Next.js test renders a\n Caligo Button from a server component. The directive went in before the first Next.js run, so the failure it\n prevents was not observed.\n- **shadcn's styles size their controls differently.** `nova` has 32px controls with the full radius, where Caligo's\n shadcn theme assumed 36px and the radius less 2px. Two variables now let an app say which it has\n (`docs/themes.md`); with them set, Caligo's buttons computed the same colours, radius, height and font as the\n app's own, in light and dark.\n\nAfter the fixes both registries install and build in a Vite app with the twenty-one components tried, from Button to\nDataGrid, Scheduler and ChatPanel, and in a Next.js app. In the Vite app the page renders in the app's theme with\nworking overlays; the Next.js app was built, not opened. Run again on 15 November 2026 with the one-file stylesheet\nand the parts (`caligo-parts`, rendered from a server component in the Next.js app): both registries in Vite and in\nNext.js, and the packed npm package in Next.js, all built."
36621
+ "body": "- `test/tailwind.test.ts` covers the converter, the transform and the runtime, and converts every stylesheet.\n- The generated tree is type-checked (`tsconfig.tailwind.json`).\n- **Side by side in a browser.** `dist/parity/index.html` loads each gallery in `examples/` twice, once on each build,\n and compares the computed style of every element and its `::before` and `::after`, including transitions. On\n 15 November 2026 it found no differences: 32,070 elements across the eleven galleries, the same in both builds.\n It ignores only what can't be seen or isn't styling: the style and colour of a border with no width, the width of\n an outline with no style, a repeated value written once (`0.1s` for `0.1s, 0.1s`), and a value a component's\n script sets on the element itself, such as the Scheduler's now-line, which is placed from the clock.\n- **Hover, focus and pressed.** A script can't put the pointer on an element, so every rule that uses `:hover`,\n `:active`, `:focus`, `:focus-visible` or `:focus-within` gets a twin right after it with a class in the\n pseudo-class's place, in both builds alike. Setting that class on an element and its ancestors is the state. Two\n of each kind of element such a rule reaches are tried: 2,466 cases, no differences.\n- **The npm stylesheet against the script bundle's.** `?with=npm` puts the package's stylesheet on the right. The two\n CSS builds order their stylesheets differently, so this finds every rule that wins only by which file comes last.\n Same eleven galleries and the same states: no differences.\n- **Since the open-core split, only the core galleries.** Ten galleries show Caligo Pro components and load Pro's\n script build (`packages/pro/dist/global`), which has no Tailwind twin, so the side-by-side check now covers the\n three on the core build: `button-next`, `parts-next` and `pilot-next`. The figures above are from before the split.\n Order ties across stylesheets, which the npm comparison found, are also caught without a browser for core and Pro\n alike by `test/override-ties.test.ts`.\n\n- **Installed into a fresh app.** `npm run test:registry` scaffolds a new shadcn/ui app with the shadcn CLI, adds\n components from each registry through a `@caligo` name, as a user would, and runs that app's own build: its strict\n type-check, then its bundler. It needs the network, so it is run before publishing, not with the tests.\n\nThe comparisons found rules in the CSS that won only by where they sat, or that the package's stylesheet didn't\nhave at all. All are fixed in the source, so the CSS build no longer depends on order there either:\n\n- Icons in an input adornment inside an icon button, `Metrics` over `StatItem`, and the large `AppBar`'s padding over\n the narrow-screen rule before it (the first comparison).\n- A focused `Select` showed no ring whenever `TextField`'s stylesheet came last, which it did in the npm package.\n- A `DataGrid` cell lost its focus ring after a pinned column. The on-primary button in `MarketingSection` lost its\n pressed state.\n- The npm stylesheet left out the six shared stylesheets in `src/internal` (chat, code, pickers, time fields,\n right-to-left). `src/caligo.css` listed component folders; it is now assembled from the import graph, in the order\n the modules import their stylesheets. Before that, three galleries differed on 3,028 elements.\n- In the Tailwind build, a rule lifted over its equals overtook one that outranked it (a featured column's header in\n `FeatureComparison`), and a hovered `GanttChart` row tied across two classes. The converter settles lifts together\n now (\"How it is generated\").\n\n### What the first install found\n\nThe registries had never been installed into a real project. Doing it on 15 November 2026, into an app made with\n`shadcn init` (Vite, then Next.js; Base UI, the `nova` preset), turned up five things, all fixed:\n\n- **The CSS registry's items left out files.** They listed files by folder, which missed internal `.tsx` and `.css`\n files and stylesheets imported from another component, so an install didn't compile. Both registries now list\n exactly what each component reaches through its imports (`scripts/lib/reach.mjs`).\n- **Nine unused names in Caligo's source** failed the fresh app's type-check, which rejects unused locals and\n parameters. They are gone.\n- **One helper named Node's `process`** without declaring it, and a fresh Vite app has no Node types. It declares it\n now. The generated tree is type-checked the way a fresh app checks its own source (unused names are errors, no Node\n or test globals), so neither of these can come back unnoticed.\n- **No file said it was a client module.** Next.js only lets a module use hooks or context when it starts with\n `'use client'`, as shadcn/ui's own components do. Both registries now add it at build time to the modules that\n use React and leave plain helpers alone (`scripts/lib/client-directive.mjs`), and the Next.js test renders a\n Caligo Button from a server component. The directive went in before the first Next.js run, so the failure it\n prevents was not observed.\n- **shadcn's styles size their controls differently.** `nova` has 32px controls with the full radius, where Caligo's\n shadcn theme assumed 36px and the radius less 2px. Two variables now let an app say which it has\n (`docs/themes.md`); with them set, Caligo's buttons computed the same colours, radius, height and font as the\n app's own, in light and dark.\n\nAfter the fixes both registries install and build in a Vite app with the twenty-one components tried, from Button to\nDataGrid, Scheduler and ChatPanel, and in a Next.js app. In the Vite app the page renders in the app's theme with\nworking overlays; the Next.js app was built, not opened. Run again on 15 November 2026 with the one-file stylesheet\nand the parts (`caligo-parts`, rendered from a server component in the Next.js app): both registries in Vite and in\nNext.js, and the packed npm package in Next.js, all built."
36029
36622
  },
36030
36623
  {
36031
36624
  "id": "tailwind/commands",
@@ -36043,7 +36636,7 @@
36043
36636
  "id": "parts",
36044
36637
  "title": "Parts",
36045
36638
  "file": "docs/parts.md",
36046
- "body": "Caligo's components follow Material UI: one component with props, such as `<Dialog open onClose>`. Eleven of them also\ncome as parts, the shape shadcn/ui and Base UI use: `Dialog.Root`, `Dialog.Trigger`, `Dialog.Content`. A part-based\ncomponent keeps its own open state, its trigger is a part of it, and you compose the rest.\n\nBoth are the same Caligo. The parts carry the same class names as the main components, so the same stylesheets, tokens\nand themes style them, and they exist in the CSS build and in the Tailwind build alike. Use whichever reads better in\nthe code around it; the two can sit in one app.\n\n```tsx\nimport { Dialog } from '@caligo-ui/core/parts';\nimport { Button, TextField } from '@caligo-ui/core';\n\n<Dialog.Root>\n <Dialog.Trigger render={<Button variant=\"outlined\" />}>Edit profile</Dialog.Trigger>\n <Dialog.Content>\n <Dialog.Header>\n <Dialog.Title>Edit profile</Dialog.Title>\n <Dialog.Description>Changes are saved when you press Save.</Dialog.Description>\n </Dialog.Header>\n <Dialog.Body>\n <TextField label=\"Name\" fullWidth />\n </Dialog.Body>\n <Dialog.Footer>\n <Dialog.Close render={<Button variant=\"text\" color=\"inherit\" />}>Cancel</Dialog.Close>\n <Button variant=\"contained\">Save</Button>\n </Dialog.Footer>\n </Dialog.Content>\n</Dialog.Root>\n```",
36639
+ "body": "Caligo's components follow Material UI: one component with props, such as `<Dialog open onClose>`. Sixteen families also\ncome as parts, the shape shadcn/ui and Base UI use: `Dialog.Root`, `Dialog.Trigger`, `Dialog.Content`. A part-based\ncomponent keeps its own open state, its trigger is a part of it, and you compose the rest.\n\nBoth are the same Caligo. The parts carry the same class names as the main components, so the same stylesheets, tokens\nand themes style them, and they exist in the CSS build and in the Tailwind build alike. Use whichever reads better in\nthe code around it; the two can sit in one app.\n\n```tsx\nimport { Dialog } from '@caligo-ui/core/parts';\nimport { Button, TextField } from '@caligo-ui/core';\n\n<Dialog.Root>\n <Dialog.Trigger render={<Button variant=\"outlined\" />}>Edit profile</Dialog.Trigger>\n <Dialog.Content>\n <Dialog.Header>\n <Dialog.Title>Edit profile</Dialog.Title>\n <Dialog.Description>Changes are saved when you press Save.</Dialog.Description>\n </Dialog.Header>\n <Dialog.Body>\n <TextField label=\"Name\" fullWidth />\n </Dialog.Body>\n <Dialog.Footer>\n <Dialog.Close render={<Button variant=\"text\" color=\"inherit\" />}>Cancel</Dialog.Close>\n <Button variant=\"contained\">Save</Button>\n </Dialog.Footer>\n </Dialog.Content>\n</Dialog.Root>\n```",
36047
36640
  "sections": [
36048
36641
  "parts/getting-them",
36049
36642
  "parts/what-there-is",
@@ -36064,7 +36657,7 @@
36064
36657
  "id": "parts/what-there-is",
36065
36658
  "title": "What there is",
36066
36659
  "file": "docs/parts.md",
36067
- "body": "| Family | Parts | Built on |\n|---|---|---|\n| `Dialog` | `Root`, `Trigger`, `Content`, `Header`, `Title`, `Description`, `Body`, `Footer`, `Close` | Base UI's Dialog, with `Dialog`'s classes |\n| `AlertDialog` | the same, and `Cancel` and `Action` | Base UI's AlertDialog: `role=\"alertdialog\"`, and a click outside doesn't close it |\n| `Drawer` (also `Sheet`) | the same as `Dialog` | Base UI's Dialog, with the temporary `Drawer`'s classes |\n| `Popover` | `Root`, `Trigger`, `Content`, `Title`, `Description`, `Close` | Base UI's Popover, with `Popover`'s classes |\n| `Tooltip` | `Provider`, `Root`, `Trigger`, `Content` | Base UI's Tooltip, with `Tooltip`'s classes |\n| `PreviewCard` (also `HoverCard`) | `Root`, `Trigger`, `Content` | Base UI's PreviewCard, with `PreviewCard`'s classes |\n| `Menu` (also `DropdownMenu`) | `Root`, `Trigger`, `Content`, `Item`, `Group`, `Label`, `Separator` | Base UI's Menu, with `Menu`'s classes; `Item` is `MenuItem`, `Separator` is `Divider` |\n| `ContextMenu` | `Root`, `Trigger`, `Content`, `Item`, `Group`, `Label`, `Separator` | Base UI's ContextMenu, with `Menu`'s classes |\n| `Tabs` | `Root`, `List`, `Trigger`, `Content` | Caligo's `Tabs`, `Tab` and `TabPanel` |\n| `Accordion` | `Root`, `Item`, `Trigger`, `Content` | Caligo's `Accordion`, `AccordionSummary` and `AccordionDetails` |\n| `Collapsible` | `Root`, `Trigger`, `Content` | Caligo's `Collapse` |\n\nThe names are shadcn/ui's (`Content`, `Trigger`, `Header`, `Footer`), and three families have its name as well as\nCaligo's: `DropdownMenu`, `HoverCard`, `Sheet`. The props of a `Root` are Base UI's (`open`, `defaultOpen`,\n`onOpenChange`; `value`, `defaultValue`, `onValueChange` for `Tabs` and `Accordion`)."
36660
+ "body": "| Family | Parts | Built on |\n|---|---|---|\n| `Dialog` | `Root`, `Trigger`, `Content`, `Header`, `Title`, `Description`, `Body`, `Footer`, `Close` | Base UI's Dialog, with `Dialog`'s classes |\n| `AlertDialog` | the same, and `Cancel` and `Action` | Base UI's AlertDialog: `role=\"alertdialog\"`, and a click outside doesn't close it |\n| `Drawer` (also `Sheet`) | the same as `Dialog` | Base UI's Dialog, with the temporary `Drawer`'s classes |\n| `Popover` | `Root`, `Trigger`, `Content`, `Title`, `Description`, `Close` | Base UI's Popover, with `Popover`'s classes |\n| `Tooltip` | `Provider`, `Root`, `Trigger`, `Content` | Base UI's Tooltip, with `Tooltip`'s classes |\n| `PreviewCard` (also `HoverCard`) | `Root`, `Trigger`, `Content` | Base UI's PreviewCard, with `PreviewCard`'s classes |\n| `Menu` (also `DropdownMenu`) | `Root`, `Trigger`, `Content`, `Item`, `CheckboxItem`, `RadioGroup`, `RadioItem`, `LinkItem`, `Submenu`, `SubmenuTrigger`, `SubmenuContent`, `Group`, `Label`, `Separator` | Base UI's Menu, with `Menu`'s classes; `Item` is `MenuItem`, `Separator` is `Divider` |\n| `ContextMenu` | `Root`, `Trigger`, `Content`, and every item kind `Menu` has | Base UI's ContextMenu, with `Menu`'s classes |\n| `Select` | `Root`, `Trigger`, `Value`, `Icon`, `Content`, `Item`, `Group`, `Label`, `Separator` | Base UI's Select, with `Select`'s field and `MenuItem` rows; give `Root` `items` so `Value` shows labels |\n| `Combobox` | `Root`, `Input`, `Trigger`, `Value`, `Content`, `Search`, `List`, `Item`, `Empty`, `Group`, `Label`, `Separator` | Base UI's Combobox, with the same field and rows; `Input` types to filter, or `Trigger` opens a list with a `Search` box. Pro's `Combobox` and `Autocomplete` add chips, async loading and virtualised lists |\n| `Toolbar` | `Root`, `Group`, `Button`, `Toggle`, `Link`, `Input`, `Separator` | Base UI's Toolbar (one tab stop, arrow keys), drawn as Caligo's grouped `Toolbar`; a `Toggle` rises to the key level while on |\n| `Toast` | `Provider`, `Toaster`, `Viewport`, `Root`, `Title`, `Description`, `Action`, `Close`, `useToastManager`, `createToastManager` | Base UI's Toast: a managed queue that stacks, times out, swipes away and announces; `Toaster` draws each toast as an outlined `Alert` |\n| `Breadcrumb` | `Root`, `List`, `Item`, `Link`, `Page`, `Separator`, `Ellipsis` | Plain elements with `Breadcrumbs`' classes |\n| `Tabs` | `Root`, `List`, `Trigger`, `Content` | Caligo's `Tabs`, `Tab` and `TabPanel` |\n| `Accordion` | `Root`, `Item`, `Trigger`, `Content` | Caligo's `Accordion`, `AccordionSummary` and `AccordionDetails` |\n| `Collapsible` | `Root`, `Trigger`, `Content` | Caligo's `Collapse` |\n\nThe names are shadcn/ui's (`Content`, `Trigger`, `Header`, `Footer`), and three families have its name as well as\nCaligo's: `DropdownMenu`, `HoverCard`, `Sheet`. The props of a `Root` are Base UI's (`open`, `defaultOpen`,\n`onOpenChange`; `value`, `defaultValue`, `onValueChange` for `Tabs` and `Accordion`)."
36068
36661
  },
36069
36662
  {
36070
36663
  "id": "parts/how-they-behave",
@@ -36082,7 +36675,7 @@
36082
36675
  "id": "parts/styling",
36083
36676
  "title": "Styling",
36084
36677
  "file": "docs/parts.md",
36085
- "body": "There is nothing new to learn. `Dialog.Content`'s surface is `.CaligoDialog-paper`, a `Menu.Item` is\n`.CaligoMenuItem-root`, and every token and theme applies, `data-theme=\"shadcn\"` included. In the Tailwind build a\nclass you pass wins over Caligo's for the same property: `<Popover.Content className=\"p-2 w-72\">`.\n\nThree small rules were added for the parts, in the main components' stylesheets, so both builds have them:\n`.CaligoDialogHeader-root` (the header), `.CaligoPopover-content` (the popover's padding) and `.CaligoMenu-label`\n(a group's heading)."
36678
+ "body": "There is nothing new to learn. `Dialog.Content`'s surface is `.CaligoDialog-paper`, a `Menu.Item` is\n`.CaligoMenuItem-root`, and every token and theme applies, `data-theme=\"shadcn\"` included. In the Tailwind build a\nclass you pass wins over Caligo's for the same property: `<Popover.Content className=\"p-2 w-72\">`.\n\nA few small rules were added for the parts, in the main components' stylesheets, so both builds have them:\n`.CaligoDialogHeader-root` (the header), `.CaligoPopover-content` (the popover's padding), `.CaligoMenu-label`\n(a group's heading), and in `Menu.css` the marks of checkbox and radio items (`.CaligoMenuItem-mark`, drawn rather\nthan nested Checkbox and Radio controls, so the item is the one thing focus lands on) and a submenu's chevron."
36086
36679
  },
36087
36680
  {
36088
36681
  "id": "parts/how-they-are-checked",
@@ -36094,7 +36687,7 @@
36094
36687
  "id": "parts/not-done",
36095
36688
  "title": "Not done",
36096
36689
  "file": "docs/parts.md",
36097
- "body": "- **Select, Checkbox, Switch, RadioGroup and Slider as parts.** Caligo's `Select` already takes `MenuItem` children,\n and the others are single elements with props in shadcn/ui too.\n- **Checkbox items, radio items and submenus in a menu.** Base UI has them; Caligo has no styles for their marks yet.\n- **`NavigationMenu`, `Menubar`, `Combobox` and `Command` as parts.** They exist as main components."
36690
+ "body": "- **Checkbox, Switch, RadioGroup and Slider as parts.** They are single elements with props in shadcn/ui too.\n- **`NavigationMenu`, `Menubar` and `Command` as parts.** They exist as main components (Pro)."
36098
36691
  },
36099
36692
  {
36100
36693
  "id": "component-tokens",
@@ -36140,7 +36733,9 @@
36140
36733
  "component-tokens/scroll-area",
36141
36734
  "component-tokens/notification-badge",
36142
36735
  "component-tokens/app-store-badge",
36143
- "component-tokens/group-item"
36736
+ "component-tokens/group-item",
36737
+ "component-tokens/layout-hooks",
36738
+ "component-tokens/density"
36144
36739
  ]
36145
36740
  },
36146
36741
  {
@@ -36377,6 +36972,18 @@
36377
36972
  "file": "docs/component-tokens.md",
36378
36973
  "body": "| Token | Value |\n|---|---|\n| `--cal-group-item-gap-sm` | `spacing-10` |\n| `--cal-group-item-gap-md` | `spacing-12` |"
36379
36974
  },
36975
+ {
36976
+ "id": "component-tokens/layout-hooks",
36977
+ "title": "layout hooks",
36978
+ "file": "docs/component-tokens.md",
36979
+ "body": "Not declared in `components/bundle.css`: each is read with today's value as its fallback, so set one only to change it.\n\n| Token | Default | |\n|---|---|---|\n| `--cal-dialog-width-xs` … `--cal-dialog-width-xl` | 444 / 600 / 900 / 1200 / 1536px | Dialog `maxWidth` |\n| `--cal-list-item-gutter` | 16px | The side padding of list rows, items and subheaders |\n| `--cal-tabs-track-padding` | 4px | The gap between the pill tabs' track and its segments |\n| `--cal-field-label-width` | a third of the field | The label column of a TextField with `orientation=\"horizontal\"` |"
36980
+ },
36981
+ {
36982
+ "id": "component-tokens/density",
36983
+ "title": "density",
36984
+ "file": "docs/component-tokens.md",
36985
+ "body": "`data-density=\"compact\"` on `<html>` or any container makes every control a step smaller together, for dense product\nUIs. Each value below is a token the components read with the default as the fallback, so an app can also set one alone.\n\n| Token | Default | Compact |\n|---|---|---|\n| `--cal-button-height-xs` … `-lg` | 28 / 32 / 40 / 48px | 20 / 24 / 28 / 32px |\n| `--cal-button-font-size-xs` … `-lg` | 12 / 12 / 14 / 16px | 12 / 12 / 13 / 14px |\n| `--cal-input-height-xs` … `-lg` | 28 / 32 / 40 / 48px | 24 / 28 / 32 / 36px |\n| `--cal-input-font-size` | 14px | 13px |\n| `--cal-field-label-font-size` | 14px (TextField's and FormLabel's labels) | 13px |\n| `--cal-toggle-height-sm` … `-lg` | 32 / 36 / 40px | 24 / 28 / 32px |\n| `--cal-toggle-padding-x-sm`, `-md`; `--cal-toggle-font-size`, `-sm` | 12, 14px; 14, 13px | 8, 10px; 13, 12px |\n| `--cal-tabs-font-size`; `--cal-tabs-padding-y-md`, `-x-md`; `--cal-tabs-track-padding` | 14px; 8, 12px; 4px | 13px; 1, 10px; 2px |\n| `--cal-menu-item-height`, `-padding-y`, `-font-size` | 32px, 6px, 14px | 28px, 4px, 13px |\n| `--cal-list-item-height`, `-padding-y`, `-font-size` | 36px, 6px, 14px | 28px, 4px, 13px |\n| `--cal-table-cell-padding-y`, `-y-sm` | 12px, 8px | 8px, 4px |\n\nButton padding, gap and icon size, and field padding, follow too (`--cal-button-padding-x-*`, `--cal-button-gap-*`,\n`--cal-button-icon-size-*`, `--cal-input-padding-x-*`). `previews/elevation.html?density=compact` shows it."
36986
+ },
36380
36987
  {
36381
36988
  "id": "component-demand",
36382
36989
  "title": "What people ask for (November 2026)",
@@ -36403,7 +37010,7 @@
36403
37010
  "id": "error-codes",
36404
37011
  "title": "Error codes",
36405
37012
  "file": "docs/error-codes.md",
36406
- "body": "Generated by `scripts/error-codes.mjs`. Every failure a person can see has its own stable code (the house error rule). Codes never change meaning and are never reused.\n\n| Code | Raised in | Defined at |\n|---|---|---|\n| `AP-101` | AnalyticsPanel | `src/AnalyticsPanel/AnalyticsPanel.tsx:44`: `/** The error state. 'true' uses code AP-101. */` |\n| `AUTH-100` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:44`: `* listed keeps its own value and shows the stage's fallback text ('AUTH-100', '-200', '-300', '-350', '-400').` |\n| `AUTH-101` | AuthPage, internal, locale | `src/AuthPage/AuthPage.tsx:47`: `signInFailed: 'AUTH-100', wrongCredentials: 'AUTH-101', accountLocked: 'AUTH-102', emailNotVerified: 'AUTH-103',` |\n| `AUTH-102` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:47`: `signInFailed: 'AUTH-100', wrongCredentials: 'AUTH-101', accountLocked: 'AUTH-102', emailNotVerified: 'AUTH-103',` |\n| `AUTH-103` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:47`: `signInFailed: 'AUTH-100', wrongCredentials: 'AUTH-101', accountLocked: 'AUTH-102', emailNotVerified: 'AUTH-103',` |\n| `AUTH-200` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:48`: `signUpFailed: 'AUTH-200', emailTaken: 'AUTH-201', passwordRejected: 'AUTH-202',` |\n| `AUTH-201` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:48`: `signUpFailed: 'AUTH-200', emailTaken: 'AUTH-201', passwordRejected: 'AUTH-202',` |\n| `AUTH-202` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:48`: `signUpFailed: 'AUTH-200', emailTaken: 'AUTH-201', passwordRejected: 'AUTH-202',` |\n| `AUTH-300` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:49`: `resetRequestFailed: 'AUTH-300', resetEmailNotSent: 'AUTH-301',` |\n| `AUTH-301` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:49`: `resetRequestFailed: 'AUTH-300', resetEmailNotSent: 'AUTH-301',` |\n| `AUTH-350` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:50`: `resetFailed: 'AUTH-350', resetLinkExpired: 'AUTH-351',` |\n| `AUTH-351` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:50`: `resetFailed: 'AUTH-350', resetLinkExpired: 'AUTH-351',` |\n| `AUTH-400` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-401` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-402` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-403` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-501` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:52`: `ssoFailed: 'AUTH-501', ssoCancelled: 'AUTH-502',` |\n| `AUTH-502` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:52`: `ssoFailed: 'AUTH-501', ssoCancelled: 'AUTH-502',` |\n| `AUTH-901` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:53`: `network: 'AUTH-901', rateLimited: 'AUTH-902',` |\n| `AUTH-902` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:53`: `network: 'AUTH-901', rateLimited: 'AUTH-902',` |\n| `BAL-101` | BalanceCard, locale | `src/BalanceCard/BalanceCard.tsx:29`: `export const BALANCE_CARD_CODES = { loadFailed: 'BAL-101' } as const;` |\n| `BIL-101` | BillingSection, locale | `src/BillingSection/BillingSection.tsx:48`: `export const BILLING_CODES = { loadFailed: 'BIL-101', invoiceDownloadFailed: 'BIL-102', paymentFailed: 'BIL-103' } as const;` |\n| `BIL-102` | BillingSection, locale | `src/BillingSection/BillingSection.tsx:48`: `export const BILLING_CODES = { loadFailed: 'BIL-101', invoiceDownloadFailed: 'BIL-102', paymentFailed: 'BIL-103' } as const;` |\n| `BIL-103` | BillingSection, locale | `src/BillingSection/BillingSection.tsx:48`: `export const BILLING_CODES = { loadFailed: 'BIL-101', invoiceDownloadFailed: 'BIL-102', paymentFailed: 'BIL-103' } as const;` |\n| `CF-101` | CopyField | `src/CopyField/CopyField.tsx:22`: `/** Why, for CF-101: the page has no clipboard access at all. */` |\n| `CF-102` | CopyField | `src/CopyField/CopyField.tsx:24`: `/** Why, for CF-102: the browser refused the write. */` |\n| `CH-201` | ApprovalDialog, ChatMessageGroup, ToolCallCard, Trace, internal | `src/ApprovalDialog/ApprovalDialog.tsx:45`: `/** Why a copy failed, under \"View more\" (code CH-201). */` |\n| `CH-202` | ChatBubble, ChatMessageList, internal | `src/ChatBubble/ChatBubble.tsx:38`: `* this, or with a plain default and code CH-202.` |\n| `CH-301` | ChatMessageList, internal | `src/ChatMessageList/ChatMessageListImpl.tsx:70`: `/** A failure to show under the messages, in the house error pattern. Default code CH-301. */` |\n| `CH-401` | ToolCallCard | `src/ToolCallCard/ToolCallCard.tsx:46`: `/** What failed, shown with the house error pattern when 'status=\"error\"'. Default code CH-401. */` |\n| `CH-402` | ReasoningCard | `src/ReasoningCard/ReasoningCard.tsx:27`: `/** Shown with the house error pattern when 'status=\"error\"'. Default code CH-402. */` |\n| `CH-403` | AgentStatusPanel | `src/AgentStatusPanel/AgentStatusPanel.tsx:53`: `/** Shown with the house error pattern when 'status=\"error\"'. Default code CH-403. */` |\n| `CH-404` | MultiAgentPanel | `src/MultiAgentPanel/MultiAgentPanel.tsx:23`: `/** Shown with the house error pattern when the agent failed. Default code CH-404. */` |\n| `CH-405` | Trace | `src/Trace/Trace.tsx:31`: `/** Shown with the house error pattern when the span failed. Default code CH-405. */` |\n| `CH-406` | VoiceInputBar | `src/VoiceInputBar/VoiceInputBar.tsx:23`: `/** Shown with the house error pattern when 'status=\"error\"'. Default code CH-406. */` |\n| `CH-407` | Questionnaire | `src/Questionnaire/Questionnaire.tsx:45`: `/** Sending the answers failed. Shown with the house error pattern. Default code CH-407. */` |\n| `CH-408` | ApprovalDialog | `src/ApprovalDialog/ApprovalDialog.tsx:61`: `/** The decision couldn't be sent, for example. Shown with the house error pattern. Default code CH-408. */` |\n| `CH-409` | AISidebar | `src/AISidebar/AISidebar.tsx:50`: `/** Shown with the house error pattern instead of the list. Default code CH-409. */` |\n| `CHG-101` | Changelog, locale | `src/Changelog/Changelog.tsx:46`: `export const CHANGELOG_CODES = { loadFailed: 'CHG-101', loadMoreFailed: 'CHG-102' } as const;` |\n| `CHG-102` | Changelog, locale | `src/Changelog/Changelog.tsx:46`: `export const CHANGELOG_CODES = { loadFailed: 'CHG-101', loadMoreFailed: 'CHG-102' } as const;` |\n| `CHT-101` | ChartsLegend | `src/ChartsLegend/chartCore.tsx:457`: `/** A stable code for the stage that failed. @default 'CHT-101' */` |\n| `CHT-102` | ActivityGauge, BarChart, Heatmap, LineChart, PieChart, RadarChart, SankeyChart | `src/ActivityGauge/ActivityGauge.tsx:127`: `dataProblem={problems.length ? { code: 'CHT-102', detail: problems.join('; ') } : null}` |\n| `CHT-103` | SankeyChart | `src/SankeyChart/SankeyChart.tsx:235`: `dataProblem={layout.cyclic ? { code: 'CHT-103', detail: 'links form a loop' } : problems.length ? { code: 'CHT-102', detail: problems.join('` |\n| `CLI-101` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:30`: `'CLI-101': { headline: 'Unknown command', description: 'Run caligo --help to see the commands.' },` |\n| `CLI-102` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:31`: `'CLI-102': { headline: 'Unknown option', description: 'Run caligo <command> --help to see its options.' },` |\n| `CLI-103` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:32`: `'CLI-103': { headline: 'Something is missing', description: 'This command needs an argument. Run caligo <command> --help.' },` |\n| `CLI-104` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:33`: `'CLI-104': { headline: 'That value won\\'t work here', description: 'Run caligo <command> --help to see the values it takes.' },` |\n| `CLI-201` | cli/api.mjs | `cli/api.mjs:34`: `'CLI-201': { headline: 'No component by that name', description: 'Check the spelling, or search: caligo search <words>.' },` |\n| `CLI-202` | cli/api.mjs | `cli/api.mjs:35`: `'CLI-202': { headline: 'No docs topic by that name', description: 'Run caligo docs to list the topics.' },` |\n| `CLI-203` | cli/api.mjs | `cli/api.mjs:36`: `'CLI-203': { headline: 'Nothing matched', description: 'Try fewer or plainer words, such as \"table\" or \"sign in\".' },` |\n| `CLI-204` | cli/api.mjs | `cli/api.mjs:37`: `'CLI-204': { headline: 'No tokens matched', description: 'Try a group (color, spacing, radius, shadow, type) or a word from a token name.' }` |\n| `CLI-301` | cli/api.mjs | `cli/api.mjs:38`: `'CLI-301': { headline: 'File not found', description: 'Check the path. caligo check takes .tsx, .jsx, .ts and .js files.' },` |\n| `CLI-302` | cli/api.mjs, cli/check.mjs | `cli/api.mjs:39`: `'CLI-302': { headline: 'File doesn\\'t parse', description: 'Fix the syntax error first; check reads the file as TSX.' },` |\n| `CLI-401` | cli/api.mjs | `cli/api.mjs:40`: `'CLI-401': { headline: 'Not in a project', description: 'Run caligo init in the folder that holds your package.json.' },` |\n| `CLI-402` | cli/api.mjs | `cli/api.mjs:41`: `'CLI-402': { headline: 'Couldn\\'t write the file', description: 'Check that the folder is writable, then run caligo init again.' },` |\n| `CLI-403` | cli/api.mjs | `cli/api.mjs:42`: `'CLI-403': { headline: 'The Caligo block in this file is damaged', description: 'It has one of the CALIGO markers but not the other. Remove ` |\n| `CLI-901` | cli/api.mjs | `cli/api.mjs:43`: `'CLI-901': { headline: 'Caligo\\'s docs index is missing', description: 'Reinstall @caligo-ui/core. If you work on Caligo itself, run npm run docs` |\n| `CLI-902` | cli/api.mjs | `cli/api.mjs:44`: `'CLI-902': { headline: 'Caligo\\'s docs index can\\'t be read', description: 'Reinstall @caligo-ui/core. If you work on Caligo itself, run npm run ` |\n| `CLI-903` | cli/api.mjs | `cli/api.mjs:45`: `'CLI-903': { headline: 'This CLI is older than its docs index', description: 'Update @caligo-ui/core so the CLI and the index match.' },` |\n| `CLI-999` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:46`: `'CLI-999': { headline: 'The Caligo CLI hit a bug', description: 'Run the command again with --verbose and send the output to the Caligo team` |\n| `CMT-101` | CommentThread, locale | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CMT-201` | CommentThread | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CMT-202` | CommentThread | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CMT-203` | CommentThread | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CO-201` | CheckoutSection | `src/CheckoutSection/CheckoutSection.tsx:21`: `offline: 'CO-201',` |\n| `CO-202` | CheckoutSection | `src/CheckoutSection/CheckoutSection.tsx:23`: `rejected: 'CO-202',` |\n| `CO-203` | CheckoutSection | `src/CheckoutSection/CheckoutSection.tsx:25`: `timeout: 'CO-203',` |\n| `CODE-101` | CodeBlock | `src/CodeBlock/CodeBlock.tsx:362`: `code={failure.kind === 'unavailable' ? 'CODE-101' : 'CODE-102'}` |\n| `CODE-102` | CodeBlock | `src/CodeBlock/CodeBlock.tsx:362`: `code={failure.kind === 'unavailable' ? 'CODE-101' : 'CODE-102'}` |\n| `CODE-103` | CodeBlock | `src/CodeBlock/CodeBlock.tsx:196`: `// CODE-103: the app's highlighter threw. Fall back to the built-in tokenizer and tell the developer.` |\n| `CRM-101` | ContactRecord, locale | `src/ContactRecord/ContactRecord.tsx:33`: `export const CONTACT_RECORD_CODES = { loadFailed: 'CRM-101', saveFailed: 'CRM-102' } as const;` |\n| `CRM-102` | ContactRecord, locale | `src/ContactRecord/ContactRecord.tsx:33`: `export const CONTACT_RECORD_CODES = { loadFailed: 'CRM-101', saveFailed: 'CRM-102' } as const;` |\n| `CT-101` | Contact | `src/Contact/Contact.tsx:21`: `missingField: 'CT-101',` |\n| `CT-102` | Contact | `src/Contact/Contact.tsx:23`: `invalidEmail: 'CT-102',` |\n| `CT-201` | Contact | `src/Contact/Contact.tsx:25`: `offline: 'CT-201',` |\n| `CT-202` | Contact | `src/Contact/Contact.tsx:27`: `rejected: 'CT-202',` |\n| `CT-203` | Contact | `src/Contact/Contact.tsx:29`: `timeout: 'CT-203',` |\n| `DG-101` | DataGrid | `src/DataGrid/DataGrid.tsx:103`: `/** Caligo extra: the error state, an ErrorPanel. 'true' uses code DG-101. */` |\n| `DG-102` | DataGrid | `src/DataGrid/DataGrid.tsx:90`: `/** The rows to show. Each needs a unique 'id', or set 'getRowId'; a missing or repeated id shows an error panel (DG-102, DG-103). */` |\n| `DG-103` | DataGrid | `src/DataGrid/DataGrid.tsx:90`: `/** The rows to show. Each needs a unique 'id', or set 'getRowId'; a missing or repeated id shows an error panel (DG-102, DG-103). */` |\n| `DG-301` | DataGrid | `src/DataGrid/DataGrid.tsx:205`: `/** Called when 'processRowUpdate' throws or rejects. The row goes back to its old values either way; without this prop the grid shows its o` |\n| `DG-401` | DataGrid | `src/DataGrid/DataGrid.tsx:1249`: `code: 'DG-401', headline: t.exportErrorHeadline, description: t.exportErrorDescription,` |\n| `DG-402` | DataGrid | `src/DataGrid/DataGrid.tsx:1336`: `code: 'DG-402', headline: t.printErrorHeadline, description: t.printErrorDescription,` |\n| `DG-403` | DataGrid | `src/DataGrid/DataGrid.tsx:1269`: `code: 'DG-403', headline: t.excelExportErrorHeadline, description: t.excelBuildErrorDescription,` |\n| `DG-404` | DataGrid | `src/DataGrid/DataGrid.tsx:1286`: `setNotice((n) => (n?.code === 'DG-403' \\|\\| n?.code === 'DG-404' ? null : n));` |\n| `DW-101` | DashboardWidget | `src/DashboardWidget/DashboardWidget.tsx:22`: `/** @default 'DW-101' */` |\n| `EV-101` | eval/run.mjs | `eval/run.mjs:37`: `for (const a of armNames) if (!ARMS[a]) { console.error('eval: no setup named \"${a}\". Setups: ${Object.keys(ARMS).join(', ')} (code EV-101)'` |\n| `EV-102` | eval/run.mjs | `eval/run.mjs:40`: `if (wanted) for (const id of wanted) if (!all.some((p) => p.id === id)) { console.error('eval: no prompt with id \"${id}\" in eval/prompts.jso` |\n| `EV-103` | eval/run.mjs | `eval/run.mjs:51`: `if (!existsSync(join(repo, 'agent/caligo.json'))) { console.error('eval: agent/caligo.json is missing. Run npm run docs:agent first (code EV` |\n| `EV-104` | eval/run.mjs | `eval/run.mjs:52`: `if (!existsSync(join(repo, 'dist/types/index.d.ts'))) { console.error('eval: dist/ is missing. Run npm run build first, so the projects can ` |\n| `EV-201` | eval/run.mjs | `eval/run.mjs:81`: `child.on('error', (e) => { clearTimeout(timer); transcript.end(); done({ ...job, failed: { code: 'EV-201', headline: 'Could not start claude` |\n| `EV-202` | eval/run.mjs | `eval/run.mjs:87`: `const failed = signal ? { code: 'EV-202', headline: 'The agent run timed out', why: 'Stopped after ${timeoutMs / 1000} s.' }` |\n| `EV-203` | eval/run.mjs | `eval/run.mjs:88`: `: code !== 0 && !last ? { code: 'EV-203', headline: 'The agent run failed', why: stderr.trim().split('\\n').slice(-3).join(' ') } : null;` |\n| `EV-301` | eval/score.mjs | `eval/score.mjs:152`: `if (!dir \\|\\| !existsSync(join(dir, 'config.json'))) { console.error('eval: give a results folder that has config.json, e.g. node eval/score` |\n| `FB-101` | FileBrowser, locale | `src/FileBrowser/FileBrowser.tsx:45`: `export const FILE_BROWSER_CODES = { loadFailed: 'FB-101', uploadFailed: 'FB-102', openFailed: 'FB-103' } as const;` |\n| `FB-102` | FileBrowser, locale | `src/FileBrowser/FileBrowser.tsx:45`: `export const FILE_BROWSER_CODES = { loadFailed: 'FB-101', uploadFailed: 'FB-102', openFailed: 'FB-103' } as const;` |\n| `FB-103` | FileBrowser, locale | `src/FileBrowser/FileBrowser.tsx:45`: `export const FILE_BROWSER_CODES = { loadFailed: 'FB-101', uploadFailed: 'FB-102', openFailed: 'FB-103' } as const;` |\n| `FEED-101` | SocialPost, locale | `src/SocialPost/SocialPost.tsx:38`: `export const SOCIAL_POST_CODES = { loadFailed: 'FEED-101', actionFailed: 'FEED-201' } as const;` |\n| `FEED-201` | SocialPost, locale | `src/SocialPost/SocialPost.tsx:38`: `export const SOCIAL_POST_CODES = { loadFailed: 'FEED-101', actionFailed: 'FEED-201' } as const;` |\n| `FU-101` | AvatarUpload, Composer, FileBrowser, FileUpload, FileUploadDropzone, internal | `src/AvatarUpload/AvatarUpload.tsx:18`: `/** A file turned away, with a stable code (FU-101 or FU-102) and plain message. */` |\n| `FU-102` | AvatarUpload, Composer, FileUpload, FileUploadDropzone, internal | `src/AvatarUpload/AvatarUpload.tsx:18`: `/** A file turned away, with a stable code (FU-101 or FU-102) and plain message. */` |\n| `FU-103` | Composer, FileBrowser, FileUpload, FileUploadDropzone, internal | `src/Composer/Composer.tsx:94`: `/** Files per message. Extra files are turned away with FU-103. */` |\n| `FU-201` | FileUploadItem | `src/FileUploadItem/FileUploadItem.tsx:24`: `/** Stable code for the failure stage, shown under \"View more\" and in the logs. Give each stage its own. @default 'FU-201' */` |\n| `FW-101` | FormWizard | `src/FormWizard/FormWizard.tsx:69`: `* '{}' to continue. Throwing or rejecting shows an error panel ('FW-101').` |\n| `FW-201` | FormWizard | `src/FormWizard/FormWizard.tsx:88`: `/** Headline of the error panel shown when 'onComplete' rejects (FW-201). @default 'We couldn’t finish' */` |\n| `GNT-101` | GanttChart | `src/GanttChart/GanttChart.tsx:132`: `invalidTask: 'GNT-101',` |\n| `GNT-102` | GanttChart | `src/GanttChart/GanttChart.tsx:133`: `badDependency: 'GNT-102',` |\n| `GNT-103` | GanttChart | `src/GanttChart/GanttChart.tsx:134`: `badLag: 'GNT-103',` |\n| `GNT-201` | GanttChart | `src/GanttChart/GanttChart.tsx:135`: `moveRejected: 'GNT-201',` |\n| `GNT-202` | GanttChart | `src/GanttChart/GanttChart.tsx:136`: `resizeRejected: 'GNT-202',` |\n| `GNT-203` | GanttChart | `src/GanttChart/GanttChart.tsx:137`: `progressRejected: 'GNT-203',` |\n| `GNT-204` | GanttChart | `src/GanttChart/GanttChart.tsx:91`: `/** GNT-204: auto-scheduling found a dependency loop. */` |\n| `INV-101` | InvoiceView, locale | `src/InvoiceView/InvoiceView.tsx:45`: `export const INVOICE_VIEW_CODES = { loadFailed: 'INV-101', downloadFailed: 'INV-102', paymentFailed: 'INV-103' } as const;` |\n| `INV-102` | InvoiceView, locale | `src/InvoiceView/InvoiceView.tsx:45`: `export const INVOICE_VIEW_CODES = { loadFailed: 'INV-101', downloadFailed: 'INV-102', paymentFailed: 'INV-103' } as const;` |\n| `INV-103` | InvoiceView, locale | `src/InvoiceView/InvoiceView.tsx:45`: `export const INVOICE_VIEW_CODES = { loadFailed: 'INV-101', downloadFailed: 'INV-102', paymentFailed: 'INV-103' } as const;` |\n| `JSON-101` | JsonViewer | `src/JsonViewer/JsonViewer.tsx:61`: `/** Headline of the error shown in place of the tree when 'json' isn't valid JSON (code JSON-101). @default \"Couldn't read the JSON\" */` |\n| `JSON-102` | JsonViewer | `src/JsonViewer/JsonViewer.tsx:41`: `/** Headline of the error shown when copying fails (codes JSON-102, JSON-103). @default \"Couldn't copy\" */` |\n| `JSON-103` | JsonViewer | `src/JsonViewer/JsonViewer.tsx:41`: `/** Headline of the error shown when copying fails (codes JSON-102, JSON-103). @default \"Couldn't copy\" */` |\n| `KEY-101` | APIKeyManager, locale | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-201` | APIKeyManager | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-202` | APIKeyManager | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-203` | APIKeyManager | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-301` | APIKeyManager, locale | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `LIC-100` | internal | `src/internal/license.ts:22`: `missing: 'LIC-100',` |\n| `LIC-101` | internal | `src/internal/license.ts:23`: `malformed: 'LIC-101',` |\n| `LIC-102` | internal | `src/internal/license.ts:24`: `signature: 'LIC-102',` |\n| `LIC-103` | internal | `src/internal/license.ts:25`: `notCovered: 'LIC-103',` |\n| `LIC-104` | internal | `src/internal/license.ts:26`: `expired: 'LIC-104',` |\n| `LIC-105` | internal | `src/internal/license.ts:27`: `plan: 'LIC-105',` |\n| `LOG-101` | LogViewer, locale | `src/LogViewer/LogViewer.tsx:42`: `export const LOG_VIEWER_CODES = { streamLost: 'LOG-101', loadFailed: 'LOG-102' } as const;` |\n| `LOG-102` | LogViewer, locale | `src/LogViewer/LogViewer.tsx:42`: `export const LOG_VIEWER_CODES = { streamLost: 'LOG-101', loadFailed: 'LOG-102' } as const;` |\n| `MDL-101` | ModelPicker, locale | `src/ModelPicker/ModelPicker.tsx:47`: `export const MODEL_PICKER_CODES = { loadFailed: 'MDL-101' } as const;` |\n| `MI-101` | MentionsInput | `src/MentionsInput/MentionsInput.tsx:74`: `/** Headline of the error panel shown in the list when a search throws or rejects (MI-101). @default 'We couldn’t load suggestions' */` |\n| `MTL-101` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:106`: `invalidClip: 'MTL-101',` |\n| `MTL-102` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:107`: `missingLead: 'MTL-102',` |\n| `MTL-103` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:108`: `linkLoop: 'MTL-103',` |\n| `MTL-201` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:109`: `changeRejected: 'MTL-201',` |\n| `NC-101` | NotificationCenter, locale | `src/NotificationCenter/NotificationCenter.tsx:49`: `export const NOTIFICATION_CENTER_CODES = { loadFailed: 'NC-101', markReadFailed: 'NC-102' } as const;` |\n| `NC-102` | NotificationCenter, locale | `src/NotificationCenter/NotificationCenter.tsx:49`: `export const NOTIFICATION_CENTER_CODES = { loadFailed: 'NC-101', markReadFailed: 'NC-102' } as const;` |\n| `NL-101` | Newsletter | `src/Newsletter/Newsletter.tsx:25`: `missingEmail: 'NL-101',` |\n| `NL-102` | Newsletter | `src/Newsletter/Newsletter.tsx:27`: `invalidEmail: 'NL-102',` |\n| `NL-201` | Newsletter, internal | `src/Newsletter/Newsletter.tsx:29`: `offline: 'NL-201',` |\n| `NL-202` | Newsletter, internal | `src/Newsletter/Newsletter.tsx:31`: `rejected: 'NL-202',` |\n| `NL-203` | Newsletter, internal | `src/Newsletter/Newsletter.tsx:33`: `timeout: 'NL-203',` |\n| `NL-410` | internal | `src/internal/marketing.ts:118`: `/** A stable code of the app's own, such as 'NL-410'. Shown under \"View more\". */` |\n| `PG-001` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PG-404` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PG-410` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:50`: `/** Overrides the code, such as your own 'PG-410'. */` |\n| `PG-500` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PG-503` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PTR-101` | PullToRefresh | `src/PullToRefresh/PullToRefresh.tsx:28`: `/** 'PTR-101': the app's 'onRefresh' threw or its promise was rejected. */` |\n| `RTE-101` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:242`: `const [pasteFailure, setPasteFailure] = React.useState<{ code: 'RTE-101' \\| 'RTE-102'; log: string } \\| null>(null);` |\n| `RTE-102` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:242`: `const [pasteFailure, setPasteFailure] = React.useState<{ code: 'RTE-101' \\| 'RTE-102'; log: string } \\| null>(null);` |\n| `RTE-201` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:166`: `* the editor never uploads anything itself. Rejecting shows an error panel ('RTE-201').` |\n| `RTE-301` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:56`: `* panel ('RTE-301') when the Markdown can't be read.` |\n| `SCH-101` | Scheduler | `src/Scheduler/Scheduler.tsx:179`: `invalidEvent: 'SCH-101',` |\n| `SCH-102` | Scheduler | `src/Scheduler/Scheduler.tsx:180`: `unsupportedRule: 'SCH-102',` |\n| `SCH-103` | Scheduler | `src/Scheduler/Scheduler.tsx:82`: `/** SCH-103 (unknown 'timezone') headline. */` |\n| `SCH-104` | Scheduler | `src/Scheduler/Scheduler.tsx:182`: `unknownEventTimeZone: 'SCH-104',` |\n| `SCH-105` | Scheduler | `src/Scheduler/Scheduler.tsx:103`: `/** SCH-105 */` |\n| `SCH-106` | Scheduler | `src/Scheduler/Scheduler.tsx:106`: `/** SCH-106 */` |\n| `SCH-107` | Scheduler | `src/Scheduler/Scheduler.tsx:109`: `/** SCH-107 */` |\n| `SCH-108` | Scheduler | `src/Scheduler/Scheduler.tsx:112`: `/** SCH-108 */` |\n| `SCH-109` | Scheduler | `src/Scheduler/Scheduler.tsx:115`: `/** SCH-109 */` |\n| `SCH-110` | Scheduler | `src/Scheduler/Scheduler.tsx:118`: `/** SCH-110 */` |\n| `SCH-111` | Scheduler | `src/Scheduler/Scheduler.tsx:121`: `/** SCH-111 */` |\n| `SCH-201` | Scheduler | `src/Scheduler/Scheduler.tsx:190`: `moveRejected: 'SCH-201',` |\n| `SCH-202` | Scheduler | `src/Scheduler/Scheduler.tsx:191`: `resizeRejected: 'SCH-202',` |\n| `SR-101` | SearchPanel, locale | `src/SearchPanel/SearchPanel.tsx:32`: `export const SEARCH_PANEL_CODES = { searchFailed: 'SR-101', timeout: 'SR-102' } as const;` |\n| `SR-102` | SearchPanel, locale | `src/SearchPanel/SearchPanel.tsx:32`: `export const SEARCH_PANEL_CODES = { searchFailed: 'SR-101', timeout: 'SR-102' } as const;` |\n| `TEAM-101` | TeamMembersPanel, locale | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-201` | TeamMembersPanel | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-202` | TeamMembersPanel | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-203` | TeamMembersPanel | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-301` | TeamMembersPanel, locale | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-302` | TeamMembersPanel, locale | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TXN-101` | TransactionList, locale | `src/TransactionList/TransactionList.tsx:52`: `export const TRANSACTION_LIST_CODES = { loadFailed: 'TXN-101', loadMoreFailed: 'TXN-102' } as const;` |\n| `TXN-102` | TransactionList, locale | `src/TransactionList/TransactionList.tsx:52`: `export const TRANSACTION_LIST_CODES = { loadFailed: 'TXN-101', loadMoreFailed: 'TXN-102' } as const;` |\n| `UP-101` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `UP-102` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `UP-103` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `UP-104` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `VID-101` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:51`: `* - 'VID-101' the browser stopped fetching the video (MediaError 1, aborted)` |\n| `VID-102` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:52`: `* - 'VID-102' a network error while loading (MediaError 2)` |\n| `VID-103` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:53`: `* - 'VID-103' the file couldn't be decoded (MediaError 3)` |\n| `VID-104` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:54`: `* - 'VID-104' no source in a supported format (MediaError 4)` |\n| `VID-201` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:55`: `* - 'VID-201' full screen was refused` |\n| `VID-202` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:56`: `* - 'VID-202' picture-in-picture was refused` |",
37013
+ "body": "Generated by `scripts/error-codes.mjs`. Every failure a person can see has its own stable code (the house error rule). Codes never change meaning and are never reused.\n\n| Code | Raised in | Defined at |\n|---|---|---|\n| `AP-101` | AnalyticsPanel | `src/AnalyticsPanel/AnalyticsPanel.tsx:44`: `/** The error state. 'true' uses code AP-101. */` |\n| `AUTH-100` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:44`: `* listed keeps its own value and shows the stage's fallback text ('AUTH-100', '-200', '-300', '-350', '-400').` |\n| `AUTH-101` | AuthPage, internal, locale | `src/AuthPage/AuthPage.tsx:47`: `signInFailed: 'AUTH-100', wrongCredentials: 'AUTH-101', accountLocked: 'AUTH-102', emailNotVerified: 'AUTH-103',` |\n| `AUTH-102` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:47`: `signInFailed: 'AUTH-100', wrongCredentials: 'AUTH-101', accountLocked: 'AUTH-102', emailNotVerified: 'AUTH-103',` |\n| `AUTH-103` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:47`: `signInFailed: 'AUTH-100', wrongCredentials: 'AUTH-101', accountLocked: 'AUTH-102', emailNotVerified: 'AUTH-103',` |\n| `AUTH-200` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:48`: `signUpFailed: 'AUTH-200', emailTaken: 'AUTH-201', passwordRejected: 'AUTH-202',` |\n| `AUTH-201` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:48`: `signUpFailed: 'AUTH-200', emailTaken: 'AUTH-201', passwordRejected: 'AUTH-202',` |\n| `AUTH-202` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:48`: `signUpFailed: 'AUTH-200', emailTaken: 'AUTH-201', passwordRejected: 'AUTH-202',` |\n| `AUTH-300` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:49`: `resetRequestFailed: 'AUTH-300', resetEmailNotSent: 'AUTH-301',` |\n| `AUTH-301` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:49`: `resetRequestFailed: 'AUTH-300', resetEmailNotSent: 'AUTH-301',` |\n| `AUTH-350` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:50`: `resetFailed: 'AUTH-350', resetLinkExpired: 'AUTH-351',` |\n| `AUTH-351` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:50`: `resetFailed: 'AUTH-350', resetLinkExpired: 'AUTH-351',` |\n| `AUTH-400` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-401` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-402` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-403` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:51`: `verifyFailed: 'AUTH-400', codeWrong: 'AUTH-401', codeExpired: 'AUTH-402', tooManyAttempts: 'AUTH-403',` |\n| `AUTH-501` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:52`: `ssoFailed: 'AUTH-501', ssoCancelled: 'AUTH-502',` |\n| `AUTH-502` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:52`: `ssoFailed: 'AUTH-501', ssoCancelled: 'AUTH-502',` |\n| `AUTH-901` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:53`: `network: 'AUTH-901', rateLimited: 'AUTH-902',` |\n| `AUTH-902` | AuthPage, locale | `src/AuthPage/AuthPage.tsx:53`: `network: 'AUTH-901', rateLimited: 'AUTH-902',` |\n| `BAL-101` | BalanceCard, locale | `src/BalanceCard/BalanceCard.tsx:29`: `export const BALANCE_CARD_CODES = { loadFailed: 'BAL-101' } as const;` |\n| `BIL-101` | BillingSection, locale | `src/BillingSection/BillingSection.tsx:48`: `export const BILLING_CODES = { loadFailed: 'BIL-101', invoiceDownloadFailed: 'BIL-102', paymentFailed: 'BIL-103' } as const;` |\n| `BIL-102` | BillingSection, locale | `src/BillingSection/BillingSection.tsx:48`: `export const BILLING_CODES = { loadFailed: 'BIL-101', invoiceDownloadFailed: 'BIL-102', paymentFailed: 'BIL-103' } as const;` |\n| `BIL-103` | BillingSection, locale | `src/BillingSection/BillingSection.tsx:48`: `export const BILLING_CODES = { loadFailed: 'BIL-101', invoiceDownloadFailed: 'BIL-102', paymentFailed: 'BIL-103' } as const;` |\n| `CF-101` | CopyField | `src/CopyField/CopyField.tsx:22`: `/** Why, for CF-101: the page has no clipboard access at all. */` |\n| `CF-102` | CopyField | `src/CopyField/CopyField.tsx:24`: `/** Why, for CF-102: the browser refused the write. */` |\n| `CH-201` | ApprovalDialog, ChatMessageGroup, ToolCallCard, Trace, internal | `src/ApprovalDialog/ApprovalDialog.tsx:45`: `/** Why a copy failed, under \"View more\" (code CH-201). */` |\n| `CH-202` | ChatBubble, ChatMessageList, internal | `src/ChatBubble/ChatBubble.tsx:38`: `* this, or with a plain default and code CH-202.` |\n| `CH-301` | ChatMessageList, internal | `src/ChatMessageList/ChatMessageListImpl.tsx:70`: `/** A failure to show under the messages, in the house error pattern. Default code CH-301. */` |\n| `CH-401` | ToolCallCard | `src/ToolCallCard/ToolCallCard.tsx:46`: `/** What failed, shown with the house error pattern when 'status=\"error\"'. Default code CH-401. */` |\n| `CH-402` | ReasoningCard | `src/ReasoningCard/ReasoningCard.tsx:27`: `/** Shown with the house error pattern when 'status=\"error\"'. Default code CH-402. */` |\n| `CH-403` | AgentStatusPanel | `src/AgentStatusPanel/AgentStatusPanel.tsx:53`: `/** Shown with the house error pattern when 'status=\"error\"'. Default code CH-403. */` |\n| `CH-404` | MultiAgentPanel | `src/MultiAgentPanel/MultiAgentPanel.tsx:23`: `/** Shown with the house error pattern when the agent failed. Default code CH-404. */` |\n| `CH-405` | Trace | `src/Trace/Trace.tsx:31`: `/** Shown with the house error pattern when the span failed. Default code CH-405. */` |\n| `CH-406` | VoiceInputBar | `src/VoiceInputBar/VoiceInputBar.tsx:23`: `/** Shown with the house error pattern when 'status=\"error\"'. Default code CH-406. */` |\n| `CH-407` | Questionnaire | `src/Questionnaire/Questionnaire.tsx:45`: `/** Sending the answers failed. Shown with the house error pattern. Default code CH-407. */` |\n| `CH-408` | ApprovalDialog | `src/ApprovalDialog/ApprovalDialog.tsx:61`: `/** The decision couldn't be sent, for example. Shown with the house error pattern. Default code CH-408. */` |\n| `CH-409` | AISidebar | `src/AISidebar/AISidebar.tsx:50`: `/** Shown with the house error pattern instead of the list. Default code CH-409. */` |\n| `CHG-101` | Changelog, locale | `src/Changelog/Changelog.tsx:46`: `export const CHANGELOG_CODES = { loadFailed: 'CHG-101', loadMoreFailed: 'CHG-102' } as const;` |\n| `CHG-102` | Changelog, locale | `src/Changelog/Changelog.tsx:46`: `export const CHANGELOG_CODES = { loadFailed: 'CHG-101', loadMoreFailed: 'CHG-102' } as const;` |\n| `CHT-101` | ChartsLegend | `src/ChartsLegend/chartCore.tsx:457`: `/** A stable code for the stage that failed. @default 'CHT-101' */` |\n| `CHT-102` | ActivityGauge, BarChart, Heatmap, LineChart, PieChart, RadarChart, SankeyChart | `src/ActivityGauge/ActivityGauge.tsx:127`: `dataProblem={problems.length ? { code: 'CHT-102', detail: problems.join('; ') } : null}` |\n| `CHT-103` | SankeyChart | `src/SankeyChart/SankeyChart.tsx:235`: `dataProblem={layout.cyclic ? { code: 'CHT-103', detail: 'links form a loop' } : problems.length ? { code: 'CHT-102', detail: problems.join('` |\n| `CLI-101` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:30`: `'CLI-101': { headline: 'Unknown command', description: 'Run caligo --help to see the commands.' },` |\n| `CLI-102` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:31`: `'CLI-102': { headline: 'Unknown option', description: 'Run caligo <command> --help to see its options.' },` |\n| `CLI-103` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:32`: `'CLI-103': { headline: 'Something is missing', description: 'This command needs an argument. Run caligo <command> --help.' },` |\n| `CLI-104` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:33`: `'CLI-104': { headline: 'That value won\\'t work here', description: 'Run caligo <command> --help to see the values it takes.' },` |\n| `CLI-201` | cli/api.mjs | `cli/api.mjs:34`: `'CLI-201': { headline: 'No component by that name', description: 'Check the spelling, or search: caligo search <words>.' },` |\n| `CLI-202` | cli/api.mjs | `cli/api.mjs:35`: `'CLI-202': { headline: 'No docs topic by that name', description: 'Run caligo docs to list the topics.' },` |\n| `CLI-203` | cli/api.mjs | `cli/api.mjs:36`: `'CLI-203': { headline: 'Nothing matched', description: 'Try fewer or plainer words, such as \"table\" or \"sign in\".' },` |\n| `CLI-204` | cli/api.mjs | `cli/api.mjs:37`: `'CLI-204': { headline: 'No tokens matched', description: 'Try a group (color, spacing, radius, shadow, type) or a word from a token name.' }` |\n| `CLI-301` | cli/api.mjs | `cli/api.mjs:38`: `'CLI-301': { headline: 'File not found', description: 'Check the path. caligo check takes .tsx, .jsx, .ts and .js files.' },` |\n| `CLI-302` | cli/api.mjs, cli/check.mjs | `cli/api.mjs:39`: `'CLI-302': { headline: 'File doesn\\'t parse', description: 'Fix the syntax error first; check reads the file as TSX.' },` |\n| `CLI-401` | cli/api.mjs | `cli/api.mjs:40`: `'CLI-401': { headline: 'Not in a project', description: 'Run caligo init in the folder that holds your package.json.' },` |\n| `CLI-402` | cli/api.mjs | `cli/api.mjs:41`: `'CLI-402': { headline: 'Couldn\\'t write the file', description: 'Check that the folder is writable, then run caligo init again.' },` |\n| `CLI-403` | cli/api.mjs | `cli/api.mjs:42`: `'CLI-403': { headline: 'The Caligo block in this file is damaged', description: 'It has one of the CALIGO markers but not the other. Remove ` |\n| `CLI-901` | cli/api.mjs | `cli/api.mjs:43`: `'CLI-901': { headline: 'Caligo\\'s docs index is missing', description: 'Reinstall @caligo-ui/core. If you work on Caligo itself, run npm run` |\n| `CLI-902` | cli/api.mjs | `cli/api.mjs:44`: `'CLI-902': { headline: 'Caligo\\'s docs index can\\'t be read', description: 'Reinstall @caligo-ui/core. If you work on Caligo itself, run npm` |\n| `CLI-903` | cli/api.mjs | `cli/api.mjs:45`: `'CLI-903': { headline: 'This CLI is older than its docs index', description: 'Update @caligo-ui/core so the CLI and the index match.' },` |\n| `CLI-999` | cli/api.mjs, cli/caligo.mjs | `cli/api.mjs:46`: `'CLI-999': { headline: 'The Caligo CLI hit a bug', description: 'Run the command again with --verbose and send the output to the Caligo team` |\n| `CMT-101` | CommentThread, locale | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CMT-201` | CommentThread | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CMT-202` | CommentThread | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CMT-203` | CommentThread | `src/CommentThread/CommentThread.tsx:51`: `export const COMMENT_THREAD_CODES = { loadFailed: 'CMT-101', offline: 'CMT-201', rejected: 'CMT-202', timeout: 'CMT-203' } as const;` |\n| `CO-201` | CheckoutSection | `src/CheckoutSection/CheckoutSection.tsx:21`: `offline: 'CO-201',` |\n| `CO-202` | CheckoutSection | `src/CheckoutSection/CheckoutSection.tsx:23`: `rejected: 'CO-202',` |\n| `CO-203` | CheckoutSection | `src/CheckoutSection/CheckoutSection.tsx:25`: `timeout: 'CO-203',` |\n| `CODE-101` | CodeBlock | `src/CodeBlock/CodeBlock.tsx:362`: `code={failure.kind === 'unavailable' ? 'CODE-101' : 'CODE-102'}` |\n| `CODE-102` | CodeBlock | `src/CodeBlock/CodeBlock.tsx:362`: `code={failure.kind === 'unavailable' ? 'CODE-101' : 'CODE-102'}` |\n| `CODE-103` | CodeBlock | `src/CodeBlock/CodeBlock.tsx:196`: `// CODE-103: the app's highlighter threw. Fall back to the built-in tokenizer and tell the developer.` |\n| `CRM-101` | ContactRecord, locale | `src/ContactRecord/ContactRecord.tsx:33`: `export const CONTACT_RECORD_CODES = { loadFailed: 'CRM-101', saveFailed: 'CRM-102' } as const;` |\n| `CRM-102` | ContactRecord, locale | `src/ContactRecord/ContactRecord.tsx:33`: `export const CONTACT_RECORD_CODES = { loadFailed: 'CRM-101', saveFailed: 'CRM-102' } as const;` |\n| `CT-101` | Contact | `src/Contact/Contact.tsx:21`: `missingField: 'CT-101',` |\n| `CT-102` | Contact | `src/Contact/Contact.tsx:23`: `invalidEmail: 'CT-102',` |\n| `CT-201` | Contact | `src/Contact/Contact.tsx:25`: `offline: 'CT-201',` |\n| `CT-202` | Contact | `src/Contact/Contact.tsx:27`: `rejected: 'CT-202',` |\n| `CT-203` | Contact | `src/Contact/Contact.tsx:29`: `timeout: 'CT-203',` |\n| `DG-101` | DataGrid | `src/DataGrid/DataGrid.tsx:103`: `/** Caligo extra: the error state, an ErrorPanel. 'true' uses code DG-101. */` |\n| `DG-102` | DataGrid | `src/DataGrid/DataGrid.tsx:90`: `/** The rows to show. Each needs a unique 'id', or set 'getRowId'; a missing or repeated id shows an error panel (DG-102, DG-103). */` |\n| `DG-103` | DataGrid | `src/DataGrid/DataGrid.tsx:90`: `/** The rows to show. Each needs a unique 'id', or set 'getRowId'; a missing or repeated id shows an error panel (DG-102, DG-103). */` |\n| `DG-301` | DataGrid | `src/DataGrid/DataGrid.tsx:205`: `/** Called when 'processRowUpdate' throws or rejects. The row goes back to its old values either way; without this prop the grid shows its o` |\n| `DG-401` | DataGrid | `src/DataGrid/DataGrid.tsx:1249`: `code: 'DG-401', headline: t.exportErrorHeadline, description: t.exportErrorDescription,` |\n| `DG-402` | DataGrid | `src/DataGrid/DataGrid.tsx:1336`: `code: 'DG-402', headline: t.printErrorHeadline, description: t.printErrorDescription,` |\n| `DG-403` | DataGrid | `src/DataGrid/DataGrid.tsx:1269`: `code: 'DG-403', headline: t.excelExportErrorHeadline, description: t.excelBuildErrorDescription,` |\n| `DG-404` | DataGrid | `src/DataGrid/DataGrid.tsx:1286`: `setNotice((n) => (n?.code === 'DG-403' \\|\\| n?.code === 'DG-404' ? null : n));` |\n| `DW-101` | DashboardWidget | `src/DashboardWidget/DashboardWidget.tsx:22`: `/** @default 'DW-101' */` |\n| `EV-101` | eval/run.mjs | `eval/run.mjs:37`: `for (const a of armNames) if (!ARMS[a]) { console.error('eval: no setup named \"${a}\". Setups: ${Object.keys(ARMS).join(', ')} (code EV-101)'` |\n| `EV-102` | eval/run.mjs | `eval/run.mjs:40`: `if (wanted) for (const id of wanted) if (!all.some((p) => p.id === id)) { console.error('eval: no prompt with id \"${id}\" in eval/prompts.jso` |\n| `EV-103` | eval/run.mjs | `eval/run.mjs:51`: `if (!existsSync(join(repo, 'agent/caligo.json'))) { console.error('eval: agent/caligo.json is missing. Run npm run docs:agent first (code EV` |\n| `EV-104` | eval/run.mjs | `eval/run.mjs:52`: `if (!existsSync(join(repo, 'dist/types/index.d.ts'))) { console.error('eval: dist/ is missing. Run npm run build first, so the projects can ` |\n| `EV-201` | eval/run.mjs | `eval/run.mjs:81`: `child.on('error', (e) => { clearTimeout(timer); transcript.end(); done({ ...job, failed: { code: 'EV-201', headline: 'Could not start claude` |\n| `EV-202` | eval/run.mjs | `eval/run.mjs:87`: `const failed = signal ? { code: 'EV-202', headline: 'The agent run timed out', why: 'Stopped after ${timeoutMs / 1000} s.' }` |\n| `EV-203` | eval/run.mjs | `eval/run.mjs:88`: `: code !== 0 && !last ? { code: 'EV-203', headline: 'The agent run failed', why: stderr.trim().split('\\n').slice(-3).join(' ') } : null;` |\n| `EV-301` | eval/score.mjs | `eval/score.mjs:152`: `if (!dir \\|\\| !existsSync(join(dir, 'config.json'))) { console.error('eval: give a results folder that has config.json, e.g. node eval/score` |\n| `FB-101` | FileBrowser, locale | `src/FileBrowser/FileBrowser.tsx:45`: `export const FILE_BROWSER_CODES = { loadFailed: 'FB-101', uploadFailed: 'FB-102', openFailed: 'FB-103' } as const;` |\n| `FB-102` | FileBrowser, locale | `src/FileBrowser/FileBrowser.tsx:45`: `export const FILE_BROWSER_CODES = { loadFailed: 'FB-101', uploadFailed: 'FB-102', openFailed: 'FB-103' } as const;` |\n| `FB-103` | FileBrowser, locale | `src/FileBrowser/FileBrowser.tsx:45`: `export const FILE_BROWSER_CODES = { loadFailed: 'FB-101', uploadFailed: 'FB-102', openFailed: 'FB-103' } as const;` |\n| `FEED-101` | SocialPost, locale | `src/SocialPost/SocialPost.tsx:38`: `export const SOCIAL_POST_CODES = { loadFailed: 'FEED-101', actionFailed: 'FEED-201' } as const;` |\n| `FEED-201` | SocialPost, locale | `src/SocialPost/SocialPost.tsx:38`: `export const SOCIAL_POST_CODES = { loadFailed: 'FEED-101', actionFailed: 'FEED-201' } as const;` |\n| `FU-101` | AvatarUpload, Composer, FileBrowser, FileUpload, FileUploadDropzone, internal | `src/AvatarUpload/AvatarUpload.tsx:18`: `/** A file turned away, with a stable code (FU-101 or FU-102) and plain message. */` |\n| `FU-102` | AvatarUpload, Composer, FileUpload, FileUploadDropzone, internal | `src/AvatarUpload/AvatarUpload.tsx:18`: `/** A file turned away, with a stable code (FU-101 or FU-102) and plain message. */` |\n| `FU-103` | Composer, FileBrowser, FileUpload, FileUploadDropzone, internal | `src/Composer/Composer.tsx:94`: `/** Files per message. Extra files are turned away with FU-103. */` |\n| `FU-201` | FileUploadItem | `src/FileUploadItem/FileUploadItem.tsx:24`: `/** Stable code for the failure stage, shown under \"View more\" and in the logs. Give each stage its own. @default 'FU-201' */` |\n| `FW-101` | FormWizard | `src/FormWizard/FormWizard.tsx:69`: `* '{}' to continue. Throwing or rejecting shows an error panel ('FW-101').` |\n| `FW-201` | FormWizard | `src/FormWizard/FormWizard.tsx:88`: `/** Headline of the error panel shown when 'onComplete' rejects (FW-201). @default 'We couldn’t finish' */` |\n| `GNT-101` | GanttChart | `src/GanttChart/GanttChart.tsx:132`: `invalidTask: 'GNT-101',` |\n| `GNT-102` | GanttChart | `src/GanttChart/GanttChart.tsx:133`: `badDependency: 'GNT-102',` |\n| `GNT-103` | GanttChart | `src/GanttChart/GanttChart.tsx:134`: `badLag: 'GNT-103',` |\n| `GNT-201` | GanttChart | `src/GanttChart/GanttChart.tsx:135`: `moveRejected: 'GNT-201',` |\n| `GNT-202` | GanttChart | `src/GanttChart/GanttChart.tsx:136`: `resizeRejected: 'GNT-202',` |\n| `GNT-203` | GanttChart | `src/GanttChart/GanttChart.tsx:137`: `progressRejected: 'GNT-203',` |\n| `GNT-204` | GanttChart | `src/GanttChart/GanttChart.tsx:91`: `/** GNT-204: auto-scheduling found a dependency loop. */` |\n| `INV-101` | InvoiceView, locale | `src/InvoiceView/InvoiceView.tsx:45`: `export const INVOICE_VIEW_CODES = { loadFailed: 'INV-101', downloadFailed: 'INV-102', paymentFailed: 'INV-103' } as const;` |\n| `INV-102` | InvoiceView, locale | `src/InvoiceView/InvoiceView.tsx:45`: `export const INVOICE_VIEW_CODES = { loadFailed: 'INV-101', downloadFailed: 'INV-102', paymentFailed: 'INV-103' } as const;` |\n| `INV-103` | InvoiceView, locale | `src/InvoiceView/InvoiceView.tsx:45`: `export const INVOICE_VIEW_CODES = { loadFailed: 'INV-101', downloadFailed: 'INV-102', paymentFailed: 'INV-103' } as const;` |\n| `JSON-101` | JsonViewer | `src/JsonViewer/JsonViewer.tsx:61`: `/** Headline of the error shown in place of the tree when 'json' isn't valid JSON (code JSON-101). @default \"Couldn't read the JSON\" */` |\n| `JSON-102` | JsonViewer | `src/JsonViewer/JsonViewer.tsx:41`: `/** Headline of the error shown when copying fails (codes JSON-102, JSON-103). @default \"Couldn't copy\" */` |\n| `JSON-103` | JsonViewer | `src/JsonViewer/JsonViewer.tsx:41`: `/** Headline of the error shown when copying fails (codes JSON-102, JSON-103). @default \"Couldn't copy\" */` |\n| `KEY-101` | APIKeyManager, locale | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-201` | APIKeyManager | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-202` | APIKeyManager | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-203` | APIKeyManager | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `KEY-301` | APIKeyManager, locale | `src/APIKeyManager/APIKeyManager.tsx:52`: `export const API_KEY_MANAGER_CODES = { loadFailed: 'KEY-101', createOffline: 'KEY-201', createRejected: 'KEY-202', createTimeout: 'KEY-203',` |\n| `LIC-100` | internal | `src/internal/license.ts:22`: `missing: 'LIC-100',` |\n| `LIC-101` | internal | `src/internal/license.ts:23`: `malformed: 'LIC-101',` |\n| `LIC-102` | internal | `src/internal/license.ts:24`: `signature: 'LIC-102',` |\n| `LIC-103` | internal | `src/internal/license.ts:25`: `notCovered: 'LIC-103',` |\n| `LIC-104` | internal | `src/internal/license.ts:26`: `expired: 'LIC-104',` |\n| `LIC-105` | internal | `src/internal/license.ts:27`: `plan: 'LIC-105',` |\n| `LOG-101` | LogViewer, locale | `src/LogViewer/LogViewer.tsx:42`: `export const LOG_VIEWER_CODES = { streamLost: 'LOG-101', loadFailed: 'LOG-102' } as const;` |\n| `LOG-102` | LogViewer, locale | `src/LogViewer/LogViewer.tsx:42`: `export const LOG_VIEWER_CODES = { streamLost: 'LOG-101', loadFailed: 'LOG-102' } as const;` |\n| `MDL-101` | ModelPicker, locale | `src/ModelPicker/ModelPicker.tsx:47`: `export const MODEL_PICKER_CODES = { loadFailed: 'MDL-101' } as const;` |\n| `MI-101` | MentionsInput | `src/MentionsInput/MentionsInput.tsx:74`: `/** Headline of the error panel shown in the list when a search throws or rejects (MI-101). @default 'We couldn’t load suggestions' */` |\n| `MTL-101` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:112`: `invalidClip: 'MTL-101',` |\n| `MTL-102` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:113`: `missingLead: 'MTL-102',` |\n| `MTL-103` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:114`: `linkLoop: 'MTL-103',` |\n| `MTL-201` | MotionTimeline | `src/MotionTimeline/MotionTimeline.tsx:115`: `changeRejected: 'MTL-201',` |\n| `NC-101` | NotificationCenter, locale | `src/NotificationCenter/NotificationCenter.tsx:49`: `export const NOTIFICATION_CENTER_CODES = { loadFailed: 'NC-101', markReadFailed: 'NC-102' } as const;` |\n| `NC-102` | NotificationCenter, locale | `src/NotificationCenter/NotificationCenter.tsx:49`: `export const NOTIFICATION_CENTER_CODES = { loadFailed: 'NC-101', markReadFailed: 'NC-102' } as const;` |\n| `NL-101` | Newsletter | `src/Newsletter/Newsletter.tsx:25`: `missingEmail: 'NL-101',` |\n| `NL-102` | Newsletter | `src/Newsletter/Newsletter.tsx:27`: `invalidEmail: 'NL-102',` |\n| `NL-201` | Newsletter, internal | `src/Newsletter/Newsletter.tsx:29`: `offline: 'NL-201',` |\n| `NL-202` | Newsletter, internal | `src/Newsletter/Newsletter.tsx:31`: `rejected: 'NL-202',` |\n| `NL-203` | Newsletter, internal | `src/Newsletter/Newsletter.tsx:33`: `timeout: 'NL-203',` |\n| `NL-410` | internal | `src/internal/marketing.ts:118`: `/** A stable code of the app's own, such as 'NL-410'. Shown under \"View more\". */` |\n| `PG-001` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PG-404` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PG-410` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:50`: `/** Overrides the code, such as your own 'PG-410'. */` |\n| `PG-500` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PG-503` | ErrorPage | `src/ErrorPage/ErrorPage.tsx:21`: `export const ERROR_PAGE_CODES: Record<ErrorPageType, string> = { '404': 'PG-404', '500': 'PG-500', offline: 'PG-001', maintenance: 'PG-503' ` |\n| `PTR-101` | PullToRefresh | `src/PullToRefresh/PullToRefresh.tsx:28`: `/** 'PTR-101': the app's 'onRefresh' threw or its promise was rejected. */` |\n| `RTE-101` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:242`: `const [pasteFailure, setPasteFailure] = React.useState<{ code: 'RTE-101' \\| 'RTE-102'; log: string } \\| null>(null);` |\n| `RTE-102` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:242`: `const [pasteFailure, setPasteFailure] = React.useState<{ code: 'RTE-101' \\| 'RTE-102'; log: string } \\| null>(null);` |\n| `RTE-201` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:166`: `* the editor never uploads anything itself. Rejecting shows an error panel ('RTE-201').` |\n| `RTE-301` | RichTextEditor | `src/RichTextEditor/RichTextEditor.tsx:56`: `* panel ('RTE-301') when the Markdown can't be read.` |\n| `SCH-101` | Scheduler | `src/Scheduler/Scheduler.tsx:179`: `invalidEvent: 'SCH-101',` |\n| `SCH-102` | Scheduler | `src/Scheduler/Scheduler.tsx:180`: `unsupportedRule: 'SCH-102',` |\n| `SCH-103` | Scheduler | `src/Scheduler/Scheduler.tsx:82`: `/** SCH-103 (unknown 'timezone') headline. */` |\n| `SCH-104` | Scheduler | `src/Scheduler/Scheduler.tsx:182`: `unknownEventTimeZone: 'SCH-104',` |\n| `SCH-105` | Scheduler | `src/Scheduler/Scheduler.tsx:103`: `/** SCH-105 */` |\n| `SCH-106` | Scheduler | `src/Scheduler/Scheduler.tsx:106`: `/** SCH-106 */` |\n| `SCH-107` | Scheduler | `src/Scheduler/Scheduler.tsx:109`: `/** SCH-107 */` |\n| `SCH-108` | Scheduler | `src/Scheduler/Scheduler.tsx:112`: `/** SCH-108 */` |\n| `SCH-109` | Scheduler | `src/Scheduler/Scheduler.tsx:115`: `/** SCH-109 */` |\n| `SCH-110` | Scheduler | `src/Scheduler/Scheduler.tsx:118`: `/** SCH-110 */` |\n| `SCH-111` | Scheduler | `src/Scheduler/Scheduler.tsx:121`: `/** SCH-111 */` |\n| `SCH-201` | Scheduler | `src/Scheduler/Scheduler.tsx:190`: `moveRejected: 'SCH-201',` |\n| `SCH-202` | Scheduler | `src/Scheduler/Scheduler.tsx:191`: `resizeRejected: 'SCH-202',` |\n| `SR-101` | SearchPanel, locale | `src/SearchPanel/SearchPanel.tsx:32`: `export const SEARCH_PANEL_CODES = { searchFailed: 'SR-101', timeout: 'SR-102' } as const;` |\n| `SR-102` | SearchPanel, locale | `src/SearchPanel/SearchPanel.tsx:32`: `export const SEARCH_PANEL_CODES = { searchFailed: 'SR-101', timeout: 'SR-102' } as const;` |\n| `TEAM-101` | TeamMembersPanel, locale | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-201` | TeamMembersPanel | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-202` | TeamMembersPanel | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-203` | TeamMembersPanel | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-301` | TeamMembersPanel, locale | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `TEAM-302` | TeamMembersPanel, locale | `src/TeamMembersPanel/TeamMembersPanel.tsx:56`: `export const TEAM_MEMBERS_PANEL_CODES = { loadFailed: 'TEAM-101', inviteOffline: 'TEAM-201', inviteRejected: 'TEAM-202', inviteTimeout: 'TEA` |\n| `THG-101` | theme-generator/app.mjs, theme-generator/engine.mjs | `theme-generator/app.mjs:51`: `'THG-101': { headline: \"This theme link couldn't be opened\", description: 'The link looks cut short. Copy the whole address again, or start ` |\n| `THG-102` | theme-generator/app.mjs, theme-generator/engine.mjs | `theme-generator/app.mjs:52`: `'THG-102': { headline: \"This theme link couldn't be opened\", description: 'It was made by a different version of the generator, or it holds ` |\n| `THG-201` | theme-generator/app.mjs | `theme-generator/app.mjs:53`: `'THG-201': { headline: \"The CSS wasn't copied\", description: 'Your browser blocked the clipboard. Select the CSS below and copy it yourself,` |\n| `THG-202` | theme-generator/app.mjs | `theme-generator/app.mjs:54`: `'THG-202': { headline: \"The link wasn't copied\", description: \"Your browser blocked the clipboard. Copy the page's address from the address ` |\n| `THG-301` | theme-generator/app.mjs | `theme-generator/app.mjs:55`: `'THG-301': { headline: \"The generator didn't load\", description: 'Part of the page could not be fetched. Check your connection and reload.',` |\n| `TXN-101` | TransactionList, locale | `src/TransactionList/TransactionList.tsx:52`: `export const TRANSACTION_LIST_CODES = { loadFailed: 'TXN-101', loadMoreFailed: 'TXN-102' } as const;` |\n| `TXN-102` | TransactionList, locale | `src/TransactionList/TransactionList.tsx:52`: `export const TRANSACTION_LIST_CODES = { loadFailed: 'TXN-101', loadMoreFailed: 'TXN-102' } as const;` |\n| `UP-101` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `UP-102` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `UP-103` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `UP-104` | UserProfilePanel, locale | `src/UserProfilePanel/UserProfilePanel.tsx:24`: `export const USER_PROFILE_CODES = { loadFailed: 'UP-101', saveFailed: 'UP-102', emailTaken: 'UP-103', avatarFailed: 'UP-104' } as const;` |\n| `VID-101` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:51`: `* - 'VID-101' the browser stopped fetching the video (MediaError 1, aborted)` |\n| `VID-102` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:52`: `* - 'VID-102' a network error while loading (MediaError 2)` |\n| `VID-103` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:53`: `* - 'VID-103' the file couldn't be decoded (MediaError 3)` |\n| `VID-104` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:54`: `* - 'VID-104' no source in a supported format (MediaError 4)` |\n| `VID-201` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:55`: `* - 'VID-201' full screen was refused` |\n| `VID-202` | VideoPlayer | `src/VideoPlayer/VideoPlayer.tsx:56`: `* - 'VID-202' picture-in-picture was refused` |",
36407
37014
  "sections": []
36408
37015
  },
36409
37016
  {