@docubook/flame 1.3.4 → 1.3.5

package/.docu/node/build.ts

@@ -112,8 +112,8 @@ async function renderDocsPage(
     });
   }
 
-  const title = (frontmatter.title as string) || slug || "Docs";
-  const description = (frontmatter.description as string) || "";
+  const title = (typeof frontmatter.title === "string" ? frontmatter.title : "") || slug || "Docs";
+  const description = typeof frontmatter.description === "string" ? frontmatter.description : "";
   const slugParts = slug ? slug.split("/") : [];
 
   const page = React.createElement(

package/.docu/node/plugin-builder.ts

@@ -365,6 +365,8 @@ export class BuildPluginBuilder implements PluginBuilder {
    * Each callback receives the **previous** callback's return value (or the
    * original frontmatter for the first). Callbacks that return `undefined` or
    * `null` pass the current value through unchanged.
+   * Callbacks that return a non-object (string, number, array) are skipped
+   * with a console warning — only plain objects are accepted.
    * Errors inside individual callbacks are caught and logged — the current
    * frontmatter passes through unchanged for that step.
    *
@@ -381,7 +383,13 @@ export class BuildPluginBuilder implements PluginBuilder {
       try {
         const next = await this._transformFrontmatter[i](result, context);
         if (next !== undefined && next !== null) {
-          result = next;
+          if (typeof next === "object" && !Array.isArray(next)) {
+            result = next;
+          } else {
+            console.warn(
+              `[plugin] transformFrontmatter callback #${i + 1} returned invalid type (expected a plain object), skipping`
+            );
+          }
         }
       } catch (err) {
         console.error(
@@ -422,6 +430,10 @@ export class BuildPluginBuilder implements PluginBuilder {
    * Callbacks are chained in a waterfall: the return value of one is passed
    * as input to the next. Return `undefined` to pass through unchanged.
    *
+   * **Note:** Only plain objects are accepted as return values. Returning
+   * a string, number, or array will be silently skipped with a warning.
+   * Plugin authors should validate their return values before returning.
+   *
    * @param callback - Receives frontmatter object and page context.
    *
    * @example

package/.docu/node/server-routes.ts

@@ -121,8 +121,12 @@ async function renderDocsServerPage(
   pathname: string,
   state: ServerState
 ): Promise<Response> {
-  const title = (doc.frontmatter.title as string) || slug.join("/") || "Docs";
-  const description = (doc.frontmatter.description as string) || "";
+  const title =
+    (typeof doc.frontmatter.title === "string" ? doc.frontmatter.title : "") ||
+    slug.join("/") ||
+    "Docs";
+  const description =
+    typeof doc.frontmatter.description === "string" ? doc.frontmatter.description : "";
 
   const page = React.createElement(
     DocsLayout,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docubook/flame",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "A blazing-fast React + MDX framework powered by Bun, built for modern documentation experiences.",
   "type": "module",
   "bin": {