Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

chore(eslint): report provenance in source comments, with a baseline of current sites (#9516)

Cindy Zhang12610cb7fdd1
diff --git a/eslint.config.js b/eslint.config.js
index 8828404355..cd49431d24 100644
--- a/eslint.config.js
+++ b/eslint.config.js
@@ -13,6 +13,7 @@ import {scope as internalBarrelScope} from './internal/eslint-plugin-astryx/no-i
import {scope as nullishGuardScope} from './internal/eslint-plugin-astryx/no-nullish-jsx-guard.js';
import {scope as truthyGuardScope} from './internal/eslint-plugin-astryx/no-truthy-jsx-guard.js';
import {scope as privateAttributeScope} from './internal/eslint-plugin-astryx/no-raw-private-attribute.js';
+import {scope as commentProvenanceScope} from './internal/eslint-plugin-astryx/no-comment-provenance.js';
/* global process */
@@ -74,6 +75,20 @@ const privateAttributeBaseline = JSON.parse(
),
);
+// Record ids, claim ids, pull request and issue references, date stamps, and
+// quote blocks in source comments that predate
+// `@astryx/no-comment-provenance`, by repo-relative file, once per site. The
+// list only shrinks.
+const commentProvenanceBaseline = JSON.parse(
+ readFileSync(
+ path.join(
+ import.meta.dirname,
+ 'internal/eslint-plugin-astryx/no-comment-provenance.baseline.json',
+ ),
+ 'utf8',
+ ),
+);
+
// The internal plugin is plain untyped JS (kept out of the lint/type surface),
// so its inferred shape doesn't satisfy ESLint's strict `Plugin` type. One
// localized assertion here keeps every `plugins` entry below type-checked.
@@ -985,6 +1000,26 @@ export default defineConfig(
],
},
},
+ // A source comment explains a reason, a constraint, or a quirk. It does not
+ // cite a record, a claim, a pull request, an issue, or a date, and it does
+ // not quote requirement text: the record links the code, and
+ // `pnpm specs:for <path>` finds it. The sites that predate this block are
+ // listed in the baseline, once per site, and that many stay allowed until
+ // they are removed; one more is reported (an error in strict mode, so a pull
+ // request that adds one fails lint, while main stays green).
+ {
+ files: commentProvenanceScope.files,
+ ignores: commentProvenanceScope.ignores,
+ plugins: {
+ '@astryx': astryxEslintPlugin,
+ },
+ rules: {
+ '@astryx/no-comment-provenance': [
+ reactSeverity,
+ {baseline: commentProvenanceBaseline, root: import.meta.dirname},
+ ],
+ },
+ },
// richtext — the pre-existing backlog, held at `warn` while it is worked
// off. Must come last so it overrides the blocks above.
//
diff --git a/internal/eslint-plugin-astryx/README.md b/internal/eslint-plugin-astryx/README.md
index 7d9d76f27a..08690d811f 100644
--- a/internal/eslint-plugin-astryx/README.md
+++ b/internal/eslint-plugin-astryx/README.md
@@ -262,6 +262,58 @@ site, and never add one.
`node internal/eslint-plugin-astryx/no-raw-private-attribute.baseline.mjs`
rewrites the list from the source (`--check` verifies it).
+### `@astryx/no-comment-provenance`
+
+Reports provenance in source comments. A comment explains only what the code
+cannot show: a reason, a constraint, an invariant, or a platform quirk. The
+record links the code, so `pnpm specs:for <path>` finds it; a citation in a
+comment goes stale and duplicates that link. The "Source comments" rule in
+`docs/architecture/knowledge-contracts.md` is the authority.
+
+```ts
+// flagged
+// Matches spec:AST-108 FR4 and component:Button (#9428).
+// Decided 2026-10-31; true as of Oct 2026.
+// The panel MUST close when focus leaves it.
+
+// fine
+// Safari fires blur before click, so the close waits a frame.
+```
+
+It finds four kinds of text, in comments only, never in strings:
+
+- record ids (`spec:AST-108`, `component:Button`, `module:Icon/registry`,
+ `architecture:…`, `family:…`, `design:…`, `theme:…`, a bare `AST-094`) and
+ claim ids with a known prefix (`FR12`, `INV3`, `DEC-4`, `AR2`, `DR1`, …);
+- pull request and issue references: `#1234`, `PR #77`, `issue 12`, and GitHub
+ pull request, issue, discussion, and commit URLs. A bare `#123` with 3, 6, or
+ 8 digits can be a hex colour, so it is not reported;
+- date stamps: an ISO date outside quotes (`2026-10-31`) and `as of Oct 2026`;
+- quote blocks: a comment block with `MUST` or `SHALL` in capitals, or a block
+ of more than six prose lines that also cites a record or a claim. The block
+ is reported once, as `spec quote`, beside its citations.
+
+Every comment is checked, public JSDoc, Effect notes, and file headers
+included. Only the lines a tool reads and code samples are skipped: lint,
+TypeScript, and other tool directives (with their `--` reasons); `@pr-a11y`
+routing lines and `SYNC:` blocks, with their continuation lines; the copyright
+line; and `@example` sections and fenced code. Adjacent line comments in one
+column are one block.
+
+When a citation is the file's only link to a record or a claim, link the file
+from a record first, then remove the citation: the source-comments rule says
+which field to use. A claim citation that `pnpm check:knowledge` cannot resolve
+yet stays in the baseline until it can.
+
+The repo config turns it on for `packages/*/src`, outside tests, stories and
+test helpers, at the strict-mode severity (an error in CI). Sites that existed
+when the rule arrived are listed by file in
+`no-comment-provenance.baseline.json`, once per site, and that many stay
+allowed until they are removed; remove an entry when you remove its site, and
+never add one.
+`node internal/eslint-plugin-astryx/no-comment-provenance.baseline.mjs`
+rewrites the list from the source (`--check` verifies it).
+
### `@astryx/no-core-internal-import`
Reports imports of Core's internal subpaths (`@astryxdesign/core/internal` and
diff --git a/internal/eslint-plugin-astryx/index.js b/internal/eslint-plugin-astryx/index.js
index df86c5e6ea..addd1befb4 100644
--- a/internal/eslint-plugin-astryx/index.js
+++ b/internal/eslint-plugin-astryx/index.js
@@ -25,6 +25,7 @@
* - no-core-internal-import: Keeps Core's internal subpaths (@astryxdesign/core/internal/*) inside Core and Lab
* - no-internal-barrel-import: Flags a package-internal relative import that resolves to a folder's index (a barrel) instead of the defining module
* - no-raw-private-attribute: Flags a private data-astryx-* attribute written by hand outside its owner module in packages/<package>/src/privateAttributes (INV23 lists the public ones)
+ * - no-comment-provenance: Flags record and claim ids, pull request and issue references, date stamps, and quoted MUST/SHALL text in source comments (the record links the code; `pnpm specs:for <path>` finds it)
* - no-raw-color: Flags a raw colour value (hex, rgb(), hsl(), oklch(), …) anywhere in component source, including inside light-dark()/color-mix(), behind a const, in a template literal, or as a var() fallback — the shapes no-hardcoded-styles cannot see
*
* Philosophy: Strict for agents (CI), lenient for humans (local dev)
@@ -44,6 +45,7 @@ import noHardcodedAnchorRule from './no-hardcoded-anchor.js';
import noRawParagraphRule from './no-raw-paragraph.js';
import noNullishJsxGuardRule from './no-nullish-jsx-guard.js';
import noTruthyJsxGuardRule from './no-truthy-jsx-guard.js';
+import noCommentProvenanceRule from './no-comment-provenance.js';
import noRawIntlLocaleRule from './no-raw-intl-locale.js';
import noUnguardedImeKeydownRule from './no-unguarded-ime-keydown.js';
import noBorderShorthandRule from './no-border-shorthand.js';
@@ -374,6 +376,7 @@ const plugin = {
'no-light-dark-outside-theme': noLightDarkOutsideThemeRule,
'no-raw-color': noRawColorRule,
'no-raw-private-attribute': noRawPrivateAttributeRule,
+ 'no-comment-provenance': noCommentProvenanceRule,
},
configs: {},
};
diff --git a/internal/eslint-plugin-astryx/no-comment-provenance.baseline.json b/internal/eslint-plugin-astryx/no-comment-provenance.baseline.json
new file mode 100644
index 0000000000..f926d7d2c0
--- /dev/null
+++ b/internal/eslint-plugin-astryx/no-comment-provenance.baseline.json
@@ -0,0 +1,2947 @@
+{
+ "packages/charts/src/getChartColors.ts": ["#3739"],
+ "packages/core/src/AppShell/AppShell.tsx": [
+ "#5701",
+ "#5701",
+ "AST-025",
+ "AST-027",
+ "DR2",
+ "DR2",
+ "FR12",
+ "FR17",
+ "FR18",
+ "FR18",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR6",
+ "FR8",
+ "FR8",
+ "component:AppShell",
+ "component:Layout",
+ "component:SideNav",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote",
+ "spec:AST-105"
+ ],
+ "packages/core/src/AppShell/observeMainOverflow.ts": [
+ "FR12",
+ "FR4",
+ "component:AppShell",
+ "spec quote",
+ "spec:AST-025"
+ ],
+ "packages/core/src/Avatar/Avatar.tsx": ["OQ-4"],
+ "packages/core/src/Badge/Badge.tsx": [
+ "#5585",
+ "FR1",
+ "INV11",
+ "INV11",
+ "INV11",
+ "INV11",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "component:Badge",
+ "spec quote"
+ ],
+ "packages/core/src/Banner/Banner.tsx": [
+ "#4166",
+ "#4166",
+ "FR3",
+ "FR3",
+ "INV11",
+ "INV11",
+ "INV11",
+ "INV11",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens"
+ ],
+ "packages/core/src/BottomSheet/BottomSheet.tsx": [
+ "AST-013",
+ "AST-027",
+ "FR13"
+ ],
+ "packages/core/src/BottomSheet/BottomSheetPanel.tsx": [
+ "FR13",
+ "spec:AST-013"
+ ],
+ "packages/core/src/BottomSheet/BottomSheetSwitcher.tsx": ["AST-013", "FR13"],
+ "packages/core/src/BottomSheet/BottomSheetSwitcherContext.ts": [
+ "FR13",
+ "spec:AST-013"
+ ],
+ "packages/core/src/BottomSheet/bottomSheetStack.ts": [
+ "DEP-0015",
+ "spec quote"
+ ],
+ "packages/core/src/Breadcrumbs/BreadcrumbItem.tsx": [
+ "FR1",
+ "FR5",
+ "INV1",
+ "architecture:interaction-modality",
+ "family:action-groups"
+ ],
+ "packages/core/src/Button/Button.tsx": [
+ "#2508",
+ "#2717",
+ "#4879",
+ "FR3",
+ "FR3",
+ "INV11",
+ "architecture:theme-tokens",
+ "spec quote",
+ "spec:AST-086"
+ ],
+ "packages/core/src/ButtonGroup/ButtonGroup.tsx": ["#2508"],
+ "packages/core/src/Calendar/Calendar.tsx": [
+ "#2715",
+ "#2715",
+ "FR1",
+ "FR1",
+ "FR2",
+ "FR5",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Calendar/dayCellUtils.ts": ["#2715", "#2715"],
+ "packages/core/src/Calendar/hooks/useCalendarNavigation.ts": ["FR1"],
+ "packages/core/src/Carousel/Carousel.tsx": [
+ "2026-08-27",
+ "AST-025",
+ "FR12",
+ "FR12",
+ "FR2",
+ "FR2",
+ "component:Carousel",
+ "spec quote",
+ "spec:AST-025"
+ ],
+ "packages/core/src/Chat/ChatComposer.tsx": [
+ "#2072",
+ "FR11",
+ "FR11",
+ "FR11",
+ "FR2",
+ "FR5",
+ "FR6",
+ "INV10",
+ "INV11",
+ "INV11",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "component:HoverCard",
+ "component:Tooltip",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Chat/ChatComposerDrawer.tsx": ["#1182", "#2072"],
+ "packages/core/src/Chat/ChatComposerInput.tsx": ["FR1", "spec:AST-056"],
+ "packages/core/src/Chat/ChatLayout.tsx": ["#2573", "#2573"],
+ "packages/core/src/Chat/ChatLayoutScrollButton.tsx": [
+ "INV4",
+ "architecture:component-theming-surface",
+ "spec quote"
+ ],
+ "packages/core/src/Chat/ChatMessageBubble.tsx": ["#2072", "#2574"],
+ "packages/core/src/Chat/ChatMessageList.tsx": ["FR4", "FR8", "spec:AST-086"],
+ "packages/core/src/Chat/ChatSystemMessage.tsx": [
+ "FR4",
+ "spec quote",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Chat/useTriggerMenu.tsx": [
+ "#4681",
+ "#6077",
+ "FR10",
+ "FR10",
+ "FR11",
+ "FR16",
+ "FR6",
+ "FR7",
+ "FR8",
+ "FR8",
+ "component:ChatComposerInput",
+ "component:ChatComposerInput",
+ "spec quote",
+ "spec quote",
+ "spec:AST-086"
+ ],
+ "packages/core/src/CheckboxInput/CheckboxInput.tsx": [
+ "FR1",
+ "FR2",
+ "FR3",
+ "FR8",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/CheckboxList/CheckboxListContext.tsx": ["FR1", "FR9"],
+ "packages/core/src/CheckboxList/CheckboxListItem.tsx": [
+ "FR9",
+ "spec quote",
+ "spec:AST-002/DEC-1"
+ ],
+ "packages/core/src/ClickableCard/ClickableCard.tsx": [
+ "FR1",
+ "FR1",
+ "FR2",
+ "spec:AST-085"
+ ],
+ "packages/core/src/CodeBlock/CodeBlock.tsx": [
+ "AST-025",
+ "DR4",
+ "FR12",
+ "FR13",
+ "FR13",
+ "FR13",
+ "design:bidirectionality"
+ ],
+ "packages/core/src/CodeBlock/tokenizer.ts": ["FR12", "FR13"],
+ "packages/core/src/Collapsible/Collapsible.tsx": [
+ "AR4",
+ "FR1",
+ "FR2",
+ "FR4",
+ "INV12",
+ "architecture:react-component-runtime",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105"
+ ],
+ "packages/core/src/CommandPalette/CommandPalette.tsx": [
+ "#6077",
+ "#6077",
+ "#6077",
+ "FR1",
+ "FR2",
+ "FR3",
+ "FR8",
+ "FR8",
+ "component:CommandPalette",
+ "component:CommandPaletteEmpty",
+ "spec quote",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/core/src/CommandPalette/CommandPaletteEmpty.tsx": ["FR3"],
+ "packages/core/src/CommandPalette/CommandPaletteInput.tsx": [
+ "AR2",
+ "AST-056",
+ "FR3",
+ "FR8",
+ "FR8",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/core/src/CommandPalette/CommandPaletteItem.tsx": ["#6077"],
+ "packages/core/src/CommandPalette/busyStartSettle.ts": [
+ "FR8",
+ "spec quote",
+ "spec:AST-086"
+ ],
+ "packages/core/src/ComplexSelector/ComplexSelector.tsx": [
+ "DR1",
+ "DR3",
+ "FR1",
+ "FR10",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR6",
+ "FR8",
+ "FR8",
+ "INV3",
+ "architecture:interaction-modality",
+ "design:reduced-motion",
+ "family:input-fields",
+ "family:input-fields",
+ "spec:AST-059",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/DateInput/DateInput.tsx": [
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR3",
+ "FR4",
+ "FR5",
+ "FR6",
+ "FR8",
+ "family:buttons",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/DateInput/NativeDateField.tsx": [
+ "FR1",
+ "FR4",
+ "FR6",
+ "FR8",
+ "family:buttons",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/DateInput/TouchDateField.tsx": [
+ "FR1",
+ "FR4",
+ "FR6",
+ "FR8",
+ "family:buttons",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/DateInput/Wheel.tsx": [
+ "FR4",
+ "module:DropdownMenu/useMenuPress"
+ ],
+ "packages/core/src/DateRangeInput/DateRangeInput.tsx": [
+ "AR3",
+ "FR1",
+ "FR1",
+ "FR2",
+ "FR8",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/DateTimeInput/DateTimeInput.tsx": [
+ "#2727",
+ "#2727",
+ "#6077",
+ "AST-085",
+ "AST-085",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR12",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR3",
+ "FR3",
+ "FR5",
+ "FR8",
+ "architecture:layer-runtime",
+ "component:BaseTypeahead",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-086"
+ ],
+ "packages/core/src/DateTimeInput/NativeDateSegment.tsx": [
+ "FR10",
+ "family:input-fields"
+ ],
+ "packages/core/src/DateTimeInput/NativeTimeSegment.tsx": [
+ "FR10",
+ "family:input-fields"
+ ],
+ "packages/core/src/DateTimeInput/TouchDateTimeField.tsx": [
+ "FR8",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Dialog/Dialog.tsx": [
+ "DR1",
+ "DR2",
+ "DR2",
+ "DR3",
+ "DR4",
+ "FR13",
+ "FR13",
+ "FR8",
+ "INV1",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote",
+ "spec:AST-013",
+ "spec:AST-013"
+ ],
+ "packages/core/src/Drawer/Drawer.tsx": [
+ "#5305",
+ "FR13",
+ "FR13",
+ "FR17",
+ "spec:AST-013",
+ "spec:AST-013"
+ ],
+ "packages/core/src/DropdownMenu/DropdownMenu.tsx": [
+ "#4477",
+ "#4477",
+ "#5976",
+ "#5976",
+ "#6893",
+ "FR2",
+ "FR3",
+ "FR7",
+ "FR7",
+ "INV1",
+ "architecture:interaction-modality",
+ "component:DropdownMenu/DEC-1",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059"
+ ],
+ "packages/core/src/DropdownMenu/DropdownMenuContext.tsx": ["#6893"],
+ "packages/core/src/DropdownMenu/DropdownMenuSubMenu.tsx": [
+ "#3121",
+ "#6893",
+ "FR8",
+ "spec:AST-059",
+ "spec:AST-086"
+ ],
+ "packages/core/src/DropdownMenu/MenuBottomSheet.tsx": [
+ "INV7",
+ "architecture:component-style-authoring"
+ ],
+ "packages/core/src/DropdownMenu/lazyMenuBottomSheet.ts": [
+ "FR9",
+ "spec quote",
+ "spec:AST-013"
+ ],
+ "packages/core/src/DropdownMenu/menuItemHover.ts": [
+ "INV1",
+ "architecture:interaction-modality",
+ "spec quote"
+ ],
+ "packages/core/src/DropdownMenu/menuWidth.ts": ["FR7", "spec:AST-059"],
+ "packages/core/src/DropdownMenu/useMenuDrillIn.tsx": ["FR9", "spec:AST-012"],
+ "packages/core/src/EmptyState/EmptyState.tsx": ["FR2", "spec:AST-086"],
+ "packages/core/src/Field/Field.tsx": ["#5689", "AST-027"],
+ "packages/core/src/Field/fieldParts.ts": [
+ "FR10",
+ "FR10",
+ "family:input-fields",
+ "spec quote"
+ ],
+ "packages/core/src/Field/fieldStatusPlacement.ts": [
+ "DEC-2",
+ "FR7",
+ "component:FieldStatus",
+ "spec quote"
+ ],
+ "packages/core/src/Field/inputDisabledFocus.ts": ["FR6", "spec:AST-085"],
+ "packages/core/src/Field/inputStyles.stylex.ts": ["FR1", "spec:AST-020"],
+ "packages/core/src/FieldStatus/FieldStatus.tsx": [
+ "FR3",
+ "FR7",
+ "FR7",
+ "INV11",
+ "architecture:theme-tokens",
+ "component:FieldStatus",
+ "component:FieldStatus",
+ "spec quote"
+ ],
+ "packages/core/src/FieldStatus/index.ts": ["FR7", "component:FieldStatus"],
+ "packages/core/src/FileInput/FileInput.tsx": [
+ "FR1",
+ "FR10",
+ "FR2",
+ "FR3",
+ "FR5",
+ "FR6",
+ "FR6",
+ "FR6",
+ "FR8",
+ "FR8",
+ "family:input-fields",
+ "spec quote",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/HoverCard/HoverCard.tsx": ["#5049", "#5049"],
+ "packages/core/src/HoverCard/useHoverCard.tsx": ["FR11"],
+ "packages/core/src/Icon/Icon.tsx": ["ORD1", "spec quote"],
+ "packages/core/src/Indicator/CheckIndicator.tsx": ["#4838", "#4893"],
+ "packages/core/src/Indicator/indicatorRegistry.ts": ["#4712"],
+ "packages/core/src/Indicator/types.ts": ["#4831", "#4918"],
+ "packages/core/src/InputGroup/groupStyles.ts": ["FR3", "spec quote"],
+ "packages/core/src/Item/Item.tsx": [
+ "FR11",
+ "FR11",
+ "FR2",
+ "FR4",
+ "component:HoverCard",
+ "component:Tooltip",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Item/ItemDescriptionContext.tsx": [
+ "spec quote",
+ "spec:AST-002/DEC-1"
+ ],
+ "packages/core/src/Item/ItemSwipeLayer.tsx": [
+ "AST-057",
+ "FR1",
+ "FR2",
+ "FR2",
+ "INV11",
+ "architecture:theme-tokens",
+ "spec quote",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Layer/LayerProvider.tsx": ["FR6", "spec:AST-059"],
+ "packages/core/src/Layer/clampInlineSize.ts": ["FR7", "spec:AST-059"],
+ "packages/core/src/Layer/layerAnimations.stylex.ts": [
+ "DR2",
+ "DR2",
+ "DR3",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote"
+ ],
+ "packages/core/src/Layer/layerInset.ts": [
+ "FR6",
+ "spec quote",
+ "spec:AST-059"
+ ],
+ "packages/core/src/Layer/layerScopedContext.tsx": ["AST-038"],
+ "packages/core/src/Layer/layerSlideRules.ts": [
+ "FR3",
+ "FR4",
+ "FR4",
+ "FR4",
+ "spec quote",
+ "spec quote",
+ "spec:AST-059",
+ "spec:AST-059"
+ ],
+ "packages/core/src/Layer/layerStructureReset.stylex.ts": [
+ "AST-038",
+ "AST-038",
+ "FR2",
+ "FR3",
+ "FR7",
+ "spec quote"
+ ],
+ "packages/core/src/Layer/layerSurfacePress.ts": [
+ "FR11",
+ "FR11",
+ "component:HoverCard",
+ "component:Tooltip",
+ "spec quote"
+ ],
+ "packages/core/src/Layer/layerTextReset.stylex.ts": ["AST-038"],
+ "packages/core/src/Layer/layerViewportInset.stylex.ts": [
+ "FR1",
+ "FR7",
+ "spec quote",
+ "spec:AST-059"
+ ],
+ "packages/core/src/Layer/modalOutlet.ts": [
+ "FR18",
+ "spec quote",
+ "spec:AST-003"
+ ],
+ "packages/core/src/Layer/preserveAnimations.ts": [
+ "FR4",
+ "spec quote",
+ "spec:AST-059"
+ ],
+ "packages/core/src/Layer/useLayer.tsx": [
+ "#3389",
+ "#3671",
+ "#4803",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR3",
+ "FR3",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR5",
+ "FR5",
+ "FR5",
+ "FR6",
+ "FR6",
+ "FR8",
+ "FR8",
+ "FR8",
+ "INV12",
+ "INV6",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059"
+ ],
+ "packages/core/src/Layout/layoutReset.ts": [
+ "FR18",
+ "FR8",
+ "component:AppShell",
+ "component:Layout",
+ "spec quote"
+ ],
+ "packages/core/src/Layout/padding.stylex.ts": ["#5208"],
+ "packages/core/src/Link/Link.tsx": [
+ "FR1",
+ "FR1",
+ "FR2",
+ "FR4",
+ "FR5",
+ "FR6",
+ "INV5",
+ "component:Link",
+ "component:Text",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/List/List.tsx": ["FR29", "spec:AST-017"],
+ "packages/core/src/List/ListContext.tsx": ["DEC-6", "spec:AST-061"],
+ "packages/core/src/List/ListItem.tsx": ["FR11", "spec:AST-061"],
+ "packages/core/src/Markdown/Markdown.fr23.bench.ts": [
+ "AST-036",
+ "FR23",
+ "spec quote",
+ "spec:AST-036"
+ ],
+ "packages/core/src/Markdown/Markdown.fr23.sampling.ts": ["FR23"],
+ "packages/core/src/Markdown/Markdown.tsx": [
+ "AST-061",
+ "DEC-6",
+ "DEC-6",
+ "DEC-9",
+ "FR11",
+ "FR17",
+ "FR23",
+ "FR30",
+ "FR30",
+ "FR5",
+ "FR9",
+ "component:List",
+ "component:Markdown",
+ "component:Markdown",
+ "module:Markdown/sourceLines",
+ "spec:AST-036",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061"
+ ],
+ "packages/core/src/Markdown/characterReferences.ts": [
+ "DEC-3",
+ "DEC-5",
+ "DEC-5",
+ "FR7",
+ "spec quote",
+ "spec quote",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061"
+ ],
+ "packages/core/src/Markdown/parser.ts": [
+ "DEC-5",
+ "module:Markdown/sourceLines",
+ "spec:AST-061"
+ ],
+ "packages/core/src/Markdown/plugin-renderer/MarkdownPluginNodeRenderer.tsx": [
+ "DEC-6",
+ "FR8",
+ "spec quote",
+ "spec:AST-064"
+ ],
+ "packages/core/src/Markdown/plugins/HeadingLinksRenderer.tsx": [
+ "module:Markdown/headingLinks"
+ ],
+ "packages/core/src/Markdown/plugins/protocol.ts": [
+ "DEC-6",
+ "FR10",
+ "FR11",
+ "FR4",
+ "module:Markdown/sourceLines",
+ "module:Markdown/sourceLines",
+ "module:Markdown/sourceLines",
+ "spec quote",
+ "spec:AST-064"
+ ],
+ "packages/core/src/Markdown/plugins/semanticFence.ts": [
+ "FR14",
+ "FR5",
+ "module:Markdown/sourceLines"
+ ],
+ "packages/core/src/Markdown/plugins/sourceLines.ts": [
+ "module:Markdown/sourceLines"
+ ],
+ "packages/core/src/MobileNav/MobileNav.tsx": [
+ "#4290",
+ "#4290",
+ "#4290",
+ "#5701"
+ ],
+ "packages/core/src/MultiSelector/MultiSelector.tsx": [
+ "AR1",
+ "AR2",
+ "AR2",
+ "DEC-5",
+ "DEC-5",
+ "FR1",
+ "FR13",
+ "FR13",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR3",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR8",
+ "FR9",
+ "INV1",
+ "architecture:interaction-modality",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-011",
+ "spec:AST-011",
+ "spec:AST-056",
+ "spec:AST-058",
+ "spec:AST-058",
+ "spec:AST-058",
+ "spec:AST-058",
+ "spec:AST-058",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/core/src/MultiSelector/hooks.ts": [
+ "#6077",
+ "FR4",
+ "FR4",
+ "FR5",
+ "FR5",
+ "INV17",
+ "spec:AST-058",
+ "spec:AST-058",
+ "spec:AST-058",
+ "spec:AST-058",
+ "spec:AST-058"
+ ],
+ "packages/core/src/NavMenu/NavHeadingMenu.tsx": [
+ "FR1",
+ "family:action-groups"
+ ],
+ "packages/core/src/NavMenu/NavHeadingMenuItem.tsx": [
+ "FR1",
+ "FR2",
+ "FR4",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/NavMenu/NavMenuContext.tsx": ["FR7"],
+ "packages/core/src/NumberInput/NumberInput.tsx": [
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "architecture:react-component-runtime/INV2",
+ "spec quote",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Overlay/Overlay.tsx": [
+ "INV7",
+ "architecture:public-component-api"
+ ],
+ "packages/core/src/Pagination/Pagination.tsx": ["FR1", "spec:AST-085"],
+ "packages/core/src/Popover/Popover.tsx": [
+ "AR4",
+ "DEC-8",
+ "DEC-8",
+ "DEC-8",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR3",
+ "FR7",
+ "FR9",
+ "INV7",
+ "INV7",
+ "architecture:component-style-authoring",
+ "architecture:component-style-authoring",
+ "architecture:theme-application",
+ "component:Popover",
+ "spec quote",
+ "spec quote",
+ "spec:AST-012",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-059",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Popover/lazyPopoverBottomSheet.ts": [
+ "FR9",
+ "spec quote",
+ "spec:AST-013"
+ ],
+ "packages/core/src/PowerSearch/PowerSearch.tsx": [
+ "#4761",
+ "AR7",
+ "AR7",
+ "FR7",
+ "component:PowerSearch",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "spec:AST-059"
+ ],
+ "packages/core/src/PowerSearch/PowerSearchEditPopover.tsx": [
+ "#4761",
+ "#4761"
+ ],
+ "packages/core/src/PowerSearch/PowerSearchValueEditor.tsx": [
+ "#1103",
+ "#1106",
+ "#1106",
+ "#1107"
+ ],
+ "packages/core/src/ProgressBar/ProgressBar.tsx": [
+ "DR1",
+ "INV11",
+ "INV11",
+ "INV11",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "design:reduced-motion",
+ "spec quote"
+ ],
+ "packages/core/src/RadioList/RadioListItem.tsx": [
+ "FR2",
+ "FR5",
+ "FR6",
+ "spec:AST-085"
+ ],
+ "packages/core/src/RadioList/RadioListReasonContext.ts": [
+ "FR1",
+ "FR5",
+ "spec quote"
+ ],
+ "packages/core/src/Resizable/resizableModel.ts": ["#4790"],
+ "packages/core/src/Resizable/useResizable.ts": [
+ "#5297",
+ "#5297",
+ "AST-010",
+ "AST-010",
+ "AST-010",
+ "AST-010",
+ "FR10",
+ "FR11",
+ "FR6",
+ "FR7",
+ "FR9",
+ "component:Resizable",
+ "component:Resizable",
+ "spec quote",
+ "spec quote"
+ ],
+ "packages/core/src/SegmentedControl/SegmentedControl.tsx": [
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR7",
+ "FR7",
+ "spec:AST-085"
+ ],
+ "packages/core/src/SegmentedControl/SegmentedControlContext.ts": [
+ "FR5",
+ "spec:AST-085"
+ ],
+ "packages/core/src/SegmentedControl/SegmentedControlItem.tsx": [
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR7",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Selector/Selector.tsx": [
+ "AR1",
+ "AST-004",
+ "FR1",
+ "FR2",
+ "FR3",
+ "FR8",
+ "FR9",
+ "spec quote",
+ "spec:AST-056",
+ "spec:AST-058",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Selector/hooks.ts": [
+ "#6077",
+ "AST-075",
+ "DEC-2",
+ "FR6",
+ "OQ2",
+ "spec quote",
+ "spec quote",
+ "spec:AST-075",
+ "spec:AST-075",
+ "spec:AST-075",
+ "spec:AST-075"
+ ],
+ "packages/core/src/Selector/types.ts": ["spec quote", "spec:AST-058"],
+ "packages/core/src/Selector/useSelectorPresentation.ts": [
+ "AR3",
+ "AR4",
+ "AR4",
+ "spec:AST-055",
+ "spec:Popover",
+ "spec:Popover"
+ ],
+ "packages/core/src/SideNav/SideNav.tsx": [
+ "#4790",
+ "AR3",
+ "AR3",
+ "FR17",
+ "FR6",
+ "FR6",
+ "FR6",
+ "INV16",
+ "architecture:react-component-runtime",
+ "component:AppShell",
+ "component:SideNav",
+ "component:SideNav",
+ "spec quote",
+ "spec quote"
+ ],
+ "packages/core/src/SideNav/SideNavCollapseButton.tsx": [
+ "AR3",
+ "component:SideNav"
+ ],
+ "packages/core/src/SideNav/SideNavFocusTargetsContext.ts": [
+ "AR3",
+ "component:SideNav",
+ "spec quote"
+ ],
+ "packages/core/src/SideNav/SideNavHeading.tsx": [
+ "FR1",
+ "FR5",
+ "INV16",
+ "architecture:react-component-runtime",
+ "family:action-groups"
+ ],
+ "packages/core/src/SideNav/SideNavItem.tsx": [
+ "#3121",
+ "AR3",
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR5",
+ "component:SideNav",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/SideNav/railMotion.ts": [
+ "DEC-2",
+ "DR2",
+ "DR3",
+ "FR17",
+ "FR4",
+ "FR6",
+ "FR9",
+ "INV12",
+ "architecture:react-component-runtime",
+ "component:AppShell",
+ "component:SideNav",
+ "design:reduced-motion",
+ "spec quote",
+ "spec:AST-105"
+ ],
+ "packages/core/src/Skeleton/Skeleton.tsx": ["FR4", "spec:AST-108"],
+ "packages/core/src/Slider/Slider.tsx": [
+ "#5050",
+ "FR1",
+ "FR3",
+ "FR5",
+ "FR6",
+ "FR6",
+ "INV5",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Spinner/Spinner.tsx": [
+ "#3617",
+ "#5410",
+ "#6253",
+ "#6253",
+ "FR4",
+ "spec:AST-108"
+ ],
+ "packages/core/src/StatusDot/StatusDot.tsx": [
+ "INV11",
+ "INV11",
+ "INV11",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens"
+ ],
+ "packages/core/src/Stepper/Step.tsx": [
+ "FR1",
+ "FR4",
+ "FR5",
+ "FR5",
+ "INV11",
+ "architecture:theme-tokens",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Switch/Switch.tsx": [
+ "FR2",
+ "FR6",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/TabList/TabMenu.tsx": [
+ "FR1",
+ "FR5",
+ "family:action-groups"
+ ],
+ "packages/core/src/Table/Table.tsx": ["FR1", "FR12", "spec:AST-025"],
+ "packages/core/src/Table/plugins/columnResize/useTableColumnResize.tsx": [
+ "AR1",
+ "AR6",
+ "DEC-3",
+ "DEC-4",
+ "DEC-5",
+ "FR10",
+ "FR10",
+ "FR10",
+ "FR6",
+ "FR8",
+ "FR9",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote"
+ ],
+ "packages/core/src/Table/plugins/groupedRows/useTableGroupedRows.tsx": [
+ "#1",
+ "#1",
+ "#2",
+ "#3"
+ ],
+ "packages/core/src/Table/plugins/rowExpansion/useTableRowExpansion.tsx": [
+ "FR15",
+ "FR15",
+ "FR2",
+ "INV12",
+ "architecture:react-component-runtime",
+ "component:Table",
+ "component:Table",
+ "spec:AST-105",
+ "spec:AST-105"
+ ],
+ "packages/core/src/Table/plugins/sortable/useTableSortable.tsx": [
+ "FR15",
+ "spec:AST-020"
+ ],
+ "packages/core/src/Text/text.stylex.ts": ["FR3", "spec quote"],
+ "packages/core/src/TextArea/TextArea.tsx": [
+ "FR2",
+ "FR8",
+ "INV16",
+ "architecture:react-component-runtime",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/TextInput/TextInput.tsx": [
+ "#6082",
+ "FR2",
+ "FR8",
+ "INV16",
+ "architecture:react-component-runtime",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Thumbnail/Thumbnail.tsx": [
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR4",
+ "FR6",
+ "FR8",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/TimeInput/TimeInput.tsx": [
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR3",
+ "FR3",
+ "FR8",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-043",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/TimeInput/TouchTimeField.tsx": [
+ "DEC-3",
+ "FR2",
+ "FR8",
+ "spec:AST-043",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Timestamp/Timestamp.tsx": [
+ "FR5",
+ "FR9",
+ "component:Timestamp",
+ "component:Timestamp",
+ "spec quote"
+ ],
+ "packages/core/src/Toast/Toast.tsx": ["FR3"],
+ "packages/core/src/Toast/ToastViewport.tsx": [
+ "FR10",
+ "FR10",
+ "FR3",
+ "FR6",
+ "FR6",
+ "FR7",
+ "FR8",
+ "spec:AST-059",
+ "spec:AST-059"
+ ],
+ "packages/core/src/Toast/useToast.tsx": ["#3658"],
+ "packages/core/src/ToggleButton/ToggleButton.tsx": [
+ "FR11",
+ "FR3",
+ "FR5",
+ "INV5",
+ "family:buttons",
+ "family:buttons"
+ ],
+ "packages/core/src/ToggleButton/ToggleButtonGroup.tsx": [
+ "INV5",
+ "architecture:public-component-api"
+ ],
+ "packages/core/src/Token/Token.tsx": [
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR11",
+ "FR11",
+ "FR2",
+ "FR5",
+ "FR5",
+ "FR5",
+ "INV5",
+ "architecture:public-component-api",
+ "component:HoverCard",
+ "component:Link",
+ "component:Tooltip",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Token/TokenLink.tsx": [
+ "FR1",
+ "FR5",
+ "FR5",
+ "component:Link",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Tokenizer/Tokenizer.tsx": [
+ "#3389",
+ "AR2",
+ "AR6",
+ "AR7",
+ "DEC-3",
+ "DEC-3",
+ "DEC-3",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR10",
+ "FR10",
+ "FR10",
+ "FR13",
+ "FR13",
+ "FR13",
+ "FR14",
+ "FR14",
+ "FR15",
+ "FR16",
+ "FR16",
+ "FR17",
+ "FR18",
+ "FR4",
+ "FR5",
+ "FR5",
+ "FR7",
+ "FR8",
+ "FR9",
+ "INV13",
+ "INV13",
+ "INV3",
+ "INV6",
+ "INV7",
+ "INV7",
+ "INV7",
+ "architecture:component-style-authoring",
+ "architecture:component-style-authoring",
+ "architecture:public-component-api",
+ "architecture:react-component-runtime",
+ "architecture:react-component-runtime",
+ "architecture:react-component-runtime",
+ "component:FormLayout",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "family:input-fields",
+ "family:input-fields",
+ "family:input-fields",
+ "family:input-fields",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-020",
+ "spec:AST-020",
+ "spec:AST-056",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-092"
+ ],
+ "packages/core/src/Tokenizer/TokenizerBottomSheet.tsx": [
+ "AR6",
+ "AR6",
+ "FR1",
+ "FR11",
+ "FR14",
+ "FR14",
+ "FR14",
+ "FR14",
+ "FR14",
+ "FR14",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR2",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR21",
+ "FR21",
+ "FR21",
+ "FR22",
+ "FR24",
+ "FR24",
+ "FR3",
+ "FR4",
+ "FR4",
+ "FR7",
+ "FR7",
+ "FR8",
+ "FR9",
+ "INV10",
+ "INV2",
+ "INV2",
+ "INV3",
+ "INV7",
+ "architecture:component-style-authoring",
+ "architecture:react-component-runtime",
+ "architecture:react-component-runtime",
+ "architecture:react-component-runtime",
+ "architecture:react-component-runtime",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "family:input-fields",
+ "family:input-fields",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-056",
+ "spec:AST-058",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Tokenizer/TokenizerClearAllMessageContext.ts": [
+ "AR7",
+ "component:Tokenizer",
+ "spec quote"
+ ],
+ "packages/core/src/Tooltip/useTooltip.tsx": ["FR11", "FR4", "spec:AST-059"],
+ "packages/core/src/TopNav/TopNavHeading.tsx": [
+ "FR1",
+ "FR5",
+ "family:action-groups"
+ ],
+ "packages/core/src/TopNav/TopNavMegaMenu.tsx": [
+ "DR1",
+ "DR2",
+ "DR3",
+ "DR4",
+ "design:reduced-motion"
+ ],
+ "packages/core/src/TopNav/TopNavMegaMenuFeaturedCard.tsx": [
+ "DR4",
+ "design:bidirectionality"
+ ],
+ "packages/core/src/TopNav/TopNavMenu.tsx": ["FR1", "family:action-groups"],
+ "packages/core/src/TreeList/TreeList.tsx": [
+ "AR1",
+ "AR1",
+ "AR2",
+ "AR2",
+ "FR1",
+ "FR2",
+ "FR3",
+ "FR4",
+ "INV12",
+ "architecture:react-component-runtime",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105"
+ ],
+ "packages/core/src/TreeList/TreeListItem.tsx": [
+ "#4308",
+ "DD3",
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR4",
+ "FR7",
+ "family:navigation-destinations",
+ "spec quote",
+ "spec quote",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085"
+ ],
+ "packages/core/src/Typeahead/BaseTypeahead.tsx": [
+ "#6077",
+ "#6845",
+ "AR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR12",
+ "FR13",
+ "FR13",
+ "FR15",
+ "FR15",
+ "FR15",
+ "FR15",
+ "FR15",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR6",
+ "FR6",
+ "FR6",
+ "FR6",
+ "FR6",
+ "FR7",
+ "FR7",
+ "FR7",
+ "FR7",
+ "FR8",
+ "FR8",
+ "FR8",
+ "FR9",
+ "FR9",
+ "FR9",
+ "architecture:layer-runtime",
+ "component:BaseTypeahead",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "family:input-fields",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-056",
+ "spec:AST-056",
+ "spec:AST-058",
+ "spec:AST-059",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092",
+ "spec:AST-092"
+ ],
+ "packages/core/src/Typeahead/Typeahead.tsx": [
+ "#5560",
+ "#7038",
+ "AR2",
+ "FR1",
+ "FR1",
+ "FR10",
+ "FR5",
+ "FR7",
+ "FR8",
+ "FR9",
+ "component:FormLayout",
+ "family:input-fields",
+ "spec quote",
+ "spec:AST-020",
+ "spec:AST-056",
+ "spec:AST-085",
+ "spec:AST-086"
+ ],
+ "packages/core/src/Typeahead/committedChoicesKey.tsx": [
+ "FR13",
+ "FR15",
+ "FR4",
+ "component:Tokenizer",
+ "spec quote",
+ "spec:AST-092"
+ ],
+ "packages/core/src/Typeahead/trailingKeyDown.tsx": [
+ "FR10",
+ "family:input-fields",
+ "spec quote"
+ ],
+ "packages/core/src/Typeahead/types.ts": ["spec:AST-058", "spec:AST-092"],
+ "packages/core/src/VisuallyHidden/VisuallyHidden.tsx": [
+ "spec quote",
+ "spec:AST-017/FR28",
+ "spec:AST-017/FR53"
+ ],
+ "packages/core/src/gestures/GestureArena.ts": [
+ "FR11",
+ "FR14",
+ "FR14",
+ "FR14",
+ "FR15",
+ "FR15",
+ "FR15",
+ "FR15",
+ "FR16",
+ "FR19",
+ "FR21",
+ "FR24",
+ "INV2",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/GestureHost.ts": [
+ "DEC-18",
+ "DEC-18",
+ "DEC-21",
+ "DEC-21",
+ "DEC-21",
+ "DEC-22",
+ "DEC-22",
+ "DEC-7",
+ "DEC-8",
+ "FR10",
+ "FR10",
+ "FR11",
+ "FR11",
+ "FR11",
+ "FR17",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR21",
+ "FR21",
+ "FR21",
+ "FR21",
+ "FR21",
+ "FR21",
+ "FR21",
+ "FR21",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR24",
+ "FR28",
+ "FR28",
+ "FR28",
+ "FR30",
+ "FR41",
+ "FR41",
+ "FR41",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR43",
+ "FR5",
+ "FR5",
+ "FR59",
+ "INV13",
+ "INV13",
+ "architecture:react-component-runtime",
+ "architecture:react-component-runtime",
+ "family:action-groups",
+ "family:action-groups",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-017",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/GestureRecognizer.ts": [
+ "FR14",
+ "FR15",
+ "FR15",
+ "FR19",
+ "FR41",
+ "INV13",
+ "architecture:react-component-runtime",
+ "spec quote",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/LongPressGestureRecognizer.ts": [
+ "FR41",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/PanGestureRecognizer.ts": [
+ "AST-100",
+ "AST-100",
+ "DEC-18",
+ "FR10",
+ "FR14",
+ "FR14",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR2",
+ "FR2",
+ "FR2",
+ "INV10",
+ "architecture:interaction-modality",
+ "spec quote",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-100"
+ ],
+ "packages/core/src/gestures/PressTracker.ts": [
+ "AST-094",
+ "DEC-21",
+ "FR11",
+ "FR11",
+ "FR11",
+ "FR11",
+ "FR24",
+ "FR41",
+ "FR41",
+ "INV13",
+ "INV13",
+ "architecture:react-component-runtime",
+ "architecture:react-component-runtime",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/ScreenEdgePanGestureRecognizer.ts": [
+ "DEC-22",
+ "DEC-22",
+ "DEC-22",
+ "DR13",
+ "DR13",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR24",
+ "FR43",
+ "FR43",
+ "design:bidirectionality",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/SwipeGestureRecognizer.ts": [
+ "FR15",
+ "FR15",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/VelocityTracker.ts": [
+ "AST-100",
+ "AST-100",
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR2",
+ "INV10",
+ "architecture:interaction-modality",
+ "spec quote",
+ "spec:AST-100",
+ "spec:AST-100"
+ ],
+ "packages/core/src/gestures/fingerScroll.ts": [
+ "FR19",
+ "FR24",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/gestureSync.ts": ["INV2", "INV3", "spec quote"],
+ "packages/core/src/gestures/haptics.ts": [
+ "FR23",
+ "spec quote",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/nativeScroll.ts": ["FR11", "spec:AST-094"],
+ "packages/core/src/gestures/pageHold.ts": [
+ "FR19",
+ "FR24",
+ "FR24",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/touchAction.ts": [
+ "DEC-7",
+ "FR14",
+ "FR20",
+ "FR41",
+ "FR59",
+ "spec quote",
+ "spec:AST-017",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/touchActionRule.ts": [
+ "DEC-8",
+ "FR18",
+ "FR24",
+ "FR24",
+ "FR3",
+ "spec quote",
+ "spec:AST-080",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/types.ts": [
+ "FR24",
+ "FR41",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/useGestureRecognizer.ts": [
+ "FR24",
+ "FR43",
+ "FR43",
+ "FR5",
+ "INV2",
+ "INV3",
+ "family:action-groups",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/gestures/usePressTracker.ts": [
+ "FR24",
+ "FR43",
+ "FR43",
+ "INV2",
+ "INV2",
+ "INV3",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/hooks/AnnounceRenderedText.tsx": [
+ "FR11",
+ "spec quote",
+ "spec:AST-002",
+ "spec:AST-086"
+ ],
+ "packages/core/src/hooks/ModalAnnounceProvider.tsx": [
+ "FR14",
+ "spec quote",
+ "spec:AST-086"
+ ],
+ "packages/core/src/hooks/actionGroupTracker.ts": ["AST-094"],
+ "packages/core/src/hooks/modalAnnounce.ts": ["AST-086", "FR14"],
+ "packages/core/src/hooks/useAdaptivePresentation.ts": [
+ "FR9",
+ "FR9",
+ "INV5",
+ "architecture:react-component-runtime",
+ "spec:AST-012",
+ "spec:AST-012"
+ ],
+ "packages/core/src/hooks/useAnnounce.ts": [
+ "AST-086",
+ "AST-086",
+ "FR14",
+ "FR8"
+ ],
+ "packages/core/src/hooks/useAnnounceRenderedText.ts": [
+ "AST-002",
+ "AST-056",
+ "AST-086",
+ "spec quote",
+ "spec quote"
+ ],
+ "packages/core/src/hooks/useAttachment.ts": ["INV3"],
+ "packages/core/src/hooks/useBusyAnnouncement.ts": ["AST-086", "spec quote"],
+ "packages/core/src/hooks/useEntryAnimation.ts": [
+ "FR13",
+ "spec quote",
+ "spec:AST-013"
+ ],
+ "packages/core/src/hooks/useHotkeys.ts": ["spec quote"],
+ "packages/core/src/hooks/useIsHydrating.ts": [
+ "FR13",
+ "FR9",
+ "spec quote",
+ "spec:AST-013"
+ ],
+ "packages/core/src/hooks/useLongPress.ts": ["AST-094", "spec quote"],
+ "packages/core/src/hooks/useRenamedProp.ts": ["AST-002", "AST-017"],
+ "packages/core/src/hooks/useScrollableArea.ts": ["AST-025"],
+ "packages/core/src/hooks/useSettledOpen.ts": [
+ "FR13",
+ "spec quote",
+ "spec:AST-013"
+ ],
+ "packages/core/src/hooks/useTypeahead.ts": [
+ "INV17",
+ "architecture:internationalization",
+ "spec quote"
+ ],
+ "packages/core/src/i18n/useListFormatter.ts": [
+ "INV1a",
+ "INV8",
+ "architecture:internationalization",
+ "spec quote"
+ ],
+ "packages/core/src/internal/tokenizer-presentation.ts": [
+ "DEC-3",
+ "FR21",
+ "INV13",
+ "architecture:react-component-runtime",
+ "component:Tokenizer",
+ "spec quote",
+ "spec:AST-017"
+ ],
+ "packages/core/src/internal/touch.ts": [
+ "FR19",
+ "FR21",
+ "FR24",
+ "INV13",
+ "INV6",
+ "architecture:component-style-authoring",
+ "architecture:react-component-runtime",
+ "spec quote",
+ "spec:AST-017",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/LayoutChangeSnapshot.tsx": [
+ "FR1",
+ "INV1",
+ "INV3",
+ "architecture:react-component-runtime",
+ "spec quote",
+ "spec:AST-105"
+ ],
+ "packages/core/src/motion/animatedLayout.ts": [
+ "DEC-11",
+ "DR1",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR3",
+ "DR3",
+ "DR3",
+ "FR1",
+ "FR2",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR5",
+ "FR6",
+ "FR7",
+ "FR8",
+ "FR8",
+ "FR8",
+ "FR8",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "FR9",
+ "INV12",
+ "INV12",
+ "INV7",
+ "architecture:component-style-authoring",
+ "architecture:react-component-runtime",
+ "component:LayoutPanel",
+ "component:Resizable",
+ "component:SideNav",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105",
+ "spec:AST-105"
+ ],
+ "packages/core/src/motion/animator.ts": [
+ "AST-094",
+ "DEC-15",
+ "DEC-15",
+ "DEC-2",
+ "DEC-2",
+ "DEC-2",
+ "DEC-2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR3",
+ "DR3",
+ "DR3",
+ "DR4",
+ "DR4",
+ "DR4",
+ "FR5",
+ "FR6",
+ "FR6",
+ "FR6",
+ "INV5",
+ "architecture:react-component-runtime",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/coast.ts": [
+ "DR2",
+ "DR2",
+ "DR2",
+ "DR3",
+ "FR4",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/presentation.ts": [
+ "FR6",
+ "spec quote",
+ "spec:AST-013"
+ ],
+ "packages/core/src/motion/reducedMotion.stylex.ts": [
+ "DR2",
+ "DR3",
+ "DR4",
+ "design:reduced-motion",
+ "spec quote"
+ ],
+ "packages/core/src/motion/reducedMotion.ts": [
+ "DR2",
+ "DR2",
+ "DR3",
+ "DR4",
+ "design:reduced-motion",
+ "spec quote"
+ ],
+ "packages/core/src/motion/reducedMotionPlan.ts": [
+ "DR1",
+ "DR1",
+ "DR2",
+ "DR4",
+ "DR4",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote"
+ ],
+ "packages/core/src/motion/resolveMotion.ts": [
+ "DEC-15",
+ "DEC-15",
+ "spec quote",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/roles.ts": ["FR4", "spec quote", "spec:AST-094"],
+ "packages/core/src/motion/rubberBand.ts": [
+ "FR6",
+ "spec quote",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/transientCopy.ts": [
+ "FR8",
+ "INV7",
+ "architecture:component-style-authoring",
+ "spec quote",
+ "spec:AST-105"
+ ],
+ "packages/core/src/motion/uikit/gestures.ts": [
+ "FR2",
+ "FR2",
+ "INV10",
+ "INV10",
+ "INV6",
+ "architecture:component-style-authoring",
+ "architecture:interaction-modality",
+ "architecture:interaction-modality",
+ "spec quote",
+ "spec quote",
+ "spec:AST-100",
+ "spec:AST-100"
+ ],
+ "packages/core/src/motion/uikit/index.ts": [
+ "FR1",
+ "FR2",
+ "spec quote",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/uikit/navigation.ts": ["FR4", "spec:AST-094"],
+ "packages/core/src/motion/uikit/scroll.ts": [
+ "2026-10-06",
+ "DEC-2",
+ "DR2",
+ "DR2",
+ "DR3",
+ "FR4",
+ "INV6",
+ "architecture:component-style-authoring",
+ "design:reduced-motion",
+ "spec quote",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/uikit/springs.ts": [
+ "DR1",
+ "DR2",
+ "DR4",
+ "FR34",
+ "FR34",
+ "FR4",
+ "FR4",
+ "FR8",
+ "INV6",
+ "architecture:component-style-authoring",
+ "design:reduced-motion",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/motion/uikit/timing.ts": [
+ "2026-10-06",
+ "2026-10-06",
+ "2026-10-06",
+ "2026-10-06",
+ "2026-10-24",
+ "DEC-1",
+ "DR2",
+ "DR4",
+ "DR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "INV6",
+ "INV6",
+ "architecture:component-style-authoring",
+ "architecture:component-style-authoring",
+ "design:reduced-motion",
+ "design:reduced-motion",
+ "spec quote",
+ "spec:AST-094",
+ "spec:AST-094",
+ "spec:AST-094"
+ ],
+ "packages/core/src/privateAttributes/hapticSwitch.stylex.ts": [
+ "INV13",
+ "INV23",
+ "architecture:public-component-api",
+ "architecture:react-component-runtime",
+ "spec quote"
+ ],
+ "packages/core/src/privateAttributes/segmentDisabled.stylex.ts": [
+ "FR2",
+ "INV23",
+ "architecture:public-component-api",
+ "component:SegmentedControl",
+ "spec quote"
+ ],
+ "packages/core/src/theme/defineTheme.ts": [
+ "FR2",
+ "FR5",
+ "FR5",
+ "FR5",
+ "architecture:theme-authoring-contract",
+ "spec quote",
+ "spec quote",
+ "spec:AST-108",
+ "spec:AST-108",
+ "spec:AST-108",
+ "spec:AST-108"
+ ],
+ "packages/core/src/theme/expandRadiusScale.ts": ["#2072"],
+ "packages/core/src/theme/generateThemeRules.ts": [
+ "INV16",
+ "INV16",
+ "INV17",
+ "INV17",
+ "INV17",
+ "INV17",
+ "INV17",
+ "INV17",
+ "INV17",
+ "INV17"
+ ],
+ "packages/core/src/theme/motionKnobs.ts": [
+ "FR1",
+ "FR1",
+ "FR5",
+ "FR6",
+ "spec quote",
+ "spec:AST-108",
+ "spec:AST-108",
+ "spec:AST-108"
+ ],
+ "packages/core/src/theme/resolveThemeValues.ts": [
+ "FR2",
+ "FR2",
+ "FR4",
+ "FR4",
+ "FR5",
+ "spec:AST-108",
+ "spec:AST-108",
+ "spec:AST-108"
+ ],
+ "packages/core/src/theme/statusColor.ts": [
+ "INV11",
+ "INV17",
+ "architecture:theme-compilation",
+ "architecture:theme-tokens",
+ "spec quote"
+ ],
+ "packages/core/src/theme/statusRoleDerivation.ts": [
+ "INV17",
+ "INV17",
+ "architecture:theme-compilation",
+ "architecture:theme-compilation",
+ "spec quote"
+ ],
+ "packages/core/src/theme/syntax/SyntaxTheme.tsx": [
+ "https://github.com/meta/astryx/issues/1148"
+ ],
+ "packages/core/src/theme/syntax/defineSyntaxTheme.ts": [
+ "https://github.com/meta/astryx/issues/1148"
+ ],
+ "packages/core/src/theme/syntax/presets.ts": [
+ "https://github.com/meta/astryx/issues/1148"
+ ],
+ "packages/core/src/theme/syntax/tokens.ts": [
+ "#5386",
+ "https://github.com/meta/astryx/issues/1148"
+ ],
+ "packages/core/src/theme/themeAdaptations.ts": [
+ "FR5",
+ "FR9",
+ "FR9",
+ "FR9",
+ "spec:AST-012",
+ "spec:AST-012",
+ "spec:AST-012",
+ "spec:AST-108"
+ ],
+ "packages/core/src/theme/themeMotion.ts": [
+ "FR1",
+ "FR15",
+ "FR2",
+ "FR2",
+ "FR4",
+ "FR4",
+ "FR5",
+ "FR5",
+ "FR5",
+ "FR6",
+ "FR6",
+ "INV1",
+ "INV6",
+ "architecture:theme-tokens",
+ "architecture:theme-tokens",
+ "component:Button",
+ "spec quote",
+ "spec:AST-108"
+ ],
+ "packages/core/src/theme/tokens.stylex.ts": [
+ "#2072",
+ "FR2",
+ "INV11",
+ "architecture:theme-tokens",
+ "spec:AST-108"
+ ],
+ "packages/core/src/theme/tokens.ts": [
+ "INV16",
+ "INV17",
+ "INV6",
+ "architecture:theme-compilation",
+ "architecture:theme-tokens"
+ ],
+ "packages/core/src/utils/accessibleName.ts": [
+ "AR3",
+ "component:SideNav",
+ "spec quote"
+ ],
+ "packages/core/src/utils/clickGuard.ts": ["AST-057", "AST-094", "spec quote"],
+ "packages/core/src/utils/coarsePointer.ts": ["AST-094", "spec quote"],
+ "packages/core/src/utils/disabledInteraction.ts": [
+ "FR1",
+ "FR2",
+ "spec:AST-085"
+ ],
+ "packages/core/src/utils/hitArea.ts": [
+ "AST-094",
+ "AST-103",
+ "FR5",
+ "spec quote"
+ ],
+ "packages/core/src/utils/inputPresentation.ts": ["AST-043"],
+ "packages/core/src/utils/interactionOverlay.stylex.ts": [
+ "AST-108",
+ "spec quote"
+ ],
+ "packages/core/src/utils/plainDate.ts": [
+ "AST-067",
+ "FR1",
+ "component:Calendar"
+ ],
+ "packages/core/src/utils/presentation.ts": [
+ "AST-012",
+ "AST-017",
+ "AST-094",
+ "spec quote"
+ ],
+ "packages/core/src/utils/pressDisabled.ts": [
+ "FR23",
+ "FR5",
+ "INV13",
+ "architecture:react-component-runtime",
+ "component:Tooltip",
+ "spec quote",
+ "spec:AST-094"
+ ],
+ "packages/core/src/utils/pressFeedback.ts": [
+ "AST-012",
+ "AST-094",
+ "AST-108",
+ "spec quote"
+ ],
+ "packages/core/src/utils/primaryClick.ts": ["FR43", "spec:AST-094"],
+ "packages/core/src/utils/selectionLock.ts": [
+ "AST-017",
+ "AST-094",
+ "spec quote"
+ ],
+ "packages/core/src/utils/touchPresentation.stylex.ts": ["AST-012", "AST-094"],
+ "packages/core/src/utils/touchPresentation.ts": [
+ "AST-012",
+ "AST-012",
+ "FR9",
+ "spec quote"
+ ],
+ "packages/core/src/utils/touchQueries.ts": ["FR6", "spec:AST-013"],
+ "packages/core/src/utils/useFocusAcrossSwap.ts": [
+ "FR4",
+ "spec quote",
+ "spec:AST-085"
+ ],
+ "packages/core/src/utils/useFocusLeavingChange.ts": [
+ "AR3",
+ "AR4",
+ "component:Collapsible",
+ "component:SideNav",
+ "spec quote"
+ ],
+ "packages/lab/src/Chart/getChartColors.ts": ["#3739"],
+ "packages/lab/src/Chat/ChatTypingIndicator.tsx": [
+ "FR2",
+ "FR4",
+ "FR4",
+ "FR6",
+ "spec quote",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/lab/src/CircularProgress/CircularProgress.tsx": [
+ "INV3",
+ "spec quote"
+ ],
+ "packages/lab/src/CodeEditor/CodeEditor.tsx": [
+ "DR2",
+ "design:bidirectionality"
+ ],
+ "packages/lab/src/CommentPin/CommentPin.tsx": [
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR2",
+ "FR4",
+ "FR6",
+ "ORD4",
+ "spec:AST-085"
+ ],
+ "packages/lab/src/Comments/CommentActions.tsx": [
+ "architecture:react-component-runtime/INV2"
+ ],
+ "packages/lab/src/Comments/CommentComposer.tsx": ["AST-086", "FR6"],
+ "packages/lab/src/Comments/CommentParts.tsx": [
+ "FR1",
+ "FR2",
+ "FR2",
+ "FR3",
+ "FR4",
+ "FR4",
+ "FR5",
+ "FR6",
+ "spec:AST-085",
+ "spec:AST-086",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/lab/src/Comments/CommentRow.tsx": ["INV1"],
+ "packages/lab/src/Comments/Comments.tsx": ["FR2", "FR5", "spec:AST-086"],
+ "packages/lab/src/Comments/CommentsContext.tsx": [
+ "AST-086",
+ "FR1",
+ "FR6",
+ "INV2",
+ "INV2",
+ "INV3"
+ ],
+ "packages/lab/src/Comments/useStatusAnnouncement.ts": [
+ "FR2",
+ "FR4",
+ "FR5",
+ "FR6",
+ "spec quote",
+ "spec quote",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/lab/src/DiffViewer/DiffViewer.tsx": ["FR13", "FR3", "FR3"],
+ "packages/lab/src/InfoTip/InfoTip.tsx": ["#5168"],
+ "packages/lab/src/LogStream/LogStream.tsx": ["FR3"],
+ "packages/lab/src/MobilePowerSearch/MobilePowerSearch.tsx": [
+ "AST-086",
+ "AST-086",
+ "AST-086",
+ "AST-086",
+ "FR14",
+ "FR14",
+ "FR14",
+ "FR14",
+ "spec quote",
+ "spec quote",
+ "spec quote"
+ ],
+ "packages/lab/src/MobilePowerSearch/mobilePowerSearchUtils.ts": [
+ "FR11",
+ "FR12",
+ "component:PowerSearch"
+ ],
+ "packages/lab/src/MobileTokenizer/MobileTokenizer.tsx": [
+ "AR6",
+ "AR6",
+ "AR6",
+ "AR6",
+ "AR6",
+ "DEC-3",
+ "FR14",
+ "FR14",
+ "FR16",
+ "FR16",
+ "FR17",
+ "FR17",
+ "FR17",
+ "FR17",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR18",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR20",
+ "FR24",
+ "FR24",
+ "FR3",
+ "FR3",
+ "FR5",
+ "FR5",
+ "FR5",
+ "FR5",
+ "FR7",
+ "INV3",
+ "INV7",
+ "INV7",
+ "INV7",
+ "INV7",
+ "architecture:component-style-authoring",
+ "architecture:component-style-authoring",
+ "architecture:react-component-runtime",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "component:Tokenizer",
+ "family:input-fields",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-085",
+ "spec:AST-086",
+ "spec:AST-086"
+ ],
+ "packages/lab/src/Sankey/SankeyLabel.tsx": ["#0", "#1"],
+ "packages/lab/src/Schedule/MonthlyView.tsx": [
+ "AR7",
+ "AR7",
+ "AR8",
+ "AR8",
+ "AR8",
+ "FR17",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR19",
+ "FR20",
+ "FR20",
+ "FR20",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "spec quote"
+ ],
+ "packages/lab/src/Schedule/TimeGridView.tsx": [
+ "AR2",
+ "DEC-1",
+ "DEC-5",
+ "FR11",
+ "FR12",
+ "FR21",
+ "FR21",
+ "FR4",
+ "FR6",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "spec quote"
+ ],
+ "packages/lab/src/Schedule/dateMath.ts": ["FR21", "component:Schedule"],
+ "packages/lab/src/Schedule/monthLayout.ts": [
+ "FR15",
+ "FR16",
+ "ORD4",
+ "component:Schedule"
+ ],
+ "packages/lab/src/Schedule/shared.tsx": [
+ "AR2",
+ "FR15",
+ "FR18",
+ "FR18",
+ "FR19",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule",
+ "component:Schedule"
+ ],
+ "packages/lab/src/Schedule/useScheduleViewPopover.ts": [
+ "FR17",
+ "FR20",
+ "component:Schedule",
+ "spec quote"
+ ],
+ "packages/native/src/components/Icon.ts": ["AST-082", "FR17"],
+ "packages/native/src/components/TextInput.ts": ["family:input-fields"],
+ "packages/native/src/contract/fromComponentDoc.ts": [
+ "AST-082",
+ "AST-082",
+ "AST-082",
+ "AST-082",
+ "AST-082",
+ "FR16",
+ "FR17",
+ "FR3",
+ "FR4",
+ "FR4",
+ "FR7",
+ "FR8",
+ "spec quote"
+ ],
+ "packages/native/src/contract/generateSwift.ts": [
+ "AST-082",
+ "AST-082",
+ "FR17",
+ "FR5",
+ "spec quote"
+ ],
+ "packages/native/src/contract/generateTypeScript.ts": [
+ "AST-082",
+ "FR5",
+ "FR6"
+ ],
+ "packages/native/src/contract/names.ts": ["AST-082", "AST-082", "FR8", "FR8"],
+ "packages/native/src/contract/parseDocType.ts": ["AST-082", "FR4"],
+ "packages/native/src/contract/rules.ts": ["AST-082", "FR4", "FR8"],
+ "packages/native/src/contract/types.ts": [
+ "AST-082",
+ "AST-082",
+ "AST-082",
+ "AST-082",
+ "AST-082",
+ "FR17",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR7",
+ "FR8"
+ ],
+ "packages/native/src/icons/defaults.ts": [
+ "AST-082",
+ "DEC-10",
+ "FR17",
+ "FR17"
+ ],
+ "packages/native/src/index.ts": ["AST-082", "FR15"],
+ "packages/native/src/logic/createLogicCore.ts": [
+ "AST-082",
+ "FR12",
+ "spec quote"
+ ],
+ "packages/native/src/platforms.ts": ["AST-082", "AST-082", "FR6"],
+ "packages/native/src/theme/defineNativeTheme.ts": [
+ "AST-082",
+ "AST-082",
+ "AST-082",
+ "DEC-5",
+ "FR10",
+ "FR17",
+ "FR18",
+ "FR18",
+ "FR18"
+ ],
+ "packages/richtext/src/CodeBlockHeaderPlugin.tsx": [
+ "DEC-4",
+ "FR8",
+ "spec quote",
+ "spec:AST-061",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/CodeSyntaxPlugin.tsx": [
+ "FR1",
+ "FR30",
+ "component:Markdown",
+ "spec quote",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/MarkdownExtensionsPlugin.tsx": [
+ "FR11",
+ "FR2",
+ "FR6",
+ "FR8",
+ "FR9",
+ "spec quote",
+ "spec:AST-064"
+ ],
+ "packages/richtext/src/RichTextEditor.tsx": [
+ "#5335",
+ "spec:AST-061",
+ "spec:AST-062",
+ "spec:AST-064"
+ ],
+ "packages/richtext/src/RichTextEditorToolbar.tsx": [
+ "spec quote",
+ "spec:AST-061/DEC-8"
+ ],
+ "packages/richtext/src/RichTextView.tsx": [
+ "FR2",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-064"
+ ],
+ "packages/richtext/src/TableColumnFloorPlugin.tsx": [
+ "FR4",
+ "spec quote",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/TaskCheckboxPlugin.tsx": [
+ "FR5",
+ "spec quote",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/codeLanguages.ts": ["FR30", "component:Markdown"],
+ "packages/richtext/src/editorNodes.ts": ["spec:AST-064"],
+ "packages/richtext/src/editorTheme.ts": [
+ "DEC-6",
+ "DEC-6",
+ "DEC-9",
+ "FR2",
+ "FR2",
+ "FR4",
+ "FR4",
+ "FR5",
+ "FR6",
+ "FR9",
+ "spec quote",
+ "spec quote",
+ "spec quote",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/index.ts": ["spec quote", "spec:AST-061/DEC-8"],
+ "packages/richtext/src/markdown.ts": [
+ "FR12",
+ "FR3",
+ "spec quote",
+ "spec:AST-064"
+ ],
+ "packages/richtext/src/markdownCharacterReferences.ts": [
+ "DEC-5",
+ "FR3",
+ "FR7",
+ "FR7",
+ "FR7",
+ "spec quote",
+ "spec quote",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-062"
+ ],
+ "packages/richtext/src/markdownCodeFence.ts": [
+ "FR5",
+ "spec quote",
+ "spec:AST-061",
+ "spec:AST-062"
+ ],
+ "packages/richtext/src/markdownExtensionNode.ts": [
+ "FR10",
+ "FR11",
+ "FR7",
+ "spec quote",
+ "spec:AST-064"
+ ],
+ "packages/richtext/src/markdownExtensions.ts": [
+ "DEC-3",
+ "DEC-4",
+ "FR1",
+ "FR1",
+ "FR1",
+ "FR10",
+ "FR10",
+ "FR4",
+ "FR4",
+ "FR4",
+ "FR5",
+ "FR5",
+ "FR6",
+ "FR6",
+ "FR6",
+ "spec quote",
+ "spec:AST-064",
+ "spec:AST-064",
+ "spec:AST-064",
+ "spec:AST-064",
+ "spec:AST-064",
+ "spec:AST-064"
+ ],
+ "packages/richtext/src/markdownHardLineBreak.ts": [
+ "FR3",
+ "spec quote",
+ "spec:AST-062"
+ ],
+ "packages/richtext/src/markdownLink.ts": [
+ "FR3",
+ "spec quote",
+ "spec:AST-062"
+ ],
+ "packages/richtext/src/markdownListExport.ts": [
+ "FR3",
+ "spec quote",
+ "spec:AST-062"
+ ],
+ "packages/richtext/src/markdownListIndentation.ts": [
+ "FR5",
+ "spec quote",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/markdownOrderedList.ts": [
+ "DEC-6",
+ "DEC-6",
+ "spec quote",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/markdownSerializers.ts": ["spec:AST-064"],
+ "packages/richtext/src/markdownSource.ts": [
+ "FR2",
+ "FR3",
+ "FR3",
+ "FR5",
+ "FR5",
+ "spec quote",
+ "spec:AST-061",
+ "spec:AST-061",
+ "spec:AST-062",
+ "spec:AST-062",
+ "spec:AST-062",
+ "spec:AST-062",
+ "spec:AST-062"
+ ],
+ "packages/richtext/src/markdownTaskList.ts": [
+ "FR5",
+ "spec quote",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/markdownThematicBreak.ts": [
+ "FR5",
+ "spec quote",
+ "spec:AST-061"
+ ],
+ "packages/richtext/src/textSemantics.ts": [
+ "FR7",
+ "spec quote",
+ "spec:AST-061"
+ ]
+}
diff --git a/internal/eslint-plugin-astryx/no-comment-provenance.baseline.mjs b/internal/eslint-plugin-astryx/no-comment-provenance.baseline.mjs
new file mode 100644
index 0000000000..35e54c3790
--- /dev/null
+++ b/internal/eslint-plugin-astryx/no-comment-provenance.baseline.mjs
@@ -0,0 +1,36 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file no-comment-provenance.baseline.mjs
+ * @description Writes (or, with --check, verifies) the baseline that
+ * `@astryx/no-comment-provenance` allows: each record id, claim id, pull
+ * request or issue reference, date stamp, and quote block, per file, once per
+ * site that predates the rule. Run it after removing citations, or after
+ * merging main into a branch that changes the rule, so the list only names
+ * sites that still exist.
+ *
+ * node internal/eslint-plugin-astryx/no-comment-provenance.baseline.mjs [--check]
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import {scope} from './no-comment-provenance.js';
+import {runRuleBaseline} from './rule-baseline.mjs';
+
+const root = path.resolve(import.meta.dirname, '../..');
+
+await runRuleBaseline({
+ ruleId: '@astryx/no-comment-provenance',
+ scope,
+ targets: fs
+ .readdirSync(path.join(root, 'packages'))
+ .filter(name => fs.existsSync(path.join(root, 'packages', name, 'src')))
+ .map(name => `packages/${name}/src`),
+ baselineFile: path.join(
+ import.meta.dirname,
+ 'no-comment-provenance.baseline.json',
+ ),
+ entryFromMessage: message => /^`([^`]*)`/.exec(message)?.[1] ?? null,
+ unique: false,
+ noun: 'comment provenance sites',
+});
diff --git a/internal/eslint-plugin-astryx/no-comment-provenance.js b/internal/eslint-plugin-astryx/no-comment-provenance.js
new file mode 100644
index 0000000000..14245c8640
--- /dev/null
+++ b/internal/eslint-plugin-astryx/no-comment-provenance.js
@@ -0,0 +1,374 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file no-comment-provenance.js
+ * @description Disallow provenance in source comments: knowledge record and
+ * claim ids, pull request and issue references, date stamps, and blocks that
+ * quote requirement text.
+ *
+ * // Matches spec:AST-108 FR4 (#9428, 2026-10-31).
+ * // The panel MUST close when focus leaves it.
+ *
+ * A comment explains only what the code cannot show: a reason, a constraint,
+ * an invariant, or a platform quirk. The record links the code, so
+ * `pnpm specs:for <path>` finds it; a citation in a comment goes stale and
+ * duplicates that link. The rule reads comments only, never strings.
+ *
+ * Every comment is checked, public JSDoc and file headers included, except
+ * the lines a tool reads and code samples:
+ * - lint, TypeScript, and other tool directives;
+ * - `@pr-a11y` routing lines and `SYNC:` blocks, with their continuation
+ * lines;
+ * - the copyright line;
+ * - `@example` sections and fenced code.
+ *
+ * Options: `{baseline: {[repoRelativeFile]: string[]}, root: string}`. The
+ * baseline lists, per file, each finding once per site that predates
+ * enforcement: the cited id, reference, or date, or `spec quote` for a quote
+ * block. That many stay allowed until removed; one more is reported. A
+ * citation that is a file's only link to a record stays until a record links
+ * the file; the message says how.
+ *
+ * Known limitations:
+ * - A claim id is matched only with a known claim prefix (`FR`, `INV`,
+ * `DEC`, and the others in `CLAIM_PREFIXES`), so a one-letter claim such
+ * as `G3` is not found.
+ * - A quote block is found only by `MUST` or `SHALL` in capitals, or as a
+ * long block that cites a record. A short paraphrase is not found.
+ * - A bare `#123` with 3, 6, or 8 digits can be a hex colour, so it is not
+ * found. `PR #123` and `issue #123` are found.
+ */
+
+import {baselineAllowance} from './rule-baseline.mjs';
+
+/**
+ * Where the repository config enforces the rule: shipped source in every
+ * package. Tests, stories, and fixtures are out of scope.
+ */
+export const scope = {
+ files: ['packages/*/src/**/*.{ts,tsx,mts,cts,js,jsx,mjs}'],
+ ignores: [
+ '**/*.test.*',
+ '**/*.spec.*',
+ '**/*.stories.*',
+ '**/*.testing.*',
+ '**/*.render-testing.*',
+ '**/__tests__/**',
+ '**/__fixtures__/**',
+ '**/dist/**',
+ ],
+};
+
+/** The baseline entry of a quote block. */
+export const QUOTE_ENTRY = 'spec quote';
+
+// The record kinds that `pnpm check:knowledge` reads, as `kind:name` ids.
+const RECORD_KINDS = [
+ 'spec',
+ 'component',
+ 'module',
+ 'theme',
+ 'architecture',
+ 'family',
+ 'design',
+ 'plan',
+];
+
+// Claim prefixes that records define (`FR12`, `INV3`, `DEC-4`, ...). The id
+// grammar is the one `check:knowledge` reads: prefix, optional hyphen, number,
+// optional letter. One-letter prefixes are left out; they match too much.
+const CLAIM_PREFIXES = [
+ 'FR',
+ 'NFR',
+ 'AR',
+ 'DEC',
+ 'INV',
+ 'ORD',
+ 'OQ',
+ 'DR',
+ 'IR',
+ 'DD',
+ 'DEP',
+ 'CLN',
+];
+
+const MONTH =
+ '(?:Jan(?:uary)?|Feb(?:ruary)?|Mar(?:ch)?|Apr(?:il)?|May|June?|July?|Aug(?:ust)?|Sep(?:t(?:ember)?)?|Oct(?:ober)?|Nov(?:ember)?|Dec(?:ember)?)';
+
+/**
+ * The text of each match is its baseline entry. The order matters: a later
+ * finder does not see text that an earlier one matched, so
+ * `spec:AST-108/FR4` is one finding, not three.
+ */
+const FINDERS = [
+ {
+ kind: 'reference',
+ pattern:
+ /https?:\/\/github\.com\/[\w.-]+\/[\w.-]+\/(?:pull|issues|discussions|commit)\/\w+/g,
+ },
+ {
+ kind: 'record',
+ pattern: new RegExp(
+ `(?<![\\w-])(?:${RECORD_KINDS.join('|')}):[A-Za-z][\\w/.-]*[\\w]`,
+ 'g',
+ ),
+ },
+ {kind: 'record', pattern: /(?<![\w/#-])AST-\d+[a-z]?(?:\/[A-Z]+-?\d+)?\b/g},
+ {
+ kind: 'claim',
+ pattern: new RegExp(
+ `(?<![\\w/#-])(?:${CLAIM_PREFIXES.join('|')})-?\\d+[a-z]?\\b`,
+ 'g',
+ ),
+ },
+ {
+ kind: 'reference',
+ pattern: /\b(?:PR|[Pp]ull request|[Ii]ssue)s?\s+#?\d+\b/g,
+ },
+ {kind: 'reference', pattern: /(?<![\w&#/])#\d+\b/g, accept: isIssueNumber},
+ {
+ kind: 'date',
+ pattern:
+ /(?<![\w'"`-])(?:19|20)\d\d-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])(?![\w'"`:-])/g,
+ },
+ {
+ kind: 'date',
+ pattern: new RegExp(
+ `\\b[Aa]s of (?:${MONTH}\\.?(?:\\s+\\d{1,2})?(?:,?\\s+\\d{4})?|\\d{4})\\b`,
+ 'g',
+ ),
+ },
+];
+
+/** `#1234` is an issue number; `#000` and `#333333` are hex colours. */
+function isIssueNumber(text) {
+ const digits = text.length - 1;
+ return digits !== 3 && digits !== 6 && digits !== 8;
+}
+
+const QUOTE_KEYWORD = /\b(?:MUST|SHALL)\b/;
+
+// A block longer than this that cites a record restates the record. The
+// citation is reported, and the block is reported once more as a quote.
+const QUOTE_BLOCK_LINES = 6;
+
+const DIRECTIVE =
+ /^(?:eslint\b|eslint-|global\s|globals\s|exported\s|@ts-|\/\s*<reference|prettier-ignore|istanbul\s|c8\s|v8\s|@vitest-environment|@jsx|#__PURE__|@__PURE__|@__NO_SIDE_EFFECTS__|webpack[A-Z]|@refresh|@license|@preserve)/;
+
+// A line that a repository tool reads. Its continuation lines run to the next
+// tag, a blank line, or the end of the comment.
+const TOOL_TAG = /^(?:@pr-a11y|SYNC:)/;
+const ANY_TAG = /^@\w/;
+const COPYRIGHT = /^Copyright\b/;
+
+/** The comment's lines, each with its text and its source index. */
+function commentLines(comment) {
+ const start = comment.range[0] + 2;
+ if (comment.type === 'Line') {
+ return [{text: comment.value, index: start}];
+ }
+ const lines = [];
+ let index = start;
+ for (const text of comment.value.split('\n')) {
+ lines.push({text, index});
+ index += text.length + 1;
+ }
+ return lines;
+}
+
+/** A line's text without comment decoration (` * `). */
+function bareText(text) {
+ return text.replace(/^\s*\*?\s?/, '').trim();
+}
+
+const rule = {
+ meta: {
+ type: 'suggestion',
+ docs: {
+ description:
+ 'Disallow record ids, claim ids, pull request and issue references, date stamps, and quoted requirement text in source comments',
+ },
+ schema: [
+ {
+ type: 'object',
+ properties: {
+ baseline: {
+ type: 'object',
+ additionalProperties: {type: 'array', items: {type: 'string'}},
+ },
+ root: {type: 'string'},
+ },
+ additionalProperties: false,
+ },
+ ],
+ messages: {
+ record:
+ '`{{entry}}` cites a knowledge record. A comment explains a reason, a ' +
+ 'constraint, or a quirk; `pnpm specs:for <path>` finds the record. If ' +
+ 'this is the file’s only link to the record, add the link to a record ' +
+ 'first (the "Source comments" rule in ' +
+ 'docs/architecture/knowledge-contracts.md says how), then remove the ' +
+ 'citation.',
+ claim:
+ '`{{entry}}` cites a record claim. A comment explains a reason, a ' +
+ 'constraint, or a quirk; `pnpm specs:for <path>` finds the record. If ' +
+ 'this is the file’s only link to the claim, add a claim-scoped ' +
+ 'reference to the file’s own record first (the "Source comments" rule ' +
+ 'in docs/architecture/knowledge-contracts.md says how), then remove ' +
+ 'the citation.',
+ reference:
+ '`{{entry}}` names a pull request or an issue. History stays in ' +
+ 'version control; the comment states only the reason that holds now.',
+ date:
+ '`{{entry}}` is a date stamp. A comment states what is true now; ' +
+ 'version control records when it changed.',
+ quote:
+ '`{{entry}}`: this comment quotes requirement text (MUST or SHALL). ' +
+ 'The record holds the requirement; the comment states only the reason ' +
+ 'the code needs, in short sentences.',
+ longQuote:
+ '`{{entry}}`: this long comment cites a record and restates it. The ' +
+ 'record holds the requirement; the comment states only the reason the ' +
+ 'code needs, in short sentences.',
+ },
+ },
+ create(context) {
+ const sourceCode = context.sourceCode ?? context.getSourceCode();
+ const isAllowed = baselineAllowance(context);
+
+ function report(entry, messageId, index) {
+ if (isAllowed(entry)) {
+ return;
+ }
+ context.report({
+ loc: {
+ start: sourceCode.getLocFromIndex(index),
+ end: sourceCode.getLocFromIndex(
+ index + (entry === QUOTE_ENTRY ? 0 : entry.length),
+ ),
+ },
+ messageId,
+ data: {entry},
+ });
+ }
+
+ /**
+ * Lines a reader sees as prose: tool lines and code samples removed.
+ * `state` carries over the comments of one block, so a `// SYNC:` line
+ * keeps its continuation lines.
+ */
+ function proseLines(comment, state) {
+ const lines = [];
+ for (const line of commentLines(comment)) {
+ const text = bareText(line.text);
+ if (text.startsWith('```')) {
+ state.inFence = !state.inFence;
+ continue;
+ }
+ if (state.inFence) {
+ continue;
+ }
+ if (text === '' || ANY_TAG.test(text)) {
+ state.inToolTag = false;
+ state.inExample = false;
+ }
+ if (TOOL_TAG.test(text)) {
+ state.inToolTag = true;
+ } else if (text.startsWith('@example')) {
+ state.inExample = true;
+ }
+ if (state.inToolTag || state.inExample || COPYRIGHT.test(text)) {
+ continue;
+ }
+ lines.push(line);
+ }
+ return lines;
+ }
+
+ /** Reports the line's findings; returns whether it cites a record. */
+ function checkLine(line) {
+ let citesRecord = false;
+ const masked = [];
+ const isMasked = (start, end) =>
+ masked.some(([from, to]) => start < to && end > from);
+ for (const finder of FINDERS) {
+ for (const match of line.text.matchAll(finder.pattern)) {
+ const start = match.index;
+ const end = start + match[0].length;
+ if (isMasked(start, end) || finder.accept?.(match[0]) === false) {
+ continue;
+ }
+ masked.push([start, end]);
+ citesRecord ||= finder.kind === 'record' || finder.kind === 'claim';
+ report(match[0], finder.kind, line.index + start);
+ }
+ }
+ return citesRecord;
+ }
+
+ function checkBlock(block) {
+ let quoteIndex = null;
+ let quoteMessage = 'quote';
+ let firstIndex = null;
+ let lineCount = 0;
+ let citesRecord = false;
+ const state = {inToolTag: false, inExample: false, inFence: false};
+ for (const comment of block) {
+ if (DIRECTIVE.test(comment.value.trim())) {
+ continue;
+ }
+ for (const line of proseLines(comment, state)) {
+ if (bareText(line.text) === '') {
+ continue;
+ }
+ firstIndex ??= line.index + line.text.search(/\S/);
+ lineCount += 1;
+ citesRecord = checkLine(line) || citesRecord;
+ if (quoteIndex == null && QUOTE_KEYWORD.test(line.text)) {
+ quoteIndex = line.index + line.text.search(QUOTE_KEYWORD);
+ }
+ }
+ }
+ if (quoteIndex == null && citesRecord && lineCount > QUOTE_BLOCK_LINES) {
+ quoteIndex = firstIndex;
+ quoteMessage = 'longQuote';
+ }
+ if (quoteIndex != null) {
+ report(QUOTE_ENTRY, quoteMessage, quoteIndex);
+ }
+ }
+
+ /**
+ * Adjacent line comments that start in one column are one block, so a
+ * quote over several lines is one finding.
+ */
+ function blocks(comments) {
+ const result = [];
+ for (const comment of comments) {
+ const block = result[result.length - 1];
+ const previous = block?.[block.length - 1];
+ if (
+ previous?.type === 'Line' &&
+ comment.type === 'Line' &&
+ comment.loc.start.line === previous.loc.end.line + 1 &&
+ comment.loc.start.column === previous.loc.start.column
+ ) {
+ block.push(comment);
+ } else {
+ result.push([comment]);
+ }
+ }
+ return result;
+ }
+
+ return {
+ Program() {
+ for (const block of blocks(sourceCode.getAllComments())) {
+ checkBlock(block);
+ }
+ },
+ };
+ },
+};
+
+export default rule;
diff --git a/internal/eslint-plugin-astryx/no-comment-provenance.test.mjs b/internal/eslint-plugin-astryx/no-comment-provenance.test.mjs
new file mode 100644
index 0000000000..e1524b4a7b
--- /dev/null
+++ b/internal/eslint-plugin-astryx/no-comment-provenance.test.mjs
@@ -0,0 +1,317 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file no-comment-provenance.test.mjs
+ * @description Tests for the Astryx no-comment-provenance ESLint rule.
+ */
+
+import {RuleTester} from 'eslint';
+import tseslint from 'typescript-eslint';
+import rule, {QUOTE_ENTRY} from './no-comment-provenance.js';
+
+const tester = new RuleTester({
+ languageOptions: {
+ parser: tseslint.parser,
+ parserOptions: {
+ ecmaVersion: 2022,
+ sourceType: 'module',
+ ecmaFeatures: {jsx: true},
+ },
+ },
+});
+
+const file = '/repo/packages/core/src/Button/Button.tsx';
+const baselined = entries => [
+ {baseline: {'packages/core/src/Button/Button.tsx': entries}, root: '/repo'},
+];
+
+// Seven prose lines with one citation: a block that restates its record.
+const longCitingBlock = `
+ // The panel closes when focus leaves it.
+ // Focus returns to the opener when it is still in the page.
+ // Otherwise focus goes to the body.
+ // A pointer press outside closes it too.
+ // Escape closes only the top panel.
+ // The close does not move scroll.
+ // Each step follows spec:AST-108.
+ const a = 1;
+`;
+
+// RuleTester registers its own describe/it blocks internally, so it must run
+// at the top level (Vitest 4 forbids calling suite functions inside an it()).
+tester.run('no-comment-provenance', rule, {
+ valid: [
+ // ✅ A comment that states a reason.
+ {
+ code: `// Safari fires blur before click, so the close waits a frame.\nconst a = 1;`,
+ filename: file,
+ },
+ // ✅ Strings are not comments.
+ {
+ code: `const a = 'spec:AST-108 FR4 #9428 2026-10-31';`,
+ filename: file,
+ },
+ // ✅ The copyright line and the lines a tool reads, with their
+ // continuation lines.
+ {
+ code: `// Copyright (c) Meta Platforms, Inc. and affiliates. 2026-01-01
+/**
+ * @input Button props
+ * @pr-a11y spec:AST-030 FR12
+ * component:Button
+ * SYNC: Button.doc.mjs follows #1234
+ */
+const a = 1;`,
+ filename: file,
+ },
+ // ✅ A line-comment SYNC reminder keeps its continuation line.
+ {
+ code: `// SYNC: keep in step with
+// component:Button and FR2.
+const a = 1;`,
+ filename: file,
+ },
+ // ✅ Lint and TypeScript directives, with their reasons.
+ {
+ code: `// eslint-disable-next-line no-console -- spec:AST-001 FR2 (#1234)
+console.log(1);
+// @ts-expect-error The type lags spec:AST-002 FR1.
+const b: number = 'x';
+/* eslint-disable no-alert */`,
+ filename: file,
+ },
+ // ✅ The @example body of public JSDoc is a code sample.
+ {
+ code: `/**
+ * A button.
+ * @example
+ * <Button since="2026-10-31" label="FR4" />
+ */
+export function Button() { return null; }`,
+ filename: file,
+ },
+ // ✅ The Effect note names the system it syncs.
+ {
+ code: `function C() {
+ // Syncs the document title with the open panel.
+ useEffect(() => {}, []);
+}`,
+ filename: file,
+ },
+ // ✅ Code samples in any comment: @example sections and fenced code.
+ {
+ code: `function f() {
+ /**
+ * Parses a date.
+ * @example
+ * parse('2026-10-31') // FR4
+ */
+ /*
+ * \`\`\`
+ * const issue = '#1234'; // 2026-10-31
+ * \`\`\`
+ */
+ return 1;
+}`,
+ filename: file,
+ },
+ // ✅ Hex colours, quoted dates, and lowercase must are not provenance.
+ {
+ code: `// Fall back to #000, #333333, #DD1234, or #DEC123.
+// Dates look like "2026-10-31" or \`2026-01-02\`.
+// The caller must pass a label.
+const a = 1;`,
+ filename: file,
+ },
+ // ✅ The baseline allows each listed site.
+ {
+ code: `// Follows spec:AST-108 FR4 since #9428 on 2026-10-31.
+// The panel MUST close.
+const a = 1;`,
+ filename: file,
+ options: baselined([
+ 'spec:AST-108',
+ 'FR4',
+ '#9428',
+ '2026-10-31',
+ QUOTE_ENTRY,
+ ]),
+ },
+ // ✅ A long block without a citation is not a quote.
+ {
+ code: longCitingBlock.replace(' Each step follows spec:AST-108.', ''),
+ filename: file,
+ },
+ ],
+ invalid: [
+ // ❌ Record ids of each kind, with a claim suffix kept in one finding.
+ {
+ code: `// See spec:AST-108/FR4, component:Button, module:Icon/registry,
+// architecture:knowledge-contracts, family:menus, design:reduced-motion,
+// theme:butter, and AST-094.
+const a = 1;`,
+ filename: file,
+ errors: [
+ {messageId: 'record', data: {entry: 'spec:AST-108/FR4'}},
+ {messageId: 'record', data: {entry: 'component:Button'}},
+ {messageId: 'record', data: {entry: 'module:Icon/registry'}},
+ {
+ messageId: 'record',
+ data: {entry: 'architecture:knowledge-contracts'},
+ },
+ {messageId: 'record', data: {entry: 'family:menus'}},
+ {messageId: 'record', data: {entry: 'design:reduced-motion'}},
+ {messageId: 'record', data: {entry: 'theme:butter'}},
+ {messageId: 'record', data: {entry: 'AST-094'}},
+ ],
+ },
+ // ❌ Claim ids.
+ {
+ code: `/* Holds FR12, INV3, DEC-4, and AR2b. */\nconst a = 1;`,
+ filename: file,
+ errors: [
+ {messageId: 'claim', data: {entry: 'FR12'}, column: 10},
+ {messageId: 'claim', data: {entry: 'INV3'}},
+ {messageId: 'claim', data: {entry: 'DEC-4'}},
+ {messageId: 'claim', data: {entry: 'AR2b'}},
+ ],
+ },
+ // ❌ Pull request and issue references.
+ {
+ code: `// Fixed in #4290, PR #77, and
+// https://github.com/meta/astryx/pull/9428.
+const a = 1;`,
+ filename: file,
+ errors: [
+ {messageId: 'reference', data: {entry: '#4290'}},
+ {messageId: 'reference', data: {entry: 'PR #77'}},
+ {
+ messageId: 'reference',
+ data: {entry: 'https://github.com/meta/astryx/pull/9428'},
+ },
+ ],
+ },
+ // ❌ Date stamps.
+ {
+ code: `// Decided 2026-10-31; true as of Oct 2026.\nconst a = 1;`,
+ filename: file,
+ errors: [
+ {messageId: 'date', data: {entry: '2026-10-31'}},
+ {messageId: 'date', data: {entry: 'as of Oct 2026'}},
+ ],
+ },
+ // ❌ Requirement text in capitals is a quote.
+ {
+ code: `// The panel MUST close when focus leaves it.\nconst a = 1;`,
+ filename: file,
+ errors: [{messageId: 'quote', data: {entry: QUOTE_ENTRY}, column: 14}],
+ },
+ // ❌ A long block that cites a record is a quote too.
+ {
+ code: longCitingBlock,
+ filename: file,
+ errors: [
+ {messageId: 'longQuote', data: {entry: QUOTE_ENTRY}, line: 2},
+ {messageId: 'record', data: {entry: 'spec:AST-108'}, line: 8},
+ ],
+ },
+ // ❌ JSDoc on exports and on their members keeps no citations.
+ {
+ code: `/** Closes on select, as decided in #9123 (component:Menu FR7). */
+export function Menu() { return null; }
+
+export interface MenuProps {
+ /** The label. Added 2026-10-31. */
+ label: string;
+}
+
+/** Local, exported below. Follows INV3. */
+const helper = () => 1;
+export {helper};`,
+ filename: file,
+ errors: [
+ {messageId: 'reference', data: {entry: '#9123'}},
+ {messageId: 'record', data: {entry: 'component:Menu'}},
+ {messageId: 'claim', data: {entry: 'FR7'}},
+ {messageId: 'date', data: {entry: '2026-10-31'}},
+ {messageId: 'claim', data: {entry: 'INV3'}},
+ ],
+ },
+ // ❌ Public JSDoc keeps no quote blocks.
+ {
+ code: `export interface ButtonProps {
+ /** The label. It MUST be short. */
+ label: string;
+}`,
+ filename: file,
+ errors: [{messageId: 'quote', data: {entry: QUOTE_ENTRY}}],
+ },
+ // ❌ File header lines that no tool reads keep no citations.
+ {
+ code: `/**
+ * @file Button.tsx
+ * @position Core primitive; follows spec:AST-010 FR1.
+ */
+const a = 1;`,
+ filename: file,
+ errors: [
+ {messageId: 'record', data: {entry: 'spec:AST-010'}},
+ {messageId: 'claim', data: {entry: 'FR1'}},
+ ],
+ },
+ // ❌ The Effect note keeps no citations.
+ {
+ code: `function C() {
+ // Syncs the document title (architecture:react-component-runtime INV3).
+ useEffect(() => {}, []);
+}`,
+ filename: file,
+ errors: [
+ {
+ messageId: 'record',
+ data: {entry: 'architecture:react-component-runtime'},
+ },
+ {messageId: 'claim', data: {entry: 'INV3'}},
+ ],
+ },
+ // ❌ JSDoc inside a function body.
+ {
+ code: `export function C() {
+ /** Follows INV3. */
+ const a = 1;
+ return a;
+}`,
+ filename: file,
+ errors: [{messageId: 'claim', data: {entry: 'INV3'}}],
+ },
+ // ❌ JSDoc on a declaration that is not exported.
+ {
+ code: `/** Follows INV3. */\nfunction local() {}`,
+ filename: file,
+ errors: [{messageId: 'claim', data: {entry: 'INV3'}}],
+ },
+ // ❌ A comment before an Effect that does not name what it syncs.
+ {
+ code: `function C() {
+ // Runs once (spec:AST-099).
+ useEffect(() => {}, []);
+}`,
+ filename: file,
+ errors: [{messageId: 'record', data: {entry: 'spec:AST-099'}}],
+ },
+ // ❌ The baseline allows as many sites as it lists; one more is reported.
+ {
+ code: `// FR4 here.\nconst a = 1;\n// FR4 again.\nconst b = 2;`,
+ filename: file,
+ options: baselined(['FR4']),
+ errors: [{messageId: 'claim', data: {entry: 'FR4'}, line: 3}],
+ },
+ // ❌ A baseline entry for another file allows nothing here.
+ {
+ code: `// See #4290.\nconst a = 1;`,
+ filename: '/repo/packages/core/src/Card/Card.tsx',
+ options: baselined(['#4290']),
+ errors: [{messageId: 'reference', data: {entry: '#4290'}}],
+ },
+ ],
+});