@noy4/docserve 0.3.3 → 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.
Files changed (79) hide show
  1. package/bin.mjs +8 -213
  2. package/dist/gallery/assets/index-CGV64tuk.css +1 -0
  3. package/dist/gallery/assets/index-Cf8Uf0vA.js +10 -0
  4. package/dist/gallery/assets/index-Cf8Uf0vA.js.map +1 -0
  5. package/dist/gallery/index.html +15 -0
  6. package/dist/node/cli.mjs +4095 -0
  7. package/dist/node/cli.mjs.map +7 -0
  8. package/dist/widget/index.js +3410 -2527
  9. package/package.json +15 -5
  10. package/src/node/cli.mjs +155 -0
  11. package/src/node/{files.mjs → docs/files.mjs} +1 -1
  12. package/src/node/{inject.mjs → docs/inject.mjs} +1 -1
  13. package/src/node/{meta.mjs → docs/meta.mjs} +1 -1
  14. package/src/node/http/app.mjs +20 -0
  15. package/src/node/{assets.mjs → http/assets.mjs} +3 -2
  16. package/src/node/http/gallery.mjs +45 -0
  17. package/src/node/http/response.mjs +31 -0
  18. package/src/node/http/routes.mjs +59 -0
  19. package/src/node/{serve-static.mjs → http/serve-static.mjs} +1 -1
  20. package/src/node/{server.mjs → http/server.mjs} +10 -10
  21. package/src/node/{state.mjs → instances/state.mjs} +9 -5
  22. package/src/node/instances/view.mjs +19 -0
  23. package/src/node/{watch.mjs → live/watch.mjs} +1 -1
  24. package/src/node/paths.mjs +10 -0
  25. package/src/node/rpc/files.mjs +5 -0
  26. package/src/node/rpc/index.mjs +39 -0
  27. package/src/node/rpc/route.mjs +34 -0
  28. package/src/node/rpc/servers.mjs +16 -0
  29. package/src/plugins/collapse/client.js +45 -0
  30. package/src/plugins/collapse/collapse.css +74 -0
  31. package/src/plugins/collapse/commands.ts +81 -0
  32. package/src/plugins/collapse/model.ts +123 -0
  33. package/src/plugins/collapse/sections.ts +105 -0
  34. package/src/plugins/collapse/view.ts +84 -0
  35. package/src/plugins/servers/client.js +77 -0
  36. package/src/plugins/servers/commands.ts +30 -0
  37. package/src/plugins/servers/model.ts +106 -0
  38. package/src/plugins/servers/servers.css +144 -0
  39. package/src/plugins/servers/ui/ServersPopover.tsx +71 -0
  40. package/src/plugins/sidebar/client.js +1 -0
  41. package/src/plugins/sidebar/icons.js +1 -1
  42. package/src/plugins/sidebar/ui/PageList.tsx +1 -1
  43. package/src/plugins/sidebar/ui/RadioMenu.tsx +1 -1
  44. package/src/plugins/sidebar/ui/Sidebar.tsx +3 -3
  45. package/src/plugins/sidebar/ui/TreeList.tsx +10 -3
  46. package/src/plugins/toc/client.js +55 -0
  47. package/src/plugins/toc/commands.ts +49 -0
  48. package/src/plugins/toc/heading-html.ts +40 -0
  49. package/src/plugins/toc/model.ts +178 -0
  50. package/src/plugins/toc/outline.js +94 -0
  51. package/src/plugins/toc/scroll-spy.ts +35 -0
  52. package/src/plugins/toc/toc.css +214 -0
  53. package/src/plugins/toc/ui/TocPanel.tsx +87 -0
  54. package/src/{plugins/sidebar/ui → shared/client}/preview-model.ts +18 -4
  55. package/src/{plugins/sidebar/ui/useModel.ts → shared/client/use-model.ts} +1 -8
  56. package/src/shared/types.d.ts +17 -1
  57. package/src/widget/{pages.js → api/pages.js} +4 -7
  58. package/src/widget/api/rpc-client.js +25 -0
  59. package/src/widget/api/servers.js +46 -0
  60. package/src/widget/host.js +10 -8
  61. package/src/widget/index.js +11 -1
  62. package/src/widget/lib/headings.js +132 -0
  63. package/src/widget/{docks.js → shell/docks.js} +2 -2
  64. package/src/widget/{palette.js → shell/palette.js} +3 -3
  65. package/src/widget/{placement.js → shell/placement.js} +1 -1
  66. package/src/widget/{ui.js → shell/ui.js} +1 -1
  67. package/src/widget/widget.css +15 -2
  68. package/index.html +0 -365
  69. package/src/node/adapter.mjs +0 -67
  70. package/src/node/gallery.mjs +0 -33
  71. package/src/node/routes.mjs +0 -105
  72. /package/src/node/{dates.mjs → docs/dates.mjs} +0 -0
  73. /package/src/node/{docs-info.mjs → docs/info.mjs} +0 -0
  74. /package/src/node/{scan.mjs → docs/scan.mjs} +0 -0
  75. /package/src/node/{websocket.mjs → live/websocket.mjs} +0 -0
  76. /package/src/widget/{live.js → api/live.js} +0 -0
  77. /package/src/widget/{rpc.js → api/rpc.js} +0 -0
  78. /package/src/widget/{palette.css → shell/palette.css} +0 -0
  79. /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
- // docserve — serve a folder of HTML as a card gallery with live reload.
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 pkg = JSON.parse(fs.readFileSync(new URL("./package.json", import.meta.url), "utf8"))
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
- const HELP = `
26
- docserve v${VERSION} — serve a folder of HTML as a card gallery with live reload.
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
- function isDirectory(path) {
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((err) => {
219
- console.error(err?.message ?? err)
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)}