@salty-css/eslint-plugin-core 0.0.1-alpha.100

package/README.md

@@ -0,0 +1,186 @@
+# Salty CSS - Kinda sweet but yet spicy CSS-in-JS library
+
+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.
+
+## Features
+
+- 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
+
+- Initialize: `npx salty-css init [directory]`
+- Create component: `npx salty-css generate [filePath]`
+- Build: `npx salty-css build [directory]`
+
+### Packages
+
+Note: Fastest way to get started with any framework is [npx salty-css init [directory]](#initialize-salty-css-for-a-project) command
+
+- [Next.js](#nextjs) → `npm install @salty-css/next` + [Next.js install guide](#nextjs) + [Next.js example app](https://github.com/margarita-form/salty-css-website)
+- [React](#react) → `npm install @salty-css/react` + [React install guide](#react) + [React example code](#code-examples)
+- [Vite](#vite) → `npm install @salty-css/vite` + [(Vite install guide)](#vite)
+- [Webpack](https://www.npmjs.com/package/@salty-css/webpack) → `npm install @salty-css/webpack` + Guide coming soon
+- [ESLint](https://www.npmjs.com/package/@salty-css/eslint-plugin-core) → `npm install @salty-css/eslint-plugin-core` + Guide coming soon
+- [Core](https://www.npmjs.com/package/@salty-css/react) → `npm install @salty-css/core` (This package contains code for internal use)
+
+### Add Salty CSS to your project with `salty-css` CLI
+
+#### Initialize Salty CSS for a project
+
+In your existing repository run `npx salty-css init [directory]` which installs required salty-css packages to the current directory, detects framework in use (current support for vite and next.js) and creates project files to the provided directory. Directory can be left blank if you want files to be created to the current directory. Init will also create `.saltyrc.json` which contains some metadata for future CLI commands.
+
+#### Create components
+
+Components can be created with `npx salty-css generate [filePath]` which then creates a new Salty CSS component file to the specified path. Additional options like `--dir, --tag, --name and --className` are also supported. Read more about them with `npx salty-css generate --help`
+
+#### Build / Compile Salty CSS
+
+If you want to manually build your project that can be done by running `npx salty-css build [directory]`. Directory is not required as CLI can use default directory defined in `.saltyrc.json`. Note that build generates css files but Vite / Webpack plugin is still required for full support.
+
+#### Update Salty CSS packages
+
+To ease the pain of package updates all Salty CSS packages can be updated with `npx salty-css update`
+
+### Manual work
+
+#### Next.js
+
+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
+
+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)
+
+[Check out react example code](#code-examples)
+
+#### Vite
+
+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';`.
+
+### 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**
+
+```tsx
+import { defineConfig } from '@salty-css/core/config';
+
+export const config = defineConfig({
+  variables: {
+    colors: {
+      brand: '#111',
+      highlight: 'yellow',
+    },
+  },
+  global: {
+    html: {
+      backgroundColor: '#f8f8f8',
+    },
+  },
+});
+```
+
+**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', {
+  base: {
+    display: 'block',
+    padding: '2vw',
+  },
+});
+```
+
+**Button** (`components/button/button.css.ts`)
+
+```tsx
+import { styled } from '@salty-css/react/styled';
+
+export const Button = styled('button', {
+  base: {
+    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',
+    },
+  },
+  variants: {
+    variant: {
+      outlined: {
+        // same as default styles
+      },
+      solid: {
+        '&:not(:hover)': {
+          background: 'black',
+          borderColor: 'black',
+          color: 'white',
+        },
+        '&:hover': {
+          background: 'transparent',
+          borderColor: 'currentColor',
+          color: 'currentColor',
+        },
+      },
+    },
+  },
+});
+```
+
+More examples coming soon

package/index.cjs

@@ -0,0 +1 @@
+"use strict";require("esbuild");require("child_process");require("path");require("fs");require("fs/promises");const o=require("winston");o.createLogger({level:"debug",format:o.format.combine(o.format.colorize(),o.format.cli()),transports:[new o.transports.Console({})]});const h=["salty","css","styles","styled"],P=(r=[])=>new RegExp(`\\.(${[...h,...r].join("|")})\\.`),x=(r,l=[])=>P(l).test(r),S={meta:{type:"problem",fixable:"code",docs:{description:"Ensure `variants` are not nested inside `base` in styled calls",category:"Errors",recommended:!0},messages:{nestedVariants:"`variants` should not be nested inside `base`."}},create(r){return x(r.filename)?{CallExpression:c=>{try{const{callee:i,arguments:e}=c;if(!(i.type==="Identifier"&&i.name==="styled"))return;const t=e[1];if(!t||!(t.type==="ObjectExpression"))return;const u=t.properties.find(s=>s.type==="Property"&&s.key.type==="Identifier"&&s.key.name==="base");if(!u)return;const{value:f}=u;if(!(f.type==="ObjectExpression"))return;const n=f.properties.find(s=>s.type==="Property"&&s.key.type==="Identifier"&&s.key.name==="variants");if(!n)return;r.report({node:n,messageId:"nestedVariants",fix:s=>{if(!n.range)return null;const{sourceCode:d}=r,b=d.getText(n),E=t.properties.indexOf(u),p=t.properties[E];if(!p.range)return null;const v=[p.range[1],p.range[1]],m=[n.range[0]-1,n.range[1]];if(f.properties.at(-1)===n){const g=d.text.slice(n.range[1]).match(/^\s*,/);g&&(m[1]+=g[0].length)}return[s.removeRange(m),s.insertTextAfterRange(v,`, ${b}`)]}})}catch(i){console.log("ESlint error",i);return}}}:{}}},I={meta:{type:"problem",fixable:"code",docs:{description:"Salty CSS related function calls or other values must be exported",category:"Errors",recommended:!0},messages:{mustBeExported:"Salty CSS related function calls or other values must be exported"}},create(r){if(!x(r.filename))return{};function c(e){if(e.type==="VariableDeclaration"){const a=e.declarations[0];if(a.type!=="VariableDeclarator")return;const t=a.init;if((t==null?void 0:t.type)!=="CallExpression")return;const y=["styled","keyframes"];if(t.callee.type==="Identifier"&&y.includes(t.callee.name))return!0}return!1}function i(e){const a=e.parent;return a.type==="ExportNamedDeclaration"||a.type==="ExportDefaultDeclaration"}return{VariableDeclaration:e=>{c(e)&&(i(e)||r.report({node:e,messageId:"mustBeExported",fix:a=>a.insertTextBefore(e,"export ")}))}}}},V={rules:{"no-variants-in-base":S,"must-be-exported":I}};module.exports=V;

package/index.d.ts

@@ -0,0 +1,7 @@
+declare const eslintPluginCore: {
+    rules: {
+        'no-variants-in-base': import("eslint").Rule.RuleModule;
+        'must-be-exported': import("eslint").Rule.RuleModule;
+    };
+};
+export default eslintPluginCore;

package/index.js

@@ -0,0 +1,116 @@
+import "esbuild";
+import "child_process";
+import "path";
+import "fs";
+import "fs/promises";
+import { createLogger as h, format as f, transports as P } from "winston";
+h({
+  level: "debug",
+  format: f.combine(f.colorize(), f.cli()),
+  transports: [new P.Console({})]
+});
+const S = ["salty", "css", "styles", "styled"], I = (r = []) => new RegExp(`\\.(${[...S, ...r].join("|")})\\.`), x = (r, i = []) => I(i).test(r), V = {
+  meta: {
+    type: "problem",
+    fixable: "code",
+    docs: {
+      description: "Ensure `variants` are not nested inside `base` in styled calls",
+      category: "Errors",
+      recommended: !0
+    },
+    messages: {
+      nestedVariants: "`variants` should not be nested inside `base`."
+    }
+  },
+  create(r) {
+    return x(r.filename) ? {
+      CallExpression: (l) => {
+        try {
+          const { callee: o, arguments: e } = l;
+          if (!(o.type === "Identifier" && o.name === "styled")) return;
+          const t = e[1];
+          if (!t || !(t.type === "ObjectExpression")) return;
+          const c = t.properties.find((s) => s.type === "Property" && s.key.type === "Identifier" && s.key.name === "base");
+          if (!c) return;
+          const { value: p } = c;
+          if (!(p.type === "ObjectExpression")) return;
+          const n = p.properties.find(
+            (s) => s.type === "Property" && s.key.type === "Identifier" && s.key.name === "variants"
+          );
+          if (!n) return;
+          r.report({
+            node: n,
+            messageId: "nestedVariants",
+            fix: (s) => {
+              if (!n.range) return null;
+              const { sourceCode: m } = r, b = m.getText(n), E = t.properties.indexOf(c), u = t.properties[E];
+              if (!u.range) return null;
+              const v = [u.range[1], u.range[1]], y = [
+                n.range[0] - 1,
+                // Include the preceding comma (if any)
+                n.range[1]
+              ];
+              if (p.properties.at(-1) === n) {
+                const g = m.text.slice(n.range[1]).match(/^\s*,/);
+                g && (y[1] += g[0].length);
+              }
+              return [s.removeRange(y), s.insertTextAfterRange(v, `, ${b}`)];
+            }
+          });
+        } catch (o) {
+          console.log("ESlint error", o);
+          return;
+        }
+      }
+    } : {};
+  }
+}, C = {
+  meta: {
+    type: "problem",
+    fixable: "code",
+    docs: {
+      description: "Salty CSS related function calls or other values must be exported",
+      category: "Errors",
+      recommended: !0
+    },
+    messages: {
+      mustBeExported: "Salty CSS related function calls or other values must be exported"
+    }
+  },
+  create(r) {
+    if (!x(r.filename)) return {};
+    function l(e) {
+      if (e.type === "VariableDeclaration") {
+        const a = e.declarations[0];
+        if (a.type !== "VariableDeclarator") return;
+        const t = a.init;
+        if ((t == null ? void 0 : t.type) !== "CallExpression") return;
+        const d = ["styled", "keyframes"];
+        if (t.callee.type === "Identifier" && d.includes(t.callee.name))
+          return !0;
+      }
+      return !1;
+    }
+    function o(e) {
+      const a = e.parent;
+      return a.type === "ExportNamedDeclaration" || a.type === "ExportDefaultDeclaration";
+    }
+    return {
+      VariableDeclaration: (e) => {
+        l(e) && (o(e) || r.report({
+          node: e,
+          messageId: "mustBeExported",
+          fix: (a) => a.insertTextBefore(e, "export ")
+        }));
+      }
+    };
+  }
+}, L = {
+  rules: {
+    "no-variants-in-base": V,
+    "must-be-exported": C
+  }
+};
+export {
+  L as default
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@salty-css/eslint-plugin-core",
+  "version": "0.0.1-alpha.100",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "typings": "./dist/index.d.ts",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "ESLint plugin for Salty CSS",
+  "homepage": "https://salty-css.dev/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/margarita-form/salty-css.git"
+  },
+  "bugs": {
+    "url": "https://github.com/margarita-form/salty-css/issues"
+  },
+  "files": [
+    "**/*",
+    "!**/*.tsbuildinfo"
+  ],
+  "nx": {
+    "sourceRoot": "libs/eslint-plugin-core/src",
+    "name": "eslint-plugin-core"
+  },
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.cjs"
+    }
+  },
+  "dependencies": {
+    "@salty-css/core": "^0.0.1-alpha.100",
+    "eslint": ">=9.x || >=8.x || >=7.x"
+  }
+}

package/rules/must-be-exported.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from 'eslint';
+export declare const mustBeExported: Rule.RuleModule;

package/rules/no-variants-in-base.d.ts

@@ -0,0 +1,2 @@
+import { Rule } from 'eslint';
+export declare const noVariantsInBase: Rule.RuleModule;