adnbn 0.10.0 → 0.12.0

package/dist/entry/relay/TransportBuilder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/entry/relay/TransportBuilder.ts"],"sourcesContent":["import AbstractBuilder from \"@entry/transport/AbstractBuilder\";\n\nimport {RegisterRelay} from \"@relay/providers\";\n\nimport {RelayOptions, RelayUnresolvedDefinition, RelayMethod} from \"@typing/relay\";\nimport {TransportName, TransportType} from \"@typing/transport\";\n\nexport default class<T extends TransportType = TransportType> extends AbstractBuilder<RelayOptions, T> {\n    protected readonly method: RelayMethod;\n\n    constructor(definition: RelayUnresolvedDefinition<T>) {\n        const {main, method, ...options} = definition;\n\n        super(options);\n\n        this.method = method || RelayMethod.Messaging;\n    }\n\n    protected transport(): RegisterRelay<TransportName, T, [RelayOptions]> {\n        const {name, init} = this.definition;\n\n        return new RegisterRelay(name, this.method, init);\n    }\n}\n"],"mappings":"AAAA,OAAO,qBAAqB;AAE5B,SAAQ,qBAAoB;AAE5B,SAAiD,mBAAkB;AAGnE,MAAO,iCAA+D,gBAAiC;AAAA,EAChF;AAAA,EAEnB,YAAY,YAA0C;AAClD,UAAM,EAAC,MAAM,QAAQ,GAAG,QAAO,IAAI;AAEnC,UAAM,OAAO;AAEb,SAAK,SAAS,UAAU,YAAY;AAAA,EACxC;AAAA,EAEU,YAA6D;AACnE,UAAM,EAAC,MAAM,KAAI,IAAI,KAAK;AAE1B,WAAO,IAAI,cAAc,MAAM,KAAK,QAAQ,IAAI;AAAA,EACpD;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/entry/relay/TransportBuilder.ts"],"sourcesContent":["import AbstractBuilder from \"@entry/transport/AbstractBuilder\";\n\nimport {RegisterRelay} from \"@relay/providers\";\n\nimport {RelayOptions, RelayUnresolvedDefinition, RelayMethod} from \"@typing/relay\";\nimport {TransportName, TransportType} from \"@typing/transport\";\nimport type {ContentScriptIsolation} from \"@typing/content\";\n\nexport default class TransportBuilder<\n    T extends TransportType = TransportType,\n    Data = unknown,\n    Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`,\n> extends AbstractBuilder<RelayOptions, T> {\n    protected readonly method: RelayMethod;\n\n    constructor(definition: RelayUnresolvedDefinition<T, Data, Isolation>) {\n        const {main, method, prepare, boundary, target, ...options} = definition;\n\n        super(options);\n\n        this.method = method || RelayMethod.Messaging;\n    }\n\n    protected transport(): RegisterRelay<TransportName, T, [RelayOptions]> {\n        const {name, init} = this.definition;\n\n        return new RegisterRelay(name, this.method, init);\n    }\n}\n"],"mappings":"AAAA,OAAO,qBAAqB;AAE5B,SAAQ,qBAAoB;AAE5B,SAAiD,mBAAkB;AAInE,MAAO,yBAIG,gBAAiC;AAAA,EACpB;AAAA,EAEnB,YAAY,YAA2D;AACnE,UAAM,EAAC,MAAM,QAAQ,SAAS,UAAU,QAAQ,GAAG,QAAO,IAAI;AAE9D,UAAM,OAAO;AAEb,SAAK,SAAS,UAAU,YAAY;AAAA,EACxC;AAAA,EAEU,YAA6D;AACnE,UAAM,EAAC,MAAM,KAAI,IAAI,KAAK;AAE1B,WAAO,IAAI,cAAc,MAAM,KAAK,QAAQ,IAAI;AAAA,EACpD;AACJ;","names":[]}

package/dist/entry/relay/index.d.ts

@@ -1,5 +1,8 @@
 import Builder from "./Builder.js";
+import type { RelayUnresolvedDefinition } from "../../types/relay.js";
+import type { TransportType } from "../../types/transport.js";
+import type { ContentScriptIsolation } from "../../types/content/index.js";
 export { Builder };
+export { resolveDefinition } from "./resolvers/definition.js";
 export type { RelayUnresolvedDefinition } from "../../types/relay.js";
-declare const _default: (definition: Partial<import("../../types/relay.js").RelayDefinition<import("../../transport/index.js").TransportType>>) => void;
-export default _default;
+export default function relay<T extends TransportType, Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`>(definition: RelayUnresolvedDefinition<T, Data, Isolation>, contentBuilder: ConstructorParameters<typeof Builder<T, Data, NoInfer<Isolation>>>[1]): void;

package/dist/entry/relay/index.js

@@ -1,7 +1,13 @@
 import Builder from "./Builder.js";
-var relay_default = Builder.resolver();
+import { resolveDefinition } from "./resolvers/definition.js";
+function relay(definition, contentBuilder) {
+  new Builder(definition, contentBuilder).build().catch((error) => {
+    console.error("Failed to build relay: ", error);
+  });
+}
 export {
   Builder,
-  relay_default as default
+  relay as default,
+  resolveDefinition
 };
 //# sourceMappingURL=index.js.map

package/dist/entry/relay/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/entry/relay/index.ts"],"sourcesContent":["import Builder from \"./Builder\";\n\nexport {Builder};\nexport type {RelayUnresolvedDefinition} from \"@typing/relay\";\n\nexport default Builder.resolver();\n"],"mappings":"AAAA,OAAO,aAAa;AAKpB,IAAO,gBAAQ,QAAQ,SAAS;","names":[]}
+{"version":3,"sources":["../../../src/entry/relay/index.ts"],"sourcesContent":["import Builder from \"./Builder\";\n\nimport type {RelayUnresolvedDefinition} from \"@typing/relay\";\nimport type {TransportType} from \"@typing/transport\";\nimport type {ContentScriptIsolation} from \"@typing/content\";\n\nexport {Builder};\nexport {resolveDefinition} from \"./resolvers/definition\";\nexport type {RelayUnresolvedDefinition} from \"@typing/relay\";\n\nexport default function relay<\n    T extends TransportType,\n    Data = unknown,\n    Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`,\n>(\n    definition: RelayUnresolvedDefinition<T, Data, Isolation>,\n    contentBuilder: ConstructorParameters<typeof Builder<T, Data, NoInfer<Isolation>>>[1]\n): void {\n    new Builder(definition, contentBuilder).build().catch(error => {\n        console.error(\"Failed to build relay: \", error);\n    });\n}\n"],"mappings":"AAAA,OAAO,aAAa;AAOpB,SAAQ,yBAAwB;AAGjB,SAAR,MAKH,YACA,gBACI;AACJ,MAAI,QAAQ,YAAY,cAAc,EAAE,MAAM,EAAE,MAAM,WAAS;AAC3D,YAAQ,MAAM,2BAA2B,KAAK;AAAA,EAClD,CAAC;AACL;","names":[]}

package/dist/entry/relay/resolvers/definition.d.ts

@@ -0,0 +1,4 @@
+import type { RelayUnresolvedDefinition } from "../../../types/relay.js";
+import type { TransportType } from "../../../types/transport.js";
+/** Resolve Relay exports without executing init; the build supplies the authoritative name. */
+export declare const resolveDefinition: <T extends TransportType = TransportType>(module: object, name: string) => RelayUnresolvedDefinition<T>;

package/dist/entry/relay/resolvers/definition.js

@@ -0,0 +1,16 @@
+import { isValidTransportDefinition, isValidTransportInitFunction } from "./../../../entry/transport/resolvers/definition.js";
+const resolveDefinition = (module, name) => {
+  const { default: defaultDefinition, ...otherDefinition } = module;
+  let definition = otherDefinition;
+  if (isValidTransportDefinition(defaultDefinition)) {
+    definition = { ...definition, ...defaultDefinition };
+  } else if (isValidTransportInitFunction(defaultDefinition)) {
+    definition = { ...definition, init: defaultDefinition };
+  }
+  const { init, main, name: _name, ...options } = definition;
+  return { name, init, main, ...options };
+};
+export {
+  resolveDefinition
+};
+//# sourceMappingURL=definition.js.map

package/dist/entry/relay/resolvers/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/entry/relay/resolvers/definition.ts"],"sourcesContent":["import {isValidTransportDefinition, isValidTransportInitFunction} from \"@entry/transport/resolvers/definition\";\n\nimport type {RelayOptions, RelayUnresolvedDefinition} from \"@typing/relay\";\nimport type {TransportType} from \"@typing/transport\";\n\n/** Resolve Relay exports without executing init; the build supplies the authoritative name. */\nexport const resolveDefinition = <T extends TransportType = TransportType>(\n    module: object,\n    name: string\n): RelayUnresolvedDefinition<T> => {\n    const {default: defaultDefinition, ...otherDefinition} = module as Record<string, unknown>;\n\n    let definition = otherDefinition as RelayUnresolvedDefinition<T>;\n\n    if (isValidTransportDefinition<RelayOptions, T>(defaultDefinition)) {\n        definition = {...definition, ...defaultDefinition};\n    } else if (isValidTransportInitFunction<RelayOptions, T>(defaultDefinition)) {\n        definition = {...definition, init: defaultDefinition};\n    }\n\n    const {init, main, name: _name, ...options} = definition;\n\n    return {name, init, main, ...options};\n};\n"],"mappings":"AAAA,SAAQ,4BAA4B,oCAAmC;AAMhE,MAAM,oBAAoB,CAC7B,QACA,SAC+B;AAC/B,QAAM,EAAC,SAAS,mBAAmB,GAAG,gBAAe,IAAI;AAEzD,MAAI,aAAa;AAEjB,MAAI,2BAA4C,iBAAiB,GAAG;AAChE,iBAAa,EAAC,GAAG,YAAY,GAAG,kBAAiB;AAAA,EACrD,WAAW,6BAA8C,iBAAiB,GAAG;AACzE,iBAAa,EAAC,GAAG,YAAY,MAAM,kBAAiB;AAAA,EACxD;AAEA,QAAM,EAAC,MAAM,MAAM,MAAM,OAAO,GAAG,QAAO,IAAI;AAE9C,SAAO,EAAC,MAAM,MAAM,MAAM,GAAG,QAAO;AACxC;","names":[]}

package/dist/locale/adapters/react/ReactLocale.d.ts

@@ -0,0 +1,18 @@
+import { type ReactNode } from "react";
+import type { Language, LocaleDir, LocaleNonPluralKeys, LocalePluralKeys, LocaleRegistry, LocaleSubstitutionArgs, LocaleSnapshot } from "../../../types/locale.js";
+import type { LocaleReactContract, LocaleReactSubstitutionArgs } from "./types.js";
+/** Adapts an existing message provider to React without owning storage or language changes. */
+export default class ReactLocale<S extends object = LocaleRegistry> implements LocaleReactContract<S> {
+    private readonly locale;
+    readonly lang: Language;
+    readonly langs: ReadonlySet<Language>;
+    readonly langNames: ReadonlyMap<Language, string>;
+    readonly dir: LocaleDir;
+    readonly isRtl: boolean;
+    constructor(locale: LocaleSnapshot<S>);
+    t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;
+    t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleReactSubstitutionArgs<S, K>): ReactNode;
+    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;
+    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleReactSubstitutionArgs<S, K>): ReactNode;
+    private render;
+}

package/dist/locale/adapters/react/ReactLocale.js

@@ -0,0 +1,41 @@
+import { createElement, Fragment } from "react";
+import { selectPluralForm, applySubstitutions, getLocaleDir, isLocaleRtl } from "./../../../shared/locale/index.js";
+class ReactLocale {
+  constructor(locale) {
+    this.locale = locale;
+    this.lang = locale.lang();
+    this.langs = locale.langs();
+    this.langNames = locale.langNames();
+    this.dir = getLocaleDir(this.lang);
+    this.isRtl = isLocaleRtl(this.lang);
+    this.t = this.t.bind(this);
+    this.choice = this.choice.bind(this);
+  }
+  locale;
+  lang;
+  langs;
+  langNames;
+  dir;
+  isRtl;
+  t(key, substitutions) {
+    return this.render(key, substitutions);
+  }
+  choice(key, count, substitutions) {
+    return this.render(key, substitutions, count);
+  }
+  render(key, substitutions, count) {
+    const message = this.locale.get(key);
+    const template = count === void 0 ? message : selectPluralForm(message, this.lang, count);
+    const parts = applySubstitutions(template, substitutions, (name) => {
+      console.warn(`Locale substitution "${name}" not found for key "${key}" in "${this.lang}" language.`);
+    });
+    if (parts.every((part) => typeof part === "string" || typeof part === "number")) {
+      return parts.join("");
+    }
+    return parts.map((part, index) => createElement(Fragment, { key: index }, part));
+  }
+}
+export {
+  ReactLocale as default
+};
+//# sourceMappingURL=ReactLocale.js.map

package/dist/locale/adapters/react/ReactLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/locale/adapters/react/ReactLocale.ts"],"sourcesContent":["import {createElement, Fragment, type ReactNode} from \"react\";\n\nimport {selectPluralForm, applySubstitutions, getLocaleDir, isLocaleRtl} from \"@shared/locale\";\n\nimport type {\n    Language,\n    LocaleDir,\n    LocaleNonPluralKeys,\n    LocalePluralKeys,\n    LocaleRegistry,\n    LocaleSubstitutionArgs,\n    LocaleSnapshot,\n} from \"@typing/locale\";\n\nimport type {LocaleReactContract, LocaleReactSubstitutionArgs} from \"./types\";\n\n/** Adapts an existing message provider to React without owning storage or language changes. */\nexport default class ReactLocale<S extends object = LocaleRegistry> implements LocaleReactContract<S> {\n    public readonly lang: Language;\n    public readonly langs: ReadonlySet<Language>;\n    public readonly langNames: ReadonlyMap<Language, string>;\n    public readonly dir: LocaleDir;\n    public readonly isRtl: boolean;\n\n    constructor(private readonly locale: LocaleSnapshot<S>) {\n        this.lang = locale.lang();\n        this.langs = locale.langs();\n        this.langNames = locale.langNames();\n        this.dir = getLocaleDir(this.lang);\n        this.isRtl = isLocaleRtl(this.lang);\n\n        this.t = this.t.bind(this);\n        this.choice = this.choice.bind(this);\n    }\n\n    public t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n    public t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleReactSubstitutionArgs<S, K>): ReactNode;\n    public t(key: LocaleNonPluralKeys<S>, substitutions?: Record<string, ReactNode>): ReactNode {\n        return this.render(key, substitutions);\n    }\n\n    public choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n    public choice<K extends LocalePluralKeys<S>>(\n        key: K,\n        count: number,\n        ...args: LocaleReactSubstitutionArgs<S, K>\n    ): ReactNode;\n    public choice(key: LocalePluralKeys<S>, count: number, substitutions?: Record<string, ReactNode>): ReactNode {\n        return this.render(key, substitutions, count);\n    }\n\n    private render(key: keyof S & string, substitutions?: Record<string, ReactNode>, count?: number): ReactNode {\n        const message = this.locale.get(key);\n\n        const template = count === undefined ? message : selectPluralForm(message, this.lang, count);\n\n        const parts = applySubstitutions(template, substitutions, name => {\n            console.warn(`Locale substitution \"${name}\" not found for key \"${key}\" in \"${this.lang}\" language.`);\n        });\n\n        if (parts.every(part => typeof part === \"string\" || typeof part === \"number\")) {\n            return parts.join(\"\");\n        }\n\n        return parts.map((part, index) => createElement(Fragment, {key: index}, part));\n    }\n}\n"],"mappings":"AAAA,SAAQ,eAAe,gBAA+B;AAEtD,SAAQ,kBAAkB,oBAAoB,cAAc,mBAAkB;AAe9E,MAAO,YAA+F;AAAA,EAOlG,YAA6B,QAA2B;AAA3B;AACzB,SAAK,OAAO,OAAO,KAAK;AACxB,SAAK,QAAQ,OAAO,MAAM;AAC1B,SAAK,YAAY,OAAO,UAAU;AAClC,SAAK,MAAM,aAAa,KAAK,IAAI;AACjC,SAAK,QAAQ,YAAY,KAAK,IAAI;AAElC,SAAK,IAAI,KAAK,EAAE,KAAK,IAAI;AACzB,SAAK,SAAS,KAAK,OAAO,KAAK,IAAI;AAAA,EACvC;AAAA,EAT6B;AAAA,EANb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAeT,EAAE,KAA6B,eAAsD;AACxF,WAAO,KAAK,OAAO,KAAK,aAAa;AAAA,EACzC;AAAA,EAQO,OAAO,KAA0B,OAAe,eAAsD;AACzG,WAAO,KAAK,OAAO,KAAK,eAAe,KAAK;AAAA,EAChD;AAAA,EAEQ,OAAO,KAAuB,eAA2C,OAA2B;AACxG,UAAM,UAAU,KAAK,OAAO,IAAI,GAAG;AAEnC,UAAM,WAAW,UAAU,SAAY,UAAU,iBAAiB,SAAS,KAAK,MAAM,KAAK;AAE3F,UAAM,QAAQ,mBAAmB,UAAU,eAAe,UAAQ;AAC9D,cAAQ,KAAK,wBAAwB,IAAI,wBAAwB,GAAG,SAAS,KAAK,IAAI,aAAa;AAAA,IACvG,CAAC;AAED,QAAI,MAAM,MAAM,UAAQ,OAAO,SAAS,YAAY,OAAO,SAAS,QAAQ,GAAG;AAC3E,aAAO,MAAM,KAAK,EAAE;AAAA,IACxB;AAEA,WAAO,MAAM,IAAI,CAAC,MAAM,UAAU,cAAc,UAAU,EAAC,KAAK,MAAK,GAAG,IAAI,CAAC;AAAA,EACjF;AACJ;","names":[]}

package/dist/locale/adapters/react/hooks/use-locale-attributes.d.ts

@@ -0,0 +1,7 @@
+import type { LocaleReactContract } from "../types.js";
+/**
+ * Applies language attributes from either locale hook to an element after render.
+ * An omitted target or undefined selects html; null disables application.
+ * Cleanup restores each previous attribute only while its applied value is unchanged.
+ */
+export declare const useLocaleAttributes: (locale: Pick<LocaleReactContract, "lang" | "dir">, target?: string | Element | null) => void;

package/dist/locale/adapters/react/hooks/use-locale-attributes.js

@@ -0,0 +1,30 @@
+import { useEffect } from "react";
+const useLocaleAttributes = (locale, target = "html") => {
+  const { lang, dir } = locale;
+  useEffect(() => {
+    const element = typeof target === "string" ? document.querySelector(target) : target;
+    if (!element) return;
+    const attributes = Object.entries({ lang, dir }).map(([name, value]) => ({
+      name,
+      value,
+      previous: element.getAttribute(name)
+    }));
+    for (const { name, value } of attributes) {
+      element.setAttribute(name, value);
+    }
+    return () => {
+      for (const { name, value, previous } of attributes) {
+        if (element.getAttribute(name) !== value) continue;
+        if (previous === null) {
+          element.removeAttribute(name);
+        } else {
+          element.setAttribute(name, previous);
+        }
+      }
+    };
+  }, [target, lang, dir]);
+};
+export {
+  useLocaleAttributes
+};
+//# sourceMappingURL=use-locale-attributes.js.map

package/dist/locale/adapters/react/hooks/use-locale-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/locale/adapters/react/hooks/use-locale-attributes.ts"],"sourcesContent":["import {useEffect} from \"react\";\nimport type {LocaleReactContract} from \"../types\";\n\n/**\n * Applies language attributes from either locale hook to an element after render.\n * An omitted target or undefined selects html; null disables application.\n * Cleanup restores each previous attribute only while its applied value is unchanged.\n */\nexport const useLocaleAttributes = (\n    locale: Pick<LocaleReactContract, \"lang\" | \"dir\">,\n    target: string | Element | null = \"html\"\n): void => {\n    const {lang, dir} = locale;\n\n    useEffect(() => {\n        const element = typeof target === \"string\" ? document.querySelector(target) : target;\n\n        if (!element) return;\n\n        const attributes = Object.entries({lang, dir}).map(([name, value]) => ({\n            name,\n            value,\n            previous: element.getAttribute(name),\n        }));\n\n        for (const {name, value} of attributes) {\n            element.setAttribute(name, value);\n        }\n\n        return () => {\n            for (const {name, value, previous} of attributes) {\n                if (element.getAttribute(name) !== value) continue;\n\n                if (previous === null) {\n                    element.removeAttribute(name);\n                } else {\n                    element.setAttribute(name, previous);\n                }\n            }\n        };\n    }, [target, lang, dir]);\n};\n"],"mappings":"AAAA,SAAQ,iBAAgB;AAQjB,MAAM,sBAAsB,CAC/B,QACA,SAAkC,WAC3B;AACP,QAAM,EAAC,MAAM,IAAG,IAAI;AAEpB,YAAU,MAAM;AACZ,UAAM,UAAU,OAAO,WAAW,WAAW,SAAS,cAAc,MAAM,IAAI;AAE9E,QAAI,CAAC,QAAS;AAEd,UAAM,aAAa,OAAO,QAAQ,EAAC,MAAM,IAAG,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO;AAAA,MACnE;AAAA,MACA;AAAA,MACA,UAAU,QAAQ,aAAa,IAAI;AAAA,IACvC,EAAE;AAEF,eAAW,EAAC,MAAM,MAAK,KAAK,YAAY;AACpC,cAAQ,aAAa,MAAM,KAAK;AAAA,IACpC;AAEA,WAAO,MAAM;AACT,iBAAW,EAAC,MAAM,OAAO,SAAQ,KAAK,YAAY;AAC9C,YAAI,QAAQ,aAAa,IAAI,MAAM,MAAO;AAE1C,YAAI,aAAa,MAAM;AACnB,kBAAQ,gBAAgB,IAAI;AAAA,QAChC,OAAO;AACH,kBAAQ,aAAa,MAAM,QAAQ;AAAA,QACvC;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC;AAC1B;","names":[]}

package/dist/locale/adapters/react/hooks/use-locale.d.ts

@@ -0,0 +1,3 @@
+import type { LocaleReactDynamicContract } from "../types.js";
+import type { LocaleStorageDriver } from "../../../../types/locale.js";
+export declare const useLocale: (storage?: LocaleStorageDriver | false) => LocaleReactDynamicContract;

package/dist/locale/adapters/react/hooks/use-locale.js

@@ -0,0 +1,17 @@
+import { useMemo, useSyncExternalStore } from "react";
+import ReactLocale from "../ReactLocale.js";
+import { ObservableLocale } from "./../../../../locale/providers/index.js";
+const useLocale = (storage) => {
+  const locale = useMemo(() => ObservableLocale.getInstance(storage), [storage]);
+  const snapshot = useSyncExternalStore(locale.subscribe, locale.snapshot);
+  return useMemo(
+    () => Object.assign(new ReactLocale(snapshot), {
+      change: locale.change
+    }),
+    [locale, snapshot]
+  );
+};
+export {
+  useLocale
+};
+//# sourceMappingURL=use-locale.js.map

package/dist/locale/adapters/react/hooks/use-locale.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/locale/adapters/react/hooks/use-locale.ts"],"sourcesContent":["import {useMemo, useSyncExternalStore} from \"react\";\n\nimport ReactLocale from \"../ReactLocale\";\n\nimport {ObservableLocale} from \"@locale/providers\";\n\nimport type {LocaleReactDynamicContract} from \"../types\";\nimport type {LocaleRegistry, LocaleStorageDriver} from \"@typing/locale\";\n\nexport const useLocale = (storage?: LocaleStorageDriver | false): LocaleReactDynamicContract => {\n    const locale = useMemo(() => ObservableLocale.getInstance(storage), [storage]);\n    const snapshot = useSyncExternalStore(locale.subscribe, locale.snapshot);\n\n    return useMemo(\n        () =>\n            Object.assign(new ReactLocale<LocaleRegistry>(snapshot), {\n                change: locale.change,\n            }),\n        [locale, snapshot]\n    );\n};\n"],"mappings":"AAAA,SAAQ,SAAS,4BAA2B;AAE5C,OAAO,iBAAiB;AAExB,SAAQ,wBAAuB;AAKxB,MAAM,YAAY,CAAC,YAAsE;AAC5F,QAAM,SAAS,QAAQ,MAAM,iBAAiB,YAAY,OAAO,GAAG,CAAC,OAAO,CAAC;AAC7E,QAAM,WAAW,qBAAqB,OAAO,WAAW,OAAO,QAAQ;AAEvE,SAAO;AAAA,IACH,MACI,OAAO,OAAO,IAAI,YAA4B,QAAQ,GAAG;AAAA,MACrD,QAAQ,OAAO;AAAA,IACnB,CAAC;AAAA,IACL,CAAC,QAAQ,QAAQ;AAAA,EACrB;AACJ;","names":[]}

package/dist/locale/adapters/react/hooks/use-native-locale.d.ts

@@ -0,0 +1,3 @@
+import type { LocaleReactContract } from "../types.js";
+/** Uses browser-selected translations with React substitutions. */
+export declare const useNativeLocale: () => LocaleReactContract;

package/dist/locale/adapters/react/hooks/use-native-locale.js

@@ -0,0 +1,10 @@
+import { useMemo } from "react";
+import NativeLocale from "./../../../../locale/providers/NativeLocale.js";
+import ReactLocale from "../ReactLocale.js";
+const useNativeLocale = () => {
+  return useMemo(() => new ReactLocale(NativeLocale.getInstance()), []);
+};
+export {
+  useNativeLocale
+};
+//# sourceMappingURL=use-native-locale.js.map

package/dist/locale/adapters/react/hooks/use-native-locale.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/locale/adapters/react/hooks/use-native-locale.ts"],"sourcesContent":["import {useMemo} from \"react\";\nimport NativeLocale from \"@locale/providers/NativeLocale\";\nimport ReactLocale from \"../ReactLocale\";\nimport type {LocaleRegistry} from \"@typing/locale\";\nimport type {LocaleReactContract} from \"../types\";\n\n/** Uses browser-selected translations with React substitutions. */\nexport const useNativeLocale = (): LocaleReactContract => {\n    return useMemo(() => new ReactLocale<LocaleRegistry>(NativeLocale.getInstance()), []);\n};\n"],"mappings":"AAAA,SAAQ,eAAc;AACtB,OAAO,kBAAkB;AACzB,OAAO,iBAAiB;AAKjB,MAAM,kBAAkB,MAA2B;AACtD,SAAO,QAAQ,MAAM,IAAI,YAA4B,aAAa,YAAY,CAAC,GAAG,CAAC,CAAC;AACxF;","names":[]}

package/dist/locale/adapters/react/index.d.ts

@@ -1,2 +1,4 @@
-export { default as LocaleProvider, type LocaleProviderProps } from "./LocaleProvider.js";
-export { useLocale, type LocaleContract } from "./context.js";
+export { useNativeLocale } from "./hooks/use-native-locale.js";
+export { useLocale } from "./hooks/use-locale.js";
+export { useLocaleAttributes } from "./hooks/use-locale-attributes.js";
+export type { LocaleReactContract, LocaleReactDynamicContract } from "./types.js";

package/dist/locale/adapters/react/index.js

@@ -1,7 +1,9 @@
-import { default as default2 } from "./LocaleProvider.js";
-import { useLocale } from "./context.js";
+import { useNativeLocale } from "./hooks/use-native-locale.js";
+import { useLocale } from "./hooks/use-locale.js";
+import { useLocaleAttributes } from "./hooks/use-locale-attributes.js";
 export {
-  default2 as LocaleProvider,
-  useLocale
+  useLocale,
+  useLocaleAttributes,
+  useNativeLocale
 };
 //# sourceMappingURL=index.js.map

package/dist/locale/adapters/react/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/locale/adapters/react/index.ts"],"sourcesContent":["export {default as LocaleProvider, type LocaleProviderProps} from \"./LocaleProvider\";\nexport {useLocale, type LocaleContract} from \"./context\";\n"],"mappings":"AAAA,SAAmB,WAAXA,gBAA0D;AAClE,SAAQ,iBAAqC;","names":["default"]}
+{"version":3,"sources":["../../../../src/locale/adapters/react/index.ts"],"sourcesContent":["export {useNativeLocale} from \"./hooks/use-native-locale\";\nexport {useLocale} from \"./hooks/use-locale\";\nexport {useLocaleAttributes} from \"./hooks/use-locale-attributes\";\nexport type {LocaleReactContract, LocaleReactDynamicContract} from \"./types\";\n"],"mappings":"AAAA,SAAQ,uBAAsB;AAC9B,SAAQ,iBAAgB;AACxB,SAAQ,2BAA0B;","names":[]}

package/dist/locale/adapters/react/types.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from "react";
+import type { Language, LocaleDir, LocaleNonPluralKeys, LocalePluralKeys, LocaleRegistry, LocaleSubstitutionArgs, LocaleSubstitutionKeys } from "../../../types/locale.js";
+export type LocaleReactSubstitutionArgs<S, K extends keyof S> = string extends keyof S ? [substitutions?: Record<string, ReactNode>] : [LocaleSubstitutionKeys<S, K>] extends [never] ? [] : [substitutions: Record<LocaleSubstitutionKeys<S, K>, ReactNode>];
+/** Translation capabilities shared by React adapters, without language mutation or storage. */
+export interface LocaleReactContract<S extends object = LocaleRegistry> {
+    /** Currently selected language code. */
+    readonly lang: Language;
+    /** Available language codes. */
+    readonly langs: ReadonlySet<Language>;
+    /** Native names keyed by the available language codes. */
+    readonly langNames: ReadonlyMap<Language, string>;
+    readonly dir: LocaleDir;
+    readonly isRtl: boolean;
+    t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;
+    t<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleReactSubstitutionArgs<S, K>): ReactNode;
+    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;
+    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleReactSubstitutionArgs<S, K>): ReactNode;
+}
+/** React translations with an observable language selection. */
+export interface LocaleReactDynamicContract<S extends object = LocaleRegistry> extends LocaleReactContract<S> {
+    change(lang: Language): Promise<Language>;
+}

package/dist/locale/adapters/react/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/locale/adapters/react/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/locale/helpers.d.ts

@@ -1,5 +1,4 @@
-import { LocaleNativeStructure } from "./providers/index.js";
-import { LocaleNonPluralKeys, LocalePluralKeys, LocaleSubstitutionArgs } from "../types/locale.js";
+import type { LocaleNonPluralKeys, LocalePluralKeys, LocaleRegistry, LocaleSubstitutionArgs } from "../types/locale.js";
 /**
  * Translates a non-plural locale key.
  *
@@ -17,7 +16,7 @@ import { LocaleNonPluralKeys, LocalePluralKeys, LocaleSubstitutionArgs } from ".
  * @param args
  * @returns The translated string.
  */
-export declare const t: <K extends LocaleNonPluralKeys<LocaleNativeStructure>>(key: K, ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>) => string;
+export declare const t: <K extends LocaleNonPluralKeys<LocaleRegistry>>(key: K, ...args: LocaleSubstitutionArgs<LocaleRegistry, K>) => string;
 /**
  * Translates a plural locale key using the provided count.
  *
@@ -35,7 +34,7 @@ export declare const t: <K extends LocaleNonPluralKeys<LocaleNativeStructure>>(k
  * @param args
  * @returns The translated string.
  */
-export declare const choice: <K extends LocalePluralKeys<LocaleNativeStructure>>(key: K, count: number, ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>) => string;
+export declare const choice: <K extends LocalePluralKeys<LocaleRegistry>>(key: K, count: number, ...args: LocaleSubstitutionArgs<LocaleRegistry, K>) => string;
 /**
  * Converts a locale key to a browser message reference.
  *
@@ -52,7 +51,7 @@ export declare const choice: <K extends LocalePluralKeys<LocaleNativeStructure>>
  * @param value - The locale key to convert.
  * @returns The browser message reference.
  */
-export declare const key: (value: keyof LocaleNativeStructure & string) => string;
+export declare const key: (value: keyof LocaleRegistry & string) => string;
 /**
  * Resolves a string that may contain a locale marker.
  *

package/dist/locale/helpers.js

@@ -1,5 +1,5 @@
 import { NativeLocale } from "./../locale/providers/index.js";
-import { convertLocaleMessageKey, extractLocaleKey } from "./../locale/utils.js";
+import { convertLocaleMessageKey, extractLocaleKey } from "./../shared/locale/index.js";
 const t = (key2, ...args) => {
   return NativeLocale.getInstance().trans(key2, ...args);
 };

package/dist/locale/helpers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/locale/helpers.ts"],"sourcesContent":["import {LocaleNativeStructure, NativeLocale} from \"@locale/providers\";\nimport {convertLocaleMessageKey, extractLocaleKey} from \"@locale/utils\";\nimport {LocaleNonPluralKeys, LocalePluralKeys, LocaleSubstitutionArgs} from \"@typing/locale\";\n\n/**\n * Translates a non-plural locale key.\n *\n * Substitutions are type-checked from the generated locale structure:\n * keys without placeholders do not accept substitutions, while keys with\n * placeholders require all declared substitution values.\n *\n * @example\n * ```ts\n * t(\"app.name\");\n * t(\"app.greeting\", {name: \"Alice\"});\n * ```\n *\n * @param key - The locale key to translate.\n * @param args\n * @returns The translated string.\n */\nexport const t = <K extends LocaleNonPluralKeys<LocaleNativeStructure>>(\n    key: K,\n    ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>\n): string => {\n    return NativeLocale.getInstance().trans(key, ...args);\n};\n\n/**\n * Translates a plural locale key using the provided count.\n *\n * Substitutions are type-checked from the generated locale structure:\n * keys without placeholders do not accept substitutions, while keys with\n * placeholders require all declared substitution values.\n *\n * @example\n * ```ts\n * choice(\"cart.items\", count, {count});\n * ```\n *\n * @param key - The locale key to translate.\n * @param count - The count used to select the plural form.\n * @param args\n * @returns The translated string.\n */\nexport const choice = <K extends LocalePluralKeys<LocaleNativeStructure>>(\n    key: K,\n    count: number,\n    ...args: LocaleSubstitutionArgs<LocaleNativeStructure, K>\n): string => {\n    return NativeLocale.getInstance().choice(key, count, ...args);\n};\n\n/**\n * Converts a locale key to a browser message reference.\n *\n * This is useful for browser-managed extension fields that expect\n * `__MSG_name__` references instead of already translated text.\n *\n * A warning is logged when the key does not exist in the generated locale keys.\n *\n * @example\n * ```ts\n * key(\"app.name\"); // \"__MSG_app_name__\"\n * ```\n *\n * @param value - The locale key to convert.\n * @returns The browser message reference.\n */\nexport const key = (value: keyof LocaleNativeStructure & string): string => {\n    const locale = NativeLocale.getInstance();\n\n    if (!locale.keys().has(value)) {\n        console.warn(`Locale key \"${value}\" not found in \"${locale.lang()}\" language.`);\n    }\n\n    return convertLocaleMessageKey(value);\n};\n\n/**\n * Resolves a string that may contain a locale marker.\n *\n * When the input contains a locale marker, the marker is extracted and translated.\n * Plain strings are returned unchanged.\n *\n * @example\n * ```ts\n * resolve(\"@app.name\");\n * resolve(\"Plain title\");\n * ```\n *\n * @param input - A plain string or a marked locale key string.\n * @returns The translated text when a marker is found, otherwise the original input.\n */\nexport const resolve = (input: string): string => {\n    const localeKey = extractLocaleKey(input);\n\n    if (localeKey) {\n        // Markers are runtime strings without substitutions; keep t() strict for typed callers.\n        return (t as (key: string) => string)(localeKey);\n    }\n\n    return input;\n};\n"],"mappings":"AAAA,SAA+B,oBAAmB;AAClD,SAAQ,yBAAyB,wBAAuB;AAoBjD,MAAM,IAAI,CACbA,SACG,SACM;AACT,SAAO,aAAa,YAAY,EAAE,MAAMA,MAAK,GAAG,IAAI;AACxD;AAmBO,MAAM,SAAS,CAClBA,MACA,UACG,SACM;AACT,SAAO,aAAa,YAAY,EAAE,OAAOA,MAAK,OAAO,GAAG,IAAI;AAChE;AAkBO,MAAM,MAAM,CAAC,UAAwD;AACxE,QAAM,SAAS,aAAa,YAAY;AAExC,MAAI,CAAC,OAAO,KAAK,EAAE,IAAI,KAAK,GAAG;AAC3B,YAAQ,KAAK,eAAe,KAAK,mBAAmB,OAAO,KAAK,CAAC,aAAa;AAAA,EAClF;AAEA,SAAO,wBAAwB,KAAK;AACxC;AAiBO,MAAM,UAAU,CAAC,UAA0B;AAC9C,QAAM,YAAY,iBAAiB,KAAK;AAExC,MAAI,WAAW;AAEX,WAAQ,EAA8B,SAAS;AAAA,EACnD;AAEA,SAAO;AACX;","names":["key"]}
+{"version":3,"sources":["../../src/locale/helpers.ts"],"sourcesContent":["import {NativeLocale} from \"@locale/providers\";\nimport {convertLocaleMessageKey, extractLocaleKey} from \"@shared/locale\";\nimport type {LocaleNonPluralKeys, LocalePluralKeys, LocaleRegistry, LocaleSubstitutionArgs} from \"@typing/locale\";\n\n/**\n * Translates a non-plural locale key.\n *\n * Substitutions are type-checked from the generated locale structure:\n * keys without placeholders do not accept substitutions, while keys with\n * placeholders require all declared substitution values.\n *\n * @example\n * ```ts\n * t(\"app.name\");\n * t(\"app.greeting\", {name: \"Alice\"});\n * ```\n *\n * @param key - The locale key to translate.\n * @param args\n * @returns The translated string.\n */\nexport const t = <K extends LocaleNonPluralKeys<LocaleRegistry>>(\n    key: K,\n    ...args: LocaleSubstitutionArgs<LocaleRegistry, K>\n): string => {\n    return NativeLocale.getInstance().trans(key, ...args);\n};\n\n/**\n * Translates a plural locale key using the provided count.\n *\n * Substitutions are type-checked from the generated locale structure:\n * keys without placeholders do not accept substitutions, while keys with\n * placeholders require all declared substitution values.\n *\n * @example\n * ```ts\n * choice(\"cart.items\", count, {count});\n * ```\n *\n * @param key - The locale key to translate.\n * @param count - The count used to select the plural form.\n * @param args\n * @returns The translated string.\n */\nexport const choice = <K extends LocalePluralKeys<LocaleRegistry>>(\n    key: K,\n    count: number,\n    ...args: LocaleSubstitutionArgs<LocaleRegistry, K>\n): string => {\n    return NativeLocale.getInstance().choice(key, count, ...args);\n};\n\n/**\n * Converts a locale key to a browser message reference.\n *\n * This is useful for browser-managed extension fields that expect\n * `__MSG_name__` references instead of already translated text.\n *\n * A warning is logged when the key does not exist in the generated locale keys.\n *\n * @example\n * ```ts\n * key(\"app.name\"); // \"__MSG_app_name__\"\n * ```\n *\n * @param value - The locale key to convert.\n * @returns The browser message reference.\n */\nexport const key = (value: keyof LocaleRegistry & string): string => {\n    const locale = NativeLocale.getInstance();\n\n    if (!locale.keys().has(value)) {\n        console.warn(`Locale key \"${value}\" not found in \"${locale.lang()}\" language.`);\n    }\n\n    return convertLocaleMessageKey(value);\n};\n\n/**\n * Resolves a string that may contain a locale marker.\n *\n * When the input contains a locale marker, the marker is extracted and translated.\n * Plain strings are returned unchanged.\n *\n * @example\n * ```ts\n * resolve(\"@app.name\");\n * resolve(\"Plain title\");\n * ```\n *\n * @param input - A plain string or a marked locale key string.\n * @returns The translated text when a marker is found, otherwise the original input.\n */\nexport const resolve = (input: string): string => {\n    const localeKey = extractLocaleKey(input);\n\n    if (localeKey) {\n        // Markers are runtime strings without substitutions; keep t() strict for typed callers.\n        return (t as (key: string) => string)(localeKey);\n    }\n\n    return input;\n};\n"],"mappings":"AAAA,SAAQ,oBAAmB;AAC3B,SAAQ,yBAAyB,wBAAuB;AAoBjD,MAAM,IAAI,CACbA,SACG,SACM;AACT,SAAO,aAAa,YAAY,EAAE,MAAMA,MAAK,GAAG,IAAI;AACxD;AAmBO,MAAM,SAAS,CAClBA,MACA,UACG,SACM;AACT,SAAO,aAAa,YAAY,EAAE,OAAOA,MAAK,OAAO,GAAG,IAAI;AAChE;AAkBO,MAAM,MAAM,CAAC,UAAiD;AACjE,QAAM,SAAS,aAAa,YAAY;AAExC,MAAI,CAAC,OAAO,KAAK,EAAE,IAAI,KAAK,GAAG;AAC3B,YAAQ,KAAK,eAAe,KAAK,mBAAmB,OAAO,KAAK,CAAC,aAAa;AAAA,EAClF;AAEA,SAAO,wBAAwB,KAAK;AACxC;AAiBO,MAAM,UAAU,CAAC,UAA0B;AAC9C,QAAM,YAAY,iBAAiB,KAAK;AAExC,MAAI,WAAW;AAEX,WAAQ,EAA8B,SAAS;AAAA,EACnD;AAEA,SAAO;AACX;","names":["key"]}

package/dist/locale/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./providers/index.js";
 export * from "./helpers.js";
-export { Language, LanguageCodes, LocaleDir, type LocaleStructure, type LocaleProvider, type LocaleDynamicProvider, type LocaleKeys, type LocaleSubstitutionArgs, type LocaleSubstitutionKeys, type LocaleSubstitutionValue, type LocaleNonPluralKeys, type LocalePluralKeys, } from "../types/locale.js";
+export * from "./storage/index.js";
+export { Language, LanguageCodes, LocaleDir, type LocaleStructure, type LocaleRegistry, type LocaleProvider, type LocaleDynamicProvider, type LocaleSnapshot, type LocaleStorageDriver, type LocaleKeys, type LocaleSubstitutionArgs, type LocaleSubstitutionKeys, type LocaleSubstitutionValue, type LocaleNonPluralKeys, type LocalePluralKeys, } from "../types/locale.js";

package/dist/locale/index.js

@@ -1,5 +1,6 @@
 export * from "./providers/index.js";
 export * from "./helpers.js";
+export * from "./storage/index.js";
 import {
   Language,
   LanguageCodes,

package/dist/locale/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/locale/index.ts"],"sourcesContent":["export * from \"./providers\";\nexport * from \"./helpers\";\n\nexport {\n    Language,\n    LanguageCodes,\n    LocaleDir,\n    type LocaleStructure,\n    type LocaleProvider,\n    type LocaleDynamicProvider,\n    type LocaleKeys,\n    type LocaleSubstitutionArgs,\n    type LocaleSubstitutionKeys,\n    type LocaleSubstitutionValue,\n    type LocaleNonPluralKeys,\n    type LocalePluralKeys,\n} from \"@typing/locale\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AAEd;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OAUG;","names":[]}
+{"version":3,"sources":["../../src/locale/index.ts"],"sourcesContent":["export * from \"./providers\";\nexport * from \"./helpers\";\nexport * from \"./storage\";\n\nexport {\n    Language,\n    LanguageCodes,\n    LocaleDir,\n    type LocaleStructure,\n    type LocaleRegistry,\n    type LocaleProvider,\n    type LocaleDynamicProvider,\n    type LocaleSnapshot,\n    type LocaleStorageDriver,\n    type LocaleKeys,\n    type LocaleSubstitutionArgs,\n    type LocaleSubstitutionKeys,\n    type LocaleSubstitutionValue,\n    type LocaleNonPluralKeys,\n    type LocalePluralKeys,\n} from \"@typing/locale\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AAEd;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,OAaG;","names":[]}

package/dist/locale/providers/AbstractLocale.d.ts

@@ -1,13 +1,13 @@
 import { Language, LocaleNonPluralKeys, LocalePluralKeys, LocaleProvider, LocaleStructure, LocaleSubstitutionArgs, LocaleSubstitutionValue } from "../../types/locale.js";
-export default abstract class<S extends object = LocaleStructure> implements LocaleProvider<S> {
+export default abstract class AbstractLocale<S extends object = LocaleStructure> implements LocaleProvider<S> {
     abstract lang(): Language;
     abstract keys(): Set<keyof S>;
-    abstract languages(): Set<Language>;
+    abstract langs(): ReadonlySet<Language>;
     /** Returns native names for this provider's languages, preserving their order. */
-    languageNames(): Map<Language, string>;
+    langNames(): ReadonlyMap<Language, string>;
     protected abstract value(key: keyof S & string): string | undefined;
     trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;
     choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;
     get<K extends keyof S & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string;
-    private getPluralIndex;
+    private substitute;
 }

package/dist/locale/providers/AbstractLocale.js

@@ -1,12 +1,11 @@
+import { selectPluralForm, applySubstitutions } from "./../../shared/locale/index.js";
 import {
-  Language,
-  LanguageNames,
-  LocaleValuesSeparator
+  LanguageNames
 } from "./../../types/locale.js";
-class AbstractLocale_default {
+class AbstractLocale {
   /** Returns native names for this provider's languages, preserving their order. */
-  languageNames() {
-    return new Map([...this.languages()].map((language) => [language, LanguageNames[language]]));
+  langNames() {
+    return new Map([...this.langs()].map((language) => [language, LanguageNames[language]]));
   }
   trans(key, ...args) {
     const [substitutions] = args;
@@ -14,9 +13,8 @@ class AbstractLocale_default {
   }
   choice(key, count, ...args) {
     const [substitutions] = args;
-    const parts = this.get(key, substitutions).split(LocaleValuesSeparator);
-    const idx = this.getPluralIndex(count);
-    return parts[idx] ?? parts[0] ?? key;
+    const message = selectPluralForm(this.get(key), this.lang(), count);
+    return this.substitute(message, key, substitutions);
   }
   get(key, substitutions) {
     const template = this.value(key);
@@ -24,94 +22,15 @@ class AbstractLocale_default {
       console.warn(`Locale key "${key}" not found in "${this.lang()}" language.`);
       return key;
     }
-    if (substitutions) {
-      return template.replace(/{{(.*?)}}/g, (_, placeholder) => {
-        const substitution = placeholder.trim();
-        if (substitution in substitutions) {
-          return substitutions[substitution].toString();
-        }
-        console.warn(
-          `Locale substitution "${substitution}" not found for key "${key}" in "${this.lang()}" language.`
-        );
-        return substitution;
-      });
-    }
-    return template;
+    return this.substitute(template, key, substitutions);
   }
-  getPluralIndex(count) {
-    switch (this.lang()) {
-      case Language.Indonesian:
-      case Language.Japanese:
-      case Language.Kannada:
-      case Language.Korean:
-      case Language.Malay:
-      case Language.Thai:
-      case Language.Turkish:
-      case Language.Vietnamese:
-        return 0;
-      case Language.Bengali:
-      case Language.Bulgarian:
-      case Language.Catalan:
-      case Language.Danish:
-      case Language.German:
-      case Language.Greek:
-      case Language.English:
-      case Language.EnglishAustralia:
-      case Language.EnglishGreatBritain:
-      case Language.EnglishUSA:
-      case Language.Spanish:
-      case Language.SpanishLatinAmericaAndCaribbean:
-      case Language.Estonian:
-      case Language.Persian:
-      case Language.Finnish:
-      case Language.Gujarati:
-      case Language.Hebrew:
-      case Language.Hungarian:
-      case Language.Italian:
-      case Language.Malayalam:
-      case Language.Marathi:
-      case Language.Dutch:
-      case Language.Norwegian:
-      case Language.Swedish:
-      case Language.Swahili:
-      case Language.Tamil:
-      case Language.Telugu:
-      case Language.ChineseChina:
-      case Language.ChineseTaiwan:
-      case Language.PortugueseBrazil:
-      case Language.PortuguesePortugal:
-        return count == 1 ? 0 : 1;
-      case Language.Amharic:
-      case Language.Filipino:
-      case Language.French:
-      case Language.Hindi:
-        return count == 0 || count == 1 ? 0 : 1;
-      case Language.Croatian:
-      case Language.Russian:
-      case Language.Serbian:
-      case Language.Ukrainian:
-        return count % 10 == 1 && count % 100 != 11 ? 0 : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 10 || count % 100 >= 20) ? 1 : 2;
-      case Language.Czech:
-      case Language.Slovak:
-        return count == 1 ? 0 : count >= 2 && count <= 4 ? 1 : 2;
-      case Language.Lithuanian:
-        return count % 10 == 1 && count % 100 != 11 ? 0 : count % 10 >= 2 && (count % 100 < 10 || count % 100 >= 20) ? 1 : 2;
-      case Language.Slovenian:
-        return count % 100 == 1 ? 0 : count % 100 == 2 ? 1 : count % 100 == 3 || count % 100 == 4 ? 2 : 3;
-      case Language.Latvian:
-        return count == 0 ? 0 : count % 10 == 1 && count % 100 != 11 ? 1 : 2;
-      case Language.Polish:
-        return count == 1 ? 0 : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 12 || count % 100 > 14) ? 1 : 2;
-      case Language.Romanian:
-        return count == 1 ? 0 : count == 0 || count % 100 > 0 && count % 100 < 20 ? 1 : 2;
-      case Language.Arabic:
-        return count == 0 ? 0 : count == 1 ? 1 : count == 2 ? 2 : count % 100 >= 3 && count % 100 <= 10 ? 3 : count % 100 >= 11 && count % 100 <= 99 ? 4 : 5;
-      default:
-        return 0;
-    }
+  substitute(message, key, substitutions) {
+    return applySubstitutions(message, substitutions, (name) => {
+      console.warn(`Locale substitution "${name}" not found for key "${key}" in "${this.lang()}" language.`);
+    }).join("");
   }
 }
 export {
-  AbstractLocale_default as default
+  AbstractLocale as default
 };
 //# sourceMappingURL=AbstractLocale.js.map

package/dist/locale/providers/AbstractLocale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/locale/providers/AbstractLocale.ts"],"sourcesContent":["import {\n    Language,\n    LanguageNames,\n    LocaleNonPluralKeys,\n    LocalePluralKeys,\n    LocaleProvider,\n    LocaleStructure,\n    LocaleSubstitutionArgs,\n    LocaleSubstitutionValue,\n    LocaleValuesSeparator,\n} from \"@typing/locale\";\n\nexport default abstract class<S extends object = LocaleStructure> implements LocaleProvider<S> {\n    public abstract lang(): Language;\n\n    public abstract keys(): Set<keyof S>;\n\n    public abstract languages(): Set<Language>;\n\n    /** Returns native names for this provider's languages, preserving their order. */\n    public languageNames(): Map<Language, string> {\n        return new Map([...this.languages()].map(language => [language, LanguageNames[language]]));\n    }\n\n    protected abstract value(key: keyof S & string): string | undefined;\n\n    public trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string {\n        const [substitutions] = args;\n\n        return this.get(key, substitutions);\n    }\n\n    public choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string {\n        const [substitutions] = args;\n        const parts = this.get(key, substitutions).split(LocaleValuesSeparator);\n\n        const idx = this.getPluralIndex(count);\n\n        return parts[idx] ?? parts[0] ?? (key as string);\n    }\n\n    public get<K extends keyof S & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string {\n        const template = this.value(key);\n\n        if (template === undefined) {\n            console.warn(`Locale key \"${key}\" not found in \"${this.lang()}\" language.`);\n\n            return key as string;\n        }\n\n        if (substitutions) {\n            return template.replace(/{{(.*?)}}/g, (_, placeholder: string) => {\n                const substitution = placeholder.trim();\n\n                if (substitution in substitutions) {\n                    return substitutions[substitution]!.toString();\n                }\n\n                console.warn(\n                    `Locale substitution \"${substitution}\" not found for key \"${key}\" in \"${this.lang()}\" language.`\n                );\n\n                return substitution;\n            });\n        }\n\n        return template;\n    }\n\n    private getPluralIndex(count: number): number {\n        switch (this.lang()) {\n            case Language.Indonesian:\n            case Language.Japanese:\n            case Language.Kannada:\n            case Language.Korean:\n            case Language.Malay:\n            case Language.Thai:\n            case Language.Turkish:\n            case Language.Vietnamese:\n                return 0;\n\n            case Language.Bengali:\n            case Language.Bulgarian:\n            case Language.Catalan:\n            case Language.Danish:\n            case Language.German:\n            case Language.Greek:\n            case Language.English:\n            case Language.EnglishAustralia:\n            case Language.EnglishGreatBritain:\n            case Language.EnglishUSA:\n            case Language.Spanish:\n            case Language.SpanishLatinAmericaAndCaribbean:\n            case Language.Estonian:\n            case Language.Persian:\n            case Language.Finnish:\n            case Language.Gujarati:\n            case Language.Hebrew:\n            case Language.Hungarian:\n            case Language.Italian:\n            case Language.Malayalam:\n            case Language.Marathi:\n            case Language.Dutch:\n            case Language.Norwegian:\n            case Language.Swedish:\n            case Language.Swahili:\n            case Language.Tamil:\n            case Language.Telugu:\n            case Language.ChineseChina:\n            case Language.ChineseTaiwan:\n            case Language.PortugueseBrazil:\n            case Language.PortuguesePortugal:\n                return count == 1 ? 0 : 1;\n\n            case Language.Amharic:\n            case Language.Filipino:\n            case Language.French:\n            case Language.Hindi:\n                return count == 0 || count == 1 ? 0 : 1;\n\n            case Language.Croatian:\n            case Language.Russian:\n            case Language.Serbian:\n            case Language.Ukrainian:\n                return count % 10 == 1 && count % 100 != 11\n                    ? 0\n                    : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 10 || count % 100 >= 20)\n                      ? 1\n                      : 2;\n\n            case Language.Czech:\n            case Language.Slovak:\n                return count == 1 ? 0 : count >= 2 && count <= 4 ? 1 : 2;\n\n            case Language.Lithuanian:\n                return count % 10 == 1 && count % 100 != 11\n                    ? 0\n                    : count % 10 >= 2 && (count % 100 < 10 || count % 100 >= 20)\n                      ? 1\n                      : 2;\n\n            case Language.Slovenian:\n                return count % 100 == 1 ? 0 : count % 100 == 2 ? 1 : count % 100 == 3 || count % 100 == 4 ? 2 : 3;\n\n            case Language.Latvian:\n                return count == 0 ? 0 : count % 10 == 1 && count % 100 != 11 ? 1 : 2;\n\n            case Language.Polish:\n                return count == 1\n                    ? 0\n                    : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 12 || count % 100 > 14)\n                      ? 1\n                      : 2;\n\n            case Language.Romanian:\n                return count == 1 ? 0 : count == 0 || (count % 100 > 0 && count % 100 < 20) ? 1 : 2;\n\n            case Language.Arabic:\n                return count == 0\n                    ? 0\n                    : count == 1\n                      ? 1\n                      : count == 2\n                        ? 2\n                        : count % 100 >= 3 && count % 100 <= 10\n                          ? 3\n                          : count % 100 >= 11 && count % 100 <= 99\n                            ? 4\n                            : 5;\n\n            default:\n                return 0;\n        }\n    }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/locale/providers/AbstractLocale.ts"],"sourcesContent":["import {selectPluralForm, applySubstitutions} from \"@shared/locale\";\n\nimport {\n    Language,\n    LanguageNames,\n    LocaleNonPluralKeys,\n    LocalePluralKeys,\n    LocaleProvider,\n    LocaleStructure,\n    LocaleSubstitutionArgs,\n    LocaleSubstitutionValue,\n} from \"@typing/locale\";\n\nexport default abstract class AbstractLocale<S extends object = LocaleStructure> implements LocaleProvider<S> {\n    public abstract lang(): Language;\n\n    public abstract keys(): Set<keyof S>;\n\n    public abstract langs(): ReadonlySet<Language>;\n\n    /** Returns native names for this provider's languages, preserving their order. */\n    public langNames(): ReadonlyMap<Language, string> {\n        return new Map([...this.langs()].map(language => [language, LanguageNames[language]]));\n    }\n\n    protected abstract value(key: keyof S & string): string | undefined;\n\n    public trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string {\n        const [substitutions] = args;\n\n        return this.get(key, substitutions);\n    }\n\n    public choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string {\n        const [substitutions] = args;\n        const message = selectPluralForm(this.get(key), this.lang(), count);\n\n        return this.substitute(message, key, substitutions);\n    }\n\n    public get<K extends keyof S & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string {\n        const template = this.value(key);\n\n        if (template === undefined) {\n            console.warn(`Locale key \"${key}\" not found in \"${this.lang()}\" language.`);\n\n            return key as string;\n        }\n\n        return this.substitute(template, key, substitutions);\n    }\n\n    private substitute(message: string, key: string, substitutions?: Record<string, LocaleSubstitutionValue>): string {\n        return applySubstitutions(message, substitutions, name => {\n            console.warn(`Locale substitution \"${name}\" not found for key \"${key}\" in \"${this.lang()}\" language.`);\n        }).join(\"\");\n    }\n}\n"],"mappings":"AAAA,SAAQ,kBAAkB,0BAAyB;AAEnD;AAAA,EAEI;AAAA,OAOG;AAEP,MAAO,eAAuG;AAAA;AAAA,EAQnG,YAA2C;AAC9C,WAAO,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC,EAAE,IAAI,cAAY,CAAC,UAAU,cAAc,QAAQ,CAAC,CAAC,CAAC;AAAA,EACzF;AAAA,EAIO,MAAwC,QAAW,MAA4C;AAClG,UAAM,CAAC,aAAa,IAAI;AAExB,WAAO,KAAK,IAAI,KAAK,aAAa;AAAA,EACtC;AAAA,EAEO,OAAsC,KAAQ,UAAkB,MAA4C;AAC/G,UAAM,CAAC,aAAa,IAAI;AACxB,UAAM,UAAU,iBAAiB,KAAK,IAAI,GAAG,GAAG,KAAK,KAAK,GAAG,KAAK;AAElE,WAAO,KAAK,WAAW,SAAS,KAAK,aAAa;AAAA,EACtD;AAAA,EAEO,IAAgC,KAAQ,eAAiE;AAC5G,UAAM,WAAW,KAAK,MAAM,GAAG;AAE/B,QAAI,aAAa,QAAW;AACxB,cAAQ,KAAK,eAAe,GAAG,mBAAmB,KAAK,KAAK,CAAC,aAAa;AAE1E,aAAO;AAAA,IACX;AAEA,WAAO,KAAK,WAAW,UAAU,KAAK,aAAa;AAAA,EACvD;AAAA,EAEQ,WAAW,SAAiB,KAAa,eAAiE;AAC9G,WAAO,mBAAmB,SAAS,eAAe,UAAQ;AACtD,cAAQ,KAAK,wBAAwB,IAAI,wBAAwB,GAAG,SAAS,KAAK,KAAK,CAAC,aAAa;AAAA,IACzG,CAAC,EAAE,KAAK,EAAE;AAAA,EACd;AACJ;","names":[]}

package/dist/locale/providers/CustomLocale.d.ts

@@ -1,7 +1,7 @@
 import AbstractLocale from "./AbstractLocale.js";
 import { Language, LocaleStructure } from "../../types/locale.js";
-export type CustomLocaleData = Record<string, string>;
-export default class<T extends object = LocaleStructure> extends AbstractLocale<T> {
+export type CustomLocaleData = Readonly<Record<string, string>>;
+export default class CustomLocale<T extends object = LocaleStructure> extends AbstractLocale<T> {
     protected language: Language;
     protected data: CustomLocaleData;
     constructor(language?: Language, data?: CustomLocaleData);
@@ -9,6 +9,6 @@ export default class<T extends object = LocaleStructure> extends AbstractLocale<
     setData(data: CustomLocaleData): this;
     lang(): Language;
     keys(): Set<keyof T>;
-    languages(): Set<Language>;
+    langs(): ReadonlySet<Language>;
     protected value(key: string): string | undefined;
 }