// types/schema.ts

export type I18nString = string | Record<string, string>;

// Examples:
const simple = "First Name";                    // Shorthand for { en: "First Name" }
const translated = { 
  en: "First Name", 
  es: "Nombre", 
  zh: "名字" 
};

import { getLocalizedString } from "@/types/schema";

// Returns "Nombre" for Spanish, falls back to English if missing
const label = getLocalizedString(field.label, "es");

// lib/i18n.ts

interface I18nDictionary {
  ui: {
    submit: string;
    next: string;
    back: string;
    save: string;
    cancel: string;
    // ... more UI strings
  };
  errors: {
    required: string;
    invalidEmail: string;
    // ... validation messages
  };
  placeholders: {
    email: string;
    phone: string;
    // ... input placeholders
  };
}

type LocalizedDictionary = Record<string, I18nDictionary>;

# Get from: DeepL Dashboard → Account → API Keys
DEEPL_API_KEY=your-api-key:fx

// app/actions/translate.ts

// Auto-translate global dictionary
export async function autoTranslateDictionary(targetLanguage: string): Promise<{
  success: boolean;
  count?: number;
  error?: string;
}>;

// Translate individual content
export async function translateContent(
  text: string,
  targetLanguages: string[]
): Promise<Record<string, string | null>>;

import { translateContent } from "@/app/actions/translate";

// Translate "Hello" to Spanish and Chinese
const result = await translateContent("Hello", ["es", "zh"]);
// Result: { es: "Hola", zh: "你好" }

// Without API key:
translateContent("Hello", ["es"]);
// Returns: { es: "[ES] Hello" }

// lib/form-translation-utils.ts

interface FlattenedTranslationRow {
  id: string;           // Unique row ID
  pageId: string;       // Page this belongs to
  pageTitle: string;    // Page display name
  key: string;          // Property key (label, helpText, etc.)
  displayLabel: string; // Human-readable label
  path: string;         // JSON path to the property
  translations: Record<string, string>;
}

// Flatten a form schema
const rows = flattenFormSchema(schema);

// Apply translations back
const updatedSchema = applyTranslationsToSchema(schema, updatedRows);

export const SUPPORTED_LANGUAGES = [
  { code: "en", name: "English", deepl: true },
  { code: "es", name: "Spanish", deepl: true },
  { code: "so", name: "Somali", deepl: false },
  // Add more languages here
];

// app/actions/translate.ts

const DEEPL_LANGUAGE_MAP: Record<string, string> = {
  en: "en-US",
  pt: "pt-BR",
  zh: "zh-HANS",
  // Add mappings for regional variants
};