adnbn 0.10.0 → 0.12.0

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

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

package/dist/types/{content.js → content/common.js}

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

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

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

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

@@ -0,0 +1,61 @@
+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 { ContentScriptRenderHandler, ContentScriptRenderValue } from "./render.js";
+import type { ContentScriptTarget, ContentScriptTargetCreator } from "./target.js";
+export interface ContentScriptDefinitionBase<Data = unknown> extends Partial<ContentScriptOptions> {
+    marker?: ContentScriptMarkerType | ContentScriptMarkerGetter;
+    anchor?: ContentScriptAnchor | ContentScriptAnchorGetter;
+    mount?: ContentScriptMountFunction;
+    container?: ContentScriptContainerTag | ContentScriptContainerOptions | ContentScriptContainerFactory<NoInfer<Data>>;
+    prepare?: ContentScriptPrepareHandler<Data>;
+    watch?: true | ContentScriptWatchStrategy;
+    main?: ContentScriptMainFunction;
+}
+export type ContentScriptRenderDefinition<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = {
+    isolation?: Isolation | {
+        type: Isolation;
+    };
+    boundary?: ContentScriptBoundaryHandler<NoInfer<Data>, NoInfer<Isolation>>;
+    target?: ContentScriptTarget<NoInfer<Data>, NoInfer<Isolation>>;
+    render?: ContentScriptRenderValue<NoInfer<Data>, NoInfer<Isolation>> | ContentScriptRenderHandler<NoInfer<Data>, NoInfer<Isolation>>;
+} & ({
+    isolation?: NoInfer<Isolation> | Extract<ContentScriptIsolationOptions, {
+        type: `${NoInfer<Isolation>}`;
+        page?: never;
+        src?: never;
+    }>;
+    boundary?: never;
+    target?: never;
+} | {
+    isolation: Extract<NoInfer<Isolation>, "shadow"> | Extract<ContentScriptIsolationShadowOptions, {
+        type: `${NoInfer<Isolation>}`;
+    }>;
+} | {
+    isolation: Extract<NoInfer<Isolation>, "iframe"> | Extract<ContentScriptIsolationFrameOptions & ContentScriptFrameRenderOptions, {
+        type: `${NoInfer<Isolation>}`;
+    }>;
+} | {
+    isolation: Extract<ContentScriptIsolationFrameOptions & (ContentScriptFramePageOptions | ContentScriptFrameSourceOptions), {
+        type: `${NoInfer<Isolation>}`;
+    }>;
+    render?: never;
+    target?: never;
+}) & ("none" extends `${NoInfer<Isolation>}` ? unknown : {
+    isolation: unknown;
+});
+export type ContentScriptDefinition<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = ContentScriptDefinitionBase<Data> & ContentScriptRenderDefinition<Data, Isolation>;
+export interface ContentScriptResolvedDefinition<Data = unknown> extends Omit<ContentScriptDefinitionBase<Data>, "anchor" | "marker" | "mount" | "container" | "watch"> {
+    isolation: ContentScriptIsolationOptions;
+    boundary?: ContentScriptBoundaryHandler<Data>;
+    marker: ContentScriptMarkerResolver;
+    anchor: ContentScriptAnchorGetter;
+    mount: ContentScriptMountFunction;
+    render?: true | ContentScriptRenderHandler<Data>;
+    container: ContentScriptContainerCreator<Data>;
+    target: ContentScriptTargetCreator<Data>;
+    watch: ContentScriptWatchStrategy;
+}
+export type ContentScriptAppendDefinition<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = Omit<ContentScriptDefinitionBase<Data>, "mount"> & ContentScriptRenderDefinition<Data, Isolation> & {
+    append?: ContentScriptAppend;
+};

package/dist/types/content/definition.js

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

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

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

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

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

package/dist/types/content/index.js

@@ -0,0 +1,2 @@
+export * from "./common.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/types/content/index.ts"],"sourcesContent":["export * from \"./common\";\n\nexport type * from \"./definition\";\nexport type * from \"./render\";\n\nexport type * from \"./adapters\";\nexport type * from \"./prepare\";\nexport type * from \"./boundary\";\nexport type * from \"./target\";\n"],"mappings":"AAAA,cAAc;","names":[]}

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

@@ -0,0 +1,9 @@
+import type { Awaiter } from "../helpers.js";
+import type { ContentScriptEntrypointOptions } from "./common.js";
+/** Per-anchor input available before a container or render target exists. */
+export interface ContentScriptPrepareProps extends ContentScriptEntrypointOptions {
+    anchor: Element;
+}
+/** False tracks the anchor without creating UI. Other results become render props.data. */
+export type ContentScriptPrepareResult<Data> = Data | false;
+export type ContentScriptPrepareHandler<Data = unknown> = (props: ContentScriptPrepareProps) => Awaiter<ContentScriptPrepareResult<Data>>;

package/dist/types/content/prepare.js

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

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

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

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

@@ -0,0 +1,6 @@
+import type { ContentScriptIsolation, ContentScriptProps } from "./common.js";
+import type { ContentScriptVanillaRenderValue, ContentScriptReactRenderValue } from "./adapters/index.js";
+/** All supported render values; the entrypoint's filename selects the runtime adapter. */
+export type ContentScriptRenderValue<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = ContentScriptVanillaRenderValue | ContentScriptReactRenderValue<Data, Isolation>;
+/** Synchronous rendering into prepared DOM. Await data and decide whether to render in prepare. */
+export type ContentScriptRenderHandler<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = (props: ContentScriptProps<Data, Isolation>) => ContentScriptRenderValue<Data, Isolation>;

package/dist/types/content/render.js

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

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

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

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

@@ -0,0 +1,13 @@
+import type { ContentScriptContainerOptions, ContentScriptContainerTag, ContentScriptIsolation } from "./common.js";
+import type { ContentScriptBoundaryProps } from "./boundary.js";
+export type ContentScriptTargetTag = ContentScriptContainerTag;
+export type ContentScriptTargetOptions = ContentScriptContainerOptions;
+/** Available after isolation exists, before the target is created or rendering starts. */
+export interface ContentScriptTargetProps<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> extends ContentScriptBoundaryProps<Data, Isolation> {
+    /** Create elements in this document, including for an iframe's child document. */
+    document: Document;
+}
+export type ContentScriptTargetFactory<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = (props: ContentScriptTargetProps<Data, Isolation>) => Element | ContentScriptTargetTag | ContentScriptTargetOptions;
+export type ContentScriptTarget<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = ContentScriptTargetTag | ContentScriptTargetOptions | ContentScriptTargetFactory<Data, Isolation>;
+/** Synchronous DOM creation; asynchronous work belongs in prepare. */
+export type ContentScriptTargetCreator<Data = unknown> = (props: ContentScriptTargetProps<Data>) => Element;

package/dist/types/content/target.js

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

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

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

package/dist/types/entrypoint.d.ts

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

package/dist/types/entrypoint.js

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

package/dist/types/entrypoint.js.map

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

package/dist/types/icon.d.ts

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

package/dist/types/icon.js.map

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

package/dist/types/language.d.ts

@@ -0,0 +1,57 @@
+export declare enum Language {
+    Arabic = "ar",
+    Amharic = "am",
+    Bulgarian = "bg",
+    Bengali = "bn",
+    Catalan = "ca",
+    Czech = "cs",
+    Danish = "da",
+    German = "de",
+    Greek = "el",
+    English = "en",
+    EnglishAustralia = "en_AU",
+    EnglishGreatBritain = "en_GB",
+    EnglishUSA = "en_US",
+    Spanish = "es",
+    SpanishLatinAmericaAndCaribbean = "es_419",
+    Estonian = "et",
+    Persian = "fa",
+    Finnish = "fi",
+    Filipino = "fil",
+    French = "fr",
+    Gujarati = "gu",
+    Hebrew = "he",
+    Hindi = "hi",
+    Croatian = "hr",
+    Hungarian = "hu",
+    Indonesian = "id",
+    Italian = "it",
+    Japanese = "ja",
+    Kannada = "kn",
+    Korean = "ko",
+    Lithuanian = "lt",
+    Latvian = "lv",
+    Malayalam = "ml",
+    Marathi = "mr",
+    Malay = "ms",
+    Dutch = "nl",
+    Norwegian = "no",
+    Polish = "pl",
+    PortugueseBrazil = "pt_BR",
+    PortuguesePortugal = "pt_PT",
+    Romanian = "ro",
+    Russian = "ru",
+    Slovak = "sk",
+    Slovenian = "sl",
+    Serbian = "sr",
+    Swedish = "sv",
+    Swahili = "sw",
+    Tamil = "ta",
+    Telugu = "te",
+    Thai = "th",
+    Turkish = "tr",
+    Ukrainian = "uk",
+    Vietnamese = "vi",
+    ChineseChina = "zh_CN",
+    ChineseTaiwan = "zh_TW"
+}