sourcey 3.4.11 → 3.5.0

package/README.md

@@ -18,18 +18,19 @@ npx sourcey init
 
 ## Features
 
-- **API reference from OpenAPI** — endpoints, parameters, request/response schemas, auto-generated code samples in 10 languages (cURL, JavaScript, TypeScript, Python, Go, Ruby, Java, PHP, Rust, C#)
-- **MCP server documentation** — tools, resources, prompts rendered as browsable reference with JSON-RPC, TypeScript, and Python code samples. Color-coded method types, annotation badges, connection config cards
-- **Markdown guides with rich components** — steps, cards, accordions, syntax-highlighted code blocks; prose docs alongside your API reference
-- **C++ and Doxygen** — feed Doxygen XML output, get modern searchable API docs. No new parser, no four-tool Breathe/Exhale/Sphinx pipeline
-- **llms.txt generation** — auto-generate llms.txt and llms-full.txt alongside your HTML. Docs serve developers and AI agents from one build
-- **TypeScript config** — `sourcey.config.ts` with `defineConfig()` autocomplete; theme, navbar, CTA buttons, footer
-- **Theme presets** — default (sidebar + TOC), minimal (single column), api-first (Stripe-style three column); colors, fonts, layout dimensions, and custom CSS on top
-- **Vite dev server** — SSR hot reload on every component and CSS change; spec and markdown changes trigger instant refresh
-- **Dark mode** — semantic design tokens, light/dark logo variants, localStorage persistence
-- **Client-side search** — instant fuzzy search across all pages and API operations; Cmd+K
-- **Static HTML output** — no framework runtime, no vendor lock-in. Deploy to GitHub Pages, Vercel, Netlify, S3, anywhere
-- **Open source** — AGPL-3.0. Self-host, fork, extend. Your docs, your infrastructure
+- **OpenAPI 2.0, 3.0, 3.1, and 3.2**: full spec coverage including `QUERY` operations, response summaries, hierarchical tags, `deviceAuthorization` OAuth, `querystring` parameters, and `$self`-aware refs for multi-document APIs
+- **API reference from OpenAPI**: endpoints, parameters, request/response schemas, auto-generated code samples in 10 languages (cURL, JavaScript, TypeScript, Python, Go, Ruby, Java, PHP, Rust, C#)
+- **MCP server documentation**: tools, resources, prompts rendered as browsable reference with JSON-RPC, TypeScript, and Python code samples. Color-coded method types, annotation badges, connection config cards
+- **Markdown guides with rich components**: steps, cards, accordions, syntax-highlighted code blocks; prose docs alongside your API reference
+- **C++ and Doxygen**: feed Doxygen XML output, get modern searchable API docs. No new parser, no four-tool Breathe/Exhale/Sphinx pipeline
+- **llms.txt generation**: auto-generate llms.txt and llms-full.txt alongside your HTML. Docs serve developers and AI agents from one build
+- **TypeScript config**: `sourcey.config.ts` with `defineConfig()` autocomplete; theme, navbar, CTA buttons, footer
+- **Theme presets**: default (sidebar + TOC), minimal (single column), api-first (Stripe-style three column); colors, fonts, layout dimensions, and custom CSS on top
+- **Vite dev server**: SSR hot reload on every component and CSS change; spec and markdown changes trigger instant refresh
+- **Dark mode**: semantic design tokens, light/dark logo variants, localStorage persistence
+- **Client-side search**: instant fuzzy search across all pages and API operations; Cmd+K
+- **Static HTML output**: no framework runtime, no vendor lock-in. Deploy to GitHub Pages, Vercel, Netlify, S3, anywhere
+- **Open source**: AGPL-3.0. Self-host, fork, extend. Your docs, your infrastructure
 
 ### Sourcey vs alternatives
 

package/dist/cli.js

@@ -3,6 +3,7 @@ import { defineCommand, runMain } from "citty";
 import { buildDocs, buildSiteDocs } from "./index.js";
 import { loadConfig } from "./config.js";
 import { init } from "./init.js";
+import { formatChangelogDiagnostic } from "./site-assembly.js";
 import pkg from "../package.json" with { type: "json" };
 const build = defineCommand({
     meta: {
@@ -27,25 +28,38 @@ const build = defineCommand({
             description: "Embeddable output (no html/body wrapper)",
             default: false,
         },
+        config: {
+            type: "string",
+            alias: ["c"],
+            description: "Path to sourcey.config.ts (file or directory containing it)",
+            required: false,
+        },
         quiet: {
             type: "boolean",
             alias: ["q"],
             description: "Suppress output",
             default: false,
         },
+        strictChangelog: {
+            type: "boolean",
+            description: "Treat changelog warnings as build errors",
+            default: false,
+        },
     },
     async run({ args }) {
         const startTime = Date.now();
         try {
             if (args.spec) {
                 if (!args.quiet)
-                    console.log(`\nSourcey — generating docs from ${args.spec}\n`);
+                    console.log(`\nSourcey: generating docs from ${args.spec}\n`);
                 const result = await buildDocs({
                     specSource: args.spec,
                     outputDir: args.output,
                     embeddable: args.embed,
+                    strictChangelog: args.strictChangelog,
                 });
                 if (!args.quiet) {
+                    logChangelogDiagnostics(result.changelogDiagnostics);
                     const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
                     console.log(`  Spec:       ${result.spec.info.title} v${result.spec.info.version}`);
                     console.log(`  Operations: ${result.spec.operations.length}`);
@@ -54,15 +68,17 @@ const build = defineCommand({
                 }
             }
             else {
-                const config = await loadConfig();
+                const config = await loadConfig(args.config);
                 if (!args.quiet)
-                    console.log(`\nSourcey — building documentation site\n`);
+                    console.log(`\nSourcey: building documentation site\n`);
                 const result = await buildSiteDocs({
                     config,
                     outputDir: args.output,
                     embeddable: args.embed,
+                    strictChangelog: args.strictChangelog,
                 });
                 if (!args.quiet) {
+                    logChangelogDiagnostics(result.changelogDiagnostics);
                     const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
                     console.log(`  Pages:  ${result.pageCount}`);
                     console.log(`  Output: ${result.outputDir}`);
@@ -89,11 +105,24 @@ const dev = defineCommand({
             description: "Port to listen on",
             default: "4400",
         },
+        config: {
+            type: "string",
+            alias: ["c"],
+            description: "Path to sourcey.config.ts (file or directory containing it)",
+            required: false,
+        },
+        strictChangelog: {
+            type: "boolean",
+            description: "Treat changelog warnings as dev errors",
+            default: false,
+        },
     },
     async run({ args }) {
         const { startDevServer } = await import("./dev-server.js");
         await startDevServer({
             port: parseInt(args.port, 10),
+            config: args.config,
+            strictChangelog: args.strictChangelog,
         });
     },
 });
@@ -150,11 +179,24 @@ const main = defineCommand({
             return;
         if (args.spec) {
             await build.run({
-                args: { _: [], spec: args.spec, output: "dist", embed: false, quiet: false },
+                args: {
+                    _: [],
+                    spec: args.spec,
+                    output: "dist",
+                    embed: false,
+                    config: undefined,
+                    quiet: false,
+                    strictChangelog: false,
+                },
                 rawArgs: [],
                 cmd: build,
             });
         }
     },
 });
+function logChangelogDiagnostics(diagnostics) {
+    for (const diagnostic of diagnostics) {
+        console.log(`  ${formatChangelogDiagnostic(diagnostic)}`);
+    }
+}
 runMain(main);

package/dist/components/changelog/ChangelogPage.d.ts

@@ -0,0 +1,5 @@
+import type { ChangelogPage as ChangelogPageData } from "../../core/markdown-loader.js";
+export declare function ChangelogPage({ page }: {
+    page: ChangelogPageData;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=ChangelogPage.d.ts.map

package/dist/components/changelog/ChangelogPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangelogPage.d.ts","sourceRoot":"","sources":["../../../src/components/changelog/ChangelogPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGxF,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,gCAyBlE"}

package/dist/components/changelog/ChangelogPage.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { VersionCard } from "./VersionCard.js";
+export function ChangelogPage({ page }) {
+    const versions = page.permalinkVersionId
+        ? page.changelog.versions.filter((version) => version.id === page.permalinkVersionId)
+        : page.changelog.versions;
+    return (_jsxs("div", { class: "sourcey-changelog-page", children: [_jsxs("header", { class: "sourcey-changelog-header", children: [_jsx("div", { class: "mt-0.5 space-y-2.5", children: _jsx("h1", { class: "text-2xl sm:text-3xl text-[rgb(var(--color-gray-900))] tracking-tight dark:text-[rgb(var(--color-gray-200))] font-bold", style: "overflow-wrap: anywhere", children: page.title }) }), page.description && (_jsx("p", { class: "sourcey-changelog-description", children: page.description }))] }), _jsx("div", { class: "sourcey-changelog-list", children: versions.map((version) => (_jsx(VersionCard, { version: version }, version.id))) })] }));
+}

package/dist/components/changelog/EntryList.d.ts

@@ -0,0 +1,5 @@
+import type { NormalizedChangelogEntry } from "../../core/types.js";
+export declare function EntryList({ entries }: {
+    entries: NormalizedChangelogEntry[];
+}): import("preact").JSX.Element | null;
+//# sourceMappingURL=EntryList.d.ts.map

package/dist/components/changelog/EntryList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntryList.d.ts","sourceRoot":"","sources":["../../../src/components/changelog/EntryList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,wBAAgB,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,wBAAwB,EAAE,CAAA;CAAE,uCAU7E"}

package/dist/components/changelog/EntryList.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+export function EntryList({ entries }) {
+    if (!entries.length)
+        return null;
+    return (_jsx("ul", { class: "sourcey-changelog-entry-list", children: entries.map((entry, index) => (_jsx("li", { dangerouslySetInnerHTML: { __html: entry.html } }, `${entry.text}-${index}`))) }));
+}

package/dist/components/changelog/TypeBadge.d.ts

@@ -0,0 +1,6 @@
+import type { ChangelogChangeType } from "../../core/types.js";
+export declare function TypeBadge({ type, label, }: {
+    type: ChangelogChangeType;
+    label: string;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=TypeBadge.d.ts.map

package/dist/components/changelog/TypeBadge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeBadge.d.ts","sourceRoot":"","sources":["../../../src/components/changelog/TypeBadge.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAY/D,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,KAAK,GACN,EAAE;IACD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,gCAEA"}

package/dist/components/changelog/TypeBadge.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+import { Badge } from "../ui/Badge.js";
+const BADGE_CLASS = {
+    added: "sourcey-changelog-badge sourcey-changelog-badge-added",
+    changed: "sourcey-changelog-badge sourcey-changelog-badge-changed",
+    fixed: "sourcey-changelog-badge sourcey-changelog-badge-fixed",
+    removed: "sourcey-changelog-badge sourcey-changelog-badge-removed",
+    deprecated: "sourcey-changelog-badge sourcey-changelog-badge-deprecated",
+    security: "sourcey-changelog-badge sourcey-changelog-badge-security",
+    other: "sourcey-changelog-badge sourcey-changelog-badge-other",
+};
+export function TypeBadge({ type, label, }) {
+    return _jsx(Badge, { class: BADGE_CLASS[type], children: label });
+}

package/dist/components/changelog/VersionCard.d.ts

@@ -0,0 +1,6 @@
+import type { NormalizedChangelogVersion } from "../../core/types.js";
+export declare function VersionCard({ version, permalinkHref, }: {
+    version: NormalizedChangelogVersion;
+    permalinkHref?: string;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=VersionCard.d.ts.map

package/dist/components/changelog/VersionCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionCard.d.ts","sourceRoot":"","sources":["../../../src/components/changelog/VersionCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAoBtE,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,aAAa,GACd,EAAE;IACD,OAAO,EAAE,0BAA0B,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,gCAuCA"}

package/dist/components/changelog/VersionCard.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { Markdown } from "../ui/Markdown.js";
+import { EntryList } from "./EntryList.js";
+import { TypeBadge } from "./TypeBadge.js";
+function formatDate(date) {
+    if (!date)
+        return null;
+    try {
+        return new Intl.DateTimeFormat("en", {
+            year: "numeric",
+            month: "long",
+            day: "numeric",
+            timeZone: "UTC",
+        }).format(new Date(`${date}T00:00:00Z`));
+    }
+    catch {
+        return date;
+    }
+}
+export function VersionCard({ version, permalinkHref, }) {
+    const href = permalinkHref ?? `#${version.id}`;
+    const label = version.version ?? "Unreleased";
+    const formattedDate = formatDate(version.date);
+    return (_jsxs("article", { id: version.id, class: `sourcey-changelog-version${version.version ? "" : " sourcey-changelog-version-unreleased"}`, children: [_jsxs("header", { class: "sourcey-changelog-version-header", children: [_jsxs("div", { class: "sourcey-changelog-version-heading", children: [_jsx("a", { href: href, class: "sourcey-changelog-version-link", children: label }), version.yanked && _jsx("span", { class: "sourcey-changelog-pill sourcey-changelog-pill-yanked", children: "YANKED" }), version.prerelease && _jsx("span", { class: "sourcey-changelog-pill sourcey-changelog-pill-pre", children: "pre" })] }), _jsxs("div", { class: "sourcey-changelog-version-meta", children: [formattedDate && _jsx("time", { dateTime: version.date ?? undefined, children: formattedDate }), version.compareUrl && (_jsx("a", { href: version.compareUrl, target: "_blank", rel: "noopener noreferrer", class: "sourcey-changelog-compare-link", children: "Compare" }))] })] }), version.summary && _jsx(Markdown, { content: version.summary, class: "sourcey-changelog-summary" }), _jsx("div", { class: "sourcey-changelog-sections", children: version.sections.map((section) => (_jsxs("section", { class: "sourcey-changelog-section", children: [_jsx("div", { class: "sourcey-changelog-section-header", children: _jsx(TypeBadge, { type: section.type, label: section.label }) }), _jsx(EntryList, { entries: section.entries })] }, `${version.id}-${section.label}`))) })] }));
+}

package/dist/components/layout/Head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Head.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"AAKA,wBAAgB,IAAI,iCAwEnB"}
+{"version":3,"file":"Head.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"AAKA,wBAAgB,IAAI,iCA8FnB"}

package/dist/components/layout/Head.js

@@ -8,13 +8,25 @@ export function Head() {
     const spec = useContext(SpecContext);
     const options = useContext(OptionsContext);
     const page = useContext(PageContext);
+    const changelogVersion = page.kind === "changelog" && page.changelog.permalinkVersionId
+        ? page.changelog.changelog.versions.find((version) => version.id === page.changelog.permalinkVersionId)
+        : undefined;
     const siteName = site.name || spec.info.title || "";
     const pageTitle = page.kind === "markdown"
         ? (siteName ? `${page.markdown.title} — ${siteName}` : page.markdown.title)
-        : `${siteName} — API Reference`;
+        : page.kind === "changelog"
+            ? (() => {
+                const baseTitle = changelogVersion
+                    ? `${changelogVersion.version ?? "Unreleased"} — ${page.changelog.title}`
+                    : page.changelog.title;
+                return siteName ? `${baseTitle} — ${siteName}` : baseTitle;
+            })()
+            : `${siteName} — API Reference`;
     const pageDescription = page.kind === "markdown"
         ? page.markdown.description || pageTitle
-        : spec.info.description ?? `${siteName} API Documentation`;
+        : page.kind === "changelog"
+            ? changelogVersion?.summary || page.changelog.description || pageTitle
+            : spec.info.summary ?? spec.info.description ?? `${siteName} API Documentation`;
     const nav = useContext(NavigationContext);
     const { colors, fonts, layout } = site.theme;
     // Desktop: h-16 row + h-12 tabs (when multi-tab) = 7rem, or h-16 alone = 4rem.
@@ -44,5 +56,5 @@ export function Head() {
     body { margin: 0; background: rgb(var(--color-background-light)); }
     .dark body { background: rgb(var(--color-background-dark)); }
   `;
-    return (_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { children: pageTitle }), _jsx("meta", { name: "description", content: pageDescription }), _jsx("meta", { name: "generator", content: `Sourcey ${pkg.version}` }), _jsx("meta", { property: "og:title", content: pageTitle }), _jsx("meta", { property: "og:description", content: pageDescription }), _jsx("meta", { property: "og:type", content: "website" }), siteName && _jsx("meta", { property: "og:site_name", content: siteName }), _jsx("meta", { name: "twitter:card", content: "summary" }), _jsx("meta", { name: "twitter:title", content: pageTitle }), _jsx("meta", { name: "twitter:description", content: pageDescription }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), _jsx("link", { rel: "preconnect", href: "https://fonts.googleapis.com" }), _jsx("link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossorigin: "anonymous" }), _jsx("link", { rel: "stylesheet", href: `https://fonts.googleapis.com/css2?family=${encodeURIComponent(fonts.googleFont)}:wght@100..900&display=swap` }), _jsx("style", { dangerouslySetInnerHTML: { __html: themeCSS } }), showLangIconCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: langIconCSS() } }), site.customCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } }), _jsx("script", { dangerouslySetInnerHTML: { __html: `(function(){var t=localStorage.getItem('sourcey-theme');if(t==='dark')document.documentElement.classList.add('dark')})()` } }), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
+    return (_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { children: pageTitle }), _jsx("meta", { name: "description", content: pageDescription }), _jsx("meta", { name: "generator", content: `Sourcey ${pkg.version}` }), options.pageUrl && _jsx("link", { rel: "canonical", href: options.pageUrl }), _jsx("meta", { property: "og:title", content: pageTitle }), _jsx("meta", { property: "og:description", content: pageDescription }), _jsx("meta", { property: "og:type", content: "website" }), siteName && _jsx("meta", { property: "og:site_name", content: siteName }), options.pageUrl && _jsx("meta", { property: "og:url", content: options.pageUrl }), options.ogImageUrl && _jsx("meta", { property: "og:image", content: options.ogImageUrl }), options.ogImageUrl && _jsx("meta", { property: "og:image:width", content: "1200" }), options.ogImageUrl && _jsx("meta", { property: "og:image:height", content: "630" }), options.ogImageUrl && _jsx("meta", { property: "og:image:type", content: "image/png" }), _jsx("meta", { name: "twitter:card", content: options.ogImageUrl ? "summary_large_image" : "summary" }), _jsx("meta", { name: "twitter:title", content: pageTitle }), _jsx("meta", { name: "twitter:description", content: pageDescription }), options.ogImageUrl && _jsx("meta", { name: "twitter:image", content: options.ogImageUrl }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), options.alternateLinks?.map((link) => (_jsx("link", { rel: "alternate", type: link.type, href: link.href, title: link.title }, `${link.type}-${link.href}`))), _jsx("link", { rel: "preconnect", href: "https://fonts.googleapis.com" }), _jsx("link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossorigin: "anonymous" }), _jsx("link", { rel: "stylesheet", href: `https://fonts.googleapis.com/css2?family=${encodeURIComponent(fonts.googleFont)}:wght@100..900&display=swap` }), _jsx("style", { dangerouslySetInnerHTML: { __html: themeCSS } }), showLangIconCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: langIconCSS() } }), site.customCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } }), _jsx("script", { dangerouslySetInnerHTML: { __html: `(function(){var t=localStorage.getItem('sourcey-theme');if(t==='dark')document.documentElement.classList.add('dark')})()` } }), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
 }

package/dist/components/layout/Page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Page.tsx"],"names":[],"mappings":"AAsPA,wBAAgB,IAAI,iCAqCnB"}
+{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Page.tsx"],"names":[],"mappings":"AAoRA,wBAAgB,IAAI,iCAqCnB"}

package/dist/components/layout/Page.js

@@ -11,6 +11,7 @@ import { Tags } from "../openapi/Tags.js";
 import { Definition } from "../openapi/Definition.js";
 import { SocialIcon, socialLabels } from "../ui/SocialIcon.js";
 import { McpConnection } from "../mcp/McpConnection.js";
+import { ChangelogPage } from "../changelog/ChangelogPage.js";
 /**
  * Markdown page content with prose typography.
  */
@@ -22,13 +23,16 @@ function MarkdownPageContent({ page, className = "" }) {
     const eyebrow = activeGroup?.label;
     return (_jsxs("div", { class: `relative grow box-border flex-col w-full mx-auto px-1 min-w-0 ${className}`, id: "content-area", children: [_jsxs("header", { class: "relative leading-none", children: [_jsxs("div", { class: "mt-0.5 space-y-2.5", children: [eyebrow && (_jsx("div", { class: "h-5 text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))] text-sm font-semibold", children: eyebrow })), _jsx("div", { class: "flex flex-col sm:flex-row items-start sm:items-center relative gap-2 min-w-0", children: _jsx("h1", { class: "text-2xl sm:text-3xl text-[rgb(var(--color-gray-900))] tracking-tight dark:text-[rgb(var(--color-gray-200))] font-bold", style: "overflow-wrap: anywhere", children: page.title }) })] }), page.description && (_jsx("div", { class: "page-description mt-2 text-lg prose prose-gray dark:prose-invert", style: "overflow-wrap: anywhere", children: _jsx(Markdown, { content: page.description, inline: true }) }))] }), _jsx("div", { class: "prose prose-gray dark:prose-invert relative mt-8 mb-14 max-w-none", dangerouslySetInnerHTML: { __html: page.html } }), _jsx(PageNavigation, {}), _jsx(ContentFooter, {})] }));
 }
+function ChangelogPageContent({ page, className = "" }) {
+    return (_jsxs("div", { class: `relative grow box-border flex-col w-full mx-auto px-1 min-w-0 ${className}`, id: "content-area", children: [_jsx(ChangelogPage, { page: page }), _jsx(PageNavigation, {}), _jsx(ContentFooter, {})] }));
+}
 /**
  * OpenAPI spec page content.
  */
 function SpecPageContent({ className = "" }) {
     const spec = useContext(SpecContext);
     const serverUrl = spec.servers[0]?.url ?? "/";
-    return (_jsxs("div", { class: `relative grow box-border flex-col w-full mx-auto px-1 min-w-0 ${className}`, id: "content-area", children: [_jsxs("article", { children: [_jsx("header", { class: "mb-8", children: _jsxs("div", { class: "flex items-baseline gap-3", children: [_jsx("h1", { class: "text-2xl sm:text-3xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))] tracking-tight", children: spec.info.title }), _jsxs("span", { class: "text-sm text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]", children: ["v", spec.info.version] })] }) }), _jsx(Introduction, {}), spec.operations[0]?.mcpExtras?.connection && (_jsx(McpConnection, { connection: spec.operations[0].mcpExtras.connection })), _jsx(SecurityDefinitions, {}), _jsx(Tags, { tags: spec.tags, serverUrl: serverUrl }), Object.keys(spec.schemas).length > 0 && (_jsxs("div", { class: "mt-12", children: [_jsx("div", { class: "mb-6", children: _jsx("h1", { class: "text-xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: "Models" }) }), Object.entries(spec.schemas).map(([name, schema]) => (_jsx(Definition, { name: name, schema: schema }, name)))] }))] }), _jsx(ContentFooter, {})] }));
+    return (_jsxs("div", { class: `relative grow box-border flex-col w-full mx-auto px-1 min-w-0 ${className}`, id: "content-area", children: [_jsxs("article", { children: [_jsxs("header", { class: "mb-8", children: [_jsxs("div", { class: "flex items-baseline gap-3", children: [_jsx("h1", { class: "text-2xl sm:text-3xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))] tracking-tight", children: spec.info.title }), _jsxs("span", { class: "text-sm text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]", children: ["v", spec.info.version] })] }), spec.info.summary && (_jsx("p", { class: "mt-2 max-w-2xl text-sm text-[rgb(var(--color-gray-600))] dark:text-[rgb(var(--color-gray-400))]", children: spec.info.summary }))] }), _jsx(Introduction, {}), spec.operations[0]?.mcpExtras?.connection && (_jsx(McpConnection, { connection: spec.operations[0].mcpExtras.connection })), _jsx(SecurityDefinitions, {}), _jsx(Tags, { tags: spec.tags, serverUrl: serverUrl }), Object.keys(spec.schemas).length > 0 && (_jsxs("div", { class: "mt-12", children: [_jsx("div", { class: "mb-6", children: _jsx("h1", { class: "text-xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: "Models" }) }), Object.entries(spec.schemas).map(([name, schema]) => (_jsx(Definition, { name: name, schema: schema }, name)))] }))] }), _jsx(ContentFooter, {})] }));
 }
 function PageNavigation() {
     const nav = useContext(NavigationContext);
@@ -58,8 +62,10 @@ function ContentFooter() {
     // Build "Edit this page" URL when repo + editBranch are configured
     let editUrl;
     const editPath = page.kind === "markdown"
-        ? (page.markdown?.editPath === undefined ? page.markdown?.sourcePath : page.markdown?.editPath)
-        : undefined;
+        ? (page.markdown.editPath === undefined ? page.markdown.sourcePath : page.markdown.editPath)
+        : page.kind === "changelog"
+            ? (page.changelog.editPath === undefined ? page.changelog.sourcePath : page.changelog.editPath)
+            : undefined;
     if (site.repo && site.editBranch && editPath) {
         const repoBase = site.repo.replace(/\/$/, "");
         const basePath = site.editBasePath ? `${site.editBasePath.replace(/^\/|\/$/g, "")}/` : "";
@@ -75,15 +81,15 @@ function ContentFooter() {
 // ---------------------------------------------------------------------------
 function DefaultLayout() {
     const page = useContext(PageContext);
-    return (_jsxs("div", { class: "max-w-[92rem] mx-auto relative px-4 lg:px-8", children: [_jsx(Sidebar, {}), _jsx("main", { id: "docs", class: "pt-[8.5rem] lg:pt-10", children: page.kind === "markdown" ? (_jsxs("div", { class: "flex flex-row-reverse gap-12 box-border w-full", children: [_jsx(TableOfContents, { headings: page.markdown.headings }), _jsx(MarkdownPageContent, { page: page.markdown, className: "lg:pl-[23.7rem] lg:-ml-12 xl:w-[calc(100%-28rem)]" })] })) : (_jsx(SpecPageContent, { className: "lg:pl-[23.7rem] lg:-ml-12" })) })] }));
+    return (_jsxs("div", { class: "max-w-[92rem] mx-auto relative px-4 lg:px-8", children: [_jsx(Sidebar, {}), _jsx("main", { id: "docs", class: "pt-[8.5rem] lg:pt-10", children: page.kind === "markdown" ? (_jsxs("div", { class: "flex flex-row-reverse gap-12 box-border w-full", children: [_jsx(TableOfContents, { headings: page.markdown.headings }), _jsx(MarkdownPageContent, { page: page.markdown, className: "lg:pl-[23.7rem] lg:-ml-12 xl:w-[calc(100%-28rem)]" })] })) : page.kind === "changelog" ? (_jsxs("div", { class: "flex flex-row-reverse gap-12 box-border w-full", children: [_jsx(TableOfContents, { headings: page.changelog.headings }), _jsx(ChangelogPageContent, { page: page.changelog, className: "lg:pl-[23.7rem] lg:-ml-12 xl:w-[calc(100%-28rem)]" })] })) : (_jsx(SpecPageContent, { className: "lg:pl-[23.7rem] lg:-ml-12" })) })] }));
 }
 function MinimalLayout() {
     const page = useContext(PageContext);
-    return (_jsx("div", { class: "max-w-3xl mx-auto relative px-4 lg:px-8", children: _jsx("main", { id: "docs", class: "pt-[8.5rem] lg:pt-10", children: page.kind === "markdown" ? (_jsx(MarkdownPageContent, { page: page.markdown })) : (_jsx(SpecPageContent, {})) }) }));
+    return (_jsx("div", { class: "max-w-3xl mx-auto relative px-4 lg:px-8", children: _jsx("main", { id: "docs", class: "pt-[8.5rem] lg:pt-10", children: page.kind === "markdown" ? (_jsx(MarkdownPageContent, { page: page.markdown })) : page.kind === "changelog" ? (_jsx(ChangelogPageContent, { page: page.changelog })) : (_jsx(SpecPageContent, {})) }) }));
 }
 function ApiFirstLayout() {
     const page = useContext(PageContext);
-    return (_jsxs("div", { class: "max-w-[92rem] mx-auto relative px-4 lg:px-8", children: [_jsx(Sidebar, {}), _jsx("main", { id: "docs", class: "pt-[8.5rem] lg:pt-10", children: page.kind === "markdown" ? (_jsxs("div", { class: "flex flex-row-reverse gap-12 box-border w-full", children: [_jsx(TableOfContents, { headings: page.markdown.headings }), _jsx(MarkdownPageContent, { page: page.markdown, className: "lg:pl-[23.7rem] lg:-ml-12 xl:w-[calc(100%-28rem)]" })] })) : (_jsx(SpecPageContent, { className: "lg:pl-[23.7rem] lg:-ml-12" })) })] }));
+    return (_jsxs("div", { class: "max-w-[92rem] mx-auto relative px-4 lg:px-8", children: [_jsx(Sidebar, {}), _jsx("main", { id: "docs", class: "pt-[8.5rem] lg:pt-10", children: page.kind === "markdown" ? (_jsxs("div", { class: "flex flex-row-reverse gap-12 box-border w-full", children: [_jsx(TableOfContents, { headings: page.markdown.headings }), _jsx(MarkdownPageContent, { page: page.markdown, className: "lg:pl-[23.7rem] lg:-ml-12 xl:w-[calc(100%-28rem)]" })] })) : page.kind === "changelog" ? (_jsxs("div", { class: "flex flex-row-reverse gap-12 box-border w-full", children: [_jsx(TableOfContents, { headings: page.changelog.headings }), _jsx(ChangelogPageContent, { page: page.changelog, className: "lg:pl-[23.7rem] lg:-ml-12 xl:w-[calc(100%-28rem)]" })] })) : (_jsx(SpecPageContent, { className: "lg:pl-[23.7rem] lg:-ml-12" })) })] }));
 }
 // ---------------------------------------------------------------------------
 // Page shell

package/dist/components/openapi/Introduction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Introduction.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Introduction.tsx"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,YAAY,iCAuC3B"}
+{"version":3,"file":"Introduction.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Introduction.tsx"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,YAAY,iCAqC3B"}

package/dist/components/openapi/Introduction.js

@@ -9,5 +9,5 @@ import { Markdown } from "../ui/Markdown.js";
 export function Introduction() {
     const spec = useContext(SpecContext);
     const { info, servers } = spec;
-    return (_jsxs("div", { id: "introduction", "data-traverse-target": "introduction", class: "mb-8", children: [info.termsOfService && (_jsx("p", { class: "mt-4 text-sm text-[rgb(var(--color-gray-500))]", children: _jsx("a", { href: info.termsOfService, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: "Terms of Service" }) })), info.contact?.email && (_jsxs("p", { class: "mt-2 text-sm text-[rgb(var(--color-gray-500))]", children: ["Contact: ", _jsx("a", { href: `mailto:${info.contact.email}`, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: info.contact.email })] })), servers.length > 0 && (_jsxs("div", { class: "mt-6 rounded-[var(--radius)] border border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)] overflow-x-auto", children: [_jsxs("div", { class: "px-4 py-2.5 text-xs font-semibold text-[rgb(var(--color-gray-600))] dark:text-[rgb(var(--color-gray-300))] border-b border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)]", children: ["Base URL", servers.length > 1 ? "s" : ""] }), servers.map((s, i) => (_jsxs("div", { class: `flex items-baseline gap-3 px-4 py-2 ${i > 0 ? "border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]" : ""}`, children: [_jsx("code", { class: "font-mono text-sm text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-200))]", children: s.url }), s.description && (_jsx("span", { class: "text-xs text-[rgb(var(--color-gray-500))]", children: s.description }))] }, i)))] })), info.description && (_jsx(Markdown, { content: info.description, class: "max-w-none mt-8" }))] }));
+    return (_jsxs("div", { id: "introduction", "data-traverse-target": "introduction", class: "mb-8", children: [info.termsOfService && (_jsx("p", { class: "mt-4 text-sm text-[rgb(var(--color-gray-500))]", children: _jsx("a", { href: info.termsOfService, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: "Terms of Service" }) })), info.contact?.email && (_jsxs("p", { class: "mt-2 text-sm text-[rgb(var(--color-gray-500))]", children: ["Contact: ", _jsx("a", { href: `mailto:${info.contact.email}`, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: info.contact.email })] })), servers.length > 0 && (_jsxs("div", { class: "mt-6 rounded-[var(--radius)] border border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)] overflow-x-auto", children: [_jsxs("div", { class: "px-4 py-2.5 text-xs font-semibold text-[rgb(var(--color-gray-600))] dark:text-[rgb(var(--color-gray-300))] border-b border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)]", children: ["Base URL", servers.length > 1 ? "s" : ""] }), servers.map((s, i) => (_jsxs("div", { class: `flex items-baseline gap-3 px-4 py-2 ${i > 0 ? "border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]" : ""}`, children: [_jsx("code", { class: "font-mono text-sm text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-200))]", children: s.url }), s.description && (_jsx("span", { class: "text-xs text-[rgb(var(--color-gray-500))]", children: s.description }))] }, i)))] })), info.description && _jsx(Markdown, { content: info.description, class: "max-w-none mt-8" })] }));
 }

package/dist/components/openapi/MediaTypeDetails.d.ts

@@ -0,0 +1,11 @@
+import type { MediaTypeContent } from "../../core/types.js";
+interface MediaTypeDetailsProps {
+    mediaType: string;
+    content: MediaTypeContent;
+    showLabel?: boolean;
+}
+export declare function MediaTypeDetails({ mediaType, content, showLabel }: MediaTypeDetailsProps): import("preact").JSX.Element | null;
+export declare function firstContentSchema(content?: Record<string, MediaTypeContent>): import("../../core/types.js").NormalizedSchema | undefined;
+export declare function contentMediaTypes(content?: Record<string, MediaTypeContent>): string[];
+export {};
+//# sourceMappingURL=MediaTypeDetails.d.ts.map

package/dist/components/openapi/MediaTypeDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaTypeDetails.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/MediaTypeDetails.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAuB,MAAM,qBAAqB,CAAC;AAIjG,UAAU,qBAAqB;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,SAAS,EAAE,OAAO,EAAE,SAAgB,EAAE,EAAE,qBAAqB,uCAsBhE;AAED,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,8DAI3C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,MAAM,EAAE,CAEtF"}

package/dist/components/openapi/MediaTypeDetails.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { SchemaDatatype } from "../schema/SchemaDatatype.js";
+import { Badge, DeprecatedBadge, RequiredBadge } from "../ui/Badge.js";
+export function MediaTypeDetails({ mediaType, content, showLabel = true }) {
+    const hasEncodings = hasEncodingDetails(content);
+    if (!showLabel && !hasEncodings)
+        return null;
+    return (_jsxs("div", { class: showLabel ? "mt-4" : "", children: [showLabel && (_jsxs("div", { class: "mb-3 flex flex-wrap items-center gap-2", children: [_jsx("code", { class: "text-xs font-medium text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-200))]", children: mediaType }), content.schema && (_jsx("span", { class: "param-type", children: _jsx(SchemaDatatype, { schema: content.schema }) }))] })), hasEncodings && _jsx(EncodingDetails, { content: content })] }));
+}
+export function firstContentSchema(content) {
+    if (!content)
+        return undefined;
+    return Object.values(content).find((mediaType) => mediaType.schema)?.schema;
+}
+export function contentMediaTypes(content) {
+    return content ? Object.keys(content) : [];
+}
+function hasEncodingDetails(content) {
+    return Object.keys(content.encoding ?? {}).length > 0
+        || (content.prefixEncoding?.length ?? 0) > 0
+        || !!content.itemEncoding;
+}
+function EncodingDetails({ content }) {
+    const namedEntries = Object.entries(content.encoding ?? {});
+    const positionalEntries = [
+        ...(content.prefixEncoding ?? []).map((encoding, index) => ({
+            name: `[${index}]`,
+            encoding,
+        })),
+        ...(content.itemEncoding ? [{ name: "[n]", encoding: content.itemEncoding }] : []),
+    ];
+    if (!namedEntries.length && !positionalEntries.length)
+        return null;
+    return (_jsxs("div", { class: "mt-4", children: [_jsx("div", { class: "text-xs font-semibold uppercase tracking-[0.14em] text-[rgb(var(--color-gray-500))]", children: "Encoding" }), namedEntries.length > 0 && (_jsx(EncodingList, { className: "params-list mt-2", entries: namedEntries.map(([name, encoding]) => ({ name, encoding })) })), positionalEntries.length > 0 && (_jsxs("div", { class: namedEntries.length > 0 ? "mt-4" : "mt-2", children: [_jsx("div", { class: "text-xs font-medium text-[rgb(var(--color-gray-500))]", children: "Ordered Parts" }), _jsx(EncodingList, { className: "params-list mt-2", entries: positionalEntries })] }))] }));
+}
+function EncodingList({ entries, className = "params-list" }) {
+    return (_jsx("div", { class: className, children: entries.map((entry) => (_jsx(EncodingItem, { name: entry.name, encoding: entry.encoding }, entry.name))) }));
+}
+function EncodingItem({ name, encoding }) {
+    const headerEntries = Object.entries(encoding.headers ?? {});
+    const nestedEntries = [
+        ...(encoding.prefixEncoding ?? []).map((entry, index) => ({
+            name: `[${index}]`,
+            encoding: entry,
+        })),
+        ...(encoding.itemEncoding ? [{ name: "[n]", encoding: encoding.itemEncoding }] : []),
+    ];
+    return (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: name }), encoding.contentType && (_jsx("span", { class: "param-type", children: _jsx("code", { class: "text-xs font-medium text-[rgb(var(--color-gray-700))] dark:text-[rgb(var(--color-gray-300))]", children: encoding.contentType }) })), encoding.style && _jsxs(Badge, { children: ["style ", encoding.style] }), encoding.explode !== undefined && _jsxs(Badge, { children: ["explode ", String(encoding.explode)] }), encoding.allowReserved !== undefined && (_jsxs(Badge, { children: ["allowReserved ", String(encoding.allowReserved)] }))] }), headerEntries.length > 0 && (_jsxs("div", { class: "mt-3", children: [_jsx("div", { class: "text-xs font-medium text-[rgb(var(--color-gray-500))]", children: "Headers" }), _jsx("div", { class: "params-list mt-2", children: headerEntries.map(([headerName, header]) => (_jsx(EncodingHeader, { name: headerName, header: header }, headerName))) })] })), nestedEntries.length > 0 && (_jsxs("div", { class: "mt-3", children: [_jsx("div", { class: "text-xs font-medium text-[rgb(var(--color-gray-500))]", children: "Nested Encoding" }), _jsx(EncodingList, { className: "params-list mt-2", entries: nestedEntries })] }))] }));
+}
+function EncodingHeader({ name, header }) {
+    const schema = header.schema ?? firstContentSchema(header.content);
+    const mediaTypes = contentMediaTypes(header.content);
+    return (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: name }), schema && (_jsx("span", { class: "param-type", children: _jsx(SchemaDatatype, { schema: schema }) })), mediaTypes.length > 0 && (_jsx("span", { class: "param-type", children: _jsx("code", { class: "text-xs font-medium text-[rgb(var(--color-gray-700))] dark:text-[rgb(var(--color-gray-300))]", children: mediaTypes.join(", ") }) })), header.required && _jsx(RequiredBadge, {}), header.deprecated && _jsx(DeprecatedBadge, {})] }), header.description && (_jsx("div", { class: "param-description", children: header.description }))] }));
+}

package/dist/components/openapi/Parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Parameters.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Parameters.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK/D,UAAU,eAAe;IACvB,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,wBAAgB,UAAU,CAAC,EAAE,UAAU,EAAE,EAAE,eAAe,uCA2BzD"}
+{"version":3,"file":"Parameters.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Parameters.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAM/D,UAAU,eAAe;IACvB,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,wBAAgB,UAAU,CAAC,EAAE,UAAU,EAAE,EAAE,eAAe,uCAgDzD"}

package/dist/components/openapi/Parameters.js

@@ -2,8 +2,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
 import { SchemaDatatype } from "../schema/SchemaDatatype.js";
 import { RequiredBadge, DeprecatedBadge } from "../ui/Badge.js";
 import { Markdown } from "../ui/Markdown.js";
+import { MediaTypeDetails, contentMediaTypes, firstContentSchema } from "./MediaTypeDetails.js";
 export function Parameters({ parameters }) {
     if (!parameters.length)
         return null;
-    return (_jsx("div", { class: "params-list", children: parameters.map((param) => (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: param.name }), param.schema && (_jsx("span", { class: "param-type", children: _jsx(SchemaDatatype, { schema: param.schema }) })), param.required && _jsx(RequiredBadge, {}), param.deprecated && _jsx(DeprecatedBadge, {}), _jsx("span", { class: "param-in", children: param.in })] }), param.description && (_jsx("div", { class: "param-description", children: _jsx(Markdown, { content: param.description, class: "prose-sm" }) }))] }, `${param.in}-${param.name}`))) }));
+    return (_jsx("div", { class: "params-list", children: parameters.map((param) => {
+            const schema = param.schema ?? firstContentSchema(param.content);
+            const mediaTypes = contentMediaTypes(param.content);
+            return (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header", children: [_jsx("code", { class: "param-name", children: param.name }), schema && (_jsx("span", { class: "param-type", children: _jsx(SchemaDatatype, { schema: schema }) })), mediaTypes.length > 0 && (_jsx("span", { class: "param-type", children: _jsx("code", { class: "text-xs font-medium text-[rgb(var(--color-gray-700))] dark:text-[rgb(var(--color-gray-300))]", children: mediaTypes.join(", ") }) })), param.required && _jsx(RequiredBadge, {}), param.deprecated && _jsx(DeprecatedBadge, {}), _jsx("span", { class: "param-in", children: param.in })] }), (param.description || mediaTypes.length > 0) && (_jsxs("div", { class: "param-description", children: [param.description && (_jsx(Markdown, { content: param.description, class: "prose-sm" })), param.content && Object.entries(param.content).map(([mediaType, content]) => (_jsx(MediaTypeDetails, { mediaType: mediaType, content: content, showLabel: true }, mediaType)))] }))] }, `${param.in}-${param.name}`));
+        }) }));
 }

package/dist/components/openapi/RequestBody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequestBody.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/RequestBody.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAKjE,UAAU,gBAAgB;IACxB,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,gBAAgB,uCAkBrD;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,uBAAuB,uCAQnE"}
+{"version":3,"file":"RequestBody.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/RequestBody.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAMjE,UAAU,gBAAgB;IACxB,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,gBAAgB,uCA4BrD;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,qBAAqB,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,EAAE,uBAAuB,uCAQnE"}

package/dist/components/openapi/RequestBody.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
 import { SchemaView } from "../schema/SchemaView.js";
 import { ExampleView } from "../schema/ExampleView.js";
 import { Markdown } from "../ui/Markdown.js";
+import { MediaTypeDetails } from "./MediaTypeDetails.js";
 /**
  * Request body content (rendered in the main content column).
  */
@@ -9,7 +10,10 @@ export function RequestBody({ body }) {
     const mediaTypes = Object.entries(body.content);
     if (!mediaTypes.length)
         return null;
-    return (_jsx("div", { children: mediaTypes.map(([mediaType, content]) => (_jsxs("div", { children: [body.description && (_jsx("div", { class: "mb-4 text-sm text-[rgb(var(--color-gray-700))] dark:text-[rgb(var(--color-gray-400))]", children: _jsx(Markdown, { content: body.description }) })), content.schema && _jsx(SchemaView, { schema: content.schema })] }, mediaType))) }));
+    return (_jsxs("div", { children: [body.description && (_jsx("div", { class: "mb-4 text-sm text-[rgb(var(--color-gray-700))] dark:text-[rgb(var(--color-gray-400))]", children: _jsx(Markdown, { content: body.description }) })), mediaTypes.map(([mediaType, content]) => (_jsxs("div", { class: mediaTypes.length > 1 ? "mt-8 first:mt-0" : "", children: [_jsx(MediaTypeDetails, { mediaType: mediaType, content: content, showLabel: mediaTypes.length > 1
+                            || Object.keys(content.encoding ?? {}).length > 0
+                            || (content.prefixEncoding?.length ?? 0) > 0
+                            || !!content.itemEncoding }), content.schema && _jsx(SchemaView, { schema: content.schema })] }, mediaType)))] }));
 }
 /**
  * Request body example (rendered in the sticky code panel).

package/dist/components/openapi/Responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Responses.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Responses.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAS9D,UAAU,cAAc;IACtB,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAUD;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,cAAc,uCA6B1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,EAAE,EAAE,cAAc,uCAiE9D"}
+{"version":3,"file":"Responses.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Responses.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAS9D,UAAU,cAAc;IACtB,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAUD;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,SAAS,EAAE,EAAE,cAAc,uCAoC1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,EAAE,EAAE,cAAc,uCAiE9D"}

package/dist/components/openapi/Responses.js

@@ -23,7 +23,7 @@ function statusColorClass(code) {
 export function ResponsesCopy({ responses }) {
     if (!responses.length)
         return null;
-    return (_jsx("div", { class: "params-list", children: responses.map((r) => (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header font-mono text-sm", children: [_jsx("span", { class: `px-1.5 py-0.5 rounded-md text-xs font-bold ${statusColorClass(r.statusCode)}`, children: r.statusCode }), _jsx("span", { class: "font-medium text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: httpStatusText(r.statusCode) }), r.content && (_jsx("span", { class: "param-type", children: renderResponseType(r) }))] }), r.description && (_jsx("div", { class: "param-description", children: _jsx(Markdown, { content: r.description, class: "prose-sm" }) }))] }, r.statusCode))) }));
+    return (_jsx("div", { class: "params-list", children: responses.map((r) => (_jsxs("div", { class: "param-item", children: [_jsxs("div", { class: "param-header font-mono text-sm", children: [_jsx("span", { class: `px-1.5 py-0.5 rounded-md text-xs font-bold ${statusColorClass(r.statusCode)}`, children: r.statusCode }), _jsx("span", { class: "font-medium text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: httpStatusText(r.statusCode) }), r.content && (_jsx("span", { class: "param-type", children: renderResponseType(r) }))] }), (r.summary || r.description) && (_jsxs("div", { class: "param-description", children: [r.summary && (_jsx("p", { class: "text-sm font-medium text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: r.summary })), r.description && (_jsx(Markdown, { content: r.description, class: "prose-sm" }))] }))] }, r.statusCode))) }));
 }
 /**
  * Response examples with status code tabs on the code block card.

package/dist/components/openapi/Security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Security.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Security.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D,UAAU,aAAa;IACrB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,uCA8CvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,wCA+ElC"}
+{"version":3,"file":"Security.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Security.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK/D,UAAU,aAAa;IACrB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,aAAa,uCA+CvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,wCA8FlC"}