@uniweb/build 0.4.10 → 0.6.0

package/README.md

@@ -15,7 +15,7 @@ npm install @uniweb/build --save-dev
 ## Features
 
 **For Foundations:**
-- **Component Discovery** - Automatically discovers components from `src/components/*/meta.js`
+- **Component Discovery** - Discovers section types from `src/sections/` (implicit at root) and `src/components/` (requires `meta.js`)
 - **Entry Generation** - Generates the foundation entry point with all exports
 - **Schema Building** - Creates `schema.json` with full component metadata for editors
 - **Image Processing** - Converts preview images to WebP format
@@ -263,7 +263,7 @@ src/
 ### Component Meta File
 
 ```js
-// src/components/Hero/meta.js
+// src/sections/Hero/meta.js
 export default {
   title: 'Hero Banner',
   description: 'A prominent header section',
@@ -367,7 +367,7 @@ Identity fields (`name`, `version`, `description`) come from the foundation's `p
 
 | Function | Description |
 |----------|-------------|
-| `discoverComponents(srcDir)` | Discover all exposed components |
+| `discoverComponents(srcDir)` | Discover all section types (folders with meta.js) |
 | `loadComponentMeta(componentDir)` | Load meta file for a component |
 | `loadPackageJson(srcDir)` | Load identity from package.json |
 | `loadFoundationConfig(srcDir)` | Load foundation.js configuration |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.4.10",
+  "version": "0.6.0",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -50,8 +50,9 @@
     "sharp": "^0.33.2"
   },
   "optionalDependencies": {
+    "@uniweb/runtime": "0.5.11",
     "@uniweb/content-reader": "1.1.2",
-    "@uniweb/runtime": "0.5.11"
+    "@uniweb/schemas": "0.2.1"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -60,7 +61,7 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/core": "0.3.10"
+    "@uniweb/core": "0.4.0"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/docs.js

@@ -30,12 +30,12 @@ function generateComponentDocs(name, meta) {
     lines.push('')
   }
 
-  // Parameters/Properties (shown first - most important for content authors)
-  if (meta.properties && Object.keys(meta.properties).length > 0) {
+  // Parameters (shown first - most important for content authors)
+  if (meta.params && Object.keys(meta.params).length > 0) {
     lines.push('### Parameters')
     lines.push('')
 
-    for (const [key, prop] of Object.entries(meta.properties)) {
+    for (const [key, prop] of Object.entries(meta.params)) {
       const defaultVal = prop.default !== undefined ? prop.default : ''
 
       // Parameter name with default

package/src/foundation/config.js

@@ -48,9 +48,9 @@ const DEFAULT_EXTERNALS = [
  * @param {Object} [options={}] - Configuration options
  * @param {string} [options.entry] - Entry point path (default: 'src/_entry.generated.js')
  * @param {string} [options.fileName] - Output file name (default: 'foundation')
- * @param {string[]} [options.components] - Paths to search for components (relative to src/).
- *                                          Default: ['components']
- *                                          Example: ['components', 'components/sections']
+ * @param {string[]} [options.components] - Paths to scan for content interfaces (relative to src/).
+ *                                          Default: ['sections', 'components']
+ *                                          Example: ['sections', 'sections/marketing']
  * @param {string[]} [options.externals] - Additional packages to externalize
  * @param {boolean} [options.includeDefaultExternals] - Include default externals (default: true)
  * @param {Array} [options.plugins] - Additional Vite plugins

package/src/generate-entry.js

@@ -112,10 +112,10 @@ function generateEntrySource(components, options = {}) {
     lines.push(`import capabilities from '${foundationExports.path}'`)
   }
 
-  // Component imports (use component's path and detected extension)
+  // Component imports
   for (const name of componentNames) {
-    const { path, ext = 'js' } = components[name]
-    lines.push(`import ${name} from './${path}/index.${ext}'`)
+    const { path, entryFile = `index.js` } = components[name]
+    lines.push(`import ${name} from './${path}/${entryFile}'`)
   }
 
   lines.push('')
@@ -153,19 +153,33 @@ function generateEntrySource(components, options = {}) {
 }
 
 /**
- * Detect the index file extension for a component
+ * Detect the entry file for a component
+ *
+ * Supports two conventions:
+ * - index.jsx (default)
+ * - ComponentName.jsx (named file matching the directory name)
+ *
+ * Named files are checked first so that Hero/Hero.jsx takes precedence
+ * over Hero/index.jsx when both exist (the named file is more intentional).
  *
  * @param {string} srcDir - Source directory
  * @param {string} componentPath - Relative path to component (e.g., 'components/Hero')
+ * @param {string} componentName - Component name (e.g., 'Hero')
+ * @returns {{ file: string, ext: string }} Entry file name and extension
  */
-function detectComponentExtension(srcDir, componentPath) {
+function detectComponentEntry(srcDir, componentPath, componentName) {
   const basePath = join(srcDir, componentPath)
   for (const ext of ['jsx', 'tsx', 'js', 'ts']) {
+    // Check named file first: Hero/Hero.jsx
+    if (existsSync(join(basePath, `${componentName}.${ext}`))) {
+      return { file: `${componentName}.${ext}`, ext }
+    }
+    // Then index file: Hero/index.jsx
     if (existsSync(join(basePath, `index.${ext}`))) {
-      return ext
+      return { file: `index.${ext}`, ext }
     }
   }
-  return 'js' // default
+  return { file: 'index.js', ext: 'js' } // default
 }
 
 /**
@@ -184,13 +198,18 @@ export async function generateEntryPoint(srcDir, outputPath = null, options = {}
   const componentNames = Object.keys(components).sort()
 
   if (componentNames.length === 0) {
-    console.warn('Warning: No exposed components found')
+    console.warn('Warning: No section types found')
   }
 
-  // Detect extensions for each component and add to component info
+  // Detect entry files for each component
+  // Bare files discovered in sections/ already have entryFile set — skip detection for those
   for (const name of componentNames) {
     const component = components[name]
-    component.ext = detectComponentExtension(srcDir, component.path)
+    if (!component.entryFile) {
+      const entry = detectComponentEntry(srcDir, component.path, component.name)
+      component.ext = entry.ext
+      component.entryFile = entry.file
+    }
   }
 
   // Check for CSS file