@fiyuu/runtime 0.4.2 → 0.4.3

package/dist/inspector.js

@@ -0,0 +1,262 @@
+import { promises as fs, existsSync } from "node:fs";
+import path from "node:path";
+export async function buildInsightsReport(options) {
+    const items = await collectInsightItems(options);
+    const assistant = await buildAssistantOutput(options, items);
+    const summary = {
+        total: items.length,
+        high: items.filter((item) => item.severity === "high").length,
+        medium: items.filter((item) => item.severity === "medium").length,
+        low: items.filter((item) => item.severity === "low").length,
+    };
+    return {
+        generatedAt: new Date().toISOString(),
+        summary,
+        items,
+        assistant,
+    };
+}
+async function collectInsightItems(options) {
+    const items = [];
+    for (const feature of options.features) {
+        items.push(...toFeatureStructureInsights(feature));
+        const fileEntries = Object.entries(feature.files).filter((entry) => Boolean(entry[1]));
+        for (const [, filePath] of fileEntries) {
+            const source = await readFileSafe(filePath);
+            if (!source) {
+                continue;
+            }
+            if (/dangerouslySetInnerHTML/.test(source)) {
+                items.push({
+                    id: `security-dangerous-html-${filePath}`,
+                    category: "security",
+                    severity: "high",
+                    title: "Potential XSS surface detected",
+                    summary: "`dangerouslySetInnerHTML` is used in a route module.",
+                    recommendation: "Prefer escaped rendering or sanitize content before passing HTML strings.",
+                    route: feature.route,
+                    file: filePath,
+                    fixable: true,
+                });
+            }
+            if (/\beval\s*\(|new\s+Function\s*\(/.test(source)) {
+                items.push({
+                    id: `security-dynamic-eval-${filePath}`,
+                    category: "security",
+                    severity: "high",
+                    title: "Dynamic code execution detected",
+                    summary: "`eval` or `new Function` appears in application logic.",
+                    recommendation: "Replace dynamic execution with explicit, typed control flow.",
+                    route: feature.route,
+                    file: filePath,
+                    fixable: true,
+                });
+            }
+            const lineCount = source.split(/\r?\n/).length;
+            if (lineCount > 450) {
+                items.push({
+                    id: `performance-large-module-${filePath}`,
+                    category: "performance",
+                    severity: "medium",
+                    title: "Large route module",
+                    summary: `Module has ${lineCount} lines and may increase parse and hydration cost.`,
+                    recommendation: "Split heavy route logic into smaller server/client helpers.",
+                    route: feature.route,
+                    file: filePath,
+                    fixable: true,
+                });
+            }
+        }
+        if (feature.files["meta.ts"]) {
+            const metaSource = await readFileSafe(feature.files["meta.ts"]);
+            if (metaSource) {
+                const seoTitle = extractSeoField(metaSource, "title");
+                const seoDescription = extractSeoField(metaSource, "description");
+                if (!seoTitle) {
+                    items.push({
+                        id: `design-missing-seo-title-${feature.route}`,
+                        category: "design",
+                        severity: "low",
+                        title: "SEO title missing in meta",
+                        summary: "`meta.ts` exists but does not define `seo.title`.",
+                        recommendation: "Add route-specific `seo.title` to improve previews and search snippets.",
+                        route: feature.route,
+                        file: feature.files["meta.ts"],
+                        fixable: true,
+                    });
+                }
+                else if (seoTitle.length > 62) {
+                    items.push({
+                        id: `design-seo-title-length-${feature.route}`,
+                        category: "design",
+                        severity: "low",
+                        title: "SEO title is longer than recommended",
+                        summary: `Current title length is ${seoTitle.length} characters.`,
+                        recommendation: "Keep seo titles around 45-60 characters to avoid truncation in SERP previews.",
+                        route: feature.route,
+                        file: feature.files["meta.ts"],
+                        fixable: true,
+                    });
+                }
+                if (!seoDescription) {
+                    items.push({
+                        id: `design-missing-seo-description-${feature.route}`,
+                        category: "design",
+                        severity: "medium",
+                        title: "SEO description missing in meta",
+                        summary: "`meta.ts` does not define `seo.description`.",
+                        recommendation: "Add a concise description (90-160 chars) for better search and social previews.",
+                        route: feature.route,
+                        file: feature.files["meta.ts"],
+                        fixable: true,
+                    });
+                }
+                else if (seoDescription.length < 80 || seoDescription.length > 170) {
+                    items.push({
+                        id: `design-seo-description-length-${feature.route}`,
+                        category: "design",
+                        severity: "low",
+                        title: "SEO description length can be improved",
+                        summary: `Current description length is ${seoDescription.length} characters.`,
+                        recommendation: "Keep seo descriptions in the 90-160 character range for reliable previews.",
+                        route: feature.route,
+                        file: feature.files["meta.ts"],
+                        fixable: true,
+                    });
+                }
+            }
+        }
+    }
+    items.push(...(await collectGlobalSecurityInsights(options.appDirectory)));
+    items.push(...collectGlobalRenderInsights(options.features));
+    return dedupeInsights(items);
+}
+function toFeatureStructureInsights(feature) {
+    const items = [];
+    for (const missing of feature.missingRequiredFiles) {
+        items.push({
+            id: `architecture-missing-${feature.route}-${missing}`,
+            category: "architecture",
+            severity: missing === "schema.ts" ? "high" : "medium",
+            title: `Required file missing: ${missing}`,
+            summary: `Feature ${feature.route} is missing ${missing}.`,
+            recommendation: "Complete the feature contract so tooling and AI context stay deterministic.",
+            route: feature.route,
+            file: path.join(feature.directory, missing),
+            fixable: true,
+        });
+    }
+    return items;
+}
+async function collectGlobalSecurityInsights(appDirectory) {
+    const items = [];
+    const middlewarePath = path.join(appDirectory, "middleware.ts");
+    if (existsSync(middlewarePath)) {
+        const middlewareSource = await readFileSafe(middlewarePath);
+        if (middlewareSource && /access-control-allow-origin["']?\s*[:,=]\s*["']\*/i.test(middlewareSource)) {
+            items.push({
+                id: "security-open-cors-middleware",
+                category: "security",
+                severity: "high",
+                title: "Wildcard CORS header in middleware",
+                summary: "Middleware appears to allow all origins globally.",
+                recommendation: "Restrict allowed origins by environment and keep credentials disabled for public origins.",
+                file: middlewarePath,
+                fixable: true,
+            });
+        }
+    }
+    return items;
+}
+function collectGlobalRenderInsights(features) {
+    const csrCount = features.filter((feature) => feature.render === "csr").length;
+    if (features.length < 4) {
+        return [];
+    }
+    const ratio = csrCount / features.length;
+    if (ratio < 0.6) {
+        return [];
+    }
+    return [
+        {
+            id: "performance-csr-heavy",
+            category: "performance",
+            severity: ratio > 0.8 ? "high" : "medium",
+            title: "Project is CSR-heavy",
+            summary: `${csrCount}/${features.length} routes render in CSR mode.`,
+            recommendation: "Move content-driven pages to SSR where possible to reduce blank-first-paint risk.",
+            fixable: true,
+        },
+    ];
+}
+async function buildAssistantOutput(options, items) {
+    void options;
+    return {
+        mode: "rule-only",
+        status: "ready",
+        details: "Using deterministic project checks (no integrated model).",
+        suggestions: createRuleBasedSuggestions(items),
+    };
+}
+function createRuleBasedSuggestions(items) {
+    if (items.length === 0) {
+        return [
+            "Run `fiyuu doctor --fix` after scaffolding new routes to keep contracts deterministic.",
+            "Keep SEO descriptions in 12-28 words and route-specific titles for stable search snippets.",
+            "Add focused tests around auth, middleware, and API routes before release builds.",
+        ];
+    }
+    const topItems = items
+        .slice()
+        .sort((left, right) => severityScore(right.severity) - severityScore(left.severity))
+        .slice(0, 4);
+    return [
+        ...topItems.map((item) => `${capitalize(item.category)}: ${item.recommendation}`),
+        "Use `fiyuu doctor --fix` for safe auto-fixes (SEO fields, missing execute(), fallback pages, className->class).",
+    ].slice(0, 6);
+}
+function dedupeInsights(items) {
+    const seen = new Set();
+    const output = [];
+    for (const item of items) {
+        if (seen.has(item.id)) {
+            continue;
+        }
+        seen.add(item.id);
+        output.push(item);
+    }
+    return output;
+}
+async function readFileSafe(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function severityScore(severity) {
+    if (severity === "high") {
+        return 3;
+    }
+    if (severity === "medium") {
+        return 2;
+    }
+    return 1;
+}
+function capitalize(value) {
+    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;
+}
+function extractSeoField(source, field) {
+    const seoBlock = source.match(/seo\s*:\s*\{([\s\S]*?)\}/m);
+    if (!seoBlock) {
+        return null;
+    }
+    const fieldRegex = new RegExp(`${field}\\s*:\\s*(["'\`])([\\s\\S]*?)\\1`, "m");
+    const match = seoBlock[1].match(fieldRegex);
+    if (!match) {
+        return null;
+    }
+    return match[2].trim() || null;
+}
+//# sourceMappingURL=inspector.js.map

package/dist/inspector.js.map

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

package/dist/server-devtools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dev-only browser script generators for the Fiyuu runtime.
+ * These return inline <script> strings injected into the rendered document.
+ */
+import type { RenderMode } from "@fiyuu/core";
+export declare function renderInsightsPanelScript(): string;
+export declare function renderUnifiedToolsScript(input: {
+    route: string;
+    render: RenderMode;
+    renderTimeMs: number;
+    warnings: string[];
+    requestId: string;
+}): string;
+//# sourceMappingURL=server-devtools.d.ts.map

package/dist/server-devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-devtools.d.ts","sourceRoot":"","sources":["../../../../packages/runtime/src/server-devtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,yBAAyB,IAAI,MAAM,CAqDlD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAgET"}

package/dist/server-devtools.js

@@ -0,0 +1,123 @@
+/**
+ * Dev-only browser script generators for the Fiyuu runtime.
+ * These return inline <script> strings injected into the rendered document.
+ */
+export function renderInsightsPanelScript() {
+    return `<script type="module">
+const host=document.createElement('div');
+host.style.cssText='position:fixed;left:16px;bottom:16px;z-index:9998;font:12px/1.5 ui-monospace,monospace';
+const toggle=document.createElement('button');
+toggle.textContent='Fiyuu Insights';
+toggle.style.cssText='border:1px solid rgba(197,214,181,.18);background:rgba(18,24,19,.94);color:#f8f3ea;border-radius:999px;padding:10px 14px;box-shadow:0 18px 56px rgba(0,0,0,.22);cursor:pointer';
+const panel=document.createElement('aside');
+panel.style.cssText='display:none;margin-top:10px;width:min(420px,calc(100vw - 30px));max-height:min(72vh,620px);overflow:auto;background:rgba(18,24,19,.96);color:#f8f3ea;border:1px solid rgba(197,214,181,.16);border-radius:18px;padding:14px 16px;box-shadow:0 18px 56px rgba(0,0,0,.22);backdrop-filter:blur(14px)';
+toggle.addEventListener('click',()=>{panel.style.display=panel.style.display==='none'?'block':'none';});
+
+function renderItems(items){
+  if(!items.length){return '<li style="margin-top:6px">No findings.</li>'}
+  return items.slice(0,8).map((item)=>'<li style="margin-top:8px"><strong>['+item.severity.toUpperCase()+'] '+item.title+'</strong><br/><span style="opacity:.82">'+item.summary+'</span><br/><span style="opacity:.7">'+item.recommendation+'</span></li>').join('');
+}
+
+async function mount(){
+  const response=await fetch('/__fiyuu/insights');
+  const data=await response.json();
+  const byCategory={
+    security:(data.items||[]).filter((item)=>item.category==='security'),
+    performance:(data.items||[]).filter((item)=>item.category==='performance'),
+    design:(data.items||[]).filter((item)=>item.category==='design'),
+    architecture:(data.items||[]).filter((item)=>item.category==='architecture'),
+  };
+  panel.innerHTML=''
+    +'<div style="display:flex;justify-content:space-between;gap:10px;align-items:center"><strong>AI Insights</strong><span style="opacity:.7">'+(data.generatedAt||'')+'</span></div>'
+    +'<p style="margin:8px 0 0;opacity:.82">'+data.summary.high+' high · '+data.summary.medium+' medium · '+data.summary.low+' low</p>'
+    +'<div style="margin-top:10px;display:flex;gap:8px"><button data-tab="findings" style="padding:6px 10px;border-radius:999px;border:1px solid rgba(197,214,181,.16);background:rgba(255,255,255,.06);color:#f8f3ea;cursor:pointer">Findings</button><button data-tab="assistant" style="padding:6px 10px;border-radius:999px;border:1px solid rgba(197,214,181,.16);background:transparent;color:#f8f3ea;cursor:pointer">Assistant</button></div>'
+    +'<section data-view="findings" style="margin-top:10px">'
+    +'<p style="margin:0"><strong>Security</strong></p><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.security)+'</ul>'
+    +'<p style="margin:10px 0 0"><strong>Performance</strong></p><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.performance)+'</ul>'
+    +'<p style="margin:10px 0 0"><strong>Design</strong></p><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.design)+'</ul>'
+    +'<p style="margin:10px 0 0"><strong>Architecture</strong></p><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.architecture)+'</ul>'
+    +'</section>'
+    +'<section data-view="assistant" style="display:none;margin-top:10px">'
+    +'<p style="margin:0;opacity:.84">Mode: '+data.assistant.mode+' · '+data.assistant.status+'</p>'
+    +'<p style="margin:8px 0 0;opacity:.72">'+data.assistant.details+'</p>'
+    +'<ul style="margin:8px 0 0;padding-left:18px">'+(data.assistant.suggestions||[]).map((line)=>'<li style="margin-top:6px">'+line+'</li>').join('')+'</ul>'
+    +'</section>';
+
+  const findingsButton=panel.querySelector('[data-tab="findings"]');
+  const assistantButton=panel.querySelector('[data-tab="assistant"]');
+  const findingsView=panel.querySelector('[data-view="findings"]');
+  const assistantView=panel.querySelector('[data-view="assistant"]');
+  findingsButton?.addEventListener('click',()=>{findingsView.style.display='block';assistantView.style.display='none';findingsButton.style.background='rgba(255,255,255,.06)';assistantButton.style.background='transparent';});
+  assistantButton?.addEventListener('click',()=>{findingsView.style.display='none';assistantView.style.display='block';assistantButton.style.background='rgba(255,255,255,.06)';findingsButton.style.background='transparent';});
+}
+
+mount().catch((error)=>{console.warn('Fiyuu insights panel failed',error);});
+host.append(toggle,panel);
+document.body.append(host);
+</script>`;
+}
+export function renderUnifiedToolsScript(input) {
+    const metrics = JSON.stringify({
+        route: input.route,
+        render: input.render,
+        renderTimeMs: input.renderTimeMs,
+        warnings: input.warnings,
+        requestId: input.requestId,
+    });
+    return `<script type="module">(function(){
+const metrics=${metrics};
+const removeLegacyPanels=()=>{const old=[...document.querySelectorAll('button')].filter((button)=>button.textContent==='Fiyuu Devtools'||button.textContent==='Fiyuu Insights');for(const button of old){const host=button.closest('div');if(host&&host.parentNode){host.parentNode.removeChild(host);}}};
+removeLegacyPanels();
+setInterval(removeLegacyPanels,500);
+
+const host=document.createElement('div');
+host.style.cssText='position:fixed;right:16px;bottom:16px;z-index:10001;font:12px/1.5 ui-monospace,monospace';
+const toggle=document.createElement('button');
+toggle.textContent='Fiyuu Console';
+toggle.style.cssText='border:1px solid rgba(197,214,181,.18);background:rgba(18,24,19,.94);color:#f8f3ea;border-radius:999px;padding:10px 14px;box-shadow:0 18px 56px rgba(0,0,0,.22);cursor:pointer';
+const panel=document.createElement('aside');
+panel.style.cssText='display:none;margin-top:10px;width:min(500px,calc(100vw - 30px));max-height:min(78vh,700px);overflow:auto;background:rgba(18,24,19,.96);color:#f8f3ea;border:1px solid rgba(197,214,181,.16);border-radius:18px;padding:14px 16px;box-shadow:0 18px 56px rgba(0,0,0,.22);backdrop-filter:blur(14px)';
+toggle.addEventListener('click',()=>{panel.style.display=panel.style.display==='none'?'block':'none';});
+
+let serverTraceEnabled=false;
+let pollingId;
+const renderItems=(items)=>{if(!items.length){return '<li style="margin-top:6px">No findings.</li>';}return items.slice(0,8).map((item)=>'<li style="margin-top:8px"><strong>['+item.severity.toUpperCase()+'] '+item.title+'</strong><br/><span style="opacity:.82">'+item.summary+'</span><br/><span style="opacity:.72">'+item.recommendation+'</span></li>').join('');};
+const renderServerItems=(events)=>{if(!events||!events.length){return '<li style="margin-top:6px">No server activity yet.</li>';}return events.slice(0,40).map((event)=>'<li style="margin-top:8px"><strong>'+event.event+'</strong><span style="opacity:.7"> ['+event.level.toUpperCase()+']</span><br/><span style="opacity:.75">'+event.at+'</span><br/><span style="opacity:.82">'+(event.details||'')+'</span></li>').join('');};
+const refreshServerEvents=async()=>{if(!serverTraceEnabled){return;}const response=await fetch('/__fiyuu/server-events');if(!response.ok){return;}const payload=await response.json();const list=panel.querySelector('[data-server-list]');if(list){list.innerHTML=renderServerItems(payload.events||[]);}};
+const startServerTrace=()=>{if(pollingId){clearInterval(pollingId);}pollingId=setInterval(()=>{refreshServerEvents().catch(()=>{});},1200);refreshServerEvents().catch(()=>{});};
+const stopServerTrace=()=>{if(pollingId){clearInterval(pollingId);pollingId=undefined;}};
+
+const mount=async()=>{
+  const [runtimeResponse,insightsResponse]=await Promise.all([fetch('/__fiyuu/devtools'),fetch('/__fiyuu/insights')]);
+  const runtime=runtimeResponse.ok?await runtimeResponse.json():{warnings:[],config:{featureFlags:{}}};
+  const insights=insightsResponse.ok?await insightsResponse.json():{summary:{high:0,medium:0,low:0},assistant:{mode:'rule-only',status:'fallback',details:'unavailable'},items:[]};
+  const warnings=(metrics.warnings.length?metrics.warnings:(runtime.warnings||[])).slice(0,4);
+  const flags=Object.entries((runtime.config&&runtime.config.featureFlags)||{}).map(([k,v])=>'<span style="display:inline-flex;margin:4px 6px 0 0;padding:3px 8px;border-radius:999px;background:rgba(233,240,224,.08)">'+k+': '+v+'</span>').join('')||'<span style="opacity:.7">none</span>';
+  const byCategory={security:(insights.items||[]).filter((i)=>i.category==='security'),performance:(insights.items||[]).filter((i)=>i.category==='performance'),design:(insights.items||[]).filter((i)=>i.category==='design'),architecture:(insights.items||[]).filter((i)=>i.category==='architecture')};
+
+  panel.innerHTML=''
+    +'<div style="display:flex;justify-content:space-between;gap:10px;align-items:center"><strong>Fiyuu Console</strong><span style="opacity:.7">'+metrics.requestId+'</span></div>'
+    +'<div style="margin-top:10px;display:flex;gap:8px"><button data-tab="runtime" style="padding:6px 10px;border-radius:999px;border:1px solid rgba(197,214,181,.16);background:rgba(255,255,255,.06);color:#f8f3ea;cursor:pointer">Runtime</button><button data-tab="insights" style="padding:6px 10px;border-radius:999px;border:1px solid rgba(197,214,181,.16);background:transparent;color:#f8f3ea;cursor:pointer">Insights</button><button data-tab="server" style="padding:6px 10px;border-radius:999px;border:1px solid rgba(197,214,181,.16);background:transparent;color:#f8f3ea;cursor:pointer">Server</button></div>'
+    +'<section data-view="runtime" style="margin-top:12px"><p style="margin:0;opacity:.86">Route <strong>'+metrics.route+'</strong> · '+String(metrics.render).toUpperCase()+' · '+metrics.renderTimeMs+'ms</p><p style="margin:8px 0 0;opacity:.7">Warnings</p><ul style="margin:6px 0 0;padding-left:18px">'+(warnings.map((w)=>'<li style="margin-top:6px">'+w+'</li>').join('')||'<li style="margin-top:6px">none</li>')+'</ul><p style="margin:10px 0 0;opacity:.7">Feature Flags</p><div style="margin-top:6px">'+flags+'</div></section>'
+    +'<section data-view="insights" style="display:none;margin-top:12px"><p style="margin:0;opacity:.86">'+insights.summary.high+' high · '+insights.summary.medium+' medium · '+insights.summary.low+' low</p><p style="margin:8px 0 0;opacity:.72">Assistant: '+insights.assistant.mode+' ('+insights.assistant.status+')</p><p style="margin:8px 0 0;opacity:.72">'+insights.assistant.details+'</p><div style="margin-top:10px"><strong>Security</strong><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.security)+'</ul></div><div style="margin-top:10px"><strong>Performance</strong><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.performance)+'</ul></div><div style="margin-top:10px"><strong>Design</strong><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.design)+'</ul></div><div style="margin-top:10px"><strong>Architecture</strong><ul style="margin:6px 0 0;padding-left:18px">'+renderItems(byCategory.architecture)+'</ul></div></section>'
+    +'<section data-view="server" style="display:none;margin-top:12px"><label style="display:flex;align-items:center;gap:8px"><input data-server-toggle type="checkbox"/> <span>Enable live server trace (dev only)</span></label><ul data-server-list style="margin:10px 0 0;padding-left:18px"></ul></section>';
+
+  const runtimeButton=panel.querySelector('[data-tab="runtime"]');
+  const insightsButton=panel.querySelector('[data-tab="insights"]');
+  const serverButton=panel.querySelector('[data-tab="server"]');
+  const runtimeView=panel.querySelector('[data-view="runtime"]');
+  const insightsView=panel.querySelector('[data-view="insights"]');
+  const serverView=panel.querySelector('[data-view="server"]');
+  const serverToggle=panel.querySelector('[data-server-toggle]');
+  runtimeButton?.addEventListener('click',()=>{runtimeView.style.display='block';insightsView.style.display='none';serverView.style.display='none';runtimeButton.style.background='rgba(255,255,255,.06)';insightsButton.style.background='transparent';serverButton.style.background='transparent';});
+  insightsButton?.addEventListener('click',()=>{runtimeView.style.display='none';insightsView.style.display='block';serverView.style.display='none';insightsButton.style.background='rgba(255,255,255,.06)';runtimeButton.style.background='transparent';serverButton.style.background='transparent';});
+  serverButton?.addEventListener('click',()=>{runtimeView.style.display='none';insightsView.style.display='none';serverView.style.display='block';serverButton.style.background='rgba(255,255,255,.06)';runtimeButton.style.background='transparent';insightsButton.style.background='transparent';});
+  serverToggle?.addEventListener('change',(event)=>{serverTraceEnabled=Boolean(event.target&&event.target.checked);if(serverTraceEnabled){startServerTrace();}else{stopServerTrace();}});
+};
+
+mount().catch((error)=>{console.warn('Fiyuu console mount failed',error);});
+host.append(toggle,panel);
+document.body.append(host);
+})();</script>`;
+}
+//# sourceMappingURL=server-devtools.js.map

package/dist/server-devtools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-devtools.js","sourceRoot":"","sources":["../../../../packages/runtime/src/server-devtools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAmDC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAMxC;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,OAAO;gBACO,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAqDR,CAAC;AAChB,CAAC"}

package/dist/server-loader.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Module loading, layout stacking, meta merging, query caching,
+ * and GEA component rendering for the Fiyuu runtime server.
+ */
+import type { FeatureRecord, MetaDefinition } from "@fiyuu/core";
+import type { RuntimeState } from "./server-types.js";
+export declare function importModule(modulePath: string, mode: "dev" | "start"): Promise<unknown>;
+export declare function resolveApiRouteModule(appDirectory: string, pathname: string): string | null;
+export declare function loadMetaFile(filePath: string, mode: "dev" | "start"): Promise<MetaDefinition>;
+export declare function loadLayoutMeta(directory: string, mode: "dev" | "start"): Promise<MetaDefinition>;
+export declare function mergeMetaDefinitions(...definitions: MetaDefinition[]): MetaDefinition;
+export declare function loadLayoutStack(appDirectory: string, feature: FeatureRecord, mode: "dev" | "start"): Promise<Array<{
+    component: unknown;
+    meta: MetaDefinition;
+}>>;
+export declare function loadFeatureMeta(feature: FeatureRecord, mode: "dev" | "start"): Promise<MetaDefinition>;
+export declare function getCachedLayoutStack(state: RuntimeState, appDirectory: string, feature: FeatureRecord, mode: "dev" | "start"): Promise<Array<{
+    component: unknown;
+    meta: MetaDefinition;
+}>>;
+export declare function getCachedMergedMeta(state: RuntimeState, feature: FeatureRecord, layoutStack: Array<{
+    component: unknown;
+    meta: MetaDefinition;
+}>, mode: "dev" | "start"): Promise<MetaDefinition>;
+export declare function pruneQueryCache(state: RuntimeState, now: number): void;
+export declare function renderGeaComponent(component: unknown, props: Record<string, unknown>): string;
+//# sourceMappingURL=server-loader.d.ts.map

package/dist/server-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-loader.d.ts","sourceRoot":"","sources":["../../../../packages/runtime/src/server-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAA4C,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKhG,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB9F;AAID,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3F;AAID,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAMnG;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAEtG;AAED,wBAAgB,oBAAoB,CAAC,GAAG,WAAW,EAAE,cAAc,EAAE,GAAG,cAAc,CAYrF;AAID,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,KAAK,GAAG,OAAO,GACpB,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC,CAAC,CAmB9D;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAI5G;AAID,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,KAAK,GAAG,OAAO,GACpB,OAAO,CAAC,KAAK,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC,CAAC,CAO9D;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC,EAChE,IAAI,EAAE,KAAK,GAAG,OAAO,GACpB,OAAO,CAAC,cAAc,CAAC,CAazB;AAID,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAwBtE;AAMD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA2B7F"}

package/dist/server-loader.js

@@ -0,0 +1,159 @@
+/**
+ * Module loading, layout stacking, meta merging, query caching,
+ * and GEA component rendering for the Fiyuu runtime server.
+ */
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { QUERY_CACHE_MAX_ENTRIES, QUERY_CACHE_SWEEP_INTERVAL_MS } from "./server-router.js";
+// ── Dynamic module import ─────────────────────────────────────────────────────
+export async function importModule(modulePath, mode) {
+    const fileUrl = pathToFileURL(modulePath).href;
+    try {
+        return await import(mode === "dev" ? `${fileUrl}?t=${Date.now()}` : fileUrl);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const shortPath = modulePath.replace(process.cwd(), ".");
+        let hint = "";
+        if (message.includes("Cannot find package") || message.includes("ERR_MODULE_NOT_FOUND")) {
+            const match = message.match(/Cannot find (?:package|module) '([^']+)'/);
+            const missing = match ? match[1] : "a dependency";
+            hint = `\n  → Missing package: "${missing}". Run \`npm install\` in the project root.`;
+        }
+        else if (message.includes("SyntaxError") || message.includes("Unexpected token")) {
+            hint = `\n  → Syntax error in ${shortPath}. Check for typos or invalid TypeScript.`;
+        }
+        else if (message.includes("ERR_INVALID_URL")) {
+            hint = `\n  → Invalid file path: ${shortPath}`;
+        }
+        const enhanced = new Error(`Failed to load module: ${shortPath}\n  ${message}${hint}`);
+        enhanced.stack = err instanceof Error ? err.stack : undefined;
+        throw enhanced;
+    }
+}
+// ── API route resolution ──────────────────────────────────────────────────────
+export function resolveApiRouteModule(appDirectory, pathname) {
+    const relativePath = pathname.replace(/^\//, "");
+    const normalizedRoot = path.resolve(appDirectory) + path.sep;
+    const directModule = path.resolve(appDirectory, relativePath, "route.ts");
+    if (!directModule.startsWith(normalizedRoot))
+        return null; // path traversal guard
+    if (existsSync(directModule))
+        return directModule;
+    const rootModule = path.resolve(appDirectory, relativePath + ".ts");
+    if (!rootModule.startsWith(normalizedRoot))
+        return null; // path traversal guard
+    return existsSync(rootModule) ? rootModule : null;
+}
+// ── Meta loading & merging ────────────────────────────────────────────────────
+export async function loadMetaFile(filePath, mode) {
+    if (!existsSync(filePath)) {
+        return { intent: "" };
+    }
+    const module = (await importModule(filePath, mode));
+    return module.default ?? { intent: "" };
+}
+export async function loadLayoutMeta(directory, mode) {
+    return loadMetaFile(path.join(directory, "layout.meta.ts"), mode);
+}
+export function mergeMetaDefinitions(...definitions) {
+    return definitions.reduce((current, item) => ({
+        ...current,
+        ...item,
+        seo: {
+            ...current.seo,
+            ...item.seo,
+        },
+    }), { intent: "" });
+}
+// ── Layout stack loading ──────────────────────────────────────────────────────
+export async function loadLayoutStack(appDirectory, feature, mode) {
+    const parts = feature.feature ? feature.feature.split("/") : [];
+    const directories = [appDirectory];
+    for (let index = 0; index < parts.length; index += 1) {
+        directories.push(path.join(appDirectory, ...parts.slice(0, index + 1)));
+    }
+    const stack = [];
+    for (const directory of directories) {
+        const layoutFile = path.join(directory, "layout.tsx");
+        const metaFile = path.join(directory, "layout.meta.ts");
+        if (existsSync(layoutFile)) {
+            const module = (await importModule(layoutFile, mode));
+            if (module.default) {
+                stack.push({ component: module.default, meta: await loadMetaFile(metaFile, mode) });
+            }
+        }
+    }
+    return stack;
+}
+export async function loadFeatureMeta(feature, mode) {
+    return feature.files["meta.ts"]
+        ? loadMetaFile(feature.files["meta.ts"], mode)
+        : { intent: feature.intent ?? "" };
+}
+// ── Cached layout stack (production only) ────────────────────────────────────
+export async function getCachedLayoutStack(state, appDirectory, feature, mode) {
+    const cached = state.layoutStackCache.get(feature.route);
+    if (cached)
+        return cached;
+    const layoutStack = await loadLayoutStack(appDirectory, feature, mode);
+    state.layoutStackCache.set(feature.route, layoutStack);
+    return layoutStack;
+}
+export async function getCachedMergedMeta(state, feature, layoutStack, mode) {
+    const cached = state.mergedMetaCache.get(feature.route);
+    if (cached)
+        return cached;
+    let featureMeta = state.featureMetaCache.get(feature.route);
+    if (!featureMeta) {
+        featureMeta = await loadFeatureMeta(feature, mode);
+        state.featureMetaCache.set(feature.route, featureMeta);
+    }
+    const merged = mergeMetaDefinitions(...layoutStack.map((item) => item.meta), featureMeta);
+    state.mergedMetaCache.set(feature.route, merged);
+    return merged;
+}
+// ── Query cache ───────────────────────────────────────────────────────────────
+export function pruneQueryCache(state, now) {
+    if (now - state.queryCacheLastPruneAt < QUERY_CACHE_SWEEP_INTERVAL_MS &&
+        state.queryCache.size < QUERY_CACHE_MAX_ENTRIES) {
+        return;
+    }
+    state.queryCacheLastPruneAt = now;
+    for (const [key, entry] of state.queryCache) {
+        if (entry.expiresAt <= now) {
+            state.queryCache.delete(key);
+        }
+    }
+    if (state.queryCache.size <= QUERY_CACHE_MAX_ENTRIES)
+        return;
+    const survivors = [...state.queryCache.entries()].sort((left, right) => left[1].expiresAt - right[1].expiresAt);
+    const overflowCount = survivors.length - QUERY_CACHE_MAX_ENTRIES;
+    for (let index = 0; index < overflowCount; index += 1) {
+        state.queryCache.delete(survivors[index][0]);
+    }
+}
+// ── GEA component rendering ───────────────────────────────────────────────────
+const geaComponentModeCache = new WeakMap();
+export function renderGeaComponent(component, props) {
+    if (typeof component !== "function") {
+        throw new Error("Route module default export must be a Gea component class or function.");
+    }
+    const candidate = component;
+    const componentKey = candidate;
+    const cachedMode = geaComponentModeCache.get(componentKey);
+    const mode = cachedMode ?? (typeof candidate.prototype?.template === "function" ? "class" : "function");
+    if (!cachedMode) {
+        geaComponentModeCache.set(componentKey, mode);
+    }
+    if (mode === "class") {
+        const instance = new candidate(props);
+        if (typeof instance.template === "function") {
+            return String(instance.template(instance.props ?? props));
+        }
+        return String(instance.toString());
+    }
+    return String(candidate(props));
+}
+//# sourceMappingURL=server-loader.js.map