jamdesk 1.1.194 → 1.1.195

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "jamdesk",
3
- "version": "1.1.194",
3
+ "version": "1.1.195",
4
4
  "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",
5
5
  "keywords": [
6
6
  "jamdesk",
@@ -983,7 +983,7 @@ export function OpenApiEndpoint({
983
983
 
984
984
  {/* Description only - summary is shown as page title (h1) */}
985
985
  {description && !descriptionAlreadyShown && (
986
- <ApiMarkdown className={`mt-4 text-sm text-[var(--color-text-secondary)] leading-relaxed ${OPERATION_DESCRIPTION_PROSE}`}>
986
+ <ApiMarkdown className={`mt-4 text-sm text-[var(--color-text-secondary)] leading-relaxed prose ${OPERATION_DESCRIPTION_PROSE}`}>
987
987
  {description}
988
988
  </ApiMarkdown>
989
989
  )}
@@ -87,15 +87,21 @@ export const API_DESCRIPTION_PROSE = [
87
87
  * correctly everywhere else on the same page. Sharing the structure and varying
88
88
  * only the scale is what keeps that from recurring.
89
89
  *
90
- * The inline version also carried `prose prose-sm dark:prose-invert`. All three
91
- * are gone and nothing renders differently for it: `prose-sm` and
92
- * `dark:prose-invert` are Tailwind Typography modifiers and this build has no
93
- * such plugin, and the local `prose` was redundant because the page already
94
- * wraps its content in `.prose` (render-doc-page.tsx `proseClasses`) — every
95
- * `.prose <descendant>` rule in themes/base.css still applies from there. The
96
- * class contributed only `.prose { color, line-height }`, both inheritable and
97
- * both already inherited from that wrapper. The other twelve description sites
98
- * never carried it.
90
+ * The call site keeps a bare `prose` alongside this constant, and MUST. It is
91
+ * tempting to read as redundant the page already wraps its content in
92
+ * `.prose` (render-doc-page.tsx `proseClasses`), so every `.prose <descendant>`
93
+ * rule reaches the element anyway — but `.prose` also sets `font-size` on the
94
+ * element it matches (themes/jam/variables.css, themes/pulsar/variables.css),
95
+ * and that is a different question from inheritance: the div carries `text-sm`,
96
+ * and `.prose` only outranks it by being UNLAYERED where Tailwind utilities sit
97
+ * in `@layer utilities`. Drop the class and `text-sm` wins, taking the
98
+ * operation description from 16px to 14px on the default theme. The themes that
99
+ * set no `.prose` font-size (base, nebula, halo) are the reason `text-sm` has to
100
+ * stay too — it is the fallback, not the intended size.
101
+ *
102
+ * `prose-sm` and `dark:prose-invert` went with the inline version and are not
103
+ * coming back: they are Tailwind Typography modifiers and this build has no
104
+ * such plugin, so they never matched anything.
99
105
  */
100
106
  export const OPERATION_DESCRIPTION_PROSE = [
101
107
  MARKDOWN_BLOCK_STRUCTURE,