maverick-wave 5.29.0 → 5.31.0

package/CLAUDE.md

@@ -1,60 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-MaverickWave is a lightweight, modern CSS framework providing a grid system, 59 UI components, utility classes, and light/dark mode support. The repo also contains the showcase/documentation website bundled into the distribution.
-
-## Commands
-
-```bash
-npm start          # Build + watch for changes (development)
-npm run build      # Clean dist, then full build
-npm run showcase   # Serve built dist on http://localhost:8888
-npm run clean      # Remove dist/ (never touches the root release files)
-npm run format     # Check formatting of SCSS, JS, JSON, HTML, MD (used by CI)
-npm run format:fix # Format all files with Prettier
-npm run verify     # Consistency checks between built CSS, markup and docs
-npm run prepack    # Build minified maverick-wave.min.{css,js} in project root
-                   # (runs automatically before npm pack / npm publish)
-```
-
-There are no test or lint scripts.
-
-## Architecture
-
-**Build pipeline** - `gulpfile.js` orchestrates everything: SCSS compilation (autoprefixed, minified), JS minification via Terser, HTML templating via `gulp-file-include`, asset copying, and build-info injection (`{{VERSION}}`, `{{LAST_BUILD_DATE}}`, `{{LAST_BUILD_YEAR}}` placeholders replaced in HTML at build time).
-
-**SCSS layers** (`src/scss/`) follow an ITCSS-inspired structure:
-
-- `abstracts/` - CSS custom properties, mixins, SCSS functions (color variant generation)
-- `base/` - Reset, element defaults, typography
-- `components/` - Self-contained component styles (59 files, one per component)
-- `form-elements/` - Form input/select/checkbox-specific styles
-- `layout/` - Grid, container, header/footer, section
-- `utilities/` - Spacing, flex, display utility classes
-- `main.scss` - Entry point using `@use`/`@forward` (not `@import`)
-
-**Mobile-first** - The unprefixed block is the phone layout; `media-up($bp)` adds
-to it. `media-down($bp)` only for rules that set what the base never sets, or
-where the narrow layout costs more properties than the wide one.
-
-**JavaScript** (`src/js/main.js`) - Single file. All components auto-initialize on `DOMContentLoaded`. Includes: gallery and image sliders, theme toggle (persisted to localStorage, transitions suppressed during the flip), accordion, mobile nav, progress bar (IntersectionObserver), scroll spy, tabs (which also get their ARIA and arrow-key handling here), alerts/toasts, modals, range inputs, dropdowns, language switcher, checkbox lists, kanban board, calendar, portrait gallery, mosaic, lightbox, story reels.
-
-**HTML showcase** (`index.html` + `src/partials/`) - The top-level `index.html` uses `@@include()` syntax to pull in 72 partials from `src/partials/`. These compile into `dist/index.html`.
-
-## Naming Conventions
-
-- **CSS classes**: `mw-` prefix for all framework classes (`.mw-btn`, `.mw-card`, `.mw-modal`)
-- **State classes**: `.mw-active`, `.mw-selected`
-- **CSS custom properties**: `--mw-` prefix (`--mw-primary-color`, `--mw-font-family-base`)
-- **Theme control**: `--mw-internal-theme-mode` CSS var controls whether theme is switchable/fixed-light/fixed-dark; body class `mw-theme-light` toggles light mode
-
-## Code Formatting
-
-Prettier is the single formatter. Config (`.prettierrc.json`): single quotes, 80-char print width, 2-space tabs, semicolons, trailing commas (ES5). Run `npm run format:fix` before committing.
-
-## Commit Convention
-
-Follows Conventional Commits: `feat:`, `fix:`, `release:`, etc.

package/gulpfile.js

@@ -1,167 +0,0 @@
-const gulp = require('gulp');
-const fileinclude = require('gulp-file-include');
-const sass = require('gulp-sass')(require('sass'));
-const postcss = require('gulp-postcss');
-const autoprefixer = require('autoprefixer');
-// clean-css 4 is the last release gulp-clean-css pins, and it predates
-// @container, @layer and @starting-style: it drops those blocks or eats their
-// selectors without an error. cssnano runs in the postcss pass that is already
-// here and understands them.
-const cssnano = require('cssnano');
-// postcss-calc cannot lex relative color syntax - `calc(l * 0.85)` inside
-// `oklch(from ...)` makes it log a parse error per declaration. It leaves the
-// value alone, so the output was always correct, but the noise buried real
-// build errors. Switching it off leaves ten calc() terms unfolded
-// (`calc(500px - 1.5rem - 2px)` stays as written), worth about 100 bytes across
-// the whole file - cheaper than a build log nobody reads.
-const cssnanoPreset = ['default', { calc: false }];
-const terser = require('gulp-terser');
-const fs = require('fs');
-const path = require('path');
-const rename = require('gulp-rename');
-const through = require('through2');
-const { deleteAsync } = require('del');
-
-// Paths
-const paths = {
-  root: '.',
-  src: 'src',
-  dist: 'dist',
-  scss: 'src/scss/**/*.scss',
-  html: '*.html',
-  js: 'src/js/*.js',
-  assets: 'src/assets/**/*',
-};
-
-function convertDateFormat(dateStr) {
-  // Use regex to match day, month, and year
-  const regex = /(\d{2})\/(\d{2})\/(\d{4})/;
-  // Replace with year-month-day format
-  return dateStr.replace(regex, '$3-$2-$1');
-}
-
-// Process HTML files
-gulp.task('html', function () {
-  return gulp
-    .src(paths.html)
-    .pipe(
-      fileinclude({
-        prefix: '@@',
-        basepath: '@file',
-      })
-    )
-    .pipe(gulp.dest(paths.dist));
-});
-
-// Process SCSS files
-gulp.task('scss-build', function () {
-  return gulp
-    .src(paths.scss)
-    .pipe(sass().on('error', sass.logError))
-    .pipe(postcss([autoprefixer(), cssnano({ preset: cssnanoPreset })]))
-    .pipe(rename('maverick-wave.min.css'))
-    .pipe(gulp.dest(path.join(paths.dist)));
-});
-gulp.task('scss-release', function () {
-  return gulp
-    .src(paths.scss)
-    .pipe(sass().on('error', sass.logError))
-    .pipe(postcss([autoprefixer(), cssnano({ preset: cssnanoPreset })]))
-    .pipe(rename('maverick-wave.min.css'))
-    .pipe(gulp.dest(path.join(paths.root)));
-});
-
-// Copy JavaScript files
-gulp.task('js-build', function () {
-  return gulp
-    .src(paths.js)
-    .pipe(terser())
-    .pipe(rename('maverick-wave.min.js'))
-    .pipe(gulp.dest(path.join(paths.dist)));
-});
-gulp.task('js-release', function () {
-  return gulp
-    .src(paths.js)
-    .pipe(terser())
-    .pipe(rename('maverick-wave.min.js'))
-    .pipe(gulp.dest(path.join(paths.root)));
-});
-
-// Copy assets
-gulp.task('assets', function () {
-  return gulp
-    .src(paths.assets, { encoding: false })
-    .pipe(gulp.dest(path.join(paths.dist)));
-});
-
-// Inject build info into HTML
-gulp.task('inject-build-info', function () {
-  // Get package.json data
-  const packageJson = JSON.parse(fs.readFileSync('./package.json', 'utf8'));
-
-  // Create build info object
-  const buildInfo = {
-    name: packageJson.name,
-    version: packageJson.version,
-    buildDate: convertDateFormat(new Date().toLocaleDateString('en-DE')),
-  };
-
-  // Create a custom transform stream to inject build info
-  const injectBuildInfo = through.obj(function (file, enc, cb) {
-    if (file.isBuffer()) {
-      let contents = file.contents.toString();
-
-      // Replace placeholders with actual values
-      contents = contents.replace(/\{\{VERSION\}\}/g, buildInfo.version);
-      contents = contents.replace(
-        /\{\{LAST_BUILD_DATE\}\}/g,
-        buildInfo.buildDate
-      );
-      contents = contents.replace(
-        /\{\{LAST_BUILD_YEAR\}\}/g,
-        buildInfo.buildDate.slice(0, 4)
-      );
-
-      file.contents = Buffer.from(contents);
-    }
-
-    this.push(file);
-    cb();
-  });
-
-  return gulp
-    .src(path.join(paths.dist, '*.html'))
-    .pipe(injectBuildInfo)
-    .pipe(gulp.dest(paths.dist));
-});
-
-// clean - remove dist only. The root maverick-wave.min.* files are committed
-// release artifacts - deleting them here once shipped a broken npm package
-// (4.22.0) because a plain build before publish wiped them.
-gulp.task('clean', async function () {
-  await deleteAsync(['dist'], { force: true });
-});
-
-// Watch for changes
-gulp.task('watch', function () {
-  gulp.watch(paths.scss, gulp.series('scss-build'));
-  gulp.watch('*.html', gulp.series('html', 'inject-build-info'));
-  gulp.watch('src/partials/*.html', gulp.series('html', 'inject-build-info'));
-  gulp.watch(paths.js, gulp.series('js-build'));
-  gulp.watch(paths.assets, gulp.series('assets'));
-});
-
-// Build task
-gulp.task(
-  'build',
-  gulp.series(
-    gulp.parallel('scss-build', 'js-build', 'assets', 'html'),
-    'inject-build-info'
-  )
-);
-
-// Release task
-gulp.task('release', gulp.series(gulp.parallel('scss-release', 'js-release')));
-
-// Default task
-gulp.task('default', gulp.series('build', 'watch'));