sdocs 0.0.10 → 0.0.12

package/dist/app-gen.js

@@ -1,13 +1,28 @@
-import { mkdir, writeFile, rm, readFile, copyFile } from 'node:fs/promises';
-import { dirname, resolve } from 'node:path';
+import { mkdir, writeFile, rm, readFile, copyFile, readdir } from 'node:fs/promises';
+import { dirname, resolve, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { discoverDocFiles, getSdocKind } from './server/discovery.js';
 import { extractSnippets, hasDefaultSnippet } from './server/snippet-extractor.js';
 import { base64urlEncode } from './server/snippet-compiler.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
-/** Absolute path to the client App.svelte in the installed package */
-function getAppComponentPath() {
-    return resolve(__dirname, 'client', 'App.svelte');
+/** Source client directory in the installed package */
+function getClientSourceDir() {
+    return resolve(__dirname, 'client');
+}
+/** Copy a directory recursively */
+async function copyDir(src, dest) {
+    await mkdir(dest, { recursive: true });
+    const entries = await readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath);
+        }
+        else {
+            await copyFile(srcPath, destPath);
+        }
+    }
 }
 /** Generate the main index.html */
 function generateIndexHtml(title) {
@@ -27,10 +42,9 @@ function generateIndexHtml(title) {
 }
 /** Generate the entry.js that mounts the App */
 function generateEntryJs(config) {
-    const appPath = getAppComponentPath().replace(/\\/g, '/');
     return `import { mount } from 'svelte';
 import { docs, cssNames } from 'virtual:sdocs';
-import App from '${appPath}';
+import App from './client/App.svelte';
 
 mount(App, {
 	target: document.getElementById('app'),
@@ -44,15 +58,16 @@ mount(App, {
 }
 /** Generate a preview HTML page for an iframe snippet */
 function generatePreviewHtml(iframeVirtualId, css) {
+    const normHref = (href) => href.startsWith('./') ? href.slice(1) : href.startsWith('/') || href.startsWith('http') ? href : '/' + href;
     let cssLinks = '';
     if (css) {
         if (typeof css === 'string') {
-            cssLinks = `<link rel="stylesheet" href="${css}">`;
+            cssLinks = `<link rel="stylesheet" href="${normHref(css)}">`;
         }
         else {
             const names = Object.keys(css);
             cssLinks = names
-                .map((name, i) => `<link rel="stylesheet" href="${css[name]}" data-sdocs-stylesheet="${name}"${i > 0 ? ' disabled' : ''}>`)
+                .map((name, i) => `<link rel="stylesheet" href="${normHref(css[name])}" data-sdocs-stylesheet="${name}"${i > 0 ? ' disabled' : ''}>`)
                 .join('\n\t');
         }
     }
@@ -87,11 +102,6 @@ function generatePreviewHtml(iframeVirtualId, css) {
 </body>
 </html>`;
 }
-/** Copy the favicon.png into the .sdocs/ directory */
-async function copyFavicon(sdocsDir) {
-    const src = resolve(__dirname, 'client', 'favicon.png');
-    await copyFile(src, resolve(sdocsDir, 'favicon.png'));
-}
 /** Discover doc files and extract snippet names (lightweight, no highlighting) */
 async function discoverSnippets(config, cwd) {
     const files = await discoverDocFiles(config.include, cwd);
@@ -117,18 +127,20 @@ async function discoverSnippets(config, cwd) {
 export async function generateDevFiles(config, cwd) {
     const sdocsDir = resolve(cwd, '.sdocs');
     await mkdir(sdocsDir, { recursive: true });
+    // Copy client components into .sdocs/client/ so they're compiled outside node_modules
+    await copyDir(getClientSourceDir(), resolve(sdocsDir, 'client'));
     await writeFile(resolve(sdocsDir, 'index.html'), generateIndexHtml(config.logo));
     await writeFile(resolve(sdocsDir, 'entry.js'), generateEntryJs(config));
-    await copyFavicon(sdocsDir);
     return sdocsDir;
 }
 /** Generate .sdocs/ directory with entry + preview HTML files for build mode */
 export async function generateBuildFiles(config, cwd) {
     const sdocsDir = resolve(cwd, '.sdocs');
     await mkdir(sdocsDir, { recursive: true });
+    // Copy client components into .sdocs/client/
+    await copyDir(getClientSourceDir(), resolve(sdocsDir, 'client'));
     await writeFile(resolve(sdocsDir, 'index.html'), generateIndexHtml(config.logo));
     await writeFile(resolve(sdocsDir, 'entry.js'), generateEntryJs(config));
-    await copyFavicon(sdocsDir);
     const inputs = {
         main: resolve(sdocsDir, 'index.html'),
     };

package/dist/commands/build.js

@@ -19,9 +19,7 @@ export async function buildCommand() {
             configFile: false,
             root: sdocsDir,
             plugins: [
-                svelte({
-                    prebundleSvelteLibraries: false,
-                }),
+                svelte(),
                 sdocsPlugin({ ...config, include: absoluteIncludes, _buildMode: true }),
             ],
             build: {
@@ -31,9 +29,6 @@ export async function buildCommand() {
                     input: inputs,
                 },
             },
-            optimizeDeps: {
-                exclude: ['sdocs'],
-            },
         });
         console.log(`[sdocs] Build complete → dist/`);
     }

package/dist/commands/dev.js

@@ -16,9 +16,7 @@ export async function devCommand() {
         configFile: false,
         root: sdocsDir,
         plugins: [
-            svelte({
-                prebundleSvelteLibraries: false,
-            }),
+            svelte(),
             sdocsPlugin({ ...config, include: absoluteIncludes }),
         ],
         server: {
@@ -28,9 +26,6 @@ export async function devCommand() {
                 allow: [cwd],
             },
         },
-        optimizeDeps: {
-            exclude: ['sdocs'],
-        },
     });
     await server.listen();
     server.printUrls();

package/dist/server/snippet-compiler.js

@@ -63,17 +63,25 @@ export function generateIframeComponent(absoluteImports, snippetBody) {
 	${snippetBody}
 </div>`;
 }
+/** Normalize a CSS path to root-relative so it works inside deeply nested virtual URLs */
+function normalizeCssHref(href) {
+    if (href.startsWith('./'))
+        return href.slice(1);
+    if (href.startsWith('/') || href.startsWith('http'))
+        return href;
+    return '/' + href;
+}
 /** Generate CSS link tags for the preview HTML */
 function generateCssLinks(css) {
     if (!css)
         return '';
     if (typeof css === 'string') {
-        return `<link rel="stylesheet" href="${css}">`;
+        return `<link rel="stylesheet" href="${normalizeCssHref(css)}">`;
     }
     // Named stylesheets: first one active, rest disabled
     const names = Object.keys(css);
     return names
-        .map((name, i) => `<link rel="stylesheet" href="${css[name]}" data-sdocs-stylesheet="${name}"${i > 0 ? ' disabled' : ''}>`)
+        .map((name, i) => `<link rel="stylesheet" href="${normalizeCssHref(css[name])}" data-sdocs-stylesheet="${name}"${i > 0 ? ' disabled' : ''}>`)
         .join('\n\t');
 }
 /** Generate the HTML page served inside the iframe */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdocs",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "A lightweight documentation tool for Svelte 5 components",
   "type": "module",
   "license": "MIT",