fusee-framework 2.7.0 → 2.7.2

package/framework/globals.js

@@ -0,0 +1,42 @@
+// ─── Opt-in Globals ───────────────────────────────────────────────────────────
+// `import 'fusee-framework/globals'` copies every fusée export onto globalThis, for code
+// that calls the API without imports (plain <script> tags, quick demos). Apps built with
+// Vite get auto-imports instead and should not load this: it keeps the whole framework
+// in the bundle, since bundlers can no longer drop unused modules.
+import * as signalModule from './core/signal.js'
+import * as resourceModule from './core/resource.js'
+import * as componentModule from './core/component.js'
+import * as elementModule from './core/element.js'
+import * as diModule from './core/di.js'
+import * as routerModule from './router/router.js'
+import * as fileRouterModule from './router/file-router.js'
+import * as compilerModule from './core/compiler.js'
+import * as composableModule from './core/composable.js'
+import * as storeModule from './core/store.js'
+import * as directivesModule from './core/directives.js'
+import * as reconcileModule from './core/reconcile.js'
+import * as actionsModule from './server/actions.js'
+import * as appRegistryModule from './core/app-registry.js'
+import * as pluginsModule from './core/plugins.js'
+import { emit } from './index.js'
+
+if (typeof globalThis !== 'undefined') {
+    Object.assign(globalThis, {
+        ...signalModule,
+        ...resourceModule,
+        ...componentModule,
+        ...elementModule,
+        ...diModule,
+        ...routerModule,
+        ...fileRouterModule,
+        ...compilerModule,
+        ...composableModule,
+        ...storeModule,
+        ...directivesModule,
+        ...reconcileModule,
+        ...actionsModule,
+        ...appRegistryModule,
+        ...pluginsModule,
+        emit
+    })
+}

package/framework/index.js

@@ -1,55 +1,22 @@
-// ─── Framework Public API ─────────────────────────────────────────────────────
-import * as signalModule from './core/signal.js'
-import * as resourceModule from './core/resource.js'
-import * as componentModule from './core/component.js'
-import * as elementModule from './core/element.js'
-import * as diModule from './core/di.js'
-import * as routerModule from './router/router.js'
-import * as fileRouterModule from './router/file-router.js'
-import * as compilerModule from './core/compiler.js'
-import * as composableModule from './core/composable.js'
-import * as storeModule from './core/store.js'
-import * as directivesModule from './core/directives.js'
-import * as reconcileModule from './core/reconcile.js'
-import * as actionsModule from './server/actions.js'
-import * as appRegistryModule from './core/app-registry.js'
-import * as pluginsModule from './core/plugins.js'
-
-export const emit = () => console.warn('[framework] emit() can only be used inside component setup()')
-
-export { signal, computed, effect, batch, untrack, inspect, watch, onCleanup, resource, createSuspense, scheduleAsyncJob } from './core/signal.js'
-export { defineResource } from './core/resource.js'
-export { defineComponent, defineAsyncComponent, onMount, onUnmount, parseSlots, provide, inject, getCurrentInstance } from './core/component.js'
-export { defineElement, toCustomElement, css, unsafeCSS } from './core/element.js'
-export { InjectionToken, provideGlobal } from './core/di.js'
-export { createRouter, navigate, mountOutlet, currentRoute, routeParams, routeQuery, matchedRoutes } from './router/router.js'
-export { generateRoutes } from './router/file-router.js'
-export { mountTemplate } from './core/compiler.js'
-export { defineComposable, assertSetupContext } from './core/composable.js'
-export { defineStore, resetStore, clearStores, registerStorePlugin, storeToRefs, storeToState, storeToGetters, useNestedStore, MutationType } from './core/store.js'
-export { directive } from './core/directives.js'
-export { reconcile } from './core/reconcile.js'
-export { defineAction, createActionProxy, useAction } from './server/actions.js'
-export { createApp } from './core/app-registry.js'
-export { defineCompilerPlugin, defineServerPlugin, defineDevToolsPlugin, defineRuntimeAdapter, defineFuseePlugin } from './core/plugins.js'
-
-if (typeof globalThis !== 'undefined') {
-    Object.assign(globalThis, {
-        ...signalModule,
-        ...resourceModule,
-        ...componentModule,
-        ...elementModule,
-        ...diModule,
-        ...routerModule,
-        ...fileRouterModule,
-        ...compilerModule,
-        ...composableModule,
-        ...storeModule,
-        ...directivesModule,
-        ...reconcileModule,
-        ...actionsModule,
-        ...appRegistryModule,
-        ...pluginsModule,
-        emit
-    })
-}
+// ─── Framework Public API ─────────────────────────────────────────────────────
+// Exports only, with no side effects, so bundlers keep just what an app uses.
+// To expose the API on globalThis instead, import 'fusee-framework/globals'.
+
+export const emit = () => console.warn('[framework] emit() can only be used inside component setup()')
+
+export { signal, computed, effect, batch, untrack, inspect, watch, onCleanup, resource, createSuspense, scheduleAsyncJob } from './core/signal.js'
+export { defineResource } from './core/resource.js'
+export { defineComponent } from './core/component.js'
+export { defineCompiledComponent, defineAsyncComponent, onMount, onUnmount, parseSlots, provide, inject, getCurrentInstance } from './core/component-core.js'
+export { defineElement, toCustomElement, css, unsafeCSS } from './core/element.js'
+export { InjectionToken, provideGlobal } from './core/di.js'
+export { createRouter, navigate, mountOutlet, currentRoute, routeParams, routeQuery, matchedRoutes } from './router/router.js'
+export { generateRoutes } from './router/file-router.js'
+export { mountTemplate } from './core/compiler.js'
+export { defineComposable, assertSetupContext } from './core/composable.js'
+export { defineStore, resetStore, clearStores, registerStorePlugin, storeToRefs, storeToState, storeToGetters, useNestedStore, MutationType } from './core/store.js'
+export { directive } from './core/directives.js'
+export { reconcile } from './core/reconcile.js'
+export { defineAction, createActionProxy, useAction } from './server/actions.js'
+export { createApp } from './core/app-registry.js'
+export { defineCompilerPlugin, defineServerPlugin, defineDevToolsPlugin, defineRuntimeAdapter, defineFuseePlugin } from './core/plugins.js'

package/framework/router/file-router.js

@@ -1,184 +1,184 @@
-import { defineAsyncComponent } from '../core/component.js';
-
-/** Builds a nested route tree from Vite-style page module glob results. */
-export function generateRoutes(globResults, options = {}) {
-    const entries = _parseGlobEntries(globResults, options);
-    const tree = _buildRouteTree(entries, false);
-    _sortRoutesRecursive(tree);
-    return tree;
-}
-
-/** Converts page module paths into normalized route entries and async components. */
-function _parseGlobEntries(globResults, options) {
-    const entries = [];
-
-    for (const filePath of Object.keys(globResults)) {
-        const loader = globResults[filePath];
-
-        let cleanPath = filePath
-            .replace(/^\.?\/?app\/pages\//, '')
-            .replace(/^\.?\/?pages\//, '')
-            .replace(/\.[jt]sx?$/, '');
-
-        const parts = cleanPath.split('/');
-        const rawFileName = parts.pop();
-        const rawDirSegments = parts;
-
-        const dirSegments = rawDirSegments.map(_transformSegment);
-        const fileName = _transformSegment(rawFileName);
-
-        const isIndex = rawFileName === 'index';
-        const isCatchAll = /^\[\.\.\./.test(rawFileName);
-
-        entries.push({
-            filePath,
-            loader,
-            dirSegments,
-            fileName,
-            isIndex,
-            isCatchAll,
-            component: defineAsyncComponent({
-                loader,
-                loadingComponent: options.loadingComponent
-            })
-        });
-    }
-
-    return entries;
-}
-
-/** Converts bracket-style page segments into router parameter or wildcard syntax. */
-function _transformSegment(seg) {
-    return seg
-        .replace(/\[\.\.\.([^\]]+)\]/g, '*')
-        .replace(/\[([^\]]+)\]/g, ':$1');
-}
-
-/** Groups route entries by directory and promotes matching files to layouts. */
-function _buildRouteTree(entries, isChild) {
-    const filesHere = new Map();
-    const grouped = new Map();
-
-    for (const entry of entries) {
-        if (entry.dirSegments.length === 0) {
-            filesHere.set(entry.fileName, entry);
-        } else {
-            const firstDir = entry.dirSegments[0];
-            if (!grouped.has(firstDir)) grouped.set(firstDir, []);
-            grouped.get(firstDir).push(entry);
-        }
-    }
-
-    let rootLayoutEntry = null;
-    if (filesHere.has('_layout')) {
-        rootLayoutEntry = filesHere.get('_layout');
-        filesHere.delete('_layout');
-    }
-
-    const routes = [];
-    const usedAsLayout = new Set();
-
-    for (const [dirName, dirEntries] of grouped) {
-        const layoutEntry = filesHere.get(dirName);
-
-        if (layoutEntry) {
-            usedAsLayout.add(dirName);
-
-            const childEntries = dirEntries.map(e => ({
-                ...e,
-                dirSegments: e.dirSegments.slice(1)
-            }));
-
-            const children = _buildRouteTree(childEntries, true);
-
-            routes.push({
-                path: isChild ? dirName : '/' + dirName,
-                component: layoutEntry.component,
-                children
-            });
-        } else {
-            for (const entry of dirEntries) {
-                const segments = [...entry.dirSegments];
-                if (!entry.isIndex) segments.push(entry.fileName);
-
-                const routePath = isChild
-                    ? segments.join('/')
-                    : '/' + segments.join('/');
-
-                routes.push({
-                    path: routePath,
-                    component: entry.component
-                });
-            }
-        }
-    }
-
-    for (const [name, entry] of filesHere) {
-        if (usedAsLayout.has(name)) continue;
-
-        if (entry.isIndex) {
-            routes.push({ path: isChild ? '' : '/', component: entry.component });
-        } else if (entry.isCatchAll || name === '*') {
-            routes.push({ path: '*', component: entry.component });
-        } else {
-            routes.push({
-                path: isChild ? name : '/' + name,
-                component: entry.component
-            });
-        }
-    }
-
-    if (rootLayoutEntry) {
-        return [{
-            path: '',
-            component: rootLayoutEntry.component,
-            children: routes
-        }];
-    }
-
-    return routes;
-}
-
-/** Sorts every route level from most specific to least specific. */
-function _sortRoutesRecursive(routes) {
-    routes.sort(_compareRoutes);
-    for (const route of routes) {
-        if (route.children) _sortRoutesRecursive(route.children);
-    }
-}
-
-/** Normalizes a route path into an array for comparison. */
-function _getPathArray(path) {
-    return Array.isArray(path) ? path : [path];
-}
-
-/** Orders static, layout, dynamic, and wildcard routes deterministically. */
-function _compareRoutes(a, b) {
-    const aPaths = _getPathArray(a.path);
-    const bPaths = _getPathArray(b.path);
-    
-    const aPath = aPaths[0];
-    const bPath = bPaths[0];
-    
-    if (aPath === '*' && bPath !== '*') return 1;
-    if (aPath !== '*' && bPath === '*') return -1;
-
-    const aWild = aPath.endsWith('/*');
-    const bWild = bPath.endsWith('/*');
-    if (aWild && !bWild) return 1;
-    if (!aWild && bWild) return -1;
-
-    const aDynamic = aPath.includes(':');
-    const bDynamic = bPath.includes(':');
-    if (aDynamic && !bDynamic) return 1;
-    if (!aDynamic && bDynamic) return -1;
-
-    if (a.children && !b.children) return -1;
-    if (!a.children && b.children) return 1;
-
-    const aSegs = aPath.split('/').filter(Boolean).length;
-    const bSegs = bPath.split('/').filter(Boolean).length;
-    if (aSegs !== bSegs) return bSegs - aSegs;
-
-    return aPath.localeCompare(bPath);
-}
+import { defineAsyncComponent } from '../core/component-core.js';
+
+/** Builds a nested route tree from Vite-style page module glob results. */
+export function generateRoutes(globResults, options = {}) {
+    const entries = _parseGlobEntries(globResults, options);
+    const tree = _buildRouteTree(entries, false);
+    _sortRoutesRecursive(tree);
+    return tree;
+}
+
+/** Converts page module paths into normalized route entries and async components. */
+function _parseGlobEntries(globResults, options) {
+    const entries = [];
+
+    for (const filePath of Object.keys(globResults)) {
+        const loader = globResults[filePath];
+
+        let cleanPath = filePath
+            .replace(/^\.?\/?app\/pages\//, '')
+            .replace(/^\.?\/?pages\//, '')
+            .replace(/\.[jt]sx?$/, '');
+
+        const parts = cleanPath.split('/');
+        const rawFileName = parts.pop();
+        const rawDirSegments = parts;
+
+        const dirSegments = rawDirSegments.map(_transformSegment);
+        const fileName = _transformSegment(rawFileName);
+
+        const isIndex = rawFileName === 'index';
+        const isCatchAll = /^\[\.\.\./.test(rawFileName);
+
+        entries.push({
+            filePath,
+            loader,
+            dirSegments,
+            fileName,
+            isIndex,
+            isCatchAll,
+            component: defineAsyncComponent({
+                loader,
+                loadingComponent: options.loadingComponent
+            })
+        });
+    }
+
+    return entries;
+}
+
+/** Converts bracket-style page segments into router parameter or wildcard syntax. */
+function _transformSegment(seg) {
+    return seg
+        .replace(/\[\.\.\.([^\]]+)\]/g, '*')
+        .replace(/\[([^\]]+)\]/g, ':$1');
+}
+
+/** Groups route entries by directory and promotes matching files to layouts. */
+function _buildRouteTree(entries, isChild) {
+    const filesHere = new Map();
+    const grouped = new Map();
+
+    for (const entry of entries) {
+        if (entry.dirSegments.length === 0) {
+            filesHere.set(entry.fileName, entry);
+        } else {
+            const firstDir = entry.dirSegments[0];
+            if (!grouped.has(firstDir)) grouped.set(firstDir, []);
+            grouped.get(firstDir).push(entry);
+        }
+    }
+
+    let rootLayoutEntry = null;
+    if (filesHere.has('_layout')) {
+        rootLayoutEntry = filesHere.get('_layout');
+        filesHere.delete('_layout');
+    }
+
+    const routes = [];
+    const usedAsLayout = new Set();
+
+    for (const [dirName, dirEntries] of grouped) {
+        const layoutEntry = filesHere.get(dirName);
+
+        if (layoutEntry) {
+            usedAsLayout.add(dirName);
+
+            const childEntries = dirEntries.map(e => ({
+                ...e,
+                dirSegments: e.dirSegments.slice(1)
+            }));
+
+            const children = _buildRouteTree(childEntries, true);
+
+            routes.push({
+                path: isChild ? dirName : '/' + dirName,
+                component: layoutEntry.component,
+                children
+            });
+        } else {
+            for (const entry of dirEntries) {
+                const segments = [...entry.dirSegments];
+                if (!entry.isIndex) segments.push(entry.fileName);
+
+                const routePath = isChild
+                    ? segments.join('/')
+                    : '/' + segments.join('/');
+
+                routes.push({
+                    path: routePath,
+                    component: entry.component
+                });
+            }
+        }
+    }
+
+    for (const [name, entry] of filesHere) {
+        if (usedAsLayout.has(name)) continue;
+
+        if (entry.isIndex) {
+            routes.push({ path: isChild ? '' : '/', component: entry.component });
+        } else if (entry.isCatchAll || name === '*') {
+            routes.push({ path: '*', component: entry.component });
+        } else {
+            routes.push({
+                path: isChild ? name : '/' + name,
+                component: entry.component
+            });
+        }
+    }
+
+    if (rootLayoutEntry) {
+        return [{
+            path: '',
+            component: rootLayoutEntry.component,
+            children: routes
+        }];
+    }
+
+    return routes;
+}
+
+/** Sorts every route level from most specific to least specific. */
+function _sortRoutesRecursive(routes) {
+    routes.sort(_compareRoutes);
+    for (const route of routes) {
+        if (route.children) _sortRoutesRecursive(route.children);
+    }
+}
+
+/** Normalizes a route path into an array for comparison. */
+function _getPathArray(path) {
+    return Array.isArray(path) ? path : [path];
+}
+
+/** Orders static, layout, dynamic, and wildcard routes deterministically. */
+function _compareRoutes(a, b) {
+    const aPaths = _getPathArray(a.path);
+    const bPaths = _getPathArray(b.path);
+    
+    const aPath = aPaths[0];
+    const bPath = bPaths[0];
+    
+    if (aPath === '*' && bPath !== '*') return 1;
+    if (aPath !== '*' && bPath === '*') return -1;
+
+    const aWild = aPath.endsWith('/*');
+    const bWild = bPath.endsWith('/*');
+    if (aWild && !bWild) return 1;
+    if (!aWild && bWild) return -1;
+
+    const aDynamic = aPath.includes(':');
+    const bDynamic = bPath.includes(':');
+    if (aDynamic && !bDynamic) return 1;
+    if (!aDynamic && bDynamic) return -1;
+
+    if (a.children && !b.children) return -1;
+    if (!a.children && b.children) return 1;
+
+    const aSegs = aPath.split('/').filter(Boolean).length;
+    const bSegs = bPath.split('/').filter(Boolean).length;
+    if (aSegs !== bSegs) return bSegs - aSegs;
+
+    return aPath.localeCompare(bPath);
+}