@emkodev/emroute 1.7.3 → 1.8.0-beta.2

package/dist/core/util/html.util.js

@@ -0,0 +1,43 @@
+/**
+ * Pure HTML utilities. No DOM, no browser APIs.
+ */
+/** HTML attribute name marking a widget as server-rendered. */
+export const SSR_ATTR = 'ssr';
+/** HTML attribute name for lazy-loading widgets. */
+export const LAZY_ATTR = 'lazy';
+const BLOCKED_PROTOCOLS = /^(javascript|data|vbscript):/i;
+/** Throw if a redirect URL uses a dangerous protocol. */
+export function assertSafeRedirect(url) {
+    if (BLOCKED_PROTOCOLS.test(url.trim())) {
+        throw new Error(`Unsafe redirect URL blocked: ${url}`);
+    }
+}
+export function escapeHtml(text) {
+    return text
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;')
+        .replaceAll('`', '&#96;');
+}
+export function unescapeHtml(text) {
+    return text
+        .replaceAll('&#96;', '`')
+        .replaceAll('&#39;', "'")
+        .replaceAll('&quot;', '"')
+        .replaceAll('&gt;', '>')
+        .replaceAll('&lt;', '<')
+        .replaceAll('&amp;', '&');
+}
+export function scopeWidgetCss(css, widgetName) {
+    return `@scope (widget-${widgetName}) {\n${css}\n}`;
+}
+/** Status code to message mapping. */
+export const STATUS_MESSAGES = {
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+    500: 'Internal Server Error',
+};
+//# sourceMappingURL=html.util.js.map

package/dist/core/util/html.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.util.js","sourceRoot":"","sources":["../../../core/util/html.util.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAE9B,oDAAoD;AACpD,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AAEhC,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAE1D,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC;SACxB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC;SACxB,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC;SACzB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;SACvB,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;SACvB,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,UAAkB;IAC5D,OAAO,kBAAkB,UAAU,QAAQ,GAAG,KAAK,CAAC;AACtD,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,uBAAuB;CAC7B,CAAC"}

package/dist/{src → core}/util/md.util.d.ts

@@ -4,5 +4,4 @@
  * Rewrites internal absolute links in markdown to include a base path prefix.
  * Skips fenced code blocks and links already under a known base path.
  */
-/** Rewrite internal absolute links in markdown to include the base path prefix. */
 export declare function rewriteMdLinks(markdown: string, base: string, skipPrefixes: string[]): string;

package/dist/{src → core}/util/md.util.js

@@ -4,10 +4,8 @@
  * Rewrites internal absolute links in markdown to include a base path prefix.
  * Skips fenced code blocks and links already under a known base path.
  */
-/** Rewrite internal absolute links in markdown to include the base path prefix. */
 export function rewriteMdLinks(markdown, base, skipPrefixes) {
     const prefix = base + '/';
-    // Negative lookahead: skip links already under a known base path
     const skip = skipPrefixes.map((p) => p.slice(1) + '/').join('|');
     const inlineRe = new RegExp(`\\]\\(\\/(?!${skip})`, 'g');
     const refRe = new RegExp(`^(\\[[^\\]]+\\]:\\s+)\\/(?!${skip})`, 'g');

package/dist/core/util/md.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.util.js","sourceRoot":"","sources":["../../../core/util/md.util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,IAAY,EAAE,YAAsB;IACnF,MAAM,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC;IAC1B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,eAAe,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,8BAA8B,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IAErE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,IAAI,WAAW;YAAE,SAAS;QAE1B,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/{src/route → core/util}/route-tree.util.js

@@ -15,7 +15,6 @@ export function resolveTargetNode(node, name, isRoot) {
     if (name === 'index') {
         if (isRoot)
             return node;
-        // Non-root index → wildcard catch-all
         node.wildcard ??= { param: 'rest', child: {} };
         return node.wildcard.child;
     }
@@ -24,7 +23,6 @@ export function resolveTargetNode(node, name, isRoot) {
         node.dynamic ??= { param, child: {} };
         return node.dynamic.child;
     }
-    // Static segment
     node.children ??= {};
     node.children[name] ??= {};
     return node.children[name];

package/dist/core/util/route-tree.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-tree.util.js","sourceRoot":"","sources":["../../../core/util/route-tree.util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,IAAY,EAAE,MAAe;IAC9E,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,IAAI,MAAM;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC,QAAQ,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,QAAQ,KAAK,EAAE,CAAC;IACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/core/util/widget-resolve.util.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Widget Resolve Utilities
+ *
+ * Server-side resolution of <widget-*> tags in HTML.
+ * Calls getData() + renderHTML() on widgets and injects SSR hydration data.
+ */
+import type { Component } from '../component/abstract.component.ts';
+import type { ContextProvider } from '../type/component.type.ts';
+import { type Logger } from '../type/logger.type.ts';
+import type { RouteInfo } from '../type/route.type.ts';
+/** Maximum nesting depth for widgets to prevent infinite loops */
+export declare const MAX_WIDGET_DEPTH = 10;
+/**
+ * Recursively resolve widgets in content with depth limit.
+ */
+export declare function resolveRecursively<T>(content: string, parse: (content: string) => T[], resolve: (widget: T) => Promise<string>, replace: (content: string, replacements: Map<T, string>) => string, depth?: number, logger?: Logger): Promise<string>;
+/**
+ * Resolve <widget-*> tags in HTML by calling getData() + renderHTML().
+ */
+export declare function resolveWidgetTags(html: string, registry: {
+    get(name: string): Component | undefined;
+}, routeInfo: RouteInfo, loadFiles?: (widgetName: string) => Promise<{
+    html?: string;
+    md?: string;
+    css?: string;
+}>, contextProvider?: ContextProvider, logger?: Logger): Promise<string>;
+/** Parse HTML attribute string into params object. */
+export declare function parseAttrsToParams(attrsString: string): Record<string, unknown>;

package/dist/{src → core}/util/widget-resolve.util.js

@@ -4,25 +4,14 @@
  * Server-side resolution of <widget-*> tags in HTML.
  * Calls getData() + renderHTML() on widgets and injects SSR hydration data.
  */
-import { logger } from "../type/logger.type.js";
+import { defaultLogger } from "../type/logger.type.js";
 import { LAZY_ATTR, SSR_ATTR } from "./html.util.js";
 /** Maximum nesting depth for widgets to prevent infinite loops */
 export const MAX_WIDGET_DEPTH = 10;
 /**
  * Recursively resolve widgets in content with depth limit.
- *
- * Generic utility used by both HTML and Markdown widget resolution.
- * Each depth level processes all widgets concurrently, then recurses
- * into each rendered result to resolve nested widgets.
- *
- * @param content - Content containing widgets
- * @param parse - Find widgets in content
- * @param resolve - Resolve a single widget to rendered output
- * @param replace - Replace widgets with resolved content
- * @param depth - Current recursion depth (internal)
- * @returns Content with all widgets recursively resolved
  */
-export async function resolveRecursively(content, parse, resolve, replace, depth = 0) {
+export async function resolveRecursively(content, parse, resolve, replace, depth = 0, logger = defaultLogger) {
     if (depth >= MAX_WIDGET_DEPTH) {
         logger.warn(`Widget nesting depth limit reached (${MAX_WIDGET_DEPTH}). ` +
             'Possible circular dependency or excessive nesting.');
@@ -34,33 +23,18 @@ export async function resolveRecursively(content, parse, resolve, replace, depth
     const replacements = new Map();
     await Promise.all(widgets.map(async (widget) => {
         let rendered = await resolve(widget);
-        // Recursively resolve any nested widgets in the rendered output
-        rendered = await resolveRecursively(rendered, parse, resolve, replace, depth + 1);
+        rendered = await resolveRecursively(rendered, parse, resolve, replace, depth + 1, logger);
         replacements.set(widget, rendered);
     }));
     return replace(content, replacements);
 }
 /**
- * Resolve <widget-*> tags in HTML by calling getData() + renderHTML()
- * via the widget registry. Injects rendered content and boolean ssr attribute.
- *
- * Supports nested widgets: if a widget's renderHTML() returns HTML containing
- * other <widget-*> tags, those will be resolved recursively up to MAX_WIDGET_DEPTH.
- *
- * Before: <widget-crypto-price coin="bitcoin"></widget-crypto-price>
- * After:  <widget-crypto-price coin="bitcoin" ssr><template shadowrootmode="open"><span>$42,000</span></template></widget-crypto-price>
- *
- * When a widget has `exposeSsrData = true`, the getData() result is serialized
- * as JSON text in the light DOM (alongside the shadow root template):
- * After:  <widget-crypto-price coin="bitcoin" ssr><template shadowrootmode="open"><span>$42,000</span></template>{"price":42000}</widget-crypto-price>
+ * Resolve <widget-*> tags in HTML by calling getData() + renderHTML().
  */
-export function resolveWidgetTags(html, registry, routeInfo, loadFiles, contextProvider) {
+export function resolveWidgetTags(html, registry, routeInfo, loadFiles, contextProvider, logger = defaultLogger) {
     const tagPattern = /<widget-(?<name>[a-z][a-z0-9-]*)(?<attrs>\s[^>]*)?>(?<content>.*?)<\/widget-\k<name>>/gis;
-    // Wrapping info stored per-match so replace() can apply it after recursion
     const wrappers = new Map();
-    // Matches standalone ssr attribute (boolean or with value), not as substring of another value
     const ssrAttrPattern = new RegExp(`\\s${SSR_ATTR}(?:\\s|=|$)`);
-    // Parse: find unprocessed widget tags
     const parse = (content) => {
         const matches = content.matchAll(tagPattern).toArray();
         return matches.filter((match) => {
@@ -68,18 +42,17 @@ export function resolveWidgetTags(html, registry, routeInfo, loadFiles, contextP
             return !ssrAttrPattern.test(attrsString);
         });
     };
-    // Resolve: render a single widget's inner content (no outer tag wrapping — that's in replace)
     const resolve = async (match) => {
         const widgetName = match.groups.name;
         const attrsString = match.groups.attrs?.trim() ?? '';
         const widget = registry.get(widgetName);
         if (!widget)
-            return match[0]; // no widget found — leave original tag as-is
+            return match[0];
         const params = parseAttrsToParams(attrsString);
         try {
             let files;
             if (loadFiles) {
-                files = await loadFiles(widgetName, widget.files);
+                files = await loadFiles(widgetName);
             }
             const baseContext = {
                 ...routeInfo,
@@ -90,7 +63,6 @@ export function resolveWidgetTags(html, registry, routeInfo, loadFiles, contextP
             const context = contextProvider ? contextProvider(baseContext) : baseContext;
             const data = await widget.getData({ params, context });
             const rendered = widget.renderHTML({ data, params, context });
-            // Store wrapping info — applied in replace() after recursion resolves nested widgets
             wrappers.set(match, {
                 tagName: `widget-${widgetName}`,
                 attrs: attrsString ? ` ${attrsString}` : '',
@@ -100,10 +72,9 @@ export function resolveWidgetTags(html, registry, routeInfo, loadFiles, contextP
         }
         catch (e) {
             logger.error(`[SSR HTML] Widget "${widgetName}" render failed`, e instanceof Error ? e : undefined);
-            return match[0]; // render failed — leave original tag as-is
+            return match[0];
         }
     };
-    // Replace: wrap resolved content in outer tag + DSD template, then substitute by index
     const replace = (content, replacements) => {
         let result = content;
         const entries = [...replacements.entries()].sort((a, b) => b[0].index - a[0].index);
@@ -114,14 +85,14 @@ export function resolveWidgetTags(html, registry, routeInfo, loadFiles, contextP
             const lightDomData = wrap?.ssrData ? wrap.ssrData : '';
             const replacement = wrap
                 ? `<${wrap.tagName}${wrap.attrs} ${SSR_ATTR}><template shadowrootmode="open">${innerHtml}</template>${lightDomData}</${wrap.tagName}>`
-                : innerHtml; // no wrapper = unresolved widget, innerHtml is the original tag
+                : innerHtml;
             result = result.slice(0, start) + replacement + result.slice(end);
         }
         return result;
     };
-    return resolveRecursively(html, parse, resolve, replace);
+    return resolveRecursively(html, parse, resolve, replace, 0, logger);
 }
-/** Parse HTML attribute string into params object (kebab→camelCase, JSON.parse with string fallback). */
+/** Parse HTML attribute string into params object. */
 export function parseAttrsToParams(attrsString) {
     const params = {};
     if (!attrsString)
@@ -129,7 +100,7 @@ export function parseAttrsToParams(attrsString) {
     const attrPattern = /(?<attr>[a-z][a-z0-9-]*)(?:="(?<dq>[^"]*)"|='(?<sq>[^']*)'|=(?<uq>[^\s>]+))?/gi;
     for (const match of attrsString.matchAll(attrPattern)) {
         const { attr: attrName, dq, sq, uq } = match.groups;
-        if (attrName === SSR_ATTR || attrName === LAZY_ATTR)
+        if (!attrName || attrName === SSR_ATTR || attrName === LAZY_ATTR)
             continue;
         const key = attrName.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
         const rawValue = dq ?? sq ?? uq;
@@ -147,7 +118,6 @@ export function parseAttrsToParams(attrsString) {
     }
     return params;
 }
-/** Escape a value for use in a single-quoted HTML attribute. */
 function escapeAttr(value) {
     return value.replaceAll('&', '&amp;').replaceAll("'", '&#39;');
 }

package/dist/core/util/widget-resolve.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-resolve.util.js","sourceRoot":"","sources":["../../../core/util/widget-resolve.util.ts"],"names":[],"mappings":"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"}

package/dist/{src → core}/widget/widget.parser.d.ts

@@ -9,18 +9,5 @@
  * ```
  */
 import type { ParsedWidgetBlock } from '../type/widget.type.ts';
-/**
- * Parse all widget blocks from markdown content.
- *
- * @param markdown - Markdown content to parse
- * @returns Array of parsed widget blocks with positions
- */
 export declare function parseWidgetBlocks(markdown: string): ParsedWidgetBlock[];
-/**
- * Replace widget blocks in markdown with rendered content.
- *
- * @param markdown - Original markdown content
- * @param replacements - Map of parsed blocks to replacement strings
- * @returns Markdown with widget blocks replaced
- */
 export declare function replaceWidgetBlocks(markdown: string, replacements: Map<ParsedWidgetBlock, string>): string;

package/dist/{src → core}/widget/widget.parser.js

@@ -8,17 +8,7 @@
  * {"key": "value"}
  * ```
  */
-/**
- * Pattern to match widget fenced code blocks.
- * Captures: widget name, params content
- */
 const WIDGET_PATTERN = /```widget:(?<name>[a-z][a-z0-9-]*)\n(?<params>.*?)```/gs;
-/**
- * Parse all widget blocks from markdown content.
- *
- * @param markdown - Markdown content to parse
- * @returns Array of parsed widget blocks with positions
- */
 export function parseWidgetBlocks(markdown) {
     const blocks = [];
     for (const match of markdown.matchAll(WIDGET_PATTERN)) {
@@ -28,12 +18,11 @@ export function parseWidgetBlocks(markdown) {
         const startIndex = match.index;
         const block = {
             fullMatch,
-            widgetName,
+            widgetName: widgetName,
             params: null,
             startIndex,
             endIndex: startIndex + fullMatch.length,
         };
-        // Parse JSON params if present
         if (paramsJson) {
             try {
                 const parsed = JSON.parse(paramsJson);
@@ -49,23 +38,13 @@ export function parseWidgetBlocks(markdown) {
             }
         }
         else {
-            // Empty params is valid - use empty object
             block.params = {};
         }
         blocks.push(block);
     }
     return blocks;
 }
-/**
- * Replace widget blocks in markdown with rendered content.
- *
- * @param markdown - Original markdown content
- * @param replacements - Map of parsed blocks to replacement strings
- * @returns Markdown with widget blocks replaced
- */
 export function replaceWidgetBlocks(markdown, replacements) {
-    // Sort blocks by position descending to replace from end first
-    // This preserves indices during replacement
     const sortedBlocks = [...replacements.entries()].sort(([a], [b]) => b.startIndex - a.startIndex);
     let result = markdown;
     for (const [block, replacement] of sortedBlocks) {

package/dist/core/widget/widget.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.parser.js","sourceRoot":"","sources":["../../../core/widget/widget.parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,cAAc,GAAG,yDAAyD,CAAC;AAEjF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,MAAO,CAAC;QAC9D,MAAM,UAAU,GAAG,SAAU,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAE/B,MAAM,KAAK,GAAsB;YAC/B,SAAS;YACT,UAAU,EAAE,UAAW;YACvB,MAAM,EAAE,IAAI;YACZ,UAAU;YACV,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC,MAAM;SACxC,CAAC;QAEF,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACtC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC5E,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;gBACxB,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,UAAU,GAAG,8BAA8B,CAAC;gBACpD,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,KAAK,CAAC,UAAU,GAAG,iBAAiB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC;QACpB,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,YAA4C;IAE5C,MAAM,YAAY,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAC1C,CAAC;IAEF,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,KAAK,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,YAAY,EAAE,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/widget/widget.registry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Widget Registry
+ *
+ * Name → Component lookup. Used by all renderers.
+ * Pages are NOT in this registry — they live in the routes manifest.
+ */
+import type { WidgetComponent } from '../component/widget.component.ts';
+export declare class WidgetRegistry {
+    private entries;
+    add(widget: WidgetComponent, modulePath?: string): void;
+    get(name: string): WidgetComponent | undefined;
+    getModulePath(name: string): string | undefined;
+    [Symbol.iterator](): IterableIterator<WidgetComponent>;
+}

package/dist/core/widget/widget.registry.js

@@ -0,0 +1,26 @@
+/**
+ * Widget Registry
+ *
+ * Name → Component lookup. Used by all renderers.
+ * Pages are NOT in this registry — they live in the routes manifest.
+ */
+export class WidgetRegistry {
+    entries = new Map();
+    add(widget, modulePath) {
+        this.entries.set(widget.name, { widget, modulePath });
+    }
+    get(name) {
+        return this.entries.get(name)?.widget;
+    }
+    getModulePath(name) {
+        return this.entries.get(name)?.modulePath;
+    }
+    [Symbol.iterator]() {
+        const entries = this.entries.values();
+        return (function* () {
+            for (const entry of entries)
+                yield entry.widget;
+        })();
+    }
+}
+//# sourceMappingURL=widget.registry.js.map

package/dist/core/widget/widget.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.registry.js","sourceRoot":"","sources":["../../../core/widget/widget.registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEnD,GAAG,CAAC,MAAuB,EAAE,UAAmB;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACxC,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC5C,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,CAAC,QAAQ,CAAC;YACf,KAAK,MAAM,KAAK,IAAI,OAAO;gBAAE,MAAM,KAAK,CAAC,MAAM,CAAC;QAClD,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;CACF"}