@xndrjs/i18n 0.7.0 → 0.8.0

package/src/scope-single.ts

@@ -1,85 +0,0 @@
-import type { IcuTranslationProviderSingle } from "./IcuTranslationProviderSingle.js";
-import type { KeyDictionary, LocaleFallbackMap, LocaleOfSingle } from "./types.js";
-import type { ParamArgs } from "./scope-types.js";
-
-/** Type-safe translation scope for a single-namespace schema. */
-export interface I18nScopeSingle<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  RequestLocales extends string = LocaleOfSingle<Schema>,
-> {
-  t<const K extends keyof Schema & string>(
-    key: K,
-    locale: RequestLocales,
-    ...params: ParamArgs<Params[K]>
-  ): string;
-  forLocale<Locale extends RequestLocales>(
-    locale: Locale
-  ): I18nScopeSingleForLocale<Schema, Params, Locale>;
-}
-
-/** Single-namespace scope with a bound locale — `t(key)` and `set(key)` without a locale argument. */
-export interface I18nScopeSingleForLocale<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  Locale extends string,
-> {
-  readonly locale: Locale;
-  t<const K extends keyof Schema & string>(key: K, ...params: ParamArgs<Params[K]>): string;
-  set<const K extends keyof Schema & string>(key: K, template: string): void;
-  forLocale<Next extends Locale>(locale: Next): I18nScopeSingleForLocale<Schema, Params, Next>;
-}
-
-export class I18nScopeSingleImpl<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  RequestLocales extends string,
-  Fallback extends LocaleFallbackMap | undefined,
-> implements I18nScopeSingle<Schema, Params, RequestLocales> {
-  constructor(
-    private readonly engine: IcuTranslationProviderSingle<Schema, Params, RequestLocales, Fallback>
-  ) {}
-
-  t = <const K extends keyof Schema & string>(
-    key: K,
-    locale: RequestLocales,
-    ...args: ParamArgs<Params[K]>
-  ): string => {
-    const params = args[0] as Record<string, unknown> | undefined;
-    return this.engine.getWithLocale(String(key), locale, params);
-  };
-
-  forLocale = <Locale extends RequestLocales>(
-    locale: Locale
-  ): I18nScopeSingleForLocaleImpl<Schema, Params, RequestLocales, Locale, Fallback> => {
-    return new I18nScopeSingleForLocaleImpl(this.engine, locale);
-  };
-}
-
-export class I18nScopeSingleForLocaleImpl<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  RequestLocales extends string,
-  Locale extends RequestLocales,
-  Fallback extends LocaleFallbackMap | undefined,
-> implements I18nScopeSingleForLocale<Schema, Params, Locale> {
-  constructor(
-    private readonly engine: IcuTranslationProviderSingle<Schema, Params, RequestLocales, Fallback>,
-    readonly locale: Locale
-  ) {}
-
-  t = <const K extends keyof Schema & string>(key: K, ...args: ParamArgs<Params[K]>): string => {
-    const params = args[0] as Record<string, unknown> | undefined;
-    return this.engine.getWithLocale(String(key), this.locale, params);
-  };
-
-  set = <const K extends keyof Schema & string>(key: K, template: string): void => {
-    this.engine.patchKey(String(key), this.locale, template);
-  };
-
-  forLocale = <Next extends Locale>(
-    locale: Next
-  ): I18nScopeSingleForLocaleImpl<Schema, Params, RequestLocales, Next, Fallback> => {
-    return new I18nScopeSingleForLocaleImpl(this.engine, locale);
-  };
-}

package/src/single-builder.ts

@@ -1,153 +0,0 @@
-import { invokeNamespaceLoader, type NamespaceLoader } from "./builder-loaders.js";
-import type { I18nEngineSingleImpl } from "./engine.js";
-import type {
-  KeyDictionary,
-  LocaleFallbackMap,
-  LocaleOfSingle,
-  PartialKeyDictionary,
-} from "./types.js";
-import type { I18nScopeSingleForLocale, I18nScopeSingleImpl } from "./scope-single.js";
-
-type SingleScopeBound<
-  Schema extends KeyDictionary,
-  Params,
-  Locale extends string,
-> = I18nScopeSingleForLocale<Schema, Params & { [K in keyof Schema]: unknown }, Locale>;
-
-export type I18nBuilderSingleOptions<
-  Schema extends KeyDictionary,
-  RequestLocales extends string = LocaleOfSingle<Schema>,
-> = {
-  dictionaryLoader?: NamespaceLoader<PartialKeyDictionary<Schema, RequestLocales> | Schema>;
-};
-
-export interface I18nBuilderSingle<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  RequestLocales extends string = LocaleOfSingle<Schema>,
-> {
-  withLocale<Locale extends RequestLocales>(
-    locale: Locale
-  ): I18nBuilderSingleForLocaleImpl<Schema, Params, RequestLocales, Locale>;
-
-  withDeliveryArea<Area extends string>(
-    area: Area
-  ): I18nBuilderSingle<Schema, Params, RequestLocales>;
-
-  load(): Promise<
-    I18nScopeSingleImpl<Schema, Params, RequestLocales, LocaleFallbackMap | undefined>
-  >;
-}
-
-export interface I18nBuilderSingleForLocale<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  Locale extends string,
-> {
-  load(): Promise<SingleScopeBound<Schema, Params, Locale>>;
-}
-
-type SingleBuilderState<
-  Schema extends KeyDictionary,
-  RequestLocales extends string = LocaleOfSingle<Schema>,
-> = {
-  locale?: RequestLocales;
-  deliveryArea?: string;
-};
-
-export class I18nBuilderSingleImpl<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  RequestLocales extends string = LocaleOfSingle<Schema>,
-> implements I18nBuilderSingle<Schema, Params, RequestLocales> {
-  private state: SingleBuilderState<Schema, RequestLocales> = {};
-
-  constructor(
-    private readonly engine: I18nEngineSingleImpl<Schema, Params, RequestLocales>,
-    private readonly options?: I18nBuilderSingleOptions<Schema, RequestLocales>,
-    state?: SingleBuilderState<Schema, RequestLocales>
-  ) {
-    if (state !== undefined) {
-      this.state = {
-        ...(state.locale !== undefined ? { locale: state.locale } : {}),
-        ...(state.deliveryArea !== undefined ? { deliveryArea: state.deliveryArea } : {}),
-      };
-    }
-  }
-
-  private clone(): SingleBuilderState<Schema, RequestLocales> {
-    return {
-      ...(this.state.locale !== undefined ? { locale: this.state.locale } : {}),
-      ...(this.state.deliveryArea !== undefined ? { deliveryArea: this.state.deliveryArea } : {}),
-    };
-  }
-
-  withLocale<Locale extends RequestLocales>(
-    locale: Locale
-  ): I18nBuilderSingleForLocaleImpl<Schema, Params, RequestLocales, Locale> {
-    const { deliveryArea: _deliveryArea, ...rest } = this.clone();
-    return new I18nBuilderSingleForLocaleImpl<Schema, Params, RequestLocales, Locale>(
-      this.engine,
-      this.options,
-      { ...rest, locale }
-    );
-  }
-
-  withDeliveryArea<Area extends string>(
-    _area: Area
-  ): I18nBuilderSingle<Schema, Params, RequestLocales> {
-    const { locale: _locale, ...rest } = this.clone();
-    return new I18nBuilderSingleImpl(this.engine, this.options, {
-      ...rest,
-      deliveryArea: _area,
-    });
-  }
-
-  async load(): Promise<
-    I18nScopeSingleImpl<Schema, Params, RequestLocales, LocaleFallbackMap | undefined>
-  > {
-    await applySingleBuilderLoad(this.engine, this.options, this.state);
-    return this.engine.toScope();
-  }
-}
-
-export class I18nBuilderSingleForLocaleImpl<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  RequestLocales extends string = LocaleOfSingle<Schema>,
-  Locale extends RequestLocales = RequestLocales,
-> implements I18nBuilderSingleForLocale<Schema, Params, Locale> {
-  constructor(
-    private readonly engine: I18nEngineSingleImpl<Schema, Params, RequestLocales>,
-    private readonly options: I18nBuilderSingleOptions<Schema, RequestLocales> | undefined,
-    private readonly state: SingleBuilderState<Schema, RequestLocales> & { locale: Locale }
-  ) {}
-
-  async load(): Promise<SingleScopeBound<Schema, Params, Locale>> {
-    await applySingleBuilderLoad(this.engine, this.options, this.state);
-    return this.engine.toScope({ locale: this.state.locale });
-  }
-}
-
-async function applySingleBuilderLoad<
-  Schema extends KeyDictionary,
-  Params extends { [K in keyof Schema]: unknown },
-  RequestLocales extends string,
->(
-  engine: I18nEngineSingleImpl<Schema, Params, RequestLocales>,
-  options: I18nBuilderSingleOptions<Schema, RequestLocales> | undefined,
-  state: SingleBuilderState<Schema, RequestLocales>
-): Promise<void> {
-  const partition = state.locale ?? state.deliveryArea;
-  const loader = options?.dictionaryLoader;
-
-  if (loader !== undefined) {
-    if (engine.hasBuilderResourceLoaded(partition)) {
-      return;
-    }
-
-    const data = await invokeNamespaceLoader(loader, partition);
-    engine.applyLoadMergeSingle(data);
-    engine.markBuilderResourceLoaded(partition);
-  }
-}