@knowcode/doc-builder 1.4.2 → 1.4.3

package/package/scripts/setup.js

@@ -0,0 +1,56 @@
+/**
+ * Post-install setup script for @knowcode/doc-builder
+ * This script runs after npm install to help users get started
+ */
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+
+// Check if we're in the doc-builder package itself (skip setup)
+const packagePath = path.join(process.cwd(), 'package.json');
+if (fs.existsSync(packagePath)) {
+  const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+  if (pkg.name === '@knowcode/doc-builder') {
+    // We're in the doc-builder package itself, skip setup
+    process.exit(0);
+  }
+}
+
+console.log(chalk.cyan('\n🚀 Welcome to @knowcode/doc-builder!\n'));
+
+console.log('You can use doc-builder in several ways:\n');
+
+console.log(chalk.yellow('1. Using npx (no installation required):'));
+console.log('   npx @knowcode/doc-builder build');
+console.log('   npx @knowcode/doc-builder dev');
+console.log('   npx @knowcode/doc-builder deploy\n');
+
+console.log(chalk.yellow('2. After installing as a dependency:'));
+console.log('   doc-builder build');
+console.log('   doc-builder dev');
+console.log('   doc-builder deploy\n');
+
+console.log(chalk.yellow('3. In your package.json scripts:'));
+console.log(chalk.gray('   "scripts": {'));
+console.log(chalk.gray('     "docs:build": "doc-builder build",'));
+console.log(chalk.gray('     "docs:dev": "doc-builder dev",'));
+console.log(chalk.gray('     "docs:deploy": "doc-builder deploy --prod"'));
+console.log(chalk.gray('   }\n'));
+
+console.log(chalk.yellow('4. Programmatically in your code:'));
+console.log(chalk.gray('   const { build } = require("@knowcode/doc-builder");'));
+console.log(chalk.gray('   await build();\n'));
+
+// Check for common doc directories
+const commonDirs = ['docs', 'documentation', 'doc'];
+const foundDir = commonDirs.find(dir => fs.existsSync(path.join(process.cwd(), dir)));
+
+if (foundDir) {
+  console.log(chalk.green(`✅ Found ${foundDir}/ directory - doc-builder will use this by default\n`));
+} else {
+  console.log(chalk.yellow(`ℹ️  No docs directory found. Create a 'docs' folder with markdown files to get started.\n`));
+}
+
+console.log(chalk.gray('For more information, visit: https://github.com/knowcode/doc-builder'));
+console.log(chalk.gray('To create a config file, run: doc-builder init --config\n'));

package/package/test-cache-bust.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+
+echo "🧹 Cache Busting Test for doc-builder"
+echo "===================================="
+
+# Step 1: Clean everything
+echo "1. Removing old build artifacts..."
+rm -rf html/
+rm -rf node_modules/
+rm -rf .cache/
+
+# Step 2: Clear npm cache
+echo "2. Clearing npm cache..."
+npm cache clean --force
+
+# Step 3: Install latest version
+echo "3. Installing latest doc-builder..."
+npm install @knowcode/doc-builder@latest
+
+# Step 4: Show version
+echo "4. Installed version:"
+npm list @knowcode/doc-builder
+
+# Step 5: Build fresh
+echo "5. Building documentation..."
+npx @knowcode/doc-builder build
+
+# Step 6: Check CSS content
+echo "6. Checking if CSS has latest changes..."
+echo "   Looking for 'margin: 0; /* Left aligned'..."
+grep -n "margin: 0; /\* Left aligned" html/css/notion-style.css || echo "NOT FOUND!"
+
+echo "   Looking for 'position: fixed; /* Use fixed'..."
+grep -n "position: fixed; /\* Use fixed" html/css/notion-style.css || echo "NOT FOUND!"
+
+echo ""
+echo "✅ If you see the CSS changes above, the package is working correctly!"
+echo "🚨 If not found, there's a build issue we need to investigate."
+echo ""
+echo "Next steps:"
+echo "1. Deploy with: vercel --prod --force"
+echo "2. Open in incognito/private browsing"
+echo "3. Hard refresh: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)"

package/package.json

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