uniweb 0.2.32 → 0.2.34

package/README.md

@@ -324,7 +324,7 @@ my-project/
     └── src/
         ├── styles.css        # Tailwind CSS v4
         ├── meta.js           # Foundation metadata
-        ├── runtime.js        # (optional) Custom Layout, props
+        ├── exports.js        # (optional) Custom Layout, props
         └── components/
             └── Section/
                 ├── index.jsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.2.32",
+  "version": "0.2.34",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -36,9 +36,9 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/build": "0.1.15",
-    "@uniweb/runtime": "0.2.8",
-    "@uniweb/core": "0.1.7",
-    "@uniweb/kit": "0.1.4"
+    "@uniweb/build": "0.1.19",
+    "@uniweb/core": "0.1.8",
+    "@uniweb/kit": "0.1.4",
+    "@uniweb/runtime": "0.2.10"
   }
 }

package/src/commands/build.js

@@ -279,6 +279,46 @@ async function generateLocalizedHtml(projectDir, i18nConfig) {
   }
 }
 
+/**
+ * Resolve foundation directory based on site config and project structure
+ *
+ * For single projects: ../foundation
+ * For multi projects: ../../foundations/{name}
+ */
+function resolveFoundationDir(projectDir, siteConfig) {
+  const foundationName = siteConfig?.foundation
+
+  // Check if we're in a multi-site structure (site is under sites/)
+  const parentDir = join(projectDir, '..')
+  const grandParentDir = join(projectDir, '..', '..')
+  const isMultiSite = parentDir.endsWith('/sites') || parentDir.endsWith('\\sites')
+
+  if (isMultiSite && foundationName) {
+    // Multi-site: look for foundations/{name}
+    const multiFoundationDir = join(grandParentDir, 'foundations', foundationName)
+    if (existsSync(multiFoundationDir)) {
+      return multiFoundationDir
+    }
+  }
+
+  // Single site: ../foundation
+  const singleFoundationDir = join(projectDir, '..', 'foundation')
+  if (existsSync(singleFoundationDir)) {
+    return singleFoundationDir
+  }
+
+  // Fallback: try to find by foundation name in parent
+  if (foundationName) {
+    const namedFoundationDir = join(parentDir, foundationName)
+    if (existsSync(namedFoundationDir)) {
+      return namedFoundationDir
+    }
+  }
+
+  // Ultimate fallback
+  return singleFoundationDir
+}
+
 /**
  * Build a site
  */
@@ -330,7 +370,7 @@ async function buildSite(projectDir, options = {}) {
       const { prerenderSite } = await import('@uniweb/build/prerender')
 
       const result = await prerenderSite(projectDir, {
-        foundationDir: foundationDir || join(projectDir, '..', 'foundation'),
+        foundationDir: foundationDir || resolveFoundationDir(projectDir, siteConfig),
         onProgress: (msg) => log(`  ${colors.dim}${msg}${colors.reset}`)
       })
 

package/src/templates/processor.js

@@ -58,7 +58,7 @@ export function clearMissingVersions() {
 function registerPartials() {
   if (partialsRegistered) return
 
-  const partialsDir = path.join(__dirname, '..', 'partials')
+  const partialsDir = path.join(__dirname, '..', '..', 'partials')
 
   if (!existsSync(partialsDir)) {
     partialsRegistered = true

package/templates/_shared/CLAUDE.md.hbs

@@ -1,148 +1 @@
-# CLAUDE.md - AI Assistant Instructions
-
-This file provides guidance for AI assistants working with this Uniweb project.
-
-## Project Overview
-
-This is a **Uniweb** project - a component web platform that separates content from code.
-
-```
-{{projectName}}/
-├── foundation/     # React component library (code)
-├── site/           # Content and pages (markdown)
-├── package.json    # Root workspace config
-└── pnpm-workspace.yaml
-```
-
-## Quick Commands
-
-```bash
-# Install dependencies
-pnpm install
-
-# Start development server (site with foundation)
-pnpm dev
-
-# Build foundation (generates dist/foundation.js and schema.json)
-cd foundation && pnpm build
-
-# Build site for production (outputs to site/dist/)
-cd site && pnpm build
-```
-
-## Key Files
-
-**Site:**
-- `site/vite.config.js` - 3-line config using `defineSiteConfig()` from `@uniweb/build/site`
-- `site/main.js` - Entry point using `start()` from `@uniweb/runtime`
-- `site/site.yml` - Site configuration (foundation path, title, i18n)
-- `site/pages/` - Content pages (file-based routing)
-
-**Foundation:**
-- `foundation/vite.config.js` - 3-line config using `defineFoundationConfig()` from `@uniweb/build`
-- `foundation/src/styles.css` - Tailwind CSS v4 theme
-- `foundation/src/components/*/meta.js` - Component metadata (makes component exposed)
-- `foundation/src/runtime.js` - (optional) Custom Layout and foundation props
-- `foundation/src/_entry.generated.js` - Auto-generated at build/dev time
-
-## Architecture
-
-### Foundation Package (`/foundation`)
-
-The **foundation** is a React component library. Components with a `meta.js` file are **exposed** (available to content creators via `type:` in frontmatter). Exposed components:
-
-1. Receive structured content parsed from markdown
-2. Have configurable parameters (theme, layout, etc.)
-3. Render content according to their design
-
-Internal components (no `meta.js`) are regular React components used within exposed components.
-
-**Key directories:**
-- `src/components/*/` - Component implementations
-- `src/components/*/meta.js` - Component metadata (makes component exposed)
-- `src/styles.css` - Global Tailwind styles
-
-### Site Package (`/site`)
-
-The **site** contains content written in markdown. The runtime loads the foundation and renders content based on component selections.
-
-**Key directories:**
-- `pages/` - Content pages organized in folders
-- `pages/[page-name]/page.yml` - Page metadata
-- `pages/[page-name]/*.md` - Content sections
-
-## Content Authoring
-
-### Section File Format
-
-```markdown
----
-type: ComponentName
-theme: dark
-layout: center
----
-
-# Main Headline
-
-Description paragraph.
-
-[Call to Action](#link)
-```
-
-### Content Structure
-
-The semantic parser extracts content into:
-
-- **`content.main.header`**: title, pretitle, subtitle
-- **`content.main.body`**: paragraphs, links, imgs, lists
-- **`content.items`**: Content groups from H3 headings
-
-## Component Development
-
-### Component Interface
-
-```jsx
-function MyComponent({ content, params, block, website }) {
-  const { title } = content.main?.header || {}
-  const { paragraphs = [] } = content.main?.body || {}
-  // ...
-}
-```
-
-### Using @uniweb/kit
-
-```jsx
-import { H1, P, Link, cn } from '@uniweb/kit'
-```
-
-### Component Metadata (`meta.js`)
-
-```javascript
-export default {
-  title: 'Component Name',
-  description: 'What the component does',
-  category: 'Content',
-  elements: { /* content elements */ },
-  properties: { /* configurable params */ },
-}
-```
-
-## Tailwind CSS v4
-
-This project uses Tailwind CSS v4 with the Vite plugin.
-
-**Theme customization** (`foundation/src/styles.css`):
-
-```css
-@import "tailwindcss";
-@source "./components/**/*.{js,jsx}";
-@theme {
-  --color-primary: #3b82f6;
-}
-```
-
-## Resources
-
-- [Uniweb Documentation](https://github.com/uniweb/uniweb)
-- [@uniweb/kit Documentation](https://www.npmjs.com/package/@uniweb/kit)
-- [Tailwind CSS v4](https://tailwindcss.com/docs)
+{{> claude-md}}

package/templates/multi/CLAUDE.md.hbs

@@ -1,100 +1 @@
-# CLAUDE.md - AI Assistant Instructions
-
-This file provides guidance for AI assistants working with this Uniweb multi-site workspace.
-
-## Project Overview
-
-This is a **Uniweb multi-site workspace** - supporting multiple sites and foundations.
-
-```
-{{projectName}}/
-├── foundations/        # Shared component libraries
-│   └── default/        # Default foundation
-├── sites/              # Content sites
-│   └── main/           # Main site
-├── package.json        # Root workspace config
-└── pnpm-workspace.yaml
-```
-
-## Quick Commands
-
-```bash
-# Install dependencies
-pnpm install
-
-# Start main site development
-pnpm dev
-
-# Start all sites in parallel
-pnpm dev:all
-
-# Build main site
-pnpm build
-
-# Build all sites
-pnpm build:all
-```
-
-## Adding New Sites
-
-1. Copy an existing site directory:
-   ```bash
-   cp -r sites/main sites/newsite
-   ```
-
-2. Update `sites/newsite/package.json` with a unique name
-
-3. Update `sites/newsite/site.yml` with site configuration
-
-4. Run `pnpm install` to link the new site
-
-## Adding New Foundations
-
-1. Copy an existing foundation:
-   ```bash
-   cp -r foundations/default foundations/newfoundation
-   ```
-
-2. Update `foundations/newfoundation/package.json` with a unique name
-
-3. In your site's `site.yml`, reference the foundation:
-   ```yaml
-   foundation: newfoundation
-   ```
-
-4. In your site's `package.json`, add the dependency:
-   ```json
-   "dependencies": {
-     "newfoundation": "file:../../foundations/newfoundation"
-   }
-   ```
-
-## Key Files
-
-**Sites:**
-- `sites/*/vite.config.js` - 3-line config using `defineSiteConfig()` from `@uniweb/build/site`
-- `sites/*/main.js` - Entry point using `start()` from `@uniweb/runtime`
-- `sites/*/site.yml` - Site configuration (foundation reference, title, i18n)
-- `sites/*/pages/` - Content pages (file-based routing)
-
-**Foundations:**
-- `foundations/*/vite.config.js` - 3-line config using `defineFoundationConfig()` from `@uniweb/build`
-- `foundations/*/src/styles.css` - Tailwind CSS v4 theme
-- `foundations/*/src/components/*/meta.js` - Component metadata (makes component exposed)
-- `foundations/*/src/runtime.js` - (optional) Custom Layout and foundation props
-
-## Architecture
-
-### Foundations (`/foundations/*`)
-
-Each foundation is a React component library. Sites can share foundations or have their own.
-
-### Sites (`/sites/*`)
-
-Each site contains content in markdown. A site references one foundation for its components.
-
-## Resources
-
-- [Uniweb Documentation](https://github.com/uniweb/uniweb)
-- [@uniweb/kit Documentation](https://www.npmjs.com/package/@uniweb/kit)
-- [Tailwind CSS v4](https://tailwindcss.com/docs)
+{{> claude-md}}

package/templates/multi/README.md.hbs

@@ -1,15 +1,8 @@
 # {{projectName}}
 
-A multi-site workspace built with [Uniweb](https://github.com/uniweb/uniweb) — a component web platform that separates content from code.
+A multi-site workspace built with [Uniweb](https://github.com/uniweb/cli) — a component web platform that separates content from code.
 
-## Quick Start
-
-```bash
-pnpm install    # Install dependencies
-pnpm dev        # Start main site development
-```
-
-Visit `http://localhost:5173` to see your site.
+{{> quick-start}}
 
 ## Project Structure
 
@@ -33,6 +26,8 @@ Visit `http://localhost:5173` to see your site.
 └── README.md            # This file
 ```
 
+{{> components-docs}}
+
 ## Commands
 
 ```bash
@@ -85,12 +80,6 @@ This allows:
 - Single source of truth for design
 - Foundation updates propagate to all sites
 
-## AI Assistance
-
-See [CLAUDE.md](./CLAUDE.md) for detailed instructions that AI assistants can use.
-
-## Learn More
+{{> ai-assistance}}
 
-- [Uniweb Documentation](https://github.com/uniweb/uniweb)
-- [@uniweb/kit Components](https://www.npmjs.com/package/@uniweb/kit)
-- [Tailwind CSS v4](https://tailwindcss.com)
+{{> learn-more}}

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

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

package/templates/multi/foundations/default/src/_entry.generated.js

@@ -0,0 +1,13 @@
+// Auto-generated foundation entry point
+// DO NOT EDIT - This file is regenerated during build
+
+import './styles.css'
+import Section from './components/Section/index.jsx'
+
+export const components = { Section }
+
+export { Section }
+
+export const capabilities = null
+
+export const meta = {}

package/templates/multi/foundations/default/src/exports.js.hbs

@@ -0,0 +1,11 @@
+{{> exports-js}}
+
+// import Layout from './components/Layout'
+
+export default {
+  // Uncomment to use a custom page layout:
+  // Layout,
+
+  // Foundation-wide props (accessible via website.foundationProps):
+  props: {},
+}

package/templates/single/README.md.hbs

@@ -1,15 +1,8 @@
 # {{projectName}}
 
-A website built with [Uniweb](https://github.com/uniweb/uniweb) — a component web platform that separates content from code.
+A website built with [Uniweb](https://github.com/uniweb/cli) — a component web platform that separates content from code.
 
-## Quick Start
-
-```bash
-pnpm install    # Install dependencies
-pnpm dev        # Start development server
-```
-
-Visit `http://localhost:5173` to see your site.
+{{> quick-start}}
 
 ## Project Structure
 
@@ -49,10 +42,7 @@ Your content here.
 [Call to Action](#)
 ```
 
-**Page structure:**
-- Create folder: `site/pages/about/`
-- Add `page.yml` with title and metadata
-- Add sections: `1-intro.md`, `2-team.md`, etc.
+{{> adding-pages}}
 
 ## Component Development
 
@@ -78,6 +68,8 @@ export default Hero
 
 Exposed components (selectable via `type:` in frontmatter) need a `meta.js` file.
 
+{{> components-docs}}
+
 ## Building
 
 ```bash
@@ -90,12 +82,6 @@ cd site && pnpm build
 
 Deploy `site/dist/` to any static host (Vercel, Netlify, Cloudflare Pages, etc.)
 
-## AI Assistance
-
-See [CLAUDE.md](./CLAUDE.md) for detailed instructions that AI assistants can use.
-
-## Learn More
+{{> ai-assistance}}
 
-- [Uniweb Documentation](https://github.com/uniweb/uniweb)
-- [@uniweb/kit Components](https://www.npmjs.com/package/@uniweb/kit)
-- [Tailwind CSS v4](https://tailwindcss.com)
+{{> learn-more}}

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

@@ -11,11 +11,11 @@
   },
   "files": ["dist", "src"],
   "scripts": {
-    "postinstall": "node scripts/generate-entry.js",
     "dev": "vite",
     "build": "uniweb build",
     "build:vite": "vite build",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "docs": "uniweb docs"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/templates/single/foundation/src/_entry.generated.js

@@ -0,0 +1,13 @@
+// Auto-generated foundation entry point
+// DO NOT EDIT - This file is regenerated during build
+
+import './styles.css'
+import Section from './components/Section/index.jsx'
+
+export const components = { Section }
+
+export { Section }
+
+export const capabilities = null
+
+export const meta = {}

package/templates/single/foundation/src/exports.js.hbs

@@ -0,0 +1,11 @@
+{{> exports-js}}
+
+// import Layout from './components/Layout'
+
+export default {
+  // Uncomment to use a custom page layout:
+  // Layout,
+
+  // Foundation-wide props (accessible via website.foundationProps):
+  props: {},
+}

package/templates/template/template/CLAUDE.md.hbs

@@ -66,5 +66,5 @@ uniweb create myproject --template github:user/repo
 
 ## Resources
 
-- [Uniweb Documentation](https://github.com/uniweb/uniweb)
+- [Uniweb Documentation](https://github.com/uniweb/cli)
 - [@uniweb/kit Documentation](https://www.npmjs.com/package/@uniweb/kit)

package/templates/template/template/foundation/src/_entry.generated.js

@@ -0,0 +1,14 @@
+// Auto-generated foundation entry point
+// DO NOT EDIT - This file is regenerated during build
+
+import './styles.css'
+import Features from './components/Features/index.jsx'
+import Hero from './components/Hero/index.jsx'
+
+export const components = { Features, Hero }
+
+export { Features, Hero }
+
+export const runtime = null
+
+export const meta = {}

package/src/partials/search-docs.hbs

@@ -1,110 +0,0 @@
-## Search Functionality
-
-Uniweb sites support full-text search out of the box. Search indexes are generated automatically at build time.
-
-### Enabling Search in Your Foundation
-
-To add search to your site, your foundation needs the **Fuse.js** library:
-
-```bash
-cd foundation
-pnpm add fuse.js
-```
-
-Then use the search helpers from `@uniweb/kit`:
-
-```jsx
-import { useSearch } from '@uniweb/kit/search'
-
-function SearchComponent({ website }) {
-  const { query, results, isLoading, clear } = useSearch(website)
-
-  return (
-    <div>
-      <input
-        type="search"
-        placeholder="Search..."
-        onChange={e => query(e.target.value)}
-      />
-      {isLoading && <span>Searching...</span>}
-      <ul>
-        {results.map(result => (
-          <li key={result.id}>
-            <a href={result.href}>{result.title}</a>
-            <p dangerouslySetInnerHTML=\{{ __html: result.snippetHtml }} />
-          </li>
-        ))}
-      </ul>
-    </div>
-  )
-}
-```
-
-### Search Configuration
-
-Search is enabled by default. To customize, add to `site/site.yml`:
-
-```yaml
-search:
-  enabled: true
-  exclude:
-    routes: [/admin, /private]    # Don't index these routes
-    components: [Debug]            # Don't index these component types
-```
-
-### How It Works
-
-1. **Build time**: Uniweb extracts text from all pages and sections
-2. **Output**: A `search-index.json` file is generated in `dist/`
-3. **Runtime**: Components fetch and search the index client-side
-4. **Multi-locale**: Each locale gets its own search index
-
-### Search API
-
-The `website` object provides these methods:
-
-```javascript
-// Check if search is available
-website.isSearchEnabled()      // Returns boolean
-
-// Get the URL for the search index
-website.getSearchIndexUrl()    // "/search-index.json" or "/es/search-index.json"
-
-// Get full search configuration
-website.getSearchConfig()      // { enabled, indexUrl, locale, include, exclude }
-```
-
-### Search Result Format
-
-Results from `useSearch()` include:
-
-| Field | Description |
-|-------|-------------|
-| `id` | Unique result identifier |
-| `type` | `"page"` or `"section"` |
-| `route` | Page route |
-| `href` | Full link including anchor |
-| `title` | Result title |
-| `pageTitle` | Parent page title (for sections) |
-| `snippetHtml` | Excerpt with `<mark>` highlighted matches |
-| `snippetText` | Plain text excerpt |
-
-### Without @uniweb/kit
-
-If you prefer not to use the kit helpers, you can fetch the index directly:
-
-```javascript
-// Fetch the search index
-const response = await fetch(website.getSearchIndexUrl())
-const index = await response.json()
-
-// Use with Fuse.js directly
-import Fuse from 'fuse.js'
-const fuse = new Fuse(index.entries, {
-  keys: ['title', 'content'],
-  threshold: 0.35,
-  includeMatches: true
-})
-
-const results = fuse.search('your query')
-```

package/templates/multi/foundations/default/src/index.js

@@ -1,32 +0,0 @@
-/**
- * Default Foundation Entry Point
- */
-
-import Section from './components/Section/index.jsx'
-
-const components = {
-  Section,
-}
-
-export function getComponent(name) {
-  return components[name]
-}
-
-export function listComponents() {
-  return Object.keys(components)
-}
-
-export function getSchema(name) {
-  return components[name]?.schema
-}
-
-export function getAllSchemas() {
-  const schemas = {}
-  for (const [name, component] of Object.entries(components)) {
-    if (component.schema) schemas[name] = component.schema
-  }
-  return schemas
-}
-
-export { Section }
-export default { getComponent, listComponents, getSchema, getAllSchemas, components }

package/templates/single/foundation/scripts/generate-entry.js

@@ -1,15 +0,0 @@
-/**
- * Generate Foundation Entry Point
- *
- * This script is called during postinstall to ensure the foundation
- * entry point exists before the site dev server starts.
- */
-
-import { generateEntryPoint } from '@uniweb/build'
-
-try {
-  await generateEntryPoint('./src', './src/_entry.generated.js')
-} catch (err) {
-  // Silently fail during initial install if dependencies aren't ready
-  console.warn('Note: Entry generation skipped (run foundation dev/build to generate)')
-}