@hiscovega/vundle 0.0.14 → 0.0.16

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.0.16](https://github.com/griddo/vundle/compare/v0.0.15...v0.0.16) (2026-01-21)
+
+## [0.0.15](https://github.com/griddo/griddo-bundler/compare/v0.0.14...v0.0.15) (2026-01-21)
+
+
+### Features
+
+* add initial client configuration and test suite ([3c51477](https://github.com/griddo/griddo-bundler/commit/3c514775e98cba6384028db9787b596632369fe1))
+* **vite:** enhance external handling and improve build resilience ([2acb47a](https://github.com/griddo/griddo-bundler/commit/2acb47a19d845f19c971242f7396642f02c75fba))
+
 ## [0.0.14](https://github.com/griddo/griddo-bundler/compare/v0.0.13...v0.0.14) (2026-01-21)
 
 

package/README.md

@@ -8,17 +8,21 @@ Griddo vite bundler configuration for Griddo Instance projects.
 npm install @hiscovega/vundle # at @hiscovega org for the beta testing
 ```
 
-## 🚀 Publishing
+## 🚀 Usage
 
-### Automated Releases with release-it
+### Build (from a client project)
 
-This package uses [release-it](https://github.com/release-it/release-it) for automated versioning and publishing.
+Run Vite using this package config:
 
-## 🚀 Usage
+```bash
+vite build --config node_modules/@hiscovega/vundle/vite.config.mjs
+```
+
+The bundler will look for the client `vite.config.*` in the current working directory and merge it on top of the master config.
 
-### Client Configuration (vite.config.mjs)
+### Client Configuration (`vite.config.mjs`)
 
-The bundler automatically looks for a `vite.config.mjs` file in a Griddo project root. Create this file to customize the build configuration.
+Create a `vite.config.mjs` (or `.ts/.js`) in your project root to customize the build configuration.
 
 ```javascript
 // vite.config.mjs (in your project root)
@@ -26,6 +30,10 @@ export default {
   plugins: [
     // Additional Vite plugins for your project
   ],
+
+  // Standard Vite/Rollup external (advanced). It will be COMPOSED with the bundler externals.
+  // build: { rollupOptions: { external: (id) => id === "my-heavy-dep" } },
+
   griddoOptions: {
     customExternals: [
       "some-heavy-package-foo", // Mark as external by exact name
@@ -35,21 +43,50 @@ export default {
 };
 ```
 
-## Salida del bundle
+### Notes
+
+- **Mandatory externals**: React, React DOM and `@griddo/core` are always externalized by the bundler.
+- **Optional assets**: `static/` and `thumbnails/` are copied into `dist/` if they exist. If they don't exist, the build will not fail.
+
+## Bundle output
 
-El bundle exporta cuatro elementos:
+The bundle exports four artifacts:
 
 ```
-dist/index.js # Antiguo src/index.js de la instancia: templates, modules, components, contextos, etc..
-dist/builder.js # Archivos relacionados con Gatsby: antiguos builder.browser.jsx, builder.ssr.jsx y builder.config.js
-dist/griddo.config.js # Antiguo griddo.config.ts
-dist/builder.css # Todo el css de la instancia empaquetado
+dist/index.js # Legacy instance entry: templates, modules, components, contexts, etc.
+dist/builder.js # Builder-related files (legacy): builder.browser.jsx, builder.ssr.jsx and builder.config.js
+dist/griddo.config.js # Legacy griddo.config.ts
+dist/builder.css # All instance CSS bundled
 ```
 
 ```
-Para importarlos en AX / CX
+Importing in AX / CX:
 import { SiteProvider, bundle, components, formsTemplates, templates } from "<bundle>"
 import { browser, config, ssr } from "<bundle>/builder"
 import griddoConfig from "<bundle>/griddo.config"
 import "<bundle>/builder.css"
 ```
+
+## ✅ Testing
+
+```bash
+npm test
+```
+
+## 🧪 Local fixture (simple client)
+
+This repo includes a minimal client fixture under `fixtures/client/`:
+
+```bash
+npm run fixture:build
+```
+
+## 🚀 Publishing
+
+This package uses [release-it](https://github.com/release-it/release-it) for automated versioning and publishing.
+
+Tip: if you run releases in a non-interactive environment (no TTY), use:
+
+```bash
+npm run release:patch -- --ci
+```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@hiscovega/vundle",
-	"version": "0.0.14",
+	"version": "0.0.16",
 	"description": "Master bundler configuration for Griddo Instance projects",
 	"main": "vite.config.mjs",
 	"module": "vite.config.mjs",
@@ -35,11 +35,14 @@
 	],
 	"scripts": {
 		"remote:build": "vite build --config ./vite.config.mjs",
+		"test": "vitest run --config ./vitest.config.mjs",
+		"test:watch": "vitest --config ./vitest.config.mjs",
+		"fixture:build": "cd fixtures/client && ../../node_modules/.bin/vite build --config ../../vite.config.mjs",
 		"lint": "biome check .",
 		"lint:fix": "biome check --write .",
 		"format": "biome format --write .",
 		"format:check": "biome format .",
-		"prepublishOnly": "npm run lint && npm run format:check",
+		"prepublishOnly": "npm run lint && npm run format:check && npm test",
 		"prepare": "npm run lint",
 		"release": "release-it",
 		"release:dry": "release-it --dry-run",
@@ -48,10 +51,10 @@
 		"release:patch": "release-it patch"
 	},
 	"dependencies": {
-		"@vitejs/plugin-react": "5.0.4",
-		"vite": "7.1.10",
+		"@vitejs/plugin-react": "5.1.2",
+		"vite": "7.3.1",
 		"vite-plugin-dts": "4.5.4",
-		"vite-plugin-static-copy": "3.1.4"
+		"vite-plugin-static-copy": "3.1.5"
 	},
 	"peerDependencies": {
 		"@griddo/core": "latest",
@@ -96,6 +99,7 @@
 	"devDependencies": {
 		"@biomejs/biome": "2.2.4",
 		"@release-it/conventional-changelog": "^10.0.1",
-		"release-it": "^19.0.4"
+		"release-it": "^19.0.4",
+		"vitest": "^4.0.17"
 	}
 }

package/plugins/index.mjs

@@ -18,6 +18,9 @@ export const plugins = [
 	// }),
 
 	viteStaticCopy({
+		// `static/` y `thumbnails/` no son obligatorios en todos los clientes.
+		// Si no existen/no hay archivos, no queremos que el build falle.
+		silent: true,
 		targets: [
 			{ src: "static", dest: "" },
 			{ src: "thumbnails", dest: "" },

package/vite.config.mjs

@@ -15,6 +15,20 @@ export default defineConfig(async ({ command, mode }) => {
 		return "assets/[name]-[hash][extname]";
 	};
 
+	const toExternalFn = (external) => {
+		if (!external) return () => false;
+		if (typeof external === "function") return external;
+
+		const externals = Array.isArray(external) ? external : [external];
+		return (id) => {
+			for (const ext of externals) {
+				if (typeof ext === "string" && (id === ext || id.startsWith(`${ext}/`))) return true;
+				if (ext instanceof RegExp && ext.test(id)) return true;
+			}
+			return false;
+		};
+	};
+
 	// Usamos la función nativa de Vite para encontrar, cargar y transpilar
 	// la configuración del cliente, soportando .ts, .js, .mjs, etc.
 	try {
@@ -116,15 +130,18 @@ export default defineConfig(async ({ command, mode }) => {
 	};
 
 	// --- Fusión Final ---
-	// Antes de fusionar, nos aseguramos de que la configuración `external` del
-	// master nunca sea sobreescrita por el cliente. Esta es la clave para
-	// evitar la duplicación de React.
-	if (clientConfig.build?.rollupOptions?.external) {
-		console.log(
-			"WARN: The client-defined 'build.rollupOptions.external' property will be ignored. Use 'griddoOptions.customExternals' instead.",
-		);
-		delete clientConfig.build.rollupOptions.external;
-	}
+	const merged = mergeConfig(masterConfig, clientConfig);
+
+	// Componemos externals: reglas del master (React/@griddo/core, etc.) + API declarativa
+	// `griddoOptions.customExternals` + `build.rollupOptions.external` estándar del cliente.
+	// Esto mantiene compatibilidad con Vite/Rollup sin permitir que el cliente "rebundee" React.
+	const clientExternal = toExternalFn(clientConfig.build?.rollupOptions?.external);
+	const masterExternal = toExternalFn(masterConfig.build?.rollupOptions?.external);
+
+	if (!merged.build) merged.build = {};
+	if (!merged.build.rollupOptions) merged.build.rollupOptions = {};
+
+	merged.build.rollupOptions.external = (id, ...args) => masterExternal(id, ...args) || clientExternal(id, ...args);
 
-	return mergeConfig(masterConfig, clientConfig);
+	return merged;
 });