@doki-land/nifty 0.0.6 → 0.0.7

package/locales/en-US/cli.json

@@ -14,6 +14,9 @@
   "cli.cmd.commit.apply": "Apply commit message edits from a JSON map and update the branch ref",
   "cli.cmd.commit.scan": "Scan commit messages for gitmoji and hygiene issues",
   "cli.cmd.commit.audit": "Audit commit messages and fail on errors",
+  "cli.opt.with-lint": "Run commit lint after export and annotate the JSON map with violations",
+  "cli.opt.json": "Print commit lint output as JSON",
+  "cli.opt.errors-only": "Only report error-level commit lint diagnostics",
   "cli.cmd.retime": "Spread commit timestamps across a date range on a new branch",
   "cli.cmd.retime.root": "Retime all commits from repository root through tip",
   "cli.cmd.change-logs": "Draft release reference changelogs from git tags",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doki-land/nifty",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Gitmoji-first commit conventions and release helpers (Node-API + TypeScript)",
   "type": "module",
   "license": "MPL-2.0",
@@ -24,9 +24,9 @@
     "jiti": "^2.4.2"
   },
   "optionalDependencies": {
-    "@doki-land/nifty-win32-x64": "0.0.6",
-    "@doki-land/nifty-linux-x64": "0.0.6",
-    "@doki-land/nifty-darwin-arm64": "0.0.6"
+    "@doki-land/nifty-win32-x64": "0.0.7",
+    "@doki-land/nifty-linux-x64": "0.0.7",
+    "@doki-land/nifty-darwin-arm64": "0.0.7"
   },
   "publishConfig": {
     "access": "public"

package/src/cli/change-logs-cmd.ts

@@ -2,6 +2,8 @@ import { join } from "node:path";
 
 import type { Cli, ParsedOptions } from "@vmz/commander";
 
+import { resolveAuthorMapPath } from "../config/authorMap.js";
+import { detectProjectLayout } from "../config/detectProject.js";
 import { loadConfig } from "../config/loadConfig.js";
 import { loadNiftyNative } from "../native.js";
 import { bootstrapFromOptions } from "./context.js";
@@ -34,6 +36,8 @@ export async function cmdChangeLogsRender(options: ParsedOptions): Promise<numbe
     await bootstrapFromOptions(options);
     const cwd = cwdFrom(options) ?? process.cwd();
     const { config } = await loadConfig({ cwd, createIfMissing: false });
+    const layout = detectProjectLayout(cwd);
+    const repoRoot = config.repoRoot ?? layout.root;
     const native = loadNiftyNative();
     const report = native.history["changelog-render"]({
         cwd,
@@ -43,7 +47,7 @@ export async function cmdChangeLogsRender(options: ParsedOptions): Promise<numbe
         write: flag(options, "write"),
         tags: flag(options, "tags"),
         repo: str(options, "repo") ?? config.changelog?.repo,
-        authorMap: str(options, "author-map") ?? config.changelog?.authorMap,
+        authorMap: str(options, "author-map") ?? resolveAuthorMapPath(config, repoRoot),
         releasesDir: str(options, "releases-dir") ?? config.changelog?.releasesDir,
     });
 
@@ -66,6 +70,8 @@ export async function cmdChangeLogsLookup(options: ParsedOptions): Promise<numbe
     await bootstrapFromOptions(options);
     const cwd = cwdFrom(options) ?? process.cwd();
     const { config } = await loadConfig({ cwd, createIfMissing: false });
+    const layout = detectProjectLayout(cwd);
+    const repoRoot = config.repoRoot ?? layout.root;
     const email = str(options, "email");
     const login = str(options, "login");
     if (!email && !login) {
@@ -76,7 +82,7 @@ export async function cmdChangeLogsLookup(options: ParsedOptions): Promise<numbe
         cwd,
         email,
         login,
-        map: str(options, "map") ?? config.changelog?.authorMap,
+        map: str(options, "map") ?? resolveAuthorMapPath(config, repoRoot),
         githubToken: str(options, "github-token") ?? config.githubToken ?? process.env.GITHUB_TOKEN,
         fetch: flag(options, "fetch"),
     });

package/src/cli/commit-cmd.ts

@@ -1,3 +1,5 @@
+import { readFile, writeFile } from "node:fs/promises";
+
 import type { Cli, ParsedOptions } from "@vmz/commander";
 
 import { loadNiftyNative } from "../native.js";
@@ -13,6 +15,8 @@ export function registerCommitCommand(cli: Cli): void {
         .option("--base <ref>", "cli.opt.base")
         .option("--ref <ref>", "cli.opt.ref")
         .option("--path <file>", "cli.opt.path")
+        .option("--with-lint", "cli.opt.with-lint")
+        .option("--errors-only", "cli.opt.errors-only")
         .action(async (options) => cmdCommitExport(options));
 
     commit
@@ -28,6 +32,8 @@ export function registerCommitCommand(cli: Cli): void {
         .option("--from <ref>", "cli.opt.from")
         .option("--to <ref>", "cli.opt.to")
         .option("-s, --subject <text>...", "cli.opt.subject")
+        .option("--json", "cli.opt.json")
+        .option("--errors-only", "cli.opt.errors-only")
         .action(async (options) => cmdCommitScan(options));
 
     commit
@@ -35,6 +41,8 @@ export function registerCommitCommand(cli: Cli): void {
         .option("--from <ref>", "cli.opt.from")
         .option("--to <ref>", "cli.opt.to")
         .option("-s, --subject <text>...", "cli.opt.subject")
+        .option("--json", "cli.opt.json")
+        .option("--errors-only", "cli.opt.errors-only")
         .action(async (options) => cmdCommitAudit(options));
 }
 
@@ -50,6 +58,22 @@ export async function cmdCommitExport(options: ParsedOptions): Promise<number> {
         path,
     });
     console.log(`export: wrote ${report.count} commit entry(ies) to ${report.path}`);
+
+    if (flag(options, "with-lint")) {
+        const errorCount = await lintAndAnnotateExport({
+            path,
+            from: base,
+            to: str(options, "ref") ?? "HEAD",
+            cwd: cwdFrom(options),
+            json: flag(options, "json"),
+            errorsOnly: flag(options, "errors-only"),
+            reportTitle: "commit export lint",
+        });
+        if (errorCount > 0) {
+            return 1;
+        }
+    }
+
     return 0;
 }
 
@@ -95,17 +119,14 @@ export async function cmdCommitApply(options: ParsedOptions): Promise<number> {
 
 export async function cmdCommitScan(options: ParsedOptions): Promise<number> {
     await bootstrapFromOptions(options);
-    await lintCommits(commitLintOptions(options), false, true);
+    await lintCommits({ ...commitLintOptions(options), reportTitle: "commit scan" }, false, true);
     return 0;
 }
 
 export async function cmdCommitAudit(options: ParsedOptions): Promise<number> {
     await bootstrapFromOptions(options);
-    const errorCount = await lintCommits(commitLintOptions(options), true, true);
-    if (errorCount > 0) {
-        throw new Error(`found ${errorCount} commit audit error(s)`);
-    }
-    return 0;
+    const errorCount = await lintCommits(commitLintOptions(options), false, true);
+    return errorCount > 0 ? 1 : 0;
 }
 
 function commitLintOptions(options: ParsedOptions): LintOptions {
@@ -116,9 +137,86 @@ function commitLintOptions(options: ParsedOptions): LintOptions {
         cwd: cwdFrom(options),
         scanCargo: false,
         commitOnly: true,
+        json: flag(options, "json"),
+        errorsOnly: flag(options, "errors-only"),
+        reportTitle: "commit audit",
     };
 }
 
+type ExportDocument = {
+    version: number;
+    entries: Array<{
+        hash: string;
+        message: string;
+        violations?: Array<{
+            rule: string;
+            severity: "error" | "warning" | "info";
+            message: string;
+        }>;
+    }>;
+};
+
+async function lintAndAnnotateExport(options: {
+    path: string;
+    from: string;
+    to: string;
+    cwd: string;
+    json: boolean;
+    errorsOnly: boolean;
+    reportTitle: string;
+}): Promise<number> {
+    const native = loadNiftyNative();
+    const report = native.lint.run({
+        cwd: options.cwd,
+        fromRef: options.from,
+        toRef: options.to,
+        commitOnly: true,
+        scanCargo: false,
+    });
+    const diagnostics = options.errorsOnly
+        ? report.diagnostics.filter((item) => item.severity === "error")
+        : report.diagnostics;
+
+    if (options.json) {
+        const { printCommitLintReport } = await import("./commit-lint-report.js");
+        printCommitLintReport(diagnostics, report.errorCount, report.warningCount, {
+            json: true,
+            errorsOnly: options.errorsOnly,
+            title: options.reportTitle,
+        });
+    } else {
+        const { printCommitLintReport } = await import("./commit-lint-report.js");
+        printCommitLintReport(diagnostics, report.errorCount, report.warningCount, {
+            errorsOnly: options.errorsOnly,
+            title: options.reportTitle,
+        });
+    }
+
+    const byHash = new Map<string, Array<{ rule: string; severity: "error" | "warning" | "info"; message: string }>>();
+    for (const item of diagnostics) {
+        if (!item.hash) {
+            continue;
+        }
+        const bucket = byHash.get(item.hash) ?? [];
+        bucket.push({ rule: item.rule, severity: item.severity, message: item.message });
+        byHash.set(item.hash, bucket);
+    }
+
+    const text = await readFile(options.path, "utf8");
+    const document = JSON.parse(text) as ExportDocument;
+    document.entries = document.entries.map((entry) => {
+        const violations = byHash.get(entry.hash);
+        if (!violations || violations.length === 0) {
+            return entry;
+        }
+        return { ...entry, violations };
+    });
+    await writeFile(options.path, `${JSON.stringify(document, null, 2)}\n`, "utf8");
+    const violationCount = document.entries.filter((entry) => entry.violations && entry.violations.length > 0).length;
+    console.log(`export: annotated ${violationCount} commit entry(ies) with lint violations in ${options.path}`);
+    return report.errorCount;
+}
+
 function requireStr(options: ParsedOptions, key: string): string {
     const value = str(options, key);
     if (!value) {

package/src/cli/commit-lint-report.ts

@@ -0,0 +1,110 @@
+export type CommitLintDiagnostic = {
+    rule: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    subject?: string;
+    hash?: string;
+    path?: string;
+    line?: number;
+};
+
+export type CommitLintReportOptions = {
+    json?: boolean;
+    errorsOnly?: boolean;
+    title?: string;
+};
+
+type CommitLintGroup = {
+    hash?: string;
+    subject?: string;
+    items: CommitLintDiagnostic[];
+};
+
+export function printCommitLintReport(
+    diagnostics: CommitLintDiagnostic[],
+    errorCount: number,
+    warningCount: number,
+    options: CommitLintReportOptions = {},
+): void {
+    const filtered = options.errorsOnly
+        ? diagnostics.filter((item) => item.severity === "error")
+        : diagnostics;
+
+    if (options.json) {
+        const payload = {
+            errorCount,
+            warningCount,
+            diagnostics: filtered,
+            groups: groupCommitDiagnostics(filtered),
+            summaryByRule: summarizeByRule(filtered),
+        };
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+
+    const title = options.title ?? "commit lint";
+    if (filtered.length === 0) {
+        console.log(`${title}: no issues found`);
+        return;
+    }
+
+    const groups = groupCommitDiagnostics(filtered);
+    const commitCount = groups.filter((group) => group.hash || group.subject).length;
+    console.log(`${title}: ${errorCount} error(s), ${warningCount} warning(s) in ${commitCount} commit(s)\n`);
+
+    for (const group of groups) {
+        printCommitGroup(group);
+    }
+
+    const summary = summarizeByRule(filtered.filter((item) => item.severity === "error"));
+    if (summary.length > 0) {
+        console.log("summary by rule:");
+        for (const [rule, count] of summary) {
+            console.log(`  ${rule}  ${count}`);
+        }
+        console.log();
+    }
+}
+
+function groupCommitDiagnostics(diagnostics: CommitLintDiagnostic[]): CommitLintGroup[] {
+    const groups = new Map<string, CommitLintGroup>();
+    const order: string[] = [];
+
+    for (const item of diagnostics) {
+        const key = item.hash ?? item.subject ?? "__inline__";
+        if (!groups.has(key)) {
+            groups.set(key, {
+                hash: item.hash,
+                subject: item.subject,
+                items: [],
+            });
+            order.push(key);
+        }
+        groups.get(key)?.items.push(item);
+    }
+
+    return order.map((key) => groups.get(key)!);
+}
+
+function summarizeByRule(diagnostics: CommitLintDiagnostic[]): Array<[string, number]> {
+    const counts = new Map<string, number>();
+    for (const item of diagnostics) {
+        counts.set(item.rule, (counts.get(item.rule) ?? 0) + 1);
+    }
+    return [...counts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]));
+}
+
+function printCommitGroup(group: CommitLintGroup): void {
+    if (group.hash || group.subject) {
+        const hash = group.hash ? `${group.hash.slice(0, 8)}  ` : "";
+        const subject = group.subject ?? "(no subject)";
+        console.log(`${hash}${subject}`);
+    } else {
+        console.log("(inline subject lint)");
+    }
+
+    for (const item of group.items) {
+        console.log(`  ${item.severity}  ${item.rule}  ${item.message}`);
+    }
+    console.log();
+}

package/src/cli/format.ts

@@ -18,7 +18,7 @@ export async function formatWorkspace(options: FormatOptions): Promise<number> {
         excludes: resolved.excludes,
         rust: resolved.rust,
         javascript: resolved.javascript,
-        styleConfig: resolved.style,
+        style: resolved.style,
     });
 
     if (report.errors.length > 0) {

package/src/cli/lint.ts

@@ -1,5 +1,6 @@
 import { loadConfig } from "../config/loadConfig.js";
 import { loadNiftyNative } from "../native.js";
+import { printCommitLintReport, type CommitLintDiagnostic } from "./commit-lint-report.js";
 
 export type LintOptions = {
     subjects: string[];
@@ -8,17 +9,12 @@ export type LintOptions = {
     cwd?: string;
     scanCargo?: boolean;
     commitOnly?: boolean;
+    json?: boolean;
+    errorsOnly?: boolean;
+    reportTitle?: string;
 };
 
-type LintDiagnostic = {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
-    subject?: string;
-    hash?: string;
-    path?: string;
-    line?: number;
-};
+type LintDiagnostic = CommitLintDiagnostic;
 
 type LintRuleConfig = {
     id: string;
@@ -59,23 +55,32 @@ export async function lintCommits(
         commitOnly: commitOnly || options.commitOnly,
     });
 
-    for (const item of report.diagnostics) {
-        printDiagnostic(item);
-    }
-
-    if (report.diagnostics.length > 0) {
-        console.log(`lint: ${report.errorCount} error(s), ${report.warningCount} warning(s)`);
+    if (commitOnly || options.commitOnly) {
+        printCommitLintReport(report.diagnostics, report.errorCount, report.warningCount, {
+            json: options.json,
+            errorsOnly: options.errorsOnly,
+            title: options.reportTitle ?? "commit lint",
+        });
     } else {
-        console.log("lint: no issues found");
+        for (const item of report.diagnostics) {
+            printWorkspaceDiagnostic(item);
+        }
+
+        if (report.diagnostics.length > 0) {
+            console.log(`lint: ${report.errorCount} error(s), ${report.warningCount} warning(s)`);
+        } else {
+            console.log("lint: no issues found");
+        }
     }
 
     return report.errorCount;
 }
 
-function printDiagnostic(item: LintDiagnostic): void {
+function printWorkspaceDiagnostic(item: LintDiagnostic): void {
     const prefix = item.severity === "error" ? "error" : item.severity === "warning" ? "warning" : "info";
     if (item.subject) {
-        console.log(`${prefix} [${item.rule}] ${item.message} (${item.subject})`);
+        const hash = item.hash ? `${item.hash.slice(0, 8)} ` : "";
+        console.log(`${prefix} [${item.rule}] ${hash}${item.message} (${item.subject})`);
         return;
     }
     const location =

package/src/config/authorMap.ts

@@ -0,0 +1,26 @@
+import { existsSync, readFileSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+
+import type { NiftyConfig } from "./types.js";
+
+/** Default path relative to repo root (email → GitHub author JSON). */
+export const DEFAULT_AUTHOR_MAP_PATH = "documentation/maintenance/author-github.json";
+
+/** Resolve configured author map path to an absolute filesystem path. */
+export function resolveAuthorMapPath(config: NiftyConfig, repoRoot: string): string {
+    const configured = config.authorMap ?? DEFAULT_AUTHOR_MAP_PATH;
+    return isAbsolute(configured) ? configured : join(repoRoot, configured);
+}
+
+/** Load author map file contents for native helpers expecting JSON text. */
+export function loadAuthorMapJson(repoRoot: string, authorMapPath?: string): string {
+    const abs = authorMapPath
+        ? isAbsolute(authorMapPath)
+            ? authorMapPath
+            : join(repoRoot, authorMapPath)
+        : resolveAuthorMapPath({}, repoRoot);
+    if (!existsSync(abs)) {
+        return "{}";
+    }
+    return readFileSync(abs, "utf8");
+}

package/src/config/formatPresets.ts

@@ -1,4 +1,4 @@
-import type { NiftyFormatConfig, NiftyFormatPreset } from "./types.js";
+import type { NiftyFormatConfig, NiftyFormatPreset, NiftyFormatStyleConfig } from "./types.js";
 
 export type ResolvedFormatOptions = {
     preset: NiftyFormatPreset;
@@ -6,16 +6,22 @@ export type ResolvedFormatOptions = {
     excludes?: string[];
     rust?: boolean;
     javascript?: boolean;
-    style?: string;
+    style: NiftyFormatStyleConfig;
 };
 
-const NPM_TOOLS_INCLUDES = [
+const DEFAULT_FORMAT_STYLE: NiftyFormatStyleConfig = {
+    indentStyle: "space",
+    indentWidth: 4,
+    lineWidth: 144,
+    quoteStyle: "single",
+};
+
+const NIFTY_PRESET_INCLUDES = [
     "scripts/**",
     "projects/packages/**",
     "projects/conformance/**",
     "projects/dashboard/**",
     "package.json",
-    "biome.json",
     "nifty.config.ts",
 ] as const;
 
@@ -30,13 +36,13 @@ const VMZ_INCLUDES = [
     "packages/content/**",
     "packages/homepage/**",
     "package.json",
-    "biome.json",
     "nifty.config.ts",
 ] as const;
 
 const PRESET_INCLUDES: Record<NiftyFormatPreset, readonly string[] | undefined> = {
     default: undefined,
-    "npm-tools": NPM_TOOLS_INCLUDES,
+    nifty: NIFTY_PRESET_INCLUDES,
+    "npm-tools": NIFTY_PRESET_INCLUDES,
     vmz: VMZ_INCLUDES,
 };
 
@@ -50,6 +56,9 @@ export function resolveFormatConfig(format: NiftyFormatConfig | undefined): Reso
         excludes: format?.excludes,
         rust: format?.rust,
         javascript: format?.javascript,
-        style: format?.style,
+        style: {
+            ...DEFAULT_FORMAT_STYLE,
+            ...format?.style,
+        },
     };
 }

package/src/config/index.ts

@@ -8,7 +8,11 @@ export {
     type ProjectLayout,
 } from "./detectProject.js";
 export {
-    authorMapToJson,
+    DEFAULT_AUTHOR_MAP_PATH,
+    loadAuthorMapJson,
+    resolveAuthorMapPath,
+} from "./authorMap.js";
+export {
     defaultConfigPath,
     ensureConfigFile,
     findConfigFile,
@@ -25,4 +29,5 @@ export {
     type NiftyConfigExport,
     type NiftyFormatConfig,
     type NiftyFormatPreset,
+    type NiftyFormatStyleConfig,
 } from "./types.js";

package/src/config/loadConfig.ts

@@ -28,7 +28,7 @@ export type LoadedNiftyConfig = {
 };
 
 const DEFAULT_CONFIG_TEMPLATE = `// Nifty project configuration.
-// See @doki-land/nifty for defineConfig, format presets, authorMap, and lint rules.
+// See @doki-land/nifty for defineConfig, format presets, authorMap path, and lint rules.
 export default {};
 `;
 
@@ -120,10 +120,3 @@ export async function loadConfig(options: LoadConfigOptions = {}): Promise<Loade
     return { config, configFile, created };
 }
 
-/** Serialize `authorMap` for native helpers expecting JSON text. */
-export function authorMapToJson(authorMap: NiftyConfig["authorMap"]): string {
-    if (!authorMap || Object.keys(authorMap).length === 0) {
-        return "{}";
-    }
-    return JSON.stringify(authorMap);
-}

package/src/config/types.ts

@@ -1,15 +1,27 @@
-/** GitHub author entry in `authorMap` (same shape as `author-github.json`). */
+/** One email → GitHub author row in `author-github.json`. */
 export type NiftyAuthorEntry = {
     id?: number;
     login?: string;
 };
 
 /** Built-in workspace format presets (`nifty.config` `format.preset`). */
-export type NiftyFormatPreset = "default" | "npm-tools" | "vmz";
+export type NiftyFormatPreset = "default" | "nifty" | "npm-tools" | "vmz";
+
+/** `oxc_formatter` style knobs (`nifty.config` `format.style`). */
+export type NiftyFormatStyleConfig = {
+    /** Indent with spaces or tabs (default: `space`). */
+    indentStyle?: "space" | "tab";
+    /** Spaces or tabs per indent level (default: `4`). */
+    indentWidth?: number;
+    /** Soft line width (default: `144`). */
+    lineWidth?: number;
+    /** String quote preference (default: `single`). */
+    quoteStyle?: "single" | "double";
+};
 
 /** Workspace format options (`nifty format` reads `nifty.config` `format`). */
 export type NiftyFormatConfig = {
-    /** Select built-in include roots. Use `vmz` for the VMZ hybrid monorepo. */
+    /** Select built-in include roots for Nifty hybrid monorepos. */
     preset?: NiftyFormatPreset;
     /** Extra include globs (override preset list when set alone). */
     includes?: string[];
@@ -19,16 +31,16 @@ export type NiftyFormatConfig = {
     rust?: boolean;
     /** Run `oxc_formatter` on JS/TS targets (default: true). */
     javascript?: boolean;
-    /** Biome-style formatter config for oxc (default: `biome.json` at project root). */
-    style?: string;
+    /** Inline oxc formatter style (not an external config file path). */
+    style?: NiftyFormatStyleConfig;
 };
 
 /** Nifty project configuration (`nifty.config.ts` / `nifty.config.js`). */
 export type NiftyConfig = {
     /** GitHub personal access token for email search / profile fetch. */
     githubToken?: string;
-    /** Email → GitHub author mapping. */
-    authorMap?: Record<string, NiftyAuthorEntry>;
+    /** Path to `author-github.json` (default: `documentation/maintenance/author-github.json`). */
+    authorMap?: string;
     /** Repository root override when discovering git metadata. */
     repoRoot?: string;
     /** Cargo workspace / crate root override. */
@@ -44,8 +56,6 @@ export type NiftyConfig = {
     changelog?: {
         /** GitHub `owner/repo` for contrib.rocks (default: parse `origin`). */
         repo?: string;
-        /** Email → GitHub map path (default: `documentation/maintenance/author-github.json`). */
-        authorMap?: string;
         /** `--write` output directory (default: `documentation/maintenance/releases`). */
         releasesDir?: string;
     };

package/src/index.ts

@@ -21,7 +21,9 @@ export {
     defineConfig,
     loadConfig,
     findConfigFile,
-    authorMapToJson,
+    DEFAULT_AUTHOR_MAP_PATH,
+    loadAuthorMapJson,
+    resolveAuthorMapPath,
     detectProjectLayout,
     discoverPackageDirs,
     findCargoManifest,
@@ -34,6 +36,7 @@ export {
     type NiftyConfigEnv,
     type NiftyFormatConfig,
     type NiftyFormatPreset,
+    type NiftyFormatStyleConfig,
     type ProjectKind,
     type ProjectLayout,
     type ResolvedFormatOptions,

package/src/native.ts

@@ -199,6 +199,13 @@ export type FormatReportRecord = {
     errors: string[];
 };
 
+export type FormatterStyleOptions = {
+    indentStyle?: string;
+    indentWidth?: number;
+    lineWidth?: number;
+    quoteStyle?: string;
+};
+
 export type FormatterRunOptions = {
     cwd?: string;
     check?: boolean;
@@ -206,7 +213,7 @@ export type FormatterRunOptions = {
     excludes?: string[];
     rust?: boolean;
     javascript?: boolean;
-    styleConfig?: string;
+    style?: FormatterStyleOptions;
 };
 
 export type FormatterExports = {
@@ -451,7 +458,7 @@ type NativeBinding = {
         excludes?: string[] | null;
         rust?: boolean | null;
         javascript?: boolean | null;
-        styleConfig?: string | null;
+        style?: FormatterStyleOptions | null;
     }) => {
         formatted: number;
         unchanged: number;
@@ -679,7 +686,7 @@ function wrapBinding(binding: NativeBinding): NiftyNative {
                     ...(options.excludes !== undefined ? { excludes: options.excludes } : {}),
                     ...(options.rust !== undefined ? { rust: options.rust } : {}),
                     ...(options.javascript !== undefined ? { javascript: options.javascript } : {}),
-                    ...(options.styleConfig !== undefined ? { styleConfig: options.styleConfig } : {}),
+                    ...(options.style !== undefined ? { style: options.style } : {}),
                 }),
         },
         publisher: {

package/src/nifty.ts

@@ -1,6 +1,6 @@
 import {
-    authorMapToJson,
     detectProjectLayout,
+    loadAuthorMapJson,
     loadConfig,
     type LoadConfigOptions,
     type NiftyConfig,
@@ -79,8 +79,9 @@ export class Nifty {
         );
 
         const native = loadNiftyNative();
+        const resolvedRepoRoot = merged.repoRoot ?? layout.root;
         return new Nifty(
-            new Gitmoji(native.gitmoji, authorMapToJson(merged.authorMap)),
+            new Gitmoji(native.gitmoji, loadAuthorMapJson(resolvedRepoRoot, merged.authorMap)),
             new Git(native.git),
             Github.open(merged.githubToken),
             merged,