typed-locales 1.0.2 → 1.0.3

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import baseFormatters from './formatters';
-import type { Formatter } from './formatters';
+import baseFormatters from './src/formatters';
+import type { Formatter } from './src/formatters';
 type ValueType = null | number | string | undefined | object;
 export type BaseFormatters = keyof typeof baseFormatters;
 export type InternalDeepStringify<T> = {
@@ -42,4 +42,4 @@ type DeepOmitNever<T> = {
 } extends infer U ? keyof U extends never ? never : U : never;
 export type Simplify<T> = InternalSimplify<DeepOmitNever<T>>;
 export declare const getTranslate: <Translations, ExtraFormattersType extends string = string, ExtraFormatters extends Record<ExtraFormattersType, Formatter> = Record<ExtraFormattersType, Formatter>>(translations: Translations, locale: string, extraFormatters?: ExtraFormatters) => <Key extends DotNestedLeafKeys<Translations>>(key: Key, ...arguments_: InterpolationProperties<GetValue<Translations, Key> & string, IsPlural<Translations, Key>> extends Record<string, never> ? [] : [params: Simplify<InterpolationProperties<GetValue<Translations, Key> & string, IsPlural<Translations, Key>>>]) => GetValue<Translations, Key>;
-export {};
+export { initReact } from './src/react';

package/dist/index.js

@@ -1,4 +1,4 @@
-import baseFormatters from './formatters';
+import baseFormatters from './src/formatters';
 // Given a translations object returns a function that can be used to translate keys
 export const getTranslate = (translations, locale, extraFormatters) => {
     const formatters = { ...baseFormatters, ...extraFormatters };
@@ -80,3 +80,4 @@ export const getTranslate = (translations, locale, extraFormatters) => {
     }
     return translate;
 };
+export { initReact } from './src/react';

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "typed-locales",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Type safe utilities for translating strings",
-  "main": "index.js",
+  "main": "dist/index.js",
   "type": "module",
   "scripts": {
-    "build": "tsc",
+    "build": "rimraf dist && tsc",
     "dev": "tsx watch src/test.tsx"
   },
   "keywords": [],
@@ -15,6 +15,7 @@
   "dependencies": {
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "rimraf": "^6.0.1",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3"
   },

package/dist/config.js

@@ -1,9 +0,0 @@
-import { initReact } from './react';
-import en from './translations/en';
-const customFormatters = {
-    myCustomFormatter: () => 'Hello im custom',
-};
-export const { useTranslation, TranslationProvider } = initReact({
-    en,
-    es: () => import('./translations/es').then(m => m.default),
-}, 'en', customFormatters);

package/dist/formatters.d.ts

@@ -1,11 +0,0 @@
-export type Formatter = (value: string, locale: string) => string;
-declare const formatters: {
-    readonly lowercase: (value: string) => string;
-    readonly uppercase: (value: string) => string;
-    readonly capitalize: (value: string) => string;
-    readonly void: () => string;
-    readonly weekday: (value: string) => string;
-    readonly number: (value: string) => string;
-    readonly json: (value: string) => string;
-};
-export default formatters;

package/dist/formatters.js

@@ -1,10 +0,0 @@
-const formatters = {
-    lowercase: (value) => value.toLowerCase(),
-    uppercase: (value) => value.toUpperCase(),
-    capitalize: (value) => value.charAt(0).toUpperCase() + value.slice(1),
-    void: () => '',
-    weekday: (value) => new Date(value).toLocaleDateString('en-US', { weekday: 'long' }),
-    number: (value) => value.toLocaleString(),
-    json: (value) => JSON.stringify(value),
-};
-export default formatters;

package/dist/react.js

@@ -1,53 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useContext, useState } from 'react';
-import { getTranslate } from './index';
-// Initial translation always should be loaded
-export const initReact = (translations, initialLocale, extraFormatters) => {
-    const TranslationContext = createContext(undefined);
-    const TranslationProvider = ({ children }) => {
-        const [locale, setLocale] = useState(initialLocale);
-        const [translate, setTranslate] = useState(() => getTranslate(translations[locale], locale, extraFormatters));
-        const [isLoading, setIsLoading] = useState(true);
-        const loadTranslation = async (targetLocale) => {
-            try {
-                const translationOrLoader = translations[targetLocale];
-                let translationData;
-                if (typeof translationOrLoader === 'function') {
-                    setIsLoading(true);
-                    translationData = await translationOrLoader();
-                }
-                else {
-                    translationData = translationOrLoader;
-                }
-                setTranslate(getTranslate(translationData, targetLocale, extraFormatters));
-            }
-            catch (error) {
-                console.error(`Failed to load translations for locale ${String(targetLocale)}:`, error);
-            }
-            finally {
-                setIsLoading(false);
-            }
-        };
-        return (_jsx(TranslationContext.Provider, { value: {
-                isLoading,
-                locale,
-                setLocale: async (newLocale) => {
-                    if (newLocale !== locale) {
-                        setLocale(newLocale);
-                        await loadTranslation(newLocale);
-                    }
-                },
-                t: translate,
-            }, children: children }));
-    };
-    const useTranslation = () => {
-        const context = useContext(TranslationContext);
-        if (!context)
-            throw new Error('useTranslation must be used within a TranslationProvider');
-        return context;
-    };
-    return {
-        TranslationProvider,
-        useTranslation
-    };
-};

package/dist/test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test.js

@@ -1,6 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useTranslation } from './config';
-const Test = () => {
-    const { t, locale, setLocale } = useTranslation();
-    return _jsxs("div", { children: [t('test'), t('nested.test', { translation: 'translated text' }), t('nested.deep.again', { value: 'someValue', otherValue: 'anotherValue' }), t('withValue', { value: 'myValue' }), t('multipleValues', { one: '1', two: '2', three: '3' }), t('examplePlural', { count: 0 }), t('examplePlural', { count: 1 }), t('examplePlural', { count: 5 }), t('examplePluralWithOtherValues', { count: 0, user: 'Alice', otherUser: undefined }), t('examplePluralWithOtherValues', { count: 1, user: 'Alice', otherUser: undefined }), t('examplePluralWithOtherValues', { count: 123, user: 'Alice', otherUser: 'Bob' }), t('exampleWithFormatting', { value: 'TEXT', other: 'Text' }), t('exampleWithJSONFormatter', { data: { key: 'value' } }), t('pluralWithNestedSubstitution', { count: 0, query: 'search', user: undefined }), t('pluralWithNestedSubstitution', { count: 1, query: 'search', user: 'john' }), t('pluralWithNestedSubstitution', { count: 5, query: 'search', user: 'john' }), t('mixedPluralNested', { count: 0, itemType: 'book', location: 'shelf' }), t('mixedPluralNested', { count: 1, itemType: 'book', location: 'shelf' }), t('mixedPluralNested', { count: 10, itemType: 'book', location: 'shelf' }), t('onlyFormat', { value: 'capitalize this' }), t('escapeBraces'), locale, _jsx("button", { onClick: () => setLocale('es'), children: "Change locale" })] });
-};

package/dist/translations/en.d.ts

@@ -1,28 +0,0 @@
-declare const en: {
-    readonly test: "Regular translation";
-    readonly nested: {
-        readonly test: "Nested {translation|myCustomFormatter}";
-        readonly deep: {
-            readonly again: "Nested again with {value} and {otherValue}";
-        };
-    };
-    readonly withValue: "With value {value}";
-    readonly multipleValues: "Multiple values: {one}, {two}, and {three}";
-    readonly examplePlural_none: "No items available";
-    readonly examplePlural_one: "One item available";
-    readonly examplePlural_other: "{count} items available";
-    readonly examplePluralWithOtherValues_none: "No items for {user}";
-    readonly examplePluralWithOtherValues_one: "One item for {user}";
-    readonly examplePluralWithOtherValues_other: "{count} items for {user} and {otherUser}";
-    readonly exampleWithFormatting: "Formatted {value|uppercase} text and {other|lowercase}";
-    readonly exampleWithJSONFormatter: "JSON formatter: {data|json}";
-    readonly pluralWithNestedSubstitution_none: "No results found for {query}";
-    readonly pluralWithNestedSubstitution_one: "One result for {query} with {user|capitalize}";
-    readonly pluralWithNestedSubstitution_other: "{count} results for {query} by {user|capitalize}";
-    readonly mixedPluralNested_none: "No {itemType} in {location}";
-    readonly mixedPluralNested_one: "One {itemType} in {location|uppercase}";
-    readonly mixedPluralNested_other: "{count} {itemType}s in {location|uppercase}";
-    readonly onlyFormat: "Just formatting: {value|capitalize}";
-    readonly escapeBraces: "Braces like this: \\{notAKey\\}";
-};
-export default en;

package/dist/translations/en.js

@@ -1,28 +0,0 @@
-const en = {
-    test: 'Regular translation',
-    nested: {
-        test: 'Nested {translation|myCustomFormatter}',
-        deep: {
-            again: 'Nested again with {value} and {otherValue}',
-        },
-    },
-    withValue: 'With value {value}',
-    multipleValues: 'Multiple values: {one}, {two}, and {three}',
-    examplePlural_none: 'No items available',
-    examplePlural_one: 'One item available',
-    examplePlural_other: '{count} items available',
-    examplePluralWithOtherValues_none: 'No items for {user}',
-    examplePluralWithOtherValues_one: 'One item for {user}',
-    examplePluralWithOtherValues_other: '{count} items for {user} and {otherUser}',
-    exampleWithFormatting: 'Formatted {value|uppercase} text and {other|lowercase}',
-    exampleWithJSONFormatter: 'JSON formatter: {data|json}',
-    pluralWithNestedSubstitution_none: 'No results found for {query}',
-    pluralWithNestedSubstitution_one: 'One result for {query} with {user|capitalize}',
-    pluralWithNestedSubstitution_other: '{count} results for {query} by {user|capitalize}',
-    mixedPluralNested_none: 'No {itemType} in {location}',
-    mixedPluralNested_one: 'One {itemType} in {location|uppercase}',
-    mixedPluralNested_other: '{count} {itemType}s in {location|uppercase}',
-    onlyFormat: 'Just formatting: {value|capitalize}',
-    escapeBraces: 'Braces like this: \\{notAKey\\}',
-};
-export default en;

package/dist/translations/es.d.ts

@@ -1,28 +0,0 @@
-declare const es: {
-    readonly test: "Traducción regular";
-    readonly nested: {
-        readonly test: "Anidado {translation|myCustomFormatter}";
-        readonly deep: {
-            readonly again: "Anidado nuevamente con {value} y {otherValue}";
-        };
-    };
-    readonly withValue: "Con valor {value}";
-    readonly multipleValues: "Múltiples valores: {one}, {two} y {three}";
-    readonly examplePlural_none: "No hay elementos disponibles";
-    readonly examplePlural_one: "Un elemento disponible";
-    readonly examplePlural_other: "{count} elementos disponibles";
-    readonly examplePluralWithOtherValues_none: "No hay elementos para {user}";
-    readonly examplePluralWithOtherValues_one: "Un elemento para {user}";
-    readonly examplePluralWithOtherValues_other: "{count} elementos para {user} y {otherUser}";
-    readonly exampleWithFormatting: "Texto formateado {value|uppercase} y {other|lowercase}";
-    readonly exampleWithJSONFormatter: "Formateador JSON: {data|json}";
-    readonly pluralWithNestedSubstitution_none: "No se encontraron resultados para {query}";
-    readonly pluralWithNestedSubstitution_one: "Un resultado para {query} con {user|capitalize}";
-    readonly pluralWithNestedSubstitution_other: "{count} resultados para {query} por {user|capitalize}";
-    readonly mixedPluralNested_none: "No hay {itemType} en {location}";
-    readonly mixedPluralNested_one: "Un {itemType} en {location|uppercase}";
-    readonly mixedPluralNested_other: "{count} {itemType}s en {location|uppercase}";
-    readonly onlyFormat: "Solo formateo: {value|capitalize}";
-    readonly escapeBraces: "Llaves como estas: \\{notAKey\\}";
-};
-export default es;

package/dist/translations/es.js

@@ -1,30 +0,0 @@
-const es = {
-    test: 'Traducción regular',
-    nested: {
-        test: 'Anidado {translation|myCustomFormatter}',
-        deep: {
-            again: 'Anidado nuevamente con {value} y {otherValue}',
-        },
-    },
-    withValue: 'Con valor {value}',
-    multipleValues: 'Múltiples valores: {one}, {two} y {three}',
-    // @ts-expect-error
-    examplePlural_none: 'No hay elementos disponibles',
-    // @ts-expect-error
-    examplePlural_one: 'Un elemento disponible',
-    examplePlural_other: '{count} elementos disponibles',
-    examplePluralWithOtherValues_none: 'No hay elementos para {user}',
-    examplePluralWithOtherValues_one: 'Un elemento para {user}',
-    examplePluralWithOtherValues_other: '{count} elementos para {user} y {otherUser}',
-    exampleWithFormatting: 'Texto formateado {value|uppercase} y {other|lowercase}',
-    exampleWithJSONFormatter: 'Formateador JSON: {data|json}',
-    pluralWithNestedSubstitution_none: 'No se encontraron resultados para {query}',
-    pluralWithNestedSubstitution_one: 'Un resultado para {query} con {user|capitalize}',
-    pluralWithNestedSubstitution_other: '{count} resultados para {query} por {user|capitalize}',
-    mixedPluralNested_none: 'No hay {itemType} en {location}',
-    mixedPluralNested_one: 'Un {itemType} en {location|uppercase}',
-    mixedPluralNested_other: '{count} {itemType}s en {location|uppercase}',
-    onlyFormat: 'Solo formateo: {value|capitalize}',
-    escapeBraces: 'Llaves como estas: \\{notAKey\\}',
-};
-export default es;

package/dist/tsconfig.tsbuildinfo

@@ -1 +0,0 @@
-{"root":["../src/formatters.ts","../src/index.ts","../src/react.tsx","../src/test.tsx","../src/translations/en.ts","../src/translations/es.ts"],"errors":true,"version":"5.8.2"}

package/dist/validation.d.ts

@@ -1,13 +0,0 @@
-import type { BaseFormatters, RemoveReadonlyDeep } from ".";
-type ErrorMessage<Value extends string, T extends string> = `You are using an invalid formatter: ${T} in: "${Value}"`;
-type ExtractFormatter<T extends string> = T extends `${string}{${string}|${infer F}}${string}` ? F : never;
-type CountOpenBraces<T extends string, Count extends readonly unknown[] = []> = T extends `${infer First}${infer Rest}` ? First extends '{' ? CountOpenBraces<Rest, [...Count, unknown]> : CountOpenBraces<Rest, Count> : Count['length'];
-type CountCloseBraces<T extends string, Count extends readonly unknown[] = []> = T extends `${infer First}${infer Rest}` ? First extends '}' ? CountCloseBraces<Rest, [...Count, unknown]> : CountCloseBraces<Rest, Count> : Count['length'];
-type BalancedBraces<T extends string> = CountOpenBraces<T> extends CountCloseBraces<T> ? never : `Brackets are not balanced in: "${T}"`;
-type ValidateFormatter<T extends string, Formatters extends string> = ExtractFormatter<T> extends never ? BalancedBraces<T> : ExtractFormatter<T> extends Formatters ? BalancedBraces<T> : ErrorMessage<T, ExtractFormatter<T>>;
-type InternalValidateTranslation<T, Formatters extends string, KeyPath extends string = ''> = T extends Record<string, any> ? {
-    [K in keyof T]: InternalValidateTranslation<T[K], Formatters, KeyPath extends '' ? K & string : `${KeyPath}.${K & string}`>;
-} : T extends string ? ValidateFormatter<T, Formatters> : T;
-export type ValidateTranslation<T, Formatters extends string> = RemoveReadonlyDeep<InternalValidateTranslation<T, BaseFormatters | Formatters>>;
-export type EnsureValidTranslation<T extends never> = T;
-export {};

package/dist/validation.js

@@ -1 +0,0 @@
-export {};