cudoc-nextra 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cudoment
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# cudoc-nextra
+
+Connect cudoc to Nextra while retaining native heading IDs and TOC behavior.
+
+ESM · Node.js 20+
+
+```sh
+npm install @cudoment/cudoc cudoc-remark cudoc-nextra
+```
+
+```js
+import { cudocRemarkPlugins } from "cudoc-nextra"
+
+// In the Nextra configuration:
+const mdxOptions = {
+  format: "detect",
+  remarkPlugins: cudocRemarkPlugins({
+    syntax: { headingAnchor: "both", callout: "both" },
+  }),
+}
+```
+
+Keep the existing Nextra theme mappings and import `@cudoment/cudoc/styles.css` once. The explicit `syntax` setup needs no cudoc components. Nextra owns its TOC. For embedding, collect through the actual Nextra compiler, prepare embeds, and add `cudoc-remark/embed` to rendering.
+
+Choose `host`, `cudoc` or `both` independently for `headingAnchor`, `badge`, `tableCellList`, `callout` and `link`. The representative callout is `> [!NOTE] Title`. Authors do not register cudoc React components in the recommended setup. Syntax-only rendering needs no stored JSON; cross-document embedding requires document collection.
+
+- [Usage guide](https://github.com/cudoment/cudoc/tree/main/docs/nextra.md) · [한국어 가이드](https://github.com/cudoment/cudoc/tree/main/docs/nextra.ko.md)
+- [Markdown syntax](https://github.com/cudoment/cudoc/tree/main/docs/syntax.md)
+- [Embedding](https://github.com/cudoment/cudoc/tree/main/docs/embedding.md)
+- [Standalone HTML alongside a host](https://github.com/cudoment/cudoc/tree/main/docs/html.md#export-alongside-an-existing-site)
+- [API reference](https://github.com/cudoment/cudoc/tree/main/docs/api-reference/README.md)
+- [Runnable examples](https://github.com/cudoment/cudoc/tree/main/examples/README.md)

package/dist/components.d.ts

@@ -0,0 +1,2 @@
+export * from "cudoc-remark/components";
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAA"}

package/dist/components.js

@@ -0,0 +1,3 @@
+// Re-export the shared implementations with generated type declarations.
+export * from "cudoc-remark/components";
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,cAAc,yBAAyB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Nextra adapter.
+ *
+ * Nextra puts the plugins given in `mdxOptions.remarkPlugins` at the front of
+ * its own pipeline, so cudoc already runs before Nextra assigns heading ids.
+ * What this package adds is the anchor id promotion that makes the two agree on
+ * one id, and the components under `cudoc-nextra/components`.
+ *
+ * The arrangement itself is `createHostPlugins`, shared with the Docusaurus
+ * adapter, so the two hosts cannot quietly diverge.
+ */
+import type { PluggableList } from "unified";
+import { type HostPluginOptions } from "cudoc-remark";
+export type CudocNextraOptions = HostPluginOptions;
+/**
+ * The remark plugins to hand to `mdxOptions.remarkPlugins`.
+ *
+ * Nextra prepends them to its own list, which is the order cudoc needs: the
+ * anchors have to exist before `remarkHeadings` reads heading ids.
+ */
+export declare const cudocRemarkPlugins: (options?: CudocNextraOptions) => PluggableList;
+export { promoteAnchorIds } from "cudoc-remark";
+export type { HostPluginOptions, PromoteAnchorIdsOptions } from "cudoc-remark";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAExE,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAS,kBAAuB,KAC/B,aAA2D,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * Nextra adapter.
+ *
+ * Nextra puts the plugins given in `mdxOptions.remarkPlugins` at the front of
+ * its own pipeline, so cudoc already runs before Nextra assigns heading ids.
+ * What this package adds is the anchor id promotion that makes the two agree on
+ * one id, and the components under `cudoc-nextra/components`.
+ *
+ * The arrangement itself is `createHostPlugins`, shared with the Docusaurus
+ * adapter, so the two hosts cannot quietly diverge.
+ */
+import { createHostPlugins } from "cudoc-remark";
+/**
+ * The remark plugins to hand to `mdxOptions.remarkPlugins`.
+ *
+ * Nextra prepends them to its own list, which is the order cudoc needs: the
+ * anchors have to exist before `remarkHeadings` reads heading ids.
+ */
+export const cudocRemarkPlugins = (options = {}) => createHostPlugins(options, "cudoc-nextra");
+export { promoteAnchorIds } from "cudoc-remark";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,iBAAiB,EAA0B,MAAM,cAAc,CAAA;AAIxE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,UAA8B,EAAE,EACjB,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "cudoc-nextra",
+  "version": "0.2.0",
+  "description": "Nextra adapter for cudoc: remark wiring and default components.",
+  "keywords": [
+    "cudoc",
+    "nextra",
+    "next",
+    "mdx",
+    "documentation"
+  ],
+  "homepage": "https://github.com/cudoment/cudoc/tree/main/packages/cudoc-nextra#readme",
+  "bugs": {
+    "url": "https://github.com/cudoment/cudoc/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cudoment/cudoc.git",
+    "directory": "packages/cudoc-nextra"
+  },
+  "license": "MIT",
+  "author": "cudoment",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./components": {
+      "types": "./dist/components.d.ts",
+      "default": "./dist/components.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "cudoc-remark": "0.2.0",
+    "unified": "^11.0.5"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  }
+}