Update documentation

Author: johnsamuelwrites

docs/content/en/reference/builtins.md

@@ -5,12 +5,12 @@ title: Built-in Aliases
 path_segments:
 - reference
 - builtins
-source_hash: 3b6205ba8915
+source_hash: 2cea4d177e8d
 status: source
 permalink: /en/docs/reference/builtins/
 ---
 
-multilingual provides localized aliases for 41 commonly used Python built-in functions. Universal English names are **always available** in all languages — aliases are additive.
+multilingual provides localized aliases for 75 Python built-in functions. Universal English names are **always available** in all languages — aliases are additive.
 
 ---
 
@@ -111,6 +111,8 @@ print(range(5))            # Universal still works
 | `next` | suivant | siguiente | naechster | 次 | التالي | अगला | 下一个 |
 | `any` | quelconque | cualquiera | irgendein | どれか | أي | कोई | 任意 |
 | `all` | tous | todos | alle | すべて | كل | सब | 所有 |
+| `aiter` | iterasync | iterasync | asynciter | 非同期イテレータ | مكرر\_غير\_متزامن | असिंकइटर | 异步迭代器 |
+| `anext` | prochainasync | siguienteasync | asyncnaechstes | 非同期次 | التالي\_غير\_المتزامن | असिंकअगला | 异步下一个 |
 
 ### String/Encoding
 
@@ -120,6 +122,35 @@ print(range(5))            # Universal still works
 | `ord` | ord | ord | ord | 文字コード | رمز\_حرف | कोड | 编码 |
 | `format` | formater | formatear | formatieren | フォーマット | تنسيق | प्रारूप | 格式化 |
 
+### Execution
+
+| Builtin | fr | es | de | ja | ar | hi | zh |
+|---------|----|----|----|----|----|----|-----|
+| `eval` | evaluer | evaluar | auswerten | 評価 | تقييم | मूल्यांकन | 评估 |
+| `exec` | executer | ejecutar | ausfuehren | 実行 | تنفيذ | निष्पादन | 执行 |
+| `compile` | compiler | compilar | kompilieren | コンパイル | تجميع | संकलन | 编译 |
+
+### Scope Inspection
+
+| Builtin | fr | es | de | ja | ar | hi | zh |
+|---------|----|----|----|----|----|----|-----|
+| `globals` | globaux | globales | globale | グローバル変数 | عالمي | वैश्विक | 全局变量 |
+| `locals` | locaux | locales | lokale | ローカル変数 | محلي | स्थानीय | 局部变量 |
+| `vars` | variables | variables | variablen | 変数 | متغيرات | चर | 变量 |
+
+### Debug & REPL
+
+| Builtin | fr | es | de | ja | ar | hi | zh |
+|---------|----|----|----|----|----|----|-----|
+| `help` | aide | ayuda | hilfe | ヘルプ | مساعدة | सहायता | 帮助 |
+| `breakpoint` | pointdarret | puntodeparada | haltepunkt | ブレークポイント | نقطة\_توقف | विरामबिंदु | 断点 |
+| `memoryview` | vuememoire | vistamemoria | speicheransicht | メモリビュー | عرض\_الذاكرة | मेमोरीदृश्य | 内存视图 |
+| `exit` | quitter | salir | beenden | 終了 | خروج | बाहर | 退出 |
+| `quit` | fermer | terminar | abbrechen | 終わり | انهاء | समाप्त | 停止 |
+| `copyright` | droitsauteur | derechosautor | urheberrecht | 著作権 | حقوق\_النشر | कॉपीराइट | 版权 |
+| `credits` | remerciements | creditos | danksagungen | クレジット | اعتمادات | श्रेय | 致谢 |
+| `license` | licence | licencia | lizenz | ライセンス | رخصة | लाइसेंस | 许可证 |
+
 ---
 
 ## Checking Available Aliases

docs/content/en/reference/compatibility.md

@@ -5,15 +5,15 @@ title: Compatibility Matrix
 path_segments:
 - reference
 - compatibility
-source_hash: 5200c7a76a88
+source_hash: 2cea4d177e8d
 status: source
 permalink: /en/docs/reference/compatibility/
 ---
 
 This matrix defines the current compatibility baseline for `multilingual`. The source of truth is:
 
 - `examples/complete_features_en.ml` and equivalents in all 17 languages
-- `tests/` (~1,797 tests across 58 test files)
+- `tests/` (~1,924 tests across 63 test files)
 
 **Target runtime**: CPython 3.12.x
 
@@ -76,6 +76,9 @@ This matrix defines the current compatibility baseline for `multilingual`. The s
 | Tuples | ✅ | literals, unpacking |
 | Strings | ✅ | single/double/triple quotes, f-strings |
 | F-string format specs | ✅ | `f"{x:.2f}"`, `f"{x!r}"`, `f"{x!s}"`, `f"{x!a}"` |
+| Bytes literals | ✅ | `b"..."`, `B"..."`, triple-quoted `b"""..."""` |
+| Raw strings | ✅ | `r"..."`, `R"..."`, triple-quoted `r"""..."""` — no escape processing |
+| Raw bytes | ✅ | `rb"..."`, `br"..."` and all case variants |
 | Hex/octal/binary literals | ✅ | `0xFF`, `0o77`, `0b1010` |
 | Scientific notation | ✅ | `1.5e10` |
 
@@ -168,7 +171,7 @@ This matrix defines the current compatibility baseline for `multilingual`. The s
 | Universal built-in functions | ✅ 70+ available | `len`, `range`, `abs`, `pow`, `divmod`, `complex`, `format`, `ascii`, `compile`, `eval`, `exec`, `globals`, `locals`, `issubclass`, `delattr`, `slice`, `aiter`, `anext`, and more |
 | Exception types | ✅ 45+ | `BaseException`, `ValueError`, `TypeError`, `KeyError`, `ModuleNotFoundError`, `ExceptionGroup`, `BaseExceptionGroup`, all warnings, and more |
 | Special values | ✅ | `True`, `False`, `None`, `Ellipsis`, `NotImplemented` |
-| Localized built-in aliases | ✅ 41 concepts | 41 builtins with aliases in all 16 non-English languages |
+| Localized built-in aliases | ✅ 75 concepts | 75 builtins with aliases in all 16 non-English languages |
 | Canonical Python built-in names | ✅ | Always usable in all languages |
 
 ---
@@ -188,7 +191,7 @@ SOV and RTL languages can use natural word order. The surface normalizer rewrite
 
 ## Test Coverage
 
-~1,797 tests across 58 test files (~19,848 lines of test code):
+~1,924 tests across 63 test files:
 
 | Test area | Files | Description |
 |-----------|-------|-------------|
@@ -214,19 +217,24 @@ The following are **not** claimed as universally compatible:
 - Full behavioral parity with all CPython edge cases
 - Full third-party package/runtime ecosystem compatibility
 - Every advanced metaprogramming/introspection scenario
-- Complete localization aliases for all CPython built-in functions (41 of 70+ have aliases)
-- Starred unpacking in deeply nested expression contexts
-- Complex decorator chains with arguments
+- WAT `@property` setter/deleter protocol (getter fully supported; `@prop.setter` not yet lowered)
+- WAT `print` `file=` keyword argument (stdout is the only target in WAT)
 
 ---
 
-## Known Fixes (v0.5.x)
+## Known Fixes
 
 | Version | Fix |
 |---------|-----|
+| v0.6.0 | **100% Python 3.12 core syntax**: bytes literals (`b"..."`), raw strings (`r"..."`), raw bytes (`rb"..."`) fully supported in lexer, parser, and both code generators |
+| v0.6.0 | Localized aliases expanded from 41 → 75: `eval`, `exec`, `compile`, `globals`, `locals`, `vars`, `help`, `memoryview`, `breakpoint`, `aiter`, `anext`, `exit`, `quit`, `copyright`, `credits`, `license` added across all 16 non-English languages |
+| v0.6.0 | WAT `@property` getter: `obj.attr` now emits a WAT function call to the getter instead of a raw `f64.load` |
+| v0.6.0 | WAT `@staticmethod` / `@classmethod`: detected via decorator; call sites no longer push an implicit `self` |
+| v0.6.0 | WAT `print` `sep=` / `end=`: custom separator and terminator interned in the data section and printed via `$print_str`; `sep=""` / `end=""` suppress output |
+| v0.6.0 | WAT dynamic dispatch: type tag (class ID) stored 8 bytes before each stateful object; `$__dispatch_method` switch function generated for every overridden method; function parameters of unknown type now dispatch polymorphically at runtime |
 | v0.5.1 | Documentation updates |
 | v0.5.0 | WAT/WASM OOP object model: class lowering with linear-memory bump allocator, inheritance with C3 MRO, `super()` resolution, WAT execution tests |
-| v0.5.0 | SemanticAnalyzer: plain assignments (`x = 5`) now correctly define the variable in scope rather than triggering a false `UNDEFINED_NAME` error (was a false-positive in some languages, e.g., French) |
+| v0.5.0 | SemanticAnalyzer: plain assignments (`x = 5`) now correctly define the variable in scope |
 | v0.5.0 | Augmented assignment (`x += 1`) now correctly reports `UNDEFINED_NAME` when the target variable has not been previously defined |
 
 ---

docs/content/fr/references/compatibilite.md

@@ -5,15 +5,15 @@ title: Compatibilité
 path_segments:
 - references
 - compatibilite
-source_hash: 5200c7a76a88
+source_hash: 2cea4d177e8d
 status: translated
 permalink: /fr/docs/references/compatibilite/
 ---
 
 Cette matrice décrit l'état actuel de compatibilité de `multilingual`. La source de vérité repose sur :
 
 - `examples/complete_features_en.ml` et ses équivalents dans les 17 langues
-- `tests/` (environ 1 797 tests répartis sur 58 fichiers de test)
+- `tests/` (environ 1 924 tests répartis sur 63 fichiers de test)
 
 **Runtime cible** : CPython 3.12.x
 
@@ -76,6 +76,9 @@ Cette matrice décrit l'état actuel de compatibilité de `multilingual`. La sou
 | Tuples | ✅ | littéraux, dépaquetage |
 | Chaînes | ✅ | guillemets simples, doubles, triples, f-strings |
 | Spécificateurs de format f-string | ✅ | `f"{x:.2f}"`, `f"{x!r}"`, `f"{x!s}"`, `f"{x!a}"` |
+| Littéraux d'octets | ✅ | `b"..."`, `B"..."`, `b"""..."""` |
+| Chaînes brutes | ✅ | `r"..."`, `R"..."`, `r"""..."""` — sans traitement des séquences d'échappement |
+| Octets bruts | ✅ | `rb"..."`, `br"..."` et toutes les variantes de casse |
 | Littéraux hexadécimaux, octaux et binaires | ✅ | `0xFF`, `0o77`, `0b1010` |
 | Notation scientifique | ✅ | `1.5e10` |
 
@@ -168,7 +171,7 @@ Cette matrice décrit l'état actuel de compatibilité de `multilingual`. La sou
 | Fonctions built-in universelles | ✅ 70+ disponibles | `len`, `range`, `abs`, `pow`, `divmod`, `complex`, `format`, `ascii`, `compile`, `eval`, `exec`, `globals`, `locals`, `issubclass`, `delattr`, `slice`, `aiter`, `anext`, etc. |
 | Types d'exceptions | ✅ 45+ | `BaseException`, `ValueError`, `TypeError`, `KeyError`, `ModuleNotFoundError`, `ExceptionGroup`, `BaseExceptionGroup`, tous les warnings, etc. |
 | Valeurs spéciales | ✅ | `True`, `False`, `None`, `Ellipsis`, `NotImplemented` |
-| Alias built-in localisés | ✅ 41 concepts | 41 builtins avec alias dans les 16 langues non anglaises |
+| Alias built-in localisés | ✅ 75 concepts | 75 builtins avec alias dans les 16 langues non anglaises |
 | Noms built-in Python canoniques | ✅ | Toujours utilisables dans toutes les langues |
 
 ---
@@ -188,7 +191,7 @@ Les langues SOV et RTL peuvent utiliser un ordre de mots naturel. Le normaliseur
 
 ## Couverture de tests
 
-Environ 1 797 tests répartis sur 58 fichiers de test :
+Environ 1 924 tests répartis sur 63 fichiers de test :
 
 | Domaine | Fichiers | Description |
 |-----------|-------|-------------|
@@ -214,16 +217,21 @@ Les points suivants **ne sont pas** annoncés comme universellement compatibles
 - Une parité comportementale complète avec tous les cas limites de CPython
 - Une compatibilité complète avec tous les écosystèmes tiers
 - Tous les scénarios avancés de métaprogrammation / introspection
-- Des alias localisés pour l'intégralité des builtins CPython
-- Le dépaquetage étoilé dans certains contextes d'expressions très imbriqués
-- Certaines chaînes complexes de décorateurs avec arguments
+- Le protocole setter/deleter de `@property` en WAT (le getter est entièrement pris en charge ; `@prop.setter` n'est pas encore abaissé)
+- L'argument nommé `file=` de `print` en WAT (seul stdout est disponible en WAT)
 
 ---
 
-## Correctifs connus (v0.5.x)
+## Correctifs connus
 
 | Version | Correctif |
 |---------|-----|
+| v0.6.0 | **Compatibilité Python 3.12 à 100 %** : littéraux d'octets (`b"..."`), chaînes brutes (`r"..."`), octets bruts (`rb"..."`) entièrement pris en charge dans le lexer, le parser et les deux générateurs de code |
+| v0.6.0 | Alias localisés élargis de 41 → 75 : `eval`, `exec`, `compile`, `globals`, `locals`, `vars`, `help`, `memoryview`, `breakpoint`, `aiter`, `anext`, `exit`, `quit`, `copyright`, `credits`, `license` ajoutés dans les 16 langues non anglaises |
+| v0.6.0 | WAT `@property` getter : `obj.attr` émet désormais un appel de fonction WAT vers le getter au lieu d'un `f64.load` brut |
+| v0.6.0 | WAT `@staticmethod` / `@classmethod` : détectés via décorateur ; les sites d'appel ne poussent plus de `self` implicite |
+| v0.6.0 | WAT `print` `sep=` / `end=` : séparateur et terminateur personnalisés internés dans la section de données et imprimés via `$print_str` ; `sep=""` / `end=""` supprime la sortie |
+| v0.6.0 | WAT dispatch dynamique : balise de type (ID de classe) stockée 8 octets avant chaque objet stateful ; fonction de commutation `$__dispatch_method` générée pour chaque méthode surchargée ; paramètres de fonction de type inconnu dispatchés polymorphiquement à l'exécution |
 | v0.5.1 | Mises à jour de documentation |
 | v0.5.0 | Modèle objet POO WAT / WASM : abaissement des classes avec allocateur linéaire, héritage avec MRO C3, résolution de `super()`, tests d'exécution WAT |
 | v0.5.0 | `SemanticAnalyzer` gère correctement les affectations simples (`x = 5`) dans la portée |

docs/content/fr/references/fonctions-integrees.md

@@ -5,12 +5,12 @@ title: Fonctions intégrées
 path_segments:
 - references
 - fonctions-integrees
-source_hash: 3b6205ba8915
+source_hash: 2cea4d177e8d
 status: translated
 permalink: /fr/docs/references/fonctions-integrees/
 ---
 
-multilingual fournit des alias localisés pour 41 fonctions intégrées Python courantes. Les noms anglais universels restent **toujours disponibles** dans toutes les langues ; les alias sont simplement ajoutés en complément.
+multilingual fournit des alias localisés pour 75 fonctions intégrées Python. Les noms anglais universels restent **toujours disponibles** dans toutes les langues ; les alias sont simplement ajoutés en complément.
 
 ---
 
@@ -111,6 +111,8 @@ print(range(5))
 | `next` | suivant | siguiente | naechster | 次 | التالي | अगला | 下一个 |
 | `any` | quelconque | cualquiera | irgendein | どれか | أي | कोई | 任意 |
 | `all` | tous | todos | alle | すべて | كل | सब | 所有 |
+| `aiter` | iterasync | iterasync | asynciter | 非同期イテレータ | مكرر\_غير\_متزامن | असिंकइटर | 异步迭代器 |
+| `anext` | prochainasync | siguienteasync | asyncnaechstes | 非同期次 | التالي\_غير\_المتزامن | असिंकअगला | 异步下一个 |
 
 ### Chaînes et encodage
 
@@ -120,6 +122,35 @@ print(range(5))
 | `ord` | ord | ord | ord | 文字コード | رمز_حرف | कोड | 编码 |
 | `format` | formater | formatear | formatieren | フォーマット | تنسيق | प्रारूप | 格式化 |
 
+### Exécution de code
+
+| Builtin | fr | es | de | ja | ar | hi | zh |
+|---------|----|----|----|----|----|----|-----|
+| `eval` | evaluer | evaluar | auswerten | 評価 | تقييم | मूल्यांकन | 评估 |
+| `exec` | executer | ejecutar | ausfuehren | 実行 | تنفيذ | निष्पादन | 执行 |
+| `compile` | compiler | compilar | kompilieren | コンパイル | تجميع | संकलन | 编译 |
+
+### Inspection de portée
+
+| Builtin | fr | es | de | ja | ar | hi | zh |
+|---------|----|----|----|----|----|----|-----|
+| `globals` | globaux | globales | globale | グローバル変数 | عالمي | वैश्विक | 全局变量 |
+| `locals` | locaux | locales | lokale | ローカル変数 | محلي | स्थानीय | 局部变量 |
+| `vars` | variables | variables | variablen | 変数 | متغيرات | चर | 变量 |
+
+### Débogage et REPL
+
+| Builtin | fr | es | de | ja | ar | hi | zh |
+|---------|----|----|----|----|----|----|-----|
+| `help` | aide | ayuda | hilfe | ヘルプ | مساعدة | सहायता | 帮助 |
+| `breakpoint` | pointdarret | puntodeparada | haltepunkt | ブレークポイント | نقطة\_توقف | विरामबिंदु | 断点 |
+| `memoryview` | vuememoire | vistamemoria | speicheransicht | メモリビュー | عرض\_الذاكرة | मेमोरीदृश्य | 内存视图 |
+| `exit` | quitter | salir | beenden | 終了 | خروج | बाहर | 退出 |
+| `quit` | fermer | terminar | abbrechen | 終わり | انهاء | समाप्त | 停止 |
+| `copyright` | droitsauteur | derechosautor | urheberrecht | 著作権 | حقوق\_النشر | कॉपीराइट | 版权 |
+| `credits` | remerciements | creditos | danksagungen | クレジット | اعتمادات | श्रेय | 致谢 |
+| `license` | licence | licencia | lizenz | ライセンス | رخصة | लाइसेंस | 许可证 |
+
 ---
 
 ## Vérification des alias disponibles