uniweb 0.2.9 → 0.2.10

package/README.md

@@ -46,7 +46,7 @@ my-project/
 
 ```markdown
 ---
-component: Hero
+type: Hero
 theme: dark
 ---
 
@@ -57,7 +57,7 @@ Build something great.
 [Get Started](#)
 ```
 
-Frontmatter specifies the component and configuration. The body contains the actual content—headings, paragraphs, links, images—which gets semantically parsed into structured data your component receives.
+Frontmatter specifies the component type and configuration. The body contains the actual content—headings, paragraphs, links, images—which gets semantically parsed into structured data your component receives.
 
 ### Beyond Markdown
 
@@ -459,7 +459,7 @@ Pages can define data sources that auto-generate subroutes. A `/blog` page can h
 ## Related Packages
 
 - [`@uniweb/build`](https://github.com/uniweb/build) — Foundation build tooling
-- [`@uniweb/runtime`](https://github.com/uniweb/runtime) — Runtime loader for sites
+- [`@uniweb/runtime`](https://github.com/uniweb/runtime) — Foundation loader and orchestrator for sites
 - [`@uniweb/templates`](https://github.com/uniweb/templates) — Official templates and template processing
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -34,6 +34,6 @@
     "@uniweb/build": "^0.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/templates": "0.1.5"
+    "@uniweb/templates": "0.1.6"
   }
 }

package/src/commands/build.js

@@ -7,6 +7,7 @@
  *   uniweb build                    # Build current directory
  *   uniweb build --target foundation # Explicitly build as foundation
  *   uniweb build --target site       # Explicitly build as site
+ *   uniweb build --prerender         # Build site + pre-render to static HTML (SSG)
  */
 
 import { existsSync } from 'node:fs'
@@ -181,12 +182,47 @@ async function buildFoundation(projectDir, options = {}) {
  * Build a site
  */
 async function buildSite(projectDir, options = {}) {
+  const { prerender = false, foundationDir } = options
+
   info('Building site...')
 
-  // Just run vite build for sites
+  // Run vite build for sites
   await runCommand('npx', ['vite', 'build'], projectDir)
 
   success('Site build complete')
+
+  // Pre-render if requested
+  if (prerender) {
+    log('')
+    info('Pre-rendering pages to static HTML (SSG)...')
+
+    try {
+      const { prerenderSite } = await import('@uniweb/build/prerender')
+
+      const result = await prerenderSite(projectDir, {
+        foundationDir: foundationDir || join(projectDir, '..', 'foundation'),
+        onProgress: (msg) => log(`  ${colors.dim}${msg}${colors.reset}`)
+      })
+
+      success(`Pre-rendered ${result.pages} page${result.pages !== 1 ? 's' : ''} to static HTML`)
+
+      // Summary
+      log('')
+      log(`${colors.green}${colors.bright}SSG Build complete!${colors.reset}`)
+      log('')
+      log(`Output:`)
+      for (const file of result.files) {
+        const relativePath = file.replace(projectDir + '/', '')
+        log(`  ${colors.dim}${relativePath}${colors.reset}`)
+      }
+    } catch (err) {
+      error(`Pre-rendering failed: ${err.message}`)
+      if (process.env.DEBUG) {
+        console.error(err.stack)
+      }
+      process.exit(1)
+    }
+  }
 }
 
 /**
@@ -207,6 +243,16 @@ export async function build(args = []) {
     }
   }
 
+  // Check for --prerender flag (SSG)
+  const prerender = args.includes('--prerender')
+
+  // Check for --foundation-dir flag (for prerendering)
+  let foundationDir = null
+  const foundationDirIndex = args.indexOf('--foundation-dir')
+  if (foundationDirIndex !== -1 && args[foundationDirIndex + 1]) {
+    foundationDir = resolve(args[foundationDirIndex + 1])
+  }
+
   // Auto-detect project type if not specified
   if (!targetType) {
     targetType = detectProjectType(projectDir)
@@ -220,12 +266,18 @@ export async function build(args = []) {
     info(`Detected project type: ${targetType}`)
   }
 
+  // Validate prerender is only used with site target
+  if (prerender && targetType !== 'site') {
+    error('--prerender can only be used with site builds')
+    process.exit(1)
+  }
+
   // Run appropriate build
   try {
     if (targetType === 'foundation') {
       await buildFoundation(projectDir)
     } else {
-      await buildSite(projectDir)
+      await buildSite(projectDir, { prerender, foundationDir })
     }
   } catch (err) {
     error(err.message)

package/src/index.js

@@ -226,6 +226,8 @@ ${colors.bright}Create Options:${colors.reset}
 
 ${colors.bright}Build Options:${colors.reset}
   --target <type>    Build target (foundation, site) - auto-detected if not specified
+  --prerender        Pre-render pages to static HTML (SSG) - site builds only
+  --foundation-dir   Path to foundation directory (for prerendering)
   --platform <name>  Deployment platform (e.g., vercel) for platform-specific output
 
 ${colors.bright}Template Types:${colors.reset}
@@ -243,6 +245,7 @@ ${colors.bright}Examples:${colors.reset}
   npx uniweb create my-project --template github:myorg/template
   npx uniweb build
   npx uniweb build --target foundation
+  npx uniweb build --prerender                         # Build site + pre-render to static HTML
 `)
 }
 
@@ -384,7 +387,7 @@ Each markdown file specifies which component to use:
 
 \`\`\`markdown
 ---
-component: Hero
+type: Hero
 theme: dark
 ---
 
@@ -601,13 +604,14 @@ async function createSite(projectDir, projectName, isWorkspace = false) {
       ...(isWorkspace ? {} : { 'foundation-example': '^0.1.0' }),
     },
     devDependencies: {
+      '@uniweb/build': '^0.1.3',
       '@vitejs/plugin-react': '^5.0.0',
       autoprefixer: '^10.4.18',
       'js-yaml': '^4.1.0',
       postcss: '^8.4.35',
       react: '^18.2.0',
       'react-dom': '^18.2.0',
-      'react-router-dom': '^6.22.0',
+      'react-router-dom': '^7.0.0',
       tailwindcss: '^3.4.1',
       vite: '^7.0.0',
       'vite-plugin-svgr': '^4.2.0',
@@ -659,7 +663,8 @@ import { readFileSync, existsSync } from 'fs'
 import yaml from 'js-yaml'
 import react from '@vitejs/plugin-react'
 import svgr from 'vite-plugin-svgr'
-import { siteContentPlugin, foundationPlugin } from '@uniweb/runtime/vite'
+import { siteContentPlugin } from '@uniweb/build/site'
+import { foundationDevPlugin } from '@uniweb/build/dev'
 
 // Read foundation from site.yml
 const siteConfig = yaml.load(readFileSync('./site.yml', 'utf8'))
@@ -685,7 +690,7 @@ export default defineConfig({
       sitePath: './',
       inject: true,
     }),
-    useRuntimeLoading && foundationPlugin({
+    useRuntimeLoading && foundationDevPlugin({
       name: foundation,
       path: foundationPath,
       serve: '/foundation',
@@ -724,7 +729,7 @@ export default defineConfig({
 `)
 
   // main.jsx - uses #foundation alias (configured in vite.config.js from site.yml)
-  writeFile(join(projectDir, 'src/main.jsx'), `import { initRuntime } from '@uniweb/runtime'
+  writeFile(join(projectDir, 'src/main.jsx'), `import initRuntime from '@uniweb/runtime'
 
 const useRuntimeLoading = import.meta.env.VITE_FOUNDATION_MODE === 'runtime'
 
@@ -760,7 +765,7 @@ order: 1
 
   // pages/home/1-hero.md
   writeFile(join(projectDir, 'pages/home/1-hero.md'), `---
-component: Hero
+type: Hero
 theme: dark
 ---
 
@@ -815,7 +820,7 @@ order: 2
 
 \`\`\`markdown
 ---
-component: Hero
+type: Hero
 theme: dark
 ---