@databricks/design-system 2.0.5 → 2.0.7

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # Changelog
 
+## 2.0.7 (2026-09-17T20:28:50Z)
+
+### Added
+
+- New `SlidesIcon` component available for import from `@databricks/design-system`.
+
+### Changed
+
+- `Button`: replaced the boolean `useNativeButtonOverride` prop with a tri-state `forceMode` prop. Values: `'native'` (default — always uses the native implementation), `'legacy-antd'` (always uses the AntD implementation), or `'flag'` (defers to the `databricks.fe.designsystem.useNativeButton` SAFE flag). Existing callsites should add `forceMode="flag"` to preserve current flag-gated behavior.
+- `LegacyForm.Item`: the label help icon now renders as the Du Bois `InfoSmallIcon` instead of AntD's `QuestionCircleOutlined`. A caller-supplied tooltip icon still takes precedence.
+- Design-system `safex` and `serverSideSafe` wrappers now accept an optional `testDefault` argument for controlling flag values in Jest and `UiTestServer` fallback paths.
+- `AlertProps` no longer references AntD types on its public surface.
+
+### Deprecated
+
+- `theme.general.iconfontCssPrefix` has been removed from the theme object.
+
+### Fixed
+
+- `Switch` (native/Radix variant): the track no longer collapses to zero width when a host app's legacy `input[type='checkbox']` CSS reset is present (e.g. Bootstrap).
+- `Notification` (Radix Toast): toast close buttons are now clickable while a modal is open, and the empty toast viewport band no longer blocks clicks to content beneath it.
+- `TypeaheadCombobox` (v1 multi-select): clear and chevron controls are now vertically centered within the tag row.
+- `LegacySelect`: the dropdown chevron no longer shifts out of alignment when rendered with a native `.db-icon` element.
+
+### Removed
+
+- `LegacyTooltip` has been removed from `@databricks/design-system`. Use `Tooltip` instead.
+
+## 2.0.6 (2026-09-15T18:10:12Z)
+
+### Added
+- `LakewatchIcon` product mark added to the icon registry; render via `<LakewatchIcon />`.
+- `getIconClassName()` utility exported from the package; returns a CSS selector matching both the legacy AntD (`.anticon`) and native (`.db-icon`) icon wrappers.
+- `Icon` accepts a new `forceNativeIcon` prop to opt an individual instance into the native icon implementation independent of the server-side flag.
+- `--db-ai-gradient-*` color tokens are now available for AI-colored icon styling.
+- `--db-popup-*` and `--db-list-*` CSS token families are now included in the package stylesheet.
+
+### Changed
+- v2 design token names: `press`/`pressed` state tokens have been renamed — use `active` (CSS `:active`) and `selected` (checked/pressed control state) in place of `press`/`pressed` in any `--db-*` token names you reference directly.
+
+### Fixed
+- `Drawer`: the `du-bois-dark` theme class is now preserved when a consumer-provided `className` is also present, restoring correct dark-mode token resolution.
+- Native `Button` (under `useNativeButton`): loading spinner animation duration corrected from 8 seconds to 1 second.
+- Native `Button` (under `useNativeButton`): disabled border is now correctly shown on buttons that are both `disabled` and `loading`.
+- Native `Checkbox.Group` (under `useNativeCheckbox`): top spacing between a `FormUI.Label` and a `Checkbox.Group` is restored to match the legacy AntD layout.
+- Native `Radio.Group` (under `useNativeRadio`): top spacing between a `FormUI.Label` and a `Radio.Group` is restored to match the legacy AntD layout.
+
 ## 2.0.5 (2026-09-10T17:52:39Z)
 
 ### Added

package/design-guidance/docs/README.md

@@ -0,0 +1,40 @@
+# Agent workflows for Du Bois
+
+These workflows guide component and icon selection, screen building, validation,
+and design review with `@databricks/design-system`.
+
+Read the package's `AGENTS.md` first. In Universe, read `js/docs/design-system/README.md`
+and the consuming application's instructions first; those remain authoritative for
+component usage, styling, localization, and testing. Use these workflows alongside the
+Du Bois usage skill.
+
+## Choose a workflow
+
+| Task | Read |
+| --- | --- |
+| Select a component | [Pick a component](../skills/dbui-pick-component.md) |
+| Select an icon | [Pick an icon](../skills/dbui-pick-icon.md) |
+| Implement a screen | [Build a screen](../skills/dbui-build-screen.md) |
+| Check implementation | [Validate](../skills/dbui-validate.md) |
+| Review a design | [Review](../skills/dbui-review.md) |
+| Review copy only | [Voice](../skills/dbui-check-voice.md) |
+| Review UX behavior | [Guidelines](../skills/dbui-check-guidelines.md) |
+| Review design intent | [Principles](../skills/dbui-check-principles.md) |
+| Review platform fit | [Ecosystem](../skills/dbui-check-ecosystem.md) |
+
+Open the relevant Markdown file in your coding agent. Use your agent's supported
+configuration to reference these Markdown instructions. In npm installations they live under
+`node_modules/@databricks/design-system/design-guidance/`.
+
+## Sources and boundaries
+
+The installed package's `dist-types/index.d.ts` and referenced declarations define
+available exports and props. In Universe, component source and Storybook MDX are the
+API reference. Verify component names and props against these sources.
+
+Verify terminology against current product guidance. Ecosystem checks require evidence supplied by the
+project; confidential platform context is not distributed in this package.
+
+Component recipes remain in existing usage documentation. CSS token authoring is
+explained in Universe's `design-system/src/design-tokens/README.md`; this workflow's
+[Token selection](tokens.md) explains how to find those tokens as a consumer.

package/design-guidance/docs/review-contract.md

@@ -0,0 +1,22 @@
+# Review output
+
+Every specialist check reports:
+
+```text
+CHECK: standards | guidelines | voice | principles | ecosystem
+STATUS: complete | partial | skipped — reason
+
+FIX
+- <location>: <observed problem>; <evidence and consequence>; <specific correction>
+IMPROVE
+- <location>: <tradeoff>; <suggested change>
+WORKING
+- <location>: <specific successful behavior>
+```
+
+Leave sections empty when there are no findings. `FIX` requires an observed defect or
+an applicable requirement and evidence. `IMPROVE` is a design judgment, not a policy
+violation. Cite source lines, visible UI, a reproduced interaction, or supplied
+requirements. State what could not be checked; a screenshot cannot prove keyboard
+behavior, actual permissions, or runtime token values. Do not invent findings to fill
+sections or describe an unrun check as passing.

package/design-guidance/docs/tokens.md

@@ -0,0 +1,35 @@
+# Token selection
+
+Du Bois has two theming systems. Existing product code may read `theme.*` through
+`useDesignSystemTheme()` and style through Emotion. Follow the application's
+instructions for that code. New CSS token authoring uses `--db-*` variables from
+`design-system/src/design-tokens/`, not the legacy `src/tokens-groups/` catalog.
+Do not migrate an application's styling system as a side effect of building a screen.
+
+## Find a token
+
+In Universe, read `design-system/src/design-tokens/README.md` and search
+`design-system/src/design-tokens/system-tokens/*.css`. The system → family → component
+chain defines meaning and override boundaries. A custom application surface consumes
+system semantics; authoring a library component follows the component-tier rules.
+
+In an npm installation, import the public `@databricks/design-system/index.css` and,
+for dark mode, `@databricks/design-system/index-dark.css` as described in `AGENTS.md`.
+Those built styles include the CSS tokens. Search the installed `dist/index.css` for
+an exact declaration before using it. Source-only paths such as `all-styles.css` are
+not part of the published API.
+
+Prefer semantic names such as `--db-surface-base` to their backing primitive color.
+Do not invent token names, flatten aliases into hex values, or add fallback literals
+that hide missing styles. Use component props before overriding component tokens.
+
+## Verify the result
+
+Check light and dark provider modes, including portaled content. CSS aliases resolve
+where they are declared; a custom alias defined only on `:root` can retain a light
+value inside a dark subtree. Follow the token README's scoping rules when defining
+aliases. Use existing typography components and scales; rem-based tokens can scale
+with the root font size, but legacy pixel values do not automatically do so.
+
+Emotion remains a peer dependency for current Du Bois components. Choosing plain CSS
+for application-owned styles does not make the library independent of Emotion.

package/design-guidance/docs/voice.md

@@ -0,0 +1,40 @@
+# Product voice and tone
+
+Apply current product terminology, localization requirements, and accessibility
+guidance when using these editorial defaults.
+This is a review aid, not a replacement for those sources.
+
+| Principle | Prefer | Avoid |
+| --- | --- | --- |
+| Clear over clever | Query sample data | Unleash insights |
+| Direct and concise | Delete catalog | Click here to delete the catalog |
+| Honest about capability | Runs on serverless compute | Blazing-fast compute |
+| Respect the reader | Review affected objects before deleting | Oops, careful |
+
+Use sentence case except established product names and acronyms. Prefer active verbs
+and American spelling in English copy. Avoid marketing filler, emoji, and exclamation
+marks in ordinary product messages. Preserve intentional product-specific language.
+
+| Context | What the copy should provide |
+| --- | --- |
+| Navigation and titles | A stable name matching the destination or task |
+| Button | The action and object; describe progress while working |
+| Empty state | What is absent and a useful next step |
+| No results | What was searched or filtered and how to broaden it |
+| Success | What completed and any useful result |
+| Error | What happened, a known cause, and a feasible recovery action |
+| Permission denied | The required access and a valid route to request it |
+| Destructive confirmation | The affected objects, scope, and whether recovery is possible |
+| Tooltip | Relevant information beyond the visible label |
+
+Do not invent a cause, permission requirement, count, or recovery promise to make a
+message sound complete. Do not say an action is irreversible if it can be undone.
+Action labels should be specific where needed; conventional labels such as Cancel are
+not automatically defects. Avoid treating editorial preferences as mechanical bans.
+
+Review accessible names as well as visible strings. Icon-only controls need meaningful
+names. Labels must survive truncation and translation. Use the project's localization
+and date/number formatters rather than concatenating strings or forcing ISO dates into
+all UI. Alt text should convey the image's purpose, not meet an arbitrary character quota.
+
+Verify product names against current product guidance.

package/design-guidance/skills/dbui-build-screen.md

@@ -0,0 +1,24 @@
+---
+name: dbui-build-screen
+description: Build a Du Bois screen from a brief, screenshot, or Figma design.
+---
+
+# Build a screen
+
+1. Identify the task, user, and states from the supplied brief. State assumptions;
+   ask only for missing decisions that block useful implementation.
+2. Inspect the consuming application's existing page layout and routing. Reuse its
+   shell and shared components. In Universe, search `@databricks/web-shared` and
+   Storybook patterns before constructing layout.
+3. Map each region with [Pick a component](dbui-pick-component.md) and each icon with
+   [Pick an icon](dbui-pick-icon.md). Verify Figma variants against actual props.
+4. Follow the app's styling convention and [Token selection](../docs/tokens.md).
+   Preserve component states and geometry through props rather than CSS overrides.
+5. Implement the full applicable state set: loading, populated, empty, filtered-empty,
+   error, denied, and disabled. Distinguish unavailable data from a genuine zero.
+   Read [Voice](../docs/voice.md) for labels, recovery, and confirmation text.
+6. Run [Validate](dbui-validate.md). Exercise the main journey and relevant keyboard,
+   theme, responsive, and overflow behavior using the project's test workflow.
+
+Report the implemented journey, checks performed, and unresolved gaps. For a design
+critique beyond implementation correctness, use [Review](dbui-review.md).

package/design-guidance/skills/dbui-check-ecosystem.md

@@ -0,0 +1,21 @@
+---
+name: dbui-check-ecosystem
+description: Check platform fit against project-provided evidence and skip unsupported claims.
+---
+
+# Check ecosystem fit
+
+Read relevant product requirements, architecture, permission models, and neighboring
+flows supplied by the project. In Universe, follow the applicable platform documentation
+instructions. Use project-provided context for platform-specific decisions.
+
+If no reliable context is available, return `STATUS: skipped — no platform evidence
+available`. With partial context, state the limits. Do not replace missing facts with
+generic assumptions about Databricks permissions, availability, or product naming.
+
+Check whether the design matches object scope, access requirements, supported actions,
+credential ownership, and existing capabilities. Separate facts from open questions.
+For each correction cite the supplied source and explain the actual mismatch. Do not copy
+confidential evidence into published guidance or expose sensitive details in a report.
+
+Return the [review contract](../docs/review-contract.md) with `CHECK: ecosystem`.

package/design-guidance/skills/dbui-check-guidelines.md

@@ -0,0 +1,29 @@
+---
+name: dbui-check-guidelines
+description: Review the UX behaviors relevant to a Du Bois surface.
+---
+
+# Check guidelines
+
+Select the topics relevant to the task; do not generate a finding for every row.
+Use these questions to evaluate the design in context.
+
+| Topic | Question |
+| --- | --- |
+| Status | Does long-running work show progress, completion, and a way to return? |
+| Errors | Does the error describe the problem and a feasible next step? |
+| States | Are empty, loading, filtered-empty, denied, and failed distinguishable? |
+| Tables | Can users find, compare, inspect, and act on the data needed for this task? |
+| Filtering | Is the active scope visible, with a way to clear it? |
+| Lineage | Does the graph explain relevant relationships and direction? |
+| Editors | Can users make, inspect, and recover from small changes? |
+| AI output | Can users recognize uncertainty, inspect sources, and handle wrong answers? |
+| Keyboard | Does the interaction follow its component's keyboard contract? |
+| Structure | Can a user arriving by deep link understand context and continue? |
+| Consequence | Is the effect and scope clear before a consequential action? |
+| Charts | Are units, limits, missing data, and exclusions apparent? |
+| Explanation | Is unfamiliar information available where a decision needs it? |
+
+For each relevant topic, cite the actual surface behavior and practical consequence.
+Use `FIX` for demonstrated defects or misleading behavior, `IMPROVE` for a tradeoff.
+Return the [review contract](../docs/review-contract.md) with `CHECK: guidelines`.

package/design-guidance/skills/dbui-check-principles.md

@@ -0,0 +1,26 @@
+---
+name: dbui-check-principles
+description: Review design intent and consequential decisions.
+---
+
+# Check principles
+
+Use these principles to explain design tradeoffs:
+
+- Built for people accountable for the data: make scope, sources, and consequences clear.
+- Calm carries the work: reserve attention for meaningful change and decisions.
+- Clear over clever, honest over hype: prefer verifiable capability to promises.
+- Every element earns its place: identify what a decoration or control contributes.
+- Learned once, true everywhere: compare with actual neighboring product patterns.
+- Easy the first time, fast the thousandth: preserve discovery and efficient repeat use.
+
+Check agency, accountability, custody, fairness, and access where relevant. Look for
+surprising commitments, unverifiable claims, hidden data boundaries, manipulative choices,
+and inaccessible routes to a task. Require evidence before calling these defects.
+
+These are design questions, not blanket restrictions on automation or permission models.
+Previously authorized automation can be appropriate; permission checks may intentionally
+prevent an action. A primary destructive button in `DangerModal` is not inherently a dark
+pattern. Evaluate intent, authorization, reversibility, and clear consequences together.
+
+Return the [review contract](../docs/review-contract.md) with `CHECK: principles`.

package/design-guidance/skills/dbui-check-voice.md

@@ -0,0 +1,17 @@
+---
+name: dbui-check-voice
+description: Review user-facing copy for clarity, consistency, and appropriate tone.
+---
+
+# Check voice
+
+Read [Voice and tone](../docs/voice.md). Extract visible copy and accessible strings:
+labels, placeholders, tooltips, headings, errors, toasts, and empty states. Skip internal
+identifiers and telemetry keys. Check terminology against supplied current product guidance.
+
+Propose exact replacements for unclear actions, inconsistent names, unsupported claims,
+missing units, and errors without a feasible next step. Distinguish editorial suggestions
+from defects that mislead the user. Do not invent product capabilities to improve wording.
+
+Review layout only where text loses its meaning through truncation or inaccessible naming.
+Return the [review contract](../docs/review-contract.md) with `CHECK: voice`.

package/design-guidance/skills/dbui-pick-component.md

@@ -0,0 +1,23 @@
+---
+name: dbui-pick-component
+description: Select a Du Bois component for a UI task without guessing exports or props.
+---
+
+# Pick a component
+
+1. Describe the interaction: selecting a value, running an action, navigating, or
+   revealing content. Search the existing `AGENTS.md` selection tables; in Universe,
+   use `js/docs/design-system/components.md` and the consuming app's shared components.
+2. Prefer the documented composite: `DangerModal` for destructive confirmation,
+   `InfoTooltip` for an info affordance, `DropdownMenu` for actions. A value picker
+   instead needs a selection component such as `SimpleSelect` or `DialogCombobox`.
+3. Verify the export and props in the installed `dist-types` declarations. In Universe,
+   also read `js/packages/du-bois/src/primitives/<Component>/<Component>.mdx` and source.
+   Import named exports from `@databricks/design-system`.
+4. When translating Figma, inspect the component's Code Connect mapping if available.
+   Nested layers may be slots or children, not new public components or Boolean props.
+5. If there is a gap, describe what you searched and compose the nearest supported
+   primitives. Do not invent an export, duplicate a shared widget, or add a dependency.
+
+Return the selected component, why it fits, the verified import, and any relevant
+composition or accessibility requirement. Use [Pick an icon](dbui-pick-icon.md) for glyphs.

package/design-guidance/skills/dbui-pick-icon.md

@@ -0,0 +1,23 @@
+---
+name: dbui-pick-icon
+description: Find a Du Bois icon by meaning and verify its exported name.
+---
+
+# Pick an icon
+
+1. Identify whether the icon represents an object, action, state, or control chrome.
+2. In Universe, read `design-system/src/design-system/Icon/CLAUDE.md`, then search
+   `icon-metadata.json` in that directory and `design-system/src/assets/icons/aliases.json`
+   by concept and synonyms. Follow the classification and description when present.
+3. In an installed package, search `dist/icon-metadata.json` for classifications,
+   descriptions, and product areas. This file is also exported as
+   `@databricks/design-system/icon-metadata.json`. Check `dist-types/design-system/Icon/`
+   and the root declarations for available names. For icons without metadata, use an
+   existing product example or ask for design input when the distinction matters.
+4. Verify the exact named export before importing from `@databricks/design-system`.
+   Use a verified catalog icon; if none fits, report the gap.
+5. Use the component's icon prop where available. Give an icon-only control an
+   accessible name; a tooltip alone does not supply one. Let the component size and
+   color its icon instead of overriding the glyph to match a screenshot.
+
+Return the export, meaning, and source evidence. If nothing fits, report the gap.

package/design-guidance/skills/dbui-review.md

@@ -0,0 +1,30 @@
+---
+name: dbui-review
+description: Review a Du Bois design through standards, UX, voice, principles, and platform fit.
+---
+
+# Review a design
+
+State the user, task, maturity, and surface inferred from the supplied input. Use existing
+context; clarify only consequential uncertainty. A brief or screenshot permits different
+checks from runnable code. State which inputs and interactions are actually available.
+
+Run the relevant checks, each with that same scope:
+
+- [Standards](dbui-validate.md): API and implementation correctness.
+- [Guidelines](dbui-check-guidelines.md): task behavior.
+- [Voice](dbui-check-voice.md): user-facing copy.
+- [Principles](dbui-check-principles.md): intent and consequential decisions.
+- [Ecosystem](dbui-check-ecosystem.md): platform fit where evidence is available.
+
+Run sequentially, or delegate independent checks if the user's instructions and agent
+capabilities permit it. Do not require a specific tool, model, or parallel agent facility.
+Each check uses the [review contract](../docs/review-contract.md); report failed or skipped
+checks honestly instead of treating them as a pass.
+
+Deduplicate findings about the same root problem. Lead with consequential `FIX` items,
+then useful `IMPROVE` suggestions and specific `WORKING` observations. Preserve evidence,
+locations, and concrete next steps. Resolve disagreements against the actual API and
+requirements; a stylistic preference does not override correct component behavior.
+
+Review alone does not authorize changing files, posting comments, or taking external actions.

package/design-guidance/skills/dbui-validate.md

@@ -0,0 +1,23 @@
+---
+name: dbui-validate
+description: Check Du Bois usage and run the consuming project’s existing checks.
+---
+
+# Validate implementation
+
+Read the existing component, accessibility, and pitfalls guidance first: package
+`AGENTS.md`, or `js/docs/design-system/` in Universe. Check the bespoke composition and
+styling closely, including named exports, real props, `componentId`, labels, and tokens.
+Generated code and use of a library component do not prove the composition is correct.
+
+Run the consuming project's registered lint, formatting, type, and relevant test
+commands. In Universe, follow its `CLAUDE.md` and `TESTING.md`; use the required UI test
+workflow when authoring UI tests. Linters cover only their configured rules and can
+have false positives.
+
+Verify interactions in the rendered surface when available: keyboard focus, activation,
+Escape and focus restoration, loading/error/empty branches, light/dark mode, and layout
+at the supported widths. A screenshot-only review must mark runtime checks as unverified.
+
+Use the [review contract](../docs/review-contract.md) with `CHECK: standards`. Separate
+observed failures from recommendations, and include check failures or unavailable checks.

package/dist/{RHFControlledTypeaheadComboboxV2-DsH-nIEk.js → RHFControlledTypeaheadComboboxV2-nSSYj16I.js}

@@ -1,8 +1,8 @@
 import { jsxs, jsx } from '@emotion/react/jsx-runtime';
 import React__default, { useRef, useCallback } from 'react';
 import { useController } from 'react-hook-form';
-import { u as useComboboxState, T as TypeaheadComboboxRoot, a as TypeaheadComboboxMultiSelectInput, b as TypeaheadComboboxMenu, c as TypeaheadComboboxInput } from './index-BRAVZg-S.js';
-import './WizardStepContentWrapper-Bq1wm0V7.js';
+import { u as useComboboxState, T as TypeaheadComboboxRoot, a as TypeaheadComboboxMultiSelectInput, b as TypeaheadComboboxMenu, c as TypeaheadComboboxInput } from './index-CUCuUviS.js';
+import './WizardStepContentWrapper-bbh_CoIf.js';
 import '@react-aria/listbox';
 import 'classnames';
 import '@emotion/react';
@@ -18,6 +18,8 @@ import '@floating-ui/dom';
 import 'react-dom';
 import '@radix-ui/react-hover-card';
 import '@radix-ui/react-toast';
+import '@radix-ui/react-slider';
+import '@radix-ui/react-toolbar';
 import '@react-aria/combobox';
 import '@react-aria/overlays';
 import '@react-aria/utils';
@@ -53,12 +55,10 @@ import '@radix-ui/react-navigation-menu';
 import '@radix-ui/react-radio-group';
 import '@radix-ui/react-progress';
 import 'react-resizable';
-import '@radix-ui/react-slider';
 import '@radix-ui/react-scroll-area';
 import '@radix-ui/react-tabs';
 import 'lodash/debounce';
 import '@radix-ui/react-toggle';
-import '@radix-ui/react-toolbar';
 
 function RHFControlledTypeaheadComboboxV2({ name, control, rules, allItems, itemToString, matcher, getKey, allowNewValue, children, validationState, inputProps, menuProps, onInputChange, componentId, analyticsEvents, valueHasNoPii, preventUnsetOnBlur, ...props }) {
     const { field } = useController({
@@ -169,4 +169,4 @@ function RHFControlledMultiSelectTypeaheadComboboxV2({ name, control, rules, all
 }
 
 export { RHFControlledMultiSelectTypeaheadComboboxV2, RHFControlledTypeaheadComboboxV2 };
-//# sourceMappingURL=RHFControlledTypeaheadComboboxV2-DsH-nIEk.js.map
+//# sourceMappingURL=RHFControlledTypeaheadComboboxV2-nSSYj16I.js.map

package/dist/{RHFControlledTypeaheadComboboxV2-DsH-nIEk.js.map → RHFControlledTypeaheadComboboxV2-nSSYj16I.js.map}

@@ -1 +1 @@
-{"version":3,"file":"RHFControlledTypeaheadComboboxV2-DsH-nIEk.js","sources":["../src/design-system/FormV2/RHFControlledTypeaheadComboboxV2.tsx"],"sourcesContent":["import type { Key } from '@react-types/shared';\nimport type { HTMLAttributes } from 'react';\nimport React, { useCallback, useRef } from 'react';\nimport type { Control, FieldPath, FieldValues, UseControllerProps } from 'react-hook-form';\nimport { useController } from 'react-hook-form';\n\nimport type { DesignSystemEventProviderAnalyticsEventTypes } from '../DesignSystemEventProvider';\nimport {\n  TypeaheadComboboxInput as TypeaheadComboboxV2Input,\n  TypeaheadComboboxMenu as TypeaheadComboboxV2Menu,\n  TypeaheadComboboxMultiSelectInput as TypeaheadComboboxV2MultiSelectInput,\n  TypeaheadComboboxRoot as TypeaheadComboboxV2Root,\n  useComboboxState as useComboboxStateV2,\n} from '../TypeaheadComboboxV2';\nimport type { TypeaheadComboboxInputProps as TypeaheadComboboxV2InputProps } from '../TypeaheadComboboxV2/TypeaheadComboboxInput';\nimport type { TypeaheadComboboxMenuProps as TypeaheadComboboxV2MenuProps } from '../TypeaheadComboboxV2/TypeaheadComboboxMenu';\nimport type { TypeaheadComboboxMultiSelectInputProps as TypeaheadComboboxV2MultiSelectInputProps } from '../TypeaheadComboboxV2/TypeaheadComboboxMultiSelectInput';\nimport type { TypeaheadComboboxRootProps as TypeaheadComboboxV2RootProps } from '../TypeaheadComboboxV2/TypeaheadComboboxRoot';\nimport type { ComboboxStateValue } from '../TypeaheadComboboxV2/hooks/useComboboxState';\nimport type { AnalyticsEventValueChangeNoPiiFlagProps, ValidationState } from '../types';\n\n// This file holds the react-aria TypeaheadComboboxV2 RHF adapters, split out of RHFAdapters.tsx so the\n// (broadly imported) RHFControlledComponents barrel does not statically pull the react-aria combobox\n// subtree into the common chunk. RHFAdapters.tsx React.lazy-imports these, so the ~175KB subtree only\n// loads on pages that actually render a V2 typeahead.\n\n// These props are omitted, as `useController` handles them. (Mirrors RHFAdapters.tsx.)\ntype OmittedOriginalProps = 'name' | 'onChange' | 'onBlur' | 'value' | 'defaultValue' | 'checked';\n\nexport interface RHFControlledTypeaheadComboboxV2Props<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n>\n  extends\n    Omit<\n      TypeaheadComboboxV2RootProps<TFieldValues[TName]>,\n      OmittedOriginalProps | 'comboboxState' | 'componentId' | 'children'\n    >,\n    UseControllerProps<TFieldValues, TName>,\n    AnalyticsEventValueChangeNoPiiFlagProps<DesignSystemEventProviderAnalyticsEventTypes.OnValueChange> {\n  control: Control<TFieldValues, any>;\n  name: TName;\n  // The react-aria hook owns filtering, so children render `comboboxState.filteredItems` rather than\n  // receiving a consumer-maintained `items` list (the key API change from the legacy adapter).\n  children: (renderProps: { comboboxState: ComboboxStateValue<Required<TFieldValues>[TName]> }) => React.ReactNode;\n  validationState?: ValidationState;\n  allItems: Required<TFieldValues>[TName][];\n  itemToString: (item: Required<TFieldValues>[TName]) => string;\n  matcher?: (item: Required<TFieldValues>[TName], query: string) => boolean;\n  getKey?: (item: Required<TFieldValues>[TName]) => Key;\n  /* Whether to allow the input value to not match any options in the list. For this to work, the item type (T) must be a string.\n   * Defaults to false.\n   */\n  allowNewValue?: boolean;\n  inputProps?: Partial<Omit<TypeaheadComboboxV2InputProps, 'componentId'>>;\n  menuProps?: Partial<TypeaheadComboboxV2MenuProps>;\n  onInputChange?: (inputValue: string) => void;\n  /** @deprecated No-op under react-aria; accepted for source-compat while migrating off the legacy adapter. */\n  preventUnsetOnBlur?: boolean;\n}\n\nexport function RHFControlledTypeaheadComboboxV2<\n  TFieldValues extends FieldValues,\n  TName extends FieldPath<TFieldValues>,\n>({\n  name,\n  control,\n  rules,\n  allItems,\n  itemToString,\n  matcher,\n  getKey,\n  allowNewValue,\n  children,\n  validationState,\n  inputProps,\n  menuProps,\n  onInputChange,\n  componentId,\n  analyticsEvents,\n  valueHasNoPii,\n  preventUnsetOnBlur,\n  ...props\n}: RHFControlledTypeaheadComboboxV2Props<TFieldValues, TName> &\n  Omit<HTMLAttributes<HTMLDivElement>, 'children'>): JSX.Element {\n  const { field } = useController<TFieldValues, TName>({\n    name,\n    control,\n    rules,\n  });\n\n  const comboboxState = useComboboxStateV2({\n    allItems,\n    itemToString,\n    getKey,\n    matcher,\n    allowNewValue,\n    formValue: field.value,\n    formOnChange: field.onChange,\n    formOnBlur: field.onBlur,\n    componentId,\n    analyticsEvents,\n    valueHasNoPii,\n    preventUnsetOnBlur,\n    // react-aria owns the input value; surface changes through the 'input' state event so the legacy\n    // `onInputChange` contract keeps working without making the input value a controlled prop.\n    onStateChange: onInputChange\n      ? (change) => {\n          if (change.type === 'input') {\n            onInputChange(change.inputValue);\n          }\n        }\n      : undefined,\n  });\n\n  return (\n    <TypeaheadComboboxV2Root {...props} comboboxState={comboboxState}>\n      <TypeaheadComboboxV2Input {...inputProps} validationState={validationState} ref={field.ref} />\n      <TypeaheadComboboxV2Menu {...menuProps}>{children({ comboboxState })}</TypeaheadComboboxV2Menu>\n    </TypeaheadComboboxV2Root>\n  );\n}\n\nexport interface RHFControlledMultiSelectTypeaheadComboboxV2Props<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n>\n  extends\n    Omit<\n      TypeaheadComboboxV2RootProps<TFieldValues>,\n      OmittedOriginalProps | 'comboboxState' | 'componentId' | 'children'\n    >,\n    UseControllerProps<TFieldValues, TName>,\n    AnalyticsEventValueChangeNoPiiFlagProps<DesignSystemEventProviderAnalyticsEventTypes.OnValueChange> {\n  control: Control<any, TFieldValues>;\n  // Required override because the full array is the field value, but TName implies a scalar property.\n  name: any;\n  children: (renderProps: {\n    comboboxState: ComboboxStateValue<TFieldValues>;\n    selectedItems: TFieldValues[];\n  }) => React.ReactNode;\n  validationState?: ValidationState;\n  allItems: TFieldValues[];\n  itemToString: (item: TFieldValues) => string;\n  matcher?: (item: TFieldValues, query: string) => boolean;\n  getKey?: (item: TFieldValues) => Key;\n  inputProps?: Partial<\n    Omit<\n      TypeaheadComboboxV2MultiSelectInputProps<TFieldValues>,\n      'selectedItems' | 'setSelectedItems' | 'getSelectedItemLabel'\n    >\n  >;\n  menuProps?: Partial<TypeaheadComboboxV2MenuProps>;\n  onInputChange?: (inputValue: string) => void;\n}\n\nexport function RHFControlledMultiSelectTypeaheadComboboxV2<TFieldValues extends FieldValues>({\n  name,\n  control,\n  rules,\n  allItems,\n  itemToString,\n  matcher,\n  getKey,\n  children,\n  validationState,\n  inputProps,\n  menuProps,\n  onInputChange,\n  componentId,\n  analyticsEvents,\n  valueHasNoPii,\n  ...props\n}: RHFControlledMultiSelectTypeaheadComboboxV2Props<TFieldValues> &\n  Omit<HTMLAttributes<HTMLDivElement>, 'children'>): JSX.Element {\n  const { field } = useController({\n    name,\n    control,\n    rules,\n  });\n\n  // The array field value IS the selection — drive it straight from RHF, no local mirror. `getKey`\n  // must be stable across renders (react-aria keys options by it) so memoize on field.value identity.\n  const selectedItems = React.useMemo<TFieldValues[]>(() => field.value ?? [], [field.value]);\n  const selectedItemsRef = useRef(selectedItems);\n  selectedItemsRef.current = selectedItems;\n\n  // The hook always calls this with a concrete array on a selection commit, but the setter type also\n  // permits an updater function — resolve it against the latest selection so both shapes are correct.\n  const setSelectedItems = useCallback<React.Dispatch<React.SetStateAction<TFieldValues[]>>>(\n    (next) => {\n      const resolved = typeof next === 'function' ? next(selectedItemsRef.current) : next;\n      field.onChange(resolved);\n    },\n    [field],\n  );\n\n  const comboboxState = useComboboxStateV2<TFieldValues>({\n    allItems,\n    itemToString,\n    getKey,\n    matcher,\n    multiSelect: true,\n    // Multi-select drives the form through selectedItems/setSelectedItems (above), not the single-select\n    // form bridge: formValue/formOnChange/formOnBlur are single-value props, and passing the array field\n    // value as formValue would feed itemToString an array (breaking the input filter).\n    selectedItems,\n    setSelectedItems,\n    componentId,\n    analyticsEvents,\n    valueHasNoPii,\n    onStateChange: onInputChange\n      ? (change) => {\n          if (change.type === 'input') {\n            onInputChange(change.inputValue);\n          }\n        }\n      : undefined,\n  });\n\n  return (\n    <TypeaheadComboboxV2Root {...props} comboboxState={comboboxState}>\n      <TypeaheadComboboxV2MultiSelectInput\n        {...inputProps}\n        selectedItems={selectedItems}\n        setSelectedItems={setSelectedItems}\n        getSelectedItemLabel={itemToString}\n        validationState={validationState}\n        ref={field.ref}\n      />\n      <TypeaheadComboboxV2Menu {...menuProps}>\n        {children({\n          comboboxState,\n          selectedItems,\n        })}\n      </TypeaheadComboboxV2Menu>\n    </TypeaheadComboboxV2Root>\n  );\n}\n"],"names":["RHFControlledTypeaheadComboboxV2","name","control","rules","allItems","itemToString","matcher","getKey","allowNewValue","children","validationState","inputProps","menuProps","onInputChange","componentId","analyticsEvents","valueHasNoPii","preventUnsetOnBlur","props","field","useController","comboboxState","useComboboxStateV2","formValue","value","formOnChange","onChange","formOnBlur","onBlur","onStateChange","change","type","inputValue","undefined","_jsxs","TypeaheadComboboxV2Root","_jsx","TypeaheadComboboxV2Input","ref","TypeaheadComboboxV2Menu","RHFControlledMultiSelectTypeaheadComboboxV2","selectedItems","React","useMemo","selectedItemsRef","useRef","current","setSelectedItems","useCallback","next","resolved","multiSelect","TypeaheadComboboxV2MultiSelectInput","getSelectedItemLabel"],"mappings":"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"}
+{"version":3,"file":"RHFControlledTypeaheadComboboxV2-nSSYj16I.js","sources":["../src/design-system/FormV2/RHFControlledTypeaheadComboboxV2.tsx"],"sourcesContent":["import type { Key } from '@react-types/shared';\nimport type { HTMLAttributes } from 'react';\nimport React, { useCallback, useRef } from 'react';\nimport type { Control, FieldPath, FieldValues, UseControllerProps } from 'react-hook-form';\nimport { useController } from 'react-hook-form';\n\nimport type { DesignSystemEventProviderAnalyticsEventTypes } from '../DesignSystemEventProvider';\nimport {\n  TypeaheadComboboxInput as TypeaheadComboboxV2Input,\n  TypeaheadComboboxMenu as TypeaheadComboboxV2Menu,\n  TypeaheadComboboxMultiSelectInput as TypeaheadComboboxV2MultiSelectInput,\n  TypeaheadComboboxRoot as TypeaheadComboboxV2Root,\n  useComboboxState as useComboboxStateV2,\n} from '../TypeaheadComboboxV2';\nimport type { TypeaheadComboboxInputProps as TypeaheadComboboxV2InputProps } from '../TypeaheadComboboxV2/TypeaheadComboboxInput';\nimport type { TypeaheadComboboxMenuProps as TypeaheadComboboxV2MenuProps } from '../TypeaheadComboboxV2/TypeaheadComboboxMenu';\nimport type { TypeaheadComboboxMultiSelectInputProps as TypeaheadComboboxV2MultiSelectInputProps } from '../TypeaheadComboboxV2/TypeaheadComboboxMultiSelectInput';\nimport type { TypeaheadComboboxRootProps as TypeaheadComboboxV2RootProps } from '../TypeaheadComboboxV2/TypeaheadComboboxRoot';\nimport type { ComboboxStateValue } from '../TypeaheadComboboxV2/hooks/useComboboxState';\nimport type { AnalyticsEventValueChangeNoPiiFlagProps, ValidationState } from '../types';\n\n// This file holds the react-aria TypeaheadComboboxV2 RHF adapters, split out of RHFAdapters.tsx so the\n// (broadly imported) RHFControlledComponents barrel does not statically pull the react-aria combobox\n// subtree into the common chunk. RHFAdapters.tsx React.lazy-imports these, so the ~175KB subtree only\n// loads on pages that actually render a V2 typeahead.\n\n// These props are omitted, as `useController` handles them. (Mirrors RHFAdapters.tsx.)\ntype OmittedOriginalProps = 'name' | 'onChange' | 'onBlur' | 'value' | 'defaultValue' | 'checked';\n\nexport interface RHFControlledTypeaheadComboboxV2Props<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n>\n  extends\n    Omit<\n      TypeaheadComboboxV2RootProps<TFieldValues[TName]>,\n      OmittedOriginalProps | 'comboboxState' | 'componentId' | 'children'\n    >,\n    UseControllerProps<TFieldValues, TName>,\n    AnalyticsEventValueChangeNoPiiFlagProps<DesignSystemEventProviderAnalyticsEventTypes.OnValueChange> {\n  control: Control<TFieldValues, any>;\n  name: TName;\n  // The react-aria hook owns filtering, so children render `comboboxState.filteredItems` rather than\n  // receiving a consumer-maintained `items` list (the key API change from the legacy adapter).\n  children: (renderProps: { comboboxState: ComboboxStateValue<Required<TFieldValues>[TName]> }) => React.ReactNode;\n  validationState?: ValidationState;\n  allItems: Required<TFieldValues>[TName][];\n  itemToString: (item: Required<TFieldValues>[TName]) => string;\n  matcher?: (item: Required<TFieldValues>[TName], query: string) => boolean;\n  getKey?: (item: Required<TFieldValues>[TName]) => Key;\n  /* Whether to allow the input value to not match any options in the list. For this to work, the item type (T) must be a string.\n   * Defaults to false.\n   */\n  allowNewValue?: boolean;\n  inputProps?: Partial<Omit<TypeaheadComboboxV2InputProps, 'componentId'>>;\n  menuProps?: Partial<TypeaheadComboboxV2MenuProps>;\n  onInputChange?: (inputValue: string) => void;\n  /** @deprecated No-op under react-aria; accepted for source-compat while migrating off the legacy adapter. */\n  preventUnsetOnBlur?: boolean;\n}\n\nexport function RHFControlledTypeaheadComboboxV2<\n  TFieldValues extends FieldValues,\n  TName extends FieldPath<TFieldValues>,\n>({\n  name,\n  control,\n  rules,\n  allItems,\n  itemToString,\n  matcher,\n  getKey,\n  allowNewValue,\n  children,\n  validationState,\n  inputProps,\n  menuProps,\n  onInputChange,\n  componentId,\n  analyticsEvents,\n  valueHasNoPii,\n  preventUnsetOnBlur,\n  ...props\n}: RHFControlledTypeaheadComboboxV2Props<TFieldValues, TName> &\n  Omit<HTMLAttributes<HTMLDivElement>, 'children'>): JSX.Element {\n  const { field } = useController<TFieldValues, TName>({\n    name,\n    control,\n    rules,\n  });\n\n  const comboboxState = useComboboxStateV2({\n    allItems,\n    itemToString,\n    getKey,\n    matcher,\n    allowNewValue,\n    formValue: field.value,\n    formOnChange: field.onChange,\n    formOnBlur: field.onBlur,\n    componentId,\n    analyticsEvents,\n    valueHasNoPii,\n    preventUnsetOnBlur,\n    // react-aria owns the input value; surface changes through the 'input' state event so the legacy\n    // `onInputChange` contract keeps working without making the input value a controlled prop.\n    onStateChange: onInputChange\n      ? (change) => {\n          if (change.type === 'input') {\n            onInputChange(change.inputValue);\n          }\n        }\n      : undefined,\n  });\n\n  return (\n    <TypeaheadComboboxV2Root {...props} comboboxState={comboboxState}>\n      <TypeaheadComboboxV2Input {...inputProps} validationState={validationState} ref={field.ref} />\n      <TypeaheadComboboxV2Menu {...menuProps}>{children({ comboboxState })}</TypeaheadComboboxV2Menu>\n    </TypeaheadComboboxV2Root>\n  );\n}\n\nexport interface RHFControlledMultiSelectTypeaheadComboboxV2Props<\n  TFieldValues extends FieldValues = FieldValues,\n  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>,\n>\n  extends\n    Omit<\n      TypeaheadComboboxV2RootProps<TFieldValues>,\n      OmittedOriginalProps | 'comboboxState' | 'componentId' | 'children'\n    >,\n    UseControllerProps<TFieldValues, TName>,\n    AnalyticsEventValueChangeNoPiiFlagProps<DesignSystemEventProviderAnalyticsEventTypes.OnValueChange> {\n  control: Control<any, TFieldValues>;\n  // Required override because the full array is the field value, but TName implies a scalar property.\n  name: any;\n  children: (renderProps: {\n    comboboxState: ComboboxStateValue<TFieldValues>;\n    selectedItems: TFieldValues[];\n  }) => React.ReactNode;\n  validationState?: ValidationState;\n  allItems: TFieldValues[];\n  itemToString: (item: TFieldValues) => string;\n  matcher?: (item: TFieldValues, query: string) => boolean;\n  getKey?: (item: TFieldValues) => Key;\n  inputProps?: Partial<\n    Omit<\n      TypeaheadComboboxV2MultiSelectInputProps<TFieldValues>,\n      'selectedItems' | 'setSelectedItems' | 'getSelectedItemLabel'\n    >\n  >;\n  menuProps?: Partial<TypeaheadComboboxV2MenuProps>;\n  onInputChange?: (inputValue: string) => void;\n}\n\nexport function RHFControlledMultiSelectTypeaheadComboboxV2<TFieldValues extends FieldValues>({\n  name,\n  control,\n  rules,\n  allItems,\n  itemToString,\n  matcher,\n  getKey,\n  children,\n  validationState,\n  inputProps,\n  menuProps,\n  onInputChange,\n  componentId,\n  analyticsEvents,\n  valueHasNoPii,\n  ...props\n}: RHFControlledMultiSelectTypeaheadComboboxV2Props<TFieldValues> &\n  Omit<HTMLAttributes<HTMLDivElement>, 'children'>): JSX.Element {\n  const { field } = useController({\n    name,\n    control,\n    rules,\n  });\n\n  // The array field value IS the selection — drive it straight from RHF, no local mirror. `getKey`\n  // must be stable across renders (react-aria keys options by it) so memoize on field.value identity.\n  const selectedItems = React.useMemo<TFieldValues[]>(() => field.value ?? [], [field.value]);\n  const selectedItemsRef = useRef(selectedItems);\n  selectedItemsRef.current = selectedItems;\n\n  // The hook always calls this with a concrete array on a selection commit, but the setter type also\n  // permits an updater function — resolve it against the latest selection so both shapes are correct.\n  const setSelectedItems = useCallback<React.Dispatch<React.SetStateAction<TFieldValues[]>>>(\n    (next) => {\n      const resolved = typeof next === 'function' ? next(selectedItemsRef.current) : next;\n      field.onChange(resolved);\n    },\n    [field],\n  );\n\n  const comboboxState = useComboboxStateV2<TFieldValues>({\n    allItems,\n    itemToString,\n    getKey,\n    matcher,\n    multiSelect: true,\n    // Multi-select drives the form through selectedItems/setSelectedItems (above), not the single-select\n    // form bridge: formValue/formOnChange/formOnBlur are single-value props, and passing the array field\n    // value as formValue would feed itemToString an array (breaking the input filter).\n    selectedItems,\n    setSelectedItems,\n    componentId,\n    analyticsEvents,\n    valueHasNoPii,\n    onStateChange: onInputChange\n      ? (change) => {\n          if (change.type === 'input') {\n            onInputChange(change.inputValue);\n          }\n        }\n      : undefined,\n  });\n\n  return (\n    <TypeaheadComboboxV2Root {...props} comboboxState={comboboxState}>\n      <TypeaheadComboboxV2MultiSelectInput\n        {...inputProps}\n        selectedItems={selectedItems}\n        setSelectedItems={setSelectedItems}\n        getSelectedItemLabel={itemToString}\n        validationState={validationState}\n        ref={field.ref}\n      />\n      <TypeaheadComboboxV2Menu {...menuProps}>\n        {children({\n          comboboxState,\n          selectedItems,\n        })}\n      </TypeaheadComboboxV2Menu>\n    </TypeaheadComboboxV2Root>\n  );\n}\n"],"names":["RHFControlledTypeaheadComboboxV2","name","control","rules","allItems","itemToString","matcher","getKey","allowNewValue","children","validationState","inputProps","menuProps","onInputChange","componentId","analyticsEvents","valueHasNoPii","preventUnsetOnBlur","props","field","useController","comboboxState","useComboboxStateV2","formValue","value","formOnChange","onChange","formOnBlur","onBlur","onStateChange","change","type","inputValue","undefined","_jsxs","TypeaheadComboboxV2Root","_jsx","TypeaheadComboboxV2Input","ref","TypeaheadComboboxV2Menu","RHFControlledMultiSelectTypeaheadComboboxV2","selectedItems","React","useMemo","selectedItemsRef","useRef","current","setSelectedItems","useCallback","next","resolved","multiSelect","TypeaheadComboboxV2MultiSelectInput","getSelectedItemLabel"],"mappings":"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"}