@kensio/pinyinjs 1.7.4 → 1.7.5

package/dist/transcription/bopomofo.js

@@ -1,346 +1,8 @@
-/**
- * Bopomofo (注音符號), in both directions.
- *
- * This is the easy half of romanisation interchange, and the reason is
- * [phonology.ts](../syllable/phonology.ts): a parsed syllable already holds the
- * underlying initial and final rather than the spelling, and bopomofo writes
- * exactly those. 就 is
- * `j` + `iou` and ㄐㄧㄡ; 军 is `j` + `ün` and ㄐㄩㄣ; 中 is `zh` + `ong` and
- * ㄓㄨㄥ. Nothing here undoes a pinyin spelling rule, because `readSyllable`
- * never applied one.
- *
- * So the mapping is compositional — an initial symbol, a medial symbol and a
- * rhyme symbol — and it is a bijection over the whole syllable inventory. The
- * three places it is not quite mechanical are recorded on the tables below.
- */
-import { toCharacters } from "../script/characters.js";
-import { NEUTRAL_TONE } from "../tone/tone.js";
-/**
- * The symbol each initial is written with.
- *
- * A syllable with no initial has no entry and writes nothing, which is what the
- * empty string stands for throughout this file.
- */
-const INITIAL_SYMBOLS = new Map([
-    ["b", "ㄅ"],
-    ["p", "ㄆ"],
-    ["m", "ㄇ"],
-    ["f", "ㄈ"],
-    ["d", "ㄉ"],
-    ["t", "ㄊ"],
-    ["n", "ㄋ"],
-    ["l", "ㄌ"],
-    ["g", "ㄍ"],
-    ["k", "ㄎ"],
-    ["h", "ㄏ"],
-    ["j", "ㄐ"],
-    ["q", "ㄑ"],
-    ["x", "ㄒ"],
-    ["zh", "ㄓ"],
-    ["ch", "ㄔ"],
-    ["sh", "ㄕ"],
-    ["r", "ㄖ"],
-    ["z", "ㄗ"],
-    ["c", "ㄘ"],
-    ["s", "ㄙ"],
-]);
-/**
- * The symbol each medial is written with.
- */
-const MEDIAL_SYMBOLS = new Map([
-    ["i", "ㄧ"],
-    ["u", "ㄨ"],
-    ["ü", "ㄩ"],
-]);
-/**
- * The symbol each rhyme is written with.
- *
- * ㄦ is here as a rhyme of its own and also serves as the 儿化 suffix, which is
- * what bopomofo does with it: 歌儿 gēr is ㄍㄜㄦ.
- *
- * The three syllabic nasals at the end are the marginal case. ㄇ and ㄋ are
- * initial letters doing rhyme duty, as bopomofo writes 呣 and 嗯; ㄫ is the
- * obsolete letter for a syllabic ng, used here rather than ㄥ so that 嗯 ǹg and
- * the rare 鞥 ēng do not come out identical.
- */
-const RHYME_SYMBOLS = new Map([
-    ["a", "ㄚ"],
-    ["o", "ㄛ"],
-    ["e", "ㄜ"],
-    ["ê", "ㄝ"],
-    ["ai", "ㄞ"],
-    ["ei", "ㄟ"],
-    ["ao", "ㄠ"],
-    ["ou", "ㄡ"],
-    ["an", "ㄢ"],
-    ["en", "ㄣ"],
-    ["ang", "ㄤ"],
-    ["eng", "ㄥ"],
-    ["er", "ㄦ"],
-    ["m", "ㄇ"],
-    ["n", "ㄋ"],
-    ["ng", "ㄫ"],
-]);
-/**
- * How each final divides into a medial and a rhyme.
- *
- * Written out rather than split off the front of the spelling, because the
- * division is phonological and the spelling only mostly follows it: `in` is
- * ㄧㄣ, an i medial over the ㄣ rhyme rather than over an n of its own, and
- * `iong` is ㄩㄥ — a ü medial despite the i in the spelling, which is why
- * 兄 xiōng and 军 jūn share a medial.
- */
-const FINAL_PARTS = {
-    a: ["", "a"],
-    o: ["", "o"],
-    e: ["", "e"],
-    ê: ["", "ê"],
-    er: ["", "er"],
-    ai: ["", "ai"],
-    ei: ["", "ei"],
-    ao: ["", "ao"],
-    ou: ["", "ou"],
-    an: ["", "an"],
-    en: ["", "en"],
-    ang: ["", "ang"],
-    eng: ["", "eng"],
-    ong: ["u", "eng"],
-    i: ["i", ""],
-    ia: ["i", "a"],
-    io: ["i", "o"],
-    ie: ["i", "ê"],
-    iao: ["i", "ao"],
-    iou: ["i", "ou"],
-    ian: ["i", "an"],
-    in: ["i", "en"],
-    iang: ["i", "ang"],
-    ing: ["i", "eng"],
-    iong: ["ü", "eng"],
-    u: ["u", ""],
-    ua: ["u", "a"],
-    uo: ["u", "o"],
-    uai: ["u", "ai"],
-    uei: ["u", "ei"],
-    uan: ["u", "an"],
-    uen: ["u", "en"],
-    uang: ["u", "ang"],
-    ueng: ["u", "eng"],
-    ü: ["ü", ""],
-    üe: ["ü", "ê"],
-    üan: ["ü", "an"],
-    ün: ["ü", "en"],
-    m: ["", "m"],
-    n: ["", "n"],
-    ng: ["", "ng"],
-};
-/**
- * The initials whose syllable with an i final is written as the initial alone:
- * 知 is ㄓ, not ㄓㄧ.
- *
- * The i of zhi, chi, shi, ri, zi, ci and si is not the i of ji at all — it is
- * the syllabic continuation of the initial (空韻), and bopomofo simply does not
- * write it. This is the one place the correspondence is not one symbol per
- * part.
- */
-const EMPTY_RHYME_INITIALS = new Set([
-    "zh",
-    "ch",
-    "sh",
-    "r",
-    "z",
-    "c",
-    "s",
-]);
-/**
- * The symbol 儿化 is written with.
- *
- * ㄦ, the same letter as the rhyme of 兒 ér itself, which is why reading it
- * takes the position into account: see {@link parseSymbols}.
- */
-const ERHUA_SYMBOL = "ㄦ";
-/**
- * The mark each tone takes.
- *
- * The neutral tone's dot goes *before* the syllable and the other four go
- * after — but **before a 儿化 ㄦ rather than after it**: 哪儿 nǎr is ㄋㄚˇㄦ and
- * 玩儿 wánr is ㄨㄢˊㄦ. The mark belongs to the syllable's nucleus, and the
- * suffix is not part of what it marks. Wikipedia's *Bopomofo*, citing 教育部's
- * 國語注音符號手冊, says so outright, and it is what 教育部's dictionaries and
- * Wiktionary both write.
- */
-const TONE_MARKS = new Map([
-    [1, "ˉ"],
-    [2, "ˊ"],
-    [3, "ˇ"],
-    [4, "ˋ"],
-    [NEUTRAL_TONE, "˙"],
-]);
-/**
- * The tone each mark stands for, including the shapes a keyboard produces.
- *
- * Tolerant input and standard output, as the rest of the package has: `´` and
- * `` ` `` are the ASCII neighbours of ˊ and ˋ, and are what text that was typed
- * rather than composed tends to carry.
- */
-const TONES_BY_MARK = new Map([
-    ["ˉ", 1],
-    ["¯", 1],
-    ["ˊ", 2],
-    ["´", 2],
-    ["ˇ", 3],
-    ["ˋ", 4],
-    ["`", 4],
-    ["˙", NEUTRAL_TONE],
-    ["·", NEUTRAL_TONE],
-]);
-/**
- * Write a syllable in bopomofo: 就 jiù becomes ㄐㄧㄡˋ.
- *
- * Total over well-formed syllables — every initial and every final has a
- * symbol — so anything the syllable parser accepts can be written, including
- * the syllables no dictionary uses.
- */
-export function writeBopomofo(syllable, options = {}) {
-    const { initial, final, tone } = syllable;
-    const [medial, rhyme] = FINAL_PARTS[final];
-    const isEmptyRhyme = final === "i" && EMPTY_RHYME_INITIALS.has(initial);
-    const written = [
-        INITIAL_SYMBOLS.get(initial) ?? "",
-        isEmptyRhyme ? "" : (MEDIAL_SYMBOLS.get(medial) ?? ""),
-        isEmptyRhyme ? "" : (RHYME_SYMBOLS.get(rhyme) ?? ""),
-    ].join("");
-    const suffix = syllable.erhua === true ? ERHUA_SYMBOL : "";
-    const mark = tone === undefined ? undefined : TONE_MARKS.get(tone);
-    if (mark === undefined || (tone === 1 && options.firstTone !== "mark")) {
-        return `${written}${suffix}`;
-    }
-    return tone === NEUTRAL_TONE
-        ? `${mark}${written}${suffix}`
-        : `${written}${mark}${suffix}`;
-}
-/**
- * Write a word in bopomofo, one syllable after another.
- *
- * Separated by spaces, as 教育部's dictionaries write them. A syllable boundary
- * is findable without the space — an initial symbol can only start one — but a
- * long unbroken run of symbols is hard to read, and the space costs nothing.
- */
-export function writeBopomofoWord(syllables, options = {}) {
-    return syllables
-        .map((syllable) => writeBopomofo(syllable, options))
-        .join(" ");
-}
-/**
- * The final each medial and rhyme pair spells, keyed as `medial|rhyme`.
- */
-const FINALS_BY_PARTS = new Map(Object.entries(FINAL_PARTS).map(([final, [medial, rhyme]]) => [
-    `${medial}|${rhyme}`,
-    final,
-]));
-/**
- * The initial each symbol stands for.
- */
-const INITIALS_BY_SYMBOL = new Map([...INITIAL_SYMBOLS].map(([initial, symbol]) => [symbol, initial]));
-/**
- * The medial each symbol stands for.
- */
-const MEDIALS_BY_SYMBOL = new Map([...MEDIAL_SYMBOLS].map(([medial, symbol]) => [symbol, medial]));
-/**
- * The rhyme each symbol stands for.
- */
-const RHYMES_BY_SYMBOL = new Map([...RHYME_SYMBOLS].map(([rhyme, symbol]) => [symbol, rhyme]));
-/**
- * Whether one character is a bopomofo letter or tone mark.
- */
-function isSymbol(symbol) {
-    return (INITIALS_BY_SYMBOL.has(symbol) ||
-        MEDIALS_BY_SYMBOL.has(symbol) ||
-        RHYMES_BY_SYMBOL.has(symbol) ||
-        TONES_BY_MARK.has(symbol));
-}
-/**
- * Whether a string is written in bopomofo at all.
- *
- * This is the one thing bopomofo makes easy that Wade-Giles cannot: it has a
- * script of its own, so it is never mistaken for pinyin and a caller never has
- * to be told which system its input is in.
- */
-export function isBopomofo(text) {
-    const trimmed = text.trim();
-    return (trimmed !== "" && toCharacters(trimmed).every((symbol) => isSymbol(symbol)));
-}
-/**
- * Take the tone mark off, wherever it was written.
- *
- * Three positions, because bopomofo uses two of them and texts use the third.
- * The neutral dot belongs at the front and the other four at the back, in front
- * of a 儿化 ㄦ where there is one — ㄨㄢˊㄦ. A mark written after the ㄦ is not
- * standard and is read anyway, since it is what a text that treated the suffix
- * as part of the syllable would produce. A mark at each end is rejected rather
- * than resolved, which is the same call `readSyllable` makes about `běi3`.
- */
-function splitTone(text) {
-    const leading = TONES_BY_MARK.get(text.slice(0, 1));
-    if (leading !== undefined) {
-        const rest = text.slice(1);
-        return TONES_BY_MARK.has(rest.slice(-1)) ? undefined : [rest, leading];
-    }
-    const trailing = TONES_BY_MARK.get(text.slice(-1));
-    if (trailing !== undefined) {
-        return [text.slice(0, -1), trailing];
-    }
-    if (text.endsWith(ERHUA_SYMBOL)) {
-        const marked = TONES_BY_MARK.get(text.slice(-2, -1));
-        if (marked !== undefined) {
-            return [`${text.slice(0, -2)}${ERHUA_SYMBOL}`, marked];
-        }
-    }
-    return [text, undefined];
-}
-/**
- * Read the symbols of one syllable, in the order bopomofo writes them.
- *
- * `hasInitial` is what recovers the syllabic nasals on a second pass: ㄇ is an
- * initial letter, so 呣 m̄ parses as an m initial with nothing after it and has
- * to be retried as a rhyme standing alone. `readParts` in
- * [syllable.ts](../syllable/syllable.ts) retries n and ng the same way, for the
- * same reason.
- */
-function parseSymbols(text, hasInitial) {
-    const symbols = toCharacters(text);
-    let at = 0;
-    const initial = hasInitial
-        ? INITIALS_BY_SYMBOL.get(symbols[at] ?? "")
-        : undefined;
-    if (initial !== undefined) {
-        at += 1;
-    }
-    const medial = MEDIALS_BY_SYMBOL.get(symbols[at] ?? "");
-    if (medial !== undefined) {
-        at += 1;
-    }
-    // ㄦ is the 儿化 suffix everywhere except at the very front of a syllable,
-    // where it is the rhyme of 儿 ér itself. That is what separates ㄦ from ㄕㄦ:
-    // 事儿 shìr writes no rhyme at all, so the ㄦ can only be the suffix, and
-    // 二儿 èr with a suffix is ㄦㄦ.
-    const isSuffix = at > 0 && symbols[at] === ERHUA_SYMBOL;
-    const rhyme = isSuffix ? undefined : RHYMES_BY_SYMBOL.get(symbols[at] ?? "");
-    if (rhyme !== undefined) {
-        at += 1;
-    }
-    const hasErhua = at > 0 && symbols[at] === ERHUA_SYMBOL;
-    if (hasErhua) {
-        at += 1;
-    }
-    return at === symbols.length
-        ? {
-            initial: initial ?? "",
-            medial: medial ?? "",
-            rhyme: rhyme ?? "",
-            hasErhua,
-        }
-        : undefined;
-}
+import { EMPTY_RHYME_INITIALS } from "./bopomofo-symbols.js";
+export { writeBopomofo, writeBopomofoWord, } from "./bopomofo-symbols.js";
+import { FINALS_BY_PARTS } from "./bopomofo-reverse.js";
+import { parseSymbols, splitTone } from "./bopomofo-parse.js";
+export { isBopomofo } from "./bopomofo-reverse.js";
 /**
  * Resolve parsed symbols to an underlying final.
  *

package/dist/transcription/bopomofo.js.map

@@ -1 +1 @@
-{"version":3,"file":"bopomofo.js","sourceRoot":"","sources":["../../src/transcription/bopomofo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bopomofo.js","sourceRoot":"","sources":["../../src/transcription/bopomofo.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAEL,aAAa,EACb,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAe,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;;;GAMG;AACH,SAAS,OAAO,CAAC,MAAc;IAC7B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC1C,IAAI,MAAM,KAAK,EAAE,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAClC,OAAO,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IACD,IAAI,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACtC,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACzC,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY,EAAE,UAAmB;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAChD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC;YACE,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK;YACL,IAAI,EAAE,SAAS;YACf,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACxC,CAAC;AACR,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAE9B,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/transcription/gwoyeu-first-second.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The first and second tone rules, the two that reach for a glide.
+ *
+ * Both work on the rime's vowels rather than the syllable as a whole, and the
+ * sonorant initials swap what the two of them do.
+ */
+import type { Initial } from "../syllable/phonology.js";
+/**
+ * Tone 1: the basic form, with `-h-` inserted after a sonorant initial.
+ */
+export declare function firstTone(form: string, initial: Initial): string;
+/**
+ * The i or u a glide can be written on, turned into y or w.
+ *
+ * The rule is `NiV → NyV` and `NuV → NwV`, where N is a non-vowel or nothing at
+ * all: the i or u has to be the medial rather than part of a diphthong, which
+ * is what the "not preceded by a vowel" test says. The `+ -i if final` clause
+ * covers the rimes that are nothing but the medial — `i` becomes `yi` and not
+ * a bare `y`.
+ */
+export declare function glided(form: string): string | undefined;
+/**
+ * Tone 2: i/u to y/w, or an `-r` after the vowels.
+ */
+export declare function secondTone(form: string, initial: Initial): string;
+/**
+ * The i or u a third tone can be swapped for e or o.
+ *
+ * `Vi`/`iV` becomes `Ve`/`eV` and `Vu`/`uV` becomes `Vo`/`oV`, so the letter
+ * has to sit beside a vowel; where both an i and a u are available it is
+ * whichever comes *first* that changes, which is why 交 jiǎo is `jeau` and not
+ * `jiao`. The swap is abandoned where it would produce `ee` or `oo`, both of
+ * which are the doubling below and would collide with it.
+ */
+export declare function swapped(form: string): string | undefined;
+//# sourceMappingURL=gwoyeu-first-second.d.ts.map

package/dist/transcription/gwoyeu-first-second.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gwoyeu-first-second.d.ts","sourceRoot":"","sources":["../../src/transcription/gwoyeu-first-second.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAUjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqBxD"}

package/dist/transcription/gwoyeu-first-second.js

@@ -0,0 +1,75 @@
+import { isVowel, SONORANT_INITIALS, vowelSpan } from "./gwoyeu-vowels.js";
+/**
+ * Tone 1: the basic form, with `-h-` inserted after a sonorant initial.
+ */
+export function firstTone(form, initial) {
+    return SONORANT_INITIALS.has(initial)
+        ? `${form.slice(0, 1)}h${form.slice(1)}`
+        : form;
+}
+/**
+ * The i or u a glide can be written on, turned into y or w.
+ *
+ * The rule is `NiV → NyV` and `NuV → NwV`, where N is a non-vowel or nothing at
+ * all: the i or u has to be the medial rather than part of a diphthong, which
+ * is what the "not preceded by a vowel" test says. The `+ -i if final` clause
+ * covers the rimes that are nothing but the medial — `i` becomes `yi` and not
+ * a bare `y`.
+ */
+export function glided(form) {
+    for (const [letter, glide] of [
+        ["i", "y"],
+        ["u", "w"],
+    ]) {
+        const at = form.indexOf(letter);
+        if (at !== -1 && !isVowel(form[at - 1])) {
+            const rest = form.slice(at + 1);
+            return `${form.slice(0, at)}${glide}${rest === "" ? letter : rest}`;
+        }
+    }
+    return undefined;
+}
+/**
+ * Tone 2: i/u to y/w, or an `-r` after the vowels.
+ */
+export function secondTone(form, initial) {
+    if (SONORANT_INITIALS.has(initial)) {
+        return form;
+    }
+    const glide = glided(form);
+    if (glide !== undefined) {
+        return glide;
+    }
+    const [, end] = vowelSpan(form);
+    return `${form.slice(0, end + 1)}r${form.slice(end + 1)}`;
+}
+/**
+ * The i or u a third tone can be swapped for e or o.
+ *
+ * `Vi`/`iV` becomes `Ve`/`eV` and `Vu`/`uV` becomes `Vo`/`oV`, so the letter
+ * has to sit beside a vowel; where both an i and a u are available it is
+ * whichever comes *first* that changes, which is why 交 jiǎo is `jeau` and not
+ * `jiao`. The swap is abandoned where it would produce `ee` or `oo`, both of
+ * which are the doubling below and would collide with it.
+ */
+export function swapped(form) {
+    const found = [
+        ["i", "e"],
+        ["u", "o"],
+    ]
+        .map(([letter, swap]) => [form.indexOf(letter), swap])
+        .filter(([at]) => at !== -1)
+        .toSorted((one, other) => one[0] - other[0])[0];
+    if (found === undefined) {
+        return undefined;
+    }
+    const [at, swap] = found;
+    const before = form[at - 1];
+    const after = form[at + 1];
+    const isBeside = isVowel(before) || isVowel(after);
+    const isDoubles = before === swap || after === swap;
+    return isBeside && !isDoubles
+        ? `${form.slice(0, at)}${swap}${form.slice(at + 1)}`
+        : undefined;
+}
+//# sourceMappingURL=gwoyeu-first-second.js.map

package/dist/transcription/gwoyeu-first-second.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gwoyeu-first-second.js","sourceRoot":"","sources":["../../src/transcription/gwoyeu-first-second.ts"],"names":[],"mappings":"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"}

package/dist/transcription/gwoyeu-spelling.d.ts

@@ -0,0 +1,38 @@
+import type { Syllable } from "../syllable/syllable.js";
+import { type ContourTone } from "./gwoyeu-tonal-forms.js";
+export declare const NEUTRAL_MARK = ".";
+/**
+ * Spell a syllable in a given tone.
+ */
+export declare function toneForm(syllable: Syllable, tone: ContourTone): string;
+/**
+ * Spell a rhotacised syllable in a given tone.
+ */
+export declare function rhotacisedTone(syllable: Syllable, tone: ContourTone): string;
+/**
+ * Write a syllable in Gwoyeu Romatzyh: 就 jiù becomes `jiow`.
+ *
+ * An unwritten tone is written as the first-tone form, because GR has no other
+ * form to write — which means it reads back as a first tone, exactly as
+ * bopomofo's unmarked syllable does.
+ *
+ * The neutral tone takes the dot in front, and behind it goes the syllable's
+ * original tonal spelling where {@link Syllable.originalTone} says what that
+ * was: 没有 méiyou is `mei.yeou`. Where it does not, the basic form goes there
+ * instead — which is what GR itself writes for a syllable that is neutral in
+ * its own right, 什么 shénme being `shern.me`. The basic form is not the first
+ * tone for a sonorant initial, and writing `.mhe` would say the 么 was one.
+ */
+export declare function writeGwoyeu(syllable: Syllable): string;
+/**
+ * Write a word in Gwoyeu Romatzyh, one syllable after another.
+ *
+ * Solid, as GR writes a word: 北京 is `Beeijing`, which is the convention
+ * pinyin inherited. GR uses an apostrophe where the join is ambiguous — its own
+ * name for pinyin, `Pin'in`, is the standard example — and that is not written
+ * here, for the same reason `readGwoyeu` takes one syllable at a time: knowing
+ * where the boundary is ambiguous means being able to split the word, and
+ * nothing here splits a GR word.
+ */
+export declare function writeGwoyeuWord(syllables: readonly Syllable[]): string;
+//# sourceMappingURL=gwoyeu-spelling.d.ts.map

package/dist/transcription/gwoyeu-spelling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gwoyeu-spelling.d.ts","sourceRoot":"","sources":["../../src/transcription/gwoyeu-spelling.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,KAAK,WAAW,EAIjB,MAAM,yBAAyB,CAAC;AAWjC,eAAO,MAAM,YAAY,MAAM,CAAC;AAoBhC;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAEtE;AA4BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAY5E;AA0BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAUtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAEtE"}

package/dist/transcription/gwoyeu-spelling.js

@@ -0,0 +1,124 @@
+import { NEUTRAL_TONE } from "../tone/tone.js";
+import { fourthTone, tonalForm, zeroInitial, } from "./gwoyeu-tonal-forms.js";
+import { APOSTROPHE, APOSTROPHE_TONES, EMPTY_RHYME_INITIALS, ERHUA_SUFFIX, FINAL_SPELLINGS, INITIAL_SPELLINGS, RHOTACISED_EMPTY_RHYME, RHOTACISED_RIMES, } from "./gwoyeu-tables.js";
+export const NEUTRAL_MARK = ".";
+/**
+ * How a final is spelled after a given initial.
+ */
+function rimeSpelling(initial, final) {
+    return final === "i" && EMPTY_RHYME_INITIALS.has(initial)
+        ? "y"
+        : FINAL_SPELLINGS[final];
+}
+/**
+ * The basic form of a syllable: the spelling every tonal rule starts from.
+ */
+function basicForm(syllable) {
+    const { initial, final } = syllable;
+    const spelt = INITIAL_SPELLINGS.get(initial) ?? "";
+    return `${spelt}${rimeSpelling(initial, final)}`;
+}
+/**
+ * Spell a syllable in a given tone.
+ */
+export function toneForm(syllable, tone) {
+    return tonalForm(basicForm(syllable), syllable.initial, tone);
+}
+/**
+ * The basic rhotacised form of a syllable: the spelling before the `-l`.
+ */
+function rhotacisedForm(syllable) {
+    const { initial, final } = syllable;
+    const rime = final === "i" && EMPTY_RHYME_INITIALS.has(initial)
+        ? RHOTACISED_EMPTY_RHYME
+        : RHOTACISED_RIMES[final];
+    return `${INITIAL_SPELLINGS.get(initial) ?? ""}${rime}`;
+}
+/**
+ * Whether a rhotacised rime spells its fourth tone rather than doubling the l.
+ *
+ * The fourth tone of a rhotacised syllable doubles the `-l` — `nal` becomes
+ * `nall` — except where the rime has a fourth tone of its own to spell, and
+ * then it spells that and adds the l on the end: `aul` becomes `awl` and `angl`
+ * becomes `anql`. *Spelling in Gwoyeu Romatzyh* lists the exceptions as
+ * `awl, owl, anql, enql, onql` and `ehl`, which is every rime ending in a
+ * diphthong's -u or in -ng, plus the `e` that takes the apostrophe.
+ */
+function isOwnFourthTone(final, rime) {
+    return final === "e" || /(?:[aeiou]u|ng)$/u.test(rime);
+}
+/**
+ * Spell a rhotacised syllable in a given tone.
+ */
+export function rhotacisedTone(syllable, tone) {
+    const { initial, final } = syllable;
+    const basic = rhotacisedForm(syllable);
+    if (tone === 4) {
+        const spelt = isOwnFourthTone(final, basic)
+            ? `${fourthTone(basic)}${ERHUA_SUFFIX}`
+            : `${basic}${ERHUA_SUFFIX}${ERHUA_SUFFIX}`;
+        return initial === "" ? zeroInitial(spelt, basic) : spelt;
+    }
+    const apostrophe = tone <= (APOSTROPHE_TONES.get(final) ?? 0) ? APOSTROPHE : "";
+    return `${tonalForm(basic, initial, tone)}${apostrophe}${ERHUA_SUFFIX}`;
+}
+/**
+ * Spell a syllable in a given tone, rhotacised or not.
+ */
+function spelling(syllable, tone) {
+    return syllable.erhua === true
+        ? rhotacisedTone(syllable, tone)
+        : toneForm(syllable, tone);
+}
+/**
+ * The basic form of a syllable, rhotacised or not.
+ *
+ * The spelling before any tonal rule has touched it, which is the first tone
+ * for every initial but the sonorants and the second tone for those. It is
+ * what a neutral syllable with no original tone is written as.
+ */
+function basicSpelling(syllable) {
+    if (syllable.erhua !== true) {
+        return basicForm(syllable);
+    }
+    const apostrophe = APOSTROPHE_TONES.has(syllable.final) ? APOSTROPHE : "";
+    return `${rhotacisedForm(syllable)}${apostrophe}${ERHUA_SUFFIX}`;
+}
+/**
+ * Write a syllable in Gwoyeu Romatzyh: 就 jiù becomes `jiow`.
+ *
+ * An unwritten tone is written as the first-tone form, because GR has no other
+ * form to write — which means it reads back as a first tone, exactly as
+ * bopomofo's unmarked syllable does.
+ *
+ * The neutral tone takes the dot in front, and behind it goes the syllable's
+ * original tonal spelling where {@link Syllable.originalTone} says what that
+ * was: 没有 méiyou is `mei.yeou`. Where it does not, the basic form goes there
+ * instead — which is what GR itself writes for a syllable that is neutral in
+ * its own right, 什么 shénme being `shern.me`. The basic form is not the first
+ * tone for a sonorant initial, and writing `.mhe` would say the 么 was one.
+ */
+export function writeGwoyeu(syllable) {
+    const { tone, originalTone } = syllable;
+    if (tone === NEUTRAL_TONE) {
+        const spelt = originalTone === undefined || originalTone === NEUTRAL_TONE
+            ? basicSpelling(syllable)
+            : spelling(syllable, originalTone);
+        return `${NEUTRAL_MARK}${spelt}`;
+    }
+    return spelling(syllable, tone ?? 1);
+}
+/**
+ * Write a word in Gwoyeu Romatzyh, one syllable after another.
+ *
+ * Solid, as GR writes a word: 北京 is `Beeijing`, which is the convention
+ * pinyin inherited. GR uses an apostrophe where the join is ambiguous — its own
+ * name for pinyin, `Pin'in`, is the standard example — and that is not written
+ * here, for the same reason `readGwoyeu` takes one syllable at a time: knowing
+ * where the boundary is ambiguous means being able to split the word, and
+ * nothing here splits a GR word.
+ */
+export function writeGwoyeuWord(syllables) {
+    return syllables.map((syllable) => writeGwoyeu(syllable)).join("");
+}
+//# sourceMappingURL=gwoyeu-spelling.js.map