@salty-css/core 0.1.0-alpha.9 → 0.1.0-feat-define-import.0

package/README.md

@@ -57,6 +57,7 @@ To get help with problems, [Join Salty CSS Discord server](https://discord.gg/R6
 - [defineVariables](#variables) - create CSS variables (tokens) that can be used in any styling function
 - [defineMediaQuery](#media-queries) - create CSS media queries and use them in any styling function
 - [defineTemplates](#templates) - create reusable templates that can be applied when same styles are used over and over again
+- [defineImport](#importing-additional-css) - pull in external CSS files (relative, public, node_modules, or URL)
 - [keyframes](#keyframes-animations) - create CSS keyframes animation that can be used and imported in any styling function
 
 ### Styling helpers & utility
@@ -319,6 +320,49 @@ Example usage:
 styled('div', { base: { textStyle: 'headline.large', card: '20px' } });
 ```
 
+## Importing additional CSS
+
+Use `defineImport` to pull in CSS that lives outside of Salty's authoring API — a reset stylesheet from npm, a Google Fonts URL, an asset in your app's `public/` folder, or a sibling `.css` file. The compiler turns each spec into an `@import` rule in the generated `saltygen/index.css`, so the imported stylesheets travel with the rest of your build.
+
+```ts
+// /styles/imports.css.ts
+import { defineImport } from '@salty-css/core/factories';
+
+export default defineImport(
+  // Relative to this file
+  './reset.css',
+  // From node_modules (bare specifier — same as Vite / native CSS @import)
+  'modern-normalize/modern-normalize.css',
+  // From node_modules (~ prefix — same resolver, webpack-style)
+  '~normalize.css/normalize.css',
+  // From your app's public/ folder (served at the host root)
+  '/fonts/inter.css',
+  // External URL
+  'https://fonts.googleapis.com/css2?family=Inter&display=swap',
+  // Object form — attach media or supports() conditions
+  { url: './print.css', media: 'print' },
+  { url: './p3.css', supports: 'color(display-p3 1 1 1)' }
+);
+```
+
+Path resolution:
+
+| Pattern                     | Behaviour                                                                                |
+| --------------------------- | ---------------------------------------------------------------------------------------- |
+| `http://`, `https://`, `//` | Emitted verbatim                                                                         |
+| Starts with `/`             | Public-folder URL — emitted verbatim, the browser resolves it against your host          |
+| Starts with `./` or `../`   | Resolved at build time relative to the file that called `defineImport`                   |
+| `~package/file.css`         | Stripped of the leading `~`, then resolved from `node_modules` and copied into the build |
+| `package/file.css` (bare)   | Same `node_modules` resolution as the `~` form                                           |
+
+All imports are placed inside a new `imports` cascade layer that sits **before** `reset`, `global`, `templates`, and your component styles. This means your own styles always win over third-party CSS you pull in — which is what most teams expect when they drop in something like `modern-normalize`.
+
+The full layer order in the generated `index.css` is:
+
+```css
+@layer imports, reset, global, templates, l0, l1, l2, l3, l4, l5, l6, l7, l8;
+```
+
 ## Keyframes animations
 
 ```ts

package/bin/confirm-install.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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>;
+export interface ConfirmYesNoOptions extends ConfirmInstallOptions {
+    /** When true, resolves true without prompting. */
+    yes?: boolean;
+    /** When true, an empty answer counts as yes. Defaults to false (empty = no). */
+    defaultYes?: boolean;
+}
+/**
+ * Generic yes/no prompt. Unlike `confirmInstall`, non-TTY without `yes`
+ * resolves `false` instead of throwing — callers can choose policy.
+ */
+export declare const confirmYesNo: (question: string, options?: ConfirmYesNoOptions) => Promise<boolean>;

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...");
@@ -225,7 +230,7 @@ const getFramework = (name) => {
   return frameworksByName[name];
 };
 const templateLoaders = {
-  "salty.config.ts": () => Promise.resolve().then(() => require("../salty.config-cqavVm2t.cjs")),
+  "salty.config.ts": () => Promise.resolve().then(() => require("../salty.config-DogY_sSQ.cjs")),
   "saltygen/index.css": () => Promise.resolve().then(() => require("../index-ByR0nfaf.cjs")),
   "react/styled-file.ts": () => Promise.resolve().then(() => require("../styled-file-CPd_rTW2.cjs")),
   "react/vanilla-file.ts": () => Promise.resolve().then(() => require("../vanilla-file-r0fp2q_m.cjs")),
@@ -293,6 +298,52 @@ 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 confirmYesNo = async (question, options = {}) => {
+  if (options.yes) return true;
+  const input = options.input ?? process.stdin;
+  const output = options.output ?? process.stdout;
+  const isTTY = options.isTTY ?? process.stdin.isTTY ?? false;
+  if (!isTTY) return false;
+  const suffix = options.defaultYes ? "(Y/n)" : "(y/N)";
+  const rl = promises$1.createInterface({ input, output, terminal: false });
+  try {
+    const answer = (await rl.question(`${question} ${suffix} `)).trim().toLowerCase();
+    if (answer === "") return !!options.defaultYes;
+    return answer === "y" || answer === "yes";
+  } 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 +390,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 +464,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 +512,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 +543,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 +627,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 +652,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 +683,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 confirmation prompts (install and rebuild).").option("-d, --dir <dir>", "Project directory to rebuild after updating.").action(async function(_version = "latest") {
+    const { legacyPeerDeps, version = _version, yes = false, dir } = 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 +692,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");
@@ -629,6 +719,17 @@ const registerUpdateCommand = (program) => {
         compiler_saltyCompiler.logger.info(`Updated to ${v.replace(/^\^/, "")}: ${names.join(", ")}`);
       }
     }
+    const project = dir ?? await getDefaultProject();
+    if (!project) {
+      compiler_saltyCompiler.logger.warn("Skipping rebuild: no project directory configured. Run `salty-css build [dir]` manually.");
+      return;
+    }
+    const shouldRebuild = await confirmYesNo("Rebuild Salty CSS now?", { yes });
+    if (!shouldRebuild) return;
+    const projectDir = resolveProjectDir(project);
+    compiler_saltyCompiler.logger.info("Rebuilding Salty-CSS project...");
+    await new compiler_saltyCompiler.SaltyCompiler(projectDir).generateCss();
+    compiler_saltyCompiler.logger.info("Rebuild complete.");
   });
 };
 const registerVersionOption = (program) => {