@north-light/crouter 0.3.197 → 0.3.199

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.197",
+  "version": "0.3.199",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.197",
+      "version": "0.3.199",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
@@ -15,9 +15,11 @@
         "@earendil-works/pi-coding-agent": "0.84.1",
         "@earendil-works/pi-tui": "0.84.1",
         "cron-parser": "^5.6.0",
+        "esbuild": "^0.27.7",
         "proper-lockfile": "4.1.2",
         "string-width": "^7.0.0",
         "tar": "^7.5.22",
+        "typescript": "^5.7.0",
         "ws": "^8.21.0",
         "yaml": "^2.9.0",
         "zod": "^4.3.6"
@@ -31,9 +33,7 @@
         "@types/node": "^24.0.0",
         "@types/proper-lockfile": "^4.1.4",
         "@types/ws": "^8.18.1",
-        "esbuild": "^0.27.7",
-        "tsx": "^4.0.0",
-        "typescript": "^5.7.0"
+        "tsx": "^4.0.0"
       }
     },
     "node_modules/@anthropic-ai/sdk": {
@@ -2432,7 +2432,6 @@
       "cpu": [
         "ppc64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2449,7 +2448,6 @@
       "cpu": [
         "arm"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2466,7 +2464,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2483,7 +2480,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2500,7 +2496,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2517,7 +2512,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2534,7 +2528,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2551,7 +2544,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2568,7 +2560,6 @@
       "cpu": [
         "arm"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2585,7 +2576,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2602,7 +2592,6 @@
       "cpu": [
         "ia32"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2619,7 +2608,6 @@
       "cpu": [
         "loong64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2636,7 +2624,6 @@
       "cpu": [
         "mips64el"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2653,7 +2640,6 @@
       "cpu": [
         "ppc64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2670,7 +2656,6 @@
       "cpu": [
         "riscv64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2687,7 +2672,6 @@
       "cpu": [
         "s390x"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2704,7 +2688,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2721,7 +2704,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2738,7 +2720,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2755,7 +2736,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2772,7 +2752,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2789,7 +2768,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2806,7 +2784,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2823,7 +2800,6 @@
       "cpu": [
         "arm64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2840,7 +2816,6 @@
       "cpu": [
         "ia32"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2857,7 +2832,6 @@
       "cpu": [
         "x64"
       ],
-      "dev": true,
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3290,7 +3264,6 @@
       "version": "0.27.7",
       "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.7.tgz",
       "integrity": "sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==",
-      "dev": true,
       "hasInstallScript": true,
       "license": "MIT",
       "bin": {
@@ -4332,7 +4305,6 @@
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
       "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
-      "dev": true,
       "license": "Apache-2.0",
       "bin": {
         "tsc": "bin/tsc",

package/scripts/install-runtime.mjs

@@ -14,7 +14,10 @@ const GENERATIONS = join(RUNTIME_HOME, 'generations');
 const LOCK = join(RUNTIME_HOME, 'install.lock');
 const LOCK_OWNER_FILE = 'owner.json';
 const RUNTIME_LOCK = 'runtime.lock.json';
-const KEEP_RECENT_GENERATIONS = 3;
+// The selected generation plus one prior, so a bad selection can be rolled
+// back by hand. Anything older is reinstallable from npm and is not worth the
+// ~500MB/generation it costs on disk.
+const KEEP_RECENT_GENERATIONS = 2;
 const FS_CONCURRENCY = 64;
 // How long an install.lock with no readable owner record is given the
 // benefit of the doubt (the owner is mid-write, or on an ancient version of
@@ -174,40 +177,36 @@ function generationIdsIn(text) {
   return [...text.matchAll(/generations\/([a-f0-9]{64})(?:[/\s]|$)/g)].map((match) => match[1]);
 }
 
-/** Return every generation used by a running process and whether every stable
- *  selector process exposed its generation lease. */
+/** Every generation a running process is using — named in its argv, or held as
+ *  an open entry-file lease (how a stable `crtr`/`crtrd` shim, whose argv names
+ *  no generation, keeps the one it resolved; see `holdGenerationEntryFd` in
+ *  bin/runtime-selector.mjs and the matching open in src/cli.ts).
+ *
+ *  Detection is positive-only and that is deliberate: a generation nothing here
+ *  names is prunable. An earlier revision also tracked whether every stable shim
+ *  had exposed a lease and skipped the whole GC when one had not. That made one
+ *  unidentifiable process veto all pruning permanently — a single pre-upgrade
+ *  viewer, which could never hold a lease the mechanism predated, silently
+ *  stopped GC forever and grew this directory by ~500MB per install. */
 async function liveGenerationIds() {
   const output = await run('ps', ['-axww', '-o', 'pid=,command='], RUNTIME_HOME, true);
   const live = new Set(generationIdsIn(output));
   const nodePids = [];
-  const opaqueStablePids = new Set();
   for (const line of output.split('\n')) {
     const match = /^\s*(\d+)\s+(.*)$/.exec(line);
     if (!match) continue;
     const [, pid, command] = match;
-    const stableSelector = /^(?:\S*node\s+)?\S*\/bin\/(?:crtr|crtrd|crouter)(?:\s|$)/.test(command);
-    if (stableSelector && generationIdsIn(command).length === 0) opaqueStablePids.add(pid);
     if (/(?:^|[\s/])(?:node|crtrd?|crouter)(?:[\s]|$)/.test(command)) nodePids.push(pid);
   }
-  if (nodePids.length === 0) return { live, uncertain: opaqueStablePids.size > 0 };
+  if (nodePids.length === 0) return live;
 
   // One lsof invocation resolves cwd references and the runtime entry-file
   // lease held by each stable CLI process without a per-process startup penalty.
   const open = await probe('lsof', ['-n', '-P', '-a', '-p', nodePids.join(','), '-Fn'], RUNTIME_HOME);
-  let pid;
-  const exposedStablePids = new Set();
   for (const line of open.split('\n')) {
-    const processMatch = /^p(\d+)$/.exec(line);
-    if (processMatch) {
-      pid = processMatch[1];
-      continue;
-    }
-    const ids = generationIdsIn(line);
-    for (const id of ids) live.add(id);
-    if (pid !== undefined && ids.length > 0 && opaqueStablePids.has(pid)) exposedStablePids.add(pid);
+    for (const id of generationIdsIn(line)) live.add(id);
   }
-  const uncertain = [...opaqueStablePids].some((stablePid) => !exposedStablePids.has(stablePid));
-  return { live, uncertain };
+  return live;
 }
 
 async function selectedGenerationId() {
@@ -219,11 +218,7 @@ async function selectedGenerationId() {
 
 async function pruneGenerations() {
   const selected = await selectedGenerationId();
-  const { live, uncertain } = await liveGenerationIds();
-  if (uncertain) {
-    process.stderr.write('runtime generation GC skipped: a live stable crouter shim does not expose its generation lease\n');
-    return;
-  }
+  const live = await liveGenerationIds();
   const entries = await readdir(GENERATIONS, { withFileTypes: true });
   const candidates = [];
   for (const entry of entries) {

package/dist/builtin-memory/init.md

@@ -1,38 +0,0 @@
----
-kind: knowledge
-when-and-why-to-read: When bootstrapping a project's memory store — the user invoked /init or a workspace has no .crouter/memory/INDEX.md front door — this knowledge should be read because a lean routed front door gives every future agent in that workspace its operating contract for a fraction of the standing context cost an unstructured guidance dump would charge each session forever.
-short-form: "Bootstrap a project memory store: survey the repo, then author a lean INDEX front door plus a linked dev doc — commands, map, non-default rules, pointers — and lint. Depth splits into linked docs; every always-loaded line must earn its keep."
-system-prompt-visibility: none
-file-read-visibility: none
-slash: true
-rationale: Unguided agents bootstrap project memory badly in both directions — either no front door at all, or a monolithic CLAUDE.md-style manual (copied README, generic framework advice, exhaustive command catalogs) that taxes every future session and decays. Distilled 2026-07-31 from ecosystem research across Anthropic/OpenAI/Cursor/GitHub guidance and production AGENTS.md files — the strongest evidence being Sentry's consolidation postmortem (critical commands buried in nested files got missed) and Anthropic's under-200-line target with adherence falling as always-loaded files grow.
----
-
-# /init — bootstrap this project's memory store
-
-Give this workspace its memory front door: a root INDEX every future agent boots with when the project mounts, plus a small graph of linked docs carrying the depth. The front door is an operating contract and routing layer, never a manual — every line it carries is paid by every session here forever, so a line earns its place only by changing behavior: a fact every task needs, a non-obvious hazard, or a rule an agent would otherwise get wrong.
-
-## 1. Survey before writing
-
-Learn the project from its own artifacts: README, package manifests and lockfiles, build/CI config, scripts, existing CLAUDE.md/AGENTS.md or docs. Extract the real commands (setup, run, build, targeted test, full verification) and RUN the important ones — record only commands you have seen work, with any required ordering, environment, or package-manager constraint. Note the architecture in a few sentences: major components, dependency direction, where generated or externally-owned code lives. Collect the conventions that differ from what a competent agent would assume — those deviations are the highest-value lines you will write.
-
-## 2. Read the contract, then author the front door
-
-Run `crtr memory write -h` first — it carries the substrate frontmatter contract and the exact root-INDEX shape, including the workspace-mount route that `crtr memory lint` validates. Then author the INDEX with these sections, total well under the length lint's cap:
-
-- **Project in one paragraph** — purpose, major components, dependency direction.
-- **Common commands** — the 3–8 commands most changes need, copyable, verified.
-- **Where to work** — a task-to-path map; mark generated or externally-owned areas.
-- **Non-default rules and gotchas** — only high-impact deviations from defaults. Skip anything a formatter, linter, or typechecker already enforces; point at the check instead.
-- **Done** — the minimum credible gate for an ordinary change.
-- **Pointers** — a `[[link]]` per deeper doc with a one-clause read trigger (e.g. "debugging the daemon → the dev doc").
-
-Exclude generic language/framework advice, copied docs or style guides, volatile version detail, rare edge cases, and multi-step procedures — depth belongs behind links, not in the standing load.
-
-## 3. Split depth into linked docs
-
-Author `dev` alongside the INDEX by default: validated setup/run/build/test/debug commands with required order and environment, targeted-vs-full verification, and common failure modes. Add `architecture` only when the tree cannot be understood from the INDEX's brief map, and a conventions/gotchas doc only once real project-specific rules outgrow a few INDEX bullets — never pre-populate generic security or style manuals. These reference docs take `none` visibility on both axes; the INDEX's links are how they are found, so they cost nothing until followed.
-
-## 4. Validate
-
-Run `crtr memory lint` — it strict-parses the store, checks the INDEX front-door contract, and fails on dangling links or over-length bodies. Fix findings rather than suppressing them. The store is a living contract: when commands, architecture, or conventions change, rewrite the affected doc in place and delete superseded guidance — an always-loaded line that has stopped being true is worse than no line at all.

package/dist/builtin-memory/plan.md

@@ -1,19 +0,0 @@
----
-kind: knowledge
-when-and-why-to-read: When an agent invokes /plan to pause work and map an implementation, this knowledge should be read because implementation can proceed from a grounded path instead of making consequential decisions while editing.
-short-form: "Pause to write one right-sized implementation plan in the node context, then stop."
-system-prompt-visibility: none
-file-read-visibility: none
-slash: true
-rationale: The prior /plan plugin prompt forced ordinary planning through a fixed question loop, reviewer node, and human approval, adding ceremony rather than letting the plan match the work.
----
-
-# /plan — write an implementation plan
-
-Pause the current work and write one right-sized implementation plan for: $ARGUMENTS
-
-Ground it in the relevant code and requirements. Make the approach, affected areas, ordering or dependencies, and verification clear enough that an implementer can carry it out without guessing. Resolve only the decisions the plan needs; point to existing patterns rather than repeating source code.
-
-Write the artifact in `$CRTR_CONTEXT_DIR`. For work that genuinely needs a broader planning roadmap, read [[plan/roadmap]] instead.
-
-Report the artifact's absolute path, then stop. Do not implement as part of this invocation.

package/dist/builtin-memory/spec.md

@@ -1,19 +0,0 @@
----
-kind: knowledge
-when-and-why-to-read: When an agent invokes /spec to pause work and capture a request, this knowledge should be read because the work can resume from settled intent instead of rediscovering what it is meant to achieve.
-short-form: "Pause to write one right-sized specification in the node context, then stop."
-system-prompt-visibility: none
-file-read-visibility: none
-slash: true
-rationale: The prior /spec plugin prompt forced ordinary artifact requests through discovery loops, reviewer nodes, and human approval, turning a small pause to clarify work into prescribed ceremony.
----
-
-# /spec — write a specification
-
-Pause the current work and write one right-sized specification for: $ARGUMENTS
-
-Ground it in the relevant request and context. Make the intended outcome, behavior, and scope boundary clear enough that a downstream reader does not have to guess. Leave implementation choices to design and planning unless they constrain the outcome.
-
-Write the artifact in `$CRTR_CONTEXT_DIR`. Read [[spec/guide]] when the request needs elicitation or a fuller quality check; for work that genuinely needs separate discovery, design, and requirements work across nodes, read [[spec/roadmap]].
-
-Report the artifact's absolute path, then stop. Do not implement as part of this invocation.

package/dist/clients/attach/render/html-markdown.d.ts

@@ -1,13 +0,0 @@
-export interface HtmlMarkdownStyles {
-    kbd: (text: string) => string;
-    mark: (text: string) => string;
-    hint: (text: string) => string;
-}
-export interface HtmlMarkdownOptions {
-    /** Undefined honors each block's `open` attribute. A boolean is the viewer's
-     * global Ctrl+O override. */
-    detailsExpanded: boolean | undefined;
-    styles: HtmlMarkdownStyles;
-}
-/** Transform the strict supported HTML subset in one Markdown string. */
-export declare function transformHtmlMarkdown(source: string, options: HtmlMarkdownOptions): string;

package/dist/clients/attach/render/html-markdown.js

@@ -1,206 +0,0 @@
-// Supported raw HTML for assistant Markdown in the attach viewer.
-//
-// This is deliberately a semantic allowlist, not an HTML renderer. Complete
-// details/summary blocks become terminal disclosure rows, while kbd and mark
-// become theme-styled inline text. Everything else stays literal, and Markdown
-// code spans/fences are protected before the allowlist scanner runs.
-const PROTECTED_PREFIX = '\u0000\u0001CRTR_HTML_CODE_';
-const PROTECTED_SUFFIX = '\u0002';
-const DETAILS_OPEN = /<details\b[^>]*>/gi;
-const DETAILS_TAG = /<\/?details\b[^>]*>/gi;
-const VALID_DETAILS_OPEN = /^<details(?:[ \t\r\n]+open)?[ \t\r\n]*>$/i;
-const VALID_DETAILS_CLOSE = /^<\/details[ \t\r\n]*>$/i;
-const SUMMARY_OPEN = /^[ \t\r\n]*<summary[ \t\r\n]*>/i;
-const SUMMARY_CLOSE = /<\/summary[ \t\r\n]*>/i;
-const INLINE_HTML = /<(kbd|mark)>([^<>\n]*?)<\/\1[ \t]*>/gi;
-const SUPPORTED_HTML = /<(?:details|kbd|mark)\b/i;
-function protectedToken(index) {
-    return `${PROTECTED_PREFIX}${index}${PROTECTED_SUFFIX}`;
-}
-function lineWithoutEnding(line) {
-    return line.endsWith('\n') ? line.slice(0, -1).replace(/\r$/, '') : line;
-}
-function protectFencedCode(source, protectedParts) {
-    const lines = source.match(/[^\n]*(?:\n|$)/g)?.filter((line) => line !== '') ?? [];
-    const out = [];
-    for (let index = 0; index < lines.length;) {
-        const openingLine = lineWithoutEnding(lines[index]);
-        const opening = /^ {0,3}(`{3,}|~{3,})[^\n]*$/.exec(openingLine);
-        if (!opening) {
-            out.push(lines[index]);
-            index++;
-            continue;
-        }
-        const marker = opening[1];
-        const markerChar = marker[0];
-        let end = index + 1;
-        for (; end < lines.length; end++) {
-            const candidate = lineWithoutEnding(lines[end]);
-            const closing = /^ {0,3}(`+|~+)[ \t]*$/.exec(candidate)?.[1];
-            if (closing?.[0] === markerChar && closing.length >= marker.length) {
-                end++;
-                break;
-            }
-        }
-        const raw = lines.slice(index, end).join('');
-        const tokenIndex = protectedParts.push(raw) - 1;
-        out.push(protectedToken(tokenIndex));
-        index = end;
-    }
-    return out.join('');
-}
-function protectInlineCode(source, protectedParts) {
-    let out = '';
-    let index = 0;
-    while (index < source.length) {
-        if (source[index] !== '`') {
-            out += source[index];
-            index++;
-            continue;
-        }
-        let openingEnd = index + 1;
-        while (source[openingEnd] === '`')
-            openingEnd++;
-        const markerLength = openingEnd - index;
-        let cursor = openingEnd;
-        let closingEnd = -1;
-        while (cursor < source.length) {
-            const next = source.indexOf('`', cursor);
-            if (next === -1)
-                break;
-            let runEnd = next + 1;
-            while (source[runEnd] === '`')
-                runEnd++;
-            if (runEnd - next === markerLength) {
-                closingEnd = runEnd;
-                break;
-            }
-            cursor = runEnd;
-        }
-        if (closingEnd === -1) {
-            out += source.slice(index, openingEnd);
-            index = openingEnd;
-            continue;
-        }
-        const tokenIndex = protectedParts.push(source.slice(index, closingEnd)) - 1;
-        out += protectedToken(tokenIndex);
-        index = closingEnd;
-    }
-    return out;
-}
-function protectMarkdownCode(source) {
-    const protectedParts = [];
-    const fenced = protectFencedCode(source, protectedParts);
-    const masked = protectInlineCode(fenced, protectedParts);
-    return {
-        masked,
-        restore: (text) => text.replace(/\u0000\u0001CRTR_HTML_CODE_(\d+)\u0002/g, (_whole, rawIndex) => protectedParts[Number(rawIndex)] ?? ''),
-    };
-}
-function isEscaped(source, index) {
-    let slashes = 0;
-    for (let cursor = index - 1; cursor >= 0 && source[cursor] === '\\'; cursor--)
-        slashes++;
-    return slashes % 2 === 1;
-}
-/** HTML phrasing content for this allowlist is plain text. Escape CommonMark's
- * ASCII punctuation so a key label such as `[x]` cannot become a link, while
- * the Markdown renderer removes the escapes from the displayed text. */
-function escapeMarkdownInline(text) {
-    return [...text].map((char) => /[!-/:-@[-`{-~]/.test(char) ? `\\${char}` : char).join('');
-}
-function transformInlineHtml(text, styles) {
-    return text.replace(INLINE_HTML, (whole, rawTag, rawBody, offset) => {
-        if (isEscaped(text, offset))
-            return whole;
-        const tag = rawTag.toLowerCase();
-        const body = tag === 'kbd' ? rawBody.replace(/\s+/g, ' ').trim() : rawBody.trim();
-        if (body === '')
-            return whole;
-        const escaped = escapeMarkdownInline(body);
-        return tag === 'kbd' ? styles.kbd(escaped) : styles.mark(escaped);
-    });
-}
-function findDetailsRange(source, openEnd) {
-    DETAILS_TAG.lastIndex = openEnd;
-    let depth = 1;
-    let nested = false;
-    for (let match = DETAILS_TAG.exec(source); match; match = DETAILS_TAG.exec(source)) {
-        if (isEscaped(source, match.index))
-            continue;
-        const closing = /^<\//.test(match[0]);
-        if (closing) {
-            depth--;
-            if (depth === 0)
-                return { closeStart: match.index, closeTag: match[0], end: DETAILS_TAG.lastIndex, nested };
-        }
-        else {
-            depth++;
-            nested = true;
-        }
-    }
-    DETAILS_TAG.lastIndex = 0;
-    return undefined;
-}
-function renderDetails(source, openTag, openEnd, range, options) {
-    if (!VALID_DETAILS_OPEN.test(openTag) || !VALID_DETAILS_CLOSE.test(range.closeTag) || range.nested)
-        return undefined;
-    const inner = source.slice(openEnd, range.closeStart);
-    const summaryOpen = SUMMARY_OPEN.exec(inner);
-    if (!summaryOpen)
-        return undefined;
-    const afterSummaryOpen = summaryOpen[0].length;
-    const summaryClose = SUMMARY_CLOSE.exec(inner.slice(afterSummaryOpen));
-    if (!summaryClose)
-        return undefined;
-    const summaryEnd = afterSummaryOpen + summaryClose.index;
-    const summary = inner.slice(afterSummaryOpen, summaryEnd).trim();
-    if (summary === '')
-        return undefined;
-    const summaryRendered = transformInlineHtml(summary, options.styles);
-    const openByAttribute = /[ \t\r\n]open[ \t\r\n]*>$/i.test(openTag);
-    const expanded = options.detailsExpanded ?? openByAttribute;
-    const glyph = expanded ? '▾' : '▸';
-    if (!expanded)
-        return `${glyph} ${summaryRendered} ${options.styles.hint('— ctrl+o to expand')}`;
-    const bodyStart = summaryEnd + summaryClose[0].length;
-    const body = inner.slice(bodyStart).trim();
-    if (body === '')
-        return `${glyph} ${summaryRendered}`;
-    return `${glyph} ${summaryRendered}\n\n${transformInlineHtml(body, options.styles)}`;
-}
-/** Transform the strict supported HTML subset in one Markdown string. */
-export function transformHtmlMarkdown(source, options) {
-    if (!SUPPORTED_HTML.test(source))
-        return source;
-    const protectedMarkdown = protectMarkdownCode(source);
-    const masked = protectedMarkdown.masked;
-    let out = '';
-    let cursor = 0;
-    DETAILS_OPEN.lastIndex = 0;
-    for (let match = DETAILS_OPEN.exec(masked); match; match = DETAILS_OPEN.exec(masked)) {
-        if (match.index < cursor)
-            continue;
-        const range = findDetailsRange(masked, DETAILS_OPEN.lastIndex);
-        if (!range) {
-            out += transformInlineHtml(masked.slice(cursor, match.index), options.styles);
-            out += masked.slice(match.index);
-            cursor = masked.length;
-            break;
-        }
-        out += transformInlineHtml(masked.slice(cursor, match.index), options.styles);
-        const whole = masked.slice(match.index, range.end);
-        if (isEscaped(masked, match.index)) {
-            out += whole;
-        }
-        else {
-            const rendered = renderDetails(masked, match[0], DETAILS_OPEN.lastIndex, range, options);
-            out += rendered ?? whole;
-        }
-        cursor = range.end;
-        DETAILS_OPEN.lastIndex = range.end;
-    }
-    if (cursor < masked.length)
-        out += transformInlineHtml(masked.slice(cursor), options.styles);
-    return protectedMarkdown.restore(out);
-}