@emkodev/emroute 1.7.3 → 1.8.0-beta.2

package/dist/core/server/emroute.server.js

@@ -0,0 +1,239 @@
+/**
+ * Emroute
+ *
+ * Framework entry point. Reads manifests from Runtime,
+ * builds Pipeline + Renderers, handles Request → Response.
+ */
+import { Pipeline } from "../pipeline/pipeline.js";
+import { SsrHtmlRenderer } from "../renderer/html.renderer.js";
+import { SsrMdRenderer } from "../renderer/md.renderer.js";
+import { WidgetRegistry } from "../widget/widget.registry.js";
+import { escapeHtml } from "../util/html.util.js";
+import { rewriteMdLinks } from "../util/md.util.js";
+import { ROUTES_MANIFEST_PATH, WIDGETS_MANIFEST_PATH, } from "../runtime/abstract.runtime.js";
+export const DEFAULT_BASE_PATH = { html: '/html', md: '/md', app: '/app' };
+export class Emroute {
+    runtime;
+    htmlBase;
+    mdBase;
+    appBase;
+    spa;
+    title;
+    htmlRenderer;
+    mdRenderer;
+    shell;
+    constructor(htmlRenderer, mdRenderer, shell, runtime, htmlBase, mdBase, appBase, spa, title) {
+        this.runtime = runtime;
+        this.htmlBase = htmlBase;
+        this.mdBase = mdBase;
+        this.appBase = appBase;
+        this.spa = spa;
+        this.title = title;
+        this.htmlRenderer = htmlRenderer;
+        this.mdRenderer = mdRenderer;
+        this.shell = shell;
+    }
+    static async create(config, runtime) {
+        const { spa = 'root' } = config;
+        const { html: htmlBase, md: mdBase, app: appBase } = config.basePath ?? DEFAULT_BASE_PATH;
+        // ── Verify route manifest exists ──────────────────────────────────
+        const manifestResponse = await runtime.query(ROUTES_MANIFEST_PATH);
+        if (manifestResponse.status === 404 && !config.routeTree) {
+            throw new Error(`[emroute] ${ROUTES_MANIFEST_PATH} not found in runtime. ` +
+                'Provide routeTree in config or ensure the runtime produces it.');
+        }
+        if (config.routeTree && manifestResponse.status === 404) {
+            await runtime.command(ROUTES_MANIFEST_PATH, {
+                body: JSON.stringify(config.routeTree),
+            });
+        }
+        // ── Pipeline ──────────────────────────────────────────────────────
+        const pipeline = new Pipeline({
+            runtime,
+            ...(config.extendContext ? { contextProvider: config.extendContext } : {}),
+            ...(config.moduleLoaders ? { moduleLoaders: config.moduleLoaders } : {}),
+        });
+        // ── Widgets ───────────────────────────────────────────────────────
+        let widgets = config.widgets;
+        const widgetsResponse = await runtime.query(WIDGETS_MANIFEST_PATH);
+        if (widgetsResponse.status !== 404) {
+            const entries = await widgetsResponse.json();
+            if (!config.widgets) {
+                widgets = await Emroute.importWidgets(entries, runtime);
+            }
+        }
+        // ── Renderers ─────────────────────────────────────────────────────
+        let ssrHtmlRenderer = null;
+        let ssrMdRenderer = null;
+        if (spa !== 'only') {
+            ssrHtmlRenderer = new SsrHtmlRenderer(pipeline, {
+                ...(config.markdownRenderer ? { markdownRenderer: config.markdownRenderer } : {}),
+                ...(widgets ? { widgets } : {}),
+            });
+            ssrMdRenderer = new SsrMdRenderer(pipeline, {
+                ...(widgets ? { widgets } : {}),
+            });
+        }
+        // ── HTML shell ────────────────────────────────────────────────────
+        const title = config.title ?? 'emroute';
+        const shellBase = (spa === 'root' || spa === 'only') ? appBase : htmlBase;
+        let shell = await Emroute.resolveShell(runtime, title, shellBase);
+        if ((await runtime.query('/main.css')).status !== 404) {
+            shell = shell.replace('</head>', '  <link rel="stylesheet" href="/main.css">\n</head>');
+        }
+        return new Emroute(ssrHtmlRenderer, ssrMdRenderer, shell, runtime, htmlBase, mdBase, appBase, spa, title);
+    }
+    // ── handleRequest ─────────────────────────────────────────────────
+    async handleRequest(req) {
+        const url = new URL(req.url);
+        const pathname = url.pathname;
+        const mdPrefix = this.mdBase + '/';
+        const htmlPrefix = this.htmlBase + '/';
+        const appPrefix = this.appBase + '/';
+        // SSR Markdown: /md/*
+        if (this.mdRenderer &&
+            (pathname.startsWith(mdPrefix) || pathname === this.mdBase)) {
+            const routePath = pathname === this.mdBase ? '/' : pathname.slice(this.mdBase.length);
+            if (routePath.length > 1 && routePath.endsWith('/')) {
+                const canonical = this.mdBase + routePath.slice(0, -1) + (url.search || '');
+                return Response.redirect(new URL(canonical, url.origin), 301);
+            }
+            try {
+                const routeUrl = new URL(routePath + url.search, url.origin);
+                const { content, status, redirect } = await this.mdRenderer.render(routeUrl, req.signal);
+                if (redirect) {
+                    const target = redirect.startsWith('/') ? this.mdBase + redirect : redirect;
+                    return Response.redirect(new URL(target, url.origin), status);
+                }
+                return new Response(rewriteMdLinks(content, this.mdBase, [this.mdBase, this.htmlBase]), {
+                    status,
+                    headers: { 'Content-Type': 'text/markdown; charset=utf-8; variant=CommonMark' },
+                });
+            }
+            catch (e) {
+                console.error(`[emroute] Error rendering ${pathname}:`, e);
+                return new Response('Internal Server Error', { status: 500 });
+            }
+        }
+        // SSR HTML: /html/*
+        if (this.htmlRenderer &&
+            (pathname.startsWith(htmlPrefix) || pathname === this.htmlBase)) {
+            const routePath = pathname === this.htmlBase ? '/' : pathname.slice(this.htmlBase.length);
+            if (routePath.length > 1 && routePath.endsWith('/')) {
+                const canonical = this.htmlBase + routePath.slice(0, -1) + (url.search || '');
+                return Response.redirect(new URL(canonical, url.origin), 301);
+            }
+            try {
+                const routeUrl = new URL(routePath + url.search, url.origin);
+                const result = await this.htmlRenderer.render(routeUrl, req.signal);
+                if (result.redirect) {
+                    const target = result.redirect.startsWith('/') ? this.htmlBase + result.redirect : result.redirect;
+                    return Response.redirect(new URL(target, url.origin), result.status);
+                }
+                const ssrTitle = result.title ?? this.title;
+                const html = Emroute.injectSsrContent(this.shell, result.content, ssrTitle, pathname);
+                return new Response(html, {
+                    status: result.status,
+                    headers: { 'Content-Type': 'text/html; charset=utf-8' },
+                });
+            }
+            catch (e) {
+                console.error(`[emroute] Error rendering ${pathname}:`, e);
+                return new Response('Internal Server Error', { status: 500 });
+            }
+        }
+        // /app/*
+        if (pathname.startsWith(appPrefix) || pathname === this.appBase) {
+            return new Response(this.shell, {
+                status: 200,
+                headers: { 'Content-Type': 'text/html; charset=utf-8' },
+            });
+        }
+        // Unhandled SSR paths in 'only' mode — serve shell
+        if (pathname.startsWith(htmlPrefix) || pathname === this.htmlBase ||
+            pathname.startsWith(mdPrefix) || pathname === this.mdBase) {
+            return new Response(this.shell, {
+                status: 200,
+                headers: { 'Content-Type': 'text/html; charset=utf-8' },
+            });
+        }
+        // Static files
+        const lastSegment = pathname.split('/').pop() ?? '';
+        if (lastSegment.includes('.')) {
+            const fileResponse = await this.runtime.handle(pathname);
+            if (fileResponse.status === 200)
+                return fileResponse;
+            return null;
+        }
+        // Bare paths → redirect
+        const base = (this.spa === 'root' || this.spa === 'only') ? this.appBase : this.htmlBase;
+        const bare = pathname === '/' ? '' : pathname.slice(1).replace(/\/$/, '');
+        return Response.redirect(new URL(`${base}/${bare}`, url.origin), 302);
+    }
+    // ── Private static helpers ────────────────────────────────────────
+    static extractWidgetExport(mod) {
+        for (const value of Object.values(mod)) {
+            if (!value)
+                continue;
+            if (typeof value === 'object' && 'getData' in value) {
+                return value;
+            }
+            if (typeof value === 'function' && value.prototype?.getData) {
+                return new value();
+            }
+        }
+        return null;
+    }
+    static async importWidgets(entries, runtime) {
+        const registry = new WidgetRegistry();
+        for (const entry of entries) {
+            try {
+                const runtimePath = entry.modulePath.startsWith('/')
+                    ? entry.modulePath
+                    : `/${entry.modulePath}`;
+                const mod = await runtime.loadModule(runtimePath);
+                const instance = Emroute.extractWidgetExport(mod);
+                if (!instance)
+                    continue;
+                registry.add(instance, runtimePath);
+            }
+            catch (e) {
+                console.error(`[emroute] Failed to load widget ${entry.modulePath}:`, e);
+            }
+        }
+        return registry;
+    }
+    static buildHtmlShell(title, htmlBase) {
+        const baseTag = htmlBase ? `\n  <base href="${escapeHtml(htmlBase)}/">` : '';
+        return `<!DOCTYPE html>
+<html>
+<head>${baseTag}
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${escapeHtml(title)}</title>
+  <style>@view-transition { navigation: auto; } router-slot { display: contents; }</style>
+</head>
+<body>
+  <router-slot></router-slot>
+</body>
+</html>`;
+    }
+    static injectSsrContent(html, content, title, ssrRoute) {
+        const slotPattern = /<router-slot\b[^>]*>.*?<\/router-slot>/s;
+        if (!slotPattern.test(html))
+            return html;
+        const ssrAttr = ssrRoute ? ` data-ssr-route="${ssrRoute}"` : '';
+        html = html.replace(slotPattern, `<router-slot${ssrAttr}>${content}</router-slot>`);
+        if (title) {
+            html = html.replace(/<title>[^<]*<\/title>/, `<title>${escapeHtml(title)}</title>`);
+        }
+        return html;
+    }
+    static async resolveShell(runtime, title, htmlBase) {
+        const response = await runtime.query('/index.html');
+        if (response.status !== 404)
+            return await response.text();
+        return Emroute.buildHtmlShell(title, htmlBase);
+    }
+}
+//# sourceMappingURL=emroute.server.js.map

package/dist/core/server/emroute.server.js.map

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

package/dist/core/server/server.type.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Server Types
+ *
+ * Types and conventions for the emroute server layer.
+ */
+import type { RouteNode } from '../type/route-tree.type.ts';
+import type { MarkdownRenderer } from '../type/markdown.type.ts';
+import type { SpaMode, WidgetManifestEntry } from '../type/widget.type.ts';
+import type { ElementManifestEntry } from '../type/element.type.ts';
+import type { ContextProvider } from '../type/component.type.ts';
+import type { WidgetRegistry } from '../widget/widget.registry.ts';
+import type { SsrHtmlRenderer } from '../renderer/html.renderer.ts';
+import type { SsrMdRenderer } from '../renderer/md.renderer.ts';
+/** Base paths for the three rendering endpoints. */
+export interface BasePath {
+    html: string;
+    md: string;
+    app: string;
+}
+export declare const DEFAULT_BASE_PATH: BasePath;
+/** Well-known manifest paths (convention between Runtime and Server). */
+export declare const ROUTES_MANIFEST_PATH = "/routes.manifest.json";
+export declare const WIDGETS_MANIFEST_PATH = "/widgets.manifest.json";
+export declare const ELEMENTS_MANIFEST_PATH = "/elements.manifest.json";
+/** Config for `createEmrouteServer()`. */
+export interface EmrouteServerConfig {
+    routeTree?: RouteNode;
+    widgets?: WidgetRegistry;
+    spa?: SpaMode;
+    basePath?: BasePath;
+    title?: string;
+    markdownRenderer?: MarkdownRenderer;
+    extendContext?: ContextProvider;
+    moduleLoaders?: Record<string, () => Promise<unknown>>;
+}
+/** An emroute server instance. */
+export interface EmrouteServer {
+    handleRequest(req: Request): Promise<Response | null>;
+    readonly htmlRenderer: SsrHtmlRenderer | null;
+    readonly mdRenderer: SsrMdRenderer | null;
+    readonly routeTree: RouteNode;
+    readonly widgetEntries: WidgetManifestEntry[];
+    readonly elementEntries: ElementManifestEntry[];
+    readonly shell: string;
+}

package/dist/core/server/server.type.js

@@ -0,0 +1,11 @@
+/**
+ * Server Types
+ *
+ * Types and conventions for the emroute server layer.
+ */
+export const DEFAULT_BASE_PATH = { html: '/html', md: '/md', app: '/app' };
+/** Well-known manifest paths (convention between Runtime and Server). */
+export const ROUTES_MANIFEST_PATH = '/routes.manifest.json';
+export const WIDGETS_MANIFEST_PATH = '/widgets.manifest.json';
+export const ELEMENTS_MANIFEST_PATH = '/elements.manifest.json';
+//# sourceMappingURL=server.type.js.map

package/dist/core/server/server.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.type.js","sourceRoot":"","sources":["../../../core/server/server.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,MAAM,CAAC,MAAM,iBAAiB,GAAa,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AAErF,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,yBAAyB,CAAC"}

package/dist/core/type/component.type.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Component Types
+ *
+ * Types for the component system. Separate from route types.
+ */
+import type { RouteInfo } from './route.type.ts';
+/** Shape of companion file contents (html, md, css). */
+export type FileContents = {
+    html?: string;
+    md?: string;
+    css?: string;
+};
+/** Context passed to components during rendering. */
+export interface ComponentContext extends RouteInfo {
+    /** @deprecated Use context.url.pathname */
+    readonly pathname: string;
+    /** @deprecated Use context.url.searchParams */
+    readonly searchParams: URLSearchParams;
+    readonly files?: Readonly<FileContents>;
+    readonly signal?: AbortSignal;
+    readonly isLeaf?: boolean;
+}
+/**
+ * Enriches the base ComponentContext with app-level services.
+ * Registered once at server creation; called for every context construction.
+ */
+export type ContextProvider = (base: ComponentContext) => ComponentContext;
+/** Render context determines how components are rendered. */
+export type RenderContext = 'markdown' | 'html' | 'spa';
+/** Component manifest entry for code generation. */
+export interface ComponentManifestEntry {
+    name: string;
+    modulePath: string;
+    tagName: string;
+    type: 'page' | 'widget';
+    pattern?: string;
+}

package/dist/core/type/component.type.js

@@ -0,0 +1,7 @@
+/**
+ * Component Types
+ *
+ * Types for the component system. Separate from route types.
+ */
+export {};
+//# sourceMappingURL=component.type.js.map

package/dist/core/type/component.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.type.js","sourceRoot":"","sources":["../../../core/type/component.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/core/type/element.type.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Element Types
+ */
+/** Custom element manifest entry for discovery and registration. */
+export interface ElementManifestEntry {
+    name: string;
+    modulePath: string;
+    tagName: string;
+}

package/dist/core/type/element.type.js

@@ -0,0 +1,5 @@
+/**
+ * Element Types
+ */
+export {};
+//# sourceMappingURL=element.type.js.map

package/dist/core/type/element.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.type.js","sourceRoot":"","sources":["../../../core/type/element.type.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/core/type/logger.type.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Logger Interface
+ *
+ * Minimal pluggable logger. Default: no-op (silent degradation).
+ * Pass via PipelineOptions to wire in.
+ */
+export interface Logger {
+    error(msg: string, error?: Error): void;
+    warn(msg: string): void;
+}
+/** Default no-op logger. */
+export declare const defaultLogger: Logger;
+/** @deprecated Pass `logger` in Emroute.create() config instead. This function is a no-op. */
+export declare function setLogger(_logger: Logger): void;

package/dist/core/type/logger.type.js

@@ -0,0 +1,8 @@
+const noop = () => { };
+/** Default no-op logger. */
+export const defaultLogger = { error: noop, warn: noop };
+/** @deprecated Pass `logger` in Emroute.create() config instead. This function is a no-op. */
+export function setLogger(_logger) {
+    console.warn('[emroute] setLogger() is deprecated. Pass `logger` in Emroute.create() config instead.');
+}
+//# sourceMappingURL=logger.type.js.map

package/dist/core/type/logger.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.type.js","sourceRoot":"","sources":["../../../core/type/logger.type.ts"],"names":[],"mappings":"AAWA,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAEtB,4BAA4B;AAC5B,MAAM,CAAC,MAAM,aAAa,GAAW,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEjE,8FAA8F;AAC9F,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;AACzG,CAAC"}

package/dist/core/type/markdown.type.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Markdown Renderer Interface
+ */
+export interface MarkdownRenderer {
+    render(markdown: string): string;
+    init?(): Promise<void>;
+}

package/dist/core/type/markdown.type.js

@@ -0,0 +1,5 @@
+/**
+ * Markdown Renderer Interface
+ */
+export {};
+//# sourceMappingURL=markdown.type.js.map

package/dist/core/type/markdown.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.type.js","sourceRoot":"","sources":["../../../core/type/markdown.type.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/{src → core}/type/route-tree.type.d.ts

@@ -2,7 +2,6 @@
  * Route Tree
  *
  * Serializable tree structure that mirrors the filesystem layout.
- * Replaces the flat array manifest as the canonical route format.
  *
  * Each node corresponds to a URL segment. The tree is JSON-serializable
  * (no Maps, no classes) so it can be written to disk, sent over the wire,
@@ -10,33 +9,22 @@
  */
 /** Files associated with a route (companion files discovered alongside the page). */
 export interface RouteFiles {
-    /** TypeScript module (e.g. "routes/about.page.ts") */
     ts?: string;
-    /** JavaScript module — merged module with inlined companions (e.g. "routes/about.page.js") */
     js?: string;
-    /** HTML template (e.g. "routes/about.page.html") */
     html?: string;
-    /** Markdown content (e.g. "routes/about.page.md") */
     md?: string;
-    /** Scoped stylesheet (e.g. "routes/about.page.css") */
     css?: string;
 }
 /** A single node in the route tree. */
 export interface RouteNode {
-    /** Route files when this node is a terminal route. */
     files?: RouteFiles;
-    /** Error boundary module path scoped to this prefix (from .error.ts). */
     errorBoundary?: string;
-    /** Redirect module path (from .redirect.ts). Mutually exclusive with files. */
     redirect?: string;
-    /** Static children keyed by URL segment (e.g. "about", "projects"). */
     children?: Record<string, RouteNode>;
-    /** Single-segment dynamic param (from [param] directories/files). */
     dynamic?: {
         param: string;
         child: RouteNode;
     };
-    /** Catch-all wildcard (from directory index.page.* files). */
     wildcard?: {
         param: string;
         child: RouteNode;

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

@@ -2,7 +2,6 @@
  * Route Tree
  *
  * Serializable tree structure that mirrors the filesystem layout.
- * Replaces the flat array manifest as the canonical route format.
  *
  * Each node corresponds to a URL segment. The tree is JSON-serializable
  * (no Maps, no classes) so it can be written to disk, sent over the wire,

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

@@ -0,0 +1 @@
+{"version":3,"file":"route-tree.type.js","sourceRoot":"","sources":["../../../core/type/route-tree.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/core/type/route.type.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Route Types
+ *
+ * Pure routing types. No rendering, no navigation, no browser concerns.
+ */
+export type { RouteNode, RouteFiles } from './route-tree.type.ts';
+/** Parameters extracted from URL patterns. */
+export type RouteParams = Readonly<Record<string, string>>;
+/** Immutable route context built once per navigation, shared across the render pipeline. */
+export interface RouteInfo {
+    readonly url: URL;
+    readonly params: RouteParams;
+}
+/** Supported file patterns in file-based routing. */
+export type RouteFileType = 'page' | 'error' | 'redirect';
+/** Redirect configuration. */
+export interface RedirectConfig {
+    to: string;
+    status: 301 | 302;
+}
+/** Route configuration for a single matched route. */
+export interface RouteConfig {
+    pattern: string;
+    type: RouteFileType;
+    modulePath: string;
+    files?: import('./route-tree.type.ts').RouteFiles;
+    parent?: string;
+    statusCode?: number;
+}
+/** Result of matching a URL against routes. */
+export interface MatchedRoute {
+    readonly route: RouteConfig;
+    readonly params: RouteParams;
+}
+/** Error boundary configuration. */
+export interface ErrorBoundary {
+    pattern: string;
+    modulePath: string;
+}
+/** Router state for history management. */
+export interface RouterState {
+    pathname: string;
+    params: RouteParams;
+    scrollY?: number;
+}
+/** Navigation options. */
+export interface NavigateOptions {
+    replace?: boolean;
+    state?: RouterState;
+    hash?: string;
+}
+/** Router event types. */
+export type RouterEventType = 'navigate' | 'error' | 'load';
+/** Router event payload. */
+export interface RouterEvent {
+    type: RouterEventType;
+    pathname: string;
+    params: RouteParams;
+    error?: Error;
+}
+/** Router event listener. */
+export type RouterEventListener = (event: RouterEvent) => void;

package/dist/core/type/route.type.js

@@ -0,0 +1,7 @@
+/**
+ * Route Types
+ *
+ * Pure routing types. No rendering, no navigation, no browser concerns.
+ */
+export {};
+//# sourceMappingURL=route.type.js.map

package/dist/core/type/route.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.type.js","sourceRoot":"","sources":["../../../core/type/route.type.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,27 @@
+/**
+ * Widget Types
+ */
+/** SPA rendering mode. */
+export type SpaMode = 'none' | 'leaf' | 'root' | 'only';
+/** Widget manifest entry for discovery and registration. */
+export interface WidgetManifestEntry {
+    name: string;
+    modulePath: string;
+    tagName: string;
+    files?: {
+        html?: string;
+        md?: string;
+        css?: string;
+    };
+}
+/** Full widgets manifest (array, sorted by name). */
+export type WidgetsManifest = WidgetManifestEntry[];
+/** Parsed widget block from markdown fenced code. */
+export interface ParsedWidgetBlock {
+    fullMatch: string;
+    widgetName: string;
+    params: Record<string, unknown> | null;
+    parseError?: string;
+    startIndex: number;
+    endIndex: number;
+}

package/dist/core/type/widget.type.js

@@ -0,0 +1,5 @@
+/**
+ * Widget Types
+ */
+export {};
+//# sourceMappingURL=widget.type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"widget.type.js","sourceRoot":"","sources":["../../../core/type/widget.type.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/core/util/html.util.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pure HTML utilities. No DOM, no browser APIs.
+ */
+/** HTML attribute name marking a widget as server-rendered. */
+export declare const SSR_ATTR = "ssr";
+/** HTML attribute name for lazy-loading widgets. */
+export declare const LAZY_ATTR = "lazy";
+/** Throw if a redirect URL uses a dangerous protocol. */
+export declare function assertSafeRedirect(url: string): void;
+export declare function escapeHtml(text: string): string;
+export declare function unescapeHtml(text: string): string;
+export declare function scopeWidgetCss(css: string, widgetName: string): string;
+/** Status code to message mapping. */
+export declare const STATUS_MESSAGES: Record<number, string>;