@umami/shiso 1.2.0 → 1.3.0

package/dist/chunks/App.js

@@ -26709,7 +26709,7 @@ function DocContent({ page, doc, site }) {
 					className: "text-sm text-muted-foreground",
 					children: site.labels.relatedTopics
 				}), /* @__PURE__ */ jsx("ul", {
-					className: "mt-3 flex flex-col gap-2",
+					className: "mt-3 flex flex-col gap-2 text-sm",
 					children: related.map(({ href, title, external }) => /* @__PURE__ */ jsxs("li", {
 						className: "flex items-center gap-2",
 						children: [/* @__PURE__ */ jsx(FileText, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umami/shiso",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Open-source documentation framework for Markdown and MDX sites.",
   "type": "module",
   "bin": {

package/src/components/DocContent.tsx

@@ -109,7 +109,7 @@ export function DocContent({ page, doc, site }: DocContentProps) {
       {related.length > 0 && (
         <nav className="mt-8" aria-label={site.labels.relatedTopics}>
           <div className="text-sm text-muted-foreground">{site.labels.relatedTopics}</div>
-          <ul className="mt-3 flex flex-col gap-2">
+          <ul className="mt-3 flex flex-col gap-2 text-sm">
             {related.map(({ href, title, external }) => (
               <li key={href} className="flex items-center gap-2">
                 <FileText size={14} className="shrink-0 text-muted-foreground" />

package/src/styles/global.css

@@ -146,25 +146,46 @@
     font-size: 0.875rem;
   }
 
+  /* Styled to match the PropertiesTable component: rounded outer border,
+     horizontal row separators only, and no header fill. */
   .docs-markdown table {
     width: 100%;
-    border-collapse: collapse;
     margin: 1rem 0;
     font-size: 0.875rem;
+    border-collapse: separate;
+    border-spacing: 0;
+    border: 1px solid var(--border);
+    border-radius: var(--radius-lg);
   }
 
   .docs-markdown th,
   .docs-markdown td {
-    border: 1px solid var(--border);
-    padding: 0.5rem 0.75rem;
+    border: none;
+    border-bottom: 1px solid var(--border);
+    padding: 0.6rem 0.75rem;
     text-align: left;
+    vertical-align: top;
+  }
+
+  .docs-markdown th:first-child,
+  .docs-markdown td:first-child {
+    padding-left: 1.5rem;
+  }
+
+  .docs-markdown th:last-child,
+  .docs-markdown td:last-child {
+    padding-right: 1.5rem;
   }
 
   .docs-markdown th {
-    background: var(--card);
+    background: transparent;
     font-weight: 600;
   }
 
+  .docs-markdown tbody tr:last-child td {
+    border-bottom: none;
+  }
+
   .docs-markdown table code:not(pre code) {
     font-size: 0.75rem;
   }

package/vite.config.ts

@@ -1,3 +1,4 @@
+import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import tailwindcss from '@tailwindcss/vite';
@@ -281,6 +282,75 @@ function shisoHtml(getDocsConfig: () => DocsConfig): Plugin {
   };
 }
 
+/**
+ * Serves the raw markdown source for `<route>.md` URLs during development,
+ * mirroring the `.md` copies the prerenderer publishes next to every page in
+ * production builds. The contextual menu's copy/view options and AI links
+ * depend on these URLs.
+ */
+function shisoMarkdownDev(getDocsConfig: () => DocsConfig, root: string): Plugin {
+  return {
+    name: 'shiso-markdown-dev',
+    apply: 'serve',
+    configureServer(server) {
+      server.middlewares.use(async (req, res, next) => {
+        const url = (req.url || '').split('?')[0];
+
+        if ((req.method !== 'GET' && req.method !== 'HEAD') || !url.endsWith('.md')) {
+          return next();
+        }
+
+        const shiso =
+          (getDocsConfig() as { $shiso?: { docsPrefix?: string; contentDir?: string } }).$shiso ||
+          {};
+        const contentDir = (shiso.contentDir ?? 'content/docs').replace(/^\/+|\/+$/g, '');
+        const prefixValue = (shiso.docsPrefix ?? '/docs').trim().replace(/\/+$/, '');
+        const docsPrefix =
+          !prefixValue || prefixValue === '/'
+            ? ''
+            : prefixValue.startsWith('/')
+              ? prefixValue
+              : `/${prefixValue}`;
+
+        let route = decodeURIComponent(url).slice(0, -'.md'.length);
+        const base = server.config.base.replace(/\/+$/, '');
+
+        if (base && route.startsWith(base)) {
+          route = route.slice(base.length);
+        }
+
+        if (docsPrefix && route.startsWith(docsPrefix)) {
+          route = route.slice(docsPrefix.length);
+        }
+
+        const slug = route.replace(/^\/+/, '') || 'index';
+        const contentRoot = path.resolve(root, contentDir);
+        const candidates = [`${slug}.mdx`, `${slug}.md`, `${slug}/index.mdx`, `${slug}/index.md`];
+
+        for (const candidate of candidates) {
+          const filePath = path.resolve(contentRoot, candidate);
+
+          // Never read outside the content directory.
+          if (!filePath.startsWith(contentRoot + path.sep)) {
+            break;
+          }
+
+          try {
+            const source = await readFile(filePath, 'utf8');
+            res.setHeader('Content-Type', 'text/markdown; charset=utf-8');
+            res.end(source);
+            return;
+          } catch {
+            // Try the next candidate.
+          }
+        }
+
+        next();
+      });
+    },
+  };
+}
+
 const MDX_REACT_ENTRY = fileURLToPath(import.meta.resolve('@mdx-js/react'));
 const LUCIDE_REACT_ENTRY = path.join(
   path.dirname(fileURLToPath(import.meta.resolve('lucide-react/package.json'))),
@@ -319,6 +389,7 @@ export default defineConfig(async () => {
         path.join(generatedRoot, 'search-index.generated.ts'),
       ),
       shisoHtml(getDocsConfig),
+      shisoMarkdownDev(getDocsConfig, projectRoot),
       shisoMdx(),
       react({ include: /\.(mdx|md|tsx|ts|jsx|js)$/ }),
     ],