sdocs 0.0.46 → 0.0.47

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.47] - 2026-07-05
+
+### Fixed
+
+- **Shared values in the file `<script>` reach previews and examples.** The
+  pipeline lifted only `import` lines into a preview, so a shared value like
+  `const options = […]` was `undefined` at render time even though the
+  language reference promises the file script's shared values are available
+  to every entity. The whole file script (imports and declarations) is now
+  lifted, with its relative imports resolved.
+
+### Changed
+
+- Test files moved out of `src/lib` into `tests/` — they no longer ship
+  compiled inside the published package.
+
 ## [0.0.46] - 2026-07-04
 
 ### Fixed

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

@@ -12,10 +12,18 @@ export declare function encodeEntityId(filePath: string, entitySlug: string): st
 export declare function entityKey(filePath: string, entitySlug: string): string;
 /** Resolve relative imports to absolute paths for use in virtual components */
 export declare function resolveImportsToAbsolute(imports: string[], docFilePath: string): string[];
+/**
+ * Rewrite the relative import specifiers in a whole `<script>` block to
+ * absolute paths, so the file script — imports AND shared values (consts,
+ * functions) — can be lifted verbatim into a generated preview. Everything
+ * else in the script is preserved, which is what makes shared values
+ * available to previews and examples.
+ */
+export declare function resolveScriptImports(script: string, docFilePath: string): string;
 /** Generate a virtual Svelte iframe wrapper component for a snippet.
  * Includes $state for reactive prop updates via postMessage, invokes
  * component methods on request, and broadcasts exported state values. */
-export declare function generateIframeComponent(absoluteImports: string[], snippetBody: string, stateNames?: string[], componentName?: string): string;
+export declare function generateIframeComponent(scriptPrelude: string, snippetBody: string, stateNames?: string[], componentName?: string): string;
 /** The JS that boots a preview page: mount the wrapper + parent-frame messaging. */
 export declare function generateMountScript(iframeComponentId: string): string;
 /** Generate the HTML page served inside the iframe (dev / CLI-build inputs) */

package/dist/server/snippet-compiler.js

@@ -47,6 +47,17 @@ export function resolveImportsToAbsolute(imports, docFilePath) {
         return imp;
     });
 }
+/**
+ * Rewrite the relative import specifiers in a whole `<script>` block to
+ * absolute paths, so the file script — imports AND shared values (consts,
+ * functions) — can be lifted verbatim into a generated preview. Everything
+ * else in the script is preserved, which is what makes shared values
+ * available to previews and examples.
+ */
+export function resolveScriptImports(script, docFilePath) {
+    const docDir = dirname(docFilePath);
+    return script.replace(/(\bfrom\s+|\bimport\s+)(['"])(\.\.?\/[^'"]*)\2/g, (_m, keyword, quote, spec) => `${keyword}${quote}${resolve(docDir, spec)}${quote}`);
+}
 /** Add bind:this to the documented component in the snippet so the wrapper
  * can reach its exported methods and state. Binds the first occurrence of
  * the doc's component when named (so wrapped children like
@@ -70,10 +81,10 @@ function injectRootRef(snippetBody, componentName) {
 /** Generate a virtual Svelte iframe wrapper component for a snippet.
  * Includes $state for reactive prop updates via postMessage, invokes
  * component methods on request, and broadcasts exported state values. */
-export function generateIframeComponent(absoluteImports, snippetBody, stateNames = [], componentName) {
-    const importBlock = absoluteImports.length > 0
-        ? absoluteImports.join('\n') + '\n'
-        : '';
+export function generateIframeComponent(scriptPrelude, snippetBody, stateNames = [], componentName) {
+    // The file <script> (imports + shared values), lifted verbatim so previews
+    // and examples see everything the entity's siblings do.
+    const importBlock = scriptPrelude.trim() ? scriptPrelude.trim() + '\n' : '';
     const stateBroadcast = stateNames.length > 0
         ? `
 	$effect(() => {

package/dist/vite.js

@@ -6,7 +6,7 @@ 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 { parseIframeId, parseMountId, parsePreviewUrl, resolveImportsToAbsolute, generateIframeComponent, generateMountScript, generatePreviewHtml, generateStaticPreviewHtml, iframeVirtualId, mountVirtualId, previewUrl, buildPreviewUrl, encodeEntityId, entityKey, setDocPathRoot, } from './server/snippet-compiler.js';
+import { parseIframeId, parseMountId, parsePreviewUrl, resolveScriptImports, 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/';
@@ -25,7 +25,7 @@ export function sdocsPlugin(userConfig) {
     let root;
     let server;
     let docEntries = new Map();
-    let docImportsCache = new Map();
+    let docScriptCache = new Map();
     const buildMode = userConfig?._buildMode ?? false;
     let isBuild = false;
     let isSsrBuild = false;
@@ -92,7 +92,7 @@ export function sdocsPlugin(userConfig) {
                 if (isDocFile(filePath)) {
                     console.log(`[sdocs] Removed doc file: ${filePath}`);
                     deleteEntriesOf(filePath);
-                    docImportsCache.delete(filePath);
+                    docScriptCache.delete(filePath);
                     invalidateVirtualModule();
                 }
             });
@@ -223,12 +223,12 @@ export function sdocsPlugin(userConfig) {
                 const snippet = allSnippets(entry).find((s) => s.slug === parsed.snippetSlug);
                 if (!snippet)
                     return null;
-                const absoluteImports = docImportsCache.get(parsed.docFilePath) ?? [];
+                const scriptPrelude = docScriptCache.get(parsed.docFilePath) ?? '';
                 // 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);
+                return generateIframeComponent(scriptPrelude, snippet.body, stateNames, preview?.componentName ?? undefined);
             }
             // Virtual mount script for an emitted preview page
             if (id.startsWith('\0' + MOUNT_PREFIX)) {
@@ -262,7 +262,7 @@ export function sdocsPlugin(userConfig) {
         deleteEntriesOf(filePath);
         const scriptContent = doc.script?.content ?? '';
         const imports = extractImports(scriptContent);
-        docImportsCache.set(filePath, resolveImportsToAbsolute(imports, filePath));
+        docScriptCache.set(filePath, resolveScriptImports(scriptContent, filePath));
         // One component parse per component file per rebuild, however many
         // previews reference it.
         const componentCache = new Map();

package/package.json

@@ -1,69 +1,69 @@
 {
-  "name": "sdocs",
-  "version": "0.0.46",
-  "description": "A lightweight documentation tool for Svelte 5 components",
-  "type": "module",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gabilungu/sdocs.git",
-    "directory": "packages/sdocs"
-  },
-  "bin": {
-    "sdocs": "./bin/sdocs.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "svelte": "./dist/index.js"
-    },
-    "./vite": {
-      "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"
-    },
-    "./ui": {
-      "types": "./dist/ui/index.d.ts",
-      "svelte": "./dist/ui/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "CHANGELOG.md"
-  ],
-  "peerDependencies": {
-    "@sveltejs/vite-plugin-svelte": "*",
-    "svelte": "*",
-    "vite": "*"
-  },
-  "devDependencies": {
-    "@sveltejs/package": "^2.5.7",
-    "@sveltejs/vite-plugin-svelte": "^6.2.4",
-    "svelte": "^5.50.0",
-    "svelte-check": "^4.0.0",
-    "typescript": "^5.7.0",
-    "vite": "^7.3.1",
-    "vitest": "^3.0.0"
-  },
-  "scripts": {
-    "dev": "vite",
-    "build": "svelte-package -i src/lib -o dist",
-    "check": "svelte-check --tsconfig ./tsconfig.json",
-    "test": "vitest run"
-  },
-  "dependencies": {
-    "marked": "^16.4.2",
-    "shiki": "^3.22.0",
-    "tinyglobby": "^0.2.15",
-    "typescript": "^5.7.0"
-  }
+	"name": "sdocs",
+	"version": "0.0.47",
+	"description": "A lightweight documentation tool for Svelte 5 components",
+	"type": "module",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/gabilungu/sdocs.git",
+		"directory": "packages/sdocs"
+	},
+	"bin": {
+		"sdocs": "./bin/sdocs.js"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"svelte": "./dist/index.js"
+		},
+		"./vite": {
+			"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"
+		},
+		"./ui": {
+			"types": "./dist/ui/index.d.ts",
+			"svelte": "./dist/ui/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"files": [
+		"dist",
+		"bin",
+		"CHANGELOG.md"
+	],
+	"peerDependencies": {
+		"@sveltejs/vite-plugin-svelte": "*",
+		"svelte": "*",
+		"vite": "*"
+	},
+	"devDependencies": {
+		"@sveltejs/package": "^2.5.7",
+		"@sveltejs/vite-plugin-svelte": "^6.2.4",
+		"svelte": "^5.50.0",
+		"svelte-check": "^4.0.0",
+		"typescript": "^5.7.0",
+		"vite": "^7.3.1",
+		"vitest": "^3.0.0"
+	},
+	"scripts": {
+		"dev": "vite",
+		"build": "svelte-package -i src/lib -o dist",
+		"check": "svelte-check --tsconfig ./tsconfig.json",
+		"test": "vitest run"
+	},
+	"dependencies": {
+		"marked": "^16.4.2",
+		"shiki": "^3.22.0",
+		"tinyglobby": "^0.2.15",
+		"typescript": "^5.7.0"
+	}
 }

package/dist/language/parser.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/language/parser.test.js

@@ -1,158 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { parseSdoc, parseArgsLiteral, slugifyTitle, normalizeBody, } from './parser.js';
-function diagnosticCodes(source) {
-    return parseSdoc(source).diagnostics.map((d) => d.code);
-}
-describe('parseSdoc typed entities', () => {
-    const source = `<script>
-	import Tabs from './Tabs.svelte';
-	import Tab from './Tab.svelte';
-</script>
-
-[DOCS title="Navigation / Tabs" description="A tab bar."]
-
-	[preview component={Tabs} args={{ active: 0 }}]
-		<Tabs {...args}><Tab label="One">…</Tab></Tabs>
-	[/preview]
-
-	[preview component={Tab} args={{ label: 'One' }}]
-		<Tabs><Tab {...args}>…</Tab></Tabs>
-	[/preview]
-
-	[example title="Vertical"]
-		<Tabs vertical />
-	[/example]
-
-[/DOCS]
-`;
-    const doc = parseSdoc(source);
-    const docs = doc.entities[0];
-    it('parses without diagnostics', () => {
-        expect(doc.diagnostics).toEqual([]);
-    });
-    it('types the DOCS entity', () => {
-        expect(docs.kind).toBe('DOCS');
-        expect(docs.title).toBe('Navigation / Tabs');
-        expect(docs.slug).toBe('navigation-tabs');
-        expect(docs.description).toBe('A tab bar.');
-    });
-    it('collects previews with component names, own args, and labels', () => {
-        expect(docs.previews).toHaveLength(2);
-        expect(docs.previews[0]).toMatchObject({
-            componentName: 'Tabs',
-            args: { active: 0 },
-            label: 'Tabs',
-        });
-        expect(docs.previews[1]).toMatchObject({
-            componentName: 'Tab',
-            args: { label: 'One' },
-            label: 'Tab',
-        });
-    });
-    it('collects examples', () => {
-        expect(docs.examples).toHaveLength(1);
-        expect(docs.examples[0].title).toBe('Vertical');
-        expect(docs.examples[0].body).toContain('<Tabs vertical />');
-    });
-    it('uses title= as the tab label override', () => {
-        const overridden = parseSdoc(`[DOCS title="X"]
-[preview component={Button} title="As a link" args={{ a: 1 }}]
-x
-[/preview]
-[preview component={Button}]
-x
-[/preview]
-[/DOCS]
-`);
-        const entity = overridden.entities[0];
-        expect(entity.previews.map((p) => p.label)).toEqual(['As a link', 'Button']);
-        expect(overridden.diagnostics).toEqual([]);
-    });
-});
-describe('parseSdoc validation', () => {
-    it('requires entity titles', () => {
-        expect(diagnosticCodes('[DOCS]\n[/DOCS]\n')).toContain('missing-attr');
-        expect(diagnosticCodes('[PAGE]\nx\n[/PAGE]\n')).toContain('missing-attr');
-    });
-    it('requires component on previews and title on examples', () => {
-        expect(diagnosticCodes('[DOCS title="X"]\n[preview]\nx\n[/preview]\n[/DOCS]\n')).toContain('missing-attr');
-        expect(diagnosticCodes('[DOCS title="X"]\n[example]\nx\n[/example]\n[/DOCS]\n')).toContain('missing-attr');
-    });
-    it('rejects unknown attributes', () => {
-        expect(diagnosticCodes('[DOCS title="X" component={B}]\n[/DOCS]\n')).toContain('unknown-attr');
-        expect(diagnosticCodes('[PAGE title="X" padding="4px"]\nx\n[/PAGE]\n')).toContain('unknown-attr');
-    });
-    it('rejects wrong attribute value kinds', () => {
-        expect(diagnosticCodes('[DOCS title={x}]\n[/DOCS]\n')).toContain('attr-value-kind');
-        expect(diagnosticCodes('[DOCS title="X"]\n[preview component="Button"]\nx\n[/preview]\n[/DOCS]\n')).toContain('attr-value-kind');
-    });
-    it('rejects non-identifier component expressions', () => {
-        expect(diagnosticCodes('[DOCS title="X"]\n[preview component={Tabs.Tab}]\nx\n[/preview]\n[/DOCS]\n')).toContain('component-identifier');
-    });
-    it('rejects duplicate example titles and preview labels', () => {
-        expect(diagnosticCodes('[DOCS title="X"]\n[example title="A"]\nx\n[/example]\n[example title="A"]\ny\n[/example]\n[/DOCS]\n')).toContain('duplicate-example-title');
-        expect(diagnosticCodes('[DOCS title="X"]\n[preview component={B}]\nx\n[/preview]\n[preview component={B}]\ny\n[/preview]\n[/DOCS]\n')).toContain('duplicate-preview-label');
-    });
-    it('rejects colliding entity addresses in one file', () => {
-        expect(diagnosticCodes('[PAGE title="A B"]\nx\n[/PAGE]\n[PAGE title="A / B"]\ny\n[/PAGE]\n')).toContain('duplicate-entity-title');
-    });
-    it('accepts LAYOUT presentation attributes', () => {
-        const doc = parseSdoc('[LAYOUT title="Login" padding="48px"]\n<div />\n[/LAYOUT]\n');
-        expect(doc.diagnostics).toEqual([]);
-        expect(doc.entities[0]).toMatchObject({ kind: 'LAYOUT', padding: '48px' });
-    });
-});
-describe('parseArgsLiteral', () => {
-    function parse(raw) {
-        const diagnostics = [];
-        const values = parseArgsLiteral(raw, { start: 0, end: raw.length }, diagnostics);
-        return { values, messages: diagnostics.map((d) => d.message) };
-    }
-    it('parses flat literals of all three types', () => {
-        expect(parse(`{ label: 'Hi', size: 14, wide: true, off: false, neg: -0.5 }`).values).toEqual({
-            label: 'Hi',
-            size: 14,
-            wide: true,
-            off: false,
-            neg: -0.5,
-        });
-    });
-    it('parses empty objects, quoted keys, and escaped strings', () => {
-        expect(parse('{}').values).toEqual({});
-        expect(parse(`{ "data-x": 'a', b: "it\\'s" }`).values).toEqual({ 'data-x': 'a', b: "it's" });
-    });
-    it('rejects nested values and identifiers with a pointer to the body', () => {
-        expect(parse(`{ items: [1, 2] }`).values).toBeNull();
-        expect(parse(`{ obj: { a: 1 } }`).values).toBeNull();
-        const { values, messages } = parse(`{ icon: MyIcon }`);
-        expect(values).toBeNull();
-        expect(messages[0]).toContain('plain literal');
-    });
-    it('rejects malformed objects', () => {
-        expect(parse(`plain`).values).toBeNull();
-        expect(parse(`{ a: 1 b: 2 }`).values).toBeNull();
-        expect(parse(`{ a: 1 } extra`).values).toBeNull();
-    });
-});
-describe('normalizeBody', () => {
-    it('strips the common indentation but keeps relative indent', () => {
-        expect(normalizeBody('\n\t\t<div>\n\t\t\t<b>x</b>\n\t\t</div>\n')).toBe('<div>\n\t<b>x</b>\n</div>');
-    });
-    it('ignores blank lines when computing the indent and blanks them out', () => {
-        expect(normalizeBody('\t\ta\n\n\t\tb\n')).toBe('a\n\nb');
-    });
-    it('unescapes body lines that start with \\[', () => {
-        expect(normalizeBody('\t\\[example title="x"]\n\ttext\n')).toBe('[example title="x"]\ntext');
-    });
-    it('dedents PAGE bodies so markdown does not become code blocks', () => {
-        const doc = parseSdoc('[PAGE title="X"]\n\t## Heading\n\n\ttext\n[/PAGE]\n');
-        expect(doc.entities[0].body).toBe('## Heading\n\ntext');
-    });
-});
-describe('slugifyTitle', () => {
-    it('slugifies title paths', () => {
-        expect(slugifyTitle('Forms / Button')).toBe('forms-button');
-        expect(slugifyTitle('  Weird -- Title!! ')).toBe('weird-title');
-        expect(slugifyTitle('')).toBe('untitled');
-    });
-});

package/dist/language/projection.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/language/projection.test.js

@@ -1,117 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { readFileSync, readdirSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { compile } from 'svelte/compiler';
-import { scanSdoc } from './scanner.js';
-import { projectSdoc } from './projection.js';
-const SOURCE = `<script lang="ts">
-	import Tabs from './Tabs.svelte';
-	import Tab from './Tab.svelte';
-	const shared = 1;
-</script>
-
-[DOCS title="Nav / Tabs" description="A tab bar."]
-
-	[preview component={Tabs} args={{ active: 0 }}]
-		<Tabs {...args} active={shared}>x</Tabs>
-	[/preview]
-
-	[example title="Wrapped child"]
-		<Tabs><Tab {...args} /></Tabs>
-	[/example]
-
-[/DOCS]
-
-[PAGE title="Guide"]
-
-	## Heading
-
-	Uses {shared} and <Tabs />.
-
-	\`\`\`svelte
-	<NotReal {broken} />
-	\`\`\`
-
-	Inline \`{code}\` is masked.
-
-[/PAGE]
-
-<style>
-	.x { color: red; }
-</style>
-`;
-describe('projectSdoc', () => {
-    const projection = projectSdoc(scanSdoc(SOURCE));
-    const lines = projection.text.split('\n');
-    const sourceLines = SOURCE.split('\n');
-    it('preserves every authored line position', () => {
-        expect(projection.sourceLineCount).toBe(sourceLines.length);
-        for (let i = 0; i < sourceLines.length; i++) {
-            const kind = projection.lineKinds[i];
-            if (kind === 'verbatim')
-                expect(lines[i]).toBe(sourceLines[i]);
-            if (kind === 'blank')
-                expect(lines[i]).toBe('');
-        }
-    });
-    const at = (needle) => sourceLines.findIndex((l) => l.includes(needle));
-    it('keeps script, style, and bodies verbatim at identical lines', () => {
-        expect(lines[1]).toBe("\timport Tabs from './Tabs.svelte';");
-        expect(lines[at('{...args} active')]).toBe(sourceLines[at('{...args} active')]);
-        expect(lines[at('color: red')]).toContain('color: red');
-    });
-    it('rewrites sub-block openers to snippet wrappers in place', () => {
-        expect(lines[at('[preview')]).toBe('{#snippet __sdocs$0_0(args: any)}');
-        expect(lines[at('[/preview]')]).toBe('{/snippet}');
-        expect(lines[at('[example')]).toBe('{#snippet __sdocs$0_1(args: any)}');
-    });
-    it('blanks entity tags and masks PAGE code while keeping prose live', () => {
-        expect(lines[at('[DOCS')]).toBe('');
-        const proseLine = sourceLines.findIndex((l) => l.includes('Uses {shared}'));
-        expect(lines[proseLine]).toBe(sourceLines[proseLine]);
-        const fenceBody = sourceLines.findIndex((l) => l.includes('NotReal'));
-        expect(lines[fenceBody]).toBe('');
-        const inline = sourceLines.findIndex((l) => l.includes('Inline'));
-        expect(lines[inline]).not.toContain('{code}');
-        expect(lines[inline].length).toBe(sourceLines[inline].length);
-    });
-    it('appends a trailer that renders snippets and references components', () => {
-        const trailer = lines.slice(projection.sourceLineCount).join('\n');
-        expect(trailer).toContain('{@render __sdocs$0_0({})}');
-        expect(trailer).toContain('{@render __sdocs$1()}');
-        expect(trailer).toContain('<Tabs />');
-    });
-    it('produces text the Svelte compiler accepts', () => {
-        expect(() => compile(projection.text, { generate: false })).not.toThrow();
-    });
-});
-describe('projectSdoc over the real corpus', () => {
-    const dirs = [
-        resolve(__dirname, '../../../../../apps/site/src/lib/ui'),
-        resolve(__dirname, '../../../../../apps/testapp-embedded/src/lib/UI'),
-        resolve(__dirname, '../../../../../apps/testapp-standalone/src'),
-    ];
-    const files = [];
-    for (const dir of dirs) {
-        try {
-            for (const f of readdirSync(dir, { recursive: true })) {
-                if (f.endsWith('.sdoc'))
-                    files.push(resolve(dir, f));
-            }
-        }
-        catch {
-            // corpus dir not present in this checkout
-        }
-    }
-    it('found the corpus', () => {
-        expect(files.length).toBeGreaterThanOrEqual(10);
-    });
-    for (const file of files) {
-        it(`compiles ${file.split('/').slice(-1)[0]}`, () => {
-            const source = readFileSync(file, 'utf-8');
-            const projection = projectSdoc(scanSdoc(source));
-            expect(projection.sourceLineCount).toBe(source.split('\n').length);
-            expect(() => compile(projection.text, { generate: false })).not.toThrow();
-        });
-    }
-});

package/dist/language/scanner.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/language/scanner.test.js

@@ -1,146 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { scanSdoc } from './scanner.js';
-const FULL = `<script lang="ts">
-	import Button from './Button.svelte';
-</script>
-
-[DOCS title="Forms / Button" description="A flexible button."]
-
-	[preview component={Button} args={{ label: 'Hi', count: 2 }}]
-		<Button {...args} />
-	[/preview]
-
-	[example title="Disabled"]
-		<Button label="Nope" disabled />
-	[/example]
-
-[/DOCS]
-
-[PAGE title="Guides / Usage"]
-
-	## When to use
-
-	A [reference link][DOCS] and a fence:
-
-	\`\`\`svelte
-	[preview looks like a tag but is content]
-	\`\`\`
-
-[/PAGE]
-
-[LAYOUT title="Patterns / Login" padding="48px"]
-	<Button label="Sign in" />
-[/LAYOUT]
-
-<style>
-	.row { display: flex; }
-</style>
-`;
-describe('scanSdoc structure', () => {
-    const file = scanSdoc(FULL);
-    it('scans a full file without errors', () => {
-        expect(file.errors).toEqual([]);
-    });
-    it('captures script and style', () => {
-        expect(file.script?.attrsText).toContain('lang="ts"');
-        expect(file.script?.content).toContain("import Button from './Button.svelte';");
-        expect(file.style?.content).toContain('.row { display: flex; }');
-    });
-    it('finds all three entities in order', () => {
-        expect(file.entities.map((e) => e.kind)).toEqual(['DOCS', 'PAGE', 'LAYOUT']);
-    });
-    it('parses entity attributes with kinds', () => {
-        const docs = file.entities[0];
-        expect(docs.attrs.title).toMatchObject({ kind: 'string', raw: 'Forms / Button' });
-        expect(docs.attrs.description).toMatchObject({ kind: 'string', raw: 'A flexible button.' });
-        const layout = file.entities[2];
-        expect(layout.attrs.padding).toMatchObject({ kind: 'string', raw: '48px' });
-    });
-    it('parses sub-blocks with attributes and bodies', () => {
-        const [preview, example] = file.entities[0].blocks;
-        expect(preview.kind).toBe('preview');
-        expect(preview.attrs.component).toMatchObject({ kind: 'expression', raw: 'Button' });
-        expect(preview.attrs.args.raw).toBe("{ label: 'Hi', count: 2 }");
-        expect(preview.body).toContain('<Button {...args} />');
-        expect(example.kind).toBe('example');
-        expect(example.body).toContain('<Button label="Nope" disabled />');
-    });
-    it('keeps bracket-looking lines inside bodies as content', () => {
-        const page = file.entities[1];
-        expect(page.body).toContain('[reference link][DOCS]');
-        expect(page.body).toContain('[preview looks like a tag but is content]');
-        expect(file.entities).toHaveLength(3);
-    });
-    it('tracks spans that slice back to the source', () => {
-        const docs = file.entities[0];
-        expect(FULL.slice(docs.openerSpan.start, docs.openerSpan.end)).toBe('[DOCS title="Forms / Button" description="A flexible button."]');
-        expect(FULL.slice(docs.span.start, docs.span.end).endsWith('[/DOCS]')).toBe(true);
-        const preview = docs.blocks[0];
-        expect(FULL.slice(preview.bodySpan.start, preview.bodySpan.end)).toBe(preview.body);
-    });
-});
-describe('scanSdoc details', () => {
-    it('supports multi-line openers', () => {
-        const file = scanSdoc('[DOCS\n\ttitle="Forms / Button"\n\tdescription="Long."\n]\n[/DOCS]\n');
-        expect(file.errors).toEqual([]);
-        expect(file.entities[0].attrs.title.raw).toBe('Forms / Button');
-    });
-    it('supports bare attributes', () => {
-        const file = scanSdoc('[DOCS title="X" draft]\n[/DOCS]\n');
-        expect(file.entities[0].attrs.draft).toMatchObject({ kind: 'bare', raw: '' });
-    });
-    it('allows comments between blocks', () => {
-        const file = scanSdoc('<!-- a note\nspanning lines -->\n[PAGE title="X"]\nhi\n[/PAGE]\n');
-        expect(file.errors).toEqual([]);
-        expect(file.entities).toHaveLength(1);
-    });
-    it('tolerates CRLF line endings and a BOM', () => {
-        const file = scanSdoc('[DOCS title="X"]\r\n[preview component={B}]\r\n<B />\r\n[/preview]\r\n[/DOCS]\r\n');
-        expect(file.errors).toEqual([]);
-        expect(file.entities[0].blocks[0].body).toContain('<B />');
-    });
-    it('handles nested braces and strings in expression attributes', () => {
-        const file = scanSdoc(`[DOCS title="X"]\n[preview component={Button} args={{ a: '}', b: { }, c: "]" }}]\nx\n[/preview]\n[/DOCS]\n`);
-        expect(file.errors).toEqual([]);
-        expect(file.entities[0].blocks[0].attrs.args.raw).toBe(`{ a: '}', b: { }, c: "]" }`);
-    });
-});
-function codes(source) {
-    return scanSdoc(source).errors.map((e) => e.code);
-}
-describe('scanSdoc errors', () => {
-    it('rejects text outside blocks', () => {
-        expect(codes('hello\n')).toContain('text-outside-blocks');
-        expect(codes('[DOCS title="X"]\nstray text\n[/DOCS]\n')).toContain('text-outside-blocks');
-    });
-    it('rejects wrong casing with a targeted message', () => {
-        expect(codes('[docs title="X"]\n[/docs]\n')).toContain('casing');
-        expect(codes('[DOCS title="X"]\n[PREVIEW component={B}]\nx\n[/PREVIEW]\n[/DOCS]\n')).toContain('casing');
-    });
-    it('rejects sub-blocks outside DOCS and unknown blocks inside', () => {
-        expect(codes('[preview component={B}]\nx\n[/preview]\n')).toContain('block-outside-entity');
-        expect(codes('[DOCS title="X"]\n[stuff]\nx\n[/stuff]\n[/DOCS]\n')).toContain('unknown-tag');
-    });
-    it('requires openers to be alone on their line', () => {
-        expect(codes('[DOCS title="X"] trailing\n[/DOCS]\n')).toContain('tag-not-alone');
-    });
-    it('reports unclosed blocks', () => {
-        expect(codes('[DOCS title="X"]\n')).toContain('unclosed-block');
-        expect(codes('[DOCS title="X"]\n[preview component={B}]\nx\n[/DOCS]\n')).toContain('unclosed-block');
-        expect(codes('[PAGE title="X"]\ntext\n')).toContain('unclosed-block');
-    });
-    it('reports stray closers and duplicate attributes', () => {
-        expect(codes('[/DOCS]\n')).toContain('stray-closer');
-        expect(codes('[DOCS title="A" title="B"]\n[/DOCS]\n')).toContain('duplicate-attr');
-    });
-    it('enforces file anatomy: script top, style bottom', () => {
-        expect(codes('[PAGE title="X"]\nx\n[/PAGE]\n<script>\nlet a;\n</script>\n')).toContain('script-position');
-        expect(codes('<style>\n.a {}\n</style>\n[PAGE title="X"]\nx\n[/PAGE]\n')).toContain('style-position');
-    });
-    it('recovers when an entity opener appears inside an unclosed [DOCS]', () => {
-        const file = scanSdoc('[DOCS title="A"]\n[PAGE title="B"]\nx\n[/PAGE]\n');
-        expect(file.errors.map((e) => e.code)).toContain('unclosed-block');
-        expect(file.entities.map((e) => e.kind)).toEqual(['DOCS', 'PAGE']);
-        expect(file.entities[1].body.trim()).toBe('x');
-    });
-});

package/dist/server/prop-parser.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/server/prop-parser.test.js

@@ -1,148 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { parseComponentSource } from './prop-parser.js';
-function byName(list, name) {
-    const found = list.find((item) => item.name === name);
-    expect(found, `expected to find "${name}"`).toBeDefined();
-    return found;
-}
-describe('TypeScript components (interface Props)', () => {
-    const source = `<script lang="ts">
-	import type { Snippet } from 'svelte';
-
-	interface Props {
-		/** The button label text */
-		label?: string;
-		/** Visual style variant */
-		variant?: 'primary' | 'secondary';
-		count: number;
-		/** Click handler */
-		onclick?: (e: MouseEvent) => void;
-		oneTime?: boolean;
-		children?: Snippet;
-		item?: Snippet<[value: string]>;
-	}
-
-	let { label = 'Button', variant = 'primary', count, onclick, oneTime, children, item }: Props = $props();
-</script>
-
-<button>{label}</button>`;
-    const data = parseComponentSource(source);
-    it('extracts types, defaults, descriptions, and requiredness', () => {
-        const label = byName(data.props, 'label');
-        expect(label.type).toBe('string');
-        expect(label.default).toBe('Button');
-        expect(label.description).toBe('The button label text');
-        expect(label.required).toBe(false);
-        const count = byName(data.props, 'count');
-        expect(count.type).toBe('number');
-        expect(count.default).toBe(null);
-        expect(count.required).toBe(true);
-    });
-    it('classifies events, snippets, and on-prefixed non-functions', () => {
-        expect(byName(data.props, 'onclick').category).toBe('event');
-        expect(byName(data.props, 'oneTime').category).toBe('prop');
-        expect(byName(data.props, 'children').category).toBe('snippet');
-        expect(byName(data.props, 'item').category).toBe('snippet');
-    });
-});
-describe('JS components with @type {{ ... }} annotation', () => {
-    const source = `<script>
-	/** @type {{ label?: string, size?: 'sm' | 'lg', onclick?: (e: MouseEvent) => void }} */
-	let { label = 'Badge', size = 'sm', onclick } = $props();
-</script>
-
-<span>{label}</span>`;
-    const data = parseComponentSource(source);
-    it('extracts types and optionality from the annotation', () => {
-        const label = byName(data.props, 'label');
-        expect(label.type).toBe('string');
-        expect(label.default).toBe('Badge');
-        expect(label.required).toBe(false);
-        expect(byName(data.props, 'size').type).toBe("'sm' | 'lg'");
-    });
-    it('classifies events from JSDoc function types', () => {
-        expect(byName(data.props, 'onclick').category).toBe('event');
-    });
-});
-describe('JS components with @typedef/@property', () => {
-    const source = `<script>
-	/**
-	 * @typedef {Object} Props
-	 * @property {string} [label] - The badge label
-	 * @property {number} count - How many
-	 * @property {() => void} [ondismiss] - Called when dismissed
-	 * @property {import('svelte').Snippet} [children] - Body content
-	 */
-
-	/** @type {Props} */
-	let { label = 'Badge', count, ondismiss, children } = $props();
-</script>
-
-<span>{label}{count}</span>`;
-    const data = parseComponentSource(source);
-    it('extracts types, descriptions, and optionality from @property tags', () => {
-        const label = byName(data.props, 'label');
-        expect(label.type).toBe('string');
-        expect(label.description).toBe('The badge label');
-        expect(label.required).toBe(false);
-        expect(label.default).toBe('Badge');
-        const count = byName(data.props, 'count');
-        expect(count.type).toBe('number');
-        expect(count.description).toBe('How many');
-        expect(count.required).toBe(true);
-    });
-    it('classifies events and imported Snippet types', () => {
-        expect(byName(data.props, 'ondismiss').category).toBe('event');
-        expect(byName(data.props, 'children').category).toBe('snippet');
-    });
-});
-describe('untyped JS components', () => {
-    it('still extracts names and defaults from destructuring', () => {
-        const data = parseComponentSource(`<script>
-	let { label = 'x', flag } = $props();
-</script>`);
-        expect(byName(data.props, 'label').default).toBe('x');
-        expect(byName(data.props, 'label').type).toBe(null);
-        expect(byName(data.props, 'flag').required).toBe(true);
-    });
-});
-describe('methods, state, and CSS custom properties', () => {
-    const source = `<script lang="ts">
-	/** Clears the value */
-	export function clear(): void {}
-
-	/** Current count */
-	export const count = $state(0);
-
-	/**
-	 * @cssvar {color} --bg - Background color
-	 * @cssvar {dimension} --radius - Corner radius
-	 */
-</script>
-
-<style>
-	.x {
-		background: var(--bg, #333);
-		border-radius: var(--radius, 4px);
-		padding: var(--pad, 8px);
-	}
-</style>`;
-    const data = parseComponentSource(source);
-    it('extracts exported functions with descriptions', () => {
-        const clear = byName(data.methods, 'clear');
-        expect(clear.returnType).toBe('void');
-        expect(clear.description).toBe('Clears the value');
-    });
-    it('extracts exported state', () => {
-        expect(byName(data.state, 'count').description).toBe('Current count');
-    });
-    it('extracts CSS vars, merging @cssvar type/description with var() defaults', () => {
-        const bg = byName(data.cssProps, '--bg');
-        expect(bg.type).toBe('color');
-        expect(bg.default).toBe('#333');
-        expect(bg.description).toBe('Background color');
-        const pad = byName(data.cssProps, '--pad');
-        expect(pad.type).toBe(null);
-        expect(pad.default).toBe('8px');
-    });
-});

package/dist/server/snippet-compiler.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/server/snippet-compiler.test.js

@@ -1,23 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { generateIframeComponent } from './snippet-compiler.js';
-describe('root ref injection', () => {
-    it('binds the documented component, not the wrapper', () => {
-        const out = generateIframeComponent([], '<Tabs>\n\t<Tab {...args} />\n</Tabs>', [], 'Tab');
-        expect(out).toContain('<Tab bind:this={__sdocsRef} {...args} />');
-        expect(out).not.toContain('<Tabs bind:this');
-    });
-    it('binds the first capitalized tag when no component is named', () => {
-        const out = generateIframeComponent([], '<Card><Button /></Card>', []);
-        expect(out).toContain('<Card bind:this={__sdocsRef}>');
-    });
-    it('falls back to the first capitalized tag when the named component is absent', () => {
-        const out = generateIframeComponent([], '<Tabs active={0}>text</Tabs>', [], 'Tab');
-        expect(out).toContain('<Tabs bind:this={__sdocsRef} active={0}>');
-    });
-    it('leaves snippets with an author bind:this untouched', () => {
-        const body = '<Tab bind:this={mine} />';
-        const out = generateIframeComponent([], body, [], 'Tab');
-        expect(out).toContain(body);
-        expect(out).not.toContain('bind:this={__sdocsRef}');
-    });
-});