@windrun-huaiin/lib 3.1.0

package/src/common-app-config.ts

@@ -0,0 +1,165 @@
+// Supported languages and their labels
+const ALL_LOCALE_LABELS = {
+  en: "English",
+  zh: "简体中文",
+  ja: "日本語", 
+  ko: "한국어",
+  fr: "Français",
+  de: "Deutsch",
+  es: "Español",
+  it: "Italiano",
+  pt: "Português",
+  tr: "Türkçe",
+  pl: "Polski",
+  ru: "Русский",
+  ar: "العربية",
+  hi: "हिन्दी",
+  th: "ไทย",
+  vi: "Tiếng Việt",
+} as const;
+
+export type SupportedLocale = keyof typeof ALL_LOCALE_LABELS;
+
+// Helper function to get language configuration from environment variables
+function getLocaleLabels(locales: string[]) {
+  return Object.fromEntries(
+    locales.map(locale => [
+      locale, 
+      ALL_LOCALE_LABELS[locale as SupportedLocale] || locale
+    ])
+  );
+}
+
+// Common application configuration creation function
+export function createCommonAppConfig(options?: {
+  // Optional: manually specify supported languages, otherwise read from environment variables
+  locales?: string[];
+  defaultLocale?: string;
+}) {
+  // Priority: manual configuration > environment variables > default values
+  const locales = options?.locales ?? 
+                  process.env.NEXT_PUBLIC_I18N_LOCALES?.split(',').map(s => s.trim()) ?? 
+                  ['en', 'zh'];
+  
+  const defaultLocale = options?.defaultLocale ?? 
+                        process.env.NEXT_PUBLIC_I18N_DEFAULT_LOCALE ?? 
+                        'en';
+  
+  const storagePrefix = process.env.NEXT_PUBLIC_I18N_STORAGE_PREFIX || 'WINDRUN-HUAIIN';
+
+  const config = {
+    // Basic configuration
+    baseUrl: process.env.NEXT_PUBLIC_BASE_URL || '',
+    githubBaseUrl: process.env.NEXT_PUBLIC_GITHUB_BASE_URL || '',
+    github: process.env.NEXT_PUBLIC_GITHUB || '',
+    githubInfoToken: process.env.NEXT_PUBLIC_FUMA_GITHUB_TOKEN || '',
+
+    // Internationalization configuration
+    i18n: {
+      locales: locales as readonly string[],
+      defaultLocale,
+      localeLabels: getLocaleLabels(locales),
+      detector: {
+        storageKey: process.env.NEXT_PUBLIC_I18N_STORAGE_KEY || 'language-preference-status',
+        autoCloseTimeout: parseInt(process.env.NEXT_PUBLIC_I18N_AUTO_CLOSE_TIMEOUT || '10000'),
+        expirationDays: parseInt(process.env.NEXT_PUBLIC_I18N_EXPIRATION_DAYS || '30'),
+        storagePrefix
+      },
+      messageRoot: process.env.NEXT_PUBLIC_I18N_MESSAGE_ROOT || 'messages',
+    },
+
+    // Style configuration
+    style: {
+      icon: {
+        uniformColor: process.env.NEXT_PUBLIC_STYLE_ICON_COLOR || "text-purple-500"
+      },
+      showBanner: process.env.NEXT_PUBLIC_STYLE_SHOW_BANNER === 'true',
+      clerkAuthInModal: process.env.NEXT_PUBLIC_STYLE_CLERK_AUTH_IN_MODAL === 'true',
+      clerkPageBanner: process.env.NEXT_PUBLIC_STYLE_CLERK_PAGE_BANNER === 'true',
+      watermark: {
+        enabled: process.env.NEXT_PUBLIC_STYLE_WATERMARK_ENABLED === 'true',
+        text: process.env.NEXT_PUBLIC_STYLE_WATERMARK_TEXT || "巽川·怀因"
+      },
+      cdnBaseUrl: process.env.NEXT_PUBLIC_STYLE_CDN_BASE_URL || "https://raw.githubusercontent.com/caofanCPU/wind-run-1/main/public",
+      placeHolder: {
+        image: process.env.NEXT_PUBLIC_STYLE_PLACEHOLDER_IMAGE || "/default.webp"
+      }
+    },
+
+    // Clerk configuration
+    clerk: {
+      signInUrl: process.env.NEXT_PUBLIC_CLERK_SIGN_IN_URL || "/sign-in",
+      fallbackSignInUrl: process.env.NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL || "/",
+      signUpUrl: process.env.NEXT_PUBLIC_CLERK_SIGN_UP_URL || "/sign-up", 
+      fallbackSignUpUrl: process.env.NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL || "/",
+      waitlistUrl: process.env.NEXT_PUBLIC_CLERK_WAITLIST_URL || "/waitlist",
+      debug: process.env.CLERK_DEBUG === 'true',
+    },
+
+    // MDX source file directory configuration
+    mdxSourceDir: {
+      docs: process.env.NEXT_PUBLIC_MDX_DOCS_DIR || "src/mdx/docs",
+      blog: process.env.NEXT_PUBLIC_MDX_BLOG_DIR || "src/mdx/blog", 
+      legal: process.env.NEXT_PUBLIC_MDX_LEGAL_DIR || "src/mdx/legal"
+    },
+  };
+
+  // Convenient constants - avoid deep nested access
+  const shortcuts = {
+    iconColor: config.style.icon.uniformColor,
+    watermark: config.style.watermark,
+    showBanner: config.style.showBanner,
+    clerkPageBanner: config.style.clerkPageBanner,
+    clerkAuthInModal: config.style.clerkAuthInModal,
+    placeHolderImage: config.style.placeHolder.image,
+    clerk: config.clerk,
+  };
+
+  return {
+    ...config,
+    shortcuts
+  };
+}
+
+// Create internationalization helper functions
+export function createI18nHelpers(i18nConfig: ReturnType<typeof createCommonAppConfig>['i18n']) {
+  function isSupportedLocale(locale: string): locale is typeof i18nConfig.locales[number] {
+    return (i18nConfig.locales as readonly string[]).includes(locale);
+  }
+
+  function getValidLocale(locale: string): typeof i18nConfig.locales[number] {
+    return isSupportedLocale(locale) ? locale : i18nConfig.defaultLocale;
+  }
+
+  const generatedLocales = i18nConfig.locales.map((loc) => ({
+    name: i18nConfig.localeLabels[loc as keyof typeof i18nConfig.localeLabels] || loc,
+    locale: loc,
+  }));
+
+  return {
+    isSupportedLocale,
+    getValidLocale,
+    generatedLocales
+  };
+}
+
+// Convenient configuration presets
+export const LOCALE_PRESETS = {
+  // Only support English
+  EN_ONLY: { locales: ['en'] as string[], defaultLocale: 'en' as string },
+  
+  // English and Chinese
+  EN_ZH: { locales: ['en', 'zh'] as string[], defaultLocale: 'en' as string },
+  
+  // Main Asian languages
+  ASIA: { locales: ['en', 'zh', 'ja', 'ko'] as string[], defaultLocale: 'en' as string },
+  
+  // Main European languages
+  EUROPE: { locales: ['en', 'fr', 'de', 'es', 'it'] as string[], defaultLocale: 'en' as string },
+  
+  // Globalization
+  GLOBAL: { locales: ['en', 'zh', 'ja', 'ko', 'fr', 'de', 'es', 'it', 'pt', 'ru'] as string[], defaultLocale: 'en' as string },
+  
+  // No internationalization (only default language)
+  NONE: { locales: [] as string[], defaultLocale: 'en' as string }
+}; 

package/src/index.ts

@@ -0,0 +1,11 @@
+// export the utility functions
+export * from './utils';
+
+// export the icons
+export * from './limited-lucide-icons';
+
+// export the LLM related functions
+export * from './llm-utils'; 
+
+// export the common app config
+export * from './common-app-config';

package/src/limited-lucide-icons.ts

@@ -0,0 +1,86 @@
+/*
+ * This file re-exports selected icons from 'lucide-react'.
+ * This is the single place to manage which lucide-react icons are available globally.
+ * Editing the list of exports here will automatically update their availability
+ * in globalLucideIcons.
+ */
+export {
+  AlbumIcon,
+  AlignHorizontalJustifyEnd,
+  ArrowLeft,
+  ArrowRight,
+  ArrowUp,
+  Binary,
+  Blocks,
+  BookX,
+  BringToFront,
+  Building2,
+  Bug,
+  Car,
+  Circle,
+  CircleAlert,
+  CircleSmall,
+  Check,
+  ChevronDown,
+  ChevronLeft,
+  ChevronRight,
+  ChevronUp,
+  Cpu,
+  ComponentIcon,
+  DatabaseZap,
+  Dot,
+  Download,
+  Eye,
+  ExternalLink,
+  Facebook,
+  FileLock2,
+  Fingerprint,
+  Gift,
+  GitPullRequestArrow,
+  Globe,
+  GlobeLock,
+  GripVertical,
+  HandHeart,
+  Handshake,
+  Highlighter,
+  HousePlus,
+  Info,
+  ImageDown,
+  ImageOff,
+  ImageUp,
+  Keyboard,
+  LandPlot,
+  Layout,
+  LayoutTemplate,
+  LibraryIcon,
+  Link,
+  Loader2,
+  LogIn,
+  LogOut,
+  MoreHorizontal,
+  MousePointerClick,
+  PanelLeft,
+  PanelsTopLeft,
+  Pencil,
+  Pi,
+  Palette,
+  ReceiptText,
+  Regex,
+  Replace,
+  Rss,
+  Scale,
+  Search,
+  Share,
+  ShieldUser,
+  SquareDashedBottomCode,
+  SquareTerminal,
+  Server,
+  SplinePointer,
+  Sparkles,
+  Star,
+  Tablets,
+  Terminal,
+  Twitter,
+  X,
+  Zap
+} from 'lucide-react'; 

package/src/llm-utils.ts

@@ -0,0 +1,50 @@
+import { remark } from 'remark';
+import remarkGfm from 'remark-gfm';
+import remarkMdx from 'remark-mdx';
+import remarkFrontmatter from 'remark-frontmatter';
+import { visit } from 'unist-util-visit';
+
+function remarkRemoveFrontmatter() {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  return (tree: any) => {
+    visit(tree, 'yaml', (_node, index, parent) => {
+      if (parent && typeof index === 'number') {
+        parent.children.splice(index, 1);
+      }
+    });
+  };
+}
+
+// remark(), parse the MDX file into MDAST
+// remarkPlugins(), parse the MDAST into HAST
+// rehypePlugins(), render the HAST into React components, i.e. HTML code
+const processor = remark()
+  // parse the md file header
+  .use(remarkFrontmatter, ['yaml'])
+  // remove the md file header
+  .use(remarkRemoveFrontmatter)
+  .use(remarkMdx)
+  .use(remarkGfm);
+
+export async function getLLMText(mdxContent: string, title?: string, description?: string) {
+  if (typeof mdxContent !== 'string') {
+    console.error('getLLMText: mdxContent received was not a string. Type:', typeof mdxContent);
+    return `# Error\n\nInvalid content received by text processor.`;
+  }
+
+  try {
+    const processed = await processor.process(mdxContent);
+    const contentWithoutFrontmatter = processed.value as string;
+
+    const markdownParts = [
+      title ? `# ${title}` : null,
+      description,
+      contentWithoutFrontmatter.trim()
+    ];
+
+    return markdownParts.filter(part => part != null).join('\n\n');
+  } catch (processingError) {
+    console.error('Error during remark processing in getLLMText:', processingError);
+    return `# Error\n\nError processing MDX content.`;
+  }
+} 

package/src/utils.ts

@@ -0,0 +1,37 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+import { format, isValid } from 'date-fns';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}
+
+export function formatTimestamp(timestamp: string, formatter: string) {
+  const fail = "";
+  if (!timestamp) {
+    return fail;
+  }
+
+  // Assume gitTimestamp is a millisecond timestamp string
+  const timestampMs = parseInt(timestamp, 10);
+  if (isNaN(timestampMs)) {
+     return fail;
+  }
+
+  const date = new Date(timestampMs); // or if it is determined to be seconds, use fromUnixTime(timestampSeconds)
+
+  // Check if the date is valid
+  if (!isValid(date)) {
+    return fail;
+  }
+
+  // Format the date
+  try {
+     // 'yyyy-MM-dd HH:mm:ss' is the date-fns formatting pattern
+     return format(date, formatter);
+  } catch (error) {
+     // format may also throw an error due to an invalid date (although isValid should have already caught it)
+     console.error("Error formatting date:", error);
+     return fail;
+  }
+}