@doki-land/nifty 0.0.0 → 0.0.1

package/src/config/index.ts

@@ -1,25 +1,25 @@
-export { defineConfig } from "./defineConfig.js";
-export {
-    detectProjectLayout,
-    discoverPackageDirs,
-    findCargoManifest,
-    findPackageManifest,
-    type ProjectKind,
-    type ProjectLayout,
-} from "./detectProject.js";
-export {
-    authorMapToJson,
-    defaultConfigPath,
-    ensureConfigFile,
-    findConfigFile,
-    loadConfig,
-    type LoadConfigOptions,
-    type LoadedNiftyConfig,
-} from "./loadConfig.js";
-export {
-    CONFIG_FILE_NAMES,
-    type NiftyAuthorEntry,
-    type NiftyConfig,
-    type NiftyConfigEnv,
-    type NiftyConfigExport,
-} from "./types.js";
+export { defineConfig } from "./defineConfig.js";
+export {
+    detectProjectLayout,
+    discoverPackageDirs,
+    findCargoManifest,
+    findPackageManifest,
+    type ProjectKind,
+    type ProjectLayout,
+} from "./detectProject.js";
+export {
+    authorMapToJson,
+    defaultConfigPath,
+    ensureConfigFile,
+    findConfigFile,
+    loadConfig,
+    type LoadConfigOptions,
+    type LoadedNiftyConfig,
+} from "./loadConfig.js";
+export {
+    CONFIG_FILE_NAMES,
+    type NiftyAuthorEntry,
+    type NiftyConfig,
+    type NiftyConfigEnv,
+    type NiftyConfigExport,
+} from "./types.js";

package/src/config/loadConfig.ts

@@ -1,129 +1,129 @@
-import { existsSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { createJiti } from "jiti";
-
-import type { NiftyConfig, NiftyConfigEnv, NiftyConfigExport } from "./types.js";
-import { CONFIG_FILE_NAMES } from "./types.js";
-import { detectProjectLayout } from "./detectProject.js";
-
-export type LoadConfigOptions = {
-    /** Directory to start searching from (defaults to `process.cwd()`). */
-    cwd?: string;
-    /** When set, skip searching and load this file directly. */
-    configFile?: string;
-    /** Passed to functional configs: `export default defineConfig(({ mode }) => ...)`. */
-    env?: Partial<NiftyConfigEnv>;
-    /**
-     * When true (default), write `nifty.config.ts` at the detected project root if missing.
-     * Set false for `--dry-run` so commands only report what would happen.
-     */
-    createIfMissing?: boolean;
-};
-
-export type LoadedNiftyConfig = {
-    config: NiftyConfig;
-    configFile?: string;
-    /** True when this run created a new config file. */
-    created?: boolean;
-};
-
-const DEFAULT_CONFIG_TEMPLATE = `// Nifty project configuration.
-// See @doki-land/nifty for defineConfig, githubToken, authorMap, and lint rules.
-export default {};
-`;
-
-const DEFAULT_ENV = (cwd: string): NiftyConfigEnv => ({
-    mode: process.env.NODE_ENV ?? "development",
-    command: "serve",
-    layout: detectProjectLayout(cwd),
-});
-
-/** Walk upward and return the nearest existing Nifty config file. */
-export function findConfigFile(cwd = process.cwd()): string | undefined {
-    let here = resolve(cwd);
-    while (true) {
-        for (const name of CONFIG_FILE_NAMES) {
-            const candidate = join(here, name);
-            if (existsSync(candidate)) {
-                return candidate;
-            }
-        }
-        const parent = dirname(here);
-        if (parent === here) {
-            return undefined;
-        }
-        here = parent;
-    }
-}
-
-/** Default config path at the detected project root (prefers `nifty.config.ts`). */
-export function defaultConfigPath(cwd = process.cwd()): string {
-    const layout = detectProjectLayout(cwd);
-    return join(layout.root, CONFIG_FILE_NAMES[0]);
-}
-
-/** Warn and optionally create a default config when none exists. */
-export function ensureConfigFile(options: { cwd?: string; create?: boolean } = {}): string | undefined {
-    const cwd = options.cwd ?? process.cwd();
-    const existing = findConfigFile(cwd);
-    if (existing) {
-        return existing;
-    }
-
-    const target = defaultConfigPath(cwd);
-    if (options.create) {
-        writeFileSync(target, DEFAULT_CONFIG_TEMPLATE, "utf8");
-        console.warn(`nifty: no config found, created default ${target}`);
-        return target;
-    }
-
-    console.warn(`nifty: no nifty.config.* found near ${detectProjectLayout(cwd).root} (using defaults)`);
-    return undefined;
-}
-
-function normalizeExport(raw: unknown): NiftyConfigExport {
-    if (raw && typeof raw === "object" && "default" in raw) {
-        return (raw as { default: NiftyConfigExport }).default;
-    }
-    return raw as NiftyConfigExport;
-}
-
-async function resolveExport(exported: NiftyConfigExport, env: NiftyConfigEnv): Promise<NiftyConfig> {
-    if (typeof exported === "function") {
-        return await exported(env);
-    }
-    return exported;
-}
-
-/** Load `nifty.config.ts/js`, creating a default file at the project root when missing. */
-export async function loadConfig(options: LoadConfigOptions = {}): Promise<LoadedNiftyConfig> {
-    const cwd = options.cwd ?? process.cwd();
-    let configFile = options.configFile ?? findConfigFile(cwd);
-    let created = false;
-
-    if (!configFile && options.createIfMissing !== false) {
-        configFile = ensureConfigFile({ cwd, create: true });
-        created = Boolean(configFile);
-    } else if (!configFile) {
-        ensureConfigFile({ cwd, create: false });
-        return { config: {} };
-    }
-
-    if (!configFile) {
-        return { config: {} };
-    }
-
-    const env: NiftyConfigEnv = { ...DEFAULT_ENV(cwd), ...options.env };
-    const jiti = createJiti(import.meta.url, { interopDefault: true });
-    const mod = await jiti.import(configFile);
-    const config = await resolveExport(normalizeExport(mod), env);
-    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);
-}
+import { existsSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { createJiti } from "jiti";
+
+import type { NiftyConfig, NiftyConfigEnv, NiftyConfigExport } from "./types.js";
+import { CONFIG_FILE_NAMES } from "./types.js";
+import { detectProjectLayout } from "./detectProject.js";
+
+export type LoadConfigOptions = {
+    /** Directory to start searching from (defaults to `process.cwd()`). */
+    cwd?: string;
+    /** When set, skip searching and load this file directly. */
+    configFile?: string;
+    /** Passed to functional configs: `export default defineConfig(({ mode }) => ...)`. */
+    env?: Partial<NiftyConfigEnv>;
+    /**
+     * When true (default), write `nifty.config.ts` at the detected project root if missing.
+     * Set false for `--dry-run` so commands only report what would happen.
+     */
+    createIfMissing?: boolean;
+};
+
+export type LoadedNiftyConfig = {
+    config: NiftyConfig;
+    configFile?: string;
+    /** True when this run created a new config file. */
+    created?: boolean;
+};
+
+const DEFAULT_CONFIG_TEMPLATE = `// Nifty project configuration.
+// See @doki-land/nifty for defineConfig, githubToken, authorMap, and lint rules.
+export default {};
+`;
+
+const DEFAULT_ENV = (cwd: string): NiftyConfigEnv => ({
+    mode: process.env.NODE_ENV ?? "development",
+    command: "serve",
+    layout: detectProjectLayout(cwd),
+});
+
+/** Walk upward and return the nearest existing Nifty config file. */
+export function findConfigFile(cwd = process.cwd()): string | undefined {
+    let here = resolve(cwd);
+    while (true) {
+        for (const name of CONFIG_FILE_NAMES) {
+            const candidate = join(here, name);
+            if (existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        const parent = dirname(here);
+        if (parent === here) {
+            return undefined;
+        }
+        here = parent;
+    }
+}
+
+/** Default config path at the detected project root (prefers `nifty.config.ts`). */
+export function defaultConfigPath(cwd = process.cwd()): string {
+    const layout = detectProjectLayout(cwd);
+    return join(layout.root, CONFIG_FILE_NAMES[0]);
+}
+
+/** Warn and optionally create a default config when none exists. */
+export function ensureConfigFile(options: { cwd?: string; create?: boolean } = {}): string | undefined {
+    const cwd = options.cwd ?? process.cwd();
+    const existing = findConfigFile(cwd);
+    if (existing) {
+        return existing;
+    }
+
+    const target = defaultConfigPath(cwd);
+    if (options.create) {
+        writeFileSync(target, DEFAULT_CONFIG_TEMPLATE, "utf8");
+        console.warn(`nifty: no config found, created default ${target}`);
+        return target;
+    }
+
+    console.warn(`nifty: no nifty.config.* found near ${detectProjectLayout(cwd).root} (using defaults)`);
+    return undefined;
+}
+
+function normalizeExport(raw: unknown): NiftyConfigExport {
+    if (raw && typeof raw === "object" && "default" in raw) {
+        return (raw as { default: NiftyConfigExport }).default;
+    }
+    return raw as NiftyConfigExport;
+}
+
+async function resolveExport(exported: NiftyConfigExport, env: NiftyConfigEnv): Promise<NiftyConfig> {
+    if (typeof exported === "function") {
+        return await exported(env);
+    }
+    return exported;
+}
+
+/** Load `nifty.config.ts/js`, creating a default file at the project root when missing. */
+export async function loadConfig(options: LoadConfigOptions = {}): Promise<LoadedNiftyConfig> {
+    const cwd = options.cwd ?? process.cwd();
+    let configFile = options.configFile ?? findConfigFile(cwd);
+    let created = false;
+
+    if (!configFile && options.createIfMissing !== false) {
+        configFile = ensureConfigFile({ cwd, create: true });
+        created = Boolean(configFile);
+    } else if (!configFile) {
+        ensureConfigFile({ cwd, create: false });
+        return { config: {} };
+    }
+
+    if (!configFile) {
+        return { config: {} };
+    }
+
+    const env: NiftyConfigEnv = { ...DEFAULT_ENV(cwd), ...options.env };
+    const jiti = createJiti(import.meta.url, { interopDefault: true });
+    const mod = await jiti.import(configFile);
+    const config = await resolveExport(normalizeExport(mod), env);
+    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,43 +1,43 @@
-/** GitHub author entry in `authorMap` (same shape as `author-github.json`). */
-export type NiftyAuthorEntry = {
-    id?: number;
-    login?: string;
-};
-
-/** 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>;
-    /** Repository root override when discovering git metadata. */
-    repoRoot?: string;
-    /** Cargo workspace / crate root override. */
-    cargoRoot?: string;
-    /** npm package root override. */
-    npmRoot?: string;
-    /** Rule-based lint configuration. */
-    lint?: {
-        rules?: Array<{
-            id: string;
-            enabled?: boolean;
-            severity?: "error" | "warning" | "info";
-        }>;
-    };
-};
-
-export type NiftyConfigExport = NiftyConfig | ((env: NiftyConfigEnv) => NiftyConfig | Promise<NiftyConfig>);
-
-export type NiftyConfigEnv = {
-    mode: string;
-    command: string;
-    /** Detected cargo + npm project layout for hybrid monorepos. */
-    layout: import("./detectProject.js").ProjectLayout;
-};
-
-export const CONFIG_FILE_NAMES = [
-    "nifty.config.ts",
-    "nifty.config.js",
-    "nifty.config.mjs",
-    "nifty.config.cjs",
-] as const;
+/** GitHub author entry in `authorMap` (same shape as `author-github.json`). */
+export type NiftyAuthorEntry = {
+    id?: number;
+    login?: string;
+};
+
+/** 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>;
+    /** Repository root override when discovering git metadata. */
+    repoRoot?: string;
+    /** Cargo workspace / crate root override. */
+    cargoRoot?: string;
+    /** npm package root override. */
+    npmRoot?: string;
+    /** Rule-based lint configuration. */
+    lint?: {
+        rules?: Array<{
+            id: string;
+            enabled?: boolean;
+            severity?: "error" | "warning" | "info";
+        }>;
+    };
+};
+
+export type NiftyConfigExport = NiftyConfig | ((env: NiftyConfigEnv) => NiftyConfig | Promise<NiftyConfig>);
+
+export type NiftyConfigEnv = {
+    mode: string;
+    command: string;
+    /** Detected cargo + npm project layout for hybrid monorepos. */
+    layout: import("./detectProject.js").ProjectLayout;
+};
+
+export const CONFIG_FILE_NAMES = [
+    "nifty.config.ts",
+    "nifty.config.js",
+    "nifty.config.mjs",
+    "nifty.config.cjs",
+] as const;

package/src/git.ts

@@ -1,61 +1,61 @@
-import type { CommitRecord, RangeInfo, TagInfo } from "./types.js";
-import { loadNiftyNative, mapCommitRecord, mapRangeInfo, mapTagInfo, type GitExports } from "./native.js";
-
-export type ResolveRangeOptions = {
-    version?: string;
-    fromRef?: string;
-    toRef?: string;
-};
-
-/**
- * Read-only git repository helpers (gix via Node-API, no `git` subprocess).
- */
-export class Git {
-    constructor(private readonly wasm: GitExports) {}
-
-    static open(): Git {
-        const native = loadNiftyNative();
-        return new Git(native.git);
-    }
-
-    /** Walk upward from `startPath` to find the working tree root containing `.git`. */
-    discoverRoot(startPath: string): string {
-        return this.wasm["discover-root"](startPath);
-    }
-
-    /** List `v*` tags sorted by semver. */
-    listVersionTags(repoRoot: string): string[] {
-        return this.wasm["list-version-tags"](repoRoot);
-    }
-
-    listTagInfos(repoRoot: string): TagInfo[] {
-        return this.wasm["list-tag-infos"](repoRoot).map(mapTagInfo);
-    }
-
-    formatTagList(repoRoot: string): string {
-        return this.wasm["format-tag-list"](repoRoot);
-    }
-
-    resolveRange(repoRoot: string, options: ResolveRangeOptions = {}): RangeInfo {
-        return mapRangeInfo(
-            this.wasm["resolve-range"](repoRoot, options.version, options.fromRef, options.toRef),
-        );
-    }
-
-    /** Collect non-merge commits in `fromRef..toRef` (exclusive..inclusive). */
-    collectCommits(repoRoot: string, fromRef: string | undefined, toRef: string): CommitRecord[] {
-        return this.wasm["collect-commits"](repoRoot, fromRef, toRef).map(mapCommitRecord);
-    }
-
-    detectGithubRepo(repoRoot: string): string | undefined {
-        return this.wasm["detect-github-repo"](repoRoot);
-    }
-
-    parseGithubRemote(url: string): string | undefined {
-        return this.wasm["parse-github-remote"](url);
-    }
-}
-
-export function createGit(): Git {
-    return Git.open();
-}
+import type { CommitRecord, RangeInfo, TagInfo } from "./types.js";
+import { loadNiftyNative, mapCommitRecord, mapRangeInfo, mapTagInfo, type GitExports } from "./native.js";
+
+export type ResolveRangeOptions = {
+    version?: string;
+    fromRef?: string;
+    toRef?: string;
+};
+
+/**
+ * Read-only git repository helpers (gix via Node-API, no `git` subprocess).
+ */
+export class Git {
+    constructor(private readonly wasm: GitExports) {}
+
+    static open(): Git {
+        const native = loadNiftyNative();
+        return new Git(native.git);
+    }
+
+    /** Walk upward from `startPath` to find the working tree root containing `.git`. */
+    discoverRoot(startPath: string): string {
+        return this.wasm["discover-root"](startPath);
+    }
+
+    /** List `v*` tags sorted by semver. */
+    listVersionTags(repoRoot: string): string[] {
+        return this.wasm["list-version-tags"](repoRoot);
+    }
+
+    listTagInfos(repoRoot: string): TagInfo[] {
+        return this.wasm["list-tag-infos"](repoRoot).map(mapTagInfo);
+    }
+
+    formatTagList(repoRoot: string): string {
+        return this.wasm["format-tag-list"](repoRoot);
+    }
+
+    resolveRange(repoRoot: string, options: ResolveRangeOptions = {}): RangeInfo {
+        return mapRangeInfo(
+            this.wasm["resolve-range"](repoRoot, options.version, options.fromRef, options.toRef),
+        );
+    }
+
+    /** Collect non-merge commits in `fromRef..toRef` (exclusive..inclusive). */
+    collectCommits(repoRoot: string, fromRef: string | undefined, toRef: string): CommitRecord[] {
+        return this.wasm["collect-commits"](repoRoot, fromRef, toRef).map(mapCommitRecord);
+    }
+
+    detectGithubRepo(repoRoot: string): string | undefined {
+        return this.wasm["detect-github-repo"](repoRoot);
+    }
+
+    parseGithubRemote(url: string): string | undefined {
+        return this.wasm["parse-github-remote"](url);
+    }
+}
+
+export function createGit(): Git {
+    return Git.open();
+}