@gracile/engine 0.9.0-next.5 → 0.9.0-next.7

package/dist/dev/development.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/dev/development.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAEN,KAAK,cAAc,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,wBAAsB,wBAAwB,CAAC,EAC9C,MAAM,EACN,IAAI,EACJ,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,OAAO,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;CACvB,CAAC,CAgDD"}
+{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/dev/development.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAEN,KAAK,cAAc,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,wBAAsB,wBAAwB,CAAC,EAC9C,MAAM,EACN,IAAI,EACJ,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC7B,GAAG,OAAO,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;CACvB,CAAC,CAqDD"}

package/dist/dev/development.js

@@ -10,7 +10,7 @@ export async function createDevelopmentHandler({ routes, vite, gracileConfig, })
     logger.info('');
     logger.info(c.dim('Creating the request handler…'), { timestamp: true });
     const collectAndCodegen = async () => {
-        await collectRoutes(routes, root, gracileConfig.routes?.exclude);
+        await collectRoutes(routes, root, gracileConfig.routes?.exclude, gracileConfig.trailingSlash);
         if (gracileConfig.experimental?.generateRoutesTypings)
             await generateRoutesTypings(root, routes).catch((error) => logger.error(String(error)));
     };

package/dist/dev/ssr-ce-tracker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Server-side Custom Elements registry tracker for dev HMR.
+ *
+ * Wraps the Lit SSR DOM shim's `customElements` so orphaned CEs
+ * can be blocked when their import is removed during development.
+ *
+ * @internal — dev-only, never runs in production builds.
+ */
+export declare function installCeTracker(): void;
+/**
+ * Block all CEs registered by a given module.
+ * They will be unblocked if the module is re-evaluated and calls define() again.
+ */
+export declare function blockCesForModule(moduleId: string): void;
+/** Check whether a module has registered any CEs. */
+export declare function hasCeRegistrations(moduleId: string): boolean;
+/**
+ * Reset tracking state.
+ * @param full - Also reset installation state (for test suite teardown
+ *   so a subsequent `installCeTracker` call takes effect).
+ */
+export declare function resetCeTracker(full?: boolean): void;
+/** Read-only view of currently blocked tags. For test assertions. */
+export declare function getBlockedTags(): ReadonlySet<string>;
+/** Read-only view of module → tag-names mappings. For test assertions. */
+export declare function getModuleToTags(): ReadonlyMap<string, ReadonlySet<string>>;
+//# sourceMappingURL=ssr-ce-tracker.d.ts.map

package/dist/dev/ssr-ce-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-ce-tracker.d.ts","sourceRoot":"","sources":["../../src/dev/ssr-ce-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwDH,wBAAgB,gBAAgB,SA+B/B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,QAMjD;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,UAAQ,QAK1C;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC,CAEpD;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAE1E"}

package/dist/dev/ssr-ce-tracker.js

@@ -0,0 +1,113 @@
+/**
+ * Server-side Custom Elements registry tracker for dev HMR.
+ *
+ * Wraps the Lit SSR DOM shim's `customElements` so orphaned CEs
+ * can be blocked when their import is removed during development.
+ *
+ * @internal — dev-only, never runs in production builds.
+ */
+// ── Tracking state ──────────────────────────────────────────────────
+/** module ID → tag names that module registered */
+const moduleToTags = new Map();
+/** Tags blocked from registry lookup (orphaned modules) */
+const blocked = new Set();
+/** Which module is currently being evaluated (set by transform-injected code) */
+let currentModuleId = null;
+let installed = false;
+// ── Registry wrapper ────────────────────────────────────────────────
+function wrapRegistry(registry) {
+    const origDefine = registry.define.bind(registry);
+    const origGet = registry.get.bind(registry);
+    registry.define = function (name, ctor, options) {
+        // If re-registered after being blocked, unblock.
+        blocked.delete(name);
+        if (currentModuleId) {
+            let tags = moduleToTags.get(currentModuleId);
+            if (!tags) {
+                tags = new Set();
+                moduleToTags.set(currentModuleId, tags);
+            }
+            tags.add(name);
+        }
+        try {
+            origDefine(name, ctor, options);
+        }
+        catch {
+            // Already defined — expected during HMR re-evaluation.
+        }
+    };
+    registry.get = function (name) {
+        if (blocked.has(name))
+            return;
+        return origGet(name);
+    };
+}
+// ── Public API ──────────────────────────────────────────────────────
+export function installCeTracker() {
+    if (installed)
+        return;
+    installed = true;
+    if (globalThis.customElements) {
+        wrapRegistry(globalThis.customElements);
+    }
+    else {
+        // Shim not yet installed — intercept the assignment so we can
+        // wrap it the moment Lit SSR's DOM shim sets it up.
+        let _ce;
+        Object.defineProperty(globalThis, 'customElements', {
+            get: () => _ce,
+            set(value) {
+                _ce = value;
+                wrapRegistry(value);
+            },
+            configurable: true,
+            enumerable: true,
+        });
+    }
+    // Expose for transform-injected code.
+    // Runs in the same process via Vite's ssrLoadModule.
+    globalThis['__gracile_ce_tracker'] = {
+        setModule(id) {
+            currentModuleId = id;
+        },
+        clearModule() {
+            currentModuleId = null;
+        },
+    };
+}
+/**
+ * Block all CEs registered by a given module.
+ * They will be unblocked if the module is re-evaluated and calls define() again.
+ */
+export function blockCesForModule(moduleId) {
+    const tags = moduleToTags.get(moduleId);
+    if (!tags)
+        return;
+    for (const tag of tags) {
+        blocked.add(tag);
+    }
+}
+/** Check whether a module has registered any CEs. */
+export function hasCeRegistrations(moduleId) {
+    return moduleToTags.has(moduleId);
+}
+/**
+ * Reset tracking state.
+ * @param full - Also reset installation state (for test suite teardown
+ *   so a subsequent `installCeTracker` call takes effect).
+ */
+export function resetCeTracker(full = false) {
+    moduleToTags.clear();
+    blocked.clear();
+    currentModuleId = null;
+    if (full)
+        installed = false;
+}
+/** Read-only view of currently blocked tags. For test assertions. */
+export function getBlockedTags() {
+    return blocked;
+}
+/** Read-only view of module → tag-names mappings. For test assertions. */
+export function getModuleToTags() {
+    return moduleToTags;
+}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AActD;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,OAAO,GAAI,SAAS,aAAa,KAAG,GAAG,EAiEnD,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAetD;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,OAAO,GAAI,SAAS,aAAa,KAAG,GAAG,EAoEnD,CAAC;AAEF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugin.js

@@ -7,6 +7,7 @@ import { createPluginSharedState } from './vite/plugin-shared-state.js';
 import { gracileServePlugin } from './vite/plugin-serve.js';
 import { gracileClientBuildPlugin } from './vite/plugin-client-build.js';
 import { gracileCollectClientAssetsPlugin, gracileServerBuildPlugin, } from './vite/plugin-server-build.js';
+import { gracileCETrackerPlugin } from './vite/plugin-ce-tracker.js';
 let isClientBuilt = false;
 /**
  * The main Vite plugin for loading the Gracile framework.
@@ -53,6 +54,8 @@ export const gracile = (config) => {
                     sharedPluginContext.litSsrRenderInfo;
             },
         },
+        // MARK: 1.5. CE registry tracker (dev HMR cleanup)
+        gracileCETrackerPlugin(),
         // MARK: 2. HMR SSR reload
         hmrSsrReload(),
         // MARK: 3. Dev serve middleware

package/dist/render/route-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-template.d.ts","sourceRoot":"","sources":["../../src/render/route-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAO1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAa7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEhF,wBAAsB,mBAAmB,CAAC,EACzC,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,OAAO,EACP,UAAU,GACV,EAAE;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CAC7C,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC,CAwJhE"}
+{"version":3,"file":"route-template.d.ts","sourceRoot":"","sources":["../../src/render/route-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIvC,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAOxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAO1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAa7C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEhF,wBAAsB,mBAAmB,CAAC,EACzC,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,OAAO,EACP,UAAU,GACV,EAAE;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CAC7C,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IAAC,QAAQ,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC,CA4JhE"}

package/dist/render/route-template.js

@@ -32,6 +32,9 @@ export async function renderRouteTemplate({ url, vite, mode, routeInfos, routeAs
             });
         const fragmentRender = renderLitSsr(fragmentOutput, mergedRenderInfo);
         const output = Readable.from(fragmentRender);
+        // TODO: Disabled for now. Causes issue in static renders.
+        // Needs investigations.
+        // const output = new RenderResultReadable(fragmentRender);
         return { output, document: null };
     }
     // MARK: Document
@@ -87,7 +90,8 @@ export async function renderRouteTemplate({ url, vite, mode, routeInfos, routeAs
         const routeOutput = await Promise.resolve(routeInfos.routeModule.template(context));
         if (assert.isLitTemplate(routeOutput) === false)
             throw new Error(`Wrong template result for page template ${routeInfos.foundRoute.filePath}.`);
-        const renderStream = Readable.from(renderLitSsr(routeOutput, mergedRenderInfo));
+        const renderStream = 
+        /* TODO: Use `new RenderResultReadable` */ Readable.from(renderLitSsr(routeOutput, mergedRenderInfo));
         const output = Readable.from(concatStreams(baseDocumentRenderStreamPre, renderStream, baseDocumentRenderStreamPost));
         return { output, document: baseDocumentHtml };
     }

package/dist/routes/collect.d.ts

@@ -1,8 +1,8 @@
 import type * as R from './route.js';
 /** @internal Exported for unit testing. */
-export declare function extractRoutePatterns(routeFilePath: string): Pick<R.Route, 'pattern' | 'hasParams'> & {
+export declare function extractRoutePatterns(routeFilePath: string, trailingSlash?: 'always' | 'never' | 'ignore'): Pick<R.Route, 'pattern' | 'hasParams'> & {
     patternString: string;
 };
 export declare const WATCHED_FILES_REGEX: RegExp;
-export declare function collectRoutes(routes: R.RoutesManifest, root: string, excludePatterns?: string[]): Promise<void>;
+export declare function collectRoutes(routes: R.RoutesManifest, root: string, excludePatterns?: string[], trailingSlash?: 'always' | 'never' | 'ignore'): Promise<void>;
 //# sourceMappingURL=collect.d.ts.map

package/dist/routes/collect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/routes/collect.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,KAAK,CAAC,MAAM,YAAY,CAAC;AAIrC,2CAA2C;AAC3C,wBAAgB,oBAAoB,CACnC,aAAa,EAAE,MAAM,GACnB,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAkDpE;AAED,eAAO,MAAM,mBAAmB,QAC4C,CAAC;AAE7E,wBAAsB,aAAa,CAClC,MAAM,EAAE,CAAC,CAAC,cAAc,EACxB,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,MAAM,EAAO,GAC5B,OAAO,CAAC,IAAI,CAAC,CAiGf"}
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/routes/collect.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,KAAK,CAAC,MAAM,YAAY,CAAC;AAIrC,2CAA2C;AAC3C,wBAAgB,oBAAoB,CACnC,aAAa,EAAE,MAAM,EACrB,aAAa,GAAE,QAAQ,GAAG,OAAO,GAAG,QAAmB,GACrD,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAmDpE;AAED,eAAO,MAAM,mBAAmB,QAC4C,CAAC;AAE7E,wBAAsB,aAAa,CAClC,MAAM,EAAE,CAAC,CAAC,cAAc,EACxB,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,MAAM,EAAO,EAC9B,aAAa,GAAE,QAAQ,GAAG,OAAO,GAAG,QAAmB,GACrD,OAAO,CAAC,IAAI,CAAC,CAiGf"}

package/dist/routes/collect.js

@@ -5,7 +5,7 @@ import { fdir as Fdir } from 'fdir';
 import c from 'picocolors';
 // eslint-disable-next-line import-x/order
 import { URLPattern as URLPatternPolyfill } from 'urlpattern-polyfill/urlpattern';
-// NOTE: The polyfill type lacks `hasRegExpGroups` from the global URLPattern.
+// HACK: The polyfill type lacks `hasRegExpGroups` from the global URLPattern.
 const URLPattern = URLPatternPolyfill;
 import { createFilter } from 'vite';
 import { emptyRoutes } from '../logging/messages.js';
@@ -13,7 +13,7 @@ import { prepareSortableRoutes, routeComparator } from './comparator.js';
 import { REGEXES } from './load-module.js';
 const logger = getLogger();
 /** @internal Exported for unit testing. */
-export function extractRoutePatterns(routeFilePath) {
+export function extractRoutePatterns(routeFilePath, trailingSlash = 'ignore') {
     const routePathname = routeFilePath.replace(/\.(js|ts|jsx|tsx|html)$/, '');
     let pathParts = routePathname.split(paths.isWindows() ? paths.WINDOWS_PATH_SEPARATOR : '/');
     const last = pathParts.at(-1);
@@ -42,8 +42,9 @@ export function extractRoutePatterns(routeFilePath) {
         }
         return entry;
     });
-    const trailingSlash = pathRelativeNormalized.length > 0 ? '/' : '';
-    const normalizedUrlPattern = `/${pathRelativeNormalized.join('/')}${trailingSlash}`;
+    const isRoot = pathRelativeNormalized.length === 0;
+    const slash = isRoot || trailingSlash === 'never' ? '' : '/';
+    const normalizedUrlPattern = `/${pathRelativeNormalized.join('/')}${slash}`;
     return {
         patternString: normalizedUrlPattern,
         pattern: new URLPattern(normalizedUrlPattern, 'http://gracile/'),
@@ -51,7 +52,7 @@ export function extractRoutePatterns(routeFilePath) {
     };
 }
 export const WATCHED_FILES_REGEX = /\/src\/routes\/(.*)\.(js|ts|jsx|tsx|html|css|scss|sass|less|styl|stylus)$/;
-export async function collectRoutes(routes, root, excludePatterns = []) {
+export async function collectRoutes(routes, root, excludePatterns = [], trailingSlash = 'ignore') {
     routes.clear();
     const routesFolder = 'src/routes';
     const routesFolderAbsolute = join(root, routesFolder);
@@ -105,7 +106,7 @@ export async function collectRoutes(routes, root, excludePatterns = []) {
     // MARK: Associate
     for (const routePath of serverEntrypointsSorted) {
         const filePath = join(routesFolder, routePath);
-        const routeWithPatterns = extractRoutePatterns(routePath);
+        const routeWithPatterns = extractRoutePatterns(routePath, trailingSlash);
         routes.set(routeWithPatterns.patternString, {
             filePath,
             pattern: routeWithPatterns.pattern,

package/dist/routes/match.d.ts

@@ -7,8 +7,11 @@ type MatchedRoute = {
     params: Parameters_;
     pathname: string;
 };
+export type TrailingSlashRedirect = {
+    redirect: string;
+};
 /** @internal Exported for unit testing. */
-export declare function matchRouteFromUrl(url: string, routes: R.RoutesManifest): MatchedRoute | null;
+export declare function matchRouteFromUrl(url: string, routes: R.RoutesManifest, trailingSlash?: 'always' | 'never' | 'ignore'): MatchedRoute | TrailingSlashRedirect | null;
 type ExtractedStaticPaths = {
     staticPaths: R.StaticPathOptionsGeneric[];
     props: unknown;
@@ -39,6 +42,7 @@ export declare function getRoute(options: {
     vite?: ViteDevServer | undefined;
     routes: R.RoutesManifest;
     routeImports?: R.RoutesImports | undefined;
-}): Promise<RouteInfos | null>;
+    trailingSlash?: 'always' | 'never' | 'ignore';
+}): Promise<RouteInfos | TrailingSlashRedirect | null>;
 export {};
 //# sourceMappingURL=match.d.ts.map

package/dist/routes/match.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/routes/match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,KAAK,CAAC,MAAM,YAAY,CAAC;AAErC,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEtD,KAAK,YAAY,GAAG;IACnB,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,CAAC,cAAc,GACtB,YAAY,GAAG,IAAI,CAuBrB;AAED,KAAK,oBAAoB,GAAG;IAC3B,WAAW,EAAE,CAAC,CAAC,wBAAwB,EAAE,CAAC;IAC1C,KAAK,EAAE,OAAO,CAAC;CACf,GAAG,IAAI,CAAC;AACT;;;;;;GAMG;AACH,2CAA2C;AAC3C,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IACjD,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6BhC;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6B7B"}
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../src/routes/match.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,KAAK,CAAC,MAAM,YAAY,CAAC;AAErC,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEtD,KAAK,YAAY,GAAG;IACnB,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,CAAC,cAAc,EACxB,aAAa,GAAE,QAAQ,GAAG,OAAO,GAAG,QAAmB,GACrD,YAAY,GAAG,qBAAqB,GAAG,IAAI,CAyC7C;AAED,KAAK,oBAAoB,GAAG;IAC3B,WAAW,EAAE,CAAC,CAAC,wBAAwB,EAAE,CAAC;IAC1C,KAAK,EAAE,OAAO,CAAC;CACf,GAAG,IAAI,CAAC;AACT;;;;;;GAMG;AACH,2CAA2C;AAC3C,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IACjD,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6BhC;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC;IAC3C,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;CAC9C,GAAG,OAAO,CAAC,UAAU,GAAG,qBAAqB,GAAG,IAAI,CAAC,CAkCrD"}

package/dist/routes/match.js

@@ -1,9 +1,23 @@
 import { loadForeignRouteObject } from './load-module.js';
 /** @internal Exported for unit testing. */
-export function matchRouteFromUrl(url, routes) {
+export function matchRouteFromUrl(url, routes, trailingSlash = 'ignore') {
     let match;
     let foundRoute;
-    const pathname = new URL(url).pathname;
+    const rawPathname = new URL(url).pathname;
+    // Handle redirect cases for 'always' and 'never' before matching.
+    // Root '/' is exempt — it always keeps its slash.
+    if (rawPathname !== '/') {
+        if (trailingSlash === 'always' && !rawPathname.endsWith('/'))
+            return { redirect: rawPathname + '/' };
+        if (trailingSlash === 'never' && rawPathname.endsWith('/'))
+            return { redirect: rawPathname.slice(0, -1) };
+    }
+    // For 'ignore', normalize to trailing-slash so it matches stored patterns.
+    const pathname = trailingSlash === 'ignore' &&
+        rawPathname !== '/' &&
+        !rawPathname.endsWith('/')
+        ? rawPathname + '/'
+        : rawPathname;
     for (const [, route] of routes) {
         if (match)
             break;
@@ -49,8 +63,10 @@ export async function extractStaticPaths(options) {
     return { staticPaths, props: properties };
 }
 export async function getRoute(options) {
-    const matchedRoute = matchRouteFromUrl(options.url, options.routes);
+    const matchedRoute = matchRouteFromUrl(options.url, options.routes, options.trailingSlash);
     if (!matchedRoute)
+        return null;
+    if ('redirect' in matchedRoute)
         return matchedRoute;
     const { foundRoute, pathname, params } = matchedRoute;
     const routeModule = await loadForeignRouteObject({

package/dist/routes/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/routes/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IAEF,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAcD,wBAAsB,YAAY,CAAC,EAClC,MAAM,EACN,IAAI,EACJ,UAAU,EACV,IAAoB,EACpB,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,aAAa,CAAC;CAC7B;;;GAmKA"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/routes/render.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,MAAM,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IAEF,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAwBD,wBAAsB,YAAY,CAAC,EAClC,MAAM,EACN,IAAI,EACJ,UAAU,EACV,IAAoB,EACpB,aAAa,GACb,EAAE;IACF,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,aAAa,CAAC;CAC7B;;;GAwKA"}

package/dist/routes/render.js

@@ -8,11 +8,18 @@ import { loadForeignRouteObject } from './load-module.js';
 async function streamToString(stream) {
     const chunks = [];
     for await (const chunk of stream) {
+        // NOTE: Since using Lit's `RenderResultReadable` instead of pure
+        // Node Readable, the chunk can be a string or a Buffer.
+        // If it's a string, convert it to Buffer first.
         if (typeof chunk === 'string') {
             chunks.push(Buffer.from(chunk));
         }
         else
-            throw new TypeError('Wrong buffer');
+            throw new TypeError('Wrong buffer type from stream. Should be a `string` only.');
+        // NOTE: Disabled for now. Causes issues with `RenderResultReadable`.
+        /* else {
+            chunks.push(chunk);
+        } */
     }
     return Buffer.concat(chunks).toString('utf8');
 }
@@ -20,7 +27,7 @@ export async function renderRoutes({ routes, vite, serverMode, root = process.cw
     const logger = getLogger();
     logger.info(c.green('Rendering routes…'), { timestamp: true });
     // MARK: Collect
-    await collectRoutes(routes, root, gracileConfig.routes?.exclude);
+    await collectRoutes(routes, root, gracileConfig.routes?.exclude, gracileConfig.trailingSlash);
     const renderedRoutes = [];
     // MARK: Iterate modules
     await Promise.all([...routes].map(async ([patternString, route]) => {

package/dist/server/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/server/request.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAOlD,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,KAAK,aAAa,EAOlB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,OAAO,KACZ,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,wBAAgB,oBAAoB,CAAC,EACpC,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,UAAU,EACV,aAAa,GACb,EAAE;IACF,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC;IAC3C,WAAW,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;CAC7B,kBAoHA;AAyBD,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,UAAU,GACV,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/server/request.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAOlD,OAAO,KAAK,KAAK,CAAC,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,KAAK,aAAa,EAOlB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,OAAO,KACZ,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,wBAAgB,oBAAoB,CAAC,EACpC,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,UAAU,EACV,aAAa,GACb,EAAE;IACF,IAAI,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC;IAC3C,WAAW,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;CAC7B,kBAuIA;AAyBD,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,UAAU,GACV,MAAM,uBAAuB,CAAC"}

package/dist/server/request.js

@@ -25,14 +25,31 @@ export function createGracileHandler({ vite, routes, routeImports, routeAssets,
                 vite,
                 routes,
                 routeImports,
+                trailingSlash: gracileConfig.trailingSlash ?? 'ignore',
             };
             const responseInit = {};
-            let routeInfos = await getRoute(routeOptions);
+            const routeResult = await getRoute(routeOptions);
+            // Trailing slash redirect (301 for GET, 308 for other methods)
+            if (routeResult && 'redirect' in routeResult) {
+                const redirectUrl = new URL(routeResult.redirect, fullUrl).href;
+                const status = method === 'GET' ? 301 : 308;
+                return { response: Response.redirect(redirectUrl, status) };
+            }
+            let routeInfos = routeResult;
             if (routeInfos === null) {
                 responseInit.status = 404;
+                // Use 'ignore' for the internal 404 lookup to avoid redirect loops.
                 const url = new URL('/404/', fullUrl).href;
-                const options = { ...routeOptions, url };
-                routeInfos = await getRoute(options);
+                const options = {
+                    ...routeOptions,
+                    url,
+                    trailingSlash: 'ignore',
+                };
+                const notFoundResult = await getRoute(options);
+                routeInfos =
+                    notFoundResult && !('redirect' in notFoundResult)
+                        ? notFoundResult
+                        : null;
             }
             if (routeInfos === null) {
                 const page = builtIn404Page(new URL(fullUrl).pathname, Boolean(vite));

package/dist/user-config.d.ts

@@ -38,6 +38,19 @@ export interface GracileConfig {
      * @defaultValue 'static'
      */
     output?: 'static' | 'server';
+    /**
+     * Controls how trailing slashes are matched on incoming URLs.
+     *
+     * - `'ignore'` — Match regardless of whether a trailing `/` is present.
+     *   `/about` and `/about/` both resolve to the same route. *(default)*
+     * - `'always'` — Only match URLs that include a trailing slash (e.g. `/about/`).
+     *   Requests without one are redirected: `301` for GET, `308` for other methods.
+     * - `'never'` — Only match URLs that do not include a trailing slash (e.g. `/about`).
+     *   Requests with one are redirected: `301` for GET, `308` for other methods.
+     *
+     * @defaultValue 'ignore'
+     */
+    trailingSlash?: 'always' | 'never' | 'ignore';
     /**
      * Settings for the development mode.
      */

package/dist/user-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../src/user-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE7B;;OAEG;IACH,GAAG,CAAC,EAAE;QACL;;;;;WAKG;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;YAAE,WAAW,EAAE,OAAO,CAAC,eAAe,CAAA;SAAE,KAAK,OAAO,CAAC;KACxE,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE;QACR;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,EAAE;QACP;;;;;;;;;;;;;WAaG;QACH,QAAQ,CAAC,EAAE;YACV;;eAEG;YACH,MAAM,CAAC,EAAE,OAAO,CAAC;YAGjB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YAEnB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,CAAC;KACF,CAAC;IACF,MAAM,CAAC,EAAE;QACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8BG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;KACjC,CAAC;IAEF;;OAEG;IACH,YAAY,CAAC,EAAE;QACd;;;WAGG;QACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;KAOhC,CAAC;CACF"}
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../src/user-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAE7B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE9C;;OAEG;IACH,GAAG,CAAC,EAAE;QACL;;;;;WAKG;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;YAAE,WAAW,EAAE,OAAO,CAAC,eAAe,CAAA;SAAE,KAAK,OAAO,CAAC;KACxE,CAAC;IAEF;;OAEG;IACH,MAAM,CAAC,EAAE;QACR;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,EAAE;QACP;;;;;;;;;;;;;WAaG;QACH,QAAQ,CAAC,EAAE;YACV;;eAEG;YACH,MAAM,CAAC,EAAE,OAAO,CAAC;YAGjB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YAEnB;;eAEG;YACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;SACnB,CAAC;KACF,CAAC;IACF,MAAM,CAAC,EAAE;QACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8BG;QACH,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;KACjC,CAAC;IAEF;;OAEG;IACH,YAAY,CAAC,EAAE;QACd;;;WAGG;QACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;KAOhC,CAAC;CACF"}

package/dist/vite/plugin-ce-tracker.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Vite plugin that tracks Custom Elements registrations on the server
+ * and cleans up orphaned CEs when imports are removed during dev HMR.
+ *
+ * How it works:
+ * 1. `configureServer` — installs the registry wrapper (before any modules load).
+ * 2. `transform` (SSR only) — injects module-context markers around files that
+ *    might call `customElements.define`, so the wrapper knows which module is
+ *    responsible for each registration.
+ * 3. `hotUpdate` — when a file changes, walks the OLD import tree, finds CE
+ *    modules in that tree, blocks their tags, and invalidates them. If they are
+ *    still imported after re-evaluation, `define()` fires again and unblocks.
+ *    If removed, they stay blocked.
+ *
+ * @internal
+ */
+import type { Plugin } from 'vite';
+export declare function gracileCETrackerPlugin(): Plugin;
+//# sourceMappingURL=plugin-ce-tracker.d.ts.map

package/dist/vite/plugin-ce-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-ce-tracker.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-ce-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAyB,MAAM,MAAM,CAAC;AAmC1D,wBAAgB,sBAAsB,IAAI,MAAM,CA6D/C"}

package/dist/vite/plugin-ce-tracker.js

@@ -0,0 +1,87 @@
+/**
+ * Vite plugin that tracks Custom Elements registrations on the server
+ * and cleans up orphaned CEs when imports are removed during dev HMR.
+ *
+ * How it works:
+ * 1. `configureServer` — installs the registry wrapper (before any modules load).
+ * 2. `transform` (SSR only) — injects module-context markers around files that
+ *    might call `customElements.define`, so the wrapper knows which module is
+ *    responsible for each registration.
+ * 3. `hotUpdate` — when a file changes, walks the OLD import tree, finds CE
+ *    modules in that tree, blocks their tags, and invalidates them. If they are
+ *    still imported after re-evaluation, `define()` fires again and unblocks.
+ *    If removed, they stay blocked.
+ *
+ * @internal
+ */
+import { installCeTracker, blockCesForModule, hasCeRegistrations, } from '../dev/ssr-ce-tracker.js';
+// ── Helpers ─────────────────────────────────────────────────────────
+/** Recursively collect all transitive imports of a module. */
+function collectImportTree(module_, seen = new Set()) {
+    if (!module_.id || seen.has(module_.id))
+        return seen;
+    seen.add(module_.id);
+    for (const imported of module_.importedModules) {
+        collectImportTree(imported, seen);
+    }
+    return seen;
+}
+/** Heuristic: does this source likely define a Custom Element? */
+function mightDefineCE(code) {
+    return (code.includes('customElements.define') ||
+        // Lit @customElement decorator — calls define() at eval time.
+        // Matches both TS source (`@customElement(`) and compiled output.
+        /\bcustomElement\s*\(/.test(code));
+}
+// ── Plugin ──────────────────────────────────────────────────────────
+export function gracileCETrackerPlugin() {
+    return {
+        name: 'vite-plugin-gracile-ce-tracker',
+        configureServer() {
+            installCeTracker();
+        },
+        // Inject module-context markers so the registry wrapper knows
+        // which module is responsible for each define() call.
+        transform(code, id, options) {
+            if (!options?.ssr)
+                return;
+            if (!mightDefineCE(code))
+                return;
+            const escaped = JSON.stringify(id);
+            return {
+                code: [
+                    `globalThis.__gracile_ce_tracker?.setModule(${escaped});`,
+                    code,
+                    `globalThis.__gracile_ce_tracker?.clearModule();`,
+                ].join('\n'),
+                map: null,
+            };
+        },
+        hotUpdate: {
+            order: 'pre',
+            handler({ modules, timestamp }) {
+                if (this.environment.name !== 'ssr')
+                    return;
+                const invalidated = new Set();
+                for (const module_ of modules) {
+                    if (!module_.id)
+                        continue;
+                    // Walk the OLD import tree (graph hasn't updated yet).
+                    const tree = collectImportTree(module_);
+                    for (const depId of tree) {
+                        if (!hasCeRegistrations(depId))
+                            continue;
+                        // Block this module's CEs. If the module is still imported
+                        // after re-evaluation, its define() will unblock them.
+                        blockCesForModule(depId);
+                        // Force re-evaluation so define() can re-fire.
+                        const depModule = this.environment.moduleGraph.getModuleById(depId);
+                        if (depModule) {
+                            this.environment.moduleGraph.invalidateModule(depModule, invalidated, timestamp, true);
+                        }
+                    }
+                }
+            },
+        },
+    };
+}

package/dist/vite/plugin-client-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-client-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-client-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,wBAAwB,CAAC,EACxC,KAAK,EACL,sBAAsB,GACtB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,sBAAsB,EAAE,YAAY,CAAC;CACrC,GAAG,YAAY,CAkDf"}
+{"version":3,"file":"plugin-client-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-client-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAGvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,wBAAwB,CAAC,EACxC,KAAK,EACL,sBAAsB,GACtB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,sBAAsB,EAAE,YAAY,CAAC;CACrC,GAAG,YAAY,CA+Df"}

package/dist/vite/plugin-client-build.js

@@ -34,6 +34,16 @@ export function gracileClientBuildPlugin({ state, virtualRoutesForClient, }) {
                 routes: state.routes,
             });
             state.renderedRoutes = htmlPages.renderedRoutes;
+            // NOTE: Vite's dev server does not invoke Rollup's `closeWatcher`
+            // hook when shutting down. Plugins like @rollup/plugin-typescript
+            // use `ts.createWatchProgram()` which sets up hundreds of FS
+            // watchers; without an explicit `closeWatcher` call they are
+            // leaked and the Node process hangs after build.
+            for (const plugin of viteServerForClientHtmlBuild.config.plugins) {
+                if (typeof plugin.closeWatcher === 'function') {
+                    await plugin.closeWatcher();
+                }
+            }
             await viteServerForClientHtmlBuild.close();
             return {
                 build: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gracile/engine",
-  "version": "0.9.0-next.5",
+  "version": "0.9.0-next.7",
   "description": "A thin, full-stack, web framework",
   "keywords": [
     "custom-elements",
@@ -43,8 +43,8 @@
     "!/dist/typedoc-entrypoint.*"
   ],
   "dependencies": {
-    "@gracile-labs/better-errors": "^0.2.0-next.4",
-    "@gracile/internal-utils": "^0.6.0-next.3",
+    "@gracile-labs/better-errors": "^0.2.1-next.0",
+    "@gracile/internal-utils": "^0.6.1-next.0",
     "@whatwg-node/server": "^0.10.18",
     "fdir": "^6.5.0",
     "picocolors": "^1.1.1",
@@ -60,5 +60,5 @@
     "access": "public",
     "provenance": true
   },
-  "gitHead": "534579e0c18fd2a9fbfaa7d9cb180187447fb193"
+  "gitHead": "9abb3f9de0217a6284a88b114194b4d254d0a104"
 }