@inovus-medical/docs 0.2.0 → 0.4.0

package/assets/styles.css

@@ -102,8 +102,7 @@ a:hover { text-decoration: underline; }
 .layout {
   display: grid;
   grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
-  max-width: 1400px;
-  margin: 0 auto;
+  width: 100%;
 }
 .sidebar {
   position: sticky; top: var(--header-h); align-self: start;

package/bin/cli.js

@@ -58,16 +58,18 @@ async function run() {
   if (cmd === 'dev') {
     const { pageCount, outPath, contentDir } = await build({ root, inDir, outDir })
     console.log(`✓ Built ${pageCount} page(s) from ${contentDir === '.' ? 'repo root' : contentDir + '/'}`)
-    serve({ dir: outPath, port })
-    console.log(`→ Serving http://localhost:${port}  (watching ${contentDir === '.' ? 'repo root' : contentDir + '/'} for changes)`)
+    const { port: actual } = await serve({ dir: outPath, port })
+    const busy = actual !== port ? `  (port ${port} was busy)` : ''
+    console.log(`→ Serving http://localhost:${actual}${busy}  (watching ${contentDir === '.' ? 'repo root' : contentDir + '/'} for changes)`)
     watchAndRebuild({ root, inDir: contentDir, outDir })
     return
   }
 
   if (cmd === 'serve') {
     const outPath = path.join(root, outDir)
-    serve({ dir: outPath, port })
-    console.log(`→ Serving ${outDir}/ at http://localhost:${port}`)
+    const { port: actual } = await serve({ dir: outPath, port })
+    const busy = actual !== port ? `  (port ${port} was busy)` : ''
+    console.log(`→ Serving ${outDir}/ at http://localhost:${actual}${busy}`)
     return
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inovus-medical/docs",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Turn a folder of markdown into a themed, Cloudflare-ready docs site.",
   "type": "module",
   "bin": {

package/src/build.js

@@ -117,7 +117,16 @@ export async function build({ root = process.cwd(), inDir, outDir = 'dist' } = {
     const routeSegments = isIndex ? dirSegments : rawSegments
     const route = toRoute(routeSegments)
 
-    const { html, headings, text, title } = renderer.render(content)
+    let rendered
+    try {
+      rendered = renderer.render(content)
+    } catch (err) {
+      const rel = path.relative(contentRoot, file)
+      console.warn(`⚠ Could not fully render ${rel}: ${err.message} — falling back to plain text.`)
+      const escaped = content.replace(/[&<>]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;' }[c]))
+      rendered = { html: `<pre>${escaped}</pre>`, headings: [], text: content.slice(0, 2000), title: null }
+    }
+    const { html, headings, text, title } = rendered
     const pageTitle = data.title || title || (isIndex ? titleCase(dirSegments[dirSegments.length - 1] || config.title) : titleCase(leaf))
 
     const page = {

package/src/markdown.js

@@ -42,7 +42,19 @@ export async function createRenderer() {
   md.use(
     await Shiki({
       themes: { light: 'github-light', dark: 'github-dark' },
-      defaultColor: false
+      defaultColor: false,
+      // Real repos use fence languages Shiki doesn't ship (env, console, ...).
+      // Map the common ones, and fall back to plain text instead of crashing the build.
+      fallbackLanguage: 'text',
+      langAlias: {
+        env: 'ini',
+        dotenv: 'ini',
+        conf: 'ini',
+        console: 'bash',
+        shell: 'bash',
+        cmd: 'bat',
+        vue: 'html'
+      }
     })
   )
 

package/src/serve.js

@@ -40,24 +40,47 @@ async function resolveFile(dir, urlPath) {
   }
 }
 
-export function serve({ dir, port = 8788 }) {
-  const server = http.createServer(async (req, res) => {
-    const file = await resolveFile(dir, req.url || '/')
-    if (file) {
-      res.writeHead(200, { 'content-type': TYPES[path.extname(file)] || 'application/octet-stream' })
-      createReadStream(file).pipe(res)
-      return
-    }
-    const notFound = path.join(dir, '404.html')
-    try {
-      const body = await fs.readFile(notFound)
-      res.writeHead(404, { 'content-type': 'text/html; charset=utf-8' })
-      res.end(body)
-    } catch {
-      res.writeHead(404, { 'content-type': 'text/plain' })
-      res.end('Not found')
-    }
+/**
+ * Start a static server for `dir`. If the requested port is busy, automatically tries the
+ * next ones (up to maxAttempts) instead of crashing. Resolves with the server and the
+ * actual port it bound to.
+ */
+export function serve({ dir, port = 8788, maxAttempts = 25 }) {
+  return new Promise((resolve, reject) => {
+    const server = http.createServer(async (req, res) => {
+      try {
+        const file = await resolveFile(dir, req.url || '/')
+        if (file) {
+          res.writeHead(200, { 'content-type': TYPES[path.extname(file)] || 'application/octet-stream' })
+          createReadStream(file).pipe(res)
+          return
+        }
+        const notFound = path.join(dir, '404.html')
+        try {
+          const body = await fs.readFile(notFound)
+          res.writeHead(404, { 'content-type': 'text/html; charset=utf-8' })
+          res.end(body)
+        } catch {
+          res.writeHead(404, { 'content-type': 'text/plain' })
+          res.end('Not found')
+        }
+      } catch (err) {
+        // A single bad request should never take down the dev server.
+        res.writeHead(500, { 'content-type': 'text/plain' })
+        res.end('Internal error: ' + err.message)
+      }
+    })
+
+    let attempt = 0
+    server.on('error', (err) => {
+      if (err.code === 'EADDRINUSE' && attempt < maxAttempts) {
+        attempt++
+        server.listen(port + attempt)
+      } else {
+        reject(err)
+      }
+    })
+    server.once('listening', () => resolve({ server, port: server.address().port }))
+    server.listen(port)
   })
-  server.listen(port)
-  return server
 }