@salty-css/core 0.0.1-alpha.24 → 0.0.1-alpha.240

package/bin/index.js

@@ -1,130 +1,3 @@
 #!/usr/bin/env node
-import { Command as L } from "commander";
-import { mkdir as N, readFile as g, writeFile as y } from "fs/promises";
-import { join as o, relative as O, parse as A, format as H } from "path";
-import { render as T } from "ejs";
-import { generateCss as W } from "../compiler/index.js";
-import { p as B } from "../pascal-case-BQpR5PdN.js";
-import { createLogger as G, format as J, transports as R } from "winston";
-import { existsSync as q } from "fs";
-import { exec as M } from "child_process";
-import U from "ora";
-const i = G({
-  level: "debug",
-  format: J.combine(J.colorize(), J.cli()),
-  transports: [new R.Console({})]
-}), _ = (e) => new Promise((l, m) => {
-  M(e, (u) => {
-    if (u) return m(u);
-    l();
-  });
-}), D = async (...e) => {
-  const l = e.map((F) => F.replace("-D", "").split("@").slice(0, -1).join("@").trim()), m = U(`Installing packages: ${l.join(", ")}`).start(), u = e.join(" ");
-  await _(`npm install ${u}`), m.succeed(`Installed packages: ${l.join(",")}`);
-}, V = () => q(o(process.cwd(), "node_modules", ".bin", "prettier"));
-async function x(e) {
-  try {
-    if (!V()) return;
-    await _(`./node_modules/.bin/prettier --write "${e}"`), i.info(`Formatted ${e} with Prettier`);
-  } catch (l) {
-    i.error(`Error formatting ${e} with Prettier:`, l);
-  }
-}
-async function K() {
-  const e = new L();
-  e.name("salty-css").description("Salty-CSS CLI tool to help with annoying configuration tasks.");
-  const l = {
-    // Core files
-    "salty.config.ts": import("../salty.config-D9ANEDiH.js"),
-    "saltygen/index.css": import("../index-D_732b92.js"),
-    // React
-    "react/react-styled-file.ts": import("../react-styled-file-CGVf5n1B.js")
-  }, m = async (a, c) => {
-    const { default: p } = await l[a], r = T(p, c);
-    return { fileName: a, content: r };
-  }, u = async () => {
-    const a = o(process.cwd(), ".saltyrc");
-    return await g(a, "utf-8").then(JSON.parse).catch(() => ({}));
-  }, F = async () => {
-    const a = new URL("../package.json", import.meta.url);
-    return await g(a, "utf-8").then(JSON.parse).catch(() => ({}));
-  }, E = await (async () => (await u()).defaultProject)(), P = await F(), v = {
-    core: `@salty-css/core@${P.version}`,
-    react: `@salty-css/react@${P.version}`,
-    eslintPluginCore: `@salty-css/eslint-plugin-core@${P.version}`,
-    vite: `@salty-css/vite@${P.version}`
-  };
-  e.command("init").description("Initialize a new Salty-CSS project.").requiredOption("-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.").action(async function() {
-    await D(v.core, v.react), await D(`-D ${v.eslintPluginCore}`), i.info("Initializing a new Salty-CSS project...");
-    const { dir: a, cssFile: c } = this.opts(), p = process.cwd(), r = o(p, a), $ = await Promise.all([m("salty.config.ts"), m("saltygen/index.css")]);
-    await N(r, { recursive: !0 });
-    const I = $.map(async ({ fileName: t, content: s }) => {
-      const d = o(r, t);
-      if (await g(d, "utf-8").catch(() => {
-      }) !== void 0) {
-        i.debug("File already exists: " + d);
-        return;
-      }
-      const k = t.split("/").slice(0, -1).join("/");
-      k && await N(o(r, k), { recursive: !0 }), i.info("Writing file: " + d), await y(d, s), await x(d);
-    });
-    await Promise.all(I);
-    const h = O(p, r), n = o(p, ".saltyrc"), f = await g(n, "utf-8").catch(() => {
-    });
-    if (f === void 0) {
-      i.info("Creating file: " + n);
-      const s = JSON.stringify({
-        defaultProject: h,
-        projects: [h]
-      }, null, 2);
-      await y(n, s);
-    } else {
-      i.info("Edit file: " + n);
-      const t = JSON.parse(f), s = new Set((t == null ? void 0 : t.projects) || []);
-      s.add(h), t.projects = [...s];
-      const d = JSON.stringify(t, null, 2);
-      await y(n, d);
-    }
-    const C = o(p, ".gitignore"), S = await g(C, "utf-8").catch(() => {
-    });
-    if (S !== void 0 && (S.includes("saltygen") || (i.info("Edit file: " + C), await y(C, S + `
-
-# Salty-CSS
-saltygen
-`))), c) {
-      const t = o(r, c), s = await g(t, "utf-8").catch(() => {
-      });
-      if (s !== void 0 && !s.includes("saltygen")) {
-        const j = o(t, ".."), z = `@import '${O(j, o(r, "saltygen/index.css"))}';`;
-        i.info("Edit file: " + t), await y(t, z + `
-` + s), await x(t);
-      }
-    }
-    const w = o(r, "vite.config.ts"), b = await g(w, "utf-8").catch(() => {
-    });
-    if (b !== void 0 && !b.includes("saltyPlugin")) {
-      i.info("Edit file: " + w);
-      const s = `import { saltyPlugin } from '@salty-css/vite';
-`, j = b.replace(/(plugins: \[)/, `$1
-  saltyPlugin(__dirname),`);
-      i.info("Installing @salty-css/vite"), await D(v.vite), i.info("Adding Salty-CSS plugin to Vite config..."), await y(w, s + j), await x(w);
-    }
-  }), e.command("build").alias("b").description("Build the Salty-CSS project.").option("-d, --dir <dir>", "Project directory to build the project in.", E).action(async function() {
-    i.info("Building the Salty-CSS project...");
-    const { dir: a } = this.opts(), c = o(process.cwd(), a);
-    await W(c);
-  }), e.command("generate <file>").alias("g").description("Generate a new component file.").option("-d, --dir <dir>", "Project directory to generate the file in.", E).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.").action(async function(a) {
-    const { dir: c, tag: p, name: r, className: $ } = this.opts(), I = o(process.cwd(), c), h = o(I, a), n = A(h);
-    n.ext || (n.ext = ".ts"), n.name.endsWith(".css") || (n.name = n.name + ".css"), n.base = n.name + n.ext;
-    const f = H(n);
-    if (await g(f, "utf-8").catch(() => {
-    }) !== void 0) {
-      i.error("File already exists:", f);
-      return;
-    }
-    i.info("Generating a new file: " + f);
-    const S = B(r || n.base.replace(/\.css\.\w+$/, "")), { content: w } = await m("react/react-styled-file.ts", { tag: p, name: S, className: $ });
-    await y(f, w), await x(f);
-  }), e.parseAsync(process.argv);
-}
-K().catch((e) => console.error(e));
+import { main as r } from "./main.js";
+r().catch((o) => console.error(o));

package/bin/logger.d.ts

@@ -1 +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"),A=require("fs"),s=require("fs/promises"),n=require("path"),ne=require("ejs"),e=require("../index-O0uhHL8c.cjs"),ie=require("../pascal-case-iWoaJWwT.cjs"),se=require("child_process"),oe=require("ora"),ae=require("../should-restart-BPXyHnNn.cjs");var G=typeof document<"u"?document.currentScript:null;const X=y=>new Promise((C,P)=>{se.exec(y,x=>{if(x)return P(x);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(),x=y.join(" ");await X(`npm install ${x}`),P.succeed(`Installed packages: ${C}`)},re=()=>A.existsSync(n.join(process.cwd(),"node_modules",".bin","prettier"));async function S(y){try{if(!re())return;await X(`./node_modules/.bin/prettier --write "${y}"`),e.logger.info(`Formatted ${y} with Prettier`)}catch(C){e.logger.error(`Error formatting ${y} with Prettier:`,C)}}async function ce(){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:f}=await C[i],d=ne.render(f,a);return{fileName:i,content:d}},x=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:G&&G.tagName.toUpperCase()==="SCRIPT"&&G.src||new URL("bin/main.cjs",document.baseURI).href);return N(i)},V=await(async()=>(await x()).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}`},H=i=>{const a=i==="."?"":i,f=process.cwd();return n.join(f,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 e.logError("Salty CSS project must be initialized in a directory with a package.json file.");e.logger.info("Initializing a new Salty-CSS project!");const{dir:f=i,cssFile:d,skipInstall:p}=this.opts();if(!f)return e.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 c=process.cwd(),r=H(f),q=await Promise.all([P("salty.config.ts"),P("saltygen/index.css")]);await s.mkdir(r,{recursive:!0});const m=q.map(async({fileName:t,content:u})=>{const l=n.join(r,t);if(await s.readFile(l,"utf-8").catch(()=>{})!==void 0){e.logger.debug("File already exists: "+l);return}const k=t.split("/").slice(0,-1).join("/");k&&await s.mkdir(n.join(r,k),{recursive:!0}),e.logger.info("Creating file: "+l),await s.writeFile(l,u),await S(l)});await Promise.all(m);const w=n.relative(c,r)||".",h=n.join(c,".saltyrc.json"),g=await s.readFile(h,"utf-8").catch(()=>{});if(g===void 0){e.logger.info("Creating file: "+h);const u=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,u),await S(h)}else{const t=JSON.parse(g),u=(t==null?void 0:t.projects)||[];if(u.findIndex(o=>o.dir===w)===-1){u.push({dir:w,framework:"react"}),t.projects=[...u];const o=JSON.stringify(t,null,2);o!==g&&(e.logger.info("Edit file: "+h),await s.writeFile(h,o),await S(h))}}const j=n.join(c,".gitignore"),T=await s.readFile(j,"utf-8").catch(()=>{});T!==void 0&&(T.includes("saltygen")||(e.logger.info("Edit file: "+j),await s.writeFile(j,T+`
+
+# Salty-CSS
+saltygen
+`)));const F=["src","public","assets","styles","css","app"],W=["styles","css","app","pages"],M=["index","styles","main","app","global","globals"],U=[".css",".scss",".sass"],E=await(async()=>{if(d)return d;for(const t of F)for(const u of M)for(const l of U){const o=n.join(r,t,u+l);if(await s.readFile(o,"utf-8").catch(()=>{})!==void 0)return n.relative(r,o);for(const O of W){const R=n.join(r,t,O,u+l);if(await s.readFile(R,"utf-8").catch(()=>{})!==void 0)return n.relative(r,R)}}})();if(E){const t=n.join(r,E),u=await s.readFile(t,"utf-8").catch(()=>{});if(u!==void 0&&!u.includes("saltygen")){const o=n.join(t,".."),O=`@import '${n.relative(o,n.join(r,"saltygen/index.css"))}';`;e.logger.info("Adding global import statement to CSS file: "+t),await s.writeFile(t,O+`
+`+u),await S(t)}}else e.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(c,"eslint.config.js"),projectMjs:n.join(r,"eslint.config.mjs"),rootMjs:n.join(c,"eslint.config.mjs"),projectJson:n.join(r,".eslintrc.json"),rootJson:n.join(c,".eslintrc.json")},v=Object.values(Z).find(t=>A.existsSync(t));if(v){p||await I(D.eslintConfigCore);const t=await s.readFile(v,"utf-8").catch(()=>{});if(!t)return e.logError("Could not read ESLint config file.");if(!t.includes("salty-css"))if(e.logger.info("Edit file: "+v),v.endsWith("js")){let o=`import saltyCss from "@salty-css/eslint-config-core/flat";
+${t}`;t.includes("typescript-eslint")?o.includes(".config(")?o=o.replace(".config(",".config(saltyCss,"):e.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,"):e.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 l=JSON.parse(t);l.extends||(l.extends=[]),l.extends.push("@salty-css/core");const o=JSON.stringify(l,null,2);await s.writeFile(v,o),await S(v)}}const L=n.join(r,"vite.config.ts"),z=await s.readFile(L,"utf-8").catch(()=>{});if(z!==void 0&&!z.includes("saltyPlugin")){e.logger.info("Edit file: "+L);const u=`import { saltyPlugin } from '@salty-css/vite';
+`,o=z.replace(/(plugins: \[)/,`$1
+  saltyPlugin(__dirname),`);p||await I(`-D ${D.vite}`),e.logger.info("Adding Salty-CSS plugin to Vite config..."),await s.writeFile(L,u+o),await S(L)}const _=["next.config.js","next.config.cjs","next.config.ts","next.config.mjs"].map(t=>n.join(r,t)).find(t=>A.existsSync(t));if(_){let t=await s.readFile(_,"utf-8").catch(()=>{});if(t!==void 0&&!t.includes("withSaltyCss")){let l=!1;/\splugins([^=]*)=[^[]\[/.test(t)&&!l&&(t=t.replace(/\splugins([^=]*)=[^[]\[/,(R,J)=>` plugins${J}= [withSaltyCss,`),l=!0);const k=t.includes("module.exports"),O=k?`const { withSaltyCss } = require('@salty-css/next');
+`:`import { withSaltyCss } from '@salty-css/next';
+`;k&&!l?(t=t.replace(/module.exports = ([^;]+)/,(R,J)=>`module.exports = withSaltyCss(${J})`),l=!0):l||(t=t.replace(/export default ([^;]+)/,(R,J)=>`export default withSaltyCss(${J})`)),p||await I(`-D ${D.next}`),e.logger.info("Adding Salty-CSS plugin to Next.js config..."),await s.writeFile(_,O+t),await S(_)}}const ee=await N().catch(()=>e.logError("Could not read package.json file.")).then(t=>(t.scripts||(t.scripts={}),t.scripts.prepare?t.scripts.prepare.includes("salty-css")||(e.logger.info("Edit file: "+b),t.scripts.prepare=t.scripts.prepare+" && npx salty-css build"):(e.logger.info("Edit file: "+b),t.scripts.prepare="npx salty-css build"),t));await Y(ee),e.logger.info("Running the build to generate initial CSS..."),await e.generateCss(r),e.logger.info("🎉 Salty CSS project initialized successfully!"),e.logger.info("Next steps:"),e.logger.info("1. Configure variables and templates in `salty.config.ts`"),e.logger.info("2. Create a new component with `npx salty-css generate [component-name]`"),e.logger.info("3. Run `npx salty-css build` to generate the CSS"),e.logger.info("4. Read about the features in the documentation: https://salty-css.dev"),e.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.").option("--watch","Watch for changes and rebuild the project.").action(async function(i=V){e.logger.info("Building the Salty-CSS project...");const{dir:a=i,watch:f}=this.opts();if(!a)return e.logError("Project directory must be provided. Add it as the first argument after build command or use the --dir option.");const d=H(a);await e.generateCss(d),f&&(e.logger.info("Watching for changes in the project directory..."),A.watch(d,{recursive:!0},async(p,c)=>{await ae.checkShouldRestart(c)?await e.generateCss(d,!1,!1):e.isSaltyFile(c)&&await e.generateFile(d,c)}))}),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:f=i,dir:d=a,tag:p,name:c,className:r,reactComponent:q=!1}=this.opts();if(!f)return e.logError("File to generate must be provided. Add it as the first argument after generate command or use the --file option.");if(!d)return e.logError("Project directory must be provided. Add it as the second argument after generate command or use the --dir option.");const m=H(d),w=f.split("/").slice(0,-1).join("/");w&&await s.mkdir(n.join(m,w),{recursive:!0});const h=n.join(m,f),g=n.parse(h);g.ext||(g.ext=".ts"),g.name.endsWith(".css")||(g.name=g.name+".css"),g.base=g.name+g.ext;const j=n.format(g);if(await s.readFile(j,"utf-8").catch(()=>{})!==void 0){e.logger.error("File already exists:",j);return}let F=ie.pascalCase(c||g.base.replace(/\.css\.\w+$/,""));if(q){const M=F+"Component";F=F+"Wrapper";const U=g.base.replace(/\.css\.\w+$/,""),{content:Q}=await P("react/react-vanilla-file.ts",{tag:p,componentName:M,styledComponentName:F,className:r,fileName:U});g.name=U.replace(/\.css$/,""),g.ext=".tsx",g.base=g.name+g.ext;const E=n.format(g);e.logger.info("Generating a new file: "+E),await s.writeFile(E,Q),await S(E)}const{content:W}=await P("react/react-styled-file.ts",{tag:p,name:F,className:r});e.logger.info("Generating a new file: "+j),await s.writeFile(j,W),await S(j)});const K=async()=>{const i=n.join(process.cwd(),"package.json"),a=await N(i).catch(p=>e.logError(p));if(!a)return e.logError("Could not read package.json file.");const f={...a.dependencies,...a.devDependencies},d=Object.entries(f).filter(([p])=>p==="salty-css"||p.startsWith("@salty-css/"));return d.length?d:e.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:f=i}=this.opts(),d=await K();if(!d)return e.logError("Could not update Salty-CSS packages as any were found in package.json.");const p=d.map(([m])=>f==="@"?`${m}@${$.version}`:`${m}@${f.replace(/^@/,"")}`);a?(e.logger.warn("Using legacy peer dependencies to update packages."),await I(...p,"--legacy-peer-deps")):await I(...p);const c=await K();if(!c)return e.logError("Something went wrong while reading the updated packages.");const r=c.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(/^\^/,"");e.logger.info(`Updated to all Salty CSS packages successfully to ${w}`)}else for(const[m,w]of Object.entries(r)){const h=m.replace(/^\^/,"");e.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();e.logger.info("CLI is running: "+i.version);const a=n.join(process.cwd(),"package.json"),f=await N(a).catch(c=>e.logError(c));if(!f)return;const d={...f.dependencies,...f.devDependencies},p=Object.keys(d).filter(c=>c==="salty-css"||c.startsWith("@salty-css/"));if(!p.length)return e.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 c of p)e.logger.info(`${c}: ${d[c]}`)}),y.parseAsync(process.argv)}exports.main=ce;

package/bin/main.d.ts

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

package/bin/main.js

@@ -0,0 +1,263 @@
+import { Command as oe } from "commander";
+import { existsSync as Q, watch as re } from "fs";
+import { mkdir as q, readFile as S, writeFile as C } from "fs/promises";
+import { join as a, relative as z, parse as ce, format as te } from "path";
+import { render as le } from "ejs";
+import { l as t, a as h, g as K, i as de, b as fe } from "../index-D8CuiJVg.js";
+import { p as pe } from "../pascal-case-BQpR5PdN.js";
+import { exec as ue } from "child_process";
+import ge from "ora";
+import { c as ye } from "../should-restart-CeCqMexy.js";
+const ne = (g) => new Promise((P, x) => {
+  ue(g, ($) => {
+    if ($) return x($);
+    P();
+  });
+}), E = async (...g) => {
+  const P = g.map((J) => J.replace("-D", "").split("@").slice(0, -1).join("@").trim()).join(", "), x = ge(`Installing packages: ${P}`).start(), $ = g.join(" ");
+  await ne(`npm install ${$}`), x.succeed(`Installed packages: ${P}`);
+}, me = () => Q(a(process.cwd(), "node_modules", ".bin", "prettier"));
+async function j(g) {
+  try {
+    if (!me()) 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 Je() {
+  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, i) => {
+    const { default: d } = await P[n], l = le(d, i);
+    return { fileName: n, content: l };
+  }, $ = async () => {
+    const n = a(process.cwd(), ".saltyrc.json");
+    return await S(n, "utf-8").then(JSON.parse).catch(() => ({}));
+  }, J = a(process.cwd(), "package.json"), O = async (n = J) => {
+    const i = await S(n, "utf-8").then(JSON.parse).catch(() => {
+    });
+    if (!i) throw "Could not read package.json file!";
+    return i;
+  }, se = async (n, i = J) => {
+    typeof n == "object" && (n = JSON.stringify(n, null, 2)), await C(i, n);
+  }, X = async () => {
+    const n = new URL("../package.json", import.meta.url);
+    return O(n);
+  }, Y = await (async () => (await $()).defaultProject)(), N = await X(), 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 i = n === "." ? "" : n, d = process.cwd();
+    return a(d, i);
+  };
+  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: d = n, cssFile: l, skipInstall: p } = this.opts();
+    if (!d) 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 r = process.cwd(), o = G(d), T = await Promise.all([x("salty.config.ts"), x("saltygen/index.css")]);
+    await q(o, { recursive: !0 });
+    const y = T.map(async ({ fileName: e, content: u }) => {
+      const c = a(o, e);
+      if (await S(c, "utf-8").catch(() => {
+      }) !== void 0) {
+        t.debug("File already exists: " + c);
+        return;
+      }
+      const b = e.split("/").slice(0, -1).join("/");
+      b && await q(a(o, b), { recursive: !0 }), t.info("Creating file: " + c), await C(c, u), await j(c);
+    });
+    await Promise.all(y);
+    const w = z(r, o) || ".", m = a(r, ".saltyrc.json"), f = await S(m, "utf-8").catch(() => {
+    });
+    if (f === void 0) {
+      t.info("Creating file: " + m);
+      const u = 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 C(m, u), await j(m);
+    } else {
+      const e = JSON.parse(f), u = (e == null ? void 0 : e.projects) || [];
+      if (u.findIndex((s) => s.dir === w) === -1) {
+        u.push({ dir: w, framework: "react" }), e.projects = [...u];
+        const s = JSON.stringify(e, null, 2);
+        s !== f && (t.info("Edit file: " + m), await C(m, s), await j(m));
+      }
+    }
+    const k = a(r, ".gitignore"), H = await S(k, "utf-8").catch(() => {
+    });
+    H !== void 0 && (H.includes("saltygen") || (t.info("Edit file: " + k), await C(k, H + `
+
+# Salty-CSS
+saltygen
+`)));
+    const F = ["src", "public", "assets", "styles", "css", "app"], M = ["styles", "css", "app", "pages"], B = ["index", "styles", "main", "app", "global", "globals"], U = [".css", ".scss", ".sass"], D = await (async () => {
+      if (l) return l;
+      for (const e of F)
+        for (const u of B)
+          for (const c of U) {
+            const s = a(o, e, u + c);
+            if (await S(s, "utf-8").catch(() => {
+            }) !== void 0) return z(o, s);
+            for (const L of M) {
+              const R = a(o, e, L, u + c);
+              if (await S(R, "utf-8").catch(() => {
+              }) !== void 0) return z(o, R);
+            }
+          }
+    })();
+    if (D) {
+      const e = a(o, D), u = await S(e, "utf-8").catch(() => {
+      });
+      if (u !== void 0 && !u.includes("saltygen")) {
+        const s = a(e, ".."), L = `@import '${z(s, a(o, "saltygen/index.css"))}';`;
+        t.info("Adding global import statement to CSS file: " + e), await C(e, L + `
+` + u), await j(e);
+      }
+    } else
+      t.warn("Could not find a CSS file to import the generated CSS. Please add it manually.");
+    const ae = {
+      projectJs: a(o, "eslint.config.js"),
+      rootJs: a(r, "eslint.config.js"),
+      projectMjs: a(o, "eslint.config.mjs"),
+      rootMjs: a(r, "eslint.config.mjs"),
+      projectJson: a(o, ".eslintrc.json"),
+      rootJson: a(r, ".eslintrc.json")
+    }, v = Object.values(ae).find((e) => Q(e));
+    if (v) {
+      p || await E(A.eslintConfigCore);
+      const e = await S(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 C(v, s), await j(v);
+        } else {
+          const c = JSON.parse(e);
+          c.extends || (c.extends = []), c.extends.push("@salty-css/core");
+          const s = JSON.stringify(c, null, 2);
+          await C(v, s), await j(v);
+        }
+    }
+    const W = a(o, "vite.config.ts"), V = await S(W, "utf-8").catch(() => {
+    });
+    if (V !== void 0 && !V.includes("saltyPlugin")) {
+      t.info("Edit file: " + W);
+      const u = `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 C(W, u + s), await j(W);
+    }
+    const _ = ["next.config.js", "next.config.cjs", "next.config.ts", "next.config.mjs"].map((e) => a(o, e)).find((e) => Q(e));
+    if (_) {
+      let e = await S(_, "utf-8").catch(() => {
+      });
+      if (e !== void 0 && !e.includes("withSaltyCss")) {
+        let c = !1;
+        /\splugins([^=]*)=[^[]\[/.test(e) && !c && (e = e.replace(/\splugins([^=]*)=[^[]\[/, (R, I) => ` plugins${I}= [withSaltyCss,`), c = !0);
+        const b = e.includes("module.exports"), L = b ? `const { withSaltyCss } = require('@salty-css/next');
+` : `import { withSaltyCss } from '@salty-css/next';
+`;
+        b && !c ? (e = e.replace(/module.exports = ([^;]+)/, (R, I) => `module.exports = withSaltyCss(${I})`), c = !0) : c || (e = e.replace(/export default ([^;]+)/, (R, I) => `export default withSaltyCss(${I})`)), p || await E(`-D ${A.next}`), t.info("Adding Salty-CSS plugin to Next.js config..."), await C(_, L + e), await j(_);
+      }
+    }
+    const ie = 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(ie), t.info("Running the build to generate initial CSS..."), await K(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.").option("--watch", "Watch for changes and rebuild the project.").action(async function(n = Y) {
+    t.info("Building the Salty-CSS project...");
+    const { dir: i = n, watch: d } = this.opts();
+    if (!i) return h("Project directory must be provided. Add it as the first argument after build command or use the --dir option.");
+    const l = G(i);
+    await K(l), d && (t.info("Watching for changes in the project directory..."), re(l, { recursive: !0 }, async (p, r) => {
+      await ye(r) ? await K(l, !1, !1) : de(r) && await fe(l, r);
+    }));
+  }), 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, i = Y) {
+    const { file: d = n, dir: l = i, tag: p, name: r, className: o, reactComponent: T = !1 } = this.opts();
+    if (!d) return h("File to generate must be provided. Add it as the first argument after generate command or use the --file option.");
+    if (!l) return h("Project directory must be provided. Add it as the second argument after generate command or use the --dir option.");
+    const y = G(l), w = d.split("/").slice(0, -1).join("/");
+    w && await q(a(y, w), { recursive: !0 });
+    const m = a(y, d), f = ce(m);
+    f.ext || (f.ext = ".ts"), f.name.endsWith(".css") || (f.name = f.name + ".css"), f.base = f.name + f.ext;
+    const k = te(f);
+    if (await S(k, "utf-8").catch(() => {
+    }) !== void 0) {
+      t.error("File already exists:", k);
+      return;
+    }
+    let F = pe(r || f.base.replace(/\.css\.\w+$/, ""));
+    if (T) {
+      const B = F + "Component";
+      F = F + "Wrapper";
+      const U = f.base.replace(/\.css\.\w+$/, ""), { content: ee } = await x("react/react-vanilla-file.ts", { tag: p, componentName: B, styledComponentName: F, className: o, fileName: U });
+      f.name = U.replace(/\.css$/, ""), f.ext = ".tsx", f.base = f.name + f.ext;
+      const D = te(f);
+      t.info("Generating a new file: " + D), await C(D, ee), await j(D);
+    }
+    const { content: M } = await x("react/react-styled-file.ts", { tag: p, name: F, className: o });
+    t.info("Generating a new file: " + k), await C(k, M), await j(k);
+  });
+  const Z = async () => {
+    const n = a(process.cwd(), "package.json"), i = await O(n).catch((p) => h(p));
+    if (!i) return h("Could not read package.json file.");
+    const d = { ...i.dependencies, ...i.devDependencies }, l = Object.entries(d).filter(([p]) => p === "salty-css" || p.startsWith("@salty-css/"));
+    return l.length ? l : 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: i, version: d = n } = this.opts(), l = await Z();
+    if (!l) return h("Could not update Salty-CSS packages as any were found in package.json.");
+    const p = l.map(([y]) => d === "@" ? `${y}@${N.version}` : `${y}@${d.replace(/^@/, "")}`);
+    i ? (t.warn("Using legacy peer dependencies to update packages."), await E(...p, "--legacy-peer-deps")) : await E(...p);
+    const r = await Z();
+    if (!r) return h("Something went wrong while reading the updated packages.");
+    const o = r.reduce((y, [w, m]) => (y[m] || (y[m] = []), y[m].push(w), y), {});
+    if (Object.keys(o).length === 1) {
+      const w = Object.keys(o)[0].replace(/^\^/, "");
+      t.info(`Updated to all Salty CSS packages successfully to ${w}`);
+    } else
+      for (const [y, w] of Object.entries(o)) {
+        const m = y.replace(/^\^/, "");
+        t.info(`Updated to ${m}: ${w.join(", ")}`);
+      }
+  }), g.option("-v, --version", "Show the current version of Salty-CSS.").action(async function() {
+    const n = await X();
+    t.info("CLI is running: " + n.version);
+    const i = a(process.cwd(), "package.json"), d = await O(i).catch((r) => h(r));
+    if (!d) return;
+    const l = { ...d.dependencies, ...d.devDependencies }, p = Object.keys(l).filter((r) => r === "salty-css" || r.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: " + i
+      );
+    for (const r of p)
+      t.info(`${r}: ${l[r]}`);
+  }), g.parseAsync(process.argv);
+}
+export {
+  Je as main
+};

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/get-function-range.d.ts

@@ -0,0 +1 @@
+export declare const getFunctionRange: (contents: string, name: string) => Promise<[number, number]>;

package/compiler/index.cjs

@@ -1,11 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const z=require("esbuild"),B=require("child_process"),P=require("../dash-case-DKzpenwY.cjs"),o=require("path"),r=require("fs"),K=require("fs/promises"),V=require("../parse-templates-W0YfTmOT.cjs");function G(t){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(t){for(const n in t)if(n!=="default"){const s=Object.getOwnPropertyDescriptor(t,n);Object.defineProperty(e,n,s.get?s:{enumerable:!0,get:()=>t[n]})}}return e.default=t,Object.freeze(e)}const R=G(z),N=t=>o.join(t,"./saltygen"),_=["salty","css","styles","styled"],q=(t=[])=>new RegExp(`\\.(${[..._,...t].join("|")})\\.`),O=(t,e=[])=>q(e).test(t),J=async t=>{const e=N(t),n=o.join(t,"salty.config.ts"),s=o.join(e,"salty.config.js");await R.build({entryPoints:[n],minify:!0,treeShaking:!0,bundle:!0,outfile:s,format:"esm",external:["react"]});const a=Date.now(),{config:w}=await import(`${s}?t=${a}`);return w},M=async t=>{const e=await J(t),n=new Set,s=(d,y=[])=>d?Object.entries(d).flatMap(([p,c])=>{if(!c)return;if(typeof c=="object")return s(c,[...y,p]);const C=[...y,p].join(".");n.add(`"${C}"`);const x=[...y.map(P.dashCase),P.dashCase(p)].join("-"),{result:D}=V.parseValueTokens(c);return`--${x}: ${D};`}):[],a=d=>d?Object.entries(d).flatMap(([y,p])=>{const c=s(p);return y==="base"?c.join(""):`${y} { ${c.join("")} }`}):[],w=d=>d?Object.entries(d).flatMap(([y,p])=>Object.entries(p).flatMap(([c,C])=>{const x=s(C,[y]),D=`.${y}-${c}, [data-${y}="${c}"]`,k=x.join("");return`${D} { ${k} }`})):[],j=s(e.variables),S=a(e.responsiveVariables),l=w(e.conditionalVariables),b=N(t),f=o.join(b,"css/variables.css"),i=`:root { ${j.join("")} ${S.join("")} } ${l.join("")}`;r.writeFileSync(f,i);const g=o.join(b,"types/css-tokens.d.ts"),m=`type VariableTokens = ${[...n].join("|")}; type PropertyValueToken = \`{\${VariableTokens}}\``;r.writeFileSync(g,m);const u=o.join(b,"css/global.css"),h=V.parseStyles(e.global,"");r.writeFileSync(u,h);const F=o.join(b,"css/templates.css"),v=V.parseTemplates(e.templates);r.writeFileSync(F,v)},T=async(t,e)=>{const n=P.toHash(t),s=o.join(e,"js",n+".js");await R.build({entryPoints:[t],minify:!0,treeShaking:!0,bundle:!0,outfile:s,format:"esm",target:["es2022"],keepNames:!0,external:["react"]});const a=Date.now();return await import(`${s}?t=${a}`)},E=async t=>{const e=N(t),n=o.join(e,"salty.config.js"),{config:s}=await import(n);return s},A=async t=>{try{const e=[],n=[],s=N(t),a=o.join(s,"index.css");(()=>{r.existsSync(s)&&B.execSync("rm -rf "+s),r.mkdirSync(s),r.mkdirSync(o.join(s,"css")),r.mkdirSync(o.join(s,"types"))})(),await M(t);const j=await E(t);async function S(i,g){const $=r.statSync(i);if($.isDirectory()){const m=r.readdirSync(i);await Promise.all(m.map(u=>S(o.join(i,u),o.join(g,u))))}else if($.isFile()&&O(i)){const u=await T(i,s),h=[];Object.entries(u).forEach(([y,p])=>{if(p.isKeyframes&&p.css){const k=`${p.animationName}.css`,H=`css/${k}`,I=o.join(s,H);e.push(k),r.writeFileSync(I,p.css);return}if(!p.generator)return;const c=p.generator._withBuildContext({name:y,config:j}),C=`${c.hash}-${c.priority}.css`;n[c.priority]||(n[c.priority]=[]),n[c.priority].push(C),h.push(C);const x=`css/${C}`,D=o.join(s,x);r.writeFileSync(D,c.css)});const F=h.map(y=>`@import url('./${y}');`).join(`
-`),v=P.toHash(i,6),d=o.join(s,`css/${v}.css`);r.writeFileSync(d,F)}}await S(t,s);const l=e.map(i=>`@import url('./css/${i}');`).join(`
-`);let f=`@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(j.importStrategy!=="component"){const i=n.flat().map(g=>`@import url('./css/${g}');`).join(`
-`);f+=i}r.writeFileSync(a,f)}catch(e){console.error(e)}},L=async(t,e)=>{try{const n=[],s=o.join(t,"./saltygen"),a=o.join(s,"index.css");if(O(e)){const j=await E(t),S=await T(e,s);Object.entries(S).forEach(([g,$])=>{if(!$.generator)return;const m=$.generator._withBuildContext({name:g,config:j}),u=`${m.hash}-${m.priority}.css`,h=`css/${u}`,F=o.join(s,h);n.push(u),r.writeFileSync(F,m.css)});const l=r.readFileSync(a,"utf8").split(`
-`),b=n.map(g=>`@import url('../saltygen/css/${g}');`),i=[...new Set([...l,...b])].join(`
-`);r.writeFileSync(a,i)}}catch(n){console.error(n)}},U=async(t,e)=>{try{const n=o.join(t,"./saltygen");if(O(e)){const a=r.readFileSync(e,"utf8");a.replace(/^(?!export\s)const\s.*/gm,f=>`export ${f}`)!==a&&await K.writeFile(e,a);const j=await E(t),S=await T(e,n);let l=a;Object.entries(S).forEach(([f,i])=>{var F;if(i.isKeyframes){console.log("value",i);return}if(!i.generator)return;const g=i.generator._withBuildContext({name:f,config:j}),$=new RegExp(`${f}[=\\s]+[^()]+styled\\(([^,]+),`,"g").exec(a);if(!$)return console.error("Could not find the original declaration");const m=(F=$.at(1))==null?void 0:F.trim(),u=`${f} = styled(${m}, "${g.classNames}", "${g._callerName}", ${JSON.stringify(g.props)});`,h=new RegExp(`${f}[=\\s]+[^()]+styled\\(([^,]+),[^;]+;`,"g");l=l.replace(h,u)});const b=P.toHash(e,6);return j.importStrategy==="component"&&(l=`import '../../saltygen/css/${b}.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=T;exports.generateConfigStyles=M;exports.generateCss=A;exports.generateFile=L;exports.isSaltyFile=O;exports.minimizeFile=U;exports.saltyFileExtensions=_;exports.saltyFileRegExp=q;
+"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-3N79AOBO.cjs");const e=require("../index-O0uhHL8c.cjs");require("../css/merge.cjs");require("../define-templates-Cunsb_Tr.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,16 +1,24 @@
-import { StyleComponentGenerator } from '../generator/style-generator';
 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) => Promise<void>;
-export declare const compileSaltyFile: (sourceFilePath: string, outputDirectory: string) => Promise<{
-    [key: string]: {
-        generator: StyleComponentGenerator;
-        isKeyframes?: boolean;
-        animationName?: string;
-        css?: string;
+export declare const generateConfigStyles: (dirname: string, configFiles: Set<string>) => Promise<void>;
+export declare const compileSaltyFile: (dirname: string, sourceFilePath: string, outputDirectory: string) => Promise<{
+    contents: {
+        [key: string]: {
+            generator: any;
+            isClassName?: boolean;
+            isMedia?: boolean;
+            isGlobalDefine?: boolean;
+            isDefineVariables?: boolean;
+            isDefineTemplates?: boolean;
+            isKeyframes?: boolean;
+            animationName?: string;
+            css?: Promise<string>;
+            styles?: any;
+        };
     };
+    outputFilePath: string;
 }>;
-export declare const generateCss: (dirname: string) => 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 generateCss: (dirname: string, prod?: boolean, clean?: boolean) => Promise<void>;
+export declare const generateFile: (dirname: string, file: string, prod?: boolean) => Promise<void>;
+export declare const minimizeFile: (dirname: string, file: string, prod?: boolean) => Promise<string | undefined>;