@ponchia/ui 0.6.5 → 0.6.7

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 (108) hide show
  1. package/CHANGELOG.md +170 -0
  2. package/README.md +43 -23
  3. package/behaviors/carousel.d.ts.map +1 -1
  4. package/behaviors/carousel.js +3 -0
  5. package/behaviors/dialog.d.ts.map +1 -1
  6. package/behaviors/dialog.js +14 -8
  7. package/behaviors/forms.d.ts.map +1 -1
  8. package/behaviors/forms.js +11 -5
  9. package/behaviors/index.d.ts +2 -0
  10. package/behaviors/index.d.ts.map +1 -1
  11. package/behaviors/index.js +2 -0
  12. package/behaviors/internal.d.ts +2 -1
  13. package/behaviors/internal.d.ts.map +1 -1
  14. package/behaviors/internal.js +23 -3
  15. package/behaviors/legend.d.ts.map +1 -1
  16. package/behaviors/legend.js +41 -9
  17. package/behaviors/splitter.d.ts +26 -0
  18. package/behaviors/splitter.d.ts.map +1 -0
  19. package/behaviors/splitter.js +200 -0
  20. package/behaviors/table.js +3 -3
  21. package/behaviors/theme.js +2 -2
  22. package/classes/classes.json +230 -4
  23. package/classes/index.d.ts +49 -1
  24. package/classes/index.js +56 -1
  25. package/classes/vscode.css-custom-data.json +1 -1
  26. package/css/analytical.css +3 -1
  27. package/css/app.css +4 -4
  28. package/css/clamp.css +92 -0
  29. package/css/figure.css +102 -0
  30. package/css/highlights.css +50 -0
  31. package/css/interval.css +90 -0
  32. package/css/primitives.css +2 -3
  33. package/css/report-kit.css +38 -0
  34. package/css/report.css +51 -4
  35. package/css/sidenote.css +12 -2
  36. package/css/site.css +2 -1
  37. package/css/sources.css +5 -0
  38. package/css/state.css +120 -1
  39. package/css/table.css +4 -0
  40. package/css/tokens.css +9 -9
  41. package/css/workbench.css +101 -8
  42. package/dist/bronto.css +1 -1
  43. package/dist/css/analytical.css +1 -1
  44. package/dist/css/app.css +1 -1
  45. package/dist/css/clamp.css +1 -0
  46. package/dist/css/figure.css +1 -0
  47. package/dist/css/highlights.css +1 -0
  48. package/dist/css/interval.css +1 -0
  49. package/dist/css/primitives.css +1 -1
  50. package/dist/css/report-kit.css +1 -0
  51. package/dist/css/report.css +1 -1
  52. package/dist/css/sidenote.css +1 -1
  53. package/dist/css/site.css +1 -1
  54. package/dist/css/sources.css +1 -1
  55. package/dist/css/state.css +1 -1
  56. package/dist/css/table.css +1 -1
  57. package/dist/css/tokens.css +1 -1
  58. package/dist/css/workbench.css +1 -1
  59. package/docs/adr/0002-scope-and-2026-baseline.md +1 -1
  60. package/docs/architecture.md +67 -43
  61. package/docs/clamp.md +49 -0
  62. package/docs/contrast.md +34 -24
  63. package/docs/d2.md +37 -0
  64. package/docs/figure.md +71 -0
  65. package/docs/frontier-primitives.md +48 -23
  66. package/docs/highlights.md +52 -0
  67. package/docs/interop/tailwind.md +148 -0
  68. package/docs/interval.md +55 -0
  69. package/docs/legends.md +3 -2
  70. package/docs/mermaid.md +6 -0
  71. package/docs/migrations/0.2-to-0.3.md +80 -0
  72. package/docs/migrations/0.3-to-0.4.md +48 -0
  73. package/docs/migrations/0.4-to-0.5.md +96 -0
  74. package/docs/migrations/0.5-to-0.6.md +82 -0
  75. package/docs/package-contract.md +40 -2
  76. package/docs/reference.md +79 -6
  77. package/docs/reporting.md +132 -56
  78. package/docs/sidenote.md +7 -1
  79. package/docs/sources.md +1 -1
  80. package/docs/stability.md +5 -3
  81. package/docs/state.md +67 -10
  82. package/docs/theming.md +10 -2
  83. package/docs/usage.md +31 -11
  84. package/docs/workbench.md +59 -18
  85. package/llms.txt +82 -14
  86. package/package.json +68 -6
  87. package/qwik/index.d.ts +1 -0
  88. package/qwik/index.d.ts.map +1 -1
  89. package/qwik/index.js +26 -21
  90. package/react/index.d.ts +1 -0
  91. package/react/index.d.ts.map +1 -1
  92. package/react/index.js +4 -1
  93. package/schemas/report-claims.v1.schema.json +137 -0
  94. package/solid/index.d.ts +2 -0
  95. package/solid/index.d.ts.map +1 -1
  96. package/solid/index.js +3 -0
  97. package/svelte/index.d.ts +88 -0
  98. package/svelte/index.d.ts.map +1 -0
  99. package/svelte/index.js +166 -0
  100. package/tailwind.css +87 -0
  101. package/tokens/figma.variables.json +2241 -0
  102. package/tokens/index.js +1 -1
  103. package/tokens/index.json +2 -2
  104. package/tokens/resolved.json +3 -3
  105. package/tokens/tokens.dtcg.json +1 -1
  106. package/vue/index.d.ts +79 -0
  107. package/vue/index.d.ts.map +1 -0
  108. package/vue/index.js +197 -0
@@ -27,6 +27,8 @@ semantic versioning contract for the surfaces listed here.
27
27
  | --- | --- | --- | --- | --- |
28
28
  | `.` | style: `./dist/bronto.css`<br>default: `./dist/bronto.css` | CSS root bundle | Stable | CSS-only package root. Supported as a CSS side-effect import in CSS-aware bundlers; not a Node/runtime JS entrypoint. |
29
29
  | `./dist/bronto.css` | `./dist/bronto.css` | Flattened CSS bundle | Stable path | The prebuilt default stylesheet. Generated from css/core.css and byte-checked by check:dist. |
30
+ | `./tailwind` | `./tailwind.css` | Tailwind CSS bridge | Stable additive | CSS-only Tailwind v4 theme/variant bridge. It maps Bronto tokens into Tailwind namespaces; it does not import component CSS. |
31
+ | `./tailwind.css` | `./tailwind.css` | Tailwind CSS bridge | Stable additive | CSS-only Tailwind v4 theme/variant bridge. It maps Bronto tokens into Tailwind namespaces; it does not import component CSS. |
30
32
  | `./css` | `./css/core.css` | CSS source fan-out | Stable path | Bundler entrypoint for css/core.css. It preserves source @import boundaries and layer behavior. |
31
33
  | `./css/core.css` | `./css/core.css` | CSS source fan-out | Stable path | Source fan-out file for consumers that want the authored leaf graph through a bundler. |
32
34
  | `./css/tokens.css` | `./dist/css/tokens.css` | Bundled layered CSS leaf | Stable additive | Generated layered direct-import leaf. Also included in dist/bronto.css. |
@@ -47,6 +49,7 @@ semantic versioning contract for the surfaces listed here.
47
49
  | `./css/skins.css` | `./dist/css/skins.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
48
50
  | `./css/dataviz.css` | `./dist/css/dataviz.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
49
51
  | `./css/report.css` | `./dist/css/report.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
52
+ | `./css/figure.css` | `./dist/css/figure.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
50
53
  | `./css/annotations.css` | `./dist/css/annotations.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
51
54
  | `./css/legend.css` | `./dist/css/legend.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
52
55
  | `./css/marks.css` | `./dist/css/marks.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
@@ -55,6 +58,9 @@ semantic versioning contract for the surfaces listed here.
55
58
  | `./css/crosshair.css` | `./dist/css/crosshair.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
56
59
  | `./css/selection.css` | `./dist/css/selection.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
57
60
  | `./css/sources.css` | `./dist/css/sources.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
61
+ | `./css/interval.css` | `./dist/css/interval.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
62
+ | `./css/clamp.css` | `./dist/css/clamp.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
63
+ | `./css/highlights.css` | `./dist/css/highlights.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
58
64
  | `./css/diff.css` | `./dist/css/diff.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
59
65
  | `./css/code.css` | `./dist/css/code.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
60
66
  | `./css/spark.css` | `./dist/css/spark.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
@@ -69,6 +75,7 @@ semantic versioning contract for the surfaces listed here.
69
75
  | `./css/workbench.css` | `./dist/css/workbench.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
70
76
  | `./css/command.css` | `./dist/css/command.css` | Opt-in layered CSS leaf | Stable additive | Generated layered direct-import leaf. Opt-in and not included in dist/bronto.css. |
71
77
  | `./css/analytical.css` | `./dist/css/analytical.css` | Opt-in CSS roll-up | Stable additive | Generated layered roll-up of the analytical leaves. Not included in the default bundle. |
78
+ | `./css/report-kit.css` | `./dist/css/report-kit.css` | Opt-in CSS roll-up | Stable additive | Generated layered roll-up for complete static reports. Not included in the default bundle. |
72
79
  | `./css/unlayered/tokens.css` | `./css/tokens.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
73
80
  | `./css/unlayered/fonts.css` | `./css/fonts.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
74
81
  | `./css/unlayered/base.css` | `./css/base.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
@@ -87,6 +94,7 @@ semantic versioning contract for the surfaces listed here.
87
94
  | `./css/unlayered/skins.css` | `./css/skins.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
88
95
  | `./css/unlayered/dataviz.css` | `./css/dataviz.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
89
96
  | `./css/unlayered/report.css` | `./css/report.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
97
+ | `./css/unlayered/figure.css` | `./css/figure.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
90
98
  | `./css/unlayered/annotations.css` | `./css/annotations.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
91
99
  | `./css/unlayered/legend.css` | `./css/legend.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
92
100
  | `./css/unlayered/marks.css` | `./css/marks.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
@@ -95,6 +103,9 @@ semantic versioning contract for the surfaces listed here.
95
103
  | `./css/unlayered/crosshair.css` | `./css/crosshair.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
96
104
  | `./css/unlayered/selection.css` | `./css/selection.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
97
105
  | `./css/unlayered/sources.css` | `./css/sources.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
106
+ | `./css/unlayered/interval.css` | `./css/interval.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
107
+ | `./css/unlayered/clamp.css` | `./css/clamp.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
108
+ | `./css/unlayered/highlights.css` | `./css/highlights.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
98
109
  | `./css/unlayered/diff.css` | `./css/diff.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
99
110
  | `./css/unlayered/code.css` | `./css/code.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
100
111
  | `./css/unlayered/spark.css` | `./css/spark.css` | Unlayered CSS leaf | Stable path | Raw authored CSS leaf for consumers that deliberately opt out of @layer bronto on that leaf. |
@@ -113,8 +124,11 @@ semantic versioning contract for the surfaces listed here.
113
124
  | `./tokens.json` | `./tokens/index.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
114
125
  | `./tokens.dtcg.json` | `./tokens/tokens.dtcg.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
115
126
  | `./tokens/resolved.json` | `./tokens/resolved.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
127
+ | `./tokens/figma.variables.json` | `./tokens/figma.variables.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
116
128
  | `./shiki/nothing.json` | `./shiki/nothing.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
117
129
  | `./llms.txt` | `./llms.txt` | Agent entrypoint | Stable path | Plain-text orientation file shipped for offline agents and tooling. |
130
+ | `./MIGRATIONS.json` | `./MIGRATIONS.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
131
+ | `./schemas/report-claims.v1.schema.json` | `./schemas/report-claims.v1.schema.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
118
132
  | `./docs/architecture.md` | `./docs/architecture.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
119
133
  | `./docs/reference.md` | `./docs/reference.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
120
134
  | `./docs/theming.md` | `./docs/theming.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -129,6 +143,7 @@ semantic versioning contract for the surfaces listed here.
129
143
  | `./docs/mermaid.md` | `./docs/mermaid.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
130
144
  | `./docs/d2.md` | `./docs/d2.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
131
145
  | `./docs/vega.md` | `./docs/vega.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
146
+ | `./docs/figure.md` | `./docs/figure.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
132
147
  | `./docs/annotations.md` | `./docs/annotations.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
133
148
  | `./docs/legends.md` | `./docs/legends.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
134
149
  | `./docs/marks.md` | `./docs/marks.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -137,6 +152,9 @@ semantic versioning contract for the surfaces listed here.
137
152
  | `./docs/crosshair.md` | `./docs/crosshair.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
138
153
  | `./docs/selection.md` | `./docs/selection.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
139
154
  | `./docs/sources.md` | `./docs/sources.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
155
+ | `./docs/interval.md` | `./docs/interval.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
156
+ | `./docs/clamp.md` | `./docs/clamp.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
157
+ | `./docs/highlights.md` | `./docs/highlights.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
140
158
  | `./docs/diff.md` | `./docs/diff.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
141
159
  | `./docs/code.md` | `./docs/code.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
142
160
  | `./docs/spark.md` | `./docs/spark.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -150,6 +168,11 @@ semantic versioning contract for the surfaces listed here.
150
168
  | `./docs/generated.md` | `./docs/generated.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
151
169
  | `./docs/workbench.md` | `./docs/workbench.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
152
170
  | `./docs/command.md` | `./docs/command.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
171
+ | `./docs/interop/tailwind.md` | `./docs/interop/tailwind.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
172
+ | `./docs/migrations/0.2-to-0.3.md` | `./docs/migrations/0.2-to-0.3.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
173
+ | `./docs/migrations/0.3-to-0.4.md` | `./docs/migrations/0.3-to-0.4.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
174
+ | `./docs/migrations/0.4-to-0.5.md` | `./docs/migrations/0.4-to-0.5.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
175
+ | `./docs/migrations/0.5-to-0.6.md` | `./docs/migrations/0.5-to-0.6.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
153
176
  | `./docs/adr/0001-color-system.md` | `./docs/adr/0001-color-system.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
154
177
  | `./docs/adr/0002-scope-and-2026-baseline.md` | `./docs/adr/0002-scope-and-2026-baseline.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
155
178
  | `./docs/adr/0003-theme-model.md` | `./docs/adr/0003-theme-model.md` | Shipped documentation | Stable path | Markdown documentation shipped in the tarball. Paths are public reading assets within a compatible minor. |
@@ -162,6 +185,8 @@ semantic versioning contract for the surfaces listed here.
162
185
  | `./react` | types: `./react/index.d.ts`<br>default: `./react/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
163
186
  | `./solid` | types: `./solid/index.d.ts`<br>default: `./solid/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
164
187
  | `./qwik` | types: `./qwik/index.d.ts`<br>default: `./qwik/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
188
+ | `./svelte` | types: `./svelte/index.d.ts`<br>default: `./svelte/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
189
+ | `./vue` | types: `./vue/index.d.ts`<br>default: `./vue/index.js` | Framework binding JS | Stable thin adapter | Optional peer wrapper over vanilla behaviors. It owns lifecycle hookup, not markup or component state. |
165
190
  | `./skins` | types: `./tokens/skins.d.ts`<br>default: `./tokens/skins.js` | Renderer/theme helper JS | Stable additive | ESM theme data/helpers for opt-in skins, chart palettes, and external renderers. |
166
191
  | `./charts` | types: `./tokens/charts.d.ts`<br>default: `./tokens/charts.js` | Renderer/theme helper JS | Stable additive | ESM theme data/helpers for opt-in skins, chart palettes, and external renderers. |
167
192
  | `./charts.json` | `./tokens/charts.json` | Machine-readable data | Stable additive | JSON package data for non-JS/tooling consumers. Shape is public unless the paired doc marks a field internal. |
@@ -183,16 +208,20 @@ always includes `package.json`, `README.md`, `LICENSE`, and
183
208
  | --- | --- | --- |
184
209
  | `css` | Source CSS directory | Public source leaves. Mostly hand-authored; generated exceptions are called out in the provenance table. |
185
210
  | `dist` | Generated CSS directory | Prebuilt layered bundle and leaves. Never hand-edit. |
211
+ | `tailwind.css` | Tailwind CSS bridge | CSS-only Tailwind v4 theme/variant bridge; hand-authored and not part of the default Bronto bundle. |
186
212
  | `fonts` | Vendored assets | Doto woff2 files plus OFL license. |
187
213
  | `tokens` | Mixed source/generated data | Token source plus generated JSON, declarations, and renderer theme data. |
188
214
  | `classes` | Mixed source/generated data | Class recipe source plus generated JSON/declarations/custom-data. |
189
215
  | `behaviors` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
190
216
  | `glyphs` | Authored public JS directory | Glyph registry/renderers shipped as JS; declarations are generated. |
217
+ | `schemas` | Machine-readable schemas | Declarative JSON schemas for package-adjacent report/tooling contracts. |
191
218
  | `annotations` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
192
219
  | `connectors` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
193
220
  | `react` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
194
221
  | `solid` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
195
222
  | `qwik` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
223
+ | `svelte` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
224
+ | `vue` | Authored public JS directory | ESM source shipped as-is; adjacent declarations/maps are generated. |
196
225
  | `shiki` | Theme data | Shiki theme JSON on the governed palette. |
197
226
  | `llms.txt` | Agent entrypoint | Shipped plain-text orientation for offline LLM/agent consumers. |
198
227
  | `CHANGELOG.md` | Release record | Shipped historical release notes. |
@@ -211,6 +240,7 @@ always includes `package.json`, `README.md`, `LICENSE`, and
211
240
  | `docs/mermaid.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
212
241
  | `docs/d2.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
213
242
  | `docs/vega.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
243
+ | `docs/figure.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
214
244
  | `docs/annotations.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
215
245
  | `docs/legends.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
216
246
  | `docs/marks.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
@@ -219,6 +249,9 @@ always includes `package.json`, `README.md`, `LICENSE`, and
219
249
  | `docs/crosshair.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
220
250
  | `docs/selection.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
221
251
  | `docs/sources.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
252
+ | `docs/interval.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
253
+ | `docs/clamp.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
254
+ | `docs/highlights.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
222
255
  | `docs/diff.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
223
256
  | `docs/code.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
224
257
  | `docs/spark.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
@@ -232,6 +265,11 @@ always includes `package.json`, `README.md`, `LICENSE`, and
232
265
  | `docs/generated.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
233
266
  | `docs/workbench.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
234
267
  | `docs/command.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
268
+ | `docs/interop/tailwind.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
269
+ | `docs/migrations/0.2-to-0.3.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
270
+ | `docs/migrations/0.3-to-0.4.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
271
+ | `docs/migrations/0.4-to-0.5.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
272
+ | `docs/migrations/0.5-to-0.6.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
235
273
  | `docs/adr/0001-color-system.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
236
274
  | `docs/adr/0002-scope-and-2026-baseline.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
237
275
  | `docs/adr/0003-theme-model.md` | Shipped documentation | Curated Markdown reading asset shipped in the npm tarball. |
@@ -245,9 +283,9 @@ result. The listed gates are part of `npm run check`.
245
283
  | Surface | Source of truth | Generated outputs | Generator | Gate | Note |
246
284
  | --- | --- | --- | --- | --- | --- |
247
285
  | Package manifest | `package.json` | docs/package-contract.md | `npm run package-contract:build` | check:fresh | The complete export/file matrix in this document is generated from the manifest. |
248
- | Token model | `tokens/index.js` | css/tokens.css; tokens/index.json; tokens/tokens.dtcg.json; tokens/resolved.json; tokens/index.d.ts | `npm run tokens:css:build; tokens:build; dtcg:build; resolved:build; dts:build` | check:fresh; check:contrast | Token names/roles are public. Resolved values are visual tuning before 1.0. |
286
+ | Token model | `tokens/index.js` | css/tokens.css; tokens/index.json; tokens/tokens.dtcg.json; tokens/resolved.json; tokens/figma.variables.json; tokens/index.d.ts | `npm run tokens:css:build; tokens:build; dtcg:build; resolved:build; figma:variables:build; dts:build` | check:fresh; check:contrast | Token names/roles are public. Resolved and Figma handoff values are visual tuning before 1.0. |
249
287
  | Class registry | `classes/index.js plus css/*.css selectors` | classes/classes.json; classes/index.d.ts; classes/vscode.css-custom-data.json; docs/reference.md | `npm run classes:json:build; dts:build; vscode:build; reference:build` | check:fresh; check:classes; check:contract | The typed registry, JSON vocabulary, and generated reference stay aligned with real selectors. |
250
- | Authored CSS graph | `css/core.css plus css/*.css leaves` | dist/bronto.css; dist/css/*.css (40 layered outputs) | `npm run dist:build` | check:dist; check:exports | Default bundle and direct layered leaf imports are generated from authored CSS and size-gated. |
288
+ | Authored CSS graph | `css/core.css plus css/*.css leaves` | dist/bronto.css; dist/css/*.css (46 layered outputs) | `npm run dist:build` | check:dist; check:exports | Default bundle and direct layered leaf imports are generated from authored CSS and size-gated. |
251
289
  | JSDoc-authored public JS | `behaviors/; annotations/; connectors/; react/; solid/; qwik/` | adjacent *.d.ts and *.d.ts.map files | `npm run dts:emit` | check:dts-emit; check:types; check:attw; check:publint | Declarations are emitted from the shipped JS, not separately maintained. |
252
290
  | Glyph registry | `glyphs/glyphs.js` | glyphs/glyphs.d.ts | `npm run glyphs:build` | check:glyphs; npm test | Glyph names and render options are public. The registry stays sorted and type-covered. |
253
291
  | Display colorways | `tokens/skins.js` | css/skins.css; tokens/skins.d.ts | `npm run skins:build` | check:skins; check:contrast | Skins are opt-in root-level choices and never part of dist/bronto.css. |
package/docs/reference.md CHANGED
@@ -9,7 +9,7 @@ rendering of every class is the kitchen-sink demo:
9
9
  **<https://ponchia.github.io/bronto-ui/>**. Theming knobs and the token
10
10
  contract: [docs/theming.md](theming.md).
11
11
 
12
- - 593 classes across 171 component groups
12
+ - 634 classes across 177 component groups
13
13
  - Import the typed registry: `import { cls, ui, cx } from '@ponchia/ui/classes'`
14
14
  - Validate markup as data (no JS/TS): `@ponchia/ui/classes.json` — the same
15
15
  vocabulary as language-neutral JSON (`groups`, `classes`, `states`,
@@ -348,6 +348,17 @@ each one matches a real selector in the stylesheet.
348
348
  | `cls.claimUnknown` | `ui-claim--unknown` | modifier |
349
349
  | `cls.claimUnsupported` | `ui-claim--unsupported` | modifier |
350
350
 
351
+ ### `.ui-clamp`
352
+
353
+ | Registry key | Class | Kind |
354
+ | --- | --- | --- |
355
+ | `cls.clamp` | `ui-clamp` | base |
356
+ | `cls.clampBody` | `ui-clamp__body` | part |
357
+ | `cls.clampControl` | `ui-clamp__control` | part |
358
+ | `cls.clampLess` | `ui-clamp__less` | part |
359
+ | `cls.clampMore` | `ui-clamp__more` | part |
360
+ | `cls.clampToggle` | `ui-clamp__toggle` | part |
361
+
351
362
  ### `.ui-cluster`
352
363
 
353
364
  | Registry key | Class | Kind |
@@ -616,6 +627,20 @@ each one matches a real selector in the stylesheet.
616
627
  | --- | --- | --- |
617
628
  | `cls.field` | `ui-field` | base |
618
629
 
630
+ ### `.ui-figure`
631
+
632
+ | Registry key | Class | Kind |
633
+ | --- | --- | --- |
634
+ | `cls.figure` | `ui-figure` | base |
635
+ | `cls.figureBody` | `ui-figure__body` | part |
636
+ | `cls.figureBodyKeyRight` | `ui-figure__body--key-right` | modifier |
637
+ | `cls.figureCaption` | `ui-figure__caption` | part |
638
+ | `cls.figureData` | `ui-figure__data` | part |
639
+ | `cls.figureKey` | `ui-figure__key` | part |
640
+ | `cls.figureMedia` | `ui-figure__media` | part |
641
+ | `cls.figureOverlay` | `ui-figure__overlay` | part |
642
+ | `cls.figureStage` | `ui-figure__stage` | part |
643
+
619
644
  ### `.ui-file`
620
645
 
621
646
  | Registry key | Class | Kind |
@@ -649,6 +674,12 @@ each one matches a real selector in the stylesheet.
649
674
  | --- | --- | --- |
650
675
  | `cls.halftone` | `ui-halftone` | base |
651
676
 
677
+ ### `.ui-highlights`
678
+
679
+ | Registry key | Class | Kind |
680
+ | --- | --- | --- |
681
+ | `cls.highlights` | `ui-highlights` | base |
682
+
652
683
  ### `.ui-hint`
653
684
 
654
685
  | Registry key | Class | Kind |
@@ -691,6 +722,36 @@ each one matches a real selector in the stylesheet.
691
722
  | `cls.inspectorBody` | `ui-inspector__body` | part |
692
723
  | `cls.inspectorHead` | `ui-inspector__head` | part |
693
724
 
725
+ ### `.ui-interval`
726
+
727
+ | Registry key | Class | Kind |
728
+ | --- | --- | --- |
729
+ | `cls.interval` | `ui-interval` | base |
730
+ | `cls.intervalBounds` | `ui-interval__bounds` | part |
731
+ | `cls.intervalLabel` | `ui-interval__label` | part |
732
+ | `cls.intervalPoint` | `ui-interval__point` | part |
733
+ | `cls.intervalRange` | `ui-interval__range` | part |
734
+ | `cls.intervalTrack` | `ui-interval__track` | part |
735
+
736
+ ### `.ui-job`
737
+
738
+ | Registry key | Class | Kind |
739
+ | --- | --- | --- |
740
+ | `cls.job` | `ui-job` | base |
741
+ | `cls.jobActions` | `ui-job__actions` | part |
742
+ | `cls.jobBar` | `ui-job__bar` | part |
743
+ | `cls.jobBody` | `ui-job__body` | part |
744
+ | `cls.jobHead` | `ui-job__head` | part |
745
+ | `cls.jobMeta` | `ui-job__meta` | part |
746
+ | `cls.jobProgress` | `ui-job__progress` | part |
747
+ | `cls.jobTitle` | `ui-job__title` | part |
748
+ | `cls.jobBlocked` | `ui-job--blocked` | modifier |
749
+ | `cls.jobCompact` | `ui-job--compact` | modifier |
750
+ | `cls.jobComplete` | `ui-job--complete` | modifier |
751
+ | `cls.jobFailed` | `ui-job--failed` | modifier |
752
+ | `cls.jobQueued` | `ui-job--queued` | modifier |
753
+ | `cls.jobRunning` | `ui-job--running` | modifier |
754
+
694
755
  ### `.ui-kbd`
695
756
 
696
757
  | Registry key | Class | Kind |
@@ -1189,6 +1250,16 @@ each one matches a real selector in the stylesheet.
1189
1250
  | --- | --- | --- |
1190
1251
  | `cls.spinner` | `ui-spinner` | base |
1191
1252
 
1253
+ ### `.ui-splitter`
1254
+
1255
+ | Registry key | Class | Kind |
1256
+ | --- | --- | --- |
1257
+ | `cls.splitter` | `ui-splitter` | base |
1258
+ | `cls.splitterHandle` | `ui-splitter__handle` | part |
1259
+ | `cls.splitterPane` | `ui-splitter__pane` | part |
1260
+ | `cls.splitterHorizontal` | `ui-splitter--horizontal` | modifier |
1261
+ | `cls.splitterVertical` | `ui-splitter--vertical` | modifier |
1262
+
1192
1263
  ### `.ui-spotlight`
1193
1264
 
1194
1265
  | Registry key | Class | Kind |
@@ -1517,9 +1588,11 @@ works in any framework without a binding layer:
1517
1588
  vocabulary onto a tone is application logic, not a framework class.
1518
1589
  - **Modal** — native `<dialog>` gets backdrop + top-layer + focus-trap
1519
1590
  free. For a controlled/portal modal, add `is-open`
1520
- (`ui.modal({ open: true })`) for the same skin/layout; the
1521
- backdrop, top-layer stacking AND focus-trap are then yours (`.is-open`
1522
- is a bare grid it does not float or stack on its own).
1591
+ (`ui.modal({ open: true })`) for the same skin/layout, mark the overlay
1592
+ `data-bronto-modal`, and run `initModal()` for the inert focus trap,
1593
+ focus-return, and Escape close signal. You still own the `is-open` state,
1594
+ backdrop, and top-layer stacking (`.is-open` is a bare grid — it does not
1595
+ float or stack on its own).
1523
1596
  - **Current page** — mark the active link with `aria-current="page"`; it is
1524
1597
  the programmatic cue the navs honour (`ui-sitenav`, `ui-app-nav`). The
1525
1598
  `.is-active` class is the visual-only equivalent on `ui-app-nav`/`ui-tab`;
@@ -1545,7 +1618,7 @@ works in any framework without a binding layer:
1545
1618
  - **Opt-in component CSS** — a few classes are not in the core bundle and need
1546
1619
  their leaf imported, or they render unstyled: `ui-property`/`ui-readout` →
1547
1620
  `@ponchia/ui/css/workbench.css`; `ui-mark`/`ui-bracket-note` →
1548
- `@ponchia/ui/css/marks.css`; the analytical leaves (`ui-annotations`,
1621
+ `@ponchia/ui/css/marks.css`; the analytical leaves (`ui-annotation`,
1549
1622
  `ui-crosshair`, `ui-spotlight`, …) → their matching leaf.
1550
1623
  - **Loaders need their children** — `ui-dotspinner` requires exactly eight
1551
1624
  `<i>` children, `ui-dotloader` three `<span>`, and a static `ui-dotbar`
@@ -1694,7 +1767,7 @@ Exact mirror of the `:root` blocks in `css/tokens.css`
1694
1767
  | `--text-dim` | `#a0a0a0` |
1695
1768
  | `--accent` | `#ff3b41` |
1696
1769
  | `--accent-ramp-end` | `#000000` |
1697
- | `--accent-strong` | `color-mix(in srgb, var(--accent) 84%, #fff)` |
1770
+ | `--accent-strong` | `color-mix(in srgb, var(--accent) 80%, #fff)` |
1698
1771
  | `--accent-text` | `var(--accent-strong)` |
1699
1772
  | `--on-accent` | `var(--button-text)` |
1700
1773
  | `--accent-soft` | `color-mix(in srgb, var(--accent) 14%, transparent)` |