Add nine agentic components and shared policies

.changeset/olive-jars-visit.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the NavItem component: a pressable navigation row with density and nesting rhythm, externally driven selection and category disclosure, a collapsed icon rail mode, and trailing content and action regions.

.changeset/olive-labels-name.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the agentic Label component for naming an associated form control.

.changeset/plain-links-navigate.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the agentic Link component with functional and content type sets, inline and standalone layouts, an optional trailing icon, and platform navigation through React Native Linking.

.changeset/popover-agentic-component.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the agentic Popover component: a trigger paired with a native floating surface built on Callout, with owned open state, tokenized surface styling, and documented per-platform limits.

.changeset/shared-components-align.md

@@ -0,0 +1,7 @@
+---
+"@fluentui-react-native/components": patch
+"@fluentui-react-native/design": patch
+"@fluentui-react-native/framework-base": patch
+---
+
+Share component accessibility, interaction, warning, and numeric style policies, and migrate component semantics to the ARIA-aligned `role` prop.

.changeset/smooth-queries-clear.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the agentic SearchBox component: an Input-backed query field with a leading search icon, a clear button that appears only while a query is present, and search, clear, disabled, and read-only semantics.

.changeset/steady-surfaces-center.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": patch
+---
+
+Keep Popover and Tooltip surfaces readable when native callouts measure unconstrained text, and keep Input and SearchBox text vertically centered after clearing a focused value.

.changeset/tidy-moons-delete.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the DestructiveButton component for irreversible and high-consequence actions, with primary and subtle danger appearances, three sizes, rounded and circle shapes, and a leading or trailing icon slot.

.changeset/tidy-pears-gather.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the agentic AvatarGroup component with spread and stack layouts, size-scaled geometry, and an optional `+N` overflow indicator.

.changeset/tidy-tags-interact.md

@@ -0,0 +1,5 @@
+---
+'@fluentui-react-native/components': minor
+---
+
+Add the agentic InteractionTag component with independently pressable primary and dismiss regions, exclusive leading icon or avatar content, and per-region focus visuals.

.changeset/tooltip-agentic-component.md

@@ -0,0 +1,5 @@
+---
+"@fluentui-react-native/components": minor
+---
+
+Add the agentic Tooltip component: a trigger paired with a short descriptive label that is revealed on pointer entry after a delay and on keyboard focus, built on the reviewed Popover pipeline with owned visibility, trigger description semantics, tokenized label styling, and documented per-platform limits.

.github/skills/agentic-component-authoring/references/state-and-accessibility.md

@@ -101,14 +101,20 @@ accessibilityState: {
 
 The component must own its role and state semantics while preserving unrelated consumer values such as `busy`.
 
-- Set the native role explicitly.
+- Set native semantics with React Native's ARIA-aligned `role` prop, not the legacy `accessibilityRole`. Use ARIA names
+  such as `img` and `heading`, not legacy names such as `image` and `header`.
+- Omit both `role` and `accessibilityRole` from public native props when the component owns the role. If a caller owns
+  the semantic choice, expose only `role`.
 - Keep disabled state, focusability, and interaction behavior consistent.
 - Prefer a consumer-provided `accessible` or `focusable` value only when it does not violate the component contract.
+  Disabled state is authoritative: resolve focusability with the shared component interaction helper so
+  `focusable={true}` cannot keep a disabled control in the focus order.
 - Add selected or checked semantics only when the corresponding behavior is enabled.
 - Use action-oriented accessible names for icon-only controls.
 
-Button warns in development when an icon-only instance lacks an `accessibilityLabel`. Put warnings in an effect so
-render remains free of observable side effects, and make the dependency list match every value used by the warning.
+Button warns in development when an icon-only instance lacks an `accessibilityLabel`. Use `useDevWarning` from
+`@fluentui-react-native/framework-base` for conditional usage warnings so render remains free of observable side
+effects and repeated renders do not emit duplicate messages.
 
 ## Use framework interaction and slot hooks
 

.github/skills/agentic-component-authoring/references/styles-and-tokens.md

@@ -97,7 +97,8 @@ Destructure only the token groups needed by a factory:
 ```
 
 Validate token values when their generated type is wider than the React Native style property. Button validates its gap
-token before assigning it to `ViewStyle['gap']`.
+token before assigning it to `ViewStyle['gap']`. Use `getNumericStyleValueAsNumber` when the target property requires a
+number; it centralizes validation and numeric-string coercion instead of repeating `Number(getNumericStyleValue(...))`.
 
 ## Apply slot props in one stage
 

.github/skills/agentic-component-authoring/references/tests-and-stories.md

@@ -12,6 +12,7 @@ Use `@testing-library/react-native`. Do not import `react-test-renderer` directl
 Prefer public semantics:
 
 - query the root by accessibility role
+- assert the ARIA-aligned `role` prop rather than the legacy `accessibilityRole`
 - use matchers such as `toBeDisabled()`
 - assert `accessibilityState`, accessible names, and focusability
 - use async `fireEvent` calls for hover, press, focus, and user handlers

.github/skills/agentic-component-contract-authoring/references/sources/flex-x3.md

@@ -35,7 +35,7 @@ Translate web concepts deliberately:
 
 | Flex evidence                        | React Native contract                                                              |
 | ------------------------------------ | ---------------------------------------------------------------------------------- |
-| ARIA attributes or native elements   | `accessibilityRole`, `accessibilityState`, labels, and UIA/AX expectations         |
+| ARIA attributes or native elements   | ARIA-aligned `role`, `accessibilityState`, labels, and UIA/AX expectations         |
 | CSS pseudo-classes                   | explicit interaction state and precedence                                          |
 | browser focus selectors and outlines | persistent `FocusVisual`; never conditional `outline*` or RNW native focus visuals |
 | CSS pixel or layout rules            | React Native units, minimum targets, and platform behavior                         |

packages/agentic/components/AGENTS.md

@@ -37,6 +37,9 @@ invariants; detailed authoring recipes live in the
 - Use `src/components/button` as the canonical higher-order implementation and `src/primitives/icon` as the canonical
   primitive.
 - Keep public props and slots small, typed, and spec-driven.
+- Express native semantics with React Native's ARIA-aligned `role` prop, not the legacy `accessibilityRole`. When a
+  component owns its semantics, omit both props from its public native surface; expose only `role` when callers own the
+  semantic choice.
 - This package targets React 19.1.4 or newer. Expose a stable native root ref through the `ref` prop, receive it as part
   of the component props, and forward it to the declared root slot. Do not use `forwardRef`.
 - Export higher-order components and public types explicitly from `src/index.ts`; export primitives and their public types

packages/agentic/components/package.json

@@ -87,12 +87,7 @@
     }
   },
   "furn": {
-    "jestPlatform": "macos",
-    "knip": {
-      "ignoreDependencies": [
-        "@fluentui-react-native/callout"
-      ]
-    }
+    "jestPlatform": "macos"
   },
   "rnx-kit": {
     "kitType": "library",