adnbn 0.9.0 → 0.11.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/locale/providers/NativeLocale.ts"],"sourcesContent":["import {getI18nMessage} from \"@addon-core/browser\";\n\nimport AbstractLocale from \"./AbstractLocale\";\n\nimport {convertLocaleKey, resolveLanguage} from \"@locale/utils\";\n\nimport {Language, LocaleCustomKeyForLanguage, LocaleProvider} from \"@typing/locale\";\n\n/** Augmented by the generated .adnbn/locale.d.ts for the current app. */\nexport interface LocaleNativeStructure {}\n\nexport default class NativeLocale<S extends object = LocaleNativeStructure> extends AbstractLocale<S> {\n    private static instance?: LocaleProvider<LocaleNativeStructure>;\n\n    public static getInstance(): LocaleProvider<LocaleNativeStructure> {\n        return (NativeLocale.instance ??= new NativeLocale());\n    }\n\n    private readonly language?: Language;\n\n    constructor() {\n        super();\n\n        /**\n         Locale detection note:\n         Chrome does NOT expose an API to get the effective translation locale.\n         getUILanguage() returns browser UI language (e.g., es-MX),\n         even if extension translations fall back to default_locale (e.g., en).\n         To detect the actual language used by i18n, we read a locale marker\n         from messages.json via chrome.i18n.getMessage().\n         */\n        const markerLang = getI18nMessage(LocaleCustomKeyForLanguage);\n        const resolvedLang = resolveLanguage(markerLang);\n\n        if (!resolvedLang) {\n            console.warn(`[NativeLocale] Unsupported language detected: \"${markerLang}\".`);\n        }\n\n        if (markerLang && resolvedLang && markerLang !== resolvedLang) {\n            console.info(`[NativeLocale] Language normalized: using \"${resolvedLang}\" instead of \"${markerLang}\".`);\n        }\n\n        this.language = resolvedLang;\n    }\n\n    public lang(): Language {\n        if (!this.language) {\n            throw new Error(\"[NativeLocale] Language is not defined. Failed to determine a supported locale.\");\n        }\n\n        return this.language;\n    }\n\n    public keys(): Set<keyof S> {\n        try {\n            // @ts-expect-error: __ADNBN_LOCALE_KEYS__ is a virtual variable generated by the bundler `src/cli/plugins/locale/index.ts`\n            return new Set<string>(__ADNBN_LOCALE_KEYS__) as Set<keyof S>;\n        } catch (e) {\n            console.error(\"[NativeLocale] Failed to access locale keys. Ensure the bundler plugin is active.\", e);\n\n            return new Set<keyof S>();\n        }\n    }\n\n    public languages(): Set<Language> {\n        try {\n            // @ts-expect-error: __ADNBN_DEFINED_LOCALES__ is a virtual variable generated by the bundler `src/cli/plugins/locale/index.ts`\n            return new Set<Language>(__ADNBN_DEFINED_LOCALES__);\n        } catch (e) {\n            console.error(\"[NativeLocale] Failed to access defined locales. Check virtual variables configuration.\", e);\n\n            return new Set<Language>();\n        }\n    }\n\n    protected value(key: Extract<keyof S, string>): string | undefined {\n        const value = getI18nMessage(convertLocaleKey(key));\n\n        // Native i18n returns an empty string for missing messages too; build keys distinguish valid empty translations.\n        if (value === \"\" && !this.keys().has(key)) {\n            return undefined;\n        }\n\n        return value;\n    }\n}\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAE7B,OAAO,oBAAoB;AAE3B,SAAQ,kBAAkB,uBAAsB;AAEhD,SAAkB,kCAAiD;AAKnE,MAAO,qBAA6E,eAAkB;AAAA,EAClG,OAAe;AAAA,EAEf,OAAc,cAAqD;AAC/D,WAAQ,aAAa,aAAb,aAAa,WAAa,IAAI,aAAa;AAAA,EACvD;AAAA,EAEiB;AAAA,EAEjB,cAAc;AACV,UAAM;AAUN,UAAM,aAAa,eAAe,0BAA0B;AAC5D,UAAM,eAAe,gBAAgB,UAAU;AAE/C,QAAI,CAAC,cAAc;AACf,cAAQ,KAAK,kDAAkD,UAAU,IAAI;AAAA,IACjF;AAEA,QAAI,cAAc,gBAAgB,eAAe,cAAc;AAC3D,cAAQ,KAAK,8CAA8C,YAAY,iBAAiB,UAAU,IAAI;AAAA,IAC1G;AAEA,SAAK,WAAW;AAAA,EACpB;AAAA,EAEO,OAAiB;AACpB,QAAI,CAAC,KAAK,UAAU;AAChB,YAAM,IAAI,MAAM,iFAAiF;AAAA,IACrG;AAEA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,OAAqB;AACxB,QAAI;AAEA,aAAO,IAAI,IAAY,qBAAqB;AAAA,IAChD,SAAS,GAAG;AACR,cAAQ,MAAM,qFAAqF,CAAC;AAEpG,aAAO,oBAAI,IAAa;AAAA,IAC5B;AAAA,EACJ;AAAA,EAEO,YAA2B;AAC9B,QAAI;AAEA,aAAO,IAAI,IAAc,yBAAyB;AAAA,IACtD,SAAS,GAAG;AACR,cAAQ,MAAM,2FAA2F,CAAC;AAE1G,aAAO,oBAAI,IAAc;AAAA,IAC7B;AAAA,EACJ;AAAA,EAEU,MAAM,KAAmD;AAC/D,UAAM,QAAQ,eAAe,iBAAiB,GAAG,CAAC;AAGlD,QAAI,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE,IAAI,GAAG,GAAG;AACvC,aAAO;AAAA,IACX;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/locale/providers/NativeLocale.ts"],"sourcesContent":["import {getI18nMessage} from \"@addon-core/browser\";\nimport {keys, languages} from \"#adnbn/locale\";\n\nimport AbstractLocale from \"./AbstractLocale\";\n\nimport {convertLocaleKey, resolveLanguage} from \"@shared/locale\";\n\nimport {Language, LocaleCustomKeyForLanguage, type LocaleRegistry} from \"@typing/locale\";\n\nexport default class NativeLocale<S extends object = LocaleRegistry> extends AbstractLocale<S> {\n    private static instance?: NativeLocale<LocaleRegistry>;\n\n    public static getInstance(): NativeLocale<LocaleRegistry> {\n        return (NativeLocale.instance ??= new NativeLocale());\n    }\n\n    private readonly language?: Language;\n\n    constructor() {\n        super();\n\n        /**\n         Locale detection note:\n         Chrome does NOT expose an API to get the effective translation locale.\n         getUILanguage() returns browser UI language (e.g., es-MX),\n         even if extension translations fall back to default_locale (e.g., en).\n         To detect the actual language used by i18n, we read a locale marker\n         from messages.json via chrome.i18n.getMessage().\n         */\n        const markerLang = getI18nMessage(LocaleCustomKeyForLanguage);\n        const resolvedLang = resolveLanguage(markerLang);\n\n        if (!resolvedLang) {\n            console.warn(`[NativeLocale] Unsupported language detected: \"${markerLang}\".`);\n        }\n\n        if (markerLang && resolvedLang && markerLang !== resolvedLang) {\n            console.info(`[NativeLocale] Language normalized: using \"${resolvedLang}\" instead of \"${markerLang}\".`);\n        }\n\n        this.language = resolvedLang;\n    }\n\n    public lang(): Language {\n        if (!this.language) {\n            throw new Error(\"[NativeLocale] Language is not defined. Failed to determine a supported locale.\");\n        }\n\n        return this.language;\n    }\n\n    public keys(): Set<keyof S> {\n        return new Set(keys) as Set<keyof S>;\n    }\n\n    public langs(): ReadonlySet<Language> {\n        return new Set(languages);\n    }\n\n    protected value(key: Extract<keyof S, string>): string | undefined {\n        const value = getI18nMessage(convertLocaleKey(key));\n\n        // Native i18n returns an empty string for missing messages too; build keys distinguish valid empty translations.\n        if (value === \"\" && !this.keys().has(key)) {\n            return undefined;\n        }\n\n        return value;\n    }\n}\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAC7B,SAAQ,MAAM,iBAAgB;AAE9B,OAAO,oBAAoB;AAE3B,SAAQ,kBAAkB,uBAAsB;AAEhD,SAAkB,kCAAsD;AAExE,MAAO,qBAAsE,eAAkB;AAAA,EAC3F,OAAe;AAAA,EAEf,OAAc,cAA4C;AACtD,WAAQ,aAAa,aAAb,aAAa,WAAa,IAAI,aAAa;AAAA,EACvD;AAAA,EAEiB;AAAA,EAEjB,cAAc;AACV,UAAM;AAUN,UAAM,aAAa,eAAe,0BAA0B;AAC5D,UAAM,eAAe,gBAAgB,UAAU;AAE/C,QAAI,CAAC,cAAc;AACf,cAAQ,KAAK,kDAAkD,UAAU,IAAI;AAAA,IACjF;AAEA,QAAI,cAAc,gBAAgB,eAAe,cAAc;AAC3D,cAAQ,KAAK,8CAA8C,YAAY,iBAAiB,UAAU,IAAI;AAAA,IAC1G;AAEA,SAAK,WAAW;AAAA,EACpB;AAAA,EAEO,OAAiB;AACpB,QAAI,CAAC,KAAK,UAAU;AAChB,YAAM,IAAI,MAAM,iFAAiF;AAAA,IACrG;AAEA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEO,OAAqB;AACxB,WAAO,IAAI,IAAI,IAAI;AAAA,EACvB;AAAA,EAEO,QAA+B;AAClC,WAAO,IAAI,IAAI,SAAS;AAAA,EAC5B;AAAA,EAEU,MAAM,KAAmD;AAC/D,UAAM,QAAQ,eAAe,iBAAiB,GAAG,CAAC;AAGlD,QAAI,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE,IAAI,GAAG,GAAG;AACvC,aAAO;AAAA,IACX;AAEA,WAAO;AAAA,EACX;AACJ;","names":[]}

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

@@ -0,0 +1,35 @@
+import type { Language, LocaleDynamicProvider, LocaleNonPluralKeys, LocalePluralKeys, LocaleRegistry, LocaleSnapshot, LocaleStorageDriver, LocaleSubstitutionArgs, LocaleSubstitutionValue } from "../../types/locale.js";
+/** Dynamic translations with shared instances and subscriptions independent of any UI framework. */
+export default class ObservableLocale<T extends object = LocaleRegistry> implements LocaleDynamicProvider<T> {
+    private static defaultInstance?;
+    private static memoryInstance?;
+    private static readonly drivers;
+    static getInstance(storage?: LocaleStorageDriver | false): ObservableLocale;
+    private readonly locale;
+    private readonly storage?;
+    private readonly listeners;
+    private readonly languages;
+    private readonly languageNames;
+    private currentSnapshot;
+    private revision;
+    private writes;
+    private pendingWrites;
+    private unsubscribe?;
+    constructor(storage?: LocaleStorageDriver | false);
+    lang(): Language;
+    langs(): ReadonlySet<Language>;
+    langNames(): ReadonlyMap<Language, string>;
+    keys(): Set<keyof T>;
+    get<K extends keyof T & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string;
+    trans<K extends LocaleNonPluralKeys<T>>(key: K, ...args: LocaleSubstitutionArgs<T, K>): string;
+    choice<K extends LocalePluralKeys<T>>(key: K, count: number, ...args: LocaleSubstitutionArgs<T, K>): string;
+    readonly snapshot: () => LocaleSnapshot<T>;
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly change: (lang: Language) => Promise<Language>;
+    sync(): Promise<Language>;
+    private connect;
+    private disconnect;
+    private refresh;
+    private createSnapshot;
+    private publish;
+}

package/dist/locale/providers/ObservableLocale.js

@@ -0,0 +1,179 @@
+import DynamicLocale from "./DynamicLocale.js";
+import CustomLocale from "./CustomLocale.js";
+import { LocaleStorage } from "../storage/index.js";
+class ObservableLocale {
+  static defaultInstance;
+  static memoryInstance;
+  static drivers = /* @__PURE__ */ new WeakMap();
+  static getInstance(storage) {
+    if (typeof storage === "object") {
+      let instance = this.drivers.get(storage);
+      if (!instance) {
+        instance = new ObservableLocale(storage);
+        this.drivers.set(storage, instance);
+      }
+      return instance;
+    }
+    if (storage === false) {
+      return this.memoryInstance ?? (this.memoryInstance = new ObservableLocale(false));
+    }
+    return this.defaultInstance ?? (this.defaultInstance = new ObservableLocale());
+  }
+  locale = new DynamicLocale(false);
+  storage;
+  listeners = /* @__PURE__ */ new Set();
+  languages;
+  languageNames;
+  currentSnapshot;
+  revision = 0;
+  writes = Promise.resolve();
+  pendingWrites = 0;
+  unsubscribe;
+  constructor(storage) {
+    this.storage = storage === false ? void 0 : storage ?? new LocaleStorage();
+    this.languages = this.langs();
+    this.languageNames = this.langNames();
+    this.currentSnapshot = this.createSnapshot();
+  }
+  lang() {
+    return this.locale.lang();
+  }
+  langs() {
+    return this.locale.langs();
+  }
+  langNames() {
+    return this.locale.langNames();
+  }
+  keys() {
+    return this.locale.keys();
+  }
+  get(key, substitutions) {
+    return this.locale.get(key, substitutions);
+  }
+  trans(key, ...args) {
+    return this.locale.trans(key, ...args);
+  }
+  choice(key, count, ...args) {
+    return this.locale.choice(key, count, ...args);
+  }
+  snapshot = () => this.currentSnapshot;
+  subscribe = (listener) => {
+    const notify = () => listener();
+    this.listeners.add(notify);
+    try {
+      this.connect();
+    } catch (error) {
+      this.listeners.delete(notify);
+      throw error;
+    }
+    if (this.listeners.size === 1) {
+      void this.refresh();
+    }
+    return () => {
+      this.listeners.delete(notify);
+      this.disconnect();
+    };
+  };
+  change = async (lang) => {
+    this.locale.select(lang);
+    const storage = this.storage;
+    if (!storage) {
+      this.publish();
+      return lang;
+    }
+    this.revision++;
+    this.pendingWrites++;
+    const saved = this.writes.then(() => storage.set(lang));
+    this.writes = saved.catch(() => void 0);
+    this.publish();
+    let succeeded = false;
+    try {
+      await saved;
+      succeeded = true;
+      return lang;
+    } finally {
+      if (--this.pendingWrites === 0 && succeeded) {
+        void this.refresh();
+      }
+    }
+  };
+  async sync() {
+    if (!this.storage) {
+      throw new Error("Language is not saving in storage");
+    }
+    if (this.pendingWrites) {
+      return this.lang();
+    }
+    const revision = ++this.revision;
+    const lang = await this.storage.get();
+    if (revision !== this.revision || this.pendingWrites) {
+      return this.lang();
+    }
+    if (lang === void 0) {
+      return this.lang();
+    }
+    if (!this.langs().has(lang)) {
+      console.warn(`Incorrect language code in storage - "${lang}"`);
+      return this.lang();
+    }
+    this.locale.select(lang);
+    this.publish();
+    return this.lang();
+  }
+  connect() {
+    if (!this.storage || this.unsubscribe) {
+      return;
+    }
+    this.unsubscribe = this.storage.watch(() => {
+      void this.refresh();
+    });
+  }
+  disconnect() {
+    var _a;
+    if (this.listeners.size) {
+      return;
+    }
+    this.revision++;
+    (_a = this.unsubscribe) == null ? void 0 : _a.call(this);
+    this.unsubscribe = void 0;
+  }
+  async refresh() {
+    if (!this.storage || this.pendingWrites) {
+      return;
+    }
+    try {
+      await this.sync();
+    } catch (error) {
+      console.error("[ObservableLocale] Cannot synchronize language:", error);
+    }
+  }
+  createSnapshot() {
+    const lang = this.lang();
+    const langs = this.languages;
+    const langNames = this.languageNames;
+    const reader = new CustomLocale(lang, this.locale.messages());
+    return Object.freeze({
+      lang: () => lang,
+      langs: () => langs,
+      langNames: () => langNames,
+      get: reader.get.bind(reader)
+    });
+  }
+  publish() {
+    if (this.currentSnapshot.lang() === this.lang()) {
+      return;
+    }
+    this.currentSnapshot = this.createSnapshot();
+    for (const listener of [...this.listeners]) {
+      try {
+        listener();
+      } catch (error) {
+        console.error("[ObservableLocale] Language subscriber failed:", error);
+      }
+    }
+  }
+}
+export {
+  ObservableLocale as default
+};
+//# sourceMappingURL=ObservableLocale.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/locale/providers/ObservableLocale.ts"],"sourcesContent":["import DynamicLocale from \"./DynamicLocale\";\nimport CustomLocale from \"./CustomLocale\";\n\nimport {LocaleStorage} from \"../storage\";\n\nimport type {\n    Language,\n    LocaleDynamicProvider,\n    LocaleNonPluralKeys,\n    LocalePluralKeys,\n    LocaleRegistry,\n    LocaleSnapshot,\n    LocaleStorageDriver,\n    LocaleSubstitutionArgs,\n    LocaleSubstitutionValue,\n} from \"@typing/locale\";\n\n/** Dynamic translations with shared instances and subscriptions independent of any UI framework. */\nexport default class ObservableLocale<T extends object = LocaleRegistry> implements LocaleDynamicProvider<T> {\n    private static defaultInstance?: ObservableLocale;\n    private static memoryInstance?: ObservableLocale;\n\n    private static readonly drivers = new WeakMap<LocaleStorageDriver, ObservableLocale>();\n\n    public static getInstance(storage?: LocaleStorageDriver | false): ObservableLocale {\n        if (typeof storage === \"object\") {\n            let instance = this.drivers.get(storage);\n\n            if (!instance) {\n                instance = new ObservableLocale(storage);\n                this.drivers.set(storage, instance);\n            }\n\n            return instance;\n        }\n\n        if (storage === false) {\n            return (this.memoryInstance ??= new ObservableLocale(false));\n        }\n\n        return (this.defaultInstance ??= new ObservableLocale());\n    }\n\n    private readonly locale = new DynamicLocale<T>(false);\n    private readonly storage?: LocaleStorageDriver;\n    private readonly listeners = new Set<() => void>();\n    private readonly languages: ReadonlySet<Language>;\n    private readonly languageNames: ReadonlyMap<Language, string>;\n    private currentSnapshot: LocaleSnapshot<T>;\n    private revision = 0;\n    private writes: Promise<void> = Promise.resolve();\n    private pendingWrites = 0;\n    private unsubscribe?: () => void;\n\n    constructor(storage?: LocaleStorageDriver | false) {\n        this.storage = storage === false ? undefined : (storage ?? new LocaleStorage());\n        this.languages = this.langs();\n        this.languageNames = this.langNames();\n        this.currentSnapshot = this.createSnapshot();\n    }\n\n    public lang(): Language {\n        return this.locale.lang();\n    }\n\n    public langs(): ReadonlySet<Language> {\n        return this.locale.langs();\n    }\n\n    public langNames(): ReadonlyMap<Language, string> {\n        return this.locale.langNames();\n    }\n\n    public keys(): Set<keyof T> {\n        return this.locale.keys();\n    }\n\n    public get<K extends keyof T & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string {\n        return this.locale.get(key, substitutions);\n    }\n\n    public trans<K extends LocaleNonPluralKeys<T>>(key: K, ...args: LocaleSubstitutionArgs<T, K>): string {\n        return this.locale.trans(key, ...args);\n    }\n\n    public choice<K extends LocalePluralKeys<T>>(key: K, count: number, ...args: LocaleSubstitutionArgs<T, K>): string {\n        return this.locale.choice(key, count, ...args);\n    }\n\n    public readonly snapshot = (): LocaleSnapshot<T> => this.currentSnapshot;\n\n    public readonly subscribe = (listener: () => void): (() => void) => {\n        // Each subscription owns its cleanup, even when the same callback is subscribed twice.\n        const notify = () => listener();\n\n        this.listeners.add(notify);\n\n        try {\n            this.connect();\n        } catch (error) {\n            this.listeners.delete(notify);\n            throw error;\n        }\n\n        if (this.listeners.size === 1) {\n            void this.refresh();\n        }\n\n        return () => {\n            this.listeners.delete(notify);\n            this.disconnect();\n        };\n    };\n\n    public readonly change = async (lang: Language): Promise<Language> => {\n        this.locale.select(lang);\n\n        const storage = this.storage;\n\n        if (!storage) {\n            this.publish();\n            return lang;\n        }\n\n        this.revision++;\n\n        // Register persistence before notifying: a subscriber may select another language immediately.\n        this.pendingWrites++;\n\n        const saved = this.writes.then(() => storage.set(lang));\n\n        this.writes = saved.catch(() => undefined);\n\n        this.publish();\n\n        let succeeded = false;\n\n        try {\n            await saved;\n            succeeded = true;\n\n            return lang;\n        } finally {\n            if (--this.pendingWrites === 0 && succeeded) {\n                void this.refresh();\n            }\n        }\n    };\n\n    public async sync(): Promise<Language> {\n        if (!this.storage) {\n            throw new Error(\"Language is not saving in storage\");\n        }\n\n        if (this.pendingWrites) {\n            return this.lang();\n        }\n\n        const revision = ++this.revision;\n        const lang = await this.storage.get();\n\n        if (revision !== this.revision || this.pendingWrites) {\n            return this.lang();\n        }\n\n        if (lang === undefined) {\n            return this.lang();\n        }\n\n        if (!this.langs().has(lang)) {\n            console.warn(`Incorrect language code in storage - \"${lang}\"`);\n\n            return this.lang();\n        }\n\n        this.locale.select(lang);\n\n        this.publish();\n\n        return this.lang();\n    }\n\n    private connect(): void {\n        if (!this.storage || this.unsubscribe) {\n            return;\n        }\n\n        this.unsubscribe = this.storage.watch(() => {\n            void this.refresh();\n        });\n    }\n\n    private disconnect(): void {\n        if (this.listeners.size) {\n            return;\n        }\n\n        this.revision++;\n\n        this.unsubscribe?.();\n        this.unsubscribe = undefined;\n    }\n\n    private async refresh(): Promise<void> {\n        if (!this.storage || this.pendingWrites) {\n            return;\n        }\n\n        try {\n            await this.sync();\n        } catch (error) {\n            console.error(\"[ObservableLocale] Cannot synchronize language:\", error);\n        }\n    }\n\n    private createSnapshot(): LocaleSnapshot<T> {\n        const lang = this.lang();\n        const langs = this.languages;\n        const langNames = this.languageNames;\n\n        const reader = new CustomLocale<T>(lang, this.locale.messages());\n\n        return Object.freeze({\n            lang: () => lang,\n            langs: () => langs,\n            langNames: () => langNames,\n            get: reader.get.bind(reader),\n        });\n    }\n\n    private publish(): void {\n        if (this.currentSnapshot.lang() === this.lang()) {\n            return;\n        }\n\n        this.currentSnapshot = this.createSnapshot();\n\n        for (const listener of [...this.listeners]) {\n            try {\n                listener();\n            } catch (error) {\n                console.error(\"[ObservableLocale] Language subscriber failed:\", error);\n            }\n        }\n    }\n}\n"],"mappings":"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","names":[]}

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

@@ -1,3 +1,4 @@
 export { default as AbstractLocale } from "./AbstractLocale.js";
 export { default as DynamicLocale } from "./DynamicLocale.js";
-export { default as NativeLocale, type LocaleNativeStructure } from "./NativeLocale.js";
+export { default as NativeLocale } from "./NativeLocale.js";
+export { default as ObservableLocale } from "./ObservableLocale.js";

package/dist/locale/providers/index.js

@@ -1,9 +1,11 @@
 import { default as default2 } from "./AbstractLocale.js";
 import { default as default3 } from "./DynamicLocale.js";
 import { default as default4 } from "./NativeLocale.js";
+import { default as default5 } from "./ObservableLocale.js";
 export {
   default2 as AbstractLocale,
   default3 as DynamicLocale,
-  default4 as NativeLocale
+  default4 as NativeLocale,
+  default5 as ObservableLocale
 };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/locale/providers/index.ts"],"sourcesContent":["export {default as AbstractLocale} from \"./AbstractLocale\";\nexport {default as DynamicLocale} from \"./DynamicLocale\";\nexport {default as NativeLocale, type LocaleNativeStructure} from \"./NativeLocale\";\n"],"mappings":"AAAA,SAAmB,WAAXA,gBAAgC;AACxC,SAAmB,WAAXA,gBAA+B;AACvC,SAAmB,WAAXA,gBAA0D;","names":["default"]}
+{"version":3,"sources":["../../../src/locale/providers/index.ts"],"sourcesContent":["export {default as AbstractLocale} from \"./AbstractLocale\";\nexport {default as DynamicLocale} from \"./DynamicLocale\";\nexport {default as NativeLocale} from \"./NativeLocale\";\nexport {default as ObservableLocale} from \"./ObservableLocale\";\n"],"mappings":"AAAA,SAAmB,WAAXA,gBAAgC;AACxC,SAAmB,WAAXA,gBAA+B;AACvC,SAAmB,WAAXA,gBAA8B;AACtC,SAAmB,WAAXA,gBAAkC;","names":["default"]}

package/dist/locale/storage/LocaleStorage.d.ts

@@ -0,0 +1,11 @@
+import { Language, type LocaleStorageDriver } from "../../types/locale.js";
+/** Stores the selected language in extension local storage under the framework namespace. */
+export default class LocaleStorage implements LocaleStorageDriver {
+    protected key: string;
+    private readonly storage;
+    constructor(key?: string);
+    get(): Promise<Language | undefined>;
+    set(lang: Language): Promise<void>;
+    watch(handler: (lang: Language) => void): () => void;
+    private parse;
+}

package/dist/locale/storage/LocaleStorage.js

@@ -0,0 +1,40 @@
+import { Storage } from "@addon-core/storage";
+import { PackageName } from "./../../types/app.js";
+import { LanguageCodes } from "./../../types/locale.js";
+class LocaleStorage {
+  constructor(key = "locale") {
+    this.key = key;
+  }
+  key;
+  storage = Storage.Local({ namespace: PackageName });
+  async get() {
+    return this.parse(await this.storage.get(this.key));
+  }
+  set(lang) {
+    return this.storage.set(this.key, lang);
+  }
+  watch(handler) {
+    return this.storage.watch({
+      [this.key]: (value) => {
+        const lang = this.parse(value);
+        if (lang !== void 0) {
+          handler(lang);
+        }
+      }
+    });
+  }
+  parse(value) {
+    if (value === void 0) {
+      return void 0;
+    }
+    if (typeof value === "string" && LanguageCodes.has(value)) {
+      return value;
+    }
+    console.warn("[LocaleStorage] Invalid language code in storage:", value);
+    return void 0;
+  }
+}
+export {
+  LocaleStorage as default
+};
+//# sourceMappingURL=LocaleStorage.js.map

package/dist/locale/storage/LocaleStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/locale/storage/LocaleStorage.ts"],"sourcesContent":["import {Storage} from \"@addon-core/storage\";\n\nimport {PackageName} from \"@typing/app\";\nimport {Language, LanguageCodes, type LocaleStorageDriver} from \"@typing/locale\";\n\n/** Stores the selected language in extension local storage under the framework namespace. */\nexport default class LocaleStorage implements LocaleStorageDriver {\n    private readonly storage = Storage.Local<Record<string, Language>>({namespace: PackageName});\n\n    constructor(protected key: string = \"locale\") {}\n\n    public async get(): Promise<Language | undefined> {\n        return this.parse(await this.storage.get(this.key));\n    }\n\n    public set(lang: Language): Promise<void> {\n        return this.storage.set(this.key, lang);\n    }\n\n    public watch(handler: (lang: Language) => void): () => void {\n        return this.storage.watch({\n            [this.key]: value => {\n                const lang = this.parse(value);\n\n                if (lang !== undefined) {\n                    handler(lang);\n                }\n            },\n        });\n    }\n\n    private parse(value: unknown): Language | undefined {\n        if (value === undefined) {\n            return undefined;\n        }\n\n        if (typeof value === \"string\" && LanguageCodes.has(value)) {\n            return value as Language;\n        }\n\n        console.warn(\"[LocaleStorage] Invalid language code in storage:\", value);\n\n        return undefined;\n    }\n}\n"],"mappings":"AAAA,SAAQ,eAAc;AAEtB,SAAQ,mBAAkB;AAC1B,SAAkB,qBAA8C;AAGhE,MAAO,cAA2D;AAAA,EAG9D,YAAsB,MAAc,UAAU;AAAxB;AAAA,EAAyB;AAAA,EAAzB;AAAA,EAFL,UAAU,QAAQ,MAAgC,EAAC,WAAW,YAAW,CAAC;AAAA,EAI3F,MAAa,MAAqC;AAC9C,WAAO,KAAK,MAAM,MAAM,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;AAAA,EACtD;AAAA,EAEO,IAAI,MAA+B;AACtC,WAAO,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;AAAA,EAC1C;AAAA,EAEO,MAAM,SAA+C;AACxD,WAAO,KAAK,QAAQ,MAAM;AAAA,MACtB,CAAC,KAAK,GAAG,GAAG,WAAS;AACjB,cAAM,OAAO,KAAK,MAAM,KAAK;AAE7B,YAAI,SAAS,QAAW;AACpB,kBAAQ,IAAI;AAAA,QAChB;AAAA,MACJ;AAAA,IACJ,CAAC;AAAA,EACL;AAAA,EAEQ,MAAM,OAAsC;AAChD,QAAI,UAAU,QAAW;AACrB,aAAO;AAAA,IACX;AAEA,QAAI,OAAO,UAAU,YAAY,cAAc,IAAI,KAAK,GAAG;AACvD,aAAO;AAAA,IACX;AAEA,YAAQ,KAAK,qDAAqD,KAAK;AAEvE,WAAO;AAAA,EACX;AACJ;","names":[]}

package/dist/locale/storage/index.d.ts

@@ -0,0 +1 @@
+export { default as LocaleStorage } from "./LocaleStorage.js";

package/dist/locale/storage/index.js

@@ -0,0 +1,5 @@
+import { default as default2 } from "./LocaleStorage.js";
+export {
+  default2 as LocaleStorage
+};
+//# sourceMappingURL=index.js.map

package/dist/locale/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/locale/storage/index.ts"],"sourcesContent":["export {default as LocaleStorage} from \"./LocaleStorage\";\n"],"mappings":"AAAA,SAAmB,WAAXA,gBAA+B;","names":["default"]}

package/dist/main/entrypoint.d.ts

@@ -0,0 +1,4 @@
+import type { EntrypointAssets, EntrypointAssetsMap } from "../types/entrypoint.js";
+export type { EntrypointAssets, EntrypointAssetsFiles, EntrypointAssetsMap, EntrypointAssetsMapEntry, } from "../types/entrypoint.js";
+export declare const getEntrypointAssetsMap: () => EntrypointAssetsMap;
+export declare const getEntrypointAssets: () => EntrypointAssets;

package/dist/main/entrypoint.js

@@ -0,0 +1,20 @@
+import { readAssets, readAssetsMap } from "#adnbn/entrypoint";
+const getEntrypointAssetsMap = () => {
+  const assets = readAssetsMap();
+  if (!assets) {
+    throw new Error("getEntrypointAssetsMap() is available only in the background entrypoint");
+  }
+  return assets;
+};
+const getEntrypointAssets = () => {
+  const assets = readAssets();
+  if (!assets) {
+    throw new Error("Current entrypoint assets are unavailable in this runtime");
+  }
+  return assets;
+};
+export {
+  getEntrypointAssets,
+  getEntrypointAssetsMap
+};
+//# sourceMappingURL=entrypoint.js.map

package/dist/main/entrypoint.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/main/entrypoint.ts"],"sourcesContent":["import {readAssets, readAssetsMap} from \"#adnbn/entrypoint\";\n\nimport type {EntrypointAssets, EntrypointAssetsMap} from \"@typing/entrypoint\";\n\nexport type {\n    EntrypointAssets,\n    EntrypointAssetsFiles,\n    EntrypointAssetsMap,\n    EntrypointAssetsMapEntry,\n} from \"@typing/entrypoint\";\n\nexport const getEntrypointAssetsMap = (): EntrypointAssetsMap => {\n    const assets = readAssetsMap();\n\n    if (!assets) {\n        throw new Error(\"getEntrypointAssetsMap() is available only in the background entrypoint\");\n    }\n\n    return assets;\n};\n\nexport const getEntrypointAssets = (): EntrypointAssets => {\n    const assets = readAssets();\n\n    if (!assets) {\n        throw new Error(\"Current entrypoint assets are unavailable in this runtime\");\n    }\n\n    return assets;\n};\n"],"mappings":"AAAA,SAAQ,YAAY,qBAAoB;AAWjC,MAAM,yBAAyB,MAA2B;AAC7D,QAAM,SAAS,cAAc;AAE7B,MAAI,CAAC,QAAQ;AACT,UAAM,IAAI,MAAM,yEAAyE;AAAA,EAC7F;AAEA,SAAO;AACX;AAEO,MAAM,sBAAsB,MAAwB;AACvD,QAAM,SAAS,WAAW;AAE1B,MAAI,CAAC,QAAQ;AACT,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC/E;AAEA,SAAO;AACX;","names":[]}

package/dist/main/icon.d.ts

@@ -1,7 +1,6 @@
+import { type IconName, type IconsMap } from "../types/icon.js";
 type Tab = chrome.tabs.Tab;
-export type IconName = string;
-export type IconsMap = Map<IconName, Record<number, string>>;
+export type { IconNameRegistry, IconName, IconsMap } from "../types/icon.js";
 export declare const getIcons: () => IconsMap;
 export declare const changeActionIcon: (icon?: IconName, tab?: number | Tab) => Promise<void>;
 export declare const changeSidebarIcon: (icon?: IconName, tab?: number | Tab) => Promise<void>;
-export {};

package/dist/main/icon.js

@@ -1,9 +1,10 @@
 import { setActionIcon, setSidebarIcon } from "@addon-core/browser";
+import { groups } from "#adnbn/icon";
 import { DefaultIconGroupName } from "./../types/icon.js";
 const getIcons = () => {
   const icons = /* @__PURE__ */ new Map();
   try {
-    Object.entries(__ADNBN_ICONS__).forEach(([key, value]) => {
+    Object.entries(groups).forEach(([key, value]) => {
       icons.set(key, value);
     });
   } catch (e) {

package/dist/main/icon.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/icon.ts"],"sourcesContent":["import {setActionIcon, setSidebarIcon} from \"@addon-core/browser\";\n\nimport {DefaultIconGroupName} from \"@typing/icon\";\n\ntype Tab = chrome.tabs.Tab;\n\nexport type IconName = string;\n\nexport type IconsMap = Map<IconName, Record<number, string>>;\n\nexport const getIcons = (): IconsMap => {\n    const icons: IconsMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_ICONS__ is a virtual variable generated by the bundler `src/cli/plugins/icon/index.ts`\n        Object.entries<Record<number, string>>(__ADNBN_ICONS__).forEach(([key, value]) => {\n            icons.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting icons: \", e);\n    }\n\n    return icons;\n};\n\nexport const changeActionIcon = async (icon?: IconName, tab?: number | Tab): Promise<void> => {\n    if (!icon) {\n        icon = DefaultIconGroupName;\n    }\n\n    const icons = getIcons().get(icon);\n\n    if (!icons) {\n        throw new Error(`Icon group name \"${icon}\" not found for action icon.`);\n    }\n\n    if (tab && typeof tab === \"object\") {\n        tab = tab.id;\n    }\n\n    await setActionIcon({path: icons, tabId: tab});\n};\n\nexport const changeSidebarIcon = async (icon?: IconName, tab?: number | Tab): Promise<void> => {\n    if (!icon) {\n        icon = DefaultIconGroupName;\n    }\n\n    const icons = getIcons().get(icon);\n\n    if (!icons) {\n        throw new Error(`Icon group name \"${icon}\" not found for sidebar icon.`);\n    }\n\n    if (tab && typeof tab === \"object\") {\n        tab = tab.id;\n    }\n\n    await setSidebarIcon({path: icons, tabId: tab});\n};\n"],"mappings":"AAAA,SAAQ,eAAe,sBAAqB;AAE5C,SAAQ,4BAA2B;AAQ5B,MAAM,WAAW,MAAgB;AACpC,QAAM,QAAkB,oBAAI,IAAI;AAEhC,MAAI;AAEA,WAAO,QAAgC,eAAe,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9E,YAAM,IAAI,KAAK,KAAK;AAAA,IACxB,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,0BAA0B,CAAC;AAAA,EAC7C;AAEA,SAAO;AACX;AAEO,MAAM,mBAAmB,OAAO,MAAiB,QAAsC;AAC1F,MAAI,CAAC,MAAM;AACP,WAAO;AAAA,EACX;AAEA,QAAM,QAAQ,SAAS,EAAE,IAAI,IAAI;AAEjC,MAAI,CAAC,OAAO;AACR,UAAM,IAAI,MAAM,oBAAoB,IAAI,8BAA8B;AAAA,EAC1E;AAEA,MAAI,OAAO,OAAO,QAAQ,UAAU;AAChC,UAAM,IAAI;AAAA,EACd;AAEA,QAAM,cAAc,EAAC,MAAM,OAAO,OAAO,IAAG,CAAC;AACjD;AAEO,MAAM,oBAAoB,OAAO,MAAiB,QAAsC;AAC3F,MAAI,CAAC,MAAM;AACP,WAAO;AAAA,EACX;AAEA,QAAM,QAAQ,SAAS,EAAE,IAAI,IAAI;AAEjC,MAAI,CAAC,OAAO;AACR,UAAM,IAAI,MAAM,oBAAoB,IAAI,+BAA+B;AAAA,EAC3E;AAEA,MAAI,OAAO,OAAO,QAAQ,UAAU;AAChC,UAAM,IAAI;AAAA,EACd;AAEA,QAAM,eAAe,EAAC,MAAM,OAAO,OAAO,IAAG,CAAC;AAClD;","names":[]}
+{"version":3,"sources":["../../src/main/icon.ts"],"sourcesContent":["import {setActionIcon, setSidebarIcon} from \"@addon-core/browser\";\nimport {groups} from \"#adnbn/icon\";\n\nimport {DefaultIconGroupName, type IconName, type IconsMap} from \"@typing/icon\";\n\ntype Tab = chrome.tabs.Tab;\n\nexport type {IconNameRegistry, IconName, IconsMap} from \"@typing/icon\";\n\nexport const getIcons = (): IconsMap => {\n    const icons: IconsMap = new Map();\n\n    try {\n        Object.entries(groups).forEach(([key, value]) => {\n            icons.set(key as IconName, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting icons: \", e);\n    }\n\n    return icons;\n};\n\nexport const changeActionIcon = async (icon?: IconName, tab?: number | Tab): Promise<void> => {\n    if (!icon) {\n        icon = DefaultIconGroupName as IconName;\n    }\n\n    const icons = getIcons().get(icon);\n\n    if (!icons) {\n        throw new Error(`Icon group name \"${icon}\" not found for action icon.`);\n    }\n\n    if (tab && typeof tab === \"object\") {\n        tab = tab.id;\n    }\n\n    await setActionIcon({path: icons, tabId: tab});\n};\n\nexport const changeSidebarIcon = async (icon?: IconName, tab?: number | Tab): Promise<void> => {\n    if (!icon) {\n        icon = DefaultIconGroupName as IconName;\n    }\n\n    const icons = getIcons().get(icon);\n\n    if (!icons) {\n        throw new Error(`Icon group name \"${icon}\" not found for sidebar icon.`);\n    }\n\n    if (tab && typeof tab === \"object\") {\n        tab = tab.id;\n    }\n\n    await setSidebarIcon({path: icons, tabId: tab});\n};\n"],"mappings":"AAAA,SAAQ,eAAe,sBAAqB;AAC5C,SAAQ,cAAa;AAErB,SAAQ,4BAAyD;AAM1D,MAAM,WAAW,MAAgB;AACpC,QAAM,QAAkB,oBAAI,IAAI;AAEhC,MAAI;AACA,WAAO,QAAQ,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC7C,YAAM,IAAI,KAAiB,KAAK;AAAA,IACpC,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,0BAA0B,CAAC;AAAA,EAC7C;AAEA,SAAO;AACX;AAEO,MAAM,mBAAmB,OAAO,MAAiB,QAAsC;AAC1F,MAAI,CAAC,MAAM;AACP,WAAO;AAAA,EACX;AAEA,QAAM,QAAQ,SAAS,EAAE,IAAI,IAAI;AAEjC,MAAI,CAAC,OAAO;AACR,UAAM,IAAI,MAAM,oBAAoB,IAAI,8BAA8B;AAAA,EAC1E;AAEA,MAAI,OAAO,OAAO,QAAQ,UAAU;AAChC,UAAM,IAAI;AAAA,EACd;AAEA,QAAM,cAAc,EAAC,MAAM,OAAO,OAAO,IAAG,CAAC;AACjD;AAEO,MAAM,oBAAoB,OAAO,MAAiB,QAAsC;AAC3F,MAAI,CAAC,MAAM;AACP,WAAO;AAAA,EACX;AAEA,QAAM,QAAQ,SAAS,EAAE,IAAI,IAAI;AAEjC,MAAI,CAAC,OAAO;AACR,UAAM,IAAI,MAAM,oBAAoB,IAAI,+BAA+B;AAAA,EAC3E;AAEA,MAAI,OAAO,OAAO,QAAQ,UAAU;AAChC,UAAM,IAAI;AAAA,EACd;AAEA,QAAM,eAAe,EAAC,MAAM,OAAO,OAAO,IAAG,CAAC;AAClD;","names":[]}

package/dist/main/index.d.ts

@@ -5,10 +5,12 @@ export * from "./command.js";
 export * from "./config.js";
 export * from "./content.js";
 export * from "./csp.js";
+export * from "./entrypoint.js";
 export * from "./env.js";
 export * from "./icon.js";
 export * from "./manifest.js";
 export * from "./offscreen.js";
+export * from "./options.js";
 export * from "./page.js";
 export * from "./plugin.js";
 export * from "./popup.js";

package/dist/main/index.js

@@ -5,10 +5,12 @@ export * from "./command.js";
 export * from "./config.js";
 export * from "./content.js";
 export * from "./csp.js";
+export * from "./entrypoint.js";
 export * from "./env.js";
 export * from "./icon.js";
 export * from "./manifest.js";
 export * from "./offscreen.js";
+export * from "./options.js";
 export * from "./page.js";
 export * from "./plugin.js";
 export * from "./popup.js";

package/dist/main/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/index.ts"],"sourcesContent":["export * from \"./app\";\nexport * from \"./background\";\nexport * from \"./browser\";\nexport * from \"./command\";\nexport * from \"./config\";\nexport * from \"./content\";\nexport * from \"./csp\";\nexport * from \"./env\";\nexport * from \"./icon\";\nexport * from \"./manifest\";\nexport * from \"./offscreen\";\nexport * from \"./page\";\nexport * from \"./plugin\";\nexport * from \"./popup\";\nexport * from \"./relay\";\nexport * from \"./sandbox\";\nexport * from \"./service\";\nexport * from \"./sidebar\";\nexport * from \"./view\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../../src/main/index.ts"],"sourcesContent":["export * from \"./app\";\nexport * from \"./background\";\nexport * from \"./browser\";\nexport * from \"./command\";\nexport * from \"./config\";\nexport * from \"./content\";\nexport * from \"./csp\";\nexport * from \"./entrypoint\";\nexport * from \"./env\";\nexport * from \"./icon\";\nexport * from \"./manifest\";\nexport * from \"./offscreen\";\nexport * from \"./options\";\nexport * from \"./page\";\nexport * from \"./plugin\";\nexport * from \"./popup\";\nexport * from \"./relay\";\nexport * from \"./sandbox\";\nexport * from \"./service\";\nexport * from \"./sidebar\";\nexport * from \"./view\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/main/offscreen.d.ts

@@ -1,10 +1,7 @@
-import { type OffscreenDefinition, OffscreenReason, type OffscreenUnresolvedDefinition } from "../types/offscreen.js";
-import type { OffscreenName, OffscreenProxyTarget } from "../offscreen/index.js";
+import { type OffscreenDefinition, type OffscreenMap, type OffscreenName, type OffscreenProxyTarget, OffscreenReason, type OffscreenUnresolvedDefinition } from "../types/offscreen.js";
 import type { TransportType } from "../types/transport.js";
-type OffscreenParameters = chrome.offscreen.CreateParameters;
 export { OffscreenReason, OffscreenDefinition, OffscreenUnresolvedDefinition };
-export type OffscreenAlias = string;
-export type OffscreenMap = Map<OffscreenAlias, OffscreenParameters>;
+export type { OffscreenAlias, OffscreenMap } from "../types/offscreen.js";
 export declare const defineOffscreen: <T extends TransportType>(options: OffscreenDefinition<T>) => OffscreenDefinition<T>;
 export declare const getOffscreens: () => OffscreenMap;
 export declare const getOffscreen: <N extends OffscreenName>(name: N) => OffscreenProxyTarget<N>;

package/dist/main/offscreen.js

@@ -1,12 +1,15 @@
 import ProxyOffscreen from "./../offscreen/providers/ProxyOffscreen.js";
-import { OffscreenReason } from "./../types/offscreen.js";
+import { parameters as offscreenParameters } from "#adnbn/offscreen";
+import {
+  OffscreenReason
+} from "./../types/offscreen.js";
 const defineOffscreen = (options) => {
   return options;
 };
 const getOffscreens = () => {
   const offscreens = /* @__PURE__ */ new Map();
   try {
-    Object.entries(__ADNBN_OFFSCREEN_PARAMETERS__).forEach(([key, value]) => {
+    Object.entries(offscreenParameters).forEach(([key, value]) => {
       offscreens.set(key, value);
     });
   } catch (e) {

package/dist/main/offscreen.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/offscreen.ts"],"sourcesContent":["import ProxyOffscreen from \"@offscreen/providers/ProxyOffscreen\";\n\nimport {type OffscreenDefinition, OffscreenReason, type OffscreenUnresolvedDefinition} from \"@typing/offscreen\";\nimport type {OffscreenName, OffscreenProxyTarget} from \"@offscreen/index\";\nimport type {TransportType} from \"@typing/transport\";\n\ntype OffscreenParameters = chrome.offscreen.CreateParameters;\n\nexport {OffscreenReason, OffscreenDefinition, OffscreenUnresolvedDefinition};\n\nexport type OffscreenAlias = string;\n\nexport type OffscreenMap = Map<OffscreenAlias, OffscreenParameters>;\n\nexport const defineOffscreen = <T extends TransportType>(options: OffscreenDefinition<T>): OffscreenDefinition<T> => {\n    return options;\n};\n\nexport const getOffscreens = (): OffscreenMap => {\n    const offscreens: OffscreenMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_OFFSCREEN_PARAMETERS__ is a virtual variable generated by the bundler `src/cli/plugins/offscreen/index.ts`\n        Object.entries<OffscreenParameters>(__ADNBN_OFFSCREEN_PARAMETERS__).forEach(([key, value]) => {\n            offscreens.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting offscreens: \", e);\n    }\n\n    return offscreens;\n};\n\nexport const getOffscreen = <N extends OffscreenName>(name: N): OffscreenProxyTarget<N> => {\n    const parameters = getOffscreens().get(name);\n\n    if (!parameters) {\n        throw new Error(`Unable to get offscreen: ${name}`);\n    }\n\n    return new ProxyOffscreen(name, parameters).get();\n};\n"],"mappings":"AAAA,OAAO,oBAAoB;AAE3B,SAAkC,uBAA0D;AAYrF,MAAM,kBAAkB,CAA0B,YAA4D;AACjH,SAAO;AACX;AAEO,MAAM,gBAAgB,MAAoB;AAC7C,QAAM,aAA2B,oBAAI,IAAI;AAEzC,MAAI;AAEA,WAAO,QAA6B,8BAA8B,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC1F,iBAAW,IAAI,KAAK,KAAK;AAAA,IAC7B,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,+BAA+B,CAAC;AAAA,EAClD;AAEA,SAAO;AACX;AAEO,MAAM,eAAe,CAA0B,SAAqC;AACvF,QAAM,aAAa,cAAc,EAAE,IAAI,IAAI;AAE3C,MAAI,CAAC,YAAY;AACb,UAAM,IAAI,MAAM,4BAA4B,IAAI,EAAE;AAAA,EACtD;AAEA,SAAO,IAAI,eAAe,MAAM,UAAU,EAAE,IAAI;AACpD;","names":[]}
+{"version":3,"sources":["../../src/main/offscreen.ts"],"sourcesContent":["import ProxyOffscreen from \"@offscreen/providers/ProxyOffscreen\";\nimport {parameters as offscreenParameters} from \"#adnbn/offscreen\";\n\nimport {\n    type OffscreenDefinition,\n    type OffscreenMap,\n    type OffscreenName,\n    type OffscreenProxyTarget,\n    OffscreenReason,\n    type OffscreenUnresolvedDefinition,\n} from \"@typing/offscreen\";\nimport type {TransportType} from \"@typing/transport\";\n\nexport {OffscreenReason, OffscreenDefinition, OffscreenUnresolvedDefinition};\n\nexport type {OffscreenAlias, OffscreenMap} from \"@typing/offscreen\";\n\nexport const defineOffscreen = <T extends TransportType>(options: OffscreenDefinition<T>): OffscreenDefinition<T> => {\n    return options;\n};\n\nexport const getOffscreens = (): OffscreenMap => {\n    const offscreens: OffscreenMap = new Map();\n\n    try {\n        Object.entries(offscreenParameters).forEach(([key, value]) => {\n            offscreens.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting offscreens: \", e);\n    }\n\n    return offscreens;\n};\n\nexport const getOffscreen = <N extends OffscreenName>(name: N): OffscreenProxyTarget<N> => {\n    const parameters = getOffscreens().get(name);\n\n    if (!parameters) {\n        throw new Error(`Unable to get offscreen: ${name}`);\n    }\n\n    return new ProxyOffscreen(name, parameters).get();\n};\n"],"mappings":"AAAA,OAAO,oBAAoB;AAC3B,SAAQ,cAAc,2BAA0B;AAEhD;AAAA,EAKI;AAAA,OAEG;AAOA,MAAM,kBAAkB,CAA0B,YAA4D;AACjH,SAAO;AACX;AAEO,MAAM,gBAAgB,MAAoB;AAC7C,QAAM,aAA2B,oBAAI,IAAI;AAEzC,MAAI;AACA,WAAO,QAAQ,mBAAmB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC1D,iBAAW,IAAI,KAAK,KAAK;AAAA,IAC7B,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,+BAA+B,CAAC;AAAA,EAClD;AAEA,SAAO;AACX;AAEO,MAAM,eAAe,CAA0B,SAAqC;AACvF,QAAM,aAAa,cAAc,EAAE,IAAI,IAAI;AAE3C,MAAI,CAAC,YAAY;AACb,UAAM,IAAI,MAAM,4BAA4B,IAAI,EAAE;AAAA,EACtD;AAEA,SAAO,IAAI,eAAe,MAAM,UAAU,EAAE,IAAI;AACpD;","names":[]}

package/dist/main/options.d.ts

@@ -0,0 +1,3 @@
+import { OptionsConfig, OptionsDefinition, OptionsProps } from "../types/options.js";
+export type { OptionsDefinition, OptionsProps, OptionsConfig };
+export declare const defineOptions: (options: OptionsDefinition) => OptionsDefinition;

package/dist/main/options.js

@@ -0,0 +1,7 @@
+const defineOptions = (options) => {
+  return options;
+};
+export {
+  defineOptions
+};
+//# sourceMappingURL=options.js.map

package/dist/main/options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/main/options.ts"],"sourcesContent":["import {OptionsConfig, OptionsDefinition, OptionsProps} from \"@typing/options\";\n\nexport type {OptionsDefinition, OptionsProps, OptionsConfig};\n\nexport const defineOptions = (options: OptionsDefinition): OptionsDefinition => {\n    return options;\n};\n"],"mappings":"AAIO,MAAM,gBAAgB,CAAC,YAAkD;AAC5E,SAAO;AACX;","names":[]}

package/dist/main/page.d.ts

@@ -1,7 +1,5 @@
-import { PageConfig, PageDefinition, PageProps } from "../types/page.js";
-export type { PageDefinition, PageProps, PageConfig };
-export type PageAlias = string;
-export type PageMap = Map<PageAlias, string>;
+import type { PageAlias, PageDefinition, PageMap } from "../types/page.js";
+export type { PageDefinition, PageProps, PageConfig, PageAliasRegistry, PageAlias, PageMap } from "../types/page.js";
 export declare const definePage: (options: PageDefinition) => PageDefinition;
 export declare const getPages: () => PageMap;
 export declare const getPageUrl: (alias: PageAlias) => string;

package/dist/main/page.js

@@ -1,11 +1,12 @@
 import { getUrl } from "@addon-core/browser";
+import { aliases } from "#adnbn/page";
 const definePage = (options) => {
   return options;
 };
 const getPages = () => {
   const pages = /* @__PURE__ */ new Map();
   try {
-    Object.entries(__ADNBN_PAGE_ALIAS__).forEach(([key, value]) => {
+    Object.entries(aliases).forEach(([key, value]) => {
       pages.set(key, value);
     });
   } catch (e) {

package/dist/main/page.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/main/page.ts"],"sourcesContent":["import {getUrl} from \"@addon-core/browser\";\n\nimport {PageConfig, PageDefinition, PageProps} from \"@typing/page\";\n\nexport type {PageDefinition, PageProps, PageConfig};\n\nexport type PageAlias = string;\n\nexport type PageMap = Map<PageAlias, string>;\n\nexport const definePage = (options: PageDefinition): PageDefinition => {\n    return options;\n};\n\nexport const getPages = (): PageMap => {\n    const pages: PageMap = new Map();\n\n    try {\n        // @ts-expect-error: __ADNBN_PAGE_ALIAS__ is a virtual variable generated by the bundler `src/cli/plugins/page/index.ts`\n        Object.entries<string>(__ADNBN_PAGE_ALIAS__).forEach(([key, value]) => {\n            pages.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting pages: \", e);\n    }\n\n    return pages;\n};\n\nexport const getPageUrl = (alias: PageAlias): string => {\n    let path = getPages().get(alias);\n\n    if (!path) {\n        console.warn(`Cannot find page: ${alias}`);\n\n        path = alias;\n    }\n\n    return getUrl(path);\n};\n"],"mappings":"AAAA,SAAQ,cAAa;AAUd,MAAM,aAAa,CAAC,YAA4C;AACnE,SAAO;AACX;AAEO,MAAM,WAAW,MAAe;AACnC,QAAM,QAAiB,oBAAI,IAAI;AAE/B,MAAI;AAEA,WAAO,QAAgB,oBAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACnE,YAAM,IAAI,KAAK,KAAK;AAAA,IACxB,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,0BAA0B,CAAC;AAAA,EAC7C;AAEA,SAAO;AACX;AAEO,MAAM,aAAa,CAAC,UAA6B;AACpD,MAAI,OAAO,SAAS,EAAE,IAAI,KAAK;AAE/B,MAAI,CAAC,MAAM;AACP,YAAQ,KAAK,qBAAqB,KAAK,EAAE;AAEzC,WAAO;AAAA,EACX;AAEA,SAAO,OAAO,IAAI;AACtB;","names":[]}
+{"version":3,"sources":["../../src/main/page.ts"],"sourcesContent":["import {getUrl} from \"@addon-core/browser\";\nimport {aliases} from \"#adnbn/page\";\n\nimport type {PageAlias, PageDefinition, PageMap} from \"@typing/page\";\n\nexport type {PageDefinition, PageProps, PageConfig, PageAliasRegistry, PageAlias, PageMap} from \"@typing/page\";\n\nexport const definePage = (options: PageDefinition): PageDefinition => {\n    return options;\n};\n\nexport const getPages = (): PageMap => {\n    const pages: PageMap = new Map();\n\n    try {\n        Object.entries(aliases).forEach(([key, value]) => {\n            pages.set(key, value);\n        });\n    } catch (e) {\n        console.error(\"Failed getting pages: \", e);\n    }\n\n    return pages;\n};\n\nexport const getPageUrl = (alias: PageAlias): string => {\n    let path = getPages().get(alias);\n\n    if (!path) {\n        console.warn(`Cannot find page: ${alias}`);\n\n        path = alias;\n    }\n\n    return getUrl(path);\n};\n"],"mappings":"AAAA,SAAQ,cAAa;AACrB,SAAQ,eAAc;AAMf,MAAM,aAAa,CAAC,YAA4C;AACnE,SAAO;AACX;AAEO,MAAM,WAAW,MAAe;AACnC,QAAM,QAAiB,oBAAI,IAAI;AAE/B,MAAI;AACA,WAAO,QAAQ,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AAC9C,YAAM,IAAI,KAAK,KAAK;AAAA,IACxB,CAAC;AAAA,EACL,SAAS,GAAG;AACR,YAAQ,MAAM,0BAA0B,CAAC;AAAA,EAC7C;AAEA,SAAO;AACX;AAEO,MAAM,aAAa,CAAC,UAA6B;AACpD,MAAI,OAAO,SAAS,EAAE,IAAI,KAAK;AAE/B,MAAI,CAAC,MAAM;AACP,YAAQ,KAAK,qBAAqB,KAAK,EAAE;AAEzC,WAAO;AAAA,EACX;AAEA,SAAO,OAAO,IAAI;AACtB;","names":[]}

package/dist/main/popup.d.ts

@@ -1,9 +1,6 @@
-import { PopupDefinition } from "../types/popup.js";
-import { ManifestPopup } from "../types/manifest.js";
+import type { PopupAlias, PopupDefinition, PopupMap } from "../types/popup.js";
 type Tab = chrome.tabs.Tab;
-export type PopupAlias = string;
-export type PopupMap = Map<PopupAlias, ManifestPopup>;
+export type { PopupAliasRegistry, PopupAlias, PopupMap } from "../types/popup.js";
 export declare const definePopup: (options: PopupDefinition) => PopupDefinition;
 export declare const getPopups: () => PopupMap;
 export declare const changePopup: (alias: PopupAlias, tab?: number | Tab) => Promise<void>;
-export {};

package/dist/main/popup.js

@@ -1,5 +1,5 @@
 import { setActionPopup, setActionTitle } from "@addon-core/browser";
-import { resolve } from "./../locale/helpers.js";
+import { aliases } from "#adnbn/popup";
 import { changeActionIcon } from "./icon.js";
 const definePopup = (options) => {
   return options;
@@ -7,7 +7,7 @@ const definePopup = (options) => {
 const getPopups = () => {
   const popups = /* @__PURE__ */ new Map();
   try {
-    Object.entries(__ADNBN_POPUP_MAP__).forEach(([key, value]) => {
+    Object.entries(aliases).forEach(([key, value]) => {
       popups.set(key, value);
     });
   } catch (e) {
@@ -29,7 +29,7 @@ const changePopup = async (alias, tab) => {
   }
   await setActionPopup(path, tab);
   if (title) {
-    await setActionTitle(resolve(title), tab);
+    await setActionTitle(title, tab);
   }
   if (icon) {
     await changeActionIcon(icon, tab);