@revolist/ui 4.0.5-rc → 4.0.5

package/MIGRATION.md

@@ -0,0 +1,36 @@
+# Current UI APIs
+
+This change removes compatibility-only component names, CSS hooks and forwarding modules. Native mounting APIs (`createPreactElement`, `mountColorPicker`, native controls and dialogs) and React, Vue, Angular and Svelte adapters remain supported.
+
+## Component names
+
+Use the current names from the matching framework entry:
+
+| Removed name     | Current name           |
+| ---------------- | ---------------------- |
+| `Icon`           | `SvgIcon`              |
+| `RemovableChip`  | `FilterChip`           |
+| `Slider`         | `SingleValueSlider`    |
+| `RangeSlider`    | `PreactRangeSlider`    |
+| `ResourcePicker` | `SharedResourcePicker` |
+| `FeedbackPanel`  | `StatusFeedbackPanel`  |
+
+The same names apply to the Angular/Svelte `UiComponent` component selector. Local import aliases are ordinary language aliases and remain available, for example `import { SingleValueSlider as Slider } from '@revolist/ui/react'`.
+
+Import `Legend` from `@revolist/ui/legend` or the framework entry, rather than `@revolist/ui/filter-controls`. Use `ControlTooltip` instead of the unused `TooltipSurface` export. Render `DialogActionFooter` or `ActionFooterView` directly instead of calling the removed `renderDialogActionFooter(h, props)` signature.
+
+## Styling
+
+`TimeGrid` and `BrushRange` no longer accept `legacyClassPrefix`. Use `rv-time-grid__*` and `brush-range__*` respectively. Slider endpoints use the shared `fromSlider` and `toSlider` classes. Product-owned filter headers, summaries and action controls retain their product-owned names.
+
+Checkbox customization uses `--rv-ui-checkbox-bg`, `--rv-ui-checkbox-border`, `--rv-ui-checkbox-checked`, `--rv-ui-checkbox-check` and `--rv-ui-checkbox-focus`; RowSelect/ColumnDialog variable aliases are removed.
+
+The active rating and pagination style rules are now in `styles/rating.css` and `styles/pagination.css`, and remain included by the main stylesheet. Primitive `$legacy-*` Sass aliases are removed; internal styles use the existing palette lookup API. The unused scalar-slider fill element is removed; its current range input owns the fill.
+
+## Date/time labels
+
+A time picker uses `text.chooseTime`, falling back to its default time label. It no longer borrows `text.chooseDate`. Date pickers continue to use `text.chooseDate`.
+
+## Source ownership
+
+Forwarding-only `.ts` modules have been replaced by their owning TSX implementations at the canonical module paths. Public package entry names stay unchanged. The native mounting bridge remains the shared owner of element-returning adapters.

package/OWNERSHIP.md

@@ -1,43 +1,43 @@
 # Shared UI ownership
 
 `@revolist/ui` is the implementation owner for reusable product controls. Pro's
-existing exports and leaf modules are compatibility adapters. Product code owns
+canonical exports and leaf modules contain the current implementations. Product code owns
 values, validation, commands, persistence and domain layout.
 
 AI prompt, suggestions, applied-request trail, action status, result and assistant compositions live in
-`src/ai/`; `src/ai/_style.scss` owns their token-based presentation. Pro's AI
+`package/ai/`; `package/ai/_style.scss` owns their token-based presentation. Pro's AI
 adapter owns interpretation, field policy, view commands, query execution and
 view snapshots. Framework adapters and native mounting reuse the same TSX.
 
-| Component family | Implementation owner under `src/` | Style owner under `src/` |
-| --- | --- | --- |
-| Native button, input, select, textarea, summary | `control-presentation.view.tsx`; Preact `native-control.tsx` | `styles/_primitives.scss`, `styles/_control.scss`, `_form.scss` |
-| Button variants, icon button, toggle, group | `controls.tsx`, `buttons/` | `styles/_primitives.scss` |
-| Icon | `icons/icon.tsx` | `styles/_primitives.scss` |
-| Checkbox | `checkbox/index.ts` | `checkbox/checkbox.scss` |
-| Switch | `switch/index.tsx` | `styles/_primitives.scss` |
-| Radio group | `controls.tsx` | `_form.scss`, `styles/_compositions.scss` |
-| Choice chips, segmented control, tabs | `choice-chips/`, `segmented-switch/`; semantic exports in `controls.tsx` | `styles/_primitives.scss` |
-| Search | `search-input/native.view.tsx`; Preact `search-input/index.tsx` | `styles/_primitives.scss` |
-| Number/date/time inputs, stepper | `controls.tsx`; grid scalar/counter adapters in `native-controls.view.tsx` | `_form.scss`, `styles/_editor-counter.scss` |
-| Listbox, panes, split layout | `editor-layout/index.tsx`; neutral aliases in `controls.tsx` | `editor-layout/style.scss` |
-| Form field, hint, error, section, disclosure | `form-controls/`, `controls.tsx` | `_form.scss`, `styles/_compositions.scss` |
-| Chips | `form-controls/presentation.tsx` | `styles/_primitives.scss` |
-| Scalar/range sliders | `filter/filters/slider/`, `native-controls.view.tsx` | `filter/filters/slider/_slider.scss`, `styles/_editor-slider.scss` |
-| Calendar and date pickers | `calendar/`, `pickers.tsx` | `calendar/_calendar.scss`, `styles/_compositions.scss` |
-| Dropdown, combobox, multi-select | `dropdown/`; compositions in `pickers.tsx` | `dropdown/editor-dropdown.style.scss`, `styles/_compositions.scss` |
-| Color palette/picker | `color-palette/` | `color-palette/*.scss` |
-| Resource picker, avatar | `resource-picker/`, `avatar/` | `resource-picker/resource-picker.scss`, `avatar/avatar.style.scss` |
-| Dialog, popover, tooltip, menu, resize | `surfaces.view.tsx`, `dialog/`, `core/`; Preact compositions in `controls.tsx` and `pickers.tsx` | `_dialog.scss`, `styles/_primitives.scss`, `styles/_compositions.scss` |
-| Toolbar, panel, empty state, alerts | `controls.tsx` | `styles/_compositions.scss` |
-| Status feedback and badges | `status-feedback/`, `controls.tsx` | `status-feedback/status-feedback.scss`, `styles/_primitives.scss` |
-| Loading | `native-controls.view.tsx`, `controls.tsx` | `styles/_loading.scss`, `styles/_compositions.scss` |
-| Pagination, progress, rating | `pagination.ts`, `progress/`, `native-controls.view.tsx`, `controls.tsx` | `progress/_bar.scss`, `progress/_circular.scss`, `styles/legacy-rating.css`, `styles/legacy-pagination.css`, `styles/_compositions.scss` |
-| BarChart, LineChart, AreaChart; distribution adapter and brush range | `distribution-chart/bar-chart.tsx`, `line-chart.tsx`, `area-chart.tsx`; shared `chart-frame.tsx` and `geometry.ts`; `brush-range/` | `distribution-chart/_distribution-chart.scss`, `brush-range/_brush-range.scss` |
-| Option rows, legend, inline fields | `filter-controls.tsx` | `styles/_filter-controls.scss` |
-| Weekly time grid and keyboard/paint gesture lifecycle | `time-grid.tsx` | `styles/_time-grid.scss` |
-| Highlighted text input and scroll synchronization | `filter-controls.tsx` | `styles/_filter-controls.scss` |
-| Theme tokens | `styles/_theme.scss` | `styles/_tokens.scss` installs light/dark scopes |
+| Component family                                                     | Implementation owner under `package/`                                                                                                  | Style owner under `package/`                                                                                                   |
+| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| Native button, input, select, textarea, summary                      | `control-presentation.tsx`; Preact `native-control.tsx`                                                                            | `styles/_primitives.scss`, `styles/_control.scss`, `_form.scss`                                                            |
+| Button variants, icon button, toggle, group                          | `controls.tsx`, `buttons/`                                                                                                         | `styles/_primitives.scss`                                                                                                  |
+| Icon                                                                 | `icons/icon.tsx`                                                                                                                   | `styles/_primitives.scss`                                                                                                  |
+| Checkbox                                                             | `checkbox/index.ts`                                                                                                                | `checkbox/checkbox.scss`                                                                                                   |
+| Switch                                                               | `switch/index.tsx`                                                                                                                 | `styles/_primitives.scss`                                                                                                  |
+| Radio group                                                          | `controls.tsx`                                                                                                                     | `_form.scss`, `styles/_compositions.scss`                                                                                  |
+| Choice chips, segmented control, tabs                                | `choice-chips/`, `segmented-switch/`; semantic exports in `controls.tsx`                                                           | `styles/_primitives.scss`                                                                                                  |
+| Search                                                               | `search-input/native.tsx`; Preact `search-input/index.tsx`                                                                         | `styles/_primitives.scss`                                                                                                  |
+| Number/date/time inputs, stepper                                     | `controls.tsx`; grid scalar/counter adapters in `native-controls.tsx`                                                              | `_form.scss`, `styles/_editor-counter.scss`                                                                                |
+| Listbox, panes, split layout                                         | `editor-layout/index.tsx`; neutral aliases in `controls.tsx`                                                                       | `editor-layout/style.scss`                                                                                                 |
+| Form field, hint, error, section, disclosure                         | `form-controls/`, `controls.tsx`                                                                                                   | `_form.scss`, `styles/_compositions.scss`                                                                                  |
+| Chips                                                                | `form-controls/presentation.tsx`                                                                                                   | `styles/_primitives.scss`                                                                                                  |
+| Scalar/range sliders                                                 | `filter/filters/slider/`, `native-controls.tsx`                                                                                    | `filter/filters/slider/_slider.scss`, `styles/_editor-slider.scss`                                                         |
+| Calendar and date pickers                                            | `calendar/`, `pickers.tsx`                                                                                                         | `calendar/_calendar.scss`, `styles/_compositions.scss`                                                                     |
+| Dropdown, combobox, multi-select                                     | `dropdown/`; compositions in `pickers.tsx`                                                                                         | `dropdown/editor-dropdown.style.scss`, `styles/_compositions.scss`                                                         |
+| Color palette/picker                                                 | `color-palette/`                                                                                                                   | `color-palette/*.scss`                                                                                                     |
+| Resource picker, avatar                                              | `resource-picker/`, `avatar/`                                                                                                      | `resource-picker/resource-picker.scss`, `avatar/avatar.style.scss`                                                         |
+| Dialog, popover, tooltip, menu, resize                               | `surfaces.tsx`, `dialog/`, `core/`; Preact compositions in `controls.tsx` and `pickers.tsx`                                        | `_dialog.scss`, `styles/_primitives.scss`, `styles/_compositions.scss`                                                     |
+| Toolbar, panel, empty state, alerts                                  | `controls.tsx`                                                                                                                     | `styles/_compositions.scss`                                                                                                |
+| Status feedback and badges                                           | `status-feedback/`, `controls.tsx`                                                                                                 | `status-feedback/status-feedback.scss`, `styles/_primitives.scss`                                                          |
+| Loading                                                              | `native-controls.tsx`, `controls.tsx`                                                                                              | `styles/_loading.scss`, `styles/_compositions.scss`                                                                        |
+| Pagination, progress, rating                                         | `pagination.ts`, `progress/`, `native-controls.tsx`, `controls.tsx`                                                                | `progress/_bar.scss`, `progress/_circular.scss`, `styles/rating.css`, `styles/pagination.css`, `styles/_compositions.scss` |
+| BarChart, LineChart, AreaChart; distribution adapter and brush range | `distribution-chart/bar-chart.tsx`, `line-chart.tsx`, `area-chart.tsx`; shared `chart-frame.tsx` and `geometry.ts`; `brush-range/` | `distribution-chart/_distribution-chart.scss`, `brush-range/_brush-range.scss`                                             |
+| Option rows, legend, inline fields                                   | `filter-controls.tsx`                                                                                                              | `styles/_filter-controls.scss`                                                                                             |
+| Weekly time grid and keyboard/paint gesture lifecycle                | `time-grid.tsx`                                                                                                                    | `styles/_time-grid.scss`                                                                                                   |
+| Highlighted text input and scroll synchronization                    | `filter-controls.tsx`                                                                                                              | `styles/_filter-controls.scss`                                                                                             |
+| Theme tokens                                                         | `styles/_theme.scss`                                                                                                               | `styles/_tokens.scss` installs light/dark scopes                                                                           |
 
 ## Renderer and stylesheet contracts
 
@@ -63,7 +63,7 @@ menus keep domain policy and data operations in their product. Large title
 fields and toolbar layouts remain product compositions using shared primitives.
 Grid cells, timeline event/task hit targets, dependency handles, card drag
 surfaces, grid expansion and virtualization keep their product geometry.
-`src/ownership.test.ts` records the explicit scene exceptions and rejects new
+`package/ownership.test.ts` records the explicit scene exceptions and rejects new
 local primitive JSX/factories elsewhere. UI's native dependency boundary and
 Charts' rendering boundary have separate assertions.
 
@@ -72,7 +72,7 @@ integration tests. Canonical suite selection is documented in `TESTING.md`.
 
 History and export commands use UI's `SvgButton` (or `IconButton` convenience composition) for SVG, count badge and pointer/keyboard tooltip presentation. Element-returning adapters use `decorateIconAction`; Charts renders controls through Preact. Products supply localized labels, permissions, actions and history counts. `ToolbarGroup` groups commands with spacing; `ButtonGroup` remains the bordered choice composition. Both danger button variants use the same red outline presentation.
 
-Structured filter adapters retain aggregation, matching, amount/date validation, timezone policy, preset meaning and commit transactions. UI receives explicit data and formatted labels. Expression parsing, syntax tokens, diagnostics and debounce remain in Pro; UI owns the highlighted input's geometry and scroll synchronization. TimeGrid owns keyboard focus and paint gesture cleanup; Pro expands visual buckets into selected hourly filter values. Legacy filter CSS classes remain adapter hooks, with theme aliases at the Pro boundary.
+Structured filter adapters retain aggregation, matching, amount/date validation, timezone policy, preset meaning and commit transactions. UI receives explicit data and formatted labels. Expression parsing, syntax tokens, diagnostics and debounce remain in Pro; UI owns the highlighted input's geometry and scroll synchronization. TimeGrid owns keyboard focus and paint gesture cleanup; Pro expands visual buckets into selected hourly filter values. Filter consumers use the canonical TimeGrid and BrushRange classes and semantic UI tokens.
 
 ## Grid-backed filter compositions stay in Pro
 
@@ -92,7 +92,7 @@ BarChart and LineChart are independent compact visual components, exported throu
 
 ### Field configurators
 
-`src/field-configurator.tsx` owns field libraries, headings, lists, drag-ready rows, neutral items and icon/caption slots. `src/styles/_field-configurator.scss` owns presentation and UI-token fallbacks. Pivot configurator exports remain aliases; its SCSS mixin delegates to UI. Query rules, native policy inspection, field metadata icons, tooltips and grid drag/drop stay in Pivot. The gallery demonstrates these primitives independently.
+`package/field-configurator.tsx` owns field libraries, headings, lists, drag-ready rows, neutral items and icon/caption slots. `package/styles/_field-configurator.scss` owns presentation and UI-token fallbacks. Pivot configurator exports remain aliases; its SCSS mixin delegates to UI. Query rules, native policy inspection, field metadata icons, tooltips and grid drag/drop stay in Pivot. The gallery demonstrates these primitives independently.
 
 Pivot configuration and chart query searchable fields both use `PivotDimensionsGrid` and Pro `TreeDataPlugin` in Pivot. The UI field library is a neutral disclosure/list shell, never a substitute for these grid-backed browsers.
 
@@ -108,7 +108,7 @@ Link-style action buttons use `Button variant="link"` or `SvgButton variant="lin
 
 ## Interactive timeline track
 
-`src/timeline-track/` owns controlled bar rendering, selection, pointer capture/movement/resizing, keyboard edits, numeric geometry helpers and track styles. Pro's Timeline editor adapter retains draft validation, localization and commits; its existing model helper exports forward to the shared model. The read-only cell timeline renderer remains in `cell-visuals/timeline.ts`.
+`package/timeline-track/` owns controlled bar rendering, selection, pointer capture/movement/resizing, keyboard edits, numeric geometry helpers and track styles. Pro's Timeline editor adapter retains draft validation, localization and commits; its existing model helper exports forward to the shared model. The read-only cell timeline renderer remains in `cell-visuals/timeline.ts`.
 
 ## Editable dialog composition
 
@@ -120,4 +120,4 @@ Link-style action buttons use `Button variant="link"` or `SvgButton variant="lin
 
 ## Preact element construction
 
-All shared UI markup is Preact TSX. Element-returning compatibility APIs mount the same TSX through `preact-mount.ts`; they do not build parallel DOM trees. Lifecycle controllers may attach, position, focus and dispose rendered roots. Grid/Stencil VNode adapters retain the Core rendering contract. Charts controls use Preact through the same mount boundary; chart scene/export geometry remains scene-owned.
+All shared UI markup is Preact TSX. Element-returning native APIs mount the same TSX through `preact-mount.ts`; they do not build parallel DOM trees. Lifecycle controllers may attach, position, focus and dispose rendered roots. Grid/Stencil VNode adapters retain the Core rendering contract. Charts controls use Preact through the same mount boundary; chart scene/export geometry remains scene-owned.