prjct-cli 0.35.2 → 0.35.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/core/commands/workflow.ts +3 -2
- package/dist/bin/prjct.mjs +5 -4
- package/package.json +1 -1
- package/templates/_bases/tracker-base.md +309 -0
- package/templates/agentic/orchestrator.md +211 -269
- package/templates/commands/github.md +9 -0
- package/templates/commands/history.md +296 -83
- package/templates/commands/jira.md +9 -0
- package/templates/commands/linear.md +9 -0
- package/templates/commands/monday.md +9 -0
- package/templates/commands/p.md +198 -63
- package/templates/commands/resume.md +68 -4
- package/templates/commands/sync.md +103 -0
- package/packages/shared/node_modules/@types/bun/LICENSE +0 -21
- package/packages/shared/node_modules/@types/bun/README.md +0 -20
- package/packages/shared/node_modules/@types/bun/index.d.ts +0 -1
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/CLAUDE.md +0 -105
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/README.md +0 -33
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/bun.d.ts +0 -7032
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/bun.ns.d.ts +0 -5
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/bundle.d.ts +0 -74
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/deprecated.d.ts +0 -184
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/devserver.d.ts +0 -187
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/README.md +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/bytecode.mdx +0 -465
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/css.mdx +0 -1024
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/esbuild.mdx +0 -298
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/executables.mdx +0 -1277
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/fullstack.mdx +0 -1086
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/hot-reloading.mdx +0 -229
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/html-static.mdx +0 -488
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/index.mdx +0 -1604
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/loaders.mdx +0 -451
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/macros.mdx +0 -328
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/minifier.mdx +0 -1286
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/bundler/plugins.mdx +0 -425
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/feedback.mdx +0 -75
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/arraybuffer-to-array.mdx +0 -29
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/arraybuffer-to-blob.mdx +0 -26
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/arraybuffer-to-buffer.mdx +0 -27
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/arraybuffer-to-string.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/arraybuffer-to-typedarray.mdx +0 -41
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/blob-to-arraybuffer.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/blob-to-dataview.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/blob-to-stream.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/blob-to-string.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/blob-to-typedarray.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/buffer-to-arraybuffer.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/buffer-to-blob.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/buffer-to-readablestream.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/buffer-to-string.mdx +0 -27
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/buffer-to-typedarray.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/dataview-to-string.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/typedarray-to-arraybuffer.mdx +0 -27
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/typedarray-to-blob.mdx +0 -18
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/typedarray-to-buffer.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/typedarray-to-dataview.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/typedarray-to-readablestream.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/binary/typedarray-to-string.mdx +0 -18
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/deployment/aws-lambda.mdx +0 -204
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/deployment/digital-ocean.mdx +0 -161
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/deployment/google-cloud-run.mdx +0 -194
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/deployment/railway.mdx +0 -145
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/deployment/render.mdx +0 -82
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/deployment/vercel.mdx +0 -97
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/astro.mdx +0 -82
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/discordjs.mdx +0 -80
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/docker.mdx +0 -151
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/drizzle.mdx +0 -195
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/elysia.mdx +0 -31
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/express.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/gel.mdx +0 -261
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/hono.mdx +0 -47
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/mongoose.mdx +0 -92
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/neon-drizzle.mdx +0 -234
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/neon-serverless-postgres.mdx +0 -60
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/nextjs.mdx +0 -103
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/nuxt.mdx +0 -96
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/pm2.mdx +0 -55
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/prisma-postgres.mdx +0 -169
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/prisma.mdx +0 -164
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/qwik.mdx +0 -114
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/react.mdx +0 -52
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/remix.mdx +0 -97
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/sentry.mdx +0 -54
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/solidstart.mdx +0 -62
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/ssr-react.mdx +0 -49
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/stric.mdx +0 -54
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/sveltekit.mdx +0 -138
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/systemd.mdx +0 -114
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/tanstack-start.mdx +0 -791
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/upstash.mdx +0 -87
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/ecosystem/vite.mdx +0 -77
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/html-rewriter/extract-links.mdx +0 -71
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/html-rewriter/extract-social-meta.mdx +0 -97
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/cluster.mdx +0 -69
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/fetch-unix.mdx +0 -35
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/fetch.mdx +0 -26
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/file-uploads.mdx +0 -97
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/hot.mdx +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/proxy.mdx +0 -50
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/server.mdx +0 -48
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/simple.mdx +0 -20
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/stream-file.mdx +0 -50
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/stream-iterator.mdx +0 -49
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/stream-node-streams-in-bun.mdx +0 -22
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/http/tls.mdx +0 -32
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/index.mdx +0 -10
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/add-dev.mdx +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/add-git.mdx +0 -40
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/add-optional.mdx +0 -27
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/add-peer.mdx +0 -45
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/add-tarball.mdx +0 -35
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/add.mdx +0 -44
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/azure-artifacts.mdx +0 -76
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/cicd.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/custom-registry.mdx +0 -32
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/from-npm-install-to-bun-install.mdx +0 -230
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/git-diff-bun-lockfile.mdx +0 -48
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/jfrog-artifactory.mdx +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/npm-alias.mdx +0 -25
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/registry-scope.mdx +0 -40
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/trusted.mdx +0 -52
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/workspaces.mdx +0 -70
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/install/yarnlock.mdx +0 -51
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/argv.mdx +0 -66
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/ctrl-c.mdx +0 -18
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/ipc.mdx +0 -69
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/nanoseconds.mdx +0 -15
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/os-signals.mdx +0 -31
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/spawn-stderr.mdx +0 -34
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/spawn-stdout.mdx +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/spawn.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/process/stdin.mdx +0 -62
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/arraybuffer.mdx +0 -30
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/buffer.mdx +0 -21
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/exists.mdx +0 -18
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/json.mdx +0 -19
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/mime.mdx +0 -22
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/stream.mdx +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/string.mdx +0 -24
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/uint8array.mdx +0 -23
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/read-file/watch.mdx +0 -66
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/build-time-constants.mdx +0 -295
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/cicd.mdx +0 -45
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/codesign-macos-executable.mdx +0 -61
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/define-constant.mdx +0 -149
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/delete-directory.mdx +0 -39
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/delete-file.mdx +0 -21
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/heap-snapshot.mdx +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/import-html.mdx +0 -15
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/import-json.mdx +0 -46
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/import-toml.mdx +0 -32
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/import-yaml.mdx +0 -104
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/read-env.mdx +0 -37
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/set-env.mdx +0 -51
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/shell.mdx +0 -42
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/timezone.mdx +0 -38
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/tsconfig-paths.mdx +0 -31
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/typescript.mdx +0 -51
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/vscode-debugger.mdx +0 -47
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/runtime/web-debugger.mdx +0 -103
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/node-readable-to-arraybuffer.mdx +0 -13
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/node-readable-to-blob.mdx +0 -13
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/node-readable-to-json.mdx +0 -14
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/node-readable-to-string.mdx +0 -14
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/node-readable-to-uint8array.mdx +0 -13
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/to-array.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/to-arraybuffer.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/to-blob.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/to-buffer.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/to-json.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/to-string.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/streams/to-typedarray.mdx +0 -24
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/bail.mdx +0 -24
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/concurrent-test-glob.mdx +0 -146
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/coverage-threshold.mdx +0 -67
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/coverage.mdx +0 -49
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/happy-dom.mdx +0 -73
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/migrate-from-jest.mdx +0 -125
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/mock-clock.mdx +0 -50
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/mock-functions.mdx +0 -70
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/rerun-each.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/run-tests.mdx +0 -116
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/skip-tests.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/snapshot.mdx +0 -102
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/spy-on.mdx +0 -49
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/svelte-test.mdx +0 -113
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/testing-library.mdx +0 -93
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/timeout.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/todo-tests.mdx +0 -74
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/update-snapshots.mdx +0 -49
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/test/watch-mode.mdx +0 -24
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/base64.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/deep-equals.mdx +0 -41
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/deflate.mdx +0 -20
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/detect-bun.mdx +0 -28
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/entrypoint.mdx +0 -19
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/escape-html.mdx +0 -24
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/file-url-to-path.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/gzip.mdx +0 -20
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/hash-a-password.mdx +0 -56
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/import-meta-dir.mdx +0 -15
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/import-meta-file.mdx +0 -15
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/import-meta-path.mdx +0 -15
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/javascript-uuid.mdx +0 -25
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/main.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/path-to-file-url.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/sleep.mdx +0 -24
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/upgrade.mdx +0 -93
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/version.mdx +0 -23
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/util/which-path-to-executable-bin.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/websocket/compression.mdx +0 -33
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/websocket/context.mdx +0 -79
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/websocket/pubsub.mdx +0 -43
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/websocket/simple.mdx +0 -38
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/append.mdx +0 -54
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/basic.mdx +0 -46
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/blob.mdx +0 -30
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/cat.mdx +0 -19
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/file-cp.mdx +0 -18
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/filesink.mdx +0 -54
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/response.mdx +0 -19
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/stdout.mdx +0 -23
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/stream.mdx +0 -19
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/guides/write-file/unlink.mdx +0 -18
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/index.mdx +0 -133
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/installation.mdx +0 -365
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/bunx.mdx +0 -91
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/catalogs.mdx +0 -292
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/add.mdx +0 -179
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/audit.mdx +0 -60
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/info.mdx +0 -70
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/install.mdx +0 -606
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/link.mdx +0 -61
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/outdated.mdx +0 -197
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/patch.mdx +0 -69
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/pm.mdx +0 -323
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/publish.mdx +0 -131
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/remove.mdx +0 -16
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/update.mdx +0 -140
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/cli/why.mdx +0 -84
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/filter.mdx +0 -102
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/global-cache.mdx +0 -72
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/isolated-installs.mdx +0 -220
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/lifecycle.mdx +0 -64
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/lockfile.mdx +0 -64
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/npmrc.mdx +0 -111
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/overrides.mdx +0 -83
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/scopes-registries.mdx +0 -35
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/security-scanner-api.mdx +0 -95
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/pm/workspaces.mdx +0 -115
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/benchmarking.mdx +0 -241
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/bindgen.mdx +0 -223
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/building-windows.mdx +0 -133
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/contributing.mdx +0 -388
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/feedback.mdx +0 -20
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/license.mdx +0 -78
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/roadmap.mdx +0 -8
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/quickstart.mdx +0 -251
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/auto-install.mdx +0 -97
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/binary-data.mdx +0 -846
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/bun-apis.mdx +0 -59
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/bunfig.mdx +0 -723
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/c-compiler.mdx +0 -204
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/child-process.mdx +0 -659
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/color.mdx +0 -267
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/console.mdx +0 -67
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/cookies.mdx +0 -454
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/debugger.mdx +0 -335
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/environment-variables.mdx +0 -231
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/ffi.mdx +0 -565
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/file-io.mdx +0 -306
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/file-system-router.mdx +0 -118
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/file-types.mdx +0 -435
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/glob.mdx +0 -181
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/globals.mdx +0 -72
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/hashing.mdx +0 -315
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/html-rewriter.mdx +0 -333
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/http/cookies.mdx +0 -79
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/http/error-handling.mdx +0 -40
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/http/metrics.mdx +0 -36
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/http/routing.mdx +0 -289
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/http/server.mdx +0 -645
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/http/tls.mdx +0 -101
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/http/websockets.mdx +0 -414
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/index.mdx +0 -223
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/jsx.mdx +0 -115
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/module-resolution.mdx +0 -374
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/networking/dns.mdx +0 -111
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/networking/fetch.mdx +0 -484
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/networking/tcp.mdx +0 -239
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/networking/udp.mdx +0 -129
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/node-api.mdx +0 -19
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/nodejs-compat.mdx +0 -468
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/plugins.mdx +0 -419
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/redis.mdx +0 -583
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/s3.mdx +0 -863
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/secrets.mdx +0 -340
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/semver.mdx +0 -57
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/shell.mdx +0 -637
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/sql.mdx +0 -1404
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/sqlite.mdx +0 -721
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/streams.mdx +0 -232
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/templating/create.mdx +0 -269
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/templating/init.mdx +0 -58
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/transpiler.mdx +0 -288
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/typescript.mdx +0 -58
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/utils.mdx +0 -922
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/watch-mode.mdx +0 -161
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/web-apis.mdx +0 -29
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/workers.mdx +0 -314
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/runtime/yaml.mdx +0 -469
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/add.mdx +0 -166
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/build.mdx +0 -196
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/bunx.mdx +0 -49
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/feedback.mdx +0 -17
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/init.mdx +0 -84
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/install.mdx +0 -173
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/link.mdx +0 -163
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/outdated.mdx +0 -140
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/patch.mdx +0 -171
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/publish.mdx +0 -198
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/remove.mdx +0 -146
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/run.mdx +0 -293
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/test.mdx +0 -100
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/snippets/cli/update.mdx +0 -144
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/code-coverage.mdx +0 -409
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/configuration.mdx +0 -514
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/dates-times.mdx +0 -129
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/discovery.mdx +0 -90
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/dom.mdx +0 -226
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/index.mdx +0 -380
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/lifecycle.mdx +0 -366
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/mocks.mdx +0 -637
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/reporters.mdx +0 -126
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/runtime-behavior.mdx +0 -342
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/snapshots.mdx +0 -434
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/test/writing-tests.mdx +0 -672
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/typescript.mdx +0 -54
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/extensions.d.ts +0 -35
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/fetch.d.ts +0 -79
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/ffi.d.ts +0 -1154
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/globals.d.ts +0 -2067
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/html-rewriter.d.ts +0 -186
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/index.d.ts +0 -32
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/jsc.d.ts +0 -233
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/overrides.d.ts +0 -376
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/package.json +0 -37
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/redis.d.ts +0 -3352
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/s3.d.ts +0 -1299
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/security.d.ts +0 -101
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/serve.d.ts +0 -1296
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/shell.d.ts +0 -380
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/sql.d.ts +0 -887
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/sqlite.d.ts +0 -1321
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/test-globals.d.ts +0 -22
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/test.d.ts +0 -2391
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/vendor/expect-type/branding.d.ts +0 -283
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/vendor/expect-type/index.d.ts +0 -1207
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/vendor/expect-type/messages.d.ts +0 -395
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/vendor/expect-type/overloads.d.ts +0 -669
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/vendor/expect-type/utils.d.ts +0 -431
- package/packages/shared/node_modules/@types/bun/node_modules/bun-types/wasm.d.ts +0 -193
- package/packages/shared/node_modules/@types/bun/package.json +0 -53
- package/templates/commands/redo.md +0 -144
- package/templates/commands/undo.md +0 -154
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Building Windows
|
|
3
|
-
description: Building Bun on Windows
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
This document describes the build process for Windows. If you run into problems, please join the [#contributing channel on our Discord](http://bun.com/discord) for help.
|
|
7
|
-
|
|
8
|
-
It is strongly recommended to use [PowerShell 7 (`pwsh.exe`)](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.4) instead of the default `powershell.exe`.
|
|
9
|
-
|
|
10
|
-
## Prerequisites
|
|
11
|
-
|
|
12
|
-
### Enable Scripts
|
|
13
|
-
|
|
14
|
-
By default, running unverified scripts are blocked.
|
|
15
|
-
|
|
16
|
-
```ps1
|
|
17
|
-
> Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
### System Dependencies
|
|
21
|
-
|
|
22
|
-
Bun v1.1 or later. We use Bun to run it's own code generators.
|
|
23
|
-
|
|
24
|
-
```ps1
|
|
25
|
-
> irm bun.sh/install.ps1 | iex
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
[Visual Studio](https://visualstudio.microsoft.com) with the "Desktop Development with C++" workload. While installing, make sure to install Git as well, if Git for Windows is not already installed.
|
|
29
|
-
|
|
30
|
-
Visual Studio can be installed graphically using the wizard or through WinGet:
|
|
31
|
-
|
|
32
|
-
```ps1
|
|
33
|
-
> winget install "Visual Studio Community 2022" --override "--add Microsoft.VisualStudio.Workload.NativeDesktop Microsoft.VisualStudio.Component.Git " -s msstore
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
After Visual Studio, you need the following:
|
|
37
|
-
|
|
38
|
-
- LLVM 19.1.7
|
|
39
|
-
- Go
|
|
40
|
-
- Rust
|
|
41
|
-
- NASM
|
|
42
|
-
- Perl
|
|
43
|
-
- Ruby
|
|
44
|
-
- Node.js
|
|
45
|
-
|
|
46
|
-
<Note>The Zig compiler is automatically downloaded, installed, and updated by the building process.</Note>
|
|
47
|
-
|
|
48
|
-
[Scoop](https://scoop.sh) can be used to install these remaining tools easily.
|
|
49
|
-
|
|
50
|
-
```ps1 Scoop
|
|
51
|
-
> irm https://get.scoop.sh | iex
|
|
52
|
-
> scoop install nodejs-lts go rust nasm ruby perl sccache
|
|
53
|
-
# scoop seems to be buggy if you install llvm and the rest at the same time
|
|
54
|
-
> scoop install llvm@19.1.7
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
<Note>
|
|
58
|
-
Please do not use WinGet/other package manager for these, as you will likely install Strawberry Perl instead of a more
|
|
59
|
-
minimal installation of Perl. Strawberry Perl includes many other utilities that get installed into `$Env:PATH` that
|
|
60
|
-
will conflict with MSVC and break the build.
|
|
61
|
-
</Note>
|
|
62
|
-
|
|
63
|
-
If you intend on building WebKit locally (optional), you should install these packages:
|
|
64
|
-
|
|
65
|
-
```ps1 Scoop
|
|
66
|
-
> scoop install make cygwin python
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
From here on out, it is **expected you use a PowerShell Terminal with `.\scripts\vs-shell.ps1` sourced**. This script is available in the Bun repository and can be loaded by executing it:
|
|
70
|
-
|
|
71
|
-
```ps1
|
|
72
|
-
> .\scripts\vs-shell.ps1
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
To verify, you can check for an MSVC-only command line such as `mt.exe`
|
|
76
|
-
|
|
77
|
-
```ps1
|
|
78
|
-
> Get-Command mt
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
<Note>
|
|
82
|
-
It is not recommended to install `ninja` / `cmake` into your global path, because you may run into a situation where
|
|
83
|
-
you try to build bun without .\scripts\vs-shell.ps1 sourced.
|
|
84
|
-
</Note>
|
|
85
|
-
|
|
86
|
-
## Building
|
|
87
|
-
|
|
88
|
-
```ps1
|
|
89
|
-
> bun run build
|
|
90
|
-
|
|
91
|
-
# after the initial `bun run build` you can use the following to build
|
|
92
|
-
> ninja -Cbuild/debug
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
If this was successful, you should have a `bun-debug.exe` in the `build/debug` folder.
|
|
96
|
-
|
|
97
|
-
```ps1
|
|
98
|
-
> .\build\debug\bun-debug.exe --revision
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
You should add this to `$Env:PATH`. The simplest way to do so is to open the start menu, type "Path", and then navigate the environment variables menu to add `C:\.....\bun\build\debug` to the user environment variable `PATH`. You should then restart your editor (if it does not update still, log out and log back in).
|
|
102
|
-
|
|
103
|
-
## Extra paths
|
|
104
|
-
|
|
105
|
-
- WebKit is extracted to `build/debug/cache/webkit/`
|
|
106
|
-
- Zig is extracted to `build/debug/cache/zig/bin/zig.exe`
|
|
107
|
-
|
|
108
|
-
## Tests
|
|
109
|
-
|
|
110
|
-
You can run the test suite either using `bun test <path>` or by using the wrapper script `bun node:test <path>`. The `bun node:test` command runs every test file in a separate instance of bun.exe, to prevent a crash in the test runner from stopping the entire suite.
|
|
111
|
-
|
|
112
|
-
```ps1
|
|
113
|
-
# Setup
|
|
114
|
-
> bun i --cwd packages\bun-internal-test
|
|
115
|
-
|
|
116
|
-
# Run the entire test suite with reporter
|
|
117
|
-
# the package.json script "test" uses "build/debug/bun-debug.exe" by default
|
|
118
|
-
> bun run test
|
|
119
|
-
|
|
120
|
-
# Run an individual test file:
|
|
121
|
-
> bun-debug test node\fs
|
|
122
|
-
> bun-debug test "C:\bun\test\js\bun\resolve\import-meta.test.js"
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
## Troubleshooting
|
|
126
|
-
|
|
127
|
-
### .rc file fails to build
|
|
128
|
-
|
|
129
|
-
`llvm-rc.exe` is odd. don't use it. use `rc.exe`, to do this make sure you are in a visual studio dev terminal, check `rc /?` to ensure it is `Microsoft Resource Compiler`
|
|
130
|
-
|
|
131
|
-
### failed to write output 'bun-debug.exe': permission denied
|
|
132
|
-
|
|
133
|
-
you cannot overwrite `bun-debug.exe` if it is already open. you likely have a running instance, maybe in the vscode debugger?
|
package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/contributing.mdx
DELETED
|
@@ -1,388 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Contributing
|
|
3
|
-
description: Contributing to Bun
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
Configuring a development environment for Bun can take 10-30 minutes depending on your internet connection and computer speed. You will need ~10GB of free disk space for the repository and build artifacts.
|
|
7
|
-
|
|
8
|
-
If you are using Windows, please refer to [this guide](/docs/project/building-windows)
|
|
9
|
-
|
|
10
|
-
## Using Nix (Alternative)
|
|
11
|
-
|
|
12
|
-
A Nix flake is provided as an alternative to manual dependency installation:
|
|
13
|
-
|
|
14
|
-
```bash
|
|
15
|
-
nix develop
|
|
16
|
-
# or explicitly use the pure shell
|
|
17
|
-
# nix develop .#pure
|
|
18
|
-
export CMAKE_SYSTEM_PROCESSOR=$(uname -m)
|
|
19
|
-
bun bd
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
This provides all dependencies in an isolated, reproducible environment without requiring sudo.
|
|
23
|
-
|
|
24
|
-
## Install Dependencies (Manual)
|
|
25
|
-
|
|
26
|
-
Using your system's package manager, install Bun's dependencies:
|
|
27
|
-
|
|
28
|
-
<CodeGroup>
|
|
29
|
-
|
|
30
|
-
```bash macOS (Homebrew)
|
|
31
|
-
$ brew install automake cmake coreutils gnu-sed go icu4c libiconv libtool ninja pkg-config rust ruby sccache
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
```bash Ubuntu/Debian
|
|
35
|
-
$ sudo apt install curl wget lsb-release software-properties-common cargo cmake git golang libtool ninja-build pkg-config rustc ruby-full xz-utils
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
```bash Arch
|
|
39
|
-
$ sudo pacman -S base-devel cmake git go libiconv libtool make ninja pkg-config python rust sed unzip ruby
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
```bash Fedora
|
|
43
|
-
$ sudo dnf install cargo clang19 llvm19 lld19 cmake git golang libtool ninja-build pkg-config rustc ruby libatomic-static libstdc++-static sed unzip which libicu-devel 'perl(Math::BigInt)'
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
```bash openSUSE Tumbleweed
|
|
47
|
-
$ sudo zypper install go cmake ninja automake git icu rustup && rustup toolchain install stable
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
</CodeGroup>
|
|
51
|
-
|
|
52
|
-
> **Note**: The Zig compiler is automatically installed and updated by the build scripts. Manual installation is not required.
|
|
53
|
-
|
|
54
|
-
Before starting, you will need to already have a release build of Bun installed, as we use our bundler to transpile and minify our code, as well as for code generation scripts.
|
|
55
|
-
|
|
56
|
-
<CodeGroup>
|
|
57
|
-
|
|
58
|
-
```bash Native
|
|
59
|
-
$ curl -fsSL https://bun.com/install | bash
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
```bash npm
|
|
63
|
-
$ npm install -g bun
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
```bash Homebrew
|
|
67
|
-
$ brew tap oven-sh/bun
|
|
68
|
-
$ brew install bun
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
</CodeGroup>
|
|
72
|
-
|
|
73
|
-
### Optional: Install `sccache`
|
|
74
|
-
|
|
75
|
-
sccache is used to cache compilation artifacts, significantly speeding up builds. It must be installed with S3 support:
|
|
76
|
-
|
|
77
|
-
```bash
|
|
78
|
-
# For macOS
|
|
79
|
-
$ brew install sccache
|
|
80
|
-
|
|
81
|
-
# For Linux. Note that the version in your package manager may not have S3 support.
|
|
82
|
-
$ cargo install sccache --features=s3
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
This will install `sccache` with S3 support. Our build scripts will automatically detect and use `sccache` with our shared S3 cache. **Note**: Not all versions of `sccache` are compiled with S3 support, hence we recommend installing it via `cargo`.
|
|
86
|
-
|
|
87
|
-
#### Registering AWS Credentials for `sccache` (Core Developers Only)
|
|
88
|
-
|
|
89
|
-
Core developers have write access to the shared S3 cache. To enable write access, you must log in with AWS credentials. The easiest way to do this is to use the [`aws` CLI](https://aws.amazon.com/cli/) and invoke [`aws configure` to provide your AWS security info](https://docs.aws.amazon.com/cli/latest/reference/configure/).
|
|
90
|
-
|
|
91
|
-
The `cmake` scripts should automatically detect your AWS credentials from the environment or the `~/.aws/credentials` file.
|
|
92
|
-
|
|
93
|
-
<details>
|
|
94
|
-
<summary>Logging in to the `aws` CLI</summary>
|
|
95
|
-
|
|
96
|
-
1. Install the AWS CLI by following [the official guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
|
|
97
|
-
2. Log in to your AWS account console. A team member should provide you with your credentials.
|
|
98
|
-
3. Click your name in the top right > Security credentials.
|
|
99
|
-
4. Scroll to "Access keys" and create a new access key.
|
|
100
|
-
5. Run `aws configure` in your terminal and provide the access key ID and secret access key when prompted.
|
|
101
|
-
|
|
102
|
-
</details>
|
|
103
|
-
|
|
104
|
-
<details>
|
|
105
|
-
<summary>Common Issues You May Encounter</summary>
|
|
106
|
-
|
|
107
|
-
- To confirm that the cache is being used, you can use the `sccache --show-stats` command right after a build. This will expose very useful statistics, including cache hits/misses.
|
|
108
|
-
- If you have multiple AWS profiles configured, ensure that the correct profile is set in the `AWS_PROFILE` environment variable.
|
|
109
|
-
- `sccache` follows a server-client model. If you run into weird issues where `sccache` refuses to use S3, even though you have AWS credentials configured, try killing any running `sccache` servers with `sccache --stop-server` and then re-running the build.
|
|
110
|
-
|
|
111
|
-
</details>
|
|
112
|
-
|
|
113
|
-
## Install LLVM
|
|
114
|
-
|
|
115
|
-
Bun requires LLVM 19 (`clang` is part of LLVM). This version requirement is to match WebKit (precompiled), as mismatching versions will cause memory allocation failures at runtime. In most cases, you can install LLVM through your system package manager:
|
|
116
|
-
|
|
117
|
-
<CodeGroup>
|
|
118
|
-
|
|
119
|
-
```bash macOS (Homebrew)
|
|
120
|
-
$ brew install llvm@19
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
```bash Ubuntu/Debian
|
|
124
|
-
$ # LLVM has an automatic installation script that is compatible with all versions of Ubuntu
|
|
125
|
-
$ wget https://apt.llvm.org/llvm.sh -O - | sudo bash -s -- 19 all
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
```bash Arch
|
|
129
|
-
$ sudo pacman -S llvm clang lld
|
|
130
|
-
```
|
|
131
|
-
|
|
132
|
-
```bash Fedora
|
|
133
|
-
$ sudo dnf install llvm clang lld-devel
|
|
134
|
-
```
|
|
135
|
-
|
|
136
|
-
```bash openSUSE Tumbleweed
|
|
137
|
-
$ sudo zypper install clang19 lld19 llvm19
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
</CodeGroup>
|
|
141
|
-
|
|
142
|
-
If none of the above solutions apply, you will have to install it [manually](https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.7).
|
|
143
|
-
|
|
144
|
-
Make sure Clang/LLVM 19 is in your path:
|
|
145
|
-
|
|
146
|
-
```bash
|
|
147
|
-
$ which clang-19
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
If not, run this to manually add it:
|
|
151
|
-
|
|
152
|
-
<CodeGroup>
|
|
153
|
-
|
|
154
|
-
```bash macOS (Homebrew)
|
|
155
|
-
# use fish_add_path if you're using fish
|
|
156
|
-
# use path+="$(brew --prefix llvm@19)/bin" if you are using zsh
|
|
157
|
-
$ export PATH="$(brew --prefix llvm@19)/bin:$PATH"
|
|
158
|
-
```
|
|
159
|
-
|
|
160
|
-
```bash Arch
|
|
161
|
-
# use fish_add_path if you're using fish
|
|
162
|
-
$ export PATH="$PATH:/usr/lib/llvm19/bin"
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
</CodeGroup>
|
|
166
|
-
|
|
167
|
-
<Warning>
|
|
168
|
-
⚠️ Ubuntu distributions (\<= 20.04) may require installation of the C++ standard library independently. See the [troubleshooting section](#span-file-not-found-on-ubuntu) for more information.
|
|
169
|
-
</Warning>
|
|
170
|
-
|
|
171
|
-
## Building Bun
|
|
172
|
-
|
|
173
|
-
After cloning the repository, run the following command to build. This may take a while as it will clone submodules and build dependencies.
|
|
174
|
-
|
|
175
|
-
```bash
|
|
176
|
-
bun run build
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
The binary will be located at `./build/debug/bun-debug`. It is recommended to add this to your `$PATH`. To verify the build worked, let's print the version number on the development build of Bun.
|
|
180
|
-
|
|
181
|
-
```bash
|
|
182
|
-
$ build/debug/bun-debug --version
|
|
183
|
-
x.y.z_debug
|
|
184
|
-
```
|
|
185
|
-
|
|
186
|
-
## VSCode
|
|
187
|
-
|
|
188
|
-
VSCode is the recommended IDE for working on Bun, as it has been configured. Once opening, you can run `Extensions: Show Recommended Extensions` to install the recommended extensions for Zig and C++. ZLS is automatically configured.
|
|
189
|
-
|
|
190
|
-
If you use a different editor, make sure that you tell ZLS to use the automatically installed Zig compiler, which is located at `./vendor/zig/zig.exe`. The filename is `zig.exe` so that it works as expected on Windows, but it still works on macOS/Linux (it just has a surprising file extension).
|
|
191
|
-
|
|
192
|
-
We recommend adding `./build/debug` to your `$PATH` so that you can run `bun-debug` in your terminal:
|
|
193
|
-
|
|
194
|
-
```sh
|
|
195
|
-
bun-debug
|
|
196
|
-
```
|
|
197
|
-
|
|
198
|
-
## Running debug builds
|
|
199
|
-
|
|
200
|
-
The `bd` package.json script compiles and runs a debug build of Bun, only printing the output of the build process if it fails.
|
|
201
|
-
|
|
202
|
-
```sh
|
|
203
|
-
bun bd <args>
|
|
204
|
-
bun bd test foo.test.ts
|
|
205
|
-
bun bd ./foo.ts
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
Bun generally takes about 2.5 minutes to compile a debug build when there are Zig changes. If your development workflow is "change one line, save, rebuild", you will spend too much time waiting for the build to finish. Instead:
|
|
209
|
-
|
|
210
|
-
- Batch up your changes
|
|
211
|
-
- Ensure zls is running with incremental watching for LSP errors (if you use VSCode and install Zig and run `bun run build` once to download Zig, this should just work)
|
|
212
|
-
- Prefer using the debugger ("CodeLLDB" in VSCode) to step through the code.
|
|
213
|
-
- Use debug logs. `BUN_DEBUG_<scope>=1` will enable debug logging for the corresponding `Output.scoped(.<scope>, .hidden)` logs. You can also set `BUN_DEBUG_QUIET_LOGS=1` to disable all debug logging that isn't explicitly enabled. To dump debug logs into a file, `BUN_DEBUG=<path-to-file>.log`. Debug logs are aggressively removed in release builds.
|
|
214
|
-
- src/js/\*\*.ts changes are pretty much instant to rebuild. C++ changes are a bit slower, but still much faster than the Zig code (Zig is one compilation unit, C++ is many).
|
|
215
|
-
|
|
216
|
-
## Code generation scripts
|
|
217
|
-
|
|
218
|
-
Several code generation scripts are used during Bun's build process. These are run automatically when changes are made to certain files.
|
|
219
|
-
|
|
220
|
-
In particular, these are:
|
|
221
|
-
|
|
222
|
-
- `./src/codegen/generate-jssink.ts` -- Generates `build/debug/codegen/JSSink.cpp`, `build/debug/codegen/JSSink.h` which implement various classes for interfacing with `ReadableStream`. This is internally how `FileSink`, `ArrayBufferSink`, `"type": "direct"` streams and other code related to streams works.
|
|
223
|
-
- `./src/codegen/generate-classes.ts` -- Generates `build/debug/codegen/ZigGeneratedClasses*`, which generates Zig & C++ bindings for JavaScriptCore classes implemented in Zig. In `**/*.classes.ts` files, we define the interfaces for various classes, methods, prototypes, getters/setters etc which the code generator reads to generate boilerplate code implementing the JavaScript objects in C++ and wiring them up to Zig
|
|
224
|
-
- `./src/codegen/cppbind.ts` -- Generates automatic Zig bindings for C++ functions marked with `[[ZIG_EXPORT]]` attributes.
|
|
225
|
-
- `./src/codegen/bundle-modules.ts` -- Bundles built-in modules like `node:fs`, `bun:ffi` into files we can include in the final binary. In development, these can be reloaded without rebuilding Zig (you still need to run `bun run build`, but it re-reads the transpiled files from disk afterwards). In release builds, these are embedded into the binary.
|
|
226
|
-
- `./src/codegen/bundle-functions.ts` -- Bundles globally-accessible functions implemented in JavaScript/TypeScript like `ReadableStream`, `WritableStream`, and a handful more. These are used similarly to the builtin modules, but the output more closely aligns with what WebKit/Safari does for Safari's built-in functions so that we can copy-paste the implementations from WebKit as a starting point.
|
|
227
|
-
|
|
228
|
-
## Modifying ESM modules
|
|
229
|
-
|
|
230
|
-
Certain modules like `node:fs`, `node:stream`, `bun:sqlite`, and `ws` are implemented in JavaScript. These live in `src/js/{node,bun,thirdparty}` files and are pre-bundled using Bun.
|
|
231
|
-
|
|
232
|
-
## Release build
|
|
233
|
-
|
|
234
|
-
To compile a release build of Bun, run:
|
|
235
|
-
|
|
236
|
-
```bash
|
|
237
|
-
bun run build:release
|
|
238
|
-
```
|
|
239
|
-
|
|
240
|
-
The binary will be located at `./build/release/bun` and `./build/release/bun-profile`.
|
|
241
|
-
|
|
242
|
-
### Download release build from pull requests
|
|
243
|
-
|
|
244
|
-
To save you time spent building a release build locally, we provide a way to run release builds from pull requests. This is useful for manually testing changes in a release build before they are merged.
|
|
245
|
-
|
|
246
|
-
To run a release build from a pull request, you can use the `bun-pr` npm package:
|
|
247
|
-
|
|
248
|
-
```sh
|
|
249
|
-
bunx bun-pr <pr-number>
|
|
250
|
-
bunx bun-pr <branch-name>
|
|
251
|
-
bunx bun-pr "https://github.com/oven-sh/bun/pull/1234566"
|
|
252
|
-
bunx bun-pr --asan <pr-number> # Linux x64 only
|
|
253
|
-
```
|
|
254
|
-
|
|
255
|
-
This will download the release build from the pull request and add it to `$PATH` as `bun-${pr-number}`. You can then run the build with `bun-${pr-number}`.
|
|
256
|
-
|
|
257
|
-
```sh
|
|
258
|
-
bun-1234566 --version
|
|
259
|
-
```
|
|
260
|
-
|
|
261
|
-
This works by downloading the release build from the GitHub Actions artifacts on the linked pull request. You may need the `gh` CLI installed to authenticate with GitHub.
|
|
262
|
-
|
|
263
|
-
## AddressSanitizer
|
|
264
|
-
|
|
265
|
-
[AddressSanitizer](https://en.wikipedia.org/wiki/AddressSanitizer) helps find memory issues, and is enabled by default in debug builds of Bun on Linux and macOS. This includes the Zig code and all dependencies. It makes the Zig code take about 2x longer to build, if that's stopping you from being productive you can disable it by setting `-Denable_asan=$<IF:$<BOOL:${ENABLE_ASAN}>,true,false>` to `-Denable_asan=false` in the `cmake/targets/BuildBun.cmake` file, but generally we recommend batching your changes up between builds.
|
|
266
|
-
|
|
267
|
-
To build a release build with Address Sanitizer, run:
|
|
268
|
-
|
|
269
|
-
```bash
|
|
270
|
-
bun run build:release:asan
|
|
271
|
-
```
|
|
272
|
-
|
|
273
|
-
In CI, we run our test suite with at least one target that is built with Address Sanitizer.
|
|
274
|
-
|
|
275
|
-
## Building WebKit locally + Debug mode of JSC
|
|
276
|
-
|
|
277
|
-
WebKit is not cloned by default (to save time and disk space). To clone and build WebKit locally, run:
|
|
278
|
-
|
|
279
|
-
```bash
|
|
280
|
-
# Clone WebKit into ./vendor/WebKit
|
|
281
|
-
$ git clone https://github.com/oven-sh/WebKit vendor/WebKit
|
|
282
|
-
|
|
283
|
-
# Check out the commit hash specified in `set(WEBKIT_VERSION <commit_hash>)` in cmake/tools/SetupWebKit.cmake
|
|
284
|
-
$ git -C vendor/WebKit checkout <commit_hash>
|
|
285
|
-
|
|
286
|
-
# Make a debug build of JSC. This will output build artifacts in ./vendor/WebKit/WebKitBuild/Debug
|
|
287
|
-
# Optionally, you can use `bun run jsc:build` for a release build
|
|
288
|
-
bun run jsc:build:debug && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
|
|
289
|
-
|
|
290
|
-
# After an initial run of `make jsc-debug`, you can rebuild JSC with:
|
|
291
|
-
$ cmake --build vendor/WebKit/WebKitBuild/Debug --target jsc && rm vendor/WebKit/WebKitBuild/Debug/JavaScriptCore/DerivedSources/inspector/InspectorProtocolObjects.h
|
|
292
|
-
|
|
293
|
-
# Build bun with the local JSC build
|
|
294
|
-
bun run build:local
|
|
295
|
-
```
|
|
296
|
-
|
|
297
|
-
Using `bun run build:local` will build Bun in the `./build/debug-local` directory (instead of `./build/debug`), you'll have to change a couple of places to use this new directory:
|
|
298
|
-
|
|
299
|
-
- The first line in `src/js/builtins.d.ts`
|
|
300
|
-
- The `CompilationDatabase` line in `.clangd` config should be `CompilationDatabase: build/debug-local`
|
|
301
|
-
- In `build.zig`, the `codegen_path` option should be `build/debug-local/codegen` (instead of `build/debug/codegen`)
|
|
302
|
-
- In `.vscode/launch.json`, many configurations use `./build/debug/`, change them as you see fit
|
|
303
|
-
|
|
304
|
-
Note that the WebKit folder, including build artifacts, is 8GB+ in size.
|
|
305
|
-
|
|
306
|
-
If you are using a JSC debug build and using VScode, make sure to run the `C/C++: Select a Configuration` command to configure intellisense to find the debug headers.
|
|
307
|
-
|
|
308
|
-
Note that if you change make changes to our [WebKit fork](https://github.com/oven-sh/WebKit), you will also have to change `SetupWebKit.cmake` to point to the commit hash.
|
|
309
|
-
|
|
310
|
-
## Troubleshooting
|
|
311
|
-
|
|
312
|
-
### 'span' file not found on Ubuntu
|
|
313
|
-
|
|
314
|
-
<Warning>
|
|
315
|
-
⚠️ Please note that the instructions below are specific to issues occurring on Ubuntu. It is unlikely that the same
|
|
316
|
-
issues will occur on other Linux distributions.
|
|
317
|
-
</Warning>
|
|
318
|
-
|
|
319
|
-
The Clang compiler typically uses the `libstdc++` C++ standard library by default. `libstdc++` is the default C++ Standard Library implementation provided by the GNU Compiler Collection (GCC). While Clang may link against the `libc++` library, this requires explicitly providing the `-stdlib` flag when running Clang.
|
|
320
|
-
|
|
321
|
-
Bun relies on C++20 features like `std::span`, which are not available in GCC versions lower than 11. GCC 10 doesn't have all of the C++20 features implemented. As a result, running `make setup` may fail with the following error:
|
|
322
|
-
|
|
323
|
-
```txt
|
|
324
|
-
fatal error: 'span' file not found
|
|
325
|
-
#include <span>
|
|
326
|
-
^~~~~~
|
|
327
|
-
```
|
|
328
|
-
|
|
329
|
-
The issue may manifest when initially running `bun setup` as Clang being unable to compile a simple program:
|
|
330
|
-
|
|
331
|
-
```txt
|
|
332
|
-
The C++ compiler
|
|
333
|
-
|
|
334
|
-
"/usr/bin/clang++-19"
|
|
335
|
-
|
|
336
|
-
is not able to compile a simple test program.
|
|
337
|
-
```
|
|
338
|
-
|
|
339
|
-
To fix the error, we need to update the GCC version to 11. To do this, we'll need to check if the latest version is available in the distribution's official repositories or use a third-party repository that provides GCC 11 packages. Here are general steps:
|
|
340
|
-
|
|
341
|
-
```bash
|
|
342
|
-
$ sudo apt update
|
|
343
|
-
$ sudo apt install gcc-11 g++-11
|
|
344
|
-
# If the above command fails with `Unable to locate package gcc-11` we need
|
|
345
|
-
# to add the APT repository
|
|
346
|
-
$ sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
|
|
347
|
-
# Now run `apt install` again
|
|
348
|
-
$ sudo apt install gcc-11 g++-11
|
|
349
|
-
```
|
|
350
|
-
|
|
351
|
-
Now, we need to set GCC 11 as the default compiler:
|
|
352
|
-
|
|
353
|
-
```bash
|
|
354
|
-
$ sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 100
|
|
355
|
-
$ sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-11 100
|
|
356
|
-
```
|
|
357
|
-
|
|
358
|
-
### libarchive
|
|
359
|
-
|
|
360
|
-
If you see an error on macOS when compiling `libarchive`, run:
|
|
361
|
-
|
|
362
|
-
```bash
|
|
363
|
-
$ brew install pkg-config
|
|
364
|
-
```
|
|
365
|
-
|
|
366
|
-
### macOS `library not found for -lSystem`
|
|
367
|
-
|
|
368
|
-
If you see this error when compiling, run:
|
|
369
|
-
|
|
370
|
-
```bash
|
|
371
|
-
$ xcode-select --install
|
|
372
|
-
```
|
|
373
|
-
|
|
374
|
-
### Cannot find `libatomic.a`
|
|
375
|
-
|
|
376
|
-
Bun defaults to linking `libatomic` statically, as not all systems have it. If you are building on a distro that does not have a static libatomic available, you can run the following command to enable dynamic linking:
|
|
377
|
-
|
|
378
|
-
```bash
|
|
379
|
-
bun run build -DUSE_STATIC_LIBATOMIC=OFF
|
|
380
|
-
```
|
|
381
|
-
|
|
382
|
-
The built version of Bun may not work on other systems if compiled this way.
|
|
383
|
-
|
|
384
|
-
## Using bun-debug
|
|
385
|
-
|
|
386
|
-
- Disable logging: `BUN_DEBUG_QUIET_LOGS=1 bun-debug ...` (to disable all debug logging)
|
|
387
|
-
- Enable logging for a specific zig scope: `BUN_DEBUG_EventLoop=1 bun-debug ...` (to allow `std.log.scoped(.EventLoop)`)
|
|
388
|
-
- Bun transpiles every file it runs, to see the actual executed source in a debug build find it in `/tmp/bun-debug-src/...path/to/file`, for example the transpiled version of `/home/bun/index.ts` would be in `/tmp/bun-debug-src/home/bun/index.ts`
|
package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/feedback.mdx
DELETED
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: bun feedback
|
|
3
|
-
description: Share feedback, bug reports, and feature requests
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
import Feedback from "/snippets/cli/feedback.mdx";
|
|
7
|
-
|
|
8
|
-
Use `bun feedback` to share feedback, bug reports, and feature requests directly with the Bun team.
|
|
9
|
-
|
|
10
|
-
```bash terminal icon="terminal"
|
|
11
|
-
bun feedback "Love the new release!"
|
|
12
|
-
bun feedback report.txt details.log
|
|
13
|
-
echo "please document X" | bun feedback --email you@example.com
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
You can provide feedback as text arguments, file paths, or piped input.
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
<Feedback />
|
package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/license.mdx
DELETED
|
@@ -1,78 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: License
|
|
3
|
-
description: License for Bun
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
Bun itself is MIT-licensed.
|
|
7
|
-
|
|
8
|
-
## JavaScriptCore
|
|
9
|
-
|
|
10
|
-
Bun statically links JavaScriptCore (and WebKit) which is LGPL-2 licensed. WebCore files from WebKit are also licensed under LGPL2. Per LGPL2:
|
|
11
|
-
|
|
12
|
-
> (1) If you statically link against an LGPL'd library, you must also provide your application in an object (not necessarily source) format, so that a user has the opportunity to modify the library and relink the application.
|
|
13
|
-
|
|
14
|
-
You can find the patched version of WebKit used by Bun here: https://github.com/oven-sh/webkit. If you would like to relink Bun with changes:
|
|
15
|
-
|
|
16
|
-
- `git submodule update --init --recursive`
|
|
17
|
-
- `make jsc`
|
|
18
|
-
- `zig build`
|
|
19
|
-
|
|
20
|
-
This compiles JavaScriptCore, compiles Bun's `.cpp` bindings for JavaScriptCore (which are the object files using JavaScriptCore) and outputs a new `bun` binary with your changes.
|
|
21
|
-
|
|
22
|
-
## Linked libraries
|
|
23
|
-
|
|
24
|
-
Bun statically links these libraries:
|
|
25
|
-
|
|
26
|
-
| Library | License |
|
|
27
|
-
| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
|
|
28
|
-
| [`boringssl`](https://boringssl.googlesource.com/boringssl/) | [several licenses](https://boringssl.googlesource.com/boringssl/+/refs/heads/master/LICENSE) |
|
|
29
|
-
| [`brotli`](https://github.com/google/brotli) | MIT |
|
|
30
|
-
| [`libarchive`](https://github.com/libarchive/libarchive) | [several licenses](https://github.com/libarchive/libarchive/blob/master/COPYING) |
|
|
31
|
-
| [`lol-html`](https://github.com/cloudflare/lol-html/tree/master/c-api) | BSD 3-Clause |
|
|
32
|
-
| [`mimalloc`](https://github.com/microsoft/mimalloc) | MIT |
|
|
33
|
-
| [`picohttp`](https://github.com/h2o/picohttpparser) | dual-licensed under the Perl License or the MIT License |
|
|
34
|
-
| [`zstd`](https://github.com/facebook/zstd) | dual-licensed under the BSD License or GPLv2 license |
|
|
35
|
-
| [`simdutf`](https://github.com/simdutf/simdutf) | Apache 2.0 |
|
|
36
|
-
| [`tinycc`](https://github.com/tinycc/tinycc) | LGPL v2.1 |
|
|
37
|
-
| [`uSockets`](https://github.com/uNetworking/uSockets) | Apache 2.0 |
|
|
38
|
-
| [`zlib-cloudflare`](https://github.com/cloudflare/zlib) | zlib |
|
|
39
|
-
| [`c-ares`](https://github.com/c-ares/c-ares) | MIT licensed |
|
|
40
|
-
| [`libicu`](https://github.com/unicode-org/icu) 72 | [license here](https://github.com/unicode-org/icu/blob/main/icu4c/LICENSE) |
|
|
41
|
-
| [`libbase64`](https://github.com/aklomp/base64/blob/master/LICENSE) | BSD 2-Clause |
|
|
42
|
-
| [`libuv`](https://github.com/libuv/libuv) (on Windows) | MIT |
|
|
43
|
-
| [`libdeflate`](https://github.com/ebiggers/libdeflate) | MIT |
|
|
44
|
-
| A fork of [`uWebsockets`](https://github.com/jarred-sumner/uwebsockets) | Apache 2.0 licensed |
|
|
45
|
-
| Parts of [Tigerbeetle's IO code](https://github.com/tigerbeetle/tigerbeetle/blob/532c8b70b9142c17e07737ab6d3da68d7500cbca/src/io/windows.zig#L1) | Apache 2.0 licensed |
|
|
46
|
-
|
|
47
|
-
## Polyfills
|
|
48
|
-
|
|
49
|
-
For compatibility reasons, the following packages are embedded into Bun's binary and injected if imported.
|
|
50
|
-
|
|
51
|
-
| Package | License |
|
|
52
|
-
| ------------------------------------------------------------------------ | ------- |
|
|
53
|
-
| [`assert`](https://npmjs.com/package/assert) | MIT |
|
|
54
|
-
| [`browserify-zlib`](https://npmjs.com/package/browserify-zlib) | MIT |
|
|
55
|
-
| [`buffer`](https://npmjs.com/package/buffer) | MIT |
|
|
56
|
-
| [`constants-browserify`](https://npmjs.com/package/constants-browserify) | MIT |
|
|
57
|
-
| [`crypto-browserify`](https://npmjs.com/package/crypto-browserify) | MIT |
|
|
58
|
-
| [`domain-browser`](https://npmjs.com/package/domain-browser) | MIT |
|
|
59
|
-
| [`events`](https://npmjs.com/package/events) | MIT |
|
|
60
|
-
| [`https-browserify`](https://npmjs.com/package/https-browserify) | MIT |
|
|
61
|
-
| [`os-browserify`](https://npmjs.com/package/os-browserify) | MIT |
|
|
62
|
-
| [`path-browserify`](https://npmjs.com/package/path-browserify) | MIT |
|
|
63
|
-
| [`process`](https://npmjs.com/package/process) | MIT |
|
|
64
|
-
| [`punycode`](https://npmjs.com/package/punycode) | MIT |
|
|
65
|
-
| [`querystring-es3`](https://npmjs.com/package/querystring-es3) | MIT |
|
|
66
|
-
| [`stream-browserify`](https://npmjs.com/package/stream-browserify) | MIT |
|
|
67
|
-
| [`stream-http`](https://npmjs.com/package/stream-http) | MIT |
|
|
68
|
-
| [`string_decoder`](https://npmjs.com/package/string_decoder) | MIT |
|
|
69
|
-
| [`timers-browserify`](https://npmjs.com/package/timers-browserify) | MIT |
|
|
70
|
-
| [`tty-browserify`](https://npmjs.com/package/tty-browserify) | MIT |
|
|
71
|
-
| [`url`](https://npmjs.com/package/url) | MIT |
|
|
72
|
-
| [`util`](https://npmjs.com/package/util) | MIT |
|
|
73
|
-
| [`vm-browserify`](https://npmjs.com/package/vm-browserify) | MIT |
|
|
74
|
-
|
|
75
|
-
## Additional credits
|
|
76
|
-
|
|
77
|
-
- Bun's JS transpiler, CSS lexer, and Node.js module resolver source code is a Zig port of [@evanw](https://github.com/evanw)’s [esbuild](https://github.com/evanw/esbuild) project.
|
|
78
|
-
- Credit to [@kipply](https://github.com/kipply) for the name "Bun"!
|
package/packages/shared/node_modules/@types/bun/node_modules/bun-types/docs/project/roadmap.mdx
DELETED
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
title: Roadmap
|
|
3
|
-
description: Bun's roadmap and long-term plans
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
Bun is a project with an incredibly large scope and is still in its early days. Long-term, Bun aims to provide an all-in-one toolkit to replace the complex, fragmented toolchains common today: Node.js, Jest, Webpack, esbuild, Babel, yarn, PostCSS, etc.
|
|
7
|
-
|
|
8
|
-
Refer to [Bun's Roadmap](https://github.com/oven-sh/bun/issues/159) on GitHub to learn more about the project's long-term plans and priorities.
|