@knowcode/doc-builder 1.9.24 → 1.9.26

package/lib/core-builder.js

@@ -64,6 +64,19 @@ function escapeHtml(text) {
   return text.replace(/[&<>"']/g, m => map[m]);
 }
 
+// Helper function to check if filename contains non-printable characters
+function hasNonPrintableChars(filename) {
+  // Check for non-printable ASCII characters (0x00-0x1F, 0x7F-0x9F)
+  // Exclude common allowed control chars like tab (0x09), newline (0x0A), carriage return (0x0D)
+  return /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x9F]/.test(filename);
+}
+
+// Helper function to sanitize filename for safe processing
+function sanitizeFilename(filename) {
+  // Remove non-printable characters
+  return filename.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F-\x9F]/g, '');
+}
+
 // Helper function to smartly capitalize text while preserving existing capitalization
 function smartCapitalize(text) {
   if (!text) return text;
@@ -1121,6 +1134,12 @@ async function getAllMarkdownFiles(dir, baseDir = dir, options = {}) {
   const items = await fs.readdir(dir);
   
   for (const item of items) {
+    // Skip files with non-printable characters in their names
+    if (hasNonPrintableChars(item)) {
+      console.log(chalk.yellow(`⚠️  Skipping file with non-printable characters: ${sanitizeFilename(item)}`));
+      continue;
+    }
+    
     const fullPath = path.join(dir, item);
     const stat = await fs.stat(fullPath);
     
@@ -1183,6 +1202,12 @@ async function getAllAttachmentFiles(dir, baseDir = dir, attachmentTypes) {
   const items = await fs.readdir(dir);
   
   for (const item of items) {
+    // Skip files with non-printable characters in their names
+    if (hasNonPrintableChars(item)) {
+      console.log(chalk.yellow(`⚠️  Skipping attachment with non-printable characters: ${sanitizeFilename(item)}`));
+      continue;
+    }
+    
     const fullPath = path.join(dir, item);
     const stat = await fs.stat(fullPath);
     
@@ -1307,7 +1332,8 @@ async function buildDocumentation(config) {
   
   // List all HTML files in output directory
   if (fs.existsSync(outputDir)) {
-    const htmlFiles = fs.readdirSync(outputDir).filter(f => f.endsWith('.html'));
+    const htmlFiles = fs.readdirSync(outputDir)
+      .filter(f => !hasNonPrintableChars(f) && f.endsWith('.html'));
     console.log(chalk.gray(`  - HTML files in output: [${htmlFiles.join(', ')}]`));
   } else {
     console.log(chalk.red(`  - ERROR: Output directory does not exist!`));
@@ -1398,6 +1424,10 @@ async function buildDocumentation(config) {
     const walkDir = (dir, baseDir = '') => {
       const items = fs.readdirSync(dir);
       items.forEach(item => {
+        // Skip files with non-printable characters
+        if (hasNonPrintableChars(item)) {
+          return;
+        }
         const fullPath = path.join(dir, item);
         const stat = fs.statSync(fullPath);
         if (stat.isDirectory()) {
@@ -1548,6 +1578,10 @@ async function buildDocumentation(config) {
       const walkDir = (dir, baseDir = '') => {
         const items = fs.readdirSync(dir);
         items.forEach(item => {
+          // Skip files with non-printable characters
+          if (hasNonPrintableChars(item)) {
+            return;
+          }
           const fullPath = path.join(dir, item);
           const stat = fs.statSync(fullPath);
           if (stat.isDirectory()) {
@@ -1737,6 +1771,10 @@ async function createDefaultIndexPage(outputDir, config, version) {
   async function findHtmlFiles(dir, baseDir = dir) {
     const items = await fs.readdir(dir);
     for (const item of items) {
+      // Skip files with non-printable characters
+      if (hasNonPrintableChars(item)) {
+        continue;
+      }
       const fullPath = path.join(dir, item);
       const stat = await fs.stat(fullPath);
       if (stat.isDirectory() && !item.startsWith('.')) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.9.24",
+  "version": "1.9.26",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {