yaxa-svelte 2.0.4 → 2.2.0

package/README.md

@@ -12,6 +12,8 @@ _Nuxt UI v4 & Nuxt UI Pro Equivalent for SvelteKit 2 & 3 & Svelte 5 with Built-i
 [![Tailwind CSS v4](https://img.shields.io/badge/Tailwind_CSS-v4.0-38B2AC?style=flat&logo=tailwind-css&logoColor=white)](https://tailwindcss.com)
 [![Bits UI](https://img.shields.io/badge/Bits_UI-v2.0-18181b?style=flat)](https://bits-ui.com)
 [![License: MIT](https://img.shields.io/badge/License-MIT-emerald.svg)](LICENSE)
+[![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](SECURITY.md)
+[![Contributing](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
 [**Live Documentation & Playground →**](https://yaxa.vercel.app)
 
@@ -239,13 +241,46 @@ export const POST = createPolarWebhookHandler();
 
 ---
 
+## ⚡ Type-Safe Endpoint Pipeline (`yaxaEndpoint` & Declarative Guards)
+
+Eliminate endpoint boilerplate in `+server.ts` with declarative auth guards, sliding-window rate limiting, multi-engine validation (Zod, Valibot, Standard Schema), and RFC 7807 Problem Details:
+
+```ts
+// src/routes/api/projects/+server.ts
+import { yaxaEndpoint, requireAuth, requireRole, rateLimit } from 'yaxa-svelte/server';
+import { z } from 'zod';
+
+const CreateProjectSchema = z.object({
+	name: z.string().min(3),
+	description: z.string().optional()
+});
+
+export const POST = yaxaEndpoint({
+	status: 201,
+	guards: [
+		requireAuth(),
+		requireRole(['admin', 'owner']),
+		rateLimit({ points: 20, windowSeconds: 60 })
+	],
+	schema: {
+		body: CreateProjectSchema
+	},
+	handle: async ({ body, user, orgId }) => {
+		// Guaranteed type-safe body, authenticated user, and active orgId
+		return { id: 'proj_123', name: body.name, orgId };
+	}
+});
+```
+
+---
+
 ## 📦 Subpath Exports Architecture
 
 | Subpath                 | Description                                                                                                                               |
 | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
 | `yaxa-svelte`           | Core UI Primitives, SEO Components, `<Gate />`, Theme System & Composables (`useGate`, `useUpload`, `useToast`, `useClipboard`, etc.)     |
 | `yaxa-svelte/admin`     | Drizzle ORM Schema Introspection, `<AdminDashboard />`, `createYaxaAdminHook`, `createDrizzleAdmin`, `<DevSandbox />`, `<RecordDrawer />` |
-| `yaxa-svelte/server`    | Universal Server Hooks, SEO endpoints, Drizzle DB drivers, Cloud Storage handlers, and Email dispatch                                     |
+| `yaxa-svelte/server`    | `yaxaEndpoint` Pipeline, Declarative Guards, RFC 7807, Universal Server Hooks, SEO endpoints, Drizzle DB, Storage & Email                 |
 | `yaxa-svelte/auth`      | Better-Auth client & server integration (`useAuth`, `<AuthCard />`, `<PasskeyUI />`, `<TwoFactorModal />`, `createYaxaAuth`)              |
 | `yaxa-svelte/db`        | Multi-dialect Drizzle ORM clients & schemas for Neon (PostgreSQL) and Turso (SQLite/LibSQL)                                               |
 | `yaxa-svelte/polar`     | Polar.sh billing, customer portal sessions, and webhook synchronization                                                                   |
@@ -293,12 +328,12 @@ theme.setAccent('sky'); // Sky Cyan (#0ea5e9)
 
 ## 🤝 Contributing
 
-Contributions are always welcome!
+Contributions are always welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Security Policy](SECURITY.md) before submitting pull requests.
 
 1. Fork the repository: `git clone https://github.com/FuntionalFrost/yaxa.git`
 2. Install dependencies: `pnpm install`
 3. Start development server: `pnpm dev`
-4. Run type checking & linting: `pnpm check && pnpm lint`
+4. Run verification gates: `pnpm lint && pnpm check && pnpm test && pnpm build`
 
 ---
 

package/dist/components/blocks/FAQ.svelte.d.ts

@@ -5,7 +5,7 @@ export interface FAQItem {
     answer: string;
     category?: string;
 }
-export declare const faqVariants: import("tailwind-variants").TVReturnType<{} | {} | {}, undefined, "w-full py-12 max-w-3xl mx-auto", {} | {}, undefined, import("tailwind-variants").TVReturnTypeLike<unknown, undefined>>;
+export declare const faqVariants: import("tailwind-variants").TVReturnType<{}, undefined, "w-full py-12 max-w-3xl mx-auto", undefined, undefined, undefined>;
 export type FAQProps = VariantProps<typeof faqVariants> & {
     title?: string;
     description?: string;

package/dist/components/blocks/FeatureGrid.svelte.d.ts

@@ -8,7 +8,7 @@ export interface FeatureItem {
     tag?: string;
     href?: string;
 }
-export declare const featureGridVariants: import("tailwind-variants").TVReturnType<{} | {} | {}, undefined, "w-full py-12", {} | {}, undefined, import("tailwind-variants").TVReturnTypeLike<unknown, undefined>>;
+export declare const featureGridVariants: import("tailwind-variants").TVReturnType<{}, undefined, "w-full py-12", undefined, undefined, undefined>;
 export type FeatureGridProps = VariantProps<typeof featureGridVariants> & {
     title?: string;
     description?: string;

package/dist/components/blocks/Testimonials.svelte.d.ts

@@ -8,7 +8,7 @@ export interface TestimonialItem {
     avatar?: string;
     rating?: number;
 }
-export declare const testimonialsVariants: import("tailwind-variants").TVReturnType<{} | {} | {}, undefined, "w-full py-12", {} | {}, undefined, import("tailwind-variants").TVReturnTypeLike<unknown, undefined>>;
+export declare const testimonialsVariants: import("tailwind-variants").TVReturnType<{}, undefined, "w-full py-12", undefined, undefined, undefined>;
 export type TestimonialsProps = VariantProps<typeof testimonialsVariants> & {
     title?: string;
     description?: string;

package/dist/components/elements/Avatar.svelte.d.ts

@@ -1,32 +1,14 @@
 import { type VariantProps } from '../../utils/cn';
 export declare const avatarVariants: import("tailwind-variants").TVReturnType<{
     size: {
-        xs: "h-6 w-6 text-[10px]";
-        sm: "h-8 w-8 text-xs";
-        md: "h-10 w-10 text-sm";
-        lg: "h-12 w-12 text-base";
-        xl: "h-14 w-14 text-lg";
-        '2xl': "h-16 w-16 text-xl";
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        '2xl': string;
     };
-}, undefined, "relative inline-flex shrink-0 items-center justify-center font-medium select-none overflow-hidden rounded-full bg-neutral-200 text-neutral-700 dark:bg-neutral-800 dark:text-neutral-300", {
-    size: {
-        xs: "h-6 w-6 text-[10px]";
-        sm: "h-8 w-8 text-xs";
-        md: "h-10 w-10 text-sm";
-        lg: "h-12 w-12 text-base";
-        xl: "h-14 w-14 text-lg";
-        '2xl': "h-16 w-16 text-xl";
-    };
-}, undefined, import("tailwind-variants").TVReturnTypeLike<{
-    size: {
-        xs: "h-6 w-6 text-[10px]";
-        sm: "h-8 w-8 text-xs";
-        md: "h-10 w-10 text-sm";
-        lg: "h-12 w-12 text-base";
-        xl: "h-14 w-14 text-lg";
-        '2xl': "h-16 w-16 text-xl";
-    };
-}, undefined>>;
+}, undefined, "relative inline-flex shrink-0 items-center justify-center font-medium select-none overflow-hidden rounded-full bg-neutral-200 text-neutral-700 dark:bg-neutral-800 dark:text-neutral-300", undefined, undefined, undefined>;
 export type AvatarProps = VariantProps<typeof avatarVariants> & {
     src?: string;
     alt?: string;

package/dist/components/elements/Badge.svelte.d.ts

@@ -3,68 +3,26 @@ import type { Snippet } from 'svelte';
 import type { IconSource } from './Icon.svelte';
 export declare const badgeVariants: import("tailwind-variants").TVReturnType<{
     variant: {
-        solid: "text-white";
-        outline: "border bg-transparent";
-        soft: "";
-        subtle: "border";
+        solid: string;
+        outline: string;
+        soft: string;
+        subtle: string;
     };
     color: {
-        primary: "";
-        neutral: "";
-        success: "";
-        warning: "";
-        error: "";
-        info: "";
+        primary: string;
+        neutral: string;
+        success: string;
+        warning: string;
+        error: string;
+        info: string;
     };
     size: {
-        xs: "text-[10px] px-1.5 py-0.5 gap-1 rounded";
-        sm: "text-xs px-2.5 py-0.5 gap-1.5 rounded-md";
-        md: "text-xs px-2.5 py-1 gap-1.5 rounded-md";
-        lg: "text-sm px-3 py-1.5 gap-2 rounded-lg";
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
     };
-}, undefined, "inline-flex items-center font-medium select-none transition-colors duration-150", {
-    variant: {
-        solid: "text-white";
-        outline: "border bg-transparent";
-        soft: "";
-        subtle: "border";
-    };
-    color: {
-        primary: "";
-        neutral: "";
-        success: "";
-        warning: "";
-        error: "";
-        info: "";
-    };
-    size: {
-        xs: "text-[10px] px-1.5 py-0.5 gap-1 rounded";
-        sm: "text-xs px-2.5 py-0.5 gap-1.5 rounded-md";
-        md: "text-xs px-2.5 py-1 gap-1.5 rounded-md";
-        lg: "text-sm px-3 py-1.5 gap-2 rounded-lg";
-    };
-}, undefined, import("tailwind-variants").TVReturnTypeLike<{
-    variant: {
-        solid: "text-white";
-        outline: "border bg-transparent";
-        soft: "";
-        subtle: "border";
-    };
-    color: {
-        primary: "";
-        neutral: "";
-        success: "";
-        warning: "";
-        error: "";
-        info: "";
-    };
-    size: {
-        xs: "text-[10px] px-1.5 py-0.5 gap-1 rounded";
-        sm: "text-xs px-2.5 py-0.5 gap-1.5 rounded-md";
-        md: "text-xs px-2.5 py-1 gap-1.5 rounded-md";
-        lg: "text-sm px-3 py-1.5 gap-2 rounded-lg";
-    };
-}, undefined>>;
+}, undefined, "inline-flex items-center font-medium select-none transition-colors duration-150", undefined, undefined, undefined>;
 export type BadgeProps = VariantProps<typeof badgeVariants> & {
     dot?: boolean;
     icon?: IconSource;

package/dist/components/elements/Button.svelte.d.ts

@@ -3,92 +3,34 @@ import type { Snippet } from 'svelte';
 import type { IconSource } from './Icon.svelte';
 export declare const buttonVariants: import("tailwind-variants").TVReturnType<{
     variant: {
-        solid: "shadow-xs text-white";
-        outline: "border bg-transparent shadow-xs";
-        soft: "";
-        subtle: "border";
-        ghost: "bg-transparent";
-        link: "p-0 underline-offset-4 hover:underline";
+        solid: string;
+        outline: string;
+        soft: string;
+        subtle: string;
+        ghost: string;
+        link: string;
     };
     color: {
-        primary: "";
-        neutral: "";
-        success: "";
-        warning: "";
-        error: "";
+        primary: string;
+        neutral: string;
+        success: string;
+        warning: string;
+        error: string;
     };
     size: {
-        xs: "text-xs px-2 py-1 gap-1 rounded-md";
-        sm: "text-sm px-2.5 py-1.5 gap-1.5 rounded-md";
-        md: "text-sm px-3.5 py-2 gap-2 rounded-lg";
-        lg: "text-base px-4 py-2.5 gap-2 rounded-lg";
-        xl: "text-base px-5 py-3 gap-2.5 rounded-xl";
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
     };
     block: {
-        true: "w-full";
+        true: string;
     };
     square: {
-        true: "aspect-square p-0";
+        true: string;
     };
-}, undefined, "inline-flex items-center justify-center font-medium transition-all duration-150 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 select-none active:scale-[0.98] whitespace-nowrap max-w-full overflow-hidden text-ellipsis shrink-0 [&>svg]:shrink-0", {
-    variant: {
-        solid: "shadow-xs text-white";
-        outline: "border bg-transparent shadow-xs";
-        soft: "";
-        subtle: "border";
-        ghost: "bg-transparent";
-        link: "p-0 underline-offset-4 hover:underline";
-    };
-    color: {
-        primary: "";
-        neutral: "";
-        success: "";
-        warning: "";
-        error: "";
-    };
-    size: {
-        xs: "text-xs px-2 py-1 gap-1 rounded-md";
-        sm: "text-sm px-2.5 py-1.5 gap-1.5 rounded-md";
-        md: "text-sm px-3.5 py-2 gap-2 rounded-lg";
-        lg: "text-base px-4 py-2.5 gap-2 rounded-lg";
-        xl: "text-base px-5 py-3 gap-2.5 rounded-xl";
-    };
-    block: {
-        true: "w-full";
-    };
-    square: {
-        true: "aspect-square p-0";
-    };
-}, undefined, import("tailwind-variants").TVReturnTypeLike<{
-    variant: {
-        solid: "shadow-xs text-white";
-        outline: "border bg-transparent shadow-xs";
-        soft: "";
-        subtle: "border";
-        ghost: "bg-transparent";
-        link: "p-0 underline-offset-4 hover:underline";
-    };
-    color: {
-        primary: "";
-        neutral: "";
-        success: "";
-        warning: "";
-        error: "";
-    };
-    size: {
-        xs: "text-xs px-2 py-1 gap-1 rounded-md";
-        sm: "text-sm px-2.5 py-1.5 gap-1.5 rounded-md";
-        md: "text-sm px-3.5 py-2 gap-2 rounded-lg";
-        lg: "text-base px-4 py-2.5 gap-2 rounded-lg";
-        xl: "text-base px-5 py-3 gap-2.5 rounded-xl";
-    };
-    block: {
-        true: "w-full";
-    };
-    square: {
-        true: "aspect-square p-0";
-    };
-}, undefined>>;
+}, undefined, "inline-flex items-center justify-center font-medium transition-all duration-150 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-50 select-none active:scale-[0.98] whitespace-nowrap max-w-full overflow-hidden text-ellipsis shrink-0 [&>svg]:shrink-0", undefined, undefined, undefined>;
 export type ButtonProps = VariantProps<typeof buttonVariants> & {
     type?: 'button' | 'submit' | 'reset';
     href?: string;

package/dist/components/elements/Carousel.svelte.d.ts

@@ -1,30 +1,6 @@
 import { type VariantProps } from '../../utils/cn.js';
 import type { Snippet } from 'svelte';
-export declare const carouselVariants: import("tailwind-variants").TVReturnType<{
-    [key: string]: {
-        [key: string]: import("tailwind-variants").ClassValue | {
-            viewport?: import("tailwind-variants").ClassValue;
-            root?: import("tailwind-variants").ClassValue;
-            slide?: import("tailwind-variants").ClassValue;
-            controls?: import("tailwind-variants").ClassValue;
-            arrowBtn?: import("tailwind-variants").ClassValue;
-            dots?: import("tailwind-variants").ClassValue;
-            dotBtn?: import("tailwind-variants").ClassValue;
-        };
-    };
-} | {
-    [x: string]: {
-        [x: string]: import("tailwind-variants").ClassValue | {
-            viewport?: import("tailwind-variants").ClassValue;
-            root?: import("tailwind-variants").ClassValue;
-            slide?: import("tailwind-variants").ClassValue;
-            controls?: import("tailwind-variants").ClassValue;
-            arrowBtn?: import("tailwind-variants").ClassValue;
-            dots?: import("tailwind-variants").ClassValue;
-            dotBtn?: import("tailwind-variants").ClassValue;
-        };
-    };
-} | {}, {
+export declare const carouselVariants: import("tailwind-variants").TVReturnType<{}, {
     root: string;
     viewport: string;
     slide: string;
@@ -32,35 +8,7 @@ export declare const carouselVariants: import("tailwind-variants").TVReturnType<
     arrowBtn: string;
     dots: string;
     dotBtn: string;
-}, undefined, {
-    [key: string]: {
-        [key: string]: import("tailwind-variants").ClassValue | {
-            viewport?: import("tailwind-variants").ClassValue;
-            root?: import("tailwind-variants").ClassValue;
-            slide?: import("tailwind-variants").ClassValue;
-            controls?: import("tailwind-variants").ClassValue;
-            arrowBtn?: import("tailwind-variants").ClassValue;
-            dots?: import("tailwind-variants").ClassValue;
-            dotBtn?: import("tailwind-variants").ClassValue;
-        };
-    };
-} | {}, {
-    root: string;
-    viewport: string;
-    slide: string;
-    controls: string;
-    arrowBtn: string;
-    dots: string;
-    dotBtn: string;
-}, import("tailwind-variants").TVReturnTypeLike<unknown, {
-    root: string;
-    viewport: string;
-    slide: string;
-    controls: string;
-    arrowBtn: string;
-    dots: string;
-    dotBtn: string;
-}>>;
+}, undefined, undefined, undefined, undefined>;
 export type CarouselProps<T> = VariantProps<typeof carouselVariants> & {
     items: T[];
     currentIndex?: number;