refactor: v3

.gitignore

@@ -4,6 +4,9 @@ node_modules
 # PostCSS
 .postcssrc.yml
 
+# Core-Styles
+dist
+
 # Fractal
 demo
 ## Files used directly by demo but not clients, yet provided via dist

HOWTO.md

@@ -37,7 +37,7 @@ Load `core-styles.base.css` from a CDN e.g. [JSDeliver].
 - Or in CSS:
 
     ```css
-    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.base.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.base.css"\);
     ```
 
 ### 2. Project
@@ -61,7 +61,7 @@ Load any one of these relevant project-type CSS from a CDN e.g. [JSDeliver]:
 - Or in CSS:
 
     ```css
-    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.______.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.______.css"\);
     ```
 
     Replace `______` with `cms` or `docs` or `portal`.
@@ -81,7 +81,7 @@ Load stylesheets from your project.
 - Or in CSS:
 
     ```css
-    @import url("/your/project/stylesheet.css");
+    @import url("/your/project/stylesheet.postcss");
     ```
 
 ## Use **Some** of [Core Styles]
@@ -120,7 +120,7 @@ Load `core-styles.settings.css` from a CDN e.g. [JSDeliver].
 - Or in CSS:
 
     ```css
-    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.settings.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.settings.css"\);
     ```
 
 ### Load a [Core Styles] Pattern
@@ -136,7 +136,7 @@ To use a pattern as is.
 - Or in CSS:
 
     ```css
-    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.settings.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.settings.css"\);
     ```
 
 ### Extend a [Core Styles] Pattern
@@ -157,7 +157,7 @@ To use a pattern but also change it to fit a unique requirement of your site.
 - Or in CSS:
 
     ```css
-    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.settings.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/[email protected]/dist/core-styles.settings.css"\);
 
     .c-message--scope-section {
       margin-bottom: 1em;

README.md

@@ -238,6 +238,12 @@ npm run build:css
 npm run build:css -- --build-id="..."
 ```
 
+##### Build Individual Stylesheets
+
+```bash
+npm run build:each -- src/lib/_imports/components/align.postcss src/lib/_imports/components/admonition.postcss ...
+```
+
 
 ## Testing
 

bin/build-each.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+/** Build one stylesheet via the Core-Styles API */
+
+const { buildStylesheets } = require('../src/main');
+
+const inputs = process.argv.slice( 2 );
+
+/* Theme: (default) */
+inputs.forEach( input => {
+    buildStylesheets( input, undefined, './dist');
+});

bin/build.js

@@ -9,7 +9,7 @@ const ARGS = mininmist( process.argv.slice( 2 ) );
 const BUILD_ID = ARGS['build-id'] || '';
 
 /* Theme: (default) */
-buildStylesheets('src/lib/_imports/**/*!(fractal.server.refresh).css', './dist', {
+buildStylesheets('src/lib/_imports/**/*!(fractal.server.refresh).postcss', './dist', {
   baseMirrorDir: 'src/lib/_imports',
   buildId: BUILD_ID
 });

bin/only-commit-source.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+function findBuiltFiles( dir ) {
+  let builtFiles = [];
+  const files = fs.readdirSync( dir );
+
+  for ( const file of files ) {
+    const filePath = path.join( dir, file );
+    const relativePath = path.relative( path.join( __dirname, '../'), filePath );
+    const isDirectory = fs.statSync( filePath ).isDirectory();
+
+    if ( isDirectory ) {
+      builtFiles.push(...findBuiltFiles( filePath ));
+      continue;
+    }
+
+    const isProbablyBuilt = filePath.endsWith('.css');
+    const shouldIgnore = (
+      /_imports\/[^/]+\/[^/]+\/[^/]+\.css$/.test(relativePath) ||
+      filePath.endsWith('fractal.server.refresh.css') ||
+      relativePath.includes('_imports/vendors') ||
+      filePath.endsWith('README.css')
+    );
+
+    if ( isProbablyBuilt && ! shouldIgnore ) {
+      builtFiles.push( relativePath );
+    }
+  }
+
+  return builtFiles;
+}
+
+const sourceDir = path.join( __dirname, '../', 'src');
+const sourceFiles = findBuiltFiles( sourceDir );
+
+if ( sourceFiles.length > 0 ) {
+  console.error(
+    `Found ${sourceFiles.length} dist files in source. Remove to permit publish:`
+  );
+  sourceFiles.forEach( file =>
+    console.error(`- ${file}`)
+  );
+
+  process.exit(1);
+} else {
+  console.log(
+    'No dist files found in source. Ready to publish.'
+  );
+}