@better-translate/core 1.0.0 → 2.1.0

package/dist/{chunk-PE2HFT6R.js → chunk-GVC3VHIX.js}

@@ -157,6 +157,9 @@ function createConfiguredTranslator(config) {
   };
   const translate = ((...args) => {
     const [key, options] = args;
+    if (options?.bt === true) {
+      return key;
+    }
     const locale = resolveLocale(options);
     const activeValue = resolveMessageValue(messageCache[locale], key);
     if (typeof activeValue === "string") {
@@ -365,6 +368,9 @@ function getTranslator() {
   return translator;
 }
 function t(key, options) {
+  if (options?.bt === true) {
+    return key;
+  }
   return getTranslator().t(key, options);
 }
 async function loadLocale(locale) {

package/dist/core.d.ts

@@ -1,6 +1,7 @@
 import type {
   AnyConfiguredTranslator,
   AnyTranslationHelpers,
+  BtTranslateOptions,
   CachedMessages,
   ConfiguredTranslator,
   DeepPartialMessages,
@@ -17,6 +18,8 @@ import type {
 } from "./types.js";
 
 export type {
+  BtTranslateCall,
+  BtTranslateOptions,
   AnyTranslationHelpers,
   CachedMessages,
   ConfiguredTranslator,
@@ -138,6 +141,8 @@ export declare function createTranslationJsonSchema(
 
 export declare function getTranslator(): AnyConfiguredTranslator;
 
+export declare function t(key: string, options: BtTranslateOptions): string;
+
 export declare function t(
   key: string,
   options?: TranslateOptions<string>,

package/dist/core.js

@@ -9,7 +9,7 @@ import {
   loadLocale,
   resetTranslationsForTests,
   t
-} from "./chunk-PE2HFT6R.js";
+} from "./chunk-GVC3VHIX.js";
 export {
   configureTranslations,
   createTranslationHelpers,

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   loadLocale,
   resetTranslationsForTests,
   t
-} from "./chunk-PE2HFT6R.js";
+} from "./chunk-GVC3VHIX.js";
 export {
   configureTranslations,
   createTranslationHelpers,

package/dist/types.d.ts

@@ -55,6 +55,9 @@ export type TranslationPlaceholderNames<TMessages extends TranslationMessages, T
 export type TranslationParamsForKey<TMessages extends TranslationMessages, TKey extends string> = string extends TranslationPlaceholderNames<TMessages, TKey> ? TranslationParams : TranslationParamsObject<TranslationPlaceholderNames<TMessages, TKey>>;
 export type TranslationKeysWithRequiredParams<TMessages extends TranslationMessages> = TranslationKey<TMessages> extends infer TKey ? TKey extends string ? [TranslationPlaceholderNames<TMessages, TKey>] extends [never] ? never : string extends TranslationPlaceholderNames<TMessages, TKey> ? never : TKey : never : never;
 export type TranslationKeysWithOptionalParams<TMessages extends TranslationMessages> = Exclude<TranslationKey<TMessages>, TranslationKeysWithRequiredParams<TMessages>>;
+export type BtTranslateOptions<TLocale extends string = string> = Simplify<TranslateOptions<TLocale> & {
+    bt: true;
+}>;
 export type TranslateOptionsForKey<TLocale extends string, TMessages extends TranslationMessages, TKey extends string> = [TranslationPlaceholderNames<TMessages, TKey>] extends [never] ? Simplify<TranslateOptions<TLocale> & {
     params?: never;
 }> : string extends TranslationPlaceholderNames<TMessages, TKey> ? Simplify<TranslateOptions<TLocale> & {
@@ -64,7 +67,14 @@ export type TranslateOptionsForKey<TLocale extends string, TMessages extends Tra
 }>;
 export type TranslateArgs<TLocale extends string, TMessages extends TranslationMessages, TKey extends string> = [TranslationPlaceholderNames<TMessages, TKey>] extends [never] ? [options?: TranslateOptionsForKey<TLocale, TMessages, TKey>] : string extends TranslationPlaceholderNames<TMessages, TKey> ? [options?: TranslateOptionsForKey<TLocale, TMessages, TKey>] : [options: TranslateOptionsForKey<TLocale, TMessages, TKey>];
 export type TranslateCall<TLocale extends string, TMessages extends TranslationMessages, TKey extends TranslationKey<TMessages> = TranslationKey<TMessages>> = [key: TKey, ...args: TranslateArgs<TLocale, TMessages, TKey>];
-export type TranslateFunction<TLocale extends string, TMessages extends TranslationMessages> = <TKey extends TranslationKey<TMessages>>(...args: TranslateCall<TLocale, TMessages, TKey>) => string;
+export type BtTranslateCall<TLocale extends string = string> = [
+    value: string,
+    options: BtTranslateOptions<TLocale>
+];
+export type TranslateFunction<TLocale extends string, TMessages extends TranslationMessages> = {
+    <TKey extends TranslationKey<TMessages>>(...args: TranslateCall<TLocale, TMessages, TKey>): string;
+    (...args: BtTranslateCall<TLocale>): string;
+};
 export interface TranslationJsonStringSchema {
     type: "string";
 }
@@ -92,6 +102,13 @@ export interface TranslationConfig<TLocale extends string> {
  * Optional overrides for a single translation lookup.
  */
 export interface TranslateOptions<TLocale extends string> {
+    /**
+     * Marks this call for `bt extract`.
+     *
+     * When true, `t(...)` returns the provided string unchanged until the CLI
+     * rewrites it to a strict keyed call.
+     */
+    bt?: true;
     /**
      * Uses a specific locale for this call instead of the configured default locale.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-translate/core",
-  "version": "1.0.0",
+  "version": "2.1.0",
   "description": "Framework-agnostic translation configuration runtime for TypeScript projects.",
   "license": "MIT",
   "type": "module",
@@ -10,8 +10,12 @@
   "types": "./dist/index.d.ts",
   "typesVersions": {
     "*": {
-      "core": ["./dist/core.d.ts"],
-      "server": ["./dist/server.d.ts"]
+      "core": [
+        "./dist/core.d.ts"
+      ],
+      "server": [
+        "./dist/server.d.ts"
+      ]
     }
   },
   "exports": {
@@ -29,7 +33,11 @@
     },
     "./package.json": "./package.json"
   },
-  "files": ["dist", "LICENSE", "README.md"],
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsup src/index.ts src/core.ts src/server.ts --format esm --clean && bun x tsc --declaration --emitDeclarationOnly --module NodeNext --moduleResolution NodeNext --target ES2022 --outDir dist src/types.ts && cp src/core.d.ts src/index.d.ts src/server.d.ts dist/",
     "check-types": "tsc --noEmit",
@@ -51,5 +59,10 @@
   "devDependencies": {
     "@repo/typescript-config": "*"
   },
-  "keywords": ["i18n", "l10n", "translations", "typescript"]
+  "keywords": [
+    "i18n",
+    "l10n",
+    "translations",
+    "typescript"
+  ]
 }