@atlaskit/ads-mcp 1.11.5 → 1.11.6

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @atlaskit/ads-mcp
 
+## 1.11.6
+
+### Patch Changes
+
+- [`c149c3839b565`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/c149c3839b565) -
+  Add EntryPoint migration guidance to the ADS MCP registry.
+
 ## 1.11.5
 
 ### Patch Changes

package/dist/cjs/tools/migration-guides/migration-registry.js

@@ -7,8 +7,9 @@ Object.defineProperty(exports, "__esModule", {
 exports.migrationRegistry = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _avatarXsmallToXxsmall = require("./migrations/avatar-xsmall-to-xxsmall");
+var _interactionToEntryPoint = require("./migrations/interaction-to-entry-point");
 var _onboardingJiraSpotlight = require("./migrations/onboarding-jira-spotlight");
 var _onboardingMultiStep = require("./migrations/onboarding-multi-step");
 var _onboardingSingleStep = require("./migrations/onboarding-single-step");
 var _onboardingWithMotion = require("./migrations/onboarding-with-motion");
-var migrationRegistry = exports.migrationRegistry = (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _avatarXsmallToXxsmall.avatarXsmallToXxsmall.id, _avatarXsmallToXxsmall.avatarXsmallToXxsmall), _onboardingJiraSpotlight.onboardingJiraSpotlight.id, _onboardingJiraSpotlight.onboardingJiraSpotlight), _onboardingSingleStep.onboardingSingleStep.id, _onboardingSingleStep.onboardingSingleStep), _onboardingMultiStep.onboardingMultiStep.id, _onboardingMultiStep.onboardingMultiStep), _onboardingWithMotion.onboardingWithMotion.id, _onboardingWithMotion.onboardingWithMotion);
+var migrationRegistry = exports.migrationRegistry = (0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)((0, _defineProperty2.default)({}, _avatarXsmallToXxsmall.avatarXsmallToXxsmall.id, _avatarXsmallToXxsmall.avatarXsmallToXxsmall), _interactionToEntryPoint.interactionToEntryPoint.id, _interactionToEntryPoint.interactionToEntryPoint), _onboardingJiraSpotlight.onboardingJiraSpotlight.id, _onboardingJiraSpotlight.onboardingJiraSpotlight), _onboardingSingleStep.onboardingSingleStep.id, _onboardingSingleStep.onboardingSingleStep), _onboardingMultiStep.onboardingMultiStep.id, _onboardingMultiStep.onboardingMultiStep), _onboardingWithMotion.onboardingWithMotion.id, _onboardingWithMotion.onboardingWithMotion);

package/dist/cjs/tools/migration-guides/migrations/interaction-to-entry-point.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.interactionToEntryPoint = void 0;
+var interactionToEntryPoint = exports.interactionToEntryPoint = {
+  id: 'interaction-to-entry-point',
+  title: 'Interaction to EntryPoint migration',
+  description: 'Use when replacing an existing modal, popup, dropdown, or similar interaction boundary with an EntryPoint. It does not apply to new inline UI, API-only work, or test-only changes.',
+  fromPackage: 'product-owned interaction',
+  toPackage: '@atlassian/entry-points',
+  examples: [{
+    title: 'Move a controlled modal to an EntryPoint trigger',
+    description: 'Replace locally owned visibility state and direct rendering with the product-supported trigger and required provider.',
+    before: "\nconst [isOpen, setIsOpen] = useState(false);\n\n<Button aria-haspopup=\"dialog\" onClick={() => setIsOpen(true)}>\n\tOpen modal\n</Button>\n{isOpen && <Modal onClose={() => setIsOpen(false)}>\u2026</Modal>}\n",
+    after: "\n<ModalContextProvider>\n\t<ModalButtonTrigger entryPoint={modalEntryPoint} appearance=\"primary\">\n\t\tOpen modal\n\t</ModalButtonTrigger>\n</ModalContextProvider>\n",
+    explanation: 'The trigger owns visibility while the loaded root receives the supplied close callback. This is a structural example only: confirm the product API, provider requirements, focus return, Escape and outside dismissal, analytics, and any existing controlled-open contract before applying it.'
+  }],
+  bestPractices: ['Read the applicable product and package guides, then inspect the current interaction, its callers, and the shipped target trigger. Identify open/close paths, callbacks, state and data owners, provider lifetime, and the trigger ref, keyboard, disabled, and semantic props.', 'Use a direct conversion only when the supported target contract preserves required behavior. Do not remove public controlled or default-open behavior, manufacture unsupported props, or force a migration by changing requirements.', 'Move deferred UI behind the product-supported lazy root and remove eager value imports that defeat it. Keep preload parameters, queries, runtime props, and injected trigger props separate.', 'Forward the supplied trigger ref and interaction props to the actual control. Keep state, analytics, providers, and close side effects with the owner whose lifetime the existing contract requires.', 'For GraphQL, preload only data available at open time and consume the matching query reference in the lazy UI. Do not hand-edit generated artifacts or replace unrelated data architectures.', 'Trace the launcher through the trigger, EntryPoint, and lazy root to the rendered experience. A disconnected descriptor or unused preload is not a completed migration.', 'Run the smallest supported checks that observe changed behavior. Check opening, closing, callbacks, focus and keyboard behavior, data freshness, loading, and failures only when the original interaction requires them.'],
+  additionalResources: 'Report independently whether the conversion is full, partial, or blocked; whether behavior is preserved, changed, or unresolved; and which checks actually ran. Do not claim performance gains or runtime parity without evidence.'
+};

package/dist/es2019/tools/migration-guides/migration-registry.js

@@ -1,10 +1,12 @@
 import { avatarXsmallToXxsmall } from './migrations/avatar-xsmall-to-xxsmall';
+import { interactionToEntryPoint } from './migrations/interaction-to-entry-point';
 import { onboardingJiraSpotlight } from './migrations/onboarding-jira-spotlight';
 import { onboardingMultiStep } from './migrations/onboarding-multi-step';
 import { onboardingSingleStep } from './migrations/onboarding-single-step';
 import { onboardingWithMotion } from './migrations/onboarding-with-motion';
 export const migrationRegistry = {
   [avatarXsmallToXxsmall.id]: avatarXsmallToXxsmall,
+  [interactionToEntryPoint.id]: interactionToEntryPoint,
   [onboardingJiraSpotlight.id]: onboardingJiraSpotlight,
   [onboardingSingleStep.id]: onboardingSingleStep,
   [onboardingMultiStep.id]: onboardingMultiStep,

package/dist/es2019/tools/migration-guides/migrations/interaction-to-entry-point.js

@@ -0,0 +1,29 @@
+export const interactionToEntryPoint = {
+  id: 'interaction-to-entry-point',
+  title: 'Interaction to EntryPoint migration',
+  description: 'Use when replacing an existing modal, popup, dropdown, or similar interaction boundary with an EntryPoint. It does not apply to new inline UI, API-only work, or test-only changes.',
+  fromPackage: 'product-owned interaction',
+  toPackage: '@atlassian/entry-points',
+  examples: [{
+    title: 'Move a controlled modal to an EntryPoint trigger',
+    description: 'Replace locally owned visibility state and direct rendering with the product-supported trigger and required provider.',
+    before: `
+const [isOpen, setIsOpen] = useState(false);
+
+<Button aria-haspopup="dialog" onClick={() => setIsOpen(true)}>
+	Open modal
+</Button>
+{isOpen && <Modal onClose={() => setIsOpen(false)}>…</Modal>}
+`,
+    after: `
+<ModalContextProvider>
+	<ModalButtonTrigger entryPoint={modalEntryPoint} appearance="primary">
+		Open modal
+	</ModalButtonTrigger>
+</ModalContextProvider>
+`,
+    explanation: 'The trigger owns visibility while the loaded root receives the supplied close callback. This is a structural example only: confirm the product API, provider requirements, focus return, Escape and outside dismissal, analytics, and any existing controlled-open contract before applying it.'
+  }],
+  bestPractices: ['Read the applicable product and package guides, then inspect the current interaction, its callers, and the shipped target trigger. Identify open/close paths, callbacks, state and data owners, provider lifetime, and the trigger ref, keyboard, disabled, and semantic props.', 'Use a direct conversion only when the supported target contract preserves required behavior. Do not remove public controlled or default-open behavior, manufacture unsupported props, or force a migration by changing requirements.', 'Move deferred UI behind the product-supported lazy root and remove eager value imports that defeat it. Keep preload parameters, queries, runtime props, and injected trigger props separate.', 'Forward the supplied trigger ref and interaction props to the actual control. Keep state, analytics, providers, and close side effects with the owner whose lifetime the existing contract requires.', 'For GraphQL, preload only data available at open time and consume the matching query reference in the lazy UI. Do not hand-edit generated artifacts or replace unrelated data architectures.', 'Trace the launcher through the trigger, EntryPoint, and lazy root to the rendered experience. A disconnected descriptor or unused preload is not a completed migration.', 'Run the smallest supported checks that observe changed behavior. Check opening, closing, callbacks, focus and keyboard behavior, data freshness, loading, and failures only when the original interaction requires them.'],
+  additionalResources: 'Report independently whether the conversion is full, partial, or blocked; whether behavior is preserved, changed, or unresolved; and which checks actually ran. Do not claim performance gains or runtime parity without evidence.'
+};

package/dist/esm/tools/migration-guides/migration-registry.js

@@ -1,7 +1,8 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { avatarXsmallToXxsmall } from './migrations/avatar-xsmall-to-xxsmall';
+import { interactionToEntryPoint } from './migrations/interaction-to-entry-point';
 import { onboardingJiraSpotlight } from './migrations/onboarding-jira-spotlight';
 import { onboardingMultiStep } from './migrations/onboarding-multi-step';
 import { onboardingSingleStep } from './migrations/onboarding-single-step';
 import { onboardingWithMotion } from './migrations/onboarding-with-motion';
-export var migrationRegistry = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, avatarXsmallToXxsmall.id, avatarXsmallToXxsmall), onboardingJiraSpotlight.id, onboardingJiraSpotlight), onboardingSingleStep.id, onboardingSingleStep), onboardingMultiStep.id, onboardingMultiStep), onboardingWithMotion.id, onboardingWithMotion);
+export var migrationRegistry = _defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty(_defineProperty({}, avatarXsmallToXxsmall.id, avatarXsmallToXxsmall), interactionToEntryPoint.id, interactionToEntryPoint), onboardingJiraSpotlight.id, onboardingJiraSpotlight), onboardingSingleStep.id, onboardingSingleStep), onboardingMultiStep.id, onboardingMultiStep), onboardingWithMotion.id, onboardingWithMotion);

package/dist/esm/tools/migration-guides/migrations/interaction-to-entry-point.js

@@ -0,0 +1,16 @@
+export var interactionToEntryPoint = {
+  id: 'interaction-to-entry-point',
+  title: 'Interaction to EntryPoint migration',
+  description: 'Use when replacing an existing modal, popup, dropdown, or similar interaction boundary with an EntryPoint. It does not apply to new inline UI, API-only work, or test-only changes.',
+  fromPackage: 'product-owned interaction',
+  toPackage: '@atlassian/entry-points',
+  examples: [{
+    title: 'Move a controlled modal to an EntryPoint trigger',
+    description: 'Replace locally owned visibility state and direct rendering with the product-supported trigger and required provider.',
+    before: "\nconst [isOpen, setIsOpen] = useState(false);\n\n<Button aria-haspopup=\"dialog\" onClick={() => setIsOpen(true)}>\n\tOpen modal\n</Button>\n{isOpen && <Modal onClose={() => setIsOpen(false)}>\u2026</Modal>}\n",
+    after: "\n<ModalContextProvider>\n\t<ModalButtonTrigger entryPoint={modalEntryPoint} appearance=\"primary\">\n\t\tOpen modal\n\t</ModalButtonTrigger>\n</ModalContextProvider>\n",
+    explanation: 'The trigger owns visibility while the loaded root receives the supplied close callback. This is a structural example only: confirm the product API, provider requirements, focus return, Escape and outside dismissal, analytics, and any existing controlled-open contract before applying it.'
+  }],
+  bestPractices: ['Read the applicable product and package guides, then inspect the current interaction, its callers, and the shipped target trigger. Identify open/close paths, callbacks, state and data owners, provider lifetime, and the trigger ref, keyboard, disabled, and semantic props.', 'Use a direct conversion only when the supported target contract preserves required behavior. Do not remove public controlled or default-open behavior, manufacture unsupported props, or force a migration by changing requirements.', 'Move deferred UI behind the product-supported lazy root and remove eager value imports that defeat it. Keep preload parameters, queries, runtime props, and injected trigger props separate.', 'Forward the supplied trigger ref and interaction props to the actual control. Keep state, analytics, providers, and close side effects with the owner whose lifetime the existing contract requires.', 'For GraphQL, preload only data available at open time and consume the matching query reference in the lazy UI. Do not hand-edit generated artifacts or replace unrelated data architectures.', 'Trace the launcher through the trigger, EntryPoint, and lazy root to the rendered experience. A disconnected descriptor or unused preload is not a completed migration.', 'Run the smallest supported checks that observe changed behavior. Check opening, closing, callbacks, focus and keyboard behavior, data freshness, loading, and failures only when the original interaction requires them.'],
+  additionalResources: 'Report independently whether the conversion is full, partial, or blocked; whether behavior is preserved, changed, or unresolved; and which checks actually ran. Do not claim performance gains or runtime parity without evidence.'
+};

package/dist/types/tools/migration-guides/migrations/interaction-to-entry-point.d.ts

@@ -0,0 +1,2 @@
+import type { MigrationGuide } from '../types';
+export declare const interactionToEntryPoint: MigrationGuide;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "1.11.5",
+	"version": "1.11.6",
 	"description": "The official Atlassian Design System MCP server to develop apps and user interfaces matching the Atlassian style.",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -24,7 +24,7 @@
 		"@atlaskit/icon": "^38.0.0",
 		"@atlaskit/icon-lab": "^7.11.0",
 		"@atlaskit/platform-feature-flags": "^2.2.0",
-		"@atlaskit/tokens": "^20.7.0",
+		"@atlaskit/tokens": "^20.8.0",
 		"@axe-core/playwright": "^4.11.1",
 		"@axe-core/puppeteer": "^4.11.1",
 		"@babel/runtime": "^7.0.0",