truthound-dashboard 1.4.0__tar.gz → 1.4.1__tar.gz

{truthound_dashboard-1.4.0 → truthound_dashboard-1.4.1}/.gitignore

@@ -142,8 +142,9 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
-# Intlayer cache only (dictionary must be committed for CI builds)
-frontend/.intlayer/cache/
+# Intlayer - config has absolute paths, cache is temp files
+# Dictionary and types need fresh generation on each build
+frontend/.intlayer/
 
 # Frontend build output (handled by build process)
 # src/truthound_dashboard/static/
@@ -169,4 +170,5 @@ CLAUDE.md
 src/truthound_dashboard/static/assets/*.js
 src/truthound_dashboard/static/assets/*.css
 
-.github/copilot-instructions.md
+.github/copilot-instructions.md
+.vercel

{truthound_dashboard-1.4.0 → truthound_dashboard-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: truthound-dashboard
-Version: 1.4.0
+Version: 1.4.1
 Summary: Open-source data quality dashboard - GX Cloud alternative
 Author-email: Truthound Team <team@truthound.dev>
 License-Expression: Apache-2.0
@@ -59,7 +59,11 @@ Description-Content-Type: text/markdown
 
 A web-based data quality monitoring dashboard for [truthound](https://github.com/seadonggyun4/truthound).
 
-[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/)
+[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/) | [Live Demo](https://truthound-dashborad.vercel.app/)
+
+> **Try the Live Demo**: Experience the full dashboard interface with mock data at [truthound-dashborad.vercel.app](https://truthound-dashborad.vercel.app/). No installation required!
+>
+> **Note**: The demo page displays in English only. Language selection is not available in the demo due to Intlayer's runtime requirements. When you install and run truthound-dashboard locally, full multi-language support (English, Korean, and AI-translated languages) works as expected.
 
 ## Overview
 <img width="300" height="300" alt="Truthound_icon" src="https://github.com/user-attachments/assets/90d9e806-8895-45ec-97dc-f8300da4d997" />

{truthound_dashboard-1.4.0 → truthound_dashboard-1.4.1}/README.md

@@ -11,7 +11,11 @@
 
 A web-based data quality monitoring dashboard for [truthound](https://github.com/seadonggyun4/truthound).
 
-[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/)
+[Documentation](https://truthound.netlify.app) | [PyPI](https://pypi.org/project/truthound-dashboard/) | [Live Demo](https://truthound-dashborad.vercel.app/)
+
+> **Try the Live Demo**: Experience the full dashboard interface with mock data at [truthound-dashborad.vercel.app](https://truthound-dashborad.vercel.app/). No installation required!
+>
+> **Note**: The demo page displays in English only. Language selection is not available in the demo due to Intlayer's runtime requirements. When you install and run truthound-dashboard locally, full multi-language support (English, Korean, and AI-translated languages) works as expected.
 
 ## Overview
 <img width="300" height="300" alt="Truthound_icon" src="https://github.com/user-attachments/assets/90d9e806-8895-45ec-97dc-f8300da4d997" />

truthound_dashboard-1.4.1/frontend/.gitignore

@@ -0,0 +1 @@
+.vercel

{truthound_dashboard-1.4.0 → truthound_dashboard-1.4.1}/frontend/package.json

@@ -1,7 +1,7 @@
 {
   "name": "truthound-dashboard-frontend",
   "private": true,
-  "version": "1.0.2",
+  "version": "1.4.1",
   "type": "module",
   "scripts": {
     "dev": "vite",

truthound_dashboard-1.4.1/frontend/scripts/generate-fallbacks.mjs

@@ -0,0 +1,111 @@
+/**
+ * Generate English fallback data from Intlayer content files
+ *
+ * This script extracts English (en) values from all .content.ts files
+ * and generates a fallbacks.ts file that can be used when Intlayer
+ * fails to load at runtime.
+ */
+
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const contentDir = path.join(__dirname, '../src/content')
+const outputFile = path.join(__dirname, '../src/lib/intlayer-fallbacks.ts')
+
+/**
+ * Extract English values from content file source code
+ */
+function extractEnglishValues(content) {
+  const result = {}
+
+  // Match t({ en: '...', ... }) patterns
+  // Handle both single-line and multi-line patterns
+  const tCallRegex = /(\w+):\s*t\(\s*\{([^}]+)\}\s*\)/gs
+
+  let match
+  while ((match = tCallRegex.exec(content)) !== null) {
+    const key = match[1]
+    const props = match[2]
+
+    // Extract the 'en' value
+    // Handle both: en: 'value' and en: "value"
+    const enMatch = props.match(/en:\s*['"]([^'"]*)['"]/s)
+    if (enMatch) {
+      result[key] = enMatch[1]
+    }
+  }
+
+  return result
+}
+
+/**
+ * Get the key name from content file
+ */
+function extractKey(content) {
+  const keyMatch = content.match(/key:\s*['"](\w+)['"]/s)
+  return keyMatch ? keyMatch[1] : null
+}
+
+// Main execution
+console.log('Generating English fallbacks from content files...\n')
+
+const contentFiles = fs.readdirSync(contentDir)
+  .filter(f => f.endsWith('.content.ts'))
+
+const fallbacks = {}
+
+for (const file of contentFiles) {
+  const filePath = path.join(contentDir, file)
+  const content = fs.readFileSync(filePath, 'utf-8')
+
+  const key = extractKey(content)
+  if (!key) {
+    console.warn(`  Warning: Could not extract key from ${file}`)
+    continue
+  }
+
+  const englishValues = extractEnglishValues(content)
+  const valueCount = Object.keys(englishValues).length
+
+  if (valueCount > 0) {
+    fallbacks[key] = englishValues
+    console.log(`  ✓ ${key}: ${valueCount} values`)
+  } else {
+    console.warn(`  Warning: No English values found in ${file}`)
+  }
+}
+
+// Generate TypeScript output
+const output = `/**
+ * Auto-generated English fallbacks for Intlayer content
+ *
+ * Generated by: scripts/generate-fallbacks.mjs
+ *
+ * These fallbacks are used when Intlayer fails to load dictionaries
+ * at runtime (e.g., in Vercel deployments).
+ *
+ * DO NOT EDIT MANUALLY - regenerate with: node scripts/generate-fallbacks.mjs
+ */
+
+// Type for IntlayerNode compatibility (string wrapper that works with React)
+type FallbackValue = string
+
+// Type for nested content structure
+type FallbackContent = Record<string, FallbackValue | Record<string, FallbackValue>>
+
+export const fallbacks: Record<string, FallbackContent> = ${JSON.stringify(fallbacks, null, 2)} as const
+
+export type FallbackKeys = keyof typeof fallbacks
+
+export function getFallback<K extends FallbackKeys>(key: K): typeof fallbacks[K] {
+  return fallbacks[key] || {}
+}
+`
+
+fs.writeFileSync(outputFile, output, 'utf-8')
+
+console.log(`\n✓ Generated ${outputFile}`)
+console.log(`  Total keys: ${Object.keys(fallbacks).length}`)
+console.log(`  Total values: ${Object.values(fallbacks).reduce((acc, v) => acc + Object.keys(v).length, 0)}`)

{truthound_dashboard-1.4.0 → truthound_dashboard-1.4.1}/frontend/src/components/ConfirmDialog.tsx

@@ -25,7 +25,7 @@
  */
 
 import { useState, useCallback } from 'react'
-import { useIntlayer } from '@/providers'
+import { useSafeIntlayer } from '@/hooks/useSafeIntlayer'
 import {
   AlertDialog,
   AlertDialogAction,
@@ -54,7 +54,7 @@ interface ConfirmState extends ConfirmOptions {
 }
 
 export function useConfirm() {
-  const common = useIntlayer('common')
+  const common = useSafeIntlayer('common')
   const [state, setState] = useState<ConfirmState>({
     isOpen: false,
     title: '',

{truthound_dashboard-1.4.0 → truthound_dashboard-1.4.1}/frontend/src/components/Layout.tsx

@@ -1,5 +1,5 @@
 import { Outlet, Link, useLocation } from 'react-router-dom'
-import { useIntlayer } from '@/providers'
+import { useSafeIntlayer } from '@/hooks/useSafeIntlayer'
 import {
   LayoutDashboard,
   Database,
@@ -76,7 +76,7 @@ const navigation: NavItem[] = [
 
 export default function Layout() {
   const location = useLocation()
-  const nav = useIntlayer('nav')
+  const nav = useSafeIntlayer('nav')
   const { theme, setTheme } = useTheme()
   const [sidebarOpen, setSidebarOpen] = useState(false)
   const [alertCount, setAlertCount] = useState(0)

truthound_dashboard-1.4.1/frontend/src/hooks/useSafeIntlayer.ts

@@ -0,0 +1,90 @@
+/**
+ * Safe Intlayer hook with English fallback support
+ *
+ * This hook wraps react-intlayer's useIntlayer and provides fallback values
+ * when Intlayer fails to load dictionaries at runtime (e.g., in Vercel deployments).
+ *
+ * Usage:
+ *   import { useSafeIntlayer } from '@/hooks/useSafeIntlayer'
+ *   const common = useSafeIntlayer('common')
+ */
+
+import { useMemo } from 'react'
+import { useIntlayer as useIntlayerOriginal } from 'react-intlayer'
+import { fallbacks } from '@/lib/intlayer-fallbacks'
+
+// Store whether we've already logged the fallback warning
+let fallbackWarningShown = false
+
+/**
+ * Check if Intlayer content is valid (not empty/broken)
+ * Returns true if the content has at least one valid property
+ */
+function isIntlayerContentValid(content: unknown): boolean {
+  if (!content || typeof content !== 'object') {
+    return false
+  }
+
+  const obj = content as Record<string, unknown>
+  // Check if at least one property exists and has a value
+  for (const key of Object.keys(obj)) {
+    const value = obj[key]
+    if (value !== undefined && value !== null) {
+      return true
+    }
+  }
+  return false
+}
+
+// Type alias for Intlayer dictionary keys from the registry
+type IntlayerKey = Parameters<typeof useIntlayerOriginal>[0]
+
+/**
+ * Safe Intlayer hook that falls back to English defaults when
+ * Intlayer fails to load dictionaries.
+ *
+ * @param key - The dictionary key
+ * @returns Dictionary content with Intlayer types preserved
+ */
+export function useSafeIntlayer<K extends IntlayerKey>(
+  key: K
+): ReturnType<typeof useIntlayerOriginal<K>> {
+  // Always try to get content from Intlayer first
+  let intlayerContent: ReturnType<typeof useIntlayerOriginal<K>> | undefined
+  let intlayerFailed = false
+
+  try {
+    intlayerContent = useIntlayerOriginal(key)
+  } catch (error) {
+    intlayerFailed = true
+    if (!fallbackWarningShown) {
+      console.warn('[useSafeIntlayer] Intlayer failed, using fallbacks:', error)
+      fallbackWarningShown = true
+    }
+  }
+
+  // Get fallback content if available
+  const fallbackContent = fallbacks[key as keyof typeof fallbacks]
+
+  // Determine which content to use
+  return useMemo(() => {
+    // If Intlayer loaded successfully and has valid content, use it
+    if (!intlayerFailed && isIntlayerContentValid(intlayerContent)) {
+      return intlayerContent as ReturnType<typeof useIntlayerOriginal<K>>
+    }
+
+    // Otherwise use fallback - cast to match Intlayer's expected return type
+    // This works because fallback strings render identically to IntlayerNode in JSX
+    if (fallbackContent) {
+      return fallbackContent as unknown as ReturnType<typeof useIntlayerOriginal<K>>
+    }
+
+    // If no fallback available, return whatever Intlayer gave us (may be empty)
+    return intlayerContent as ReturnType<typeof useIntlayerOriginal<K>>
+  }, [intlayerFailed, intlayerContent, fallbackContent])
+}
+
+/**
+ * Re-export useLocale for convenience
+ */
+export { useLocale } from 'react-intlayer'