@rimelight/ui 0.0.41 → 0.0.43

package/src/shortcuts.ts

@@ -0,0 +1,172 @@
+import { atom } from "nanostores"
+
+export type Handler = (e: KeyboardEvent) => void
+export interface ShortcutConfig {
+  handler: Handler
+  usingInput?: boolean | string | undefined
+  label?: string | undefined
+  description?: string | undefined
+  category?: string | undefined
+  order?: number | undefined
+}
+export type ShortcutsConfig = Record<string, ShortcutConfig | Handler | false | null | undefined>
+export interface ShortcutsOptions {
+  chainDelay?: number | undefined
+}
+export interface RegisteredShortcut {
+  id: string
+  keys: string[]
+  label?: string | undefined
+  description?: string | undefined
+  category?: string | undefined
+  order?: number | undefined
+}
+
+interface Shortcut {
+  key: string
+  handler: Handler
+  mods: number
+  usingInput?: boolean | string | undefined
+}
+
+const isMac = typeof navigator !== "undefined" && /Mac|iP/.test(navigator.userAgent),
+  MOD_CMD = isMac ? 2 : 1,
+  SHIFTABLE = new Set([
+    "arrowleft",
+    "arrowright",
+    "arrowup",
+    "arrowdown",
+    "tab",
+    "escape",
+    "enter",
+    "backspace"
+  ]),
+  kMap = (m: string, v: any) => m.split(",").map((k) => [k, v]),
+  MODS: Record<string, number> = Object.fromEntries([
+    ...kMap("ctrl,control", 1),
+    ...kMap("cmd,command,meta", MOD_CMD),
+    ...kMap("alt,opt,option", 4),
+    ["shift", 8]
+  ]),
+  KEYS: Record<string, string> = Object.fromEntries([
+    ...kMap("ctrl,control", "Ctrl"),
+    ...kMap("cmd,command,meta", isMac ? "⌘" : "Ctrl"),
+    ...kMap("alt,opt,option", isMac ? "⌥" : "Alt"),
+    ["shift", isMac ? "⇧" : "Shift"],
+    ..."enter:↵,delete:⌦,backspace:⌫,escape:Esc,tab:⇥,space:Space,arrowup:↑,arrowdown:↓,arrowleft:←,arrowright:→"
+      .split(",")
+      .map((s) => s.split(":") as [string, string])
+  ])
+
+export const formatShortcutKeys = (k: string): string[] =>
+  k.split(/[_-]/).map((p) => KEYS[p.toLowerCase()] ?? (p ? p[0]!.toUpperCase() + p.slice(1) : ""))
+
+export const activeShortcutsStore = atom<RegisteredShortcut[]>([])
+
+const isUsingInput = (el: Element | null): boolean | string => {
+  while (el?.shadowRoot?.activeElement) el = el.shadowRoot.activeElement
+  return el && (/INPUT|TEXTAREA|SELECT/.test(el.nodeName) || (el as HTMLElement).isContentEditable)
+    ? el.getAttribute("name") || true
+    : false
+}
+
+const isEnabled = (s: Shortcut, input: boolean | string) =>
+  s.usingInput === true || (s.usingInput ? input === s.usingInput : !input)
+
+export function defineShortcuts(
+  config: ShortcutsConfig,
+  options: ShortcutsOptions = {}
+): () => void {
+  if (typeof window === "undefined") return () => {}
+
+  const standard: Shortcut[] = [],
+    chained = new Map<string, Shortcut>(),
+    reg: RegisteredShortcut[] = []
+  let maxChain = 2
+
+  for (const [k, cfg] of Object.entries(config)) {
+    if (!cfg) continue
+    const obj = typeof cfg === "object" ? cfg : null,
+      handler = obj ? obj.handler : cfg
+    if (typeof handler !== "function") continue
+
+    const chain = k.includes("-") && k !== "-" && !k.includes("_"),
+      parts = k.toLowerCase().split(chain ? "-" : "_")
+    let mods = 0
+    const nonMods = parts.filter((p) => (MODS[p] ? !(mods |= MODS[p]!) : true)),
+      base = chain ? k.toLowerCase() : nonMods.join("_"),
+      item: Shortcut = { key: base, handler, mods, usingInput: obj?.usingInput }
+
+    if (chain) {
+      maxChain = Math.max(maxChain, parts.length)
+      chained.set(base, item)
+    } else standard.push(item)
+
+    if (obj?.label || obj?.description)
+      reg.push({
+        id: `${obj.category || "system"}-${k}`,
+        keys: formatShortcutKeys(k),
+        category: obj.category || "system",
+        label: obj.label,
+        description: obj.description,
+        order: obj.order
+      })
+  }
+
+  const ids = new Set(reg.map((i) => i.id))
+  if (ids.size)
+    activeShortcutsStore.set(
+      activeShortcutsStore
+        .get()
+        .filter((i) => !ids.has(i.id))
+        .concat(reg)
+    )
+
+  const inputs: string[] = []
+  let timer: ReturnType<typeof setTimeout> | undefined
+
+  const onKeyDown = (e: KeyboardEvent) => {
+    if (!e.key) return
+    const input = isUsingInput(document.activeElement),
+      trigger = (s: Shortcut) => {
+        e.preventDefault()
+        s.handler(e)
+        inputs.length = 0
+      }
+
+    inputs.push(e.key.toLowerCase())
+    if (inputs.length > maxChain) inputs.shift()
+    clearTimeout(timer)
+
+    if (inputs.length >= 2 && chained.size)
+      for (let len = Math.min(inputs.length, maxChain); len >= 2; len--) {
+        const match = chained.get(inputs.slice(-len).join("-"))
+        if (match && isEnabled(match, input)) return trigger(match)
+      }
+
+    const eMods = +e.ctrlKey | (+e.metaKey << 1) | (+e.altKey << 2) | (+e.shiftKey << 3),
+      c = e.code.toLowerCase(),
+      k = e.key.toLowerCase()
+
+    for (const s of standard) {
+      if ((s.mods & 7) !== (eMods & 7)) continue
+      if (s.mods & 4 ? c !== `key${s.key}` && c !== `digit${s.key}` && c !== s.key : k !== s.key)
+        continue
+      if (
+        Boolean(s.mods & 8) !== e.shiftKey &&
+        (s.mods & 8 || /^[a-z]$/.test(s.key) || SHIFTABLE.has(s.key))
+      )
+        continue
+      if (isEnabled(s, input)) return trigger(s)
+    }
+
+    timer = setTimeout(() => void (inputs.length = 0), options.chainDelay ?? 800)
+  }
+
+  window.addEventListener("keydown", onKeyDown)
+  return () => {
+    window.removeEventListener("keydown", onKeyDown)
+    clearTimeout(timer)
+    if (ids.size) activeShortcutsStore.set(activeShortcutsStore.get().filter((i) => !ids.has(i.id)))
+  }
+}

package/src/types.ts

@@ -0,0 +1,57 @@
+import type { UserConfig } from "unocss"
+import type { RimelightIcons } from "./icons"
+import type { P } from "./preset"
+
+export type Theme = "light" | "dark"
+export type BuiltinThemeColor = keyof typeof P
+export type ThemeColor = BuiltinThemeColor | (string & {})
+
+export type ColorModeInput =
+  | Record<string, string>
+  | { light?: Record<string, string>; dark?: Record<string, string> }
+
+export interface PresetOptions {
+  /**
+   * Custom colors.
+   */
+  colors?: Record<string, ColorModeInput>
+  /**
+   * Global icon overrides mapping icon names to class names (e.g. `i-lucide-x`) or raw SVG strings.
+   */
+  icons?: RimelightIcons
+  /**
+   * Configure which built-in UnoCSS presets are enabled/disabled.
+   */
+  presets?: { wind?: boolean; typography?: boolean; icons?: boolean }
+}
+
+export interface UIConfig extends PresetOptions {
+  /**
+   * Whether to strip default theme classes from all components.
+   */
+  unstyled?: boolean
+  /**
+   * Configuration for keyboard shortcuts.
+   */
+  shortcuts?: { categories?: Record<string, { label: string }> }
+  /**
+   * Configuration for the Logo component variants.
+   */
+  logos?: Record<string, string | Record<string, string | undefined>>
+  /**
+   * Global component configuration overrides.
+   */
+  components?: {
+    themes?: Record<
+      string,
+      {
+        slots?: Record<string, string | ((base: string) => string) | undefined>
+        [key: string]: unknown
+      }
+    >
+  }
+  /**
+   * Custom UnoCSS configuration overrides.
+   */
+  unocss?: UserConfig
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Rimelight Entertainment
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.