Repository navigation
Description
Goal
Make the agentic component library trustworthy for beta and production adoption:
reviewed native contracts, enforced coverage and accessibility evidence,
consumer-visible readiness, and a dependency-ordered catalog.
Status - 2026-11-09
In progress: 16 direct sub-issues, 4 completed and 12 open.
Repository reconciliation against main at
666e3298393be3156d01c3772a5cda0fd390b705.
The package exports 24 higher-order components and 5 public primitives.
The 24 reviewed implemented local contracts comprise 23 admitted Flex catalog
components plus the local-foundation Text contract.
The #4273 generation backlog has 32 children: 5 completed and 27 open.
Popover #4236, Menu #4232, MenuButton #4231, and Dropdown #4224 were delivered
and exported by merged #4386; this reconciliation closes their stale generation
issues. TabList #4243 was already complete. These closures are not beta or
production-readiness certifications.
Delivered since the previous summary
- Pivot agentic component specs and align implementations #4296 delivered source-backed React Native contracts and fork-safe integrity checks.
- focus-zone: start of fabric implementations for both macos and windows #4199 completed the original Fabric FocusZone delivery (Components: Complete the Fabric FocusZone for macOS and Windows #4217); Consolidate Callout and FocusZone into native-core #4354 and
Modernize native-core desktop primitives and track remaining qualification #4381 consolidated and modernized native-core. Remaining native obligations
have their own issues below. - Add Popover, Menu, MenuButton, and Dropdown for macOS, Windows, and Win32 #4386 delivered the four popup components, bounded Menu submenus, disabled
discoverability, shared popup controllers, and constrained Office Win32 adapters.
Its native story evidence covers macOS Fabric/Paper, Windows Fabric, and Win32.
VoiceOver, Narrator, complete visual qualification, and Office Apple runtime
were explicitly not established. - Agentic Button: expose visible labels and toggle state #4403-Agentic Text: extend contract regression coverage #4424 expanded component contract coverage and repaired native labels,
selection, and indicator semantics. This is not a shared accessibility registry
or a readiness model. - Desktop testing: declare and select WDIO cases by input lane, platform and scope #4464/Desktop testing: migrate stories and split CI input lanes #4466 introduced declarative
desktopItrequirements, input lanes,
platform exclusions, unsupported outcomes, and issue-linked quarantine.
Accessible-only CI is not physical keyboard/focus qualification.
Direct work items
| Status | Issue | Current outcome or remaining work |
|---|---|---|
| Open | #4214 Accessibility conformance | Per-component assertions improved; typed applicability/exception registry, shared runner, structured report, and onboarding gate remain. |
| Open, partial | #4215 Button / ToggleButton | Button retains caller-owned selected presentation and now exposes checked/Toggle semantics. Reconcile deferred source dispositions and review the distinct self-toggling ToggleButton contract. |
| Open, partial | #4216 Component tests | Contract checks, stories, export equality, and broad runtime/type coverage exist. Finish coverage enforcement/exemptions, missing Button type tests, and platform qualification policy. |
| Done | #4217 Fabric FocusZone | Original delivery completed; do not reopen it for the separately tracked #4374/#4376 gates. |
| Done | #4250 Primitive boundary | Public unstyled primitives and native-core ownership are defined. |
| Open | #4251 Readiness model | No consumer-visible evidence-backed readiness ladder/assessment is delivered. implemented and reviewed are contract lifecycle, not readiness. |
| Done | #4252 Spec patterns | Pinned, source-backed native contracts and local validation delivered. |
| Open | #4273 Missing components | 5 of 32 generation issues complete; 27 remain. Recompute dependencies against the delivered popup stack. |
| Done | #4291 Callout inconsistencies | Original platform fixes delivered; extended qualification remains #4375. |
| Open | #4373 Win32 Button release | Intervening-key onPressOut regression remains explicitly quarantined on Win32. |
| Open | #4374 FocusZone qualification | In-flight races, lifecycle/focus-result, inactive-window, field-editor, and assistive-technology evidence remain. |
| Open, partial | #4375 Callout qualification | New popup and entry-focus behavior is delivered; DPI/RTL/scroll geometry, resource cycles, and accessibility/visual matrix remain. |
| Open, partial | #4377 Popup transactions/restoration | Bounded families, disabled-focusable rows, and Tab dismissal are delivered. Natural bidirectional owner-relative continuation and complete race/restoration policy are not. |
| Open | #4378 Text-fragment anchors | Materialized View/rect/point support is not a renderer-owned text-layout provider. |
| Open | #4379 Modal scope | Nonmodal Callout/FocusZone do not provide background accessibility isolation and arbitrary-child modal containment. |
| Open | #4383 Context-menu opening | Trigger-based Menu is delivered; secondary click, keyboard/AT context invocation, and all-host point anchoring remain. |
Beta exit criteria
- Pinned provenance, reviewed local native contracts, and fork-safe integrity checks.
- Public component, primitive, and native package boundaries are explicit.
- Original Fabric FocusZone and the first popup component delivery are merged.
- Every public component and primitive meets the enforced coverage contract (Components: Component tests for the agentic component library #4216).
- Shared static accessibility conformance covers the complete export inventory (Components: Accessibility conformance suite #4214).
- Every item has consumer-visible readiness backed by current evidence (Components: Component readiness model and initial assessment #4251).
- Button/ToggleButton follow-through and the remaining catalog decisions are complete.
- Every beta-marked item has qualified target-platform input, focus, semantics,
screen-reader, and visual evidence, with exclusions and limitations visible.
Production exit criteria
- Approved catalog entries are production-ready or explicitly declined.
- Readiness promotion is gated and cannot outrun evidence.
- Native action invocation, speech, visual states, lifecycle, and host admission
are qualified on the declared desktop endpoints. - Legacy replacements have migration guidance and package dispositions.
- Renderer fixes reach consumers through upstream or explicit consuming-host
integration; this repository's RNmacOS patch is not installed by publishing components.
Sequencing and boundaries
- Start contract review for unblocked catalog items; do not wait on completed
Components: Complete the Fabric FocusZone for macOS and Windows #4217/Components: Spec patterns: ingestion from the canonical catalog and repeatable generation #4252 or describe the delivered popup stack as absent. - ToggleButton Components: Generate Toggle Button #4247 owns controlled/uncontrolled state transitions; Button
continues to present externally suppliedselected. - Modal Dialog/Drawer depend on Components: Provide modal focus scope and background accessibility isolation #4379, not merely a working Popover.
- Context menus and inline text anchors remain Components: Add context-menu opening and point anchors for Menu #4383 and Components: Add renderer-owned text-fragment anchors and layout-generation tracking #4378.
- Keep Win32 host additions in Win32: Track popup-host continuation, lifecycle, and accessibility capabilities #4384 and native-core root/peer/publishing admission
in Infrastructure: Qualify native-core Win32 capabilities, peer floors, publishing, and root admission #4376 under Infrastructure workstream #4275. Existing/win32adapters do not imply unrestricted
native-core root admission. - Readiness depends on Components: Accessibility conformance suite #4214/Components: Component tests for the agentic component library #4216 and infrastructure Infrastructure workstream #4275/Infrastructure: Desktop driver improvements for workload hosting, lifecycle, and agent orchestration #4435; theming is Theming Workstream #4276.
Evidence and validation limits
- Public exports
and export agreement test - Contract inventory
- Component remaining work
- Native-core remaining work
- Current tests and input-lane policy
The committed report's 52 candidate entries are a dated drift snapshot, not
a fresh upstream inventory; 49 entries remain admitted. This reconciliation
inspected source, committed tests, merged evidence, and live issue relationships.
Package/build/native tests were not run. Historical pass counts remain
revision-specific, and skipped, unsupported, or excluded cases are not passes.
Historical workstream scope and acceptance (retained; the reconciled status above is current)
Goal
Make packages/agentic/components trustworthy for beta adoption and eventually
production use. A consumer should be able to tell which components are ready,
every component should follow the same React Native contract and test model, and
the remaining Fluent catalog should be delivered in dependency order with real
macOS and Windows evidence.
Status
In progress. Three of nine direct work items are closed; six remain open.
PR #4296
completed the spec-system foundation and a substantial implementation-alignment
pass:
- Replaced copied web-oriented source specs with independently authored React
Native contracts backed by a pinned Flex Marketplace release, immutable x3
provenance, source locks, local contract validation, and authenticated drift
reporting. This closes #4252. - Added
TabListwith controlled and uncontrolled selection, roving focus,
orientation-aware keyboard navigation, disabled-item skipping, and native set
metadata. There are now 19 reviewed local component contracts. - Fixed ten component-local defects and four shared or parent-infrastructure
gaps, including focus modality and phase-locked shared animation behavior. - Preserved repaired divergence IDs as resolved history. Ten reviewed
divergences remain deferred: four need platform or interaction validation and
six need separately reviewed public API decisions. - Passed the complete uncached repository graph after merging current
main
(165 Lage tasks).
The FURN-only primitive boundary
(#4250) and
Callout platform inconsistencies
(#4291) are
also closed.
What is left
- Define and publish the component readiness model and initial assessment
(#4251). - Finish the uniform component-test contract and accessibility conformance
registry (#4216,
#4214). - Resolve Button versus ToggleButton API ownership before generating
ToggleButton (#4215). - Complete Fabric FocusZone for macOS and React Native Windows while
preserving Win32 Paper behavior
(#4217). - Reconcile the missing-component catalog with the pinned 49-component release,
the current 52-entry candidate catalog, and the newly implemented TabList,
then deliver the remaining waves
(#4273). - Record real macOS and React Native Windows Fabric keyboard, focus, and
screen-reader evidence for every component promoted to beta.
Work items
| Status | Issue | Outcome or remaining work |
|---|---|---|
| Open | #4214 - Accessibility conformance suite | Add the typed applicability registry and shared conformance runner across exported components. |
| Open | #4215 - Button and ToggleButton alignment | Decide selected state, shape, icon placement, and ownership of toggle behavior. |
| Open | #4216 - Component tests | Define and enforce uniform type, behavior, snapshot, and platform coverage. |
| Open | #4217 - Fabric FocusZone | Complete macOS and Windows Fabric support and preserve the Win32 Paper path. |
| Done | #4250 - Primitive boundary | FURN-only primitive ownership and publication boundary settled. |
| Open | #4251 - Readiness model | Persist objective readiness levels and prevent promotion above available evidence. |
| Done | #4252 - Spec patterns | Plugin-first React Native contract workflow merged in PR #4296. |
| Open | #4273 - Missing components | Refresh the rollup and deliver the remaining catalog in dependency order. |
| Done | #4291 - Callout platform inconsistencies | Platform inconsistency work completed. |
Beta exit criteria
- The component contract source is pinned, provenance is recorded, and
fork-safe validation plus authenticated drift reporting are available. - All currently implemented components have reviewed local React Native
contracts, usage guidance, and explicit web divergences. - Every exported primitive has an explicit ownership and contract policy.
- Every exported component and primitive satisfies one enforced test
coverage contract on the supported test platforms. - Every exported higher-order component passes the shared accessibility
conformance suite. - Every exported component carries a consumer-visible readiness level
computed from objective evidence. - Button and ToggleButton have non-overlapping approved contracts.
- FocusZone works on macOS Fabric and React Native Windows Fabric, and its
Win32 Paper coverage remains green. - The refreshed wave 1 and wave 2 catalog is implemented at beta readiness
or has an evidence-backed blocker. - Every beta-marked component has documented macOS and React Native Windows
Fabric validation.
Production exit criteria
- Every component in the approved catalog is production-ready or explicitly
declined with rationale. - Readiness is CI-gated so a component cannot be marked above its evidence.
- Keyboard, focus, and screen-reader behavior is validated on every
supported desktop endpoint. - Local contract integrity fails CI; authorized source drift is reviewed
against the immutable pin without requiring private source access in
public or fork CI. - Every replacement for a legacy component has migration guidance and an
explicit legacy-package disposition.
Agent context
Contract authority
Use this order of authority:
- The pinned Flex Marketplace payload is the exact authoring input.
- The pinned x3 commit provides immutable design lineage.
- The reviewed local React Native
SPEC.mdis authoritative for FURN behavior,
usage, accessibility, and intentional web divergence. - Mutable Marketplace or x3 HEAD is candidate drift for review, not an
automatic contract update.
The merged source lock uses Marketplace commit
206c4996205b027f4d806ac4ac7366f1f0ab0d5a and x3 commit
334d3b82a08b610b0002fe922ce9b4dac4db64f2. Public and fork CI validate
committed contract metadata without reading private sources; authorized
maintainers run source refresh and candidate-drift discovery.
Remaining reviewed divergences
Platform or interaction validation is still required for Input whole-field
hover/focus treatment, ProgressBar determinate animation, and Switch keyboard
activation. Separately reviewed API decisions remain for Avatar and Skeleton
focusability, Checkbox-owned native props, Button/ToggleButton separation,
Button icon positions, and Divider sizing.
Dependencies and sequencing
- Readiness depends on the enforced component-test and accessibility evidence.
- ToggleButton depends on the Button contract decision.
- Focus-orchestrated components depend on FocusZone or an explicitly approved
component-owned navigation model. - Overlay components should establish Popover, anchoring, light-dismiss, and
focus-trap foundations before dependent menus, dialogs, tooltips, and
teaching surfaces. - Platform readiness depends on the desktop-driver and Storybook work in
#4275. - Component styling depends on the unified theme contract tracked by
#4276.
Merged evidence
- PR #4296 - Pivot agentic component specs and align implementations
- PR #4295 - Add appearance-aware Flex theme sources
- PR #4294 - Infrastructure: land the public desktop driver
packages/agentic/components/SPEC-SOURCE.mdpackages/agentic/components/SPEC-MIGRATION.mdpackages/agentic/components/spec-source-lock.jsonpackages/agentic/components/scripts/spec-contracts/
Activity
JasonVMo commentedon Oct 16, 2026
The remaining native-core modernization work is now tracked as direct sub-issues: #4374 (FocusZone request/lifetime qualification), #4375 (Callout geometry, resources, and assistive technology), #4377 (popup-family transactions, owner-relative Tab/restoration, and disabled MenuItem discoverability), #4378 (renderer-owned text fragments), and #4379 (modal focus/accessibility isolation). Existing Menu #4232, Popover #4236, Dialog #4222, and Drawer #4223 remain their component delivery owners. #4373 remains open for the Win32 Button press-out regression; its one failing authored case is being quarantined only on Win32, not treated as fixed. Infrastructure admission/publishing and real-module gates are #4376/#4380 under #4275. Each new issue retains native evidence limits and acceptance criteria from the retiring modernization handoff.
JasonVMo commentedon Oct 17, 2026
Blocked popup-prerequisite handoff — October 16, 2026
Pushed commit 54887b3 on
user/jasonvmo/menu-popover.menu-popover-plan.mdsection 12 contains the complete per-platform handoff and exact validation matrix.Delivered independently usable prerequisites: Framework Base/MenuItem disabled-focusable targets with activation refusal and exactly-once release cleanup; Input's outline/underline focus-visible treatment; modern Callout first/last focus, observed dismissal causes, and duplicate/late-event fences. The changed native command is wired through generated Windows bindings and both macOS adapters.
/legacystays stable.Not delivered: Popover #4236, Menu #4232, MenuButton #4231, and Dropdown #4224 remain unimplemented/unexported behind P0/P1 and the remaining native family/continuation/semantics work. No component issue is closed or declared release-ready. Reviewed R1-R3 are applied; #4384 is the consolidated Win32 host follow-up, including the approved Tab close-and-return interim.
Executed evidence
yarn workspace @fluentui-react-native/framework-base test: passed 205 tests, 6 snapshots.yarn workspace @fluentui-react-native/components test: passed 484 tests, 8 snapshots, contract checks and strict story types.yarn workspace @fluentui-react-native/native-core test: passed 18 ownership/entrypoint checks plus 37 Jest tests, 1 snapshot, build and story types.codegen:windows --check,yarn build,yarn check-agent-instructions, andyarn change:check: passed.STORYBOOK_SMOKE_STORY='native-modern-callout--*', tagstory): 176 stories rendered; 3 cases passed, 8 input-dependent cases skipped.STORYBOOK_SMOKE_STORY='components-*--*focus*', tagstory): each 2 passed / 16 skipped; Win32 rendered 154 stories. New MenuItem native menuitem/disabled semantics passed on both endpoints. Physical navigation, activation, Input focus treatment, and Callout entry focus remain unqualified because the runtime did not advertise the required input capabilities. Helper doctor readiness was not treated as permission to bypass that gate.yarn clean-lage-cachethenyarn lage buildci: failed on 11 Knip findings in untouched workspaces; no unrelated dependencies were removed or ignored.yarn lage testthen completed 37 tasks but hit two Storybook worker deadlines; both affected contracts passed the bounded--runInBand --testNamePattern "representative desktop story tests|executes isolated inline code"retry. The aggregate is not reported as green.Next platform actions
macOS native, Office integration, actual UIA/AX actions and speech/visual matrices were not run. All owned Metro/channel/driver listeners were shut down after smoke.