markopress 0.0.1

package/dist/markdown/loader.js

@@ -0,0 +1,325 @@
+/**
+ * Markdown loader with frontmatter parsing
+ */
+import matter from 'gray-matter';
+import MarkdownIt from 'markdown-it';
+import mdAnchor from 'markdown-it-anchor';
+import mdAttrs from 'markdown-it-attrs';
+import * as mdEmoji from 'markdown-it-emoji';
+import { createHighlighter } from 'shiki';
+import { setupContainers, setupDetails } from './containers.js';
+import { createEnhancedHighlighter } from './code.js';
+import { preprocessIncludesWithRegions } from './includes.js';
+import { preserveTagsPlugin } from './preserve-tags.js';
+import { globalTagValidator } from './tag-validator.js';
+// Cache highlighter instance
+let highlighterInstance = null;
+// Track languages that have been loaded for lazy loading
+const loadedLanguages = new Set();
+let loadLanguagePromise = null;
+/**
+ * Essential languages to load immediately (covers ~80% of use cases)
+ * Everything else loads on-demand to speed up initial build
+ */
+const ESSENTIAL_LANGUAGES = [
+    'javascript',
+    'typescript',
+    'js',
+    'ts',
+    'bash',
+    'markdown',
+    'md',
+];
+/**
+ * Language alias map (shorthand -> full name)
+ */
+const LANGUAGE_ALIASES = {
+    'js': 'javascript',
+    'ts': 'typescript',
+    'py': 'python',
+    'rs': 'rust',
+    'sh': 'bash',
+    'shell': 'bash',
+    'yml': 'yaml',
+    'cs': 'csharp',
+    'cpp': 'c++',
+};
+/**
+ * Resolve language alias to canonical name
+ */
+function resolveLanguageAlias(lang) {
+    return LANGUAGE_ALIASES[lang] || lang;
+}
+/**
+ * Get or create Shiki highlighter with lazy loading support
+ *
+ * Lazy loading strategy:
+ * 1. Start with only essential languages (js, ts, bash, md)
+ * 2. Load additional languages via preloadLanguages() as needed
+ * 3. Cache loaded languages to avoid re-loading
+ */
+async function getHighlighterInstance() {
+    if (!highlighterInstance) {
+        // Start with essential languages (covers ~80% of use cases)
+        // Additional languages are loaded via preloadLanguages() after scanning content
+        highlighterInstance = await createHighlighter({
+            themes: ['github-light', 'github-dark'],
+            langs: Array.from(ESSENTIAL_LANGUAGES),
+        });
+        // Initialize loaded languages tracking
+        ESSENTIAL_LANGUAGES.forEach(lang => loadedLanguages.add(resolveLanguageAlias(lang)));
+    }
+    return highlighterInstance;
+}
+/**
+ * Pre-load a list of languages in parallel
+ * Called after scanning all files to load only the languages actually used
+ */
+export async function preloadLanguages(languages) {
+    if (!highlighterInstance) {
+        // Create base highlighter with essential languages first
+        await getHighlighterInstance();
+    }
+    // Load all needed languages in parallel
+    const loadPromises = [];
+    for (const lang of languages) {
+        const resolved = resolveLanguageAlias(lang);
+        if (!loadedLanguages.has(resolved)) {
+            loadPromises.push((async () => {
+                try {
+                    const { bundledLanguages } = await import('shiki/langs');
+                    if (resolved in bundledLanguages) {
+                        await highlighterInstance.loadLanguage(bundledLanguages[resolved]);
+                        loadedLanguages.add(resolved);
+                    }
+                }
+                catch {
+                    // Language not available, ignore
+                }
+            })());
+        }
+    }
+    await Promise.all(loadPromises);
+}
+/**
+ * Get or create a shared MarkdownIt instance
+ * This allows reusing the same instance across multiple parseMarkdown calls
+ *
+ * @param options - Markdown parsing options
+ * @param env - Markdown environment context
+ * @returns Configured MarkdownIt instance
+ */
+export async function getMarkdownIt(options = {}, env = {}) {
+    const highlighter = await getHighlighterInstance();
+    // Create enhanced highlighter with line features
+    const enhancedHighlight = createEnhancedHighlighter(highlighter, {
+        lineNumbers: options.lineNumbers ?? true,
+    });
+    const md = new MarkdownIt({
+        html: true, // Allow HTML in markdown (authors are trusted in SSG context)
+        linkify: true,
+        typographer: true,
+        highlight: (code, lang, attrs) => {
+            if (!lang) {
+                return ''; // Use default escaping
+            }
+            try {
+                // attrs contains a meta string (e.g., "{4}" or "title='file.js'")
+                return enhancedHighlight(code, lang, attrs);
+            }
+            catch (e) {
+                // Fallback for unsupported languages
+                return '';
+            }
+        },
+    });
+    // Add plugins
+    md.use(mdAnchor, {
+        slugify: slugify,
+        permalink: mdAnchor.permalink.linkInsideHeader({
+            symbol: '#',
+            placement: 'before',
+        }),
+    });
+    md.use(mdAttrs);
+    md.use(mdEmoji.full || mdEmoji.bare);
+    // Add custom containers (tip, warning, danger, info, note)
+    setupContainers(md);
+    // Add collapsible details container
+    setupDetails(md);
+    // Add preserve Marko tags plugin if enabled
+    if (options.markoTags?.enabled) {
+        md.use(preserveTagsPlugin, {
+            tagsDir: options.markoTags?.tagsDir || 'tags/',
+            onTagDetected: (tagName, lineNumber) => {
+                // Track tag for validation at end of build
+                globalTagValidator.addDetectedTag(tagName, env.filePath || 'unknown', lineNumber);
+            },
+        });
+    }
+    return md;
+}
+/**
+ * Parse markdown with frontmatter
+ */
+export async function parseMarkdown(src, options = {}, env = {}, existingMd) {
+    // Parse frontmatter
+    const { data: frontmatter, content: rawContent, excerpt } = matter(src, {
+        excerpt: true,
+        excerpt_separator: '<!-- more -->',
+    });
+    // Preprocess file includes
+    const content = await preprocessIncludesWithRegions(rawContent, {
+        root: env.rootDir ?? process.cwd(),
+        currentFile: env.filePath ?? '',
+    });
+    // Use provided MarkdownIt or create new one
+    const md = existingMd || await setupMarkdownIt(options, env);
+    // Render to HTML
+    const html = md.render(content, env);
+    // Extract headers only if TOC is enabled for this module
+    const headers = env.extractToc ? extractHeaders(content) : [];
+    return {
+        frontmatter,
+        content,
+        html,
+        excerpt,
+        headers: buildHeaderTree(headers),
+    };
+}
+/**
+ * Setup markdown-it with plugins and Shiki highlighting
+ * @deprecated Use getMarkdownIt() directly for better reusability
+ */
+async function setupMarkdownIt(options, env) {
+    return getMarkdownIt(options, env);
+}
+/**
+ * Strip markdown formatting from text for cleaner TOC entries
+ * Removes bold, italic, code, links, and other inline markdown
+ */
+function stripMarkdownFormatting(text) {
+    return text
+        // Remove inline code: `code`
+        .replace(/`([^`]+)`/g, '$1')
+        // Remove bold/italic: **text**, __text__, *text*, _text_
+        .replace(/\*\*\*\+([^*]+)\*\*\+/g, '$1')
+        .replace(/___+([^_]+)___+/g, '$1')
+        .replace(/\*\*([^*]+)\*\*/g, '$1')
+        .replace(/__([^_]+)__/g, '$1')
+        .replace(/\*([^*]+)\*/g, '$1')
+        .replace(/_([^_]+)_/g, '$1')
+        // Remove links: [text](url) or [text](url "title")
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+        .replace(/\[([^\]]+)\]\[[^\]]+\]/g, '$1')
+        .trim();
+}
+/**
+ * Extract headers from markdown content
+ * Skips code blocks (fenced and indented) to avoid extracting comments from code examples
+ */
+function extractHeaders(content) {
+    const headers = [];
+    // Remove code blocks before processing headers
+    // This prevents extracting # comments from bash/code examples
+    const withoutCodeBlocks = content
+        .replace(/```[\s\S]*?```/g, '') // Fenced code blocks
+        .replace(/~~~[\s\S]*?~~~/g, '') // Tilde-fenced code blocks
+        .replace(/^(\t| {4}).+$/gm, ''); // Indented code blocks
+    const headerRegex = /^(#{1,6})\s+(.+)$/gm;
+    let match;
+    while ((match = headerRegex.exec(withoutCodeBlocks)) !== null) {
+        const level = match[1].length;
+        const rawTitle = match[2].trim();
+        const title = stripMarkdownFormatting(rawTitle);
+        const slug = slugify(rawTitle); // Use raw title for slug to preserve numbering
+        headers.push({ level, title, slug });
+    }
+    return headers;
+}
+/**
+ * Build header tree from flat list
+ */
+function buildHeaderTree(headers) {
+    const result = [];
+    const stack = [];
+    for (const header of headers) {
+        const node = {
+            level: header.level,
+            title: header.title,
+            slug: header.slug,
+            children: [],
+        };
+        // Pop from stack until we find parent level
+        while (stack.length > 0 && stack[stack.length - 1].level >= header.level) {
+            stack.pop();
+        }
+        if (stack.length === 0) {
+            result.push(node);
+        }
+        else {
+            stack[stack.length - 1].children.push(node);
+        }
+        stack.push(node);
+    }
+    return result;
+}
+/**
+ * Slugify text for URL-safe IDs
+ * Preserves emojis (URL-safe) and text, removes special chars
+ * Handles camelCase by inserting hyphens at word boundaries
+ */
+function slugify(text) {
+    return text
+        .trim()
+        // Insert hyphens between lowercase-to-uppercase transitions (camelCase)
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        // Insert hyphens between digit-to-letter transitions
+        .replace(/([0-9])([a-zA-Z])/g, '$1-$2')
+        // Insert hyphens between letter-to-digit transitions
+        .replace(/([a-zA-Z])([0-9])/g, '$1-$2')
+        .toLowerCase()
+        // Replace spaces with hyphens
+        .replace(/\s+/g, '-')
+        // Remove special chars but keep letters, numbers, hyphens, and emojis
+        // Emojis are in Unicode ranges outside \w (word chars)
+        .replace(/[^\w\u00A0-\uFFFF\-]+/g, '')
+        // Remove leading/trailing hyphens
+        .replace(/^-+|-+$/g, '')
+        // Replace multiple hyphens with single
+        .replace(/-+/g, '-');
+}
+/**
+ * Validate frontmatter against VitePress/Docusaurus schema
+ */
+export function validateFrontmatter(frontmatter) {
+    const errors = [];
+    // Common fields
+    if (frontmatter.title !== undefined && typeof frontmatter.title !== 'string') {
+        errors.push('title must be a string');
+    }
+    if (frontmatter.description !== undefined && typeof frontmatter.description !== 'string') {
+        errors.push('description must be a string');
+    }
+    if (frontmatter.draft !== undefined && typeof frontmatter.draft !== 'boolean') {
+        errors.push('draft must be a boolean');
+    }
+    // Date fields
+    if (frontmatter.date !== undefined) {
+        if (!(typeof frontmatter.date === 'string' || frontmatter.date instanceof Date)) {
+            errors.push('date must be a string or Date');
+        }
+    }
+    // Tags/categories
+    if (frontmatter.tags !== undefined && !Array.isArray(frontmatter.tags)) {
+        errors.push('tags must be an array');
+    }
+    if (frontmatter.categories !== undefined && !Array.isArray(frontmatter.categories)) {
+        errors.push('categories must be an array');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/markdown/loader.js.map

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

package/dist/markdown/preserve-tags.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Markdown-it plugin to preserve Marko tags (kebab-case) during markdown processing
+ *
+ * This plugin detects Marko component tags and preserves them verbatim,
+ * allowing Marko's runtime to handle component discovery and rendering.
+ *
+ * - Preserves self-closing tags: <my-tag prop="value"/>
+ * - Preserves tags with content: <my-tag>content</my-tag>
+ * - Converts markdown→HTML inside tags that don't contain Marko syntax
+ * - Preserves Marko template content as-is (nested components, slots)
+ */
+/**
+ * Main plugin function
+ */
+export declare function preserveTagsPlugin(md: any, options: any): void;
+//# sourceMappingURL=preserve-tags.d.ts.map

package/dist/markdown/preserve-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preserve-tags.d.ts","sourceRoot":"","sources":["../../src/markdown/preserve-tags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqPH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAiC9D"}

package/dist/markdown/preserve-tags.js

@@ -0,0 +1,233 @@
+/**
+ * Markdown-it plugin to preserve Marko tags (kebab-case) during markdown processing
+ *
+ * This plugin detects Marko component tags and preserves them verbatim,
+ * allowing Marko's runtime to handle component discovery and rendering.
+ *
+ * - Preserves self-closing tags: <my-tag prop="value"/>
+ * - Preserves tags with content: <my-tag>content</my-tag>
+ * - Converts markdown→HTML inside tags that don't contain Marko syntax
+ * - Preserves Marko template content as-is (nested components, slots)
+ */
+// Standard HTML5 elements that should NOT be preserved
+const HTML_ELEMENTS = new Set([
+    'div', 'p', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'hr', 'blockquote', 'pre', 'figure', 'figcaption',
+    'span', 'a', 'strong', 'em', 'b', 'i', 'u', 's', 'sub', 'sup', 'code', 'small',
+    'ul', 'ol', 'li', 'dl', 'dt', 'dd',
+    'table', 'thead', 'tbody', 'tfoot', 'tr', 'th', 'td', 'caption', 'col', 'colgroup',
+    'form', 'input', 'button', 'select', 'datalist', 'optgroup', 'option', 'textarea',
+    'label', 'fieldset', 'legend',
+    'img', 'video', 'audio', 'source', 'track', 'canvas', 'map', 'area',
+    'script', 'style', 'link', 'meta', 'noscript',
+    'html', 'head', 'body', 'title', 'base', 'section', 'article', 'aside', 'header', 'footer', 'nav', 'main', 'address',
+    'details', 'summary', 'dialog',
+    'iframe', 'object', 'param', 'embed',
+]);
+/**
+ * Create placeholder for a detected Marko component
+ */
+function createPlaceholder(id) {
+    return `<div data-marko-tag="${id}"></div>`;
+}
+/**
+ * Restore Marko components from placeholders
+ */
+function restoreComponents(html, components) {
+    let result = html;
+    // Restore in reverse order to preserve positions
+    for (let i = components.length - 1; i >= 0; i--) {
+        const comp = components[i];
+        const placeholder = createPlaceholder(comp.id);
+        result = result.replace(placeholder, comp.processedTag);
+    }
+    return result;
+}
+/**
+ * Check if content contains Marko syntax (nested components or named slots)
+ */
+function hasMarkoSyntax(content) {
+    // Check for nested Marko components (kebab-case tags)
+    const nestedComponentRegex = /<[a-z][a-z0-9-]*(?:\s[^>]*?)?>/;
+    // Check for named slots (@slot-name)
+    const namedSlotRegex = /<@[\w-]+/;
+    return nestedComponentRegex.test(content) || namedSlotRegex.test(content);
+}
+/**
+ * Process component content - convert markdown to HTML if no Marko syntax present
+ */
+function processComponentContent(content, md) {
+    if (!content || !content.trim()) {
+        return '';
+    }
+    if (hasMarkoSyntax(content)) {
+        // Content is a Marko template - preserve as-is
+        return content;
+    }
+    // Content is plain markdown - convert to HTML
+    let html = md.render(content);
+    // Unwrap <p> tags if markdown-it wrapped the content
+    // (markdown-it wraps plain text in <p> tags)
+    const trimmed = html.trim();
+    if (trimmed.startsWith('<p>') && trimmed.endsWith('</p>')) {
+        const inner = trimmed.slice(3, -4);
+        // Check if there are no other block elements, then unwrap
+        if (!inner.includes('</div>') && !inner.includes('<pre>')) {
+            html = inner;
+        }
+    }
+    return html;
+}
+function parseOpeningTag(markdown, pos) {
+    const tagRegex = /<([a-z][a-z0-9-]*)(\s[^>]*?)?(\/)?>/g;
+    tagRegex.lastIndex = pos;
+    const match = tagRegex.exec(markdown);
+    if (!match) {
+        return null;
+    }
+    return {
+        name: match[1],
+        attrs: match[2] || '',
+        selfClosing: match[3] === '/',
+        end: match.index + match[0].length
+    };
+}
+/**
+ * Extract full Marko component with content
+ */
+function extractComponent(markdown, startPos, md, onTagDetected, getLineNumber) {
+    const openingTag = parseOpeningTag(markdown, startPos);
+    if (!openingTag) {
+        return null;
+    }
+    const tagName = openingTag.name;
+    // Skip if it's a standard HTML element
+    if (HTML_ELEMENTS.has(tagName)) {
+        return null;
+    }
+    // Notify callback for validation
+    if (onTagDetected && getLineNumber) {
+        const lineNumber = getLineNumber(markdown, startPos);
+        onTagDetected(tagName, lineNumber);
+    }
+    // If self-closing, return immediately
+    if (openingTag.selfClosing) {
+        return {
+            id: 0,
+            start: startPos,
+            end: openingTag.end,
+            originalTag: markdown.slice(startPos, openingTag.end),
+            content: '',
+            processedTag: markdown.slice(startPos, openingTag.end)
+        };
+    }
+    // Find matching closing tag (handle nesting)
+    let pos = openingTag.end;
+    let depth = 1;
+    const closeTagStart = `</${tagName}`;
+    const closeTagFull = `</${tagName}>`;
+    while (pos < markdown.length && depth > 0) {
+        const nextOpen = markdown.indexOf(`<${tagName}`, pos);
+        const nextClose = markdown.indexOf(closeTagFull, pos);
+        if (nextClose === -1) {
+            // No closing tag found - treat what we have
+            break;
+        }
+        if (nextOpen !== -1 && nextOpen < nextClose) {
+            // Found opening tag before closing
+            const potentialTag = parseOpeningTag(markdown, nextOpen);
+            if (potentialTag && potentialTag.name === tagName) {
+                depth++;
+                pos = potentialTag.end;
+                continue;
+            }
+        }
+        // Found closing tag
+        depth--;
+        if (depth === 0) {
+            const endPos = nextClose + closeTagFull.length;
+            const content = markdown.slice(openingTag.end, nextClose);
+            // Process content (convert markdown or preserve Marko)
+            const processedContent = processComponentContent(content, md);
+            return {
+                id: 0,
+                start: startPos,
+                end: endPos,
+                originalTag: markdown.slice(startPos, endPos),
+                content,
+                processedTag: `<${tagName}${openingTag.attrs}>${processedContent}</${tagName}>`
+            };
+        }
+        pos = nextClose + closeTagFull.length;
+    }
+    // No matching closing tag found - treat as self-closing
+    return {
+        id: 0,
+        start: startPos,
+        end: openingTag.end,
+        originalTag: markdown.slice(startPos, openingTag.end),
+        content: '',
+        processedTag: `<${tagName}${openingTag.attrs}/>`
+    };
+}
+/**
+ * Extract all Marko components from markdown
+ */
+function extractComponents(markdown, md, onTagDetected, getLineNumber) {
+    const components = [];
+    let pos = 0;
+    let id = 0;
+    while (pos < markdown.length) {
+        // Find next potential tag
+        const tagStart = markdown.indexOf('<', pos);
+        if (tagStart === -1) {
+            break;
+        }
+        const component = extractComponent(markdown, tagStart, md, onTagDetected, getLineNumber);
+        if (component) {
+            component.id = id++;
+            components.push(component);
+            pos = component.end;
+        }
+        else {
+            pos = tagStart + 1;
+        }
+    }
+    return components;
+}
+/**
+ * Get line number from position in text
+ */
+function getLineNumber(text, position) {
+    const before = text.substring(0, position);
+    return before.split('\n').length;
+}
+/**
+ * Main plugin function
+ */
+export function preserveTagsPlugin(md, options) {
+    const { onTagDetected } = options || {};
+    // Wrap the render method
+    const originalRender = md.render.bind(md);
+    md.render = (src, env) => {
+        // Extract all Marko components (with content processing)
+        const components = extractComponents(src, md, onTagDetected, getLineNumber);
+        // Replace with placeholders
+        let processedSrc = src;
+        let offset = 0;
+        for (const comp of components) {
+            const placeholder = createPlaceholder(comp.id);
+            const adjustedStart = comp.start + offset;
+            const adjustedEnd = comp.end + offset;
+            processedSrc = processedSrc.substring(0, adjustedStart) +
+                placeholder +
+                processedSrc.substring(adjustedEnd);
+            offset += placeholder.length - (comp.end - comp.start);
+        }
+        // Render with placeholders
+        const result = originalRender(processedSrc, env);
+        // Restore Marko components (with processed content)
+        const restored = restoreComponents(String(result), components);
+        return restored;
+    };
+}
+//# sourceMappingURL=preserve-tags.js.map

package/dist/markdown/preserve-tags.js.map

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

package/dist/markdown/renderer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Request-time markdown renderer
+ * Lazy-loads MarkdownIt + Shiki on first use
+ * Used by route handlers to render markdown on demand
+ */
+import MarkdownIt from 'markdown-it';
+import type { MarkdownOptions, ProcessedMarkdown } from './types.js';
+/**
+ * Render markdown source to HTML at request time
+ *
+ * This function lazy-loads MarkdownIt + Shiki on first call,
+ * then reuses the instance for subsequent renders.
+ *
+ * @param source - Raw markdown source with frontmatter
+ * @param options - Markdown parsing options (only used on first call)
+ * @returns Processed markdown with frontmatter, HTML, and headers
+ */
+export declare function renderMarkdown(source: string, options?: MarkdownOptions): Promise<ProcessedMarkdown>;
+/**
+ * Reset the cached MarkdownIt instance
+ * Useful for testing or when options change
+ */
+export declare function resetRendererCache(): void;
+/**
+ * Get the current MarkdownIt instance if initialized
+ */
+export declare function getRendererInstance(): MarkdownIt | null;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/markdown/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/markdown/renderer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,UAAU,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAU,MAAM,YAAY,CAAC;AAQ7E;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,CAkC5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,GAAG,IAAI,CAEvD"}