Cleaned up docs.
This commit is contained in:
@@ -1,54 +0,0 @@
|
||||
# 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:
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
```
|
||||
|
||||
Build in watch mode:
|
||||
|
||||
```bash
|
||||
npm run build:watch
|
||||
```
|
||||
|
||||
Smoke check CLI output:
|
||||
|
||||
```bash
|
||||
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:
|
||||
|
||||
```bash
|
||||
npm pack --pack-destination ./artifacts
|
||||
```
|
||||
|
||||
Install from tarball:
|
||||
|
||||
```bash
|
||||
npm install ./artifacts/@slawek/sk-az-tools-<version>.tgz
|
||||
```
|
||||
Reference in New Issue
Block a user