{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-progress-bar",
  "title": "Progress Bar",
  "description": "Horizontal progress indicator with animated fill, configurable label positions, size presets, custom fill/track color overrides via CSS tokens, getValueLabel for custom label formatting, max prop, and semantic color intents. Built on the Radix UI Progress primitive.",
  "dependencies": [
    "class-variance-authority"
  ],
  "registryDependencies": [
    "@lema-ds/skeleton",
    "@lema-ds/tooltip",
    "@lema-ds/progress",
    "@lema-ds/ui-i18n",
    "@lema-ds/ds-locale-provider",
    "@lema-ds/tokens"
  ],
  "files": [
    {
      "path": "components/ds/ds-progress-bar.tsx",
      "content": "\"use client\"\n\nimport { cva } from \"class-variance-authority\"\nimport type { VariantProps } from \"class-variance-authority\"\nimport type { CSSProperties, HTMLAttributes, ReactNode } from \"react\"\nimport { cn } from \"@/lib/utils\"\nimport { UI_I18N, type UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\nimport {\n  Tooltip,\n  TooltipContent,\n  TooltipProvider,\n  TooltipTrigger,\n} from \"@/components/ui/tooltip\"\nimport { Progress } from \"@/components/ui/progress\"\n\n// ── Types ──────────────────────────────────────────────────────────────────\n\nexport type ProgressBarIntent =\n  \"primary\" | \"secondary\" | \"success\" | \"destructive\"\nexport type ProgressBarSize = \"sm\" | \"md\" | \"lg\"\nexport type ProgressBarLabelLayout = \"inline\" | \"above\" | \"below\"\n\nexport interface ProgressBarVariantProps\n  extends\n    VariantProps<typeof progressBarContainerVariants>,\n    VariantProps<typeof progressBarNameVariants>,\n    VariantProps<typeof progressBarLabelVariants>,\n    VariantProps<typeof progressBarFillVariants> {}\n\nexport interface ProgressBarProps\n  extends ProgressBarVariantProps, HTMLAttributes<HTMLDivElement> {\n  value: number\n  name?: string\n  namePosition?: \"left\" | \"right\"\n  upper?: boolean\n  showLabel?: boolean\n  labelPosition?: \"left\" | \"right\"\n  labelLayout?: ProgressBarLabelLayout\n  labelWidth?: number\n  intent?: ProgressBarIntent\n  size?: ProgressBarSize\n  total?: number\n  loading?: boolean\n  precision?: number\n  max?: number\n  getValueLabel?: (value: number, max: number) => string\n  tooltip?: ReactNode\n  /** Locale used for formatting the percentage label */\n  locale?: UILocale\n  /**\n   * Override fill color via CSS token `--progress-fill`.\n   * Accepts any CSS color value or `var(--my-token)`.\n   * @example fillColor=\"var(--color-brand)\"\n   */\n  fillColor?: string\n  /**\n   * Override track (background) color via CSS token `--progress-track`.\n   * Accepts any CSS color value or `var(--my-token)`.\n   */\n  trackColor?: string\n}\n\n// ── Variants ───────────────────────────────────────────────────────────────\n\nexport const progressBarContainerVariants = cva(\"flex w-full\", {\n  variants: {\n    labelLayout: {\n      inline: \"items-center gap-2\",\n      above: \"flex-col gap-1\",\n      below: \"flex-col gap-1\",\n    },\n  },\n  defaultVariants: { labelLayout: \"inline\" },\n})\n\nexport const progressBarNameVariants = cva(\n  \"truncate font-medium text-muted-foreground\",\n  {\n    variants: {\n      upper: { true: \"uppercase\" },\n      position: {\n        left: \"\",\n        right: \"text-foreground\",\n      },\n      size: {\n        sm: \"text-xs\",\n        md: \"text-sm\",\n        lg: \"text-base\",\n      },\n    },\n    defaultVariants: { upper: false, position: \"left\", size: \"md\" },\n  }\n)\n\nexport const progressBarLabelVariants = cva(\n  \"shrink-0 text-center font-semibold tabular-nums\",\n  {\n    variants: {\n      size: {\n        sm: \"w-8 text-xs\",\n        md: \"w-10 text-sm\",\n        lg: \"w-12 text-base\",\n      },\n    },\n    defaultVariants: { size: \"md\" },\n  }\n)\n\nexport const progressBarFillVariants = cva(\n  \"size-full flex-1 rounded-full transition-[transform] duration-700 ease-out\",\n  {\n    variants: {\n      intent: {\n        primary: \"bg-primary\",\n        secondary: \"bg-secondary\",\n        success: \"bg-success\",\n        destructive: \"bg-destructive\",\n      },\n    },\n    defaultVariants: { intent: \"primary\" },\n  }\n)\n\n// ── Skeleton sizes keyed by size prop ──────────────────────────────────────\n\nconst skeletonDims: Record<\n  ProgressBarSize,\n  { name: string; label: string; track: string }\n> = {\n  sm: { name: \"h-3 w-24\", label: \"h-3 w-8\", track: \"h-2\" },\n  md: { name: \"h-4 w-32\", label: \"h-4 w-10\", track: \"h-3\" },\n  lg: { name: \"h-5 w-40\", label: \"h-5 w-12\", track: \"h-4\" },\n}\n\n// ── ProgressBar ────────────────────────────────────────────────────────────\n\nexport function ProgressBar({\n  value,\n  name,\n  namePosition = \"left\",\n  upper = false,\n  showLabel = true,\n  labelPosition = \"left\",\n  labelLayout = \"above\",\n  labelWidth,\n  intent = \"primary\",\n  size = \"sm\",\n  total,\n  loading = false,\n  precision = 0,\n  max = 100,\n  getValueLabel,\n  tooltip,\n  locale: localeProp,\n  fillColor,\n  trackColor,\n  style,\n  className,\n  ...props\n}: ProgressBarProps) {\n  const locale = useUILocale(localeProp)\n  const tokenStyle = {\n    ...(fillColor !== undefined && { \"--progress-fill\": fillColor }),\n    ...(trackColor !== undefined && { \"--progress-track\": trackColor }),\n    ...style,\n  } as CSSProperties\n  const clamped =\n    total !== undefined\n      ? Math.max(0, Math.min(1, value / total))\n      : Math.max(0, Math.min(1, value > 1 ? value / 100 : value))\n\n  const displayLabel =\n    total !== undefined\n      ? `${value} / ${total}`\n      : new Intl.NumberFormat(locale, {\n          style: \"percent\",\n          minimumFractionDigits: precision,\n          maximumFractionDigits: precision,\n        }).format(clamped)\n\n  const displayName = upper ? name?.toUpperCase() : name\n  const ratioDims: typeof skeletonDims = {\n    sm: {\n      name: skeletonDims.sm.name,\n      label: \"h-3 w-14\",\n      track: skeletonDims.sm.track,\n    },\n    md: {\n      name: skeletonDims.md.name,\n      label: \"h-4 w-16\",\n      track: skeletonDims.md.track,\n    },\n    lg: {\n      name: skeletonDims.lg.name,\n      label: \"h-5 w-20\",\n      track: skeletonDims.lg.track,\n    },\n  }\n  const dims = total !== undefined ? ratioDims[size] : skeletonDims[size]\n  const isStacked = labelLayout === \"above\" || labelLayout === \"below\"\n\n  // ── Loading state ────────────────────────────────────────────────────────\n\n  if (loading) {\n    if (isStacked) {\n      const labelsRowSkeleton =\n        (name ?? showLabel) ? (\n          <div className=\"flex items-center justify-between gap-2\">\n            {name && <Skeleton className={dims.name} />}\n            {showLabel && <Skeleton className={dims.label} />}\n          </div>\n        ) : null\n\n      const trackSkeleton = (\n        <Skeleton className={cn(\"w-full rounded-full\", dims.track)} />\n      )\n\n      return (\n        <div\n          data-slot=\"progress-bar\"\n          style={tokenStyle}\n          className={cn(\n            progressBarContainerVariants({ labelLayout }),\n            className\n          )}\n          {...props}\n        >\n          {labelLayout === \"above\" && labelsRowSkeleton}\n          {trackSkeleton}\n          {labelLayout === \"below\" && labelsRowSkeleton}\n        </div>\n      )\n    }\n\n    return (\n      <div\n        data-slot=\"progress-bar\"\n        style={tokenStyle}\n        className={cn(progressBarContainerVariants({ labelLayout }), className)}\n        {...props}\n      >\n        {name && <Skeleton className={dims.name} />}\n        {showLabel && <Skeleton className={dims.label} />}\n        <Skeleton className={cn(\"flex-1 rounded-full\", dims.track)} />\n      </div>\n    )\n  }\n\n  // ── Track ────────────────────────────────────────────────────────────────\n\n  const intentIndicatorClass: Record<ProgressBarIntent, string> = {\n    primary: \"\",\n    secondary: \"*:data-[slot=progress-indicator]:bg-secondary\",\n    success: \"*:data-[slot=progress-indicator]:bg-success\",\n    destructive: \"*:data-[slot=progress-indicator]:bg-destructive\",\n  }\n\n  const trackHeight_: Record<ProgressBarSize, string> = {\n    sm: \"min-w-20\",\n    md: \"min-w-24\",\n    lg: \"min-w-32\",\n  }\n\n  const track = (\n    <Progress\n      className={cn(\n        isStacked ? \"w-full\" : \"flex-1\",\n        trackHeight_[size],\n        !fillColor && intentIndicatorClass[intent],\n        fillColor && \"*:data-[slot=progress-indicator]:bg-(--progress-fill)\",\n        trackColor && \"bg-(--progress-track)\",\n        \"*:data-[slot=progress-indicator]:transition-[transform] *:data-[slot=progress-indicator]:duration-700 *:data-[slot=progress-indicator]:ease-out\"\n      )}\n      value={clamped * 100}\n      max={max}\n      getValueLabel={getValueLabel}\n      aria-label={\n        name ?? (locale ? UI_I18N[locale].progressBar.label : \"Progress\")\n      }\n      aria-valuenow={Math.round(clamped * 100)}\n      aria-valuemin={0}\n      aria-valuemax={100}\n      style={{\n        height: size === \"sm\" ? \"0.5rem\" : size === \"lg\" ? \"1rem\" : undefined,\n      }}\n    />\n  )\n\n  const wrappedTrack = tooltip ? (\n    <TooltipProvider delayDuration={100}>\n      <Tooltip>\n        <TooltipTrigger asChild>{track}</TooltipTrigger>\n        <TooltipContent>{tooltip}</TooltipContent>\n      </Tooltip>\n    </TooltipProvider>\n  ) : (\n    track\n  )\n\n  // ── Above / below layout ─────────────────────────────────────────────────\n\n  if (isStacked) {\n    const labelsRow =\n      (name ?? showLabel) ? (\n        <div className=\"flex items-center justify-between gap-2\">\n          {name && (\n            <span\n              className={progressBarNameVariants({\n                upper,\n                position: \"left\",\n                size,\n              })}\n            >\n              {displayName}\n            </span>\n          )}\n          {showLabel && (\n            <span\n              className={cn(\n                progressBarLabelVariants({ size }),\n                \"w-auto text-right\"\n              )}\n            >\n              {displayLabel}\n            </span>\n          )}\n        </div>\n      ) : null\n\n    return (\n      <div\n        data-slot=\"progress-bar\"\n        className={cn(progressBarContainerVariants({ labelLayout }), className)}\n        {...props}\n      >\n        {labelLayout === \"above\" && labelsRow}\n        {wrappedTrack}\n        {labelLayout === \"below\" && labelsRow}\n      </div>\n    )\n  }\n\n  // ── Inline layout (default, backward-compatible) ─────────────────────────\n\n  return (\n    <div\n      data-slot=\"progress-bar\"\n      className={cn(progressBarContainerVariants({ labelLayout }), className)}\n      {...props}\n    >\n      {name && namePosition === \"left\" && (\n        <span\n          className={progressBarNameVariants({ upper, position: \"left\", size })}\n          style={labelWidth ? { width: labelWidth } : undefined}\n        >\n          {displayName}\n        </span>\n      )}\n\n      {showLabel && labelPosition === \"left\" && (\n        <span\n          className={cn(\n            progressBarLabelVariants({ size }),\n            total !== undefined && \"w-auto\"\n          )}\n        >\n          {displayLabel}\n        </span>\n      )}\n\n      {wrappedTrack}\n\n      {name && namePosition === \"right\" && (\n        <span\n          className={progressBarNameVariants({\n            upper,\n            position: \"right\",\n            size,\n          })}\n          style={labelWidth ? { width: labelWidth } : undefined}\n        >\n          {displayName}\n        </span>\n      )}\n\n      {showLabel && labelPosition === \"right\" && (\n        <span\n          className={cn(\n            progressBarLabelVariants({ size }),\n            total !== undefined && \"w-auto\"\n          )}\n        >\n          {displayLabel}\n        </span>\n      )}\n    </div>\n  )\n}\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
