@rimelight/ui 0.0.26 → 0.0.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimelight/ui",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "private": false,
   "description": "Rimelight Entertainment UI Library.",
   "keywords": [
@@ -56,6 +56,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "prepare": "vp config",
+    "knip": "knip",
+    "astro": "astro",
+    "docs:meta": "tsx scripts/extract-meta.ts"
+  },
   "dependencies": {
     "@astrojs/prism": "^4.0.1",
     "@astrojs/vue": "6.0.1",
@@ -97,9 +103,5 @@
       "optional": true
     }
   },
-  "scripts": {
-    "knip": "knip",
-    "astro": "astro",
-    "docs:meta": "tsx scripts/extract-meta.ts"
-  }
-}
+  "packageManager": "pnpm@11.1.2"
+}

package/src/components/astro/RLAButton.astro

@@ -1,104 +1,108 @@
----
-import { scv, cx } from "css-variants"
-import { useUi, resolveClasses } from "../../utils"
-import type { ComponentVariants, ComponentSlots } from "../../types"
-import buttonTheme from "../../themes/button.theme"
-
-const button = scv(buttonTheme)
-type ButtonVariants = ComponentVariants<typeof buttonTheme>
-
-export interface RLAButtonProps {
-  variant?: ButtonVariants['variant'];
-  color?: ButtonVariants['color'];
-  size?: ButtonVariants['size'];
-  href?: string;
-  label?: string;
-  leadingIcon?: string;
-  trailingIcon?: string;
-  loading?: boolean;
-  square?: boolean;
-  block?: boolean;
-  active?: boolean;
-  activeColor?: ButtonVariants['color'];
-  activeVariant?: ButtonVariants['variant'];
-  ui?: ComponentSlots<typeof buttonTheme>;
-  class?: any;
-  [key: string]: unknown;
-}
-
-const {
-  variant = "solid",
-  color = "primary",
-  size = "md",
-  href,
-  label,
-  leadingIcon,
-  trailingIcon,
-  loading = false,
-  square = false,
-  block = false,
-  active = false,
-  activeColor,
-  activeVariant,
-  ui: uiProp,
-  class: className,
-  ...rest
-} = Astro.props as RLAButtonProps
-
-const isLeading = !!(leadingIcon || Astro.slots.has("leading")) || loading
-const isTrailing = !!(trailingIcon || Astro.slots.has("trailing")) || (loading && !isLeading)
-
-const showLeadingIcon = loading
-  ? "i-lucide-loader-circle"
-  : leadingIcon
-
-const showTrailingIcon = loading
-  ? "i-lucide-loader-circle"
-  : trailingIcon
-
-const leadingIconClass = loading ? "animate-spin" : ""
-const trailingIconClass = loading ? "animate-spin" : ""
-
-const classes = resolveClasses(button, {
-  variant: active && activeVariant ? activeVariant : variant,
-  color: active && activeColor ? activeColor : color,
-  size,
-  block,
-  square: square || (!label && !Astro.slots.has("default")),
-  leading: isLeading,
-  trailing: isTrailing,
-  loading,
-  active
-}, useUi("button", uiProp), className);
-
-const Tag = href ? "a" : "button";
----
-<Tag
-  class={classes.root}
-  data-slot="root"
-  {...(Tag === "a" ? { href } : {})}
-  {...rest}
->
-  <slot name="leading" {...{ ui: classes }}>
-    {isLeading && (
-      <span class={classes.leadingIcon} data-slot="leading-icon">
-        <span class={cx(showLeadingIcon, leadingIconClass)} aria-hidden="true" />
-      </span>
-    )}
-  </slot>
-
-  {label !== undefined && label !== null && (
-    <span class={classes.label} data-slot="label">
-      {label}
-    </span>
-  )}
-  {!label && <slot />}
-
-  <slot name="trailing" {...{ ui: classes }}>
-    {isTrailing && (
-      <span class={classes.trailingIcon} data-slot="trailing-icon">
-        <span class={cx(showTrailingIcon, trailingIconClass)} aria-hidden="true" />
-      </span>
-    )}
-  </slot>
-</Tag>
+---
+import { scv, cx } from "css-variants"
+import { useUi, resolveClasses } from "../../utils"
+import type { ComponentVariants, ComponentSlots } from "../../types"
+import buttonThemeDefault, { createButtonTheme } from "../../themes/button.theme"
+import { getUIConfig } from "virtual:rimelight-ui"
+
+const uiConfig = getUIConfig()
+const buttonTheme = uiConfig.colors ? createButtonTheme(uiConfig.colors) : buttonThemeDefault
+
+const button = scv(buttonTheme)
+type ButtonVariants = ComponentVariants<typeof buttonThemeDefault>
+
+export interface RLAButtonProps {
+  variant?: ButtonVariants['variant'];
+  color?: ButtonVariants['color'];
+  size?: ButtonVariants['size'];
+  href?: string;
+  label?: string;
+  leadingIcon?: string;
+  trailingIcon?: string;
+  loading?: boolean;
+  square?: boolean;
+  block?: boolean;
+  active?: boolean;
+  activeColor?: ButtonVariants['color'];
+  activeVariant?: ButtonVariants['variant'];
+  ui?: ComponentSlots<typeof buttonTheme>;
+  class?: any;
+  [key: string]: unknown;
+}
+
+const {
+  variant = "solid",
+  color = "primary",
+  size = "md",
+  href,
+  label,
+  leadingIcon,
+  trailingIcon,
+  loading = false,
+  square = false,
+  block = false,
+  active = false,
+  activeColor,
+  activeVariant,
+  ui: uiProp,
+  class: className,
+  ...rest
+} = Astro.props as RLAButtonProps
+
+const isLeading = !!(leadingIcon || Astro.slots.has("leading")) || loading
+const isTrailing = !!(trailingIcon || Astro.slots.has("trailing")) || (loading && !isLeading)
+
+const showLeadingIcon = loading
+  ? "i-lucide-loader-circle"
+  : leadingIcon
+
+const showTrailingIcon = loading
+  ? "i-lucide-loader-circle"
+  : trailingIcon
+
+const leadingIconClass = loading ? "animate-spin" : ""
+const trailingIconClass = loading ? "animate-spin" : ""
+
+const classes = resolveClasses(button, {
+  variant: active && activeVariant ? activeVariant : variant,
+  color: active && activeColor ? activeColor : color,
+  size,
+  block,
+  square: square || (!label && !Astro.slots.has("default")),
+  leading: isLeading,
+  trailing: isTrailing,
+  loading,
+  active
+}, useUi("button", uiProp), className);
+
+const Tag = href ? "a" : "button";
+---
+<Tag
+  class={classes.root}
+  data-slot="root"
+  {...(Tag === "a" ? { href } : {})}
+  {...rest}
+>
+  <slot name="leading" {...{ ui: classes }}>
+    {isLeading && (
+      <span class={classes.leadingIcon} data-slot="leading-icon">
+        <span class={cx(showLeadingIcon, leadingIconClass)} aria-hidden="true" />
+      </span>
+    )}
+  </slot>
+
+  {label !== undefined && label !== null && (
+    <span class={classes.label} data-slot="label">
+      {label}
+    </span>
+  )}
+  {!label && <slot />}
+
+  <slot name="trailing" {...{ ui: classes }}>
+    {isTrailing && (
+      <span class={classes.trailingIcon} data-slot="trailing-icon">
+        <span class={cx(showTrailingIcon, trailingIconClass)} aria-hidden="true" />
+      </span>
+    )}
+  </slot>
+</Tag>

package/src/components/astro/RLAEmbedYoutube.astro

@@ -0,0 +1,219 @@
+---
+import { scv } from "css-variants"
+import { useUi, resolveClasses } from "../../utils"
+import type { ComponentVariants, ComponentSlots } from "../../types"
+import embedYoutubeTheme from "../../themes/embedYoutube.theme"
+import type { RLAIconProps } from "./RLAIcon.astro"
+import { Image } from "astro:assets"
+
+const PLACEHOLDER_THUMBNAIL = "/assets/placeholder.webp";
+const YOUTUBE_EMBED_BASE = "https://www.youtube.com/embed/";
+const VALID_ID_PATTERN = /^[\w-]{11}$/;
+const KNOWN_PREFIXES = ["www.", "m.", "music.", "gaming."];
+const YOUTUBE_THUMB_BASE = "https://i3.ytimg.com/vi/";
+const MAXRES_THUMBNAIL = "maxresdefault.jpg";
+const DEFAULT_THUMBNAIL = "hqdefault.jpg";
+
+const thumbnailAvailabilityCache = new Map<string, boolean>();
+
+function normalizeHost(host: string): string {
+  for (const prefix of KNOWN_PREFIXES) {
+    if (host.startsWith(prefix)) {
+      return host.slice(prefix.length);
+    }
+  }
+  return host;
+}
+
+function sanitizeVideoId(id: string | null): string | null {
+  if (!id) return null;
+  return VALID_ID_PATTERN.test(id) ? id : null;
+}
+
+function extractYoutubeVideoId(rawUrl: string): string | null {
+  if (!rawUrl) return null;
+
+  try {
+    const url = new URL(rawUrl);
+    const host = normalizeHost(url.hostname);
+
+    if (host === "youtu.be") {
+      const id = url.pathname.split("/").filter(Boolean)[0] ?? null;
+      return sanitizeVideoId(id);
+    }
+
+    if (host.endsWith("youtube.com")) {
+      const paramsId = sanitizeVideoId(url.searchParams.get("v"));
+      if (paramsId) return paramsId;
+
+      const segments = url.pathname.split("/").filter(Boolean);
+      if (!segments.length) return null;
+
+      if (segments[0] === "embed" || segments[0] === "shorts" || segments[0] === "live") {
+        return sanitizeVideoId(segments[1] ?? null);
+      }
+
+      return sanitizeVideoId(segments[segments.length - 1] ?? null);
+    }
+  } catch {
+    // If it's just an 11-character ID passed directly, return it validated
+    if (VALID_ID_PATTERN.test(rawUrl)) {
+      return rawUrl;
+    }
+    return null;
+  }
+
+  return null;
+}
+
+async function isThumbnailAvailable(url: string): Promise<boolean> {
+  if (thumbnailAvailabilityCache.has(url)) {
+    return thumbnailAvailabilityCache.get(url)!;
+  }
+
+  if (typeof fetch !== "function") {
+    return false;
+  }
+
+  try {
+    const response = await fetch(url, { method: "HEAD" });
+    let available = response.ok;
+
+    if (!available && response.status === 405) {
+      const getResponse = await fetch(url, { method: "GET" });
+      available = getResponse.ok;
+    }
+
+    thumbnailAvailabilityCache.set(url, available);
+    return available;
+  } catch {
+    return false;
+  }
+}
+
+async function getYoutubeThumbnail(rawUrl: string): Promise<string> {
+  const id = extractYoutubeVideoId(rawUrl);
+  if (!id) return PLACEHOLDER_THUMBNAIL;
+
+  const baseUrl = `${YOUTUBE_THUMB_BASE}${id}`;
+  const maxResUrl = `${baseUrl}/${MAXRES_THUMBNAIL}`;
+
+  if (await isThumbnailAvailable(maxResUrl)) {
+    return maxResUrl;
+  }
+
+  return `${baseUrl}/${DEFAULT_THUMBNAIL}`;
+}
+
+function getYoutubeEmbedUrl(rawUrl: string): string | null {
+  const id = extractYoutubeVideoId(rawUrl);
+  return id ? `${YOUTUBE_EMBED_BASE}${id}?autoplay=1` : null;
+}
+
+const embedYoutube = scv(embedYoutubeTheme)
+type EmbedYoutubeVariants = ComponentVariants<typeof embedYoutubeTheme>
+
+export interface RLAEmbedYoutubeProps {
+  /**
+   * The URL of the YouTube video to embed.
+   */
+  src: string;
+  /**
+    * The title of the video to display.
+    * @default "YouTube Video Player"
+    */
+  title?: string;
+  /**
+   * The name of the icon to display in the play trigger overlay.
+   * @default "i-lucide-play"
+   */
+  icon?: RLAIconProps["name"];
+  ui?: ComponentSlots<typeof embedYoutubeTheme>;
+  class?: any;
+  [key: string]: unknown;
+}
+
+const {
+  src,
+  title = "YouTube Video Player",
+  icon = "i-lucide-play",
+  ui: uiProp,
+  class: className,
+  ...rest
+} = Astro.props as RLAEmbedYoutubeProps;
+
+const classes = resolveClasses(embedYoutube, {
+  title: !!(Astro.slots.has("title") || Astro.props.title),
+  icon: !!(Astro.slots.has("icon") || Astro.props.icon),
+}, useUi("embedYoutube", uiProp), className);
+
+const embedUrl = getYoutubeEmbedUrl(src);
+const thumbnail = await getYoutubeThumbnail(src);
+const isPlayable = Boolean(embedUrl);
+const ariaLabel = isPlayable ? "Play YouTube Video" : "YouTube Video Unavailable";
+---
+
+<div
+    class:list={[classes.root]}
+    {...rest}
+>
+  <button
+    type="button"
+    data-youtube-trigger
+    aria-label={ariaLabel}
+    data-embed-url={isPlayable ? embedUrl : undefined}
+    disabled={!isPlayable}
+    data-video-title={title}
+    class:list={[classes.trigger]}
+  >
+    <Image
+      layout="full-width"
+      src={thumbnail}
+      alt={title}
+      width="1280"
+      height="720"
+      loading="lazy"
+      class:list={[classes.image]}
+    />
+
+    <slot name="icon">
+      <span class:list={[classes.icon, icon]} aria-hidden="true" />
+    </slot>
+  </button>
+</div>
+
+<script is:inline>
+  (() => {
+    const root = document.currentScript?.previousElementSibling;
+    if (!(root instanceof HTMLElement)) return;
+
+    const trigger = root.querySelector("[data-youtube-trigger]");
+    if (!(trigger instanceof HTMLButtonElement)) return;
+
+    const embedUrl = trigger.dataset.embedUrl;
+    const title = trigger.dataset.videoTitle;
+    if (!embedUrl) return;
+
+    const activate = () => {
+      const iframe = document.createElement("iframe");
+      iframe.src = embedUrl;
+      iframe.title = title;
+      iframe.allow =
+          "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share";
+      iframe.allowFullscreen = true;
+      iframe.loading = "lazy";
+      iframe.referrerPolicy = "strict-origin-when-cross-origin";
+      iframe.classList.add("w-full", "h-full", "absolute", "inset-0");
+
+      root.replaceChildren(iframe);
+    };
+
+    trigger.addEventListener("click", activate, { once: true });
+    trigger.addEventListener("keydown", (event) => {
+      if (event.key === "Enter" || event.key === " ") {
+        event.preventDefault();
+        activate();
+      }
+    }, { once: true });
+  })();
+</script>

package/src/components/astro/RLASection.astro

@@ -104,23 +104,19 @@ const TitleTag = variant === "hero" ? "h1" : "h2";
   <slot name="top" />
 
   <div
-    data-slot="container"
     class:list={[classes.container]}
   >
     {(Astro.slots.has("header") || Astro.props.icon || Astro.props.headline || Astro.props.title || Astro.props.description || Astro.slots.has("body") || Astro.slots.has("footer") || Astro.slots.has("links") || Astro.props.links?.length) && (
       <div
-        data-slot="wrapper"
         class:list={[classes.wrapper]}
       >
         {(Astro.slots.has("header") || Astro.props.icon || Astro.props.headline || Astro.props.title || Astro.props.description) && (
           <div
-            data-slot="header"
             class:list={[classes.header]}
           >
             <slot name="header">
               {(Astro.props.icon || Astro.slots.has("leading")) && (
                 <div
-                  data-slot="leading"
                   class:list={[classes.leading]}
                 >
                   <slot name="leading" {...{ ui: classes }}>
@@ -133,7 +129,6 @@ const TitleTag = variant === "hero" ? "h1" : "h2";
 
               {(Astro.props.headline || Astro.slots.has("headline")) && (
                 <div
-                  data-slot="headline"
                   class:list={[classes.headline]}
                 >
                   <slot name="headline">
@@ -144,7 +139,6 @@ const TitleTag = variant === "hero" ? "h1" : "h2";
 
               {(Astro.props.title || Astro.slots.has("title")) && (
                 <TitleTag
-                  data-slot="title"
                   class:list={[classes.title]}
                 >
                   <slot name="title">
@@ -155,7 +149,6 @@ const TitleTag = variant === "hero" ? "h1" : "h2";
 
               {(Astro.props.description || Astro.slots.has("description")) && (
                 <div
-                  data-slot="description"
                   class:list={[classes.description]}
                 >
                   <slot name="description">
@@ -169,7 +162,6 @@ const TitleTag = variant === "hero" ? "h1" : "h2";
 
         {Astro.slots.has("body") && (
           <div
-            data-slot="body"
             class:list={[classes.body]}
           >
             <slot name="body" />
@@ -178,13 +170,11 @@ const TitleTag = variant === "hero" ? "h1" : "h2";
 
         {(Astro.slots.has("footer") || Astro.slots.has("links") || Astro.props.links?.length) && (
           <div
-            data-slot="footer"
             class:list={[classes.footer]}
           >
             <slot name="footer">
               {(Astro.props.links?.length || Astro.slots.has("links")) && (
                 <div
-                  data-slot="links"
                   class:list={[classes.links]}
                 >
                   {Astro.props.links?.map((link) => (

package/src/env.d.ts

@@ -9,7 +9,7 @@ declare module "virtual:nuxt-ui-plugins" {
 declare module "virtual:rimelight-ui" {
   import type { DefaultUIConfig } from "../themes"
 
-  export function getUIConfig(): DefaultUIConfig
+  export function getUIConfig(): DefaultUIConfig & { colors?: string[] }
 }
 
 interface StarlightAddonsConfig {

package/src/integrations/ui.ts

@@ -33,6 +33,10 @@ export interface UIOptions {
    * wins).
    */
   ui?: UIConfigOverrides
+  /**
+   * Custom color names to dynamically generate variants for.
+   */
+  colors?: string[]
 }
 
 /**
@@ -59,7 +63,9 @@ export interface UIOptions {
  */
 export function ui(options: UIOptions = {}): AstroIntegration[] {
   const resolvedUI = defu(options.ui ?? {}, defaultUIConfig)
-  const resolvedConfig = { ...resolvedUI, logos: options.logos ?? {} }
+  const coreColors = ["primary", "secondary", "info", "success", "warning", "error", "commentary", "ideation", "source"]
+  const mergedColors = [...new Set([...coreColors, ...(options.colors || [])])]
+  const resolvedConfig = { ...resolvedUI, logos: options.logos ?? {}, colors: mergedColors }
 
   const virtualModuleId = "virtual:rimelight-ui"
   const resolvedVirtualModuleId = "\0" + virtualModuleId