patternfly
diff --git a/‎.changeset/a11y-controller-opts.md‎
Lines changed: 46 additions & 0 deletions b/‎.changeset/a11y-controller-opts.md‎
Lines changed: 46 additions & 0 deletions
diff --git a/‎.changeset/a11y-snapshot-chai.md‎
Lines changed: 32 additions & 0 deletions b/‎.changeset/a11y-snapshot-chai.md‎
Lines changed: 32 additions & 0 deletions
diff --git a/‎.changeset/activedescendant-controller.md‎
Lines changed: 20 additions & 0 deletions b/‎.changeset/activedescendant-controller.md‎
Lines changed: 20 additions & 0 deletions
diff --git a/‎.changeset/clever-places-happen.md‎
Lines changed: 8 additions & 0 deletions b/‎.changeset/clever-places-happen.md‎
Lines changed: 8 additions & 0 deletions
diff --git a/‎.changeset/clever-yaks-thank.md‎
Lines changed: 4 additions & 0 deletions b/‎.changeset/clever-yaks-thank.md‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎.changeset/combobox-controller.md‎
Lines changed: 28 additions & 0 deletions b/‎.changeset/combobox-controller.md‎
Lines changed: 28 additions & 0 deletions
diff --git a/‎.changeset/dirty-bears-win.md‎
Lines changed: 34 additions & 0 deletions b/‎.changeset/dirty-bears-win.md‎
Lines changed: 34 additions & 0 deletions
diff --git a/‎.changeset/few-lands-feel.md‎
Lines changed: 4 additions & 0 deletions b/‎.changeset/few-lands-feel.md‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎.changeset/fluffy-papers-sit.md‎
Lines changed: 16 additions & 0 deletions b/‎.changeset/fluffy-papers-sit.md‎
Lines changed: 16 additions & 0 deletions
diff --git a/‎.changeset/free-ideas-fry.md‎
Lines changed: 4 additions & 0 deletions b/‎.changeset/free-ideas-fry.md‎
Lines changed: 4 additions & 0 deletions
@@ -0,0 +1,46 @@
+---
+"@patternfly/pfe-core": major
+---
+`RovingTabindexController`, `ListboxController`: constructor options were changed. 
+In particular, the `initItems(items: Item[])` and `setActiveItem(item: Item)` methods
+were removed and replaced with the `getItems: () => Item[]` constructor option, and 
+the `atFocusedItemIndex` accessor.
+
+**Before**:
+
+```ts
+#tabindex = new TabindexController(this);
+
+firstUpdated() {
+  this.#tabindex.initItems(this.items);
+}
+
+updated(changed: PropertyValues<this>) {
+  if (changed.has('activeItem')) {
+    this.#tabindex.setActiveItem(this.activeItem);
+  }
+}
+```
+
+**After**:
+
+```ts
+#tabindex = new TabindexController(this, {
+  getItems: () => this.items,
+});
+
+updated(changed: PropertyValues<this>) {
+  if (changed.has('activeItem')) {
+    this.#tabindex.atFocusedItemIndex = this.items.indexOf(this.activeItem);
+  }
+}
+```
+
+
+**For further migration guidance**, please see the [sources in `@patternfly/pfe-core`][sources],
+especially:
+- `ATFocusController.ts`,
+- `RovingTabindexController.ts`, and
+- `ListboxController.ts`.
+
+[sources]: https://github.com/patternfly/patternfly-elements/tree/main/core/pfe-core/controllers/
@@ -0,0 +1,32 @@
+---
+"@patternfly/pfe-tools": minor
+---
+`a11ySnapshot`: Added chai assertions for various accessibility-tree scenarios
+
+Examples:
+```ts
+describe('<pf-accordion>', function() {
+  beforeEach(() => fixture(html`
+    <pf-accordion>
+      <pf-accordion-header id="header1">header-1</pf-accordion-header>
+      <pf-accordion-panel>panel-1</pf-accordion-panel>
+    </pf-accordion>
+  `))
+  describe('clicking the first heading', function() {
+    beforeEach(clickFirstHeading);
+    it('expands the first panel', async function() {
+      expect(await a11ySnapshot())
+        .to.axContainName('panel-1');
+    });
+    it('focuses the first panel', async function() {
+      expect(await a11ySnapshot())
+        .to.have.axTreeFocusOn(document.getElementById('header1'));
+    });
+    it('shows the collapse all button', async function() {
+      expect(await a11ySnapshot())
+        .to.axContainRole('button');
+    });
+  })
+})
+
+```
@@ -0,0 +1,20 @@
+---
+"@patternfly/pfe-core": minor
+---
+✨ Added `ActiveDescendantController`
+
+This controller implements the [WAI-ARIA activedescendant pattern][pattern]
+for keyboard and screen-reader accessibility.
+
+```ts
+#activedescentant = ActivedescendantController.of(this, {
+  getItems: () => this.options,
+  getItemsContainer: () => this.#listbox,
+  getOrientation: () => 'vertical',
+  getActiveDescendantContainer: () => this.#input,
+  getControlsElements: () => [this.#input, this.#button].filter(x => !!x),
+  setItemActive: (item, active) => void (item.active = active),
+});
+```
+
+[pattern]: https://www.w3.org/WAI/ARIA/apg/practices/keyboard-interface/#kbd_focus_activedescendant
@@ -0,0 +1,8 @@
+---
+"@patternfly/eslint-config": patch
+"@patternfly/create-element": patch
+"@patternfly/pfe-core": patch
+"@patternfly/pfe-tools": patch
+"@patternfly/elements": patch
+---
+updated dependencies
@@ -0,0 +1,4 @@
+---
+"@patternfly/elements": minor
+---
+`<pf-card>`: added `title` slot, for when the title is not inline with any slotted header actions
@@ -0,0 +1,28 @@
+---
+"@patternfly/pfe-core": minor
+---
+✨ Added `ComboboxController`
+
+This controller implements the [WAI-ARIA combobox pattern][pattern] for both
+select-only and inline autocomplete comboboxes.
+
+```ts
+#combobox = ComboboxController.of(this, {
+  multi: this.multi,
+  getItems: () => this.options,
+  getFallbackLabel: () => this.accessibleLabel,
+  getListboxElement: () => this._listbox ?? null,
+  getToggleButton: () => this._toggleButton ?? null,
+  getComboboxInput: () => this._toggleInput ?? null,
+  isExpanded: () => this.expanded,
+  requestShowListbox: () => void (this.expanded ||= true),
+  requestHideListbox: () => void (this.expanded &&= false),
+  setItemHidden: (item, hidden) => void (item.hidden = hidden),
+  isItem: item => item instanceof PfOption,
+  setItemActive: (item, active) => item.active = active,
+  setItemSelected: (item, selected) => item.selected = selected,
+});
+
+```
+
+[pattern]: https://www.w3.org/WAI/ARIA/apg/patterns/combobox/
@@ -0,0 +1,34 @@
+---
+"@patternfly/elements": major
+---
+`<pf-icon>`: removed the `getIconUrl` static method, and replaced it with the 
+`resolve` static method
+
+The steps for overriding icon loading behaviour have changed. Before, you had to 
+return a string from the `getIconUrl` method, or the second argument to 
+`addIconSet`. Now, both of those functions must return a Node, or any lit-html
+renderable value, or a Promise thereof.
+
+**Before**:
+
+```js
+PfIcon.addIconSet('local', (set, icon) =>
+  new URL(`/assets/icons/${set}-${icon}.js`));
+
+// or
+PfIcon.getIconUrl = (set, icon) =>
+  new URL(`/assets/icons/${set}-${icon}.js`))
+```
+
+**After**:
+```js
+PfIcon.addIconSet('local', (set, icon) =>
+  import(`/assets/icons/${set}-${icon}.js`))
+    .then(mod => mod.default);
+
+// or
+PfIcon.resolve = (set, icon) =>
+  import(`/assets/icons/${set}-${icon}.js`))
+    .then(mod => mod.default);
+```
+
@@ -0,0 +1,4 @@
+---
+"@patternfly/pfe-core": major
+---
+Removed global `pfeLog` feature
@@ -0,0 +1,16 @@
+---
+"@patternfly/pfe-core": minor
+---
+**Decorators**: Added `@listen`. Use it to attach element event listeners to
+class methods.
+
+```ts
+@customElement('custom-input')
+class CustomInput extends LitElement {
+  @property({ type: Boolean }) dirty = false;
+  @listen('keyup', { once: true })
+  protected onKeyup() {
+    this.dirty = true;
+  }
+}
+```
@@ -0,0 +1,4 @@
+---
+"@patternfly/pfe-core": patch
+---
+`InternalsController`: corrected the types for aria IDL list attributes
-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +---
 +"@patternfly/elements": minor
 +---
 +`<pf-card>`: added `title` slot, for when the title is not inline with any slotted header actions