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.jsindex 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-iimport {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.mdindex 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` anddiff --git a/internal/eslint-plugin-astryx/index.js b/internal/eslint-plugin-astryx/index.jsindex 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.jsonnew file mode 100644index 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.mjsnew file mode 100644index 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.jsnew file mode 100644index 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.mjsnew file mode 100644index 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'}}],+ },+ ],+});