@sugarcube-org/cli 0.0.0-alpha.16 → 0.0.0-alpha.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE.md CHANGED
@@ -1,9 +1,31 @@
1
- # Proprietary Software
1
+ # Sugarcube Private Alpha License
2
2
 
3
- This software is proprietary and confidential. All rights reserved.
3
+ Copyright © 2025 Mark Tomlinson. All rights reserved.
4
4
 
5
- Copyright (c) 2025 Mark Tomlinson
5
+ **Version 1.0 December 2025**
6
6
 
7
- This software is provided "as is" without warranty of any kind, either express or implied.
7
+ This software is provided under a temporary, non-exclusive, non-transferable
8
+ license for private evaluation and internal use as part of the Sugarcube
9
+ Private Alpha Program.
8
10
 
9
- Unauthorized copying, distribution, or use of this software is strictly prohibited.
11
+ ## Permitted
12
+
13
+ - Use in internal and client projects for the purpose of evaluating Sugarcube
14
+ - Reporting bugs, performance issues, and usability feedback
15
+
16
+ ## Not Permitted
17
+
18
+ - Redistribution of the software or any derivative works
19
+ - Public hosting of the source code
20
+ - Sublicensing, resale, or commercial distribution of Sugarcube itself
21
+ - Reverse engineering for the purpose of creating a competing product
22
+
23
+ ## Disclaimer
24
+
25
+ This software is provided "as is", without warranty of any kind, express or
26
+ implied. The author assumes no liability for damages arising from its use.
27
+
28
+ ## Future Licensing
29
+
30
+ This license will be replaced by an open-source license at public beta or
31
+ general availability.
package/README.md CHANGED
@@ -1,52 +1,7 @@
1
1
  # @sugarcube-org/cli
2
2
 
3
- CLI for scaffolding sugarcube projects and managing design tokens.
3
+ > ⚠️ **Private Alpha** This package is under active development and not yet ready for public use.
4
4
 
5
- ## What it does
5
+ ## License
6
6
 
7
- - Initializes new sugarcube projects with design tokens and CSS architecture
8
- - Generates CSS variables and utility classes from design tokens
9
- - Validates design token files for W3C compliance
10
- - Installs copy-to-use components for multiple frameworks
11
- - Adds CUBE CSS architecture to projects
12
-
13
- ## Installation
14
-
15
- ```bash
16
- npm install -g @sugarcube-org/cli
17
- ```
18
-
19
- ## Usage
20
-
21
- ```bash
22
- # Initialize a new project
23
- make-sugarcube init
24
-
25
- # Generate CSS from tokens
26
- make-sugarcube generate
27
-
28
- # Validate token files
29
- make-sugarcube validate
30
-
31
- # Add components
32
- make-sugarcube components
33
-
34
- # Add CUBE CSS
35
- make-sugarcube cube
36
- ```
37
-
38
- ## Commands
39
-
40
- - `init` - Set up a new sugarcube project
41
- - `generate` - Generate CSS variables and utilities
42
- - `validate` - Validate design token files
43
- - `components` - Install copy-to-use components
44
- - `cube` - Add CUBE CSS architecture
45
-
46
- ## Development
47
-
48
- ```bash
49
- pnpm install
50
- pnpm build
51
- pnpm dev
52
- ```
7
+ See [LICENSE.md](./LICENSE.md) for terms.
package/dist/index.mjs CHANGED
@@ -1,50 +1,158 @@
1
1
  #!/usr/bin/env node
2
- var Te=Object.defineProperty;var a=(e,t)=>Te(e,"name",{value:t,configurable:!0});import{Command as j}from"commander";import{existsSync as k,readFileSync as re}from"node:fs";import{relative as E,join as h,basename as U,resolve as F,dirname as Ie,normalize as Fe}from"pathe";import{select as $e,isCancel as M,log as v,multiselect as Re,text as xe,confirm as Pe,spinner as K,intro as ie,cancel as je,outro as _}from"@clack/prompts";import{GLOBAL_DIR as _e,VARIABLES_FILE_SUFFIX as Ne,TOKENS_FILE_SUFFIX as ae,tokenProcessingPipeline as Ae,SUGARCUBE_CONFIG_FILE as b,loadConfig as L,DEFAULT_STYLES_PATH as V,DEFAULT_DESIGN_TOKENS_PATH as Oe,generateCSSVariables as H,writeCSSVariablesToDisk as q,generateIndex as B,generateCSSUtilityClasses as ce,writeCSSUtilitiesToDisk as le,SUGARCUBE_FILE as Ue,validateConfig as Le,DEFAULT_CONFIG as ue,normalizeConfig as Ge}from"@sugarcube-org/core";import w from"picocolors";import We from"node-fetch";import{z as d}from"zod";import J,{mkdir as $,writeFile as N}from"node:fs/promises";import{execa as Me}from"execa";import{detect as Be}from"@antfu/ni";import I,{resolve as Je}from"node:path";import Q from"fast-glob";var ze="0.0.0-alpha.16",Ke={version:ze};class m extends Error{static{a(this,"CLIError")}constructor(t,n){super(t),this.name="CLIError",this.cause=n}}class z extends m{static{a(this,"ValidationError")}constructor(t,n,o,s){super(t),this.field=n,this.value=o,this.suggestion=s,this.name="ValidationError"}}class X extends m{static{a(this,"FileOperationError")}constructor(t,n,o,s){super(t),this.filePath=n,this.operation=o,this.cause=s,this.name="FileOperationError"}}const Y=d.enum(["react","astro-native","astro-enhanced","web-components"]),pe=d.object({path:d.string(),type:d.string()}),Ve=pe.extend({framework:Y});d.object({themes:d.record(d.string(),d.array(d.string())).optional()}).strict();const He=d.object({name:d.string(),type:d.string(),description:d.string().optional(),frameworks:d.array(d.string()).optional(),files:d.array(d.union([Ve,pe])),tokens:d.record(d.object({type:d.string(),mapping:d.string()})).optional(),dependencies:d.record(Y,d.array(d.string())).optional(),registryDependencies:d.record(Y,d.array(d.string())).optional(),tokenDependencies:d.array(d.string()).optional()}),qe=d.array(He),Qe=d.object({content:d.string()}),C={error:w.red,warn:w.yellow,info:w.cyan,success:w.green,bold:w.bold,path:w.cyan},fe=process.env.REGISTRY_URL??"https://sugarcube.sh/r";async function me(e){try{const t=await We(e);if(!t.ok){if(t.status===401)throw new m(`Registry access denied: Authentication required
3
- URL: ${C.info(e)}`);if(t.status===403)throw new m(`Registry access denied: Invalid or missing token
4
- URL: ${C.info(e)}`);if(t.status===404)throw new m(`Registry resource not found
5
- URL: ${C.info(e)}`);const n=await t.json().catch(()=>null),o=n&&typeof n=="object"&&"error"in n?n.error:t.statusText;throw new m(`Registry request failed: ${o}
6
- URL: ${C.info(e)}`)}return t.json()}catch(t){throw t instanceof m?t:new m(`Failed to connect to registry
7
- URL: ${C.info(e)}
8
- Check your internet connection`)}}a(me,"fetchRegistry");async function A(){const e=`${fe}/index.json`,t=await me(e);try{return qe.parse(t)}catch{throw new m(`Invalid registry data received
9
- URL: ${C.info(e)}`)}}a(A,"getRegistryIndex");async function Z({type:e,name:t,framework:n}){const o=await A(),s=o.find(c=>c.type===e&&c.name===t);if(!s){const c=o.filter(i=>i.type===e).map(i=>i.name);throw new m(`${e} '${C.info(t)}' not found in registry
10
- Available ${e}s: ${c.join(", ")}`)}let r=s.files;e==="component"&&n&&(r=s.files.filter(c=>"framework"in c&&c.framework===n));const l=await Promise.all(r.map(async c=>{const i=`${fe}/${c.path}.json`,p=await me(i);try{const g=Qe.parse(p);return{path:c.path,type:c.type,framework:"framework"in c?c.framework:void 0,content:g.content}}catch{throw new m(`Invalid file content received
11
- File: ${C.info(c.path)}`)}}));return{item:s,files:l}}a(Z,"getRegistryFiles");async function de(e,t,n){const o=[],s=new Set;async function r(l){if(s.has(l))return;s.add(l);const c=e.find(p=>p.name===l);if(!c){const p=e.filter(g=>g.type==="component").map(g=>g.name).join(", ");throw new m(`Component '${l}' not found in registry
12
- Available components: ${p}`)}const i=c.registryDependencies?.[n]||[];for(const p of i)await r(p);o.push(c)}a(r,"resolveComponent");for(const l of t)await r(l);return o}a(de,"resolveTree");async function Xe({cssOutputDirectory:e,selectedComponents:t,componentType:n,componentsOutputDirectory:o,tokensOutputDirectory:s}){const r={variableCSS:[],utilityCSS:[],componentFiles:[],componentCSS:[],cubeCSS:[],indexFiles:[]},l=await A(),i=(await de(l,t,n)).map(f=>f.name),p=l.filter(f=>f.type==="component").filter(f=>i.includes(f.name)),g=p.flatMap(f=>f.files.filter(u=>(u.type==="tsx"||u.type==="astro"||u.type==="njk")&&"framework"in u&&u.framework===n).map(u=>E(process.cwd(),h(o,f.name,`${f.name}.${u.type}`))));r.componentFiles=g.filter(f=>k(h(process.cwd(),f)));const y=p.flatMap(f=>{const u=f.name;return[E(process.cwd(),h(o,f.name,`${u}.css`)),E(process.cwd(),h(e,_e,`${u}${Ne}`))]});r.componentCSS=y.filter(f=>k(h(process.cwd(),f)));const S=p.flatMap(f=>{const u=f.name;return[E(process.cwd(),h(s,`${u}${ae}`)),E(process.cwd(),h(s,"components",`${u}${ae}`))]});return r.componentCSS.push(...S.filter(f=>k(h(process.cwd(),f)))),r}a(Xe,"collectComponentOverwriteWarnings");async function ge({cubeDirectory:e}){const t={variableCSS:[],utilityCSS:[],componentFiles:[],componentCSS:[],cubeCSS:[],indexFiles:[]},n=await A();if(!n)throw new m("Failed to fetch registry index");const o=n.filter(s=>s.type==="cube").flatMap(s=>s.files).map(s=>{const r=s.path.replace(/^styles\//,"");return E(process.cwd(),h(e,r))});return t.cubeCSS=o.filter(s=>k(h(process.cwd(),s))),t}a(ge,"collectCubeOverwriteWarnings");const ee={PROJECT_REQUIRED:`This command requires you to initialize a sugarcube project. Run ${w.cyan("make-sugarcube init")} first.
13
-
14
- For more information, visit: ${w.cyan("https://sugarcube.sh/docs/initialize")}`};function te(e){const t=[];if(e.variableCSS.length>0&&t.push(`CSS variables files:
15
- ${e.variableCSS.map(n=>` - ${n}`).join(`
2
+ var Je=Object.defineProperty;var o=(e,t)=>Je(e,"name",{value:t,configurable:!0});import{Command as L}from"commander";import{relative as R,join as $,basename as x,resolve as Q,dirname as qe,normalize as ze}from"pathe";import c from"picocolors";import{existsSync as N,readFileSync as ye}from"node:fs";import Ze from"node-fetch";import{z as m}from"zod";import se,{mkdir as W,writeFile as X,readFile as Qe}from"node:fs/promises";import{execa as Xe}from"execa";import{loadAndResolveTokens as et,validateConfig as tt,configFileExists as v,loadInternalConfig as ee,loadUserConfig as nt,processAndConvertTokens as oe,generateCSSVariables as Te,writeCSSVariablesToDisk as Se,writeCSSUtilitiesToDisk as Ie,convertConfigToUnoRules as st,DEFAULT_STYLES_PATH as ot,DEFAULT_CONFIG as re,fillDefaults as rt}from"@sugarcube-org/core";import it from"is-unicode-supported";import ie,{resolve as at}from"node:path";import{select as ct,isCancel as ae,log as lt,multiselect as ut,confirm as ft,cancel as ke}from"@clack/prompts";import{getColumns as pt}from"@clack/core";import{wrapAnsi as dt}from"fast-wrap-ansi";import*as Ee from"node:readline";import be from"node:readline";import{createLogUpdate as Ce}from"log-update";import{detect as gt}from"@antfu/ni";import{getTsconfig as mt}from"get-tsconfig";import{createGenerator as ht}from"@unocss/core";import G from"fast-glob";var wt="0.0.0-alpha.17",yt={version:wt};const ce="fluid",$e="**/*.json",Re="@sugarcube-org/vite",Tt=["node_modules",".git",".next","dist","build"],St=5,A={INIT:"make-sugarcube init",COMPONENTS:"make-sugarcube components",GENERATE:"make-sugarcube generate",CUBE:"make-sugarcube cube"},It={INITIALIZATION:"https://sugarcube.sh/docs/getting-started/getting-started"},w={PROJECT_REQUIRED:`No sugarcube project detected. Please run ${c.cyan(A.INIT)} first.
3
+
4
+ For more information, visit: ${c.cyan(It.INITIALIZATION)}`,CONFIG_EXISTS:o(()=>`A sugarcube config file already exists in this projct.
5
+
6
+ To start over, remove it and run ${c.cyan(A.INIT)} again.`,"CONFIG_EXISTS"),PLUGIN_INSTALL_FAILED:o(e=>`Failed to install ${e.pluginToInstall} plugin.
7
+
8
+ This is usually a temporary issue. Try these steps:
9
+
10
+ 1. Run the command again
11
+ 2. Check your internet connection
12
+ 3. Install manually: ${e.packageManager} add ${e.pluginToInstall}
13
+
14
+ If the problem continues, please open an issue at:
15
+ https://github.com/sugarcube-org/sugarcube/issues`,"PLUGIN_INSTALL_FAILED"),INITIALIZATION_INCOMPLETE:o(()=>`The initialization process was not completed properly.
16
+ This is an internal error that should not occur.
17
+ Try running the \`init\` command again.
18
+
19
+ If the problem persists, please report this issue at
20
+ https://github.com/sugarcube-org/sugarcube/issues`,"INITIALIZATION_INCOMPLETE"),CONFIG_WRITE_FAILED:o(()=>"Failed to write configuration file. Check permissions and try again.","CONFIG_WRITE_FAILED"),DIRECTORY_PATH_EMPTY:o(e=>`${e} cannot be empty. Please provide a valid directory path.`,"DIRECTORY_PATH_EMPTY"),DIRECTORY_PATH_RESERVED:o((e,t)=>`Option: ${e}
21
+ Value: "${t}"
22
+
23
+ ${e} cannot be in a reserved directory`,"DIRECTORY_PATH_RESERVED"),KIT_INCOMPLETE:o(()=>`The starter kit appears to be incomplete or corrupted.
24
+
25
+ This is likely a temporary issue. Please try running the command again or choose a different starter kit.`,"KIT_INCOMPLETE"),REGISTRY_AUTH_REQUIRED:o(e=>`Registry access denied: Authentication required
26
+ URL: ${c.cyan(e)}`,"REGISTRY_AUTH_REQUIRED"),REGISTRY_AUTH_INVALID:o(e=>`Registry access denied: Invalid or missing token
27
+ URL: ${c.cyan(e)}`,"REGISTRY_AUTH_INVALID"),REGISTRY_NOT_FOUND:o(e=>`Registry resource not found
28
+ URL: ${c.cyan(e)}`,"REGISTRY_NOT_FOUND"),REGISTRY_REQUEST_FAILED:o((e,t)=>`Registry request failed: ${e}
29
+ URL: ${c.cyan(t)}`,"REGISTRY_REQUEST_FAILED"),REGISTRY_NETWORK_ERROR:o(e=>`Failed to connect to registry
30
+
31
+ URL: ${c.cyan(e)}
32
+
33
+ The registry server may be temporarily unavailable or there might be network connectivity issues. Please try again in a few minutes.`,"REGISTRY_NETWORK_ERROR"),REGISTRY_INVALID_DATA:o(e=>`Invalid registry data received
34
+ URL: ${c.cyan(e)}`,"REGISTRY_INVALID_DATA"),REGISTRY_ITEM_NOT_FOUND:o((e,t,n)=>`${e==="tokens"?"Starter kit":e}'${c.cyan(t)} ' not found in registry
35
+ Available ${e==="tokens"?"starter kit":e}s: ${n.join(", ")}`,"REGISTRY_ITEM_NOT_FOUND"),REGISTRY_FILE_INVALID:o(e=>`Invalid file content received
36
+ File: ${c.cyan(e)}`,"REGISTRY_FILE_INVALID"),STARTER_KIT_UNAVAILABLE:o(e=>`Starter kit '${c.cyan(e)}' is currently unavailable.
37
+
38
+ Please try a different starter kit or run the command again in a few minutes.`,"STARTER_KIT_UNAVAILABLE"),TOKEN_LOAD_FAILED:o(e=>`Failed to load token files:
39
+
40
+ ${e.join(`
41
+ `)}
42
+
43
+ Please check your token files and try again.`,"TOKEN_LOAD_FAILED"),TOKEN_VALIDATION_FAILED:o(e=>{let t=`Token validation failed:
44
+
45
+ `;for(const[n,s]of e){t+=`Error(s) in ${c.cyan(n)}:
46
+ `;for(const r of s)t+=` - ${r}
47
+ `;t+=`
48
+ `}return t+=`See ${c.cyan("https://sugarcube.sh/docs/design-tokens")} for valid token formats`,t},"TOKEN_VALIDATION_FAILED"),TOKEN_FILE_INVALID_JSON:o(e=>`File ${e}: Invalid JSON syntax`,"TOKEN_FILE_INVALID_JSON"),TOKEN_FILE_INCOMPLETE_JSON:o(e=>`File ${e}: Incomplete JSON file`,"TOKEN_FILE_INCOMPLETE_JSON"),TOKEN_FILE_GENERIC_ERROR:o((e,t)=>`File ${e}: ${t}`,"TOKEN_FILE_GENERIC_ERROR"),DEPENDENCY_INSTALL_FAILED:o(e=>`Failed to install dependencies using ${e}.
49
+ Please check your package manager configuration and try again.`,"DEPENDENCY_INSTALL_FAILED"),VALIDATE_NO_PATH_SPECIFIED:o(()=>`No path specified.
50
+
51
+ Run ${c.cyan("make-sugarcube validate --help")} for more information.`,"VALIDATE_NO_PATH_SPECIFIED"),VALIDATE_PATH_NOT_FOUND:o(e=>`Path not found: ${e}
52
+
53
+ Please check that the specified path exists`,"VALIDATE_PATH_NOT_FOUND"),VALIDATE_NO_TOKEN_FILES:o(()=>`No token files found.
54
+
55
+ Please ensure the path contains .json token files`,"VALIDATE_NO_TOKEN_FILES"),COMPONENTS_FRAMEWORK_REQUIRED:o(()=>`Framework is required when specifying components. Use --framework to specify a framework (react, css-only) or run without arguments for interactive mode.
56
+
57
+ See ${c.cyan("https://sugarcube.sh/docs/cli/components")} for more information.`,"COMPONENTS_FRAMEWORK_REQUIRED"),COMPONENTS_INVALID_FRAMEWORK:o(()=>"Invalid framework. Must be one of: react, css-only.","COMPONENTS_INVALID_FRAMEWORK"),COMPONENTS_DIRECTORY_NOT_CONFIGURED:o(()=>"Components directory must be configured in non-interactive mode. Please run the 'components' command without arguments first.","COMPONENTS_DIRECTORY_NOT_CONFIGURED"),PLUGIN_DETECTED:o(e=>`Plugin detected: ${e}
58
+
59
+ The 'generate' command is for manual generation without plugins. Since you have a plugin installed, use your development server instead:
60
+
61
+ npm run dev # or your framework's dev command
62
+
63
+ The plugin will automatically generate CSS with hot module replacement.`,"PLUGIN_DETECTED")};class g extends Error{static{o(this,"CLIError")}constructor(t,n){super(t),this.name="CLIError",this.cause=n}}const le=m.enum(["react","web-components","css-only"]),_e=m.object({path:m.string(),type:m.string()}),kt=_e.extend({framework:le});m.object({themes:m.record(m.string(),m.array(m.string())).optional()}).strict();const Et=m.object({name:m.string(),type:m.string(),description:m.string().optional(),frameworks:m.array(m.string()).optional(),files:m.array(m.union([kt,_e])),tokens:m.record(m.object({type:m.string(),mapping:m.string()})).optional(),dependencies:m.record(le,m.array(m.string())).optional(),registryDependencies:m.record(le,m.array(m.string())).optional(),tokenDependencies:m.array(m.string()).optional()}),bt=m.array(Et),Ct=m.object({content:m.string()}),De=process.env.REGISTRY_URL??"https://sugarcube.sh/r";async function ve(e){try{const t=await Ze(e);if(!t.ok){if(t.status===401)throw new g(w.REGISTRY_AUTH_REQUIRED(e));if(t.status===403)throw new g(w.REGISTRY_AUTH_INVALID(e));if(t.status===404)throw new g(w.REGISTRY_NOT_FOUND(e));const n=await t.json().catch(()=>null),s=n&&typeof n=="object"&&"error"in n?String(n.error):t.statusText;throw new g(w.REGISTRY_REQUEST_FAILED(s,e))}return t.json()}catch(t){throw t instanceof g?t:new g(w.REGISTRY_NETWORK_ERROR(e))}}o(ve,"fetchRegistry");async function M(){const e=`${De}/index.json`,t=await ve(e);try{return bt.parse(t)}catch{throw new g(w.REGISTRY_INVALID_DATA(e))}}o(M,"getRegistryIndex");async function ue({type:e,name:t,framework:n}){const s=await M(),r=s.find(a=>a.type===e&&a.name===t);if(!r){const a=s.filter(l=>l.type===e).map(l=>l.name);throw new g(w.REGISTRY_ITEM_NOT_FOUND(e,t,a))}let i=r.files;e==="component"&&n&&(i=r.files.filter(a=>"framework"in a&&a.framework===n));const u=await Promise.all(i.map(async a=>{const l=`${De}/${a.path}.json`,f=await ve(l);try{const p=Ct.parse(f);return{path:a.path,type:a.type,framework:"framework"in a?a.framework:void 0,content:p.content}}catch{throw new g(w.REGISTRY_FILE_INVALID(a.path))}}));return{item:r,files:u}}o(ue,"getRegistryFiles");async function $t(e){const t=await ue({type:"tokens",name:e});if(!t.files[0])throw new g(w.STARTER_KIT_UNAVAILABLE(e));return t}o($t,"fetchStarterKit");async function fe(e,t,n){const s=[],r=new Set;async function i(u){if(r.has(u))return;r.add(u);const a=e.find(f=>f.name===u);if(!a){const f=e.filter(p=>p.type==="component").map(p=>p.name).join(", ");throw new g(`Component '${u}' not found in registry
64
+ Available components: ${f}`)}const l=a.registryDependencies?.[n]||[];for(const f of l)await i(f);s.push(a)}o(i,"resolveComponent");for(const u of t)await i(u);return s}o(fe,"resolveTree");async function Rt({selectedComponents:e,componentType:t,componentsOutputDirectory:n}){const s={variableCSS:[],utilityCSS:[],componentFiles:[],componentCSS:[],cubeCSS:[],indexFiles:[]},r=await M(),u=(await fe(r,e,t)).map(p=>p.name),a=r.filter(p=>p.type==="component").filter(p=>u.includes(p.name)),l=a.flatMap(p=>p.files.filter(d=>(d.type==="tsx"||d.type==="astro"||d.type==="njk")&&"framework"in d&&d.framework===t).map(d=>R(process.cwd(),$(n,p.name,`${p.name}.${d.type}`))));s.componentFiles=l.filter(p=>N($(process.cwd(),p)));const f=a.map(p=>{const d=p.name;return R(process.cwd(),$(n,p.name,`${d}.css`))});return s.componentCSS=f.filter(p=>N($(process.cwd(),p))),s}o(Rt,"collectComponentOverwriteWarnings");async function _t({cubeDirectory:e}){const t={variableCSS:[],utilityCSS:[],componentFiles:[],componentCSS:[],cubeCSS:[],indexFiles:[]},s=(await M()).filter(r=>r.type==="cube").flatMap(r=>r.files).map(r=>{const i=r.path.replace(/^styles\//,"");return R(process.cwd(),$(e,i))});return t.cubeCSS=s.filter(r=>N($(process.cwd(),r))),t}o(_t,"collectCubeOverwriteWarnings");function Ae(e){const t=[];if(e.variableCSS.length>0&&t.push(`CSS variables files:
65
+ ${e.variableCSS.map(s=>` - ${s}`).join(`
16
66
  `)}`),e.utilityCSS.length>0&&t.push(`CSS utility files:
17
- ${e.utilityCSS.map(n=>` - ${n}`).join(`
67
+ ${e.utilityCSS.map(s=>` - ${s}`).join(`
18
68
  `)}`),e.cubeCSS.length>0&&t.push(`CUBE CSS files:
19
- ${e.cubeCSS.map(n=>` - ${n}`).join(`
20
- `)}`),e.componentFiles.length>0||e.componentCSS.length>0){const n=[...e.componentFiles,...e.componentCSS];t.push(`Component files:
21
- ${n.map(o=>` - ${o}`).join(`
22
- `)}`)}if(e.indexFiles.length>0&&t.push(`Index files:
23
- ${e.indexFiles.map(n=>` - ${n}`).join(`
24
- `)}`),t.length!==0)return w.yellow(`WARNING: The following file(s) already exist and will be OVERWRITTEN:
25
-
26
- ${w.dim(t.join(`
27
-
28
- `))}`)}a(te,"formatOverwriteWarnings");function Ye(e){return typeof e.tokens=="object"&&!("source"in e.tokens)}a(Ye,"hasCollections$1");async function Ze(e){if(Ye(e)){const t=e.tokens;return"components"in t?!1:(t.components={source:["components/*.tokens.json"]},!0)}return!1}a(Ze,"handleComponentTokenIntegration");const D={error(...e){console.log(C.error(e.join(" ")))},warn(...e){console.log(C.warn(e.join(" ")))},info(...e){console.log(C.info(e.join(" ")))},success(...e){console.log(C.success(e.join(" ")))},log(...e){console.log(e.join(" "))},break(){console.log("")}};function et(...e){process.env.DEBUG==="true"&&process.stderr.write(`[sugarcube:debug] ${e.map(String).join(" ")}
29
- `)}a(et,"debugLog");function G(e){if(D.break(),e instanceof m){const t=e.message.split(`
30
- `);if(t.length>1){D.error(t[0]),D.break();for(const n of t.slice(1))D.error(` ${n.trim()}`)}else D.error(e.message);process.env.DEBUG&&e.cause&&D.info(`
31
- Caused by:`,e.cause)}else D.error(`An unexpected error occurred: ${e instanceof Error?e.message:String(e)}
32
- If this issue persists, please report it: ${w.cyanBright("https://github.com/sugarcube-org/sugarcube/issues")}`),process.env.DEBUG&&D.info(`
33
- Error details:`,e);D.break(),process.exit(0)}a(G,"handleError");async function tt(e,{withFallback:t=!1}={}){const n=await Be({programmatic:!0,cwd:e});if(n?.startsWith("yarn@"))return"yarn";if(n?.startsWith("pnpm@"))return"pnpm";if(n==="bun")return"bun";if(!t)return n?.split("@")[0]??"npm";const o=process.env.npm_config_user_agent||"";return o.startsWith("yarn")?"yarn":o.startsWith("pnpm")?"pnpm":o.startsWith("bun")?"bun":"npm"}a(tt,"getPackageManager");async function we(e,t){const n=await tt(t,{withFallback:!0}),o=n==="npm"?"install":"add";try{await Me(n,[o,...e],{cwd:t})}catch{const r=`Failed to install dependencies using ${n}.
34
-
35
- This might be because you're using 'npx' with a pnpm project. Try:
36
- pnpm dlx make-sugarcube components
37
-
38
- Or use the appropriate package runner for your project:
39
- npm: npx make-sugarcube components
40
- pnpm: pnpm dlx make-sugarcube components
41
- yarn: yarn dlx make-sugarcube components
42
- bun: bunx make-sugarcube components`;throw new Error(r)}}a(we,"installDependencies");function nt(e){const t=h(e,"blocks");return k(t)}a(nt,"hasBlocksDirectory");function st(e){return typeof e.tokens=="object"&&!("source"in e.tokens)}a(st,"hasCollections");async function ot(e,t,n){const{hasCollectionsMode:o,useBlocksDir:s,componentsOutputDirectory:r,cssOutputDirectory:l,tokensOutputDirectory:c}=n;if(e.path.endsWith(".tokens.json")){const g=o?h(c,"components",`${t.name}.tokens.json`):h(c,`${t.name}.tokens.json`);return await N(g,e.content),g}if(e.path.endsWith(".css")){if(s){const S=h(l,"blocks",`${t.name}.css`);return await N(S,e.content),S}const g=h(r,t.name);await $(g,{recursive:!0});const y=h(g,`${t.name}.css`);return await N(y,e.content),y}const i=h(r,t.name);await $(i,{recursive:!0});const p=h(i,U(e.path));return await N(p,e.content),p}a(ot,"writeComponentFile");async function rt({registryIndex:e,selectedComponents:t,componentType:n,componentsOutputDirectory:o,cssOutputDirectory:s,tokensOutputDirectory:r,config:l,overwrite:c}){const i=[],p=new Set,g=nt(s),y=st(l);if(await $(o,{recursive:!0}),await $(r,{recursive:!0}),y){const f=h(r,"components");await $(f,{recursive:!0})}const S=await de(e,t,n);for(const f of S){const u=await Z({type:"component",name:f.name,framework:n});for(const x of u.files)if(x)try{const P=await ot(x,f,{hasCollectionsMode:y,useBlocksDir:g,componentsOutputDirectory:o,cssOutputDirectory:s,tokensOutputDirectory:r});i.push(P)}catch(P){const be=P instanceof Error?`: ${P.message}`:"";throw new m(`Failed to write component file for "${f.name}"${be}`)}const W=f.dependencies?.[n]||[];for(const x of W)p.add(x)}if(p.size>0)try{await we(Array.from(p),process.cwd())}catch(f){const u=f instanceof Error?`: ${f.message}`:"";throw new m(`Failed to install component dependencies${u}`)}return{createdFiles:i,npmDependencies:p}}a(rt,"installComponents");async function it(e="src/ui/components"){const t=await xe({message:"Save components to",placeholder:e,validate:a(n=>{if(n.trim().replace(/['"]/g,"").length===0)return"Output directory cannot be empty"},"validate")});return M(t)&&process.exit(0),I.relative(process.cwd(),I.resolve(process.cwd(),t))}a(it,"promptComponentDirectory");async function he(e=!0){const t=[{label:"React",value:"react",hint:".tsx"},{label:"Astro (Native)",value:"astro-native",hint:"Minimal, standards-based .astro; uses native HTML features"},{label:"Astro (Enhanced)",value:"astro-enhanced",hint:"Advanced features, richer client-side logic - coming soon"},{label:"Web Components",value:"web-components",hint:"Native web components using TypeScript - coming soon"}];e&&t.push({label:"Skip",value:"skip",hint:"continue without components"});const n=await $e({message:"Build with",options:t});return M(n)&&process.exit(0),n==="astro-enhanced"||n==="web-components"?(v.info(w.blue("Sorry, this framework is coming soon! Please choose 'Astro (Native)' or 'React' for now.")),he(e)):n}a(he,"promptComponentFramework");async function at(e,t){const n=e.filter(s=>s.type==="component"&&s.frameworks?.includes(t)),o=await Re({message:"Select components to add",options:n.map(s=>({label:s.name,value:s.name,hint:s.description})),required:!0});return M(o)&&process.exit(0),o}a(at,"promptComponentSelectionFiltered");async function ne(e,t=!1){const n=await Pe({message:e,initialValue:t});return(!n||M(n))&&process.exit(0),!0}a(ne,"confirmOverwrite");function se(e){const t=e.generated,o=[...new Set(t)].map(r=>I.relative(process.cwd(),r)),s=K();s.start(`Writing ${o.length} files:`),s.stop(`Wrote ${o.length} files:`);for(const r of o)D.log(` - ${r}`);D.break()}a(se,"showSummary");async function O(e,t){const n=t?{type:"memory",data:t,config:e}:{type:"files",config:e},{trees:o,resolved:s,errors:r}=await Ae(n);if(r.load.length>0)throw new m(`Failed to load token files:
43
- ${r.load.map(l=>`${l.file}: ${l.message}`).join(`
44
- `)}`);if(r.validation.length>0||r.flatten.length>0||r.resolution.length>0){D.break();const l=[...r.flatten,...r.validation,...r.resolution],c=new Map;for(const i of l)if(i.source?.sourcePath){const p=c.get(i.source.sourcePath)||[];p.push(i.message),c.set(i.source.sourcePath,p)}for(const[i,p]of c){D.error(`Error(s) in ${C.path(i)}:`);for(const g of p)D.error(` - ${g}`);D.break()}throw new m(`Token validation failed. See ${C.info("https://sugarcube.sh/docs/design-tokens")} for valid token formats`)}return{trees:o,resolved:s}}a(O,"processTokensForCLI");async function ye(e){const t={$schema:"https://sugarcube.sh/r/schema.json",...e};try{const n=JSON.stringify(t,null,2);await N(b,n)}catch(n){const o=n instanceof Error?`: ${n.message}`:"";throw new m(`Failed to write config file${o}`)}}a(ye,"writeConfig");async function ct(e,t,n,o,s,r,l){const c=await A(),{createdFiles:i}=await rt({registryIndex:c,selectedComponents:e,componentType:t,componentsOutputDirectory:n,cssOutputDirectory:o,tokensOutputDirectory:s,config:r,overwrite:l});return i}a(ct,"installComponentFiles");const lt=new j().name("components").description("Add components to your project").argument("[components...]","Components to add (e.g., button card)").option("-f, --framework <type>","Framework to use (react, astro-native)").option("-s, --silent","Suppress logs and prompts").option("-o, --overwrite","Overwrite existing files").action(async(e,t)=>{try{if(t.silent||ie(w.inverse(" Add components ")),!k(b))throw new m(ee.PROJECT_REQUIRED);const{config:n}=await L();let o,s=[],r;if(e.length>0||t.framework){if(!t.framework)throw new m(`Framework is required when specifying components. Use --framework to specify a framework (react, astro-native) or run without arguments for interactive mode.
45
-
46
- See ${w.cyan("https://docs.sugarcube.sh/cli/components")} for more information.`);if(!["react","astro-native"].includes(t.framework))throw new m("Invalid framework. Must be one of: react, astro-native.");if(r=t.framework,s=e,!n.output?.components)throw new m("Components directory must be configured in non-interactive mode. Please run the 'components' command without arguments first.");o=F(process.cwd(),n.output.components)}else{r=await he(!1);const y=await A();if(y||(je("Failed to fetch component list"),process.exit(1)),s=await at(y,r),n.output?.components)o=F(process.cwd(),n.output.components);else{const S=await it();o=F(process.cwd(),S),n.output.components=E(process.cwd(),o),await ye(n)}}const l=F(process.cwd(),n.output?.css||V),c=F(process.cwd(),n.output?.tokens||Oe),i=await Xe({cssOutputDirectory:l,selectedComponents:s,componentType:r,componentsOutputDirectory:o,tokensOutputDirectory:c}),p=te(i);p&&!t.force&&!t.silent&&(v.warn(p),await ne("Continue?",!1));const g=K();g.start("Installing components...");try{const y=await ct(s,r,o,l,c,n,t.overwrite||!1);g.stop("Components installed successfully"),await Ze(n);const{trees:S,resolved:f}=await O(n),{output:u}=await H(S,f,n);await q(u),await B(l,n),t.silent||(se({generated:y}),_(w.greenBright("Success! Components installed \u2728")))}catch(y){throw g.stop("Installation failed"),y}}catch(n){G(n)}});async function ke(e){const t=[],n=F(process.cwd(),e);await $(n,{recursive:!0});const s=(await A()).filter(r=>r.type==="cube").map(r=>r.name);for(const r of s){const l=await Z({type:"cube",name:r});for(const c of l.files){if(!c)continue;const i=c.path.replace(/^styles\//,""),p=h(n,i),g=Ie(p);try{await $(g,{recursive:!0}),await N(p,c.content),t.push(p)}catch(y){const S=y instanceof Error?`: ${y.message}`:"";throw new m(`Failed to write CUBE module "${r}"${S}`)}}}return t}a(ke,"installCUBE");const ut=new j().name("cube").description("Add CUBE CSS to your project").option("-s, --silent","Suppress logs and prompts").option("-f, --force","Skip overwrite confirmation").action(async e=>{try{if(!k(b))throw new m(ee.PROJECT_REQUIRED);const{config:t}=await L(),n=F(process.cwd(),t.output?.css||V);try{await $(n,{recursive:!0})}catch(l){const c=l instanceof Error?`: ${l.message}`:"";throw new m(`Failed to create output directory${c}`)}const o=await ge({cubeDirectory:n}),s=te(o);s&&!e.force&&!e.silent&&(v.warn(s),await ne("Continue?",!1));const r=await ke(n);await B(n,t),e.silent||(se({generated:r}),_(w.greenBright("Success! CUBE CSS added successfully. \u2728")))}catch(t){G(t)}});async function pt(e,t,n){const o=[],{output:s}=await H(e,t,n);await q(s),o.push(...s);const{output:r}=ce(t,n);await le(r),o.push(...r);const l=await B(n.output?.css||V,n);return o.push({path:l,css:Ue}),o}a(pt,"generateAllCSS");const ft=new j().name("generate").description("Generate CSS from your design tokens").option("--force","Skip overwrite confirmation").option("-s, --silent","Suppress logs and prompts").action(async e=>{try{if(!k(b))throw new m(ee.PROJECT_REQUIRED);const{config:t}=await L(),{trees:n,resolved:o}=await O(t),s=await pt(n,o,t);e.silent||(se({generated:s.map(r=>r.path)}),_(w.greenBright("Success! CSS generated successfully. \u2728")))}catch(t){G(t)}}),mt=["**/node_modules/**",".next","public","dist","build",".astro",".nuxt",".output",".svelte-kit"],R={"next-app":{tokensDir:"app/design-tokens",stylesDir:"app/styles",componentDir:"app/components"},"next-pages":{tokensDir:"src/design-tokens",stylesDir:"src/styles",componentDir:"src/components"},astro:{tokensDir:"src/design-tokens",stylesDir:"src/styles",componentDir:"src/components"},vite:{tokensDir:"src/design-tokens",stylesDir:"src/styles",componentDir:"src/components"},nuxt:{tokensDir:"assets/design-tokens",stylesDir:"assets/styles",componentDir:"components"},sveltekit:{tokensDir:"src/lib/design-tokens",stylesDir:"src/lib/styles",componentDir:"src/lib/components"},remix:{tokensDir:"app/design-tokens",stylesDir:"app/styles",componentDir:"app/components"},eleventy:{tokensDir:"src/_data/design-tokens",stylesDir:"src/styles",componentDir:"src/components"},none:{tokensDir:"src/design-tokens",stylesDir:"src/styles",componentDir:"src/components"}};function dt(e){try{const t=I.resolve(e,"package.json");if(!k(t))return null;const n=re(t,"utf-8");return JSON.parse(n)}catch{return null}}a(dt,"getPackageJson");function gt(e){const t=["design-tokens","tokens","src/design-tokens","src/tokens","app/design-tokens","assets/design-tokens","src/_data/design-tokens","src/lib/design-tokens"],n=["styles","css","src/styles","src/css","app/styles","assets/styles","assets/css","src/lib/styles"],o=["components","src/components","app/components","src/lib/components"],s={};for(const r of t)if(k(I.resolve(e,r))){s.existingTokensDir=r;break}for(const r of n)if(k(I.resolve(e,r))){s.existingStylesDir=r;break}for(const r of o)if(k(I.resolve(e,r))){s.existingComponentsDir=r;break}return s}a(gt,"findExistingPaths");async function wt(e){const[t,n,o]=await Promise.all([Q.glob("**/{next,vite,astro,nuxt,svelte,remix,eleventy}.config.*|.eleventy.js",{cwd:e,deep:3,ignore:mt}),k(I.resolve(e,"src")),dt(e)]),s=gt(e),r=k(I.resolve(e,`${n?"src/":""}app`)),l={framework:"none",isSrcDir:n,tokensDir:"src/design-tokens",stylesDir:"src/styles",componentDir:"src/components"};if(t.find(i=>i.startsWith("next.config."))?.length){const i=r?"next-app":"next-pages",p=R[i];return{...l,framework:i,tokensDir:s.existingTokensDir||p.tokensDir,stylesDir:s.existingStylesDir||p.stylesDir,componentDir:s.existingComponentsDir||p.componentDir}}if(t.find(i=>i.startsWith("astro.config."))?.length){const i=R.astro;return{...l,framework:"astro",tokensDir:s.existingTokensDir||i.tokensDir,stylesDir:s.existingStylesDir||i.stylesDir,componentDir:s.existingComponentsDir||i.componentDir}}if(t.find(i=>i.startsWith("nuxt.config."))?.length){const i=R.nuxt;return{...l,framework:"nuxt",tokensDir:s.existingTokensDir||i.tokensDir,stylesDir:s.existingStylesDir||i.stylesDir,componentDir:s.existingComponentsDir||i.componentDir}}if(t.find(i=>i.startsWith("svelte.config."))?.length){const i=R.sveltekit;return{...l,framework:"sveltekit",tokensDir:s.existingTokensDir||i.tokensDir,stylesDir:s.existingStylesDir||i.stylesDir,componentDir:s.existingComponentsDir||i.componentDir}}if(Object.keys(o?.dependencies??{}).find(i=>i.startsWith("@remix-run/"))){const i=R.remix;return{...l,framework:"remix",tokensDir:s.existingTokensDir||i.tokensDir,stylesDir:s.existingStylesDir||i.stylesDir,componentDir:s.existingComponentsDir||i.componentDir}}if(t.find(i=>i.startsWith("eleventy.config.")||i.startsWith(".eleventy."))?.length){const i=R.eleventy;return{...l,framework:"eleventy",tokensDir:s.existingTokensDir||i.tokensDir,stylesDir:s.existingStylesDir||i.stylesDir,componentDir:s.existingComponentsDir||i.componentDir}}if(t.find(i=>i.startsWith("vite.config."))?.length){const i=R.vite;return{...l,framework:"vite",tokensDir:s.existingTokensDir||i.tokensDir,stylesDir:s.existingStylesDir||i.stylesDir,componentDir:s.existingComponentsDir||i.componentDir}}const c=R.none;return{...l,framework:"none",tokensDir:s.existingTokensDir||(n?c.tokensDir:"design-tokens"),stylesDir:s.existingStylesDir||(n?c.stylesDir:"styles"),componentDir:s.existingComponentsDir||(n?c.componentDir:"components")}}a(wt,"getProjectInfo");function ht(e){return{"next-app":"Next.js (App Router)","next-pages":"Next.js (Pages Router)",astro:"Astro",vite:"Vite",nuxt:"Nuxt",sveltekit:"SvelteKit",remix:"Remix",eleventy:"11ty (Eleventy)",none:"No framework"}[e]}a(ht,"getFrameworkDisplayName");async function yt(){k(b)&&(v.error(`A ${w.cyan(b)} file already exists at ${w.cyan(process.cwd())}.
47
- To start over, remove the ${w.cyan(b)} file and run ${w.cyan("init")} again.
48
- `),process.exit(1))}a(yt,"preflightInit");function kt(e,t=process.cwd()){try{const n=Je(t,"package.json");if(!k(n))return!1;const o=re(n,"utf-8"),s=JSON.parse(o),r={...s.dependencies,...s.devDependencies,...s.peerDependencies};return e in r}catch{return!1}}a(kt,"isPackageInstalled");const Dt=a(async(e,t,n)=>{const o=await Z({type:"tokens",name:e});if(!o.files[0])throw new m(`Starter kit '${e}' does not contain any token files`);const s=F(process.cwd(),t),r=o.files.find(u=>U(u.path)==="config.json");let l={};if(r)try{l=JSON.parse(r.content)}catch(u){et(`Could not parse config.json for starter kit '${e}':`,u)}const c=o.files.filter(u=>U(u.path)!=="config.json").map(u=>({path:h(s,U(u.path)),content:u.content})),i=Object.fromEntries(c.map(u=>[U(u.path),E(process.cwd(),u.path)])),p={};if(l.themes)for(const[u,W]of Object.entries(l.themes))p[u]=W.map(x=>{const P=i[x];if(!P)throw new m(`Theme file '${x}' not found in starter kit '${e}'`);return P});const g={...n};Object.keys(p).length>0&&typeof g.tokens=="object"&&!Array.isArray(g.tokens)&&"source"in g.tokens&&(g.tokens.themes=p);const y=Le(g),{trees:S,resolved:f}=await O(y,Object.fromEntries(c.map(u=>[u.path,{collection:"default",content:u.content}])));return{config:y,trees:S,resolved:f,tokensDir:s,tokenFiles:c,createdTokenPaths:c.map(u=>E(process.cwd(),u.path))}},"initializeFromStarterKit"),St="https://sugarcube.sh/r/schema.json",oe="tailwind-fluid",De="**/*.json",Se="@sugarcube-org/vite",ve="@sugarcube-org/postcss",vt=["node_modules",".git",".next","dist","build"],Ct=/^[a-zA-Z][a-zA-Z0-9_-]*$/,Et=5,T={LAUNCH_INITIATED:"Launch sequence initiated.",PREFLIGHT_COMPLETE:"\u2714 Preflight checks",PROJECT_DETECTED:a(e=>`\u2714 Project detected (${e})`,"PROJECT_DETECTED"),TOKENS_INSTALLED:"\u2714 Design tokens installed",TOKENS_CONFIGURED:"\u2714 Design tokens configured",CUBE_INSTALLED:"\u2714 CUBE CSS installed",CSS_VARS_GENERATED:"\u2714 CSS variables generated",UTILITIES_GENERATED:"\u2714 Utility classes generated",DEPS_INSTALLED:"\u2714 Dependencies installed",CONFIG_WRITTEN:a(e=>`\u2714 Config file written (${e})`,"CONFIG_WRITTEN"),SUGARCUBE_ENTRY_CREATED:a(e=>`\u2714 Sugarcube entry point created (${e})`,"SUGARCUBE_ENTRY_CREATED"),SUCCESS:"Success! Project initialized \u2728",CONTINUING_WITHOUT_PLUGIN:"\u2714 Continuing without plugin..."};async function bt(e){if(e.setupResult=await Dt(e.starterKit??"",e.tokensDir,e.config),e.setupResult.tokenFiles)for(const t of e.setupResult.tokenFiles)try{await J.writeFile(t.path,t.content),e.createdFiles.push(t.path)}catch(n){throw new X("Failed to write token file",t.path,"writeFile",n instanceof Error?n:void 0)}}a(bt,"downloadAndWriteTokenFiles");async function Tt(e){await bt(e),v.success(T.TOKENS_INSTALLED)}a(Tt,"installFromStarterKit");async function It(e){try{await J.mkdir(e.tokensDir,{recursive:!0}),e.createdDirectories.push(e.tokensDir),await J.mkdir(e.stylesDir,{recursive:!0}),e.createdDirectories.push(e.stylesDir)}catch(t){throw new X("Failed to create directories",e.tokensDir,"mkdir",t instanceof Error?t:void 0)}}a(It,"createProjectDirectories");async function Ft(e,t,n,o,s){return{options:e,...t,config:n,minimalUserConfig:o,...s,createdFiles:[],createdDirectories:[],installedDependencies:[]}}a(Ft,"buildInitContext");function Ce(e,t){if(!e||e.trim()==="")throw new z(`${t} cannot be empty`,t,e,'Provide a valid directory path like "src/styles"');const n=Fe(e);if(n.includes("../")||n.startsWith("/"))throw new z(`${t} should be a relative path within your project`,t,e,`Use a relative path like "src/styles" instead of "${e}"`);const o=n.split("/")[0];if(o&&vt.includes(o))throw new z(`${t} cannot be in a reserved directory`,t,e,`Avoid using ${o}. Try "src/styles" or "assets/styles" instead`)}a(Ce,"validateDirectoryPath");function $t(e){if(e.tokensDir&&Ce(e.tokensDir,"tokens-dir"),e.stylesDir&&Ce(e.stylesDir,"styles-dir"),e.kit&&!Ct.test(e.kit))throw new z("Kit name contains invalid characters","kit",e.kit,'Use only letters, numbers, hyphens, and underscores. Try "tailwind-fluid" or "tailwind-static"')}a($t,"validateOptions");function Ee(e,t=0){if(typeof e!="object"||e===null||t>Et)return!1;for(const[n,o]of Object.entries(e))if(!n.startsWith("$")&&typeof o=="object"&&o!==null&&("$value"in o||Ee(o,t+1)))return!0;return!1}a(Ee,"hasAnyToken");async function Rt(e){try{const t=await Q(De,{cwd:e,absolute:!0});for(const n of t)try{const o=await J.readFile(n,"utf-8"),s=JSON.parse(o);if(Ee(s))return!0}catch{}return!1}catch{return!1}}a(Rt,"detectExistingTokens");function xt(e){return{source:[h(E(process.cwd(),e.actualTokensDir),De)]}}a(xt,"createSingleTokenCollection");async function Pt(e){return xt(e)}a(Pt,"buildTokensConfig");async function jt(e){const t=await Pt(e),n=E(process.cwd(),e.actualStylesDir),o=E(process.cwd(),e.actualTokensDir),s={$schema:St,tokens:t},r={};return n!==ue.output.css&&(r.css=n),o!==ue.output.tokens&&(r.tokens=o),Object.keys(r).length>0&&(s.output=r),s}a(jt,"generateMinimalConfig");function _t(e){return e==="next-app"||e==="next-pages"?ve:Se}a(_t,"selectPluginForFramework");async function Nt(e){await yt();const t=await wt(process.cwd());v.success(T.PREFLIGHT_COMPLETE),v.success(T.PROJECT_DETECTED(ht(t.framework)));const n=e.tokensDir||t.tokensDir,o=e.stylesDir||t.stylesDir,s=await Rt(n);return{projectInfo:t,tokensDir:n,stylesDir:o,hasExistingTokens:s}}a(Nt,"initializeProjectContext");function At(e,t,n){let o=null;n||(o=e.kit||oe);let s=null;e.plugin==="auto"||!e.plugin?s=_t(t.framework):e.plugin==="vite"?s=Se:e.plugin==="postcss"&&(s=ve);const r=e.cube!==!1;return{starterKit:o,pluginToInstall:s,installCube:r}}a(At,"determineInstallationTargets");async function Ot(e){if(!e.installCube)return;const t=await ge({cubeDirectory:e.stylesDir}),n=te(t);n&&(v.warn(n),await ne("Continue and overwrite existing files?",!1))}a(Ot,"checkConflicts");async function Ut(e){const{trees:t,resolved:n}=await O(e.config);e.setupResult={config:e.config,createdTokenPaths:[],trees:t,resolved:n,tokenFiles:[],tokensDir:e.tokensDir},v.success(T.TOKENS_CONFIGURED)}a(Ut,"processExistingTokens");async function Lt(e){!e.hasExistingTokens&&e.starterKit?await Tt(e):await Ut(e)}a(Lt,"setupDesignTokens");async function Gt(e){e.installCube&&(await ke(e.stylesDir),v.success(T.CUBE_INSTALLED))}a(Gt,"installCubeFiles");async function Wt(e){if(!e.setupResult)throw new m("Initialization incomplete. Please re-run the `init` command.");const{trees:t,resolved:n}=e.setupResult,{output:o}=await H(t,n,e.config);await q(o);const{output:s}=ce(n,e.config);await le(s),await B(e.stylesDir,e.config)}a(Wt,"writeStyles");async function Mt(e){if(!e.pluginToInstall)return;if(kt(e.pluginToInstall)){v.success(T.DEPS_INSTALLED);return}const t=K();t.start(`Installing ${e.pluginToInstall.split("/")[1]} plugin...`);try{await we([e.pluginToInstall],process.cwd()),e.installedDependencies.push(e.pluginToInstall),t.stop(T.DEPS_INSTALLED)}catch{t.stop(""),v.warn(w.yellow(`Failed to install ${e.pluginToInstall}. Install manually: npm install ${e.pluginToInstall}`)),v.info(T.CONTINUING_WITHOUT_PLUGIN)}}a(Mt,"installPlugins");async function Bt(e){try{await ye(e.minimalUserConfig),e.createdFiles.push(b),v.success(T.CONFIG_WRITTEN(b))}catch(t){throw new X("Failed to write configuration file",b,"writeFile",t instanceof Error?t:void 0)}_(w.greenBright(T.SUCCESS))}a(Bt,"finalize");const Jt=new j().name("init").description("Initialize a new sugarcube project").option("--kit <kit>",`Starter kit to use (default: ${oe})`,oe).option("--tokens-dir <dir>","Design tokens directory (e.g., 'src/design-tokens')").option("--styles-dir <dir>","Styles output directory (e.g., 'src/styles')").option("--plugin <type>","Plugin to install: vite, postcss, none, or auto (default: auto)","auto").option("--no-cube","Don't install CUBE CSS").action(async e=>{let t;try{$t(e);const n=await Nt(e),o=await jt({actualTokensDir:n.tokensDir,actualStylesDir:n.stylesDir}),r={...Ge(o),$schema:o.$schema},l=o,c=At(e,n.projectInfo,n.hasExistingTokens);t=await Ft(e,n,r,l,c),await Ot(t),await It(t),await Lt(t),await Gt(t),await Mt(t),await Wt(t),await Bt(t)}catch(n){G(n)}}),zt=new j().name("validate").description("Validate design token files").argument("[paths...]","Token files or directories to validate (e.g., src/design-tokens)").action(async e=>{try{if(ie(w.inverse(" Validate design tokens ")),k(b)&&!e.length){const{config:o}=await L();await O(o),_(w.greenBright("All tokens are valid \u2728"));return}if(!e.length)throw new m("No paths specified. Please provide files/directories to validate, or run this in a sugarcube project directory.");for(const o of e)if(!k(o))throw new m(`Path not found: ${o}
49
- Please check that the specified files or directories exist`);const t=await Q(e.map(o=>o.endsWith(".json")?o:h(o,"**/*.json")));if(t.length===0)throw new m(`No JSON files found in the specified paths
50
- Please ensure the paths contain .json files`);const n=k(b)?(await L()).config:{tokens:{source:[]},output:{tokens:".",css:".",separate:!1}};await O({...n,tokens:{source:t.map(o=>E(process.cwd(),o))}}),_(w.greenBright("All tokens are valid \u2728"))}catch(t){G(t)}});process.on("SIGINT",()=>process.exit(0)),process.on("SIGTERM",()=>process.exit(0));async function Kt(){const e=new j().name("sugarcube").description("CLI for scaffolding sugarcube projects"),t=process.argv[2];(!t||!["init","generate","validate","components","cube"].includes(t))&&e.version(Ke.version,"-v, --version","display the version number"),e.addCommand(Jt).addCommand(ft).addCommand(zt).addCommand(lt).addCommand(ut),e.parse()}a(Kt,"main"),Kt();
69
+ ${e.cubeCSS.map(s=>` - ${s}`).join(`
70
+ `)}`),e.componentFiles.length>0||e.componentCSS.length>0){const s=[...e.componentFiles,...e.componentCSS];t.push(`Component files:
71
+ ${s.map(r=>` - ${r}`).join(`
72
+ `)}`)}return e.indexFiles.length>0&&t.push(`Index files:
73
+ ${e.indexFiles.map(s=>` - ${s}`).join(`
74
+ `)}`),t.length===0?void 0:`The following file(s) already exist and will be overwritten:
75
+
76
+ ${t.join(`
77
+
78
+ `)}`}o(Ae,"formatOverwriteWarnings");async function pe(e,t,n){if(e.length===0)return;const s=n==="npm"?"install":"add";try{await Xe(n,[s,...e],{cwd:t})}catch{throw new g(w.DEPENDENCY_INSTALL_FAILED(n))}}o(pe,"installDependencies");async function Dt(e,t,n){const s=$(n,t.name);if(await W(s,{recursive:!0}),e.path.endsWith(".css")){const i=$(s,`${t.name}.css`);return await X(i,e.content),i}const r=$(s,x(e.path));return await X(r,e.content),r}o(Dt,"writeComponentFile");async function vt({registryIndex:e,selectedComponents:t,componentType:n,componentsOutputDirectory:s,packageManager:r}){const i=[],u=new Set;await W(s,{recursive:!0});const a=await fe(e,t,n);for(const l of a){const f=await ue({type:"component",name:l.name,framework:n});for(const d of f.files)if(d)try{const h=await Dt(d,l,s);h&&i.push(h)}catch(h){const E=h instanceof Error?`: ${h.message}`:"";throw new g(`Failed to write component file for "${l.name}"${E}`)}const p=l.dependencies?.[n]||[];for(const d of p)u.add(d)}if(u.size>0)try{await pe(Array.from(u),process.cwd(),r)}catch(l){const f=l instanceof Error?`: ${l.message}`:"";throw new g(`Failed to install component dependencies${f}`)}return{createdFiles:i,npmDependencies:u}}o(vt,"installComponents");async function At(e){const t=[],n=Q(process.cwd(),e);await W(n,{recursive:!0});const r=(await M()).filter(i=>i.type==="cube").map(i=>i.name);for(const i of r){const u=await ue({type:"cube",name:i});for(const a of u.files){if(!a)continue;const l=a.path.replace(/^styles\//,""),f=$(n,l),p=qe(f);try{await W(p,{recursive:!0}),await X(f,a.content),t.push(f)}catch(d){const h=d instanceof Error?`: ${d.message}`:"";throw new g(`Failed to write CUBE module "${i}"${h}`)}}}return t}o(At,"installCUBE");async function Ft(e,t){await se.mkdir(t,{recursive:!0});const n=[];for(const s of e)await se.writeFile(s.path,s.content),n.push(s.path);return n}o(Ft,"writeTokenFiles");async function B(e,t){const n={type:"files",config:e},{trees:s,resolved:r,errors:i}=await et(n);if(i.load.length>0){const u=i.load.map(a=>{const l=a.file.split("/").pop()||"unknown file";let f=`File ${l}: `;return a.message.includes("Unexpected token")?f=w.TOKEN_FILE_INVALID_JSON(l):a.message.includes("Unexpected end")?f=w.TOKEN_FILE_INCOMPLETE_JSON(l):f=w.TOKEN_FILE_GENERIC_ERROR(l,a.message),f});throw new g(w.TOKEN_LOAD_FAILED(u))}if(i.validation.length>0||i.flatten.length>0||i.resolution.length>0){const u=[...i.flatten,...i.validation,...i.resolution],a=new Map;for(const l of u)if(l.source?.sourcePath){const f=a.get(l.source.sourcePath)||[];f.push(l.message),a.set(l.source.sourcePath,f)}throw new g(w.TOKEN_VALIDATION_FAILED(a))}return{trees:s,resolved:r}}o(B,"loadAndResolveTokensForCLI");function Nt(e,t){const n={...e};return Object.keys(t).length>0&&typeof n.tokens=="object"&&!Array.isArray(n.tokens)&&"source"in n.tokens&&(n.tokens.themes=t),tt(n)}o(Nt,"integrateThemesIntoConfig");const{hidden:gs}=c,Ot=it(),k=o((e,t)=>Ot?e:t,"unicodeOr"),Pt=k("\u25C7","o"),Fe=k("\u250C","T"),O=k("\u2502","|"),de=k("\u2514","\u2014"),Lt=k("\u2510","T"),Mt=k("\u2518","\u2014"),te=k("\u2500","-"),jt=k("\u256E","+"),Ut=k("\u256F","+"),xt=k("\u2570","+"),Wt=k("\u256D","+"),Gt=k("\u25CF","\u2022"),Bt=k("\u25C6","*"),Vt=k("\u25B2","!"),Kt=k("\u25A0","x"),V=o((e,t=c.bgGreen,n=c.black)=>t(` ${n(e)} `),"label"),K=o(e=>{const t=["[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)","(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PRZcf-ntqry=><~]))"].join("|"),n=new RegExp(t,"g");return typeof e=="string"?e.replace(n,""):e},"strip"),Y=o((e="",t)=>{process.stdout.write(`
79
+
80
+ ${c.gray(Fe)}${c.gray(te)} ${e}
81
+ `)},"intro"),ne=o((e="",t)=>{process.stdout.write(`${c.gray(O)}
82
+ ${c.gray(de)}${c.gray(te)} ${e}
83
+
84
+ `)},"outro");function Yt(...e){process.env.DEBUG==="true"&&process.stderr.write(`[sugarcube:debug] ${e.map(String).join(" ")}
85
+ `)}o(Yt,"debugLog");function j(e){return new Promise(t=>setTimeout(t,e))}o(j,"sleep");function Ht(e,t){const n={};if(e.themes)for(const[s,r]of Object.entries(e.themes))n[s]=r.map(i=>{const u=t[i];if(!u)throw new g(w.KIT_INCOMPLETE());return u});return n}o(Ht,"processKitThemes");const Jt=o(async(e,t,n)=>{const s=await $t(e),r=Q(process.cwd(),t),i=s.files.find(d=>x(d.path)==="config.json");let u={};if(i)try{u=JSON.parse(i.content)}catch(d){Yt(`Could not parse config.json for starter kit '${e}':`,d)}const a=s.files.filter(d=>x(d.path)!=="config.json").map(d=>({path:$(r,x(d.path)),content:d.content})),l=Object.fromEntries(a.map(d=>[x(d.path),R(process.cwd(),d.path)])),f=Ht(u,l);return{config:Nt(n,f),tokenFiles:a,tokensDir:r,createdTokenPaths:a.map(d=>R(process.cwd(),d.path))}},"prepareStarterKitForInstall");async function qt(e){const t=await Jt(e.starterKit??"",e.tokensDir,e.config),n=await Ft(t.tokenFiles,e.tokensDir),{trees:s,resolved:r}=await B(e.config);e.setupResult={config:t.config,createdTokenPaths:t.createdTokenPaths,trees:s,resolved:r,tokenFiles:t.tokenFiles,tokensDir:t.tokensDir},e.createdFiles.push(...n)}o(qt,"installFromStarterKit");async function Ne(e=!0){const t=[{label:"React",value:"react",hint:".tsx"},{label:"CSS Only",value:"css-only",hint:".css"},{label:c.dim("Web components"),value:"web-components",hint:"Coming soon!"}];e&&t.push({label:"Skip",value:"skip",hint:"continue without components"});const n=await ct({message:"Build with",options:t});return ae(n)&&process.exit(0),n==="web-components"?(lt.info(c.blue("Web components are coming soon! Please choose React or CSS Only for now.")),Ne(e)):n}o(Ne,"promptComponentFramework");async function zt(e,t){const n=e.filter(r=>r.type==="component"&&r.frameworks?.includes(t)),s=await ut({message:"Select components to add",options:n.map(r=>({label:r.name,value:r.name,hint:r.description})),required:!0});return ae(s)&&process.exit(0),s}o(zt,"promptComponentSelectionFiltered");async function Oe(e,t=!1){const n=await ft({message:e,initialValue:t});return(!n||ae(n))&&(ke(),process.exit(0)),!0}o(Oe,"confirmOverwrite");const Zt=[Wt,jt,xt,Ut],Qt=[Fe,Lt,de,Mt];function Pe(e,t,n,s){let r=n,i=n;return s==="center"?r=Math.floor((t-e)/2):s==="right"&&(r=t-e-n),i=t-r-e,[r,i]}o(Pe,"getPaddingForLine");const Xt=o(e=>e,"defaultFormatBorder"),ge=o((e="",t="",n)=>{const s=n?.output??process.stdout,r=pt(s),u=1*2,a=n?.titlePadding??1,l=n?.contentPadding??2,f=n?.width===void 0||n.width==="auto"?1:Math.min(1,n.width),p=n?.includePrefix?`${O} `:"",d=n?.formatBorder??Xt,h=(n?.rounded?Zt:Qt).map(d),E=d(te),b=d(O),T=r-p.length;let C=Math.floor(r*f)-p.length;if(n?.width==="auto"){const z=e.split(`
86
+ `);let U=K(t).length+a*2;for(const He of z){const we=K(He).length+l*2;we>U&&(U=we)}const Z=U+u;Z<C&&(C=Z)}C%2!==0&&(C<T?C++:C--);const I=C-u,F=I-a*2,y=K(t).length>F?`${t.slice(0,F-3)}...`:t,[_,D]=Pe(K(y).length,I,a,n?.titleAlign),P=dt(e,I-l*2,{hard:!0,trim:!1});s.write(`${p}${h[0]}${E.repeat(_)}${y}${E.repeat(D)}${h[1]}
87
+ `);const q=P.split(`
88
+ `);for(const z of q){const[U,Z]=Pe(K(z).length,I,l,n?.contentAlign);s.write(`${p}${b}${" ".repeat(U)}${z}${" ".repeat(Z)}${b}
89
+ `)}s.write(`${p}${h[2]}${E.repeat(I)}${h[3]}
90
+ `)},"box");function me(e,t={}){const n=`
91
+ ${e}`;ge(n,c.black(c.bgRed(" ERROR ")),{width:"auto",titlePadding:2,formatBorder:c.red,...t})}o(me,"errorBoxWithBadge");function Le(e,t={}){const n=`
92
+ ${e}`;ge(n,c.black(c.bgYellow(" WARNING ")),{width:"auto",titlePadding:2,formatBorder:c.yellow,...t})}o(Le,"warningBoxWithBadge");function en(e,t={}){const n=`
93
+ ${e}`;ge(n,c.black(c.bgCyan(" INFO ")),{width:"auto",titlePadding:2,formatBorder:c.cyan,...t})}o(en,"infoBoxWithBadge");const tn=o((e,t)=>{if(!(e.meta&&e.name!=="escape")){if(e.ctrl){if(e.name==="a")return"first";if(e.name==="c"||e.name==="d")return"abort";if(e.name==="e")return"last";if(e.name==="g")return"reset"}return e.name==="return"||e.name==="enter"?"submit":e.name==="backspace"?"delete":e.name==="delete"?"deleteForward":e.name==="abort"?"abort":e.name==="escape"?"exit":e.name==="tab"?"next":e.name==="pagedown"?"nextPage":e.name==="pageup"?"prevPage":e.name==="home"?"home":e.name==="end"?"end":e.name==="up"?"up":e.name==="down"?"down":e.name==="right"?"right":e.name==="left"?"left":!1}},"action"),nn=o(async(e,t={})=>{const{sidebarSymbol:n=c.gray("\u2502"),clear:s=!1,stdin:r=process.stdin,stdout:i=process.stdout}=t,u=be.createInterface({input:r,escapeCodeTimeout:50}),a=Ce(i,{showCursor:!1});be.emitKeypressEvents(r,u);let l=0,f=!1;const p=o(async()=>{r.off("keypress",d),r.isTTY&&r.setRawMode(!1),u.close(),f=!0,l<e.length-1||s?a.clear():a.done()},"done"),d=o((h,E)=>{r.isTTY&&r.setRawMode(!0);const b=tn(E);if(b==="abort")return p(),process.exit(0);["up","down","left","right"].includes(b)||p()},"handleKeyPress");r.isTTY&&r.setRawMode(!0),r.on("keypress",d);for(const h of e){const E=Array.isArray(h)?h:h.split(" "),b=[];for(const I of[""].concat(E)){I&&b.push(I);const F=b.join(" ").replace(/sugarcube/g,c.cyan("sugarcube")),y=`${n} ${F}`;a(y),f||await new Promise(_=>setTimeout(_,Math.floor(Math.random()*126)+75))}f||await new Promise(I=>setTimeout(I,100));const C=(await Promise.all(E).then(I=>I.join(" "))).replace(/sugarcube/g,c.cyan("sugarcube"));a(`${n} ${C}`),f||await new Promise(I=>setTimeout(I,Math.floor(Math.random()*201)+1200)),l++}r.off("keypress",d),await new Promise(h=>setTimeout(h,100)),p(),r.isTTY&&r.setRawMode(!1),r.removeAllListeners("keypress")},"sayAnimatedInSidebar");function sn(){return Math.floor(Math.random()*551)+200}o(sn,"getRandomTaskDuration");async function on(e,{sidebarSymbol:t="\u2502",spacing:n=1,stdin:s=process.stdin,stdout:r=process.stdout,initialDelayMs:i=200,minDurationMs:u,successPauseMs:a=300,successMessage:l,successAsOutro:f=!1}={}){const p=o((y,_)=>{let D="";switch(_){case"start":D=`${c.cyan(`\u25B6 ${y.start}`)}`;break;case"pending":D=`${c.dim(`\u25A1 ${y.pending}`)}`;break;case"success":D=`${c.green(`\u2714 ${y.end}`)}`;break;case"end":D=`${c.dim(`\u25A0 ${y.end}`)}`;break}return`${t} ${D}`},"formatWithSidebar"),d=Array.from({length:e.length},()=>"");e.forEach((y,_)=>{d[_]=p(y,"pending")});const h=Ce(r),E=Ee.createInterface({input:s,escapeCodeTimeout:50});Ee.emitKeypressEvents(s,E);const b=o(y=>{y===""&&(h.clear(),E.close(),s.isTTY&&s.setRawMode(!1),process.exit(0)),s.isTTY&&s.setRawMode(!0)},"keypress");s.isTTY&&s.setRawMode(!0),s.on("keypress",b);const T=Array.from({length:Math.max(n,0)},()=>`${t}`),C=o(()=>[...T,...d].join(`
94
+ `),"renderContent");h(C()),await j(i);let I=0;for(const y of e){d[I]=p(y,"start"),h(C());const _=Date.now(),D=y.while();try{await D;const P=Date.now()-_,q=typeof u=="number"?u:sn();P<q&&await j(q-P),d[I]=p(y,"success"),h(C()),await j(a)}catch(P){throw d[I]=`${t} ${c.red(`\u2717 ${y.end} (failed)`)}`,h(C()),y.onError?.(P),s.removeListener("keypress",b),E.close(),s.isTTY&&s.setRawMode(!1),P}I++}const F=e.map(y=>p(y,"end"));if(l)if(f){const y=`${c.gray(de)}${c.gray(te)} ${c.green(l)}`;h([...T,...F,`${t}`,y].join(`
95
+ `))}else{const y=`${t} ${c.green(l)}`;h([...T,...F,`${t}`,y].join(`
96
+ `))}else h([...T,...F].join(`
97
+ `));await j(1e3),s.removeListener("keypress",b),s.isTTY&&s.setRawMode(!1),E.close(),h.done()}o(on,"executeTasksInSidebar");const rn=o(e=>process.stdout.write(`${e}
98
+ `),"rawLog"),S={message:o((e=[],{symbol:t=c.gray(O),secondarySymbol:n=c.gray(O),output:s=process.stdout,spacing:r=1}={})=>{const i=[];for(let a=0;a<r;a++)i.push(`${n}`);const u=Array.isArray(e)?e:e.split(`
99
+ `);if(u.length>0){const[a,...l]=u;a&&a.length>0?i.push(`${t} ${a}`):i.push(t);for(const f of l)f.length>0?i.push(`${n} ${f}`):i.push(n)}s.write(`${i.join(`
100
+ `)}
101
+ `)},"message"),info:o((e,t)=>{S.message(e,{...t,symbol:c.blue(Gt)})},"info"),success:o((e,t)=>{S.message(e,{...t,symbol:c.green(Bt)})},"success"),step:o((e,t)=>{S.message(e,{...t,symbol:c.green(Pt)})},"step"),warn:o((e,t)=>{S.message(e,{...t,symbol:c.yellow(Vt)})},"warn"),error:o((e,t)=>{S.message(e,{...t,symbol:c.red(Kt)})},"error"),animated:o(async(e,{secondarySymbol:t=c.gray(O),output:n=process.stdout,clear:s=!1,...r}={})=>nn(e,{sidebarSymbol:t,stdout:n,clear:s,...r}),"animated"),tasks:o(async(e,{spacing:t=1,secondarySymbol:n=c.gray(O),output:s=process.stdout,...r}={})=>on(e,{sidebarSymbol:n,spacing:t,stdout:s,...r}),"tasks"),space:o((e=1)=>{for(let t=0;t<e;t++)process.stdout.write(`${c.gray(O)}
102
+ `)},"space"),break:o((e=1)=>{for(let t=0;t<e;t++)process.stdout.write(`
103
+ `)},"break")};function H(e){if(e instanceof g)S.space(1),me(e.message,{});else{const t=`An unexpected error occurred: ${e instanceof Error?e.message:String(e)}
104
+
105
+ If this issue persists, please report it: ${c.cyan("https://github.com/sugarcube-org/sugarcube/issues")}`;S.space(1),me(t,{})}process.exit(0)}o(H,"handleError");function Me(e){return{absolute:Q(process.cwd(),e)}}o(Me,"resolveDirectoryFromFlag");async function je(e){if(v())try{const{config:t}=await ee(),n=an(t,e);return typeof n=="string"?Q(process.cwd(),n):void 0}catch{return}}o(je,"resolveDirectoryFromConfig");function an(e,t){const n=t.split(".");let s=e;for(const r of n){if(s==null||typeof s!="object")return;s=s[r]}return s}o(an,"getNestedValue");async function cn(e){if(e){const{absolute:t}=Me(e);return{directory:t,fromConfig:!1}}if(v())try{const t=await je("output.css");if(t)return{directory:t,fromConfig:!0}}catch{}throw new g(`A sugarcube config file was not found.
106
+
107
+ Either a config file or --styles-dir is required to run this command.
108
+
109
+ To use the cube command without a config file:
110
+ e.g. ${c.cyan(`${A.CUBE} --styles-dir src/styles`)}
111
+
112
+ To create a config file:
113
+ ${c.cyan(A.INIT)}
114
+
115
+ Stuck? ${c.cyan("https://sugarcube.sh")}`)}o(cn,"getCssDir");async function ln(e){if(e){const{absolute:t}=Me(e);return{directory:t,fromConfig:!1}}if(v())try{const t=await je("output.components");if(t)return{directory:t,fromConfig:!0}}catch{}throw new g(`A sugarcube config file was not found.
116
+
117
+ Either a config file or --components-dir is required to run this command.
118
+
119
+ To use the components command without a config file:
120
+ e.g. ${c.cyan(`${A.COMPONENTS} --components-dir src/components/ui`)}
121
+
122
+ To create a config file:
123
+ ${c.cyan(A.INIT)}
124
+
125
+ Stuck? ${c.cyan("https://sugarcube.sh")}`)}o(ln,"getComponentsDir");function J(e,t=process.cwd()){try{const n=at(t,"package.json");if(!N(n))return!1;const s=ye(n,"utf-8"),r=JSON.parse(s),i={...r.dependencies,...r.devDependencies,...r.peerDependencies};return e in i}catch{return!1}}o(J,"isPackageInstalled");async function Ue(e,{withFallback:t=!1}={}){const n=await gt({programmatic:!0,cwd:e});if(n?.startsWith("yarn@"))return"yarn";if(n?.startsWith("pnpm@"))return"pnpm";if(n==="bun")return"bun";if(!t)return n?.split("@")[0]??"npm";const s=process.env.npm_config_user_agent||"";return s.startsWith("yarn")?"yarn":s.startsWith("pnpm")?"pnpm":s.startsWith("bun")?"bun":"npm"}o(Ue,"getPackageManager");function un(e=process.cwd()){return mt(e)!==null}o(un,"isTypeScriptProject");async function xe(e=process.cwd()){return un(e)?"sugarcube.config.ts":"sugarcube.config.js"}o(xe,"getConfigFileName");function fn(e){return/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(e)}o(fn,"isValidIdentifier");function he(e,t=0){const n=" ".repeat(t);if(e===null)return"null";if(e===void 0)return"undefined";if(typeof e=="string")return JSON.stringify(e);if(typeof e=="number"||typeof e=="boolean")return String(e);if(Array.isArray(e))return e.length===0?"[]":`[
126
+ ${e.map(r=>`${n} ${he(r,t+1)}`).join(`,
127
+ `)}
128
+ ${n}]`;if(typeof e=="object"){const s=Object.entries(e);return s.length===0?"{}":`{
129
+ ${s.map(([i,u])=>{const a=fn(i)?i:JSON.stringify(i);return`${n} ${a}: ${he(u,t+1)}`}).join(`,
130
+ `)}
131
+ ${n}}`}return JSON.stringify(e)}o(he,"formatValue");function pn(e,t){const n=he(e,0);return`${t?`import type { UserConfig } from "@sugarcube-org/core";
132
+
133
+ const config: UserConfig = `:`/**
134
+ * @type {import('@sugarcube-org/core').UserConfig}
135
+ */
136
+ const config = `}${n};
137
+
138
+ export default config;
139
+ `}o(pn,"formatConfigAsCode");async function We(e){try{const t=await xe(),n=t.endsWith(".ts"),s=pn(e,n);await X(t,s,"utf-8")}catch(t){const n=t instanceof Error?`: ${t.message}`:"";throw new g(`Failed to write config file${n}`)}}o(We,"writeUserConfig");function dn(e,t){return{...e,...t,output:{...e.output??{},...t.output??{}},transforms:{...e.transforms??{},...t.transforms??{}}}}o(dn,"mergeUserConfig");async function Ge(e){const{config:t}=await nt(),n=dn(t,e);await We(n)}o(Ge,"mergeConfigIntoFile");const gn=new L().name("components").description("Add components to your project").argument("[components...]","Components to add (e.g., button card)").option("-f, --framework <type>","Framework to use (react, css-only)").option("--components-dir <dir>","Components output directory (e.g., 'src/components')").option("-s, --silent","Suppress logs and prompts").option("-o, --overwrite","Overwrite existing files").action(async(e,t)=>{try{t.silent||Y(V(c.bgGreen(c.black("Components"))));const{directory:n,fromConfig:s}=await ln(t.componentsDir);let r=[],i;if(e.length>0||t.framework){if(!t.framework)throw new g(w.COMPONENTS_FRAMEWORK_REQUIRED());if(!["react","css-only"].includes(t.framework))throw new g(w.COMPONENTS_INVALID_FRAMEWORK());i=t.framework,r=e}else{i=await Ne(!1);const T=await M();T||(ke("Failed to fetch component list"),process.exit(1)),r=await zt(T,i)}const u=await Ue(process.cwd(),{withFallback:!0}),a=await M(),l=await fe(a,r,i),f=await Rt({selectedComponents:r,componentType:i,componentsOutputDirectory:n}),p=Ae(f);if(p&&!t.force&&!t.silent){const T=Le(p,{});S.space(1),await Oe("Continue?",!1)}const d=[],h=[],E=new Set;for(const T of l){const C=T.dependencies?.[i]||[];for(const I of C)E.add(I)}const b=Array.from(E).filter(T=>!J(T,process.cwd()));b.length>0&&d.push({pending:`Install ${b.length} dependencies`,start:`Installing ${b.join(", ")}...`,end:`Installed ${b.join(", ")}`,while:o(async()=>{await pe(b,process.cwd(),u)},"while")});for(const T of l)d.push({pending:`Write component files for ${T.name}`,start:`Writing component files for ${T.name}...`,end:`Wrote component files for ${T.name}`,while:o(async()=>{const C=await vt({registryIndex:a,selectedComponents:[T.name],componentType:i,componentsOutputDirectory:n,overwrite:t.overwrite||!1,packageManager:u});h.push(...C.createdFiles)},"while")});if(await S.tasks(d,{successMessage:"Components added successfully! \u{1F389} ",minDurationMs:0,successAsOutro:!0}),rn(""),!s&&v()){const T=R(process.cwd(),n);await Ge({output:{components:T}})}}catch(n){H(n)}}),mn=new L().name("cube").description("Add CUBE CSS to your project").option("-s, --silent","Suppress logs and prompts").option("-f, --force","Skip overwrite confirmation").option("--styles-dir <dir>","CSS output directory (e.g., 'src/styles')").action(async e=>{try{e.silent||Y(V("CUBE CSS"));const{directory:t,fromConfig:n}=await cn(e.stylesDir);try{await W(t,{recursive:!0})}catch(u){const a=u instanceof Error?`: ${u.message}`:"";throw new g(`Failed to create output directory${a}`)}const s=await _t({cubeDirectory:t}),r=Ae(s);if(r&&!e.force&&!e.silent){S.space(1);const u=Le(r,{});await Oe("Continue?",!1)}const i=await At(t);if(!e.silent){S.space(1);const u=i,f=[...new Set(u)].map(p=>R(process.cwd(),p)).map(p=>({pending:`Write ${p}`,start:`Writing ${p}`,end:`Wrote ${p}`,while:o(async()=>{},"while")}));await S.tasks(f,{spacing:0,minDurationMs:0,successPauseMs:100,successMessage:"\u{1F389} Files written!"}),ne(c.green("CUBE added successfully."))}if(!n&&v()){const u=R(process.cwd(),t);await Ge({output:{css:u}})}}catch(t){H(t)}});function hn(){return["**/*.{html,htm,js,ts,jsx,tsx,vue,svelte,astro,php,njk,liquid,pug,hbs,handlebars,twig,erb,ejs}","!node_modules/**","!dist/**","!build/**","!.next/**","!.nuxt/**","!.astro/**","!.git/**","!coverage/**","!*.config.{js,ts,mjs}"]}o(hn,"getDefaultScanPatterns");function wn(){return hn()}o(wn,"getScanPatterns");async function Be(e,t){const n={name:"sugarcube",rules:st(t.utilities??{},e),preflights:[]},s=await ht({presets:[n]}),r=wn(),i=await G(r,{dot:!0});if(i.length===0)return[];const a=(await Promise.all(i.map(f=>Qe(f,"utf8")))).join(`
140
+ `),{css:l}=await s.generate(a,{preflights:!1});return l?.trim()?[{path:`${t.output?.css||ot}/utilities/utilities.gen.css`,css:l,collection:"default"}]:[]}o(Be,"generateSugarcubeUtilities");async function yn(e,t,n){const s=[],r=await oe(e,t,n),i=await Te(r,n);await Se(i),s.push(...i);const u=await Be(r,n);return await Ie(u),s.push(...u),s}o(yn,"generateAllCSS");const Tn=new L().name("generate").description("Generate CSS from your design tokens").option("--force","Skip overwrite confirmation").option("-s, --silent","Suppress logs and prompts").action(async e=>{try{if(e.silent||Y(V("Generate CSS")),J("@sugarcube-org/vite"))throw new g("Sugarcube vite plugin detected. When using the plugin, CSS is generated automatically during your build process. Remove the plugin to use CLI generation instead.");if(!v())throw new g(`A sugarcube config file was not found. This command requires one.
141
+
142
+ Please run ${c.cyan(A.INIT)} (or manually create a config file).
143
+
144
+ Stuck? ${c.cyan("https://sugarcube.sh")}`);const{config:t}=await ee(),{trees:n,resolved:s}=await B(t),r=await yn(n,s,t);if(!e.silent){const i=r.map(f=>f.path),l=[...new Set(i)].map(f=>R(process.cwd(),f)).map(f=>({pending:`Write ${f}`,start:`Writing ${f}`,end:`Wrote ${f}`,while:o(async()=>{},"while")}));await S.tasks(l,{spacing:1,minDurationMs:0,successPauseMs:100,successMessage:"\u{1F389} Files written!"}),S.space(1),ne(c.green("CSS generated successfully."))}}catch(t){H(t)}});function Sn(e){return{source:[$(R(process.cwd(),e.actualTokensDir),$e)]}}o(Sn,"createSingleTokenCollection");async function In(e){return Sn(e)}o(In,"buildTokensConfig");async function kn(e){const t=await In({actualTokensDir:e.actualTokensDir}),n=R(process.cwd(),e.actualStylesDir),s=e.isSrcDir?re.output.components:re.output.components.replace(/^src\//,"");return{tokens:t,output:{css:n,components:s,separate:re.output.separate}}}o(kn,"buildUserConfig");function Ve(e,t=0){if(typeof e!="object"||e===null||t>St)return!1;for(const[n,s]of Object.entries(e))if(!n.startsWith("$")&&typeof s=="object"&&s!==null&&("$value"in s||Ve(s,t+1)))return!0;return!1}o(Ve,"hasAnyToken");async function En(e){try{const t=await G($e,{cwd:e,absolute:!0});for(const n of t)try{const s=await se.readFile(n,"utf-8"),r=JSON.parse(s);if(Ve(r))return!0}catch{}return!1}catch{return!1}}o(En,"detectExistingTokens");const Ke=["**/node_modules/**",".next","public","dist","build",".astro",".nuxt",".output",".svelte-kit"];function bn(e){try{const t=ie.resolve(e,"package.json");if(!N(t))return null;const n=ye(t,"utf-8");return JSON.parse(n)}catch{return null}}o(bn,"getPackageJson");async function Cn(e){const[t,n,s]=await Promise.all([G.glob("**/{next,vite,astro,nuxt,svelte,remix,eleventy}.config.*|.eleventy.js",{cwd:e,deep:3,ignore:Ke}),N(ie.resolve(e,"src")),bn(e)]),r=n?"src/design-tokens":"design-tokens",i=n?"src/styles":"styles",u=n?"src/components":"components";let a="none";return t.find(l=>l.startsWith("next.config."))?.length?a=N(ie.resolve(e,`${n?"src/":""}app`))?"next-app":"next-pages":t.find(l=>l.startsWith("astro.config."))?.length?a="astro":t.find(l=>l.startsWith("nuxt.config."))?.length?a="nuxt":t.find(l=>l.startsWith("svelte.config."))?.length?a="sveltekit":Object.keys(s?.dependencies??{}).find(l=>l.startsWith("@remix-run/"))?a="remix":t.find(l=>l.startsWith("eleventy.config.")||l.startsWith(".eleventy."))?.length?a="eleventy":t.find(l=>l.startsWith("vite.config."))?.length&&(a="vite"),{framework:a,isSrcDir:n,tokensDir:r,stylesDir:i,componentDir:u}}o(Cn,"getProjectInfo");async function $n(e,t){return!!((await G.glob("vite.config.*",{cwd:e,deep:1,ignore:Ke})).length>0||["vite","astro","nuxt","sveltekit","remix"].includes(t))}o($n,"shouldInstallVitePlugin");const Rn=o(async e=>{S.space(2),await j(200);let t="Next steps";if(e.pluginToInstall===Re)t+=`
145
+
146
+ `,t+=`1. Import the generated CSS
147
+ `,t+=` ${c.cyan("import 'virtual:uno.css'")}`;else{const n=`${e.stylesDir}/global/tokens.variables.gen.css`;t+=`
148
+
149
+ `,t+=`1. Import the generated CSS
150
+ `,t+=` ${c.cyan(`import './${n}'`)}`}t+=`
151
+
152
+ `,t+=`2. (Optional) Add CUBE CSS
153
+ `,t+=` ${c.cyan(A.CUBE)}`,t+=`
154
+
155
+ `,t+=`3. (Optional) Add components
156
+ `,t+=` ${c.cyan(A.COMPONENTS)}`,t+=`
157
+
158
+ `,t+=`Docs: ${c.cyan("https://sugarcube.sh")}`,en(t,{width:.75}),await j(200),S.break(1)},"nextSteps");async function _n(e){await Rn(e)}o(_n,"next");const Dn=o(async()=>{const e=["Welcome to sugarcube \u2014 the toolkit for seriously sweet frontends!"];S.space(1),await S.animated(e,{clear:!1})},"welcome");function Ye(e,t){if(!e||e.trim()==="")throw new g(w.DIRECTORY_PATH_EMPTY(t));const s=ze(e).split("/")[0];if(s&&Tt.includes(s))throw new g(w.DIRECTORY_PATH_RESERVED(t,e))}o(Ye,"validateDirectoryPath");function vn(e){e.tokensDir&&Ye(e.tokensDir,"tokens-dir"),e.stylesDir&&Ye(e.stylesDir,"styles-dir")}o(vn,"validateOptions");async function An(){v()&&(me(w.CONFIG_EXISTS(),{}),process.exit(0))}o(An,"preflightInit");async function Fn(e){const t=await Cn(process.cwd()),n=e.tokensDir||t.tokensDir,s=e.stylesDir||t.stylesDir,r=await En(n);return{tokensDir:n,stylesDir:s,isSrcDir:t.isSrcDir,hasExistingTokens:r,framework:t.framework}}o(Fn,"initializeProjectContext");async function Nn(e,t,n){const s=t?null:e.kit||ce;if((e.skip||[]).includes("plugin"))return{starterKit:s,pluginToInstall:null};const i=await On(n);return{starterKit:s,pluginToInstall:i}}o(Nn,"determineInstallationTargets");async function On(e){return await $n(process.cwd(),e)?Re:null}o(On,"determinePlugin");async function Pn(e,t,n,s,r){const i=await Ue(process.cwd(),{withFallback:!0});return{options:e,...t,isSrcDir:t.isSrcDir,config:n,userConfig:s,...r,packageManager:i,createdFiles:[],createdDirectories:[],installedDependencies:[],tasks:[]}}o(Pn,"buildInitContext");async function Ln(e){const{trees:t,resolved:n}=await B(e.config);e.setupResult={config:e.config,createdTokenPaths:[],trees:t,resolved:n,tokenFiles:[],tokensDir:e.tokensDir}}o(Ln,"processExistingTokens");async function Mn(e){!e.hasExistingTokens&&e.starterKit?await qt(e):await Ln(e)}o(Mn,"setupDesignTokens");async function jn(e){if(!e.setupResult)throw new g(w.INITIALIZATION_INCOMPLETE());const{trees:t,resolved:n}=e.setupResult,s=await oe(t,n,e.config),r=await Te(s,e.config);await Se(r)}o(jn,"writeCSSVariables");async function Un(e){if(!e.setupResult)throw new g(w.INITIALIZATION_INCOMPLETE());const{trees:t,resolved:n}=e.setupResult,s=await oe(t,n,e.config),r=await Be(s,e.config);r.length&&await Ie(r)}o(Un,"writeCSSUtilities");async function xn(e){if(e.pluginToInstall&&!J(e.pluginToInstall))try{await pe([e.pluginToInstall],process.cwd(),e.packageManager),e.installedDependencies.push(e.pluginToInstall)}catch{throw new g(w.PLUGIN_INSTALL_FAILED({pluginToInstall:e.pluginToInstall,packageManager:e.packageManager}))}}o(xn,"installPlugins");async function Wn(e){try{await We(e.userConfig);const t=await xe();e.createdFiles.push(t)}catch{throw new g(w.CONFIG_WRITE_FAILED())}}o(Wn,"finalize");function Gn(e){const t=[];if(e.hasExistingTokens?t.push({pending:"Looking for existing tokens",start:"Looking for existing tokens...",end:`Existing tokens found at ${e.tokensDir} ${k("\u2192","->")} using them`,while:o(async()=>{},"while")}):e.starterKit&&t.push({pending:"Looking for existing tokens",start:"Looking for existing tokens...",end:`No existing tokens detected ${k("\u2192","->")} adding starter kit`,while:o(async()=>{},"while")}),e.pluginToInstall){const n="Vite";J(e.pluginToInstall)?t.push({pending:`Checking for ${n} compatibility`,start:`Checking for ${n} compatibility...`,end:`${n} plugin already installed ${k("\u2192","->")} skipping plugin installation`,while:o(async()=>{},"while")}):t.push({pending:"Checking for Vite compatibility",start:"Checking for Vite compatibility...",end:`Vite detected ${k("\u2192","->")} plugin will be installed`,while:o(async()=>{},"while")})}else{const n=e.options.skip?.includes("plugin");t.push({pending:"Checking for Vite compatibility",start:"Checking for Vite compatibility...",end:n?`Plugin skipped ${k("\u2192","->")} CSS will be generated as file(s)`:`No Vite detected ${k("\u2192","->")} CSS will be generated as file(s)`,while:o(async()=>{},"while")})}return t}o(Gn,"buildDetectionTasks");async function Bn(e){if(e.tasks.push({pending:e.hasExistingTokens?"Process existing design tokens":"Add design tokens",start:e.hasExistingTokens?"Processing existing design tokens...":"Adding design tokens...",end:e.hasExistingTokens?"Design tokens processed":"Design tokens added",while:o(async()=>{await Mn(e)},"while")}),!e.pluginToInstall)e.tasks.push({pending:"Generate CSS variables",start:"Generating CSS variables...",end:"CSS variables generated",while:o(async()=>{await jn(e)},"while")}),e.tasks.push({pending:"Generate CSS utilities",start:"Generating CSS utilities...",end:"CSS utilities generated",while:o(async()=>{await Un(e)},"while")});else if(e.pluginToInstall&&!J(e.pluginToInstall)){const t="Vite";e.tasks.push({pending:`Install ${t} plugin`,start:`Installing ${t} plugin...`,end:`${t} plugin installed`,while:o(async()=>{await xn(e)},"while")})}e.tasks.push({pending:"Write configuration file",start:"Writing configuration file...",end:"Configuration file written",while:o(async()=>{await Wn(e)},"while")})}o(Bn,"buildExecutionTasks");const Vn=new L().name("init").description("Initialize a new sugarcube project").option("--kit <kit>",`Starter kit to use (default: ${ce})`,ce).option("--tokens-dir <dir>","Design tokens directory (e.g., 'src/design-tokens')").option("--styles-dir <dir>","Styles output directory (e.g., 'src/styles')").option("--with <items...>","Install optional items").option("--skip <items...>","Skip installation of specific items (e.g., plugin)").action(async e=>{let t;try{vn(e),await An();const n=await Fn(e),s=await kn({actualTokensDir:n.tokensDir,actualStylesDir:n.stylesDir,isSrcDir:n.isSrcDir}),r=rt(s),i=await Nn(e,n.hasExistingTokens,n.framework);t=await Pn(e,n,r,s,i),Y(V("sugarcube")),await Dn();const u=Gn(t);u.length>0&&(S.message("Detecting project\u2026"),await S.tasks(u,{minDurationMs:1e3})),t.tasks=[],await Bn(t),t.tasks.length>0&&(S.message("Setting things up\u2026"),await S.tasks(t.tasks,{successMessage:"\u{1F389} Tasks completed successfully!"})),await _n(t)}catch(n){H(n)}}),Kn=new L().name("validate").description("Validate design token files").argument("[paths...]","Token files or directories to validate (e.g., src/design-tokens)").action(async e=>{try{if(Y(V("Validate")),v()&&!e.length){const{config:s}=await ee();await B(s),ne(c.greenBright("All tokens valid \u2728"));return}if(!e.length)throw new g(w.VALIDATE_NO_PATH_SPECIFIED());for(const s of e)if(!N(s))throw new g(w.VALIDATE_PATH_NOT_FOUND(s));const t=await G(e.map(s=>s.endsWith(".json")?s:$(s,"**/*.json")));if(t.length===0)throw new g(w.VALIDATE_NO_TOKEN_FILES());const n=v()?(await ee()).config:{tokens:{source:[]},output:{tokens:".",css:".",separate:!1},transforms:{fluid:{min:320,max:1200},colorFallbackStrategy:"native"},build:{}};await B({...n,tokens:{source:t.map(s=>R(process.cwd(),s))}}),ne(c.greenBright("All tokens valid \u2728"))}catch(t){H(t)}});process.on("SIGINT",()=>process.exit(0)),process.on("SIGTERM",()=>process.exit(0));async function Yn(){const e=new L().name("sugarcube").description("CLI for scaffolding sugarcube projects").version(yt.version,"-v, --version","display the version number");e.addCommand(Vn).addCommand(Tn).addCommand(Kn).addCommand(gn).addCommand(mn),e.parse()}o(Yn,"main"),Yn();
package/package.json CHANGED
@@ -1,11 +1,12 @@
1
1
  {
2
2
  "name": "@sugarcube-org/cli",
3
- "version": "0.0.0-alpha.16",
3
+ "version": "0.0.0-alpha.17",
4
4
  "publishConfig": {
5
- "access": "public"
5
+ "access": "public",
6
+ "provenance": false
6
7
  },
7
8
  "description": "A CLI for scaffolding sugarcube applications",
8
- "license": "UNLICENSED",
9
+ "license": "SEE LICENSE IN LICENSE.md",
9
10
  "author": "Mark Tomlinson",
10
11
  "repository": {
11
12
  "type": "git",
@@ -36,21 +37,27 @@
36
37
  "sugarcube": "./dist/index.mjs"
37
38
  },
38
39
  "dependencies": {
39
- "@antfu/ni": "^23.3.0",
40
- "@clack/prompts": "^0.9.1",
41
- "commander": "^12.1.0",
42
- "cross-env": "^7.0.3",
43
- "execa": "^9.5.2",
44
- "fast-glob": "^3.3.2",
45
- "node-fetch": "^3.3.0",
46
- "pathe": "^2.0.3",
47
- "picocolors": "^1.1.1",
48
- "zod": "^3.24.2",
49
- "@sugarcube-org/core": "0.0.1-alpha.6"
40
+ "@antfu/ni": "23.3.0",
41
+ "@clack/core": "1.0.0-alpha.3",
42
+ "@clack/prompts": "1.0.0-alpha.3",
43
+ "@sugarcube-org/core": "0.0.1-alpha.7",
44
+ "@unocss/core": "66.5.2",
45
+ "commander": "12.1.0",
46
+ "execa": "9.5.2",
47
+ "fast-glob": "3.3.2",
48
+ "fast-wrap-ansi": "0.1.3",
49
+ "get-tsconfig": "4.7.2",
50
+ "is-unicode-supported": "2.1.0",
51
+ "log-update": "6.1.0",
52
+ "node-fetch": "3.3.0",
53
+ "pathe": "2.0.3",
54
+ "picocolors": "1.1.1",
55
+ "zod": "3.21.4"
50
56
  },
51
57
  "devDependencies": {
52
- "pkgroll": "^2.5.1",
53
- "tsx": "^4.19.2"
58
+ "cross-env": "7.0.3",
59
+ "pkgroll": "2.5.1",
60
+ "tsx": "4.19.2"
54
61
  },
55
62
  "engines": {
56
63
  "node": ">=18.0.0"