@flanksource/clicky-ui 0.3.58 → 0.3.60

package/dist/overlay/DropdownMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"DropdownMenu.js","names":[],"sources":["../../src/overlay/DropdownMenu.tsx"],"sourcesContent":["import { useEffect, useRef, useState, type ReactNode } from \"react\";\nimport { Slot } from \"@radix-ui/react-slot\";\nimport {\n  autoUpdate,\n  flip,\n  FloatingFocusManager,\n  FloatingList,\n  FloatingNode,\n  FloatingPortal,\n  FloatingTree,\n  offset,\n  shift,\n  useClick,\n  useDismiss,\n  useFloating,\n  useFloatingNodeId,\n  useFloatingTree,\n  useInteractions,\n  useListNavigation,\n  useRole,\n} from \"@floating-ui/react\";\nimport { cn } from \"../lib/utils\";\nimport { Button, type ButtonProps } from \"../components/button\";\nimport { Icon, type StaticIconComponent } from \"../data/Icon\";\nimport { UiChevronDown } from \"../icons\";\nimport {\n  MENU_POPOVER_CLASS,\n  MenuContext,\n  menuViewportSize,\n} from \"./dropdownMenuContext\";\nimport { MenuItemList } from \"./DropdownMenuSubmenu\";\nimport { useEscapeLayer, useFloatingZIndex } from \"./modalStack\";\n\nexport type DropdownMenuItem = {\n  /** Visible label. */\n  label: ReactNode;\n  /** Called when the item is chosen. Ignored when the item has `children`. */\n  onSelect: () => void;\n  /** Iconify name or imported icon component rendered before the label. */\n  icon?: string | StaticIconComponent;\n  /** CSS colour applied to this item's icon (the glyph fills `currentColor`). */\n  iconColor?: string;\n  /** Theme-aware classes applied to this item's icon. */\n  iconClassName?: string | undefined;\n  /**\n   * Section header. A non-interactive header renders above the first item of\n   * each contiguous group — provide items pre-sorted by `group`. Items without\n   * a `group` render no header.\n   */\n  group?: string;\n  /** Browser tooltip for the item. */\n  title?: string;\n  /** Disable selection. */\n  disabled?: boolean;\n  /**\n   * Nested submenu items. When present the item becomes a submenu trigger: it\n   * opens a flyout of `children` (recursively) on hover / click / ArrowRight\n   * instead of firing `onSelect`.\n   */\n  children?: DropdownMenuItem[];\n  /** Editor or explanatory content above a submenu's choices. */\n  header?: ReactNode;\n};\n\nexport type DropdownMenuProps = {\n  /** Trigger label. Ignored when `trigger` is provided. */\n  label?: ReactNode;\n  /** Icon shown before the trigger label. Ignored when `trigger` is provided. */\n  icon?: string | StaticIconComponent;\n  /** Hide the trailing chevron on the default trigger. */\n  hideChevron?: boolean;\n  /** Variant forwarded to the default Button trigger. */\n  variant?: ButtonProps[\"variant\"];\n  /** Size forwarded to the default Button trigger. */\n  size?: ButtonProps[\"size\"];\n  /** Custom trigger element. Its root receives menu state and interaction props. */\n  trigger?: ReactNode;\n  /** Declarative menu items. Provide this or `children`, not both. */\n  items?: DropdownMenuItem[];\n  /** Custom menu content. Use `closeMenu` to dismiss after a selection. */\n  children?: (closeMenu: () => void) => ReactNode;\n  /** Rendered at the top of the menu, above the items/children. */\n  header?: ReactNode;\n  /** Rendered at the bottom of the menu, below the items/children (e.g. a \"Show more…\" link). */\n  footer?: ReactNode;\n  /** Horizontal alignment of the menu relative to the trigger. */\n  align?: \"left\" | \"right\";\n  /** Notified whenever the menu opens or closes. */\n  onOpenChange?: (open: boolean) => void;\n  /** Browser tooltip / accessible label for the default trigger. */\n  title?: string;\n  /** Accessible label (`aria-label`) for the floating menu element itself. */\n  menuLabel?: string;\n  /** Classes applied to the wrapper. */\n  className?: string;\n  /** Classes applied to the floating menu. */\n  menuClassName?: string;\n};\n\n/**\n * A trigger + floating menu. Flat `items` render as a single list; an item with\n * `children` opens a flyout submenu. The FloatingTree lets every level cooperate\n * on focus and dismissal, so selecting any leaf closes the whole menu.\n */\nexport function DropdownMenu(props: DropdownMenuProps) {\n  return (\n    <FloatingTree>\n      <DropdownMenuRoot {...props} />\n    </FloatingTree>\n  );\n}\n\nfunction DropdownMenuRoot({\n  label,\n  icon,\n  hideChevron = false,\n  variant = \"outline\",\n  size = \"sm\",\n  trigger,\n  items,\n  children,\n  header,\n  footer,\n  align = \"right\",\n  onOpenChange,\n  title,\n  menuLabel,\n  className,\n  menuClassName,\n}: DropdownMenuProps) {\n  const [open, setOpen] = useState(false);\n  const [activeIndex, setActiveIndex] = useState<number | null>(null);\n  const floatingZ = useFloatingZIndex();\n  const tree = useFloatingTree();\n  const nodeId = useFloatingNodeId();\n  const elementsRef = useRef<Array<HTMLElement | null>>([]);\n\n  const onOpenChangeRef = useRef(onOpenChange);\n  onOpenChangeRef.current = onOpenChange;\n  useEffect(() => {\n    onOpenChangeRef.current?.(open);\n  }, [open]);\n\n  const { refs, floatingStyles, context } = useFloating<HTMLDivElement>({\n    // nodeId is always defined inside the FloatingTree; guard for the type only.\n    ...(nodeId ? { nodeId } : {}),\n    open,\n    onOpenChange: setOpen,\n    // bottom-end / bottom-start reproduce the previous right/left alignment.\n    placement: align === \"right\" ? \"bottom-end\" : \"bottom-start\",\n    whileElementsMounted: autoUpdate,\n    // offset(4) ≈ the previous mt-1; flip opens upward at the bottom edge and\n    // shift slides the menu back on-screen at the horizontal edges.\n    middleware: [\n      offset(4),\n      flip({ padding: 8 }),\n      shift({ padding: 8 }),\n      menuViewportSize,\n    ],\n  });\n\n  const click = useClick(context);\n  // useDismiss is React-tree aware: a press inside anything rendered through the\n  // menu's `children` render-prop — including a Modal that portals to\n  // document.body — propagates via React's synthetic events to the floating\n  // element and counts as \"inside\", so it won't dismiss the menu (which would\n  // unmount that child Modal). A Modal owned by a sibling/parent instead of this\n  // menu correctly does dismiss the menu, which is harmless since closing the\n  // menu does not unmount a Modal it doesn't own.\n  const dismiss = useDismiss(context, { escapeKey: false });\n  const role = useRole(context, { role: \"menu\" });\n  const listNav = useListNavigation(context, {\n    listRef: elementsRef,\n    activeIndex,\n    onNavigate: setActiveIndex,\n    loop: true,\n  });\n\n  const { getReferenceProps, getFloatingProps, getItemProps } = useInteractions(\n    [click, dismiss, role, listNav],\n  );\n\n  const closeMenu = () => {\n    setOpen(false);\n    if (refs.domReference.current instanceof HTMLElement)\n      refs.domReference.current.focus();\n  };\n  useEscapeLayer(open, closeMenu);\n\n  // Selecting any leaf (at any depth) emits a tree-wide \"click\"; the root closes\n  // and restores focus to the trigger.\n  const closeMenuRef = useRef(closeMenu);\n  closeMenuRef.current = closeMenu;\n  useEffect(() => {\n    if (!tree) return;\n    const onTreeClick = () => closeMenuRef.current();\n    tree.events.on(\"click\", onTreeClick);\n    return () => tree.events.off(\"click\", onTreeClick);\n  }, [tree]);\n\n  return (\n    <FloatingNode id={nodeId}>\n      <div className={cn(\"relative inline-flex\", className)}>\n        {trigger ? (\n          <Slot\n            ref={refs.setReference}\n            className=\"inline-flex\"\n            aria-haspopup=\"menu\"\n            aria-expanded={open}\n            {...getReferenceProps()}\n          >\n            {trigger}\n          </Slot>\n        ) : (\n          <Button\n            ref={refs.setReference as React.Ref<HTMLButtonElement>}\n            // Opening a menu never submits the form the trigger sits in.\n            type=\"button\"\n            variant={variant}\n            size={size}\n            title={title}\n            aria-haspopup=\"menu\"\n            aria-expanded={open}\n            {...getReferenceProps()}\n          >\n            {icon && (\n              <Icon\n                {...(typeof icon === \"string\" ? { name: icon } : { icon })}\n              />\n            )}\n            {label}\n            {!hideChevron && <Icon icon={UiChevronDown} />}\n          </Button>\n        )}\n        {open && (\n          <FloatingPortal>\n            <FloatingFocusManager\n              context={context}\n              modal={false}\n              closeOnFocusOut={false}\n            >\n              <div\n                ref={refs.setFloating}\n                {...getFloatingProps()}\n                role=\"menu\"\n                aria-label={menuLabel}\n                {...(menuLabel ? { \"aria-labelledby\": undefined } : {})}\n                style={{ ...floatingStyles, zIndex: floatingZ }}\n                className={cn(MENU_POPOVER_CLASS, menuClassName)}\n              >\n                {header != null && (\n                  <div className=\"border-b border-border px-3 py-1.5\">\n                    {header}\n                  </div>\n                )}\n                {children ? (\n                  children(closeMenu)\n                ) : (\n                  <MenuContext.Provider\n                    value={{\n                      getItemProps,\n                      activeIndex,\n                      setActiveIndex,\n                      setHasFocusInside: () => {},\n                      isOpen: open,\n                    }}\n                  >\n                    <FloatingList elementsRef={elementsRef}>\n                      <MenuItemList items={items ?? []} />\n                    </FloatingList>\n                  </MenuContext.Provider>\n                )}\n                {footer != null && (\n                  <div className=\"border-t border-border px-3 py-1.5\">\n                    {footer}\n                  </div>\n                )}\n              </div>\n            </FloatingFocusManager>\n          </FloatingPortal>\n        )}\n      </div>\n    </FloatingNode>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"DropdownMenu.js","names":[],"sources":["../../src/overlay/DropdownMenu.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState, type ReactNode } from \"react\";\nimport { Slot } from \"@radix-ui/react-slot\";\nimport {\n  autoUpdate,\n  flip,\n  FloatingFocusManager,\n  FloatingList,\n  FloatingNode,\n  FloatingPortal,\n  FloatingTree,\n  offset,\n  shift,\n  useClick,\n  useDismiss,\n  useFloating,\n  useFloatingNodeId,\n  useFloatingTree,\n  useInteractions,\n  useListNavigation,\n  useRole,\n} from \"@floating-ui/react\";\nimport { cn } from \"../lib/utils\";\nimport { Button, type ButtonProps } from \"../components/button\";\nimport { Icon, type StaticIconComponent } from \"../data/Icon\";\nimport { UiChevronDown } from \"../icons\";\nimport {\n  MENU_POPOVER_CLASS,\n  MenuContext,\n  menuViewportSize,\n} from \"./dropdownMenuContext\";\nimport { MenuItemList } from \"./DropdownMenuSubmenu\";\nimport { useEscapeLayer, useFloatingZIndex } from \"./modalStack\";\n\nexport type DropdownMenuItem = {\n  /** Visible label. */\n  label: ReactNode;\n  /** Called when the item is chosen. Ignored when the item has `children`. */\n  onSelect: () => void;\n  /** Iconify name or imported icon component rendered before the label. */\n  icon?: string | StaticIconComponent;\n  /** CSS colour applied to this item's icon (the glyph fills `currentColor`). */\n  iconColor?: string;\n  /** Theme-aware classes applied to this item's icon. */\n  iconClassName?: string | undefined;\n  /**\n   * Section header. A non-interactive header renders above the first item of\n   * each contiguous group — provide items pre-sorted by `group`. Items without\n   * a `group` render no header.\n   */\n  group?: string;\n  /** Browser tooltip for the item. */\n  title?: string;\n  /** Disable selection. */\n  disabled?: boolean;\n  /**\n   * Nested submenu items. When present the item becomes a submenu trigger: it\n   * opens a flyout of `children` (recursively) on hover / click / ArrowRight\n   * instead of firing `onSelect`.\n   */\n  children?: DropdownMenuItem[];\n  /** Editor or explanatory content above a submenu's choices. */\n  header?: ReactNode;\n};\n\nexport type DropdownMenuProps = {\n  role?: \"menu\" | \"dialog\";\n  /** Trigger label. Ignored when `trigger` is provided. */\n  label?: ReactNode;\n  /** Icon shown before the trigger label. Ignored when `trigger` is provided. */\n  icon?: string | StaticIconComponent;\n  /** Hide the trailing chevron on the default trigger. */\n  hideChevron?: boolean;\n  /** Variant forwarded to the default Button trigger. */\n  variant?: ButtonProps[\"variant\"];\n  /** Size forwarded to the default Button trigger. */\n  size?: ButtonProps[\"size\"];\n  /** Custom trigger element. Its root receives menu state and interaction props. */\n  trigger?: ReactNode;\n  /** Declarative menu items. Provide this or `children`, not both. */\n  items?: DropdownMenuItem[];\n  /** Custom menu content. Use `closeMenu` to dismiss after a selection. */\n  children?: (closeMenu: () => void) => ReactNode;\n  /** Rendered at the top of the menu, above the items/children. */\n  header?: ReactNode;\n  /** Rendered at the bottom of the menu, below the items/children (e.g. a \"Show more…\" link). */\n  footer?: ReactNode;\n  /** Horizontal alignment of the menu relative to the trigger. */\n  align?: \"left\" | \"right\";\n  /** Notified whenever the menu opens or closes. */\n  onOpenChange?: (open: boolean) => void;\n  /** Browser tooltip / accessible label for the default trigger. */\n  title?: string;\n  /** Accessible label (`aria-label`) for the floating menu element itself. */\n  menuLabel?: string;\n  /** Classes applied to the wrapper. */\n  className?: string;\n  /** Classes applied to the floating menu. */\n  menuClassName?: string;\n};\n\n/**\n * A trigger + floating menu. Flat `items` render as a single list; an item with\n * `children` opens a flyout submenu. The FloatingTree lets every level cooperate\n * on focus and dismissal, so selecting any leaf closes the whole menu.\n */\nexport function DropdownMenu(props: DropdownMenuProps) {\n  return (\n    <FloatingTree>\n      <DropdownMenuRoot {...props} />\n    </FloatingTree>\n  );\n}\n\nfunction DropdownMenuRoot({\n  role: popupRole = \"menu\",\n  label,\n  icon,\n  hideChevron = false,\n  variant = \"outline\",\n  size = \"sm\",\n  trigger,\n  items,\n  children,\n  header,\n  footer,\n  align = \"right\",\n  onOpenChange,\n  title,\n  menuLabel,\n  className,\n  menuClassName,\n}: DropdownMenuProps) {\n  const [open, setOpen] = useState(false);\n  const [activeIndex, setActiveIndex] = useState<number | null>(null);\n  const floatingZ = useFloatingZIndex();\n  const tree = useFloatingTree();\n  const nodeId = useFloatingNodeId();\n  const elementsRef = useRef<Array<HTMLElement | null>>([]);\n\n  // Every open/close goes through here, so the host hears each change from the\n  // event that caused it rather than from an effect after the render.\n  const changeOpen = (next: boolean) => {\n    if (next === open) return;\n    setOpen(next);\n    onOpenChange?.(next);\n  };\n\n  const { refs, floatingStyles, context } = useFloating<HTMLDivElement>({\n    // nodeId is always defined inside the FloatingTree; guard for the type only.\n    ...(nodeId ? { nodeId } : {}),\n    open,\n    onOpenChange: changeOpen,\n    // bottom-end / bottom-start reproduce the previous right/left alignment.\n    placement: align === \"right\" ? \"bottom-end\" : \"bottom-start\",\n    whileElementsMounted: autoUpdate,\n    // offset(4) ≈ the previous mt-1; flip opens upward at the bottom edge and\n    // shift slides the menu back on-screen at the horizontal edges.\n    middleware: [\n      offset(4),\n      flip({ padding: 8 }),\n      shift({ padding: 8 }),\n      menuViewportSize,\n    ],\n  });\n\n  const click = useClick(context);\n  // useDismiss is React-tree aware: a press inside anything rendered through the\n  // menu's `children` render-prop — including a Modal that portals to\n  // document.body — propagates via React's synthetic events to the floating\n  // element and counts as \"inside\", so it won't dismiss the menu (which would\n  // unmount that child Modal). A Modal owned by a sibling/parent instead of this\n  // menu correctly does dismiss the menu, which is harmless since closing the\n  // menu does not unmount a Modal it doesn't own.\n  const dismiss = useDismiss(context, { escapeKey: false });\n  const role = useRole(context, { role: popupRole });\n  const listNav = useListNavigation(context, {\n    listRef: elementsRef,\n    activeIndex,\n    onNavigate: setActiveIndex,\n    loop: true,\n  });\n\n  const { getReferenceProps, getFloatingProps, getItemProps } = useInteractions(\n    [click, dismiss, role, ...(popupRole === \"menu\" ? [listNav] : [])],\n  );\n\n  const closeMenu = () => {\n    changeOpen(false);\n    if (refs.domReference.current instanceof HTMLElement)\n      refs.domReference.current.focus();\n  };\n  useEscapeLayer(open, closeMenu);\n\n  // Selecting any leaf (at any depth) emits a tree-wide \"click\"; the root closes\n  // and restores focus to the trigger.\n  // The listener subscribes once per tree; it reads the latest closeMenu,\n  // which is published after each commit rather than during render.\n  const closeMenuRef = useRef(closeMenu);\n  useLayoutEffect(() => {\n    closeMenuRef.current = closeMenu;\n  });\n  useEffect(() => {\n    if (!tree) return;\n    const onTreeClick = () => closeMenuRef.current();\n    tree.events.on(\"click\", onTreeClick);\n    return () => tree.events.off(\"click\", onTreeClick);\n  }, [tree]);\n\n  return (\n    <FloatingNode id={nodeId}>\n      <div className={cn(\"relative inline-flex\", className)}>\n        {trigger ? (\n          <Slot\n            ref={refs.setReference}\n            className=\"inline-flex\"\n            aria-haspopup={popupRole}\n            aria-expanded={open}\n            {...getReferenceProps()}\n          >\n            {trigger}\n          </Slot>\n        ) : (\n          <Button\n            ref={refs.setReference as React.Ref<HTMLButtonElement>}\n            // Opening a menu never submits the form the trigger sits in.\n            type=\"button\"\n            variant={variant}\n            size={size}\n            title={title}\n            aria-haspopup={popupRole}\n            aria-expanded={open}\n            {...getReferenceProps()}\n          >\n            {icon && (\n              <Icon\n                {...(typeof icon === \"string\" ? { name: icon } : { icon })}\n              />\n            )}\n            {label}\n            {!hideChevron && <Icon icon={UiChevronDown} />}\n          </Button>\n        )}\n        {open && (\n          <FloatingPortal>\n            <FloatingFocusManager\n              context={context}\n              modal={false}\n              closeOnFocusOut={false}\n            >\n              <div\n                ref={refs.setFloating}\n                {...getFloatingProps()}\n                role={popupRole}\n                aria-modal={popupRole === \"dialog\" ? false : undefined}\n                aria-label={menuLabel}\n                {...(menuLabel ? { \"aria-labelledby\": undefined } : {})}\n                style={{ ...floatingStyles, zIndex: floatingZ }}\n                className={cn(MENU_POPOVER_CLASS, menuClassName)}\n              >\n                {header != null && (\n                  <div className=\"border-b border-border px-3 py-1.5\">\n                    {header}\n                  </div>\n                )}\n                {children ? (\n                  children(closeMenu)\n                ) : (\n                  <MenuContext.Provider\n                    value={{\n                      getItemProps,\n                      activeIndex,\n                      setActiveIndex,\n                      setHasFocusInside: () => {},\n                      isOpen: open,\n                    }}\n                  >\n                    <FloatingList elementsRef={elementsRef}>\n                      <MenuItemList items={items ?? []} />\n                    </FloatingList>\n                  </MenuContext.Provider>\n                )}\n                {footer != null && (\n                  <div className=\"border-t border-border px-3 py-1.5\">\n                    {footer}\n                  </div>\n                )}\n              </div>\n            </FloatingFocusManager>\n          </FloatingPortal>\n        )}\n      </div>\n    </FloatingNode>\n  );\n}\n"],"mappings":"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"}

package/dist/rpc/EntityExplorerApp.cjs

@@ -4,6 +4,7 @@ const require_AppShell = require("../layout/AppShell.cjs");
 const require_useOperations = require("./useOperations.cjs");
 const require_clickyMetadata = require("./clickyMetadata.cjs");
 const require_OperationCatalog = require("./OperationCatalog.cjs");
+const require_explorer_nav_context = require("./explorer-nav-context.cjs");
 const require_commandHref = require("./commandHref.cjs");
 const require_OperationCommandPage = require("./OperationCommandPage.cjs");
 const require_OperationEntityPage = require("./OperationEntityPage.cjs");
@@ -12,7 +13,7 @@ let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 // src/rpc/EntityExplorerApp.tsx
 var SIDEBAR_COLLAPSED_KEY = "clicky-ui:sidebar:collapsed";
-function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, actions, formExtensions, formActions, surfaceActionLabels, resultRenderer, entityDetailBodyRenderer, entityDetailHeaderRenderer }) {
+function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, actions, formExtensions, formActions, surfaceActionLabels, resultRenderer, entityDetailBodyRenderer, entityDetailHeaderRenderer, surfaceTitleActions, surfacePaginationMode }) {
 	const formPre = formExtensions?.pre;
 	const formPost = formExtensions?.post;
 	const { pathname, renderLink, navigate } = require_router.useRouter();
@@ -64,6 +65,26 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 		showApiExplorer,
 		explorerDefinition
 	]);
+	const [navContainer, setNavContainer] = (0, react.useState)(null);
+	const [navClaims, setNavClaims] = (0, react.useState)(0);
+	const claimNav = (0, react.useCallback)(() => {
+		setNavClaims((count) => count + 1);
+		return () => setNavClaims((count) => count - 1);
+	}, []);
+	const surface = resolvedRoute.kind === "surface" ? resolvedRoute.surface : void 0;
+	const titleActions = surface ? surfaceTitleActions?.(surface.key) : void 0;
+	const paginationMode = surface ? surfacePaginationMode?.(surface.key) : void 0;
+	const navSlot = (0, react.useMemo)(() => ({
+		container: surface ? navContainer : null,
+		title: surface?.title ?? "",
+		titleActions,
+		claim: claimNav
+	}), [
+		claimNav,
+		navContainer,
+		surface,
+		titleActions
+	]);
 	(0, react.useEffect)(() => {
 		if (defaultSurface == null || relativePath !== "/") return;
 		navigate(require_commandHref.withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });
@@ -73,7 +94,7 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 		relativePath,
 		navigate
 	]);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_AppShell.AppShell, {
+	const content = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_AppShell.AppShell, {
 		brand: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "min-w-0",
 			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -87,16 +108,27 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 		navSections,
 		sidebarFooter: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_theme_switcher.ThemeSwitcher, {}),
 		...actions ? { actions } : {},
-		...resolvedRoute.kind === "surface" && resolvedRoute.surface ? { nav: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		...resolvedRoute.kind === "surface" && resolvedRoute.surface ? { nav: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [navClaims === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 			className: "flex min-w-0 flex-1 items-baseline gap-density-2",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
-				className: "min-w-0 truncate text-base font-semibold tracking-tight",
-				children: resolvedRoute.surface.title
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				className: "hidden min-w-0 truncate text-sm text-muted-foreground lg:block",
-				children: require_clickyMetadata.makeSurfaceDefinition(resolvedRoute.surface).description
-			})]
-		}) } : {},
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
+					className: "min-w-0 truncate text-base font-semibold tracking-tight",
+					children: resolvedRoute.surface.title
+				}),
+				titleActions ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "flex shrink-0 items-center self-center",
+					children: titleActions
+				}) : null,
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "hidden min-w-0 truncate text-sm text-muted-foreground lg:block",
+					children: require_clickyMetadata.makeSurfaceDefinition(resolvedRoute.surface).description
+				})
+			]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			ref: setNavContainer,
+			"data-slot": "explorer-nav",
+			className: "contents"
+		})] }) } : {},
 		collapsedStorageKey: SIDEBAR_COLLAPSED_KEY,
 		contentWidth: "full",
 		contentClassName: "p-6",
@@ -111,7 +143,8 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 			...formPost ? { formPost } : {},
 			...formActions ? { formActions } : {},
 			...surfaceActionLabels?.[resolvedRoute.surface.key] ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] } : {},
-			...resultRenderer ? { resultRenderer } : {}
+			...resultRenderer ? { resultRenderer } : {},
+			...paginationMode ? { paginationMode } : {}
 		}, resolvedRoute.surface.key) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "entity" ? resolvedRoute.surface ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_OperationEntityPage.OperationEntityPage, {
 			definition: require_clickyMetadata.makeSurfaceDefinition(resolvedRoute.surface),
 			entities: [resolvedRoute.surface.entity],
@@ -152,6 +185,10 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 			children: "Redirecting…"
 		})
 	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_explorer_nav_context.ExplorerNavContext.Provider, {
+		value: navSlot,
+		children: content
+	});
 }
 function parseExplorerRoute(pathname) {
 	const normalized = require_commandHref.trimTrailingSlash(pathname) || "/";

package/dist/rpc/EntityExplorerApp.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"EntityExplorerApp.cjs","names":["useRouter","useOperations","useMemo","getClickySurfaces","buildCommandHref","surfaceNavSection","withBasePath","_jsx","AppShell","ThemeSwitcher","makeSurfaceDefinition","OperationCatalog","OperationEntityPage","OperationCommandPage","trimTrailingSlash","ARG_QUERY_PREFIX"],"sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useEffect, useMemo, type ReactNode } from \"react\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { PreExtension, PostExtension } from \"../components/json-schema-form-types\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport { AppShell, type AppShellNavSection } from \"../layout/AppShell\";\nimport { getClickySurfaces, makeSurfaceDefinition } from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport type { ResultRenderer } from \"./OperationResultView\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport {\n  OperationEntityPage,\n  type EntityDetailBodyRenderer,\n  type EntityDetailHeaderRenderer,\n} from \"./OperationEntityPage\";\nimport type { FormActionsRenderer } from \"./SchemaActionForm\";\nimport { surfaceNavSection } from \"./surfaceNav\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type SurfaceActionLabels = Record<string, Record<string, string>>;\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  /** Right-aligned top-bar cluster forwarded to AppShell's actions slot. */\n  actions?: ReactNode;\n  /**\n   * Custom JsonSchemaForm field extensions applied to every create/edit form the\n   * explorer renders — e.g. a SecretKeySelector widget keyed on an\n   * `x-clicky-component` schema hint. `pre` transforms a resolved control; `post`\n   * can replace the rendered value node with a custom component.\n   */\n  formExtensions?: { pre?: PreExtension[]; post?: PostExtension[] };\n  /**\n   * Optional extra footer actions added to every create/edit form (e.g. a\n   * connection \"Test\" split-button). The renderer receives the live form value\n   * and the action it submits to, so it can scope itself to a given entity.\n   */\n  formActions?: FormActionsRenderer;\n  /** Per-surface labels keyed by x-clicky verb/actionName. */\n  surfaceActionLabels?: SurfaceActionLabels;\n  /**\n   * @deprecated Superseded by per-surface icons emitted by the backend\n   * (x-clicky-icon → ClickySurface.icon). AppShell section labels are plain\n   * strings, so this group-header icon map is no longer rendered. Kept for\n   * source-compatibility only.\n   */\n  surfaceIcons?: Record<string, ReactNode>;\n  /**\n   * Optional host override for the result surface. Called where an entity's\n   * result table renders, with the current surface key, the raw response, and\n   * the default OperationResultView element. Return `defaultView` to keep the\n   * standard table, or a custom node (e.g. a LogsTable for trace/log profiles\n   * flagged via x-clicky-render). Filtering/sorting policy is the host's choice.\n   */\n  resultRenderer?: ResultRenderer;\n  /** Host override for a loaded entity's body; heading and actions remain. */\n  entityDetailBodyRenderer?: EntityDetailBodyRenderer;\n  /** Host override for a loaded entity's \"{title}: {id}\" heading. */\n  entityDetailHeaderRenderer?: EntityDetailHeaderRenderer;\n};\n\n// SIDEBAR_COLLAPSED_KEY persists the AppShell rail collapsed flag across reloads.\nconst SIDEBAR_COLLAPSED_KEY = \"clicky-ui:sidebar:collapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  actions,\n  formExtensions,\n  formActions,\n  surfaceActionLabels,\n  resultRenderer,\n  entityDetailBodyRenderer,\n  entityDetailHeaderRenderer,\n}: EntityExplorerAppProps) {\n  const formPre = formExtensions?.pre;\n  const formPost = formExtensions?.post;\n  const { pathname, renderLink, navigate } = useRouter();\n  const { spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n  const navSections = useMemo<AppShellNavSection[]>(() => {\n    const sections: AppShellNavSection[] = surfaceGroups.map((group) =>\n      surfaceNavSection(group.label, group.surfaces, {\n        isActive: (surface) => isSurfaceRouteActive(resolvedRoute, surface.key),\n        hrefFor: (surface) => withBasePath(basePath, `/${surface.key}`),\n      }),\n    );\n    if (showApiExplorer) {\n      sections.push({\n        items: [\n          {\n            key: explorerDefinition.key,\n            label: explorerDefinition.title,\n            active: resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n            to: withBasePath(basePath, \"/explorer\"),\n          },\n        ],\n      });\n    }\n    return sections;\n  }, [surfaceGroups, basePath, resolvedRoute, showApiExplorer, explorerDefinition]);\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <AppShell\n      brand={\n        <div className=\"min-w-0\">\n          <div className=\"truncate text-sm font-semibold\">\n            {spec?.info.title ?? \"Clicky Explorer\"}\n          </div>\n          <div className=\"truncate text-xs text-sidebar-foreground/60\">\n            Metadata-driven entity explorer\n          </div>\n        </div>\n      }\n      navSections={navSections}\n      sidebarFooter={<ThemeSwitcher />}\n      {...(actions ? { actions } : {})}\n      // The page header belongs to the host, not to OperationCatalog — the\n      // catalog renders only its results. OperationEntityPage still titles\n      // itself, so this covers the collection route only.\n      //\n      // It rides in the top bar rather than a bodyHeader row: next to the rail\n      // that bar is otherwise empty, and the row it replaces cost the result\n      // table ~72px of the viewport it needs to keep its sticky head and\n      // pagination footer on screen without the page itself scrolling.\n      {...(resolvedRoute.kind === \"surface\" && resolvedRoute.surface\n        ? {\n            nav: (\n              <div className=\"flex min-w-0 flex-1 items-baseline gap-density-2\">\n                <h1 className=\"min-w-0 truncate text-base font-semibold tracking-tight\">\n                  {resolvedRoute.surface.title}\n                </h1>\n                <p className=\"hidden min-w-0 truncate text-sm text-muted-foreground lg:block\">\n                  {makeSurfaceDefinition(resolvedRoute.surface).description}\n                </p>\n              </div>\n            ),\n          }\n        : {})}\n      collapsedStorageKey={SIDEBAR_COLLAPSED_KEY}\n      // Results are wide tables, not prose — let them use the whole workspace\n      // instead of the centred reading column.\n      contentWidth=\"full\"\n      contentClassName=\"p-6\"\n    >\n      {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              // Filter state is seeded from the URL when the catalog mounts and\n              // written back to it, so one instance spanning two surfaces would\n              // carry the first surface's filters onto the second's URL. Keying\n              // on the surface makes each one start from its own query string.\n              key={resolvedRoute.surface.key}\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(resultRenderer ? { resultRenderer } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(entityDetailBodyRenderer ? { entityDetailBodyRenderer } : {})}\n            {...(entityDetailHeaderRenderer ? { entityDetailHeaderRenderer } : {})}\n            {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n    </AppShell>\n  );\n\n  return content;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"mappings":"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"}
+{"version":3,"file":"EntityExplorerApp.cjs","names":["useRouter","useOperations","useMemo","getClickySurfaces","buildCommandHref","surfaceNavSection","withBasePath","useState","useCallback","AppShell","ThemeSwitcher","_Fragment","makeSurfaceDefinition","OperationCatalog","OperationEntityPage","OperationCommandPage","ExplorerNavContext","trimTrailingSlash","ARG_QUERY_PREFIX"],"sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { ExplorerNavContext, type ExplorerNavSlot } from \"./explorer-nav-context\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { PreExtension, PostExtension } from \"../components/json-schema-form-types\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport { AppShell, type AppShellNavSection } from \"../layout/AppShell\";\nimport { getClickySurfaces, makeSurfaceDefinition } from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport type { ResultRenderer } from \"./OperationResultView\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport {\n  OperationEntityPage,\n  type EntityDetailBodyRenderer,\n  type EntityDetailHeaderRenderer,\n} from \"./OperationEntityPage\";\nimport type { FormActionsRenderer } from \"./SchemaActionForm\";\nimport { surfaceNavSection } from \"./surfaceNav\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type SurfaceActionLabels = Record<string, Record<string, string>>;\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  /** Right-aligned top-bar cluster forwarded to AppShell's actions slot. */\n  actions?: ReactNode;\n  /**\n   * Custom JsonSchemaForm field extensions applied to every create/edit form the\n   * explorer renders — e.g. a SecretKeySelector widget keyed on an\n   * `x-clicky-component` schema hint. `pre` transforms a resolved control; `post`\n   * can replace the rendered value node with a custom component.\n   */\n  formExtensions?: { pre?: PreExtension[]; post?: PostExtension[] };\n  /**\n   * Optional extra footer actions added to every create/edit form (e.g. a\n   * connection \"Test\" split-button). The renderer receives the live form value\n   * and the action it submits to, so it can scope itself to a given entity.\n   */\n  formActions?: FormActionsRenderer;\n  /** Per-surface labels keyed by x-clicky verb/actionName. */\n  surfaceActionLabels?: SurfaceActionLabels;\n  /**\n   * @deprecated Superseded by per-surface icons emitted by the backend\n   * (x-clicky-icon → ClickySurface.icon). AppShell section labels are plain\n   * strings, so this group-header icon map is no longer rendered. Kept for\n   * source-compatibility only.\n   */\n  surfaceIcons?: Record<string, ReactNode>;\n  /**\n   * Optional host override for the result surface. Called where an entity's\n   * result table renders, with the current surface key, the raw response, and\n   * the default OperationResultView element. Return `defaultView` to keep the\n   * standard table, or a custom node (e.g. a LogsTable for trace/log profiles\n   * flagged via x-clicky-render). Filtering/sorting policy is the host's choice.\n   */\n  resultRenderer?: ResultRenderer;\n  /** Host override for a loaded entity's body; heading and actions remain. */\n  entityDetailBodyRenderer?: EntityDetailBodyRenderer;\n  /** Host override for a loaded entity's \"{title}: {id}\" heading. */\n  entityDetailHeaderRenderer?: EntityDetailHeaderRenderer;\n  /** Compact host controls (e.g. an edit icon) shown right after a surface's title or breadcrumb in the top bar. */\n  surfaceTitleActions?: (surfaceKey: string) => ReactNode;\n  /**\n   * Per-surface paging presentation, forwarded to OperationCatalog's\n   * `paginationMode`. Return undefined to keep automatic selection (a cursor\n   * walk whenever the list declares a cursor); return \"paged\" for a surface\n   * whose readers need prev/next offset controls.\n   */\n  surfacePaginationMode?: (surfaceKey: string) => \"paged\" | \"infinite\" | undefined;\n};\n\n// SIDEBAR_COLLAPSED_KEY persists the AppShell rail collapsed flag across reloads.\nconst SIDEBAR_COLLAPSED_KEY = \"clicky-ui:sidebar:collapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  actions,\n  formExtensions,\n  formActions,\n  surfaceActionLabels,\n  resultRenderer,\n  entityDetailBodyRenderer,\n  entityDetailHeaderRenderer,\n  surfaceTitleActions,\n  surfacePaginationMode,\n}: EntityExplorerAppProps) {\n  const formPre = formExtensions?.pre;\n  const formPost = formExtensions?.post;\n  const { pathname, renderLink, navigate } = useRouter();\n  const { spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n  const navSections = useMemo<AppShellNavSection[]>(() => {\n    const sections: AppShellNavSection[] = surfaceGroups.map((group) =>\n      surfaceNavSection(group.label, group.surfaces, {\n        isActive: (surface) => isSurfaceRouteActive(resolvedRoute, surface.key),\n        hrefFor: (surface) => withBasePath(basePath, `/${surface.key}`),\n      }),\n    );\n    if (showApiExplorer) {\n      sections.push({\n        items: [\n          {\n            key: explorerDefinition.key,\n            label: explorerDefinition.title,\n            active: resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n            to: withBasePath(basePath, \"/explorer\"),\n          },\n        ],\n      });\n    }\n    return sections;\n  }, [surfaceGroups, basePath, resolvedRoute, showApiExplorer, explorerDefinition]);\n\n  const [navContainer, setNavContainer] = useState<HTMLElement | null>(null);\n  const [navClaims, setNavClaims] = useState(0);\n  const claimNav = useCallback(() => {\n    setNavClaims((count) => count + 1);\n    return () => setNavClaims((count) => count - 1);\n  }, []);\n  const surface = resolvedRoute.kind === \"surface\" ? resolvedRoute.surface : undefined;\n  const titleActions = surface ? surfaceTitleActions?.(surface.key) : undefined;\n  const paginationMode = surface ? surfacePaginationMode?.(surface.key) : undefined;\n  // The container only exists while a surface is resolved, so a portal\n  // mounted before the spec loads renders nothing rather than a bare crumb.\n  const navSlot = useMemo<ExplorerNavSlot>(\n    () => ({\n      container: surface ? navContainer : null,\n      title: surface?.title ?? \"\",\n      titleActions,\n      claim: claimNav,\n    }),\n    [claimNav, navContainer, surface, titleActions],\n  );\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <AppShell\n      brand={\n        <div className=\"min-w-0\">\n          <div className=\"truncate text-sm font-semibold\">\n            {spec?.info.title ?? \"Clicky Explorer\"}\n          </div>\n          <div className=\"truncate text-xs text-sidebar-foreground/60\">\n            Metadata-driven entity explorer\n          </div>\n        </div>\n      }\n      navSections={navSections}\n      sidebarFooter={<ThemeSwitcher />}\n      {...(actions ? { actions } : {})}\n      // The page header belongs to the host, not to OperationCatalog — the\n      // catalog renders only its results. OperationEntityPage still titles\n      // itself, so this covers the collection route only.\n      //\n      // It rides in the top bar rather than a bodyHeader row: next to the rail\n      // that bar is otherwise empty, and the row it replaces cost the result\n      // table ~72px of the viewport it needs to keep its sticky head and\n      // pagination footer on screen without the page itself scrolling.\n      {...(resolvedRoute.kind === \"surface\" && resolvedRoute.surface\n        ? {\n            nav: (\n              <>\n                {navClaims === 0 && (\n                  <div className=\"flex min-w-0 flex-1 items-baseline gap-density-2\">\n                    <h1 className=\"min-w-0 truncate text-base font-semibold tracking-tight\">\n                      {resolvedRoute.surface.title}\n                    </h1>\n                    {titleActions ? (\n                      <div className=\"flex shrink-0 items-center self-center\">{titleActions}</div>\n                    ) : null}\n                    <p className=\"hidden min-w-0 truncate text-sm text-muted-foreground lg:block\">\n                      {makeSurfaceDefinition(resolvedRoute.surface).description}\n                    </p>\n                  </div>\n                )}\n                <div ref={setNavContainer} data-slot=\"explorer-nav\" className=\"contents\" />\n              </>\n            ),\n          }\n        : {})}\n      collapsedStorageKey={SIDEBAR_COLLAPSED_KEY}\n      // Results are wide tables, not prose — let them use the whole workspace\n      // instead of the centred reading column.\n      contentWidth=\"full\"\n      contentClassName=\"p-6\"\n    >\n      {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              // Filter state is seeded from the URL when the catalog mounts and\n              // written back to it, so one instance spanning two surfaces would\n              // carry the first surface's filters onto the second's URL. Keying\n              // on the surface makes each one start from its own query string.\n              key={resolvedRoute.surface.key}\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(resultRenderer ? { resultRenderer } : {})}\n            {...(paginationMode ? { paginationMode } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(entityDetailBodyRenderer ? { entityDetailBodyRenderer } : {})}\n            {...(entityDetailHeaderRenderer ? { entityDetailHeaderRenderer } : {})}\n            {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n    </AppShell>\n  );\n\n  return <ExplorerNavContext.Provider value={navSlot}>{content}</ExplorerNavContext.Provider>;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"mappings":"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"}

package/dist/rpc/EntityExplorerApp.d.ts

@@ -48,6 +48,15 @@ export type EntityExplorerAppProps = {
     entityDetailBodyRenderer?: EntityDetailBodyRenderer;
     /** Host override for a loaded entity's "{title}: {id}" heading. */
     entityDetailHeaderRenderer?: EntityDetailHeaderRenderer;
+    /** Compact host controls (e.g. an edit icon) shown right after a surface's title or breadcrumb in the top bar. */
+    surfaceTitleActions?: (surfaceKey: string) => ReactNode;
+    /**
+     * Per-surface paging presentation, forwarded to OperationCatalog's
+     * `paginationMode`. Return undefined to keep automatic selection (a cursor
+     * walk whenever the list declares a cursor); return "paged" for a surface
+     * whose readers need prev/next offset controls.
+     */
+    surfacePaginationMode?: (surfaceKey: string) => "paged" | "infinite" | undefined;
 };
-export declare function EntityExplorerApp({ client, basePath, showApiExplorer, actions, formExtensions, formActions, surfaceActionLabels, resultRenderer, entityDetailBodyRenderer, entityDetailHeaderRenderer, }: EntityExplorerAppProps): import("react").JSX.Element;
+export declare function EntityExplorerApp({ client, basePath, showApiExplorer, actions, formExtensions, formActions, surfaceActionLabels, resultRenderer, entityDetailBodyRenderer, entityDetailHeaderRenderer, surfaceTitleActions, surfacePaginationMode, }: EntityExplorerAppProps): import("react").JSX.Element;
 //# sourceMappingURL=EntityExplorerApp.d.ts.map

package/dist/rpc/EntityExplorerApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityExplorerApp.d.ts","sourceRoot":"","sources":["../../src/rpc/EntityExplorerApp.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAaxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAClE;;;;OAIG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,mEAAmE;IACnE,0BAA0B,CAAC,EAAE,0BAA0B,CAAC;CACzD,CAAC;AAKF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAa,EACb,eAAsB,EACtB,OAAO,EACP,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,0BAA0B,GAC3B,EAAE,sBAAsB,+BA6LxB"}
+{"version":3,"file":"EntityExplorerApp.d.ts","sourceRoot":"","sources":["../../src/rpc/EntityExplorerApp.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlF,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAaxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzE,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAClE;;;;OAIG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,mEAAmE;IACnE,0BAA0B,CAAC,EAAE,0BAA0B,CAAC;IACxD,kHAAkH;IAClH,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,SAAS,CAAC;IACxD;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;CAClF,CAAC;AAKF,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAa,EACb,eAAsB,EACtB,OAAO,EACP,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,GACtB,EAAE,sBAAsB,+BA2NxB"}

package/dist/rpc/EntityExplorerApp.js

@@ -4,15 +4,16 @@ import { AppShell } from "../layout/AppShell.js";
 import { useOperations } from "./useOperations.js";
 import { getClickySurfaces, makeSurfaceDefinition } from "./clickyMetadata.js";
 import { OperationCatalog } from "./OperationCatalog.js";
+import { ExplorerNavContext } from "./explorer-nav-context.js";
 import { ARG_QUERY_PREFIX, buildCommandHref, trimTrailingSlash, withBasePath } from "./commandHref.js";
 import { OperationCommandPage } from "./OperationCommandPage.js";
 import { OperationEntityPage } from "./OperationEntityPage.js";
 import { surfaceNavSection } from "./surfaceNav.js";
-import { useEffect, useMemo } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 // src/rpc/EntityExplorerApp.tsx
 var SIDEBAR_COLLAPSED_KEY = "clicky-ui:sidebar:collapsed";
-function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, actions, formExtensions, formActions, surfaceActionLabels, resultRenderer, entityDetailBodyRenderer, entityDetailHeaderRenderer }) {
+function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, actions, formExtensions, formActions, surfaceActionLabels, resultRenderer, entityDetailBodyRenderer, entityDetailHeaderRenderer, surfaceTitleActions, surfacePaginationMode }) {
 	const formPre = formExtensions?.pre;
 	const formPost = formExtensions?.post;
 	const { pathname, renderLink, navigate } = useRouter();
@@ -64,6 +65,26 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 		showApiExplorer,
 		explorerDefinition
 	]);
+	const [navContainer, setNavContainer] = useState(null);
+	const [navClaims, setNavClaims] = useState(0);
+	const claimNav = useCallback(() => {
+		setNavClaims((count) => count + 1);
+		return () => setNavClaims((count) => count - 1);
+	}, []);
+	const surface = resolvedRoute.kind === "surface" ? resolvedRoute.surface : void 0;
+	const titleActions = surface ? surfaceTitleActions?.(surface.key) : void 0;
+	const paginationMode = surface ? surfacePaginationMode?.(surface.key) : void 0;
+	const navSlot = useMemo(() => ({
+		container: surface ? navContainer : null,
+		title: surface?.title ?? "",
+		titleActions,
+		claim: claimNav
+	}), [
+		claimNav,
+		navContainer,
+		surface,
+		titleActions
+	]);
 	useEffect(() => {
 		if (defaultSurface == null || relativePath !== "/") return;
 		navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });
@@ -73,7 +94,7 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 		relativePath,
 		navigate
 	]);
-	return /* @__PURE__ */ jsx(AppShell, {
+	const content = /* @__PURE__ */ jsx(AppShell, {
 		brand: /* @__PURE__ */ jsxs("div", {
 			className: "min-w-0",
 			children: [/* @__PURE__ */ jsx("div", {
@@ -87,16 +108,27 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 		navSections,
 		sidebarFooter: /* @__PURE__ */ jsx(ThemeSwitcher, {}),
 		...actions ? { actions } : {},
-		...resolvedRoute.kind === "surface" && resolvedRoute.surface ? { nav: /* @__PURE__ */ jsxs("div", {
+		...resolvedRoute.kind === "surface" && resolvedRoute.surface ? { nav: /* @__PURE__ */ jsxs(Fragment$1, { children: [navClaims === 0 && /* @__PURE__ */ jsxs("div", {
 			className: "flex min-w-0 flex-1 items-baseline gap-density-2",
-			children: [/* @__PURE__ */ jsx("h1", {
-				className: "min-w-0 truncate text-base font-semibold tracking-tight",
-				children: resolvedRoute.surface.title
-			}), /* @__PURE__ */ jsx("p", {
-				className: "hidden min-w-0 truncate text-sm text-muted-foreground lg:block",
-				children: makeSurfaceDefinition(resolvedRoute.surface).description
-			})]
-		}) } : {},
+			children: [
+				/* @__PURE__ */ jsx("h1", {
+					className: "min-w-0 truncate text-base font-semibold tracking-tight",
+					children: resolvedRoute.surface.title
+				}),
+				titleActions ? /* @__PURE__ */ jsx("div", {
+					className: "flex shrink-0 items-center self-center",
+					children: titleActions
+				}) : null,
+				/* @__PURE__ */ jsx("p", {
+					className: "hidden min-w-0 truncate text-sm text-muted-foreground lg:block",
+					children: makeSurfaceDefinition(resolvedRoute.surface).description
+				})
+			]
+		}), /* @__PURE__ */ jsx("div", {
+			ref: setNavContainer,
+			"data-slot": "explorer-nav",
+			className: "contents"
+		})] }) } : {},
 		collapsedStorageKey: SIDEBAR_COLLAPSED_KEY,
 		contentWidth: "full",
 		contentClassName: "p-6",
@@ -111,7 +143,8 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 			...formPost ? { formPost } : {},
 			...formActions ? { formActions } : {},
 			...surfaceActionLabels?.[resolvedRoute.surface.key] ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] } : {},
-			...resultRenderer ? { resultRenderer } : {}
+			...resultRenderer ? { resultRenderer } : {},
+			...paginationMode ? { paginationMode } : {}
 		}, resolvedRoute.surface.key) : /* @__PURE__ */ jsx(UnknownSurface, { surfaceKey: resolvedRoute.surfaceKey }) : resolvedRoute.kind === "entity" ? resolvedRoute.surface ? /* @__PURE__ */ jsx(OperationEntityPage, {
 			definition: makeSurfaceDefinition(resolvedRoute.surface),
 			entities: [resolvedRoute.surface.entity],
@@ -152,6 +185,10 @@ function EntityExplorerApp({ client, basePath = "", showApiExplorer = true, acti
 			children: "Redirecting…"
 		})
 	});
+	return /* @__PURE__ */ jsx(ExplorerNavContext.Provider, {
+		value: navSlot,
+		children: content
+	});
 }
 function parseExplorerRoute(pathname) {
 	const normalized = trimTrailingSlash(pathname) || "/";

package/dist/rpc/EntityExplorerApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityExplorerApp.js","names":["_jsx"],"sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useEffect, useMemo, type ReactNode } from \"react\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { PreExtension, PostExtension } from \"../components/json-schema-form-types\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport { AppShell, type AppShellNavSection } from \"../layout/AppShell\";\nimport { getClickySurfaces, makeSurfaceDefinition } from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport type { ResultRenderer } from \"./OperationResultView\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport {\n  OperationEntityPage,\n  type EntityDetailBodyRenderer,\n  type EntityDetailHeaderRenderer,\n} from \"./OperationEntityPage\";\nimport type { FormActionsRenderer } from \"./SchemaActionForm\";\nimport { surfaceNavSection } from \"./surfaceNav\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type SurfaceActionLabels = Record<string, Record<string, string>>;\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  /** Right-aligned top-bar cluster forwarded to AppShell's actions slot. */\n  actions?: ReactNode;\n  /**\n   * Custom JsonSchemaForm field extensions applied to every create/edit form the\n   * explorer renders — e.g. a SecretKeySelector widget keyed on an\n   * `x-clicky-component` schema hint. `pre` transforms a resolved control; `post`\n   * can replace the rendered value node with a custom component.\n   */\n  formExtensions?: { pre?: PreExtension[]; post?: PostExtension[] };\n  /**\n   * Optional extra footer actions added to every create/edit form (e.g. a\n   * connection \"Test\" split-button). The renderer receives the live form value\n   * and the action it submits to, so it can scope itself to a given entity.\n   */\n  formActions?: FormActionsRenderer;\n  /** Per-surface labels keyed by x-clicky verb/actionName. */\n  surfaceActionLabels?: SurfaceActionLabels;\n  /**\n   * @deprecated Superseded by per-surface icons emitted by the backend\n   * (x-clicky-icon → ClickySurface.icon). AppShell section labels are plain\n   * strings, so this group-header icon map is no longer rendered. Kept for\n   * source-compatibility only.\n   */\n  surfaceIcons?: Record<string, ReactNode>;\n  /**\n   * Optional host override for the result surface. Called where an entity's\n   * result table renders, with the current surface key, the raw response, and\n   * the default OperationResultView element. Return `defaultView` to keep the\n   * standard table, or a custom node (e.g. a LogsTable for trace/log profiles\n   * flagged via x-clicky-render). Filtering/sorting policy is the host's choice.\n   */\n  resultRenderer?: ResultRenderer;\n  /** Host override for a loaded entity's body; heading and actions remain. */\n  entityDetailBodyRenderer?: EntityDetailBodyRenderer;\n  /** Host override for a loaded entity's \"{title}: {id}\" heading. */\n  entityDetailHeaderRenderer?: EntityDetailHeaderRenderer;\n};\n\n// SIDEBAR_COLLAPSED_KEY persists the AppShell rail collapsed flag across reloads.\nconst SIDEBAR_COLLAPSED_KEY = \"clicky-ui:sidebar:collapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  actions,\n  formExtensions,\n  formActions,\n  surfaceActionLabels,\n  resultRenderer,\n  entityDetailBodyRenderer,\n  entityDetailHeaderRenderer,\n}: EntityExplorerAppProps) {\n  const formPre = formExtensions?.pre;\n  const formPost = formExtensions?.post;\n  const { pathname, renderLink, navigate } = useRouter();\n  const { spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n  const navSections = useMemo<AppShellNavSection[]>(() => {\n    const sections: AppShellNavSection[] = surfaceGroups.map((group) =>\n      surfaceNavSection(group.label, group.surfaces, {\n        isActive: (surface) => isSurfaceRouteActive(resolvedRoute, surface.key),\n        hrefFor: (surface) => withBasePath(basePath, `/${surface.key}`),\n      }),\n    );\n    if (showApiExplorer) {\n      sections.push({\n        items: [\n          {\n            key: explorerDefinition.key,\n            label: explorerDefinition.title,\n            active: resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n            to: withBasePath(basePath, \"/explorer\"),\n          },\n        ],\n      });\n    }\n    return sections;\n  }, [surfaceGroups, basePath, resolvedRoute, showApiExplorer, explorerDefinition]);\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <AppShell\n      brand={\n        <div className=\"min-w-0\">\n          <div className=\"truncate text-sm font-semibold\">\n            {spec?.info.title ?? \"Clicky Explorer\"}\n          </div>\n          <div className=\"truncate text-xs text-sidebar-foreground/60\">\n            Metadata-driven entity explorer\n          </div>\n        </div>\n      }\n      navSections={navSections}\n      sidebarFooter={<ThemeSwitcher />}\n      {...(actions ? { actions } : {})}\n      // The page header belongs to the host, not to OperationCatalog — the\n      // catalog renders only its results. OperationEntityPage still titles\n      // itself, so this covers the collection route only.\n      //\n      // It rides in the top bar rather than a bodyHeader row: next to the rail\n      // that bar is otherwise empty, and the row it replaces cost the result\n      // table ~72px of the viewport it needs to keep its sticky head and\n      // pagination footer on screen without the page itself scrolling.\n      {...(resolvedRoute.kind === \"surface\" && resolvedRoute.surface\n        ? {\n            nav: (\n              <div className=\"flex min-w-0 flex-1 items-baseline gap-density-2\">\n                <h1 className=\"min-w-0 truncate text-base font-semibold tracking-tight\">\n                  {resolvedRoute.surface.title}\n                </h1>\n                <p className=\"hidden min-w-0 truncate text-sm text-muted-foreground lg:block\">\n                  {makeSurfaceDefinition(resolvedRoute.surface).description}\n                </p>\n              </div>\n            ),\n          }\n        : {})}\n      collapsedStorageKey={SIDEBAR_COLLAPSED_KEY}\n      // Results are wide tables, not prose — let them use the whole workspace\n      // instead of the centred reading column.\n      contentWidth=\"full\"\n      contentClassName=\"p-6\"\n    >\n      {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              // Filter state is seeded from the URL when the catalog mounts and\n              // written back to it, so one instance spanning two surfaces would\n              // carry the first surface's filters onto the second's URL. Keying\n              // on the surface makes each one start from its own query string.\n              key={resolvedRoute.surface.key}\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(resultRenderer ? { resultRenderer } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(entityDetailBodyRenderer ? { entityDetailBodyRenderer } : {})}\n            {...(entityDetailHeaderRenderer ? { entityDetailHeaderRenderer } : {})}\n            {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n    </AppShell>\n  );\n\n  return content;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"mappings":"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"}
+{"version":3,"file":"EntityExplorerApp.js","names":["_Fragment"],"sources":["../../src/rpc/EntityExplorerApp.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState, type ReactNode } from \"react\";\nimport { ExplorerNavContext, type ExplorerNavSlot } from \"./explorer-nav-context\";\nimport { ThemeSwitcher } from \"../components/theme-switcher\";\nimport type { PreExtension, PostExtension } from \"../components/json-schema-form-types\";\nimport type { ClickyCommandRuntime } from \"../data/Clicky\";\nimport { AppShell, type AppShellNavSection } from \"../layout/AppShell\";\nimport { getClickySurfaces, makeSurfaceDefinition } from \"./clickyMetadata\";\nimport {\n  ARG_QUERY_PREFIX,\n  AUTORUN_QUERY_PARAM,\n  buildCommandHref,\n  trimTrailingSlash,\n  withBasePath,\n} from \"./commandHref\";\nimport { useRouter } from \"./router\";\nimport { OperationCatalog } from \"./OperationCatalog\";\nimport type { ResultRenderer } from \"./OperationResultView\";\nimport { OperationCommandPage } from \"./OperationCommandPage\";\nimport {\n  OperationEntityPage,\n  type EntityDetailBodyRenderer,\n  type EntityDetailHeaderRenderer,\n} from \"./OperationEntityPage\";\nimport type { FormActionsRenderer } from \"./SchemaActionForm\";\nimport { surfaceNavSection } from \"./surfaceNav\";\nimport type { ClickySurface } from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\nimport { useOperations } from \"./useOperations\";\n\nexport type SurfaceActionLabels = Record<string, Record<string, string>>;\n\nexport type EntityExplorerAppProps = {\n  client: OperationsApiClient;\n  basePath?: string;\n  showApiExplorer?: boolean;\n  /** Right-aligned top-bar cluster forwarded to AppShell's actions slot. */\n  actions?: ReactNode;\n  /**\n   * Custom JsonSchemaForm field extensions applied to every create/edit form the\n   * explorer renders — e.g. a SecretKeySelector widget keyed on an\n   * `x-clicky-component` schema hint. `pre` transforms a resolved control; `post`\n   * can replace the rendered value node with a custom component.\n   */\n  formExtensions?: { pre?: PreExtension[]; post?: PostExtension[] };\n  /**\n   * Optional extra footer actions added to every create/edit form (e.g. a\n   * connection \"Test\" split-button). The renderer receives the live form value\n   * and the action it submits to, so it can scope itself to a given entity.\n   */\n  formActions?: FormActionsRenderer;\n  /** Per-surface labels keyed by x-clicky verb/actionName. */\n  surfaceActionLabels?: SurfaceActionLabels;\n  /**\n   * @deprecated Superseded by per-surface icons emitted by the backend\n   * (x-clicky-icon → ClickySurface.icon). AppShell section labels are plain\n   * strings, so this group-header icon map is no longer rendered. Kept for\n   * source-compatibility only.\n   */\n  surfaceIcons?: Record<string, ReactNode>;\n  /**\n   * Optional host override for the result surface. Called where an entity's\n   * result table renders, with the current surface key, the raw response, and\n   * the default OperationResultView element. Return `defaultView` to keep the\n   * standard table, or a custom node (e.g. a LogsTable for trace/log profiles\n   * flagged via x-clicky-render). Filtering/sorting policy is the host's choice.\n   */\n  resultRenderer?: ResultRenderer;\n  /** Host override for a loaded entity's body; heading and actions remain. */\n  entityDetailBodyRenderer?: EntityDetailBodyRenderer;\n  /** Host override for a loaded entity's \"{title}: {id}\" heading. */\n  entityDetailHeaderRenderer?: EntityDetailHeaderRenderer;\n  /** Compact host controls (e.g. an edit icon) shown right after a surface's title or breadcrumb in the top bar. */\n  surfaceTitleActions?: (surfaceKey: string) => ReactNode;\n  /**\n   * Per-surface paging presentation, forwarded to OperationCatalog's\n   * `paginationMode`. Return undefined to keep automatic selection (a cursor\n   * walk whenever the list declares a cursor); return \"paged\" for a surface\n   * whose readers need prev/next offset controls.\n   */\n  surfacePaginationMode?: (surfaceKey: string) => \"paged\" | \"infinite\" | undefined;\n};\n\n// SIDEBAR_COLLAPSED_KEY persists the AppShell rail collapsed flag across reloads.\nconst SIDEBAR_COLLAPSED_KEY = \"clicky-ui:sidebar:collapsed\";\n\nexport function EntityExplorerApp({\n  client,\n  basePath = \"\",\n  showApiExplorer = true,\n  actions,\n  formExtensions,\n  formActions,\n  surfaceActionLabels,\n  resultRenderer,\n  entityDetailBodyRenderer,\n  entityDetailHeaderRenderer,\n  surfaceTitleActions,\n  surfacePaginationMode,\n}: EntityExplorerAppProps) {\n  const formPre = formExtensions?.pre;\n  const formPost = formExtensions?.post;\n  const { pathname, renderLink, navigate } = useRouter();\n  const { spec } = useOperations(client);\n  const surfaces = useMemo(() => getClickySurfaces(spec), [spec]);\n  const surfaceGroups = useMemo(() => groupSurfacesByParent(surfaces), [surfaces]);\n  const defaultSurface = useMemo(\n    () => surfaces.find((surface) => !surface.admin) ?? surfaces[0],\n    [surfaces],\n  );\n  const relativePath = useMemo(() => stripBasePath(pathname, basePath), [basePath, pathname]);\n  const route = useMemo(() => parseExplorerRoute(relativePath), [relativePath]);\n  const resolvedRoute = useMemo(() => resolveRouteSurface(route, surfaces), [route, surfaces]);\n  const commandRuntime = useMemo<ClickyCommandRuntime>(\n    () => ({\n      client,\n      hrefForCommand: (resolved) => buildCommandHref(basePath, resolved),\n      onNavigate: (resolved) => {\n        const href = buildCommandHref(basePath, resolved);\n        if (!href) return;\n        navigate(href);\n      },\n    }),\n    [basePath, client, navigate],\n  );\n  const { initialValues: commandInitialValues } = useMemo(\n    () =>\n      resolvedRoute.kind === \"command\"\n        ? readCommandQueryParams()\n        : { initialValues: {}, autoRun: false },\n    [resolvedRoute.kind, pathname],\n  );\n  const explorerDefinition = useMemo(\n    () => ({\n      key: \"explorer\",\n      title: \"API Explorer\",\n      description: \"Every operation exposed by the current OpenAPI spec.\",\n    }),\n    [],\n  );\n  const navSections = useMemo<AppShellNavSection[]>(() => {\n    const sections: AppShellNavSection[] = surfaceGroups.map((group) =>\n      surfaceNavSection(group.label, group.surfaces, {\n        isActive: (surface) => isSurfaceRouteActive(resolvedRoute, surface.key),\n        hrefFor: (surface) => withBasePath(basePath, `/${surface.key}`),\n      }),\n    );\n    if (showApiExplorer) {\n      sections.push({\n        items: [\n          {\n            key: explorerDefinition.key,\n            label: explorerDefinition.title,\n            active: resolvedRoute.kind === \"explorer\" || resolvedRoute.kind === \"command\",\n            to: withBasePath(basePath, \"/explorer\"),\n          },\n        ],\n      });\n    }\n    return sections;\n  }, [surfaceGroups, basePath, resolvedRoute, showApiExplorer, explorerDefinition]);\n\n  const [navContainer, setNavContainer] = useState<HTMLElement | null>(null);\n  const [navClaims, setNavClaims] = useState(0);\n  const claimNav = useCallback(() => {\n    setNavClaims((count) => count + 1);\n    return () => setNavClaims((count) => count - 1);\n  }, []);\n  const surface = resolvedRoute.kind === \"surface\" ? resolvedRoute.surface : undefined;\n  const titleActions = surface ? surfaceTitleActions?.(surface.key) : undefined;\n  const paginationMode = surface ? surfacePaginationMode?.(surface.key) : undefined;\n  // The container only exists while a surface is resolved, so a portal\n  // mounted before the spec loads renders nothing rather than a bare crumb.\n  const navSlot = useMemo<ExplorerNavSlot>(\n    () => ({\n      container: surface ? navContainer : null,\n      title: surface?.title ?? \"\",\n      titleActions,\n      claim: claimNav,\n    }),\n    [claimNav, navContainer, surface, titleActions],\n  );\n\n  useEffect(() => {\n    if (defaultSurface == null || relativePath !== \"/\") return;\n    navigate(withBasePath(basePath, `/${defaultSurface.key}`), { replace: true });\n  }, [basePath, defaultSurface, relativePath, navigate]);\n\n  const content = (\n    <AppShell\n      brand={\n        <div className=\"min-w-0\">\n          <div className=\"truncate text-sm font-semibold\">\n            {spec?.info.title ?? \"Clicky Explorer\"}\n          </div>\n          <div className=\"truncate text-xs text-sidebar-foreground/60\">\n            Metadata-driven entity explorer\n          </div>\n        </div>\n      }\n      navSections={navSections}\n      sidebarFooter={<ThemeSwitcher />}\n      {...(actions ? { actions } : {})}\n      // The page header belongs to the host, not to OperationCatalog — the\n      // catalog renders only its results. OperationEntityPage still titles\n      // itself, so this covers the collection route only.\n      //\n      // It rides in the top bar rather than a bodyHeader row: next to the rail\n      // that bar is otherwise empty, and the row it replaces cost the result\n      // table ~72px of the viewport it needs to keep its sticky head and\n      // pagination footer on screen without the page itself scrolling.\n      {...(resolvedRoute.kind === \"surface\" && resolvedRoute.surface\n        ? {\n            nav: (\n              <>\n                {navClaims === 0 && (\n                  <div className=\"flex min-w-0 flex-1 items-baseline gap-density-2\">\n                    <h1 className=\"min-w-0 truncate text-base font-semibold tracking-tight\">\n                      {resolvedRoute.surface.title}\n                    </h1>\n                    {titleActions ? (\n                      <div className=\"flex shrink-0 items-center self-center\">{titleActions}</div>\n                    ) : null}\n                    <p className=\"hidden min-w-0 truncate text-sm text-muted-foreground lg:block\">\n                      {makeSurfaceDefinition(resolvedRoute.surface).description}\n                    </p>\n                  </div>\n                )}\n                <div ref={setNavContainer} data-slot=\"explorer-nav\" className=\"contents\" />\n              </>\n            ),\n          }\n        : {})}\n      collapsedStorageKey={SIDEBAR_COLLAPSED_KEY}\n      // Results are wide tables, not prose — let them use the whole workspace\n      // instead of the centred reading column.\n      contentWidth=\"full\"\n      contentClassName=\"p-6\"\n    >\n      {resolvedRoute.kind === \"surface\" ? (\n          resolvedRoute.surface ? (\n            <OperationCatalog\n              // Filter state is seeded from the URL when the catalog mounts and\n              // written back to it, so one instance spanning two surfaces would\n              // carry the first surface's filters onto the second's URL. Keying\n              // on the surface makes each one start from its own query string.\n              key={resolvedRoute.surface.key}\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(resultRenderer ? { resultRenderer } : {})}\n            {...(paginationMode ? { paginationMode } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"entity\" ? (\n          resolvedRoute.surface ? (\n            <OperationEntityPage\n              definition={makeSurfaceDefinition(resolvedRoute.surface)}\n              entities={[resolvedRoute.surface.entity]}\n              client={client}\n              renderLink={renderLink}\n              surfaceKey={resolvedRoute.surface.key}\n              backHref={withBasePath(basePath, `/${resolvedRoute.surface.key}`)}\n              backLabel={`Back to ${resolvedRoute.surface.title}`}\n              commandRuntime={commandRuntime}\n              {...(formPre ? { formPre } : {})}\n            {...(formPost ? { formPost } : {})}\n            {...(formActions ? { formActions } : {})}\n            {...(surfaceActionLabels?.[resolvedRoute.surface.key]\n              ? { actionLabels: surfaceActionLabels[resolvedRoute.surface.key] }\n              : {})}\n            {...(entityDetailBodyRenderer ? { entityDetailBodyRenderer } : {})}\n            {...(entityDetailHeaderRenderer ? { entityDetailHeaderRenderer } : {})}\n            {...(resolvedRoute.id ? { id: resolvedRoute.id } : {})}\n            />\n          ) : (\n            <UnknownSurface surfaceKey={resolvedRoute.surfaceKey} />\n          )\n        ) : resolvedRoute.kind === \"command\" ? (\n          <OperationCommandPage\n            client={client}\n            backHref={withBasePath(basePath, \"/explorer\")}\n            backLabel=\"Back to API Explorer\"\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n            initialValues={commandInitialValues}\n            autoRun={true}\n            {...(resolvedRoute.operationId ? { operationId: resolvedRoute.operationId } : {})}\n          />\n        ) : resolvedRoute.kind === \"explorer\" ? (\n          <OperationCatalog\n            definition={explorerDefinition}\n            entities={[]}\n            allOperations\n            client={client}\n            renderLink={renderLink}\n            commandRuntime={commandRuntime}\n          />\n        ) : defaultSurface == null ? (\n          <div className=\"text-sm text-muted-foreground\">Loading surfaces…</div>\n        ) : (\n          <div className=\"text-sm text-muted-foreground\">Redirecting…</div>\n        )}\n    </AppShell>\n  );\n\n  return <ExplorerNavContext.Provider value={navSlot}>{content}</ExplorerNavContext.Provider>;\n}\n\ntype ExplorerRoute =\n  | { kind: \"root\" }\n  | { kind: \"explorer\" }\n  | { kind: \"command\"; operationId?: string }\n  | { kind: \"surface\"; surfaceKey: string; surface?: ClickySurface }\n  | {\n      kind: \"entity\";\n      surfaceKey: string;\n      surface?: ClickySurface;\n      id?: string;\n    };\n\nfunction parseExplorerRoute(pathname: string): ExplorerRoute {\n  const normalized = trimTrailingSlash(pathname) || \"/\";\n  if (normalized === \"/\") {\n    return { kind: \"root\" };\n  }\n\n  const segments = normalized.replace(/^\\/+/, \"\").split(\"/\");\n  if (segments[0] === \"explorer\") {\n    return { kind: \"explorer\" };\n  }\n  if (segments[0] === \"commands\") {\n    return segments[1] ? { kind: \"command\", operationId: segments[1] } : { kind: \"command\" };\n  }\n  const surfaceKey = segments[0] ?? \"\";\n  if (segments[1]) {\n    return {\n      kind: \"entity\",\n      surfaceKey,\n      id: decodeURIComponent(segments[1]),\n    };\n  }\n  return { kind: \"surface\", surfaceKey };\n}\n\nfunction resolveRouteSurface(route: ExplorerRoute, surfaces: ClickySurface[]): ExplorerRoute {\n  if (route.kind !== \"surface\" && route.kind !== \"entity\") {\n    return route;\n  }\n  const surface = surfaces.find((item) => item.key === route.surfaceKey);\n  return surface ? { ...route, surface } : route;\n}\n\nfunction isSurfaceRouteActive(route: ExplorerRoute, surfaceKey: string) {\n  return (\n    (route.kind === \"surface\" && route.surfaceKey === surfaceKey) ||\n    (route.kind === \"entity\" && route.surfaceKey === surfaceKey)\n  );\n}\n\nfunction stripBasePath(pathname: string, basePath: string) {\n  const base = trimTrailingSlash(basePath);\n  if (!base || base === \"/\") {\n    return trimTrailingSlash(pathname) || \"/\";\n  }\n  if (pathname === base) {\n    return \"/\";\n  }\n  if (pathname.startsWith(`${base}/`)) {\n    return trimTrailingSlash(pathname.slice(base.length)) || \"/\";\n  }\n  return trimTrailingSlash(pathname) || \"/\";\n}\n\nfunction UnknownSurface({ surfaceKey }: { surfaceKey: string }) {\n  return (\n    <div className=\"p-6 text-sm text-muted-foreground\">\n      Unknown surface: <code>{surfaceKey}</code>\n    </div>\n  );\n}\n\nconst LEGACY_AUTORUN_QUERY_PARAM = \"__autoRun\";\n\ntype SurfaceGroup = {\n  parent: string; // the slug; \"\" for surfaces that declared no parent\n  label: string; // display name in the sidebar\n  surfaces: ClickySurface[];\n};\n\n// groupSurfacesByParent buckets surfaces by their ClickySurface.parent slug,\n// preserving the order surfaces appeared in the spec. Surfaces with no parent\n// fall into a trailing \"\" bucket labelled \"Other\".\nfunction groupSurfacesByParent(surfaces: ClickySurface[]): SurfaceGroup[] {\n  const order: string[] = [];\n  const buckets = new Map<string, ClickySurface[]>();\n  for (const surface of surfaces) {\n    const parent = surface.parent ?? \"\";\n    if (!buckets.has(parent)) {\n      buckets.set(parent, []);\n      order.push(parent);\n    }\n    buckets.get(parent)!.push(surface);\n  }\n  return order.map((parent) => ({\n    parent,\n    label: parent === \"\" ? \"Other\" : titleCase(parent),\n    surfaces: buckets.get(parent)!,\n  }));\n}\n\nfunction titleCase(value: string): string {\n  if (!value) return value;\n  return value.charAt(0).toUpperCase() + value.slice(1);\n}\n\nfunction readCommandQueryParams(): { initialValues: Record<string, string>; autoRun: boolean } {\n  if (typeof window === \"undefined\") {\n    return { initialValues: {}, autoRun: false };\n  }\n  const search = new URLSearchParams(window.location.search);\n  const initialValues: Record<string, string> = {};\n  let autoRun = false;\n  const positional: string[] = [];\n\n  for (const [key, value] of search.entries()) {\n    if (key === AUTORUN_QUERY_PARAM || key === LEGACY_AUTORUN_QUERY_PARAM) {\n      autoRun = value === \"1\" || value === \"true\";\n      continue;\n    }\n    if (key.startsWith(ARG_QUERY_PREFIX)) {\n      const index = Number.parseInt(key.slice(ARG_QUERY_PREFIX.length), 10);\n      if (Number.isFinite(index) && index >= 0) {\n        positional[index] = value;\n      }\n      continue;\n    }\n    initialValues[key] = value;\n  }\n\n  const packedArgs = positional.filter((value) => value !== undefined).join(\" \");\n  if (packedArgs !== \"\") {\n    initialValues.args = packedArgs;\n  }\n\n  return { initialValues, autoRun };\n}\n"],"mappings":"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"}

package/dist/rpc/EntitySurface.cjs

@@ -0,0 +1,38 @@
+const require_router = require("./router.cjs");
+const require_useOperations = require("./useOperations.cjs");
+const require_clickyMetadata = require("./clickyMetadata.cjs");
+const require_OperationCatalog = require("./OperationCatalog.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+// src/rpc/EntitySurface.tsx
+/**
+* EntitySurface lists one surface wherever a host places it — the same listing,
+* filters and result renderer EntityExplorerApp shows on the surface's own
+* route, embedded in another page (e.g. a connection's logs on its detail page).
+* Filter state lives in the current URL's query string, as it does on the route.
+*/
+function EntitySurface({ client, surfaceKey, resultRenderer, paginationMode }) {
+	const { renderLink } = require_router.useRouter();
+	const { spec } = require_useOperations.useOperations(client);
+	const surface = (0, react.useMemo)(() => spec ? require_clickyMetadata.getClickySurfaces(spec).find((item) => item.key === surfaceKey) : void 0, [spec, surfaceKey]);
+	if (!spec) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "text-sm text-muted-foreground",
+		children: "Loading…"
+	});
+	if (!surface) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "text-sm text-muted-foreground",
+		children: ["Unknown surface: ", /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: surfaceKey })]
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_OperationCatalog.OperationCatalog, {
+		definition: require_clickyMetadata.makeSurfaceDefinition(surface),
+		entities: [surface.entity],
+		client,
+		renderLink,
+		surfaceKey: surface.key,
+		...resultRenderer ? { resultRenderer } : {},
+		...paginationMode ? { paginationMode } : {}
+	}, surface.key);
+}
+exports.EntitySurface = EntitySurface;
+
+//# sourceMappingURL=EntitySurface.cjs.map