@contractspec/lib.contracts-spec 2.4.0 → 2.5.0

package/dist/translations/index.js

@@ -28,9 +28,6 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
-// src/translations/spec.ts
-var defineTranslation = (spec) => spec;
-
 // src/translations/registry.ts
 class TranslationRegistry {
   specs = new Map;
@@ -168,6 +165,63 @@ class TranslationRegistry {
   }
 }
 
+// src/translations/i18n-factory.ts
+var DEFAULT_LOCALE = "en";
+var SUPPORTED_LOCALES = ["en", "fr", "es"];
+function resolveLocale(optionsLocale, runtimeLocale) {
+  const raw = runtimeLocale ?? optionsLocale ?? DEFAULT_LOCALE;
+  if (isSupportedLocale(raw))
+    return raw;
+  const base = raw.split("-")[0];
+  if (base && isSupportedLocale(base))
+    return base;
+  return DEFAULT_LOCALE;
+}
+function isSupportedLocale(locale) {
+  return SUPPORTED_LOCALES.includes(locale);
+}
+function interpolate(template, params) {
+  if (!params)
+    return template;
+  return template.replace(/\{(\w+)\}/g, (match, key) => {
+    if (key in params)
+      return String(params[key]);
+    return match;
+  });
+}
+function createI18nFactory(config) {
+  let sharedRegistry = null;
+  function getRegistry() {
+    if (!sharedRegistry) {
+      sharedRegistry = new TranslationRegistry(config.catalogs);
+    }
+    return sharedRegistry;
+  }
+  const factory = {
+    create(optionsLocale, runtimeLocale) {
+      const locale = resolveLocale(optionsLocale, runtimeLocale);
+      const registry = getRegistry();
+      return {
+        locale,
+        t(key, params) {
+          const raw = registry.getValue(config.specKey, key, locale, key);
+          return interpolate(raw, params);
+        }
+      };
+    },
+    getDefault() {
+      return factory.create(DEFAULT_LOCALE);
+    },
+    resetRegistry() {
+      sharedRegistry = null;
+    }
+  };
+  return factory;
+}
+
+// src/translations/spec.ts
+var defineTranslation = (spec) => spec;
+
 // src/translations/validation.ts
 function validateTranslationSpec(spec) {
   const issues = [];
@@ -524,10 +578,16 @@ export {
   validateTranslationSpec,
   validateTranslationRegistry,
   validateICUFormat,
+  resolveLocale,
+  isSupportedLocale,
+  interpolate,
   findMissingTranslations,
   findAllMissingTranslations,
   defineTranslation,
+  createI18nFactory,
   assertTranslationSpecValid,
   TranslationValidationError,
-  TranslationRegistry
+  TranslationRegistry,
+  SUPPORTED_LOCALES,
+  DEFAULT_LOCALE
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.contracts-spec",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Spec definitions and registries for ContractSpec",
   "keywords": [
     "contractspec",
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "@blocknote/core": "^0.46.1",
-    "@contractspec/lib.schema": "2.4.0",
+    "@contractspec/lib.schema": "2.5.0",
     "compare-versions": "^6.1.1",
     "turndown": "^7.2.2",
     "zod": "^4.3.5"
@@ -38,8 +38,8 @@
     "react": "^19.2.4"
   },
   "devDependencies": {
-    "@contractspec/tool.bun": "2.4.0",
-    "@contractspec/tool.typescript": "2.4.0",
+    "@contractspec/tool.bun": "2.5.0",
+    "@contractspec/tool.typescript": "2.5.0",
     "@types/turndown": "^5.0.6",
     "typescript": "^5.9.3"
   },
@@ -1014,6 +1014,12 @@
       "node": "./dist/node/integrations/providers/database.js",
       "default": "./dist/integrations/providers/database.js"
     },
+    "./integrations/providers/deepgram": {
+      "types": "./dist/integrations/providers/deepgram.d.ts",
+      "bun": "./dist/integrations/providers/deepgram.js",
+      "node": "./dist/node/integrations/providers/deepgram.js",
+      "default": "./dist/integrations/providers/deepgram.js"
+    },
     "./integrations/providers/elevenlabs": {
       "types": "./dist/integrations/providers/elevenlabs.d.ts",
       "bun": "./dist/integrations/providers/elevenlabs.js",
@@ -1038,6 +1044,12 @@
       "node": "./dist/node/integrations/providers/fal.js",
       "default": "./dist/integrations/providers/fal.js"
     },
+    "./integrations/providers/fal-image": {
+      "types": "./dist/integrations/providers/fal-image.d.ts",
+      "bun": "./dist/integrations/providers/fal-image.js",
+      "node": "./dist/node/integrations/providers/fal-image.js",
+      "default": "./dist/integrations/providers/fal-image.js"
+    },
     "./integrations/providers/fathom": {
       "types": "./dist/integrations/providers/fathom.d.ts",
       "bun": "./dist/integrations/providers/fathom.js",
@@ -1080,6 +1092,12 @@
       "node": "./dist/node/integrations/providers/granola.js",
       "default": "./dist/integrations/providers/granola.js"
     },
+    "./integrations/providers/image": {
+      "types": "./dist/integrations/providers/image.d.ts",
+      "bun": "./dist/integrations/providers/image.js",
+      "node": "./dist/node/integrations/providers/image.js",
+      "default": "./dist/integrations/providers/image.js"
+    },
     "./integrations/providers/index": {
       "types": "./dist/integrations/providers/index.d.ts",
       "bun": "./dist/integrations/providers/index.js",
@@ -1122,6 +1140,18 @@
       "node": "./dist/node/integrations/providers/notion.js",
       "default": "./dist/integrations/providers/notion.js"
     },
+    "./integrations/providers/openai-image": {
+      "types": "./dist/integrations/providers/openai-image.d.ts",
+      "bun": "./dist/integrations/providers/openai-image.js",
+      "node": "./dist/node/integrations/providers/openai-image.js",
+      "default": "./dist/integrations/providers/openai-image.js"
+    },
+    "./integrations/providers/openai-realtime": {
+      "types": "./dist/integrations/providers/openai-realtime.d.ts",
+      "bun": "./dist/integrations/providers/openai-realtime.js",
+      "node": "./dist/node/integrations/providers/openai-realtime.js",
+      "default": "./dist/integrations/providers/openai-realtime.js"
+    },
     "./integrations/providers/openbanking": {
       "types": "./dist/integrations/providers/openbanking.d.ts",
       "bun": "./dist/integrations/providers/openbanking.js",
@@ -1230,6 +1260,12 @@
       "node": "./dist/node/integrations/providers/voice.js",
       "default": "./dist/integrations/providers/voice.js"
     },
+    "./integrations/providers/voice-video-sync": {
+      "types": "./dist/integrations/providers/voice-video-sync.d.ts",
+      "bun": "./dist/integrations/providers/voice-video-sync.js",
+      "node": "./dist/node/integrations/providers/voice-video-sync.js",
+      "default": "./dist/integrations/providers/voice-video-sync.js"
+    },
     "./integrations/runtime": {
       "types": "./dist/integrations/runtime.d.ts",
       "bun": "./dist/integrations/runtime.js",
@@ -2046,6 +2082,12 @@
       "node": "./dist/node/translations/catalog.js",
       "default": "./dist/translations/catalog.js"
     },
+    "./translations/i18n-factory": {
+      "types": "./dist/translations/i18n-factory.d.ts",
+      "bun": "./dist/translations/i18n-factory.js",
+      "node": "./dist/node/translations/i18n-factory.js",
+      "default": "./dist/translations/i18n-factory.js"
+    },
     "./translations/index": {
       "types": "./dist/translations/index.d.ts",
       "bun": "./dist/translations/index.js",
@@ -3203,6 +3245,12 @@
         "node": "./dist/node/integrations/providers/database.js",
         "default": "./dist/integrations/providers/database.js"
       },
+      "./integrations/providers/deepgram": {
+        "types": "./dist/integrations/providers/deepgram.d.ts",
+        "bun": "./dist/integrations/providers/deepgram.js",
+        "node": "./dist/node/integrations/providers/deepgram.js",
+        "default": "./dist/integrations/providers/deepgram.js"
+      },
       "./integrations/providers/elevenlabs": {
         "types": "./dist/integrations/providers/elevenlabs.d.ts",
         "bun": "./dist/integrations/providers/elevenlabs.js",
@@ -3227,6 +3275,12 @@
         "node": "./dist/node/integrations/providers/fal.js",
         "default": "./dist/integrations/providers/fal.js"
       },
+      "./integrations/providers/fal-image": {
+        "types": "./dist/integrations/providers/fal-image.d.ts",
+        "bun": "./dist/integrations/providers/fal-image.js",
+        "node": "./dist/node/integrations/providers/fal-image.js",
+        "default": "./dist/integrations/providers/fal-image.js"
+      },
       "./integrations/providers/fathom": {
         "types": "./dist/integrations/providers/fathom.d.ts",
         "bun": "./dist/integrations/providers/fathom.js",
@@ -3269,6 +3323,12 @@
         "node": "./dist/node/integrations/providers/granola.js",
         "default": "./dist/integrations/providers/granola.js"
       },
+      "./integrations/providers/image": {
+        "types": "./dist/integrations/providers/image.d.ts",
+        "bun": "./dist/integrations/providers/image.js",
+        "node": "./dist/node/integrations/providers/image.js",
+        "default": "./dist/integrations/providers/image.js"
+      },
       "./integrations/providers/index": {
         "types": "./dist/integrations/providers/index.d.ts",
         "bun": "./dist/integrations/providers/index.js",
@@ -3311,6 +3371,18 @@
         "node": "./dist/node/integrations/providers/notion.js",
         "default": "./dist/integrations/providers/notion.js"
       },
+      "./integrations/providers/openai-image": {
+        "types": "./dist/integrations/providers/openai-image.d.ts",
+        "bun": "./dist/integrations/providers/openai-image.js",
+        "node": "./dist/node/integrations/providers/openai-image.js",
+        "default": "./dist/integrations/providers/openai-image.js"
+      },
+      "./integrations/providers/openai-realtime": {
+        "types": "./dist/integrations/providers/openai-realtime.d.ts",
+        "bun": "./dist/integrations/providers/openai-realtime.js",
+        "node": "./dist/node/integrations/providers/openai-realtime.js",
+        "default": "./dist/integrations/providers/openai-realtime.js"
+      },
       "./integrations/providers/openbanking": {
         "types": "./dist/integrations/providers/openbanking.d.ts",
         "bun": "./dist/integrations/providers/openbanking.js",
@@ -3419,6 +3491,12 @@
         "node": "./dist/node/integrations/providers/voice.js",
         "default": "./dist/integrations/providers/voice.js"
       },
+      "./integrations/providers/voice-video-sync": {
+        "types": "./dist/integrations/providers/voice-video-sync.d.ts",
+        "bun": "./dist/integrations/providers/voice-video-sync.js",
+        "node": "./dist/node/integrations/providers/voice-video-sync.js",
+        "default": "./dist/integrations/providers/voice-video-sync.js"
+      },
       "./integrations/runtime": {
         "types": "./dist/integrations/runtime.d.ts",
         "bun": "./dist/integrations/runtime.js",
@@ -4235,6 +4313,12 @@
         "node": "./dist/node/translations/catalog.js",
         "default": "./dist/translations/catalog.js"
       },
+      "./translations/i18n-factory": {
+        "types": "./dist/translations/i18n-factory.d.ts",
+        "bun": "./dist/translations/i18n-factory.js",
+        "node": "./dist/node/translations/i18n-factory.js",
+        "default": "./dist/translations/i18n-factory.js"
+      },
       "./translations/index": {
         "types": "./dist/translations/index.d.ts",
         "bun": "./dist/translations/index.js",