Merge pull request #7 from mountain-pass/changeset-release/main

tompahoward · web-flow · commit 24b7f2510a0b · 2026-04-24T09:51:48.000+10:00
Version Packages
diff --git a/.changeset/core-search-postcode-locality-state.md b/.changeset/core-search-postcode-locality-state.md
diff --git a/.changeset/postcode-locality-state-components.md b/.changeset/postcode-locality-state-components.md
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,21 @@
 # @mountainpass/addressr-core
 
+## 0.7.0
+
+### Minor Changes
+
+- 825cf97: Add `searchPostcodes`, `searchLocalities`, and `searchStates` methods to `createAddressrClient`. Each method mirrors `searchAddresses` (debounce, abort, retry, HATEOAS root discovery) but targets the new narrower endpoints via distinct rel URIs.
+
+  New public types: `PostcodeSearchResult`, `LocalitySearchResult`, `StateSearchResult`.
+
+  `SearchPage` is now generic: `SearchPage<T = AddressSearchResult>`. Existing consumers referencing the concrete `SearchPage` type remain source-compatible; the default type argument preserves behaviour.
+
+  Internally extracted a private `searchByRel<T>(rel, query, signal)` helper that holds the shared search body; `searchAddresses` now delegates to it. No change to existing `searchAddresses` behaviour or signature.
+
+  See ADR 006 for the architectural rationale.
+
+  **Note**: consumers behind RapidAPI may need to wait for the edge cache to refresh before the new rels become discoverable from the API root. See PROB-004.
+
 ## 0.6.1
 
 ### Patch Changes
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mountainpass/addressr-core",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Framework-agnostic HATEOAS client and types for Australian address search via Addressr",
   "author": {
     "name": "Mountain Pass",
diff --git a/packages/react/CHANGELOG.md b/packages/react/CHANGELOG.md
@@ -1,5 +1,29 @@
 # @mountainpass/addressr-react
 
+## 0.7.0
+
+### Minor Changes
+
+- 54cce83: Add `PostcodeAutocomplete`, `LocalityAutocomplete`, and `StateAutocomplete` components plus matching headless hooks/stores/composables (`usePostcodeSearch`/`useLocalitySearch`/`useStateSearch` for React and Vue, `createPostcodeSearch`/`createLocalitySearch`/`createStateSearch` for Svelte) across all three framework packages.
+
+  Each component mirrors the existing `AddressAutocomplete` baseline:
+  - WAI-ARIA combobox (`role="combobox"`, `aria-expanded`, `aria-controls`, `aria-activedescendant`, `aria-required`, `aria-invalid`, `aria-describedby`)
+  - `role="status"` `aria-live="polite"` live region with entity-specific announcements
+  - Full keyboard support (ArrowDown/Up, Enter, Escape; ArrowDown opens menu when closed)
+  - 44px minimum touch target and 3:1 focus ring inherited from existing `--addressr-*` tokens (no new tokens)
+  - Same four render zones per ADR 004: `renderItem`/`renderLoading`/`renderNoResults`/`renderError` (props in React, slots in Svelte/Vue: `item`, `loading`, `no-results`, `error`)
+
+  `onSelect` (React)/`select` event (Vue)/`onSelect` prop (Svelte) emits the search result directly — postcode, locality, and state results carry every field consumers need, so no follow-up HATEOAS detail fetch is performed (asymmetry with `AddressAutocomplete` is deliberate; see ADR 006).
+
+  Internal refactor: `useAddressSearch` (React/Vue) and `createAddressSearch` (Svelte) now delegate to a private generic primitive (`useSearch<T>` / `createSearch<T>`) shared with the new wrappers. Public API and behaviour unchanged — covered by existing test suites as a regression gate.
+
+  See ADR 006 (`docs/decisions/006-additional-search-endpoints.accepted.md`) for the architectural rationale.
+
+### Patch Changes
+
+- Updated dependencies [825cf97]
+  - @mountainpass/addressr-core@0.7.0
+
 ## 0.6.1
 
 ### Patch Changes
diff --git a/packages/react/package.json b/packages/react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mountainpass/addressr-react",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "React address autocomplete component for Australian address search via Addressr",
   "author": {
     "name": "Mountain Pass",
diff --git a/packages/svelte/CHANGELOG.md b/packages/svelte/CHANGELOG.md
@@ -1,5 +1,29 @@
 # @mountainpass/addressr-svelte
 
+## 0.7.0
+
+### Minor Changes
+
+- 54cce83: Add `PostcodeAutocomplete`, `LocalityAutocomplete`, and `StateAutocomplete` components plus matching headless hooks/stores/composables (`usePostcodeSearch`/`useLocalitySearch`/`useStateSearch` for React and Vue, `createPostcodeSearch`/`createLocalitySearch`/`createStateSearch` for Svelte) across all three framework packages.
+
+  Each component mirrors the existing `AddressAutocomplete` baseline:
+  - WAI-ARIA combobox (`role="combobox"`, `aria-expanded`, `aria-controls`, `aria-activedescendant`, `aria-required`, `aria-invalid`, `aria-describedby`)
+  - `role="status"` `aria-live="polite"` live region with entity-specific announcements
+  - Full keyboard support (ArrowDown/Up, Enter, Escape; ArrowDown opens menu when closed)
+  - 44px minimum touch target and 3:1 focus ring inherited from existing `--addressr-*` tokens (no new tokens)
+  - Same four render zones per ADR 004: `renderItem`/`renderLoading`/`renderNoResults`/`renderError` (props in React, slots in Svelte/Vue: `item`, `loading`, `no-results`, `error`)
+
+  `onSelect` (React)/`select` event (Vue)/`onSelect` prop (Svelte) emits the search result directly — postcode, locality, and state results carry every field consumers need, so no follow-up HATEOAS detail fetch is performed (asymmetry with `AddressAutocomplete` is deliberate; see ADR 006).
+
+  Internal refactor: `useAddressSearch` (React/Vue) and `createAddressSearch` (Svelte) now delegate to a private generic primitive (`useSearch<T>` / `createSearch<T>`) shared with the new wrappers. Public API and behaviour unchanged — covered by existing test suites as a regression gate.
+
+  See ADR 006 (`docs/decisions/006-additional-search-endpoints.accepted.md`) for the architectural rationale.
+
+### Patch Changes
+
+- Updated dependencies [825cf97]
+  - @mountainpass/addressr-core@0.7.0
+
 ## 0.6.1
 
 ### Patch Changes
diff --git a/packages/svelte/package.json b/packages/svelte/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mountainpass/addressr-svelte",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Svelte address autocomplete component for Australian address search via Addressr",
   "author": {
     "name": "Mountain Pass",
diff --git a/packages/vue/CHANGELOG.md b/packages/vue/CHANGELOG.md
@@ -1,5 +1,29 @@
 # @mountainpass/addressr-vue
 
+## 0.7.0
+
+### Minor Changes
+
+- 54cce83: Add `PostcodeAutocomplete`, `LocalityAutocomplete`, and `StateAutocomplete` components plus matching headless hooks/stores/composables (`usePostcodeSearch`/`useLocalitySearch`/`useStateSearch` for React and Vue, `createPostcodeSearch`/`createLocalitySearch`/`createStateSearch` for Svelte) across all three framework packages.
+
+  Each component mirrors the existing `AddressAutocomplete` baseline:
+  - WAI-ARIA combobox (`role="combobox"`, `aria-expanded`, `aria-controls`, `aria-activedescendant`, `aria-required`, `aria-invalid`, `aria-describedby`)
+  - `role="status"` `aria-live="polite"` live region with entity-specific announcements
+  - Full keyboard support (ArrowDown/Up, Enter, Escape; ArrowDown opens menu when closed)
+  - 44px minimum touch target and 3:1 focus ring inherited from existing `--addressr-*` tokens (no new tokens)
+  - Same four render zones per ADR 004: `renderItem`/`renderLoading`/`renderNoResults`/`renderError` (props in React, slots in Svelte/Vue: `item`, `loading`, `no-results`, `error`)
+
+  `onSelect` (React)/`select` event (Vue)/`onSelect` prop (Svelte) emits the search result directly — postcode, locality, and state results carry every field consumers need, so no follow-up HATEOAS detail fetch is performed (asymmetry with `AddressAutocomplete` is deliberate; see ADR 006).
+
+  Internal refactor: `useAddressSearch` (React/Vue) and `createAddressSearch` (Svelte) now delegate to a private generic primitive (`useSearch<T>` / `createSearch<T>`) shared with the new wrappers. Public API and behaviour unchanged — covered by existing test suites as a regression gate.
+
+  See ADR 006 (`docs/decisions/006-additional-search-endpoints.accepted.md`) for the architectural rationale.
+
+### Patch Changes
+
+- Updated dependencies [825cf97]
+  - @mountainpass/addressr-core@0.7.0
+
 ## 0.6.1
 
 ### Patch Changes
diff --git a/packages/vue/package.json b/packages/vue/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mountainpass/addressr-vue",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Vue address autocomplete component for Australian address search via Addressr",
   "author": {
     "name": "Mountain Pass",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@mountainpass/addressr-core",`
`3`		`- "version": "0.6.1",`
	`3`	`+ "version": "0.7.0",`
`4`	`4`	`"description": "Framework-agnostic HATEOAS client and types for Australian address search via Addressr",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "Mountain Pass",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@mountainpass/addressr-react",`
`3`		`- "version": "0.6.1",`
	`3`	`+ "version": "0.7.0",`
`4`	`4`	`"description": "React address autocomplete component for Australian address search via Addressr",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "Mountain Pass",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@mountainpass/addressr-svelte",`
`3`		`- "version": "0.6.1",`
	`3`	`+ "version": "0.7.0",`
`4`	`4`	`"description": "Svelte address autocomplete component for Australian address search via Addressr",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "Mountain Pass",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@mountainpass/addressr-vue",`
`3`		`- "version": "0.6.1",`
	`3`	`+ "version": "0.7.0",`
`4`	`4`	`"description": "Vue address autocomplete component for Australian address search via Addressr",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "Mountain Pass",`