pugkit 1.0.0-beta.1

package/core/context.mjs

@@ -0,0 +1,51 @@
+import { resolve } from 'node:path'
+import { CacheManager } from './cache.mjs'
+import { DependencyGraph } from './graph.mjs'
+import { createGlobPatterns } from '../config/index.mjs'
+
+export class BuildContext {
+  constructor(config, mode) {
+    this.config = config
+    this.mode = mode
+    this.cache = new CacheManager(mode)
+    this.graph = new DependencyGraph()
+
+    this.paths = {
+      root: config.root,
+      src: resolve(config.root, 'src'),
+      dist: resolve(config.root, 'dist', config.subdir || ''),
+      public: resolve(config.root, 'public')
+    }
+
+    this.patterns = createGlobPatterns(this.paths.src)
+    this.server = null
+    this.taskRegistry = null
+  }
+
+  async runTask(taskName, taskFn, options = {}) {
+    try {
+      await taskFn(this, options)
+    } catch (error) {
+      console.error(`Task failed: ${taskName}`)
+      throw error
+    }
+  }
+
+  async runParallel(tasks) {
+    await Promise.all(tasks.map(({ name, fn, options = {} }) => this.runTask(name, fn, options)))
+  }
+
+  async runSeries(tasks) {
+    for (const { name, fn, options = {} } of tasks) {
+      await this.runTask(name, fn, options)
+    }
+  }
+
+  get isProduction() {
+    return this.mode === 'production'
+  }
+
+  get isDevelopment() {
+    return this.mode === 'development'
+  }
+}

package/core/graph.mjs

@@ -0,0 +1,97 @@
+/**
+ * 依存関係グラフ
+ * Pugのパーシャル依存を管理
+ */
+export class DependencyGraph {
+  constructor() {
+    this.edges = new Map() // 親 -> Set<依存>
+    this.reverseEdges = new Map() // 依存 -> Set<親>
+  }
+
+  /**
+   * 依存関係を追加
+   */
+  addDependency(parent, dependency) {
+    // 親 -> 依存
+    if (!this.edges.has(parent)) {
+      this.edges.set(parent, new Set())
+    }
+    this.edges.get(parent).add(dependency)
+
+    // 依存 -> 親（逆引き）
+    if (!this.reverseEdges.has(dependency)) {
+      this.reverseEdges.set(dependency, new Set())
+    }
+    this.reverseEdges.get(dependency).add(parent)
+  }
+
+  /**
+   * パーシャル変更時に再ビルドが必要な親ファイルを取得
+   */
+  getAffectedParents(dependency) {
+    const affected = new Set()
+    const queue = [dependency]
+    const visited = new Set()
+
+    while (queue.length > 0) {
+      const current = queue.shift()
+
+      if (visited.has(current)) {
+        continue
+      }
+      visited.add(current)
+
+      const parents = this.reverseEdges.get(current)
+
+      if (parents) {
+        parents.forEach(parent => {
+          affected.add(parent)
+          // 連鎖的な依存もチェック
+          queue.push(parent)
+        })
+      }
+    }
+
+    return Array.from(affected)
+  }
+
+  /**
+   * ファイルの依存関係をクリア
+   */
+  clearDependencies(file) {
+    // 親としての依存をクリア
+    const deps = this.edges.get(file)
+    if (deps) {
+      deps.forEach(dep => {
+        const parents = this.reverseEdges.get(dep)
+        if (parents) {
+          parents.delete(file)
+          if (parents.size === 0) {
+            this.reverseEdges.delete(dep)
+          }
+        }
+      })
+      this.edges.delete(file)
+    }
+
+    // 依存としての親をクリア
+    const parents = this.reverseEdges.get(file)
+    if (parents) {
+      parents.forEach(parent => {
+        const deps = this.edges.get(parent)
+        if (deps) {
+          deps.delete(file)
+        }
+      })
+      this.reverseEdges.delete(file)
+    }
+  }
+
+  /**
+   * すべてのグラフをクリア
+   */
+  clear() {
+    this.edges.clear()
+    this.reverseEdges.clear()
+  }
+}

package/core/server.mjs

@@ -0,0 +1,78 @@
+import browser from 'browser-sync'
+import { resolve } from 'node:path'
+import { existsSync } from 'node:fs'
+import { mkdir } from 'node:fs/promises'
+import { logger } from '../utils/logger.mjs'
+
+/**
+ * 開発サーバータスク
+ */
+export async function serverTask(context, options = {}) {
+  const { paths, config } = context
+  const distRoot = paths.dist
+
+  // distディレクトリの確認
+  if (!existsSync(distRoot)) {
+    await mkdir(distRoot, { recursive: true })
+  }
+
+  // BrowserSyncインスタンス作成
+  const bs = browser.create()
+  context.server = bs
+
+  const subdir = config.subdir ? '/' + config.subdir.replace(/^\/|\/$/g, '') : ''
+  const startPath = (config.server.startPath || '/').replace(/^\//, '')
+  const fullStartPath = subdir ? `${subdir}/${startPath}` : `/${startPath}`
+
+  return new Promise((resolve, reject) => {
+    bs.init(
+      {
+        notify: false,
+        server: {
+          baseDir: distRoot,
+          serveStaticOptions: {
+            extensions: ['html'],
+            setHeaders: (res, path) => {
+              if (path.endsWith('.css') || path.endsWith('.js')) {
+                res.setHeader('Cache-Control', 'no-cache')
+              }
+            }
+          }
+        },
+        open: false,
+        scrollProportionally: false,
+        ghostMode: false,
+        ui: false,
+        startPath: fullStartPath,
+        port: config.server.port,
+        host: config.server.host,
+        socket: {
+          namespace: '/browser-sync'
+        },
+        logLevel: 'silent',
+        logFileChanges: false,
+        logConnections: false,
+        minify: false,
+        timestamps: false,
+        codeSync: true,
+        online: false,
+        files: false, // 手動でリロード制御
+        injectChanges: true,
+        reloadDelay: 0,
+        reloadDebounce: 50
+      },
+      err => {
+        if (err) {
+          logger.error('server', err.message)
+          reject(err)
+        } else {
+          const urls = bs.getOption('urls')
+          logger.success('server', `Running at ${urls.get('local')}`)
+          resolve()
+        }
+      }
+    )
+  })
+}
+
+export default serverTask

package/core/watcher.mjs

@@ -0,0 +1,314 @@
+import chokidar from 'chokidar'
+import { relative } from 'node:path'
+import { logger } from '../utils/logger.mjs'
+
+/**
+ * ファイル監視タスク
+ */
+export async function watcherTask(context, options = {}) {
+  const watcher = new FileWatcher(context)
+  await watcher.start()
+}
+
+/**
+ * ファイルウォッチャー
+ */
+class FileWatcher {
+  constructor(context) {
+    this.context = context
+    this.watchers = []
+  }
+
+  async start() {
+    const { paths } = this.context
+
+    // 初回ビルド（依存関係グラフ構築のため）
+    logger.info('watch', 'Building initial dependency graph...')
+    if (this.context.taskRegistry?.pug) {
+      await this.context.taskRegistry.pug(this.context)
+    }
+
+    // Pug監視
+    this.watchPug(paths.src)
+
+    // Sass監視
+    this.watchSass(paths.src)
+
+    // Script監視
+    this.watchScript(paths.src)
+
+    // SVG監視
+    this.watchSvg(paths.src)
+
+    // 画像監視
+    this.watchImages(paths.src)
+
+    // Public監視
+    this.watchPublic(paths.public)
+
+    logger.info('watch', 'File watching started')
+  }
+
+  /**
+   * Pug監視（依存関係を考慮）
+   */
+  watchPug(basePath) {
+    const watcher = chokidar.watch(basePath, {
+      ignoreInitial: true,
+      ignored: [
+        /(^|[\/\\])\../, // 隠しファイル
+        /node_modules/,
+        /\.git/
+      ],
+      persistent: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 100,
+        pollInterval: 50
+      }
+    })
+
+    watcher.on('change', async path => {
+      // .pugファイルのみ処理
+      if (!path.endsWith('.pug')) {
+        return
+      }
+      const relPath = relative(basePath, path)
+      logger.info('change', `pug: ${relPath}`)
+
+      try {
+        // パーシャルの場合、依存する親ファイルも再ビルド
+        const affectedFiles = this.context.graph.getAffectedParents(path)
+
+        if (affectedFiles.length > 0) {
+          logger.info('pug', `Rebuilding ${affectedFiles.length} affected file(s)`)
+        }
+
+        // キャッシュ無効化
+        this.context.cache.invalidatePugTemplate(path)
+        affectedFiles.forEach(f => this.context.cache.invalidatePugTemplate(f))
+
+        // Pugタスクを実行（変更されたファイルのみ）
+        if (this.context.taskRegistry?.pug) {
+          await this.context.taskRegistry.pug(this.context, {
+            files: [path, ...affectedFiles]
+          })
+        }
+
+        this.reload()
+      } catch (error) {
+        logger.error('watch', `Pug build failed: ${error.message}`)
+      }
+    })
+
+    this.watchers.push(watcher)
+  }
+
+  /**
+   * Sass監視
+   */
+  watchSass(basePath) {
+    const watcher = chokidar.watch(basePath, {
+      ignoreInitial: true,
+      ignored: [/(^|[\/\\])\../, /node_modules/, /\.git/],
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 }
+    })
+
+    watcher.on('change', async path => {
+      // .scssファイルのみ処理
+      if (!path.endsWith('.scss')) {
+        return
+      }
+      const relPath = relative(basePath, path)
+      logger.info('change', `sass: ${relPath}`)
+
+      try {
+        // Sassタスクを実行
+        if (this.context.taskRegistry?.sass) {
+          await this.context.taskRegistry.sass(this.context)
+        }
+
+        // CSSはインジェクション（リロードせずに更新）
+        this.injectCSS()
+      } catch (error) {
+        logger.error('watch', `Sass build failed: ${error.message}`)
+      }
+    })
+
+    this.watchers.push(watcher)
+  }
+
+  /**
+   * Script監視
+   */
+  watchScript(basePath) {
+    const watcher = chokidar.watch(basePath, {
+      ignoreInitial: true,
+      ignored: [/(^|[\/\\])\../, /node_modules/, /\.git/, /\.d\.ts$/],
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 }
+    })
+
+    watcher.on('change', async path => {
+      // .ts/.jsファイルのみ処理（.d.tsを除く）
+      if (!(path.endsWith('.ts') || path.endsWith('.js')) || path.endsWith('.d.ts')) {
+        return
+      }
+      const relPath = relative(basePath, path)
+      logger.info('change', `script: ${relPath}`)
+
+      try {
+        // Scriptタスクを実行
+        if (this.context.taskRegistry?.script) {
+          await this.context.taskRegistry.script(this.context)
+        }
+
+        this.reload()
+      } catch (error) {
+        logger.error('watch', `Script build failed: ${error.message}`)
+      }
+    })
+
+    this.watchers.push(watcher)
+  }
+
+  /**
+   * SVG監視
+   */
+  watchSvg(basePath) {
+    const watcher = chokidar.watch(basePath, {
+      ignoreInitial: true,
+      ignored: [/(^|[\/\\])\../, /node_modules/, /\.git/, /icons/], // iconsはスプライト用なので除外
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 }
+    })
+
+    const handleSvgChange = async path => {
+      // .svgファイルのみ処理（iconsディレクトリは除外）
+      if (!path.endsWith('.svg') || path.includes('/icons/')) {
+        return
+      }
+      const relPath = relative(basePath, path)
+      logger.info('change', `svg: ${relPath}`)
+
+      try {
+        // SVGタスクを実行（変更されたファイルのみ）
+        if (this.context.taskRegistry?.svg) {
+          await this.context.taskRegistry.svg(this.context, {
+            files: [path]
+          })
+        }
+
+        this.reload()
+      } catch (error) {
+        logger.error('watch', `SVG processing failed: ${error.message}`)
+      }
+    }
+
+    watcher.on('change', handleSvgChange)
+    watcher.on('add', handleSvgChange)
+
+    this.watchers.push(watcher)
+  }
+
+  /**
+   * 画像監視
+   */
+  watchImages(basePath) {
+    const watcher = chokidar.watch(basePath, {
+      ignoreInitial: true,
+      ignored: [/(^|[\/\\])\../, /node_modules/, /\.git/],
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 }
+    })
+
+    const handleImageChange = async path => {
+      // 画像ファイルのみ処理
+      if (!/\.(jpg|jpeg|png|gif)$/i.test(path)) {
+        return
+      }
+      const relPath = relative(basePath, path)
+      logger.info('change', `image: ${relPath}`)
+
+      try {
+        // 追加・変更時: 画像を処理
+        if (this.context.taskRegistry?.image) {
+          await this.context.taskRegistry.image(this.context, {
+            files: [path]
+          })
+        }
+
+        this.reload()
+      } catch (error) {
+        logger.error('watch', `Image processing failed: ${error.message}`)
+      }
+    }
+
+    watcher.on('change', handleImageChange)
+    watcher.on('add', handleImageChange)
+
+    this.watchers.push(watcher)
+  }
+
+  /**
+   * Public監視
+   */
+  watchPublic(basePath) {
+    const watcher = chokidar.watch(basePath, {
+      ignoreInitial: true,
+      ignored: [/(^|[\/\\])\../, /node_modules/, /\.git/],
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 }
+    })
+
+    watcher.on('change', async path => {
+      const relPath = relative(basePath, path)
+      logger.info('change', `public: ${relPath}`)
+
+      try {
+        // Copyタスクを実行
+        if (this.context.taskRegistry?.copy) {
+          await this.context.taskRegistry.copy(this.context)
+        }
+
+        this.reload()
+      } catch (error) {
+        logger.error('watch', `Copy failed: ${error.message}`)
+      }
+    })
+
+    this.watchers.push(watcher)
+  }
+
+  /**
+   * ブラウザリロード
+   */
+  reload() {
+    if (this.context.server) {
+      setTimeout(() => {
+        this.context.server.reload()
+      }, 100)
+    }
+  }
+
+  /**
+   * CSSインジェクション（リロードなし）
+   */
+  injectCSS() {
+    if (this.context.server) {
+      setTimeout(() => {
+        this.context.server.reload('*.css')
+      }, 100)
+    }
+  }
+
+  /**
+   * 監視停止
+   */
+  async stop() {
+    await Promise.all(this.watchers.map(w => w.close()))
+    logger.info('watch', 'File watching stopped')
+  }
+}
+
+export default watcherTask

package/generate/asset.mjs

@@ -0,0 +1,19 @@
+import { writeFile, copyFile, mkdir } from 'node:fs/promises'
+import { dirname } from 'node:path'
+import { ensureFileDir } from '../utils/file.mjs'
+
+export async function generateAsset(outputPath, data) {
+  await ensureFileDir(outputPath)
+
+  if (typeof data === 'string' || Buffer.isBuffer(data)) {
+    await writeFile(outputPath, data)
+  }
+
+  return outputPath
+}
+
+export async function copyAsset(srcPath, destPath) {
+  await ensureFileDir(destPath)
+  await copyFile(srcPath, destPath)
+  return destPath
+}

package/generate/page.mjs

@@ -0,0 +1,13 @@
+import { writeFile } from 'node:fs/promises'
+import { relative, resolve } from 'node:path'
+import { ensureFileDir } from '../utils/file.mjs'
+
+export async function generatePage(filePath, html, paths) {
+  const relativePath = relative(paths.src, filePath)
+  const outputPath = resolve(paths.dist, relativePath.replace('.pug', '.html'))
+
+  await ensureFileDir(outputPath)
+  await writeFile(outputPath, html, 'utf8')
+
+  return outputPath
+}

package/index.mjs

@@ -0,0 +1,60 @@
+import { loadConfig } from './config/index.mjs'
+import { Builder } from './core/builder.mjs'
+import pugTask from './tasks/pug.mjs'
+import sassTask from './tasks/sass.mjs'
+import scriptTask from './tasks/script.mjs'
+import copyTask from './tasks/copy.mjs'
+import imageTask from './tasks/image.mjs'
+import svgTask from './tasks/svg.mjs'
+import spriteTask from './tasks/svg-sprite.mjs'
+import serverTask from './core/server.mjs'
+import watcherTask from './core/watcher.mjs'
+
+export async function createBuilder(root = process.cwd(), mode = 'development') {
+  const config = await loadConfig(root)
+  const builder = new Builder(config, mode)
+
+  builder.registerTasks({
+    pug: pugTask,
+    sass: sassTask,
+    script: scriptTask,
+    image: imageTask,
+    svg: svgTask,
+    sprite: spriteTask,
+    copy: copyTask,
+    server: serverTask,
+    watch: watcherTask
+  })
+
+  builder.context.taskRegistry = {
+    pug: pugTask,
+    sass: sassTask,
+    script: scriptTask,
+    image: imageTask,
+    svg: svgTask,
+    copy: copyTask
+  }
+
+  return builder
+}
+
+export async function build(root = process.cwd()) {
+  const builder = await createBuilder(root, 'production')
+  await builder.build()
+}
+
+export async function watch(root = process.cwd()) {
+  const builder = await createBuilder(root, 'development')
+  await builder.watch()
+}
+
+export async function runTask(taskName, root = process.cwd()) {
+  const builder = await createBuilder(root, 'production')
+  await builder.runTask(taskName)
+}
+
+export { Builder, loadConfig }
+export { BuildContext } from './core/context.mjs'
+export { CacheManager } from './core/cache.mjs'
+export { DependencyGraph } from './core/graph.mjs'
+export { defineConfig } from './config/index.mjs'

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "pugkit",
+  "version": "1.0.0-beta.1",
+  "description": "A build tool for Pug-based projects",
+  "type": "module",
+  "license": "MIT",
+  "author": "mfxgu2i <mfxgu2i@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mfxgu2i/pugkit.git",
+    "directory": "packages/pugkit"
+  },
+  "bugs": "https://github.com/mfxgu2i/pugkit/issues",
+  "homepage": "https://github.com/mfxgu2i/pugkit#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "pugkit": "./cli/index.mjs"
+  },
+  "keywords": [
+    "pug",
+    "ssg",
+    "static-site-generator",
+    "frontend-tooling"
+  ],
+  "exports": {
+    ".": "./index.mjs",
+    "./config": "./config/index.mjs"
+  },
+  "files": [
+    "cli",
+    "config",
+    "core",
+    "generate",
+    "index.mjs",
+    "tasks",
+    "transform",
+    "utils"
+  ],
+  "dependencies": {
+    "autoprefixer": "^10.4.21",
+    "browser-sync": "^3.0.4",
+    "cac": "^6.7.14",
+    "chokidar": "^4.0.3",
+    "cssnano": "^7.1.1",
+    "esbuild": "^0.25.5",
+    "glob": "^10.3.10",
+    "image-size": "^2.0.2",
+    "picocolors": "^1.1.1",
+    "postcss": "^8.4.49",
+    "prettier": "^3.8.0",
+    "pug": "^3.0.3",
+    "sass": "^1.89.2",
+    "sharp": "^0.34.2",
+    "svgo": "^4.0.0"
+  }
+}