koguma 2.2.0 → 2.2.1

package/cli/scaffold.ts

@@ -11,7 +11,11 @@ import {
 import { resolve } from 'path';
 import { ok, warn } from './log.ts';
 import { generateKogumaToml } from './config.ts';
-import { findMarkdownField, type ContentTypeInfo } from './content.ts';
+import {
+  findMarkdownField,
+  findMarkdownFields,
+  type ContentTypeInfo
+} from './content.ts';
 import matter from 'gray-matter';
 
 // ── Template types ─────────────────────────────────────────────────
@@ -315,29 +319,50 @@ export function generateExampleFile(
   ctId: string,
   fields: Record<string, { fieldType: string }>,
   singleton?: boolean
-): { content: string; extension: string } {
+): {
+  content: string;
+  extension: string;
+  siblingFiles?: { fieldId: string; content: string }[];
+} {
   const frontmatter: Record<string, unknown> = {};
-  let hasMarkdown = false;
+  const mdFields = Object.entries(fields)
+    .filter(([, meta]) => meta.fieldType === 'markdown')
+    .map(([id]) => id);
+  const primaryMdField = mdFields[0] ?? null;
+  const extraMdFields = mdFields.slice(1);
 
   for (const [fieldId, meta] of Object.entries(fields)) {
     if (meta.fieldType === 'markdown') {
-      hasMarkdown = true;
-      continue; // markdown goes in body, not frontmatter
+      continue; // markdown goes in body or sibling files, not frontmatter
     }
     frontmatter[fieldId] = placeholderForFieldType(meta.fieldType);
   }
 
-  if (hasMarkdown) {
+  // Build sibling example files for extra markdown fields
+  const siblingFiles: { fieldId: string; content: string }[] = [];
+  for (const fieldId of extraMdFields) {
+    siblingFiles.push({
+      fieldId,
+      content: `Write your ${fieldId} content here.`
+    });
+  }
+
+  if (primaryMdField) {
     const fm = matter.stringify('', frontmatter).trim();
     const bodyHint = singleton ? '' : `\nWrite your ${ctId} content here.\n`;
     return {
       content: `${fm}\n${bodyHint}`,
-      extension: '.md'
+      extension: '.md',
+      ...(siblingFiles.length > 0 ? { siblingFiles } : {})
     };
   }
 
   const fm = matter.stringify('', frontmatter).trim();
-  return { content: fm + '\n', extension: '.md' };
+  return {
+    content: fm + '\n',
+    extension: '.md',
+    ...(siblingFiles.length > 0 ? { siblingFiles } : {})
+  };
 }
 
 /**
@@ -367,7 +392,7 @@ export function scaffoldContentDirFromTemplate(
         fields[fid] = { fieldType: fieldTypeFromExpression(expr) };
       }
 
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         fields,
         ct.singleton
@@ -375,6 +400,14 @@ export function scaffoldContentDirFromTemplate(
       const filename = `_example${extension}`;
       writeFileSync(resolve(typeDir, filename), content);
       ok(`Created content/${ct.id}/${filename}`);
+
+      // Write sibling example files for extra markdown fields
+      if (siblingFiles) {
+        for (const { fieldId, content: siblingContent } of siblingFiles) {
+          const siblingName = `_example.${fieldId}.md`;
+          writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+        }
+      }
     } else if (!dirExisted) {
       ok(`Created content/${ct.id}/`);
     }
@@ -408,7 +441,7 @@ export function scaffoldContentDir(
     const isEmpty = dirExisted ? readdirSync(typeDir).length === 0 : true;
 
     if (isEmpty) {
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         ct.fieldMeta,
         ct.singleton
@@ -416,6 +449,14 @@ export function scaffoldContentDir(
       const filename = `_example${extension}`;
       writeFileSync(resolve(typeDir, filename), content);
       ok(`Created content/${ct.id}/${filename}`);
+
+      // Write sibling example files for extra markdown fields
+      if (siblingFiles) {
+        for (const { fieldId, content: siblingContent } of siblingFiles) {
+          const siblingName = `_example.${fieldId}.md`;
+          writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+        }
+      }
     } else if (!dirExisted) {
       ok(`Created content/${ct.id}/`);
     }
@@ -538,7 +579,7 @@ export function syncContentDirsWithConfig(
         mkdirSync(typeDir, { recursive: true });
       }
 
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         ct.fieldMeta,
         ct.singleton
@@ -551,6 +592,14 @@ export function syncContentDirsWithConfig(
       if (!dryRun) {
         writeFileSync(resolve(typeDir, filename), content);
         ok(`Created content/${ct.id}/${filename}`);
+
+        // Write sibling example files for extra markdown fields
+        if (siblingFiles) {
+          for (const { fieldId, content: siblingContent } of siblingFiles) {
+            const siblingName = `_example.${fieldId}.md`;
+            writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+          }
+        }
       }
       continue;
     }
@@ -559,7 +608,7 @@ export function syncContentDirsWithConfig(
 
     // If dir is empty, create _example
     if (files.length === 0) {
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         ct.fieldMeta,
         ct.singleton
@@ -572,6 +621,14 @@ export function syncContentDirsWithConfig(
       if (!dryRun) {
         writeFileSync(resolve(typeDir, filename), content);
         ok(`Created content/${ct.id}/${filename}`);
+
+        // Write sibling example files for extra markdown fields
+        if (siblingFiles) {
+          for (const { fieldId, content: siblingContent } of siblingFiles) {
+            const siblingName = `_example.${fieldId}.md`;
+            writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+          }
+        }
       }
       continue;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koguma",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "🐻 A little CMS with big heart — schema-driven, runs on Cloudflare's free tier",
   "type": "module",
   "license": "MIT",