kss-modern 0.0.41 → 0.0.42

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

@@ -37,6 +37,12 @@ interface in2Section {
     previewFileName: string;
     fullpageFileName: string;
 }
+interface in2FirstLevelSection extends in2Section {
+    sections: in2SecondLevelSection[];
+}
+interface in2SecondLevelSection extends in2Section {
+    sections: in2Section[];
+}
 
 interface StyleguideConfiguration {
     mode: 'development' | 'production';
@@ -79,6 +85,13 @@ interface StyleguideBuildOutput {
         overwrittenSectionsIds?: string[];
     };
 }
+/**
+ * Parse given contentDir and get structured data for further processing
+ */
+declare function parseStyleguide(contentDir: StyleguideConfiguration['contentDir']): Promise<{
+    content: in2FirstLevelSection[];
+    overwrittenSectionsIds: string[];
+}>;
 /**
  * Builds the styleguide
  * @param config - The configuration for the styleguide
@@ -92,5 +105,5 @@ declare function buildStyleguide(config: StyleguideConfiguration): Promise<Style
  */
 declare function watchStyleguide(config: StyleguideConfiguration, onChange?: () => void, onError?: (errorData: StyleguideBuildOutput['errors']) => void): Promise<void>;
 
-export { buildStyleguide, watchStyleguide };
+export { buildStyleguide, parseStyleguide, watchStyleguide };
 export type { StyleguideConfiguration };

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

@@ -37,6 +37,12 @@ interface in2Section {
     previewFileName: string;
     fullpageFileName: string;
 }
+interface in2FirstLevelSection extends in2Section {
+    sections: in2SecondLevelSection[];
+}
+interface in2SecondLevelSection extends in2Section {
+    sections: in2Section[];
+}
 
 interface StyleguideConfiguration {
     mode: 'development' | 'production';
@@ -79,6 +85,13 @@ interface StyleguideBuildOutput {
         overwrittenSectionsIds?: string[];
     };
 }
+/**
+ * Parse given contentDir and get structured data for further processing
+ */
+declare function parseStyleguide(contentDir: StyleguideConfiguration['contentDir']): Promise<{
+    content: in2FirstLevelSection[];
+    overwrittenSectionsIds: string[];
+}>;
 /**
  * Builds the styleguide
  * @param config - The configuration for the styleguide
@@ -92,5 +105,5 @@ declare function buildStyleguide(config: StyleguideConfiguration): Promise<Style
  */
 declare function watchStyleguide(config: StyleguideConfiguration, onChange?: () => void, onError?: (errorData: StyleguideBuildOutput['errors']) => void): Promise<void>;
 
-export { buildStyleguide, watchStyleguide };
+export { buildStyleguide, parseStyleguide, watchStyleguide };
 export type { StyleguideConfiguration };

package/dist/node/lib/index.mjs

@@ -726,7 +726,7 @@ function extractMarkdownPath(input) {
   }
   return path2;
 }
-async function parse(input, config) {
+async function parse(input, contentDir) {
   const data = kssParser(input).sections.filter((section) => Boolean(section.reference));
   const overwrittenSectionsIds = [];
   const sortedData = data.sort((a, b) => {
@@ -744,7 +744,7 @@ async function parse(input, config) {
       };
     }
     return {
-      description: await parseMarkdown({ filePath: path.join(config.contentDir, markdownPath), rootHeadingLevel }),
+      description: await parseMarkdown({ filePath: path.join(contentDir, markdownPath), rootHeadingLevel }),
       hasMarkdownDescription: true
     };
   }
@@ -755,7 +755,7 @@ async function parse(input, config) {
     const isHtmlFilePath = trimmedMarkup.endsWith(".html") && !trimmedMarkup.includes("<") && !trimmedMarkup.includes("\n");
     if (isHtmlFilePath) {
       sourceMarkup = {
-        file: path.join(config.contentDir, trimmedMarkup)
+        file: path.join(contentDir, trimmedMarkup)
       };
     } else if (section.markup.includes('<insert-vite-pug src="')) {
       const regexModifierLine = /<insert-vite-pug src="(.+?)".*(?:[\n\r\u2028\u2029]\s*)?(modifierClass="(.+?)")? *><\/insert-vite-pug>/g;
@@ -767,7 +767,7 @@ async function parse(input, config) {
         if (!pugSourcePath || !pugSourcePath.endsWith(".pug")) {
           throw new Error("No or invalid Pug source path found");
         }
-        pugSourcePath = path.join(config.contentDir, pugSourcePath);
+        pugSourcePath = path.join(contentDir, pugSourcePath);
         sourceMarkup = {
           file: pugSourcePath
         };
@@ -2094,18 +2094,21 @@ function watchStyleguideForChanges(path, callback) {
   );
 }
 
-async function buildStyleguide(config) {
-  const styleguideContentPaths = await glob(`${config.contentDir}/**/*.{css,scss}`);
+async function parseStyleguide(contentDir) {
+  const styleguideContentPaths = await glob(`${contentDir}/**/*.{css,scss}`);
   const styleguideContent = await Promise.all(
     styleguideContentPaths.map(async (filePath) => ({
       path: filePath,
       contents: await fs.readFile(filePath, "utf-8")
     }))
   );
-  const rawParsedOutput = await parse(styleguideContent, config);
+  const rawParsedOutput = await parse(styleguideContent, contentDir);
   if (!rawParsedOutput)
     throw new Error("Could not parse content");
-  const { content: parsedContent, overwrittenSectionsIds } = rawParsedOutput;
+  return rawParsedOutput;
+}
+async function buildStyleguide(config) {
+  const { content: parsedContent, overwrittenSectionsIds } = await parseStyleguide(config.contentDir);
   if (config.mode === "production" && await fs.exists(config.outDir)) {
     const files = await glob(`${config.outDir}/**/*.html`);
     await Promise.all(files.map((file) => fs.unlink(file)));
@@ -2321,4 +2324,4 @@ async function watchStyleguide(config, onChange, onError) {
   });
 }
 
-export { buildStyleguide, watchStyleguide };
+export { buildStyleguide, parseStyleguide, watchStyleguide };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kss-modern",
   "type": "module",
-  "version": "0.0.41",
+  "version": "0.0.42",
   "description": "Modern KSS compatible styleguide generator",
   "repository": {
     "type": "git",