kotori 3.0.4 → 3.1.0

package/README.md

@@ -5,7 +5,7 @@
 Strongly-typed, modular i18n for React. Variables are inferred directly from your strings — no codegen, no JSON, no schema files.
 
 ```ts
-const { dict } = kotori({
+const { dict, t } = kotori({
     primaryLanguageTag: 'en',
     secondaryLanguageTags: ['zh', 'ja', 'ms'],
 })
@@ -26,16 +26,16 @@ const intro = dict({
 
 
 // ✅ Works
-t('intro', { name: 'John', time: '12:25' }) 
+t(intro, { name: 'John', time: '12:25' }) 
 
 // ❌ TypeScript error: missing { name }
-t('intro', { time: '12:25' })
+t(intro, { time: '12:25' })
 
 // ❌ TypeScript error: unknown key 'nama'                   
-t('intro', { nama: 'John', time: '12:25' }) 
+t(intro, { nama: 'John', time: '12:25' }) 
 
 // ❌ TypeScript error: invalid format for 'time'
-t('intro', { name: 'John', time: '12-00' }) 
+t(intro, { name: 'John', time: '12-00' }) 
 ```
 
 - No codegen
@@ -180,7 +180,7 @@ export const { useT, dict, setLanguage } = kotori({
 | `primaryLanguageTag` | `BCP47LanguageTag` | The source language. Drives variable inference. |
 | `secondaryLanguageTags` | `BCP47LanguageTag[]` | Additional supported languages. |
 
-Returns `{ dict, useT, setLanguage }`.
+Returns `{ dict, useT, setLanguage, t }`.
 
 ### `dict(translations)<argsType?>`
 
@@ -203,6 +203,10 @@ const time = dict({ en: '{{hour}}:{{minute}}' })<{
 
 Updates the current language and rerenders all active `useT` consumers across all pages. Available directly on the `kotori` instance — useful for calling outside of React (route guards, axios interceptors, etc.).
 
+### `t(dict, args?)` 
+
+Returns the translated string for the current language. `args` is required if the string has variables, omitted if it doesn't. Available directly on the `kotori` instance for non-React usage, but typically accessed via the `useT` hook.
+
 ### `useT()`
 
 React hook. Returns `{ t, language, setLanguage }`.
@@ -224,6 +228,7 @@ kotori uses [BCP 47](https://www.iana.org/assignments/language-subtag-registry/l
 - Pluralization support
 - Gender support
 - Value formatting (date, number, currency)
+- Support for non-React frameworks (Vue, Svelte, Angular, etc.)
 
 ## Trivial
 

package/dist/index.cjs

@@ -20,17 +20,19 @@ const kotori = (props) => {
 			listeners.delete(listener);
 		};
 	};
+	const t = (dict, ...args) => {
+		let locale = dict().translation[language] || "unable_to_load_translations";
+		for (const objKey in args[0]) locale = locale.replace(new RegExp(`\\{\\{\\s*${objKey}\\s*\\}\\}`, "g"), () => String(args[0]?.[objKey]));
+		return locale;
+	};
 	let snapshot = {
 		language,
 		setLanguage,
-		t: (dict, ...args) => {
-			let locale = dict().translation[language] || "unable_to_load_translations";
-			for (const objKey in args[0]) locale = locale.replace(new RegExp(`\\{\\{\\s*${objKey}\\s*\\}\\}`, "g"), () => String(args[0]?.[objKey]));
-			return locale;
-		}
+		t
 	};
 	return {
 		setLanguage,
+		t,
 		dict: (translation) => () => ({ translation }),
 		useT: () => (0, react.useSyncExternalStore)(subscribe, () => snapshot, () => snapshot)
 	};

package/dist/index.d.cts

@@ -13,6 +13,10 @@ declare const kotori: <const PrimaryTag extends AllTags, const SecondaryTags ext
   secondaryLanguageTags: SecondaryTags[];
 }) => {
   setLanguage: (tag: PrimaryTag | SecondaryTags) => void;
+  t: <DictCallback extends () => Readonly<{
+    translation: Record<PrimaryTag | SecondaryTags, string>;
+    [_args]?: Record<string, string | number>;
+  }>>(dict: DictCallback, ...args: keyof NonNullable<ReturnType<DictCallback>[typeof _args]> extends never ? [] : [NonNullable<ReturnType<DictCallback>[typeof _args]>]) => string;
   dict: <const PrimaryString extends string, const SecondaryObject extends { [Key in SecondaryTags]: ExtractVariables<PrimaryString> extends infer PrimaryVariables ? ExtractVariables<SecondaryObject[Key] & string> extends infer SecondaryVariables ? PrimaryVariables[] extends SecondaryVariables[] ? SecondaryVariables[] extends PrimaryVariables[] ? SecondaryObject[Key] : "variables not match!" : "variables not match!!" : never : never }>(translation: { [Key in PrimaryTag]: PrimaryString } & SecondaryObject) => <const ArgsType extends Record<ExtractVariables<PrimaryString>, string | number> = Record<ExtractVariables<PrimaryString>, string | number>>() => Readonly<{
     translation: typeof translation;
     [_args]?: ArgsType;

package/dist/index.d.mts

@@ -13,6 +13,10 @@ declare const kotori: <const PrimaryTag extends AllTags, const SecondaryTags ext
   secondaryLanguageTags: SecondaryTags[];
 }) => {
   setLanguage: (tag: PrimaryTag | SecondaryTags) => void;
+  t: <DictCallback extends () => Readonly<{
+    translation: Record<PrimaryTag | SecondaryTags, string>;
+    [_args]?: Record<string, string | number>;
+  }>>(dict: DictCallback, ...args: keyof NonNullable<ReturnType<DictCallback>[typeof _args]> extends never ? [] : [NonNullable<ReturnType<DictCallback>[typeof _args]>]) => string;
   dict: <const PrimaryString extends string, const SecondaryObject extends { [Key in SecondaryTags]: ExtractVariables<PrimaryString> extends infer PrimaryVariables ? ExtractVariables<SecondaryObject[Key] & string> extends infer SecondaryVariables ? PrimaryVariables[] extends SecondaryVariables[] ? SecondaryVariables[] extends PrimaryVariables[] ? SecondaryObject[Key] : "variables not match!" : "variables not match!!" : never : never }>(translation: { [Key in PrimaryTag]: PrimaryString } & SecondaryObject) => <const ArgsType extends Record<ExtractVariables<PrimaryString>, string | number> = Record<ExtractVariables<PrimaryString>, string | number>>() => Readonly<{
     translation: typeof translation;
     [_args]?: ArgsType;

package/dist/index.mjs

@@ -19,17 +19,19 @@ const kotori = (props) => {
 			listeners.delete(listener);
 		};
 	};
+	const t = (dict, ...args) => {
+		let locale = dict().translation[language] || "unable_to_load_translations";
+		for (const objKey in args[0]) locale = locale.replace(new RegExp(`\\{\\{\\s*${objKey}\\s*\\}\\}`, "g"), () => String(args[0]?.[objKey]));
+		return locale;
+	};
 	let snapshot = {
 		language,
 		setLanguage,
-		t: (dict, ...args) => {
-			let locale = dict().translation[language] || "unable_to_load_translations";
-			for (const objKey in args[0]) locale = locale.replace(new RegExp(`\\{\\{\\s*${objKey}\\s*\\}\\}`, "g"), () => String(args[0]?.[objKey]));
-			return locale;
-		}
+		t
 	};
 	return {
 		setLanguage,
+		t,
 		dict: (translation) => () => ({ translation }),
 		useT: () => useSyncExternalStore(subscribe, () => snapshot, () => snapshot)
 	};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "kotori",
 	"description": "Strongly-typed and composable internationalization library for React",
-	"version": "3.0.4",
+	"version": "3.1.0",
 	"scripts": {
 		"setup": "rm -rf node_modules && npm i && git init && husky",
 		"prepublishOnly": "npm i && npx tsc && npm run build",