{ "$schema": "https://unpkg.com/knip@6/schema-jsonc.json", // `tests/__snapshots__/tsnapi/**` is `tsnapi`'s generated API-snapshot // fixture content (see `tests/exports.test.ts` and the root AGENTS.md // "Development" section) - compared byte-for-byte against a fresh build, // never imported. Not source to analyze. "ignore": ["tests/__snapshots__/tsnapi/**"], // `@iconify-json/*` icon collections and `@unocss/preset-icons` are // resolved by UnoCSS's `presetIcons()` at build time by package presence // (scanning `i-ph:*` classes against the installed collection), never // imported in source - the same false-positive class knip's own docs // describe for icon-collection dependencies. "ignoreDependencies": ["@iconify-json/.+", "@unocss/preset-icons", "@antfu/skills", "satori"], // Every built-in plugin's `src/index.ts` aliases its `createDevframe` // factory as both the named and default export (AGENTS.md § "A plugin's // default export is its `createDevframe` factory") - `export default // createXDevframe` right below `export function createXDevframe(...) {}`. // Deliberate, not an accidental duplicate: the named export is for options, // the default export is the conventional single-devframe import. Service // packages (`createService`) follow the same rule. "ignoreIssues": { "plugins/*/src/node/index.ts": ["duplicates"], "plugins/*/src/index.ts": ["duplicates"], "services/*/src/index.ts": ["duplicates"] }, "workspaces": { ".": { // `design/*.ts` is the shared design system (AGENTS.md § "Design // system") consumed by every plugin/example's own `uno.config.ts` and // `design.ts` via relative imports (`../../design/uno.config`). Those // are UnoCSS/plugin config files, not part of the reachability graph // knip builds for "unused files", so the shared source is otherwise // reported as unused from the root workspace. // // `skills/devframe/templates/*.ts` are the devframe-authoring skill's // copy-and-run reference snippets (`skills/devframe/SKILL.md`) - each // one a standalone, runnable example, not imported by anything else. "entry": ["design/*.ts", "skills/devframe/templates/*.ts", "scripts/smoke-bun.ts"], // `@x18n/cli` is run by hand (`pnpm x18n`) and no script calls it yet. "ignoreDependencies": ["@x18n/cli"] }, "packages/hub-ui-onboard": { // The playground is a dev-only Vite app (`pnpm play`); its config is // loaded by the Vite CLI, not imported. "entry": ["playground/vite.config.ts"] }, "docs": { // Nuxt auto-registers `app/components` and `app/composables`; the files // here shadow same-named pieces of the comark-docs layer (AppHeaderBrand, // useFilteredNavigation, ...), so nothing imports them explicitly. // // `app/components/global/*.ts` re-export Nuxt UI components for content, // `highlighter.ts` is loaded by path from `comarkDocs.highlighter` in // `nuxt.config.ts`, and `comark-lint.config.ts` is found by the // `comark-lint` CLI. "entry": [ "app/components/*.vue", "app/components/OgImage/*.vue", "app/components/global/*.ts", "app/composables/*.ts", "highlighter.ts", "comark-lint.config.ts" ], // `app/components/AssistantChat.vue` shadows the comark-docs layer's own // component and mirrors its imports verbatim (see the file header). These // packages are provided transitively by the `comark-docs` layer, not // declared in `docs/package.json`, so knip sees them as unlisted. // // `@shikijs/magic-move` is declared in `docs/package.json` but only ever // referenced as the `@shikijs/magic-move/style.css` subpath in the // `nuxt.config.ts` `css` array; knip can't map that CSS-only subpath back // to the package, so it mis-reports the (genuinely-listed) dep as unlisted. "ignoreDependencies": ["ai", "@ai-sdk/vue", "@comark/nuxt.*", "@nuxt/ui.*", "@shikijs/magic-move"] }, "examples/custom-hub-next": { // The React client build's root sits at `src/client` (`next dev // src/client`), not the workspace root, so knip's default PostCSS // config glob (workspace-root `postcss.config.*`) misses it. "postcss": { "config": ["src/client/postcss.config.mjs"] }, // `BUILTIN_PLUGIN_PACKAGES` (`src/client/devframe/next-devframe-hub.ts`) // lists these as string literals and loads them via a runtime // `import()` carrying `webpackIgnore`/`turbopackIgnore` comments - // deliberately invisible to bundlers (and knip) so Next never inlines // their node-only code. They're genuinely used at runtime. "ignoreDependencies": [ "@devframes/plugin-a11y", "@devframes/plugin-code-server", "@devframes/plugin-git", "@devframes/plugin-inspect", "@devframes/plugin-messages", "@devframes/plugin-og", "@devframes/plugin-terminals" ] }, "examples/hub-next": { // `BUILTIN_PLUGIN_PACKAGES` (`src/client/hub.ts`) lists these as string // literals loaded through a runtime `import()` carrying // `webpackIgnore`/`turbopackIgnore`, deliberately invisible to bundlers // (and knip) so Next never inlines their node-only code. They're // genuinely used at runtime. (`data-inspector` and `assets` load via // their own string-literal helpers, so knip sees those directly.) "ignoreDependencies": [ "@devframes/plugin-a11y", "@devframes/plugin-code-server", "@devframes/plugin-git", "@devframes/plugin-inspect", "@devframes/plugin-messages", "@devframes/plugin-og", "@devframes/plugin-terminals" ] }, "examples/custom-hub-vite": { // `demo-dock-client` is consumed only as a runtime string: the demo // dock's `action.importFrom` bare specifier, resolved by Vite through // the hub's `clientModuleResolution` template (`/@id/{specifier}`), // never a static import knip's graph can see. "ignoreDependencies": ["demo-dock-client"] }, // Multi-entry example package (see `packages/devframe` above for why // exports-mapped entries are listed explicitly): `src/index.ts` is the // dock client script the hub examples import at runtime by URL/specifier, // `src/node.ts` the bundle-path helper the Next host loads dynamically. "examples/demo-dock-client": { "entry": ["src/{index,node}.ts"] }, "examples/next-runtime-snapshot": { // The Next.js app root sits at `app/` (`next build app`), not the // workspace root, so knip's default PostCSS config glob misses it. "postcss": { "config": ["app/postcss.config.mjs"] } }, // The Deno entry runs via `deno run src/server.ts`, a command string knip // doesn't parse (unlike `tsx`/`bun`), so name the entry explicitly; it // pulls in `src/hub.ts` and every plugin dependency from there. "examples/hub-deno": { "entry": ["src/server.ts"] }, "packages/devframe": { // Every `package.json#exports` subpath maps to one of these source // files (see `tsdown.config.ts`'s `serverEntries`/`clientEntries`). // Knip's package.json→dist→src source mapping needs `outDir` set on // the workspace `tsconfig.json`, but this repo's packages resolve // each other's `src/*.ts` directly across workspaces (via the `paths` // aliases in `tsconfig.base.json`), and `outDir` breaks `tsc`'s // `rootDir` inference for every consumer that does - so entries are // listed explicitly instead. Keep this in sync with the `exports` map. "entry": [ "src/{index,constants}.ts", "src/adapters/{build,cac,dev,embedded,initiate,mcp}.ts", "src/client/index.ts", "src/in-page-channel/index.ts", "src/internal/index.ts", "src/node/index.ts", "src/node/{auth,hub-internals}/index.ts", "src/recipes/interactive-auth.ts", "src/rpc/{index,client,server}.ts", "src/rpc/dump/index.ts", "src/rpc/transports/{sse-client,sse-server,ws-bun,ws-deno,ws-client,ws-server}.ts", "src/types/index.ts", "src/utils/*.ts" ] }, "packages/agentic": { "entry": ["src/{mcp,connect}/index.ts"] }, "packages/hub": { "entry": ["src/{index,constants}.ts", "src/{client,node,types}/index.ts", "src/node/{index,initiate,build}.ts"] }, "packages/hub-ui": { // `playground/client-scripts/*.ts` are dock `action` entries the // playground's `seed.ts` points at by their runtime URL string // (`action.importFrom`), not a static import knip's graph can see, // the same shape as a devframe's `clientScript`/`clientScripts` entry. "entry": ["playground/client-scripts/*.ts"] }, "packages/vite": { "ignoreBinaries": ["openssl"] }, "packages/json-render": { // `src/node/index.ts` is already picked up via `tsdown.config.ts` // (its literal `entry` object parses cleanly); only `core.ts`/`hub.ts` // need to be declared explicitly. "entry": ["src/{index,core,hub}.ts"] }, "packages/json-render-ui": { // Published node-safe entries are `spa.ts`/`hub.ts`; the browser // renderer ships only as self-contained Vite bundles (the standalone // SPA and the prebuilt renderer module, consumed at runtime via the // hub's renderer manifest). "entry": ["src/{spa,hub}.ts"], // The standalone SPA's own Vite config (`src/spa/vite.config.ts`) // mounts `unocss/vite` with no explicit config path, so UnoCSS // discovers this nested `uno.config.ts` by directory proximity to // `root` - not an import knip's graph can see. Keep the package-root // config the Storybook build uses alongside it. "unocss": { "config": ["uno.config.ts", "src/spa/uno.config.ts"] } }, // Every built-in plugin ships the same entry shape (see each // `tsdown.config.ts`'s `serverEntries`/`clientEntries`): a root // `index.ts`, an optional `cli.ts`/`vite.ts`/`constants.ts`/`types.ts`, // and `client|node|rpc|inject|engine|registry/index.ts` subdirectories. // One shared pattern covers them all - see `packages/devframe` above for // why this is explicit instead of relying on source mapping. "plugins/*": { "entry": [ "src/{index,cli,vite,constants,types}.ts", "src/{client,node,rpc,inject,engine,registry}/index.ts" ] }, "plugins/inspect": { // The lockstep assets package is referenced only as a runtime string // (`${pkg.name}--assets` in `clientAssets`), never imported, so knip // can't see the dev-only workspace link that makes it resolvable in // the monorepo. Repeat the `plugins/*` entry glob (a workspace config // replaces, not merges, it). "entry": [ "src/node/{index,setup,cli}.ts", "src/node/rpc/index.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-inspect--assets", "@devframes/vite"] }, "plugins/inspect/assets-pkg": { // Assets-only package: no source, just a prebuilt `dist` produced by // the sibling plugin's Vite build. "entry": [], "project": [] }, // Each plugin's lockstep `--assets` package is referenced only as a // runtime string (`${pkg.name}--assets` in `clientAssets`), never imported, // so knip can't see the dev-only workspace link. A workspace config // replaces (not merges) the `plugins/*` glob's `entry`, so repeat it. "plugins/og": { "entry": [ "src/node/{index,setup,cli}.ts", "src/node/rpc/index.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-og--assets", "@devframes/vite"] }, "plugins/og/assets-pkg": { "entry": [], "project": [] }, "plugins/data-inspector": { "entry": [ "src/node/{index,setup,cli}.ts", "src/node/rpc/index.ts", "src/node/{engine,registry}/index.ts", "src/inject/index.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-data-inspector--assets", "@devframes/vite"] }, "plugins/data-inspector/assets-pkg": { "entry": [], "project": [] }, "plugins/code-server": { "entry": [ "src/node/{index,setup,cli,constants,types,vite}.ts", "src/node/rpc/index.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-code-server--assets"] }, "plugins/code-server/assets-pkg": { "entry": [], "project": [] }, "plugins/assets": { "entry": [ "src/node/{index,setup,cli,constants,types}.ts", "src/node/rpc/index.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-assets--assets", "@devframes/vite"] }, "plugins/assets/assets-pkg": { "entry": [], "project": [] }, "plugins/messages": { "entry": [ "src/node/{index,setup,cli,constants}.ts", "src/node/rpc/index.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-messages--assets", "@devframes/vite"] }, "plugins/messages/assets-pkg": { "entry": [], "project": [] }, "plugins/terminals": { "entry": [ "src/node/{index,setup,cli,constants,types,vite}.ts", "src/node/rpc/index.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-terminals--assets"] }, "plugins/terminals/assets-pkg": { "entry": [], "project": [] }, "plugins/a11y/assets-pkg": { "entry": [], "project": [] }, "plugins/git/assets-pkg": { "entry": [], "project": [] }, "plugins/a11y": { // `storybook-solidjs-vite` (not an official `@storybook/*` framework // package) doesn't match knip's Storybook plugin trigger, so it never // auto-enables here. Mirror the plugin's own defaults by hand. "storybook": { "config": [".storybook/main.ts"], "entry": [".storybook/preview.tsx"], "project": [".storybook/**/*.{js,jsx,ts,tsx,mts}"] }, // A workspace-specific `entry` replaces (rather than merges with) the // `plugins/*` glob's `entry` above, so repeat that pattern here // alongside the stories. "entry": [ "src/node/{index,setup,cli}.ts", "src/node/rpc/index.ts", "src/client-script/index.ts", "app/**/*.stories.tsx" ], "ignoreDependencies": ["@devframes/plugin-a11y--assets", "@devframes/vite"] }, "plugins/git": { // The React client build's root sits at `app/` (`next dev app`), not the // workspace root, so knip's default PostCSS config glob (workspace-root // `postcss.config.*`) misses it. "postcss": { "config": ["app/postcss.config.mjs"] }, "entry": [ "src/node/{index,cli}.ts", "app/**/*.stories.@(ts|tsx)" ], "ignoreDependencies": ["@devframes/plugin-git--assets"] } } }