{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-page-header",
  "title": "Page Header",
  "description": "Cabeçalho de página padronizado com breadcrumbs, título, tags, ações e navegação de retorno.",
  "dependencies": [
    "class-variance-authority",
    "lucide-react"
  ],
  "registryDependencies": [
    "@lema-ds/button",
    "@lema-ds/skeleton",
    "@lema-ds/ui-i18n",
    "@lema-ds/ds-locale-provider"
  ],
  "files": [
    {
      "path": "components/ds/ds-page-header.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { cva, type VariantProps } from \"class-variance-authority\"\nimport { ArrowLeft } from \"lucide-react\"\n\nimport { cn } from \"@/lib/utils\"\nimport { Button } from \"@/components/ui/button\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\nimport { UI_I18N, type UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\n\n// ── Variants ──\n\nexport const pageHeaderContainerVariants = cva(\"flex w-full flex-col gap-3\", {\n  variants: {\n    size: {\n      sm: \"pb-3\",\n      md: \"pb-4\",\n      lg: \"pb-6\",\n    },\n    variant: {\n      default: \"border-b border-border\",\n      compact: \"\",\n      banner: \"rounded-xl border border-border bg-muted/40 p-6\",\n    },\n  },\n  defaultVariants: {\n    size: \"md\",\n    variant: \"default\",\n  },\n})\n\nexport const pageHeaderTitleVariants = cva(\n  \"font-semibold tracking-tight text-foreground\",\n  {\n    variants: {\n      size: {\n        sm: \"text-base font-semibold\",\n        md: \"text-lg font-semibold\",\n        lg: \"text-xl font-bold\",\n      },\n    },\n    defaultVariants: {\n      size: \"md\",\n    },\n  }\n)\n\nexport const pageHeaderDescriptionVariants = cva(\"text-muted-foreground\", {\n  variants: {\n    size: {\n      sm: \"text-xs font-normal\",\n      md: \"text-sm font-normal\",\n      lg: \"text-base font-normal\",\n    },\n  },\n  defaultVariants: {\n    size: \"md\",\n  },\n})\n\n// ── Types ──\n\nexport interface PageHeaderProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, \"title\">,\n    VariantProps<typeof pageHeaderContainerVariants> {\n  /**\n   * Primary title of the page.\n   */\n  title: React.ReactNode\n  /**\n   * Secondary description or help text.\n   */\n  description?: React.ReactNode\n  /**\n   * Breadcrumb navigation component or elements rendered above title.\n   */\n  breadcrumbs?: React.ReactNode\n  /**\n   * Actions or button group aligned to the right.\n   */\n  actions?: React.ReactNode\n  /**\n   * Optional status badge rendered next to the title.\n   */\n  badge?: React.ReactNode\n  /**\n   * Additional metadata tags or info rendered below the description.\n   */\n  metadata?: React.ReactNode\n  /**\n   * Callback fired when clicking the back button.\n   */\n  onBack?: () => void\n  /**\n   * Optional URL for back button if functioning as a link.\n   */\n  backHref?: string\n  /**\n   * Accessible label for back button. Defaults to localized \"Back\".\n   */\n  backLabel?: string\n  /**\n   * Loading state showing matched skeleton components.\n   */\n  loading?: boolean\n  /**\n   * Root HTML element to render. Defaults to 'header'.\n   */\n  as?: \"header\" | \"section\" | \"div\"\n  /**\n   * Locale for text translation.\n   */\n  locale?: UILocale\n}\n\n// ── Component ──\n\nexport const PageHeader = React.forwardRef<HTMLDivElement, PageHeaderProps>(\n  (\n    {\n      as = \"header\",\n      title,\n      description,\n      breadcrumbs,\n      actions,\n      badge,\n      metadata,\n      onBack,\n      backHref,\n      backLabel,\n      size = \"md\",\n      variant = \"default\",\n      loading = false,\n      locale: localeProp,\n      className,\n      ...props\n    },\n    ref\n  ) => {\n    const locale = useUILocale(localeProp)\n    const t = UI_I18N[locale].pageHeader\n    const resolvedBackLabel = backLabel ?? t.back\n\n    const backIconSize =\n      size === \"sm\" ? \"size-3.5\" : size === \"lg\" ? \"size-5\" : \"size-4\"\n\n    if (loading) {\n      return (\n        <div\n          ref={ref}\n          className={cn(\n            pageHeaderContainerVariants({ size, variant }),\n            className\n          )}\n          {...props}\n        >\n          {breadcrumbs && <Skeleton className=\"h-4 w-40\" />}\n          <div className=\"flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between\">\n            <div className=\"flex flex-col gap-2\">\n              <Skeleton\n                className={cn(\n                  \"w-64\",\n                  size === \"sm\" ? \"h-6\" : size === \"lg\" ? \"h-8\" : \"h-7\"\n                )}\n              />\n              <Skeleton className=\"h-4 w-96\" />\n            </div>\n            {actions && <Skeleton className=\"h-9 w-32 shrink-0\" />}\n          </div>\n        </div>\n      )\n    }\n\n    const renderBackButton = () => {\n      if (!onBack && !backHref) return null\n\n      if (backHref) {\n        return (\n          <Button\n            variant=\"ghost\"\n            size=\"icon\"\n            className=\"size-8 shrink-0\"\n            asChild\n            aria-label={resolvedBackLabel}\n          >\n            <a href={backHref}>\n              <ArrowLeft className={backIconSize} />\n            </a>\n          </Button>\n        )\n      }\n\n      return (\n        <Button\n          type=\"button\"\n          variant=\"ghost\"\n          size=\"icon\"\n          className=\"size-8 shrink-0\"\n          onClick={onBack}\n          aria-label={resolvedBackLabel}\n        >\n          <ArrowLeft className={backIconSize} />\n        </Button>\n      )\n    }\n\n    const Comp = as\n\n    return (\n      <Comp\n        ref={ref}\n        className={cn(\n          pageHeaderContainerVariants({ size, variant }),\n          className\n        )}\n        {...props}\n      >\n        {breadcrumbs && <div className=\"w-full\">{breadcrumbs}</div>}\n        <div className=\"flex flex-col gap-3 sm:flex-row sm:items-start sm:justify-between\">\n          <div className=\"flex min-w-0 items-start gap-2.5\">\n            {renderBackButton()}\n            <div className=\"flex min-w-0 flex-col gap-1\">\n              <div className=\"flex flex-wrap items-center gap-2\">\n                <h1 className={cn(pageHeaderTitleVariants({ size }))}>\n                  {title}\n                </h1>\n                {badge && <div className=\"shrink-0\">{badge}</div>}\n              </div>\n              {description && (\n                <div className={cn(pageHeaderDescriptionVariants({ size }))}>\n                  {description}\n                </div>\n              )}\n              {metadata && (\n                <div className=\"flex flex-wrap items-center gap-2 pt-1\">\n                  {metadata}\n                </div>\n              )}\n            </div>\n          </div>\n          {actions && (\n            <div className=\"flex shrink-0 items-center gap-2 pt-1 sm:pt-0\">\n              {actions}\n            </div>\n          )}\n        </div>\n      </Comp>\n    )\n  }\n)\n\nPageHeader.displayName = \"PageHeader\"\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
