@viewlint/create-config 0.0.1

package/README.md

@@ -0,0 +1,25 @@
+# @viewlint/create-config
+
+Interactive initializer for ViewLint configuration.
+
+## Usage
+
+```bash
+npx @viewlint/create-config
+```
+
+Or:
+
+```bash
+npm init @viewlint/config
+```
+
+## What it does
+
+- Asks which preset to use (`@viewlint/rules` recommended vs all)
+- Asks whether to generate a TypeScript or JavaScript config
+- Writes a `viewlint.config.ts` or `viewlint.config.mjs` file
+- Optionally installs required dependencies as dev dependencies
+- If you choose to install dependencies and no `package.json` exists, it can create a minimal one
+
+For more info, see the [docs](https://viewlint.vercel.app/docs/getting-started)

package/bin/create-config.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+import { run } from "../dist/index.js"
+
+try {
+	const exitCode = await run(process.argv)
+	process.exitCode = exitCode
+} catch (error) {
+	const message = error instanceof Error ? error.message : String(error)
+	process.stderr.write(`${message}\n`)
+	process.exitCode = 1
+}

package/dist/applySetupPlan.d.ts

@@ -0,0 +1,22 @@
+import { type SpawnSyncLike } from "./installDependencies.js";
+import type { SetupPlan } from "./promptForSetupPlan.js";
+export type ApplySetupPlanResult = {
+    exitCode: number;
+    configFilePath: string | null;
+    existingConfigFilePath: string | null;
+    createdPackageJsonPath: string | null;
+    installed: boolean;
+};
+export declare function applySetupPlan(opts: {
+    cwd: string;
+    plan: SetupPlan;
+    runtime?: {
+        platform?: NodeJS.Platform;
+        spawnSync?: SpawnSyncLike;
+        stat?: (filePath: string) => Promise<{
+            isFile(): boolean;
+        }>;
+        writeFile?: (filePath: string, contents: string, encoding: "utf8") => Promise<void>;
+    };
+}): Promise<ApplySetupPlanResult>;
+//# sourceMappingURL=applySetupPlan.d.ts.map

package/dist/applySetupPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applySetupPlan.d.ts","sourceRoot":"","sources":["../src/applySetupPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,aAAa,EAClB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAMxD,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,SAAS,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;QAC1B,SAAS,CAAC,EAAE,aAAa,CAAA;QACzB,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,MAAM,IAAI,OAAO,CAAA;SAAE,CAAC,CAAA;QAC3D,SAAS,CAAC,EAAE,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAA;KAClB,CAAA;CACD,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8EhC"}

package/dist/applySetupPlan.js

@@ -0,0 +1,75 @@
+import { installDependencies, } from "./installDependencies.js";
+import { writePackageJsonIfMissing } from "./packageJson.js";
+import { findExistingViewlintConfigFile, writeViewlintConfigFile, } from "./viewlintConfigFile.js";
+export async function applySetupPlan(opts) {
+    const existingConfigFilePath = await findExistingViewlintConfigFile({
+        cwd: opts.cwd,
+        runtime: opts.runtime ? { stat: opts.runtime.stat } : undefined,
+    });
+    if (existingConfigFilePath) {
+        return {
+            exitCode: 1,
+            configFilePath: null,
+            existingConfigFilePath,
+            createdPackageJsonPath: null,
+            installed: false,
+        };
+    }
+    const configFilePath = await writeViewlintConfigFile({
+        cwd: opts.cwd,
+        preset: opts.plan.preset,
+        language: opts.plan.language,
+        runtime: opts.runtime ? { writeFile: opts.runtime.writeFile } : undefined,
+    });
+    if (!opts.plan.installNow) {
+        return {
+            exitCode: 0,
+            configFilePath,
+            existingConfigFilePath: null,
+            createdPackageJsonPath: null,
+            installed: false,
+        };
+    }
+    let createdPackageJsonPath = null;
+    if (opts.plan.createPackageJson) {
+        const created = await writePackageJsonIfMissing({
+            cwd: opts.cwd,
+            runtime: opts.runtime
+                ? {
+                    stat: opts.runtime.stat,
+                    writeFile: opts.runtime.writeFile,
+                }
+                : undefined,
+        });
+        createdPackageJsonPath = created?.filePath ?? null;
+    }
+    const packageManager = opts.plan.packageManager;
+    if (!packageManager) {
+        return {
+            exitCode: 1,
+            configFilePath,
+            existingConfigFilePath: null,
+            createdPackageJsonPath,
+            installed: false,
+        };
+    }
+    const installExitCode = await installDependencies({
+        cwd: opts.cwd,
+        packageManager,
+        dependencies: opts.plan.dependencies,
+        runtime: opts.runtime
+            ? {
+                platform: opts.runtime.platform,
+                spawnSync: opts.runtime.spawnSync,
+                stat: opts.runtime.stat,
+            }
+            : undefined,
+    });
+    return {
+        exitCode: installExitCode,
+        configFilePath,
+        existingConfigFilePath: null,
+        createdPackageJsonPath,
+        installed: installExitCode === 0,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { SetupPlan } from "./promptForSetupPlan.js";
+type PromptForSetupPlan = (opts: {
+    cwd: string;
+}) => Promise<SetupPlan | null>;
+export declare function run(_argv: string[]): Promise<number>;
+export declare function runInternal(opts: {
+    cwd: string;
+    prompt: PromptForSetupPlan;
+}): Promise<number>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAIxD,KAAK,kBAAkB,GAAG,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;AAE9E,wBAAsB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAM1D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,kBAAkB,CAAA;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB"}

package/dist/index.js

@@ -0,0 +1,37 @@
+import { applySetupPlan } from "./applySetupPlan.js";
+import { promptForSetupPlan } from "./promptForSetupPlan.js";
+import { findExistingViewlintConfigFile } from "./viewlintConfigFile.js";
+export async function run(_argv) {
+    // argv reserved for future non-interactive flags
+    return runInternal({
+        cwd: process.cwd(),
+        prompt: promptForSetupPlan,
+    });
+}
+export async function runInternal(opts) {
+    const existingConfigFile = await findExistingViewlintConfigFile({
+        cwd: opts.cwd,
+    });
+    if (existingConfigFile) {
+        process.stderr.write(`A ViewLint config file already exists at ${existingConfigFile}. Remove it and re-run this initializer.\n`);
+        return 1;
+    }
+    const plan = await opts.prompt({ cwd: opts.cwd });
+    if (plan === null)
+        return 0;
+    const result = await applySetupPlan({ cwd: opts.cwd, plan });
+    if (result.existingConfigFilePath) {
+        process.stderr.write(`A ViewLint config file already exists at ${result.existingConfigFilePath}. Remove it and re-run this initializer.\n`);
+        return result.exitCode;
+    }
+    if (result.createdPackageJsonPath) {
+        process.stdout.write(`Created ${result.createdPackageJsonPath}\n`);
+    }
+    if (result.configFilePath) {
+        process.stdout.write(`Created ${result.configFilePath}\n`);
+    }
+    if (!plan.installNow) {
+        process.stdout.write(`Next: install ${plan.dependencies.join(", ")} and run viewlint.\n`);
+    }
+    return result.exitCode;
+}

package/dist/installDependencies.d.ts

@@ -0,0 +1,31 @@
+import type { PackageManager } from "./promptForSetupPlan.js";
+type InstallCommand = {
+    command: string;
+    args: string[];
+};
+export type SpawnSyncLike = (command: string, args: string[], options: {
+    cwd: string;
+    encoding: "utf8";
+    stdio: "inherit";
+}) => {
+    status: number | null;
+    error?: unknown;
+};
+export declare function getInstallCommand(opts: {
+    packageManager: PackageManager;
+    dependencies: readonly string[];
+}): InstallCommand;
+export declare function installDependencies(opts: {
+    cwd: string;
+    packageManager: PackageManager;
+    dependencies: readonly string[];
+    runtime?: {
+        platform?: NodeJS.Platform;
+        spawnSync?: SpawnSyncLike;
+        stat?: (filePath: string) => Promise<{
+            isFile(): boolean;
+        }>;
+    };
+}): Promise<number>;
+export {};
+//# sourceMappingURL=installDependencies.d.ts.map

package/dist/installDependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installDependencies.d.ts","sourceRoot":"","sources":["../src/installDependencies.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,KAAK,cAAc,GAAG;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;CACd,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IACR,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;CAChB,KACG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAU/C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,cAAc,EAAE,cAAc,CAAA;IAC9B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CAC/B,GAAG,cAAc,CAqBjB;AAoBD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,cAAc,CAAA;IAC9B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;QAC1B,SAAS,CAAC,EAAE,aAAa,CAAA;QACzB,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,MAAM,IAAI,OAAO,CAAA;SAAE,CAAC,CAAA;KAC3D,CAAA;CACD,GAAG,OAAO,CAAC,MAAM,CAAC,CAsClB"}

package/dist/installDependencies.js

@@ -0,0 +1,62 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+function getPlatformCommand(command, platform) {
+    if (platform !== "win32")
+        return command;
+    return `${command}.cmd`;
+}
+export function getInstallCommand(opts) {
+    const deps = [...opts.dependencies];
+    if (opts.packageManager === "npm") {
+        return { command: "npm", args: ["install", "--save-dev", ...deps] };
+    }
+    if (opts.packageManager === "yarn") {
+        return { command: "yarn", args: ["add", "--dev", ...deps] };
+    }
+    if (opts.packageManager === "pnpm") {
+        return { command: "pnpm", args: ["add", "--save-dev", ...deps] };
+    }
+    if (opts.packageManager === "bun") {
+        return { command: "bun", args: ["add", "--dev", ...deps] };
+    }
+    const _exhaustive = opts.packageManager;
+    throw new Error(`Unsupported package manager: ${_exhaustive}`);
+}
+async function assertHasPackageJson(cwd, stat) {
+    const packageJsonPath = path.join(cwd, "package.json");
+    try {
+        const stats = await stat(packageJsonPath);
+        if (!stats.isFile()) {
+            throw new Error(`Expected ${packageJsonPath} to be a file.`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Cannot install dependencies because no package.json was found at ${packageJsonPath}. (${message})`);
+    }
+}
+export async function installDependencies(opts) {
+    const platform = opts.runtime?.platform ?? process.platform;
+    const spawn = opts.runtime?.spawnSync ?? spawnSync;
+    const stat = opts.runtime?.stat ?? fs.stat;
+    await assertHasPackageJson(opts.cwd, stat);
+    const install = getInstallCommand({
+        packageManager: opts.packageManager,
+        dependencies: opts.dependencies,
+    });
+    process.stdout.write(`Installing dev dependencies using ${opts.packageManager}: ${opts.dependencies.join(", ")}\n`);
+    const result = spawn(getPlatformCommand(install.command, platform), install.args, {
+        cwd: opts.cwd,
+        encoding: "utf8",
+        stdio: "inherit",
+    });
+    if (result.error) {
+        const message = result.error instanceof Error
+            ? result.error.message
+            : String(result.error);
+        process.stderr.write(`${message}\n`);
+        return 1;
+    }
+    return result.status ?? 1;
+}

package/dist/packageJson.d.ts

@@ -0,0 +1,26 @@
+export type PackageJson = {
+    name: string;
+    private: true;
+    version: string;
+};
+export declare function derivePackageNameFromCwd(cwd: string): string;
+export declare function renderPackageJson(opts: {
+    cwd: string;
+}): {
+    filePath: string;
+    contents: string;
+    packageName: string;
+};
+export declare function writePackageJsonIfMissing(opts: {
+    cwd: string;
+    runtime?: {
+        stat?: (filePath: string) => Promise<{
+            isFile(): boolean;
+        }>;
+        writeFile?: (filePath: string, contents: string, encoding: "utf8") => Promise<void>;
+    };
+}): Promise<{
+    filePath: string;
+    packageName: string;
+} | null>;
+//# sourceMappingURL=packageJson.d.ts.map

package/dist/packageJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageJson.d.ts","sourceRoot":"","sources":["../src/packageJson.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,IAAI,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAuBD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACnB,CAeA;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACrD,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,MAAM,IAAI,OAAO,CAAA;SAAE,CAAC,CAAA;QAC3D,SAAS,CAAC,EAAE,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAA;KAClB,CAAA;CACD,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAkB5D"}

package/dist/packageJson.js

@@ -0,0 +1,51 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+function sanitizePackageName(name) {
+    const lower = name.trim().toLowerCase();
+    const cleaned = lower
+        .replace(/\s+/g, "-")
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "");
+    const withoutForbiddenPrefix = cleaned.replace(/^[._-]+/, "");
+    if (withoutForbiddenPrefix.length === 0) {
+        throw new Error(`Cannot derive a valid package name from '${name}'. Create a package.json manually and re-run.`);
+    }
+    return withoutForbiddenPrefix;
+}
+export function derivePackageNameFromCwd(cwd) {
+    const baseName = path.basename(cwd);
+    return sanitizePackageName(baseName);
+}
+export function renderPackageJson(opts) {
+    const packageName = derivePackageNameFromCwd(opts.cwd);
+    const filePath = path.join(opts.cwd, "package.json");
+    const pkg = {
+        name: packageName,
+        private: true,
+        version: "0.0.0",
+    };
+    return {
+        filePath,
+        contents: `${JSON.stringify(pkg, null, 2)}\n`,
+        packageName,
+    };
+}
+export async function writePackageJsonIfMissing(opts) {
+    const stat = opts.runtime?.stat ?? fs.stat;
+    const writeFile = opts.runtime?.writeFile ?? fs.writeFile;
+    const rendered = renderPackageJson({ cwd: opts.cwd });
+    try {
+        const stats = await stat(rendered.filePath);
+        if (!stats.isFile()) {
+            throw new Error(`Expected ${rendered.filePath} to be a file.`);
+        }
+        return null;
+    }
+    catch {
+        // Missing: create it.
+    }
+    await writeFile(rendered.filePath, rendered.contents, "utf8");
+    return { filePath: rendered.filePath, packageName: rendered.packageName };
+}

package/dist/promptForSetupPlan.d.ts

@@ -0,0 +1,16 @@
+export type ConfigPreset = "recommended" | "all";
+export type ConfigLanguage = "typescript" | "javascript";
+export type PackageManager = "npm" | "yarn" | "pnpm" | "bun";
+export type SetupPlan = {
+    preset: ConfigPreset;
+    language: ConfigLanguage;
+    dependencies: readonly string[];
+    installNow: boolean;
+    createPackageJson: boolean;
+    packageManager: PackageManager | null;
+};
+export declare function getRequiredDependencies(): readonly string[];
+export declare function promptForSetupPlan(opts: {
+    cwd: string;
+}): Promise<SetupPlan | null>;
+//# sourceMappingURL=promptForSetupPlan.d.ts.map

package/dist/promptForSetupPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptForSetupPlan.d.ts","sourceRoot":"","sources":["../src/promptForSetupPlan.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,KAAK,CAAA;AAChD,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,YAAY,CAAA;AACxD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,EAAE,cAAc,CAAA;IACxB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,UAAU,EAAE,OAAO,CAAA;IACnB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;CACrC,CAAA;AAID,wBAAgB,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAE3D;AAkDD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAA;CACX,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAiJ5B"}

package/dist/promptForSetupPlan.js

@@ -0,0 +1,173 @@
+import fs from "node:fs";
+import path from "node:path";
+import * as p from "@clack/prompts";
+const REQUIRED_DEPENDENCIES = ["viewlint", "@viewlint/rules"];
+export function getRequiredDependencies() {
+    return [...REQUIRED_DEPENDENCIES];
+}
+function parseConfigPreset(value) {
+    if (value === "recommended" || value === "all")
+        return value;
+    throw new Error(`Unexpected preset selection: ${String(value)}`);
+}
+function parseConfigLanguage(value) {
+    if (value === "typescript" || value === "javascript")
+        return value;
+    throw new Error(`Unexpected language selection: ${String(value)}`);
+}
+function parsePackageManager(value) {
+    if (value === "npm" ||
+        value === "yarn" ||
+        value === "pnpm" ||
+        value === "bun") {
+        return value;
+    }
+    throw new Error(`Unexpected package manager selection: ${String(value)}`);
+}
+function parseConfirm(value) {
+    if (value === true || value === false)
+        return value;
+    throw new Error(`Unexpected confirmation value: ${String(value)}`);
+}
+function detectPackageManagerFromLockfiles(cwd) {
+    const candidates = [
+        { pm: "bun", file: "bun.lockb" },
+        { pm: "bun", file: "bun.lock" },
+        { pm: "pnpm", file: "pnpm-lock.yaml" },
+        { pm: "yarn", file: "yarn.lock" },
+        { pm: "npm", file: "package-lock.json" },
+        { pm: "npm", file: "npm-shrinkwrap.json" },
+    ];
+    for (const { pm, file } of candidates) {
+        if (fs.existsSync(path.join(cwd, file)))
+            return pm;
+    }
+    return null;
+}
+function formatDependencyList(deps) {
+    return deps.join(", ");
+}
+export async function promptForSetupPlan(opts) {
+    p.intro("ViewLint config");
+    const presetRaw = await p.select({
+        message: "How would you like to configure ViewLint?",
+        options: [
+            {
+                value: "recommended",
+                label: "Base rules (Recommended)",
+                hint: "@viewlint/rules:recommended",
+            },
+            {
+                value: "all",
+                label: "All rules (Best for AI Agents)",
+                hint: "@viewlint/rules:all",
+            },
+        ],
+        initialValue: "recommended",
+    });
+    if (p.isCancel(presetRaw)) {
+        p.cancel("Setup cancelled.");
+        return null;
+    }
+    const preset = parseConfigPreset(presetRaw);
+    const languageRaw = await p.select({
+        message: "What language do you want your configuration file to be written in?",
+        options: [
+            { value: "typescript", label: "TypeScript" },
+            { value: "javascript", label: "JavaScript" },
+        ],
+        initialValue: "typescript",
+    });
+    if (p.isCancel(languageRaw)) {
+        p.cancel("Setup cancelled.");
+        return null;
+    }
+    const language = parseConfigLanguage(languageRaw);
+    const dependencies = getRequiredDependencies();
+    const installNowRaw = await p.confirm({
+        message: `The config you've selected requires the following dependencies: ${formatDependencyList(dependencies)}. Would you like to install them now?`,
+        initialValue: true,
+    });
+    if (p.isCancel(installNowRaw)) {
+        p.cancel("Setup cancelled.");
+        return null;
+    }
+    const installNow = parseConfirm(installNowRaw);
+    if (!installNow) {
+        p.outro("Config selection complete.");
+        return {
+            preset,
+            language,
+            dependencies,
+            installNow,
+            createPackageJson: false,
+            packageManager: null,
+        };
+    }
+    const packageJsonPath = path.join(opts.cwd, "package.json");
+    const hasPackageJson = fs.existsSync(packageJsonPath);
+    let createPackageJson = false;
+    if (!hasPackageJson) {
+        const createPackageJsonRaw = await p.confirm({
+            message: "No package.json was found in this directory. Create one now? (required to install dependencies)",
+            initialValue: true,
+        });
+        if (p.isCancel(createPackageJsonRaw)) {
+            p.cancel("Setup cancelled.");
+            return null;
+        }
+        createPackageJson = parseConfirm(createPackageJsonRaw);
+        if (!createPackageJson) {
+            p.outro("Config selection complete.");
+            return {
+                preset,
+                language,
+                dependencies,
+                installNow: false,
+                createPackageJson: false,
+                packageManager: null,
+            };
+        }
+    }
+    const detectedPm = detectPackageManagerFromLockfiles(opts.cwd);
+    const packageManagerRaw = await p.select({
+        message: "Which package manager would you like to use?",
+        options: [
+            {
+                value: "npm",
+                label: "npm",
+                hint: detectedPm === "npm" ? "detected" : undefined,
+            },
+            {
+                value: "yarn",
+                label: "yarn",
+                hint: detectedPm === "yarn" ? "detected" : undefined,
+            },
+            {
+                value: "pnpm",
+                label: "pnpm",
+                hint: detectedPm === "pnpm" ? "detected" : undefined,
+            },
+            {
+                value: "bun",
+                label: "bun",
+                hint: detectedPm === "bun" ? "detected" : undefined,
+            },
+        ],
+        initialValue: detectedPm ?? "npm",
+    });
+    if (p.isCancel(packageManagerRaw)) {
+        p.cancel("Setup cancelled.");
+        return null;
+    }
+    const packageManager = parsePackageManager(packageManagerRaw);
+    p.outro("Config selection complete.");
+    return {
+        preset,
+        language,
+        dependencies,
+        installNow,
+        createPackageJson,
+        packageManager,
+    };
+}

package/dist/viewlintConfigFile.d.ts

@@ -0,0 +1,25 @@
+import type { ConfigLanguage, ConfigPreset } from "./promptForSetupPlan.js";
+type ViewLintConfigFileName = "viewlint.config.ts" | "viewlint.config.js" | "viewlint.config.mjs";
+export declare function renderViewlintConfigFile(opts: {
+    preset: ConfigPreset;
+    language: ConfigLanguage;
+}): {
+    fileName: ViewLintConfigFileName;
+    contents: string;
+};
+export declare function findExistingViewlintConfigFile(opts: {
+    cwd: string;
+    runtime?: {
+        stat?: (filePath: string) => Promise<unknown>;
+    };
+}): Promise<string | null>;
+export declare function writeViewlintConfigFile(opts: {
+    cwd: string;
+    preset: ConfigPreset;
+    language: ConfigLanguage;
+    runtime?: {
+        writeFile?: (filePath: string, contents: string, encoding: "utf8") => Promise<void>;
+    };
+}): Promise<string>;
+export {};
+//# sourceMappingURL=viewlintConfigFile.d.ts.map

package/dist/viewlintConfigFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewlintConfigFile.d.ts","sourceRoot":"","sources":["../src/viewlintConfigFile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3E,KAAK,sBAAsB,GACxB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,CAAA;AA0BxB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,EAAE,cAAc,CAAA;CACxB,GAAG;IAAE,QAAQ,EAAE,sBAAsB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgBzD;AAED,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IAC1D,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAC7C,CAAA;CACD,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAczB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,YAAY,CAAA;IACpB,QAAQ,EAAE,cAAc,CAAA;IACxB,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,KACZ,OAAO,CAAC,IAAI,CAAC,CAAA;KAClB,CAAA;CACD,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlB"}

package/dist/viewlintConfigFile.js

@@ -0,0 +1,61 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const VIEWLINT_CONFIG_FILE_NAMES = [
+    "viewlint.config.ts",
+    "viewlint.config.js",
+    "viewlint.config.mjs",
+];
+function getTargetConfigFileName(language) {
+    if (language === "typescript")
+        return "viewlint.config.ts";
+    if (language === "javascript")
+        return "viewlint.config.mjs";
+    const _exhaustive = language;
+    throw new Error(`Unsupported config language: ${_exhaustive}`);
+}
+function getExtendsString(preset) {
+    if (preset === "recommended")
+        return "rules/recommended";
+    if (preset === "all")
+        return "rules/all";
+    const _exhaustive = preset;
+    throw new Error(`Unsupported preset: ${_exhaustive}`);
+}
+export function renderViewlintConfigFile(opts) {
+    const fileName = getTargetConfigFileName(opts.language);
+    const extendsString = getExtendsString(opts.preset);
+    const contents = `import { defineConfig } from "viewlint/config"\n` +
+        `import rules from "@viewlint/rules"\n` +
+        `\n` +
+        `export default defineConfig({\n` +
+        `\tplugins: {\n` +
+        `\t\trules,\n` +
+        `\t},\n` +
+        `\textends: ["${extendsString}"],\n` +
+        `})\n`;
+    return { fileName, contents };
+}
+export async function findExistingViewlintConfigFile(opts) {
+    const stat = opts.runtime?.stat ?? fs.stat;
+    for (const fileName of VIEWLINT_CONFIG_FILE_NAMES) {
+        const filePath = path.join(opts.cwd, fileName);
+        try {
+            await stat(filePath);
+            return filePath;
+        }
+        catch {
+            // Not found.
+        }
+    }
+    return null;
+}
+export async function writeViewlintConfigFile(opts) {
+    const writeFile = opts.runtime?.writeFile ?? fs.writeFile;
+    const rendered = renderViewlintConfigFile({
+        preset: opts.preset,
+        language: opts.language,
+    });
+    const targetPath = path.join(opts.cwd, rendered.fileName);
+    await writeFile(targetPath, rendered.contents, "utf8");
+    return targetPath;
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "@viewlint/create-config",
+	"version": "0.0.1",
+	"description": "Interactive initializer for ViewLint configuration",
+	"type": "module",
+	"bin": "./bin/create-config.js",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"bin",
+		"dist",
+		"README.md"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.0.0"
+	},
+	"devDependencies": {
+		"@repo/typescript-config": "workspace:*",
+		"@types/node": "^22.15.3",
+		"bun-types": "^1.3.8",
+		"typescript": "5.9.2"
+	},
+	"scripts": {
+		"build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
+		"check-types": "tsc -p tsconfig.check.json --noEmit",
+		"prepack": "npm run build",
+		"test": "bun test"
+	}
+}