@lokascript/i18n 1.1.0 → 1.1.2

package/dist/dictionaries/index.d.cts

@@ -0,0 +1,203 @@
+import { D as Dictionary, c as DictionaryCategory } from '../types-naTJIIaT.cjs';
+
+/**
+ * Dictionary Derivation from Semantic Profiles
+ *
+ * Creates Dictionary objects from LanguageProfile keywords,
+ * eliminating keyword duplication between packages.
+ *
+ * The semantic profile is the single source of truth for keyword translations.
+ * This adapter extracts the `primary` value from each KeywordTranslation.
+ */
+
+/**
+ * KeywordTranslation interface (matches @lokascript/semantic)
+ */
+interface KeywordTranslation {
+    readonly primary: string;
+    readonly alternatives?: string[];
+    readonly normalized?: string;
+}
+/**
+ * LanguageProfile interface (subset needed for derivation)
+ */
+interface LanguageProfile {
+    readonly code: string;
+    readonly keywords: Record<string, KeywordTranslation>;
+    readonly references?: Record<string, string>;
+}
+/**
+ * Options for dictionary derivation.
+ */
+interface DeriveOptions {
+    /**
+     * Override specific categories with custom values.
+     * Useful for categories not fully covered by the profile.
+     */
+    overrides?: Partial<Dictionary>;
+    /**
+     * Whether to include English fallbacks for missing entries.
+     * Default: true
+     */
+    includeFallbacks?: boolean;
+}
+/**
+ * Derive a Dictionary from a LanguageProfile.
+ *
+ * This is the main adapter function that creates dictionaries from
+ * semantic profiles, eliminating keyword duplication.
+ *
+ * @param profile - The language profile to derive from
+ * @param options - Derivation options
+ * @returns A complete Dictionary object
+ *
+ * @example
+ * ```typescript
+ * import { japaneseProfile } from '@lokascript/semantic';
+ * import { deriveFromProfile } from './derive';
+ *
+ * export const ja = deriveFromProfile(japaneseProfile);
+ * ```
+ */
+declare function deriveFromProfile(profile: LanguageProfile, options?: DeriveOptions): Dictionary;
+/**
+ * Create an English dictionary (identity mapping).
+ * Special case since English keywords map to themselves.
+ */
+declare function createEnglishDictionary(): Dictionary;
+/**
+ * Compare a derived dictionary against an original to find missing entries.
+ * Useful for validating that derivation is complete.
+ */
+declare function validateDictionary(derived: Dictionary, original: Dictionary): {
+    missing: Record<DictionaryCategory, string[]>;
+    coverage: number;
+};
+
+/**
+ * Dictionary Index
+ *
+ * Exports dictionaries for all supported languages.
+ *
+ * Strategy: Dictionaries are derived from semantic profiles where possible,
+ * with fallbacks to manual definitions for categories not in profiles
+ * (events, temporal, some values, attributes).
+ *
+ * The semantic package's language profiles are the single source of truth
+ * for command/modifier/logical keyword translations.
+ *
+ * TRANSITION NOTE: Currently using full legacy overrides to preserve
+ * backward compatibility. Once profiles and dictionaries are synchronized,
+ * the legacy overrides can be reduced to only non-profile categories.
+ */
+
+/**
+ * English dictionary - uses legacy values for full compatibility.
+ */
+declare const en: Dictionary;
+/**
+ * Spanish dictionary - legacy overrides for compatibility.
+ */
+declare const es: Dictionary;
+/**
+ * Japanese dictionary - legacy overrides for compatibility.
+ */
+declare const ja: Dictionary;
+/**
+ * Korean dictionary - legacy overrides for compatibility.
+ */
+declare const ko: Dictionary;
+/**
+ * Chinese dictionary - legacy overrides for compatibility.
+ */
+declare const zh: Dictionary;
+/**
+ * French dictionary - legacy overrides for compatibility.
+ */
+declare const fr: Dictionary;
+/**
+ * German dictionary - legacy overrides for compatibility.
+ */
+declare const de: Dictionary;
+/**
+ * Arabic dictionary - legacy overrides for compatibility.
+ */
+declare const ar: Dictionary;
+/**
+ * Turkish dictionary - legacy overrides for compatibility.
+ */
+declare const tr: Dictionary;
+/**
+ * Indonesian dictionary - legacy overrides for compatibility.
+ */
+declare const id: Dictionary;
+/**
+ * Portuguese dictionary - legacy overrides for compatibility.
+ */
+declare const pt: Dictionary;
+/**
+ * Quechua dictionary - legacy overrides for compatibility.
+ */
+declare const qu: Dictionary;
+/**
+ * Swahili dictionary - legacy overrides for compatibility.
+ */
+declare const sw: Dictionary;
+/**
+ * Italian dictionary - legacy overrides for compatibility.
+ */
+declare const it: Dictionary;
+/**
+ * Vietnamese dictionary - legacy overrides for compatibility.
+ */
+declare const vi: Dictionary;
+/**
+ * Polish dictionary - legacy overrides for compatibility.
+ */
+declare const pl: Dictionary;
+/**
+ * Russian dictionary - legacy overrides for compatibility.
+ */
+declare const ru: Dictionary;
+/**
+ * Ukrainian dictionary - legacy overrides for compatibility.
+ */
+declare const uk: Dictionary;
+/**
+ * Hindi dictionary - legacy overrides for compatibility.
+ */
+declare const hi: Dictionary;
+/**
+ * Bengali dictionary - legacy overrides for compatibility.
+ */
+declare const bn: Dictionary;
+/**
+ * Thai dictionary - legacy overrides for compatibility.
+ */
+declare const th: Dictionary;
+/**
+ * Malay dictionary - legacy overrides for compatibility.
+ */
+declare const ms: Dictionary;
+/**
+ * Tagalog dictionary - legacy overrides for compatibility.
+ */
+declare const tl: Dictionary;
+/**
+ * All available dictionaries indexed by locale code.
+ */
+declare const dictionaries: Record<string, Dictionary>;
+/**
+ * Get all supported locale codes.
+ */
+declare const supportedLocales: string[];
+/**
+ * Check if a locale is supported.
+ */
+declare const isLocaleSupported: (locale: string) => boolean;
+/**
+ * Get dictionary with fallback to another locale.
+ */
+declare const getDictionary: (locale: string, fallback?: string) => Dictionary | null;
+
+export { ar, bn, createEnglishDictionary, de, deriveFromProfile, dictionaries, en, es, fr, getDictionary, hi, id, isLocaleSupported, it, ja, ko, ms, pl, pt, qu, ru, supportedLocales, sw, th, tl, tr, uk, validateDictionary, vi, zh };

package/dist/dictionaries/index.d.ts

@@ -0,0 +1,203 @@
+import { D as Dictionary, c as DictionaryCategory } from '../types-naTJIIaT.js';
+
+/**
+ * Dictionary Derivation from Semantic Profiles
+ *
+ * Creates Dictionary objects from LanguageProfile keywords,
+ * eliminating keyword duplication between packages.
+ *
+ * The semantic profile is the single source of truth for keyword translations.
+ * This adapter extracts the `primary` value from each KeywordTranslation.
+ */
+
+/**
+ * KeywordTranslation interface (matches @lokascript/semantic)
+ */
+interface KeywordTranslation {
+    readonly primary: string;
+    readonly alternatives?: string[];
+    readonly normalized?: string;
+}
+/**
+ * LanguageProfile interface (subset needed for derivation)
+ */
+interface LanguageProfile {
+    readonly code: string;
+    readonly keywords: Record<string, KeywordTranslation>;
+    readonly references?: Record<string, string>;
+}
+/**
+ * Options for dictionary derivation.
+ */
+interface DeriveOptions {
+    /**
+     * Override specific categories with custom values.
+     * Useful for categories not fully covered by the profile.
+     */
+    overrides?: Partial<Dictionary>;
+    /**
+     * Whether to include English fallbacks for missing entries.
+     * Default: true
+     */
+    includeFallbacks?: boolean;
+}
+/**
+ * Derive a Dictionary from a LanguageProfile.
+ *
+ * This is the main adapter function that creates dictionaries from
+ * semantic profiles, eliminating keyword duplication.
+ *
+ * @param profile - The language profile to derive from
+ * @param options - Derivation options
+ * @returns A complete Dictionary object
+ *
+ * @example
+ * ```typescript
+ * import { japaneseProfile } from '@lokascript/semantic';
+ * import { deriveFromProfile } from './derive';
+ *
+ * export const ja = deriveFromProfile(japaneseProfile);
+ * ```
+ */
+declare function deriveFromProfile(profile: LanguageProfile, options?: DeriveOptions): Dictionary;
+/**
+ * Create an English dictionary (identity mapping).
+ * Special case since English keywords map to themselves.
+ */
+declare function createEnglishDictionary(): Dictionary;
+/**
+ * Compare a derived dictionary against an original to find missing entries.
+ * Useful for validating that derivation is complete.
+ */
+declare function validateDictionary(derived: Dictionary, original: Dictionary): {
+    missing: Record<DictionaryCategory, string[]>;
+    coverage: number;
+};
+
+/**
+ * Dictionary Index
+ *
+ * Exports dictionaries for all supported languages.
+ *
+ * Strategy: Dictionaries are derived from semantic profiles where possible,
+ * with fallbacks to manual definitions for categories not in profiles
+ * (events, temporal, some values, attributes).
+ *
+ * The semantic package's language profiles are the single source of truth
+ * for command/modifier/logical keyword translations.
+ *
+ * TRANSITION NOTE: Currently using full legacy overrides to preserve
+ * backward compatibility. Once profiles and dictionaries are synchronized,
+ * the legacy overrides can be reduced to only non-profile categories.
+ */
+
+/**
+ * English dictionary - uses legacy values for full compatibility.
+ */
+declare const en: Dictionary;
+/**
+ * Spanish dictionary - legacy overrides for compatibility.
+ */
+declare const es: Dictionary;
+/**
+ * Japanese dictionary - legacy overrides for compatibility.
+ */
+declare const ja: Dictionary;
+/**
+ * Korean dictionary - legacy overrides for compatibility.
+ */
+declare const ko: Dictionary;
+/**
+ * Chinese dictionary - legacy overrides for compatibility.
+ */
+declare const zh: Dictionary;
+/**
+ * French dictionary - legacy overrides for compatibility.
+ */
+declare const fr: Dictionary;
+/**
+ * German dictionary - legacy overrides for compatibility.
+ */
+declare const de: Dictionary;
+/**
+ * Arabic dictionary - legacy overrides for compatibility.
+ */
+declare const ar: Dictionary;
+/**
+ * Turkish dictionary - legacy overrides for compatibility.
+ */
+declare const tr: Dictionary;
+/**
+ * Indonesian dictionary - legacy overrides for compatibility.
+ */
+declare const id: Dictionary;
+/**
+ * Portuguese dictionary - legacy overrides for compatibility.
+ */
+declare const pt: Dictionary;
+/**
+ * Quechua dictionary - legacy overrides for compatibility.
+ */
+declare const qu: Dictionary;
+/**
+ * Swahili dictionary - legacy overrides for compatibility.
+ */
+declare const sw: Dictionary;
+/**
+ * Italian dictionary - legacy overrides for compatibility.
+ */
+declare const it: Dictionary;
+/**
+ * Vietnamese dictionary - legacy overrides for compatibility.
+ */
+declare const vi: Dictionary;
+/**
+ * Polish dictionary - legacy overrides for compatibility.
+ */
+declare const pl: Dictionary;
+/**
+ * Russian dictionary - legacy overrides for compatibility.
+ */
+declare const ru: Dictionary;
+/**
+ * Ukrainian dictionary - legacy overrides for compatibility.
+ */
+declare const uk: Dictionary;
+/**
+ * Hindi dictionary - legacy overrides for compatibility.
+ */
+declare const hi: Dictionary;
+/**
+ * Bengali dictionary - legacy overrides for compatibility.
+ */
+declare const bn: Dictionary;
+/**
+ * Thai dictionary - legacy overrides for compatibility.
+ */
+declare const th: Dictionary;
+/**
+ * Malay dictionary - legacy overrides for compatibility.
+ */
+declare const ms: Dictionary;
+/**
+ * Tagalog dictionary - legacy overrides for compatibility.
+ */
+declare const tl: Dictionary;
+/**
+ * All available dictionaries indexed by locale code.
+ */
+declare const dictionaries: Record<string, Dictionary>;
+/**
+ * Get all supported locale codes.
+ */
+declare const supportedLocales: string[];
+/**
+ * Check if a locale is supported.
+ */
+declare const isLocaleSupported: (locale: string) => boolean;
+/**
+ * Get dictionary with fallback to another locale.
+ */
+declare const getDictionary: (locale: string, fallback?: string) => Dictionary | null;
+
+export { ar, bn, createEnglishDictionary, de, deriveFromProfile, dictionaries, en, es, fr, getDictionary, hi, id, isLocaleSupported, it, ja, ko, ms, pl, pt, qu, ru, supportedLocales, sw, th, tl, tr, uk, validateDictionary, vi, zh };