@rcarls/rc-list 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,55 @@
+# @rcarls/rc-list
+
+## 0.6.0
+
+### Minor Changes
+
+- b639e04: Add coordinated list and list-item layout tokens so container queries can
+  stack unchanged content regions while preserving shared subgrid alignment.
+
+  Breaking for the pre-1.0 carousel API: remove the redundant
+  `variant="hero|multi-browse"` attribute and property. The variant only
+  changed slide geometry, which is already controlled by
+  `--rc-carousel-slide-size`. Remove `variant="hero"` without replacement;
+  replace `variant="multi-browse"` with
+  `--rc-carousel-slide-size: min(75%, 300px)`.
+
+- a108336: Add shared-column `rc-list` and `rc-list-item` elements with standard and
+  segmented appearances, default content truncation, and native-backed single or
+  multiple selection coordination. Restore author-owned item state when native
+  selection coordination ends.
+- 6683eb9: Add shared, lifecycle-safe click delegation and let interactive list items
+  forward plain surface clicks to same-root native action targets while
+  preserving nested and modified clicks.
+
+### Patch Changes
+
+- a108336: Warn in development when `rc-card`/`rc-list-item` has `interactive` set but
+  no way to resolve a click target: no `action-target`, and for
+  `rc-list-item`, no native child checkbox/radio either. Surface clicks
+  silently go nowhere in that state; the warning now says so at the point
+  the row or card is set up wrong, instead of leaving it to be discovered
+  by a user tapping a dead row or card.
+- 7382c71: Add a priority-aware action toolbar that moves original controls into an
+  overflow menu. Which actions are promoted is a purely declarative computation
+  from `max-shown` and each action's `data-priority`/authored `slot`, with no
+  runtime measurement of the toolbar's or its children's rendered size: a
+  consumer whose promoted count needs to react to available space owns that
+  decision and writes the resulting `max-shown` value down. Include controlled
+  and uncontrolled open state, keyboard navigation, light dismissal, and a
+  non-Popover fallback.
+
+  Fix `--rc-adaptive-menu-touch-target-overlap-inline-start`/`-end`: the host's
+  own `max-inline-size: 100%` self-referenced a shrink-to-fit ancestor's
+  already-margin-reduced auto size (an app bar's own trailing group, for
+  example), quietly clamping the host back down and canceling the overlap out
+  from under it. The cap now grows by the overlap amount so it only ever bounds
+  the host's real content.
+
+- 57370e4: Align component metadata, aggregate framework typings, development-time native-child
+  validation, controlled menu state, package declarations, and public documentation before the
+  next release.
+- Updated dependencies [6683eb9]
+- Updated dependencies [ee7ba6c]
+- Updated dependencies [30eb232]
+  - @rcarls/rc-common@0.6.0

package/README.md

@@ -0,0 +1,86 @@
+# @rcarls/rc-list
+
+Shared-column list rows with optional native-backed single or multiple
+selection.
+
+```html
+<rc-list selection="single" aria-label="Delivery speed">
+  <rc-list-item>
+    <input slot="leading" type="radio" name="speed" value="standard" checked />
+    <span>Standard</span>
+    <span slot="trailing">Free</span>
+  </rc-list-item>
+  <rc-list-item>
+    <input slot="leading" type="radio" name="speed" value="express" />
+    <span>Express</span>
+    <span slot="trailing">$12</span>
+  </rc-list-item>
+</rc-list>
+```
+
+`rc-list` owns the shared leading, content, and trailing columns. Each direct
+`rc-list-item` participates through CSS subgrid, so optional content aligns
+across rows and unused columns collapse for the whole list.
+
+The default `standard` variant is suited to continuous lists. Use
+`variant="segmented"` for discrete settings-style rows. Theme packages own
+their appearance.
+
+`selection` accepts `none` (the default), `single`, or `multiple`. Selecting
+lists require one direct native radio or checkbox in each row. The native input
+remains the source of truth for checked and disabled state; the list mirrors
+that state to its item and makes a non-interactive row surface activate the
+input. Links, buttons, inputs, and other interactive descendants retain their
+own behavior. Radios in a single-selection list should share a `name`, just as
+they would in an unenhanced native radio group.
+
+## Action targets
+
+For a row whose primary action is not its selection input, set `interactive`
+and point `action-target` at a same-root native anchor or button. Plain primary
+clicks on the row surface activate that target; clicks on nested interactive
+content and modifier-qualified or non-primary clicks keep their native
+behavior.
+
+```html
+<rc-list aria-label="Theme settings">
+  <rc-list-item interactive action-target="open-theme">
+    Theme
+    <button id="open-theme" type="button" slot="trailing">Choose</button>
+  </rc-list-item>
+</rc-list>
+```
+
+The target remains its own keyboard tab stop. `action-target` extends pointer
+reach only and does not turn the row itself into a second button or link.
+
+Content truncates with an ellipsis by default. Set
+`--rc-list-item-content-white-space: normal` where multi-line content is
+intended.
+
+The shared column sizes and each item's region placement are CSS custom
+properties. Consumers can coordinate them from a container query without
+changing the row's source order, interaction, or semantics. For example,
+collapse the shared trailing track and place trailing metadata below content:
+
+```css
+.list-region {
+  container-type: inline-size;
+}
+
+@container (max-width: 24rem) {
+  .list-region rc-list {
+    --rc-list-trailing-size: 0;
+    --rc-list-trailing-gap: 0;
+    --rc-list-item-grid-template-rows: auto auto;
+    --rc-list-item-leading-grid-row: 1 / -1;
+    --rc-list-item-content-grid-row: 1;
+    --rc-list-item-trailing-grid-column: content-start / content-end;
+    --rc-list-item-trailing-grid-row: 2;
+    --rc-list-item-trailing-justify-self: start;
+  }
+}
+```
+
+Import `@rcarls/rc-list` to use the classes without registering them, or import
+`@rcarls/rc-list/define` to register `<rc-list>` and `<rc-list-item>`.