⍺

Author: darkobits

.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: ci
+on:
+  push:
+    paths-ignore:
+      - "**.md"
+  pull_request:
+    paths-ignore:
+      - "**.md"
+env:
+  FORCE_COLOR: 3
+concurrency:
+  group: ${{ github.ref }}
+  # Only cancel concurrent builds when we are not on the default branch. This
+  # way, if a commit breaks the default branch, we can more easily determine
+  # which commit caused the failure.
+  cancel-in-progress: ${{ github.ref != github.event.repository.default_branch }}
+jobs:
+  ci:
+    name: CI
+    # Skip building tags; an identical job for the commit to which the tag
+    # points will be triggered, making tag-based jobs superfluous.
+    if: github.ref_type != 'tag'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
+      - name: Install Dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Test
+        run: pnpm test:coverage
+
+      - name: Build
+        run: pnpm build

.gitignore

@@ -0,0 +1,96 @@
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+/NOTES.md
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Typescript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+# next.js build output
+.next
+
+# Claude Code
+.claude
+
+# Build artifacts
+dist/

.nvmrc

@@ -0,0 +1 @@
+lts/*

.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "[javascript][typescript][javascriptreact][typescriptreact][json][jsonc]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit"
+    }
+  },
+  "cSpell.words": [
+    "publint",
+    "tsdown",
+    "unbundle"
+  ]
+}

README.md

@@ -0,0 +1,11 @@
+This is a template repository that can be used to quickly bootstrap new Node
+libraries. The minimal but robust toolchain consists of [`tsdown`][tsdown],
+[`vitest`][vitest], [`eslint`][eslint], and [`release-it`][release-it].
+
+Click **Use this template** at the top-right of this page to clone this
+repository.
+
+[tsdown]: https://tsdown.dev
+[vitest]: https://vitest.dev
+[eslint]: https://www.eslint.org
+[release-it]: https://github.com/release-it/release-it

eslint.config.ts

@@ -0,0 +1,4 @@
+import { configs } from '@darkobits/eslint-config'
+import { defineConfig } from 'eslint/config'
+
+export default defineConfig(configs.ts)

package.json

@@ -0,0 +1,54 @@
+{
+  "name": "project-name-here",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Project description here.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://repository/url/here.git"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Author Name Here <author.name.here@email.com>",
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./lib/add": "./dist/lib/add.js",
+    "./lib/subtract": "./dist/lib/subtract.js",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch src",
+    "lint": "eslint --cache",
+    "lint:fix": "eslint --fix --cache",
+    "test": "vitest --run",
+    "test:coverage": "vitest --run --coverage",
+    "test:watch": "vitest",
+    "tsc": "tsc",
+    "tsc:watch": "tsc --watch"
+  },
+  "devDependencies": {
+    "@darkobits/eslint-config": "4.0.0-beta.7",
+    "@types/node": "^24.0.7",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^9.36.0",
+    "publint": "^0.3.12",
+    "tsdown": "^0.12.9",
+    "typescript": "^5.8.3",
+    "unplugin-unused": "^0.5.1",
+    "vitest": "^3.2.4"
+  },
+  "packageManager": "pnpm@10.22.0",
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=10"
+  },
+  "engineStrict": true
+}