@igstack/app-catalog-frontend-core 6.7.0 → 6.8.0

package/dist/esm/modules/appCatalog/ui/catalog/AppDetailPanel.js

@@ -1,6 +1,6 @@
 import { jsxs, jsx } from "react/jsx-runtime";
-import { X } from "lucide-react";
-import { useMemo, useRef, useLayoutEffect, useEffect } from "react";
+import { Minimize2, Maximize2, X } from "lucide-react";
+import { useMemo, useRef, useState, useLayoutEffect, useEffect } from "react";
 import { useAppCatalogContext } from "../../context/AppCatalogContext.js";
 import { useOptionalUser } from "../../../auth/AuthContext.js";
 import "@tanstack/react-query";
@@ -29,6 +29,7 @@ function AppDetailPanel({
     [subResource, app, allResources, user]
   );
   const dialogRef = useRef(null);
+  const [isWide, setIsWide] = useState(false);
   useLayoutEffect(() => {
     const card = dialogRef.current;
     const scroller = card == null ? void 0 : card.parentElement;
@@ -72,18 +73,31 @@ function AppDetailPanel({
         "aria-modal": "true",
         "aria-label": `${(subResource == null ? void 0 : subResource.displayName) ?? app.displayName} details`,
         tabIndex: -1,
-        className: "relative w-full max-w-[min(1120px,94vw)] overflow-hidden rounded-[var(--radius)] border border-border bg-background shadow-2xl animate-in fade-in zoom-in-95 duration-200 outline-none",
+        className: `relative w-full ${isWide ? "max-w-none" : "max-w-[min(1120px,94vw)]"} overflow-hidden rounded-[var(--radius)] border border-border bg-background shadow-2xl animate-in fade-in zoom-in-95 duration-200 outline-none`,
         children: [
-          /* @__PURE__ */ jsx(
-            "button",
-            {
-              type: "button",
-              "aria-label": "Close",
-              onClick: onClose,
-              className: "absolute top-3 right-3 z-10 rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors",
-              children: /* @__PURE__ */ jsx(X, { className: "size-4" })
-            }
-          ),
+          /* @__PURE__ */ jsxs("div", { className: "absolute top-3 right-3 z-10 flex gap-1", children: [
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                "aria-label": isWide ? "Restore width" : "Widen card",
+                title: isWide ? "Restore width" : "Widen card",
+                onClick: () => setIsWide((wide) => !wide),
+                className: "rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors",
+                children: isWide ? /* @__PURE__ */ jsx(Minimize2, { className: "size-4" }) : /* @__PURE__ */ jsx(Maximize2, { className: "size-4" })
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                "aria-label": "Close",
+                onClick: onClose,
+                className: "rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors",
+                children: /* @__PURE__ */ jsx(X, { className: "size-4" })
+              }
+            )
+          ] }),
           /* @__PURE__ */ jsx(
             "div",
             {

package/dist/esm/modules/appCatalog/ui/catalog/AppDetailPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppDetailPanel.js","sources":["../../../../../../src/modules/appCatalog/ui/catalog/AppDetailPanel.tsx"],"sourcesContent":["import type { Resource } from '@igstack/app-catalog-backend-core'\nimport { X } from 'lucide-react'\nimport { useEffect, useLayoutEffect, useMemo, useRef } from 'react'\nimport { useAppCatalogContext } from '../../context/AppCatalogContext'\nimport {\n  ResourceDetailAccessActions,\n  ResourceDetailProvider,\n} from '~/modules/extensions'\nimport { useOptionalUser } from '~/modules/auth'\nimport { useDismissStack, useDismissable } from '~/modules/dismiss/DismissStack'\nimport { getChildResources } from '../../utils/resolveHelpers'\nimport { SubResourceDetailPanel } from '../components/SubResourceDetailPanel'\nimport { AppDetails } from '../detail/AppDetails'\n\n/**\n * Centered detail card over the catalog (#38, item B). Renders the rich\n * AppDetails (access-hero, sub-resources, tiers) as a large centered modal card\n * over the catalog backdrop.\n *\n * When a sub-resource is selected (`?sub=<slug>` — e.g. the user clicked a\n * matched sub-resource row in the search results) the card shows that\n * sub-resource's own detail, with its two-step access chain and a back link to\n * the parent.\n *\n * Escape handling: this component does NOT globally bind Escape. Escape-to-close\n * is owned by AppDetails' own key handling (which first closes an open\n * screenshot gallery, then closes the card), so pressing Esc inside the gallery\n * returns to the card — not all the way to the home page (#38 Esc-stacking bug).\n */\nexport function AppDetailPanel({\n  app,\n  subResource,\n  onClose,\n  onAppClick,\n  onBackToParent,\n}: {\n  app: Resource\n  /** Selected child of `app`, when the URL carries `?sub=<slug>`. */\n  subResource?: Resource | null\n  onClose: () => void\n  onAppClick?: (app: Resource) => void\n  /** Clears `?sub=` and returns to the parent's detail. */\n  onBackToParent?: () => void\n}) {\n  const { approvalMethods, resources: allResources } = useAppCatalogContext()\n  const user = useOptionalUser()\n\n  // The sub-resource branch has no band of its own, so its slot payload is\n  // assembled here, where the catalog context already is, and handed down.\n  const subResourceActionsCtx = useMemo(\n    () => ({\n      resource: subResource ?? app,\n      parent: subResource ? app : undefined,\n      subResources: getChildResources(allResources, app.slug),\n      user: user ? { email: user.email, isAdmin: user.isAdmin ?? false } : null,\n    }),\n    [subResource, app, allResources, user],\n  )\n  const dialogRef = useRef<HTMLDivElement>(null)\n\n  /**\n   * Centre the card ONCE when it opens, then hold that position.\n   *\n   * `my-auto` centred it on every render, so each panel height change pushed both\n   * edges and half the delta became upward movement of everything above it —\n   * including the tab strip, which moved 113px and took the control the user had\n   * just clicked with it (CLS 0.19, \"needs improvement\").\n   *\n   * Top-anchoring fixed the shift but looked wrong: a short card sat high on the\n   * page. So pin the centred offset instead. The card still opens centred, and\n   * anything that grows it afterwards extends downward only — which is what a\n   * reader expects when they open a tab with more in it.\n   *\n   * Only on open and on resize. Deliberately NOT on content change: reacting to\n   * content is precisely the bug.\n   */\n  useLayoutEffect(() => {\n    const card = dialogRef.current\n    const scroller = card?.parentElement\n    if (!card || !scroller) return\n\n    const pinCentre = () => {\n      card.style.marginTop = '0px'\n      const style = getComputedStyle(scroller)\n      const usable =\n        scroller.clientHeight -\n        parseFloat(style.paddingTop) -\n        parseFloat(style.paddingBottom)\n      const slack = usable - card.offsetHeight\n      // Negative slack means the card is already taller than the viewport; leave it\n      // at the top and let the overlay scroll, rather than pushing its head off.\n      card.style.marginTop = `${Math.max(0, Math.round(slack / 2))}px`\n    }\n\n    pinCentre()\n    window.addEventListener('resize', pinCentre)\n    return () => window.removeEventListener('resize', pinCentre)\n    // Keyed on the opened entry: a different card is a new open, and should\n    // re-centre for its own height.\n  }, [app.slug, subResource?.slug])\n\n  // Focus the dialog on mount so Esc hotkeys fire immediately, even when\n  // the card was opened by a mouse click (which leaves focus on the grid row).\n  //\n  // Unless something inside already took the caret — the Quick Jump field does,\n  // and it has the better claim: a child's effect runs before its parent's, so\n  // without this guard the card would take focus straight back off it.\n  //\n  // Runs again whenever the card navigates to another resource, keyed the same\n  // way the body below is: that navigation destroys whatever was focused (the\n  // \"View replacement\" button, a prerequisite's parent), and without this the\n  // caret would land on <body> — where the next Tab walks the catalog grid\n  // behind the scrim, since the card has no focus trap.\n  const shownSlug = subResource?.slug ?? app.slug\n  const stack = useDismissStack()\n  useEffect(() => {\n    const dialog = dialogRef.current\n    if (!dialog || dialog.contains(document.activeElement)) return\n    // Only while the card is on top. A layer opened OVER it — a deployment's\n    // dialog on a nested route — owns the caret, and on a cold deep link that\n    // layer mounts before the card does, so without this check the card took\n    // focus back off the dialog's first field the moment the catalog arrived.\n    const top = stack.topElement()\n    if (top && top !== dialog) return\n    dialog.focus()\n  }, [shownSlug, stack])\n\n  // Escape closes the card. Registered here rather than in AppDetails because\n  // this is the layer's element, and because the sub-resource view renders a\n  // different body in place of AppDetails — which left that view with no\n  // Escape at all while the registration lived in the body.\n  useDismissable(dialogRef, onClose)\n\n  return (\n    <div className=\"fixed inset-0 z-50 flex items-start justify-center overflow-y-auto p-4 sm:p-6 md:p-10\">\n      {/* scrim */}\n      <button\n        type=\"button\"\n        aria-label=\"Close details panel\"\n        onClick={onClose}\n        className=\"fixed inset-0 -z-10 bg-black/40 backdrop-blur-[2px] animate-in fade-in\"\n      />\n      {/* centered card — wide enough for data tables (sub-resources have 5\n          columns incl. \"Access Contacts\"/\"AWS Account\" that wrapped at 760px);\n          prose inside AppDetails is width-capped separately so it stays\n          readable. Caps at 94vw so it never touches the edges. */}\n      <div\n        ref={dialogRef}\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label={`${subResource?.displayName ?? app.displayName} details`}\n        tabIndex={-1}\n        // Centred on open, then held — see the pin effect above. `my-auto` is\n        // deliberately absent: it re-centres on EVERY height change, which is the\n        // layout-shift bug.\n        // `overflow-hidden` belongs on the rounded box: the scrolling child\n        // below carries the band's tint to its own square corners and paints\n        // them over this radius, so the card's top corners read as cut off.\n        className=\"relative w-full max-w-[min(1120px,94vw)] overflow-hidden rounded-[var(--radius)] border border-border bg-background shadow-2xl animate-in fade-in zoom-in-95 duration-200 outline-none\"\n      >\n        <button\n          type=\"button\"\n          aria-label=\"Close\"\n          onClick={onClose}\n          className=\"absolute top-3 right-3 z-10 rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors\"\n        >\n          <X className=\"size-4\" />\n        </button>\n        {/* Keyed by the resource on screen, so the body remounts when the card\n            navigates from one app to another (\"View replacement\", an access\n            prerequisite's parent) instead of updating in place. Everything\n            per-app inside it is component state with no reset of its own — the\n            roles table's expansion, the icon/screenshot error flags, a draft\n            source edit — and it used to arrive at the next app still carrying\n            the previous one's, plus the previous scroll offset.\n\n            The key is here and not on the outer dialog on purpose: that one\n            would restart the open animation and re-run the mount-focus effect\n            on every in-card navigation. */}\n        <div\n          key={shownSlug}\n          className=\"max-h-[85vh] overflow-y-auto px-6 py-5 sm:px-8 sm:py-7\"\n        >\n          {/* Inside the key, so anything a plugin provides here is scoped to\n              the resource on screen and is discarded when the card navigates.\n              Renders its children untouched when no plugin contributes. */}\n          <ResourceDetailProvider\n            resource={subResource ?? app}\n            parent={subResource ? app : undefined}\n          >\n            {subResource ? (\n              <SubResourceDetailPanel\n                subResource={subResource}\n                parent={app}\n                approvalMethods={approvalMethods}\n                onBack={onBackToParent ?? onClose}\n                actions={\n                  <ResourceDetailAccessActions {...subResourceActionsCtx} />\n                }\n              />\n            ) : (\n              <AppDetails app={app} onAppClick={onAppClick} />\n            )}\n          </ResourceDetailProvider>\n        </div>\n      </div>\n    </div>\n  )\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"AppDetailPanel.js","sources":["../../../../../../src/modules/appCatalog/ui/catalog/AppDetailPanel.tsx"],"sourcesContent":["import type { Resource } from '@igstack/app-catalog-backend-core'\nimport { Maximize2, Minimize2, X } from 'lucide-react'\nimport { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react'\nimport { useAppCatalogContext } from '../../context/AppCatalogContext'\nimport {\n  ResourceDetailAccessActions,\n  ResourceDetailProvider,\n} from '~/modules/extensions'\nimport { useOptionalUser } from '~/modules/auth'\nimport { useDismissStack, useDismissable } from '~/modules/dismiss/DismissStack'\nimport { getChildResources } from '../../utils/resolveHelpers'\nimport { SubResourceDetailPanel } from '../components/SubResourceDetailPanel'\nimport { AppDetails } from '../detail/AppDetails'\n\n/**\n * Centered detail card over the catalog (#38, item B). Renders the rich\n * AppDetails (access-hero, sub-resources, tiers) as a large centered modal card\n * over the catalog backdrop.\n *\n * When a sub-resource is selected (`?sub=<slug>` — e.g. the user clicked a\n * matched sub-resource row in the search results) the card shows that\n * sub-resource's own detail, with its two-step access chain and a back link to\n * the parent.\n *\n * Escape handling: this component does NOT globally bind Escape. Escape-to-close\n * is owned by AppDetails' own key handling (which first closes an open\n * screenshot gallery, then closes the card), so pressing Esc inside the gallery\n * returns to the card — not all the way to the home page (#38 Esc-stacking bug).\n */\nexport function AppDetailPanel({\n  app,\n  subResource,\n  onClose,\n  onAppClick,\n  onBackToParent,\n}: {\n  app: Resource\n  /** Selected child of `app`, when the URL carries `?sub=<slug>`. */\n  subResource?: Resource | null\n  onClose: () => void\n  onAppClick?: (app: Resource) => void\n  /** Clears `?sub=` and returns to the parent's detail. */\n  onBackToParent?: () => void\n}) {\n  const { approvalMethods, resources: allResources } = useAppCatalogContext()\n  const user = useOptionalUser()\n\n  // The sub-resource branch has no band of its own, so its slot payload is\n  // assembled here, where the catalog context already is, and handed down.\n  const subResourceActionsCtx = useMemo(\n    () => ({\n      resource: subResource ?? app,\n      parent: subResource ? app : undefined,\n      subResources: getChildResources(allResources, app.slug),\n      user: user ? { email: user.email, isAdmin: user.isAdmin ?? false } : null,\n    }),\n    [subResource, app, allResources, user],\n  )\n  const dialogRef = useRef<HTMLDivElement>(null)\n  // Not persisted: every open starts at the normal width. The toggle is for the\n  // one card being read, and the default stays readable for the next one.\n  const [isWide, setIsWide] = useState(false)\n\n  /**\n   * Centre the card ONCE when it opens, then hold that position.\n   *\n   * `my-auto` centred it on every render, so each panel height change pushed both\n   * edges and half the delta became upward movement of everything above it —\n   * including the tab strip, which moved 113px and took the control the user had\n   * just clicked with it (CLS 0.19, \"needs improvement\").\n   *\n   * Top-anchoring fixed the shift but looked wrong: a short card sat high on the\n   * page. So pin the centred offset instead. The card still opens centred, and\n   * anything that grows it afterwards extends downward only — which is what a\n   * reader expects when they open a tab with more in it.\n   *\n   * Only on open and on resize. Deliberately NOT on content change: reacting to\n   * content is precisely the bug.\n   */\n  useLayoutEffect(() => {\n    const card = dialogRef.current\n    const scroller = card?.parentElement\n    if (!card || !scroller) return\n\n    const pinCentre = () => {\n      card.style.marginTop = '0px'\n      const style = getComputedStyle(scroller)\n      const usable =\n        scroller.clientHeight -\n        parseFloat(style.paddingTop) -\n        parseFloat(style.paddingBottom)\n      const slack = usable - card.offsetHeight\n      // Negative slack means the card is already taller than the viewport; leave it\n      // at the top and let the overlay scroll, rather than pushing its head off.\n      card.style.marginTop = `${Math.max(0, Math.round(slack / 2))}px`\n    }\n\n    pinCentre()\n    window.addEventListener('resize', pinCentre)\n    return () => window.removeEventListener('resize', pinCentre)\n    // Keyed on the opened entry: a different card is a new open, and should\n    // re-centre for its own height.\n  }, [app.slug, subResource?.slug])\n\n  // Focus the dialog on mount so Esc hotkeys fire immediately, even when\n  // the card was opened by a mouse click (which leaves focus on the grid row).\n  //\n  // Unless something inside already took the caret — the Quick Jump field does,\n  // and it has the better claim: a child's effect runs before its parent's, so\n  // without this guard the card would take focus straight back off it.\n  //\n  // Runs again whenever the card navigates to another resource, keyed the same\n  // way the body below is: that navigation destroys whatever was focused (the\n  // \"View replacement\" button, a prerequisite's parent), and without this the\n  // caret would land on <body> — where the next Tab walks the catalog grid\n  // behind the scrim, since the card has no focus trap.\n  const shownSlug = subResource?.slug ?? app.slug\n  const stack = useDismissStack()\n  useEffect(() => {\n    const dialog = dialogRef.current\n    if (!dialog || dialog.contains(document.activeElement)) return\n    // Only while the card is on top. A layer opened OVER it — a deployment's\n    // dialog on a nested route — owns the caret, and on a cold deep link that\n    // layer mounts before the card does, so without this check the card took\n    // focus back off the dialog's first field the moment the catalog arrived.\n    const top = stack.topElement()\n    if (top && top !== dialog) return\n    dialog.focus()\n  }, [shownSlug, stack])\n\n  // Escape closes the card. Registered here rather than in AppDetails because\n  // this is the layer's element, and because the sub-resource view renders a\n  // different body in place of AppDetails — which left that view with no\n  // Escape at all while the registration lived in the body.\n  useDismissable(dialogRef, onClose)\n\n  return (\n    <div className=\"fixed inset-0 z-50 flex items-start justify-center overflow-y-auto p-4 sm:p-6 md:p-10\">\n      {/* scrim */}\n      <button\n        type=\"button\"\n        aria-label=\"Close details panel\"\n        onClick={onClose}\n        className=\"fixed inset-0 -z-10 bg-black/40 backdrop-blur-[2px] animate-in fade-in\"\n      />\n      {/* centered card — wide enough for data tables (sub-resources have 5\n          columns incl. \"Access Contacts\"/\"AWS Account\" that wrapped at 760px);\n          prose inside AppDetails is width-capped separately so it stays\n          readable. Caps at 94vw so it never touches the edges. */}\n      <div\n        ref={dialogRef}\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label={`${subResource?.displayName ?? app.displayName} details`}\n        tabIndex={-1}\n        // Centred on open, then held — see the pin effect above. `my-auto` is\n        // deliberately absent: it re-centres on EVERY height change, which is the\n        // layout-shift bug.\n        // `overflow-hidden` belongs on the rounded box: the scrolling child\n        // below carries the band's tint to its own square corners and paints\n        // them over this radius, so the card's top corners read as cut off.\n        // Widening drops the cap only. The pinned top margin is left alone, so\n        // the card's top edge stays put and restoring gives back the same layout.\n        className={`relative w-full ${isWide ? 'max-w-none' : 'max-w-[min(1120px,94vw)]'} overflow-hidden rounded-[var(--radius)] border border-border bg-background shadow-2xl animate-in fade-in zoom-in-95 duration-200 outline-none`}\n      >\n        <div className=\"absolute top-3 right-3 z-10 flex gap-1\">\n          <button\n            type=\"button\"\n            aria-label={isWide ? 'Restore width' : 'Widen card'}\n            title={isWide ? 'Restore width' : 'Widen card'}\n            onClick={() => setIsWide((wide) => !wide)}\n            className=\"rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors\"\n          >\n            {isWide ? (\n              <Minimize2 className=\"size-4\" />\n            ) : (\n              <Maximize2 className=\"size-4\" />\n            )}\n          </button>\n          <button\n            type=\"button\"\n            aria-label=\"Close\"\n            onClick={onClose}\n            className=\"rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors\"\n          >\n            <X className=\"size-4\" />\n          </button>\n        </div>\n        {/* Keyed by the resource on screen, so the body remounts when the card\n            navigates from one app to another (\"View replacement\", an access\n            prerequisite's parent) instead of updating in place. Everything\n            per-app inside it is component state with no reset of its own — the\n            roles table's expansion, the icon/screenshot error flags, a draft\n            source edit — and it used to arrive at the next app still carrying\n            the previous one's, plus the previous scroll offset.\n\n            The key is here and not on the outer dialog on purpose: that one\n            would restart the open animation and re-run the mount-focus effect\n            on every in-card navigation. */}\n        <div\n          key={shownSlug}\n          className=\"max-h-[85vh] overflow-y-auto px-6 py-5 sm:px-8 sm:py-7\"\n        >\n          {/* Inside the key, so anything a plugin provides here is scoped to\n              the resource on screen and is discarded when the card navigates.\n              Renders its children untouched when no plugin contributes. */}\n          <ResourceDetailProvider\n            resource={subResource ?? app}\n            parent={subResource ? app : undefined}\n          >\n            {subResource ? (\n              <SubResourceDetailPanel\n                subResource={subResource}\n                parent={app}\n                approvalMethods={approvalMethods}\n                onBack={onBackToParent ?? onClose}\n                actions={\n                  <ResourceDetailAccessActions {...subResourceActionsCtx} />\n                }\n              />\n            ) : (\n              <AppDetails app={app} onAppClick={onAppClick} />\n            )}\n          </ResourceDetailProvider>\n        </div>\n      </div>\n    </div>\n  )\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igstack/app-catalog-frontend-core",
-  "version": "6.7.0",
+  "version": "6.8.0",
   "description": "Frontend core library for App Catalog",
   "homepage": "https://github.com/lislon/app-catalog",
   "repository": {
@@ -118,7 +118,7 @@
     "tailwindcss": "^4.1.7",
     "tiptap-markdown": "^0.8.0",
     "tslib": "^2.3.0",
-    "@igstack/app-catalog-shared-core": "6.7.0"
+    "@igstack/app-catalog-shared-core": "6.8.0"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.0.5",
@@ -146,7 +146,7 @@
     "vite-plugin-static-copy": "^3.1.4",
     "vite-plugin-svgr": "^4.2.0",
     "vitest": "^4.1.2",
-    "@igstack/app-catalog-backend-core": "6.7.0"
+    "@igstack/app-catalog-backend-core": "6.8.0"
   },
   "peerDependencies": {
     "@tanstack/react-router": "1.170.41",
@@ -156,7 +156,7 @@
     "vite": "^6.3.5",
     "vite-plugin-svgr": "^4.2.0"
   },
-  "gitHead": "4d75acde50ae71295fee00fc17f87134becc949f",
+  "gitHead": "23f71eafc97012101c37c2939800b95f7a515851",
   "scripts": {
     "build": "vite build",
     "build:lenient": "vite build --mode lenient",

package/src/__tests__/modules/appCatalog/ui/catalog/AppDetailPanel.widen.test.tsx

@@ -0,0 +1,53 @@
+import type { Resource } from '@igstack/app-catalog-backend-core'
+import { fireEvent, render, screen } from '@testing-library/react'
+import userEvent from '@testing-library/user-event'
+import { describe, expect, it, vi } from 'vitest'
+import '@testing-library/jest-dom/vitest'
+
+vi.mock('~/modules/appCatalog/ui/detail/AppDetails', () => ({
+  AppDetails: () => <p>body</p>,
+}))
+vi.mock('~/modules/appCatalog/ui/components/SubResourceDetailPanel', () => ({
+  SubResourceDetailPanel: () => null,
+}))
+vi.mock('~/modules/appCatalog/context/AppCatalogContext', () => ({
+  useAppCatalogContext: vi.fn(() => ({ approvalMethods: [], resources: [] })),
+}))
+
+const { AppDetailPanel } =
+  await import('~/modules/appCatalog/ui/catalog/AppDetailPanel')
+
+const app = { slug: 'tracker', displayName: 'Tracker' } as Resource
+
+describe('AppDetailPanel — widen button', () => {
+  // jsdom has no layout, so the measured width is checked on the live site;
+  // here only the toggle and its cap.
+  it('toggles the card between its capped width and the full width', async () => {
+    const user = userEvent.setup()
+    render(<AppDetailPanel app={app} onClose={vi.fn()} />)
+    const dialog = screen.getByRole('dialog')
+    expect(dialog).not.toHaveClass('max-w-none')
+
+    await user.click(screen.getByRole('button', { name: 'Widen card' }))
+    expect(dialog).toHaveClass('max-w-none')
+
+    await user.click(screen.getByRole('button', { name: 'Restore width' }))
+    expect(dialog).not.toHaveClass('max-w-none')
+    expect(screen.getByRole('button', { name: 'Widen card' })).toBeVisible()
+  })
+
+  it('works from the keyboard and leaves Escape closing the card', async () => {
+    const user = userEvent.setup()
+    const onClose = vi.fn()
+    render(<AppDetailPanel app={app} onClose={onClose} />)
+
+    screen.getByRole('button', { name: 'Widen card' }).focus()
+    await user.keyboard('{Enter}')
+    expect(screen.getByRole('dialog')).toHaveClass('max-w-none')
+
+    fireEvent.keyDown(screen.getByRole('button', { name: 'Restore width' }), {
+      key: 'Escape',
+    })
+    expect(onClose).toHaveBeenCalledTimes(1)
+  })
+})

package/src/modules/appCatalog/ui/catalog/AppDetailPanel.tsx

@@ -1,6 +1,6 @@
 import type { Resource } from '@igstack/app-catalog-backend-core'
-import { X } from 'lucide-react'
-import { useEffect, useLayoutEffect, useMemo, useRef } from 'react'
+import { Maximize2, Minimize2, X } from 'lucide-react'
+import { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react'
 import { useAppCatalogContext } from '../../context/AppCatalogContext'
 import {
   ResourceDetailAccessActions,
@@ -57,6 +57,9 @@ export function AppDetailPanel({
     [subResource, app, allResources, user],
   )
   const dialogRef = useRef<HTMLDivElement>(null)
+  // Not persisted: every open starts at the normal width. The toggle is for the
+  // one card being read, and the default stays readable for the next one.
+  const [isWide, setIsWide] = useState(false)
 
   /**
    * Centre the card ONCE when it opens, then hold that position.
@@ -156,16 +159,33 @@ export function AppDetailPanel({
         // `overflow-hidden` belongs on the rounded box: the scrolling child
         // below carries the band's tint to its own square corners and paints
         // them over this radius, so the card's top corners read as cut off.
-        className="relative w-full max-w-[min(1120px,94vw)] overflow-hidden rounded-[var(--radius)] border border-border bg-background shadow-2xl animate-in fade-in zoom-in-95 duration-200 outline-none"
+        // Widening drops the cap only. The pinned top margin is left alone, so
+        // the card's top edge stays put and restoring gives back the same layout.
+        className={`relative w-full ${isWide ? 'max-w-none' : 'max-w-[min(1120px,94vw)]'} overflow-hidden rounded-[var(--radius)] border border-border bg-background shadow-2xl animate-in fade-in zoom-in-95 duration-200 outline-none`}
       >
-        <button
-          type="button"
-          aria-label="Close"
-          onClick={onClose}
-          className="absolute top-3 right-3 z-10 rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors"
-        >
-          <X className="size-4" />
-        </button>
+        <div className="absolute top-3 right-3 z-10 flex gap-1">
+          <button
+            type="button"
+            aria-label={isWide ? 'Restore width' : 'Widen card'}
+            title={isWide ? 'Restore width' : 'Widen card'}
+            onClick={() => setIsWide((wide) => !wide)}
+            className="rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors"
+          >
+            {isWide ? (
+              <Minimize2 className="size-4" />
+            ) : (
+              <Maximize2 className="size-4" />
+            )}
+          </button>
+          <button
+            type="button"
+            aria-label="Close"
+            onClick={onClose}
+            className="rounded-full p-1.5 text-muted-foreground hover:bg-accent hover:text-foreground transition-colors"
+          >
+            <X className="size-4" />
+          </button>
+        </div>
         {/* Keyed by the resource on screen, so the body remounts when the card
             navigates from one app to another ("View replacement", an access
             prerequisite's parent) instead of updating in place. Everything