@clicktap/ui 0.43.4 → 0.43.5

package/docs/migrations/2026/01/{2026-01-14-external-link-detection.md → ui-2026-01-14-external-link-detection.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui`, `apps/frontend`
 **Breaking:** No (additive, but requires provider setup for SSR)
 **Classification:** IMPROVEMENT
+**Formerly named:** `2026-01-14-external-link-detection.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 
 ## Dependencies

package/docs/migrations/2026/01/{2026-01-14-use-route-hook.md → ui-2026-01-14-use-route-hook.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui`, `apps/frontend`
 **Breaking:** No (additive, but recommended migration)
 **Classification:** IMPROVEMENT
+**Formerly named:** `2026-01-14-use-route-hook.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 
 ## Dependencies

package/docs/migrations/2026/01/{2026-01-15-input-disable-skeleton.md → ui-2026-01-15-input-disable-skeleton.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui`, `apps/frontend`
 **Breaking:** No
 **Classification:** IMPROVEMENT
+**Formerly named:** `2026-01-15-input-disable-skeleton.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 
 ## Dependencies

package/docs/migrations/2026/02/{2026-02-17-select-popover-portal-container-restored.md → ui-2026-02-17-select-popover-portal-container-restored.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui` Select component, any consumer using Select inside Dialog or Modal
 **Classification:** BUGFIX
 **Breaking:** No
+**Formerly named:** `2026-02-17-select-popover-portal-container-restored.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/03/{2026-03-24-image-dimmed-hidden-onready.md → ui-2026-03-24-image-dimmed-hidden-onready.md}

@@ -6,6 +6,7 @@
 **Classification:** IMPROVEMENT
 **Breaking:** No
 **Group:** plp-image-transitions
+**Formerly named:** `2026-03-24-image-dimmed-hidden-onready.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/03/{2026-03-24-modal-overlay-backdrop-dismiss.md → ui-2026-03-24-modal-overlay-backdrop-dismiss.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui` — `ModalOverlay` component
 **Classification:** BUGFIX
 **Breaking:** No
+**Formerly named:** `2026-03-24-modal-overlay-backdrop-dismiss.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/04/{2026-04-17-select-address-input-onchange-key-or-item.md → ui-2026-04-17-select-address-input-onchange-key-or-item.md}

@@ -5,6 +5,7 @@
 **Affects:** Frontend apps consuming `@clicktap/ui`'s `Select` and components that re-export its types (`AddressInput`, etc.). Any handler typed as `(value: Key) => void` breaks after the update.
 **Classification:** COMPATIBILITY
 **Breaking:** Yes — TypeScript-only. No runtime change; existing handlers still receive the same value at runtime, but strict TS setups fail to compile.
+**Formerly named:** `2026-04-17-select-address-input-onchange-key-or-item.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/05/{2026-05-01-build-pdp-url-util.md → ui-2026-05-01-build-pdp-url-util.md}

@@ -7,6 +7,7 @@
 **Breaking:** No (additive)
 **Status:** ⚠️ **Superseded — never shipped. Do not adopt.** (CTAP-1077)
 **Superseded by:** the backend line-item `productUrl` fields — `QuoteItem.productUrl` / `OrderItem.productUrl` (see `2026-06-08-quote-item-product-url.md` and `2026-06-08-order-item-product-url.md` in the `quote-graphql` / `order-graphql` modules).
+**Formerly named:** `2026-05-01-build-pdp-url-util.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 > ⚠️ **This export was never published.** As of `@clicktap/ui` **0.40.9** there is no
 > `@clicktap/ui/utils/buildPdpUrl` — do not try to import it (there is no "shipped in X" version to check

package/docs/migrations/2026/05/{2026-05-03-auth-aware-graphql-client.md → ui-2026-05-03-auth-aware-graphql-client.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui/utils/createAuthAwareGraphqlClient` — new export
 **Classification:** IMPROVEMENT
 **Breaking:** No (additive)
+**Formerly named:** `2026-05-03-auth-aware-graphql-client.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/05/{2026-05-20-framer-motion-11-idioms.md → ui-2026-05-20-framer-motion-11-idioms.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui/components/Dialog`, `@clicktap/ui/components/ModalOverlay`, `@clicktap/ui/components/Badge`, `@clicktap/ui/components/Loader/CircularEasing`, `@clicktap/ui/components/Loader/Pulse`, and any consumer-side `motion.*` usage on framer-motion 11.x.
 **Classification:** COMPATIBILITY
 **Breaking:** Yes (for consumers passing custom `animationVariants` containing multi-function `transform` strings, transform/scale primitives in modal variants, calc-with-mixed-units in animate targets, or who copy-paste the affected motion patterns into their own components — see Consumer Impact)
+**Formerly named:** `2026-05-20-framer-motion-11-idioms.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/05/{2026-05-21-button-loading-content.md → ui-2026-05-21-button-loading-content.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui/components/Button` (new `ButtonLoadingContent` export) and every submit-style button in the frontend app.
 **Classification:** IMPROVEMENT
 **Breaking:** No
+**Formerly named:** `2026-05-21-button-loading-content.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/05/{2026-05-21-password-check-hide-on-empty.md → ui-2026-05-21-password-check-hide-on-empty.md}

@@ -5,6 +5,7 @@
 **Affects:** `libs/ui/src/components/PasswordCheck/PasswordCheck.tsx`
 **Classification:** IMPROVEMENT
 **Breaking:** No
+**Formerly named:** `2026-05-21-password-check-hide-on-empty.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/05/{2026-05-29-password-check-requirements-variant.md → ui-2026-05-29-password-check-requirements-variant.md}

@@ -5,10 +5,11 @@
 **Affects:** `libs/ui/src/components/PasswordCheck/PasswordCheck.tsx`, `libs/ui/src/components/PasswordCheck/PasswordCheck.types.ts`
 **Classification:** IMPROVEMENT
 **Breaking:** No (the variant is additive; `default` is unchanged)
+**Formerly named:** `2026-05-29-password-check-requirements-variant.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 
-- [`PasswordCheck` `requirements` variant hides until the visitor types](./2026-05-21-password-check-hide-on-empty.md) — the hide-on-empty refinement to this same variant.
+- [`PasswordCheck` `requirements` variant hides until the visitor types](./ui-2026-05-21-password-check-hide-on-empty.md) — the hide-on-empty refinement to this same variant.
 
 ## Summary
 
@@ -26,7 +27,7 @@ This guide documents the `requirements` variant of `PasswordCheck` so forked UI
 
 ## Behavior
 
-- **Hides when `value` is empty** — showing four unchecked bullets before any input reads as a list of demands rather than live feedback. (See the [hide-on-empty guide](./2026-05-21-password-check-hide-on-empty.md).)
+- **Hides when `value` is empty** — showing four unchecked bullets before any input reads as a list of demands rather than live feedback. (See the [hide-on-empty guide](./ui-2026-05-21-password-check-hide-on-empty.md).)
 - Each rule transitions from `○` (slate) to `✓` (green) as it's met.
 - The 5-bar strength meter colors match the `default` variant's meter (red → yellow → green → blue by strength).
 - The component is stateless and pure — strength is derived from `value` via `checkStrength`.

package/docs/migrations/2026/06/{2026-06-17-select-standardization.md → ui-2026-06-17-select-standardization.md}

@@ -5,6 +5,7 @@
 **Affects:** Any app consuming `@clicktap/ui`'s `Select` / `DropdownSelect` (Crispi, FFL, and any fork that renders pickers, sort controls, country/region selects, or configurable-product options).
 **Classification:** FEATURE + BREAKING
 **Breaking:** Yes — (1) `DropdownSelect` removed, (2) the bare `<Select>` is now a **button picker**, not a combobox, (3) `DropdownSelect`'s `classNames.trigger` is now `classNames.input`, (4) the root is `w-full` by default, (5) `<Option>` is react-stately's `Item` — keyed by `key` (no `id`) and **cannot be wrapped**.
+**Formerly named:** `2026-06-17-select-standardization.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 
@@ -284,4 +285,4 @@ Safe — presentation-layer only, no persistent state.
 - Types: `libs/ui/src/components/Select/Select.types.ts`
 - Stories: `libs/ui/src/components/Select/Select.stories.tsx` (`Picker`, `Searchable`, `SearchableAuto`, `AsyncDataSource`, `ServerSideSearch`, `ThemedOptions`, `Grouped`, `Multiple`, `GroupedMultiple`, `ButtonMultiple`)
 - In-repo consumer examples: `apps/frontend/components/AddressForm/AddressForm.tsx` (country/region, autofill, aliases), `apps/frontend/components/Collection/CollectionToolbar.tsx` (toolbar width), `apps/frontend/components/Product/components/ConfigurableOptions/ConfigurableOptions.tsx`
-- Related: [`Select` `onSelectionChange` widened to `Key | T`](../04/2026-04-17-select-address-input-onchange-key-or-item.md), [`Select` `popoverPortalContainer` restored](../02/2026-02-17-select-popover-portal-container-restored.md)
+- Related: [`Select` `onSelectionChange` widened to `Key | T`](../04/ui-2026-04-17-select-address-input-onchange-key-or-item.md), [`Select` `popoverPortalContainer` restored](../02/ui-2026-02-17-select-popover-portal-container-restored.md)

package/docs/migrations/2026/06/{2026-06-18-select-hiddenselect-setvalue-crash.md → ui-2026-06-18-select-hiddenselect-setvalue-crash.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui` `Select` — the **searchable** (ComboBox) variant (`ComboBoxSelect`)
 **Classification:** BUGFIX
 **Breaking:** No
+**Formerly named:** `2026-06-18-select-hiddenselect-setvalue-crash.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Why
 

package/docs/migrations/2026/07/{2026-07-31-ui-exports-bundler-resolution.md → ui-2026-07-31-ui-exports-bundler-resolution.md}

@@ -4,6 +4,7 @@
 **Revised:** 2026-08-08 — the test-runner half (CTAP-1195): every runtime subpath entry gains a `default` condition, so CJS resolvers (Jest) stop falling through to the `.d.ts`. See "Test runners (Jest)" below; reported by noco.
 **Package:** `@clicktap/ui`
 **Breaking:** No — additive to the `exports` map. Existing `moduleResolution: node` / `node10`
+**Formerly named:** `2026-07-31-ui-exports-bundler-resolution.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 consumers are unaffected (that resolver ignores `exports`); this only *adds* working resolution under
 `bundler` / `node16` / `nodenext`.
 **Classification:** BUGFIX (packaging) — unblocks `moduleResolution: bundler`, and with it TypeScript 7

package/docs/migrations/2026/08/{2026-08-02-nextui-to-heroui.md → ui-2026-08-02-nextui-to-heroui.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui` peer dependencies — `Accordion`, `Badge`, `Pagination`, `Tooltip`
 **Classification:** DEPENDENCY
 **Breaking:** Yes (peer dependencies change; requires Tailwind 4 — see below)
+**Formerly named:** `2026-08-02-nextui-to-heroui.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Dependencies
 

package/docs/migrations/2026/08/{2026-08-04-password-reveal-press-and-hold.md → ui-2026-08-04-password-reveal-press-and-hold.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui` — `Input` with `type="password"`.
 **Classification:** IMPROVEMENT (security / UX)
 **Breaking:** Behavioural only — the reveal changed from a click-toggle to press-and-hold. No API/prop
+**Formerly named:** `2026-08-04-password-reveal-press-and-hold.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 change; adoption is automatic.
 **Ticket:** CTAP-1128
 

package/docs/migrations/2026/08/{2026-08-04-resend-code-control.md → ui-2026-08-04-resend-code-control.md}

@@ -6,6 +6,7 @@
 **Classification:** IMPROVEMENT (new capability)
 **Breaking:** No — additive exports.
 **Consumers:** the OTP resend timer — [wire it everywhere](../../../../../../apps/frontend/docs/migrations/2026/08/2026-08-04-otp-resend-timer.md) ·
+**Formerly named:** `2026-08-04-resend-code-control.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 GraphQL contract — [resend mutations](../../../../../../libs/mezzio-modules/user/docs/migrations/2026/08/2026-08-04-otp-resend-mutations.md)
 
 ## Summary

package/docs/migrations/2026/08/{2026-08-06-clicktap-ui-image-next-subpath.md → ui-2026-08-06-clicktap-ui-image-next-subpath.md}

@@ -7,6 +7,7 @@
 **Requires:** `@clicktap/ui` at the release bundling CTAP-1125. Next consumers additionally need `next >= 14` installed — it is now an **optional peer**, so your package manager will not add it for you.
 **Classification:** IMPROVEMENT
 **Breaking:** Yes, for Next consumers — one import path per call site. See "If you are a Next app" below.
+**Formerly named:** `2026-08-06-clicktap-ui-image-next-subpath.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## What changed and why
 

package/docs/migrations/2026/08/{2026-08-06-clicktap-ui-loaders-drop-framer-motion.md → ui-2026-08-06-clicktap-ui-loaders-drop-framer-motion.md}

@@ -5,7 +5,8 @@
 **Affects:** `@clicktap/ui` — `Button`, `ButtonLoadingContent`, `Loader/CircularEasing`, `Loader/Pulse`
 **Breaking:** No API change. **One requirement to be aware of** — see below.
 **Requires:** `@import '@clicktap/ui/theme.css'` in your CSS entry
-([tokens guide](./2026-08-06-clicktap-ui-semantic-tokens.md))
+**Formerly named:** `2026-08-06-clicktap-ui-loaders-drop-framer-motion.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
+([tokens guide](./ui-2026-08-06-clicktap-ui-semantic-tokens.md))
 **Classification:** IMPROVEMENT
 
 ## What changed

package/docs/migrations/2026/08/{2026-08-06-clicktap-ui-semantic-tokens.md → ui-2026-08-06-clicktap-ui-semantic-tokens.md}

@@ -5,6 +5,7 @@
 **Affects:** `@clicktap/ui`, every app that renders its components
 **Breaking:** **Yes — one required import.** Components render *unstyled* without it.
 **Requires:** Tailwind v4 (`@import 'tailwindcss'` in your CSS entry). See
+**Formerly named:** `2026-08-06-clicktap-ui-semantic-tokens.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 [the v4 upgrade guide](../../../../../../apps/frontend/docs/migrations/2026/07/2026-07-31-tailwind-3-to-4.md).
 **Classification:** COMPATIBILITY
 

package/docs/migrations/2026/08/{2026-08-07-ui-peer-contract-form-graphql-optional-peers.md → ui-2026-08-07-ui-peer-contract-form-graphql-optional-peers.md}

@@ -5,6 +5,7 @@
 **Requires:** `@clicktap/ui` at the first release after 0.42.0
 **Classification:** COMPATIBILITY
 **Breaking:** No for minimal consumers; action needed only if you use the form or GraphQL-aware components
+**Formerly named:** `2026-08-07-ui-peer-contract-form-graphql-optional-peers.md` — renamed 2026-08-10 (CTAP-1214) for global filename uniqueness; library guides carry their package slug so they can never collide with an app-level guide in a consumer's aggregated working set. **If you carry a `-applied` sibling under the old name, rename it to match — do NOT re-apply.**
 
 ## Why this exists
 

package/docs/migrations/README.md

@@ -8,27 +8,27 @@ For migrations affecting the frontend app, see [frontend migrations](../../../..
 
 | Date | Migration | Breaking | Dependencies |
 |------|-----------|----------|--------------|
-| 2026-01-14 | [External link detection + `LinkProvider`](./2026/01/2026-01-14-external-link-detection.md) | No | *None* |
-| 2026-01-14 | [`useRoute` hook + `RouteProvider`](./2026/01/2026-01-14-use-route-hook.md) | No | *None* |
-| 2026-01-15 | [`Input` `disableSkeleton` prop](./2026/01/2026-01-15-input-disable-skeleton.md) | No | *None* |
+| 2026-01-14 | [External link detection + `LinkProvider`](./2026/01/ui-2026-01-14-external-link-detection.md) | No | *None* |
+| 2026-01-14 | [`useRoute` hook + `RouteProvider`](./2026/01/ui-2026-01-14-use-route-hook.md) | No | *None* |
+| 2026-01-15 | [`Input` `disableSkeleton` prop](./2026/01/ui-2026-01-15-input-disable-skeleton.md) | No | *None* |
 | 2026-02-16 | [Environment utilities — `@clicktap/ui/utils/env`](./2026/02/ui-2026-02-16-env-utils-from-clicktap-ui.md) | No | *None* |
-| 2026-02-17 | [`Select` `popoverPortalContainer` restored](./2026/02/2026-02-17-select-popover-portal-container-restored.md) | No | *None* |
-| 2026-03-24 | [Image: dimmed, hidden, and onReady Props](./2026/03/2026-03-24-image-dimmed-hidden-onready.md) ↔ | No | *None* |
-| 2026-03-24 | [ModalOverlay: fix dismiss on backdrop click](./2026/03/2026-03-24-modal-overlay-backdrop-dismiss.md) | No | *None* |
-| 2026-04-17 | [`Select`/`AddressInput` `onChange` widened to `Key \| T`](./2026/04/2026-04-17-select-address-input-onchange-key-or-item.md) | Yes | *None* |
+| 2026-02-17 | [`Select` `popoverPortalContainer` restored](./2026/02/ui-2026-02-17-select-popover-portal-container-restored.md) | No | *None* |
+| 2026-03-24 | [Image: dimmed, hidden, and onReady Props](./2026/03/ui-2026-03-24-image-dimmed-hidden-onready.md) ↔ | No | *None* |
+| 2026-03-24 | [ModalOverlay: fix dismiss on backdrop click](./2026/03/ui-2026-03-24-modal-overlay-backdrop-dismiss.md) | No | *None* |
+| 2026-04-17 | [`Select`/`AddressInput` `onChange` widened to `Key \| T`](./2026/04/ui-2026-04-17-select-address-input-onchange-key-or-item.md) | Yes | *None* |
 | 2026-04-24 | [`PLACEHOLDER_IMAGE` Export from `@clicktap/ui/utils/placeholder`](./2026/04/ui-2026-04-24-image-placeholder-frontend-fallback.md) ↔ | No | *None* |
 | 2026-04-30 | [Top-Down PDP Option Dependency — `@clicktap/ui/utils/variantOptions`](./2026/04/ui-2026-04-30-top-down-pdp-option-dependency.md) ↔ | No | *None* |
 | 2026-04-30 | [PDP Option Selection — Conservative Prune Helper (`pruneInvalidSelections`)](./2026/04/ui-2026-04-30-prune-invalid-pdp-selections.md) ↔ | No | Top-Down PDP Option Dependency |
-| 2026-05-01 | [`buildPdpUrl` Utility — `@clicktap/ui/utils/buildPdpUrl`](./2026/05/2026-05-01-build-pdp-url-util.md) | No | *None* |
-| 2026-05-03 | [Auth-aware GraphQL client — `@clicktap/ui/utils/createAuthAwareGraphqlClient`](./2026/05/2026-05-03-auth-aware-graphql-client.md) | No | *None* |
-| 2026-05-20 | [framer-motion 11.x idioms — opacity-only for modals, primitives elsewhere, matched keyframe shapes](./2026/05/2026-05-20-framer-motion-11-idioms.md) ↔ | Yes (custom `animationVariants` only) | *None* |
-| 2026-05-21 | [`ButtonLoadingContent` helper — right-side spinner for all submit buttons](./2026/05/2026-05-21-button-loading-content.md) ↔ | No | *None* |
-| 2026-05-21 | [`PasswordCheck` `requirements` variant hides until the visitor types](./2026/05/2026-05-21-password-check-hide-on-empty.md) | No | *None* |
-| 2026-05-29 | [`PasswordCheck` — the `requirements` variant (adoption guide for forks)](./2026/05/2026-05-29-password-check-requirements-variant.md) | No | PasswordCheck hide-on-empty |
-| 2026-06-17 | [Select standardization — one `<Select searchable>`, `DropdownSelect` removed](./2026/06/2026-06-17-select-standardization.md) ↔ | Yes | *None* |
-| 2026-06-18 | [Select (searchable): fix "setValue is not a function" crash on browser autofill](./2026/06/2026-06-18-select-hiddenselect-setvalue-crash.md) | No | Select standardization |
-| 2026-08-04 | [`ResendCode` control + `useCooldown` hook](./2026/08/2026-08-04-resend-code-control.md) ↔ | No | OTP resend timer (CTAP-1114) |
-| 2026-08-04 | [Password reveal is press-and-hold, not a toggle](./2026/08/2026-08-04-password-reveal-press-and-hold.md) | Behavioural | *None* (CTAP-1128) |
-| 2026-08-06 | [`Image` is framework-free; Next's optimizer moves to `@clicktap/ui/next`](./2026/08/2026-08-06-clicktap-ui-image-next-subpath.md) ↔ | Yes (Next consumers) | *None* |
+| 2026-05-01 | [`buildPdpUrl` Utility — `@clicktap/ui/utils/buildPdpUrl`](./2026/05/ui-2026-05-01-build-pdp-url-util.md) | No | *None* |
+| 2026-05-03 | [Auth-aware GraphQL client — `@clicktap/ui/utils/createAuthAwareGraphqlClient`](./2026/05/ui-2026-05-03-auth-aware-graphql-client.md) | No | *None* |
+| 2026-05-20 | [framer-motion 11.x idioms — opacity-only for modals, primitives elsewhere, matched keyframe shapes](./2026/05/ui-2026-05-20-framer-motion-11-idioms.md) ↔ | Yes (custom `animationVariants` only) | *None* |
+| 2026-05-21 | [`ButtonLoadingContent` helper — right-side spinner for all submit buttons](./2026/05/ui-2026-05-21-button-loading-content.md) ↔ | No | *None* |
+| 2026-05-21 | [`PasswordCheck` `requirements` variant hides until the visitor types](./2026/05/ui-2026-05-21-password-check-hide-on-empty.md) | No | *None* |
+| 2026-05-29 | [`PasswordCheck` — the `requirements` variant (adoption guide for forks)](./2026/05/ui-2026-05-29-password-check-requirements-variant.md) | No | PasswordCheck hide-on-empty |
+| 2026-06-17 | [Select standardization — one `<Select searchable>`, `DropdownSelect` removed](./2026/06/ui-2026-06-17-select-standardization.md) ↔ | Yes | *None* |
+| 2026-06-18 | [Select (searchable): fix "setValue is not a function" crash on browser autofill](./2026/06/ui-2026-06-18-select-hiddenselect-setvalue-crash.md) | No | Select standardization |
+| 2026-08-04 | [`ResendCode` control + `useCooldown` hook](./2026/08/ui-2026-08-04-resend-code-control.md) ↔ | No | OTP resend timer (CTAP-1114) |
+| 2026-08-04 | [Password reveal is press-and-hold, not a toggle](./2026/08/ui-2026-08-04-password-reveal-press-and-hold.md) | Behavioural | *None* (CTAP-1128) |
+| 2026-08-06 | [`Image` is framework-free; Next's optimizer moves to `@clicktap/ui/next`](./2026/08/ui-2026-08-06-clicktap-ui-image-next-subpath.md) ↔ | Yes (Next consumers) | *None* |
 
 ↔ = cross-app migration (has counterpart in frontend app)

package/docs/migrations/index.json

@@ -1,6 +1,6 @@
 [
   {
-    "path": "2026/08/2026-08-07-ui-peer-contract-form-graphql-optional-peers.md",
+    "path": "2026/08/ui-2026-08-07-ui-peer-contract-form-graphql-optional-peers.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-08-07",
@@ -10,7 +10,7 @@
     "affects": ""
   },
   {
-    "path": "2026/08/2026-08-06-clicktap-ui-semantic-tokens.md",
+    "path": "2026/08/ui-2026-08-06-clicktap-ui-semantic-tokens.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-08-06",
@@ -20,7 +20,7 @@
     "affects": "`@clicktap/ui`, every app that renders its components"
   },
   {
-    "path": "2026/08/2026-08-06-clicktap-ui-loaders-drop-framer-motion.md",
+    "path": "2026/08/ui-2026-08-06-clicktap-ui-loaders-drop-framer-motion.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-08-06",
@@ -30,7 +30,7 @@
     "affects": "`@clicktap/ui` — `Button`, `ButtonLoadingContent`, `Loader/CircularEasing`, `Loader/Pulse`"
   },
   {
-    "path": "2026/08/2026-08-06-clicktap-ui-image-next-subpath.md",
+    "path": "2026/08/ui-2026-08-06-clicktap-ui-image-next-subpath.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-08-06",
@@ -40,7 +40,7 @@
     "affects": "Any consumer importing `@clicktap/ui/components/Image` or `@clicktap/ui/components/UploadImage`. Consumer counterpart: [`apps/frontend/docs/migrations/2026/08/2026-08-06-image-from-clicktap-ui-next.md`](../../../../../../apps/frontend/docs/migrations/2026/08/2026-08-06-image-from-clicktap-ui-next.md)"
   },
   {
-    "path": "2026/08/2026-08-04-resend-code-control.md",
+    "path": "2026/08/ui-2026-08-04-resend-code-control.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-08-04",
@@ -50,7 +50,7 @@
     "affects": "`@clicktap/ui` — new `components/ResendCode` and `hooks/useCooldown` exports."
   },
   {
-    "path": "2026/08/2026-08-04-password-reveal-press-and-hold.md",
+    "path": "2026/08/ui-2026-08-04-password-reveal-press-and-hold.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-08-04",
@@ -60,7 +60,7 @@
     "affects": "`@clicktap/ui` — `Input` with `type=\"password\"`."
   },
   {
-    "path": "2026/08/2026-08-02-nextui-to-heroui.md",
+    "path": "2026/08/ui-2026-08-02-nextui-to-heroui.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-08-02",
@@ -70,7 +70,7 @@
     "affects": "`@clicktap/ui` peer dependencies — `Accordion`, `Badge`, `Pagination`, `Tooltip`"
   },
   {
-    "path": "2026/07/2026-07-31-ui-exports-bundler-resolution.md",
+    "path": "2026/07/ui-2026-07-31-ui-exports-bundler-resolution.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-07-31",
@@ -80,7 +80,7 @@
     "affects": ""
   },
   {
-    "path": "2026/06/2026-06-18-select-hiddenselect-setvalue-crash.md",
+    "path": "2026/06/ui-2026-06-18-select-hiddenselect-setvalue-crash.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-06-18",
@@ -90,7 +90,7 @@
     "affects": "`@clicktap/ui` `Select` — the **searchable** (ComboBox) variant (`ComboBoxSelect`)"
   },
   {
-    "path": "2026/06/2026-06-17-select-standardization.md",
+    "path": "2026/06/ui-2026-06-17-select-standardization.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-06-17",
@@ -100,7 +100,7 @@
     "affects": "Any app consuming `@clicktap/ui`'s `Select` / `DropdownSelect` (Crispi, FFL, and any fork that renders pickers, sort controls, country/region selects, or configurable-product options)."
   },
   {
-    "path": "2026/05/2026-05-29-password-check-requirements-variant.md",
+    "path": "2026/05/ui-2026-05-29-password-check-requirements-variant.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-05-29",
@@ -110,7 +110,7 @@
     "affects": "`libs/ui/src/components/PasswordCheck/PasswordCheck.tsx`, `libs/ui/src/components/PasswordCheck/PasswordCheck.types.ts`"
   },
   {
-    "path": "2026/05/2026-05-21-password-check-hide-on-empty.md",
+    "path": "2026/05/ui-2026-05-21-password-check-hide-on-empty.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-05-21",
@@ -120,7 +120,7 @@
     "affects": "`libs/ui/src/components/PasswordCheck/PasswordCheck.tsx`"
   },
   {
-    "path": "2026/05/2026-05-21-button-loading-content.md",
+    "path": "2026/05/ui-2026-05-21-button-loading-content.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-05-21",
@@ -130,7 +130,7 @@
     "affects": "`@clicktap/ui/components/Button` (new `ButtonLoadingContent` export) and every submit-style button in the frontend app."
   },
   {
-    "path": "2026/05/2026-05-20-framer-motion-11-idioms.md",
+    "path": "2026/05/ui-2026-05-20-framer-motion-11-idioms.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-05-20",
@@ -140,7 +140,7 @@
     "affects": "`@clicktap/ui/components/Dialog`, `@clicktap/ui/components/ModalOverlay`, `@clicktap/ui/components/Badge`, `@clicktap/ui/components/Loader/CircularEasing`, `@clicktap/ui/components/Loader/Pulse`, and any consumer-side `motion.*` usage on framer-motion 11.x."
   },
   {
-    "path": "2026/05/2026-05-03-auth-aware-graphql-client.md",
+    "path": "2026/05/ui-2026-05-03-auth-aware-graphql-client.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-05-03",
@@ -150,7 +150,7 @@
     "affects": "`@clicktap/ui/utils/createAuthAwareGraphqlClient` — new export"
   },
   {
-    "path": "2026/05/2026-05-01-build-pdp-url-util.md",
+    "path": "2026/05/ui-2026-05-01-build-pdp-url-util.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-05-01",
@@ -190,7 +190,7 @@
     "affects": "`@clicktap/ui` consumers that render product/category images"
   },
   {
-    "path": "2026/04/2026-04-17-select-address-input-onchange-key-or-item.md",
+    "path": "2026/04/ui-2026-04-17-select-address-input-onchange-key-or-item.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-04-17",
@@ -200,7 +200,7 @@
     "affects": "Frontend apps consuming `@clicktap/ui`'s `Select` and components that re-export its types (`AddressInput`, etc.). Any handler typed as `(value: Key) => void` breaks after the update."
   },
   {
-    "path": "2026/03/2026-03-24-modal-overlay-backdrop-dismiss.md",
+    "path": "2026/03/ui-2026-03-24-modal-overlay-backdrop-dismiss.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-03-24",
@@ -210,7 +210,7 @@
     "affects": "`@clicktap/ui` — `ModalOverlay` component"
   },
   {
-    "path": "2026/03/2026-03-24-image-dimmed-hidden-onready.md",
+    "path": "2026/03/ui-2026-03-24-image-dimmed-hidden-onready.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-03-24",
@@ -220,7 +220,7 @@
     "affects": "`@clicktap/ui` — `Image` component"
   },
   {
-    "path": "2026/02/2026-02-17-select-popover-portal-container-restored.md",
+    "path": "2026/02/ui-2026-02-17-select-popover-portal-container-restored.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-02-17",
@@ -240,7 +240,7 @@
     "affects": "All files importing `isDevelopment` / `isProduction` from local `utils/env`"
   },
   {
-    "path": "2026/01/2026-01-15-input-disable-skeleton.md",
+    "path": "2026/01/ui-2026-01-15-input-disable-skeleton.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-01-15",
@@ -250,7 +250,7 @@
     "affects": "`@clicktap/ui`, `apps/frontend`"
   },
   {
-    "path": "2026/01/2026-01-14-use-route-hook.md",
+    "path": "2026/01/ui-2026-01-14-use-route-hook.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-01-14",
@@ -260,7 +260,7 @@
     "affects": "`@clicktap/ui`, `apps/frontend`"
   },
   {
-    "path": "2026/01/2026-01-14-external-link-detection.md",
+    "path": "2026/01/ui-2026-01-14-external-link-detection.md",
     "module": "libs/frontend-modules/ui",
     "package": "@clicktap/ui",
     "date": "2026-01-14",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clicktap/ui",
-  "version": "0.43.4",
+  "version": "0.43.5",
   "private": false,
   "author": "Clicktap",
   "description": "A library of React UI components and low-level hooks.",