yaxa-svelte 1.0.0

package/dist/site/manifest.js

@@ -0,0 +1,32 @@
+import { DEFAULT_SITE_CONFIG } from './config';
+export function createManifestHandler(optionsOrConfig) {
+    const config = !optionsOrConfig
+        ? DEFAULT_SITE_CONFIG
+        : 'name' in optionsOrConfig
+            ? optionsOrConfig
+            : optionsOrConfig.config || DEFAULT_SITE_CONFIG;
+    return async () => {
+        const manifest = {
+            name: config.title || config.name,
+            short_name: config.name,
+            description: config.description,
+            start_url: '/',
+            display: 'standalone',
+            background_color: config.theme?.neutralColor || '#121212',
+            theme_color: config.theme?.primaryColor || '#ff3e00',
+            icons: [
+                {
+                    src: '/favicon.svg',
+                    sizes: 'any',
+                    type: 'image/svg+xml'
+                }
+            ]
+        };
+        return new Response(JSON.stringify(manifest, null, 2), {
+            headers: {
+                'Content-Type': 'application/manifest+json; charset=utf-8',
+                'Cache-Control': 'public, max-age=86400'
+            }
+        });
+    };
+}

package/dist/site/og.d.ts

@@ -0,0 +1,14 @@
+import type { RequestHandler } from '@sveltejs/kit';
+import type { SiteConfig } from './config';
+export interface OgImageOptions {
+    config?: SiteConfig;
+}
+export declare function generateOgSvg(params: {
+    title: string;
+    description?: string;
+    siteName?: string;
+    badge?: string;
+    theme?: 'dark' | 'light';
+    url?: string;
+}): string;
+export declare function createOgImageHandler(options?: OgImageOptions): RequestHandler;

package/dist/site/og.js

@@ -0,0 +1,116 @@
+export function generateOgSvg(params) {
+    const isDark = params.theme !== 'light';
+    const bgGradientStart = isDark ? '#121212' : '#fafafa';
+    const bgGradientEnd = isDark ? '#1c1917' : '#f5f5f4';
+    const cardBg = isDark ? 'rgba(24, 24, 27, 0.85)' : 'rgba(255, 255, 255, 0.9)';
+    const cardBorder = isDark ? 'rgba(63, 63, 70, 0.5)' : 'rgba(228, 228, 231, 0.9)';
+    const titleColor = isDark ? '#fafafa' : '#09090b';
+    const descColor = isDark ? '#a1a1aa' : '#52525b';
+    const svelteFlame1 = '#ff3e00';
+    const svelteFlame2 = '#ea580c';
+    const metaColor = isDark ? '#71717a' : '#71717a';
+    // Escape XML characters
+    const escapeXml = (unsafe) => unsafe
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+    const safeTitle = escapeXml(params.title || 'Welcome');
+    const safeDesc = escapeXml(params.description || 'Fast, beautiful, accessible web applications.');
+    const safeSiteName = escapeXml(params.siteName || 'Yaxa');
+    const safeBadge = params.badge ? escapeXml(params.badge) : null;
+    const safeUrl = escapeXml(params.url ? params.url.replace(/^https?:\/\//, '') : 'yaxa.dev');
+    return `<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="${bgGradientStart}"/>
+      <stop offset="100%" stop-color="${bgGradientEnd}"/>
+    </linearGradient>
+    <linearGradient id="brandGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="${svelteFlame1}"/>
+      <stop offset="100%" stop-color="${svelteFlame2}"/>
+    </linearGradient>
+    <linearGradient id="glowGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="${svelteFlame1}" stop-opacity="0.25"/>
+      <stop offset="100%" stop-color="${svelteFlame2}" stop-opacity="0.08"/>
+    </linearGradient>
+    <filter id="blurFilter" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="80"/>
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="630" fill="url(#bgGrad)"/>
+
+  <!-- Glowing Orbs -->
+  <circle cx="150" cy="120" r="280" fill="url(#glowGrad)" filter="url(#blurFilter)"/>
+  <circle cx="1050" cy="500" r="300" fill="url(#glowGrad)" filter="url(#blurFilter)"/>
+
+  <!-- Card Border and Container -->
+  <rect x="60" y="60" width="1080" height="510" rx="24" fill="${cardBg}" stroke="${cardBorder}" stroke-width="2"/>
+
+  <!-- Top Bar: Logo & Badge -->
+  <g transform="translate(120, 130)">
+    <!-- Yaxa Svelte-Style Dual-Tone X Ribbon Icon -->
+    <g transform="translate(0, -2) scale(0.44)">
+      <!-- Outer Flame Track -->
+      <path d="M24 24 L76 76" stroke="url(#brandGrad)" stroke-width="22" stroke-linecap="round"/>
+      <path d="M76 24 L56 44 M44 56 L24 76" stroke="url(#brandGrad)" stroke-width="22" stroke-linecap="round"/>
+      <!-- Inner White Core Track -->
+      <path d="M24 24 L76 76" stroke="#ffffff" stroke-width="8" stroke-linecap="round"/>
+      <path d="M76 24 L58 42 M42 58 L24 76" stroke="#ffffff" stroke-width="8" stroke-linecap="round"/>
+    </g>
+    
+    <!-- Site Name -->
+    <text x="54" y="27" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="24" font-weight="700" fill="${titleColor}">${safeSiteName}</text>
+
+    <!-- Badge -->
+    ${safeBadge
+        ? `
+    <rect x="760" y="2" width="${safeBadge.length * 10 + 36}" height="32" rx="16" fill="rgba(255, 62, 0, 0.15)" stroke="rgba(255, 62, 0, 0.4)" stroke-width="1"/>
+    <text x="${760 + (safeBadge.length * 10 + 36) / 2}" y="23" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="600" fill="#ff6a00" text-anchor="middle">${safeBadge}</text>
+    `
+        : ''}
+  </g>
+
+  <!-- Middle: Title & Description -->
+  <g transform="translate(120, 250)">
+    <text x="0" y="40" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="52" font-weight="800" fill="${titleColor}" letter-spacing="-0.03em">${safeTitle}</text>
+    <text x="0" y="110" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="24" font-weight="400" fill="${descColor}" width="840">${safeDesc}</text>
+  </g>
+
+  <!-- Bottom: Domain and Decorative Accent Line -->
+  <g transform="translate(120, 480)">
+    <line x1="0" y1="0" x2="840" y2="0" stroke="${cardBorder}" stroke-width="1"/>
+    <circle cx="6" cy="30" r="4" fill="${svelteFlame1}"/>
+    <text x="20" y="35" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="18" font-weight="500" fill="${metaColor}">${safeUrl}</text>
+  </g>
+</svg>`;
+}
+export function createOgImageHandler(options) {
+    return async ({ url }) => {
+        const title = url.searchParams.get('title') || options?.config?.title || 'Yaxa';
+        const description = url.searchParams.get('description') ||
+            options?.config?.description ||
+            'Fast, beautiful, accessible UI components and SEO tools for SvelteKit.';
+        const badge = url.searchParams.get('badge') || undefined;
+        const theme = url.searchParams.get('theme') || 'dark';
+        const siteName = url.searchParams.get('site') || options?.config?.name || 'Yaxa';
+        const siteUrl = options?.config?.url || url.origin;
+        const svg = generateOgSvg({
+            title,
+            description,
+            siteName,
+            badge,
+            theme,
+            url: siteUrl
+        });
+        return new Response(svg, {
+            headers: {
+                'Content-Type': 'image/svg+xml; charset=utf-8',
+                'Cache-Control': 'public, max-age=86400, s-maxage=86400'
+            }
+        });
+    };
+}

package/dist/site/robots.d.ts

@@ -0,0 +1,10 @@
+import type { RequestHandler } from '@sveltejs/kit';
+import type { SiteConfig } from './config';
+export interface RobotsOptions {
+    config: SiteConfig;
+    /**
+     * Override environment detection. If true, allows indexing. If false, disallows indexing.
+     */
+    isProduction?: boolean;
+}
+export declare function createRobotsHandler(optionsOrConfig: SiteConfig | RobotsOptions): RequestHandler;

package/dist/site/robots.js

@@ -0,0 +1,54 @@
+export function createRobotsHandler(optionsOrConfig) {
+    const options = 'config' in optionsOrConfig ? optionsOrConfig : { config: optionsOrConfig };
+    const { config } = options;
+    return async ({ url }) => {
+        try {
+            const isProdEnv = typeof process !== 'undefined' && process.env?.NODE_ENV === 'production';
+            const isProd = options.isProduction ??
+                (isProdEnv &&
+                    !url.hostname.includes('localhost') &&
+                    !url.hostname.includes('vercel.app') &&
+                    !url.hostname.includes('preview') &&
+                    !url.hostname.includes('staging'));
+            const baseUrl = config?.url || url?.origin || 'https://yaxa.vercel.app';
+            let body;
+            if (!isProd && !options.isProduction) {
+                // Non-production or preview deployment: protect against indexing
+                body = `# Non-production environment: indexing disabled\nUser-agent: *\nDisallow: /\n`;
+            }
+            else if (config?.robots?.rules && config.robots.rules.length > 0) {
+                // Custom defined rules
+                body = config.robots.rules
+                    .map((rule) => {
+                    let ruleText = `User-agent: ${rule.userAgent}\n`;
+                    if (rule.allow) {
+                        ruleText += rule.allow.map((path) => `Allow: ${path}\n`).join('');
+                    }
+                    if (rule.disallow) {
+                        ruleText += rule.disallow.map((path) => `Disallow: ${path}\n`).join('');
+                    }
+                    return ruleText;
+                })
+                    .join('\n');
+            }
+            else {
+                // Default production allow
+                body = `User-agent: *\nAllow: /\n`;
+            }
+            // Always append sitemap reference
+            body += `\nSitemap: ${baseUrl}/sitemap.xml\n`;
+            return new Response(body, {
+                headers: {
+                    'Content-Type': 'text/plain; charset=utf-8',
+                    'Cache-Control': 'public, max-age=86400'
+                }
+            });
+        }
+        catch (err) {
+            console.error('robots.txt handler error:', err);
+            return new Response(`User-agent: *\nDisallow: /\n`, {
+                headers: { 'Content-Type': 'text/plain; charset=utf-8' }
+            });
+        }
+    };
+}

package/dist/site/schema.d.ts

@@ -0,0 +1,67 @@
+import type { SiteConfig } from './config';
+export type SchemaType = 'WebSite' | 'Organization' | 'WebPage' | 'Article' | 'Product' | 'BreadcrumbList' | 'FAQPage';
+export interface BreadcrumbItem {
+    name: string;
+    url: string;
+}
+export interface ArticleSchemaData {
+    title: string;
+    description: string;
+    url: string;
+    datePublished: string;
+    dateModified?: string;
+    image?: string;
+    authorName?: string;
+}
+export declare function generateWebSiteSchema(config: SiteConfig): {
+    author?: {
+        '@type': string;
+        name: string;
+        url: string | undefined;
+    } | undefined;
+    '@context': string;
+    '@type': string;
+    name: string;
+    url: string;
+    description: string;
+};
+export declare function generateOrganizationSchema(config: SiteConfig): {
+    '@context': string;
+    '@type': string;
+    name: string;
+    url: string;
+    logo: string | undefined;
+    sameAs: (string | undefined)[];
+};
+export declare function generateArticleSchema(config: SiteConfig, article: ArticleSchemaData): {
+    '@context': string;
+    '@type': string;
+    headline: string;
+    description: string;
+    url: string;
+    datePublished: string;
+    dateModified: string;
+    image: string | undefined;
+    author: {
+        '@type': string;
+        name: string;
+    };
+    publisher: {
+        '@type': string;
+        name: string;
+        logo: {
+            '@type': string;
+            url: string;
+        } | undefined;
+    };
+};
+export declare function generateBreadcrumbSchema(config: SiteConfig, items: BreadcrumbItem[]): {
+    '@context': string;
+    '@type': string;
+    itemListElement: {
+        '@type': string;
+        position: number;
+        name: string;
+        item: string;
+    }[];
+};

package/dist/site/schema.js

@@ -0,0 +1,67 @@
+export function generateWebSiteSchema(config) {
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'WebSite',
+        name: config.name,
+        url: config.url,
+        description: config.description,
+        ...(config.author
+            ? {
+                author: {
+                    '@type': 'Person',
+                    name: config.author.name,
+                    url: config.author.url
+                }
+            }
+            : {})
+    };
+}
+export function generateOrganizationSchema(config) {
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'Organization',
+        name: config.name,
+        url: config.url,
+        logo: config.logo ? `${config.url}${config.logo}` : undefined,
+        sameAs: [
+            config.socials?.github,
+            config.socials?.twitter,
+            config.socials?.discord,
+            config.socials?.bluesky,
+            config.socials?.youtube
+        ].filter(Boolean)
+    };
+}
+export function generateArticleSchema(config, article) {
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'Article',
+        headline: article.title,
+        description: article.description,
+        url: article.url,
+        datePublished: article.datePublished,
+        dateModified: article.dateModified || article.datePublished,
+        image: article.image,
+        author: {
+            '@type': 'Person',
+            name: article.authorName || config.author?.name || config.name
+        },
+        publisher: {
+            '@type': 'Organization',
+            name: config.name,
+            logo: config.logo ? { '@type': 'ImageObject', url: `${config.url}${config.logo}` } : undefined
+        }
+    };
+}
+export function generateBreadcrumbSchema(config, items) {
+    return {
+        '@context': 'https://schema.org',
+        '@type': 'BreadcrumbList',
+        itemListElement: items.map((item, index) => ({
+            '@type': 'ListItem',
+            position: index + 1,
+            name: item.name,
+            item: item.url.startsWith('http') ? item.url : `${config.url}${item.url}`
+        }))
+    };
+}

package/dist/site/seo-helpers.d.ts

@@ -0,0 +1,36 @@
+export interface PageSeoConfig {
+    title: string;
+    description?: string;
+    canonical?: string;
+    badge?: string;
+    ogImage?: string | {
+        title?: string;
+        description?: string;
+        badge?: string;
+        theme?: 'dark' | 'light';
+    };
+    twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player';
+    keywords?: string[];
+    noindex?: boolean;
+    nofollow?: boolean;
+    schema?: Record<string, unknown> | Record<string, unknown>[];
+}
+/**
+ * Type-safe helper for SvelteKit load() functions to define page-level SEO.
+ * When returned inside { seo: definePageSeo(...) }, YaxaApp automatically
+ * extracts and binds all meta tags, OpenGraph cards, Twitter cards, and Schema.org data.
+ *
+ * Example:
+ * ```ts
+ * export const load = () => {
+ *   return {
+ *     seo: definePageSeo({
+ *       title: 'DataTable Component',
+ *       description: 'Interactive sortable table for SvelteKit',
+ *       badge: 'Components'
+ *     })
+ *   };
+ * };
+ * ```
+ */
+export declare function definePageSeo(seo: PageSeoConfig): PageSeoConfig;

package/dist/site/seo-helpers.js

@@ -0,0 +1,21 @@
+/**
+ * Type-safe helper for SvelteKit load() functions to define page-level SEO.
+ * When returned inside { seo: definePageSeo(...) }, YaxaApp automatically
+ * extracts and binds all meta tags, OpenGraph cards, Twitter cards, and Schema.org data.
+ *
+ * Example:
+ * ```ts
+ * export const load = () => {
+ *   return {
+ *     seo: definePageSeo({
+ *       title: 'DataTable Component',
+ *       description: 'Interactive sortable table for SvelteKit',
+ *       badge: 'Components'
+ *     })
+ *   };
+ * };
+ * ```
+ */
+export function definePageSeo(seo) {
+    return seo;
+}

package/dist/site/sitemap-xsl.d.ts

@@ -0,0 +1,6 @@
+import type { RequestHandler } from '@sveltejs/kit';
+import type { SiteConfig } from './config';
+export declare function generateSitemapXsl(config?: SiteConfig): string;
+export declare function createSitemapXslHandler(options?: {
+    config?: SiteConfig;
+}): RequestHandler;

package/dist/site/sitemap-xsl.js

@@ -0,0 +1,164 @@
+export function generateSitemapXsl(config) {
+    const siteName = config?.name || 'Yaxa';
+    const primaryColor = config?.theme?.primaryColor || '#ff3e00';
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="2.0" 
+  xmlns:html="http://www.w3.org/TR/REC-html40"
+  xmlns:sitemap="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+  <xsl:output method="html" version="1.0" encoding="UTF-8" indent="yes"/>
+  <xsl:template match="/">
+    <html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+      <head>
+        <title>XML Sitemap · ${siteName}</title>
+        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <style type="text/css">
+          :root {
+            --primary: ${primaryColor};
+          }
+          body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+            background-color: #121212;
+            color: #e4e4e7;
+            margin: 0;
+            padding: 32px 16px;
+          }
+          .container {
+            max-width: 1024px;
+            margin: 0 auto;
+            background-color: #18181b;
+            border: 1px solid #27272a;
+            border-radius: 16px;
+            padding: 32px;
+            box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.5);
+          }
+          .header {
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
+            border-bottom: 1px solid #27272a;
+            padding-bottom: 24px;
+            margin-bottom: 24px;
+          }
+          .logo-area {
+            display: flex;
+            align-items: center;
+            gap: 12px;
+          }
+          .badge {
+            background-color: rgba(255, 62, 0, 0.15);
+            color: var(--primary);
+            border: 1px solid rgba(255, 62, 0, 0.3);
+            border-radius: 9999px;
+            padding: 4px 12px;
+            font-size: 12px;
+            font-weight: 600;
+          }
+          h1 {
+            font-size: 24px;
+            font-weight: 800;
+            margin: 0;
+            color: #ffffff;
+          }
+          p {
+            color: #a1a1aa;
+            font-size: 14px;
+            margin: 8px 0 0 0;
+          }
+          table {
+            width: 100%;
+            border-collapse: collapse;
+            font-size: 13px;
+          }
+          th {
+            background-color: #27272a;
+            color: #d4d4d8;
+            font-weight: 600;
+            text-align: left;
+            padding: 12px 16px;
+            border-bottom: 1px solid #3f3f46;
+          }
+          th:first-child { border-top-left-radius: 8px; }
+          th:last-child { border-top-right-radius: 8px; }
+          td {
+            padding: 12px 16px;
+            border-bottom: 1px solid #27272a;
+          }
+          tr:hover td {
+            background-color: #27272a;
+          }
+          a {
+            color: var(--primary);
+            text-decoration: none;
+            font-weight: 500;
+          }
+          a:hover {
+            text-decoration: underline;
+          }
+          .footer {
+            margin-top: 24px;
+            font-size: 12px;
+            color: #71717a;
+            text-align: center;
+          }
+        </style>
+      </head>
+      <body>
+        <div class="container">
+          <div class="header">
+            <div>
+              <div class="logo-area">
+                <h1>${siteName} Sitemap</h1>
+                <span class="badge"><xsl:value-of select="count(sitemap:urlset/sitemap:url)"/> URLs</span>
+              </div>
+              <p>Generated dynamically by Yaxa for SvelteKit 2.7+ and search crawlers.</p>
+            </div>
+          </div>
+          <table>
+            <thead>
+              <tr>
+                <th style="width: 55%;">URL Location</th>
+                <th style="width: 15%;">Changefreq</th>
+                <th style="width: 15%;">Priority</th>
+                <th style="width: 15%;">Last Modified</th>
+              </tr>
+            </thead>
+            <tbody>
+              <xsl:for-each select="sitemap:urlset/sitemap:url">
+                <tr>
+                  <td>
+                    <a target="_blank">
+                      <xsl:attribute name="href">
+                        <xsl:value-of select="sitemap:loc"/>
+                      </xsl:attribute>
+                      <xsl:value-of select="sitemap:loc"/>
+                    </a>
+                  </td>
+                  <td><xsl:value-of select="sitemap:changefreq"/></td>
+                  <td><xsl:value-of select="sitemap:priority"/></td>
+                  <td><xsl:value-of select="sitemap:lastmod"/></td>
+                </tr>
+              </xsl:for-each>
+            </tbody>
+          </table>
+          <div class="footer">
+            Powered by Yaxa · SvelteKit 2.7+ · Svelte 5
+          </div>
+        </div>
+      </body>
+    </html>
+  </xsl:template>
+</xsl:stylesheet>`;
+}
+export function createSitemapXslHandler(options) {
+    return async () => {
+        const xsl = generateSitemapXsl(options?.config);
+        return new Response(xsl, {
+            headers: {
+                'Content-Type': 'application/xml; charset=utf-8',
+                'Cache-Control': 'public, max-age=86400, s-maxage=86400'
+            }
+        });
+    };
+}

package/dist/site/sitemap.d.ts

@@ -0,0 +1,20 @@
+import type { RequestHandler } from '@sveltejs/kit';
+import type { SiteConfig } from './config';
+export interface SitemapRoute {
+    loc: string;
+    lastmod?: string;
+    changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+}
+export interface SitemapOptions {
+    config: SiteConfig;
+    /**
+     * Additional static or dynamic routes to include (e.g. /blog/[slug], /products/[id])
+     */
+    dynamicRoutes?: () => Promise<SitemapRoute[]> | SitemapRoute[];
+    /**
+     * Default routes to include if not providing dynamic list
+     */
+    staticRoutes?: string[];
+}
+export declare function createSitemapHandler(optionsOrConfig: SiteConfig | SitemapOptions): RequestHandler;