@clipwright/core 0.19.0 → 0.21.0

package/dist/tts-backend.js

@@ -1,13 +1,5 @@
-/**
- * Склейка посимвольных таймингов в пословные.
- *
- * Живёт здесь, а не в адаптере ElevenLabs, потому что посимвольный формат
- * встречается у нескольких вендоров, и переписывать эту логику под каждого —
- * лишняя работа с одинаковыми граничными случаями.
- *
- * Границей слова считается пробельный символ; сам пробел в слово не входит,
- * но и не рвёт уже начатое. Пустые слова не порождаются.
- */
+/** Joins per-character timings into words, shared by vendors with that format. Whitespace */
+/** ends a word without joining it; empty words are never produced. */
 export function charTimingsToWords(characters, startTimes, endTimes) {
     if (characters.length !== startTimes.length || characters.length !== endTimes.length) {
         throw new Error(`character/timing length mismatch: ${characters.length} chars, ` +

package/dist/tts-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"tts-backend.js","sourceRoot":"","sources":["../src/tts-backend.ts"],"names":[],"mappings":"AAsEA;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,UAA6B,EAC7B,QAA2B;IAE3B,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,CAAC,MAAM,UAAU;YAC9D,GAAG,UAAU,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,OAAO,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QAClC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"tts-backend.js","sourceRoot":"","sources":["../src/tts-backend.ts"],"names":[],"mappings":"AAmDA,6FAA6F;AAC7F,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAChC,UAA6B,EAC7B,UAA6B,EAC7B,QAA2B;IAE3B,IAAI,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,qCAAqC,UAAU,CAAC,MAAM,UAAU;YAC9D,GAAG,UAAU,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,OAAO,CACzD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IAEZ,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,GAAG,GAAG,EAAE,CAAC;QACX,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,KAAK,EAAE,CAAC;YACR,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,GAAG,UAAU,CAAC,CAAC,CAAW,CAAC;QAClC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAW,CAAC;IAC9B,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/uploads.d.ts

@@ -1,12 +1,12 @@
 import { z } from "zod";
-/** Один потолок с пробой источника (`PROBE_MAX_BYTES` в service-core, сторож рядом с ней). */
+/** The same cap as the source probe (`PROBE_MAX_BYTES` in service-core, guarded there). */
 export declare const UPLOAD_MAX_BYTES: number;
-/** Загрузок на аккаунт за скользящие сутки; ссылка живёт день, объект — семь (lifecycle R2). */
+/** Uploads per account over a sliding day; a link lives one day, the object seven (storage lifecycle). */
 export declare const UPLOAD_DAILY_CAP = 20;
 export declare const UPLOAD_WINDOW_SECONDS = 86400;
 export declare const UPLOAD_URL_TTL_SECONDS = 86400;
 export declare const UPLOAD_OBJECT_RETENTION_DAYS = 7;
-/** WebP здесь нет намеренно: размеры из него проба не читает, а без них формат не проверить. */
+/** No WebP on purpose: the probe cannot read its dimensions, and without them the format cannot be checked. */
 export declare const UPLOAD_MEDIA_TYPES: readonly ["image/png", "image/jpeg"];
 export type UploadMediaType = (typeof UPLOAD_MEDIA_TYPES)[number];
 export declare const UPLOADS_PATH = "/v1/uploads";
@@ -23,7 +23,7 @@ export declare const uploadResponse: z.ZodObject<{
     expires_at: z.ZodString;
 }, z.core.$strip>;
 export type UploadResponse = z.infer<typeof uploadResponse>;
-/** Тип по первым байтам, не по заголовку и не по расширению: их пишет отправитель. */
+/** Type by the first bytes, not by header or extension: the sender writes those. */
 export declare function sniffUploadMediaType(bytes: Uint8Array): UploadMediaType | null;
 export declare function uploadExtension(mediaType: UploadMediaType): "png" | "jpg";
 export declare const UPLOAD_IMAGE_DESCRIPTION: string;

package/dist/uploads.js

@@ -1,12 +1,12 @@
 import { z } from "zod";
-/** Один потолок с пробой источника (`PROBE_MAX_BYTES` в service-core, сторож рядом с ней). */
+/** The same cap as the source probe (`PROBE_MAX_BYTES` in service-core, guarded there). */
 export const UPLOAD_MAX_BYTES = 10 * 1024 * 1024;
-/** Загрузок на аккаунт за скользящие сутки; ссылка живёт день, объект — семь (lifecycle R2). */
+/** Uploads per account over a sliding day; a link lives one day, the object seven (storage lifecycle). */
 export const UPLOAD_DAILY_CAP = 20;
 export const UPLOAD_WINDOW_SECONDS = 86_400;
 export const UPLOAD_URL_TTL_SECONDS = 86_400;
 export const UPLOAD_OBJECT_RETENTION_DAYS = 7;
-/** WebP здесь нет намеренно: размеры из него проба не читает, а без них формат не проверить. */
+/** No WebP on purpose: the probe cannot read its dimensions, and without them the format cannot be checked. */
 export const UPLOAD_MEDIA_TYPES = ["image/png", "image/jpeg"];
 export const UPLOADS_PATH = "/v1/uploads";
 export const uploadResponse = z.object({
@@ -19,7 +19,7 @@ export const uploadResponse = z.object({
     expires_at: z.string().datetime(),
 });
 const PNG_SIGNATURE = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
-/** Тип по первым байтам, не по заголовку и не по расширению: их пишет отправитель. */
+/** Type by the first bytes, not by header or extension: the sender writes those. */
 export function sniffUploadMediaType(bytes) {
     if (bytes.length >= 8 && PNG_SIGNATURE.every((b, i) => bytes[i] === b))
         return "image/png";

package/dist/uploads.js.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8FAA8F;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,gGAAgG;AAChG,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,gGAAgG;AAChG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,YAAY,CAAU,CAAC;AAGvE,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAGH,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEvE,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC;IAC3F,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrF,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAA0B;IACxD,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GACnC,+FAA+F;IAC/F,+FAA+F;IAC/F,iGAAiG;IACjG,mGAAmG;IACnG,iGAAiG,CAAC"}
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../src/uploads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,0GAA0G;AAC1G,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C,+GAA+G;AAC/G,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,WAAW,EAAE,YAAY,CAAU,CAAC;AAGvE,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACjD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAGH,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEvE,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC;IAC3F,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACrF,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAA0B;IACxD,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GACnC,+FAA+F;IAC/F,+FAA+F;IAC/F,iGAAiG;IACjG,mGAAmG;IACnG,iGAAiG,CAAC"}

package/dist/vendor-response.d.ts

@@ -1,98 +1,35 @@
-/**
- * ЧТО УСПЕЛО СЛУЧИТЬСЯ С ПЛАТНЫМ ЗАПРОСОМ — ПРИЗНАК НА ОШИБКЕ, А НЕ ДОГАДКА ПО
- * ЕЁ ТЕКСТУ (US-606a).
- *
- * ЗАЧЕМ ЭТО СУЩЕСТВУЕТ. Провалившийся платный вызов кончается одним из трёх, и
- * различать их обязан код, а не человек, читающий лог:
- *
- *  - платный запрос ещё НЕ УХОДИЛ (упал наш префлайт, бесплатный шаг, гард
- *    длины) — денег не взяли точно;
- *  - вендор ОТВЕТИЛ — дальше всё решает код: 4xx означает отказ без денег, а
- *    2xx, которым мы не смогли воспользоваться, означает, что работу приняли и
- *    посчитали;
- *  - ОТВЕТА НЕ БЫЛО ВОВСЕ (обрыв, тайм-аут) — взяли или нет, неизвестно.
- *
- * Третий случай — единственная причина, по которой US-606a вообще написана.
- * Свалив его в «не получилось», мы объявили бы неизвестность отсутствием траты,
- * то есть соврали бы в свою пользу ровно там, где ошибка дороже всего.
- *
- * ПОЧЕМУ ОТСУТСТВИЕ ПРИЗНАКА ЗНАЧИТ «НЕИЗВЕСТНО», А НЕ «НЕ УХОДИЛ». Это
- * fail-closed: непомеченная ошибка поднимает лишний алерт, непомеченная в
- * другую сторону — прячет возможную трату. Цена первой ошибки — внимание
- * владельца, цена второй — необнаруженное списание. Поэтому умолчание такое.
- *
- * ПОЧЕМУ РАЗБОР ТЕКСТА ОШИБКИ НЕ ГОДИТСЯ. Он завёл бы второй источник правды:
- * формат сообщений адаптера и его копию в парсере. Они расходятся на первой же
- * правке текста — молча, потому что парсер просто перестаёт узнавать строку.
- * Тот же довод уже стоил нам одного дефекта в `SpendRefusedError`.
- *
- * ПОЧЕМУ В `core`, А НЕ В СЕРВИСНОМ ПАКЕТЕ. Это обязанность реализаций
- * `RenderBackend` и `TtsBackend`, а оба контракта живут здесь — вместе с
- * требованием различать райтраебл и нерайтраебл ошибки, которое той же природы.
- * Модуль не тянет ничего: три функции над свойством объекта.
- */
-/**
- * Что известно о судьбе платного запроса к моменту броска.
- *
- * `unsent` — платный запрос не уходил. `responded` — вендор ответил, и код
- * ответа известен числом: флага «ответил» не хватило бы, потому что 200 и 402
- * — разные события с разной ценой.
- */
+/** What is known about the paid request when it threw. `unsent`: it never left. `responded`: */
+/** the vendor answered, with the status as a number, since 200 and 402 cost differently. */
 export type VendorDispatchFact = {
     readonly kind: "unsent";
 } | {
     readonly kind: "responded";
     readonly status: number;
 };
-/** Платный запрос ещё не уходил: упал префлайт, гард или бесплатный шаг. */
+/** The paid request never left: a preflight, a guard or a free step failed. */
 export declare function markVendorUnsent<E>(error: E): E;
-/** Вендор ответил, и вот с каким кодом. */
+/** The vendor answered, with this status. */
 export declare function markVendorResponse<E>(error: E, status: number): E;
-/**
- * Что известно о судьбе запроса. `undefined` — не известно НИЧЕГО, и это
- * утверждение о незнании, а не об отказе.
- *
- * Читает и не-Error значения: в `catch` приходит `unknown`, и бросить могли что
- * угодно.
- */
+/** What is known about the request. `undefined` means NOTHING is known, a statement of */
+/** ignorance, not of refusal. Reads non-Error values too, since `catch` gets `unknown`. */
 export declare function vendorDispatchFact(error: unknown): VendorDispatchFact | undefined;
-/**
- * ВЕРДИКТ ВЕНДОРА О САМОЙ ЗАДАЧЕ — вторая ось, отдельная от судьбы запроса.
- *
- * ЗАЧЕМ ОТДЕЛЬНО ОТ `VendorDispatchFact`. Тот отвечает на вопрос «дошёл ли
- * платный запрос»; этот — на вопрос «что вендор СКАЗАЛ о работе, которую уже
- * принял». Оси независимы: запрос дошёл и получил 200 (первая ось довольна), а
- * задача через десять минут поллинга объявлена проваленной (вторая ось — нет).
- *
- * ЗАЧЕМ ЭТО ВООБЩЕ ЕСТЬ. Без вердикта учёт не может отличить «мы не узнали, чем
- * кончилось» от «вендор сам сказал, что провалил». Первое обязано оставаться
- * незакрытым, второе — записаться: молчать о том, что знаешь, в аудиторском
- * следе так же плохо, как утверждать то, чего не знаешь. Круг 2 внешней приёмки
- * поймал первую ошибку, круг 3 — вторую.
- *
- * `succeeded` здесь означает «вендор довёл работу до конца», даже если
- * воспользоваться результатом мы не смогли (пришёл `completed` без
- * положительной длительности). Наша неспособность прочитать ответ — не провал
- * вендора и не повод записывать его в отчёт как провал.
- */
+/** The vendor's verdict on the job itself, an axis apart from dispatch: an accepted request */
+/** may still fail later. `succeeded` means the vendor finished, even if we could not use it. */
 export type VendorJobVerdict = "succeeded" | "failed";
-/** Помечает ошибку тем, что вендор сказал о САМОЙ задаче. */
+/** Marks the error with what the vendor said about the job ITSELF. */
 export declare function markVendorJobVerdict<E>(error: E, verdict: VendorJobVerdict): E;
-/**
- * Вердикт вендора о задаче. `undefined` — вендор ничего терминального не
- * сказал: оборвался поллинг, вышел срок, ответил не тот код. Это незнание, и
- * закрывать по нему операцию нельзя.
- */
+/** The vendor's verdict on the job. `undefined`: nothing terminal was said (polling broke, */
+/** timed out, wrong status). That is ignorance, and an operation must not be closed on it. */
 export declare function vendorJobVerdict(error: unknown): VendorJobVerdict | undefined;
-/** Чья причина за отказом вендора. `unknown` — честный ответ и ПРЕЖНЕЕ */
-/** поведение (не ноль): разбор и цена обратного — `docs/18` §11.5. */
+/** Whose fault a vendor refusal is. `unknown` is the honest answer and keeps the previous */
+/** behavior (not zero). */
 export type VendorRefusalClass = "account_standing" | "vendor" | "unknown";
-/** Помечает ошибку тем, что о причине отказа сказал сам вендор. */
+/** Marks the error with what the vendor itself said about the refusal cause. */
 export declare function markVendorRefusal<E>(error: E, refusal: VendorRefusalClass): E;
-/** Непомеченная ошибка — `unknown`: fail-closed здесь смотрит в прежнее поведение. */
+/** An unmarked error is `unknown`: fail-closed here means the previous behavior. */
 export declare function vendorRefusalClass(error: unknown): VendorRefusalClass;
-/** Пометить класс отказа ответом САМОГО адаптера. Без неё обязательный член */
-/** задавал бы вендору вопрос, ответ на который никуда не едет (§11.6). */
+/** Marks the refusal class with the adapter's OWN answer; otherwise the required member */
+/** would ask the vendor a question whose answer goes nowhere. */
 export declare function withRefusalClass<T>(backend: {
     classifyRefusal(error: unknown): VendorRefusalClass;
 }, call: () => Promise<T>): Promise<T>;

package/dist/vendor-response.js

@@ -1,50 +1,10 @@
-/**
- * ЧТО УСПЕЛО СЛУЧИТЬСЯ С ПЛАТНЫМ ЗАПРОСОМ — ПРИЗНАК НА ОШИБКЕ, А НЕ ДОГАДКА ПО
- * ЕЁ ТЕКСТУ (US-606a).
- *
- * ЗАЧЕМ ЭТО СУЩЕСТВУЕТ. Провалившийся платный вызов кончается одним из трёх, и
- * различать их обязан код, а не человек, читающий лог:
- *
- *  - платный запрос ещё НЕ УХОДИЛ (упал наш префлайт, бесплатный шаг, гард
- *    длины) — денег не взяли точно;
- *  - вендор ОТВЕТИЛ — дальше всё решает код: 4xx означает отказ без денег, а
- *    2xx, которым мы не смогли воспользоваться, означает, что работу приняли и
- *    посчитали;
- *  - ОТВЕТА НЕ БЫЛО ВОВСЕ (обрыв, тайм-аут) — взяли или нет, неизвестно.
- *
- * Третий случай — единственная причина, по которой US-606a вообще написана.
- * Свалив его в «не получилось», мы объявили бы неизвестность отсутствием траты,
- * то есть соврали бы в свою пользу ровно там, где ошибка дороже всего.
- *
- * ПОЧЕМУ ОТСУТСТВИЕ ПРИЗНАКА ЗНАЧИТ «НЕИЗВЕСТНО», А НЕ «НЕ УХОДИЛ». Это
- * fail-closed: непомеченная ошибка поднимает лишний алерт, непомеченная в
- * другую сторону — прячет возможную трату. Цена первой ошибки — внимание
- * владельца, цена второй — необнаруженное списание. Поэтому умолчание такое.
- *
- * ПОЧЕМУ РАЗБОР ТЕКСТА ОШИБКИ НЕ ГОДИТСЯ. Он завёл бы второй источник правды:
- * формат сообщений адаптера и его копию в парсере. Они расходятся на первой же
- * правке текста — молча, потому что парсер просто перестаёт узнавать строку.
- * Тот же довод уже стоил нам одного дефекта в `SpendRefusedError`.
- *
- * ПОЧЕМУ В `core`, А НЕ В СЕРВИСНОМ ПАКЕТЕ. Это обязанность реализаций
- * `RenderBackend` и `TtsBackend`, а оба контракта живут здесь — вместе с
- * требованием различать райтраебл и нерайтраебл ошибки, которое той же природы.
- * Модуль не тянет ничего: три функции над свойством объекта.
- */
-/**
- * Имя свойства. Намеренно длинное и с префиксом проекта: свойство садится на
- * чужие объекты ошибок, и короткое имя вроде `status` затёрло бы поле, которое
- * туда положил кто-то другой.
- */
+// What happened to a paid request, as a flag on the error rather than a guess from its text.
+// No flag means "unknown", not "unsent": fail-closed, so a possible charge is never hidden.
+/** Property name, long and project-prefixed: it lands on foreign error objects, and a short */
+/** name like `status` would overwrite someone else's field. */
 const VENDOR_DISPATCH_FACT = "clipwrightVendorDispatchFact";
-/**
- * Общая запись признака. Неперечислимо: ошибки уезжают в логи и в `runs.error`,
- * и лишний ключ в их сериализации — шум, за который никто не просил.
- *
- * НА ПРИМИТИВЕ — НИЧЕГО НЕ ДЕЛАЕТ, И ЭТО НАЗВАННОЕ СВОЙСТВО, А НЕ НЕДОСМОТР:
- * `throw "строка"` пометить нечем, и такая ошибка попадёт в `unknown`. Это
- * сторона fail-closed (лишний алерт, а не потерянная трата), поэтому терпимо.
- */
+/** Shared flag writer. Non-enumerable, so it does not clutter serialized logs. A primitive */
+/** cannot be marked and reads as unknown, which is the fail-closed side. */
 function mark(error, fact) {
     if (typeof error !== "object" || error === null) {
         return error;
@@ -53,27 +13,22 @@ function mark(error, fact) {
         value: fact,
         enumerable: false,
         writable: false,
-        // `configurable`, чтобы повторная пометка не бросала TypeError: ошибка
-        // проходит несколько уровней адаптера, и внешний слой вправе уточнить факт.
+        // `configurable` so a second mark does not throw: an outer adapter layer may
+        // refine the fact.
         configurable: true,
     });
     return error;
 }
-/** Платный запрос ещё не уходил: упал префлайт, гард или бесплатный шаг. */
+/** The paid request never left: a preflight, a guard or a free step failed. */
 export function markVendorUnsent(error) {
     return mark(error, { kind: "unsent" });
 }
-/** Вендор ответил, и вот с каким кодом. */
+/** The vendor answered, with this status. */
 export function markVendorResponse(error, status) {
     return mark(error, { kind: "responded", status });
 }
-/**
- * Что известно о судьбе запроса. `undefined` — не известно НИЧЕГО, и это
- * утверждение о незнании, а не об отказе.
- *
- * Читает и не-Error значения: в `catch` приходит `unknown`, и бросить могли что
- * угодно.
- */
+/** What is known about the request. `undefined` means NOTHING is known, a statement of */
+/** ignorance, not of refusal. Reads non-Error values too, since `catch` gets `unknown`. */
 export function vendorDispatchFact(error) {
     if (typeof error !== "object" || error === null) {
         return undefined;
@@ -92,7 +47,7 @@ export function vendorDispatchFact(error) {
     return undefined;
 }
 const VENDOR_JOB_VERDICT = "clipwrightVendorJobVerdict";
-/** Помечает ошибку тем, что вендор сказал о САМОЙ задаче. */
+/** Marks the error with what the vendor said about the job ITSELF. */
 export function markVendorJobVerdict(error, verdict) {
     if (typeof error !== "object" || error === null) {
         return error;
@@ -105,11 +60,8 @@ export function markVendorJobVerdict(error, verdict) {
     });
     return error;
 }
-/**
- * Вердикт вендора о задаче. `undefined` — вендор ничего терминального не
- * сказал: оборвался поллинг, вышел срок, ответил не тот код. Это незнание, и
- * закрывать по нему операцию нельзя.
- */
+/** The vendor's verdict on the job. `undefined`: nothing terminal was said (polling broke, */
+/** timed out, wrong status). That is ignorance, and an operation must not be closed on it. */
 export function vendorJobVerdict(error) {
     if (typeof error !== "object" || error === null) {
         return undefined;
@@ -118,7 +70,7 @@ export function vendorJobVerdict(error) {
     return value === "succeeded" || value === "failed" ? value : undefined;
 }
 const VENDOR_REFUSAL_CLASS = "clipwrightVendorRefusalClass";
-/** Помечает ошибку тем, что о причине отказа сказал сам вендор. */
+/** Marks the error with what the vendor itself said about the refusal cause. */
 export function markVendorRefusal(error, refusal) {
     if (typeof error !== "object" || error === null) {
         return error;
@@ -131,7 +83,7 @@ export function markVendorRefusal(error, refusal) {
     });
     return error;
 }
-/** Непомеченная ошибка — `unknown`: fail-closed здесь смотрит в прежнее поведение. */
+/** An unmarked error is `unknown`: fail-closed here means the previous behavior. */
 export function vendorRefusalClass(error) {
     if (typeof error !== "object" || error === null) {
         return "unknown";
@@ -139,8 +91,8 @@ export function vendorRefusalClass(error) {
     const value = error[VENDOR_REFUSAL_CLASS];
     return value === "account_standing" || value === "vendor" ? value : "unknown";
 }
-/** Пометить класс отказа ответом САМОГО адаптера. Без неё обязательный член */
-/** задавал бы вендору вопрос, ответ на который никуда не едет (§11.6). */
+/** Marks the refusal class with the adapter's OWN answer; otherwise the required member */
+/** would ask the vendor a question whose answer goes nowhere. */
 export async function withRefusalClass(backend, call) {
     try {
         return await call();

package/dist/vendor-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"vendor-response.js","sourceRoot":"","sources":["../src/vendor-response.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAaH;;;;GAIG;AACH,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAE5D;;;;;;;GAOG;AACH,SAAS,IAAI,CAAI,KAAQ,EAAE,IAAwB;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE;QACjD,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,uEAAuE;QACvE,4EAA4E;QAC5E,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAI,KAAQ;IAC1C,OAAO,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAAI,KAAQ,EAAE,MAAc;IAC5D,OAAO,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAI,KAAiC,CAAC,oBAAoB,CAAC,CAAC;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,KAA6C,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAuBD,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAExD,6DAA6D;AAC7D,MAAM,UAAU,oBAAoB,CAAI,KAAQ,EAAE,OAAyB;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,kBAAkB,EAAE;QAC/C,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAI,KAAiC,CAAC,kBAAkB,CAAC,CAAC;IACrE,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACzE,CAAC;AAMD,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAE5D,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAI,KAAQ,EAAE,OAA2B;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,oBAAoB,EAAE;QACjD,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAI,KAAiC,CAAC,oBAAoB,CAAC,CAAC;IACvE,OAAO,KAAK,KAAK,kBAAkB,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgE,EAChE,IAAsB;IAEtB,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}
+{"version":3,"file":"vendor-response.js","sourceRoot":"","sources":["../src/vendor-response.ts"],"names":[],"mappings":"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"}

package/dist/voice-admission.d.ts

@@ -1,7 +1,7 @@
 import type { Gender } from "./default-actor.js";
 import { type CatalogFileVoice } from "./voice-catalog.js";
 import { type TtsModelId } from "./voices.js";
-/** Почему API не допускает имя голоса; `undefined` — пресет или живой голос каталога. */
+/** Why the API refuses a voice name; `undefined` for a preset or a live catalog voice. */
 export declare function catalogVoiceRefusal(voice: string, voices?: readonly CatalogFileVoice[]): string | undefined;
 export declare const serverUgcInput: import("zod").ZodObject<{
     script: import("zod").ZodOptional<import("zod").ZodString>;
@@ -99,11 +99,11 @@ export declare const serverUgcInput: import("zod").ZodObject<{
         white: "white";
     }>>;
 }, import("zod/v4/core").$strip>;
-/** Пол голоса по имени: у пресета — наш факт, у каталожного — метка вендора. */
-/** Сырой `voice_id` пола не имеет, и это `undefined`, а не догадка (#210). */
+/** Voice gender by name: our fact for a preset, the vendor label for a catalog voice. */
+/** A raw `voice_id` has no gender, so `undefined`, not a guess. */
 export declare function voiceGenderOf(voice: string, voices?: readonly CatalogFileVoice[]): Gender | undefined;
-/** Предупреждение — только там, где НЕХВАТКА верификации что-то значит: у */
-/** `eleven_v3` её нет ни у кого, разбор — `docs/16` (clipwright#208). */
+/** Warns only where MISSING verification means something: for `eleven_v3` no voice */
+/** has it at all. */
 export declare function buildVoiceVerificationWarnings(input: {
     voice?: string | undefined;
     voice_id?: string | undefined;

package/dist/voice-admission.js

@@ -3,8 +3,8 @@ import { normalizeVoiceLabel } from "./voice-catalog.js";
 import { VOICE_CATALOG } from "./voice-catalog-data.js";
 import { vendorVerifiedModels } from "./voice-listing.js";
 import { isVoicePresetName, resolveTtsModel, VOICE_PRESETS } from "./voices.js";
-// Подпуть, а не баррел: каталог весит сотни килобайт, и клиентам SDK он не нужен (docs/16).
-/** Почему API не допускает имя голоса; `undefined` — пресет или живой голос каталога. */
+// A subpath, not the barrel: the catalog weighs hundreds of kilobytes and SDK clients do not need it.
+/** Why the API refuses a voice name; `undefined` for a preset or a live catalog voice. */
 export function catalogVoiceRefusal(voice, voices = VOICE_CATALOG.voices) {
     if (isVoicePresetName(voice))
         return undefined;
@@ -19,8 +19,8 @@ export function catalogVoiceRefusal(voice, voices = VOICE_CATALOG.voices) {
     return undefined;
 }
 export const serverUgcInput = serverUgcInputWith((voice) => catalogVoiceRefusal(voice));
-/** Пол голоса по имени: у пресета — наш факт, у каталожного — метка вендора. */
-/** Сырой `voice_id` пола не имеет, и это `undefined`, а не догадка (#210). */
+/** Voice gender by name: our fact for a preset, the vendor label for a catalog voice. */
+/** A raw `voice_id` has no gender, so `undefined`, not a guess. */
 export function voiceGenderOf(voice, voices = VOICE_CATALOG.voices) {
     if (isVoicePresetName(voice))
         return VOICE_PRESETS[voice].gender;
@@ -28,8 +28,8 @@ export function voiceGenderOf(voice, voices = VOICE_CATALOG.voices) {
     const label = normalizeVoiceLabel(entry?.gender_raw);
     return label === "female" || label === "male" ? label : undefined;
 }
-/** Предупреждение — только там, где НЕХВАТКА верификации что-то значит: у */
-/** `eleven_v3` её нет ни у кого, разбор — `docs/16` (clipwright#208). */
+/** Warns only where MISSING verification means something: for `eleven_v3` no voice */
+/** has it at all. */
 export function buildVoiceVerificationWarnings(input, gender, voices = VOICE_CATALOG.voices) {
     const slug = input.voice;
     if (slug === undefined || isVoicePresetName(slug))

package/dist/voice-admission.js.map

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

package/dist/voice-catalog-data.d.ts

@@ -1,5 +1,5 @@
-/** Сгенерированные файлы, разобранные схемой. В баррел не входит: клиентам SDK */
-/** каталог не нужен, а подключать ли его подпутём, решает S5 (#164). */
+/** The generated files, parsed by their schemas. Not in the barrel: SDK clients do not need */
+/** the catalog. */
 export declare const VOICE_CATALOG: {
     shortfall: Partial<Record<"bg" | "cs" | "da" | "de" | "el" | "en" | "es" | "fi" | "fil" | "fr" | "hi" | "hr" | "hu" | "id" | "it" | "ja" | "ko" | "ms" | "nl" | "no" | "pl" | "pt" | "ro" | "ru" | "sk" | "sv" | "ta" | "tr" | "uk" | "vi" | "zh", {
         female?: number | undefined;

package/dist/voice-catalog-data.js

@@ -1,8 +1,8 @@
 import catalogJson from "./voice-catalog.generated.json" with { type: "json" };
 import modelsJson from "./tts-model-languages.generated.json" with { type: "json" };
 import { ttsModelLanguagesFile, voiceCatalogFile } from "./voice-catalog.js";
-/** Сгенерированные файлы, разобранные схемой. В баррел не входит: клиентам SDK */
-/** каталог не нужен, а подключать ли его подпутём, решает S5 (#164). */
+/** The generated files, parsed by their schemas. Not in the barrel: SDK clients do not need */
+/** the catalog. */
 export const VOICE_CATALOG = voiceCatalogFile.parse(catalogJson);
 export const TTS_MODEL_LANGUAGES = ttsModelLanguagesFile.parse(modelsJson);
 //# sourceMappingURL=voice-catalog-data.js.map

package/dist/voice-catalog-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-catalog-data.js","sourceRoot":"","sources":["../src/voice-catalog-data.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,gCAAgC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/E,OAAO,UAAU,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,kFAAkF;AAClF,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"voice-catalog-data.js","sourceRoot":"","sources":["../src/voice-catalog-data.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,gCAAgC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/E,OAAO,UAAU,MAAM,sCAAsC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,+FAA+F;AAC/F,mBAAmB;AACnB,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC"}

package/dist/voice-catalog.d.ts

@@ -1,11 +1,11 @@
 import { z } from "zod";
-/** Языки каталога голосов — ЕДИНСТВЕННЫЙ список (#164); остальное выводится из него. */
+/** Voice catalog languages: the ONLY list; everything else is derived from it. */
 export declare const CATALOG_LANGUAGES: readonly ["bg", "cs", "da", "de", "el", "en", "es", "fi", "fil", "fr", "hi", "hr", "hu", "id", "it", "ja", "ko", "ms", "nl", "no", "pl", "pt", "ro", "ru", "sk", "sv", "ta", "tr", "uk", "vi", "zh"];
 export type CatalogLanguage = (typeof CATALOG_LANGUAGES)[number];
 export declare const CATALOG_GENDERS: readonly ["female", "male"];
 export type CatalogGender = (typeof CATALOG_GENDERS)[number];
 export declare const CATALOG_VOICES_PER_GENDER = 5;
-/** Запись сгенерированного файла; не путать с `voiceCatalogEntry` — ответом `/v1/voices`. */
+/** An entry of the generated file; not to be confused with `voiceCatalogEntry`, the `/v1/voices` response. */
 export declare const catalogFileVoice: z.ZodObject<{
     slug: z.ZodString;
     language: z.ZodEnum<{
@@ -171,8 +171,8 @@ export declare const ttsModelLanguagesFile: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type TtsModelLanguagesFile = z.infer<typeof ttsModelLanguagesFile>;
-/** Фильтры `/v1/voices`: разбор запроса, `inputSchema` MCP и параметры SDK. Метки */
-/** `age` и `use_case` берутся из данных каталога, поэтому их допустимый набор знает сервер. */
+/** `/v1/voices` filters: request parsing, the MCP `inputSchema` and SDK parameters. `age` and */
+/** `use_case` labels come from catalog data, so the server knows their allowed set. */
 export declare const voicesQueryShape: {
     language: z.ZodOptional<z.ZodEnum<{
         bg: "bg";
@@ -267,5 +267,5 @@ export declare const voicesQuery: z.ZodObject<{
 }, z.core.$strip>;
 export type VoicesQuery = z.infer<typeof voicesQuery>;
 export declare const VOICES_QUERY_FIELDS: (keyof VoicesQuery)[];
-/** Нормализация метки на чтении: `middle-aged` → `middle_aged`, пустая → нет метки. */
+/** Label normalization on read: `middle-aged` → `middle_aged`, empty → no label. */
 export declare function normalizeVoiceLabel(raw: string | null | undefined): string | undefined;