@ywal123456/jskim 0.1.0

package/scripts/lib/merge-config.js

@@ -0,0 +1,130 @@
+'use strict';
+
+/**
+ * defaults とプロジェクト設定をマージします。
+ *
+ * - スカラー: プロジェクト側があれば優先
+ * - オブジェクト (build / watch / serve / dev): 1段階の shallow merge
+ * - 配列 (render / templates / copy): プロジェクト側配列が defaults を丸ごと置き換え
+ *
+ * 元の defaults / プロジェクトオブジェクトは変更しません。
+ *
+ * @param {object} defaults
+ * @param {object} project
+ * @returns {object}
+ */
+function mergeConfig(defaults, project) {
+  const base = defaults && typeof defaults === 'object' ? defaults : {};
+  const override = project && typeof project === 'object' ? project : {};
+
+  const merged = {
+    sourceDir: pickScalar(override.sourceDir, base.sourceDir),
+    outputDir: pickScalar(override.outputDir, base.outputDir),
+    render: pickArray(override.render, base.render, []),
+    templates: pickArray(override.templates, base.templates, []),
+    copy: pickArray(override.copy, base.copy, []),
+    build: mergeBuild(base.build, override.build),
+    watch: mergeWatch(base.watch, override.watch),
+    serve: mergeServe(base.serve, override.serve),
+    dev: mergeDev(base.dev, override.dev),
+  };
+
+  return {
+    sourceDir: merged.sourceDir,
+    outputDir: merged.outputDir,
+    render: merged.render.map((rule) => ({ ...rule })),
+    templates: [...merged.templates],
+    copy: merged.copy.map((rule) => ({ ...rule })),
+    build: { ...merged.build },
+    watch: { ...merged.watch },
+    serve: { ...merged.serve },
+    dev: { ...merged.dev },
+  };
+}
+
+function pickScalar(projectValue, defaultValue) {
+  return projectValue !== undefined ? projectValue : defaultValue;
+}
+
+function pickArray(projectValue, defaultValue, fallback) {
+  if (Array.isArray(projectValue)) {
+    return projectValue.slice();
+  }
+  if (Array.isArray(defaultValue)) {
+    return defaultValue.slice();
+  }
+  return fallback.slice();
+}
+
+function mergeBuild(defaultBuild, projectBuild) {
+  const base =
+    defaultBuild && typeof defaultBuild === 'object' ? defaultBuild : {};
+  const override =
+    projectBuild && typeof projectBuild === 'object' ? projectBuild : {};
+
+  return {
+    clean:
+      override.clean !== undefined
+        ? Boolean(override.clean)
+        : base.clean !== undefined
+          ? Boolean(base.clean)
+          : true,
+  };
+}
+
+function mergeWatch(defaultWatch, projectWatch) {
+  const base =
+    defaultWatch && typeof defaultWatch === 'object' ? defaultWatch : {};
+  const override =
+    projectWatch && typeof projectWatch === 'object' ? projectWatch : {};
+
+  return {
+    debounce:
+      override.debounce !== undefined
+        ? override.debounce
+        : base.debounce !== undefined
+          ? base.debounce
+          : 150,
+  };
+}
+
+function mergeServe(defaultServe, projectServe) {
+  const base =
+    defaultServe && typeof defaultServe === 'object' ? defaultServe : {};
+  const override =
+    projectServe && typeof projectServe === 'object' ? projectServe : {};
+
+  return {
+    host:
+      override.host !== undefined
+        ? override.host
+        : base.host !== undefined
+          ? base.host
+          : '127.0.0.1',
+    port:
+      override.port !== undefined
+        ? override.port
+        : base.port !== undefined
+          ? base.port
+          : 3000,
+  };
+}
+
+function mergeDev(defaultDev, projectDev) {
+  const base = defaultDev && typeof defaultDev === 'object' ? defaultDev : {};
+  const override =
+    projectDev && typeof projectDev === 'object' ? projectDev : {};
+
+  return {
+    liveReload:
+      override.liveReload !== undefined
+        ? override.liveReload
+        : base.liveReload !== undefined
+          ? base.liveReload
+          : true,
+  };
+}
+
+module.exports = {
+  mergeConfig,
+};

package/scripts/lib/render-pages.js

@@ -0,0 +1,121 @@
+'use strict';
+
+const path = require('node:path');
+const fse = require('fs-extra');
+const fg = require('fast-glob');
+
+/**
+ * 出力ファイルのディレクトリから outputDir までの相対パスとして rootPath を計算します。
+ * HTML 用に常に `/` 区切りを使います。
+ *
+ * @param {string} outputFilePath HTML ファイルの絶対パス
+ * @param {string} outputDir 出力ルートの絶対パス
+ * @returns {string} "./" | "../" | "../../" | ...
+ */
+function computeRootPath(outputFilePath, outputDir) {
+  const outFileDir = path.dirname(path.resolve(outputFilePath));
+  const outRoot = path.resolve(outputDir);
+  let relative = path.relative(outFileDir, outRoot);
+
+  if (!relative || relative === '') {
+    return './';
+  }
+
+  relative = relative.split(path.sep).join('/');
+
+  if (!relative.endsWith('/')) {
+    relative += '/';
+  }
+
+  return relative;
+}
+
+/**
+ * render ルールに従ってページをレンダリングします。
+ *
+ * @param {object} options
+ * @param {import('nunjucks').Environment} options.env
+ * @param {object} options.project 解決済みプロジェクト
+ * @returns {Promise<{ renderedCount: number, files: string[] }>}
+ */
+async function renderPages({ env, project }) {
+  const { name, sourceDir, outputDir, render } = project;
+  let renderedCount = 0;
+  const files = [];
+
+  for (let i = 0; i < render.length; i += 1) {
+    const rule = render[i];
+    const fromDir = path.resolve(sourceDir, rule.from);
+    const toDir = path.resolve(outputDir, rule.to || '');
+    const extension = rule.extension.startsWith('.')
+      ? rule.extension
+      : `.${rule.extension}`;
+
+    if (!(await fse.pathExists(fromDir))) {
+      throw new Error(
+        `[JSKim] プロジェクト "${name}" の render[${i}].from が存在しません。\n` +
+          `パス: ${fromDir}\n` +
+          `設定: render[${i}].from = ${rule.from}`
+      );
+    }
+
+    const matches = await fg(rule.include, {
+      cwd: fromDir,
+      onlyFiles: true,
+      dot: false,
+      absolute: false,
+    });
+
+    matches.sort();
+
+    for (const relativeMatch of matches) {
+      const sourceFile = path.join(fromDir, relativeMatch);
+      const parsed = path.parse(relativeMatch);
+      const outRelative = path.join(parsed.dir, `${parsed.name}${extension}`);
+      const outputFile = path.join(toDir, outRelative);
+
+      // Nunjucks loader 用に sourceDir からの相対パスへ
+      const templatePath = path
+        .relative(sourceDir, sourceFile)
+        .split(path.sep)
+        .join('/');
+
+      const rootPath = computeRootPath(outputFile, outputDir);
+
+      let html;
+      try {
+        html = env.render(templatePath, { rootPath });
+      } catch (err) {
+        const message = err && err.message ? err.message : String(err);
+        throw new Error(
+          `[JSKim] プロジェクト "${name}" の Nunjucks レンダリングに失敗しました。\n` +
+            `ソース: ${sourceFile}\n` +
+            `テンプレート: ${templatePath}\n` +
+            `原因: ${message}`
+        );
+      }
+
+      try {
+        await fse.ensureDir(path.dirname(outputFile));
+        await fse.writeFile(outputFile, html, 'utf8');
+      } catch (err) {
+        const message = err && err.message ? err.message : String(err);
+        throw new Error(
+          `[JSKim] プロジェクト "${name}" のレンダリング結果の書き込みに失敗しました。\n` +
+            `出力: ${outputFile}\n` +
+            `原因: ${message}`
+        );
+      }
+
+      renderedCount += 1;
+      files.push(outputFile);
+    }
+  }
+
+  return { renderedCount, files };
+}
+
+module.exports = {
+  renderPages,
+  computeRootPath,
+};

package/scripts/lib/resolve-project.js

@@ -0,0 +1,198 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { mergeConfig } = require('./merge-config');
+
+/**
+ * 読み込んだ設定から名前付きプロジェクトを解決・検証します。
+ *
+ * @param {object} options
+ * @param {object} options.config
+ * @param {string} options.workspaceRoot
+ * @param {string|undefined} options.projectName
+ * @param {string} [options.commandName='build']
+ * @param {string} [options.usageLine] プロジェクト名欠落時の使用方法行
+ * @returns {object} 解決済みプロジェクト
+ */
+function resolveProject({
+  config,
+  workspaceRoot,
+  projectName,
+  commandName = 'build',
+  usageLine,
+}) {
+  if (!projectName || String(projectName).trim() === '') {
+    const usage =
+      usageLine || `npm run ${commandName} -- <project-name>`;
+    throw new Error(
+      `[JSKim] プロジェクト名を指定してください。\n` +
+        `使用方法: ${usage}`
+    );
+  }
+
+  const name = String(projectName).trim();
+  const projects = config.projects || {};
+  const projectConfig = projects[name];
+
+  if (!projectConfig) {
+    const available = Object.keys(projects);
+    const list =
+      available.length > 0 ? available.join(', ') : '(登録なし)';
+    throw new Error(
+      `[JSKim] 不明なプロジェクトです: ${name}\n` +
+        `利用可能なプロジェクト: ${list}`
+    );
+  }
+
+  const merged = mergeConfig(config.defaults || {}, projectConfig);
+
+  if (!merged.sourceDir || String(merged.sourceDir).trim() === '') {
+    throw new Error(
+      `[JSKim] プロジェクト "${name}" に sourceDir がありません。\n` +
+        `jskim.config.js の projects.${name}.sourceDir を設定してください。`
+    );
+  }
+
+  if (!merged.outputDir || String(merged.outputDir).trim() === '') {
+    throw new Error(
+      `[JSKim] プロジェクト "${name}" に outputDir がありません。\n` +
+        `jskim.config.js の projects.${name}.outputDir を設定してください。`
+    );
+  }
+
+  const sourceDir = path.resolve(workspaceRoot, merged.sourceDir);
+  const outputDir = path.resolve(workspaceRoot, merged.outputDir);
+
+  if (!fs.existsSync(sourceDir)) {
+    throw new Error(
+      `[JSKim] プロジェクト "${name}" の sourceDir が存在しません。\n` +
+        `パス: ${sourceDir}\n` +
+        `設定: projects.${name}.sourceDir = ${merged.sourceDir}`
+    );
+  }
+
+  if (!fs.statSync(sourceDir).isDirectory()) {
+    throw new Error(
+      `[JSKim] プロジェクト "${name}" の sourceDir はディレクトリではありません。\n` +
+        `パス: ${sourceDir}`
+    );
+  }
+
+  if (!Array.isArray(merged.render) || merged.render.length === 0) {
+    throw new Error(
+      `[JSKim] プロジェクト "${name}" の render 設定が無い、または空です。\n` +
+        `jskim.config.js の defaults.render または projects.${name}.render を定義してください。`
+    );
+  }
+
+  for (let i = 0; i < merged.render.length; i += 1) {
+    const rule = merged.render[i];
+    if (!rule || typeof rule !== 'object') {
+      throw new Error(
+        `[JSKim] プロジェクト "${name}" の render[${i}] が不正です。\n` +
+          `原因: 各 render ルールはオブジェクトである必要があります。`
+      );
+    }
+    if (!rule.from || String(rule.from).trim() === '') {
+      throw new Error(
+        `[JSKim] プロジェクト "${name}" の render[${i}].from が不正です。\n` +
+          `原因: from は必須です（sourceDir 基準）。`
+      );
+    }
+    if (!Array.isArray(rule.include) || rule.include.length === 0) {
+      throw new Error(
+        `[JSKim] プロジェクト "${name}" の render[${i}].include が不正です。\n` +
+          `原因: include は空でない glob パターン配列である必要があります。`
+      );
+    }
+    if (!rule.extension || String(rule.extension).trim() === '') {
+      throw new Error(
+        `[JSKim] プロジェクト "${name}" の render[${i}].extension が不正です。\n` +
+          `原因: extension は必須です（例: ".html"）。`
+      );
+    }
+  }
+
+  validateWatchConfig(merged.watch, name);
+  validateServeConfig(merged.serve, name);
+  validateDevConfig(merged.dev, name);
+
+  return {
+    name,
+    sourceDir,
+    outputDir,
+    sourceDirConfig: merged.sourceDir,
+    outputDirConfig: merged.outputDir,
+    render: merged.render,
+    templates: merged.templates,
+    copy: merged.copy,
+    build: merged.build,
+    watch: merged.watch,
+    serve: merged.serve,
+    dev: merged.dev,
+    workspaceRoot,
+  };
+}
+
+function validateWatchConfig(watch, projectName) {
+  const debounce = watch && watch.debounce;
+
+  if (
+    typeof debounce !== 'number' ||
+    !Number.isFinite(debounce) ||
+    debounce < 0
+  ) {
+    throw new Error(
+      `[JSKim] 設定値が不正です: watch.debounce\n` +
+        `プロジェクト: ${projectName}\n` +
+        `0以上の有限な数値を指定してください。\n` +
+        `受け取った値: ${String(debounce)}`
+    );
+  }
+}
+
+function validateServeConfig(serve, projectName) {
+  const host = serve && serve.host;
+  const port = serve && serve.port;
+
+  if (typeof host !== 'string' || host.trim() === '') {
+    throw new Error(
+      `[JSKim] 設定値が不正です: serve.host\n` +
+        `プロジェクト: ${projectName}\n` +
+        `空でない文字列を指定してください。\n` +
+        `受け取った値: ${String(host)}`
+    );
+  }
+
+  if (
+    typeof port !== 'number' ||
+    !Number.isInteger(port) ||
+    port < 1 ||
+    port > 65535
+  ) {
+    throw new Error(
+      `[JSKim] 設定値が不正です: serve.port\n` +
+        `プロジェクト: ${projectName}\n` +
+        `1から65535までの整数を指定してください。\n` +
+        `受け取った値: ${String(port)}`
+    );
+  }
+}
+
+function validateDevConfig(dev, projectName) {
+  const liveReload = dev && dev.liveReload;
+
+  if (typeof liveReload !== 'boolean') {
+    throw new Error(
+      `[JSKim] 設定値が不正です: dev.liveReload\n` +
+        `プロジェクト: ${projectName}\n` +
+        `boolean を指定してください。\n` +
+        `受け取った値: ${String(liveReload)}`
+    );
+  }
+}
+
+module.exports = {
+  resolveProject,
+};

package/scripts/lib/resolve-watch-paths.js

@@ -0,0 +1,134 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+/**
+ * 解決済みプロジェクト設定から監視ディレクトリを計算します。
+ * sourceDir 配下の render[].from / templates[] / copy[].from を監視します。
+ * outputDir / dist / node_modules は監視しません。
+ *
+ * @param {object} project
+ * @returns {{ absolutePaths: string[], displayPaths: string[] }}
+ */
+function resolveWatchPaths(project) {
+  const { name, sourceDir, outputDir, workspaceRoot, render, templates, copy } =
+    project;
+
+  const absolutePaths = [];
+  const seen = new Set();
+
+  function addCandidate(absPath) {
+    const resolved = path.resolve(absPath);
+    const key =
+      process.platform === 'win32' ? resolved.toLowerCase() : resolved;
+
+    if (seen.has(key)) {
+      return;
+    }
+
+    if (isForbiddenWatchPath(resolved, outputDir, workspaceRoot)) {
+      return;
+    }
+
+    if (!fs.existsSync(resolved)) {
+      return;
+    }
+
+    seen.add(key);
+    absolutePaths.push(resolved);
+  }
+
+  for (const rule of render) {
+    if (rule && rule.from) {
+      addCandidate(path.join(sourceDir, rule.from));
+    }
+  }
+
+  for (const rel of Array.isArray(templates) ? templates : []) {
+    if (rel) {
+      addCandidate(path.join(sourceDir, rel));
+    }
+  }
+
+  for (const rule of Array.isArray(copy) ? copy : []) {
+    if (rule && rule.from) {
+      addCandidate(path.join(sourceDir, rule.from));
+    }
+  }
+
+  if (absolutePaths.length === 0) {
+    throw new Error(
+      `[JSKim] プロジェクト "${name}" の監視パスがありません。\n` +
+        `原因: render[].from / templates[] / copy[].from のいずれも既存パスに解決できませんでした。\n` +
+        `sourceDir: ${sourceDir}`
+    );
+  }
+
+  absolutePaths.sort(comparePaths);
+
+  const displayPaths = absolutePaths.map((abs) =>
+    toDisplayPath(abs, workspaceRoot)
+  );
+
+  return { absolutePaths, displayPaths };
+}
+
+function isForbiddenWatchPath(candidate, outputDir, workspaceRoot) {
+  const resolved = path.resolve(candidate);
+  const out = path.resolve(outputDir);
+  const root = path.resolve(workspaceRoot);
+  const distRoot = path.join(root, 'dist');
+
+  if (samePath(resolved, out) || isInsideOrSame(out, resolved)) {
+    return true;
+  }
+
+  if (samePath(resolved, distRoot) || isInsideOrSame(distRoot, resolved)) {
+    return true;
+  }
+
+  const parts = resolved.split(path.sep);
+  if (parts.some((part) => part.toLowerCase() === 'node_modules')) {
+    return true;
+  }
+
+  return false;
+}
+
+function toDisplayPath(abs, workspaceRoot) {
+  const rel = path.relative(workspaceRoot, abs);
+  if (!rel || rel.startsWith('..') || path.isAbsolute(rel)) {
+    return abs.split(path.sep).join('/');
+  }
+  return rel.split(path.sep).join('/');
+}
+
+function samePath(a, b) {
+  const na = path.resolve(a);
+  const nb = path.resolve(b);
+  if (process.platform === 'win32') {
+    return na.toLowerCase() === nb.toLowerCase();
+  }
+  return na === nb;
+}
+
+function isInsideOrSame(parent, child) {
+  if (samePath(parent, child)) {
+    return true;
+  }
+  const rel = path.relative(path.resolve(parent), path.resolve(child));
+  return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
+}
+
+function comparePaths(a, b) {
+  const left = process.platform === 'win32' ? a.toLowerCase() : a;
+  const right = process.platform === 'win32' ? b.toLowerCase() : b;
+  if (left < right) return -1;
+  if (left > right) return 1;
+  return 0;
+}
+
+module.exports = {
+  resolveWatchPaths,
+};

package/scripts/serve.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const { runServeCommand } = require('./commands/serve-command');
+
+runServeCommand({
+  projectName: process.argv[2],
+  workspaceRoot: process.cwd(),
+  usageLine: 'npm run serve -- <project-name>',
+}).catch((err) => {
+  const message = err && err.message ? err.message : String(err);
+  console.error(message);
+  process.exitCode = 1;
+});

package/scripts/watch.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const { runWatchCommand } = require('./commands/watch-command');
+
+runWatchCommand({
+  projectName: process.argv[2],
+  workspaceRoot: process.cwd(),
+  usageLine: 'npm run watch -- <project-name>',
+}).catch((err) => {
+  const message = err && err.message ? err.message : String(err);
+  console.error(message);
+  process.exitCode = 1;
+});