adnbn 0.12.0 → 0.13.0

package/dist/entry/content/lifecycle/types.d.ts

@@ -0,0 +1,28 @@
+import type { ContentScriptNode } from "../../../types/content/index.js";
+/** One owner drains discovery requests for a single builder generation. */
+export interface ContentScriptCycle {
+    generation: number;
+    pending: boolean;
+    promise: Promise<void>;
+}
+/** One completion callback for the event decorator paired with this renderer. */
+export interface ContentScriptMountNotifier {
+    setMountHandler(handler: () => void): void;
+}
+export interface ContentScriptRenderLifecycle extends ContentScriptMountNotifier {
+    /** The owning lifecycle handles deferred renderer failures without throwing. */
+    setErrorHandler(handler: (error: unknown) => void): void;
+}
+/** Internal composition result; only renderers supply their own completion signal. */
+export interface ContentScriptNodeAssembly {
+    node: ContentScriptNode;
+    renderer?: ContentScriptRenderLifecycle;
+}
+export interface ContentScriptRenderOptions {
+    ready?: () => Promise<void>;
+}
+/** The isolation stage supplies a node and optional readiness for its render target. */
+export interface ContentScriptIsolationAssembly {
+    node: ContentScriptNode;
+    ready?: () => Promise<void>;
+}

package/dist/entry/content/resolvers/watch.d.ts

@@ -1,5 +1,5 @@
 import type { ContentScriptWatchStrategy } from "../../../types/content/index.js";
-/** Create a debounced DOM-mutation strategy. Calling the returned strategy starts observing. */
+/** Batch DOM mutations in a fixed window. Calling the returned strategy starts observing. */
 export declare const createMutationObserverStrategy: (options?: MutationObserverInit) => ContentScriptWatchStrategy;
 /** Observe DOM mutations while waiting for the first content nodes. */
 export declare const createAwaitFirstStrategy: (options?: MutationObserverInit) => ContentScriptWatchStrategy;

package/dist/entry/content/resolvers/watch.js

@@ -1,19 +1,22 @@
-import debounce from "debounce";
-const createMutationObserverStrategy = (options) => (update) => {
-  if (!options) {
-    options = {};
-  }
-  const handle = debounce(update, 200);
-  const observer = new MutationObserver(handle);
+const createMutationObserverStrategy = (options) => (update, context) => {
+  let timer;
+  const observer = new MutationObserver((records) => {
+    if (timer !== void 0 || !records.some((record) => !context.owns(record.target))) {
+      return;
+    }
+    timer = setTimeout(() => {
+      timer = void 0;
+      void update();
+    }, 200);
+  });
   observer.observe(document.body ?? document.documentElement ?? document, {
     childList: true,
     subtree: true,
-    attributes: true,
-    characterData: true,
     ...options
   });
   return () => {
-    handle.clear();
+    clearTimeout(timer);
+    timer = void 0;
     observer.disconnect();
   };
 };
@@ -24,16 +27,28 @@ const createAwaitFirstStrategy = (options) => (update, context) => {
     ...options
   });
   let unwatch;
+  let pending;
   const clear = () => {
     unwatch && unwatch();
     unwatch = void 0;
+    pending = void 0;
   };
   if (context.nodes.size === 0) {
-    unwatch = resolver(async () => {
-      await update();
-      if (context.nodes.size > 0) {
-        clear();
+    unwatch = resolver(() => {
+      const completion = Promise.resolve(update());
+      if (completion === pending) {
+        return completion;
       }
+      pending = completion;
+      return completion.then(() => {
+        if (context.nodes.size > 0) {
+          clear();
+        }
+      }).finally(() => {
+        if (pending === completion) {
+          pending = void 0;
+        }
+      });
     }, context);
   }
   return () => {

package/dist/entry/content/resolvers/watch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/entry/content/resolvers/watch.ts"],"sourcesContent":["import debounce from \"debounce\";\n\nimport type {ContentScriptWatchStrategy} from \"@typing/content\";\n\n/** Create a debounced DOM-mutation strategy. Calling the returned strategy starts observing. */\n// prettier-ignore\nexport const createMutationObserverStrategy =\n    (options?: MutationObserverInit): ContentScriptWatchStrategy =>\n        update => {\n            if (!options) {\n                options = {};\n            }\n\n            const handle = debounce(update, 200);\n\n            const observer = new MutationObserver(handle);\n\n            observer.observe(document.body ?? document.documentElement ?? document, {\n                childList: true,\n                subtree: true,\n                attributes: true,\n                characterData: true,\n                ...options,\n            });\n\n            return () => {\n                handle.clear();\n                observer.disconnect();\n            };\n        };\n\n/** Observe DOM mutations while waiting for the first content nodes. */\n// prettier-ignore\nexport const createAwaitFirstStrategy =\n    (options?: MutationObserverInit): ContentScriptWatchStrategy =>\n        (update, context) => {\n            const resolver = createMutationObserverStrategy({\n                attributes: false,\n                characterData: false,\n                ...options,\n            });\n\n            let unwatch: { (): void } | undefined;\n\n            const clear = () => {\n                unwatch && unwatch();\n                unwatch = undefined;\n            };\n\n            if (context.nodes.size === 0) {\n                unwatch = resolver(async () => {\n                    await update();\n\n                    if (context.nodes.size > 0) {\n                        clear();\n                    }\n                }, context);\n            }\n\n            return () => {\n                clear();\n            };\n        };\n\n// prettier-ignore\nexport const withLocationTracking =\n    (strategy: ContentScriptWatchStrategy): ContentScriptWatchStrategy =>\n        (update, context) => {\n            let currentUrl = location.href;\n\n            const interval = setInterval(() => {\n                if (currentUrl !== location.href) {\n                    currentUrl = location.href;\n\n                    try {\n                        context.mount();\n                    } catch (error) {\n                        console.error(\"Content script mount on location change failed\", error);\n                    }\n                }\n            }, 300);\n\n            const unwatch = strategy(update, context);\n\n            return () => {\n                clearInterval(interval);\n                unwatch();\n            };\n        };\n"],"mappings":"AAAA,OAAO,cAAc;AAMd,MAAM,iCACT,CAAC,YACG,YAAU;AACN,MAAI,CAAC,SAAS;AACV,cAAU,CAAC;AAAA,EACf;AAEA,QAAM,SAAS,SAAS,QAAQ,GAAG;AAEnC,QAAM,WAAW,IAAI,iBAAiB,MAAM;AAE5C,WAAS,QAAQ,SAAS,QAAQ,SAAS,mBAAmB,UAAU;AAAA,IACpE,WAAW;AAAA,IACX,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,GAAG;AAAA,EACP,CAAC;AAED,SAAO,MAAM;AACT,WAAO,MAAM;AACb,aAAS,WAAW;AAAA,EACxB;AACJ;AAID,MAAM,2BACT,CAAC,YACG,CAAC,QAAQ,YAAY;AACjB,QAAM,WAAW,+BAA+B;AAAA,IAC5C,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,GAAG;AAAA,EACP,CAAC;AAED,MAAI;AAEJ,QAAM,QAAQ,MAAM;AAChB,eAAW,QAAQ;AACnB,cAAU;AAAA,EACd;AAEA,MAAI,QAAQ,MAAM,SAAS,GAAG;AAC1B,cAAU,SAAS,YAAY;AAC3B,YAAM,OAAO;AAEb,UAAI,QAAQ,MAAM,OAAO,GAAG;AACxB,cAAM;AAAA,MACV;AAAA,IACJ,GAAG,OAAO;AAAA,EACd;AAEA,SAAO,MAAM;AACT,UAAM;AAAA,EACV;AACJ;AAGD,MAAM,uBACT,CAAC,aACG,CAAC,QAAQ,YAAY;AACjB,MAAI,aAAa,SAAS;AAE1B,QAAM,WAAW,YAAY,MAAM;AAC/B,QAAI,eAAe,SAAS,MAAM;AAC9B,mBAAa,SAAS;AAEtB,UAAI;AACA,gBAAQ,MAAM;AAAA,MAClB,SAAS,OAAO;AACZ,gBAAQ,MAAM,kDAAkD,KAAK;AAAA,MACzE;AAAA,IACJ;AAAA,EACJ,GAAG,GAAG;AAEN,QAAM,UAAU,SAAS,QAAQ,OAAO;AAExC,SAAO,MAAM;AACT,kBAAc,QAAQ;AACtB,YAAQ;AAAA,EACZ;AACJ;","names":[]}
+{"version":3,"sources":["../../../../src/entry/content/resolvers/watch.ts"],"sourcesContent":["import type {ContentScriptWatchStrategy} from \"@typing/content\";\n\n/** Batch DOM mutations in a fixed window. Calling the returned strategy starts observing. */\n// prettier-ignore\nexport const createMutationObserverStrategy =\n    (options?: MutationObserverInit): ContentScriptWatchStrategy =>\n        (update, context) => {\n            let timer: ReturnType<typeof setTimeout> | undefined;\n\n            const observer = new MutationObserver(records => {\n                if (timer !== undefined || !records.some(record => !context.owns(record.target))) {\n                    return;\n                }\n\n                timer = setTimeout(() => {\n                    timer = undefined;\n                    void update();\n                }, 200);\n            });\n\n            observer.observe(document.body ?? document.documentElement ?? document, {\n                childList: true,\n                subtree: true,\n                ...options,\n            });\n\n            return () => {\n                clearTimeout(timer);\n                timer = undefined;\n                observer.disconnect();\n            };\n        };\n\n/** Observe DOM mutations while waiting for the first content nodes. */\n// prettier-ignore\nexport const createAwaitFirstStrategy =\n    (options?: MutationObserverInit): ContentScriptWatchStrategy =>\n        (update, context) => {\n            const resolver = createMutationObserverStrategy({\n                attributes: false,\n                characterData: false,\n                ...options,\n            });\n\n            let unwatch: { (): void } | undefined;\n            let pending: Promise<void> | undefined;\n\n            const clear = () => {\n                unwatch && unwatch();\n                unwatch = undefined;\n                pending = undefined;\n            };\n\n            if (context.nodes.size === 0) {\n                unwatch = resolver(() => {\n                    const completion = Promise.resolve(update());\n\n                    if (completion === pending) {\n                        return completion;\n                    }\n\n                    pending = completion;\n\n                    return completion.then(() => {\n                        if (context.nodes.size > 0) {\n                            clear();\n                        }\n                    }).finally(() => {\n                        if (pending === completion) {\n                            pending = undefined;\n                        }\n                    });\n                }, context);\n            }\n\n            return () => {\n                clear();\n            };\n        };\n\n// prettier-ignore\nexport const withLocationTracking =\n    (strategy: ContentScriptWatchStrategy): ContentScriptWatchStrategy =>\n        (update, context) => {\n            let currentUrl = location.href;\n\n            const interval = setInterval(() => {\n                if (currentUrl !== location.href) {\n                    currentUrl = location.href;\n\n                    try {\n                        context.mount();\n                    } catch (error) {\n                        console.error(\"Content script mount on location change failed\", error);\n                    }\n                }\n            }, 300);\n\n            const unwatch = strategy(update, context);\n\n            return () => {\n                clearInterval(interval);\n                unwatch();\n            };\n        };\n"],"mappings":"AAIO,MAAM,iCACT,CAAC,YACG,CAAC,QAAQ,YAAY;AACjB,MAAI;AAEJ,QAAM,WAAW,IAAI,iBAAiB,aAAW;AAC7C,QAAI,UAAU,UAAa,CAAC,QAAQ,KAAK,YAAU,CAAC,QAAQ,KAAK,OAAO,MAAM,CAAC,GAAG;AAC9E;AAAA,IACJ;AAEA,YAAQ,WAAW,MAAM;AACrB,cAAQ;AACR,WAAK,OAAO;AAAA,IAChB,GAAG,GAAG;AAAA,EACV,CAAC;AAED,WAAS,QAAQ,SAAS,QAAQ,SAAS,mBAAmB,UAAU;AAAA,IACpE,WAAW;AAAA,IACX,SAAS;AAAA,IACT,GAAG;AAAA,EACP,CAAC;AAED,SAAO,MAAM;AACT,iBAAa,KAAK;AAClB,YAAQ;AACR,aAAS,WAAW;AAAA,EACxB;AACJ;AAID,MAAM,2BACT,CAAC,YACG,CAAC,QAAQ,YAAY;AACjB,QAAM,WAAW,+BAA+B;AAAA,IAC5C,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,GAAG;AAAA,EACP,CAAC;AAED,MAAI;AACJ,MAAI;AAEJ,QAAM,QAAQ,MAAM;AAChB,eAAW,QAAQ;AACnB,cAAU;AACV,cAAU;AAAA,EACd;AAEA,MAAI,QAAQ,MAAM,SAAS,GAAG;AAC1B,cAAU,SAAS,MAAM;AACrB,YAAM,aAAa,QAAQ,QAAQ,OAAO,CAAC;AAE3C,UAAI,eAAe,SAAS;AACxB,eAAO;AAAA,MACX;AAEA,gBAAU;AAEV,aAAO,WAAW,KAAK,MAAM;AACzB,YAAI,QAAQ,MAAM,OAAO,GAAG;AACxB,gBAAM;AAAA,QACV;AAAA,MACJ,CAAC,EAAE,QAAQ,MAAM;AACb,YAAI,YAAY,YAAY;AACxB,oBAAU;AAAA,QACd;AAAA,MACJ,CAAC;AAAA,IACL,GAAG,OAAO;AAAA,EACd;AAEA,SAAO,MAAM;AACT,UAAM;AAAA,EACV;AACJ;AAGD,MAAM,uBACT,CAAC,aACG,CAAC,QAAQ,YAAY;AACjB,MAAI,aAAa,SAAS;AAE1B,QAAM,WAAW,YAAY,MAAM;AAC/B,QAAI,eAAe,SAAS,MAAM;AAC9B,mBAAa,SAAS;AAEtB,UAAI;AACA,gBAAQ,MAAM;AAAA,MAClB,SAAS,OAAO;AACZ,gBAAQ,MAAM,kDAAkD,KAAK;AAAA,MACzE;AAAA,IACJ;AAAA,EACJ,GAAG,GAAG;AAEN,QAAM,UAAU,SAAS,QAAQ,OAAO;AAExC,SAAO,MAAM;AACT,kBAAc,QAAQ;AACtB,YAAQ;AAAA,EACZ;AACJ;","names":[]}

package/dist/entry/relay/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/entry/relay/index.ts"],"sourcesContent":["import Builder from \"./Builder\";\n\nimport type {RelayUnresolvedDefinition} from \"@typing/relay\";\nimport type {TransportType} from \"@typing/transport\";\nimport type {ContentScriptIsolation} from \"@typing/content\";\n\nexport {Builder};\nexport {resolveDefinition} from \"./resolvers/definition\";\nexport type {RelayUnresolvedDefinition} from \"@typing/relay\";\n\nexport default function relay<\n    T extends TransportType,\n    Data = unknown,\n    Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`,\n>(\n    definition: RelayUnresolvedDefinition<T, Data, Isolation>,\n    contentBuilder: ConstructorParameters<typeof Builder<T, Data, NoInfer<Isolation>>>[1]\n): void {\n    new Builder(definition, contentBuilder).build().catch(error => {\n        console.error(\"Failed to build relay: \", error);\n    });\n}\n"],"mappings":"AAAA,OAAO,aAAa;AAOpB,SAAQ,yBAAwB;AAGjB,SAAR,MAKH,YACA,gBACI;AACJ,MAAI,QAAQ,YAAY,cAAc,EAAE,MAAM,EAAE,MAAM,WAAS;AAC3D,YAAQ,MAAM,2BAA2B,KAAK;AAAA,EAClD,CAAC;AACL;","names":[]}
+{"version":3,"sources":["../../../src/entry/relay/index.ts"],"sourcesContent":["import Builder from \"./Builder\";\n\nimport type {RelayUnresolvedDefinition} from \"@typing/relay\";\nimport type {TransportType} from \"@typing/transport\";\nimport type {ContentScriptIsolation} from \"@typing/content\";\n\nexport {Builder};\nexport {resolveDefinition} from \"./resolvers/definition\";\n\nexport type {RelayUnresolvedDefinition} from \"@typing/relay\";\n\nexport default function relay<\n    T extends TransportType,\n    Data = unknown,\n    Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`,\n>(\n    definition: RelayUnresolvedDefinition<T, Data, Isolation>,\n    contentBuilder: ConstructorParameters<typeof Builder<T, Data, NoInfer<Isolation>>>[1]\n): void {\n    new Builder(definition, contentBuilder).build().catch(error => {\n        console.error(\"Failed to build relay: \", error);\n    });\n}\n"],"mappings":"AAAA,OAAO,aAAa;AAOpB,SAAQ,yBAAwB;AAIjB,SAAR,MAKH,YACA,gBACI;AACJ,MAAI,QAAQ,YAAY,cAAc,EAAE,MAAM,EAAE,MAAM,WAAS;AAC3D,YAAQ,MAAM,2BAA2B,KAAK;AAAA,EAClD,CAAC;AACL;","names":[]}

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

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

package/dist/shared/locale/index.js

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

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

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

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

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

package/dist/shared/locale/messages.js

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

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

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

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

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

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

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

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

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

package/dist/types/locale.d.ts

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

package/dist/types/locale.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/locale.ts"],"sourcesContent":["import {Language} from \"@typing/language\";\n\nexport {Language};\n\nexport const RtlLanguages: ReadonlySet<Language> = new Set([Language.Arabic, Language.Persian, Language.Hebrew]);\n\nexport const LocaleNestedKeysSeparator = \".\";\n\nexport const LocaleKeysSeparator = \"_\";\n\nexport const LocaleValuesSeparator = \"|\";\n\nexport const LocaleCustomKeyForLanguage = \"locale\";\n\nexport const LocaleKeyMarker = \"@\";\n\nexport const LanguageCodes: ReadonlySet<string> = new Set(Object.values(Language));\n\n/** Native language names, independent of the selected UI language. */\nexport const LanguageNames: Readonly<Record<Language, string>> = Object.freeze({\n    [Language.Arabic]: \"العربية\",\n    [Language.Amharic]: \"አማርኛ\",\n    [Language.Bulgarian]: \"Български\",\n    [Language.Bengali]: \"বাংলা\",\n    [Language.Catalan]: \"Català\",\n    [Language.Czech]: \"Čeština\",\n    [Language.Danish]: \"Dansk\",\n    [Language.German]: \"Deutsch\",\n    [Language.Greek]: \"Ελληνικά\",\n    [Language.English]: \"English\",\n    [Language.EnglishAustralia]: \"English (Australia)\",\n    [Language.EnglishGreatBritain]: \"English (United Kingdom)\",\n    [Language.EnglishUSA]: \"English (United States)\",\n    [Language.Spanish]: \"Español\",\n    [Language.SpanishLatinAmericaAndCaribbean]: \"Español (Latinoamérica y el Caribe)\",\n    [Language.Estonian]: \"Eesti\",\n    [Language.Persian]: \"فارسی\",\n    [Language.Finnish]: \"Suomi\",\n    [Language.Filipino]: \"Filipino\",\n    [Language.French]: \"Français\",\n    [Language.Gujarati]: \"ગુજરાતી\",\n    [Language.Hebrew]: \"עברית\",\n    [Language.Hindi]: \"हिन्दी\",\n    [Language.Croatian]: \"Hrvatski\",\n    [Language.Hungarian]: \"Magyar\",\n    [Language.Indonesian]: \"Bahasa Indonesia\",\n    [Language.Italian]: \"Italiano\",\n    [Language.Japanese]: \"日本語\",\n    [Language.Kannada]: \"ಕನ್ನಡ\",\n    [Language.Korean]: \"한국어\",\n    [Language.Lithuanian]: \"Lietuvių\",\n    [Language.Latvian]: \"Latviešu\",\n    [Language.Malayalam]: \"മലയാളം\",\n    [Language.Marathi]: \"मराठी\",\n    [Language.Malay]: \"Bahasa Melayu\",\n    [Language.Dutch]: \"Nederlands\",\n    [Language.Norwegian]: \"Norsk\",\n    [Language.Polish]: \"Polski\",\n    [Language.PortugueseBrazil]: \"Português (Brasil)\",\n    [Language.PortuguesePortugal]: \"Português (Portugal)\",\n    [Language.Romanian]: \"Română\",\n    [Language.Russian]: \"Русский\",\n    [Language.Slovak]: \"Slovenčina\",\n    [Language.Slovenian]: \"Slovenščina\",\n    [Language.Serbian]: \"Српски\",\n    [Language.Swedish]: \"Svenska\",\n    [Language.Swahili]: \"Kiswahili\",\n    [Language.Tamil]: \"தமிழ்\",\n    [Language.Telugu]: \"తెలుగు\",\n    [Language.Thai]: \"ไทย\",\n    [Language.Turkish]: \"Türkçe\",\n    [Language.Ukrainian]: \"Українська\",\n    [Language.Vietnamese]: \"Tiếng Việt\",\n    [Language.ChineseChina]: \"中文（简体）\",\n    [Language.ChineseTaiwan]: \"中文（繁體）\",\n});\n\nexport const LocaleFileExtensions: ReadonlySet<string> = new Set([\"yaml\", \"yml\", \"json\"]);\n\nexport enum LocaleDir {\n    RightToLeft = \"rtl\",\n    LeftToRight = \"ltr\",\n}\n\nexport type LocaleValue = string | number | Array<string | number>;\n\nexport type LocaleData = {\n    [key: string]: LocaleValue | LocaleData;\n};\n\nexport type LocaleItems = Map<string, string>;\n\nexport type LocaleKeys = ReadonlySet<string>;\n\nexport type LocaleMessages = {\n    [key: string]: {\n        message: string;\n    };\n};\n\nexport interface LocaleBuilder {\n    lang(): Language;\n\n    merge(data: LocaleData): this;\n\n    build(): LocaleMessages;\n\n    get(): LocaleItems;\n\n    keys(): LocaleKeys;\n\n    structure(): LocaleStructure;\n\n    isValid(): boolean;\n\n    validate(): this;\n}\n\nexport type LocaleBuilders = Map<Language, LocaleBuilder>;\n\n/** Completed messages keyed by language and browser-compatible message key. */\nexport type LocaleCatalogue = Partial<Record<Language, Record<string, string>>>;\n\nexport interface LocaleValidator {\n    isValid(locale: LocaleBuilder): boolean;\n\n    validate(locale: LocaleBuilder): this;\n}\n\nexport interface LocaleContractValidator {\n    isValid(builders: LocaleBuilders): boolean;\n\n    validate(builders: LocaleBuilders): this;\n}\n\nexport interface LocaleFutures {\n    plural: boolean;\n    substitutions: readonly string[];\n}\n\nexport interface LocaleStructure {\n    [key: string]: LocaleFutures;\n}\n\n/**\n * Empty because translation keys and their plural/substitution contracts belong to the consuming application.\n * Generated `.adnbn/locale.d.ts` declarations populate it by augmenting `adnbn/locale`.\n */\nexport interface LocaleRegistry {}\n\nexport type LocaleNonPluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: false} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocalePluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: true} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocaleSubstitutionValue = string | number;\n\nexport type LocaleSubstitutionKeys<T, K extends keyof T> = T[K] extends {substitutions: readonly (infer U)[]}\n    ? U & string\n    : never;\n\nexport type LocaleSubstitutionsFor<T, K extends keyof T> = [LocaleSubstitutionKeys<T, K>] extends [never]\n    ? never\n    : Record<LocaleSubstitutionKeys<T, K>, LocaleSubstitutionValue>;\n\nexport type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof T\n    ? [substitutions?: Record<string, LocaleSubstitutionValue>]\n    : [LocaleSubstitutionKeys<T, K>] extends [never]\n      ? []\n      : [substitutions: LocaleSubstitutionsFor<T, K>];\n\nexport interface LocaleProvider<S> {\n    /** Currently selected language code. */\n    lang(): Language;\n\n    /** Available language codes. */\n    langs(): ReadonlySet<Language>;\n\n    /** Native names keyed by the available language codes. */\n    langNames(): ReadonlyMap<Language, string>;\n\n    keys(): ReadonlySet<keyof S>;\n\n    // non-plural keys\n    trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    // plural keys\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n}\n\nexport interface LocaleDynamicProvider<S> extends LocaleProvider<S> {\n    change(lang: Language): Promise<Language>;\n}\n\n/** Read-only message access for one selected language. */\nexport interface LocaleSnapshot<S> {\n    readonly lang: () => Language;\n    readonly langs: () => ReadonlySet<Language>;\n    readonly langNames: () => ReadonlyMap<Language, string>;\n    readonly get: <K extends keyof S & string>(key: K) => string;\n}\n\n/** Persists one language selection independently of the application's translation catalogue. */\nexport interface LocaleStorageDriver {\n    /** No saved selection leaves the provider's current language unchanged. */\n    get(): Promise<Language | undefined>;\n\n    set(lang: Language): Promise<void>;\n\n    /** Observes valid selections, including own writes; does not emit an initial value or deletions. */\n    watch(handler: (lang: Language) => void): () => void;\n}\n"],"mappings":"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","names":["LocaleDir"]}
+{"version":3,"sources":["../../src/types/locale.ts"],"sourcesContent":["import {Language} from \"@typing/language\";\n\nexport {Language};\n\nexport const RtlLanguages: ReadonlySet<Language> = new Set([Language.Arabic, Language.Persian, Language.Hebrew]);\n\nexport const LocaleNestedKeysSeparator = \".\";\n\nexport const LocaleKeysSeparator = \"_\";\n\nexport const LocaleValuesSeparator = \"|\";\n\nexport const LocaleCustomKeyForLanguage = \"locale\";\n\nexport const LocaleKeyMarker = \"@\";\n\nexport const LanguageCodes: ReadonlySet<string> = new Set(Object.values(Language));\n\n/** Native language names, independent of the selected UI language. */\nexport const LanguageNames: Readonly<Record<Language, string>> = Object.freeze({\n    [Language.Arabic]: \"العربية\",\n    [Language.Amharic]: \"አማርኛ\",\n    [Language.Bulgarian]: \"Български\",\n    [Language.Bengali]: \"বাংলা\",\n    [Language.Catalan]: \"Català\",\n    [Language.Czech]: \"Čeština\",\n    [Language.Danish]: \"Dansk\",\n    [Language.German]: \"Deutsch\",\n    [Language.Greek]: \"Ελληνικά\",\n    [Language.English]: \"English\",\n    [Language.EnglishAustralia]: \"English (Australia)\",\n    [Language.EnglishGreatBritain]: \"English (United Kingdom)\",\n    [Language.EnglishUSA]: \"English (United States)\",\n    [Language.Spanish]: \"Español\",\n    [Language.SpanishLatinAmericaAndCaribbean]: \"Español (Latinoamérica y el Caribe)\",\n    [Language.Estonian]: \"Eesti\",\n    [Language.Persian]: \"فارسی\",\n    [Language.Finnish]: \"Suomi\",\n    [Language.Filipino]: \"Filipino\",\n    [Language.French]: \"Français\",\n    [Language.Gujarati]: \"ગુજરાતી\",\n    [Language.Hebrew]: \"עברית\",\n    [Language.Hindi]: \"हिन्दी\",\n    [Language.Croatian]: \"Hrvatski\",\n    [Language.Hungarian]: \"Magyar\",\n    [Language.Indonesian]: \"Bahasa Indonesia\",\n    [Language.Italian]: \"Italiano\",\n    [Language.Japanese]: \"日本語\",\n    [Language.Kannada]: \"ಕನ್ನಡ\",\n    [Language.Korean]: \"한국어\",\n    [Language.Lithuanian]: \"Lietuvių\",\n    [Language.Latvian]: \"Latviešu\",\n    [Language.Malayalam]: \"മലയാളം\",\n    [Language.Marathi]: \"मराठी\",\n    [Language.Malay]: \"Bahasa Melayu\",\n    [Language.Dutch]: \"Nederlands\",\n    [Language.Norwegian]: \"Norsk\",\n    [Language.Polish]: \"Polski\",\n    [Language.PortugueseBrazil]: \"Português (Brasil)\",\n    [Language.PortuguesePortugal]: \"Português (Portugal)\",\n    [Language.Romanian]: \"Română\",\n    [Language.Russian]: \"Русский\",\n    [Language.Slovak]: \"Slovenčina\",\n    [Language.Slovenian]: \"Slovenščina\",\n    [Language.Serbian]: \"Српски\",\n    [Language.Swedish]: \"Svenska\",\n    [Language.Swahili]: \"Kiswahili\",\n    [Language.Tamil]: \"தமிழ்\",\n    [Language.Telugu]: \"తెలుగు\",\n    [Language.Thai]: \"ไทย\",\n    [Language.Turkish]: \"Türkçe\",\n    [Language.Ukrainian]: \"Українська\",\n    [Language.Vietnamese]: \"Tiếng Việt\",\n    [Language.ChineseChina]: \"中文（简体）\",\n    [Language.ChineseTaiwan]: \"中文（繁體）\",\n});\n\nexport const LocaleFileExtensions: ReadonlySet<string> = new Set([\"yaml\", \"yml\", \"json\"]);\n\nexport enum LocaleDir {\n    RightToLeft = \"rtl\",\n    LeftToRight = \"ltr\",\n}\n\nexport type LocaleValue = string | number | Array<string | number>;\n\nexport type LocaleData = {\n    [key: string]: LocaleValue | LocaleData;\n};\n\nexport type LocaleItems = Map<string, string>;\n\nexport type LocaleKeys = ReadonlySet<string>;\n\nexport type LocaleMessages = {\n    [key: string]: {\n        message: string;\n        placeholders?: Record<string, {content: string}>;\n    };\n};\n\nexport interface LocaleBuilder {\n    lang(): Language;\n\n    merge(data: LocaleData): this;\n\n    build(): LocaleMessages;\n\n    get(): LocaleItems;\n\n    keys(): LocaleKeys;\n\n    structure(): LocaleStructure;\n\n    isValid(): boolean;\n\n    validate(): this;\n}\n\nexport type LocaleBuilders = Map<Language, LocaleBuilder>;\n\n/** Completed messages keyed by language and browser-compatible message key. */\nexport type LocaleCatalogue = Partial<Record<Language, Record<string, string>>>;\n\nexport interface LocaleValidator {\n    isValid(locale: LocaleBuilder): boolean;\n\n    validate(locale: LocaleBuilder): this;\n}\n\nexport interface LocaleContractValidator {\n    isValid(builders: LocaleBuilders): boolean;\n\n    validate(builders: LocaleBuilders): this;\n}\n\nexport interface LocaleFutures {\n    plural: boolean;\n    substitutions: readonly string[];\n}\n\nexport interface LocaleStructure {\n    [key: string]: LocaleFutures;\n}\n\n/**\n * Empty because translation keys and their plural/substitution contracts belong to the consuming application.\n * Generated `.adnbn/locale.d.ts` declarations populate it by augmenting `adnbn/locale`.\n */\nexport interface LocaleRegistry {}\n\nexport type LocaleNonPluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: false} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocalePluralKeys<T> = {\n    [K in keyof T]: T[K] extends {plural: true} ? K : never;\n}[keyof T] &\n    string;\n\nexport type LocaleSubstitutionValue = string | number;\n\nexport type LocaleSubstitutionKeys<T, K extends keyof T> = T[K] extends {substitutions: readonly (infer U)[]}\n    ? U & string\n    : never;\n\nexport type LocaleSubstitutionsFor<T, K extends keyof T> = [LocaleSubstitutionKeys<T, K>] extends [never]\n    ? never\n    : Record<LocaleSubstitutionKeys<T, K>, LocaleSubstitutionValue>;\n\nexport type LocaleSubstitutionArgs<T, K extends keyof T> = string extends keyof T\n    ? [substitutions?: Record<string, LocaleSubstitutionValue>]\n    : [LocaleSubstitutionKeys<T, K>] extends [never]\n      ? []\n      : [substitutions: LocaleSubstitutionsFor<T, K>];\n\nexport interface LocaleProvider<S> {\n    /** Currently selected language code. */\n    lang(): Language;\n\n    /** Available language codes. */\n    langs(): ReadonlySet<Language>;\n\n    /** Native names keyed by the available language codes. */\n    langNames(): ReadonlyMap<Language, string>;\n\n    keys(): ReadonlySet<keyof S>;\n\n    // non-plural keys\n    trans<K extends LocaleNonPluralKeys<S>>(key: K, ...args: LocaleSubstitutionArgs<S, K>): string;\n\n    // plural keys\n    choice<K extends LocalePluralKeys<S>>(key: K, count: number, ...args: LocaleSubstitutionArgs<S, K>): string;\n}\n\nexport interface LocaleDynamicProvider<S> extends LocaleProvider<S> {\n    change(lang: Language): Promise<Language>;\n}\n\n/** Read-only message access for one selected language. */\nexport interface LocaleSnapshot<S> {\n    readonly lang: () => Language;\n    readonly langs: () => ReadonlySet<Language>;\n    readonly langNames: () => ReadonlyMap<Language, string>;\n    readonly get: <K extends keyof S & string>(key: K) => string;\n}\n\n/** Persists one language selection independently of the application's translation catalogue. */\nexport interface LocaleStorageDriver {\n    /** No saved selection leaves the provider's current language unchanged. */\n    get(): Promise<Language | undefined>;\n\n    set(lang: Language): Promise<void>;\n\n    /** Observes valid selections, including own writes; does not emit an initial value or deletions. */\n    watch(handler: (lang: Language) => void): () => void;\n}\n"],"mappings":"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","names":["LocaleDir"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adnbn",
   "type": "module",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Addon Bone - Cross-browser web extension framework with shared code base",
   "homepage": "https://addonbone.com",
   "author": "Anjey Tsibylskij (https://github.com/atldays)",
@@ -152,12 +152,10 @@
     "@rspack/core": "^1.7.5",
     "@rspack/lite-tapable": "^1.1.0",
     "@svgr/webpack": "^8.1.0",
-    "await-lock": "^3.0.0",
     "c12": "^3.3.2",
     "cac": "^6.7.14",
     "consola": "^3.4.2",
     "css-loader": "^7.1.2",
-    "debounce": "^2.2.0",
     "file-loader": "^6.2.0",
     "get-value": "^4.0.1",
     "html-rspack-tags-plugin": "^0.0.3",

package/types/client.d.ts

@@ -310,17 +310,17 @@ declare module "*?asis" {
     export default src;
 }
 
-declare module "*?isolation" {
+declare module "*?unisolated" {
     const classes: Readonly<Record<string, string>>;
     export default classes;
 }
 
-declare module "*?isolation&asis" {
+declare module "*?unisolated&asis" {
     const src: string;
     export default src;
 }
 
-declare module "*?asis&isolation" {
+declare module "*?asis&unisolated" {
     const src: string;
     export default src;
 }

package/dist/cli/plugins/style/types.d.ts

@@ -1,5 +0,0 @@
-import type { RuleSetCondition } from "@rspack/core";
-export interface StylePluginOptions {
-    /** Issuer layers where ?isolation selects a separate CSS destination. Omit to use ordinary CSS rules. */
-    isolationIssuerLayer?: RuleSetCondition;
-}

package/dist/entry/content/adapters/react/resolvers/definition.d.ts

@@ -1,2 +0,0 @@
-import type { ContentScriptDefinition } from "../../../../../types/content/index.js";
-export declare const resolveDefinition: (module: object) => ContentScriptDefinition;

package/dist/entry/content/adapters/react/resolvers/definition.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../src/entry/content/adapters/react/resolvers/definition.ts"],"sourcesContent":["import {isValidElement} from \"react\";\nimport {mergeDefinition} from \"../../../resolvers/definition\";\n\nimport type {ContentScriptDefinition} from \"@typing/content\";\n\nexport const resolveDefinition = (module: object): ContentScriptDefinition => {\n    return mergeDefinition(\n        module,\n        value =>\n            typeof value === \"function\" ||\n            isValidElement(value) ||\n            typeof value === \"number\" ||\n            (typeof value === \"string\" && value.length > 0) ||\n            value instanceof Element\n    );\n};\n"],"mappings":"AAAA,SAAQ,sBAAqB;AAC7B,SAAQ,uBAAsB;AAIvB,MAAM,oBAAoB,CAAC,WAA4C;AAC1E,SAAO;AAAA,IACH;AAAA,IACA,WACI,OAAO,UAAU,cACjB,eAAe,KAAK,KACpB,OAAO,UAAU,YAChB,OAAO,UAAU,YAAY,MAAM,SAAS,KAC7C,iBAAiB;AAAA,EACzB;AACJ;","names":[]}

package/dist/entry/content/adapters/react/resolvers/render.d.ts

@@ -1,2 +0,0 @@
-import type { ContentScriptRenderHandler, ContentScriptRenderValue } from "../../../../../types/content/index.js";
-export declare const createRenderResolver: <Data = unknown>(render?: ContentScriptRenderValue<Data> | ContentScriptRenderHandler<Data>) => ContentScriptRenderHandler<Data>;

package/dist/entry/content/adapters/react/resolvers/render.js

@@ -1,9 +0,0 @@
-import { createElement, isValidElement } from "react";
-const createRenderResolver = (render) => (props) => {
-  const value = typeof render === "function" ? createElement(render, props) : render;
-  return isValidElement(value) ? value : void 0;
-};
-export {
-  createRenderResolver
-};
-//# sourceMappingURL=render.js.map

package/dist/entry/content/adapters/react/resolvers/render.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../src/entry/content/adapters/react/resolvers/render.ts"],"sourcesContent":["import {createElement, isValidElement} from \"react\";\n\nimport type {\n    ContentScriptRenderHandler,\n    ContentScriptRenderValue,\n    ContentScriptRenderReactComponent,\n} from \"@typing/content\";\n\nexport const createRenderResolver =\n    <Data = unknown>(\n        render?: ContentScriptRenderValue<Data> | ContentScriptRenderHandler<Data>\n    ): ContentScriptRenderHandler<Data> =>\n    props => {\n        // Functions in React entrypoints are components; React owns their invocation and hooks.\n        const value =\n            typeof render === \"function\"\n                ? createElement(render as ContentScriptRenderReactComponent<Data>, props)\n                : render;\n\n        return isValidElement(value) ? value : undefined;\n    };\n"],"mappings":"AAAA,SAAQ,eAAe,sBAAqB;AAQrC,MAAM,uBACT,CACI,WAEJ,WAAS;AAEL,QAAM,QACF,OAAO,WAAW,aACZ,cAAc,QAAmD,KAAK,IACtE;AAEV,SAAO,eAAe,KAAK,IAAI,QAAQ;AAC3C;","names":[]}

package/dist/entry/content/adapters/vanilla/resolvers/definition.d.ts

@@ -1,2 +0,0 @@
-import type { ContentScriptDefinition } from "../../../../../types/content/index.js";
-export declare const resolveDefinition: (module: object) => ContentScriptDefinition;

package/dist/entry/content/adapters/vanilla/resolvers/definition.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../src/entry/content/adapters/vanilla/resolvers/definition.ts"],"sourcesContent":["import {mergeDefinition} from \"../../../resolvers/definition\";\nimport {isValidRenderValue} from \"./render\";\n\nimport type {ContentScriptDefinition} from \"@typing/content\";\n\nexport const resolveDefinition = (module: object): ContentScriptDefinition => {\n    return mergeDefinition(module, value => typeof value === \"function\" || isValidRenderValue(value));\n};\n"],"mappings":"AAAA,SAAQ,uBAAsB;AAC9B,SAAQ,0BAAyB;AAI1B,MAAM,oBAAoB,CAAC,WAA4C;AAC1E,SAAO,gBAAgB,QAAQ,WAAS,OAAO,UAAU,cAAc,mBAAmB,KAAK,CAAC;AACpG;","names":[]}

package/dist/entry/content/adapters/vanilla/resolvers/render.d.ts

@@ -1,3 +0,0 @@
-import type { ContentScriptRenderHandler, ContentScriptRenderValue } from "../../../../../types/content/index.js";
-export declare const isValidRenderValue: (value: unknown) => value is string | number | Element;
-export declare const createRenderResolver: <Data = unknown>(render?: ContentScriptRenderValue<Data> | ContentScriptRenderHandler<Data>) => ContentScriptRenderHandler<Data>;

package/dist/entry/content/adapters/vanilla/resolvers/render.js

@@ -1,15 +0,0 @@
-const isValidRenderValue = (value) => {
-  return typeof value === "string" && value.length > 0 || typeof value === "number" || value instanceof Element;
-};
-const createRenderResolver = (render) => (props) => {
-  const resolvedRender = typeof render === "function" ? render(props) : render;
-  if (!isValidRenderValue(resolvedRender)) {
-    return;
-  }
-  return resolvedRender;
-};
-export {
-  createRenderResolver,
-  isValidRenderValue
-};
-//# sourceMappingURL=render.js.map

package/dist/entry/content/adapters/vanilla/resolvers/render.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../src/entry/content/adapters/vanilla/resolvers/render.ts"],"sourcesContent":["import type {ContentScriptRenderHandler, ContentScriptRenderValue} from \"@typing/content\";\n\nexport const isValidRenderValue = (value: unknown): value is string | number | Element => {\n    return (typeof value === \"string\" && value.length > 0) || typeof value === \"number\" || value instanceof Element;\n};\n\n// prettier-ignore\nexport const createRenderResolver =\n    <Data = unknown>(render?: ContentScriptRenderValue<Data> | ContentScriptRenderHandler<Data>): ContentScriptRenderHandler<Data> =>\n        props => {\n            const resolvedRender = typeof render === \"function\" ? render(props) : render;\n\n            if (!isValidRenderValue(resolvedRender)) {\n                return;\n            }\n\n            return resolvedRender;\n        };\n"],"mappings":"AAEO,MAAM,qBAAqB,CAAC,UAAuD;AACtF,SAAQ,OAAO,UAAU,YAAY,MAAM,SAAS,KAAM,OAAO,UAAU,YAAY,iBAAiB;AAC5G;AAGO,MAAM,uBACT,CAAiB,WACb,WAAS;AACL,QAAM,iBAAiB,OAAO,WAAW,aAAa,OAAO,KAAK,IAAI;AAEtE,MAAI,CAAC,mBAAmB,cAAc,GAAG;AACrC;AAAA,EACJ;AAEA,SAAO;AACX;","names":[]}