@atlaskit/ads-mcp 1.11.2 → 1.11.3

package/dist/cjs/tools/get-lint-rules/lint-rules-structured-content.codegen.js

@@ -9,7 +9,7 @@ exports.lintRulesMcpStructuredContent = void 0;
  *
  * Structured content for MCP (JSON) for ESLint rule docs from constellation.
  *
- * @codegen <<SignedSource::519a4af34d9d3f477d07bad55b5fde80>>
+ * @codegen <<SignedSource::89a5a1c47b0a992cb611dc171b6eb82e>>
  * @codegenCommand yarn build structured-docs
  */
 /* eslint-disable no-template-curly-in-string */
@@ -95,7 +95,7 @@ var lintRulesMcpStructuredContent = exports.lintRulesMcpStructuredContent = [{
   ruleName: 'no-deprecated-apis',
   description: 'Props across the Atlassian Design System can be deprecated when they are no longer fit for purpose'
 }, {
-  content: '{"ruleName":"no-deprecated-design-token-usage","description":"Using deprecated design tokens is dangerous as they will eventually be deleted after the sunset","content":"# no-deprecated-design-token-usage\\n\\nUsing deprecated design tokens is dangerous as they will eventually be deleted after the sunset\\nperiod. This rule helps you move to non-deprecated design tokens.\\n\\n## Examples\\n\\nThis rule will mark usage of deprecated design tokens as violations.\\n\\n## Incorrect\\n\\n```js\\nimport { token } from \'@atlaskit/tokens\';\\n\\ncss({ color: token(\'i.am.deprecated\') });\\n                    ^^^^^^^^^^^^^^^\\ncss({ color: token(\'i.am.a.token\') });\\n                    ^^^^^^^^^^^^^\\n```\\n\\n## Options\\n\\nIt\'s recommended to set this rule to \\"warn\\" to allow for new and old tokens to exist side-by-side\\nfor the duration of the deprecation period and avoid big-bang migrations.\\n\\nOnce the deprecation period is over for a design token it will be moved into `deleted` state at\\nwhich point the counterpart of this rule `no-unsafe-design-token-usage` will mark violations as\\nerrors.\\n\\nRunning `eslint --fix` will automatically apply replacement tokens if present.\\n"}',
+  content: '{"ruleName":"no-deprecated-design-token-usage","description":"Using deprecated design tokens is dangerous as they will eventually be deleted after the sunset","content":"# no-deprecated-design-token-usage\\n\\nUsing deprecated design tokens is dangerous as they will eventually be deleted after the sunset\\nperiod. This rule helps you move to non-deprecated design tokens.\\n\\n## Examples\\n\\nThis rule will mark usage of deprecated design tokens as violations.\\n\\n## Incorrect\\n\\n```js\\nimport { token } from \'@atlaskit/tokens\';\\n\\ncss({ color: token(\'i.am.deprecated\') });\\n                    ^^^^^^^^^^^^^^^\\ncss({ color: token(\'i.am.a.token\') });\\n                    ^^^^^^^^^^^^^\\n```\\n\\n## Options\\n\\nIt\'s recommended to set this rule to \\"warn\\" to allow for new and old tokens to exist side-by-side\\nfor the duration of the deprecation period and avoid big-bang migrations.\\n\\nOnce the deprecation period is over for a design token it will be moved into `deleted` state at\\nwhich point the counterpart of this rule `no-unsafe-design-token-usage` will mark violations as\\nerrors.\\n\\nReplacement tokens are offered as editor suggestions when present.\\n\\n## Primitive component props\\n\\nThe rule also checks explicit string props on imported `@atlaskit/primitives` components, including\\naliases, namespaces, component subpaths, and `/compiled` imports. It covers the token-valued spacing\\nand color props, as well as `Text.size`, `Text.weight`, `MetricText.size`, and Bleed\'s\\npositive-to-negative spacing mapping. See\\n[`no-unsafe-design-token-usage`](/components/eslint-plugin-design-system/no-unsafe-design-token-usage/usage#primitive-component-props)\\nfor the full prop list and static-analysis limits.\\n\\nDeprecated tokens produce warnings according to this rule\'s configured severity. Suggestions\\npreserve semantic prop values (such as `size=\\"small\\"`) and are only offered when the replacement is\\nsupported by the prop. Tokens without a replacement, raw CSS replacements, and incompatible token\\nfamilies are reported without a suggestion.\\n"}',
   ruleName: 'no-deprecated-design-token-usage',
   description: 'Using deprecated design tokens is dangerous as they will eventually be deleted after the sunset'
 }, {
@@ -223,7 +223,7 @@ var lintRulesMcpStructuredContent = exports.lintRulesMcpStructuredContent = [{
   ruleName: 'no-to-match-snapshot',
   description: 'This rule disallows the use of Jest snapshot matchers in unit tests:'
 }, {
-  content: '{"ruleName":"no-unsafe-design-token-usage","description":"Using design tokens in an unsafe way risks the health of the system and will affect how fast your","content":"# no-unsafe-design-token-usage\\n\\nUsing design tokens in an unsafe way risks the health of the system and will affect how fast your\\ncodebase can migrate between versions.\\n\\n## Examples\\n\\nThis rule will mark design token usage that is not statically and locally analyzable, as well as\\ndesign tokens that are considered deleted.\\n\\n## Incorrect\\n\\n```js\\nconst textColor = \'red\';\\n\\ncss({ color: textColor });\\n             ^^^^^^^^^ must be a string literal\\n```\\n\\n```js\\ncss({ boxShadow: \'0px 1px 1px var(--ds-accent-subtleBlue)\' });\\n                              ^^^^^^^^^^^^^^^^^^^^^^^^^^ must use the token() function\\n```\\n\\n## Correct\\n\\n```js\\nimport { token } from \'@atlaskit/tokens\';\\n\\ncss({ boxShadow: token(\'elevation.shadow.card\') });\\n\\ncss`\\n\\tcolor: ${(token(\'color.text.highemphasis\'), N20)};\\n`;\\n```\\n\\n## Options\\n\\nThis rule comes with options to aid in migrating to design tokens.\\n\\n### fallbackUsage\\n\\n- `forced`: Fallback values must always be provided\\n- `none`: Fallback values must never be provided. (Fixer will remove if provided)\\n- `optional`: Fallbacks are optional\\n\\n### shouldEnforceFallbacks (deprecated)\\n\\nWhen `true` the rule will mark token function usage as violations when fallbacks aren\'t defined.\\nWhen `false` the rule will mark token function usage as violations when fallbacks are defined.\\n"}',
+  content: '{"ruleName":"no-unsafe-design-token-usage","description":"Using design tokens in an unsafe way risks the health of the system and will affect how fast your","content":"# no-unsafe-design-token-usage\\n\\nUsing design tokens in an unsafe way risks the health of the system and will affect how fast your\\ncodebase can migrate between versions.\\n\\n## Examples\\n\\nThis rule will mark design token usage that is not statically and locally analyzable, as well as\\ndesign tokens that are considered deleted.\\n\\n## Incorrect\\n\\n```js\\nconst textColor = \'red\';\\n\\ncss({ color: textColor });\\n             ^^^^^^^^^ must be a string literal\\n```\\n\\n```js\\ncss({ boxShadow: \'0px 1px 1px var(--ds-accent-subtleBlue)\' });\\n                              ^^^^^^^^^^^^^^^^^^^^^^^^^^ must use the token() function\\n```\\n\\n## Correct\\n\\n```js\\nimport { token } from \'@atlaskit/tokens\';\\n\\ncss({ boxShadow: token(\'elevation.shadow.card\') });\\n\\ncss`\\n\\tcolor: ${(token(\'color.text.highemphasis\'), N20)};\\n`;\\n```\\n\\n## Token names in xcss\\n\\nThe rule also checks experimental and deleted token names used directly in object literals passed to\\n`xcss()` from `@atlaskit/primitives`, including nested pseudo selectors and media queries. Aliased\\nimports and namespace imports are supported.\\n\\n```js\\nimport { xcss } from \'@atlaskit/primitives/xcss\';\\n\\n// Incorrect: experimental token\\nxcss({ gap: \'space.gap.medium\' });\\n\\n// Correct: active token; no token() wrapper is needed\\nxcss({ gap: \'space.100\' });\\n```\\n\\nFixes replace the string with its replacement token name. Raw CSS replacements are reported without\\na fix because token-valued xcss properties may not accept them. This check covers literal property\\nvalues in the xcss object, rather than values supplied through variables or object spreads.\\n\\n## Primitive component props\\n\\nThe rule also reports experimental and deleted tokens selected by explicit string props on\\n`@atlaskit/primitives` components. This includes:\\n\\n- `Box`: `backgroundColor` and all padding props.\\n- `Inline`: `space` and `rowSpace`; `Stack`: `space`.\\n- `Flex` and `Grid`: `gap`, `rowGap`, and `columnGap`.\\n- `Text`: `color`, `size`, and `weight`; `MetricText`: `size`.\\n- `Bleed`: `all`, `inline`, and `block`, resolved to negative spacing tokens.\\n- Standard `Anchor` and `Pressable`: `backgroundColor` and all padding props. Their compiled\\n  versions do not expose these props.\\n\\nNamed, aliased, namespace, and supported default imports are recognized, including component\\nsubpaths and `/compiled` imports. Local bindings that shadow imports are ignored.\\n\\n```jsx\\nimport { Stack } from \'@atlaskit/primitives/compiled/stack\';\\n\\n// Incorrect: experimental token\\n<Stack space=\\"space.gap.medium\\" />;\\n\\n// Correct\\n<Stack space=\\"space.100\\" />;\\n```\\n\\nBoth `space=\\"...\\"` and `space={\'...\'}` are checked. Semantic values are resolved to their actual\\ntokens: for example, `Text size=\\"small\\"` selects `font.body.small`, and `Bleed all=\\"space.100\\"`\\nselects `space.negative.100`. Fixes preserve the prop\'s value format and are only offered when the\\nreplacement is a token the prop supports. Raw CSS replacements and incompatible token families are\\nreported without a fix.\\n\\nThis check does not resolve variables, expressions, prop spreads, omitted defaults, or implicit\\nsurface-derived text colors. It does not require `token()` wrappers or fallbacks for primitive\\nprops. Deprecated tokens are checked by `no-deprecated-design-token-usage`, allowing its warning\\nseverity to remain independently configurable.\\n\\n## Options\\n\\nThis rule comes with options to aid in migrating to design tokens.\\n\\n### fallbackUsage\\n\\n- `forced`: Fallback values must always be provided\\n- `none`: Fallback values must never be provided. (Fixer will remove if provided)\\n- `optional`: Fallbacks are optional\\n\\n### shouldEnforceFallbacks (deprecated)\\n\\nWhen `true` the rule will mark token function usage as violations when fallbacks aren\'t defined.\\nWhen `false` the rule will mark token function usage as violations when fallbacks are defined.\\n"}',
   ruleName: 'no-unsafe-design-token-usage',
   description: 'Using design tokens in an unsafe way risks the health of the system and will affect how fast your'
 }, {