refactor: v3

.gitignore

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

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/**/*!(fractality.server.refresh).css', './dist', {
+buildStylesheets('src/lib/_imports/**/*!(fractality.server.refresh).postcss', './dist', {
   baseMirrorDir: 'src/lib/_imports',
   buildId: BUILD_ID
 });

bin/only-commit-source.js

@@ -0,0 +1,73 @@
+#!/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 basename = path.basename( filePath, '.css' );
+
+    // `.css` files exactly 2 directories below `_imports/` are source files
+    // in the reorganized third-party library structure (e.g. Bootstrap 4/5).
+    // They use `.css` extension by convention and are not build artifacts.
+    const isLibrarySource = /_imports\/[^/]+\/[^/]+\/[^/]+\.css$/.test( relativePath );
+
+    // `core-styles.*.css` files are consumer-facing entry points in `_imports/`;
+    // they aggregate @imports for a client library and must be published.
+    const isEntryPoint = /_imports\/core-styles\.[^/]+\.css$/.test( relativePath );
+
+    // Files whose name starts with `demo` / `example`, or contains `.demo`,
+    // are Fractal-only demo helpers and are never compiled into the package.
+    const isDemoOrExample = /(?:^demo(?:[.-]|$)|\.demo(?:[.-]|$)|^example(?:[.-]|$))/.test( basename );
+
+    // `_imports/vendors/` exists on epic/v3 but is removed on epic/v3--reorg;
+    // this rule becomes a no-op once the reorg merges in.
+    const isVendored = relativePath.includes( '_imports/vendors' );
+
+    const shouldIgnore = (
+      isLibrarySource ||
+      filePath.endsWith('fractality.server.refresh.css') ||
+      isVendored ||
+      filePath.endsWith('README.css') ||
+      isEntryPoint ||
+      isDemoOrExample
+    );
+
+    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.'
+  );
+}