@rimelight/ui 0.0.34 → 0.0.36

package/src/types/components/color-area.ts

@@ -0,0 +1,19 @@
+import type { Theme, ThemeColor } from "../theme"
+
+export interface ColorAreaProps {
+  colorSpace?: "hsl" | "rgb" | "hsb"
+  defaultValue?: string
+  disabled?: boolean
+  modelValue?: string
+  name?: string
+  required?: boolean
+  xChannel?: "hue" | "saturation" | "red" | "green" | "blue" | "alpha" | "lightness" | "brightness"
+  xName?: string
+  yChannel?: "hue" | "saturation" | "red" | "green" | "blue" | "alpha" | "lightness" | "brightness"
+  yName?: string
+  color?: ThemeColor
+  theme?: Theme
+  ui?: any
+  class?: any
+  [key: string]: unknown
+}

package/src/types/components/color-field.ts

@@ -0,0 +1,21 @@
+import type { Theme, ThemeColor } from "../theme"
+
+export interface ColorFieldProps {
+  channel?: "hue" | "saturation" | "red" | "green" | "blue" | "alpha" | "lightness" | "brightness"
+  colorSpace?: "hsl" | "rgb" | "hsb"
+  defaultValue?: string
+  disabled?: boolean
+  disableWheelChange?: boolean
+  locale?: string
+  modelValue?: string
+  name?: string
+  placeholder?: string
+  readonly?: boolean
+  required?: boolean
+  step?: number
+  color?: ThemeColor
+  theme?: Theme
+  ui?: any
+  class?: any
+  [key: string]: unknown
+}

package/src/types/components/color-slider.ts

@@ -0,0 +1,20 @@
+import type { Theme, ThemeColor } from "../theme"
+
+export interface ColorSliderProps {
+  channel: "hue" | "saturation" | "red" | "green" | "blue" | "alpha" | "lightness" | "brightness"
+  colorSpace?: "hsl" | "rgb" | "hsb"
+  defaultValue?: string
+  dir?: "ltr" | "rtl"
+  disabled?: boolean
+  inverted?: boolean
+  modelValue?: string
+  name?: string
+  orientation?: "vertical" | "horizontal"
+  required?: boolean
+  step?: number
+  color?: ThemeColor
+  theme?: Theme
+  ui?: any
+  class?: any
+  [key: string]: unknown
+}

package/src/types/components/grid.ts

@@ -0,0 +1,23 @@
+export interface GridProps {
+  /**
+   * Number of columns on desktop viewports.
+   */
+  cols?: 1 | 2 | 3 | 4 | 5 | 6
+  /**
+   * Staggered height layout for grid items.
+   */
+  stagger?: boolean
+  /**
+   * Grid gap size.
+   */
+  gap?: "none" | "xs" | "sm" | "md" | "lg" | "xl"
+  /**
+   * Slot-specific CSS class overrides.
+   */
+  ui?: any
+  /**
+   * Additional CSS classes to apply to the root element.
+   */
+  class?: any
+  [key: string]: unknown
+}

package/src/types/components/input.ts

@@ -41,6 +41,10 @@ export interface InputProps {
    * Trailing icon name.
    */
   trailingIcon?: string
+  /**
+   * Variant style.
+   */
+  variant?: "default" | "ghost"
   /**
    * Size scale.
    */

package/src/types/components/layout-grid.ts

@@ -0,0 +1,145 @@
+export interface LayoutGridProps {
+  /**
+   * Number of columns on base/xs viewports (<640px by default).
+   *
+   * @default 4
+   */
+  cols?: number
+  /**
+   * Number of columns on sm viewports (>=640px by default).
+   *
+   * @default 4
+   */
+  smCols?: number
+  /**
+   * Number of columns on md viewports (>=768px by default).
+   *
+   * @default 8
+   */
+  mdCols?: number
+  /**
+   * Number of columns on lg viewports (>=1024px by default).
+   *
+   * @default 12
+   */
+  lgCols?: number
+  /**
+   * Number of columns on xl viewports (>=1280px by default).
+   *
+   * @default 12
+   */
+  xlCols?: number
+  /**
+   * Breakpoint width in pixels for sm breakpoint.
+   *
+   * @default 640
+   */
+  smBreakpoint?: number
+  /**
+   * Breakpoint width in pixels for md breakpoint.
+   *
+   * @default 768
+   */
+  mdBreakpoint?: number
+  /**
+   * Breakpoint width in pixels for lg breakpoint.
+   *
+   * @default 1024
+   */
+  lgBreakpoint?: number
+  /**
+   * Breakpoint width in pixels for xl breakpoint.
+   *
+   * @default 1280
+   */
+  xlBreakpoint?: number
+  /**
+   * Spacing between columns in rem. Can be a single number or array [base, sm, md, lg, xl].
+   *
+   * @default 1
+   */
+  gutter?: number | number[]
+  /**
+   * Spacing on outer margins of the grid in rem. Can be a single number or array [base, sm, md, lg,
+   * xl].
+   *
+   * @default 1
+   */
+  margin?: number | number[]
+  /**
+   * Color value (CSS color string) for the grid.
+   *
+   * @default "#ff0000"
+   */
+  gridColor?: string
+  /**
+   * Opacity for filled column backgrounds.
+   *
+   * @default 0.1
+   */
+  gridOpacity?: number
+  /**
+   * Maximum width of the grid container (CSS max-width string).
+   *
+   * @default "100vw"
+   */
+  maxWidth?: string
+  /**
+   * Whether to display colored backgrounds in columns.
+   *
+   * @default false
+   */
+  showBackground?: boolean
+  /**
+   * Whether to overlay a secondary full-width viewport grid.
+   *
+   * @default true
+   */
+  showFullWidth?: boolean
+  /**
+   * Color value (CSS color string) for the full-width grid overlay.
+   *
+   * @default "#3b82f6"
+   */
+  fullWidthGridColor?: string
+  /**
+   * Opacity for filled full-width column backgrounds.
+   *
+   * @default 0.05
+   */
+  fullWidthGridOpacity?: number
+  /**
+   * Whether to display colored backgrounds in full-width columns.
+   *
+   * @default false
+   */
+  showFullWidthBackground?: boolean
+  /**
+   * Z-index of the grid overlay.
+   *
+   * @default 1000
+   */
+  zIndex?: number
+  /**
+   * Shortcut key combination to toggle grid visibility, using underscore formatting (e.g.
+   * meta_shift_g).
+   *
+   * @default "meta_shift_g"
+   */
+  shortcut?: string
+  /**
+   * Whether the grid is restricted only to development mode (import.meta.env.DEV).
+   *
+   * @default true
+   */
+  devOnly?: boolean
+  /**
+   * UI class overrides for components elements slots.
+   */
+  ui?: any
+  /**
+   * CSS class to apply to the root wrapper.
+   */
+  class?: any
+  [key: string]: unknown
+}

package/src/types/components/link-group.ts

@@ -34,9 +34,11 @@ export interface LinkGroupProps {
    */
   ui?: any
   /**
-   * Force a theme mode for the link group (flat, light, dark).
+   * Force a color-scheme context on the link group. `"light"` or `"dark"` sets `color-scheme` on
+   * the root element, causing all `light-dark()` color variables to resolve to the correct scheme
+   * regardless of the global page mode.
    */
-  theme?: "flat" | "light" | "dark"
+  theme?: "light" | "dark"
   /**
    * Additional CSS classes to apply to the root element.
    */

package/src/types/components/link.ts

@@ -15,6 +15,21 @@ export interface LinkProps {
   activeClass?: string
   variant?: "solid" | "outline" | "soft" | "subtle" | "ghost" | "link"
   color?: ThemeColor
+  /**
+   * Styles the link visually as a button
+   *
+   * @default false
+   */
+  isButton?: boolean
+  /**
+   * Screen reader accessibility label. Will automatically append " (opens in a new tab)" for
+   * external links if not customized
+   */
+  ariaLabel?: string
+  /**
+   * Custom external link icon name
+   */
+  externalIcon?: string
   /**
    * Slot-specific CSS class overrides.
    */

package/src/types/components/logo.ts

@@ -8,10 +8,10 @@ export interface LogoProps {
    */
   mode?: "color" | "white" | "black"
   /**
-   * Theme override for color mode detection. Use "flat" to pin to the configured flat variant and
-   * skip auto-detection.
+   * Theme override — pins the logo rendering to `"light"` or `"dark"` color-scheme context, causing
+   * `light-dark()` variables to resolve to the correct scheme regardless of the global page mode.
    */
-  theme?: "flat" | "light" | "dark"
+  theme?: "light" | "dark"
   /**
    * The destination URL when the logo is clicked.
    */

package/src/types/components/post.ts

@@ -23,6 +23,18 @@ export interface PostProps {
    * The variant of the post.
    */
   variant?: "soft" | "ghost"
+  /**
+   * The orientation layout of the post.
+   */
+  orientation?: "vertical" | "horizontal"
+  /**
+   * Badge label displayed on the post.
+   */
+  badge?: string
+  /**
+   * Badge color scheme.
+   */
+  badgeColor?: string
   /**
    * Slot-specific CSS class overrides.
    */

package/src/types/components/search.ts

@@ -0,0 +1,29 @@
+export interface SearchProps {
+  /**
+   * API endpoint to query results from.
+   */
+  endpoint?: string
+  /**
+   * Search input placeholder.
+   */
+  placeholder?: string
+  /**
+   * Custom labels and localization text.
+   */
+  messages?: {
+    searchButtonLabel?: string
+    searchPlaceholder?: string
+    noResultsLabel?: string
+    footerCloseHint?: string
+    footerBackendHint?: string
+  }
+  /**
+   * Slot-specific CSS class overrides.
+   */
+  ui?: any
+  /**
+   * Additional CSS classes to apply to the root element.
+   */
+  class?: any
+  [key: string]: unknown
+}

package/src/types/components/sidebar.ts

@@ -15,18 +15,13 @@ export interface BadgeConfig {
 }
 
 export interface SidebarItem {
-  label?: string
+  label: string
   href?: string
   icon?: string
   badge?: string | BadgeConfig
   active?: boolean
   children?: SidebarItem[]
   items?: SidebarItem[]
-  order?: number
-  autogenerate?: {
-    directory: string
-    collapsed?: boolean
-  }
   collapsed?: boolean
 }
 
@@ -49,6 +44,7 @@ export interface EditLinkConfig {
 }
 
 export interface DocsConfig {
+  basePath?: string
   sidebar:
     | (SidebarItem | SidebarScope)[]
     | {

package/src/types/components/{megamenu.ts → steps.ts}

@@ -1,4 +1,10 @@
-export interface MegamenuProps {
+export interface StepsProps {
+  /**
+   * Controls the size of the step indicators and spacing.
+   *
+   * @default "md"
+   */
+  size?: "sm" | "md" | "lg"
   /**
    * Slot-specific CSS class overrides.
    */

package/src/types/components/table-of-contents.ts

@@ -1,4 +1,26 @@
+export interface TableOfContentsHeading {
+  depth: number
+  slug: string
+  text: string
+}
+
+export interface TableOfContentsConfig {
+  minHeadingLevel?: number
+  maxHeadingLevel?: number
+}
+
 export interface TableOfContentsProps {
+  headings: TableOfContentsHeading[]
+  /**
+   * False = hide entirely, object = heading level bounds
+   */
+  tableOfContents?: false | TableOfContentsConfig
+  /**
+   * CSS selector for the container element whose headings should be tracked.
+   *
+   * @default ".markdown-content"
+   */
+  containerSelector?: string
   /**
    * The component the root element should render as.
    *

package/src/types/components/toast.ts

@@ -32,5 +32,9 @@ export interface ToastProps {
    * Additional CSS classes to apply to the root element.
    */
   class?: any
+  /**
+   * Whether the toast can be dismissed by user or timeout.
+   */
+  dismissable?: boolean
   [key: string]: unknown
 }

package/src/types/docs.ts

@@ -0,0 +1,40 @@
+export interface PropMeta {
+  name: string
+  type: string
+  default?: string
+  required: boolean
+  description: string
+}
+
+export interface SlotMeta {
+  name: string
+  bindings: Record<string, string>
+  description: string
+}
+
+export interface EmitMeta {
+  name: string
+  type: string
+  description: string
+}
+
+export interface ThemeMeta {
+  slots: string[]
+  base: Record<string, string | string[]>
+  variants: Record<string, Record<string, Record<string, string | string[]>>>
+  compoundVariants: Record<string, unknown>[]
+  defaultVariants: Record<string, unknown>
+}
+
+export interface ComponentMeta {
+  name: string
+  astroComponent: string | null
+  vueComponent: string | null
+  frameworks: ("astro" | "vue")[]
+  props: PropMeta[]
+  slots: SlotMeta[]
+  emits: EmitMeta[]
+  theme: ThemeMeta | null
+}
+
+export type ComponentMetaMap = Record<string, ComponentMeta>

package/src/types/index.ts

@@ -1,3 +1,153 @@
-export * from "./components"
 export * from "./componentVariant"
 export * from "./theme"
+export * from "./docs"
+
+export type { ThreeDHoverProps } from "./components/3d-hover"
+export type { AccordionProps } from "./components/accordion"
+export type { CalloutProps } from "./components/callout"
+export type { AppProps } from "./components/app"
+export type { AspectRatioProps } from "./components/aspect-ratio"
+export type { AudioProps } from "./components/audio"
+export type { AvatarGroupProps } from "./components/avatar-group"
+export type { AvatarProps } from "./components/avatar"
+export type { BadgeProps } from "./components/badge"
+export type { BannerProps } from "./components/banner"
+export type { BreadcrumbProps } from "./components/breadcrumb"
+export type { BrowserMockupProps } from "./components/browser-mockup"
+export type { ButtonProps } from "./components/button"
+export type { CalendarProps } from "./components/calendar"
+export type { CardProps } from "./components/card"
+export type { CarouselProps } from "./components/carousel"
+export type { ChangelogProps } from "./components/changelog"
+export type { ChartProps, ChartDataPoint } from "./components/chart"
+export type { ChatMessageProps } from "./components/chat-message"
+export type { ChatMessagesProps } from "./components/chat-messages"
+export type { ChatPaletteProps } from "./components/chat-palette"
+export type { ChatPromptProps } from "./components/chat-prompt"
+export type { ChatPromptSubmitProps } from "./components/chat-prompt-submit"
+export type { ChatReasoningProps } from "./components/chat-reasoning"
+export type { ChatShimmerProps } from "./components/chat-shimmer"
+export type { ChatToolProps } from "./components/chat-tool"
+export type { ChatProps } from "./components/chat"
+export type { CheckboxProps } from "./components/checkbox"
+export type { ChipProps } from "./components/chip"
+export type { CollapsibleProps } from "./components/collapsible"
+export type { ColorPickerProps } from "./components/color-picker"
+export type { CommandPaletteProps } from "./components/command-palette"
+export type { CompareProps } from "./components/compare"
+export type { ConfirmProps } from "./components/confirm"
+export type { ContainerProps } from "./components/container"
+export type { ContextMenuProps } from "./components/context-menu"
+export type { DashboardGroupProps } from "./components/dashboard-group"
+export type { DashboardNavbarProps } from "./components/dashboard-navbar"
+export type { DashboardPanelProps } from "./components/dashboard-panel"
+export type { DashboardResizeHandleProps } from "./components/dashboard-resize-handle"
+export type { DashboardSearchButtonProps } from "./components/dashboard-search-button"
+export type { DashboardSearchProps } from "./components/dashboard-search"
+export type { SearchProps } from "./components/search"
+export type { DashboardSidebarCollapseProps } from "./components/dashboard-sidebar-collapse"
+export type { DashboardSidebarToggleProps } from "./components/dashboard-sidebar-toggle"
+export type { DashboardSidebarProps } from "./components/dashboard-sidebar"
+export type { DashboardToolbarProps } from "./components/dashboard-toolbar"
+export type { DockProps } from "./components/dock"
+export type { DrawerProps } from "./components/drawer"
+export type { DropdownMenuProps } from "./components/dropdown-menu"
+export type { EditorProps } from "./components/editor"
+export type { EmptyProps } from "./components/empty"
+export type { ErrorProps } from "./components/error"
+export type { FieldGroupProps } from "./components/field-group"
+export type { FieldsetProps } from "./components/fieldset"
+export type { FileUploadProps } from "./components/file-upload"
+export type { FloatingActionProps } from "./components/floating-action"
+export type { FooterProps } from "./components/footer"
+export type { FormFieldProps } from "./components/form-field"
+export type { FormProps } from "./components/form"
+export type { GalleryProps } from "./components/gallery"
+export type { GridProps } from "./components/grid"
+export type { LayoutGridProps } from "./components/layout-grid"
+export type { HeaderProps } from "./components/header"
+export type { HoverCardProps } from "./components/hover-card"
+export type { IconProps } from "./components/icon"
+export type { ImageProps } from "./components/image"
+export type { InputDateProps } from "./components/input-date"
+export type { InputMenuProps } from "./components/input-menu"
+export type { InputNumberProps } from "./components/input-number"
+export type { InputProps } from "./components/input"
+export type { InputTagsProps } from "./components/input-tags"
+export type { InputTimeProps } from "./components/input-time"
+export type { KbdProps } from "./components/kbd"
+export type { KnobProps } from "./components/knob"
+export type { LabelProps } from "./components/label"
+export type { LinkGroupProps } from "./components/link-group"
+export type { LinkProps } from "./components/link"
+export type { ListboxProps } from "./components/listbox"
+export type { LocaleSelectorProps } from "./components/locale-selector"
+export type { LogoProps } from "./components/logo"
+export type { MainProps } from "./components/main"
+export type { MarqueeProps } from "./components/marquee"
+export type { MeterProps } from "./components/meter"
+export type { ModalProps } from "./components/modal"
+export type { NavigationMenuItem, NavigationMenuProps } from "./components/navigation-menu"
+export type { PageAsideProps } from "./components/page-aside"
+export type { PageBodyProps } from "./components/page-body"
+export type { PageHeaderProps } from "./components/page-header"
+export type { PageSectionProps } from "./components/page-section"
+export type { PageProps } from "./components/page"
+export type { PaginationProps } from "./components/pagination"
+export type { PasswordProps } from "./components/password"
+export type { PhoneMockupProps } from "./components/phone-mockup"
+export type { PinInputProps } from "./components/pin-input"
+export type { PlaceholderProps } from "./components/placeholder"
+export type { PopoverProps } from "./components/popover"
+export type { PostProps } from "./components/post"
+export type { PricingPlanProps } from "./components/pricing-plan"
+export type { PricingTableProps } from "./components/pricing-table"
+export type { ProgressProps } from "./components/progress"
+export type { ProseProps } from "./components/prose"
+export type { QrCodeProps } from "./components/qr-code"
+export type { RadioGroupProps } from "./components/radio-group"
+export type { RatingProps } from "./components/rating"
+export type { ScrollAreaProps } from "./components/scroll-area"
+export type { ScrollToTopProps } from "./components/scroll-to-top"
+export type { SelectProps } from "./components/select"
+export type { SeparatorProps } from "./components/separator"
+export type {
+  SidebarProps,
+  DocsConfig,
+  BadgeConfig,
+  SidebarItem,
+  SidebarScope
+} from "./components/sidebar"
+export type { SkeletonProps } from "./components/skeleton"
+export type { SlideoverProps } from "./components/slideover"
+export type { SliderProps } from "./components/slider"
+export type { SpeedDialProps } from "./components/speed-dial"
+export type { SpinnerProps } from "./components/spinner"
+export type { SplitterProps } from "./components/splitter"
+export type { SpoilerProps } from "./components/spoiler"
+export type { StepperProps } from "./components/stepper"
+export type { StepsProps } from "./components/steps"
+export type { StickySurfaceProps } from "./components/sticky-surface"
+export type { SwitchProps } from "./components/switch"
+export type {
+  TableOfContentsProps,
+  TableOfContentsHeading,
+  TableOfContentsConfig
+} from "./components/table-of-contents"
+export type { TableProps } from "./components/table"
+export type { TabsProps } from "./components/tabs"
+export type { TextareaProps } from "./components/textarea"
+export type { ThemeSelectorProps } from "./components/theme-selector"
+export type { TimelineProps } from "./components/timeline"
+export type { ToastProps } from "./components/toast"
+export type { TooltipProps } from "./components/tooltip"
+export type { TourProps } from "./components/tour"
+export type { TreeProps } from "./components/tree"
+export type { UserProps } from "./components/user"
+export type { VideoProps } from "./components/video"
+export type { WatermarkProps } from "./components/watermark"
+export type { WindowMockupProps } from "./components/window-mockup"
+
+export type { ColorAreaProps } from "./components/color-area"
+export type { ColorFieldProps } from "./components/color-field"
+export type { ColorSliderProps } from "./components/color-slider"

package/src/types/theme.ts

@@ -1,11 +1,11 @@
-import { defaultColors } from "../presets/defaults"
+import type { defaultColors } from "../presets/defaults"
 
-export type Theme = "flat" | "light" | "dark"
+export type Theme = "light" | "dark"
 
 export interface CustomColors {}
 
-export type ThemeColor =
-  | typeof defaultColors[number]
-  | "neutral"
-  | keyof CustomColors
+type AddCustomColors<T> = [keyof T] extends [never]
+  ? (typeof defaultColors)[number]
+  : (typeof defaultColors)[number] | keyof T
 
+export type ThemeColor = AddCustomColors<CustomColors> | "neutral"