lion/.changeset/four-wolves-do.md

@lion/ui
patch

Side-effect-free alternative for localize (the globally shared instance of LocalizeManager). When this function is imported, no side-effect happened yet, i.e. no global instance was registered yet. The side effect-free approach generates:

• smaller, optimized bundles
• a predictable loading order, that allows for:
  • deduping strategies when multiple instances of the localizeManager are on a page
  • providing a customized extension of LocalizeManager

Also see: https://github.com/ing-bank/lion/discussions/1861

Use it like this:

function myFunction() {
  // note that 'localizeManager' is the same as former 'localize'
  const localizeManager = getLocalizeManger();
  // ...
}

In a class, we advise a shared instance:

class MyClass {
  constructor() {
    this._localizeManager = getLocalizeManger();
  }
  // ...
}

Make sure to always call this method inside a function or class (otherwise side effects are created)

Do you want to register your own LocalizeManager? Make sure it's registered before anyone called getLocalizeManager()

import { singletonManager } from 'singleton-manager';
import { getLocalizeManger } from '@lion/ui/localize-no-side-effects.js';

// First register your own LocalizeManager (for deduping or other reasons)
singletonManager.set('lion/ui::localize::0.x', class MyLocalizeManager extends LocalizeManager {});

// Now, all your code gets the right instance
export function myFn() {
  const localizeManager = getLocalizeManager();
  // ...
}

export class myClass() {
  constructor() {
    this._localizeManager = getLocalizeManager();
    // ...
  }
}