@defold-typescript/types 0.55.0 → 0.56.0

package/dist/cli-runtime.js

@@ -1963,6 +1963,15 @@ function weldStrandedListMarkers(text) {
   return out.join(`
 `).trim();
 }
+function stripMarkup(html) {
+  let text = html;
+  let previous;
+  do {
+    previous = text;
+    text = text.replace(MARKUP_TAG, "");
+  } while (text !== previous);
+  return text;
+}
 function preToMarkdown(inner) {
   const lines = htmlToCodeText(inner).split(`
 `);
@@ -1999,8 +2008,8 @@ ${LIST_INDENT.repeat(Math.max(0, listDepth - 1))}- `;
   }).replace(/<br\s*\/?>/gi, `
 `).replace(/<\/p>/gi, `
 
-`).replace(/<[^>]+>/g, "");
-  text = decodeEntities(text);
+`);
+  text = decodeEntities(stripMarkup(text));
   text = text.replace(/[ \t]+/g, " ").replace(/ *\n */g, `
 `).replace(/\n{3,}/g, `
 
@@ -2012,9 +2021,9 @@ ${LIST_INDENT.repeat(Math.max(0, listDepth - 1))}- `;
   return text.split("*/").join("*\\/");
 }
 function htmlToCodeText(html) {
-  let text = html.replace(/<br\s*\/?>/gi, `
-`).replace(/<[^>]+>/g, "");
-  text = decodeEntities(text);
+  const stripped = stripMarkup(html.replace(/<br\s*\/?>/gi, `
+`));
+  const text = decodeEntities(stripped);
   const lines = text.split(`
 `).map((line) => line.replace(/[ \t]+$/g, ""));
   while (lines.length > 0 && lines[0] === "")
@@ -2191,7 +2200,7 @@ function renderDocComment(parts) {
   }
   return [...lines.map((line) => line.replaceAll("*/", "*\\/")), " */"];
 }
-var NAMED_ENTITIES, LIST_INDENT = "", STRANDED_MARKER, LIST_ITEM, MISREAD_MARKDOWN_LINE, MANGLED_FENCE, FENCE_OPENER;
+var NAMED_ENTITIES, LIST_INDENT = "", STRANDED_MARKER, LIST_ITEM, MARKUP_TAG, MISREAD_MARKDOWN_LINE, MANGLED_FENCE, FENCE_OPENER;
 var init_doc_comment = __esm(() => {
   NAMED_ENTITIES = {
     amp: "&",
@@ -2220,6 +2229,12 @@ var init_doc_comment = __esm(() => {
   };
   STRANDED_MARKER = /^(*)-$/;
   LIST_ITEM = /^*- /;
+  MARKUP_TAG = new RegExp([
+    "</?(?:a|b|blockquote|br|code|dd|div|dl|dt|em|h[1-6]|hr|i|iframe|img|kbd|li|lia|ol|p|pre|s|script|small|span|strong|style|sub|sup|super|table|tbody|td|tfoot|th|thead|tr|u|ul)\\s*/?>",
+    "</?(?:script|style|iframe)\\b[^<>]*>",
+    `</?[a-z][^<>=]*=(?:[^<>"']|"[^"]*"|'[^']*')*>`,
+    "</?[a-z][^<>=]*=[^<>]*>"
+  ].join("|"), "gi");
   MISREAD_MARKDOWN_LINE = /^\s*`[^`]+`/;
   MANGLED_FENCE = /<code>([A-Za-z0-9_+-]+)\n([\s\S]*?)<\/code>/g;
   FENCE_OPENER = /^```([A-Za-z0-9_+-]+)$/;

package/dist/library-runtime.js

@@ -55,6 +55,15 @@ function weldStrandedListMarkers(text) {
   return out.join(`
 `).trim();
 }
+function stripMarkup(html) {
+  let text = html;
+  let previous;
+  do {
+    previous = text;
+    text = text.replace(MARKUP_TAG, "");
+  } while (text !== previous);
+  return text;
+}
 function preToMarkdown(inner) {
   const lines = htmlToCodeText(inner).split(`
 `);
@@ -91,8 +100,8 @@ ${LIST_INDENT.repeat(Math.max(0, listDepth - 1))}- `;
   }).replace(/<br\s*\/?>/gi, `
 `).replace(/<\/p>/gi, `
 
-`).replace(/<[^>]+>/g, "");
-  text = decodeEntities(text);
+`);
+  text = decodeEntities(stripMarkup(text));
   text = text.replace(/[ \t]+/g, " ").replace(/ *\n */g, `
 `).replace(/\n{3,}/g, `
 
@@ -104,9 +113,9 @@ ${LIST_INDENT.repeat(Math.max(0, listDepth - 1))}- `;
   return text.split("*/").join("*\\/");
 }
 function htmlToCodeText(html) {
-  let text = html.replace(/<br\s*\/?>/gi, `
-`).replace(/<[^>]+>/g, "");
-  text = decodeEntities(text);
+  const stripped = stripMarkup(html.replace(/<br\s*\/?>/gi, `
+`));
+  const text = decodeEntities(stripped);
   const lines = text.split(`
 `).map((line) => line.replace(/[ \t]+$/g, ""));
   while (lines.length > 0 && lines[0] === "")
@@ -283,7 +292,7 @@ function renderDocComment(parts) {
   }
   return [...lines.map((line) => line.replaceAll("*/", "*\\/")), " */"];
 }
-var NAMED_ENTITIES, LIST_INDENT = "", STRANDED_MARKER, LIST_ITEM, MISREAD_MARKDOWN_LINE, MANGLED_FENCE, FENCE_OPENER;
+var NAMED_ENTITIES, LIST_INDENT = "", STRANDED_MARKER, LIST_ITEM, MARKUP_TAG, MISREAD_MARKDOWN_LINE, MANGLED_FENCE, FENCE_OPENER;
 var init_doc_comment = __esm(() => {
   NAMED_ENTITIES = {
     amp: "&",
@@ -312,6 +321,12 @@ var init_doc_comment = __esm(() => {
   };
   STRANDED_MARKER = /^(*)-$/;
   LIST_ITEM = /^*- /;
+  MARKUP_TAG = new RegExp([
+    "</?(?:a|b|blockquote|br|code|dd|div|dl|dt|em|h[1-6]|hr|i|iframe|img|kbd|li|lia|ol|p|pre|s|script|small|span|strong|style|sub|sup|super|table|tbody|td|tfoot|th|thead|tr|u|ul)\\s*/?>",
+    "</?(?:script|style|iframe)\\b[^<>]*>",
+    `</?[a-z][^<>=]*=(?:[^<>"']|"[^"]*"|'[^']*')*>`,
+    "</?[a-z][^<>=]*=[^<>]*>"
+  ].join("|"), "gi");
   MISREAD_MARKDOWN_LINE = /^\s*`[^`]+`/;
   MANGLED_FENCE = /<code>([A-Za-z0-9_+-]+)\n([\s\S]*?)<\/code>/g;
   FENCE_OPENER = /^```([A-Za-z0-9_+-]+)$/;

package/examples/translations.json

@@ -795,8 +795,8 @@
   ],
   "gui.play_particlefx": [
     {
-      "sourceHash": "19a26b6e14ad0997",
-      "ts": "// How to play a particle fx when a gui node is created.\n// The callback receives the gui node, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nexport default defineGuiScript({\n  init(self) {\n    gui.play_particlefx(gui.get_node(\"particlefx\"), (self, node, emitter, state) => {\n      if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n        // exhaust is done spawning particles...\n      }\n    });\n  },\n});"
+      "sourceHash": "3a4e5cb8e98bf1a0",
+      "ts": "// How to play a particle fx when a gui node is created.\n// The callback receives the gui node, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.\nexport default defineGuiScript({\n  init(self) {\n    gui.play_particlefx(gui.get_node(\"particlefx\"), (self, node, emitter, state) => {\n      if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n        // exhaust is done spawning particles...\n      }\n    });\n  },\n});"
     }
   ],
   "gui.reset_material": [
@@ -1107,8 +1107,8 @@
   ],
   "particlefx.play": [
     {
-      "sourceHash": "01a21997b47ac4fc",
-      "ts": "// How to play a particle fx when a game object is created.\n// The callback receives the hash of the path to the particlefx, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.\nexport default defineScript({\n  init(self) {\n    particlefx.play(\"#particlefx\", (self, id, emitter, state) => {\n      if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n        // exhaust is done spawning particles...\n      }\n    });\n  },\n});"
+      "sourceHash": "ad5d0aba2677b291",
+      "ts": "// How to play a particle fx when a game object is created.\n// The callback receives the hash of the path to the particlefx, the hash of the id\n// of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.\nexport default defineScript({\n  init(self) {\n    particlefx.play(\"#particlefx\", (self, id, emitter, state) => {\n      if (emitter === hash(\"exhaust\") && state === particlefx.EMITTER_STATE_POSTSPAWN) {\n        // exhaust is done spawning particles...\n      }\n    });\n  },\n});"
     }
   ],
   "particlefx.reset_constant": [

package/generated/gui.d.ts

@@ -1355,7 +1355,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a gui node is created.
      * // The callback receives the gui node, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineGuiScript({
      *   init(self) {
      *     gui.play_particlefx(gui.get_node("particlefx"), (self, node, emitter, state) => {

package/generated/particlefx.d.ts

@@ -45,7 +45,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a game object is created.
      * // The callback receives the hash of the path to the particlefx, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineScript({
      *   init(self) {
      *     particlefx.play("#particlefx", (self, id, emitter, state) => {

package/generated/versions/defold-1.12.4/gui.d.ts

@@ -1324,7 +1324,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a gui node is created.
      * // The callback receives the gui node, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineGuiScript({
      *   init(self) {
      *     gui.play_particlefx(gui.get_node("particlefx"), (self, node, emitter, state) => {

package/generated/versions/defold-1.12.4/model.d.ts

@@ -53,7 +53,7 @@ declare global {
      * AABB information return as a table with `min` and `max` fields, where `min` and `max` has type `vmath.vector3`.
      *
      * @param url - the model
-     * @returns A table containing info about all AABB in the format
+     * @returns A table containing info about all AABB in the format <hash(mesh_id), aabb_info>
      * @example
      * ```ts
      * model.get_mesh_aabb("#model"); // => { hash("Sword") = { min = vmath.vector3(-0.5, -0.5, 0), max = vmath.vector3(0.5, 0.5, 0) }, hash("Shield") = { min = vmath.vector3(-0.5, -0.5, -0.5), max = vmath.vector3(0.5, 0.5, 0.5) } }

package/generated/versions/defold-1.12.4/particlefx.d.ts

@@ -49,7 +49,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a game object is created.
      * // The callback receives the hash of the path to the particlefx, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineScript({
      *   init(self) {
      *     particlefx.play("#particlefx", (self, id, emitter, state) => {

package/generated/versions/defold-1.12.4/resource.d.ts

@@ -102,10 +102,10 @@ declare global {
      * number the height of the animation
      *
      * - `frame_start`
-     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `frame_end`
-     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `playback`
      * constant optional playback mode of the animation, the default value is go.PLAYBACK_ONCE_FORWARD
@@ -1096,10 +1096,10 @@ declare global {
      * number the height of the animation
      *
      * - `frame_start`
-     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `frame_end`
-     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `playback`
      * constant optional playback mode of the animation, the default value is go.PLAYBACK_ONCE_FORWARD

package/generated/versions/defold-1.13.0/gui.d.ts

@@ -1322,7 +1322,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a gui node is created.
      * // The callback receives the gui node, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineGuiScript({
      *   init(self) {
      *     gui.play_particlefx(gui.get_node("particlefx"), (self, node, emitter, state) => {

package/generated/versions/defold-1.13.0/model.d.ts

@@ -72,7 +72,7 @@ declare global {
      * AABB information return as a table with `min` and `max` fields, where `min` and `max` has type `vmath.vector3`.
      *
      * @param url - the model
-     * @returns A table containing info about all AABB in the format
+     * @returns A table containing info about all AABB in the format <hash(mesh_id), aabb_info>
      * @example
      * ```ts
      * model.get_mesh_aabb("#model"); // => { hash("Sword") = { min = vmath.vector3(-0.5, -0.5, 0), max = vmath.vector3(0.5, 0.5, 0) }, hash("Shield") = { min = vmath.vector3(-0.5, -0.5, -0.5), max = vmath.vector3(0.5, 0.5, 0.5) } }

package/generated/versions/defold-1.13.0/particlefx.d.ts

@@ -49,7 +49,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a game object is created.
      * // The callback receives the hash of the path to the particlefx, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineScript({
      *   init(self) {
      *     particlefx.play("#particlefx", (self, id, emitter, state) => {

package/generated/versions/defold-1.13.0/resource.d.ts

@@ -102,10 +102,10 @@ declare global {
      * number the height of the animation
      *
      * - `frame_start`
-     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `frame_end`
-     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `playback`
      * constant optional playback mode of the animation, the default value is go.PLAYBACK_ONCE_FORWARD
@@ -1100,10 +1100,10 @@ declare global {
      * number the height of the animation
      *
      * - `frame_start`
-     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `frame_end`
-     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `playback`
      * constant optional playback mode of the animation, the default value is go.PLAYBACK_ONCE_FORWARD

package/generated/versions/defold-1.13.1/gui.d.ts

@@ -1322,7 +1322,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a gui node is created.
      * // The callback receives the gui node, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineGuiScript({
      *   init(self) {
      *     gui.play_particlefx(gui.get_node("particlefx"), (self, node, emitter, state) => {

package/generated/versions/defold-1.13.1/model.d.ts

@@ -72,7 +72,7 @@ declare global {
      * AABB information return as a table with `min` and `max` fields, where `min` and `max` has type `vmath.vector3`.
      *
      * @param url - the model
-     * @returns A table containing info about all AABB in the format
+     * @returns A table containing info about all AABB in the format <hash(mesh_id), aabb_info>
      * @example
      * ```ts
      * model.get_mesh_aabb("#model"); // => { hash("Sword") = { min = vmath.vector3(-0.5, -0.5, 0), max = vmath.vector3(0.5, 0.5, 0) }, hash("Shield") = { min = vmath.vector3(-0.5, -0.5, -0.5), max = vmath.vector3(0.5, 0.5, 0.5) } }

package/generated/versions/defold-1.13.1/particlefx.d.ts

@@ -49,7 +49,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a game object is created.
      * // The callback receives the hash of the path to the particlefx, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineScript({
      *   init(self) {
      *     particlefx.play("#particlefx", (self, id, emitter, state) => {

package/generated/versions/defold-1.13.1/resource.d.ts

@@ -102,10 +102,10 @@ declare global {
      * number the height of the animation
      *
      * - `frame_start`
-     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `frame_end`
-     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `playback`
      * constant optional playback mode of the animation, the default value is go.PLAYBACK_ONCE_FORWARD
@@ -1100,10 +1100,10 @@ declare global {
      * number the height of the animation
      *
      * - `frame_start`
-     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the first geometry of the animation. Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `frame_end`
-     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. in atlas.
+     * number index to the last geometry of the animation (non-inclusive). Indices are lua based and must be in the range of 1 .. <number-of-geometries> in atlas.
      *
      * - `playback`
      * constant optional playback mode of the animation, the default value is go.PLAYBACK_ONCE_FORWARD

package/generated/versions/defold-1.13.2/gui.d.ts

@@ -1355,7 +1355,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a gui node is created.
      * // The callback receives the gui node, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineGuiScript({
      *   init(self) {
      *     gui.play_particlefx(gui.get_node("particlefx"), (self, node, emitter, state) => {

package/generated/versions/defold-1.13.2/particlefx.d.ts

@@ -45,7 +45,7 @@ declare global {
      * ```ts
      * // How to play a particle fx when a game object is created.
      * // The callback receives the hash of the path to the particlefx, the hash of the id
-     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_.
+     * // of the emitter, and the new state of the emitter as particlefx.EMITTER_STATE_<STATE>.
      * export default defineScript({
      *   init(self) {
      *     particlefx.play("#particlefx", (self, id, emitter, state) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defold-typescript/types",
-  "version": "0.55.0",
+  "version": "0.56.0",
   "description": "TypeScript types for the Defold engine's Lua APIs.",
   "license": "MIT",
   "repository": {

package/scripts/extension-goldens.ts

@@ -13,11 +13,11 @@ export const EXTENSION_GOLDENS_DIR = "extension-goldens";
 const PACKAGE_ROOT = resolve(import.meta.dirname, "..");
 const EXTENSION_GOLDEN_NAMESPACES = ["iac", "iap", "push", "webview"] as const;
 
-// Each golden's doc is the conversion of the extension's `.script_api` at its
-// `packages/library-types/defold-extensions.json` pin, the same JSON the
-// Libraries pages render, so a golden carries the namespace's constants, optional
-// slots and callback arguments exactly as `resolve` would emit them for a project.
-const EXTENSION_DOCS_DIR = resolve(PACKAGE_ROOT, "../library-types/defold-extensions/api-doc");
+// Each golden's doc is a copy of the conversion of the extension's `.script_api`
+// at its `defold-extensions.json` pin, the same JSON the Libraries pages render,
+// so a golden carries the namespace's constants, optional slots and callback
+// arguments exactly as `resolve` would emit them for a project.
+const EXTENSION_DOCS_DIR = resolve(PACKAGE_ROOT, "fixtures/extension-docs");
 
 export const EXTENSION_GOLDEN_MANIFEST: readonly ModuleManifestEntry[] =
   EXTENSION_GOLDEN_NAMESPACES.map((namespace) => ({

package/scripts/generate-api-signatures.ts

@@ -23,7 +23,7 @@ export interface SignaturesArtifact {
   readonly versions: Record<string, Record<string, string>>;
   // The same axis and keys, carrying each documented slot's rendered type. Kept
   // parallel rather than folded into `versions` because three consumers
-  // (`api-surface-loader`, `combined-surface`, `version-window`) type that map's
+  // (`toolchain-surface-loader`, `combined-surface`, `version-window`) type that map's
   // value as a string; a symbol documenting no slot is absent here.
   readonly slotTypes: Record<string, Record<string, SlotTypes>>;
 }

package/src/doc-comment.ts

@@ -87,6 +87,37 @@ function weldStrandedListMarkers(text: string): string {
   return out.join("\n").trim();
 }
 
+// What counts as markup in upstream prose: the tags the docs use, plus any tag
+// assigning an attribute. Every other `<` is text, as in `Values <= 0` or
+// `<logger_name>.log`. A listed name must close straight away, because a
+// comparison such as `a <b and c> d` reads the same as a tag with bare
+// attributes. `object` stays off the list: `wrap` documents `<object>` as text.
+// `lia` and `super` are upstream typos. The toolchain docs site renders this
+// output with `html: true`, so script-bearing elements go whatever follows their
+// name, and a quoted attribute value may hold a `<` a browser reads as part of
+// the tag.
+const MARKUP_TAG = new RegExp(
+  [
+    "</?(?:a|b|blockquote|br|code|dd|div|dl|dt|em|h[1-6]|hr|i|iframe|img|kbd|li|lia|ol|p|pre|s|script|small|span|strong|style|sub|sup|super|table|tbody|td|tfoot|th|thead|tr|u|ul)\\s*/?>",
+    "</?(?:script|style|iframe)\\b[^<>]*>",
+    "</?[a-z][^<>=]*=(?:[^<>\"']|\"[^\"]*\"|'[^']*')*>",
+    "</?[a-z][^<>=]*=[^<>]*>",
+  ].join("|"),
+  "gi",
+);
+
+// Removing a tag can join the text around it into a new one (`<scr<b>ipt>`), so
+// this repeats until nothing changes.
+function stripMarkup(html: string): string {
+  let text = html;
+  let previous: string;
+  do {
+    previous = text;
+    text = text.replace(MARKUP_TAG, "");
+  } while (text !== previous);
+  return text;
+}
+
 // Upstream Markdown indented one level too deep is highlighted as code while
 // still reading as Markdown: every line opens on a backtick-quoted name, as in
 // the field table `graphics.get_adapter_info` documents under `limits`. That
@@ -156,10 +187,9 @@ export function htmlToDocText(html: string): string {
       return close ? "" : `\n${LIST_INDENT.repeat(Math.max(0, listDepth - 1))}- `;
     })
     .replace(/<br\s*\/?>/gi, "\n")
-    .replace(/<\/p>/gi, "\n\n")
-    .replace(/<[^>]+>/g, "");
+    .replace(/<\/p>/gi, "\n\n");
 
-  text = decodeEntities(text);
+  text = decodeEntities(stripMarkup(text));
 
   // Collapse horizontal whitespace runs, trim around newlines, fold runaway
   // blank runs to one blank line, then trim the whole string — preserving
@@ -195,8 +225,8 @@ export function htmlToDocText(html: string): string {
  * runs of blank lines to one. Returns `""` for empty / whitespace-only input.
  */
 export function htmlToCodeText(html: string): string {
-  let text = html.replace(/<br\s*\/?>/gi, "\n").replace(/<[^>]+>/g, "");
-  text = decodeEntities(text);
+  const stripped = stripMarkup(html.replace(/<br\s*\/?>/gi, "\n"));
+  const text = decodeEntities(stripped);
 
   const lines = text.split("\n").map((line) => line.replace(/[ \t]+$/g, ""));
   while (lines.length > 0 && lines[0] === "") lines.shift();

package/src/index-slot-classifications.ts

@@ -568,7 +568,7 @@ function isPlainObject(value: unknown): value is Record<string, unknown> {
 // multi-value return as a field of that return (`cast:return::tile_x`). A
 // typedef method is keyed by its bare name, so one key covers every class of the
 // page that declares that method.
-// `docs-site/app/lib/library-index-slot-gate.test.ts` reds on a scanned slot
+// The library docs site's `site/app/lib/library-index-slot-gate.test.ts` reds on a scanned slot
 // missing from the library data folder's `index-slot-classifications.json` and on an entry
 // no library page declares.
 export function parseLibraryIndexSlotClassifications(