@aidc-toolkit/utility 0.9.8-beta → 0.9.9-beta

package/dist/index.d.ts

@@ -1,507 +1,5 @@
-import { $NormalizeIntoArray, $Dictionary } from './typescript/helpers.js';
-import { DefaultNamespace, FlatNamespace, InitOptions, Namespace, FormatFunction, Resource, TOptions, InterpolationOptions, ResourceLanguage, ResourceKey } from './typescript/options.js';
-import { TFunction, KeyPrefix } from './typescript/t.js';
 import { I18NEnvironment } from '@aidc-toolkit/core';
-import { Resource as Resource$1 } from 'i18next';
-
-// Internal Helpers
-
-
-interface Interpolator {
-  init(options: InterpolationOptions, reset: boolean): undefined;
-  reset(): undefined;
-  resetRegExp(): undefined;
-  interpolate(str: string, data: object, lng: string, options: InterpolationOptions): string;
-  nest(str: string, fc: (...args: any[]) => any, options: InterpolationOptions): string;
-}
-
-declare class ResourceStore {
-  constructor(data: Resource, options: InitOptions);
-
-  public data: Resource;
-
-  public options: InitOptions;
-
-  /**
-   * Gets fired when resources got added or removed
-   */
-  on(event: 'added' | 'removed', callback: (lng: string, ns: string) => void): void;
-
-  /**
-   * Remove event listener
-   * removes all callback when callback not specified
-   */
-  off(event: 'added' | 'removed', callback?: (lng: string, ns: string) => void): void;
-}
-
-interface Formatter {
-  init(services: Services, i18nextOptions: InitOptions): void;
-  add(name: string, fc: (value: any, lng: string | undefined, options: any) => string): void;
-  addCached(
-    name: string,
-    fc: (lng: string | undefined, options: any) => (value: any) => string,
-  ): void;
-  format: FormatFunction;
-}
-
-interface Services {
-  backendConnector: any;
-  i18nFormat: any;
-  interpolator: Interpolator;
-  languageDetector: any;
-  languageUtils: any;
-  logger: any;
-  pluralResolver: any;
-  resourceStore: ResourceStore;
-  formatter?: Formatter;
-}
-
-type ModuleType =
-  | 'backend'
-  | 'logger'
-  | 'languageDetector'
-  | 'postProcessor'
-  | 'i18nFormat'
-  | 'formatter'
-  | '3rdParty';
-
-interface Module {
-  type: ModuleType;
-}
-
-type CallbackError = Error | string | null | undefined;
-type ReadCallback = (
-  err: CallbackError,
-  data: ResourceKey | boolean | null | undefined,
-) => void;
-type MultiReadCallback = (err: CallbackError, data: Resource | null | undefined) => void;
-
-/**
- * Used to load data for i18next.
- * Can be provided as a singleton or as a prototype constructor (preferred for supporting multiple instances of i18next).
- * For singleton set property `type` to `'backend'` For a prototype constructor set static property.
- */
-interface BackendModule<Options = object> extends Module {
-  type: 'backend';
-  init(services: Services, backendOptions: Options, i18nextOptions: InitOptions): void;
-  read(language: string, namespace: string, callback: ReadCallback): void;
-  /** Save the missing translation */
-  create?(
-    languages: readonly string[],
-    namespace: string,
-    key: string,
-    fallbackValue: string,
-  ): void;
-  /** Load multiple languages and namespaces. For backends supporting multiple resources loading */
-  readMulti?(
-    languages: readonly string[],
-    namespaces: readonly string[],
-    callback: MultiReadCallback,
-  ): void;
-  /** Store the translation. For backends acting as cache layer */
-  save?(language: string, namespace: string, data: ResourceLanguage): void;
-}
-
-/**
- * Used to detect language in user land.
- * Can be provided as a singleton or as a prototype constructor (preferred for supporting multiple instances of i18next).
- * For singleton set property `type` to `'languageDetector'` For a prototype constructor set static property.
- */
-interface LanguageDetectorModule extends Module {
-  type: 'languageDetector';
-  init?(services: Services, detectorOptions: object, i18nextOptions: InitOptions): void;
-  /** Must return detected language */
-  detect(): string | readonly string[] | undefined;
-  cacheUserLanguage?(lng: string): void;
-}
-
-/**
- * Used to detect language in user land.
- * Can be provided as a singleton or as a prototype constructor (preferred for supporting multiple instances of i18next).
- * For singleton set property `type` to `'languageDetector'` For a prototype constructor set static property.
- */
-interface LanguageDetectorAsyncModule extends Module {
-  type: 'languageDetector';
-  /** Set to true to enable async detection */
-  async: true;
-  init?(services: Services, detectorOptions: object, i18nextOptions: InitOptions): void;
-  /** Must call callback passing detected language or return a Promise */
-  detect(
-    callback: (lng: string | readonly string[] | undefined) => void | undefined,
-  ): void | Promise<string | readonly string[] | undefined>;
-  cacheUserLanguage?(lng: string): void | Promise<void>;
-}
-
-/**
- * Override the built-in console logger.
- * Do not need to be a prototype function.
- */
-interface LoggerModule extends Module {
-  type: 'logger';
-  log(...args: any[]): void;
-  warn(...args: any[]): void;
-  error(...args: any[]): void;
-}
-
-interface I18nFormatModule extends Module {
-  type: 'i18nFormat';
-}
-
-interface FormatterModule extends Module, Formatter {
-  type: 'formatter';
-}
-
-interface ThirdPartyModule extends Module {
-  type: '3rdParty';
-  init(i18next: i18n): void;
-}
-
-interface Modules {
-  backend?: BackendModule;
-  logger?: LoggerModule;
-  languageDetector?: LanguageDetectorModule | LanguageDetectorAsyncModule;
-  i18nFormat?: I18nFormatModule;
-  formatter?: FormatterModule;
-  external: ThirdPartyModule[];
-}
-
-// helper to identify class https://stackoverflow.com/a/45983481/2363935
-interface Newable<T> {
-  new (...args: any[]): T;
-}
-interface NewableModule<T extends Module> extends Newable<T> {
-  type: T['type'];
-}
-
-type Callback = (error: any, t: TFunction) => void;
-
-/**
- * Uses similar args as the t function and returns true if a key exists.
- */
-interface ExistsFunction<
-  TKeys extends string = string,
-  TInterpolationMap extends object = $Dictionary,
-> {
-  (key: TKeys | TKeys[], options?: TOptions<TInterpolationMap>): boolean;
-}
-
-interface CloneOptions extends InitOptions {
-  /**
-   * Will create a new instance of the resource store and import the existing translation resources.
-   * This way it will not shared the resource store instance.
-   * @default false
-   */
-  forkResourceStore?: boolean;
-}
-
-interface CustomInstanceExtensions {}
-
-// Used just here to exclude `DefaultNamespace` which can be both string or array from `FlatNamespace`
-// in TFunction declaration below.
-// Due to this only very special usage I'm not moving this inside helpers.
-type InferArrayValuesElseReturnType<T> = T extends (infer A)[] ? A : T;
-
-// eslint-disable-next-line @typescript-eslint/naming-convention
-interface i18n extends CustomInstanceExtensions {
-  // Expose parameterized t in the i18next interface hierarchy
-  t: TFunction<
-    [
-      ...$NormalizeIntoArray<DefaultNamespace>,
-      ...Exclude<FlatNamespace, InferArrayValuesElseReturnType<DefaultNamespace>>[],
-    ]
-  >;
-
-  /**
-   * The default of the i18next module is an i18next instance ready to be initialized by calling init.
-   * You can create additional instances using the createInstance function.
-   *
-   * @param options - Initial options.
-   * @param callback - will be called after all translations were loaded or with an error when failed (in case of using a backend).
-   */
-  init(callback?: Callback): Promise<TFunction>;
-  init<T>(options: InitOptions<T>, callback?: Callback): Promise<TFunction>;
-
-  loadResources(callback?: (err: any) => void): void;
-
-  /**
-   * The use function is there to load additional plugins to i18next.
-   * For available module see the plugins page and don't forget to read the documentation of the plugin.
-   *
-   * @param module Accepts a class or object
-   */
-  use<T extends Module>(module: T | NewableModule<T> | Newable<T>): this;
-
-  /**
-   * List of modules used
-   */
-  modules: Modules;
-
-  /**
-   * Internal container for all used plugins and implementation details like languageUtils, pluralResolvers, etc.
-   */
-  services: Services;
-
-  /**
-   * Internal container for translation resources
-   */
-  store: ResourceStore;
-
-  /**
-   * Uses similar args as the t function and returns true if a key exists.
-   */
-  exists: ExistsFunction;
-
-  /**
-   * Returns a resource data by language.
-   */
-  getDataByLanguage(lng: string): { [key: string]: { [key: string]: string } } | undefined;
-
-  /**
-   * Returns a t function that defaults to given language or namespace.
-   * Both params could be arrays of languages or namespaces and will be treated as fallbacks in that case.
-   * On the returned function you can like in the t function override the languages or namespaces by passing them in options or by prepending namespace.
-   *
-   * Accepts optional keyPrefix that will be automatically applied to returned t function.
-   */
-  getFixedT<
-    Ns extends Namespace | null = DefaultNamespace,
-    TKPrefix extends KeyPrefix<ActualNs> = undefined,
-    ActualNs extends Namespace = Ns extends null ? DefaultNamespace : Ns,
-  >(
-    ...args:
-      | [lng: string | readonly string[], ns?: Ns, keyPrefix?: TKPrefix]
-      | [lng: null, ns: Ns, keyPrefix?: TKPrefix]
-  ): TFunction<ActualNs, TKPrefix>;
-
-  /**
-   * Changes the language. The callback will be called as soon translations were loaded or an error occurs while loading.
-   * HINT: For easy testing - setting lng to 'cimode' will set t function to always return the key.
-   */
-  changeLanguage(lng?: string, callback?: Callback): Promise<TFunction>;
-
-  /**
-   * Is set to the current detected or set language.
-   * If you need the primary used language depending on your configuration (supportedLngs, load) you will prefer using i18next.languages[0].
-   */
-  language: string;
-
-  /**
-   * Is set to an array of language-codes that will be used it order to lookup the translation value.
-   */
-  languages: readonly string[];
-
-  /**
-   * Is set to the current resolved language.
-   * It can be used as primary used language, for example in a language switcher.
-   */
-  resolvedLanguage?: string;
-
-  /**
-   * Checks if namespace has loaded yet.
-   * i.e. used by react-i18next
-   */
-  hasLoadedNamespace(
-    ns: string | readonly string[],
-    options?: {
-      lng?: string | readonly string[];
-      fallbackLng?: InitOptions['fallbackLng'];
-      /**
-       * if `undefined` is returned default checks are performed.
-       */
-      precheck?: (
-        i18n: i18n,
-        /**
-         * Check if the language namespace provided are not in loading status:
-         * returns `true` if load is completed successfully or with an error.
-         */
-        loadNotPending: (
-          lng: string | readonly string[],
-          ns: string | readonly string[],
-        ) => boolean,
-      ) => boolean | undefined;
-    },
-  ): boolean;
-
-  /**
-   * Loads additional namespaces not defined in init options.
-   */
-  loadNamespaces(ns: string | readonly string[], callback?: Callback): Promise<void>;
-
-  /**
-   * Loads additional languages not defined in init options (preload).
-   */
-  loadLanguages(lngs: string | readonly string[], callback?: Callback): Promise<void>;
-
-  /**
-   * Reloads resources on given state. Optionally you can pass an array of languages and namespaces as params if you don't want to reload all.
-   */
-  reloadResources(
-    lngs?: string | readonly string[],
-    ns?: string | readonly string[],
-    callback?: () => void,
-  ): Promise<void>;
-  reloadResources(lngs: null, ns: string | readonly string[], callback?: () => void): Promise<void>;
-
-  /**
-   * Changes the default namespace.
-   */
-  setDefaultNamespace(ns: string | readonly string[]): void;
-
-  /**
-   * Returns rtl or ltr depending on languages read direction.
-   */
-  dir(lng?: string): 'ltr' | 'rtl';
-
-  /**
-   * Exposes interpolation.format function added on init.
-   */
-  format: FormatFunction;
-
-  /**
-   * Will return a new i18next instance.
-   * Please read the options page for details on configuration options.
-   * Providing a callback will automatically call init.
-   * The callback will be called after all translations were loaded or with an error when failed (in case of using a backend).
-   */
-  createInstance(options?: InitOptions, callback?: Callback): i18n;
-
-  /**
-   * Creates a clone of the current instance. Shares store, plugins and initial configuration.
-   * Can be used to create an instance sharing storage but being independent on set language or namespaces.
-   */
-  cloneInstance(options?: CloneOptions, callback?: Callback): i18n;
-
-  /**
-   * Gets fired after initialization.
-   */
-  on(event: 'initialized', callback: (options: InitOptions) => void): void;
-
-  /**
-   * Gets fired on loaded resources.
-   */
-  on(
-    event: 'loaded',
-    callback: (loaded: { [language: string]: { [namespace: string]: boolean } }) => void,
-  ): void;
-
-  /**
-   * Gets fired if loading resources failed.
-   */
-  on(event: 'failedLoading', callback: (lng: string, ns: string, msg: string) => void): void;
-
-  /**
-   * Gets fired on accessing a key not existing.
-   */
-  on(
-    event: 'missingKey',
-    callback: (lngs: readonly string[], namespace: string, key: string, res: string) => void,
-  ): void;
-
-  /**
-   * Gets fired when resources got added or removed.
-   */
-  on(event: 'added' | 'removed', callback: (lng: string, ns: string) => void): void;
-
-  /**
-   * Gets fired when changeLanguage got called.
-   */
-  on(event: 'languageChanged', callback: (lng: string) => void): void;
-
-  /**
-   * Event listener
-   */
-  on(event: string, listener: (...args: any[]) => void): void;
-
-  /**
-   * Remove event listener
-   * removes all callback when callback not specified
-   */
-  off(event: string, listener?: (...args: any[]) => void): void;
-
-  /**
-   * Gets one value by given key.
-   */
-  getResource(
-    lng: string,
-    ns: string,
-    key: string,
-    options?: Pick<InitOptions, 'keySeparator' | 'ignoreJSONStructure'>,
-  ): any;
-
-  /**
-   * Adds one key/value.
-   */
-  addResource(
-    lng: string,
-    ns: string,
-    key: string,
-    value: string,
-    options?: { keySeparator?: string; silent?: boolean },
-  ): i18n;
-
-  /**
-   * Adds multiple key/values.
-   */
-  addResources(lng: string, ns: string, resources: any): i18n;
-
-  /**
-   * Adds a complete bundle.
-   * Setting deep param to true will extend existing translations in that file.
-   * Setting overwrite to true it will overwrite existing translations in that file.
-   */
-  addResourceBundle(
-    lng: string,
-    ns: string,
-    resources: any,
-    deep?: boolean,
-    overwrite?: boolean,
-  ): i18n;
-
-  /**
-   * Checks if a resource bundle exists.
-   */
-  hasResourceBundle(lng: string, ns: string): boolean;
-
-  /**
-   * Returns a resource bundle.
-   */
-  getResourceBundle(lng: string, ns: string): any;
-
-  /**
-   * Removes an existing bundle.
-   */
-  removeResourceBundle(lng: string, ns: string): i18n;
-
-  /**
-   * Current options
-   */
-  options: InitOptions;
-
-  /**
-   * Is initialized
-   */
-  isInitialized: boolean;
-
-  /**
-   * Is initializing
-   */
-  isInitializing: boolean;
-
-  /**
-   * Store was initialized
-   */
-  initializedStoreOnce: boolean;
-
-  /**
-   * Language was initialized
-   */
-  initializedLanguageOnce: boolean;
-
-  /**
-   * Emit event
-   */
-  emit(eventName: string, ...args: any[]): void;
-}
+import { Resource, i18n } from 'i18next';
 
 declare const localeStrings: {
     readonly Transformer: {
@@ -509,8 +7,8 @@ declare const localeStrings: {
         readonly tweakMustBeGreaterThanOrEqualToZero: "Tweak {{tweak}} must be greater than or equal to 0";
         readonly valueMustBeGreaterThanOrEqualToZero: "Value {{value}} must be greater than or equal to 0";
         readonly valueMustBeLessThan: "Value {{value}} must be less than {{domain}}";
-        readonly minValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minValue}} must be greater than or equal to 0";
-        readonly maxValueMustBeLessThan: "Maximum value {{maxValue}} must be less than {{domain}}";
+        readonly minimumValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minimumValue}} must be greater than or equal to 0";
+        readonly maximumValueMustBeLessThan: "Maximum value {{maximumValue}} must be less than {{domain}}";
     };
     readonly RegExpValidator: {
         readonly stringDoesNotMatchPattern: "String {{s}} does not match pattern";
@@ -544,7 +42,7 @@ type UtilityLocaleStrings = typeof localeStrings;
 /**
  * Utility resources.
  */
-declare const utilityResources: Resource$1;
+declare const utilityResources: Resource;
 declare const i18nextUtility: i18n;
 /**
  * Initialize internationalization.
@@ -561,9 +59,9 @@ declare const i18nextUtility: i18n;
 declare function i18nUtilityInit(environment: I18NEnvironment, debug?: boolean): Promise<void>;
 
 /**
- * Sequencer. Defines an ascending or descending sequence of big integers implemented as an iterable.
+ * Sequence. Defines an ascending or descending sequence of big integers implemented as an iterable.
  */
-declare class Sequencer implements Iterable<bigint> {
+declare class Sequence implements Iterable<bigint> {
     /**
      * Start value (inclusive).
      */
@@ -583,11 +81,11 @@ declare class Sequencer implements Iterable<bigint> {
     /**
      * Minimum value (inclusive).
      */
-    private readonly _minValue;
+    private readonly _minimumValue;
     /**
      * Maximum value (inclusive).
      */
-    private readonly _maxValue;
+    private readonly _maximumValue;
     /**
      * Constructor.
      *
@@ -614,11 +112,11 @@ declare class Sequencer implements Iterable<bigint> {
     /**
      * Get the minimum value (inclusive).
      */
-    get minValue(): bigint;
+    get minimumValue(): bigint;
     /**
      * Get the maximum value (inclusive).
      */
-    get maxValue(): bigint;
+    get maximumValue(): bigint;
     /**
      * Iterable implementation.
      *
@@ -629,23 +127,27 @@ declare class Sequencer implements Iterable<bigint> {
 }
 
 /**
- * Transformer input, one of:
+ * Transformer primitive type.
+ */
+type TransformerPrimitive = string | number | bigint | boolean;
+/**
+ * Transformer input type, one of:
  *
- * - T (primitive type)
- * - Iterable<T>
+ * - TInput (primitive type)
+ * - Iterable<TInput>
  *
- * @template T
- * Primitive type.
+ * @template TInput
+ * Transformer input primitive type.
  */
-type TransformerInput<T extends string | number | bigint | boolean> = T | Iterable<T>;
+type TransformerInput<TInput extends TransformerPrimitive> = TInput | Iterable<TInput>;
 /**
  * Transformer callback, used to convert transformed value to its final value.
  *
  * @template TInput
- * Type of input to callback.
+ * Transformer input primitive type.
  *
  * @template TOutput
- * Type of output to callback.
+ * Transformer output type.
  *
  * @param input
  * Input value.
@@ -656,33 +158,33 @@ type TransformerInput<T extends string | number | bigint | boolean> = T | Iterab
  * @returns
  * Output value.
  */
-type TransformerCallback<TInput, TOutput> = (input: TInput, index: number) => TOutput;
+type TransformerCallback<TInput extends TransformerPrimitive, TOutput> = (input: TInput, index: number) => TOutput;
 /**
  * Transformer output, based on transformer input:
  *
- * - If type T is primitive, result is type TOutput.
- * - If type T is Iterable, result is type Iterable<TOutput>.
+ * - If type TTransformerInput is primitive, result is type TOutput.
+ * - If type TTransformerInput is Iterable, result is type Iterable<TOutput>.
  *
- * @template T
+ * @template TTransformerInput
  * Transformer input type.
  *
  * @template TOutput
  * Output base type.
  */
-type TransformerOutput<T extends TransformerInput<string | number | bigint | boolean>, TOutput> = T extends (T extends TransformerInput<infer TInput> ? TInput : never) ? TOutput : Iterable<TOutput>;
+type TransformerOutput<TTransformerInput extends TransformerInput<TransformerPrimitive>, TOutput> = TTransformerInput extends (TTransformerInput extends TransformerInput<infer TInput> ? TInput : never) ? TOutput : Iterable<TOutput>;
 /**
- * Transform an iterable by applying a transformer callback to each entry.
+ * Transform an input iterable to an output iterable that applies a transformer callback to each value in the input.
  *
- * @param iterable
- * Input iterable.
+ * @param values
+ * Input values iterable.
  *
  * @param transformerCallback
  * Callback to transform input value to output value.
  *
  * @returns
- * Output iterable.
+ * Output values iterable.
  */
-declare function transformIterable<TInput, TOutput>(iterable: Iterable<TInput>, transformerCallback: TransformerCallback<TInput, TOutput>): Iterable<TOutput>;
+declare function transformIterable<TInput extends TransformerPrimitive, TOutput>(values: Iterable<TInput>, transformerCallback: TransformerCallback<TInput, TOutput>): Iterable<TOutput>;
 /**
  * Transformer that transforms values in a numeric domain to values in a range equal to the domain or to another range
  * defined by a callback function. In other words, the domain determines valid input values and, without a callback, the
@@ -753,31 +255,57 @@ declare abstract class Transformer {
      * Transformed value.
      */
     protected abstract doForward(value: bigint): bigint;
+    /**
+     * Validate that a value is within the domain and do the work of transforming it forward.
+     *
+     * @param value
+     * Value.
+     *
+     * @returns
+     * Transformed value.
+     */
+    private validateDoForward;
+    /**
+     * Validate that a value is within the domain, do the work of transforming it forward, and apply a callback.
+     *
+     * @param transformerCallback
+     * Called after each value is transformed to convert it to its final value.
+     *
+     * @param value
+     * Value.
+     *
+     * @param index
+     * Index in sequence (0 for single transformation).
+     *
+     * @returns
+     * Transformed value.
+     */
+    private validateDoForwardCallback;
     /**
      * Transform value(s) forward.
      *
-     * @template T
+     * @template TTransformerInput
      * Value(s) input type.
      *
      * @param valueOrValues
-     * Value(s). If this is an instance of {@link Sequencer}, the minimum and maximum values are validated prior to
+     * Value(s). If this is an instance of {@link Sequence}, the minimum and maximum values are validated prior to
      * transformation. Otherwise, the individual value(s) is/are validated at the time of transformation.
      *
      * @returns
      * Transformed value(s).
      */
-    forward<T extends TransformerInput<number | bigint>>(valueOrValues: T): TransformerOutput<T, bigint>;
+    forward<TTransformerInput extends TransformerInput<number | bigint>>(valueOrValues: TTransformerInput): TransformerOutput<TTransformerInput, bigint>;
     /**
      * Transform value(s) forward, optionally applying a transformation.
      *
-     * @template T
+     * @template TTransformerInput
      * Value(s) input type.
      *
-     * @template U
+     * @template TOutput
      * Transformation callback output type.
      *
      * @param valueOrValues
-     * Value(s). If this is an instance of {@link Sequencer}, the minimum and maximum values are validated prior to
+     * Value(s). If this is an instance of {@link Sequence}, the minimum and maximum values are validated prior to
      * transformation. Otherwise, the individual value(s) is/are validated at the time of transformation.
      *
      * @param transformerCallback
@@ -786,7 +314,7 @@ declare abstract class Transformer {
      * @returns
      * Transformed value(s).
      */
-    forward<T extends TransformerInput<number | bigint>, U>(valueOrValues: T, transformerCallback: TransformerCallback<bigint, U>): TransformerOutput<T, U>;
+    forward<TTransformerInput extends TransformerInput<number | bigint>, TOutput>(valueOrValues: TTransformerInput, transformerCallback: TransformerCallback<bigint, TOutput>): TransformerOutput<TTransformerInput, TOutput>;
     /**
      * Do the work of transforming a value in reverse.
      *
@@ -822,10 +350,11 @@ declare class IdentityTransformer extends Transformer {
     protected doReverse(transformedValue: bigint): bigint;
 }
 /**
- * Encryption transformer. Values are transformed using repeated shuffle and xor operations. The underlying operations
- * are similar to those found in many cryptography algorithms, particularly AES. While sufficient for obfuscation of
- * numeric sequences (e.g., serial number generation, below), if true format-preserving encryption is required, a more
- * robust algorithm such as {@link https://doi.org/10.6028/NIST.SP.800-38Gr1-draft | FF1} is recommended.
+ * Encryption transformer. Values are transformed using repeated shuffle and xor operations, similar to those found in
+ * many cryptography algorithms, particularly AES. While sufficient for obfuscation of numeric sequences (e.g., serial
+ * number generation, below), if true format-preserving encryption is required, a more robust algorithm such as
+ * {@link https://doi.org/10.6028/NIST.SP.800-38Gr1-draft | FF1} is recommended. Furthermore, no work has been done to
+ * mitigate {@link https://timing.attacks.cr.yp.to/index.html | timing attacks} for key detection.
  *
  * The purpose of the encryption transformer is to generate pseudo-random values in a deterministic manner to obscure
  * the sequence of values generated over time. A typical example is for serial number generation, where knowledge of the
@@ -854,10 +383,6 @@ declare class EncryptionTransformer extends Transformer {
      * Number of bytes covered by the domain.
      */
     private readonly _domainBytes;
-    /**
-     * Tweak.
-     */
-    private readonly _tweak;
     /**
      * Xor bytes array generated from the domain and tweak.
      */
@@ -884,10 +409,6 @@ declare class EncryptionTransformer extends Transformer {
      * Tweak.
      */
     constructor(domain: number | bigint, tweak: number | bigint);
-    /**
-     * Get the tweak.
-     */
-    get tweak(): bigint;
     /**
      * Convert a value to a byte array big enough to handle the entire domain.
      *
@@ -1385,4 +906,4 @@ declare const ALPHABETIC_CREATOR: CharacterSetCreator;
  */
 declare const ALPHANUMERIC_CREATOR: CharacterSetCreator;
 
-export { ALPHABETIC_CREATOR, ALPHANUMERIC_CREATOR, CharacterSetCreator, type CharacterSetValidation, CharacterSetValidator, EncryptionTransformer, Exclusion, HEXADECIMAL_CREATOR, IdentityTransformer, NUMERIC_CREATOR, RecordValidator, RegExpValidator, Sequencer, type StringValidation, type StringValidator, Transformer, type TransformerCallback, type TransformerInput, type TransformerOutput, type UtilityLocaleStrings, i18nUtilityInit, i18nextUtility, transformIterable, utilityNS, utilityResources };
+export { ALPHABETIC_CREATOR, ALPHANUMERIC_CREATOR, CharacterSetCreator, type CharacterSetValidation, CharacterSetValidator, EncryptionTransformer, Exclusion, HEXADECIMAL_CREATOR, IdentityTransformer, NUMERIC_CREATOR, RecordValidator, RegExpValidator, Sequence, type StringValidation, type StringValidator, Transformer, type TransformerCallback, type TransformerInput, type TransformerOutput, type TransformerPrimitive, type UtilityLocaleStrings, i18nUtilityInit, i18nextUtility, transformIterable, utilityNS, utilityResources };