@shevky/core 0.0.4 → 0.0.6

package/engines/renderEngine.js

@@ -517,7 +517,9 @@ export class RenderEngine {
       return;
     }
 
-    const configKeys = Object.keys(collectionsConfig);
+    const configKeys = Object.keys(collectionsConfig).filter(
+      (key) => key !== "includeContentFile",
+    );
     for (const configKey of configKeys) {
       const config = collectionsConfig[configKey];
       if (!config || typeof config !== "object") {

package/lib/contentFile.js

@@ -40,6 +40,10 @@ export class ContentFile {
     return this._header.status;
   }
 
+  get fragment() {
+    return this._header.fragment;
+  }
+
   get id() {
     return this._header.id;
   }
@@ -167,4 +171,16 @@ export class ContentFile {
   get isPostTemplate() {
     return this.template === "post";
   }
+
+  toObject() {
+    return {
+      header: this._header.raw,
+      body: {
+        content: this.content,
+      },
+      content: this.content,
+      isValid: this.isValid,
+      sourcePath: this.sourcePath,
+    };
+  }
 }

package/lib/contentHeader.js

@@ -18,6 +18,10 @@ export class ContentHeader {
       : "";
   }
 
+  get fragment() {
+    return _fmt.boolean(this._frontMatter.fragment);
+  }
+
   get id() {
     return typeof this._frontMatter.id === "string"
       ? this._frontMatter.id.trim()

package/lib/contentSummary.js

@@ -12,6 +12,10 @@ export class ContentSummary {
     return this._file.id;
   }
 
+  get fragment() {
+    return this._file.fragment;
+  }
+
   get title() {
     return this._file.title;
   }
@@ -67,6 +71,7 @@ export class ContentSummary {
   toObject() {
     return {
       id: this.id,
+      fragment: this.fragment,
       title: this.title,
       slug: this.slug,
       lang: this.lang,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shevky/core",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "A minimal, dependency-light static site generator.",
   "type": "module",
   "main": "shevky.js",
@@ -36,7 +36,7 @@
   },
   "homepage": "https://github.com/shevky/core#readme",
   "dependencies": {
-    "@shevky/base": "^0.0.2",
+    "@shevky/base": "^0.0.3",
     "@types/node": "^20.11.30",
     "@types/mustache": "^4.2.6",
     "@types/html-minifier-terser": "^7.0.2",

package/registries/contentRegistry.js

@@ -1,4 +1,4 @@
-import { io as _io } from "@shevky/base";
+import { io as _io, config as _cfg } from "@shevky/base";
 import matter from "gray-matter";
 
 import { ContentFile } from "../lib/contentFile.js";
@@ -202,6 +202,9 @@ export class ContentRegistry {
       return this.#_collectionsCache;
     }
 
+    const includeContentFile = Boolean(
+      _cfg?.content?.collections?.includeContentFile,
+    );
     /** @type {import("../types/index.d.ts").CollectionsByLang} */
     const pagesByLang = {};
     const contentFiles = this.files;
@@ -211,8 +214,10 @@ export class ContentRegistry {
       }
 
       const contentSummary = new ContentSummary(file);
+      const summaryBase = contentSummary.toObject();
       const summary = /** @type {import("../types/index.d.ts").CollectionEntry} */ ({
-        ...contentSummary.toObject(),
+        ...summaryBase,
+        ...(includeContentFile ? file.toObject() : {}),
         canonical: this.#_metaEngine.buildContentUrl(
           file.canonical,
           file.lang,

package/scripts/build.js

@@ -48,6 +48,7 @@ const TEMPLATES_DIR = _prj.templatesDir;
 const ASSETS_DIR = _prj.assetsDir;
 const SITE_CONFIG_PATH = _prj.siteConfig;
 const I18N_CONFIG_PATH = _prj.i18nConfig;
+const FRAGMENTS_DIR = "fragments";
 
 const pluginRegistry = new PluginRegistry();
 const templateRegistry = new TemplateRegistry();
@@ -461,6 +462,100 @@ async function renderContentTemplate(
   listingOverride,
 ) {
   const template = templateRegistry.getTemplate(TYPE_TEMPLATE, templateName);
+  const {
+    normalizedFront,
+    listing,
+    collectionFlags,
+    site,
+    languageFlags,
+    resolvedDictionary,
+  } = buildContentRenderContext(front, lang, dictionary, listingOverride);
+
+  return Mustache.render(
+    template.content,
+    {
+      content: { html: decorateHtml(contentHtml, templateName) },
+      front: normalizedFront,
+      lang,
+      listing,
+      site,
+      locale: languageFlags.locale,
+      isEnglish: languageFlags.isEnglish,
+      isTurkish: languageFlags.isTurkish,
+      i18n: resolvedDictionary,
+      ...collectionFlags,
+    },
+    {
+      ...templateRegistry.getFiles(TYPE_PARTIAL),
+      ...templateRegistry.getFiles(TYPE_COMPONENT),
+    },
+  );
+}
+
+/**
+ * @param {string} contentHtml
+ * @param {FrontMatter} front
+ * @param {string} lang
+ * @param {Record<string, any>} dictionary
+ * @param {string} [templateName]
+ * @param {any} [listingOverride]
+ */
+async function renderFragmentTemplate(
+  contentHtml,
+  front,
+  lang,
+  dictionary,
+  templateName,
+  listingOverride,
+) {
+  const template =
+    typeof templateName === "string" && templateName.trim().length > 0
+      ? templateRegistry.getTemplate(TYPE_TEMPLATE, templateName.trim())
+      : null;
+  if (templateName && !template) {
+    _log.warn(`[build] Fragment template not found: ${templateName}`);
+  }
+  const {
+    normalizedFront,
+    listing,
+    collectionFlags,
+    site,
+    languageFlags,
+    resolvedDictionary,
+  } = buildContentRenderContext(front, lang, dictionary, listingOverride);
+  const decorated = decorateHtml(contentHtml, templateName ?? "");
+  const templateContent = template?.content ?? "{{{content.html}}}";
+
+  return Mustache.render(
+    templateContent,
+    {
+      content: { html: decorated },
+      contentHtml: decorated,
+      contentObject: { html: decorated },
+      front: normalizedFront,
+      lang,
+      listing,
+      site,
+      locale: languageFlags.locale,
+      isEnglish: languageFlags.isEnglish,
+      isTurkish: languageFlags.isTurkish,
+      i18n: resolvedDictionary,
+      ...collectionFlags,
+    },
+    {
+      ...templateRegistry.getFiles(TYPE_PARTIAL),
+      ...templateRegistry.getFiles(TYPE_COMPONENT),
+    },
+  );
+}
+
+/**
+ * @param {FrontMatter} front
+ * @param {string} lang
+ * @param {Record<string, any>} dictionary
+ * @param {any} [listingOverride]
+ */
+function buildContentRenderContext(front, lang, dictionary, listingOverride) {
   const baseFront = normalizeFrontMatter(front);
   /** @type {string[]} */
   const normalizedTags = Array.isArray(front.tags)
@@ -513,25 +608,14 @@ async function renderContentTemplate(
   const site = metaEngine.buildSiteData(lang);
   const languageFlags = _i18n.flags(lang);
 
-  return Mustache.render(
-    template.content,
-    {
-      content: { html: decorateHtml(contentHtml, templateName) },
-      front: normalizedFront,
-      lang,
-      listing,
-      site,
-      locale: languageFlags.locale,
-      isEnglish: languageFlags.isEnglish,
-      isTurkish: languageFlags.isTurkish,
-      i18n: resolvedDictionary,
-      ...collectionFlags,
-    },
-    {
-      ...templateRegistry.getFiles(TYPE_PARTIAL),
-      ...templateRegistry.getFiles(TYPE_COMPONENT),
-    },
-  );
+  return {
+    normalizedFront,
+    listing,
+    collectionFlags,
+    site,
+    languageFlags,
+    resolvedDictionary,
+  };
 }
 
 /**
@@ -597,6 +681,18 @@ function buildOutputPath(front, lang, slug) {
   return _io.path.combine(...segments.filter(Boolean), "index.html");
 }
 
+/** @param {unknown} value */
+function resolveFragmentId(value) {
+  if (typeof value !== "string") {
+    return "";
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return "";
+  }
+  return trimmed.replace(/[\\/]/g, "-");
+}
+
 /** @param {string} value */
 function toPosixPath(value) {
   return value.split(_io.path.separator).join("/");
@@ -833,6 +929,13 @@ async function buildContentPages() {
       markdownHtml ?? "",
       placeholders,
     );
+    const rawFront = normalizeFrontMatter(file.header);
+    const shouldBuildFragment = _fmt.boolean(rawFront.fragment);
+    const fragmentTemplateName =
+      typeof rawFront.fragmentTemplate === "string" &&
+      rawFront.fragmentTemplate.trim().length > 0
+        ? rawFront.fragmentTemplate.trim()
+        : file.template;
 
     if (file.template === "collection" || file.template === "home") {
       await renderEngine.buildPaginatedCollectionPages({
@@ -918,6 +1021,48 @@ async function buildContentPages() {
         inputBytes: byteLength(file.content),
       },
     });
+
+    if (shouldBuildFragment) {
+      const fragmentId = resolveFragmentId(rawFront.id ?? file.id);
+      if (!fragmentId) {
+        _log.warn(
+          `[build] Fragment skipped for ${normalizeLogPath(file.sourcePath)} (missing id).`,
+        );
+      } else {
+        const fragmentHtml = await renderFragmentTemplate(
+          hydratedHtml,
+          file.header,
+          file.lang,
+          dictionary,
+          fragmentTemplateName,
+        );
+        const transformedFragment = await renderEngine.transformHtml(
+          fragmentHtml,
+          {
+            versionToken,
+            minifyHtml,
+          },
+        );
+        const fragmentLang =
+          typeof file.lang === "string" && file.lang.trim().length > 0
+            ? file.lang.trim()
+            : _i18n.default;
+        const fragmentPath = _io.path.combine(
+          FRAGMENTS_DIR,
+          fragmentLang,
+          `frag_${fragmentId}.html`,
+        );
+        GENERATED_PAGES.add(toPosixPath(fragmentPath));
+        await writeHtmlFile(fragmentPath, transformedFragment, {
+          action: "BUILD_FRAGMENT",
+          type: "fragment",
+          source: file.sourcePath,
+          lang: file.lang,
+          template: fragmentTemplateName,
+          inputBytes: byteLength(file.content),
+        });
+      }
+    }
   }
 
   await renderEngine.buildDynamicCollectionPages({

package/scripts/main.js

@@ -4,7 +4,7 @@ import _cli from "./cli.js";
 import _build from "./build.js";
 import _init from "./init.js";
 
-const VERSION = "0.0.4";
+const VERSION = "0.0.6";
 
 const __filename = _io.url.toPath(import.meta.url);
 const __dirname = _io.path.name(__filename);

package/scripts/social.js

@@ -1,6 +1,10 @@
 import { config as _cfg } from "@shevky/base";
 
 function getRss() {
+  if (!_cfg.identity.social.rss) {
+    return;
+  }
+
   return {
     key: "rss",
     tone: "rss",

package/types/index.d.ts

@@ -91,6 +91,11 @@ export type CollectionEntry = ContentSummaryLike & {
   type?: string;
   seriesTitle?: string;
   canonical?: string;
+  header?: ContentHeaderLike;
+  body?: ContentBodyLike;
+  content?: string;
+  isValid?: boolean;
+  sourcePath?: string;
 };
 
 export type CollectionsByLang = Record<string, Record<string, CollectionEntry[]>>;