@tenjuu99/blog 0.3.4 → 0.3.6

package/lib/dir.js

@@ -27,6 +27,9 @@ const packageDirCore = path.dirname(__filename) + '/../packages'
 
 let alreadyCached = false
 
+// @vocab: パッケージ (docs/dictionary.md#パッケージ)
+// @vocab: ビルド (docs/dictionary.md#ビルド)
+// @test: tests/ssg-core/hooks.test.js
 const cache = () => {
   if (alreadyCached) {
     return

package/lib/distribute.js

@@ -8,14 +8,22 @@ import { styleText } from 'node:util'
 import config from './config.js'
 import { cacheDir } from './dir.js'
 import { applyTemplate } from './applyTemplate.js'
+import { distributeImages } from './imageDistributor.js'
+import { createConverter } from '../packages/editor/server/createConverter.js'
 
 const indexFile = `${cacheDir}/index.json`
 
+// @vocab: ページ (docs/dictionary.md#ページ)
+// @vocab: テンプレート (docs/dictionary.md#テンプレート)
 const renderPage = async (page) => {
   const template = page.template
   return [page.name, await render(template, page)]
 }
 
+// @vocab: ビルド (docs/dictionary.md#ビルド)
+// @vocab: ページ (docs/dictionary.md#ページ)
+// @vocab: ページインデックス (docs/dictionary.md#ページインデックス)
+// @test: tests/ssg-core/hooks.test.js
 const distribute = async (data, srcDir, distDir) => {
   const promises = []
   const newIndex = []
@@ -36,13 +44,19 @@ const distribute = async (data, srcDir, distDir) => {
     })
   }
   const distributeRaw = config.distribute_raw.split(',')
-  distributeRaw.forEach((copyDir) => {
+  const imageConverter = config.image_converter ? await createConverter(config.image_converter) : null
+  for (const copyDir of distributeRaw) {
     if (!existsSync(`${cacheDir}/${copyDir}`)) {
-      return
+      continue
+    }
+    if (imageConverter) {
+      await distributeImages(`${cacheDir}/${copyDir}/`, `${distDir}/${copyDir}/`, imageConverter)
+      console.log(styleText('green', '[convert]'), `${cacheDir}/${copyDir}/ => ${distDir}/${copyDir}/`)
+    } else {
+      cpSync(`${cacheDir}/${copyDir}/`, `${distDir}/${copyDir}/`, { recursive: true, force: true })
+      console.log(styleText('green', '[copy]'), `${cacheDir}/${copyDir}/ => ${distDir}/${copyDir}/`)
     }
-    cpSync(`${cacheDir}/${copyDir}/`, `${distDir}/${copyDir}/`, { recursive: true, force: true })
-    console.log(styleText('green', '[copy]'), `${cacheDir}/${copyDir}/ => ${distDir}/${copyDir}/`)
-  })
+  }
 
   if (!existsSync(cacheDir)) {
     mkdirSync(cacheDir)

package/lib/files.js

@@ -4,6 +4,8 @@ import { templateDir, cssDir } from './dir.js'
 let staticFilesContainer = {}
 let loaded = false
 
+// @vocab: テンプレート (docs/dictionary.md#テンプレート)
+// @test: tests/editor/editor-sidebar.test.js
 const warmUp = async () => {
   if (loaded) {
     return

package/lib/filter.js

@@ -70,6 +70,9 @@ const ifConditionEvaluator = (condition, variables) => {
  * @param {object} variables
  * @returns {string}
  */
+// @vocab: テンプレート (docs/dictionary.md#テンプレート)
+// @vocab: ヘルパー関数 (docs/dictionary.md#ヘルパー関数)
+// @test: tests/ssg-core/filter.test.js
 const replaceIfFilter = (text, variables) => {
   const matched = [...text.matchAll(IF_REGEXP)]
   for (const item of matched) {
@@ -87,6 +90,10 @@ const replaceIfFilter = (text, variables) => {
   return text
 }
 
+// @vocab: SSGスクリプト (docs/dictionary.md#ssgスクリプト)
+// @vocab: テンプレート (docs/dictionary.md#テンプレート)
+// @vocab: ヘルパー関数 (docs/dictionary.md#ヘルパー関数)
+// @test: tests/ssg-core/filter.test.js
 const replaceScriptFilter = async (text, variables) => {
   let replaced = text
   const scripts = [...text.matchAll(SCRIPT_REGEXP)].map((matched) => {

package/lib/generate.js

@@ -12,6 +12,8 @@ const beforeGenerate = async () => {
   await warmUpTemplate()
 }
 
+// @vocab: ビルド (docs/dictionary.md#ビルド)
+// @test: tests/ssg-core/hooks.test.js
 export const runHooks = async (hookName, customHelperDir = null, customAllData = null, customConfig = null) => {
   const targetConfig = customConfig || config
   const targetAllData = customAllData || allData
@@ -43,6 +45,9 @@ export const runHooks = async (hookName, customHelperDir = null, customAllData =
   }
 }
 
+// @vocab: ビルド (docs/dictionary.md#ビルド)
+// @vocab: ページインデックス (docs/dictionary.md#ページインデックス)
+// @test: tests/ssg-core/hooks.test.js
 const generate = async () => {
   let start = performance.now()
   await beforeGenerate()

package/lib/helper.js

@@ -7,6 +7,9 @@ const helper = {}
 // top-level await を使うと循環依存がある場合に ESM のデッドロックが発生するため IIFE を使用する。
 // helperReady をエクスポートすることで、ヘルパーのロード完了を外部から await できる。
 // （Promise は一度 resolve すれば以降の await は即座に返るため、複数箇所で await しても問題ない）
+// @vocab: ヘルパー関数 (docs/dictionary.md#ヘルパー関数)
+// @vocab: パッケージ (docs/dictionary.md#パッケージ)
+// @test: tests/ssg-core/helper.test.js
 export const helperReady = (async () => {
   if (config.helper) {
     const files = config.helper.split(',')

package/lib/imageDistributor.js

@@ -0,0 +1,59 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+const IMAGE_EXTENSIONS = new Set(['jpg', 'jpeg', 'png', 'gif', 'webp', 'avif', 'tiff', 'heic', 'bmp'])
+
+/**
+ * @vocab ビルド画像配布器 (docs/dictionary.md)
+ * @test tests/ssg-core/imageDistributor.test.js
+ */
+export async function distributeImages(srcDir, distDir, { fn, ext }) {
+  const files = await collectFiles(srcDir)
+  for (const relPath of files) {
+    const srcPath = path.join(srcDir, relPath)
+    const fileExt = path.extname(relPath).slice(1).toLowerCase()
+    const isImage = IMAGE_EXTENSIONS.has(fileExt)
+    const baseName = path.basename(relPath, path.extname(relPath))
+    const subDir = path.dirname(relPath)
+    if (fn && isImage) {
+      const outputName = ext ? `${baseName}.${ext}` : path.basename(relPath)
+      const distPath = path.join(distDir, subDir, outputName)
+      await writeConvertedFile(srcPath, distPath, fn)
+    } else {
+      const distPath = path.join(distDir, relPath)
+      fs.mkdirSync(path.dirname(distPath), { recursive: true })
+      fs.copyFileSync(srcPath, distPath)
+    }
+  }
+}
+
+/**
+ * @vocab ビルド画像配布器 (docs/dictionary.md)
+ * @test tests/ssg-core/imageDistributor.test.js
+ */
+export async function collectFiles(dir) {
+  const result = []
+  const walk = (current, rel) => {
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+      const relPath = rel ? path.join(rel, entry.name) : entry.name
+      if (entry.isDirectory()) {
+        walk(path.join(current, entry.name), relPath)
+      } else {
+        result.push(relPath)
+      }
+    }
+  }
+  walk(dir, '')
+  return result
+}
+
+/**
+ * @vocab ビルド画像配布器 (docs/dictionary.md)
+ * @test tests/ssg-core/imageDistributor.test.js
+ */
+export async function writeConvertedFile(srcPath, distPath, fn) {
+  const buffer = fs.readFileSync(srcPath)
+  const converted = await fn(buffer)
+  fs.mkdirSync(path.dirname(distPath), { recursive: true })
+  fs.writeFileSync(distPath, converted)
+}

package/lib/indexer.js

@@ -31,6 +31,9 @@ const collect = (dir, namePrefix = '', promises = []) => {
   return promises
 }
 
+// @vocab: ページインデックス (docs/dictionary.md#ページインデックス)
+// @vocab: ページ (docs/dictionary.md#ページ)
+// @test: tests/ssg-core/indexer.test.js
 const indexing = async () => {
   allData = {}
 

package/lib/pageData.js

@@ -5,11 +5,16 @@ import config from './config.js'
 const FRONTMATTER_REGEXP = /^(<!|-)--(?<variables>[\s\S]*?)--(-|>)/
 const METADATA_KEY_REGEXP = /^([a-zA-Z\d_-]+):/
 
+// @vocab: ページ (docs/dictionary.md#ページ)
+// @vocab: フロントマター (docs/dictionary.md#フロントマター)
+// @test: tests/ssg-core/pageData.test.js
 const makePageData = (filename, content) => {
   const [name, ext] = filename.split('.')
   return parse(content, name, ext)
 }
 
+// @vocab: フロントマター (docs/dictionary.md#フロントマター)
+// @vocab: ページ (docs/dictionary.md#ページ)
 const parse = (content, name, ext) => {
   const matched = content.match(FRONTMATTER_REGEXP)
   const markdownReplaced = content.replace(FRONTMATTER_REGEXP, '')
@@ -56,11 +61,17 @@ const parse = (content, name, ext) => {
     metaDataMerged.url = '/preview' + metaDataMerged.url
   }
   metaDataMerged.full_url = fullUrl(metaDataMerged)
-  metaDataMerged['__output'] = name === 'index' ? '/index.html' : `${metaDataMerged.url}.${metaDataMerged.ext}`
+  metaDataMerged['__output'] = name === 'index'
+    ? '/index.html'
+    : metaDataMerged.url.endsWith('/')
+      ? `${metaDataMerged.url}index.html`
+      : `${metaDataMerged.url}.${metaDataMerged.ext}`
 
   return metaDataMerged
 }
 
+// @vocab: フロントマター (docs/dictionary.md#フロントマター)
+// @test: tests/ssg-core/pageData.test.js
 const parseMetaData = (data) => {
   const metaData = {}
   let isStringContinue = false

package/lib/render.js

@@ -13,6 +13,11 @@ marked.use({
   breaks: true
 })
 
+// @vocab: テンプレート (docs/dictionary.md#テンプレート)
+// @vocab: ページ (docs/dictionary.md#ページ)
+// @vocab: SSGスクリプト (docs/dictionary.md#ssgスクリプト)
+// @vocab: ヘルパー関数 (docs/dictionary.md#ヘルパー関数)
+// @test: tests/ssg-core/helper.test.js
 const render = async (templateName, data) => {
   await helperReady
   let template

package/lib/replaceVariablesFilter.js

@@ -11,6 +11,9 @@ const VARIABLE_REGEXP = /(\\)?{{[\s]*([^{}]+)[\s]*}}/g
  * @params {object} variables
  * @return {text}
  */
+// @vocab: テンプレート (docs/dictionary.md#テンプレート)
+// @vocab: ヘルパー関数 (docs/dictionary.md#ヘルパー関数)
+// @test: tests/ssg-core/replaceVariablesFilter.test.js
 const replaceVariablesFilter = (text, variables) => {
   const matched = [...text.matchAll(VARIABLE_REGEXP)]
   const replace = Object.fromEntries(matched.map(match => [match[0], {variableName: match[2].trim().toLowerCase(), backslash: !!match[1]}]))
@@ -29,6 +32,8 @@ const replaceVariablesFilter = (text, variables) => {
  * @param {object} variables
  * @return {Array.<string>}
  */
+// @vocab: ヘルパー関数 (docs/dictionary.md#ヘルパー関数)
+// @vocab: テンプレート (docs/dictionary.md#テンプレート)
 const replaceVariable = (target, replaceTargetRawText, backslash, variables) => {
     const toBeReplace = replaceTargetRawText
     const toBeReplaceScript = toBeReplace.match(/([\w\d_]+)\((.*)\)/)

package/lib/tryServer.js

@@ -9,7 +9,9 @@ const handlers = async (path) => {
   if (handlersAlreadyRegistered) {
     return registeredHandlers[path]
   }
-  const serverFiles = fs.readdirSync(serverDir)
+  const serverFiles = fs.readdirSync(serverDir, { withFileTypes: true })
+    .filter(e => e.isFile())
+    .map(e => e.name)
   const loaded = await Promise.all(serverFiles.map(file => import(`${serverDir}/${file}`)))
   loaded.forEach(s => registeredHandlers[s.path] = s)
   handlersAlreadyRegistered = true

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@tenjuu99/blog",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "blog template",
   "main": "index.js",
   "scripts": {
     "dev": "node bin/dev-server",
     "server": "node bin/server",
     "generate": "node bin/generate",
-    "test": "node --test --test-concurrency=1 test/**/*.test.js",
-    "test:watch": "node --test --watch test/**/*.test.js"
+    "test": "node --test --test-concurrency=1 tests/**/*.test.js",
+    "test:watch": "node --test --watch tests/**/*.test.js"
   },
   "bin": {
     "generate": "bin/generate",
@@ -23,10 +23,13 @@
   "license": "MIT",
   "dependencies": {
     "chokidar": "^4.0.x",
-    "marked": "^13.x"
+    "marked": "^13.x",
+    "sharp": "^0.35.2"
   },
   "devDependencies": {
-    "@tenjuu99/blog": "file:./"
+    "@playwright/test": "^1.61.0",
+    "@tenjuu99/blog": "file:./",
+    "@types/node": "^25.9.3"
   },
   "type": "module",
   "engines": {

package/packages/breadcrumbs/helper/breadcrumbs.js

@@ -2,6 +2,9 @@ import { allData, config } from '@tenjuu99/blog'
 
 export function breadcrumbList(pageName, topPageName = 'top') {
   const pageData = allData[pageName]
+  if (!pageData) {
+    return ''
+  }
   const entries = Object.entries(allData)
   const breadCrumbs = ['/']
   if (pageData.breadcrumbs) {

package/packages/category/helper/category.js

@@ -8,6 +8,11 @@ let categoryTreeCache = null
  * @param {Object} config - 設定オブジェクト
  * @returns {Object} カテゴリーツリー
  */
+// @vocab: カテゴリーシステム (docs/dictionary.md#カテゴリーシステム)
+// @vocab: カテゴリー (docs/dictionary.md#カテゴリー)
+// @vocab: カテゴリーパス (docs/dictionary.md#カテゴリーパス)
+// @vocab: サブカテゴリー (docs/dictionary.md#サブカテゴリー)
+// @test: tests/category/category-tree.test.js
 export function buildCategoryTree(data = allData, conf = config) {
   const tree = {}
   const urlCase = conf.category?.url_case || 'lower'
@@ -74,6 +79,10 @@ export function getCategoryTree() {
  * @param {Array} categoryPath - カテゴリーパス（例: ["Art", "Painting"]）
  * @returns {Array} ページデータの配列
  */
+// @vocab: カテゴリーパス (docs/dictionary.md#カテゴリーパス)
+// @vocab: カテゴリー (docs/dictionary.md#カテゴリー)
+// @vocab: ページ (docs/dictionary.md#ページ)
+// @test: tests/category/category-helper.test.js
 export function getCategoryPages(categoryPath) {
   const pages = []
 
@@ -95,6 +104,10 @@ export function getCategoryPages(categoryPath) {
  * @param {Array} categoryPath - カテゴリーパス（例: ["Art"]）
  * @returns {Array} ページデータの配列
  */
+// @vocab: サブカテゴリー (docs/dictionary.md#サブカテゴリー)
+// @vocab: カテゴリーパス (docs/dictionary.md#カテゴリーパス)
+// @vocab: ページ (docs/dictionary.md#ページ)
+// @test: tests/category/category-helper.test.js
 export function getCategoryPagesRecursive(categoryPath) {
   const pages = []
 

package/packages/category/helper/categoryIndexer.js

@@ -4,6 +4,8 @@ import { buildCategoryTree } from './category.js'
  * 記事名配列を perPage 件ずつのページ配列に分割する
  * 空の場合は [[]] を返す（ページ数ゼロを避けるため）
  */
+// @vocab: ページネーション (docs/dictionary.md#ページネーション)
+// @test: tests/category/category-pagination.test.js
 function sliceIntoPages(items, perPage) {
   if (items.length === 0) return [[]]
   const pages = []
@@ -37,6 +39,9 @@ function sliceIntoPages(items, perPage) {
  * @param {Object} categoryConfig - 単一カテゴリー設定オブジェクト
  * @param {Object} config - グローバル設定オブジェクト
  */
+// @vocab: カテゴリーページ (docs/dictionary.md#カテゴリーページ)
+// @vocab: ページネーション (docs/dictionary.md#ページネーション)
+// @test: tests/category/category-pagination.test.js
 function buildVirtualPage(url, categoryData, children, currentPage, totalPages, categoryConfig, config) {
   const pageName = url.replace(/^\//, '') + '/index'
   const paginationBase = categoryData.baseUrl + '/'
@@ -44,7 +49,7 @@ function buildVirtualPage(url, categoryData, children, currentPage, totalPages,
 
   const page = {
     name: pageName,
-    url: url,
+    url: url + '/',
     __output: `${url}/index.html`,
     title: categoryData.title,
     template: categoryConfig.template || 'category.html',
@@ -65,7 +70,7 @@ function buildVirtualPage(url, categoryData, children, currentPage, totalPages,
     og_description: `${categoryData.title} カテゴリーのページ一覧`,
     __filetype: 'md',
     markdown_not_parsed: '',
-    full_url: `${config.url_base || 'http://localhost:8000'}${url}`,
+    full_url: `${config.url_base || 'http://localhost:8000'}${url}/`,
     category_pages: [],
     category_current_page: currentPage,
     category_total_pages: totalPages,
@@ -82,6 +87,10 @@ function buildVirtualPage(url, categoryData, children, currentPage, totalPages,
  * @param {Object} categoryConfig - 単一カテゴリー設定オブジェクト
  * @param {Object} config - グローバル設定オブジェクト
  */
+// @vocab: カテゴリーページ (docs/dictionary.md#カテゴリーページ)
+// @vocab: カテゴリーシステム (docs/dictionary.md#カテゴリーシステム)
+// @vocab: ページネーション (docs/dictionary.md#ページネーション)
+// @test: tests/category/category-pagination.test.js
 function generateCategoryPages(allData, categoryConfig, config) {
   const pathFilter = categoryConfig.path_filter || ''
   let filteredData = allData
@@ -100,7 +109,7 @@ function generateCategoryPages(allData, categoryConfig, config) {
 
   for (const [url, categoryData] of Object.entries(tree)) {
     const children = Object.entries(categoryData.children).map(([childUrl, childNode]) => ({
-      url: childUrl,
+      url: childUrl + '/',
       title: childNode.title,
     }))
 
@@ -140,6 +149,9 @@ function generateCategoryPages(allData, categoryConfig, config) {
  * @param {Object} allData - 全ページデータ
  * @param {Object} config - 設定オブジェクト
  */
+// @vocab: カテゴリーシステム (docs/dictionary.md#カテゴリーシステム)
+// @vocab: ビルド (docs/dictionary.md#ビルド)
+// @test: tests/category/category-indexer.test.js
 export async function afterIndexing(allData, config) {
   const categorySystems = config.categories
     ? config.categories

package/packages/category/helper/pagination.js

@@ -2,6 +2,9 @@
  * getPaginationUrl: ページ番号から URL を生成する
  * page === 1 なら basePath、それ以外なら basePath + page + '/'
  */
+// @vocab: ページネーション (docs/dictionary.md#ページネーション)
+// @vocab: カテゴリーページ (docs/dictionary.md#カテゴリーページ)
+// @test: tests/category/category-pagination.test.js
 export function getPaginationUrl(basePath, page) {
   const base = basePath.endsWith('/') ? basePath : `${basePath}/`
   if (page === 1) return base
@@ -12,6 +15,8 @@ export function getPaginationUrl(basePath, page) {
  * buildWindowedPages: ウィンドウ付きページ番号リストを生成する
  * 各要素は {num, isCurrent} または {num: null, isEllipsis: true}
  */
+// @vocab: ページネーション (docs/dictionary.md#ページネーション)
+// @test: tests/category/category-pagination.test.js
 export function buildWindowedPages(totalPages, currentPage, windowSize = 2) {
   if (totalPages <= 0) return []
   if (totalPages === 1) return [{ num: 1, isCurrent: currentPage === 1 }]

package/packages/editor/css/editor.css

@@ -90,7 +90,7 @@ form select {
   background: rgb(192, 198, 217);
   height: 100%;
   padding: 0;
-  overflow-y: hidden;
+  overflow-y: auto;
   flex-basis: 300px;
   position: relative;
   z-index: 3;
@@ -117,9 +117,28 @@ form select {
   color: #666;
   text-decoration: none;
 }
+.sidebar a.active {
+  font-weight: bold;
+  color: #333;
+  background: rgba(104, 117, 154, .2);
+  display: block;
+}
 .sidebar li:hover {
   background: rgba(104, 117, 154, .3);
 }
+.sidebar details > summary {
+  cursor: pointer;
+  padding: 2px 0;
+  color: #444;
+  font-size: 0.9em;
+  list-style: disclosure-closed;
+}
+.sidebar details[open] > summary {
+  list-style: disclosure-open;
+}
+.sidebar details > ul {
+  padding-left: 8px;
+}
 .sidebar-toggle {
   cursor: pointer;
   width: 20px;

package/packages/editor/helper/sidebarTree.js

@@ -0,0 +1,6 @@
+import { buildTree, renderTreeHtml } from '../js/tree.js'
+
+export function renderSidebarTree(files) {
+  const tree = buildTree(files.filter(f => !f.__is_auto_category))
+  return renderTreeHtml(tree)
+}