{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "pagination",
  "title": "Pagination",
  "description": "ink-framed page navigation (<nav aria-label=\"Pagination\">) with deterministic ellipsis range builder, tabular summary, and aria-current=\"page\" ink inversion.",
  "registryDependencies": [
    "https://frame12.dev/r/frame12-styles.json"
  ],
  "files": [
    {
      "path": "ui/pagination.tsx",
      "content": "'use client';\n\nimport * as React from 'react';\n\nexport type PaginationDensity = 'comfortable' | 'compact';\nexport type PaginationRangeToken = number | 'ellipsis-start' | 'ellipsis-end';\n\nfunction toSafeInt(value: number | undefined, fallback: number, min: number): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    return Math.max(min, Math.floor(fallback));\n  }\n  return Math.max(min, Math.floor(value));\n}\n\nfunction isModifiedLinkClick(\n  event: React.MouseEvent<HTMLElement>,\n  href: string | undefined,\n): boolean {\n  if (event.defaultPrevented) return true;\n  if (href === undefined) return false;\n  return (\n    event.metaKey ||\n    event.ctrlKey ||\n    event.shiftKey ||\n    event.altKey ||\n    (typeof event.button === 'number' && event.button !== 0)\n  );\n}\n\nexport function buildPaginationRange(\n  page: number,\n  totalPages: number,\n  siblingCount = 1,\n  boundaryCount = 1,\n): PaginationRangeToken[] {\n  const safeTotal = toSafeInt(totalPages, 1, 1);\n  const safeSiblings = toSafeInt(siblingCount, 1, 0);\n  const safeBoundaries = toSafeInt(boundaryCount, 1, 1);\n  const safePage = Math.min(toSafeInt(page, 1, 1), safeTotal);\n\n  const totalPageNumbers = safeSiblings * 2 + safeBoundaries * 2 + 3;\n  if (safeTotal <= totalPageNumbers) {\n    return Array.from({ length: safeTotal }, (_, i) => i + 1);\n  }\n\n  const leftSiblingIndex = Math.max(safePage - safeSiblings, 1);\n  const rightSiblingIndex = Math.min(safePage + safeSiblings, safeTotal);\n\n  const showLeftEllipsis = leftSiblingIndex > safeBoundaries + 1;\n  const showRightEllipsis = rightSiblingIndex < safeTotal - safeBoundaries;\n\n  if (!showLeftEllipsis && showRightEllipsis) {\n    const leftItemCount = safeBoundaries + 2 + 2 * safeSiblings;\n    const leftRange = Array.from({ length: leftItemCount }, (_, i) => i + 1);\n    const rightBoundary = Array.from(\n      { length: safeBoundaries },\n      (_, i) => safeTotal - safeBoundaries + 1 + i,\n    );\n    return [...leftRange, 'ellipsis-end', ...rightBoundary];\n  }\n\n  if (showLeftEllipsis && !showRightEllipsis) {\n    const rightItemCount = safeBoundaries + 2 + 2 * safeSiblings;\n    const start = safeTotal - rightItemCount + 1;\n    const leftBoundary = Array.from({ length: safeBoundaries }, (_, i) => i + 1);\n    const rightRange = Array.from({ length: rightItemCount }, (_, i) => start + i);\n    return [...leftBoundary, 'ellipsis-start', ...rightRange];\n  }\n\n  const leftBoundary = Array.from({ length: safeBoundaries }, (_, i) => i + 1);\n  const rightBoundary = Array.from(\n    { length: safeBoundaries },\n    (_, i) => safeTotal - safeBoundaries + 1 + i,\n  );\n  const middleLength = rightSiblingIndex - leftSiblingIndex + 1;\n  const middleRange = Array.from({ length: middleLength }, (_, i) => leftSiblingIndex + i);\n  return [...leftBoundary, 'ellipsis-start', ...middleRange, 'ellipsis-end', ...rightBoundary];\n}\n\nconst PaginationContext = React.createContext<{\n  density: PaginationDensity;\n}>({\n  density: 'comfortable',\n});\n\nexport interface PaginationSummaryDetails {\n  page: number;\n  totalPages: number;\n  startItem?: number;\n  endItem?: number;\n  totalItems?: number;\n}\n\nexport interface PaginationProps extends Omit<React.HTMLAttributes<HTMLElement>, 'onChange'> {\n  page?: number;\n  defaultPage?: number;\n  totalPages?: number;\n  onPageChange?: (page: number) => void;\n  siblingCount?: number;\n  boundaryCount?: number;\n  density?: PaginationDensity;\n  ariaLabel?: string;\n  previousLabel?: React.ReactNode;\n  nextLabel?: React.ReactNode;\n  ellipsisLabel?: string;\n  showSummary?: boolean;\n  totalItems?: number;\n  pageSize?: number;\n  formatSummary?: (details: PaginationSummaryDetails) => React.ReactNode;\n  getItemAriaLabel?: (\n    type: 'page' | 'previous' | 'next',\n    page: number,\n    isCurrent: boolean,\n  ) => string;\n  getItemHref?: (page: number) => string | undefined;\n}\n\nexport const Pagination = React.forwardRef<HTMLElement, PaginationProps>(function Pagination(\n  {\n    page: controlledPage,\n    defaultPage = 1,\n    totalPages,\n    onPageChange,\n    siblingCount = 1,\n    boundaryCount = 1,\n    density = 'comfortable',\n    ariaLabel = 'Pagination',\n    'aria-label': userAriaLabel,\n    previousLabel = 'Prev',\n    nextLabel = 'Next',\n    ellipsisLabel = 'More pages',\n    showSummary = false,\n    totalItems,\n    pageSize = 20,\n    formatSummary,\n    getItemAriaLabel,\n    getItemHref,\n    className = '',\n    children,\n    ...rest\n  },\n  ref,\n) {\n  const isCompact = density === 'compact';\n  const isControlled = controlledPage !== undefined;\n  const safeDefaultPage = toSafeInt(defaultPage, 1, 1);\n  const [uncontrolledPage, setUncontrolledPage] = React.useState<number>(() => safeDefaultPage);\n  const safeTotal = totalPages !== undefined ? toSafeInt(totalPages, 1, 1) : 1;\n  const rawPage = isControlled ? controlledPage : uncontrolledPage;\n  const currentPage = Math.min(toSafeInt(rawPage, safeDefaultPage, 1), safeTotal);\n  const safePageSize = toSafeInt(pageSize, 20, 1);\n  const safeTotalItems =\n    typeof totalItems === 'number' && Number.isFinite(totalItems) && totalItems >= 0\n      ? Math.floor(totalItems)\n      : undefined;\n\n  const selectPage = React.useCallback(\n    (next: number) => {\n      if (typeof next !== 'number' || !Number.isFinite(next)) return;\n      const clamped = Math.min(Math.max(1, Math.floor(next)), safeTotal);\n      if (clamped === currentPage) return;\n      if (!isControlled) {\n        setUncontrolledPage(clamped);\n      }\n      onPageChange?.(clamped);\n    },\n    [currentPage, isControlled, onPageChange, safeTotal],\n  );\n\n  const ctxValue = React.useMemo(() => ({ density }), [density]);\n  const hasDataPagination = totalPages !== undefined && !children;\n  const tokens = React.useMemo(\n    () =>\n      hasDataPagination\n        ? buildPaginationRange(currentPage, safeTotal, siblingCount, boundaryCount)\n        : [],\n    [hasDataPagination, currentPage, safeTotal, siblingCount, boundaryCount],\n  );\n\n  let summaryNode: React.ReactNode = null;\n  if (showSummary && hasDataPagination) {\n    const startItem =\n      safeTotalItems === undefined\n        ? undefined\n        : safeTotalItems === 0\n          ? 0\n          : (currentPage - 1) * safePageSize + 1;\n    const endItem =\n      safeTotalItems === undefined\n        ? undefined\n        : Math.min(currentPage * safePageSize, safeTotalItems);\n    if (formatSummary) {\n      summaryNode = formatSummary({\n        page: currentPage,\n        totalPages: safeTotal,\n        startItem,\n        endItem,\n        totalItems: safeTotalItems,\n      });\n    } else {\n      const pad = (n: number) => String(n).padStart(2, '0');\n      if (safeTotalItems !== undefined && startItem !== undefined && endItem !== undefined) {\n        summaryNode = `PAGE ${pad(currentPage)} OF ${pad(safeTotal)} · ${startItem}–${endItem} OF ${safeTotalItems}`;\n      } else {\n        summaryNode = `PAGE ${pad(currentPage)} OF ${pad(safeTotal)}`;\n      }\n    }\n  }\n\n  const prevPage = Math.max(1, currentPage - 1);\n  const nextPage = Math.min(safeTotal, currentPage + 1);\n  const prevHref = getItemHref?.(prevPage);\n  const nextHref = getItemHref?.(nextPage);\n\n  return (\n    <PaginationContext.Provider value={ctxValue}>\n      <nav\n        ref={ref}\n        aria-label={userAriaLabel ?? ariaLabel}\n        data-density={isCompact ? 'compact' : undefined}\n        className={`f12-pagination${isCompact ? ' f12-pagination-compact' : ''}${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {showSummary && summaryNode !== null && summaryNode !== '' && (\n          <div className=\"f12-pagination-summary\" aria-live=\"polite\">\n            {summaryNode}\n          </div>\n        )}\n        {hasDataPagination ? (\n          <PaginationContent>\n            <PaginationItem>\n              <PaginationPrevious\n                href={prevHref}\n                disabled={currentPage <= 1}\n                aria-label={\n                  getItemAriaLabel\n                    ? getItemAriaLabel('previous', prevPage, false)\n                    : 'Go to previous page'\n                }\n                onClick={(e) => {\n                  if (!isModifiedLinkClick(e, prevHref)) {\n                    selectPage(currentPage - 1);\n                  }\n                }}\n              >\n                {previousLabel}\n              </PaginationPrevious>\n            </PaginationItem>\n            {tokens.map((token) => {\n              if (token === 'ellipsis-start' || token === 'ellipsis-end') {\n                return (\n                  <PaginationItem key={token}>\n                    <PaginationEllipsis aria-label={ellipsisLabel} />\n                  </PaginationItem>\n                );\n              }\n              const isCurrent = token === currentPage;\n              const itemHref = getItemHref?.(token);\n              return (\n                <PaginationItem key={token}>\n                  <PaginationLink\n                    href={itemHref}\n                    isActive={isCurrent}\n                    aria-label={\n                      getItemAriaLabel\n                        ? getItemAriaLabel('page', token, isCurrent)\n                        : isCurrent\n                          ? `Page ${token}, current page`\n                          : `Go to page ${token}`\n                    }\n                    onClick={(e) => {\n                      if (!isModifiedLinkClick(e, itemHref)) {\n                        selectPage(token);\n                      }\n                    }}\n                  >\n                    {token}\n                  </PaginationLink>\n                </PaginationItem>\n              );\n            })}\n            <PaginationItem>\n              <PaginationNext\n                href={nextHref}\n                disabled={currentPage >= safeTotal}\n                aria-label={\n                  getItemAriaLabel\n                    ? getItemAriaLabel('next', nextPage, false)\n                    : 'Go to next page'\n                }\n                onClick={(e) => {\n                  if (!isModifiedLinkClick(e, nextHref)) {\n                    selectPage(currentPage + 1);\n                  }\n                }}\n              >\n                {nextLabel}\n              </PaginationNext>\n            </PaginationItem>\n          </PaginationContent>\n        ) : (\n          children\n        )}\n      </nav>\n    </PaginationContext.Provider>\n  );\n});\n\nexport type PaginationContentProps = React.HTMLAttributes<HTMLUListElement>;\n\nexport const PaginationContent = React.forwardRef<HTMLUListElement, PaginationContentProps>(\n  function PaginationContent({ className = '', children, ...rest }, ref) {\n    return (\n      <ul\n        ref={ref}\n        className={`f12-pagination-list${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {children}\n      </ul>\n    );\n  },\n);\n\nexport type PaginationItemProps = React.LiHTMLAttributes<HTMLLIElement>;\n\nexport const PaginationItem = React.forwardRef<HTMLLIElement, PaginationItemProps>(\n  function PaginationItem({ className = '', children, ...rest }, ref) {\n    return (\n      <li\n        ref={ref}\n        className={`f12-pagination-item${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        {children}\n      </li>\n    );\n  },\n);\n\nexport interface PaginationLinkProps\n  extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onClick' | 'type'>,\n    Pick<\n      React.AnchorHTMLAttributes<HTMLAnchorElement>,\n      'href' | 'target' | 'download' | 'rel' | 'hrefLang' | 'ping' | 'referrerPolicy' | 'media'\n    > {\n  type?: React.ButtonHTMLAttributes<HTMLButtonElement>['type'] | (string & {});\n  disabled?: boolean;\n  isActive?: boolean;\n  density?: PaginationDensity;\n  onClick?: React.MouseEventHandler<HTMLElement>;\n}\n\nexport const PaginationLink = React.forwardRef<\n  HTMLButtonElement | HTMLAnchorElement,\n  PaginationLinkProps\n>(function PaginationLink(\n  {\n    href,\n    type,\n    isActive = false,\n    disabled = false,\n    density: propDensity,\n    'aria-current': userAriaCurrent,\n    className = '',\n    onClick,\n    children,\n    ...rest\n  },\n  ref,\n) {\n  const ctx = React.useContext(PaginationContext);\n  const effectiveDensity = propDensity ?? ctx.density;\n  const isCompact = effectiveDensity === 'compact';\n  const ariaCurrent = userAriaCurrent ?? (isActive ? 'page' : undefined);\n  const mergedClass = `f12-pagination-link${isActive ? ' f12-pagination-link-active' : ''}${isCompact ? ' f12-pagination-link-compact' : ''}${disabled ? ' f12-pagination-link-disabled' : ''}${className ? ` ${className}` : ''}`;\n\n  if (href !== undefined) {\n    return (\n      <a\n        ref={ref as React.Ref<HTMLAnchorElement>}\n        href={disabled ? undefined : href}\n        type={type}\n        aria-current={ariaCurrent}\n        aria-disabled={disabled ? 'true' : undefined}\n        tabIndex={disabled ? -1 : undefined}\n        data-active={isActive ? 'true' : undefined}\n        className={mergedClass}\n        onClick={(e) => {\n          if (disabled) {\n            e.preventDefault();\n            return;\n          }\n          onClick?.(e);\n        }}\n        {...(rest as React.AnchorHTMLAttributes<HTMLAnchorElement>)}\n      >\n        {children}\n      </a>\n    );\n  }\n\n  return (\n    <button\n      ref={ref as React.Ref<HTMLButtonElement>}\n      type={(type as React.ButtonHTMLAttributes<HTMLButtonElement>['type']) ?? 'button'}\n      disabled={disabled}\n      aria-current={ariaCurrent}\n      data-active={isActive ? 'true' : undefined}\n      className={mergedClass}\n      onClick={(e) => {\n        if (disabled) {\n          e.preventDefault();\n          return;\n        }\n        onClick?.(e);\n      }}\n      {...(rest as React.ButtonHTMLAttributes<HTMLButtonElement>)}\n    >\n      {children}\n    </button>\n  );\n});\n\nexport type PaginationPreviousProps = PaginationLinkProps;\n\nexport const PaginationPrevious = React.forwardRef<\n  HTMLButtonElement | HTMLAnchorElement,\n  PaginationPreviousProps\n>(function PaginationPrevious(\n  { 'aria-label': ariaLabel = 'Go to previous page', className = '', children, ...rest },\n  ref,\n) {\n  return (\n    <PaginationLink\n      ref={ref}\n      aria-label={ariaLabel}\n      className={`f12-pagination-prev${className ? ` ${className}` : ''}`}\n      {...rest}\n    >\n      <span className=\"f12-pagination-arrow\" aria-hidden=\"true\">\n        ‹\n      </span>\n      <span>{children ?? 'Prev'}</span>\n    </PaginationLink>\n  );\n});\n\nexport type PaginationNextProps = PaginationLinkProps;\n\nexport const PaginationNext = React.forwardRef<\n  HTMLButtonElement | HTMLAnchorElement,\n  PaginationNextProps\n>(function PaginationNext(\n  { 'aria-label': ariaLabel = 'Go to next page', className = '', children, ...rest },\n  ref,\n) {\n  return (\n    <PaginationLink\n      ref={ref}\n      aria-label={ariaLabel}\n      className={`f12-pagination-next${className ? ` ${className}` : ''}`}\n      {...rest}\n    >\n      <span>{children ?? 'Next'}</span>\n      <span className=\"f12-pagination-arrow\" aria-hidden=\"true\">\n        ›\n      </span>\n    </PaginationLink>\n  );\n});\n\nexport type PaginationEllipsisProps = React.HTMLAttributes<HTMLSpanElement>;\n\nexport const PaginationEllipsis = React.forwardRef<HTMLSpanElement, PaginationEllipsisProps>(\n  function PaginationEllipsis(\n    { 'aria-label': ariaLabel = 'More pages', className = '', children, ...rest },\n    ref,\n  ) {\n    return (\n      <span\n        ref={ref}\n        className={`f12-pagination-ellipsis${className ? ` ${className}` : ''}`}\n        {...rest}\n      >\n        <span aria-hidden=\"true\">{children ?? '…'}</span>\n        <span className=\"f12-sr-only\">{ariaLabel}</span>\n      </span>\n    );\n  },\n);\n",
      "type": "registry:ui",
      "target": "components/frame12/pagination.tsx"
    }
  ],
  "type": "registry:ui"
}