uniweb 0.2.12 → 0.2.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -34,6 +34,6 @@
     "handlebars": "^4.7.8",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/build": "0.1.4"
+    "@uniweb/build": "0.1.5"
   }
 }

package/src/commands/docs.js

@@ -0,0 +1,143 @@
+/**
+ * Docs Command
+ *
+ * Generates markdown documentation from foundation schema.
+ *
+ * Usage:
+ *   uniweb docs                    # Generate docs for current directory
+ *   uniweb docs --output README.md # Custom output filename
+ *   uniweb docs --from-source      # Build schema from source (no build required)
+ */
+
+import { existsSync } from 'node:fs'
+import { resolve, join } from 'node:path'
+import { generateDocs } from '@uniweb/build'
+
+// Colors for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+}
+
+function log(message) {
+  console.log(message)
+}
+
+function success(message) {
+  console.log(`${colors.green}✓${colors.reset} ${message}`)
+}
+
+function error(message) {
+  console.error(`${colors.red}✗${colors.reset} ${message}`)
+}
+
+function info(message) {
+  console.log(`${colors.cyan}→${colors.reset} ${message}`)
+}
+
+/**
+ * Parse command line arguments
+ */
+function parseArgs(args) {
+  const options = {
+    output: 'COMPONENTS.md',
+    fromSource: false,
+  }
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+
+    if (arg === '--output' || arg === '-o') {
+      options.output = args[++i]
+    } else if (arg === '--from-source' || arg === '-s') {
+      options.fromSource = true
+    } else if (arg === '--help' || arg === '-h') {
+      options.help = true
+    }
+  }
+
+  return options
+}
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  log(`
+${colors.bright}uniweb docs${colors.reset} - Generate component documentation
+
+${colors.dim}Usage:${colors.reset}
+  uniweb docs                         Generate COMPONENTS.md from schema.json
+  uniweb docs --output DOCS.md        Custom output filename
+  uniweb docs --from-source           Build schema from source (no build required)
+
+${colors.dim}Options:${colors.reset}
+  -o, --output <file>    Output filename (default: COMPONENTS.md)
+  -s, --from-source      Read meta.js files directly instead of schema.json
+  -h, --help             Show this help message
+
+${colors.dim}Notes:${colors.reset}
+  By default, docs are generated from dist/schema.json (requires build).
+  Use --from-source to generate without building first.
+`)
+}
+
+/**
+ * Detect if current directory is a foundation
+ */
+function isFoundation(dir) {
+  const srcDir = join(dir, 'src')
+  const componentsDir = join(srcDir, 'components')
+  return existsSync(componentsDir)
+}
+
+/**
+ * Main docs command
+ */
+export async function docs(args) {
+  const options = parseArgs(args)
+
+  if (options.help) {
+    showHelp()
+    return
+  }
+
+  const projectDir = resolve(process.cwd())
+
+  // Verify this is a foundation
+  if (!isFoundation(projectDir)) {
+    error('This directory does not appear to be a foundation.')
+    log(`${colors.dim}Foundations have a src/components/ directory with component folders.${colors.reset}`)
+    process.exit(1)
+  }
+
+  // Check if schema.json exists (if not using --from-source)
+  const schemaPath = join(projectDir, 'dist', 'schema.json')
+  if (!options.fromSource && !existsSync(schemaPath)) {
+    log(`${colors.yellow}⚠${colors.reset} No dist/schema.json found.`)
+    log(`${colors.dim}Run 'uniweb build' first, or use '--from-source' to read meta.js files directly.${colors.reset}`)
+    log('')
+    info('Falling back to --from-source mode')
+    options.fromSource = true
+  }
+
+  try {
+    info('Generating documentation...')
+
+    const result = await generateDocs(projectDir, {
+      output: options.output,
+      fromSource: options.fromSource,
+    })
+
+    success(`Generated ${result.outputPath}`)
+    log(`${colors.dim}Documented ${result.componentCount} components${colors.reset}`)
+  } catch (err) {
+    error(`Failed to generate docs: ${err.message}`)
+    process.exit(1)
+  }
+}

package/src/index.js

@@ -3,14 +3,13 @@
 /**
  * Uniweb CLI
  *
- * Scaffolds new Uniweb sites and foundations, and builds projects.
+ * Scaffolds new Uniweb sites and foundations, builds projects, and generates docs.
  *
  * Usage:
  *   npx uniweb create [project-name]
- *   npx uniweb create --template single      # site/ + foundation/ (default)
- *   npx uniweb create --template multi       # sites/* + foundations/*
+ *   npx uniweb create --template marketing
  *   npx uniweb build
- *   npx uniweb build --target foundation
+ *   npx uniweb docs                          # Generate COMPONENTS.md from schema
  */
 
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs'
@@ -18,6 +17,7 @@ import { resolve, join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import prompts from 'prompts'
 import { build } from './commands/build.js'
+import { docs } from './commands/docs.js'
 import { getVersionsForTemplates, getVersion } from './versions.js'
 import {
   resolveTemplate,
@@ -84,6 +84,12 @@ async function main() {
     return
   }
 
+  // Handle docs command
+  if (command === 'docs') {
+    await docs(args.slice(1))
+    return
+  }
+
   // Handle create command
   if (command !== 'create') {
     error(`Unknown command: ${command}`)
@@ -239,6 +245,7 @@ ${colors.bright}Usage:${colors.reset}
 ${colors.bright}Commands:${colors.reset}
   create [name]      Create a new project
   build              Build the current project
+  docs               Generate component documentation
 
 ${colors.bright}Create Options:${colors.reset}
   --template <type>  Project template
@@ -251,6 +258,10 @@ ${colors.bright}Build Options:${colors.reset}
   --foundation-dir   Path to foundation directory (for prerendering)
   --platform <name>  Deployment platform (e.g., vercel) for platform-specific output
 
+${colors.bright}Docs Options:${colors.reset}
+  --output <file>    Output filename (default: COMPONENTS.md)
+  --from-source      Read meta.js files directly instead of schema.json
+
 ${colors.bright}Template Types:${colors.reset}
   single                        One site + one foundation (default)
   multi                         Multiple sites and foundations
@@ -268,6 +279,7 @@ ${colors.bright}Examples:${colors.reset}
   npx uniweb build
   npx uniweb build --target foundation
   npx uniweb build --prerender                         # Build site + pre-render to static HTML
+  cd foundation && npx uniweb docs                     # Generate COMPONENTS.md
 `)
 }
 

package/src/versions.js

@@ -72,6 +72,9 @@ export function getResolvedVersions() {
     '@uniweb/runtime': '^0.1.0',
     '@uniweb/core': '^0.1.0',
 
+    // Foundation utility library (used by official templates)
+    '@uniweb/kit': '^0.1.0',
+
     // CLI itself (use current version)
     'uniweb': `^${pkg.version}`,
   }
@@ -106,6 +109,7 @@ export function getVersionsForTemplates() {
     build: versions['@uniweb/build'],
     runtime: versions['@uniweb/runtime'],
     core: versions['@uniweb/core'],
+    kit: versions['@uniweb/kit'],
     templates: versions['@uniweb/templates'],
     cli: versions['uniweb'],
   }