@noy4/docserve 0.3.4 → 0.3.5
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 +8 -213
- package/dist/gallery/assets/index-CGV64tuk.css +1 -0
- package/dist/gallery/assets/index-Cf8Uf0vA.js +10 -0
- package/dist/gallery/assets/index-Cf8Uf0vA.js.map +1 -0
- package/dist/gallery/index.html +15 -0
- package/dist/node/cli.mjs +4095 -0
- package/dist/node/cli.mjs.map +7 -0
- package/dist/widget/index.js +730 -495
- package/package.json +14 -4
- package/src/node/cli.mjs +155 -0
- package/src/node/{files.mjs → docs/files.mjs} +1 -1
- package/src/node/{inject.mjs → docs/inject.mjs} +1 -1
- package/src/node/{meta.mjs → docs/meta.mjs} +1 -1
- package/src/node/http/app.mjs +20 -0
- package/src/node/{assets.mjs → http/assets.mjs} +3 -2
- package/src/node/http/gallery.mjs +45 -0
- package/src/node/http/response.mjs +31 -0
- package/src/node/http/routes.mjs +59 -0
- package/src/node/{serve-static.mjs → http/serve-static.mjs} +1 -1
- package/src/node/{server.mjs → http/server.mjs} +10 -10
- package/src/node/{state.mjs → instances/state.mjs} +9 -5
- package/src/node/instances/view.mjs +19 -0
- package/src/node/{watch.mjs → live/watch.mjs} +1 -1
- package/src/node/paths.mjs +10 -0
- package/src/node/rpc/files.mjs +5 -0
- package/src/node/rpc/index.mjs +39 -0
- package/src/node/rpc/route.mjs +34 -0
- package/src/node/rpc/servers.mjs +16 -0
- package/src/plugins/servers/client.js +77 -0
- package/src/plugins/servers/commands.ts +30 -0
- package/src/plugins/servers/model.ts +106 -0
- package/src/plugins/servers/servers.css +144 -0
- package/src/plugins/servers/ui/ServersPopover.tsx +71 -0
- package/src/plugins/sidebar/ui/PageList.tsx +1 -1
- package/src/plugins/sidebar/ui/RadioMenu.tsx +1 -1
- package/src/plugins/sidebar/ui/Sidebar.tsx +3 -3
- package/src/plugins/sidebar/ui/TreeList.tsx +10 -3
- package/src/{plugins/sidebar/ui → shared/client}/preview-model.ts +18 -4
- package/src/{plugins/sidebar/ui/useModel.ts → shared/client/use-model.ts} +1 -8
- package/src/shared/types.d.ts +17 -1
- package/src/widget/{pages.js → api/pages.js} +4 -7
- package/src/widget/api/rpc-client.js +25 -0
- package/src/widget/api/servers.js +46 -0
- package/src/widget/host.js +10 -8
- package/src/widget/index.js +2 -0
- package/src/widget/{docks.js → shell/docks.js} +2 -2
- package/src/widget/{palette.js → shell/palette.js} +3 -3
- package/src/widget/{placement.js → shell/placement.js} +1 -1
- package/src/widget/{ui.js → shell/ui.js} +1 -1
- package/index.html +0 -365
- package/src/node/adapter.mjs +0 -67
- package/src/node/gallery.mjs +0 -33
- package/src/node/routes.mjs +0 -105
- /package/src/node/{dates.mjs → docs/dates.mjs} +0 -0
- /package/src/node/{docs-info.mjs → docs/info.mjs} +0 -0
- /package/src/node/{scan.mjs → docs/scan.mjs} +0 -0
- /package/src/node/{websocket.mjs → live/websocket.mjs} +0 -0
- /package/src/widget/{live.js → api/live.js} +0 -0
- /package/src/widget/{rpc.js → api/rpc.js} +0 -0
- /package/src/widget/{palette.css → shell/palette.css} +0 -0
- /package/src/widget/{styles.js → shell/styles.js} +0 -0
package/bin.mjs
CHANGED
|
@@ -1,221 +1,16 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
//
|
|
4
|
-
// docserve [dir] [command] [options]
|
|
5
|
-
//
|
|
6
|
-
// Flow:
|
|
7
|
-
// parse args ──▶ stop / status ──▶ state files
|
|
8
|
-
// └─ start
|
|
9
|
-
// ├─ single-instance check (findByDir)
|
|
10
|
-
// ├─ --background ──▶ spawn detached ──▶ wait for the state file
|
|
11
|
-
// └─ foreground ──▶ runServer() (writes its state file on bind)
|
|
12
|
-
import fs from "node:fs"
|
|
13
|
-
import path from "node:path"
|
|
14
|
-
import { exec, spawn } from "node:child_process"
|
|
15
|
-
import { fileURLToPath } from "node:url"
|
|
16
|
-
import { parseArgs } from "node:util"
|
|
17
|
-
import { runServer } from "./src/node/server.mjs"
|
|
18
|
-
import { findByDir, listLiveStates, removeState } from "./src/node/state.mjs"
|
|
2
|
+
import { existsSync } from "node:fs"
|
|
19
3
|
|
|
20
|
-
const
|
|
21
|
-
const VERSION = pkg.version
|
|
22
|
-
const DEFAULT_PORT = 4242
|
|
23
|
-
const SUBCOMMANDS = ["stop", "status"]
|
|
4
|
+
const entry = new URL("./dist/node/cli.mjs", import.meta.url)
|
|
24
5
|
|
|
25
|
-
|
|
26
|
-
docserve
|
|
27
|
-
|
|
28
|
-
Usage:
|
|
29
|
-
docserve [dir] [command] [options]
|
|
30
|
-
|
|
31
|
-
Arguments:
|
|
32
|
-
dir Folder of HTML files to serve (default: current directory)
|
|
33
|
-
|
|
34
|
-
Commands:
|
|
35
|
-
stop Stop the server serving [dir], or every server when [dir] is omitted
|
|
36
|
-
status List the running servers (url + docs); exit 1 if none
|
|
37
|
-
|
|
38
|
-
Options:
|
|
39
|
-
--open Open the gallery in the browser once the port is bound
|
|
40
|
-
--port <number> Port to bind (default: ${DEFAULT_PORT}); falls back +1 up to 20 tries
|
|
41
|
-
--background Start detached; the bound port and pid land in the state dir
|
|
42
|
-
-h, --help Show this help
|
|
43
|
-
-v, --version Show version
|
|
44
|
-
`
|
|
45
|
-
|
|
46
|
-
async function main() {
|
|
47
|
-
const args = parseCliArgs()
|
|
48
|
-
if (args.command === "stop") return stopServer(args)
|
|
49
|
-
if (args.command === "status") return showStatus()
|
|
50
|
-
return startServer(args)
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
function parseCliArgs() {
|
|
54
|
-
let parsed
|
|
55
|
-
try {
|
|
56
|
-
parsed = parseArgs({
|
|
57
|
-
allowPositionals: true,
|
|
58
|
-
options: {
|
|
59
|
-
open: { type: "boolean" },
|
|
60
|
-
port: { type: "string" },
|
|
61
|
-
background: { type: "boolean" },
|
|
62
|
-
help: { type: "boolean", short: "h" },
|
|
63
|
-
version: { type: "boolean", short: "v" },
|
|
64
|
-
},
|
|
65
|
-
})
|
|
66
|
-
} catch (err) {
|
|
67
|
-
console.error(`[docserve] ${err.message}`)
|
|
68
|
-
console.error(HELP)
|
|
69
|
-
process.exit(1)
|
|
70
|
-
}
|
|
71
|
-
if (parsed.values.help) {
|
|
72
|
-
console.log(HELP)
|
|
73
|
-
process.exit(0)
|
|
74
|
-
}
|
|
75
|
-
if (parsed.values.version) {
|
|
76
|
-
console.log(VERSION)
|
|
77
|
-
process.exit(0)
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
let dir = null
|
|
81
|
-
let command = null
|
|
82
|
-
for (const positional of parsed.positionals) {
|
|
83
|
-
if (dir === null && command === null && SUBCOMMANDS.includes(positional)) {
|
|
84
|
-
command = positional
|
|
85
|
-
continue
|
|
86
|
-
}
|
|
87
|
-
if (dir === null) {
|
|
88
|
-
dir = positional
|
|
89
|
-
continue
|
|
90
|
-
}
|
|
91
|
-
if (command === null && SUBCOMMANDS.includes(positional)) {
|
|
92
|
-
command = positional
|
|
93
|
-
continue
|
|
94
|
-
}
|
|
95
|
-
console.error(`[docserve] Unexpected argument "${positional}".`)
|
|
96
|
-
process.exit(1)
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
let port = DEFAULT_PORT
|
|
100
|
-
if (parsed.values.port !== undefined) {
|
|
101
|
-
port = Number(parsed.values.port)
|
|
102
|
-
if (!Number.isInteger(port) || port < 1 || port > 65535) {
|
|
103
|
-
console.error(`[docserve] --port expects an integer between 1 and 65535, got "${parsed.values.port}"`)
|
|
104
|
-
process.exit(1)
|
|
105
|
-
}
|
|
106
|
-
}
|
|
107
|
-
|
|
108
|
-
return {
|
|
109
|
-
dir,
|
|
110
|
-
command,
|
|
111
|
-
port,
|
|
112
|
-
open: parsed.values.open ?? false,
|
|
113
|
-
background: parsed.values.background ?? false,
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
function stopServer(args) {
|
|
118
|
-
const dir = args.dir ? path.resolve(args.dir) : null
|
|
119
|
-
// listLiveStates() prunes stale state (dead pid) silently.
|
|
120
|
-
const states = dir ? [findByDir(dir)].filter(Boolean) : listLiveStates()
|
|
121
|
-
if (!states.length) {
|
|
122
|
-
if (dir) {
|
|
123
|
-
console.error(`docserve is not serving ${dir}.`)
|
|
124
|
-
process.exit(1)
|
|
125
|
-
}
|
|
126
|
-
console.log("docserve is not running.")
|
|
127
|
-
return
|
|
128
|
-
}
|
|
129
|
-
for (const state of states) {
|
|
130
|
-
try {
|
|
131
|
-
process.kill(state.pid, "SIGTERM")
|
|
132
|
-
} catch {}
|
|
133
|
-
removeState(state)
|
|
134
|
-
console.log(`Stopped docserve (${state.url})`)
|
|
135
|
-
console.log(` docs : ${state.docsDir}`)
|
|
136
|
-
}
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
function showStatus() {
|
|
140
|
-
const states = listLiveStates()
|
|
141
|
-
if (!states.length) {
|
|
142
|
-
console.error("docserve is not running.")
|
|
143
|
-
process.exit(1)
|
|
144
|
-
}
|
|
145
|
-
for (const [index, state] of states.entries()) {
|
|
146
|
-
if (index > 0) console.log()
|
|
147
|
-
console.log(state.url)
|
|
148
|
-
console.log(`docs : ${state.docsDir}`)
|
|
149
|
-
}
|
|
150
|
-
}
|
|
151
|
-
|
|
152
|
-
async function startServer(args) {
|
|
153
|
-
const docsDir = path.resolve(args.dir ?? ".")
|
|
154
|
-
if (!isDirectory(docsDir)) {
|
|
155
|
-
console.error(`[docserve] Directory not found: ${docsDir}`)
|
|
156
|
-
process.exit(1)
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
// Single instance per folder: same docsDir just opens its URL; a different
|
|
160
|
-
// docsDir starts its own instance (the port fallback avoids collisions).
|
|
161
|
-
const running = findByDir(docsDir)
|
|
162
|
-
if (running) {
|
|
163
|
-
if (args.open) openBrowser(running.url)
|
|
164
|
-
console.log(`docserve is already serving this folder: ${running.url}`)
|
|
165
|
-
return
|
|
166
|
-
}
|
|
167
|
-
|
|
168
|
-
if (args.background) return startBackground(args, docsDir)
|
|
169
|
-
|
|
170
|
-
console.log(`docserve v${pkg.version}`)
|
|
171
|
-
console.log(`docs : ${docsDir}`)
|
|
172
|
-
await runServer({ docsDir, port: args.port, open: args.open })
|
|
173
|
-
}
|
|
174
|
-
|
|
175
|
-
async function startBackground(args, docsDir) {
|
|
176
|
-
const entry = fileURLToPath(import.meta.url)
|
|
177
|
-
const childArgs = [entry, docsDir]
|
|
178
|
-
if (args.open) childArgs.push("--open")
|
|
179
|
-
if (args.port !== DEFAULT_PORT) childArgs.push("--port", String(args.port))
|
|
180
|
-
const child = spawn(process.execPath, childArgs, { detached: true, stdio: "ignore" })
|
|
181
|
-
child.unref()
|
|
182
|
-
|
|
183
|
-
const state = await waitForState(child.pid)
|
|
184
|
-
if (!state) {
|
|
185
|
-
console.error("[docserve] Server did not report startup (no state file). Try running in the foreground.")
|
|
186
|
-
process.exit(1)
|
|
187
|
-
}
|
|
188
|
-
console.log("docserve started in the background")
|
|
189
|
-
console.log(` pid : ${state.pid}`)
|
|
190
|
-
console.log(` url : ${state.url}`)
|
|
191
|
-
console.log(` docs : ${state.docsDir}`)
|
|
192
|
-
console.log(" stop : docserve stop")
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
// Poll the state dir until the server with the given pid reports its state.
|
|
196
|
-
async function waitForState(pid, { timeoutMs = 10000, intervalMs = 200 } = {}) {
|
|
197
|
-
const deadline = Date.now() + timeoutMs
|
|
198
|
-
while (Date.now() < deadline) {
|
|
199
|
-
const state = listLiveStates().find((entry) => entry.pid === pid)
|
|
200
|
-
if (state) return state
|
|
201
|
-
await new Promise((resolve) => setTimeout(resolve, intervalMs))
|
|
202
|
-
}
|
|
203
|
-
return null
|
|
204
|
-
}
|
|
205
|
-
|
|
206
|
-
function openBrowser(url) {
|
|
207
|
-
if (process.platform === "darwin") exec(`open ${url}`)
|
|
6
|
+
if (!existsSync(entry)) {
|
|
7
|
+
console.error("[docserve] Missing dist/node/cli.mjs. Run `npm run build`.")
|
|
8
|
+
process.exit(1)
|
|
208
9
|
}
|
|
209
10
|
|
|
210
|
-
|
|
211
|
-
try {
|
|
212
|
-
return fs.statSync(path).isDirectory()
|
|
213
|
-
} catch {
|
|
214
|
-
return false
|
|
215
|
-
}
|
|
216
|
-
}
|
|
11
|
+
const { main } = await import(entry.href)
|
|
217
12
|
|
|
218
|
-
main().catch((
|
|
219
|
-
console.error(
|
|
13
|
+
main().catch((error) => {
|
|
14
|
+
console.error(error?.message ?? error)
|
|
220
15
|
process.exit(1)
|
|
221
16
|
})
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
:root{--bg:#0f1117;--card:#1a1d27;--border:#2a2e3d;--text:#e6e8ee;--muted:#9aa0b0;--accent:#6c8cff;--green:#4ade80;--btn-bg:#0f1117d1;--folder-hue:210}@media (prefers-color-scheme:light){:root{--bg:#f8fafc;--card:#fff;--border:#e2e8f0;--text:#334155;--muted:#64748b;--accent:#2563eb;--green:#16a34a;--btn-bg:#ffffffd9}}*{box-sizing:border-box}html{background:var(--bg)}body{background:var(--bg);color:var(--text);margin:0;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Hiragino Sans,Noto Sans JP,sans-serif;font-size:15px;line-height:1.5}.docserve-gallery{padding:40px 80px}@media (width<=720px){.docserve-gallery{padding:24px 20px}}.gallery-head{align-items:center;gap:10px;margin-bottom:8px;display:flex}.gallery-head__title{min-width:0;color:var(--text);align-items:center;gap:10px;margin:0;font-size:1.6rem;font-weight:700;display:flex}.gallery-head__folder{width:26px;height:26px;color:hsl(var(--folder-hue) 70% 52%);flex-shrink:0}.gallery-head__folder svg{width:100%;height:100%;display:block}.gallery-head__name{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.gallery-head__servers{margin-left:auto;font-size:.78rem;font-weight:500;position:relative}.gallery-head__servers summary{border:1px solid var(--border);background:var(--card);color:var(--muted);cursor:pointer;-webkit-user-select:none;user-select:none;border-radius:8px;align-items:center;gap:6px;padding:5px 10px;list-style:none;display:flex}.gallery-head__servers summary::-webkit-details-marker{display:none}.gallery-head__servers[open] summary,.gallery-head__servers summary:hover{border-color:var(--accent);color:var(--text)}.servers-menu{z-index:20;border:1px solid var(--border);background:var(--card);border-radius:10px;width:220px;padding:3px;position:absolute;top:calc(100% + 6px);right:0;box-shadow:0 4px 12px #0000001f}.servers-row{color:var(--text);border-radius:7px;grid-template-rows:auto auto;grid-template-columns:6px minmax(0,1fr) auto auto;align-items:center;gap:2px 6px;padding:5px 6px;text-decoration:none;display:grid}a.servers-row:hover{background:#6c8cff1f}.servers-row.is-current{color:var(--muted)}.server-dot{background:var(--border);border-radius:50%;grid-area:1/1/span 2;width:6px;height:6px}.servers-row.is-current .server-dot{background:var(--green)}.server-name{text-overflow:ellipsis;white-space:nowrap;grid-area:1/2;font-weight:600;overflow:hidden}.servers-row.is-current .server-name{color:var(--text)}.server-path{color:var(--muted);text-overflow:ellipsis;white-space:nowrap;grid-area:2/2;font-size:.62rem;overflow:hidden}.server-port{color:var(--muted);font-variant-numeric:tabular-nums;white-space:nowrap;grid-area:2/3;font-size:.62rem}.server-check{color:var(--green);grid-area:1/4/span 2;font-size:.65rem}.gallery-sub{color:var(--muted);margin:0 0 32px;font-size:.9rem}.gallery-sub b{color:var(--green)}.gallery-sub code,.gallery-empty code{border:1px solid var(--border);background:var(--card);word-break:break-all;border-radius:6px;padding:2px 8px;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:.78rem}.page-grid{grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:16px;display:grid}.page-card{border:1px solid var(--border);background:var(--card);color:inherit;border-radius:12px;flex-direction:column;text-decoration:none;transition:transform .15s,border-color .15s;display:flex;overflow:hidden}.page-card:hover{border-color:var(--accent)}.page-card__preview{background:#fff;height:160px;position:relative;overflow:hidden}.page-card__thumb{position:absolute;inset:0}.page-card__preview iframe{transform-origin:0 0;pointer-events:none;background:#fff;border:0;position:absolute;top:0;left:0}.page-card__preview:after{content:"";position:absolute;inset:0}.copy-btn{z-index:1;border:1px solid var(--border);background:var(--btn-bg);width:26px;height:26px;color:var(--text);cursor:pointer;opacity:0;border-radius:7px;place-items:center;padding:0;transition:opacity .15s,color .15s,border-color .15s;display:grid;position:absolute;top:8px;right:8px}.copy-btn svg{width:13px;height:13px}.copy-btn .ic-check{display:none}.page-card:hover .copy-btn{opacity:1}.copy-btn:hover{border-color:var(--accent);color:var(--accent)}.copy-btn.copied{border-color:var(--green);color:var(--green)}.copy-btn.copied .ic-copy{display:none}.copy-btn.copied .ic-check{display:block}@media (hover:none){.copy-btn{opacity:.7}}.page-card__meta{border-top:1px solid var(--border);flex-direction:column;flex:1;justify-content:space-between;gap:8px;padding:10px 12px;display:flex}.page-card__title{align-items:center;gap:6px;min-width:0;font-size:.85rem;font-weight:600;line-height:1.4;display:flex}.page-card__title>span{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.page-card__favicon{object-fit:contain;border-radius:4px;flex-shrink:0;width:16px;height:16px}.page-card__date{color:var(--muted);font-size:.7rem}.gallery-empty{border:1px dashed var(--border);max-width:480px;color:var(--muted);text-align:center;border-radius:12px;margin:48px auto;padding:32px 24px}.gallery-empty__title{color:var(--text);margin:0 0 8px;font-weight:600}.gallery-empty p{margin:0}.gallery-empty button{border:1px solid var(--border);background:var(--card);color:var(--text);cursor:pointer;font:inherit;border-radius:7px;margin-top:12px;padding:5px 12px}.gallery-empty button:hover{border-color:var(--accent)}
|