@wondocs/next-plugin 0.0.0 → 0.1.0-beta.1

package/dist/index.cjs

@@ -6,7 +6,32 @@ let _wondocs_core_build = require("@wondocs/core/build");
 let _wondocs_core_watch = require("@wondocs/core/watch");
 //#region src/plugin.ts
 const outDir = (0, node_path.join)(process.cwd(), ".wondocs");
+function toProjectRelative(absolutePath) {
+	return `./${(0, node_path.relative)(process.cwd(), absolutePath).split(node_path.sep).join("/")}`;
+}
 let watchHandle = null;
+/**
+* Creates a Next.js config wrapper that builds/watches WonDocs content and
+* wires the generated sidebar/pages modules into Turbopack's resolver.
+*
+* @param wonDocsConfig - WonDocs options (contents directory, MDX plugins, etc).
+* @returns A `withWonDocs` function to wrap your `NextConfig`.
+*
+* @example
+* ```ts
+* // next.config.ts
+* import type { NextConfig } from "next";
+* import { createWonDocs } from "@wondocs/next-plugin";
+*
+* const nextConfig: NextConfig = {
+*   reactCompiler: true,
+* };
+*
+* const withWonDocs = createWonDocs({ contentsDir: "docs/" });
+*
+* export default withWonDocs(nextConfig);
+* ```
+*/
 function createWonDocs(wonDocsConfig = {}) {
 	return function withWonDocs(nextConfig = {}) {
 		return async function(phase) {
@@ -23,8 +48,8 @@ function createWonDocs(wonDocsConfig = {}) {
 					...nextConfig.turbopack,
 					resolveAlias: {
 						...nextConfig.turbopack?.resolveAlias,
-						"#wondocs/sidebar": (0, node_path.join)(outDir, "sidebar.js"),
-						"#wondocs/pages": (0, node_path.join)(outDir, "pages.js")
+						"#wondocs/sidebar": toProjectRelative((0, node_path.join)(outDir, "sidebar.js")),
+						"#wondocs/pages": toProjectRelative((0, node_path.join)(outDir, "pages.js"))
 					}
 				}
 			};

package/dist/index.d.cts

@@ -1,6 +1,28 @@
 import { NextConfig } from "next";
 import { WonDocsConfig } from "@wondocs/core/config";
 //#region src/plugin.d.ts
+/**
+ * Creates a Next.js config wrapper that builds/watches WonDocs content and
+ * wires the generated sidebar/pages modules into Turbopack's resolver.
+ *
+ * @param wonDocsConfig - WonDocs options (contents directory, MDX plugins, etc).
+ * @returns A `withWonDocs` function to wrap your `NextConfig`.
+ *
+ * @example
+ * ```ts
+ * // next.config.ts
+ * import type { NextConfig } from "next";
+ * import { createWonDocs } from "@wondocs/next-plugin";
+ *
+ * const nextConfig: NextConfig = {
+ *   reactCompiler: true,
+ * };
+ *
+ * const withWonDocs = createWonDocs({ contentsDir: "docs/" });
+ *
+ * export default withWonDocs(nextConfig);
+ * ```
+ */
 declare function createWonDocs(wonDocsConfig?: WonDocsConfig): (nextConfig?: NextConfig) => (phase: string) => Promise<NextConfig>;
 //#endregion
 export { createWonDocs };

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;iBAegB,cAAc,gBAAe,iBACf,aAAY,gBAGf,kBAAgB,QAAQ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;iBA6CgB,cAAc,gBAAe,iBACf,aAAY,gBAGf,kBAAgB,QAAQ"}

package/dist/index.d.mts

@@ -1,6 +1,28 @@
 import { WonDocsConfig } from "@wondocs/core/config";
 import { NextConfig } from "next";
 //#region src/plugin.d.ts
+/**
+ * Creates a Next.js config wrapper that builds/watches WonDocs content and
+ * wires the generated sidebar/pages modules into Turbopack's resolver.
+ *
+ * @param wonDocsConfig - WonDocs options (contents directory, MDX plugins, etc).
+ * @returns A `withWonDocs` function to wrap your `NextConfig`.
+ *
+ * @example
+ * ```ts
+ * // next.config.ts
+ * import type { NextConfig } from "next";
+ * import { createWonDocs } from "@wondocs/next-plugin";
+ *
+ * const nextConfig: NextConfig = {
+ *   reactCompiler: true,
+ * };
+ *
+ * const withWonDocs = createWonDocs({ contentsDir: "docs/" });
+ *
+ * export default withWonDocs(nextConfig);
+ * ```
+ */
 declare function createWonDocs(wonDocsConfig?: WonDocsConfig): (nextConfig?: NextConfig) => (phase: string) => Promise<NextConfig>;
 //#endregion
 export { createWonDocs };

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;iBAegB,cAAc,gBAAe,iBACf,aAAY,gBAGf,kBAAgB,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;iBA6CgB,cAAc,gBAAe,iBACf,aAAY,gBAGf,kBAAgB,QAAQ"}

package/dist/index.mjs

@@ -1,11 +1,36 @@
-import { join } from "node:path";
+import { join, relative, sep } from "node:path";
 import { PHASE_DEVELOPMENT_SERVER, PHASE_PRODUCTION_BUILD } from "next/constants.js";
 import { loadConfig } from "@wondocs/core/config";
 import { buildDocs } from "@wondocs/core/build";
 import { watchDocs } from "@wondocs/core/watch";
 //#region src/plugin.ts
 const outDir = join(process.cwd(), ".wondocs");
+function toProjectRelative(absolutePath) {
+	return `./${relative(process.cwd(), absolutePath).split(sep).join("/")}`;
+}
 let watchHandle = null;
+/**
+* Creates a Next.js config wrapper that builds/watches WonDocs content and
+* wires the generated sidebar/pages modules into Turbopack's resolver.
+*
+* @param wonDocsConfig - WonDocs options (contents directory, MDX plugins, etc).
+* @returns A `withWonDocs` function to wrap your `NextConfig`.
+*
+* @example
+* ```ts
+* // next.config.ts
+* import type { NextConfig } from "next";
+* import { createWonDocs } from "@wondocs/next-plugin";
+*
+* const nextConfig: NextConfig = {
+*   reactCompiler: true,
+* };
+*
+* const withWonDocs = createWonDocs({ contentsDir: "docs/" });
+*
+* export default withWonDocs(nextConfig);
+* ```
+*/
 function createWonDocs(wonDocsConfig = {}) {
 	return function withWonDocs(nextConfig = {}) {
 		return async function(phase) {
@@ -22,8 +47,8 @@ function createWonDocs(wonDocsConfig = {}) {
 					...nextConfig.turbopack,
 					resolveAlias: {
 						...nextConfig.turbopack?.resolveAlias,
-						"#wondocs/sidebar": join(outDir, "sidebar.js"),
-						"#wondocs/pages": join(outDir, "pages.js")
+						"#wondocs/sidebar": toProjectRelative(join(outDir, "sidebar.js")),
+						"#wondocs/pages": toProjectRelative(join(outDir, "pages.js"))
 					}
 				}
 			};

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import { join } from \"node:path\";\nimport type { NextConfig } from \"next\";\nimport {\n  PHASE_DEVELOPMENT_SERVER,\n  PHASE_PRODUCTION_BUILD,\n} from \"next/constants\";\n\nimport { loadConfig, type WonDocsConfig } from \"@wondocs/core/config\";\nimport { buildDocs } from \"@wondocs/core/build\";\nimport { watchDocs } from \"@wondocs/core/watch\";\n\nconst outDir = join(process.cwd(), \".wondocs\");\n\nlet watchHandle: { close(): void } | null = null;\n\nexport function createWonDocs(wonDocsConfig: WonDocsConfig = {}) {\n  return function withWonDocs(nextConfig: NextConfig = {}) {\n    // Returns an async function because Turbopack has no plugin API to hook into\n    // individual compilations — scanning runs once when next.config is evaluated.\n    return async function (phase: string): Promise<NextConfig> {\n      const resolvedConfig = loadConfig(wonDocsConfig);\n      const shouldWatch =\n        phase === PHASE_DEVELOPMENT_SERVER || process.argv.includes(\"--watch\");\n      const shouldBuild = phase === PHASE_PRODUCTION_BUILD;\n\n      // next.config is also evaluated on `next start` (PHASE_PRODUCTION_SERVER) and other\n      // non-build phases — skip there so we don't re-scan/recompile docs (and re-write\n      // .wondocs/) on every server boot, which can also fail on read-only production filesystems.\n      if (shouldWatch) {\n        if (watchHandle) watchHandle.close();\n        watchHandle = await watchDocs(resolvedConfig);\n      } else if (shouldBuild) {\n        await buildDocs(resolvedConfig);\n      }\n\n      return {\n        ...nextConfig,\n        turbopack: {\n          ...nextConfig.turbopack,\n          resolveAlias: {\n            ...nextConfig.turbopack?.resolveAlias,\n            \"#wondocs/sidebar\": join(outDir, \"sidebar.js\"),\n            \"#wondocs/pages\": join(outDir, \"pages.js\"),\n          },\n        },\n      };\n    };\n  };\n}\n"],"mappings":";;;;;;AAWA,MAAM,SAAS,KAAK,QAAQ,IAAI,GAAG,UAAU;AAE7C,IAAI,cAAwC;AAE5C,SAAgB,cAAc,gBAA+B,CAAC,GAAG;CAC/D,OAAO,SAAS,YAAY,aAAyB,CAAC,GAAG;EAGvD,OAAO,eAAgB,OAAoC;GACzD,MAAM,iBAAiB,WAAW,aAAa;GAC/C,MAAM,cACJ,UAAU,4BAA4B,QAAQ,KAAK,SAAS,SAAS;GACvE,MAAM,cAAc,UAAU;GAK9B,IAAI,aAAa;IACf,IAAI,aAAa,YAAY,MAAM;IACnC,cAAc,MAAM,UAAU,cAAc;GAC9C,OAAO,IAAI,aACT,MAAM,UAAU,cAAc;GAGhC,OAAO;IACL,GAAG;IACH,WAAW;KACT,GAAG,WAAW;KACd,cAAc;MACZ,GAAG,WAAW,WAAW;MACzB,oBAAoB,KAAK,QAAQ,YAAY;MAC7C,kBAAkB,KAAK,QAAQ,UAAU;KAC3C;IACF;GACF;EACF;CACF;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import { join, relative, sep } from \"node:path\";\nimport type { NextConfig } from \"next\";\nimport {\n  PHASE_DEVELOPMENT_SERVER,\n  PHASE_PRODUCTION_BUILD,\n} from \"next/constants\";\n\nimport { loadConfig, type WonDocsConfig } from \"@wondocs/core/config\";\nimport { buildDocs } from \"@wondocs/core/build\";\nimport { watchDocs } from \"@wondocs/core/watch\";\n\nconst outDir = join(process.cwd(), \".wondocs\");\n\n// Turbopack's resolveAlias doesn't support absolute filesystem paths (\"server\n// relative imports are not implemented yet\") — it needs a project-relative\n// path, POSIX-separated, with an explicit \"./\" so it isn't treated as a bare\n// specifier.\nfunction toProjectRelative(absolutePath: string): string {\n  return `./${relative(process.cwd(), absolutePath).split(sep).join(\"/\")}`;\n}\n\nlet watchHandle: { close(): void } | null = null;\n\n/**\n * Creates a Next.js config wrapper that builds/watches WonDocs content and\n * wires the generated sidebar/pages modules into Turbopack's resolver.\n *\n * @param wonDocsConfig - WonDocs options (contents directory, MDX plugins, etc).\n * @returns A `withWonDocs` function to wrap your `NextConfig`.\n *\n * @example\n * ```ts\n * // next.config.ts\n * import type { NextConfig } from \"next\";\n * import { createWonDocs } from \"@wondocs/next-plugin\";\n *\n * const nextConfig: NextConfig = {\n *   reactCompiler: true,\n * };\n *\n * const withWonDocs = createWonDocs({ contentsDir: \"docs/\" });\n *\n * export default withWonDocs(nextConfig);\n * ```\n */\nexport function createWonDocs(wonDocsConfig: WonDocsConfig = {}) {\n  return function withWonDocs(nextConfig: NextConfig = {}) {\n    // Returns an async function because Turbopack has no plugin API to hook into\n    // individual compilations — scanning runs once when next.config is evaluated.\n    return async function (phase: string): Promise<NextConfig> {\n      const resolvedConfig = loadConfig(wonDocsConfig);\n      const shouldWatch =\n        phase === PHASE_DEVELOPMENT_SERVER || process.argv.includes(\"--watch\");\n      const shouldBuild = phase === PHASE_PRODUCTION_BUILD;\n\n      // next.config is also evaluated on `next start` (PHASE_PRODUCTION_SERVER) and other\n      // non-build phases — skip there so we don't re-scan/recompile docs (and re-write\n      // .wondocs/) on every server boot, which can also fail on read-only production filesystems.\n      if (shouldWatch) {\n        if (watchHandle) watchHandle.close();\n        watchHandle = await watchDocs(resolvedConfig);\n      } else if (shouldBuild) {\n        await buildDocs(resolvedConfig);\n      }\n\n      return {\n        ...nextConfig,\n        turbopack: {\n          ...nextConfig.turbopack,\n          resolveAlias: {\n            ...nextConfig.turbopack?.resolveAlias,\n            \"#wondocs/sidebar\": toProjectRelative(join(outDir, \"sidebar.js\")),\n            \"#wondocs/pages\": toProjectRelative(join(outDir, \"pages.js\")),\n          },\n        },\n      };\n    };\n  };\n}\n"],"mappings":";;;;;;AAWA,MAAM,SAAS,KAAK,QAAQ,IAAI,GAAG,UAAU;AAM7C,SAAS,kBAAkB,cAA8B;CACvD,OAAO,KAAK,SAAS,QAAQ,IAAI,GAAG,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG;AACvE;AAEA,IAAI,cAAwC;;;;;;;;;;;;;;;;;;;;;;;AAwB5C,SAAgB,cAAc,gBAA+B,CAAC,GAAG;CAC/D,OAAO,SAAS,YAAY,aAAyB,CAAC,GAAG;EAGvD,OAAO,eAAgB,OAAoC;GACzD,MAAM,iBAAiB,WAAW,aAAa;GAC/C,MAAM,cACJ,UAAU,4BAA4B,QAAQ,KAAK,SAAS,SAAS;GACvE,MAAM,cAAc,UAAU;GAK9B,IAAI,aAAa;IACf,IAAI,aAAa,YAAY,MAAM;IACnC,cAAc,MAAM,UAAU,cAAc;GAC9C,OAAO,IAAI,aACT,MAAM,UAAU,cAAc;GAGhC,OAAO;IACL,GAAG;IACH,WAAW;KACT,GAAG,WAAW;KACd,cAAc;MACZ,GAAG,WAAW,WAAW;MACzB,oBAAoB,kBAAkB,KAAK,QAAQ,YAAY,CAAC;MAChE,kBAAkB,kBAAkB,KAAK,QAAQ,UAAU,CAAC;KAC9D;IACF;GACF;EACF;CACF;AACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wondocs/next-plugin",
   "description": "WonDocs Next.js Plugin - A plugin for integrating WonDocs with Next.js applications.",
-  "version": "0.0.0",
+  "version": "0.1.0-beta.1",
   "private": false,
   "type": "module",
   "keywords": [
@@ -35,20 +35,20 @@
       "default": "./dist/index.mjs"
     }
   },
-  "scripts": {
-    "prebuild": "rm -rf dist",
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "lint": "eslint .",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
-    "@wondocs/core": "workspace:*"
+    "@wondocs/core": "0.1.0-beta.1"
   },
   "peerDependencies": {
     "next": ">=16.0.0"
   },
   "devDependencies": {
-    "next": "^16.2.11"
+    "next": "^16.3.0"
+  },
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit"
   }
-}
+}