@opendocsdev/cli 0.2.0 → 0.2.2

package/README.md

@@ -1,6 +1,6 @@
 # opendocs
 
-[![npm version](https://img.shields.io/npm/v/opendocs.svg)](https://www.npmjs.com/package/opendocs)
+[![npm version](https://img.shields.io/npm/v/@opendocsdev/cli.svg)](https://www.npmjs.com/package/@opendocsdev/cli)
 [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://github.com/chigala/opendocs/blob/main/LICENSE)
 
 Beautiful docs with zero config. An open-source alternative to [Mintlify](https://mintlify.com).
@@ -10,13 +10,13 @@ Write documentation in MDX, get built-in search, syntax highlighting, theming, a
 ## Installation
 
 ```bash
-npm install -g opendocs
+npm install -g @opendocsdev/cli
 ```
 
 Or use directly with npx:
 
 ```bash
-npx opendocs init my-docs
+npx @opendocsdev/cli init my-docs
 ```
 
 ## Commands
@@ -191,15 +191,15 @@ Tabbed code blocks for showing the same example in multiple languages:
 ````mdx
 <CodeGroup>
 ```bash npm
-npm install opendocs
+npm install @opendocsdev/cli
 ```
 
 ```bash pnpm
-pnpm add opendocs
+pnpm add @opendocsdev/cli
 ```
 
 ```bash yarn
-yarn add opendocs
+yarn add @opendocsdev/cli
 ```
 </CodeGroup>
 ````
@@ -223,7 +223,7 @@ yarn add opendocs
 <Steps>
   ### Install the CLI
 
-  Run `npm install -g opendocs`.
+  Run `npm install -g @opendocsdev/cli`.
 
   ### Create a project
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendocsdev/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "publishConfig": {
     "access": "public"
   },

package/src/engine/src/lib/mdx-loader.ts

@@ -50,6 +50,7 @@ function getSnippetFolders(): string[] {
 }
 
 const snippetFolders = getSnippetFolders();
+const projectDir = import.meta.env.OPENDOCS_PROJECT_DIR || "";
 
 // Get all MDX files from user's content directory
 // This glob pattern is resolved at build time via the @content Vite alias
@@ -71,7 +72,7 @@ function isSnippetPath(path: string): boolean {
  * Uses default snippet folders from environment
  */
 function extractSlugFromPath(globPath: string): string | null {
-  return extractSlugFromPathUtil(globPath, snippetFolders);
+  return extractSlugFromPathUtil(globPath, snippetFolders, projectDir);
 }
 
 /**

package/src/engine/src/lib/mdx-utils.ts

@@ -19,7 +19,8 @@ export function isSnippetPath(path: string, folders: string[]): boolean {
  */
 export function extractSlugFromPath(
   globPath: string,
-  folders: string[]
+  folders: string[],
+  projectDir?: string
 ): string | null {
   // Remove @content/ prefix if present
   if (globPath.startsWith("@content/")) {
@@ -36,11 +37,25 @@ export function extractSlugFromPath(
     return null;
   }
 
-  // Handle relative paths from Vite glob
+  // Use project directory name to find the content root in the path
+  // This handles both local dev (short relative paths) and npm global install (long relative paths)
+  if (projectDir) {
+    const projectDirName = projectDir.replace(/\/$/, "").split("/").pop();
+    if (projectDirName) {
+      const marker = `/${projectDirName}/`;
+      const idx = globPath.lastIndexOf(marker);
+      if (idx !== -1) {
+        const contentPath = globPath.substring(idx + marker.length);
+        if (isSnippetPath(contentPath, folders)) {
+          return null;
+        }
+        return contentPath.replace(/\.mdx?$/, "");
+      }
+    }
+  }
+
+  // Fallback: Handle relative paths from Vite glob
   // e.g., "../../../../test-docs/guides/using-snippets.mdx" -> "guides/using-snippets"
-  // e.g., "../../../../test-docs/components.mdx" -> "components"
-  // Find the project directory boundary (last ../ followed by project-dir/)
-  // The pattern matches all the "../" parts, then project-dir/, then captures the slug
   const relativeMatch = globPath.match(/(?:\.\.\/)+[^/]+\/(.+)\.mdx?$/);
   if (relativeMatch) {
     return relativeMatch[1];
@@ -60,10 +75,10 @@ export function extractSlugFromPath(
  * Filter paths and return valid slugs (excludes snippet folders)
  * Used for testing purposes
  */
-export function filterPathsToSlugs(paths: string[], folders: string[]): string[] {
+export function filterPathsToSlugs(paths: string[], folders: string[], projectDir?: string): string[] {
   const slugs: string[] = [];
   for (const path of paths) {
-    const slug = extractSlugFromPath(path, folders);
+    const slug = extractSlugFromPath(path, folders, projectDir);
     if (slug !== null && !slugs.includes(slug)) {
       slugs.push(slug);
     }