ipa-core 1.0.0

package/core.js

@@ -0,0 +1,131 @@
+// IPA elements in json notation
+const core = {
+
+    //consonants
+    //pulmonic
+
+    //plosive
+    'p': { type: "consonant", features: { manner: "plosive", place: "bilabial", voicing: "voiceless" }, airstream: "pulmonic" },
+    'b': { type: "consonant", features: { manner: "plosive", place: "bilabial", voicing: "voiced" }, airstream: "pulmonic" },
+    't': { type: "consonant", features: { manner: "plosive", place: "alveolar", voicing: "voiceless" }, airstream: "pulmonic" },
+    'd': { type: "consonant", features: { manner: "plosive", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʈ': { type: "consonant", features: { manner: "plosive", place: "retroflex", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ɖ': { type: "consonant", features: { manner: "plosive", place: "retroflex", voicing: "voiced" }, airstream: "pulmonic" },
+    'c': { type: "consonant", features: { manner: "plosive", place: "palatal", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ɟ': { type: "consonant", features: { manner: "plosive", place: "palatal", voicing: "voiced" }, airstream: "pulmonic" },
+    'k': { type: "consonant", features: { manner: "plosive", place: "velar", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ɡ': { type: "consonant", features: { manner: "plosive", place: "velar", voicing: "voiced" }, airstream: "pulmonic" },
+    'q': { type: "consonant", features: { manner: "plosive", place: "uvular", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ɢ': { type: "consonant", features: { manner: "plosive", place: "uvular", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʔ': { type: "consonant", features: { manner: "plosive", place: "glottal", voicing: "voiceless" }, airstream: "pulmonic" },
+    //nasal
+    'm': { type: "consonant", features: { manner: "nasal", place: "bilabial", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɱ': { type: "consonant", features: { manner: "nasal", place: "labiodental", voicing: "voiced" }, airstream: "pulmonic" },
+    'n': { type: "consonant", features: { manner: "nasal", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɳ': { type: "consonant", features: { manner: "nasal", place: "retroflex", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɲ': { type: "consonant", features: { manner: "nasal", place: "palatal", voicing: "voiced" }, airstream: "pulmonic" },
+    'ŋ': { type: "consonant", features: { manner: "nasal", place: "velar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɴ': { type: "consonant", features: { manner: "nasal", place: "uvular", voicing: "voiced" }, airstream: "pulmonic" },
+    //trill
+    'ʙ': { type: "consonant", features: { manner: "trill", place: "bilabial", voicing: "voiced" }, airstream: "pulmonic" },
+    'r': { type: "consonant", features: { manner: "trill", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʀ': { type: "consonant", features: { manner: "trill", place: "uvular", voicing: "voiced" }, airstream: "pulmonic" },
+    //tap or flap
+    'ⱱ': { type: "consonant", features: { manner: "tap/flap", place: "labiodental", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɾ': { type: "consonant", features: { manner: "tap/flap", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɽ': { type: "consonant", features: { manner: "tap/flap", place: "retroflex", voicing: "voiced" }, airstream: "pulmonic" },
+    //fricative
+    'ɸ': { type: "consonant", features: { manner: "fricative", place: "bilabial", voicing: "voiceless" }, airstream: "pulmonic" },
+    'f': { type: "consonant", features: { manner: "fricative", place: "labiodental", voicing: "voiceless" }, airstream: "pulmonic" },
+    'θ': { type: "consonant", features: { manner: "fricative", place: "dental", voicing: "voiceless" }, airstream: "pulmonic" },
+    's': { type: "consonant", features: { manner: "fricative", place: "alveolar", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ʃ': { type: "consonant", features: { manner: "fricative", place: "postalveolar", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ʂ': { type: "consonant", features: { manner: "fricative", place: "retroflex", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ç': { type: "consonant", features: { manner: "fricative", place: "palatal", voicing: "voiceless" }, airstream: "pulmonic" },
+    'x': { type: "consonant", features: { manner: "fricative", place: "velar", voicing: "voiceless" }, airstream: "pulmonic" },
+    'χ': { type: "consonant", features: { manner: "fricative", place: "uvular", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ħ': { type: "consonant", features: { manner: "fricative", place: "pharyngeal", voicing: "voiceless" }, airstream: "pulmonic" },
+    'h': { type: "consonant", features: { manner: "fricative", place: "glottal", voicing: "voiceless" }, airstream: "pulmonic" },
+    'β': { type: "consonant", features: { manner: "fricative", place: "bilabial", voicing: "voiced" }, airstream: "pulmonic" },
+    'v': { type: "consonant", features: { manner: "fricative", place: "labiodental", voicing: "voiced" }, airstream: "pulmonic" },
+    'ð': { type: "consonant", features: { manner: "fricative", place: "dental", voicing: "voiced" }, airstream: "pulmonic" },
+    'z': { type: "consonant", features: { manner: "fricative", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʒ': { type: "consonant", features: { manner: "fricative", place: "postalveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʐ': { type: "consonant", features: { manner: "fricative", place: "retroflex", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʝ': { type: "consonant", features: { manner: "fricative", place: "palatal", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɣ': { type: "consonant", features: { manner: "fricative", place: "velar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʁ': { type: "consonant", features: { manner: "fricative", place: "uvular", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʕ': { type: "consonant", features: { manner: "fricative", place: "pharyngeal", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɦ': { type: "consonant", features: { manner: "fricative", place: "glottal", voicing: "voiced" }, airstream: "pulmonic" },
+    // LATERAL FRICATIVES
+    'ɬ': { type: "consonant", features: { manner: "lateral fricative", place: "alveolar", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ɮ': { type: "consonant", features: { manner: "lateral fricative", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    //aproximant
+    'ʋ': { type: "consonant", features: { manner: "approximant", place: "labiodental", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɹ': { type: "consonant", features: { manner: "approximant", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɻ': { type: "consonant", features: { manner: "approximant", place: "retroflex", voicing: "voiced" }, airstream: "pulmonic" },
+    'j': { type: "consonant", features: { manner: "approximant", place: "palatal", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɰ': { type: "consonant", features: { manner: "approximant", place: "velar", voicing: "voiced" }, airstream: "pulmonic" },
+    //lateral approximant
+    'l': { type: "consonant", features: { manner: "lateral approximant", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɭ': { type: "consonant", features: { manner: "lateral approximant", place: "retroflex", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʎ': { type: "consonant", features: { manner: "lateral approximant", place: "palatal", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʟ': { type: "consonant", features: { manner: "lateral approximant", place: "velar", voicing: "voiced" }, airstream: "pulmonic" },
+    //non-pulmonic
+    //implosive
+    'ɓ': { type: "consonant", features: { manner: "plosive", place: "bilabial", voicing: "voiced" }, airstream: "glottalic ingressive" },
+    'ɗ': { type: "consonant", features: { manner: "plosive", place: "alveolar", voicing: "voiced" }, airstream: "glottalic ingressive" },
+    'ʄ': { type: "consonant", features: { manner: "plosive", place: "palatal", voicing: "voiced" }, airstream: "glottalic ingressive" },
+    'ɠ': { type: "consonant", features: { manner: "plosive", place: "velar", voicing: "voiced" }, airstream: "glottalic ingressive" },
+    'ʛ': { type: "consonant", features: { manner: "plosive", place: "uvular", voicing: "voiced" }, airstream: "glottalic ingressive" },
+    //clicks
+    'ʘ': { type: "consonant", features: { manner: "click", place: "bilabial" }, airstream: "lingual ingressive" },
+    'ǀ': { type: "consonant", features: { manner: "click", place: "dental" }, airstream: "lingual ingressive" },
+    'ǃ': { type: "consonant", features: { manner: "click", place: "postalveolar" }, airstream: "lingual ingressive" },
+    'ǂ': { type: "consonant", features: { manner: "click", place: "palatoalveolar" }, airstream: "lingual ingressive" },
+    'ǁ': { type: "consonant", features: { manner: "click", place: "alveolar lateral" }, airstream: "lingual ingressive" },
+    //others
+    'ʍ': { type: "consonant", features: { manner: "fricative", place: "labial-velar", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ɕ': { type: "consonant", features: { manner: "fricative", place: "alveolo-palatal", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ʑ': { type: "consonant", features: { manner: "fricative", place: "alveolo-palatal", voicing: "voiced" }, airstream: "pulmonic" },
+    'w': { type: "consonant", features: { manner: "approximant", place: "labial-velar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɺ': { type: "consonant", features: { manner: "lateral flap", place: "alveolar", voicing: "voiced" }, airstream: "pulmonic" },
+    'ɥ': { type: "consonant", features: { manner: "approximant", place: "labial-palatal", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʜ': { type: "consonant", features: { manner: "fricative", place: "epiglottal", voicing: "voiceless" }, airstream: "pulmonic" },
+    'ʢ': { type: "consonant", features: { manner: "fricative/approximant", place: "epiglottal", voicing: "voiced" }, airstream: "pulmonic" },
+    'ʡ': { type: "consonant", features: { manner: "plosive", place: "epiglottal", voicing: "voiceless" }, airstream: "pulmonic" },
+    //coarticulated
+    'ɧ': { type: "consonant", coarticulated: true, components: ["ʃ", "x"] },
+    //vowels
+    //front
+    'i': { type: "vowel", features: { height: "close", backness: "front", rounding: "unrounded" }, airstream: "pulmonic" },
+    'y': { type: "vowel", features: { height: "close", backness: "front", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɪ': { type: "vowel", features: { height: "near-close", backness: "front", rounding: "unrounded" }, airstream: "pulmonic" },
+    'ʏ': { type: "vowel", features: { height: "near-close", backness: "front", rounding: "rounded" }, airstream: "pulmonic" },
+    'e': { type: "vowel", features: { height: "close-mid", backness: "front", rounding: "unrounded" }, airstream: "pulmonic" },
+    'ø': { type: "vowel", features: { height: "close-mid", backness: "front", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɛ': { type: "vowel", features: { height: "open-mid", backness: "front", rounding: "unrounded" }, airstream: "pulmonic" },
+    'œ': { type: "vowel", features: { height: "open-mid", backness: "front", rounding: "rounded" }, airstream: "pulmonic" },
+    'æ': { type: "vowel", features: { height: "near-open", backness: "front", rounding: "unrounded" }, airstream: "pulmonic" },
+    //central
+    'ə': { type: "vowel", features: { height: "mid", backness: "central", rounding: "unrounded" }, airstream: "pulmonic" },
+    'ɨ': { type: "vowel", features: { height: "close", backness: "central", rounding: "unrounded" }, airstream: "pulmonic" },
+    'ʉ': { type: "vowel", features: { height: "close", backness: "central", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɘ': { type: "vowel", features: { height: "close-mid", backness: "central", rounding: "unrounded" }, airstream: "pulmonic" },
+    'ɵ': { type: "vowel", features: { height: "close-mid", backness: "central", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɜ': { type: "vowel", features: { height: "open-mid", backness: "central", rounding: "unrounded" }, airstream: "pulmonic" },
+    'ɞ': { type: "vowel", features: { height: "open-mid", backness: "central", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɐ': { type: "vowel", features: { height: "near-open", backness: "central", rounding: "unrounded" }, airstream: "pulmonic" },
+    //back
+    'ɯ': { type: "vowel", features: { height: "close", backness: "back", rounding: "unrounded" }, airstream: "pulmonic" },
+    'u': { type: "vowel", features: { height: "close", backness: "back", rounding: "rounded" }, airstream: "pulmonic" },
+    'ʊ': { type: "vowel", features: { height: "near-close", backness: "back", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɤ': { type: "vowel", features: { height: "close-mid", backness: "back", rounding: "unrounded" }, airstream: "pulmonic" },
+    'o': { type: "vowel", features: { height: "close-mid", backness: "back", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɔ': { type: "vowel", features: { height: "open-mid", backness: "back", rounding: "rounded" }, airstream: "pulmonic" },
+    'ɑ': { type: "vowel", features: { height: "open", backness: "back", rounding: "unrounded" }, airstream: "pulmonic" },
+    'ɒ': { type: "vowel", features: { height: "open", backness: "back", rounding: "rounded" }, airstream: "pulmonic" }
+
+}
+
+export default core

package/generate-config.js

@@ -0,0 +1,170 @@
+// generate-config.js
+
+import fs from 'fs';
+import path from 'path';
+
+import core from './core.js';
+import modifiers from './modifiers.js';
+
+
+// -----------------------------
+// GROUP IPA SYMBOLS BY TYPE
+// -----------------------------
+function groupByType(core) {
+  const groups = {};
+
+  for (const [symbol, data] of Object.entries(core)) {
+    const type = data.type || 'other';
+    if (!groups[type]) groups[type] = [];
+    groups[type].push(symbol);
+  }
+
+  return groups;
+}
+
+
+// -----------------------------
+// WRAP SYMBOL LINES
+// -----------------------------
+function wrapSymbols(symbols, perLine = 12) {
+  const lines = [];
+  for (let i = 0; i < symbols.length; i += perLine) {
+    lines.push('// ' + symbols.slice(i, i + perLine).join(' '));
+  }
+  return lines.join('\n');
+}
+
+
+// -----------------------------
+// IPA SECTION
+// -----------------------------
+function generateIPASection(core) {
+  const grouped = groupByType(core);
+
+  const sections = Object.entries(grouped).map(([type, symbols]) => {
+    symbols.sort((a, b) => a.localeCompare(b));
+
+    return [
+      `// ${type.toUpperCase()}`,
+      wrapSymbols(symbols),
+      ''
+    ].join('\n');
+  });
+
+  return [
+    '/**',
+    ' * IPA SYMBOL REFERENCE',
+    ' * Copy/paste symbols as needed',
+    ' */',
+    '',
+    ...sections
+  ].join('\n');
+}
+
+
+// -----------------------------
+// WRAP MODIFIERS HORIZONTALLY
+// -----------------------------
+function wrapModifiers(modList, maxLineLength = 90) {
+  const lines = [];
+  let currentLine = '// ';
+
+  modList.forEach((mod, index) => {
+    const separator = index === 0 ? '' : ' | ';
+    const nextChunk = separator + mod;
+
+    if ((currentLine + nextChunk).length > maxLineLength) {
+      lines.push(currentLine);
+      currentLine = '// ' + mod;
+    } else {
+      currentLine += nextChunk;
+    }
+  });
+
+  if (currentLine.trim()) lines.push(currentLine);
+
+  return lines.join('\n');
+}
+
+
+// -----------------------------
+// MODIFIER SECTION
+// -----------------------------
+function generateModifierSection(modifiers) {
+  const entries = Object.entries(modifiers);
+  entries.sort(([a], [b]) => a.localeCompare(b));
+
+  const formatted = entries.map(([key, data]) => {
+    const appliesTo = Array.isArray(data.appliesTo)
+      ? data.appliesTo.join(', ')
+      : data.appliesTo || '';
+    return `${key}(${appliesTo})`;
+  });
+
+  return [
+    '/**',
+    ' * MODIFIER REFERENCE',
+    ' * modifier(appliesTo)',
+    ' */',
+    '',
+    wrapModifiers(formatted),
+    ''
+  ].join('\n');
+}
+
+
+// -----------------------------
+// ORTHOGRAPHY EXPORT SECTION
+// -----------------------------
+function generateOrthographyExport() {
+  const commentedOrthography = [
+    '// k: ["k", ["aspirated"]],',
+    '// a: ["ɑ", ["more_rounded"]],',
+    '// x̱: [',
+    '//   ["k", ["ejective", "aspirated"]],',
+    '//   ["x", []]',
+    '// ],',
+    '// l: ["ɬ"]'
+  ].join('\n');
+
+  return [
+    '/**',
+    ' * ORTHOGRAPHY CONFIG',
+    ' * Use parseConfig() at runtime',
+    ' *',
+    ' * Fill in your orthography below; examples are commented out.',
+    ' */',
+    '',
+    "import { parseConfig } from './parser.js';",
+    '',
+    'const orthography = {',
+    commentedOrthography,
+    '};',
+    '',
+    'export default parseConfig(orthography);',
+    ''
+  ].join('\n');
+}
+
+
+// -----------------------------
+// MAIN GENERATOR
+// -----------------------------
+function generateConfig() {
+  const content = [
+    generateIPASection(core),
+    '',
+    generateModifierSection(modifiers),
+    '',
+    generateOrthographyExport()
+  ].join('\n');
+
+  const outputPath = path.join(process.cwd(), 'ipa.config.js');
+  fs.writeFileSync(outputPath, content, 'utf-8');
+
+  console.log('✅ ipa.config.js generated with parseConfig() export');
+}
+
+
+// RUN
+generateConfig();

package/generate-conlang.js

@@ -0,0 +1,120 @@
+import fs from "fs";
+import path from "path";
+import readline from "readline";
+import core from "./core.js";
+import modifiers from "./modifiers.js";
+
+/** Pick random element */
+const pickRandom = (arr) => arr[Math.floor(Math.random() * arr.length)];
+
+/** Shuffle array */
+const shuffle = (arr) => {
+  for (let i = arr.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [arr[i], arr[j]] = [arr[j], arr[i]];
+  }
+  return arr;
+};
+
+/** Prompt helper */
+function prompt(query) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  return new Promise((resolve) =>
+    rl.question(query, (ans) => {
+      rl.close();
+      resolve(ans);
+    })
+  );
+}
+
+/** Generate conlang orthography */
+function generateConlang({ alphabet, mod1Chance, mod2Chance, affricateChance }) {
+  const letters = alphabet.split("");
+  const usedIPA = new Set();
+  const orthography = {};
+  const coreKeys = shuffle(Object.keys(core));
+
+  letters.forEach((letter) => {
+    // Pick unused IPA
+    let ipaKey;
+    while (true) {
+      const candidate = pickRandom(coreKeys);
+      if (!usedIPA.has(candidate)) {
+        ipaKey = candidate;
+        usedIPA.add(candidate);
+        break;
+      }
+    }
+
+    const baseObj = core[ipaKey];
+    const modifiersList = [];
+
+    // Modifier 1
+    if (Math.random() < mod1Chance) {
+      const compatible = Object.entries(modifiers).filter(
+        ([, mod]) => !mod.appliesTo || mod.appliesTo.includes(baseObj?.type)
+      );
+      if (compatible.length) modifiersList.push(pickRandom(compatible)[0]);
+    }
+
+    // Modifier 2
+    if (Math.random() < mod2Chance && modifiersList.length) {
+      const compatible = Object.entries(modifiers).filter(
+        ([key, mod]) =>
+          !modifiersList.includes(key) &&
+          (!mod.appliesTo || mod.appliesTo.includes(baseObj?.type))
+      );
+      if (compatible.length) modifiersList.push(pickRandom(compatible)[0]);
+    }
+
+    // Plosive → affricate
+    if (baseObj?.features?.manner === "plosive" && Math.random() < affricateChance) {
+      const fricatives = Object.entries(core).filter(
+        ([, obj]) =>
+          obj?.features?.manner === "fricative" &&
+          obj.features.place === baseObj.features.place
+      );
+      if (fricatives.length) {
+        const fricKey = pickRandom(fricatives)[0];
+        orthography[letter] = [
+          [ipaKey, modifiersList],
+          [fricKey, []],
+        ];
+        return;
+      }
+    }
+
+    orthography[letter] = [ipaKey, modifiersList];
+  });
+
+  return orthography;
+}
+
+/** Main async function */
+async function main() {
+  const alphabet = (await prompt("Enter alphabet (default a-z): ")) || "abcdefghijklmnopqrstuvwxyz";
+  const mod1 = parseFloat((await prompt("Modifier 1 chance (default 0.33): ")) || "0.33");
+  const mod2 = parseFloat((await prompt("Modifier 2 chance (default 0.06): ")) || "0.06");
+  const aff = parseFloat((await prompt("Plosive → affricate chance (default 0.1): ")) || "0.1");
+
+  const orthography = generateConlang({
+    alphabet,
+    mod1Chance: mod1,
+    mod2Chance: mod2,
+    affricateChance: aff,
+  });
+
+  const outPath = path.join(process.cwd(), "generatedConlang.js");
+  const lines = Object.entries(orthography).map(
+    ([l, v]) => `  ${JSON.stringify(l)}:${JSON.stringify(v)}`
+  );
+  const content = `/** Generated conlang orthography */\nconst generatedOrthography={\n${lines.join(",\n")}\n};\nexport default generatedOrthography;`;
+
+  fs.writeFileSync(outPath, content, "utf-8");
+  console.log("✅ generatedConlang.js written");
+}
+
+main();

package/index.js

@@ -0,0 +1,9 @@
+// Import your data layers
+import core from "./core.js";           // base consonants & vowels
+import modifiers from "./modifiers.js"; // diacritics, tones, suprasegmentals
+import rules from "./rules.js";         // modifier compatibility rules
+import parser from "./parser.js";       // parser (parsePhoneme, parseUnit, parseConfig)
+
+// Export the layers so users can access them if needed
+export const { parsePhoneme, parseUnit, parseConfig } = parser;
+export { core, modifiers, rules, parser };

package/modifiers.js

@@ -0,0 +1,250 @@
+const modifiers = {
+  // DIACRITICS
+
+  voiceless: {
+    symbol: "̥",
+    appliesTo: "consonant",
+    effects: { voicing: "voiceless" }
+  },
+  voiced: {
+    symbol: "̬",
+    appliesTo: "consonant",
+    effects: { voicing: "voiced" }
+  },
+  aspirated: {
+    symbol: "ʰ",
+    appliesTo: "consonant",
+    effects: { aspiration: true }
+  },
+
+  more_rounded: {
+    symbol: "̹",
+    appliesTo: "vowel",
+    effects: { rounding: "more" }
+  },
+  less_rounded: {
+    symbol: "̜",
+    appliesTo: "vowel",
+    effects: { rounding: "less" }
+  },
+
+  advanced: {
+    symbol: "̟",
+    appliesTo: "consonant",
+    effects: { placeModifier: "advanced" }
+  },
+  retracted: {
+    symbol: "̠",
+    appliesTo: "consonant",
+    effects: { placeModifier: "retracted" }
+  },
+
+  centralized: {
+    symbol: "̈",
+    appliesTo: "vowel",
+    effects: { backness: "centralized" }
+  },
+  mid_centralized: {
+    symbol: "̽",
+    appliesTo: "vowel",
+    effects: { backness: "mid-centralized" }
+  },
+
+  syllabic: {
+    symbol: "̩",
+    appliesTo: "consonant",
+    effects: { syllabic: true }
+  },
+  non_syllabic: {
+    symbol: "̯",
+    appliesTo: "vowel",
+    effects: { syllabic: false }
+  },
+
+  dental: {
+    symbol: "̪",
+    appliesTo: "consonant",
+    effects: { placeModifier: "dental" }
+  },
+  apical: {
+    symbol: "̺",
+    appliesTo: "consonant",
+    effects: { articulation: "apical" }
+  },
+  laminal: {
+    symbol: "̻",
+    appliesTo: "consonant",
+    effects: { articulation: "laminal" }
+  },
+
+  velarized_or_pharyngealized: {
+    symbol: "ˠ",
+    appliesTo: "consonant",
+    effects: { secondaryArticulation: "velarized_or_pharyngealized" }
+  },
+  velarized: {
+    symbol: "̴",
+    appliesTo: "consonant",
+    effects: { secondaryArticulation: "velarized" }
+  },
+  palatalized: {
+    symbol: "ʲ",
+    appliesTo: "consonant",
+    effects: { secondaryArticulation: "palatalized" }
+  },
+  labialized: {
+    symbol: "ʷ",
+    appliesTo: "consonant",
+    effects: { secondaryArticulation: "labialized" }
+  },
+  pharyngealized: {
+    symbol: "ˤ",
+    appliesTo: "consonant",
+    effects: { secondaryArticulation: "pharyngealized" }
+  },
+
+  nasalized: {
+    symbol: "̃",
+    appliesTo: ["vowel", "consonant"],
+    effects: { nasalization: true }
+  },
+
+  rhoticity: {
+    symbol: "˞",
+    appliesTo: "vowel",
+    effects: { rhotic: true }
+  },
+
+  length_half_long: {
+    symbol: "ˑ",
+    appliesTo: ["vowel", "consonant"],
+    effects: { length: "half-long" }
+  },
+  length_long: {
+    symbol: "ː",
+    appliesTo: ["vowel", "consonant"],
+    effects: { length: "long" }
+  },
+  extra_short: {
+    symbol: "̆",
+    appliesTo: ["vowel", "consonant"],
+    effects: { length: "extra-short" }
+  },
+
+  voiceless_flap: {
+    symbol: "̥̆",
+    appliesTo: "consonant",
+    effects: {
+      voicing: "voiceless",
+      mannerModifier: "flap"
+    }
+  },
+
+  creaky_voice: {
+    symbol: "̰",
+    appliesTo: ["vowel", "consonant"],
+    effects: { phonation: "creaky" }
+  },
+  breathy_voice: {
+    symbol: "̤",
+    appliesTo: ["vowel", "consonant"],
+    effects: { phonation: "breathy" }
+  },
+
+  linguolabial: {
+    symbol: "̼",
+    appliesTo: "consonant",
+    effects: { placeModifier: "linguolabial" }
+  },
+
+  raised: {
+    symbol: "̝",
+    appliesTo: ["vowel", "consonant"],
+    effects: { heightModifier: "raised" }
+  },
+  lowered: {
+    symbol: "̞",
+    appliesTo: ["vowel", "consonant"],
+    effects: { heightModifier: "lowered" }
+  },
+
+  advanced_tongue_root: {
+    symbol: "̘",
+    appliesTo: "vowel",
+    effects: { tongueRoot: "advanced" }
+  },
+  retracted_tongue_root: {
+    symbol: "̙",
+    appliesTo: "vowel",
+    effects: { tongueRoot: "retracted" }
+  },
+
+  // TONES / ACCENTS
+
+  high_tone: {
+    symbol: "́",
+    appliesTo: ["vowel", "consonant"],
+    effects: { tone: "high" }
+  },
+  low_tone: {
+    symbol: "̀",
+    appliesTo: ["vowel", "consonant"],
+    effects: { tone: "low" }
+  },
+  rising_tone: {
+    symbol: "̌",
+    appliesTo: ["vowel", "consonant"],
+    effects: { tone: "rising" }
+  },
+  falling_tone: {
+    symbol: "̂",
+    appliesTo: ["vowel", "consonant"],
+    effects: { tone: "falling" }
+  },
+  extra_high_tone: {
+    symbol: "᷄",
+    appliesTo: ["vowel", "consonant"],
+    effects: { tone: "extra-high" }
+  },
+  extra_low_tone: {
+    symbol: "᷅",
+    appliesTo: ["vowel", "consonant"],
+    effects: { tone: "extra-low" }
+  },
+
+  extra_high_pitch: {
+    symbol: "᷄",
+    appliesTo: ["vowel", "consonant"],
+    effects: { pitch: "extra-high" }
+  },
+  extra_low_pitch: {
+    symbol: "᷅",
+    appliesTo: ["vowel", "consonant"],
+    effects: { pitch: "extra-low" }
+  },
+
+  downstep: {
+    symbol: "ꜜ",
+    appliesTo: ["vowel", "consonant"],
+    effects: { toneModifier: "downstep" }
+  },
+  upstep: {
+    symbol: "ꜛ",
+    appliesTo: ["vowel", "consonant"],
+    effects: { toneModifier: "upstep" }
+  },
+
+  no_audible_release: {
+    symbol: "̚",
+    appliesTo: "consonant",
+    effects: { release: "none" }
+  },
+  //ejective
+  ejective: {
+  symbol: "ʼ",
+  appliesTo: "consonant",
+  effects: { airstream: "egressive_glottalic" } // or just mark it as ejective
+}
+};
+
+export default modifiers;

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "ipa-core",
+  "version": "1.0.0",
+  "description": "Language-agnostic IPA core with features",
+  "license": "ISC",
+  "author": "Cody Bruno",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "test": "node test.js",
+    "init:ipa": "node generate-config.js",
+    "make-conlang": "node generate-conlang.js"
+  },
+  "keywords": ["ipa", "phoneme", "language", "linguistics"]
+}

package/parser.js

@@ -0,0 +1,137 @@
+// parser.js
+
+import core from "./core";
+import modifiers from "./modifiers";
+import rules from "./rules";
+
+/**
+ * Parses a single phoneme with optional modifiers.
+ * @param {string} base - Base IPA symbol
+ * @param {string[]} appliedModifiers - List of modifier keys
+ * @returns {object} - Full feature object
+ */
+function parsePhoneme(base, appliedModifiers = []) {
+  const baseObj = core[base];
+  if (!baseObj) {
+    throw new Error(`Unknown base phoneme: ${base}`);
+  }
+
+  let features = { ...baseObj.features };
+  const modifiersApplied = [];
+
+  for (const modKey of appliedModifiers) {
+    const mod = modifiers[modKey];
+    if (!mod) {
+      throw new Error(`Unknown modifier: ${modKey}`);
+    }
+
+    const incompatible = rules[modKey]?.incompatibleWith || [];
+    const conflict = modifiersApplied.find(applied => incompatible.includes(applied));
+    if (conflict) {
+      console.warn(`Modifier "${modKey}" is incompatible with already applied "${conflict}". Skipping.`);
+      continue;
+    }
+
+    if (mod.features) {
+      features = { ...features, ...mod.features };
+    } else {
+      features[modKey] = true;
+    }
+
+    modifiersApplied.push(modKey);
+  }
+
+  return {
+    base,
+    symbol: baseObj.symbol || base,
+    features,
+    modifiersApplied
+  };
+}
+
+/**
+ * Helper to create a phoneme unit for orthography config.
+ * Can be a single phoneme or a sequence object.
+ * @param {string|object} unit - Single base or a sequence object
+ * @param {string[]} appliedModifiers - Modifiers for single phoneme (ignored if sequence)
+ * @returns {object}
+ */
+function parseUnit(unit, appliedModifiers = []) {
+  // if unit is a string, treat as single phoneme
+  if (typeof unit === "string") {
+    return { type: "single", base: unit, modifiers: appliedModifiers };
+  }
+
+  // if unit is an object with multiple phonemes, treat as sequence
+  if (typeof unit === "object") {
+    const sequence = [];
+    for (const base in unit) {
+      const mods = unit[base] || [];
+      sequence.push({ base, modifiers: mods });
+    }
+    return { type: "sequence", sequence };
+  }
+
+  throw new Error(`Invalid unit: ${unit}`);
+}
+
+/**
+ * Parses a unit (single or sequence) into full feature objects
+ * @param {object} unitObj
+ * @returns {object|array} - Parsed phoneme object or array of parsed phonemes
+ */
+function parseUnitObj(unitObj) {
+  if (unitObj.type === "single") {
+    return parsePhoneme(unitObj.base, unitObj.modifiers);
+  }
+
+  if (unitObj.type === "sequence") {
+    return unitObj.sequence.map(u => parsePhoneme(u.base, u.modifiers));
+  }
+
+  throw new Error(`Unknown unit type: ${unitObj.type}`);
+}
+
+/**
+ * Parses an entire orthography config.
+ * Supports:
+ * 1) Full parseUnit() objects
+ * 2) Single-phoneme shorthand: ["base", ["modifiers"]]
+ * 3) Sequence shorthand: [["base1", ["mods1"]], ["base2", ["mods2"]], ...]
+ * @param {object} config - { letter: parseUnit(...) OR shorthand }
+ * @returns {object} parsed - { letter: parsedPhoneme OR array if sequence }
+ */
+function parseConfig(config) {
+  const parsed = {};
+
+  for (const letter in config) {
+    const val = config[letter];
+
+    let unitObj;
+
+    // Already a parseUnit object
+    if (val && typeof val === "object" && val.type && (val.type === "single" || val.type === "sequence")) {
+      unitObj = val;
+    }
+    // Shorthand single phoneme: ["base", ["modifiers"]]
+    else if (Array.isArray(val) && typeof val[0] === "string") {
+      const base = val[0];
+      const mods = Array.isArray(val[1]) ? val[1] : [];
+      unitObj = { type: "single", base, modifiers: mods };
+    }
+    // Shorthand sequence: [["base1", ["mods1"]], ["base2", ["mods2"]], ...]
+    else if (Array.isArray(val) && val.every(el => Array.isArray(el) && typeof el[0] === "string")) {
+      const sequence = val.map(([base, mods]) => ({ base, modifiers: Array.isArray(mods) ? mods : [] }));
+      unitObj = { type: "sequence", sequence };
+    }
+    else {
+      throw new Error(`Invalid orthography entry for "${letter}": ${JSON.stringify(val)}`);
+    }
+
+    parsed[letter] = parseUnitObj(unitObj);
+  }
+
+  return parsed;
+}
+
+export { parsePhoneme, parseUnit, parseConfig };

package/rules.js

@@ -0,0 +1,52 @@
+//modifier compatability
+const rules = {
+  // Voicing / phonation
+  voiceless: { incompatibleWith: ["voiced", "creaky_voice", "breathy_voice"] },
+  voiced: { incompatibleWith: ["voiceless", "voiceless_flap"] },
+  voiceless_flap: { incompatibleWith: ["voiced", "aspirated"] },
+  creaky_voice: { incompatibleWith: ["voiceless"] },
+  breathy_voice: { incompatibleWith: ["voiceless"] },
+
+  // Place / articulation
+  advanced: { incompatibleWith: ["retracted", "velarized_or_pharyngealized"] },
+  retracted: { incompatibleWith: ["advanced", "velarized_or_pharyngealized"] },
+  palatalized: { incompatibleWith: ["velarized_or_pharyngealized"] },
+  velarized_or_pharyngealized: { incompatibleWith: ["palatalized", "advanced", "retracted"] },
+  pharyngealized: { incompatibleWith: ["palatalized"] },
+  linguolabial: { incompatibleWith: [] },
+  dental: { incompatibleWith: [] },
+  apical: { incompatibleWith: [] },
+  laminal: { incompatibleWith: [] },
+  velarized: { incompatibleWith: ["palatalized", "advanced", "retracted"] },
+
+  // Syllabicity
+  syllabic: { incompatibleWith: ["non_syllabic"] },
+  non_syllabic: { incompatibleWith: ["syllabic"] },
+
+  // Nasalization / rhoticity
+  nasalized: { incompatibleWith: [] },
+  rhoticity: { incompatibleWith: [] },
+
+  // Length / duration
+  extra_short: { incompatibleWith: ["length_half_long", "length_long"] },
+  length_half_long: { incompatibleWith: ["extra_short", "length_long"] },
+  length_long: { incompatibleWith: ["extra_short", "length_half_long"] },
+
+  // Segment-level tones / accents
+  high_tone: { incompatibleWith: ["low_tone", "falling_tone", "extra_low_tone"] },
+  low_tone: { incompatibleWith: ["high_tone", "rising_tone", "extra_high_tone"] },
+  rising_tone: { incompatibleWith: ["falling_tone", "low_tone"] },
+  falling_tone: { incompatibleWith: ["rising_tone", "high_tone"] },
+  extra_high_tone: { incompatibleWith: ["extra_low_tone", "low_tone"] },
+  extra_low_tone: { incompatibleWith: ["extra_high_tone", "high_tone"] },
+  downstep: { incompatibleWith: [] },
+  upstep: { incompatibleWith: [] },
+  extra_high_pitch: { incompatibleWith: ["extra_low_pitch"] },
+  extra_low_pitch: { incompatibleWith: ["extra_high_pitch"] },
+
+  // Special consonant markers
+  aspirated: { incompatibleWith: ["voiceless_flap", "no_audible_release"] },
+  no_audible_release: { incompatibleWith: ["aspirated"] }
+};
+
+module.exports = rules

package/test.js

@@ -0,0 +1,60 @@
+// test.js
+
+const { parseUnit, parseConfig } = require("./parser");
+
+// Sample orthography config
+const orthography = {
+  // A single consonant with a modifier
+  k: parseUnit("k", ["aspirated"]),
+
+  // A single vowel with a modifier
+  a: parseUnit("ɑ", ["more_rounded"]),
+
+  // A consonant sequence (affricate)
+  x̱: parseUnit({
+    k: ["ejective", "aspirated"],
+    x: []
+  }),
+
+  // Another single consonant
+  l: parseUnit("ɬ")
+};
+
+// Another sample orthography config using shorthand
+const shorthandOrthography = {
+  // A single consonant with a modifier
+  k: ["k", ["aspirated"]],
+
+  // A single vowel with a modifier
+  a: ["ɑ", ["more_rounded"]],
+
+  // A consonant sequence (affricate)
+  x̱: [[
+    'k', ["ejective", "aspirated"],
+    'x', []
+]],
+
+  // Another single consonant
+  l: ["ɬ"]
+};
+
+console.log("=== Orthography Config ===");
+console.log(JSON.stringify(orthography, null, 2));
+
+const parsed = parseConfig(orthography);
+console.log("\n=== Parsed Output ===");
+console.log(JSON.stringify(parsed, null, 2));
+
+// Optional: inspect a single phoneme
+const singlePhoneme = parsed.k;
+console.log("\n=== Single Phoneme 'k' Features ===");
+console.log(singlePhoneme);
+
+// Optional: inspect a sequence
+const affricateSequence = parsed.x̱;
+console.log("\n=== Affricate Sequence 'x̱' Features ===");
+console.log(affricateSequence);
+
+const parsedShorthand = parseConfig(shorthandOrthography);
+console.log("\n=== Parsed Output2 ===");
+console.log(JSON.stringify(parsedShorthand, null, 2));