@prenta/core 0.123.0 → 1.0.0

package/dist/page-builder/seo-analyzer.js

@@ -1,778 +0,0 @@
-import { hasChildren } from './types.js';
-// ─── Helpers ───────────────────────────────────────────────────────────────
-export function stripHtml(html) {
-    return html.replace(/<[^>]*>/g, '').trim();
-}
-export function countWords(text) {
-    const trimmed = text.trim();
-    if (trimmed.length === 0)
-        return 0;
-    return trimmed.split(/\s+/).length;
-}
-export function countSentences(text) {
-    const matches = text.match(/[.!?]+/g);
-    return matches ? matches.length : 1;
-}
-export function countSyllables(word) {
-    const w = word.toLowerCase().replace(/[^a-z]/g, '');
-    if (w.length <= 2)
-        return 1;
-    let count = 0;
-    let prevVowel = false;
-    for (let i = 0; i < w.length; i++) {
-        const char = w[i];
-        const isVowel = /[aeiouy]/.test(char);
-        if (isVowel && !prevVowel) {
-            count++;
-        }
-        prevVowel = isVowel;
-    }
-    if (w.endsWith('e') && count > 1) {
-        count--;
-    }
-    return Math.max(count, 1);
-}
-function isInternalLink(url) {
-    return url.startsWith('/') || url.startsWith('#');
-}
-function extractStringValues(data) {
-    const parts = [];
-    for (const value of Object.values(data)) {
-        if (typeof value === 'string') {
-            parts.push(stripHtml(value));
-        }
-        else if (Array.isArray(value)) {
-            for (const item of value) {
-                if (typeof item === 'string') {
-                    parts.push(stripHtml(item));
-                }
-                else if (item && typeof item === 'object') {
-                    parts.push(extractStringValues(item));
-                }
-            }
-        }
-        else if (value && typeof value === 'object') {
-            parts.push(extractStringValues(value));
-        }
-    }
-    return parts.filter(Boolean).join(' ');
-}
-// ─── Content Extractor ─────────────────────────────────────────────────────
-function extractBlockContent(block, content) {
-    const { blockType } = block.settings;
-    const data = block.data;
-    const texts = [];
-    switch (blockType) {
-        case 'hero': {
-            const title = typeof data.title === 'string' ? data.title : '';
-            const subtitle = typeof data.subtitle === 'string' ? data.subtitle : '';
-            const ctaText = typeof data.ctaText === 'string' ? data.ctaText : '';
-            if (title)
-                texts.push(title);
-            if (subtitle)
-                texts.push(subtitle);
-            if (ctaText)
-                texts.push(ctaText);
-            if (title) {
-                content.headings.push({ level: 1, text: title, blockId: block.id });
-            }
-            if (typeof data.image === 'string' && data.image) {
-                content.images.push({
-                    src: data.image,
-                    alt: typeof data.alt === 'string' ? data.alt : '',
-                    blockId: block.id,
-                });
-            }
-            if (typeof data.ctaLink === 'string' && data.ctaLink) {
-                content.links.push({
-                    url: data.ctaLink,
-                    text: ctaText || 'CTA',
-                    internal: isInternalLink(data.ctaLink),
-                    blockId: block.id,
-                });
-            }
-            break;
-        }
-        case 'text': {
-            const heading = typeof data.heading === 'string' ? data.heading : '';
-            const body = typeof data.body === 'string' ? stripHtml(data.body) : '';
-            if (heading)
-                texts.push(heading);
-            if (body)
-                texts.push(body);
-            if (heading) {
-                const level = typeof data.headingLevel === 'number' ? data.headingLevel : 2;
-                content.headings.push({ level, text: heading, blockId: block.id });
-            }
-            break;
-        }
-        case 'image': {
-            const alt = typeof data.alt === 'string' ? data.alt : '';
-            const caption = typeof data.caption === 'string' ? data.caption : '';
-            if (alt)
-                texts.push(alt);
-            if (caption)
-                texts.push(caption);
-            content.images.push({
-                src: typeof data.src === 'string' ? data.src : '',
-                alt,
-                blockId: block.id,
-            });
-            if (typeof data.link === 'string' && data.link) {
-                content.links.push({
-                    url: data.link,
-                    text: alt || caption || 'Image link',
-                    internal: isInternalLink(data.link),
-                    blockId: block.id,
-                });
-            }
-            break;
-        }
-        case 'cards': {
-            const items = Array.isArray(data.items) ? data.items : [];
-            for (const item of items) {
-                if (item && typeof item === 'object') {
-                    const cardItem = item;
-                    const title = typeof cardItem.title === 'string' ? cardItem.title : '';
-                    const desc = typeof cardItem.description === 'string' ? cardItem.description : '';
-                    if (title)
-                        texts.push(title);
-                    if (desc)
-                        texts.push(stripHtml(desc));
-                    if (typeof cardItem.link === 'string' && cardItem.link) {
-                        content.links.push({
-                            url: cardItem.link,
-                            text: title || 'Card link',
-                            internal: isInternalLink(cardItem.link),
-                            blockId: block.id,
-                        });
-                    }
-                }
-            }
-            break;
-        }
-        case 'cta': {
-            const heading = typeof data.heading === 'string' ? data.heading : '';
-            const body = typeof data.body === 'string' ? stripHtml(data.body) : '';
-            const buttonText = typeof data.buttonText === 'string' ? data.buttonText : '';
-            if (heading)
-                texts.push(heading);
-            if (body)
-                texts.push(body);
-            if (buttonText)
-                texts.push(buttonText);
-            if (typeof data.buttonLink === 'string' && data.buttonLink) {
-                content.links.push({
-                    url: data.buttonLink,
-                    text: buttonText || 'Button',
-                    internal: isInternalLink(data.buttonLink),
-                    blockId: block.id,
-                });
-            }
-            break;
-        }
-        case 'video': {
-            for (const value of Object.values(data)) {
-                if (typeof value === 'string' && value) {
-                    texts.push(value);
-                }
-            }
-            break;
-        }
-        case 'gallery': {
-            const images = Array.isArray(data.images) ? data.images : [];
-            for (const img of images) {
-                if (img && typeof img === 'object') {
-                    const imgItem = img;
-                    const alt = typeof imgItem.alt === 'string' ? imgItem.alt : '';
-                    const caption = typeof imgItem.caption === 'string' ? imgItem.caption : '';
-                    if (alt)
-                        texts.push(alt);
-                    if (caption)
-                        texts.push(caption);
-                    content.images.push({
-                        src: typeof imgItem.src === 'string' ? imgItem.src : '',
-                        alt,
-                        blockId: block.id,
-                    });
-                }
-            }
-            break;
-        }
-        case 'faq': {
-            const items = Array.isArray(data.items) ? data.items : [];
-            for (const item of items) {
-                if (item && typeof item === 'object') {
-                    const faqItem = item;
-                    const question = typeof faqItem.question === 'string' ? faqItem.question : '';
-                    const answer = typeof faqItem.answer === 'string' ? stripHtml(faqItem.answer) : '';
-                    if (question)
-                        texts.push(question);
-                    if (answer)
-                        texts.push(answer);
-                }
-            }
-            break;
-        }
-        case 'form': {
-            const msg = typeof data.successMessage === 'string' ? data.successMessage : '';
-            if (msg)
-                texts.push(msg);
-            break;
-        }
-        case 'code':
-            break;
-        default: {
-            texts.push(extractStringValues(data));
-            break;
-        }
-    }
-    const blockText = texts.filter(Boolean).join(' ');
-    if (blockText) {
-        content.blockTexts.set(block.id, blockText);
-    }
-}
-function traverseTree(node, content) {
-    if (node.type === 'block') {
-        extractBlockContent(node, content);
-        return;
-    }
-    if (hasChildren(node)) {
-        for (const child of node.children) {
-            traverseTree(child, content);
-        }
-    }
-}
-export function extractContent(tree) {
-    const content = {
-        plainText: '',
-        wordCount: 0,
-        headings: [],
-        images: [],
-        links: [],
-        blockTexts: new Map(),
-    };
-    traverseTree(tree, content);
-    const allTexts = [];
-    for (const text of content.blockTexts.values()) {
-        allTexts.push(text);
-    }
-    content.plainText = allTexts.join(' ');
-    content.wordCount = countWords(content.plainText);
-    return content;
-}
-// ─── Readability Analyzer ──────────────────────────────────────────────────
-export function analyzeReadability(text) {
-    const words = text.trim().split(/\s+/).filter(Boolean);
-    const wordCount = words.length;
-    if (wordCount === 0) {
-        return {
-            fleschScore: 0,
-            avgSentenceLength: 0,
-            wordCount: 0,
-            readingTime: 0,
-            passiveEstimate: 0,
-        };
-    }
-    const sentenceCount = countSentences(text);
-    const avgSentenceLength = wordCount / sentenceCount;
-    let totalSyllables = 0;
-    for (const word of words) {
-        totalSyllables += countSyllables(word);
-    }
-    const fleschScore = Math.max(0, Math.min(100, 206.835 - 1.015 * avgSentenceLength - 84.6 * (totalSyllables / wordCount)));
-    const readingTime = Math.ceil(wordCount / 200);
-    const passivePattern = /\b(is|are|was|were|been|being|be)\s+\w+ed\b/gi;
-    const passiveMatches = text.match(passivePattern);
-    const passiveCount = passiveMatches ? passiveMatches.length : 0;
-    const passiveEstimate = sentenceCount > 0 ? Math.round((passiveCount / sentenceCount) * 100) : 0;
-    return {
-        fleschScore: Math.round(fleschScore * 10) / 10,
-        avgSentenceLength: Math.round(avgSentenceLength * 10) / 10,
-        wordCount,
-        readingTime,
-        passiveEstimate: Math.min(passiveEstimate, 100),
-    };
-}
-// ─── SEO Checker ───────────────────────────────────────────────────────────
-function keyphraseInText(text, keyphrase) {
-    return text.toLowerCase().includes(keyphrase.toLowerCase());
-}
-function keyphraseCount(text, keyphrase) {
-    const lower = text.toLowerCase();
-    const kp = keyphrase.toLowerCase();
-    let count = 0;
-    let idx = 0;
-    while ((idx = lower.indexOf(kp, idx)) !== -1) {
-        count++;
-        idx += kp.length;
-    }
-    return count;
-}
-function getFirstParagraph(content) {
-    for (const text of content.blockTexts.values()) {
-        if (text.trim().length > 0)
-            return text;
-    }
-    return '';
-}
-export function analyzeSEO(tree, pageSettings) {
-    const content = extractContent(tree);
-    const readability = analyzeReadability(content.plainText);
-    const checks = [];
-    const perBlockHints = new Map();
-    const kp = pageSettings.focusKeyphrase || '';
-    const metaTitle = pageSettings.metaTitle || pageSettings.title || '';
-    const metaDesc = pageSettings.metaDescription || '';
-    // ── Page-level checks ───────────────────────────────────────────────────
-    if (metaTitle.length === 0) {
-        checks.push({
-            id: 'meta-title-exists',
-            label: 'Meta title',
-            status: 'error',
-            detail: 'Meta title is missing',
-        });
-    }
-    else if (metaTitle.length < 30 || metaTitle.length > 60) {
-        checks.push({
-            id: 'meta-title-length',
-            label: 'Meta title length',
-            status: 'warning',
-            detail: `Meta title is ${metaTitle.length} chars (recommended: 30-60)`,
-        });
-    }
-    else {
-        checks.push({
-            id: 'meta-title-length',
-            label: 'Meta title length',
-            status: 'good',
-            detail: `Meta title is ${metaTitle.length} chars`,
-        });
-    }
-    if (metaDesc.length === 0) {
-        checks.push({
-            id: 'meta-desc-exists',
-            label: 'Meta description',
-            status: 'error',
-            detail: 'Meta description is missing',
-        });
-    }
-    else if (metaDesc.length < 120 || metaDesc.length > 160) {
-        checks.push({
-            id: 'meta-desc-length',
-            label: 'Meta description length',
-            status: 'warning',
-            detail: `Meta description is ${metaDesc.length} chars (recommended: 120-160)`,
-        });
-    }
-    else {
-        checks.push({
-            id: 'meta-desc-length',
-            label: 'Meta description length',
-            status: 'good',
-            detail: `Meta description is ${metaDesc.length} chars`,
-        });
-    }
-    if (!kp) {
-        checks.push({
-            id: 'keyphrase-set',
-            label: 'Focus keyphrase',
-            status: 'warning',
-            detail: 'No focus keyphrase set',
-        });
-    }
-    else {
-        checks.push({
-            id: 'keyphrase-set',
-            label: 'Focus keyphrase',
-            status: 'good',
-            detail: `Focus keyphrase: "${kp}"`,
-        });
-        if (keyphraseInText(metaTitle, kp)) {
-            checks.push({
-                id: 'keyphrase-in-title',
-                label: 'Keyphrase in title',
-                status: 'good',
-                detail: 'Focus keyphrase found in meta title',
-            });
-        }
-        else {
-            checks.push({
-                id: 'keyphrase-in-title',
-                label: 'Keyphrase in title',
-                status: 'warning',
-                detail: 'Focus keyphrase not found in meta title',
-            });
-        }
-        if (keyphraseInText(metaDesc, kp)) {
-            checks.push({
-                id: 'keyphrase-in-desc',
-                label: 'Keyphrase in description',
-                status: 'good',
-                detail: 'Focus keyphrase found in meta description',
-            });
-        }
-        else {
-            checks.push({
-                id: 'keyphrase-in-desc',
-                label: 'Keyphrase in description',
-                status: 'warning',
-                detail: 'Focus keyphrase not found in meta description',
-            });
-        }
-        if (keyphraseInText(pageSettings.slug, kp)) {
-            checks.push({
-                id: 'keyphrase-in-slug',
-                label: 'Keyphrase in slug',
-                status: 'good',
-                detail: 'Focus keyphrase found in URL slug',
-            });
-        }
-        else {
-            checks.push({
-                id: 'keyphrase-in-slug',
-                label: 'Keyphrase in slug',
-                status: 'warning',
-                detail: 'Focus keyphrase not found in URL slug',
-            });
-        }
-        const firstPara = getFirstParagraph(content);
-        if (keyphraseInText(firstPara, kp)) {
-            checks.push({
-                id: 'keyphrase-in-intro',
-                label: 'Keyphrase in introduction',
-                status: 'good',
-                detail: 'Focus keyphrase found in first paragraph',
-            });
-        }
-        else {
-            checks.push({
-                id: 'keyphrase-in-intro',
-                label: 'Keyphrase in introduction',
-                status: 'warning',
-                detail: 'Focus keyphrase not found in first paragraph',
-            });
-        }
-        const kpCount = keyphraseCount(content.plainText, kp);
-        const density = content.wordCount > 0 ? ((kpCount * countWords(kp)) / content.wordCount) * 100 : 0;
-        if (density >= 0.5 && density <= 3) {
-            checks.push({
-                id: 'keyphrase-density',
-                label: 'Keyphrase density',
-                status: 'good',
-                detail: `Keyphrase density is ${density.toFixed(1)}%`,
-            });
-        }
-        else if (density === 0) {
-            checks.push({
-                id: 'keyphrase-density',
-                label: 'Keyphrase density',
-                status: 'error',
-                detail: 'Keyphrase not found in content',
-            });
-        }
-        else {
-            checks.push({
-                id: 'keyphrase-density',
-                label: 'Keyphrase density',
-                status: 'warning',
-                detail: `Keyphrase density is ${density.toFixed(1)}% (recommended: 0.5-3%)`,
-            });
-        }
-    }
-    if (content.wordCount >= 300) {
-        checks.push({
-            id: 'content-length',
-            label: 'Content length',
-            status: 'good',
-            detail: `${content.wordCount} words`,
-        });
-    }
-    else {
-        checks.push({
-            id: 'content-length',
-            label: 'Content length',
-            status: 'warning',
-            detail: `Only ${content.wordCount} words (recommended: 300+)`,
-        });
-    }
-    if (pageSettings.ogImage) {
-        checks.push({
-            id: 'og-image',
-            label: 'Open Graph image',
-            status: 'good',
-            detail: 'OG image is set',
-        });
-    }
-    else {
-        checks.push({
-            id: 'og-image',
-            label: 'Open Graph image',
-            status: 'warning',
-            detail: 'No OG image set',
-        });
-    }
-    if (pageSettings.schemaType) {
-        checks.push({
-            id: 'schema-type',
-            label: 'Schema type',
-            status: 'good',
-            detail: `Schema type: ${pageSettings.schemaType}`,
-        });
-    }
-    else {
-        checks.push({
-            id: 'schema-type',
-            label: 'Schema type',
-            status: 'warning',
-            detail: 'No schema type set',
-        });
-    }
-    // ── Heading structure ───────────────────────────────────────────────────
-    const h1Count = content.headings.filter((h) => h.level === 1).length;
-    if (h1Count === 0) {
-        checks.push({
-            id: 'h1-exists',
-            label: 'H1 heading',
-            status: 'error',
-            detail: 'No H1 heading found',
-        });
-    }
-    else if (h1Count === 1) {
-        checks.push({
-            id: 'h1-exists',
-            label: 'H1 heading',
-            status: 'good',
-            detail: 'Single H1 heading found',
-        });
-    }
-    else {
-        checks.push({
-            id: 'h1-exists',
-            label: 'H1 heading',
-            status: 'warning',
-            detail: `Multiple H1 headings found (${h1Count})`,
-        });
-    }
-    let hierarchyGood = true;
-    const sortedHeadings = [...content.headings];
-    for (let i = 1; i < sortedHeadings.length; i++) {
-        const prev = sortedHeadings[i - 1];
-        const curr = sortedHeadings[i];
-        if (prev && curr && curr.level > prev.level + 1) {
-            hierarchyGood = false;
-            break;
-        }
-    }
-    if (hierarchyGood) {
-        checks.push({
-            id: 'heading-hierarchy',
-            label: 'Heading hierarchy',
-            status: 'good',
-            detail: 'Heading levels follow a logical order',
-        });
-    }
-    else {
-        checks.push({
-            id: 'heading-hierarchy',
-            label: 'Heading hierarchy',
-            status: 'warning',
-            detail: 'Heading hierarchy skips levels',
-        });
-    }
-    if (kp && content.headings.some((h) => keyphraseInText(h.text, kp))) {
-        checks.push({
-            id: 'keyphrase-in-heading',
-            label: 'Keyphrase in heading',
-            status: 'good',
-            detail: 'Focus keyphrase found in a heading',
-        });
-    }
-    else if (kp) {
-        checks.push({
-            id: 'keyphrase-in-heading',
-            label: 'Keyphrase in heading',
-            status: 'warning',
-            detail: 'Focus keyphrase not found in any heading',
-        });
-    }
-    // ── Image checks ────────────────────────────────────────────────────────
-    const imagesWithoutAlt = content.images.filter((img) => !img.alt);
-    if (imagesWithoutAlt.length === 0 && content.images.length > 0) {
-        checks.push({
-            id: 'images-alt',
-            label: 'Image alt text',
-            status: 'good',
-            detail: 'All images have alt text',
-        });
-    }
-    else if (imagesWithoutAlt.length > 0) {
-        checks.push({
-            id: 'images-alt',
-            label: 'Image alt text',
-            status: 'error',
-            detail: `${imagesWithoutAlt.length} image(s) missing alt text`,
-        });
-    }
-    if (kp && content.images.some((img) => keyphraseInText(img.alt, kp))) {
-        checks.push({
-            id: 'keyphrase-in-alt',
-            label: 'Keyphrase in image alt',
-            status: 'good',
-            detail: 'Focus keyphrase found in at least one image alt text',
-        });
-    }
-    else if (kp && content.images.length > 0) {
-        checks.push({
-            id: 'keyphrase-in-alt',
-            label: 'Keyphrase in image alt',
-            status: 'warning',
-            detail: 'Focus keyphrase not found in any image alt text',
-        });
-    }
-    // ── Link checks ─────────────────────────────────────────────────────────
-    const internalLinks = content.links.filter((l) => l.internal);
-    const externalLinks = content.links.filter((l) => !l.internal);
-    if (internalLinks.length > 0) {
-        checks.push({
-            id: 'internal-links',
-            label: 'Internal links',
-            status: 'good',
-            detail: `${internalLinks.length} internal link(s)`,
-        });
-    }
-    else {
-        checks.push({
-            id: 'internal-links',
-            label: 'Internal links',
-            status: 'warning',
-            detail: 'No internal links found',
-        });
-    }
-    if (externalLinks.length > 0) {
-        checks.push({
-            id: 'external-links',
-            label: 'External links',
-            status: 'good',
-            detail: `${externalLinks.length} external link(s)`,
-        });
-    }
-    else {
-        checks.push({
-            id: 'external-links',
-            label: 'External links',
-            status: 'warning',
-            detail: 'No external links found',
-        });
-    }
-    // ── Per-block hints ─────────────────────────────────────────────────────
-    for (const img of content.images) {
-        if (!img.alt) {
-            addBlockHint(perBlockHints, img.blockId, {
-                id: 'block-missing-alt',
-                label: 'Missing alt text',
-                status: 'error',
-                detail: 'Missing alt text',
-                blockId: img.blockId,
-            });
-        }
-        else if (kp && !keyphraseInText(img.alt, kp)) {
-            addBlockHint(perBlockHints, img.blockId, {
-                id: 'block-alt-no-keyphrase',
-                label: 'Alt text keyphrase',
-                status: 'warning',
-                detail: "Alt text doesn't contain focus keyphrase",
-                blockId: img.blockId,
-            });
-        }
-    }
-    for (const [blockId, blockText] of content.blockTexts) {
-        if (kp) {
-            const heading = content.headings.find((h) => h.blockId === blockId && h.level === 1);
-            if (heading && !keyphraseInText(heading.text, kp)) {
-                addBlockHint(perBlockHints, blockId, {
-                    id: 'block-hero-no-keyphrase',
-                    label: 'Title keyphrase',
-                    status: 'warning',
-                    detail: "Title doesn't contain focus keyphrase",
-                    blockId,
-                });
-            }
-        }
-        if (countWords(blockText) > 300) {
-            addBlockHint(perBlockHints, blockId, {
-                id: 'block-paragraph-long',
-                label: 'Paragraph length',
-                status: 'warning',
-                detail: 'Paragraph too long',
-                blockId,
-            });
-        }
-    }
-    // Check for text blocks without headings
-    traverseForTextBlockHints(tree, content, perBlockHints);
-    // Check for video blocks without poster
-    traverseForVideoHints(tree, perBlockHints);
-    // ── Score calculation ───────────────────────────────────────────────────
-    let totalScore = 0;
-    for (const check of checks) {
-        if (check.status === 'good')
-            totalScore += 100;
-        else if (check.status === 'warning')
-            totalScore += 50;
-    }
-    const score = checks.length > 0 ? Math.round(totalScore / checks.length) : 0;
-    return { score, checks, readability, content, perBlockHints };
-}
-// ─── Internal Utilities ────────────────────────────────────────────────────
-function addBlockHint(map, blockId, hint) {
-    const existing = map.get(blockId);
-    if (existing) {
-        existing.push(hint);
-    }
-    else {
-        map.set(blockId, [hint]);
-    }
-}
-function traverseForTextBlockHints(node, content, perBlockHints) {
-    if (node.type === 'block') {
-        if (node.settings.blockType === 'text') {
-            const hasHeading = content.headings.some((h) => h.blockId === node.id);
-            if (!hasHeading) {
-                addBlockHint(perBlockHints, node.id, {
-                    id: 'block-no-heading',
-                    label: 'Section heading',
-                    status: 'warning',
-                    detail: 'No heading in this section',
-                    blockId: node.id,
-                });
-            }
-        }
-        return;
-    }
-    if (hasChildren(node)) {
-        for (const child of node.children) {
-            traverseForTextBlockHints(child, content, perBlockHints);
-        }
-    }
-}
-function traverseForVideoHints(node, perBlockHints) {
-    if (node.type === 'block') {
-        if (node.settings.blockType === 'video' && !node.data.poster) {
-            addBlockHint(perBlockHints, node.id, {
-                id: 'block-video-no-poster',
-                label: 'Video poster',
-                status: 'warning',
-                detail: 'No poster image set',
-                blockId: node.id,
-            });
-        }
-        return;
-    }
-    if (hasChildren(node)) {
-        for (const child of node.children) {
-            traverseForVideoHints(child, perBlockHints);
-        }
-    }
-}
-//# sourceMappingURL=seo-analyzer.js.map