uniweb 0.6.23 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.6.23",
+  "version": "0.7.0",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -40,9 +40,9 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
-    "@uniweb/build": "0.6.20",
-    "@uniweb/core": "0.4.7",
-    "@uniweb/runtime": "0.5.22",
-    "@uniweb/kit": "0.5.11"
+    "@uniweb/build": "0.7.0",
+    "@uniweb/core": "0.5.0",
+    "@uniweb/kit": "0.6.0",
+    "@uniweb/runtime": "0.6.0"
   }
 }

package/partials/agents-md.hbs

@@ -146,7 +146,7 @@ Components that render their own background declare `background: 'self'` in `met
 site/layout/
 ├── header.md               # type: Header — rendered on every page
 ├── footer.md               # type: Footer — rendered on every page
-└── left.md                 # type: LeftPanel — optional sidebar
+└── left.md                 # type: Sidebar — optional sidebar
 
 site/pages/
 └── home/
@@ -334,14 +334,41 @@ const firstBody = block.page.getFirstBodyBlockInfo()
 
 ### Custom Layouts
 
-Export a Layout from `foundation/src/foundation.js`. Kit provides `SidebarLayout` for sidebar-based sites (docs, dashboards):
+Layouts live in `foundation/src/layouts/` and are auto-discovered. Set the default in `foundation.js`:
+
+```js
+// foundation/src/foundation.js
+export default {
+  name: 'My Template',              // Display name (falls back to package.json name)
+  description: 'A brief description', // Falls back to package.json description
+  defaultLayout: 'DocsLayout',
+}
+```
 
 ```jsx
-import { SidebarLayout } from '@uniweb/kit/styled'
-export default { Layout: SidebarLayout }
+// foundation/src/layouts/DocsLayout/index.jsx
+export default function DocsLayout({ header, body, footer, left, right, params }) {
+  return (
+    <div className="min-h-screen flex flex-col">
+      {header && <header>{header}</header>}
+      <div className="flex-1 flex">
+        {left && <aside className="w-64">{left}</aside>}
+        <main className="flex-1">{body}</main>
+        {right && <aside className="w-64">{right}</aside>}
+      </div>
+      {footer && <footer>{footer}</footer>}
+    </div>
+  )
+}
 ```
 
-Layout receives pre-rendered areas: `header`, `body`, `footer`, `left`/`leftPanel`, `right`/`rightPanel`.
+Layout receives pre-rendered areas as props: `header`, `body`, `footer`, `left`, `right` (or any custom area names declared in `meta.js`), plus `params`, `page`, and `website`. Pages select layouts and hide areas in `page.yml`:
+
+```yaml
+layout:
+  name: MarketingLayout
+  hide: [left, right]
+```
 
 ## Converting Existing Designs
 

package/src/commands/docs.js

@@ -121,11 +121,13 @@ ${colors.bright}Navigation Visibility:${colors.reset}
   ${colors.cyan}hideInHeader${colors.reset}      Hide from header nav only
   ${colors.cyan}hideInFooter${colors.reset}      Hide from footer nav only
 
-${colors.bright}Layout Overrides:${colors.reset}
-  ${colors.cyan}layout.header${colors.reset}     Show header on this page (default: true)
-  ${colors.cyan}layout.footer${colors.reset}     Show footer on this page (default: true)
-  ${colors.cyan}layout.leftPanel${colors.reset}  Show left sidebar (default: true)
-  ${colors.cyan}layout.rightPanel${colors.reset} Show right sidebar (default: true)
+${colors.bright}Layout Options:${colors.reset}
+  ${colors.cyan}layout${colors.reset}            Layout name or object with name, hide, params
+                    String: layout name (e.g., MarketingLayout)
+                    Object: { name, hide: [areas], params: {...} }
+  ${colors.cyan}layout.hide${colors.reset}       Array of area names to suppress on this page
+                    Example: [header, footer] or [left, right]
+  ${colors.cyan}layout.params${colors.reset}     Layout-specific parameters (merged with meta.js defaults)
 
 ${colors.bright}Section Control:${colors.reset}
   ${colors.cyan}sections${colors.reset}          "*" for auto-discover, or explicit array
@@ -147,7 +149,7 @@ ${colors.bright}Example:${colors.reset}
   order: 2
   hideInFooter: true
   layout:
-    rightPanel: false
+    hide: [right]
   seo:
     image: /about-og.png${colors.reset}
 

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

@@ -9,7 +9,7 @@
  * Identity (name, version, description) comes from package.json.
  */
 
-// import Layout from './sections/Layout'
+// Create a layout at src/layouts/MyLayout/index.jsx
 
 /**
  * CSS custom properties that sites can override in theme.yml
@@ -33,8 +33,8 @@ export const vars = {
  * Runtime exports (Layout and props)
  */
 export default {
-  // Uncomment to use a custom page layout:
-  // Layout,
+  // Optional: Create custom layouts in src/layouts/
+  // Then set defaultLayout: 'MyLayout' below
 
   // Foundation-wide props (accessible via website.foundationProps):
   props: {},

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

@@ -3,13 +3,13 @@
  *
  * This file defines foundation-level configuration:
  * - vars: CSS custom properties that sites can override in theme.yml
- * - Layout: Custom page layout component (optional)
+ * - defaultLayout: Name of the default layout from src/layouts/ (optional)
  * - props: Foundation-wide props accessible via website.foundationProps
  *
  * Identity (name, version, description) comes from package.json.
  */
 
-// import Layout from './sections/Layout'
+// Create a layout at src/layouts/MyLayout/index.jsx
 
 /**
  * CSS custom properties that sites can override in theme.yml
@@ -30,18 +30,19 @@ export const vars = {
 }
 
 /**
- * Runtime exports (Layout and props)
+ * Runtime exports
  *
- * The Layout component receives pre-rendered page areas as props:
- * - page, website: Runtime context
+ * Layout components live in src/layouts/ and are auto-discovered.
+ * Each layout receives pre-rendered page areas as props:
+ * - page, website, params: Runtime context
  * - header, body, footer: Core page regions (pre-rendered React elements)
- * - left/leftPanel, right/rightPanel: Sidebar panels
+ * - Plus any custom areas declared in the layout's meta.js
  *
- * If no Layout is provided, the runtime uses a default layout.
+ * If no layouts exist, the runtime uses a default layout.
  */
 export default {
-  // Uncomment to use a custom page layout:
-  // Layout,
+  // Optional: Create custom layouts in src/layouts/
+  // Then set defaultLayout: 'MyLayout' below
 
   // Foundation-wide props (accessible via website.foundationProps):
   props: {},