jamdesk 1.1.193 → 1.1.195

package/dist/__tests__/unit/frontmatter-sync.test.d.ts

@@ -1,7 +1,8 @@
 /**
  * Sync Verification Test
  *
- * Ensures the frontmatter-utils.ts file stays in sync with build-service.
+ * Ensures the frontmatter-utils.ts file and the frontmatter-text.ts leaf it
+ * re-exports stay in sync with build-service.
  * Catches drift if someone forgets to run `npm run vendor`.
  */
 export {};

package/dist/__tests__/unit/frontmatter-sync.test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter-sync.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/frontmatter-sync.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"frontmatter-sync.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/frontmatter-sync.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/unit/frontmatter-sync.test.js

@@ -1,7 +1,8 @@
 /**
  * Sync Verification Test
  *
- * Ensures the frontmatter-utils.ts file stays in sync with build-service.
+ * Ensures the frontmatter-utils.ts file and the frontmatter-text.ts leaf it
+ * re-exports stay in sync with build-service.
  * Catches drift if someone forgets to run `npm run vendor`.
  */
 import { describe, it, expect } from 'vitest';
@@ -20,7 +21,21 @@ describe('frontmatter-utils sync verification', () => {
         const cliWithoutHeader = cliContent.replace(/^\/\*\*\n \* Frontmatter Utilities[\s\S]*?AUTO-SYNCED[\s\S]*?\*\/\n\n/, '');
         // Remove the original header from build-service version
         const buildServiceWithoutHeader = buildServiceContent.replace(/^\/\*\*[\s\S]*?\*\/\s*\n/, '');
-        expect(cliWithoutHeader).toBe(buildServiceWithoutHeader);
+        // vendor.js rewrites exactly one relative specifier on the way in: src/lib
+        // is compiled under NodeNext, which demands the extension build-service
+        // cannot write (Turbopack resolves relative specifiers literally). Asserted
+        // rather than merely normalised, so the transform cannot silently stop.
+        expect(cliWithoutHeader).toContain("from './frontmatter-text.js'");
+        expect(cliWithoutHeader.replace("from './frontmatter-text.js'", "from './frontmatter-text'"))
+            .toBe(buildServiceWithoutHeader);
+    });
+    it('CLI frontmatter-text matches build-service source byte for byte', () => {
+        // frontmatter-utils re-exports frontmatterText from this leaf, so the copy
+        // is load-bearing for the CLI build, not just for behaviour parity. Copied
+        // without a banner, so this comparison is exact.
+        const cliPath = path.join(__dirname, '../../lib/frontmatter-text.ts');
+        const buildServicePath = path.join(__dirname, '../../../../build-service/lib/frontmatter-text.ts');
+        expect(fs.readFileSync(cliPath, 'utf-8')).toBe(fs.readFileSync(buildServicePath, 'utf-8'));
     });
 });
 //# sourceMappingURL=frontmatter-sync.test.js.map

package/dist/__tests__/unit/frontmatter-sync.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter-sync.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/frontmatter-sync.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;QACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oDAAoD,CAAC,CAAC;QAEpG,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,mBAAmB,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAEvE,gEAAgE;QAChE,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,uEAAuE,EAAE,EAAE,CAAC,CAAC;QAEzH,wDAAwD;QACxD,MAAM,yBAAyB,GAAG,mBAAmB,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QAE9F,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"frontmatter-sync.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/frontmatter-sync.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;QACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oDAAoD,CAAC,CAAC;QAEpG,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,mBAAmB,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAEvE,gEAAgE;QAChE,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,uEAAuE,EAAE,EAAE,CAAC,CAAC;QAEzH,wDAAwD;QACxD,MAAM,yBAAyB,GAAG,mBAAmB,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QAE9F,2EAA2E;QAC3E,wEAAwE;QACxE,4EAA4E;QAC5E,wEAAwE;QACxE,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACnE,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,8BAA8B,EAAE,2BAA2B,CAAC,CAAC;aAC1F,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,2EAA2E;QAC3E,2EAA2E;QAC3E,iDAAiD;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;QACtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mDAAmD,CAAC,CAAC;QAEnG,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/frontmatter-text.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Coerce a frontmatter value to the string its text consumers require.
+ *
+ * Frontmatter is whatever YAML decided, not what the author meant:
+ * `description: 404` parses to a number and `description: 2026-01-01` to a
+ * Date. Both reach surfaces that accept only strings — react-markdown asserts
+ * on `children` and THROWS in development, `.trim()`/`.replace()` throw
+ * outright, and `<meta name="description">` would carry `[object Object]`.
+ *
+ * The same is true of a dereferenced OpenAPI spec, which is why ApiMarkdown
+ * calls this too: the ISR loader runs SwaggerParser.dereference, NOT .validate
+ * (lib/openapi-isr.ts), so a `description:` YAML read as a number or a Date is
+ * never rejected on the way in and arrives at the renderer as-is.
+ *
+ * A Date is rendered back as the ISO date the author typed rather than through
+ * String(): YAML anchors a bare date at UTC midnight, so String() formats it in
+ * local time, which anywhere west of UTC prints the PREVIOUS day.
+ *
+ * Canonical here rather than beside any one caller: the renderer, the search
+ * index, and llms-full.txt each parse frontmatter independently, and a copy per
+ * consumer is how three of them ended up without the Date branch.
+ */
+export declare function frontmatterText(value: unknown): string;
+//# sourceMappingURL=frontmatter-text.d.ts.map

package/dist/lib/frontmatter-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-text.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter-text.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD"}

package/dist/lib/frontmatter-text.js

@@ -0,0 +1,41 @@
+// builder/build-service/lib/frontmatter-text.ts
+//
+// One function, deliberately in an import-free leaf module of its own.
+//
+// It started in frontmatter-utils.ts and still re-exports from there, so every
+// existing caller is untouched. It had to move because ApiMarkdown.tsx — the
+// single renderer for every description an OpenAPI spec carries — needs the
+// same coercion and is a `'use client'` module: importing frontmatter-utils
+// would drag gray-matter across the client boundary and into the browser
+// bundle. A copy in the component instead is how the Date branch went missing
+// from three frontmatter consumers before this function was made canonical.
+/**
+ * Coerce a frontmatter value to the string its text consumers require.
+ *
+ * Frontmatter is whatever YAML decided, not what the author meant:
+ * `description: 404` parses to a number and `description: 2026-01-01` to a
+ * Date. Both reach surfaces that accept only strings — react-markdown asserts
+ * on `children` and THROWS in development, `.trim()`/`.replace()` throw
+ * outright, and `<meta name="description">` would carry `[object Object]`.
+ *
+ * The same is true of a dereferenced OpenAPI spec, which is why ApiMarkdown
+ * calls this too: the ISR loader runs SwaggerParser.dereference, NOT .validate
+ * (lib/openapi-isr.ts), so a `description:` YAML read as a number or a Date is
+ * never rejected on the way in and arrives at the renderer as-is.
+ *
+ * A Date is rendered back as the ISO date the author typed rather than through
+ * String(): YAML anchors a bare date at UTC midnight, so String() formats it in
+ * local time, which anywhere west of UTC prints the PREVIOUS day.
+ *
+ * Canonical here rather than beside any one caller: the renderer, the search
+ * index, and llms-full.txt each parse frontmatter independently, and a copy per
+ * consumer is how three of them ended up without the Date branch.
+ */
+export function frontmatterText(value) {
+    if (value === null || value === undefined || value === '')
+        return '';
+    if (value instanceof Date)
+        return value.toISOString().slice(0, 10);
+    return String(value);
+}
+//# sourceMappingURL=frontmatter-text.js.map

package/dist/lib/frontmatter-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-text.js","sourceRoot":"","sources":["../../src/lib/frontmatter-text.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,uEAAuE;AACvE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAE5E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACrE,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/lib/frontmatter-utils.d.ts

@@ -22,22 +22,5 @@ export declare function parseFrontmatterLenient(content: string): {
     };
     content: string;
 };
-/**
- * Coerce a frontmatter value to the string its text consumers require.
- *
- * Frontmatter is whatever YAML decided, not what the author meant:
- * `description: 404` parses to a number and `description: 2026-01-01` to a
- * Date. Both reach surfaces that accept only strings — react-markdown asserts
- * on `children` and THROWS in development, `.trim()`/`.replace()` throw
- * outright, and `<meta name="description">` would carry `[object Object]`.
- *
- * A Date is rendered back as the ISO date the author typed rather than through
- * String(): YAML anchors a bare date at UTC midnight, so String() formats it in
- * local time, which anywhere west of UTC prints the PREVIOUS day.
- *
- * Canonical here rather than beside any one caller: the renderer, the search
- * index, and llms-full.txt each parse frontmatter independently, and a copy per
- * consumer is how three of them ended up without the Date branch.
- */
-export declare function frontmatterText(value: unknown): string;
+export { frontmatterText } from './frontmatter-text.js';
 //# sourceMappingURL=frontmatter-utils.d.ts.map

package/dist/lib/frontmatter-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter-utils.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA8D7D;AAqBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IAExD,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB,CAIA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD"}
+{"version":3,"file":"frontmatter-utils.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA8D7D;AAqBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IAExD,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB,CAIA;AAMD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/frontmatter-utils.js

@@ -97,28 +97,9 @@ export function parseFrontmatterLenient(content) {
     const { data, content: rawContent } = matter(processed);
     return { data, content: rawContent };
 }
-/**
- * Coerce a frontmatter value to the string its text consumers require.
- *
- * Frontmatter is whatever YAML decided, not what the author meant:
- * `description: 404` parses to a number and `description: 2026-01-01` to a
- * Date. Both reach surfaces that accept only strings — react-markdown asserts
- * on `children` and THROWS in development, `.trim()`/`.replace()` throw
- * outright, and `<meta name="description">` would carry `[object Object]`.
- *
- * A Date is rendered back as the ISO date the author typed rather than through
- * String(): YAML anchors a bare date at UTC midnight, so String() formats it in
- * local time, which anywhere west of UTC prints the PREVIOUS day.
- *
- * Canonical here rather than beside any one caller: the renderer, the search
- * index, and llms-full.txt each parse frontmatter independently, and a copy per
- * consumer is how three of them ended up without the Date branch.
- */
-export function frontmatterText(value) {
-    if (value === null || value === undefined || value === '')
-        return '';
-    if (value instanceof Date)
-        return value.toISOString().slice(0, 10);
-    return String(value);
-}
+// frontmatterText lives in its own import-free leaf so ApiMarkdown.tsx (a
+// `'use client'` module) can share it without pulling gray-matter into the
+// browser bundle. Re-exported here because this is where every caller expects
+// it, and a second import path would be a second thing to keep in step.
+export { frontmatterText } from './frontmatter-text.js';
 //# sourceMappingURL=frontmatter-utils.js.map

package/dist/lib/frontmatter-utils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.193",
+  "version": "1.1.195",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/components/mdx/ApiMarkdown.tsx

@@ -3,6 +3,7 @@
 import type React from 'react';
 import ReactMarkdown from 'react-markdown';
 import remarkGfm from 'remark-gfm';
+import { frontmatterText } from '@/lib/frontmatter-text';
 
 /**
  * The single markdown renderer for every description an OpenAPI spec carries.
@@ -23,13 +24,23 @@ import remarkGfm from 'remark-gfm';
  *
  * `singleTilde: false` keeps `~x~` from becoming strikethrough, so a lone tilde
  * in a path or a range survives.
+ *
+ * `children` is typed `unknown` on purpose. Every call site hands us a
+ * `description` straight out of a dereferenced spec, and the ISR loader runs
+ * SwaggerParser.dereference, NOT .validate (lib/openapi-isr.ts) — so YAML's
+ * reading of `description: 404` (a number) or `description: 2026-01-01` (a
+ * Date) is never rejected on the way in. react-markdown asserts on a non-string
+ * `children` and THROWS, which on a docs page means a 500 for a spec that
+ * merely forgot its quotes. Narrowing at this one boundary covers all thirteen
+ * description sites at once; a `string` annotation here would only have made
+ * the compiler agree with a promise the data does not keep.
  */
 export function ApiMarkdown({
   children,
   className,
   style,
 }: {
-  children: string;
+  children: unknown;
   className: string;
   /** The playground panel styles exclusively with inline CSS variables (see
    *  PlaygroundParamForm's header), so it has no class to pass. Optional so
@@ -39,10 +50,15 @@ export function ApiMarkdown({
   return (
     <div className={className} style={style}>
       <ReactMarkdown remarkPlugins={[[remarkGfm, { singleTilde: false }]]}>
-        {children}
+        {frontmatterText(children)}
       </ReactMarkdown>
     </div>
   );
 }
 
-export { API_DESCRIPTION_PROSE, MARKDOWN_BLOCK_STRUCTURE } from './markdown-classes';
+// Re-exported so a call site takes the renderer and its typography in one
+// import. MARKDOWN_BLOCK_STRUCTURE is deliberately NOT among them: its only
+// consumer is render-doc-page.tsx, a server module, and routing a constant
+// through this `'use client'` file would drag the component across the
+// boundary with it.
+export { API_DESCRIPTION_PROSE, OPERATION_DESCRIPTION_PROSE } from './markdown-classes';

package/vendored/components/mdx/OpenApiEndpoint.tsx

@@ -7,7 +7,7 @@ import { ApiEndpoint } from './ApiEndpoint';
 import { CodePanel, CodePanelTab, DelayedSpinner } from '../ui/CodePanel';
 import { useShikiHighlightMultiple } from '@/hooks/useShikiHighlight';
 import { preloadHighlighter } from '@/lib/shiki-client';
-import { ApiMarkdown, API_DESCRIPTION_PROSE } from './ApiMarkdown';
+import { ApiMarkdown, API_DESCRIPTION_PROSE, OPERATION_DESCRIPTION_PROSE } from './ApiMarkdown';
 import { resolveServerUrl } from '@/lib/openapi/resolve-server-url';
 
 
@@ -983,7 +983,7 @@ export function OpenApiEndpoint({
       
       {/* Description only - summary is shown as page title (h1) */}
       {description && !descriptionAlreadyShown && (
-        <ApiMarkdown className="mt-4 text-sm text-[var(--color-text-secondary)] leading-relaxed prose prose-sm dark:prose-invert max-w-none [&>p]:mb-3 [&>ul]:my-2 [&>ol]:my-2 [&>h2]:text-base [&>h2]:font-semibold [&>h2]:mt-4 [&>h2]:mb-2 [&>h3]:text-sm [&>h3]:font-semibold [&>h3]:mt-3 [&>h3]:mb-2 [&_li]:my-0.5 [&_code]:text-xs [&_code]:bg-[var(--color-bg-tertiary)] [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:rounded [&_pre]:bg-[var(--color-bg-tertiary)] [&_pre]:p-3 [&_pre]:rounded-lg [&_pre]:text-xs [&_pre]:overflow-x-auto [&_strong]:text-[var(--color-text-primary)] [&_table]:w-full [&_table]:my-3 [&_table]:text-xs [&_table]:border-collapse [&_table]:block [&_table]:overflow-x-auto [&_th]:text-left [&_th]:font-semibold [&_th]:p-2 [&_th]:border [&_th]:border-[var(--color-border)] [&_td]:p-2 [&_td]:border [&_td]:border-[var(--color-border)] [&_td]:align-top">
+        <ApiMarkdown className={`mt-4 text-sm text-[var(--color-text-secondary)] leading-relaxed prose ${OPERATION_DESCRIPTION_PROSE}`}>
           {description}
         </ApiMarkdown>
       )}

package/vendored/components/mdx/markdown-classes.ts

@@ -31,6 +31,29 @@ export const MARKDOWN_BLOCK_STRUCTURE = [
   '[&_pre]:bg-[var(--color-bg-tertiary)] [&_pre]:p-3 [&_pre]:rounded-lg [&_pre]:text-xs [&_pre]:overflow-x-auto',
   '[&_pre_code]:bg-transparent [&_pre_code]:p-0',
   '[&>blockquote]:border-l-2 [&>blockquote]:border-[var(--color-border)] [&>blockquote]:pl-3 [&>blockquote]:my-2',
+  // The four below matter at the SUBTITLE sites and nowhere else, which is not
+  // obvious and is worth stating: every endpoint description renders inside the
+  // page's own `.prose` wrapper (render-doc-page.tsx `proseClasses`), and
+  // app/globals.css imports themes/base.css UNLAYERED while Tailwind utilities
+  // land in `@layer utilities` — so `.prose li > p`, `.prose hr` and friends
+  // outrank anything here regardless of specificity. The subtitle sits in the
+  // <header>, outside that wrapper, with only preflight underneath it.
+  //
+  // Markdown wraps list items in <p> the moment a list has a blank line between
+  // items ("loose"), and an unstyled block <p> inside an <li> reads as a broken
+  // list — which is how a loose list in a page description has always rendered.
+  // Values match the `.prose` rules they shadow, so the endpoint sites are
+  // unaffected either way.
+  '[&_li>p]:m-0 [&_li>p]:inline',
+  '[&_li>p+p]:block [&_li>p+p]:mt-2',
+  // No `border-0` alongside: preflight already gives an <hr> a top border and
+  // no others, so the shorthand would only add a shorthand-vs-longhand pair
+  // whose winner is Tailwind's emission order rather than anything stated here.
+  '[&_hr]:border-t [&_hr]:border-[var(--color-border)] [&_hr]:my-6',
+  // Overflow protection only — deliberately not `.prose img`'s `display: block`
+  // and 1rem/2rem margins, which would knock a small inline badge (a normal
+  // thing to put in a description) onto a line of its own.
+  '[&_img]:max-w-full [&_img]:h-auto',
   // `block` + `overflow-x-auto`: a wide table must scroll inside its own
   // container, never widen the page — mobile is 375px.
   '[&_table]:w-full [&_table]:my-2 [&_table]:text-xs [&_table]:border-collapse [&_table]:block [&_table]:overflow-x-auto',
@@ -49,3 +72,40 @@ export const API_DESCRIPTION_PROSE = [
   '[&>h3]:text-sm [&>h3]:font-semibold [&>h3]:mt-2 [&>h3]:mb-1.5',
   '[&_code]:text-xs [&_code]:bg-[var(--color-bg-tertiary)] [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:rounded',
 ].join(' ');
+
+/**
+ * The operation description at the top of an endpoint block — the one site that
+ * gets a full reading column rather than a dense row.
+ *
+ * Differs from API_DESCRIPTION_PROSE in exactly one utility: `h2` keeps a larger
+ * scale than `h3`, because a long operation description is the one description
+ * that actually carries a heading hierarchy worth seeing.
+ *
+ * It used to spell out its own block structure inline instead, and that is how
+ * it ended up the only description site without `[&_.task-list-item]:list-none`
+ * — a GFM task list rendered a bullet AND a checkbox there while rendering
+ * correctly everywhere else on the same page. Sharing the structure and varying
+ * only the scale is what keeps that from recurring.
+ *
+ * The call site keeps a bare `prose` alongside this constant, and MUST. It is
+ * tempting to read as redundant — the page already wraps its content in
+ * `.prose` (render-doc-page.tsx `proseClasses`), so every `.prose <descendant>`
+ * rule reaches the element anyway — but `.prose` also sets `font-size` on the
+ * element it matches (themes/jam/variables.css, themes/pulsar/variables.css),
+ * and that is a different question from inheritance: the div carries `text-sm`,
+ * and `.prose` only outranks it by being UNLAYERED where Tailwind utilities sit
+ * in `@layer utilities`. Drop the class and `text-sm` wins, taking the
+ * operation description from 16px to 14px on the default theme. The themes that
+ * set no `.prose` font-size (base, nebula, halo) are the reason `text-sm` has to
+ * stay too — it is the fallback, not the intended size.
+ *
+ * `prose-sm` and `dark:prose-invert` went with the inline version and are not
+ * coming back: they are Tailwind Typography modifiers and this build has no
+ * such plugin, so they never matched anything.
+ */
+export const OPERATION_DESCRIPTION_PROSE = [
+  MARKDOWN_BLOCK_STRUCTURE,
+  '[&>h2]:text-base [&>h2]:font-semibold [&>h2]:mt-4 [&>h2]:mb-2',
+  '[&>h3]:text-sm [&>h3]:font-semibold [&>h3]:mt-3 [&>h3]:mb-2',
+  '[&_code]:text-xs [&_code]:bg-[var(--color-bg-tertiary)] [&_code]:px-1.5 [&_code]:py-0.5 [&_code]:rounded',
+].join(' ');

package/vendored/lib/frontmatter-text.ts

@@ -0,0 +1,39 @@
+// builder/build-service/lib/frontmatter-text.ts
+//
+// One function, deliberately in an import-free leaf module of its own.
+//
+// It started in frontmatter-utils.ts and still re-exports from there, so every
+// existing caller is untouched. It had to move because ApiMarkdown.tsx — the
+// single renderer for every description an OpenAPI spec carries — needs the
+// same coercion and is a `'use client'` module: importing frontmatter-utils
+// would drag gray-matter across the client boundary and into the browser
+// bundle. A copy in the component instead is how the Date branch went missing
+// from three frontmatter consumers before this function was made canonical.
+
+/**
+ * Coerce a frontmatter value to the string its text consumers require.
+ *
+ * Frontmatter is whatever YAML decided, not what the author meant:
+ * `description: 404` parses to a number and `description: 2026-01-01` to a
+ * Date. Both reach surfaces that accept only strings — react-markdown asserts
+ * on `children` and THROWS in development, `.trim()`/`.replace()` throw
+ * outright, and `<meta name="description">` would carry `[object Object]`.
+ *
+ * The same is true of a dereferenced OpenAPI spec, which is why ApiMarkdown
+ * calls this too: the ISR loader runs SwaggerParser.dereference, NOT .validate
+ * (lib/openapi-isr.ts), so a `description:` YAML read as a number or a Date is
+ * never rejected on the way in and arrives at the renderer as-is.
+ *
+ * A Date is rendered back as the ISO date the author typed rather than through
+ * String(): YAML anchors a bare date at UTC midnight, so String() formats it in
+ * local time, which anywhere west of UTC prints the PREVIOUS day.
+ *
+ * Canonical here rather than beside any one caller: the renderer, the search
+ * index, and llms-full.txt each parse frontmatter independently, and a copy per
+ * consumer is how three of them ended up without the Date branch.
+ */
+export function frontmatterText(value: unknown): string {
+  if (value === null || value === undefined || value === '') return '';
+  if (value instanceof Date) return value.toISOString().slice(0, 10);
+  return String(value);
+}

package/vendored/lib/frontmatter-utils.ts

@@ -112,25 +112,8 @@ export function parseFrontmatterLenient(content: string): {
   return { data, content: rawContent };
 }
 
-/**
- * Coerce a frontmatter value to the string its text consumers require.
- *
- * Frontmatter is whatever YAML decided, not what the author meant:
- * `description: 404` parses to a number and `description: 2026-01-01` to a
- * Date. Both reach surfaces that accept only strings — react-markdown asserts
- * on `children` and THROWS in development, `.trim()`/`.replace()` throw
- * outright, and `<meta name="description">` would carry `[object Object]`.
- *
- * A Date is rendered back as the ISO date the author typed rather than through
- * String(): YAML anchors a bare date at UTC midnight, so String() formats it in
- * local time, which anywhere west of UTC prints the PREVIOUS day.
- *
- * Canonical here rather than beside any one caller: the renderer, the search
- * index, and llms-full.txt each parse frontmatter independently, and a copy per
- * consumer is how three of them ended up without the Date branch.
- */
-export function frontmatterText(value: unknown): string {
-  if (value === null || value === undefined || value === '') return '';
-  if (value instanceof Date) return value.toISOString().slice(0, 10);
-  return String(value);
-}
+// frontmatterText lives in its own import-free leaf so ApiMarkdown.tsx (a
+// `'use client'` module) can share it without pulling gray-matter into the
+// browser bundle. Re-exported here because this is where every caller expects
+// it, and a second import path would be a second thing to keep in step.
+export { frontmatterText } from './frontmatter-text';

package/vendored/lib/openapi/expand-spec-pages.ts

@@ -33,7 +33,7 @@ import { slug as githubSlug } from 'github-slugger';
 import type { DocsConfig, GroupConfig, TabConfig } from '../docs-types.js';
 import { isPathWithinProject } from '../../shared/path-security.js';
 import { collectMdxFiles, type CollectMdxOptions } from '../isr-build-executor.js';
-import { descriptionWindow } from '../description-window.js';
+import { squeezeToPageDescription } from './squeeze-page-description.js';
 import { getCachedSpec } from './cache.js';
 import { generateNavFromSpec } from './generate-nav-from-spec.js';
 import type { GeneratedPage } from './types.js';
@@ -80,36 +80,6 @@ function generatedSpecSource(openapi: TabConfig['openapi']): string | null {
     : null;
 }
 
-/**
- * Squeeze an operation description down to a meta description.
- *
- * `operation.description` is prose with no length contract — real specs put
- * several paragraphs, tables and lists in it. Copied verbatim into frontmatter
- * it becomes the page's `<meta name="description">` and its rendered subtitle,
- * so a 900-character block ships to search engines as one truncated smear and
- * pushes the whole page body down the screen. Nothing downstream bounds it:
- * validate-page-frontmatter only ever checks `< window.min`, never a maximum.
- *
- * Nothing is lost — the full description still reaches the page body through
- * enrichPageInfosWithOperations, and the subtitle/body de-duplication in
- * render-doc-page compares the two texts, so a trimmed subtitle correctly stops
- * suppressing the complete operation description below it.
- */
-function metaDescription(description: string): string {
-  // First paragraph only, whitespace flattened: a meta description is a single
-  // line, and a spec's second paragraph is invariably detail, not summary.
-  const firstParagraph = description.split(/\n\s*\n/)[0] ?? '';
-  const flat = firstParagraph.replace(/\s+/g, ' ').trim();
-  const { generateMax } = descriptionWindow({ sample: flat });
-  if (flat.length <= generateMax) return flat;
-  // Cut on a word boundary so the snippet does not end mid-word. CJK has no
-  // spaces, so lastIndexOf returns -1 there and the hard slice stands — which
-  // is correct for a script that wraps anywhere.
-  const hardCut = flat.slice(0, generateMax);
-  const lastSpace = hardCut.lastIndexOf(' ');
-  return `${(lastSpace > generateMax * 0.6 ? hardCut.slice(0, lastSpace) : hardCut).replace(/[\s,;:.]+$/, '')}…`;
-}
-
 /** Frontmatter values are JSON-encoded — valid YAML double-quoted scalars,
  *  immune to colons/quotes/newlines in spec summaries. */
 function generatedPageMdx(page: GeneratedPage, specSource: string): string {
@@ -119,7 +89,7 @@ function generatedPageMdx(page: GeneratedPage, specSource: string): string {
   const lines = [
     '---',
     `title: ${JSON.stringify(page.title)}`,
-    ...(page.description ? [`description: ${JSON.stringify(metaDescription(page.description))}`] : []),
+    ...(page.description ? [`description: ${JSON.stringify(squeezeToPageDescription(page.description))}`] : []),
     `openapi: ${JSON.stringify(`${specRef} ${page.method} ${page.path}`)}`,
     '---',
     '',

package/vendored/lib/openapi/squeeze-page-description.ts

@@ -0,0 +1,53 @@
+// builder/build-service/lib/openapi/squeeze-page-description.ts
+//
+// One function, deliberately in a leaf module of its own: BOTH the page
+// generator that writes a description into generated frontmatter and the
+// renderer that recognises it as redundant must call the same code, and
+// `expand-spec-pages.ts` pulls in `fs` and the whole build executor — far too
+// much to drag into a request-time page render. Only `description-window.ts`
+// (itself import-free) is needed here.
+//
+// Extensionless import, unlike the `.js`-suffixed ones in expand-spec-pages.ts:
+// render-doc-page.tsx pulls this module into the Next/Turbopack graph, which
+// resolves a relative specifier literally and cannot map `.js` onto a `.ts`
+// file. tsc is happy either way under `moduleResolution: "bundler"`, so the
+// bundler's requirement is the binding one — and it fails at `vercel --prod`,
+// which neither `tsc --noEmit` nor the vitest gate exercises.
+
+import { descriptionWindow } from '../description-window';
+
+/**
+ * Squeeze an operation description down to a meta description.
+ *
+ * EXPORTED because `render-doc-page.tsx` recognises this function's output to
+ * decide that a generated page's subtitle is a redundant copy of the operation
+ * description below it. Producer and recogniser MUST be the same code: a
+ * hand-written matcher for "the shapes this emits" silently stops matching the
+ * day the squeeze changes, and the duplicate comes back with no test failing.
+ *
+ * `operation.description` is prose with no length contract — real specs put
+ * several paragraphs, tables and lists in it. Copied verbatim into frontmatter
+ * it becomes the page's `<meta name="description">` and its rendered subtitle,
+ * so a 900-character block ships to search engines as one truncated smear and
+ * pushes the whole page body down the screen. Nothing downstream bounds it:
+ * validate-page-frontmatter only ever checks `< window.min`, never a maximum.
+ *
+ * Nothing is lost — the full description still reaches the page body through
+ * enrichPageInfosWithOperations, and render-doc-page recognises this squeeze
+ * and drops the shortened SUBTITLE, leaving the endpoint block to render the
+ * description whole.
+ */
+export function squeezeToPageDescription(description: string): string {
+  // First paragraph only, whitespace flattened: a meta description is a single
+  // line, and a spec's second paragraph is invariably detail, not summary.
+  const firstParagraph = description.split(/\n\s*\n/)[0] ?? '';
+  const flat = firstParagraph.replace(/\s+/g, ' ').trim();
+  const { generateMax } = descriptionWindow({ sample: flat });
+  if (flat.length <= generateMax) return flat;
+  // Cut on a word boundary so the snippet does not end mid-word. CJK has no
+  // spaces, so lastIndexOf returns -1 there and the hard slice stands — which
+  // is correct for a script that wraps anywhere.
+  const hardCut = flat.slice(0, generateMax);
+  const lastSpace = hardCut.lastIndexOf(' ');
+  return `${(lastSpace > generateMax * 0.6 ? hardCut.slice(0, lastSpace) : hardCut).replace(/[\s,;:.]+$/, '')}…`;
+}

package/vendored/lib/render-doc-page.tsx

@@ -95,6 +95,7 @@ import { parseLocalePath } from '@/lib/locale-fallback';
 import { DocsLocaleProvider } from '@/components/mdx/docs-locale-context';
 import { findFirstNavPage } from '@/lib/find-first-nav-page';
 import { candidateSpecPaths } from '@/lib/openapi/lang-spec-path';
+import { squeezeToPageDescription } from '@/lib/openapi/squeeze-page-description';
 import { ApiEndpoint } from '@/components/mdx/ApiEndpoint';
 import { AIActionsMenu } from '@/components/AIActionsMenu';
 import { getContextualOptions } from '@/lib/contextual-defaults';
@@ -105,6 +106,23 @@ import { resolveAutoNewsletter, mdxHasEmailSubscribe } from '@/lib/email-subscri
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | 'TRACE';
 
+/**
+ * The page subtitle — the frontmatter `description` rendered under the h1.
+ *
+ * Hoisted because this page has TWO subtitle sites (the API-page branch and the
+ * standard one) rendering the same string through the same markdown pipeline.
+ * They had drifted: the standard branch carried no block structure at all, so a
+ * list, table or blockquote in a plain page's description lost its markers and
+ * borders to Tailwind preflight while the identical description on an API page
+ * rendered correctly.
+ *
+ * `[&>p:only-child]:m-0` rather than `[&>p]:m-0`: a one-paragraph description —
+ * almost all of them — sits tight under the heading, but a multi-paragraph one
+ * still needs the spacing MARKDOWN_BLOCK_STRUCTURE gives it, and a blanket
+ * `m-0` would also collide with that rule at equal specificity.
+ */
+const SUBTITLE_PROSE = `text-base sm:text-lg text-theme-text-secondary leading-relaxed mt-2 sm:mt-3 ${MARKDOWN_BLOCK_STRUCTURE} [&>p:only-child]:m-0 [&_code]:text-[0.9em] [&_code]:bg-[var(--color-bg-tertiary)] [&_code]:px-1 [&_code]:py-0.5 [&_code]:rounded`;
+
 const DEFAULT_SITE_URL = 'https://docs.example.com';
 
 /**
@@ -778,10 +796,43 @@ export async function renderDocPage(input: RenderInput): Promise<ReactElement> {
   // string actually rendered above, and a non-string frontmatter description
   // would make `.replace` throw here too.
   const flattenText = (s: string) => s.replace(/\s+/g, ' ').trim();
+  const flatSubtitle = subtitleMarkdown ? flattenText(subtitleMarkdown) : '';
+  // Spec input, not ours: a `description:` that YAML hands back as a number or
+  // a Date must not take the page down ("docs never 500"). Narrowed once here
+  // so none of the string work below can throw.
+  const operationDescription =
+    typeof openApiEndpointData?.description === 'string'
+      ? openApiEndpointData.description
+      : '';
+  const flatOperation = operationDescription ? flattenText(operationDescription) : '';
   const descriptionAlreadyShown = Boolean(
-    subtitleMarkdown &&
-      openApiEndpointData?.description &&
-      flattenText(subtitleMarkdown) === flattenText(openApiEndpointData.description),
+    flatSubtitle && flatOperation && flatSubtitle === flatOperation,
+  );
+
+  // The mirror case: the subtitle is a SHORTENED copy of the operation
+  // description rather than the whole of it, so suppressing the endpoint block
+  // would delete everything the shortening dropped. Here the SUBTITLE is the
+  // redundant half — the block below opens with the same words and then carries
+  // the rest — so drop the subtitle and keep the block. Across the specs in
+  // this repo a third of operations land here, and the page showed a visibly
+  // cut-off `…` paragraph directly above the same text in full.
+  //
+  // Asking the generator itself rather than pattern-matching its output: a
+  // page generated from a spec gets `squeezeToPageDescription(operation)` as
+  // its frontmatter description, so "the subtitle is that squeeze" is exactly
+  // the redundant case and nothing else is. A hand-written matcher for the
+  // shapes the squeeze happens to emit today would silently stop matching the
+  // day the squeeze changes — and an author's own short lead-in that merely
+  // opens like the operation is still theirs, which a looser prefix test would
+  // have deleted.
+  //
+  // Nothing is lost by dropping it — the frontmatter description's real job is
+  // <meta>/OG/llms.txt, and those read `data.description` directly.
+  const subtitleRedundant = Boolean(
+    flatSubtitle &&
+      flatOperation &&
+      !descriptionAlreadyShown &&
+      flatSubtitle === flattenText(squeezeToPageDescription(operationDescription)),
   );
 
   // ── Single pre-render compile pass ("docs never 500") ──────────────────────
@@ -998,8 +1049,8 @@ export async function renderDocPage(input: RenderInput): Promise<ReactElement> {
                     and THIS is the only place that markdown renders. Without it
                     a table or list here renders bare. `:only-child` keeps the
                     ordinary one-paragraph subtitle flush. */}
-                {data.description && (
-                  <div className={`text-base sm:text-lg text-theme-text-secondary leading-relaxed mt-2 sm:mt-3 ${MARKDOWN_BLOCK_STRUCTURE} [&>p:only-child]:m-0 [&_code]:text-[0.9em] [&_code]:bg-[var(--color-bg-tertiary)] [&_code]:px-1 [&_code]:py-0.5 [&_code]:rounded`}>
+                {data.description && !subtitleRedundant && (
+                  <div className={SUBTITLE_PROSE}>
                     <ReactMarkdown remarkPlugins={[[remarkGfm, { singleTilde: false }]]}>{subtitleMarkdown}</ReactMarkdown>
                   </div>
                 )}
@@ -1121,7 +1172,7 @@ export async function renderDocPage(input: RenderInput): Promise<ReactElement> {
             {hasAiActions && <div className="ml-auto flex-shrink-0 hidden sm:block"><AIActionsMenu options={contextualOptions} projectName={config.name} /></div>}
           </div>
           {data.description && (
-            <div className="text-base sm:text-lg text-theme-text-secondary leading-relaxed mt-2 sm:mt-3 [&>p]:m-0 [&_code]:text-[0.9em] [&_code]:bg-[var(--color-bg-tertiary)] [&_code]:px-1 [&_code]:py-0.5 [&_code]:rounded">
+            <div className={SUBTITLE_PROSE}>
               <ReactMarkdown remarkPlugins={[[remarkGfm, { singleTilde: false }]]}>{subtitleMarkdown}</ReactMarkdown>
             </div>
           )}

package/vendored/lib/static-artifacts.ts

@@ -686,7 +686,15 @@ export function generateLlmsFullTxt(options: LlmsFullTxtOptions): string {
     // therefore never matched for any soft-wrapped description — the one case
     // this dedup exists for.
     const flat = (t: string) => t.replace(/\s+/g, ' ');
-    if (description && !flat(content).includes(flat(description))) {
+    // The trailing ellipsis is squeezeToPageDescription's truncation marker, and
+    // the body it was cut from never contains it — so `includes` missed exactly
+    // the shape this dedup exists for and emitted a visibly cut-off line above a
+    // body repeating it in full. A third of real operations squeeze that way.
+    // Dropping the marker before the test costs authored prose nothing: an
+    // authored description only loses its line when the body already says it,
+    // which is the rule this check already applies to every other page.
+    const spoken = description.replace(/\u2026$/, '');
+    if (spoken && !flat(content).includes(flat(spoken))) {
       parts.push(`*${description}*\n\n`);
     }