// Whitelist of Nitro client localization files exposed in
// /admin/translations/client. The registry doubles as a path-traversal guard
// for the saveClientTranslations server action: only `id`s defined here can be
// written to.

export type ClientTranslationFormat = 'json5' | 'json'

export interface ClientTranslationFile {
  id: string
  /** Path relative to the project root. */
  relPath: string
  format: ClientTranslationFormat
  language: 'it' | 'en' | 'shared'
  readOnly: boolean
  /**
   * True when the on-disk file commonly contains comments that the json5
   * serializer cannot preserve. Used to surface a warning in the UI.
   */
  hasComments: boolean
  /** Free-form note shown in the UI (e.g. why a file is read-only). */
  note?: string
}

export const CLIENT_TRANSLATION_FILES: ClientTranslationFile[] = [
  {
    id: 'ui-texts-it',
    relPath: 'public/nitro-assets/config/UITexts.json5',
    format: 'json5',
    language: 'it',
    readOnly: false,
    hasComments: true,
    note: 'Override del client (sovrascrive ExternalTexts).',
  },
  {
    id: 'ui-texts-en',
    relPath: 'public/nitro-assets/config/UITexts_en.json5',
    format: 'json5',
    language: 'en',
    readOnly: true,
    hasComments: true,
    note: 'Riferimento EN — non viene caricato dal client.',
  },
  {
    id: 'external-texts',
    relPath: 'public/nitro-assets/config/ExternalTexts.json5',
    format: 'json5',
    language: 'shared',
    readOnly: false,
    hasComments: false,
  },
  {
    id: 'external-texts-badges',
    relPath: 'public/nitro-assets/config/ExternalTexts_Badges.json5',
    format: 'json5',
    language: 'shared',
    readOnly: false,
    hasComments: false,
    note: 'File grande (~30k voci): usa la ricerca.',
  },
  {
    id: 'catalog-texts',
    relPath: 'public/nitro-assets/config/CatalogTexts.json5',
    format: 'json5',
    language: 'shared',
    readOnly: false,
    hasComments: false,
  },
  {
    id: 'gamedata-external-texts',
    relPath: 'public/nitro-assets/gamedata/ExternalTexts.json',
    format: 'json',
    language: 'shared',
    readOnly: true,
    hasComments: false,
    note: 'Copia "live" servita al client. Generata dal build, modifiche manuali sovrascritte.',
  },
  {
    id: 'badge-texts-en',
    relPath: 'public/nitro3/localization/badge-texts-en.json',
    format: 'json',
    language: 'en',
    readOnly: false,
    hasComments: false,
  },
  {
    id: 'badge-texts-it',
    relPath: 'public/nitro3/localization/badge-texts-it.json',
    format: 'json',
    language: 'it',
    readOnly: false,
    hasComments: false,
  },
]

export function getClientTranslationFile(id: string): ClientTranslationFile | undefined {
  return CLIENT_TRANSLATION_FILES.find((f) => f.id === id)
}