@rimelight/ui 0.0.1

package/src/utils/shared/deep-merge.ts

@@ -0,0 +1,36 @@
+function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+/**
+ * Deep-merge two dictionaries. - `base` provides known structure (fallback) - `overrides` can
+ * provide partial values - Both types are preserved and merged correctly
+ */
+function assertRecord(obj: unknown): asserts obj is Record<string, unknown> {
+  if (!obj || typeof obj !== "object") throw new Error("Expected object")
+}
+
+function assertA<T>(obj: unknown): asserts obj is T {
+  if (!obj) throw new Error("Expected result")
+}
+
+export function deepMerge<A extends object, B extends Partial<A>>(base: A, overrides: B): A {
+  const result = { ...base }
+  assertRecord(result)
+
+  for (const key of Object.keys(overrides)) {
+    const overrideValue = Reflect.get(overrides, key)
+    const baseValue = Reflect.get(base, key)
+
+    if (overrideValue === undefined) continue
+
+    if (isObject(baseValue) && isObject(overrideValue)) {
+      Reflect.set(result, key, deepMerge(baseValue as object, overrideValue as Partial<object>))
+    } else {
+      Reflect.set(result, key, overrideValue)
+    }
+  }
+
+  assertA<A>(result)
+  return result
+}

package/src/utils/shared/embed.ts

@@ -0,0 +1,105 @@
+const PLACEHOLDER_THUMBNAIL = "/assets/placeholder.png"
+
+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
+}
+
+export 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("/").find(Boolean) ?? 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 {
+    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
+  }
+}
+
+export 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}`
+}
+
+export function getYoutubeEmbedUrl(rawUrl: string): string | null {
+  const id = extractYoutubeVideoId(rawUrl)
+  return id ? `${YOUTUBE_EMBED_BASE}${id}?autoplay=1` : null
+}

package/src/utils/shared/index.ts

@@ -0,0 +1,3 @@
+export * from "./parse-boolean"
+export * from "./deep-merge"
+export * from "./embed"

package/src/utils/shared/parse-boolean.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse a boolean flag from Wrangler-env string.
+ *
+ * Accepts: "1", "true", "on" → true "0", "false", "off" → false undefined → defaultValue
+ */
+export function parseBooleanFlag(value: string | undefined, defaultValue: boolean): boolean {
+  if (value === undefined) return defaultValue
+
+  const v = value.toLowerCase()
+  if (v === "1" || v === "true" || v === "on") return true
+  if (v === "0" || v === "false" || v === "off") return false
+
+  return defaultValue
+}