yaxa-svelte 1.0.0

package/dist/composables/useToast.js

@@ -0,0 +1,34 @@
+import { toast } from 'svelte-sonner';
+export function useToast() {
+    return {
+        add: (options) => {
+            if (typeof options === 'string') {
+                return toast(options);
+            }
+            const { title, description, color = 'neutral', duration = 4000, action } = options;
+            const actionObj = action
+                ? {
+                    label: action.label,
+                    onClick: action.onClick
+                }
+                : undefined;
+            switch (color) {
+                case 'success':
+                    return toast.success(title || '', { description, duration, action: actionObj });
+                case 'error':
+                    return toast.error(title || '', { description, duration, action: actionObj });
+                case 'warning':
+                    return toast.warning(title || '', { description, duration, action: actionObj });
+                case 'primary':
+                case 'neutral':
+                default:
+                    return toast.info(title || '', { description, duration, action: actionObj });
+            }
+        },
+        success: (title, description) => toast.success(title, { description }),
+        error: (title, description) => toast.error(title, { description }),
+        warning: (title, description) => toast.warning(title, { description }),
+        info: (title, description) => toast.info(title, { description }),
+        dismiss: (id) => toast.dismiss(id)
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+export { default as Button } from './components/elements/Button.svelte';
+export { default as ButtonGroup } from './components/elements/ButtonGroup.svelte';
+export { default as Badge } from './components/elements/Badge.svelte';
+export { default as Avatar } from './components/elements/Avatar.svelte';
+export { default as AvatarGroup } from './components/elements/AvatarGroup.svelte';
+export { default as Kbd } from './components/elements/Kbd.svelte';
+export { default as Icon } from './components/elements/Icon.svelte';
+export { default as Spinner } from './components/elements/Spinner.svelte';
+export { default as Progress } from './components/elements/Progress.svelte';
+export { default as Skeleton } from './components/elements/Skeleton.svelte';
+export { default as Link } from './components/elements/Link.svelte';
+export { default as Logo } from './components/elements/Logo.svelte';
+export { default as DataTable } from './components/elements/DataTable.svelte';
+export type { Column } from './components/elements/DataTable.svelte';
+export { default as Chip } from './components/elements/Chip.svelte';
+export { default as Meter } from './components/elements/Meter.svelte';
+export { default as Form } from './components/forms/Form.svelte';
+export { default as FormField } from './components/forms/FormField.svelte';
+export { default as Input } from './components/forms/Input.svelte';
+export { default as Textarea } from './components/forms/Textarea.svelte';
+export { default as Checkbox } from './components/forms/Checkbox.svelte';
+export { default as Switch } from './components/forms/Switch.svelte';
+export { default as Select } from './components/forms/Select.svelte';
+export { default as RadioGroup } from './components/forms/RadioGroup.svelte';
+export { default as Slider } from './components/forms/Slider.svelte';
+export { default as ColorPicker } from './components/forms/ColorPicker.svelte';
+export { default as Container } from './components/layout/Container.svelte';
+export { default as Header } from './components/layout/Header.svelte';
+export { default as Footer } from './components/layout/Footer.svelte';
+export { default as Section } from './components/layout/Section.svelte';
+export { default as Card } from './components/layout/Card.svelte';
+export { default as Divider } from './components/layout/Divider.svelte';
+export { default as YaxaApp } from './components/layout/YaxaApp.svelte';
+export { default as Tabs } from './components/navigation/Tabs.svelte';
+export { default as Breadcrumb } from './components/navigation/Breadcrumb.svelte';
+export { default as Pagination } from './components/navigation/Pagination.svelte';
+export { default as CommandPalette } from './components/navigation/CommandPalette.svelte';
+export { default as DropdownMenu } from './components/navigation/DropdownMenu.svelte';
+export { default as Modal } from './components/overlays/Modal.svelte';
+export { default as Slideover } from './components/overlays/Slideover.svelte';
+export { default as Popover } from './components/overlays/Popover.svelte';
+export { default as Tooltip } from './components/overlays/Tooltip.svelte';
+export { default as Alert } from './components/overlays/Alert.svelte';
+export { default as Accordion } from './components/overlays/Accordion.svelte';
+export { default as ContextMenu } from './components/overlays/ContextMenu.svelte';
+export type { ContextMenuItem } from './components/overlays/ContextMenu.svelte';
+export { useClipboard } from './composables/useClipboard.svelte';
+export type { UseClipboardOptions } from './composables/useClipboard.svelte';
+export { useShortcuts } from './composables/useShortcuts.svelte';
+export type { ShortcutItem, ShortcutConfig } from './composables/useShortcuts.svelte';
+export { useColorMode } from './composables/useColorMode.svelte';
+export { useToast } from './composables/useToast';
+export type { ToastOptions, ToastAction } from './composables/useToast';
+export { useMediaQuery } from './composables/useMediaQuery.svelte';
+export { useDebounce } from './composables/useDebounce.svelte';
+export { toast } from 'svelte-sonner';
+export { theme, themeInitScript, ACCENT_PALETTES, NEUTRAL_PALETTES, FONT_PRESETS, RADIUS_PRESETS, FONT_SIZE_PRESETS } from './theme/theme.svelte';
+export type { ThemeMode, AccentName, NeutralName, FontFamily, RadiusPreset, BaseFontSize, AccentOption } from './theme/theme.svelte';
+export { default as Seo } from './components/seo/Seo.svelte';
+export { default as Favicons } from './components/seo/Favicons.svelte';
+export { default as OgImage } from './components/seo/OgImage.svelte';
+export { defineSiteConfig } from './site/config';
+export type { SiteConfig, NavItem, AuthorConfig } from './site/config';
+export { setSiteConfig, getSiteConfig } from './site/context';
+export { createYaxaHook } from './site/hook';
+export type { YaxaHookOptions } from './site/hook';
+export { createRobotsHandler } from './site/robots';
+export type { RobotsOptions } from './site/robots';
+export { createSitemapHandler } from './site/sitemap';
+export type { SitemapRoute, SitemapOptions } from './site/sitemap';
+export { createSitemapXslHandler, generateSitemapXsl } from './site/sitemap-xsl';
+export { createOgImageHandler, generateOgSvg } from './site/og';
+export type { OgImageOptions } from './site/og';
+export { createManifestHandler } from './site/manifest';
+export { generateWebSiteSchema, generateOrganizationSchema, generateArticleSchema, generateBreadcrumbSchema } from './site/schema';
+export type { SchemaType, BreadcrumbItem, ArticleSchemaData } from './site/schema';
+export { definePageSeo } from './site/seo-helpers';
+export type { PageSeoConfig } from './site/seo-helpers';
+export { yaxa } from './vite/index';
+export type { YaxaPluginOptions } from './vite/index';
+export { default as AuthCard } from './components/saas/AuthCard.svelte';
+export { default as UserMenu } from './components/saas/UserMenu.svelte';
+export { default as PricingCard } from './components/saas/PricingCard.svelte';
+export { default as PricingTable } from './components/saas/PricingTable.svelte';
+export { default as SubscriptionCard } from './components/saas/SubscriptionCard.svelte';
+export { useAuth } from './composables/useAuth.svelte';
+export type { UseAuthOptions, SocialProvider } from './composables/useAuth.svelte';
+export { getDb, schemaPg, schemaSqlite } from './server/db/index';
+export type { DbConfig, DbDriver, SaasUser, SaasSubscription, SubscriptionStatus, PricingTier, PricingFeature } from './server/db/index';
+export { createYaxaAuth } from './server/auth/index';
+export type { YaxaAuthConfig, YaxaAuth } from './server/auth/index';
+export { createYaxaAuthHook } from './server/auth/hook';
+export type { YaxaAuthHookOptions } from './server/auth/hook';
+export { getPolarClient, createPolarCheckout, createPolarCustomerPortalSession } from './server/polar/index';
+export type { PolarConfig, CreateCheckoutOptions } from './server/polar/index';
+export { createPolarWebhookHandler } from './server/polar/webhook';
+export type { PolarWebhookOptions } from './server/polar/webhook';
+export { getResendClient, sendMagicLinkEmail, sendWelcomeEmail } from './server/email/index';
+export type { ResendEmailConfig, SendMagicLinkOptions, SendWelcomeEmailOptions } from './server/email/index';
+export { cn, tv } from './utils/cn';
+export type { VariantProps } from './utils/cn';

package/dist/index.js

@@ -0,0 +1,92 @@
+// Yaxa - Nuxt UI v4 Equivalent for SvelteKit 2.7+ & Svelte 5
+// Elements
+export { default as Button } from './components/elements/Button.svelte';
+export { default as ButtonGroup } from './components/elements/ButtonGroup.svelte';
+export { default as Badge } from './components/elements/Badge.svelte';
+export { default as Avatar } from './components/elements/Avatar.svelte';
+export { default as AvatarGroup } from './components/elements/AvatarGroup.svelte';
+export { default as Kbd } from './components/elements/Kbd.svelte';
+export { default as Icon } from './components/elements/Icon.svelte';
+export { default as Spinner } from './components/elements/Spinner.svelte';
+export { default as Progress } from './components/elements/Progress.svelte';
+export { default as Skeleton } from './components/elements/Skeleton.svelte';
+export { default as Link } from './components/elements/Link.svelte';
+export { default as Logo } from './components/elements/Logo.svelte';
+export { default as DataTable } from './components/elements/DataTable.svelte';
+export { default as Chip } from './components/elements/Chip.svelte';
+export { default as Meter } from './components/elements/Meter.svelte';
+// Form Controls
+export { default as Form } from './components/forms/Form.svelte';
+export { default as FormField } from './components/forms/FormField.svelte';
+export { default as Input } from './components/forms/Input.svelte';
+export { default as Textarea } from './components/forms/Textarea.svelte';
+export { default as Checkbox } from './components/forms/Checkbox.svelte';
+export { default as Switch } from './components/forms/Switch.svelte';
+export { default as Select } from './components/forms/Select.svelte';
+export { default as RadioGroup } from './components/forms/RadioGroup.svelte';
+export { default as Slider } from './components/forms/Slider.svelte';
+export { default as ColorPicker } from './components/forms/ColorPicker.svelte';
+// Layout & Shell
+export { default as Container } from './components/layout/Container.svelte';
+export { default as Header } from './components/layout/Header.svelte';
+export { default as Footer } from './components/layout/Footer.svelte';
+export { default as Section } from './components/layout/Section.svelte';
+export { default as Card } from './components/layout/Card.svelte';
+export { default as Divider } from './components/layout/Divider.svelte';
+export { default as YaxaApp } from './components/layout/YaxaApp.svelte';
+// Navigation & Command
+export { default as Tabs } from './components/navigation/Tabs.svelte';
+export { default as Breadcrumb } from './components/navigation/Breadcrumb.svelte';
+export { default as Pagination } from './components/navigation/Pagination.svelte';
+export { default as CommandPalette } from './components/navigation/CommandPalette.svelte';
+export { default as DropdownMenu } from './components/navigation/DropdownMenu.svelte';
+// Overlays & Feedback
+export { default as Modal } from './components/overlays/Modal.svelte';
+export { default as Slideover } from './components/overlays/Slideover.svelte';
+export { default as Popover } from './components/overlays/Popover.svelte';
+export { default as Tooltip } from './components/overlays/Tooltip.svelte';
+export { default as Alert } from './components/overlays/Alert.svelte';
+export { default as Accordion } from './components/overlays/Accordion.svelte';
+export { default as ContextMenu } from './components/overlays/ContextMenu.svelte';
+// Composables & Runes (Nuxt UI v4 Composables Parity)
+export { useClipboard } from './composables/useClipboard.svelte';
+export { useShortcuts } from './composables/useShortcuts.svelte';
+export { useColorMode } from './composables/useColorMode.svelte';
+export { useToast } from './composables/useToast';
+export { useMediaQuery } from './composables/useMediaQuery.svelte';
+export { useDebounce } from './composables/useDebounce.svelte';
+// Feedback & Toast notification helper
+export { toast } from 'svelte-sonner';
+// Theming
+export { theme, themeInitScript, ACCENT_PALETTES, NEUTRAL_PALETTES, FONT_PRESETS, RADIUS_PRESETS, FONT_SIZE_PRESETS } from './theme/theme.svelte';
+// Site Essentials & SEO Suite
+export { default as Seo } from './components/seo/Seo.svelte';
+export { default as Favicons } from './components/seo/Favicons.svelte';
+export { default as OgImage } from './components/seo/OgImage.svelte';
+export { defineSiteConfig } from './site/config';
+export { setSiteConfig, getSiteConfig } from './site/context';
+export { createYaxaHook } from './site/hook';
+export { createRobotsHandler } from './site/robots';
+export { createSitemapHandler } from './site/sitemap';
+export { createSitemapXslHandler, generateSitemapXsl } from './site/sitemap-xsl';
+export { createOgImageHandler, generateOgSvg } from './site/og';
+export { createManifestHandler } from './site/manifest';
+export { generateWebSiteSchema, generateOrganizationSchema, generateArticleSchema, generateBreadcrumbSchema } from './site/schema';
+export { definePageSeo } from './site/seo-helpers';
+export { yaxa } from './vite/index';
+// SaaS Suite: Components, Composables & Integrations
+export { default as AuthCard } from './components/saas/AuthCard.svelte';
+export { default as UserMenu } from './components/saas/UserMenu.svelte';
+export { default as PricingCard } from './components/saas/PricingCard.svelte';
+export { default as PricingTable } from './components/saas/PricingTable.svelte';
+export { default as SubscriptionCard } from './components/saas/SubscriptionCard.svelte';
+export { useAuth } from './composables/useAuth.svelte';
+// SaaS Server & DB Modules
+export { getDb, schemaPg, schemaSqlite } from './server/db/index';
+export { createYaxaAuth } from './server/auth/index';
+export { createYaxaAuthHook } from './server/auth/hook';
+export { getPolarClient, createPolarCheckout, createPolarCustomerPortalSession } from './server/polar/index';
+export { createPolarWebhookHandler } from './server/polar/webhook';
+export { getResendClient, sendMagicLinkEmail, sendWelcomeEmail } from './server/email/index';
+// Utilities
+export { cn, tv } from './utils/cn';

package/dist/server/auth/hook.d.ts

@@ -0,0 +1,14 @@
+import type { Handle } from '@sveltejs/kit';
+import type { YaxaAuth } from './index';
+export interface YaxaAuthHookOptions {
+    auth: YaxaAuth;
+    protectedPaths?: string[];
+    loginPath?: string;
+}
+/**
+ * Creates an all-in-one SvelteKit Server Hook for Better-Auth.
+ * - Automatically routes /api/auth/* to Better-Auth
+ * - Parses and caches session on event.locals
+ * - Enforces path protection for dashboard/app routes
+ */
+export declare function createYaxaAuthHook(options: YaxaAuthHookOptions): Handle;

package/dist/server/auth/hook.js

@@ -0,0 +1,36 @@
+import { redirect } from '@sveltejs/kit';
+/**
+ * Creates an all-in-one SvelteKit Server Hook for Better-Auth.
+ * - Automatically routes /api/auth/* to Better-Auth
+ * - Parses and caches session on event.locals
+ * - Enforces path protection for dashboard/app routes
+ */
+export function createYaxaAuthHook(options) {
+    const { auth, protectedPaths = ['/dashboard', '/app', '/settings'], loginPath = '/login' } = options;
+    return async ({ event, resolve }) => {
+        // 1. Intercept Better-Auth API routes (/api/auth/*)
+        if (event.url.pathname.startsWith('/api/auth')) {
+            return auth.handler(event.request);
+        }
+        // 2. Fetch session from cookies/headers
+        try {
+            const session = await auth.api.getSession({
+                headers: event.request.headers
+            });
+            // Attach to locals
+            event.locals.session = session?.session || null;
+            event.locals.user = session?.user || null;
+        }
+        catch {
+            event.locals.session = null;
+            event.locals.user = null;
+        }
+        // 3. Check protected routes
+        const isProtected = protectedPaths.some((path) => event.url.pathname.startsWith(path));
+        if (isProtected && !event.locals.user) {
+            const returnTo = encodeURIComponent(event.url.pathname + event.url.search);
+            throw redirect(303, `${loginPath}?returnTo=${returnTo}`);
+        }
+        return resolve(event);
+    };
+}

package/dist/server/auth/index.d.ts

@@ -0,0 +1,39 @@
+import { type BetterAuthOptions } from 'better-auth';
+import { type AnyDb } from '../db';
+export interface YaxaAuthConfig {
+    db?: AnyDb;
+    driver?: 'neon' | 'turso' | 'sqlite';
+    secret?: string;
+    baseURL?: string;
+    socialProviders?: {
+        github?: {
+            clientId: string;
+            clientSecret: string;
+        };
+        google?: {
+            clientId: string;
+            clientSecret: string;
+        };
+        discord?: {
+            clientId: string;
+            clientSecret: string;
+        };
+    };
+    emailAndPassword?: {
+        enabled: boolean;
+        requireEmailVerification?: boolean;
+    };
+    magicLink?: {
+        enabled: boolean;
+        sendMagicLink?: (data: {
+            email: string;
+            token: string;
+            url: string;
+        }) => Promise<void>;
+    };
+}
+/**
+ * Creates and initializes a Better-Auth instance pre-configured for Yaxa and Drizzle.
+ */
+export declare function createYaxaAuth(config?: YaxaAuthConfig): import("better-auth").Auth<BetterAuthOptions>;
+export type YaxaAuth = ReturnType<typeof createYaxaAuth>;

package/dist/server/auth/index.js

@@ -0,0 +1,69 @@
+import { betterAuth } from 'better-auth';
+import { drizzleAdapter } from 'better-auth/adapters/drizzle';
+import { schemaPg, schemaSqlite, getDb } from '../db';
+/**
+ * Creates and initializes a Better-Auth instance pre-configured for Yaxa and Drizzle.
+ */
+export function createYaxaAuth(config = {}) {
+    const driver = config.driver ||
+        (typeof process !== 'undefined'
+            ? process.env.DATABASE_DRIVER
+            : undefined) ||
+        'neon';
+    const database = config.db || getDb({ driver });
+    const authOptions = {
+        secret: config.secret ||
+            (typeof process !== 'undefined' ? process.env.BETTER_AUTH_SECRET : undefined) ||
+            'yaxa-default-super-secret-key-change-in-prod-123456789',
+        baseURL: config.baseURL ||
+            (typeof process !== 'undefined'
+                ? process.env.PUBLIC_APP_URL || process.env.BETTER_AUTH_URL
+                : undefined) ||
+            'http://localhost:5173',
+        database: drizzleAdapter(database, {
+            provider: driver === 'neon' ? 'pg' : 'sqlite',
+            schema: driver === 'neon' ? schemaPg : schemaSqlite
+        }),
+        emailAndPassword: {
+            enabled: config.emailAndPassword?.enabled ?? true,
+            requireEmailVerification: config.emailAndPassword?.requireEmailVerification ?? false
+        },
+        socialProviders: {
+            ...(config.socialProviders?.github
+                ? {
+                    github: {
+                        clientId: config.socialProviders.github.clientId,
+                        clientSecret: config.socialProviders.github.clientSecret
+                    }
+                }
+                : typeof process !== 'undefined' &&
+                    process.env.GITHUB_CLIENT_ID &&
+                    process.env.GITHUB_CLIENT_SECRET
+                    ? {
+                        github: {
+                            clientId: process.env.GITHUB_CLIENT_ID,
+                            clientSecret: process.env.GITHUB_CLIENT_SECRET
+                        }
+                    }
+                    : {}),
+            ...(config.socialProviders?.google
+                ? {
+                    google: {
+                        clientId: config.socialProviders.google.clientId,
+                        clientSecret: config.socialProviders.google.clientSecret
+                    }
+                }
+                : typeof process !== 'undefined' &&
+                    process.env.GOOGLE_CLIENT_ID &&
+                    process.env.GOOGLE_CLIENT_SECRET
+                    ? {
+                        google: {
+                            clientId: process.env.GOOGLE_CLIENT_ID,
+                            clientSecret: process.env.GOOGLE_CLIENT_SECRET
+                        }
+                    }
+                    : {})
+        }
+    };
+    return betterAuth(authOptions);
+}

package/dist/server/db/index.d.ts

@@ -0,0 +1,18 @@
+import { drizzle as drizzleNeon } from 'drizzle-orm/neon-http';
+import { drizzle as drizzleLibsql } from 'drizzle-orm/libsql';
+import * as schemaPg from './schema-pg';
+import * as schemaSqlite from './schema-sqlite';
+import type { DbDriver } from './types';
+export * from './types';
+export { schemaPg, schemaSqlite };
+export interface DbConfig {
+    driver?: DbDriver;
+    url?: string;
+    authToken?: string;
+}
+export type AnyDb = ReturnType<typeof drizzleNeon<typeof schemaPg>> | ReturnType<typeof drizzleLibsql<typeof schemaSqlite>>;
+/**
+ * Creates or retrieves a Drizzle database client instance.
+ * Supports switching between Neon (PostgreSQL) and Turso (LibSQL/SQLite).
+ */
+export declare function getDb(config?: DbConfig): AnyDb;

package/dist/server/db/index.js

@@ -0,0 +1,43 @@
+import { drizzle as drizzleNeon } from 'drizzle-orm/neon-http';
+import { drizzle as drizzleLibsql } from 'drizzle-orm/libsql';
+import { neon } from '@neondatabase/serverless';
+import { createClient } from '@libsql/client';
+import * as schemaPg from './schema-pg';
+import * as schemaSqlite from './schema-sqlite';
+export * from './types';
+export { schemaPg, schemaSqlite };
+let cachedDb = null;
+/**
+ * Creates or retrieves a Drizzle database client instance.
+ * Supports switching between Neon (PostgreSQL) and Turso (LibSQL/SQLite).
+ */
+export function getDb(config) {
+    if (cachedDb && !config) {
+        return cachedDb;
+    }
+    const driver = config?.driver ||
+        (typeof process !== 'undefined' ? process.env.DATABASE_DRIVER : undefined) ||
+        'neon';
+    const url = config?.url ||
+        (typeof process !== 'undefined'
+            ? process.env.DATABASE_URL || 'postgres://localhost:5432/yaxa_saas'
+            : 'postgres://localhost:5432/yaxa_saas');
+    const authToken = config?.authToken ||
+        (typeof process !== 'undefined' ? process.env.DATABASE_AUTH_TOKEN : undefined);
+    if (driver === 'turso' || driver === 'sqlite') {
+        const client = createClient({
+            url,
+            authToken
+        });
+        const db = drizzleLibsql(client, { schema: schemaSqlite });
+        if (!config)
+            cachedDb = db;
+        return db;
+    }
+    // Default to Neon Serverless Postgres
+    const sql = neon(url);
+    const db = drizzleNeon(sql, { schema: schemaPg });
+    if (!config)
+        cachedDb = db;
+    return db;
+}