@taon-dev/i18n 0.0.1

package/lib/internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals.js","sourceRoot":"","sources":[""],"names":[],"mappings":";;;AAAa,QAAA,0BAA0B,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAClE,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC"}

package/lib/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@taon-dev/i18n/lib",
+  "version": "0.0.1"
+}

package/lib/start-cli.d.ts

@@ -0,0 +1,7 @@
+/**
+ *
+ * @param argsv process.argsv
+ * @param filename needed if you want ipc communicaiton
+ */
+export declare function startCli(argsv: string[], filename: string): Promise<void>;
+export default startCli;

package/lib/start-cli.js

@@ -0,0 +1,46 @@
+"use strict";
+//#region tnp-helpers cli template
+// import { Helpers, BaseCommandLineFeature } from 'tnp-helpers/src';
+// import { BaseProject, BaseStartConfig } from 'tnp-helpers/src'; // @backend
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startCli = startCli;
+// class $Version extends BaseCommandLineFeature<{}> {
+//   public _() {
+//     console.log(`Hello world from cli`);
+//     this._exit();
+//   }
+// }
+//#endregion
+/**
+ *
+ * @param argsv process.argsv
+ * @param filename needed if you want ipc communicaiton
+ */
+async function startCli(argsv, filename) {
+    //#region @backendFunc
+    console.log('Hello from cli');
+    console.log({ argsv });
+    process.exit(0);
+    //#region start config
+    // new BaseStartConfig({
+    //   ProjectClass: BaseProject,
+    //   functionsOrClasses: [
+    //     {
+    //       classOrFnName: '$Version',
+    //       funcOrClass: $Version,
+    //     },
+    //   ],
+    //   argsv,
+    //   useStringArrForArgsFunctions: true,
+    //   shortArgsReplaceConfig: {
+    //     v: 'version',
+    //   },
+    //   callbackNotRecognizedCommand: async () => {
+    //     Helpers.error(`Command not recognized`, false, true);
+    //   },
+    // });
+    //#endregion
+    //#endregion
+}
+exports.default = startCli;
+//# sourceMappingURL=start-cli.js.map

package/lib/start-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-cli.js","sourceRoot":"","sources":[""],"names":[],"mappings":";AAAA,kCAAkC;AAClC,qEAAqE;AACrE,8EAA8E;;AAe9E,4BA0BC;AAvCD,sDAAsD;AACtD,iBAAiB;AACjB,2CAA2C;AAC3C,oBAAoB;AACpB,MAAM;AACN,IAAI;AACJ,YAAY;AAEZ;;;;GAIG;AACI,KAAK,UAAU,QAAQ,CAAC,KAAe,EAAE,QAAgB;IAC9D,sBAAsB;IACtB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhB,sBAAsB;IACtB,wBAAwB;IACxB,+BAA+B;IAC/B,0BAA0B;IAC1B,QAAQ;IACR,mCAAmC;IACnC,+BAA+B;IAC/B,SAAS;IACT,OAAO;IACP,WAAW;IACX,wCAAwC;IACxC,8BAA8B;IAC9B,oBAAoB;IACpB,OAAO;IACP,gDAAgD;IAChD,4DAA4D;IAC5D,OAAO;IACP,MAAM;IACN,YAAY;IACZ,YAAY;AACd,CAAC;AAED,kBAAe,QAAQ,CAAC"}

package/lib/transignal-config.d.ts

@@ -0,0 +1,34 @@
+import { InjectionToken } from '@angular/core';
+import { TransignalFeature } from './features/types';
+import { INTERNAL_TRANSIGNAL_CONFIG } from './internals';
+import { TransignalService } from './transignal-service';
+import { TransignalConfig } from './types';
+import { StringKeys } from './utility-types';
+/**
+ * Utility function to define a type of translations for type inference
+ */
+export declare const treeShakedTranslations: <Translations extends Record<string, Record<string, unknown>>>() => Translations;
+export declare const TRANSIGNAL_CONFIG: InjectionToken<unknown>;
+/**
+ * Use to inject transignal config
+ */
+export declare const injectTransignalConfig: <Languages extends string, Translations extends Record<string, Record<string, unknown>>>() => TransignalConfig<Languages, Translations>;
+/**
+ * Prepares type-safe transignal object
+ * @param config Transignal configruation {@link TransignalConfig}
+ * @param features Extra tree-shakeable features
+ * - {@link withPreloadScopes} - preloads selected scopes
+ * - {@link withServerSideLanguage} - sets language based on `document.lang` in SSR environment
+ * - {@link withNavigatorLanguage} - sets language based on `navigator.language` in browser environment
+ * - {@link withLanguageLocalStorageSync} - syncs language with localStorage
+ * - {@link withTranslatedTitle} - enables translation of page title
+ */
+export declare const prepareTransignal: <Languages extends string, Translations extends Record<string, Record<string, unknown>>>(config: TransignalConfig<Languages, Translations>, ...features: NoInfer<TransignalFeature<Languages, Translations>[]>) => {
+    [INTERNAL_TRANSIGNAL_CONFIG]: {
+        config: TransignalConfig<Languages, Translations>;
+        features: TransignalFeature<Languages, Translations>[];
+    };
+    provide: () => import("@angular/core", { with: { "resolution-mode": "import" } }).EnvironmentProviders;
+    service: () => TransignalService<Languages, Translations, StringKeys<Translations>>;
+    t: <Scope extends StringKeys<Translations>>(scope: Scope) => import("./types").TranslateObj<Translations[Scope]>;
+};

package/lib/transignal-config.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareTransignal = exports.injectTransignalConfig = exports.TRANSIGNAL_CONFIG = exports.treeShakedTranslations = void 0;
+const core_1 = require("@angular/core");
+const internals_1 = require("./internals");
+const transignal_service_1 = require("./transignal-service");
+/**
+ * Utility function to define a type of translations for type inference
+ */
+const treeShakedTranslations = () => internals_1.TREE_SHAKED_TRANSLATIONS;
+exports.treeShakedTranslations = treeShakedTranslations;
+exports.TRANSIGNAL_CONFIG = new core_1.InjectionToken('TRANSIGNAL_CONFIG');
+/**
+ * Use to inject transignal config
+ */
+const injectTransignalConfig = () => (0, core_1.inject)(exports.TRANSIGNAL_CONFIG);
+exports.injectTransignalConfig = injectTransignalConfig;
+/**
+ * Prepares type-safe transignal object
+ * @param config Transignal configruation {@link TransignalConfig}
+ * @param features Extra tree-shakeable features
+ * - {@link withPreloadScopes} - preloads selected scopes
+ * - {@link withServerSideLanguage} - sets language based on `document.lang` in SSR environment
+ * - {@link withNavigatorLanguage} - sets language based on `navigator.language` in browser environment
+ * - {@link withLanguageLocalStorageSync} - syncs language with localStorage
+ * - {@link withTranslatedTitle} - enables translation of page title
+ */
+const prepareTransignal = (config, ...features) => {
+    const service = () => (0, core_1.inject)(transignal_service_1.TransignalService);
+    return {
+        [internals_1.INTERNAL_TRANSIGNAL_CONFIG]: { config, features },
+        provide: () => (0, core_1.makeEnvironmentProviders)([
+            { provide: exports.TRANSIGNAL_CONFIG, useValue: config },
+            transignal_service_1.TransignalService,
+            features.map(feature => feature.providers),
+        ]),
+        service,
+        t: (scope) => service().t(scope),
+    };
+};
+exports.prepareTransignal = prepareTransignal;
+//# sourceMappingURL=transignal-config.js.map

package/lib/transignal-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transignal-config.js","sourceRoot":"","sources":[""],"names":[],"mappings":";;;AAAA,wCAAiF;AAGjF,2CAAmF;AACnF,6DAAyD;AAIzD;;GAEG;AACI,MAAM,sBAAsB,GAAG,GAElC,EAAE,CAAC,oCAAmD,CAAC;AAF9C,QAAA,sBAAsB,0BAEwB;AAE9C,QAAA,iBAAiB,GAAG,IAAI,qBAAc,CAAC,mBAAmB,CAAC,CAAC;AAEzE;;GAEG;AACI,MAAM,sBAAsB,GAAG,GAGlC,EAAE,CAAC,IAAA,aAAM,EAA4C,yBAAiB,CAAC,CAAC;AAH/D,QAAA,sBAAsB,0BAGyC;AAE5E;;;;;;;;;GASG;AACI,MAAM,iBAAiB,GAAG,CAI/B,MAAiD,EACjD,GAAG,QAA+D,EAClE,EAAE;IACF,MAAM,OAAO,GAAG,GAAG,EAAE,CACnB,IAAA,aAAM,EAAuE,sCAAiB,CAAC,CAAC;IAClG,OAAO;QACL,CAAC,sCAA0B,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;QAClD,OAAO,EAAE,GAAG,EAAE,CACZ,IAAA,+BAAwB,EAAC;YACvB,EAAE,OAAO,EAAE,yBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE;YAChD,sCAAiB;YACjB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;SAC3C,CAAC;QACJ,OAAO;QACP,CAAC,EAAE,CAAyC,KAAY,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;KAChF,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,iBAAiB,qBAoB5B"}

package/lib/transignal-param-handlers.d.ts

@@ -0,0 +1,11 @@
+import { TranslateParams } from './types';
+export type ParamHandler = (translation: string, params?: TranslateParams) => string;
+/**
+ * Param handler which allows for specification of basic params: `{name}`
+ *
+ * @param translation Translated text
+ * @param params      Params provided to translation function
+ */
+export declare const simpleParamsHandler: ParamHandler;
+export declare const noParamsHandler: ParamHandler;
+export declare const simpleParamValueStringify: (paramValue: unknown) => any;

package/lib/transignal-param-handlers.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.simpleParamValueStringify = exports.noParamsHandler = exports.simpleParamsHandler = void 0;
+/**
+ * Param handler which allows for specification of basic params: `{name}`
+ *
+ * @param translation Translated text
+ * @param params      Params provided to translation function
+ */
+const simpleParamsHandler = (translation, params) => {
+    if (!params)
+        return translation;
+    for (const [key, value] of Object.entries(params)) {
+        translation = translation.replaceAll(`{${key}}`, (0, exports.simpleParamValueStringify)(value));
+    }
+    return translation;
+};
+exports.simpleParamsHandler = simpleParamsHandler;
+const noParamsHandler = translation => translation;
+exports.noParamsHandler = noParamsHandler;
+const simpleParamValueStringify = (paramValue) => {
+    if (typeof paramValue === 'string') {
+        return paramValue;
+    }
+    if (paramValue == null) {
+        return '';
+    }
+    return paramValue.toString();
+};
+exports.simpleParamValueStringify = simpleParamValueStringify;
+//# sourceMappingURL=transignal-param-handlers.js.map

package/lib/transignal-param-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transignal-param-handlers.js","sourceRoot":"","sources":[""],"names":[],"mappings":";;;AAIA;;;;;GAKG;AACI,MAAM,mBAAmB,GAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,WAAW,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,EAAE,IAAA,iCAAyB,EAAC,KAAK,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B;AAEK,MAAM,eAAe,GAAiB,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC;AAA3D,QAAA,eAAe,mBAA4C;AAEjE,MAAM,yBAAyB,GAAG,CAAC,UAAmB,EAAE,EAAE;IAC/D,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAQ,UAAkB,CAAC,QAAQ,EAAE,CAAC;AACxC,CAAC,CAAC;AARW,QAAA,yBAAyB,6BAQpC"}

package/lib/transignal-service.d.ts

@@ -0,0 +1,32 @@
+import { TranslateObj, TranslateParams } from './types';
+import { StringKeys } from './utility-types';
+/**
+ * Main transignal service, used to process and cache translations
+ * Can be injected directly or with use of transignal object created with {@link prepareTransignal} function (recommended)
+ */
+export declare class TransignalService<Languages extends string, Translations extends Record<string, Record<string, any>>, Scopes extends StringKeys<Translations>> {
+    private readonly injector;
+    private readonly config;
+    private readonly paramsHandler;
+    private readonly loadingFn;
+    private readonly errorHandler;
+    private readonly loadingCount;
+    private readonly scopeMap;
+    private readonly languageMap;
+    /**
+     * Use to set or get active language
+     */
+    readonly activeLang: import("@angular/core", { with: { "resolution-mode": "import" } }).WritableSignal<Languages>;
+    /**
+     * Use to determine whether service is currently loading translation files
+     */
+    readonly isLoading: import("@angular/core", { with: { "resolution-mode": "import" } }).Signal<boolean>;
+    t<Scope extends Scopes>(scope: Scope): TranslateObj<Translations[Scope]>;
+    private initT;
+    private preparePrefixFn;
+    private preparePluralFn;
+    private prepareSelectFn;
+    protected replaceParams<T>(translation: T, params?: TranslateParams): T;
+    private fetchLanguage;
+    private resolveObjectPath;
+}

package/lib/transignal-service.js

@@ -0,0 +1,206 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransignalService = void 0;
+const core_1 = require("@angular/core");
+const internals_1 = require("./internals");
+const transignal_config_1 = require("./transignal-config");
+const transignal_param_handlers_1 = require("./transignal-param-handlers");
+/**
+ * Main transignal service, used to process and cache translations
+ * Can be injected directly or with use of transignal object created with {@link prepareTransignal} function (recommended)
+ */
+let TransignalService = class TransignalService {
+    injector = (0, core_1.inject)(core_1.EnvironmentInjector);
+    config = (0, transignal_config_1.injectTransignalConfig)();
+    paramsHandler = this.config.paramHandler ?? transignal_param_handlers_1.simpleParamsHandler;
+    loadingFn = this.config.loadingFn ?? (() => '...');
+    // eslint-disable-next-line no-console
+    errorHandler = this.config.errorHandler ?? console.error; // TODO maybe add a link to error page in docs
+    loadingCount = (0, core_1.signal)(0);
+    scopeMap = new Map();
+    languageMap = new Map();
+    /**
+     * Use to set or get active language
+     */
+    activeLang = (0, core_1.signal)(this.config.defaultLang);
+    /**
+     * Use to determine whether service is currently loading translation files
+     */
+    isLoading = (0, core_1.computed)(() => this.loadingCount() > 0);
+    t(scope) {
+        const existing = this.scopeMap.get(scope);
+        if (existing) {
+            return existing;
+        }
+        const scopeObj = this.initT(scope);
+        this.scopeMap.set(scope, scopeObj);
+        return scopeObj;
+    }
+    initT(scope) {
+        const cache = new Map();
+        const t = ((key, params) => {
+            const lang = this.activeLang();
+            const baseKey = `${lang}/${key}`;
+            const memoKey = params ? `${baseKey}_${JSON.stringify(params)}` : baseKey;
+            const alreadyComputed = cache.get(memoKey);
+            if (alreadyComputed) {
+                return alreadyComputed;
+            }
+            const { isLoading, error, value } = this.fetchLanguage(scope, lang);
+            if (isLoading()) {
+                return this.loadingFn?.(key);
+            }
+            if (error() || !value()) {
+                this.errorHandler('missing_file', error());
+                return '';
+            }
+            const result = this.replaceParams(this.resolveObjectPath(value(), key), params);
+            cache.set(memoKey, result);
+            return result;
+        }); // needed as other props are assigned below
+        t.arr = t;
+        t.obj = t;
+        t.prefix = this.preparePrefixFn(t, 1);
+        t.plural = this.preparePluralFn(t);
+        t.select = this.prepareSelectFn(t);
+        return t;
+    }
+    preparePrefixFn(t, depth) {
+        return (prefix) => {
+            const prefixedT = (key, params) => t(`${prefix}.${key}`, params);
+            prefixedT.arr = prefixedT;
+            prefixedT.obj = prefixedT;
+            prefixedT.plural = this.preparePluralFn(prefixedT);
+            prefixedT.select = this.prepareSelectFn(prefixedT);
+            prefixedT.prefix =
+                this.config.maxPrefixDepth || 3 >= depth
+                    ? this.preparePrefixFn(prefixedT, depth + 1)
+                    : () => {
+                        this.errorHandler('prefix_too_deep');
+                        const t = () => '';
+                        t.arr = () => [];
+                        t.obj = () => ({});
+                        t.plural = () => '';
+                        return t;
+                    };
+            return prefixedT;
+        };
+    }
+    preparePluralFn(t) {
+        return (key, count, params) => {
+            const plurals = t(key, { count, ...params });
+            if (typeof plurals === 'string') {
+                if (plurals === this.loadingFn(key)) {
+                    return plurals;
+                }
+                this.errorHandler('invalid_plural', key, plurals);
+                return plurals;
+            }
+            if (plurals[count]) {
+                return plurals[count];
+            }
+            const valueLastDigit = +count.toFixed(0).at(-1);
+            if (plurals.one && valueLastDigit === 1) {
+                return plurals.one;
+            }
+            if (plurals.many && valueLastDigit >= 5) {
+                return plurals.many;
+            }
+            if (plurals.few && valueLastDigit > 1 && valueLastDigit < 5) {
+                return plurals.few;
+            }
+            if (plurals.other) {
+                return plurals.other;
+            }
+            this.errorHandler('missing_plural', key, plurals, count);
+            return '';
+        };
+    }
+    prepareSelectFn(t) {
+        return (key, value, params) => {
+            const selects = t(key, { value, ...params });
+            if (typeof selects === 'string') {
+                if (selects === this.loadingFn(key)) {
+                    return selects;
+                }
+                this.errorHandler('invalid_select', key, selects);
+                return selects;
+            }
+            if (value !== null) {
+                if (selects[value]) {
+                    return selects[value];
+                }
+            }
+            else if (selects['null']) {
+                return selects['null'];
+            }
+            this.errorHandler('missing_select', key, selects, value);
+            return '';
+        };
+    }
+    replaceParams(translation, params) {
+        if (!translation)
+            return translation;
+        if (typeof translation === 'string') {
+            return this.paramsHandler(translation, params);
+        }
+        if (Array.isArray(translation)) {
+            return translation.map(val => this.replaceParams(val, params));
+        }
+        if (typeof translation === 'object') {
+            return Object.entries(translation).reduce((prev, [objKey, objVal]) => {
+                prev[objKey] = this.replaceParams(objVal, params);
+                return prev;
+            }, {});
+        }
+        return translation;
+    }
+    fetchLanguage(scope, lang) {
+        const cacheKey = `${scope}/${lang}`;
+        const existing = this.languageMap.get(cacheKey);
+        if (existing)
+            return existing;
+        const { translations, loader } = this.config;
+        const translation = (0, core_1.runInInjectionContext)(this.injector, () => translations === internals_1.TREE_SHAKED_TRANSLATIONS
+            ? (0, core_1.untracked)(() => (0, core_1.resource)({
+                loader: async () => {
+                    this.loadingCount.update(count => ++count);
+                    const file = await (0, core_1.runInInjectionContext)(this.injector, () => loader(scope, lang));
+                    this.loadingCount.update(count => --count);
+                    return file;
+                },
+            }))
+            : {
+                value: (0, core_1.signal)(translations[scope]),
+                isLoading: (0, core_1.signal)(false),
+                error: (0, core_1.signal)(undefined),
+            });
+        this.languageMap.set(cacheKey, translation);
+        return translation;
+    }
+    resolveObjectPath(obj, path) {
+        const keys = path.split('.');
+        let current = obj;
+        for (const key of keys) {
+            if (current && typeof current === 'object') {
+                current = current[key];
+            }
+            else {
+                this.errorHandler('missing_key', { obj, path });
+                return undefined;
+            }
+        }
+        return current;
+    }
+};
+exports.TransignalService = TransignalService;
+exports.TransignalService = TransignalService = __decorate([
+    (0, core_1.Injectable)()
+], TransignalService);
+//# sourceMappingURL=transignal-service.js.map

package/lib/transignal-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transignal-service.js","sourceRoot":"","sources":[""],"names":[],"mappings":"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"}

package/lib/transignal-testing.d.ts

@@ -0,0 +1,8 @@
+import { prepareTransignal } from './transignal-config';
+/**
+ * Provides unit-test version of transignal that loads translation instantly without loading
+ *
+ * @param transignal   existing transignal instance
+ * @param translations real translations in a selected language
+ */
+export declare const provideTransignalTesting: <Languages extends string, Translations extends Record<string, Record<string, unknown>>>(transignal: ReturnType<typeof prepareTransignal<Languages, Translations>>, translations: Translations) => import("@angular/core", { with: { "resolution-mode": "import" } }).EnvironmentProviders;

package/lib/transignal-testing.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provideTransignalTesting = void 0;
+const internals_1 = require("./internals");
+const transignal_config_1 = require("./transignal-config");
+/**
+ * Provides unit-test version of transignal that loads translation instantly without loading
+ *
+ * @param transignal   existing transignal instance
+ * @param translations real translations in a selected language
+ */
+const provideTransignalTesting = (transignal, translations) => (0, transignal_config_1.prepareTransignal)({ ...transignal[internals_1.INTERNAL_TRANSIGNAL_CONFIG].config, translations }, ...transignal[internals_1.INTERNAL_TRANSIGNAL_CONFIG].features).provide();
+exports.provideTransignalTesting = provideTransignalTesting;
+//# sourceMappingURL=transignal-testing.js.map

package/lib/transignal-testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transignal-testing.js","sourceRoot":"","sources":[""],"names":[],"mappings":";;;AAAA,2CAAyD;AACzD,2DAAwD;AAExD;;;;;GAKG;AACI,MAAM,wBAAwB,GAAG,CAItC,UAAyE,EACzE,YAA0B,EAC1B,EAAE,CACF,IAAA,qCAAiB,EACf,EAAE,GAAG,UAAU,CAAC,sCAA0B,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,EAClE,GAAG,UAAU,CAAC,sCAA0B,CAAC,CAAC,QAAQ,CACnD,CAAC,OAAO,EAAE,CAAC;AAVD,QAAA,wBAAwB,4BAUvB"}

package/lib/types.d.ts

@@ -0,0 +1,124 @@
+import { ParamHandler } from './transignal-param-handlers';
+import { ArrayPaths, GetNestedType, ObjectPaths, PluralPaths, SelectPaths, StringKeys, StringPaths } from './utility-types';
+export type TransignalError = 
+/** Error when key is not found in translations */
+'missing_key'
+/** Error when translation file for scope and lang has not been found */
+ | 'missing_file'
+/** Error plural for a value is not defined for a language */
+ | 'missing_plural'
+/** Error when plural used on a non-plural translation */
+ | 'invalid_plural'
+/** Error select for a value is not defined for a language */
+ | 'missing_select'
+/** Error when select used on a non-select translation */
+ | 'invalid_select'
+/** Error when prefix chain is called more then {@link TransignalConfig.maxPrefixDepth} */
+ | 'prefix_too_deep';
+export type TranslateParams = Record<string, unknown>;
+export type Marked<K, T> = K & {
+    __marker: T;
+};
+export type BasePluralTranslation = Partial<Record<number | 'one' | 'few' | 'many' | 'other', string>>;
+export type PluralTranslation = Marked<BasePluralTranslation, 'plural'>;
+export type BaseSelectTranslation = Partial<Record<string | number | 'null', string>>;
+export type MarkedAsSelect<T extends BaseSelectTranslation> = Marked<T, 'select'>;
+export type SelectTranslation = MarkedAsSelect<BaseSelectTranslation>;
+export type TranslateFn<Keys extends string, Result> = (key: Keys, params?: TranslateParams) => Result;
+export type TranslateObj<Context extends Record<string, any>> = TranslateFn<StringPaths<Context>, string> & {
+    /**
+     * Returns translating function that returns an array of translations
+     * @param key path of translation
+     * @param params parameters of translation in syntax defined by {@link TransignalConfig.paramHandler}
+     */
+    arr: <ArrKey extends ArrayPaths<Context>>(key: ArrKey, params?: TranslateParams) => GetNestedType<Context, ArrKey>;
+    /**
+     * Returns translating function that returns an object of translations
+     * @param key path of translation
+     * @param params parameters of translation in syntax defined by {@link TransignalConfig.paramHandler}
+     */
+    obj: <ObjKey extends ObjectPaths<Context>>(key: ObjKey, params?: TranslateParams) => GetNestedType<Context, ObjKey>;
+    /**
+     * Returns translating function that returns a string translation depending on a correct plural form
+     * @param key path of translation
+     * @param count count to determine correct plural form
+     * @param params parameters of translation in syntax defined by {@link TransignalConfig.paramHandler}
+     */
+    plural: <ObjKey extends PluralPaths<Context>>(key: ObjKey, count: number, params?: TranslateParams) => string;
+    /**
+     * Returns translating function that returns a string translation depending on a selected value
+     * @param key path of translation
+     * @param value value to determine selected translation
+     * @param params parameters of translation in syntax defined by {@link TransignalConfig.paramHandler}
+     */
+    select: <ObjKey extends SelectPaths<Context>>(key: ObjKey, value: keyof SelectTranslation | null, params?: TranslateParams) => string;
+    /**
+     * Returns translating function that is encapsulated in a selected prefix
+     * @param prefix path of new root translation
+     */
+    prefix: <T extends ObjectPaths<Context>>(prefix: T) => TranslateObj<GetNestedType<Context, T>>;
+};
+export type TranslationFile = Record<string, unknown>;
+export type TransignalConfig<Languages extends string, Translations extends Record<string, Record<string, unknown>>> = {
+    /**
+     * Default language code
+     */
+    defaultLang: NoInfer<Languages>;
+    /**
+     * An array of available languages that your application supports.
+     * These should be unique string identifiers for each language (e.g., ['en', 'fr', 'es']).
+     */
+    availableLangs: Languages[];
+    /**
+     * Defines the type of translations.
+     * Please use helper function {@link treeShakedTranslations()}
+     * @example
+     * ```typescript
+     * import type translations from './i18n/translations';
+     * ...
+     * translations: treeShakedTranslations<typeof translations>(),
+     * ```
+     */
+    translations: Translations;
+    /**
+     * A function responsible for dynamically loading translation files.
+     * This function is called when a specific translation scope and language is requested
+     * It runs in TransignalService injection context so {@link inject()} can be used to e.g. use HttpClient
+     *
+     * @param scope The string key representing the translation scope (e.g., 'common', 'auth').
+     * @param lang The language identifier for which to load translations (e.g., 'en', 'fr').
+     * @returns A Promise that resolves to a `TranslationFile` object, which is
+     * a record of string keys to unknown values representing the translations for
+     * the given scope and language.
+     */
+    loader: (scope: StringKeys<Translations>, lang: Languages) => Promise<TranslationFile>;
+    /**
+     * An optional function that defines how a loading message should be displayed
+     * while translations are being loaded.
+     *
+     * @param key The translation key that is currently being loaded.
+     * @returns A string representing the loading message.
+     */
+    loadingFn?: (key: string) => string;
+    /**
+     * An optional function that defines how params should be processed
+     * Defaults to {@link simpleParamsHandler}
+     * Use {@link noParamsHandler} if you don't want to use params
+     * If you want to handle message format then you can install TODO
+     */
+    paramHandler?: ParamHandler;
+    /**
+     * An optional error handler function that will be called when a `TransignalError` occurs.
+     * This allows you to implement custom error reporting or logging.
+     *
+     * @param errorCode Code of an error {@link TransignalError} code that occurred.
+     * @param args Any additional arguments relevant to the error.
+     */
+    errorHandler?: (errorCode: TransignalError, ...args: unknown[]) => void;
+    /**
+     * Defines max depth of prefix functions in {@link TranslateObj}
+     * Defaults to 3, this means that if prefix function is used more than 3 time on the same t then it will fail
+     * Required for performance reasons
+     */
+    maxPrefixDepth?: number;
+};

package/lib/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":[""],"names":[],"mappings":""}

package/lib/utility-types.d.ts

@@ -0,0 +1,29 @@
+import { Signal } from '@angular/core';
+import { PluralTranslation, SelectTranslation } from './types';
+export type GetNestedType<T, P extends string> = P extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? GetNestedType<T[Key], Rest> : never : P extends keyof T ? NonNullable<T[P]> : never;
+type DotPrefix<T extends string> = T extends '' ? '' : `.${T}`;
+export type Paths<T> = T extends object ? T extends Array<infer U> ? `${number}${'' | DotPrefix<Paths<U>>}` : {
+    [K in keyof T]-?: K extends string | number ? `${K}${'' | DotPrefix<Paths<T[K]>>}` : never;
+}[keyof T] : '';
+export type ArrayPaths<T> = {
+    [P in Paths<T>]: GetNestedType<T, P> extends Array<unknown> ? P : never;
+}[Paths<T>];
+export type ObjectPaths<T> = {
+    [P in Paths<T>]: GetNestedType<T, P> extends Record<any, unknown> ? P : never;
+}[Paths<T>];
+export type PluralPaths<T> = {
+    [P in Paths<T>]: GetNestedType<T, P> extends PluralTranslation ? P : never;
+}[Paths<T>];
+export type SelectPaths<T> = {
+    [P in Paths<T>]: GetNestedType<T, P> extends SelectTranslation ? P : never;
+}[Paths<T>];
+export type StringPaths<T> = {
+    [P in Paths<T>]: GetNestedType<T, P> extends string ? P : never;
+}[Paths<T>];
+export type StringKeys<T> = Extract<keyof T, string>;
+export type ResourceRefLike<T> = {
+    value: Signal<T | undefined>;
+    isLoading: Signal<boolean>;
+    error: Signal<Error | undefined>;
+};
+export {};

package/lib/utility-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=utility-types.js.map