adnbn 0.12.0 → 0.14.0

package/dist/main/index.d.ts

@@ -11,7 +11,9 @@ export * from "./icon.js";
 export * from "./manifest.js";
 export * from "./offscreen.js";
 export * from "./options.js";
+export * from "./override.js";
 export * from "./page.js";
+export * from "./permissions.js";
 export * from "./plugin.js";
 export * from "./popup.js";
 export * from "./relay.js";

package/dist/main/index.js

@@ -11,7 +11,9 @@ export * from "./icon.js";
 export * from "./manifest.js";
 export * from "./offscreen.js";
 export * from "./options.js";
+export * from "./override.js";
 export * from "./page.js";
+export * from "./permissions.js";
 export * from "./plugin.js";
 export * from "./popup.js";
 export * from "./relay.js";

package/dist/main/index.js.map

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

package/dist/main/override.d.ts

@@ -0,0 +1,5 @@
+import { BookmarksDefinition, BookmarksProps, HistoryDefinition, HistoryProps, NewtabDefinition, NewtabProps } from "../types/override.js";
+export type { NewtabDefinition, NewtabProps, BookmarksDefinition, BookmarksProps, HistoryDefinition, HistoryProps };
+export declare const defineNewtab: (options: NewtabDefinition) => NewtabDefinition;
+export declare const defineBookmarks: (options: BookmarksDefinition) => BookmarksDefinition;
+export declare const defineHistory: (options: HistoryDefinition) => HistoryDefinition;

package/dist/main/override.js

@@ -0,0 +1,15 @@
+const defineNewtab = (options) => {
+  return options;
+};
+const defineBookmarks = (options) => {
+  return options;
+};
+const defineHistory = (options) => {
+  return options;
+};
+export {
+  defineBookmarks,
+  defineHistory,
+  defineNewtab
+};
+//# sourceMappingURL=override.js.map

package/dist/main/override.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/main/override.ts"],"sourcesContent":["import {\n    BookmarksDefinition,\n    BookmarksProps,\n    HistoryDefinition,\n    HistoryProps,\n    NewtabDefinition,\n    NewtabProps,\n} from \"@typing/override\";\n\nexport type {NewtabDefinition, NewtabProps, BookmarksDefinition, BookmarksProps, HistoryDefinition, HistoryProps};\n\nexport const defineNewtab = (options: NewtabDefinition): NewtabDefinition => {\n    return options;\n};\n\nexport const defineBookmarks = (options: BookmarksDefinition): BookmarksDefinition => {\n    return options;\n};\n\nexport const defineHistory = (options: HistoryDefinition): HistoryDefinition => {\n    return options;\n};\n"],"mappings":"AAWO,MAAM,eAAe,CAAC,YAAgD;AACzE,SAAO;AACX;AAEO,MAAM,kBAAkB,CAAC,YAAsD;AAClF,SAAO;AACX;AAEO,MAAM,gBAAgB,CAAC,YAAkD;AAC5E,SAAO;AACX;","names":[]}

package/dist/main/permissions.d.ts

@@ -0,0 +1 @@
+export type { PermissionsOptions } from "../types/permissions.js";

package/dist/main/permissions.js

@@ -0,0 +1 @@
+//# sourceMappingURL=permissions.js.map

package/dist/main/view.d.ts

@@ -1 +1 @@
-export type { ViewDefinition, ViewOptions } from "../types/view.js";
+export type { ViewDefinition, ViewOptions, ViewReactRenderValue, ViewRenderHandler, ViewRenderReactComponent, ViewRenderValue, ViewVanillaRenderValue, } from "../types/view/index.js";

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

@@ -1,5 +1,5 @@
 export { convertLocaleKey, convertLocaleMessageKey, extractLocaleKey, isLocaleKey, modifyLocaleMessageKey } from "./keys.js";
 export { getLocaleDir, isLocaleRtl, resolveLanguage } from "./language.js";
-export { flattenLocaleMessages, getLocaleFilename } from "./messages.js";
+export { escapeLocaleMessage, escapeLocaleMessages, flattenLocaleMessages, getLocaleFilename } from "./messages.js";
 export { selectPluralForm } from "./plural.js";
 export { applySubstitutions, parsePlaceholders } from "./substitutions.js";

package/dist/shared/locale/index.js

@@ -1,12 +1,14 @@
 import { convertLocaleKey, convertLocaleMessageKey, extractLocaleKey, isLocaleKey, modifyLocaleMessageKey } from "./keys.js";
 import { getLocaleDir, isLocaleRtl, resolveLanguage } from "./language.js";
-import { flattenLocaleMessages, getLocaleFilename } from "./messages.js";
+import { escapeLocaleMessage, escapeLocaleMessages, flattenLocaleMessages, getLocaleFilename } from "./messages.js";
 import { selectPluralForm } from "./plural.js";
 import { applySubstitutions, parsePlaceholders } from "./substitutions.js";
 export {
   applySubstitutions,
   convertLocaleKey,
   convertLocaleMessageKey,
+  escapeLocaleMessage,
+  escapeLocaleMessages,
   extractLocaleKey,
   flattenLocaleMessages,
   getLocaleDir,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/shared/locale/index.ts"],"sourcesContent":["export {convertLocaleKey, convertLocaleMessageKey, extractLocaleKey, isLocaleKey, modifyLocaleMessageKey} from \"./keys\";\nexport {getLocaleDir, isLocaleRtl, resolveLanguage} from \"./language\";\nexport {flattenLocaleMessages, getLocaleFilename} from \"./messages\";\nexport {selectPluralForm} from \"./plural\";\nexport {applySubstitutions, parsePlaceholders} from \"./substitutions\";\n"],"mappings":"AAAA,SAAQ,kBAAkB,yBAAyB,kBAAkB,aAAa,8BAA6B;AAC/G,SAAQ,cAAc,aAAa,uBAAsB;AACzD,SAAQ,uBAAuB,yBAAwB;AACvD,SAAQ,wBAAuB;AAC/B,SAAQ,oBAAoB,yBAAwB;","names":[]}
+{"version":3,"sources":["../../../src/shared/locale/index.ts"],"sourcesContent":["export {convertLocaleKey, convertLocaleMessageKey, extractLocaleKey, isLocaleKey, modifyLocaleMessageKey} from \"./keys\";\nexport {getLocaleDir, isLocaleRtl, resolveLanguage} from \"./language\";\nexport {escapeLocaleMessage, escapeLocaleMessages, flattenLocaleMessages, getLocaleFilename} from \"./messages\";\nexport {selectPluralForm} from \"./plural\";\nexport {applySubstitutions, parsePlaceholders} from \"./substitutions\";\n"],"mappings":"AAAA,SAAQ,kBAAkB,yBAAyB,kBAAkB,aAAa,8BAA6B;AAC/G,SAAQ,cAAc,aAAa,uBAAsB;AACzD,SAAQ,qBAAqB,sBAAsB,uBAAuB,yBAAwB;AAClG,SAAQ,wBAAuB;AAC/B,SAAQ,oBAAoB,yBAAwB;","names":[]}

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

@@ -1,3 +1,7 @@
 import type { Language, LocaleMessages } from "../../types/locale.js";
+/** Native i18n consumes the first dollar in each escaped run; the catalogue keeps the original text. */
+export declare const escapeLocaleMessage: (message: string) => string;
+/** Protects literal $NAME$ text from the earlier named-placeholder pass as well. */
+export declare const escapeLocaleMessages: (messages: LocaleMessages) => LocaleMessages;
 export declare const getLocaleFilename: (lang: Language) => string;
 export declare const flattenLocaleMessages: (messages: LocaleMessages) => Record<string, string>;

package/dist/shared/locale/messages.js

@@ -1,8 +1,20 @@
+const escapeLocaleMessage = (message) => message.replace(/\$+/g, (dollars) => "$" + dollars);
+const escapeLocaleMessages = (messages) => Object.fromEntries(
+  Object.entries(messages).map(([key, value]) => {
+    const message = escapeLocaleMessage(value.message);
+    return [
+      key,
+      /\$[a-z0-9_@]+\$/i.test(value.message) ? { ...value, message: "$text$", placeholders: { text: { content: message } } } : { ...value, message }
+    ];
+  })
+);
 const getLocaleFilename = (lang) => {
   return `_locales/${lang}/messages.json`;
 };
 const flattenLocaleMessages = (messages) => Object.fromEntries(Object.entries(messages).map(([key, value]) => [key, value.message]));
 export {
+  escapeLocaleMessage,
+  escapeLocaleMessages,
   flattenLocaleMessages,
   getLocaleFilename
 };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/shared/locale/messages.ts"],"sourcesContent":["import type {Language, LocaleMessages} from \"@typing/locale\";\n\nexport const getLocaleFilename = (lang: Language): string => {\n    return `_locales/${lang}/messages.json`;\n};\n\nexport const flattenLocaleMessages = (messages: LocaleMessages): Record<string, string> =>\n    Object.fromEntries(Object.entries(messages).map(([key, value]) => [key, value.message]));\n"],"mappings":"AAEO,MAAM,oBAAoB,CAAC,SAA2B;AACzD,SAAO,YAAY,IAAI;AAC3B;AAEO,MAAM,wBAAwB,CAAC,aAClC,OAAO,YAAY,OAAO,QAAQ,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,MAAM,OAAO,CAAC,CAAC;","names":[]}
+{"version":3,"sources":["../../../src/shared/locale/messages.ts"],"sourcesContent":["import type {Language, LocaleMessages} from \"@typing/locale\";\n\n/** Native i18n consumes the first dollar in each escaped run; the catalogue keeps the original text. */\nexport const escapeLocaleMessage = (message: string): string => message.replace(/\\$+/g, dollars => \"$\" + dollars);\n\n/** Protects literal $NAME$ text from the earlier named-placeholder pass as well. */\nexport const escapeLocaleMessages = (messages: LocaleMessages): LocaleMessages =>\n    Object.fromEntries(\n        Object.entries(messages).map(([key, value]) => {\n            const message = escapeLocaleMessage(value.message);\n\n            return [\n                key,\n                /\\$[a-z0-9_@]+\\$/i.test(value.message)\n                    ? {...value, message: \"$text$\", placeholders: {text: {content: message}}}\n                    : {...value, message},\n            ];\n        })\n    );\n\nexport const getLocaleFilename = (lang: Language): string => {\n    return `_locales/${lang}/messages.json`;\n};\n\nexport const flattenLocaleMessages = (messages: LocaleMessages): Record<string, string> =>\n    Object.fromEntries(Object.entries(messages).map(([key, value]) => [key, value.message]));\n"],"mappings":"AAGO,MAAM,sBAAsB,CAAC,YAA4B,QAAQ,QAAQ,QAAQ,aAAW,MAAM,OAAO;AAGzG,MAAM,uBAAuB,CAAC,aACjC,OAAO;AAAA,EACH,OAAO,QAAQ,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AAC3C,UAAM,UAAU,oBAAoB,MAAM,OAAO;AAEjD,WAAO;AAAA,MACH;AAAA,MACA,mBAAmB,KAAK,MAAM,OAAO,IAC/B,EAAC,GAAG,OAAO,SAAS,UAAU,cAAc,EAAC,MAAM,EAAC,SAAS,QAAO,EAAC,EAAC,IACtE,EAAC,GAAG,OAAO,QAAO;AAAA,IAC5B;AAAA,EACJ,CAAC;AACL;AAEG,MAAM,oBAAoB,CAAC,SAA2B;AACzD,SAAO,YAAY,IAAI;AAC3B;AAEO,MAAM,wBAAwB,CAAC,aAClC,OAAO,YAAY,OAAO,QAAQ,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,MAAM,OAAO,CAAC,CAAC;","names":[]}

package/dist/types/background.d.ts

@@ -1,14 +1,9 @@
 import { EntrypointBuilder, EntrypointOptions } from "./entrypoint.js";
 import { Awaiter } from "./helpers.js";
+import { PermissionsOptions } from "./permissions.js";
 export declare const BackgroundEntryName = "background";
-type ManifestPermissions = chrome.runtime.ManifestPermission;
-type ManifestOptionalPermissions = chrome.runtime.ManifestOptionalPermission;
-export interface BackgroundConfig {
+export interface BackgroundConfig extends PermissionsOptions {
     persistent?: boolean;
-    permissions?: ManifestPermissions[];
-    optionalPermissions?: ManifestOptionalPermissions[];
-    hostPermissions?: string[];
-    optionalHostPermissions?: string[];
 }
 export type BackgroundOptions = BackgroundConfig & EntrypointOptions;
 export type BackgroundEntrypointOptions = BackgroundOptions;
@@ -17,4 +12,3 @@ export interface BackgroundDefinition extends BackgroundEntrypointOptions {
     main?: BackgroundMainHandler;
 }
 export type BackgroundBuilder = EntrypointBuilder;
-export {};

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\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":[]}
+{"version":3,"sources":["../../src/types/background.ts"],"sourcesContent":["import {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport {Awaiter} from \"@typing/helpers\";\nimport {PermissionsOptions} from \"@typing/permissions\";\n\nexport const BackgroundEntryName = \"background\";\n\nexport interface BackgroundConfig extends PermissionsOptions {\n    persistent?: boolean;\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":"AAIO,MAAM,sBAAsB;","names":[]}

package/dist/types/content/common.d.ts

@@ -53,6 +53,8 @@ export interface ContentScriptStylesRuntime {
     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;
+    /** Waits for initial and already requested CSS for this root; retries missing failed links. */
+    ready(root: ShadowRoot | HTMLElement): Promise<void>;
     delete(root: ShadowRoot | HTMLElement): void;
     load(url: string): Promise<void>;
 }
@@ -224,6 +226,12 @@ export interface ContentScriptEventEmitter {
 }
 export interface ContentScriptContext extends ContentScriptMount {
     nodes: ReadonlySet<ContentScriptNode>;
+    /**
+     * Whether target belongs to UI mounted by this context, including ShadowRoot descendants.
+     * Already-connected site containers and containers wrapping their anchors are excluded.
+     * Membership ends at unmount. Traversal does not cross an iframe document into its host.
+     */
+    owns(target: Node): boolean;
     /**
      * Registers a callback function that will be invoked when a specific content script context event occurs.
      *

package/dist/types/content/common.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/types/content/common.ts"],"sourcesContent":["import type {ContentScriptPrepareProps} from \"./prepare\";\nimport type {ContentScriptBoundary} from \"./boundary\";\n\nimport type {PageAlias} from \"@typing/page\";\nimport type {Optional} from \"utility-types\";\n\nimport type {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport type {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 ContentScriptFrameRenderOptions {\n    page?: never;\n    src?: never;\n}\n\nexport interface ContentScriptFramePageOptions {\n    page: PageAlias;\n    src?: never;\n}\n\nexport interface ContentScriptFrameSourceOptions {\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}\n\nexport interface ContentScriptIsolationShadowOptions extends ContentScriptShadowOptions {\n    type: ContentScriptIsolation.Shadow | \"shadow\";\n    page?: never;\n    src?: 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 ContentScriptContainerProps<Data = unknown> extends ContentScriptPrepareProps {\n    data: Data;\n}\n\nexport interface ContentScriptProps<\n    Data = unknown,\n    Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`,\n> extends ContentScriptContainerProps<Data> {\n    /** Outer mounted element; the Shadow host or iframe wrapper when isolated. */\n    container: Element;\n    /** Actual render destination. Use its root/document for portals and DOM operations. */\n    target: Element;\n    /** ShadowRoot or iframe for the active isolation; undefined without isolation. */\n    boundary: ContentScriptBoundary<Isolation>;\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// 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<Data = unknown> = (\n    props: ContentScriptContainerProps<Data>\n) => Awaiter<Element | ContentScriptContainerTag | ContentScriptContainerOptions>;\n\nexport type ContentScriptContainerCreator<Data = unknown> = (\n    props: ContentScriptContainerProps<Data>\n) => Awaiter<Element>;\n\n// Watch\nexport type ContentScriptWatchStrategy = (update: () => Awaiter<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    /** Present while isolation is mounted, including navigation-only iframes. */\n    boundary?: ContentScriptBoundary;\n}\n\nexport type ContentScriptNodeSet = Set<ContentScriptNode>;\n\n// Builder\nexport interface ContentScriptBuilder extends EntrypointBuilder {\n    getContext(): ContentScriptContext;\n}\n"],"mappings":"AASO,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"]}
+{"version":3,"sources":["../../../src/types/content/common.ts"],"sourcesContent":["import type {ContentScriptPrepareProps} from \"./prepare\";\nimport type {ContentScriptBoundary} from \"./boundary\";\n\nimport type {PageAlias} from \"@typing/page\";\nimport type {Optional} from \"utility-types\";\n\nimport type {EntrypointBuilder, EntrypointOptions} from \"@typing/entrypoint\";\nimport type {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    /** Waits for initial and already requested CSS for this root; retries missing failed links. */\n    ready(root: ShadowRoot | HTMLElement): Promise<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 ContentScriptFrameRenderOptions {\n    page?: never;\n    src?: never;\n}\n\nexport interface ContentScriptFramePageOptions {\n    page: PageAlias;\n    src?: never;\n}\n\nexport interface ContentScriptFrameSourceOptions {\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}\n\nexport interface ContentScriptIsolationShadowOptions extends ContentScriptShadowOptions {\n    type: ContentScriptIsolation.Shadow | \"shadow\";\n    page?: never;\n    src?: 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 ContentScriptContainerProps<Data = unknown> extends ContentScriptPrepareProps {\n    data: Data;\n}\n\nexport interface ContentScriptProps<\n    Data = unknown,\n    Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`,\n> extends ContentScriptContainerProps<Data> {\n    /** Outer mounted element; the Shadow host or iframe wrapper when isolated. */\n    container: Element;\n    /** Actual render destination. Use its root/document for portals and DOM operations. */\n    target: Element;\n    /** ShadowRoot or iframe for the active isolation; undefined without isolation. */\n    boundary: ContentScriptBoundary<Isolation>;\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// 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<Data = unknown> = (\n    props: ContentScriptContainerProps<Data>\n) => Awaiter<Element | ContentScriptContainerTag | ContentScriptContainerOptions>;\n\nexport type ContentScriptContainerCreator<Data = unknown> = (\n    props: ContentScriptContainerProps<Data>\n) => Awaiter<Element>;\n\n// Watch\nexport type ContentScriptWatchStrategy = (update: () => Awaiter<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     * Whether target belongs to UI mounted by this context, including ShadowRoot descendants.\n     * Already-connected site containers and containers wrapping their anchors are excluded.\n     * Membership ends at unmount. Traversal does not cross an iframe document into its host.\n     */\n    owns(target: Node): boolean;\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    /** Present while isolation is mounted, including navigation-only iframes. */\n    boundary?: ContentScriptBoundary;\n}\n\nexport type ContentScriptNodeSet = Set<ContentScriptNode>;\n\n// Builder\nexport interface ContentScriptBuilder extends EntrypointBuilder {\n    getContext(): ContentScriptContext;\n}\n"],"mappings":"AASO,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/content/definition.d.ts

@@ -9,6 +9,11 @@ export interface ContentScriptDefinitionBase<Data = unknown> extends Partial<Con
     mount?: ContentScriptMountFunction;
     container?: ContentScriptContainerTag | ContentScriptContainerOptions | ContentScriptContainerFactory<NoInfer<Data>>;
     prepare?: ContentScriptPrepareHandler<Data>;
+    /**
+     * Omit to watch until the first nodes are found; true keeps observing child-list changes.
+     * Use a custom strategy to observe attributes or text. Built-in strategies ignore internal
+     * changes in owned UI containers unless a container wraps its own anchor.
+     */
     watch?: true | ContentScriptWatchStrategy;
     main?: ContentScriptMainFunction;
 }

package/dist/types/entrypoint.d.ts

@@ -15,7 +15,10 @@ export declare enum EntrypointType {
     Popup = "popup",
     Sidebar = "sidebar",
     Offscreen = "offscreen",
-    Sandbox = "sandbox"
+    Sandbox = "sandbox",
+    Newtab = "newtab",
+    Bookmarks = "bookmarks",
+    History = "history"
 }
 export interface EntrypointOptions {
     /**
@@ -116,6 +119,7 @@ export interface EntrypointNameGenerator {
     reserve(name: string): this;
     name(name: string): string;
     file(file: EntrypointFile): string;
+    derive(file: EntrypointFile): string;
     likely(name?: string): boolean;
     has(name: string): boolean;
     reset(): this;

package/dist/types/entrypoint.js

@@ -13,6 +13,9 @@ var EntrypointType = /* @__PURE__ */ ((EntrypointType2) => {
   EntrypointType2["Sidebar"] = "sidebar";
   EntrypointType2["Offscreen"] = "offscreen";
   EntrypointType2["Sandbox"] = "sandbox";
+  EntrypointType2["Newtab"] = "newtab";
+  EntrypointType2["Bookmarks"] = "bookmarks";
+  EntrypointType2["History"] = "history";
   return EntrypointType2;
 })(EntrypointType || {});
 export {

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 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"]}
+{"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    Newtab = \"newtab\",\n    Bookmarks = \"bookmarks\",\n    History = \"history\",\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    derive(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;AACV,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,aAAU;AAdF,SAAAA;AAAA,GAAA;","names":["EntrypointType"]}

package/dist/types/locale.d.ts

@@ -23,6 +23,9 @@ export type LocaleKeys = ReadonlySet<string>;
 export type LocaleMessages = {
     [key: string]: {
         message: string;
+        placeholders?: Record<string, {
+            content: string;
+        }>;
     };
 };
 export interface LocaleBuilder {

package/dist/types/locale.js.map

@@ -1 +1 @@
-{"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":"AAAA,SAAQ,gBAAe;AAIhB,MAAM,eAAsC,oBAAI,IAAI,CAAC,SAAS,QAAQ,SAAS,SAAS,SAAS,MAAM,CAAC;AAExG,MAAM,4BAA4B;AAElC,MAAM,sBAAsB;AAE5B,MAAM,wBAAwB;AAE9B,MAAM,6BAA6B;AAEnC,MAAM,kBAAkB;AAExB,MAAM,gBAAqC,IAAI,IAAI,OAAO,OAAO,QAAQ,CAAC;AAG1E,MAAM,gBAAoD,OAAO,OAAO;AAAA,EAC3E,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,gBAAgB,GAAG;AAAA,EAC7B,CAAC,SAAS,mBAAmB,GAAG;AAAA,EAChC,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,+BAA+B,GAAG;AAAA,EAC5C,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,gBAAgB,GAAG;AAAA,EAC7B,CAAC,SAAS,kBAAkB,GAAG;AAAA,EAC/B,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,IAAI,GAAG;AAAA,EACjB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,YAAY,GAAG;AAAA,EACzB,CAAC,SAAS,aAAa,GAAG;AAC9B,CAAC;AAEM,MAAM,uBAA4C,oBAAI,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC;AAEjF,IAAK,YAAL,kBAAKA,eAAL;AACH,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,iBAAc;AAFN,SAAAA;AAAA,GAAA;","names":["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        placeholders?: Record<string, {content: 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":"AAAA,SAAQ,gBAAe;AAIhB,MAAM,eAAsC,oBAAI,IAAI,CAAC,SAAS,QAAQ,SAAS,SAAS,SAAS,MAAM,CAAC;AAExG,MAAM,4BAA4B;AAElC,MAAM,sBAAsB;AAE5B,MAAM,wBAAwB;AAE9B,MAAM,6BAA6B;AAEnC,MAAM,kBAAkB;AAExB,MAAM,gBAAqC,IAAI,IAAI,OAAO,OAAO,QAAQ,CAAC;AAG1E,MAAM,gBAAoD,OAAO,OAAO;AAAA,EAC3E,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,gBAAgB,GAAG;AAAA,EAC7B,CAAC,SAAS,mBAAmB,GAAG;AAAA,EAChC,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,+BAA+B,GAAG;AAAA,EAC5C,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,gBAAgB,GAAG;AAAA,EAC7B,CAAC,SAAS,kBAAkB,GAAG;AAAA,EAC/B,CAAC,SAAS,QAAQ,GAAG;AAAA,EACrB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,KAAK,GAAG;AAAA,EAClB,CAAC,SAAS,MAAM,GAAG;AAAA,EACnB,CAAC,SAAS,IAAI,GAAG;AAAA,EACjB,CAAC,SAAS,OAAO,GAAG;AAAA,EACpB,CAAC,SAAS,SAAS,GAAG;AAAA,EACtB,CAAC,SAAS,UAAU,GAAG;AAAA,EACvB,CAAC,SAAS,YAAY,GAAG;AAAA,EACzB,CAAC,SAAS,aAAa,GAAG;AAC9B,CAAC;AAEM,MAAM,uBAA4C,oBAAI,IAAI,CAAC,QAAQ,OAAO,MAAM,CAAC;AAEjF,IAAK,YAAL,kBAAKA,eAAL;AACH,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,iBAAc;AAFN,SAAAA;AAAA,GAAA;","names":["LocaleDir"]}

package/dist/types/manifest.d.ts

@@ -14,8 +14,8 @@ export declare enum ManifestIncognito {
 }
 type ManifestCommon = chrome.runtime.Manifest;
 type ManifestBase = chrome.runtime.ManifestBase;
-type ManifestPermission = chrome.runtime.ManifestPermission;
-type ManifestOptionalPermission = chrome.runtime.ManifestOptionalPermission;
+export type ManifestPermission = chrome.runtime.ManifestPermission;
+export type ManifestOptionalPermission = chrome.runtime.ManifestOptionalPermission;
 type ManifestFixed<T extends ManifestBase> = Omit<T, "manifest_version"> & {
     manifest_version: ManifestVersion;
 };
@@ -84,6 +84,7 @@ export interface ManifestBuilder<T extends CoreManifest = Manifest> {
     setPopup(popup?: ManifestPopup): this;
     setSidebar(sidebar?: ManifestSidebar): this;
     setOptions(options?: ManifestOptions): this;
+    setOverride(override?: ManifestOverride): this;
     addSandbox(sandbox: ManifestSandbox): this;
     appendSandboxes(sandboxes: Iterable<ManifestSandbox>): this;
     addSandboxCsp(csp: SandboxCspConfig): this;
@@ -164,6 +165,23 @@ export interface ManifestOptions {
      */
     openInTab?: boolean;
 }
+export type ManifestOverridePage = "newtab" | "bookmarks" | "history";
+/**
+ * Chromium refuses to load an extension that overrides more than one page and other browsers
+ * only support `newtab`, so the manifest holds a single override instead of a dictionary.
+ */
+export interface ManifestOverride {
+    /**
+     * Built-in browser page replaced by the extension.
+     * Written as the key of `chrome_url_overrides` in the manifest.
+     */
+    page: ManifestOverridePage;
+    /**
+     * Path to the replacement HTML file relative to the extension root.
+     * Written as the value of `chrome_url_overrides[page]`.
+     */
+    path: string;
+}
 export interface ManifestAccessibleResource {
     resources: string[];
     matches?: 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\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"]}
+{"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\nexport type ManifestPermission = chrome.runtime.ManifestPermission;\n\nexport type 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    setOverride(override?: ManifestOverride): 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 type ManifestOverridePage = \"newtab\" | \"bookmarks\" | \"history\";\n\n/**\n * Chromium refuses to load an extension that overrides more than one page and other browsers\n * only support `newtab`, so the manifest holds a single override instead of a dictionary.\n */\nexport interface ManifestOverride {\n    /**\n     * Built-in browser page replaced by the extension.\n     * Written as the key of `chrome_url_overrides` in the manifest.\n     */\n    page: ManifestOverridePage;\n    /**\n     * Path to the replacement HTML file relative to the extension root.\n     * Written as the value of `chrome_url_overrides[page]`.\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    /** 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/offscreen.d.ts

@@ -1,5 +1,5 @@
 import { TransportConfig, TransportDefinition, TransportProxyTarget, TransportTarget, TransportType } from "./transport.js";
-import { ViewOptions } from "./view.js";
+import { ViewOptions, ViewRenderDefinition } from "./view/index.js";
 import { Awaiter } from "./helpers.js";
 import { CspOptions } from "./csp.js";
 export declare const OffscreenGlobalKey = "adnbnOffscreen";
@@ -57,7 +57,7 @@ export interface OffscreenConfig extends TransportConfig {
 export type OffscreenOptions = OffscreenConfig & CspOptions & ViewOptions;
 export type OffscreenEntrypointOptions = Partial<OffscreenOptions>;
 export type OffscreenMainHandler<T extends TransportType> = (offscreen: T, options: OffscreenEntrypointOptions) => Awaiter<void>;
-export interface OffscreenDefinition<T extends TransportType> extends TransportDefinition<OffscreenOptions, T>, OffscreenEntrypointOptions {
+export interface OffscreenDefinition<T extends TransportType> extends TransportDefinition<OffscreenOptions, T>, OffscreenEntrypointOptions, ViewRenderDefinition<OffscreenEntrypointOptions> {
     main?: OffscreenMainHandler<T>;
 }
 export type OffscreenUnresolvedDefinition<T extends TransportType> = Partial<OffscreenDefinition<T>>;

package/dist/types/offscreen.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/offscreen.ts"],"sourcesContent":["import {\n    TransportConfig,\n    TransportDefinition,\n    TransportProxyTarget,\n    TransportTarget,\n    TransportType,\n} from \"@typing/transport\";\nimport {ViewOptions} from \"@typing/view\";\nimport {Awaiter} from \"@typing/helpers\";\nimport {CspOptions} from \"@typing/csp\";\n\nexport const OffscreenGlobalKey = \"adnbnOffscreen\";\n\nexport const OffscreenGlobalAccess = \"adnbnOffscreenAccess\";\n\nexport const OffscreenBridgeReadyMessageType = \"adnbn:offscreen:ready\";\n\nexport enum OffscreenReason {\n    /** A reason used for testing purposes only. */\n    Testing = \"TESTING\",\n    /** The offscreen document is responsible for playing audio. */\n    AudioPlayback = \"AUDIO_PLAYBACK\",\n    /** The offscreen document needs to embed and script an iframe in order to modify the iframe's content. */\n    IframeScripting = \"IFRAME_SCRIPTING\",\n    /** The offscreen document needs to embed an iframe and scrape its DOM to extract information. */\n    DOMScraping = \"DOM_SCRAPING\",\n    /** The offscreen document needs to interact with Blob objects (including URL.createObjectURL()). */\n    Blobs = \"BLOBS\",\n    /** The offscreen document needs to use the DOMParser API. */\n    DOMParser = \"DOM_PARSER\",\n    /** The offscreen document needs to interact with media streams from user media (e.g. getUserMedia()). */\n    UserMedia = \"USER_MEDIA\",\n    /** The offscreen document needs to interact with media streams from display media (e.g. getDisplayMedia()). */\n    DisplayMedia = \"DISPLAY_MEDIA\",\n    /** The offscreen document needs to use WebRTC APIs. */\n    WebRTC = \"WEB_RTC\",\n    /** The offscreen document needs to interact with the clipboard APIs(e.g. Navigator.clipboard). */\n    Clipboard = \"CLIPBOARD\",\n    /** Specifies that the offscreen document needs access to localStorage. */\n    LocalStorage = \"LOCAL_STORAGE\",\n    /** Specifies that the offscreen document needs to spawn workers. */\n    Workers = \"WORKERS\",\n    /** Specifies that the offscreen document needs to use navigator.getBattery. */\n    BatteryStatus = \"BATTERY_STATUS\",\n    /** Specifies that the offscreen document needs to use window.matchMedia. */\n    MatchMedia = \"MATCH_MEDIA\",\n    /** Specifies that the offscreen document needs to use navigator.geolocation. */\n    Geolocation = \"GEOLOCATION\",\n}\n\n/**\n * Empty because offscreen names and contracts belong to the consuming application.\n * Generated `.adnbn/offscreen.d.ts` declarations populate it by augmenting `adnbn/offscreen`.\n */\nexport interface OffscreenRegistry {}\n\nexport type OffscreenName = Extract<keyof OffscreenRegistry, string>;\n\nexport type OffscreenTarget<N extends keyof OffscreenRegistry> = TransportTarget<OffscreenRegistry, N>;\n\nexport type OffscreenProxyTarget<N extends keyof OffscreenRegistry> = TransportProxyTarget<OffscreenRegistry, N>;\n\nexport type OffscreenAlias = string;\n\nexport type OffscreenMap = Map<OffscreenAlias, OffscreenParameters>;\n\nexport type OffscreenParameters = chrome.offscreen.CreateParameters;\n\nexport type OffscreenParametersMap = Record<string, OffscreenParameters>;\n\nexport interface OffscreenConfig extends TransportConfig {\n    reasons?: `${OffscreenReason}` | `${OffscreenReason}`[] | OffscreenReason | OffscreenReason[];\n    justification?: string;\n}\n\nexport type OffscreenOptions = OffscreenConfig & CspOptions & ViewOptions;\n\nexport type OffscreenEntrypointOptions = Partial<OffscreenOptions>;\n\nexport type OffscreenMainHandler<T extends TransportType> = (\n    offscreen: T,\n    options: OffscreenEntrypointOptions\n) => Awaiter<void>;\n\nexport interface OffscreenDefinition<T extends TransportType>\n    extends TransportDefinition<OffscreenOptions, T>, OffscreenEntrypointOptions {\n    main?: OffscreenMainHandler<T>;\n}\n\nexport type OffscreenUnresolvedDefinition<T extends TransportType> = Partial<OffscreenDefinition<T>>;\n"],"mappings":"AAWO,MAAM,qBAAqB;AAE3B,MAAM,wBAAwB;AAE9B,MAAM,kCAAkC;AAExC,IAAK,kBAAL,kBAAKA,qBAAL;AAEH,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,qBAAkB;AAElB,EAAAA,iBAAA,iBAAc;AAEd,EAAAA,iBAAA,WAAQ;AAER,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,YAAS;AAET,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,gBAAa;AAEb,EAAAA,iBAAA,iBAAc;AA9BN,SAAAA;AAAA,GAAA;","names":["OffscreenReason"]}
+{"version":3,"sources":["../../src/types/offscreen.ts"],"sourcesContent":["import {\n    TransportConfig,\n    TransportDefinition,\n    TransportProxyTarget,\n    TransportTarget,\n    TransportType,\n} from \"@typing/transport\";\nimport {ViewOptions, ViewRenderDefinition} from \"@typing/view\";\nimport {Awaiter} from \"@typing/helpers\";\nimport {CspOptions} from \"@typing/csp\";\n\nexport const OffscreenGlobalKey = \"adnbnOffscreen\";\n\nexport const OffscreenGlobalAccess = \"adnbnOffscreenAccess\";\n\nexport const OffscreenBridgeReadyMessageType = \"adnbn:offscreen:ready\";\n\nexport enum OffscreenReason {\n    /** A reason used for testing purposes only. */\n    Testing = \"TESTING\",\n    /** The offscreen document is responsible for playing audio. */\n    AudioPlayback = \"AUDIO_PLAYBACK\",\n    /** The offscreen document needs to embed and script an iframe in order to modify the iframe's content. */\n    IframeScripting = \"IFRAME_SCRIPTING\",\n    /** The offscreen document needs to embed an iframe and scrape its DOM to extract information. */\n    DOMScraping = \"DOM_SCRAPING\",\n    /** The offscreen document needs to interact with Blob objects (including URL.createObjectURL()). */\n    Blobs = \"BLOBS\",\n    /** The offscreen document needs to use the DOMParser API. */\n    DOMParser = \"DOM_PARSER\",\n    /** The offscreen document needs to interact with media streams from user media (e.g. getUserMedia()). */\n    UserMedia = \"USER_MEDIA\",\n    /** The offscreen document needs to interact with media streams from display media (e.g. getDisplayMedia()). */\n    DisplayMedia = \"DISPLAY_MEDIA\",\n    /** The offscreen document needs to use WebRTC APIs. */\n    WebRTC = \"WEB_RTC\",\n    /** The offscreen document needs to interact with the clipboard APIs(e.g. Navigator.clipboard). */\n    Clipboard = \"CLIPBOARD\",\n    /** Specifies that the offscreen document needs access to localStorage. */\n    LocalStorage = \"LOCAL_STORAGE\",\n    /** Specifies that the offscreen document needs to spawn workers. */\n    Workers = \"WORKERS\",\n    /** Specifies that the offscreen document needs to use navigator.getBattery. */\n    BatteryStatus = \"BATTERY_STATUS\",\n    /** Specifies that the offscreen document needs to use window.matchMedia. */\n    MatchMedia = \"MATCH_MEDIA\",\n    /** Specifies that the offscreen document needs to use navigator.geolocation. */\n    Geolocation = \"GEOLOCATION\",\n}\n\n/**\n * Empty because offscreen names and contracts belong to the consuming application.\n * Generated `.adnbn/offscreen.d.ts` declarations populate it by augmenting `adnbn/offscreen`.\n */\nexport interface OffscreenRegistry {}\n\nexport type OffscreenName = Extract<keyof OffscreenRegistry, string>;\n\nexport type OffscreenTarget<N extends keyof OffscreenRegistry> = TransportTarget<OffscreenRegistry, N>;\n\nexport type OffscreenProxyTarget<N extends keyof OffscreenRegistry> = TransportProxyTarget<OffscreenRegistry, N>;\n\nexport type OffscreenAlias = string;\n\nexport type OffscreenMap = Map<OffscreenAlias, OffscreenParameters>;\n\nexport type OffscreenParameters = chrome.offscreen.CreateParameters;\n\nexport type OffscreenParametersMap = Record<string, OffscreenParameters>;\n\nexport interface OffscreenConfig extends TransportConfig {\n    reasons?: `${OffscreenReason}` | `${OffscreenReason}`[] | OffscreenReason | OffscreenReason[];\n    justification?: string;\n}\n\nexport type OffscreenOptions = OffscreenConfig & CspOptions & ViewOptions;\n\nexport type OffscreenEntrypointOptions = Partial<OffscreenOptions>;\n\nexport type OffscreenMainHandler<T extends TransportType> = (\n    offscreen: T,\n    options: OffscreenEntrypointOptions\n) => Awaiter<void>;\n\nexport interface OffscreenDefinition<T extends TransportType>\n    extends\n        TransportDefinition<OffscreenOptions, T>,\n        OffscreenEntrypointOptions,\n        ViewRenderDefinition<OffscreenEntrypointOptions> {\n    main?: OffscreenMainHandler<T>;\n}\n\nexport type OffscreenUnresolvedDefinition<T extends TransportType> = Partial<OffscreenDefinition<T>>;\n"],"mappings":"AAWO,MAAM,qBAAqB;AAE3B,MAAM,wBAAwB;AAE9B,MAAM,kCAAkC;AAExC,IAAK,kBAAL,kBAAKA,qBAAL;AAEH,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,qBAAkB;AAElB,EAAAA,iBAAA,iBAAc;AAEd,EAAAA,iBAAA,WAAQ;AAER,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,YAAS;AAET,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,kBAAe;AAEf,EAAAA,iBAAA,aAAU;AAEV,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,gBAAa;AAEb,EAAAA,iBAAA,iBAAc;AA9BN,SAAAA;AAAA,GAAA;","names":["OffscreenReason"]}

package/dist/types/options.d.ts

@@ -1,9 +1,10 @@
-import { ViewDefinition, ViewOptions } from "./view.js";
+import { ViewDefinition, ViewOptions } from "./view/index.js";
 import { CspOptions } from "./csp.js";
+import { PermissionsOptions } from "./permissions.js";
 export interface OptionsConfig {
     /** Open in a browser tab. Defaults to true; embedded mode depends on browser support. */
     openInTab?: boolean;
 }
-export type OptionsEntrypointOptions = OptionsConfig & CspOptions & ViewOptions;
+export type OptionsEntrypointOptions = OptionsConfig & PermissionsOptions & CspOptions & ViewOptions;
 export type OptionsProps = OptionsEntrypointOptions;
 export type OptionsDefinition = OptionsEntrypointOptions & ViewDefinition<OptionsProps>;

package/dist/types/override.d.ts

@@ -0,0 +1,22 @@
+import { ViewDefinition, ViewOptions } from "./view/index.js";
+import { CspOptions } from "./csp.js";
+import { EntrypointType } from "./entrypoint.js";
+import { PermissionsOptions } from "./permissions.js";
+/**
+ * Entrypoints that replace a built-in browser page through `chrome_url_overrides`.
+ * Chromium refuses to load an extension that overrides more than one page,
+ * so each build selects a single override.
+ */
+export type OverrideEntrypointType = EntrypointType.Newtab | EntrypointType.Bookmarks | EntrypointType.History;
+export type OverrideEntrypointOptions = PermissionsOptions & CspOptions & ViewOptions;
+export type OverrideProps = OverrideEntrypointOptions;
+export type OverrideDefinition = OverrideEntrypointOptions & ViewDefinition<OverrideProps>;
+export type NewtabEntrypointOptions = OverrideEntrypointOptions;
+export type NewtabProps = NewtabEntrypointOptions;
+export type NewtabDefinition = NewtabEntrypointOptions & ViewDefinition<NewtabProps>;
+export type BookmarksEntrypointOptions = OverrideEntrypointOptions;
+export type BookmarksProps = BookmarksEntrypointOptions;
+export type BookmarksDefinition = BookmarksEntrypointOptions & ViewDefinition<BookmarksProps>;
+export type HistoryEntrypointOptions = OverrideEntrypointOptions;
+export type HistoryProps = HistoryEntrypointOptions;
+export type HistoryDefinition = HistoryEntrypointOptions & ViewDefinition<HistoryProps>;

package/dist/types/override.js

@@ -0,0 +1 @@
+//# sourceMappingURL=override.js.map

package/dist/types/override.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types/page.d.ts

@@ -1,4 +1,4 @@
-import { ViewDefinition, ViewOptions } from "./view.js";
+import { ViewDefinition, ViewOptions } from "./view/index.js";
 import { CspOptions } from "./csp.js";
 /**
  * Empty because page aliases depend on the consuming application's entrypoints.