@alfadocs/ui-kit-debug 0.20.0 → 0.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfadocs/ui-kit-debug",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "type": "module",
   "description": "AlfaDocs shared design system — tokens, components, patterns, and translations for platform, booking, and alfascribe. (debug build — identical runtime to @alfadocs/ui-kit, ships source maps for symbolication).",
   "license": "BUSL-1.1",

package/dist/_chunks/alert-DBnawbmf.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"alert-DBnawbmf.js","sources":["../../src/components/alert/alert.tsx"],"sourcesContent":["import {\n  Children,\n  forwardRef,\n  isValidElement,\n  useCallback,\n  useRef,\n  useState,\n  type HTMLAttributes,\n  type ReactNode,\n} from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { Info, CircleCheck, TriangleAlert, CircleX, X } from 'lucide-react';\nimport { useControllableState } from '../../hooks/use-controllable-state';\n\nconst alertVariants = cva(\n  [\n    // Default `items-center` keeps the icon + dismiss optically aligned\n    // with a single-line description. The `data-[has-title=true]`\n    // selector flips to `items-start` when an `<Alert.Title>` is\n    // present so the icon anchors to the heading's top instead of\n    // floating against the centre of the title+description block.\n    // For multi-line descriptions without a title, `items-center` still\n    // looks right at 2–3 lines and matches Toast / Notification.\n    'ds:flex ds:items-center ds:data-[has-title=true]:items-start ds:gap-[var(--spacing-md)]',\n    'ds:rounded-[var(--radius-md)]',\n    'ds:border ds:border-[length:var(--border-width-sm)]',\n    'ds:p-[var(--spacing-md)]',\n    'ds:break-words',\n  ].join(' '),\n  {\n    variants: {\n      // Each variant paints `<Button intent=\"tonal\">` descendants via a\n      // child selector — the button carries `data-intent=\"tonal\"`, the\n      // Alert applies the matching tint (`*-foreground` for bg + the\n      // surface `--background` for fg). Descendant selectors sidestep\n      // custom-property inheritance and are rock-solid across themes.\n      variant: {\n        info: [\n          'ds:border-[color:var(--info)]',\n          'ds:bg-[color-mix(in_srgb,var(--info)_10%,transparent)]',\n          'ds:text-[var(--info-foreground)]',\n          'ds:[&_[data-intent=tonal]]:bg-[color:var(--info-foreground)]',\n          'ds:[&_[data-intent=tonal]]:text-[color:var(--background)]',\n        ].join(' '),\n        success: [\n          'ds:border-[color:var(--success)]',\n          'ds:bg-[color-mix(in_srgb,var(--success)_10%,transparent)]',\n          'ds:text-[var(--success-foreground)]',\n          'ds:[&_[data-intent=tonal]]:bg-[color:var(--success-foreground)]',\n          'ds:[&_[data-intent=tonal]]:text-[color:var(--background)]',\n        ].join(' '),\n        warning: [\n          'ds:border-[color:var(--warning)]',\n          'ds:bg-[color-mix(in_srgb,var(--warning)_10%,transparent)]',\n          'ds:text-[var(--warning-foreground)]',\n          'ds:[&_[data-intent=tonal]]:bg-[color:var(--warning-foreground)]',\n          'ds:[&_[data-intent=tonal]]:text-[color:var(--background)]',\n        ].join(' '),\n        error: [\n          'ds:border-[color:var(--error)]',\n          'ds:bg-[color-mix(in_srgb,var(--error)_10%,transparent)]',\n          'ds:text-[var(--error-foreground)]',\n          'ds:[&_[data-intent=tonal]]:bg-[color:var(--error-foreground)]',\n          'ds:[&_[data-intent=tonal]]:text-[color:var(--background)]',\n        ].join(' '),\n      },\n    },\n    defaultVariants: {\n      variant: 'info',\n    },\n  },\n);\n\n// Icon stays `mt-0.5` only when an `<Alert.Title>` is present — that\n// offset compensates for the title's cap-height vs. line-box origin so\n// the glyph aligns with the heading's caps. Without a title, the\n// container uses `items-center` and the offset would push the icon\n// 2px off the optical axis.\nconst ICON_BASE = 'ds:shrink-0 ds:size-5';\nconst ICON_WITH_TITLE = `${ICON_BASE} ds:mt-0.5`;\n\nconst CLOSE_BUTTON_CLASSES = [\n  'ds:ms-auto ds:shrink-0 ds:inline-flex ds:items-center ds:justify-center',\n  'ds:rounded-[var(--radius-sm)]',\n  'ds:min-h-[var(--min-target-size)] ds:min-w-[var(--min-target-size)]',\n  'ds:-mt-[var(--spacing-xs)] ds:-me-[var(--spacing-xs)]',\n  'ds:text-current ds:opacity-70',\n  'ds:hover:opacity-100',\n  'ds:transition-opacity ds:duration-[var(--animation-duration)] ds:motion-reduce:transition-none',\n  'ds:focus-visible:outline-[length:var(--focus-ring-width)] ds:focus-visible:outline-solid',\n  'ds:focus-visible:outline-[color:var(--ring)] ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]',\n  'ds:forced-colors:focus-visible:outline-[CanvasText]',\n].join(' ');\n\nconst VARIANT_CONFIG = {\n  info: { icon: <Info aria-hidden=\"true\" />, role: 'status', live: 'polite' },\n  success: {\n    icon: <CircleCheck aria-hidden=\"true\" />,\n    role: 'status',\n    live: 'polite',\n  },\n  warning: {\n    icon: <TriangleAlert aria-hidden=\"true\" />,\n    role: 'alert',\n    live: 'assertive',\n  },\n  error: {\n    icon: <CircleX aria-hidden=\"true\" />,\n    role: 'alert',\n    live: 'assertive',\n  },\n} as const;\n\ninterface AlertTitleProps extends HTMLAttributes<HTMLHeadingElement> {\n  as?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span';\n}\n\nconst AlertTitle = forwardRef<HTMLHeadingElement, AlertTitleProps>(\n  ({ as: Tag = 'h5', className, ...props }, ref) => (\n    <Tag\n      ref={ref}\n      className={['type-title-item', className].filter(Boolean).join(' ')}\n      {...props}\n    />\n  ),\n);\nAlertTitle.displayName = 'Alert.Title';\n\nconst AlertDescription = forwardRef<\n  HTMLParagraphElement,\n  HTMLAttributes<HTMLParagraphElement>\n>(({ className, ...props }, ref) => (\n  <p\n    ref={ref}\n    // `mt` is gated on the root's `data-has-title=\"true\"` attribute so\n    // the margin only paints when there's a Title above the\n    // Description to separate from. Without this gate, a Description\n    // rendered alone sits a few pixels below the icon + dismiss ×\n    // optical centre — visible on the AlfaDocs marketing privacy\n    // generator before HTP-4860's follow-up fix.\n    className={[\n      'ds:[[data-has-title=true]_&]:mt-[var(--spacing-xs)] type-body-sm',\n      className,\n    ]\n      .filter(Boolean)\n      .join(' ')}\n    {...props}\n  />\n));\nAlertDescription.displayName = 'Alert.Description';\n\nconst AlertAction = forwardRef<HTMLDivElement, HTMLAttributes<HTMLDivElement>>(\n  ({ className, ...props }, ref) => (\n    <div\n      ref={ref}\n      className={[\n        'ds:mt-[var(--spacing-sm)] ds:flex ds:flex-wrap ds:items-center ds:gap-[var(--spacing-sm)]',\n        className,\n      ]\n        .filter(Boolean)\n        .join(' ')}\n      {...props}\n    />\n  ),\n);\nAlertAction.displayName = 'Alert.Action';\n\nexport interface AlertProps\n  extends\n    Omit<HTMLAttributes<HTMLDivElement>, 'role'>,\n    VariantProps<typeof alertVariants> {\n  variant?: 'info' | 'success' | 'warning' | 'error';\n  dismissible?: boolean;\n  open?: boolean;\n  onOpenChange?: (open: boolean) => void;\n  icon?: ReactNode;\n  live?: 'assertive' | 'polite' | 'off';\n}\n\nexport type { AlertTitleProps };\n\nconst AlertRoot = forwardRef<HTMLDivElement, AlertProps>(\n  (\n    {\n      variant = 'info',\n      dismissible = false,\n      open: controlledOpen,\n      onOpenChange,\n      icon,\n      live,\n      className,\n      children,\n      ...props\n    },\n    ref,\n  ) => {\n    const { t } = useTranslation();\n    const [isOpenRaw, setOpen] = useControllableState<boolean>({\n      value: controlledOpen,\n      defaultValue: true,\n      onChange: onOpenChange,\n    });\n    const isOpen = isOpenRaw ?? true;\n    const [isClosing, setIsClosing] = useState(false);\n    const closeTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n    const animationDurationMs = useCallback((): number => {\n      if (typeof window === 'undefined') return 200;\n      const raw = window\n        .getComputedStyle(document.documentElement)\n        .getPropertyValue('--animation-duration');\n      if (!raw) return 200;\n      const trimmed = raw.trim();\n      const n = parseFloat(trimmed);\n      if (!Number.isFinite(n)) return 200;\n      return trimmed.endsWith('ms') ? n : n * 1000;\n    }, []);\n\n    if (!isOpen) return null;\n\n    const config = VARIANT_CONFIG[variant];\n    const effectiveIcon = icon !== undefined ? icon : config.icon;\n\n    // Detect an `<Alert.Title>` anywhere in the immediate children so\n    // the root can flip its cross-axis alignment. Nested wrappers\n    // around a Title aren't supported — keep the API as flat as the\n    // existing `Alert.Title` / `Alert.Description` convention.\n    const hasTitle = Children.toArray(children).some(\n      (child) => isValidElement(child) && child.type === AlertTitle,\n    );\n\n    const handleDismiss = () => {\n      if (isClosing) return;\n      setIsClosing(true);\n      if (closeTimerRef.current) clearTimeout(closeTimerRef.current);\n      closeTimerRef.current = setTimeout(() => {\n        setIsClosing(false);\n        setOpen(false);\n      }, animationDurationMs());\n    };\n\n    return (\n      <div\n        ref={ref}\n        role={config.role}\n        aria-live={live ?? config.live}\n        data-component=\"alert\"\n        data-has-title={hasTitle ? 'true' : 'false'}\n        data-state={isClosing ? 'closing' : 'open'}\n        className={[\n          alertVariants({ variant, className }),\n          // Entry: fade + slide-down on mount. Exit: fade + slide-up + slight\n          // scale when dismissed. Driven by `tw-animate-css`. Respects\n          // `prefers-reduced-motion` via `motion-safe:` and zeroes under the\n          // accessible theme (`--animation-duration: 0ms`).\n          'ds:motion-safe:animate-in ds:motion-safe:fade-in-0 ds:motion-safe:slide-in-from-top-2',\n          'ds:motion-safe:data-[state=closing]:animate-out ds:motion-safe:data-[state=closing]:fade-out-0',\n          'ds:motion-safe:data-[state=closing]:slide-out-to-top-2 ds:motion-safe:data-[state=closing]:zoom-out-95',\n          // Pin the exit's end-state until React unmounts. Without\n          // `fill-mode-forwards` the element snaps back to opacity:1 for one\n          // paint frame after the animation ends.\n          'ds:motion-safe:data-[state=closing]:fill-mode-forwards',\n          'ds:motion-safe:duration-[var(--animation-duration)]',\n        ].join(' ')}\n        {...props}\n      >\n        {effectiveIcon ? (\n          <span className={hasTitle ? ICON_WITH_TITLE : ICON_BASE}>\n            {effectiveIcon}\n          </span>\n        ) : null}\n\n        <div className=\"ds:flex-1 ds:min-w-0\">{children}</div>\n\n        {dismissible ? (\n          <button\n            type=\"button\"\n            aria-label={t('common.close', 'Close')}\n            onClick={handleDismiss}\n            className={CLOSE_BUTTON_CLASSES}\n          >\n            <X aria-hidden=\"true\" className=\"ds:size-4\" />\n          </button>\n        ) : null}\n      </div>\n    );\n  },\n);\n\nAlertRoot.displayName = 'Alert';\n\nexport const Alert = Object.assign(AlertRoot, {\n  Title: AlertTitle,\n  Description: AlertDescription,\n  Action: AlertAction,\n});\n"],"names":["alertVariants","cva","ICON_BASE","ICON_WITH_TITLE","CLOSE_BUTTON_CLASSES","VARIANT_CONFIG","jsx","Info","CircleCheck","TriangleAlert","CircleX","AlertTitle","forwardRef","Tag","className","props","ref","AlertDescription","AlertAction","AlertRoot","variant","dismissible","controlledOpen","onOpenChange","icon","live","children","t","useTranslation","isOpenRaw","setOpen","useControllableState","isOpen","isClosing","setIsClosing","useState","closeTimerRef","useRef","animationDurationMs","useCallback","raw","trimmed","n","config","effectiveIcon","hasTitle","Children","child","isValidElement","handleDismiss","jsxs","Alert"],"mappings":"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"}

package/dist/_chunks/avatar-I10iCDs8.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"avatar-I10iCDs8.js","sources":["../../src/components/avatar/avatar.tsx"],"sourcesContent":["import {\n  forwardRef,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n  type HTMLAttributes,\n} from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { composeRefs } from '../_shared/compose-refs';\n\n// ── Hash ──────────────────────────────────────────────────────────────────────\n\n/** djb2 hash — fast, unsigned 32-bit, stable across calls. */\nfunction djb2(str: string): number {\n  let hash = 5381;\n  for (let i = 0; i < str.length; i++) {\n    hash = ((hash << 5) + hash) ^ str.charCodeAt(i);\n    hash = hash >>> 0; // coerce to unsigned 32-bit integer\n  }\n  return hash;\n}\n\n/**\n * 16 brand hues — all verified ≥ 4.5 : 1 contrast against white\n * (var(--primary-foreground)) using the WCAG 2.x relative-luminance formula.\n * Spans four distinct hue families for good visual distribution.\n *\n *  Index | Token                  | Contrast  | Visual character\n *  0     | --color-violet-500     | 4.74 : 1  | bright violet\n *  1     | --color-violet-600     | 5.53 : 1  | medium violet\n *  2     | --color-violet-700     | 7.29 : 1  | dark violet\n *  3     | --color-violet-800     | 9.57 : 1  | deep violet\n *  4     | --color-violet-900     | 12.06 : 1 | midnight violet\n *  5     | --color-purple-700     | 5.21 : 1  | medium purple\n *  6     | --color-purple-800     | 7.52 : 1  | dark purple\n *  7     | --color-purple-900     | 10.40 : 1 | deep purple\n *  8     | --color-magenta-700    | 6.01 : 1  | vivid magenta\n *  9     | --color-magenta-800    | 8.05 : 1  | dark magenta\n *  10    | --color-magenta-900    | 11.20 : 1 | deep magenta\n *  11    | --color-blue-300       | 4.64 : 1  | slate / steel blue\n *  12    | --color-blue-400       | 6.95 : 1  | medium slate\n *  13    | --color-blue-500       | 13.00 : 1 | deep navy\n *  14    | --color-blue-700       | 17.82 : 1 | midnight navy\n *  15    | --color-grey-900       | 5.78 : 1  | warm charcoal\n */\nconst INITIALS_BG_CLASSES = [\n  'ds:bg-[var(--color-violet-500)]',\n  'ds:bg-[var(--color-violet-600)]',\n  'ds:bg-[var(--color-violet-700)]',\n  'ds:bg-[var(--color-violet-800)]',\n  'ds:bg-[var(--color-violet-900)]',\n  'ds:bg-[var(--color-purple-700)]',\n  'ds:bg-[var(--color-purple-800)]',\n  'ds:bg-[var(--color-purple-900)]',\n  'ds:bg-[var(--color-magenta-700)]',\n  'ds:bg-[var(--color-magenta-800)]',\n  'ds:bg-[var(--color-magenta-900)]',\n  'ds:bg-[var(--color-blue-300)]',\n  'ds:bg-[var(--color-blue-400)]',\n  'ds:bg-[var(--color-blue-500)]',\n  'ds:bg-[var(--color-blue-700)]',\n  'ds:bg-[var(--color-grey-900)]',\n] as const;\n\n/** Deterministically maps a name string to one of 16 brand-hue Tailwind classes. Same name always produces the same class. */\nexport function nameToColorClass(name: string): string {\n  return INITIALS_BG_CLASSES[djb2(name) % INITIALS_BG_CLASSES.length];\n}\n\n/**\n * Extracts 1–2 uppercase initials:\n * - Single-word name: first two characters  (\"John\" → \"JO\")\n * - Multi-word name: first char of first word + first char of last word  (\"John Doe\" → \"JD\")\n */\nexport function getInitials(name: string): string {\n  const words = name.trim().split(/\\s+/).filter(Boolean);\n  if (words.length === 0) return '';\n  if (words.length === 1) return words[0].slice(0, 2).toUpperCase();\n  return (words[0][0] + words[words.length - 1][0]).toUpperCase();\n}\n\n// ── CVA ───────────────────────────────────────────────────────────────────────\n\nconst avatarVariants = cva(\n  [\n    'ds:relative ds:inline-flex ds:shrink-0 ds:select-none ds:items-center ds:justify-center ds:overflow-hidden ds:rounded-[var(--radius-full)]',\n    // Focus ring — uses design-system tokens so theme overrides (accessible: 3px) apply automatically.\n    // The ring renders when Avatar is placed inside a focusable ancestor (e.g. a <button>).\n    'ds:focus-visible:outline-solid',\n    'ds:focus-visible:outline-[length:var(--focus-ring-width)]',\n    'ds:focus-visible:outline-ring',\n    'ds:focus-visible:outline-offset-[length:var(--focus-ring-offset)]',\n  ].join(' '),\n  {\n    variants: {\n      size: {\n        // text-[var(--font-size-xs)] = 0.75rem (12px) — smallest available token\n        xs: 'ds:size-6 ds:text-[length:var(--font-size-xs)] ds:font-semibold ds:leading-none',\n        sm: 'ds:size-8 ds:text-[length:var(--font-size-xs)] ds:font-semibold ds:leading-none',\n        md: 'ds:size-10 ds:text-[length:var(--font-size-xs)] ds:font-semibold ds:leading-none',\n        lg: 'ds:size-12 ds:text-[length:var(--font-size-sm)] ds:font-semibold ds:leading-none',\n        xl: 'ds:size-16 ds:text-[length:var(--font-size-base)] ds:font-semibold ds:leading-none',\n      },\n    },\n    defaultVariants: { size: 'md' },\n  },\n);\n\n// ── Props ─────────────────────────────────────────────────────────────────────\n\nexport interface AvatarProps\n  extends\n    Omit<HTMLAttributes<HTMLSpanElement>, 'color'>,\n    VariantProps<typeof avatarVariants> {\n  /** Image source URL. When provided and loads successfully, the image is displayed. */\n  src?: string;\n  /** Display name — drives initials extraction and deterministic background colour. */\n  name?: string;\n  /**\n   * Override the auto-generated background with any CSS colour string\n   * (e.g. `\"var(--color-violet-700)\"`).\n   * Applied via a CSS custom property so no `style` attribute is added to the JSX element.\n   * Caller is responsible for WCAG AA contrast (≥4.5:1) against white text.\n   */\n  color?: string;\n}\n\n// ── Component ─────────────────────────────────────────────────────────────────\n\nexport const Avatar = forwardRef<HTMLSpanElement, AvatarProps>(\n  ({ src, name, color, size, className, ...props }, ref) => {\n    const { t } = useTranslation();\n\n    const innerRef = useRef<HTMLSpanElement>(null);\n    const composedRef = composeRefs(ref, innerRef);\n\n    // Track only image errors. The image renders immediately as an overlay;\n    // before it loads the browser paints nothing (transparent), showing the\n    // background colour + initials behind it. On error we remove the img and\n    // the initials/fallback remain permanently visible.\n    const [imgError, setImgError] = useState(false);\n\n    // Reset error flag whenever src changes\n    useEffect(() => {\n      setImgError(false);\n    }, [src]);\n\n    // Apply color override via CSS custom property — avoids style={{…}} on JSX.\n    // Mirrors the pattern used by the Progress component for imperative CSS property injection.\n    useLayoutEffect(() => {\n      const el = innerRef.current;\n      if (!el) return;\n      if (color) {\n        el.style.setProperty('--avatar-color-override', color);\n      } else {\n        el.style.removeProperty('--avatar-color-override');\n      }\n    }, [color]);\n\n    // Image is \"active\" when provided and not errored\n    const imgActive = !!src && !imgError;\n\n    // Initials and fallback icon are shown when no usable image\n    const showInitials = !imgActive && !!name;\n    const showIcon = !imgActive && !name;\n\n    // Background — always rendered (serves as loading placeholder when image is fetching)\n    const fallbackBgClass = color\n      ? 'ds:bg-[var(--avatar-color-override)]'\n      : name\n        ? nameToColorClass(name)\n        : 'ds:bg-muted';\n\n    // Always white text against brand hues / color override; muted-foreground for icon\n    const contentColorClass =\n      color || name\n        ? 'ds:text-[var(--primary-foreground)]'\n        : 'ds:text-muted-foreground';\n\n    const rootClassName = avatarVariants({\n      size,\n      className: [fallbackBgClass, contentColorClass, className]\n        .filter(Boolean)\n        .join(' '),\n    });\n\n    // Accessible label — name takes priority, then the localised placeholder\n    const ariaLabel = name ?? t('avatar.placeholder', 'User avatar');\n\n    return (\n      <span\n        ref={composedRef}\n        role=\"img\"\n        aria-label={ariaLabel}\n        data-component=\"avatar\"\n        className={rootClassName}\n        {...props}\n      >\n        {/* Initials — rendered behind the image; visible while image is loading\n            or permanently when no src / src errors */}\n        {(showInitials || imgActive) && !!name && (\n          <span aria-hidden=\"true\">{getInitials(name)}</span>\n        )}\n\n        {/* Fallback icon — shown when neither image nor name is available */}\n        {showIcon && (\n          <svg\n            aria-hidden=\"true\"\n            viewBox=\"0 0 24 24\"\n            className=\"ds:size-[58%] ds:fill-current\"\n          >\n            <path d=\"M12 12c2.76 0 5-2.24 5-5s-2.24-5-5-5-5 2.24-5 5 2.24 5 5 5zm0 2c-3.33 0-10 1.67-10 5v2h20v-2c0-3.33-6.67-5-10-5z\" />\n          </svg>\n        )}\n\n        {/* Image — absolutely positioned overlay. Renders transparently until the\n            browser paints the decoded pixels, then covers the initials behind it.\n            Removed from DOM on error so initials remain permanently visible. */}\n        {imgActive && (\n          <img\n            src={src}\n            alt=\"\"\n            aria-hidden=\"true\"\n            className=\"ds:absolute ds:inset-0 ds:size-full ds:object-cover\"\n            onError={() => setImgError(true)}\n          />\n        )}\n      </span>\n    );\n  },\n);\n\nAvatar.displayName = 'Avatar';\n"],"names":["djb2","str","hash","i","INITIALS_BG_CLASSES","nameToColorClass","name","getInitials","words","avatarVariants","cva","Avatar","forwardRef","src","color","size","className","props","ref","t","useTranslation","innerRef","useRef","composedRef","composeRefs","imgError","setImgError","useState","useEffect","useLayoutEffect","el","imgActive","showInitials","showIcon","fallbackBgClass","rootClassName","ariaLabel","jsxs","jsx"],"mappings":"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"}