@noy4/docserve 0.3.2 → 0.3.3
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/bin.mjs +2 -2
- package/dist/widget/index.js +11155 -0
- package/package.json +24 -3
- package/src/node/adapter.mjs +67 -0
- package/src/node/assets.mjs +36 -0
- package/src/node/dates.mjs +73 -0
- package/src/node/docs-info.mjs +39 -0
- package/src/node/files.mjs +43 -0
- package/src/node/gallery.mjs +33 -0
- package/src/node/inject.mjs +43 -0
- package/src/node/meta.mjs +137 -0
- package/src/node/routes.mjs +105 -0
- package/src/node/scan.mjs +87 -0
- package/src/node/serve-static.mjs +158 -0
- package/src/node/server.mjs +69 -0
- package/src/node/watch.mjs +119 -0
- package/src/plugins/copy/client.js +72 -0
- package/src/plugins/copy/copy.css +21 -0
- package/src/plugins/home/client.js +24 -0
- package/src/plugins/sidebar/client.js +105 -0
- package/src/plugins/sidebar/grouping.js +108 -0
- package/src/plugins/sidebar/icons.js +25 -0
- package/src/plugins/sidebar/model.ts +91 -0
- package/src/plugins/sidebar/resize-model.ts +47 -0
- package/src/plugins/sidebar/sidebar.css +663 -0
- package/src/plugins/sidebar/tree-model.ts +23 -0
- package/src/plugins/sidebar/tree.ts +69 -0
- package/src/plugins/sidebar/ui/PageList.tsx +153 -0
- package/src/plugins/sidebar/ui/RadioMenu.tsx +201 -0
- package/src/plugins/sidebar/ui/Sidebar.tsx +95 -0
- package/src/plugins/sidebar/ui/SidebarHeader.tsx +87 -0
- package/src/plugins/sidebar/ui/TreeList.tsx +121 -0
- package/src/plugins/sidebar/ui/preview-model.ts +134 -0
- package/src/plugins/sidebar/ui/useModel.ts +25 -0
- package/src/shared/types.d.ts +193 -0
- package/src/widget/commands.js +214 -0
- package/src/widget/docks.js +127 -0
- package/src/widget/host.js +187 -0
- package/src/widget/index.js +14 -0
- package/src/widget/lib/disposables.js +44 -0
- package/src/widget/lib/dom.js +106 -0
- package/src/widget/lib/events.js +65 -0
- package/src/widget/lib/persisted-signal.js +40 -0
- package/src/widget/lib/storage.js +70 -0
- package/src/widget/live.js +86 -0
- package/src/widget/pages.js +65 -0
- package/src/widget/palette.css +162 -0
- package/src/widget/palette.js +259 -0
- package/src/widget/placement.js +204 -0
- package/src/widget/plugins.js +39 -0
- package/src/widget/rpc.js +32 -0
- package/src/widget/styles.js +31 -0
- package/src/widget/ui.js +50 -0
- package/src/widget/widget.css +193 -0
- package/server/files.mjs +0 -261
- package/server/index.mjs +0 -198
- package/server/inject.html +0 -88
- package/server/inject.mjs +0 -28
- package/server/watch.mjs +0 -104
- /package/{server → src/node}/state.mjs +0 -0
- /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
|
+
}
|