@doki-land/nifty 0.1.4 → 0.1.5

package/Readme.md

@@ -0,0 +1,55 @@
+# @doki-land/nifty
+
+[![npm version](https://img.shields.io/npm/v/@doki-land/nifty.svg)](https://www.npmjs.com/package/@doki-land/nifty)
+
+Programmatic and CLI surface for **Nifty** — gitmoji commit lint, hybrid Cargo + npm bumps, Oak formatting, workspace publish, and gix-backed git helpers. Product overview: [npm-tools readme](https://github.com/oovm/npm-tools#readme).
+
+## Exports
+
+| Subpath | Purpose |
+| --- | --- |
+| `@doki-land/nifty` | `Nifty`, `Git`, `Github`, `Gitmoji`, config loaders, shared types |
+| `@doki-land/nifty/cli` | CLI module re-exports (advanced integrations) |
+| `nifty` (bin) | Full command-line interface |
+
+Platform native bindings (`@doki-land/nifty-*`) install automatically as optional dependencies on matching hosts. Do not import them directly.
+
+## Example
+
+**CLI** — run from a project root that contains `nifty.config.ts` (optional):
+
+```bash
+nifty check --from v0.1.0 --to HEAD
+nifty bump --version 0.2.0 --dry-run
+nifty format --check
+```
+
+**TypeScript API** — open a hybrid workspace and read git history:
+
+```ts
+import { createNifty } from "@doki-land/nifty";
+
+const nifty = await createNifty({ cwd: process.cwd() });
+const ok = nifty.gitmoji.validateSubject("✨ Add workspace helper");
+const range = nifty.git.resolveRange(nifty.layout.root, {
+  fromRef: "v0.1.0",
+  toRef: "HEAD",
+});
+```
+
+**Config** — typed project defaults:
+
+```ts
+import { defineConfig } from "@doki-land/nifty";
+
+export default defineConfig({
+  lint: {
+    rules: [{ id: "gitmoji/subject", severity: "error", enabled: true }],
+  },
+});
+```
+
+## Related packages
+
+- [@doki-land/nifty-skills](https://www.npmjs.com/package/@doki-land/nifty-skills) — Agent Skills for `nifty` workflows
+- Platform sidecars (`@doki-land/nifty-win32-x64`, `@doki-land/nifty-linux-x64`, …) — prebuilt Node-API artifacts resolved by this package

package/package.json

@@ -1,12 +1,16 @@
 {
-  "name": "@doki-land/nifty",
-  "version": "0.1.4",
-  "description": "Gitmoji-first commit conventions and release helpers (Node-API + TypeScript)",
-  "type": "module",
-  "license": "MPL-2.0",
   "bin": {
     "nifty": "cli/nifty.mjs"
   },
+  "dependencies": {
+    "@vmz/commander": "^0.2.0",
+    "jiti": "^2.4.2"
+  },
+  "description": "Gitmoji-first commit conventions and release helpers (Node-API + TypeScript)",
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.3"
+  },
   "exports": {
     ".": "./src/index.ts",
     "./cli": "./src/cli/index.ts"
@@ -16,20 +20,14 @@
     "locales",
     "src"
   ],
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "test": "node --test tests/*.test.mjs"
-  },
-  "dependencies": {
-    "@vmz/commander": "^0.2.0",
-    "jiti": "^2.4.2"
-  },
+  "license": "MPL-2.0",
+  "name": "@doki-land/nifty",
   "optionalDependencies": {
-    "@doki-land/nifty-win32-x64": "0.1.4",
-    "@doki-land/nifty-linux-x64": "0.1.4",
-    "@doki-land/nifty-linux-arm64": "0.1.4",
-    "@doki-land/nifty-darwin-arm64": "0.1.4",
-    "@doki-land/nifty-darwin-x64": "0.1.4"
+    "@doki-land/nifty-darwin-arm64": "0.1.5",
+    "@doki-land/nifty-darwin-x64": "0.1.5",
+    "@doki-land/nifty-linux-arm64": "0.1.5",
+    "@doki-land/nifty-linux-x64": "0.1.5",
+    "@doki-land/nifty-win32-x64": "0.1.5"
   },
   "publishConfig": {
     "access": "public"
@@ -37,5 +35,11 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oovm/npm-tools.git"
-  }
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "typecheck": "tsc --noEmit"
+  },
+  "type": "module",
+  "version": "0.1.5"
 }

package/src/cli/publish-cmd.ts

@@ -16,6 +16,7 @@ export function registerPublishCommand(cli: Cli): void {
         .option("--package <name>", "cli.opt.package")
         .option("--tag <tag>", "cli.opt.tag")
         .option("--access <access>", "cli.opt.access")
+        .option("--version <version>", "cli.opt.version")
         .option("--otp <code>", "cli.opt.otp")
         .option("--totp-secret <secret>", "cli.opt.totp-secret")
         .option("--npm-token <token>", "cli.opt.npm-token")
@@ -35,6 +36,7 @@ export async function cmdPublish(options: ParsedOptions): Promise<number> {
         placeholder: flag(options, "placeholder"),
         tag: str(options, "tag"),
         access: str(options, "access") ?? "public",
+        version: str(options, "version"),
         ...(packages.length === 1
             ? { only: packages[0] }
             : packages.length > 1

package/src/cli/publish.ts

@@ -8,6 +8,7 @@ export type PublishOptions = {
     placeholder?: boolean;
     tag?: string;
     access?: string;
+    version?: string;
 };
 
 export type PublishReport = {
@@ -28,6 +29,7 @@ export async function runPublish(argv: string[]): Promise<void> {
         placeholder: options.placeholder,
         tag: options.tag,
         access: options.access,
+        version: options.version,
         ...authPayload(options.auth),
     });
     printPublishReport(report, options.dryRun);
@@ -40,6 +42,7 @@ function parsePublishArgs(argv: string[]) {
     let placeholder = false;
     let tag: string | undefined;
     let access = "public";
+    let version: string | undefined;
     const auth = parseAuthArgs(argv);
 
     for (let i = 0; i < argv.length; i += 1) {
@@ -56,6 +59,8 @@ function parsePublishArgs(argv: string[]) {
             tag = argv[++i];
         } else if (arg === "--access") {
             access = argv[++i];
+        } else if (arg === "--version") {
+            version = argv[++i];
         } else if (arg === "-h" || arg === "--help") {
             printPublishHelp();
             process.exit(0);
@@ -64,7 +69,7 @@ function parsePublishArgs(argv: string[]) {
         }
     }
 
-    return { cwd, dryRun, refresh, placeholder, tag, access, auth };
+    return { cwd, dryRun, refresh, placeholder, tag, access, version, auth };
 }
 
 export function printPublishReport(report: PublishReport, dryRun?: boolean): void {
@@ -96,6 +101,7 @@ Usage:
   nifty publish --placeholder
   nifty publish --tag next
   nifty publish --access public
+  nifty publish --version 0.3.1
   nifty publish --otp 123456
   nifty publish -C <cwd>
 

package/src/native.ts

@@ -222,6 +222,7 @@ export type PublisherExports = {
         placeholder?: boolean;
         only?: string;
         packages?: string[];
+        version?: string;
         tag?: string;
         access?: string;
         npm?: string;
@@ -303,6 +304,7 @@ type NativeBinding = {
         token?: string | null;
         only?: string | null;
         packages?: string[] | null;
+        version?: string | null;
     }) => PublishReport;
     publisherTrustWorkspace: (options: {
         cwd?: string | null;
@@ -700,6 +702,7 @@ function wrapBinding(binding: NativeBinding): NiftyNative {
                     ...(options.placeholder !== undefined ? { placeholder: options.placeholder } : {}),
                     ...(options.only !== undefined ? { only: options.only } : {}),
                     ...(options.packages !== undefined ? { packages: options.packages } : {}),
+                    ...(options.version !== undefined ? { version: options.version } : {}),
                     ...(options.tag !== undefined ? { tag: options.tag } : {}),
                     ...(options.access !== undefined ? { access: options.access } : {}),
                     ...(options.npm !== undefined ? { npm: options.npm } : {}),