@openuji/render-respec 0.1.0

package/dist/render/diagnostics.d.ts

@@ -0,0 +1,19 @@
+import type { LintResult } from '@openuji/speculator-lint';
+export interface DiagnosticsByFile {
+    [file: string]: Array<{
+        code: string;
+        severity: 'error' | 'warning' | 'info';
+        message: string;
+        line?: number;
+        column?: number;
+    }>;
+}
+/**
+ * Group diagnostics by file
+ */
+export declare function groupDiagnosticsByFile(lintResult: LintResult): DiagnosticsByFile;
+/**
+ * Render diagnostics as HTML
+ */
+export declare function renderDiagnosticsHtml(lintResult: LintResult): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/render/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/render/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAC9B,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,iBAAiB,CAkBhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA2CpE"}

package/dist/render/diagnostics.js

@@ -0,0 +1,63 @@
+/**
+ * Group diagnostics by file
+ */
+export function groupDiagnosticsByFile(lintResult) {
+    const grouped = {};
+    for (const diagnostic of lintResult.diagnostics) {
+        const file = diagnostic.file || 'unknown';
+        if (!grouped[file]) {
+            grouped[file] = [];
+        }
+        grouped[file].push({
+            code: diagnostic.code,
+            severity: diagnostic.severity,
+            message: diagnostic.message,
+            line: diagnostic.sourcePos?.line,
+            column: diagnostic.sourcePos?.column,
+        });
+    }
+    return grouped;
+}
+/**
+ * Render diagnostics as HTML
+ */
+export function renderDiagnosticsHtml(lintResult) {
+    const grouped = groupDiagnosticsByFile(lintResult);
+    const files = Object.keys(grouped);
+    if (files.length === 0) {
+        return '<div class="diagnostics-panel"><p>✅ No issues found</p></div>';
+    }
+    const sections = files.map(file => {
+        const diagnostics = grouped[file];
+        const items = diagnostics.map(d => {
+            const severityClass = `diagnostic-${d.severity}`;
+            const location = d.line ? ` (line ${d.line}${d.column ? `:${d.column}` : ''})` : '';
+            return `
+                <li class="${severityClass}">
+                    <strong>${d.code}</strong>: ${d.message}${location}
+                </li>
+            `;
+        }).join('');
+        return `
+            <div class="diagnostic-file">
+                <h4>${file}</h4>
+                <ul class="diagnostic-list">
+                    ${items}
+                </ul>
+            </div>
+        `;
+    }).join('');
+    const errorCount = lintResult.diagnostics.filter(d => d.severity === 'error').length;
+    const warningCount = lintResult.diagnostics.filter(d => d.severity === 'warning').length;
+    return `
+        <div class="diagnostics-panel">
+            <h3>📋 Diagnostics</h3>
+            <p class="diagnostic-summary">
+                ${errorCount} error${errorCount !== 1 ? 's' : ''}, 
+                ${warningCount} warning${warningCount !== 1 ? 's' : ''}
+            </p>
+            ${sections}
+        </div>
+    `;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/render/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/render/diagnostics.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAsB;IACzD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,SAAS,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,IAAI,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI;YAChC,MAAM,EAAE,UAAU,CAAC,SAAS,EAAE,MAAM;SACvC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAsB;IACxD,MAAM,OAAO,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,+DAA+D,CAAC;IAC3E,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QAC9B,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC9B,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,OAAO;6BACU,aAAa;8BACZ,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,OAAO,GAAG,QAAQ;;aAEzD,CAAC;QACN,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEZ,OAAO;;sBAEO,IAAI;;sBAEJ,KAAK;;;SAGlB,CAAC;IACN,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACrF,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAEzF,OAAO;;;;kBAIO,UAAU,SAAS,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;kBAC9C,YAAY,WAAW,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;;cAExD,QAAQ;;KAEjB,CAAC;AACN,CAAC"}

package/dist/render/html.d.ts

@@ -0,0 +1,8 @@
+import type { Workspace } from '@openuji/speculator';
+import type { LintResult } from '@openuji/speculator-lint';
+import type { ReSpecConfig } from '../model.js';
+/**
+ * Generate complete ReSpec HTML document
+ */
+export declare function generateHTML(workspace: Workspace, config: ReSpecConfig, lintResult: LintResult): Promise<string>;
+//# sourceMappingURL=html.d.ts.map

package/dist/render/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/render/html.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD;;GAEG;AACH,wBAAsB,YAAY,CAC9B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACvB,OAAO,CAAC,MAAM,CAAC,CA6DjB"}

package/dist/render/html.js

@@ -0,0 +1,174 @@
+import nunjucks from 'nunjucks';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { generateToc, renderTocHtml } from './toc.js';
+import { renderDiagnosticsHtml } from './diagnostics.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Generate complete ReSpec HTML document
+ */
+export async function generateHTML(workspace, config, lintResult) {
+    // Get the entry document (first document in workspace)
+    const document = workspace.documents[0];
+    if (!document) {
+        throw new Error('No document found in workspace');
+    }
+    // Generate TOC
+    const tocEntries = generateToc(document, config.maxTocLevel);
+    const tocHtml = renderTocHtml(tocEntries);
+    // Render main content from AST
+    const contentHtml = renderDocumentContent(document);
+    // Render diagnostics
+    const diagnosticsHtml = renderDiagnosticsHtml(lintResult);
+    // Prepare template data
+    const templateData = {
+        // Document metadata
+        title: document.metadata?.title || 'Specification',
+        subtitle: config.subtitle,
+        // Status and dates
+        specStatus: config.specStatus,
+        publishDate: config.publishDate || new Date().toISOString().split('T')[0],
+        previousPublishDate: config.previousPublishDate,
+        // People
+        editors: config.editors || [],
+        authors: config.authors || [],
+        // Organization
+        group: config.group,
+        wg: config.wg,
+        wgURI: config.wgURI,
+        // Content
+        abstract: extractAbstract(document),
+        toc: tocHtml,
+        content: contentHtml,
+        diagnostics: diagnosticsHtml,
+        // GitHub
+        github: config.github,
+        // Copyright
+        copyrightStart: config.copyrightStart || new Date().getFullYear().toString(),
+        // Logos
+        logos: config.logos || [],
+    };
+    // Configure Nunjucks
+    const templatesDir = join(__dirname, '..', 'templates');
+    nunjucks.configure(templatesDir, { autoescape: false });
+    // Render template
+    const html = nunjucks.render('respec.html', templateData);
+    return html;
+}
+/**
+ * Extract abstract section from document
+ */
+function extractAbstract(document) {
+    if (!document.children)
+        return 'No abstract provided.';
+    for (const child of document.children) {
+        if (child.type === 'section') {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const section = child;
+            if (section.id === 'abstract' || section.data?.respecClass === 'abstract') {
+                return renderNode(section);
+            }
+        }
+    }
+    return 'No abstract provided.';
+}
+/**
+ * Render document content as HTML
+ */
+function renderDocumentContent(document) {
+    if (!document.children)
+        return '';
+    return document.children
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        .filter((child) => child.id !== 'abstract') // Skip abstract, it's rendered separately
+        .map(child => renderNode(child))
+        .join('\n');
+}
+/**
+ * Recursively render an AST node to HTML
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderNode(node) {
+    if (!node || typeof node !== 'object')
+        return '';
+    switch (node.type) {
+        case 'section':
+            return renderSection(node);
+        case 'paragraph':
+            return renderParagraph(node);
+        case 'heading':
+            return renderHeading(node);
+        case 'text':
+            return escapeHtml(node.value || '');
+        case 'definition':
+            return renderDefinition(node);
+        case 'reference':
+            return renderReference(node);
+        case 'code':
+            return `<code>${escapeHtml(node.value || '')}</code>`;
+        case 'emphasis':
+            return `<em>${renderChildren(node)}</em>`;
+        case 'strong':
+            return `<strong>${renderChildren(node)}</strong>`;
+        case 'link':
+            return `<a href="${escapeHtml(node.href || '#')}">${renderChildren(node)}</a>`;
+        case 'list':
+            return renderList(node);
+        case 'listItem':
+            return `<li>${renderChildren(node)}</li>`;
+        default:
+            return renderChildren(node);
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderSection(node) {
+    const id = node.id ? ` id="${escapeHtml(node.id)}"` : '';
+    const className = node.data?.respecClass ? ` class="${escapeHtml(node.data.respecClass)}"` : '';
+    const title = node.title ? `<h${node.level || 2}>${escapeHtml(node.title)}</h${node.level || 2}>` : '';
+    const content = renderChildren(node);
+    return `<section${id}${className}>\n${title}\n${content}\n</section>`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderParagraph(node) {
+    return `<p>${renderChildren(node)}</p>`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderHeading(node) {
+    const level = node.level || 2;
+    return `<h${level}>${renderChildren(node)}</h${level}>`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderDefinition(node) {
+    const term = node.term || renderChildren(node);
+    const id = node.id ? ` id="${escapeHtml(node.id)}"` : '';
+    return `<dfn${id}>${escapeHtml(term)}</dfn>`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderReference(node) {
+    const targetTerm = node.targetTerm || renderChildren(node);
+    const href = node.resolved?.id ? `#${escapeHtml(node.resolved.id)}` : '#';
+    return `<a href="${href}" class="internalDFN">${escapeHtml(targetTerm)}</a>`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderList(node) {
+    const tag = node.ordered ? 'ol' : 'ul';
+    const content = renderChildren(node);
+    return `<${tag}>${content}</${tag}>`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function renderChildren(node) {
+    if (!node.children || !Array.isArray(node.children))
+        return '';
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return node.children.map((child) => renderNode(child)).join('');
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+//# sourceMappingURL=html.js.map

package/dist/render/html.js.map

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

package/dist/render/toc.d.ts

@@ -0,0 +1,16 @@
+import type { Document } from '@openuji/speculator';
+export interface TocEntry {
+    id: string;
+    title: string;
+    level: number;
+    children: TocEntry[];
+}
+/**
+ * Generate Table of Contents from document sections
+ */
+export declare function generateToc(document: Document, maxLevel?: number): TocEntry[];
+/**
+ * Render TOC as HTML
+ */
+export declare function renderTocHtml(entries: TocEntry[], level?: number): string;
+//# sourceMappingURL=toc.d.ts.map

package/dist/render/toc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.d.ts","sourceRoot":"","sources":["../../src/render/toc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAE,MAAU,GAAG,QAAQ,EAAE,CAyChF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAgB5E"}

package/dist/render/toc.js

@@ -0,0 +1,60 @@
+/**
+ * Generate Table of Contents from document sections
+ */
+export function generateToc(document, maxLevel = 3) {
+    const toc = [];
+    const stack = [];
+    // Walk through document children (sections)
+    if (document.children) {
+        for (const child of document.children) {
+            if (child.type === 'section') {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const section = child;
+                const level = section.level || 1;
+                // Only include up to maxLevel
+                if (level > maxLevel)
+                    continue;
+                const entry = {
+                    id: section.id || `section-${toc.length}`,
+                    title: section.title || 'Untitled Section',
+                    level,
+                    children: [],
+                };
+                // Determine where to place this entry
+                while (stack.length > 0 && stack[stack.length - 1].level >= level) {
+                    stack.pop();
+                }
+                if (stack.length === 0) {
+                    // Top-level entry
+                    toc.push(entry);
+                }
+                else {
+                    // Nested entry
+                    stack[stack.length - 1].entry.children.push(entry);
+                }
+                stack.push({ entry, level });
+            }
+        }
+    }
+    return toc;
+}
+/**
+ * Render TOC as HTML
+ */
+export function renderTocHtml(entries, level = 1) {
+    if (entries.length === 0)
+        return '';
+    const items = entries.map(entry => {
+        const children = renderTocHtml(entry.children, level + 1);
+        return `
+            <li class="tocline">
+                <a href="#${entry.id}" class="tocxref">
+                    <span class="secno"></span> ${entry.title}
+                </a>
+                ${children ? `<ol class="toc">${children}</ol>` : ''}
+            </li>
+        `;
+    }).join('');
+    return items;
+}
+//# sourceMappingURL=toc.js.map

package/dist/render/toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","sourceRoot":"","sources":["../../src/render/toc.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAkB,EAAE,WAAmB,CAAC;IAChE,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,MAAM,KAAK,GAA8C,EAAE,CAAC;IAE5D,4CAA4C;IAC5C,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC3B,8DAA8D;gBAC9D,MAAM,OAAO,GAAG,KAAY,CAAC;gBAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;gBAEjC,8BAA8B;gBAC9B,IAAI,KAAK,GAAG,QAAQ;oBAAE,SAAS;gBAE/B,MAAM,KAAK,GAAa;oBACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,WAAW,GAAG,CAAC,MAAM,EAAE;oBACzC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,kBAAkB;oBAC1C,KAAK;oBACL,QAAQ,EAAE,EAAE;iBACf,CAAC;gBAEF,sCAAsC;gBACtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;oBAChE,KAAK,CAAC,GAAG,EAAE,CAAC;gBAChB,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACrB,kBAAkB;oBAClB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACJ,eAAe;oBACf,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACvD,CAAC;gBAED,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmB,EAAE,QAAgB,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1D,OAAO;;4BAEa,KAAK,CAAC,EAAE;kDACc,KAAK,CAAC,KAAK;;kBAE3C,QAAQ,CAAC,CAAC,CAAC,mBAAmB,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE;;SAE3D,CAAC;IACN,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,OAAO,KAAK,CAAC;AACjB,CAAC"}