{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "changelog-page",
  "title": "Changelog Page",
  "description": "Releases grouped by date with version, category, and product area filters.",
  "dependencies": [
    "class-variance-authority"
  ],
  "registryDependencies": [
    "label",
    "select",
    "https://uaiblocks.dev/r/uai-theme.json",
    "https://uaiblocks.dev/r/changelog-entry.json",
    "https://uaiblocks.dev/r/empty-state.json",
    "https://uaiblocks.dev/r/filter-bar.json",
    "https://uaiblocks.dev/r/uai-utils.json"
  ],
  "files": [
    {
      "path": "src/registry/uai/blocks/changelog-page.tsx",
      "content": "\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport {\n  type ComponentProps,\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useId,\n  useLayoutEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport { Label } from \"@/components/ui/label\";\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from \"@/components/ui/select\";\nimport {\n  ChangelogEntry,\n  type ChangelogEntryProps,\n  type ChangelogEntryVariant,\n} from \"@/components/ui/uai/changelog-entry\";\nimport { EmptyState, type EmptyStateProps } from \"@/components/ui/uai/empty-state\";\nimport {\n  FilterBar,\n  type FilterBarProps,\n  type FilterBarVariant,\n} from \"@/components/ui/uai/filter-bar\";\nimport { cn } from \"@/lib/uai-utils\";\n\nconst useIsomorphicLayoutEffect = typeof window === \"undefined\" ? useEffect : useLayoutEffect;\n\ntype RegisterOptionLabel = (value: string, label: ReactNode) => () => void;\n\n/**\n * Base UI's SelectValue prints the raw value unless it knows the label, and its items only mount\n * while the list is open. Options render once more inside this context, outside the Select, to\n * report their labels; Radix shows the same label either way.\n */\nconst OptionLabelsContext = createContext<RegisterOptionLabel | null>(null);\n\nfunction useOptionLabels() {\n  const [labels, setLabels] = useState<Record<string, ReactNode>>({});\n  const register = useCallback<RegisterOptionLabel>((value, label) => {\n    setLabels((current) => ({ ...current, [value]: label }));\n    return () => setLabels(({ [value]: _removed, ...rest }) => rest);\n  }, []);\n  return [labels, register] as const;\n}\n\n/** True inside the label collector, where an option only reports its label and renders nothing. */\nfunction useReportOptionLabel(value: string, label: ReactNode) {\n  const register = useContext(OptionLabelsContext);\n  useIsomorphicLayoutEffect(() => register?.(value, label), [register, value, label]);\n  return register !== null;\n}\n\nexport const CHANGELOG_PAGE_VARIANTS = [\"timeline\", \"cards\", \"compact\"] as const;\nexport type ChangelogPageVariant = (typeof CHANGELOG_PAGE_VARIANTS)[number];\nexport type ChangelogPageFilterName = \"category\" | \"area\";\nexport type ChangelogPageProps = ComponentProps<\"section\"> & {\n  variant?: ChangelogPageVariant;\n  /** Selected category filter. An empty string shows every category. */\n  category?: string;\n  defaultCategory?: string;\n  onCategoryChange?: (category: string) => void;\n  /** Selected product area filter. An empty string shows every area. */\n  area?: string;\n  defaultArea?: string;\n  onAreaChange?: (area: string) => void;\n};\n\ntype Registry = {\n  register: (key: string, visible: boolean) => void;\n  remove: (key: string) => void;\n};\ntype PageContext = Registry & {\n  id: string;\n  variant: ChangelogPageVariant;\n  filters: Record<ChangelogPageFilterName, string>;\n  setFilter: (name: ChangelogPageFilterName, value: string) => void;\n  total: number;\n  visible: number;\n};\nconst Context = createContext<PageContext | null>(null);\nfunction usePage(part: string) {\n  const context = useContext(Context);\n  if (!context) throw new Error(`${part} must be used within ChangelogPage`);\n  return context;\n}\nconst GroupContext = createContext<(Registry & { titleId: string }) | null>(null);\n\nconst changelogPageVariants = cva(\"grid min-w-0 text-[13px]/[18px] text-foreground\", {\n  variants: {\n    variant: { timeline: \"gap-7\", cards: \"gap-7\", compact: \"gap-4\" },\n  },\n});\n\nconst entryVariants: Record<ChangelogPageVariant, ChangelogEntryVariant> = {\n  timeline: \"timeline\",\n  cards: \"card\",\n  compact: \"compact\",\n};\nconst filterVariants: Record<ChangelogPageVariant, FilterBarVariant> = {\n  timeline: \"toolbar\",\n  cards: \"toolbar\",\n  compact: \"compact\",\n};\n\nfunction useRegistry() {\n  const [entries, setEntries] = useState<Record<string, boolean>>({});\n  const register = useCallback(\n    (key: string, visible: boolean) =>\n      setEntries((current) =>\n        current[key] === visible ? current : { ...current, [key]: visible },\n      ),\n    [],\n  );\n  const remove = useCallback(\n    (key: string) =>\n      setEntries((current) => {\n        if (!(key in current)) return current;\n        const { [key]: _, ...rest } = current;\n        return rest;\n      }),\n    [],\n  );\n  const values = Object.values(entries);\n  return {\n    register,\n    remove,\n    total: values.length,\n    visible: values.filter(Boolean).length,\n  };\n}\n\n/** Releases grouped by date, with version, category, and product area filters. */\nexport function ChangelogPage({\n  variant = \"timeline\",\n  category,\n  defaultCategory = \"\",\n  onCategoryChange,\n  area,\n  defaultArea = \"\",\n  onAreaChange,\n  children,\n  className,\n  ...props\n}: ChangelogPageProps) {\n  const id = useId();\n  const [internalCategory, setInternalCategory] = useState(defaultCategory);\n  const [internalArea, setInternalArea] = useState(defaultArea);\n  const filters = { category: category ?? internalCategory, area: area ?? internalArea };\n  const registry = useRegistry();\n  const setFilter = (name: ChangelogPageFilterName, value: string) => {\n    if (filters[name] === value) return;\n    if (name === \"category\") {\n      if (category === undefined) setInternalCategory(value);\n      onCategoryChange?.(value);\n    } else {\n      if (area === undefined) setInternalArea(value);\n      onAreaChange?.(value);\n    }\n  };\n  return (\n    <Context.Provider value={{ id, variant, filters, setFilter, ...registry }}>\n      <section\n        aria-labelledby={`${id}-title`}\n        data-slot=\"changelog-page\"\n        className={cn(changelogPageVariants({ variant }), className)}\n        {...props}\n        data-variant={variant}\n      >\n        {children}\n      </section>\n    </Context.Provider>\n  );\n}\n\nexport function ChangelogPageHeader({ className, ...props }: ComponentProps<\"header\">) {\n  const { variant } = usePage(\"ChangelogPageHeader\");\n  return (\n    <header\n      data-slot=\"changelog-page-header\"\n      className={cn(\n        \"flex min-w-0 flex-wrap items-end justify-between\",\n        variant === \"compact\" ? \"gap-2\" : \"gap-4\",\n        className,\n      )}\n      {...props}\n    />\n  );\n}\n\nexport function ChangelogPageTitle({ className, ...props }: ComponentProps<\"h1\">) {\n  const { id, variant } = usePage(\"ChangelogPageTitle\");\n  return (\n    <h1\n      data-slot=\"changelog-page-title\"\n      className={cn(\n        \"m-0 font-semibold tracking-[-0.015em] text-balance\",\n        variant === \"compact\" ? \"text-xl/[26px]\" : \"text-[28px]/[34px]\",\n        className,\n      )}\n      {...props}\n      id={`${id}-title`}\n    />\n  );\n}\n\nexport function ChangelogPageDescription({ className, ...props }: ComponentProps<\"p\">) {\n  return (\n    <p\n      data-slot=\"changelog-page-description\"\n      className={cn(\"m-0 max-w-[60ch] text-pretty text-muted-foreground\", className)}\n      {...props}\n    />\n  );\n}\n\n/** A Filter Bar whose reset clears the category and area filters. */\nexport function ChangelogPageFilters(\n  props: Omit<FilterBarProps, \"variant\" | \"activeCount\" | \"onReset\">,\n) {\n  const context = usePage(\"ChangelogPageFilters\");\n  return (\n    <FilterBar\n      data-slot=\"changelog-page-filters\"\n      {...props}\n      variant={filterVariants[context.variant]}\n      activeCount={[context.filters.category, context.filters.area].filter(Boolean).length}\n      onReset={() => {\n        context.setFilter(\"category\", \"\");\n        context.setFilter(\"area\", \"\");\n      }}\n    />\n  );\n}\n\nexport type ChangelogPageFilterProps = Omit<\n  ComponentProps<typeof SelectTrigger>,\n  \"id\" | \"name\" | \"size\" | \"value\" | \"defaultValue\" | \"onChange\"\n> & {\n  name: ChangelogPageFilterName;\n  /** Visible label for the select. */\n  label: string;\n};\n\n// Radix Select forbids empty item values, so the \"All\" option (\"\") maps to this private value.\nconst ALL_VALUE = \"__uai-changelog-all__\";\n\nconst filterTriggerClass =\n  \"w-auto max-w-full cursor-pointer gap-1 rounded-full border-0 bg-secondary py-0 pr-2 pl-2.5 text-[12.5px]/[18px] font-medium text-secondary-foreground shadow-none transition-colors duration-120 ease-[ease-out] hover:bg-[color-mix(in_oklab,var(--secondary)_85%,var(--foreground))] focus-visible:ring-0 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring focus-visible:outline-solid motion-reduce:transition-none dark:bg-secondary dark:hover:bg-[color-mix(in_oklab,var(--secondary)_85%,var(--foreground))] [&_svg]:size-3.5\";\nconst filterContentClass =\n  \"min-w-36 rounded-[14px] border-0 bg-popover text-popover-foreground shadow-[0_0_0_1px_var(--border-strong),0_12px_28px_-10px_oklch(0_0_0/0.32),0_2px_6px_-2px_oklch(0_0_0/0.12)] duration-180 ease-[cubic-bezier(0.16,1,0.3,1)] data-[state=closed]:zoom-out-96 data-closed:zoom-out-96 data-[state=open]:zoom-in-96 data-open:zoom-in-96 data-[state=open]:[--tw-enter-translate-x:0]! data-open:[--tw-enter-translate-x:0]! data-[state=open]:[--tw-enter-translate-y:0]! data-open:[--tw-enter-translate-y:0]! motion-reduce:data-[state=closed]:animate-none motion-reduce:data-closed:animate-none motion-reduce:data-[state=open]:animate-none motion-reduce:data-open:animate-none\";\n\n/**\n * A labelled select bound to one page filter. Compose ChangelogPageFilterOption items inside;\n * the page's onCategoryChange / onAreaChange report changes.\n */\nexport function ChangelogPageFilter({\n  name,\n  label,\n  className,\n  children,\n  ...props\n}: ChangelogPageFilterProps) {\n  const context = usePage(\"ChangelogPageFilter\");\n  const id = useId();\n  const compact = context.variant === \"compact\";\n  const [labels, registerLabel] = useOptionLabels();\n  const selected = context.filters[name] || ALL_VALUE;\n  return (\n    <span className=\"inline-flex min-w-0 items-center gap-2\">\n      <Label\n        htmlFor={id}\n        className=\"text-[12px] leading-[inherit] font-normal text-subtle-foreground select-auto\"\n      >\n        {label}\n      </Label>\n      <Select\n        name={name}\n        value={selected}\n        onValueChange={(next: string | null) => {\n          if (next !== null) context.setFilter(name, next === ALL_VALUE ? \"\" : next);\n        }}\n      >\n        <SelectTrigger\n          data-slot=\"changelog-page-filter\"\n          className={cn(\n            filterTriggerClass,\n            compact ? \"data-[size=default]:h-6\" : \"data-[size=default]:h-7\",\n            className,\n          )}\n          {...props}\n          id={id}\n        >\n          <SelectValue>{labels[selected]}</SelectValue>\n        </SelectTrigger>\n        <SelectContent className={filterContentClass}>{children}</SelectContent>\n      </Select>\n      <OptionLabelsContext.Provider value={registerLabel}>{children}</OptionLabelsContext.Provider>\n    </span>\n  );\n}\n\nexport type ChangelogPageFilterOptionProps = Omit<ComponentProps<typeof SelectItem>, \"value\"> & {\n  /** Filter value. Use an empty string for the \"All\" option. */\n  value: string;\n};\n\n/** One option inside ChangelogPageFilter. */\nexport function ChangelogPageFilterOption({\n  value,\n  className,\n  ...props\n}: ChangelogPageFilterOptionProps) {\n  const context = usePage(\"ChangelogPageFilterOption\");\n  const collecting = useReportOptionLabel(value === \"\" ? ALL_VALUE : value, props.children);\n  if (collecting) return null;\n  return (\n    <SelectItem\n      data-slot=\"changelog-page-filter-option\"\n      className={cn(\n        \"cursor-pointer rounded-[10px] text-foreground focus:bg-accent focus:text-foreground\",\n        context.variant === \"compact\"\n          ? \"min-h-7 py-1 pr-7 pl-2 text-[12.5px]/[18px]\"\n          : \"min-h-8 py-1.5 pr-8 pl-2.5 text-[13px]/[18px]\",\n        className,\n      )}\n      {...props}\n      value={value === \"\" ? ALL_VALUE : value}\n    />\n  );\n}\n\n/** A polite status with the number of matching releases. */\nexport function ChangelogPageCount({ className, children, ...props }: ComponentProps<\"p\">) {\n  const { visible, total } = usePage(\"ChangelogPageCount\");\n  return (\n    <p\n      role=\"status\"\n      data-slot=\"changelog-page-count\"\n      className={cn(\"m-0 text-[12px] text-subtle-foreground tabular-nums\", className)}\n      {...props}\n    >\n      {children ??\n        (visible === total\n          ? `${total} ${total === 1 ? \"release\" : \"releases\"}`\n          : `Showing ${visible} of ${total} releases`)}\n    </p>\n  );\n}\n\n/** Releases for one period. The group hides itself when none of its releases match. */\nexport function ChangelogPageGroup({ className, ...props }: ComponentProps<\"section\">) {\n  const { variant } = usePage(\"ChangelogPageGroup\");\n  const titleId = useId();\n  const registry = useRegistry();\n  const empty = registry.total > 0 && registry.visible === 0;\n  const value = useMemo(\n    () => ({ titleId, register: registry.register, remove: registry.remove }),\n    [titleId, registry.register, registry.remove],\n  );\n  return (\n    <GroupContext.Provider value={value}>\n      <section\n        aria-labelledby={titleId}\n        hidden={empty}\n        data-slot=\"changelog-page-group\"\n        className={cn(\n          \"min-w-0\",\n          empty ? \"hidden\" : \"grid\",\n          variant === \"compact\" ? \"gap-2\" : \"gap-4\",\n          className,\n        )}\n        {...props}\n      />\n    </GroupContext.Provider>\n  );\n}\n\nexport function ChangelogPageGroupTitle({ className, ...props }: ComponentProps<\"h2\">) {\n  const group = useContext(GroupContext);\n  const { variant } = usePage(\"ChangelogPageGroupTitle\");\n  if (!group) throw new Error(\"ChangelogPageGroupTitle must be used within ChangelogPageGroup\");\n  return (\n    <h2\n      data-slot=\"changelog-page-group-title\"\n      className={cn(\n        \"m-0 border-b text-[11.5px]/4 font-medium text-subtle-foreground tabular-nums\",\n        variant === \"compact\" ? \"pb-1\" : \"pb-2\",\n        className,\n      )}\n      {...props}\n      id={group.titleId}\n    />\n  );\n}\n\nexport type ChangelogPageReleaseProps = Omit<ChangelogEntryProps, \"variant\"> & {\n  /** Category values matched by the category filter, for example [\"added\", \"fixed\"]. */\n  categories?: readonly string[];\n  /** Product area matched by the area filter. */\n  area?: string;\n};\n/** One release, a Changelog Entry. It renders nothing while the filters exclude it. */\nexport function ChangelogPageRelease({\n  categories = [],\n  area,\n  className,\n  ...props\n}: ChangelogPageReleaseProps) {\n  const context = usePage(\"ChangelogPageRelease\");\n  const group = useContext(GroupContext);\n  const key = useId();\n  const { filters, register, remove } = context;\n  const visible =\n    (!filters.category || categories.includes(filters.category)) &&\n    (!filters.area || filters.area === area);\n  useEffect(() => {\n    register(key, visible);\n    group?.register(key, visible);\n  }, [key, visible, register, group]);\n  useEffect(\n    () => () => {\n      remove(key);\n      group?.remove(key);\n    },\n    [key, remove, group],\n  );\n  if (!visible) return null;\n  return (\n    <ChangelogEntry\n      data-slot=\"changelog-page-release\"\n      {...props}\n      className={cn(\n        \"animate-in fill-mode-both duration-240 ease-out-quint fade-in-0 slide-in-from-bottom-1 motion-reduce:animate-none\",\n        className,\n      )}\n      variant={entryVariants[context.variant]}\n      data-area={area}\n      data-categories={categories.join(\" \") || undefined}\n    />\n  );\n}\n\n/** Shown when the filters match no releases. Compose Empty State parts inside it. */\nexport function ChangelogPageEmpty(props: Omit<EmptyStateProps, \"variant\">) {\n  const context = usePage(\"ChangelogPageEmpty\");\n  if (context.total === 0 || context.visible > 0) return null;\n  return (\n    <EmptyState\n      data-slot=\"changelog-page-empty\"\n      {...props}\n      variant={context.variant === \"compact\" ? \"compact\" : \"card\"}\n    />\n  );\n}\n",
      "type": "registry:component",
      "target": "@components/uai/changelog-page.tsx"
    }
  ],
  "categories": [
    "content",
    "changelog"
  ],
  "type": "registry:block"
}