From 000d3446edd7e5e414f3e31cfd325e0a616e4809 Mon Sep 17 00:00:00 2001 From: Ronald Tse Date: Wed, 11 Nov 2026 06:45:20 +0800 Subject: [PATCH] docs: README section for the ISC-WF-1 workflow extension MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The gem's headline runtime feature had no README surface: document ruleset/use/override, languages/when guards with the language: selection, the additivity guarantee, and the actual corpus adoption state (Thai leading-vowel shared ruleset; W3 exercised by the conformance fixtures). Example output verified against the corpus (bgnpcgn-tha-Thai-Latn-2002 กรุงเทพ -> krungthep). --- README.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/README.md b/README.md index 961d8954..13c7897b 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,32 @@ Interscript.transliterate("odni-rus-Cyrl-Latn-2015", "привет") # => "privet" ---- +== Workflow extension (ISC-WF-1) + +Maps can reuse rule blocks and condition rows on a language. A +`ruleset` is spliced at a `use` position (recursively, across +declared dependencies); `use ... override { ... }` replaces rows on +byte-exact from-equality; a `languages` declaration plus `when` +guards let the caller select a language per call — guards are inert +without a selection: + +[source,ruby] +---- +# alalc-tha and bgnpcgn-tha share their leading-vowel machinery +# through libs/thai-latn.isc — one ruleset, per-map overrides +Interscript.transliterate("bgnpcgn-tha-Thai-Latn-2002", "กรุงเทพ") + +# language conditioning: select one of the map's declared languages; +# guards are inert when no (or an undeclared) language is passed +Interscript.transliterate("some-map-id", "...", {}, language: "kur") +---- + +The constructs are additive: maps that don't use them transliterate +identically. The corpus adoption so far is the Thai leading-vowel +shared ruleset (W1/W2); W3 conditioning is exercised by the +conformance fixtures. Normative text: interscript/maps +`docs/isc-wf-1.md`. + == Neural models (Interscript::ML) The gem embeds the IMF v1 model runtime — resolve a model id through