@ywal123456/jskim 0.2.0 → 0.3.1

package/scripts/lib/build-project.js

@@ -7,23 +7,17 @@ const { createNunjucksEnv } = require('./create-nunjucks-env');
 const { cleanOutput } = require('./clean-output');
 const { renderPages } = require('./render-pages');
 const { copyFiles } = require('./copy-files');
+const { processFiles } = require('./process-files');
 
 /**
  * 設定を読み込み、プロジェクトを解決してフルビルドを実行します。
  *
  * @param {string|undefined} projectName
  * @param {object} [options]
- * @param {string} [options.workspaceRoot]
- * @param {string} [options.commandName='build']
- * @param {string} [options.usageLine]
- * @param {string} [options.logTitle='ビルドが完了しました']
- * @param {boolean} [options.includeOutput=true]
- * @param {boolean} [options.log=true]
  * @returns {Promise<object>}
  */
 async function buildProject(projectName, options = {}) {
-  const workspaceRoot =
-    options.workspaceRoot || process.cwd();
+  const workspaceRoot = options.workspaceRoot || process.cwd();
   const commandName = options.commandName || 'build';
 
   const { config } = loadConfig(workspaceRoot);
@@ -39,7 +33,7 @@ async function buildProject(projectName, options = {}) {
 }
 
 /**
- * 解決済みプロジェクトに対して clean → render → copy を実行します。
+ * 解決済みプロジェクトに対して clean → pipeline を実行します。
  *
  * @param {object} project
  * @param {object} [options]
@@ -62,10 +56,22 @@ async function runBuild(project, options = {}) {
   const env = createNunjucksEnv({
     sourceDir: project.sourceDir,
     templates: project.templates,
+    nunjucks: project.nunjucks,
   });
 
-  const { renderedCount } = await renderPages({ env, project });
-  const { copiedCount } = await copyFiles({ project });
+  let renderedCount = 0;
+  let copiedCount = 0;
+
+  if (project.pipelineMode === 'files') {
+    const result = await processFiles({ env, project });
+    renderedCount = result.renderedCount;
+    copiedCount = result.copiedCount;
+  } else {
+    const rendered = await renderPages({ env, project });
+    const copied = await copyFiles({ project });
+    renderedCount = rendered.renderedCount;
+    copiedCount = copied.copiedCount;
+  }
 
   const outputDisplay = path
     .relative(project.workspaceRoot, project.outputDir)
@@ -92,7 +98,7 @@ function printBuildResult(result, options = {}) {
 
   console.log(`[JSKim] ${logTitle}`);
   console.log(`プロジェクト: ${result.project.name}`);
-  console.log(`レンダリングしたページ数: ${result.renderedCount}`);
+  console.log(`レンダリングしたファイル数: ${result.renderedCount}`);
   console.log(`コピーしたファイル数: ${result.copiedCount}`);
   if (includeOutput) {
     console.log(`出力先: ${result.outputDisplay}`);

package/scripts/lib/create-nunjucks-env.js

@@ -7,13 +7,15 @@ const nunjucks = require('nunjucks');
 /**
  * プロジェクト用の Nunjucks 環境を作成します。
  * loader ルート: sourceDir + templates[]（重複除去）。
+ * filters / globals を登録します。
  *
  * @param {object} options
  * @param {string} options.sourceDir
  * @param {string[]} options.templates
+ * @param {object} [options.nunjucks]
  * @returns {nunjucks.Environment}
  */
-function createNunjucksEnv({ sourceDir, templates }) {
+function createNunjucksEnv({ sourceDir, templates, nunjucks: nunjucksConfig }) {
   const roots = [];
   const seen = new Set();
 
@@ -48,14 +50,51 @@ function createNunjucksEnv({ sourceDir, templates }) {
     noCache: true,
   });
 
+  // HTML 互換のため autoescape は維持する。
+  // JSON/JS 出力が必要な filter は SafeString を返すこと。
   const env = new nunjucks.Environment(loader, {
     autoescape: true,
     noCache: true,
   });
 
+  const config =
+    nunjucksConfig && typeof nunjucksConfig === 'object' ? nunjucksConfig : {};
+  registerFilters(env, config.filters || {});
+  registerGlobals(env, config.globals || {});
+
   return env;
 }
 
+function registerFilters(env, filters) {
+  for (const [name, fn] of Object.entries(filters)) {
+    env.addFilter(name, wrapSyncCallable(fn, `filter:${name}`));
+  }
+}
+
+function registerGlobals(env, globals) {
+  for (const [name, value] of Object.entries(globals)) {
+    if (typeof value === 'function') {
+      env.addGlobal(name, wrapSyncCallable(value, `global:${name}`));
+    } else {
+      env.addGlobal(name, value);
+    }
+  }
+}
+
+function wrapSyncCallable(fn, label) {
+  return function wrapped(...args) {
+    const result = fn.apply(this, args);
+    if (result && typeof result.then === 'function') {
+      throw new Error(
+        `[JSKim] 非同期${label.startsWith('filter') ? 'filter' : 'global'}は現在サポートされていません。\n` +
+          `対象: ${label}\n` +
+          `同期の function のみ登録できます。`
+      );
+    }
+    return result;
+  };
+}
+
 module.exports = {
   createNunjucksEnv,
 };

package/scripts/lib/create-project-watcher.js

@@ -184,9 +184,9 @@ function createProjectWatcher(project, options = {}) {
           `[JSKim] プロジェクト "${project.name}" の初回ビルドに失敗しました。ウォッチャーは開始します。`
         );
       } else {
-        const representative = events[events.length - 1] || null;
         console.error(`[JSKim] 再ビルドに失敗しました`);
         console.error(`プロジェクト: ${project.name}`);
+        const representative = events[events.length - 1] || null;
         if (representative) {
           console.error(`イベント: ${representative.event}`);
           console.error(`ファイル: ${representative.file}`);
@@ -194,7 +194,12 @@ function createProjectWatcher(project, options = {}) {
         if (events.length > 1) {
           console.error(`変更数: ${events.length} ファイル`);
         }
-        console.error(`原因: ${message}`);
+        // 診断付きメッセージは重複ヘッダーを避けるためそのまま出力する
+        if (String(message).startsWith('[JSKim]')) {
+          console.error(message);
+        } else {
+          console.error(`原因: ${message}`);
+        }
         console.error(
           `[JSKim] ウォッチャーは継続中です。修正して保存すると再試行します。`
         );

package/scripts/lib/format-diagnostic.js

@@ -0,0 +1,234 @@
+'use strict';
+
+const { toDisplayPath } = require('./to-display-path');
+
+/**
+ * Error から短い原因メッセージを取り出します（stack は含めません）。
+ * @param {unknown} err
+ * @returns {string}
+ */
+function getCauseMessage(err) {
+  if (!err) {
+    return String(err);
+  }
+  if (typeof err === 'string') {
+    return err;
+  }
+  if (err && typeof err.message === 'string' && err.message.trim() !== '') {
+    return err.message;
+  }
+  return String(err);
+}
+
+/**
+ * Nunjucks が lineno / colno を提供する場合だけ位置を返します。
+ * message 本文の正規表現解析は行いません。
+ *
+ * @param {unknown} err
+ * @returns {{ line?: number, column?: number }}
+ */
+function readNunjucksLocation(err) {
+  if (!err || typeof err !== 'object') {
+    return {};
+  }
+
+  const lineno = err.lineno;
+  const colno = err.colno;
+  const result = {};
+
+  if (Number.isInteger(lineno) && lineno > 0) {
+    result.line = lineno;
+  }
+  if (Number.isInteger(colno) && colno > 0) {
+    result.column = colno;
+  }
+
+  return result;
+}
+
+/**
+ * Nunjucks レンダリング失敗の診断メッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.sourceFile
+ * @param {string} options.templatePath
+ * @param {string} [options.workspaceRoot]
+ * @param {unknown} options.err
+ * @returns {string}
+ */
+function formatRenderError(options) {
+  const {
+    projectName,
+    sourceFile,
+    templatePath,
+    workspaceRoot,
+    err,
+  } = options;
+
+  const sourceDisplay = toDisplayPath(sourceFile, workspaceRoot);
+  const location = readNunjucksLocation(err);
+  const cause = getCauseMessage(err);
+
+  const lines = [
+    `[JSKim] プロジェクト "${projectName}" の Nunjucks レンダリングに失敗しました。`,
+    `ソース: ${sourceDisplay}`,
+    `テンプレート: ${templatePath}`,
+  ];
+
+  if (location.line != null) {
+    lines.push(`行: ${location.line}`);
+  }
+  if (location.column != null) {
+    lines.push(`列: ${location.column}`);
+  }
+
+  lines.push(`原因: ${cause}`);
+  lines.push('テンプレート構文または参照先（extends / include）を確認してください。');
+
+  return lines.join('\n');
+}
+
+/**
+ * 出力パス衝突の診断メッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.outputFile
+ * @param {string} options.sourceFileA
+ * @param {string} options.sourceFileB
+ * @param {number} [options.ruleIndexA]
+ * @param {number} [options.ruleIndexB]
+ * @param {string} [options.workspaceRoot]
+ * @returns {string}
+ */
+function formatCollisionError(options) {
+  const {
+    projectName,
+    outputFile,
+    sourceFileA,
+    sourceFileB,
+    ruleIndexA,
+    ruleIndexB,
+    workspaceRoot,
+  } = options;
+
+  const lines = [
+    `[JSKim] 出力パスが衝突しています。`,
+    `プロジェクト: ${projectName}`,
+    `出力: ${toDisplayPath(outputFile, workspaceRoot)}`,
+    formatCollisionSource('ソース1', sourceFileA, ruleIndexA, workspaceRoot),
+    formatCollisionSource('ソース2', sourceFileB, ruleIndexB, workspaceRoot),
+    '同じ出力になるソースを分けるか、どちらかを除外してください。',
+  ];
+
+  return lines.join('\n');
+}
+
+function formatCollisionSource(label, sourceFile, ruleIndex, workspaceRoot) {
+  const display = toDisplayPath(sourceFile, workspaceRoot);
+  if (Number.isInteger(ruleIndex) && ruleIndex >= 0) {
+    return `${label}: ${display} (files[${ruleIndex}])`;
+  }
+  return `${label}: ${display}`;
+}
+
+/**
+ * sourceDir / outputDir 外へのパス逸脱メッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.label
+ * @param {string} options.root
+ * @param {string} options.candidate
+ * @param {'sourceDir'|'outputDir'|string} [options.rootKind]
+ * @param {string} [options.workspaceRoot]
+ * @returns {string}
+ */
+function formatPathOutsideError(options) {
+  const {
+    projectName,
+    label,
+    root,
+    candidate,
+    rootKind,
+    workspaceRoot,
+  } = options;
+
+  const kindLabel =
+    rootKind === 'sourceDir'
+      ? 'sourceDir'
+      : rootKind === 'outputDir'
+        ? 'outputDir'
+        : '許可ルート';
+
+  return [
+    `[JSKim] プロジェクト "${projectName}" の ${label} が許可範囲外です。`,
+    `種別: ${kindLabel} の外への参照`,
+    `ルート: ${toDisplayPath(root, workspaceRoot)}`,
+    `対象: ${toDisplayPath(candidate, workspaceRoot)}`,
+    '相対パスが sourceDir / outputDir 内に収まるように設定してください。',
+  ].join('\n');
+}
+
+/**
+ * 設定バリデーション向けの共通ヘッダー行を組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.configKey
+ * @param {string} [options.detail]
+ * @param {string} [options.received]
+ * @param {string} [options.hint]
+ * @returns {string}
+ */
+function formatConfigValidationError(options) {
+  const { projectName, configKey, detail, received, hint } = options;
+  const lines = [
+    `[JSKim] 設定値が不正です: ${configKey}`,
+    `プロジェクト: ${projectName}`,
+    `設定キー: projects.${projectName} または defaults の ${configKey}`,
+  ];
+
+  if (detail) {
+    lines.push(detail);
+  }
+  if (received !== undefined) {
+    lines.push(`受け取った値: ${received}`);
+  }
+  if (hint) {
+    lines.push(hint);
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * 書き込み失敗などの I/O エラーメッセージを組み立てます。
+ *
+ * @param {object} options
+ * @param {string} options.projectName
+ * @param {string} options.actionLabel
+ * @param {string} options.targetFile
+ * @param {string} [options.workspaceRoot]
+ * @param {unknown} options.err
+ * @returns {string}
+ */
+function formatIoError(options) {
+  const { projectName, actionLabel, targetFile, workspaceRoot, err } = options;
+  return [
+    `[JSKim] プロジェクト "${projectName}" の${actionLabel}に失敗しました。`,
+    `対象: ${toDisplayPath(targetFile, workspaceRoot)}`,
+    `原因: ${getCauseMessage(err)}`,
+  ].join('\n');
+}
+
+module.exports = {
+  getCauseMessage,
+  readNunjucksLocation,
+  formatRenderError,
+  formatCollisionError,
+  formatPathOutsideError,
+  formatConfigValidationError,
+  formatIoError,
+};

package/scripts/lib/load-config.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const path = require('node:path');
+const { toDisplayPath } = require('./to-display-path');
 
 const CONFIG_FILENAME = 'jskim.config.js';
 
@@ -11,6 +12,7 @@ const CONFIG_FILENAME = 'jskim.config.js';
  */
 function loadConfig(workspaceRoot) {
   const configPath = path.join(workspaceRoot, CONFIG_FILENAME);
+  const configDisplay = toDisplayPath(configPath, workspaceRoot);
 
   let config;
   try {
@@ -25,21 +27,21 @@ function loadConfig(workspaceRoot) {
 
       if (missingConfig) {
         throw new Error(
-          `[JSKim] 設定ファイルが見つかりません: ${configPath}\n` +
+          `[JSKim] 設定ファイルが見つかりません: ${configDisplay}\n` +
             `ワークスペースルートに ${CONFIG_FILENAME} を作成してください。`
         );
       }
     }
 
     throw new Error(
-      `[JSKim] 設定ファイルの読み込みに失敗しました: ${configPath}\n` +
+      `[JSKim] 設定ファイルの読み込みに失敗しました: ${configDisplay}\n` +
         `原因: ${err && err.message ? err.message : String(err)}`
     );
   }
 
   if (!config || typeof config !== 'object') {
     throw new Error(
-      `[JSKim] 設定が不正です: ${configPath}\n` +
+      `[JSKim] 設定が不正です: ${configDisplay}\n` +
         `原因: module.exports はオブジェクトである必要があります。`
     );
   }
@@ -47,7 +49,7 @@ function loadConfig(workspaceRoot) {
   if (!config.projects || typeof config.projects !== 'object') {
     throw new Error(
       `[JSKim] 設定が不正です: projects が無い、またはオブジェクトではありません。\n` +
-        `設定: ${configPath}`
+        `設定: ${configDisplay}`
     );
   }
 

package/scripts/lib/merge-config.js

@@ -4,8 +4,8 @@
  * defaults とプロジェクト設定をマージします。
  *
  * - スカラー: プロジェクト側があれば優先
- * - オブジェクト (build / watch / serve / dev): 1段階の shallow merge
- * - 配列 (render / templates / copy): プロジェクト側配列が defaults を丸ごと置き換え
+ * - オブジェクト (build / watch / serve / dev / data / nunjucks): 1段階の shallow merge
+ * - 配列 (render / templates / copy / files): プロジェクト側配列が defaults を丸ごと置き換え
  *
  * 元の defaults / プロジェクトオブジェクトは変更しません。
  *
@@ -23,6 +23,9 @@ function mergeConfig(defaults, project) {
     render: pickArray(override.render, base.render, []),
     templates: pickArray(override.templates, base.templates, []),
     copy: pickArray(override.copy, base.copy, []),
+    files: pickOptionalArray(override.files, base.files),
+    data: mergePlainObject(base.data, override.data),
+    nunjucks: mergeNunjucks(base.nunjucks, override.nunjucks),
     build: mergeBuild(base.build, override.build),
     watch: mergeWatch(base.watch, override.watch),
     serve: mergeServe(base.serve, override.serve),
@@ -35,6 +38,19 @@ function mergeConfig(defaults, project) {
     render: merged.render.map((rule) => ({ ...rule })),
     templates: [...merged.templates],
     copy: merged.copy.map((rule) => ({ ...rule })),
+    files:
+      merged.files == null
+        ? null
+        : merged.files.map((rule) => ({
+            ...rule,
+            include: Array.isArray(rule.include) ? [...rule.include] : undefined,
+            exclude: Array.isArray(rule.exclude) ? [...rule.exclude] : undefined,
+          })),
+    data: isPlainObject(merged.data) ? { ...merged.data } : merged.data,
+    nunjucks: {
+      filters: { ...merged.nunjucks.filters },
+      globals: { ...merged.nunjucks.globals },
+    },
     build: { ...merged.build },
     watch: { ...merged.watch },
     serve: { ...merged.serve },
@@ -56,6 +72,75 @@ function pickArray(projectValue, defaultValue, fallback) {
   return fallback.slice();
 }
 
+/**
+ * files 未設定を null で表し、legacy と区別します。
+ * @returns {object[]|null}
+ */
+function pickOptionalArray(projectValue, defaultValue) {
+  if (Array.isArray(projectValue)) {
+    return projectValue.slice();
+  }
+  if (Array.isArray(defaultValue)) {
+    return defaultValue.slice();
+  }
+  return null;
+}
+
+function mergePlainObject(defaultValue, projectValue) {
+  if (projectValue !== undefined && !isPlainObject(projectValue)) {
+    return projectValue;
+  }
+  if (projectValue === undefined && defaultValue !== undefined && !isPlainObject(defaultValue)) {
+    return defaultValue;
+  }
+
+  const base = isPlainObject(defaultValue) ? defaultValue : {};
+  const override = isPlainObject(projectValue) ? projectValue : {};
+  return { ...base, ...override };
+}
+
+function isPlainObject(value) {
+  return value && typeof value === 'object' && !Array.isArray(value);
+}
+
+function mergeNunjucks(defaultValue, projectValue) {
+  const base =
+    defaultValue && typeof defaultValue === 'object' && !Array.isArray(defaultValue)
+      ? defaultValue
+      : {};
+  const override =
+    projectValue && typeof projectValue === 'object' && !Array.isArray(projectValue)
+      ? projectValue
+      : {};
+
+  const baseFilters =
+    base.filters && typeof base.filters === 'object' && !Array.isArray(base.filters)
+      ? base.filters
+      : {};
+  const overrideFilters =
+    override.filters &&
+    typeof override.filters === 'object' &&
+    !Array.isArray(override.filters)
+      ? override.filters
+      : {};
+
+  const baseGlobals =
+    base.globals && typeof base.globals === 'object' && !Array.isArray(base.globals)
+      ? base.globals
+      : {};
+  const overrideGlobals =
+    override.globals &&
+    typeof override.globals === 'object' &&
+    !Array.isArray(override.globals)
+      ? override.globals
+      : {};
+
+  return {
+    filters: { ...baseFilters, ...overrideFilters },
+    globals: { ...baseGlobals, ...overrideGlobals },
+  };
+}
+
 function mergeBuild(defaultBuild, projectBuild) {
   const base =
     defaultBuild && typeof defaultBuild === 'object' ? defaultBuild : {};