@docmd/core 0.4.0

package/src/utils/fs-utils.js

@@ -0,0 +1,40 @@
+// Source file from the docmd project — https://github.com/docmd-io/docmd
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+
+async function ensureDir(dirPath) {
+  await fs.mkdir(dirPath, { recursive: true });
+}
+
+async function remove(dirPath) {
+  await fs.rm(dirPath, { recursive: true, force: true });
+}
+
+async function copy(src, dest) {
+  await fs.cp(src, dest, { recursive: true });
+}
+
+async function exists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function writeJson(file, object, options = {}) {
+  const content = JSON.stringify(object, null, options.spaces || 2);
+  await fs.writeFile(file, content, 'utf8');
+}
+
+module.exports = {
+  ...fs,
+  ensureDir,
+  remove,
+  copy,
+  pathExists: exists,
+  exists,
+  writeJson
+};

package/src/utils/logger.js

@@ -0,0 +1,21 @@
+// Source file from the docmd project — https://github.com/docmd-io/docmd
+
+const chalk = require('chalk');
+
+const { version } = require('../../package.json');
+
+const printBanner = () => {
+  const logo = `
+                       
+${chalk.blue('     _                 _ ')}
+${chalk.blue('   _| |___ ___ _____ _| |')}
+${chalk.blue('  | . | . |  _|     | . |')}
+${chalk.blue('  |___|___|___|_|_|_|___|')}
+  `;
+
+  console.log(logo);
+  console.log(`   ${chalk.dim(`v${version}`)}`);
+  console.log(`\n`);
+};
+
+module.exports = { printBanner };

package/src/utils/plugin-loader.js

@@ -0,0 +1,90 @@
+const chalk = require('chalk');
+
+const hooks = {
+  markdownSetup: [],
+  injectHead: [],
+  injectBody: [],
+  onPostBuild: [],
+  assets: [],
+  getClientAssets: [] // Legacy support
+};
+
+// Map short names to package names
+const ALIASES = {
+  'search': '@docmd/plugin-search',
+  'seo': '@docmd/plugin-seo',
+  'sitemap': '@docmd/plugin-sitemap',
+  'analytics': '@docmd/plugin-analytics',
+  'mermaid': '@docmd/plugin-mermaid'
+};
+
+function loadPlugins(config) {
+  // 1. Reset hooks
+  Object.keys(hooks).forEach(key => hooks[key] = []);
+
+  // 2. Initialize Plugin Map (Name -> Options)
+  // This ensures unique plugins (last write wins)
+  const pluginMap = new Map();
+
+  // A. Add Defaults
+  pluginMap.set('@docmd/plugin-search', config.search !== false ? {} : false);
+  pluginMap.set('@docmd/plugin-seo', config.plugins?.seo || {});
+  pluginMap.set('@docmd/plugin-sitemap', config.plugins?.sitemap || {});
+  pluginMap.set('@docmd/plugin-analytics', config.plugins?.analytics || {});
+
+  // B. Add/Override from Config
+  if (config.plugins) {
+    Object.keys(config.plugins).forEach(key => {
+      // Resolve Alias (e.g., 'mermaid' -> '@docmd/plugin-mermaid')
+      const resolvedName = ALIASES[key] || key;
+      const options = config.plugins[key];
+      
+      // Update map (Override default if exists)
+      pluginMap.set(resolvedName, options);
+    });
+  }
+
+  // 3. Load and Register
+  for (const [name, options] of pluginMap) {
+    if (options === false) continue; // Skip disabled
+
+    try {
+      // Try resolving standard package
+      let pluginModule;
+      try {
+        pluginModule = require(name);
+      } catch (e) {
+        // Fallback for local development or misnamed packages
+        console.warn(chalk.dim(`   > Debug: Could not require '${name}', checking alternatives...`));
+        throw e; 
+      }
+
+      registerPlugin(name, pluginModule, options);
+    } catch (e) {
+      console.warn(chalk.yellow(`⚠️  Could not load plugin: ${name}`));
+      // Only log full error in verbose/debug mode to reduce noise
+      // console.error(e.message); 
+    }
+  }
+
+  return hooks;
+}
+
+function registerPlugin(name, plugin, options) {
+  if (typeof plugin.markdownSetup === 'function') hooks.markdownSetup.push((md) => plugin.markdownSetup(md, options));
+  
+  if (typeof plugin.generateMetaTags === 'function') {
+    hooks.injectHead.push((config, page, root) => plugin.generateMetaTags(config, page, root));
+  }
+  
+  if (typeof plugin.generateScripts === 'function') {
+    hooks.injectHead.push((c) => plugin.generateScripts(c, options).headScriptsHtml || '');
+    hooks.injectBody.push((c) => plugin.generateScripts(c, options).bodyScriptsHtml || '');
+  }
+
+  if (typeof plugin.onPostBuild === 'function') hooks.onPostBuild.push((ctx) => plugin.onPostBuild({ ...ctx, options }));
+  
+  if (typeof plugin.getAssets === 'function') hooks.assets.push(() => plugin.getAssets(options));
+}
+
+module.exports = { loadPlugins, hooks };

package/src/utils/plugin-runner.js

@@ -0,0 +1,31 @@
+const { onPostBuild: searchPostBuild, getClientAssets: getSearchAssets } = require('@docmd/plugin-search');
+const { onPostBuild: sitemapPostBuild } = require('@docmd/plugin-sitemap');
+// We will implement SEO/Analytics later, but they are typically "hooks" inside the HTML generation
+// or post-build actions.
+
+// Map of standard plugins that run post-build
+const POST_BUILD_PLUGINS = [
+  { name: 'search', fn: searchPostBuild },
+  { name: 'sitemap', fn: sitemapPostBuild }
+];
+
+async function runPostBuildHooks(context) {
+  for (const plugin of POST_BUILD_PLUGINS) {
+    try {
+      if (plugin.fn) {
+        await plugin.fn(context);
+      }
+    } catch (e) {
+      console.error(`❌ Plugin '${plugin.name}' failed:`, e.message);
+    }
+  }
+}
+
+function getPluginAssets() {
+  // Aggregate assets from plugins that have client-side scripts (like Search)
+  return [
+    { src: getSearchAssets(), dest: 'plugins/search' }
+  ];
+}
+
+module.exports = { runPostBuildHooks, getPluginAssets };