@sugarcube-org/postcss 0.0.1-alpha.2 → 0.0.1-alpha.3

package/LICENSE.md

@@ -0,0 +1,9 @@
+# Proprietary Software
+
+This software is proprietary and confidential. All rights reserved.
+
+Copyright (c) 2025 Mark Tomlinson
+
+This software is provided "as is" without warranty of any kind, either express or implied.
+
+Unauthorized copying, distribution, or use of this software is strictly prohibited. 

package/README.md

@@ -0,0 +1,41 @@
+# @sugarcube-org/postcss
+
+PostCSS plugin for sugarcube CSS generation.
+
+## What it does
+
+- Generates CSS variables and utilities as part of PostCSS processing
+- Integrates with any build tool that supports PostCSS
+- Provides flexible CSS generation for sugarcube projects
+
+## Installation
+
+```bash
+npm install @sugarcube-org/postcss
+```
+
+## Usage
+
+```js
+// postcss.config.js
+module.exports = {
+  plugins: [
+    require('@sugarcube-org/postcss')
+  ]
+}
+```
+
+## Features
+
+- **Build tool agnostic** - Works with any PostCSS-compatible setup
+- **Configurable** - Uses your sugarcube.config.json settings
+- **Efficient** - Generates CSS during build process
+- **Flexible** - Integrates with existing PostCSS workflows
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+``` 

package/dist/index.cjs

@@ -1,3 +1,3 @@
-"use strict";var h=Object.defineProperty;var u=(s,n)=>h(s,"name",{value:n,configurable:!0});var f=require("node:fs"),c=require("node:path"),l=require("@sugarcube-org/core");function y(s){return s&&"source"in s&&Array.isArray(s.source)}u(y,"isSingleCollection");function d(s,n,t=new Set){for(const r of s)if(!r.includes("*")&&f.existsSync(r)){const e=c.resolve(process.cwd(),r);t.has(e)||n.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:e})}else if(r.includes("*")){const e=c.dirname(r),o=c.basename(r);f.existsSync(e)&&n.messages.push({type:"dir-dependency",plugin:"postcss-sugarcube",dir:c.resolve(process.cwd(),e),glob:o})}}u(d,"processTokenSources");function b(s,n){if(n.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:c.resolve(process.cwd(),"sugarcube.config.json")}),!s.tokens)return;const t=s.output?.directories?.css||"./src/styles",r=new Set;if(s.output?.css?.separate?r.add(c.resolve(process.cwd(),`${t}/global/variables/colors.variables.css`)):r.add(c.resolve(process.cwd(),`${t}/tokens.css`)),y(s.tokens))d(s.tokens.source,n,r);else for(const[e,o]of Object.entries(s.tokens))o&&"source"in o&&Array.isArray(o.source)&&d(o.source,n,r)}u(b,"registerDependencies");function v(s){const n=s.filter(e=>e.file||e.source?.sourcePath),t=s.filter(e=>!e.file&&(!e.source||!e.source.sourcePath)),r=[];for(const e of n){const o=e.file||e.source?.sourcePath;if(!o)continue;const i=c.relative(process.cwd(),o),a=e.message.replace(o,i);r.push(a)}for(const e of t)r.push(e.message);return r.join(`
-  - `)}u(v,"formatErrors");let g=0;const w=u((s={})=>({postcssPlugin:"postcss-sugarcube",async Once(n,{result:t}){if(!t.opts.from){t.warn("No input file provided to postcss-sugarcube");return}try{const e=n.nodes[0];if(e&&e.type==="comment"&&e.text.includes("AUTOMATICALLY GENERATED FILE"))return;const o=await l.loadConfig();b(o,t);const i=await l.tokensToCSSPipeline(o),a=[...i.errors.load,...i.errors.flatten,...i.errors.validation,...i.errors.resolution];if(a.length>0){t.warn(`Token validation failed:
-  - ${v(a)}`,{plugin:"postcss-sugarcube",word:"error"});return}const m=l.getTokenPathsFromConfig(o);await l.writeCSSFilesToDisk(i.output,!0,m);const p=Date.now();!s.silent&&p-g>1e3&&(t.messages.push({type:"log",plugin:"postcss-sugarcube",text:"\u2728 Generated CSS files from tokens"}),g=p)}catch(e){t.warn(e instanceof Error?e.message:String(e),{plugin:"postcss-sugarcube",word:"error"})}}}),"sugarcubePlugin");w.postcss=!0,module.exports=w;
+"use strict";var E=Object.defineProperty;var c=(e,s)=>E(e,"name",{value:s,configurable:!0});var v=require("node:fs"),f=require("node:path"),g=require("@sugarcube-org/core"),P=c((e,s)=>(s=Symbol[e])?s:Symbol.for("Symbol."+e),"__knownSymbol"),C=c(e=>{throw TypeError(e)},"__typeError"),y=c((e,s,l)=>{if(s!=null){typeof s!="object"&&typeof s!="function"&&C("Object expected");var t,u;t===void 0&&(t=s[P("dispose")]),typeof t!="function"&&C("Object not disposable"),u&&(t=c(function(){try{u.call(this)}catch(p){return Promise.reject(p)}},"dispose")),e.push([l,t,s])}return s},"__using"),b=c((e,s,l)=>{var t=typeof SuppressedError=="function"?SuppressedError:function(n,d,i,o){return o=Error(i),o.name="SuppressedError",o.error=n,o.suppressed=d,o},u=c(n=>s=l?new t(n,s,"An error was suppressed during disposal"):(l=!0,n),"fail"),p=c(n=>{for(;n=e.pop();)try{var d=n[1]&&n[1].call(n[2]);if(n[0])return Promise.resolve(d).then(p,i=>(u(i),p()))}catch(i){u(i)}if(l)throw s},"next");return p()},"__callDispose");const a=process.env.DEBUG==="true";function U(e){return e&&"source"in e&&Array.isArray(e.source)}c(U,"isSingleCollection");function h(e,s,l=new Set){for(const t of e)if(!t.includes("*")&&v.existsSync(t)){const u=f.resolve(process.cwd(),t);l.has(u)||s.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:u})}else if(t.includes("*")){const u=f.dirname(t),p=f.basename(t);v.existsSync(u)&&s.messages.push({type:"dir-dependency",plugin:"postcss-sugarcube",dir:f.resolve(process.cwd(),u),glob:p})}}c(h,"processTokenSources");function A(e,s){if(s.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:f.resolve(process.cwd(),g.SUGARCUBE_CONFIG_FILE)}),!e.tokens)return;const l=e.output?.css||"./src/styles",t=new Set;if(e.output?.separate?t.add(f.resolve(process.cwd(),`${l}/global/variables/colors.variables.css`)):t.add(f.resolve(process.cwd(),`${l}/tokens.css`)),U(e.tokens))h(e.tokens.source,s,t);else for(const[u,p]of Object.entries(e.tokens))p&&"source"in p&&Array.isArray(p.source)&&h(p.source,s,t)}c(A,"registerDependencies");const w=c((e,s,l)=>{const t=l instanceof Error?l.message:String(l);e.warn(`[sugarcube] ${s}${t}`,{plugin:"postcss-sugarcube",word:"error"})},"reportError"),k=c(()=>(console.log("\u{1F3AF} PostCSS Sugarcube plugin is initializing"),{postcssPlugin:"postcss-sugarcube",prepare(e){console.log("\u26A1 PostCSS Sugarcube plugin is preparing..."),e.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:f.resolve(process.cwd(),g.SUGARCUBE_CONFIG_FILE)}),e.messages.push({type:"dir-dependency",plugin:"postcss-sugarcube",dir:f.resolve(process.cwd(),"src/design-tokens"),glob:"*.json"});let s=null;const l=c(async()=>{var n=[];try{const o=y(n,new g.Instrumentation);if(a&&o.start("Process Tokens"),!s)throw new Error("Sugarcube config not initialized");a&&o.start("Token Processing Pipeline");const r=await g.tokenProcessingPipeline({type:"files",config:s.config}),S=[...r.errors.load,...r.errors.flatten,...r.errors.validation,...r.errors.resolution];return S.length>0&&w(e,`Token processing issues found:
+`,S.map(m=>`  - ${m.message}`).join(`
+`)),a&&o.end("Token Processing Pipeline"),a&&o.end("Process Tokens"),{resolved:r.resolved,trees:r.trees}}catch(o){var d=o,i=!0}finally{b(n,d,i)}},"processTokens"),t=c(async n=>{var d=[];try{const r=y(d,new g.Instrumentation);if(a&&r.start("Generate and Write CSS Variables"),!s)throw new Error("Sugarcube config not initialized");a&&r.start("CSS Variables Pipeline");const S=await g.generateCSSVariables(n.trees,n.resolved,s.config);a&&r.end("CSS Variables Pipeline"),a&&r.start("Write CSS Variables to Disk"),await g.writeCSSVariablesToDisk(S.output),a&&r.end("Write CSS Variables to Disk"),a&&r.end("Generate and Write CSS Variables")}catch(r){var i=r,o=!0}finally{b(d,i,o)}},"generateAndWriteCSSVariables"),u=c(async n=>{var d=[];try{const r=y(d,new g.Instrumentation);if(a&&r.start("Generate and Write Utilities"),!s)throw new Error("Sugarcube config not initialized");a&&r.start("Generate Utility CSS");const{output:S}=g.generateCSSUtilityClasses(n.resolved,s.config);a&&r.end("Generate Utility CSS"),a&&r.start("Write CSS Utilities to Disk"),await g.writeCSSUtilitiesToDisk(S),a&&r.end("Write CSS Utilities to Disk"),a&&r.end("Generate and Write Utilities")}catch(r){var i=r,o=!0}finally{b(d,i,o)}},"generateAndWriteUtilities"),p=c(async()=>{var n=[];try{const o=y(n,new g.Instrumentation);a&&o.start("Process and Update");try{const r=await l();await t(r),await u(r)}catch(r){w(e,"Sugarcube processing failed",r)}a&&o.end("Process and Update")}catch(o){var d=o,i=!0}finally{b(n,d,i)}},"processAndUpdate");return{async Once(n){if(console.log("  Once called for file:",e.opts.from),!e.opts.from){e.warn("No input file provided to postcss-sugarcube");return}try{const i=n.nodes[0];if(i&&i.type==="comment"&&i.text.includes("AUTOMATICALLY GENERATED FILE"))return;s=await g.loadConfig(),A(s.config,e),await p()}catch(i){w(e,"Sugarcube processing failed",i)}}}}}),"sugarcubePlugin");k.postcss=!0,module.exports=k;

package/dist/index.d.cts

@@ -5,6 +5,6 @@ interface PostcssSugarcubeOptions {
     validateOnly?: boolean;
     checkSync?: boolean;
 }
-declare const sugarcubePlugin: PluginCreator<PostcssSugarcubeOptions>;
+declare const sugarcubePlugin: PluginCreator<Record<string, unknown>>;
 
 export { type PostcssSugarcubeOptions, sugarcubePlugin as default };

package/dist/index.d.mts

@@ -5,6 +5,6 @@ interface PostcssSugarcubeOptions {
     validateOnly?: boolean;
     checkSync?: boolean;
 }
-declare const sugarcubePlugin: PluginCreator<PostcssSugarcubeOptions>;
+declare const sugarcubePlugin: PluginCreator<Record<string, unknown>>;
 
 export { type PostcssSugarcubeOptions, sugarcubePlugin as default };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-var h=Object.defineProperty;var u=(s,o)=>h(s,"name",{value:o,configurable:!0});var y=(s,o)=>()=>(o||s((o={exports:{}}).exports,o),o.exports);import p from"node:fs";import c from"node:path";import{loadConfig as b,tokensToCSSPipeline as v,getTokenPathsFromConfig as S,writeCSSFilesToDisk as k}from"@sugarcube-org/core";var A=y((N,m)=>{function E(s){return s&&"source"in s&&Array.isArray(s.source)}u(E,"isSingleCollection");function f(s,o,n=new Set){for(const r of s)if(!r.includes("*")&&p.existsSync(r)){const e=c.resolve(process.cwd(),r);n.has(e)||o.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:e})}else if(r.includes("*")){const e=c.dirname(r),t=c.basename(r);p.existsSync(e)&&o.messages.push({type:"dir-dependency",plugin:"postcss-sugarcube",dir:c.resolve(process.cwd(),e),glob:t})}}u(f,"processTokenSources");function P(s,o){if(o.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:c.resolve(process.cwd(),"sugarcube.config.json")}),!s.tokens)return;const n=s.output?.directories?.css||"./src/styles",r=new Set;if(s.output?.css?.separate?r.add(c.resolve(process.cwd(),`${n}/global/variables/colors.variables.css`)):r.add(c.resolve(process.cwd(),`${n}/tokens.css`)),E(s.tokens))f(s.tokens.source,o,r);else for(const[e,t]of Object.entries(s.tokens))t&&"source"in t&&Array.isArray(t.source)&&f(t.source,o,r)}u(P,"registerDependencies");function T(s){const o=s.filter(e=>e.file||e.source?.sourcePath),n=s.filter(e=>!e.file&&(!e.source||!e.source.sourcePath)),r=[];for(const e of o){const t=e.file||e.source?.sourcePath;if(!t)continue;const i=c.relative(process.cwd(),t),a=e.message.replace(t,i);r.push(a)}for(const e of n)r.push(e.message);return r.join(`
-  - `)}u(T,"formatErrors");let d=0;const g=u((s={})=>({postcssPlugin:"postcss-sugarcube",async Once(o,{result:n}){if(!n.opts.from){n.warn("No input file provided to postcss-sugarcube");return}try{const e=o.nodes[0];if(e&&e.type==="comment"&&e.text.includes("AUTOMATICALLY GENERATED FILE"))return;const t=await b();P(t,n);const i=await v(t),a=[...i.errors.load,...i.errors.flatten,...i.errors.validation,...i.errors.resolution];if(a.length>0){n.warn(`Token validation failed:
-  - ${T(a)}`,{plugin:"postcss-sugarcube",word:"error"});return}const w=S(t);await k(i.output,!0,w);const l=Date.now();!s.silent&&l-d>1e3&&(n.messages.push({type:"log",plugin:"postcss-sugarcube",text:"\u2728 Generated CSS files from tokens"}),d=l)}catch(e){n.warn(e instanceof Error?e.message:String(e),{plugin:"postcss-sugarcube",word:"error"})}}}),"sugarcubePlugin");g.postcss=!0,m.exports=g});export default A();
+var U=Object.defineProperty;var c=(s,e)=>U(s,"name",{value:e,configurable:!0});var A=(s,e)=>()=>(e||s((e={exports:{}}).exports,e),e.exports);import v from"node:fs";import f from"node:path";import{SUGARCUBE_CONFIG_FILE as m,loadConfig as _,Instrumentation as S,tokenProcessingPipeline as D,generateCSSVariables as T,writeCSSVariablesToDisk as G,generateCSSUtilityClasses as W,writeCSSUtilitiesToDisk as I}from"@sugarcube-org/core";var O=A((z,E)=>{var V=c((s,e)=>(e=Symbol[s])?e:Symbol.for("Symbol."+s),"__knownSymbol"),h=c(s=>{throw TypeError(s)},"__typeError"),y=c((s,e,l)=>{if(e!=null){typeof e!="object"&&typeof e!="function"&&h("Object expected");var t,u;t===void 0&&(t=e[V("dispose")]),typeof t!="function"&&h("Object not disposable"),u&&(t=c(function(){try{u.call(this)}catch(p){return Promise.reject(p)}},"dispose")),s.push([l,t,e])}return e},"__using"),b=c((s,e,l)=>{var t=typeof SuppressedError=="function"?SuppressedError:function(n,d,i,o){return o=Error(i),o.name="SuppressedError",o.error=n,o.suppressed=d,o},u=c(n=>e=l?new t(n,e,"An error was suppressed during disposal"):(l=!0,n),"fail"),p=c(n=>{for(;n=s.pop();)try{var d=n[1]&&n[1].call(n[2]);if(n[0])return Promise.resolve(d).then(p,i=>(u(i),p()))}catch(i){u(i)}if(l)throw e},"next");return p()},"__callDispose");const a=process.env.DEBUG==="true";function F(s){return s&&"source"in s&&Array.isArray(s.source)}c(F,"isSingleCollection");function k(s,e,l=new Set){for(const t of s)if(!t.includes("*")&&v.existsSync(t)){const u=f.resolve(process.cwd(),t);l.has(u)||e.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:u})}else if(t.includes("*")){const u=f.dirname(t),p=f.basename(t);v.existsSync(u)&&e.messages.push({type:"dir-dependency",plugin:"postcss-sugarcube",dir:f.resolve(process.cwd(),u),glob:p})}}c(k,"processTokenSources");function j(s,e){if(e.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:f.resolve(process.cwd(),m)}),!s.tokens)return;const l=s.output?.css||"./src/styles",t=new Set;if(s.output?.separate?t.add(f.resolve(process.cwd(),`${l}/global/variables/colors.variables.css`)):t.add(f.resolve(process.cwd(),`${l}/tokens.css`)),F(s.tokens))k(s.tokens.source,e,t);else for(const[u,p]of Object.entries(s.tokens))p&&"source"in p&&Array.isArray(p.source)&&k(p.source,e,t)}c(j,"registerDependencies");const w=c((s,e,l)=>{const t=l instanceof Error?l.message:String(l);s.warn(`[sugarcube] ${e}${t}`,{plugin:"postcss-sugarcube",word:"error"})},"reportError"),C=c(()=>(console.log("\u{1F3AF} PostCSS Sugarcube plugin is initializing"),{postcssPlugin:"postcss-sugarcube",prepare(s){console.log("\u26A1 PostCSS Sugarcube plugin is preparing..."),s.messages.push({type:"dependency",plugin:"postcss-sugarcube",file:f.resolve(process.cwd(),m)}),s.messages.push({type:"dir-dependency",plugin:"postcss-sugarcube",dir:f.resolve(process.cwd(),"src/design-tokens"),glob:"*.json"});let e=null;const l=c(async()=>{var n=[];try{const o=y(n,new S);if(a&&o.start("Process Tokens"),!e)throw new Error("Sugarcube config not initialized");a&&o.start("Token Processing Pipeline");const r=await D({type:"files",config:e.config}),g=[...r.errors.load,...r.errors.flatten,...r.errors.validation,...r.errors.resolution];return g.length>0&&w(s,`Token processing issues found:
+`,g.map(P=>`  - ${P.message}`).join(`
+`)),a&&o.end("Token Processing Pipeline"),a&&o.end("Process Tokens"),{resolved:r.resolved,trees:r.trees}}catch(o){var d=o,i=!0}finally{b(n,d,i)}},"processTokens"),t=c(async n=>{var d=[];try{const r=y(d,new S);if(a&&r.start("Generate and Write CSS Variables"),!e)throw new Error("Sugarcube config not initialized");a&&r.start("CSS Variables Pipeline");const g=await T(n.trees,n.resolved,e.config);a&&r.end("CSS Variables Pipeline"),a&&r.start("Write CSS Variables to Disk"),await G(g.output),a&&r.end("Write CSS Variables to Disk"),a&&r.end("Generate and Write CSS Variables")}catch(r){var i=r,o=!0}finally{b(d,i,o)}},"generateAndWriteCSSVariables"),u=c(async n=>{var d=[];try{const r=y(d,new S);if(a&&r.start("Generate and Write Utilities"),!e)throw new Error("Sugarcube config not initialized");a&&r.start("Generate Utility CSS");const{output:g}=W(n.resolved,e.config);a&&r.end("Generate Utility CSS"),a&&r.start("Write CSS Utilities to Disk"),await I(g),a&&r.end("Write CSS Utilities to Disk"),a&&r.end("Generate and Write Utilities")}catch(r){var i=r,o=!0}finally{b(d,i,o)}},"generateAndWriteUtilities"),p=c(async()=>{var n=[];try{const o=y(n,new S);a&&o.start("Process and Update");try{const r=await l();await t(r),await u(r)}catch(r){w(s,"Sugarcube processing failed",r)}a&&o.end("Process and Update")}catch(o){var d=o,i=!0}finally{b(n,d,i)}},"processAndUpdate");return{async Once(n){if(console.log("  Once called for file:",s.opts.from),!s.opts.from){s.warn("No input file provided to postcss-sugarcube");return}try{const i=n.nodes[0];if(i&&i.type==="comment"&&i.text.includes("AUTOMATICALLY GENERATED FILE"))return;e=await _(),j(e.config,s),await p()}catch(i){w(s,"Sugarcube processing failed",i)}}}}}),"sugarcubePlugin");C.postcss=!0,E.exports=C});export default O();

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "@sugarcube-org/postcss",
-  "version": "0.0.1-alpha.2",
+  "version": "0.0.1-alpha.3",
+  "description": "PostCSS plugin for sugarcube",
+  "license": "UNLICENSED",
+  "author": "Mark Tomlinson",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sugarcube-org/sugarcube"
+  },
   "exports": {
     "require": {
       "types": "./dist/index.d.cts",
@@ -15,7 +22,7 @@
     "dist/"
   ],
   "dependencies": {
-    "@sugarcube-org/core": "0.0.1-alpha.5"
+    "@sugarcube-org/core": "0.0.1-alpha.6"
   },
   "peerDependencies": {
     "postcss": "^8.4.0"
@@ -26,7 +33,7 @@
     "tsx": "^4.19.2"
   },
   "scripts": {
-    "build": "pkgroll --minify --clean-dist",
+    "build": "pkgroll --minify",
     "dev": "pkgroll --watch",
     "type-check": "tsc --noEmit"
   }