sdocs 0.0.45 → 0.0.46

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.46] - 2026-07-04
+
+### Fixed
+
+- **`npx sdocs` works in projects without a local install again.** The
+  Explorer's lazy syntax highlighter (added in 0.0.36) imports `shiki`,
+  which a bare project couldn't resolve from the staging directory — the
+  dev server failed with `Failed to resolve import "shiki/core"`. The
+  staging directory now links sdocs' own `shiki` (and `svelte`, when the
+  project has none) into place; a project-local `svelte` still wins.
+
 ## [0.0.45] - 2026-07-04
 
 ### Fixed

package/dist/explorer/tree-builder.d.ts

@@ -9,7 +9,7 @@ export interface TreeNode {
     children: TreeNode[];
     /** The doc entry (only for component/page/layout nodes) */
     doc?: DocEntry;
-    /** Snippet names for component nodes (excludes Default) */
+    /** Example titles for component nodes (sidebar sub-pages) */
     examples?: string[];
     /** Whether this node should be expanded by default */
     defaultExpanded?: boolean;

package/dist/server/app-gen.js

@@ -1,13 +1,38 @@
-import { mkdir, mkdtemp, writeFile, rm, readFile, copyFile, readdir } from 'node:fs/promises';
+import { mkdir, mkdtemp, writeFile, rm, readFile, copyFile, readdir, symlink } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { dirname, resolve, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
 import { discoverDocFiles } from './discovery.js';
 import { parseSdoc } from '../language/index.js';
 import { planEntitySnippets } from './doc-model.js';
 import { encodeEntityId, setDocPathRoot } from './snippet-compiler.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+/**
+ * Make the staging dir self-sufficient: the staged Explorer imports shiki
+ * (and svelte) as bare specifiers, but when the staging dir sits inside a
+ * bare project (npx run, no local install), walking up never reaches sdocs'
+ * own dependency tree. Link what the Explorer needs into the staging dir's
+ * node_modules — svelte only when the project has no copy of its own, so a
+ * project-local svelte keeps winning (two svelte runtimes don't mix).
+ */
+async function linkStagedDeps(sdocsDir, cwd) {
+    const nodeModules = resolve(sdocsDir, 'node_modules');
+    await mkdir(nodeModules, { recursive: true });
+    const link = async (pkg) => {
+        const target = dirname(require.resolve(`${pkg}/package.json`));
+        await symlink(target, resolve(nodeModules, pkg), 'junction').catch(() => { });
+    };
+    await link('shiki');
+    try {
+        require.resolve('svelte/package.json', { paths: [cwd] });
+    }
+    catch {
+        await link('svelte');
+    }
+}
 /** Source Explorer directory in the installed package (dist/explorer, next to dist/server) */
 function getExplorerSourceDir() {
     return resolve(__dirname, '../explorer');
@@ -164,6 +189,7 @@ export async function generateDevFiles(config, cwd) {
     const sdocsDir = await createStagingDir(cwd);
     // Copy Explorer components into the staging dir so they're compiled outside node_modules
     await copyExplorerApp(sdocsDir);
+    await linkStagedDeps(sdocsDir, cwd);
     await writeFile(resolve(sdocsDir, 'index.html'), generateIndexHtml(config.logo));
     await writeFile(resolve(sdocsDir, 'entry.js'), generateEntryJs(config));
     return sdocsDir;
@@ -176,6 +202,7 @@ export async function generateBuildFiles(config, cwd) {
     setDocPathRoot(sdocsDir);
     // Copy Explorer components into the staging dir
     await copyExplorerApp(sdocsDir);
+    await linkStagedDeps(sdocsDir, cwd);
     await writeFile(resolve(sdocsDir, 'index.html'), generateIndexHtml(config.logo));
     await writeFile(resolve(sdocsDir, 'entry.js'), generateEntryJs(config));
     const inputs = {

package/dist/server/discovery.d.ts

@@ -1,4 +1,2 @@
 /** Discover all .sdoc files matching the include patterns */
 export declare function discoverDocFiles(include: string[], root: string): Promise<string[]>;
-/** Get the absolute path for a relative import */
-export declare function resolveImportPath(importPath: string, fromFile: string): string;

package/dist/server/discovery.js

@@ -1,5 +1,4 @@
 import { glob } from 'tinyglobby';
-import { resolve } from 'node:path';
 /** Discover all .sdoc files matching the include patterns */
 export async function discoverDocFiles(include, root) {
     const files = await glob(include, {
@@ -8,8 +7,3 @@ export async function discoverDocFiles(include, root) {
     });
     return files.sort();
 }
-/** Get the absolute path for a relative import */
-export function resolveImportPath(importPath, fromFile) {
-    const dir = fromFile.substring(0, fromFile.lastIndexOf('/'));
-    return resolve(dir, importPath);
-}

package/package.json

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