adnbn 0.14.0 → 0.15.0

package/dist/relay/result.js

@@ -11,6 +11,12 @@ class RelayFrameTimeoutError extends Error {
   }
   timeoutMs;
 }
+class RelayProtocolError extends Error {
+  constructor(relayName) {
+    super(`Relay "${relayName}" returned an invalid scripting response envelope.`);
+    this.name = "RelayProtocolError";
+  }
+}
 const fulfilledRelayFrame = (target, result) => ({
   target,
   status: "fulfilled",
@@ -78,6 +84,7 @@ const sortRelayFrameResults = (results) => {
 };
 export {
   RelayFrameTimeoutError,
+  RelayProtocolError,
   fulfilledRelayFrame,
   injectScriptErrorKind,
   messageErrorKind,

package/dist/relay/result.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/relay/result.ts"],"sourcesContent":["import {serializeError} from \"@message/error\";\n\nimport {InjectScriptTargetErrorKind} from \"@addon-core/inject-script\";\n\nimport {\n    RelayFrameErrorKind,\n    type RelayFrameResult,\n    type RelayFramesResult,\n    type RelayResultTarget,\n} from \"@typing/relay\";\n\nexport class RelayFrameTimeoutError extends Error {\n    public constructor(public readonly timeoutMs: number) {\n        super(`Relay frame did not respond within ${timeoutMs}ms.`);\n        this.name = \"RelayFrameTimeoutError\";\n    }\n}\n\nexport const fulfilledRelayFrame = <T>(target: RelayResultTarget, result: T): RelayFrameResult<T> => ({\n    target,\n    status: \"fulfilled\",\n    result,\n});\n\nexport const rejectedRelayFrame = <T>(\n    target: RelayResultTarget,\n    error: unknown,\n    kind: RelayFrameErrorKind\n): RelayFrameResult<T> => ({\n    target,\n    status: \"rejected\",\n    error: {\n        kind,\n        ...serializeError(error),\n    },\n});\n\nexport const messageErrorKind = (error: unknown): RelayFrameErrorKind => {\n    const message = error instanceof Error ? error.message : String(error);\n\n    if (\n        /receiving end does not exist|no matching message handler|frame.*(?:removed|not found)|no frame with id|invalid frame id/i.test(\n            message\n        )\n    ) {\n        return RelayFrameErrorKind.TargetGone;\n    }\n\n    return RelayFrameErrorKind.Delivery;\n};\n\nexport const injectScriptErrorKind = (kind: `${InjectScriptTargetErrorKind}`): RelayFrameErrorKind => {\n    switch (kind) {\n        case InjectScriptTargetErrorKind.Execution:\n            return RelayFrameErrorKind.Execution;\n        case InjectScriptTargetErrorKind.Delivery:\n            return RelayFrameErrorKind.Delivery;\n        case InjectScriptTargetErrorKind.Timeout:\n            return RelayFrameErrorKind.Timeout;\n        case InjectScriptTargetErrorKind.TargetGone:\n            return RelayFrameErrorKind.TargetGone;\n        case InjectScriptTargetErrorKind.Unobservable:\n            return RelayFrameErrorKind.Unobservable;\n        default:\n            throw new TypeError(`Unsupported Inject Script target error kind: ${kind}`);\n    }\n};\n\nexport const withRelayTimeout = <T>(promise: Promise<T>, timeoutMs?: number): Promise<T> => {\n    if (timeoutMs === undefined) {\n        return promise;\n    }\n\n    return new Promise<T>((resolve, reject) => {\n        const timeout = setTimeout(() => reject(new RelayFrameTimeoutError(timeoutMs)), timeoutMs);\n\n        promise.then(\n            result => {\n                clearTimeout(timeout);\n                resolve(result);\n            },\n            error => {\n                clearTimeout(timeout);\n                reject(error);\n            }\n        );\n    });\n};\n\nexport const sortRelayFrameResults = <T>(results: RelayFramesResult<T>): RelayFramesResult<T> => {\n    return [...results].sort((a, b) => {\n        const frameDifference =\n            (a.target.frameId ?? Number.MAX_SAFE_INTEGER) - (b.target.frameId ?? Number.MAX_SAFE_INTEGER);\n\n        if (frameDifference !== 0) {\n            return frameDifference;\n        }\n\n        return (a.target.documentId ?? \"\").localeCompare(b.target.documentId ?? \"\");\n    });\n};\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAE7B,SAAQ,mCAAkC;AAE1C;AAAA,EACI;AAAA,OAIG;AAEA,MAAM,+BAA+B,MAAM;AAAA,EACvC,YAA4B,WAAmB;AAClD,UAAM,sCAAsC,SAAS,KAAK;AAD3B;AAE/B,SAAK,OAAO;AAAA,EAChB;AAAA,EAHmC;AAIvC;AAEO,MAAM,sBAAsB,CAAI,QAA2B,YAAoC;AAAA,EAClG;AAAA,EACA,QAAQ;AAAA,EACR;AACJ;AAEO,MAAM,qBAAqB,CAC9B,QACA,OACA,UACuB;AAAA,EACvB;AAAA,EACA,QAAQ;AAAA,EACR,OAAO;AAAA,IACH;AAAA,IACA,GAAG,eAAe,KAAK;AAAA,EAC3B;AACJ;AAEO,MAAM,mBAAmB,CAAC,UAAwC;AACrE,QAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAErE,MACI,2HAA2H;AAAA,IACvH;AAAA,EACJ,GACF;AACE,WAAO,oBAAoB;AAAA,EAC/B;AAEA,SAAO,oBAAoB;AAC/B;AAEO,MAAM,wBAAwB,CAAC,SAAgE;AAClG,UAAQ,MAAM;AAAA,IACV,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B;AACI,YAAM,IAAI,UAAU,gDAAgD,IAAI,EAAE;AAAA,EAClF;AACJ;AAEO,MAAM,mBAAmB,CAAI,SAAqB,cAAmC;AACxF,MAAI,cAAc,QAAW;AACzB,WAAO;AAAA,EACX;AAEA,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACvC,UAAM,UAAU,WAAW,MAAM,OAAO,IAAI,uBAAuB,SAAS,CAAC,GAAG,SAAS;AAEzF,YAAQ;AAAA,MACJ,YAAU;AACN,qBAAa,OAAO;AACpB,gBAAQ,MAAM;AAAA,MAClB;AAAA,MACA,WAAS;AACL,qBAAa,OAAO;AACpB,eAAO,KAAK;AAAA,MAChB;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;AAEO,MAAM,wBAAwB,CAAI,YAAwD;AAC7F,SAAO,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM;AAC/B,UAAM,mBACD,EAAE,OAAO,WAAW,OAAO,qBAAqB,EAAE,OAAO,WAAW,OAAO;AAEhF,QAAI,oBAAoB,GAAG;AACvB,aAAO;AAAA,IACX;AAEA,YAAQ,EAAE,OAAO,cAAc,IAAI,cAAc,EAAE,OAAO,cAAc,EAAE;AAAA,EAC9E,CAAC;AACL;","names":[]}
+{"version":3,"sources":["../../src/relay/result.ts"],"sourcesContent":["import {serializeError} from \"@message/error\";\n\nimport {InjectScriptTargetErrorKind} from \"@addon-core/inject-script\";\n\nimport {\n    RelayFrameErrorKind,\n    type RelayFrameResult,\n    type RelayFramesResult,\n    type RelayResultTarget,\n} from \"@typing/relay\";\n\nexport class RelayFrameTimeoutError extends Error {\n    public constructor(public readonly timeoutMs: number) {\n        super(`Relay frame did not respond within ${timeoutMs}ms.`);\n        this.name = \"RelayFrameTimeoutError\";\n    }\n}\n\nexport class RelayProtocolError extends Error {\n    public constructor(relayName: string) {\n        super(`Relay \"${relayName}\" returned an invalid scripting response envelope.`);\n        this.name = \"RelayProtocolError\";\n    }\n}\n\nexport const fulfilledRelayFrame = <T>(target: RelayResultTarget, result: T): RelayFrameResult<T> => ({\n    target,\n    status: \"fulfilled\",\n    result,\n});\n\nexport const rejectedRelayFrame = <T>(\n    target: RelayResultTarget,\n    error: unknown,\n    kind: RelayFrameErrorKind\n): RelayFrameResult<T> => ({\n    target,\n    status: \"rejected\",\n    error: {\n        kind,\n        ...serializeError(error),\n    },\n});\n\nexport const messageErrorKind = (error: unknown): RelayFrameErrorKind => {\n    const message = error instanceof Error ? error.message : String(error);\n\n    if (\n        /receiving end does not exist|no matching message handler|frame.*(?:removed|not found)|no frame with id|invalid frame id/i.test(\n            message\n        )\n    ) {\n        return RelayFrameErrorKind.TargetGone;\n    }\n\n    return RelayFrameErrorKind.Delivery;\n};\n\nexport const injectScriptErrorKind = (kind: `${InjectScriptTargetErrorKind}`): RelayFrameErrorKind => {\n    switch (kind) {\n        case InjectScriptTargetErrorKind.Execution:\n            return RelayFrameErrorKind.Execution;\n        case InjectScriptTargetErrorKind.Delivery:\n            return RelayFrameErrorKind.Delivery;\n        case InjectScriptTargetErrorKind.Timeout:\n            return RelayFrameErrorKind.Timeout;\n        case InjectScriptTargetErrorKind.TargetGone:\n            return RelayFrameErrorKind.TargetGone;\n        case InjectScriptTargetErrorKind.Unobservable:\n            return RelayFrameErrorKind.Unobservable;\n        default:\n            throw new TypeError(`Unsupported Inject Script target error kind: ${kind}`);\n    }\n};\n\nexport const withRelayTimeout = <T>(promise: Promise<T>, timeoutMs?: number): Promise<T> => {\n    if (timeoutMs === undefined) {\n        return promise;\n    }\n\n    return new Promise<T>((resolve, reject) => {\n        const timeout = setTimeout(() => reject(new RelayFrameTimeoutError(timeoutMs)), timeoutMs);\n\n        promise.then(\n            result => {\n                clearTimeout(timeout);\n                resolve(result);\n            },\n            error => {\n                clearTimeout(timeout);\n                reject(error);\n            }\n        );\n    });\n};\n\nexport const sortRelayFrameResults = <T>(results: RelayFramesResult<T>): RelayFramesResult<T> => {\n    return [...results].sort((a, b) => {\n        const frameDifference =\n            (a.target.frameId ?? Number.MAX_SAFE_INTEGER) - (b.target.frameId ?? Number.MAX_SAFE_INTEGER);\n\n        if (frameDifference !== 0) {\n            return frameDifference;\n        }\n\n        return (a.target.documentId ?? \"\").localeCompare(b.target.documentId ?? \"\");\n    });\n};\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAE7B,SAAQ,mCAAkC;AAE1C;AAAA,EACI;AAAA,OAIG;AAEA,MAAM,+BAA+B,MAAM;AAAA,EACvC,YAA4B,WAAmB;AAClD,UAAM,sCAAsC,SAAS,KAAK;AAD3B;AAE/B,SAAK,OAAO;AAAA,EAChB;AAAA,EAHmC;AAIvC;AAEO,MAAM,2BAA2B,MAAM;AAAA,EACnC,YAAY,WAAmB;AAClC,UAAM,UAAU,SAAS,oDAAoD;AAC7E,SAAK,OAAO;AAAA,EAChB;AACJ;AAEO,MAAM,sBAAsB,CAAI,QAA2B,YAAoC;AAAA,EAClG;AAAA,EACA,QAAQ;AAAA,EACR;AACJ;AAEO,MAAM,qBAAqB,CAC9B,QACA,OACA,UACuB;AAAA,EACvB;AAAA,EACA,QAAQ;AAAA,EACR,OAAO;AAAA,IACH;AAAA,IACA,GAAG,eAAe,KAAK;AAAA,EAC3B;AACJ;AAEO,MAAM,mBAAmB,CAAC,UAAwC;AACrE,QAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAErE,MACI,2HAA2H;AAAA,IACvH;AAAA,EACJ,GACF;AACE,WAAO,oBAAoB;AAAA,EAC/B;AAEA,SAAO,oBAAoB;AAC/B;AAEO,MAAM,wBAAwB,CAAC,SAAgE;AAClG,UAAQ,MAAM;AAAA,IACV,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B,KAAK,4BAA4B;AAC7B,aAAO,oBAAoB;AAAA,IAC/B;AACI,YAAM,IAAI,UAAU,gDAAgD,IAAI,EAAE;AAAA,EAClF;AACJ;AAEO,MAAM,mBAAmB,CAAI,SAAqB,cAAmC;AACxF,MAAI,cAAc,QAAW;AACzB,WAAO;AAAA,EACX;AAEA,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACvC,UAAM,UAAU,WAAW,MAAM,OAAO,IAAI,uBAAuB,SAAS,CAAC,GAAG,SAAS;AAEzF,YAAQ;AAAA,MACJ,YAAU;AACN,qBAAa,OAAO;AACpB,gBAAQ,MAAM;AAAA,MAClB;AAAA,MACA,WAAS;AACL,qBAAa,OAAO;AACpB,eAAO,KAAK;AAAA,MAChB;AAAA,IACJ;AAAA,EACJ,CAAC;AACL;AAEO,MAAM,wBAAwB,CAAI,YAAwD;AAC7F,SAAO,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM;AAC/B,UAAM,mBACD,EAAE,OAAO,WAAW,OAAO,qBAAqB,EAAE,OAAO,WAAW,OAAO;AAEhF,QAAI,oBAAoB,GAAG;AACvB,aAAO;AAAA,IACX;AAEA,YAAQ,EAAE,OAAO,cAAc,IAAI,cAAc,EAAE,OAAO,cAAc,EAAE;AAAA,EAC9E,CAAC;AACL;","names":[]}

package/dist/types/action.d.ts

@@ -0,0 +1,8 @@
+import type { IconName } from "./icon.js";
+/** Default appearance of the extension's toolbar button. */
+export interface ActionOptions {
+    /** Icon group name. Falls back to `config.icon` when omitted. */
+    icon?: IconName;
+    /** Tooltip text or locale key, such as `@action.title`. Defaults to the extension name. */
+    title?: string;
+}

package/dist/types/action.js

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

package/dist/types/action.js.map

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

package/dist/types/config.d.ts

@@ -7,6 +7,7 @@ import { Plugin } from "./plugin.js";
 import { Language } from "./locale.js";
 import { Awaiter } from "./helpers.js";
 import { EnvFilterOptions, EnvFilterVariant } from "./env.js";
+import { ActionOptions } from "./action.js";
 /**
  * Configuration options for building a browser extension. This interface defines
  * all the properties required to customize the build process, extension metadata,
@@ -136,6 +137,18 @@ export interface Config {
      * - "disable"
      */
     icon: string;
+    /**
+     * Default appearance of the toolbar button (`action` in MV3, `browser_action` in MV2).
+     * An explicit object, including `{}`, declares the button without requiring a popup or command.
+     * It does not register a click handler.
+     *
+     * The applied popup overrides each explicitly specified icon/title independently.
+     * Missing values fall back to these settings, then to `icon` and the extension name.
+     * When omitted, only an applied popup or execute-action command declares the button.
+     *
+     * @example {icon: "active", title: "@action.title"}
+     */
+    action?: ActionOptions;
     /**
      * Browser-specific settings (populate manifest.browser_specific_settings).
      *
@@ -405,7 +418,10 @@ export interface Config {
     concatContentScripts: boolean;
     /**
      * Flag indicating whether to merge styles from App and Shared directories.
-     * When `true`, styles from both directories will be combined.
+     * When `true`, importing a shared stylesheet also compiles the app stylesheet at the same
+     * relative path into the same CSS module, with shared rules before app rules. Relative `@use`
+     * and `@forward` requests and literal `url(...)` values in the merged sources resolve from the
+     * file that declares them.
      *
      * @default true
      */

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

@@ -1,6 +1,6 @@
 import type { ContentScriptPrepareHandler } from "./prepare.js";
 import type { ContentScriptBoundaryHandler } from "./boundary.js";
-import type { ContentScriptAnchor, ContentScriptAnchorGetter, ContentScriptAppend, ContentScriptContainerCreator, ContentScriptContainerFactory, ContentScriptContainerOptions, ContentScriptContainerTag, ContentScriptFramePageOptions, ContentScriptFrameRenderOptions, ContentScriptFrameSourceOptions, ContentScriptIsolation, ContentScriptIsolationFrameOptions, ContentScriptIsolationOptions, ContentScriptIsolationShadowOptions, ContentScriptMainFunction, ContentScriptMarkerGetter, ContentScriptMarkerResolver, ContentScriptMarkerType, ContentScriptMountFunction, ContentScriptOptions, ContentScriptWatchStrategy } from "./common.js";
+import type { ContentScriptAnchor, ContentScriptAnchorGetter, ContentScriptBuilder, ContentScriptAppend, ContentScriptContainerCreator, ContentScriptContainerFactory, ContentScriptContainerOptions, ContentScriptContainerTag, ContentScriptFramePageOptions, ContentScriptFrameRenderOptions, ContentScriptFrameSourceOptions, ContentScriptIsolation, ContentScriptIsolationFrameOptions, ContentScriptIsolationOptions, ContentScriptIsolationShadowOptions, ContentScriptMainFunction, ContentScriptMarkerGetter, ContentScriptMarkerResolver, ContentScriptMarkerType, ContentScriptMountFunction, ContentScriptOptions, ContentScriptWatchStrategy } from "./common.js";
 import type { ContentScriptRenderHandler, ContentScriptRenderValue } from "./render.js";
 import type { ContentScriptTarget, ContentScriptTargetCreator } from "./target.js";
 export interface ContentScriptDefinitionBase<Data = unknown> extends Partial<ContentScriptOptions> {
@@ -50,6 +50,7 @@ export type ContentScriptRenderDefinition<Data = unknown, Isolation extends `${C
     isolation: unknown;
 });
 export type ContentScriptDefinition<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = ContentScriptDefinitionBase<Data> & ContentScriptRenderDefinition<Data, Isolation>;
+export type ContentScriptBuilderConstructor<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = new (definition: ContentScriptDefinition<Data, NoInfer<Isolation>>) => ContentScriptBuilder;
 export interface ContentScriptResolvedDefinition<Data = unknown> extends Omit<ContentScriptDefinitionBase<Data>, "anchor" | "marker" | "mount" | "container" | "watch"> {
     isolation: ContentScriptIsolationOptions;
     boundary?: ContentScriptBoundaryHandler<Data>;

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 {
@@ -16,6 +17,7 @@ type ManifestCommon = chrome.runtime.Manifest;
 type ManifestBase = chrome.runtime.ManifestBase;
 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,6 +80,7 @@ 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;

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

@@ -2,6 +2,7 @@ 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`.
@@ -11,7 +12,7 @@ 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 & PermissionsOptions & CspOptions & ViewOptions;

package/dist/types/sidebar.d.ts

@@ -3,6 +3,7 @@ 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.
@@ -13,7 +14,7 @@ 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 & PermissionsOptions & CspOptions & ViewOptions;

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 {PermissionsOptions} from \"@typing/permissions\";\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 & PermissionsOptions & CspOptions & ViewOptions;\n\nexport type SidebarProps = SidebarEntrypointOptions;\n\nexport type SidebarDefinition = SidebarEntrypointOptions & ViewDefinition<SidebarProps>;\n"],"mappings":"AACA,SAAQ,eAAc;AAKf,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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adnbn",
   "type": "module",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Addon Bone - Cross-browser web extension framework with shared code base",
   "homepage": "https://addonbone.com",
   "author": "Anjey Tsibylskij (https://github.com/atldays)",
@@ -31,9 +31,9 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "bin",
+    "bin/adnbn.js",
     "dist",
-    "scripts",
+    "scripts/check-node-version.js",
     "types"
   ],
   "engines": {
@@ -114,39 +114,28 @@
     "prepublishOnly": "npm run build",
     "build": "node ./scripts/clean-dist.js && tsup && tsc -p tsconfig.build.json && node ./scripts/copy-dts.js && tsc-alias -p tsconfig.build.json -f -fe .js",
     "format": "prettier --write .",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "prepare:integration": "npm run build && tsx tests/integration/prepare.ts",
-    "typecheck:integration": "npm run build && tsx tests/integration/typecheck.ts --prepare",
-    "test:integration": "npm run build && node scripts/test-run.mjs --selectProjects build types chrome firefox",
-    "test:integration:build": "npm run test:build --",
+    "check": "tsx tests/check.ts",
     "check:node-version": "node ./scripts/check-node-version.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:fixtures": "npm run build && tsx tests/integration/typecheck.ts --prepare",
+    "fixtures:prepare": "npm run build && tsx tests/integration/prepare.ts",
     "test": "npm run build && node scripts/test-run.mjs",
-    "test:ci": "npm run test -- --ci --coverage",
-    "test:ci:non-browser": "npm run test -- --ci --coverage --selectProjects unit-node unit-dom build types",
-    "test:watch": "node scripts/test-run.mjs --selectProjects unit-node unit-dom --watch",
-    "test:offscreen": "node scripts/test-run.mjs --testPathPatterns=Offscreen",
-    "test:chrome": "npm run build && node scripts/test-run.mjs --selectProjects chrome",
-    "test:firefox": "npm run build && node scripts/test-run.mjs --selectProjects firefox",
-    "test:message": "node scripts/test-run.mjs --testPathPatterns=src/message",
-    "test:service": "node scripts/test-run.mjs --testPathPatterns=Service",
-    "test:relay": "npm run test -- --testPathPatterns=Relay",
-    "test:locale": "npm run test -- --testPathPatterns=Locale",
-    "test:manifest": "node scripts/test-run.mjs --testPathPatterns=src/cli/builders/manifest",
-    "test:entrypoint": "node scripts/test-run.mjs --testPathPatterns=src/cli/entrypoint",
-    "test:plugins": "npm run test -- --testPathPatterns=src/cli/plugins",
-    "release": "release-it",
-    "release:preview": "release-it --no-github.release --no-npm.publish --no-git.tag --ci",
     "test:unit": "node scripts/test-run.mjs --selectProjects unit-node unit-dom --verbose=false",
-    "test:build": "npm run build && node scripts/test-run.mjs --selectProjects build",
-    "test:types": "npm run typecheck:integration && node scripts/test-run.mjs --selectProjects types",
+    "test:watch": "node scripts/test-run.mjs --selectProjects unit-node unit-dom --watch",
+    "test:build": "npm run build && node scripts/test-run.mjs --selectProjects build --verbose=false",
+    "test:types": "npm run build && node scripts/test-run.mjs --selectProjects types --verbose=false",
+    "test:browser": "npm run build && node scripts/test-run.mjs --selectProjects chrome firefox --verbose=false",
+    "test:browser:chrome": "npm run build && node scripts/test-run.mjs --selectProjects chrome --verbose=false",
+    "test:browser:firefox": "npm run build && node scripts/test-run.mjs --selectProjects firefox --verbose=false",
     "test:inventory": "node scripts/test-inventory.mjs",
-    "test:pre-push": "tsx tests/pre-push.ts",
-    "test:run": "node scripts/test-run.mjs"
+    "test:run": "node scripts/test-run.mjs",
+    "release": "release-it",
+    "release:preview": "release-it --release-version --dry-run --no-git.requireBranch --no-git.requireCleanWorkingDir --no-git.push --no-github.release --no-npm.publish --ci && release-it --changelog --dry-run --no-git.requireBranch --no-git.requireCleanWorkingDir --no-git.push --no-github.release --no-npm.publish --ci"
   },
   "dependencies": {
-    "@addon-core/browser": "^0.7.2",
+    "@addon-core/browser": "^0.9.0",
     "@addon-core/inject-script": "^0.5.0",
-    "@addon-core/storage": "^0.7.0",
+    "@addon-core/storage": "^0.8.0",
     "@rsdoctor/rspack-plugin": "^1.5.1",
     "@rspack/cli": "^1.7.5",
     "@rspack/core": "^1.7.5",
@@ -172,7 +161,6 @@
     "sass": "^1.83.4",
     "sass-loader": "^16.0.4",
     "semver": "^7.7.3",
-    "source-modifier-loader": "^1.0.2",
     "tsconfig-paths": "^4.2.0",
     "type-fest": "^4.37.0",
     "typescript": "^5.7.3",
@@ -212,7 +200,6 @@
     "istanbul-reports": "^3.2.0",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.0.0",
-    "jest-webextension-mock": "^4.0.0",
     "prettier": "^3.6.2",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",

package/dist/cli/builders/app/command.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/cli/builders/app/command.ts"],"sourcesContent":["import {Compiler} from \"@rspack/core\";\n\nexport const build = (compiler: Compiler) => {\n    compiler.run((err, stats) => {\n        if (err) {\n            console.error(\"Rspack compilation error:\", err);\n            process.exit(1);\n        }\n\n        if (stats?.hasErrors()) {\n            console.error(\n                stats.toString({\n                    colors: true,\n                    errors: true,\n                })\n            );\n\n            process.exit(1);\n        }\n\n        console.log(stats?.toString({colors: true}));\n\n        compiler.close(closeErr => {\n            if (closeErr) {\n                console.error(\"Rspack close error:\", closeErr);\n                process.exit(1);\n            }\n        });\n    });\n};\n\nexport const watch = (compiler: Compiler) => {\n    const watching = compiler.watch(\n        {\n            aggregateTimeout: 300,\n            ignored: /node_modules/,\n        },\n        (err, stats) => {\n            if (err) {\n                console.error(\"Rspack watch error:\", err);\n                process.exit(1);\n            }\n\n            if (stats?.hasErrors()) {\n                console.error(\n                    stats.toString({\n                        colors: true,\n                        errors: true,\n                    })\n                );\n\n                return;\n            }\n\n            console.log(stats?.toString({colors: true}));\n        }\n    );\n\n    process.on(\"SIGINT\", () => {\n        watching.close(() => {\n            console.log(\"Rspack watch mode stopped\");\n            process.exit(0);\n        });\n    });\n};\n"],"mappings":"AAEO,MAAM,QAAQ,CAAC,aAAuB;AACzC,WAAS,IAAI,CAAC,KAAK,UAAU;AACzB,QAAI,KAAK;AACL,cAAQ,MAAM,6BAA6B,GAAG;AAC9C,cAAQ,KAAK,CAAC;AAAA,IAClB;AAEA,QAAI,+BAAO,aAAa;AACpB,cAAQ;AAAA,QACJ,MAAM,SAAS;AAAA,UACX,QAAQ;AAAA,UACR,QAAQ;AAAA,QACZ,CAAC;AAAA,MACL;AAEA,cAAQ,KAAK,CAAC;AAAA,IAClB;AAEA,YAAQ,IAAI,+BAAO,SAAS,EAAC,QAAQ,KAAI,EAAE;AAE3C,aAAS,MAAM,cAAY;AACvB,UAAI,UAAU;AACV,gBAAQ,MAAM,uBAAuB,QAAQ;AAC7C,gBAAQ,KAAK,CAAC;AAAA,MAClB;AAAA,IACJ,CAAC;AAAA,EACL,CAAC;AACL;AAEO,MAAM,QAAQ,CAAC,aAAuB;AACzC,QAAM,WAAW,SAAS;AAAA,IACtB;AAAA,MACI,kBAAkB;AAAA,MAClB,SAAS;AAAA,IACb;AAAA,IACA,CAAC,KAAK,UAAU;AACZ,UAAI,KAAK;AACL,gBAAQ,MAAM,uBAAuB,GAAG;AACxC,gBAAQ,KAAK,CAAC;AAAA,MAClB;AAEA,UAAI,+BAAO,aAAa;AACpB,gBAAQ;AAAA,UACJ,MAAM,SAAS;AAAA,YACX,QAAQ;AAAA,YACR,QAAQ;AAAA,UACZ,CAAC;AAAA,QACL;AAEA;AAAA,MACJ;AAEA,cAAQ,IAAI,+BAAO,SAAS,EAAC,QAAQ,KAAI,EAAE;AAAA,IAC/C;AAAA,EACJ;AAEA,UAAQ,GAAG,UAAU,MAAM;AACvB,aAAS,MAAM,MAAM;AACjB,cAAQ,IAAI,2BAA2B;AACvC,cAAQ,KAAK,CAAC;AAAA,IAClB,CAAC;AAAA,EACL,CAAC;AACL;","names":[]}

package/dist/locale/providers/ObservableLocale.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/locale/providers/ObservableLocale.ts"],"sourcesContent":["import DynamicLocale from \"./DynamicLocale\";\nimport CustomLocale from \"./CustomLocale\";\n\nimport {LocaleStorage} from \"../storage\";\n\nimport type {\n    Language,\n    LocaleDynamicProvider,\n    LocaleNonPluralKeys,\n    LocalePluralKeys,\n    LocaleRegistry,\n    LocaleSnapshot,\n    LocaleStorageDriver,\n    LocaleSubstitutionArgs,\n    LocaleSubstitutionValue,\n} from \"@typing/locale\";\n\n/** Dynamic translations with shared instances and subscriptions independent of any UI framework. */\nexport default class ObservableLocale<T extends object = LocaleRegistry> implements LocaleDynamicProvider<T> {\n    private static defaultInstance?: ObservableLocale;\n    private static memoryInstance?: ObservableLocale;\n\n    private static readonly drivers = new WeakMap<LocaleStorageDriver, ObservableLocale>();\n\n    public static getInstance(storage?: LocaleStorageDriver | false): ObservableLocale {\n        if (typeof storage === \"object\") {\n            let instance = this.drivers.get(storage);\n\n            if (!instance) {\n                instance = new ObservableLocale(storage);\n                this.drivers.set(storage, instance);\n            }\n\n            return instance;\n        }\n\n        if (storage === false) {\n            return (this.memoryInstance ??= new ObservableLocale(false));\n        }\n\n        return (this.defaultInstance ??= new ObservableLocale());\n    }\n\n    private readonly locale = new DynamicLocale<T>(false);\n    private readonly storage?: LocaleStorageDriver;\n    private readonly listeners = new Set<() => void>();\n    private readonly languages: ReadonlySet<Language>;\n    private readonly languageNames: ReadonlyMap<Language, string>;\n    private currentSnapshot: LocaleSnapshot<T>;\n    private revision = 0;\n    private writes: Promise<void> = Promise.resolve();\n    private pendingWrites = 0;\n    private unsubscribe?: () => void;\n\n    constructor(storage?: LocaleStorageDriver | false) {\n        this.storage = storage === false ? undefined : (storage ?? new LocaleStorage());\n        this.languages = this.langs();\n        this.languageNames = this.langNames();\n        this.currentSnapshot = this.createSnapshot();\n    }\n\n    public lang(): Language {\n        return this.locale.lang();\n    }\n\n    public langs(): ReadonlySet<Language> {\n        return this.locale.langs();\n    }\n\n    public langNames(): ReadonlyMap<Language, string> {\n        return this.locale.langNames();\n    }\n\n    public keys(): Set<keyof T> {\n        return this.locale.keys();\n    }\n\n    public get<K extends keyof T & string>(key: K, substitutions?: Record<string, LocaleSubstitutionValue>): string {\n        return this.locale.get(key, substitutions);\n    }\n\n    public trans<K extends LocaleNonPluralKeys<T>>(key: K, ...args: LocaleSubstitutionArgs<T, K>): string {\n        return this.locale.trans(key, ...args);\n    }\n\n    public choice<K extends LocalePluralKeys<T>>(key: K, count: number, ...args: LocaleSubstitutionArgs<T, K>): string {\n        return this.locale.choice(key, count, ...args);\n    }\n\n    public readonly snapshot = (): LocaleSnapshot<T> => this.currentSnapshot;\n\n    public readonly subscribe = (listener: () => void): (() => void) => {\n        // Each subscription owns its cleanup, even when the same callback is subscribed twice.\n        const notify = () => listener();\n\n        this.listeners.add(notify);\n\n        try {\n            this.connect();\n        } catch (error) {\n            this.listeners.delete(notify);\n            throw error;\n        }\n\n        if (this.listeners.size === 1) {\n            void this.refresh();\n        }\n\n        return () => {\n            this.listeners.delete(notify);\n            this.disconnect();\n        };\n    };\n\n    public readonly change = async (lang: Language): Promise<Language> => {\n        this.locale.select(lang);\n\n        const storage = this.storage;\n\n        if (!storage) {\n            this.publish();\n            return lang;\n        }\n\n        this.revision++;\n\n        // Register persistence before notifying: a subscriber may select another language immediately.\n        this.pendingWrites++;\n\n        const saved = this.writes.then(() => storage.set(lang));\n\n        this.writes = saved.catch(() => undefined);\n\n        this.publish();\n\n        let succeeded = false;\n\n        try {\n            await saved;\n            succeeded = true;\n\n            return lang;\n        } finally {\n            if (--this.pendingWrites === 0 && succeeded) {\n                void this.refresh();\n            }\n        }\n    };\n\n    public async sync(): Promise<Language> {\n        if (!this.storage) {\n            throw new Error(\"Language is not saving in storage\");\n        }\n\n        if (this.pendingWrites) {\n            return this.lang();\n        }\n\n        const revision = ++this.revision;\n        const lang = await this.storage.get();\n\n        if (revision !== this.revision || this.pendingWrites) {\n            return this.lang();\n        }\n\n        if (lang === undefined) {\n            return this.lang();\n        }\n\n        if (!this.langs().has(lang)) {\n            console.warn(`Incorrect language code in storage - \"${lang}\"`);\n\n            return this.lang();\n        }\n\n        this.locale.select(lang);\n\n        this.publish();\n\n        return this.lang();\n    }\n\n    private connect(): void {\n        if (!this.storage || this.unsubscribe) {\n            return;\n        }\n\n        this.unsubscribe = this.storage.watch(() => {\n            void this.refresh();\n        });\n    }\n\n    private disconnect(): void {\n        if (this.listeners.size) {\n            return;\n        }\n\n        this.revision++;\n\n        this.unsubscribe?.();\n        this.unsubscribe = undefined;\n    }\n\n    private async refresh(): Promise<void> {\n        if (!this.storage || this.pendingWrites) {\n            return;\n        }\n\n        try {\n            await this.sync();\n        } catch (error) {\n            console.error(\"[ObservableLocale] Cannot synchronize language:\", error);\n        }\n    }\n\n    private createSnapshot(): LocaleSnapshot<T> {\n        const lang = this.lang();\n        const langs = this.languages;\n        const langNames = this.languageNames;\n\n        const reader = new CustomLocale<T>(lang, this.locale.messages());\n\n        return Object.freeze({\n            lang: () => lang,\n            langs: () => langs,\n            langNames: () => langNames,\n            get: reader.get.bind(reader),\n        });\n    }\n\n    private publish(): void {\n        if (this.currentSnapshot.lang() === this.lang()) {\n            return;\n        }\n\n        this.currentSnapshot = this.createSnapshot();\n\n        for (const listener of [...this.listeners]) {\n            try {\n                listener();\n            } catch (error) {\n                console.error(\"[ObservableLocale] Language subscriber failed:\", error);\n            }\n        }\n    }\n}\n"],"mappings":"AAAA,OAAO,mBAAmB;AAC1B,OAAO,kBAAkB;AAEzB,SAAQ,qBAAoB;AAe5B,MAAO,iBAAsG;AAAA,EACzG,OAAe;AAAA,EACf,OAAe;AAAA,EAEf,OAAwB,UAAU,oBAAI,QAA+C;AAAA,EAErF,OAAc,YAAY,SAAyD;AAC/E,QAAI,OAAO,YAAY,UAAU;AAC7B,UAAI,WAAW,KAAK,QAAQ,IAAI,OAAO;AAEvC,UAAI,CAAC,UAAU;AACX,mBAAW,IAAI,iBAAiB,OAAO;AACvC,aAAK,QAAQ,IAAI,SAAS,QAAQ;AAAA,MACtC;AAEA,aAAO;AAAA,IACX;AAEA,QAAI,YAAY,OAAO;AACnB,aAAQ,KAAK,mBAAL,KAAK,iBAAmB,IAAI,iBAAiB,KAAK;AAAA,IAC9D;AAEA,WAAQ,KAAK,oBAAL,KAAK,kBAAoB,IAAI,iBAAiB;AAAA,EAC1D;AAAA,EAEiB,SAAS,IAAI,cAAiB,KAAK;AAAA,EACnC;AAAA,EACA,YAAY,oBAAI,IAAgB;AAAA,EAChC;AAAA,EACA;AAAA,EACT;AAAA,EACA,WAAW;AAAA,EACX,SAAwB,QAAQ,QAAQ;AAAA,EACxC,gBAAgB;AAAA,EAChB;AAAA,EAER,YAAY,SAAuC;AAC/C,SAAK,UAAU,YAAY,QAAQ,SAAa,WAAW,IAAI,cAAc;AAC7E,SAAK,YAAY,KAAK,MAAM;AAC5B,SAAK,gBAAgB,KAAK,UAAU;AACpC,SAAK,kBAAkB,KAAK,eAAe;AAAA,EAC/C;AAAA,EAEO,OAAiB;AACpB,WAAO,KAAK,OAAO,KAAK;AAAA,EAC5B;AAAA,EAEO,QAA+B;AAClC,WAAO,KAAK,OAAO,MAAM;AAAA,EAC7B;AAAA,EAEO,YAA2C;AAC9C,WAAO,KAAK,OAAO,UAAU;AAAA,EACjC;AAAA,EAEO,OAAqB;AACxB,WAAO,KAAK,OAAO,KAAK;AAAA,EAC5B;AAAA,EAEO,IAAgC,KAAQ,eAAiE;AAC5G,WAAO,KAAK,OAAO,IAAI,KAAK,aAAa;AAAA,EAC7C;AAAA,EAEO,MAAwC,QAAW,MAA4C;AAClG,WAAO,KAAK,OAAO,MAAM,KAAK,GAAG,IAAI;AAAA,EACzC;AAAA,EAEO,OAAsC,KAAQ,UAAkB,MAA4C;AAC/G,WAAO,KAAK,OAAO,OAAO,KAAK,OAAO,GAAG,IAAI;AAAA,EACjD;AAAA,EAEgB,WAAW,MAAyB,KAAK;AAAA,EAEzC,YAAY,CAAC,aAAuC;AAEhE,UAAM,SAAS,MAAM,SAAS;AAE9B,SAAK,UAAU,IAAI,MAAM;AAEzB,QAAI;AACA,WAAK,QAAQ;AAAA,IACjB,SAAS,OAAO;AACZ,WAAK,UAAU,OAAO,MAAM;AAC5B,YAAM;AAAA,IACV;AAEA,QAAI,KAAK,UAAU,SAAS,GAAG;AAC3B,WAAK,KAAK,QAAQ;AAAA,IACtB;AAEA,WAAO,MAAM;AACT,WAAK,UAAU,OAAO,MAAM;AAC5B,WAAK,WAAW;AAAA,IACpB;AAAA,EACJ;AAAA,EAEgB,SAAS,OAAO,SAAsC;AAClE,SAAK,OAAO,OAAO,IAAI;AAEvB,UAAM,UAAU,KAAK;AAErB,QAAI,CAAC,SAAS;AACV,WAAK,QAAQ;AACb,aAAO;AAAA,IACX;AAEA,SAAK;AAGL,SAAK;AAEL,UAAM,QAAQ,KAAK,OAAO,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC;AAEtD,SAAK,SAAS,MAAM,MAAM,MAAM,MAAS;AAEzC,SAAK,QAAQ;AAEb,QAAI,YAAY;AAEhB,QAAI;AACA,YAAM;AACN,kBAAY;AAEZ,aAAO;AAAA,IACX,UAAE;AACE,UAAI,EAAE,KAAK,kBAAkB,KAAK,WAAW;AACzC,aAAK,KAAK,QAAQ;AAAA,MACtB;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,MAAa,OAA0B;AACnC,QAAI,CAAC,KAAK,SAAS;AACf,YAAM,IAAI,MAAM,mCAAmC;AAAA,IACvD;AAEA,QAAI,KAAK,eAAe;AACpB,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,UAAM,WAAW,EAAE,KAAK;AACxB,UAAM,OAAO,MAAM,KAAK,QAAQ,IAAI;AAEpC,QAAI,aAAa,KAAK,YAAY,KAAK,eAAe;AAClD,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,QAAI,SAAS,QAAW;AACpB,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,QAAI,CAAC,KAAK,MAAM,EAAE,IAAI,IAAI,GAAG;AACzB,cAAQ,KAAK,yCAAyC,IAAI,GAAG;AAE7D,aAAO,KAAK,KAAK;AAAA,IACrB;AAEA,SAAK,OAAO,OAAO,IAAI;AAEvB,SAAK,QAAQ;AAEb,WAAO,KAAK,KAAK;AAAA,EACrB;AAAA,EAEQ,UAAgB;AACpB,QAAI,CAAC,KAAK,WAAW,KAAK,aAAa;AACnC;AAAA,IACJ;AAEA,SAAK,cAAc,KAAK,QAAQ,MAAM,MAAM;AACxC,WAAK,KAAK,QAAQ;AAAA,IACtB,CAAC;AAAA,EACL;AAAA,EAEQ,aAAmB;AAhM/B;AAiMQ,QAAI,KAAK,UAAU,MAAM;AACrB;AAAA,IACJ;AAEA,SAAK;AAEL,eAAK,gBAAL;AACA,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,MAAc,UAAyB;AACnC,QAAI,CAAC,KAAK,WAAW,KAAK,eAAe;AACrC;AAAA,IACJ;AAEA,QAAI;AACA,YAAM,KAAK,KAAK;AAAA,IACpB,SAAS,OAAO;AACZ,cAAQ,MAAM,mDAAmD,KAAK;AAAA,IAC1E;AAAA,EACJ;AAAA,EAEQ,iBAAoC;AACxC,UAAM,OAAO,KAAK,KAAK;AACvB,UAAM,QAAQ,KAAK;AACnB,UAAM,YAAY,KAAK;AAEvB,UAAM,SAAS,IAAI,aAAgB,MAAM,KAAK,OAAO,SAAS,CAAC;AAE/D,WAAO,OAAO,OAAO;AAAA,MACjB,MAAM,MAAM;AAAA,MACZ,OAAO,MAAM;AAAA,MACb,WAAW,MAAM;AAAA,MACjB,KAAK,OAAO,IAAI,KAAK,MAAM;AAAA,IAC/B,CAAC;AAAA,EACL;AAAA,EAEQ,UAAgB;AACpB,QAAI,KAAK,gBAAgB,KAAK,MAAM,KAAK,KAAK,GAAG;AAC7C;AAAA,IACJ;AAEA,SAAK,kBAAkB,KAAK,eAAe;AAE3C,eAAW,YAAY,CAAC,GAAG,KAAK,SAAS,GAAG;AACxC,UAAI;AACA,iBAAS;AAAA,MACb,SAAS,OAAO;AACZ,gBAAQ,MAAM,kDAAkD,KAAK;AAAA,MACzE;AAAA,IACJ;AAAA,EACJ;AACJ;","names":[]}

package/dist/message/adapters/react/useMessageHandler.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/message/adapters/react/useMessageHandler.ts"],"sourcesContent":["import {useCallback, useEffect, useRef} from \"react\";\nimport {MessageDictionary, MessageTargetHandler, MessageType} from \"@typing/message\";\n\nimport {Message} from \"@message/providers\";\n\nexport default function useMessageHandler<K extends MessageType<T>, T extends MessageDictionary = MessageDictionary>(\n    type: K,\n    handler: MessageTargetHandler<T, K>\n): void {\n    const messageRef = useRef<Message<T> | null>(null);\n\n    if (!messageRef.current) {\n        messageRef.current = Message.getInstance<T>();\n    }\n\n    const handlerRef = useRef(handler);\n    handlerRef.current = handler;\n\n    const stableWrapper = useCallback<MessageTargetHandler<T, K>>((data, sender) => {\n        return handlerRef.current(data, sender);\n    }, []);\n\n    useEffect(() => {\n        return messageRef.current!.watch(type, stableWrapper);\n    }, [type, stableWrapper]);\n}\n"],"mappings":"AAAA,SAAQ,aAAa,WAAW,cAAa;AAG7C,SAAQ,eAAc;AAEP,SAAR,kBACH,MACA,SACI;AACJ,QAAM,aAAa,OAA0B,IAAI;AAEjD,MAAI,CAAC,WAAW,SAAS;AACrB,eAAW,UAAU,QAAQ,YAAe;AAAA,EAChD;AAEA,QAAM,aAAa,OAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,gBAAgB,YAAwC,CAAC,MAAM,WAAW;AAC5E,WAAO,WAAW,QAAQ,MAAM,MAAM;AAAA,EAC1C,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACZ,WAAO,WAAW,QAAS,MAAM,MAAM,aAAa;AAAA,EACxD,GAAG,CAAC,MAAM,aAAa,CAAC;AAC5B;","names":[]}

package/scripts/clean-dist.js

@@ -1,7 +0,0 @@
-import {rm} from "fs/promises";
-import {dirname, join} from "path";
-import {fileURLToPath} from "url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-await rm(join(__dirname, "..", "dist"), {force: true, recursive: true});

package/scripts/copy-dts.js

@@ -1,29 +0,0 @@
-import {globby} from "globby";
-import {cp, mkdir} from "fs/promises";
-import {dirname, join, relative} from "path";
-import {fileURLToPath} from "url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const root = join(__dirname, "..");
-const distRoot = join(root, "dist");
-
-const files = await globby(
-    [
-        "src/**/*.d.ts",
-        "!src/**/tests/**/*",
-        "!src/**/__tests__/**/*",
-        "!src/**/__mocks__/**/*",
-        "!src/**/*.test.d.ts",
-        "!src/**/*.spec.d.ts",
-    ],
-    {cwd: root, dot: true}
-);
-
-for (const file of files) {
-    const rel = relative("src", file);
-    const dest = join(distRoot, rel);
-    await mkdir(dirname(dest), {recursive: true});
-    await cp(join(root, file), dest, {force: true, recursive: false});
-}
-
-console.log(`DTS Copied ${files.length} .d.ts files to dist`);

package/scripts/merge-coverage.mjs

@@ -1,12 +0,0 @@
-import {readFile} from "node:fs/promises";
-import path from "node:path";
-import coverage from "istanbul-lib-coverage";
-import report from "istanbul-lib-report";
-import reports from "istanbul-reports";
-
-const files = process.argv.slice(2);
-if (files.length < 2) throw new Error("Pass the unit and build coverage-final.json files");
-const map = coverage.createCoverageMap({});
-for (const file of files) map.merge(JSON.parse(await readFile(file, "utf8")));
-const context = report.createContext({dir: path.resolve("coverage/merged"), coverageMap: map});
-for (const format of ["json", "lcov", "text-summary"]) reports.create(format).execute(context);

package/scripts/pre-commit.mjs

@@ -1,22 +0,0 @@
-import {execFileSync} from "node:child_process";
-import path from "node:path";
-import * as prettier from "prettier";
-
-const root = path.resolve(import.meta.dirname, "..");
-const git = args => execFileSync("git", args, {cwd: root, encoding: "utf8"});
-const changed = git(["diff", "--cached", "--name-only", "--diff-filter=ACMR", "-z"]).split("\0").filter(Boolean);
-const unformatted = [];
-
-for (const file of changed) {
-    const filepath = path.join(root, file);
-    const info = await prettier.getFileInfo(filepath, {ignorePath: path.join(root, ".prettierignore")});
-    if (info.ignored || !info.inferredParser) continue;
-    // Check the staged contents; never rewrite unstaged work or silently stage it.
-    const contents = git(["show", `:${file}`]);
-    if (!(await prettier.check(contents, {...(await prettier.resolveConfig(filepath)), filepath})))
-        unformatted.push(file);
-}
-if (unformatted.length) {
-    console.error(`Format and stage these files before committing:\n${unformatted.join("\n")}`);
-    process.exit(1);
-}

package/scripts/test-inventory.mjs

@@ -1,38 +0,0 @@
-import assert from "node:assert/strict";
-import {execFile} from "node:child_process";
-import {existsSync} from "node:fs";
-import path from "node:path";
-import {promisify} from "node:util";
-
-const execute = promisify(execFile);
-const root = path.resolve(import.meta.dirname, "..");
-const jest = path.join(root, "scripts/test-run.mjs");
-const options = {cwd: root, maxBuffer: 10 * 1024 * 1024};
-const {stdout: configuration} = await execute(process.execPath, [jest, "--showConfig"], options);
-const projects = JSON.parse(configuration).configs.map(config => config.displayName.name);
-const {stdout: tracked} = await execute(
-    "git",
-    ["ls-files", "--cached", "--others", "--exclude-standard", "-z"],
-    options
-);
-const expected = new Set(
-    tracked.split("\0").filter(file => file.endsWith(".test.ts") && existsSync(path.join(root, file)))
-);
-const owners = new Map();
-
-for (const project of projects) {
-    const {stdout} = await execute(
-        process.execPath,
-        [jest, "--selectProjects", project, "--listTests", "--json", "--runInBand"],
-        options
-    );
-    const files = JSON.parse(stdout);
-    console.info(`${project}: ${files.length} files`);
-    for (const filename of files) {
-        const file = path.relative(root, filename).split(path.sep).join("/");
-        assert(!owners.has(file), `${file} belongs to both ${owners.get(file)} and ${project}`);
-        owners.set(file, project);
-    }
-}
-assert.deepEqual(new Set(owners.keys()), expected, "Every test file must belong to exactly one Jest project");
-console.info(`${expected.size} test files, each in exactly one project`);

package/scripts/test-run.mjs

@@ -1,25 +0,0 @@
-import {spawn} from "node:child_process";
-import {constants} from "node:os";
-import path from "node:path";
-
-const root = path.resolve(import.meta.dirname, "..");
-// Keep the workaround scoped to the environment where this project reproduces nodejs/node#62393.
-const flags = process.platform === "darwin" && process.arch === "arm64" ? ["--no-sparkplug"] : [];
-const child = spawn(
-    process.execPath,
-    [...flags, path.join(root, "node_modules/jest/bin/jest.js"), ...process.argv.slice(2)],
-    {stdio: "inherit"}
-);
-
-const forward = signal => child.kill(signal);
-const signals = ["SIGINT", "SIGTERM", "SIGHUP"];
-for (const signal of signals) process.on(signal, forward);
-child.once("error", error => {
-    console.error(error);
-    process.exitCode = 1;
-});
-child.once("close", (code, signal) => {
-    for (const signal of signals) process.off(signal, forward);
-    if (signal) console.error(`Jest terminated with ${signal}`);
-    process.exitCode = code ?? (signal ? 128 + constants.signals[signal] : 1);
-});