kss-modern 1.5.0 → 1.6.0

package/dist/node/lib/index.d.mts

@@ -153,6 +153,15 @@ interface StyleguideOptions {
      * the initial page load.
      */
     reloadPreviewsOnThemeChange?: boolean;
+    /**
+     * Let search engines index the generated styleguide.
+     *
+     * Off by default: a styleguide is internal documentation, and its output directory is usually
+     * served from a host that is reachable without being meant for the public. Every build writes a
+     * `robots.txt` into the output root, and every page carries a matching `<meta name="robots">` —
+     * `noindex, nofollow` while this is off, `index, follow` once it is on.
+     */
+    allowSearchEngineIndexing?: boolean;
     logoSignet?: {
         href: string;
     } | {

package/dist/node/lib/index.d.ts

@@ -153,6 +153,15 @@ interface StyleguideOptions {
      * the initial page load.
      */
     reloadPreviewsOnThemeChange?: boolean;
+    /**
+     * Let search engines index the generated styleguide.
+     *
+     * Off by default: a styleguide is internal documentation, and its output directory is usually
+     * served from a host that is reachable without being meant for the public. Every build writes a
+     * `robots.txt` into the output root, and every page carries a matching `<meta name="robots">` —
+     * `noindex, nofollow` while this is off, `index, follow` once it is on.
+     */
+    allowSearchEngineIndexing?: boolean;
     logoSignet?: {
         href: string;
     } | {

package/dist/node/lib/index.mjs

@@ -1344,6 +1344,18 @@ async function logicalWriteFile(filepath, content) {
   await fs.writeFile(filepath, content);
 }
 
+const ROBOTS_FILE_NAME = "robots.txt";
+function generateRobotsTxt(allowSearchEngineIndexing) {
+  const rule = allowSearchEngineIndexing ? "Allow: /" : "Disallow: /";
+  return `# Generated by kss-modern
+User-agent: *
+${rule}
+`;
+}
+async function writeRobotsFile(outDir, allowSearchEngineIndexing) {
+  await logicalWriteFile(path.join(outDir, ROBOTS_FILE_NAME), generateRobotsTxt(allowSearchEngineIndexing));
+}
+
 async function generateFullPageFile(data) {
   const supportsDarkMode = !(data.deactivateDarkMode ?? false);
   const computedScriptTags = data.js.filter((entry) => entry.type !== "overwriteStyleguide").map((js) => {
@@ -1363,6 +1375,7 @@ async function generateFullPageFile(data) {
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="generator" content="styleguide">
+    <meta name="robots" content="${data.allowSearchEngineIndexing ? "index, follow" : "noindex, nofollow"}">
     <link rel="icon" type="image/svg+xml" href="/styleguide-assets/favicon/fullpage.svg">
     ${data.ogImageUrl ? `<meta property="og:image" content="${data.ogImageUrl}">` : ""}
     ${typeof data.brandColor === "object" && "dark" in data.brandColor && "light" in data.brandColor ? `
@@ -2228,6 +2241,7 @@ async function generatePreviewFile(data) {
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="generator" content="styleguide">
+    <meta name="robots" content="${data.allowSearchEngineIndexing ? "index, follow" : "noindex, nofollow"}">
     <link rel="icon" type="image/svg+xml" href="/styleguide-assets/favicon/preview.svg">
     ${data.ogImageUrl ? `<meta property="og:image" content="${data.ogImageUrl}">` : ""}
     ${typeof data.brandColor === "object" && "dark" in data.brandColor && "light" in data.brandColor ? `
@@ -2693,6 +2707,7 @@ async function writeFullPageFile(config, baseDirectory, section) {
       html: htmlMarkup,
       brandColor: config.brandColor,
       deactivateDarkMode: config.deactivateDarkMode,
+      allowSearchEngineIndexing: config.allowSearchEngineIndexing,
       ogImageUrl: config.plugins?.ogImage ? config.plugins.ogImage(section) : void 0
     });
   } catch (error) {
@@ -2750,6 +2765,7 @@ function writePreviewFile(config, context, firstLevelIndex, secondLevelIndex) {
     },
     brandColor: config.brandColor,
     deactivateDarkMode: config.deactivateDarkMode,
+    allowSearchEngineIndexing: config.allowSearchEngineIndexing,
     reloadPreviewsOnThemeChange: config.reloadPreviewsOnThemeChange,
     ogImageUrl: config.plugins?.ogImage ? config.plugins.ogImage(secondLevelSection) : void 0
   });
@@ -2886,7 +2902,11 @@ async function buildAll(input) {
       fileWriteTasks.push(writePreviewFile(config, context, firstLevelIndex, secondLevelIndex));
     });
   });
-  await Promise.all([copyStyleguideAssets(config), ...fileWriteTasks]);
+  await Promise.all([
+    copyStyleguideAssets(config),
+    writeRobotsFile(config.outDir, config.allowSearchEngineIndexing ?? false),
+    ...fileWriteTasks
+  ]);
   const errors = {};
   if (context.overwrittenSectionsIds.length > 0) {
     errors.overwrittenSectionsIds = context.overwrittenSectionsIds;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kss-modern",
   "type": "module",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Modern KSS compatible styleguide generator",
   "keywords": [
     "kss",