@salty-css/core 0.1.0-alpha.14 → 0.1.0-alpha.16

package/bin/confirm-install.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Renders a single package spec for display. Translates the internal
+ * `'-D <pkg>@<ver>'` shorthand used by `npmInstall` into a `<pkg>@<ver> (dev)`
+ * suffix so the user-facing list reads naturally.
+ */
+export declare const formatPackageForDisplay: (spec: string) => string;
+export declare const renderPackageList: (packages: string[]) => string;
+export interface ConfirmInstallOptions {
+    /** Streams used for the prompt — defaults to process.stdin/stdout. Allows tests to inject. */
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    /** Whether the input is a TTY — defaults to process.stdin.isTTY. Allows tests to override. */
+    isTTY?: boolean;
+}
+/**
+ * Confirm a batched install. Resolves on success, throws on decline.
+ *
+ * - `yes=true` or empty `packages` → no prompt, resolves immediately.
+ * - Non-TTY without `yes` → throws, telling the user to pass `--yes`.
+ * - Otherwise prints the list and asks `Proceed? (y/N)`. Accepts y/yes
+ *   (case-insensitive); anything else throws to abort the command.
+ */
+export declare const confirmInstall: (packages: string[], yes: boolean, options?: ConfirmInstallOptions) => Promise<void>;

package/bin/context.d.ts

@@ -8,11 +8,14 @@ export interface ProjectContext {
     rcFile: RCFile;
     cliVersion: string;
     skipInstall: boolean;
+    yes: boolean;
 }
 export declare const resolveProjectDir: (dir: string, rootDir?: string) => string;
 export interface BuildContextOptions {
     dir: string;
     skipInstall?: boolean;
+    /** Skip the install confirmation prompt and install without asking. */
+    yes?: boolean;
     /** When false, build context even if package.json is missing (used by commands that should not require one). */
     requirePackageJson?: boolean;
 }

package/bin/integrations/index.d.ts

@@ -1,12 +1,20 @@
 import { ProjectContext } from '../context';
-import { BuildIntegrationAdapter } from './types';
+import { BuildIntegrationAdapter, IntegrationPlan } from './types';
 export declare const buildIntegrationRegistry: BuildIntegrationAdapter[];
-export declare const detectAndApplyIntegrations: (ctx: ProjectContext) => Promise<{
+export interface PlannedIntegration {
+    name: string;
+    configPath: string;
+    plan: IntegrationPlan;
+}
+/** Detect every integration that has work to do and compute its plan. */
+export declare const planIntegrations: (ctx: ProjectContext) => Promise<PlannedIntegration[]>;
+/** Execute each previously-planned integration (writes config files). */
+export declare const applyIntegrationPlans: (planned: PlannedIntegration[]) => Promise<{
     name: string;
     configPath: string;
     changed: boolean;
 }[]>;
-export type { BuildIntegrationAdapter, ConfigEdit } from './types';
+export type { BuildIntegrationAdapter, ConfigEdit, IntegrationPlan } from './types';
 export { viteIntegration, editViteConfig, vitePackage } from './vite';
 export { nextIntegration, editNextConfig, nextPackage, nextConfigFiles } from './next';
 export { astroIntegration, editAstroConfig, astroPackage } from './astro';

package/bin/integrations/types.d.ts

@@ -3,12 +3,24 @@ export interface IntegrationApplyResult {
     /** Whether any file was edited or any install was performed. */
     changed: boolean;
 }
+/**
+ * Pending integration work — the packages it would like installed and a
+ * closure that writes the config edits once the install (if any) has run.
+ */
+export interface IntegrationPlan {
+    /** Packages to install, using the same `npmInstall` shorthand (e.g. `'-D @salty-css/vite@1.2.3'`). */
+    packages: string[];
+    execute(): Promise<IntegrationApplyResult>;
+}
 export interface BuildIntegrationAdapter {
     name: string;
     /** Returns the config file path this integration targets, or null when not applicable. */
     detect(ctx: ProjectContext): Promise<string | null> | string | null;
-    /** Idempotently wire the integration into the project (edit configs, install dev deps). */
-    apply(ctx: ProjectContext, configPath: string): Promise<IntegrationApplyResult>;
+    /**
+     * Idempotently produce the work needed to wire the integration in. Returns
+     * null when the integration is already wired (nothing to do).
+     */
+    plan(ctx: ProjectContext, configPath: string): Promise<IntegrationPlan | null>;
 }
 /** Pure transform — returned by an integration when it knows how to rewrite a config file. */
 export interface ConfigEdit {

package/bin/main.cjs

@@ -11,6 +11,7 @@ const child_process = require("child_process");
 const ora = require("ora");
 const pascalCase = require("../pascal-case-By_l58S-.cjs");
 const ejs = require("ejs");
+const promises$1 = require("readline/promises");
 var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
 const defaultPackageJsonPath = path.join(process.cwd(), "package.json");
 const readPackageJson = async (filePath = defaultPackageJsonPath) => {
@@ -141,17 +142,21 @@ const buildContext = async (opts) => {
     packageJson,
     rcFile,
     cliVersion: cliPackageJson.version || "0.0.0",
-    skipInstall: !!opts.skipInstall
+    skipInstall: !!opts.skipInstall,
+    yes: !!opts.yes
   };
 };
 const registerBuildCommand = (program, defaultProject) => {
-  program.command("build [directory]").alias("b").description("Build the Salty-CSS project.").option("-d, --dir <dir>", "Project directory to build the project in.").option("--watch", "Watch for changes and rebuild the project.").action(async function(_dir = defaultProject) {
+  program.command("build [directory]").alias("b").description("Build the Salty-CSS project.").option("-d, --dir <dir>", "Project directory to build the project in.").option("--watch", "Watch for changes and rebuild the project.").option("--mode <mode>", 'Build mode: "production" or "development". Defaults to NODE_ENV-based detection.').action(async function(_dir = defaultProject) {
     compiler_saltyCompiler.logger.info("Building the Salty-CSS project...");
-    const { dir = _dir, watch } = this.opts();
+    const { dir = _dir, watch, mode } = this.opts();
+    if (mode !== void 0 && mode !== "production" && mode !== "development") {
+      return compiler_saltyCompiler.logError(`Invalid --mode "${mode}". Expected "production" or "development".`);
+    }
     const resolved = dir ?? await getDefaultProject();
     if (!resolved) return compiler_saltyCompiler.logError("Project directory must be provided. Add it as the first argument after build command or use the --dir option.");
     const projectDir = resolveProjectDir(resolved);
-    const compiler = new compiler_saltyCompiler.SaltyCompiler(projectDir);
+    const compiler = new compiler_saltyCompiler.SaltyCompiler(projectDir, { mode });
     await compiler.generateCss();
     if (watch) {
       compiler_saltyCompiler.logger.info("Watching for changes in the project directory...");
@@ -293,6 +298,36 @@ const registerGenerateCommand = (program, defaultProject) => {
     await formatWithPrettier(formattedStyledFilePath);
   });
 };
+const formatPackageForDisplay = (spec) => {
+  const trimmed = spec.trim();
+  if (trimmed.startsWith("-D ")) return `${trimmed.slice(3).trim()} (dev)`;
+  return trimmed;
+};
+const renderPackageList = (packages) => {
+  return packages.map((p) => `  + ${formatPackageForDisplay(p)}`).join("\n");
+};
+const confirmInstall = async (packages, yes, options = {}) => {
+  if (yes) return;
+  if (packages.length === 0) return;
+  const input = options.input ?? process.stdin;
+  const output = options.output ?? process.stdout;
+  const isTTY = options.isTTY ?? (process.stdin.isTTY ?? false);
+  if (!isTTY) {
+    throw new Error("Cannot prompt for install confirmation: stdin is not a TTY. Re-run with --yes to install the listed packages without prompting.");
+  }
+  output.write(`The following packages will be installed:
+${renderPackageList(packages)}
+`);
+  const rl = promises$1.createInterface({ input, output, terminal: false });
+  try {
+    const answer = (await rl.question("Proceed? (y/N) ")).trim().toLowerCase();
+    if (answer !== "y" && answer !== "yes") {
+      throw new Error("Install cancelled by user.");
+    }
+  } finally {
+    rl.close();
+  }
+};
 const CSS_FILE_FOLDERS = ["src", "public", "assets", "styles", "css", "app"];
 const CSS_SECOND_LEVEL_FOLDERS = ["styles", "css", "app", "pages"];
 const CSS_FILE_NAMES = ["index", "styles", "main", "app", "global", "globals"];
@@ -339,17 +374,22 @@ const editAstroConfig = (existing) => {
 const astroIntegration = {
   name: "astro",
   detect: (ctx) => findAstroConfig(ctx.projectDir),
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await promises.readFile(configPath, "utf-8").catch(() => void 0);
-    if (existing === void 0) return { changed: false };
+    if (existing === void 0) return null;
     const result = editAstroConfig(existing);
     if (result.warning) compiler_saltyCompiler.logger.warn(result.warning);
-    if (result.content === null) return { changed: false };
-    if (!ctx.skipInstall) await npmInstall(`-D ${astroPackage(ctx.cliVersion)}`);
-    compiler_saltyCompiler.logger.info("Adding Salty-CSS integration to Astro config: " + configPath);
-    await promises.writeFile(configPath, result.content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (result.content === null) return null;
+    const newContent = result.content;
+    return {
+      packages: [`-D ${astroPackage(ctx.cliVersion)}`],
+      execute: async () => {
+        compiler_saltyCompiler.logger.info("Adding Salty-CSS integration to Astro config: " + configPath);
+        await promises.writeFile(configPath, newContent);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const ESLINT_CONFIG_CANDIDATES = [
@@ -408,20 +448,25 @@ const eslintIntegration = {
     const candidates = eslintConfigCandidates(ctx.projectDir, ctx.cwd);
     return candidates.find((p) => fs.existsSync(p)) ?? null;
   },
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await promises.readFile(configPath, "utf-8").catch(() => void 0);
     if (existing === void 0) {
       compiler_saltyCompiler.logger.error("Could not read ESLint config file.");
-      return { changed: false };
+      return null;
     }
-    if (!ctx.skipInstall) await npmInstall(corePackages.eslintConfigCore(ctx.cliVersion));
     const result = editEslintConfig(existing, configPath.endsWith("js"));
     if (result.warning) compiler_saltyCompiler.logger.warn(result.warning);
-    if (result.content === null) return { changed: false };
-    compiler_saltyCompiler.logger.info("Edit file: " + configPath);
-    await promises.writeFile(configPath, result.content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (result.content === null) return null;
+    const newContent = result.content;
+    return {
+      packages: [corePackages.eslintConfigCore(ctx.cliVersion)],
+      execute: async () => {
+        compiler_saltyCompiler.logger.info("Edit file: " + configPath);
+        await promises.writeFile(configPath, newContent);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const nextConfigFiles = ["next.config.js", "next.config.cjs", "next.config.ts", "next.config.mjs"];
@@ -451,16 +496,20 @@ const nextIntegration = {
     const found = nextConfigFiles.map((file) => path.join(ctx.projectDir, file)).find((p) => fs.existsSync(p));
     return found ?? null;
   },
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await promises.readFile(configPath, "utf-8").catch(() => void 0);
-    if (existing === void 0) return { changed: false };
+    if (existing === void 0) return null;
     const { content } = editNextConfig(existing);
-    if (content === null) return { changed: false };
-    if (!ctx.skipInstall) await npmInstall(`-D ${nextPackage(ctx.cliVersion)}`);
-    compiler_saltyCompiler.logger.info("Adding Salty-CSS plugin to Next.js config...");
-    await promises.writeFile(configPath, content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (content === null) return null;
+    return {
+      packages: [`-D ${nextPackage(ctx.cliVersion)}`],
+      execute: async () => {
+        compiler_saltyCompiler.logger.info("Adding Salty-CSS plugin to Next.js config...");
+        await promises.writeFile(configPath, content);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const vitePackage = (version) => `@salty-css/vite@${version}`;
@@ -478,27 +527,40 @@ const viteIntegration = {
     const path$1 = path.join(ctx.projectDir, "vite.config.ts");
     return fs.existsSync(path$1) ? path$1 : null;
   },
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await promises.readFile(configPath, "utf-8").catch(() => void 0);
-    if (existing === void 0) return { changed: false };
+    if (existing === void 0) return null;
     const { content } = editViteConfig(existing);
-    if (content === null) return { changed: false };
-    compiler_saltyCompiler.logger.info("Edit file: " + configPath);
-    if (!ctx.skipInstall) await npmInstall(`-D ${vitePackage(ctx.cliVersion)}`);
-    compiler_saltyCompiler.logger.info("Adding Salty-CSS plugin to Vite config...");
-    await promises.writeFile(configPath, content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (content === null) return null;
+    return {
+      packages: [`-D ${vitePackage(ctx.cliVersion)}`],
+      execute: async () => {
+        compiler_saltyCompiler.logger.info("Edit file: " + configPath);
+        compiler_saltyCompiler.logger.info("Adding Salty-CSS plugin to Vite config...");
+        await promises.writeFile(configPath, content);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const buildIntegrationRegistry = [eslintIntegration, viteIntegration, nextIntegration, astroIntegration];
-const detectAndApplyIntegrations = async (ctx) => {
-  const results = [];
+const planIntegrations = async (ctx) => {
+  const planned = [];
   for (const integration of buildIntegrationRegistry) {
     const configPath = await integration.detect(ctx);
     if (!configPath) continue;
-    const result = await integration.apply(ctx, configPath);
-    results.push({ name: integration.name, configPath, changed: result.changed });
+    const plan = await integration.plan(ctx, configPath);
+    if (!plan) continue;
+    planned.push({ name: integration.name, configPath, plan });
+  }
+  return planned;
+};
+const applyIntegrationPlans = async (planned) => {
+  const results = [];
+  for (const { name, configPath, plan } of planned) {
+    const result = await plan.execute();
+    results.push({ name, configPath, changed: result.changed });
   }
   return results;
 };
@@ -549,17 +611,24 @@ const wirePrepareScript = async () => {
   await updatePackageJson(next);
 };
 const registerInitCommand = (program) => {
-  program.command("init [directory]").description("Initialize a new Salty-CSS project.").option("-d, --dir <dir>", "Project directory to initialize the project in.").option("--css-file <css-file>", "Existing CSS file where to import the generated CSS. Path must be relative to the given project directory.").option("--skip-install", "Skip installing dependencies.").action(async function(_dir = ".") {
+  program.command("init [directory]").description("Initialize a new Salty-CSS project.").option("-d, --dir <dir>", "Project directory to initialize the project in.").option("--css-file <css-file>", "Existing CSS file where to import the generated CSS. Path must be relative to the given project directory.").option("--skip-install", "Skip installing dependencies.").option("-y, --yes", "Skip the install confirmation prompt.").action(async function(_dir = ".") {
     try {
       const opts = this.opts();
       const dir = opts.dir ?? _dir;
       if (!dir) return compiler_saltyCompiler.logError("Project directory must be provided. Add it as the first argument after init command or use the --dir option.");
-      const ctx = await buildContext({ dir, skipInstall: opts.skipInstall });
+      const ctx = await buildContext({ dir, skipInstall: opts.skipInstall, yes: opts.yes });
       compiler_saltyCompiler.logger.info("Initializing a new Salty-CSS project!");
       const framework = await detectFramework(ctx);
       compiler_saltyCompiler.logger.info(`Detected framework: ${framework.name}`);
+      const plannedIntegrations = await planIntegrations(ctx);
       if (!ctx.skipInstall) {
-        await npmInstall(corePackages.core(ctx.cliVersion), framework.runtimePackage(ctx.cliVersion));
+        const packages = [
+          corePackages.core(ctx.cliVersion),
+          framework.runtimePackage(ctx.cliVersion),
+          ...plannedIntegrations.flatMap((p) => p.plan.packages)
+        ];
+        await confirmInstall(packages, ctx.yes);
+        await npmInstall(...packages);
       }
       const projectFiles = await Promise.all([readTemplate("salty.config.ts"), readTemplate("saltygen/index.css")]);
       await promises.mkdir(ctx.projectDir, { recursive: true });
@@ -567,7 +636,7 @@ const registerInitCommand = (program) => {
       await writeProjectToRc(ctx.cwd, ctx.relativeProjectPath, framework);
       await ensureGitignoreSaltygen(ctx.cwd);
       await importSaltygenIntoCss(ctx.projectDir, opts.cssFile);
-      await detectAndApplyIntegrations(ctx);
+      await applyIntegrationPlans(plannedIntegrations);
       await wirePrepareScript();
       compiler_saltyCompiler.logger.info("Running the build to generate initial CSS...");
       const compiler = new compiler_saltyCompiler.SaltyCompiler(ctx.projectDir);
@@ -598,8 +667,8 @@ const getSaltyCssPackages = async () => {
   return saltyCssPackages;
 };
 const registerUpdateCommand = (program) => {
-  program.command("update [version]").alias("up").description("Update Salty-CSS packages to the latest or specified version.").option("-v, --version <version>", "Version to update to.").option("--legacy-peer-deps <legacyPeerDeps>", "Use legacy peer dependencies (not recommended).", false).action(async function(_version = "latest") {
-    const { legacyPeerDeps, version = _version } = this.opts();
+  program.command("update [version]").alias("up").description("Update Salty-CSS packages to the latest or specified version.").option("-v, --version <version>", "Version to update to.").option("--legacy-peer-deps <legacyPeerDeps>", "Use legacy peer dependencies (not recommended).", false).option("-y, --yes", "Skip the install confirmation prompt.").action(async function(_version = "latest") {
+    const { legacyPeerDeps, version = _version, yes = false } = this.opts();
     const saltyCssPackages = await getSaltyCssPackages();
     if (!saltyCssPackages) return compiler_saltyCompiler.logError("Could not update Salty-CSS packages as any were found in package.json.");
     const cli = await readThisPackageJson();
@@ -607,6 +676,11 @@ const registerUpdateCommand = (program) => {
       if (version === "@") return `${name}@${cli.version}`;
       return `${name}@${version.replace(/^@/, "")}`;
     });
+    try {
+      await confirmInstall(packagesToUpdate, yes);
+    } catch (err) {
+      return compiler_saltyCompiler.logError(err instanceof Error ? err.message : String(err));
+    }
     if (legacyPeerDeps) {
       compiler_saltyCompiler.logger.warn("Using legacy peer dependencies to update packages.");
       await npmInstall(...packagesToUpdate, "--legacy-peer-deps");

package/bin/main.js

@@ -9,6 +9,7 @@ import { exec } from "child_process";
 import ora from "ora";
 import { p as pascalCase } from "../pascal-case-F3Usi5Wf.js";
 import ejs from "ejs";
+import { createInterface } from "readline/promises";
 const defaultPackageJsonPath = join(process.cwd(), "package.json");
 const readPackageJson = async (filePath = defaultPackageJsonPath) => {
   const content = await readFile(filePath, "utf-8").then(JSON.parse).catch(() => void 0);
@@ -138,17 +139,21 @@ const buildContext = async (opts) => {
     packageJson,
     rcFile,
     cliVersion: cliPackageJson.version || "0.0.0",
-    skipInstall: !!opts.skipInstall
+    skipInstall: !!opts.skipInstall,
+    yes: !!opts.yes
   };
 };
 const registerBuildCommand = (program, defaultProject) => {
-  program.command("build [directory]").alias("b").description("Build the Salty-CSS project.").option("-d, --dir <dir>", "Project directory to build the project in.").option("--watch", "Watch for changes and rebuild the project.").action(async function(_dir = defaultProject) {
+  program.command("build [directory]").alias("b").description("Build the Salty-CSS project.").option("-d, --dir <dir>", "Project directory to build the project in.").option("--watch", "Watch for changes and rebuild the project.").option("--mode <mode>", 'Build mode: "production" or "development". Defaults to NODE_ENV-based detection.').action(async function(_dir = defaultProject) {
     logger.info("Building the Salty-CSS project...");
-    const { dir = _dir, watch: watch$1 } = this.opts();
+    const { dir = _dir, watch: watch$1, mode } = this.opts();
+    if (mode !== void 0 && mode !== "production" && mode !== "development") {
+      return logError(`Invalid --mode "${mode}". Expected "production" or "development".`);
+    }
     const resolved = dir ?? await getDefaultProject();
     if (!resolved) return logError("Project directory must be provided. Add it as the first argument after build command or use the --dir option.");
     const projectDir = resolveProjectDir(resolved);
-    const compiler = new SaltyCompiler(projectDir);
+    const compiler = new SaltyCompiler(projectDir, { mode });
     await compiler.generateCss();
     if (watch$1) {
       logger.info("Watching for changes in the project directory...");
@@ -290,6 +295,36 @@ const registerGenerateCommand = (program, defaultProject) => {
     await formatWithPrettier(formattedStyledFilePath);
   });
 };
+const formatPackageForDisplay = (spec) => {
+  const trimmed = spec.trim();
+  if (trimmed.startsWith("-D ")) return `${trimmed.slice(3).trim()} (dev)`;
+  return trimmed;
+};
+const renderPackageList = (packages) => {
+  return packages.map((p) => `  + ${formatPackageForDisplay(p)}`).join("\n");
+};
+const confirmInstall = async (packages, yes, options = {}) => {
+  if (yes) return;
+  if (packages.length === 0) return;
+  const input = options.input ?? process.stdin;
+  const output = options.output ?? process.stdout;
+  const isTTY = options.isTTY ?? (process.stdin.isTTY ?? false);
+  if (!isTTY) {
+    throw new Error("Cannot prompt for install confirmation: stdin is not a TTY. Re-run with --yes to install the listed packages without prompting.");
+  }
+  output.write(`The following packages will be installed:
+${renderPackageList(packages)}
+`);
+  const rl = createInterface({ input, output, terminal: false });
+  try {
+    const answer = (await rl.question("Proceed? (y/N) ")).trim().toLowerCase();
+    if (answer !== "y" && answer !== "yes") {
+      throw new Error("Install cancelled by user.");
+    }
+  } finally {
+    rl.close();
+  }
+};
 const CSS_FILE_FOLDERS = ["src", "public", "assets", "styles", "css", "app"];
 const CSS_SECOND_LEVEL_FOLDERS = ["styles", "css", "app", "pages"];
 const CSS_FILE_NAMES = ["index", "styles", "main", "app", "global", "globals"];
@@ -336,17 +371,22 @@ const editAstroConfig = (existing) => {
 const astroIntegration = {
   name: "astro",
   detect: (ctx) => findAstroConfig(ctx.projectDir),
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await readFile(configPath, "utf-8").catch(() => void 0);
-    if (existing === void 0) return { changed: false };
+    if (existing === void 0) return null;
     const result = editAstroConfig(existing);
     if (result.warning) logger.warn(result.warning);
-    if (result.content === null) return { changed: false };
-    if (!ctx.skipInstall) await npmInstall(`-D ${astroPackage(ctx.cliVersion)}`);
-    logger.info("Adding Salty-CSS integration to Astro config: " + configPath);
-    await writeFile(configPath, result.content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (result.content === null) return null;
+    const newContent = result.content;
+    return {
+      packages: [`-D ${astroPackage(ctx.cliVersion)}`],
+      execute: async () => {
+        logger.info("Adding Salty-CSS integration to Astro config: " + configPath);
+        await writeFile(configPath, newContent);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const ESLINT_CONFIG_CANDIDATES = [
@@ -405,20 +445,25 @@ const eslintIntegration = {
     const candidates = eslintConfigCandidates(ctx.projectDir, ctx.cwd);
     return candidates.find((p) => existsSync(p)) ?? null;
   },
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await readFile(configPath, "utf-8").catch(() => void 0);
     if (existing === void 0) {
       logger.error("Could not read ESLint config file.");
-      return { changed: false };
+      return null;
     }
-    if (!ctx.skipInstall) await npmInstall(corePackages.eslintConfigCore(ctx.cliVersion));
     const result = editEslintConfig(existing, configPath.endsWith("js"));
     if (result.warning) logger.warn(result.warning);
-    if (result.content === null) return { changed: false };
-    logger.info("Edit file: " + configPath);
-    await writeFile(configPath, result.content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (result.content === null) return null;
+    const newContent = result.content;
+    return {
+      packages: [corePackages.eslintConfigCore(ctx.cliVersion)],
+      execute: async () => {
+        logger.info("Edit file: " + configPath);
+        await writeFile(configPath, newContent);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const nextConfigFiles = ["next.config.js", "next.config.cjs", "next.config.ts", "next.config.mjs"];
@@ -448,16 +493,20 @@ const nextIntegration = {
     const found = nextConfigFiles.map((file) => join(ctx.projectDir, file)).find((p) => existsSync(p));
     return found ?? null;
   },
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await readFile(configPath, "utf-8").catch(() => void 0);
-    if (existing === void 0) return { changed: false };
+    if (existing === void 0) return null;
     const { content } = editNextConfig(existing);
-    if (content === null) return { changed: false };
-    if (!ctx.skipInstall) await npmInstall(`-D ${nextPackage(ctx.cliVersion)}`);
-    logger.info("Adding Salty-CSS plugin to Next.js config...");
-    await writeFile(configPath, content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (content === null) return null;
+    return {
+      packages: [`-D ${nextPackage(ctx.cliVersion)}`],
+      execute: async () => {
+        logger.info("Adding Salty-CSS plugin to Next.js config...");
+        await writeFile(configPath, content);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const vitePackage = (version) => `@salty-css/vite@${version}`;
@@ -475,27 +524,40 @@ const viteIntegration = {
     const path = join(ctx.projectDir, "vite.config.ts");
     return existsSync(path) ? path : null;
   },
-  apply: async (ctx, configPath) => {
+  plan: async (ctx, configPath) => {
     const existing = await readFile(configPath, "utf-8").catch(() => void 0);
-    if (existing === void 0) return { changed: false };
+    if (existing === void 0) return null;
     const { content } = editViteConfig(existing);
-    if (content === null) return { changed: false };
-    logger.info("Edit file: " + configPath);
-    if (!ctx.skipInstall) await npmInstall(`-D ${vitePackage(ctx.cliVersion)}`);
-    logger.info("Adding Salty-CSS plugin to Vite config...");
-    await writeFile(configPath, content);
-    await formatWithPrettier(configPath);
-    return { changed: true };
+    if (content === null) return null;
+    return {
+      packages: [`-D ${vitePackage(ctx.cliVersion)}`],
+      execute: async () => {
+        logger.info("Edit file: " + configPath);
+        logger.info("Adding Salty-CSS plugin to Vite config...");
+        await writeFile(configPath, content);
+        await formatWithPrettier(configPath);
+        return { changed: true };
+      }
+    };
   }
 };
 const buildIntegrationRegistry = [eslintIntegration, viteIntegration, nextIntegration, astroIntegration];
-const detectAndApplyIntegrations = async (ctx) => {
-  const results = [];
+const planIntegrations = async (ctx) => {
+  const planned = [];
   for (const integration of buildIntegrationRegistry) {
     const configPath = await integration.detect(ctx);
     if (!configPath) continue;
-    const result = await integration.apply(ctx, configPath);
-    results.push({ name: integration.name, configPath, changed: result.changed });
+    const plan = await integration.plan(ctx, configPath);
+    if (!plan) continue;
+    planned.push({ name: integration.name, configPath, plan });
+  }
+  return planned;
+};
+const applyIntegrationPlans = async (planned) => {
+  const results = [];
+  for (const { name, configPath, plan } of planned) {
+    const result = await plan.execute();
+    results.push({ name, configPath, changed: result.changed });
   }
   return results;
 };
@@ -546,17 +608,24 @@ const wirePrepareScript = async () => {
   await updatePackageJson(next);
 };
 const registerInitCommand = (program) => {
-  program.command("init [directory]").description("Initialize a new Salty-CSS project.").option("-d, --dir <dir>", "Project directory to initialize the project in.").option("--css-file <css-file>", "Existing CSS file where to import the generated CSS. Path must be relative to the given project directory.").option("--skip-install", "Skip installing dependencies.").action(async function(_dir = ".") {
+  program.command("init [directory]").description("Initialize a new Salty-CSS project.").option("-d, --dir <dir>", "Project directory to initialize the project in.").option("--css-file <css-file>", "Existing CSS file where to import the generated CSS. Path must be relative to the given project directory.").option("--skip-install", "Skip installing dependencies.").option("-y, --yes", "Skip the install confirmation prompt.").action(async function(_dir = ".") {
     try {
       const opts = this.opts();
       const dir = opts.dir ?? _dir;
       if (!dir) return logError("Project directory must be provided. Add it as the first argument after init command or use the --dir option.");
-      const ctx = await buildContext({ dir, skipInstall: opts.skipInstall });
+      const ctx = await buildContext({ dir, skipInstall: opts.skipInstall, yes: opts.yes });
       logger.info("Initializing a new Salty-CSS project!");
       const framework = await detectFramework(ctx);
       logger.info(`Detected framework: ${framework.name}`);
+      const plannedIntegrations = await planIntegrations(ctx);
       if (!ctx.skipInstall) {
-        await npmInstall(corePackages.core(ctx.cliVersion), framework.runtimePackage(ctx.cliVersion));
+        const packages = [
+          corePackages.core(ctx.cliVersion),
+          framework.runtimePackage(ctx.cliVersion),
+          ...plannedIntegrations.flatMap((p) => p.plan.packages)
+        ];
+        await confirmInstall(packages, ctx.yes);
+        await npmInstall(...packages);
       }
       const projectFiles = await Promise.all([readTemplate("salty.config.ts"), readTemplate("saltygen/index.css")]);
       await mkdir(ctx.projectDir, { recursive: true });
@@ -564,7 +633,7 @@ const registerInitCommand = (program) => {
       await writeProjectToRc(ctx.cwd, ctx.relativeProjectPath, framework);
       await ensureGitignoreSaltygen(ctx.cwd);
       await importSaltygenIntoCss(ctx.projectDir, opts.cssFile);
-      await detectAndApplyIntegrations(ctx);
+      await applyIntegrationPlans(plannedIntegrations);
       await wirePrepareScript();
       logger.info("Running the build to generate initial CSS...");
       const compiler = new SaltyCompiler(ctx.projectDir);
@@ -595,8 +664,8 @@ const getSaltyCssPackages = async () => {
   return saltyCssPackages;
 };
 const registerUpdateCommand = (program) => {
-  program.command("update [version]").alias("up").description("Update Salty-CSS packages to the latest or specified version.").option("-v, --version <version>", "Version to update to.").option("--legacy-peer-deps <legacyPeerDeps>", "Use legacy peer dependencies (not recommended).", false).action(async function(_version = "latest") {
-    const { legacyPeerDeps, version = _version } = this.opts();
+  program.command("update [version]").alias("up").description("Update Salty-CSS packages to the latest or specified version.").option("-v, --version <version>", "Version to update to.").option("--legacy-peer-deps <legacyPeerDeps>", "Use legacy peer dependencies (not recommended).", false).option("-y, --yes", "Skip the install confirmation prompt.").action(async function(_version = "latest") {
+    const { legacyPeerDeps, version = _version, yes = false } = this.opts();
     const saltyCssPackages = await getSaltyCssPackages();
     if (!saltyCssPackages) return logError("Could not update Salty-CSS packages as any were found in package.json.");
     const cli = await readThisPackageJson();
@@ -604,6 +673,11 @@ const registerUpdateCommand = (program) => {
       if (version === "@") return `${name}@${cli.version}`;
       return `${name}@${version.replace(/^@/, "")}`;
     });
+    try {
+      await confirmInstall(packagesToUpdate, yes);
+    } catch (err) {
+      return logError(err instanceof Error ? err.message : String(err));
+    }
     if (legacyPeerDeps) {
       logger.warn("Using legacy peer dependencies to update packages.");
       await npmInstall(...packagesToUpdate, "--legacy-peer-deps");

package/compiler/salty-compiler.cjs

@@ -111,7 +111,7 @@ const saltyReset = {
   }
 };
 class SaltyCompiler {
-  constructor(projectRootDir) {
+  constructor(projectRootDir, options = {}) {
     __publicField(this, "importFile", (path2) => {
       const now = Date.now();
       return import(
@@ -691,11 +691,13 @@ ${newContent}
       });
     });
     this.projectRootDir = projectRootDir;
+    this.options = options;
     if (typeof process === "undefined") {
       throw new Error("SaltyServer can only be used in a Node.js environment.");
     }
   }
   get isProduction() {
+    if (this.options.mode) return this.options.mode === "production";
     try {
       return process.env["NODE_ENV"] !== "development";
     } catch {

package/compiler/salty-compiler.d.ts

@@ -1,9 +1,14 @@
 import { CachedConfig, SaltyConfig } from '../config';
+export type SaltyCompilerMode = 'production' | 'development';
+export interface SaltyCompilerOptions {
+    mode?: SaltyCompilerMode;
+}
 export declare class SaltyCompiler {
     projectRootDir: string;
+    private options;
     importFile: (path: string) => Promise<any>;
     private cache;
-    constructor(projectRootDir: string);
+    constructor(projectRootDir: string, options?: SaltyCompilerOptions);
     get isProduction(): boolean;
     /**
      * Locate and read the .saltyrc.json file starting from the current directory and moving up the directory tree.

package/compiler/salty-compiler.js

@@ -91,7 +91,7 @@ const saltyReset = {
   }
 };
 class SaltyCompiler {
-  constructor(projectRootDir) {
+  constructor(projectRootDir, options = {}) {
     __publicField(this, "importFile", (path) => {
       const now = Date.now();
       return import(
@@ -671,11 +671,13 @@ ${newContent}
       });
     });
     this.projectRootDir = projectRootDir;
+    this.options = options;
     if (typeof process === "undefined") {
       throw new Error("SaltyServer can only be used in a Node.js environment.");
     }
   }
   get isProduction() {
+    if (this.options.mode) return this.options.mode === "production";
     try {
       return process.env["NODE_ENV"] !== "development";
     } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salty-css/core",
-  "version": "0.1.0-alpha.14",
+  "version": "0.1.0-alpha.16",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "typings": "./dist/index.d.ts",