@yomiscript/core 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# @yomiscript/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+YomiScript: the notation in which an LLM (or any Yomite) writes how a text is read, and a Katarite turns it into
+sound. Specification: `spec/yomiscript/README.md` in the repository.
+
+- `parse(ys)`: an utterance -> language sections -> tokens (morae / syllables, boundaries, pauses), with `<f0:…>`
+  pitch values and the original text of each span (`<t:…>`, D23). Errors explain what to write instead.
+- `realize(ys, { dialect })`: the reference rule-based prosody (accent / stress / tone marks -> `<f0:…>` values).
+- `Katarite`, `Speech`, `SpanTime`: the interface every Katarite offers (YomiScript in; audio and when each span is
+  spoken out).
+- `YOMISCRIPT_INSTRUCTIONS`: what an LLM needs to write YomiScript; the description of the `speak` tool in the MCP
+  server and the gui-chat-protocol plugin.
+- `LoadBytes`: how a Katarite's engine reads a model file. `@yomiscript/core/node` has `cachedLoader({ dir, baseUrl })`,
+  which reads from a directory and downloads a missing file into it once (Node only).

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./yomiscript.ts";
+export * from "./yomite.ts";
+export * from "./katarite.ts";
+export * from "./instructions.ts";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./yomiscript.js";
+export * from "./yomite.js";
+export * from "./katarite.js";
+export * from "./instructions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC"}

package/dist/instructions.d.ts

@@ -0,0 +1 @@
+export declare const YOMISCRIPT_INSTRUCTIONS = "Write what you want to say as YomiScript, a pronunciation notation: you decide how every word is read, from its context.\n\n- One utterance: `<lang> /\u2026 \u2198/` for a statement, `<lang> /\u2026 \u2197/` for a question. `<lang>` is a BCP 47 tag (`ja`, `en-US`).\n- The pronunciation is IPA, as the words are actually spoken: numbers, dates, symbols and abbreviations spelled out, and each word read the way it is meant here.\n  - Japanese: phonemic IPA, mora by mora. Rows: a i \u026F e o; ka ki k\u026F ke ko (k\u02B2a k\u02B2\u026F k\u02B2o); sa \u0255i s\u026F se so (\u0255a \u0255\u026F \u0255o); dza d\u0291i dz\u026F dze dzo; ta t\u0255i ts\u026F te to (t\u0255a t\u0255\u026F t\u0255o); da de do; na \u0272i n\u026F ne no (\u0272a \u0272\u026F \u0272o); ha \u00E7i \u0278\u026F he ho (\u00E7a \u00E7\u026F \u00E7o); ba bi b\u026F be bo; pa pi p\u026F pe po; ma mi m\u026F me mo (m\u02B2a\u2026); ja j\u026F jo; wa; \u027Ea \u027Ei \u027E\u026F \u027Ee \u027Eo (\u027E\u02B2a\u2026). Loanword sounds: ti di t\u026F \u0278a \u0278i \u0278e \u0278o wi we wo tsa va. Particles: \u306F `wa`, \u3078 `e`, \u3092 `o`. Long vowel `\u02D0` as pronounced (\u5148\u751F `se\u02D0se\u02D0`). Geminate: double the next consonant (`kitte`; before t\u0255 / ts write `t`: `matt\u0255i`), `\u0294` before a vowel or at the end. \u30F3: `m` before p b m, `n` before t d n \u027E dz, `\u0272` before t\u0255 d\u0291 \u0272, `\u014B` before k \u0261, `\u0274` otherwise. Latin letters and symbols as a Japanese speaker says them (iPhone `ai\u0278o\u0274`). Separate words with spaces.\n  - English: IPA with `\u02C8` / `\u02CC` stress at the start of the syllable, `.` between syllables, spaces between words.\n- ` \u2016 ` marks a pause (a comma). Several sentences stay one utterance: end each inner sentence with ` \u2198 ` or ` \u2197 `.\n- After each word, write the text it reads in `<t:\u2026>`, so that joining them gives back your text exactly: punctuation goes with the word before it (`des\u026F<t:\u3067\u3059\u3002>`) or in its own `<t:\u2026>` where nothing is spoken (`\u2016<t:\u3001>`); in English write the spaces too (`\u02C8w\u025Dld<t: world.>`).\n- No pitch values and no accent marks: the synthesizer makes the prosody.\n\nExamples:\nja /\u0255\u026F\u02D0mats\u026F<t:\u9031\u672B> wa<t:\u306F> \u2016<t:\u3001> tomodat\u0255i<t:\u53CB\u9054> to<t:\u3068> k\u02B2o\u02D0to<t:\u4EAC\u90FD> e<t:\u3078> ik\u026F<t:\u884C\u304F> jote\u02D0<t:\u4E88\u5B9A> des\u026F<t:\u3067\u3059\u3002> \u2198/\nja /ts\u026Fitat\u0255i<t:\u4E00\u65E5> ka\u027Ea<t:\u304B\u3089> mikka<t:\u4E09\u65E5> made<t:\u307E\u3067> jas\u026Fmi<t:\u4F11\u307F> des\u026F<t:\u3067\u3059\u3002> \u2198/\nen-US /\u02CCa\u026A<t:I> \u02C8\u0279\u025Bd<t: read> \u00F0\u0259<t: the> \u02C8l\u025B.\u027E\u0259\u0279<t: letter> \u02C8twa\u026As<t: twice,> \u2016 \u02CCb\u028Ct<t: but> \u026At<t: it> \u02C8st\u026Al<t: still> \u02CCme\u026Ad<t: made> \u02C8no\u028A<t: no> \u02C8s\u025Bns<t: sense.> \u2198/";

package/dist/instructions.js

@@ -0,0 +1,17 @@
+// The instructions an LLM needs to write YomiScript for a Katarite: the text of a tool description (MCP, gui-chat-protocol)
+// or a system prompt. The same subset was measured in eval/browser_tts (prompt.md there is the experiment's frozen copy).
+export const YOMISCRIPT_INSTRUCTIONS = `Write what you want to say as YomiScript, a pronunciation notation: you decide how every word is read, from its context.
+
+- One utterance: \`<lang> /… ↘/\` for a statement, \`<lang> /… ↗/\` for a question. \`<lang>\` is a BCP 47 tag (\`ja\`, \`en-US\`).
+- The pronunciation is IPA, as the words are actually spoken: numbers, dates, symbols and abbreviations spelled out, and each word read the way it is meant here.
+  - Japanese: phonemic IPA, mora by mora. Rows: a i ɯ e o; ka ki kɯ ke ko (kʲa kʲɯ kʲo); sa ɕi sɯ se so (ɕa ɕɯ ɕo); dza dʑi dzɯ dze dzo; ta tɕi tsɯ te to (tɕa tɕɯ tɕo); da de do; na ɲi nɯ ne no (ɲa ɲɯ ɲo); ha çi ɸɯ he ho (ça çɯ ço); ba bi bɯ be bo; pa pi pɯ pe po; ma mi mɯ me mo (mʲa…); ja jɯ jo; wa; ɾa ɾi ɾɯ ɾe ɾo (ɾʲa…). Loanword sounds: ti di tɯ ɸa ɸi ɸe ɸo wi we wo tsa va. Particles: は \`wa\`, へ \`e\`, を \`o\`. Long vowel \`ː\` as pronounced (先生 \`seːseː\`). Geminate: double the next consonant (\`kitte\`; before tɕ / ts write \`t\`: \`mattɕi\`), \`ʔ\` before a vowel or at the end. ン: \`m\` before p b m, \`n\` before t d n ɾ dz, \`ɲ\` before tɕ dʑ ɲ, \`ŋ\` before k ɡ, \`ɴ\` otherwise. Latin letters and symbols as a Japanese speaker says them (iPhone \`aiɸoɴ\`). Separate words with spaces.
+  - English: IPA with \`ˈ\` / \`ˌ\` stress at the start of the syllable, \`.\` between syllables, spaces between words.
+- \` ‖ \` marks a pause (a comma). Several sentences stay one utterance: end each inner sentence with \` ↘ \` or \` ↗ \`.
+- After each word, write the text it reads in \`<t:…>\`, so that joining them gives back your text exactly: punctuation goes with the word before it (\`desɯ<t:です。>\`) or in its own \`<t:…>\` where nothing is spoken (\`‖<t:、>\`); in English write the spaces too (\`ˈwɝld<t: world.>\`).
+- No pitch values and no accent marks: the synthesizer makes the prosody.
+
+Examples:
+ja /ɕɯːmatsɯ<t:週末> wa<t:は> ‖<t:、> tomodatɕi<t:友達> to<t:と> kʲoːto<t:京都> e<t:へ> ikɯ<t:行く> joteː<t:予定> desɯ<t:です。> ↘/
+ja /tsɯitatɕi<t:一日> kaɾa<t:から> mikka<t:三日> made<t:まで> jasɯmi<t:休み> desɯ<t:です。> ↘/
+en-US /ˌaɪ<t:I> ˈɹɛd<t: read> ðə<t: the> ˈlɛ.ɾəɹ<t: letter> ˈtwaɪs<t: twice,> ‖ ˌbʌt<t: but> ɪt<t: it> ˈstɪl<t: still> ˌmeɪd<t: made> ˈnoʊ<t: no> ˈsɛns<t: sense.> ↘/`;
+//# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,0HAA0H;AAE1H,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;sKAa+H,CAAC"}

package/dist/katarite.d.ts

@@ -0,0 +1,23 @@
+export interface SpanTime {
+    /** index into parse(ys).texts */
+    span: number;
+    /** seconds from the start of the audio */
+    start: number;
+    end: number;
+}
+export interface Speech {
+    samples: Float32Array;
+    sampleRate: number;
+    /** the original text of each span (<t:…>), empty when the YomiScript has none */
+    texts: string[];
+    /** when each span is spoken; may be empty when the engine cannot tell */
+    times: SpanTime[];
+}
+export interface Katarite {
+    readonly name: string;
+    /** the languages it speaks (BCP 47 primary tags) */
+    readonly languages: readonly string[];
+    speak(ys: string): Promise<Speech>;
+}
+/** how a Katarite's engine reads a file of its model directory (in the browser a fetch, in Node a file or a download) */
+export type LoadBytes = (path: string) => Promise<Uint8Array | ArrayBuffer>;

package/dist/katarite.js

@@ -0,0 +1,4 @@
+// What every Katarite offers to the apps (CLI, MCP server, gui-chat-protocol plugin): YomiScript in, audio out,
+// and when each <t:…> span (D23) is spoken, so the text can be shown and the current word highlighted.
+export {};
+//# sourceMappingURL=katarite.js.map

package/dist/katarite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"katarite.js","sourceRoot":"","sources":["../src/katarite.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,uGAAuG"}

package/dist/node.d.ts

@@ -0,0 +1,11 @@
+import type { LoadBytes } from "./katarite.ts";
+export interface CachedLoaderOptions {
+    /** the directory the files are read from and downloaded into */
+    dir: string;
+    /** where missing files are downloaded from (ends with "/"); none: a missing file is an error */
+    baseUrl?: string;
+    /** called before each download, e.g. to tell the user (the first run downloads hundreds of MB) */
+    onDownload?: (url: string) => void;
+    fetch?: typeof globalThis.fetch;
+}
+export declare function cachedLoader({ dir, baseUrl, onDownload, fetch }: CachedLoaderOptions): LoadBytes;

package/dist/node.js

@@ -0,0 +1,29 @@
+// What the Node Katarites share: a loader that reads model files from a directory and, when a file is missing,
+// downloads it once from a base URL (Hugging Face) into that directory.
+import fs from "node:fs/promises";
+import path from "node:path";
+const missing = (e) => e.code === "ENOENT";
+export function cachedLoader({ dir, baseUrl, onDownload, fetch = globalThis.fetch }) {
+    return async (file) => {
+        const local = path.join(dir, file);
+        try {
+            return new Uint8Array(await fs.readFile(local));
+        }
+        catch (e) {
+            if (!missing(e) || !baseUrl)
+                throw e;
+        }
+        const url = new URL(file, baseUrl).href;
+        onDownload?.(url);
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`download failed: ${url} (${res.status} ${res.statusText})`);
+        const bytes = new Uint8Array(await res.arrayBuffer());
+        await fs.mkdir(path.dirname(local), { recursive: true });
+        const tmp = `${local}.${process.pid}.part`; // written whole, then renamed: an interrupted download leaves no file
+        await fs.writeFile(tmp, bytes);
+        await fs.rename(tmp, local);
+        return bytes;
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,wEAAwE;AACxE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,MAAM,OAAO,GAAG,CAAC,CAAU,EAAE,EAAE,CAAE,CAA2B,CAAC,IAAI,KAAK,QAAQ,CAAC;AAE/E,MAAM,UAAU,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,EAAuB;IACtG,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;gBAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;QACxC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,KAAK,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;QAC1F,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,sEAAsE;QAClH,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/yomiscript.d.ts

@@ -0,0 +1,54 @@
+export type TokenKind = "unit" | "space" | "pause" | "bound" | "punct" | "end";
+/** Japanese mora kinds: a mora, the moraic nasal N, a geminate / glottal stop Q, a long vowel R */
+export type MoraKind = "mora" | "N" | "Q" | "R";
+export interface Token {
+  kind: TokenKind;
+  /** accent phrase index within the section */
+  ph: number;
+  /** boundary / punctuation / end symbol ('#', '_', '.', '?', or the text of <p:…>) */
+  sym?: string;
+  /** a sentence end inside the utterance (' ↘ ' / ' ↗ ') */
+  sent?: boolean;
+  /** pitch values written after the unit */
+  f0?: number[] | null;
+  /** the <t:…> span this unit reads (index into Utterance.texts, D23) */
+  span?: number;
+  start?: number;
+  end?: number;
+  vend?: number;
+  lang?: string;
+  mk?: MoraKind;
+  on?: string;
+  v?: string;
+  ipa?: string;
+  dev?: boolean;
+  rise?: boolean;
+  fall?: boolean;
+  chunk?: number;
+  k?: number;
+  hasRise?: boolean;
+  raw?: string;
+  j?: number;
+  nsyl?: number;
+  st?: string;
+  tone?: string;
+}
+export interface Section {
+  lang: string;
+  text: string;
+  base: number;
+  end: "$" | "?";
+  toks: Token[];
+}
+export interface Utterance {
+  /** the string as written (trimmed), annotations included */
+  ys: string;
+  top: string;
+  end: "$" | "?";
+  sections: Section[];
+  /** the original text of each span (<t:…>, D23), in order */
+  texts: string[];
+}
+export declare const isJa: (l: string) => boolean;
+export declare const VOWELS = "aeiou\u00E6\u0251\u0252\u0254\u0259\u025A\u025B\u025C\u026A\u028A\u028C\u1D4A\u0250\u00F8\u0153";
+export declare function parse(written: string): Utterance;

package/dist/yomiscript.js

@@ -0,0 +1,403 @@
+// YomiScript notation — no engine, voice or language rules.
+// Utterance: `<lang> /… ↘/` (or ↗ for a question), lang = BCP 47 language (no dialect tags). Inside: ` | ` accent phrase,
+// ` ‖ ` breath group / pause, `{<lang> …}` a section in another language.
+// parse(): utterance -> language sections -> tokens (units = mora / syllable, plus space / pause / boundary / end).
+// Accent, stress and tone marks are kept on the tokens; pitch values <f0:v,…> (semitones relative to the
+// speaker's register) attach to the unit right before them. Offsets point into the trimmed utterance string.
+const LANG = "[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*";
+const UTT = new RegExp(`^(${LANG})\\s*/(.*?)\\s*([↘↗])\\s*/$`, "s");
+const TAG = new RegExp(`\\{(${LANG}) ([^{}]*)\\}`, "g");
+export const isJa = (l) => l === "ja" || l.startsWith("ja-");
+export const VOWELS = "aeiouæɑɒɔəɚɛɜɪʊʌᵊɐøœ"; // IPA vowel letters of the syllable languages (en, fr); diacritics follow them
+const SEPS = { "|": "#", "‖": "_" }; // internal names: '#' accent phrase, '_' pause
+const SEP = (s) => (s !== undefined && SEPS[s]) || null;
+const inStr = (ch, s) => s.includes(ch);
+function f0At(s, i) {
+  // '<f0:1.5,-2>' at i -> [values, index after '>'] or null
+  if (!s.startsWith("<f0:", i)) return null;
+  const j = s.indexOf(">", i);
+  if (j < 0) throw new Error(`unclosed <f0: in ${JSON.stringify(s)}`);
+  const v = s
+    .slice(i + 4, j)
+    .split(",")
+    .map(Number);
+  if (v.some((x) => isNaN(x))) throw new Error(`bad pitch value ${s.slice(i, j + 1)}`);
+  return [v, j + 1];
+}
+function whyNot(s) {
+  if (!s) return "empty input";
+  if (/^\^|[$?]$/.test(s)) return "old notation (^…$ / ^lang|…); write  <lang> /… ↘/";
+  if (!new RegExp(`^${LANG}\\s*/`).test(s)) return 'missing language tag before the opening "/" (e.g. "ja /")';
+  if (!/\/\s*$/.test(s)) return 'missing closing "/"';
+  if (!/[↘↗]\s*\/\s*$/.test(s)) return 'missing sentence-final ↘ or ↗ before the closing "/"';
+  return "not YomiScript";
+}
+function takeTexts(ys) {
+  let out = "";
+  const map = [],
+    texts = [];
+  for (let i = 0; i < ys.length;) {
+    if (ys.startsWith("<t:", i)) {
+      const j = ys.indexOf(">", i);
+      if (j < 0) throw new Error(`unclosed <t: in ${JSON.stringify(ys)}`);
+      texts.push({ text: ys.slice(i + 3, j), at: out.length });
+      i = j + 1;
+    } else {
+      map.push(i);
+      out += ys[i++];
+    }
+  }
+  map.push(ys.length);
+  return { out, map, texts };
+}
+function spanOf(texts, t) {
+  if (t.kind !== "unit" || !texts.length || t.end === undefined) return;
+  const end = t.end;
+  const k = texts.findIndex((x) => x.at >= end);
+  if (k >= 0) t.span = k;
+}
+function mapOffsets(map, t) {
+  if (typeof t.start === "number") t.start = map[t.start];
+  // exclusive ends: one past the last character
+  if (t.end !== undefined && t.end > 0) t.end = map[t.end - 1] + 1;
+  if (t.vend !== undefined && t.vend > 0) t.vend = map[t.vend - 1] + 1;
+}
+function placeTexts(S, T) {
+  // each unit gets the span it reads (index into texts), then offsets go back to the annotated string
+  for (const sec of S) {
+    sec.base = T.map[sec.base];
+    for (const t of sec.toks) {
+      spanOf(T.texts, t);
+      mapOffsets(T.map, t);
+    }
+  }
+}
+function splitSections(top, b, b0) {
+  // the top language and the {<lang> …} sections in order, with their offsets
+  const P = [];
+  let pos = 0;
+  for (const mm of b.matchAll(TAG)) {
+    const at = mm.index ?? 0;
+    P.push([top, pos, b.slice(pos, at)], [mm[1], at + mm[1].length + 2, mm[2]]);
+    pos = at + mm[0].length;
+  }
+  P.push([top, pos, b.slice(pos)]);
+  const S = [];
+  for (const [l, s, x] of P) {
+    let a = 0,
+      z = x.length;
+    while (a < z && inStr(x[a], " |‖")) a++;
+    while (z > a && inStr(x[z - 1], " |‖")) z--;
+    if (a < z) S.push({ lang: l, text: x.slice(a, z), base: b0 + s + a });
+  }
+  return S;
+}
+export function parse(written) {
+  written = written.trim();
+  const T = takeTexts(written),
+    ys = T.out;
+  const m = ys.match(UTT);
+  if (!m) throw new Error(`${whyNot(ys)} — got ${JSON.stringify(ys.length > 60 ? ys.slice(0, 60) + "…" : ys)}. YomiScript looks like  ja /kʲoꜜːwa | aꜜmeɡa ↘/`);
+  const top = m[1],
+    end = m[3] === "↗" ? "?" : "$";
+  const parts = splitSections(top, m[2], ys.indexOf("/") + 1);
+  const S = parts.map((p, i) => {
+    const sec = { ...p, end: i === parts.length - 1 ? end : "$", toks: segment(p.lang, p.text, p.base) };
+    const last = [...sec.toks].reverse().find((t) => t.kind !== "bound");
+    sec.toks.push({ kind: "end", sym: endSym(sec.end, last), ph: last ? last.ph : 0 });
+    return sec;
+  });
+  placeTexts(S, T);
+  return { ys: written, top, end, sections: S, texts: T.texts.map((x) => x.text) };
+}
+// the final ↘ / ↗ is the engine's '.' / '?'; ↘ adds nothing if the utterance already ends with punctuation (<p:!> …)
+function endSym(end, last) {
+  if (end === "?") return "?";
+  return last?.kind === "punct" ? "" : ".";
+}
+function segment(lang, t, base) {
+  if (isJa(lang)) return jaSeg(t, base);
+  return lang === "zh" ? zhSeg(t, base) : euSeg(t, base);
+}
+// ---- Japanese: IPA morae with ꜛ (rise) / ꜜ (accent nucleus); '.' and spaces optional
+const JV = "aiɯeouɨ",
+  JNAS = "mnɲŋɴ",
+  DEVOICE = "̥";
+const JAFF = ["tɕ", "dʑ", "ts", "dz", "ʨ", "ʥ", "ʦ", "ʣ"];
+const JCONS = "kɡsɕztdnɲhçɸbpmjwɾvʔŋɴʑβ";
+function jaTokens(c, base) {
+  const T = [];
+  for (let i = 0; i < c.length;) {
+    const ch = c[i],
+      at = base + i;
+    if (ch === "." || ch === " ") {
+      i++;
+      continue;
+    }
+    const f = f0At(c, i);
+    if (f) {
+      T.push({ t: "F", v: f[0] });
+      i = f[1];
+      continue;
+    }
+    if (ch === "ꜛ" || ch === "ꜜ") {
+      T.push({ t: ch });
+      i++;
+      continue;
+    }
+    if (ch === "ː") {
+      T.push({ t: "R", s: "ː", end: at + 1 });
+      i++;
+      continue;
+    }
+    if (inStr(ch, JV)) {
+      let dev = false;
+      i++;
+      if (c[i] === DEVOICE) {
+        dev = true;
+        i++;
+      }
+      T.push({ t: "V", s: ch, dev, vend: at + 1, end: base + i });
+      continue;
+    }
+    const [s, j] = jaConsonant(c, i);
+    i = j;
+    T.push({ t: "C", s, end: base + i });
+  }
+  return T;
+}
+function jaConsonant(c, i) {
+  // the consonant at i (with ʲ / ʷ) -> [symbol, index after it]
+  const ch = c[i],
+    two = c.slice(i, i + 2);
+  let s = ch;
+  if (JAFF.includes(two)) s = two;
+  else if (ch === "g")
+    s = "ɡ"; // IPA: g = ɡ
+  else if (!JAFF.includes(ch) && !inStr(ch, JCONS)) {
+    const kana = /[぀-ヿ]/.test(ch) ? " (kana is not YomiScript; write IPA with ꜛ ꜜ)" : "";
+    throw new Error(`not Japanese YomiScript IPA: ${JSON.stringify(ch)} in ${JSON.stringify(c)}${kana}`);
+  }
+  i += JAFF.includes(two) ? 2 : 1;
+  if (c[i] === "ʲ" || c[i] === "ʷ") return [s + c[i], i + 1];
+  return [s, i];
+}
+function jaMoras(c, base) {
+  // -> morae [{kind:'mora'|'N'|'Q'|'R', on, v, ipa, dev, vend, end, f0, rise, fall}] (as units: kind 'unit', mora kind in mk)
+  const T = jaTokens(c, base),
+    M = [];
+  let on = "";
+  const next = (i) => {
+    for (let j = i + 1; j < T.length; j++) if (T[j].t === "C" || T[j].t === "V" || T[j].t === "R") return T[j];
+    return null;
+  };
+  const add = (o) => M.push({ rise: false, fall: false, f0: null, dev: false, ...o });
+  T.forEach((x, i) => {
+    if (x.t === "ꜛ" || x.t === "ꜜ" || x.t === "F") {
+      markLast(M, x, on, c);
+      return;
+    }
+    if (x.t === "R") {
+      add({ kind: "R", ipa: "ː", end: x.end });
+      return;
+    }
+    const s = x.s ?? "";
+    if (x.t === "V") {
+      add({ kind: "mora", on, v: s, ipa: on + s, dev: x.dev, vend: x.vend, end: x.end });
+      on = "";
+      return;
+    }
+    const kind = on ? null : specialMora(s, next(i));
+    if (kind) {
+      add({ kind, ipa: s, end: x.end });
+      return;
+    }
+    if (on && !inStr(s, "jw")) throw new Error(`unexpected consonant cluster ${on}${s} in ${JSON.stringify(c)}`);
+    on += s;
+  });
+  if (on) throw new Error(`consonant ${on} without a vowel in ${JSON.stringify(c)}`);
+  return M;
+}
+function markLast(M, x, on, c) {
+  // ꜛ / ꜜ / <f0:…> -> on the mora before it
+  if (x.t === "F") {
+    if (on || !M.length) throw new Error(`<f0:…> must follow a mora in ${JSON.stringify(c)}`);
+    M[M.length - 1].f0 = x.v;
+    return;
+  }
+  if (on) throw new Error(`accent mark inside a mora in ${JSON.stringify(c)}`);
+  if (M.length) M[M.length - 1][x.t === "ꜛ" ? "rise" : "fall"] = true;
+}
+function specialMora(s, n) {
+  // a consonant with no onset before it: 'N' (moraic nasal), 'Q' (glottal stop, geminate) or null (an onset)
+  if (s === "ɴ") return "N";
+  if (s === "ʔ") return "Q";
+  if (inStr(s, JNAS) && n?.t !== "V") return "N"; // moraic nasal before a consonant or the end
+  if (n?.t === "C" && !inStr(s, "jw") && !inStr(n.s ?? "", "jw")) return "Q"; // geminate
+  return null;
+}
+function jaWordSpans(t) {
+  // [start, end] of each word; ' | ' and ' ‖ ' are words of their own even without spaces around them
+  const W = [];
+  for (let i = 0, s = -1; i <= t.length; i++) {
+    const c = t[i];
+    if (i === t.length || c === " " || SEP(c)) {
+      if (s >= 0) W.push([s, i]);
+      s = -1;
+      if (c && SEP(c)) W.push([i, i + 1]);
+    } else if (s < 0) s = i;
+  }
+  return W;
+}
+function jaWordItems(w, at) {
+  // one word -> morae and <p:…> in order
+  const items = [];
+  for (let i = 0, s = 0; i <= w.length;) {
+    const p = i < w.length ? pAt(w, i) : null;
+    if (i === w.length || p) {
+      if (i > s) items.push(...jaMoras(w.slice(s, i), at + s));
+      if (!p) break;
+      items.push({ kind: "punct", sym: p[0] });
+      i = s = p[1];
+    } else i = w.startsWith("<f0:", i) ? w.indexOf(">", i) + 1 || w.length : i + 1;
+  }
+  return items;
+}
+function jaSeg(t, base) {
+  // words (spaces), ' | ' / ' ‖ ' / ' ↘ ' / ' ↗ ' between them, <p:…> inside or as a word; morae per accent phrase
+  const out = [];
+  let ph = 0,
+    chunk = 0,
+    cur = [];
+  const flush = () => {
+    // one accent phrase: morae numbered k within it; spaces and <p:…> kept in place
+    const M = cur.filter((x) => x.kind !== "space" && x.kind !== "punct"),
+      hasRise = M.some((m) => m.rise);
+    let k = 0;
+    for (const x of cur)
+      out.push(x.kind === "space" || x.kind === "punct" ? { ...x, ph } : { ...x, mk: x.kind, kind: "unit", lang: "ja", ph, chunk, k: k++, hasRise });
+    if (M.length) chunk++;
+    cur = [];
+  };
+  for (const [a, z] of jaWordSpans(t)) {
+    const w = t.slice(a, z),
+      b = boundary(w, ph, true);
+    if (b) {
+      flush();
+      out.push(...b.filter((x) => x.kind !== "bound" || x.sym === "#"));
+      ph++;
+      continue;
+    }
+    const L = cur.length ? cur[cur.length - 1] : lastTok(out);
+    if (L && L.kind !== "pause") cur.push({ kind: "space" });
+    cur.push(...jaWordItems(w, base + a));
+  }
+  flush();
+  return out;
+}
+const lastTok = (out) => [...out].reverse().find((x) => x.kind !== "bound");
+function boundary(w, ph, sent = false) {
+  // ' | ' / ' ‖ ' -> bound (+ pause); a sentence end inside the utterance ' ↘ ' / ' ↗ ' -> punct; otherwise null
+  const sep = SEP(w);
+  if (sep)
+    return sep === "_"
+      ? [
+          { kind: "bound", sym: sep, ph },
+          { kind: "pause", ph },
+        ]
+      : [{ kind: "bound", sym: sep, ph }];
+  if (w === "↘" || w === "↗") return [{ kind: "punct", sym: w === "↗" ? "?" : ".", ...(sent ? { sent } : {}), ph }];
+  return null;
+}
+function words(t, base, unit) {
+  // English / French / Chinese: words separated by spaces; unit(word, offset, ph) -> tokens of one word
+  const out = [];
+  let ph = 0,
+    pos = 0;
+  for (const w of t.split(" ")) {
+    const o = base + pos;
+    pos += w.length + 1;
+    if (!w) continue;
+    const b = boundary(w, ph);
+    if (b) {
+      out.push(...b);
+      ph++;
+      continue;
+    }
+    const L = lastTok(out);
+    if (L && L.kind !== "pause") out.push({ kind: "space", ph });
+    out.push(...unit(w, o, ph));
+  }
+  return out;
+}
+// ---- English / French: IPA syllables ('.'), words (' '), stress ˈ ˌ, liaison ‿ ; boundaries ' | ' ' ‖ ' as words;
+// a sentence end inside the utterance ' ↘ ' / ' ↗ '; punctuation the engine uses as a prosodic cue: <p:…>
+function pAt(s, i) {
+  if (!s.startsWith("<p:", i)) return null;
+  const j = s.indexOf(">", i + 3);
+  if (j < 0) throw new Error(`unclosed <p: in ${JSON.stringify(s)}`);
+  return [s.slice(i + 3, j), j + 1];
+}
+function sylls(w, base) {
+  // -> syllables {raw,start,end,f0} and punctuation {punct:sym} in order; '.' splits syllables outside <…>
+  const R = [];
+  let raw = "",
+    start = base,
+    f0 = null,
+    end = base;
+  const flush = () => {
+    if (raw || f0) R.push({ raw, start, end, f0 });
+    raw = "";
+    f0 = null;
+  };
+  for (let i = 0; i <= w.length;) {
+    if (i === w.length || w[i] === ".") {
+      flush();
+      start = base + i + 1;
+      end = start;
+      i++;
+      continue;
+    }
+    const f = f0At(w, i);
+    if (f) {
+      f0 = f[0];
+      i = f[1];
+      continue;
+    }
+    const p = pAt(w, i);
+    if (p) {
+      flush();
+      R.push({ punct: p[0] });
+      i = p[1];
+      start = end = base + i;
+      continue;
+    }
+    if (w[i] !== "‿") raw += w[i];
+    i++;
+    end = base + i;
+  }
+  return R;
+}
+function euSeg(t, base) {
+  return words(t, base, (w, o, ph) => {
+    const S = sylls(w, o),
+      N = S.filter((s) => !("punct" in s)).length;
+    let j = 0;
+    return S.map((s) => {
+      if ("punct" in s) return { kind: "punct", sym: s.punct, ph };
+      return { kind: "unit", ph, j: j++, nsyl: N, st: inStr(s.raw[0] ?? "", "ˈˌ") ? s.raw[0] : "", ...s };
+    });
+  });
+}
+// ---- Chinese (pinyin + tone digits; to be replaced with IPA + tone letters, D17)
+function zhSeg(t, base) {
+  return words(t, base, (w, o, ph) =>
+    sylls(w, o).map((s) => {
+      if ("punct" in s) return { kind: "punct", sym: s.punct, ph };
+      const m = s.raw.match(/^[a-zü]+(\d)(?:>(\d))?/);
+      if (!m) throw new Error(`bad pinyin syllable ${JSON.stringify(s.raw)}`);
+      return { kind: "unit", ph, tone: m[2] || m[1], ...s };
+    }),
+  );
+}
+//# sourceMappingURL=yomiscript.js.map

package/dist/yomiscript.js.map

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

package/dist/yomite.d.ts

@@ -0,0 +1,18 @@
+export interface Edit {
+    at: number;
+    ins: string;
+    del?: number;
+}
+export interface RealizeOptions {
+    dialect?: {
+        ja?: "tokyo" | "osaka";
+    };
+    /** only the Japanese accent phrases that carry ꜛ or ꜜ get values (and no devoicing is written); everything else is
+     * left to the Katarite's own prosody. For callers that mark the accent only where they know it (D25) */
+    markedOnly?: boolean;
+    /** multiplies the values written for Japanese (1 by default; 0.5 is the gentler pitch the tools use, D25) */
+    jaScale?: number;
+}
+export declare const f0Mark: (c: number[]) => string;
+export declare function applyEdits(s: string, E: Edit[]): string;
+export declare function realize(ys: string, opt?: RealizeOptions): string;

package/dist/yomite.js

@@ -0,0 +1,133 @@
+// Yomite (reference, rule-based prosody): YomiScript with accent / stress / tone marks -> the same YomiScript with
+// pitch values <f0:…> (semitones relative to the speaker's register) after each unit. Also writes allophones that are
+// a pronunciation choice: Japanese vowel devoicing (◌̥) and the American English t/d flap (ɾ).
+// Units that already carry <f0:…> are left as written. The Katarite renders only the values.
+// Dialect is a Yomite setting, not part of YomiScript: realize(ys, {dialect:{ja:'osaka'}}).
+import { parse, isJa, VOWELS } from "./yomiscript.js";
+const inStr = (ch, s) => s.includes(ch);
+const fmt = (v) => String(Math.round(v * 100) / 100);
+export const f0Mark = (c) => `<f0:${c.map(fmt).join(",")}>`;
+export function applyEdits(s, E) {
+    for (const e of [...E].sort((a, b) => b.at - a.at))
+        s = s.slice(0, e.at) + e.ins + s.slice(e.at + (e.del || 0));
+    return s;
+}
+// Japanese: Tokyo-type pitch from ꜛ / ꜜ per accent phrase. Osaka (Keihan-type): a phrase without ꜛ is high-onset,
+// ꜛ marks where a low-onset phrase rises; the high stretch is flatter and vowels are not devoiced
+const VLJ = ["k", "s", "ɕ", "t", "ʨ", "ʦ", "h", "ç", "ɸ", "p"];
+const voicelessStart = (m) => !!m && m.mk === "mora" && VLJ.some((x) => (m.ipa ?? "").startsWith(x));
+function devoiced(M, k, end) {
+    // i / ɯ between voiceless consonants, and the ɯ of a sentence-final す
+    const m = M[k];
+    if (m.mk !== "mora" || !inStr(m.v ?? "", "iɯɨ") || !voicelessStart(m))
+        return false;
+    if (voicelessStart(M[k + 1]))
+        return true;
+    return k === M.length - 1 && end === "$" && (m.ipa === "sɯ" || m.ipa === "sɨ");
+}
+function jaPhrase(M, end, E, { osaka, devoice, scale }) {
+    // one accent phrase: high after ꜛ (or from the start without ꜛ), low after ꜜ; declining within the high stretch
+    let state = M[0].hasRise ? "L" : "H", hk = 0;
+    M.forEach((m, k) => {
+        let v;
+        if (state === "H")
+            v = 2.5 - 0.45 * hk++;
+        else
+            v = k === 0 ? -2.0 : -2.5 - 0.3 * hk;
+        const auto = devoice && !osaka && devoiced(M, k, end);
+        if (auto && !m.dev)
+            E.push({ at: m.vend ?? 0, ins: "̥" });
+        if (osaka && v >= 0)
+            v = 2.5 - (2.5 - v) / 3;
+        if (!m.dev && !auto && !m.f0)
+            E.push({ at: m.end ?? 0, ins: f0Mark([v * scale]) });
+        if (m.rise)
+            state = "H";
+        if (m.fall)
+            state = "L";
+    });
+}
+const marked = (M) => M.some((m) => m.rise || m.fall);
+function jaRules(sec, E, opt) {
+    const C = [];
+    for (const t of sec.toks) {
+        if (t.kind !== "unit")
+            continue;
+        const c = t.chunk ?? 0;
+        C[c] ??= [];
+        C[c].push(t);
+    }
+    const o = { osaka: opt.dialect?.ja === "osaka", devoice: !opt.markedOnly, scale: opt.jaScale ?? 1 };
+    for (const M of C)
+        if (!opt.markedOnly || marked(M))
+            jaPhrase(M, sec.end, E, o);
+}
+// English / French: stress-based pitch, phrase-boundary rise, sentence-final fall or rise
+function flaps(t, prev) {
+    // American English: t / d between a vowel (or r) and a vowel or syllabic l, not at the start of a word -> ɾ
+    const r = t.raw ?? "";
+    if (t.j === 0 || !inStr(r[0] ?? "#", "td") || r.length < 2 || prev?.kind !== "unit")
+        return false;
+    if (!inStr(r[1], VOWELS + "ɝɚ") && !r.slice(1).startsWith("l̩"))
+        return false;
+    return inStr((prev.raw ?? "").slice(-1), VOWELS + "ɹrɝɚ");
+}
+function euValue(t, fr) {
+    if (fr)
+        return t.j === (t.nsyl ?? 0) - 1 ? [0.5] : [-0.5];
+    return { ˈ: [3.0, 1.0], ˌ: [1.0] }[t.st ?? ""] ?? [-1.5];
+}
+// American English only: not en-GB, not French, and not English words inside another language
+const flapping = (lang, top) => lang.startsWith("en") && lang !== "en-GB" && top.startsWith("en");
+const lastValued = (C) => C.findLast((x) => x.c);
+function euContours(sec, top, E) {
+    // stress-based value per syllable (null where the YomiScript already has one), plus the phrase-final rises
+    const fr = sec.lang === "fr", flap = flapping(sec.lang, top);
+    const C = [];
+    let prev = null;
+    for (const t of sec.toks) {
+        const L = t.kind === "bound" ? lastValued(C) : null;
+        if (L?.c)
+            L.c = [...L.c, 2.5];
+        if (t.kind === "bound")
+            continue;
+        if (t.kind === "unit" && flap && !t.f0 && flaps(t, prev))
+            E.push({ at: t.start ?? 0, del: 1, ins: "ɾ" });
+        if (t.kind === "unit")
+            C.push({ t, c: t.f0 ? null : euValue(t, fr) });
+        prev = t;
+    }
+    return C;
+}
+function euRules(sec, E, top) {
+    const C = euContours(sec, top, E), L = lastValued(C);
+    if (L?.c)
+        L.c = [L.c[0], sec.end === "$" ? -5 : 6]; // sentence-final fall or rise
+    for (const { t, c } of C)
+        if (c)
+            E.push({ at: t.end ?? 0, ins: f0Mark(c) });
+}
+// Chinese: tone contours (tone 5 = neutral, no value)
+const TC = { 1: [3, 3], 2: [-1, 3.5], 3: [-3, -4.5, -3], 4: [4, -3], 5: null };
+function zhRules(sec, E) {
+    for (const t of sec.toks) {
+        const c = TC[t.tone ?? ""];
+        if (t.kind === "unit" && !t.f0 && c)
+            E.push({ at: t.end ?? 0, ins: f0Mark(c) });
+    }
+}
+export function realize(ys, opt = {}) {
+    const Y = parse(ys), E = [];
+    for (const sec of Y.sections) {
+        if (isJa(sec.lang))
+            jaRules(sec, E, opt);
+        else if (opt.markedOnly)
+            continue;
+        else if (sec.lang === "zh")
+            zhRules(sec, E);
+        else
+            euRules(sec, E, Y.top);
+    }
+    return applyEdits(Y.ys, E);
+}
+//# sourceMappingURL=yomite.js.map

package/dist/yomite.js.map

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

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@yomiscript/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "YomiScript: parser, types and the rule-based prosody (Yomite tools)",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/receptron/yomiscript.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/receptron/yomiscript/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/receptron/yomiscript/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepack": "yarn --cwd ../.. build && node ../../tools/prepack.mjs"
+  }
+}