vocs 1.4.0 → 2.0.0-rc.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024-present weth, LLC
+Copyright (c) 2025-present 
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -3,14 +3,14 @@
 <p align="center">
   <a href="https://vocs.dev">
     <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="https://github.com/wevm/vocs/blob/main/.github/vocs-logo-dark.svg">
-      <img alt="vocs logo" src="https://github.com/wevm/vocs/blob/main/.github/vocs-logo-light.svg" width="auto" height="40">
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/wevm/vocs/refs/heads/next/.github/logo-dark.svg">
+      <img alt="vocs logo" src="https://raw.githubusercontent.com/wevm/vocs/refs/heads/next/.github/logo-light.svg" width="auto" height="100">
     </picture>
   </a>
 </p>
 
 <p align="center">
-  Minimal Documentation Framework, powered by React + Vite.
+  Portable Documentation Framework, powered by Vite.
 <p>
 
 <p align="center">
@@ -28,7 +28,6 @@
   </a>
 </p>
 
-
 ## Documentation
 
 For documentation and guides, visit [vocs.dev](https://vocs.dev).
@@ -46,4 +45,3 @@ For casual chit-chat with others using the framework:
 ## Contributing
 
 Contributions to Vocs are greatly appreciated! If you're interested in contributing to Vocs, please read the [Contributing Guide](https://github.com/wevm/vocs/blob/main/.github/CONTRIBUTING.md) **before submitting a pull request**.
-

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs';
+import { glob } from 'node:fs/promises';
+import * as path from 'node:path';
+import react from '@vitejs/plugin-react';
+import { cac } from 'cac';
+import * as vite from 'vite';
+import * as Config from './internal/config.js';
+import { vocs } from './waku/vite.js';
+const pkg = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+const cli = cac('vocs');
+async function getTypeScriptForTwoslash() {
+    try {
+        return await import('typescript');
+    }
+    catch {
+        throw new Error('Using twoslash code blocks requires `typescript` to be installed in your project.');
+    }
+}
+cli
+    .command('dev', 'Start development server')
+    .option('--port <port>', 'Port to listen on', { default: 5173 })
+    .option('--host [host]', 'Host to listen on')
+    .action(async (options) => {
+    const server = await vite.createServer({
+        configFile: false,
+        plugins: [react(), vocs()],
+        server: {
+            port: options.port,
+            ...(options.host !== undefined && { host: options.host }),
+        },
+    });
+    await server.listen();
+    server.printUrls();
+});
+cli.command('build', 'Build for production').action(async () => {
+    const config = await Config.resolve();
+    const builder = await vite.createBuilder({
+        configFile: false,
+        plugins: [react(), vocs()],
+        build: {
+            outDir: config.outDir,
+        },
+    });
+    await builder.buildApp();
+});
+cli
+    .command('preview', 'Preview production build')
+    .option('--port <port>', 'Port to listen on', { default: 4173 })
+    .option('--host [host]', 'Host to listen on')
+    .action(async (options) => {
+    const config = await Config.resolve();
+    process.env['PORT'] ??= String(options.port);
+    if (options.host)
+        process.env['HOST'] = String(options.host);
+    const previewPath = new URL(`${config.outDir}/preview.js`, `file://${process.cwd()}/`).href;
+    await import(previewPath);
+});
+cli
+    .command('twoslash [pattern]', 'Check twoslash blocks for errors [experimental]')
+    .option('--lang <lang>', 'Language to check: typescript, rust, or all', { default: 'typescript' })
+    .option('--fail-on-error', 'Exit with non-zero code if errors found', { default: true })
+    .option('--concurrency <n>', 'Number of parallel Rust compilations', { default: 1 })
+    .option('--verbose', 'Enable verbose output', { default: false })
+    .action(async (pattern, options) => {
+    const config = await Config.resolve();
+    const srcDir = path.resolve(config.rootDir, config.srcDir);
+    const cacheDir = path.resolve(config.rootDir, '.vocs/cache');
+    // Find MD/MDX files matching the pattern
+    // Auto-append /*.{md,mdx} if pattern doesn't already specify an extension
+    let globPattern = pattern ?? '**/*.{md,mdx}';
+    if (pattern && !pattern.match(/\.mdx?(\})?$/)) {
+        globPattern = pattern.endsWith('/') ? `${pattern}*.{md,mdx}` : `${pattern}/*.{md,mdx}`;
+    }
+    const mdxFiles = [];
+    for await (const file of glob(globPattern, { cwd: srcDir }))
+        mdxFiles.push(path.resolve(srcDir, file));
+    if (mdxFiles.length === 0) {
+        console.log('[vocs] No MDX files found');
+        return;
+    }
+    // Regex to find ```lang twoslash code blocks (3+ backticks or tildes)
+    const twoslashRegex = /(?:`{3,}|~{3,})(\w+)\s+twoslash([^\n]*)\n([\s\S]*?)(?:`{3,}|~{3,})/g;
+    // Regex to find :::code-group blocks (3+ colons)
+    const codeGroupRegex = /:{3,}code-group\n([\s\S]*?):{3,}/g;
+    // Regex to extract filename from meta
+    const filenameRegex = /filename=["']([^"']+)["']/;
+    const tsLangs = ['ts', 'tsx', 'typescript', 'js', 'jsx', 'javascript'];
+    const rustLangs = ['rust', 'rs'];
+    const tsBlocks = [];
+    const rustBlocks = [];
+    // Physical source getter for `// [!include ~/...]`
+    const Snippets = await import('./internal/snippets.js');
+    const physicalSourceGetter = Snippets.createPhysicalSourceGetter({
+        srcDir: config.srcDir,
+        rootDir: config.rootDir,
+    });
+    /** Removes common leading whitespace from all lines. */
+    function dedent(text) {
+        const lines = text.split('\n');
+        let minIndent = Number.POSITIVE_INFINITY;
+        for (const line of lines) {
+            if (line.trim().length === 0)
+                continue;
+            const match = line.match(/^(\s*)/);
+            if (match)
+                minIndent = Math.min(minIndent, match[1]?.length ?? 0);
+        }
+        if (minIndent === Number.POSITIVE_INFINITY || minIndent === 0)
+            return text;
+        return lines.map((line) => line.slice(minIndent)).join('\n');
+    }
+    for (const file of mdxFiles) {
+        const content = fs.readFileSync(file, 'utf-8');
+        // Build virtual file map from code-groups
+        const virtualFiles = new Map();
+        for (const groupMatch of content.matchAll(codeGroupRegex)) {
+            const groupContent = groupMatch[1] ?? '';
+            for (const blockMatch of groupContent.matchAll(twoslashRegex)) {
+                const meta = blockMatch[2]?.trim() ?? '';
+                let code = blockMatch[3] ?? '';
+                const filenameMatch = meta.match(filenameRegex);
+                if (filenameMatch?.[1]) {
+                    code = Snippets.processIncludes({
+                        code: code.trim(),
+                        getSource: physicalSourceGetter,
+                    });
+                    virtualFiles.set(filenameMatch[1], code);
+                }
+            }
+        }
+        // Combine physical and virtual source getters
+        const virtualSourceGetter = Snippets.createVirtualSourceGetter({ virtualFiles });
+        const getSource = Snippets.combineSourceGetters(physicalSourceGetter, virtualSourceGetter);
+        for (const match of content.matchAll(twoslashRegex)) {
+            const lang = match[1];
+            const meta = match[2]?.trim() ?? '';
+            let code = match[3];
+            if (!lang || !code)
+                continue;
+            code = dedent(code);
+            code = Snippets.processIncludes({ code, getSource });
+            if (virtualFiles.size > 0 && tsLangs.includes(lang)) {
+                code = Snippets.processImports({ code, virtualFiles });
+            }
+            if (tsLangs.includes(lang)) {
+                tsBlocks.push({ file, code, lang, meta });
+            }
+            else if (rustLangs.includes(lang)) {
+                rustBlocks.push({ file, code, lang, meta });
+            }
+        }
+    }
+    const checkTs = options.lang === 'typescript' || options.lang === 'all';
+    const checkRust = options.lang === 'rust' || options.lang === 'all';
+    const blocksToCheck = (checkTs ? tsBlocks.length : 0) + (checkRust ? rustBlocks.length : 0);
+    if (blocksToCheck === 0) {
+        console.log('[vocs] No twoslash blocks found');
+        return;
+    }
+    const errors = [];
+    // Check TypeScript blocks
+    if (checkTs && tsBlocks.length > 0) {
+        console.log(`[vocs] Checking ${tsBlocks.length} TypeScript twoslash block(s)...`);
+        // Use same config as build (shiki-transformers.ts)
+        const { createTwoslasher } = await import('twoslash');
+        const tsModule = await getTypeScriptForTwoslash();
+        const twoslasher = createTwoslasher({
+            tsModule,
+            compilerOptions: {
+                ignoreDeprecations: Number.parseInt(tsModule.versionMajorMinor, 10) >= 6 ? '6.0' : '5.0',
+                moduleResolution: 100, // bundler
+                preserveSymlinks: false,
+                types: ['node'],
+            },
+            customTags: ['log', 'error', 'warn', 'annotate'],
+        });
+        for (const block of tsBlocks) {
+            const relativePath = path.relative(config.rootDir, block.file);
+            try {
+                twoslasher(block.code, block.lang);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                errors.push({
+                    file: relativePath,
+                    lang: block.lang,
+                    meta: block.meta,
+                    code: block.code,
+                    error: message,
+                });
+            }
+        }
+    }
+    // Check Rust blocks
+    if (checkRust && rustBlocks.length > 0) {
+        console.log(`[vocs] Checking ${rustBlocks.length} Rust twoslash block(s)...`);
+        const { createRustTwoslasher } = await import('./internal/twoslash/index.js');
+        const rustTwoslasher = createRustTwoslasher({
+            cacheDir,
+            verbose: options.verbose,
+        });
+        const concurrency = Math.max(1, options.concurrency);
+        const queue = [...rustBlocks];
+        const processBlock = async (block) => {
+            const relativePath = path.relative(config.rootDir, block.file);
+            try {
+                rustTwoslasher(block.code, 'rust');
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                errors.push({
+                    file: relativePath,
+                    lang: block.lang,
+                    meta: block.meta,
+                    code: block.code,
+                    error: message,
+                });
+            }
+        };
+        const workers = Array.from({ length: concurrency }, async () => {
+            while (queue.length > 0) {
+                const block = queue.shift();
+                if (block)
+                    await processBlock(block);
+            }
+        });
+        await Promise.all(workers);
+    }
+    if (errors.length === 0) {
+        console.log(`[vocs] All ${blocksToCheck} twoslash block(s) passed`);
+        return;
+    }
+    console.error(`\n[vocs] Found ${errors.length} twoslash error(s):\n`);
+    for (const err of errors) {
+        console.error(`File: ${err.file}`);
+        console.error(`Lang: ${err.lang}${err.meta ? ` ${err.meta}` : ''}`);
+        console.error(`Error: ${err.error}`);
+        console.error(`Code:\n${err.code.slice(0, 200)}${err.code.length > 200 ? '...' : ''}`);
+        console.error('\n---\n');
+    }
+    if (options.failOnError) {
+        process.exit(1);
+    }
+});
+cli.help();
+cli.version(pkg.version);
+cli.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAErC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;AAE5F,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;AAEvB,KAAK,UAAU,wBAAwB;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAA;IACH,CAAC;AACH,CAAC;AAED,GAAG;KACA,OAAO,CAAC,KAAK,EAAE,0BAA0B,CAAC;KAC1C,MAAM,CAAC,eAAe,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KAC/D,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC;KAC5C,MAAM,CAAC,KAAK,EAAE,OAAkD,EAAE,EAAE;IACnE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;QACrC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;QAC1B,MAAM,EAAE;YACN,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;SAC1D;KACF,CAAC,CAAA;IACF,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;IACrB,MAAM,CAAC,SAAS,EAAE,CAAA;AACpB,CAAC,CAAC,CAAA;AAEJ,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IACrC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC;QACvC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;QAC1B,KAAK,EAAE;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB;KACF,CAAC,CAAA;IACF,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;AAC1B,CAAC,CAAC,CAAA;AAEF,GAAG;KACA,OAAO,CAAC,SAAS,EAAE,0BAA0B,CAAC;KAC9C,MAAM,CAAC,eAAe,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KAC/D,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC;KAC5C,MAAM,CAAC,KAAK,EAAE,OAAkD,EAAE,EAAE;IACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IACrC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,aAAa,EAAE,UAAU,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAA;IAC3F,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEJ,GAAG;KACA,OAAO,CAAC,oBAAoB,EAAE,iDAAiD,CAAC;KAChF,MAAM,CAAC,eAAe,EAAE,6CAA6C,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;KACjG,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACvF,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;KACnF,MAAM,CAAC,WAAW,EAAE,uBAAuB,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KAChE,MAAM,CACL,KAAK,EACH,OAA2B,EAC3B,OAKC,EACD,EAAE;IACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;IAE5D,yCAAyC;IACzC,0EAA0E;IAC1E,IAAI,WAAW,GAAG,OAAO,IAAI,eAAe,CAAA;IAC5C,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QAC9C,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,aAAa,CAAA;IACxF,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IAE3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;QACxC,OAAM;IACR,CAAC;IAED,sEAAsE;IACtE,MAAM,aAAa,GAAG,qEAAqE,CAAA;IAC3F,iDAAiD;IACjD,MAAM,cAAc,GAAG,mCAAmC,CAAA;IAC1D,sCAAsC;IACtC,MAAM,aAAa,GAAG,2BAA2B,CAAA;IAEjD,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;IACtE,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAGhC,MAAM,QAAQ,GAAY,EAAE,CAAA;IAC5B,MAAM,UAAU,GAAY,EAAE,CAAA;IAE9B,mDAAmD;IACnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;IACvD,MAAM,oBAAoB,GAAG,QAAQ,CAAC,0BAA0B,CAAC;QAC/D,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAA;IAEF,wDAAwD;IACxD,SAAS,MAAM,CAAC,IAAY;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,SAAS,GAAG,MAAM,CAAC,iBAAiB,CAAA;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAClC,IAAI,KAAK;gBAAE,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAA;QACnE,CAAC;QACD,IAAI,SAAS,KAAK,MAAM,CAAC,iBAAiB,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QAC1E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAE9C,0CAA0C;QAC1C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAA;QAC9C,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAC1D,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;YACxC,KAAK,MAAM,UAAU,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;gBACxC,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;gBAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;gBAC/C,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvB,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;wBAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;wBACjB,SAAS,EAAE,oBAAoB;qBAChC,CAAC,CAAA;oBACF,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,MAAM,mBAAmB,GAAG,QAAQ,CAAC,yBAAyB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAA;QAChF,MAAM,SAAS,GAAG,QAAQ,CAAC,oBAAoB,CAAC,oBAAoB,EAAE,mBAAmB,CAAC,CAAA;QAE1F,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;YACnC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YACnB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;gBAAE,SAAQ;YAE5B,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YACnB,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;YAEpD,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAA;YACxD,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC3C,CAAC;iBAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,CAAA;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,CAAA;IAEnE,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3F,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAA;QAC9C,OAAM;IACR,CAAC;IAGD,MAAM,MAAM,GAAoB,EAAE,CAAA;IAElC,0BAA0B;IAC1B,IAAI,OAAO,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAC,MAAM,kCAAkC,CAAC,CAAA;QAEjF,mDAAmD;QACnD,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAA;QACrD,MAAM,QAAQ,GAAG,MAAM,wBAAwB,EAAE,CAAA;QACjD,MAAM,UAAU,GAAG,gBAAgB,CAAC;YAClC,QAAQ;YACR,eAAe,EAAE;gBACf,kBAAkB,EAChB,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;gBACtE,gBAAgB,EAAE,GAAG,EAAE,UAAU;gBACjC,gBAAgB,EAAE,KAAK;gBACvB,KAAK,EAAE,CAAC,MAAM,CAAC;aAChB;YACD,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC;SACjD,CAAC,CAAA;QAEF,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC9D,IAAI,CAAC;gBACH,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAChE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,OAAO;iBACf,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,mBAAmB,UAAU,CAAC,MAAM,4BAA4B,CAAC,CAAA;QAC7E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAA;QAC7E,MAAM,cAAc,GAAG,oBAAoB,CAAC;YAC1C,QAAQ;YACR,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAA;QAEF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,CAAA;QAE7B,MAAM,YAAY,GAAG,KAAK,EAAE,KAAY,EAAE,EAAE;YAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC9D,IAAI,CAAC;gBACH,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAChE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,OAAO;iBACf,CAAC,CAAA;YACJ,CAAC;QACH,CAAC,CAAA;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;gBAC3B,IAAI,KAAK;oBAAE,MAAM,YAAY,CAAC,KAAK,CAAC,CAAA;YACtC,CAAC;QACH,CAAC,CAAC,CAAA;QACF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,2BAA2B,CAAC,CAAA;QACnE,OAAM;IACR,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,MAAM,uBAAuB,CAAC,CAAA;IACrE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;QAClC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACnE,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,KAAK,EAAE,CAAC,CAAA;QACpC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACtF,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC1B,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC,CACF,CAAA;AAEH,GAAG,CAAC,IAAI,EAAE,CAAA;AACV,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACxB,GAAG,CAAC,KAAK,EAAE,CAAA"}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export * as Changelog from './internal/changelog.js';
+export { type Config, define as defineConfig, resolve as resolveConfig, } from './internal/config.js';
+export * as Feedback from './internal/feedback.js';
+export * as McpSource from './internal/mcp-source.js';
+export * as Twoslash from './internal/twoslash/index.js';
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAA;AACpD,OAAO,EACL,KAAK,MAAM,EACX,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA"}

package/dist/config.js

@@ -0,0 +1,7 @@
+/// <reference types="./globals.d.ts" />
+export * as Changelog from './internal/changelog.js';
+export { define as defineConfig, resolve as resolveConfig, } from './internal/config.js';
+export * as Feedback from './internal/feedback.js';
+export * as McpSource from './internal/mcp-source.js';
+export * as Twoslash from './internal/twoslash/index.js';
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAEL,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,GACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,QAAQ,MAAM,8BAA8B,CAAA"}

package/dist/globals.d.ts

@@ -0,0 +1,59 @@
+/// <reference types="unplugin-icons/types/react" />
+
+declare module '*.mdx' {
+  export const frontmatter: import('./config.js').Frontmatter
+  export function Page(props: Record<string, unknown>): JSX.Element
+  export default function MDXContent(props: Record<string, unknown>): JSX.Element
+}
+
+declare module '*.md' {
+  export const frontmatter: import('./config.js').Frontmatter
+  export function Page(props: Record<string, unknown>): JSX.Element
+  export default function MDXContent(props: Record<string, unknown>): JSX.Element
+}
+
+declare module 'virtual:vocs/config' {
+  export const config: import('./config.js').Config
+}
+
+declare module 'virtual:vocs/langs' {
+  export const langs: import('shiki').LanguageRegistration[]
+}
+
+declare module 'virtual:vocs/search-index' {
+  export function getSearchIndex(): Promise<string>
+}
+
+declare module 'virtual:vocs/group-icons.css' {}
+
+declare module 'virtual:vocs/group-icons.css?inline' {
+  const css: string
+  export default css
+}
+
+declare module 'virtual:vocs/group-icons.css?url' {
+  const url: string | undefined
+  export default url
+}
+
+declare module 'virtual:vocs/user-styles' {
+  const url: string | undefined
+  export default url
+}
+
+declare module 'virtual:vocs/user-styles?inline' {
+  const css: string | undefined
+  export default css
+}
+
+declare module '*.css?url' {
+  const url: string
+  export default url
+}
+
+declare module 'virtual:vocs/slots' {
+  import type { ComponentType } from 'react'
+  export const Footer: ComponentType | undefined
+  export const OutlineFooter: ComponentType | undefined
+  export const SidebarHeader: ComponentType | undefined
+}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { useRouter } from 'waku';
+export * as Feedback from './internal/feedback.js';
+export * as McpSource from './internal/mcp-source.js';
+export { Badge } from './react/Badge.js';
+export { Callout } from './react/Callout.js';
+export { Card, Cards } from './react/Cards.js';
+export { Head } from './react/Head.js';
+export * as HomePage from './react/HomePage.js';
+export { Feedback as FeedbackWidget } from './react/internal/Feedback.client.js';
+export { Layout } from './react/Layout.js';
+export { Link } from './react/Link.js';
+export * as MdxPageContext from './react/MdxPageContext.js';
+export { Provider as MdxPageContextProvider } from './react/MdxPageContext.js';
+export { Sandbox } from './react/Sandbox/index.js';
+export { ScrollRestoration } from './react/ScrollRestoration.js';
+export { Tab, Tabs } from './react/Tabs.js';
+export { useConfig } from './react/useConfig.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export { useRouter } from 'waku';
+export * as Feedback from './internal/feedback.js';
+export * as McpSource from './internal/mcp-source.js';
+export { Badge } from './react/Badge.js';
+export { Callout } from './react/Callout.js';
+export { Card, Cards } from './react/Cards.js';
+export { Head } from './react/Head.js';
+export * as HomePage from './react/HomePage.js';
+export { Feedback as FeedbackWidget } from './react/internal/Feedback.client.js';
+export { Layout } from './react/Layout.js';
+export { Link } from './react/Link.js';
+export * as MdxPageContext from './react/MdxPageContext.js';
+export { Provider as MdxPageContextProvider } from './react/MdxPageContext.js';
+export { Sandbox } from './react/Sandbox/index.js';
+export { ScrollRestoration } from './react/ScrollRestoration.js';
+export { Tab, Tabs } from './react/Tabs.js';
+export { useConfig } from './react/useConfig.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,KAAK,QAAQ,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/internal/changelog.d.ts

@@ -0,0 +1,78 @@
+export type Adapter = {
+    /** Adapter type identifier */
+    type: string;
+    /** Fetches releases from the source */
+    fetch: (options?: {
+        /** Maximum number of releases to fetch */
+        limit?: number | undefined;
+        /** Include prereleases */
+        prereleases?: boolean | undefined;
+    }) => Promise<Release[]>;
+};
+export type Release = {
+    /** Release version/tag name (e.g., "v1.0.0") */
+    version: string;
+    /** Release title/name */
+    title: string;
+    /** Release date as ISO string */
+    date: string;
+    /** Release notes content (Markdown) */
+    body: string;
+    /** Release notes content as HTML (rendered from body) */
+    bodyHtml?: string | undefined;
+    /** URL to the release page */
+    url: string;
+    /** Whether this is a prerelease */
+    prerelease?: boolean | undefined;
+};
+/**
+ * Creates a changelog adapter from a custom adapter definition.
+ *
+ * @example
+ * ```ts
+ * import { Changelog } from 'vocs'
+ *
+ * export default defineConfig({
+ *   changelog: Changelog.from({
+ *     type: 'custom',
+ *     async fetch() {
+ *       return [{ version: '1.0.0', title: 'v1.0.0', date: '2024-01-01', body: '', url: '' }]
+ *     },
+ *   }),
+ * })
+ * ```
+ */
+export declare function from(adapter: Adapter): Adapter;
+/**
+ * Creates a GitHub releases changelog adapter.
+ *
+ * @example
+ * ```ts
+ * import { github } from 'vocs/changelog'
+ *
+ * export default defineConfig({
+ *   changelog: github({ repo: 'wevm/viem' }),
+ * })
+ * ```
+ */
+export declare function github(options: github.Options): Adapter;
+export declare namespace github {
+    type Options = {
+        /**
+         * GitHub repository in "owner/repo" format.
+         * @example "wevm/viem"
+         */
+        repo: string;
+        /**
+         * Include prereleases in the changelog.
+         * @default false
+         */
+        prereleases?: boolean | undefined;
+        /**
+         * GitHub API token for authenticated requests (higher rate limits).
+         * Falls back to GITHUB_TOKEN environment variable.
+         */
+        token?: string | undefined;
+    };
+}
+//# sourceMappingURL=changelog.d.ts.map

package/dist/internal/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/internal/changelog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE;QAChB,0CAA0C;QAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1B,0BAA0B;QAC1B,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAClC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACjC,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CA6CvD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,OAAO,GAAG;QACb;;;WAGG;QACH,IAAI,EAAE,MAAM,CAAA;QACZ;;;WAGG;QACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACjC;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC3B,CAAA;CACF"}

package/dist/internal/changelog.js

@@ -0,0 +1,63 @@
+/**
+ * Creates a changelog adapter from a custom adapter definition.
+ *
+ * @example
+ * ```ts
+ * import { Changelog } from 'vocs'
+ *
+ * export default defineConfig({
+ *   changelog: Changelog.from({
+ *     type: 'custom',
+ *     async fetch() {
+ *       return [{ version: '1.0.0', title: 'v1.0.0', date: '2024-01-01', body: '', url: '' }]
+ *     },
+ *   }),
+ * })
+ * ```
+ */
+export function from(adapter) {
+    return adapter;
+}
+/**
+ * Creates a GitHub releases changelog adapter.
+ *
+ * @example
+ * ```ts
+ * import { github } from 'vocs/changelog'
+ *
+ * export default defineConfig({
+ *   changelog: github({ repo: 'wevm/viem' }),
+ * })
+ * ```
+ */
+export function github(options) {
+    const { repo, token, prereleases = false } = options;
+    return {
+        type: 'github',
+        async fetch(fetchOptions = {}) {
+            const { limit = 50 } = fetchOptions;
+            const apiToken = token || process.env['GITHUB_TOKEN'];
+            const headers = {
+                Accept: 'application/vnd.github.v3+json',
+                'User-Agent': 'vocs-changelog',
+            };
+            if (apiToken)
+                headers['Authorization'] = `Bearer ${apiToken}`;
+            const response = await globalThis.fetch(`https://api.github.com/repos/${repo}/releases?per_page=${limit}`, { headers });
+            if (!response.ok)
+                throw new Error(`Failed to fetch GitHub releases: ${response.statusText}`);
+            const data = (await response.json());
+            return data
+                .filter((release) => prereleases || !release.prerelease)
+                .map((release) => ({
+                version: release.tag_name,
+                title: release.name || release.tag_name,
+                date: release.published_at,
+                body: release.body || '',
+                url: release.html_url,
+                prerelease: release.prerelease,
+            }));
+        },
+    };
+}
+//# sourceMappingURL=changelog.js.map

package/dist/internal/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/internal/changelog.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,IAAI,CAAC,OAAgB;IACnC,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,MAAM,CAAC,OAAuB;IAC5C,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAEpD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE;YAC3B,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,YAAY,CAAA;YAEnC,MAAM,QAAQ,GAAG,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YACrD,MAAM,OAAO,GAA2B;gBACtC,MAAM,EAAE,gCAAgC;gBACxC,YAAY,EAAE,gBAAgB;aAC/B,CAAA;YACD,IAAI,QAAQ;gBAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,QAAQ,EAAE,CAAA;YAE7D,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CACrC,gCAAgC,IAAI,sBAAsB,KAAK,EAAE,EACjE,EAAE,OAAO,EAAE,CACZ,CAAA;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YAW5F,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAA;YAEvD,OAAO,IAAI;iBACR,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;iBACvD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBACjB,OAAO,EAAE,OAAO,CAAC,QAAQ;gBACzB,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ;gBACvC,IAAI,EAAE,OAAO,CAAC,YAAY;gBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;gBACxB,GAAG,EAAE,OAAO,CAAC,QAAQ;gBACrB,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC,CAAA;QACP,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/internal/config-serializer.d.ts

@@ -0,0 +1,7 @@
+import type { Config } from './config.js';
+export declare function serialize(config: Config): string;
+export declare function serializeFunctions(value: any, key?: string): any;
+export declare function deserialize(config: string): Config;
+export declare function deserializeFunctions(value: any): any;
+export declare const deserializeFunctionsStringified = "\n  function deserializeFunctions(value) {\n    if (Array.isArray(value)) {\n      return value.map(deserializeFunctions)\n    } else if (typeof value === 'object' && value !== null) {\n      return Object.keys(value).reduce((acc, key) => {\n        acc[key] = deserializeFunctions(value[key])\n        return acc\n      }, {})\n    } else if (typeof value === 'string' && value.includes('_vocs-fn_')) {\n      return new Function(`return ${value.slice(9)}`)()\n    } else {\n      return value\n    }\n  }\n";
+//# sourceMappingURL=config-serializer.d.ts.map

package/dist/internal/config-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-serializer.d.ts","sourceRoot":"","sources":["../../src/internal/config-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAoBhE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAGD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAepD;AAED,eAAO,MAAM,+BAA+B,igBAe3C,CAAA"}