lapikit 0.0.0-insiders.09c4e21 → 0.0.0-insiders.0a8aed3

package/README.md

@@ -1,5 +1,5 @@
 <a href="https://lapikit.dev">
-  <img src="https://raw.githubusercontent.com/Nycolaide/lapikit/main/.github/lapikit.svg" alt="Lapikit Logo" width="125">
+  <img src="https://raw.githubusercontent.com/lapikit/lapikit.dev/main/.github/lapikit.svg" alt="Lapikit Logo" width="125">
 </a>
 
 # Lapikit - Svelte components library
@@ -8,10 +8,10 @@
 [![][subscribe-to-instagram]](https://www.instagram.com/lapikit/)
 [![][join-discord-lapikit]](https://discord.gg/gn9ZGtDtK4)
 
-[![][version]](https://github.com/nycolaide/lapikit/releases?q=lapikit&expanded=true)
+[![][version]](https://github.com/lapikit/lapikit/releases?q=lapikit&expanded=true)
 [![][installs]](https://www.npmjs.com/package/lapikit)
 [![][installs-this-month]](https://www.npmjs.com/package/lapikit)
-[![][license]](https://github.com/nycolaide/lapikit/blob/main/LICENSE)
+[![][license]](https://github.com/lapikit/lapikit/blob/main/LICENSE)
 [![][discord]](https://discord.gg/gn9ZGtDtK4)
 
 Lapikit is a comprehensive Svelte components library that provides developers with a wide range of pre-built, customizable UI components to streamline the development process. Whether you're building a simple website or a complex web application, Lapikit has the tools you need to create beautiful and functional user interfaces with ease.
@@ -71,7 +71,7 @@ Lapikit has created to help Svelte developers save time and effort when building
 
 ## 💖Community
 
-Join our growing community on [Discord](https://discord.gg/gn9ZGtDtK4) and [GitHub Discussions](https://github.com/nycolaide/lapikit/discussions) where we discuss and collaborate on all things Lapikit. Don't be shy, jump right in and be part of the discussion!
+Join our growing community on [Discord](https://discord.gg/gn9ZGtDtK4) and [GitHub Discussions](https://github.com/lapikit/lapikit/discussions) where we discuss and collaborate on all things Lapikit. Don't be shy, jump right in and be part of the discussion!
 
 ## 💁‍♂️Contributing
 
@@ -84,9 +84,9 @@ Be part of the next revolution in code editing by contributing to the project. T
 
 ## 📄License
 
-Licensed under the [MIT license](https://github.com/nycolaide/lapikit/blob/main/LICENSE).
+Licensed under the [MIT license](https://github.com/lapikit/lapikit/blob/main/LICENSE).
 
-Copyright © 2025 Nycolaide
+Copyright © 2025 - 2026 Nycolaide
 
 ## 🪧We support these projects
 
@@ -96,12 +96,12 @@ We are proud supporters of the open-source community and contribute to several p
   <tr>
     <td>
       <a href="https://www.w3.org/">
-        <img src="https://raw.githubusercontent.com/Nycolaide/lapikit/main/.github/w3c.svg" alt="W3C" width="75">
+        <img src="https://raw.githubusercontent.com/lapikit/lapikit.dev/main/.github/w3c.svg" alt="W3C" width="75">
       </a>
     </td>
     <td>
       <a href="https://humanstxt.org/">
-        <img src="https://raw.githubusercontent.com/Nycolaide/lapikit/main/.github/humans.png" alt="Humans.txt" width="115">
+        <img src="https://raw.githubusercontent.com/lapikit/lapikit.dev/main/.github/humans.png" alt="Humans.txt" width="115">
       </a>
     </td>
   </tr>
@@ -111,7 +111,7 @@ We are proud supporters of the open-source community and contribute to several p
 [join-discord-lapikit]: https://img.shields.io/badge/Join%20the%20community-black.svg?style=for-the-badge&logo=Discord
 [subscribe-to-instagram]: https://img.shields.io/badge/Follow%20@Lapikit-black.svg?style=for-the-badge&logo=Instagram
 [version]: https://img.shields.io/npm/v/lapikit.svg?label=Version&color=f58142
-[license]: https://badgen.net/github/license/nycolaide/lapikit?label=License&color=cc5640
+[license]: https://badgen.net/github/license/lapikit/lapikit?label=License&color=cc5640
 [installs]: https://badgen.net/npm/dt/lapikit?label=NPM%20installs&color=40ba12
 [installs-this-month]: https://badgen.net/npm/dm/lapikit?label=NPM%20installs&color=40ba12
 [discord]: https://img.shields.io/discord/1383879204671721492?color=5865F2&label=Discord&logo=discord&logoColor=white

package/bin/helpers.js

@@ -0,0 +1,251 @@
+import readline from 'node:readline/promises';
+import { emitKeypressEvents, moveCursor, cursorTo, clearLine } from 'node:readline';
+
+const color = {
+	red: (text) => `\x1b[31m${text}\x1b[0m`,
+	green: (text) => `\x1b[32m${text}\x1b[0m`,
+	yellow: (text) => `\x1b[33m${text}\x1b[0m`,
+	blue: (text) => `\x1b[34m${text}\x1b[0m`,
+	purple: (text) => `\x1b[35m${text}\x1b[0m`,
+	cyan: (text) => `\x1b[36m${text}\x1b[0m`
+};
+
+const variant = {
+	bold: (text) => `\x1b[1m${text}\x1b[0m`,
+	underline: (text) => `\x1b[4m${text}\x1b[0m`,
+	inverse: (text) => `\x1b[7m${text}\x1b[0m`
+};
+
+const bold = {
+	red: (text) => `\x1b[1m\x1b[31m${text}\x1b[0m`,
+	green: (text) => `\x1b[1m\x1b[32m${text}\x1b[0m`,
+	yellow: (text) => `\x1b[1m\x1b[33m${text}\x1b[0m`,
+	blue: (text) => `\x1b[1m\x1b[34m${text}\x1b[0m`,
+	purple: (text) => `\x1b[1m\x1b[35m${text}\x1b[0m`,
+	cyan: (text) => `\x1b[1m\x1b[36m${text}\x1b[0m`
+};
+
+const inverse = {
+	red: (text) => `\x1b[7m\x1b[31m${text}\x1b[0m`,
+	green: (text) => `\x1b[7m\x1b[32m${text}\x1b[0m`,
+	yellow: (text) => `\x1b[7m\x1b[33m${text}\x1b[0m`,
+	blue: (text) => `\x1b[7m\x1b[34m${text}\x1b[0m`,
+	purple: (text) => `\x1b[7m\x1b[35m${text}\x1b[0m`,
+	cyan: (text) => `\x1b[7m\x1b[36m${text}\x1b[0m`
+};
+
+const underline = {
+	red: (text) => `\x1b[4m\x1b[31m${text}\x1b[0m`,
+	green: (text) => `\x1b[4m\x1b[32m${text}\x1b[0m`,
+	yellow: (text) => `\x1b[4m\x1b[33m${text}\x1b[0m`,
+	blue: (text) => `\x1b[4m\x1b[34m${text}\x1b[0m`,
+	purple: (text) => `\x1b[4m\x1b[35m${text}\x1b[0m`,
+	cyan: (text) => `\x1b[4m\x1b[36m${text}\x1b[0m`
+};
+
+export const ansi = {
+	color,
+	variant,
+	bold,
+	inverse,
+	underline
+};
+
+export const terminal = (type = 'info', msg) => {
+	const name = ansi.color.cyan('lapikit');
+
+	if (type === 'error') console.error(name, ansi.bold.red('[error]'), msg);
+	else if (type === 'warn') console.warn(name, ansi.bold.yellow('[warn]'), msg);
+	else if (type === 'success') console.warn(name, ansi.bold.green('[success]'), msg);
+	else if (type === 'none') console.log(msg);
+	else console.log(name, ansi.bold.blue('[info]'), msg);
+};
+
+export function createRL() {
+	const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+	rl.on('SIGINT', () => {
+		if (process.stdin.isTTY) process.stdin.setRawMode(false);
+		console.log('\n');
+		terminal('warn', 'installation canceled.');
+		process.exit(0);
+	});
+
+	return rl;
+}
+
+export async function toggle(rl, message, initial = true) {
+	const hint = initial ? 'Y/n' : 'y/N';
+	const answer = (await rl.question(`${message} (${hint}): `)).trim().toLowerCase();
+	if (answer === '') return initial;
+	return answer === 'y';
+}
+
+export async function text(rl, message, initial = '', validate) {
+	while (true) {
+		const hint = initial ? ` (${initial})` : '';
+		const answer = (await rl.question(`${message}${hint}: `)).trim();
+		const value = answer === '' ? initial : answer;
+		if (validate) {
+			const result = validate(value);
+			if (result !== true) {
+				terminal('warn', result);
+				continue;
+			}
+		}
+		return value;
+	}
+}
+
+async function selectFallback(rl, message, choices) {
+	console.log(`\n${message}`);
+	choices.forEach((c, i) => console.log(`  ${i + 1}. ${c.title}`));
+
+	while (true) {
+		const answer = (await rl.question(`Choice (1): `)).trim();
+		const index = answer === '' ? 0 : parseInt(answer, 10) - 1;
+		if (index >= 0 && index < choices.length) return choices[index].value;
+		terminal('warn', `Please enter a number between 1 and ${choices.length}`);
+	}
+}
+
+async function multiselectFallback(rl, message, choices) {
+	console.log(`\n${message}`);
+	choices.forEach((c, i) => console.log(`  ${i + 1}. ${c.title}`));
+	console.log(`  (enter numbers separated by commas, e.g. 1,2 - leave empty for none)`);
+
+	while (true) {
+		const answer = (await rl.question(`Choice: `)).trim();
+		if (answer === '') return [];
+
+		const indexes = answer.split(',').map((part) => parseInt(part.trim(), 10) - 1);
+		const valid = indexes.every((index) => index >= 0 && index < choices.length);
+		if (valid) return [...new Set(indexes)].map((index) => choices[index].value);
+
+		terminal('warn', `Please enter numbers between 1 and ${choices.length}, separated by commas`);
+	}
+}
+
+async function interactiveList(rl, message, hint, choices, renderLine, onKey) {
+	console.log(`\n${message}`);
+	console.log(ansi.color.cyan(`  (${hint})`));
+	choices.forEach((_, i) => console.log(renderLine(i)));
+
+	const { stdin } = process;
+	rl.pause();
+	const wasRaw = stdin.isRaw;
+	emitKeypressEvents(stdin, rl);
+	stdin.setRawMode(true);
+	stdin.resume();
+
+	return new Promise((resolve) => {
+		const redrawLine = (index) => {
+			const rowsUp = choices.length - index;
+			moveCursor(process.stdout, 0, -rowsUp);
+			cursorTo(process.stdout, 0);
+			clearLine(process.stdout, 1);
+			process.stdout.write(renderLine(index));
+			moveCursor(process.stdout, 0, rowsUp);
+			cursorTo(process.stdout, 0);
+		};
+
+		const cleanup = () => {
+			stdin.removeListener('keypress', onKeypress);
+			stdin.setRawMode(wasRaw);
+			rl.resume();
+		};
+
+		const onKeypress = (str, key) => {
+			if (key.ctrl && key.name === 'c') {
+				cleanup();
+				process.stdout.write('\n');
+				terminal('warn', 'installation canceled.');
+				process.exit(130);
+			}
+			onKey(key, redrawLine, (value) => {
+				cleanup();
+				console.log('');
+				resolve(value);
+			});
+		};
+
+		stdin.on('keypress', onKeypress);
+	});
+}
+
+export async function select(rl, message, choices) {
+	const { stdin } = process;
+	if (!stdin.isTTY || typeof stdin.setRawMode !== 'function') {
+		return selectFallback(rl, message, choices);
+	}
+
+	let cursor = 0;
+	const renderLine = (index) => {
+		const radio = index === cursor ? ansi.color.green('(●)') : '( )';
+		const pointer = index === cursor ? ansi.color.cyan('❯') : ' ';
+		return `${pointer} ${radio} ${choices[index].title}`;
+	};
+
+	return interactiveList(
+		rl,
+		message,
+		'↑/↓ move, enter to confirm',
+		choices,
+		renderLine,
+		(key, redrawLine, resolve) => {
+			const previousCursor = cursor;
+			if (key.name === 'up') {
+				cursor = (cursor - 1 + choices.length) % choices.length;
+				redrawLine(previousCursor);
+				redrawLine(cursor);
+			} else if (key.name === 'down') {
+				cursor = (cursor + 1) % choices.length;
+				redrawLine(previousCursor);
+				redrawLine(cursor);
+			} else if (key.name === 'return') {
+				resolve(choices[cursor].value);
+			}
+		}
+	);
+}
+
+export async function multiselect(rl, message, choices) {
+	const { stdin } = process;
+	if (!stdin.isTTY || typeof stdin.setRawMode !== 'function') {
+		return multiselectFallback(rl, message, choices);
+	}
+
+	const selected = new Set();
+	let cursor = 0;
+	const renderLine = (index) => {
+		const checked = selected.has(index) ? ansi.color.green('[x]') : '[ ]';
+		const pointer = index === cursor ? ansi.color.cyan('❯') : ' ';
+		return `${pointer} ${checked} ${choices[index].title}`;
+	};
+
+	return interactiveList(
+		rl,
+		message,
+		'↑/↓ move, space to select, enter to confirm',
+		choices,
+		renderLine,
+		(key, redrawLine, resolve) => {
+			const previousCursor = cursor;
+			if (key.name === 'up') {
+				cursor = (cursor - 1 + choices.length) % choices.length;
+				redrawLine(previousCursor);
+				redrawLine(cursor);
+			} else if (key.name === 'down') {
+				cursor = (cursor + 1) % choices.length;
+				redrawLine(previousCursor);
+				redrawLine(cursor);
+			} else if (key.name === 'space') {
+				if (selected.has(cursor)) selected.delete(cursor);
+				else selected.add(cursor);
+				redrawLine(cursor);
+			} else if (key.name === 'return') {
+				resolve([...selected].sort((a, b) => a - b).map((index) => choices[index].value));
+			}
+		}
+	);
+}

package/bin/hooks.js

@@ -0,0 +1,318 @@
+#!/usr/bin/env node
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { terminal } from './helpers.js';
+
+const INSTALL_ARGS = {
+	npm: ['install', '--save-dev'],
+	yarn: ['add', '-D'],
+	pnpm: ['add', '--save-dev'],
+	bun: ['add', '-D']
+};
+
+export function installDependency(pkgManager, packageName, cwd) {
+	const args = INSTALL_ARGS[pkgManager];
+	if (!args) throw new Error(`Unsupported package manager: ${pkgManager}`);
+	return new Promise((resolve, reject) => {
+		const child = spawn(pkgManager, [...args, packageName], {
+			cwd,
+			stdio: 'inherit',
+			shell: process.platform === 'win32'
+		});
+		child.on('error', reject);
+		child.on('close', (code) =>
+			code === 0 ? resolve() : reject(new Error(`${pkgManager} exited with code ${code}`))
+		);
+	});
+}
+
+function findMatchingDelimiter(content, openIndex, openChar, closeChar) {
+	let depth = 0;
+	for (let i = openIndex; i < content.length; i++) {
+		const ch = content[i];
+		if (ch === '"' || ch === "'" || ch === '`') {
+			i = skipString(content, i);
+			continue;
+		}
+		if (ch === openChar) depth++;
+		else if (ch === closeChar) {
+			depth--;
+			if (depth === 0) return i;
+		}
+	}
+	return -1;
+}
+
+function skipString(source, start) {
+	const quote = source[start];
+	for (let i = start + 1; i < source.length; i++) {
+		if (source[i] === '\\') {
+			i++;
+			continue;
+		}
+		if (source[i] === quote) return i;
+	}
+	return source.length - 1;
+}
+
+function insertImportLine(content, importLine) {
+	const lines = content.split('\n');
+	let importInsertIndex = 0;
+	for (let i = 0; i < lines.length; i++) {
+		if (lines[i].trim().startsWith('import ')) importInsertIndex = i + 1;
+	}
+	lines.splice(importInsertIndex, 0, importLine);
+	return lines.join('\n');
+}
+
+function buildPreprocessCall(pluginKeys = []) {
+	if (!pluginKeys.length) return `lapikitPreprocess()`;
+	const plugins = pluginKeys.map((key) => `'${key}'`).join(', ');
+	return `lapikitPreprocess({ plugins: [${plugins}] })`;
+}
+
+function mergeExistingPreprocessCall(content, pluginKeys) {
+	if (!pluginKeys.length) return null;
+
+	const callMatch = content.match(/lapikitPreprocess\s*\(\s*(\{[\s\S]*?\})?\s*\)/);
+	if (!callMatch) return null;
+
+	const [fullMatch, optionsSource] = callMatch;
+	const pluginsMatch = optionsSource?.match(/plugins\s*:\s*\[([^\]]*)\]/);
+	const existingKeys = pluginsMatch
+		? [...pluginsMatch[1].matchAll(/'([^']+)'|"([^"]+)"/g)].map((m) => m[1] ?? m[2])
+		: [];
+
+	const merged = [...new Set([...existingKeys, ...pluginKeys])];
+	if (merged.length === existingKeys.length) return null;
+
+	const newCall = buildPreprocessCall(merged);
+	return (
+		content.slice(0, callMatch.index) + newCall + content.slice(callMatch.index + fullMatch.length)
+	);
+}
+
+function findValueEnd(source, start) {
+	let depth = 0;
+	for (let i = start; i < source.length; i++) {
+		const ch = source[i];
+		if (ch === '"' || ch === "'" || ch === '`') {
+			i = skipString(source, i);
+			continue;
+		}
+		if (ch === '(' || ch === '[' || ch === '{') depth++;
+		else if (ch === ')' || ch === ']' || ch === '}') {
+			if (depth === 0) return i;
+			depth--;
+		} else if (ch === ',' && depth === 0) return i;
+	}
+	return source.length;
+}
+
+function injectPreprocessEntry(objectSource, pluginKeys = []) {
+	const call = buildPreprocessCall(pluginKeys);
+
+	const keyMatch = objectSource.match(/preprocess\s*:\s*/);
+	if (!keyMatch) {
+		return objectSource.replace('{', `{\n\t\t\tpreprocess: [${call}],`);
+	}
+	const valueStart = keyMatch.index + keyMatch[0].length;
+
+	if (objectSource[valueStart] === '[') {
+		const openBracketIndex = valueStart;
+		const closeBracketIndex = findMatchingDelimiter(objectSource, openBracketIndex, '[', ']');
+		const inner = objectSource.slice(openBracketIndex + 1, closeBracketIndex);
+		const trimmed = inner.trim();
+
+		let newInner;
+		if (!trimmed) {
+			newInner = call;
+		} else if (inner.includes('\n')) {
+			const firstItemMatch = inner.match(/\n(\s*)\S/);
+			const indent = firstItemMatch ? firstItemMatch[1] : '\t\t';
+			const closingMatch = inner.match(/\n(\s*)$/);
+			const closingIndent = closingMatch ? closingMatch[1] : '\t';
+			const innerTrimmed = inner.trimEnd();
+			const sep = innerTrimmed.endsWith(',') ? '' : ',';
+			newInner = `${innerTrimmed}${sep}\n${indent}${call}\n${closingIndent}`;
+		} else {
+			const sep = trimmed.endsWith(',') ? ' ' : ', ';
+			newInner = `${trimmed}${sep}${call}`;
+		}
+		return (
+			objectSource.slice(0, openBracketIndex + 1) + newInner + objectSource.slice(closeBracketIndex)
+		);
+	}
+
+	const valueEnd = findValueEnd(objectSource, valueStart);
+	const expr = objectSource.slice(valueStart, valueEnd).trim();
+	return objectSource.slice(0, valueStart) + `[${expr}, ${call}]` + objectSource.slice(valueEnd);
+}
+
+export async function findSvelteConfigFile(projectPath) {
+	for (const ext of ['js', 'mjs', 'cjs', 'ts']) {
+		const file = path.join(projectPath, `svelte.config.${ext}`);
+		try {
+			await fs.access(file);
+			return file;
+		} catch {
+			// lapikit other step
+		}
+	}
+	throw new Error('No svelte.config file found');
+}
+
+export async function addLiliPreprocess(svelteConfigFile, pluginKeys = []) {
+	let content = await fs.readFile(svelteConfigFile, 'utf-8');
+	const lapikitImport = `import { lapikitPreprocess } from 'lapikit/preprocess';`;
+
+	if (content.includes(`from 'lapikit/preprocess'`)) {
+		const updated = mergeExistingPreprocessCall(content, pluginKeys);
+		if (!updated) {
+			terminal('warn', `lapikitPreprocess already imported in ${svelteConfigFile}`);
+			return;
+		}
+		await fs.writeFile(svelteConfigFile, updated);
+		terminal('success', `lapikitPreprocess plugins updated in ${svelteConfigFile}`);
+		return;
+	}
+
+	const match = content.match(/(?:const\s+\w+\s*=\s*|export\s+default\s*)(\{)/);
+	if (!match) {
+		throw new Error(`Could not find the exported config object in ${svelteConfigFile}`);
+	}
+
+	const openBraceIndex = match.index + match[0].length - 1;
+	const closeBraceIndex = findMatchingDelimiter(content, openBraceIndex, '{', '}');
+	if (closeBraceIndex === -1) {
+		throw new Error(`Could not parse the config object in ${svelteConfigFile}`);
+	}
+
+	const objectSource = content.slice(openBraceIndex, closeBraceIndex + 1);
+	const updatedObject = injectPreprocessEntry(objectSource, pluginKeys);
+	content = content.slice(0, openBraceIndex) + updatedObject + content.slice(closeBraceIndex + 1);
+	content = insertImportLine(content, lapikitImport);
+
+	await fs.writeFile(svelteConfigFile, content);
+	terminal('success', `lapikitPreprocess added to ${svelteConfigFile}`);
+}
+
+export async function findViteConfigFile(projectPath) {
+	for (const ext of ['ts', 'js', 'mjs', 'cjs']) {
+		const file = path.join(projectPath, `vite.config.${ext}`);
+		try {
+			await fs.access(file);
+			return file;
+		} catch {
+			// lapikit other step
+		}
+	}
+	return null;
+}
+
+function findSveltekitPluginCall(content) {
+	const match = content.match(/sveltekit\s*\(\s*\{/);
+	if (!match) return null;
+
+	const openBraceIndex = match.index + match[0].length - 1;
+	const closeBraceIndex = findMatchingDelimiter(content, openBraceIndex, '{', '}');
+	if (closeBraceIndex === -1) return null;
+
+	return { openBraceIndex, closeBraceIndex };
+}
+
+export async function addLiliPreprocessToViteConfig(viteConfigFile, pluginKeys = []) {
+	let content = await fs.readFile(viteConfigFile, 'utf-8');
+	const lapikitImport = `import { lapikitPreprocess } from 'lapikit/preprocess';`;
+
+	if (content.includes(`from 'lapikit/preprocess'`)) {
+		const updated = mergeExistingPreprocessCall(content, pluginKeys);
+		if (!updated) {
+			terminal('warn', `lapikitPreprocess already imported in ${viteConfigFile}`);
+			return;
+		}
+		await fs.writeFile(viteConfigFile, updated);
+		terminal('success', `lapikitPreprocess plugins updated in ${viteConfigFile}`);
+		return;
+	}
+
+	const pluginCall = findSveltekitPluginCall(content);
+	if (!pluginCall) {
+		throw new Error(`Could not find a sveltekit({ ... }) plugin call in ${viteConfigFile}`);
+	}
+
+	const { openBraceIndex, closeBraceIndex } = pluginCall;
+	const objectSource = content.slice(openBraceIndex, closeBraceIndex + 1);
+	const updatedObject = injectPreprocessEntry(objectSource, pluginKeys);
+	content = content.slice(0, openBraceIndex) + updatedObject + content.slice(closeBraceIndex + 1);
+	content = insertImportLine(content, lapikitImport);
+
+	await fs.writeFile(viteConfigFile, content);
+	terminal('success', `lapikitPreprocess added to ${viteConfigFile}`);
+}
+
+// Since SvelteKit 2.62, Svelte/preprocess config can be passed directly to the
+// sveltekit() vite plugin instead of svelte.config.js — when it is, svelte.config.js
+// is ignored, so the vite.config plugin call takes priority when both exist.
+export async function resolveSveltePreprocessTarget(projectPath) {
+	const viteConfigFile = await findViteConfigFile(projectPath);
+	if (viteConfigFile) {
+		const content = await fs.readFile(viteConfigFile, 'utf-8');
+		if (findSveltekitPluginCall(content)) {
+			return { file: viteConfigFile, add: addLiliPreprocessToViteConfig };
+		}
+	}
+
+	try {
+		const svelteConfigFile = await findSvelteConfigFile(projectPath);
+		return { file: svelteConfigFile, add: addLiliPreprocess };
+	} catch {
+		throw new Error(
+			'No svelte.config file found, and no sveltekit({ ... }) plugin config found in vite.config.(js|ts) ' +
+				"Add lapikitPreprocess() manually: import { lapikitPreprocess } from 'lapikit/preprocess'; " +
+				'then add it to your preprocess array.'
+		);
+	}
+}
+
+export async function findEslintConfigFile(projectPath) {
+	for (const ext of ['js', 'mjs', 'cjs', 'ts']) {
+		const file = path.join(projectPath, `eslint.config.${ext}`);
+		try {
+			await fs.access(file);
+			return file;
+		} catch {
+			// lapikit other step
+		}
+	}
+	throw new Error('No eslint.config.js file found');
+}
+
+export async function addLapikitEslintConfig(eslintConfigFile) {
+	let content = await fs.readFile(eslintConfigFile, 'utf-8');
+	const lapikitImport = `import lapikitConfig from 'eslint-config-lapikit';`;
+
+	if (content.includes(`from 'eslint-config-lapikit'`)) {
+		terminal('warn', `eslint-config-lapikit already imported in ${eslintConfigFile}`);
+		return;
+	}
+
+	content = insertImportLine(content, lapikitImport);
+
+	// Matches `export default [...]` as well as wrapped forms like
+	// `export default defineConfig([...])`, `export default defineConfig(a, b)`
+	// (rest-args form, no array) and member-expression wrappers like
+	// `export default ts.config(...)`.
+	const exportArrayPattern = /export\s+default\s*(?:\[|[\w.]+\s*\()/;
+	if (!exportArrayPattern.test(content)) {
+		throw new Error(
+			`Could not find "export default [...]" in ${eslintConfigFile}. Please add "...lapikitConfig" manually.`
+		);
+	}
+
+	content = content.replace(exportArrayPattern, (m) => `${m}\n\t...lapikitConfig,`);
+
+	await fs.writeFile(eslintConfigFile, content);
+	terminal('success', `eslint-config-lapikit added to ${eslintConfigFile}`);
+}