@jterrazz/typescript 4.3.0 → 5.0.0

package/README.md

@@ -2,10 +2,6 @@
 
 Drop-in TypeScript build tooling with zero configuration.
 
-## About
-
-_Hey there – I'm Jean-Baptiste, just another developer doing weird things with code. All my projects live on [jterrazz.com](https://jterrazz.com) – complete with backstories and lessons learned. Feel free to poke around – you might just find something useful!_
-
 ## Installation
 
 ```bash
@@ -26,30 +22,30 @@ npm install @jterrazz/typescript
 ### 2. Use the CLI
 
 ```bash
-npx typescript watch       # Watch mode (build + run on changes)
-npx typescript build --app # Production build (ESM + types)
-npx typescript build --lib # Library build (ESM + CJS + types)
+npx typescript build       # Build application (ESM + types)
+npx typescript bundle      # Bundle library (ESM + CJS + types)
+npx typescript start       # Run the built application
+npx typescript dev         # Build, run, and rebuild on changes
 ```
 
 ## What you get
 
-- **Blazing fast** — Powered by [Rolldown](https://rolldown.rs) (Rust) and [tsgo](https://github.com/nicolo-ribaudo/typescript-go) (Go)
+- **Blazing fast** — Powered by [tsdown](https://tsdown.dev) / [Rolldown](https://rolldown.rs) (Rust)
 - **Zero configuration** — Works out of the box
 - **Multiple outputs** — ESM + CommonJS + TypeScript declarations
 - **Source maps** — Full debugging support
 
 ### Build outputs
 
-| Command                  | Output            | Description                     |
-| ------------------------ | ----------------- | ------------------------------- |
-| `typescript watch`       | `dist/index.js`   | ESM only, fast rebuilds (~20ms) |
-| `typescript build --app` | `dist/index.js`   | ESM bundle                      |
-|                          | `dist/index.d.ts` | TypeScript declarations         |
-| `typescript build --lib` | `dist/index.js`   | ESM bundle                      |
-|                          | `dist/index.cjs`  | CommonJS bundle                 |
-|                          | `dist/index.d.ts` | TypeScript declarations         |
-
-If `src/instrumentation.ts` exists, it will also generate corresponding `instrumentation.*` files.
+| Command             | Output            | Description             |
+| ------------------- | ----------------- | ----------------------- |
+| `typescript build`  | `dist/index.js`   | ESM bundle              |
+|                     | `dist/index.d.ts` | TypeScript declarations |
+| `typescript bundle` | `dist/index.js`   | ESM bundle              |
+|                     | `dist/index.cjs`  | CommonJS bundle         |
+|                     | `dist/index.d.ts` | TypeScript declarations |
+| `typescript start`  | —                 | Runs `dist/index.js`    |
+| `typescript dev`    | `dist/index.js`   | Watch + rebuild + run   |
 
 ## Project structure
 
@@ -66,11 +62,11 @@ your-project/
 
 The package uses a fully compiled toolchain — no JavaScript in the hot path:
 
-| Step         | Tool                                                    | Language |
-| ------------ | ------------------------------------------------------- | -------- |
-| Transpile    | [Oxc](https://oxc.rs) (via Rolldown)                    | Rust     |
-| Bundle       | [Rolldown](https://rolldown.rs)                         | Rust     |
-| Declarations | [tsgo](https://github.com/nicolo-ribaudo/typescript-go) | Go       |
+| Step         | Tool                                  | Language |
+| ------------ | ------------------------------------- | -------- |
+| Transpile    | [Oxc](https://oxc.rs) (via tsdown)    | Rust     |
+| Bundle       | [Rolldown](https://rolldown.rs)       | Rust     |
+| Declarations | [tsdown](https://tsdown.dev) built-in | Rust     |
 
 ## License
 

package/bin/typescript.sh

@@ -27,84 +27,79 @@ done
 SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
 PACKAGE_ROOT="$SCRIPT_DIR/.."
 
-# Use binaries from the package's node_modules
-ROLLDOWN="$PACKAGE_ROOT/node_modules/.bin/rolldown"
-NODEMON="$PACKAGE_ROOT/node_modules/.bin/nodemon"
-
-# Add package's node_modules/.bin to PATH so plugins can find binaries like tsgo
-export PATH="$PACKAGE_ROOT/node_modules/.bin:$PATH"
+# Find binaries - check package's node_modules first, then project's (handles npm hoisting)
+find_binary() {
+    local name="$1"
+    if [ -x "$PACKAGE_ROOT/node_modules/.bin/$name" ]; then
+        echo "$PACKAGE_ROOT/node_modules/.bin/$name"
+    elif [ -x "$PROJECT_ROOT/node_modules/.bin/$name" ]; then
+        echo "$PROJECT_ROOT/node_modules/.bin/$name"
+    else
+        echo "$name"  # Fallback to PATH
+    fi
+}
+
+TSDOWN=$(find_binary tsdown)
 
 # Parse command
 COMMAND="$1"
 shift 2>/dev/null || true
 
+run_tsdown() {
+    local CONFIG_PATH="$1"
+    local LABEL="$2"
+
+    printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} ${LABEL}...\n\n"
+
+    cd "$PROJECT_ROOT"
+
+    if ! "$TSDOWN" --config "$CONFIG_PATH" --cwd "$PROJECT_ROOT"; then
+        printf "${RED}Error: Build failed${NC}\n"
+        exit 1
+    fi
+
+    printf "\n${GREEN}Build completed${NC}\n"
+}
+
 case "$COMMAND" in
     build)
-        # Parse build arguments (required: --app or --lib)
-        BUILD_MODE=""
-        for arg in "$@"; do
-            case $arg in
-                --lib)
-                    BUILD_MODE="lib"
-                    ;;
-                --app)
-                    BUILD_MODE="app"
-                    ;;
-            esac
-        done
-
-        if [ -z "$BUILD_MODE" ]; then
-            printf "${RED}Error: Build mode required. Use --app or --lib${NC}\n\n"
-            printf "  --app  Build for applications (ESM + types)\n"
-            printf "  --lib  Build for libraries (ESM + CJS + types)\n"
-            exit 1
-        fi
-
-        CONFIG_PATH="$SCRIPT_DIR/../config/rolldown.build.config.js"
-
-        printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} Building with Rolldown (${BUILD_MODE} mode)...\n\n"
-        printf "Project root: %s\n" "$PROJECT_ROOT"
-        printf "Config path: %s\n\n" "$CONFIG_PATH"
-
-        cd "$PROJECT_ROOT"
+        run_tsdown "$SCRIPT_DIR/../config/tsdown.build.ts" "Building application (ESM + types)"
+        ;;
 
-        if ! BUILD_MODE="$BUILD_MODE" "$ROLLDOWN" --config "$CONFIG_PATH"; then
-            printf "${RED}Error: Build failed${NC}\n"
-            exit 1
-        fi
+    bundle)
+        run_tsdown "$SCRIPT_DIR/../config/tsdown.bundle.ts" "Bundling library (ESM + CJS + types)"
+        ;;
 
-        printf "\n${GREEN}Build completed${NC}\n"
+    start)
+        cd "$PROJECT_ROOT"
+        exec node --enable-source-maps dist/index.js "$@"
         ;;
 
-    watch)
-        CONFIG_PATH="$SCRIPT_DIR/../config/rolldown.dev.config.js"
+    dev)
+        CONFIG_PATH="$SCRIPT_DIR/../config/tsdown.build.ts"
 
-        printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} Starting watch mode...\n\n"
-        printf "Project root: %s\n" "$PROJECT_ROOT"
-        printf "Config path: %s\n" "$CONFIG_PATH"
-        printf "Watching: %s/src\n\n" "$PROJECT_ROOT"
+        printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} Starting dev mode...\n\n"
 
         cd "$PROJECT_ROOT"
 
-        "$NODEMON" --quiet \
-            --watch src \
-            --ext 'ts,tsx,js,json' \
-            --exec "if OUTPUT=\$(\"$ROLLDOWN\" --config \"$CONFIG_PATH\" 2>&1); then printf '${GREEN}Rebuilt${NC}\n'; node --enable-source-maps dist/index.js; else echo \"\$OUTPUT\" | grep -v 'tsgo.*experimental' | grep -v 'PLUGIN_TIMINGS'; exit 1; fi"
+        "$TSDOWN" --config "$CONFIG_PATH" --cwd "$PROJECT_ROOT" \
+            --watch \
+            --on-success "node --enable-source-maps dist/index.js"
         ;;
 
     *)
         printf "${CYAN_BG}${BRIGHT_WHITE} TYPESCRIPT ${NC} TypeScript/Node project toolkit\n\n"
-        printf "Usage: typescript <command> [options]\n\n"
+        printf "Usage: typescript <command>\n\n"
         printf "Commands:\n"
-        printf "  build    Build the project\n"
-        printf "  watch    Start watch mode (build + run on changes)\n\n"
-        printf "Build options:\n"
-        printf "  --app    Build for applications (ESM + types)\n"
-        printf "  --lib    Build for libraries (ESM + CJS + types)\n\n"
+        printf "  build     Build application (ESM + types)\n"
+        printf "  bundle    Bundle library (ESM + CJS + types)\n"
+        printf "  start     Run the built application\n"
+        printf "  dev       Build, run, and rebuild on changes\n\n"
         printf "Examples:\n"
-        printf "  typescript build --lib\n"
-        printf "  typescript build --app\n"
-        printf "  typescript watch\n"
+        printf "  typescript build\n"
+        printf "  typescript bundle\n"
+        printf "  typescript start\n"
+        printf "  typescript dev\n"
         exit 1
         ;;
 esac

package/config/tsdown.build.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  hash: false,
+  outExtensions: () => ({
+    js: ".js",
+  }),
+});

package/config/tsdown.bundle.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm", "cjs"],
+  dts: true,
+  sourcemap: true,
+  clean: true,
+  hash: false,
+  outExtensions: ({ format }) => ({
+    js: format === "cjs" ? ".cjs" : ".js",
+  }),
+});

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@jterrazz/typescript",
-  "version": "4.3.0",
+  "version": "5.0.0",
   "author": "Jean-Baptiste Terrazzoni <contact@jterrazz.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jterrazz/package-typescript"
+  },
   "bin": {
     "typescript": "bin/typescript.sh"
   },
@@ -21,22 +25,11 @@
     "build": "# no build script"
   },
   "dependencies": {
-    "@typescript/native-preview": "^7.0.0-dev.20260124.1",
-    "nodemon": "3.1.11",
-    "rolldown": "^1.0.0-rc.1",
-    "rolldown-plugin-dts": "^0.21.6"
+    "tsdown": "^0.21.5"
   },
   "devDependencies": {
     "@jterrazz/codestyle": "^1.2.6",
-    "@types/node": "^25.0.10",
-    "vitest": "^4.0.18"
-  },
-  "peerDependencies": {
-    "@types/node": "*"
-  },
-  "peerDependenciesMeta": {
-    "@types/node": {
-      "optional": true
-    }
+    "@types/node": "^25.5.0",
+    "vitest": "^4.1.2"
   }
 }

package/tsconfig/expo.json

@@ -1,6 +1,7 @@
 {
   "display": "Expo",
-  "include": ["../../../../src/"],
+  "include": ["../../../../**/*.ts", "../../../../**/*.tsx"],
+  "exclude": ["../../../../node_modules"],
 
   "compilerOptions": {
     "allowJs": true,

package/tsconfig/node.json

@@ -1,6 +1,7 @@
 {
   "display": "Node ESM",
-  "include": ["../../../../src/"],
+  "include": ["../../../../**/*.ts"],
+  "exclude": ["../../../../node_modules"],
 
   "compilerOptions": {
     "moduleResolution": "Bundler",

package/config/rolldown.build.config.js

@@ -1,46 +0,0 @@
-import { existsSync } from "node:fs";
-import { defineConfig } from "rolldown";
-import { dts } from "rolldown-plugin-dts";
-
-// Build mode: 'lib' = ESM + CJS + types, 'app' = ESM + types only
-const isLibrary = process.env.BUILD_MODE === "lib";
-
-// Externalize all dependencies (node built-ins + node_modules)
-const external = [/node_modules/, /^node:/, /^[a-z@]/];
-
-// Build input with optional instrumentation entry point
-const input = {
-  index: "src/index.ts",
-  ...(existsSync("src/instrumentation.ts") && { instrumentation: "src/instrumentation.ts" }),
-};
-
-// ESM build with .d.ts generation
-const esmBuild = defineConfig({
-  input,
-  external,
-  plugins: [
-    dts({
-      // Use TypeScript Go for fastest .d.ts generation (experimental)
-      tsgo: true,
-    }),
-  ],
-  output: {
-    dir: "dist",
-    format: "esm",
-    sourcemap: true,
-  },
-});
-
-// CJS build (no dts - already generated by ESM build)
-const cjsBuild = defineConfig({
-  input,
-  external,
-  output: {
-    dir: "dist",
-    entryFileNames: "[name].cjs",
-    format: "cjs",
-    sourcemap: true,
-  },
-});
-
-export default isLibrary ? [esmBuild, cjsBuild] : [esmBuild];

package/config/rolldown.dev.config.js

@@ -1,20 +0,0 @@
-import { existsSync } from "node:fs";
-import { defineConfig } from "rolldown";
-
-// Build input with optional instrumentation entry point
-const input = {
-  index: "src/index.ts",
-  ...(existsSync("src/instrumentation.ts") && { instrumentation: "src/instrumentation.ts" }),
-};
-
-// Dev build - ESM only, no .d.ts (faster rebuilds)
-// Externalize all dependencies for Node.js apps
-export default defineConfig({
-  input,
-  external: [/node_modules/, /^node:/, /^[a-z@]/],
-  output: {
-    dir: "dist",
-    format: "esm",
-    sourcemap: true,
-  },
-});