@classic-homes/theme-docs 0.1.0 → 0.3.0

package/dist/lib/vite/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@classic-homes/theme-docs/vite` — regenerate docs content while you write.
+ *
+ * Runs your `generate` step (typically `loadDocs` → `renderDocs` → write JSON) when the
+ * dev server starts and whenever a file under `watch` changes, then reloads the page.
+ * Builds run it once before bundling, so the generated files are always current.
+ */
+import type { Plugin } from 'vite';
+export interface DocsContentPluginOptions {
+    /** Directories (or files) whose changes trigger `generate` */
+    watch: string | string[];
+    /** Produce the content the app imports. Throw to report a failure. */
+    generate: () => void | Promise<void>;
+    /** Wait this long after the last change before regenerating. Default: 200ms */
+    debounce?: number;
+}
+export declare function docsContent(options: DocsContentPluginOptions): Plugin;

package/dist/lib/vite/index.js

@@ -0,0 +1,38 @@
+/**
+ * `@classic-homes/theme-docs/vite` — regenerate docs content while you write.
+ *
+ * Runs your `generate` step (typically `loadDocs` → `renderDocs` → write JSON) when the
+ * dev server starts and whenever a file under `watch` changes, then reloads the page.
+ * Builds run it once before bundling, so the generated files are always current.
+ */
+import path from 'node:path';
+export function docsContent(options) {
+    const { generate, debounce = 200 } = options;
+    const watched = (Array.isArray(options.watch) ? options.watch : [options.watch]).map((p) => path.resolve(p));
+    const isWatched = (file) => watched.some((w) => file === w || file.startsWith(w + path.sep));
+    let timer;
+    return {
+        name: 'classic-theme-docs:content',
+        async buildStart() {
+            await generate();
+        },
+        configureServer(server) {
+            server.watcher.add(watched);
+            server.watcher.on('all', (_event, file) => {
+                if (!isWatched(path.resolve(file)))
+                    return;
+                clearTimeout(timer);
+                timer = setTimeout(async () => {
+                    try {
+                        await generate();
+                        server.config.logger.info('[docs] content regenerated', { timestamp: true });
+                        server.ws.send({ type: 'full-reload' });
+                    }
+                    catch (err) {
+                        server.config.logger.error(`[docs] content regeneration failed:\n${err.stack ?? err}`);
+                    }
+                }, debounce);
+            });
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/theme-docs",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Markdown documentation components for the Classic theme system",
   "type": "module",
   "main": "./dist/lib/index.js",
@@ -14,6 +14,36 @@
       "import": "./dist/lib/index.js",
       "default": "./dist/lib/index.js"
     },
+    "./parser": {
+      "types": "./dist/lib/parser/api.d.ts",
+      "import": "./dist/lib/parser/api.js",
+      "default": "./dist/lib/parser/api.js"
+    },
+    "./sanitize": {
+      "types": "./dist/lib/sanitize/index.d.ts",
+      "import": "./dist/lib/sanitize/index.js",
+      "default": "./dist/lib/sanitize/index.js"
+    },
+    "./content": {
+      "types": "./dist/lib/content/index.d.ts",
+      "import": "./dist/lib/content/index.js",
+      "default": "./dist/lib/content/index.js"
+    },
+    "./nav": {
+      "types": "./dist/lib/content/browser.d.ts",
+      "import": "./dist/lib/content/browser.js",
+      "default": "./dist/lib/content/browser.js"
+    },
+    "./search": {
+      "types": "./dist/lib/search/index.d.ts",
+      "import": "./dist/lib/search/index.js",
+      "default": "./dist/lib/search/index.js"
+    },
+    "./vite": {
+      "types": "./dist/lib/vite/index.d.ts",
+      "import": "./dist/lib/vite/index.js",
+      "default": "./dist/lib/vite/index.js"
+    },
     "./styles": "./dist/lib/styles/markdown.css"
   },
   "sideEffects": [
@@ -26,7 +56,9 @@
     "build": "svelte-package -i src",
     "dev": "svelte-package -i src --watch",
     "clean": "node ../../scripts/rm.mjs dist",
-    "typecheck": "svelte-check --tsconfig ./tsconfig.json"
+    "typecheck": "svelte-check --tsconfig ./tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "svelte",
@@ -44,12 +76,17 @@
     "access": "public"
   },
   "peerDependencies": {
+    "@classic-homes/theme-svelte": ">=1.16.0",
     "mermaid": "^11.0.0",
-    "svelte": "^5.0.0"
+    "svelte": "^5.0.0",
+    "vite": ">=5.0.0"
   },
   "peerDependenciesMeta": {
     "mermaid": {
       "optional": true
+    },
+    "vite": {
+      "optional": true
     }
   },
   "dependencies": {
@@ -57,15 +94,25 @@
     "clsx": "^2.1.0",
     "js-yaml": "^4.3.2",
     "marked": "^17.0.0",
+    "minisearch": "7.2.0",
+    "sanitize-html": "2.18.0",
     "shiki": "^1.0.0",
     "tailwind-merge": "^2.2.0",
     "tailwind-variants": "^0.3.0"
   },
   "devDependencies": {
+    "@classic-homes/theme-svelte": "*",
     "@sveltejs/package": "^2.3.0",
+    "@sveltejs/vite-plugin-svelte": "7.2.0",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/svelte": "5.4.2",
     "@types/js-yaml": "4.0.9",
+    "@types/sanitize-html": "2.16.2",
+    "jsdom": "28.1.0",
     "svelte": "^5.0.0",
     "svelte-check": "^4.0.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vite": "8.1.3",
+    "vitest": "4.1.11"
   }
 }