jamdesk 1.1.195 → 1.1.197

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

@@ -4,8 +4,14 @@
  * 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]`.
+ * on `children` and THROWS in development, and `.trim()`/`.replace()` throw
+ * outright.
+ *
+ * What this does NOT do is make every malformed shape presentable. A YAML
+ * mapping still coerces to `[object Object]` and a sequence to `a,b`, because
+ * the alternative — returning '' — hides an authoring mistake behind an empty
+ * page rather than a visibly wrong one. The contract is only that no input
+ * makes a caller throw.
  *
  * The same is true of a dereferenced OpenAPI spec, which is why ApiMarkdown
  * calls this too: the ISR loader runs SwaggerParser.dereference, NOT .validate

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

@@ -1 +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"}
+{"version":3,"file":"frontmatter-text.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter-text.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CActD"}

package/dist/lib/frontmatter-text.js

@@ -15,8 +15,14 @@
  * 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]`.
+ * on `children` and THROWS in development, and `.trim()`/`.replace()` throw
+ * outright.
+ *
+ * What this does NOT do is make every malformed shape presentable. A YAML
+ * mapping still coerces to `[object Object]` and a sequence to `a,b`, because
+ * the alternative — returning '' — hides an authoring mistake behind an empty
+ * page rather than a visibly wrong one. The contract is only that no input
+ * makes a caller throw.
  *
  * The same is true of a dereferenced OpenAPI spec, which is why ApiMarkdown
  * calls this too: the ISR loader runs SwaggerParser.dereference, NOT .validate
@@ -34,8 +40,17 @@
 export function frontmatterText(value) {
     if (value === null || value === undefined || value === '')
         return '';
-    if (value instanceof Date)
+    // An out-of-range Date still satisfies `instanceof`, and toISOString() throws
+    // RangeError on it — the one input that would make this function do the very
+    // thing it exists to prevent. js-yaml cannot produce one (its timestamp
+    // resolver builds through Date.UTC, which rolls over rather than going
+    // invalid) and JSON.parse produces no Dates at all, but a JS caller can:
+    // Firestore's Timestamp.toDate() on out-of-range seconds, or a reviver.
+    // Falling through yields "Invalid Date" — visibly wrong, which is the right
+    // failure for a coercion whose contract is that it never throws.
+    if (value instanceof Date && !Number.isNaN(value.getTime())) {
         return value.toISOString().slice(0, 10);
+    }
     return String(value);
 }
 //# sourceMappingURL=frontmatter-text.js.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACrE,8EAA8E;IAC9E,6EAA6E;IAC7E,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,wEAAwE;IACxE,4EAA4E;IAC5E,iEAAiE;IACjE,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

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;AAMD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"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,CAkE7D;AAmED;;;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

@@ -24,10 +24,15 @@ export function preprocessFrontmatter(content) {
     const body = content.slice(frontmatterEnd);
     // Process each line of frontmatter
     const lines = frontmatter.split('\n');
+    // Lines belonging to a previous key's multi-line value are VALUE TEXT, not
+    // key/value pairs, and must be left exactly as written.
+    const isContinuation = markContinuationLines(lines);
     const fixedLines = lines.map((line, i) => {
         // Skip empty lines and comments
         if (!line.trim() || line.trim().startsWith('#'))
             return line;
+        if (isContinuation[i])
+            return line;
         // Match key: value pattern (simple single-line values only).
         // The key may contain colon-segments (e.g. `og:title`, `twitter:card`,
         // `article:published_time`) so we split on the FIRST colon followed by
@@ -35,13 +40,13 @@ export function preprocessFrontmatter(content) {
         // A plain `[a-zA-Z_][a-zA-Z0-9_]*` key class stopped at the first colon,
         // misparsing `og:title: Social` as key=`og`, value=`title: Social`, then
         // quote-wrapping it into `og: "title: Social"` and destroying `og:title`.
-        const match = line.match(/^(\s*)([a-zA-Z_][a-zA-Z0-9_.-]*(?::[a-zA-Z0-9_.-]+)*):\s*(.*)$/);
+        const match = line.match(KEY_LINE);
         if (!match)
             return line;
         const [, indent, key, value] = match;
         // Skip if value is empty, already quoted, or is a multi-line indicator
         // Multi-line indicators: | (literal), > (folded), with optional modifiers: |-  |+  >-  >+
-        if (!value || value.startsWith('"') || value.startsWith("'") || /^[|>][-+]?$/.test(value)) {
+        if (!value || value.startsWith('"') || value.startsWith("'") || isBlockScalar(value)) {
             return line;
         }
         // Skip if value looks like a nested object or array
@@ -69,6 +74,55 @@ export function preprocessFrontmatter(content) {
     // `---<Info>` and tripping MDX's "expected closing tag" validator.
     return '---\n' + fixedLines.join('\n') + endMatch[0] + body;
 }
+/**
+ * A `key:` line. Shared with `markContinuationLines` so the two cannot disagree
+ * about what counts as a key — if they did, a line would be rewritten as a key
+ * by one and treated as value text by the other.
+ */
+const KEY_LINE = /^(\s*)([a-zA-Z_][a-zA-Z0-9_.-]*(?::[a-zA-Z0-9_.-]+)*):\s*(.*)$/;
+/** `|`, `>`, `|-`, `>+`, `|2` … — the value is the indented block below. */
+function isBlockScalar(value) {
+    return /^[|>][-+]?\d*$/.test(value.trim());
+}
+/**
+ * Mark every line that is part of a PREVIOUS key's multi-line value.
+ *
+ * Those lines are value text. Running the key/value rewrite over them is how a
+ * Swedish changelog's continuation line `  Kotlin-SDK:er, Afterpay…` was
+ * rebuilt as `  Kotlin-SDK: er, …`: the reconstruction always emits `key: value`
+ * with a space, which turned plain prose into what YAML reads as a nested
+ * mapping entry, and js-yaml rejected the whole file — so a page lost its
+ * frontmatter entirely to a preprocessor whose only job is to RESCUE files.
+ *
+ * Inside a block scalar the same rewrite does not throw, which is worse: the
+ * injected space lands silently in the description text and ships to the page.
+ */
+function markContinuationLines(lines) {
+    const out = new Array(lines.length).fill(false);
+    for (let i = 0; i < lines.length; i++) {
+        if (out[i])
+            continue;
+        const match = lines[i].match(KEY_LINE);
+        if (!match)
+            continue;
+        const [, indent, , value] = match;
+        // A block scalar always has a body; a plain value only sometimes wraps.
+        if (!isBlockScalar(value) && !hasFoldedContinuation(lines, i))
+            continue;
+        for (let j = i + 1; j < lines.length; j++) {
+            // A blank line inside a block scalar is part of it; one at the end is
+            // harmless to mark, since the mapper skips blank lines anyway.
+            if (!lines[j].trim()) {
+                out[j] = true;
+                continue;
+            }
+            if (lines[j].search(/\S/) <= indent.length)
+                break;
+            out[j] = true;
+        }
+    }
+    return out;
+}
 /**
  * True if the value on `lines[i]` continues onto a subsequent indented line
  * (a YAML folded scalar without an explicit `|` or `>` indicator). The next

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.195",
+  "version": "1.1.197",
   "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/markdown-classes.ts

@@ -91,13 +91,25 @@ export const API_DESCRIPTION_PROSE = [
  * 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),
+ * element it matches (themes/jam, themes/pulsar, themes/halo),
  * 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.
+ * operation description from 16px to 14px on jam (the default), pulsar and
+ * halo. `text-sm` has to stay too: base and nebula set no `.prose` font-size
+ * at all, so for them it is the size that actually renders.
+ *
+ * Audit those rules with a selector-agnostic search, not `^\.prose` — jam and
+ * halo write theirs as `body[data-theme="..."] .prose`, and an anchored grep
+ * reports both as clean.
+ *
+ * Font-size is not all of it, either. Below 1024px `.api-page-layout .prose`
+ * (themes/base.css) switches this element to `display: flex; flex-direction:
+ * column`, so its paragraph margins stop collapsing and start adding. That
+ * predates the consolidation — the old inline string carried `prose` too — but
+ * it means the class is a layout switch as well as a type size, and removing
+ * it changes the narrow-viewport rendering on every theme, not just the three
+ * that set a `.prose` font-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

package/vendored/lib/frontmatter-text.ts

@@ -16,8 +16,14 @@
  * 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]`.
+ * on `children` and THROWS in development, and `.trim()`/`.replace()` throw
+ * outright.
+ *
+ * What this does NOT do is make every malformed shape presentable. A YAML
+ * mapping still coerces to `[object Object]` and a sequence to `a,b`, because
+ * the alternative — returning '' — hides an authoring mistake behind an empty
+ * page rather than a visibly wrong one. The contract is only that no input
+ * makes a caller throw.
  *
  * The same is true of a dereferenced OpenAPI spec, which is why ApiMarkdown
  * calls this too: the ISR loader runs SwaggerParser.dereference, NOT .validate
@@ -34,6 +40,16 @@
  */
 export function frontmatterText(value: unknown): string {
   if (value === null || value === undefined || value === '') return '';
-  if (value instanceof Date) return value.toISOString().slice(0, 10);
+  // An out-of-range Date still satisfies `instanceof`, and toISOString() throws
+  // RangeError on it — the one input that would make this function do the very
+  // thing it exists to prevent. js-yaml cannot produce one (its timestamp
+  // resolver builds through Date.UTC, which rolls over rather than going
+  // invalid) and JSON.parse produces no Dates at all, but a JS caller can:
+  // Firestore's Timestamp.toDate() on out-of-range seconds, or a reviver.
+  // Falling through yields "Invalid Date" — visibly wrong, which is the right
+  // failure for a coercion whose contract is that it never throws.
+  if (value instanceof Date && !Number.isNaN(value.getTime())) {
+    return value.toISOString().slice(0, 10);
+  }
   return String(value);
 }

package/vendored/lib/frontmatter-utils.ts

@@ -28,9 +28,13 @@ export function preprocessFrontmatter(content: string): string {
 
   // Process each line of frontmatter
   const lines = frontmatter.split('\n');
+  // Lines belonging to a previous key's multi-line value are VALUE TEXT, not
+  // key/value pairs, and must be left exactly as written.
+  const isContinuation = markContinuationLines(lines);
   const fixedLines = lines.map((line, i) => {
     // Skip empty lines and comments
     if (!line.trim() || line.trim().startsWith('#')) return line;
+    if (isContinuation[i]) return line;
 
     // Match key: value pattern (simple single-line values only).
     // The key may contain colon-segments (e.g. `og:title`, `twitter:card`,
@@ -39,14 +43,14 @@ export function preprocessFrontmatter(content: string): string {
     // A plain `[a-zA-Z_][a-zA-Z0-9_]*` key class stopped at the first colon,
     // misparsing `og:title: Social` as key=`og`, value=`title: Social`, then
     // quote-wrapping it into `og: "title: Social"` and destroying `og:title`.
-    const match = line.match(/^(\s*)([a-zA-Z_][a-zA-Z0-9_.-]*(?::[a-zA-Z0-9_.-]+)*):\s*(.*)$/);
+    const match = line.match(KEY_LINE);
     if (!match) return line;
 
     const [, indent, key, value] = match;
 
     // Skip if value is empty, already quoted, or is a multi-line indicator
     // Multi-line indicators: | (literal), > (folded), with optional modifiers: |-  |+  >-  >+
-    if (!value || value.startsWith('"') || value.startsWith("'") || /^[|>][-+]?$/.test(value)) {
+    if (!value || value.startsWith('"') || value.startsWith("'") || isBlockScalar(value)) {
       return line;
     }
 
@@ -79,6 +83,52 @@ export function preprocessFrontmatter(content: string): string {
   return '---\n' + fixedLines.join('\n') + endMatch[0] + body;
 }
 
+/**
+ * A `key:` line. Shared with `markContinuationLines` so the two cannot disagree
+ * about what counts as a key — if they did, a line would be rewritten as a key
+ * by one and treated as value text by the other.
+ */
+const KEY_LINE =
+  /^(\s*)([a-zA-Z_][a-zA-Z0-9_.-]*(?::[a-zA-Z0-9_.-]+)*):\s*(.*)$/;
+
+/** `|`, `>`, `|-`, `>+`, `|2` … — the value is the indented block below. */
+function isBlockScalar(value: string): boolean {
+  return /^[|>][-+]?\d*$/.test(value.trim());
+}
+
+/**
+ * Mark every line that is part of a PREVIOUS key's multi-line value.
+ *
+ * Those lines are value text. Running the key/value rewrite over them is how a
+ * Swedish changelog's continuation line `  Kotlin-SDK:er, Afterpay…` was
+ * rebuilt as `  Kotlin-SDK: er, …`: the reconstruction always emits `key: value`
+ * with a space, which turned plain prose into what YAML reads as a nested
+ * mapping entry, and js-yaml rejected the whole file — so a page lost its
+ * frontmatter entirely to a preprocessor whose only job is to RESCUE files.
+ *
+ * Inside a block scalar the same rewrite does not throw, which is worse: the
+ * injected space lands silently in the description text and ships to the page.
+ */
+function markContinuationLines(lines: string[]): boolean[] {
+  const out = new Array<boolean>(lines.length).fill(false);
+  for (let i = 0; i < lines.length; i++) {
+    if (out[i]) continue;
+    const match = lines[i].match(KEY_LINE);
+    if (!match) continue;
+    const [, indent, , value] = match;
+    // A block scalar always has a body; a plain value only sometimes wraps.
+    if (!isBlockScalar(value) && !hasFoldedContinuation(lines, i)) continue;
+    for (let j = i + 1; j < lines.length; j++) {
+      // A blank line inside a block scalar is part of it; one at the end is
+      // harmless to mark, since the mapper skips blank lines anyway.
+      if (!lines[j].trim()) { out[j] = true; continue; }
+      if (lines[j].search(/\S/) <= indent.length) break;
+      out[j] = true;
+    }
+  }
+  return out;
+}
+
 /**
  * True if the value on `lines[i]` continues onto a subsequent indented line
  * (a YAML folded scalar without an explicit `|` or `>` indicator). The next

package/vendored/lib/mdx.ts

@@ -9,6 +9,7 @@ import { getContentDir } from './docs';
 import { injectPromptSources } from './inject-prompt-source';
 import { mdxSecurityOptions } from './mdx-security-options';
 import { remarkSvgNamespaceAttrs } from './remark-svg-namespace-attrs';
+import { remarkStyleStringToObject } from './remark-style-string-to-object';
 import { getShikiOptions } from './shiki-config';
 
 export interface DocFrontmatter {
@@ -46,7 +47,7 @@ export async function getDocContent(slug: string[]): Promise<DocContent | null>
     // Keep expression props (e.g. cols={2}) compatible under next-mdx-remote v6.
     ...mdxSecurityOptions,
     mdxOptions: {
-      remarkPlugins: [remarkGfm, remarkSvgNamespaceAttrs],
+      remarkPlugins: [remarkGfm, remarkSvgNamespaceAttrs, remarkStyleStringToObject],
       rehypePlugins: [[rehypeShiki, shikiOptions]],
     },
     scope: data,