@burdenoff/fe-libs 2026.516.2 → 2026.518.2

package/src/vite/plugins.ts

@@ -5,8 +5,8 @@
  * @version Vite 8.0.0-beta.8+
  */
 
-import type { Plugin } from "vite";
-import { resolve } from "path";
+import type { Plugin } from 'vite';
+import { resolve } from 'path';
 
 interface ContextualAliasOptions {
   /** Path to fe-libs/src */
@@ -35,18 +35,16 @@ interface ContextualAliasOptions {
  * ]
  * ```
  */
-export function createContextualAliasPlugin(
-  options: ContextualAliasOptions,
-): Plugin {
+export function createContextualAliasPlugin(options: ContextualAliasOptions): Plugin {
   const { feLibsPath, srcPath, microfePaths = {} } = options;
 
   return {
-    name: "burdenoff:contextual-alias",
-    enforce: "pre",
+    name: 'burdenoff:contextual-alias',
+    enforce: 'pre',
 
     async resolveId(source, importer, resolveOptions) {
       // Only handle @/ imports
-      if (!source.startsWith("@/")) {
+      if (!source.startsWith('@/')) {
         return null;
       }
 
@@ -59,7 +57,7 @@ export function createContextualAliasPlugin(
       let basePath: string;
 
       // Determine base path based on importer location
-      if (importer.includes("fe-libs")) {
+      if (importer.includes('fe-libs')) {
         // Importer is from fe-libs, resolve to fe-libs/src
         basePath = feLibsPath;
       } else {
@@ -103,14 +101,14 @@ export function createContextualAliasPlugin(
  */
 export function createAdaptiveExpressionsFix(): Plugin {
   return {
-    name: "burdenoff:adaptive-expressions-fix",
-    enforce: "pre",
+    name: 'burdenoff:adaptive-expressions-fix',
+    enforce: 'pre',
 
     resolveId(source) {
       // Force correct resolution for adaptive-expressions
-      if (source === "adaptive-expressions") {
+      if (source === 'adaptive-expressions') {
         return {
-          id: "adaptive-expressions/lib/index.js",
+          id: 'adaptive-expressions/lib/index.js',
           external: false,
         };
       }
@@ -130,15 +128,13 @@ export function createAdaptiveExpressionsFix(): Plugin {
  * plugins: [createReactSingletonPlugin(resolve(__dirname, 'node_modules'))]
  * ```
  */
-export function createReactSingletonAliases(
-  nodeModulesPath: string,
-): Record<string, string> {
+export function createReactSingletonAliases(nodeModulesPath: string): Record<string, string> {
   return {
-    react: resolve(nodeModulesPath, "react"),
-    "react-dom": resolve(nodeModulesPath, "react-dom"),
-    "react-dom/client": resolve(nodeModulesPath, "react-dom/client"),
-    "react/jsx-runtime": resolve(nodeModulesPath, "react/jsx-runtime"),
-    "react/jsx-dev-runtime": resolve(nodeModulesPath, "react/jsx-dev-runtime"),
+    react: resolve(nodeModulesPath, 'react'),
+    'react-dom': resolve(nodeModulesPath, 'react-dom'),
+    'react-dom/client': resolve(nodeModulesPath, 'react-dom/client'),
+    'react/jsx-runtime': resolve(nodeModulesPath, 'react/jsx-runtime'),
+    'react/jsx-dev-runtime': resolve(nodeModulesPath, 'react/jsx-dev-runtime'),
   };
 }
 
@@ -151,40 +147,31 @@ export function createReactSingletonAliases(
  */
 export function createNodeShimAliases(
   feLibsShimsPath: string,
-  srcPath?: string,
+  srcPath?: string
 ): Record<string, string> {
   const shimsPath = srcPath ?? feLibsShimsPath;
   return {
-    assert: resolve(feLibsShimsPath, "assert.ts"),
-    util: resolve(feLibsShimsPath, "util.ts"),
-    process: resolve(feLibsShimsPath, "process.ts"),
-    "use-sync-external-store/shim": resolve(
-      shimsPath,
-      "use-sync-external-store-shim.ts",
-    ),
-    "use-sync-external-store/shim/index": resolve(
-      shimsPath,
-      "use-sync-external-store-shim.ts",
-    ),
-    "use-sync-external-store/shim/index.js": resolve(
+    assert: resolve(feLibsShimsPath, 'assert.ts'),
+    util: resolve(feLibsShimsPath, 'util.ts'),
+    process: resolve(feLibsShimsPath, 'process.ts'),
+    'use-sync-external-store/shim': resolve(shimsPath, 'use-sync-external-store-shim.ts'),
+    'use-sync-external-store/shim/index': resolve(shimsPath, 'use-sync-external-store-shim.ts'),
+    'use-sync-external-store/shim/index.js': resolve(shimsPath, 'use-sync-external-store-shim.ts'),
+    'use-sync-external-store/with-selector': resolve(
       shimsPath,
-      "use-sync-external-store-shim.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
-    "use-sync-external-store/with-selector": resolve(
+    'use-sync-external-store/with-selector.js': resolve(
       shimsPath,
-      "use-sync-external-store-with-selector.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
-    "use-sync-external-store/with-selector.js": resolve(
+    'use-sync-external-store/shim/with-selector': resolve(
       shimsPath,
-      "use-sync-external-store-with-selector.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
-    "use-sync-external-store/shim/with-selector": resolve(
+    'use-sync-external-store/shim/with-selector.js': resolve(
       shimsPath,
-      "use-sync-external-store-with-selector.ts",
-    ),
-    "use-sync-external-store/shim/with-selector.js": resolve(
-      shimsPath,
-      "use-sync-external-store-with-selector.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
   };
 }
@@ -196,68 +183,41 @@ export function createNodeShimAliases(
  * @param nodeModulesPath - Path to the app's node_modules
  * @param shimsPath - Path to the shims directory for use-sync-external-store
  */
-export function createZustandEsmPlugin(
-  nodeModulesPath: string,
-  shimsPath: string,
-): Plugin {
+export function createZustandEsmPlugin(nodeModulesPath: string, shimsPath: string): Plugin {
   const zustandEsmMap: Record<string, string> = {
-    zustand: resolve(nodeModulesPath, "zustand/esm/index.mjs"),
-    "zustand/vanilla": resolve(nodeModulesPath, "zustand/esm/vanilla.mjs"),
-    "zustand/middleware": resolve(
-      nodeModulesPath,
-      "zustand/esm/middleware.mjs",
-    ),
-    "zustand/middleware/immer": resolve(
-      nodeModulesPath,
-      "zustand/esm/middleware/immer.mjs",
-    ),
-    "zustand/shallow": resolve(nodeModulesPath, "zustand/esm/shallow.mjs"),
-    "zustand/vanilla/shallow": resolve(
-      nodeModulesPath,
-      "zustand/esm/vanilla/shallow.mjs",
-    ),
-    "zustand/react": resolve(nodeModulesPath, "zustand/esm/react.mjs"),
-    "zustand/react/shallow": resolve(
-      nodeModulesPath,
-      "zustand/esm/react/shallow.mjs",
-    ),
-    "zustand/traditional": resolve(
-      nodeModulesPath,
-      "zustand/esm/traditional.mjs",
-    ),
-    "use-sync-external-store/shim": resolve(
-      shimsPath,
-      "use-sync-external-store-shim.ts",
-    ),
-    "use-sync-external-store/shim/index": resolve(
-      shimsPath,
-      "use-sync-external-store-shim.ts",
-    ),
-    "use-sync-external-store/shim/index.js": resolve(
-      shimsPath,
-      "use-sync-external-store-shim.ts",
-    ),
-    "use-sync-external-store/with-selector": resolve(
+    zustand: resolve(nodeModulesPath, 'zustand/esm/index.mjs'),
+    'zustand/vanilla': resolve(nodeModulesPath, 'zustand/esm/vanilla.mjs'),
+    'zustand/middleware': resolve(nodeModulesPath, 'zustand/esm/middleware.mjs'),
+    'zustand/middleware/immer': resolve(nodeModulesPath, 'zustand/esm/middleware/immer.mjs'),
+    'zustand/shallow': resolve(nodeModulesPath, 'zustand/esm/shallow.mjs'),
+    'zustand/vanilla/shallow': resolve(nodeModulesPath, 'zustand/esm/vanilla/shallow.mjs'),
+    'zustand/react': resolve(nodeModulesPath, 'zustand/esm/react.mjs'),
+    'zustand/react/shallow': resolve(nodeModulesPath, 'zustand/esm/react/shallow.mjs'),
+    'zustand/traditional': resolve(nodeModulesPath, 'zustand/esm/traditional.mjs'),
+    'use-sync-external-store/shim': resolve(shimsPath, 'use-sync-external-store-shim.ts'),
+    'use-sync-external-store/shim/index': resolve(shimsPath, 'use-sync-external-store-shim.ts'),
+    'use-sync-external-store/shim/index.js': resolve(shimsPath, 'use-sync-external-store-shim.ts'),
+    'use-sync-external-store/with-selector': resolve(
       shimsPath,
-      "use-sync-external-store-with-selector.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
-    "use-sync-external-store/with-selector.js": resolve(
+    'use-sync-external-store/with-selector.js': resolve(
       shimsPath,
-      "use-sync-external-store-with-selector.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
-    "use-sync-external-store/shim/with-selector": resolve(
+    'use-sync-external-store/shim/with-selector': resolve(
       shimsPath,
-      "use-sync-external-store-with-selector.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
-    "use-sync-external-store/shim/with-selector.js": resolve(
+    'use-sync-external-store/shim/with-selector.js': resolve(
       shimsPath,
-      "use-sync-external-store-with-selector.ts",
+      'use-sync-external-store-with-selector.ts'
     ),
   };
 
   return {
-    name: "burdenoff:zustand-esm",
-    enforce: "pre",
+    name: 'burdenoff:zustand-esm',
+    enforce: 'pre',
     resolveId(source) {
       if (source in zustandEsmMap) {
         return zustandEsmMap[source];
@@ -273,39 +233,39 @@ export function createZustandEsmPlugin(
  */
 export function createManualChunks(id: string): string | undefined {
   if (
-    id.includes("node_modules/react-dom") ||
-    id.includes("node_modules/react/") ||
-    id.includes("node_modules/react-router") ||
-    id.includes("node_modules/react-error-boundary")
+    id.includes('node_modules/react-dom') ||
+    id.includes('node_modules/react/') ||
+    id.includes('node_modules/react-router') ||
+    id.includes('node_modules/react-error-boundary')
   ) {
-    return "vendor-react";
+    return 'vendor-react';
   }
   if (
-    id.includes("node_modules/@apollo/client") ||
-    id.includes("node_modules/graphql") ||
-    id.includes("node_modules/graphql-ws")
+    id.includes('node_modules/@apollo/client') ||
+    id.includes('node_modules/graphql') ||
+    id.includes('node_modules/graphql-ws')
   ) {
-    return "vendor-apollo";
+    return 'vendor-apollo';
   }
   if (
-    id.includes("node_modules/lucide-react") ||
-    id.includes("node_modules/sonner") ||
-    id.includes("node_modules/cmdk")
+    id.includes('node_modules/lucide-react') ||
+    id.includes('node_modules/sonner') ||
+    id.includes('node_modules/cmdk')
   ) {
-    return "vendor-ui";
+    return 'vendor-ui';
   }
-  if (id.includes("node_modules/@radix-ui")) {
-    return "vendor-radix";
+  if (id.includes('node_modules/@radix-ui')) {
+    return 'vendor-radix';
   }
   if (
-    id.includes("node_modules/react-hook-form") ||
-    id.includes("node_modules/@hookform") ||
-    id.includes("node_modules/zod")
+    id.includes('node_modules/react-hook-form') ||
+    id.includes('node_modules/@hookform') ||
+    id.includes('node_modules/zod')
   ) {
-    return "vendor-forms";
+    return 'vendor-forms';
   }
-  if (id.includes("node_modules/date-fns")) {
-    return "vendor-datefns";
+  if (id.includes('node_modules/date-fns')) {
+    return 'vendor-datefns';
   }
   return undefined;
 }

package/src/vite/shell.config.ts

@@ -24,20 +24,13 @@
  * ```
  */
 
-import { defineConfig, type UserConfig, type Plugin } from "vite";
-import react from "@vitejs/plugin-react";
-import tailwindcss from "@tailwindcss/vite";
-import { resolve, dirname } from "path";
-import { fileURLToPath } from "url";
-import {
-  type AppShellConfig,
-  STANDARD_WATCH_IGNORE,
-  APP_SHELL_PORT_MAP,
-} from "./types";
-import {
-  createContextualAliasPlugin,
-  createReactSingletonAliases,
-} from "./plugins";
+import { defineConfig, type UserConfig, type Plugin } from 'vite';
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { type AppShellConfig, STANDARD_WATCH_IGNORE, APP_SHELL_PORT_MAP } from './types';
+import { createContextualAliasPlugin, createReactSingletonAliases } from './plugins';
 
 /**
  * Creates a standardized Vite configuration for app shells.
@@ -46,22 +39,19 @@ import {
  * @param configPath - The path to the vite.config.ts file (use import.meta.url)
  * @returns Vite configuration object
  */
-export function createAppShellConfig(
-  config: AppShellConfig,
-  configPath: string,
-): UserConfig {
+export function createAppShellConfig(config: AppShellConfig, configPath: string): UserConfig {
   // Resolve __dirname from the config file path
   const __dirname =
-    typeof configPath === "string" && configPath.startsWith("file://")
+    typeof configPath === 'string' && configPath.startsWith('file://')
       ? dirname(fileURLToPath(configPath))
       : configPath;
 
   const {
     name,
     port = APP_SHELL_PORT_MAP[name] || 5200,
-    feLibsPath = "../../fe-libs/src",
+    feLibsPath = '../../fe-libs/src',
     microfrontends = [],
-    microfePath = "../../microfe",
+    microfePath = '../../microfe',
     additionalAliases = {},
     additionalPlugins = [],
     manualChunks = {},
@@ -70,16 +60,13 @@ export function createAppShellConfig(
 
   const resolvedFeLibsPath = resolve(__dirname, feLibsPath);
   const resolvedMicrofePath = resolve(__dirname, microfePath);
-  const srcPath = resolve(__dirname, "./src");
-  const nodeModulesPath = resolve(__dirname, "node_modules");
+  const srcPath = resolve(__dirname, './src');
+  const nodeModulesPath = resolve(__dirname, 'node_modules');
 
   // Build microfrontend path map for contextual alias resolution
   const microfePaths: Record<string, string> = {};
   microfrontends.forEach((mfe) => {
-    microfePaths[`microfe-${mfe}`] = resolve(
-      resolvedMicrofePath,
-      `microfe-${mfe}/src`,
-    );
+    microfePaths[`microfe-${mfe}`] = resolve(resolvedMicrofePath, `microfe-${mfe}/src`);
   });
 
   // Build microfrontend aliases
@@ -87,7 +74,7 @@ export function createAppShellConfig(
   microfrontends.forEach((mfe) => {
     microfeAliases[`@burdenoff/microfe-${mfe}`] = resolve(
       resolvedMicrofePath,
-      `microfe-${mfe}/src`,
+      `microfe-${mfe}/src`
     );
   });
 
@@ -104,9 +91,9 @@ export function createAppShellConfig(
 
   // Default manual chunks for optimal caching
   const defaultManualChunks: Record<string, string[]> = {
-    "vendor-react": ["react", "react-dom", "react-router-dom"],
-    "vendor-apollo": ["@apollo/client", "graphql"],
-    "vendor-ui": ["lucide-react", "zustand"],
+    'vendor-react': ['react', 'react-dom', 'react-router-dom'],
+    'vendor-apollo': ['@apollo/client', 'graphql'],
+    'vendor-ui': ['lucide-react', 'zustand'],
     ...manualChunks,
   };
 
@@ -118,21 +105,21 @@ export function createAppShellConfig(
       strictPort: true,
       headers: {
         // Required for OAuth popup flows and SharedArrayBuffer
-        "Cross-Origin-Opener-Policy": "same-origin-allow-popups",
-        "Cross-Origin-Embedder-Policy": "unsafe-none",
+        'Cross-Origin-Opener-Policy': 'same-origin-allow-popups',
+        'Cross-Origin-Embedder-Policy': 'unsafe-none',
       },
       watch: {
         ignored: [
           ...STANDARD_WATCH_IGNORE,
           // Ignore microfrontend dist outputs
-          "**/microfe/*/dist/**",
+          '**/microfe/*/dist/**',
         ],
       },
       // Allow serving files from linked packages
       fs: {
         allow: [
-          resolve(__dirname, ".."),
-          resolve(__dirname, "../.."),
+          resolve(__dirname, '..'),
+          resolve(__dirname, '../..'),
           resolvedFeLibsPath,
           resolvedMicrofePath,
         ],
@@ -141,7 +128,7 @@ export function createAppShellConfig(
 
     build: {
       // Target modern browsers
-      target: "es2022",
+      target: 'es2022',
 
       // Enable source maps for production debugging
       sourcemap: true,
@@ -156,9 +143,9 @@ export function createAppShellConfig(
           manualChunks: defaultManualChunks,
 
           // Consistent chunk naming for better caching
-          chunkFileNames: "chunks/[name]-[hash].js",
-          entryFileNames: "[name]-[hash].js",
-          assetFileNames: "assets/[name]-[hash].[ext]",
+          chunkFileNames: 'chunks/[name]-[hash].js',
+          entryFileNames: '[name]-[hash].js',
+          assetFileNames: 'assets/[name]-[hash].[ext]',
         },
       },
 
@@ -172,7 +159,7 @@ export function createAppShellConfig(
         ...createReactSingletonAliases(nodeModulesPath),
 
         // fe-libs source
-        "@burdenoff/fe-libs": resolvedFeLibsPath,
+        '@burdenoff/fe-libs': resolvedFeLibsPath,
 
         // Microfrontend sources
         ...microfeAliases,
@@ -183,47 +170,47 @@ export function createAppShellConfig(
 
       // Prevent duplicate dependencies in bundle
       dedupe: [
-        "react",
-        "react-dom",
-        "react-router-dom",
-        "@apollo/client",
-        "graphql",
-        "zustand",
-        "@tanstack/react-query",
+        'react',
+        'react-dom',
+        'react-router-dom',
+        '@apollo/client',
+        'graphql',
+        'zustand',
+        '@tanstack/react-query',
       ],
 
       // Ensure correct entry point resolution
-      mainFields: ["module", "main", "browser"],
-      conditions: ["import", "module", "default"],
+      mainFields: ['module', 'main', 'browser'],
+      conditions: ['import', 'module', 'default'],
     },
 
     // Vite 8 uses Oxc for transforms instead of esbuild
     oxc: {
       jsx: {
-        runtime: "automatic",
+        runtime: 'automatic',
       },
     },
 
     // Optimize dependencies for faster dev startup
     optimizeDeps: {
       include: [
-        "react",
-        "react-dom",
-        "react-dom/client",
-        "react/jsx-runtime",
-        "react/jsx-dev-runtime",
-        "react-router-dom",
-        "react-error-boundary",
-        "@apollo/client",
-        "@apollo/client/react",
-        "@apollo/client/link/context",
-        "@apollo/client/link/error",
-        "graphql",
-        "lucide-react",
-        "zustand",
-        "sonner",
-        "clsx",
-        "tailwind-merge",
+        'react',
+        'react-dom',
+        'react-dom/client',
+        'react/jsx-runtime',
+        'react/jsx-dev-runtime',
+        'react-router-dom',
+        'react-error-boundary',
+        '@apollo/client',
+        '@apollo/client/react',
+        '@apollo/client/link/context',
+        '@apollo/client/link/error',
+        'graphql',
+        'lucide-react',
+        'zustand',
+        'sonner',
+        'clsx',
+        'tailwind-merge',
         ...optimizeDepsInclude,
       ],
     },

package/src/vite/types.ts

@@ -5,7 +5,7 @@
  * @version Vite 8.0.0-beta.8+
  */
 
-import type { Plugin } from "vite";
+import type { Plugin } from 'vite';
 
 /**
  * Microfrontend configuration options
@@ -74,34 +74,34 @@ export interface AppShellConfig {
  */
 export const STANDARD_MFE_EXTERNALS = [
   // React ecosystem
-  "react",
-  "react-dom",
-  "react/jsx-runtime",
-  "react/jsx-dev-runtime",
-  "react-router-dom",
+  'react',
+  'react-dom',
+  'react/jsx-runtime',
+  'react/jsx-dev-runtime',
+  'react-router-dom',
 
   // Apollo Client
-  "@apollo/client",
-  "@apollo/client/react",
-  "@apollo/client/link/error",
-  "@apollo/client/link/retry",
-  "@apollo/client/link/context",
-  "@apollo/client/core",
-  "@apollo/client/cache",
-  "graphql",
+  '@apollo/client',
+  '@apollo/client/react',
+  '@apollo/client/link/error',
+  '@apollo/client/link/retry',
+  '@apollo/client/link/context',
+  '@apollo/client/core',
+  '@apollo/client/cache',
+  'graphql',
 
   // State management
-  "zustand",
-  "zustand/middleware",
+  'zustand',
+  'zustand/middleware',
 
   // React Query
-  "@tanstack/react-query",
+  '@tanstack/react-query',
 
   // Common UI
-  "lucide-react",
+  'lucide-react',
 
   // fe-libs (provided by app shell)
-  "@burdenoff/fe-libs",
+  '@burdenoff/fe-libs',
   /^@burdenoff\/fe-libs\/.*/,
 ] as const;
 
@@ -109,21 +109,21 @@ export const STANDARD_MFE_EXTERNALS = [
  * Standard watch ignore patterns
  */
 export const STANDARD_WATCH_IGNORE = [
-  "**/node_modules/**",
-  "**/dist/**",
-  "**/.git/**",
-  "**/coverage/**",
-  "**/.turbo/**",
-  "**/build/**",
-  "**/*.log",
-  "**/tmp/**",
-  "**/.cache/**",
-  "**/test-results/**",
-  "**/__snapshots__/**",
-  "**/.idea/**",
-  "**/.vscode/**",
-  "**/.DS_Store",
-  "**/Thumbs.db",
+  '**/node_modules/**',
+  '**/dist/**',
+  '**/.git/**',
+  '**/coverage/**',
+  '**/.turbo/**',
+  '**/build/**',
+  '**/*.log',
+  '**/tmp/**',
+  '**/.cache/**',
+  '**/test-results/**',
+  '**/__snapshots__/**',
+  '**/.idea/**',
+  '**/.vscode/**',
+  '**/.DS_Store',
+  '**/Thumbs.db',
 ] as const;
 
 /**