@atlaskit/ads-mcp 1.12.0 → 1.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,7 +9,7 @@ exports.atlaskitHooks = void 0;
9
9
  *
10
10
  * Structured content hooks from design-system *.docs.tsx files
11
11
  *
12
- * @codegen <<SignedSource::569e2db73fed31893c8123b061d19745>>
12
+ * @codegen <<SignedSource::32cbac9200091bcd2203fac2c2bc0734>>
13
13
  * @codegenCommand afm workspace @af/ads-ai-tooling codegen
14
14
  */
15
15
  /* eslint-disable @repo/internal/react/boolean-prop-naming-convention -- not our types */
@@ -1065,6 +1065,54 @@ var atlaskitHooks = exports.atlaskitHooks = [{
1065
1065
  },
1066
1066
  package: '@atlassian/jira-create-work-items',
1067
1067
  examples: []
1068
+ }, {
1069
+ name: 'useCloseCurrentPanel',
1070
+ description: 'For internal Atlassian use only: Get a callback that closes the current panel inside LayoutWithPanel or PanelsRenderer. Internal Atlassian package; not available for use outside Atlassian.',
1071
+ status: 'open-beta',
1072
+ keywords: ['panel', 'context', 'state', 'close', 'open'],
1073
+ category: 'layout',
1074
+ package: '@atlassian/panel-system',
1075
+ examples: ["import Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { PanelLayout } from '@atlaskit/navigation-system/layout/panel-layout';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { PanelActionClose } from '@atlassian/panel-system/panel-action/close';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { useCloseCurrentPanel, useCurrentPanel } from '@atlassian/panel-system/panel-context';\nimport { PanelDisclaimer } from '@atlassian/panel-system/panel-disclaimer';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelManager } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelRouter } from '@atlassian/panel-system/panel-router';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { PanelsRenderer } from '@atlassian/panel-system/panels-renderer';\nfunction ProjectSummary() {\n\tconst panel = useCurrentPanel<{ summary: string }>();\n\tconst closePanel = useCloseCurrentPanel();\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Project summary</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionClose label=\"Close project summary\" onClick={closePanel} />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Text as=\"p\">{panel.params.summary}</Text>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter\n\t\t\t\tdisclaimer={\n\t\t\t\t\t<PanelDisclaimer>AI-generated content. Verify important details.</PanelDisclaimer>\n\t\t\t\t}\n\t\t\t>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst { state, manager } = usePanelManager();\n\treturn (\n\t\t<PanelLayout\n\t\t\tisPanelOpen={state.activePanel !== null}\n\t\t\tpanelKey={state.activePanel?.instanceId}\n\t\t\tpanelLabel=\"Project summary\"\n\t\t\tresizeLabel=\"Resize project summary\"\n\t\t\tpanel={\n\t\t\t\t<PanelsRenderer>\n\t\t\t\t\t<PanelRouter />\n\t\t\t\t</PanelsRenderer>\n\t\t\t}\n\t\t>\n\t\t\t<Button\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'project-summary',\n\t\t\t\t\t\tparams: {\n\t\t\t\t\t\t\tsummary:\n\t\t\t\t\t\t\t\t'The release checklist is ready for review. Two work items remain in progress.',\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpanelContent: <ProjectSummary />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView project summary\n\t\t\t</Button>\n\t\t</PanelLayout>\n\t);\n}\n// Internal Atlassian package. Prefer LayoutWithPanel for the standard integration.\n// Use this composition when the app needs to own its PanelLayout and PanelRouter.\nexport default function CustomRenderingExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
1076
+ }, {
1077
+ name: 'useCurrentPanel',
1078
+ description: 'For internal Atlassian use only: Read the current panel and typed runtime parameters inside LayoutWithPanel or PanelsRenderer. Internal Atlassian package; not available for use outside Atlassian.',
1079
+ status: 'open-beta',
1080
+ keywords: ['panel', 'context', 'state', 'close', 'open'],
1081
+ category: 'layout',
1082
+ package: '@atlassian/panel-system',
1083
+ examples: ["import Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { PanelLayout } from '@atlaskit/navigation-system/layout/panel-layout';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { PanelActionClose } from '@atlassian/panel-system/panel-action/close';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { useCloseCurrentPanel, useCurrentPanel } from '@atlassian/panel-system/panel-context';\nimport { PanelDisclaimer } from '@atlassian/panel-system/panel-disclaimer';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelManager } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelRouter } from '@atlassian/panel-system/panel-router';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { PanelsRenderer } from '@atlassian/panel-system/panels-renderer';\nfunction ProjectSummary() {\n\tconst panel = useCurrentPanel<{ summary: string }>();\n\tconst closePanel = useCloseCurrentPanel();\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Project summary</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionClose label=\"Close project summary\" onClick={closePanel} />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Text as=\"p\">{panel.params.summary}</Text>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter\n\t\t\t\tdisclaimer={\n\t\t\t\t\t<PanelDisclaimer>AI-generated content. Verify important details.</PanelDisclaimer>\n\t\t\t\t}\n\t\t\t>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst { state, manager } = usePanelManager();\n\treturn (\n\t\t<PanelLayout\n\t\t\tisPanelOpen={state.activePanel !== null}\n\t\t\tpanelKey={state.activePanel?.instanceId}\n\t\t\tpanelLabel=\"Project summary\"\n\t\t\tresizeLabel=\"Resize project summary\"\n\t\t\tpanel={\n\t\t\t\t<PanelsRenderer>\n\t\t\t\t\t<PanelRouter />\n\t\t\t\t</PanelsRenderer>\n\t\t\t}\n\t\t>\n\t\t\t<Button\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'project-summary',\n\t\t\t\t\t\tparams: {\n\t\t\t\t\t\t\tsummary:\n\t\t\t\t\t\t\t\t'The release checklist is ready for review. Two work items remain in progress.',\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpanelContent: <ProjectSummary />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView project summary\n\t\t\t</Button>\n\t\t</PanelLayout>\n\t);\n}\n// Internal Atlassian package. Prefer LayoutWithPanel for the standard integration.\n// Use this composition when the app needs to own its PanelLayout and PanelRouter.\nexport default function CustomRenderingExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
1084
+ }, {
1085
+ name: 'usePanel',
1086
+ description: 'For internal Atlassian use only: Read the current panel and its close function inside the context supplied by LayoutWithPanel or PanelsRenderer. Internal Atlassian package; not available for use outside Atlassian.',
1087
+ status: 'open-beta',
1088
+ keywords: ['panel', 'context', 'state', 'close', 'open'],
1089
+ category: 'layout',
1090
+ package: '@atlassian/panel-system',
1091
+ examples: ["import React, { useState } from 'react';\nimport Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Stack } from '@atlaskit/primitives/compiled/stack';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { LayoutWithPanel } from '@atlassian/panel-system/layout-with-panel';\nimport { PanelActionCloseSmart } from '@atlassian/panel-system/panel-action/close-smart';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelActionNewTab } from '@atlassian/panel-system/panel-action/new-tab';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { usePanel } from '@atlassian/panel-system/panel-context';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelActions, usePanelState } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelSubheader } from '@atlassian/panel-system/panel-subheader';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { SubheaderInlineEdit } from '@atlassian/panel-system/subheader-inline-edit';\nfunction WorkItemDetails() {\n\tconst { panel, closePanel } = usePanel<{ title: string }>();\n\tconst [title, setTitle] = useState(panel.params.title);\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Work item</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionNewTab href=\"/browse/PROJ-42\" label=\"Open work item in a new tab\" />\n\t\t\t\t\t<PanelActionCloseSmart label=\"Close work item\" />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelSubheader\n\t\t\t\t\ttitle={title}\n\t\t\t\t\tinlineEdit={\n\t\t\t\t\t\t<SubheaderInlineEdit\n\t\t\t\t\t\t\tdefaultValue={title}\n\t\t\t\t\t\t\tplaceholder=\"Add a work item title\"\n\t\t\t\t\t\t\teditButtonLabel=\"Edit work item title\"\n\t\t\t\t\t\t\tconfirmButtonLabel=\"Confirm title\"\n\t\t\t\t\t\t\tcancelButtonLabel=\"Cancel editing\"\n\t\t\t\t\t\t\tonConfirm={setTitle}\n\t\t\t\t\t\t/>\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Stack space=\"space.200\">\n\t\t\t\t\t\t<Text as=\"p\">PROJ-42 · In progress</Text>\n\t\t\t\t\t\t<Text as=\"p\">Review the release checklist with the project team.</Text>\n\t\t\t\t\t\t<Text as=\"p\">\n\t\t\t\t\t\t\tThis example keeps title edits locally. Connect confirmation to your app's save\n\t\t\t\t\t\t\toperation.\n\t\t\t\t\t\t</Text>\n\t\t\t\t\t</Stack>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst manager = usePanelActions();\n\tconst { activePanel } = usePanelState();\n\treturn (\n\t\t<LayoutWithPanel panelLabel=\"Work item details\" resizeLabel=\"Resize work item details\">\n\t\t\t<Button\n\t\t\t\tisSelected={activePanel?.instanceId === 'PROJ-42'}\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'PROJ-42',\n\t\t\t\t\t\tparams: { title: 'Prepare the release checklist' },\n\t\t\t\t\t\tpanelContent: <WorkItemDetails />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView PROJ-42\n\t\t\t</Button>\n\t\t</LayoutWithPanel>\n\t);\n}\n// Internal Atlassian package. This example uses already-loaded React content.\n// For lazy EntryPoints, prefer Trigger inside the app's Relay environment provider.\nexport default function ContextualDetailsExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
1092
+ }, {
1093
+ name: 'usePanelActions',
1094
+ description: 'For internal Atlassian use only: Access stable panel actions when a consumer only needs to open, close, or resize panels. Requires PanelProvider. Internal Atlassian package; not available for use outside Atlassian.',
1095
+ status: 'open-beta',
1096
+ keywords: ['panel', 'context', 'state', 'close', 'open'],
1097
+ category: 'layout',
1098
+ package: '@atlassian/panel-system',
1099
+ examples: ["import React, { useState } from 'react';\nimport Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Stack } from '@atlaskit/primitives/compiled/stack';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { LayoutWithPanel } from '@atlassian/panel-system/layout-with-panel';\nimport { PanelActionCloseSmart } from '@atlassian/panel-system/panel-action/close-smart';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelActionNewTab } from '@atlassian/panel-system/panel-action/new-tab';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { usePanel } from '@atlassian/panel-system/panel-context';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelActions, usePanelState } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelSubheader } from '@atlassian/panel-system/panel-subheader';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { SubheaderInlineEdit } from '@atlassian/panel-system/subheader-inline-edit';\nfunction WorkItemDetails() {\n\tconst { panel, closePanel } = usePanel<{ title: string }>();\n\tconst [title, setTitle] = useState(panel.params.title);\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Work item</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionNewTab href=\"/browse/PROJ-42\" label=\"Open work item in a new tab\" />\n\t\t\t\t\t<PanelActionCloseSmart label=\"Close work item\" />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelSubheader\n\t\t\t\t\ttitle={title}\n\t\t\t\t\tinlineEdit={\n\t\t\t\t\t\t<SubheaderInlineEdit\n\t\t\t\t\t\t\tdefaultValue={title}\n\t\t\t\t\t\t\tplaceholder=\"Add a work item title\"\n\t\t\t\t\t\t\teditButtonLabel=\"Edit work item title\"\n\t\t\t\t\t\t\tconfirmButtonLabel=\"Confirm title\"\n\t\t\t\t\t\t\tcancelButtonLabel=\"Cancel editing\"\n\t\t\t\t\t\t\tonConfirm={setTitle}\n\t\t\t\t\t\t/>\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Stack space=\"space.200\">\n\t\t\t\t\t\t<Text as=\"p\">PROJ-42 · In progress</Text>\n\t\t\t\t\t\t<Text as=\"p\">Review the release checklist with the project team.</Text>\n\t\t\t\t\t\t<Text as=\"p\">\n\t\t\t\t\t\t\tThis example keeps title edits locally. Connect confirmation to your app's save\n\t\t\t\t\t\t\toperation.\n\t\t\t\t\t\t</Text>\n\t\t\t\t\t</Stack>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst manager = usePanelActions();\n\tconst { activePanel } = usePanelState();\n\treturn (\n\t\t<LayoutWithPanel panelLabel=\"Work item details\" resizeLabel=\"Resize work item details\">\n\t\t\t<Button\n\t\t\t\tisSelected={activePanel?.instanceId === 'PROJ-42'}\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'PROJ-42',\n\t\t\t\t\t\tparams: { title: 'Prepare the release checklist' },\n\t\t\t\t\t\tpanelContent: <WorkItemDetails />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView PROJ-42\n\t\t\t</Button>\n\t\t</LayoutWithPanel>\n\t);\n}\n// Internal Atlassian package. This example uses already-loaded React content.\n// For lazy EntryPoints, prefer Trigger inside the app's Relay environment provider.\nexport default function ContextualDetailsExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
1100
+ }, {
1101
+ name: 'usePanelManager',
1102
+ description: 'For internal Atlassian use only: Read both panel state and actions inside PanelProvider. Prefer usePanelActions for action-only consumers. Internal Atlassian package; not available for use outside Atlassian.',
1103
+ status: 'open-beta',
1104
+ keywords: ['panel', 'context', 'state', 'close', 'open'],
1105
+ category: 'layout',
1106
+ package: '@atlassian/panel-system',
1107
+ examples: ["import Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { PanelLayout } from '@atlaskit/navigation-system/layout/panel-layout';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { PanelActionClose } from '@atlassian/panel-system/panel-action/close';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { useCloseCurrentPanel, useCurrentPanel } from '@atlassian/panel-system/panel-context';\nimport { PanelDisclaimer } from '@atlassian/panel-system/panel-disclaimer';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelManager } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelRouter } from '@atlassian/panel-system/panel-router';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { PanelsRenderer } from '@atlassian/panel-system/panels-renderer';\nfunction ProjectSummary() {\n\tconst panel = useCurrentPanel<{ summary: string }>();\n\tconst closePanel = useCloseCurrentPanel();\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Project summary</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionClose label=\"Close project summary\" onClick={closePanel} />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Text as=\"p\">{panel.params.summary}</Text>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter\n\t\t\t\tdisclaimer={\n\t\t\t\t\t<PanelDisclaimer>AI-generated content. Verify important details.</PanelDisclaimer>\n\t\t\t\t}\n\t\t\t>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst { state, manager } = usePanelManager();\n\treturn (\n\t\t<PanelLayout\n\t\t\tisPanelOpen={state.activePanel !== null}\n\t\t\tpanelKey={state.activePanel?.instanceId}\n\t\t\tpanelLabel=\"Project summary\"\n\t\t\tresizeLabel=\"Resize project summary\"\n\t\t\tpanel={\n\t\t\t\t<PanelsRenderer>\n\t\t\t\t\t<PanelRouter />\n\t\t\t\t</PanelsRenderer>\n\t\t\t}\n\t\t>\n\t\t\t<Button\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'project-summary',\n\t\t\t\t\t\tparams: {\n\t\t\t\t\t\t\tsummary:\n\t\t\t\t\t\t\t\t'The release checklist is ready for review. Two work items remain in progress.',\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpanelContent: <ProjectSummary />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView project summary\n\t\t\t</Button>\n\t\t</PanelLayout>\n\t);\n}\n// Internal Atlassian package. Prefer LayoutWithPanel for the standard integration.\n// Use this composition when the app needs to own its PanelLayout and PanelRouter.\nexport default function CustomRenderingExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
1108
+ }, {
1109
+ name: 'usePanelState',
1110
+ description: 'For internal Atlassian use only: Read active-panel and preferred-width state inside PanelProvider. Internal Atlassian package; not available for use outside Atlassian.',
1111
+ status: 'open-beta',
1112
+ keywords: ['panel', 'context', 'state', 'close', 'open'],
1113
+ category: 'layout',
1114
+ package: '@atlassian/panel-system',
1115
+ examples: ["import React, { useState } from 'react';\nimport Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Stack } from '@atlaskit/primitives/compiled/stack';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { LayoutWithPanel } from '@atlassian/panel-system/layout-with-panel';\nimport { PanelActionCloseSmart } from '@atlassian/panel-system/panel-action/close-smart';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelActionNewTab } from '@atlassian/panel-system/panel-action/new-tab';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { usePanel } from '@atlassian/panel-system/panel-context';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelActions, usePanelState } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelSubheader } from '@atlassian/panel-system/panel-subheader';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { SubheaderInlineEdit } from '@atlassian/panel-system/subheader-inline-edit';\nfunction WorkItemDetails() {\n\tconst { panel, closePanel } = usePanel<{ title: string }>();\n\tconst [title, setTitle] = useState(panel.params.title);\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Work item</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionNewTab href=\"/browse/PROJ-42\" label=\"Open work item in a new tab\" />\n\t\t\t\t\t<PanelActionCloseSmart label=\"Close work item\" />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelSubheader\n\t\t\t\t\ttitle={title}\n\t\t\t\t\tinlineEdit={\n\t\t\t\t\t\t<SubheaderInlineEdit\n\t\t\t\t\t\t\tdefaultValue={title}\n\t\t\t\t\t\t\tplaceholder=\"Add a work item title\"\n\t\t\t\t\t\t\teditButtonLabel=\"Edit work item title\"\n\t\t\t\t\t\t\tconfirmButtonLabel=\"Confirm title\"\n\t\t\t\t\t\t\tcancelButtonLabel=\"Cancel editing\"\n\t\t\t\t\t\t\tonConfirm={setTitle}\n\t\t\t\t\t\t/>\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Stack space=\"space.200\">\n\t\t\t\t\t\t<Text as=\"p\">PROJ-42 · In progress</Text>\n\t\t\t\t\t\t<Text as=\"p\">Review the release checklist with the project team.</Text>\n\t\t\t\t\t\t<Text as=\"p\">\n\t\t\t\t\t\t\tThis example keeps title edits locally. Connect confirmation to your app's save\n\t\t\t\t\t\t\toperation.\n\t\t\t\t\t\t</Text>\n\t\t\t\t\t</Stack>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst manager = usePanelActions();\n\tconst { activePanel } = usePanelState();\n\treturn (\n\t\t<LayoutWithPanel panelLabel=\"Work item details\" resizeLabel=\"Resize work item details\">\n\t\t\t<Button\n\t\t\t\tisSelected={activePanel?.instanceId === 'PROJ-42'}\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'PROJ-42',\n\t\t\t\t\t\tparams: { title: 'Prepare the release checklist' },\n\t\t\t\t\t\tpanelContent: <WorkItemDetails />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView PROJ-42\n\t\t\t</Button>\n\t\t</LayoutWithPanel>\n\t);\n}\n// Internal Atlassian package. This example uses already-loaded React content.\n// For lazy EntryPoints, prefer Trigger inside the app's Relay environment provider.\nexport default function ContextualDetailsExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
1068
1116
  }, {
1069
1117
  name: 'useAllMessages',
1070
1118
  description: 'Returns every non-dismissed message in a placement with a placement-bound wrapper. Use it when one surface renders messages from multiple templates.',
@@ -2070,52 +2118,4 @@ var atlaskitHooks = exports.atlaskitHooks = [{
2070
2118
  category: 'studio',
2071
2119
  package: '@atlassian/studio-browse-kit',
2072
2120
  examples: []
2073
- }, {
2074
- name: 'useCloseCurrentPanel',
2075
- description: 'For internal Atlassian use only: Get a callback that closes the current panel inside LayoutWithPanel or PanelsRenderer. Internal Atlassian package; not available for use outside Atlassian.',
2076
- status: 'open-beta',
2077
- keywords: ['panel', 'context', 'state', 'close', 'open'],
2078
- category: 'layout',
2079
- package: '@atlassian/panel-system',
2080
- examples: ["import Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { PanelLayout } from '@atlaskit/navigation-system/layout/panel-layout';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { PanelActionClose } from '@atlassian/panel-system/panel-action/close';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { useCloseCurrentPanel, useCurrentPanel } from '@atlassian/panel-system/panel-context';\nimport { PanelDisclaimer } from '@atlassian/panel-system/panel-disclaimer';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelManager } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelRouter } from '@atlassian/panel-system/panel-router';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { PanelsRenderer } from '@atlassian/panel-system/panels-renderer';\nfunction ProjectSummary() {\n\tconst panel = useCurrentPanel<{ summary: string }>();\n\tconst closePanel = useCloseCurrentPanel();\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Project summary</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionClose label=\"Close project summary\" onClick={closePanel} />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Text as=\"p\">{panel.params.summary}</Text>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter\n\t\t\t\tdisclaimer={\n\t\t\t\t\t<PanelDisclaimer>AI-generated content. Verify important details.</PanelDisclaimer>\n\t\t\t\t}\n\t\t\t>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst { state, manager } = usePanelManager();\n\treturn (\n\t\t<PanelLayout\n\t\t\tisPanelOpen={state.activePanel !== null}\n\t\t\tpanelKey={state.activePanel?.instanceId}\n\t\t\tpanelLabel=\"Project summary\"\n\t\t\tresizeLabel=\"Resize project summary\"\n\t\t\tpanel={\n\t\t\t\t<PanelsRenderer>\n\t\t\t\t\t<PanelRouter />\n\t\t\t\t</PanelsRenderer>\n\t\t\t}\n\t\t>\n\t\t\t<Button\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'project-summary',\n\t\t\t\t\t\tparams: {\n\t\t\t\t\t\t\tsummary:\n\t\t\t\t\t\t\t\t'The release checklist is ready for review. Two work items remain in progress.',\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpanelContent: <ProjectSummary />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView project summary\n\t\t\t</Button>\n\t\t</PanelLayout>\n\t);\n}\n// Internal Atlassian package. Prefer LayoutWithPanel for the standard integration.\n// Use this composition when the app needs to own its PanelLayout and PanelRouter.\nexport default function CustomRenderingExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
2081
- }, {
2082
- name: 'useCurrentPanel',
2083
- description: 'For internal Atlassian use only: Read the current panel and typed runtime parameters inside LayoutWithPanel or PanelsRenderer. Internal Atlassian package; not available for use outside Atlassian.',
2084
- status: 'open-beta',
2085
- keywords: ['panel', 'context', 'state', 'close', 'open'],
2086
- category: 'layout',
2087
- package: '@atlassian/panel-system',
2088
- examples: ["import Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { PanelLayout } from '@atlaskit/navigation-system/layout/panel-layout';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { PanelActionClose } from '@atlassian/panel-system/panel-action/close';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { useCloseCurrentPanel, useCurrentPanel } from '@atlassian/panel-system/panel-context';\nimport { PanelDisclaimer } from '@atlassian/panel-system/panel-disclaimer';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelManager } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelRouter } from '@atlassian/panel-system/panel-router';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { PanelsRenderer } from '@atlassian/panel-system/panels-renderer';\nfunction ProjectSummary() {\n\tconst panel = useCurrentPanel<{ summary: string }>();\n\tconst closePanel = useCloseCurrentPanel();\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Project summary</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionClose label=\"Close project summary\" onClick={closePanel} />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Text as=\"p\">{panel.params.summary}</Text>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter\n\t\t\t\tdisclaimer={\n\t\t\t\t\t<PanelDisclaimer>AI-generated content. Verify important details.</PanelDisclaimer>\n\t\t\t\t}\n\t\t\t>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst { state, manager } = usePanelManager();\n\treturn (\n\t\t<PanelLayout\n\t\t\tisPanelOpen={state.activePanel !== null}\n\t\t\tpanelKey={state.activePanel?.instanceId}\n\t\t\tpanelLabel=\"Project summary\"\n\t\t\tresizeLabel=\"Resize project summary\"\n\t\t\tpanel={\n\t\t\t\t<PanelsRenderer>\n\t\t\t\t\t<PanelRouter />\n\t\t\t\t</PanelsRenderer>\n\t\t\t}\n\t\t>\n\t\t\t<Button\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'project-summary',\n\t\t\t\t\t\tparams: {\n\t\t\t\t\t\t\tsummary:\n\t\t\t\t\t\t\t\t'The release checklist is ready for review. Two work items remain in progress.',\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpanelContent: <ProjectSummary />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView project summary\n\t\t\t</Button>\n\t\t</PanelLayout>\n\t);\n}\n// Internal Atlassian package. Prefer LayoutWithPanel for the standard integration.\n// Use this composition when the app needs to own its PanelLayout and PanelRouter.\nexport default function CustomRenderingExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
2089
- }, {
2090
- name: 'usePanel',
2091
- description: 'For internal Atlassian use only: Read the current panel and its close function inside the context supplied by LayoutWithPanel or PanelsRenderer. Internal Atlassian package; not available for use outside Atlassian.',
2092
- status: 'open-beta',
2093
- keywords: ['panel', 'context', 'state', 'close', 'open'],
2094
- category: 'layout',
2095
- package: '@atlassian/panel-system',
2096
- examples: ["import React, { useState } from 'react';\nimport Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Stack } from '@atlaskit/primitives/compiled/stack';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { LayoutWithPanel } from '@atlassian/panel-system/layout-with-panel';\nimport { PanelActionCloseSmart } from '@atlassian/panel-system/panel-action/close-smart';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelActionNewTab } from '@atlassian/panel-system/panel-action/new-tab';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { usePanel } from '@atlassian/panel-system/panel-context';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelActions, usePanelState } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelSubheader } from '@atlassian/panel-system/panel-subheader';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { SubheaderInlineEdit } from '@atlassian/panel-system/subheader-inline-edit';\nfunction WorkItemDetails() {\n\tconst { panel, closePanel } = usePanel<{ title: string }>();\n\tconst [title, setTitle] = useState(panel.params.title);\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Work item</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionNewTab href=\"/browse/PROJ-42\" label=\"Open work item in a new tab\" />\n\t\t\t\t\t<PanelActionCloseSmart label=\"Close work item\" />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelSubheader\n\t\t\t\t\ttitle={title}\n\t\t\t\t\tinlineEdit={\n\t\t\t\t\t\t<SubheaderInlineEdit\n\t\t\t\t\t\t\tdefaultValue={title}\n\t\t\t\t\t\t\tplaceholder=\"Add a work item title\"\n\t\t\t\t\t\t\teditButtonLabel=\"Edit work item title\"\n\t\t\t\t\t\t\tconfirmButtonLabel=\"Confirm title\"\n\t\t\t\t\t\t\tcancelButtonLabel=\"Cancel editing\"\n\t\t\t\t\t\t\tonConfirm={setTitle}\n\t\t\t\t\t\t/>\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Stack space=\"space.200\">\n\t\t\t\t\t\t<Text as=\"p\">PROJ-42 · In progress</Text>\n\t\t\t\t\t\t<Text as=\"p\">Review the release checklist with the project team.</Text>\n\t\t\t\t\t\t<Text as=\"p\">\n\t\t\t\t\t\t\tThis example keeps title edits locally. Connect confirmation to your app's save\n\t\t\t\t\t\t\toperation.\n\t\t\t\t\t\t</Text>\n\t\t\t\t\t</Stack>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst manager = usePanelActions();\n\tconst { activePanel } = usePanelState();\n\treturn (\n\t\t<LayoutWithPanel panelLabel=\"Work item details\" resizeLabel=\"Resize work item details\">\n\t\t\t<Button\n\t\t\t\tisSelected={activePanel?.instanceId === 'PROJ-42'}\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'PROJ-42',\n\t\t\t\t\t\tparams: { title: 'Prepare the release checklist' },\n\t\t\t\t\t\tpanelContent: <WorkItemDetails />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView PROJ-42\n\t\t\t</Button>\n\t\t</LayoutWithPanel>\n\t);\n}\n// Internal Atlassian package. This example uses already-loaded React content.\n// For lazy EntryPoints, prefer Trigger inside the app's Relay environment provider.\nexport default function ContextualDetailsExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
2097
- }, {
2098
- name: 'usePanelActions',
2099
- description: 'For internal Atlassian use only: Access stable panel actions when a consumer only needs to open, close, or resize panels. Requires PanelProvider. Internal Atlassian package; not available for use outside Atlassian.',
2100
- status: 'open-beta',
2101
- keywords: ['panel', 'context', 'state', 'close', 'open'],
2102
- category: 'layout',
2103
- package: '@atlassian/panel-system',
2104
- examples: ["import React, { useState } from 'react';\nimport Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Stack } from '@atlaskit/primitives/compiled/stack';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { LayoutWithPanel } from '@atlassian/panel-system/layout-with-panel';\nimport { PanelActionCloseSmart } from '@atlassian/panel-system/panel-action/close-smart';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelActionNewTab } from '@atlassian/panel-system/panel-action/new-tab';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { usePanel } from '@atlassian/panel-system/panel-context';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelActions, usePanelState } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelSubheader } from '@atlassian/panel-system/panel-subheader';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { SubheaderInlineEdit } from '@atlassian/panel-system/subheader-inline-edit';\nfunction WorkItemDetails() {\n\tconst { panel, closePanel } = usePanel<{ title: string }>();\n\tconst [title, setTitle] = useState(panel.params.title);\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Work item</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionNewTab href=\"/browse/PROJ-42\" label=\"Open work item in a new tab\" />\n\t\t\t\t\t<PanelActionCloseSmart label=\"Close work item\" />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelSubheader\n\t\t\t\t\ttitle={title}\n\t\t\t\t\tinlineEdit={\n\t\t\t\t\t\t<SubheaderInlineEdit\n\t\t\t\t\t\t\tdefaultValue={title}\n\t\t\t\t\t\t\tplaceholder=\"Add a work item title\"\n\t\t\t\t\t\t\teditButtonLabel=\"Edit work item title\"\n\t\t\t\t\t\t\tconfirmButtonLabel=\"Confirm title\"\n\t\t\t\t\t\t\tcancelButtonLabel=\"Cancel editing\"\n\t\t\t\t\t\t\tonConfirm={setTitle}\n\t\t\t\t\t\t/>\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Stack space=\"space.200\">\n\t\t\t\t\t\t<Text as=\"p\">PROJ-42 · In progress</Text>\n\t\t\t\t\t\t<Text as=\"p\">Review the release checklist with the project team.</Text>\n\t\t\t\t\t\t<Text as=\"p\">\n\t\t\t\t\t\t\tThis example keeps title edits locally. Connect confirmation to your app's save\n\t\t\t\t\t\t\toperation.\n\t\t\t\t\t\t</Text>\n\t\t\t\t\t</Stack>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst manager = usePanelActions();\n\tconst { activePanel } = usePanelState();\n\treturn (\n\t\t<LayoutWithPanel panelLabel=\"Work item details\" resizeLabel=\"Resize work item details\">\n\t\t\t<Button\n\t\t\t\tisSelected={activePanel?.instanceId === 'PROJ-42'}\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'PROJ-42',\n\t\t\t\t\t\tparams: { title: 'Prepare the release checklist' },\n\t\t\t\t\t\tpanelContent: <WorkItemDetails />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView PROJ-42\n\t\t\t</Button>\n\t\t</LayoutWithPanel>\n\t);\n}\n// Internal Atlassian package. This example uses already-loaded React content.\n// For lazy EntryPoints, prefer Trigger inside the app's Relay environment provider.\nexport default function ContextualDetailsExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
2105
- }, {
2106
- name: 'usePanelManager',
2107
- description: 'For internal Atlassian use only: Read both panel state and actions inside PanelProvider. Prefer usePanelActions for action-only consumers. Internal Atlassian package; not available for use outside Atlassian.',
2108
- status: 'open-beta',
2109
- keywords: ['panel', 'context', 'state', 'close', 'open'],
2110
- category: 'layout',
2111
- package: '@atlassian/panel-system',
2112
- examples: ["import Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { PanelLayout } from '@atlaskit/navigation-system/layout/panel-layout';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { PanelActionClose } from '@atlassian/panel-system/panel-action/close';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { useCloseCurrentPanel, useCurrentPanel } from '@atlassian/panel-system/panel-context';\nimport { PanelDisclaimer } from '@atlassian/panel-system/panel-disclaimer';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelManager } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelRouter } from '@atlassian/panel-system/panel-router';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { PanelsRenderer } from '@atlassian/panel-system/panels-renderer';\nfunction ProjectSummary() {\n\tconst panel = useCurrentPanel<{ summary: string }>();\n\tconst closePanel = useCloseCurrentPanel();\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Project summary</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionClose label=\"Close project summary\" onClick={closePanel} />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Text as=\"p\">{panel.params.summary}</Text>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter\n\t\t\t\tdisclaimer={\n\t\t\t\t\t<PanelDisclaimer>AI-generated content. Verify important details.</PanelDisclaimer>\n\t\t\t\t}\n\t\t\t>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst { state, manager } = usePanelManager();\n\treturn (\n\t\t<PanelLayout\n\t\t\tisPanelOpen={state.activePanel !== null}\n\t\t\tpanelKey={state.activePanel?.instanceId}\n\t\t\tpanelLabel=\"Project summary\"\n\t\t\tresizeLabel=\"Resize project summary\"\n\t\t\tpanel={\n\t\t\t\t<PanelsRenderer>\n\t\t\t\t\t<PanelRouter />\n\t\t\t\t</PanelsRenderer>\n\t\t\t}\n\t\t>\n\t\t\t<Button\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'project-summary',\n\t\t\t\t\t\tparams: {\n\t\t\t\t\t\t\tsummary:\n\t\t\t\t\t\t\t\t'The release checklist is ready for review. Two work items remain in progress.',\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpanelContent: <ProjectSummary />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView project summary\n\t\t\t</Button>\n\t\t</PanelLayout>\n\t);\n}\n// Internal Atlassian package. Prefer LayoutWithPanel for the standard integration.\n// Use this composition when the app needs to own its PanelLayout and PanelRouter.\nexport default function CustomRenderingExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
2113
- }, {
2114
- name: 'usePanelState',
2115
- description: 'For internal Atlassian use only: Read active-panel and preferred-width state inside PanelProvider. Internal Atlassian package; not available for use outside Atlassian.',
2116
- status: 'open-beta',
2117
- keywords: ['panel', 'context', 'state', 'close', 'open'],
2118
- category: 'layout',
2119
- package: '@atlassian/panel-system',
2120
- examples: ["import React, { useState } from 'react';\nimport Button from '@atlaskit/button/default/button';\nimport { Main } from '@atlaskit/navigation-system/layout/main';\nimport { Root } from '@atlaskit/navigation-system/layout/root';\nimport { Stack } from '@atlaskit/primitives/compiled/stack';\nimport { Text } from '@atlaskit/primitives/compiled/text';\nimport { LayoutWithPanel } from '@atlassian/panel-system/layout-with-panel';\nimport { PanelActionCloseSmart } from '@atlassian/panel-system/panel-action/close-smart';\nimport { PanelActionGroup } from '@atlassian/panel-system/panel-action/group';\nimport { PanelActionNewTab } from '@atlassian/panel-system/panel-action/new-tab';\nimport { PanelBody } from '@atlassian/panel-system/panel-body';\nimport { PanelContainer } from '@atlassian/panel-system/panel-container';\nimport { PanelContent } from '@atlassian/panel-system/panel-content';\nimport { usePanel } from '@atlassian/panel-system/panel-context';\nimport { PanelFooter } from '@atlassian/panel-system/panel-footer';\nimport { PanelHeader } from '@atlassian/panel-system/panel-header';\nimport { usePanelActions, usePanelState } from '@atlassian/panel-system/panel-manager';\nimport { PanelProvider } from '@atlassian/panel-system/panel-provider';\nimport { PanelSubheader } from '@atlassian/panel-system/panel-subheader';\nimport { PanelTitle } from '@atlassian/panel-system/panel-title';\nimport { SubheaderInlineEdit } from '@atlassian/panel-system/subheader-inline-edit';\nfunction WorkItemDetails() {\n\tconst { panel, closePanel } = usePanel<{ title: string }>();\n\tconst [title, setTitle] = useState(panel.params.title);\n\treturn (\n\t\t<PanelContainer>\n\t\t\t<PanelHeader>\n\t\t\t\t<PanelTitle>Work item</PanelTitle>\n\t\t\t\t<PanelActionGroup>\n\t\t\t\t\t<PanelActionNewTab href=\"/browse/PROJ-42\" label=\"Open work item in a new tab\" />\n\t\t\t\t\t<PanelActionCloseSmart label=\"Close work item\" />\n\t\t\t\t</PanelActionGroup>\n\t\t\t</PanelHeader>\n\t\t\t<PanelContent>\n\t\t\t\t<PanelSubheader\n\t\t\t\t\ttitle={title}\n\t\t\t\t\tinlineEdit={\n\t\t\t\t\t\t<SubheaderInlineEdit\n\t\t\t\t\t\t\tdefaultValue={title}\n\t\t\t\t\t\t\tplaceholder=\"Add a work item title\"\n\t\t\t\t\t\t\teditButtonLabel=\"Edit work item title\"\n\t\t\t\t\t\t\tconfirmButtonLabel=\"Confirm title\"\n\t\t\t\t\t\t\tcancelButtonLabel=\"Cancel editing\"\n\t\t\t\t\t\t\tonConfirm={setTitle}\n\t\t\t\t\t\t/>\n\t\t\t\t\t}\n\t\t\t\t/>\n\t\t\t\t<PanelBody>\n\t\t\t\t\t<Stack space=\"space.200\">\n\t\t\t\t\t\t<Text as=\"p\">PROJ-42 · In progress</Text>\n\t\t\t\t\t\t<Text as=\"p\">Review the release checklist with the project team.</Text>\n\t\t\t\t\t\t<Text as=\"p\">\n\t\t\t\t\t\t\tThis example keeps title edits locally. Connect confirmation to your app's save\n\t\t\t\t\t\t\toperation.\n\t\t\t\t\t\t</Text>\n\t\t\t\t\t</Stack>\n\t\t\t\t</PanelBody>\n\t\t\t</PanelContent>\n\t\t\t<PanelFooter>\n\t\t\t\t<Button onClick={closePanel}>Done</Button>\n\t\t\t</PanelFooter>\n\t\t</PanelContainer>\n\t);\n}\nfunction ProjectContent() {\n\tconst manager = usePanelActions();\n\tconst { activePanel } = usePanelState();\n\treturn (\n\t\t<LayoutWithPanel panelLabel=\"Work item details\" resizeLabel=\"Resize work item details\">\n\t\t\t<Button\n\t\t\t\tisSelected={activePanel?.instanceId === 'PROJ-42'}\n\t\t\t\tonClick={() =>\n\t\t\t\t\tmanager.openPanel({\n\t\t\t\t\t\tinstanceId: 'PROJ-42',\n\t\t\t\t\t\tparams: { title: 'Prepare the release checklist' },\n\t\t\t\t\t\tpanelContent: <WorkItemDetails />,\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t>\n\t\t\t\tView PROJ-42\n\t\t\t</Button>\n\t\t</LayoutWithPanel>\n\t);\n}\n// Internal Atlassian package. This example uses already-loaded React content.\n// For lazy EntryPoints, prefer Trigger inside the app's Relay environment provider.\nexport default function ContextualDetailsExample(): React.JSX.Element {\n\treturn (\n\t\t<PanelProvider>\n\t\t\t<Root>\n\t\t\t\t<Main>\n\t\t\t\t\t<ProjectContent />\n\t\t\t\t</Main>\n\t\t\t</Root>\n\t\t</PanelProvider>\n\t);\n}"]
2121
2121
  }];