@salty-css/core 0.0.1-alpha.2 → 0.0.1-alpha.200

package/.saltyrc.schema.json

@@ -0,0 +1,48 @@
+{
+  "$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 root 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, relative to the project root."
+          },
+          "configDir": {
+            "type": "string",
+            "description": "Dir3ectorywhere the project configuration file is located, relative to the project root."
+          },
+          "saltygenDir": {
+            "type": "string",
+            "description": "Directory where the salty css files will be generated to, relative to the project root."
+          }
+        },
+        "required": ["dir", "framework"]
+      }
+    }
+  },
+  "required": ["defaultProject", "projects"]
+}

package/README.md

@@ -1,15 +1,132 @@
-# Salty Css
+![Salty CSS Banner](https://salty-css.dev/assets/banners/dvd.svg)
 
-## Basic usage example with Button
+# Salty CSS - CSS-in-JS library that is kinda sweet
 
-### Initial requirements
+Is there anything saltier than CSS in frontend web development? Salty CSS is built to provide better developer experience for developers looking for performant and feature rich CSS-in-JS solutions.
 
-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`
+## Features
 
-### Code examples
+- 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
+
+## Get started
+
+Fastest way to get started with any framework is `npx salty-css init [directory]` command
+
+- Next.js → [Next.js guide](#nextjs) + [Next.js example app](https://github.com/margarita-form/salty-css-website)
+- React + Vite → [React + Vite guide](#react--vite) + [React example code](#code-examples)
+- React + Webpack → Guide coming soon
+
+## Useful commands
+
+- Create component: `npx salty-css generate [filePath]`
+- Build: `npx salty-css build [directory]`
+- Update Salty CSS packages: `npx salty-css up`
+
+## Salty CSS styled function
+
+```ts
+// components/wrapper.css.ts
+import { styled } from '@salty-css/react/styled';
+
+// Define a component with styled function. First argument is the component name or existing component to extend and second argument is the object containing the styles and other options
+export const Component = styled('div', {
+  className: 'wrapper', // Define custom class name that will be included for this component
+  element: 'section', // Define the html element that will be rendered for this component, overrides the first 'div' argument
+  base: {
+    // 👉 Add your CSS-in-JS base styles here! 👈
+  },
+  variants: {
+    // Define conditional styles that will be applied to the component based on the variant prop values
+  },
+  compoundVariants: [
+    // Define conditional styles that will be applied to the component based on the combination of variant prop values
+  ],
+  defaultVariants: {
+    // Set default variant prop values
+  },
+  defaultProps: {
+    // Add additional default props for the component (eg, id and other html element attributes)
+  },
+  passProps: true, // Pass variant props to the rendered element / parent component (default: false)
+});
+```
+
+## 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
+
+## Usage
+
+### Next.js
+
+![salty-next](https://github.com/user-attachments/assets/2cf6a93f-cdd5-4f5f-ab2e-3bc8bcfb83e8)
+
+Salty CSS provides Next.js App & Pages router support with full React Server Components support.
+
+### Add Salty CSS to Next.js
+
+1. In your existing Next.js repository you can run `npx salty-css init` to automatically configure Salty CSS.
+2. Create your first Salty CSS component with `npx salty-css generate [filePath]` (e.g. src/custom-wrapper)
+3. Import your component for example to `page.tsx` and see it working!
+
+And note: steps 2 & 3 are just to show how get new components up and running, step 1 does all of the important stuff 🤯
+
+#### 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)
+
+---
+
+### React + Vite
+
+![salty-vite-react](https://github.com/user-attachments/assets/12ec5b6a-0dcc-48fa-afc1-d337fc8f800c)
+
+### Add Salty CSS to your React + Vite app
+
+1. In your existing Vite repository you can run `npx salty-css init` to automatically configure Salty CSS.
+2. Create your first Salty CSS component with `npx salty-css generate [filePath]` (e.g. src/custom-wrapper)
+3. Import your component for example to `main.tsx` and see it working!
+
+And note: steps 2 & 3 are just to show how get new components up and running, step 1 does all of the important stuff 🤯
+
+#### 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';`.
+
+[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,31 +148,16 @@ 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
 import { styled } from '@salty-css/react/styled';
 
 export const Wrapper = styled('div', {
-  display: 'block',
-  padding: '2vw',
+  base: {
+    display: 'block',
+    padding: '2vw',
+  },
 });
 ```
 
@@ -65,22 +167,24 @@ export const Wrapper = styled('div', {
 import { styled } from '@salty-css/react/styled';
 
 export const Button = styled('button', {
-  display: 'block',
-  padding: `0.6em 1.2em`,
-  border: '1px solid currentColor',
-  background: 'transparent',
-  color: 'currentColor/40',
-  cursor: 'pointer',
-  transition: '200ms',
-  textDecoration: 'none',
-  '&:hover': {
-    background: 'black',
-    borderColor: 'black',
-    color: 'white',
-  },
-  '&:disabled': {
-    opacity: 0.25,
-    pointerEvents: 'none',
+  base: {
+    display: 'block',
+    padding: `0.6em 1.2em`,
+    border: '1px solid currentColor',
+    background: 'transparent',
+    color: 'currentColor',
+    cursor: 'pointer',
+    transition: '200ms',
+    textDecoration: 'none',
+    '&:hover': {
+      background: 'black',
+      borderColor: 'black',
+      color: 'white',
+    },
+    '&:disabled': {
+      opacity: 0.25,
+      pointerEvents: 'none',
+    },
   },
   variants: {
     variant: {
@@ -104,4 +208,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-CHz91O9z.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","app","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-BM4snbAi.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", "app", "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

@@ -0,0 +1 @@
+"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-styles-D_gL6efj.cjs");const e=require("../index-CHz91O9z.cjs");require("../css/merge.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

@@ -0,0 +1,21 @@
+export declare const saltyFileExtensions: string[];
+export declare const saltyFileRegExp: (additional?: string[]) => RegExp;
+export declare const isSaltyFile: (file: string, additional?: string[]) => boolean;
+export declare const generateConfigStyles: (dirname: string, configFiles: Set<string>) => Promise<void>;
+export declare const compileSaltyFile: (dirname: string, sourceFilePath: string, outputDirectory: string) => Promise<{
+    [key: string]: {
+        generator: any;
+        isClassName?: boolean;
+        isMedia?: boolean;
+        isGlobalDefine?: boolean;
+        isDefineVariables?: boolean;
+        isDefineTemplates?: boolean;
+        isKeyframes?: boolean;
+        animationName?: string;
+        css?: string;
+        styles?: any;
+    };
+}>;
+export declare const generateCss: (dirname: string, prod?: boolean, clean?: boolean) => Promise<void>;
+export declare const generateFile: (dirname: string, file: string) => Promise<void>;
+export declare const minimizeFile: (dirname: string, file: string, prod?: boolean) => Promise<string | undefined>;