adnbn 0.11.0 → 0.13.0

package/dist/shared/content/isolation.js

@@ -1,34 +1,40 @@
 import {
   ContentScriptIsolation,
   ContentScriptShadowMode
-} from "./../../types/content.js";
+} from "./../../types/content/index.js";
 const isContentScriptFrameNavigation = (isolation) => !!isolation && typeof isolation === "object" && "type" in isolation && isolation.type === ContentScriptIsolation.Iframe && ("page" in isolation && isolation.page !== void 0 || "src" in isolation && isolation.src !== void 0);
 const resolveContentScriptIsolation = (value, hasRender = false) => {
   const options = value === void 0 ? { type: ContentScriptIsolation.None } : typeof value === "string" ? { type: value } : value;
   if (!options || typeof options !== "object" || Array.isArray(options)) {
     throw new Error("isolation must be none, shadow, iframe, or an options object with type");
   }
-  const { type, mode, page, src, width, height } = options;
+  const { type, mode, page, src } = options;
   if (!Object.values(ContentScriptIsolation).includes(type)) {
     throw new Error(
       "isolation.type must be a statically known ContentScriptIsolation value: none, shadow or iframe"
     );
   }
-  const keys = type === ContentScriptIsolation.Shadow ? ["type", "mode"] : type === ContentScriptIsolation.Iframe ? ["type", "page", "src", "width", "height"] : ["type"];
+  const keys = type === ContentScriptIsolation.Shadow ? ["type", "mode"] : type === ContentScriptIsolation.Iframe ? ["type", "page", "src"] : ["type"];
   for (const key of Object.keys(options)) {
-    if (!keys.includes(key)) throw new Error(`isolation.${key} is not supported for isolation type "${type}"`);
+    if (!keys.includes(key)) {
+      throw new Error(`isolation.${key} is not supported for isolation type "${type}"`);
+    }
+  }
+  if (type === ContentScriptIsolation.None) {
+    return { type };
   }
-  if (type === ContentScriptIsolation.None) return { type };
   if (type === ContentScriptIsolation.Shadow) {
     if (mode !== void 0 && !Object.values(ContentScriptShadowMode).includes(mode)) {
       throw new Error('isolation.mode must be "open" or "closed"');
     }
     return { type, mode: mode ?? ContentScriptShadowMode.Open };
   }
-  if (page !== void 0 && src !== void 0)
+  if (page !== void 0 && src !== void 0) {
     throw new Error("isolation.page and isolation.src are mutually exclusive");
-  if (page !== void 0 && (typeof page !== "string" || !page.trim()))
+  }
+  if (page !== void 0 && (typeof page !== "string" || !page.trim())) {
     throw new Error("isolation.page must be a statically known page alias");
+  }
   if (src !== void 0) {
     if (typeof src !== "string" || !/^(https?|chrome-extension|moz-extension):\/\//.test(src)) {
       throw new Error("isolation.src must be an absolute HTTP(S) or extension URL");
@@ -44,21 +50,8 @@ const resolveContentScriptIsolation = (value, hasRender = false) => {
       "isolation.page/isolation.src cannot be combined with render; the embedded page owns its UI and resources"
     );
   }
-  for (const [name, size] of [
-    ["width", width],
-    ["height", height]
-  ]) {
-    if (size !== void 0 && !(typeof size === "number" && Number.isFinite(size) && size >= 0 || typeof size === "string" && size.trim())) {
-      throw new Error(`isolation.${name} must be pixels or a CSS size`);
-    }
-  }
-  if (typeof height === "string" && height.trim().toLowerCase() === "auto") {
-    throw new Error('isolation.height: "auto" is not supported yet; specify an explicit height');
-  }
   return {
     type,
-    width: width ?? "100%",
-    height: height ?? 150,
     ...page === void 0 ? {} : { page },
     ...src === void 0 ? {} : { src }
   };

package/dist/shared/content/isolation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/shared/content/isolation.ts"],"sourcesContent":["import {\n    ContentScriptIsolation,\n    ContentScriptShadowMode,\n    type ContentScriptIsolationOptions,\n    type ContentScriptIsolationFrameOptions,\n    type ContentScriptFramePageOptions,\n    type ContentScriptFrameSourceOptions,\n} from \"@typing/content\";\n\nexport const isContentScriptFrameNavigation = (\n    isolation: unknown\n): isolation is ContentScriptIsolationFrameOptions &\n    (ContentScriptFramePageOptions | ContentScriptFrameSourceOptions) =>\n    !!isolation &&\n    typeof isolation === \"object\" &&\n    \"type\" in isolation &&\n    isolation.type === ContentScriptIsolation.Iframe &&\n    ((\"page\" in isolation && isolation.page !== undefined) || (\"src\" in isolation && isolation.src !== undefined));\n\n/** Pure normalization and structural validation, shared by CLI and runtime. */\nexport const resolveContentScriptIsolation = (value: unknown, hasRender = false): ContentScriptIsolationOptions => {\n    const options =\n        value === undefined ? {type: ContentScriptIsolation.None} : typeof value === \"string\" ? {type: value} : value;\n    if (!options || typeof options !== \"object\" || Array.isArray(options)) {\n        throw new Error(\"isolation must be none, shadow, iframe, or an options object with type\");\n    }\n    const {type, mode, page, src, width, height} = options as Record<string, unknown>;\n    if (!Object.values(ContentScriptIsolation).includes(type as ContentScriptIsolation)) {\n        throw new Error(\n            \"isolation.type must be a statically known ContentScriptIsolation value: none, shadow or iframe\"\n        );\n    }\n    const keys =\n        type === ContentScriptIsolation.Shadow\n            ? [\"type\", \"mode\"]\n            : type === ContentScriptIsolation.Iframe\n              ? [\"type\", \"page\", \"src\", \"width\", \"height\"]\n              : [\"type\"];\n    for (const key of Object.keys(options)) {\n        if (!keys.includes(key)) throw new Error(`isolation.${key} is not supported for isolation type \"${type}\"`);\n    }\n    if (type === ContentScriptIsolation.None) return {type};\n    if (type === ContentScriptIsolation.Shadow) {\n        if (mode !== undefined && !Object.values(ContentScriptShadowMode).includes(mode as ContentScriptShadowMode)) {\n            throw new Error('isolation.mode must be \"open\" or \"closed\"');\n        }\n        return {type, mode: (mode as ContentScriptShadowMode | undefined) ?? ContentScriptShadowMode.Open};\n    }\n    if (page !== undefined && src !== undefined)\n        throw new Error(\"isolation.page and isolation.src are mutually exclusive\");\n    if (page !== undefined && (typeof page !== \"string\" || !page.trim()))\n        throw new Error(\"isolation.page must be a statically known page alias\");\n    if (src !== undefined) {\n        if (typeof src !== \"string\" || !/^(https?|chrome-extension|moz-extension):\\/\\//.test(src)) {\n            throw new Error(\"isolation.src must be an absolute HTTP(S) or extension URL\");\n        }\n        try {\n            new URL(src);\n        } catch {\n            throw new Error(\"isolation.src must be a valid absolute URL\");\n        }\n    }\n    if ((page !== undefined || src !== undefined) && hasRender) {\n        throw new Error(\n            \"isolation.page/isolation.src cannot be combined with render; the embedded page owns its UI and resources\"\n        );\n    }\n    for (const [name, size] of [\n        [\"width\", width],\n        [\"height\", height],\n    ] as const) {\n        if (\n            size !== undefined &&\n            !(\n                (typeof size === \"number\" && Number.isFinite(size) && size >= 0) ||\n                (typeof size === \"string\" && size.trim())\n            )\n        ) {\n            throw new Error(`isolation.${name} must be pixels or a CSS size`);\n        }\n    }\n    if (typeof height === \"string\" && height.trim().toLowerCase() === \"auto\") {\n        throw new Error('isolation.height: \"auto\" is not supported yet; specify an explicit height');\n    }\n    return {\n        type,\n        width: width ?? \"100%\",\n        height: height ?? 150,\n        ...(page === undefined ? {} : {page}),\n        ...(src === undefined ? {} : {src}),\n    } as ContentScriptIsolationFrameOptions;\n};\n"],"mappings":"AAAA;AAAA,EACI;AAAA,EACA;AAAA,OAKG;AAEA,MAAM,iCAAiC,CAC1C,cAGA,CAAC,CAAC,aACF,OAAO,cAAc,YACrB,UAAU,aACV,UAAU,SAAS,uBAAuB,WACxC,UAAU,aAAa,UAAU,SAAS,UAAe,SAAS,aAAa,UAAU,QAAQ;AAGhG,MAAM,gCAAgC,CAAC,OAAgB,YAAY,UAAyC;AAC/G,QAAM,UACF,UAAU,SAAY,EAAC,MAAM,uBAAuB,KAAI,IAAI,OAAO,UAAU,WAAW,EAAC,MAAM,MAAK,IAAI;AAC5G,MAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG;AACnE,UAAM,IAAI,MAAM,wEAAwE;AAAA,EAC5F;AACA,QAAM,EAAC,MAAM,MAAM,MAAM,KAAK,OAAO,OAAM,IAAI;AAC/C,MAAI,CAAC,OAAO,OAAO,sBAAsB,EAAE,SAAS,IAA8B,GAAG;AACjF,UAAM,IAAI;AAAA,MACN;AAAA,IACJ;AAAA,EACJ;AACA,QAAM,OACF,SAAS,uBAAuB,SAC1B,CAAC,QAAQ,MAAM,IACf,SAAS,uBAAuB,SAC9B,CAAC,QAAQ,QAAQ,OAAO,SAAS,QAAQ,IACzC,CAAC,MAAM;AACnB,aAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACpC,QAAI,CAAC,KAAK,SAAS,GAAG,EAAG,OAAM,IAAI,MAAM,aAAa,GAAG,yCAAyC,IAAI,GAAG;AAAA,EAC7G;AACA,MAAI,SAAS,uBAAuB,KAAM,QAAO,EAAC,KAAI;AACtD,MAAI,SAAS,uBAAuB,QAAQ;AACxC,QAAI,SAAS,UAAa,CAAC,OAAO,OAAO,uBAAuB,EAAE,SAAS,IAA+B,GAAG;AACzG,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC/D;AACA,WAAO,EAAC,MAAM,MAAO,QAAgD,wBAAwB,KAAI;AAAA,EACrG;AACA,MAAI,SAAS,UAAa,QAAQ;AAC9B,UAAM,IAAI,MAAM,yDAAyD;AAC7E,MAAI,SAAS,WAAc,OAAO,SAAS,YAAY,CAAC,KAAK,KAAK;AAC9D,UAAM,IAAI,MAAM,sDAAsD;AAC1E,MAAI,QAAQ,QAAW;AACnB,QAAI,OAAO,QAAQ,YAAY,CAAC,gDAAgD,KAAK,GAAG,GAAG;AACvF,YAAM,IAAI,MAAM,4DAA4D;AAAA,IAChF;AACA,QAAI;AACA,UAAI,IAAI,GAAG;AAAA,IACf,QAAQ;AACJ,YAAM,IAAI,MAAM,4CAA4C;AAAA,IAChE;AAAA,EACJ;AACA,OAAK,SAAS,UAAa,QAAQ,WAAc,WAAW;AACxD,UAAM,IAAI;AAAA,MACN;AAAA,IACJ;AAAA,EACJ;AACA,aAAW,CAAC,MAAM,IAAI,KAAK;AAAA,IACvB,CAAC,SAAS,KAAK;AAAA,IACf,CAAC,UAAU,MAAM;AAAA,EACrB,GAAY;AACR,QACI,SAAS,UACT,EACK,OAAO,SAAS,YAAY,OAAO,SAAS,IAAI,KAAK,QAAQ,KAC7D,OAAO,SAAS,YAAY,KAAK,KAAK,IAE7C;AACE,YAAM,IAAI,MAAM,aAAa,IAAI,+BAA+B;AAAA,IACpE;AAAA,EACJ;AACA,MAAI,OAAO,WAAW,YAAY,OAAO,KAAK,EAAE,YAAY,MAAM,QAAQ;AACtE,UAAM,IAAI,MAAM,2EAA2E;AAAA,EAC/F;AACA,SAAO;AAAA,IACH;AAAA,IACA,OAAO,SAAS;AAAA,IAChB,QAAQ,UAAU;AAAA,IAClB,GAAI,SAAS,SAAY,CAAC,IAAI,EAAC,KAAI;AAAA,IACnC,GAAI,QAAQ,SAAY,CAAC,IAAI,EAAC,IAAG;AAAA,EACrC;AACJ;","names":[]}
+{"version":3,"sources":["../../../src/shared/content/isolation.ts"],"sourcesContent":["import {\n    ContentScriptIsolation,\n    ContentScriptShadowMode,\n    type ContentScriptIsolationOptions,\n    type ContentScriptIsolationFrameOptions,\n    type ContentScriptFramePageOptions,\n    type ContentScriptFrameSourceOptions,\n} from \"@typing/content\";\n\nexport const isContentScriptFrameNavigation = (\n    isolation: unknown\n): isolation is ContentScriptIsolationFrameOptions &\n    (ContentScriptFramePageOptions | ContentScriptFrameSourceOptions) =>\n    !!isolation &&\n    typeof isolation === \"object\" &&\n    \"type\" in isolation &&\n    isolation.type === ContentScriptIsolation.Iframe &&\n    ((\"page\" in isolation && isolation.page !== undefined) || (\"src\" in isolation && isolation.src !== undefined));\n\n/** Pure normalization and structural validation, shared by CLI and runtime. */\nexport const resolveContentScriptIsolation = (value: unknown, hasRender = false): ContentScriptIsolationOptions => {\n    const options =\n        value === undefined ? {type: ContentScriptIsolation.None} : typeof value === \"string\" ? {type: value} : value;\n\n    if (!options || typeof options !== \"object\" || Array.isArray(options)) {\n        throw new Error(\"isolation must be none, shadow, iframe, or an options object with type\");\n    }\n\n    const {type, mode, page, src} = options as Record<string, unknown>;\n\n    if (!Object.values(ContentScriptIsolation).includes(type as ContentScriptIsolation)) {\n        throw new Error(\n            \"isolation.type must be a statically known ContentScriptIsolation value: none, shadow or iframe\"\n        );\n    }\n\n    const keys =\n        type === ContentScriptIsolation.Shadow\n            ? [\"type\", \"mode\"]\n            : type === ContentScriptIsolation.Iframe\n              ? [\"type\", \"page\", \"src\"]\n              : [\"type\"];\n\n    for (const key of Object.keys(options)) {\n        if (!keys.includes(key)) {\n            throw new Error(`isolation.${key} is not supported for isolation type \"${type}\"`);\n        }\n    }\n\n    if (type === ContentScriptIsolation.None) {\n        return {type};\n    }\n\n    if (type === ContentScriptIsolation.Shadow) {\n        if (mode !== undefined && !Object.values(ContentScriptShadowMode).includes(mode as ContentScriptShadowMode)) {\n            throw new Error('isolation.mode must be \"open\" or \"closed\"');\n        }\n\n        return {type, mode: (mode as ContentScriptShadowMode | undefined) ?? ContentScriptShadowMode.Open};\n    }\n\n    if (page !== undefined && src !== undefined) {\n        throw new Error(\"isolation.page and isolation.src are mutually exclusive\");\n    }\n\n    if (page !== undefined && (typeof page !== \"string\" || !page.trim())) {\n        throw new Error(\"isolation.page must be a statically known page alias\");\n    }\n\n    if (src !== undefined) {\n        if (typeof src !== \"string\" || !/^(https?|chrome-extension|moz-extension):\\/\\//.test(src)) {\n            throw new Error(\"isolation.src must be an absolute HTTP(S) or extension URL\");\n        }\n\n        try {\n            new URL(src);\n        } catch {\n            throw new Error(\"isolation.src must be a valid absolute URL\");\n        }\n    }\n\n    if ((page !== undefined || src !== undefined) && hasRender) {\n        throw new Error(\n            \"isolation.page/isolation.src cannot be combined with render; the embedded page owns its UI and resources\"\n        );\n    }\n\n    return {\n        type,\n        ...(page === undefined ? {} : {page}),\n        ...(src === undefined ? {} : {src}),\n    } as ContentScriptIsolationFrameOptions;\n};\n"],"mappings":"AAAA;AAAA,EACI;AAAA,EACA;AAAA,OAKG;AAEA,MAAM,iCAAiC,CAC1C,cAGA,CAAC,CAAC,aACF,OAAO,cAAc,YACrB,UAAU,aACV,UAAU,SAAS,uBAAuB,WACxC,UAAU,aAAa,UAAU,SAAS,UAAe,SAAS,aAAa,UAAU,QAAQ;AAGhG,MAAM,gCAAgC,CAAC,OAAgB,YAAY,UAAyC;AAC/G,QAAM,UACF,UAAU,SAAY,EAAC,MAAM,uBAAuB,KAAI,IAAI,OAAO,UAAU,WAAW,EAAC,MAAM,MAAK,IAAI;AAE5G,MAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG;AACnE,UAAM,IAAI,MAAM,wEAAwE;AAAA,EAC5F;AAEA,QAAM,EAAC,MAAM,MAAM,MAAM,IAAG,IAAI;AAEhC,MAAI,CAAC,OAAO,OAAO,sBAAsB,EAAE,SAAS,IAA8B,GAAG;AACjF,UAAM,IAAI;AAAA,MACN;AAAA,IACJ;AAAA,EACJ;AAEA,QAAM,OACF,SAAS,uBAAuB,SAC1B,CAAC,QAAQ,MAAM,IACf,SAAS,uBAAuB,SAC9B,CAAC,QAAQ,QAAQ,KAAK,IACtB,CAAC,MAAM;AAEnB,aAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACpC,QAAI,CAAC,KAAK,SAAS,GAAG,GAAG;AACrB,YAAM,IAAI,MAAM,aAAa,GAAG,yCAAyC,IAAI,GAAG;AAAA,IACpF;AAAA,EACJ;AAEA,MAAI,SAAS,uBAAuB,MAAM;AACtC,WAAO,EAAC,KAAI;AAAA,EAChB;AAEA,MAAI,SAAS,uBAAuB,QAAQ;AACxC,QAAI,SAAS,UAAa,CAAC,OAAO,OAAO,uBAAuB,EAAE,SAAS,IAA+B,GAAG;AACzG,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC/D;AAEA,WAAO,EAAC,MAAM,MAAO,QAAgD,wBAAwB,KAAI;AAAA,EACrG;AAEA,MAAI,SAAS,UAAa,QAAQ,QAAW;AACzC,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC7E;AAEA,MAAI,SAAS,WAAc,OAAO,SAAS,YAAY,CAAC,KAAK,KAAK,IAAI;AAClE,UAAM,IAAI,MAAM,sDAAsD;AAAA,EAC1E;AAEA,MAAI,QAAQ,QAAW;AACnB,QAAI,OAAO,QAAQ,YAAY,CAAC,gDAAgD,KAAK,GAAG,GAAG;AACvF,YAAM,IAAI,MAAM,4DAA4D;AAAA,IAChF;AAEA,QAAI;AACA,UAAI,IAAI,GAAG;AAAA,IACf,QAAQ;AACJ,YAAM,IAAI,MAAM,4CAA4C;AAAA,IAChE;AAAA,EACJ;AAEA,OAAK,SAAS,UAAa,QAAQ,WAAc,WAAW;AACxD,UAAM,IAAI;AAAA,MACN;AAAA,IACJ;AAAA,EACJ;AAEA,SAAO;AAAA,IACH;AAAA,IACA,GAAI,SAAS,SAAY,CAAC,IAAI,EAAC,KAAI;AAAA,IACnC,GAAI,QAAQ,SAAY,CAAC,IAAI,EAAC,IAAG;AAAA,EACrC;AACJ;","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/adapters/index.d.ts

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

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

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

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

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

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

@@ -0,0 +1,4 @@
+import type { ReactNode } from "react";
+import type { ContentScriptIsolation, ContentScriptProps } from "../common.js";
+export type ContentScriptRenderReactComponent<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = (props: ContentScriptProps<Data, Isolation>) => Exclude<ReactNode, Promise<unknown>>;
+export type ContentScriptReactRenderValue<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = Exclude<ReactNode, Promise<unknown>> | ContentScriptRenderReactComponent<Data, Isolation>;

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,17 @@
+import type { ContentScriptContainerProps, ContentScriptIsolation } from "./common.js";
+export interface ContentScriptBoundaryMap {
+    none: undefined;
+    shadow: ShadowRoot;
+    iframe: HTMLIFrameElement;
+}
+/** The browser node implementing isolation, distinct from the container and render target. */
+export type ContentScriptBoundary<Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = ContentScriptBoundaryMap[Isolation];
+/** Available when isolation is created, before its target or child document is ready. */
+export interface ContentScriptBoundaryProps<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> extends ContentScriptContainerProps<Data> {
+    container: Element;
+    boundary: Exclude<ContentScriptBoundary<Isolation>, undefined>;
+}
+/** Releases user subscriptions before the boundary is removed. */
+export type ContentScriptBoundaryCleanup = () => void;
+/** Synchronous setup, once per boundary; return cleanup for subscriptions or observers. */
+export type ContentScriptBoundaryHandler<Data = unknown, Isolation extends `${ContentScriptIsolation}` = `${ContentScriptIsolation}`> = (props: ContentScriptBoundaryProps<Data, Isolation>) => void | ContentScriptBoundaryCleanup;

package/dist/types/content/boundary.js

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

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

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

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

@@ -1,8 +1,9 @@
-import type { PageAlias } from "./page.js";
-import type { FC, ReactNode } from "react";
-import { Optional } from "utility-types";
-import { EntrypointBuilder, EntrypointOptions } from "./entrypoint.js";
-import { Awaiter, PickNonFunctionProperties } from "./helpers.js";
+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";
@@ -52,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>;
 }
@@ -127,20 +130,15 @@ export interface ContentScriptShadowOptions {
      */
     mode?: ContentScriptShadowMode | `${ContentScriptShadowMode}`;
 }
-export interface ContentScriptFrameOptions {
-    width?: number | string;
-    /** Defaults to 150px. Automatic height is not supported yet. */
-    height?: number | string;
-}
-export interface ContentScriptFrameRenderOptions extends ContentScriptFrameOptions {
+export interface ContentScriptFrameRenderOptions {
     page?: never;
     src?: never;
 }
-export interface ContentScriptFramePageOptions extends ContentScriptFrameOptions {
+export interface ContentScriptFramePageOptions {
     page: PageAlias;
     src?: never;
 }
-export interface ContentScriptFrameSourceOptions extends ContentScriptFrameOptions {
+export interface ContentScriptFrameSourceOptions {
     src: string;
     page?: never;
 }
@@ -150,15 +148,11 @@ export interface ContentScriptIsolationNoneOptions {
     mode?: never;
     page?: never;
     src?: never;
-    width?: never;
-    height?: never;
 }
 export interface ContentScriptIsolationShadowOptions extends ContentScriptShadowOptions {
     type: ContentScriptIsolation.Shadow | "shadow";
     page?: never;
     src?: never;
-    width?: never;
-    height?: never;
 }
 export type ContentScriptIsolationFrameOptions = ContentScriptFrame & {
     type: ContentScriptIsolation.Iframe | "iframe";
@@ -176,8 +170,16 @@ 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>;
@@ -200,18 +202,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 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;
@@ -227,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.
      *
@@ -248,36 +253,10 @@ export interface ContentScriptNode extends ContentScriptMount {
     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 ContentScriptDefinitionBase extends Partial<ContentScriptOptions> {
-    marker?: ContentScriptMarkerType | ContentScriptMarkerGetter;
-    anchor?: ContentScriptAnchor | ContentScriptAnchorGetter;
-    mount?: ContentScriptMountFunction;
-    container?: ContentScriptContainerTag | ContentScriptContainerOptions | ContentScriptContainerFactory;
-    watch?: true | ContentScriptWatchStrategy;
-    main?: ContentScriptMainFunction;
-}
-export type ContentScriptDefinition = ContentScriptDefinitionBase & ({
-    isolation?: ContentScriptIsolation | `${ContentScriptIsolation}` | ContentScriptIsolationNoneOptions | ContentScriptIsolationShadowOptions | (ContentScriptIsolationFrameOptions & ContentScriptFrameRenderOptions);
-    render?: ContentScriptRenderValue | ContentScriptRenderHandler;
-} | {
-    isolation: ContentScriptIsolationFrameOptions & (ContentScriptFramePageOptions | ContentScriptFrameSourceOptions);
-    render?: never;
-});
-export interface ContentScriptResolvedDefinition extends Omit<ContentScriptDefinitionBase, "anchor" | "marker" | "mount" | "container" | "watch"> {
-    isolation: ContentScriptIsolationOptions;
-    marker: ContentScriptMarkerResolver;
-    anchor: ContentScriptAnchorGetter;
-    mount: ContentScriptMountFunction;
-    render?: ContentScriptRenderHandler;
-    container: ContentScriptContainerCreator;
-    watch: ContentScriptWatchStrategy;
-}
-type ContentScriptAppendVariant<T> = T extends unknown ? Omit<T, "mount"> & {
-    append?: ContentScriptAppend;
-} : never;
-export type ContentScriptAppendDefinition = ContentScriptAppendVariant<ContentScriptDefinition>;
 export interface ContentScriptBuilder extends EntrypointBuilder {
     getContext(): ContentScriptContext;
 }

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

@@ -58,4 +58,4 @@ export {
   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    /** 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

@@ -0,0 +1,66 @@
+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>;
+    /**
+     * 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;
+}
+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/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 {