@rcarls/rc-select 0.0.0-next-20260921045401

package/CHANGELOG.md

@@ -0,0 +1,184 @@
+# @rcarls/rc-select
+
+## 0.0.0-next-20260921045401
+
+### Minor Changes
+
+- 079e025: Standardize component styling contracts for the breaking 0.7 release.
+
+  BREAKING CHANGE: Rename the Markdown editor's `--rme-*` properties to
+  `--rc-markdown-editor-*`, `--rc-app-bar-background` to `--rc-app-bar-bg`,
+  `--rc-textarea-radius` to `--rc-textarea-border-radius`, the transfer-list
+  `--rc-transfer-list-panel-*` properties to `--rc-transfer-list-listbox-*`,
+  `--rc-chip-group-webkit-scrollbar-display` to
+  `--rc-chip-group-scrollbar-display`, and `--rc-text` to `--rc-field-text`.
+  Compatibility aliases are intentionally not provided.
+
+  BREAKING CHANGE: Replace `--rc-select-chip-padding-inline` and
+  `--rc-combobox-chip-padding-inline` with explicit `*-padding-inline-start` and
+  `*-padding-inline-end` tokens. Generated removable chips now reserve the full
+  remove target and its edge offset, so their indicator cannot overlap label text.
+
+  Add canonical app-bar elevation, transfer-list listbox radius, and textarea
+  line-action tokens. Add logical `rc-chip` inline-padding properties so themes
+  can implement Material's icon-aware spacing without overriding authored child
+  styles. Make `rc-field` consume the shared semantic token layer,
+  and place the `rc-chip` and `rc-search-bar` light-DOM structural styles in the
+  `rc-base` cascade layer so normal consumer rules override them.
+
+  Prevent decorative, `aria-hidden` trailing list content from intercepting a
+  whole-row action target, and keep segmented-list item geometry from leaking
+  into nested standard lists.
+
+  Remove unused Material navigation-rail toggle tokens and obsolete list-item
+  theme tokens. Register the segmented-button private theme seam and enforce
+  token ownership, documentation, removed-name, selector-budget, and cascade
+  layer contracts through the component architecture audit.
+
+- 4341311: Add reusable fullscreen dialogs and declarative dialog popup mode to `rc-select` and
+  `rc-combobox`. Dialog selection and creation are staged until Done, while close and Escape
+  discard the draft. Fullscreen surfaces follow the visual viewport under browser zoom and
+  software keyboards, and anchored popups now clamp to the visual viewport.
+- 94dc987: `rc-menu-button`'s, `rc-select`'s, and `rc-combobox`'s popup/listbox now fade
+  in and out through CSS alone, using `@starting-style` and a discrete
+  `display`/`overlay` transition, driven by new `--rc-menu-button-popup-duration`,
+  `--rc-select-listbox-duration`, and `--rc-combobox-listbox-duration`
+  properties. `showPopover()`/`hidePopover()` (via `openPopup()`/`closePopup()`)
+  stay synchronous, and nothing waits on the transition finishing.
+
+  These animate opacity only, not a scale or slide transform: all three
+  position their popup with the shared `AnchorController`, which applies its
+  own viewport-clamping `translate` and reads `getBoundingClientRect()` to
+  compute the next correction. A second, CSS-driven transform on the same
+  element and property would fight that positioning math on every open, not
+  only during an edge case.
+
+  `rc-fab-menu` already had a scale-based entrance for its popup (verified safe
+  here: unlike the general `AnchorController` case, this popup isn't
+  collision-clamped), but no exit animation at all and no directional easing.
+  Both are added: the popup now fades and scales back out on close, and enter
+  uses a decelerating curve while exit uses an accelerating one.
+
+- 8a30e96: Support acting as an `rc-field` control provider: `focus()`/`blur()` forward to the shadow-DOM
+  trigger, a real user-driven selection now dispatches native `input` and `change` on the slotted
+  `<select>` (a programmatic `value`/`defaultValue` write does not, matching `rc-textarea`'s
+  controlled-value contract), and a new `required` property mirrors the slotted select's own
+  `required` onto `aria-required` on the trigger.
+
+### Patch Changes
+
+- Updated dependencies [50d5610]
+- Updated dependencies [079e025]
+- Updated dependencies [4341311]
+- Updated dependencies [2c7c80a]
+- Updated dependencies [57338f5]
+  - @rcarls/rc-common@0.0.0-next-20260921045401
+  - @rcarls/rc-chip-group@0.0.0-next-20260921045401
+  - @rcarls/rc-dialog@0.0.0-next-20260921045401
+  - @rcarls/rc-listbox@0.0.0-next-20260921045401
+
+## 0.6.0
+
+### Minor Changes
+
+- ffcbf11: Add adaptive chip-group layouts, native-backed filter chips, and shared
+  input-chip rendering. Native-backed chips preserve controlled host state,
+  follow form resets when uncontrolled, and accept native link actions. Groups
+  restore author-owned chip variants when coordination ends. Keep search input
+  chrome inside the search surface and align contextual icon sizes with Material 3.
+
+### Patch Changes
+
+- Updated dependencies [ffcbf11]
+- Updated dependencies [6683eb9]
+- Updated dependencies [ee7ba6c]
+- Updated dependencies [30eb232]
+  - @rcarls/rc-chip-group@0.6.0
+  - @rcarls/rc-common@0.6.0
+  - @rcarls/rc-listbox@0.6.0
+
+## 0.5.0
+
+### Patch Changes
+
+- Updated dependencies [4ae2ef0]
+- Updated dependencies [689340c]
+  - @rcarls/rc-common@0.5.0
+  - @rcarls/rc-listbox@0.5.0
+
+## 0.4.2
+
+### Patch Changes
+
+- @rcarls/rc-common@0.4.2
+- @rcarls/rc-listbox@0.4.2
+
+## 0.4.1
+
+### Patch Changes
+
+- @rcarls/rc-common@0.4.1
+- @rcarls/rc-listbox@0.4.1
+
+## 0.4.0
+
+### Patch Changes
+
+- 9c3bc6f: Document the `listbox` CSS part, the `open`/`multiple`/`disabled`/`placeholder`/`display`
+  attributes, and the `--rc-select-chip-gap`, `--rc-select-chip-border`,
+  `--rc-select-listbox-border`, and `--rc-select-shadow` custom properties in the generated API
+  reference.
+- Updated dependencies [e57277f]
+- Updated dependencies [8944083]
+- Updated dependencies [ccca8e2]
+- Updated dependencies [037b1b3]
+  - @rcarls/rc-common@0.4.0
+  - @rcarls/rc-listbox@0.4.0
+
+## 0.3.2
+
+### Patch Changes
+
+- 88b4086: Fix Firefox for Android bug: `<label>`-wrapped multiple selects [Bugzilla 1475723](https://bugzilla.mozilla.org/show_bug.cgi?id=1475723)
+- Updated dependencies [88b4086]
+  - @rcarls/rc-common@0.3.2
+  - @rcarls/rc-listbox@0.3.2
+
+## 0.3.1
+
+### Patch Changes
+
+- @rcarls/rc-common@0.3.1
+- @rcarls/rc-listbox@0.3.1
+
+## 0.3.0
+
+### Added
+
+- Add typed listbox action option support through the embedded listbox.
+
+### Changed
+
+- Change the required native `<select>` child to the default slot.
+- Normalize embedded listbox option styling around `--rc-listbox-*` custom properties.
+- Update package metadata, README intro, and docs links.
+
+### Migration
+
+- Remove `slot="select"` from the native `<select>` child.
+
+```diff
+- <rc-select><select slot="select" name="status">...</select></rc-select>
++ <rc-select><select name="status">...</select></rc-select>
+```
+
+### Dependencies
+
+- Sync internal dependencies to 0.3.0.
+
+## 0.2.0
+
+### Patch Changes
+
+- @rcarls/rc-common@0.2.0
+- @rcarls/rc-listbox@0.2.0

package/README.md

@@ -0,0 +1,93 @@
+# `@rcarls/rc-select`
+
+Select-only combobox backed by a native `<select>`, following the [WAI-ARIA Combobox pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/).
+
+Docs: [https://richardcarls.github.io/rc-webcomponents/components/rc-select](https://richardcarls.github.io/rc-webcomponents/components/rc-select).
+
+## Installation
+
+PowerShell:
+
+```powershell
+yarn.cmd add @rcarls/rc-select
+```
+
+Bash/zsh:
+
+```bash
+yarn add @rcarls/rc-select
+```
+
+## Import
+
+```ts
+import '@rcarls/rc-select/define';
+```
+
+## Basic Usage
+
+```html
+<label>
+  Fruit
+  <rc-select placeholder="Choose fruit">
+    <select name="fruit">
+      <option value="">Choose fruit</option>
+      <option value="apple">Apple</option>
+      <option value="banana">Banana</option>
+      <option value="cherry" disabled>Cherry</option>
+    </select>
+  </rc-select>
+</label>
+```
+
+## Dialog popup
+
+Set `popup-mode="dialog"` when an anchored listbox would leave too little usable viewport. The
+component manages a fullscreen native dialog with a leading close action, title, current chips,
+option list, and trailing Done action.
+
+Dialog selection is transactional: option and chip changes are staged until Done is activated.
+Done updates the native `<select>` and fires one `rc-select-change`; the leading close action,
+Escape, and imperative close discard the staged changes.
+
+```html
+<rc-select popup-mode="dialog" placeholder="Choose categories" multiple>
+  <select name="categories" multiple>
+    <option value="quick">Quick meal</option>
+    <option value="vegetarian">Vegetarian</option>
+  </select>
+</rc-select>
+```
+
+## API
+
+| Property / method          | Type                             | Description                                               |
+| -------------------------- | -------------------------------- | --------------------------------------------------------- |
+| `open`                     | `boolean`                        | Current popup state.                                      |
+| `multiple`                 | `boolean`                        | Mirrors the slotted `<select multiple>` state.            |
+| `disabled`                 | `boolean`                        | Mirrors the slotted `<select disabled>` state.            |
+| `placeholder`              | `string`                         | Text shown when no value is selected.                     |
+| `display`                  | `'auto' \| 'chips' \| 'compact'` | Controls multi-select display.                            |
+| `popupMode`                | `'popover' \| 'dialog'`          | Chooses anchored or transactional dialog presentation.    |
+| `dialogConfirmLabel`       | `string`                         | Dialog commit action label. Defaults to `Done`.           |
+| `dialogCancelLabel`        | `string`                         | Accessible label for the leading close action.            |
+| `dialogCancelButton`       | `'visible' \| 'hidden'`          | Shows or hides the leading close action.                  |
+| `value`                    | `string \| string[]`             | Controlled selection. Programmatic writes apply silently. |
+| `openPopup()`              | `void`                           | Opens the listbox popover.                                |
+| `closePopup(returnFocus?)` | `void`                           | Closes the listbox and optionally restores focus.         |
+
+## Events
+
+| Event              | Detail                          | Description                   |
+| ------------------ | ------------------------------- | ----------------------------- |
+| `rc-select-change` | `{ value: string \| string[] }` | Fires when selection changes. |
+| `rc-select-open`   | none                            | Fires when the popup opens.   |
+| `rc-select-close`  | none                            | Fires when the popup closes.  |
+
+## Accessibility
+
+- Trigger uses `role="combobox"`, `aria-haspopup="listbox"`, and
+  `aria-activedescendant`.
+- The popup uses `rc-listbox` for `role="listbox"` and option state.
+- Accessible name is copied from the slotted select label or `aria-label` unless
+  the trigger has an explicit label.