From f75b78672e6e7647cf9d61475b637f1b8fcaeb93 Mon Sep 17 00:00:00 2001 From: Ronald Tse Date: Thu, 12 Nov 2026 15:39:52 +0800 Subject: [PATCH] docs: Libraries page - the Rust runtime, the current Ruby surface, 428 systems, grammar single-sourcing; dep 5.12.0; catalogue regen - New Rust (crates.io) section: the interscript crate + the iscrs CLI (the fully-released fourth runtime). - Ruby section rewritten to the current surface: gem install interscript + Interscript::ML::Translator (the IMF v1 in-gem runtime) - the legacy standalone secryst gem path is superseded. - 289 -> 428 systems; the grammar single-sourcing note (one checksum -pinned .parg source; the TypeScript and Python parsers are generated from it, structurally identical across the 434-file corpus). - interscript dependency ^5.12.0 (the generated-parser release); catalogue regenerated 428/428 against it. --- package-lock.json | 8 +++--- package.json | 2 +- src/content/docs/Libraries.adoc | 51 +++++++++++++++++++++++++++++---- 3 files changed, 50 insertions(+), 11 deletions(-) diff --git a/package-lock.json b/package-lock.json index 06adf7e..2976f6b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -21,7 +21,7 @@ "@litertjs/core": "^2.5.3", "@tailwindcss/vite": "^4.0.0", "astro": "^7.3.5", - "interscript": "^5.11.0", + "interscript": "^5.12.0", "onnxruntime-web": "^1.31.1", "svgo": "^4.1.0", "tailwindcss": "^4.0.0", @@ -6195,9 +6195,9 @@ "license": "ISC" }, "node_modules/interscript": { - "version": "5.11.0", - "resolved": "https://registry.npmjs.org/interscript/-/interscript-5.11.0.tgz", - "integrity": "sha512-BCuBD5XtOniKCyCQRfp9FyWCUZGvTuZQ2/CJsM6B52f8NyB5lITilhCqigOvDSzPfTg6tAQICWIeLt5dd8jeAA==", + "version": "5.12.0", + "resolved": "https://registry.npmjs.org/interscript/-/interscript-5.12.0.tgz", + "integrity": "sha512-WnE94otB4AME8k22fSm/mEomTzXum5HMwAEoJcBEjlz2c9S+7gZ/DAcx0kFDHM2G4WYRpeVh0tRJiWp17pQnVA==", "license": "BSD-2-Clause", "dependencies": { "fflate": "^0.8.3", diff --git a/package.json b/package.json index fae0055..3ceaa65 100644 --- a/package.json +++ b/package.json @@ -35,7 +35,7 @@ "@litertjs/core": "^2.5.3", "@tailwindcss/vite": "^4.0.0", "astro": "^7.3.5", - "interscript": "^5.11.0", + "interscript": "^5.12.0", "onnxruntime-web": "^1.31.1", "svgo": "^4.1.0", "tailwindcss": "^4.0.0", diff --git a/src/content/docs/Libraries.adoc b/src/content/docs/Libraries.adoc index 6138417..b6a0885 100644 --- a/src/content/docs/Libraries.adoc +++ b/src/content/docs/Libraries.adoc @@ -13,7 +13,7 @@ Install: npm install interscript ``` -Transliterate with one of the 289 authority systems: +Transliterate with any of the 428 authority systems: ```ts import { transliterateAsync } from "interscript" @@ -35,6 +35,35 @@ const model = await imf.IMFModel.fromZipBytes(resolved.bytes) const vocalized = await model.translate("السلام عليكم") ``` +All four language runtimes execute the same canonical grammar: the + ISC grammar has a single normative source (the parsanol `.parg` + file, checksum-pinned), and the TypeScript and Python parsers are + generated from it — verified structurally identical across the whole + 434-file corpus on every change. + +== Rust (crates.io) + +Install: + +``` +cargo add interscript +``` + +Transliterate and run the golden conformance gate: + +```rust +use interscript_rs::Runtime; + +let rt = Runtime::new(vec![ + std::path::PathBuf::from("maps/maps"), + std::path::PathBuf::from("maps/libs"), +]); +let out = rt.transliterate("bgnpcgn-ukr-Cyrl-Latn-2019", "Антон")?; +``` + +The crate also ships the `iscrs` CLI (transliterate, corpus test +sweeps, the golden capture, and IMF model inference). + == Python Install: @@ -57,16 +86,26 @@ print(model.translate("قوله فحكمها في الوفاة")) Install: ``` -gem install secryst +gem install interscript +``` + +Transliterate (deterministic maps), optionally with a language +selection for maps that declare languages: + +```ruby +require "interscript" + +Interscript.transliterate("bgnpcgn-ukr-Cyrl-Latn-2019", "Антон") ``` -Load and translate: +Use a neural model — the gem embeds the IMF v1 runtime (index +resolution, checksum verification, ONNX inference): ```ruby -require "secryst" +require "interscript/ml" -model = Secryst::Model.load("ara-diac-small-2.1-int8") -model.translate("قوله فحكمها في الوفاة") +Interscript::ML::Translator.new(model_file: "ara-diac-base-1.0") + .translate("قوله فحكمها في الوفاة") ``` == Command line