uniweb 0.2.30 → 0.2.32

package/README.md

@@ -322,10 +322,9 @@ my-project/
     ├── package.json
     ├── vite.config.js        # 3-line config
     └── src/
-        ├── index.js          # Component exports
-        ├── entry-runtime.js  # Runtime entry (imports styles + index)
         ├── styles.css        # Tailwind CSS v4
         ├── meta.js           # Foundation metadata
+        ├── runtime.js        # (optional) Custom Layout, props
         └── components/
             └── Section/
                 ├── index.jsx
@@ -483,8 +482,7 @@ The `defineFoundationConfig()` function handles all Vite configuration for found
 import { defineFoundationConfig } from "@uniweb/build";
 
 export default defineFoundationConfig({
-  // All options are optional
-  entry: "src/entry-runtime.js", // Entry point path
+  // All options are optional - entry is auto-generated
   fileName: "foundation", // Output file name
   externals: [], // Additional packages to externalize
   includeDefaultExternals: true, // Include react, @uniweb/core, etc.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.2.30",
+  "version": "0.2.32",
   "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.14",
-    "@uniweb/core": "0.1.6",
-    "@uniweb/runtime": "0.2.6",
+    "@uniweb/build": "0.1.15",
+    "@uniweb/runtime": "0.2.8",
+    "@uniweb/core": "0.1.7",
     "@uniweb/kit": "0.1.4"
   }
 }

package/templates/_shared/CLAUDE.md.hbs

@@ -40,24 +40,26 @@ cd site && pnpm build
 
 **Foundation:**
 - `foundation/vite.config.js` - 3-line config using `defineFoundationConfig()` from `@uniweb/build`
-- `foundation/src/entry-runtime.js` - Runtime entry point (imports styles + components)
-- `foundation/src/index.js` - Component exports
 - `foundation/src/styles.css` - Tailwind CSS v4 theme
-- `foundation/src/components/*/meta.js` - Component metadata and schema
+- `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. Each component:
+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. Receives structured content parsed from markdown
-2. Has configurable parameters (theme, layout, etc.)
-3. Renders the content according to its design
+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 and schema
+- `src/components/*/meta.js` - Component metadata (makes component exposed)
 - `src/styles.css` - Global Tailwind styles
 
 ### Site Package (`/site`)

package/templates/multi/CLAUDE.md.hbs

@@ -79,9 +79,9 @@ pnpm build:all
 
 **Foundations:**
 - `foundations/*/vite.config.js` - 3-line config using `defineFoundationConfig()` from `@uniweb/build`
-- `foundations/*/src/entry-runtime.js` - Runtime entry point
 - `foundations/*/src/styles.css` - Tailwind CSS v4 theme
-- `foundations/*/src/components/*/meta.js` - Component metadata
+- `foundations/*/src/components/*/meta.js` - Component metadata (makes component exposed)
+- `foundations/*/src/runtime.js` - (optional) Custom Layout and foundation props
 
 ## Architecture
 

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

@@ -2,9 +2,9 @@
   "name": "default",
   "version": "0.1.0",
   "type": "module",
-  "main": "./src/index.js",
+  "main": "./src/_entry.generated.js",
   "exports": {
-    ".": "./src/index.js",
+    ".": "./src/_entry.generated.js",
     "./styles": "./src/styles.css",
     "./dist": "./dist/foundation.js",
     "./dist/styles": "./dist/assets/style.css"

package/templates/single/README.md.hbs

@@ -76,7 +76,7 @@ export function Hero({ content, params }) {
 export default Hero
 ```
 
-Each component needs a `meta.js` file defining its schema.
+Exposed components (selectable via `type:` in frontmatter) need a `meta.js` file.
 
 ## Building
 

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

@@ -2,15 +2,16 @@
   "name": "foundation",
   "version": "0.1.0",
   "type": "module",
-  "main": "./src/index.js",
+  "main": "./src/_entry.generated.js",
   "exports": {
-    ".": "./src/index.js",
+    ".": "./src/_entry.generated.js",
     "./styles": "./src/styles.css",
     "./dist": "./dist/foundation.js",
     "./dist/styles": "./dist/assets/style.css"
   },
   "files": ["dist", "src"],
   "scripts": {
+    "postinstall": "node scripts/generate-entry.js",
     "dev": "vite",
     "build": "uniweb build",
     "build:vite": "vite build",

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

@@ -0,0 +1,15 @@
+/**
+ * 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)')
+}

package/templates/template/template/foundation/package.json.hbs

@@ -2,9 +2,9 @@
   "name": "foundation",
   "version": "0.1.0",
   "type": "module",
-  "main": "./src/index.js",
+  "main": "./src/_entry.generated.js",
   "exports": {
-    ".": "./src/index.js",
+    ".": "./src/_entry.generated.js",
     "./styles": "./src/styles.css",
     "./dist": "./dist/foundation.js",
     "./dist/styles": "./dist/assets/style.css"

package/templates/multi/foundations/default/src/entry-runtime.js

@@ -1,3 +0,0 @@
-import './styles.css'
-export * from './index.js'
-export { default } from './index.js'

package/templates/single/foundation/src/entry-runtime.js

@@ -1,3 +0,0 @@
-import './styles.css'
-export * from './index.js'
-export { default } from './index.js'

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

@@ -1,35 +0,0 @@
-/**
- * Foundation Entry Point
- *
- * Export all components from this file.
- * Components are discovered from src/components/{Name}/meta.js during build.
- */
-
-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/template/template/foundation/src/entry-runtime.js

@@ -1,3 +0,0 @@
-import './styles.css'
-export * from './index.js'
-export { default } from './index.js'

package/templates/template/template/foundation/src/index.js

@@ -1,36 +0,0 @@
-/**
- * Foundation Entry Point
- *
- * Export all your template's components here.
- */
-
-import Hero from './components/Hero/index.jsx'
-import Features from './components/Features/index.jsx'
-
-const components = {
-  Hero,
-  Features,
-}
-
-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 { Hero, Features }
-export default { getComponent, listComponents, getSchema, getAllSchemas, components }