@tenphi/cookbook 0.19.0 → 0.19.1

package/docs/authoring.mdx

@@ -98,6 +98,8 @@ tableOfContents: { mobile: true, minHeadingLevel: 2, maxHeadingLevel: 3 }
 The same frontmatter field can change heading levels or set `mobile: false` on
 one page. `tableOfContents: false` disables both versions. Selecting a mobile
 contents link closes the disclosure and moves keyboard focus to the heading.
+The desktop contents list highlights the current section and scrolls its own
+list when the active link moves out of view.
 Customize `theme.styles.MobileTableOfContents` and `TableOfContentsLayout`.
 
 ## Hero images

package/docs/theme-and-components.md

@@ -951,6 +951,9 @@ for the close button. The inset divider above the tabs belongs to `TopNavigation
 
 The desktop table of contents is hidden below 72rem. Set
 `tableOfContents: { mobile: true }` to show an optional compact disclosure there.
+On desktop, the current section is marked as the page scrolls and its link stays
+visible in a long contents list. Customize its appearance with
+`theme.styles.TableOfContents.CurrentLink`.
 `MobileTableOfContents` owns its summary and links; `TableOfContentsLayout`
 controls placement. `Layout` controls shared
 navigation dimensions and the drawer's scroll lock; `PageFrame` styles the
@@ -1192,7 +1195,11 @@ snippets. The padding follows the `code` preset's line height. Override it with
 
 Shiki classifies code; Tasty renders every token using Glaze's semantic syntax
 colors. Customize token rules with `theme.styles.SyntaxHighlight`, or their
-colors with `theme.palette` (for example `syntax-keyword`). Code fences, including
+colors with `theme.palette` (for example `syntax-keyword`). The default
+`syntax-bg` stays white in light mode and takes a slight brand-hued tint, close
+to the page background's saturation, in dark mode. Set
+`theme.palette["syntax-bg"]` to give code its own color seed;
+syntax text and token contrast resolve against that surface. Code fences, including
 MDX and diff blocks, use classes without inline style attributes. Custom Shiki
 transformers should emit classes; unsupported inline declarations fail with a
 configuration hint.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenphi/cookbook",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "Repository-native static documentation for Astro",
   "type": "module",
   "keywords": [
@@ -68,8 +68,8 @@
   "author": "Andrey Yamanov",
   "license": "MIT",
   "dependencies": {
-    "@tenphi/docs": "0.19.0",
-    "@tenphi/renderer": "0.19.0"
+    "@tenphi/docs": "0.19.1",
+    "@tenphi/renderer": "0.19.1"
   },
   "peerDependencies": {
     "astro": "^7.3.2"