@capillaryjs/capillary-ui 1.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/CHANGELOG.md +459 -0
  2. package/LICENSE +55 -0
  3. package/NOTICE +2 -0
  4. package/README.md +853 -0
  5. package/colors/README.md +63 -0
  6. package/colors/gray/colors.css +16 -0
  7. package/colors/green/colors.css +16 -0
  8. package/colors/iceblue/colors.css +19 -0
  9. package/colors/ocean/colors.css +16 -0
  10. package/colors/orange/colors.css +16 -0
  11. package/colors/purple/colors.css +16 -0
  12. package/colors/red/colors.css +16 -0
  13. package/colors/yellow/colors.css +16 -0
  14. package/dist/Components/Placeholder.d.ts +15 -0
  15. package/dist/Components/Placeholder.d.ts.map +1 -0
  16. package/dist/Components/app/app.d.ts +41 -0
  17. package/dist/Components/app/app.d.ts.map +1 -0
  18. package/dist/Components/component.d.ts +256 -0
  19. package/dist/Components/component.d.ts.map +1 -0
  20. package/dist/Components/controlUtils.d.ts +23 -0
  21. package/dist/Components/controlUtils.d.ts.map +1 -0
  22. package/dist/Components/data/descriptionList.d.ts +23 -0
  23. package/dist/Components/data/descriptionList.d.ts.map +1 -0
  24. package/dist/Components/data/filterState.d.ts +38 -0
  25. package/dist/Components/data/filterState.d.ts.map +1 -0
  26. package/dist/Components/data/infoPanel.d.ts +29 -0
  27. package/dist/Components/data/infoPanel.d.ts.map +1 -0
  28. package/dist/Components/data/listview/listview.d.ts +51 -0
  29. package/dist/Components/data/listview/listview.d.ts.map +1 -0
  30. package/dist/Components/data/selectionhandler.d.ts +87 -0
  31. package/dist/Components/data/selectionhandler.d.ts.map +1 -0
  32. package/dist/Components/data/table/DataTable.d.ts +79 -0
  33. package/dist/Components/data/table/DataTable.d.ts.map +1 -0
  34. package/dist/Components/data/table/FilterPanel.d.ts +41 -0
  35. package/dist/Components/data/table/FilterPanel.d.ts.map +1 -0
  36. package/dist/Components/data/table/TableHeader.d.ts +23 -0
  37. package/dist/Components/data/table/TableHeader.d.ts.map +1 -0
  38. package/dist/Components/data/table/TableHeaderCell.d.ts +41 -0
  39. package/dist/Components/data/table/TableHeaderCell.d.ts.map +1 -0
  40. package/dist/Components/data/table/tableDataSource.d.ts +49 -0
  41. package/dist/Components/data/table/tableDataSource.d.ts.map +1 -0
  42. package/dist/Components/data/table/tableQuery.d.ts +29 -0
  43. package/dist/Components/data/table/tableQuery.d.ts.map +1 -0
  44. package/dist/Components/data/treeview/treeModel.d.ts +23 -0
  45. package/dist/Components/data/treeview/treeModel.d.ts.map +1 -0
  46. package/dist/Components/data/treeview/treeitem.d.ts +21 -0
  47. package/dist/Components/data/treeview/treeitem.d.ts.map +1 -0
  48. package/dist/Components/data/treeview/treeview.d.ts +49 -0
  49. package/dist/Components/data/treeview/treeview.d.ts.map +1 -0
  50. package/dist/Components/dialog/dialog.d.ts +46 -0
  51. package/dist/Components/dialog/dialog.d.ts.map +1 -0
  52. package/dist/Components/layout/declarativeRegion.d.ts +30 -0
  53. package/dist/Components/layout/declarativeRegion.d.ts.map +1 -0
  54. package/dist/Components/layout/groupBox.d.ts +21 -0
  55. package/dist/Components/layout/groupBox.d.ts.map +1 -0
  56. package/dist/Components/layout/header.d.ts +20 -0
  57. package/dist/Components/layout/header.d.ts.map +1 -0
  58. package/dist/Components/layout/layout.d.ts +28 -0
  59. package/dist/Components/layout/layout.d.ts.map +1 -0
  60. package/dist/Components/layout/layoutTraits.d.ts +39 -0
  61. package/dist/Components/layout/layoutTraits.d.ts.map +1 -0
  62. package/dist/Components/layout/optionGroup.d.ts +35 -0
  63. package/dist/Components/layout/optionGroup.d.ts.map +1 -0
  64. package/dist/Components/layout/optionsBox.d.ts +12 -0
  65. package/dist/Components/layout/optionsBox.d.ts.map +1 -0
  66. package/dist/Components/layout/panel.d.ts +34 -0
  67. package/dist/Components/layout/panel.d.ts.map +1 -0
  68. package/dist/Components/layout/routedSelection.d.ts +10 -0
  69. package/dist/Components/layout/routedSelection.d.ts.map +1 -0
  70. package/dist/Components/layout/sidebar.d.ts +27 -0
  71. package/dist/Components/layout/sidebar.d.ts.map +1 -0
  72. package/dist/Components/layout/splitView.d.ts +82 -0
  73. package/dist/Components/layout/splitView.d.ts.map +1 -0
  74. package/dist/Components/layout/tabpanel/tab.d.ts +15 -0
  75. package/dist/Components/layout/tabpanel/tab.d.ts.map +1 -0
  76. package/dist/Components/layout/tabpanel/tabline.d.ts +31 -0
  77. package/dist/Components/layout/tabpanel/tabline.d.ts.map +1 -0
  78. package/dist/Components/layout/tabpanel/tabpanel.d.ts +44 -0
  79. package/dist/Components/layout/tabpanel/tabpanel.d.ts.map +1 -0
  80. package/dist/Components/lineinputs/CheckableControl.d.ts +7 -0
  81. package/dist/Components/lineinputs/CheckableControl.d.ts.map +1 -0
  82. package/dist/Components/lineinputs/LabeledInputControl.d.ts +7 -0
  83. package/dist/Components/lineinputs/LabeledInputControl.d.ts.map +1 -0
  84. package/dist/Components/lineinputs/SelectControl.d.ts +7 -0
  85. package/dist/Components/lineinputs/SelectControl.d.ts.map +1 -0
  86. package/dist/Components/lineinputs/checkbox/Checkbox.d.ts +46 -0
  87. package/dist/Components/lineinputs/checkbox/Checkbox.d.ts.map +1 -0
  88. package/dist/Components/lineinputs/checkbox/QuadCheckbox.d.ts +11 -0
  89. package/dist/Components/lineinputs/checkbox/QuadCheckbox.d.ts.map +1 -0
  90. package/dist/Components/lineinputs/checkbox/TriCheckbox.d.ts +11 -0
  91. package/dist/Components/lineinputs/checkbox/TriCheckbox.d.ts.map +1 -0
  92. package/dist/Components/lineinputs/datetime/Calendar.d.ts +23 -0
  93. package/dist/Components/lineinputs/datetime/Calendar.d.ts.map +1 -0
  94. package/dist/Components/lineinputs/datetime/DatePicker.d.ts +62 -0
  95. package/dist/Components/lineinputs/datetime/DatePicker.d.ts.map +1 -0
  96. package/dist/Components/lineinputs/datetime/DateTimePicker.d.ts +52 -0
  97. package/dist/Components/lineinputs/datetime/DateTimePicker.d.ts.map +1 -0
  98. package/dist/Components/lineinputs/datetime/TimePicker.d.ts +46 -0
  99. package/dist/Components/lineinputs/datetime/TimePicker.d.ts.map +1 -0
  100. package/dist/Components/lineinputs/datetime/civilDate.d.ts +37 -0
  101. package/dist/Components/lineinputs/datetime/civilDate.d.ts.map +1 -0
  102. package/dist/Components/lineinputs/datetime/timeString.d.ts +26 -0
  103. package/dist/Components/lineinputs/datetime/timeString.d.ts.map +1 -0
  104. package/dist/Components/lineinputs/dropdown.d.ts +49 -0
  105. package/dist/Components/lineinputs/dropdown.d.ts.map +1 -0
  106. package/dist/Components/lineinputs/label.d.ts +14 -0
  107. package/dist/Components/lineinputs/label.d.ts.map +1 -0
  108. package/dist/Components/lineinputs/radio.d.ts +69 -0
  109. package/dist/Components/lineinputs/radio.d.ts.map +1 -0
  110. package/dist/Components/lineinputs/textbox.d.ts +40 -0
  111. package/dist/Components/lineinputs/textbox.d.ts.map +1 -0
  112. package/dist/Components/lineinputs/toggle.d.ts +40 -0
  113. package/dist/Components/lineinputs/toggle.d.ts.map +1 -0
  114. package/dist/Components/menu/button.d.ts +31 -0
  115. package/dist/Components/menu/button.d.ts.map +1 -0
  116. package/dist/Components/menu/toolbar.d.ts +15 -0
  117. package/dist/Components/menu/toolbar.d.ts.map +1 -0
  118. package/dist/Components/navigation/breadcrumb.d.ts +31 -0
  119. package/dist/Components/navigation/breadcrumb.d.ts.map +1 -0
  120. package/dist/Components/navigation/navigationBar.d.ts +53 -0
  121. package/dist/Components/navigation/navigationBar.d.ts.map +1 -0
  122. package/dist/Components/status/progressBar.d.ts +23 -0
  123. package/dist/Components/status/progressBar.d.ts.map +1 -0
  124. package/dist/Components/status/statusPresentation.d.ts +21 -0
  125. package/dist/Components/status/statusPresentation.d.ts.map +1 -0
  126. package/dist/Components/theme/stylesheetPicker.d.ts +42 -0
  127. package/dist/Components/theme/stylesheetPicker.d.ts.map +1 -0
  128. package/dist/index.d.ts +68 -0
  129. package/dist/index.d.ts.map +1 -0
  130. package/dist/index.js +7736 -0
  131. package/dist/index.js.map +1 -0
  132. package/dist/jsx-dev-runtime-BAF7C1E1.js +1368 -0
  133. package/dist/jsx-dev-runtime-BAF7C1E1.js.map +1 -0
  134. package/dist/jsx-dev-runtime.d.ts +2 -0
  135. package/dist/jsx-dev-runtime.d.ts.map +1 -0
  136. package/dist/jsx-dev-runtime.js +6 -0
  137. package/dist/jsx-dev-runtime.js.map +1 -0
  138. package/dist/jsx-runtime.d.ts +26 -0
  139. package/dist/jsx-runtime.d.ts.map +1 -0
  140. package/dist/jsx-runtime.js +9 -0
  141. package/dist/jsx-runtime.js.map +1 -0
  142. package/dist/localization.d.ts +76 -0
  143. package/dist/localization.d.ts.map +1 -0
  144. package/dist/routing/RouteLink.d.ts +18 -0
  145. package/dist/routing/RouteLink.d.ts.map +1 -0
  146. package/dist/routing/RouteOutlet.d.ts +38 -0
  147. package/dist/routing/RouteOutlet.d.ts.map +1 -0
  148. package/dist/routing/RouteQuery.d.ts +19 -0
  149. package/dist/routing/RouteQuery.d.ts.map +1 -0
  150. package/dist/routing/RouteScope.d.ts +18 -0
  151. package/dist/routing/RouteScope.d.ts.map +1 -0
  152. package/dist/routing/RouteValue.d.ts +19 -0
  153. package/dist/routing/RouteValue.d.ts.map +1 -0
  154. package/dist/routing/navigationAdapter.d.ts +33 -0
  155. package/dist/routing/navigationAdapter.d.ts.map +1 -0
  156. package/dist/routing/route.d.ts +64 -0
  157. package/dist/routing/route.d.ts.map +1 -0
  158. package/dist/routing/router.d.ts +109 -0
  159. package/dist/routing/router.d.ts.map +1 -0
  160. package/dist/runtime.d.ts +34 -0
  161. package/dist/runtime.d.ts.map +1 -0
  162. package/dist/services.d.ts +45 -0
  163. package/dist/services.d.ts.map +1 -0
  164. package/dist/styling/styleRegistry.d.ts +15 -0
  165. package/dist/styling/styleRegistry.d.ts.map +1 -0
  166. package/dist/styling/theme.d.ts +39 -0
  167. package/dist/styling/theme.d.ts.map +1 -0
  168. package/dist/util/filterMode.d.ts +15 -0
  169. package/dist/util/filterMode.d.ts.map +1 -0
  170. package/docs/application-composition-guide.md +843 -0
  171. package/docs/application-layout-guide.md +553 -0
  172. package/package.json +90 -0
  173. package/styles/structural.css +2388 -0
  174. package/themes/README.md +99 -0
  175. package/themes/base.css +344 -0
  176. package/themes/java/theme.css +21 -0
  177. package/themes/minimal/theme.css +7 -0
  178. package/themes/shiny/theme.css +168 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,459 @@
1
+ # Capillary UI changelog
2
+
3
+ All notable changes to `@capillaryjs/capillary-ui` are documented here. The format
4
+ follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and Semantic
5
+ Versioning.
6
+
7
+ ## Unreleased
8
+
9
+ ## 1.0.0-alpha.1 - 2026-09-14
10
+
11
+ ### Changed
12
+
13
+ - Renamed the package from `@sylwellsoftware/fray` to
14
+ `@capillaryjs/capillary-ui`, public `Fray*`/`fray*` symbols to
15
+ `CapillaryUi*`/`capillaryUi*`, and supported `fray-*` custom elements and
16
+ CSS/data namespaces to the `cap-*` prefix. Existing released entries below
17
+ retain their historical names.
18
+
19
+ ## 1.4.0 - 2026-09-13
20
+
21
+ ### Added
22
+
23
+ - Added optional static localization to `FrayRuntime`: applications can supply
24
+ a BCP 47 locale and typed partial `FrayMessageOverrides` from their existing
25
+ localization system. Fray applies immutable per-runtime English fallback,
26
+ uses typed functions for parameterized accessibility messages, and formats
27
+ Gregorian Calendar month/year heading, weekday labels, and day numerals with
28
+ the selected locale.
29
+ Catalog loading, locale policy, application text, live switching, document
30
+ language/direction, and RTL remain application concerns.
31
+ - Added textual `ariaLabel` alternatives to `Checkbox` and `TableColumn` for
32
+ Fray-generated accessibility messages when visible labels are rich content.
33
+ - Added external destinations to `NavigationBar`: an item whose `to` is
34
+ `{kind: 'external', href}` renders a plain anchor the router never
35
+ intercepts, preserving native link behavior for cross-application and
36
+ cross-origin navigation without requiring a router in the runtime.
37
+ - Added the `Breadcrumb` navigation component: an ordered path of ancestor
38
+ router-aware links ending in an `aria-current="page"` current item, with
39
+ optional per-item `onClick` actions and accessible `nav`/`ol` semantics.
40
+ - Added the presentation-only `Layout` component with mutually exclusive
41
+ `horizontal`/`vertical` modifiers, named parent allocation, and explicit
42
+ scrolling. `Panel` now composes Layout as its body.
43
+ - Made `SplitView` a resizable two-pane control with required SplitPrimary and
44
+ SplitSecondary Layout panes, a focusable separator, pointer dragging,
45
+ orientation-appropriate keyboard resizing, minimum sizes, and `onResize`.
46
+ - Expanded the application composition guide with a decision rule for Layout,
47
+ Panel, and SplitView; guidance to prefer intentional layout boundaries over
48
+ anonymous layout wrappers; and updated allocation examples.
49
+
50
+ - Added `DeclarativeRegion` and `readDeclarativeRegions()` for defining
51
+ parent-specific, non-visual named content regions with duplicate, foreign,
52
+ required-region, and ordinary-content validation.
53
+ - Added `PanelToolbar`, `SidebarToolbar`, `SplitPrimary`, `SplitSecondary`,
54
+ `DialogActions`, and `OptionGroupHeaderEnd` declarative region markers.
55
+
56
+ - Added a packaged application composition guide covering workflow-led screen
57
+ design, persistent shells, state lifetime, layout and scrolling contracts,
58
+ content composition, and component reuse, alongside the repository layout guide.
59
+
60
+ - Added bounded layout allocation traits: `fray-layout-horizontal`,
61
+ `fray-layout-vertical`, `fray-size-natural`, `fray-size-flexible`, and
62
+ `fray-scroll`. `FrayApp` accepts root `layout`; `Header`, `NavigationBar`,
63
+ `Panel`, `Sidebar`, and `Toolbar` accept explicit host `allocation`.
64
+
65
+ - **Experimental:** `DatePicker`, `TimePicker`, and `DateTimePicker` components,
66
+ plus `CivilDate` and `TimeString` utility types and helpers. These are exported
67
+ from the package root and tagged `@experimental`; they may change in any
68
+ release until they stabilize and are not yet covered by the 1.x semver
69
+ guarantee.
70
+ - `InfoPanel` and `InfoField` components for presenting key-value summary
71
+ information in a bordered panel with an optional title. `InfoPanel` renders
72
+ panel chrome (background, border, shadow) with a `Header` when a `title` is
73
+ provided, and a native `<dl>` grid of `InfoField` children. `InfoField` renders
74
+ a native `dt`/`dd` pair with `label` and `value` props.
75
+
76
+ ### Fixed
77
+
78
+ - Loading and error presentation is now consistent across actions, line
79
+ inputs, choices, date/time controls, option groups, progress, and data
80
+ views. Loading uses the theme's animated working texture (with reduced-motion
81
+ and forced-colors fallbacks); errors use the semantic error color on the
82
+ relevant native surface plus an accessible icon/message. The icon and hidden
83
+ message are absolute overlays in every context, with details revealed from
84
+ the icon on hover or focus. `ListView`, `DataTable`, and `TreeView` now show
85
+ deterministic Bank2-style placeholders for empty initial loads and animate
86
+ retained rows during refresh; TreeView gains `placeholderCount`. The
87
+ `busy` live prop is available across input/choice controls and
88
+ `OptionGroup`, `Button` gains live `error`, and emitter-backed Dropdown
89
+ options derive busy/error feedback from their fetch snapshot.
90
+
91
+ - `NavigationBar` now rejects meaningless `exact` matching on external
92
+ destinations; the public item union exposes `exact` only for router-aware
93
+ targets. Blank external hrefs are also rejected consistently.
94
+
95
+ - `TreeView` now presents a localized loading state rather than a misleading
96
+ empty state while an empty node source is loading. Calendar day cells now use
97
+ the runtime locale's numeral system alongside its localized heading and
98
+ weekday labels.
99
+
100
+ - Fray-generated table sort/filter and Checkbox state labels no longer coerce
101
+ rich vnode labels to `"[object Object]"`.
102
+
103
+ - `ListView` now re-renders when its plain-array `items` prop changes. A static
104
+ `items` array was wrapped in an internal emitter only once at construction and
105
+ never synced on `setProps`, so a parent re-render with new items left the list
106
+ showing stale (or empty) content. `setProps` now syncs the owned items emitter,
107
+ matching `TreeView`'s `nodes` contract.
108
+
109
+ - Sized input controls (`Textbox`, `SelectControl`, `DatePicker`) no longer clip
110
+ invisibly inside narrow containers. Each now caps its field at the container
111
+ width (`max-width: 100%`), shrinks to a usable floor via the new optional
112
+ `--input-min-width` variable (default `6rem`), and lets its host shrink. A
113
+ `Sidebar` toolbar region (`fray-toolbarcontent`) now scrolls horizontally
114
+ (`overflow-x: auto`) when content sits below its floor, matching the existing
115
+ `fray-content` scroll contract — so a control in a resizable pane shrinks,
116
+ then scrolls, rather than being cut off.
117
+
118
+ - The dropdown trigger glyph now defaults to a universally supported Unicode
119
+ character (U+25BE) in `base.css` instead of `none`, so all themes render the
120
+ `::before` pseudo-element glyph without a per-theme override. The previous
121
+ Shiny-only value used U+23F7, which is absent from Helvetica and common
122
+ sans-serif fonts and did not display in Chrome.
123
+
124
+ ### Changed
125
+
126
+ - Documented that the document remains application policy: a viewport-sized
127
+ `FrayApp` claims `100vh`, so dedicated app documents must remove the
128
+ browser's default `body` margin to avoid document scrollbars. The guidance
129
+ now appears in the README's root-sizing section and in the application
130
+ composition guide's bounded-chain discussion.
131
+
132
+ - Panel content now emits a `fray-layout` host instead of `fray-content`.
133
+ SplitView panes are visible Layout components rather than non-visual region
134
+ markers; the previous `orientation`, `direction`, and parent-level pane-label
135
+ props remain migration aliases.
136
+
137
+ - `Panel`, `Sidebar`, `SplitView`, `Dialog`, and `OptionGroup` now accept their
138
+ secondary structural content through parent-specific region children rather
139
+ than `FrayChild`-valued `toolbar`, `primary`, `secondary`, `actions`, and
140
+ `headerEnd` props. The removed prop forms fail with migration guidance.
141
+
142
+ - Documented and enforced the theme contract as it actually works. Custom
143
+ properties remain the primary instrument and must be declared on `:root`
144
+ inside `@layer theme`, but a theme may also write ordinary CSS rules,
145
+ including component-host, trait, part, ARIA-state, and pseudo-element
146
+ selectors, when no variable expresses the intended difference. Such rules
147
+ must sit outside `@layer theme`, since component CSS is injected as an
148
+ unlayered `<style>` element prepended to `<head>` and would otherwise outrank
149
+ them. The previous documentation restricted every theme except Shiny to
150
+ variables only, which contradicted both the cascade design and the shipped
151
+ Shiny theme.
152
+
153
+ - Component chrome text is now consistently non-selectable. `user-select: none`
154
+ covers section `Header` titles, `OptionGroup`/`OptionsPanel` legends, native
155
+ `select` shells (`Dropdown`, `TimePicker`, `ThemePicker`, `ColorPicker`),
156
+ `Toolbar`, `Breadcrumb`, `NavigationBar`, `ProgressBar`, `InfoPanel`,
157
+ `DescriptionList`, `FilterPanel`, `Dialog` titles, the `DatePicker` trigger
158
+ and calendar popup, the `DateTimePicker` legend, and every Fray-rendered
159
+ `label` element. The `DatePicker` text input explicitly keeps
160
+ `user-select: text`. The generated `styles/structural.css` now also includes
161
+ `Breadcrumb`, `Header`, `InfoPanel`, `OptionGroup`, `OptionsPanel`,
162
+ `RadioGroup`, `DatePicker`, `DateTimePicker`, and `TimePicker`, which were
163
+ missing from the stylesheet manifest.
164
+
165
+ ## 1.3.1 - 2026-09-08
166
+
167
+ ### Fixed
168
+
169
+ - Removed the fixed height from checkable controls so their layout follows the
170
+ active line-height and supports wrapped label content.
171
+
172
+ - Published npm packages now include this changelog alongside their release
173
+ history.
174
+
175
+ ## 1.3.0 - 2026-09-08
176
+
177
+ ### Added
178
+
179
+ - Added independent `--navigation-bar-*` and `--navigation-link-*` theme
180
+ variables. Navigation now defaults to text-link presentation rather than
181
+ inheriting generic button chrome.
182
+ - Added `NavigationBar`, a labelled native navigation list over `RouteLink`
183
+ destinations, and `RouteOutlet`, an application-emitter-backed owner for
184
+ non-tab literal routes with nested scope propagation.
185
+ - Added the shared `ContentMountPolicy` type. Outlets support eager,
186
+ lazy-retained, and active-only branch lifetime and preselect a pending direct
187
+ route before mounting content.
188
+ - Added `TabPanel.mountPolicy` with eager, lazy-retained, and active-only
189
+ content lifecycles while preserving stable semantic tabpanel shells and the
190
+ current eager default. Routed panels preselect a matching pending literal
191
+ route before first content render, avoiding transient default-view mounts
192
+ during direct nested restoration.
193
+
194
+ ### Changed
195
+
196
+ - Shiny now presents `NavigationBar` as a light, text-link navigation strip
197
+ beneath application chrome instead of a dark action-bar surface.
198
+
199
+ ## 1.2.0 - 2026-09-08
200
+
201
+ ### Added
202
+
203
+ - Added `OptionGroup`, a labelled `fieldset`/`legend` shell with a `headerEnd` slot for controls that need a standardized semantic grouping.
204
+ - Added `OptionsPanel`, extending `GroupPanel` with a flex-column content area and a configurable group gap, designed to contain `OptionGroup` children. `OptionsPanel` now styles nested `fieldset`/`legend` elements with flex-column stretch layout, bordered legends, and neutral palette text color.
205
+ - Added `FrayHostElementTagNameMap` and `FrayElementTagNameMap` types to register
206
+ custom `fray-*` host elements as JSX intrinsic tags, enabling TSX-only
207
+ authoring without explicit `h()` calls.
208
+ - Added `FrayApp` and `mountFrayApp()`. `FrayApp` provides a fixed block-level
209
+ `fray-app` root, optional viewport-axis sizing, and a `main`/`none` landmark
210
+ policy; the mount helper collects and injects its dependency CSS before the
211
+ first commit.
212
+ - Adjusted font-styling in general to be more sensible
213
+ - Improved base css of CategoryHidepanel for more compact layout
214
+
215
+ ### Changed
216
+
217
+ - Refined `GroupPanel` layout from a rigid grid to a flexible row so the
218
+ vertical header and content adapt naturally to varying label lengths and
219
+ content sizes. The header chrome is now self-contained, removing the need
220
+ for per-heading-level style overrides.
221
+ - Tightened `OptionsPanel` and `OptionGroup` spacing for a more compact,
222
+ form-like appearance that better suits dense control panels. The content
223
+ area now stretches to fill available height, and fieldset legends sit
224
+ closer to their controls with reduced gaps and padding.
225
+ - Gave `CheckableControl` a fixed row height so checkboxes and radios align
226
+ consistently across different label and font configurations.
227
+ - Added a shared `border-radius` to the `.colored` trait so gradient
228
+ surfaces round consistently with other bordered elements.
229
+
230
+ ### Fixed
231
+
232
+ - `FrayApp` now applies the theme canvas, text color, font family, font size,
233
+ and line height even when embedded. Existing viewport root traits now apply
234
+ the published text color as well as typography.
235
+ - RadioGroup basic rendering adjusted
236
+
237
+ ## 1.1.1 - 2026-09-07
238
+
239
+ ### Changed
240
+
241
+ - Replaced legacy `h()`-first documentation with a comprehensive TSX-first
242
+ guide covering every public component, reactive template form, data-source
243
+ ownership rule, service/routing boundary, and styling contract.
244
+ - Restored the framework overview's design rationale for native browser
245
+ semantics, meaningful HTML/CSS separation, and the complementary intent
246
+ behind the Glue and Fray names.
247
+
248
+ ## 1.1.0 - 2026-09-07
249
+
250
+ ### Added
251
+
252
+ - Added `GroupPanel`, a labelled control-group surface with a bordered body
253
+ and a full-height vertical `Header` using the normal section-header chrome.
254
+
255
+ ### Changed
256
+
257
+ - Added a reusable `colored` presentation trait that paints explicit
258
+ `--c1`/`--c2`/`--c3` triplets as a gradient and lets Shiny add shared depth
259
+ through `--colored-shadow`. `TreeView` now accepts `itemLabelClassName` and
260
+ `itemLabelStyle` callbacks so applications can decorate the block label next
261
+ to an expander without painting the entire semantic tree row.
262
+ - Made `GroupPanel` headers narrower and corrected their box model, with a
263
+ small content gap, right inset, and a minimal inset between the vertical
264
+ header and the group border.
265
+ - Replaced Shiny's hard-coded blue section-header gradient stop with the
266
+ existing primary palette anchor and derived its translucent highlight stops
267
+ from the light palette endpoint.
268
+ - Reorganized the public Meridian style lab around a persistent Scope/View
269
+ navigation rail and flat sibling-island layouts for Portfolio, Register,
270
+ Change, and Analysis. Portfolio attention, Register criteria, and Analysis
271
+ visibility now derive independently from shared application scope while the
272
+ selected change remains durable across local filtering.
273
+
274
+ ### Fixed
275
+
276
+ - Application roots using either `fray-fill-horizontal` or
277
+ `fray-fill-vertical` now consume the published `--font-family`,
278
+ `--font-size`, and `--line-height` tokens, preventing inherited controls and
279
+ native content from falling back to the browser's serif defaults.
280
+
281
+ ## 1.0.0 - 2026-09-06
282
+
283
+ ### Added
284
+
285
+ - Independent `fray-fill-horizontal` and `fray-fill-vertical` application-root
286
+ modifiers with axis-specific sizing/overflow behavior and a white
287
+ `--application-background` canvas. Applications combine both modifiers for
288
+ fullscreen behavior; runtime mounting itself remains sizing-neutral.
289
+ - An explicit common `island` component modifier and catalogued
290
+ `--island-*` surface variables, allowing themes to elevate only deliberate
291
+ application surfaces instead of inferring boundaries from component nesting.
292
+ - `data-fray` renderer ownership markers on every Fray-created element, fixed
293
+ one-hyphen `fray-<stem>` component hosts, a variable-only base stylesheet,
294
+ and the `setFrayAppearance()`/`getFrayAppearance()` document appearance API.
295
+ - Base-to-derived component CSS collection, including dependencies declared at
296
+ every class level, for meaningful component styling inheritance.
297
+ - Explicit component-specific `live()` prop allowlists, enforced consistently
298
+ by typed JSX/`h()` authoring and the runtime renderer.
299
+ - `Label` component with a live `text` prop for accessible form field labeling.
300
+ - `Header` component with a native `h1`–`h6` level and source-owned Section
301
+ Header treatment.
302
+
303
+ ### Changed
304
+
305
+ - Regenerated structural CSS to match the fixed component host names.
306
+ - Palette ramps can independently mix their primary, secondary, or neutral
307
+ light and dark sides toward palette-selected hue endpoints.
308
+ - Normal applications register their root component and inject only reachable
309
+ component CSS. Base owns semantic defaults and palette derivation; named
310
+ colors and themes are independent variable-only files with no base import.
311
+ - The public style lab has returned to a native zero-component baseline for
312
+ strict component-at-a-time CSS review.
313
+ - Interactive controls now expose consistent live availability and validation
314
+ contracts: `Textbox`/`Dropdown` accept live disabled, required, and error
315
+ state; checkboxes, radio controls, and toggles accept live disabled, required,
316
+ and error state; standalone radios also accept live checked state.
317
+ - `RadioGroup.options` remains an ordinary array supplied through explicit owner
318
+ renders, and raw `valueEmitter` behavior is unchanged.
319
+ - Enabled strict TypeScript compiler checking.
320
+ - Restarted the public component treatments for Button, the Checkbox family,
321
+ DescriptionList/DescriptionItem, Dialog, Dropdown, FilterPanel, Header,
322
+ ListView, Panel, Placeholder, ProgressBar, RadioGroup/RadioButton, Sidebar,
323
+ SplitView, the DataTable/TableHeader family, TabLine/TabPanel, Textbox,
324
+ Toggle, and Toolbar around fixed light-DOM parts, native/ARIA state
325
+ selectors, and reachable component-local CSS. ProgressBar preserves native
326
+ progress semantics while presenting its label through the legacy-compatible
327
+ clipped completed surface.
328
+ - Rebuilt the public style lab as the reactive Meridian Change Office workflow
329
+ so approved component CSS is exercised through application-owned scope,
330
+ filtering, selection, routing, and retained-screen state.
331
+ - Restarted TreeView around a native tree list, fixed expander/label parts,
332
+ semantic selection and expansion selectors, and declarative TreeItem updates;
333
+ the style lab now uses that hierarchy alongside live theme and colour pickers.
334
+
335
+ ### Removed
336
+
337
+ - Configurable Fray component host prefixes and overrides, plus the obsolete
338
+ top-level `themes/light.css` and `themes/dark.css` compatibility bundles.
339
+ - The named `baseStyles` recipe registry and its public types; shared component
340
+ CSS now follows meaningful class inheritance.
341
+
342
+ ### Fixed
343
+
344
+ - Island sizing reacts to the application root's opted-in viewport axes with
345
+ corresponding bounds and overflow, and component ancestry rejects islands
346
+ nested within other islands.
347
+ - Toggle and TabLine native buttons now honor configured UI text scaling;
348
+ Toggle's default selected surface also preserves AA text contrast, and the
349
+ Sidebar browser contract follows its fixed light-DOM content part.
350
+ - `SplitView` panes are keyboard-focusable so their owned overflow remains
351
+ operable without a pointing device.
352
+ - `Panel` now composes `Header`, uses trait classes for content orientation, and
353
+ owns only its surface, content layout, and live disabled presentation.
354
+ - `Sidebar` now has a fixed `fray-sidebar` CSS host while retaining its native
355
+ complementary `aside` region.
356
+ - `SplitView` now uses class-owned direction and pane hooks, a simple two-pane
357
+ flex layout, and its existing native/ARIA pane semantics.
358
+ - FilterPanel retains its component-relative Bank2 anchor without a deferred
359
+ viewport offset that caused the panel to flicker out of view.
360
+ - Multi-state Checkbox variants synchronize the native checked property after
361
+ every semantic transition.
362
+
363
+ ## 0.7.0 - 2026-09-04
364
+
365
+ ### Added
366
+
367
+ - Contextually discovered hierarchical browser routing with immutable literal
368
+ and dynamic route descriptors, ordered cancellable resolvers, canonical
369
+ fallback, and structured transition/issue state.
370
+ - History/path, hash, and memory navigation adapters plus native `RouteLink`,
371
+ `RouteValue`, `RouteQuery`, and route-aware `TabPanel` integration.
372
+
373
+ ### Changed
374
+
375
+ - `FrayRuntime` can carry a caller-owned router, and routed component children
376
+ inherit their mounted route lineage without changing Glue or unrouted
377
+ component behavior.
378
+
379
+ ## 0.6.0 - 2026-09-04
380
+
381
+ ### Added
382
+
383
+ - Prefix-free public theme traits for complete and split custom-component
384
+ treatments, including data-component and colored visualization surfaces.
385
+ - Primary, secondary, and neutral 50–950 palette ramps with documented
386
+ light/default/dark aliases and contrast endpoints.
387
+
388
+ ### Changed
389
+
390
+ - Themes now target native elements, traits, and native/ARIA state inside
391
+ `@scope`; component and part diagnostics are no longer presentation hooks.
392
+ - Color files expose palette language only. Themes map that palette to button,
393
+ input, panel, status, selection, and visualization roles.
394
+ - Theme/color root attributes and public custom properties are prefix-free;
395
+ see the semantic-markup and theming migration guidance.
396
+
397
+ ## 0.5.0 - 2026-09-03
398
+
399
+ ### Changed
400
+
401
+ - Two-state checkboxes with custom semantic values expose the second value as
402
+ the checked state, so native checkbox interactions remain correct for
403
+ bindings such as `visible`/`hidden`.
404
+
405
+ ## 0.4.0 - 2026-09-03
406
+
407
+ ### Added
408
+
409
+ - Typed service keys, immutable providers, lazy application scopes, and
410
+ declared class-component service access through `FrayRuntime`.
411
+
412
+ ### Changed
413
+
414
+ - Application services are registered at the composition root and inherited by
415
+ nested class components without service prop-drilling.
416
+
417
+ ## 0.3.0 - 2026-09-03
418
+
419
+ ### Added
420
+
421
+ - Stable list, tree, table, dialog, filter, selection, and placeholder exports.
422
+ - Versioned semantic filter-state composition and persistence helpers.
423
+ - Read-only keyed tree-node projections and immutable writable-root updates.
424
+ - Explicit local, caller-query, handler, and REST table data-source adapters.
425
+
426
+ ### Changed
427
+
428
+ - `FilterMode` values are `neutral`, `prefer`, `require`, and `deny`.
429
+ - Generic filter dimensions reject denied matches, require every required value,
430
+ accept any preferred value when preferences are active, and ignore neutral
431
+ values.
432
+ - Single-select lists and tables use item-or-null emitters; array emitters
433
+ require explicit multi-selection.
434
+ - `DataTable` uses one of `data`, `dataSource`, or `rest` instead of legacy
435
+ query/REST props.
436
+
437
+ ## 0.2.0 - 2026-09-03
438
+
439
+ ### Added
440
+
441
+ - Generated theme-neutral structural CSS, replaceable treatment bundles, color
442
+ palettes, and theme/color picker components.
443
+
444
+ ### Changed
445
+
446
+ - Components consume semantic styling variables rather than embedded theme
447
+ colors, and published package checks validate CSS subpaths.
448
+ - Fray's Glue peer range follows the compatible Glue `0.2.x` line.
449
+
450
+ ## 0.1.0-alpha.1 - 2026-09-02
451
+
452
+ ### Added
453
+
454
+ - Initial public packaging with strict TypeScript declarations, ESM JSX
455
+ runtimes, accessible controls, supported themes, and initial data APIs.
456
+
457
+ ### Changed
458
+
459
+ - Glue is Fray's external peer dependency.
package/LICENSE ADDED
@@ -0,0 +1,55 @@
1
+ Apache License
2
+
3
+ Version 2.0, January 2004
4
+
5
+ http://www.apache.org/licenses/
6
+
7
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
8
+
9
+ 1. Definitions.
10
+
11
+ "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
12
+
13
+ "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
16
+
17
+ "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
18
+
19
+ "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
20
+
21
+ "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
22
+
23
+ "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
24
+
25
+ "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
26
+
27
+ "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
28
+
29
+ "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
30
+
31
+ 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
32
+
33
+ 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
34
+
35
+ 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
36
+
37
+ You must give any other recipients of the Work or Derivative Works a copy of this License; and
38
+
39
+ You must cause any modified files to carry prominent notices stating that You changed the files; and
40
+
41
+ You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
42
+
43
+ If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
44
+
45
+ 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
46
+
47
+ 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
48
+
49
+ 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
50
+
51
+ 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
52
+
53
+ 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
54
+
55
+ END OF TERMS AND CONDITIONS
package/NOTICE ADDED
@@ -0,0 +1,2 @@
1
+ Capillary UI
2
+ Copyright 2026 Sylwell Software