@dogsbay/render-html 0.2.0-beta.120 → 0.2.0-beta.121

package/css/api.css

@@ -1,4 +1,4 @@
-/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui api-symbol.css, api-source.css, EndpointSection.astro, PropertyItem.astro. Do not edit. */
+/* Generated by packages/render-html/scripts/sync-sources.mjs from @dogsbay/ui api-symbol.css, api-source.css, EndpointCard.astro, EndpointSection.astro, PropertyItem.astro. Do not edit. */
 /* API Symbol badges, coloured by kind. Text on its own 20% tint must reach
    WCAG AA (4.5:1) on the page background: the light colours were L 0.5–0.6
    (3.2–4.0:1) and are L 0.44 (5.0:1 or more); render-html's
@@ -126,6 +126,63 @@
 }
 
 
+  /* An operation's description is Markdown rendered to HTML (lists, code,
+     paragraphs), placed where the page's prose styles do not reach: without
+     these a bulleted field list reads as loose lines. */
+  .api-description > * + * {
+    margin-top: 0.5rem;
+  }
+  .api-description ul {
+    list-style: disc;
+    padding-left: 1.25rem;
+  }
+  .api-description ol {
+    list-style: decimal;
+    padding-left: 1.25rem;
+  }
+  .api-description li + li,
+  .api-description li > ul,
+  .api-description li > ol {
+    margin-top: 0.125rem;
+  }
+  .api-description ul ul {
+    list-style: circle;
+  }
+  /* Field names (`id`, `scm_type`) stand out in the JSON key colour,
+     on a faint tint of it. Override --api-field in the theme to change it; a site
+     scaffolded before the token existed gets --api-post, the same blue. */
+  .api-description code {
+    font-family: var(--font-mono, ui-monospace, monospace);
+    font-size: 0.85em;
+    font-weight: 600;
+    color: var(--api-field, var(--api-post, var(--foreground)));
+    background-color: color-mix(in oklab, var(--api-field, var(--api-post, var(--foreground))) 8%, transparent);
+    border-radius: 0.25rem;
+    padding: 0.0625rem 0.3rem;
+  }
+  /* A code block in a description (a JSON shape, `?order_by=`) is one
+     full-width block, as Swagger UI shows it: the chip styling above,
+     applied per line, read as a stack of separate highlights. */
+  .api-description pre {
+    overflow-x: auto;
+    border-radius: 0.375rem;
+    padding: 0.5rem 0.75rem;
+    background-color: var(--code-background, color-mix(in oklab, var(--foreground) 6%, transparent));
+  }
+  .api-description pre code {
+    display: block;
+    padding: 0;
+    border-radius: 0;
+    background: none;
+    white-space: pre;
+  }
+  .api-description a {
+    color: var(--primary);
+    text-decoration: underline;
+    text-underline-offset: 2px;
+  }
+
+
   details[open] > summary [data-section-chevron] {
     transform: rotate(90deg);
   }

package/css/theme-default.css

@@ -56,6 +56,7 @@
   --color-code-fg: var(--code-foreground);
 
   /* API reference — HTTP method, type, status, role colors */
+  --color-api-field: var(--api-field);
   --color-api-get: var(--api-get);
   --color-api-post: var(--api-post);
   --color-api-put: var(--api-put);
@@ -139,6 +140,9 @@
   --api-head: oklch(0.47 0.222 286);
   --api-required: oklch(0.45 0.179 22);
   --api-deprecated: oklch(0.455 0.105 63);
+  /* A field name in an operation's description (`id`, `name`): the JSON
+     key colour of the highlighted examples (github-light-default #0550ae). */
+  --api-field: oklch(0.47 0.16 254);
   --api-type-string: oklch(0.435 0.095 162);
   --api-type-number: oklch(0.45 0.174 259);
   --api-type-boolean: oklch(0.455 0.105 63);
@@ -195,6 +199,7 @@
   --api-head: oklch(0.740 0.182 286);
   --api-required: oklch(0.805 0.194 22);
   --api-deprecated: oklch(0.745 0.15 63);
+  --api-field: oklch(0.79 0.11 245); /* github-dark-default #79c0ff */
   --api-type-string: oklch(0.690 0.135 162);
   --api-type-number: oklch(0.725 0.174 259);
   --api-type-boolean: oklch(0.720 0.15 63);

package/css/theme-mintlify.css

@@ -56,6 +56,7 @@
   --color-code-fg: var(--code-foreground);
 
   /* API reference — HTTP method, type, status, role colors */
+  --color-api-field: var(--api-field);
   --color-api-get: var(--api-get);
   --color-api-post: var(--api-post);
   --color-api-put: var(--api-put);
@@ -142,6 +143,9 @@
   --api-head: oklch(0.47 0.222 286);
   --api-required: oklch(0.45 0.179 22);
   --api-deprecated: oklch(0.455 0.105 63);
+  /* A field name in an operation's description (`id`, `name`): the JSON
+     key colour of the highlighted examples (github-light-default #0550ae). */
+  --api-field: oklch(0.47 0.16 254);
   --api-type-string: oklch(0.435 0.095 162);
   --api-type-number: oklch(0.45 0.174 259);
   --api-type-boolean: oklch(0.455 0.105 63);
@@ -199,6 +203,7 @@
   --api-head: oklch(0.740 0.182 286);
   --api-required: oklch(0.805 0.194 22);
   --api-deprecated: oklch(0.745 0.15 63);
+  --api-field: oklch(0.79 0.11 245); /* github-dark-default #79c0ff */
   --api-type-string: oklch(0.690 0.135 162);
   --api-type-number: oklch(0.725 0.174 259);
   --api-type-boolean: oklch(0.720 0.15 63);

package/dist/api.js

@@ -319,7 +319,7 @@ function endpoint(n, ctx) {
             ? `<div class="flex items-center gap-2 rounded-lg border border-api-deprecated/30 bg-api-deprecated/10 px-4 py-2 text-sm text-api-deprecated">${DEPRECATED_ICON}<span>This endpoint is deprecated.</span></div>`
             : "") +
         (summary ? `<p class="text-sm text-muted-foreground">${esc(summary)}</p>` : "") +
-        (description ? `<div class="text-sm text-muted-foreground">${rewriteHtml(description, ctx)}</div>` : "") +
+        (description ? `<div class="api-description text-sm text-muted-foreground">${rewriteHtml(description, ctx)}</div>` : "") +
         `<div class="space-y-3">${sections}</div></div>`;
     const panels = codePanels(p)
         .map((c) => c.samples

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/render-html",
-  "version": "0.2.0-beta.120",
+  "version": "0.2.0-beta.121",
   "description": "Dogsbay MD TreeNode → HTML with the Astro components' markup and classes. No highlighter, math or CSS compiler unless you pass one; Worker- and browser-safe",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,9 +30,9 @@
   "dependencies": {
     "htmlparser2": "^10.1.0",
     "markdown-it": "^14.3.0",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.120",
-    "@dogsbay/serialize-core": "0.2.0-beta.120",
-    "@dogsbay/types": "0.2.0-beta.120"
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.121",
+    "@dogsbay/serialize-core": "0.2.0-beta.121",
+    "@dogsbay/types": "0.2.0-beta.121"
   },
   "peerDependencies": {
     "katex": "^0.16.0"