@abreen/tada 1.0.2 → 1.2.0

package/webpack/build-state.js

@@ -1,97 +0,0 @@
-const watchStateByCompiler = new WeakMap();
-const buildDeltaByCompiler = new WeakMap();
-
-function cloneSet(values) {
-  return new Set(values || []);
-}
-
-function getEmptyBuildDelta() {
-  return {
-    changedSourceFiles: new Set(),
-    changedHtmlAssetPaths: new Set(),
-    removedHtmlAssetPaths: new Set(),
-    templatesChanged: false,
-  };
-}
-
-function setWatchState(compiler, watchState) {
-  watchStateByCompiler.set(compiler, {
-    contentFiles: cloneSet(watchState?.contentFiles),
-    buildContentFiles: cloneSet(watchState?.buildContentFiles),
-    changedContentFiles: cloneSet(watchState?.changedContentFiles),
-    templatesChanged: Boolean(watchState?.templatesChanged),
-    structureChanged: Boolean(watchState?.structureChanged),
-  });
-}
-
-function getWatchState(compiler) {
-  const state = watchStateByCompiler.get(compiler);
-  if (!state) {
-    return null;
-  }
-
-  return {
-    contentFiles: cloneSet(state.contentFiles),
-    buildContentFiles: cloneSet(state.buildContentFiles),
-    changedContentFiles: cloneSet(state.changedContentFiles),
-    templatesChanged: state.templatesChanged,
-    structureChanged: state.structureChanged,
-  };
-}
-
-function setBuildDelta(compiler, buildDelta) {
-  buildDeltaByCompiler.set(compiler, {
-    changedSourceFiles: cloneSet(buildDelta?.changedSourceFiles),
-    changedHtmlAssetPaths: cloneSet(buildDelta?.changedHtmlAssetPaths),
-    removedHtmlAssetPaths: cloneSet(buildDelta?.removedHtmlAssetPaths),
-    templatesChanged: Boolean(buildDelta?.templatesChanged),
-  });
-}
-
-function mergeIntoSet(target, values) {
-  if (!values) {
-    return;
-  }
-
-  for (const value of values) {
-    target.add(value);
-  }
-}
-
-function updateBuildDelta(compiler, buildDelta) {
-  const current = getBuildDelta(compiler);
-  mergeIntoSet(current.changedSourceFiles, buildDelta?.changedSourceFiles);
-  mergeIntoSet(
-    current.changedHtmlAssetPaths,
-    buildDelta?.changedHtmlAssetPaths,
-  );
-  mergeIntoSet(
-    current.removedHtmlAssetPaths,
-    buildDelta?.removedHtmlAssetPaths,
-  );
-  current.templatesChanged =
-    current.templatesChanged || Boolean(buildDelta?.templatesChanged);
-  buildDeltaByCompiler.set(compiler, current);
-}
-
-function getBuildDelta(compiler) {
-  const delta = buildDeltaByCompiler.get(compiler);
-  if (!delta) {
-    return getEmptyBuildDelta();
-  }
-
-  return {
-    changedSourceFiles: cloneSet(delta.changedSourceFiles),
-    changedHtmlAssetPaths: cloneSet(delta.changedHtmlAssetPaths),
-    removedHtmlAssetPaths: cloneSet(delta.removedHtmlAssetPaths),
-    templatesChanged: delta.templatesChanged,
-  };
-}
-
-module.exports = {
-  getBuildDelta,
-  getWatchState,
-  setBuildDelta,
-  setWatchState,
-  updateBuildDelta,
-};

package/webpack/colors.js

@@ -1,15 +0,0 @@
-const util = require('util');
-
-const R = (str, ...args) => util.styleText(['red'], String.raw(str, ...args));
-const G = (str, ...args) => util.styleText(['green'], String.raw(str, ...args));
-const B = (str, ...args) => util.styleText(['blue'], String.raw(str, ...args));
-const Y = (str, ...args) =>
-  util.styleText(['yellow'], String.raw(str, ...args));
-const L = (str, ...args) =>
-  util.styleText(['blackBright'], String.raw(str, ...args));
-const P = (str, ...args) =>
-  util.styleText(['magenta'], String.raw(str, ...args));
-const I = (str, ...args) =>
-  util.styleText(['italic', 'bold'], String.raw(str, ...args));
-
-module.exports = { R, G, B, Y, L, P, I };

package/webpack/config.base.js

@@ -1,151 +0,0 @@
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const _ = require('lodash');
-const CopyPlugin = require('copy-webpack-plugin');
-const MiniCssExtractPlugin = require('mini-css-extract-plugin');
-const GenerateContentAssetsPlugin = require('./generate-content-assets-plugin');
-const PagefindPlugin = require('./pagefind-plugin');
-const GenerateFaviconPlugin = require('./generate-favicon-plugin');
-const GenerateManifestPlugin = require('./generate-manifest-plugin');
-const GenerateFontsPlugin = require('./generate-fonts-plugin');
-const { getDistDir, createDefinePlugin } = require('./util');
-const { isFeatureEnabled } = require('./features');
-const {
-  getContentDir,
-  getPackageDir,
-  getProjectDir,
-  getPublicDir,
-} = require('./utils/paths');
-const { parseHsl } = require('./utils/parse-hsl');
-
-const distDir = getDistDir();
-
-function renderThemeScss(siteVariables) {
-  const templatePath = path.join(getPackageDir(), 'templates/_theme.scss');
-  const template = fs.readFileSync(templatePath, 'utf-8');
-  const { hue, saturation, lightness } = parseHsl(siteVariables.themeColor);
-  const tintHue = siteVariables.tintHue ?? 20;
-  const tintAmount = siteVariables.tintAmount ?? 100;
-  const rendered = _.template(template)({
-    themeHue: hue,
-    themeSaturation: saturation,
-    themeLightness: lightness,
-    tintHue,
-    tintAmount,
-  });
-
-  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'tada-'));
-  const configDir = path.join(tmpDir, 'config');
-  fs.mkdirSync(configDir);
-  fs.writeFileSync(path.join(configDir, '_theme.scss'), rendered);
-
-  return tmpDir;
-}
-
-function createModuleRules(siteVariables) {
-  const packageDir = getPackageDir();
-  const themeDir = renderThemeScss(siteVariables);
-
-  return [
-    { test: /\.js$/, exclude: /node_modules/, use: { loader: 'babel-loader' } },
-    {
-      test: /\.tsx?$/,
-      include: path.resolve(packageDir, 'src'),
-      loader: 'ts-loader',
-      options: { configFile: path.resolve(packageDir, 'tsconfig.json') },
-    },
-    {
-      test: /\.(sa|sc|c)ss$/,
-      use: [
-        MiniCssExtractPlugin.loader,
-        {
-          loader: 'css-loader',
-          options: {
-            url: {
-              // Don't bundle fonts (they are handled by GenerateFontsPlugin)
-              filter: url => !url.endsWith('.woff2'),
-            },
-          },
-        },
-        {
-          loader: 'sass-loader',
-          options: { sassOptions: { loadPaths: [themeDir, getProjectDir()] } },
-        },
-      ],
-    },
-  ];
-}
-
-async function createPlugins(
-  siteVariables,
-  { defineIsDev = false, plugins = [] } = {},
-) {
-  return [
-    new GenerateContentAssetsPlugin(siteVariables),
-    createDefinePlugin(siteVariables, defineIsDev),
-    new MiniCssExtractPlugin({
-      filename: '[name].css',
-      chunkFilename: '[id].css',
-    }),
-    new CopyPlugin({
-      patterns: [
-        { from: getPublicDir(), to: '.', noErrorOnMissing: true },
-        {
-          from: '**/*.{png,jpg,jpeg,gif,svg,txt,zip}',
-          context: getContentDir(),
-          to: '[path][name][ext]',
-          noErrorOnMissing: true,
-        },
-      ],
-    }),
-    isFeatureEnabled(siteVariables, 'search')
-      ? new PagefindPlugin(siteVariables)
-      : null,
-    isFeatureEnabled(siteVariables, 'favicon')
-      ? new GenerateFaviconPlugin(siteVariables)
-      : null,
-    isFeatureEnabled(siteVariables, 'favicon')
-      ? new GenerateManifestPlugin(siteVariables)
-      : null,
-    new GenerateFontsPlugin(),
-    ...plugins,
-    require('./print-flair-plugin'),
-  ].filter(Boolean);
-}
-
-async function createBaseConfig({
-  mode,
-  siteVariables,
-  entry,
-  devtool,
-  defineIsDev = false,
-  optimization,
-  plugins,
-}) {
-  const packageDir = getPackageDir();
-  return {
-    mode,
-    entry,
-    output: {
-      path: distDir,
-      publicPath: siteVariables.basePath,
-      filename: '[name].bundle.js',
-    },
-    resolve: { extensions: ['.ts', '.js', '.json'] },
-    resolveLoader: {
-      modules: [
-        path.resolve(packageDir, 'node_modules'),
-        path.resolve(packageDir, '..', '..'),
-        'node_modules',
-      ],
-    },
-    devtool,
-    module: { rules: createModuleRules(siteVariables) },
-    ...(optimization && { optimization }),
-    plugins: await createPlugins(siteVariables, { defineIsDev, plugins }),
-    stats: 'errors-only',
-  };
-}
-
-module.exports = { createBaseConfig };

package/webpack/config.dev.js

@@ -1,23 +0,0 @@
-const path = require('path');
-const ContentWatchPlugin = require('./content-watch-plugin');
-const { createBaseConfig } = require('./config.base');
-const { getDevSiteVariables } = require('./site-variables');
-const { getPackageDir } = require('./utils/paths');
-
-module.exports = async (env = {}) => {
-  const siteVariables = getDevSiteVariables();
-  const packageDir = getPackageDir();
-  const entry = { index: path.resolve(packageDir, 'src/index.ts') };
-  if (env.watchMode) {
-    entry.reload = path.resolve(packageDir, 'webpack/watch-reload-client.js');
-  }
-
-  return createBaseConfig({
-    mode: 'development',
-    devtool: 'inline-source-map',
-    siteVariables,
-    entry,
-    defineIsDev: true,
-    plugins: [new ContentWatchPlugin(siteVariables)],
-  });
-};

package/webpack/config.prod.js

@@ -1,32 +0,0 @@
-const path = require('path');
-const TerserPlugin = require('terser-webpack-plugin');
-const { createBaseConfig } = require('./config.base');
-const { compileTemplates } = require('./templates');
-const { getProdSiteVariables } = require('./site-variables');
-const { getPackageDir } = require('./utils/paths');
-
-const siteVariables = getProdSiteVariables();
-
-module.exports = async () => {
-  compileTemplates(siteVariables);
-
-  return createBaseConfig({
-    mode: 'production',
-    siteVariables,
-    entry: { index: path.resolve(getPackageDir(), 'src/index.ts') },
-    devtool: false,
-    optimization: {
-      minimizer: [
-        /*
-         * Bun's event loop doesn't track TerserPlugin's worker threads,
-         * causing a premature exit; set parallel to false to prevent worker
-         * threads from being used.
-         */
-        new TerserPlugin({
-          parallel: false,
-          terserOptions: { output: { comments: false } },
-        }),
-      ],
-    },
-  });
-};

package/webpack/content-watch-plugin.js

@@ -1,153 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const {
-  getContentDir,
-  getContentFiles,
-  getBuildContentFiles,
-} = require('./util');
-const { setWatchState } = require('./build-state');
-const {
-  compileTemplates,
-  getHtmlTemplatesDir,
-  getJsonDataDir,
-  JSON_DATA_FILES,
-} = require('./templates');
-const { getProjectDir } = require('./utils/paths');
-
-let _needsRestart = false;
-
-class ContentWatchPlugin {
-  constructor(siteVariables) {
-    this.siteVariables = siteVariables;
-    this.siteConfigPath = path.resolve(
-      getProjectDir(),
-      'config',
-      'site.dev.json',
-    );
-  }
-
-  apply(compiler) {
-    let lastSig = null;
-
-    compiler.hooks.make.tap('ContentWatchPlugin', compilation => {
-      const htmlTemplatesDir = getHtmlTemplatesDir();
-      const jsonDataDir = getJsonDataDir();
-
-      // Refresh templates cache from disk
-      try {
-        compileTemplates(this.siteVariables);
-      } catch (err) {
-        compilation.errors.push(err);
-        for (const fileName of fs.readdirSync(htmlTemplatesDir)) {
-          compilation.fileDependencies.add(
-            path.join(htmlTemplatesDir, fileName),
-          );
-        }
-        for (const dataFile of JSON_DATA_FILES) {
-          const dataPath = path.join(jsonDataDir, dataFile);
-          if (fs.existsSync(dataPath)) {
-            compilation.fileDependencies.add(dataPath);
-          }
-        }
-        return;
-      }
-
-      const contentDir = getContentDir();
-      const modifiedFiles = new Set(
-        [...(compiler.modifiedFiles || [])].map(filePath =>
-          path.resolve(filePath),
-        ),
-      );
-      const normalizedContentDir = path.resolve(contentDir) + path.sep;
-      const normalizedHtmlDir = path.resolve(htmlTemplatesDir) + path.sep;
-      const contentFiles = getContentFiles(
-        contentDir,
-        Object.keys(this.siteVariables.codeLanguages),
-      );
-      const buildContentFiles = getBuildContentFiles(
-        contentDir,
-        Object.keys(this.siteVariables.codeLanguages),
-      );
-
-      // Detect structural changes (files added or deleted) that require a
-      // fresh compiler with updated content asset caches
-      const sig = buildContentFiles.slice().sort().join('\0');
-      let structureChanged = false;
-      if (lastSig !== null && sig !== lastSig) {
-        _needsRestart = true;
-        structureChanged = true;
-      }
-      lastSig = sig;
-
-      const changedContentFiles = new Set(
-        [...modifiedFiles].filter(filePath =>
-          filePath.startsWith(normalizedContentDir),
-        ),
-      );
-
-      // Check if any HTML template or JSON data file changed
-      const jsonDataPaths = JSON_DATA_FILES.map(f =>
-        path.resolve(jsonDataDir, f),
-      );
-      const templatesChanged = [...modifiedFiles].some(
-        filePath =>
-          filePath === path.resolve(htmlTemplatesDir) ||
-          filePath.startsWith(normalizedHtmlDir) ||
-          jsonDataPaths.includes(filePath),
-      );
-
-      setWatchState(compiler, {
-        contentFiles,
-        buildContentFiles,
-        changedContentFiles,
-        templatesChanged,
-        structureChanged,
-      });
-
-      // Tell webpack to watch all content files
-      for (const filePath of contentFiles) {
-        compilation.fileDependencies.add(filePath);
-      }
-
-      // Watch content directories so webpack detects newly added files
-      function addDirs(dir) {
-        compilation.contextDependencies.add(dir);
-        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-          if (entry.isDirectory()) {
-            addDirs(path.join(dir, entry.name));
-          }
-        }
-      }
-      addDirs(contentDir);
-
-      // Watch HTML template files from the package
-      for (const fileName of fs.readdirSync(htmlTemplatesDir)) {
-        compilation.fileDependencies.add(path.join(htmlTemplatesDir, fileName));
-      }
-
-      // Watch JSON data files from the project config
-      for (const dataFile of JSON_DATA_FILES) {
-        const dataPath = path.join(jsonDataDir, dataFile);
-        if (fs.existsSync(dataPath)) {
-          compilation.fileDependencies.add(dataPath);
-        }
-      }
-
-      // Watch the site config file and restart when it changes
-      compilation.fileDependencies.add(this.siteConfigPath);
-      const siteConfigChanged = modifiedFiles.has(
-        path.resolve(this.siteConfigPath),
-      );
-      if (siteConfigChanged) {
-        _needsRestart = true;
-      }
-    });
-  }
-}
-
-ContentWatchPlugin.needsRestart = () => _needsRestart;
-ContentWatchPlugin.clearRestart = () => {
-  _needsRestart = false;
-};
-
-module.exports = ContentWatchPlugin;

package/webpack/features.js

@@ -1,5 +0,0 @@
-function isFeatureEnabled(siteVariables, featureName) {
-  return siteVariables.features?.[featureName] !== false;
-}
-
-module.exports = { isFeatureEnabled };