@vibesdotdev/kit 0.0.0-stage → 1.0.0-rc.3

package/dist/lib/svelte/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * `@vibesdotdev/kit/svelte`
+ *
+ * Canonical generic Svelte surface. Root stays isomorphic. Domain families
+ * (billing, mail, schedule-calendar, profile-sections, user-component,
+ * tool-widgets, app-shell product policy) stay on their explicit subpaths.
+ */
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from '../components/ui/accordion';
+export { Calendar, CalendarDay, CalendarCell, CalendarGrid, CalendarHeader, CalendarMonths, CalendarGridRow, CalendarHeading, CalendarGridBody, CalendarGridHead, CalendarHeadCell, CalendarNextButton, CalendarPrevButton, CalendarNav, CalendarMonth, CalendarYearSelect, CalendarMonthSelect, CalendarCaption } from '../components/ui/calendar';
+export { Alert, alertVariants, AlertDescription, AlertTitle, type AlertVariant } from '../components/ui/alert';
+export { AlertDialog, AlertDialogTitle, AlertDialogAction, AlertDialogCancel, AlertDialogPortal, AlertDialogFooter, AlertDialogHeader, AlertDialogTrigger, AlertDialogOverlay, AlertDialogContent, AlertDialogDescription } from '../components/ui/alert-dialog';
+export { AspectRatio } from '../components/ui/aspect-ratio';
+export { Avatar, AvatarImage, AvatarFallback } from '../components/ui/avatar';
+export { Icon } from '../components/icon';
+export { Badge, badgeVariants } from '../components/ui/badge';
+export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbSeparator, BreadcrumbLink, BreadcrumbList, BreadcrumbPage } from '../components/ui/breadcrumb';
+export { Button, type ButtonProps, buttonVariants, type ButtonSize, type ButtonVariant } from '../components/ui/button';
+export { ButtonGroup, ButtonGroupText, ButtonGroupSeparator } from '../components/ui/button-group';
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardAction } from '../components/ui/card';
+export { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext } from '../components/ui/carousel';
+export { ConfirmDialog } from '../components/ui/confirm-dialog';
+export { Checkbox } from '../components/ui/checkbox';
+export { Collapsible, CollapsibleContent, CollapsibleTrigger } from '../components/ui/collapsible';
+export { Command, CommandDialog, CommandEmpty, CommandGroup, CommandItem, CommandLinkItem, CommandInput, CommandList, CommandSeparator, CommandShortcut, CommandLoading } from '../components/ui/command';
+export { ContextMenu, ContextMenuSub, ContextMenuPortal, ContextMenuItem, ContextMenuGroupHeading, ContextMenuGroup, ContextMenuContent, ContextMenuTrigger, ContextMenuShortcut, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuRadioGroup, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuCheckboxItem, ContextMenuLabel } from '../components/ui/context-menu';
+export { FlexRender, renderComponent, renderSnippet, createSvelteTable } from '../components/ui/data-table';
+export { Dialog, DialogTitle, DialogPortal, DialogFooter, DialogHeader, DialogTrigger, DialogOverlay, DialogContent, DialogDescription, DialogClose } from '../components/ui/dialog';
+export { ErrorPage, getErrorPageInfo, type ErrorPageInfo } from '../components/error-boundary';
+export { Drawer, DrawerNestedRoot, DrawerContent, DrawerDescription, DrawerOverlay, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DrawerPortal, DrawerClose } from '../components/ui/drawer';
+export { DropdownMenu, DropdownMenuCheckboxGroup, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuPortal, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, DropdownMenuGroupHeading } from '../components/ui/dropdown-menu';
+export { Empty, EmptyHeader, EmptyMedia, EmptyTitle, EmptyDescription, EmptyContent } from '../components/ui/empty';
+export { Field, FieldLegend, FieldGroup, FieldContent, FieldLabel, FieldTitle, FieldDescription, FieldSeparator, FieldError } from '../components/ui/field';
+export { FormField, FormItem, FormControl, FormDescription, FormLabel, FormFieldErrors, FormItemErrors, FormMessage, FormFieldset, FormLegend, FormElementField, FormButton } from '../components/ui/form';
+export { HoverCard, HoverCardContent, HoverCardTrigger, HoverCardPortal } from '../components/ui/hover-card';
+export { Input } from '../components/ui/input';
+export { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea } from '../components/ui/input-group';
+export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator } from '../components/ui/input-otp';
+export { ItemGroup, ItemSeparator, ItemHeader, ItemFooter, ItemContent, ItemTitle, ItemDescription, ItemActions, ItemMedia } from '../components/ui/item';
+export { Kbd, KbdGroup } from '../components/ui/kbd';
+export { Label } from '../components/ui/label';
+export { Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MenubarMenu, MenubarGroup, MenubarSub, MenubarRadioGroup, MenubarLabel, MenubarGroupHeading, MenubarPortal } from '../components/ui/menubar';
+export { ModeSwitcher, SharedModeWatcher, ModeStore, currentModeStore } from '../components/ui/mode-switcher';
+export { NativeSelect, NativeSelectOption, NativeSelectOptGroup } from '../components/ui/native-select';
+export { NavigationMenuRoot, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport } from '../components/ui/navigation-menu';
+export { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationPrevButton, PaginationPrevious, PaginationNextButton, PaginationNext, PaginationEllipsis } from '../components/ui/pagination';
+export { Popover, PopoverContent, PopoverTrigger, PopoverClose, PopoverPortal } from '../components/ui/popover';
+export { Progress } from '../components/ui/progress';
+export { RadioGroup, RadioGroupItem } from '../components/ui/radio-group';
+export { PaneGroup, Pane, Handle, ResizablePane, ResizableHandle } from '../components/ui/resizable';
+export { ScrollArea, ScrollAreaScrollbar } from '../components/ui/scroll-area';
+export { Select, SelectGroup, SelectLabel, SelectItem, SelectContent, SelectTrigger, SelectSeparator, SelectScrollDownButton, SelectScrollUpButton, SelectGroupHeading, SelectPortal, SelectValue } from '../components/ui/select';
+export { Separator } from '../components/ui/separator';
+export { Sheet, SheetClose, SheetTrigger, SheetPortal, SheetOverlay, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription } from '../components/ui/sheet';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar } from '../components/ui/sidebar';
+export { Skeleton } from '../components/ui/skeleton';
+export { Slider } from '../components/ui/slider';
+export { Toaster } from '../components/ui/sonner';
+export { Spinner } from '../components/ui/spinner';
+export { Switch } from '../components/ui/switch';
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from '../components/ui/table';
+export { Tabs, TabsContent, TabsList, TabsTrigger } from '../components/ui/tabs';
+export { Textarea } from '../components/ui/textarea';
+export { Toggle, toggleVariants } from '../components/ui/toggle';
+export { ToggleGroup, ToggleGroupItem } from '../components/ui/toggle-group';
+export { Tooltip, TooltipContent, TooltipTrigger, TooltipProvider, TooltipPortal } from '../components/ui/tooltip';
+export { default as CanvasBackground } from '../components/background/CanvasBackground.svelte';
+export { VibesLogo, vibesLogoSvg } from '../components/brand/index.js';
+export { default as AnimatedSection } from '../components/parallax/AnimatedSection.svelte';
+export { default as StaggeredList } from '../components/parallax/StaggeredList.svelte';
+export { default as FlowerOfLifeCanvas } from '../components/webgl/FlowerOfLifeCanvas.svelte';
+export { default as NodeNetworkCanvas } from '../components/webgl/NodeNetworkCanvas.svelte';
+export { default as CodeFlowCanvas } from '../components/webgl/CodeFlowCanvas.svelte';
+export { default as OrbitCanvas } from '../components/webgl/OrbitCanvas.svelte';
+export { default as ParticleFlowCanvas } from '../components/webgl/ParticleFlowCanvas.svelte';
+export { default as PulseCanvas } from '../components/webgl/PulseCanvas.svelte';
+export { default as HexGridCanvas } from '../components/webgl/HexGridCanvas.svelte';
+export { default as AssemblyField } from '../components/webgl/AssemblyField.svelte';
+export { default as DemoBanner } from '../components/demo/DemoBanner.svelte';
+export { default as Banner } from '../components/banner/Banner.svelte';
+export { CardSkeleton, PageHeaderSkeleton, TableRowSkeleton, FormSkeleton } from '../components/skeleton/index.js';
+export { GlassPanel, type GlassPanelComposition, type GlassPanelFidelity, type GlassPanelIntensity, type GlassPanelProps } from '../components/ui/glass-panel';
+export { SelectorPill, SelectorPillDivider } from '../components/glass/index.ts';
+export { GlobalErrorBoundary } from '../components/error-boundary';
+export { default as SkipLink } from '../components/a11y/SkipLink.svelte';
+export { success, error, warning, info, loading, message, dismiss, dismissAll, update } from '../components/toast/index.js';
+export { default as FormError } from '../components/form-utils/FormError.svelte';
+export { default as VibesFormField } from '../components/form-utils/VibesFormField.svelte';
+export { SettingsCard, SettingsFormSection, DangerZone } from '../settings/index.js';
+export { default as SearchSelect, type SearchSelectOption } from '../components/search-select/SearchSelect.svelte';
+export { PageHeader, EmptyState } from '../components/layout/index.js';
+export { RunStatusBadge } from '../components/viz/index.js';

package/dist/lib/svelte/index.js

@@ -0,0 +1,97 @@
+/**
+ * `@vibesdotdev/kit/svelte`
+ *
+ * Canonical generic Svelte surface. Root stays isomorphic. Domain families
+ * (billing, mail, schedule-calendar, profile-sections, user-component,
+ * tool-widgets, app-shell product policy) stay on their explicit subpaths.
+ */
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from '../components/ui/accordion';
+export { Calendar, CalendarDay, CalendarCell, CalendarGrid, CalendarHeader, CalendarMonths, CalendarGridRow, CalendarHeading, CalendarGridBody, CalendarGridHead, CalendarHeadCell, CalendarNextButton, CalendarPrevButton, CalendarNav, CalendarMonth, CalendarYearSelect, CalendarMonthSelect, CalendarCaption } from '../components/ui/calendar';
+export { Alert, alertVariants, AlertDescription, AlertTitle } from '../components/ui/alert';
+export { AlertDialog, AlertDialogTitle, AlertDialogAction, AlertDialogCancel, AlertDialogPortal, AlertDialogFooter, AlertDialogHeader, AlertDialogTrigger, AlertDialogOverlay, AlertDialogContent, AlertDialogDescription } from '../components/ui/alert-dialog';
+export { AspectRatio } from '../components/ui/aspect-ratio';
+export { Avatar, AvatarImage, AvatarFallback } from '../components/ui/avatar';
+export { Icon } from '../components/icon';
+export { Badge, badgeVariants } from '../components/ui/badge';
+export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbSeparator, BreadcrumbLink, BreadcrumbList, BreadcrumbPage } from '../components/ui/breadcrumb';
+export { Button, buttonVariants } from '../components/ui/button';
+export { ButtonGroup, ButtonGroupText, ButtonGroupSeparator } from '../components/ui/button-group';
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CardAction } from '../components/ui/card';
+export { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext } from '../components/ui/carousel';
+// Chart components are deliberately NOT in the barrel — import them from
+// '@vibesdotdev/kit/components/ui/chart' when a surface actually wires them.
+// chart-tooltip imports the layerchart BARREL, whose Dagre export drags the
+// CJS-only `@dagrejs/dagre` into the browser module graph of every barrel
+// consumer; with zero chart consumers today that cost (and the raw-CJS
+// breakage in optimizer-less hosts like component-shot) bought nothing.
+export { ConfirmDialog } from '../components/ui/confirm-dialog';
+export { Checkbox } from '../components/ui/checkbox';
+export { Collapsible, CollapsibleContent, CollapsibleTrigger } from '../components/ui/collapsible';
+export { Command, CommandDialog, CommandEmpty, CommandGroup, CommandItem, CommandLinkItem, CommandInput, CommandList, CommandSeparator, CommandShortcut, CommandLoading } from '../components/ui/command';
+export { ContextMenu, ContextMenuSub, ContextMenuPortal, ContextMenuItem, ContextMenuGroupHeading, ContextMenuGroup, ContextMenuContent, ContextMenuTrigger, ContextMenuShortcut, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuRadioGroup, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuCheckboxItem, ContextMenuLabel } from '../components/ui/context-menu';
+export { FlexRender, renderComponent, renderSnippet, createSvelteTable } from '../components/ui/data-table';
+export { Dialog, DialogTitle, DialogPortal, DialogFooter, DialogHeader, DialogTrigger, DialogOverlay, DialogContent, DialogDescription, DialogClose } from '../components/ui/dialog';
+export { ErrorPage, getErrorPageInfo } from '../components/error-boundary';
+export { Drawer, DrawerNestedRoot, DrawerContent, DrawerDescription, DrawerOverlay, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DrawerPortal, DrawerClose } from '../components/ui/drawer';
+export { DropdownMenu, DropdownMenuCheckboxGroup, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuPortal, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, DropdownMenuGroupHeading } from '../components/ui/dropdown-menu';
+export { Empty, EmptyHeader, EmptyMedia, EmptyTitle, EmptyDescription, EmptyContent } from '../components/ui/empty';
+export { Field, FieldLegend, FieldGroup, FieldContent, FieldLabel, FieldTitle, FieldDescription, FieldSeparator, FieldError } from '../components/ui/field';
+export { FormField, FormItem, FormControl, FormDescription, FormLabel, FormFieldErrors, FormItemErrors, FormMessage, FormFieldset, FormLegend, FormElementField, FormButton } from '../components/ui/form';
+export { HoverCard, HoverCardContent, HoverCardTrigger, HoverCardPortal } from '../components/ui/hover-card';
+export { Input } from '../components/ui/input';
+export { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea } from '../components/ui/input-group';
+export { InputOTP, InputOTPGroup, InputOTPSlot, InputOTPSeparator } from '../components/ui/input-otp';
+export { ItemGroup, ItemSeparator, ItemHeader, ItemFooter, ItemContent, ItemTitle, ItemDescription, ItemActions, ItemMedia } from '../components/ui/item';
+export { Kbd, KbdGroup } from '../components/ui/kbd';
+export { Label } from '../components/ui/label';
+export { Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MenubarMenu, MenubarGroup, MenubarSub, MenubarRadioGroup, MenubarLabel, MenubarGroupHeading, MenubarPortal } from '../components/ui/menubar';
+export { ModeSwitcher, SharedModeWatcher, ModeStore, currentModeStore } from '../components/ui/mode-switcher';
+export { NativeSelect, NativeSelectOption, NativeSelectOptGroup } from '../components/ui/native-select';
+export { NavigationMenuRoot, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport } from '../components/ui/navigation-menu';
+export { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationPrevButton, PaginationPrevious, PaginationNextButton, PaginationNext, PaginationEllipsis } from '../components/ui/pagination';
+export { Popover, PopoverContent, PopoverTrigger, PopoverClose, PopoverPortal } from '../components/ui/popover';
+export { Progress } from '../components/ui/progress';
+export { RadioGroup, RadioGroupItem } from '../components/ui/radio-group';
+export { PaneGroup, Pane, Handle, ResizablePane, ResizableHandle } from '../components/ui/resizable';
+export { ScrollArea, ScrollAreaScrollbar } from '../components/ui/scroll-area';
+export { Select, SelectGroup, SelectLabel, SelectItem, SelectContent, SelectTrigger, SelectSeparator, SelectScrollDownButton, SelectScrollUpButton, SelectGroupHeading, SelectPortal, SelectValue } from '../components/ui/select';
+export { Separator } from '../components/ui/separator';
+export { Sheet, SheetClose, SheetTrigger, SheetPortal, SheetOverlay, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription } from '../components/ui/sheet';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar } from '../components/ui/sidebar';
+export { Skeleton } from '../components/ui/skeleton';
+export { Slider } from '../components/ui/slider';
+export { Toaster } from '../components/ui/sonner';
+export { Spinner } from '../components/ui/spinner';
+export { Switch } from '../components/ui/switch';
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from '../components/ui/table';
+export { Tabs, TabsContent, TabsList, TabsTrigger } from '../components/ui/tabs';
+export { Textarea } from '../components/ui/textarea';
+export { Toggle, toggleVariants } from '../components/ui/toggle';
+export { ToggleGroup, ToggleGroupItem } from '../components/ui/toggle-group';
+export { Tooltip, TooltipContent, TooltipTrigger, TooltipProvider, TooltipPortal } from '../components/ui/tooltip';
+export { default as CanvasBackground } from '../components/background/CanvasBackground.svelte';
+export { VibesLogo, vibesLogoSvg } from '../components/brand/index.js';
+export { default as AnimatedSection } from '../components/parallax/AnimatedSection.svelte';
+export { default as StaggeredList } from '../components/parallax/StaggeredList.svelte';
+export { default as FlowerOfLifeCanvas } from '../components/webgl/FlowerOfLifeCanvas.svelte';
+export { default as NodeNetworkCanvas } from '../components/webgl/NodeNetworkCanvas.svelte';
+export { default as CodeFlowCanvas } from '../components/webgl/CodeFlowCanvas.svelte';
+export { default as OrbitCanvas } from '../components/webgl/OrbitCanvas.svelte';
+export { default as ParticleFlowCanvas } from '../components/webgl/ParticleFlowCanvas.svelte';
+export { default as PulseCanvas } from '../components/webgl/PulseCanvas.svelte';
+export { default as HexGridCanvas } from '../components/webgl/HexGridCanvas.svelte';
+export { default as AssemblyField } from '../components/webgl/AssemblyField.svelte';
+export { default as DemoBanner } from '../components/demo/DemoBanner.svelte';
+export { default as Banner } from '../components/banner/Banner.svelte';
+export { CardSkeleton, PageHeaderSkeleton, TableRowSkeleton, FormSkeleton } from '../components/skeleton/index.js';
+export { GlassPanel } from '../components/ui/glass-panel';
+export { SelectorPill, SelectorPillDivider } from "../components/glass/index.js";
+export { GlobalErrorBoundary } from '../components/error-boundary';
+export { default as SkipLink } from '../components/a11y/SkipLink.svelte';
+export { success, error, warning, info, loading, message, dismiss, dismissAll, update } from '../components/toast/index.js';
+export { default as FormError } from '../components/form-utils/FormError.svelte';
+export { default as VibesFormField } from '../components/form-utils/VibesFormField.svelte';
+export { SettingsCard, SettingsFormSection, DangerZone } from '../settings/index.js';
+export { default as SearchSelect } from '../components/search-select/SearchSelect.svelte';
+export { PageHeader, EmptyState } from '../components/layout/index.js';
+export { RunStatusBadge } from '../components/viz/index.js';

package/dist/lib/types/errors.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Typed error interfaces for vibeskit
+ *
+ * Kit error interfaces and constructors.
+ *
+ * @example
+ * ```typescript
+ * import { isApiError, createApiError, type ApiError } from '../index.ts/errors';
+ * ```
+ */
+/** An API error; `Details` is the type of its optional detail payload. */
+export interface ApiError<Details = unknown> {
+    message: string;
+    code?: string;
+    status?: number;
+    details?: Details;
+}
+export interface ValidationError {
+    field: string;
+    message: string;
+    code?: string;
+}
+export type AuthenticationError = ApiError;
+export type AuthorizationError = ApiError;
+export type NotFoundError = ApiError;
+export type ConflictError = ApiError;
+export type RateLimitError = ApiError;
+export type BillingError = ApiError;
+export type ServerError = ApiError;
+export type Result<T, E = ApiError> = SuccessResult<T> | FailureResult<E>;
+export type SuccessResult<T> = {
+    success: true;
+    data: T;
+};
+export type FailureResult<E = ApiError> = {
+    success: false;
+    error: E;
+    /** What was thrown, kept as thrown, when `error` was read from a caught failure (`tryCatch`). */
+    cause?: unknown;
+};
+export type AsyncResult<T, E = ApiError> = Promise<Result<T, E>>;
+export type OkResult<T> = SuccessResult<T>;
+export declare function createApiError<Details>(message: string, code?: string, status?: number, details?: Details): ApiError<Details>;
+export declare function isApiError(value: unknown): value is ApiError;
+export declare const isValidationError: typeof isApiError;
+export declare const isAuthenticationError: typeof isApiError;
+export declare const isAuthorizationError: typeof isApiError;
+export declare const isNotFoundError: typeof isApiError;
+export declare const isConflictError: typeof isApiError;
+export declare const isRateLimitError: typeof isApiError;
+export declare const isBillingError: typeof isApiError;
+export declare const isServerError: typeof isApiError;
+export declare const isSuccess: <T>(value: Result<T>) => value is SuccessResult<T>;
+export declare const isFailure: <T>(value: Result<T>) => value is FailureResult;
+export declare const createValidationError: (field: string, message: string, code?: string) => ValidationError;
+export declare const createNotFoundError: (message: string) => NotFoundError;
+export declare const toApiError: (value: unknown) => ApiError;
+export declare const success: <T>(data: T) => SuccessResult<T>;
+export declare const failure: <E = ApiError>(error: E) => FailureResult<E>;
+export declare const ok: <T>(data: T) => SuccessResult<T>;
+export declare const err: <E = ApiError<unknown>>(error: E) => FailureResult<E>;
+export declare function tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T>>;
+export declare function tryCatch<T>(fn: () => T): Result<T>;

package/dist/lib/types/errors.js

@@ -0,0 +1,59 @@
+/**
+ * Typed error interfaces for vibeskit
+ *
+ * Kit error interfaces and constructors.
+ *
+ * @example
+ * ```typescript
+ * import { isApiError, createApiError, type ApiError } from '../index.ts/errors';
+ * ```
+ */
+import * as z from 'zod/v4';
+export function createApiError(message, code, status, details) {
+    return { message, code, status, details };
+}
+export function isApiError(value) {
+    return !!value && typeof value === 'object' && 'message' in value;
+}
+export const isValidationError = isApiError;
+export const isAuthenticationError = isApiError;
+export const isAuthorizationError = isApiError;
+export const isNotFoundError = isApiError;
+export const isConflictError = isApiError;
+export const isRateLimitError = isApiError;
+export const isBillingError = isApiError;
+export const isServerError = isApiError;
+export const isSuccess = (value) => value.success;
+export const isFailure = (value) => !value.success;
+export const createValidationError = (field, message, code) => ({ field, message, code });
+export const createNotFoundError = (message) => createApiError(message, 'NOT_FOUND', 404);
+/**
+ * How `toApiError` reads a value: one that already has the `ApiError` shape is
+ * kept as is (a thrown `Error` keeps its identity); any other value becomes an
+ * `ApiError` carrying its text.
+ */
+const ApiErrorFromValueSchema = z.union([
+    z.custom(isApiError),
+    z.unknown().transform((other) => createApiError(String(other)))
+]);
+export const toApiError = (value) => ApiErrorFromValueSchema.parse(value);
+export const success = (data) => ({ success: true, data });
+export const failure = (error) => ({ success: false, error });
+export const ok = success;
+export const err = failure;
+export async function tryCatchAsync(fn) {
+    try {
+        return success(await fn());
+    }
+    catch (error) {
+        return { success: false, error: toApiError(error), cause: error };
+    }
+}
+export function tryCatch(fn) {
+    try {
+        return success(fn());
+    }
+    catch (error) {
+        return { success: false, error: toApiError(error), cause: error };
+    }
+}

package/dist/lib/types/kit.d.ts

@@ -0,0 +1,289 @@
+/**
+ * VibesKit interface and configuration types
+ */
+import type { Handle, RequestHandler, HandleServerError, RequestEvent } from '@sveltejs/kit';
+import * as z from 'zod/v4';
+import type { VibesPlugin, PluginConfig, PluginApi } from './plugin';
+import type { AuthConfig } from '../server/hooks/auth';
+import type { SecurityHeadersConfig, SecurityPattern } from '../server/hooks/security';
+import type { UserContextConfig } from '../server/hooks/context';
+import type { MaintenanceConfig } from '../server/hooks/maintenance';
+import type { ActivityConfig } from '../server/hooks/activity';
+import type { UserStatusRoutingConfig } from '../server/hooks/user-status';
+import type { ReferralConfig } from '../server/hooks/referral';
+import type { VibesKitRuntimePort } from '../server/locals';
+import type { VibesConfig as EndpointConfig, VibesHandler } from '../server/endpoint/types';
+import type { LoadConfig, LoadHandler, ActionHandler } from '../server/page/load';
+import type { VibesLayoutLoadOptions, FeatureGateOptions, LayoutData, LayoutLoadFunction, LayoutUserData } from '../server/layout/load';
+import type { GateOptions } from '../client/guard/gate.ts';
+import type { PageGateOptions } from '../client/schemas/gate.ts';
+export type { AuthConfig } from '../server/hooks/auth';
+export type { SecurityHeadersConfig, CSPConfig, SecurityPattern } from '../server/hooks/security';
+export type { UserContextConfig, ContextLoaders } from '../server/hooks/context';
+export type { MaintenanceConfig } from '../server/hooks/maintenance';
+export type { ActivityConfig, ActivityLogEntry, ActivityLoggerFunction } from '../server/hooks/activity';
+export type { UserStatusRoutingConfig } from '../server/hooks/user-status';
+export type { ReferralConfig } from '../server/hooks/referral';
+/**
+ * Logger metadata: the structured fields of one log call, field name to value.
+ * Mirrors the runtime logger contract's `LogContextSchema` (kit imports no
+ * framework runtime): the injected logger normalizes, redacts and parses every
+ * field, so a field may carry any value.
+ */
+export declare const LoggerMetaSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type LoggerMeta = z.infer<typeof LoggerMetaSchema>;
+/**
+ * Logger Service Interface
+ */
+export interface Logger {
+    debug(message: string, meta?: LoggerMeta): void;
+    info(message: string, meta?: LoggerMeta): void;
+    warn(message: string, meta?: LoggerMeta): void;
+    error(message: string, error?: Error, meta?: LoggerMeta): void;
+}
+/**
+ * Cache Service Interface
+ */
+export interface CacheService {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<boolean>;
+    del(key: string): Promise<boolean>;
+    flushPattern(pattern: string): Promise<void>;
+    invalidateUser?(userId: string): Promise<void>;
+    invalidateProject?(projectId: string): Promise<void>;
+}
+/**
+ * Auth Service Interface
+ */
+export interface AuthService {
+    isUserSuperuser(runtime: VibesKitRuntimePort, userId: string): Promise<boolean>;
+    hasPermissions(runtime: VibesKitRuntimePort, userId: string, permissions: {
+        resource: string;
+        action: string;
+    }[], projectId?: string | null, requireAll?: boolean): Promise<boolean>;
+    checkOwnership(runtime: VibesKitRuntimePort, userId: string, resourceType: string, resourceId: string, projectId?: string | null): Promise<boolean>;
+    /** Invalidate cached permissions after an authorization change. */
+    invalidateUserPermissions?(runtime: VibesKitRuntimePort, userId: string, projectId?: string | null): Promise<void>;
+}
+/**
+ * Billing usage metadata
+ */
+export interface BillingUsageMeta {
+    projectId?: string;
+    metadata?: string;
+    [key: string]: string | number | boolean | null | undefined;
+}
+/**
+ * User subscription data
+ */
+export interface UserSubscriptionData {
+    planSlug: string;
+    planTier?: string | null;
+    status: 'active' | 'canceled' | 'past_due' | 'trialing' | 'incomplete';
+    currentPeriodEnd?: Date | null;
+    cancelAtPeriodEnd?: boolean;
+}
+/**
+ * Credit balance snapshot returned by the billing service.
+ */
+export interface CreditBalanceSnapshot {
+    balance: number;
+}
+/**
+ * Billing Service Interface. Every method receives the request's runtime port
+ * first (D1): adapters resolve credentials, bindings and origins through it.
+ */
+export interface BillingService {
+    hasFeatureAccess(runtime: VibesKitRuntimePort, userId: string, feature: string): Promise<boolean>;
+    checkQuota(runtime: VibesKitRuntimePort, userId: string, feature: string, amount: number): Promise<{
+        allowed: boolean;
+        currentUsage: number;
+        limit?: number;
+    }>;
+    recordUsage(runtime: VibesKitRuntimePort, userId: string, feature: string, amount: number, meta?: BillingUsageMeta): Promise<void>;
+    refundUsage(runtime: VibesKitRuntimePort, userId: string, feature: string, amount: number, meta?: BillingUsageMeta): Promise<void>;
+    getUserSubscription(runtime: VibesKitRuntimePort, userId: string): Promise<UserSubscriptionData | null>;
+    getUserPlanSlug(runtime: VibesKitRuntimePort, userId: string): Promise<string | null>;
+    getUpgradeUrl(runtime: VibesKitRuntimePort, feature: string, plan?: string, currentPath?: string, missingFeature?: string): Promise<string>;
+    /**
+     * Pre-flight credit balance read. Returns null when the upstream
+     * service is unreachable so the wrapper can decide whether to
+     * fall through or fail closed.
+     *
+     * `opts.memberActiveOrgId` enables org-first billing: when supplied and
+     * the org has opted in to paying for members (member under allocation,
+     * org pool funded), the returned balance is the ORG pool's — the pool the
+     * charge will draw from. Omit it for the plain user-pool balance.
+     */
+    getBalance(runtime: VibesKitRuntimePort, userId: string, opts?: {
+        memberActiveOrgId?: string | null;
+    }): Promise<CreditBalanceSnapshot | null>;
+}
+/**
+ * Main VibesKit interface
+ * Provides unified API for all vibeskit functionality
+ */
+export interface VibesKit {
+    /** Kit configuration */
+    config: VibesKitConfig;
+    /** Server-side APIs */
+    server: {
+        /** SvelteKit hooks */
+        hooks: {
+            /** Create main request handle */
+            handle: (middleware?: Handle[], overrides?: Partial<VibesKitConfig>) => Handle;
+            /** Create error handler */
+            errorHandler: () => HandleServerError;
+        };
+        /** API endpoint wrappers */
+        endpoint: {
+            GET: <T>(config: EndpointConfig, handler: VibesHandler<T>) => RequestHandler;
+            POST: <T>(config: EndpointConfig, handler: VibesHandler<T>) => RequestHandler;
+            PUT: <T>(config: EndpointConfig, handler: VibesHandler<T>) => RequestHandler;
+            PATCH: <T>(config: EndpointConfig, handler: VibesHandler<T>) => RequestHandler;
+            DELETE: <T>(config: EndpointConfig, handler: VibesHandler<T>) => RequestHandler;
+            request: <T>(method: string, path: string, config: EndpointConfig, handler: VibesHandler<T>) => RequestHandler;
+        };
+        /** Layout load helpers: the layout's own data, merged under the wrapper's `user` */
+        layout: {
+            load: <T extends LayoutData = LayoutData>(options: VibesLayoutLoadOptions, loadFn?: LayoutLoadFunction<T>) => (event: RequestEvent) => Promise<T & LayoutUserData>;
+            auth: <T extends LayoutData = LayoutData>(options: {
+                authRedirectUrl?: string;
+            }, loadFn?: LayoutLoadFunction<T>) => (event: RequestEvent) => Promise<T & LayoutUserData>;
+            feature: <T extends LayoutData = LayoutData>(options: FeatureGateOptions, loadFn?: LayoutLoadFunction<T>) => (event: RequestEvent) => Promise<T & LayoutUserData>;
+        };
+        /** Page load and action helpers */
+        page: {
+            load: <T>(config: LoadConfig, handler: LoadHandler<T>) => (event: import('@sveltejs/kit').RequestEvent) => T | Promise<T>;
+            action: <T>(config: LoadConfig, handler: ActionHandler<T>) => (event: import('@sveltejs/kit').RequestEvent) => T | Promise<T>;
+        };
+    };
+    /** Client-side APIs */
+    client: {
+        /** Layout lifecycle */
+        layout: {
+            mount: (options: {
+                title?: string;
+                titleSuffix?: string;
+                description?: string;
+            }) => void;
+            init: (options: {
+                title?: string;
+                titleSuffix?: string;
+                description?: string;
+            }) => void;
+        };
+        /** Page enhancement */
+        page: {
+            enhance: (options: PageGateOptions) => {
+                enhanceHook: (ctx: {
+                    cancel: () => void;
+                }) => () => Promise<void>;
+            };
+        };
+        /** Guards and gates: the guarded call's result, or `undefined` when the gate blocked it */
+        guard: <Args extends unknown[], Result>(fn: (...args: Args) => Result | Promise<Result>, options: GateOptions) => (...args: Args) => Promise<Result | undefined>;
+        gateAction: (options: GateOptions) => (node: HTMLElement) => {
+            destroy: () => void;
+        };
+    };
+    /** Plugin registry and access */
+    plugin: {
+        /** Get a registered plugin's API surface by name; the reader parses the member it uses */
+        get: (name: string) => PluginApi | undefined;
+        /** Check if plugin is registered */
+        has: (name: string) => boolean;
+        /** List all registered plugins */
+        list: () => VibesPlugin[];
+    };
+    /** Internal plugin management */
+    _plugins: Map<string, VibesPlugin>;
+    _registerPlugin: (plugin: VibesPlugin, config?: PluginConfig['config']) => void;
+}
+/**
+ * Complete vibeskit configuration
+ */
+export interface VibesKitConfig {
+    /** Injected Services */
+    services?: {
+        logger?: Logger;
+        cache?: CacheService;
+        auth?: AuthService;
+        billing?: BillingService;
+    };
+    /** Authentication configuration */
+    auth: AuthConfig;
+    /** Security configuration */
+    security?: SecurityHeadersConfig & {
+        /** Security profile patterns for route-based security */
+        patterns?: SecurityPattern[];
+        /** Nested header settings; when present they replace the flat header fields above */
+        headers?: SecurityHeadersConfig;
+    };
+    /** User context enhancement */
+    context?: UserContextConfig;
+    /** Maintenance mode */
+    maintenance?: MaintenanceConfig;
+    /** Development mode for server error detail visibility */
+    developmentMode?: {
+        enabled?: boolean;
+        resolveEnabled?: () => boolean;
+        resolveWarningEnabled?: () => boolean;
+    };
+    /** Docs/OpenAPI dev tooling host facts */
+    docs?: {
+        /** Project root for the dev-only OpenAPI route-file scan and report */
+        projectRoot?: string;
+    };
+    /** Activity logging */
+    activity?: ActivityConfig;
+    /** User status routing (pending/active/suspended/banned) */
+    userStatus?: UserStatusRoutingConfig;
+    /** Referral attribution */
+    referral?: ReferralConfig;
+    /** Plugin configurations */
+    plugins?: PluginConfig[];
+    /** Convenience config for built-in plugins */
+    verification?: {
+        acme?: ACMEConfig;
+    };
+    hostname?: HostnameConfig;
+    /** Billing configuration */
+    billing?: {
+        canonicalTiers?: readonly string[];
+    };
+    /** Development mode flag */
+    isDev?: boolean;
+}
+/**
+ * ACME plugin configuration
+ */
+export interface ACMEConfig {
+    enabled: boolean;
+    getChallenge: (token: string) => Promise<string | null>;
+    onChallengeRequested?: (token: string, timestamp: Date) => void | Promise<void>;
+    onChallengeVerified?: (token: string, domain: string) => void | Promise<void>;
+}
+/**
+ * Hostname routing plugin configuration
+ */
+export interface HostnameConfig {
+    enabled: boolean;
+    resolveHostname: (hostname: string) => Promise<HostnameContext | null>;
+    pathPattern?: string;
+    onHostnameResolved?: (context: HostnameContext) => void | Promise<void>;
+}
+/**
+ * Hostname context injected into event.locals
+ */
+export interface HostnameContext {
+    domain: string;
+    projectId?: string | null;
+    projectSlug?: string;
+    projectName?: string;
+    ownerId?: string;
+    ownerType?: string;
+    deployTarget?: 'kubernetes' | 'cloudflare';
+    accountSlug?: string;
+    [key: string]: string | null | undefined;
+}

package/dist/lib/types/kit.js

@@ -0,0 +1,11 @@
+/**
+ * VibesKit interface and configuration types
+ */
+import * as z from 'zod/v4';
+/**
+ * Logger metadata: the structured fields of one log call, field name to value.
+ * Mirrors the runtime logger contract's `LogContextSchema` (kit imports no
+ * framework runtime): the injected logger normalizes, redacts and parses every
+ * field, so a field may carry any value.
+ */
+export const LoggerMetaSchema = z.record(z.string(), z.unknown());