@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.
- package/bin.mjs +2 -2
- package/dist/widget/index.js +11803 -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/collapse/client.js +45 -0
- package/src/plugins/collapse/collapse.css +74 -0
- package/src/plugins/collapse/commands.ts +81 -0
- package/src/plugins/collapse/model.ts +123 -0
- package/src/plugins/collapse/sections.ts +105 -0
- package/src/plugins/collapse/view.ts +84 -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 +106 -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/plugins/toc/client.js +55 -0
- package/src/plugins/toc/commands.ts +49 -0
- package/src/plugins/toc/heading-html.ts +40 -0
- package/src/plugins/toc/model.ts +178 -0
- package/src/plugins/toc/outline.js +94 -0
- package/src/plugins/toc/scroll-spy.ts +35 -0
- package/src/plugins/toc/toc.css +214 -0
- package/src/plugins/toc/ui/TocPanel.tsx +87 -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 +22 -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/headings.js +132 -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 +206 -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,65 @@
|
|
|
1
|
+
// Generic event emitter, ported from devframe's `utils/events.ts`.
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* @template {EventsMap} [Events=EventsMap]
|
|
5
|
+
* @returns {EventEmitter<Events>}
|
|
6
|
+
*/
|
|
7
|
+
export function createEventEmitter() {
|
|
8
|
+
/** @type {EventEmitter<Events>['_listeners']} */
|
|
9
|
+
const _listeners = {}
|
|
10
|
+
|
|
11
|
+
/**
|
|
12
|
+
* @param {keyof Events} event
|
|
13
|
+
* @param {...any} args
|
|
14
|
+
*/
|
|
15
|
+
function emit(event, ...args) {
|
|
16
|
+
const callbacks = _listeners[event] || []
|
|
17
|
+
for (let i = 0, length = callbacks.length; i < length; i++) {
|
|
18
|
+
const callback = callbacks[i]
|
|
19
|
+
if (callback)
|
|
20
|
+
callback(...args)
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* @param {keyof Events} event
|
|
26
|
+
* @param {...any} args
|
|
27
|
+
*/
|
|
28
|
+
function emitOnce(event, ...args) {
|
|
29
|
+
emit(event, ...args)
|
|
30
|
+
delete _listeners[event]
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* @param {keyof Events} event
|
|
35
|
+
* @param {(...args: any[]) => void} cb
|
|
36
|
+
* @returns {EventUnsubscribe}
|
|
37
|
+
*/
|
|
38
|
+
function on(event, cb) {
|
|
39
|
+
;(_listeners[event] ||= []).push(/** @type {Events[keyof Events]} */ (cb))
|
|
40
|
+
return () => {
|
|
41
|
+
_listeners[event] = /** @type {any} */ (_listeners[event]?.filter(i => cb !== i))
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* @param {keyof Events} event
|
|
47
|
+
* @param {(...args: any[]) => void} cb
|
|
48
|
+
* @returns {EventUnsubscribe}
|
|
49
|
+
*/
|
|
50
|
+
function once(event, cb) {
|
|
51
|
+
const unsubscribe = on(event, (...args) => {
|
|
52
|
+
unsubscribe()
|
|
53
|
+
return cb(...args)
|
|
54
|
+
})
|
|
55
|
+
return unsubscribe
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
return {
|
|
59
|
+
_listeners,
|
|
60
|
+
emit,
|
|
61
|
+
emitOnce,
|
|
62
|
+
on,
|
|
63
|
+
once,
|
|
64
|
+
}
|
|
65
|
+
}
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
const DEFAULT_ROOTS = ["main", "article", ".container"]
|
|
2
|
+
const DEFAULT_EXCLUDED = "nav, aside, header, footer"
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* @typedef {{ element: HTMLHeadingElement, level: number, children: TocNode[] }} TocNode
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Content root: `data-*` root selector, else the first of main / article / .container, else body.
|
|
10
|
+
* @param {Document} [doc]
|
|
11
|
+
* @param {string} [attribute]
|
|
12
|
+
* @param {string[]} [selectors]
|
|
13
|
+
* @returns {HTMLElement | null}
|
|
14
|
+
*/
|
|
15
|
+
export function findRoot(doc = document, attribute = "data-toc-root", selectors = DEFAULT_ROOTS) {
|
|
16
|
+
const source = doc.body ?? doc.documentElement
|
|
17
|
+
if (!source) return null
|
|
18
|
+
|
|
19
|
+
const selector = source.getAttribute(attribute)
|
|
20
|
+
if (selector) {
|
|
21
|
+
try {
|
|
22
|
+
const custom = doc.querySelector(selector)
|
|
23
|
+
if (custom) return /** @type {HTMLElement} */ (custom)
|
|
24
|
+
} catch {}
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
for (const candidate of selectors) {
|
|
28
|
+
const element = doc.querySelector(candidate)
|
|
29
|
+
if (element) return /** @type {HTMLElement} */ (element)
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
return doc.body
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Headings inside `root` whose level falls in `range`, in document order.
|
|
37
|
+
* @param {HTMLElement | null} root
|
|
38
|
+
* @param {[number, number] | null} range
|
|
39
|
+
* @param {string} [excludedSelector]
|
|
40
|
+
* @returns {HTMLHeadingElement[]}
|
|
41
|
+
*/
|
|
42
|
+
export function collectHeadings(root, range, excludedSelector = DEFAULT_EXCLUDED) {
|
|
43
|
+
if (!root || !range) return []
|
|
44
|
+
|
|
45
|
+
const [min, max] = range
|
|
46
|
+
const headings = [...root.querySelectorAll("h1, h2, h3, h4, h5, h6")].filter((element) => {
|
|
47
|
+
const level = Number(element.tagName[1])
|
|
48
|
+
if (level < min || level > max) return false
|
|
49
|
+
if (!element.textContent?.trim()) return false
|
|
50
|
+
if (isHidden(element)) return false
|
|
51
|
+
|
|
52
|
+
const excluded = excludedSelector ? element.closest(excludedSelector) : null
|
|
53
|
+
return !excluded || excluded === root || !root.contains(excluded)
|
|
54
|
+
})
|
|
55
|
+
|
|
56
|
+
return /** @type {HTMLHeadingElement[]} */ (headings)
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Give every heading a stable, unique id; existing ids are kept.
|
|
61
|
+
* @param {HTMLHeadingElement[]} headings
|
|
62
|
+
* @param {Document} [doc]
|
|
63
|
+
*/
|
|
64
|
+
export function ensureIds(headings, doc = document) {
|
|
65
|
+
const reserved = new Set()
|
|
66
|
+
for (const element of doc.querySelectorAll("[id]")) {
|
|
67
|
+
if (element.id) reserved.add(element.id)
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
for (const heading of headings) {
|
|
71
|
+
if (heading.id) continue
|
|
72
|
+
|
|
73
|
+
const base = slugify(heading.textContent ?? "")
|
|
74
|
+
let id = base
|
|
75
|
+
let index = 2
|
|
76
|
+
while (!id || reserved.has(id)) id = base ? `${base}-${index++}` : `section-${index++}`
|
|
77
|
+
|
|
78
|
+
heading.id = id
|
|
79
|
+
reserved.add(id)
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* `Hello, World!` → `hello-world`.
|
|
85
|
+
* @param {string} text
|
|
86
|
+
* @returns {string}
|
|
87
|
+
*/
|
|
88
|
+
export function slugify(text) {
|
|
89
|
+
return text.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "")
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* Nest headings by level: a heading becomes a child while its level is greater
|
|
94
|
+
* than the previous one.
|
|
95
|
+
* @param {HTMLHeadingElement[]} headings
|
|
96
|
+
* @returns {TocNode[]}
|
|
97
|
+
*/
|
|
98
|
+
export function buildTree(headings) {
|
|
99
|
+
/** @type {TocNode[]} */
|
|
100
|
+
const roots = []
|
|
101
|
+
/** @type {TocNode[]} */
|
|
102
|
+
const stack = []
|
|
103
|
+
|
|
104
|
+
for (const element of headings) {
|
|
105
|
+
const node = { element, level: Number(element.tagName[1]), children: [] }
|
|
106
|
+
while (stack.length && stack[stack.length - 1].level >= node.level) stack.pop()
|
|
107
|
+
if (stack.length) stack[stack.length - 1].children.push(node)
|
|
108
|
+
else roots.push(node)
|
|
109
|
+
stack.push(node)
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
return roots
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* @param {Element} element
|
|
117
|
+
* @returns {boolean}
|
|
118
|
+
*/
|
|
119
|
+
function isHidden(element) {
|
|
120
|
+
if (element.hasAttribute("hidden") || element.getAttribute("aria-hidden") === "true") return true
|
|
121
|
+
if (element.closest("details:not([open])")) return true
|
|
122
|
+
|
|
123
|
+
const view = element.ownerDocument.defaultView
|
|
124
|
+
if (!view) return false
|
|
125
|
+
|
|
126
|
+
for (let node = element; node; node = node.parentElement) {
|
|
127
|
+
const style = view.getComputedStyle(node)
|
|
128
|
+
if (style.display === "none" || style.visibility === "hidden") return true
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
return false
|
|
132
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
// Signal backed by localStorage: read once on creation, written on change.
|
|
2
|
+
import { signal } from "@preact/signals-react"
|
|
3
|
+
import { persisted as persistedStore } from "./storage.js"
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @template T
|
|
7
|
+
* @param {string} key
|
|
8
|
+
* @param {T} [initial] Used when the key is absent or cannot be parsed.
|
|
9
|
+
* @param {object} [options]
|
|
10
|
+
* @param {(raw: string) => T} [options.parse]
|
|
11
|
+
* @param {(value: T) => string} [options.serialize]
|
|
12
|
+
* @returns {import("@preact/signals-react").Signal<T>}
|
|
13
|
+
*/
|
|
14
|
+
export function persisted(key, initial, options = {}) {
|
|
15
|
+
const store = persistedStore(key, initial, options)
|
|
16
|
+
const value = signal(store.value)
|
|
17
|
+
|
|
18
|
+
// `subscribe` runs once immediately; skip that write so construction alone
|
|
19
|
+
// does not create the key.
|
|
20
|
+
let first = true
|
|
21
|
+
value.subscribe((next) => {
|
|
22
|
+
if (first) {
|
|
23
|
+
first = false
|
|
24
|
+
return
|
|
25
|
+
}
|
|
26
|
+
store.value = next
|
|
27
|
+
})
|
|
28
|
+
|
|
29
|
+
return value
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Boolean variant of `persisted`.
|
|
34
|
+
* @param {string} key
|
|
35
|
+
* @param {boolean} [initial]
|
|
36
|
+
* @returns {import("@preact/signals-react").Signal<boolean>}
|
|
37
|
+
*/
|
|
38
|
+
export function persistedBool(key, initial = false) {
|
|
39
|
+
return persisted(key, initial, { parse: (raw) => raw === "true" })
|
|
40
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
// localStorage-backed values.
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* @template T
|
|
5
|
+
* @typedef {object} Persisted
|
|
6
|
+
* @property {T} value
|
|
7
|
+
* @property {() => void} clear
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* @template T
|
|
12
|
+
* @param {string} key
|
|
13
|
+
* @param {T} [initial] Returned when the key is absent or cannot be parsed.
|
|
14
|
+
* Object values (arrays included) default to JSON parse/serialize; primitives
|
|
15
|
+
* default to plain strings.
|
|
16
|
+
* @param {object} [options]
|
|
17
|
+
* @param {(raw: string) => T} [options.parse]
|
|
18
|
+
* @param {(value: T) => string} [options.serialize]
|
|
19
|
+
* @returns {Persisted<T>}
|
|
20
|
+
*/
|
|
21
|
+
export function persisted(key, initial = /** @type {any} */ (null), options = {}) {
|
|
22
|
+
// Object initial values are stored as JSON; primitives as plain strings.
|
|
23
|
+
const json = initial !== null && typeof initial === "object"
|
|
24
|
+
const {
|
|
25
|
+
parse = json ? (raw) => JSON.parse(raw) : (raw) => /** @type {any} */(raw),
|
|
26
|
+
serialize = json ? (value) => JSON.stringify(value) : (value) => String(value),
|
|
27
|
+
} = options
|
|
28
|
+
|
|
29
|
+
function read() {
|
|
30
|
+
try {
|
|
31
|
+
const raw = localStorage.getItem(key)
|
|
32
|
+
return raw == null ? initial : parse(raw)
|
|
33
|
+
} catch {
|
|
34
|
+
return initial
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function write(value) {
|
|
39
|
+
try {
|
|
40
|
+
localStorage.setItem(key, serialize(value))
|
|
41
|
+
} catch { }
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
return {
|
|
45
|
+
get value() {
|
|
46
|
+
return read()
|
|
47
|
+
},
|
|
48
|
+
set value(next) {
|
|
49
|
+
write(next)
|
|
50
|
+
},
|
|
51
|
+
clear() {
|
|
52
|
+
try {
|
|
53
|
+
localStorage.removeItem(key)
|
|
54
|
+
} catch { }
|
|
55
|
+
},
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Boolean variant: stores `"true"` / `"false"`.
|
|
61
|
+
* @param {string} key
|
|
62
|
+
* @param {boolean} [initial]
|
|
63
|
+
* @returns {Persisted<boolean>}
|
|
64
|
+
*/
|
|
65
|
+
export function persistedFlag(key, initial = false) {
|
|
66
|
+
return persisted(key, initial, {
|
|
67
|
+
parse: (raw) => raw === "true",
|
|
68
|
+
serialize: (value) => String(value),
|
|
69
|
+
})
|
|
70
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
// Live reload over the server's /__reload websocket, with reconnect backoff.
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* @typedef {object} LiveHandle
|
|
5
|
+
* @property {() => void} close
|
|
6
|
+
* @property {() => boolean} isOpen
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Subscribe to reload events. Reconnects with exponential backoff; a dropped
|
|
11
|
+
* socket never reloads the page by itself.
|
|
12
|
+
* @param {object} options
|
|
13
|
+
* @param {string} [options.path]
|
|
14
|
+
* @param {(message: LiveMessage) => void} options.onMessage
|
|
15
|
+
* @param {() => void} [options.onOpen]
|
|
16
|
+
* @returns {LiveHandle}
|
|
17
|
+
*/
|
|
18
|
+
export function connectLive({ path = "/__reload", onMessage, onOpen }) {
|
|
19
|
+
const MIN_DELAY = 500
|
|
20
|
+
const MAX_DELAY = 10000
|
|
21
|
+
|
|
22
|
+
/** @type {WebSocket | null} */
|
|
23
|
+
let socket = null
|
|
24
|
+
let delay = MIN_DELAY
|
|
25
|
+
/** @type {ReturnType<typeof setTimeout> | null} */
|
|
26
|
+
let timer = null
|
|
27
|
+
let closed = false
|
|
28
|
+
|
|
29
|
+
open()
|
|
30
|
+
|
|
31
|
+
return {
|
|
32
|
+
close() {
|
|
33
|
+
closed = true
|
|
34
|
+
if (timer) clearTimeout(timer)
|
|
35
|
+
timer = null
|
|
36
|
+
socket?.close()
|
|
37
|
+
socket = null
|
|
38
|
+
},
|
|
39
|
+
isOpen() {
|
|
40
|
+
return socket?.readyState === WebSocket.OPEN
|
|
41
|
+
},
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function open() {
|
|
45
|
+
if (closed) return
|
|
46
|
+
const proto = location.protocol === "https:" ? "wss:" : "ws:"
|
|
47
|
+
const ws = new WebSocket(`${proto}//${location.host}${path}`)
|
|
48
|
+
socket = ws
|
|
49
|
+
|
|
50
|
+
ws.addEventListener("open", () => {
|
|
51
|
+
if (closed) return
|
|
52
|
+
delay = MIN_DELAY
|
|
53
|
+
onOpen?.()
|
|
54
|
+
})
|
|
55
|
+
|
|
56
|
+
ws.addEventListener("message", (event) => {
|
|
57
|
+
if (closed) return
|
|
58
|
+
let message
|
|
59
|
+
try {
|
|
60
|
+
message = JSON.parse(event.data)
|
|
61
|
+
} catch {
|
|
62
|
+
return
|
|
63
|
+
}
|
|
64
|
+
if (message && typeof message === "object") onMessage(message)
|
|
65
|
+
})
|
|
66
|
+
|
|
67
|
+
ws.addEventListener("close", () => {
|
|
68
|
+
if (closed || socket !== ws) return
|
|
69
|
+
socket = null
|
|
70
|
+
schedule()
|
|
71
|
+
})
|
|
72
|
+
|
|
73
|
+
ws.addEventListener("error", () => {
|
|
74
|
+
// A failed connect also fires close; nothing to do here.
|
|
75
|
+
})
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function schedule() {
|
|
79
|
+
if (closed || timer) return
|
|
80
|
+
timer = setTimeout(() => {
|
|
81
|
+
timer = null
|
|
82
|
+
open()
|
|
83
|
+
}, delay)
|
|
84
|
+
delay = Math.min(delay * 2, MAX_DELAY)
|
|
85
|
+
}
|
|
86
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
// Page listing for the widget: /api/files, cached until a change arrives.
|
|
2
|
+
import { decoded, pageUrl } from "./lib/dom.js"
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* @param {{ rpc: RpcContext }} options
|
|
6
|
+
*/
|
|
7
|
+
export function createPages({ rpc }) {
|
|
8
|
+
/** @type {DocPage[] | null} */
|
|
9
|
+
let cache = null
|
|
10
|
+
/** @type {Promise<DocPage[]> | null} */
|
|
11
|
+
let pending = null
|
|
12
|
+
|
|
13
|
+
rpc.register("docserve:pages:list", list)
|
|
14
|
+
rpc.register("docserve:pages:resolve", resolve)
|
|
15
|
+
|
|
16
|
+
return {
|
|
17
|
+
list,
|
|
18
|
+
resolve,
|
|
19
|
+
/** Drop the cache so the next read refetches. */
|
|
20
|
+
invalidate() {
|
|
21
|
+
cache = null
|
|
22
|
+
pending = null
|
|
23
|
+
},
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* @param {{ force?: boolean }} [options]
|
|
28
|
+
* @returns {Promise<DocPage[]>}
|
|
29
|
+
*/
|
|
30
|
+
async function list({ force = false } = {}) {
|
|
31
|
+
if (force) {
|
|
32
|
+
cache = null
|
|
33
|
+
pending = null
|
|
34
|
+
}
|
|
35
|
+
if (cache) return cache
|
|
36
|
+
if (pending) return pending
|
|
37
|
+
|
|
38
|
+
pending = fetch("/api/files", { headers: { accept: "application/json" } })
|
|
39
|
+
.then((response) => {
|
|
40
|
+
if (!response.ok) throw new Error(`/api/files: ${response.status}`)
|
|
41
|
+
return response.json()
|
|
42
|
+
})
|
|
43
|
+
.then((data) => {
|
|
44
|
+
const pages = Array.isArray(data) ? data : []
|
|
45
|
+
cache = pages
|
|
46
|
+
return pages
|
|
47
|
+
})
|
|
48
|
+
.finally(() => {
|
|
49
|
+
pending = null
|
|
50
|
+
})
|
|
51
|
+
|
|
52
|
+
return pending
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Find the page a docs-relative path points at.
|
|
57
|
+
* @param {string} page e.g. `guides/intro.html`
|
|
58
|
+
* @returns {Promise<DocPage | null>}
|
|
59
|
+
*/
|
|
60
|
+
async function resolve(page) {
|
|
61
|
+
const target = pageUrl(page)
|
|
62
|
+
const pages = await list()
|
|
63
|
+
return pages.find((entry) => entry.url === target || decoded(entry.url) === `/${page}`) ?? null
|
|
64
|
+
}
|
|
65
|
+
}
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
/* Command palette. Colours come from the host's variables in widget.css. */
|
|
2
|
+
|
|
3
|
+
.docserve-palette {
|
|
4
|
+
display: none;
|
|
5
|
+
position: fixed;
|
|
6
|
+
inset: 0;
|
|
7
|
+
z-index: 2;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
.docserve-palette[data-open] {
|
|
11
|
+
display: block;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
.docserve-palette__backdrop {
|
|
15
|
+
position: absolute;
|
|
16
|
+
inset: 0;
|
|
17
|
+
background: rgba(15, 23, 42, 0.28);
|
|
18
|
+
backdrop-filter: blur(2px);
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
.docserve-palette__dialog {
|
|
22
|
+
position: absolute;
|
|
23
|
+
left: 50%;
|
|
24
|
+
top: 18vh;
|
|
25
|
+
transform: translateX(-50%);
|
|
26
|
+
display: flex;
|
|
27
|
+
flex-direction: column;
|
|
28
|
+
width: min(560px, 92vw);
|
|
29
|
+
max-height: 60vh;
|
|
30
|
+
overflow: hidden;
|
|
31
|
+
border: 1px solid var(--docserve-panel-border);
|
|
32
|
+
border-radius: 14px;
|
|
33
|
+
background: var(--docserve-panel-bg);
|
|
34
|
+
color: var(--docserve-panel-text);
|
|
35
|
+
box-shadow: 0 24px 60px rgba(0, 0, 0, 0.28);
|
|
36
|
+
font-size: 14px;
|
|
37
|
+
line-height: 1.45;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
.docserve-palette__input {
|
|
41
|
+
flex: none;
|
|
42
|
+
width: 100%;
|
|
43
|
+
padding: 14px 16px;
|
|
44
|
+
border: 0;
|
|
45
|
+
border-bottom: 1px solid var(--docserve-panel-border);
|
|
46
|
+
background: transparent;
|
|
47
|
+
color: inherit;
|
|
48
|
+
font: inherit;
|
|
49
|
+
font-size: 15px;
|
|
50
|
+
outline: none;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
.docserve-palette__list {
|
|
54
|
+
flex: 1;
|
|
55
|
+
margin: 0;
|
|
56
|
+
padding: 6px;
|
|
57
|
+
overflow-y: auto;
|
|
58
|
+
list-style: none;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
.docserve-palette__row {
|
|
62
|
+
display: flex;
|
|
63
|
+
align-items: center;
|
|
64
|
+
gap: 10px;
|
|
65
|
+
padding: 8px 10px;
|
|
66
|
+
border-radius: 8px;
|
|
67
|
+
cursor: pointer;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
.docserve-palette__row[aria-selected="true"] {
|
|
71
|
+
background: var(--docserve-dock-accent-soft);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
.docserve-palette__icon {
|
|
75
|
+
display: grid;
|
|
76
|
+
place-items: center;
|
|
77
|
+
flex: none;
|
|
78
|
+
color: var(--docserve-dock-muted);
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
.docserve-palette__row[aria-selected="true"] .docserve-palette__icon {
|
|
82
|
+
color: var(--docserve-dock-accent);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
.docserve-palette__icon svg {
|
|
86
|
+
width: 16px;
|
|
87
|
+
height: 16px;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
.docserve-palette__text {
|
|
91
|
+
display: flex;
|
|
92
|
+
flex: 1;
|
|
93
|
+
flex-direction: column;
|
|
94
|
+
min-width: 0;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
.docserve-palette__title {
|
|
98
|
+
overflow: hidden;
|
|
99
|
+
white-space: nowrap;
|
|
100
|
+
text-overflow: ellipsis;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
.docserve-palette__hint {
|
|
104
|
+
overflow: hidden;
|
|
105
|
+
white-space: nowrap;
|
|
106
|
+
text-overflow: ellipsis;
|
|
107
|
+
color: var(--docserve-panel-muted);
|
|
108
|
+
font-size: 12px;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
.docserve-palette__keys {
|
|
112
|
+
display: flex;
|
|
113
|
+
flex: none;
|
|
114
|
+
gap: 4px;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
.docserve-palette__key {
|
|
118
|
+
flex: none;
|
|
119
|
+
padding: 0 5px;
|
|
120
|
+
border: 1px solid var(--docserve-panel-border);
|
|
121
|
+
border-radius: 5px;
|
|
122
|
+
color: var(--docserve-dock-muted);
|
|
123
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
124
|
+
font-size: 11px;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
.docserve-palette__empty {
|
|
128
|
+
display: none;
|
|
129
|
+
margin: 0;
|
|
130
|
+
padding: 24px 16px;
|
|
131
|
+
color: var(--docserve-panel-muted);
|
|
132
|
+
font-size: 13px;
|
|
133
|
+
text-align: center;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
.docserve-palette__empty[data-visible] {
|
|
137
|
+
display: block;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
.docserve-palette__footer {
|
|
141
|
+
display: flex;
|
|
142
|
+
flex: none;
|
|
143
|
+
gap: 16px;
|
|
144
|
+
padding: 8px 14px;
|
|
145
|
+
border-top: 1px solid var(--docserve-panel-border);
|
|
146
|
+
color: var(--docserve-panel-muted);
|
|
147
|
+
font-size: 11px;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
.docserve-palette__legend {
|
|
151
|
+
display: flex;
|
|
152
|
+
align-items: center;
|
|
153
|
+
gap: 4px;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
.docserve-palette__legend kbd {
|
|
157
|
+
padding: 0 4px;
|
|
158
|
+
border: 1px solid var(--docserve-panel-border);
|
|
159
|
+
border-radius: 4px;
|
|
160
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
161
|
+
font-size: 11px;
|
|
162
|
+
}
|