adnbn 0.9.0 → 0.11.0

package/dist/types/language.d.ts

@@ -0,0 +1,57 @@
+export declare enum Language {
+    Arabic = "ar",
+    Amharic = "am",
+    Bulgarian = "bg",
+    Bengali = "bn",
+    Catalan = "ca",
+    Czech = "cs",
+    Danish = "da",
+    German = "de",
+    Greek = "el",
+    English = "en",
+    EnglishAustralia = "en_AU",
+    EnglishGreatBritain = "en_GB",
+    EnglishUSA = "en_US",
+    Spanish = "es",
+    SpanishLatinAmericaAndCaribbean = "es_419",
+    Estonian = "et",
+    Persian = "fa",
+    Finnish = "fi",
+    Filipino = "fil",
+    French = "fr",
+    Gujarati = "gu",
+    Hebrew = "he",
+    Hindi = "hi",
+    Croatian = "hr",
+    Hungarian = "hu",
+    Indonesian = "id",
+    Italian = "it",
+    Japanese = "ja",
+    Kannada = "kn",
+    Korean = "ko",
+    Lithuanian = "lt",
+    Latvian = "lv",
+    Malayalam = "ml",
+    Marathi = "mr",
+    Malay = "ms",
+    Dutch = "nl",
+    Norwegian = "no",
+    Polish = "pl",
+    PortugueseBrazil = "pt_BR",
+    PortuguesePortugal = "pt_PT",
+    Romanian = "ro",
+    Russian = "ru",
+    Slovak = "sk",
+    Slovenian = "sl",
+    Serbian = "sr",
+    Swedish = "sv",
+    Swahili = "sw",
+    Tamil = "ta",
+    Telugu = "te",
+    Thai = "th",
+    Turkish = "tr",
+    Ukrainian = "uk",
+    Vietnamese = "vi",
+    ChineseChina = "zh_CN",
+    ChineseTaiwan = "zh_TW"
+}

package/dist/types/language.js

@@ -0,0 +1,62 @@
+var Language = /* @__PURE__ */ ((Language2) => {
+  Language2["Arabic"] = "ar";
+  Language2["Amharic"] = "am";
+  Language2["Bulgarian"] = "bg";
+  Language2["Bengali"] = "bn";
+  Language2["Catalan"] = "ca";
+  Language2["Czech"] = "cs";
+  Language2["Danish"] = "da";
+  Language2["German"] = "de";
+  Language2["Greek"] = "el";
+  Language2["English"] = "en";
+  Language2["EnglishAustralia"] = "en_AU";
+  Language2["EnglishGreatBritain"] = "en_GB";
+  Language2["EnglishUSA"] = "en_US";
+  Language2["Spanish"] = "es";
+  Language2["SpanishLatinAmericaAndCaribbean"] = "es_419";
+  Language2["Estonian"] = "et";
+  Language2["Persian"] = "fa";
+  Language2["Finnish"] = "fi";
+  Language2["Filipino"] = "fil";
+  Language2["French"] = "fr";
+  Language2["Gujarati"] = "gu";
+  Language2["Hebrew"] = "he";
+  Language2["Hindi"] = "hi";
+  Language2["Croatian"] = "hr";
+  Language2["Hungarian"] = "hu";
+  Language2["Indonesian"] = "id";
+  Language2["Italian"] = "it";
+  Language2["Japanese"] = "ja";
+  Language2["Kannada"] = "kn";
+  Language2["Korean"] = "ko";
+  Language2["Lithuanian"] = "lt";
+  Language2["Latvian"] = "lv";
+  Language2["Malayalam"] = "ml";
+  Language2["Marathi"] = "mr";
+  Language2["Malay"] = "ms";
+  Language2["Dutch"] = "nl";
+  Language2["Norwegian"] = "no";
+  Language2["Polish"] = "pl";
+  Language2["PortugueseBrazil"] = "pt_BR";
+  Language2["PortuguesePortugal"] = "pt_PT";
+  Language2["Romanian"] = "ro";
+  Language2["Russian"] = "ru";
+  Language2["Slovak"] = "sk";
+  Language2["Slovenian"] = "sl";
+  Language2["Serbian"] = "sr";
+  Language2["Swedish"] = "sv";
+  Language2["Swahili"] = "sw";
+  Language2["Tamil"] = "ta";
+  Language2["Telugu"] = "te";
+  Language2["Thai"] = "th";
+  Language2["Turkish"] = "tr";
+  Language2["Ukrainian"] = "uk";
+  Language2["Vietnamese"] = "vi";
+  Language2["ChineseChina"] = "zh_CN";
+  Language2["ChineseTaiwan"] = "zh_TW";
+  return Language2;
+})(Language || {});
+export {
+  Language
+};
+//# sourceMappingURL=language.js.map

package/dist/types/language.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/language.ts"],"sourcesContent":["export enum Language {\n    Arabic = \"ar\",\n    Amharic = \"am\",\n    Bulgarian = \"bg\",\n    Bengali = \"bn\",\n    Catalan = \"ca\",\n    Czech = \"cs\",\n    Danish = \"da\",\n    German = \"de\",\n    Greek = \"el\",\n    English = \"en\",\n    EnglishAustralia = \"en_AU\",\n    EnglishGreatBritain = \"en_GB\",\n    EnglishUSA = \"en_US\",\n    Spanish = \"es\",\n    SpanishLatinAmericaAndCaribbean = \"es_419\",\n    Estonian = \"et\",\n    Persian = \"fa\",\n    Finnish = \"fi\",\n    Filipino = \"fil\",\n    French = \"fr\",\n    Gujarati = \"gu\",\n    Hebrew = \"he\",\n    Hindi = \"hi\",\n    Croatian = \"hr\",\n    Hungarian = \"hu\",\n    Indonesian = \"id\",\n    Italian = \"it\",\n    Japanese = \"ja\",\n    Kannada = \"kn\",\n    Korean = \"ko\",\n    Lithuanian = \"lt\",\n    Latvian = \"lv\",\n    Malayalam = \"ml\",\n    Marathi = \"mr\",\n    Malay = \"ms\",\n    Dutch = \"nl\",\n    Norwegian = \"no\",\n    Polish = \"pl\",\n    PortugueseBrazil = \"pt_BR\",\n    PortuguesePortugal = \"pt_PT\",\n    Romanian = \"ro\",\n    Russian = \"ru\",\n    Slovak = \"sk\",\n    Slovenian = \"sl\",\n    Serbian = \"sr\",\n    Swedish = \"sv\",\n    Swahili = \"sw\",\n    Tamil = \"ta\",\n    Telugu = \"te\",\n    Thai = \"th\",\n    Turkish = \"tr\",\n    Ukrainian = \"uk\",\n    Vietnamese = \"vi\",\n    ChineseChina = \"zh_CN\",\n    ChineseTaiwan = \"zh_TW\",\n}\n"],"mappings":"AAAO,IAAK,WAAL,kBAAKA,cAAL;AACH,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,sBAAmB;AACnB,EAAAA,UAAA,yBAAsB;AACtB,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,qCAAkC;AAClC,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,sBAAmB;AACnB,EAAAA,UAAA,wBAAqB;AACrB,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,YAAS;AACT,EAAAA,UAAA,UAAO;AACP,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,eAAY;AACZ,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,kBAAe;AACf,EAAAA,UAAA,mBAAgB;AAvDR,SAAAA;AAAA,GAAA;","names":["Language"]}

package/dist/types/locale.d.ts

@@ -1,64 +1,5 @@
-export declare enum Language {
-    Arabic = "ar",
-    Amharic = "am",
-    Bulgarian = "bg",
-    Bengali = "bn",
-    Catalan = "ca",
-    Czech = "cs",
-    Danish = "da",
-    German = "de",
-    Greek = "el",
-    English = "en",
-    EnglishAustralia = "en_AU",
-    EnglishGreatBritain = "en_GB",
-    EnglishUSA = "en_US",
-    Spanish = "es",
-    SpanishLatinAmericaAndCaribbean = "es_419",
-    Estonian = "et",
-    Persian = "fa",
-    Finnish = "fi",
-    Filipino = "fil",
-    French = "fr",
-    Gujarati = "gu",
-    Hebrew = "he",
-    Hindi = "hi",
-    Croatian = "hr",
-    Hungarian = "hu",
-    Indonesian = "id",
-    Italian = "it",
-    Japanese = "ja",
-    Kannada = "kn",
-    Korean = "ko",
-    Lithuanian = "lt",
-    Latvian = "lv",
-    Malayalam = "ml",
-    Marathi = "mr",
-    Malay = "ms",
-    Dutch = "nl",
-    Norwegian = "no",
-    Polish = "pl",
-    PortugueseBrazil = "pt_BR",
-    PortuguesePortugal = "pt_PT",
-    Romanian = "ro",
-    Russian = "ru",
-    Slovak = "sk",
-    Slovenian = "sl",
-    Serbian = "sr",
-    Swedish = "sv",
-    Swahili = "sw",
-    Tamil = "ta",
-    Telugu = "te",
-    Thai = "th",
-    Turkish = "tr",
-    Ukrainian = "uk",
-    Vietnamese = "vi",
-    ChineseChina = "zh_CN",
-    ChineseTaiwan = "zh_TW"
-}
-export declare enum LocaleDir {
-    RightToLeft = "rtl",
-    LeftToRight = "ltr"
-}
+import { Language } from "./language.js";
+export { Language };
 export declare const RtlLanguages: ReadonlySet<Language>;
 export declare const LocaleNestedKeysSeparator = ".";
 export declare const LocaleKeysSeparator = "_";
@@ -69,6 +10,10 @@ export declare const LanguageCodes: ReadonlySet<string>;
 /** Native language names, independent of the selected UI language. */
 export declare const LanguageNames: Readonly<Record<Language, string>>;
 export declare const LocaleFileExtensions: ReadonlySet<string>;
+export declare enum LocaleDir {
+    RightToLeft = "rtl",
+    LeftToRight = "ltr"
+}
 export type LocaleValue = string | number | Array<string | number>;
 export type LocaleData = {
     [key: string]: LocaleValue | LocaleData;
@@ -91,6 +36,8 @@ export interface LocaleBuilder {
     validate(): this;
 }
 export type LocaleBuilders = Map<Language, LocaleBuilder>;
+/** Completed messages keyed by language and browser-compatible message key. */
+export type LocaleCatalogue = Partial<Record<Language, Record<string, string>>>;
 export interface LocaleValidator {
     isValid(locale: LocaleBuilder): boolean;
     validate(locale: LocaleBuilder): this;
@@ -106,6 +53,12 @@ export interface LocaleFutures {
 export interface LocaleStructure {
     [key: string]: LocaleFutures;
 }
+/**
+ * Empty because translation keys and their plural/substitution contracts belong to the consuming application.
+ * Generated `.adnbn/locale.d.ts` declarations populate it by augmenting `adnbn/locale`.
+ */
+export interface LocaleRegistry {
+}
 export type LocaleNonPluralKeys<T> = {
     [K in keyof T]: T[K] extends {
         plural: false;
@@ -123,9 +76,12 @@ export type LocaleSubstitutionKeys<T, K extends keyof T> = T[K] extends {
 export type LocaleSubstitutionsFor<T, K extends keyof T> = [LocaleSubstitutionKeys<T, K>] extends [never] ? never : Record<LocaleSubstitutionKeys<T, K>, LocaleSubstitutionValue>;
 export type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof T ? [substitutions?: Record<string, LocaleSubstitutionValue>] : [LocaleSubstitutionKeys<T, K>] extends [never] ? [] : [substitutions: LocaleSubstitutionsFor<T, K>];
 export interface LocaleProvider<S> {
+    /** Currently selected language code. */
     lang(): Language;
-    languages(): Set<Language>;
-    languageNames(): Map<Language, string>;
+    /** Available language codes. */
+    langs(): ReadonlySet<Language>;
+    /** Native names keyed by the available language codes. */
+    langNames(): ReadonlyMap<Language, string>;
     keys(): ReadonlySet<keyof S>;
     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;
@@ -133,3 +89,18 @@ export interface LocaleProvider<S> {
 export interface LocaleDynamicProvider<S> extends LocaleProvider<S> {
     change(lang: Language): Promise<Language>;
 }
+/** Read-only message access for one selected language. */
+export interface LocaleSnapshot<S> {
+    readonly lang: () => Language;
+    readonly langs: () => ReadonlySet<Language>;
+    readonly langNames: () => ReadonlyMap<Language, string>;
+    readonly get: <K extends keyof S & string>(key: K) => string;
+}
+/** Persists one language selection independently of the application's translation catalogue. */
+export interface LocaleStorageDriver {
+    /** No saved selection leaves the provider's current language unchanged. */
+    get(): Promise<Language | undefined>;
+    set(lang: Language): Promise<void>;
+    /** Observes valid selections, including own writes; does not emit an initial value or deletions. */
+    watch(handler: (lang: Language) => void): () => void;
+}

package/dist/types/locale.js

@@ -1,67 +1,5 @@
-var Language = /* @__PURE__ */ ((Language2) => {
-  Language2["Arabic"] = "ar";
-  Language2["Amharic"] = "am";
-  Language2["Bulgarian"] = "bg";
-  Language2["Bengali"] = "bn";
-  Language2["Catalan"] = "ca";
-  Language2["Czech"] = "cs";
-  Language2["Danish"] = "da";
-  Language2["German"] = "de";
-  Language2["Greek"] = "el";
-  Language2["English"] = "en";
-  Language2["EnglishAustralia"] = "en_AU";
-  Language2["EnglishGreatBritain"] = "en_GB";
-  Language2["EnglishUSA"] = "en_US";
-  Language2["Spanish"] = "es";
-  Language2["SpanishLatinAmericaAndCaribbean"] = "es_419";
-  Language2["Estonian"] = "et";
-  Language2["Persian"] = "fa";
-  Language2["Finnish"] = "fi";
-  Language2["Filipino"] = "fil";
-  Language2["French"] = "fr";
-  Language2["Gujarati"] = "gu";
-  Language2["Hebrew"] = "he";
-  Language2["Hindi"] = "hi";
-  Language2["Croatian"] = "hr";
-  Language2["Hungarian"] = "hu";
-  Language2["Indonesian"] = "id";
-  Language2["Italian"] = "it";
-  Language2["Japanese"] = "ja";
-  Language2["Kannada"] = "kn";
-  Language2["Korean"] = "ko";
-  Language2["Lithuanian"] = "lt";
-  Language2["Latvian"] = "lv";
-  Language2["Malayalam"] = "ml";
-  Language2["Marathi"] = "mr";
-  Language2["Malay"] = "ms";
-  Language2["Dutch"] = "nl";
-  Language2["Norwegian"] = "no";
-  Language2["Polish"] = "pl";
-  Language2["PortugueseBrazil"] = "pt_BR";
-  Language2["PortuguesePortugal"] = "pt_PT";
-  Language2["Romanian"] = "ro";
-  Language2["Russian"] = "ru";
-  Language2["Slovak"] = "sk";
-  Language2["Slovenian"] = "sl";
-  Language2["Serbian"] = "sr";
-  Language2["Swedish"] = "sv";
-  Language2["Swahili"] = "sw";
-  Language2["Tamil"] = "ta";
-  Language2["Telugu"] = "te";
-  Language2["Thai"] = "th";
-  Language2["Turkish"] = "tr";
-  Language2["Ukrainian"] = "uk";
-  Language2["Vietnamese"] = "vi";
-  Language2["ChineseChina"] = "zh_CN";
-  Language2["ChineseTaiwan"] = "zh_TW";
-  return Language2;
-})(Language || {});
-var LocaleDir = /* @__PURE__ */ ((LocaleDir2) => {
-  LocaleDir2["RightToLeft"] = "rtl";
-  LocaleDir2["LeftToRight"] = "ltr";
-  return LocaleDir2;
-})(LocaleDir || {});
-const RtlLanguages = /* @__PURE__ */ new Set(["ar" /* Arabic */, "fa" /* Persian */, "he" /* Hebrew */]);
+import { Language } from "./../types/language.js";
+const RtlLanguages = /* @__PURE__ */ new Set([Language.Arabic, Language.Persian, Language.Hebrew]);
 const LocaleNestedKeysSeparator = ".";
 const LocaleKeysSeparator = "_";
 const LocaleValuesSeparator = "|";
@@ -69,63 +7,68 @@ const LocaleCustomKeyForLanguage = "locale";
 const LocaleKeyMarker = "@";
 const LanguageCodes = new Set(Object.values(Language));
 const LanguageNames = Object.freeze({
-  ["ar" /* Arabic */]: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629",
-  ["am" /* Amharic */]: "\u12A0\u121B\u122D\u129B",
-  ["bg" /* Bulgarian */]: "\u0411\u044A\u043B\u0433\u0430\u0440\u0441\u043A\u0438",
-  ["bn" /* Bengali */]: "\u09AC\u09BE\u0982\u09B2\u09BE",
-  ["ca" /* Catalan */]: "Catal\xE0",
-  ["cs" /* Czech */]: "\u010Ce\u0161tina",
-  ["da" /* Danish */]: "Dansk",
-  ["de" /* German */]: "Deutsch",
-  ["el" /* Greek */]: "\u0395\u03BB\u03BB\u03B7\u03BD\u03B9\u03BA\u03AC",
-  ["en" /* English */]: "English",
-  ["en_AU" /* EnglishAustralia */]: "English (Australia)",
-  ["en_GB" /* EnglishGreatBritain */]: "English (United Kingdom)",
-  ["en_US" /* EnglishUSA */]: "English (United States)",
-  ["es" /* Spanish */]: "Espa\xF1ol",
-  ["es_419" /* SpanishLatinAmericaAndCaribbean */]: "Espa\xF1ol (Latinoam\xE9rica y el Caribe)",
-  ["et" /* Estonian */]: "Eesti",
-  ["fa" /* Persian */]: "\u0641\u0627\u0631\u0633\u06CC",
-  ["fi" /* Finnish */]: "Suomi",
-  ["fil" /* Filipino */]: "Filipino",
-  ["fr" /* French */]: "Fran\xE7ais",
-  ["gu" /* Gujarati */]: "\u0A97\u0AC1\u0A9C\u0AB0\u0ABE\u0AA4\u0AC0",
-  ["he" /* Hebrew */]: "\u05E2\u05D1\u05E8\u05D9\u05EA",
-  ["hi" /* Hindi */]: "\u0939\u093F\u0928\u094D\u0926\u0940",
-  ["hr" /* Croatian */]: "Hrvatski",
-  ["hu" /* Hungarian */]: "Magyar",
-  ["id" /* Indonesian */]: "Bahasa Indonesia",
-  ["it" /* Italian */]: "Italiano",
-  ["ja" /* Japanese */]: "\u65E5\u672C\u8A9E",
-  ["kn" /* Kannada */]: "\u0C95\u0CA8\u0CCD\u0CA8\u0CA1",
-  ["ko" /* Korean */]: "\uD55C\uAD6D\uC5B4",
-  ["lt" /* Lithuanian */]: "Lietuvi\u0173",
-  ["lv" /* Latvian */]: "Latvie\u0161u",
-  ["ml" /* Malayalam */]: "\u0D2E\u0D32\u0D2F\u0D3E\u0D33\u0D02",
-  ["mr" /* Marathi */]: "\u092E\u0930\u093E\u0920\u0940",
-  ["ms" /* Malay */]: "Bahasa Melayu",
-  ["nl" /* Dutch */]: "Nederlands",
-  ["no" /* Norwegian */]: "Norsk",
-  ["pl" /* Polish */]: "Polski",
-  ["pt_BR" /* PortugueseBrazil */]: "Portugu\xEAs (Brasil)",
-  ["pt_PT" /* PortuguesePortugal */]: "Portugu\xEAs (Portugal)",
-  ["ro" /* Romanian */]: "Rom\xE2n\u0103",
-  ["ru" /* Russian */]: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439",
-  ["sk" /* Slovak */]: "Sloven\u010Dina",
-  ["sl" /* Slovenian */]: "Sloven\u0161\u010Dina",
-  ["sr" /* Serbian */]: "\u0421\u0440\u043F\u0441\u043A\u0438",
-  ["sv" /* Swedish */]: "Svenska",
-  ["sw" /* Swahili */]: "Kiswahili",
-  ["ta" /* Tamil */]: "\u0BA4\u0BAE\u0BBF\u0BB4\u0BCD",
-  ["te" /* Telugu */]: "\u0C24\u0C46\u0C32\u0C41\u0C17\u0C41",
-  ["th" /* Thai */]: "\u0E44\u0E17\u0E22",
-  ["tr" /* Turkish */]: "T\xFCrk\xE7e",
-  ["uk" /* Ukrainian */]: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430",
-  ["vi" /* Vietnamese */]: "Ti\u1EBFng Vi\u1EC7t",
-  ["zh_CN" /* ChineseChina */]: "\u4E2D\u6587\uFF08\u7B80\u4F53\uFF09",
-  ["zh_TW" /* ChineseTaiwan */]: "\u4E2D\u6587\uFF08\u7E41\u9AD4\uFF09"
+  [Language.Arabic]: "\u0627\u0644\u0639\u0631\u0628\u064A\u0629",
+  [Language.Amharic]: "\u12A0\u121B\u122D\u129B",
+  [Language.Bulgarian]: "\u0411\u044A\u043B\u0433\u0430\u0440\u0441\u043A\u0438",
+  [Language.Bengali]: "\u09AC\u09BE\u0982\u09B2\u09BE",
+  [Language.Catalan]: "Catal\xE0",
+  [Language.Czech]: "\u010Ce\u0161tina",
+  [Language.Danish]: "Dansk",
+  [Language.German]: "Deutsch",
+  [Language.Greek]: "\u0395\u03BB\u03BB\u03B7\u03BD\u03B9\u03BA\u03AC",
+  [Language.English]: "English",
+  [Language.EnglishAustralia]: "English (Australia)",
+  [Language.EnglishGreatBritain]: "English (United Kingdom)",
+  [Language.EnglishUSA]: "English (United States)",
+  [Language.Spanish]: "Espa\xF1ol",
+  [Language.SpanishLatinAmericaAndCaribbean]: "Espa\xF1ol (Latinoam\xE9rica y el Caribe)",
+  [Language.Estonian]: "Eesti",
+  [Language.Persian]: "\u0641\u0627\u0631\u0633\u06CC",
+  [Language.Finnish]: "Suomi",
+  [Language.Filipino]: "Filipino",
+  [Language.French]: "Fran\xE7ais",
+  [Language.Gujarati]: "\u0A97\u0AC1\u0A9C\u0AB0\u0ABE\u0AA4\u0AC0",
+  [Language.Hebrew]: "\u05E2\u05D1\u05E8\u05D9\u05EA",
+  [Language.Hindi]: "\u0939\u093F\u0928\u094D\u0926\u0940",
+  [Language.Croatian]: "Hrvatski",
+  [Language.Hungarian]: "Magyar",
+  [Language.Indonesian]: "Bahasa Indonesia",
+  [Language.Italian]: "Italiano",
+  [Language.Japanese]: "\u65E5\u672C\u8A9E",
+  [Language.Kannada]: "\u0C95\u0CA8\u0CCD\u0CA8\u0CA1",
+  [Language.Korean]: "\uD55C\uAD6D\uC5B4",
+  [Language.Lithuanian]: "Lietuvi\u0173",
+  [Language.Latvian]: "Latvie\u0161u",
+  [Language.Malayalam]: "\u0D2E\u0D32\u0D2F\u0D3E\u0D33\u0D02",
+  [Language.Marathi]: "\u092E\u0930\u093E\u0920\u0940",
+  [Language.Malay]: "Bahasa Melayu",
+  [Language.Dutch]: "Nederlands",
+  [Language.Norwegian]: "Norsk",
+  [Language.Polish]: "Polski",
+  [Language.PortugueseBrazil]: "Portugu\xEAs (Brasil)",
+  [Language.PortuguesePortugal]: "Portugu\xEAs (Portugal)",
+  [Language.Romanian]: "Rom\xE2n\u0103",
+  [Language.Russian]: "\u0420\u0443\u0441\u0441\u043A\u0438\u0439",
+  [Language.Slovak]: "Sloven\u010Dina",
+  [Language.Slovenian]: "Sloven\u0161\u010Dina",
+  [Language.Serbian]: "\u0421\u0440\u043F\u0441\u043A\u0438",
+  [Language.Swedish]: "Svenska",
+  [Language.Swahili]: "Kiswahili",
+  [Language.Tamil]: "\u0BA4\u0BAE\u0BBF\u0BB4\u0BCD",
+  [Language.Telugu]: "\u0C24\u0C46\u0C32\u0C41\u0C17\u0C41",
+  [Language.Thai]: "\u0E44\u0E17\u0E22",
+  [Language.Turkish]: "T\xFCrk\xE7e",
+  [Language.Ukrainian]: "\u0423\u043A\u0440\u0430\u0457\u043D\u0441\u044C\u043A\u0430",
+  [Language.Vietnamese]: "Ti\u1EBFng Vi\u1EC7t",
+  [Language.ChineseChina]: "\u4E2D\u6587\uFF08\u7B80\u4F53\uFF09",
+  [Language.ChineseTaiwan]: "\u4E2D\u6587\uFF08\u7E41\u9AD4\uFF09"
 });
 const LocaleFileExtensions = /* @__PURE__ */ new Set(["yaml", "yml", "json"]);
+var LocaleDir = /* @__PURE__ */ ((LocaleDir2) => {
+  LocaleDir2["RightToLeft"] = "rtl";
+  LocaleDir2["LeftToRight"] = "ltr";
+  return LocaleDir2;
+})(LocaleDir || {});
 export {
   Language,
   LanguageCodes,

package/dist/types/locale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/locale.ts"],"sourcesContent":["export enum Language {\n    Arabic = \"ar\",\n    Amharic = \"am\",\n    Bulgarian = \"bg\",\n    Bengali = \"bn\",\n    Catalan = \"ca\",\n    Czech = \"cs\",\n    Danish = \"da\",\n    German = \"de\",\n    Greek = \"el\",\n    English = \"en\",\n    EnglishAustralia = \"en_AU\",\n    EnglishGreatBritain = \"en_GB\",\n    EnglishUSA = \"en_US\",\n    Spanish = \"es\",\n    SpanishLatinAmericaAndCaribbean = \"es_419\",\n    Estonian = \"et\",\n    Persian = \"fa\",\n    Finnish = \"fi\",\n    Filipino = \"fil\",\n    French = \"fr\",\n    Gujarati = \"gu\",\n    Hebrew = \"he\",\n    Hindi = \"hi\",\n    Croatian = \"hr\",\n    Hungarian = \"hu\",\n    Indonesian = \"id\",\n    Italian = \"it\",\n    Japanese = \"ja\",\n    Kannada = \"kn\",\n    Korean = \"ko\",\n    Lithuanian = \"lt\",\n    Latvian = \"lv\",\n    Malayalam = \"ml\",\n    Marathi = \"mr\",\n    Malay = \"ms\",\n    Dutch = \"nl\",\n    Norwegian = \"no\",\n    Polish = \"pl\",\n    PortugueseBrazil = \"pt_BR\",\n    PortuguesePortugal = \"pt_PT\",\n    Romanian = \"ro\",\n    Russian = \"ru\",\n    Slovak = \"sk\",\n    Slovenian = \"sl\",\n    Serbian = \"sr\",\n    Swedish = \"sv\",\n    Swahili = \"sw\",\n    Tamil = \"ta\",\n    Telugu = \"te\",\n    Thai = \"th\",\n    Turkish = \"tr\",\n    Ukrainian = \"uk\",\n    Vietnamese = \"vi\",\n    ChineseChina = \"zh_CN\",\n    ChineseTaiwan = \"zh_TW\",\n}\n\nexport enum LocaleDir {\n    RightToLeft = \"rtl\",\n    LeftToRight = \"ltr\",\n}\n\nexport const RtlLanguages: ReadonlySet<Language> = new Set([Language.Arabic, Language.Persian, Language.Hebrew]);\n\nexport const LocaleNestedKeysSeparator = \".\";\n\nexport const LocaleKeysSeparator = \"_\";\n\nexport const LocaleValuesSeparator = \"|\";\n\nexport const LocaleCustomKeyForLanguage = \"locale\";\n\nexport const LocaleKeyMarker = \"@\";\n\nexport const LanguageCodes: ReadonlySet<string> = new Set(Object.values(Language));\n\n/** Native language names, independent of the selected UI language. */\nexport const LanguageNames: Readonly<Record<Language, string>> = Object.freeze({\n    [Language.Arabic]: \"العربية\",\n    [Language.Amharic]: \"አማርኛ\",\n    [Language.Bulgarian]: \"Български\",\n    [Language.Bengali]: \"বাংলা\",\n    [Language.Catalan]: \"Català\",\n    [Language.Czech]: \"Čeština\",\n    [Language.Danish]: \"Dansk\",\n    [Language.German]: \"Deutsch\",\n    [Language.Greek]: \"Ελληνικά\",\n    [Language.English]: \"English\",\n    [Language.EnglishAustralia]: \"English (Australia)\",\n    [Language.EnglishGreatBritain]: \"English (United Kingdom)\",\n    [Language.EnglishUSA]: \"English (United States)\",\n    [Language.Spanish]: \"Español\",\n    [Language.SpanishLatinAmericaAndCaribbean]: \"Español (Latinoamérica y el Caribe)\",\n    [Language.Estonian]: \"Eesti\",\n    [Language.Persian]: \"فارسی\",\n    [Language.Finnish]: \"Suomi\",\n    [Language.Filipino]: \"Filipino\",\n    [Language.French]: \"Français\",\n    [Language.Gujarati]: \"ગુજરાતી\",\n    [Language.Hebrew]: \"עברית\",\n    [Language.Hindi]: \"हिन्दी\",\n    [Language.Croatian]: \"Hrvatski\",\n    [Language.Hungarian]: \"Magyar\",\n    [Language.Indonesian]: \"Bahasa Indonesia\",\n    [Language.Italian]: \"Italiano\",\n    [Language.Japanese]: \"日本語\",\n    [Language.Kannada]: \"ಕನ್ನಡ\",\n    [Language.Korean]: \"한국어\",\n    [Language.Lithuanian]: \"Lietuvių\",\n    [Language.Latvian]: \"Latviešu\",\n    [Language.Malayalam]: \"മലയാളം\",\n    [Language.Marathi]: \"मराठी\",\n    [Language.Malay]: \"Bahasa Melayu\",\n    [Language.Dutch]: \"Nederlands\",\n    [Language.Norwegian]: \"Norsk\",\n    [Language.Polish]: \"Polski\",\n    [Language.PortugueseBrazil]: \"Português (Brasil)\",\n    [Language.PortuguesePortugal]: \"Português (Portugal)\",\n    [Language.Romanian]: \"Română\",\n    [Language.Russian]: \"Русский\",\n    [Language.Slovak]: \"Slovenčina\",\n    [Language.Slovenian]: \"Slovenščina\",\n    [Language.Serbian]: \"Српски\",\n    [Language.Swedish]: \"Svenska\",\n    [Language.Swahili]: \"Kiswahili\",\n    [Language.Tamil]: \"தமிழ்\",\n    [Language.Telugu]: \"తెలుగు\",\n    [Language.Thai]: \"ไทย\",\n    [Language.Turkish]: \"Türkçe\",\n    [Language.Ukrainian]: \"Українська\",\n    [Language.Vietnamese]: \"Tiếng Việt\",\n    [Language.ChineseChina]: \"中文（简体）\",\n    [Language.ChineseTaiwan]: \"中文（繁體）\",\n});\n\nexport const LocaleFileExtensions: ReadonlySet<string> = new Set([\"yaml\", \"yml\", \"json\"]);\n\nexport type LocaleValue = string | number | Array<string | number>;\n\nexport type LocaleData = {\n    [key: string]: LocaleValue | LocaleData;\n};\n\nexport type LocaleItems = Map<string, string>;\n\nexport type LocaleKeys = ReadonlySet<string>;\n\nexport type LocaleMessages = {\n    [key: string]: {\n        message: string;\n    };\n};\n\nexport interface LocaleBuilder {\n    lang(): Language;\n\n    merge(data: LocaleData): this;\n\n    build(): LocaleMessages;\n\n    get(): LocaleItems;\n\n    keys(): LocaleKeys;\n\n    structure(): LocaleStructure;\n\n    isValid(): boolean;\n\n    validate(): this;\n}\n\nexport type LocaleBuilders = Map<Language, LocaleBuilder>;\n\nexport interface LocaleValidator {\n    isValid(locale: LocaleBuilder): boolean;\n\n    validate(locale: LocaleBuilder): this;\n}\n\nexport interface LocaleContractValidator {\n    isValid(builders: LocaleBuilders): boolean;\n\n    validate(builders: LocaleBuilders): this;\n}\n\nexport interface LocaleFutures {\n    plural: boolean;\n    substitutions: readonly string[];\n}\n\nexport interface LocaleStructure {\n    [key: string]: LocaleFutures;\n}\n\nexport type LocaleNonPluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: false} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocalePluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: true} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocaleSubstitutionValue = string | number;\n\nexport type LocaleSubstitutionKeys<T, K extends keyof T> = T[K] extends {substitutions: readonly (infer U)[]}\n    ? U & string\n    : never;\n\nexport type LocaleSubstitutionsFor<T, K extends keyof T> = [LocaleSubstitutionKeys<T, K>] extends [never]\n    ? never\n    : Record<LocaleSubstitutionKeys<T, K>, LocaleSubstitutionValue>;\n\nexport type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof T\n    ? [substitutions?: Record<string, LocaleSubstitutionValue>]\n    : [LocaleSubstitutionKeys<T, K>] extends [never]\n      ? []\n      : [substitutions: LocaleSubstitutionsFor<T, K>];\n\nexport interface LocaleProvider<S> {\n    lang(): Language;\n\n    languages(): Set<Language>;\n\n    languageNames(): Map<Language, string>;\n\n    keys(): ReadonlySet<keyof S>;\n\n    // non-plural keys\n    trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    // plural keys\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n}\n\nexport interface LocaleDynamicProvider<S> extends LocaleProvider<S> {\n    change(lang: Language): Promise<Language>;\n}\n"],"mappings":"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","names":["Language","LocaleDir"]}
+{"version":3,"sources":["../../src/types/locale.ts"],"sourcesContent":["import {Language} from \"@typing/language\";\n\nexport {Language};\n\nexport const RtlLanguages: ReadonlySet<Language> = new Set([Language.Arabic, Language.Persian, Language.Hebrew]);\n\nexport const LocaleNestedKeysSeparator = \".\";\n\nexport const LocaleKeysSeparator = \"_\";\n\nexport const LocaleValuesSeparator = \"|\";\n\nexport const LocaleCustomKeyForLanguage = \"locale\";\n\nexport const LocaleKeyMarker = \"@\";\n\nexport const LanguageCodes: ReadonlySet<string> = new Set(Object.values(Language));\n\n/** Native language names, independent of the selected UI language. */\nexport const LanguageNames: Readonly<Record<Language, string>> = Object.freeze({\n    [Language.Arabic]: \"العربية\",\n    [Language.Amharic]: \"አማርኛ\",\n    [Language.Bulgarian]: \"Български\",\n    [Language.Bengali]: \"বাংলা\",\n    [Language.Catalan]: \"Català\",\n    [Language.Czech]: \"Čeština\",\n    [Language.Danish]: \"Dansk\",\n    [Language.German]: \"Deutsch\",\n    [Language.Greek]: \"Ελληνικά\",\n    [Language.English]: \"English\",\n    [Language.EnglishAustralia]: \"English (Australia)\",\n    [Language.EnglishGreatBritain]: \"English (United Kingdom)\",\n    [Language.EnglishUSA]: \"English (United States)\",\n    [Language.Spanish]: \"Español\",\n    [Language.SpanishLatinAmericaAndCaribbean]: \"Español (Latinoamérica y el Caribe)\",\n    [Language.Estonian]: \"Eesti\",\n    [Language.Persian]: \"فارسی\",\n    [Language.Finnish]: \"Suomi\",\n    [Language.Filipino]: \"Filipino\",\n    [Language.French]: \"Français\",\n    [Language.Gujarati]: \"ગુજરાતી\",\n    [Language.Hebrew]: \"עברית\",\n    [Language.Hindi]: \"हिन्दी\",\n    [Language.Croatian]: \"Hrvatski\",\n    [Language.Hungarian]: \"Magyar\",\n    [Language.Indonesian]: \"Bahasa Indonesia\",\n    [Language.Italian]: \"Italiano\",\n    [Language.Japanese]: \"日本語\",\n    [Language.Kannada]: \"ಕನ್ನಡ\",\n    [Language.Korean]: \"한국어\",\n    [Language.Lithuanian]: \"Lietuvių\",\n    [Language.Latvian]: \"Latviešu\",\n    [Language.Malayalam]: \"മലയാളം\",\n    [Language.Marathi]: \"मराठी\",\n    [Language.Malay]: \"Bahasa Melayu\",\n    [Language.Dutch]: \"Nederlands\",\n    [Language.Norwegian]: \"Norsk\",\n    [Language.Polish]: \"Polski\",\n    [Language.PortugueseBrazil]: \"Português (Brasil)\",\n    [Language.PortuguesePortugal]: \"Português (Portugal)\",\n    [Language.Romanian]: \"Română\",\n    [Language.Russian]: \"Русский\",\n    [Language.Slovak]: \"Slovenčina\",\n    [Language.Slovenian]: \"Slovenščina\",\n    [Language.Serbian]: \"Српски\",\n    [Language.Swedish]: \"Svenska\",\n    [Language.Swahili]: \"Kiswahili\",\n    [Language.Tamil]: \"தமிழ்\",\n    [Language.Telugu]: \"తెలుగు\",\n    [Language.Thai]: \"ไทย\",\n    [Language.Turkish]: \"Türkçe\",\n    [Language.Ukrainian]: \"Українська\",\n    [Language.Vietnamese]: \"Tiếng Việt\",\n    [Language.ChineseChina]: \"中文（简体）\",\n    [Language.ChineseTaiwan]: \"中文（繁體）\",\n});\n\nexport const LocaleFileExtensions: ReadonlySet<string> = new Set([\"yaml\", \"yml\", \"json\"]);\n\nexport enum LocaleDir {\n    RightToLeft = \"rtl\",\n    LeftToRight = \"ltr\",\n}\n\nexport type LocaleValue = string | number | Array<string | number>;\n\nexport type LocaleData = {\n    [key: string]: LocaleValue | LocaleData;\n};\n\nexport type LocaleItems = Map<string, string>;\n\nexport type LocaleKeys = ReadonlySet<string>;\n\nexport type LocaleMessages = {\n    [key: string]: {\n        message: string;\n    };\n};\n\nexport interface LocaleBuilder {\n    lang(): Language;\n\n    merge(data: LocaleData): this;\n\n    build(): LocaleMessages;\n\n    get(): LocaleItems;\n\n    keys(): LocaleKeys;\n\n    structure(): LocaleStructure;\n\n    isValid(): boolean;\n\n    validate(): this;\n}\n\nexport type LocaleBuilders = Map<Language, LocaleBuilder>;\n\n/** Completed messages keyed by language and browser-compatible message key. */\nexport type LocaleCatalogue = Partial<Record<Language, Record<string, string>>>;\n\nexport interface LocaleValidator {\n    isValid(locale: LocaleBuilder): boolean;\n\n    validate(locale: LocaleBuilder): this;\n}\n\nexport interface LocaleContractValidator {\n    isValid(builders: LocaleBuilders): boolean;\n\n    validate(builders: LocaleBuilders): this;\n}\n\nexport interface LocaleFutures {\n    plural: boolean;\n    substitutions: readonly string[];\n}\n\nexport interface LocaleStructure {\n    [key: string]: LocaleFutures;\n}\n\n/**\n * Empty because translation keys and their plural/substitution contracts belong to the consuming application.\n * Generated `.adnbn/locale.d.ts` declarations populate it by augmenting `adnbn/locale`.\n */\nexport interface LocaleRegistry {}\n\nexport type LocaleNonPluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: false} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocalePluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: true} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocaleSubstitutionValue = string | number;\n\nexport type LocaleSubstitutionKeys<T, K extends keyof T> = T[K] extends {substitutions: readonly (infer U)[]}\n    ? U & string\n    : never;\n\nexport type LocaleSubstitutionsFor<T, K extends keyof T> = [LocaleSubstitutionKeys<T, K>] extends [never]\n    ? never\n    : Record<LocaleSubstitutionKeys<T, K>, LocaleSubstitutionValue>;\n\nexport type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof T\n    ? [substitutions?: Record<string, LocaleSubstitutionValue>]\n    : [LocaleSubstitutionKeys<T, K>] extends [never]\n      ? []\n      : [substitutions: LocaleSubstitutionsFor<T, K>];\n\nexport interface LocaleProvider<S> {\n    /** Currently selected language code. */\n    lang(): Language;\n\n    /** Available language codes. */\n    langs(): ReadonlySet<Language>;\n\n    /** Native names keyed by the available language codes. */\n    langNames(): ReadonlyMap<Language, string>;\n\n    keys(): ReadonlySet<keyof S>;\n\n    // non-plural keys\n    trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    // plural keys\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n}\n\nexport interface LocaleDynamicProvider<S> extends LocaleProvider<S> {\n    change(lang: Language): Promise<Language>;\n}\n\n/** Read-only message access for one selected language. */\nexport interface LocaleSnapshot<S> {\n    readonly lang: () => Language;\n    readonly langs: () => ReadonlySet<Language>;\n    readonly langNames: () => ReadonlyMap<Language, string>;\n    readonly get: <K extends keyof S & string>(key: K) => string;\n}\n\n/** Persists one language selection independently of the application's translation catalogue. */\nexport interface LocaleStorageDriver {\n    /** No saved selection leaves the provider's current language unchanged. */\n    get(): Promise<Language | undefined>;\n\n    set(lang: Language): Promise<void>;\n\n    /** Observes valid selections, including own writes; does not emit an initial value or deletions. */\n    watch(handler: (lang: Language) => void): () => void;\n}\n"],"mappings":"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","names":["LocaleDir"]}

package/dist/types/manifest.d.ts

@@ -5,12 +5,17 @@ import { Language } from "./locale.js";
 import { BrowserSpecific, DataCollectionPermission } from "./browser.js";
 import { CspConfig } from "./csp.js";
 import { SandboxCspConfig } from "./sandbox.js";
+export declare const ManifestMatchSchemes: ReadonlySet<string>;
+export declare const ManifestSpecialSchemes: ReadonlySet<string>;
+export declare enum ManifestIncognito {
+    Spanning = "spanning",
+    Split = "split",
+    NotAllowed = "not_allowed"
+}
 type ManifestCommon = chrome.runtime.Manifest;
 type ManifestBase = chrome.runtime.ManifestBase;
 type ManifestPermission = chrome.runtime.ManifestPermission;
 type ManifestOptionalPermission = chrome.runtime.ManifestOptionalPermission;
-export declare const ManifestMatchSchemes: ReadonlySet<string>;
-export declare const ManifestSpecialSchemes: ReadonlySet<string>;
 type ManifestFixed<T extends ManifestBase> = Omit<T, "manifest_version"> & {
     manifest_version: ManifestVersion;
 };
@@ -19,11 +24,6 @@ interface ManifestUnstable {
     web_accessible_resources?: string[] | chrome.runtime.ManifestV3["web_accessible_resources"];
 }
 export type ManifestVersion = 2 | 3;
-export declare enum ManifestIncognito {
-    Spanning = "spanning",
-    Split = "split",
-    NotAllowed = "not_allowed"
-}
 export type ManifestIncognitoValue = ManifestIncognito | `${ManifestIncognito}`;
 export type CoreManifest = ManifestFixed<ManifestBase>;
 export type ChromeManifest = ManifestFixed<ManifestCommon>;
@@ -83,6 +83,7 @@ export interface ManifestBuilder<T extends CoreManifest = Manifest> {
     setContentScripts(contentScripts?: ManifestContentScripts): this;
     setPopup(popup?: ManifestPopup): this;
     setSidebar(sidebar?: ManifestSidebar): this;
+    setOptions(options?: ManifestOptions): this;
     addSandbox(sandbox: ManifestSandbox): this;
     appendSandboxes(sandboxes: Iterable<ManifestSandbox>): this;
     addSandboxCsp(csp: SandboxCspConfig): this;
@@ -150,6 +151,19 @@ export interface ManifestSidebar {
      */
     path?: string;
 }
+export interface ManifestOptions {
+    /**
+     * Path to the options page HTML file relative to the extension root.
+     * Written to `options_ui.page` in the manifest.
+     */
+    path: string;
+    /**
+     * Whether the options page should open in a browser tab.
+     * Written to `options_ui.open_in_tab` and defaults to `true` when omitted.
+     * Set to `false` to request an embedded page where supported by the browser.
+     */
+    openInTab?: boolean;
+}
 export interface ManifestAccessibleResource {
     resources: string[];
     matches?: string[];
@@ -160,8 +174,11 @@ export type ManifestAccessibleResources = Set<ManifestAccessibleResource>;
 export type ManifestSandbox = string;
 export type ManifestSandboxes = Set<ManifestSandbox>;
 export interface ManifestDependency {
+    /** Initial scripts, in execution order. */
     js: Set<string>;
+    /** Initial styles delivered by the manifest. */
     css: Set<string>;
+    /** Runtime resources, including lazy JS/CSS and other emitted files. */
     assets: Set<string>;
 }
 export type ManifestIcon = Map<number, string>;

package/dist/types/manifest.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/manifest.ts"],"sourcesContent":["import {ContentScriptConfig} from \"@typing/content\";\nimport {BackgroundConfig} from \"@typing/background\";\nimport {CommandConfig} from \"@typing/command\";\nimport {Language} from \"@typing/locale\";\nimport {BrowserSpecific, DataCollectionPermission} from \"@typing/browser\";\nimport {CspConfig} from \"@typing/csp\";\nimport {SandboxCspConfig} from \"@typing/sandbox\";\n\ntype ManifestCommon = chrome.runtime.Manifest;\ntype ManifestBase = chrome.runtime.ManifestBase;\ntype ManifestPermission = chrome.runtime.ManifestPermission;\ntype ManifestOptionalPermission = chrome.runtime.ManifestOptionalPermission;\n\nexport const ManifestMatchSchemes: ReadonlySet<string> = new Set<string>([\"http\", \"https\", \"file\", \"ftp\", \"ws\", \"wss\"]);\n\nexport const ManifestSpecialSchemes: ReadonlySet<string> = new Set<string>([\n    \"chrome-extension\",\n    \"moz-extension\",\n    \"data\",\n    \"blob\",\n    \"filesystem\",\n    \"about\",\n    \"chrome\",\n    \"resource\",\n]);\n\ntype ManifestFixed<T extends ManifestBase> = Omit<T, \"manifest_version\"> & {\n    manifest_version: ManifestVersion;\n};\n\ninterface ManifestUnstable {\n    permissions?: (ManifestPermission | (string & Record<never, never>))[];\n    web_accessible_resources?: string[] | chrome.runtime.ManifestV3[\"web_accessible_resources\"];\n}\n\nexport type ManifestVersion = 2 | 3;\n\nexport enum ManifestIncognito {\n    Spanning = \"spanning\",\n    Split = \"split\",\n    NotAllowed = \"not_allowed\",\n}\n\nexport type ManifestIncognitoValue = ManifestIncognito | `${ManifestIncognito}`;\n\nexport type CoreManifest = ManifestFixed<ManifestBase>;\n\nexport type ChromeManifest = ManifestFixed<ManifestCommon>;\n\nexport type FirefoxManifest = ChromeManifest & {\n    action?: chrome.runtime.ManifestV3[\"action\"] & {\n        browser_style?: boolean;\n    };\n    browser_action?: chrome.runtime.ManifestV2[\"browser_action\"] & {\n        browser_style?: boolean;\n    };\n    page_action?: chrome.runtime.ManifestV2[\"page_action\"] & {\n        browser_style?: boolean;\n    };\n    browser_specific_settings?: {\n        gecko?: {\n            id?: string;\n            strict_min_version?: string;\n            strict_max_version?: string;\n            update_url?: string;\n            data_collection_permissions?: {\n                required?: [\"none\"] | `${DataCollectionPermission}`[];\n                optional?: `${DataCollectionPermission}`[];\n            };\n        };\n        gecko_android?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type SafariManifest = ChromeManifest & {\n    browser_specific_settings?: {\n        safari?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type Manifest = ChromeManifest | FirefoxManifest | SafariManifest;\n\nexport type OptionalManifest = Partial<Omit<Manifest, \"manifest_version\">>;\n\nexport interface ManifestBuilder<T extends CoreManifest = Manifest> {\n    setName(name: string): this;\n\n    setShortName(shortName?: string): this;\n\n    setDescription(description?: string): this;\n\n    setAuthor(author?: string): this;\n\n    setHomepage(homepage?: string): this;\n\n    setVersion(version?: string): this;\n\n    setIncognito(incognito?: ManifestIncognitoValue): this;\n\n    setMinimumVersion(minimumVersion?: string): this;\n\n    setLocale(lang?: Language): this;\n\n    // Specific settings\n    setSpecific(settings?: BrowserSpecific): this;\n\n    mergeSpecific(settings: BrowserSpecific): this;\n\n    // Icons\n    setIcons(icons?: ManifestIcons): this;\n\n    setIcon(icon?: string): this; // name of an icon set for manifest.icons\n\n    // Entry\n    setBackground(background?: ManifestBackground): this;\n\n    setCommands(commands?: ManifestCommands): this;\n\n    setContentScripts(contentScripts?: ManifestContentScripts): this;\n\n    setPopup(popup?: ManifestPopup): this;\n\n    setSidebar(sidebar?: ManifestSidebar): this;\n\n    // Sandbox\n    addSandbox(sandbox: ManifestSandbox): this;\n\n    appendSandboxes(sandboxes: Iterable<ManifestSandbox>): this;\n\n    addSandboxCsp(csp: SandboxCspConfig): this;\n\n    appendSandboxCsp(csps: Iterable<SandboxCspConfig>): this;\n\n    // Content Security Policy\n    addCsp(csp: CspConfig): this;\n\n    appendCsp(csps: Iterable<CspConfig>): this;\n\n    // System\n    setDependencies(dependencies: ManifestDependencies): this;\n\n    // Permissions\n    addPermission(permission: ManifestPermission): this;\n\n    setPermissions(permissions: ManifestPermissions): this;\n\n    appendPermissions(permissions: ManifestPermissions): this;\n\n    // Optional Permissions\n    addOptionalPermission(permission: ManifestOptionalPermission): this;\n\n    setOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    appendOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    // Host Permissions\n    addHostPermission(permission: string): this;\n\n    setHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Optional Host Permissions\n    addOptionalHostPermission(permission: string): this;\n\n    setOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Web Accessible Resource\n    setAccessibleResource(accessibleResources: ManifestAccessibleResources): this;\n\n    appendAccessibleResources(accessibleResources: ManifestAccessibleResources): this;\n\n    addAccessibleResource(accessibleResource: ManifestAccessibleResource): this;\n\n    getWebAccessibleResources(): ManifestAccessibleResource[];\n\n    // Getter\n    get(): T;\n\n    raw(manifest: OptionalManifest): this;\n}\n\ntype Entry = string;\n\nexport interface ManifestEntry {\n    entry: Entry;\n}\n\nexport type ManifestBackground = ManifestEntry & BackgroundConfig;\n\nexport type ManifestContentScript = ManifestEntry & ContentScriptConfig;\nexport type ManifestContentScripts = Set<ManifestContentScript>;\n\nexport type ManifestCommand = CommandConfig;\nexport type ManifestCommands = Set<ManifestCommand>;\n\nexport interface ManifestPopup {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestSidebar {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestAccessibleResource {\n    resources: string[];\n    matches?: string[];\n    extensionIds?: string[];\n    useDynamicUrl?: boolean;\n}\n\nexport type ManifestAccessibleResources = Set<ManifestAccessibleResource>;\n\nexport type ManifestSandbox = string;\n\nexport type ManifestSandboxes = Set<ManifestSandbox>;\n\nexport interface ManifestDependency {\n    js: Set<string>;\n    css: Set<string>;\n    assets: Set<string>;\n}\n\nexport type ManifestIcon = Map<number, string>;\n\nexport type ManifestIcons = Map<string, ManifestIcon>;\n\nexport type ManifestDependencies = Map<Entry, ManifestDependency>;\n\nexport type ManifestPermissions = Set<ManifestPermission>;\n\nexport type ManifestOptionalPermissions = Set<ManifestOptionalPermission>;\n\nexport type ManifestHostPermissions = Set<string>;\n"],"mappings":"AAaO,MAAM,uBAA4C,oBAAI,IAAY,CAAC,QAAQ,SAAS,QAAQ,OAAO,MAAM,KAAK,CAAC;AAE/G,MAAM,yBAA8C,oBAAI,IAAY;AAAA,EACvE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAaM,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,mBAAA,cAAW;AACX,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,gBAAa;AAHL,SAAAA;AAAA,GAAA;","names":["ManifestIncognito"]}
+{"version":3,"sources":["../../src/types/manifest.ts"],"sourcesContent":["import {ContentScriptConfig} from \"@typing/content\";\nimport {BackgroundConfig} from \"@typing/background\";\nimport {CommandConfig} from \"@typing/command\";\nimport {Language} from \"@typing/locale\";\nimport {BrowserSpecific, DataCollectionPermission} from \"@typing/browser\";\nimport {CspConfig} from \"@typing/csp\";\nimport {SandboxCspConfig} from \"@typing/sandbox\";\n\nexport const ManifestMatchSchemes: ReadonlySet<string> = new Set<string>([\"http\", \"https\", \"file\", \"ftp\", \"ws\", \"wss\"]);\n\nexport const ManifestSpecialSchemes: ReadonlySet<string> = new Set<string>([\n    \"chrome-extension\",\n    \"moz-extension\",\n    \"data\",\n    \"blob\",\n    \"filesystem\",\n    \"about\",\n    \"chrome\",\n    \"resource\",\n]);\n\nexport enum ManifestIncognito {\n    Spanning = \"spanning\",\n    Split = \"split\",\n    NotAllowed = \"not_allowed\",\n}\n\ntype ManifestCommon = chrome.runtime.Manifest;\n\ntype ManifestBase = chrome.runtime.ManifestBase;\n\ntype ManifestPermission = chrome.runtime.ManifestPermission;\n\ntype ManifestOptionalPermission = chrome.runtime.ManifestOptionalPermission;\n\ntype ManifestFixed<T extends ManifestBase> = Omit<T, \"manifest_version\"> & {\n    manifest_version: ManifestVersion;\n};\n\ninterface ManifestUnstable {\n    permissions?: (ManifestPermission | (string & Record<never, never>))[];\n    web_accessible_resources?: string[] | chrome.runtime.ManifestV3[\"web_accessible_resources\"];\n}\n\nexport type ManifestVersion = 2 | 3;\n\nexport type ManifestIncognitoValue = ManifestIncognito | `${ManifestIncognito}`;\n\nexport type CoreManifest = ManifestFixed<ManifestBase>;\n\nexport type ChromeManifest = ManifestFixed<ManifestCommon>;\n\nexport type FirefoxManifest = ChromeManifest & {\n    action?: chrome.runtime.ManifestV3[\"action\"] & {\n        browser_style?: boolean;\n    };\n    browser_action?: chrome.runtime.ManifestV2[\"browser_action\"] & {\n        browser_style?: boolean;\n    };\n    page_action?: chrome.runtime.ManifestV2[\"page_action\"] & {\n        browser_style?: boolean;\n    };\n    browser_specific_settings?: {\n        gecko?: {\n            id?: string;\n            strict_min_version?: string;\n            strict_max_version?: string;\n            update_url?: string;\n            data_collection_permissions?: {\n                required?: [\"none\"] | `${DataCollectionPermission}`[];\n                optional?: `${DataCollectionPermission}`[];\n            };\n        };\n        gecko_android?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type SafariManifest = ChromeManifest & {\n    browser_specific_settings?: {\n        safari?: {\n            strict_min_version?: string;\n            strict_max_version?: string;\n        };\n    };\n} & ManifestUnstable;\n\nexport type Manifest = ChromeManifest | FirefoxManifest | SafariManifest;\n\nexport type OptionalManifest = Partial<Omit<Manifest, \"manifest_version\">>;\n\nexport interface ManifestBuilder<T extends CoreManifest = Manifest> {\n    setName(name: string): this;\n\n    setShortName(shortName?: string): this;\n\n    setDescription(description?: string): this;\n\n    setAuthor(author?: string): this;\n\n    setHomepage(homepage?: string): this;\n\n    setVersion(version?: string): this;\n\n    setIncognito(incognito?: ManifestIncognitoValue): this;\n\n    setMinimumVersion(minimumVersion?: string): this;\n\n    setLocale(lang?: Language): this;\n\n    // Specific settings\n    setSpecific(settings?: BrowserSpecific): this;\n\n    mergeSpecific(settings: BrowserSpecific): this;\n\n    // Icons\n    setIcons(icons?: ManifestIcons): this;\n\n    setIcon(icon?: string): this; // name of an icon set for manifest.icons\n\n    // Entry\n    setBackground(background?: ManifestBackground): this;\n\n    setCommands(commands?: ManifestCommands): this;\n\n    setContentScripts(contentScripts?: ManifestContentScripts): this;\n\n    setPopup(popup?: ManifestPopup): this;\n\n    setSidebar(sidebar?: ManifestSidebar): this;\n\n    setOptions(options?: ManifestOptions): this;\n\n    // Sandbox\n    addSandbox(sandbox: ManifestSandbox): this;\n\n    appendSandboxes(sandboxes: Iterable<ManifestSandbox>): this;\n\n    addSandboxCsp(csp: SandboxCspConfig): this;\n\n    appendSandboxCsp(csps: Iterable<SandboxCspConfig>): this;\n\n    // Content Security Policy\n    addCsp(csp: CspConfig): this;\n\n    appendCsp(csps: Iterable<CspConfig>): this;\n\n    // System\n    setDependencies(dependencies: ManifestDependencies): this;\n\n    // Permissions\n    addPermission(permission: ManifestPermission): this;\n\n    setPermissions(permissions: ManifestPermissions): this;\n\n    appendPermissions(permissions: ManifestPermissions): this;\n\n    // Optional Permissions\n    addOptionalPermission(permission: ManifestOptionalPermission): this;\n\n    setOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    appendOptionalPermissions(permissions: ManifestOptionalPermissions): this;\n\n    // Host Permissions\n    addHostPermission(permission: string): this;\n\n    setHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Optional Host Permissions\n    addOptionalHostPermission(permission: string): this;\n\n    setOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    appendOptionalHostPermissions(permissions: ManifestHostPermissions): this;\n\n    // Web Accessible Resource\n    setAccessibleResource(accessibleResources: ManifestAccessibleResources): this;\n\n    appendAccessibleResources(accessibleResources: ManifestAccessibleResources): this;\n\n    addAccessibleResource(accessibleResource: ManifestAccessibleResource): this;\n\n    getWebAccessibleResources(): ManifestAccessibleResource[];\n\n    // Getter\n    get(): T;\n\n    raw(manifest: OptionalManifest): this;\n}\n\ntype Entry = string;\n\nexport interface ManifestEntry {\n    entry: Entry;\n}\n\nexport type ManifestBackground = ManifestEntry & BackgroundConfig;\n\nexport type ManifestContentScript = ManifestEntry & ContentScriptConfig;\n\nexport type ManifestContentScripts = Set<ManifestContentScript>;\n\nexport type ManifestCommand = CommandConfig;\n\nexport type ManifestCommands = Set<ManifestCommand>;\n\nexport interface ManifestPopup {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestSidebar {\n    /**\n     * Represents the group name of an icon that can be used in UI elements.\n     * This property is optional and, if defined, should typically refer to a string\n     * that matches the name of an icon resource available in the application or icon library.\n     */\n    icon?: string;\n    /**\n     * Represents an optional title or name or locale key that can be assigned to an entity.\n     */\n    title?: string;\n    /**\n     * Represents an optional HTML path.\n     */\n    path?: string;\n}\n\nexport interface ManifestOptions {\n    /**\n     * Path to the options page HTML file relative to the extension root.\n     * Written to `options_ui.page` in the manifest.\n     */\n    path: string;\n    /**\n     * Whether the options page should open in a browser tab.\n     * Written to `options_ui.open_in_tab` and defaults to `true` when omitted.\n     * Set to `false` to request an embedded page where supported by the browser.\n     */\n    openInTab?: boolean;\n}\n\nexport interface ManifestAccessibleResource {\n    resources: string[];\n    matches?: string[];\n    extensionIds?: string[];\n    useDynamicUrl?: boolean;\n}\n\nexport type ManifestAccessibleResources = Set<ManifestAccessibleResource>;\n\nexport type ManifestSandbox = string;\n\nexport type ManifestSandboxes = Set<ManifestSandbox>;\n\nexport interface ManifestDependency {\n    /** Initial scripts, in execution order. */\n    js: Set<string>;\n    /** Initial styles delivered by the manifest. */\n    css: Set<string>;\n    /** Runtime resources, including lazy JS/CSS and other emitted files. */\n    assets: Set<string>;\n}\n\nexport type ManifestIcon = Map<number, string>;\n\nexport type ManifestIcons = Map<string, ManifestIcon>;\n\nexport type ManifestDependencies = Map<Entry, ManifestDependency>;\n\nexport type ManifestPermissions = Set<ManifestPermission>;\n\nexport type ManifestOptionalPermissions = Set<ManifestOptionalPermission>;\n\nexport type ManifestHostPermissions = Set<string>;\n"],"mappings":"AAQO,MAAM,uBAA4C,oBAAI,IAAY,CAAC,QAAQ,SAAS,QAAQ,OAAO,MAAM,KAAK,CAAC;AAE/G,MAAM,yBAA8C,oBAAI,IAAY;AAAA,EACvE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAEM,IAAK,oBAAL,kBAAKA,uBAAL;AACH,EAAAA,mBAAA,cAAW;AACX,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,gBAAa;AAHL,SAAAA;AAAA,GAAA;","names":["ManifestIncognito"]}

package/dist/types/message.d.ts

@@ -11,6 +11,13 @@ export type MessageSendOptions = number | {
 export interface MessageDictionary {
     [key: string]: (data: any) => any;
 }
+/**
+ * Declares no application-specific message signatures by default.
+ * Applications add their signatures by augmenting `adnbn/message`.
+ * Undeclared names retain the MessageDictionary fallback.
+ */
+export interface MessageRegistry extends MessageDictionary {
+}
 export interface MessageSenderAware {
     readonly [MessageSenderProperty]?: MessageSender;
 }