@clipwright/core 0.1.0

package/dist/tts-backend.js

@@ -0,0 +1,54 @@
+/**
+ * Вендор-нейтральный контракт синтеза речи.
+ *
+ * ЗАЧЕМ отдельно от рендера: провайдеры TTS меняются независимо от провайдеров
+ * аватара, и «ElevenLabs + HeyGen» — лишь одна из комбинаций.
+ *
+ * Ключевая причина существования этого файла — ТАЙМИНГИ. ElevenLabs отдаёт их
+ * ПОСИМВОЛЬНО (проверено 18.07.2026: 134 символа → 134 тайминга), а этап B
+ * ждёт пословные для `createTikTokStyleCaptions()`. Другой провайдер отдаст
+ * пословные сразу или не отдаст вовсе. Нормализация обязана происходить в
+ * адаптере, иначе посимвольный формат ElevenLabs протечёт в пайплайн субтитров
+ * и намертво привяжет нас к вендору.
+ */
+/**
+ * Склейка посимвольных таймингов в пословные.
+ *
+ * Живёт здесь, а не в адаптере ElevenLabs, потому что посимвольный формат
+ * встречается у нескольких вендоров, и переписывать эту логику под каждого —
+ * лишняя работа с одинаковыми граничными случаями.
+ *
+ * Границей слова считается пробельный символ; сам пробел в слово не входит,
+ * но и не рвёт уже начатое. Пустые слова не порождаются.
+ */
+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, ` +
+            `${startTimes.length} starts, ${endTimes.length} ends`);
+    }
+    const words = [];
+    let buf = "";
+    let start = 0;
+    let end = 0;
+    const flush = () => {
+        if (buf.length > 0) {
+            words.push({ word: buf, startSec: start, endSec: end });
+            buf = "";
+        }
+    };
+    for (let i = 0; i < characters.length; i += 1) {
+        const ch = characters[i];
+        if (/\s/.test(ch)) {
+            flush();
+            continue;
+        }
+        if (buf.length === 0) {
+            start = startTimes[i];
+        }
+        buf += ch;
+        end = endTimes[i];
+    }
+    flush();
+    return words;
+}
+//# sourceMappingURL=tts-backend.js.map

package/dist/tts-backend.js.map

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

package/dist/voices.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Каталог голосовых пресетов — НАШИ имена + метадата, БЕЗ вендорских id.
+ *
+ * ЗАЧЕМ имена здесь, а id в адаптере (условие плана R4-b, принцип 5):
+ * `VOICE_PRESET_NAMES` порождает `z.enum` во входе `make_ugc` (`makeUgcInputShape`),
+ * а он, в свою очередь, — `tools/list`/OpenAPI/типы SDK. Значит имена ОБЯЗАНЫ жить
+ * в core. Вендорские ElevenLabs-id — платный секрет вендора и живут ровно в одном
+ * месте — адаптере воркера (`PRESET_TO_VOICE_ID`, US-514); в core их нет ни одного,
+ * иначе поверхность ключа расширилась бы (был инцидент 6fbe5b6). Расщепление
+ * «имя в core / id в адаптере» вынуждено этими двумя инвариантами.
+ *
+ * ПОЧЕМУ у `owner_ru_clone` нет `gender`: это клон голоса владельца, и у вендора
+ * для него нет лейбла гендера. Выдумывать метадату за вендора нельзя (принцип
+ * «мы не должны выдумывать», условие §6) — отсутствие поля само по себе значимо
+ * и участвует в precedence-логике verify-voices (US-520) и warnings (US-517).
+ */
+export interface VoicePreset {
+    /** Язык голоса в терминах BCP-47-подобного короткого кода (ru/en). */
+    language: string;
+    /**
+     * Гендерный лейбл голоса. ОПУЩЕН намеренно, если у вендора его нет
+     * (клон владельца): отсутствие ≠ "неизвестно", это осознанный сигнал.
+     */
+    gender?: "female" | "male";
+    /** Человекочитаемое описание для list_voices (US-516). */
+    description: string;
+}
+/**
+ * Стартовый набор из 5 пресетов (условие плана §4). Порядок значим только для
+ * презентации; дефолт задаётся отдельно через `DEFAULT_VOICE_PRESET`.
+ */
+export declare const VOICE_PRESETS: {
+    readonly owner_ru_clone: {
+        readonly language: "ru";
+        readonly description: "Клон голоса владельца (David-Dmitry-Ru); русский — на английском даёт акцент";
+    };
+    readonly sarah: {
+        readonly language: "en";
+        readonly gender: "female";
+        readonly description: "Soft, natural female voice (English)";
+    };
+    readonly george: {
+        readonly language: "en";
+        readonly gender: "male";
+        readonly description: "Warm British storyteller, narrative pacing (English)";
+    };
+    readonly eric: {
+        readonly language: "en";
+        readonly gender: "male";
+        readonly description: "Smooth American, conversational tone (English)";
+    };
+    readonly daria_ru_female: {
+        readonly language: "ru";
+        readonly gender: "female";
+        readonly description: "Женский повествовательный голос (русский)";
+    };
+};
+/**
+ * Кортеж имён пресетов для `z.enum`. Выводится из ключей `VOICE_PRESETS`, чтобы
+ * список имён и метадата не разъехались (правило проекта №2 — не дублировать).
+ */
+export declare const VOICE_PRESET_NAMES: [keyof typeof VOICE_PRESETS, ...(keyof typeof VOICE_PRESETS)[]];
+export type VoicePresetName = keyof typeof VOICE_PRESETS;
+/**
+ * Дефолт под текущий аватар (look-01 «warm storyteller»): `george` —
+ * британский повествовательный голос, семантически совпадает с образом.
+ * Изначально дефолтом ставился клон владельца, но на английских скриптах он
+ * давал русский акцент (on-ear владельца 2026-07-20) — сменён на нейтральный
+ * английский. Клон остаётся доступным пресетом `owner_ru_clone` для русских
+ * скриптов. Подстановка дефолта — забота резолвера, а не схемы (схема хранит
+ * `.optional()` без `.default()`, чтобы отличать явный выбор от умолчания —
+ * нужно для warnings US-517).
+ */
+export declare const DEFAULT_VOICE_PRESET: "george";
+/**
+ * Форма сырого `voice_id` вендора. НАМЕРЕННО терпимая (16–32 алфанумерик):
+ * ElevenLabs не документирует формат id, наблюдаемые id — 20 символов, но
+ * строгая длина 20 превратила бы будущий валидный id иной длины в ложный
+ * отказ. Это лишь грубый фильтр мусора на входе; реальную проверку
+ * существования id делает бесплатный префлайт в воркере (US-515).
+ */
+export declare const VOICE_ID_PATTERN: RegExp;
+/**
+ * Результат разрешения выбора голоса — дискриминированное объединение. `preset`
+ * несёт НАШЕ имя (адаптер превратит его в вендорский id через `PRESET_TO_VOICE_ID`),
+ * `raw` — уже сырой вендорский id (escape hatch). Core НЕ знает вендорских id, и
+ * это объединение — граница: дальше маппинг делает адаптер (принцип 5).
+ */
+export type VoiceSelection = {
+    kind: "preset";
+    preset: VoicePresetName;
+} | {
+    kind: "raw";
+    voiceId: string;
+};
+/**
+ * Чистое разрешение приоритета голосовых полей входа.
+ *
+ * Взаимоисключение `voice`/`voice_id` уже гарантировано `.refine` в
+ * `makeUgcInput` (skills.ts), поэтому здесь — только приоритет и подстановка
+ * дефолта, без повторной валидации. Приоритет: сырой `voice_id` (явный escape
+ * hatch) > `voice` (имя пресета) > дефолт (клон владельца). Дефолт живёт тут, а
+ * не в схеме, потому что схема хранит `.optional()` без `.default()`, чтобы
+ * отличать явный выбор от умолчания (warnings US-517).
+ */
+export declare function resolveVoiceSelection(input: {
+    voice?: VoicePresetName;
+    voice_id?: string;
+}): VoiceSelection;
+/**
+ * Семейство письменности скрипта — грубый детектор для языкового warning'а
+ * (US-517). Считает ТОЛЬКО буквенные символы: кириллица (U+0400–U+04FF) против
+ * латиницы (A–Z/a–z). Знаки препинания, цифры, пробелы, эмодзи игнорируются —
+ * они не различают язык.
+ *
+ * НЕЙТРАЛЬНАЯ ПОЛОСА (детерминированно, тестируемо):
+ *  - < 2 букв всего (пусто, одни цифры, единичная буква-случайность) → "neutral":
+ *    данных для суждения нет (это «мало букв» из плана §Р3, условие ii);
+ *  - ни одна сторона не набрала порога доминирования 60% (напр. смесь 50/50) →
+ *    "neutral": язык скрипта неоднозначен, warning выдавать не на чем.
+ * Только уверенное доминирование (≥60%) даёт "cyrillic"/"latin".
+ */
+export declare const SCRIPT_DOMINANCE_THRESHOLD = 0.6;
+export declare function detectScriptFamily(script: string): "cyrillic" | "latin" | "neutral";
+/**
+ * Warning отложенной проверки сырого voice_id на ПУТИ QUOTE (US-517). На quote
+ * префлайта ещё нет (он бесплатный, но живёт в воркере, US-515), поэтому честно
+ * сообщаем: существование id сверяется со счётом на СТАРТЕ рана, не сейчас. На
+ * пути рана этот warning НЕ выдаётся — там префлайт уже отработал и, если каталог
+ * неполон, добавит собственный `VOICE_CATALOG_INCOMPLETE_WARNING` (воркер зовёт
+ * buildVoiceWarnings без voice_id, чтобы эти два не дублировали друг друга).
+ */
+export declare const RAW_VOICE_ID_VALIDATION_WARNING = "raw voice_id is verified against your account at run start, not at quote time";
+/**
+ * Голосовые warnings по ТЕСТУ ДОПУСТИМОСТИ (план §Р3). Warning допустим, только
+ * если ОДНОВРЕМЕННО: (i) причина — то, что клиент запросил ЯВНО (не дефолт, не наш
+ * выбор); (ii) утверждение опирается на данные, которые ЕСТЬ (лейбл присутствует),
+ * а не на их отсутствие; (iii) на дефолтном happy-path не срабатывает НИКОГДА.
+ *
+ * ПРАВИЛО СТАРШИНСТВА ПОДМЕНЫ: подмена (клиент попросил X, отдали Y) предупреждает
+ * ВСЕГДА, независимо от (iii) — (iii) глушит уведомления о ПРАВИЛЬНОМ поведении, не
+ * о деградированном. Канон такой подмены — 1080p→720p (render-backend.ts:144). В
+ * ДАННОМ дизайне подмены голоса НЕТ: путь падает closed (сырой id не найден → бросок
+ * до платного POST, US-515; неизвестное имя → 400 на границе enum), голос молча не
+ * заменяется. Поэтому правило старшинства здесь не применяется — но зафиксировано,
+ * чтобы будущая подмена не была ошибочно заглушена условием (iii).
+ *
+ * ПОЧЕМУ НЕТ ГЕНДЕР-WARNING (осознанное отсутствие, а не упущение): у нас нет
+ * источника правды о гендере АВАТАРА — модель персонажа ещё не приземлилась (план
+ * §D, открытый вопрос 4), а у клона владельца (`owner_ru_clone`) вендор не даёт и
+ * гендера ГОЛОСА (правило проекта — не выдумывать метадату за вендора, условие §6).
+ * Нормативно: warning о несовпадении голос/аватар опирался бы на ОТСУТСТВУЮЩИЕ
+ * данные (нарушение условия ii) и на дефолтном пути шумел бы (нарушение iii). Ни
+ * один кодовый путь ниже не порождает строки со словом gender по построению.
+ *
+ * ПОЧЕМУ тест не подавляет обязательный warning про подмену №3 (принцип DR-2):
+ * обязанность №3 крепится к НЕИСПОЛНЕННОМУ явному запросу (клиент попросил 1080p,
+ * дали 720p) — это подмена, у неё старшинство над (iii). Здесь же голос либо
+ * исполняется как запрошен, либо ран падает — деградированной выдачи под видом
+ * успешной не бывает, глушить нечего.
+ */
+export declare function buildVoiceWarnings(input: {
+    voice?: VoicePresetName | undefined;
+    voice_id?: string | undefined;
+    script: string;
+}): string[];

package/dist/voices.js

@@ -0,0 +1,193 @@
+/**
+ * Стартовый набор из 5 пресетов (условие плана §4). Порядок значим только для
+ * презентации; дефолт задаётся отдельно через `DEFAULT_VOICE_PRESET`.
+ */
+export const VOICE_PRESETS = {
+    owner_ru_clone: {
+        language: "ru",
+        description: "Клон голоса владельца (David-Dmitry-Ru); русский — на английском даёт акцент",
+    },
+    sarah: {
+        language: "en",
+        gender: "female",
+        description: "Soft, natural female voice (English)",
+    },
+    george: {
+        language: "en",
+        gender: "male",
+        description: "Warm British storyteller, narrative pacing (English)",
+    },
+    eric: {
+        language: "en",
+        gender: "male",
+        description: "Smooth American, conversational tone (English)",
+    },
+    daria_ru_female: {
+        language: "ru",
+        gender: "female",
+        description: "Женский повествовательный голос (русский)",
+    },
+};
+/**
+ * Кортеж имён пресетов для `z.enum`. Выводится из ключей `VOICE_PRESETS`, чтобы
+ * список имён и метадата не разъехались (правило проекта №2 — не дублировать).
+ */
+export const VOICE_PRESET_NAMES = Object.keys(VOICE_PRESETS);
+/**
+ * Дефолт под текущий аватар (look-01 «warm storyteller»): `george` —
+ * британский повествовательный голос, семантически совпадает с образом.
+ * Изначально дефолтом ставился клон владельца, но на английских скриптах он
+ * давал русский акцент (on-ear владельца 2026-07-20) — сменён на нейтральный
+ * английский. Клон остаётся доступным пресетом `owner_ru_clone` для русских
+ * скриптов. Подстановка дефолта — забота резолвера, а не схемы (схема хранит
+ * `.optional()` без `.default()`, чтобы отличать явный выбор от умолчания —
+ * нужно для warnings US-517).
+ */
+export const DEFAULT_VOICE_PRESET = "george";
+/**
+ * Форма сырого `voice_id` вендора. НАМЕРЕННО терпимая (16–32 алфанумерик):
+ * ElevenLabs не документирует формат id, наблюдаемые id — 20 символов, но
+ * строгая длина 20 превратила бы будущий валидный id иной длины в ложный
+ * отказ. Это лишь грубый фильтр мусора на входе; реальную проверку
+ * существования id делает бесплатный префлайт в воркере (US-515).
+ */
+export const VOICE_ID_PATTERN = /^[A-Za-z0-9]{16,32}$/;
+/**
+ * Чистое разрешение приоритета голосовых полей входа.
+ *
+ * Взаимоисключение `voice`/`voice_id` уже гарантировано `.refine` в
+ * `makeUgcInput` (skills.ts), поэтому здесь — только приоритет и подстановка
+ * дефолта, без повторной валидации. Приоритет: сырой `voice_id` (явный escape
+ * hatch) > `voice` (имя пресета) > дефолт (клон владельца). Дефолт живёт тут, а
+ * не в схеме, потому что схема хранит `.optional()` без `.default()`, чтобы
+ * отличать явный выбор от умолчания (warnings US-517).
+ */
+export function resolveVoiceSelection(input) {
+    if (input.voice_id !== undefined) {
+        return { kind: "raw", voiceId: input.voice_id };
+    }
+    if (input.voice !== undefined) {
+        return { kind: "preset", preset: input.voice };
+    }
+    return { kind: "preset", preset: DEFAULT_VOICE_PRESET };
+}
+/**
+ * Семейство письменности скрипта — грубый детектор для языкового warning'а
+ * (US-517). Считает ТОЛЬКО буквенные символы: кириллица (U+0400–U+04FF) против
+ * латиницы (A–Z/a–z). Знаки препинания, цифры, пробелы, эмодзи игнорируются —
+ * они не различают язык.
+ *
+ * НЕЙТРАЛЬНАЯ ПОЛОСА (детерминированно, тестируемо):
+ *  - < 2 букв всего (пусто, одни цифры, единичная буква-случайность) → "neutral":
+ *    данных для суждения нет (это «мало букв» из плана §Р3, условие ii);
+ *  - ни одна сторона не набрала порога доминирования 60% (напр. смесь 50/50) →
+ *    "neutral": язык скрипта неоднозначен, warning выдавать не на чем.
+ * Только уверенное доминирование (≥60%) даёт "cyrillic"/"latin".
+ */
+export const SCRIPT_DOMINANCE_THRESHOLD = 0.6;
+export function detectScriptFamily(script) {
+    let cyrillic = 0;
+    let latin = 0;
+    for (const ch of script) {
+        if (ch >= "Ѐ" && ch <= "ӿ") {
+            cyrillic += 1;
+        }
+        else if ((ch >= "A" && ch <= "Z") || (ch >= "a" && ch <= "z")) {
+            latin += 1;
+        }
+    }
+    const total = cyrillic + latin;
+    // «Мало букв» → нейтрально: судить о языке не на чем (условие ii — данных нет).
+    if (total < 2) {
+        return "neutral";
+    }
+    if (cyrillic / total >= SCRIPT_DOMINANCE_THRESHOLD) {
+        return "cyrillic";
+    }
+    if (latin / total >= SCRIPT_DOMINANCE_THRESHOLD) {
+        return "latin";
+    }
+    return "neutral";
+}
+/**
+ * Отображение нашего короткого языкового лейбла пресета в семейство письменности.
+ * НАМЕРЕННО охватывает только языки, которые мы реально размечаем (ru/en): лейбл
+ * вне этого набора трактуется как «нет данных для сравнения» и глушит warning
+ * (условие ii — утверждение опирается на присутствующие данные, а не на догадку).
+ */
+const LANGUAGE_TO_SCRIPT_FAMILY = {
+    ru: "cyrillic",
+    en: "latin",
+};
+/**
+ * Warning отложенной проверки сырого voice_id на ПУТИ QUOTE (US-517). На quote
+ * префлайта ещё нет (он бесплатный, но живёт в воркере, US-515), поэтому честно
+ * сообщаем: существование id сверяется со счётом на СТАРТЕ рана, не сейчас. На
+ * пути рана этот warning НЕ выдаётся — там префлайт уже отработал и, если каталог
+ * неполон, добавит собственный `VOICE_CATALOG_INCOMPLETE_WARNING` (воркер зовёт
+ * buildVoiceWarnings без voice_id, чтобы эти два не дублировали друг друга).
+ */
+export const RAW_VOICE_ID_VALIDATION_WARNING = "raw voice_id is verified against your account at run start, not at quote time";
+/**
+ * Голосовые warnings по ТЕСТУ ДОПУСТИМОСТИ (план §Р3). Warning допустим, только
+ * если ОДНОВРЕМЕННО: (i) причина — то, что клиент запросил ЯВНО (не дефолт, не наш
+ * выбор); (ii) утверждение опирается на данные, которые ЕСТЬ (лейбл присутствует),
+ * а не на их отсутствие; (iii) на дефолтном happy-path не срабатывает НИКОГДА.
+ *
+ * ПРАВИЛО СТАРШИНСТВА ПОДМЕНЫ: подмена (клиент попросил X, отдали Y) предупреждает
+ * ВСЕГДА, независимо от (iii) — (iii) глушит уведомления о ПРАВИЛЬНОМ поведении, не
+ * о деградированном. Канон такой подмены — 1080p→720p (render-backend.ts:144). В
+ * ДАННОМ дизайне подмены голоса НЕТ: путь падает closed (сырой id не найден → бросок
+ * до платного POST, US-515; неизвестное имя → 400 на границе enum), голос молча не
+ * заменяется. Поэтому правило старшинства здесь не применяется — но зафиксировано,
+ * чтобы будущая подмена не была ошибочно заглушена условием (iii).
+ *
+ * ПОЧЕМУ НЕТ ГЕНДЕР-WARNING (осознанное отсутствие, а не упущение): у нас нет
+ * источника правды о гендере АВАТАРА — модель персонажа ещё не приземлилась (план
+ * §D, открытый вопрос 4), а у клона владельца (`owner_ru_clone`) вендор не даёт и
+ * гендера ГОЛОСА (правило проекта — не выдумывать метадату за вендора, условие §6).
+ * Нормативно: warning о несовпадении голос/аватар опирался бы на ОТСУТСТВУЮЩИЕ
+ * данные (нарушение условия ii) и на дефолтном пути шумел бы (нарушение iii). Ни
+ * один кодовый путь ниже не порождает строки со словом gender по построению.
+ *
+ * ПОЧЕМУ тест не подавляет обязательный warning про подмену №3 (принцип DR-2):
+ * обязанность №3 крепится к НЕИСПОЛНЕННОМУ явному запросу (клиент попросил 1080p,
+ * дали 720p) — это подмена, у неё старшинство над (iii). Здесь же голос либо
+ * исполняется как запрошен, либо ран падает — деградированной выдачи под видом
+ * успешной не бывает, глушить нечего.
+ */
+export function buildVoiceWarnings(input) {
+    // Сырой escape-hatch id: причина явная (i), но проверка существования отложена
+    // до рана. На quote префлайта нет — предупреждаем об отложенной валидации.
+    if (input.voice_id !== undefined) {
+        return [RAW_VOICE_ID_VALIDATION_WARNING];
+    }
+    // Условие (iii): голос НЕ задан явно → дефолт (клон владельца). На дефолтном
+    // happy-path языковых warning'ов НЕТ НИКОГДА — это несущий анти-шум US-517.
+    if (input.voice === undefined) {
+        return [];
+    }
+    // Defensive: до вызова zod уже сузил voice до валидного имени enum, но чистая
+    // функция не полагается на это. Неизвестное имя → нет пресета → нет данных → [].
+    const preset = VOICE_PRESETS[input.voice];
+    if (preset === undefined) {
+        return [];
+    }
+    // Условие (ii): сравнивать можно только при ПРИСУТСТВУЮЩЕМ пригодном лейбле.
+    // Язык вне размеченного набора (ru/en) — «нет данных» → молчим, не выдумываем.
+    const voiceFamily = LANGUAGE_TO_SCRIPT_FAMILY[preset.language];
+    if (voiceFamily === undefined) {
+        return [];
+    }
+    // Условие (i)+(ii) выполнены: причина — явно выбранный пресет, а суждение
+    // опирается на присутствующий лейбл против ДЕТЕКТИРОВАННОГО семейства скрипта.
+    // Нейтральный/неоднозначный скрипт не противоречит ничему → молчим (ii).
+    const scriptFamily = detectScriptFamily(input.script);
+    if (scriptFamily === "neutral" || scriptFamily === voiceFamily) {
+        return [];
+    }
+    return [
+        `voice "${input.voice}" is labeled ${preset.language}, but the script looks ${scriptFamily}; it will be voiced in a ${preset.language} voice`,
+    ];
+}
+//# sourceMappingURL=voices.js.map

package/dist/voices.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@clipwright/core",
+  "version": "0.1.0",
+  "description": "Zod schemas and the shared request/response contract of the Clipwright UGC video API",
+  "license": "MIT",
+  "author": "Dimantika LLC",
+  "homepage": "https://clipwright.io",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./idempotency": {
+      "types": "./dist/idempotency.d.ts",
+      "default": "./dist/idempotency.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit"
+  }
+}