@womp/kookie-ui 0.14.3 → 0.14.5

package/dist/esm/chunk-RJTWRLK4.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/components/message-scroller.tsx"],
-  "sourcesContent": ["'use client';\n\n/**\n * MessageScroller \u2014 a transcript that follows a conversation.\n *\n * The behaviour is shadcn/ui's Message Scroller primitive (`@shadcn/react/message-scroller`,\n * MIT, https://ui.shadcn.com). Streaming, anchoring a new turn, keeping your place when history\n * loads above, and jumping back to the latest are a body of edge cases nobody should rewrite, so\n * Kookie takes the primitive and adds only the surface: the parts, the class names, the button.\n *\n * Anatomy\n * ```tsx\n * <MessageScroller.Root>\n *   <MessageScroller.Viewport aria-label=\"Conversation\">\n *     <MessageScroller.Content>\n *       <MessageScroller.Item messageId=\"u1\" scrollAnchor>\u2026</MessageScroller.Item>\n *       <MessageScroller.Item messageId=\"a1\">\u2026</MessageScroller.Item>\n *     </MessageScroller.Content>\n *   </MessageScroller.Viewport>\n *   <MessageScroller.Button aria-label=\"Jump to the latest\" />\n * </MessageScroller.Root>\n * ```\n *\n * The viewport is its own scroller. Kookie's `ScrollArea` is Radix's, and Radix cannot hand its\n * viewport element to another library, so the transcript scrolls natively with a thin scrollbar.\n *\n * Requires React 19, which the primitive needs.\n */\n\nimport * as React from 'react';\nimport classNames from 'classnames';\nimport {\n  MessageScroller as Primitive,\n  useMessageScroller,\n  useMessageScrollerScrollable,\n  useMessageScrollerVisibility,\n  type MessageScrollerDefaultScrollPosition,\n  type MessageScrollerScrollOptions,\n  type MessageScrollerScrollable,\n  type MessageScrollerVisibilityState,\n} from '@shadcn/react/message-scroller';\n\nimport { useComposedRefs } from 'radix-ui/internal';\n\nimport { IconButton, type IconButtonProps } from './icon-button.js';\nimport { useScrollEdges } from '../hooks/use-scroll-edges.js';\n\ninterface RootProps extends React.ComponentPropsWithoutRef<'div'> {\n  /**\n   * Keeps the newest content in view while the reader is at the end. Default `true`.\n   * Once the reader scrolls up, the transcript stays where they are until they return.\n   */\n  autoScroll?: boolean;\n  /** Where the transcript opens: `end` (default), `start`, or the last anchored message. */\n  defaultScrollPosition?: MessageScrollerDefaultScrollPosition;\n  /** Distance in pixels from the end that still counts as \"at the end\". */\n  scrollEdgeThreshold?: number;\n  /** Space in pixels kept above a message when one is scrolled to or anchored. */\n  scrollMargin?: number;\n}\n\n/** Holds the scroll state. Everything else goes inside it. */\nconst Root = React.forwardRef<HTMLDivElement, RootProps>(\n  ({ autoScroll = true, defaultScrollPosition = 'end', scrollEdgeThreshold, scrollMargin, className, children, ...props }, forwardedRef) => (\n    <Primitive.Provider\n      autoScroll={autoScroll}\n      defaultScrollPosition={defaultScrollPosition}\n      {...(scrollEdgeThreshold != null ? { scrollEdgeThreshold } : {})}\n      {...(scrollMargin != null ? { scrollMargin } : {})}\n    >\n      <Primitive.Root {...props} ref={forwardedRef} className={classNames('rt-MessageScrollerRoot', className)}>\n        {children}\n      </Primitive.Root>\n    </Primitive.Provider>\n  ),\n);\nRoot.displayName = 'MessageScroller.Root';\n\ninterface ViewportProps extends React.ComponentPropsWithoutRef<'div'> {\n  /** Name of the transcript region, e.g. \"Conversation\". */\n  'aria-label'?: string;\n  /** Keep the reader's place when older messages are added above. Default `true`. */\n  preserveScrollOnPrepend?: boolean;\n  /**\n   * Fades messages toward the top and bottom edges while there is more past them. A floating\n   * band over an edge (a toolbar, a goal tray, a composer) can set `--scroll-fade-start` or\n   * `--scroll-fade-end` to its height, so messages fade as they pass under it. Default `true`.\n   */\n  fade?: boolean;\n}\n\n/** The scrolling element. */\nconst Viewport = React.forwardRef<HTMLDivElement, ViewportProps>(({ className, 'aria-label': label, fade = true, ...props }, forwardedRef) => {\n  const setEdgesElement = useScrollEdges<HTMLDivElement>(fade);\n  const ref = useComposedRefs(forwardedRef, setEdgesElement);\n  return (\n    // The primitive names an unnamed viewport \"Messages\", in English. An empty name is skipped by\n    // accessible-name computation, so a transcript is only named when the app names it.\n    <Primitive.Viewport\n      aria-label={label ?? ''}\n      {...props}\n      ref={ref}\n      data-fade={fade ? '' : undefined}\n      className={classNames('rt-MessageScrollerViewport', className)}\n    />\n  );\n});\nViewport.displayName = 'MessageScroller.Viewport';\n\ntype ContentProps = React.ComponentPropsWithoutRef<'div'>;\n\n/** The list of messages, inside the viewport. */\nconst Content = React.forwardRef<HTMLDivElement, ContentProps>(({ className, ...props }, forwardedRef) => (\n  <Primitive.Content {...props} ref={forwardedRef} className={classNames('rt-MessageScrollerContent', className)} />\n));\nContent.displayName = 'MessageScroller.Content';\n\ninterface ItemProps extends React.ComponentPropsWithoutRef<'div'> {\n  /** A stable id, so the row can be scrolled to with `useMessageScroller().scrollToMessage`. */\n  messageId?: string;\n  /** Anchor this row near the top when it arrives. Set it on the person's own messages. */\n  scrollAnchor?: boolean;\n}\n\n/** One row of the transcript. */\nconst Item = React.forwardRef<HTMLDivElement, ItemProps>(({ className, ...props }, forwardedRef) => (\n  <Primitive.Item {...props} ref={forwardedRef} className={classNames('rt-MessageScrollerItem', className)} />\n));\nItem.displayName = 'MessageScroller.Item';\n\ntype ButtonProps = Omit<IconButtonProps, 'aria-label' | 'aria-labelledby'> & {\n  /** Accessible name, in your words. Default \"Jump to the latest\". */\n  'aria-label'?: string;\n  /** `end` jumps to the latest message (default); `start` to the first. */\n  direction?: 'start' | 'end';\n  /** Scroll behaviour of the jump. Default `smooth`. */\n  behavior?: ScrollBehavior;\n};\n\n/**\n * Jumps back to the latest message. It renders only while the reader is away from the end.\n * Place it inside `Root`, after the viewport. It sits over the viewport's bottom edge.\n */\nconst Button = React.forwardRef<HTMLButtonElement, ButtonProps>(\n  ({ direction = 'end', behavior, className, children, size = '2', variant = 'surface', color = 'gray', radius = 'full', 'aria-label': label, ...props }, forwardedRef) => (\n    <Primitive.Button\n      direction={direction}\n      {...(behavior ? { behavior } : {})}\n      render={\n        <IconButton\n          {...props}\n          ref={forwardedRef}\n          size={size}\n          variant={variant}\n          color={color}\n          radius={radius}\n          aria-label={label ?? (direction === 'end' ? 'Jump to the latest' : 'Jump to the first')}\n          className={classNames('rt-MessageScrollerButton', className)}\n          data-direction={direction}\n        >\n          {children ?? (\n            <svg width=\"15\" height=\"15\" viewBox=\"0 0 15 15\" fill=\"none\" aria-hidden style={direction === 'start' ? { transform: 'rotate(180deg)' } : undefined}>\n              <path d=\"M7.5 2.5v10M3.5 8.5l4 4 4-4\" stroke=\"currentColor\" strokeWidth=\"1.5\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n            </svg>\n          )}\n        </IconButton>\n      }\n    />\n  ),\n);\nButton.displayName = 'MessageScroller.Button';\n\nexport { Root, Viewport, Content, Item, Button, useMessageScroller, useMessageScrollerScrollable, useMessageScrollerVisibility };\nexport type {\n  RootProps as MessageScrollerRootProps,\n  ViewportProps as MessageScrollerViewportProps,\n  ContentProps as MessageScrollerContentProps,\n  ItemProps as MessageScrollerItemProps,\n  ButtonProps as MessageScrollerButtonProps,\n  MessageScrollerDefaultScrollPosition,\n  MessageScrollerScrollOptions,\n  MessageScrollerScrollable,\n  MessageScrollerVisibilityState,\n};\n"],
-  "mappings": "wHAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,YAAAE,EAAA,YAAAC,EAAA,SAAAC,EAAA,SAAAC,EAAA,aAAAC,EAAA,uBAAAC,EAAA,iCAAAC,EAAA,iCAAAC,IA6BA,UAAYC,MAAW,QACvB,OAAOC,MAAgB,aACvB,OACE,mBAAmBC,EACnB,sBAAAL,EACA,gCAAAC,EACA,gCAAAC,MAKK,iCAEP,OAAS,mBAAAI,MAAuB,oBAoBhC,IAAMC,EAAa,aACjB,CAAC,CAAE,WAAAC,EAAa,GAAM,sBAAAC,EAAwB,MAAO,oBAAAC,EAAqB,aAAAC,EAAc,UAAAC,EAAW,SAAAC,EAAU,GAAGC,CAAM,EAAGC,IACvH,gBAACC,EAAU,SAAV,CACC,WAAYR,EACZ,sBAAuBC,EACtB,GAAIC,GAAuB,KAAO,CAAE,oBAAAA,CAAoB,EAAI,CAAC,EAC7D,GAAIC,GAAgB,KAAO,CAAE,aAAAA,CAAa,EAAI,CAAC,GAEhD,gBAACK,EAAU,KAAV,CAAgB,GAAGF,EAAO,IAAKC,EAAc,UAAWE,EAAW,yBAA0BL,CAAS,GACpGC,CACH,CACF,CAEJ,EACAN,EAAK,YAAc,uBAgBnB,IAAMW,EAAiB,aAA0C,CAAC,CAAE,UAAAN,EAAW,aAAcO,EAAO,KAAAC,EAAO,GAAM,GAAGN,CAAM,EAAGC,IAAiB,CAC5I,IAAMM,EAAkBC,EAA+BF,CAAI,EACrDG,EAAMC,EAAgBT,EAAcM,CAAe,EACzD,OAGE,gBAACL,EAAU,SAAV,CACC,aAAYG,GAAS,GACpB,GAAGL,EACJ,IAAKS,EACL,YAAWH,EAAO,GAAK,OACvB,UAAWH,EAAW,6BAA8BL,CAAS,EAC/D,CAEJ,CAAC,EACDM,EAAS,YAAc,2BAKvB,IAAMO,EAAgB,aAAyC,CAAC,CAAE,UAAAb,EAAW,GAAGE,CAAM,EAAGC,IACvF,gBAACC,EAAU,QAAV,CAAmB,GAAGF,EAAO,IAAKC,EAAc,UAAWE,EAAW,4BAA6BL,CAAS,EAAG,CACjH,EACDa,EAAQ,YAAc,0BAUtB,IAAMC,EAAa,aAAsC,CAAC,CAAE,UAAAd,EAAW,GAAGE,CAAM,EAAGC,IACjF,gBAACC,EAAU,KAAV,CAAgB,GAAGF,EAAO,IAAKC,EAAc,UAAWE,EAAW,yBAA0BL,CAAS,EAAG,CAC3G,EACDc,EAAK,YAAc,uBAenB,IAAMC,EAAe,aACnB,CAAC,CAAE,UAAAC,EAAY,MAAO,SAAAC,EAAU,UAAAjB,EAAW,SAAAC,EAAU,KAAAiB,EAAO,IAAK,QAAAC,EAAU,UAAW,MAAAC,EAAQ,OAAQ,OAAAC,EAAS,OAAQ,aAAcd,EAAO,GAAGL,CAAM,EAAGC,IACtJ,gBAACC,EAAU,OAAV,CACC,UAAWY,EACV,GAAIC,EAAW,CAAE,SAAAA,CAAS,EAAI,CAAC,EAChC,OACE,gBAACK,EAAA,CACE,GAAGpB,EACJ,IAAKC,EACL,KAAMe,EACN,QAASC,EACT,MAAOC,EACP,OAAQC,EACR,aAAYd,IAAUS,IAAc,MAAQ,qBAAuB,qBACnE,UAAWX,EAAW,2BAA4BL,CAAS,EAC3D,iBAAgBgB,GAEff,GACC,gBAAC,OAAI,MAAM,KAAK,OAAO,KAAK,QAAQ,YAAY,KAAK,OAAO,cAAW,GAAC,MAAOe,IAAc,QAAU,CAAE,UAAW,gBAAiB,EAAI,QACvI,gBAAC,QAAK,EAAE,8BAA8B,OAAO,eAAe,YAAY,MAAM,cAAc,QAAQ,eAAe,QAAQ,CAC7H,CAEJ,EAEJ,CAEJ,EACAD,EAAO,YAAc",
-  "names": ["message_scroller_exports", "__export", "Button", "Content", "Item", "Root", "Viewport", "useMessageScroller", "useMessageScrollerScrollable", "useMessageScrollerVisibility", "React", "classNames", "Primitive", "useComposedRefs", "Root", "autoScroll", "defaultScrollPosition", "scrollEdgeThreshold", "scrollMargin", "className", "children", "props", "forwardedRef", "Primitive", "classNames", "Viewport", "label", "fade", "setEdgesElement", "useScrollEdges", "ref", "useComposedRefs", "Content", "Item", "Button", "direction", "behavior", "size", "variant", "color", "radius", "IconButton"]
-}

package/dist/esm/chunk-YEYM7QQZ.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/components/icon-button.tsx"],
-  "sourcesContent": ["import * as React from 'react';\n\nimport { BaseButton } from './_internal/base-button.js';\nimport { Button } from './button.js';\nimport type { BaseButtonProps } from './_internal/base-button.js';\n\ntype IconButtonElement = React.ElementRef<typeof BaseButton>;\n\n/**\n * Required accessibility props for icon buttons\n * Icon buttons must have an accessible name to meet WCAG guidelines\n *\n * Three ways to provide accessibility:\n * 1. aria-label: Direct descriptive text\n * 2. aria-labelledby: Reference to a label element\n * 3. children: Visible text content (fallback)\n */\ntype AccessibilityProps =\n  | { 'aria-label': string; 'aria-labelledby'?: never }\n  | { 'aria-label'?: never; 'aria-labelledby': string }\n  | { 'aria-label'?: never; 'aria-labelledby'?: never; children: React.ReactNode };\n\n/**\n * Tooltip configuration props that can be passed to IconButton\n * These props are forwarded to the underlying Tooltip component\n */\ninterface IconButtonTooltipProps {\n  /** Content to display in the tooltip on hover/focus */\n  tooltip?: React.ReactNode;\n  /** Side of the button where the tooltip should appear */\n  tooltipSide?: 'top' | 'right' | 'bottom' | 'left';\n  /** Alignment of the tooltip relative to the button */\n  tooltipAlign?: 'start' | 'center' | 'end';\n  /** Delay before showing the tooltip (in milliseconds) */\n  tooltipDelayDuration?: number;\n  /** Whether to disable hoverable content behavior */\n  tooltipDisableHoverableContent?: boolean;\n}\n\n/**\n * Core IconButton props excluding the 'as' prop for polymorphic behavior\n * Combines BaseButton props with accessibility requirements and tooltip functionality\n */\ntype IconButtonOwnProps = Omit<BaseButtonProps, 'as'> & AccessibilityProps & IconButtonTooltipProps;\n\n/**\n * Polymorphic IconButton props that support rendering as different HTML elements\n * @template C - The element type to render as (defaults to 'button')\n */\ntype IconButtonProps<C extends React.ElementType = 'button'> = IconButtonOwnProps & {\n  /** Element type to render as (e.g., 'a', 'span', etc.) */\n  as?: C;\n} & Omit<React.ComponentPropsWithoutRef<C>, keyof IconButtonOwnProps>;\n\n/**\n * IconButton component type that supports polymorphic rendering\n * @template C - The element type to render as\n */\ntype IconButtonComponent = <C extends React.ElementType = 'button'>(props: IconButtonProps<C> & { ref?: React.ForwardedRef<IconButtonElement> }) => React.ReactElement | null;\n\n/**\n * IconButton component for compact, accessible icon-only interactions. It is `Button` with\n * `iconOnly` set, kept as its own name for its stricter type: an accessible name is required.\n *\n * The IconButton component extends Button with specialized behavior for visual symbols.\n * It enforces accessibility requirements, provides automatic square sizing, and includes\n * built-in tooltip integration. Icon buttons are essential for space-efficient interfaces\n * while maintaining accessibility compliance.\n *\n * Key features:\n * - Enforced accessibility requirements (aria-label, aria-labelledby, or children)\n * - Automatic square aspect ratios for consistent visual alignment\n * - Built-in tooltip support for context and guidance\n * - Same variant and size system as Button for consistency\n * - Runtime validation for accessibility compliance\n *\n * @example\n * ```tsx\n * // Basic icon button with aria-label\n * <IconButton aria-label=\"Settings\">\n *   <Settings />\n * </IconButton>\n *\n * // Icon button with tooltip\n * <IconButton aria-label=\"Save\" tooltip=\"Save your progress\">\n *   <Save />\n * </IconButton>\n *\n * // Icon button with aria-labelledby\n * <IconButton aria-labelledby=\"settings-label\">\n *   <Settings />\n * </IconButton>\n * <span id=\"settings-label\">Open settings panel</span>\n *\n * // Icon button with visible text (fallback)\n * <IconButton>\n *   <Settings />\n *   Settings\n * </IconButton>\n * ```\n */\nconst IconButton = React.forwardRef(\n  (props: IconButtonProps, forwardedRef: React.ForwardedRef<IconButtonElement>) => <Button {...props} iconOnly ref={forwardedRef} />,\n) as IconButtonComponent & { displayName?: string };\n\nIconButton.displayName = 'IconButton';\n\nexport { IconButton };\nexport type { IconButtonProps };\n"],
-  "mappings": "wCAAA,UAAYA,MAAW,QAqGvB,IAAMC,EAAmB,aACvB,CAACC,EAAwBC,IAAwD,gBAACC,EAAA,CAAQ,GAAGF,EAAO,SAAQ,GAAC,IAAKC,EAAc,CAClI,EAEAF,EAAW,YAAc",
-  "names": ["React", "IconButton", "props", "forwardedRef", "Button"]
-}