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

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/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.6",
+  "version": "0.9.0-next.7",
   "description": "A thin, full-stack, web framework",
   "keywords": [
     "custom-elements",
@@ -60,5 +60,5 @@
     "access": "public",
     "provenance": true
   },
-  "gitHead": "a83e253566cdeb19aa75c7d0a686e3e52e921eed"
+  "gitHead": "9abb3f9de0217a6284a88b114194b4d254d0a104"
 }