@broberg/ai-sdk 0.40.0 → 0.41.0

package/dist/index.d.ts

@@ -39,13 +39,31 @@ declare function classifyRegionName(name: string | undefined): Region;
  *  is it?" — a narrower question than "where will my call go?". */
 declare function regionOfProvider(provider: string): Region;
 
-/** One dictionary entry. `alias` says it differently; `ipa` says it precisely. */
+/** One dictionary entry. `alias` says it differently; `ipa` says it in phonemes.
+ *
+ *  **`ipa` is NOT the "more precise" option for a FOREIGN word — measured 2026-09-04.**
+ *  Christian listened to `workflow` as `ˈwɜːkfloʊ` through the da-DK voices jeppe and
+ *  christel and reported: *"ikke korrekt engelsk med et sjovt mix"*. A Danish neural
+ *  voice renders English phonemes through Danish phonology, so foreign IPA comes out a
+ *  hybrid rather than English. The symbols are honoured; the accent is not.
+ *
+ *  So pick by what the word IS, not by which field sounds more exact:
+ *  - a DANISH word the voice mispronounces → `ipa` does what you want.
+ *  - an ENGLISH word inside Danish text → neither field is right yet. `alias` (spell it
+ *    the way a Dane would say it) is the honest workaround today; a real engine switch
+ *    is F051.2, and it is blocked on a listening test, not on code.
+ *
+ *  Dated on purpose. This is a measurement of two specific voices on one date, not a
+ *  permanent property of IPA — Azure ships new voices, and the next reader deserves to
+ *  see that it may have moved. */
 interface Pronunciation {
     /** The word as it appears in the text. Matched whole-word, case-insensitively. */
     word: string;
     /** Say this instead. Azure `<sub alias>`; ElevenLabs plain substitution. */
     alias?: string;
-    /** IPA phonemes. Azure `<phoneme alphabet="ipa" ph>`. ElevenLabs cannot do this. */
+    /** IPA phonemes. Azure `<phoneme alphabet="ipa" ph>`. ElevenLabs cannot do this
+     *  (it THROWS rather than silently skipping). See the type doc above before reaching
+     *  for this on a foreign word. */
     ipa?: string;
     /** Reserved for a future per-entry language switch; carried but not yet emitted. */
     lang?: string;
@@ -2320,8 +2338,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.40.0";
-declare const SDK_TAG: "@broberg/ai-sdk@0.40.0";
+declare const VERSION: "0.41.0";
+declare const SDK_TAG: "@broberg/ai-sdk@0.41.0";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.

package/dist/index.js

@@ -18,7 +18,7 @@ import {
   listMediaPrices,
   pricingFreshness,
   pricingGeneratedAt
-} from "./chunk-KXTCLLVF.js";
+} from "./chunk-B74RSBT5.js";
 
 // src/transport/http.ts
 async function httpTransport(req) {
@@ -1537,7 +1537,7 @@ function assertPronunciations(list, provider) {
     }
     if (p.alias !== void 0 && p.ipa !== void 0) {
       throw new Error(
-        `${provider} adapter: pronunciation "${p.word}" sets BOTH alias and ipa. They are different instructions \u2014 alias says it differently, ipa says it precisely. Pick one.`
+        `${provider} adapter: pronunciation "${p.word}" sets BOTH alias and ipa. They are different instructions \u2014 alias says it differently, ipa says it in phonemes. Pick one.`
       );
     }
     if (p.alias === void 0 && p.ipa === void 0) {
@@ -3093,8 +3093,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.40.0";
-var SDK_TAG = "@broberg/ai-sdk@0.40.0";
+var VERSION = "0.41.0";
+var SDK_TAG = "@broberg/ai-sdk@0.41.0";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {