@mongez/pkgist 1.0.2 → 1.0.4

package/README.md

@@ -13,33 +13,45 @@ A build, version, and publish tool for TypeScript/React npm packages. Powered by
 - **npm publish** — publishes from the build directory, not the source
 - **Dry-run mode** — prints every step without touching disk, git, or npm
 - **Concurrency** — builds multiple packages in parallel
-- **TypeScript config** — `builder.ts` with full type safety via `defineConfig`
+- **TypeScript config** — `pkgist.config.ts` with full type safety via `defineConfig`
 
 ---
 
 ## Installation
 
 ```sh
-cd /path/to/compiler-v2
-npm install
-npm run build
-npm link          # makes `pkgist` available globally
+# Global — use the CLI anywhere
+npm install -g @mongez/pkgist
+
+# Or as a dev dependency in your monorepo root
+npm install -D @mongez/pkgist
+```
+
+Add a script to your root `package.json` for convenience:
+
+```json
+{
+  "scripts": {
+    "release": "pkgist build:all",
+    "release:dry": "pkgist build:all --dry-run"
+  }
+}
 ```
 
 ---
 
 ## Configuration
 
-Create a `builder.ts` in your project root (the bundler auto-discovers it):
+Create a `pkgist.config.ts` in your project root (auto-discovered; `builder.ts` also works):
 
 ```ts
 import { defineConfig } from "@mongez/pkgist";
 
 export default defineConfig({
   settings: {
-    concurrency: 8,          // parallel build limit (default: 4)
-    buildDir: "../builds",   // where compiled packages are written
-    sourcesDir: "../sources", // where source snapshots are archived
+    concurrency: 8,           // parallel build limit (default: 4)
+    buildDir: "../builds",    // where compiled packages are written
+    sourcesDir: "../sources", // optional: where source snapshots are archived
   },
 
   // Standalone: each package versions independently
@@ -75,7 +87,7 @@ Every entry in `standalone[]` and `families[].packages[]` accepts:
 | Option | Type | Default | Description |
 |---|---|---|---|
 | `name` | `string` | **required** | npm package name |
-| `root` | `string` | **required** | Path to package root, relative to `builder.ts` |
+| `root` | `string` | **required** | Path to package root, relative to `pkgist.config.ts` |
 | `type` | `"typescript" \| "react"` | `"typescript"` | React packages get JSX support |
 | `formats` | `("esm" \| "cjs")[]` | `["esm", "cjs"]` | Output formats |
 | `mainType` | `"cjs" \| "esm"` | `"cjs"` | Primary format (affects `main` field in package.json) |
@@ -95,13 +107,13 @@ Every entry in `standalone[]` and `families[].packages[]` accepts:
 
 | Option | Type | Default | Description |
 |---|---|---|---|
-| `version` | `"auto" \| string` | `"auto"` | `"auto"` = patch bump; explicit string = use that version |
+| `version` | `"auto" \| "patch" \| "minor" \| "major" \| string` | `"auto"` | `"auto"`/`"patch"` bumps the patch digit; `"minor"` bumps minor; `"major"` bumps major; any semver string uses that version exactly |
 
 ### Family-level options
 
 | Option | Type | Default | Description |
 |---|---|---|---|
-| `version` | `"auto" \| string` | `"auto"` | Version strategy for the whole family |
+| `version` | `"auto" \| "patch" \| "minor" \| "major" \| string` | `"auto"` | Same strategies as standalone; applied to the highest current version across all family members |
 | `commit` | `string` | — | Commit message applied to all packages (overrides per-package) |
 
 ---
@@ -200,7 +212,7 @@ Available on all `build` commands:
 | `--no-publish` | Skip `npm publish` |
 | `--no-git` | Skip git add / commit / push / tag |
 | `--concurrency <n>` | Override the parallel build limit |
-| `--config <path>` | Path to config file (default: `builder.ts` in cwd) |
+| `--config <path>` | Path to config file (default: auto-discovers `pkgist.config.ts` / `builder.ts` in cwd) |
 | `--verbose` | Show debug-level log lines |
 
 ---

package/builder.ts

@@ -1,7 +1,5 @@
 import { defineConfig } from "@mongez/pkgist";
 
-const RELEASE_COMMIT = "Added skills and improved build output";
-
 export default defineConfig({
   settings: {
     concurrency: 8,
@@ -14,13 +12,12 @@ export default defineConfig({
       name: "@mongez/reinforcements",
       root: "../@mongez/reinforcements",
       version: "auto",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/agent-kit",
       root: "../@mongez/agent-kit",
-      commit: "Fixed imported cli bin",
+      commit: "Enhanced docs",
       entries: ["index.ts", "cli/index.ts"],
       clone: ["README.md", "bin", "skills", "llms.txt", "llms-full.txt"],
     },
@@ -28,77 +25,66 @@ export default defineConfig({
       name: "@mongez/supportive-is",
       root: "../@mongez/supportive-is",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/cache",
       root: "../@mongez/cache",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/events",
       root: "../@mongez/events",
       version: "auto",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/collection",
       root: "../@mongez/collection",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/concat-route",
       root: "../@mongez/concat-route",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/query-string",
       root: "../@mongez/query-string",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/dotenv",
       root: "../@mongez/dotenv",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/encryption",
       root: "../@mongez/encryption",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/config",
       root: "../@mongez/config",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/dom",
       root: "../@mongez/dom",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
       name: "@mongez/user",
       root: "../@mongez/user",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
@@ -106,7 +92,6 @@ export default defineConfig({
       root: "../@mongez/react-router",
       type: "react",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
@@ -114,7 +99,6 @@ export default defineConfig({
       root: "../@mongez/react-helmet",
       type: "react",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
@@ -122,7 +106,6 @@ export default defineConfig({
       root: "../@mongez/react-form",
       type: "react",
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
     {
@@ -131,7 +114,6 @@ export default defineConfig({
       mainType: "esm",
       formats: ["esm"],
       version: "minor",
-      commit: RELEASE_COMMIT,
       clone: ["README.md", "skills", "llms.txt", "llms-full.txt"],
     },
   ],
@@ -139,8 +121,7 @@ export default defineConfig({
   families: [
     {
       name: "atom",
-      version: "6.0.0",
-      commit: RELEASE_COMMIT,
+      version: "patch",
       packages: [
         {
           name: "@mongez/atom",
@@ -164,7 +145,6 @@ export default defineConfig({
     {
       name: "localization",
       version: "minor",
-      commit: RELEASE_COMMIT,
       packages: [
         {
           name: "@mongez/localization",

package/dist/cli.js

@@ -685,7 +685,7 @@ async function publishPackage(pkg, buildPath, dryRun) {
     "npm-publish",
     pkg.name,
     "npm",
-    ["publish", "--access", access],
+    ["publish", "--access", access, "--registry", "https://registry.npmjs.org"],
     buildPath
   );
   logger.success(`Published ${pkg.name}`);