sk-az-tools/docs/PACKAGING.md

Packaging sk-az-tools

Build model

• Source lives in src/ as TypeScript (.ts).
• Runtime package is compiled to dist/ using npm run build.
• Public package entrypoints (exports and bin) point to dist/**.

Package surface

• exports defines what consumers can import.
• files controls what is shipped to npm.
• Current shipping content is dist, README.md, and LICENSE.

Development workflow

Build once:

npm run build

Build in watch mode:

npm run build:watch

Smoke check CLI output:

node dist/cli.js --help

Publish checklist

1. Run npm run build and ensure TypeScript compiles without errors.
2. Verify package content with npm pack --dry-run.
3. Create artifact: npm pack --pack-destination ./artifacts.
4. Optionally install the artifact locally and validate CLI/imports.

Tarball usage

Create package tarball:

npm pack --pack-destination ./artifacts

Install from tarball:

npm install ./artifacts/@slawek/sk-az-tools-<version>.tgz