sekkei-preview 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { spawn } from 'node:child_process';
+import { existsSync, symlinkSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveDocsDir } from './resolve-docs-dir.js';
+import { generateIndexIfMissing } from './generate-index.js';
+import { generateVitePressConfig } from './generate-config.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageDir = resolve(__dirname, '..');
+function printUsage() {
+    console.log(`
+Usage: sekkei-preview [command] [options]
+
+Commands:
+  dev     Start dev server with hot-reload (default)
+  build   Build static site
+  serve   Serve built static site
+
+Options:
+  --docs <path>   Docs directory (default: auto-resolve)
+  --port <N>      Dev server port (default: 5173)
+  --edit          Enable WYSIWYG editing mode
+  --help          Show this help
+`);
+}
+function main() {
+    const { values, positionals } = parseArgs({
+        args: process.argv.slice(2),
+        options: {
+            docs: { type: 'string' },
+            port: { type: 'string' },
+            edit: { type: 'boolean', default: false },
+            help: { type: 'boolean', default: false },
+        },
+        allowPositionals: true,
+        strict: false,
+    });
+    if (values.help) {
+        printUsage();
+        process.exit(0);
+    }
+    const command = positionals[0] ?? 'dev';
+    if (!['dev', 'build', 'serve'].includes(command)) {
+        console.error(`Unknown command: ${command}`);
+        printUsage();
+        process.exit(1);
+    }
+    const port = values.port ? parseInt(values.port, 10) : 5173;
+    if (isNaN(port) || port < 1 || port > 65535) {
+        console.error('Error: --port must be a number between 1 and 65535');
+        process.exit(1);
+    }
+    const edit = values.edit;
+    // Resolve docs directory
+    let docsDir;
+    try {
+        docsDir = resolveDocsDir(values.docs);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+    console.log(`Docs directory: ${docsDir}`);
+    // Generate index.md if missing
+    generateIndexIfMissing(docsDir);
+    // Generate VitePress config
+    generateVitePressConfig(docsDir, packageDir, {
+        edit,
+        port,
+    });
+    console.log(`VitePress config generated at ${docsDir}/.vitepress/config.mts`);
+    if (edit) {
+        console.log('Edit mode enabled — WYSIWYG editor available');
+    }
+    // Symlink package's node_modules into docs dir so VitePress can resolve deps
+    const pkgNodeModules = resolve(packageDir, 'node_modules');
+    const docsNodeModules = join(docsDir, 'node_modules');
+    if (!existsSync(docsNodeModules)) {
+        symlinkSync(pkgNodeModules, docsNodeModules, 'junction');
+    }
+    const env = { ...process.env };
+    if (edit) {
+        env.SEKKEI_EDIT = '1';
+    }
+    // Build VitePress args — run from docs dir (no srcDir argument needed)
+    const vpArgs = [command];
+    if (command === 'dev') {
+        vpArgs.push('--port', String(port));
+    }
+    // Resolve VitePress binary
+    const vitepressBin = resolve(packageDir, 'node_modules', '.bin', 'vitepress');
+    // Spawn VitePress process with CWD = docsDir
+    const child = spawn(vitepressBin, vpArgs, {
+        stdio: 'inherit',
+        env,
+        cwd: docsDir,
+    });
+    child.on('error', (err) => {
+        console.error(`Failed to start VitePress: ${err.message}`);
+        process.exit(1);
+    });
+    child.on('close', (code) => {
+        process.exit(code ?? 0);
+    });
+    // Forward SIGINT/SIGTERM to child
+    const signals = ['SIGINT', 'SIGTERM'];
+    for (const sig of signals) {
+        process.on(sig, () => {
+            child.kill(sig);
+        });
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/generate-config.d.ts

@@ -0,0 +1,22 @@
+export interface ConfigOptions {
+    edit: boolean;
+    port: number;
+    title?: string;
+}
+interface SidebarItem {
+    text: string;
+    link?: string;
+    collapsed?: boolean;
+    items?: SidebarItem[];
+}
+/**
+ * Build sidebar from docs directory structure.
+ * Sorts by numbered prefix (01-, 02-, etc.).
+ * Directories become collapsible groups.
+ */
+export declare function buildSidebar(docsDir: string, basePath?: string): SidebarItem[];
+/**
+ * Generate VitePress config.mts content and write to docsDir/.vitepress/.
+ */
+export declare function generateVitePressConfig(docsDir: string, packageDir: string, options: ConfigOptions): void;
+export {};

package/dist/generate-config.js

@@ -0,0 +1,138 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join, resolve, basename, extname } from 'node:path';
+/**
+ * Build sidebar from docs directory structure.
+ * Sorts by numbered prefix (01-, 02-, etc.).
+ * Directories become collapsible groups.
+ */
+export function buildSidebar(docsDir, basePath = '') {
+    const items = [];
+    const fullPath = join(docsDir, basePath);
+    if (!existsSync(fullPath))
+        return items;
+    const entries = readdirSync(fullPath, { withFileTypes: true })
+        .filter(e => {
+        const name = e.name;
+        if (name.startsWith('.') || name.startsWith('_'))
+            return false;
+        if (name === 'node_modules' || name === 'index.md')
+            return false;
+        return true;
+    })
+        .sort((a, b) => a.name.localeCompare(b.name, undefined, { numeric: true }));
+    for (const entry of entries) {
+        const relPath = basePath ? `${basePath}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            const children = buildSidebar(docsDir, relPath);
+            if (children.length > 0) {
+                items.push({
+                    text: formatDisplayName(entry.name),
+                    collapsed: false,
+                    items: children,
+                });
+            }
+        }
+        else if (entry.isFile() && extname(entry.name) === '.md') {
+            const title = extractTitle(join(docsDir, relPath));
+            const link = '/' + relPath.replace(/\.md$/, '');
+            items.push({ text: title, link });
+        }
+    }
+    return items;
+}
+/**
+ * Strip numbered prefix and format as display name.
+ * "01-overview" → "Overview", "05-features" → "Features"
+ */
+function formatDisplayName(name) {
+    const stripped = name.replace(/^\d+-/, '');
+    return stripped
+        .split(/[-_]/)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+/**
+ * Extract title from markdown: YAML frontmatter title or first H1.
+ */
+function extractTitle(filePath) {
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const lines = raw.split('\n');
+        // Check YAML frontmatter
+        if (lines[0]?.trim() === '---') {
+            for (let i = 1; i < Math.min(lines.length, 20); i++) {
+                if (lines[i]?.trim() === '---')
+                    break;
+                const match = lines[i]?.match(/^title:\s*["']?(.+?)["']?\s*$/);
+                if (match)
+                    return match[1];
+            }
+        }
+        // Check first H1
+        for (const line of lines.slice(0, 30)) {
+            const h1 = line.match(/^#\s+(.+)/);
+            if (h1)
+                return h1[1];
+        }
+    }
+    catch {
+        // ignore read errors
+    }
+    // Fallback: format filename
+    return formatDisplayName(basename(filePath, '.md'));
+}
+/**
+ * Generate VitePress config.mts content and write to docsDir/.vitepress/.
+ */
+export function generateVitePressConfig(docsDir, packageDir, options) {
+    const sidebar = buildSidebar(docsDir);
+    const sidebarJson = JSON.stringify(sidebar, null, 2);
+    const themePath = resolve(packageDir, 'theme').replace(/\\/g, '/');
+    const pluginPath = resolve(packageDir, 'plugins', 'file-api-plugin.ts').replace(/\\/g, '/');
+    const pluginImport = options.edit
+        ? `import { sekkeiFileApiPlugin } from '${pluginPath}'`
+        : '';
+    const nodeModulesPath = resolve(packageDir, 'node_modules').replace(/\\/g, '/');
+    const pluginsList = [];
+    if (options.edit) {
+        pluginsList.push(`sekkeiFileApiPlugin('${docsDir.replace(/\\/g, '/')}')`);
+    }
+    const editModeConfig = options.edit ? `\n    editMode: true,` : '';
+    const config = `import path from 'node:path'
+${pluginImport}
+
+export default {
+  title: ${JSON.stringify(options.title ?? 'Sekkei Docs')},
+  description: 'Japanese specification documents',
+  themeConfig: {
+    sidebar: ${sidebarJson},
+    outline: { level: [2, 3] },
+    search: { provider: 'local' },${editModeConfig}
+  },
+  vite: {
+    resolve: {
+      alias: {
+        'vitepress/theme': path.join('${nodeModulesPath}', 'vitepress', 'dist', 'client', 'theme-default', 'index.js'),
+      },
+    },
+    server: {
+      fs: { allow: ['${packageDir.replace(/\\/g, '/')}', '${docsDir.replace(/\\/g, '/')}'] },
+    },
+    optimizeDeps: {
+      entries: [],
+    },${pluginsList.length > 0 ? `\n    plugins: [${pluginsList.join(', ')}],` : ''}
+  },
+}
+`;
+    const vpDir = join(docsDir, '.vitepress');
+    if (!existsSync(vpDir))
+        mkdirSync(vpDir, { recursive: true });
+    writeFileSync(join(vpDir, 'config.mts'), config, 'utf8');
+    // Write theme re-export so VitePress picks up the custom theme
+    const themeIndex = `export { default } from '${themePath}/index.ts'\n`;
+    const themeDir = join(vpDir, 'theme');
+    if (!existsSync(themeDir))
+        mkdirSync(themeDir, { recursive: true });
+    writeFileSync(join(themeDir, 'index.ts'), themeIndex, 'utf8');
+}
+//# sourceMappingURL=generate-config.js.map

package/dist/generate-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-config.js","sourceRoot":"","sources":["../src/generate-config.ts"],"names":[],"mappings":"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"}

package/dist/generate-index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate index.md if missing in docs dir.
+ * Uses _index.yaml for structure or falls back to minimal homepage.
+ */
+export declare function generateIndexIfMissing(docsDir: string): void;

package/dist/generate-index.js

@@ -0,0 +1,74 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * Generate index.md if missing in docs dir.
+ * Uses _index.yaml for structure or falls back to minimal homepage.
+ */
+export function generateIndexIfMissing(docsDir) {
+    const indexPath = join(docsDir, 'index.md');
+    if (existsSync(indexPath))
+        return;
+    const indexYamlPath = join(docsDir, '_index.yaml');
+    let content;
+    if (existsSync(indexYamlPath)) {
+        content = generateFromIndexYaml(indexYamlPath);
+    }
+    else {
+        content = generateMinimalIndex(docsDir);
+    }
+    writeFileSync(indexPath, content, 'utf8');
+}
+function generateFromIndexYaml(yamlPath) {
+    const raw = readFileSync(yamlPath, 'utf8');
+    const manifest = parseYaml(raw);
+    const title = manifest?.title ?? 'Sekkei Documentation';
+    const desc = manifest?.description ?? '';
+    const lines = [
+        '---',
+        'layout: home',
+        '---',
+        '',
+        `# ${title}`,
+        '',
+    ];
+    if (desc)
+        lines.push(desc, '');
+    if (manifest?.sections?.length) {
+        lines.push('## Documents', '');
+        for (const section of manifest.sections) {
+            const link = section.path.replace(/\.md$/, '');
+            lines.push(`- [${section.title}](/${link})${section.description ? ` — ${section.description}` : ''}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function generateMinimalIndex(docsDir) {
+    // Try to get project name from sekkei.config.yaml
+    let projectName = 'Sekkei Documentation';
+    const configPath = join(process.cwd(), 'sekkei.config.yaml');
+    if (existsSync(configPath)) {
+        try {
+            const raw = readFileSync(configPath, 'utf8');
+            const config = parseYaml(raw);
+            if (config?.project?.name) {
+                projectName = config.project.name;
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return [
+        '---',
+        'layout: home',
+        '---',
+        '',
+        `# ${projectName}`,
+        '',
+        `Documentation generated by [Sekkei](https://github.com/bienhoang/sekkei).`,
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=generate-index.js.map

package/dist/generate-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-index.js","sourceRoot":"","sources":["../src/generate-index.ts"],"names":[],"mappings":"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"}

package/dist/resolve-docs-dir.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve docs directory with priority:
+ * 1. --docs CLI flag
+ * 2. ./sekkei-docs/ in CWD
+ * 3. sekkei.config.yaml → output.directory
+ * 4. Error
+ */
+export declare function resolveDocsDir(cliDocsFlag?: string): string;

package/dist/resolve-docs-dir.js

@@ -0,0 +1,46 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * Resolve docs directory with priority:
+ * 1. --docs CLI flag
+ * 2. ./sekkei-docs/ in CWD
+ * 3. sekkei.config.yaml → output.directory
+ * 4. Error
+ */
+export function resolveDocsDir(cliDocsFlag) {
+    const cwd = process.cwd();
+    // Priority 1: CLI flag
+    if (cliDocsFlag) {
+        const abs = resolve(cwd, cliDocsFlag);
+        if (!existsSync(abs)) {
+            throw new Error(`Docs directory not found: ${abs}`);
+        }
+        return abs;
+    }
+    // Priority 2: ./sekkei-docs/ convention
+    const conventionDir = join(cwd, 'sekkei-docs');
+    if (existsSync(conventionDir)) {
+        return conventionDir;
+    }
+    // Priority 3: sekkei.config.yaml
+    const configPath = join(cwd, 'sekkei.config.yaml');
+    if (existsSync(configPath)) {
+        try {
+            const raw = readFileSync(configPath, 'utf8');
+            const config = parseYaml(raw);
+            const outputDir = config?.output?.directory;
+            if (outputDir) {
+                const abs = resolve(cwd, outputDir);
+                if (existsSync(abs)) {
+                    return abs;
+                }
+            }
+        }
+        catch {
+            // Config parse failed — fall through
+        }
+    }
+    throw new Error('No docs directory found. Use --docs <path>, create ./sekkei-docs/, or set output.directory in sekkei.config.yaml');
+}
+//# sourceMappingURL=resolve-docs-dir.js.map

package/dist/resolve-docs-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-docs-dir.js","sourceRoot":"","sources":["../src/resolve-docs-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,WAAoB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,uBAAuB;IACvB,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,wCAAwC;IACxC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,iCAAiC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACnD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAwC,CAAC;YACrE,MAAM,SAAS,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;YAC5C,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACpC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpB,OAAO,GAAG,CAAC;gBACb,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,kHAAkH,CACnH,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "sekkei-preview",
+  "version": "0.1.0",
+  "description": "VitePress-based preview + WYSIWYG editor for Sekkei specification documents",
+  "type": "module",
+  "bin": {
+    "sekkei-preview": "./dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "files": [
+    "dist/",
+    "theme/",
+    "plugins/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "vitepress": "^1.6.4",
+    "vue": "^3.5.0",
+    "yaml": "^2.7.0",
+    "@milkdown/kit": "^7.18.0",
+    "@milkdown/vue": "^7.18.0",
+    "@milkdown/theme-nord": "^7.18.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.13.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "sekkei",
+    "vitepress",
+    "preview",
+    "wysiwyg",
+    "milkdown",
+    "japanese",
+    "specification"
+  ],
+  "license": "MIT"
+}