adnbn 0.9.0 → 0.11.0

package/dist/shared/locale/plural.js

@@ -0,0 +1,81 @@
+import { Language, LocaleValuesSeparator } from "./../../types/locale.js";
+const selectPluralForm = (message, lang, count) => {
+  const parts = message.split(LocaleValuesSeparator);
+  return parts[getPluralIndex(lang, count)] ?? parts[0] ?? message;
+};
+const getPluralIndex = (lang, count) => {
+  switch (lang) {
+    case Language.Indonesian:
+    case Language.Japanese:
+    case Language.Kannada:
+    case Language.Korean:
+    case Language.Malay:
+    case Language.Thai:
+    case Language.Turkish:
+    case Language.Vietnamese:
+      return 0;
+    case Language.Bengali:
+    case Language.Bulgarian:
+    case Language.Catalan:
+    case Language.Danish:
+    case Language.German:
+    case Language.Greek:
+    case Language.English:
+    case Language.EnglishAustralia:
+    case Language.EnglishGreatBritain:
+    case Language.EnglishUSA:
+    case Language.Spanish:
+    case Language.SpanishLatinAmericaAndCaribbean:
+    case Language.Estonian:
+    case Language.Persian:
+    case Language.Finnish:
+    case Language.Gujarati:
+    case Language.Hebrew:
+    case Language.Hungarian:
+    case Language.Italian:
+    case Language.Malayalam:
+    case Language.Marathi:
+    case Language.Dutch:
+    case Language.Norwegian:
+    case Language.Swedish:
+    case Language.Swahili:
+    case Language.Tamil:
+    case Language.Telugu:
+    case Language.ChineseChina:
+    case Language.ChineseTaiwan:
+    case Language.PortugueseBrazil:
+    case Language.PortuguesePortugal:
+      return count == 1 ? 0 : 1;
+    case Language.Amharic:
+    case Language.Filipino:
+    case Language.French:
+    case Language.Hindi:
+      return count == 0 || count == 1 ? 0 : 1;
+    case Language.Croatian:
+    case Language.Russian:
+    case Language.Serbian:
+    case Language.Ukrainian:
+      return count % 10 == 1 && count % 100 != 11 ? 0 : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 10 || count % 100 >= 20) ? 1 : 2;
+    case Language.Czech:
+    case Language.Slovak:
+      return count == 1 ? 0 : count >= 2 && count <= 4 ? 1 : 2;
+    case Language.Lithuanian:
+      return count % 10 == 1 && count % 100 != 11 ? 0 : count % 10 >= 2 && (count % 100 < 10 || count % 100 >= 20) ? 1 : 2;
+    case Language.Slovenian:
+      return count % 100 == 1 ? 0 : count % 100 == 2 ? 1 : count % 100 == 3 || count % 100 == 4 ? 2 : 3;
+    case Language.Latvian:
+      return count == 0 ? 0 : count % 10 == 1 && count % 100 != 11 ? 1 : 2;
+    case Language.Polish:
+      return count == 1 ? 0 : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 12 || count % 100 > 14) ? 1 : 2;
+    case Language.Romanian:
+      return count == 1 ? 0 : count == 0 || count % 100 > 0 && count % 100 < 20 ? 1 : 2;
+    case Language.Arabic:
+      return count == 0 ? 0 : count == 1 ? 1 : count == 2 ? 2 : count % 100 >= 3 && count % 100 <= 10 ? 3 : count % 100 >= 11 && count % 100 <= 99 ? 4 : 5;
+    default:
+      return 0;
+  }
+};
+export {
+  selectPluralForm
+};
+//# sourceMappingURL=plural.js.map

package/dist/shared/locale/plural.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/locale/plural.ts"],"sourcesContent":["import {Language, LocaleValuesSeparator} from \"@typing/locale\";\n\nexport const selectPluralForm = (message: string, lang: Language, count: number): string => {\n    const parts = message.split(LocaleValuesSeparator);\n\n    return parts[getPluralIndex(lang, count)] ?? parts[0] ?? message;\n};\n\nconst getPluralIndex = (lang: Language, count: number): number => {\n    switch (lang) {\n        case Language.Indonesian:\n        case Language.Japanese:\n        case Language.Kannada:\n        case Language.Korean:\n        case Language.Malay:\n        case Language.Thai:\n        case Language.Turkish:\n        case Language.Vietnamese:\n            return 0;\n\n        case Language.Bengali:\n        case Language.Bulgarian:\n        case Language.Catalan:\n        case Language.Danish:\n        case Language.German:\n        case Language.Greek:\n        case Language.English:\n        case Language.EnglishAustralia:\n        case Language.EnglishGreatBritain:\n        case Language.EnglishUSA:\n        case Language.Spanish:\n        case Language.SpanishLatinAmericaAndCaribbean:\n        case Language.Estonian:\n        case Language.Persian:\n        case Language.Finnish:\n        case Language.Gujarati:\n        case Language.Hebrew:\n        case Language.Hungarian:\n        case Language.Italian:\n        case Language.Malayalam:\n        case Language.Marathi:\n        case Language.Dutch:\n        case Language.Norwegian:\n        case Language.Swedish:\n        case Language.Swahili:\n        case Language.Tamil:\n        case Language.Telugu:\n        case Language.ChineseChina:\n        case Language.ChineseTaiwan:\n        case Language.PortugueseBrazil:\n        case Language.PortuguesePortugal:\n            return count == 1 ? 0 : 1;\n\n        case Language.Amharic:\n        case Language.Filipino:\n        case Language.French:\n        case Language.Hindi:\n            return count == 0 || count == 1 ? 0 : 1;\n\n        case Language.Croatian:\n        case Language.Russian:\n        case Language.Serbian:\n        case Language.Ukrainian:\n            return count % 10 == 1 && count % 100 != 11\n                ? 0\n                : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 10 || count % 100 >= 20)\n                  ? 1\n                  : 2;\n\n        case Language.Czech:\n        case Language.Slovak:\n            return count == 1 ? 0 : count >= 2 && count <= 4 ? 1 : 2;\n\n        case Language.Lithuanian:\n            return count % 10 == 1 && count % 100 != 11\n                ? 0\n                : count % 10 >= 2 && (count % 100 < 10 || count % 100 >= 20)\n                  ? 1\n                  : 2;\n\n        case Language.Slovenian:\n            return count % 100 == 1 ? 0 : count % 100 == 2 ? 1 : count % 100 == 3 || count % 100 == 4 ? 2 : 3;\n\n        case Language.Latvian:\n            return count == 0 ? 0 : count % 10 == 1 && count % 100 != 11 ? 1 : 2;\n\n        case Language.Polish:\n            return count == 1\n                ? 0\n                : count % 10 >= 2 && count % 10 <= 4 && (count % 100 < 12 || count % 100 > 14)\n                  ? 1\n                  : 2;\n\n        case Language.Romanian:\n            return count == 1 ? 0 : count == 0 || (count % 100 > 0 && count % 100 < 20) ? 1 : 2;\n\n        case Language.Arabic:\n            return count == 0\n                ? 0\n                : count == 1\n                  ? 1\n                  : count == 2\n                    ? 2\n                    : count % 100 >= 3 && count % 100 <= 10\n                      ? 3\n                      : count % 100 >= 11 && count % 100 <= 99\n                        ? 4\n                        : 5;\n\n        default:\n            return 0;\n    }\n};\n"],"mappings":"AAAA,SAAQ,UAAU,6BAA4B;AAEvC,MAAM,mBAAmB,CAAC,SAAiB,MAAgB,UAA0B;AACxF,QAAM,QAAQ,QAAQ,MAAM,qBAAqB;AAEjD,SAAO,MAAM,eAAe,MAAM,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK;AAC7D;AAEA,MAAM,iBAAiB,CAAC,MAAgB,UAA0B;AAC9D,UAAQ,MAAM;AAAA,IACV,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AACV,aAAO;AAAA,IAEX,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AACV,aAAO,SAAS,IAAI,IAAI;AAAA,IAE5B,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AACV,aAAO,SAAS,KAAK,SAAS,IAAI,IAAI;AAAA,IAE1C,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AACV,aAAO,QAAQ,MAAM,KAAK,QAAQ,OAAO,KACnC,IACA,QAAQ,MAAM,KAAK,QAAQ,MAAM,MAAM,QAAQ,MAAM,MAAM,QAAQ,OAAO,MACxE,IACA;AAAA,IAEZ,KAAK,SAAS;AAAA,IACd,KAAK,SAAS;AACV,aAAO,SAAS,IAAI,IAAI,SAAS,KAAK,SAAS,IAAI,IAAI;AAAA,IAE3D,KAAK,SAAS;AACV,aAAO,QAAQ,MAAM,KAAK,QAAQ,OAAO,KACnC,IACA,QAAQ,MAAM,MAAM,QAAQ,MAAM,MAAM,QAAQ,OAAO,MACrD,IACA;AAAA,IAEZ,KAAK,SAAS;AACV,aAAO,QAAQ,OAAO,IAAI,IAAI,QAAQ,OAAO,IAAI,IAAI,QAAQ,OAAO,KAAK,QAAQ,OAAO,IAAI,IAAI;AAAA,IAEpG,KAAK,SAAS;AACV,aAAO,SAAS,IAAI,IAAI,QAAQ,MAAM,KAAK,QAAQ,OAAO,KAAK,IAAI;AAAA,IAEvE,KAAK,SAAS;AACV,aAAO,SAAS,IACV,IACA,QAAQ,MAAM,KAAK,QAAQ,MAAM,MAAM,QAAQ,MAAM,MAAM,QAAQ,MAAM,MACvE,IACA;AAAA,IAEZ,KAAK,SAAS;AACV,aAAO,SAAS,IAAI,IAAI,SAAS,KAAM,QAAQ,MAAM,KAAK,QAAQ,MAAM,KAAM,IAAI;AAAA,IAEtF,KAAK,SAAS;AACV,aAAO,SAAS,IACV,IACA,SAAS,IACP,IACA,SAAS,IACP,IACA,QAAQ,OAAO,KAAK,QAAQ,OAAO,KACjC,IACA,QAAQ,OAAO,MAAM,QAAQ,OAAO,KAClC,IACA;AAAA,IAElB;AACI,aAAO;AAAA,EACf;AACJ;","names":[]}

package/dist/shared/locale/substitutions.d.ts

@@ -0,0 +1,10 @@
+interface LocalePlaceholder {
+    name: string;
+    start: number;
+    end: number;
+}
+/** Empty names and malformed placeholders remain literal message text. */
+export declare const parsePlaceholders: (message: string) => LocalePlaceholder[];
+/** Keeps supplied values intact so each adapter can render them in its own format. */
+export declare const applySubstitutions: <T>(message: string, substitutions: Record<string, T> | undefined, onMissing: (name: string) => void) => (string | T)[];
+export {};

package/dist/shared/locale/substitutions.js

@@ -0,0 +1,32 @@
+const parsePlaceholders = (message) => {
+  const placeholders = [];
+  for (const match of message.matchAll(/{{([^{}]+)}}/g)) {
+    const name = match[1].trim();
+    if (name) {
+      placeholders.push({ name, start: match.index, end: match.index + match[0].length });
+    }
+  }
+  return placeholders;
+};
+const applySubstitutions = (message, substitutions, onMissing) => {
+  if (!substitutions) return [message];
+  const parts = [];
+  let offset = 0;
+  for (const placeholder of parsePlaceholders(message)) {
+    parts.push(message.slice(offset, placeholder.start));
+    if (Object.prototype.hasOwnProperty.call(substitutions, placeholder.name)) {
+      parts.push(substitutions[placeholder.name]);
+    } else {
+      onMissing(placeholder.name);
+      parts.push(placeholder.name);
+    }
+    offset = placeholder.end;
+  }
+  parts.push(message.slice(offset));
+  return parts;
+};
+export {
+  applySubstitutions,
+  parsePlaceholders
+};
+//# sourceMappingURL=substitutions.js.map

package/dist/shared/locale/substitutions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/locale/substitutions.ts"],"sourcesContent":["interface LocalePlaceholder {\n    name: string;\n    start: number;\n    end: number;\n}\n\n/** Empty names and malformed placeholders remain literal message text. */\nexport const parsePlaceholders = (message: string): LocalePlaceholder[] => {\n    const placeholders: LocalePlaceholder[] = [];\n\n    for (const match of message.matchAll(/{{([^{}]+)}}/g)) {\n        const name = match[1].trim();\n\n        if (name) {\n            placeholders.push({name, start: match.index, end: match.index + match[0].length});\n        }\n    }\n\n    return placeholders;\n};\n\n/** Keeps supplied values intact so each adapter can render them in its own format. */\nexport const applySubstitutions = <T>(\n    message: string,\n    substitutions: Record<string, T> | undefined,\n    onMissing: (name: string) => void\n): (string | T)[] => {\n    if (!substitutions) return [message];\n\n    const parts: (string | T)[] = [];\n    let offset = 0;\n\n    for (const placeholder of parsePlaceholders(message)) {\n        parts.push(message.slice(offset, placeholder.start));\n\n        if (Object.prototype.hasOwnProperty.call(substitutions, placeholder.name)) {\n            parts.push(substitutions[placeholder.name]);\n        } else {\n            onMissing(placeholder.name);\n            parts.push(placeholder.name);\n        }\n\n        offset = placeholder.end;\n    }\n\n    parts.push(message.slice(offset));\n\n    return parts;\n};\n"],"mappings":"AAOO,MAAM,oBAAoB,CAAC,YAAyC;AACvE,QAAM,eAAoC,CAAC;AAE3C,aAAW,SAAS,QAAQ,SAAS,eAAe,GAAG;AACnD,UAAM,OAAO,MAAM,CAAC,EAAE,KAAK;AAE3B,QAAI,MAAM;AACN,mBAAa,KAAK,EAAC,MAAM,OAAO,MAAM,OAAO,KAAK,MAAM,QAAQ,MAAM,CAAC,EAAE,OAAM,CAAC;AAAA,IACpF;AAAA,EACJ;AAEA,SAAO;AACX;AAGO,MAAM,qBAAqB,CAC9B,SACA,eACA,cACiB;AACjB,MAAI,CAAC,cAAe,QAAO,CAAC,OAAO;AAEnC,QAAM,QAAwB,CAAC;AAC/B,MAAI,SAAS;AAEb,aAAW,eAAe,kBAAkB,OAAO,GAAG;AAClD,UAAM,KAAK,QAAQ,MAAM,QAAQ,YAAY,KAAK,CAAC;AAEnD,QAAI,OAAO,UAAU,eAAe,KAAK,eAAe,YAAY,IAAI,GAAG;AACvE,YAAM,KAAK,cAAc,YAAY,IAAI,CAAC;AAAA,IAC9C,OAAO;AACH,gBAAU,YAAY,IAAI;AAC1B,YAAM,KAAK,YAAY,IAAI;AAAA,IAC/B;AAEA,aAAS,YAAY;AAAA,EACzB;AAEA,QAAM,KAAK,QAAQ,MAAM,MAAM,CAAC;AAEhC,SAAO;AACX;","names":[]}

package/dist/types/background.d.ts

@@ -1,8 +1,8 @@
 import { EntrypointBuilder, EntrypointOptions } from "./entrypoint.js";
 import { Awaiter } from "./helpers.js";
+export declare const BackgroundEntryName = "background";
 type ManifestPermissions = chrome.runtime.ManifestPermission;
 type ManifestOptionalPermissions = chrome.runtime.ManifestOptionalPermission;
-export declare const BackgroundEntryName = "background";
 export interface BackgroundConfig {
     persistent?: boolean;
     permissions?: ManifestPermissions[];

package/dist/types/background.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/background.ts"],"sourcesContent":["import {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport {Awaiter} from \"@typing/helpers\";\n\ntype ManifestPermissions = chrome.runtime.ManifestPermission;\ntype ManifestOptionalPermissions = chrome.runtime.ManifestOptionalPermission;\n\nexport const BackgroundEntryName = \"background\";\n\nexport interface BackgroundConfig {\n    persistent?: boolean;\n    permissions?: ManifestPermissions[];\n    optionalPermissions?: ManifestOptionalPermissions[];\n    hostPermissions?: string[];\n    optionalHostPermissions?: string[];\n}\n\nexport type BackgroundOptions = BackgroundConfig & EntrypointOptions;\n\nexport type BackgroundEntrypointOptions = BackgroundOptions;\n\nexport type BackgroundMainHandler = (options: BackgroundOptions) => Awaiter<void>;\n\nexport interface BackgroundDefinition extends BackgroundEntrypointOptions {\n    main?: BackgroundMainHandler;\n}\n\nexport type BackgroundBuilder = EntrypointBuilder;\n"],"mappings":"AAMO,MAAM,sBAAsB;","names":[]}
+{"version":3,"sources":["../../src/types/background.ts"],"sourcesContent":["import {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport {Awaiter} from \"@typing/helpers\";\n\nexport const BackgroundEntryName = \"background\";\n\ntype ManifestPermissions = chrome.runtime.ManifestPermission;\n\ntype ManifestOptionalPermissions = chrome.runtime.ManifestOptionalPermission;\n\nexport interface BackgroundConfig {\n    persistent?: boolean;\n    permissions?: ManifestPermissions[];\n    optionalPermissions?: ManifestOptionalPermissions[];\n    hostPermissions?: string[];\n    optionalHostPermissions?: string[];\n}\n\nexport type BackgroundOptions = BackgroundConfig & EntrypointOptions;\n\nexport type BackgroundEntrypointOptions = BackgroundOptions;\n\nexport type BackgroundMainHandler = (options: BackgroundOptions) => Awaiter<void>;\n\nexport interface BackgroundDefinition extends BackgroundEntrypointOptions {\n    main?: BackgroundMainHandler;\n}\n\nexport type BackgroundBuilder = EntrypointBuilder;\n"],"mappings":"AAGO,MAAM,sBAAsB;","names":[]}

package/dist/types/command.d.ts

@@ -2,8 +2,8 @@ import { Required } from "utility-types";
 import { EntrypointBuilder, EntrypointOptions } from "./entrypoint.js";
 import { BackgroundConfig } from "./background.js";
 import { Awaiter } from "./helpers.js";
-type Tab = chrome.tabs.Tab;
 export declare const CommandExecuteActionName = "_execute_action";
+type Tab = chrome.tabs.Tab;
 export interface CommandConfig extends BackgroundConfig {
     name: string;
     description?: string;

package/dist/types/command.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/command.ts"],"sourcesContent":["import {Required} from \"utility-types\";\n\nimport {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport {BackgroundConfig} from \"@typing/background\";\nimport {Awaiter} from \"@typing/helpers\";\n\ntype Tab = chrome.tabs.Tab;\n\nexport const CommandExecuteActionName = \"_execute_action\";\n\nexport interface CommandConfig extends BackgroundConfig {\n    name: string;\n    description?: string;\n    global?: boolean;\n    defaultKey?: string;\n    windowsKey?: string;\n    macKey?: string;\n    chromeosKey?: string;\n    linuxKey?: string;\n}\n\nexport type CommandOptions = CommandConfig & EntrypointOptions;\n\nexport type CommandEntrypointOptions = Partial<CommandOptions>;\n\nexport type CommandExecute = (tab: Tab | undefined, options: CommandOptions) => Awaiter<void>;\n\nexport interface CommandDefinition extends CommandEntrypointOptions {\n    execute: CommandExecute;\n}\n\nexport type ExecuteActionCommandDefinition = Omit<CommandDefinition, \"name\">;\n\nexport type CommandUnresolvedDefinition = Partial<CommandDefinition>;\n\nexport type CommandResolvedDefinition = Required<CommandDefinition, \"name\" | \"execute\">;\n\nexport type CommandBuilder = EntrypointBuilder;\n"],"mappings":"AAQO,MAAM,2BAA2B;","names":[]}
+{"version":3,"sources":["../../src/types/command.ts"],"sourcesContent":["import {Required} from \"utility-types\";\n\nimport {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport {BackgroundConfig} from \"@typing/background\";\nimport {Awaiter} from \"@typing/helpers\";\n\nexport const CommandExecuteActionName = \"_execute_action\";\n\ntype Tab = chrome.tabs.Tab;\n\nexport interface CommandConfig extends BackgroundConfig {\n    name: string;\n    description?: string;\n    global?: boolean;\n    defaultKey?: string;\n    windowsKey?: string;\n    macKey?: string;\n    chromeosKey?: string;\n    linuxKey?: string;\n}\n\nexport type CommandOptions = CommandConfig & EntrypointOptions;\n\nexport type CommandEntrypointOptions = Partial<CommandOptions>;\n\nexport type CommandExecute = (tab: Tab | undefined, options: CommandOptions) => Awaiter<void>;\n\nexport interface CommandDefinition extends CommandEntrypointOptions {\n    execute: CommandExecute;\n}\n\nexport type ExecuteActionCommandDefinition = Omit<CommandDefinition, \"name\">;\n\nexport type CommandUnresolvedDefinition = Partial<CommandDefinition>;\n\nexport type CommandResolvedDefinition = Required<CommandDefinition, \"name\" | \"execute\">;\n\nexport type CommandBuilder = EntrypointBuilder;\n"],"mappings":"AAMO,MAAM,2BAA2B;","names":[]}

package/dist/types/content.d.ts

@@ -1,14 +1,61 @@
+import type { PageAlias } from "./page.js";
 import type { FC, ReactNode } from "react";
 import { Optional } from "utility-types";
 import { EntrypointBuilder, EntrypointOptions } from "./entrypoint.js";
 import { Awaiter, PickNonFunctionProperties } from "./helpers.js";
-type ExecutionWorld = chrome.scripting.ExecutionWorld;
-type RunAt = chrome.extensionTypes.RunAt;
 export declare const ContentScriptMatches: string[];
+/** Shared property used by the bundler plugin and the content script's style runtime getter. */
+export declare const ContentScriptStylesRuntimeProperty = "__adnbnIsolatedStyles";
+export declare enum ContentScriptWorld {
+    Isolated = "ISOLATED",
+    Main = "MAIN"
+}
 export declare enum ContentScriptDeclarative {
     Required = "required",
     Optional = "optional"
 }
+export declare enum ContentScriptIsolation {
+    None = "none",
+    Shadow = "shadow",
+    Iframe = "iframe"
+}
+export declare enum ContentScriptShadowMode {
+    Open = "open",
+    Closed = "closed"
+}
+export declare enum ContentScriptAppend {
+    Last = "last",
+    First = "first",
+    Replace = "replace",
+    Before = "before",
+    After = "after"
+}
+export declare enum ContentScriptMarker {
+    /** In-memory marking (no DOM mutations). */
+    Weak = "weak",
+    /** DOM attribute-based marking. */
+    Attribute = "attribute"
+}
+export declare enum ContentScriptMarkerValue {
+    Mounted = "1",
+    Unmounted = "0"
+}
+export declare enum ContentScriptEvent {
+    Mount = "mount",
+    Unmount = "unmount",
+    Add = "add",
+    Remove = "remove"
+}
+type RunAt = chrome.extensionTypes.RunAt;
+export interface ContentScriptStylesRuntime {
+    /** Resolves initial stylesheet URLs once, before the first root is registered. */
+    initialize(resolveUrl: (file: string) => string): void;
+    /** Retry restored styles once on load error; future loads keep the default failure behavior. */
+    add(root: ShadowRoot | HTMLElement, target: Element | null, retry?: boolean): void;
+    delete(root: ShadowRoot | HTMLElement): void;
+    load(url: string): Promise<void>;
+}
+export type ContentScriptWorldValue = ContentScriptWorld | `${chrome.scripting.ExecutionWorld}`;
 export interface ContentScriptConfig {
     matches?: string[];
     /**
@@ -38,8 +85,13 @@ export interface ContentScriptConfig {
     runAt?: RunAt;
     /**
      * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
+     *
+     * Dynamic imports keep physical async chunks in ISOLATED. MAIN keeps the same Promise-based
+     * execution semantics but includes dynamic dependencies in the initial entrypoint graph.
+     * Manifest V2 builds always use ISOLATED. Requesting MAIN emits a build warning and applies
+     * ISOLATED grouping and chunk loading rules before generating the manifest.
      */
-    world?: ExecutionWorld;
+    world?: ContentScriptWorldValue;
     /**
      * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
      * @default false
@@ -68,14 +120,57 @@ export interface ContentScriptConfig {
     declarative?: boolean | `${ContentScriptDeclarative}` | ContentScriptDeclarative;
 }
 export type ContentScriptOptions = ContentScriptConfig & EntrypointOptions;
-export type ContentScriptEntrypointOptions = Partial<ContentScriptOptions>;
-export declare enum ContentScriptAppend {
-    Last = "last",
-    First = "first",
-    Replace = "replace",
-    Before = "before",
-    After = "after"
+export interface ContentScriptShadowOptions {
+    /**
+     * Controls access through the host's shadowRoot property, not CSS isolation or UI visibility.
+     * @default ContentScriptShadowMode.Open
+     */
+    mode?: ContentScriptShadowMode | `${ContentScriptShadowMode}`;
+}
+export interface ContentScriptFrameOptions {
+    width?: number | string;
+    /** Defaults to 150px. Automatic height is not supported yet. */
+    height?: number | string;
+}
+export interface ContentScriptFrameRenderOptions extends ContentScriptFrameOptions {
+    page?: never;
+    src?: never;
 }
+export interface ContentScriptFramePageOptions extends ContentScriptFrameOptions {
+    page: PageAlias;
+    src?: never;
+}
+export interface ContentScriptFrameSourceOptions extends ContentScriptFrameOptions {
+    src: string;
+    page?: never;
+}
+export type ContentScriptFrame = ContentScriptFrameRenderOptions | ContentScriptFramePageOptions | ContentScriptFrameSourceOptions;
+export interface ContentScriptIsolationNoneOptions {
+    type: ContentScriptIsolation.None | "none";
+    mode?: never;
+    page?: never;
+    src?: never;
+    width?: never;
+    height?: never;
+}
+export interface ContentScriptIsolationShadowOptions extends ContentScriptShadowOptions {
+    type: ContentScriptIsolation.Shadow | "shadow";
+    page?: never;
+    src?: never;
+    width?: never;
+    height?: never;
+}
+export type ContentScriptIsolationFrameOptions = ContentScriptFrame & {
+    type: ContentScriptIsolation.Iframe | "iframe";
+    mode?: never;
+};
+/** Object form of isolation, also used after resolving shorthand values. */
+export type ContentScriptIsolationOptions = ContentScriptIsolationNoneOptions | ContentScriptIsolationShadowOptions | ContentScriptIsolationFrameOptions;
+export type ContentScriptIsolationValue = ContentScriptIsolation | `${ContentScriptIsolation}` | ContentScriptIsolationOptions;
+/** Statically resolved configuration; runtime render values are never retained here. */
+export type ContentScriptEntrypointOptions = Partial<ContentScriptOptions> & {
+    isolation?: ContentScriptIsolationOptions;
+};
 export type ContentScriptMountFunction = (anchor: Element, container: Element) => void | (() => void);
 export interface ContentScriptMount {
     mount(): boolean | undefined | void;
@@ -86,16 +181,6 @@ export interface ContentScriptProps extends ContentScriptEntrypointOptions {
 }
 export type ContentScriptAnchor = string | Element | null | undefined;
 export type ContentScriptAnchorGetter = () => Awaiter<ContentScriptAnchor>;
-export declare enum ContentScriptMarker {
-    /** In-memory marking (no DOM mutations). */
-    Weak = "weak",
-    /** DOM attribute-based marking. */
-    Attribute = "attribute"
-}
-export declare enum ContentScriptMarkerValue {
-    Mounted = "1",
-    Unmounted = "0"
-}
 export interface ContentScriptMarkerContract {
     for(anchor: ContentScriptAnchor): ContentScriptMarkerContract;
     /**
@@ -127,12 +212,6 @@ export type ContentScriptContainerOptions = {
 export type ContentScriptContainerFactory = (props: ContentScriptProps) => Awaiter<Element | ContentScriptContainerTag | ContentScriptContainerOptions>;
 export type ContentScriptContainerCreator = (props: ContentScriptProps) => Awaiter<Element>;
 export type ContentScriptWatchStrategy = (update: () => void, context: ContentScriptContext) => () => void;
-export declare enum ContentScriptEvent {
-    Mount = "mount",
-    Unmount = "unmount",
-    Add = "add",
-    Remove = "remove"
-}
 export type ContentScriptEventCallback = (event: ContentScriptEvent, node: ContentScriptNode) => void;
 export interface ContentScriptEventEmitter {
     on(callback: ContentScriptEventCallback): void;
@@ -167,18 +246,27 @@ export type ContentScriptMainFunction = (context: ContentScriptContext, options:
 export interface ContentScriptNode extends ContentScriptMount {
     anchor: Element;
     container?: Element;
+    /** Element used by the active adapter as the destination for rendered UI. */
+    target?: Element;
 }
 export type ContentScriptNodeSet = Set<ContentScriptNode>;
-export interface ContentScriptDefinition extends ContentScriptEntrypointOptions {
+export interface ContentScriptDefinitionBase extends Partial<ContentScriptOptions> {
     marker?: ContentScriptMarkerType | ContentScriptMarkerGetter;
     anchor?: ContentScriptAnchor | ContentScriptAnchorGetter;
     mount?: ContentScriptMountFunction;
-    render?: ContentScriptRenderValue | ContentScriptRenderHandler;
     container?: ContentScriptContainerTag | ContentScriptContainerOptions | ContentScriptContainerFactory;
     watch?: true | ContentScriptWatchStrategy;
     main?: ContentScriptMainFunction;
 }
-export interface ContentScriptResolvedDefinition extends Omit<ContentScriptDefinition, "anchor" | "marker" | "mount" | "container" | "render" | "watch"> {
+export type ContentScriptDefinition = ContentScriptDefinitionBase & ({
+    isolation?: ContentScriptIsolation | `${ContentScriptIsolation}` | ContentScriptIsolationNoneOptions | ContentScriptIsolationShadowOptions | (ContentScriptIsolationFrameOptions & ContentScriptFrameRenderOptions);
+    render?: ContentScriptRenderValue | ContentScriptRenderHandler;
+} | {
+    isolation: ContentScriptIsolationFrameOptions & (ContentScriptFramePageOptions | ContentScriptFrameSourceOptions);
+    render?: never;
+});
+export interface ContentScriptResolvedDefinition extends Omit<ContentScriptDefinitionBase, "anchor" | "marker" | "mount" | "container" | "watch"> {
+    isolation: ContentScriptIsolationOptions;
     marker: ContentScriptMarkerResolver;
     anchor: ContentScriptAnchorGetter;
     mount: ContentScriptMountFunction;
@@ -186,9 +274,10 @@ export interface ContentScriptResolvedDefinition extends Omit<ContentScriptDefin
     container: ContentScriptContainerCreator;
     watch: ContentScriptWatchStrategy;
 }
-export interface ContentScriptAppendDefinition extends Omit<ContentScriptDefinition, "mount"> {
+type ContentScriptAppendVariant<T> = T extends unknown ? Omit<T, "mount"> & {
     append?: ContentScriptAppend;
-}
+} : never;
+export type ContentScriptAppendDefinition = ContentScriptAppendVariant<ContentScriptDefinition>;
 export interface ContentScriptBuilder extends EntrypointBuilder {
     getContext(): ContentScriptContext;
 }

package/dist/types/content.js

@@ -1,9 +1,26 @@
 const ContentScriptMatches = ["http://*/*", "https://*/*"];
+const ContentScriptStylesRuntimeProperty = "__adnbnIsolatedStyles";
+var ContentScriptWorld = /* @__PURE__ */ ((ContentScriptWorld2) => {
+  ContentScriptWorld2["Isolated"] = "ISOLATED";
+  ContentScriptWorld2["Main"] = "MAIN";
+  return ContentScriptWorld2;
+})(ContentScriptWorld || {});
 var ContentScriptDeclarative = /* @__PURE__ */ ((ContentScriptDeclarative2) => {
   ContentScriptDeclarative2["Required"] = "required";
   ContentScriptDeclarative2["Optional"] = "optional";
   return ContentScriptDeclarative2;
 })(ContentScriptDeclarative || {});
+var ContentScriptIsolation = /* @__PURE__ */ ((ContentScriptIsolation2) => {
+  ContentScriptIsolation2["None"] = "none";
+  ContentScriptIsolation2["Shadow"] = "shadow";
+  ContentScriptIsolation2["Iframe"] = "iframe";
+  return ContentScriptIsolation2;
+})(ContentScriptIsolation || {});
+var ContentScriptShadowMode = /* @__PURE__ */ ((ContentScriptShadowMode2) => {
+  ContentScriptShadowMode2["Open"] = "open";
+  ContentScriptShadowMode2["Closed"] = "closed";
+  return ContentScriptShadowMode2;
+})(ContentScriptShadowMode || {});
 var ContentScriptAppend = /* @__PURE__ */ ((ContentScriptAppend2) => {
   ContentScriptAppend2["Last"] = "last";
   ContentScriptAppend2["First"] = "first";
@@ -33,8 +50,12 @@ export {
   ContentScriptAppend,
   ContentScriptDeclarative,
   ContentScriptEvent,
+  ContentScriptIsolation,
   ContentScriptMarker,
   ContentScriptMarkerValue,
-  ContentScriptMatches
+  ContentScriptMatches,
+  ContentScriptShadowMode,
+  ContentScriptStylesRuntimeProperty,
+  ContentScriptWorld
 };
 //# sourceMappingURL=content.js.map

package/dist/types/content.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/content.ts"],"sourcesContent":["import type {FC, ReactNode} from \"react\";\nimport {Optional} from \"utility-types\";\n\nimport {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport {Awaiter, PickNonFunctionProperties} from \"@typing/helpers\";\n\ntype ExecutionWorld = chrome.scripting.ExecutionWorld;\ntype RunAt = chrome.extensionTypes.RunAt;\n\nexport const ContentScriptMatches = [\"http://*/*\", \"https://*/*\"];\n\nexport enum ContentScriptDeclarative {\n    Required = \"required\",\n    Optional = \"optional\",\n}\n\nexport interface ContentScriptConfig {\n    matches?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default []\n     */\n    excludeMatches?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default []\n     */\n    includeGlobs?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default []\n     */\n    excludeGlobs?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default false\n     */\n    allFrames?: boolean;\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default \"documentIdle\"\n     */\n    runAt?: RunAt;\n    /**\n     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world\n     */\n    world?: ExecutionWorld;\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default false\n     */\n    matchAboutBlank?: boolean;\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default false\n     */\n    matchOriginAsFallback?: boolean;\n    /**\n     * Whether this content script requires explicit host permission declaration in the extension manifest.\n     *\n     * Accepted values:\n     * - ContentScriptDeclarative.Required — adds the corresponding host patterns to manifest.host_permissions.\n     * - ContentScriptDeclarative.Optional — adds the corresponding host patterns to manifest.optional_host_permissions.\n     *\n     * Backward compatibility:\n     * - true ≡ ContentScriptDeclarative.Required\n     * - false ≡ undefined (as if the value is not set)\n     *\n     * @see https://developer.chrome.com/docs/extensions/mv3/declare_permissions/\n     *\n     * @default undefined\n     */\n    declarative?: boolean | `${ContentScriptDeclarative}` | ContentScriptDeclarative;\n}\n\nexport type ContentScriptOptions = ContentScriptConfig & EntrypointOptions;\n\nexport type ContentScriptEntrypointOptions = Partial<ContentScriptOptions>;\n\n// Append\nexport enum ContentScriptAppend {\n    Last = \"last\",\n    First = \"first\",\n    Replace = \"replace\",\n    Before = \"before\",\n    After = \"after\",\n}\n\n// Mount\nexport type ContentScriptMountFunction = (anchor: Element, container: Element) => void | (() => void);\n\nexport interface ContentScriptMount {\n    mount(): boolean | undefined | void;\n\n    unmount(): boolean | undefined | void;\n}\n\n// Props\nexport interface ContentScriptProps extends ContentScriptEntrypointOptions {\n    anchor: Element;\n}\n\n// Anchor\nexport type ContentScriptAnchor = string | Element | null | undefined;\nexport type ContentScriptAnchorGetter = () => Awaiter<ContentScriptAnchor>;\n\n// Marker\nexport enum ContentScriptMarker {\n    /** In-memory marking (no DOM mutations). */\n    Weak = \"weak\",\n    /** DOM attribute-based marking. */\n    Attribute = \"attribute\",\n}\n\nexport enum ContentScriptMarkerValue {\n    Mounted = \"1\",\n    Unmounted = \"0\",\n}\n\nexport interface ContentScriptMarkerContract {\n    for(anchor: ContentScriptAnchor): ContentScriptMarkerContract;\n\n    /**\n     * Returns elements that are not tracked yet (no marker attribute present).\n     * MUST NOT mutate marker state.\n     */\n    unmarked(): Element[];\n\n    marked(): Element[];\n\n    mark(element: Element, value: ContentScriptMarkerValue): boolean;\n\n    unmark(element: Element): boolean;\n\n    isMarked(element: Element): boolean;\n\n    value(element: Element): ContentScriptMarkerValue | undefined;\n\n    mount(element: Element): boolean;\n\n    unmount(element: Element): boolean;\n\n    reset(): ContentScriptMarkerContract;\n}\n\nexport type ContentScriptMarkerType =\n    | ContentScriptMarker\n    | `${ContentScriptMarker}`\n    | ContentScriptMarkerContract\n    | undefined;\n\nexport type ContentScriptMarkerGetter = (options: ContentScriptOptions) => Awaiter<ContentScriptMarkerType>;\nexport type ContentScriptMarkerResolver = (options: ContentScriptOptions) => Awaiter<ContentScriptMarkerContract>;\n\n// Render\nexport type ContentScriptRenderReactComponent = FC<ContentScriptProps>;\nexport type ContentScriptRenderValue = Element | ReactNode | ContentScriptRenderReactComponent;\nexport type ContentScriptRenderHandler = (props: ContentScriptProps) => Awaiter<undefined | ContentScriptRenderValue>;\n\n// Container\nexport type ContentScriptContainerTag = Exclude<keyof HTMLElementTagNameMap, \"html\" | \"body\">;\n\nexport type ContentScriptContainerOptions = {\n    [Tag in ContentScriptContainerTag]: {\n        tagName: Tag;\n    } & Exclude<Optional<PickNonFunctionProperties<HTMLElementTagNameMap[Tag]>>, \"id\">;\n}[ContentScriptContainerTag];\n\nexport type ContentScriptContainerFactory = (\n    props: ContentScriptProps\n) => Awaiter<Element | ContentScriptContainerTag | ContentScriptContainerOptions>;\nexport type ContentScriptContainerCreator = (props: ContentScriptProps) => Awaiter<Element>;\n\n// Watch\nexport type ContentScriptWatchStrategy = (update: () => void, context: ContentScriptContext) => () => void;\n\n// Event\nexport enum ContentScriptEvent {\n    Mount = \"mount\",\n    Unmount = \"unmount\",\n    Add = \"add\",\n    Remove = \"remove\",\n}\n\nexport type ContentScriptEventCallback = (event: ContentScriptEvent, node: ContentScriptNode) => void;\n\nexport interface ContentScriptEventEmitter {\n    on(callback: ContentScriptEventCallback): void;\n\n    off(callback: ContentScriptEventCallback): void;\n\n    emit(event: ContentScriptEvent, node: ContentScriptNode): void;\n\n    emitMount(node: ContentScriptNode): void;\n\n    emitUnmount(node: ContentScriptNode): void;\n\n    emitAdd(node: ContentScriptNode): void;\n\n    emitRemove(node: ContentScriptNode): void;\n\n    removeAllListeners(): void;\n\n    listenerCount(): number;\n\n    hasListeners(): boolean;\n}\n\n// Context\nexport interface ContentScriptContext extends ContentScriptMount {\n    nodes: ReadonlySet<ContentScriptNode>;\n\n    /**\n     * Registers a callback function that will be invoked when a specific content script context event occurs.\n     *\n     * @param {ContentScriptEventCallback} callback - The function to be executed when the event is triggered. Receives event-related data as its argument.\n     * @return {Function} A function that can be called to unsubscribe the callback from the event.\n     */\n    watch(callback: ContentScriptEventCallback): () => void;\n\n    /**\n     * Stops watching for changes or events that were previously being observed.\n     * Unsubscribes from all event listeners that were registered through the watch method.\n     *\n     * @return {void} No return value.\n     */\n    unwatch(): void;\n}\n\n// Main\nexport type ContentScriptMainFunction = (context: ContentScriptContext, options: ContentScriptOptions) => Awaiter<void>;\n\n// Node\nexport interface ContentScriptNode extends ContentScriptMount {\n    anchor: Element;\n    container?: Element;\n}\n\nexport type ContentScriptNodeSet = Set<ContentScriptNode>;\n\n// Definition\nexport interface ContentScriptDefinition extends ContentScriptEntrypointOptions {\n    marker?: ContentScriptMarkerType | ContentScriptMarkerGetter;\n    anchor?: ContentScriptAnchor | ContentScriptAnchorGetter;\n    mount?: ContentScriptMountFunction;\n    render?: ContentScriptRenderValue | ContentScriptRenderHandler;\n    container?: ContentScriptContainerTag | ContentScriptContainerOptions | ContentScriptContainerFactory;\n    watch?: true | ContentScriptWatchStrategy;\n    main?: ContentScriptMainFunction;\n}\n\n// prettier-ignore\nexport interface ContentScriptResolvedDefinition extends Omit<ContentScriptDefinition, \"anchor\" | \"marker\" | \"mount\" | \"container\" | \"render\" | \"watch\"> {\n    marker: ContentScriptMarkerResolver;\n    anchor: ContentScriptAnchorGetter;\n    mount: ContentScriptMountFunction;\n    render?: ContentScriptRenderHandler;\n    container: ContentScriptContainerCreator;\n    watch: ContentScriptWatchStrategy;\n}\n\nexport interface ContentScriptAppendDefinition extends Omit<ContentScriptDefinition, \"mount\"> {\n    append?: ContentScriptAppend;\n}\n\n// Builder\nexport interface ContentScriptBuilder extends EntrypointBuilder {\n    getContext(): ContentScriptContext;\n}\n"],"mappings":"AASO,MAAM,uBAAuB,CAAC,cAAc,aAAa;AAEzD,IAAK,2BAAL,kBAAKA,8BAAL;AACH,EAAAA,0BAAA,cAAW;AACX,EAAAA,0BAAA,cAAW;AAFH,SAAAA;AAAA,GAAA;AAqEL,IAAK,sBAAL,kBAAKC,yBAAL;AACH,EAAAA,qBAAA,UAAO;AACP,EAAAA,qBAAA,WAAQ;AACR,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,WAAQ;AALA,SAAAA;AAAA,GAAA;AA2BL,IAAK,sBAAL,kBAAKC,yBAAL;AAEH,EAAAA,qBAAA,UAAO;AAEP,EAAAA,qBAAA,eAAY;AAJJ,SAAAA;AAAA,GAAA;AAOL,IAAK,2BAAL,kBAAKC,8BAAL;AACH,EAAAA,0BAAA,aAAU;AACV,EAAAA,0BAAA,eAAY;AAFJ,SAAAA;AAAA,GAAA;AA+DL,IAAK,qBAAL,kBAAKC,wBAAL;AACH,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,SAAM;AACN,EAAAA,oBAAA,YAAS;AAJD,SAAAA;AAAA,GAAA;","names":["ContentScriptDeclarative","ContentScriptAppend","ContentScriptMarker","ContentScriptMarkerValue","ContentScriptEvent"]}
+{"version":3,"sources":["../../src/types/content.ts"],"sourcesContent":["import type {PageAlias} from \"@typing/page\";\nimport type {FC, ReactNode} from \"react\";\nimport {Optional} from \"utility-types\";\n\nimport {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport {Awaiter, PickNonFunctionProperties} from \"@typing/helpers\";\n\nexport const ContentScriptMatches = [\"http://*/*\", \"https://*/*\"];\n\n/** Shared property used by the bundler plugin and the content script's style runtime getter. */\nexport const ContentScriptStylesRuntimeProperty = \"__adnbnIsolatedStyles\";\n\nexport enum ContentScriptWorld {\n    Isolated = \"ISOLATED\",\n    Main = \"MAIN\",\n}\n\nexport enum ContentScriptDeclarative {\n    Required = \"required\",\n    Optional = \"optional\",\n}\n\nexport enum ContentScriptIsolation {\n    None = \"none\",\n    Shadow = \"shadow\",\n    Iframe = \"iframe\",\n}\n\nexport enum ContentScriptShadowMode {\n    Open = \"open\",\n    Closed = \"closed\",\n}\n\n// Append\nexport enum ContentScriptAppend {\n    Last = \"last\",\n    First = \"first\",\n    Replace = \"replace\",\n    Before = \"before\",\n    After = \"after\",\n}\n\n// Marker\nexport enum ContentScriptMarker {\n    /** In-memory marking (no DOM mutations). */\n    Weak = \"weak\",\n    /** DOM attribute-based marking. */\n    Attribute = \"attribute\",\n}\n\nexport enum ContentScriptMarkerValue {\n    Mounted = \"1\",\n    Unmounted = \"0\",\n}\n\n// Event\nexport enum ContentScriptEvent {\n    Mount = \"mount\",\n    Unmount = \"unmount\",\n    Add = \"add\",\n    Remove = \"remove\",\n}\n\ntype RunAt = chrome.extensionTypes.RunAt;\n\nexport interface ContentScriptStylesRuntime {\n    /** Resolves initial stylesheet URLs once, before the first root is registered. */\n    initialize(resolveUrl: (file: string) => string): void;\n    /** Retry restored styles once on load error; future loads keep the default failure behavior. */\n    add(root: ShadowRoot | HTMLElement, target: Element | null, retry?: boolean): void;\n    delete(root: ShadowRoot | HTMLElement): void;\n    load(url: string): Promise<void>;\n}\n\nexport type ContentScriptWorldValue = ContentScriptWorld | `${chrome.scripting.ExecutionWorld}`;\n\nexport interface ContentScriptConfig {\n    matches?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default []\n     */\n    excludeMatches?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default []\n     */\n    includeGlobs?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default []\n     */\n    excludeGlobs?: string[];\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default false\n     */\n    allFrames?: boolean;\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default \"documentIdle\"\n     */\n    runAt?: RunAt;\n    /**\n     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world\n     *\n     * Dynamic imports keep physical async chunks in ISOLATED. MAIN keeps the same Promise-based\n     * execution semantics but includes dynamic dependencies in the initial entrypoint graph.\n     * Manifest V2 builds always use ISOLATED. Requesting MAIN emits a build warning and applies\n     * ISOLATED grouping and chunk loading rules before generating the manifest.\n     */\n    world?: ContentScriptWorldValue;\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default false\n     */\n    matchAboutBlank?: boolean;\n    /**\n     * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/\n     * @default false\n     */\n    matchOriginAsFallback?: boolean;\n    /**\n     * Whether this content script requires explicit host permission declaration in the extension manifest.\n     *\n     * Accepted values:\n     * - ContentScriptDeclarative.Required — adds the corresponding host patterns to manifest.host_permissions.\n     * - ContentScriptDeclarative.Optional — adds the corresponding host patterns to manifest.optional_host_permissions.\n     *\n     * Backward compatibility:\n     * - true ≡ ContentScriptDeclarative.Required\n     * - false ≡ undefined (as if the value is not set)\n     *\n     * @see https://developer.chrome.com/docs/extensions/mv3/declare_permissions/\n     *\n     * @default undefined\n     */\n    declarative?: boolean | `${ContentScriptDeclarative}` | ContentScriptDeclarative;\n}\n\nexport type ContentScriptOptions = ContentScriptConfig & EntrypointOptions;\n\nexport interface ContentScriptShadowOptions {\n    /**\n     * Controls access through the host's shadowRoot property, not CSS isolation or UI visibility.\n     * @default ContentScriptShadowMode.Open\n     */\n    mode?: ContentScriptShadowMode | `${ContentScriptShadowMode}`;\n}\n\nexport interface ContentScriptFrameOptions {\n    width?: number | string;\n    /** Defaults to 150px. Automatic height is not supported yet. */\n    height?: number | string;\n}\n\nexport interface ContentScriptFrameRenderOptions extends ContentScriptFrameOptions {\n    page?: never;\n    src?: never;\n}\n\nexport interface ContentScriptFramePageOptions extends ContentScriptFrameOptions {\n    page: PageAlias;\n    src?: never;\n}\n\nexport interface ContentScriptFrameSourceOptions extends ContentScriptFrameOptions {\n    src: string;\n    page?: never;\n}\n\nexport type ContentScriptFrame =\n    | ContentScriptFrameRenderOptions\n    | ContentScriptFramePageOptions\n    | ContentScriptFrameSourceOptions;\n\nexport interface ContentScriptIsolationNoneOptions {\n    type: ContentScriptIsolation.None | \"none\";\n    mode?: never;\n    page?: never;\n    src?: never;\n    width?: never;\n    height?: never;\n}\n\nexport interface ContentScriptIsolationShadowOptions extends ContentScriptShadowOptions {\n    type: ContentScriptIsolation.Shadow | \"shadow\";\n    page?: never;\n    src?: never;\n    width?: never;\n    height?: never;\n}\n\nexport type ContentScriptIsolationFrameOptions = ContentScriptFrame & {\n    type: ContentScriptIsolation.Iframe | \"iframe\";\n    mode?: never;\n};\n\n/** Object form of isolation, also used after resolving shorthand values. */\nexport type ContentScriptIsolationOptions =\n    | ContentScriptIsolationNoneOptions\n    | ContentScriptIsolationShadowOptions\n    | ContentScriptIsolationFrameOptions;\n\nexport type ContentScriptIsolationValue =\n    | ContentScriptIsolation\n    | `${ContentScriptIsolation}`\n    | ContentScriptIsolationOptions;\n\n/** Statically resolved configuration; runtime render values are never retained here. */\nexport type ContentScriptEntrypointOptions = Partial<ContentScriptOptions> & {\n    isolation?: ContentScriptIsolationOptions;\n};\n\n// Mount\nexport type ContentScriptMountFunction = (anchor: Element, container: Element) => void | (() => void);\n\nexport interface ContentScriptMount {\n    mount(): boolean | undefined | void;\n\n    unmount(): boolean | undefined | void;\n}\n\n// Props\nexport interface ContentScriptProps extends ContentScriptEntrypointOptions {\n    anchor: Element;\n}\n\n// Anchor\nexport type ContentScriptAnchor = string | Element | null | undefined;\n\nexport type ContentScriptAnchorGetter = () => Awaiter<ContentScriptAnchor>;\n\nexport interface ContentScriptMarkerContract {\n    for(anchor: ContentScriptAnchor): ContentScriptMarkerContract;\n\n    /**\n     * Returns elements that are not tracked yet (no marker attribute present).\n     * MUST NOT mutate marker state.\n     */\n    unmarked(): Element[];\n\n    marked(): Element[];\n\n    mark(element: Element, value: ContentScriptMarkerValue): boolean;\n\n    unmark(element: Element): boolean;\n\n    isMarked(element: Element): boolean;\n\n    value(element: Element): ContentScriptMarkerValue | undefined;\n\n    mount(element: Element): boolean;\n\n    unmount(element: Element): boolean;\n\n    reset(): ContentScriptMarkerContract;\n}\n\nexport type ContentScriptMarkerType =\n    | ContentScriptMarker\n    | `${ContentScriptMarker}`\n    | ContentScriptMarkerContract\n    | undefined;\n\nexport type ContentScriptMarkerGetter = (options: ContentScriptOptions) => Awaiter<ContentScriptMarkerType>;\n\nexport type ContentScriptMarkerResolver = (options: ContentScriptOptions) => Awaiter<ContentScriptMarkerContract>;\n\n// Render\nexport type ContentScriptRenderReactComponent = FC<ContentScriptProps>;\n\nexport type ContentScriptRenderValue = Element | ReactNode | ContentScriptRenderReactComponent;\n\nexport type ContentScriptRenderHandler = (props: ContentScriptProps) => Awaiter<undefined | ContentScriptRenderValue>;\n\n// Container\nexport type ContentScriptContainerTag = Exclude<keyof HTMLElementTagNameMap, \"html\" | \"body\">;\n\nexport type ContentScriptContainerOptions = {\n    [Tag in ContentScriptContainerTag]: {\n        tagName: Tag;\n    } & Exclude<Optional<PickNonFunctionProperties<HTMLElementTagNameMap[Tag]>>, \"id\">;\n}[ContentScriptContainerTag];\n\nexport type ContentScriptContainerFactory = (\n    props: ContentScriptProps\n) => Awaiter<Element | ContentScriptContainerTag | ContentScriptContainerOptions>;\n\nexport type ContentScriptContainerCreator = (props: ContentScriptProps) => Awaiter<Element>;\n\n// Watch\nexport type ContentScriptWatchStrategy = (update: () => void, context: ContentScriptContext) => () => void;\n\nexport type ContentScriptEventCallback = (event: ContentScriptEvent, node: ContentScriptNode) => void;\n\nexport interface ContentScriptEventEmitter {\n    on(callback: ContentScriptEventCallback): void;\n\n    off(callback: ContentScriptEventCallback): void;\n\n    emit(event: ContentScriptEvent, node: ContentScriptNode): void;\n\n    emitMount(node: ContentScriptNode): void;\n\n    emitUnmount(node: ContentScriptNode): void;\n\n    emitAdd(node: ContentScriptNode): void;\n\n    emitRemove(node: ContentScriptNode): void;\n\n    removeAllListeners(): void;\n\n    listenerCount(): number;\n\n    hasListeners(): boolean;\n}\n\n// Context\nexport interface ContentScriptContext extends ContentScriptMount {\n    nodes: ReadonlySet<ContentScriptNode>;\n\n    /**\n     * Registers a callback function that will be invoked when a specific content script context event occurs.\n     *\n     * @param {ContentScriptEventCallback} callback - The function to be executed when the event is triggered. Receives event-related data as its argument.\n     * @return {Function} A function that can be called to unsubscribe the callback from the event.\n     */\n    watch(callback: ContentScriptEventCallback): () => void;\n\n    /**\n     * Stops watching for changes or events that were previously being observed.\n     * Unsubscribes from all event listeners that were registered through the watch method.\n     *\n     * @return {void} No return value.\n     */\n    unwatch(): void;\n}\n\n// Main\nexport type ContentScriptMainFunction = (context: ContentScriptContext, options: ContentScriptOptions) => Awaiter<void>;\n\n// Node\nexport interface ContentScriptNode extends ContentScriptMount {\n    anchor: Element;\n    container?: Element;\n\n    /** Element used by the active adapter as the destination for rendered UI. */\n    target?: Element;\n}\n\nexport type ContentScriptNodeSet = Set<ContentScriptNode>;\n\n// Definition\nexport interface ContentScriptDefinitionBase extends Partial<ContentScriptOptions> {\n    marker?: ContentScriptMarkerType | ContentScriptMarkerGetter;\n    anchor?: ContentScriptAnchor | ContentScriptAnchorGetter;\n    mount?: ContentScriptMountFunction;\n    container?: ContentScriptContainerTag | ContentScriptContainerOptions | ContentScriptContainerFactory;\n    watch?: true | ContentScriptWatchStrategy;\n    main?: ContentScriptMainFunction;\n}\n\nexport type ContentScriptDefinition = ContentScriptDefinitionBase &\n    (\n        | {\n              isolation?:\n                  | ContentScriptIsolation\n                  | `${ContentScriptIsolation}`\n                  | ContentScriptIsolationNoneOptions\n                  | ContentScriptIsolationShadowOptions\n                  | (ContentScriptIsolationFrameOptions & ContentScriptFrameRenderOptions);\n              render?: ContentScriptRenderValue | ContentScriptRenderHandler;\n          }\n        | {\n              isolation: ContentScriptIsolationFrameOptions &\n                  (ContentScriptFramePageOptions | ContentScriptFrameSourceOptions);\n              render?: never;\n          }\n    );\n\nexport interface ContentScriptResolvedDefinition extends Omit<\n    ContentScriptDefinitionBase,\n    \"anchor\" | \"marker\" | \"mount\" | \"container\" | \"watch\"\n> {\n    isolation: ContentScriptIsolationOptions;\n    marker: ContentScriptMarkerResolver;\n    anchor: ContentScriptAnchorGetter;\n    mount: ContentScriptMountFunction;\n    render?: ContentScriptRenderHandler;\n    container: ContentScriptContainerCreator;\n    watch: ContentScriptWatchStrategy;\n}\n\ntype ContentScriptAppendVariant<T> = T extends unknown ? Omit<T, \"mount\"> & {append?: ContentScriptAppend} : never;\n\nexport type ContentScriptAppendDefinition = ContentScriptAppendVariant<ContentScriptDefinition>;\n\n// Builder\nexport interface ContentScriptBuilder extends EntrypointBuilder {\n    getContext(): ContentScriptContext;\n}\n"],"mappings":"AAOO,MAAM,uBAAuB,CAAC,cAAc,aAAa;AAGzD,MAAM,qCAAqC;AAE3C,IAAK,qBAAL,kBAAKA,wBAAL;AACH,EAAAA,oBAAA,cAAW;AACX,EAAAA,oBAAA,UAAO;AAFC,SAAAA;AAAA,GAAA;AAKL,IAAK,2BAAL,kBAAKC,8BAAL;AACH,EAAAA,0BAAA,cAAW;AACX,EAAAA,0BAAA,cAAW;AAFH,SAAAA;AAAA,GAAA;AAKL,IAAK,yBAAL,kBAAKC,4BAAL;AACH,EAAAA,wBAAA,UAAO;AACP,EAAAA,wBAAA,YAAS;AACT,EAAAA,wBAAA,YAAS;AAHD,SAAAA;AAAA,GAAA;AAML,IAAK,0BAAL,kBAAKC,6BAAL;AACH,EAAAA,yBAAA,UAAO;AACP,EAAAA,yBAAA,YAAS;AAFD,SAAAA;AAAA,GAAA;AAML,IAAK,sBAAL,kBAAKC,yBAAL;AACH,EAAAA,qBAAA,UAAO;AACP,EAAAA,qBAAA,WAAQ;AACR,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,WAAQ;AALA,SAAAA;AAAA,GAAA;AASL,IAAK,sBAAL,kBAAKC,yBAAL;AAEH,EAAAA,qBAAA,UAAO;AAEP,EAAAA,qBAAA,eAAY;AAJJ,SAAAA;AAAA,GAAA;AAOL,IAAK,2BAAL,kBAAKC,8BAAL;AACH,EAAAA,0BAAA,aAAU;AACV,EAAAA,0BAAA,eAAY;AAFJ,SAAAA;AAAA,GAAA;AAML,IAAK,qBAAL,kBAAKC,wBAAL;AACH,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,SAAM;AACN,EAAAA,oBAAA,YAAS;AAJD,SAAAA;AAAA,GAAA;","names":["ContentScriptWorld","ContentScriptDeclarative","ContentScriptIsolation","ContentScriptShadowMode","ContentScriptAppend","ContentScriptMarker","ContentScriptMarkerValue","ContentScriptEvent"]}

package/dist/types/entrypoint.d.ts

@@ -2,6 +2,8 @@ import { Mode } from "./app.js";
 import { Browser } from "./browser.js";
 import { ManifestVersion } from "./manifest.js";
 export declare const EntrypointFileExtensions: ReadonlySet<string>;
+export declare const EntrypointAssetsRuntimeProperty = "__adnbnCurrentEntrypointAssets";
+export declare const EntrypointAssetsMapRuntimeProperty = "__adnbnBuildAssets";
 export declare enum EntrypointType {
     Background = "background",
     Command = "command",
@@ -76,6 +78,18 @@ export interface EntrypointFile {
  * These files will be compiled and bundled together as part of the specified entrypoint.
  */
 export type EntrypointEntries = Map<string, Set<EntrypointFile>>;
+export interface EntrypointAssetsFiles {
+    readonly js: readonly string[];
+    readonly css: readonly string[];
+}
+export interface EntrypointAssets {
+    readonly initial: EntrypointAssetsFiles;
+    readonly async: EntrypointAssetsFiles;
+}
+export interface EntrypointAssetsMapEntry extends EntrypointAssets {
+    readonly assets: readonly string[];
+}
+export type EntrypointAssetsMap = Readonly<Record<string, EntrypointAssetsMapEntry>>;
 export interface EntrypointParser<O extends EntrypointOptions> {
     options(file: EntrypointFile): O;
     contract(file: EntrypointFile): string | undefined;
@@ -85,6 +99,12 @@ export interface EntrypointFinder {
     empty(): Promise<boolean>;
     exists(): Promise<boolean>;
     clear(): this;
+    /**
+     * Determines if the specified file exists within the current set of files.
+     *
+     * @param {EntrypointFile} file - The file to be checked for existence in the set of files.
+     * @return {boolean} Returns true if the file exists in the set, otherwise false.
+     */
     holds(file: EntrypointFile): boolean;
 }
 export interface EntrypointOptionsFinder<O extends EntrypointOptions> extends EntrypointFinder {

package/dist/types/entrypoint.js

@@ -1,4 +1,6 @@
 const EntrypointFileExtensions = /* @__PURE__ */ new Set(["ts", "tsx", "js", "jsx", "vue", "svelte"]);
+const EntrypointAssetsRuntimeProperty = "__adnbnCurrentEntrypointAssets";
+const EntrypointAssetsMapRuntimeProperty = "__adnbnBuildAssets";
 var EntrypointType = /* @__PURE__ */ ((EntrypointType2) => {
   EntrypointType2["Background"] = "background";
   EntrypointType2["Command"] = "command";
@@ -14,6 +16,8 @@ var EntrypointType = /* @__PURE__ */ ((EntrypointType2) => {
   return EntrypointType2;
 })(EntrypointType || {});
 export {
+  EntrypointAssetsMapRuntimeProperty,
+  EntrypointAssetsRuntimeProperty,
   EntrypointFileExtensions,
   EntrypointType
 };

package/dist/types/entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/entrypoint.ts"],"sourcesContent":["import {Mode} from \"@typing/app\";\nimport {Browser} from \"@typing/browser\";\nimport {ManifestVersion} from \"@typing/manifest\";\n\nexport const EntrypointFileExtensions: ReadonlySet<string> = new Set([\"ts\", \"tsx\", \"js\", \"jsx\", \"vue\", \"svelte\"]);\n\nexport enum EntrypointType {\n    Background = \"background\",\n    Command = \"command\",\n    ContentScript = \"content\",\n    Page = \"page\",\n    Service = \"service\",\n    Relay = \"relay\",\n    Options = \"options\",\n    Popup = \"popup\",\n    Sidebar = \"sidebar\",\n    Offscreen = \"offscreen\",\n    Sandbox = \"sandbox\",\n}\n\nexport interface EntrypointOptions {\n    /**\n     * List of target browsers to include this entrypoint in. Defaults to being included in all\n     * builds.\n     *\n     * @default undefined\n     */\n    includeBrowser?: `${Browser}`[] | Browser[];\n\n    /**\n     * List of target browsers to exclude this entrypoint from.\n     *\n     * @default undefined\n     */\n    excludeBrowser?: `${Browser}`[] | Browser[];\n\n    /**\n     * List of target apps to include this entrypoint in. Defaults to being included in all builds.\n     *\n     * @default undefined\n     */\n    excludeApp?: string[];\n\n    /**\n     * List of target apps to exclude this entrypoint from.\n     *\n     * @default undefined\n     */\n    includeApp?: string[];\n\n    /**\n     * Build mode for filtering entry points. Entry point will be included only\n     * if it matches the current build mode (Production or Development).\n     *\n     * @default undefined\n     */\n    mode?: `${Exclude<Mode, Mode.None>}` | Exclude<Mode, Mode.None>;\n\n    /**\n     * Manifest version constraint for this entry point. Entry point will be included\n     * only if it matches the target manifest version.\n     *\n     * @default undefined\n     */\n    manifestVersion?: ManifestVersion;\n\n    /**\n     * Debug mode flag. If true, entry point will be included only when building\n     * with DEBUG flag enabled.\n     *\n     * @default undefined\n     */\n    debug?: boolean;\n}\n\nexport interface EntrypointFile {\n    file: string;\n    import: string;\n    external?: string;\n}\n\n/**\n * Dictionary of entrypoint for the build configuration.\n *\n * @key {string} - The name of the entrypoint that will be used in the bundler configuration.\n * @value {EntrypointFile[]} - Array of files that will be included in this entrypoint.\n * These files will be compiled and bundled together as part of the specified entrypoint.\n */\nexport type EntrypointEntries = Map<string, Set<EntrypointFile>>;\n\nexport interface EntrypointParser<O extends EntrypointOptions> {\n    options(file: EntrypointFile): O;\n\n    contract(file: EntrypointFile): string | undefined;\n}\n\nexport interface EntrypointFinder {\n    files(): Promise<Set<EntrypointFile>>;\n\n    empty(): Promise<boolean>;\n\n    exists(): Promise<boolean>;\n\n    clear(): this;\n\n    holds(file: EntrypointFile): boolean;\n}\n\nexport interface EntrypointOptionsFinder<O extends EntrypointOptions> extends EntrypointFinder {\n    type(): EntrypointType;\n\n    options(): Promise<Map<EntrypointFile, O>>;\n\n    contracts(): Promise<Map<EntrypointFile, string | undefined>>;\n}\n\nexport interface EntrypointNameGenerator {\n    reserve(name: string): this;\n\n    name(name: string): string;\n\n    file(file: EntrypointFile): string;\n\n    likely(name?: string): boolean;\n\n    has(name: string): boolean;\n\n    reset(): this;\n}\n\nexport interface EntrypointBuilder {\n    build(): Promise<void>;\n\n    destroy(): Promise<void>;\n}\n\nexport type EntrypointConstructorParameter<T> = T extends new (arg: infer P) => any ? P : never;\n"],"mappings":"AAIO,MAAM,2BAAgD,oBAAI,IAAI,CAAC,MAAM,OAAO,MAAM,OAAO,OAAO,QAAQ,CAAC;AAEzG,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,mBAAgB;AAChB,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,aAAU;AAXF,SAAAA;AAAA,GAAA;","names":["EntrypointType"]}
+{"version":3,"sources":["../../src/types/entrypoint.ts"],"sourcesContent":["import {Mode} from \"@typing/app\";\nimport {Browser} from \"@typing/browser\";\nimport {ManifestVersion} from \"@typing/manifest\";\n\nexport const EntrypointFileExtensions: ReadonlySet<string> = new Set([\"ts\", \"tsx\", \"js\", \"jsx\", \"vue\", \"svelte\"]);\n\nexport const EntrypointAssetsRuntimeProperty = \"__adnbnCurrentEntrypointAssets\";\nexport const EntrypointAssetsMapRuntimeProperty = \"__adnbnBuildAssets\";\n\nexport enum EntrypointType {\n    Background = \"background\",\n    Command = \"command\",\n    ContentScript = \"content\",\n    Page = \"page\",\n    Service = \"service\",\n    Relay = \"relay\",\n    Options = \"options\",\n    Popup = \"popup\",\n    Sidebar = \"sidebar\",\n    Offscreen = \"offscreen\",\n    Sandbox = \"sandbox\",\n}\n\nexport interface EntrypointOptions {\n    /**\n     * List of target browsers to include this entrypoint in. Defaults to being included in all\n     * builds.\n     *\n     * @default undefined\n     */\n    includeBrowser?: `${Browser}`[] | Browser[];\n\n    /**\n     * List of target browsers to exclude this entrypoint from.\n     *\n     * @default undefined\n     */\n    excludeBrowser?: `${Browser}`[] | Browser[];\n\n    /**\n     * List of target apps to include this entrypoint in. Defaults to being included in all builds.\n     *\n     * @default undefined\n     */\n    excludeApp?: string[];\n\n    /**\n     * List of target apps to exclude this entrypoint from.\n     *\n     * @default undefined\n     */\n    includeApp?: string[];\n\n    /**\n     * Build mode for filtering entry points. Entry point will be included only\n     * if it matches the current build mode (Production or Development).\n     *\n     * @default undefined\n     */\n    mode?: `${Exclude<Mode, Mode.None>}` | Exclude<Mode, Mode.None>;\n\n    /**\n     * Manifest version constraint for this entry point. Entry point will be included\n     * only if it matches the target manifest version.\n     *\n     * @default undefined\n     */\n    manifestVersion?: ManifestVersion;\n\n    /**\n     * Debug mode flag. If true, entry point will be included only when building\n     * with DEBUG flag enabled.\n     *\n     * @default undefined\n     */\n    debug?: boolean;\n}\n\nexport interface EntrypointFile {\n    file: string;\n    import: string;\n    external?: string;\n}\n\n/**\n * Dictionary of entrypoint for the build configuration.\n *\n * @key {string} - The name of the entrypoint that will be used in the bundler configuration.\n * @value {EntrypointFile[]} - Array of files that will be included in this entrypoint.\n * These files will be compiled and bundled together as part of the specified entrypoint.\n */\nexport type EntrypointEntries = Map<string, Set<EntrypointFile>>;\n\nexport interface EntrypointAssetsFiles {\n    readonly js: readonly string[];\n    readonly css: readonly string[];\n}\n\nexport interface EntrypointAssets {\n    readonly initial: EntrypointAssetsFiles;\n    readonly async: EntrypointAssetsFiles;\n}\n\nexport interface EntrypointAssetsMapEntry extends EntrypointAssets {\n    readonly assets: readonly string[];\n}\n\nexport type EntrypointAssetsMap = Readonly<Record<string, EntrypointAssetsMapEntry>>;\n\nexport interface EntrypointParser<O extends EntrypointOptions> {\n    options(file: EntrypointFile): O;\n\n    contract(file: EntrypointFile): string | undefined;\n}\n\nexport interface EntrypointFinder {\n    files(): Promise<Set<EntrypointFile>>;\n\n    empty(): Promise<boolean>;\n\n    exists(): Promise<boolean>;\n\n    clear(): this;\n\n    /**\n     * Determines if the specified file exists within the current set of files.\n     *\n     * @param {EntrypointFile} file - The file to be checked for existence in the set of files.\n     * @return {boolean} Returns true if the file exists in the set, otherwise false.\n     */\n    holds(file: EntrypointFile): boolean;\n}\n\nexport interface EntrypointOptionsFinder<O extends EntrypointOptions> extends EntrypointFinder {\n    type(): EntrypointType;\n\n    options(): Promise<Map<EntrypointFile, O>>;\n\n    contracts(): Promise<Map<EntrypointFile, string | undefined>>;\n}\n\nexport interface EntrypointNameGenerator {\n    reserve(name: string): this;\n\n    name(name: string): string;\n\n    file(file: EntrypointFile): string;\n\n    likely(name?: string): boolean;\n\n    has(name: string): boolean;\n\n    reset(): this;\n}\n\nexport interface EntrypointBuilder {\n    build(): Promise<void>;\n\n    destroy(): Promise<void>;\n}\n\nexport type EntrypointConstructorParameter<T> = T extends new (arg: infer P) => any ? P : never;\n"],"mappings":"AAIO,MAAM,2BAAgD,oBAAI,IAAI,CAAC,MAAM,OAAO,MAAM,OAAO,OAAO,QAAQ,CAAC;AAEzG,MAAM,kCAAkC;AACxC,MAAM,qCAAqC;AAE3C,IAAK,iBAAL,kBAAKA,oBAAL;AACH,EAAAA,gBAAA,gBAAa;AACb,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,mBAAgB;AAChB,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,aAAU;AAXF,SAAAA;AAAA,GAAA;","names":["EntrypointType"]}

package/dist/types/icon.d.ts

@@ -1,3 +1,11 @@
 export declare const DefaultIconGroupName = "default";
 export declare const IconFileExtensions: ReadonlySet<string>;
 export declare const IconSizes: ReadonlySet<number>;
+/**
+ * Empty because icon group names depend on the consuming application's icon files.
+ * Generated `.adnbn/icon.d.ts` declarations augment `adnbn`, adding discovered names as keys with value `true`.
+ */
+export interface IconNameRegistry {
+}
+export type IconName = keyof IconNameRegistry extends never ? string : Extract<keyof IconNameRegistry, string>;
+export type IconsMap = Map<IconName, Record<number, string>>;

package/dist/types/icon.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/icon.ts"],"sourcesContent":["export const DefaultIconGroupName = \"default\";\n\nexport const IconFileExtensions: ReadonlySet<string> = new Set([\"png\"]);\n\nexport const IconSizes: ReadonlySet<number> = new Set([16, 32, 48, 64, 128, 256, 512]);\n"],"mappings":"AAAO,MAAM,uBAAuB;AAE7B,MAAM,qBAA0C,oBAAI,IAAI,CAAC,KAAK,CAAC;AAE/D,MAAM,YAAiC,oBAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC;","names":[]}
+{"version":3,"sources":["../../src/types/icon.ts"],"sourcesContent":["export const DefaultIconGroupName = \"default\";\n\nexport const IconFileExtensions: ReadonlySet<string> = new Set([\"png\"]);\n\nexport const IconSizes: ReadonlySet<number> = new Set([16, 32, 48, 64, 128, 256, 512]);\n\n/**\n * Empty because icon group names depend on the consuming application's icon files.\n * Generated `.adnbn/icon.d.ts` declarations augment `adnbn`, adding discovered names as keys with value `true`.\n */\nexport interface IconNameRegistry {}\n\nexport type IconName = keyof IconNameRegistry extends never ? string : Extract<keyof IconNameRegistry, string>;\n\nexport type IconsMap = Map<IconName, Record<number, string>>;\n"],"mappings":"AAAO,MAAM,uBAAuB;AAE7B,MAAM,qBAA0C,oBAAI,IAAI,CAAC,KAAK,CAAC;AAE/D,MAAM,YAAiC,oBAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC;","names":[]}