@zsnout/ithkuil/generate/helpers/stress.js

A set of tools which can generate and parse romanized Ithkuil text and which can generate Ithkuil script from text and JSON data.

import { deepFreeze } from "./deep-freeze.js";
/** An object mapping from vowels to their stressed counterparts. */
export const VOWEL_TO_STRESSED_VOWEL_MAP = /* @__PURE__ */ deepFreeze({
    a: "á",
    ä: "â",
    e: "é",
    ë: "ê",
    i: "í",
    o: "ó",
    ö: "ô",
    u: "ú",
    ü: "û",
});
/**
 * Applies stress to a vowel form, marking it either with an accent (´) or a
 * circumflex (ˆ).
 *
 * @param vowelForm The vowel form to apply stress to.
 * @returns The stressed vowel form.
 */
export function stressVowelForm(vowelForm) {
    if (vowelForm.length == 0) {
        throw new Error("Expected a vowel form; found ''.");
    }
    const firstChar = vowelForm[0];
    if (firstChar in VOWEL_TO_STRESSED_VOWEL_MAP) {
        return (VOWEL_TO_STRESSED_VOWEL_MAP[firstChar] + vowelForm.slice(1));
    }
    throw new Error("Expected a vowel form; found '" + vowelForm + "'.");
}
/**
 * Counts the number of vowels and dipthongs in a string.
 *
 * @param text The text to count the vowels of.
 * @returns The number of vowels and dipthongs in the given string.
 */
export function countVowelForms(text) {
    return text.match(/[aeëou]i|[aeëio]u|[aeiouäëöü]/g)?.length || 0;
}
/**
 * Marks a specific syllable of a word with stress.
 *
 * @param word The word to apply stress to.
 * @param position The position to apply stress at.
 * @returns The word, with the proper syllable stressed.
 */
export function applyStress(word, position) {
    const sequences = word.match(/[aeëou]i|[aeëio]u|[aeiouäëöü]|[^aeiouäëöü]+/g);
    if (!sequences) {
        throw new Error("Cannot add stress to an empty word.");
    }
    const vowelFormIndices = sequences
        .map((value, index) => [value, index])
        .filter(([value]) => /[aeiouäëöü]/.test(value));
    const stressType = position == -1 ? "ultimate"
        : position == -2 ? "penultimate"
            : position == -3 ? "antepenultimate"
                : position == -4 ? "preantepenultimate"
                    : "(unknown stress)";
    const item = vowelFormIndices.at(position);
    if (!item) {
        throw new Error("Cannot apply " +
            stressType +
            " stress to a word with " +
            vowelFormIndices.length +
            " vowel form" +
            (vowelFormIndices.length == 1 ? "" : "s") +
            ".");
    }
    sequences[item[1]] = stressVowelForm(item[0]);
    return sequences.join("");
}