@doxbrix/doxloop 0.1.3 → 0.1.5

package/dist/interactive.js

@@ -0,0 +1,343 @@
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { basename, join, relative, resolve } from 'node:path';
+import { AGENT_CATALOG, detectAgents, installAgent } from './agents.js';
+import { pathExists } from './fs.js';
+import { GENERATOR_CATALOG, resolveGeneratorPackage } from './generators.js';
+import { PROJECT_FILE, isSpecUrl, parseSpec } from './project.js';
+import { heading, note, promptConfirm, promptSelect, promptText, } from './prompts.js';
+const PRODUCT_MARKERS = [
+    'package.json',
+    'pyproject.toml',
+    'go.mod',
+    'Cargo.toml',
+    'pom.xml',
+    'build.gradle',
+    'Gemfile',
+    'composer.json',
+    'src',
+    'lib',
+    '.git',
+];
+export async function runInitWizard(cwd, providedIo) {
+    const io = providedIo ?? { input: process.stdin, output: process.stdout };
+    heading(io, 'Doxloop — create a documentation project');
+    const detected = await describeDirectory(cwd);
+    if (detected) {
+        note(io, `✓ Detected product source: ${cwd}\n  Found: ${detected}`);
+    }
+    const directory = await promptText({
+        message: 'Where should the documentation project live?',
+        initial: detected ? `../${basename(cwd)}-docs` : './docs',
+        hint: 'A new or empty directory, separate from your product source.',
+        validate: async (value) => (await validateProjectDirectory(cwd, value)) ??
+            (detected
+                ? await validateSourceDirectory(cwd, resolve(cwd, value), '.')
+                : undefined),
+        io,
+    });
+    const projectRoot = resolve(cwd, directory);
+    const evidence = await promptSelect({
+        message: 'What should the documentation be based on?',
+        choices: [
+            {
+                value: 'directory',
+                label: detected ? 'This product source' : 'Local source code',
+                hint: detected
+                    ? cwd
+                    : 'a directory Doxloop reads as read-only evidence',
+            },
+            {
+                value: 'spec',
+                label: 'An API specification',
+                hint: 'OpenAPI or Swagger — file or URL',
+            },
+            { value: 'both', label: 'Both', hint: 'source code and a specification' },
+            {
+                value: 'none',
+                label: 'Nothing yet',
+                hint: 'author from my written request; add evidence later',
+            },
+        ],
+        io,
+    });
+    const sources = [];
+    let sourceRoot;
+    if (evidence === 'directory' || evidence === 'both') {
+        if (detected) {
+            sourceRoot = cwd;
+        }
+        else {
+            const path = await promptText({
+                message: 'Path to your product source',
+                validate: (value) => validateSourceDirectory(cwd, projectRoot, value),
+                io,
+            });
+            sourceRoot = resolve(cwd, path);
+        }
+        const found = await describeDirectory(sourceRoot);
+        if (found)
+            note(io, `✓ found: ${found}`);
+        // Stored source paths are resolved from the project root, not the wizard cwd.
+        sources.push({ name: 'product', path: projectRelative(projectRoot, sourceRoot) });
+    }
+    if (evidence === 'spec' || evidence === 'both') {
+        const location = await promptText({
+            message: 'API specification (file or URL)',
+            validate: (value) => validateSpecLocation(cwd, value),
+            io,
+        });
+        const summary = await describeSpec(cwd, location);
+        if (summary)
+            note(io, `✓ ${summary}`);
+        const spec = parseSpec(`api=${location}`);
+        sources.push(isSpecUrl(spec.path)
+            ? spec
+            : { ...spec, path: projectRelative(projectRoot, resolve(cwd, spec.path)) });
+    }
+    if (evidence === 'none') {
+        note(io, 'The agent will author from your request and ask before inventing product behavior.\nAttach evidence later with `doxloop settings`.');
+    }
+    const suggestedTitle = (sourceRoot ? await titleFromPackageMetadata(sourceRoot) : undefined) ??
+        titleize(basename(projectRoot));
+    const title = await promptText({
+        message: 'Site title',
+        initial: suggestedTitle,
+        io,
+    });
+    const generatorChoice = await promptSelect({
+        message: 'How should the documentation site be generated?',
+        choices: [
+            {
+                value: 'doxbrix',
+                label: 'Doxbrix',
+                hint: 'recommended · built in · no additional setup',
+            },
+            {
+                value: 'other',
+                label: 'Use another documentation framework',
+            },
+        ],
+        io,
+    });
+    const generator = generatorChoice === 'doxbrix'
+        ? 'doxbrix'
+        : await promptSelect({
+            message: 'Choose your documentation framework',
+            choices: GENERATOR_CATALOG.filter((entry) => entry.id !== 'doxbrix').map((entry) => ({
+                value: entry.id,
+                label: entry.displayName,
+                ...(entry.packageName &&
+                    resolveGeneratorPackage(projectRoot, entry.packageName)
+                    ? { hint: 'installed' }
+                    : entry.packageName
+                        ? { hint: `will install ${entry.packageName}` }
+                        : {}),
+            })),
+            io,
+        });
+    return { directory, title, sources, generator };
+}
+export function replayInitCommand(plan) {
+    const parts = ['doxloop init', quoteArgument(plan.directory)];
+    if (plan.title)
+        parts.push('--title', quoteArgument(plan.title));
+    for (const source of plan.sources) {
+        if ((source.kind ?? 'directory') === 'openapi') {
+            parts.push('--spec', quoteArgument(`${source.name}=${source.path}`));
+        }
+        else {
+            parts.push('--source', quoteArgument(`${source.name}=${source.path}`));
+        }
+    }
+    if (plan.generator !== 'doxbrix')
+        parts.push('--generator', plan.generator);
+    return parts.join(' ');
+}
+export function formatInitPlan(cwd, plan) {
+    const projectRoot = resolve(cwd, plan.directory);
+    const evidence = plan.sources.length === 0
+        ? 'None yet'
+        : plan.sources
+            .map((source) => (source.kind ?? 'directory') === 'openapi'
+            ? `OpenAPI: ${source.path}`
+            : `Source: ${resolve(projectRoot, source.path)}`)
+            .join('\n            ');
+    const generator = GENERATOR_CATALOG.find((entry) => entry.id === plan.generator)?.displayName ??
+        plan.generator;
+    return `Setup summary\n\n  Documentation: ${projectRoot}\n  Evidence:      ${evidence}\n  Site title:    ${plan.title ?? basename(projectRoot)}\n  Generator:     ${generator}`;
+}
+export async function runCreateRescueWizard(cwd, io) {
+    const found = await describeDirectory(cwd);
+    if (!found)
+        return undefined;
+    const name = basename(cwd);
+    note(io, `This directory is not a Doxloop project — it looks like your product source\n(found: ${found}).`);
+    const proceed = await promptConfirm({
+        message: `Set up a separate documentation project for "${name}" now?`,
+        initial: true,
+        io,
+    });
+    if (!proceed)
+        return undefined;
+    return runInitWizard(cwd, io);
+}
+export async function promptForRequest(mode, io, hasEvidence = true) {
+    const value = await promptText({
+        message: mode === 'create'
+            ? 'What documentation do you need?'
+            : 'Anything specific to focus on?',
+        hint: mode === 'create'
+            ? 'Describe readers, required pages, tone, or priorities — or press Enter to let the agent propose a plan.'
+            : hasEvidence
+                ? 'Press Enter to synchronize documentation with the source changes above.'
+                : 'Describe the documentation-only change, or press Enter to cancel.',
+        allowEmpty: true,
+        io,
+    });
+    return value === '' ? undefined : value;
+}
+export async function selectAgentInteractive(io) {
+    const agents = await detectAgents();
+    const installed = new Set(agents.map((agent) => agent.name));
+    const selected = await promptSelect({
+        message: 'Which agent should author this run?',
+        choices: AGENT_CATALOG.map((agent) => ({
+            value: agent.name,
+            label: agent.displayName,
+            hint: installed.has(agent.name) ? 'installed' : 'not installed · will install',
+        })),
+        io,
+    });
+    if (!installed.has(selected)) {
+        const agent = AGENT_CATALOG.find((candidate) => candidate.name === selected);
+        note(io, `Installing ${agent?.displayName ?? selected}...`);
+        await installAgent(selected);
+        note(io, `✓ ${agent?.displayName ?? selected} installed.`);
+    }
+    return selected;
+}
+async function validateProjectDirectory(cwd, value) {
+    const root = resolve(cwd, value);
+    if (await pathExists(join(root, PROJECT_FILE))) {
+        return `A Doxloop project already exists at ${root}. Choose another directory.`;
+    }
+    if (await pathExists(root)) {
+        try {
+            const stats = await stat(root);
+            if (!stats.isDirectory())
+                return `${root} is not a directory.`;
+            if ((await readdir(root)).length > 0) {
+                return `${root} is not empty. Choose a new or empty directory.`;
+            }
+        }
+        catch {
+            return `Cannot inspect ${root}.`;
+        }
+    }
+    return undefined;
+}
+async function validateSourceDirectory(cwd, projectRoot, value) {
+    const sourceRoot = resolve(cwd, value);
+    try {
+        const stats = await stat(sourceRoot);
+        if (!stats.isDirectory())
+            return `${sourceRoot} is not a directory.`;
+    }
+    catch {
+        return `The product source does not exist: ${sourceRoot}`;
+    }
+    if (sourceRoot === projectRoot ||
+        projectRoot.startsWith(`${sourceRoot}/`) ||
+        sourceRoot.startsWith(`${projectRoot}/`)) {
+        return 'The product source and documentation project must be separate directories.';
+    }
+    return undefined;
+}
+async function validateSpecLocation(cwd, value) {
+    if (isSpecUrl(value)) {
+        try {
+            const url = new URL(value);
+            if (url.username || url.password)
+                return 'Remove embedded credentials from the URL.';
+        }
+        catch {
+            return 'Enter a valid HTTP or HTTPS URL.';
+        }
+        return undefined;
+    }
+    const path = resolve(cwd, value);
+    try {
+        const stats = await stat(path);
+        if (!stats.isFile())
+            return `${path} is not a file.`;
+    }
+    catch {
+        return `The specification file does not exist: ${path}`;
+    }
+    return undefined;
+}
+export async function describeSpec(cwd, location) {
+    if (isSpecUrl(location))
+        return undefined;
+    const path = resolve(cwd, location);
+    try {
+        const parsed = JSON.parse(await readFile(path, 'utf8'));
+        const version = typeof parsed.openapi === 'string'
+            ? `OpenAPI ${parsed.openapi}`
+            : typeof parsed.swagger === 'string'
+                ? `Swagger ${parsed.swagger}`
+                : undefined;
+        if (!version)
+            return undefined;
+        const title = typeof parsed.info?.title === 'string' ? parsed.info.title : undefined;
+        const operations = parsed.paths
+            ? Object.values(parsed.paths).reduce((total, methods) => total + Object.keys(methods ?? {}).length, 0)
+            : 0;
+        return [version, title ? `"${title}"` : undefined, `${operations} operations`]
+            .filter(Boolean)
+            .join(' — ');
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function describeDirectory(path) {
+    const found = [];
+    for (const marker of PRODUCT_MARKERS) {
+        if (await pathExists(join(path, marker)))
+            found.push(marker);
+        if (found.length === 4)
+            break;
+    }
+    return found.length > 0 ? found.join(', ') : undefined;
+}
+async function titleFromPackageMetadata(sourceRoot) {
+    try {
+        const parsed = JSON.parse(await readFile(join(sourceRoot, 'package.json'), 'utf8'));
+        if (typeof parsed.name === 'string' && parsed.name.trim() !== '') {
+            return titleize(parsed.name.replace(/^@[^/]+\//, ''));
+        }
+    }
+    catch {
+        // No package metadata; fall back to the directory name.
+    }
+    return undefined;
+}
+function titleize(value) {
+    return value
+        .split(/[-_.\s]+/)
+        .filter(Boolean)
+        .map((word) => `${word[0]?.toUpperCase() ?? ''}${word.slice(1)}`)
+        .join(' ');
+}
+function quoteArgument(value) {
+    if (/^[a-zA-Z0-9_@%+=:,./-]+$/.test(value))
+        return value;
+    if (process.platform === 'win32')
+        return `'${value.replaceAll("'", "''")}'`;
+    return `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+function projectRelative(projectRoot, absolute) {
+    return relative(projectRoot, absolute).split('\\').join('/');
+}
+//# sourceMappingURL=interactive.js.map

package/dist/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"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"}

package/dist/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAYrE,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAEnB,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AA2CD,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AA6ID,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAA;CAC5C,GAAG,MAAM,CAuZT;AAuWD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4CvD"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAYrE,OAAO,KAAK,EAGV,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAEnB,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,CAAA;CACd;AA2CD,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzE;AA6ID,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAA;CAC5C,GAAG,MAAM,CAylBT;AAuWD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA4CvD"}

package/dist/preview.js

@@ -449,6 +449,159 @@ export function doxbrixDocument(input) {
     document.body.classList.remove('dxb-search-open');
     searchButton?.focus();
   }
+  function setApiBodyValue(body, path, value) {
+    const key = path[0];
+    if (!key) return;
+    if (path.length === 1) {
+      body[key] = value;
+      return;
+    }
+    if (!body[key] || typeof body[key] !== 'object' || Array.isArray(body[key])) {
+      body[key] = {};
+    }
+    setApiBodyValue(body[key], path.slice(1), value);
+  }
+  function apiBodyValue(input) {
+    const value = input.value.trim();
+    const type = (input.dataset.apiParamType || 'string').toLocaleLowerCase();
+    if (type === 'integer') {
+      const parsed = Number(value);
+      if (!Number.isInteger(parsed)) throw new Error(input.dataset.apiParamName + ' must be an integer.');
+      return parsed;
+    }
+    if (type === 'number') {
+      const parsed = Number(value);
+      if (!Number.isFinite(parsed)) throw new Error(input.dataset.apiParamName + ' must be a number.');
+      return parsed;
+    }
+    if (type === 'boolean') {
+      if (value !== 'true' && value !== 'false') throw new Error(input.dataset.apiParamName + ' must be true or false.');
+      return value === 'true';
+    }
+    if (type === 'array' || type === 'object') {
+      let parsed;
+      try {
+        parsed = JSON.parse(value);
+      } catch {
+        throw new Error(input.dataset.apiParamName + ' must contain valid JSON.');
+      }
+      if (type === 'array' && !Array.isArray(parsed)) throw new Error(input.dataset.apiParamName + ' must be a JSON array.');
+      if (type === 'object' && (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))) {
+        throw new Error(input.dataset.apiParamName + ' must be a JSON object.');
+      }
+      return parsed;
+    }
+    return input.value;
+  }
+  function apiRequestFromModal(modal) {
+    const endpoint = modal.closest('.dp-api-ref');
+    const method = endpoint?.dataset.apiMethod || 'GET';
+    const baseUrl = (endpoint?.dataset.apiBaseUrl || '').replace(/\\/+$/, '');
+    let path = endpoint?.dataset.apiPath || '/';
+    const query = new URLSearchParams();
+    const headers = new Headers();
+    const body = {};
+    modal.querySelectorAll('[data-api-param-location]').forEach((input) => {
+      const name = input.dataset.apiParamName || '';
+      const locationName = input.dataset.apiParamLocation || 'query';
+      const value = input.value.trim();
+      if (input.required && !value) throw new Error(name + ' is required.');
+      if (!name || !value) return;
+      if (locationName === 'path') {
+        path = path.split('{' + name + '}').join(encodeURIComponent(input.value));
+      } else if (locationName === 'query') {
+        query.append(name, input.value);
+      } else if (locationName === 'header') {
+        headers.set(name, input.value);
+      } else if (locationName === 'body') {
+        setApiBodyValue(body, name.split('.'), apiBodyValue(input));
+      }
+    });
+    const unresolved = path.match(/\\{([^}]+)\\}/);
+    if (unresolved) throw new Error('Path parameter ' + unresolved[1] + ' needs a value.');
+    const queryString = query.toString();
+    const url = baseUrl + path + (queryString ? '?' + queryString : '');
+    let parsedUrl;
+    try {
+      parsedUrl = new URL(url);
+    } catch {
+      throw new Error('The endpoint baseUrl and path do not form a valid URL.');
+    }
+    if (parsedUrl.protocol !== 'http:' && parsedUrl.protocol !== 'https:') {
+      throw new Error('Try it only supports HTTP and HTTPS endpoints.');
+    }
+    const hasBody = Object.keys(body).length > 0 && method !== 'GET' && method !== 'HEAD';
+    if (hasBody && !headers.has('Content-Type')) headers.set('Content-Type', 'application/json');
+    const init = { method, headers };
+    if (hasBody) init.body = JSON.stringify(body);
+    const headerLines = Array.from(headers.entries()).map(([name, value]) => name + ': ' + value);
+    const requestText = [
+      method + ' ' + url,
+      ...headerLines,
+      ...(hasBody ? ['', JSON.stringify(body, null, 2)] : []),
+    ].join('\\n');
+    return { url, init, requestText };
+  }
+  function showApiTryError(modal, error) {
+    const responseCard = modal.querySelector('[data-api-live-response]');
+    const status = modal.querySelector('[data-api-live-status]');
+    const body = modal.querySelector('[data-api-live-body]');
+    responseCard.hidden = false;
+    status.className = 'tryit-status-bar error';
+    status.textContent = 'Request error';
+    body.textContent = error instanceof Error ? error.message : String(error);
+  }
+  function updateApiTryRequest(modal) {
+    const request = apiRequestFromModal(modal);
+    modal.querySelector('[data-api-request-url]').textContent = request.url;
+    modal.querySelector('[data-api-live-request]').textContent = request.requestText;
+    modal.querySelector('[data-api-live-response]').hidden = true;
+    return request;
+  }
+  async function sendApiTryRequest(button) {
+    const modal = button.closest('[data-api-try-modal]');
+    let request;
+    try {
+      request = updateApiTryRequest(modal);
+    } catch (error) {
+      showApiTryError(modal, error);
+      return;
+    }
+    const responseCard = modal.querySelector('[data-api-live-response]');
+    const status = modal.querySelector('[data-api-live-status]');
+    const body = modal.querySelector('[data-api-live-body]');
+    button.disabled = true;
+    button.textContent = 'Sending…';
+    responseCard.hidden = false;
+    status.className = 'tryit-status-bar';
+    status.textContent = 'Sending request…';
+    body.textContent = '';
+    try {
+      const response = await fetch(request.url, request.init);
+      const responseText = await response.text();
+      let formatted = responseText || '(empty response body)';
+      try {
+        formatted = JSON.stringify(JSON.parse(responseText), null, 2);
+      } catch {}
+      status.className = 'tryit-status-bar ' + (response.ok ? 'success' : 'error');
+      status.textContent = response.status + ' ' + (response.statusText || (response.ok ? 'Success' : 'Error'));
+      body.textContent = formatted;
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      showApiTryError(
+        modal,
+        new Error('The browser could not complete the request. ' + detail + ' Check that the API is reachable and allows requests from ' + location.origin + ' (CORS).'),
+      );
+    } finally {
+      button.disabled = false;
+      button.textContent = 'Send request';
+    }
+  }
+  function closeApiTryModal(modal) {
+    modal.hidden = true;
+    document.body.classList.remove('dxb-tryit-open');
+    modal.closest('.dp-api-ref')?.querySelector('[data-api-try]')?.focus();
+  }
   document.addEventListener('click', (event) => {
     if (event.target.closest('[data-preview-search]')) openSearch();
     if (event.target === searchDialog) closeSearch();
@@ -489,6 +642,30 @@ export function doxbrixDocument(input) {
       const code = card?.querySelector('pre:not([hidden])');
       if (code && navigator.clipboard) navigator.clipboard.writeText(code.innerText);
     }
+    const tryIt = event.target.closest('[data-api-try]');
+    if (tryIt) {
+      const modal = tryIt.closest('.dp-api-ref')?.querySelector('[data-api-try-modal]');
+      if (modal) {
+        modal.hidden = false;
+        document.body.classList.add('dxb-tryit-open');
+        try {
+          updateApiTryRequest(modal);
+        } catch (error) {
+          showApiTryError(modal, error);
+        }
+        modal.querySelector('[data-api-param-location]')?.focus();
+      }
+    }
+    const tryItClose = event.target.closest('[data-api-try-close]');
+    if (tryItClose) closeApiTryModal(tryItClose.closest('[data-api-try-modal]'));
+    if (event.target.matches('[data-api-try-modal]')) closeApiTryModal(event.target);
+    const tryItSend = event.target.closest('[data-api-send]');
+    if (tryItSend) void sendApiTryRequest(tryItSend);
+    const tryItCopy = event.target.closest('[data-api-try-copy]');
+    if (tryItCopy && navigator.clipboard) {
+      const code = tryItCopy.closest('.tryit-code-card')?.querySelector('pre');
+      if (code) navigator.clipboard.writeText(code.innerText);
+    }
     const responseTab = event.target.closest('[data-api-response-tab]');
     if (responseTab) {
       const card = responseTab.closest('.dp-api-resp-card');
@@ -518,8 +695,25 @@ export function doxbrixDocument(input) {
       }
     }
   });
+  document.querySelectorAll('[data-api-try-modal]').forEach((modal) => {
+    modal.addEventListener('input', () => {
+      try {
+        updateApiTryRequest(modal);
+      } catch (error) {
+        showApiTryError(modal, error);
+      }
+    });
+  });
   searchInput?.addEventListener('input', renderSearchResults);
   document.addEventListener('keydown', (event) => {
+    if (event.key === 'Escape') {
+      const openTryIt = document.querySelector('[data-api-try-modal]:not([hidden])');
+      if (openTryIt) {
+        event.preventDefault();
+        closeApiTryModal(openTryIt);
+        return;
+      }
+    }
     if ((event.metaKey || event.ctrlKey) && event.key.toLocaleLowerCase() === 'k') {
       event.preventDefault();
       searchDialog?.hidden ? openSearch() : closeSearch();