@almadar/core 10.84.0 → 10.86.0

package/dist/i18n/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Internationalization (i18n) — vocabulary tables for the `.lolo`/`.orb`
+ * language (English, Arabic, Slovenian). See `Almadar_i18n.md` / the i18n
+ * program plan for the section contract; this module is the JS-path owner.
+ *
+ * @packageDocumentation
+ */
+type LanguageCode = 'en' | 'ar' | 'sl';
+declare const LANGUAGE_CODES: readonly LanguageCode[];
+declare const I18N_SECTIONS: readonly ["keywords", "shapes", "tags", "categories", "capabilities", "annotations", "sigils", "effects", "types", "units", "literals", "reservedEvents", "orb"];
+type I18nSection = typeof I18N_SECTIONS[number];
+interface I18nMeta {
+    code: LanguageCode;
+    name: string;
+    rtl: boolean;
+}
+type I18nTables = {
+    meta: I18nMeta;
+} & Record<I18nSection, Record<string, string>>;
+/** Supplied by the caller (@almadar/std) — core must not import std. */
+interface OperatorTables {
+    operators: Record<string, string>;
+}
+/** Validating loader — the one owner of the table shape; every reader (core, pattern-sync) goes through it. */
+declare function parseI18nTables(raw: unknown, source: string): I18nTables;
+declare function parseOperatorTables(raw: unknown, source: string): OperatorTables;
+declare const coreTables: Record<LanguageCode, I18nTables>;
+declare function getVocabulary(lang: LanguageCode): I18nTables;
+/** Native → English map for one section family; operators come from the caller (std). */
+declare function aliasMap(lang: LanguageCode, section: I18nSection | 'operators', operators?: OperatorTables): ReadonlyMap<string, string>;
+/** The token equals exactly one language's `keywords.app` value. */
+/** The keywords that can legally open a `.lolo` program (top-level structure, LOLO.md §3). */
+declare const LOLO_FIRST_TOKEN_KEYWORDS: readonly ["app", "uses", "expects", "type", "theme", "orbital"];
+/** A `.lolo` program's language: its first token is one language's translation of a first-token keyword. */
+declare function languageOfLoloFirstToken(token: string): LanguageCode | undefined;
+/** A top-level `.orb` key equals exactly one language's `orb.orbitals` value. */
+declare function languageOfOrbTopLevelKeys(keys: readonly string[]): LanguageCode | undefined;
+type I18nProblemKind = 'missing' | 'orphan' | 'empty' | 'inconsistent' | 'collision' | 'selector-not-unique' | 'operators-mismatch' | 'identical-to-english';
+interface I18nProblem {
+    lang: LanguageCode;
+    section: string;
+    kind: I18nProblemKind;
+    key: string;
+    detail?: string;
+}
+interface I18nCoverageInput {
+    core: Record<LanguageCode, I18nTables>;
+    std?: Record<LanguageCode, OperatorTables>;
+    canonicalOperators?: readonly string[];
+}
+/**
+ * The one implementation of the i18n coverage rules (plan B1):
+ * missing/orphan/empty key sets, cross-section translation consistency,
+ * native-value collisions (within a section, and across effects∪operators),
+ * unique language-selector translations, and operator-set parity.
+ * Never truncates — returns every problem found.
+ */
+declare function checkI18nCoverage(input: I18nCoverageInput): {
+    ok: boolean;
+    problems: I18nProblem[];
+};
+/**
+ * Informational only — NOT part of the coverage gate (Slovenian legitimately
+ * carries loanwords identical to English). Lists native values equal to the
+ * English value, for a human to spot-check.
+ */
+declare function reportIdenticalToEnglish(input: I18nCoverageInput): I18nProblem[];
+
+export { I18N_SECTIONS, type I18nCoverageInput, type I18nMeta, type I18nProblem, type I18nProblemKind, type I18nSection, type I18nTables, LANGUAGE_CODES, LOLO_FIRST_TOKEN_KEYWORDS, type LanguageCode, type OperatorTables, aliasMap, checkI18nCoverage, coreTables, getVocabulary, languageOfLoloFirstToken, languageOfOrbTopLevelKeys, parseI18nTables, parseOperatorTables, reportIdenticalToEnglish };