sdocs 0.0.40 → 0.0.42

package/dist/vite.js

@@ -1,17 +1,25 @@
 import { readFile } from 'node:fs/promises';
 import { loadRawConfig, resolveAndFinalize } from './server/config.js';
-import { discoverDocFiles, getSdocKind } from './server/discovery.js';
-import { parseDocSource } from './server/meta-parser.js';
+import { discoverDocFiles } from './server/discovery.js';
 import { parseComponent } from './server/prop-parser.js';
-import { extractSnippets, extractMarkupBody, hasDefaultSnippet, generateAutoDefault, } from './server/snippet-extractor.js';
+import { parseSdoc, offsetToPosition } from './language/index.js';
+import { planEntitySnippets, extractImports, resolveComponentImport, } from './server/doc-model.js';
+import { renderPageMarkdown } from './server/page-markdown.js';
 import { highlight, disposeHighlighter } from './server/highlighter.js';
-import { extractTocFromHtml } from './server/toc-extractor.js';
-import { parseIframeId, parseMountId, parsePreviewUrl, resolveImportsToAbsolute, generateIframeComponent, generateMountScript, generatePreviewHtml, generateStaticPreviewHtml, iframeVirtualId, mountVirtualId, previewUrl, buildPreviewUrl, encodeDocPath, setDocPathRoot, } from './server/snippet-compiler.js';
+import { parseIframeId, parseMountId, parsePreviewUrl, resolveImportsToAbsolute, generateIframeComponent, generateMountScript, generatePreviewHtml, generateStaticPreviewHtml, iframeVirtualId, mountVirtualId, previewUrl, buildPreviewUrl, encodeEntityId, entityKey, setDocPathRoot, } from './server/snippet-compiler.js';
 const VIRTUAL_MODULE_ID = 'virtual:sdocs';
 const RESOLVED_VIRTUAL_ID = '\0virtual:sdocs';
 const IFRAME_PREFIX = '/@sdocs/iframe/';
 const PREVIEW_PREFIX = '/@sdocs/preview/';
 const MOUNT_PREFIX = '/@sdocs/mount/';
+/** Every renderable snippet of an entry, in order. */
+function allSnippets(entry) {
+    return [
+        ...entry.previews.map((p) => p.snippet),
+        ...entry.examples,
+        ...(entry.content ? [entry.content] : []),
+    ];
+}
 export function sdocsPlugin(userConfig) {
     let config;
     let root;
@@ -48,19 +56,19 @@ export function sdocsPlugin(userConfig) {
                 const parsed = parsePreviewUrl(req.url);
                 if (!parsed)
                     return next();
-                const entry = docEntries.get(parsed.docFilePath);
+                const entry = docEntries.get(entityKey(parsed.docFilePath, parsed.entitySlug));
                 if (!entry) {
                     res.statusCode = 404;
                     res.end('Doc not found');
                     return;
                 }
-                const snippet = entry.snippets.find((s) => s.name === parsed.snippetName);
+                const snippet = allSnippets(entry).find((s) => s.slug === parsed.snippetSlug);
                 if (!snippet) {
                     res.statusCode = 404;
                     res.end('Snippet not found');
                     return;
                 }
-                const iframeId = iframeVirtualId(parsed.docFilePath, parsed.snippetName);
+                const iframeId = iframeVirtualId(parsed.docFilePath, parsed.entitySlug, snippet.slug);
                 const html = generatePreviewHtml(iframeId, config.css);
                 res.setHeader('Content-Type', 'text/html');
                 // Let Vite transform the HTML (resolves imports, injects HMR client)
@@ -83,7 +91,7 @@ export function sdocsPlugin(userConfig) {
             server.watcher.on('unlink', (filePath) => {
                 if (isDocFile(filePath)) {
                     console.log(`[sdocs] Removed doc file: ${filePath}`);
-                    docEntries.delete(filePath);
+                    deleteEntriesOf(filePath);
                     docImportsCache.delete(filePath);
                     invalidateVirtualModule();
                 }
@@ -140,17 +148,17 @@ export function sdocsPlugin(userConfig) {
                     }
                 }
                 for (const entry of docEntries.values()) {
-                    const encoded = encodeDocPath(entry.filePath);
-                    for (const snippet of entry.snippets) {
-                        const jsFileName = `previews/${encoded}/${snippet.name}.js`;
+                    const encoded = encodeEntityId(entry.filePath, entry.entitySlug);
+                    for (const snippet of allSnippets(entry)) {
+                        const jsFileName = `previews/${encoded}/${snippet.slug}.js`;
                         this.emitFile({
                             type: 'chunk',
-                            id: mountVirtualId(entry.filePath, snippet.name),
+                            id: mountVirtualId(entry.filePath, entry.entitySlug, snippet.slug),
                             fileName: jsFileName,
                         });
                         plannedPreviews.push({
                             jsFileName,
-                            htmlFileName: `previews/${encoded}/${snippet.name}.html`,
+                            htmlFileName: `previews/${encoded}/${snippet.slug}.html`,
                         });
                     }
                 }
@@ -178,7 +186,7 @@ export function sdocsPlugin(userConfig) {
                         cssFiles.add(css);
                     queue.push(...mod.imports);
                 }
-                // The HTML sits at previews/<doc>/<name>.html — two levels deep.
+                // The HTML sits at previews/<entity>/<name>.html — two levels deep.
                 const cssLinks = [
                     ...emittedCssLinks,
                     ...[...cssFiles].map((file) => ({ href: `../../${file}` })),
@@ -209,23 +217,25 @@ export function sdocsPlugin(userConfig) {
                 const parsed = parseIframeId(realId);
                 if (!parsed)
                     return null;
-                const entry = docEntries.get(parsed.docFilePath);
+                const entry = docEntries.get(entityKey(parsed.docFilePath, parsed.entitySlug));
                 if (!entry)
                     return null;
-                const snippet = entry.snippets.find((s) => s.name === parsed.snippetName);
+                const snippet = allSnippets(entry).find((s) => s.slug === parsed.snippetSlug);
                 if (!snippet)
                     return null;
                 const absoluteImports = docImportsCache.get(parsed.docFilePath) ?? [];
-                const stateNames = (entry.componentData?.state ?? []).map((s) => s.name);
-                const componentName = entry.componentPath?.split('/').pop()?.replace('.svelte', '');
-                return generateIframeComponent(absoluteImports, snippet.body, stateNames, componentName);
+                // Method calls and live state bind to the snippet's own preview;
+                // example iframes fall back to the first preview's component.
+                const preview = entry.previews.find((p) => p.snippet.slug === snippet.slug) ?? entry.previews[0];
+                const stateNames = (preview?.componentData?.state ?? []).map((s) => s.name);
+                return generateIframeComponent(absoluteImports, snippet.body, stateNames, preview?.componentName ?? undefined);
             }
             // Virtual mount script for an emitted preview page
             if (id.startsWith('\0' + MOUNT_PREFIX)) {
                 const parsed = parseMountId(id.slice(1));
                 if (!parsed)
                     return null;
-                return generateMountScript(iframeVirtualId(parsed.docFilePath, parsed.snippetName));
+                return generateMountScript(iframeVirtualId(parsed.docFilePath, parsed.entitySlug, parsed.snippetSlug));
             }
         },
         async buildEnd() {
@@ -234,90 +244,132 @@ export function sdocsPlugin(userConfig) {
     };
     // ─── Process a single doc file ───
     async function processDocFile(filePath) {
-        const source = await readFile(filePath, 'utf-8');
-        const kind = getSdocKind(filePath);
-        const parsed = parseDocSource(source, filePath);
-        const meta = parsed.meta;
-        const componentPath = parsed.componentPath;
-        const imports = parsed.imports;
-        let snippets;
-        let toc;
-        if (kind === 'page' || kind === 'layout') {
-            const body = extractMarkupBody(source);
-            snippets = [{ name: 'Content', body }];
-            if (kind === 'page') {
-                toc = extractTocFromHtml(body);
-            }
+        try {
+            await processDocFileInner(filePath);
         }
-        else {
-            snippets = extractSnippets(source);
-            if (!hasDefaultSnippet(snippets)) {
-                const componentName = componentPath?.split('/').pop()?.replace('.svelte', '') ?? 'Component';
-                snippets.unshift({
-                    name: 'Default',
-                    body: generateAutoDefault(componentName),
-                });
-            }
+        catch (err) {
+            // A half-written file must never kill the dev server.
+            console.warn(`[sdocs] Failed to process ${filePath}:`, err);
         }
-        // If component is specified as a path but not imported, auto-add the import
-        if (componentPath) {
-            const componentName = componentPath.split('/').pop()?.replace('.svelte', '') ?? 'Component';
-            const hasImport = imports.some((imp) => imp.includes(componentName));
-            if (!hasImport) {
-                imports.push(`import ${componentName} from '${componentPath}'`);
-            }
+    }
+    async function processDocFileInner(filePath) {
+        const source = await readFile(filePath, 'utf-8');
+        const doc = parseSdoc(source);
+        for (const d of doc.diagnostics) {
+            const pos = offsetToPosition(source, d.span.start);
+            console.warn(`[sdocs] ${filePath}:${pos.line + 1}:${pos.column + 1} — ${d.message}`);
         }
-        // Cache resolved imports for iframe component generation
+        deleteEntriesOf(filePath);
+        const scriptContent = doc.script?.content ?? '';
+        const imports = extractImports(scriptContent);
         docImportsCache.set(filePath, resolveImportsToAbsolute(imports, filePath));
-        let componentData = null;
-        let highlightedSource = null;
-        if (kind === 'component' && componentPath) {
-            try {
-                componentData = await parseComponent(componentPath);
-                const componentSource = await readFile(componentPath, 'utf-8');
-                highlightedSource = await highlight(componentSource);
+        // One component parse per component file per rebuild, however many
+        // previews reference it.
+        const componentCache = new Map();
+        const loadComponent = async (componentPath) => {
+            let cached = componentCache.get(componentPath);
+            if (!cached) {
+                cached = { data: null, highlighted: null };
+                try {
+                    cached.data = await parseComponent(componentPath);
+                    const componentSource = await readFile(componentPath, 'utf-8');
+                    cached.highlighted = await highlight(componentSource);
+                }
+                catch (err) {
+                    console.warn(`[sdocs] Failed to parse component: ${componentPath}`, err);
+                }
+                componentCache.set(componentPath, cached);
+            }
+            return cached;
+        };
+        for (const entity of doc.entities) {
+            const planned = planEntitySnippets(entity);
+            const snippets = planned.map((p) => ({
+                name: p.name,
+                slug: p.slug,
+                role: p.role,
+                body: p.body,
+            }));
+            const entry = {
+                kind: entity.kind === 'DOCS' ? 'component' : entity.kind === 'PAGE' ? 'page' : 'layout',
+                filePath,
+                entitySlug: entity.slug,
+                meta: { title: entity.title },
+                previews: [],
+                examples: [],
+                content: null,
+            };
+            if (entity.kind === 'DOCS') {
+                if (entity.description)
+                    entry.meta.description = entity.description;
+                for (const [i, preview] of entity.previews.entries()) {
+                    const snippet = snippets[i];
+                    let componentPath = null;
+                    let componentData = null;
+                    let highlightedSource = null;
+                    if (preview.componentName) {
+                        componentPath = resolveComponentImport(preview.componentName, imports, filePath);
+                        if (componentPath) {
+                            const loaded = await loadComponent(componentPath);
+                            componentData = loaded.data;
+                            highlightedSource = loaded.highlighted;
+                        }
+                        else {
+                            console.warn(`[sdocs] ${filePath}: component {${preview.componentName}} is not imported in the file's <script>`);
+                        }
+                    }
+                    snippet.highlightedHtml = await highlight(snippet.body);
+                    entry.previews.push({
+                        label: preview.label,
+                        componentName: preview.componentName,
+                        componentPath,
+                        componentData,
+                        highlightedSource,
+                        args: preview.args ?? {},
+                        snippet,
+                    });
+                }
+                entry.examples = snippets.filter((s) => s.role === 'example');
+                for (const example of entry.examples) {
+                    example.highlightedHtml = await highlight(example.body);
+                }
             }
-            catch (err) {
-                console.warn(`[sdocs] Failed to parse component: ${componentPath}`, err);
+            else if (entity.kind === 'PAGE') {
+                const rendered = await renderPageMarkdown(entity.body);
+                snippets[0].body = rendered.html;
+                entry.content = snippets[0];
+                entry.toc = rendered.toc;
             }
+            else {
+                entry.content = snippets[0];
+                entry.padding = entity.padding;
+            }
+            docEntries.set(entityKey(filePath, entity.slug), entry);
         }
-        for (const snippet of snippets) {
-            snippet.highlightedHtml = await highlight(snippet.body);
-        }
-        docEntries.set(filePath, {
-            kind,
-            filePath,
-            componentPath,
-            meta,
-            componentData,
-            snippets,
-            highlightedSource,
-            toc,
-        });
     }
     // ─── Generate the virtual module ───
     function generateVirtualModule() {
-        const entries = Array.from(docEntries.values());
-        const data = entries.map((e) => ({
+        const urlFor = (entry, snippet) => 
+        // Only absolute bases prefix here; SvelteKit builds with a relative
+        // base ('./') and passes its real path via the Explorer's previewBase.
+        (base.startsWith('/') && base !== '/' ? base.replace(/\/$/, '') : '') +
+            (buildMode || isBuild
+                ? buildPreviewUrl(entry.filePath, entry.entitySlug, snippet.slug)
+                : previewUrl(entry.filePath, entry.entitySlug, snippet.slug));
+        const withUrl = (entry, snippet) => ({
+            ...snippet,
+            previewUrl: urlFor(entry, snippet),
+        });
+        const data = Array.from(docEntries.values()).map((e) => ({
             kind: e.kind,
             filePath: e.filePath,
-            componentPath: e.componentPath,
+            entitySlug: e.entitySlug,
             meta: e.meta,
-            componentData: e.componentData,
-            snippets: e.snippets.map((s) => ({
-                name: s.name,
-                body: s.body,
-                highlightedHtml: s.highlightedHtml,
-                previewUrl: 
-                // Only absolute bases prefix here; SvelteKit builds with a relative
-                // base ('./') and passes its real path via the Explorer's previewBase.
-                (base.startsWith('/') && base !== '/' ? base.replace(/\/$/, '') : '') +
-                    (buildMode || isBuild
-                        ? buildPreviewUrl(e.filePath, s.name)
-                        : previewUrl(e.filePath, s.name)),
-            })),
-            highlightedSource: e.highlightedSource,
+            previews: e.previews.map((p) => ({ ...p, snippet: withUrl(e, p.snippet) })),
+            examples: e.examples.map((s) => withUrl(e, s)),
+            content: e.content ? withUrl(e, e.content) : null,
             toc: e.toc,
+            padding: e.padding,
         }));
         // Extract named CSS stylesheet names (empty array if single string or null)
         const cssNames = config.css && typeof config.css === 'object'
@@ -335,10 +387,9 @@ export function sdocsPlugin(userConfig) {
         }
         // Also invalidate iframe virtual modules for the changed doc file
         if (docFilePath) {
-            const entry = docEntries.get(docFilePath);
-            if (entry) {
-                for (const snippet of entry.snippets) {
-                    const iframeId = '\0' + iframeVirtualId(docFilePath, snippet.name);
+            for (const entry of entriesOf(docFilePath)) {
+                for (const snippet of allSnippets(entry)) {
+                    const iframeId = '\0' + iframeVirtualId(docFilePath, entry.entitySlug, snippet.slug);
                     const iframeMod = server.moduleGraph.getModuleById(iframeId);
                     if (iframeMod) {
                         server.moduleGraph.invalidateModule(iframeMod);
@@ -351,6 +402,20 @@ export function sdocsPlugin(userConfig) {
     function isDocFile(filePath) {
         return filePath.endsWith('.sdoc');
     }
+    function entriesOf(filePath) {
+        const entries = [];
+        for (const [key, entry] of docEntries) {
+            if (key.startsWith(filePath + '#'))
+                entries.push(entry);
+        }
+        return entries;
+    }
+    function deleteEntriesOf(filePath) {
+        for (const key of [...docEntries.keys()]) {
+            if (key.startsWith(filePath + '#'))
+                docEntries.delete(key);
+        }
+    }
     /** Emit a user stylesheet as a build asset; returns its href relative to a preview page. */
     async function emitCssAsset(ctx, href, name) {
         if (href.startsWith('http'))
@@ -362,16 +427,20 @@ export function sdocsPlugin(userConfig) {
     }
     function isComponentReferencedByDoc(filePath) {
         for (const entry of docEntries.values()) {
-            if (entry.componentPath === filePath)
+            if (entry.previews.some((p) => p.componentPath === filePath))
                 return true;
         }
         return false;
     }
     async function reprocessComponentEntries(componentPath) {
-        for (const [docPath, entry] of docEntries) {
-            if (entry.componentPath === componentPath) {
-                await processDocFile(docPath);
+        const files = new Set();
+        for (const entry of docEntries.values()) {
+            if (entry.previews.some((p) => p.componentPath === componentPath)) {
+                files.add(entry.filePath);
             }
         }
+        for (const file of files) {
+            await processDocFile(file);
+        }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdocs",
-  "version": "0.0.40",
+  "version": "0.0.42",
   "description": "A lightweight documentation tool for Svelte 5 components",
   "type": "module",
   "license": "MIT",
@@ -21,6 +21,11 @@
       "types": "./dist/vite.d.ts",
       "default": "./dist/vite.js"
     },
+    "./language": {
+      "types": "./dist/language/index.d.ts",
+      "default": "./dist/language/index.js"
+    },
+    "./grammar/sdoc.tmLanguage.json": "./dist/grammar/sdoc.tmLanguage.json",
     "./explorer": {
       "svelte": "./dist/explorer/Explorer.svelte"
     },
@@ -56,6 +61,7 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "marked": "^16.4.2",
     "shiki": "^3.22.0",
     "tinyglobby": "^0.2.15",
     "typescript": "^5.7.0"

package/dist/server/meta-parser.d.ts

@@ -1,11 +0,0 @@
-import type { SdocMeta } from '../types.js';
-interface MetaParseResult {
-    meta: SdocMeta;
-    componentPath: string | null;
-    imports: string[];
-}
-/** Extract meta and imports from a .sdoc file */
-export declare function parseDocFile(filePath: string): Promise<MetaParseResult>;
-/** Parse meta from .sdoc source */
-export declare function parseDocSource(source: string, filePath: string): MetaParseResult;
-export {};

package/dist/server/meta-parser.js

@@ -1,109 +0,0 @@
-import { parse } from 'svelte/compiler';
-import { readFile } from 'node:fs/promises';
-import { resolve, dirname } from 'node:path';
-/** Extract meta and imports from a .sdoc file */
-export async function parseDocFile(filePath) {
-    const source = await readFile(filePath, 'utf-8');
-    return parseDocSource(source, filePath);
-}
-/** Parse meta from .sdoc source */
-export function parseDocSource(source, filePath) {
-    const ast = parse(source, { modern: true });
-    const scriptContent = extractScriptContent(source);
-    if (!scriptContent) {
-        return {
-            meta: { title: guessTitle(filePath) },
-            componentPath: null,
-            imports: [],
-        };
-    }
-    const imports = extractImports(scriptContent);
-    const meta = extractMeta(scriptContent);
-    const componentPath = resolveComponentPath(meta, imports, filePath);
-    return { meta, componentPath, imports };
-}
-/** Extract the content of the <script> tag */
-function extractScriptContent(source) {
-    const match = source.match(/<script[^>]*>([\s\S]*?)<\/script>/);
-    return match ? match[1] : null;
-}
-/** Extract import statements */
-function extractImports(scriptContent) {
-    const imports = [];
-    const regex = /^\s*import\s+.+$/gm;
-    let match;
-    while ((match = regex.exec(scriptContent)) !== null) {
-        imports.push(match[0].trim());
-    }
-    return imports;
-}
-/** Extract meta object from `export const meta = { ... }` using brace counting */
-function extractMeta(scriptContent) {
-    // Find where the meta object starts
-    const startMatch = scriptContent.match(/export\s+const\s+meta\s*(?::\s*\w+\s*)?=\s*\{/);
-    if (!startMatch || startMatch.index === undefined)
-        return { title: 'Untitled' };
-    // Find the opening brace
-    const braceStart = startMatch.index + startMatch[0].length - 1;
-    let depth = 1;
-    let i = braceStart + 1;
-    // Count braces to find the matching closing brace
-    while (i < scriptContent.length && depth > 0) {
-        const ch = scriptContent[i];
-        if (ch === '{')
-            depth++;
-        else if (ch === '}')
-            depth--;
-        // Skip strings
-        else if (ch === "'" || ch === '"' || ch === '`') {
-            i++;
-            while (i < scriptContent.length && scriptContent[i] !== ch) {
-                if (scriptContent[i] === '\\')
-                    i++; // skip escaped chars
-                i++;
-            }
-        }
-        i++;
-    }
-    const metaStr = scriptContent.slice(braceStart, i);
-    try {
-        // Replace component: Identifier with component: 'Identifier'
-        const cleaned = metaStr.replace(/component:\s*([A-Z]\w*)/, "component: '$1'");
-        const fn = new Function(`return (${cleaned})`);
-        const result = fn();
-        return result;
-    }
-    catch {
-        return extractMetaFields(metaStr);
-    }
-}
-/** Fallback: extract meta fields with regex */
-function extractMetaFields(metaStr) {
-    const title = metaStr.match(/title:\s*['"](.+?)['"]/)?.[1] ?? 'Untitled';
-    const description = metaStr.match(/description:\s*['"](.+?)['"]/)?.[1];
-    return { title, description };
-}
-/** Resolve the component import path to an absolute path */
-function resolveComponentPath(meta, imports, docFilePath) {
-    const componentValue = typeof meta.component === 'string' ? meta.component : null;
-    if (!componentValue)
-        return null;
-    // If component is a relative path (e.g. './Button.svelte'), resolve directly
-    if (componentValue.startsWith('./') || componentValue.startsWith('../')) {
-        return resolve(dirname(docFilePath), componentValue);
-    }
-    // Otherwise it's an identifier (e.g. 'Button') — find matching import
-    for (const imp of imports) {
-        const match = imp.match(new RegExp(`import\\s+${componentValue}\\s+from\\s+['"](.+?)['"]`));
-        if (match) {
-            const importPath = match[1];
-            return resolve(dirname(docFilePath), importPath);
-        }
-    }
-    return null;
-}
-/** Guess a title from the file path */
-function guessTitle(filePath) {
-    const fileName = filePath.split('/').pop() ?? '';
-    return fileName.replace(/\.sdoc$/, '').replace(/\./g, ' ');
-}

package/dist/server/snippet-extractor.d.ts

@@ -1,11 +0,0 @@
-import type { ExtractedSnippet } from '../types.js';
-/** Extract top-level {#snippet} blocks from .sdoc source, handling nested snippets */
-export declare function extractSnippets(source: string): ExtractedSnippet[];
-/** Check if a Default snippet exists or needs auto-generation */
-export declare function hasDefaultSnippet(snippets: ExtractedSnippet[]): boolean;
-/** Generate an auto-generated Default snippet body */
-export declare function generateAutoDefault(componentName: string): string;
-/** Extract the markup body of a .sdoc file (everything outside <script> and <style>) */
-export declare function extractMarkupBody(source: string): string;
-/** Get the snippet names in order (Default first, then alphabetical) */
-export declare function getSnippetOrder(snippets: ExtractedSnippet[]): string[];

package/dist/server/snippet-extractor.js

@@ -1,83 +0,0 @@
-/** Extract top-level {#snippet} blocks from .sdoc source, handling nested snippets */
-export function extractSnippets(source) {
-    const snippets = [];
-    // Strip <script> and <style> to search only markup
-    const markup = source
-        .replace(/<script[^>]*>[\s\S]*?<\/script>/g, '')
-        .replace(/<style[^>]*>[\s\S]*?<\/style>/g, '');
-    const openRegex = /\{#snippet\s+(\w+)\s*\([^)]*\)\}/g;
-    let match;
-    let searchFrom = 0;
-    while (true) {
-        openRegex.lastIndex = searchFrom;
-        match = openRegex.exec(markup);
-        if (!match)
-            break;
-        const name = match[1];
-        const bodyStart = match.index + match[0].length;
-        // Count nesting depth to find the matching {/snippet}
-        let depth = 1;
-        let i = bodyStart;
-        while (i < markup.length && depth > 0) {
-            if (markup.startsWith('{/snippet}', i)) {
-                depth--;
-                if (depth === 0)
-                    break;
-                i += '{/snippet}'.length;
-            }
-            else if (markup.startsWith('{#snippet', i)) {
-                depth++;
-                const closeBrace = markup.indexOf('}', i);
-                i = closeBrace !== -1 ? closeBrace + 1 : i + 1;
-            }
-            else {
-                i++;
-            }
-        }
-        if (depth === 0) {
-            const body = dedent(markup.slice(bodyStart, i).trim());
-            snippets.push({ name, body });
-            searchFrom = i + '{/snippet}'.length;
-        }
-        else {
-            break; // malformed source, stop
-        }
-    }
-    return snippets;
-}
-/** Remove common leading whitespace from all lines */
-function dedent(text) {
-    const lines = text.split('\n');
-    // Skip first line (already trimmed) when computing minimum indent
-    const rest = lines.slice(1).filter((l) => l.trim().length > 0);
-    const indents = rest.map((l) => l.match(/^(\s*)/)?.[1].length ?? 0);
-    const min = indents.length > 0 ? Math.min(...indents) : 0;
-    if (min === 0)
-        return text;
-    return [lines[0], ...lines.slice(1).map((l) => l.slice(min))].join('\n');
-}
-/** Check if a Default snippet exists or needs auto-generation */
-export function hasDefaultSnippet(snippets) {
-    return snippets.some((s) => s.name === 'Default');
-}
-/** Generate an auto-generated Default snippet body */
-export function generateAutoDefault(componentName) {
-    return `<${componentName} {...args} />`;
-}
-/** Extract the markup body of a .sdoc file (everything outside <script> and <style>) */
-export function extractMarkupBody(source) {
-    return source
-        .replace(/<script[^>]*>[\s\S]*?<\/script>/g, '')
-        .replace(/<style[^>]*>[\s\S]*?<\/style>/g, '')
-        .trim();
-}
-/** Get the snippet names in order (Default first, then alphabetical) */
-export function getSnippetOrder(snippets) {
-    const names = snippets.map((s) => s.name);
-    const defaultIndex = names.indexOf('Default');
-    if (defaultIndex > 0) {
-        names.splice(defaultIndex, 1);
-        names.unshift('Default');
-    }
-    return names;
-}

package/dist/server/toc-extractor.d.ts

@@ -1,3 +0,0 @@
-import type { TocHeading } from '../types.js';
-/** Extract ToC headings from HTML markup (for .sdoc pages) */
-export declare function extractTocFromHtml(body: string): TocHeading[];

package/dist/server/toc-extractor.js

@@ -1,23 +0,0 @@
-/** Slugify a heading text into an ID */
-function slugify(text) {
-    return text
-        .toLowerCase()
-        .replace(/[^\w\s-]/g, '')
-        .replace(/\s+/g, '-')
-        .replace(/-+/g, '-')
-        .trim();
-}
-/** Extract ToC headings from HTML markup (for .sdoc pages) */
-export function extractTocFromHtml(body) {
-    const headings = [];
-    const regex = /<h([2-4])[^>]*>([\s\S]*?)<\/h[2-4]>/gi;
-    let match;
-    while ((match = regex.exec(body)) !== null) {
-        const level = parseInt(match[1]);
-        const text = match[2].replace(/<[^>]*>/g, '').trim();
-        if (text) {
-            headings.push({ text, level, id: slugify(text) });
-        }
-    }
-    return headings;
-}