@emkodev/emroute 1.6.2 → 1.6.3

package/dist/src/element/markdown.element.js

@@ -0,0 +1,93 @@
+/**
+ * Markdown Element — <mark-down> custom element.
+ *
+ * Renders markdown content with pluggable renderer.
+ * Supports:
+ * - Inline content: <mark-down># Title</mark-down>
+ * - Source attribute: <mark-down src="/path/to.md"></mark-down>
+ */
+import { escapeHtml, HTMLElementBase } from "../util/html.util.js";
+export class MarkdownElement extends HTMLElementBase {
+    static renderer = null;
+    static rendererInitPromise = null;
+    abortController = null;
+    /**
+     * Set the markdown renderer.
+     * Must be called before any <mark-down> elements are connected.
+     *
+     * @example
+     * ```ts
+     * import { createEmkoRenderer } from './emko.renderer.ts';
+     * MarkdownElement.setRenderer(await createEmkoRenderer());
+     * ```
+     */
+    static setRenderer(renderer) {
+        MarkdownElement.renderer = renderer;
+        MarkdownElement.rendererInitPromise = renderer.init ? renderer.init() : null;
+    }
+    /**
+     * Get the current renderer, waiting for init if needed.
+     */
+    static async getRenderer() {
+        const renderer = MarkdownElement.renderer;
+        if (!renderer) {
+            throw new Error('No markdown renderer configured. Call MarkdownElement.setRenderer() before using <mark-down> elements.');
+        }
+        if (MarkdownElement.rendererInitPromise) {
+            await MarkdownElement.rendererInitPromise;
+        }
+        return renderer;
+    }
+    async connectedCallback() {
+        this.abortController = new AbortController();
+        await this.loadContent();
+    }
+    disconnectedCallback() {
+        this.abortController?.abort();
+        this.abortController = null;
+    }
+    async loadContent() {
+        const src = this.getAttribute('src');
+        const inlineContent = this.textContent?.trim();
+        if (src) {
+            await this.loadFromSrc(src);
+        }
+        else if (inlineContent) {
+            await this.renderContent(inlineContent);
+        }
+        else {
+            this.innerHTML = '';
+        }
+    }
+    async loadFromSrc(src) {
+        const signal = this.abortController?.signal;
+        try {
+            const response = await fetch(src, { signal });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch ${src}: ${response.status}`);
+            }
+            const markdown = await response.text();
+            await this.renderContent(markdown);
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                return;
+            }
+            this.showError(error);
+        }
+    }
+    async renderContent(markdown) {
+        try {
+            const renderer = await MarkdownElement.getRenderer();
+            this.innerHTML = renderer.render(markdown);
+        }
+        catch (error) {
+            this.showError(error);
+        }
+    }
+    showError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        this.innerHTML = `<div>Markdown Error: ${escapeHtml(message)}</div>`;
+    }
+}
+//# sourceMappingURL=markdown.element.js.map

package/dist/src/element/markdown.element.js.map

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

package/dist/src/element/slot.element.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Router Slot Element
+ *
+ * <router-slot> is where page content is rendered.
+ * Supports nested routes via parent page containing slot.
+ *
+ * Usage:
+ * ```html
+ * <router-slot></router-slot>
+ * ```
+ *
+ * For nested routes, parent page includes:
+ * ```typescript
+ * export default function render() {
+ *   return `
+ *     <header>...</header>
+ *     <main>
+ *       <router-slot></router-slot>
+ *     </main>
+ *   `;
+ * }
+ * ```
+ */
+import { HTMLElementBase } from '../util/html.util.ts';
+/**
+ * Router slot web component.
+ * Serves as the mounting point for page content.
+ */
+export declare class RouterSlot extends HTMLElementBase {
+}

package/dist/src/element/slot.element.js

@@ -0,0 +1,31 @@
+/**
+ * Router Slot Element
+ *
+ * <router-slot> is where page content is rendered.
+ * Supports nested routes via parent page containing slot.
+ *
+ * Usage:
+ * ```html
+ * <router-slot></router-slot>
+ * ```
+ *
+ * For nested routes, parent page includes:
+ * ```typescript
+ * export default function render() {
+ *   return `
+ *     <header>...</header>
+ *     <main>
+ *       <router-slot></router-slot>
+ *     </main>
+ *   `;
+ * }
+ * ```
+ */
+import { HTMLElementBase } from "../util/html.util.js";
+/**
+ * Router slot web component.
+ * Serves as the mounting point for page content.
+ */
+export class RouterSlot extends HTMLElementBase {
+}
+//# sourceMappingURL=slot.element.js.map

package/dist/src/element/slot.element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot.element.js","sourceRoot":"","sources":["../../../src/element/slot.element.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,eAAe;CAAG"}

package/dist/src/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @emkodev/emroute
+ *
+ * Public API — types, component base classes, and utilities for consumer code.
+ *
+ * For environment-specific code, use sub-exports:
+ *   @emkodev/emroute/spa        — Browser: SPA router + custom elements
+ *   @emkodev/emroute/ssr/html   — Server: SSR HTML renderer
+ *   @emkodev/emroute/ssr/md     — Server: SSR Markdown renderer
+ *   @emkodev/emroute/server     — Production server
+ *   @emkodev/emroute/runtime    — Abstract runtime + constants
+ *   @emkodev/emroute/runtime/sitemap — Sitemap generation
+ */
+export type { ErrorBoundary, MatchedRoute, NavigateOptions, RedirectConfig, RouteConfig, RouteFiles, RouteFileType, RouteInfo, RouteParams, RouterEvent, RouterEventListener, RouterEventType, RouterState, RoutesManifest, } from './type/route.type.ts';
+export type { ParsedWidgetBlock, SpaMode, WidgetManifestEntry, WidgetsManifest, } from './type/widget.type.ts';
+export type { MarkdownRenderer } from './type/markdown.type.ts';
+export { type Logger, setLogger } from './type/logger.type.ts';
+export { Component, type ComponentContext, type ComponentManifestEntry, type ContextProvider, type FileContents, type RenderContext, } from './component/abstract.component.ts';
+export { PageComponent } from './component/page.component.ts';
+export { WidgetComponent } from './component/widget.component.ts';
+export { WidgetRegistry } from './widget/widget.registry.ts';
+export { type BasePath, DEFAULT_BASE_PATH, prefixManifest } from './route/route.core.ts';
+export { escapeHtml, scopeWidgetCss } from './util/html.util.ts';

package/dist/src/index.js

@@ -0,0 +1,24 @@
+/**
+ * @emkodev/emroute
+ *
+ * Public API — types, component base classes, and utilities for consumer code.
+ *
+ * For environment-specific code, use sub-exports:
+ *   @emkodev/emroute/spa        — Browser: SPA router + custom elements
+ *   @emkodev/emroute/ssr/html   — Server: SSR HTML renderer
+ *   @emkodev/emroute/ssr/md     — Server: SSR Markdown renderer
+ *   @emkodev/emroute/server     — Production server
+ *   @emkodev/emroute/runtime    — Abstract runtime + constants
+ *   @emkodev/emroute/runtime/sitemap — Sitemap generation
+ */
+export { setLogger } from "./type/logger.type.js";
+// Components
+export { Component, } from "./component/abstract.component.js";
+export { PageComponent } from "./component/page.component.js";
+export { WidgetComponent } from "./component/widget.component.js";
+export { WidgetRegistry } from "./widget/widget.registry.js";
+// Route config
+export { DEFAULT_BASE_PATH, prefixManifest } from "./route/route.core.js";
+// Utils
+export { escapeHtml, scopeWidgetCss } from "./util/html.util.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4BH,OAAO,EAAe,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE/D,aAAa;AACb,OAAO,EACL,SAAS,GAMV,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,eAAe;AACf,OAAO,EAAiB,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEzF,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/overlay/mod.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Overlay Module
+ *
+ * Programmatic overlay API for modals, toasts, and popovers.
+ * For simple cases, use declarative HTML (commandfor/command + popover/dialog).
+ * dismissAll() closes both programmatic and declarative overlays.
+ */
+export type { ModalOptions, OverlayService, PopoverOptions, ToastOptions } from './overlay.type.ts';
+export { createOverlayService } from './overlay.service.ts';

package/dist/src/overlay/mod.js

@@ -0,0 +1,9 @@
+/**
+ * Overlay Module
+ *
+ * Programmatic overlay API for modals, toasts, and popovers.
+ * For simple cases, use declarative HTML (commandfor/command + popover/dialog).
+ * dismissAll() closes both programmatic and declarative overlays.
+ */
+export { createOverlayService } from "./overlay.service.js";
+//# sourceMappingURL=mod.js.map

package/dist/src/overlay/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/overlay/mod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/overlay/overlay.css.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Overlay Default CSS
+ *
+ * Styles for modals, toasts, and popovers. Works for both declarative
+ * (commandfor/command + HTML attributes) and programmatic (OverlayService)
+ * overlays. Uses CSS custom properties for theming.
+ */
+export declare const overlayCSS: string;

package/dist/src/overlay/overlay.css.js

@@ -0,0 +1,170 @@
+/**
+ * Overlay Default CSS
+ *
+ * Styles for modals, toasts, and popovers. Works for both declarative
+ * (commandfor/command + HTML attributes) and programmatic (OverlayService)
+ * overlays. Uses CSS custom properties for theming.
+ */
+export const overlayCSS = /* css */ `
+:root {
+  --overlay-backdrop: oklch(0% 0 0 / 0.5);
+  --overlay-surface: oklch(100% 0 0);
+  --overlay-radius: 8px;
+  --overlay-shadow: 0 8px 32px oklch(0% 0 0 / 0.2);
+  --overlay-toast-gap: 8px;
+  --overlay-toast-duration: 5s;
+  --overlay-z: 1000;
+}
+
+/* --- Modal (dialog) --- */
+
+dialog[data-overlay-modal] {
+  border: none;
+  padding: 0;
+  background: var(--overlay-surface);
+  border-radius: var(--overlay-radius);
+  box-shadow: var(--overlay-shadow);
+  max-width: min(90vw, 560px);
+  max-height: 85vh;
+  overflow: auto;
+  opacity: 1;
+  translate: 0 0;
+  transition:
+    opacity 200ms,
+    translate 200ms;
+}
+
+dialog[data-overlay-modal][open] {
+  transition:
+    opacity 200ms,
+    translate 200ms,
+    display 200ms allow-discrete,
+    overlay 200ms allow-discrete;
+
+  @starting-style {
+    opacity: 0;
+    translate: 0 20px;
+  }
+}
+
+dialog[data-overlay-modal]::backdrop {
+  background: var(--overlay-backdrop);
+  opacity: 1;
+  transition: opacity 200ms;
+}
+
+dialog[data-overlay-modal][open]::backdrop {
+  transition:
+    opacity 200ms,
+    display 200ms allow-discrete,
+    overlay 200ms allow-discrete;
+
+  @starting-style {
+    opacity: 0;
+  }
+}
+
+dialog[data-overlay-modal][data-dismissing] {
+  opacity: 0;
+  translate: 0 20px;
+}
+
+dialog[data-overlay-modal][data-dismissing]::backdrop {
+  opacity: 0;
+}
+
+/* --- Toast container --- */
+
+[data-overlay-toast-container] {
+  position: fixed;
+  bottom: 16px;
+  right: 16px;
+  z-index: var(--overlay-z);
+  display: flex;
+  flex-direction: column;
+  gap: var(--overlay-toast-gap);
+  pointer-events: none;
+}
+
+/* --- Toast item --- */
+
+[data-overlay-toast] {
+  pointer-events: auto;
+  background: var(--overlay-surface);
+  border-radius: var(--overlay-radius);
+  box-shadow: var(--overlay-shadow);
+  padding: 12px 16px;
+  animation: overlay-toast-auto var(--overlay-toast-duration, 5s) ease-in-out forwards;
+}
+
+/* Manual toast (timeout: 0): no auto-dismiss, entry transition only */
+[data-overlay-toast][data-toast-manual] {
+  animation: none;
+  opacity: 1;
+  translate: 0 0;
+  transition:
+    opacity 200ms,
+    translate 200ms;
+
+  @starting-style {
+    opacity: 0;
+    translate: 20px 0;
+  }
+}
+
+/* Dismissed toast: CSS exit animation */
+[data-overlay-toast][data-dismissing] {
+  animation: overlay-toast-exit 200ms ease-in forwards;
+}
+
+@keyframes overlay-toast-auto {
+  0%   { opacity: 0; translate: 20px 0; }
+  10%  { opacity: 1; translate: 0 0; }
+  80%  { opacity: 1; translate: 0 0; }
+  100% { opacity: 0; translate: 0 0; display: none; }
+}
+
+@keyframes overlay-toast-exit {
+  to { opacity: 0; translate: 20px 0; display: none; }
+}
+
+/* --- Popover --- */
+
+[data-overlay-popover] {
+  border: none;
+  padding: 0;
+  margin: 0;
+  background: var(--overlay-surface);
+  border-radius: var(--overlay-radius);
+  box-shadow: var(--overlay-shadow);
+  opacity: 1;
+  scale: 1;
+  transition:
+    opacity 200ms,
+    scale 200ms;
+}
+
+[data-overlay-popover]:popover-open {
+  position-anchor: auto;
+  inset: unset;
+  top: anchor(bottom);
+  left: anchor(start);
+  margin-top: 4px;
+  transition:
+    opacity 200ms,
+    scale 200ms,
+    display 200ms allow-discrete,
+    overlay 200ms allow-discrete;
+
+  @starting-style {
+    opacity: 0;
+    scale: 0.95;
+  }
+}
+
+[data-overlay-popover][data-dismissing] {
+  opacity: 0;
+  scale: 0.95;
+}
+`;
+//# sourceMappingURL=overlay.css.js.map

package/dist/src/overlay/overlay.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.css.js","sourceRoot":"","sources":["../../../src/overlay/overlay.css.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAW,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiK3C,CAAC"}

package/dist/src/overlay/overlay.service.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Overlay Service
+ *
+ * Programmatic API for modals, toasts, and popovers. For simple trigger
+ * patterns, use declarative HTML (commandfor/command + popover/dialog)
+ * with zero JS. This service covers dynamic content, programmatic
+ * triggers, and complex workflows.
+ *
+ * dismissAll() is DOM-aware: it closes both programmatic overlays
+ * managed by this service AND declarative popovers/dialogs found
+ * via DOM queries.
+ */
+import type { OverlayService } from './overlay.type.ts';
+export declare function createOverlayService(): OverlayService;