···3737- **@bdbchgg/oxrls** (v1.0.0-alpha.1): First public release of oxrls — a Rust-powered release CLI for JS/TS monorepos.
38383939 I'm incredibly happy to release this. oxrls has been a joy to build and I'm already using it for my own monorepos. It's fast, configurable, bendable and just works!
4040-4040+4141 Features included in this release:
4242-4342 - `oxrls init` with interactive config wizard
4443 - `oxrls new` for creating release files (interactive and CLI mode)
4544 - `oxrls status` to preview pending changes
···5251 - Per-package and global CHANGELOG.md generation
5352 - SemVer-compliant version bumping
5453 - Deterministic read-compute-write safety model
5555-5656- I hope this tool saves you as much time and headache as it's already saving me. ❤️5454+5555+ I hope this tool saves you as much time and headache as it's already saving me. ❤️
···64646565Controls when internal dependency ranges are updated:
66666767-| Value | Behavior |
6868-|-------|----------|
6969-| `"always"` | Always update ranges |
7070-| `"patch"` | Update when dependency got at least a patch |
7171-| `"minor"` | Update only for minor or major |
7272-| `"major"` | Update only for major |
7373-| `"never"` | Never update |
6767+| Value | Behavior |
6868+| ---------- | ------------------------------------------- |
6969+| `"always"` | Always update ranges |
7070+| `"patch"` | Update when dependency got at least a patch |
7171+| `"minor"` | Update only for minor or major |
7272+| `"major"` | Update only for major |
7373+| `"never"` | Never update |
74747575### `baseBranch`
7676···109109110110```json
111111{
112112- "linked": [
113113- ["@scope/hooks", "@scope/utils"]
114114- ]
112112+ "linked": [["@scope/hooks", "@scope/utils"]]
115113}
116114```
117115
···11# Getting Started with oxrls
2233-**oxrls** (short for *oxrelease*) is a Rust-powered release management CLI for JavaScript/TypeScript monorepos. It handles version bumps, changelogs, internal dependency updates, pre-release versions, and npm publishing.
33+**oxrls** (short for _oxrelease_) is a Rust-powered release management CLI for JavaScript/TypeScript monorepos. It handles version bumps, changelogs, internal dependency updates, pre-release versions, and npm publishing.
4455## Installation
66···7676```
77777878After `oxrls bump`:
7979+7980- Package versions are updated in `package.json`
8081- Internal dependency ranges are updated
8182- `CHANGELOG.md` is created/updated
+38-36
docs/usage.md
packages/oxrls/docs/usage.md
···10101111**Options:**
12121313-| Option | Description |
1414-|--------|-------------|
1515-| `--force` | Overwrite existing config |
1313+| Option | Description |
1414+| --------------------- | -------------------------------------------- |
1515+| `--force` | Overwrite existing config |
1616| `--release-dir <DIR>` | Custom release directory (default: `.oxrls`) |
1717-| `--non-interactive` | Skip the config wizard and use defaults |
1717+| `--non-interactive` | Skip the config wizard and use defaults |
18181919**Interactive mode** (default): walks you through all config options step by step:
2020···50505151**Options:**
52525353-| Option | Description |
5454-|--------|-------------|
5353+| Option | Description |
5454+| ---------------------------- | -------------------------------- |
5555| `-p`, `--package <PKG:TYPE>` | Package + bump type (repeatable) |
5656-| `--summary <TEXT>` | Summary of the change |
5757-| `--details <TEXT>` | Optional body text |
5656+| `--summary <TEXT>` | Summary of the change |
5757+| `--details <TEXT>` | Optional body text |
58585959**Generated file:**
60606161```markdown
6262---
6363-"@scope/core": patch
6464-"@scope/react": minor
6363+'@scope/core': patch
6464+'@scope/react': minor
6565---
66666767Improve editor behavior.
···114114Reads `.oxrls/releaseplan.txt` (a plain text list of package names, one per line, alphabetically sorted).
115115116116**Behavior:**
117117+117118- **Private packages** (`"private": true`) are skipped
118119- **Version check**: verifies `package.json` version matches the expected version
119120- **Exists check**: runs `npm view <pkg>@<version> version` first — skips if already published
···156157```
157158158159Package names support:
160160+159161- Exact names: `@scope/pkg-c`
160162- Partial names: `pkg-c` resolves to `@scope/pkg-c` by suffix matching
161163- Globs: `"@scope/pre-*"`
···167169168170```markdown
169171---
170170-"@scope/pkg-a": patch
171171-"@scope/pkg-b": minor
172172+'@scope/pkg-a': patch
173173+'@scope/pkg-b': minor
172174---
173175174176Summary of changes.
···183185184186## Version bump rules
185187186186-| Current | Bump | Result |
187187-|---------|------|--------|
188188-| 1.2.3 | patch | 1.2.4 |
189189-| 1.2.3 | minor | 1.3.0 |
190190-| 1.2.3 | major | 2.0.0 |
191191-| 0.2.3 | major | 1.0.0 |
192192-| 0.2.3 | minor | 0.3.0 |
193193-| 0.2.3 | patch | 0.2.4 |
188188+| Current | Bump | Result |
189189+| ------- | ----- | ------ |
190190+| 1.2.3 | patch | 1.2.4 |
191191+| 1.2.3 | minor | 1.3.0 |
192192+| 1.2.3 | major | 2.0.0 |
193193+| 0.2.3 | major | 1.0.0 |
194194+| 0.2.3 | minor | 0.3.0 |
195195+| 0.2.3 | patch | 0.2.4 |
194196195197Multiple bumps for same package: **major > minor > patch**.
196198···224226225227oxrls updates dependency ranges in `dependencies`, `devDependencies`, `peerDependencies`, and `optionalDependencies`:
226228227227-| Original | Updated |
228228-|----------|---------|
229229-| `^1.2.3` | `^1.2.4` |
230230-| `~1.2.3` | `~1.2.4` |
231231-| `1.2.3` | `1.2.4` |
232232-| `workspace:*` | `workspace:*` |
233233-| `workspace:^` | `workspace:^` |
234234-| `workspace:~` | `workspace:~` |
229229+| Original | Updated |
230230+| ------------------ | ------------------ |
231231+| `^1.2.3` | `^1.2.4` |
232232+| `~1.2.3` | `~1.2.4` |
233233+| `1.2.3` | `1.2.4` |
234234+| `workspace:*` | `workspace:*` |
235235+| `workspace:^` | `workspace:^` |
236236+| `workspace:~` | `workspace:~` |
235237| `workspace:^1.2.3` | `workspace:^1.2.4` |
236238237239---
···280282281283Version examples:
282284283283-| Bump | Without pre | With pre (beta) |
284284-|------|-------------|-----------------|
285285-| patch | `1.2.4` | `1.2.4-beta.1` |
286286-| minor | `1.3.0` | `1.3.0-beta.1` |
287287-| major | `2.0.0` | `2.0.0-beta.1` |
285285+| Bump | Without pre | With pre (beta) |
286286+| ----- | ----------- | --------------- |
287287+| patch | `1.2.4` | `1.2.4-beta.1` |
288288+| minor | `1.3.0` | `1.3.0-beta.1` |
289289+| major | `2.0.0` | `2.0.0-beta.1` |
288290289291Pre-release tag is used as the npm dist-tag during `oxrls release`:
290292···298300## Exit codes
299301300302| Code | Meaning |
301301-|------|---------|
302302-| 0 | Success |
303303-| 1 | Error |
303303+| ---- | ------- |
304304+| 0 | Success |
305305+| 1 | Error |
+1
index.d.ts
packages/oxrls/index.d.ts
···11/* auto-generated by NAPI-RS */
22/* eslint-disable */
33export declare function runCli(args: Array<string>): void
44+export declare function plus100(input: number): number