Dev 0.8.5

.github/workflows/npm-publish.yml

@@ -1,4 +1,4 @@
-name: docmd Release to NPM
+name: Release docmd to NPM
 
 on:
   release:
@@ -11,7 +11,7 @@ permissions:
   packages: write
 
 # ---------------------------------------------------------------------------
-# Job 1 — Build Rust native binaries (matrix, one runner per platform)
+# Job 1: Build Rust native binaries (matrix, one runner per platform)
 #
 # Each runner compiles the napi-rs addon for its target, then uploads the
 # resulting .node file as a workflow artifact. The publish job downloads
@@ -99,7 +99,7 @@ jobs:
           if-no-files-found: error
 
   # ---------------------------------------------------------------------------
-  # Job 2 — Publish all packages to npm
+  # Job 2: Publish all packages to npm
   #
   # Runs after all matrix builds succeed. Downloads every .node artifact into
   # rust-binaries/bin/ so the package contains the binaries when npm publish runs.

.gitignore

@@ -35,4 +35,5 @@ packages/engines/rust/bin/*.node
 packages/engines/rust-binaries/native/target/
 
 # Docmd Cache
-.docmd/
+.docmd/
+.docmd-search/

README.de.md

@@ -125,7 +125,7 @@ Hält Ihr Projekt einfach.
 my-docs/
 ├── docs/
 ├── assets/
-├── docmd.config.js (optional)
+├── docmd.config.json (optional)
 └── package.json
 ```
 
@@ -139,7 +139,7 @@ Ein browserbasierter Editor zum sofortigen Schreiben und Vorschauen von Dokument
 
 Für den Anfang ist keine Konfiguration erforderlich.
 
-Fügen Sie eine Konfigurationsdatei (`docmd.config.js` im Projektwurzelverzeichnis) nur hinzu, wenn Sie mehr Kontrolle benötigen.
+Fügen Sie eine Konfigurationsdatei (`docmd.config.json` im Projektwurzelverzeichnis) nur hinzu, wenn Sie mehr Kontrolle benötigen.
 
 ```js
 const { defineConfig } = require('@docmd/core');
@@ -185,7 +185,7 @@ Verwendung in Skripten oder CI-Pipelines:
 ```js
 const { build, buildLive } = require('@docmd/core');
 
-await build('./docmd.config.js', { isDev: false });
+await build('./docmd.config.json', { isDev: false });
 await buildLive();
 ```
 

README.es.md

@@ -125,7 +125,7 @@ Mantiene tu proyecto simple.
 my-docs/
 ├── docs/
 ├── assets/
-├── docmd.config.js (opcional)
+├── docmd.config.json (opcional)
 └── package.json
 ```
 
@@ -139,7 +139,7 @@ Un editor basado en navegador para escribir y previsualizar documentos al instan
 
 No se requiere configuración para empezar.
 
-Añade un archivo de configuración (`docmd.config.js` en la raíz del proyecto) solo cuando necesites más control.
+Añade un archivo de configuración (`docmd.config.json` en la raíz del proyecto) solo cuando necesites más control.
 
 ```js
 const { defineConfig } = require('@docmd/core');
@@ -185,7 +185,7 @@ Uso en scripts o flujos de CI:
 ```js
 const { build, buildLive } = require('@docmd/core');
 
-await build('./docmd.config.js', { isDev: false });
+await build('./docmd.config.json', { isDev: false });
 await buildLive();
 ```
 

README.fr.md

@@ -125,7 +125,7 @@ Garde votre projet simple.
 my-docs/
 ├── docs/
 ├── assets/
-├── docmd.config.js (optionnel)
+├── docmd.config.json (optionnel)
 └── package.json
 ```
 
@@ -139,7 +139,7 @@ Un éditeur par navigateur pour écrire et prévisualiser des documents instanta
 
 Aucune configuration n'est requise pour commencer.
 
-Ajoutez un fichier de configuration (`docmd.config.js` à la racine du projet) uniquement lorsque vous avez besoin de plus de contrôle.
+Ajoutez un fichier de configuration (`docmd.config.json` à la racine du projet) uniquement lorsque vous avez besoin de plus de contrôle.
 
 ```js
 const { defineConfig } = require('@docmd/core');
@@ -185,7 +185,7 @@ Utilisation dans des scripts ou des pipelines CI :
 ```js
 const { build, buildLive } = require('@docmd/core');
 
-await build('./docmd.config.js', { isDev: false });
+await build('./docmd.config.json', { isDev: false });
 await buildLive();
 ```
 

README.ja.md

@@ -125,7 +125,7 @@ docmd deploy  # Docker, Nginx, Caddyの設定を即座に生成
 my-docs/
 ├── docs/
 ├── assets/
-├── docmd.config.js (オプション)
+├── docmd.config.json (オプション)
 └── package.json
 ```
 
@@ -139,7 +139,7 @@ my-docs/
 
 開始にあたって設定は不要です。
 
-より詳細なコントロールが必要な場合のみ、プロジェクトのルートに設定ファイル (`docmd.config.js`) を追加してください。
+より詳細なコントロールが必要な場合のみ、プロジェクトのルートに設定ファイル (`docmd.config.json`) を追加してください。
 
 ```js
 const { defineConfig } = require('@docmd/core');
@@ -185,7 +185,7 @@ module.exports = defineConfig({
 ```js
 const { build, buildLive } = require('@docmd/core');
 
-await build('./docmd.config.js', { isDev: false });
+await build('./docmd.config.json', { isDev: false });
 await buildLive();
 ```
 

README.md

@@ -129,7 +129,7 @@ Keeps your project simple.
 my-docs/
 ├── docs/
 ├── assets/
-├── docmd.config.js (optional)
+├── docmd.config.json (optional)
 └── package.json
 ```
 
@@ -143,7 +143,7 @@ A browser-based editor for writing and previewing docs instantly. No setup requi
 
 No configuration is required to get started.
 
-Add a config file (`docmd.config.js` in the project root) only when you need more control.
+Add a config file (`docmd.config.json` in the project root) only when you need more control.
 
 ```js
 const { defineConfig } = require('@docmd/core');
@@ -189,7 +189,7 @@ Use in scripts or CI pipelines:
 ```js
 const { build, buildLive } = require('@docmd/core');
 
-await build('./docmd.config.js', { isDev: false });
+await build('./docmd.config.json', { isDev: false });
 await buildLive();
 ```
 

README.zh.md

@@ -129,7 +129,7 @@ docmd deploy    # 瞬间生成 Docker/Nginx/Caddy 配置文件
 my-docs/
 ├── docs/
 ├── assets/
-├── docmd.config.js（可选）
+├── docmd.config.json（可选）
 └── package.json
 ```
 
@@ -143,7 +143,7 @@ my-docs/
 
 开始使用无需任何配置。
 
-仅在需要更多控制时，在项目根目录添加配置文件（`docmd.config.js`）。
+仅在需要更多控制时，在项目根目录添加配置文件（`docmd.config.json`）。
 
 ```js
 const { defineConfig } = require('@docmd/core');
@@ -189,7 +189,7 @@ module.exports = defineConfig({
 ```js
 const { build, buildLive } = require('@docmd/core');
 
-await build('./docmd.config.js', { isDev: false });
+await build('./docmd.config.json', { isDev: false });
 await buildLive();
 ```
 

package.json

@@ -1,12 +1,14 @@
 {
   "name": "@docmd/monorepo",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "private": true,
   "description": "The minimalist, zero-config documentation generator monorepo.",
   "scripts": {
     "dev": "pnpm docmd dev",
+    "live": "pnpm docmd-live",
     "build": "pnpm -r run build",
     "docmd": "node packages/core/dist/bin/docmd.js --cwd packages/_playground",
+    "docmd-live": "node packages/live/bin/docmd-live.js --cwd packages/_playground",
     "prep": "node scripts/prep.js",
     "verify": "node scripts/verify.js",
     "lint": "eslint .",
@@ -18,13 +20,14 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.9.0",
+    "@types/node": "^25.9.1",
     "chalk": "4.1.2",
+    "docmd-search": "0.1.0-alpha.0",
     "esbuild": "^0.28.0",
-    "eslint": "^10.4.0",
+    "eslint": "^10.4.1",
     "globals": "^17.6.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.59.4"
+    "typescript-eslint": "^8.60.0"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -36,6 +39,11 @@
     ],
     "overrides": {
       "mermaid>uuid": ">=14.0.0"
+    },
+    "peerDependencyRules": {
+      "ignoreMissing": [
+        "docmd-search"
+      ]
     }
   },
   "keywords": [

packages/_playground/docmd.config.json

@@ -41,7 +41,10 @@
   },
 
   "plugins": {
-    "search": {},
+    "search": {
+      "semantic": true,
+      "showConfidence": true
+    },
     "seo": {},
     "sitemap": {},
     "analytics": {

packages/_playground/docs-05/index.md

@@ -1 +1,34 @@
 # V0.5.0 Overview
+
+This is the documentation for version 0.5.0 of docmd. This version introduces several new features for developers.
+
+## Features
+
+- **Developer Tools**: Enhanced debugging capabilities
+- **Performance**: Faster build times for large documentation sites
+- **Search**: Improved keyword search with better relevance scoring
+- **Plugins**: New plugin API for extending functionality
+
+## Getting Started
+
+To get started with version 0.5.0, install the package:
+
+```bash
+npm install @docmd/core@0.5.0
+```
+
+## Developer Guide
+
+This version is designed with developers in mind. The new developer tools make it easier to debug and customize your documentation site.
+
+### Configuration
+
+Configure your site by creating a `docmd.config.js` file in your project root.
+
+### Building
+
+Run the build command to generate your documentation:
+
+```bash
+npx docmd build
+```

packages/_playground/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docmd/playground",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "private": true,
   "dependencies": {
     "@docmd/core": "workspace:*",

packages/api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docmd/api",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Plugin API surface for docmd.",
   "type": "module",
   "main": "dist/index.js",

packages/api/src/hooks.ts

@@ -84,7 +84,7 @@
   errors: string[];
 }
 
 function validateDescriptor(descriptor: any): ValidationResult {
   const errors: string[] = [];
 
   if (!descriptor || typeof descriptor !== 'object') {
@@ -127,12 +127,12 @@
 // Isolation wrapper (§2)
 // ---------------------------------------------------------------------------
 
 function safeCall<T>(hookName: string, pluginName: string, fn: (...args: any[]) => T, ...args: any[]): T | string | undefined {
   try {
     return fn(...args);
   } catch (err: any) {
     TUI.error(`Plugin "${pluginName}" threw in ${hookName}`, err.message);
     return (hookName === 'injectHead' || hookName === 'injectBody') ? '' as any : undefined;
   }
 }
 
@@ -177,9 +177,9 @@
 // ---------------------------------------------------------------------------
 
 // Load the official plugin registry
 let _pluginRegistry: Record<string, any> | null = null;
 
 function getPluginRegistry(): Record<string, any> {
   if (_pluginRegistry) return _pluginRegistry;
 
   try {
@@ -266,7 +266,7 @@
     execSync(installCmd, { stdio: 'pipe', cwd, timeout: 60000 });
     TUI.step(`Plugin installed: ${shortName}`, 'DONE');
     return true;
-  } catch (err: any) {
+  } catch (_err: any) {
     TUI.step(`Failed to install: ${shortName}`, 'FAIL');
     warnOnce(`install:${packageName}`, TUI.dim(`Run "docmd add ${shortName}" manually for details`));
     return false;
@@ -368,7 +368,7 @@
           const resolvedPath = require.resolve(name, { paths: resolvePaths });
           rawModule = await import(pathToFileURL(resolvedPath).href);
         }
-      } catch (e: any) {
+      } catch (_e: any) {
         if (name.startsWith('@docmd/plugin-')) {
           needsAutoInstall = true;
         } else {