@emkodev/emroute 1.7.2 → 1.7.3

package/src/route/route.core.ts

@@ -17,7 +17,7 @@ import type {
   RouterEvent,
   RouterEventListener,
 } from '../type/route.type.ts';
-import type { ComponentContext, ContextProvider } from '../component/abstract.component.ts';
+import type { ComponentContext, ContextProvider, FileContents } from '../component/abstract.component.ts';
 import type { RouteResolver, ResolvedRoute } from './route.resolver.ts';
 
 /** Base paths for the two SSR rendering endpoints. */
@@ -56,7 +56,7 @@ function toRouteConfig(resolved: ResolvedRoute): RouteConfig {
     pattern: resolved.pattern,
     type: node.redirect ? 'redirect' : 'page',
     modulePath: node.redirect ?? node.files?.ts ?? node.files?.js ?? node.files?.html ?? node.files?.md ?? '',
-    files: node.files,
+    ...(node.files ? { files: node.files } : {}),
   };
 }
 
@@ -157,7 +157,7 @@ export class RouteCore {
       pattern: `/${status}`,
       type: 'page',
       modulePath: node.files?.ts ?? node.files?.js ?? node.files?.html ?? node.files?.md ?? '',
-      files: node.files,
+      ...(node.files ? { files: node.files } : {}),
     };
   }
 
@@ -190,7 +190,7 @@ export class RouteCore {
       pattern,
       type: node.redirect ? 'redirect' : 'page',
       modulePath: node.redirect ?? node.files?.ts ?? node.files?.js ?? node.files?.html ?? node.files?.md ?? '',
-      files: node.files,
+      ...(node.files ? { files: node.files } : {}),
     };
   }
 
@@ -287,7 +287,11 @@ export class RouteCore {
       widgetFiles.css ? load(widgetFiles.css) : undefined,
     ]);
 
-    return { html, md, css };
+    const result: { html?: string; md?: string; css?: string } = {};
+    if (html != null) result.html = html;
+    if (md != null) result.md = md;
+    if (css != null) result.css = css;
+    return result;
   }
 
   /**
@@ -349,13 +353,18 @@ export class RouteCore {
       ]);
     }
 
+    const files: FileContents = {};
+    if (html != null) files.html = html;
+    if (md != null) files.md = md;
+    if (css != null) files.css = css;
+
     const base: ComponentContext = {
       ...routeInfo,
       pathname: routeInfo.url.pathname,
       searchParams: routeInfo.url.searchParams,
-      files: { html, md, css },
-      signal,
-      isLeaf,
+      files,
+      ...(signal ? { signal } : {}),
+      ...(isLeaf != null ? { isLeaf } : {}),
     };
     return this.contextProvider ? this.contextProvider(base) : base;
   }

package/src/type/element.type.ts

@@ -0,0 +1,22 @@
+/**
+ * Custom Element - Type Definitions
+ *
+ * Custom elements are plain HTMLElement subclasses auto-discovered from
+ * `elementsDir/{name}/{name}.element.ts`. They are registered in the
+ * browser via `customElements.define()` during `bootEmrouteApp()`.
+ */
+
+/**
+ * Custom element manifest entry.
+ * Discovered from `elementsDir/{name}/{name}.element.ts`.
+ */
+export interface ElementManifestEntry {
+  /** Element name in kebab-case (must contain a hyphen per web spec) */
+  name: string;
+
+  /** Path to element module file */
+  modulePath: string;
+
+  /** Custom element tag name (same as name) */
+  tagName: string;
+}

package/src/util/widget-resolve.util.ts

@@ -5,7 +5,7 @@
  * Calls getData() + renderHTML() on widgets and injects SSR hydration data.
  */
 
-import type { Component, ContextProvider } from '../component/abstract.component.ts';
+import type { Component, ComponentContext, ContextProvider } from '../component/abstract.component.ts';
 import { logger } from '../type/logger.type.ts';
 import type { RouteInfo } from '../type/route.type.ts';
 import { LAZY_ATTR, SSR_ATTR } from './html.util.ts';
@@ -118,13 +118,13 @@ export function resolveWidgetTags(
         files = await loadFiles(widgetName, widget.files);
       }
 
-      const baseContext = {
+      const baseContext: ComponentContext = {
         ...routeInfo,
         pathname: routeInfo.url.pathname,
         searchParams: routeInfo.url.searchParams,
-        files,
+        ...(files ? { files } : {}),
       };
-      const context = contextProvider ? contextProvider(baseContext) : baseContext;
+      const context: ComponentContext = contextProvider ? contextProvider(baseContext) : baseContext;
 
       const data = await widget.getData({ params, context });
       const rendered = widget.renderHTML({ data, params, context });

package/src/widget/widget.registry.ts

@@ -40,7 +40,7 @@ export class WidgetRegistry {
         name,
         modulePath: name,
         tagName: `widget-${name}`,
-        files: widget.files,
+        ...(widget.files ? { files: widget.files } : {}),
       };
       widgets.push(entry);
       moduleLoaders[name] = () => Promise.resolve({ default: widget.constructor });