{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "page",
  "title": "Page",
  "description": "Page frame with header, actions, body, and an optional aside on either side.",
  "dependencies": [
    "@base-ui/react"
  ],
  "files": [
    {
      "path": "components/ui/page.tsx",
      "content": "import { mergeProps } from \"@base-ui/react/merge-props\";\nimport { useRender } from \"@base-ui/react/use-render\";\nimport type { ComponentProps, ReactNode } from \"react\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * True when a slot value should produce markup. `null`, `undefined`, booleans,\n * empty strings, and `0` are treated as empty, so `aside={false}` or\n * `metadata={count}` with a zero count never render a stray wrapper or a bare \"0\".\n */\nfunction isRenderable(node: ReactNode): boolean {\n  return node != null && typeof node !== \"boolean\" && node !== \"\" && node !== 0;\n}\n\n// ------------------------------------------------------------------\n// Page\n// ------------------------------------------------------------------\n\nconst pageSizeVariants = {\n  sm: \"max-w-3xl\",\n  md: \"max-w-5xl\",\n  lg: \"max-w-7xl\",\n  xl: \"max-w-[1600px]\",\n  full: \"max-w-none\",\n} as const;\n\ntype PageSize = keyof typeof pageSizeVariants;\n\ntype PageProps = useRender.ComponentProps<\"div\"> & {\n  /** Maximum content width. */\n  size?: PageSize;\n  /** Responsive horizontal padding. */\n  gutter?: boolean;\n};\n\nfunction PageRoot({ size = \"lg\", gutter = true, className, render, ...props }: PageProps) {\n  return useRender({\n    defaultTagName: \"div\",\n    render,\n    state: { slot: \"page\" },\n    props: mergeProps<\"div\">(\n      {\n        className: cn(\n          \"mx-auto w-full min-w-0\",\n          pageSizeVariants[size],\n          gutter && \"px-4 sm:px-6 lg:px-8\",\n          \"py-6 md:py-8\",\n          className,\n        ),\n      },\n      props,\n    ),\n  });\n}\n\n// ------------------------------------------------------------------\n// Page.Header\n// ------------------------------------------------------------------\n\n/**\n * Page.Header renders a div by default. A <header> outside <main> or a sectioning\n * element becomes the page's banner landmark, which usually belongs to the app\n * shell; pass `render={<header />}` when this header should be one.\n */\ntype PageTitleElement = \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\";\n\ntype PageHeaderProps = Omit<useRender.ComponentProps<\"div\">, \"title\"> & {\n  /** Rendered as the page heading, an h1 unless `titleAs` says otherwise. */\n  title: ReactNode;\n  /**\n   * Heading element for the title. Keep the default h1 for a real page; pick a\n   * lower level when the Page is nested, for example in a preview or a dialog.\n   */\n  titleAs?: PageTitleElement;\n  description?: ReactNode;\n  /** Badges or status rendered inline after the title. */\n  metadata?: ReactNode;\n  /** Primary actions, usually wrapped in Page.Actions. */\n  actions?: ReactNode;\n};\n\nfunction PageHeader({\n  title,\n  titleAs: Title = \"h1\",\n  description,\n  metadata,\n  actions,\n  className,\n  children,\n  render,\n  ...props\n}: PageHeaderProps) {\n  const content = (\n    <>\n      <div data-slot=\"page-header-content\" className=\"flex min-w-0 flex-1 flex-col gap-1\">\n        <div className=\"flex min-w-0 flex-wrap items-center gap-2\">\n          <Title data-slot=\"page-title\" className=\"text-2xl font-semibold tracking-tight\">\n            {title}\n          </Title>\n\n          {isRenderable(metadata) && <div data-slot=\"page-metadata\">{metadata}</div>}\n        </div>\n\n        {isRenderable(description) && (\n          <div data-slot=\"page-description\" className=\"text-muted-foreground text-sm\">\n            {description}\n          </div>\n        )}\n\n        {children}\n      </div>\n\n      {isRenderable(actions) && (\n        <div data-slot=\"page-header-actions\" className=\"flex shrink-0 items-center gap-2\">\n          {actions}\n        </div>\n      )}\n    </>\n  );\n\n  return useRender({\n    defaultTagName: \"div\",\n    render,\n    state: { slot: \"page-header\" },\n    props: mergeProps<\"div\">(\n      {\n        className: cn(\n          \"mb-6 flex min-w-0 flex-col gap-4\",\n          \"sm:flex-row sm:items-start sm:justify-between\",\n          className,\n        ),\n        children: content,\n      },\n      props,\n    ),\n  });\n}\n\n// ------------------------------------------------------------------\n// Page.Actions\n// ------------------------------------------------------------------\n\ntype PageActionsProps = useRender.ComponentProps<\"div\">;\n\nfunction PageActions({ className, render, ...props }: PageActionsProps) {\n  return useRender({\n    defaultTagName: \"div\",\n    render,\n    state: { slot: \"page-actions\" },\n    props: mergeProps<\"div\">(\n      { className: cn(\"flex flex-wrap items-center gap-2\", className) },\n      props,\n    ),\n  });\n}\n\n// ------------------------------------------------------------------\n// Page.Body\n// ------------------------------------------------------------------\n\ntype PageAsideWidth = \"sm\" | \"md\" | \"lg\";\ntype PageAsidePosition = \"start\" | \"end\";\ntype PageAsideBreakpoint = \"md\" | \"lg\" | \"xl\" | \"2xl\";\ntype PageAsideCollapse = \"stack\" | \"hide\";\n\n// Each preset sets --page-aside-width; the grid template reads it, so a custom\n// width is one style or class away: style={{ \"--page-aside-width\": \"13rem\" }}.\nconst asideWidthVariants = {\n  sm: \"[--page-aside-width:16rem]\",\n  md: \"[--page-aside-width:20rem]\",\n  lg: \"[--page-aside-width:24rem]\",\n} as const satisfies Record<PageAsideWidth, string>;\n\n// The aside column is mirrored for \"start\", so the content always gets the\n// flexible track. Both children are placed explicitly on row 1 from the\n// breakpoint up, which keeps the DOM (and reading) order content-first\n// regardless of position.\nconst asideTemplateVariants = {\n  md: {\n    end: \"md:grid-cols-[minmax(0,1fr)_var(--page-aside-width)]\",\n    start: \"md:grid-cols-[var(--page-aside-width)_minmax(0,1fr)]\",\n  },\n  lg: {\n    end: \"lg:grid-cols-[minmax(0,1fr)_var(--page-aside-width)]\",\n    start: \"lg:grid-cols-[var(--page-aside-width)_minmax(0,1fr)]\",\n  },\n  xl: {\n    end: \"xl:grid-cols-[minmax(0,1fr)_var(--page-aside-width)]\",\n    start: \"xl:grid-cols-[var(--page-aside-width)_minmax(0,1fr)]\",\n  },\n  \"2xl\": {\n    end: \"2xl:grid-cols-[minmax(0,1fr)_var(--page-aside-width)]\",\n    start: \"2xl:grid-cols-[var(--page-aside-width)_minmax(0,1fr)]\",\n  },\n} as const satisfies Record<PageAsideBreakpoint, Record<PageAsidePosition, string>>;\n\nconst contentPlacementVariants = {\n  md: { end: \"md:col-start-1 md:row-start-1\", start: \"md:col-start-2 md:row-start-1\" },\n  lg: { end: \"lg:col-start-1 lg:row-start-1\", start: \"lg:col-start-2 lg:row-start-1\" },\n  xl: { end: \"xl:col-start-1 xl:row-start-1\", start: \"xl:col-start-2 xl:row-start-1\" },\n  \"2xl\": { end: \"2xl:col-start-1 2xl:row-start-1\", start: \"2xl:col-start-2 2xl:row-start-1\" },\n} as const satisfies Record<PageAsideBreakpoint, Record<PageAsidePosition, string>>;\n\nconst asidePlacementVariants = {\n  md: { end: \"md:col-start-2 md:row-start-1\", start: \"md:col-start-1 md:row-start-1\" },\n  lg: { end: \"lg:col-start-2 lg:row-start-1\", start: \"lg:col-start-1 lg:row-start-1\" },\n  xl: { end: \"xl:col-start-2 xl:row-start-1\", start: \"xl:col-start-1 xl:row-start-1\" },\n  \"2xl\": { end: \"2xl:col-start-2 2xl:row-start-1\", start: \"2xl:col-start-1 2xl:row-start-1\" },\n} as const satisfies Record<PageAsideBreakpoint, Record<PageAsidePosition, string>>;\n\n// \"hide\" removes the aside below the breakpoint instead of stacking it.\nconst asideHiddenVariants = {\n  md: \"hidden md:block\",\n  lg: \"hidden lg:block\",\n  xl: \"hidden xl:block\",\n  \"2xl\": \"hidden 2xl:block\",\n} as const satisfies Record<PageAsideBreakpoint, string>;\n\ntype PageBodyProps = useRender.ComponentProps<\"div\"> & {\n  /** Supplementary column, placed beside the content from `asideBreakpoint` up. */\n  aside?: ReactNode;\n  /** Aside width: 16rem, 20rem, or 24rem. Set --page-aside-width for any other width. */\n  asideWidth?: PageAsideWidth;\n  /** Which side the aside sits on from `asideBreakpoint` up. */\n  asidePosition?: PageAsidePosition;\n  /** Breakpoint at which the aside moves beside the content. */\n  asideBreakpoint?: PageAsideBreakpoint;\n  /** Below the breakpoint, stack the aside under the content or hide it. */\n  asideCollapse?: PageAsideCollapse;\n  /** Accessible name for the aside landmark. */\n  asideLabel?: string;\n  /** Extra props for the aside element, for example a sticky className. */\n  asideProps?: Omit<ComponentProps<\"aside\">, \"children\">;\n};\n\nfunction PageBody({\n  aside,\n  asideWidth = \"md\",\n  asidePosition = \"end\",\n  asideBreakpoint = \"lg\",\n  asideCollapse = \"stack\",\n  asideLabel = \"Supplementary information\",\n  asideProps,\n  className,\n  children,\n  render,\n  ...props\n}: PageBodyProps) {\n  const hasAside = isRenderable(aside);\n  const dataAttributes = { \"data-aside-position\": hasAside ? asidePosition : undefined };\n\n  const content = (\n    <>\n      <div\n        data-slot=\"page-content\"\n        className={cn(\n          \"min-w-0\",\n          hasAside && contentPlacementVariants[asideBreakpoint][asidePosition],\n        )}\n      >\n        {children}\n      </div>\n\n      {hasAside && (\n        <aside\n          data-slot=\"page-aside\"\n          aria-label={asideLabel}\n          {...asideProps}\n          className={cn(\n            \"min-w-0\",\n            asideCollapse === \"hide\" && asideHiddenVariants[asideBreakpoint],\n            asidePlacementVariants[asideBreakpoint][asidePosition],\n            asideProps?.className,\n          )}\n        >\n          {aside}\n        </aside>\n      )}\n    </>\n  );\n\n  return useRender({\n    defaultTagName: \"div\",\n    render,\n    state: { slot: \"page-body\" },\n    props: mergeProps<\"div\">(\n      {\n        ...dataAttributes,\n        className: cn(\n          \"grid min-w-0 grid-cols-1 items-start gap-6\",\n          hasAside && asideWidthVariants[asideWidth],\n          hasAside && asideTemplateVariants[asideBreakpoint][asidePosition],\n          className,\n        ),\n        children: content,\n      },\n      props,\n    ),\n  });\n}\n\n// ------------------------------------------------------------------\n// Compound API\n// ------------------------------------------------------------------\n\nconst Page = Object.assign(PageRoot, {\n  Header: PageHeader,\n  Actions: PageActions,\n  Body: PageBody,\n});\n\nexport { Page, PageRoot, PageHeader, PageActions, PageBody, isRenderable };\n\nexport type {\n  PageProps,\n  PageSize,\n  PageHeaderProps,\n  PageTitleElement,\n  PageActionsProps,\n  PageBodyProps,\n  PageAsideWidth,\n  PageAsidePosition,\n  PageAsideBreakpoint,\n  PageAsideCollapse,\n};\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}