@rimelight/ui 0.0.33 → 0.0.34

package/src/types/components/timeline.ts

@@ -1,11 +1,11 @@
-export interface TimelineProps {
-  /**
-   * Slot-specific CSS class overrides.
-   */
-  ui?: any
-  /**
-   * Additional CSS classes to apply to the root element.
-   */
-  class?: any
-  [key: string]: unknown
-}
+export interface TimelineProps {
+  /**
+   * 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/toast.ts

@@ -1,3 +1,4 @@
+import type { ThemeColor } from "../theme"
 export interface ToastProps {
   /**
    * Main toast title.
@@ -22,7 +23,7 @@ export interface ToastProps {
   /**
    * Color theme.
    */
-  color?: "primary" | "secondary" | "success" | "warning" | "error" | "info"
+  color?: ThemeColor
   /**
    * Slot-specific CSS class overrides.
    */

package/src/types/components/tooltip.ts

@@ -1,23 +1,23 @@
-export interface TooltipProps {
-  /**
-   * The text content to display inside the tooltip.
-   */
-  content?: string
-  /**
-   * Controlled open state.
-   */
-  open?: boolean
-  /**
-   * Placement of the tooltip relative to the trigger.
-   */
-  placement?: "top" | "bottom" | "left" | "right"
-  /**
-   * Slot-specific CSS class overrides.
-   */
-  ui?: any
-  /**
-   * Additional CSS classes to apply to the root element.
-   */
-  class?: any
-  [key: string]: unknown
-}
+export interface TooltipProps {
+  /**
+   * The text content to display inside the tooltip.
+   */
+  content?: string
+  /**
+   * Controlled open state.
+   */
+  open?: boolean
+  /**
+   * Placement of the tooltip relative to the trigger.
+   */
+  placement?: "top" | "bottom" | "left" | "right"
+  /**
+   * 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/tour.ts

@@ -1,11 +1,11 @@
-export interface TourProps {
-  /**
-   * Slot-specific CSS class overrides.
-   */
-  ui?: any
-  /**
-   * Additional CSS classes to apply to the root element.
-   */
-  class?: any
-  [key: string]: unknown
-}
+export interface TourProps {
+  /**
+   * 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/tree.ts

@@ -1,11 +1,11 @@
-export interface TreeProps {
-  /**
-   * Slot-specific CSS class overrides.
-   */
-  ui?: any
-  /**
-   * Additional CSS classes to apply to the root element.
-   */
-  class?: any
-  [key: string]: unknown
-}
+export interface TreeProps {
+  /**
+   * 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/user.ts

@@ -1,11 +1,11 @@
-export interface UserProps {
-  /**
-   * Slot-specific CSS class overrides.
-   */
-  ui?: any
-  /**
-   * Additional CSS classes to apply to the root element.
-   */
-  class?: any
-  [key: string]: unknown
-}
+export interface UserProps {
+  /**
+   * 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/watermark.ts

@@ -1,11 +1,11 @@
-export interface WatermarkProps {
-  /**
-   * Slot-specific CSS class overrides.
-   */
-  ui?: any
-  /**
-   * Additional CSS classes to apply to the root element.
-   */
-  class?: any
-  [key: string]: unknown
-}
+export interface WatermarkProps {
+  /**
+   * 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/window-mockup.ts

@@ -1,11 +1,11 @@
-export interface WindowMockupProps {
-  /**
-   * Slot-specific CSS class overrides.
-   */
-  ui?: any
-  /**
-   * Additional CSS classes to apply to the root element.
-   */
-  class?: any
-  [key: string]: unknown
-}
+export interface WindowMockupProps {
+  /**
+   * Slot-specific CSS class overrides.
+   */
+  ui?: any
+  /**
+   * Additional CSS classes to apply to the root element.
+   */
+  class?: any
+  [key: string]: unknown
+}

package/src/types/theme.ts

@@ -1 +1,11 @@
+import { defaultColors } from "../presets/defaults"
+
 export type Theme = "flat" | "light" | "dark"
+
+export interface CustomColors {}
+
+export type ThemeColor =
+  | typeof defaultColors[number]
+  | "neutral"
+  | keyof CustomColors
+

package/src/utils/docs.ts

@@ -1,189 +1,215 @@
-import type { DocsConfig, BadgeConfig } from "../types"
-
-export function defineDocsConfig(config: DocsConfig): DocsConfig {
-  return config
-}
-
-/** Strip a leading numeric sort prefix from a filename id, e.g. "01.getting-started" → "getting-started" */
-function stripNumericPrefix(id: string): string {
-  return id.replace(/^(\d+\.)+/, "")
-}
-
-/** Extract a numeric sort key from a doc id for numeric-prefix sorting */
-function numericPrefixOrder(id: string): number {
-  const segment = id.split("/").pop() ?? id
-  const m = segment.match(/^(\d+)\./)
-  return m ? parseInt(m[1], 10) : Infinity
-}
-
-export interface ResolvedSidebarItem {
-  label: string
-  href?: string
-  icon?: string
-  badge?: string | BadgeConfig
-  active?: boolean
-  children?: ResolvedSidebarItem[]
-  collapsed?: boolean
-}
-
-export interface ResolvedScope {
-  id: string
-  label: string
-  href: string
-  icon?: string
-  active?: boolean
-}
-
-export async function getDocsSidebar(
-  config: DocsConfig,
-  locale: string,
-  currentPath: string,
-  getCollection: (name: string) => Promise<any[]>
-): Promise<{
-  items: ResolvedSidebarItem[]
-  scopes: ResolvedScope[]
-  activeScope?: ResolvedScope
-}> {
-  const docs = await getCollection("docs")
-  const normPath = currentPath.replace(/\/$/, "").toLowerCase()
-  const docsBase = `/${locale}/docs`
-
-  const scopes: ResolvedScope[] = config.sidebar
-    .filter((item): item is import("../types").SidebarScope => "id" in item)
-    .map(scope => ({
-      id: scope.id,
-      label: scope.label,
-      href: scope.href.replace("{locale}", locale),
-      icon: scope.icon
-    }))
-
-  function isDocInItems(items: import("../types").SidebarItem[], docId: string | undefined, href: string): boolean {
-    for (const item of items) {
-      if (item.href && item.href.toLowerCase().replace(/\/$/, "") === href) return true
-      if (item.autogenerate && docId) {
-        const dir = item.autogenerate.directory.replace(/\/$/, "")
-        if (dir === "") {
-          if (!docId.includes("/")) return true
-        } else if (docId.startsWith(dir + "/") || docId === dir) {
-          return true
-        }
-      }
-      if (item.children && isDocInItems(item.children, docId, href)) return true
-    }
-    return false
-  }
-
-  // Find active scope — most-specific prefix match, fallback to scanning scope items
-  let activeScope = scopes.find(s => normPath === s.href.replace(/\/$/, "").toLowerCase())
-  if (!activeScope) {
-    const currentDoc = docs.find(d => `${docsBase}/${d.id}`.toLowerCase() === normPath)
-    const scopeMatch = config.sidebar.find(s => {
-      if (!("id" in s)) return false
-      return isDocInItems(s.items || [], currentDoc?.id, normPath)
-    }) as import("../types").SidebarScope | undefined
-
-    if (scopeMatch) {
-      activeScope = scopes.find(s => s.id === scopeMatch.id)
-    }
-  }
-  if (!activeScope) {
-    activeScope = [...scopes]
-      .sort((a, b) => b.href.length - a.href.length)
-      .find(s => normPath.startsWith(s.href.toLowerCase()))
-  }
-  if (activeScope) activeScope.active = true
-
-  const sidebarConfig = config.sidebar.find(item =>
-    "id" in item && activeScope && item.id === activeScope.id
-  ) as import("../types").SidebarScope | undefined
-
-  const items = sidebarConfig?.items || []
-
-  async function resolveItem(item: import("../types").SidebarItem): Promise<ResolvedSidebarItem[]> {
-    if (item.autogenerate) {
-      const dir = item.autogenerate.directory
-      // Match docs whose id starts with the directory
-      const prefix = dir.replace(/\/$/, "")
-      const filteredDocs = docs.filter(d => {
-        if (d.data.sidebar?.hidden === true) return false
-        if (prefix === "") return !d.id.includes("/")
-        return d.id.startsWith(prefix + "/") || d.id === prefix
-      })
-
-      filteredDocs.sort((a, b) => {
-        // 1. Frontmatter `order` takes priority
-        const aOrder = a.data.sidebar?.order ?? a.data.order ?? numericPrefixOrder(a.id)
-        const bOrder = b.data.sidebar?.order ?? b.data.order ?? numericPrefixOrder(b.id)
-        if (aOrder !== bOrder) return aOrder - bOrder
-        // 2. Fall back to alphabetical by stripped label
-        const aLabel = a.data.sidebar?.label ?? a.data.title
-        const bLabel = b.data.sidebar?.label ?? b.data.title
-        return stripNumericPrefix(aLabel).localeCompare(stripNumericPrefix(bLabel))
-      })
-
-      return filteredDocs.map(doc => {
-        const href = `${docsBase}/${doc.id}/`
-        const badge = doc.data.sidebar?.badge ?? doc.data.badge as string | BadgeConfig | undefined
-        return {
-          label: doc.data.sidebar?.label ?? doc.data.title,
-          href,
-          badge,
-          active: normPath === href.replace(/\/$/, "").toLowerCase()
-        }
-      })
-    }
-
-    const resolved: ResolvedSidebarItem = {
-      label: item.label,
-      href: item.href ? item.href.replace("{locale}", locale) : undefined,
-      icon: item.icon,
-      badge: item.badge,
-      collapsed: item.collapsed
-    }
-
-    if (resolved.href) {
-      resolved.active = normPath === resolved.href.replace(/\/$/, "").toLowerCase()
-    }
-
-    if (item.children) {
-      const children: ResolvedSidebarItem[] = []
-      for (const child of item.children) {
-        children.push(...(await resolveItem(child)))
-      }
-      resolved.children = children
-      if (!resolved.active) {
-        resolved.active = children.some(c => c.active)
-      }
-    }
-
-    return [resolved]
-  }
-
-  const resolvedItems: ResolvedSidebarItem[] = []
-  for (const item of items) {
-    resolvedItems.push(...(await resolveItem(item)))
-  }
-
-  return { items: resolvedItems, scopes, activeScope }
-}
-
-export function getSurroundItems(sidebar: ResolvedSidebarItem[], currentPath: string) {
-  const flatItems: { label: string, href: string }[] = []
-
-  function flatten(items: ResolvedSidebarItem[]) {
-    for (const item of items) {
-      if (item.href) flatItems.push({ label: item.label, href: item.href })
-      if (item.children) flatten(item.children)
-    }
-  }
-
-  flatten(sidebar)
-
-  const normPath = currentPath.replace(/\/$/, "").toLowerCase()
-  const currentIndex = flatItems.findIndex(item => item.href.replace(/\/$/, "").toLowerCase() === normPath)
-
-  return {
-    prev: currentIndex > 0 ? flatItems[currentIndex - 1] : null,
-    next: currentIndex >= 0 && currentIndex < flatItems.length - 1 ? flatItems[currentIndex + 1] : null
-  }
-}
+import type { DocsConfig, BadgeConfig } from "../types"
+
+export function defineDocsConfig(config: DocsConfig): DocsConfig {
+  return config
+}
+
+/**
+ * Strip a leading numeric sort prefix from a filename id, e.g. "01.getting-started" →
+ * "getting-started"
+ */
+function stripNumericPrefix(id: string): string {
+  return id.replace(/^(\d+\.)+/, "")
+}
+
+/**
+ * Extract a numeric sort key from a doc id for numeric-prefix sorting
+ */
+function numericPrefixOrder(id: string): number {
+  const segment = id.split("/").pop() ?? id
+  const m = segment.match(/^(\d+)\./)
+  return m ? parseInt(m[1], 10) : Infinity
+}
+
+export interface ResolvedSidebarItem {
+  label: string
+  href?: string
+  icon?: string
+  badge?: string | BadgeConfig
+  active?: boolean
+  children?: ResolvedSidebarItem[]
+  collapsed?: boolean
+}
+
+export interface ResolvedScope {
+  id: string
+  label: string
+  href: string
+  icon?: string
+  active?: boolean
+}
+
+export async function getDocsSidebar(
+  config: DocsConfig,
+  locale: string,
+  currentPath: string,
+  getCollection: (name: string) => Promise<any[]>
+): Promise<{
+  items: ResolvedSidebarItem[]
+  scopes: ResolvedScope[]
+  activeScope?: ResolvedScope
+}> {
+  const docs = await getCollection("docs")
+  const normPath = currentPath.replace(/\/$/, "").toLowerCase()
+  const docsBase = `/${locale}/docs`
+
+  const sidebarScopes: import("../types").SidebarScope[] = Array.isArray(config.sidebar)
+    ? config.sidebar.filter(
+        (item): item is import("../types").SidebarScope => "id" in item || "scopes" in item
+      )
+    : (config.sidebar as any)?.scopes || []
+
+  const scopes: ResolvedScope[] = sidebarScopes.map((scope) => {
+    const id = scope.id || scope.label
+    let href = scope.href || ""
+    if (!href && scope.items && scope.items.length > 0) {
+      href = scope.items[0].href || ""
+    }
+    return {
+      id,
+      label: scope.label,
+      href: href.replace("{locale}", locale),
+      icon: scope.icon
+    }
+  })
+
+  function isDocInItems(
+    items: import("../types").SidebarItem[],
+    docId: string | undefined,
+    href: string
+  ): boolean {
+    for (const item of items) {
+      if (item.href && item.href.toLowerCase().replace(/\/$/, "") === href) return true
+      if (item.autogenerate && docId) {
+        const dir = item.autogenerate.directory.replace(/\/$/, "")
+        if (dir === "") {
+          if (!docId.includes("/")) return true
+        } else if (docId.startsWith(dir + "/") || docId === dir) {
+          return true
+        }
+      }
+      const childItems = item.children || item.items
+      if (childItems && isDocInItems(childItems, docId, href)) return true
+    }
+    return false
+  }
+
+  // Find active scope — most-specific prefix match, fallback to scanning scope items
+  let activeScope = scopes.find((s) => normPath === s.href.replace(/\/$/, "").toLowerCase())
+  if (!activeScope) {
+    const currentDoc = docs.find((d) => `${docsBase}/${d.id}`.toLowerCase() === normPath)
+    const scopeMatch = sidebarScopes.find((s) => {
+      return isDocInItems(s.items || [], currentDoc?.id, normPath)
+    })
+
+    if (scopeMatch) {
+      const matchId = scopeMatch.id || scopeMatch.label
+      activeScope = scopes.find((s) => s.id === matchId)
+    }
+  }
+  if (!activeScope) {
+    activeScope = [...scopes]
+      .toSorted((a, b) => b.href.length - a.href.length)
+      .find((s) => normPath.startsWith(s.href.toLowerCase()))
+  }
+  if (activeScope) activeScope.active = true
+
+  const sidebarConfig = sidebarScopes.find(
+    (item) => activeScope && (item.id === activeScope.id || item.label === activeScope.id)
+  )
+
+  const items = sidebarConfig?.items || []
+
+  async function resolveItem(item: import("../types").SidebarItem): Promise<ResolvedSidebarItem[]> {
+    if (item.autogenerate) {
+      const dir = item.autogenerate.directory
+      // Match docs whose id starts with the directory
+      const prefix = dir.replace(/\/$/, "")
+      const filteredDocs = docs.filter((d) => {
+        if (d.data.sidebar?.hidden === true) return false
+        if (prefix === "") return !d.id.includes("/")
+        return d.id.startsWith(prefix + "/") || d.id === prefix
+      })
+
+      filteredDocs.sort((a, b) => {
+        // 1. Frontmatter `order` takes priority
+        const aOrder = a.data.sidebar?.order ?? a.data.order ?? numericPrefixOrder(a.id)
+        const bOrder = b.data.sidebar?.order ?? b.data.order ?? numericPrefixOrder(b.id)
+        if (aOrder !== bOrder) return aOrder - bOrder
+        // 2. Fall back to alphabetical by stripped label
+        const aLabel = a.data.sidebar?.label ?? a.data.title
+        const bLabel = b.data.sidebar?.label ?? b.data.title
+        return stripNumericPrefix(aLabel).localeCompare(stripNumericPrefix(bLabel))
+      })
+
+      return filteredDocs.map((doc) => {
+        const href = `${docsBase}/${doc.id}/`
+        const badge =
+          doc.data.sidebar?.badge ?? (doc.data.badge as string | BadgeConfig | undefined)
+        return {
+          label: doc.data.sidebar?.label ?? doc.data.title,
+          href,
+          badge,
+          active: normPath === href.replace(/\/$/, "").toLowerCase()
+        }
+      })
+    }
+
+    const resolved: ResolvedSidebarItem = {
+      label: item.label,
+      href: item.href ? item.href.replace("{locale}", locale) : undefined,
+      icon: item.icon,
+      badge: item.badge,
+      collapsed: item.collapsed
+    }
+
+    if (resolved.href) {
+      resolved.active = normPath === resolved.href.replace(/\/$/, "").toLowerCase()
+    }
+
+    const childItems = item.children || item.items
+    if (childItems) {
+      const children: ResolvedSidebarItem[] = []
+      for (const child of childItems) {
+        children.push(...(await resolveItem(child)))
+      }
+      resolved.children = children
+      if (!resolved.active) {
+        resolved.active = children.some((c) => c.active)
+      }
+    }
+
+    return [resolved]
+  }
+
+  const resolvedItems: ResolvedSidebarItem[] = []
+  for (const item of items) {
+    resolvedItems.push(...(await resolveItem(item)))
+  }
+
+  return { items: resolvedItems, scopes, activeScope }
+}
+
+export function getSurroundItems(sidebar: ResolvedSidebarItem[], currentPath: string) {
+  const flatItems: { label: string; href: string }[] = []
+
+  function flatten(items: ResolvedSidebarItem[]) {
+    for (const item of items) {
+      if (item.href) flatItems.push({ label: item.label, href: item.href })
+      if (item.children) flatten(item.children)
+    }
+  }
+
+  flatten(sidebar)
+
+  const normPath = currentPath.replace(/\/$/, "").toLowerCase()
+  const currentIndex = flatItems.findIndex(
+    (item) => item.href.replace(/\/$/, "").toLowerCase() === normPath
+  )
+
+  return {
+    prev: currentIndex > 0 ? flatItems[currentIndex - 1] : null,
+    next:
+      currentIndex >= 0 && currentIndex < flatItems.length - 1 ? flatItems[currentIndex + 1] : null
+  }
+}