@morda-dev/create-sdk 1.1.0 → 1.1.3

package/README.md

@@ -1,51 +1,123 @@
-# create-sdk
-
-Scaffold a production-ready TypeScript SDK with a strict public API.
-
-## 🚀 Quick start
-
-```bash
-npx @morda-dev/create-sdk my-sdk
-cd my-sdk
-npm install
-npm run build
-```
-
-## ✨ What you get
-
-⚡ TypeScript + ESM out of the box
-
-🔒 Strict public API enforcement (API Extractor)
-
-🧪 CI-ready project structure
-
-📦 Clean SDK architecture
-
-🚫 No accidental exports
-
-## 📁 Project structure
-src/
-  index.ts        # public API surface
-  modules/        # internal implementation
-  types/          # public types
-
-  Only symbols exported from src/index.ts are considered public.
-
-## 📜 Available scripts
-npm run build      # build the SDK
-npm run api:check  # validate public API
-
-## 🧠 Philosophy
-
-This CLI helps you build SDKs with a stable and explicit public API.
-
-Anything not exported from src/index.ts is treated as private by default.
-This prevents accidental breaking changes and enforces long-term stability.
-
-## ⚙️ Requirements
-
-Node.js >= 18
-
-## 📄 License
-
-ISC
+# create-sdk
+![npm](https://img.shields.io/npm/v/@morda-dev/create-sdk)
+![npm downloads](https://img.shields.io/npm/dm/@morda-dev/create-sdk)
+![CI](https://github.com/mordaHQ/create-sdk/actions/workflows/ci.yml/badge.svg)
+
+> Scaffold a **production-ready TypeScript SDK** with a **strict public API**.
+
+`create-sdk` is a CLI tool that bootstraps a modern TypeScript SDK with
+**ESM-first setup**, **API Extractor**, and **CI-ready structure** — so you
+can focus on features, not boilerplate.
+
+---
+
+## ✨ Features
+
+- ⚡ **Interactive CLI** (or fully automated with flags)
+- 📦 **ESM-first TypeScript setup**
+- 🔒 **Strict public API** via API Extractor
+- 🧪 **CI-verified & smoke-tested**
+- 🧱 Clean, scalable project structure
+- 🚫 No hidden magic, no vendor lock-in
+
+---
+
+## 🚀 Quick start
+
+This creates a clean SDK with a strict public API enforced by API Extractor.
+
+```bash
+npx @morda-dev/create-sdk my-sdk
+cd my-sdk
+npm install
+npm run build
+```
+
+That’s it. You now have a production-ready SDK.
+
+## 📘 Example SDK
+
+See a minimal, production-style SDK generated with **create-sdk**:
+
+👉 https://github.com/mordaHQ/example-sdk
+
+This example demonstrates:
+- a single, explicit public API entrypoint (`src/index.ts`)
+- API Extractor–controlled surface
+- ESM-first configuration
+- CI-ready setup
+- safe evolution without accidental breaking changes
+
+Use it as a reference for structuring real-world SDKs.
+
+## ❓ Why create-sdk?
+
+Most SDK starters fall into one of two traps:
+
+- ❌ too minimal — no real production setup
+- ❌ too complex — opinionated, hard to extend
+
+**create-sdk** sits in the middle:
+
+> Strict where it matters. Flexible where it should be.
+
+You get:
+
+- a clearly defined public API
+- predictable build & release flow
+- freedom to grow the SDK your way
+
+## 🧩 What’s included
+
+- TypeScript project with strict config
+- API Extractor setup
+- Ready-to-use CI workflow
+- Clean module-based structure
+- Example public API and types
+
+## 🛠 CLI options
+
+```bash
+npx @morda-dev/create-sdk <name> [options]
+```
+
+### Options
+
+- `--yes` — skip all prompts  
+- `--no-install` — skip dependency installation  
+- `--no-git` — skip git initialization
+
+### Example
+
+```bash
+npx @morda-dev/create-sdk my-sdk --yes --no-install
+```
+
+## 📦 Requirements
+
+- Node.js >= 18
+- npm / pnpm / yarn
+
+## ✅ Used in production
+
+This template is used to scaffold and maintain real-world TypeScript SDKs.
+
+
+## 🧭 Roadmap
+
+- Custom templates
+- Optional monorepo mode
+- Plugin system
+- SDK release automation helpers
+
+## 🤝 Contributing
+
+Issues and PRs are welcome.
+This project is intentionally kept small, clean, and well-documented.
+
+## 📄 License
+
+ISC
+
+
+---

package/bin/create-sdk.js

@@ -1,261 +1,261 @@
-#!/usr/bin/env node
-
-import fs from "fs";
-import path from "path";
-import process from "process";
-import { fileURLToPath } from "url";
-import { execSync } from "child_process";
-import prompts from "prompts";
-
-/* ============================================================================
- * Environment checks
- * ============================================================================
- */
-
-const REQUIRED_NODE_MAJOR = 18;
-const CURRENT_NODE_MAJOR = Number(process.versions.node.split(".")[0]);
-
-if (CURRENT_NODE_MAJOR < REQUIRED_NODE_MAJOR) {
-  console.error(
-    `❌ Node.js ${REQUIRED_NODE_MAJOR}+ is required.\n` +
-      `   You are using Node.js ${process.versions.node}`
-  );
-  process.exit(1);
-}
-
-/* ============================================================================
- * CLI args & flags
- * ============================================================================
- */
-
-const rawArgs = process.argv.slice(2);
-
-const flags = {
-  yes: rawArgs.includes("--yes"),
-  noGit: rawArgs.includes("--no-git"),
-  noInstall: rawArgs.includes("--no-install"),
-};
-
-if (rawArgs.includes("--version") || rawArgs.includes("-v")) {
-  console.log("create-sdk v1.1.0");
-  process.exit(0);
-}
-
-if (rawArgs.includes("--help") || rawArgs.includes("-h")) {
-  console.log(`
-create-sdk — scaffold a production-ready TypeScript SDK
-
-Usage:
-  npx @morda-dev/create-sdk <project-name>
-
-Options:
-  --yes           Skip prompts and use defaults
-  --no-git        Do not initialize git repository
-  --no-install    Do not install dependencies
-  --help, -h      Show this help
-  --version, -v   Show version
-
-Example:
-  npx @morda-dev/create-sdk my-sdk
-  npx @morda-dev/create-sdk my-sdk --yes --no-install
-`);
-  process.exit(0);
-}
-
-/* ============================================================================
- * Paths
- * ============================================================================
- */
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const templateDir = path.resolve(__dirname, "../template");
-
-/* ============================================================================
- * Project name & interactive flow
- * ============================================================================
- */
-
-const argProjectName = rawArgs.find((a) => !a.startsWith("-"));
-
-let projectName;
-let initGit = !flags.noGit;
-let installDeps = !flags.noInstall;
-
-if (flags.yes && argProjectName) {
-  projectName = argProjectName;
-} else if (!argProjectName) {
-  const answers = await prompts(
-    [
-      {
-        type: "text",
-        name: "name",
-        message: "Project name:",
-        validate: (v) => (v ? true : "Project name is required"),
-      },
-      {
-        type: "confirm",
-        name: "initGit",
-        message: "Initialize git repository?",
-        initial: true,
-      },
-      {
-        type: "confirm",
-        name: "installDeps",
-        message: "Install dependencies now?",
-        initial: false,
-      },
-    ],
-    {
-      onCancel: () => {
-        console.log("\n❌ Cancelled");
-        process.exit(1);
-      },
-    }
-  );
-
-  projectName = answers.name;
-  initGit = answers.initGit;
-  installDeps = answers.installDeps;
-} else {
-  projectName = argProjectName;
-}
-
-if (!projectName) {
-  console.error("❌ Project name is required");
-  process.exit(1);
-}
-
-/* ============================================================================
- * Target directory
- * ============================================================================
- */
-
-const dirName = projectName.startsWith("@")
-  ? projectName.split("/")[1]
-  : projectName;
-
-const targetDir = path.resolve(process.cwd(), dirName);
-
-/* ============================================================================
- * Safety checks
- * ============================================================================
- */
-
-if (!fs.existsSync(templateDir)) {
-  console.error("❌ Template directory not found:", templateDir);
-  process.exit(1);
-}
-
-if (fs.existsSync(targetDir)) {
-  console.error(`❌ Directory "${dirName}" already exists`);
-  process.exit(1);
-}
-
-/* ============================================================================
- * Scaffold project
- * ============================================================================
- */
-
-console.log("🚀 Creating SDK:", projectName);
-
-copyDir(templateDir, targetDir);
-
-/* ============================================================================
- * Update package.json
- * ============================================================================
- */
-
-const pkgPath = path.join(targetDir, "package.json");
-const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-
-pkg.name = projectName;
-pkg.version = "0.1.0";
-delete pkg.private;
-
-fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-
-/* ============================================================================
- * Update README title
- * ============================================================================
- */
-
-const readmePath = path.join(targetDir, "README.md");
-
-if (fs.existsSync(readmePath)) {
-  const updated = fs
-    .readFileSync(readmePath, "utf8")
-    .replace(/^# .*/m, `# ${projectName}`);
-
-  fs.writeFileSync(readmePath, updated);
-}
-
-/* ============================================================================
- * Git init
- * ============================================================================
- */
-
-if (initGit) {
-  try {
-    execSync("git init", { cwd: targetDir, stdio: "ignore" });
-  } catch {}
-}
-
-/* ============================================================================
- * Install dependencies
- * ============================================================================
- */
-
-if (installDeps) {
-  try {
-    execSync("npm install", { cwd: targetDir, stdio: "inherit" });
-  } catch {
-    console.warn("⚠️ Failed to install dependencies");
-  }
-}
-
-/* ============================================================================
- * Done
- * ============================================================================
- */
-
-console.log("");
-console.log("🎉 SDK scaffolded successfully!");
-console.log("");
-console.log("Next steps:");
-console.log(`  cd ${dirName}`);
-if (!installDeps) console.log("  npm install");
-console.log("  npm run build");
-console.log("");
-console.log("Happy hacking 🚀");
-
-/* ============================================================================
- * Helpers
- * ============================================================================
- */
-
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    if (shouldIgnore(entry.name)) continue;
-
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function shouldIgnore(name) {
-  return (
-    name === "node_modules" ||
-    name === ".git" ||
-    name === "dist" ||
-    name === ".DS_Store"
-  );
-}
+#!/usr/bin/env node
+
+import fs from "fs";
+import path from "path";
+import process from "process";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+import prompts from "prompts";
+
+/* ============================================================================
+ * Environment checks
+ * ============================================================================
+ */
+
+const REQUIRED_NODE_MAJOR = 18;
+const CURRENT_NODE_MAJOR = Number(process.versions.node.split(".")[0]);
+
+if (CURRENT_NODE_MAJOR < REQUIRED_NODE_MAJOR) {
+  console.error(
+    `❌ Node.js ${REQUIRED_NODE_MAJOR}+ is required.\n` +
+      `   You are using Node.js ${process.versions.node}`
+  );
+  process.exit(1);
+}
+
+/* ============================================================================
+ * CLI args & flags
+ * ============================================================================
+ */
+
+const rawArgs = process.argv.slice(2);
+
+const flags = {
+  yes: rawArgs.includes("--yes"),
+  noGit: rawArgs.includes("--no-git"),
+  noInstall: rawArgs.includes("--no-install"),
+};
+
+if (rawArgs.includes("--version") || rawArgs.includes("-v")) {
+  console.log("create-sdk v1.1.0");
+  process.exit(0);
+}
+
+if (rawArgs.includes("--help") || rawArgs.includes("-h")) {
+  console.log(`
+create-sdk — scaffold a production-ready TypeScript SDK
+
+Usage:
+  npx @morda-dev/create-sdk <project-name>
+
+Options:
+  --yes           Skip prompts and use defaults
+  --no-git        Do not initialize git repository
+  --no-install    Do not install dependencies
+  --help, -h      Show this help
+  --version, -v   Show version
+
+Example:
+  npx @morda-dev/create-sdk my-sdk
+  npx @morda-dev/create-sdk my-sdk --yes --no-install
+`);
+  process.exit(0);
+}
+
+/* ============================================================================
+ * Paths
+ * ============================================================================
+ */
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const templateDir = path.resolve(__dirname, "../template");
+
+/* ============================================================================
+ * Project name & interactive flow
+ * ============================================================================
+ */
+
+const argProjectName = rawArgs.find((a) => !a.startsWith("-"));
+
+let projectName;
+let initGit = !flags.noGit;
+let installDeps = !flags.noInstall;
+
+if (flags.yes && argProjectName) {
+  projectName = argProjectName;
+} else if (!argProjectName) {
+  const answers = await prompts(
+    [
+      {
+        type: "text",
+        name: "name",
+        message: "Project name:",
+        validate: (v) => (v ? true : "Project name is required"),
+      },
+      {
+        type: "confirm",
+        name: "initGit",
+        message: "Initialize git repository?",
+        initial: true,
+      },
+      {
+        type: "confirm",
+        name: "installDeps",
+        message: "Install dependencies now?",
+        initial: false,
+      },
+    ],
+    {
+      onCancel: () => {
+        console.log("\n❌ Cancelled");
+        process.exit(1);
+      },
+    }
+  );
+
+  projectName = answers.name;
+  initGit = answers.initGit;
+  installDeps = answers.installDeps;
+} else {
+  projectName = argProjectName;
+}
+
+if (!projectName) {
+  console.error("❌ Project name is required");
+  process.exit(1);
+}
+
+/* ============================================================================
+ * Target directory
+ * ============================================================================
+ */
+
+const dirName = projectName.startsWith("@")
+  ? projectName.split("/")[1]
+  : projectName;
+
+const targetDir = path.resolve(process.cwd(), dirName);
+
+/* ============================================================================
+ * Safety checks
+ * ============================================================================
+ */
+
+if (!fs.existsSync(templateDir)) {
+  console.error("❌ Template directory not found:", templateDir);
+  process.exit(1);
+}
+
+if (fs.existsSync(targetDir)) {
+  console.error(`❌ Directory "${dirName}" already exists`);
+  process.exit(1);
+}
+
+/* ============================================================================
+ * Scaffold project
+ * ============================================================================
+ */
+
+console.log("🚀 Creating SDK:", projectName);
+
+copyDir(templateDir, targetDir);
+
+/* ============================================================================
+ * Update package.json
+ * ============================================================================
+ */
+
+const pkgPath = path.join(targetDir, "package.json");
+const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+
+pkg.name = projectName;
+pkg.version = "0.1.0";
+delete pkg.private;
+
+fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+
+/* ============================================================================
+ * Update README title
+ * ============================================================================
+ */
+
+const readmePath = path.join(targetDir, "README.md");
+
+if (fs.existsSync(readmePath)) {
+  const updated = fs
+    .readFileSync(readmePath, "utf8")
+    .replace(/^# .*/m, `# ${projectName}`);
+
+  fs.writeFileSync(readmePath, updated);
+}
+
+/* ============================================================================
+ * Git init
+ * ============================================================================
+ */
+
+if (initGit) {
+  try {
+    execSync("git init", { cwd: targetDir, stdio: "ignore" });
+  } catch {}
+}
+
+/* ============================================================================
+ * Install dependencies
+ * ============================================================================
+ */
+
+if (installDeps) {
+  try {
+    execSync("npm install", { cwd: targetDir, stdio: "inherit" });
+  } catch {
+    console.warn("⚠️ Failed to install dependencies");
+  }
+}
+
+/* ============================================================================
+ * Done
+ * ============================================================================
+ */
+
+console.log("");
+console.log("🎉 SDK scaffolded successfully!");
+console.log("");
+console.log("Next steps:");
+console.log(`  cd ${dirName}`);
+if (!installDeps) console.log("  npm install");
+console.log("  npm run build");
+console.log("");
+console.log("Happy hacking 🚀");
+
+/* ============================================================================
+ * Helpers
+ * ============================================================================
+ */
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (shouldIgnore(entry.name)) continue;
+
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function shouldIgnore(name) {
+  return (
+    name === "node_modules" ||
+    name === ".git" ||
+    name === "dist" ||
+    name === ".DS_Store"
+  );
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@morda-dev/create-sdk",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "CLI to scaffold a production-ready TypeScript SDK with a strict public API",
   "type": "module",
   "bin": {
-    "create-sdk": "bin/create-sdk.js"
+    "create-sdk": "./bin/create-sdk.js"
   },
   "files": [
     "bin",
@@ -14,11 +14,36 @@
   "engines": {
     "node": ">=18"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mordaHQ/create-sdk.git"
+  },
+  "homepage": "https://github.com/mordaHQ/create-sdk",
+  "bugs": {
+    "url": "https://github.com/mordaHQ/create-sdk/issues"
+  },
+  "keywords": [
+    "create-sdk",
+    "typescript",
+    "sdk",
+    "cli",
+    "scaffold",
+    "api-extractor",
+    "library"
+  ],
   "scripts": {
-    "test:smoke": "node ./bin/create-sdk.js __tmp-smoke-sdk --yes --no-install --no-git && node -e \"import('fs').then(fs => fs.rmSync('__tmp-smoke-sdk', { recursive: true, force: true }))\""
+    "test:smoke": "node ./bin/create-sdk.js __tmp-smoke-sdk --yes --no-install --no-git && node -e \"import('fs').then(fs => fs.rmSync('__tmp-smoke-sdk', { recursive: true, force: true }))\"",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "changeset publish"
   },
   "dependencies": {
     "prompts": "^2.4.2"
   },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^18.19.0",
+    "undici-types": "^7.16.0"
+  },
   "license": "ISC"
 }

package/template/.github/workflows/ci.yml

@@ -1,30 +1,30 @@
-name: CI
-
-on:
-  pull_request:
-    branches: [ main ]
-  push:
-    branches: [ main ]
-
-jobs:
-  build-and-api-check:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repo
-        uses: actions/checkout@v4
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build
-        run: npm run build
-
-      - name: API Extractor check
-        run: npm run api:check
+name: CI
+
+on:
+  pull_request:
+    branches: [ main ]
+  push:
+    branches: [ main ]
+
+jobs:
+  build-and-api-check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: API Extractor check
+        run: npm run api:check

package/template/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Morda Dev
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights  
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
-copies of the Software, and to permit persons to whom the Software is  
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in  
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING  
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS  
-IN THE SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Morda Dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights  
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
+copies of the Software, and to permit persons to whom the Software is  
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in  
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING  
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS  
+IN THE SOFTWARE.

package/template/README.md

@@ -1,49 +1,49 @@
-# @morda-dev/project-template
-
-Production-ready TypeScript SDK template with a strict public API, ESM-first setup,
-and best practices baked in.
-
-This package can be used as:
-- a base for building your own SDK
-- a reference for ESM + TypeScript library architecture
-- a starting point for production-ready npm packages
-
----
-
-## Installation
-
-```bash
-npm install @morda-dev/project-template
-```
-
-## Usage
-
-```ts
-import { getUser, sumAges } from '@morda-dev/project-template';
-
-const user = getUser(1);
-console.log(user);
-
-const totalAge = sumAges([
-  { id: 1, name: 'Alice', age: 20 },
-  { id: 2, name: 'Bob', age: 30 },
-]);
-
-console.log(totalAge);
-```
-
-## API
-### getUser(id: number)
-
-Returns a user wrapped in `ApiResult`.
-
-### sumAges(users: User[])
-
-Returns the sum of all user ages.
-
-## License
-
-ISC
-
-
----
+# @morda-dev/project-template
+
+Production-ready TypeScript SDK template with a strict public API, ESM-first setup,
+and best practices baked in.
+
+This package can be used as:
+- a base for building your own SDK
+- a reference for ESM + TypeScript library architecture
+- a starting point for production-ready npm packages
+
+---
+
+## Installation
+
+```bash
+npm install @morda-dev/project-template
+```
+
+## Usage
+
+```ts
+import { getUser, sumAges } from '@morda-dev/project-template';
+
+const user = getUser(1);
+console.log(user);
+
+const totalAge = sumAges([
+  { id: 1, name: 'Alice', age: 20 },
+  { id: 2, name: 'Bob', age: 30 },
+]);
+
+console.log(totalAge);
+```
+
+## API
+### getUser(id: number)
+
+Returns a user wrapped in `ApiResult`.
+
+### sumAges(users: User[])
+
+Returns the sum of all user ages.
+
+## License
+
+ISC
+
+
+---

package/template/etc/project-template.api.md

@@ -1,32 +1,32 @@
-## API Report File for "@morda-dev/project-template"
-
-> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
-
-```ts
-
-// @public
-export type ApiResult<T> = {
-    success: true;
-    data: T;
-} | {
-    success: false;
-    error: string;
-};
-
-// @public
-export function getUser(id: number): ApiResult<User>;
-
-// @public
-export function sumAges(users: User[]): number;
-
-// @public
-export interface User {
-    // (undocumented)
-    age: number;
-    // (undocumented)
-    id: number;
-    // (undocumented)
-    name: string;
-}
-
-```
+## API Report File for "@morda-dev/project-template"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+// @public
+export type ApiResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+
+// @public
+export function getUser(id: number): ApiResult<User>;
+
+// @public
+export function sumAges(users: User[]): number;
+
+// @public
+export interface User {
+    // (undocumented)
+    age: number;
+    // (undocumented)
+    id: number;
+    // (undocumented)
+    name: string;
+}
+
+```

package/template/src/index.ts

@@ -1,25 +1,25 @@
-/**
- * @packageDocumentation
- *
- * Production-ready TypeScript SDK template.
- *
- * This file defines the public API surface of the package.
- * Only symbols exported from this file are considered stable
- * and part of the public contract.
- */
-
-/* ============================================================================
- * Types (Public)
- * ============================================================================
- */
-
-/** @public */
-export type { User, ApiResult } from "./types/user.js";
-
-/* ============================================================================
- * Functions (Public)
- * ============================================================================
- */
-
-/** @public */
-export { getUser, sumAges } from "./modules/user.js";
+/**
+ * @packageDocumentation
+ *
+ * Production-ready TypeScript SDK template.
+ *
+ * This file defines the public API surface of the package.
+ * Only symbols exported from this file are considered stable
+ * and part of the public contract.
+ */
+
+/* ============================================================================
+ * Types (Public)
+ * ============================================================================
+ */
+
+/** @public */
+export type { User, ApiResult } from "./types/user.js";
+
+/* ============================================================================
+ * Functions (Public)
+ * ============================================================================
+ */
+
+/** @public */
+export { getUser, sumAges } from "./modules/user.js";

package/template/src/modules/user.ts

@@ -1,31 +1,31 @@
-import { ApiResult, User } from "../types/user.js";
-
-/**
- * @public
- * Get a user by id
- */
-export function getUser(id: number): ApiResult<User> {
-  if (id <= 0) {
-    return {
-      success: false,
-      error: "Invalid user id",
-    };
-  }
-
-  return {
-    success: true,
-    data: {
-      id,
-      name: "John Doe",
-      age: 30,
-    },
-  };
-}
-
-/**
- * @public
- * Sum ages of users
- */
-export function sumAges(users: User[]): number {
-  return users.reduce((sum, user) => sum + user.age, 0);
-}
+import { ApiResult, User } from "../types/user.js";
+
+/**
+ * @public
+ * Get a user by id
+ */
+export function getUser(id: number): ApiResult<User> {
+  if (id <= 0) {
+    return {
+      success: false,
+      error: "Invalid user id",
+    };
+  }
+
+  return {
+    success: true,
+    data: {
+      id,
+      name: "John Doe",
+      age: 30,
+    },
+  };
+}
+
+/**
+ * @public
+ * Sum ages of users
+ */
+export function sumAges(users: User[]): number {
+  return users.reduce((sum, user) => sum + user.age, 0);
+}

package/template/src/types/user.ts

@@ -1,17 +1,17 @@
-/**
- * @public
- * User entity
- */
-export interface User {
-  id: number;
-  name: string;
-  age: number;
-}
-
-/**
- * @public
- * Generic API result
- */
-export type ApiResult<T> =
-  | { success: true; data: T }
-  | { success: false; error: string };
+/**
+ * @public
+ * User entity
+ */
+export interface User {
+  id: number;
+  name: string;
+  age: number;
+}
+
+/**
+ * @public
+ * Generic API result
+ */
+export type ApiResult<T> =
+  | { success: true; data: T }
+  | { success: false; error: string };