uniweb 0.2.41 → 0.2.42

package/README.md

@@ -18,6 +18,9 @@ The `marketing` template includes real components (Hero, Features, Pricing, Test
 **Other templates:**
 
 ```bash
+# Multilingual business site (English, Spanish, French)
+npx uniweb@latest create my-site --template international
+
 # Academic site (researcher portfolios, lab pages)
 npx uniweb@latest create my-site --template academic
 
@@ -371,6 +374,31 @@ uniweb create my-site --template docs
 
 Perfect for technical documentation, guides, and API references.
 
+### International
+
+```bash
+uniweb create my-site --template international
+```
+
+**Includes:** Hero, Features, Team, CTA, Header (with language switcher), Footer (with language links)
+
+**Languages:** English (default), Spanish, French
+
+A multilingual business site demonstrating Uniweb's i18n capabilities. Includes pre-configured translation files and a complete localization workflow:
+
+```bash
+# Extract translatable strings
+uniweb i18n extract
+
+# Check translation coverage
+uniweb i18n status
+
+# Build generates locale-specific output (dist/es/, dist/fr/)
+uniweb build
+```
+
+Perfect for international businesses and learning the i18n workflow.
+
 ## External Templates
 
 Use templates from npm or GitHub:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.2.41",
+  "version": "0.2.42",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -37,7 +37,7 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/build": "0.1.22",
+    "@uniweb/build": "0.1.23",
     "@uniweb/core": "0.1.10",
     "@uniweb/kit": "0.1.5",
     "@uniweb/runtime": "0.2.11"

package/partials/{claude-md.hbs → agents-md.hbs}

@@ -1,4 +1,4 @@
-# CLAUDE.md
+# AGENTS.md
 
 This file provides guidance for AI assistants working with this Uniweb project.
 

package/partials/ai-assistance.hbs

@@ -1,3 +1,3 @@
 ## AI Assistance
 
-See [CLAUDE.md](./CLAUDE.md) for detailed instructions that AI assistants can use.
+See [AGENTS.md](./AGENTS.md) for detailed instructions that AI assistants can use.

package/partials/components-docs.hbs

@@ -3,13 +3,11 @@
 Generate up-to-date documentation for all foundation components:
 
 ```bash
-# From within the foundation directory
-pnpm docs
-```
+# From foundation directory
+pnpm uniweb docs
 
-This creates `COMPONENTS.md` with full details on each component's:
-- Content elements (title, paragraphs, links, images, items)
-- Parameters (theme, layout, columns, etc.)
-- Presets (pre-configured parameter combinations)
+# Or from site directory (auto-detects linked foundation)
+cd site && pnpm uniweb docs
+```
 
-The documentation is generated from component `meta.js` files, so it's always current.
+This creates `COMPONENTS.md` with details on each component's parameters, presets, and content elements. The documentation is generated from component `meta.js` files, so it's always current.

package/src/commands/docs.js

@@ -7,10 +7,14 @@
  *   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)
+ *
+ * When run from a site directory, automatically finds and documents the
+ * linked foundation, placing COMPONENTS.md in the site folder.
  */
 
 import { existsSync } from 'node:fs'
-import { resolve, join } from 'node:path'
+import { readFile } from 'node:fs/promises'
+import { resolve, join, dirname } from 'node:path'
 import { generateDocs } from '@uniweb/build'
 
 // Colors for terminal output
@@ -72,7 +76,7 @@ function showHelp() {
 ${colors.bright}uniweb docs${colors.reset} - Generate component documentation
 
 ${colors.dim}Usage:${colors.reset}
-  uniweb docs                         Generate COMPONENTS.md from schema.json
+  uniweb docs                         Generate COMPONENTS.md
   uniweb docs --output DOCS.md        Custom output filename
   uniweb docs --from-source           Build schema from source (no build required)
 
@@ -82,8 +86,9 @@ ${colors.dim}Options:${colors.reset}
   -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.
+  Run from a foundation directory to generate docs there.
+  Run from a site directory to auto-detect the linked foundation
+  and generate docs in the site folder for convenience.
 `)
 }
 
@@ -96,6 +101,47 @@ function isFoundation(dir) {
   return existsSync(componentsDir)
 }
 
+/**
+ * Detect if current directory is a site
+ */
+function isSite(dir) {
+  return existsSync(join(dir, 'site.yml')) || existsSync(join(dir, 'site.yaml'))
+}
+
+/**
+ * Resolve foundation path from a site directory
+ * Reads package.json to find foundation dependency with file: protocol
+ */
+async function resolveFoundationFromSite(siteDir) {
+  const pkgPath = join(siteDir, 'package.json')
+  if (!existsSync(pkgPath)) {
+    return null
+  }
+
+  try {
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'))
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies }
+
+    // Look for foundation dependency with file: protocol
+    // Common names: "foundation", or the foundation name from site.yml
+    for (const [name, version] of Object.entries(deps)) {
+      if (typeof version === 'string' && version.startsWith('file:')) {
+        const relativePath = version.slice(5) // Remove 'file:' prefix
+        const absolutePath = resolve(siteDir, relativePath)
+
+        // Check if this is actually a foundation
+        if (isFoundation(absolutePath)) {
+          return { name, path: absolutePath }
+        }
+      }
+    }
+  } catch {
+    // Ignore parse errors
+  }
+
+  return null
+}
+
 /**
  * Main docs command
  */
@@ -108,19 +154,34 @@ export async function docs(args) {
   }
 
   const projectDir = resolve(process.cwd())
+  let foundationDir = projectDir
+  let outputDir = projectDir
+
+  // Check if we're in a site directory
+  if (isSite(projectDir)) {
+    const foundation = await resolveFoundationFromSite(projectDir)
+    if (!foundation) {
+      error('Could not find a linked foundation in this site.')
+      log(`${colors.dim}Make sure package.json has a foundation dependency like:${colors.reset}`)
+      log(`${colors.dim}  "foundation": "file:../foundation"${colors.reset}`)
+      process.exit(1)
+    }
 
-  // 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}`)
+    foundationDir = foundation.path
+    outputDir = projectDir
+    info(`Found foundation: ${foundation.name} (${foundation.path})`)
+  } else if (!isFoundation(projectDir)) {
+    error('This directory does not appear to be a foundation or site.')
+    log(`${colors.dim}Foundations have a src/components/ directory.${colors.reset}`)
+    log(`${colors.dim}Sites have a site.yml file.${colors.reset}`)
     process.exit(1)
   }
 
   // Check if schema.json exists (if not using --from-source)
-  const schemaPath = join(projectDir, 'dist', 'schema.json')
+  const schemaPath = join(foundationDir, '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(`${colors.yellow}⚠${colors.reset} No dist/schema.json found in foundation.`)
+    log(`${colors.dim}Run 'uniweb build' in the foundation first, or use '--from-source'.${colors.reset}`)
     log('')
     info('Falling back to --from-source mode')
     options.fromSource = true
@@ -129,8 +190,8 @@ export async function docs(args) {
   try {
     info('Generating documentation...')
 
-    const result = await generateDocs(projectDir, {
-      output: options.output,
+    const result = await generateDocs(foundationDir, {
+      output: join(outputDir, options.output),
       fromSource: options.fromSource,
     })
 

package/src/templates/resolver.js

@@ -6,7 +6,7 @@
 export const BUILTIN_TEMPLATES = ['single', 'multi', 'template']
 
 // Official templates from @uniweb/templates package (downloaded from GitHub releases)
-export const OFFICIAL_TEMPLATES = ['marketing', 'academic', 'docs']
+export const OFFICIAL_TEMPLATES = ['marketing', 'academic', 'docs', 'international']
 
 /**
  * Parse a template identifier and determine its source type

package/templates/_shared/AGENTS.md.hbs

@@ -0,0 +1 @@
+{{> agents-md}}

package/templates/multi/AGENTS.md.hbs

@@ -0,0 +1 @@
+{{> agents-md}}

package/templates/multi/README.md.hbs

@@ -22,7 +22,7 @@ A multi-site workspace built with [Uniweb](https://github.com/uniweb/cli) — a
 │       ├── main.js
 │       └── vite.config.js
 │
-├── CLAUDE.md            # AI assistant instructions
+├── AGENTS.md            # AI assistant instructions
 └── README.md            # This file
 ```
 

package/templates/multi/foundations/default/package.json.hbs

@@ -14,8 +14,7 @@
     "dev": "vite",
     "build": "uniweb build",
     "build:vite": "vite build",
-    "preview": "vite preview",
-    "docs": "uniweb docs"
+    "preview": "vite preview"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/templates/single/README.md.hbs

@@ -22,7 +22,7 @@ A website built with [Uniweb](https://github.com/uniweb/cli) — a component web
 │   ├── site.yml         # Site configuration
 │   └── vite.config.js   # defineSiteConfig()
 │
-└── CLAUDE.md            # AI assistant instructions
+└── AGENTS.md            # AI assistant instructions
 ```
 
 ## Content Authoring

package/templates/single/foundation/package.json.hbs

@@ -14,8 +14,7 @@
     "dev": "vite",
     "build": "uniweb build",
     "build:vite": "vite build",
-    "preview": "vite preview",
-    "docs": "uniweb docs"
+    "preview": "vite preview"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/templates/single/template.json

@@ -3,7 +3,7 @@
   "description": "A minimal Uniweb project with one foundation and one site. The canonical starting point for any Uniweb project.",
   "base": "_shared",
   "structure": {
-    "root": ["package.json.hbs", "pnpm-workspace.yaml", ".gitignore", "CLAUDE.md.hbs"],
+    "root": ["package.json.hbs", "pnpm-workspace.yaml", ".gitignore", "AGENTS.md.hbs"],
     "foundation": ["package.json.hbs", "vite.config.js", ".gitignore", "src/"],
     "site": ["package.json.hbs", "vite.config.js", "index.html.hbs", "site.yml.hbs", "src/", "pages/"]
   }

package/templates/template/template/{CLAUDE.md.hbs → AGENTS.md.hbs}

@@ -1,4 +1,4 @@
-# CLAUDE.md - AI Assistant Instructions
+# AGENTS.md - AI Assistant Instructions
 
 This file provides guidance for AI assistants working with this Uniweb template project.
 

package/templates/_shared/CLAUDE.md.hbs

@@ -1 +0,0 @@
-{{> claude-md}}

package/templates/multi/CLAUDE.md.hbs

@@ -1 +0,0 @@
-{{> claude-md}}