@rcarls/rc-list 0.0.0-next-20260921045401

package/CHANGELOG.md

@@ -0,0 +1,120 @@
+# @rcarls/rc-list
+
+## 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.
+
+- 6e548d9: Several components handle `prefers-reduced-motion: reduce` in their own
+  shadow styles, outside a theme's reach, and refine it the same way the theme
+  layer already does: spatial motion (`translate`, `scale`, `transform`,
+  `inline-size`, `block-size`) goes fully to zero, while effects motion (color,
+  opacity) shortens instead of disappearing.
+
+  `rc-app-bar` zeros its host's hide/show `translate` but shortens the
+  expanded title's fade-in. `rc-disclosure` keeps its panel's expand/collapse
+  zeroed, but its summary/content backstop for a theme-added transition now
+  shortens instead of zeroing it outright. `rc-list-item`'s row and
+  state-layer transition only color and opacity, so the whole sweep shortens.
+  `rc-fab-menu`'s popup mixes `scale` with opacity/overlay/display under one
+  shared duration; reduced motion now zeros the scale and shortens the rest.
+  `rc-switch`'s thumb mixes background-color with inline-size/block-size/
+  transform the same way; the icons and track, which each transition only one
+  kind of property, needed only the zero-or-shorten call. `rc-fab`'s
+  scroll-reveal is opacity/visibility only with no time-based duration to
+  shorten in its scroll-linked path, so reduced motion narrows the scroll
+  window instead of collapsing it to zero; its JS-transition fallback path
+  shortens the same fade rather than removing it. `rc-progress`'s determinate
+  fill transition, previously unguarded under reduced motion, is now zeroed;
+  its indeterminate loop, a continuous sweep with no meaningful shortened
+  form, stays fully stopped rather than shortened.
+
+### Patch Changes
+
+- Updated dependencies [50d5610]
+- Updated dependencies [4341311]
+  - @rcarls/rc-common@0.0.0-next-20260921045401
+
+## 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>`.