import { html, nothing } from 'lit'; import { LightElement } from '../lib/base.js'; import { t } from '../lib/i18n.js'; import { setSlice, clearSlice } from '../lib/view-context.js'; /// The view-context slice this page owns (see `lib/view-context.js`). const VIEW_SLICE = 'entity@plugin-page-host'; // Host for plugin-contributed pages (`#plugin//`). // // The frontend knows nothing about what a plugin page does: on navigation it // dynamic-imports the fragment ES module the plugin serves from its own router // (`/api/plugin//`), registers its default-exported HTMLElement // class as a custom element, and mounts it with the `plugin-id` attribute set. // The fragment talks to its backend only through `/api/plugin//…` and runs // with the full session privileges — plugins are trusted (they ship in the // binary). See `Plugin::web_pages` in core-api for the fragment contract. export class PluginPageHost extends LightElement { static get properties() { return { _open: { state: true }, _route: { state: true }, // "plugin//" while open _error: { state: true }, _loading: { state: true }, }; } constructor() { super(); this._open = false; this._route = null; this._error = null; this._loading = false; this._mounted = null; // currently mounted fragment element this._titles = new Map(); // "plugin/page" element tag → the page's own title } connectedCallback() { super.connectedCallback(); this.style.display = 'none'; window.addEventListener('llm-page-change', (e) => { const page = e.detail.page || ''; if (page.startsWith('plugin/')) { this._openPage(page); } else { this._open = false; this._route = null; this.style.display = 'none'; clearSlice(VIEW_SLICE); } }); } disconnectedCallback() { clearSlice(VIEW_SLICE); super.disconnectedCallback(); } async _openPage(route) { this._open = true; this.style.display = 'flex'; if (route === this._route) return; this._route = route; this._error = null; this._loading = true; const [, pluginId, pageId] = route.split('/'); // The entity slice: which plugin page this is. The ids go out at once; the // page's own title — the part the route cannot carry — replaces them as // soon as the pages list resolves (cached: a re-open refetches nothing). setSlice(VIEW_SLICE, [{ label: 'Open plugin page', value: `${pluginId} / ${pageId}` }]); const tag = `skald-plugin-${pluginId}-${pageId}`; try { if (!customElements.get(tag)) { const page = await this._resolvePage(pluginId, pageId); this._titles.set(tag, page.title); const mod = await import(/* @vite-ignore */ page.entry_url); const cls = mod.default; if (!cls || !(cls.prototype instanceof HTMLElement)) { throw new Error('fragment must default-export an HTMLElement class'); } customElements.define(tag, cls); } const title = this._titles.get(tag); if (title && this._route === route) { setSlice(VIEW_SLICE, [{ label: 'Open plugin page', value: `${title} (${pluginId} / ${pageId})` }]); } const el = document.createElement(tag); el.setAttribute('plugin-id', pluginId); if (this._mounted) this._mounted.remove(); this._mounted = el; } catch (e) { this._error = e.message || String(e); if (this._mounted) { this._mounted.remove(); this._mounted = null; } } finally { this._loading = false; } } async _resolvePage(pluginId, pageId) { const res = await fetch('/api/plugins/pages'); if (!res.ok) throw new Error(`HTTP ${res.status}`); const pages = await res.json(); const page = pages.find(p => p.plugin_id === pluginId && p.page_id === pageId); if (!page) throw new Error(t('plugin_page.unavailable')); return page; } render() { if (!this._open) return nothing; return html` ${this._loading ? html`
${t('plugin_page.loading')}
` : nothing} ${this._error ? html`
${this._error}
` : nothing} ${this._mounted && !this._error ? this._mounted : nothing} `; } }