@oml/markdown 0.7.0

package/src/renderers/renderer.ts

@@ -0,0 +1,84 @@
+// Copyright (c) 2026 Modelware. All rights reserved.
+
+import type { MdBlockExecutionResult } from './types.js';
+
+export interface MarkdownBlockRenderer {
+    canRender(result: MdBlockExecutionResult): boolean;
+    render(result: MdBlockExecutionResult): HTMLElement;
+}
+
+export type TableBlockKind = 'table' | 'table-editor' | 'matrix' | 'tree';
+export type CanvasBlockKind = 'graph' | 'diagram';
+
+export abstract class BaseMarkdownBlockRenderer implements MarkdownBlockRenderer {
+    abstract canRender(result: MdBlockExecutionResult): boolean;
+    abstract render(result: MdBlockExecutionResult): HTMLElement;
+
+    protected createResultContainer(status: MdBlockExecutionResult['status']): HTMLElement {
+        const container = document.createElement('div');
+        container.className = `oml-md-result oml-md-result-${status}`;
+        return container;
+    }
+
+    protected createMessageContainer(text: string): HTMLElement {
+        const message = document.createElement('div');
+        message.className = 'oml-md-result-message';
+        message.textContent = text;
+        return message;
+    }
+
+    protected requestTextFileDownload(content: string, fallbackName = 'download', fileExtension = 'txt'): void {
+        const filename = this.buildDownloadFileName(fallbackName, fileExtension);
+        const event = new CustomEvent('md-download-file', {
+            detail: { filename, content },
+        });
+        window.dispatchEvent(event);
+    }
+
+    private buildDownloadFileName(fallbackName: string, fileExtension: string): string {
+        const sourceUri = document.body.getAttribute('data-source-uri') ?? '';
+        let namePart = fallbackName;
+        if (sourceUri) {
+            const fileName = sourceUri.split('/').pop() ?? '';
+            const fileStem = fileName.replace(/\.[^.]+$/, '');
+            if (fileStem) {
+                namePart = fileStem;
+            }
+        }
+        const sanitized = namePart.replace(/\W+/g, '_');
+        const ts = new Date().toISOString().replace(/[:.]/g, '-');
+        const extension = fileExtension.replace(/^\./, '') || 'csv';
+        return `${sanitized}_${ts}.${extension}`;
+    }
+}
+
+export abstract class QueryMarkdownBlockRenderer extends BaseMarkdownBlockRenderer {
+    protected getBlockSource(result: MdBlockExecutionResult): string | undefined {
+        return result.blockSource;
+    }
+
+    protected getBlockMeta(result: MdBlockExecutionResult): string | undefined {
+        return result.blockMeta;
+    }
+
+    protected getBlockRange(result: MdBlockExecutionResult): { start?: number; end?: number } {
+        return { start: result.blockLineStart, end: result.blockLineEnd };
+    }
+}
+
+export abstract class CanvasMarkdownBlockRenderer extends QueryMarkdownBlockRenderer {
+    protected abstract readonly canvasKinds: ReadonlyArray<CanvasBlockKind>;
+
+    canRender(result: MdBlockExecutionResult): boolean {
+        return result.status === 'ok'
+            && this.canvasKinds.includes(result.kind as CanvasBlockKind);
+    }
+
+    protected renderNotImplemented(result: MdBlockExecutionResult): HTMLElement {
+        const container = this.createResultContainer(result.status);
+        const source = this.getBlockSource(result);
+        const sourceHint = source && source.trim().length > 0 ? ' Query source is available to this renderer.' : '';
+        container.appendChild(this.createMessageContainer(`Renderer for '${result.kind}' is not implemented yet.${sourceHint}`));
+        return container;
+    }
+}

package/src/renderers/table-editor-renderer.ts

@@ -0,0 +1,8 @@
+// Copyright (c) 2026 Modelware. All rights reserved.
+
+import { TableMarkdownBlockRenderer } from './table-renderer.js';
+
+export class TableEditorMarkdownBlockRenderer extends TableMarkdownBlockRenderer {
+    protected override readonly tableKinds = ['table-editor'] as const;
+}
+