@atlaskit/ads-mcp 0.20.2 → 0.20.4

package/dist/es2019/tools/migration-guides/migrations/onboarding-to-spotlight.js

@@ -1,646 +0,0 @@
-const additionalResources = 'Visit https://hello.atlassian.net/wiki/spaces/DST/pages/6069774593 or https://atlassian.design/components/spotlight for more context';
-export const onboardingSingleStep = {
-  id: 'single-step',
-  title: 'Single Step Spotlight Migration',
-  description: 'Use when code ONLY has `Spotlight` from `@atlaskit/onboarding` (no JiraSpotlight)',
-  fromPackage: '@atlaskit/onboarding',
-  toPackage: '@atlaskit/spotlight',
-  examples: [{
-    title: 'Migrate single step spotlight',
-    description: 'Replace SpotlightTarget, and Spotlight with the new compositional @atlaskit/spotlight components',
-    before: `
-// file1.tsx
-import React, { useState } from 'react';
-import Button from '@atlaskit/button/new';
-import { Spotlight } from '@atlaskit/onboarding';
-
-const OnboardingSpotlight = () => {
-  const [isSpotlightActive, setIsSpotlightActive] = useState(true);
-  const start = () => setIsSpotlightActive(true);
-  const end = () => setIsSpotlightActive(false);
-
-  return (
-		{isSpotlightActive && (
-			<Spotlight
-				dialogPlacement='bottom right'
-				actions={[
-					{
-						onClick: end,
-						text: 'Got it',
-					},
-				]}
-				heading="Feature Heading"
-				target="my-target"
-			>
-				This is the spotlight body content describing the feature.
-			</Spotlight>
-		)}
-  );
-};
-
-// file2.tsx
-import React from 'react';
-import Button from '@atlaskit/button/new';
-import { Spotlight } from '@atlaskit/onboarding';
-
-const SomeFeature = () => {
-
-  return (
-		<SpotlightTarget name="my-target">
-			<Button>Target Element</Button>
-		</SpotlightTarget>
-  );
-};
-`,
-    after: `
-// file2.tsx -- the Spotlight has been co-located to the targeted element.
-import React, { useState } from 'react';
-import Button from '@atlaskit/button/new';
-import { Text } from '@atlaskit/primitives/compiled';
-import {
-  PopoverContent,
-  PopoverProvider,
-  PopoverTarget,
-  SpotlightActions,
-  SpotlightBody,
-  SpotlightCard,
-  SpotlightControls,
-  SpotlightDismissControl,
-  SpotlightFooter,
-  SpotlightHeader,
-  SpotlightHeadline,
-  SpotlightPrimaryAction,
-} from '@atlaskit/spotlight';
-
-const Spotlight = () => {
-  const [isVisible, setIsVisible] = useState(false);
-  const dismiss = () => setIsVisible(false);
-  const done = () => setIsVisible(false);
-
-  return (
-    <PopoverProvider>
-      <PopoverTarget>
-        <Button onClick={() => setIsVisible(true)}>Target Element</Button>
-      </PopoverTarget>
-      <PopoverContent dismiss={dismiss} placement="bottom-start" isVisible={isVisible}>
-        <SpotlightCard>
-          <SpotlightHeader>
-            <SpotlightHeadline>Feature Heading</SpotlightHeadline>
-            <SpotlightControls>
-              <SpotlightDismissControl />
-            </SpotlightControls>
-          </SpotlightHeader>
-          <SpotlightBody>
-            <Text>This is the spotlight body content describing the feature.</Text>
-          </SpotlightBody>
-          <SpotlightFooter>
-            <SpotlightActions>
-              <SpotlightPrimaryAction onClick={done}>Got it</SpotlightPrimaryAction>
-            </SpotlightActions>
-          </SpotlightFooter>
-        </SpotlightCard>
-      </PopoverContent>
-    </PopoverProvider>
-  );
-};`,
-    explanation: `Key changes when migrating a single step spotlight:
-- Do not use this migration guide for JiraSpotlight. Use 'jira-spotlight' instead.
-- PopoverProvider maintains internal Spotlight state. SpotlightManager coordinated multiple @atlaskit/onboarding usages and is no longer needed.
-- Replace SpotlightTarget with PopoverTarget - wraps the element to highlight
-- Replace Spotlight with PopoverContent containing SpotlightCard - controls visibility and positioning
-- The 'heading' prop becomes SpotlightHeadline inside SpotlightHeader
-- The 'actions' array becomes SpotlightActions with SpotlightPrimaryAction (and optionally SpotlightSecondaryAction)
-- The children content moves into SpotlightBody wrapped with Text component
-- Add SpotlightDismissControl inside SpotlightControls for the close button
-- The 'target' and/or 'targetName' prop is replaced with PopoverTarget directly wrapping the target element
-- The 'dialogPlacement' prop becomes 'placement' on PopoverContent. Mapping: "top right" → "top-start", "top center" → "top", "top left" → "top-end", "right bottom" → "right-start", "right middle" → "right-start | right-end", "right top" → "right-end", "bottom left" → "bottom-end", "bottom center" → "bottom", "bottom right" → "bottom-start", "left top" → "left-end", "left middle" → "left-start | left-end", "left bottom" → "left-start"'`
-  }],
-  bestPractices: ['PopoverTarget should wrap exactly one child element that will be highlighted', 'Always include SpotlightDismissControl for accessibility - allows users to dismiss via close button', 'SpotlightPrimaryAction is required and wraps the main CTA button', 'Wrap body text content in the Text component from @atlaskit/primitives/compiled'],
-  additionalResources
-};
-export const onboardingJiraSpotlight = {
-  id: 'jira-spotlight',
-  title: 'JiraSpotlight Migration',
-  description: 'Use when code contains `JiraSpotlight` import from `@atlassian/jira-spotlight`',
-  fromPackage: '@atlassian/jira-spotlight',
-  toPackage: '@atlaskit/spotlight',
-  examples: [{
-    title: 'Internal <JiraSpotlight /> migration',
-    description: 'Internal migrations are possible for JiraSpotlight usages which only pass simple/textual content to JiraSpotlight children',
-    before: `
-// file1.tsx
-import { JiraSpotlight } from '@atlassian/jira-spotlight/src/ui/jira-spotlight.tsx';
-
-export const OnboardingSpotlightWrapper = () => {
-	const spotlightId = 'some-unique-identifier'
-	const { dark, light } = spotlightImageUrls[spotlightId];
-	const imageUrl = colorMode === 'dark' ? dark : light;
-
-	return (
-		<JiraSpotlight
-			image={imageUrl}
-			actions={[
-				{
-					onClick,
-					text: formatMessage(dismiss),
-				},
-			]}
-			heading={formatMessage(heading)}
-			target={spotlightId}
-			key={spotlightId}
-			targetRadius={3}
-			targetBgColor={token('elevation.surface')}
-			messageId={spotlightId}
-			messageType="transactional"
-			dialogWidth={275}
-		>
-			{formatMessage(body)}
-		</JiraSpotlight>
-	);
-}
-
-// file2.tsx
-import { SpotlightTarget } from '@atlaskit/onboarding';
-
-const spotlightId = 'some-unique-identifier'
-
-export const SomeFeature = () => {
-	return (
-		<SpotlightTarget name={spotlightId}>
-			// Target code
-		</SpotlightTarget>
-	);
-}
-`,
-    after: `
-// file1.tsx
-import { JiraSpotlight } from '@atlassian/jira-spotlight/src/ui/jira-spotlight.tsx';
-
-export const OnboardingSpotlightWrapper = () => {
-	const spotlightId = 'some-unique-identifier'
-	const { dark, light } = spotlightImageUrls[spotlightId];
-	const imageUrl = colorMode === 'dark' ? dark : light;
-
-	return (
-		<JiraSpotlight
-			isMigrated // isMigrated prop passed
-			image={imageUrl}
-			actions={[
-				{
-					onClick,
-					text: formatMessage(dismiss),
-				},
-			]}
-			heading={formatMessage(heading)}
-			target={spotlightId}
-			key={spotlightId}
-			targetRadius={3}
-			targetBgColor={token('elevation.surface')}
-			messageId={spotlightId}
-			messageType="transactional"
-			dialogWidth={275}
-		>
-			{formatMessage(body)}
-		</JiraSpotlight>
-	);
-}
-
-// file2.tsx
-// Updated SpotlightTarget import statement
-import { SpotlightTarget } from '@atlassian/jira-spotlight/src/ui/SpotlightTarget.tsx';
-
-export const SomeFeature = () => {
-	const spotlightId = 'some-unique-identifier'
-
-	return (
-		<SpotlightTarget name={spotlightId}>
-			// Target code
-		</SpotlightTarget>
-	);
-}
-			`,
-    explanation: `Key changes when migrating a JiraSpotlight:
-- A JiraSpotlight and a SpotlightTarget are part of the same usage if they share a spotlightId value - Referenced in JiraSpotlight.target and SpotlightTarget.name props
-- Pass isMigrated={true} to JiraSpotlight.
-- Update SpotlightTarget import statment from '@atlaskit/onboarding' to '@atlassian/jira-spotlight/src/ui/SpotlightTarget.tsx';
-- These changes allow switching the internal implementation to '@atlaskit/spotlight' via a feature flag.
-- This internal migration is only possible for usages that don't rely too heavily on the 'children' prop, as complex values, like heading, images, etc passed to 'children' are difficult to parse.
-`
-  }, {
-    title: 'Complex <JiraSpotlight /> migration',
-    description: 'Complex migrations are necessary for JiraSpotlight usages that make heavy use of the `children` prop to achieve customisation instead of relying on the `heading`, `body`, `image`, and/or `actions` props.',
-    before: `
-// file1.tsx
-import { JiraSpotlight } from '@atlassian/jira-spotlight/src/ui/jira-spotlight.tsx';
-
-export const OnboardingSpotlightWrapper = () => {
-	const spotlightId = 'some-unique-identifier'
-	const { dark, light } = spotlightImageUrls[spotlightId];
-	const imageUrl = colorMode === 'dark' ? dark : light;
-
-	return (
-		<JiraSpotlight
-			target={spotlightId}
-			targetRadius={3}
-			dialogPlacement=''
-			targetBgColor={token('elevation.surface')}
-			messageId={spotlightId}
-			messageType="transactional"
-			dialogWidth={275}
-		>
-			<CustomSpotlightInner>
-				{imageUrl}
-				{formatMessage(heading)}
-				{formatMessage(body)}
-				<CustomSpotlightAction>
-					{formatMessage(dismiss)}
-				</CustomSpotlightAction>
-			</CustomSpotlightInner>
-		</JiraSpotlight>
-	);
-}
-
-// file2.tsx
-import { SpotlightTarget } from '@atlaskit/onboarding';
-
-const spotlightId = 'some-unique-identifier'
-
-export const SomeFeature = () => {
-	return (
-		<SpotlightTarget name={spotlightId}>
-			// Target code
-		</SpotlightTarget>
-	);
-}
-`,
-    after: `
-// file2.tsx - Spotlight code has been co-located to the targeted element
-import { Text } from '@atlaskit/primitives/compiled';
-import {
-  PopoverContent,
-  PopoverProvider,
-  PopoverTarget,
-  SpotlightActions,
-  SpotlightBody,
-  SpotlightCard,
-  SpotlightControls,
-  SpotlightDismissControl,
-  SpotlightFooter,
-  SpotlightHeader,
-  SpotlightHeadline,
-  SpotlightPrimaryAction,
-} from '@atlaskit/spotlight';
-import Image from '@atlaskit/image';
-import { ChoreographedComponent } from '@atlassian/jira-spotlight/src/ui/ChoreographedComponent.tsx';
-
-export const SomeFeature = () => {
-	const { dark, light } = spotlightImageUrls[spotlightId];
-
-	const [isSpotlightVisible, actions] = useListViewOnboarding({
-		projectId: String(projectData.id),
-		id: spotlightId,
-	});
-
-	return (
-		<PopoverProvider>
-			<PopoverTarget>{renderTrigger(isSpotlightVisible)}</PopoverTarget>
-			<ChoreographedComponent messageId={spotlightId} messageType="transactional">
-				<PopoverContent isVisible={isSpotlightVisible} placement="bottom-start" dismiss={onClick}>
-					<SpotlightCard>
-						<SpotlightHeader>
-							<SpotlightHeadline>{formatMessage(heading)}</SpotlightHeadline>
-							<SpotlightControls>
-								<SpotlightDismissControl />
-							</SpotlightControls>
-						</SpotlightHeader>
-						<SpotlightMedia>
-							<Image src={light} srcDark={dark} alt="" />
-						</SpotlightMedia>
-						<SpotlightBody>
-							<Text>{formatMessage(body)}</Text>
-						</SpotlightBody>
-						<SpotlightFooter>
-							<SpotlightActions>
-								<SpotlightPrimaryAction onClick={onClick}>
-									{formatMessage(dismiss)}
-								</SpotlightPrimaryAction>
-							</SpotlightActions>
-						</SpotlightFooter>
-					</SpotlightCard>
-				</PopoverContent>
-			</ChoreographedComponent>
-		</PopoverProvider>
-	);
-};`,
-    explanation: `Key changes when migrating a single step spotlight:
-- Replace JiraSpotlight with ChoreographedComponent from '@atlassian/jira-spotlight'.
-- PopoverProvider maintains internal Spotlight state.
-- Replace SpotlightTarget with PopoverTarget - wraps the element to highlight
-- Replace Spotlight with PopoverContent containing SpotlightCard - controls visibility and positioning
-- 'heading' becomes SpotlightHeadline inside SpotlightHeader
-- 'actions' becomes SpotlightActions with SpotlightPrimaryAction (and optionally SpotlightSecondaryAction)
-- 'body' content moves into SpotlightBody wrapped with Text component
-- Add SpotlightDismissControl inside SpotlightControls for the close button
-- The 'target' and/or 'targetName' prop is replaced with PopoverTarget directly wrapping the target element
-- 'dialogPlacement' prop becomes 'placement' on PopoverContent. Mapping: "top right" → "top-start", "top center" → "top", "top left" → "top-end", "right bottom" → "right-start", "right middle" → "right-start | right-end", "right top" → "right-end", "bottom left" → "bottom-end", "bottom center" → "bottom", "bottom right" → "bottom-start", "left top" → "left-end", "left middle" → "left-start | left-end", "left bottom" → "left-start"'`
-  }],
-  bestPractices: [],
-  additionalResources
-};
-export const onboardingMultiStep = {
-  id: 'multi-step',
-  title: 'Multi Step Spotlight Tour Migration',
-  description: 'Migrate a multi-step spotlight tour from @atlaskit/onboarding to @atlaskit/spotlight',
-  fromPackage: '@atlaskit/onboarding',
-  toPackage: '@atlaskit/spotlight',
-  examples: [{
-    title: 'Migrate multi step spotlight tour',
-    description: 'Replace the single SpotlightManager pattern with multiple PopoverProvider instances, one for each target in the tour',
-    before: `import React, { useState } from 'react';
-import Button, { IconButton } from '@atlaskit/button/new';
-import CommentAddIcon from '@atlaskit/icon/core/comment-add';
-import CopyIcon from '@atlaskit/icon/core/copy';
-import {
-  Spotlight,
-  SpotlightManager,
-  SpotlightTarget,
-  SpotlightTransition,
-} from '@atlaskit/onboarding';
-
-const OnboardingTour = () => {
-  const [activeSpotlight, setActiveSpotlight] = useState<null | number>(null);
-  const start = () => setActiveSpotlight(0);
-  const next = () => setActiveSpotlight((activeSpotlight || 0) + 1);
-  const back = () => setActiveSpotlight((activeSpotlight || 1) - 1);
-  const end = () => setActiveSpotlight(null);
-
-  const renderActiveSpotlight = () => {
-    const spotlights = [
-      <Spotlight
-        actions={[
-          { onClick: () => next(), text: 'Next' },
-          { onClick: () => end(), text: 'Dismiss', appearance: 'subtle' },
-        ]}
-        heading="Add a comment"
-        target="comment"
-        key="comment"
-      >
-        Quickly add a comment to the work item.
-      </Spotlight>,
-      <Spotlight
-        actions={[
-          { onClick: () => end(), text: 'Done' },
-          { onClick: () => back(), text: 'Back', appearance: 'subtle' },
-        ]}
-        heading="Copy code"
-        target="copy"
-        key="copy"
-      >
-        Click to copy the example code to your clipboard.
-      </Spotlight>,
-    ];
-
-    if (activeSpotlight === null) {
-      return null;
-    }
-    return spotlights[activeSpotlight];
-  };
-
-  return (
-    <SpotlightManager>
-      <SpotlightTarget name="comment">
-        <IconButton icon={CommentAddIcon} label="comment" />
-      </SpotlightTarget>
-      <SpotlightTarget name="copy">
-        <IconButton icon={CopyIcon} label="Copy" />
-      </SpotlightTarget>
-      <Button appearance="primary" onClick={start}>
-        Start tour
-      </Button>
-      <SpotlightTransition>{renderActiveSpotlight()}</SpotlightTransition>
-    </SpotlightManager>
-  );
-};`,
-    after: `import React, { useState } from 'react';
-import Button, { IconButton } from '@atlaskit/button/new';
-import CommentAddIcon from '@atlaskit/icon/core/comment-add';
-import CopyIcon from '@atlaskit/icon/core/copy';
-import { Text } from '@atlaskit/primitives/compiled';
-import {
-  PopoverContent,
-  PopoverProvider,
-  PopoverTarget,
-  SpotlightActions,
-  SpotlightBody,
-  SpotlightCard,
-  SpotlightControls,
-  SpotlightDismissControl,
-  SpotlightFooter,
-  SpotlightHeader,
-  SpotlightHeadline,
-  SpotlightPrimaryAction,
-  SpotlightSecondaryAction,
-  SpotlightStepCount,
-} from '@atlaskit/spotlight';
-
-const SpotlightTour = () => {
-  const [currentStep, setCurrentStep] = useState<number>(0);
-
-  const dismiss = () => setCurrentStep(0);
-  const back = () => setCurrentStep(Math.max(currentStep - 1, 1));
-  const next = () => setCurrentStep(Math.min(currentStep + 1, 2));
-  const done = () => setCurrentStep(0);
-
-  return (
-    <>
-      <PopoverProvider>
-        <PopoverTarget>
-          <IconButton icon={CommentAddIcon} label="comment" />
-        </PopoverTarget>
-        <PopoverContent dismiss={dismiss} placement="bottom-start" isVisible={currentStep === 1}>
-          <SpotlightCard>
-            <SpotlightHeader>
-              <SpotlightHeadline>Add a comment</SpotlightHeadline>
-              <SpotlightControls>
-                <SpotlightDismissControl onClick={dismiss} />
-              </SpotlightControls>
-            </SpotlightHeader>
-            <SpotlightBody>
-              <Text>Quickly add a comment to the work item.</Text>
-            </SpotlightBody>
-            <SpotlightFooter>
-              <SpotlightStepCount>1 of 2</SpotlightStepCount>
-              <SpotlightActions>
-                <SpotlightPrimaryAction onClick={next}>Next</SpotlightPrimaryAction>
-              </SpotlightActions>
-            </SpotlightFooter>
-          </SpotlightCard>
-        </PopoverContent>
-      </PopoverProvider>
-
-      <PopoverProvider>
-        <PopoverTarget>
-          <IconButton icon={CopyIcon} label="Copy" />
-        </PopoverTarget>
-        <PopoverContent dismiss={dismiss} placement="bottom-start" isVisible={currentStep === 2}>
-          <SpotlightCard>
-            <SpotlightHeader>
-              <SpotlightHeadline>Copy code</SpotlightHeadline>
-              <SpotlightControls>
-                <SpotlightDismissControl onClick={dismiss} />
-              </SpotlightControls>
-            </SpotlightHeader>
-            <SpotlightBody>
-              <Text>Click to copy the example code to your clipboard.</Text>
-            </SpotlightBody>
-            <SpotlightFooter>
-              <SpotlightStepCount>2 of 2</SpotlightStepCount>
-              <SpotlightActions>
-                <SpotlightSecondaryAction onClick={back}>Back</SpotlightSecondaryAction>
-                <SpotlightPrimaryAction onClick={done}>Done</SpotlightPrimaryAction>
-              </SpotlightActions>
-            </SpotlightFooter>
-          </SpotlightCard>
-        </PopoverContent>
-      </PopoverProvider>
-
-      <Button appearance="primary" onClick={() => setCurrentStep(1)}>
-        Start tour
-      </Button>
-    </>
-  );
-};`,
-    explanation: `Key changes when migrating a multi-step spotlight tour:
-- SpotlightManager coordinated multiple spotlights in a tour. PopoverProvider manages internal state for a single spotlight.
-- Each target gets its own PopoverProvider > PopoverTarget > PopoverContent structure
-- The spotlight array pattern is replaced with individual SpotlightCard components per target
-- Control visibility with isVisible={currentStep === n} on each PopoverContent
-- Add SpotlightStepCount component in SpotlightFooter to show progress (e.g., "1 of 3")
-- Use SpotlightSecondaryAction for "Back" buttons instead of appearance: 'subtle' in the actions array
-- Use SpotlightPrimaryAction for "Next" and "Done" buttons
-- The renderActiveSpotlight pattern is no longer needed - visibility is controlled declaratively
-- Navigation functions use Math.max/Math.min to bound the step range safely
-- All other migration changes from single step spotlight migration guide apply.`
-  }],
-  bestPractices: ['Use a numeric currentStep state where 0 = hidden, 1+ = active step number', 'Always include SpotlightStepCount in multi-step tours for user orientation', 'First step should only have "Next" action, middle steps have "Back" and "Next", last step has "Back" and "Done"', 'Use SpotlightSecondaryAction for back/dismiss actions and SpotlightPrimaryAction for next/done', 'Include SpotlightDismissControl with onClick={dismiss} so users can exit the tour at any point', 'Bound navigation functions with Math.max/Math.min to prevent invalid step values', 'Preference duplicating Spotlight code instead of trying to have a single `@atlaskit/spotlight` instance that conditionally renders content based on step.'],
-  additionalResources
-};
-export const onboardingWithMotion = {
-  id: 'motion',
-  title: 'Single Step Spotlight with Motion Migration',
-  description: 'Migrate a single step spotlight with entrance animation from @atlaskit/onboarding to @atlaskit/spotlight using @atlaskit/motion',
-  fromPackage: '@atlaskit/onboarding',
-  toPackage: '@atlaskit/spotlight',
-  examples: [{
-    title: 'Migrate spotlight with transition animation',
-    description: 'Replace SpotlightTransition with FadeIn from @atlaskit/motion wrapped around the SpotlightCard',
-    before: `import React, { useState } from 'react';
-import Button from '@atlaskit/button/new';
-import {
-  Spotlight,
-  SpotlightManager,
-  SpotlightTarget,
-  SpotlightTransition,
-} from '@atlaskit/onboarding';
-
-const OnboardingSpotlightWithTransition = () => {
-  const [isSpotlightActive, setIsSpotlightActive] = useState(false);
-  const start = () => setIsSpotlightActive(true);
-  const end = () => setIsSpotlightActive(false);
-
-  return (
-    <SpotlightManager>
-      <SpotlightTarget name="my-target">
-        <Button>Target Element</Button>
-      </SpotlightTarget>
-      <div>
-        <Button appearance="primary" onClick={start}>
-          Show spotlight
-        </Button>
-      </div>
-      <SpotlightTransition>
-        {isSpotlightActive && (
-          <Spotlight
-            actions={[
-              {
-                onClick: end,
-                text: 'Got it',
-              },
-            ]}
-            heading="Feature Heading"
-            target="my-target"
-            key="my-target"
-          >
-            This is the spotlight body content describing the feature.
-          </Spotlight>
-        )}
-      </SpotlightTransition>
-    </SpotlightManager>
-  );
-};`,
-    after: `import React, { useState } from 'react';
-import Button from '@atlaskit/button/new';
-import { FadeIn } from '@atlaskit/motion';
-import { Text } from '@atlaskit/primitives/compiled';
-import {
-  PopoverContent,
-  PopoverProvider,
-  PopoverTarget,
-  SpotlightActions,
-  SpotlightBody,
-  SpotlightCard,
-  SpotlightControls,
-  SpotlightDismissControl,
-  SpotlightFooter,
-  SpotlightHeader,
-  SpotlightHeadline,
-  SpotlightPrimaryAction,
-} from '@atlaskit/spotlight';
-
-const SpotlightWithMotion = () => {
-  const [isVisible, setIsVisible] = useState(false);
-  const dismiss = () => setIsVisible(false);
-  const done = () => setIsVisible(false);
-
-  return (
-    <PopoverProvider>
-      <PopoverTarget>
-        <Button onClick={() => setIsVisible(true)}>Target Element</Button>
-      </PopoverTarget>
-      <PopoverContent done={done} dismiss={dismiss} placement="bottom-start" isVisible={isVisible}>
-        <FadeIn entranceDirection="left">
-          {(props) => (
-            <div {...props}>
-              <SpotlightCard>
-                <SpotlightHeader>
-                  <SpotlightHeadline>Feature Heading</SpotlightHeadline>
-                  <SpotlightControls>
-                    <SpotlightDismissControl />
-                  </SpotlightControls>
-                </SpotlightHeader>
-                <SpotlightBody>
-                  <Text>This is the spotlight body content describing the feature.</Text>
-                </SpotlightBody>
-                <SpotlightFooter>
-                  <SpotlightActions>
-                    <SpotlightPrimaryAction onClick={done}>Got it</SpotlightPrimaryAction>
-                  </SpotlightActions>
-                </SpotlightFooter>
-              </SpotlightCard>
-            </div>
-          )}
-        </FadeIn>
-      </PopoverContent>
-    </PopoverProvider>
-  );
-};`,
-    explanation: `Key changes when migrating a spotlight with transition animation:
-- Replace SpotlightTransition with FadeIn from @atlaskit/motion
-- Import FadeIn from '@atlaskit/motion' instead of SpotlightTransition from '@atlaskit/onboarding'
-- FadeIn uses a render props pattern - wrap content in {(props) => <div {...props}>...</div>}
-- The entranceDirection prop controls animation direction: 'left', 'right', 'top', or 'bottom'
-- All other migration changes from single step spotlight apply (PopoverProvider, compositional components, etc.)`
-  }],
-  bestPractices: ['Choose entranceDirection based on spotlight placement (e.g., "left" for right-placed spotlights)', 'Motion is optional - only add if the original onboarding spotlight used SpotlightTransition for entrance effects'],
-  additionalResources
-};