adnbn 0.13.0 → 0.15.0

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/manifest.d.ts

@@ -5,6 +5,7 @@ import { Language } from "./locale.js";
 import { BrowserSpecific, DataCollectionPermission } from "./browser.js";
 import { CspConfig } from "./csp.js";
 import { SandboxCspConfig } from "./sandbox.js";
+import { ActionOptions } from "./action.js";
 export declare const ManifestMatchSchemes: ReadonlySet<string>;
 export declare const ManifestSpecialSchemes: ReadonlySet<string>;
 export declare enum ManifestIncognito {
@@ -14,8 +15,9 @@ 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;
+export type ManifestAction = NonNullable<chrome.runtime.ManifestV3["action"]>;
 type ManifestFixed<T extends ManifestBase> = Omit<T, "manifest_version"> & {
     manifest_version: ManifestVersion;
 };
@@ -78,12 +80,14 @@ export interface ManifestBuilder<T extends CoreManifest = Manifest> {
     mergeSpecific(settings: BrowserSpecific): this;
     setIcons(icons?: ManifestIcons): this;
     setIcon(icon?: string): this;
+    setAction(action?: ActionOptions): this;
     setBackground(background?: ManifestBackground): this;
     setCommands(commands?: ManifestCommands): this;
     setContentScripts(contentScripts?: ManifestContentScripts): this;
     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 +168,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\";\nimport {ActionOptions} from \"@typing/action\";\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\nexport type ManifestAction = NonNullable<chrome.runtime.ManifestV3[\"action\"]>;\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    // Toolbar button\n    setAction(action?: ActionOptions): this;\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":"AASO,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.

package/dist/types/permissions.d.ts

@@ -0,0 +1,39 @@
+import type { ManifestHostPermissions, ManifestOptionalPermission, ManifestOptionalPermissions, ManifestPermission, ManifestPermissions } from "./manifest.js";
+/**
+ * Manifest permissions required by an entrypoint.
+ *
+ * Browsers grant permissions to the whole extension, never to a single entrypoint.
+ * Declaring them here keeps a requirement beside the code that needs it
+ * and adds it to the manifest only in builds that include the entrypoint.
+ *
+ * An entrypoint type opts into this contract explicitly; it is not part of every entrypoint.
+ */
+export interface PermissionsOptions {
+    /**
+     * API permissions granted at install time. Written to `permissions`.
+     */
+    permissions?: ManifestPermission[];
+    /**
+     * API permissions requested at runtime. Written to `optional_permissions`.
+     */
+    optionalPermissions?: ManifestOptionalPermission[];
+    /**
+     * Host match patterns granted at install time.
+     * Written to `host_permissions`, or to `permissions` in Manifest V2.
+     */
+    hostPermissions?: string[];
+    /**
+     * Host match patterns requested at runtime.
+     * Written to `optional_host_permissions`, or to `optional_permissions` in Manifest V2.
+     */
+    optionalHostPermissions?: string[];
+}
+/**
+ * Permissions collected from the entrypoints that reach a build, ready to be appended to the manifest.
+ */
+export interface EntrypointPermissions {
+    permissions: ManifestPermissions;
+    optionalPermissions: ManifestOptionalPermissions;
+    hostPermissions: ManifestHostPermissions;
+    optionalHostPermissions: ManifestHostPermissions;
+}

package/dist/types/permissions.js

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

package/dist/types/permissions.js.map

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

package/dist/types/plugin.d.ts

@@ -67,9 +67,12 @@ interface PluginName {
 }
 export interface Plugin extends PluginName {
     background?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
+    bookmarks?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     bundler?: PluginHandler<PluginBundlerOptions, RspackConfig>;
     command?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     content?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
+    history?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
+    newtab?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     options?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     page?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
     popup?: PluginHandler<PluginConfigOptions, PluginEntrypointResult>;
@@ -88,7 +91,7 @@ export type PluginHandlerCallback<O, T = void> = {
     (options: O): Awaiter<T>;
 };
 export type PluginHandlerKeys = keyof Omit<Plugin, "name">;
-export type PluginEntrypointKeys = keyof Pick<Plugin, "background" | "command" | "content" | "options" | "page" | "popup" | "relay" | "sandbox" | "service" | "sidebar" | "offscreen">;
+export type PluginEntrypointKeys = keyof Pick<Plugin, "background" | "bookmarks" | "command" | "content" | "history" | "newtab" | "options" | "page" | "popup" | "relay" | "sandbox" | "service" | "sidebar" | "offscreen">;
 export type PluginAssetKeys = keyof Pick<Plugin, "icon" | "locale">;
 export type PluginHandlerType<T extends Plugin[PluginHandlerKeys]> = T extends PluginHandlerCallback<infer O, infer R> ? {
     options: O;

package/dist/types/popup.d.ts

@@ -1,6 +1,8 @@
-import { ViewDefinition, ViewOptions } from "./view.js";
+import { ViewDefinition, ViewOptions } from "./view/index.js";
 import { CspOptions } from "./csp.js";
+import { PermissionsOptions } from "./permissions.js";
 import type { ManifestPopup } from "./manifest.js";
+import type { IconName } from "./icon.js";
 /**
  * Empty because popup aliases depend on the consuming application's entrypoints.
  * Generated `.adnbn/popup.d.ts` declarations augment `adnbn`, adding discovered aliases as keys with value `true`.
@@ -10,9 +12,9 @@ export interface PopupAliasRegistry {
 export type PopupAlias = keyof PopupAliasRegistry extends never ? string : Extract<keyof PopupAliasRegistry, string>;
 export type PopupMap = Map<PopupAlias, ManifestPopup>;
 export interface PopupConfig {
-    icon?: string;
+    icon?: IconName;
     apply?: boolean;
 }
-export type PopupEntrypointOptions = PopupConfig & CspOptions & ViewOptions;
+export type PopupEntrypointOptions = PopupConfig & PermissionsOptions & CspOptions & ViewOptions;
 export type PopupProps = PopupEntrypointOptions;
 export type PopupDefinition = PopupEntrypointOptions & ViewDefinition<PopupProps>;

package/dist/types/sandbox.d.ts

@@ -1,5 +1,5 @@
 import { TransportConfig, TransportDefinition, TransportType } from "./transport.js";
-import { ViewOptions } from "./view.js";
+import { ViewOptions, ViewRenderDefinition } from "./view/index.js";
 import { Awaiter } from "./helpers.js";
 import { MessageError, MessageSender } from "./message.js";
 import type { RpcAsyncProxy } from "./rpc.js";
@@ -60,7 +60,7 @@ export interface SandboxConfig extends TransportConfig {
 export type SandboxOptions = SandboxConfig & SandboxCspOptions & ViewOptions;
 export type SandboxEntrypointOptions = Partial<SandboxOptions>;
 export type SandboxMainHandler<T extends TransportType> = (sandbox: T, options: SandboxEntrypointOptions) => Awaiter<void>;
-export interface SandboxDefinition<T extends TransportType> extends TransportDefinition<SandboxOptions, T>, SandboxEntrypointOptions {
+export interface SandboxDefinition<T extends TransportType> extends TransportDefinition<SandboxOptions, T>, SandboxEntrypointOptions, ViewRenderDefinition<SandboxEntrypointOptions> {
     main?: SandboxMainHandler<T>;
 }
 export type SandboxUnresolvedDefinition<T extends TransportType> = Partial<SandboxDefinition<T>>;

package/dist/types/sandbox.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/sandbox.ts"],"sourcesContent":["import {TransportConfig, TransportDefinition, TransportType} from \"@typing/transport\";\nimport {ViewOptions} from \"@typing/view\";\nimport {Awaiter} from \"@typing/helpers\";\nimport {MessageError, MessageSender} from \"@typing/message\";\nimport type {RpcAsyncProxy} from \"@typing/rpc\";\n\nexport const SandboxGlobalKey = \"adnbnSandbox\";\n\nexport const SandboxGlobalAccess = \"adnbnSandboxAccess\";\n\nexport const SandboxNamespace = \"adnbn:sandbox\";\n\nexport const SandboxReadyMessageType = `${SandboxNamespace}:ready`;\n\nexport const SandboxRequestMessageType = `${SandboxNamespace}:request`;\n\nexport const SandboxResponseMessageType = `${SandboxNamespace}:response`;\n\nexport enum SandboxAllow {\n    Forms = \"forms\",\n    Popups = \"popups\",\n    Modals = \"modals\",\n    Downloads = \"downloads\",\n    PointerLock = \"pointer-lock\",\n    TopNavigationByUserActivation = \"top-navigation-by-user-activation\",\n}\n\nexport enum SandboxSource {\n    Self = \"'self'\",\n    None = \"'none'\",\n    Data = \"data:\",\n    Blob = \"blob:\",\n    UnsafeInline = \"'unsafe-inline'\",\n}\n\n/**\n * Empty because sandbox names and contracts belong to the consuming application.\n * Generated `.adnbn/sandbox.d.ts` declarations populate it by augmenting `adnbn/sandbox`.\n */\nexport interface SandboxRegistry {}\n\nexport type SandboxName = Extract<keyof SandboxRegistry, string>;\n\nexport type SandboxProxyTarget<N extends keyof SandboxRegistry> = RpcAsyncProxy<SandboxRegistry[N]>;\n\nexport type SandboxAlias = string;\n\nexport type SandboxMap = Map<SandboxAlias, SandboxParameters>;\n\nexport interface SandboxCspSources {\n    connect?: Array<SandboxSource | `${SandboxSource}`>;\n    image?: Array<SandboxSource | `${SandboxSource}`>;\n    style?: Array<SandboxSource | `${SandboxSource}`>;\n    font?: Array<SandboxSource | `${SandboxSource}`>;\n    media?: Array<SandboxSource | `${SandboxSource}`>;\n    worker?: Array<SandboxSource | `${SandboxSource}`>;\n    child?: Array<SandboxSource | `${SandboxSource}`>;\n}\n\nexport interface SandboxCspConfig {\n    eval?: boolean;\n    inline?: boolean;\n    allow?: Array<SandboxAllow | `${SandboxAllow}`>;\n    sources?: SandboxCspSources;\n}\n\nexport interface SandboxCspOptions {\n    csp?: SandboxCspConfig;\n}\n\nexport interface SandboxConfig extends TransportConfig {\n    readyTimeout?: number;\n    requestTimeout?: number;\n    removeOnRequestTimeout?: boolean;\n}\n\nexport type SandboxOptions = SandboxConfig & SandboxCspOptions & ViewOptions;\n\nexport type SandboxEntrypointOptions = Partial<SandboxOptions>;\n\nexport type SandboxMainHandler<T extends TransportType> = (\n    sandbox: T,\n    options: SandboxEntrypointOptions\n) => Awaiter<void>;\n\nexport interface SandboxDefinition<T extends TransportType>\n    extends TransportDefinition<SandboxOptions, T>, SandboxEntrypointOptions {\n    main?: SandboxMainHandler<T>;\n}\n\nexport type SandboxUnresolvedDefinition<T extends TransportType> = Partial<SandboxDefinition<T>>;\n\nexport type SandboxParameters = {url: string} & Pick<\n    SandboxConfig,\n    \"readyTimeout\" | \"requestTimeout\" | \"removeOnRequestTimeout\"\n>;\n\nexport type SandboxParametersMap = Record<string, SandboxParameters>;\n\nexport interface SandboxReadyMessage {\n    type: typeof SandboxReadyMessageType;\n    channel: string;\n    name: string;\n}\n\nexport interface SandboxRequestMessage {\n    type: typeof SandboxRequestMessageType;\n    channel: string;\n    name: string;\n    requestId: string;\n    path?: string;\n    args: any[];\n}\n\nexport interface SandboxResponseMessage {\n    type: typeof SandboxResponseMessageType;\n    channel: string;\n    name: string;\n    requestId: string;\n    ok: boolean;\n    payload?: any;\n    error?: MessageError;\n}\n\nexport type SandboxEnvelope = SandboxRequestMessage | SandboxResponseMessage;\n\n/**\n * Internal seam for the sandbox wire. Lives below `SandboxMessage`, invisible to callers.\n *\n * - `connect` establishes the channel (host: create the iframe and await the ready\n *   handshake; sandbox/in-memory: resolves immediately). Must be idempotent — concurrent\n *   callers share one connection.\n * - `post` sends one already-built envelope to the peer.\n * - `subscribe` attaches exactly one underlying listener and returns its remover.\n * - `dispose` tears the channel down (remove listener, drop the iframe).\n */\nexport interface SandboxPort {\n    connect(): Promise<void>;\n\n    post(message: SandboxEnvelope): void;\n\n    subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void;\n\n    dispose(): void;\n}\n"],"mappings":"AAMO,MAAM,mBAAmB;AAEzB,MAAM,sBAAsB;AAE5B,MAAM,mBAAmB;AAEzB,MAAM,0BAA0B,GAAG,gBAAgB;AAEnD,MAAM,4BAA4B,GAAG,gBAAgB;AAErD,MAAM,6BAA6B,GAAG,gBAAgB;AAEtD,IAAK,eAAL,kBAAKA,kBAAL;AACH,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,eAAY;AACZ,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,mCAAgC;AANxB,SAAAA;AAAA,GAAA;AASL,IAAK,gBAAL,kBAAKC,mBAAL;AACH,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,kBAAe;AALP,SAAAA;AAAA,GAAA;","names":["SandboxAllow","SandboxSource"]}
+{"version":3,"sources":["../../src/types/sandbox.ts"],"sourcesContent":["import {TransportConfig, TransportDefinition, TransportType} from \"@typing/transport\";\nimport {ViewOptions, ViewRenderDefinition} from \"@typing/view\";\nimport {Awaiter} from \"@typing/helpers\";\nimport {MessageError, MessageSender} from \"@typing/message\";\nimport type {RpcAsyncProxy} from \"@typing/rpc\";\n\nexport const SandboxGlobalKey = \"adnbnSandbox\";\n\nexport const SandboxGlobalAccess = \"adnbnSandboxAccess\";\n\nexport const SandboxNamespace = \"adnbn:sandbox\";\n\nexport const SandboxReadyMessageType = `${SandboxNamespace}:ready`;\n\nexport const SandboxRequestMessageType = `${SandboxNamespace}:request`;\n\nexport const SandboxResponseMessageType = `${SandboxNamespace}:response`;\n\nexport enum SandboxAllow {\n    Forms = \"forms\",\n    Popups = \"popups\",\n    Modals = \"modals\",\n    Downloads = \"downloads\",\n    PointerLock = \"pointer-lock\",\n    TopNavigationByUserActivation = \"top-navigation-by-user-activation\",\n}\n\nexport enum SandboxSource {\n    Self = \"'self'\",\n    None = \"'none'\",\n    Data = \"data:\",\n    Blob = \"blob:\",\n    UnsafeInline = \"'unsafe-inline'\",\n}\n\n/**\n * Empty because sandbox names and contracts belong to the consuming application.\n * Generated `.adnbn/sandbox.d.ts` declarations populate it by augmenting `adnbn/sandbox`.\n */\nexport interface SandboxRegistry {}\n\nexport type SandboxName = Extract<keyof SandboxRegistry, string>;\n\nexport type SandboxProxyTarget<N extends keyof SandboxRegistry> = RpcAsyncProxy<SandboxRegistry[N]>;\n\nexport type SandboxAlias = string;\n\nexport type SandboxMap = Map<SandboxAlias, SandboxParameters>;\n\nexport interface SandboxCspSources {\n    connect?: Array<SandboxSource | `${SandboxSource}`>;\n    image?: Array<SandboxSource | `${SandboxSource}`>;\n    style?: Array<SandboxSource | `${SandboxSource}`>;\n    font?: Array<SandboxSource | `${SandboxSource}`>;\n    media?: Array<SandboxSource | `${SandboxSource}`>;\n    worker?: Array<SandboxSource | `${SandboxSource}`>;\n    child?: Array<SandboxSource | `${SandboxSource}`>;\n}\n\nexport interface SandboxCspConfig {\n    eval?: boolean;\n    inline?: boolean;\n    allow?: Array<SandboxAllow | `${SandboxAllow}`>;\n    sources?: SandboxCspSources;\n}\n\nexport interface SandboxCspOptions {\n    csp?: SandboxCspConfig;\n}\n\nexport interface SandboxConfig extends TransportConfig {\n    readyTimeout?: number;\n    requestTimeout?: number;\n    removeOnRequestTimeout?: boolean;\n}\n\nexport type SandboxOptions = SandboxConfig & SandboxCspOptions & ViewOptions;\n\nexport type SandboxEntrypointOptions = Partial<SandboxOptions>;\n\nexport type SandboxMainHandler<T extends TransportType> = (\n    sandbox: T,\n    options: SandboxEntrypointOptions\n) => Awaiter<void>;\n\nexport interface SandboxDefinition<T extends TransportType>\n    extends\n        TransportDefinition<SandboxOptions, T>,\n        SandboxEntrypointOptions,\n        ViewRenderDefinition<SandboxEntrypointOptions> {\n    main?: SandboxMainHandler<T>;\n}\n\nexport type SandboxUnresolvedDefinition<T extends TransportType> = Partial<SandboxDefinition<T>>;\n\nexport type SandboxParameters = {url: string} & Pick<\n    SandboxConfig,\n    \"readyTimeout\" | \"requestTimeout\" | \"removeOnRequestTimeout\"\n>;\n\nexport type SandboxParametersMap = Record<string, SandboxParameters>;\n\nexport interface SandboxReadyMessage {\n    type: typeof SandboxReadyMessageType;\n    channel: string;\n    name: string;\n}\n\nexport interface SandboxRequestMessage {\n    type: typeof SandboxRequestMessageType;\n    channel: string;\n    name: string;\n    requestId: string;\n    path?: string;\n    args: any[];\n}\n\nexport interface SandboxResponseMessage {\n    type: typeof SandboxResponseMessageType;\n    channel: string;\n    name: string;\n    requestId: string;\n    ok: boolean;\n    payload?: any;\n    error?: MessageError;\n}\n\nexport type SandboxEnvelope = SandboxRequestMessage | SandboxResponseMessage;\n\n/**\n * Internal seam for the sandbox wire. Lives below `SandboxMessage`, invisible to callers.\n *\n * - `connect` establishes the channel (host: create the iframe and await the ready\n *   handshake; sandbox/in-memory: resolves immediately). Must be idempotent — concurrent\n *   callers share one connection.\n * - `post` sends one already-built envelope to the peer.\n * - `subscribe` attaches exactly one underlying listener and returns its remover.\n * - `dispose` tears the channel down (remove listener, drop the iframe).\n */\nexport interface SandboxPort {\n    connect(): Promise<void>;\n\n    post(message: SandboxEnvelope): void;\n\n    subscribe(onMessage: (message: SandboxEnvelope, sender: MessageSender) => void): () => void;\n\n    dispose(): void;\n}\n"],"mappings":"AAMO,MAAM,mBAAmB;AAEzB,MAAM,sBAAsB;AAE5B,MAAM,mBAAmB;AAEzB,MAAM,0BAA0B,GAAG,gBAAgB;AAEnD,MAAM,4BAA4B,GAAG,gBAAgB;AAErD,MAAM,6BAA6B,GAAG,gBAAgB;AAEtD,IAAK,eAAL,kBAAKA,kBAAL;AACH,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,YAAS;AACT,EAAAA,cAAA,eAAY;AACZ,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,mCAAgC;AANxB,SAAAA;AAAA,GAAA;AASL,IAAK,gBAAL,kBAAKC,mBAAL;AACH,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,UAAO;AACP,EAAAA,eAAA,kBAAe;AALP,SAAAA;AAAA,GAAA;","names":["SandboxAllow","SandboxSource"]}

package/dist/types/sidebar.d.ts

@@ -1,7 +1,9 @@
-import { ViewDefinition, ViewOptions } from "./view.js";
+import { ViewDefinition, ViewOptions } from "./view/index.js";
 import { Browser } from "./browser.js";
 import { CspOptions } from "./csp.js";
+import { PermissionsOptions } from "./permissions.js";
 import type { ManifestSidebar } from "./manifest.js";
+import type { IconName } from "./icon.js";
 export declare const SidebarAlternativeBrowsers: ReadonlySet<Browser>;
 /**
  * Empty because sidebar aliases depend on the consuming application's entrypoints.
@@ -12,9 +14,9 @@ export interface SidebarAliasRegistry {
 export type SidebarAlias = keyof SidebarAliasRegistry extends never ? string : Extract<keyof SidebarAliasRegistry, string>;
 export type SidebarMap = Map<SidebarAlias, ManifestSidebar>;
 export interface SidebarConfig {
-    icon?: string;
+    icon?: IconName;
     apply?: boolean;
 }
-export type SidebarEntrypointOptions = SidebarConfig & CspOptions & ViewOptions;
+export type SidebarEntrypointOptions = SidebarConfig & PermissionsOptions & CspOptions & ViewOptions;
 export type SidebarProps = SidebarEntrypointOptions;
 export type SidebarDefinition = SidebarEntrypointOptions & ViewDefinition<SidebarProps>;

package/dist/types/sidebar.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/sidebar.ts"],"sourcesContent":["import {ViewDefinition, ViewOptions} from \"@typing/view\";\nimport {Browser} from \"@typing/browser\";\nimport {CspOptions} from \"@typing/csp\";\nimport type {ManifestSidebar} from \"@typing/manifest\";\n\nexport const SidebarAlternativeBrowsers: ReadonlySet<Browser> = new Set([Browser.Opera, Browser.Firefox]);\n\n/**\n * Empty because sidebar aliases depend on the consuming application's entrypoints.\n * Generated `.adnbn/sidebar.d.ts` declarations augment `adnbn`, adding discovered aliases as keys with value `true`.\n */\nexport interface SidebarAliasRegistry {}\n\nexport type SidebarAlias = keyof SidebarAliasRegistry extends never\n    ? string\n    : Extract<keyof SidebarAliasRegistry, string>;\n\nexport type SidebarMap = Map<SidebarAlias, ManifestSidebar>;\n\nexport interface SidebarConfig {\n    icon?: string;\n    apply?: boolean;\n}\n\nexport type SidebarEntrypointOptions = SidebarConfig & CspOptions & ViewOptions;\n\nexport type SidebarProps = SidebarEntrypointOptions;\n\nexport type SidebarDefinition = SidebarEntrypointOptions & ViewDefinition<SidebarProps>;\n"],"mappings":"AACA,SAAQ,eAAc;AAIf,MAAM,6BAAmD,oBAAI,IAAI,CAAC,QAAQ,OAAO,QAAQ,OAAO,CAAC;","names":[]}
+{"version":3,"sources":["../../src/types/sidebar.ts"],"sourcesContent":["import {ViewDefinition, ViewOptions} from \"@typing/view\";\nimport {Browser} from \"@typing/browser\";\nimport {CspOptions} from \"@typing/csp\";\nimport {PermissionsOptions} from \"@typing/permissions\";\nimport type {ManifestSidebar} from \"@typing/manifest\";\nimport type {IconName} from \"@typing/icon\";\n\nexport const SidebarAlternativeBrowsers: ReadonlySet<Browser> = new Set([Browser.Opera, Browser.Firefox]);\n\n/**\n * Empty because sidebar aliases depend on the consuming application's entrypoints.\n * Generated `.adnbn/sidebar.d.ts` declarations augment `adnbn`, adding discovered aliases as keys with value `true`.\n */\nexport interface SidebarAliasRegistry {}\n\nexport type SidebarAlias = keyof SidebarAliasRegistry extends never\n    ? string\n    : Extract<keyof SidebarAliasRegistry, string>;\n\nexport type SidebarMap = Map<SidebarAlias, ManifestSidebar>;\n\nexport interface SidebarConfig {\n    icon?: IconName;\n    apply?: boolean;\n}\n\nexport type SidebarEntrypointOptions = SidebarConfig & PermissionsOptions & CspOptions & ViewOptions;\n\nexport type SidebarProps = SidebarEntrypointOptions;\n\nexport type SidebarDefinition = SidebarEntrypointOptions & ViewDefinition<SidebarProps>;\n"],"mappings":"AACA,SAAQ,eAAc;AAMf,MAAM,6BAAmD,oBAAI,IAAI,CAAC,QAAQ,OAAO,QAAQ,OAAO,CAAC;","names":[]}

package/dist/types/view/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export type * from "./vanilla.js";
+export type * from "./react.js";

package/dist/types/view/adapters/index.js

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

package/dist/types/view/adapters/index.js.map

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

package/dist/types/view/adapters/react.d.ts

@@ -0,0 +1,4 @@
+import type { FC, ReactNode } from "react";
+import type { ViewConfig } from "../common.js";
+export type ViewRenderReactComponent<T extends ViewConfig> = FC<T>;
+export type ViewReactRenderValue<T extends ViewConfig> = Exclude<ReactNode, Promise<unknown>> | ViewRenderReactComponent<T>;

package/dist/types/view/adapters/react.js

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

package/dist/types/view/adapters/react.js.map

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

package/dist/types/view/adapters/vanilla.d.ts

@@ -0,0 +1 @@
+export type ViewVanillaRenderValue = Element | string | number | boolean | null | undefined;

package/dist/types/view/adapters/vanilla.js

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

package/dist/types/view/adapters/vanilla.js.map

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

package/dist/types/{view.d.ts → view/common.d.ts}

@@ -1,8 +1,7 @@
-import type { FC, ReactNode } from "react";
 import type { Optional } from "utility-types";
 import type { Options as HtmlOptions } from "html-rspack-tags-plugin";
-import { Awaiter, ExcludeFunctionsFromProperties, PickNonFunctionProperties } from "./helpers.js";
-import { EntrypointBuilder, EntrypointOptions } from "./entrypoint.js";
+import { Awaiter, ExcludeFunctionsFromProperties, PickNonFunctionProperties } from "../helpers.js";
+import { EntrypointBuilder, EntrypointOptions } from "../entrypoint.js";
 export interface ViewConfig {
     as?: string;
     title?: string;
@@ -10,9 +9,6 @@ export interface ViewConfig {
 }
 export type ViewOptions = ViewConfig & EntrypointOptions & ExcludeFunctionsFromProperties<HtmlOptions>;
 export type ViewEntrypointOptions = ViewOptions;
-export type ViewRenderReactComponent<T extends ViewConfig> = FC<T>;
-export type ViewRenderValue<T extends ViewConfig> = string | Element | ReactNode | ViewRenderReactComponent<T>;
-export type ViewRenderHandler<T extends ViewConfig> = (props: T) => Awaiter<void | ViewRenderValue<T>>;
 export type ViewContainerTag = Exclude<keyof HTMLElementTagNameMap, "html" | "body">;
 export type ViewContainerOptions = {
     [Tag in ViewContainerTag]: {
@@ -21,12 +17,4 @@ export type ViewContainerOptions = {
 }[ViewContainerTag];
 export type ViewContainerFactory<T extends ViewConfig> = (props: T) => Awaiter<Element | ViewContainerTag | ViewContainerOptions>;
 export type ViewContainerCreator<T extends ViewConfig> = (props: T) => Awaiter<Element>;
-export interface ViewDefinition<T extends ViewConfig> extends ViewOptions {
-    render?: ViewRenderValue<T> | ViewRenderHandler<T>;
-    container?: ViewContainerTag | ViewContainerOptions | ViewContainerFactory<T>;
-}
-export interface ViewResolvedDefinition<T extends ViewConfig> extends ViewDefinition<T> {
-    render: ViewRenderHandler<T>;
-    container: ViewContainerCreator<T>;
-}
 export type ViewBuilder = EntrypointBuilder;

package/dist/types/view/common.js

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

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

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

package/dist/types/view/definition.d.ts

@@ -0,0 +1,15 @@
+import type { ViewBuilder, ViewConfig, ViewContainerCreator, ViewContainerFactory, ViewContainerOptions, ViewContainerTag, ViewOptions } from "./common.js";
+import type { ViewRenderHandler, ViewRenderValue } from "./render.js";
+/** UI of a view document; entrypoints that also render a view (offscreen, sandbox) adopt it as a mixin. */
+export interface ViewRenderDefinition<T extends ViewConfig> {
+    render?: ViewRenderValue<T> | ViewRenderHandler<T>;
+    container?: ViewContainerTag | ViewContainerOptions | ViewContainerFactory<T>;
+}
+export interface ViewDefinition<T extends ViewConfig> extends ViewOptions, ViewRenderDefinition<T> {
+}
+export interface ViewResolvedDefinition<T extends ViewConfig> extends ViewDefinition<T> {
+    render?: ViewRenderHandler<T>;
+    container: ViewContainerCreator<T>;
+}
+/** A renderer adapter's builder class, selected by the entrypoint filename and injected by the build. */
+export type ViewBuilderConstructor<T extends ViewConfig> = new (definition: ViewDefinition<T>) => ViewBuilder;

package/dist/types/view/definition.js

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

package/dist/types/view/definition.js.map

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

package/dist/types/view/index.d.ts

@@ -0,0 +1,4 @@
+export type * from "./common.js";
+export type * from "./definition.js";
+export type * from "./render.js";
+export type * from "./adapters/index.js";

package/dist/types/view/index.js

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

package/dist/types/view/index.js.map

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

package/dist/types/view/render.d.ts

@@ -0,0 +1,7 @@
+import type { Awaiter } from "../helpers.js";
+import type { ViewConfig } from "./common.js";
+import type { ViewReactRenderValue, ViewVanillaRenderValue } from "./adapters/index.js";
+/** All supported render values; the entrypoint's filename selects the runtime adapter. */
+export type ViewRenderValue<T extends ViewConfig> = ViewVanillaRenderValue | ViewReactRenderValue<T>;
+/** A view document renders once, so its handler may await data before returning the value. */
+export type ViewRenderHandler<T extends ViewConfig> = (props: T) => Awaiter<void | ViewRenderValue<T>>;

package/dist/types/view/render.js

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

package/dist/types/view/render.js.map

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