Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { createRequire } from 'node:module';
import type { UserConfig } from 'tsdown';
import { defineConfig } from 'tsdown';
// jsonc-parser's package `main` is a UMD bundle whose `require('./impl/format')`
// submodule loads are not statically inlinable — bundling it leaves bare
// `./impl/*` requires that crash at runtime from the packaged dist (no
// node_modules beside dist/cli.mjs). Its `module` field is a clean ESM build
// with static relative imports the bundler can follow, so resolve the bare
// `jsonc-parser` specifier straight to that ESM entry before bundling.
const jsoncParserEsmEntry = createRequire(import.meta.url).resolve('jsonc-parser/lib/esm/main.js');
// Native addons stay external in EVERY build — they ship .node binaries
// resolved at runtime.
const nativeAddonNeverBundle = [
'@parcel/watcher',
'@napi-rs/keyring',
'@inkeep/open-knowledge-native-config',
];
// tsdown defaults to externalizing entries in `dependencies`, but the
// desktop install ships no node_modules/ next to dist/cli.mjs, so bare
// specifiers crash on resolve. Force-inline every pure-JS runtime dep in the
// standalone (cli / parse-worker) build. Keep this in sync with
// packages/cli/package.json `dependencies` (tsdown-bundle-coverage.test.ts
// enforces).
const alwaysBundlePureJsDeps = [
/^@inquirer\/checkbox(\/|$)/,
/^@inquirer\/password(\/|$)/,
/^@inquirer\/select(\/|$)/,
/^@modelcontextprotocol\/sdk(\/|$)/,
/^@octokit\/auth-oauth-device(\/|$)/,
/^@octokit\/request(\/|$)/,
/^@octokit\/rest(\/|$)/,
/^@borewit\/text-codec(\/|$)/,
/^@tokenizer\/inflate(\/|$)/,
/^@tokenizer\/token(\/|$)/,
/^cli-boxes(\/|$)/,
/^commander(\/|$)/,
/^file-type(\/|$)/,
/^ieee754(\/|$)/,
/^jsonc-parser(\/|$)/,
/^just-bash(\/|$)/,
/^picocolors(\/|$)/,
/^picomatch(\/|$)/,
// pino is used via `pino.destination()` (sync sonic-boom, no worker
// transports). Externalized, it resolves as a bare specifier from
// app.asar.unpacked/ at runtime in packaged DMGs and crashes with
// ERR_MODULE_NOT_FOUND — Node's resolver from app.asar.unpacked/
// can't cross into the sibling app.asar/ for node_modules. Inlining
// here removes the runtime resolution entirely.
/^pino(\/|$)/,
/^proper-lockfile(\/|$)/,
/^shell-quote(\/|$)/,
/^simple-git(\/|$)/,
// sirv is inlined TRANSITIVELY via @inkeep/open-knowledge-server (boot.ts's
// react-shell mount) — it is NOT a cli package.json dep (dropped with the
// `--only ui` proxy). Do not remove this entry when reconciling `alwaysBundle`
// against cli deps; the server-inlined-closure guard in
// tsdown-bundle-coverage.test.ts pins it.
/^sirv(\/|$)/,
/^smol-toml(\/|$)/,
/^strtok3(\/|$)/,
/^token-types(\/|$)/,
/^uint8array-extras(\/|$)/,
/^yaml(\/|$)/,
/^yazl(\/|$)/,
// yjs must stay inlined in the standalone build (same no-node_modules
// constraint as the rest of this list), and must stay EXTERNAL in the
// library build below — see that config's `neverBundle`.
/^yjs(\/|$)/,
/^zod(\/|$)/,
];
const sharedPlugins: NonNullable<UserConfig['plugins']> = [
{
name: 'jsonc-parser-esm-entry',
resolveId(id) {
return id === 'jsonc-parser' ? jsoncParserEsmEntry : null;
},
},
{
// pino stays value-bundled (see `alwaysBundlePureJsDeps` — the packaged
// DMG cannot resolve it as a bare specifier). Its VALUE inlines fine, but
// its TYPES cannot be inlined into cli's .d.mts: pino ships `export = pino`
// with the public API surfacing `pino.Logger` / `pino.LoggerOptions`, and
// rolldown-plugin-dts's declaration bundler fails to extract those
// namespace members from pino's .d.ts under pnpm's isolated node_modules
// (aborts with MISSING_EXPORT). Externalize pino ONLY in the declaration
// pass (importer is a generated `.d.ts`), leaving `import('pino')`
// references that consumers resolve from their own pino dependency
// (e.g. the desktop app declares pino).
name: 'externalize-pino-in-dts',
resolveId(id, importer) {
if ((id === 'pino' || id.startsWith('pino/')) && importer && /\.d\.[cm]?ts$/.test(importer)) {
return { id, external: true };
}
return null;
},
},
];
const sharedInputOptions: NonNullable<UserConfig['inputOptions']> = (options) => {
// Filter a known false-positive warning. The branch below documents WHY the
// warning is suppressed — re-evaluate when bumping rolldown / tsdown /
// rolldown-plugin-dts. Anything not matched falls through to default.
options.onLog = (level, log, defaultHandler) => {
// `@protobufjs/inquire` uses `eval("quire".replace(/^/,"re"))(name)`
// as a deliberate require-detection workaround for bundlers. The
// dependency reaches us transitively via @opentelemetry/otlp-transformer
// (every OTLP exporter). Cannot be patched at source.
if (
log.code === 'EVAL' &&
typeof log.id === 'string' &&
log.id.includes('/@protobufjs/inquire/')
) {
return;
}
defaultHandler(level, log);
};
return options;
};
// Two builds instead of one, split on how yjs resolves. yjs keeps a
// module-level singleton and breaks `instanceof` across duplicate copies
// (yjs/yjs#438), and the desktop's main + utility processes import BOTH this
// package's library entry AND `@inkeep/open-knowledge-server` — the server
// leaves yjs external, so a library entry with yjs inlined loads a second
// copy into those processes ("Yjs was already imported" at packaged startup).
// The standalone bin (dist/cli.mjs), by contrast, runs with no node_modules
// beside it and MUST keep yjs inlined. tsdown's externalization is global per
// build, so the two entries get their own builds. `clean` stays off in both:
// the `build:cli` script wipes dist/ up front instead, so neither build can
// clobber the other's output.
export default defineConfig([
{
// `parse-worker` ships as its own entry so the server's parse pool can
// spawn `./parse-worker.mjs` next to dist/cli.mjs at runtime (the
// published install has no node_modules to resolve through).
entry: { cli: 'src/bin.ts', 'parse-worker': 'src/parse-worker.ts' },
unbundle: false,
format: 'esm',
dts: false,
clean: false,
minify: true,
plugins: sharedPlugins,
inputOptions: sharedInputOptions,
deps: {
neverBundle: nativeAddonNeverBundle,
alwaysBundle: alwaysBundlePureJsDeps,
},
},
{
// Library entry (package export "."). Same inlining as the standalone
// build EXCEPT yjs, which stays a bare `import 'yjs'` so every consumer
// process resolves the one copy in its node_modules — the desktop's
// main/utility processes then share that copy with
// `@inkeep/open-knowledge-server` and yjs's singleton stays intact.
// Backed by `yjs` in package.json `dependencies`.
entry: { index: 'src/index.ts' },
unbundle: false,
format: 'esm',
dts: { tsconfig: 'tsconfig.build.json' },
clean: false,
minify: true,
plugins: sharedPlugins,
inputOptions: sharedInputOptions,
deps: {
neverBundle: [...nativeAddonNeverBundle, 'yjs'],
alwaysBundle: alwaysBundlePureJsDeps.filter((re) => !re.test('yjs')),
},
},
]);