@uniweb/build 0.1.8 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -9,6 +9,8 @@
     "./images": "./src/images.js",
     "./generate-entry": "./src/generate-entry.js",
     "./vite-plugin": "./src/vite-foundation-plugin.js",
+    "./foundation": "./src/foundation/index.js",
+    "./foundation/config": "./src/foundation/config.js",
     "./site": "./src/site/index.js",
     "./site/config": "./src/site/config.js",
     "./dev": "./src/dev/index.js",

package/src/foundation/config.js

@@ -0,0 +1,144 @@
+/**
+ * Foundation Vite Configuration
+ *
+ * Provides a zero-config or minimal-config Vite setup for Uniweb foundations.
+ * Handles library mode, externals, and standard plugins.
+ *
+ * @module @uniweb/build/foundation/config
+ *
+ * @example
+ * // Minimal vite.config.js (recommended)
+ * import { defineFoundationConfig } from '@uniweb/build'
+ *
+ * export default defineFoundationConfig()
+ *
+ * @example
+ * // With customization
+ * import { defineFoundationConfig } from '@uniweb/build'
+ *
+ * export default defineFoundationConfig({
+ *   entry: 'src/custom-entry.js',
+ *   externals: ['lodash'],
+ *   plugins: [myPlugin()],
+ * })
+ */
+
+import { resolve } from 'node:path'
+
+/**
+ * Default externals for foundations
+ * These are not bundled into the foundation output
+ */
+/**
+ * Default externals for foundations
+ * These are provided by the runtime and should not be bundled
+ */
+const DEFAULT_EXTERNALS = [
+  'react',
+  'react-dom',
+  'react/jsx-runtime',
+  'react/jsx-dev-runtime',
+  '@uniweb/core'
+]
+
+/**
+ * Create a complete Vite configuration for a Uniweb foundation
+ *
+ * @param {Object} [options={}] - Configuration options
+ * @param {string} [options.entry] - Entry point path (default: 'src/entry-runtime.js')
+ * @param {string} [options.fileName] - Output file name (default: 'foundation')
+ * @param {string[]} [options.externals] - Additional packages to externalize
+ * @param {boolean} [options.includeDefaultExternals] - Include default externals (default: true)
+ * @param {Array} [options.plugins] - Additional Vite plugins
+ * @param {boolean} [options.tailwind] - Include Tailwind CSS v4 plugin (default: true)
+ * @param {boolean} [options.sourcemap] - Generate sourcemaps (default: true)
+ * @param {Object} [options.build] - Additional build options to merge
+ * @returns {Promise<Object>} Vite configuration
+ */
+export async function defineFoundationConfig(options = {}) {
+  const {
+    entry = 'src/entry-runtime.js',
+    fileName = 'foundation',
+    externals: additionalExternals = [],
+    includeDefaultExternals = true,
+    plugins: extraPlugins = [],
+    tailwind = true,
+    sourcemap = true,
+    build: buildOverrides = {},
+    ...restOptions
+  } = options
+
+  // Determine foundation root (where vite.config.js is)
+  const foundationRoot = process.cwd()
+
+  // Build externals list
+  const externals = includeDefaultExternals
+    ? [...DEFAULT_EXTERNALS, ...additionalExternals]
+    : additionalExternals
+
+  // Dynamic imports for optional peer dependencies
+  const imports = [
+    import('@vitejs/plugin-react'),
+    import('vite-plugin-svgr')
+  ]
+
+  // Only import tailwind if enabled
+  if (tailwind) {
+    imports.unshift(import('@tailwindcss/vite'))
+  }
+
+  const modules = await Promise.all(imports)
+
+  // Extract plugins based on what was imported
+  let tailwindcss, react, svgr
+  if (tailwind) {
+    tailwindcss = modules[0].default
+    react = modules[1].default
+    svgr = modules[2].default
+  } else {
+    react = modules[0].default
+    svgr = modules[1].default
+  }
+
+  // Build the plugins array
+  const plugins = [
+    tailwind && tailwindcss(),
+    react(),
+    svgr(),
+    ...extraPlugins
+  ].filter(Boolean)
+
+  return {
+    plugins,
+
+    build: {
+      lib: {
+        entry: resolve(foundationRoot, entry),
+        formats: ['es'],
+        fileName
+      },
+      rollupOptions: {
+        external: externals,
+        output: {
+          assetFileNames: 'assets/[name][extname]'
+        }
+      },
+      sourcemap,
+      cssCodeSplit: false,
+      ...buildOverrides
+    },
+
+    ...restOptions
+  }
+}
+
+/**
+ * Default export - an async function that can be used directly as vite.config.js
+ *
+ * @example
+ * // vite.config.js - simplest form
+ * export { default } from '@uniweb/build/foundation/config'
+ */
+export default function (overrides = {}) {
+  return defineFoundationConfig(overrides)
+}

package/src/foundation/index.js

@@ -0,0 +1,9 @@
+/**
+ * Foundation Build Tools
+ *
+ * Vite configuration and utilities for building Uniweb foundations.
+ *
+ * @module @uniweb/build/foundation
+ */
+
+export { defineFoundationConfig, default } from './config.js'

package/src/index.js

@@ -46,5 +46,11 @@ export {
   generateDocsFromSchema,
 } from './docs.js'
 
+// Foundation config
+export { defineFoundationConfig } from './foundation/config.js'
+
+// Site config
+export { defineSiteConfig } from './site/config.js'
+
 // Default export is the combined Vite plugin
 export { default } from './vite-foundation-plugin.js'