@opnpress/opnpress-cli 0.2.4 → 0.3.0

package/dist/{build.js → cli/buildSite.js}

@@ -5,10 +5,10 @@ import { unified } from 'unified';
 import remarkParse from 'remark-parse';
 import remarkGfm from 'remark-gfm';
 import YAML from 'yaml';
-import { loadNavigationConfig, loadSiteConfig, loadThemeConfig } from './config.js';
-import { buildPageTitle, isPublished, loadContentSources } from './content.js';
-import { buildPageArtifact, writeRenderedPage } from './render.js';
-import { escapeHtml, ensureDir, walkFiles, writeFileEnsured } from './utils.js';
+import { loadNavigationConfig, loadSiteConfig, loadThemeConfig } from '../config.js';
+import { buildPageTitle, isPublished, loadContentSources } from '../content.js';
+import { buildPageArtifact, writeRenderedPage } from '../renderer/pageGenerator.js';
+import { escapeHtml, ensureDir, walkFiles, writeFileEnsured } from '../utils.js';
 async function removeIfExists(target) {
     await fs.rm(target, { recursive: true, force: true });
 }

package/dist/{init.js → cli/initProject.js}

@@ -1,9 +1,9 @@
 import path from 'node:path';
 import { promises as fs } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { ensureDir, walkFiles, writeFileEnsured } from './utils.js';
+import { ensureDir, walkFiles, writeFileEnsured } from '../utils.js';
 const INIT_MARKER_PATH = '.opnpress/initialized.json';
-const TEMPLATE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'templates');
+const TEMPLATE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'templates');
 export async function isInitialized(rootDir) {
     try {
         await fs.access(path.join(rootDir, INIT_MARKER_PATH));

package/dist/{cli.js → cli/main.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import path from 'node:path';
-import { buildSite } from './build.js';
-import { initProject } from './init.js';
+import { buildSite } from './buildSite.js';
+import { initProject } from './initProject.js';
 import { startPreviewServer } from './server.js';
 function usage() {
     return `Usage:

package/dist/integrations/booking-calendar.js

@@ -0,0 +1,23 @@
+import { escapeHtml } from '../utils.js';
+import { sectionStyleFromConfig } from '../rendering/shared.js';
+const handler = {
+    getTrigger: () => 'booking-calendar',
+    render: (config, { site, source }) => {
+        const title = typeof config.title === 'string' ? config.title : '';
+        const description = typeof config.description === 'string' ? config.description : '';
+        const integrationConfig = site.integrations.bookingCalendar;
+        if (!integrationConfig.embedUrl) {
+            throw new Error('booking-calendar block requires integrations.bookingCalendar.embedUrl to be set in site.config.yaml');
+        }
+        return `
+      <section class="card integration integration-booking-calendar"${sectionStyleFromConfig(config, source.routePath)}>
+        ${title ? `<h2>${escapeHtml(title)}</h2>` : ''}
+        ${description ? `<p>${escapeHtml(description)}</p>` : ''}
+        <div class="embed-frame">
+          <iframe src="${escapeHtml(integrationConfig.embedUrl)}" title="${escapeHtml(integrationConfig.buttonLabel)}" loading="lazy" referrerpolicy="no-referrer-when-downgrade" allowfullscreen></iframe>
+        </div>
+      </section>
+    `;
+    }
+};
+export default handler;

package/dist/integrations/company-info.js

@@ -0,0 +1,24 @@
+import { sectionStyleFromConfig } from '../rendering/shared.js';
+import { renderContactCardMarkup } from '../rendering/contact.js';
+const handler = {
+    getTrigger: () => 'company-info',
+    render: (config, { site, source }) => renderContactCardMarkup({
+        title: typeof config.title === 'string' ? config.title : '',
+        description: typeof config.description === 'string' ? config.description : '',
+        sectionStyle: sectionStyleFromConfig(config, source.routePath),
+        currentRoute: source.routePath,
+        className: 'company-info',
+        info: {
+            name: site.integrations.companyInfo.name ?? '',
+            tagline: site.integrations.companyInfo.tagline ?? '',
+            logo: site.integrations.companyInfo.logo ?? '',
+            address: site.integrations.companyInfo.address ?? '',
+            mapUrl: site.integrations.companyInfo.mapUrl ?? '',
+            phone: site.integrations.companyInfo.phone ?? '',
+            email: site.integrations.companyInfo.email ?? '',
+            hours: site.integrations.companyInfo.hours ?? '',
+            website: site.integrations.companyInfo.website ?? ''
+        }
+    })
+};
+export default handler;

package/dist/integrations/contact-form.js

@@ -0,0 +1,35 @@
+import { escapeHtml } from '../utils.js';
+import { sectionStyleFromConfig } from '../rendering/shared.js';
+const handler = {
+    getTrigger: () => 'contact-form',
+    render: (config, { site, source }) => {
+        const title = typeof config.title === 'string' ? config.title : '';
+        const description = typeof config.description === 'string' ? config.description : '';
+        const integrationConfig = site.integrations.contactForm;
+        if (!integrationConfig.action) {
+            throw new Error('contact-form block requires integrations.contactForm.action to be set in site.config.yaml');
+        }
+        return `
+      <section class="card integration integration-contact-form"${sectionStyleFromConfig(config, source.routePath)}>
+        ${title ? `<h2>${escapeHtml(title)}</h2>` : ''}
+        ${description ? `<p>${escapeHtml(description)}</p>` : ''}
+        <form class="integration-form" action="${escapeHtml(integrationConfig.action)}" method="post">
+          <label>
+            <span>Name</span>
+            <input name="name" type="text" autocomplete="name" required />
+          </label>
+          <label>
+            <span>Email</span>
+            <input name="email" type="email" autocomplete="email" required />
+          </label>
+          <label>
+            <span>Message</span>
+            <textarea name="message" rows="5" required></textarea>
+          </label>
+          <button type="submit">${escapeHtml(integrationConfig.buttonLabel)}</button>
+        </form>
+      </section>
+    `;
+    }
+};
+export default handler;

package/dist/integrations/contact-links.js

@@ -0,0 +1,87 @@
+import { escapeHtml } from '../utils.js';
+import { sectionStyleFromConfig } from '../rendering/shared.js';
+import { normalizeContactHref } from '../rendering/contact.js';
+function contactLinkIconMarkup(kind) {
+    switch (kind) {
+        case 'email':
+            return `<svg class="contact-link-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M20 4H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V6a2 2 0 0 0-2-2Zm0 4.236-8 5-8-5V6l8 5 8-5v2.236Z"/></svg>`;
+        case 'phone':
+            return `<svg class="contact-link-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M6.62 10.79a15.5 15.5 0 0 0 6.59 6.59l2.2-2.2a1 1 0 0 1 1.02-.24c1.12.37 2.33.57 3.57.57a1 1 0 0 1 1 1V20a1 1 0 0 1-1 1C10.31 21 3 13.69 3 4a1 1 0 0 1 1-1h2.49a1 1 0 0 1 1 1c0 1.24.2 2.45.57 3.57a1 1 0 0 1-.24 1.02l-2.2 2.2Z"/></svg>`;
+        case 'website':
+            return `<svg class="contact-link-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M12 2a10 10 0 1 0 0 20 10 10 0 0 0 0-20Zm7.9 9h-3.17a15.7 15.7 0 0 0-1.16-5.2A8.02 8.02 0 0 1 19.9 11Zm-1.8 2a8.03 8.03 0 0 1-4.33 4.2c.44-1.3.73-2.75.84-4.2h3.5ZM12 20c-.82 0-2.22-2.05-2.8-6h5.6c-.58 3.95-1.98 6-2.8 6Zm-2.8-8c.11-1.45.4-2.9.84-4.2A8.03 8.03 0 0 0 5.7 12h3.5ZM12 4c.82 0 2.22 2.05 2.8 6H9.2c.58-3.95 1.98-6 2.8-6Zm-3.77 1.8A15.7 15.7 0 0 0 7.07 11H3.9a8.02 8.02 0 0 1 4.33-5.2ZM3.9 13h3.17a15.7 15.7 0 0 0 1.16 5.2A8.02 8.02 0 0 1 3.9 13Zm12.77 5.2c.44-1.3.73-2.75.84-4.2h3.17a8.02 8.02 0 0 1-4.01 4.2Z"/></svg>`;
+        case 'map':
+            return `<svg class="contact-link-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M12 2C8.14 2 5 5.14 5 9c0 4.86 7 13 7 13s7-8.14 7-13c0-3.86-3.14-7-7-7Zm0 9.5A2.5 2.5 0 1 1 12 6a2.5 2.5 0 0 1 0 5.5Z"/></svg>`;
+        case 'address':
+            return `<svg class="contact-link-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M12 2 3 7v10l9 5 9-5V7l-9-5Zm0 2.3L18 7l-6 3.7L6 7l6-2.7ZM5 8.6l6 3.7v7.6l-6-3.3V8.6Zm14 0v7.9l-6 3.2v-7.6l6-3.5Z"/></svg>`;
+        case 'hours':
+            return `<svg class="contact-link-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M12 2a10 10 0 1 0 0 20 10 10 0 0 0 0-20Zm1 10.41V7h-2v6l5 3 .99-1.63L13 12.41Z"/></svg>`;
+        default:
+            return '';
+    }
+}
+function buildContactLinkItems(data) {
+    const items = [];
+    const email = data.email?.trim();
+    const phone = data.phone?.trim();
+    const website = data.website?.trim();
+    const mapUrl = data.mapUrl?.trim();
+    const address = data.address?.trim();
+    const hours = data.hours?.trim();
+    if (email)
+        items.push({ kind: 'email', label: 'Email', href: normalizeContactHref(email, 'email') });
+    if (phone)
+        items.push({ kind: 'phone', label: 'Phone', href: normalizeContactHref(phone, 'phone') });
+    if (website)
+        items.push({ kind: 'website', label: 'Website', href: normalizeContactHref(website, 'website') });
+    if (mapUrl)
+        items.push({ kind: 'map', label: 'Map', href: normalizeContactHref(mapUrl, 'website') });
+    if (address)
+        items.push({ kind: 'address', label: 'Address', value: address });
+    if (hours)
+        items.push({ kind: 'hours', label: 'Hours', value: hours });
+    return items;
+}
+function renderContactLinksMarkup(items, options = {}) {
+    const showIcons = options.showIcons !== false;
+    const showLabels = options.showLabels !== false;
+    const variant = options.variant === 'stacked' ? 'stacked' : 'inline';
+    const content = items
+        .map((item) => {
+        const icon = showIcons ? contactLinkIconMarkup(item.kind) : '';
+        if (item.href) {
+            return `
+          <a class="share-link contact-link contact-link-${item.kind}" href="${escapeHtml(item.href)}" rel="noopener noreferrer" target="${item.href.startsWith('http') ? '_blank' : '_self'}"${showLabels ? '' : ` aria-label="${escapeHtml(item.label)}"`}>
+            ${icon ? `<span class="contact-link-icon-wrap">${icon}</span>` : ''}
+            ${showLabels ? `<span class="contact-link-label">${escapeHtml(item.label)}${item.value ? `: ${escapeHtml(item.value)}` : ''}</span>` : ''}
+          </a>
+        `;
+        }
+        return `
+        <span class="share-link contact-link contact-link-${item.kind}">
+          ${icon ? `<span class="contact-link-icon-wrap">${icon}</span>` : ''}
+          ${showLabels ? `<span class="contact-link-label">${escapeHtml(item.label)}${item.value ? `: ${escapeHtml(item.value)}` : ''}</span>` : `<span class="contact-link-label">${escapeHtml(item.value ?? item.label)}</span>`}
+        </span>
+      `;
+    })
+        .join('');
+    return `<div class="integration-links contact-links contact-links-${variant}">${content}</div>`;
+}
+const handler = {
+    getTrigger: () => 'contact-links',
+    render: (config, { site, source }) => {
+        const title = typeof config.title === 'string' ? config.title : '';
+        const description = typeof config.description === 'string' ? config.description : '';
+        const variant = typeof config.variant === 'string' ? config.variant : 'inline';
+        const showIcons = typeof config.showIcons === 'boolean' ? config.showIcons : site.integrations.contactLinks.showIcons;
+        const showLabels = typeof config.showLabels === 'boolean' ? config.showLabels : site.integrations.contactLinks.showLabels;
+        const items = buildContactLinkItems(site.integrations.contactLinks);
+        return `
+      <section class="card integration integration-contact-links"${sectionStyleFromConfig(config, source.routePath)}>
+        ${title ? `<h2>${escapeHtml(title)}</h2>` : ''}
+        ${description ? `<p>${escapeHtml(description)}</p>` : ''}
+        ${items.length ? renderContactLinksMarkup(items, { variant, showIcons, showLabels }) : '<p class="empty-state">No contact links configured.</p>'}
+      </section>
+    `;
+    }
+};
+export default handler;

package/dist/integrations/index.js

@@ -0,0 +1,18 @@
+import contactForm from './contact-form.js';
+import shareableLinks from './shareable-links.js';
+import socialsLinks from './socials-links.js';
+import companyInfo from './company-info.js';
+import contactLinks from './contact-links.js';
+import bookingCalendar from './booking-calendar.js';
+import maps from './maps.js';
+import video from './video.js';
+export const integrationHandlers = new Map([
+    [contactForm.getTrigger(), contactForm],
+    [shareableLinks.getTrigger(), shareableLinks],
+    [socialsLinks.getTrigger(), socialsLinks],
+    [companyInfo.getTrigger(), companyInfo],
+    [contactLinks.getTrigger(), contactLinks],
+    [bookingCalendar.getTrigger(), bookingCalendar],
+    [maps.getTrigger(), maps],
+    [video.getTrigger(), video]
+]);

package/dist/integrations/maps.js

@@ -0,0 +1,23 @@
+import { escapeHtml } from '../utils.js';
+import { sectionStyleFromConfig } from '../rendering/shared.js';
+const handler = {
+    getTrigger: () => 'maps',
+    render: (config, { site, source }) => {
+        const title = typeof config.title === 'string' ? config.title : '';
+        const description = typeof config.description === 'string' ? config.description : '';
+        const integrationConfig = site.integrations.maps;
+        if (!integrationConfig.embedUrl) {
+            throw new Error('maps block requires integrations.maps.embedUrl to be set in site.config.yaml');
+        }
+        return `
+      <section class="card integration integration-maps"${sectionStyleFromConfig(config, source.routePath)}>
+        ${title ? `<h2>${escapeHtml(title)}</h2>` : ''}
+        ${description ? `<p>${escapeHtml(description)}</p>` : ''}
+        <div class="embed-frame embed-frame--map">
+          <iframe src="${escapeHtml(integrationConfig.embedUrl)}" title="${escapeHtml(title || 'Map')}" loading="lazy" referrerpolicy="no-referrer-when-downgrade" allowfullscreen></iframe>
+        </div>
+      </section>
+    `;
+    }
+};
+export default handler;

package/dist/integrations/shareable-links.js

@@ -0,0 +1,58 @@
+import { escapeHtml } from '../utils.js';
+import { sectionStyleFromConfig } from '../rendering/shared.js';
+const handler = {
+    getTrigger: () => 'shareable-links',
+    render: (config, { site, source, title, canonicalUrl }) => {
+        if (!site.integrations.shareableLinks.enabled) {
+            return '';
+        }
+        const shortcodeTitle = typeof config.title === 'string' ? config.title : '';
+        const shortcodeDescription = typeof config.description === 'string' ? config.description : '';
+        const encodedTitle = encodeURIComponent(title);
+        const encodedUrl = encodeURIComponent(canonicalUrl);
+        const requestedTargets = Array.isArray(config.targets) && config.targets.length ? config.targets : ['copy', 'x', 'linkedin', 'facebook', 'email'];
+        const targets = requestedTargets
+            .filter((target) => typeof target === 'string')
+            .map((target) => {
+            switch (target) {
+                case 'copy':
+                    return { label: 'Copy link', href: canonicalUrl };
+                case 'x':
+                    return { label: 'Share on X', href: `https://twitter.com/intent/tweet?text=${encodedTitle}&url=${encodedUrl}` };
+                case 'linkedin':
+                    return { label: 'Share on LinkedIn', href: `https://www.linkedin.com/sharing/share-offsite/?url=${encodedUrl}` };
+                case 'facebook':
+                    return { label: 'Share on Facebook', href: `https://www.facebook.com/sharer/sharer.php?u=${encodedUrl}` };
+                case 'email':
+                    return { label: 'Email', href: `mailto:?subject=${encodedTitle}&body=${encodedUrl}` };
+                default:
+                    return null;
+            }
+        })
+            .filter((target) => Boolean(target));
+        const fallbackTargets = [
+            { label: 'Copy link', href: canonicalUrl },
+            { label: 'Share on X', href: `https://twitter.com/intent/tweet?text=${encodedTitle}&url=${encodedUrl}` },
+            { label: 'Share on LinkedIn', href: `https://www.linkedin.com/sharing/share-offsite/?url=${encodedUrl}` },
+            { label: 'Share on Facebook', href: `https://www.facebook.com/sharer/sharer.php?u=${encodedUrl}` },
+            { label: 'Email', href: `mailto:?subject=${encodedTitle}&body=${encodedUrl}` }
+        ];
+        const finalTargets = targets.length ? targets : fallbackTargets;
+        return `
+      <section class="card integration integration-shareable-links"${sectionStyleFromConfig(config, source.routePath)}>
+        ${shortcodeTitle ? `<h2>${escapeHtml(shortcodeTitle)}</h2>` : ''}
+        ${shortcodeDescription ? `<p>${escapeHtml(shortcodeDescription)}</p>` : ''}
+        <div class="integration-links">
+          ${finalTargets
+            .map((target) => `
+                <a class="share-link" href="${escapeHtml(target.href)}" rel="noopener noreferrer" target="${target.href.startsWith('http') ? '_blank' : '_self'}">
+                  ${escapeHtml(target.label)}
+                </a>
+              `)
+            .join('')}
+        </div>
+      </section>
+    `;
+    }
+};
+export default handler;

package/dist/integrations/socials-links.js

@@ -0,0 +1,198 @@
+import { escapeHtml } from '../utils.js';
+import { isExternalUrl, sectionStyleFromConfig } from '../rendering/shared.js';
+const SOCIAL_PROVIDER_ORDER = [
+    'twitter',
+    'x',
+    'github',
+    'facebook',
+    'instagram',
+    'linkedin',
+    'youtube',
+    'tiktok',
+    'threads',
+    'mastodon',
+    'bluesky',
+    'website',
+    'email'
+];
+function socialProviderLabel(provider) {
+    switch (provider) {
+        case 'x':
+            return 'X';
+        case 'youtube':
+            return 'YouTube';
+        case 'github':
+            return 'GitHub';
+        case 'linkedin':
+            return 'LinkedIn';
+        case 'mastodon':
+            return 'Mastodon';
+        case 'bluesky':
+            return 'Bluesky';
+        case 'facebook':
+            return 'Facebook';
+        case 'instagram':
+            return 'Instagram';
+        case 'tiktok':
+            return 'TikTok';
+        case 'threads':
+            return 'Threads';
+        case 'website':
+            return 'Website';
+        case 'email':
+            return 'Email';
+        default:
+            return 'Twitter';
+    }
+}
+function normalizeSocialInput(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return '';
+    }
+    if (isExternalUrl(trimmed) || trimmed.startsWith('mailto:')) {
+        return trimmed;
+    }
+    return trimmed.replace(/^@+/, '');
+}
+function socialHref(provider, value) {
+    const normalized = normalizeSocialInput(value);
+    if (!normalized) {
+        return '';
+    }
+    if (isExternalUrl(normalized) || normalized.startsWith('mailto:')) {
+        return normalized;
+    }
+    const handle = normalized.replace(/^@+/, '');
+    switch (provider) {
+        case 'twitter':
+        case 'x':
+            return `https://x.com/${handle}`;
+        case 'github':
+            return `https://github.com/${handle}`;
+        case 'facebook':
+            return `https://facebook.com/${handle}`;
+        case 'instagram':
+            return `https://instagram.com/${handle}`;
+        case 'linkedin':
+            return `https://www.linkedin.com/in/${handle}`;
+        case 'youtube':
+            return `https://www.youtube.com/@${handle}`;
+        case 'tiktok':
+            return `https://www.tiktok.com/@${handle}`;
+        case 'threads':
+            return `https://www.threads.net/@${handle}`;
+        case 'mastodon':
+            if (handle.includes('@')) {
+                const [user, instance] = handle.split('@').filter(Boolean);
+                if (user && instance) {
+                    return `https://${instance}/@${user}`;
+                }
+            }
+            return `https://mastodon.social/@${handle}`;
+        case 'bluesky':
+            return `https://bsky.app/profile/${handle}`;
+        case 'website':
+            return `https://${handle}`;
+        case 'email':
+            return `mailto:${handle}`;
+        default:
+            return normalized;
+    }
+}
+function socialIconSlug(provider) {
+    switch (provider) {
+        case 'twitter':
+            return 'twitter';
+        case 'x':
+            return 'x';
+        case 'github':
+            return 'github';
+        case 'facebook':
+            return 'facebook';
+        case 'instagram':
+            return 'instagram';
+        case 'linkedin':
+            return 'linkedin';
+        case 'youtube':
+            return 'youtube';
+        case 'tiktok':
+            return 'tiktok';
+        case 'threads':
+            return 'threads';
+        case 'mastodon':
+            return 'mastodon';
+        case 'bluesky':
+            return 'bluesky';
+        default:
+            return null;
+    }
+}
+function socialIconMarkup(provider) {
+    const slug = socialIconSlug(provider);
+    if (slug) {
+        const src = `https://cdn.simpleicons.org/${slug}?viewbox=auto&size=20`;
+        return `<img class="social-icon" src="${escapeHtml(src)}" alt="" aria-hidden="true" loading="lazy" decoding="async" />`;
+    }
+    switch (provider) {
+        case 'website':
+            return `<svg class="social-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M12 2a10 10 0 1 0 0 20 10 10 0 0 0 0-20Zm7.9 9h-3.17a15.7 15.7 0 0 0-1.16-5.2A8.02 8.02 0 0 1 19.9 11Zm-1.8 2a8.03 8.03 0 0 1-4.33 4.2c.44-1.3.73-2.75.84-4.2h3.5ZM12 20c-.82 0-2.22-2.05-2.8-6h5.6c-.58 3.95-1.98 6-2.8 6Zm-2.8-8c.11-1.45.4-2.9.84-4.2A8.03 8.03 0 0 0 5.7 12h3.5ZM12 4c.82 0 2.22 2.05 2.8 6H9.2c.58-3.95 1.98-6 2.8-6Zm-3.77 1.8A15.7 15.7 0 0 0 7.07 11H3.9a8.02 8.02 0 0 1 4.33-5.2ZM3.9 13h3.17a15.7 15.7 0 0 0 1.16 5.2A8.02 8.02 0 0 1 3.9 13Zm12.77 5.2c.44-1.3.73-2.75.84-4.2h3.17a8.02 8.02 0 0 1-4.01 4.2Z"/></svg>`;
+        case 'email':
+            return `<svg class="social-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path fill="currentColor" d="M20 4H4a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V6a2 2 0 0 0-2-2Zm0 4.236-8 5-8-5V6l8 5 8-5v2.236Z"/></svg>`;
+        default:
+            return '';
+    }
+}
+function socialEntriesFromConfig(socials, providers) {
+    const requestedProviders = providers?.length
+        ? providers.map((provider) => provider.trim().toLowerCase()).filter(Boolean)
+        : SOCIAL_PROVIDER_ORDER;
+    const providerSet = new Set(requestedProviders);
+    const seenHrefs = new Set();
+    return SOCIAL_PROVIDER_ORDER.filter((provider) => providerSet.has(provider)).flatMap((provider) => {
+        const value = provider === 'twitter' || provider === 'x'
+            ? socials.twitter ?? socials.x
+            : socials[provider];
+        if (!value || !value.trim()) {
+            return [];
+        }
+        const href = socialHref(provider, value);
+        if (!href || seenHrefs.has(href)) {
+            return [];
+        }
+        seenHrefs.add(href);
+        return [{ provider, label: socialProviderLabel(provider), href }];
+    });
+}
+const handler = {
+    getTrigger: () => 'socials-links',
+    render: (config, { site, source }) => {
+        const shortcodeTitle = typeof config.title === 'string' ? config.title : '';
+        const shortcodeDescription = typeof config.description === 'string' ? config.description : '';
+        const providers = Array.isArray(config.providers)
+            ? config.providers.filter((provider) => typeof provider === 'string')
+            : undefined;
+        const links = socialEntriesFromConfig(site.socials, providers);
+        const showLabels = typeof config.showLabels === 'boolean' ? config.showLabels : true;
+        return `
+      <section class="card integration integration-socials-links"${sectionStyleFromConfig(config, source.routePath)}>
+        ${shortcodeTitle ? `<h2>${escapeHtml(shortcodeTitle)}</h2>` : ''}
+        ${shortcodeDescription ? `<p>${escapeHtml(shortcodeDescription)}</p>` : ''}
+        <div class="integration-links">
+          ${links
+            .map((link) => {
+            const icon = socialIconMarkup(link.provider);
+            return `
+                <a class="share-link social-link" href="${escapeHtml(link.href)}" rel="noopener noreferrer" target="_blank"${showLabels ? '' : ` aria-label="${escapeHtml(link.label)}"`}>
+                  ${icon ? `<span class="social-link-icon">${icon}</span>` : ''}
+                  ${showLabels ? `<span class="social-link-label">${escapeHtml(link.label)}</span>` : ''}
+                </a>
+              `;
+        })
+            .join('')}
+        </div>
+      </section>
+    `;
+    }
+};
+export default handler;

package/dist/integrations/video.js

@@ -0,0 +1,74 @@
+import { escapeHtml } from '../utils.js';
+import { isExternalUrl, sectionStyleFromConfig } from '../rendering/shared.js';
+function buildVideoEmbedUrl(provider, value) {
+    const raw = value?.trim() ?? '';
+    if (!raw) {
+        return '';
+    }
+    if (isExternalUrl(raw) && /\/embed\//i.test(raw)) {
+        return raw;
+    }
+    const normalizedProvider = (provider ?? 'youtube').trim().toLowerCase();
+    const trimmed = raw.replace(/^https?:\/\//i, '');
+    if (isExternalUrl(raw)) {
+        if (/\/embed\//i.test(raw)) {
+            return raw;
+        }
+        const parsed = new URL(raw);
+        const pathParts = parsed.pathname.split('/').filter(Boolean);
+        const lastPart = pathParts[pathParts.length - 1] ?? '';
+        if (normalizedProvider === 'youtube' || normalizedProvider === 'x') {
+            const videoId = parsed.searchParams.get('v') ??
+                parsed.searchParams.get('video_id') ??
+                lastPart.replace(/^@/, '');
+            return videoId ? `https://www.youtube.com/embed/${videoId}` : raw;
+        }
+        if (normalizedProvider === 'vimeo') {
+            const id = pathParts.find((part) => /^\d+$/.test(part)) ?? lastPart;
+            return id ? `https://player.vimeo.com/video/${id}` : raw;
+        }
+        if (normalizedProvider === 'loom') {
+            const slug = lastPart || parsed.pathname.replace(/^\//, '');
+            return slug ? `https://www.loom.com/embed/${slug}` : raw;
+        }
+        return raw;
+    }
+    const clean = trimmed.replace(/^@+/, '');
+    switch (normalizedProvider) {
+        case 'youtube':
+            return `https://www.youtube.com/embed/${clean}`;
+        case 'vimeo':
+            return `https://player.vimeo.com/video/${clean}`;
+        case 'loom':
+            return `https://www.loom.com/embed/${clean}`;
+        default:
+            return clean;
+    }
+}
+const handler = {
+    getTrigger: () => 'video',
+    render: (config, { source }) => {
+        const shortcodeTitle = typeof config.title === 'string' ? config.title : '';
+        const shortcodeDescription = typeof config.description === 'string' ? config.description : '';
+        const videoProvider = typeof config.provider === 'string' ? config.provider : 'youtube';
+        const videoUrl = typeof config.url === 'string'
+            ? config.url
+            : typeof config.embedUrl === 'string'
+                ? config.embedUrl
+                : '';
+        const embedUrl = buildVideoEmbedUrl(videoProvider, videoUrl);
+        if (!embedUrl) {
+            throw new Error('video block requires provider and url parameters in the shortcode body');
+        }
+        return `
+      <section class="card integration integration-video"${sectionStyleFromConfig(config, source.routePath)}>
+        ${shortcodeTitle ? `<h2>${escapeHtml(shortcodeTitle)}</h2>` : ''}
+        ${shortcodeDescription ? `<p>${escapeHtml(shortcodeDescription)}</p>` : ''}
+        <div class="embed-frame">
+          <iframe src="${escapeHtml(embedUrl)}" title="${escapeHtml(shortcodeTitle || 'Video')}" loading="lazy" referrerpolicy="no-referrer-when-downgrade" allowfullscreen></iframe>
+        </div>
+      </section>
+    `;
+    }
+};
+export default handler;

package/dist/{linkEmbedding.js → renderer/aioHelper.js}

@@ -1,4 +1,4 @@
-import { escapeHtml } from './utils.js';
+import { escapeHtml } from '../utils.js';
 function discoveryLinkMarkup(href, label, className = 'nav-link discovery-link') {
     return `<a class="${className}" href="${escapeHtml(href)}">${escapeHtml(label)}</a>`;
 }

package/dist/renderer/footerHtmlBuilder.js

@@ -0,0 +1,11 @@
+import { escapeHtml } from '../utils.js';
+export function buildFooterHtml(params) {
+    const { siteDescription, poweredBy, footerHtml, discoveryFooterNav } = params;
+    return `
+    <footer class="site-footer">
+      <div>${escapeHtml(siteDescription)}</div>
+      <nav class="site-footer-nav" aria-label="Footer navigation">${poweredBy}${footerHtml}</nav>
+      ${discoveryFooterNav}
+    </footer>
+  `;
+}

package/dist/renderer/headerHtmlBuilder.js

@@ -0,0 +1,20 @@
+import { escapeHtml } from '../utils.js';
+export function buildHeaderHtml(params) {
+    const { siteName, homeHref, navigationHtml, discoveryHeaderNav, logoUrl } = params;
+    return `
+    <header class="site-header">
+      <a class="site-brand" href="${escapeHtml(homeHref)}">
+        ${logoUrl ? `<img class="site-logo" src="${escapeHtml(logoUrl)}" alt="" aria-hidden="true" />` : ''}
+        <span>${escapeHtml(siteName)}</span>
+      </a>
+      <nav class="site-nav" aria-label="Main navigation">${navigationHtml}</nav>
+      ${discoveryHeaderNav}
+    </header>
+  `;
+}
+export function renderNavList(items) {
+    if (!items.length) {
+        return '';
+    }
+    return items.map((item) => `<a class="nav-link" href="${escapeHtml(item.url)}">${escapeHtml(item.title)}</a>`).join('');
+}