@puredesktop/puredesktop-ui-bridge 1.0.0-beta.1 → 2.1.0

package/src/utils/extensionIconMap.ts

@@ -1,123 +1,123 @@
-import type { LucideIcon } from 'lucide-react'
-import {
-  Archive,
-  Braces,
-  File,
-  FileAudio,
-  FileCode2,
-  FileImage,
-  FileSpreadsheet,
-  FileText,
-  FileType,
-  FileVideo,
-  Folder,
-  Globe,
-  Sheet,
-} from 'lucide-react'
-
-export type ExtensionIconMap = Partial<Record<string, LucideIcon>> & {
-  _: LucideIcon
-}
-
-/**
- * File key → Lucide icon.
- * Use `dir` for directories; otherwise normalized extension (no dot).
- * `_` is the default fallback.
- *
- * @example
- * const ext = isDirectory ? 'dir' : normalizeExtension(extension)
- * const Icon = switchOn(ext, extensionIconMap) ?? extensionIconMap._
- */
-export const extensionIconMap: ExtensionIconMap = {
-  dir: Folder,
-
-  // Documents
-  pdf: FileType,
-  txt: FileText,
-  md: FileText,
-  markdown: FileText,
-  rtf: FileText,
-  doc: FileText,
-  docx: FileText,
-
-  // Web
-  html: Globe,
-  htm: Globe,
-  css: FileCode2,
-  scss: FileCode2,
-  sass: FileCode2,
-  less: FileCode2,
-
-  // Code / data
-  json: Braces,
-  jsonc: Braces,
-  json5: Braces,
-  yaml: Braces,
-  yml: Braces,
-  toml: Braces,
-  xml: Braces,
-  csv: Sheet,
-  tsv: Sheet,
-  xls: FileSpreadsheet,
-  xlsx: FileSpreadsheet,
-  ods: FileSpreadsheet,
-  ts: FileCode2,
-  tsx: FileCode2,
-  js: FileCode2,
-  jsx: FileCode2,
-  mjs: FileCode2,
-  cjs: FileCode2,
-  py: FileCode2,
-  rb: FileCode2,
-  go: FileCode2,
-  rs: FileCode2,
-  java: FileCode2,
-  kt: FileCode2,
-  swift: FileCode2,
-  c: FileCode2,
-  cpp: FileCode2,
-  h: FileCode2,
-  hpp: FileCode2,
-  cs: FileCode2,
-  php: FileCode2,
-  sh: FileCode2,
-  bash: FileCode2,
-  zsh: FileCode2,
-  sql: FileCode2,
-  graphql: FileCode2,
-  gql: FileCode2,
-  vue: FileCode2,
-  svelte: FileCode2,
-
-  // Media
-  png: FileImage,
-  jpg: FileImage,
-  jpeg: FileImage,
-  gif: FileImage,
-  webp: FileImage,
-  svg: FileImage,
-  bmp: FileImage,
-  ico: FileImage,
-  mp4: FileVideo,
-  mov: FileVideo,
-  webm: FileVideo,
-  ogv: FileVideo,
-  mkv: FileVideo,
-  mp3: FileAudio,
-  m4a: FileAudio,
-  wav: FileAudio,
-  ogg: FileAudio,
-  flac: FileAudio,
-
-  // Archives
-  zip: Archive,
-  tar: Archive,
-  gz: Archive,
-  tgz: Archive,
-  bz2: Archive,
-  xz: Archive,
-  '7z': Archive,
-  rar: Archive,
-
-  _: File,
-}
+import type { LucideIcon } from 'lucide-react'
+import {
+  Archive,
+  Braces,
+  File,
+  FileAudio,
+  FileCode2,
+  FileImage,
+  FileSpreadsheet,
+  FileText,
+  FileType,
+  FileVideo,
+  Folder,
+  Globe,
+  Sheet,
+} from 'lucide-react'
+
+export type ExtensionIconMap = Partial<Record<string, LucideIcon>> & {
+  _: LucideIcon
+}
+
+/**
+ * File key → Lucide icon.
+ * Use `dir` for directories; otherwise normalized extension (no dot).
+ * `_` is the default fallback.
+ *
+ * @example
+ * const ext = isDirectory ? 'dir' : normalizeExtension(extension)
+ * const Icon = switchOn(ext, extensionIconMap) ?? extensionIconMap._
+ */
+export const extensionIconMap: ExtensionIconMap = {
+  dir: Folder,
+
+  // Documents
+  pdf: FileType,
+  txt: FileText,
+  md: FileText,
+  markdown: FileText,
+  rtf: FileText,
+  doc: FileText,
+  docx: FileText,
+
+  // Web
+  html: Globe,
+  htm: Globe,
+  css: FileCode2,
+  scss: FileCode2,
+  sass: FileCode2,
+  less: FileCode2,
+
+  // Code / data
+  json: Braces,
+  jsonc: Braces,
+  json5: Braces,
+  yaml: Braces,
+  yml: Braces,
+  toml: Braces,
+  xml: Braces,
+  csv: Sheet,
+  tsv: Sheet,
+  xls: FileSpreadsheet,
+  xlsx: FileSpreadsheet,
+  ods: FileSpreadsheet,
+  ts: FileCode2,
+  tsx: FileCode2,
+  js: FileCode2,
+  jsx: FileCode2,
+  mjs: FileCode2,
+  cjs: FileCode2,
+  py: FileCode2,
+  rb: FileCode2,
+  go: FileCode2,
+  rs: FileCode2,
+  java: FileCode2,
+  kt: FileCode2,
+  swift: FileCode2,
+  c: FileCode2,
+  cpp: FileCode2,
+  h: FileCode2,
+  hpp: FileCode2,
+  cs: FileCode2,
+  php: FileCode2,
+  sh: FileCode2,
+  bash: FileCode2,
+  zsh: FileCode2,
+  sql: FileCode2,
+  graphql: FileCode2,
+  gql: FileCode2,
+  vue: FileCode2,
+  svelte: FileCode2,
+
+  // Media
+  png: FileImage,
+  jpg: FileImage,
+  jpeg: FileImage,
+  gif: FileImage,
+  webp: FileImage,
+  svg: FileImage,
+  bmp: FileImage,
+  ico: FileImage,
+  mp4: FileVideo,
+  mov: FileVideo,
+  webm: FileVideo,
+  ogv: FileVideo,
+  mkv: FileVideo,
+  mp3: FileAudio,
+  m4a: FileAudio,
+  wav: FileAudio,
+  ogg: FileAudio,
+  flac: FileAudio,
+
+  // Archives
+  zip: Archive,
+  tar: Archive,
+  gz: Archive,
+  tgz: Archive,
+  bz2: Archive,
+  xz: Archive,
+  '7z': Archive,
+  rar: Archive,
+
+  _: File,
+}

package/src/utils/generalUtils.ts

@@ -1,157 +1,157 @@
-/**
- * General-purpose utility functions.
- * No DOM, no React, no Electron — safe for main and renderer.
- */
-
-// ---- Deep access ----
-
-/** Safe deep property access. Returns defaultValue if path resolves to undefined. */
-export function get<T = unknown>(
-  obj: unknown,
-  path: string | string[],
-  defaultValue?: T,
-): T | undefined {
-  if (obj == null) return defaultValue
-  const keys = Array.isArray(path) ? path : path.split('.')
-  let result: unknown = obj
-  for (const key of keys) {
-    result = (result as Record<string, unknown>)?.[key]
-    if (result === undefined) return defaultValue
-  }
-  return (result ?? defaultValue) as T | undefined
-}
-
-// ---- Type guards ----
-
-export const isPlainObject = (
-  value: unknown,
-): value is Record<string, unknown> => {
-  if (typeof value !== 'object' || value === null) return false
-  const proto = Object.getPrototypeOf(value)
-  return proto === Object.prototype || proto === null
-}
-
-export const isFunction = (
-  value: unknown,
-): value is (...args: unknown[]) => unknown => typeof value === 'function'
-
-// ---- Object iteration ----
-
-export const mapEntries = <K extends string, V, R>(
-  obj: Record<K, V>,
-  cb: (key: K, value: V) => R,
-): R[] => Object.entries(obj).map(([k, v]) => cb(k as K, v as V))
-
-export const filterEntries = <K extends string, V>(
-  obj: Record<K, V>,
-  cb: (key: K, value: V) => boolean,
-): Array<[K, V]> =>
-  (Object.entries(obj) as Array<[K, V]>).filter(([k, v]) => cb(k, v))
-
-// ---- Conditional spreads ----
-
-/** Conditionally return array items for array spread. */
-export const arrIf = <T>(
-  condition: boolean,
-  item: T | T[],
-  fallback: T[] = [],
-): T[] => {
-  if (condition) return Array.isArray(item) ? item : [item]
-  return fallback
-}
-
-// ---- Switch helpers ----
-
-/**
- * Exhaustive-style value lookup — replaces switch/case for simple
- * key → value mappings. `_` is an optional fallback for unmatched keys.
- */
-export const switchOn = <K extends PropertyKey, R>(
-  key: K,
-  cases: Partial<Record<K, R>> & { _?: R },
-): R | undefined => (key in cases ? cases[key as K] : cases._)
-
-/**
- * Lazy variant of switchOn — calls the matched function so React
- * branches aren't evaluated until needed.
- */
-export const callOn = <K extends PropertyKey, R>(
-  key: K,
-  cases: Partial<Record<K, () => R>> & { _?: () => R },
-): R | undefined => (cases[key as K] ?? cases._)?.()
-
-// ---- JSON ----
-
-/** Safe JSON parse. Returns fallback on failure. */
-export const safeParse = <T = Record<string, unknown>>(
-  str: string,
-  fallback: T = {} as T,
-): T => {
-  try {
-    return JSON.parse(str) as T
-  } catch {
-    return (str as unknown as T) ?? fallback
-  }
-}
-
-// ---- String casing ----
-
-/** "camelCaseString" → "Camel Case String" */
-export const camelCaseToCapital = (str: string): string => {
-  if (!str) return ''
-  return str
-    .replace(/([A-Z])/g, ' $1')
-    .split(' ')
-    .map(w => w.charAt(0).toUpperCase() + w.slice(1))
-    .join(' ')
-}
-
-/** "snake_case_string" (or "kebab-case") → "Snake Case String" */
-export const snakeCaseToHuman = (str: string): string => {
-  if (!str) return ''
-  return str
-    .replace(/[_-]+/g, ' ')
-    .trim()
-    .replace(/\b\w/g, c => c.toUpperCase())
-}
-
-/** "wait For Assignment" | "do_not_return" → "waitForAssignment" */
-export const toCamelCase = (str: string): string => {
-  if (!str) return ''
-  if (/^[a-z][a-zA-Z0-9]*$/.test(str)) return str
-
-  const words = str
-    .replace(/[^a-zA-Z0-9\s_-]/g, '')
-    .split(/[\s_-]+/)
-    .filter(Boolean)
-
-  return words
-    .map((word, i) =>
-      i === 0
-        ? word.toLowerCase()
-        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase(),
-    )
-    .join('')
-}
-
-/** "camelCase" | "snake_case" → "Camel case" */
-export const toHumanReadable = (str: string): string => {
-  if (!str) return ''
-  return str
-    .replace(/([a-z])([A-Z])/g, '$1 $2')
-    .replace(/[_-]+/g, ' ')
-    .replace(/^\w/, c => c.toUpperCase())
-}
-
-/** "my-chapter-file.md" → "My Chapter File" */
-export const slugToTitle = (slug: string): string =>
-  slug
-    .replace(/\.md$/, '')
-    .split(/[-_\s]+/)
-    .filter(Boolean)
-    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-    .join(' ') || 'Untitled'
-
-/** Strip leading dot and lowercase — `".PDF"` → `"pdf"`. */
-export const normalizeExtension = (extension: string): string =>
-  extension.toLowerCase().replace(/^\./, '')
+/**
+ * General-purpose utility functions.
+ * No DOM, no React, no Electron — safe for main and renderer.
+ */
+
+// ---- Deep access ----
+
+/** Safe deep property access. Returns defaultValue if path resolves to undefined. */
+export function get<T = unknown>(
+  obj: unknown,
+  path: string | string[],
+  defaultValue?: T,
+): T | undefined {
+  if (obj == null) return defaultValue
+  const keys = Array.isArray(path) ? path : path.split('.')
+  let result: unknown = obj
+  for (const key of keys) {
+    result = (result as Record<string, unknown>)?.[key]
+    if (result === undefined) return defaultValue
+  }
+  return (result ?? defaultValue) as T | undefined
+}
+
+// ---- Type guards ----
+
+export const isPlainObject = (
+  value: unknown,
+): value is Record<string, unknown> => {
+  if (typeof value !== 'object' || value === null) return false
+  const proto = Object.getPrototypeOf(value)
+  return proto === Object.prototype || proto === null
+}
+
+export const isFunction = (
+  value: unknown,
+): value is (...args: unknown[]) => unknown => typeof value === 'function'
+
+// ---- Object iteration ----
+
+export const mapEntries = <K extends string, V, R>(
+  obj: Record<K, V>,
+  cb: (key: K, value: V) => R,
+): R[] => Object.entries(obj).map(([k, v]) => cb(k as K, v as V))
+
+export const filterEntries = <K extends string, V>(
+  obj: Record<K, V>,
+  cb: (key: K, value: V) => boolean,
+): Array<[K, V]> =>
+  (Object.entries(obj) as Array<[K, V]>).filter(([k, v]) => cb(k, v))
+
+// ---- Conditional spreads ----
+
+/** Conditionally return array items for array spread. */
+export const arrIf = <T>(
+  condition: boolean,
+  item: T | T[],
+  fallback: T[] = [],
+): T[] => {
+  if (condition) return Array.isArray(item) ? item : [item]
+  return fallback
+}
+
+// ---- Switch helpers ----
+
+/**
+ * Exhaustive-style value lookup — replaces switch/case for simple
+ * key → value mappings. `_` is an optional fallback for unmatched keys.
+ */
+export const switchOn = <K extends PropertyKey, R>(
+  key: K,
+  cases: Partial<Record<K, R>> & { _?: R },
+): R | undefined => (key in cases ? cases[key as K] : cases._)
+
+/**
+ * Lazy variant of switchOn — calls the matched function so React
+ * branches aren't evaluated until needed.
+ */
+export const callOn = <K extends PropertyKey, R>(
+  key: K,
+  cases: Partial<Record<K, () => R>> & { _?: () => R },
+): R | undefined => (cases[key as K] ?? cases._)?.()
+
+// ---- JSON ----
+
+/** Safe JSON parse. Returns fallback on failure. */
+export const safeParse = <T = Record<string, unknown>>(
+  str: string,
+  fallback: T = {} as T,
+): T => {
+  try {
+    return JSON.parse(str) as T
+  } catch {
+    return (str as unknown as T) ?? fallback
+  }
+}
+
+// ---- String casing ----
+
+/** "camelCaseString" → "Camel Case String" */
+export const camelCaseToCapital = (str: string): string => {
+  if (!str) return ''
+  return str
+    .replace(/([A-Z])/g, ' $1')
+    .split(' ')
+    .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+    .join(' ')
+}
+
+/** "snake_case_string" (or "kebab-case") → "Snake Case String" */
+export const snakeCaseToHuman = (str: string): string => {
+  if (!str) return ''
+  return str
+    .replace(/[_-]+/g, ' ')
+    .trim()
+    .replace(/\b\w/g, c => c.toUpperCase())
+}
+
+/** "wait For Assignment" | "do_not_return" → "waitForAssignment" */
+export const toCamelCase = (str: string): string => {
+  if (!str) return ''
+  if (/^[a-z][a-zA-Z0-9]*$/.test(str)) return str
+
+  const words = str
+    .replace(/[^a-zA-Z0-9\s_-]/g, '')
+    .split(/[\s_-]+/)
+    .filter(Boolean)
+
+  return words
+    .map((word, i) =>
+      i === 0
+        ? word.toLowerCase()
+        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase(),
+    )
+    .join('')
+}
+
+/** "camelCase" | "snake_case" → "Camel case" */
+export const toHumanReadable = (str: string): string => {
+  if (!str) return ''
+  return str
+    .replace(/([a-z])([A-Z])/g, '$1 $2')
+    .replace(/[_-]+/g, ' ')
+    .replace(/^\w/, c => c.toUpperCase())
+}
+
+/** "my-chapter-file.md" → "My Chapter File" */
+export const slugToTitle = (slug: string): string =>
+  slug
+    .replace(/\.md$/, '')
+    .split(/[-_\s]+/)
+    .filter(Boolean)
+    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ') || 'Untitled'
+
+/** Strip leading dot and lowercase — `".PDF"` → `"pdf"`. */
+export const normalizeExtension = (extension: string): string =>
+  extension.toLowerCase().replace(/^\./, '')