typescript

apdev

General-purpose development tools for TypeScript/JavaScript projects - character validation, circular import detection, and more.

Installation

pnpm add -D apdev-js
# or
npm install --save-dev apdev-js

Available Tools

check-chars

Validate files contain only allowed characters (ASCII + emoji + technical symbols).

npx apdev check-chars src/**/*.ts

check-imports

Detect circular imports in a JS/TS package.

npx apdev check-imports --package mylib --src-dir src

release

Interactive release automation (build, tag, GitHub release, npm publish).

npx apdev release
npx apdev release 1.0.0

Configuration

Add an "apdev" field to your package.json:

{
  "apdev": {
    "base_package": "mylib",
    "src_dir": "src"
  }
}

With configuration, you can run check-imports without flags:

npx apdev check-imports

Integration with lint-staged / Husky

Add character checking as a pre-commit hook:

{
  "lint-staged": {
    "*.{ts,tsx,js,jsx}": ["apdev check-chars"]
  }
}

Programmatic API

import {
  isAllowedChar,
  checkFile,
  checkPaths,
  checkCircularImports,
  loadConfig,
} from "apdev-js";

// Check a single character
isAllowedChar("A"); // true
isAllowedChar("\u4E2D"); // false (CJK)

// Check a file
const problems = checkFile("src/index.ts");

// Detect circular imports
const exitCode = checkCircularImports("src", "mylib");

Development

Prerequisites: Node.js >= 18, pnpm.

cd typescript
pnpm install              # Install dependencies
pnpm build                # Build (ESM + CJS + types)
pnpm test                 # Run tests
pnpm lint                 # Lint
pnpm format               # Format

Release

Requires npm authentication (~/.npmrc) and GitHub CLI (gh).

./release.sh              # Use version from package.json
./release.sh 0.2.0        # Specify version
./release.sh --yes        # Silent mode (CI/CD)

The script will: verify version → clean → build → pack check → git tag → GitHub release → npm publish.

License

Apache-2.0