wxt 0.16.8 → 0.16.10

package/dist/{index-sl22zA2Z.d.ts → index-h54vKikt.d.cts}

@@ -493,99 +493,34 @@ interface Logger {
     level: LogLevel;
 }
 interface BaseEntrypointOptions {
-    include?: TargetBrowser[];
-    exclude?: TargetBrowser[];
-}
-interface BaseEntrypoint {
     /**
-     * The entrypoint's name. This is the filename or dirname without the type suffix.
-     *
-     * Examples:
-     * - `popup.html` → `popup`
-     * - `options/index.html` → `options`
-     * - `named.sandbox.html` → `named`
-     * - `named.sandbox/index.html` → `named`
-     * - `sandbox.html` → `sandbox`
-     * - `sandbox/index.html` → `sandbox`
-     * - `overlay.content.ts` → `overlay`
-     * - `overlay.content/index.ts` → `overlay`
+     * List of target browsers to include this entrypoint in. Defaults to being included in all
+     * builds. Cannot be used with `exclude`. You must choose one of the two options.
      *
-     * The name is used when generating an output file:
-     * `<entrypoint.outputDir>/<entrypoint.name>.<ext>`
-     */
-    name: string;
-    /**
-     * Absolute path to the entrypoint's input file.
-     */
-    inputPath: string;
-    /**
-     * Absolute path to the entrypoint's output directory. Can be the`InternalConfg.outDir` or a
-     * subdirectory of it.
-     */
-    outputDir: string;
-    options: BaseEntrypointOptions;
-    skipped: boolean;
-}
-interface GenericEntrypoint extends BaseEntrypoint {
-    type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'sidepanel' | 'devtools' | 'unlisted-page' | 'unlisted-script' | 'unlisted-style' | 'content-script-style';
-}
-interface BackgroundEntrypoint extends BaseEntrypoint {
-    type: 'background';
-    options: {
-        persistent?: boolean;
-        type?: 'module';
-    } & BaseEntrypointOptions;
-}
-interface ContentScriptEntrypoint extends BaseEntrypoint {
-    type: 'content-script';
-    options: Omit<ContentScriptDefinition, 'main'> & BaseEntrypointOptions;
-}
-interface PopupEntrypoint extends BaseEntrypoint {
-    type: 'popup';
-    options: {
-        /**
-         * Defaults to "browser_action" to be equivalent to MV3's "action" key
-         */
-        mv2Key?: 'browser_action' | 'page_action';
-        defaultIcon?: Record<string, string>;
-        defaultTitle?: string;
-        browserStyle?: boolean;
-    } & BaseEntrypointOptions;
-}
-interface OptionsEntrypoint extends BaseEntrypoint {
-    type: 'options';
-    options: {
-        openInTab?: boolean;
-        browserStyle?: boolean;
-        chromeStyle?: boolean;
-    } & BaseEntrypointOptions;
-}
-type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint;
-type EntrypointGroup = Entrypoint | Entrypoint[];
-type OnContentScriptStopped = (cb: () => void) => void;
-type ContentScriptDefinition = ContentScriptIsolatedWorldDefinition | ContentScriptMainWorldDefinition;
-interface ContentScriptIsolatedWorldDefinition extends ContentScriptBaseDefinition {
-    /**
-     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
-     * @default "ISOLATED"
+     * @default undefined
      */
-    world?: 'ISOLATED';
+    include?: TargetBrowser[];
     /**
-     * Main function executed when the content script is loaded.
+     * List of target browsers to exclude this entrypoint from. Cannot be used with `include`. You
+     * must choose one of the two options.
+     *
+     * @default undefined
      */
-    main(ctx: ContentScriptContext): void | Promise<void>;
+    exclude?: TargetBrowser[];
 }
-interface ContentScriptMainWorldDefinition extends ContentScriptBaseDefinition {
-    /**
-     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
-     */
-    world: 'MAIN';
+interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
+    persistent?: PerBrowserOption<boolean>;
     /**
-     * Main function executed when the content script is loaded.
+     * Set to `"module"` to output the background entrypoint as ESM. ESM outputs can share chunks and
+     * reduce the overall size of the bundled extension.
+     *
+     * When `undefined`, the background is bundled individually into an IIFE format.
+     *
+     * @default undefined
      */
-    main(): void | Promise<void>;
+    type?: PerBrowserOption<'module'>;
 }
-interface ContentScriptBaseDefinition extends ExcludableEntrypoint {
+interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
     matches: PerBrowserOption<Manifest.ContentScript['matches']>;
     /**
      * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
@@ -631,47 +566,168 @@ interface ContentScriptBaseDefinition extends ExcludableEntrypoint {
      *   onto the page. Use `browser.runtime.getURL("content-scripts/<name>.css")` to get the file's
      *   URL
      * - `"ui"` - Exclude the CSS from the manifest. CSS will be automatically added to your UI when
-     *   calling `createContentScriptUi`
+     *   calling `createShadowRootUi`
      *
      * @default "manifest"
      */
     cssInjectionMode?: PerBrowserOption<'manifest' | 'manual' | 'ui'>;
+    /**
+     * Specify how the content script is registered.
+     *
+     * - `"manifest"`: The content script will be added to the `content_scripts` entry in the
+     *   manifest. This is the normal and most well known way of registering a content script.
+     * - `"runtime"`: The content script's `matches` is added to `host_permissions` and you are
+     *   responsible for using the scripting API to register the content script dynamically at
+     *   runtime.
+     *
+     * @default "manifest"
+     */
+    registration?: PerBrowserOption<'manifest' | 'runtime'>;
 }
-interface BackgroundDefinition extends ExcludableEntrypoint {
-    type?: PerBrowserOption<'module'>;
-    persistent?: PerBrowserOption<boolean>;
-    main(): void;
+interface MainWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
+    /**
+     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
+     */
+    world: 'MAIN';
 }
-interface UnlistedScriptDefinition extends ExcludableEntrypoint {
+interface IsolatedWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
     /**
-     * Main function executed when the unlisted script is ran.
+     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
+     * @default "ISOLATED"
      */
-    main(): void | Promise<void>;
+    world?: 'ISOLATED';
 }
-type PerBrowserOption<T> = T | {
-    [browser: TargetBrowser]: T;
-};
-interface ExcludableEntrypoint {
+interface PopupEntrypointOptions extends BaseEntrypointOptions {
     /**
-     * List of target browsers to include this entrypoint in. Defaults to being included in all
-     * builds. Cannot be used with `exclude`. You must choose one of the two options.
-     *
-     * @default undefined
+     * Defaults to "browser_action" to be equivalent to MV3's "action" key
      */
-    include?: TargetBrowser[];
+    mv2Key?: PerBrowserOption<'browser_action' | 'page_action'>;
+    defaultIcon?: Record<string, string>;
+    defaultTitle?: PerBrowserOption<string>;
+    browserStyle?: PerBrowserOption<boolean>;
+}
+interface OptionsEntrypointOptions extends BaseEntrypointOptions {
+    openInTab?: PerBrowserOption<boolean>;
+    browserStyle?: PerBrowserOption<boolean>;
+    chromeStyle?: PerBrowserOption<boolean>;
+}
+interface SidepanelEntrypointOptions extends BaseEntrypointOptions {
     /**
-     * List of target browsers to exclude this entrypoint from. Cannot be used with `include`. You
-     * must choose one of the two options.
+     * Firefox only. See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
+     * @default false
+     */
+    openAtInstall?: PerBrowserOption<boolean>;
+    /**
+     * @deprecated See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
+     */
+    browserStyle?: PerBrowserOption<boolean>;
+    defaultIcon?: string | Record<string, string>;
+    defaultTitle?: PerBrowserOption<string>;
+}
+interface BaseEntrypoint {
+    /**
+     * The entrypoint's name. This is the filename or dirname without the type suffix.
      *
-     * @default undefined
+     * Examples:
+     * - `popup.html` &rarr; `popup`
+     * - `options/index.html` &rarr; `options`
+     * - `named.sandbox.html` &rarr; `named`
+     * - `named.sandbox/index.html` &rarr; `named`
+     * - `sandbox.html` &rarr; `sandbox`
+     * - `sandbox/index.html` &rarr; `sandbox`
+     * - `overlay.content.ts` &rarr; `overlay`
+     * - `overlay.content/index.ts` &rarr; `overlay`
+     *
+     * The name is used when generating an output file:
+     * `<entrypoint.outputDir>/<entrypoint.name>.<ext>`
      */
-    exclude?: TargetBrowser[];
+    name: string;
+    /**
+     * Absolute path to the entrypoint's input file.
+     */
+    inputPath: string;
+    /**
+     * Absolute path to the entrypoint's output directory. Can be the`InternalConfg.outDir` or a
+     * subdirectory of it.
+     */
+    outputDir: string;
+    skipped: boolean;
 }
+interface GenericEntrypoint extends BaseEntrypoint {
+    type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'devtools' | 'unlisted-page' | 'unlisted-script' | 'unlisted-style' | 'content-script-style';
+    options: ResolvedPerBrowserOptions<BaseEntrypointOptions>;
+}
+interface BackgroundEntrypoint extends BaseEntrypoint {
+    type: 'background';
+    options: ResolvedPerBrowserOptions<BackgroundEntrypointOptions>;
+}
+interface ContentScriptEntrypoint extends BaseEntrypoint {
+    type: 'content-script';
+    options: ResolvedPerBrowserOptions<MainWorldContentScriptEntrypointOptions | IsolatedWorldContentScriptEntrypointOptions>;
+}
+interface PopupEntrypoint extends BaseEntrypoint {
+    type: 'popup';
+    options: ResolvedPerBrowserOptions<PopupEntrypointOptions, 'defaultIcon'>;
+}
+interface OptionsEntrypoint extends BaseEntrypoint {
+    type: 'options';
+    options: ResolvedPerBrowserOptions<OptionsEntrypointOptions>;
+}
+interface SidepanelEntrypoint extends BaseEntrypoint {
+    type: 'sidepanel';
+    options: ResolvedPerBrowserOptions<SidepanelEntrypointOptions, 'defaultIcon'>;
+}
+type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint | SidepanelEntrypoint;
+type EntrypointGroup = Entrypoint | Entrypoint[];
+type OnContentScriptStopped = (cb: () => void) => void;
+interface IsolatedWorldContentScriptDefinition extends IsolatedWorldContentScriptEntrypointOptions {
+    /**
+     * Main function executed when the content script is loaded.
+     */
+    main(ctx: ContentScriptContext): void | Promise<void>;
+}
+interface MainWorldContentScriptDefinition extends MainWorldContentScriptEntrypointOptions {
+    /**
+     * Main function executed when the content script is loaded.
+     */
+    main(): void | Promise<void>;
+}
+type ContentScriptDefinition = IsolatedWorldContentScriptDefinition | MainWorldContentScriptDefinition;
+interface BackgroundDefinition extends BackgroundEntrypointOptions {
+    /**
+     * Main function executed when the background script is started. Cannot be async.
+     */
+    main(): void;
+}
+interface UnlistedScriptDefinition extends BaseEntrypointOptions {
+    /**
+     * Main function executed when the unlisted script is ran.
+     */
+    main(): void | Promise<void>;
+}
+/**
+ * Either a single value or a map of different browsers to the value for that browser.
+ */
+type PerBrowserOption<T> = T | PerBrowserMap<T>;
+type PerBrowserMap<T> = {
+    [browser: TargetBrowser]: T;
+};
+/**
+ * Convert `{ key: PerBrowserOption<T> }` to just `{ key: T }`, stripping away the
+ * `PerBrowserOption` type for all fields inside the object.
+ *
+ * A optional second list of keys can be passed if a field isn't compatible with `PerBrowserOption`, like `defaultIcon`.
+ */
+type ResolvedPerBrowserOptions<T, TOmitted extends keyof T = never> = {
+    [key in keyof Omit<T, TOmitted>]: T[key] extends PerBrowserOption<infer U> ? U : T[key];
+} & {
+    [key in TOmitted]: T[key];
+};
 /**
  * Manifest customization available in the `wxt.config.ts` file. You cannot configure entrypoints
  * here, they are configured inline.
  */
-type UserManifest = Partial<Omit<Manifest.WebExtensionManifest, 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'sandbox' | 'sidepanel' | 'sidebar_action'>>;
+type UserManifest = Partial<Omit<Manifest.WebExtensionManifest, 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'sandbox'>>;
 type UserManifestFn = (env: ConfigEnv) => UserManifest | Promise<UserManifest>;
 interface ConfigEnv {
     mode: string;
@@ -986,4 +1042,4 @@ type WxtResolvedUnimportOptions = Partial<UnimportOptions> & {
     eslintrc: ResolvedEslintrc;
 };
 
-export type { Wxt as A, BuildOutput as B, ContentScriptEntrypoint as C, ExtensionRunner as D, ExtensionRunnerConfig as E, FsCache as F, GenericEntrypoint as G, HookResult as H, InlineConfig as I, EslintGlobalsPropValue as J, Eslintrc as K, Logger as L, ResolvedEslintrc as M, WxtUnimportOptions as N, OutputFile as O, PopupEntrypoint as P, WxtResolvedUnimportOptions as Q, ResolvedConfig as R, ServerInfo as S, TargetBrowser as T, UserConfig as U, VirtualEntrypointType as V, WxtDevServer as W, WxtViteConfig as a, OutputChunk as b, OutputAsset as c, BuildStepOutput as d, TargetManifestVersion as e, BaseEntrypointOptions as f, BaseEntrypoint as g, BackgroundEntrypoint as h, OptionsEntrypoint as i, Entrypoint as j, EntrypointGroup as k, OnContentScriptStopped as l, ContentScriptDefinition as m, ContentScriptIsolatedWorldDefinition as n, ContentScriptMainWorldDefinition as o, ContentScriptBaseDefinition as p, BackgroundDefinition as q, UnlistedScriptDefinition as r, PerBrowserOption as s, ExcludableEntrypoint as t, UserManifest as u, UserManifestFn as v, ConfigEnv as w, WxtBuilder as x, WxtBuilderServer as y, WxtHooks as z };
+export type { Eslintrc as $, UserManifestFn as A, BuildOutput as B, ContentScriptEntrypoint as C, ConfigEnv as D, ExtensionRunnerConfig as E, WxtBuilder as F, GenericEntrypoint as G, WxtBuilderServer as H, InlineConfig as I, ServerInfo as J, HookResult as K, Logger as L, MainWorldContentScriptEntrypointOptions as M, WxtHooks as N, OutputFile as O, PopupEntrypointOptions as P, Wxt as Q, ResolvedPerBrowserOptions as R, SidepanelEntrypointOptions as S, TargetBrowser as T, UserConfig as U, ResolvedConfig as V, WxtDevServer as W, FsCache as X, ExtensionRunner as Y, VirtualEntrypointType as Z, EslintGlobalsPropValue as _, WxtViteConfig as a, ResolvedEslintrc as a0, WxtUnimportOptions as a1, WxtResolvedUnimportOptions as a2, OutputChunk as b, OutputAsset as c, BuildStepOutput as d, TargetManifestVersion as e, BaseEntrypointOptions as f, BackgroundEntrypointOptions as g, BaseContentScriptEntrypointOptions as h, IsolatedWorldContentScriptEntrypointOptions as i, OptionsEntrypointOptions as j, BaseEntrypoint as k, BackgroundEntrypoint as l, PopupEntrypoint as m, OptionsEntrypoint as n, SidepanelEntrypoint as o, Entrypoint as p, EntrypointGroup as q, OnContentScriptStopped as r, IsolatedWorldContentScriptDefinition as s, MainWorldContentScriptDefinition as t, ContentScriptDefinition as u, BackgroundDefinition as v, UnlistedScriptDefinition as w, PerBrowserOption as x, PerBrowserMap as y, UserManifest as z };

package/dist/{index-sl22zA2Z.d.cts → index-h54vKikt.d.ts}

@@ -493,99 +493,34 @@ interface Logger {
     level: LogLevel;
 }
 interface BaseEntrypointOptions {
-    include?: TargetBrowser[];
-    exclude?: TargetBrowser[];
-}
-interface BaseEntrypoint {
     /**
-     * The entrypoint's name. This is the filename or dirname without the type suffix.
-     *
-     * Examples:
-     * - `popup.html` → `popup`
-     * - `options/index.html` → `options`
-     * - `named.sandbox.html` → `named`
-     * - `named.sandbox/index.html` → `named`
-     * - `sandbox.html` → `sandbox`
-     * - `sandbox/index.html` → `sandbox`
-     * - `overlay.content.ts` → `overlay`
-     * - `overlay.content/index.ts` → `overlay`
+     * List of target browsers to include this entrypoint in. Defaults to being included in all
+     * builds. Cannot be used with `exclude`. You must choose one of the two options.
      *
-     * The name is used when generating an output file:
-     * `<entrypoint.outputDir>/<entrypoint.name>.<ext>`
-     */
-    name: string;
-    /**
-     * Absolute path to the entrypoint's input file.
-     */
-    inputPath: string;
-    /**
-     * Absolute path to the entrypoint's output directory. Can be the`InternalConfg.outDir` or a
-     * subdirectory of it.
-     */
-    outputDir: string;
-    options: BaseEntrypointOptions;
-    skipped: boolean;
-}
-interface GenericEntrypoint extends BaseEntrypoint {
-    type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'sidepanel' | 'devtools' | 'unlisted-page' | 'unlisted-script' | 'unlisted-style' | 'content-script-style';
-}
-interface BackgroundEntrypoint extends BaseEntrypoint {
-    type: 'background';
-    options: {
-        persistent?: boolean;
-        type?: 'module';
-    } & BaseEntrypointOptions;
-}
-interface ContentScriptEntrypoint extends BaseEntrypoint {
-    type: 'content-script';
-    options: Omit<ContentScriptDefinition, 'main'> & BaseEntrypointOptions;
-}
-interface PopupEntrypoint extends BaseEntrypoint {
-    type: 'popup';
-    options: {
-        /**
-         * Defaults to "browser_action" to be equivalent to MV3's "action" key
-         */
-        mv2Key?: 'browser_action' | 'page_action';
-        defaultIcon?: Record<string, string>;
-        defaultTitle?: string;
-        browserStyle?: boolean;
-    } & BaseEntrypointOptions;
-}
-interface OptionsEntrypoint extends BaseEntrypoint {
-    type: 'options';
-    options: {
-        openInTab?: boolean;
-        browserStyle?: boolean;
-        chromeStyle?: boolean;
-    } & BaseEntrypointOptions;
-}
-type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint;
-type EntrypointGroup = Entrypoint | Entrypoint[];
-type OnContentScriptStopped = (cb: () => void) => void;
-type ContentScriptDefinition = ContentScriptIsolatedWorldDefinition | ContentScriptMainWorldDefinition;
-interface ContentScriptIsolatedWorldDefinition extends ContentScriptBaseDefinition {
-    /**
-     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
-     * @default "ISOLATED"
+     * @default undefined
      */
-    world?: 'ISOLATED';
+    include?: TargetBrowser[];
     /**
-     * Main function executed when the content script is loaded.
+     * List of target browsers to exclude this entrypoint from. Cannot be used with `include`. You
+     * must choose one of the two options.
+     *
+     * @default undefined
      */
-    main(ctx: ContentScriptContext): void | Promise<void>;
+    exclude?: TargetBrowser[];
 }
-interface ContentScriptMainWorldDefinition extends ContentScriptBaseDefinition {
-    /**
-     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
-     */
-    world: 'MAIN';
+interface BackgroundEntrypointOptions extends BaseEntrypointOptions {
+    persistent?: PerBrowserOption<boolean>;
     /**
-     * Main function executed when the content script is loaded.
+     * Set to `"module"` to output the background entrypoint as ESM. ESM outputs can share chunks and
+     * reduce the overall size of the bundled extension.
+     *
+     * When `undefined`, the background is bundled individually into an IIFE format.
+     *
+     * @default undefined
      */
-    main(): void | Promise<void>;
+    type?: PerBrowserOption<'module'>;
 }
-interface ContentScriptBaseDefinition extends ExcludableEntrypoint {
+interface BaseContentScriptEntrypointOptions extends BaseEntrypointOptions {
     matches: PerBrowserOption<Manifest.ContentScript['matches']>;
     /**
      * See https://developer.chrome.com/docs/extensions/mv3/content_scripts/
@@ -631,47 +566,168 @@ interface ContentScriptBaseDefinition extends ExcludableEntrypoint {
      *   onto the page. Use `browser.runtime.getURL("content-scripts/<name>.css")` to get the file's
      *   URL
      * - `"ui"` - Exclude the CSS from the manifest. CSS will be automatically added to your UI when
-     *   calling `createContentScriptUi`
+     *   calling `createShadowRootUi`
      *
      * @default "manifest"
      */
     cssInjectionMode?: PerBrowserOption<'manifest' | 'manual' | 'ui'>;
+    /**
+     * Specify how the content script is registered.
+     *
+     * - `"manifest"`: The content script will be added to the `content_scripts` entry in the
+     *   manifest. This is the normal and most well known way of registering a content script.
+     * - `"runtime"`: The content script's `matches` is added to `host_permissions` and you are
+     *   responsible for using the scripting API to register the content script dynamically at
+     *   runtime.
+     *
+     * @default "manifest"
+     */
+    registration?: PerBrowserOption<'manifest' | 'runtime'>;
 }
-interface BackgroundDefinition extends ExcludableEntrypoint {
-    type?: PerBrowserOption<'module'>;
-    persistent?: PerBrowserOption<boolean>;
-    main(): void;
+interface MainWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
+    /**
+     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
+     */
+    world: 'MAIN';
 }
-interface UnlistedScriptDefinition extends ExcludableEntrypoint {
+interface IsolatedWorldContentScriptEntrypointOptions extends BaseContentScriptEntrypointOptions {
     /**
-     * Main function executed when the unlisted script is ran.
+     * See https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts#isolated_world
+     * @default "ISOLATED"
      */
-    main(): void | Promise<void>;
+    world?: 'ISOLATED';
 }
-type PerBrowserOption<T> = T | {
-    [browser: TargetBrowser]: T;
-};
-interface ExcludableEntrypoint {
+interface PopupEntrypointOptions extends BaseEntrypointOptions {
     /**
-     * List of target browsers to include this entrypoint in. Defaults to being included in all
-     * builds. Cannot be used with `exclude`. You must choose one of the two options.
-     *
-     * @default undefined
+     * Defaults to "browser_action" to be equivalent to MV3's "action" key
      */
-    include?: TargetBrowser[];
+    mv2Key?: PerBrowserOption<'browser_action' | 'page_action'>;
+    defaultIcon?: Record<string, string>;
+    defaultTitle?: PerBrowserOption<string>;
+    browserStyle?: PerBrowserOption<boolean>;
+}
+interface OptionsEntrypointOptions extends BaseEntrypointOptions {
+    openInTab?: PerBrowserOption<boolean>;
+    browserStyle?: PerBrowserOption<boolean>;
+    chromeStyle?: PerBrowserOption<boolean>;
+}
+interface SidepanelEntrypointOptions extends BaseEntrypointOptions {
     /**
-     * List of target browsers to exclude this entrypoint from. Cannot be used with `include`. You
-     * must choose one of the two options.
+     * Firefox only. See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
+     * @default false
+     */
+    openAtInstall?: PerBrowserOption<boolean>;
+    /**
+     * @deprecated See https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/sidebar_action#syntax
+     */
+    browserStyle?: PerBrowserOption<boolean>;
+    defaultIcon?: string | Record<string, string>;
+    defaultTitle?: PerBrowserOption<string>;
+}
+interface BaseEntrypoint {
+    /**
+     * The entrypoint's name. This is the filename or dirname without the type suffix.
      *
-     * @default undefined
+     * Examples:
+     * - `popup.html` &rarr; `popup`
+     * - `options/index.html` &rarr; `options`
+     * - `named.sandbox.html` &rarr; `named`
+     * - `named.sandbox/index.html` &rarr; `named`
+     * - `sandbox.html` &rarr; `sandbox`
+     * - `sandbox/index.html` &rarr; `sandbox`
+     * - `overlay.content.ts` &rarr; `overlay`
+     * - `overlay.content/index.ts` &rarr; `overlay`
+     *
+     * The name is used when generating an output file:
+     * `<entrypoint.outputDir>/<entrypoint.name>.<ext>`
      */
-    exclude?: TargetBrowser[];
+    name: string;
+    /**
+     * Absolute path to the entrypoint's input file.
+     */
+    inputPath: string;
+    /**
+     * Absolute path to the entrypoint's output directory. Can be the`InternalConfg.outDir` or a
+     * subdirectory of it.
+     */
+    outputDir: string;
+    skipped: boolean;
 }
+interface GenericEntrypoint extends BaseEntrypoint {
+    type: 'sandbox' | 'bookmarks' | 'history' | 'newtab' | 'devtools' | 'unlisted-page' | 'unlisted-script' | 'unlisted-style' | 'content-script-style';
+    options: ResolvedPerBrowserOptions<BaseEntrypointOptions>;
+}
+interface BackgroundEntrypoint extends BaseEntrypoint {
+    type: 'background';
+    options: ResolvedPerBrowserOptions<BackgroundEntrypointOptions>;
+}
+interface ContentScriptEntrypoint extends BaseEntrypoint {
+    type: 'content-script';
+    options: ResolvedPerBrowserOptions<MainWorldContentScriptEntrypointOptions | IsolatedWorldContentScriptEntrypointOptions>;
+}
+interface PopupEntrypoint extends BaseEntrypoint {
+    type: 'popup';
+    options: ResolvedPerBrowserOptions<PopupEntrypointOptions, 'defaultIcon'>;
+}
+interface OptionsEntrypoint extends BaseEntrypoint {
+    type: 'options';
+    options: ResolvedPerBrowserOptions<OptionsEntrypointOptions>;
+}
+interface SidepanelEntrypoint extends BaseEntrypoint {
+    type: 'sidepanel';
+    options: ResolvedPerBrowserOptions<SidepanelEntrypointOptions, 'defaultIcon'>;
+}
+type Entrypoint = GenericEntrypoint | BackgroundEntrypoint | ContentScriptEntrypoint | PopupEntrypoint | OptionsEntrypoint | SidepanelEntrypoint;
+type EntrypointGroup = Entrypoint | Entrypoint[];
+type OnContentScriptStopped = (cb: () => void) => void;
+interface IsolatedWorldContentScriptDefinition extends IsolatedWorldContentScriptEntrypointOptions {
+    /**
+     * Main function executed when the content script is loaded.
+     */
+    main(ctx: ContentScriptContext): void | Promise<void>;
+}
+interface MainWorldContentScriptDefinition extends MainWorldContentScriptEntrypointOptions {
+    /**
+     * Main function executed when the content script is loaded.
+     */
+    main(): void | Promise<void>;
+}
+type ContentScriptDefinition = IsolatedWorldContentScriptDefinition | MainWorldContentScriptDefinition;
+interface BackgroundDefinition extends BackgroundEntrypointOptions {
+    /**
+     * Main function executed when the background script is started. Cannot be async.
+     */
+    main(): void;
+}
+interface UnlistedScriptDefinition extends BaseEntrypointOptions {
+    /**
+     * Main function executed when the unlisted script is ran.
+     */
+    main(): void | Promise<void>;
+}
+/**
+ * Either a single value or a map of different browsers to the value for that browser.
+ */
+type PerBrowserOption<T> = T | PerBrowserMap<T>;
+type PerBrowserMap<T> = {
+    [browser: TargetBrowser]: T;
+};
+/**
+ * Convert `{ key: PerBrowserOption<T> }` to just `{ key: T }`, stripping away the
+ * `PerBrowserOption` type for all fields inside the object.
+ *
+ * A optional second list of keys can be passed if a field isn't compatible with `PerBrowserOption`, like `defaultIcon`.
+ */
+type ResolvedPerBrowserOptions<T, TOmitted extends keyof T = never> = {
+    [key in keyof Omit<T, TOmitted>]: T[key] extends PerBrowserOption<infer U> ? U : T[key];
+} & {
+    [key in TOmitted]: T[key];
+};
 /**
  * Manifest customization available in the `wxt.config.ts` file. You cannot configure entrypoints
  * here, they are configured inline.
  */
-type UserManifest = Partial<Omit<Manifest.WebExtensionManifest, 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'sandbox' | 'sidepanel' | 'sidebar_action'>>;
+type UserManifest = Partial<Omit<Manifest.WebExtensionManifest, 'background' | 'chrome_url_overrides' | 'devtools_page' | 'manifest_version' | 'options_page' | 'options_ui' | 'sandbox'>>;
 type UserManifestFn = (env: ConfigEnv) => UserManifest | Promise<UserManifest>;
 interface ConfigEnv {
     mode: string;
@@ -986,4 +1042,4 @@ type WxtResolvedUnimportOptions = Partial<UnimportOptions> & {
     eslintrc: ResolvedEslintrc;
 };
 
-export type { Wxt as A, BuildOutput as B, ContentScriptEntrypoint as C, ExtensionRunner as D, ExtensionRunnerConfig as E, FsCache as F, GenericEntrypoint as G, HookResult as H, InlineConfig as I, EslintGlobalsPropValue as J, Eslintrc as K, Logger as L, ResolvedEslintrc as M, WxtUnimportOptions as N, OutputFile as O, PopupEntrypoint as P, WxtResolvedUnimportOptions as Q, ResolvedConfig as R, ServerInfo as S, TargetBrowser as T, UserConfig as U, VirtualEntrypointType as V, WxtDevServer as W, WxtViteConfig as a, OutputChunk as b, OutputAsset as c, BuildStepOutput as d, TargetManifestVersion as e, BaseEntrypointOptions as f, BaseEntrypoint as g, BackgroundEntrypoint as h, OptionsEntrypoint as i, Entrypoint as j, EntrypointGroup as k, OnContentScriptStopped as l, ContentScriptDefinition as m, ContentScriptIsolatedWorldDefinition as n, ContentScriptMainWorldDefinition as o, ContentScriptBaseDefinition as p, BackgroundDefinition as q, UnlistedScriptDefinition as r, PerBrowserOption as s, ExcludableEntrypoint as t, UserManifest as u, UserManifestFn as v, ConfigEnv as w, WxtBuilder as x, WxtBuilderServer as y, WxtHooks as z };
+export type { Eslintrc as $, UserManifestFn as A, BuildOutput as B, ContentScriptEntrypoint as C, ConfigEnv as D, ExtensionRunnerConfig as E, WxtBuilder as F, GenericEntrypoint as G, WxtBuilderServer as H, InlineConfig as I, ServerInfo as J, HookResult as K, Logger as L, MainWorldContentScriptEntrypointOptions as M, WxtHooks as N, OutputFile as O, PopupEntrypointOptions as P, Wxt as Q, ResolvedPerBrowserOptions as R, SidepanelEntrypointOptions as S, TargetBrowser as T, UserConfig as U, ResolvedConfig as V, WxtDevServer as W, FsCache as X, ExtensionRunner as Y, VirtualEntrypointType as Z, EslintGlobalsPropValue as _, WxtViteConfig as a, ResolvedEslintrc as a0, WxtUnimportOptions as a1, WxtResolvedUnimportOptions as a2, OutputChunk as b, OutputAsset as c, BuildStepOutput as d, TargetManifestVersion as e, BaseEntrypointOptions as f, BackgroundEntrypointOptions as g, BaseContentScriptEntrypointOptions as h, IsolatedWorldContentScriptEntrypointOptions as i, OptionsEntrypointOptions as j, BaseEntrypoint as k, BackgroundEntrypoint as l, PopupEntrypoint as m, OptionsEntrypoint as n, SidepanelEntrypoint as o, Entrypoint as p, EntrypointGroup as q, OnContentScriptStopped as r, IsolatedWorldContentScriptDefinition as s, MainWorldContentScriptDefinition as t, ContentScriptDefinition as u, BackgroundDefinition as v, UnlistedScriptDefinition as w, PerBrowserOption as x, PerBrowserMap as y, UserManifest as z };