@tenphi/cookbook 0.19.0 → 0.19.2

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

@@ -521,10 +521,12 @@ and mobile menu. On wider layouts, heading permalinks sit to the left of the
 heading and are revealed on heading hover or keyboard focus. On mobile they
 stay visible and inline so the target is not clipped by the narrower content
 gutter. Customize the behavior with `MarkdownHeading.Link`,
-`MarkdownHeading.RevealedLink`, and `MarkdownHeading.LinkIcon`. Activating a
-heading link copies the full page URL with that section’s fragment, without
-scrolling or changing the current URL. A checkmark and screen-reader status
-confirm the copy; clipboard failures are announced. Modified clicks and links
+`MarkdownHeading.RevealedLink`, and `MarkdownHeading.LinkIcon`. The `#` icon
+scales with its heading and stays centered in the link target across heading
+levels and screen widths. Activating a heading link copies the full page URL
+with that section’s fragment without scrolling or changing the current URL. A
+checkmark and screen-reader status confirm the copy; clipboard failures are
+announced. Modified clicks and links
 without JavaScript retain native anchor behavior. Customize the confirmation
 with `MarkdownHeading.CopiedLink`, `MarkdownHeading.CopiedLinkIcon` (the hidden
 original icon), and `MarkdownHeading.CopiedIcon` (the checkmark).
@@ -951,6 +953,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 +1197,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.2",
   "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.2",
+    "@tenphi/renderer": "0.19.2"
   },
   "peerDependencies": {
     "astro": "^7.3.2"