@atlaskit/ads-mcp 1.0.0 → 1.2.0

package/dist/es2019/tools/get-all-components/types.js

@@ -0,0 +1 @@
+export {};

package/dist/es2019/tools/get-atlaskit-components/atlaskit-components.codegen.js

@@ -3,7 +3,7 @@
  *
  * Structured content components from design-system *.docs.tsx files
  *
- * @codegen <<SignedSource::bd5b86ae65b6b9e48b637d6a463db4f9>>
+ * @codegen <<SignedSource::c074026b3760583a882b411542329528>>
  * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:atlaskit-components
  */
 /* eslint-disable @repo/internal/react/boolean-prop-naming-convention -- not our types */
@@ -250,6 +250,9 @@ export const atlaskitComponents = [{
   }, {
     name: 'insertMenuItems',
     type: 'MenuItem[]'
+  }, {
+    name: 'isEditorModernisationEnabled',
+    type: 'boolean'
   }, {
     name: 'legacyImageUploadProvider',
     type: 'Promise<ImageUploadProvider>'
@@ -408,7 +411,7 @@ export const atlaskitComponents = [{
   examples: ["import applyDevTools from 'prosemirror-dev-tools';\nimport { ComposableEditor } from '@atlaskit/editor-core/composable-editor';\nimport { usePreset } from '@atlaskit/editor-core/use-preset';\nimport { analyticsPlugin } from '@atlaskit/editor-plugins/analytics';\nimport { annotationPlugin } from '@atlaskit/editor-plugins/annotation';\nimport type { AnnotationProviders } from '@atlaskit/editor-plugins/annotation';\nimport { basePlugin } from '@atlaskit/editor-plugins/base';\nimport { blockControlsPlugin } from '@atlaskit/editor-plugins/block-controls';\nimport { blockTypePlugin } from '@atlaskit/editor-plugins/block-type';\nimport { breakoutPlugin } from '@atlaskit/editor-plugins/breakout';\nimport { codeBlockPlugin } from '@atlaskit/editor-plugins/code-block';\nimport { compositionPlugin } from '@atlaskit/editor-plugins/composition';\nimport { contentInsertionPlugin } from '@atlaskit/editor-plugins/content-insertion';\nimport { copyButtonPlugin } from '@atlaskit/editor-plugins/copy-button';\nimport { decorationsPlugin } from '@atlaskit/editor-plugins/decorations';\nimport { editorDisabledPlugin } from '@atlaskit/editor-plugins/editor-disabled';\nimport { emojiPlugin } from '@atlaskit/editor-plugins/emoji';\nimport { expandPlugin } from '@atlaskit/editor-plugins/expand';\nimport { extensionPlugin } from '@atlaskit/editor-plugins/extension';\nimport { floatingToolbarPlugin } from '@atlaskit/editor-plugins/floating-toolbar';\nimport { focusPlugin } from '@atlaskit/editor-plugins/focus';\nimport { gridPlugin } from '@atlaskit/editor-plugins/grid';\nimport { guidelinePlugin } from '@atlaskit/editor-plugins/guideline';\nimport { layoutPlugin } from '@atlaskit/editor-plugins/layout';\nimport { listPlugin } from '@atlaskit/editor-plugins/list';\nimport { mediaPlugin } from '@atlaskit/editor-plugins/media';\nimport { panelPlugin } from '@atlaskit/editor-plugins/panel';\nimport { quickInsertPlugin } from '@atlaskit/editor-plugins/quick-insert';\nimport { rulePlugin } from '@atlaskit/editor-plugins/rule';\nimport { selectionPlugin } from '@atlaskit/editor-plugins/selection';\nimport { selectionToolbarPlugin } from '@atlaskit/editor-plugins/selection-toolbar';\nimport { tablesPlugin } from '@atlaskit/editor-plugins/table';\nimport { tasksAndDecisionsPlugin } from '@atlaskit/editor-plugins/tasks-and-decisions';\nimport { textFormattingPlugin } from '@atlaskit/editor-plugins/text-formatting';\nimport { typeAheadPlugin } from '@atlaskit/editor-plugins/type-ahead';\nimport { widthPlugin } from '@atlaskit/editor-plugins/width';\nimport { defaultValue } from './default-value';\nexport default function Editor(): React.JSX.Element {\n\tconst { preset } = usePreset((builder) =>\n\t\tbuilder\n\t\t\t.add(basePlugin)\n\t\t\t.add(blockTypePlugin)\n\t\t\t.add(focusPlugin)\n\t\t\t.add(typeAheadPlugin)\n\t\t\t.add(quickInsertPlugin)\n\t\t\t.add(selectionPlugin)\n\t\t\t.add(decorationsPlugin)\n\t\t\t.add(layoutPlugin)\n\t\t\t.add(listPlugin)\n\t\t\t.add([analyticsPlugin, {}])\n\t\t\t.add(contentInsertionPlugin)\n\t\t\t.add(widthPlugin)\n\t\t\t.add(guidelinePlugin)\n\t\t\t.add(textFormattingPlugin)\n\t\t\t.add([\n\t\t\t\ttablesPlugin,\n\t\t\t\t{\n\t\t\t\t\ttableOptions: {\n\t\t\t\t\t\tadvanced: true,\n\t\t\t\t\t\tallowColumnResizing: true,\n\t\t\t\t\t\tallowHeaderRow: true,\n\t\t\t\t\t\tallowTableResizing: true,\n\t\t\t\t\t},\n\t\t\t\t\tisTableScalingEnabled: true,\n\t\t\t\t\tallowContextualMenu: true,\n\t\t\t\t\tfullWidthEnabled: true,\n\t\t\t\t},\n\t\t\t])\n\t\t\t.add(emojiPlugin)\n\t\t\t.add(panelPlugin)\n\t\t\t.add(rulePlugin)\n\t\t\t.add(tasksAndDecisionsPlugin)\n\t\t\t.add([expandPlugin, { allowInsertion: true, appearance: 'full-page' }])\n\t\t\t.add(editorDisabledPlugin)\n\t\t\t.add(copyButtonPlugin)\n\t\t\t.add(compositionPlugin)\n\t\t\t.add(codeBlockPlugin)\n\t\t\t.add(blockControlsPlugin)\n\t\t\t.add(breakoutPlugin)\n\t\t\t.add(gridPlugin)\n\t\t\t.add(floatingToolbarPlugin)\n\t\t\t.add([selectionToolbarPlugin, { preferenceToolbarAboveSelection: true }])\n\t\t\t.add([\n\t\t\t\tmediaPlugin,\n\t\t\t\t{\n\t\t\t\t\tallowMediaSingle: { disableLayout: true },\n\t\t\t\t\tallowMediaGroup: false,\n\t\t\t\t\tallowResizing: true,\n\t\t\t\t\tisCopyPasteEnabled: true,\n\t\t\t\t\tallowBreakoutSnapPoints: true,\n\t\t\t\t\tallowAdvancedToolBarOptions: true,\n\t\t\t\t\tallowDropzoneDropLine: true,\n\t\t\t\t\tallowMediaSingleEditable: true,\n\t\t\t\t\tallowImagePreview: true,\n\t\t\t\t\tfullWidthEnabled: true,\n\t\t\t\t\twaitForMediaUpload: true,\n\t\t\t\t},\n\t\t\t])\n\t\t\t.add([\n\t\t\t\tannotationPlugin,\n\t\t\t\t{\n\t\t\t\t\tinlineComment: {},\n\t\t\t\t} as AnnotationProviders,\n\t\t\t])\n\t\t\t.add(extensionPlugin),\n\t);\n\treturn (\n\t\t<ComposableEditor\n\t\t\tappearance=\"full-page\"\n\t\t\tonEditorReady={(editorAction) => {\n\t\t\t\teditorAction.replaceDocument(defaultValue);\n\t\t\t}}\n\t\t\tonChange={(view) => {\n\t\t\t\tapplyDevTools(view);\n\t\t\t}}\n\t\t\tpreset={preset}\n\t\t/>\n\t);\n}"],
   props: [{
     name: 'api',
-    type: '{ blockControls: BasePluginDependenciesAPI<{ actions: { registerNodeDecoration: (factory: NodeDecorationFactory) => void; unregisterNodeDecoration: (type: string) => void; }; commands: { ...; }; dependencies: BlockControlsPluginDependencies; pluginConfiguration?: BlockControlsPluginConfig; sharedState: { ...; }; }>;...'
+    type: '{ blockControls: BasePluginDependenciesAPI<{ actions: { getTextInfo: (editorView: EditorView) => { textContent: string; textLength: number; }; registerNodeDecoration: (factory: NodeDecorationFactory) => void; unregisterNodeDecoration: (type: string) => void; }; commands: { ...; }; dependencies: BlockControlsPluginDe...'
   }, {
     name: 'config',
     type: '{ quickInsertButtonEnabled?: boolean; rightSideControlsEnabled?: boolean; }',
@@ -675,6 +678,14 @@ export const atlaskitComponents = [{
     name: 'portalProviderAPI',
     type: 'PortalProviderAPI',
     isRequired: true
+  }, {
+    name: 'prebuiltEditorState',
+    type: 'EditorState',
+    description: "Pre-built EditorState from ReactEditorView's ssrDeps.\nWhen provided, skips internal EditorState creation to avoid double work."
+  }, {
+    name: 'prebuiltPMPlugins',
+    type: 'SafePlugin<any>[]',
+    description: "Pre-built SafePlugins from ReactEditorView's ssrDeps.\nWhen provided, skips internal PM plugin creation to avoid double work."
   }, {
     name: 'schema',
     type: 'Schema<any, any>',
@@ -827,6 +838,10 @@ export const atlaskitComponents = [{
   }, {
     name: 'onColumnResize',
     type: '(key: string, width: number) => void'
+  }, {
+    name: 'onColumnSort',
+    type: '(key: string) => void',
+    description: 'Callback to be invoked whenever a user sorts a datasource table by a column.'
   }, {
     name: 'onVisibleColumnKeysChange',
     type: '(visibleColumnKeys: string[]) => void',
@@ -844,6 +859,9 @@ export const atlaskitComponents = [{
     name: 'scrollableContainerHeight',
     type: 'number',
     description: 'If this number is set it will restrict (max-height) maximum size of the component AND make main container a scrollable container.\nIt this number is 0 it will not restrict height and not make container scrollable.'
+  }, {
+    name: 'sortState',
+    type: '{ direction: DatasourceTableSortDirection; key: string; }'
   }, {
     name: 'url',
     type: 'string',
@@ -947,6 +965,10 @@ export const atlaskitComponents = [{
     name: 'customMessages',
     type: '{ linkLabel?: MessageDescriptor; linkAriaLabel?: MessageDescriptor; linkPlaceholder?: MessageDescriptor; linkTextLabel?: MessageDescriptor; linkTextPlaceholder?: MessageDescriptor; linkHelperTextLabel?: MessageDescriptor; submitButtonLabel?: MessageDescriptor; }',
     description: 'Allows for customisation of text in the link picker.'
+  }, {
+    name: 'disableManualUrlInsert',
+    type: 'boolean',
+    description: 'When true, disables the Insert button when the user has manually typed a URL but no search\nresult has been selected. This prevents inserting external/manual links when only\nresult-based links are desired.'
   }, {
     name: 'disableWidth',
     type: 'boolean',
@@ -1069,6 +1091,9 @@ export const atlaskitComponents = [{
   }, {
     name: 'allowCustomPanels',
     type: 'boolean'
+  }, {
+    name: 'allowDownloadCodeBlock',
+    type: 'boolean'
   }, {
     name: 'allowFixedColumnWidthOption',
     type: 'boolean'
@@ -1146,6 +1171,10 @@ export const atlaskitComponents = [{
   }, {
     name: 'getExtensionHeight',
     type: '(node: PMNode) => string'
+  }, {
+    name: 'headingIdPrefix',
+    type: 'string',
+    description: 'Optional prefix to prepend to all generated heading IDs.\nUsed by nested renderers to namespace heading IDs and avoid collisions with the host page.'
   }, {
     name: 'includeNodesCountInStats',
     type: 'boolean'
@@ -1312,8 +1341,8 @@ export const atlaskitComponents = [{
     description: 'Show selected state of smart link.'
   }, {
     name: 'onClick',
-    type: '(event: MouseEvent<Element, globalThis.MouseEvent> | KeyboardEvent<Element>) => void',
-    description: 'A callback function after a link is clicked.'
+    type: '(event: MouseEvent<Element, globalThis.MouseEvent> | KeyboardEvent<Element>, data?: OnClickData) => void',
+    description: 'A callback function triggered when a Smart Link is clicked.\n\nWhen defined, the default browser navigation is prevented and your handler\nis responsible for navigation — except for Flexible Card, which always opens\nthe link and then calls the callback.\n\nThe optional second argument `data` provides additional context about the click:\n- `data.destinationUrl` — the resolved URL Smart Link will navigate to.\n  This may differ from the original `url` prop if Smart Link resolved a\n  preferred URL from metadata or appended analytics parameters.\n- `data.url` — the original `url` prop passed to the component.\n\n@example\n// Basic usage\nonClick={(e) => { e.preventDefault(); window.location.href = myUrl; }}\n\n// With destination URL\nonClick={(e, data) => { navigate(data?.destinationUrl ?? url); }}'
   }, {
     name: 'onError',
     type: '(data: { err?: Error; status: "errored" | "fallback" | "unauthorized" | "forbidden" | "not_found"; url: string; }) => void',
@@ -1767,8 +1796,8 @@ export const atlaskitComponents = [{
     description: 'Show selected state of smart link.'
   }, {
     name: 'onClick',
-    type: '(event: MouseEvent<Element, MouseEvent> | KeyboardEvent<Element>) => void',
-    description: 'A callback function after a link is clicked.'
+    type: '(event: MouseEvent<Element, MouseEvent> | KeyboardEvent<Element>, data?: OnClickData) => void',
+    description: 'A callback function triggered when a Smart Link is clicked.\n\nWhen defined, the default browser navigation is prevented and your handler\nis responsible for navigation — except for Flexible Card, which always opens\nthe link and then calls the callback.\n\nThe optional second argument `data` provides additional context about the click:\n- `data.destinationUrl` — the resolved URL Smart Link will navigate to.\n  This may differ from the original `url` prop if Smart Link resolved a\n  preferred URL from metadata or appended analytics parameters.\n- `data.url` — the original `url` prop passed to the component.\n\n@example\n// Basic usage\nonClick={(e) => { e.preventDefault(); window.location.href = myUrl; }}\n\n// With destination URL\nonClick={(e, data) => { navigate(data?.destinationUrl ?? url); }}'
   }, {
     name: 'onError',
     type: '(data: { err?: Error; status: "errored" | "fallback" | "unauthorized" | "forbidden" | "not_found"; url: string; }) => void',

package/dist/es2019/tools/get-atlaskit-hooks/atlaskit-hooks.codegen.js

@@ -0,0 +1,200 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Structured content hooks from design-system *.docs.tsx files
+ *
+ * @codegen <<SignedSource::54db052ad53f695704ea4e9666a1ee4d>>
+ * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:atlaskit-hooks
+ */
+/* eslint-disable @repo/internal/react/boolean-prop-naming-convention -- not our types */
+
+export const atlaskitHooks = [{
+  name: 'useAnalyticsEvents',
+  description: 'Returns `createAnalyticsEvent`, a stable callback that produces a `UIAnalyticsEvent` pre-wired with the surrounding analytics context and handlers. Call `.fire(channel)` on the returned event to dispatch it.',
+  status: 'general-availability',
+  usageGuidelines: ['Use inside any component that needs to fire events. Always pair with a parent `AnalyticsListener`, otherwise events fire into the void.', 'Build the payload with the smallest information the listener needs — heavy serialisation belongs in the handler, not the call site.'],
+  keywords: ['analytics', 'hook', 'useAnalyticsEvents', 'analytics-next'],
+  category: 'analytics',
+  parameters: [],
+  returns: {
+    type: '{ createAnalyticsEvent: (payload: AnalyticsEventPayload) => UIAnalyticsEvent }',
+    description: '`createAnalyticsEvent` is referentially stable per nearest `AnalyticsContext`, so it is safe to put in dependency arrays.'
+  },
+  package: '@atlaskit/analytics-next',
+  examples: ["import React, { type FC, type MouseEvent, useCallback } from 'react';\nimport {\n\tAnalyticsListener,\n\ttype UIAnalyticsEvent,\n\tuseAnalyticsEvents,\n\tuseCallbackWithAnalytics,\n\tusePlatformLeafEventHandler,\n\twithAnalyticsEvents,\n\ttype WithAnalyticsEventsProps,\n} from '../src';\ninterface Props extends WithAnalyticsEventsProps {\n\tchildren: React.ReactNode;\n\tonClick: (e: MouseEvent<HTMLButtonElement>) => void;\n}\nconst ButtonBase = ({ createAnalyticsEvent, onClick, ...rest }: Props) => {\n\tconst handleClick = useCallback(\n\t\t(e: MouseEvent<HTMLButtonElement>) => {\n\t\t\t// Create our analytics event\n\t\t\tconst analyticsEvent = createAnalyticsEvent!({\n\t\t\t\taction: 'click',\n\t\t\t});\n\t\t\t// Fire our analytics event on the 'atlaskit' channel\n\t\t\tanalyticsEvent.fire('atlaskit');\n\t\t\tif (onClick) {\n\t\t\t\tonClick(e);\n\t\t\t}\n\t\t},\n\t\t[onClick, createAnalyticsEvent],\n\t);\n\treturn <button {...rest} onClick={handleClick} />;\n};\nconst Button = withAnalyticsEvents()(ButtonBase);\nconst ButtonUsingHook: FC<Props> = ({ onClick, ...props }) => {\n\t// Decompose function from the hook\n\tconst { createAnalyticsEvent } = useAnalyticsEvents();\n\tconst handleClick = useCallback(\n\t\t(e: MouseEvent<HTMLButtonElement>) => {\n\t\t\t// Create our analytics event\n\t\t\tconst analyticsEvent = createAnalyticsEvent({ action: 'click' });\n\t\t\t// Fire our analytics event\n\t\t\tanalyticsEvent.fire('atlaskit');\n\t\t\tif (onClick) {\n\t\t\t\tonClick(e);\n\t\t\t}\n\t\t},\n\t\t[onClick, createAnalyticsEvent],\n\t);\n\treturn <button {...props} onClick={handleClick} />;\n};\nconst ButtonUsingCallback: FC<Props> = ({ onClick, ...props }) => {\n\tconst handleClick = useCallbackWithAnalytics(onClick, { action: 'click' }, 'atlaskit');\n\treturn <button {...props} onClick={handleClick} />;\n};\nconst ButtonUsingEventHandlerHook = ({\n\tonClick,\n\tchildren,\n}: {\n\tchildren: React.ReactNode;\n\tonClick: (\n\t\tmouseEvent: React.MouseEvent<HTMLButtonElement>,\n\t\tanalyticsEvent: UIAnalyticsEvent,\n\t) => void;\n}) => {\n\tconst handleClick = usePlatformLeafEventHandler({\n\t\tfn: onClick,\n\t\taction: 'clicked',\n\t\tcomponentName: 'fancy-button',\n\t\tpackageName: '@atlaskit/fancy-button',\n\t\tpackageVersion: '0.1.0',\n\t});\n\treturn <button onClick={handleClick}>{children}</button>;\n};\nconst App: FC = () => {\n\tconst handleEvent = (analyticsEvent: UIAnalyticsEvent) => {\n\t\tconst { payload, context } = analyticsEvent;\n\t\tconsole.log('Received event:', { payload, context });\n\t};\n\tconst onClickHandler = () => console.log('onClickCallback');\n\treturn (\n\t\t<AnalyticsListener channel=\"atlaskit\" onEvent={handleEvent}>\n\t\t\t<Button onClick={onClickHandler}>Click me (withAnalyticsEvents)</Button>\n\t\t\t<br />\n\t\t\t<ButtonUsingHook onClick={onClickHandler}>Click me (useAnalyticsEvents)</ButtonUsingHook>\n\t\t\t<br />\n\t\t\t<ButtonUsingCallback onClick={onClickHandler}>\n\t\t\t\tClick me (useCallbackWithAnalytics)\n\t\t\t</ButtonUsingCallback>\n\t\t\t<br />\n\t\t\t<ButtonUsingEventHandlerHook onClick={onClickHandler}>\n\t\t\t\tClick me (usePlatformLeafEventHandler)\n\t\t\t</ButtonUsingEventHandlerHook>\n\t\t</AnalyticsListener>\n\t);\n};\nexport default App;"]
+}, {
+  name: 'useCloseOnEscapePress',
+  description: 'Calls `onClose` when the Escape key is pressed and this layer is currently on top of the layering tree. Layers covered by a deeper layer are skipped, so Escape closes the topmost surface first.',
+  status: 'general-availability',
+  usageGuidelines: ['Mount inside the component that owns the surface (modal body, popup body, drawer body). Wrap that component in `<Layering>` or it will not receive layer information.', 'Do not pair with a second top-level Escape listener — the hook already coordinates dismissal across stacked layers.'],
+  accessibilityGuidelines: ['Escape-to-close is the expected dismissal pattern for overlay surfaces (WAI-ARIA Authoring Practices). Always wire it up alongside an explicit close button.'],
+  keywords: ['layering', 'hook', 'useCloseOnEscapePress', 'escape', 'dismiss'],
+  category: 'layering',
+  parameters: [{
+    name: 'options',
+    type: '{ onClose: (e: KeyboardEvent) => void; isDisabled?: boolean }',
+    description: '`onClose` runs on the first Escape keydown per press. Set `isDisabled` to opt out without unmounting the hook (for example, when the surface is mounted but in a non-closable state).'
+  }],
+  returns: {
+    type: 'void'
+  },
+  package: '@atlaskit/layering',
+  examples: []
+}, {
+  name: 'useInterval',
+  description: 'Declarative wrapper around `setInterval`. Re-runs the latest `callback` every `delay` milliseconds and clears the timer on unmount or when `delay` changes. Passing `null` for `delay` pauses the timer without unmounting the hook.',
+  status: 'general-availability',
+  usageGuidelines: ['Use for polling, ticking clocks, or any callback that needs to fire on a fixed cadence inside a React component.', 'Pass `null` for `delay` to pause — do not unmount the component just to stop the timer.', 'The callback is captured by ref, so referencing the latest props/state in it does not require putting them in any dependency array.'],
+  keywords: ['hook', 'useInterval', 'setInterval', 'polling', 'frontend-utilities'],
+  category: 'hooks',
+  parameters: [{
+    name: 'callback',
+    type: '() => void',
+    description: 'Function to run on each tick. The hook keeps a ref to the latest callback, so changing it does not reset the interval.'
+  }, {
+    name: 'delay',
+    type: 'number | null',
+    description: 'Interval in milliseconds. Pass `null` to pause the timer.'
+  }],
+  returns: {
+    type: 'void'
+  },
+  package: '@atlaskit/frontend-utilities',
+  examples: []
+}, {
+  name: 'useLayering',
+  description: 'Returns information about the current layer in the layering tree: the layer depth, a check for whether this layer is currently disabled (i.e. not on top), and the top-most depth in the tree.',
+  status: 'general-availability',
+  usageGuidelines: ['Use inside a layered surface to gate behaviour that should only run for the top-most layer (for example, registering global keyboard listeners or auto-focusing content).', 'Prefer `useCloseOnEscapePress` for the common case of closing on Escape — only reach for `useLayering` when you need raw level info.'],
+  keywords: ['layering', 'hook', 'useLayering', 'top-layer'],
+  category: 'layering',
+  parameters: [],
+  returns: {
+    type: '{ currentLevel: number; isLayerDisabled: () => boolean; getTopLevel: () => number | null }',
+    description: '`currentLevel` is the depth of the calling layer. `isLayerDisabled()` returns true when a deeper layer is currently on top. `getTopLevel()` returns the deepest registered layer, or `null` if no layers are mounted.'
+  },
+  package: '@atlaskit/layering',
+  examples: []
+}, {
+  name: 'useLocalStorage',
+  description: '`useState`-shaped wrapper around `window.localStorage` with built-in JSON serialisation and a wrapper that survives the storage being unavailable (e.g. private browsing modes that throw). Persists `value` under `key` and rehydrates it on mount.',
+  status: 'general-availability',
+  usageGuidelines: ['Use for user-scoped preferences that should survive a page refresh (collapsed sidebar state, last-used view, etc.).', 'Do not store secrets or large blobs — `localStorage` is plaintext and capped at ~5 MB per origin.', 'Values are JSON-serialised; non-serialisable values (functions, `Symbol`, circular refs) will be lost on rehydrate.'],
+  keywords: ['hook', 'useLocalStorage', 'storage', 'persistence', 'frontend-utilities'],
+  category: 'hooks',
+  parameters: [{
+    name: 'key',
+    type: 'string',
+    description: 'Storage key. Changing the key swaps the underlying storage entry.'
+  }, {
+    name: 'defaultValue',
+    type: 'T',
+    description: 'Returned (and persisted) when nothing is stored under `key` yet.'
+  }],
+  returns: {
+    type: '[value: T, setValue: (value: T) => void]',
+    description: 'A React-style tuple. `setValue` writes both to component state and to local storage.'
+  },
+  package: '@atlaskit/frontend-utilities',
+  examples: []
+}, {
+  name: 'useLocalStorageRecord',
+  description: 'Persistent bounded log built on top of `useLocalStorage`. Stores up to `maxLength` items keyed by stringified equality and exposes `putRecord` / `removeRecord` actions for append-only collections like recent searches.',
+  status: 'general-availability',
+  usageGuidelines: ['Use for capped histories (recent searches, recently visited items, undo stacks).', '`removeRecord(query)` matches by JSON-stringified inclusion, not by identity — pass a stable substring of the record to remove.', 'Equality is structural via `JSON.stringify`: pushing a record that stringifies the same as an existing one is a no-op.'],
+  keywords: ['hook', 'useLocalStorageRecord', 'history', 'storage', 'frontend-utilities'],
+  category: 'hooks',
+  parameters: [{
+    name: 'key',
+    type: 'string',
+    description: 'Local storage key used to persist the list.'
+  }, {
+    name: 'initialValue',
+    type: 'T[]',
+    description: 'Initial list contents when nothing is stored yet.',
+    defaultValue: '[]',
+    isOptional: true
+  }, {
+    name: 'maxLength',
+    type: 'number',
+    description: 'Cap on stored records. Once reached, the oldest entry is dropped on the next `putRecord`. Pass `0` to disable the cap.',
+    defaultValue: '100',
+    isOptional: true
+  }],
+  returns: {
+    type: '{ records: T[]; actions: { putRecord: (record: T) => void; removeRecord: (query: string) => void } }',
+    description: '`actions` are NOT referentially stable — wrap in `useCallback` if you put them in dependency arrays.'
+  },
+  package: '@atlaskit/frontend-utilities',
+  examples: []
+}, {
+  name: 'usePrevious',
+  description: 'Returns the previous render-cycle value of `value`. On the first render the hook returns `undefined`; subsequent renders return the value supplied on the prior render.',
+  status: 'general-availability',
+  usageGuidelines: ['Use for change-detection effects — e.g. firing analytics only when a prop transitions from one value to another.', 'Do not store derived state in `usePrevious`; prefer a `useEffect` that mirrors the change you care about.', '`undefined` on the first render is intentional — initialise downstream logic to handle that case.'],
+  keywords: ['hook', 'usePrevious', 'previous-value', 'frontend-utilities'],
+  category: 'hooks',
+  parameters: [{
+    name: 'value',
+    type: 'T',
+    description: 'The value to track across renders.'
+  }],
+  returns: {
+    type: 'T | undefined',
+    description: '`undefined` on the first render, otherwise the value passed on the previous render.'
+  },
+  package: '@atlaskit/frontend-utilities',
+  examples: []
+}, {
+  name: 'useWhyDidUpdate',
+  description: 'Development-only debug hook that logs which dependencies changed since the previous render, using deep equality (`lodash.isEqual`). Useful for diagnosing unexpected re-renders when the data inside a prop looks identical but the reference changed.',
+  status: 'general-availability',
+  usageGuidelines: ['Use locally while debugging; remove before shipping. The hook short-circuits in production (`NODE_ENV === "production"`) but the import and call still ship.', 'Pass the same array shape you would pass to `useEffect` deps for the comparison to mean anything.', "Prefer `useWhyDidUpdateShallow` when you want to mirror React's own re-render trigger."],
+  keywords: ['hook', 'useWhyDidUpdate', 'debug', 'rerender', 'frontend-utilities'],
+  category: 'hooks',
+  parameters: [{
+    name: 'name',
+    type: 'string',
+    description: 'Label printed in the console log (typically the component name).'
+  }, {
+    name: 'deps',
+    type: 'any[]',
+    description: 'Dependency array to compare across renders.'
+  }, {
+    name: 'depsNames',
+    type: 'string[]',
+    description: 'Optional per-dependency labels for the log output. Falls back to `dep_<index>`.',
+    isOptional: true
+  }],
+  returns: {
+    type: 'void'
+  },
+  package: '@atlaskit/frontend-utilities',
+  examples: []
+}, {
+  name: 'useWhyDidUpdateShallow',
+  description: 'Variant of `useWhyDidUpdate` that compares dependencies with `Object.is` (shallow / reference equality) — the same comparison React itself uses to decide whether to re-render. Useful when you want to find out which prop is changing identity from one render to the next.',
+  status: 'general-availability',
+  usageGuidelines: ['Reach for this hook first when chasing "why is this re-rendering" — it matches React\'s own equality semantics. Drop to `useWhyDidUpdate` only when you suspect the content changed but the reference did not.', 'Same production-stripping behaviour as `useWhyDidUpdate` — log calls are no-ops in prod builds.'],
+  keywords: ['hook', 'useWhyDidUpdateShallow', 'debug', 'rerender', 'frontend-utilities'],
+  category: 'hooks',
+  parameters: [{
+    name: 'name',
+    type: 'string',
+    description: 'Label printed in the console log (typically the component name).'
+  }, {
+    name: 'deps',
+    type: 'any[]',
+    description: 'Dependency array to compare across renders.'
+  }, {
+    name: 'depsNames',
+    type: 'string[]',
+    description: 'Optional per-dependency labels for the log output.',
+    isOptional: true
+  }],
+  returns: {
+    type: 'void'
+  },
+  package: '@atlaskit/frontend-utilities',
+  examples: []
+}];

package/dist/es2019/tools/get-atlaskit-hooks/get-atlaskit-hooks-tool.js

@@ -0,0 +1,14 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+import { atlaskitHooks } from './atlaskit-hooks.codegen';
+export const getAtlaskitHooksTool = async () => {
+  const hooks = atlaskitHooks.map(hook => ({
+    name: hook.name,
+    package: hook.package
+  }));
+  return {
+    content: [{
+      type: 'text',
+      text: JSON.stringify(hooks, null, 2)
+    }]
+  };
+};

package/dist/es2019/tools/get-atlaskit-hooks/list-get-atlaskit-hooks-tool.js

@@ -0,0 +1,21 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { z } from 'zod';
+import { zodToJsonSchema } from '../../helpers';
+export const listGetAtlaskitHooksTool = {
+  name: 'atlaskit_get_hooks',
+  description: `Returns the names and packages of all atlaskit hooks excluding hooks covered by the Atlassian Design System.
+
+WHEN TO USE:
+Use this when you want to see what hooks are available without the full metadata payload.
+
+No parameters.`,
+  annotations: {
+    title: 'Get all Atlaskit hooks',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(z.object({}))
+};

package/dist/es2019/tools/get-atlaskit-hooks/types.js

@@ -0,0 +1 @@
+export {};