md2x 0.1.0

package/dist/types/src/plugins/mermaid-plugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mermaid Plugin
+ *
+ * Handles Mermaid diagram processing in content script and DOCX export
+ */
+import { BasePlugin } from './base-plugin';
+export declare class MermaidPlugin extends BasePlugin {
+    constructor();
+}

package/dist/types/src/plugins/plugin-content-utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Plugin Content Script Utilities
+ * Handles content script specific logic for plugins (HTML generation, remark integration)
+ */
+import type { BasePlugin } from './base-plugin';
+import type { TranslateFunction, EscapeHtmlFunction, AsyncTaskQueueManager, ASTNode, PluginRenderer } from '../types/index';
+/**
+ * Create async placeholder element HTML (before rendering)
+ * @param id - Placeholder element ID
+ * @param pluginType - Plugin type identifier
+ * @param isInline - Whether to render inline or block
+ * @param translate - Translation function
+ * @param sourceHash - Content hash for DOM diff matching
+ * @returns Placeholder HTML
+ */
+export declare function createPlaceholderElement(id: string, pluginType: string, isInline: boolean, translate: TranslateFunction, sourceHash?: string): string;
+/**
+ * Create error HTML
+ * @param errorMessage - Localized error message
+ * @returns Error HTML
+ */
+export declare function createErrorHTML(errorMessage: string): string;
+/**
+ * Visit function type from unist-util-visit
+ */
+type VisitFn = (tree: unknown, nodeType: string, visitor: (node: ASTNode, index: number | undefined, parent: {
+    children?: unknown[];
+} | undefined) => void) => void;
+/**
+ * Create remark plugin function for a plugin
+ * @param plugin - Plugin instance
+ * @param renderer - Renderer instance
+ * @param asyncTask - Async task creator
+ * @param translate - Translation function
+ * @param escapeHtml - HTML escape function
+ * @param visit - unist-util-visit function
+ * @returns Remark plugin function
+ */
+export declare function createRemarkPlugin(plugin: BasePlugin, renderer: PluginRenderer, asyncTask: AsyncTaskQueueManager['asyncTask'], translate: TranslateFunction, escapeHtml: EscapeHtmlFunction, visit: VisitFn): () => (tree: unknown) => void;
+export {};

package/dist/types/src/plugins/plugin-html-utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Plugin HTML Utilities
+ * Converts unified plugin render results to HTML
+ */
+import type { PluginRenderResult, UnifiedRenderResult } from '../types/index';
+/**
+ * Convert unified plugin render result to HTML string
+ * @param id - Placeholder element ID
+ * @param renderResult - Unified render result from plugin.renderToCommon()
+ * @param pluginType - Plugin type for alt text
+ * @param sourceHash - Content hash for DOM diff matching
+ * @returns HTML string
+ */
+export declare function convertPluginResultToHTML(id: string, renderResult: UnifiedRenderResult, pluginType?: string, sourceHash?: string): string;
+/**
+ * Replace placeholder with rendered content in DOM
+ * @param id - Placeholder element ID
+ * @param result - Render result with base64, width, height, format
+ * @param pluginType - Plugin type
+ * @param isInline - Whether to render inline or block
+ * @param expectedSourceHash - Source hash to validate against placeholder (prevents race conditions)
+ */
+export declare function replacePlaceholderWithImage(id: string, result: PluginRenderResult, pluginType: string, isInline: boolean, expectedSourceHash: string): void;

package/dist/types/src/plugins/rehype-image-uri.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Rehype plugin to rewrite relative image paths to absolute URIs.
+ *
+ * This plugin is primarily used in VS Code webview context where relative
+ * image paths need to be converted to vscode-webview-resource: URIs.
+ *
+ * The base URI is obtained from DocumentService.
+ */
+import type { Root } from 'hast';
+/**
+ * Rehype plugin to rewrite image src attributes
+ */
+export default function rehypeImageUri(): (tree: Root) => void;

package/dist/types/src/plugins/remark-super-sub.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Remark plugin to support superscript (^text^) and subscript (~text~) syntax.
+ * Compatible with unified 11 / remark-parse 11 / micromark architecture.
+ *
+ * Syntax:
+ *   - Superscript: ^text^ → <sup>text</sup>
+ *   - Subscript: ~text~ → <sub>text</sub>
+ *
+ * Note: Single ~ is used for subscript (different from GFM's ~~ for strikethrough)
+ */
+import type { Plugin } from 'unified';
+import type { Root } from 'mdast';
+/**
+ * Remark plugin to support superscript and subscript syntax.
+ */
+declare const remarkSuperSub: Plugin<[], Root>;
+export default remarkSuperSub;

package/dist/types/src/plugins/remark-toc-filter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Remark plugin to filter out [toc] markers in rendered HTML
+ * The [toc] marker is used in DOCX export but should not be visible in HTML rendering
+ */
+import type { Node } from 'unist';
+/**
+ * Plugin to remove [toc] markers from the AST
+ * Removes paragraphs that contain only [toc] or variations like [TOC]
+ */
+export default function remarkTocFilter(): (tree: Node) => void;

package/dist/types/src/plugins/svg-plugin.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SVG Plugin
+ *
+ * Handles SVG code blocks and SVG image files in content script and DOCX export
+ */
+import { BasePlugin } from './base-plugin';
+/**
+ * AST node interface for SVG plugin
+ */
+interface AstNode {
+    type: string;
+    lang?: string;
+    value?: string;
+    url?: string;
+}
+export declare class SvgPlugin extends BasePlugin {
+    private _currentNodeType;
+    constructor();
+    /**
+     * Extract content from AST node
+     * Handles both SVG code blocks and SVG image files
+     * @param node - AST node
+     * @returns SVG content or URL, or null if not applicable
+     */
+    extractContent(node: AstNode): string | null;
+    /**
+     * SVG uses inline rendering for images, block for code blocks
+     * @returns True for inline rendering (images), false for block (code blocks)
+     */
+    isInline(): boolean;
+    /**
+     * Check if content is a URL (for image nodes)
+     * @param content - Extracted content
+     * @returns True if content is a URL
+     */
+    isUrl(content: string): boolean;
+    /**
+     * Fetch SVG content from URL
+     * Uses DocumentService for unified file access across all platforms.
+     * @param url - URL to fetch (http://, https://, file://, data:, or relative path)
+     * @returns SVG content
+     */
+    fetchContent(url: string): Promise<string>;
+    /**
+     * Get AST node selector(s) for remark visit
+     * SVG plugin handles both code blocks and image nodes
+     * @returns Array of node types ['code', 'image']
+     */
+    get nodeSelector(): string[];
+}
+export {};

package/dist/types/src/plugins/vega-plugin.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Vega Plugin using BasePlugin architecture
+ */
+import { BasePlugin } from './base-plugin';
+/**
+ * Vega Plugin implementation
+ */
+export declare class VegaPlugin extends BasePlugin {
+    constructor();
+}

package/dist/types/src/plugins/vegalite-plugin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Vega-Lite Plugin using BasePlugin architecture
+ */
+import { BasePlugin } from './base-plugin';
+/**
+ * AST node interface
+ */
+interface AstNode {
+    type: string;
+    lang?: string;
+    value?: string;
+}
+/**
+ * Vega-Lite Plugin implementation
+ */
+export declare class VegaLitePlugin extends BasePlugin {
+    constructor();
+    /**
+     * Override extractContent to support both 'vega-lite' and 'vegalite'
+     */
+    extractContent(node: AstNode): string | null;
+}
+export {};

package/dist/types/src/types/cache.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Cache Type Definitions
+ * Types for caching system
+ */
+import type { RendererThemeConfig } from './render';
+/**
+ * Individual cache item stored in IndexedDB
+ */
+export interface CacheItem<T = unknown> {
+    key: string;
+    value: T;
+    type: string;
+    size: number;
+    timestamp: number;
+    accessTime: number;
+}
+/**
+ * IndexedDB cache statistics
+ */
+export interface IndexedDBCacheStats {
+    itemCount: number;
+    maxItems: number;
+    totalSize: number;
+    totalSizeMB: string;
+    items: Array<{
+        key: string;
+        type: string;
+        size: number;
+        sizeMB: string;
+        created: string;
+        lastAccess: string;
+    }>;
+}
+/**
+ * Full cache statistics (for detailed view)
+ */
+export interface CacheStats {
+    indexedDBCache: IndexedDBCacheStats;
+    combined: {
+        totalItems: number;
+        totalSizeMB: string;
+    };
+    databaseInfo: {
+        dbName: string;
+        storeName: string;
+        version: number;
+    };
+}
+/**
+ * Simple cache stats for popup/background communication
+ */
+export interface SimpleCacheStats {
+    itemCount: number;
+    maxItems: number;
+    totalSize: number;
+    totalSizeMB: string;
+    items: CacheItem[];
+    message?: string;
+}
+/**
+ * Cache manager interface for content scripts
+ */
+export interface ICacheManager {
+    ensureDB?(): Promise<unknown>;
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, type?: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<boolean>;
+    cleanup?(): Promise<void>;
+    getStats(): Promise<CacheStats | SimpleCacheStats | null>;
+}
+/**
+ * Cache manager interface for renderers.
+ * Used by both the extension-side cache manager and the background proxy.
+ */
+export interface RendererCacheManager {
+    ensureDB(): Promise<unknown>;
+    generateKey(content: string, type: string, themeConfig?: RendererThemeConfig | null, outputFormat?: string): Promise<string>;
+    get(key: string): Promise<unknown>;
+    set(key: string, value: unknown, type: string): Promise<void>;
+    delete?(key: string): Promise<boolean>;
+    cleanup?(): Promise<void>;
+    getStats(): Promise<CacheStats | SimpleCacheStats | null>;
+    clear(): Promise<void>;
+}

package/dist/types/src/types/core.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Core Type Definitions
+ * Basic types used throughout the application
+ */
+/**
+ * Translation function - supports both single string and array substitutions
+ */
+export type TranslateFunction = (key: string, substitutions?: string | string[]) => string;
+/**
+ * HTML escape function
+ */
+export type EscapeHtmlFunction = (str: string) => string;
+/**
+ * Per-file UI state (scroll position, TOC visibility, zoom, etc.)
+ */
+export interface FileState {
+    /** Line-based scroll position (stable during content changes) */
+    scrollLine?: number;
+    tocVisible?: boolean;
+    zoom?: number;
+    layoutMode?: string;
+    lastModified?: number;
+    [key: string]: unknown;
+}
+/**
+ * All file states storage - keyed by URL
+ */
+export interface AllFileStates {
+    [url: string]: FileState;
+}
+/**
+ * History entry for recently viewed files
+ */
+export interface HistoryEntry {
+    url: string;
+    title: string;
+    lastAccess: string;
+}
+/**
+ * Background script message
+ *
+ * @deprecated Use RequestEnvelope from src/types/messaging.ts instead.
+ * This flat message format is being phased out in favor of the standardized
+ * envelope format: { id, type, payload, timestamp, source? }
+ *
+ * Migration guide:
+ * - Move all flat fields (action, url, state, etc.) into the `payload` object
+ * - Use ServiceChannel.send() or ServiceChannel.post() for message passing
+ * - See docs/dev/messaging-audit.md for details
+ */
+export interface BackgroundMessage {
+    type?: string;
+    action?: string;
+    url?: string;
+    state?: FileState;
+    position?: number;
+    operation?: string;
+    key?: string;
+    value?: unknown;
+    dataType?: string;
+    limit?: number;
+    renderType?: string;
+    input?: string | object;
+    themeConfig?: unknown;
+    config?: unknown;
+    extraParams?: unknown;
+    filePath?: string;
+    binary?: boolean;
+    payload?: {
+        purpose?: string;
+        encoding?: string;
+        metadata?: Record<string, unknown>;
+        expectedSize?: number;
+        chunkSize?: number;
+    };
+    token?: string;
+    chunk?: string;
+}
+/**
+ * Generic message handler
+ */
+export type MessageHandler = (message: unknown) => void;
+/**
+ * Upload session for chunked file uploads
+ */
+export interface UploadSession {
+    purpose: string;
+    encoding: 'text' | 'base64';
+    metadata: Record<string, unknown>;
+    expectedSize: number | null;
+    chunkSize: number;
+    chunks: string[];
+    receivedBytes: number;
+    createdAt: number;
+    completed: boolean;
+    data?: string;
+    lastChunkTime?: number;
+    completedAt?: number;
+}

package/dist/types/src/types/docx.d.ts

@@ -0,0 +1,240 @@
+/**
+ * DOCX Export Type Definitions
+ *
+ * This file defines types for DOCX export functionality.
+ *
+ * IMPORTANT: These types are INTERNAL types for theme configuration and conversion.
+ * They are NOT the same as docx library types. The conversion layer (theme-to-docx.ts)
+ * is responsible for converting these internal types to docx library types.
+ */
+import { BorderStyle, AlignmentType, type IFontAttributesProperties } from 'docx';
+/**
+ * Alignment type values from docx library
+ * Use this type when you need to store alignment values
+ */
+export type AlignmentTypeValue = (typeof AlignmentType)[keyof typeof AlignmentType];
+/**
+ * Border style values from docx library
+ * Use this type when you need to store border style values
+ */
+export type BorderStyleValue = (typeof BorderStyle)[keyof typeof BorderStyle];
+/**
+ * Emoji font style options for DOCX export
+ * - 'apple': Use Apple Color Emoji (iOS/macOS style, 3D glossy)
+ * - 'windows': Use Segoe UI Emoji (Windows/WPS style, flat design)
+ * - 'system': Use system emoji (no font processing, preserve original)
+ */
+export type EmojiStyle = 'apple' | 'windows' | 'system';
+/**
+ * Internal run style for theme configuration
+ * This is converted to IRunStylePropertiesOptions when creating DOCX
+ */
+export interface DOCXRunStyle {
+    font: string | IFontAttributesProperties;
+    size: number;
+    bold?: boolean;
+    color?: string;
+}
+/**
+ * Internal paragraph spacing for theme configuration
+ * Values are in twips (twentieth of a point, 1440 twips = 1 inch)
+ */
+export interface DOCXParagraphSpacing {
+    line?: number;
+    before?: number;
+    after?: number;
+}
+/**
+ * Internal paragraph style for theme configuration
+ * Note: alignment is stored as string for flexibility in theme files,
+ * converted to AlignmentTypeValue at runtime
+ */
+export interface DOCXParagraphStyle {
+    spacing?: DOCXParagraphSpacing;
+    alignment?: string;
+}
+/**
+ * Internal heading style for theme configuration
+ */
+export interface DOCXHeadingStyle {
+    id: string;
+    name: string;
+    basedOn: string;
+    next: string;
+    run: DOCXRunStyle;
+    paragraph: DOCXParagraphStyle;
+}
+/**
+ * Internal character style for code blocks
+ */
+export interface DOCXCharacterStyle {
+    font: string | IFontAttributesProperties;
+    size: number;
+    background: string;
+}
+/**
+ * Internal border style
+ * Note: style is BorderStyleValue from docx library
+ */
+export interface DOCXBorder {
+    style: BorderStyleValue;
+    size: number;
+    color: string;
+}
+/**
+ * Internal table borders configuration
+ */
+export interface DOCXTableBorders {
+    all?: DOCXBorder;
+    headerTop?: DOCXBorder;
+    headerBottom?: DOCXBorder;
+    insideHorizontal?: DOCXBorder;
+    lastRowBottom?: DOCXBorder;
+}
+/**
+ * Internal table style configuration
+ */
+export interface DOCXTableStyle {
+    borders: DOCXTableBorders;
+    header: {
+        shading?: {
+            fill: string;
+        };
+        color?: string;
+        bold?: boolean;
+    };
+    cell: {
+        margins?: {
+            top: number;
+            bottom: number;
+            left: number;
+            right: number;
+        };
+    };
+    zebra: boolean | {
+        even: string;
+        odd: string;
+    };
+}
+/**
+ * Code syntax highlighting colors
+ */
+export interface DOCXCodeColors {
+    background: string;
+    foreground: string;
+    colors: Record<string, string>;
+}
+/**
+ * Complete internal DOCX theme styles configuration
+ * Used throughout the DOCX export system
+ */
+export interface DOCXThemeStyles {
+    default: {
+        run: DOCXRunStyle;
+        paragraph: DOCXParagraphStyle;
+    };
+    paragraphStyles: Record<string, DOCXHeadingStyle>;
+    characterStyles: {
+        code: DOCXCharacterStyle;
+    };
+    tableStyles: DOCXTableStyle;
+    codeColors: DOCXCodeColors;
+    linkColor: string;
+    blockquoteColor: string;
+}
+/**
+ * Link definition from markdown reference links
+ */
+export interface LinkDefinition {
+    url: string;
+    title: string | null;
+}
+/**
+ * Image buffer result from fetching
+ */
+export interface ImageBufferResult {
+    buffer: Uint8Array;
+    contentType: string;
+}
+/**
+ * Supported image types for DOCX
+ */
+export type DOCXImageType = 'png' | 'jpg' | 'gif' | 'bmp';
+/**
+ * Fetch image result with dimensions
+ */
+export interface FetchImageResult {
+    buffer: Uint8Array;
+    width: number;
+    height: number;
+    type: DOCXImageType;
+}
+/**
+ * DOCX export result
+ */
+export interface DOCXExportResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Progress callback type
+ */
+export type DOCXProgressCallback = (processed: number, total: number) => void;
+/**
+ * Public DOCX exporter interface
+ * Implemented by the DocxExporter class in src/exporters/docx-exporter.ts
+ */
+export interface DocxExporter {
+    exportToDocx(markdown: string, filename?: string, onProgress?: DOCXProgressCallback | null): Promise<DOCXExportResult>;
+    setBaseUrl?(url: string): void;
+}
+/**
+ * Base AST node interface
+ */
+export interface DOCXASTNode {
+    type: string;
+    children?: DOCXASTNode[];
+    value?: string;
+    depth?: number;
+    lang?: string;
+    url?: string;
+    title?: string;
+    identifier?: string;
+    ordered?: boolean;
+    start?: number;
+    [key: string]: unknown;
+}
+/**
+ * List node with ordering info
+ */
+export interface DOCXListNode extends DOCXASTNode {
+    type: 'list';
+    ordered: boolean;
+    start?: number;
+    children: DOCXASTNode[];
+}
+/**
+ * Blockquote node
+ */
+export interface DOCXBlockquoteNode extends DOCXASTNode {
+    type: 'blockquote';
+    children: DOCXASTNode[];
+}
+/**
+ * Table node
+ */
+export interface DOCXTableNode extends DOCXASTNode {
+    type: 'table';
+    children: DOCXASTNode[];
+}
+/**
+ * Inline node (text, link, emphasis, etc.)
+ */
+export interface DOCXInlineNode extends DOCXASTNode {
+    type: 'text' | 'link' | 'emphasis' | 'strong' | 'inlineCode' | 'image' | 'linkReference' | 'inlineMath' | 'break' | 'html';
+    url?: string;
+    title?: string;
+    identifier?: string;
+    alt?: string;
+}
+export { BorderStyle, AlignmentType };

package/dist/types/src/types/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Unified Type Definitions
+ *
+ * All shared types should be imported from this file.
+ * This is the single source of truth for type definitions.
+ */
+import './platform.d';
+export type { TranslateFunction, EscapeHtmlFunction, FileState, AllFileStates, HistoryEntry, BackgroundMessage, MessageHandler, UploadSession, } from './core';
+export type { CacheItem, IndexedDBCacheStats, CacheStats, SimpleCacheStats, ICacheManager, RendererCacheManager, } from './cache';
+export type { RenderResult, RenderResultType, RenderResultContent, RenderResultDisplay, UnifiedRenderResult, RendererThemeConfig, } from './render';
+export type { ColorScheme, HeadingConfig, FontScheme, BorderConfig, TableStyleConfig, CodeThemeConfig, LayoutHeadingConfig, LayoutBlockConfig, LayoutScheme, Theme, ThemeDefinition, ThemeCategoryInfo, ThemeRegistry, ThemeRegistryInfo, } from './theme';
+export type { PlatformType, PlatformMessageAPI, PlatformStorageAPI, PlatformResourceAPI, PlatformI18nAPI, PlatformBridgeAPI, DownloadOptions, CacheService, RendererService, StorageService, FileService, ResourceService, I18nService, MessageService, PlatformAPI, } from './platform';
+export type { RenderMessageType, ServiceMessageType, CommonMessageType, AnyMessageType, RenderPayloadMap, ServicePayloadMap, RequestEnvelope, ResponseEnvelope, RenderRequestEnvelope, ServiceRequestEnvelope, RenderResponseData, } from './messaging';
+export { RenderMessageType as RenderMessageTypes, ServiceMessageType as ServiceMessageTypes, CommonMessageType as CommonMessageTypes, } from './messaging';
+export type { TaskStatus, TaskData, AsyncTaskObject, PlaceholderResult, AsyncTaskResult, AsyncTaskPlugin, AsyncTaskQueueManager, ASTNode, IPlugin, PluginRenderer, PluginRenderResult, } from './plugin';
+export type { AlignmentTypeValue, BorderStyleValue, DOCXRunStyle, DOCXParagraphSpacing, DOCXParagraphStyle, DOCXHeadingStyle, DOCXCharacterStyle, DOCXBorder, DOCXTableBorders, DOCXTableStyle, DOCXCodeColors, DOCXThemeStyles, LinkDefinition, ImageBufferResult, DOCXImageType, FetchImageResult, DOCXExportResult, DOCXProgressCallback, DocxExporter, DOCXASTNode, DOCXListNode, DOCXBlockquoteNode, DOCXTableNode, DOCXInlineNode, } from './docx';
+export { BorderStyle, AlignmentType } from './docx';
+export type { LayoutConfig, ToolbarManagerOptions, GenerateToolbarHTMLOptions, ToolbarManagerInstance, } from './toolbar';