{"_id":"@act-spec/plugin-vitepress","name":"@act-spec/plugin-vitepress","dist-tags":{"rc":"0.2.0-rc.1","latest":"0.2.0-rc.1"},"versions":{"0.2.0-rc.1":{"name":"@act-spec/plugin-vitepress","version":"0.2.0-rc.1","description":"VitePress plugin for the ACT (Agent Content Tree) reference implementation. Wraps the ACT generator pipeline against VitePress 1.x / 2.x via the transformPageData and buildEnd hooks.","license":"Apache-2.0","author":{"name":"Jeremy Forsythe","email":"jeremy@act-spec.org"},"homepage":"https://act-spec.org","bugs":{"url":"https://github.com/act-spec/act/issues"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/act-spec/act.git","directory":"packages/plugin-vitepress"},"peerDependencies":{"vitepress":"^1.0.0 || ^2.0.0"},"peerDependenciesMeta":{"vitepress":{"optional":true}},"dependencies":{"@act-spec/adapter-markdown":"0.2.0-rc.1","@act-spec/generator-core":"0.2.0-rc.1","@act-spec/core":"0.2.0-rc.1"},"devDependencies":{"@vitest/coverage-v8":"^2.1.9","tsx":"^4.19.2","typescript":"^5.6.3","vitest":"^2.1.4","@act-spec/validator":"0.2.0-rc.1","@act-spec/adapter-framework":"0.2.0-rc.1"},"scripts":{"build":"tsc -p tsconfig.json","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","lint":"eslint src","typecheck":"tsc -p tsconfig.json --noEmit"},"_id":"@act-spec/plugin-vitepress@0.2.0-rc.1","_integrity":"sha512-XLT03oWS+7pseXuxw/674SYXNLf93cRO57iL1Pts/EGxzNfMu9yZ9dcmOiuckQtPFXb2o8eSe2CgZVlZ64JM1Q==","_resolved":"/private/var/folders/yp/y7frhcvj70jgr6b8g633lghr0000gn/T/a8e596e2731df398bb17d1bd364c36a3/act-spec-plugin-vitepress-0.2.0-rc.1.tgz","_from":"file:act-spec-plugin-vitepress-0.2.0-rc.1.tgz","_nodeVersion":"22.19.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-XLT03oWS+7pseXuxw/674SYXNLf93cRO57iL1Pts/EGxzNfMu9yZ9dcmOiuckQtPFXb2o8eSe2CgZVlZ64JM1Q==","shasum":"0dcae8fc33fb60bd109724e7f2f13b7be26b2c67","tarball":"https://registry.npmjs.org/@act-spec/plugin-vitepress/-/plugin-vitepress-0.2.0-rc.1.tgz","fileCount":20,"unpackedSize":138319,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD+TQBkd7uMvPMun7s6AdKih7GvExAzGxMDe1yUGo79BgIhAOApAueuaMlUAqubUksVSLLRkzAAPgtDTjADBkN3Tgqz"}]},"_npmUser":{"name":"jdforsythe","email":"jdforsythe@gmail.com"},"directories":{},"maintainers":[{"name":"jdforsythe","email":"jdforsythe@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/plugin-vitepress_0.2.0-rc.1_1777915327137_0.7120032488158212"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-04T17:22:07.032Z","0.2.0-rc.1":"2026-05-04T17:22:07.314Z","modified":"2026-05-04T17:22:07.538Z"},"maintainers":[{"name":"jdforsythe","email":"jdforsythe@gmail.com"}],"description":"VitePress plugin for the ACT (Agent Content Tree) reference implementation. Wraps the ACT generator pipeline against VitePress 1.x / 2.x via the transformPageData and buildEnd hooks.","homepage":"https://act-spec.org","repository":{"type":"git","url":"git+https://github.com/act-spec/act.git","directory":"packages/plugin-vitepress"},"author":{"name":"Jeremy Forsythe","email":"jeremy@act-spec.org"},"bugs":{"url":"https://github.com/act-spec/act/issues"},"license":"Apache-2.0","readme":"# @act-spec/plugin-vitepress\n\nVitePress plugin for ACT (Agent Content Tree). Wraps the ACT generator\npipeline (`@act-spec/generator-core`) against VitePress 1.x / 2.x via the\n`transformPageData` (per-page) and `buildEnd` (final emit) hooks. The\nmarkdown adapter is consumed unchanged from `@act-spec/adapter-markdown`.\n\nVitePress's `locales` config is read at `transformPageData` time and\nthreaded into the ACT locale tree. The plugin emits `/llms.txt` and\n`/llms-full.txt` by default; opt out via `emit.llmsTxt: false` /\n`emit.llmsFullTxt: false`.\n\n## Install\n\n```sh\npnpm add -D @act-spec/plugin-vitepress\n```\n\n## Usage\n\n```ts\n// .vitepress/config.ts\nimport { defineConfig } from 'vitepress';\nimport { actPlugin } from '@act-spec/plugin-vitepress';\n\nconst act = actPlugin({\n  baseUrl: 'https://example.com',\n  manifest: { site: { name: 'Example Docs' } },\n  urlTemplates: { indexUrl: '/act/index.json', nodeUrlTemplate: '/act/n/{id}.json' },\n});\n\nexport default defineConfig({\n  title: 'Example Docs',\n  transformPageData: act.transformPageData,\n  buildEnd: act.buildEnd,\n});\n```\n\nAfter `vitepress build`, the ACT file set lands inside VitePress's\n`outDir` (default `.vitepress/dist/`):\n\n- `/.well-known/act.json` — manifest\n- `/act/index.json` — index\n- `/act/nodes/*.json` — per-node files\n- `/llms.txt`, `/llms-full.txt` — back-compat surfaces (default-on)\n\n## Configuration\n\n| Option              | Default      | Notes                                                      |\n| ------------------- | ------------ | ---------------------------------------------------------- |\n| `baseUrl`           | (required)   | Site origin; used as `manifest.site.canonical_url`.        |\n| `manifest`          | (required)   | `{ site: { name } }` minimum.                              |\n| `urlTemplates`      | (required)   | `indexUrl` + `nodeUrlTemplate`.                            |\n| `conformanceTarget` | `'standard'` | `'core' \\| 'standard' \\| 'strict'`.                        |\n| `outputDir`         | VitePress's `outDir` | Override target dir for ACT artifacts.            |\n| `parseMode`         | `'coarse'`   | `'fine'` requires `conformanceTarget >= \"standard\"`.       |\n| `emit.llmsTxt`      | `true`       | Set `false` to skip `/llms.txt`.                            |\n| `emit.llmsFullTxt`  | `true`       | Set `false` to skip `/llms-full.txt`.                       |\n| `adapters`          | auto-wired   | Replaces the default markdown adapter.                     |\n| `hooks`             | none         | `preBuild` / `postBuild` / `onError`.                      |\n\n## Peer dependencies\n\n| Peer        | Range            |\n| ----------- | ---------------- |\n| `vitepress` | `^1.0.0 \\|\\| ^2.0.0` |\n\nOptional from npm's perspective; the plugin is a no-op without VitePress.\n\n## Links\n\n- Generator core: [`@act-spec/generator-core`](../generator-core)\n- Markdown adapter: [`@act-spec/adapter-markdown`](../adapter-markdown)\n- Repository: <https://github.com/act-spec/act>\n","readmeFilename":"README.md","_rev":"1-f9ea2161a9b1e3bcb44a7c7b554c37ec"}