Antigravity × npm パッケージ開発ガイド — AI エージェントで TypeScript ライブラリの作成・テスト・公開を自動化する

@myorg/utils/
├── src/
│   └── index.ts          # エントリポイント
├── tests/
│   └── index.test.ts     # テストファイル
├── tsconfig.json          # TypeScript 設定
├── tsup.config.ts         # バンドル設定（ESM + CJS）
├── vitest.config.ts       # テスト設定
├── biome.json             # リント＆フォーマット設定
├── package.json           # npm メタデータ
├── README.md              # ドキュメント
├── LICENSE                # ライセンスファイル
└── .gitignore

{
  "name": "@myorg/utils",
  "version": "0.1.0",
  "type": "module",
  "main": "./dist/index.cjs",
  "module": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "import": {
        "types": "./dist/index.d.ts",
        "default": "./dist/index.js"
      },
      "require": {
        "types": "./dist/index.d.cts",
        "default": "./dist/index.cjs"
      }
    }
  },
  "files": ["dist", "README.md", "LICENSE"],
  "scripts": {
    "build": "tsup",
    "test": "vitest run",
    "test:watch": "vitest",
    "lint": "biome check .",
    "prepublishOnly": "npm run build && npm run test"
  }
}

// tsup.config.ts
import { defineConfig } from "tsup";
 
export default defineConfig({
  entry: ["src/index.ts"],
  format: ["esm", "cjs"],    // デュアル出力
  dts: true,                  // 型定義ファイルを自動生成
  splitting: false,
  sourcemap: true,
  clean: true,                // ビルド前に dist/ をクリーン
  outDir: "dist",
  target: "es2022",
  minify: false,              // ライブラリは minify しないのが一般的
});

# ビルド実行
npx tsup
 
# 出力結果の確認
# dist/index.js     — ESM 形式
# dist/index.cjs    — CommonJS 形式
# dist/index.d.ts   — 型定義
# dist/index.d.cts  — CJS 用型定義

// src/index.ts
export function slugify(text: string): string {
  return text
    .toLowerCase()
    .trim()
    .replace(/[^\w\s-]/g, "")
    .replace(/[\s_]+/g, "-")
    .replace(/-+/g, "-")
    .replace(/^-|-$/g, "");
}
 
export function truncate(str: string, maxLength: number, suffix = "..."): string {
  if (str.length <= maxLength) return str;
  return str.slice(0, maxLength - suffix.length) + suffix;
}
 
export function groupBy<T>(arr: T[], key: keyof T): Record<string, T[]> {
  return arr.reduce((acc, item) => {
    const group = String(item[key]);
    (acc[group] ??= []).push(item);
    return acc;
  }, {} as Record<string, T[]>);
}

// tests/index.test.ts
import { describe, it, expect } from "vitest";
import { slugify, truncate, groupBy } from "../src/index";
 
describe("slugify", () => {
  it("基本的な文字列をスラッグに変換する", () => {
    expect(slugify("Hello World")).toBe("hello-world");
  });
 
  it("特殊文字を除去する", () => {
    expect(slugify("Hello, World! @2026")).toBe("hello-world-2026");
  });
 
  it("先頭と末尾のハイフンを除去する", () => {
    expect(slugify("  --hello--  ")).toBe("hello");
  });
 
  it("空文字列を処理する", () => {
    expect(slugify("")).toBe("");
  });
 
  it("連続するスペースをハイフン1つにまとめる", () => {
    expect(slugify("a   b   c")).toBe("a-b-c");
  });
});
 
describe("truncate", () => {
  it("上限以下の文字列はそのまま返す", () => {
    expect(truncate("short", 10)).toBe("short");
  });
 
  it("上限を超えた文字列を切り詰める", () => {
    expect(truncate("this is a long sentence", 10)).toBe("this is...");
  });
 
  it("カスタム suffix を適用する", () => {
    expect(truncate("abcdefghij", 8, "…")).toBe("abcdefg…");
  });
});
 
describe("groupBy", () => {
  it("指定キーでグループ化する", () => {
    const data = [
      { category: "a", value: 1 },
      { category: "b", value: 2 },
      { category: "a", value: 3 },
    ];
    const result = groupBy(data, "category");
    expect(result.a).toHaveLength(2);
    expect(result.b).toHaveLength(1);
  });
 
  it("空配列は空オブジェクトを返す", () => {
    expect(groupBy([], "key" as never)).toEqual({});
  });
});

# エージェントへの指示例
「最新のコミット履歴を確認して、semver に基づいたバージョンバンプを提案してください。
CHANGELOG.md も Keep a Changelog 形式で更新してください。」

## [0.2.0] - 2026-03-31
 
### Added
- `groupBy` ユーティリティ関数を追加
- ESM + CJS デュアル出力に対応
 
### Fixed
- `slugify` で連続ハイフンが残る問題を修正

# 公開前の確認コマンド
npm pack --dry-run
 
# 出力例:
# npm notice Tarball Contents
# npm notice 1.2kB  dist/index.js
# npm notice 1.0kB  dist/index.cjs
# npm notice 892B   dist/index.d.ts
# npm notice 892B   dist/index.d.cts
# npm notice 2.1kB  README.md
# npm notice 1.1kB  LICENSE
# npm notice 580B   package.json
# npm notice Tarball Details
# npm notice name:          @myorg/utils
# npm notice version:       0.2.0
# npm notice package size:  3.2 kB

# npm にログイン（初回のみ）
npm login
 
# 公開（スコープ付きパッケージの場合は --access public を指定）
npm publish --access public

# .github/workflows/publish.yml
name: Publish Package
 
on:
  release:
    types: [published]
 
jobs:
  publish:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      id-token: write
    steps:
      - uses: actions/checkout@v4
 
      - uses: actions/setup-node@v4
        with:
          node-version: "22"
          registry-url: "https://registry.npmjs.org"
 
      - run: npm ci
      - run: npm run lint
      - run: npm run test
      - run: npm run build
 
      - run: npm publish --provenance --access public
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}