@noy4/docserve 0.3.2 → 0.3.4

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.
Files changed (76) hide show
  1. package/bin.mjs +2 -2
  2. package/dist/widget/index.js +11803 -0
  3. package/package.json +24 -3
  4. package/src/node/adapter.mjs +67 -0
  5. package/src/node/assets.mjs +36 -0
  6. package/src/node/dates.mjs +73 -0
  7. package/src/node/docs-info.mjs +39 -0
  8. package/src/node/files.mjs +43 -0
  9. package/src/node/gallery.mjs +33 -0
  10. package/src/node/inject.mjs +43 -0
  11. package/src/node/meta.mjs +137 -0
  12. package/src/node/routes.mjs +105 -0
  13. package/src/node/scan.mjs +87 -0
  14. package/src/node/serve-static.mjs +158 -0
  15. package/src/node/server.mjs +69 -0
  16. package/src/node/watch.mjs +119 -0
  17. package/src/plugins/collapse/client.js +45 -0
  18. package/src/plugins/collapse/collapse.css +74 -0
  19. package/src/plugins/collapse/commands.ts +81 -0
  20. package/src/plugins/collapse/model.ts +123 -0
  21. package/src/plugins/collapse/sections.ts +105 -0
  22. package/src/plugins/collapse/view.ts +84 -0
  23. package/src/plugins/copy/client.js +72 -0
  24. package/src/plugins/copy/copy.css +21 -0
  25. package/src/plugins/home/client.js +24 -0
  26. package/src/plugins/sidebar/client.js +106 -0
  27. package/src/plugins/sidebar/grouping.js +108 -0
  28. package/src/plugins/sidebar/icons.js +25 -0
  29. package/src/plugins/sidebar/model.ts +91 -0
  30. package/src/plugins/sidebar/resize-model.ts +47 -0
  31. package/src/plugins/sidebar/sidebar.css +663 -0
  32. package/src/plugins/sidebar/tree-model.ts +23 -0
  33. package/src/plugins/sidebar/tree.ts +69 -0
  34. package/src/plugins/sidebar/ui/PageList.tsx +153 -0
  35. package/src/plugins/sidebar/ui/RadioMenu.tsx +201 -0
  36. package/src/plugins/sidebar/ui/Sidebar.tsx +95 -0
  37. package/src/plugins/sidebar/ui/SidebarHeader.tsx +87 -0
  38. package/src/plugins/sidebar/ui/TreeList.tsx +121 -0
  39. package/src/plugins/sidebar/ui/preview-model.ts +134 -0
  40. package/src/plugins/sidebar/ui/useModel.ts +25 -0
  41. package/src/plugins/toc/client.js +55 -0
  42. package/src/plugins/toc/commands.ts +49 -0
  43. package/src/plugins/toc/heading-html.ts +40 -0
  44. package/src/plugins/toc/model.ts +178 -0
  45. package/src/plugins/toc/outline.js +94 -0
  46. package/src/plugins/toc/scroll-spy.ts +35 -0
  47. package/src/plugins/toc/toc.css +214 -0
  48. package/src/plugins/toc/ui/TocPanel.tsx +87 -0
  49. package/src/shared/types.d.ts +193 -0
  50. package/src/widget/commands.js +214 -0
  51. package/src/widget/docks.js +127 -0
  52. package/src/widget/host.js +187 -0
  53. package/src/widget/index.js +22 -0
  54. package/src/widget/lib/disposables.js +44 -0
  55. package/src/widget/lib/dom.js +106 -0
  56. package/src/widget/lib/events.js +65 -0
  57. package/src/widget/lib/headings.js +132 -0
  58. package/src/widget/lib/persisted-signal.js +40 -0
  59. package/src/widget/lib/storage.js +70 -0
  60. package/src/widget/live.js +86 -0
  61. package/src/widget/pages.js +65 -0
  62. package/src/widget/palette.css +162 -0
  63. package/src/widget/palette.js +259 -0
  64. package/src/widget/placement.js +204 -0
  65. package/src/widget/plugins.js +39 -0
  66. package/src/widget/rpc.js +32 -0
  67. package/src/widget/styles.js +31 -0
  68. package/src/widget/ui.js +50 -0
  69. package/src/widget/widget.css +206 -0
  70. package/server/files.mjs +0 -261
  71. package/server/index.mjs +0 -198
  72. package/server/inject.html +0 -88
  73. package/server/inject.mjs +0 -28
  74. package/server/watch.mjs +0 -104
  75. /package/{server → src/node}/state.mjs +0 -0
  76. /package/{server → src/node}/websocket.mjs +0 -0
@@ -0,0 +1,69 @@
1
+ // Nested folder/file tree built from a flat list of paths.
2
+ import { decoded } from "../../widget/lib/dom.js"
3
+
4
+ /** One row in the tree: a folder or an item leaf. */
5
+ export interface TreeNode<T> {
6
+ /** Display name (decoded last path segment). */
7
+ name: string
8
+ /** Root-relative path; also the collapse key. */
9
+ path: string
10
+ isFolder: boolean
11
+ children: TreeNode<T>[]
12
+ /** Set on leaves only. */
13
+ data?: T
14
+ }
15
+
16
+ /**
17
+ * Build a folder tree from a flat list. Folders come first at every level,
18
+ * then entries are sorted by display name (natural number order).
19
+ *
20
+ * @param items Flat entries, e.g. pages or assets.
21
+ * @param getPath Root-relative path for an entry, e.g. `/guides/intro.html`.
22
+ */
23
+ export function buildTree<T>(items: readonly T[], getPath: (item: T) => string): TreeNode<T>[] {
24
+ const root: TreeNode<T> = { name: "", path: "", isFolder: true, children: [] }
25
+ const folders = new Map<string, TreeNode<T>>([["", root]])
26
+
27
+ for (const item of items) {
28
+ const parts = getPath(item).split("/").filter(Boolean)
29
+ if (!parts.length) continue
30
+
31
+ let parent = root
32
+ let path = ""
33
+
34
+ for (const part of parts.slice(0, -1)) {
35
+ path = path ? `${path}/${part}` : part
36
+ let folder = folders.get(path)
37
+ if (!folder) {
38
+ folder = { name: decoded(part), path, isFolder: true, children: [] }
39
+ folders.set(path, folder)
40
+ parent.children.push(folder)
41
+ }
42
+ parent = folder
43
+ }
44
+
45
+ const name = parts[parts.length - 1]
46
+ parent.children.push({
47
+ name: decoded(name),
48
+ path: path ? `${path}/${name}` : name,
49
+ isFolder: false,
50
+ children: [],
51
+ data: item,
52
+ })
53
+ }
54
+
55
+ sortTree(root)
56
+
57
+ return root.children
58
+ }
59
+
60
+ function sortTree<T>(node: TreeNode<T>): void {
61
+ node.children.sort((a, b) => {
62
+ if (a.isFolder !== b.isFolder) return a.isFolder ? -1 : 1
63
+ return a.name.localeCompare(b.name, undefined, { numeric: true, sensitivity: "base" })
64
+ })
65
+
66
+ for (const child of node.children) {
67
+ if (child.isFolder) sortTree(child)
68
+ }
69
+ }
@@ -0,0 +1,153 @@
1
+ import { useCallback, useState } from "react"
2
+ import { decoded, displayDate, pageUrl } from "../../../widget/lib/dom.js"
3
+ import { groupByFolder, groupByMonth } from "../grouping.js"
4
+ import type { PreviewModel } from "./preview-model.js"
5
+ import type { SidebarModel, SidebarView } from "../model.js"
6
+
7
+ export interface PageListProps {
8
+ model: SidebarModel
9
+ previews?: PreviewModel
10
+ }
11
+
12
+ export function PageList({ model, previews }: PageListProps) {
13
+ const pages = model.pages.value
14
+ const view = model.view.value
15
+ const grouping = model.grouping.value
16
+ const currentPage = model.currentPage
17
+ const target = pageUrl(currentPage)
18
+
19
+ if (grouping === "none")
20
+ return pages.map((page) => (
21
+ <PageItem
22
+ key={itemKey(page, view)}
23
+ page={page}
24
+ view={view}
25
+ target={target}
26
+ currentPage={currentPage}
27
+ previews={previews}
28
+ />
29
+ ))
30
+
31
+ const groups = grouping === "folder" ? groupByFolder(pages) : groupByMonth(pages)
32
+
33
+ return groups.map((group) => {
34
+ const id = groupHeadingId(grouping, group.key)
35
+ const label = grouping === "folder" ? decoded(group.key) || "/" : group.label
36
+
37
+ return (
38
+ <section key={group.key || "root"} className="docserve-sidebar__group" aria-labelledby={id}>
39
+ <h2 className="docserve-sidebar__group-head" id={id}>
40
+ <span>{label}</span>
41
+ <span className="docserve-sidebar__group-count">{group.pages.length}</span>
42
+ </h2>
43
+ <div className="docserve-sidebar__group-body">
44
+ {group.pages.map((page) => (
45
+ <PageItem
46
+ key={itemKey(page, view)}
47
+ page={page}
48
+ view={view}
49
+ target={target}
50
+ currentPage={currentPage}
51
+ previews={previews}
52
+ />
53
+ ))}
54
+ </div>
55
+ </section>
56
+ )
57
+ })
58
+ }
59
+
60
+ interface PageItemProps {
61
+ page: DocPage
62
+ view: SidebarView
63
+ target: string
64
+ currentPage: string
65
+ previews?: PreviewModel
66
+ }
67
+
68
+ function PageItem({ page, view, target, currentPage, previews }: PageItemProps) {
69
+ const active = isActive(page, target, currentPage)
70
+
71
+ return view === "gallery"
72
+ ? <GalleryCard page={page} active={active} previews={previews} />
73
+ : <ListRow page={page} active={active} />
74
+ }
75
+
76
+ function itemKey(page: DocPage, view: SidebarView): string {
77
+ return view === "gallery" ? pageKey(page) : page.url
78
+ }
79
+
80
+ function groupHeadingId(grouping: string, key: string): string {
81
+ const name = key ? key.replace(/[^\w.-]+/g, "-") : grouping === "folder" ? "root" : "undated"
82
+ return `docserve-sidebar-group-${grouping}-${name}`
83
+ }
84
+
85
+ function pageKey(page: DocPage): string {
86
+ return `${page.url}:${page.modified ?? page.created}`
87
+ }
88
+
89
+ function ListRow({ page, active }: { page: DocPage; active: boolean }) {
90
+ const date = displayDate(page.created)
91
+
92
+ return (
93
+ <a
94
+ className="docserve-sidebar__item"
95
+ href={page.url}
96
+ title={date ? `${page.title} — ${date}` : page.title}
97
+ aria-current={active ? "page" : undefined}
98
+ >
99
+ <span className="docserve-sidebar__title">
100
+ <Favicon src={page.favicon} />
101
+ <span>{pageLabel(page)}</span>
102
+ </span>
103
+ </a>
104
+ )
105
+ }
106
+
107
+ function GalleryCard({ page, active, previews }: { page: DocPage; active: boolean; previews?: PreviewModel }) {
108
+ const label = pageLabel(page)
109
+ const setThumb = useCallback((element: HTMLDivElement | null) => previews?.watch(element), [previews])
110
+
111
+ return (
112
+ <a
113
+ className="docserve-sidebar__card"
114
+ href={page.url}
115
+ title={page.title}
116
+ aria-current={active ? "page" : undefined}
117
+ >
118
+ <div className="docserve-sidebar__thumb" ref={setThumb}>
119
+ <iframe tabIndex={-1} title={label} data-src={page.url} />
120
+ </div>
121
+ <div className="docserve-sidebar__meta">
122
+ <div className="docserve-sidebar__card-title">
123
+ <Favicon src={page.favicon} />
124
+ <span>{label}</span>
125
+ </div>
126
+ <div className="docserve-sidebar__card-date">{displayDate(page.created)}</div>
127
+ </div>
128
+ </a>
129
+ )
130
+ }
131
+
132
+ export function Favicon({ src }: { src?: string }) {
133
+ const [failed, setFailed] = useState(false)
134
+ if (!src || failed) return null
135
+
136
+ return (
137
+ <img
138
+ className="docserve-sidebar__favicon"
139
+ src={src}
140
+ alt=""
141
+ loading="lazy"
142
+ onError={() => setFailed(true)}
143
+ />
144
+ )
145
+ }
146
+
147
+ function isActive(page: DocPage, target: string, currentPage: string): boolean {
148
+ return page.url === target || decoded(page.url) === `/${currentPage}`
149
+ }
150
+
151
+ function pageLabel(page: DocPage): string {
152
+ return page.title || decoded(page.url)
153
+ }
@@ -0,0 +1,201 @@
1
+ import { effect, signal } from "@preact/signals-react"
2
+ import { useEffect } from "react"
3
+ import { ICON_CHECK, ICON_CHEVRON_DOWN } from "../icons.js"
4
+ import { useModel } from "./useModel.js"
5
+
6
+ export interface RadioMenuOption<T extends string> {
7
+ id: T
8
+ label: string
9
+ icon: string
10
+ }
11
+
12
+ export interface RadioMenuProps<T extends string> {
13
+ /** Accessible name for the menu and its trigger, e.g. "Grouping". */
14
+ label: string
15
+ value: T
16
+ options: readonly RadioMenuOption<T>[]
17
+ onChange: (value: T) => void
18
+ }
19
+
20
+ /** Open state, placement and event handling for a single-choice menu. */
21
+ export class RadioMenuModel {
22
+ readonly open = signal(false)
23
+ readonly position = signal<{ top: number; right: number } | null>(null)
24
+
25
+ #trigger: HTMLButtonElement | null = null
26
+ #menu: HTMLDivElement | null = null
27
+ #items: (HTMLButtonElement | null)[] = []
28
+
29
+ readonly setTrigger = (element: HTMLButtonElement | null): void => {
30
+ this.#trigger = element
31
+ }
32
+
33
+ readonly setMenu = (element: HTMLDivElement | null): void => {
34
+ this.#menu = element
35
+ }
36
+
37
+ readonly setItem = (index: number, element: HTMLButtonElement | null): void => {
38
+ this.#items[index] = element
39
+ }
40
+
41
+ /** Document-level dismiss listeners live only while the menu is open. */
42
+ subscribe(): () => void {
43
+ return effect(() => {
44
+ if (!this.open.value) return
45
+
46
+ document.addEventListener("pointerdown", this.#onPointerDown, true)
47
+ document.addEventListener("keydown", this.#onKeyDown, true)
48
+ window.addEventListener("resize", this.#onDismiss)
49
+ window.addEventListener("scroll", this.#onDismiss, true)
50
+
51
+ return () => {
52
+ document.removeEventListener("pointerdown", this.#onPointerDown, true)
53
+ document.removeEventListener("keydown", this.#onKeyDown, true)
54
+ window.removeEventListener("resize", this.#onDismiss)
55
+ window.removeEventListener("scroll", this.#onDismiss, true)
56
+ }
57
+ })
58
+ }
59
+
60
+ readonly toggle = (): void => {
61
+ if (this.open.value) {
62
+ this.close({ focusTrigger: false })
63
+ return
64
+ }
65
+
66
+ const rect = this.#trigger?.getBoundingClientRect()
67
+ if (!rect) return
68
+ // Fixed placement: the panel clips positioned descendants.
69
+ this.position.value = { top: rect.bottom + 4, right: Math.max(8, window.innerWidth - rect.right) }
70
+ this.open.value = true
71
+ }
72
+
73
+ close({ focusTrigger = true }: { focusTrigger?: boolean } = {}): void {
74
+ this.open.value = false
75
+ this.position.value = null
76
+ if (focusTrigger) this.#trigger?.focus()
77
+ }
78
+
79
+ select<T extends string>(id: T, onChange: (id: T) => void): void {
80
+ onChange(id)
81
+ this.close()
82
+ }
83
+
84
+ focusIndex(index: number): void {
85
+ this.#items[index]?.focus()
86
+ }
87
+
88
+ #moveFocus(key: string): void {
89
+ const items = this.#items.filter((item): item is HTMLButtonElement => item !== null)
90
+ if (!items.length) return
91
+
92
+ const index = items.indexOf(this.#activeItem())
93
+ const last = items.length - 1
94
+ let next = index
95
+
96
+ if (key === "Home") next = 0
97
+ else if (key === "End") next = last
98
+ else if (key === "ArrowDown") next = index < 0 ? 0 : (index + 1) % items.length
99
+ else next = index < 0 ? last : (index - 1 + items.length) % items.length
100
+
101
+ items[next]?.focus()
102
+ }
103
+
104
+ /** Focused element inside any shadow root that wraps the widget. */
105
+ #activeItem(): HTMLButtonElement | null {
106
+ let active: Element | null = document.activeElement
107
+ while (active?.shadowRoot?.activeElement) active = active.shadowRoot.activeElement
108
+ return active instanceof HTMLButtonElement ? active : null
109
+ }
110
+
111
+ #onPointerDown = (event: PointerEvent): void => {
112
+ const path = event.composedPath()
113
+ if (this.#menu && path.includes(this.#menu)) return
114
+ if (this.#trigger && path.includes(this.#trigger)) return
115
+ this.close({ focusTrigger: false })
116
+ }
117
+
118
+ #onKeyDown = (event: KeyboardEvent): void => {
119
+ if (event.key === "Escape") {
120
+ // Keep the shortcut from also closing the sidebar.
121
+ event.stopPropagation()
122
+ this.close()
123
+ return
124
+ }
125
+
126
+ if (event.key !== "ArrowDown" && event.key !== "ArrowUp" && event.key !== "Home" && event.key !== "End")
127
+ return
128
+
129
+ event.preventDefault()
130
+ this.#moveFocus(event.key)
131
+ }
132
+
133
+ #onDismiss = (): void => this.close({ focusTrigger: false })
134
+ }
135
+
136
+ export function RadioMenu<T extends string>({ label, value, options, onChange }: RadioMenuProps<T>) {
137
+ const menu = useModel(() => new RadioMenuModel())
138
+ const open = menu.open.value
139
+ const position = menu.position.value
140
+ const current = options.find((option) => option.id === value) ?? options[0]
141
+
142
+ // Focusing needs the rendered menu, so it runs after React commits.
143
+ useEffect(() => {
144
+ if (open)
145
+ menu.focusIndex(Math.max(0, options.findIndex((option) => option.id === value)))
146
+ }, [menu, open, value, options])
147
+
148
+ if (!current) return null
149
+
150
+ return (
151
+ <>
152
+ <button
153
+ ref={menu.setTrigger}
154
+ type="button"
155
+ className="docserve-sidebar__menu-trigger"
156
+ aria-label={`${label}: ${current.label}`}
157
+ title={`${label}: ${current.label}`}
158
+ aria-haspopup="menu"
159
+ aria-expanded={open}
160
+ onClick={menu.toggle}
161
+ >
162
+ <span className="docserve-sidebar__menu-trigger-icon" dangerouslySetInnerHTML={{ __html: current.icon }} />
163
+ <span className="docserve-sidebar__menu-trigger-caret" dangerouslySetInnerHTML={{ __html: ICON_CHEVRON_DOWN }} />
164
+ </button>
165
+ {open && position && (
166
+ <div
167
+ ref={menu.setMenu}
168
+ className="docserve-sidebar__menu"
169
+ role="menu"
170
+ aria-label={label}
171
+ style={{ top: `${position.top}px`, right: `${position.right}px` }}
172
+ >
173
+ <div className="docserve-sidebar__menu-label" role="presentation">{label}</div>
174
+ {options.map((option, index) => {
175
+ const checked = option.id === value
176
+
177
+ return (
178
+ <button
179
+ key={option.id}
180
+ ref={(element) => menu.setItem(index, element)}
181
+ type="button"
182
+ className="docserve-sidebar__menu-item"
183
+ role="menuitemradio"
184
+ aria-checked={checked}
185
+ onClick={() => menu.select(option.id, onChange)}
186
+ >
187
+ <span className="docserve-sidebar__menu-item-icon" dangerouslySetInnerHTML={{ __html: option.icon }} />
188
+ <span className="docserve-sidebar__menu-item-label">{option.label}</span>
189
+ <span
190
+ className="docserve-sidebar__menu-item-check"
191
+ aria-hidden="true"
192
+ dangerouslySetInnerHTML={{ __html: checked ? ICON_CHECK : "" }}
193
+ />
194
+ </button>
195
+ )
196
+ })}
197
+ </div>
198
+ )}
199
+ </>
200
+ )
201
+ }
@@ -0,0 +1,95 @@
1
+ import { useEffect, useLayoutEffect } from "react"
2
+ import type { CSSProperties } from "react"
3
+ import { PageList } from "./PageList.js"
4
+ import { PreviewModel } from "./preview-model.js"
5
+ import { SidebarHeader } from "./SidebarHeader.js"
6
+ import { TreeList } from "./TreeList.js"
7
+ import { useLayoutModel } from "./useModel.js"
8
+ import type { SidebarModel } from "../model.js"
9
+
10
+ export interface SidebarProps {
11
+ model: SidebarModel
12
+ }
13
+
14
+ export function Sidebar({ model }: SidebarProps) {
15
+ const docs = model.docs
16
+ const previews = useLayoutModel(() => new PreviewModel())
17
+ const pages = model.pages.value
18
+ const status = model.status.value
19
+ const view = model.view.value
20
+ const grouping = model.grouping.value
21
+ const open = model.open.value
22
+ const resizer = model.resizer
23
+ const resizing = resizer.resizing.value
24
+ const width = `min(${resizer.width.value}px, 86vw)`
25
+
26
+ const style = {
27
+ width,
28
+ ...(docs && { "--docserve-sidebar-hue": String(docs.hue) }),
29
+ } as CSSProperties
30
+
31
+ useLayoutEffect(() => {
32
+ if (!open) return
33
+ const html = document.documentElement
34
+ html.style.setProperty("--docserve-panel-left", width)
35
+ html.toggleAttribute("data-docserve-panel-left", true)
36
+
37
+ return () => {
38
+ html.style.removeProperty("--docserve-panel-left")
39
+ html.toggleAttribute("data-docserve-panel-left", false)
40
+ }
41
+ }, [open, width])
42
+
43
+ useEffect(() => {
44
+ if (!open) return
45
+ previews.element?.querySelector('[aria-current="page"]')?.scrollIntoView({ block: "nearest" })
46
+ }, [open, pages, view, grouping])
47
+
48
+ return (
49
+ <aside
50
+ className="docserve-panel docserve-sidebar"
51
+ data-side="left"
52
+ data-open={open ? "" : undefined}
53
+ data-view={view}
54
+ data-grouping={grouping}
55
+ data-resizing={resizing ? "" : undefined}
56
+ aria-label={docs?.name || "Pages"}
57
+ style={style}
58
+ >
59
+ <SidebarHeader model={model} />
60
+ <nav ref={previews.setRoot} className="docserve-sidebar__list" aria-label="Pages">
61
+ {status === "error"
62
+ ? (
63
+ <div className="docserve-sidebar__empty">
64
+ <p>Could not load pages</p>
65
+ <button
66
+ type="button"
67
+ className="docserve-sidebar__retry"
68
+ onClick={() => model.load({ force: true })}
69
+ >
70
+ Retry
71
+ </button>
72
+ </div>
73
+ )
74
+ : status === "loading" && !pages.length
75
+ ? <p className="docserve-sidebar__empty">Loading…</p>
76
+ : pages.length
77
+ ? view === "tree"
78
+ ? <TreeList model={model.tree} currentPage={model.currentPage} />
79
+ : <PageList model={model} previews={previews} />
80
+ : <p className="docserve-sidebar__empty">No pages</p>}
81
+ </nav>
82
+ <div
83
+ className="docserve-sidebar__resize"
84
+ role="separator"
85
+ aria-orientation="vertical"
86
+ aria-label="Resize sidebar"
87
+ onPointerDown={resizer.start}
88
+ onPointerMove={resizer.move}
89
+ onPointerUp={resizer.stop}
90
+ onPointerCancel={resizer.stop}
91
+ onLostPointerCapture={resizer.end}
92
+ />
93
+ </aside>
94
+ )
95
+ }
@@ -0,0 +1,87 @@
1
+ import { ICON_CALENDAR, ICON_FOLDER, ICON_GRID, ICON_LIST, ICON_SIDEBAR, ICON_TREE, ICON_UNGROUP } from "../icons.js"
2
+ import type { SidebarGrouping, SidebarModel } from "../model.js"
3
+ import { RadioMenu } from "./RadioMenu.js"
4
+ import type { RadioMenuOption } from "./RadioMenu.js"
5
+
6
+ const GROUPING_OPTIONS: RadioMenuOption<SidebarGrouping>[] = [
7
+ { id: "none", icon: ICON_UNGROUP, label: "No grouping" },
8
+ { id: "month", icon: ICON_CALENDAR, label: "By month" },
9
+ { id: "folder", icon: ICON_FOLDER, label: "By folder" },
10
+ ]
11
+
12
+ export interface SidebarHeaderProps {
13
+ model: SidebarModel
14
+ }
15
+
16
+ export function SidebarHeader({ model }: SidebarHeaderProps) {
17
+ const docs = model.docs
18
+ const name = docs?.name || "Pages"
19
+ const view = model.view.value
20
+ const grouping = model.grouping.value
21
+ const pages = model.pages.value
22
+ const files = model.status.value === "ready" ? pages.length : null
23
+
24
+ return (
25
+ <header className="docserve-sidebar__head">
26
+ <div className="docserve-sidebar__title">
27
+ <a className="docserve-sidebar__home" href="/" title="Open gallery">
28
+ <span className="docserve-sidebar__icon" dangerouslySetInnerHTML={{ __html: ICON_FOLDER }} />
29
+ <span className="docserve-sidebar__name" title={name}>{name}</span>
30
+ </a>
31
+ <button
32
+ type="button"
33
+ className="docserve-sidebar__close"
34
+ aria-label="Close sidebar"
35
+ title="Close sidebar"
36
+ onClick={() => model.setOpen(false)}
37
+ dangerouslySetInnerHTML={{ __html: ICON_SIDEBAR }}
38
+ />
39
+ </div>
40
+ <div className="docserve-sidebar__sub">
41
+ {docs && <code className="docserve-sidebar__path" title={docs.path}>{docs.path}</code>}
42
+ <span className="docserve-sidebar__files">
43
+ {files == null ? "" : `${files} ${files === 1 ? "file" : "files"}`}
44
+ </span>
45
+ </div>
46
+ <div className="docserve-sidebar__options">
47
+ {view !== "tree" && (
48
+ <RadioMenu
49
+ label="Grouping"
50
+ value={grouping}
51
+ options={GROUPING_OPTIONS}
52
+ onChange={(next) => model.setGrouping(next)}
53
+ />
54
+ )}
55
+ <div className="docserve-sidebar__views" role="group" aria-label="View">
56
+ <button
57
+ type="button"
58
+ className="docserve-sidebar__view"
59
+ aria-label="List view"
60
+ title="List view"
61
+ aria-pressed={view === "list"}
62
+ onClick={() => model.setView("list")}
63
+ dangerouslySetInnerHTML={{ __html: ICON_LIST }}
64
+ />
65
+ <button
66
+ type="button"
67
+ className="docserve-sidebar__view"
68
+ aria-label="Gallery view"
69
+ title="Gallery view"
70
+ aria-pressed={view === "gallery"}
71
+ onClick={() => model.setView("gallery")}
72
+ dangerouslySetInnerHTML={{ __html: ICON_GRID }}
73
+ />
74
+ <button
75
+ type="button"
76
+ className="docserve-sidebar__view"
77
+ aria-label="Tree view"
78
+ title="Tree view"
79
+ aria-pressed={view === "tree"}
80
+ onClick={() => model.setView("tree")}
81
+ dangerouslySetInnerHTML={{ __html: ICON_TREE }}
82
+ />
83
+ </div>
84
+ </div>
85
+ </header>
86
+ )
87
+ }