@tenphi/cookbook 0.24.0 → 0.25.1

package/docs/configuration.md

@@ -507,6 +507,10 @@ Configure renderer-level Markdown options such as custom remark or rehype
 plugins and Shiki languages through Astro's top-level `markdown` configuration.
 Cookbook preserves those settings while adding its own build-time transforms.
 
+GFM column alignment (`:--`, `:-:`, `--:`) becomes a `data-align` modifier on
+table cells. Restyle it with `@own(align=right)` and similar states in
+`theme.styles.MarkdownTable.Cell`.
+
 Cookbook preserves custom metadata and supports custom schemas. See
 [extending Cookbook](./plugins.md) for Astro Markdown plugins, native GitHub
 alerts, the content query API, and styling limits.
@@ -612,7 +616,9 @@ build: {
 `strict` makes missing internal links errors instead of warnings. `ci` makes
 missing heading fragments errors and defaults to `true` when `CI=true`.
 Cookbook derives its public base path from Astro's top-level `base` setting so
-routes and assets cannot drift between two configurations. An empty `cacheDir`
+routes and assets cannot drift between two configurations. Page URLs likewise
+follow Astro's `trailingSlash` and `build.format`; see
+[Deployment](./deployment.md#github-pages). An empty `cacheDir`
 uses `~/.cache/cookbook`; set an explicit path to relocate downloaded package
 artifacts. Package limits protect builds from unexpected registry artifacts;
 raise them deliberately for a reviewed package.

package/docs/deployment.md

@@ -42,6 +42,13 @@ served at `https://owner.github.io/repository/`, set Astro's
 `base: "/repository/"`; Cookbook derives the same base for its graph and
 assets.
 
+Page URLs follow Astro's `trailingSlash` and `build.format`. The default
+directory output writes `guide/index.html`, so links, canonicals, and `llms.txt`
+use `/guide/`. `build.format: "file"` writes `guide.html` and uses `/guide`,
+while the home remains the directory index at the base. `trailingSlash` set to
+`"always"` or `"never"` overrides both. Either way, readers follow the URL the
+host serves directly instead of a redirect.
+
 ## Custom domains
 
 Set Cookbook's canonical site metadata to the HTTPS origin. The integration

package/docs/quality-checks.md

@@ -49,10 +49,12 @@ rejects the TypeScript 7 API. Runtime compilation and lint parsing are separate.
 
 The reference build enforces separate limits for initial page JavaScript,
 lazy search assets, font files, images, and extracted Tasty CSS. A default guide
-currently loads about 9 KB of first-party JavaScript initially; search is lazy.
+currently loads about 22 KB of first-party JavaScript initially (about 10 KB
+gzipped), including Astro's built-in hover prefetching; search and the client
+router remain lazy. The initial JavaScript budget is 24 KiB.
 The checked reference output contains about 73 KB of fonts, 66 KB of images and
-icons, and a 189 KB shared stylesheet. The guide's first-party HTML, CSS, and
-initial JavaScript total about 33 KB when gzipped. Actual network transfers vary
+icons, and a 181 KB shared stylesheet. The guide's first-party HTML, CSS, and
+initial JavaScript total about 40 KB when gzipped. Actual network transfers vary
 with hosting compression and caching. `node scripts/check-reference-budgets.mjs`
 prints current raw budgets and the gzip estimate; neither includes external
 analytics.

package/docs/site-navigation.md

@@ -33,6 +33,25 @@ scroll resets to the top on page changes, including Back and Forward; links with
 fragments still navigate to their heading. The current page and its ancestors
 update from the destination markup. Mobile navigation and other open panels close.
 
+Cookbook enables Astro's built-in hover prefetching by default. Hovering over or
+focusing an internal link for about 80 ms downloads the destination HTML in the
+background. Moving across links briefly does not prefetch them, and repeated
+links to the same page share a prefetch. When the browser reports data-saving
+mode or a slow connection, Astro waits for tap intent instead.
+
+Prefetching warms the browser's HTTP cache. Static hosting should send cache
+headers such as `Cache-Control` or `ETag` so navigation can reuse the response;
+uncacheable responses may still be downloaded again on click. Browser and private
+session policies can also limit cache reuse. Destination stylesheets remain part
+of the router's preparation before the page swap.
+
+Set `prefetch: false` in `astro.config.mjs` to disable page prefetching while
+retaining client navigation. Cookbook preserves any explicit Astro `prefetch`
+configuration, including `prefetchAll: false` for selective prefetching. For a
+single link, use `data-astro-prefetch="false"` to opt out or
+`data-astro-prefetch` to opt in. See [Astro's prefetch guide](https://docs.astro.build/en/guides/prefetch/)
+for the supported strategies.
+
 Search keeps its query and loaded engine between pages in the same language,
 and closes when a result is followed. Language changes initialize the translated
 search interface. External links, downloads, modified clicks, and links marked
@@ -41,8 +60,9 @@ use normal document navigation.
 
 Custom browser scripts should attach behavior through custom-element lifecycle
 callbacks or initialize on `astro:page-load`; bundled scripts are not rerun on
-every client navigation. The router and appearance initialization belong to the common page shell
-and remain available with replacement Header, Head, and PageFrame components.
+every client navigation. The router and appearance initialization belong to the
+common page shell and remain available with replacement Header, Head, and
+PageFrame components.
 
 ## Search
 

package/package.json

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