@kindgi/cli 0.1.6 → 0.1.7

package/dist/init/pinning.js

@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * How `kindgi init` writes a third-party dependency it adds to an app
+ * (zod; vitest and vite for its tests): at the version Kindgi is tested
+ * with, written exactly when the
+ * app pins exactly or its package manager saves exact versions, else as a
+ * `^` range from that version. Kindgi's own packages are always exact
+ * (`dependency-specs.ts`).
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import semver from 'semver';
+/**
+ * The zod Kindgi is tested with: the version the workspace resolves.
+ * Bump it with each release; a test checks it against the workspace's zod
+ * and `@kindgi/sdk`'s zod range.
+ */
+export const TESTED_ZOD_VERSION = '4.6.5';
+/**
+ * The vitest a pack's tests are run with, and the vite it needs (vitest
+ * names vite as a peer it doesn't install, so init adds both): what the
+ * fresh templates and augment mode write. Bump them with each release
+ * after a pack's `kindgi test` passes on them; a test checks the vite is
+ * inside vitest's peer range and the templates agree.
+ */
+export const TESTED_VITEST_VERSION = '5.0.3';
+export const TESTED_VITE_VERSION = '8.3.4';
+/** The vites `TESTED_VITEST_VERSION` takes (its `peerDependencies.vite`). */
+export const VITEST_VITE_RANGE = '^6.4.0 || ^7.0.0 || ^8.0.0';
+/** `version` as an app writes it: exact, or a `^` range from it. */
+export function specAt(version, exact) {
+    return exact ? version : `^${version}`;
+}
+const PINNED_SECTIONS = ['dependencies', 'devDependencies', 'optionalDependencies'];
+/**
+ * Whether the app pins exactly: it has at least one semver spec, and every
+ * one is an exact version (`1.2.3`, not `^1.2.3`, `~1.2`, `*`). Specs that
+ * aren't semver (`workspace:*`, `catalog:`, `file:`, `npm:…`, a git URL, a
+ * tag) say nothing either way, and peer ranges are ranges by nature.
+ */
+export function pinsExactly(pkg) {
+    let exact = 0;
+    for (const section of PINNED_SECTIONS) {
+        const deps = pkg[section];
+        if (deps === null || typeof deps !== 'object')
+            continue;
+        for (const spec of Object.values(deps)) {
+            if (typeof spec !== 'string')
+                continue;
+            const trimmed = spec.trim();
+            if (semver.valid(trimmed) !== null)
+                exact += 1;
+            else if (semver.validRange(trimmed) !== null)
+                return false;
+        }
+    }
+    return exact > 0;
+}
+/**
+ * Whether the app's package manager is set to save exact versions:
+ * - npm and pnpm: `save-exact=true` or an empty `save-prefix` in the
+ *   project's `.npmrc`, else in the user's (`~/.npmrc`), the project's
+ *   winning when it sets either;
+ * - pnpm: `saveExact: true` or an empty `savePrefix` in `pnpm-workspace.yaml`;
+ * - Yarn (2+): an empty `defaultSemverRangePrefix` in `.yarnrc.yml`;
+ * - Bun: `exact = true` under `[install]` in `bunfig.toml`.
+ * Only those settings are read: nothing else in these files (a registry
+ * token, say) is kept or shown.
+ */
+export async function savesExact(dir, home) {
+    const project = npmrcSaveExact(await readText(join(dir, '.npmrc')));
+    if (project !== undefined)
+        return project;
+    if (home !== undefined) {
+        const user = npmrcSaveExact(await readText(join(home, '.npmrc')));
+        if (user !== undefined)
+            return user;
+    }
+    const pnpm = await readText(join(dir, 'pnpm-workspace.yaml'));
+    if (/^\s*saveExact:\s*true\s*$/m.test(pnpm) || /^\s*savePrefix:\s*(''|"")\s*$/m.test(pnpm)) {
+        return true;
+    }
+    const yarn = await readText(join(dir, '.yarnrc.yml'));
+    if (/^\s*defaultSemverRangePrefix:\s*(''|"")\s*$/m.test(yarn))
+        return true;
+    return bunInstallExact(await readText(join(dir, 'bunfig.toml')));
+}
+/** `.npmrc`'s answer: `true`/`false` when it sets `save-exact` or `save-prefix`, else `undefined`. */
+function npmrcSaveExact(text) {
+    let saveExact;
+    let savePrefix;
+    for (const line of text.split(/\r?\n/)) {
+        const match = /^\s*(save-exact|save-prefix)\s*=\s*(.*?)\s*$/.exec(line);
+        if (match === null)
+            continue;
+        const value = (match[2] ?? '').replace(/^(['"])(.*)\1$/, '$2');
+        if (match[1] === 'save-exact')
+            saveExact = value === 'true';
+        else
+            savePrefix = value;
+    }
+    if (saveExact === undefined && savePrefix === undefined)
+        return undefined;
+    // `save-exact=true` wins over any prefix; an empty prefix is exact too.
+    return saveExact === true || savePrefix === '';
+}
+/** `exact = true` in `bunfig.toml`'s `[install]` table. */
+function bunInstallExact(text) {
+    let inInstall = false;
+    for (const line of text.split(/\r?\n/)) {
+        const table = /^\s*\[([^\]]+)\]\s*$/.exec(line);
+        if (table !== null) {
+            inInstall = table[1]?.trim() === 'install';
+            continue;
+        }
+        if (inInstall && /^\s*exact\s*=\s*true\s*(#.*)?$/.test(line))
+            return true;
+    }
+    return false;
+}
+async function readText(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=pinning.js.map

package/dist/init/pinning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pinning.js","sourceRoot":"","sources":["../../src/init/pinning.ts"],"names":[],"mappings":"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"}

package/dist/init/template-files.d.ts

@@ -30,7 +30,7 @@ export interface Substitutions {
     /**
      * The commands a README shows, as `kindgi init`'s Next steps print them:
      * the install (`pnpm install`), the typecheck script, and how the project
-     * runs its `kindgi` (`pnpm exec kindgi`, `npx --no kindgi`, `uv run
+     * runs its `kindgi` (`pnpm exec kindgi`, `npx --no -- kindgi`, `uv run
      * kindgi`). Left as placeholders when absent, for a second pass
      * (`fillRunnerPlaceholders`) once the package manager is known.
      */

package/dist/init/tsconfig-paths.d.ts

@@ -0,0 +1,29 @@
+export interface PathAlias {
+    /** The tsconfig pattern: `@/*`, or an exact name. */
+    readonly pattern: string;
+    /** Where it points, relative to the app's folder, with `/` separators: `src/*`, `../ui/src/*`. */
+    readonly target: string;
+}
+export interface TsconfigPaths {
+    /** In the order to try them: exact names, then the longest prefix first (TypeScript's choice). */
+    readonly aliases: readonly PathAlias[];
+    /** What couldn't be carried over as it is, for init's summary. */
+    readonly notes: readonly string[];
+}
+/**
+ * `<appDir>/tsconfig.json`'s path aliases. No tsconfig, or one without
+ * `paths`: none. `paths` and `baseUrl` come from the nearest config that
+ * sets each (the app's own, then what it extends, the last of an array
+ * first); targets resolve against `baseUrl`, else the folder of the config
+ * that sets `paths`; a leading `${configDir}` is the app's folder, as
+ * TypeScript has it. A target list's first entry is used (vitest has no
+ * fallback), and a pattern starting with `*` is left out (vitest would
+ * send every import, packages too, through it).
+ */
+export declare function readTsconfigPaths(appDir: string): Promise<TsconfigPaths>;
+/**
+ * JSON as tsconfig files are written: with `//` and `/* *\/` comments
+ * and trailing commas, which TypeScript accepts and `JSON.parse` doesn't.
+ */
+export declare function parseJsonc(text: string): unknown;
+//# sourceMappingURL=tsconfig-paths.d.ts.map

package/dist/init/tsconfig-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-paths.d.ts","sourceRoot":"","sources":["../../src/init/tsconfig-paths.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kGAAkG;IAClG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAcD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAkD9E;AAwGD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/dist/init/tsconfig-paths.js

@@ -0,0 +1,235 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * An app's TypeScript path aliases (`compilerOptions.paths` in its
+ * `tsconfig.json`, following `extends`), for the vitest config `kindgi
+ * init` adds: vitest doesn't read tsconfig, so without them a tool that
+ * imports `@/lib/orders` builds with the app and fails under `kindgi test`.
+ * Read once, at init, and written into that config as `resolve.alias`.
+ */
+import { readFile, realpath } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+const NO_PATHS = { aliases: [], notes: [] };
+/** How deep an `extends` chain is followed. */
+const MAX_EXTENDS_DEPTH = 16;
+/**
+ * `<appDir>/tsconfig.json`'s path aliases. No tsconfig, or one without
+ * `paths`: none. `paths` and `baseUrl` come from the nearest config that
+ * sets each (the app's own, then what it extends, the last of an array
+ * first); targets resolve against `baseUrl`, else the folder of the config
+ * that sets `paths`; a leading `${configDir}` is the app's folder, as
+ * TypeScript has it. A target list's first entry is used (vitest has no
+ * fallback), and a pattern starting with `*` is left out (vitest would
+ * send every import, packages too, through it).
+ */
+export async function readTsconfigPaths(appDir) {
+    // Real paths throughout: a package's tsconfig resolves to one (Node,
+    // like TypeScript, follows pnpm's links), and a target is relative to
+    // the folder of the config that names it.
+    const app = await realOrResolved(appDir);
+    const start = join(app, 'tsconfig.json');
+    const unread = [];
+    const levels = await collectLevels(start, new Set(), 0, unread);
+    if (levels === undefined)
+        return NO_PATHS;
+    const withPaths = levels.find((l) => isRecord(l.compilerOptions.paths));
+    if (withPaths === undefined) {
+        const notes = unread.map((spec) => `tsconfig.json extends ${spec}, which init couldn't read: any paths it sets aren't in vitest's aliases.`);
+        if (levels[0]?.references === true) {
+            notes.push("tsconfig.json has project references, and init reads only its own paths: copy any the referenced configs set into vitest's aliases.");
+        }
+        return { aliases: [], notes };
+    }
+    const withBaseUrl = levels.find((l) => typeof l.compilerOptions.baseUrl === 'string');
+    const base = withBaseUrl !== undefined
+        ? resolve(withBaseUrl.dir, inConfigDir(withBaseUrl.compilerOptions.baseUrl, app))
+        : withPaths.dir;
+    const aliases = [];
+    const notes = [];
+    const paths = withPaths.compilerOptions.paths;
+    for (const [pattern, targets] of Object.entries(paths)) {
+        if (!Array.isArray(targets))
+            continue;
+        const first = targets.find((t) => typeof t === 'string');
+        if (first === undefined)
+            continue;
+        if (pattern.startsWith('*')) {
+            notes.push(`tsconfig.json's paths map "${pattern}", which would catch every import in vitest, packages too: left out of its aliases.`);
+            continue;
+        }
+        if (targets.length > 1) {
+            notes.push(`tsconfig.json maps "${pattern}" to ${targets.length} places; vitest's alias takes the first, ${first}.`);
+        }
+        aliases.push({ pattern, target: fromApp(app, resolve(base, inConfigDir(first, app))) });
+    }
+    return { aliases: aliases.sort(byPrecedence), notes };
+}
+/**
+ * The config at `file` and what it extends, nearest first; `undefined`
+ * when `file` can't be read. An `extends` that can't be resolved or read
+ * is recorded in `unread` and skipped.
+ */
+async function collectLevels(file, seen, depth, unread) {
+    if (seen.has(file) || depth > MAX_EXTENDS_DEPTH)
+        return [];
+    seen.add(file);
+    const parsed = await readJsonc(file);
+    if (!isRecord(parsed))
+        return undefined;
+    const compilerOptions = isRecord(parsed.compilerOptions) ? parsed.compilerOptions : {};
+    const levels = [
+        {
+            dir: dirname(await realOrResolved(file)),
+            compilerOptions,
+            references: Array.isArray(parsed.references),
+        },
+    ];
+    const ext = parsed.extends;
+    const specs = typeof ext === 'string' ? [ext] : Array.isArray(ext) ? ext : [];
+    // A later entry of an `extends` array overrides an earlier one.
+    for (const spec of [...specs].reverse()) {
+        if (typeof spec !== 'string')
+            continue;
+        const target = resolveExtends(spec, file);
+        const inner = target === undefined ? undefined : await collectLevels(target, seen, depth + 1, unread);
+        if (inner === undefined)
+            unread.push(spec);
+        else
+            levels.push(...inner);
+    }
+    return levels;
+}
+/** Where an `extends` entry points: a path from the config's folder, or a package's tsconfig. */
+function resolveExtends(spec, from) {
+    if (spec.startsWith('./') || spec.startsWith('../') || isAbsolute(spec)) {
+        const path = resolve(dirname(from), spec);
+        return path.endsWith('.json') ? path : `${path}.json`;
+    }
+    const require = createRequire(from);
+    for (const candidate of [spec, `${spec}/tsconfig.json`, `${spec}.json`]) {
+        try {
+            return require.resolve(candidate);
+        }
+        catch {
+            // try the next form
+        }
+    }
+    return undefined;
+}
+/**
+ * A path with TypeScript's `${configDir}` (5.5+) at its start made
+ * absolute: it names the folder of the tsconfig in use, the app's, even
+ * when a config it extends writes it.
+ */
+function inConfigDir(path, app) {
+    return path.startsWith(CONFIG_DIR) ? join(app, path.slice(CONFIG_DIR.length)) : path;
+}
+const CONFIG_DIR = '${configDir}';
+/** `path`'s real path, or `path` resolved when it has none. */
+async function realOrResolved(path) {
+    try {
+        return await realpath(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}
+/** `path` relative to the app's real folder, with `/` separators; the app itself is `.`. */
+function fromApp(app, path) {
+    const rel = relative(app, path).split(sep).join('/');
+    return rel === '' ? '.' : rel;
+}
+/** Exact names first, then wildcards by the length of what precedes the `*`, longest first. */
+function byPrecedence(a, b) {
+    const prefix = (p) => p.includes('*') ? p.indexOf('*') : Number.MAX_SAFE_INTEGER;
+    return prefix(b.pattern) - prefix(a.pattern);
+}
+async function readJsonc(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    try {
+        return parseJsonc(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * JSON as tsconfig files are written: with `//` and `/* *\/` comments
+ * and trailing commas, which TypeScript accepts and `JSON.parse` doesn't.
+ */
+export function parseJsonc(text) {
+    return JSON.parse(withoutTrailingCommas(withoutComments(text.replace(/^/, ''))));
+}
+/** The text with its comments blanked, strings untouched. */
+function withoutComments(text) {
+    let out = '';
+    let i = 0;
+    while (i < text.length) {
+        const c = text[i];
+        if (c === '"') {
+            const end = stringEnd(text, i);
+            out += text.slice(i, end);
+            i = end;
+        }
+        else if (c === '/' && (text[i + 1] === '/' || text[i + 1] === '*')) {
+            i = commentEnd(text, i);
+            out += ' ';
+        }
+        else {
+            out += c;
+            i += 1;
+        }
+    }
+    return out;
+}
+/** The index just past the comment opening at `start`: a `//` one ends before its newline. */
+function commentEnd(text, start) {
+    if (text[start + 1] === '/') {
+        const newline = text.indexOf('\n', start);
+        return newline === -1 ? text.length : newline;
+    }
+    const close = text.indexOf('*/', start + 2);
+    return close === -1 ? text.length : close + 2;
+}
+/** Whitespace, then a `}` or `]`, from `lastIndex`. */
+const CLOSER_AHEAD = /\s*[}\]]/y;
+/** The text without a `,` that only whitespace separates from a `}` or `]`, strings untouched. */
+function withoutTrailingCommas(text) {
+    let out = '';
+    let i = 0;
+    while (i < text.length) {
+        const c = text[i];
+        if (c === '"') {
+            const end = stringEnd(text, i);
+            out += text.slice(i, end);
+            i = end;
+            continue;
+        }
+        CLOSER_AHEAD.lastIndex = i + 1;
+        if (c === ',' && CLOSER_AHEAD.test(text)) {
+            i += 1;
+            continue;
+        }
+        out += c;
+        i += 1;
+    }
+    return out;
+}
+/** The index just past the string literal opening at `start`. */
+function stringEnd(text, start) {
+    let i = start + 1;
+    while (i < text.length && text[i] !== '"')
+        i += text[i] === '\\' ? 2 : 1;
+    return Math.min(i + 1, text.length);
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=tsconfig-paths.js.map

package/dist/init/tsconfig-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-paths.js","sourceRoot":"","sources":["../../src/init/tsconfig-paths.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAgB9E,MAAM,QAAQ,GAAkB,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAE3D,+CAA+C;AAC/C,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAS7B;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc;IACpD,qEAAqE;IACrE,sEAAsE;IACtE,0CAA0C;IAC1C,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACzC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAE1C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CACtB,CAAC,IAAI,EAAE,EAAE,CACP,yBAAyB,IAAI,2EAA2E,CAC3G,CAAC;QACF,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CACR,qIAAqI,CACtI,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC;IACtF,MAAM,IAAI,GACR,WAAW,KAAK,SAAS;QACvB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,WAAW,CAAC,eAAe,CAAC,OAAiB,EAAE,GAAG,CAAC,CAAC;QAC3F,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IAEpB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,eAAe,CAAC,KAAgC,CAAC;IACzE,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QACtE,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CACR,8BAA8B,OAAO,qFAAqF,CAC3H,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CACR,uBAAuB,OAAO,QAAQ,OAAO,CAAC,MAAM,4CAA4C,KAAK,GAAG,CACzG,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,aAAa,CAC1B,IAAY,EACZ,IAAiB,EACjB,KAAa,EACb,MAAgB;IAEhB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,GAAG,iBAAiB;QAAE,OAAO,EAAE,CAAC;IAC3D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,MAAM,GAAkB;QAC5B;YACE,GAAG,EAAE,OAAO,CAAC,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;YACxC,eAAe;YACf,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;SAC7C;KACF,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,gEAAgE;IAChE,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACxC,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,KAAK,GACT,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1F,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACtC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iGAAiG;AACjG,SAAS,cAAc,CAAC,IAAY,EAAE,IAAY;IAChD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC;IACxD,CAAC;IACD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,MAAM,SAAS,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,gBAAgB,EAAE,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAY,EAAE,GAAW;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC,+DAA+D;AAC/D,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,4FAA4F;AAC5F,SAAS,OAAO,CAAC,GAAW,EAAE,IAAY;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAChC,CAAC;AAED,+FAA+F;AAC/F,SAAS,YAAY,CAAC,CAAY,EAAE,CAAY;IAC9C,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CACnC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;IAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,6DAA6D;AAC7D,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/B,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC1B,CAAC,GAAG,GAAG,CAAC;QACV,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACrE,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACxB,GAAG,IAAI,GAAG,CAAC;QACb,CAAC;aAAM,CAAC;YACN,GAAG,IAAI,CAAC,CAAC;YACT,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8FAA8F;AAC9F,SAAS,UAAU,CAAC,IAAY,EAAE,KAAa;IAC7C,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IAC5C,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,uDAAuD;AACvD,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC,kGAAkG;AAClG,SAAS,qBAAqB,CAAC,IAAY;IACzC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/B,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC1B,CAAC,GAAG,GAAG,CAAC;YACR,SAAS;QACX,CAAC;QACD,YAAY,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,GAAG,IAAI,CAAC,CAAC;QACT,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iEAAiE;AACjE,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa;IAC5C,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/init/vitest-setup.d.ts

@@ -0,0 +1,41 @@
+import type { WantedDependency } from './package-json-patcher.js';
+import { type PathAlias } from './tsconfig-paths.js';
+/** What `kindgi test` runs in an app Kindgi was added to. */
+export declare const KINDGI_TESTS_GLOB = "kindgi/**/*.test.ts";
+export type VitestSetup = {
+    /** Write (or, with --force, rewrite) init's config, and add what it needs. */
+    readonly kind: 'write';
+    readonly path: string;
+    readonly contents: string;
+    readonly dependencies: readonly WantedDependency[];
+    readonly aliases: readonly PathAlias[];
+    readonly notes: readonly string[];
+} | {
+    /** init's own config from an earlier run, kept (no --force). */
+    readonly kind: 'kept';
+    readonly path: string;
+} | {
+    /** The app's own vitest setup, left as is; the warning says what `kindgi test` needs. */
+    readonly kind: 'app-owned';
+    readonly warning: string;
+};
+/**
+ * What to do about the app's tests:
+ * - a vitest config init wrote before: rewritten with --force (its aliases
+ *   read again), else kept;
+ * - the app's own `vitest.config.*`, or vitest without one (`vite.config.*`
+ *   or vitest's defaults): left as is, with a warning;
+ * - else init's config, with vitest and vite pinned as the app pins.
+ */
+export declare function planVitestSetup(args: {
+    readonly targetDir: string;
+    readonly pkg: Readonly<Record<string, unknown>>;
+    /** The app is `"type": "module"`: the config is `.ts`, else `.mts`. */
+    readonly esmApp: boolean;
+    /** Write exact versions (the app pins exactly, or saves exact). */
+    readonly exact: boolean;
+    readonly force: boolean;
+}): Promise<VitestSetup>;
+/** The config init writes: Kindgi's tests only, with the app's path aliases. */
+export declare function renderVitestConfig(aliases: readonly PathAlias[]): string;
+//# sourceMappingURL=vitest-setup.d.ts.map

package/dist/init/vitest-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.d.ts","sourceRoot":"","sources":["../../src/init/vitest-setup.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAQlE,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,qBAAqB,CAAC;AAExE,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAKvD,MAAM,MAAM,WAAW,GACnB;IACE,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,GACD;IACE,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IACE,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AASN;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBvB;AA8BD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAgCxE"}

package/dist/init/vitest-setup.js

@@ -0,0 +1,163 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * The test setup augment-mode `kindgi init` gives an app, so `kindgi test`
+ * runs the tests beside its Kindgi primitives: `vitest` and `vite`
+ * (vitest's peer, which it doesn't install) in devDependencies, and a
+ * vitest config at the app's root (`vitest.config.mts`, `.ts` in a
+ * `"type": "module"` app) that runs the `.test.ts` files under `kindgi/`
+ * with the app's tsconfig path aliases. An app that runs vitest already keeps its own
+ * setup, and init says what `kindgi test` needs from it.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import semver from 'semver';
+import { VITEST_CONFIG_FILENAMES } from '../test/runners.js';
+import { TESTED_VITEST_VERSION, TESTED_VITE_VERSION, VITEST_VITE_RANGE, specAt, } from './pinning.js';
+import { readTsconfigPaths } from './tsconfig-paths.js';
+/** What `kindgi test` runs in an app Kindgi was added to. */
+export const KINDGI_TESTS_GLOB = 'kindgi/**/*.test.ts';
+/** The first line of the config init writes: how a later init knows the file is its own. */
+const HEADER = '// The vitest config for the tests beside your Kindgi primitives, added by';
+const DEPENDENCY_SECTIONS = [
+    'dependencies',
+    'devDependencies',
+    'peerDependencies',
+    'optionalDependencies',
+];
+/**
+ * What to do about the app's tests:
+ * - a vitest config init wrote before: rewritten with --force (its aliases
+ *   read again), else kept;
+ * - the app's own `vitest.config.*`, or vitest without one (`vite.config.*`
+ *   or vitest's defaults): left as is, with a warning;
+ * - else init's config, with vitest and vite pinned as the app pins.
+ */
+export async function planVitestSetup(args) {
+    for (const name of VITEST_CONFIG_FILENAMES) {
+        const path = join(args.targetDir, name);
+        const text = await readText(path);
+        if (text === undefined)
+            continue;
+        if (text.startsWith(HEADER)) {
+            if (!args.force)
+                return { kind: 'kept', path };
+            return write(args, path);
+        }
+        return {
+            kind: 'app-owned',
+            warning: `vitest: the app's own ${name} is left as is, and kindgi test runs it: its test.include needs '${KINDGI_TESTS_GLOB}', and its resolve.alias the tsconfig paths Kindgi's code imports by.`,
+        };
+    }
+    if (hasDependency(args.pkg, 'vitest')) {
+        return {
+            kind: 'app-owned',
+            warning: `vitest: the app runs vitest without a vitest.config.* (on vite.config.* or vitest's defaults), left as is. kindgi test needs one: a vitest.config.${args.esmApp ? 'ts' : 'mts'} whose test.include has '${KINDGI_TESTS_GLOB}' beside the app's own tests (vitest then reads it instead of vite.config.*).`,
+        };
+    }
+    return write(args, join(args.targetDir, args.esmApp ? 'vitest.config.ts' : 'vitest.config.mts'));
+}
+async function write(args, path) {
+    const paths = await readTsconfigPaths(args.targetDir);
+    const notes = [...viteWarnings(args.pkg), ...paths.notes];
+    const { aliases } = paths;
+    return {
+        kind: 'write',
+        path,
+        contents: renderVitestConfig(aliases),
+        dependencies: [
+            {
+                name: 'vitest',
+                spec: specAt(TESTED_VITEST_VERSION, args.exact),
+                section: 'devDependencies',
+            },
+            { name: 'vite', spec: specAt(TESTED_VITE_VERSION, args.exact), section: 'devDependencies' },
+        ],
+        aliases,
+        notes,
+    };
+}
+/** The config init writes: Kindgi's tests only, with the app's path aliases. */
+export function renderVitestConfig(aliases) {
+    const lines = [
+        HEADER,
+        '// `kindgi init`: `kindgi test` runs it.',
+        ...(aliases.length > 0
+            ? ["import { dirname } from 'node:path';", "import { fileURLToPath } from 'node:url';", '']
+            : []),
+        "import { defineConfig } from 'vitest/config';",
+        '',
+        ...(aliases.length > 0 ? ['const root = dirname(fileURLToPath(import.meta.url));', ''] : []),
+        'export default defineConfig({',
+        ...(aliases.length > 0
+            ? [
+                '  resolve: {',
+                "    // tsconfig.json's paths, which vitest doesn't read, as `kindgi init`",
+                '    // found them: when you change those, change these to match.',
+                '    alias: [',
+                ...aliases.map((a) => `      { find: ${aliasFind(a.pattern)}, replacement: ${aliasReplacement(a)} },`),
+                '    ],',
+                '  },',
+            ]
+            : []),
+        '  test: {',
+        `    include: ['${KINDGI_TESTS_GLOB}'],`,
+        '    passWithNoTests: true,',
+        '  },',
+        '});',
+        '',
+    ];
+    return lines.join('\n');
+}
+/** A tsconfig pattern as a regex literal: an exact name, or `prefix*suffix` capturing the `*`. */
+function aliasFind(pattern) {
+    const star = pattern.indexOf('*');
+    if (star === -1)
+        return `/^${escapeRegex(pattern)}$/`;
+    return `/^${escapeRegex(pattern.slice(0, star))}(.*)${escapeRegex(pattern.slice(star + 1))}$/`;
+}
+/** The target from the config's folder, as a template literal, with the `*` as the capture. */
+function aliasReplacement(alias) {
+    const escaped = alias.target.replace(/[`\\]/g, '\\$&').replace(/\$\{/g, '\\${');
+    const target = alias.pattern.includes('*') ? escaped.replace('*', '$1') : escaped;
+    return target === '.' ? '`${root}`' : `\`\${root}/${target}\``;
+}
+/**
+ * The app's own vite is kept; one outside vitest's peer range is reported,
+ * since installing vitest then fails on its peer. A spec that isn't a
+ * semver range is taken on trust.
+ */
+function viteWarnings(pkg) {
+    for (const section of DEPENDENCY_SECTIONS) {
+        const deps = pkg[section];
+        if (deps === null || typeof deps !== 'object')
+            continue;
+        const spec = deps.vite;
+        if (typeof spec !== 'string')
+            continue;
+        if (semver.validRange(spec) === null || semver.intersects(spec, VITEST_VITE_RANGE))
+            return [];
+        return [
+            `vite: the app has vite ${spec} (${section}), left as is. vitest ${TESTED_VITEST_VERSION}, which kindgi test runs, needs vite ${VITEST_VITE_RANGE}: upgrade vite before installing, or the install stops on vitest's peer.`,
+        ];
+    }
+    return [];
+}
+function escapeRegex(text) {
+    return text.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+}
+function hasDependency(pkg, name) {
+    return DEPENDENCY_SECTIONS.some((section) => {
+        const deps = pkg[section];
+        return deps !== null && typeof deps === 'object' && name in deps;
+    });
+}
+async function readText(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=vitest-setup.js.map

package/dist/init/vitest-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest-setup.js","sourceRoot":"","sources":["../../src/init/vitest-setup.ts"],"names":[],"mappings":"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"}