epic/v3: do not commit /dist & source files as .postcss (#407)

* feat!: remove dist

* conf!: ignore dist

* feat!: prevent publish if .css in src

Need next to:
- Rename source files to .postcss.
- Deal with demo stylesheets.

* feat: log if no dist found in source

* refactor: optimizations

* refactor: renamed vars

* refactor: renamed source .css files to .postcss

* refactor: move **/*.css source to ../*.postcss

* fix/refactor: load .postcsss not .css

* temp: restore dist (rebuilt) to diff

* revert "conf!: ignore dist" (manually)

* chore: delete & ignore dist (again)

I checked diff with base branch. All good:
- Diff had changes (unexpected).
- Diff changes were rmeoval of demo and outdated files.

* chore: ignore dist

* chore: delete util script

* fix: ignore fractal util file

.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/core-styles@2.25.3/dist/core-styles.base.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.25.3/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/core-styles@2.25.3/dist/core-styles.______.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.25.3/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/core-styles@2.25.3/dist/core-styles.settings.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.25.3/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/core-styles@2.25.3/dist/core-styles.settings.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.25.3/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/core-styles@2.25.3/dist/core-styles.settings.css");
+    @import url("https://cdn.jsdelivr.net/npm/@tacc/core-styles@2.25.3/dist/core-styles.settings.css"\);
 
     .c-message--scope-section {
       margin-bottom: 1em;

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,50 @@
+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, '../src'), filePath );
+    const isDirectory = fs.statSync( filePath ).isDirectory();
+
+    if ( isDirectory ) {
+      builtFiles.push(...findBuiltFiles( filePath ));
+      continue;
+    }
+
+    const isProbablyBuilt = filePath.endsWith('.css');
+    const shouldIgnore = (
+      /^lib\/_imports\/[^/]+\/[^/]+\/[^/]+\.css$/.test(relativePath) ||
+      filePath.endsWith('fractal.server.refresh.css') ||
+      relativePath.includes('_imports/vendors') ||
+      filePath.endsWith('README.css')
+    );
+
+    if ( isProbablyBuilt && ! shouldIgnore ) {
+      builtFiles.push(filePath);
+    }
+  }
+
+  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.'
+  );
+}