@salty-css/core 0.0.1-alpha.12 → 0.0.1-alpha.120

package/.saltyrc.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Salty CSS CLI Run Configuration",
+  "description": "File .saltyrc.json is used to define projects and their configurations in json format for salty css cli.",
+  "type": "object",
+  "properties": {
+    "info": {
+      "type": "string",
+      "description": "Info about what the file is about."
+    },
+    "defaultProject": {
+      "type": "string",
+      "description": "The default project to be used."
+    },
+    "projects": {
+      "type": "array",
+      "description": "List of projects.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "dir": {
+            "type": "string",
+            "description": "The directory of the project. This is also used as the project name."
+          },
+          "framework": {
+            "type": "string",
+            "description": "The framework used by the project.",
+            "enum": ["react", "other"]
+          },
+          "components": {
+            "type": "string",
+            "description": "The directory for the components."
+          }
+        },
+        "required": ["dir", "framework"]
+      }
+    }
+  },
+  "required": ["defaultProject", "projects"]
+}

package/README.md

@@ -1,15 +1,91 @@
-# Salty Css
+# Salty CSS - Kinda sweet but yet spicy CSS-in-JS library
 
-## Basic usage example with Button
+In the world of frontend dev is there anything saltier than CSS? Salty CSS is built to provide better developer experience for developers looking for performant and feature rich CSS-in-JS solutions.
 
-### Initial requirements
+## Features
 
-1. Add `saltyPlugin` to vite or webpack config from `@salty-css/vite` or `@salty-css/webpack`
-2. Create `salty-config.ts` to the root of your project
-3. Import global styles to any regular .css file from `saltygen/index.css` (does not exist during first run, cli command coming later)
-4. Create salty components with styled only inside files that end with `.css.ts`, `.salty.ts` `.styled.ts` or `.styles.ts`
+- Build time compilation to achieve awesome runtime performance and minimal size
+- Next.js, React Server Components, Vite and Webpack support
+- Type safety with out of the box TypeScript and ESLint plugin
+- Advanced CSS variables configuration to allow smooth token usage
+- Style templates to create reusable styles easily
 
-### Code examples
+## Get started
+
+- Initialize: `npx salty-css init [directory]`
+- Create component: `npx salty-css generate [filePath]`
+- Build: `npx salty-css build [directory]`
+
+### Initialize
+
+Fastest way to get started with any framework is [npx salty-css init [directory]](#initialize-salty-css-for-a-project) command
+
+- Next.js → [Next.js guide](#nextjs) + [Next.js example app](https://github.com/margarita-form/salty-css-website)
+- React → [React guide](#react) + [React example code](#code-examples)
+- Vite → [Vite guide](#vite)
+- Webpack → Guide coming soon
+- ESLint → Guide coming soon
+
+### Salty CSS CLI
+
+In your existing repository you can use `npx salty-css [command]` to initialize a project, generate components, update related packages and build required files.
+
+- Initialize project → `npx salty-css init [directory]` - Installs required packages, detects framework in use and creates project files to the provided directory. Directory can be left blank if you want files to be created to the current directory.
+- Generate component → `npx salty-css update [version]` - Update @salty-css packages in your repository. Default version is "latest". Additional options like `--dir`, `--tag`, `--name` and `--className` are also supported.
+- Build files → `npx salty-css build [directory]` - Compile Salty CSS related files in your project. This should not be needed if you are using tools like Next.js or Vite
+
+### Guides
+
+#### Next.js
+
+In your existing Next.js repository you can run `npx salty-css init` to automatically configure Salty CSS.
+
+##### Manual configuration
+
+1. For Next.js support install `npm i @salty-css/next @salty-css/core @salty-css/react`
+2. Create `salty.config.ts` to your app directory
+3. Add Salty CSS plugin to next.js config
+
+- **Next.js 15:** In `next.config.ts` add import for salty plugin `import { withSaltyCss } from '@salty-css/next';` and then add `withSaltyCss` to wrap your nextConfig export like so `export default withSaltyCss(nextConfig);`
+- **Next.js 14 and older:** In `next.config.js` add import for salty plugin `const { withSaltyCss } = require('@salty-css/next');` and then add `withSaltyCss` to wrap your nextConfig export like so `module.exports = withSaltyCss(nextConfig);`
+
+4. Make sure that `salty.config.ts` and `next.config.ts` are in the same folder!
+5. Build `saltygen` directory by running your app once or with cli `npx salty-css build [directory]`
+6. Import global styles from `saltygen/index.css` to some global css file with `@import 'insert_path_to_index_css';`.
+
+[Check out Next.js demo project](https://github.com/margarita-form/salty-css-website) or [react example code](#code-examples)
+
+#### Vite
+
+In your existing Vite repository you can run `npx salty-css init` to automatically configure Salty CSS.
+
+##### Manual configuration
+
+1. For Vite support install `npm i @salty-css/vite @salty-css/core`
+2. In `vite.config` add import for salty plugin `import { saltyPlugin } from '@salty-css/vite';` and then add `saltyPlugin(__dirname)` to your vite configuration plugins
+3. Make sure that `salty.config.ts` and `vite.config.ts` are in the same folder!
+4. Build `saltygen` directory by running your app once or with cli `npx salty-css build [directory]`
+5. Import global styles from `saltygen/index.css` to some global css file with `@import 'insert_path_to_index_css';`.
+
+#### React
+
+In your existing React repository you can run `npx salty-css init` to automatically configure Salty CSS.
+
+##### Manual configuration
+
+1. Install related dependencies: `npm i @salty-css/core @salty-css/react`
+2. Create `salty.config.ts` to your app directory
+3. Configure your build tool to support Salty CSS ([Vite](#vite) or Webpack) or after changes run `npx salty-css build`
+
+[Check out react example code](#code-examples)
+
+### Create components
+
+1. Create salty components with styled only inside files that end with `.css.ts`, `.salty.ts` `.styled.ts` or `.styles.ts`
+
+## Code examples
+
+### Basic usage example with Button
 
 **Salty config**
 
@@ -31,23 +107,6 @@ export const config = defineConfig({
 });
 ```
 
-**Your React component file**
-
-```tsx
-import { Wrapper } from '../components/wrapper/wrapper.css';
-import { Button } from '../components/button/button.css';
-
-export const IndexPage = () => {
-  return (
-    <Wrapper>
-      <Button variant="solid" onClick={() => alert('It is a button.')}>
-        Outlined
-      </Button>
-    </Wrapper>
-  );
-};
-```
-
 **Wrapper** (`components/wrapper/wrapper.css.ts`)
 
 ```tsx
@@ -72,7 +131,7 @@ export const Button = styled('button', {
     padding: `0.6em 1.2em`,
     border: '1px solid currentColor',
     background: 'transparent',
-    color: 'currentColor/40',
+    color: 'currentColor',
     cursor: 'pointer',
     transition: '200ms',
     textDecoration: 'none',
@@ -108,4 +167,21 @@ export const Button = styled('button', {
 });
 ```
 
+**Your React component file**
+
+```tsx
+import { Wrapper } from '../components/wrapper/wrapper.css';
+import { Button } from '../components/button/button.css';
+
+export const IndexPage = () => {
+  return (
+    <Wrapper>
+      <Button variant="solid" onClick={() => alert('It is a button.')}>
+        Outlined
+      </Button>
+    </Wrapper>
+  );
+};
+```
+
 More examples coming soon

package/bin/bin-util.d.ts

@@ -0,0 +1,2 @@
+export declare const execAsync: (command: string) => Promise<void>;
+export declare const npmInstall: (...packages: string[]) => Promise<void>;

package/bin/index.cjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";const e=require("./main.cjs");e.main().catch(n=>console.error(n));

package/bin/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { main as r } from "./main.js";
+r().catch((o) => console.error(o));

package/bin/logger.d.ts

@@ -0,0 +1,2 @@
+export declare const logger: import('winston').Logger;
+export declare const logError: (message: string) => void;

package/bin/main.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const te=require("commander"),G=require("fs"),s=require("fs/promises"),n=require("path"),ne=require("ejs"),t=require("../index-mhoDzsNb.cjs"),ie=require("../pascal-case-iWoaJWwT.cjs"),se=require("child_process"),oe=require("ora");var z=typeof document<"u"?document.currentScript:null;const X=y=>new Promise((C,P)=>{se.exec(y,F=>{if(F)return P(F);C()})}),I=async(...y)=>{const C=y.map(b=>b.replace("-D","").split("@").slice(0,-1).join("@").trim()).join(", "),P=oe(`Installing packages: ${C}`).start(),F=y.join(" ");await X(`npm install ${F}`),P.succeed(`Installed packages: ${C}`)},ae=()=>G.existsSync(n.join(process.cwd(),"node_modules",".bin","prettier"));async function S(y){try{if(!ae())return;await X(`./node_modules/.bin/prettier --write "${y}"`),t.logger.info(`Formatted ${y} with Prettier`)}catch(C){t.logger.error(`Error formatting ${y} with Prettier:`,C)}}async function re(){const y=new te.Command;y.name("salty-css").description("Salty-CSS CLI tool to help with annoying configuration tasks.");const C={"salty.config.ts":Promise.resolve().then(()=>require("../salty.config-Dk6ZcCxI.cjs")),"saltygen/index.css":Promise.resolve().then(()=>require("../index-84Wroia-.cjs")),"react/react-styled-file.ts":Promise.resolve().then(()=>require("../react-styled-file-Dkubsz-U.cjs")),"react/react-vanilla-file.ts":Promise.resolve().then(()=>require("../react-vanilla-file-CG_WJLam.cjs"))},P=async(i,a)=>{const{default:l}=await C[i],u=ne.render(l,a);return{fileName:i,content:u}},F=async()=>{const i=n.join(process.cwd(),".saltyrc.json");return await s.readFile(i,"utf-8").then(JSON.parse).catch(()=>({}))},b=n.join(process.cwd(),"package.json"),N=async(i=b)=>{const a=await s.readFile(i,"utf-8").then(JSON.parse).catch(()=>{});if(!a)throw"Could not read package.json file!";return a},Y=async(i,a=b)=>{typeof i=="object"&&(i=JSON.stringify(i,null,2)),await s.writeFile(a,i)},B=async()=>{const i=new URL("../package.json",typeof document>"u"?require("url").pathToFileURL(__filename).href:z&&z.tagName.toUpperCase()==="SCRIPT"&&z.src||new URL("bin/main.cjs",document.baseURI).href);return N(i)},V=await(async()=>(await F()).defaultProject)(),$=await B(),D={core:`@salty-css/core@${$.version}`,react:`@salty-css/react@${$.version}`,eslintConfigCore:`@salty-css/eslint-config-core@${$.version}`,vite:`@salty-css/vite@${$.version}`,next:`@salty-css/next@${$.version}`},R=i=>{const a=i==="."?"":i,l=process.cwd();return n.join(l,a)};y.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(i="."){if(!await N().catch(()=>{}))return t.logError("Salty CSS project must be initialized in a directory with a package.json file.");t.logger.info("Initializing a new Salty-CSS project!");const{dir:l=i,cssFile:u,skipInstall:p}=this.opts();if(!l)return t.logError("Project directory must be provided. Add it as the first argument after init command or use the --dir option.");p||await I(D.core,D.react);const f=process.cwd(),r=R(l),T=await Promise.all([P("salty.config.ts"),P("saltygen/index.css")]);await s.mkdir(r,{recursive:!0});const m=T.map(async({fileName:e,content:g})=>{const c=n.join(r,e);if(await s.readFile(c,"utf-8").catch(()=>{})!==void 0){t.logger.debug("File already exists: "+c);return}const k=e.split("/").slice(0,-1).join("/");k&&await s.mkdir(n.join(r,k),{recursive:!0}),t.logger.info("Creating file: "+c),await s.writeFile(c,g),await S(c)});await Promise.all(m);const w=n.relative(f,r)||".",h=n.join(f,".saltyrc.json"),d=await s.readFile(h,"utf-8").catch(()=>{});if(d===void 0){t.logger.info("Creating file: "+h);const g=JSON.stringify({$schema:"./node_modules/@salty-css/core/.saltyrc.schema.json",info:"This file is used to define projects and their configurations for Salty CSS cli. Do not delete, modify or add this file to .gitignore.",defaultProject:w,projects:[{dir:w,framework:"react"}]},null,2);await s.writeFile(h,g),await S(h)}else{const e=JSON.parse(d),g=(e==null?void 0:e.projects)||[];if(g.findIndex(o=>o.dir===w)===-1){g.push({dir:w,framework:"react"}),e.projects=[...g];const o=JSON.stringify(e,null,2);o!==d&&(t.logger.info("Edit file: "+h),await s.writeFile(h,o),await S(h))}}const j=n.join(f,".gitignore"),U=await s.readFile(j,"utf-8").catch(()=>{});U!==void 0&&(U.includes("saltygen")||(t.logger.info("Edit file: "+j),await s.writeFile(j,U+`
+
+# Salty-CSS
+saltygen
+`)));const x=["src","public","assets","styles","css","app"],H=["styles","css","app","pages"],M=["index","styles","main","global","globals"],L=[".css",".scss",".sass"],E=await(async()=>{if(u)return u;for(const e of x)for(const g of M)for(const c of L){const o=n.join(r,e,g+c);if(await s.readFile(o,"utf-8").catch(()=>{})!==void 0)return n.relative(r,o);for(const O of H){const q=n.join(r,e,O,g+c);if(await s.readFile(q,"utf-8").catch(()=>{})!==void 0)return n.relative(r,q)}}})();if(E){const e=n.join(r,E),g=await s.readFile(e,"utf-8").catch(()=>{});if(g!==void 0&&!g.includes("saltygen")){const o=n.join(e,".."),O=`@import '${n.relative(o,n.join(r,"saltygen/index.css"))}';`;t.logger.info("Adding global import statement to CSS file: "+e),await s.writeFile(e,O+`
+`+g),await S(e)}}else t.logger.warn("Could not find a CSS file to import the generated CSS. Please add it manually.");const Z={projectJs:n.join(r,"eslint.config.js"),rootJs:n.join(f,"eslint.config.js"),projectMjs:n.join(r,"eslint.config.mjs"),rootMjs:n.join(f,"eslint.config.mjs"),projectJson:n.join(r,".eslintrc.json"),rootJson:n.join(f,".eslintrc.json")},v=Object.values(Z).find(e=>G.existsSync(e));if(v){p||await I(D.eslintConfigCore);const e=await s.readFile(v,"utf-8").catch(()=>{});if(!e)return t.logError("Could not read ESLint config file.");if(!e.includes("salty-css"))if(t.logger.info("Edit file: "+v),v.endsWith("js")){let o=`import saltyCss from "@salty-css/eslint-config-core/flat";
+${e}`;e.includes("typescript-eslint")?o.includes(".config(")?o=o.replace(".config(",".config(saltyCss,"):t.logger.warn("Could not find the correct place to add the Salty-CSS config for ESLint. Please add it manually."):o.includes("export default [")?o=o.replace("export default [","export default [ saltyCss,"):o.includes("eslintConfig = [")?o=o.replace("eslintConfig = [","eslintConfig = [ saltyCss,"):t.logger.warn("Could not find the correct place to add the Salty-CSS config for ESLint. Please add it manually."),await s.writeFile(v,o),await S(v)}else{const c=JSON.parse(e);c.extends||(c.extends=[]),c.extends.push("@salty-css/core");const o=JSON.stringify(c,null,2);await s.writeFile(v,o),await S(v)}}const _=n.join(r,"vite.config.ts"),W=await s.readFile(_,"utf-8").catch(()=>{});if(W!==void 0&&!W.includes("saltyPlugin")){t.logger.info("Edit file: "+_);const g=`import { saltyPlugin } from '@salty-css/vite';
+`,o=W.replace(/(plugins: \[)/,`$1
+  saltyPlugin(__dirname),`);p||await I(`-D ${D.vite}`),t.logger.info("Adding Salty-CSS plugin to Vite config..."),await s.writeFile(_,g+o),await S(_)}const A=["next.config.js","next.config.cjs","next.config.ts","next.config.mjs"].map(e=>n.join(r,e)).find(e=>G.existsSync(e));if(A){let e=await s.readFile(A,"utf-8").catch(()=>{});if(e!==void 0&&!e.includes("withSaltyCss")){let c=!1;/\splugins([^=]*)=[^[]\[/.test(e)&&!c&&(e=e.replace(/\splugins([^=]*)=[^[]\[/,(q,J)=>` plugins${J}= [withSaltyCss,`),c=!0);const k=e.includes("module.exports"),O=k?`const { withSaltyCss } = require('@salty-css/next');
+`:`import { withSaltyCss } from '@salty-css/next';
+`;k&&!c?(e=e.replace(/module.exports = ([^;]+)/,(q,J)=>`module.exports = withSaltyCss(${J})`),c=!0):c||(e=e.replace(/export default ([^;]+)/,(q,J)=>`export default withSaltyCss(${J})`)),p||await I(`-D ${D.next}`),t.logger.info("Adding Salty-CSS plugin to Next.js config..."),await s.writeFile(A,O+e),await S(A)}}const ee=await N().catch(()=>t.logError("Could not read package.json file.")).then(e=>(e.scripts||(e.scripts={}),e.scripts.prepare?e.scripts.prepare.includes("salty-css")||(t.logger.info("Edit file: "+b),e.scripts.prepare=e.scripts.prepare+" && npx salty-css build"):(t.logger.info("Edit file: "+b),e.scripts.prepare="npx salty-css build"),e));await Y(ee),t.logger.info("Running the build to generate initial CSS..."),await t.generateCss(r),t.logger.info("🎉 Salty CSS project initialized successfully!"),t.logger.info("Next steps:"),t.logger.info("1. Configure variables and templates in `salty.config.ts`"),t.logger.info("2. Create a new component with `npx salty-css generate [component-name]`"),t.logger.info("3. Run `npx salty-css build` to generate the CSS"),t.logger.info("4. Read about the features in the documentation: https://salty-css.dev"),t.logger.info("5. Star the project on GitHub: https://github.com/margarita-form/salty-css ⭐")}),y.command("build [directory]").alias("b").description("Build the Salty-CSS project.").option("-d, --dir <dir>","Project directory to build the project in.").action(async function(i=V){t.logger.info("Building the Salty-CSS project...");const{dir:a=i}=this.opts();if(!a)return t.logError("Project directory must be provided. Add it as the first argument after build command or use the --dir option.");const l=R(a);await t.generateCss(l)}),y.command("generate [file] [directory]").alias("g").description("Generate a new component file.").option("-f, --file <file>","File to generate.").option("-d, --dir <dir>","Project directory to generate the file in.").option("-t, --tag <tag>","HTML tag of the component.","div").option("-n, --name <name>","Name of the component.").option("-c, --className <className>","CSS class of the component.").option("-r, --reactComponent","Generate a React component as well.").action(async function(i,a=V){const{file:l=i,dir:u=a,tag:p,name:f,className:r,reactComponent:T=!1}=this.opts();if(!l)return t.logError("File to generate must be provided. Add it as the first argument after generate command or use the --file option.");if(!u)return t.logError("Project directory must be provided. Add it as the second argument after generate command or use the --dir option.");const m=R(u),w=l.split("/").slice(0,-1).join("/");w&&await s.mkdir(n.join(m,w),{recursive:!0});const h=n.join(m,l),d=n.parse(h);d.ext||(d.ext=".ts"),d.name.endsWith(".css")||(d.name=d.name+".css"),d.base=d.name+d.ext;const j=n.format(d);if(await s.readFile(j,"utf-8").catch(()=>{})!==void 0){t.logger.error("File already exists:",j);return}let x=ie.pascalCase(f||d.base.replace(/\.css\.\w+$/,""));if(T){const M=x+"Component";x=x+"Wrapper";const L=d.base.replace(/\.css\.\w+$/,""),{content:Q}=await P("react/react-vanilla-file.ts",{tag:p,componentName:M,styledComponentName:x,className:r,fileName:L});d.name=L.replace(/\.css$/,""),d.ext=".tsx",d.base=d.name+d.ext;const E=n.format(d);t.logger.info("Generating a new file: "+E),await s.writeFile(E,Q),await S(E)}const{content:H}=await P("react/react-styled-file.ts",{tag:p,name:x,className:r});t.logger.info("Generating a new file: "+j),await s.writeFile(j,H),await S(j)});const K=async()=>{const i=n.join(process.cwd(),"package.json"),a=await N(i).catch(p=>t.logError(p));if(!a)return t.logError("Could not read package.json file.");const l={...a.dependencies,...a.devDependencies},u=Object.entries(l).filter(([p])=>p==="salty-css"||p.startsWith("@salty-css/"));return u.length?u:t.logError("No Salty-CSS packages found in package.json. Make sure you are running update command in the same directory! Used package.json path: "+i)};y.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).",!1).action(async function(i="latest"){const{legacyPeerDeps:a,version:l=i}=this.opts(),u=await K();if(!u)return t.logError("Could not update Salty-CSS packages as any were found in package.json.");const p=u.map(([m])=>l==="@"?`${m}@${$.version}`:`${m}@${l.replace(/^@/,"")}`);a?(t.logger.warn("Using legacy peer dependencies to update packages."),await I(...p,"--legacy-peer-deps")):await I(...p);const f=await K();if(!f)return t.logError("Something went wrong while reading the updated packages.");const r=f.reduce((m,[w,h])=>(m[h]||(m[h]=[]),m[h].push(w),m),{});if(Object.keys(r).length===1){const w=Object.keys(r)[0].replace(/^\^/,"");t.logger.info(`Updated to all Salty CSS packages successfully to ${w}`)}else for(const[m,w]of Object.entries(r)){const h=m.replace(/^\^/,"");t.logger.info(`Updated to ${h}: ${w.join(", ")}`)}}),y.option("-v, --version","Show the current version of Salty-CSS.").action(async function(){const i=await B();t.logger.info("CLI is running: "+i.version);const a=n.join(process.cwd(),"package.json"),l=await N(a).catch(f=>t.logError(f));if(!l)return;const u={...l.dependencies,...l.devDependencies},p=Object.keys(u).filter(f=>f==="salty-css"||f.startsWith("@salty-css/"));if(!p.length)return t.logError("No Salty-CSS packages found in package.json. Make sure you are running update command in the same directory! Used package.json path: "+a);for(const f of p)t.logger.info(`${f}: ${u[f]}`)}),y.parseAsync(process.argv)}exports.main=re;

package/bin/main.d.ts

@@ -0,0 +1 @@
+export declare function main(): Promise<void>;

package/bin/main.js

@@ -0,0 +1,260 @@
+import { Command as oe } from "commander";
+import { existsSync as K } from "fs";
+import { mkdir as q, readFile as C, writeFile as w } from "fs/promises";
+import { join as i, relative as z, parse as re, format as ee } from "path";
+import { render as ce } from "ejs";
+import { l as t, a as h, g as te } from "../index-BKt0qRhM.js";
+import { p as le } from "../pascal-case-BQpR5PdN.js";
+import { exec as de } from "child_process";
+import fe from "ora";
+const ne = (g) => new Promise((P, x) => {
+  de(g, (F) => {
+    if (F) return x(F);
+    P();
+  });
+}), E = async (...g) => {
+  const P = g.map((J) => J.replace("-D", "").split("@").slice(0, -1).join("@").trim()).join(", "), x = fe(`Installing packages: ${P}`).start(), F = g.join(" ");
+  await ne(`npm install ${F}`), x.succeed(`Installed packages: ${P}`);
+}, pe = () => K(i(process.cwd(), "node_modules", ".bin", "prettier"));
+async function j(g) {
+  try {
+    if (!pe()) return;
+    await ne(`./node_modules/.bin/prettier --write "${g}"`), t.info(`Formatted ${g} with Prettier`);
+  } catch (P) {
+    t.error(`Error formatting ${g} with Prettier:`, P);
+  }
+}
+async function xe() {
+  const g = new oe();
+  g.name("salty-css").description("Salty-CSS CLI tool to help with annoying configuration tasks.");
+  const P = {
+    // Core files
+    "salty.config.ts": import("../salty.config-BhBY_oOk.js"),
+    "saltygen/index.css": import("../index-D_732b92.js"),
+    // React
+    "react/react-styled-file.ts": import("../react-styled-file-CGVf5n1B.js"),
+    "react/react-vanilla-file.ts": import("../react-vanilla-file-CCXbsjIb.js")
+  }, x = async (n, a) => {
+    const { default: c } = await P[n], u = ce(c, a);
+    return { fileName: n, content: u };
+  }, F = async () => {
+    const n = i(process.cwd(), ".saltyrc.json");
+    return await C(n, "utf-8").then(JSON.parse).catch(() => ({}));
+  }, J = i(process.cwd(), "package.json"), O = async (n = J) => {
+    const a = await C(n, "utf-8").then(JSON.parse).catch(() => {
+    });
+    if (!a) throw "Could not read package.json file!";
+    return a;
+  }, se = async (n, a = J) => {
+    typeof n == "object" && (n = JSON.stringify(n, null, 2)), await w(a, n);
+  }, Q = async () => {
+    const n = new URL("../package.json", import.meta.url);
+    return O(n);
+  }, X = await (async () => (await F()).defaultProject)(), N = await Q(), A = {
+    core: `@salty-css/core@${N.version}`,
+    react: `@salty-css/react@${N.version}`,
+    eslintConfigCore: `@salty-css/eslint-config-core@${N.version}`,
+    vite: `@salty-css/vite@${N.version}`,
+    next: `@salty-css/next@${N.version}`
+  }, G = (n) => {
+    const a = n === "." ? "" : n, c = process.cwd();
+    return i(c, a);
+  };
+  g.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(n = ".") {
+    if (!await O().catch(() => {
+    })) return h("Salty CSS project must be initialized in a directory with a package.json file.");
+    t.info("Initializing a new Salty-CSS project!");
+    const { dir: c = n, cssFile: u, skipInstall: p } = this.opts();
+    if (!c) return h("Project directory must be provided. Add it as the first argument after init command or use the --dir option.");
+    p || await E(A.core, A.react);
+    const d = process.cwd(), o = G(c), H = await Promise.all([x("salty.config.ts"), x("saltygen/index.css")]);
+    await q(o, { recursive: !0 });
+    const y = H.map(async ({ fileName: e, content: f }) => {
+      const r = i(o, e);
+      if (await C(r, "utf-8").catch(() => {
+      }) !== void 0) {
+        t.debug("File already exists: " + r);
+        return;
+      }
+      const b = e.split("/").slice(0, -1).join("/");
+      b && await q(i(o, b), { recursive: !0 }), t.info("Creating file: " + r), await w(r, f), await j(r);
+    });
+    await Promise.all(y);
+    const S = z(d, o) || ".", m = i(d, ".saltyrc.json"), l = await C(m, "utf-8").catch(() => {
+    });
+    if (l === void 0) {
+      t.info("Creating file: " + m);
+      const f = JSON.stringify({
+        $schema: "./node_modules/@salty-css/core/.saltyrc.schema.json",
+        info: "This file is used to define projects and their configurations for Salty CSS cli. Do not delete, modify or add this file to .gitignore.",
+        defaultProject: S,
+        projects: [
+          {
+            dir: S,
+            framework: "react"
+          }
+        ]
+      }, null, 2);
+      await w(m, f), await j(m);
+    } else {
+      const e = JSON.parse(l), f = (e == null ? void 0 : e.projects) || [];
+      if (f.findIndex((s) => s.dir === S) === -1) {
+        f.push({ dir: S, framework: "react" }), e.projects = [...f];
+        const s = JSON.stringify(e, null, 2);
+        s !== l && (t.info("Edit file: " + m), await w(m, s), await j(m));
+      }
+    }
+    const k = i(d, ".gitignore"), U = await C(k, "utf-8").catch(() => {
+    });
+    U !== void 0 && (U.includes("saltygen") || (t.info("Edit file: " + k), await w(k, U + `
+
+# Salty-CSS
+saltygen
+`)));
+    const $ = ["src", "public", "assets", "styles", "css", "app"], M = ["styles", "css", "app", "pages"], B = ["index", "styles", "main", "global", "globals"], R = [".css", ".scss", ".sass"], D = await (async () => {
+      if (u) return u;
+      for (const e of $)
+        for (const f of B)
+          for (const r of R) {
+            const s = i(o, e, f + r);
+            if (await C(s, "utf-8").catch(() => {
+            }) !== void 0) return z(o, s);
+            for (const T of M) {
+              const L = i(o, e, T, f + r);
+              if (await C(L, "utf-8").catch(() => {
+              }) !== void 0) return z(o, L);
+            }
+          }
+    })();
+    if (D) {
+      const e = i(o, D), f = await C(e, "utf-8").catch(() => {
+      });
+      if (f !== void 0 && !f.includes("saltygen")) {
+        const s = i(e, ".."), T = `@import '${z(s, i(o, "saltygen/index.css"))}';`;
+        t.info("Adding global import statement to CSS file: " + e), await w(e, T + `
+` + f), await j(e);
+      }
+    } else
+      t.warn("Could not find a CSS file to import the generated CSS. Please add it manually.");
+    const ie = {
+      projectJs: i(o, "eslint.config.js"),
+      rootJs: i(d, "eslint.config.js"),
+      projectMjs: i(o, "eslint.config.mjs"),
+      rootMjs: i(d, "eslint.config.mjs"),
+      projectJson: i(o, ".eslintrc.json"),
+      rootJson: i(d, ".eslintrc.json")
+    }, v = Object.values(ie).find((e) => K(e));
+    if (v) {
+      p || await E(A.eslintConfigCore);
+      const e = await C(v, "utf-8").catch(() => {
+      });
+      if (!e) return h("Could not read ESLint config file.");
+      if (!e.includes("salty-css"))
+        if (t.info("Edit file: " + v), v.endsWith("js")) {
+          let s = `import saltyCss from "@salty-css/eslint-config-core/flat";
+${e}`;
+          e.includes("typescript-eslint") ? s.includes(".config(") ? s = s.replace(".config(", ".config(saltyCss,") : t.warn("Could not find the correct place to add the Salty-CSS config for ESLint. Please add it manually.") : s.includes("export default [") ? s = s.replace("export default [", "export default [ saltyCss,") : s.includes("eslintConfig = [") ? s = s.replace("eslintConfig = [", "eslintConfig = [ saltyCss,") : t.warn("Could not find the correct place to add the Salty-CSS config for ESLint. Please add it manually."), await w(v, s), await j(v);
+        } else {
+          const r = JSON.parse(e);
+          r.extends || (r.extends = []), r.extends.push("@salty-css/core");
+          const s = JSON.stringify(r, null, 2);
+          await w(v, s), await j(v);
+        }
+    }
+    const _ = i(o, "vite.config.ts"), V = await C(_, "utf-8").catch(() => {
+    });
+    if (V !== void 0 && !V.includes("saltyPlugin")) {
+      t.info("Edit file: " + _);
+      const f = `import { saltyPlugin } from '@salty-css/vite';
+`, s = V.replace(/(plugins: \[)/, `$1
+  saltyPlugin(__dirname),`);
+      p || await E(`-D ${A.vite}`), t.info("Adding Salty-CSS plugin to Vite config..."), await w(_, f + s), await j(_);
+    }
+    const W = ["next.config.js", "next.config.cjs", "next.config.ts", "next.config.mjs"].map((e) => i(o, e)).find((e) => K(e));
+    if (W) {
+      let e = await C(W, "utf-8").catch(() => {
+      });
+      if (e !== void 0 && !e.includes("withSaltyCss")) {
+        let r = !1;
+        /\splugins([^=]*)=[^[]\[/.test(e) && !r && (e = e.replace(/\splugins([^=]*)=[^[]\[/, (L, I) => ` plugins${I}= [withSaltyCss,`), r = !0);
+        const b = e.includes("module.exports"), T = b ? `const { withSaltyCss } = require('@salty-css/next');
+` : `import { withSaltyCss } from '@salty-css/next';
+`;
+        b && !r ? (e = e.replace(/module.exports = ([^;]+)/, (L, I) => `module.exports = withSaltyCss(${I})`), r = !0) : r || (e = e.replace(/export default ([^;]+)/, (L, I) => `export default withSaltyCss(${I})`)), p || await E(`-D ${A.next}`), t.info("Adding Salty-CSS plugin to Next.js config..."), await w(W, T + e), await j(W);
+      }
+    }
+    const ae = await O().catch(() => h("Could not read package.json file.")).then((e) => (e.scripts || (e.scripts = {}), e.scripts.prepare ? e.scripts.prepare.includes("salty-css") || (t.info("Edit file: " + J), e.scripts.prepare = e.scripts.prepare + " && npx salty-css build") : (t.info("Edit file: " + J), e.scripts.prepare = "npx salty-css build"), e));
+    await se(ae), t.info("Running the build to generate initial CSS..."), await te(o), t.info("🎉 Salty CSS project initialized successfully!"), t.info("Next steps:"), t.info("1. Configure variables and templates in `salty.config.ts`"), t.info("2. Create a new component with `npx salty-css generate [component-name]`"), t.info("3. Run `npx salty-css build` to generate the CSS"), t.info("4. Read about the features in the documentation: https://salty-css.dev"), t.info("5. Star the project on GitHub: https://github.com/margarita-form/salty-css ⭐");
+  }), g.command("build [directory]").alias("b").description("Build the Salty-CSS project.").option("-d, --dir <dir>", "Project directory to build the project in.").action(async function(n = X) {
+    t.info("Building the Salty-CSS project...");
+    const { dir: a = n } = this.opts();
+    if (!a) return h("Project directory must be provided. Add it as the first argument after build command or use the --dir option.");
+    const c = G(a);
+    await te(c);
+  }), g.command("generate [file] [directory]").alias("g").description("Generate a new component file.").option("-f, --file <file>", "File to generate.").option("-d, --dir <dir>", "Project directory to generate the file in.").option("-t, --tag <tag>", "HTML tag of the component.", "div").option("-n, --name <name>", "Name of the component.").option("-c, --className <className>", "CSS class of the component.").option("-r, --reactComponent", "Generate a React component as well.").action(async function(n, a = X) {
+    const { file: c = n, dir: u = a, tag: p, name: d, className: o, reactComponent: H = !1 } = this.opts();
+    if (!c) return h("File to generate must be provided. Add it as the first argument after generate command or use the --file option.");
+    if (!u) return h("Project directory must be provided. Add it as the second argument after generate command or use the --dir option.");
+    const y = G(u), S = c.split("/").slice(0, -1).join("/");
+    S && await q(i(y, S), { recursive: !0 });
+    const m = i(y, c), l = re(m);
+    l.ext || (l.ext = ".ts"), l.name.endsWith(".css") || (l.name = l.name + ".css"), l.base = l.name + l.ext;
+    const k = ee(l);
+    if (await C(k, "utf-8").catch(() => {
+    }) !== void 0) {
+      t.error("File already exists:", k);
+      return;
+    }
+    let $ = le(d || l.base.replace(/\.css\.\w+$/, ""));
+    if (H) {
+      const B = $ + "Component";
+      $ = $ + "Wrapper";
+      const R = l.base.replace(/\.css\.\w+$/, ""), { content: Z } = await x("react/react-vanilla-file.ts", { tag: p, componentName: B, styledComponentName: $, className: o, fileName: R });
+      l.name = R.replace(/\.css$/, ""), l.ext = ".tsx", l.base = l.name + l.ext;
+      const D = ee(l);
+      t.info("Generating a new file: " + D), await w(D, Z), await j(D);
+    }
+    const { content: M } = await x("react/react-styled-file.ts", { tag: p, name: $, className: o });
+    t.info("Generating a new file: " + k), await w(k, M), await j(k);
+  });
+  const Y = async () => {
+    const n = i(process.cwd(), "package.json"), a = await O(n).catch((p) => h(p));
+    if (!a) return h("Could not read package.json file.");
+    const c = { ...a.dependencies, ...a.devDependencies }, u = Object.entries(c).filter(([p]) => p === "salty-css" || p.startsWith("@salty-css/"));
+    return u.length ? u : h(
+      "No Salty-CSS packages found in package.json. Make sure you are running update command in the same directory! Used package.json path: " + n
+    );
+  };
+  g.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).", !1).action(async function(n = "latest") {
+    const { legacyPeerDeps: a, version: c = n } = this.opts(), u = await Y();
+    if (!u) return h("Could not update Salty-CSS packages as any were found in package.json.");
+    const p = u.map(([y]) => c === "@" ? `${y}@${N.version}` : `${y}@${c.replace(/^@/, "")}`);
+    a ? (t.warn("Using legacy peer dependencies to update packages."), await E(...p, "--legacy-peer-deps")) : await E(...p);
+    const d = await Y();
+    if (!d) return h("Something went wrong while reading the updated packages.");
+    const o = d.reduce((y, [S, m]) => (y[m] || (y[m] = []), y[m].push(S), y), {});
+    if (Object.keys(o).length === 1) {
+      const S = Object.keys(o)[0].replace(/^\^/, "");
+      t.info(`Updated to all Salty CSS packages successfully to ${S}`);
+    } else
+      for (const [y, S] of Object.entries(o)) {
+        const m = y.replace(/^\^/, "");
+        t.info(`Updated to ${m}: ${S.join(", ")}`);
+      }
+  }), g.option("-v, --version", "Show the current version of Salty-CSS.").action(async function() {
+    const n = await Q();
+    t.info("CLI is running: " + n.version);
+    const a = i(process.cwd(), "package.json"), c = await O(a).catch((d) => h(d));
+    if (!c) return;
+    const u = { ...c.dependencies, ...c.devDependencies }, p = Object.keys(u).filter((d) => d === "salty-css" || d.startsWith("@salty-css/"));
+    if (!p.length)
+      return h(
+        "No Salty-CSS packages found in package.json. Make sure you are running update command in the same directory! Used package.json path: " + a
+      );
+    for (const d of p)
+      t.info(`${d}: ${u[d]}`);
+  }), g.parseAsync(process.argv);
+}
+export {
+  xe as main
+};

package/bin/prettier.d.ts

@@ -0,0 +1 @@
+export declare function formatWithPrettier(filePath: string): Promise<void>;

package/compiler/get-files.d.ts

@@ -0,0 +1,3 @@
+export declare const getSaltyRcPath: (dirname: string) => string;
+export declare const getPackageJsonPath: (dirname: string) => string;
+export declare const getPackageJson: (dirname: string) => Promise<any>;

package/compiler/index.cjs

@@ -1,11 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const K=require("esbuild"),J=require("winston"),G=require("child_process"),N=require("../util/index.cjs"),o=require("path"),r=require("fs"),L=require("fs/promises"),_=require("../parse-templates-BY1Xai-_.cjs");function q(t){const s=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(t){for(const n in t)if(n!=="default"){const e=Object.getOwnPropertyDescriptor(t,n);Object.defineProperty(s,n,e.get?e:{enumerable:!0,get:()=>t[n]})}}return s.default=t,Object.freeze(s)}const R=q(K),k=q(J),A=k.createLogger({level:"info",format:k.format.combine(k.format.colorize(),k.format.cli()),transports:[new k.transports.Console({})]}),v=t=>o.join(t,"./saltygen"),M=["salty","css","styles","styled"],z=(t=[])=>new RegExp(`\\.(${[...M,...t].join("|")})\\.`),T=(t,s=[])=>z(s).test(t),U=async t=>{const s=v(t),n=o.join(t,"salty-config.ts"),e=o.join(s,"salty-config.js");await R.build({entryPoints:[n],minify:!0,treeShaking:!0,bundle:!0,outfile:e,format:"esm",external:["react"]});const a=Date.now(),{config:h}=await import(`${e}?t=${a}`);return h},H=async t=>{const s=await U(t),n=new Set,e=(f,p=[])=>f?Object.entries(f).flatMap(([y,c])=>{if(!c)return;if(typeof c=="object")return e(c,[...p,y]);const x=[...p,y].join(".");n.add(`"${x}"`);const D=[...p.map(N.dashCase),N.dashCase(y)].join("-"),{result:P}=_.parseValueTokens(c);return`--${D}: ${P};`}):[],a=f=>f?Object.entries(f).flatMap(([p,y])=>{const c=e(y);return p==="base"?c.join(""):`${p} { ${c.join("")} }`}):[],h=f=>f?Object.entries(f).flatMap(([p,y])=>Object.entries(y).flatMap(([c,x])=>{const D=e(x,[p]),P=`.${p}-${c}, [data-${p}="${c}"]`,O=D.join("");return`${P} { ${O} }`})):[],b=e(s.variables),w=a(s.responsiveVariables),l=h(s.conditionalVariables),j=v(t),u=o.join(j,"css/variables.css"),i=`:root { ${b.join("")} ${w.join("")} } ${l.join("")}`;r.writeFileSync(u,i);const g=o.join(j,"types/css-tokens.d.ts"),d=`type VariableTokens = ${[...n].join("|")}; type PropertyValueToken = \`{\${VariableTokens}}\``;r.writeFileSync(g,d);const m=o.join(j,"css/global.css"),S=_.parseStyles(s.global,"");r.writeFileSync(m,S);const F=o.join(j,"css/templates.css"),C=_.parseTemplates(s.templates);r.writeFileSync(F,C)},V=async(t,s)=>{const n=N.toHash(t),e=o.join(s,"js",n+".js");await R.build({entryPoints:[t],minify:!0,treeShaking:!0,bundle:!0,outfile:e,format:"esm",target:["es2022"],keepNames:!0,external:["react"]});const a=Date.now();return await import(`${e}?t=${a}`)},E=async t=>{const s=v(t),n=o.join(s,"salty-config.js"),{config:e}=await import(n);return e},W=async t=>{try{const s=[],n=[],e=v(t),a=o.join(e,"index.css");(()=>{r.existsSync(e)&&G.execSync("rm -rf "+e),r.mkdirSync(e),r.mkdirSync(o.join(e,"css")),r.mkdirSync(o.join(e,"types"))})(),await H(t);const b=await E(t);async function w(i,g){const $=r.statSync(i);if($.isDirectory()){const d=r.readdirSync(i);await Promise.all(d.map(m=>w(o.join(i,m),o.join(g,m))))}else if($.isFile()&&T(i)){const m=await V(i,e),S=[];Object.entries(m).forEach(([p,y])=>{if(y.isKeyframes&&y.css){const O=`${y.animationName}.css`,I=`css/${O}`,B=o.join(e,I);s.push(O),r.writeFileSync(B,y.css);return}if(!y.generator)return;const c=y.generator._withBuildContext({name:p,config:b}),x=`${c.hash}-${c.priority}.css`;n[c.priority]||(n[c.priority]=[]),n[c.priority].push(x),S.push(x);const D=`css/${x}`,P=o.join(e,D);r.writeFileSync(P,c.css)});const F=S.map(p=>`@import url('./${p}');`).join(`
-`),C=N.toHash(i,6),f=o.join(e,`css/${C}.css`);r.writeFileSync(f,F)}}await w(t,e);const l=s.map(i=>`@import url('./css/${i}');`).join(`
-`);let u=`@layer l0, l1, l2, l3, l4, l5, l6, l7, l8;
-
-${["@import url('./css/variables.css');","@import url('./css/global.css');","@import url('./css/templates.css');"].join(`
-`)}
-${l}`;if(b.importStrategy!=="component"){const i=n.flat().map(g=>`@import url('./css/${g}');`).join(`
-`);u+=i}r.writeFileSync(a,u)}catch(s){console.error(s)}},X=async(t,s)=>{try{const n=[],e=o.join(t,"./saltygen"),a=o.join(e,"index.css");if(T(s)){const b=await E(t),w=await V(s,e);Object.entries(w).forEach(([g,$])=>{if(!$.generator)return;const d=$.generator._withBuildContext({name:g,config:b}),m=`${d.hash}-${d.priority}.css`,S=`css/${m}`,F=o.join(e,S);n.push(m),r.writeFileSync(F,d.css)});const l=r.readFileSync(a,"utf8").split(`
-`),j=n.map(g=>`@import url('../saltygen/css/${g}');`),i=[...new Set([...l,...j])].join(`
-`);r.writeFileSync(a,i)}}catch(n){console.error(n)}},Y=async(t,s)=>{try{const n=o.join(t,"./saltygen");if(T(s)){let a=r.readFileSync(s,"utf8");a.replace(/^(?!export\s)const\s.*/gm,u=>`export ${u}`)!==a&&await L.writeFile(s,a);const b=await E(t),w=await V(s,n);let l=a;Object.entries(w).forEach(([u,i])=>{var f;if(i.isKeyframes){console.log("value",i);return}if(!i.generator)return;const g=i.generator._withBuildContext({name:u,config:b}),$=new RegExp(`${u}[=\\s]+[^()]+styled\\(([^,]+),`,"g").exec(a);if(!$)return console.error("Could not find the original declaration");const d=(f=$.at(1))==null?void 0:f.trim(),{element:m,variantKeys:S}=g.props,F=`${u} = styled(${d}, "${g.classNames}", "${g._callerName}", ${JSON.stringify(m)}, ${JSON.stringify(S)});`,C=new RegExp(`${u}[=\\s]+[^()]+styled\\(([^,]+),[^;]+;`,"g");l=l.replace(C,F)});const j=N.toHash(s,6);return b.importStrategy==="component"&&(l=`import '../../saltygen/css/${j}.css';
-${l}`),l=l.replace("{ styled }","{ styledClient as styled }"),l=l.replace("@salty-css/react/styled","@salty-css/react/styled-client"),l}}catch(n){console.error(n)}};exports.compileSaltyFile=V;exports.generateCss=W;exports.generateFile=X;exports.generateVariables=H;exports.isSaltyFile=T;exports.logger=A;exports.minimizeFile=Y;exports.saltyFileExtensions=M;exports.saltyFileRegExp=z;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("esbuild");require("child_process");require("../dash-case-BJEkFEGQ.cjs");require("path");require("fs");require("fs/promises");require("../parse-templates-DIOn-gO_.cjs");const e=require("../index-mhoDzsNb.cjs");exports.compileSaltyFile=e.compileSaltyFile;exports.generateConfigStyles=e.generateConfigStyles;exports.generateCss=e.generateCss;exports.generateFile=e.generateFile;exports.isSaltyFile=e.isSaltyFile;exports.minimizeFile=e.minimizeFile;exports.saltyFileExtensions=e.saltyFileExtensions;exports.saltyFileRegExp=e.saltyFileRegExp;

package/compiler/index.d.ts

@@ -1,11 +1,9 @@
 import { StyleComponentGenerator } from '../generator/style-generator';
-import * as winston from 'winston';
-export declare const logger: winston.Logger;
 export declare const saltyFileExtensions: string[];
 export declare const saltyFileRegExp: (additional?: string[]) => RegExp;
 export declare const isSaltyFile: (file: string, additional?: string[]) => boolean;
-export declare const generateVariables: (dirname: string) => Promise<void>;
-export declare const compileSaltyFile: (sourceFilePath: string, outputDirectory: string) => Promise<{
+export declare const generateConfigStyles: (dirname: string) => Promise<void>;
+export declare const compileSaltyFile: (dirname: string, sourceFilePath: string, outputDirectory: string) => Promise<{
     [key: string]: {
         generator: StyleComponentGenerator;
         isKeyframes?: boolean;
@@ -13,6 +11,6 @@ export declare const compileSaltyFile: (sourceFilePath: string, outputDirectory:
         css?: string;
     };
 }>;
-export declare const generateCss: (dirname: string) => Promise<void>;
+export declare const generateCss: (dirname: string, prod?: boolean) => Promise<void>;
 export declare const generateFile: (dirname: string, file: string) => Promise<void>;
-export declare const minimizeFile: (dirname: string, file: string) => Promise<string | undefined>;
+export declare const minimizeFile: (dirname: string, file: string, prod?: boolean) => Promise<string | undefined>;