prev-cli 0.8.0 → 0.9.0

package/dist/cli.js

@@ -136,14 +136,30 @@ function fileToRoute(file) {
   }
   return "/" + withoutExt;
 }
-async function scanPages(rootDir) {
-  const files = await fg.glob("**/*.{md,mdx}", {
+async function scanPages(rootDir, options = {}) {
+  const { include = [] } = options;
+  const includeDirs = include.map((dir) => dir.startsWith(".") ? dir : `.${dir}`);
+  const patterns = ["**/*.{md,mdx}"];
+  for (const dir of includeDirs) {
+    patterns.push(`${dir}/**/*.{md,mdx}`);
+  }
+  const ignore = ["node_modules/**", "dist/**", ".cache/**"];
+  const files = await fg.glob(patterns, {
     cwd: rootDir,
-    ignore: ["node_modules/**", "dist/**", ".cache/**", ".*/**"],
-    dot: false
+    ignore,
+    dot: true
+  });
+  const filteredFiles = files.filter((file) => {
+    const parts = file.split("/");
+    for (const part of parts) {
+      if (part.startsWith(".") && part !== ".") {
+        return includeDirs.some((dir) => file.startsWith(dir.slice(1)) || file.startsWith(dir));
+      }
+    }
+    return true;
   });
   const routeMap = new Map;
-  for (const file of files) {
+  for (const file of filteredFiles) {
     const route = fileToRoute(file);
     const basename = path2.basename(file, path2.extname(file)).toLowerCase();
     const priority = basename === "index" ? 1 : basename === "readme" ? 2 : 0;
@@ -222,7 +238,8 @@ function buildSidebarTree(pages) {
 // src/vite/plugins/pages-plugin.ts
 var VIRTUAL_MODULE_ID = "virtual:prev-pages";
 var RESOLVED_VIRTUAL_MODULE_ID = "\x00" + VIRTUAL_MODULE_ID;
-function pagesPlugin(rootDir) {
+function pagesPlugin(rootDir, options = {}) {
+  const { include } = options;
   return {
     name: "prev-pages",
     resolveId(id) {
@@ -232,7 +249,7 @@ function pagesPlugin(rootDir) {
     },
     async load(id) {
       if (id === RESOLVED_VIRTUAL_MODULE_ID) {
-        const pages = await scanPages(rootDir);
+        const pages = await scanPages(rootDir, { include });
         const sidebar = buildSidebarTree(pages);
         return `
           export const pages = ${JSON.stringify(pages)};
@@ -439,7 +456,7 @@ var cliRoot2 = findCliRoot2();
 var cliNodeModules = findNodeModules(cliRoot2);
 var srcRoot2 = path4.join(cliRoot2, "src");
 async function createViteConfig(options) {
-  const { rootDir, mode, port } = options;
+  const { rootDir, mode, port, include } = options;
   const cacheDir = await ensureCacheDir(rootDir);
   return {
     root: rootDir,
@@ -453,7 +470,7 @@ async function createViteConfig(options) {
         rehypePlugins: [rehypeHighlight]
       }),
       react(),
-      pagesPlugin(rootDir),
+      pagesPlugin(rootDir, { include }),
       entryPlugin(rootDir)
     ],
     resolve: {
@@ -568,7 +585,8 @@ async function startDev(rootDir, options = {}) {
   const config = await createViteConfig({
     rootDir,
     mode: "development",
-    port
+    port,
+    include: options.include
   });
   const server = await createServer2(config);
   await server.listen();
@@ -577,14 +595,15 @@ async function startDev(rootDir, options = {}) {
   printReady();
   return server;
 }
-async function buildSite(rootDir) {
+async function buildSite(rootDir, options = {}) {
   console.log();
   console.log("  ✨ prev build");
   console.log();
   console.log("  Building your documentation site...");
   const config = await createViteConfig({
     rootDir,
-    mode: "production"
+    mode: "production",
+    include: options.include
   });
   await build(config);
   console.log();
@@ -597,7 +616,8 @@ async function previewSite(rootDir, options = {}) {
   const config = await createViteConfig({
     rootDir,
     mode: "production",
-    port
+    port,
+    include: options.include
   });
   const server = await preview(config);
   printWelcome("preview");
@@ -615,6 +635,7 @@ var { values, positionals } = parseArgs({
     port: { type: "string", short: "p" },
     days: { type: "string", short: "d" },
     cwd: { type: "string", short: "c" },
+    include: { type: "string", short: "i", multiple: true },
     help: { type: "boolean", short: "h" }
   },
   allowPositionals: true
@@ -635,17 +656,19 @@ Commands:
   clean     Remove old cache directories
 
 Options:
-  -c, --cwd <path>    Set working directory
-  -p, --port <port>   Specify port (dev/preview)
-  -d, --days <days>   Cache age threshold for clean (default: 30)
-  -h, --help          Show this help message
+  -c, --cwd <path>       Set working directory
+  -p, --port <port>      Specify port (dev/preview)
+  -i, --include <dir>    Include dot-prefixed directory (can use multiple times)
+  -d, --days <days>      Cache age threshold for clean (default: 30)
+  -h, --help             Show this help message
 
 Examples:
-  prev                Start dev server on random port
-  prev dev -p 3000    Start dev server on port 3000
-  prev build          Build static site to ./dist
-  prev clean          Remove caches older than 30 days
-  prev clean -d 7     Remove caches older than 7 days
+  prev                       Start dev server on random port
+  prev dev -p 3000           Start dev server on port 3000
+  prev build                 Build static site to ./dist
+  prev dev -i .c3            Include .c3 directory in docs
+  prev dev -i .c3 -i .notes  Include multiple dot directories
+  prev clean -d 7            Remove caches older than 7 days
 `);
 }
 async function main() {
@@ -655,16 +678,17 @@ async function main() {
   }
   const port = values.port ? parseInt(values.port, 10) : undefined;
   const days = values.days ? parseInt(values.days, 10) : 30;
+  const include = values.include || [];
   try {
     switch (command) {
       case "dev":
-        await startDev(rootDir, { port });
+        await startDev(rootDir, { port, include });
         break;
       case "build":
-        await buildSite(rootDir);
+        await buildSite(rootDir, { include });
         break;
       case "preview":
-        await previewSite(rootDir, { port });
+        await previewSite(rootDir, { port, include });
         break;
       case "clean":
         const removed = await cleanCache({ maxAgeDays: days });

package/dist/vite/config.d.ts

@@ -3,5 +3,6 @@ export interface ConfigOptions {
     rootDir: string;
     mode: 'development' | 'production';
     port?: number;
+    include?: string[];
 }
 export declare function createViteConfig(options: ConfigOptions): Promise<InlineConfig>;

package/dist/vite/pages.d.ts

@@ -23,5 +23,8 @@ export declare function parseFrontmatter(content: string): {
     content: string;
 };
 export declare function fileToRoute(file: string): string;
-export declare function scanPages(rootDir: string): Promise<Page[]>;
+export interface ScanOptions {
+    include?: string[];
+}
+export declare function scanPages(rootDir: string, options?: ScanOptions): Promise<Page[]>;
 export declare function buildSidebarTree(pages: Page[]): SidebarItem[];

package/dist/vite/plugins/pages-plugin.d.ts

@@ -1,2 +1,5 @@
 import type { Plugin } from 'vite';
-export declare function pagesPlugin(rootDir: string): Plugin;
+export interface PagesPluginOptions {
+    include?: string[];
+}
+export declare function pagesPlugin(rootDir: string, options?: PagesPluginOptions): Plugin;

package/dist/vite/start.d.ts

@@ -1,6 +1,10 @@
 export interface DevOptions {
     port?: number;
+    include?: string[];
+}
+export interface BuildOptions {
+    include?: string[];
 }
 export declare function startDev(rootDir: string, options?: DevOptions): Promise<import("vite").ViteDevServer>;
-export declare function buildSite(rootDir: string): Promise<void>;
+export declare function buildSite(rootDir: string, options?: BuildOptions): Promise<void>;
 export declare function previewSite(rootDir: string, options?: DevOptions): Promise<import("vite").PreviewServer>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prev-cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Transform MDX directories into beautiful documentation websites",
   "type": "module",
   "license": "MIT",