@tenphi/cookbook 0.23.0 → 0.24.0
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/docs/component-styles.md +1 -1
- package/docs/site-navigation.md +23 -0
- package/package.json +3 -3
package/docs/component-styles.md
CHANGED
|
@@ -214,7 +214,7 @@ it stays complete when a surface changes.
|
|
|
214
214
|
|
|
215
215
|
#### Page shell
|
|
216
216
|
|
|
217
|
-
* `Document`: `All`, `BlockSpacing`, `Body`, `Control`, `Pointer`, `ResponsiveWidth`, `ResponsiveHeight`, `Hidden`, `PrintHidden`, `DesktopBlock`, `DesktopFlex`, `ScreenReaderOnly`, `Strong`, `Link`, `NarrowBlock`, `MobileBlock`, `Code`, `FocusRing`, `CurrentLink`, `SearchOpen`
|
|
217
|
+
* `Document`: `All`, `BlockSpacing`, `Body`, `Control`, `Pointer`, `ResponsiveWidth`, `ResponsiveHeight`, `Hidden`, `PrintHidden`, `DesktopBlock`, `DesktopFlex`, `ScreenReaderOnly`, `RouteAnnouncer`, `Strong`, `Link`, `NarrowBlock`, `MobileBlock`, `Code`, `FocusRing`, `CurrentLink`, `SearchOpen`
|
|
218
218
|
* `Layout`: `Islands`
|
|
219
219
|
* `PageFrame`: `MainFrame`, `SidebarFrame`, `Columns`
|
|
220
220
|
* `MainPane`: None
|
package/docs/site-navigation.md
CHANGED
|
@@ -21,6 +21,29 @@ navigation: {
|
|
|
21
21
|
}
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
+
## Client navigation
|
|
25
|
+
|
|
26
|
+
Internal page links use client navigation over the generated static HTML. The
|
|
27
|
+
router loads when an internal page link is hovered, focused, or clicked, so it
|
|
28
|
+
does not add to the initial page download for readers who stay on one page. The
|
|
29
|
+
current page stays visible while the next page and its styles load, then swaps
|
|
30
|
+
without a full-page fade. Appearance preferences, sidebar expansion choices, and
|
|
31
|
+
desktop sidebar scroll within the same navigation section are preserved. Article
|
|
32
|
+
scroll resets to the top on page changes, including Back and Forward; links with
|
|
33
|
+
fragments still navigate to their heading. The current page and its ancestors
|
|
34
|
+
update from the destination markup. Mobile navigation and other open panels close.
|
|
35
|
+
|
|
36
|
+
Search keeps its query and loaded engine between pages in the same language,
|
|
37
|
+
and closes when a result is followed. Language changes initialize the translated
|
|
38
|
+
search interface. External links, downloads, modified clicks, and links marked
|
|
39
|
+
`data-astro-reload` keep normal browser behavior. Without JavaScript, page links
|
|
40
|
+
use normal document navigation.
|
|
41
|
+
|
|
42
|
+
Custom browser scripts should attach behavior through custom-element lifecycle
|
|
43
|
+
callbacks or initialize on `astro:page-load`; bundled scripts are not rerun on
|
|
44
|
+
every client navigation. The router and appearance initialization belong to the common page shell
|
|
45
|
+
and remain available with replacement Header, Head, and PageFrame components.
|
|
46
|
+
|
|
24
47
|
## Search
|
|
25
48
|
|
|
26
49
|
The production build creates a local Pagefind index. Readers can select Search
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tenphi/cookbook",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.24.0",
|
|
4
4
|
"description": "Repository-native static documentation for Astro",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"keywords": [
|
|
@@ -68,8 +68,8 @@
|
|
|
68
68
|
"author": "Andrey Yamanov",
|
|
69
69
|
"license": "MIT",
|
|
70
70
|
"dependencies": {
|
|
71
|
-
"@tenphi/docs": "0.
|
|
72
|
-
"@tenphi/renderer": "0.
|
|
71
|
+
"@tenphi/docs": "0.24.0",
|
|
72
|
+
"@tenphi/renderer": "0.24.0"
|
|
73
73
|
},
|
|
74
74
|
"peerDependencies": {
|
|
75
75
|
"astro": "^7.3.2"
|