@ploykit/ui 0.0.0-stage → 0.1.0

package/dist/hooks/useZodForm.d.ts

@@ -0,0 +1,6 @@
+import { type FieldValues, type UseFormProps, type UseFormReturn } from 'react-hook-form';
+import type { ZodSchema } from 'zod';
+export interface ZodFormOptions<T extends FieldValues> extends UseFormProps<T> {
+    schema: ZodSchema<T, T>;
+}
+export declare function useZodForm<T extends FieldValues>(opts: ZodFormOptions<T>): UseFormReturn<T>;

package/dist/hooks/useZodForm.js

@@ -0,0 +1,6 @@
+import { zodResolver } from '@hookform/resolvers/zod';
+import { useForm } from 'react-hook-form';
+export function useZodForm(opts) {
+    const { schema, ...rest } = opts;
+    return useForm({ ...rest, resolver: zodResolver(schema) });
+}

package/dist/hooks/ws.d.ts

@@ -0,0 +1,4 @@
+import type { FrameHandler, ScopePrefix, WsClient, WsStatus } from '@ploykit/client';
+export declare function useWsStatus(client: WsClient): WsStatus;
+export declare function useWsScope(prefix: ScopePrefix, id: string | undefined, client: WsClient): void;
+export declare function useWsFrame(type: string, handler: FrameHandler, client: WsClient): void;

package/dist/hooks/ws.js

@@ -0,0 +1,21 @@
+import { useEffect, useRef, useSyncExternalStore } from 'react';
+export function useWsStatus(client) {
+    return useSyncExternalStore((cb) => client.onStatus(cb), () => client.status, () => 'idle');
+}
+export function useWsScope(prefix, id, client) {
+    useEffect(() => {
+        if (!id)
+            return;
+        return client.subscribe(prefix, id);
+    }, [prefix, id, client]);
+}
+export function useWsFrame(type, handler, client) {
+    const ref = useRef(handler);
+    useEffect(() => {
+        ref.current = handler;
+    });
+    useEffect(() => {
+        const dispatch = (frame) => ref.current(frame);
+        return client.on(type, dispatch);
+    }, [type, client]);
+}

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+export { PloykitProvider, queryKeys } from './provider/PloykitProvider';
+export type { PKUser, PKWorkspace, PKSubscription, PKOrder, PKPlan } from './provider/PloykitProvider';
+export { useAuth } from './hooks/useAuth';
+export { useLogin } from './hooks/useLogin';
+export { useWorkspace, useWorkspaceSwitch } from './hooks/useWorkspace';
+export { useBilling, useUsagePreview, PlanGate } from './hooks/useBilling';
+export { useApi, ApiError } from './hooks/useApi';
+export type { ApiFetchOptions } from './hooks/useApi';
+export { useSEO } from './hooks/useSEO';
+export type { SeoMeta } from './hooks/useSEO';
+export { useWsStatus, useWsScope, useWsFrame } from './hooks/ws';
+export { createWsClient, defaultWsUrl } from './realtime';
+export { bridgeWsToQuery } from './lib/ws-query-bridge';
+export type { WsInvalidationRule } from './lib/ws-query-bridge';
+export { AppShell } from './layouts/AppShell';
+export type { NavItem } from './layouts/AppShell';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarProvider, SidebarTrigger, } from './components/ui/sidebar';
+export { Separator } from './components/ui/separator';
+export { Skeleton } from './components/ui/skeleton';
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from './components/ui/tooltip';
+export { Sheet, SheetContent, SheetHeader, SheetTitle, SheetDescription } from './components/ui/sheet';
+export { LoginPage } from './pages/LoginPage';
+export type { OAuthProviderOption, LoginPageProps } from './pages/LoginPage';
+export { LandingPage } from './pages/LandingPage';
+export type { Feature as LandingFeature, Plan as LandingPlan } from './pages/LandingPage';
+export { Button, buttonVariants } from './components/ui/Button';
+export type { ButtonProps } from './components/ui/Button';
+export { Input } from './components/ui/Input';
+export { Badge, badgeVariants, StatusBadge } from './components/ui/Badge';
+export { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, DialogClose, } from './components/ui/dialog';
+export { PageHeader, PageLoading, PageEmpty, PageError } from './components/Page';
+export { ConfirmProvider, useConfirm } from './components/ConfirmDialog';
+export { NotificationBell } from './components/NotificationBell';
+export { WorkspaceSwitcher } from './components/WorkspaceSwitcher';
+export { SecretModal, ImpactConfirmation } from './components/SecretModal';
+export { cn, statusTone, statusLabel, STATUS_TONE_CLASS, STATUS_LABEL, formatDate, formatDateTime, shortID } from './lib/utils';
+export type { StatusTone } from './lib/utils';
+export { roleSatisfies } from './lib/perm';
+export type { Perm } from './lib/perm';
+export { usePasswordReset } from './hooks/usePasswordReset';
+export { ForgotPasswordPage } from './pages/auth/ForgotPasswordPage';
+export type { ForgotPasswordPageProps } from './pages/auth/ForgotPasswordPage';
+export { ResetPasswordPage } from './pages/auth/ResetPasswordPage';
+export type { ResetPasswordPageProps } from './pages/auth/ResetPasswordPage';
+export { VerifyEmailPage } from './pages/auth/VerifyEmailPage';
+export { ErrorBoundary } from './components/ErrorBoundary';
+export type { ErrorBoundaryProps } from './components/ErrorBoundary';
+export { toast, Toaster } from './components/toast';
+export { useZodForm } from './hooks/useZodForm';
+export type { ZodFormOptions } from './hooks/useZodForm';
+export { FormField } from './components/FormField';
+export type { FormFieldProps } from './components/FormField';
+export { DataTable } from './components/DataTable';
+export type { Column, DataTableProps } from './components/DataTable';
+export { Field, FieldLabel, FieldDescription, FieldError, FieldGroup, FieldLegend, FieldSeparator, FieldSet, FieldContent, FieldTitle, } from './components/ui/field';
+export { Label } from './components/ui/label';
+export { Tabs, TabsList, TabsTrigger, TabsContent } from './components/ui/tabs';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, } from './components/ui/alert-dialog';
+export { Avatar, AvatarImage, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarBadge, } from './components/ui/avatar';
+export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, } from './components/ui/menu';
+export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, } from './components/ui/select';
+export { Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, } from './components/ui/popover';
+export { Switch } from './components/ui/switch';
+export { Progress, ProgressTrack, ProgressIndicator, ProgressLabel, ProgressValue, } from './components/ui/progress';
+export { Checkbox } from './components/ui/checkbox';
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent, } from './components/ui/card';
+export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, } from './components/ui/breadcrumb';
+export { Empty, EmptyHeader, EmptyTitle, EmptyDescription, EmptyContent, EmptyMedia, EmptyFooter, } from './components/ui/empty';
+export { SettingsShell } from './layouts/SettingsShell';
+export type { SettingsNavItem, SettingsNavGroup, SettingsShellProps } from './layouts/SettingsShell';
+export { AuthShell } from './layouts/AuthShell';
+export type { AuthShellProps } from './layouts/AuthShell';
+export { SettingsCard } from './components/SettingsCard';
+export type { SettingsCardProps } from './components/SettingsCard';
+export { UserMenu } from './components/UserMenu';
+export { OnboardingChecklist } from './components/OnboardingChecklist';
+export { RegisterPage } from './pages/auth/RegisterPage';
+export type { RegisterPageProps } from './pages/auth/RegisterPage';
+export { InviteAcceptPage } from './pages/auth/InviteAcceptPage';
+export { ProfileSettingsPage } from './pages/account/ProfileSettingsPage';
+export type { ProfileSettingsPageProps } from './pages/account/ProfileSettingsPage';
+export { SecuritySettingsPage } from './pages/account/SecuritySettingsPage';
+export { TokensPage } from './pages/account/TokensPage';
+export { NotificationPreferencesPage } from './pages/account/NotificationPreferencesPage';
+export type { NotificationPreferencesPageProps, NotificationTypeMeta } from './pages/account/NotificationPreferencesPage';
+export { MembersPage } from './pages/workspace/MembersPage';
+export { WorkspaceGeneralPage } from './pages/workspace/WorkspaceGeneralPage';
+export { WorkspaceAuditPage } from './pages/workspace/WorkspaceAuditPage';
+export { UsagePage } from './pages/workspace/UsagePage';
+export { BillingPage } from './pages/workspace/BillingPage';
+export { BillingSuccessPage } from './pages/workspace/BillingSuccessPage';
+export { WebhooksPage } from './pages/workspace/WebhooksPage';
+export { useSessions, useRevokeSession, useRevokeAllSessions } from './hooks/useSessions';
+export type { SessionInfo } from './hooks/useSessions';
+export { useTokens, useCreateToken, useRevokeToken } from './hooks/useTokens';
+export type { PAT, CreatePATResult } from './hooks/useTokens';
+export { useNotificationPrefs, useSetNotificationPref } from './hooks/useNotificationPrefs';
+export type { NotificationPreference } from './hooks/useNotificationPrefs';
+export { useMembers, useMemberMutations, useMyInvitations, ASSIGNABLE_ROLES } from './hooks/useMembers';
+export type { PKMember, PKInvitation, PKShareLink, PKInvitationWithWorkspace, CreateShareLinkResult, } from './hooks/useMembers';
+export { useAudit, exportAuditCsv, auditQueryString, EMPTY_AUDIT_FILTERS } from './hooks/useAudit';
+export type { AuditFilters, PKAuditEvent } from './hooks/useAudit';
+export { useUsage } from './hooks/useUsage';
+export type { PKUsageResp, PKUsageItem } from './hooks/useUsage';
+export { apiErrorMessage } from './lib/api-error';
+export { CronInput } from './components/CronInput';
+export { SchedulesPage } from './pages/workspace/SchedulesPage';
+export { SiteBanner } from './components/SiteBanner';
+export { SiteBannerLayer } from './components/SiteBannerLayer';
+export type { SiteBannerLayerProps } from './components/SiteBannerLayer';
+export { useSiteConfig, SITE_CONFIG_QUERY_KEY } from './hooks/useSiteConfig';
+export type { SiteConfig } from './hooks/useSiteConfig';
+export { ImpersonationBanner } from './components/ImpersonationBanner';
+export { AdminShell } from './pages/admin/AdminShell';
+export { OverviewPage } from './pages/admin/OverviewPage';
+export { UsersPage } from './pages/admin/UsersPage';
+export { UserDetailPage } from './pages/admin/UserDetailPage';
+export { WorkspacesPage } from './pages/admin/WorkspacesPage';
+export { WorkspaceDetailPage } from './pages/admin/WorkspaceDetailPage';
+export { OrdersPage } from './pages/admin/OrdersPage';
+export { WebhookDeliveriesPage } from './pages/admin/WebhookDeliveriesPage';
+export { AuditPage } from './pages/admin/AuditPage';
+export { SSOPage } from './pages/admin/SSOPage';
+export { AdminSettingsPage } from './pages/admin/AdminSettingsPage';

package/dist/index.js

@@ -0,0 +1,94 @@
+export { PloykitProvider, queryKeys } from './provider/PloykitProvider';
+export { useAuth } from './hooks/useAuth';
+export { useLogin } from './hooks/useLogin';
+export { useWorkspace, useWorkspaceSwitch } from './hooks/useWorkspace';
+export { useBilling, useUsagePreview, PlanGate } from './hooks/useBilling';
+export { useApi, ApiError } from './hooks/useApi';
+export { useSEO } from './hooks/useSEO';
+export { useWsStatus, useWsScope, useWsFrame } from './hooks/ws';
+export { createWsClient, defaultWsUrl } from './realtime';
+export { bridgeWsToQuery } from './lib/ws-query-bridge';
+export { AppShell } from './layouts/AppShell';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarProvider, SidebarTrigger, } from './components/ui/sidebar';
+export { Separator } from './components/ui/separator';
+export { Skeleton } from './components/ui/skeleton';
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from './components/ui/tooltip';
+export { Sheet, SheetContent, SheetHeader, SheetTitle, SheetDescription } from './components/ui/sheet';
+export { LoginPage } from './pages/LoginPage';
+export { LandingPage } from './pages/LandingPage';
+export { Button, buttonVariants } from './components/ui/Button';
+export { Input } from './components/ui/Input';
+export { Badge, badgeVariants, StatusBadge } from './components/ui/Badge';
+export { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, DialogClose, } from './components/ui/dialog';
+export { PageHeader, PageLoading, PageEmpty, PageError } from './components/Page';
+export { ConfirmProvider, useConfirm } from './components/ConfirmDialog';
+export { NotificationBell } from './components/NotificationBell';
+export { WorkspaceSwitcher } from './components/WorkspaceSwitcher';
+export { SecretModal, ImpactConfirmation } from './components/SecretModal';
+export { cn, statusTone, statusLabel, STATUS_TONE_CLASS, STATUS_LABEL, formatDate, formatDateTime, shortID } from './lib/utils';
+export { roleSatisfies } from './lib/perm';
+export { usePasswordReset } from './hooks/usePasswordReset';
+export { ForgotPasswordPage } from './pages/auth/ForgotPasswordPage';
+export { ResetPasswordPage } from './pages/auth/ResetPasswordPage';
+export { VerifyEmailPage } from './pages/auth/VerifyEmailPage';
+export { ErrorBoundary } from './components/ErrorBoundary';
+export { toast, Toaster } from './components/toast';
+export { useZodForm } from './hooks/useZodForm';
+export { FormField } from './components/FormField';
+export { DataTable } from './components/DataTable';
+export { Field, FieldLabel, FieldDescription, FieldError, FieldGroup, FieldLegend, FieldSeparator, FieldSet, FieldContent, FieldTitle, } from './components/ui/field';
+export { Label } from './components/ui/label';
+export { Tabs, TabsList, TabsTrigger, TabsContent } from './components/ui/tabs';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, } from './components/ui/alert-dialog';
+export { Avatar, AvatarImage, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarBadge, } from './components/ui/avatar';
+export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, } from './components/ui/menu';
+export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, } from './components/ui/select';
+export { Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, } from './components/ui/popover';
+export { Switch } from './components/ui/switch';
+export { Progress, ProgressTrack, ProgressIndicator, ProgressLabel, ProgressValue, } from './components/ui/progress';
+export { Checkbox } from './components/ui/checkbox';
+export { Card, CardHeader, CardFooter, CardTitle, CardAction, CardDescription, CardContent, } from './components/ui/card';
+export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, } from './components/ui/breadcrumb';
+export { Empty, EmptyHeader, EmptyTitle, EmptyDescription, EmptyContent, EmptyMedia, EmptyFooter, } from './components/ui/empty';
+export { SettingsShell } from './layouts/SettingsShell';
+export { AuthShell } from './layouts/AuthShell';
+export { SettingsCard } from './components/SettingsCard';
+export { UserMenu } from './components/UserMenu';
+export { OnboardingChecklist } from './components/OnboardingChecklist';
+export { RegisterPage } from './pages/auth/RegisterPage';
+export { InviteAcceptPage } from './pages/auth/InviteAcceptPage';
+export { ProfileSettingsPage } from './pages/account/ProfileSettingsPage';
+export { SecuritySettingsPage } from './pages/account/SecuritySettingsPage';
+export { TokensPage } from './pages/account/TokensPage';
+export { NotificationPreferencesPage } from './pages/account/NotificationPreferencesPage';
+export { MembersPage } from './pages/workspace/MembersPage';
+export { WorkspaceGeneralPage } from './pages/workspace/WorkspaceGeneralPage';
+export { WorkspaceAuditPage } from './pages/workspace/WorkspaceAuditPage';
+export { UsagePage } from './pages/workspace/UsagePage';
+export { BillingPage } from './pages/workspace/BillingPage';
+export { BillingSuccessPage } from './pages/workspace/BillingSuccessPage';
+export { WebhooksPage } from './pages/workspace/WebhooksPage';
+export { useSessions, useRevokeSession, useRevokeAllSessions } from './hooks/useSessions';
+export { useTokens, useCreateToken, useRevokeToken } from './hooks/useTokens';
+export { useNotificationPrefs, useSetNotificationPref } from './hooks/useNotificationPrefs';
+export { useMembers, useMemberMutations, useMyInvitations, ASSIGNABLE_ROLES } from './hooks/useMembers';
+export { useAudit, exportAuditCsv, auditQueryString, EMPTY_AUDIT_FILTERS } from './hooks/useAudit';
+export { useUsage } from './hooks/useUsage';
+export { apiErrorMessage } from './lib/api-error';
+export { CronInput } from './components/CronInput';
+export { SchedulesPage } from './pages/workspace/SchedulesPage';
+export { SiteBanner } from './components/SiteBanner';
+export { SiteBannerLayer } from './components/SiteBannerLayer';
+export { useSiteConfig, SITE_CONFIG_QUERY_KEY } from './hooks/useSiteConfig';
+export { ImpersonationBanner } from './components/ImpersonationBanner';
+export { AdminShell } from './pages/admin/AdminShell';
+export { OverviewPage } from './pages/admin/OverviewPage';
+export { UsersPage } from './pages/admin/UsersPage';
+export { UserDetailPage } from './pages/admin/UserDetailPage';
+export { WorkspacesPage } from './pages/admin/WorkspacesPage';
+export { WorkspaceDetailPage } from './pages/admin/WorkspaceDetailPage';
+export { OrdersPage } from './pages/admin/OrdersPage';
+export { WebhookDeliveriesPage } from './pages/admin/WebhookDeliveriesPage';
+export { AuditPage } from './pages/admin/AuditPage';
+export { SSOPage } from './pages/admin/SSOPage';
+export { AdminSettingsPage } from './pages/admin/AdminSettingsPage';

package/dist/layouts/AppShell.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+export interface NavItem {
+    path: string;
+    label: string;
+    icon?: ReactNode;
+}
+export declare function AppShell({ children, nav, brand, logo, logoDark, sidebarFooter, headerRight, breadcrumbTail, settingsContent }: {
+    children: ReactNode;
+    nav?: NavItem[];
+    brand?: string;
+    /** 品牌图形（sidebar 顶栏，方形 mark 最佳，h-7 宽自适应）；与 brand 文字横排。 */
+    logo?: string;
+    /** 暗色变体，经 prefers-color-scheme 切换——仅当应用主题跟随系统时才传；
+     *  固定亮色主题的应用不要传（否则深色系统的用户会在亮底上拿到暗色变体）。 */
+    logoDark?: string;
+    sidebarFooter?: ReactNode;
+    headerRight?: ReactNode;
+    breadcrumbTail?: string | null;
+    settingsContent?: ReactNode;
+}): import("react").JSX.Element;

package/dist/layouts/AppShell.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useLocation, useNavigate } from 'react-router';
+import { FolderKanban } from 'lucide-react';
+import { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupContent, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarProvider, SidebarTrigger, } from '../components/ui/sidebar';
+import { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbPage, BreadcrumbSeparator, } from '../components/ui/breadcrumb';
+import { UserMenu } from '../components/UserMenu';
+import { ImpersonationBanner } from '../components/ImpersonationBanner';
+export function AppShell({ children, nav, brand, logo, logoDark, sidebarFooter, headerRight, breadcrumbTail = null, settingsContent }) {
+    const location = useLocation();
+    const navigate = useNavigate();
+    const items = nav ?? [
+        { path: '/app', label: '概览', icon: _jsx(FolderKanban, { size: 17, "aria-hidden": "true" }) },
+    ];
+    const selected = items.find((item) => location.pathname.startsWith(item.path));
+    const isSettingsMode = settingsContent !== undefined &&
+        (location.pathname.startsWith('/settings') || location.pathname.startsWith('/account'));
+    return (_jsxs(SidebarProvider, { children: [_jsxs(Sidebar, { collapsible: "icon", children: [_jsx(SidebarHeader, { children: _jsxs("div", { className: "flex items-center gap-2 px-2 pb-1 pt-1 group-data-[collapsible=icon]:justify-center", children: [logo && (_jsxs("picture", { children: [_jsx("source", { media: "(prefers-color-scheme: dark)", srcSet: logoDark ?? logo }), _jsx("img", { src: logo, alt: `${brand ?? 'App'} logo`, className: "h-7 w-auto group-data-[collapsible=icon]:w-7 group-data-[collapsible=icon]:object-contain" })] })), _jsx("div", { className: "text-lg font-bold text-foreground group-data-[collapsible=icon]:hidden", children: brand ?? 'App' })] }) }), _jsx(SidebarContent, { children: isSettingsMode ? (settingsContent) : (_jsx(SidebarGroup, { children: _jsx(SidebarGroupContent, { children: _jsx(SidebarMenu, { children: items.map((item) => {
+                                        const active = selected?.path === item.path;
+                                        return (_jsx(SidebarMenuItem, { children: _jsxs(SidebarMenuButton, { isActive: active, "aria-current": active ? 'page' : undefined, tooltip: item.label, onClick: () => navigate(item.path), children: [item.icon, _jsx("span", { className: "truncate", children: item.label })] }) }, item.path));
+                                    }) }) }) })) }), _jsx(SidebarFooter, { className: "group-data-[collapsible=icon]:hidden", children: sidebarFooter })] }), _jsxs(SidebarInset, { children: [_jsx(ImpersonationBanner, {}), _jsxs("header", { className: "flex h-14 shrink-0 items-center gap-3 border-b border-border bg-background px-4", children: [_jsx(SidebarTrigger, {}), breadcrumbTail !== null ? (_jsx(Breadcrumb, { children: _jsxs(BreadcrumbList, { children: [selected && (_jsxs(_Fragment, { children: [_jsx(BreadcrumbItem, { children: _jsx(BreadcrumbPage, { children: selected.label }) }), _jsx(BreadcrumbSeparator, {})] })), _jsx(BreadcrumbItem, { children: _jsx(BreadcrumbPage, { children: breadcrumbTail }) })] }) })) : null, _jsx("div", { className: "flex-1" }), headerRight, _jsx(UserMenu, {})] }), _jsx("div", { className: "flex-1 overflow-auto p-6", children: children })] })] }));
+}

package/dist/layouts/AuthShell.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from 'react';
+export interface AuthShellProps {
+    children: ReactNode;
+    brand?: ReactNode;
+    footer?: ReactNode;
+}
+export declare function AuthShell({ children, brand, footer }: AuthShellProps): import("react").JSX.Element;

package/dist/layouts/AuthShell.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function AuthShell({ children, brand, footer }) {
+    return (_jsx("div", { className: "flex min-h-svh w-full items-center justify-center bg-background p-6 md:p-10", children: _jsxs("div", { className: "w-full max-w-sm", children: [brand && _jsx("div", { className: "mb-6 flex flex-col items-center gap-2 text-center", children: brand }), children, footer && (_jsx("div", { className: "mt-6 text-center text-xs text-muted-foreground", children: footer }))] }) }));
+}

package/dist/layouts/SettingsShell.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import { type Perm } from '../lib/perm';
+export interface SettingsNavItem {
+    path: string;
+    label: string;
+    icon?: ReactNode;
+    perm?: Perm;
+}
+export interface SettingsNavGroup {
+    group: string;
+    items: SettingsNavItem[];
+}
+export interface SettingsShellProps {
+    nav?: SettingsNavGroup[];
+    children: ReactNode;
+    title?: string;
+    description?: string;
+}
+export declare function SettingsShell({ nav, children, title, description }: SettingsShellProps): import("react").JSX.Element;

package/dist/layouts/SettingsShell.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Link, useLocation, useNavigate } from 'react-router';
+import { cn } from '../lib/utils';
+import { roleSatisfies } from '../lib/perm';
+import { useWorkspace } from '../hooks/useWorkspace';
+import { buttonVariants } from '../components/ui/Button';
+import { Separator } from '../components/ui/separator';
+import { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectTrigger, SelectValue, } from '../components/ui/select';
+export function SettingsShell({ nav, children, title = '设置', description }) {
+    const location = useLocation();
+    const navigate = useNavigate();
+    const role = useWorkspace().current?.role;
+    const isActive = (path) => location.pathname === path || location.pathname.startsWith(path + '/');
+    const visibleNav = (nav ?? [])
+        .map((g) => ({ ...g, items: g.items.filter((i) => roleSatisfies(role, i.perm)) }))
+        .filter((g) => g.items.length > 0);
+    const flatItems = visibleNav.flatMap((g) => g.items);
+    const activeItem = flatItems.find((i) => isActive(i.path));
+    const hasNav = visibleNav.length > 0;
+    return (_jsxs("div", { className: "mx-auto w-full max-w-6xl", children: [_jsxs("div", { children: [_jsx("div", { className: "text-2xl md:text-3xl font-bold tracking-tight", children: title }), description && _jsx("p", { className: "mt-1 text-base text-muted-foreground", children: description })] }), _jsx(Separator, { className: "my-4 lg:my-6" }), _jsxs("div", { className: cn('flex flex-col gap-6', hasNav && 'lg:flex-row lg:gap-0 lg:space-x-12'), children: [hasNav && (_jsx("div", { className: "lg:hidden", children: _jsxs(Select, { value: activeItem?.path ?? null, onValueChange: (v) => typeof v === 'string' && v && navigate(v), children: [_jsx(SelectTrigger, { className: "w-full", "aria-label": "\u8BBE\u7F6E\u5BFC\u822A", children: _jsx(SelectValue, { children: activeItem?.label ?? '跳转设置页' }) }), _jsx(SelectContent, { align: "start", children: visibleNav.map((group) => (_jsxs(SelectGroup, { children: [_jsx(SelectLabel, { children: group.group }), group.items.map((item) => (_jsx(SelectItem, { value: item.path, children: item.label }, item.path)))] }, group.group))) })] }) })), hasNav && (_jsx("aside", { className: "hidden lg:block lg:w-1/5 lg:self-start lg:sticky lg:top-0", children: _jsx("nav", { "aria-label": "\u8BBE\u7F6E\u5BFC\u822A", children: visibleNav.map((group) => (_jsxs("div", { className: "mb-6", children: [_jsx("p", { className: "mb-2 px-2 text-xs uppercase tracking-wider text-muted-foreground", children: group.group }), _jsx("ul", { className: "space-y-1", children: group.items.map((item) => (_jsx("li", { children: _jsxs(Link, { to: item.path, "aria-current": isActive(item.path) ? 'page' : undefined, className: cn(buttonVariants({ variant: 'ghost' }), 'w-full justify-start', isActive(item.path) && 'bg-muted'), children: [item.icon, item.label] }) }, item.path))) })] }, group.group))) }) })), _jsx("div", { className: "min-w-0 flex-1", children: children })] })] }));
+}

package/dist/lib/api-error.d.ts

@@ -0,0 +1 @@
+export declare function apiErrorMessage(err: unknown, fallback?: string): string;

package/dist/lib/api-error.js

@@ -0,0 +1,74 @@
+import { ApiError } from '@ploykit/client';
+const KNOWN_MESSAGES = {
+    'invalid credentials': '邮箱或密码不正确，请检查后重试',
+    'current password incorrect': '当前密码不正确，请确认后重新输入',
+    '当前密码不正确，请确认后重新输入': '当前密码不正确，请确认后重新输入',
+    '新密码不能与当前密码相同': '新密码不能与当前密码相同，请换一个新密码',
+    'email already registered': '该邮箱已注册，可直接登录或换个邮箱重试',
+    'slug already taken': '该标识已被占用，请换个工作区名称重试',
+    'already a member': '该用户已是本工作区成员，无需重复邀请',
+    'invitation already pending': '该邮箱已有一封待处理的邀请，可先撤销旧邀请再重发',
+    'target is already an owner': '对方已是所有者，无需重复转让所有权',
+    'name required (<=64 chars)': '名称不能为空，且不超过 64 字节（约 21 个汉字）',
+    'name required': '名称不能为空',
+};
+const KNOWN_MESSAGE_PREFIXES = [
+    ['slug must be', '标识格式有误：需 4-40 位小写字母、数字或连字符（-），且不能以连字符开头或结尾'],
+    ['last owner cannot leave', '最后一个所有者不能离开工作区，请先转移所有权或删除工作区'],
+    ['avatar_url must be', '头像链接格式有误：需以 http(s) 开头且不超过 2048 字符'],
+    ['workspace cannot be deleted', '工作区暂时无法删除：存在未满足的前置条件（如未完结订单或活跃资源），请先处理后再试'],
+    ['egress:', '回调地址不可达私网/被安全策略拦截，请改用公网 https 地址'],
+    ['egressx:', '回调地址不可达私网/被安全策略拦截，请改用公网 https 地址'],
+];
+const KNOWN_CODES = {
+    E_QUOTA_EXCEEDED: '配额已用尽，可在 设置→计费 升级套餐后重试',
+    E_TIMEOUT: '请求超时，网络可能较慢，请稍后重试',
+    E_ABORTED: '请求已取消',
+    E_CHANNEL_TEST_UNSUPPORTED: '该支付渠道不支持测试连接（manual 渠道无外部端点可探测）',
+    E_MALFORMED_RESPONSE: '服务返回了无法识别的响应，请稍后重试；若持续出现请联系平台管理员',
+    E_VALIDATION: '请求参数有误，请检查填写内容后重试',
+    E_INVALID_CRON: 'Cron 表达式格式有误（应为 5 段：分 时 日 月 周），请检查后重试',
+    E_INVALID_TZ: '时区无效，请填写 IANA 时区名（如 Asia/Shanghai）',
+    E_CONFLICT: '操作与当前状态冲突，请刷新页面查看最新状态后再试',
+};
+function detailsText(details) {
+    return typeof details === 'string' && details.trim() !== '' ? details.trim() : undefined;
+}
+function knownMessage(message) {
+    const normalized = message.trim().toLowerCase();
+    const exact = KNOWN_MESSAGES[normalized];
+    if (exact)
+        return exact;
+    return KNOWN_MESSAGE_PREFIXES.find(([prefix]) => normalized.startsWith(prefix))?.[1];
+}
+export function apiErrorMessage(err, fallback = '操作失败') {
+    if (err instanceof ApiError) {
+        const byMessage = knownMessage(err.message);
+        if (byMessage)
+            return byMessage;
+        const details = detailsText(err.details);
+        if (details)
+            return details;
+        if (err.code && KNOWN_CODES[err.code])
+            return KNOWN_CODES[err.code];
+        if (err.status === 402) {
+            return '当前套餐不支持此操作。可在 设置→计费 升级套餐';
+        }
+        if (err.status === 401)
+            return '登录已过期或未登录，请重新登录后再试';
+        if (err.status === 429) {
+            const wait = err.retryAfter !== undefined && err.retryAfter > 0 ? `（约 ${err.retryAfter} 秒后可重试）` : '';
+            return `请求过于频繁，请稍后再试${wait}`;
+        }
+        if (err.status >= 500)
+            return '服务暂时不可用，请稍后重试；若持续出现请联系平台管理员';
+        if (err.status === 404)
+            return '不存在或无权访问';
+        if (err.status === 403)
+            return '权限不足' + (err.message && err.message !== 'forbidden' ? `：${err.message}` : '');
+        return err.message || fallback;
+    }
+    if (err instanceof TypeError)
+        return '网络连接失败，请检查网络后重试';
+    return err instanceof Error && err.message ? err.message : fallback;
+}

package/dist/lib/perm.d.ts

@@ -0,0 +1,2 @@
+export type Perm = 'admin' | 'owner';
+export declare function roleSatisfies(role: string | undefined, perm?: Perm): boolean;

package/dist/lib/perm.js

@@ -0,0 +1,7 @@
+export function roleSatisfies(role, perm) {
+    if (perm === undefined)
+        return true;
+    if (perm === 'owner')
+        return role === 'owner';
+    return role === 'owner' || role === 'admin';
+}

package/dist/lib/utils.d.ts

@@ -0,0 +1,12 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;
+export type StatusTone = 'positive' | 'critical' | 'warning' | 'neutral' | 'brand';
+export declare const STATUS_TONE_CLASS: Record<StatusTone, string>;
+export declare function statusTone(status: string): StatusTone;
+export declare const STATUS_LABEL: Record<string, string>;
+export declare function statusLabel(status: string): string;
+export declare function formatDate(iso: string): string;
+export declare function formatDateTime(iso: string): string;
+export declare function browserTzLabel(): string;
+export declare function formatDateTimeTz(iso: string): string;
+export declare function shortID(id: string, len?: number): string;

package/dist/lib/utils.js

@@ -0,0 +1,84 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+export const STATUS_TONE_CLASS = {
+    positive: 'bg-(--success)/10 text-(--success) border-(--success)/30',
+    critical: 'bg-(--destructive)/10 text-(--destructive) border-(--destructive)/30',
+    warning: 'bg-(--warning)/15 text-(--warning) border-(--warning)/40',
+    neutral: 'bg-muted text-muted-foreground border-border',
+    brand: 'bg-primary/10 text-primary border-primary/20',
+};
+export function statusTone(status) {
+    const s = status.toLowerCase();
+    if (['active', 'paid', 'delivered', 'completed', 'success', 'running', 'entitled', 'done'].includes(s))
+        return 'positive';
+    if (['failed', 'dead', 'error', 'disabled', 'canceled', 'expired', 'removed'].includes(s))
+        return 'critical';
+    if (['pending', 'warned', 'suspended', 'retrying'].includes(s))
+        return 'warning';
+    if (['owner', 'admin', 'pro', 'recommended'].includes(s))
+        return 'brand';
+    return 'neutral';
+}
+export const STATUS_LABEL = {
+    pending: '待处理',
+    accepted: '已接受',
+    declined: '已拒绝',
+    revoked: '已撤销',
+    expired: '已过期',
+    redeemed: '已兑换',
+    paid: '已支付',
+    canceled: '已取消',
+    active: '生效中',
+    inactive: '未启用',
+    enabled: '已启用',
+    disabled: '已禁用',
+    delivered: '已投递',
+    failed: '失败',
+    retrying: '重试中',
+    completed: '已完成',
+    done: '已完成',
+    running: '运行中',
+    success: '成功',
+    error: '错误',
+    dead: '死信/投递失败',
+    warned: '已警告',
+    suspended: '已暂停',
+    removed: '已移除',
+    entitled: '已生效',
+    refunded: '已退款',
+};
+export function statusLabel(status) {
+    return STATUS_LABEL[status.toLowerCase()] ?? status;
+}
+export function formatDate(iso) {
+    return new Date(iso).toLocaleDateString('zh-CN', { year: 'numeric', month: '2-digit', day: '2-digit' });
+}
+export function formatDateTime(iso) {
+    return new Date(iso).toLocaleString('zh-CN', {
+        year: 'numeric', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', hour12: false,
+    });
+}
+export function browserTzLabel() {
+    for (const nameType of ['shortOffset', 'short']) {
+        try {
+            const opts = { timeZoneName: nameType };
+            const parts = new Intl.DateTimeFormat('en-US', opts).formatToParts(new Date());
+            const label = parts.find((p) => p.type === 'timeZoneName')?.value;
+            if (label)
+                return label;
+        }
+        catch {
+            // 试下一档兜底
+        }
+    }
+    return '本地时区';
+}
+export function formatDateTimeTz(iso) {
+    return `${formatDateTime(iso)} (${browserTzLabel()})`;
+}
+export function shortID(id, len = 8) {
+    return id.slice(0, len);
+}

package/dist/lib/ws-query-bridge.d.ts

@@ -0,0 +1,7 @@
+import type { QueryClient, QueryKey } from '@tanstack/react-query';
+import type { WsClient } from '@ploykit/client';
+export interface WsInvalidationRule {
+    match: string | RegExp;
+    invalidate: readonly QueryKey[];
+}
+export declare function bridgeWsToQuery(ws: WsClient, queryClient: QueryClient, rules: readonly WsInvalidationRule[]): () => void;

package/dist/lib/ws-query-bridge.js

@@ -0,0 +1,35 @@
+function ruleMatches(rule, type) {
+    if (typeof rule.match === 'string')
+        return rule.match === type;
+    rule.match.lastIndex = 0;
+    return rule.match.test(type);
+}
+export function bridgeWsToQuery(ws, queryClient, rules) {
+    let sawOpen = false;
+    const offStatus = ws.onStatus((status) => {
+        if (status !== 'open')
+            return;
+        if (!sawOpen) {
+            sawOpen = true;
+            return;
+        }
+        for (const rule of rules) {
+            for (const key of rule.invalidate) {
+                queryClient.invalidateQueries({ queryKey: key });
+            }
+        }
+    });
+    const offFrame = ws.on('*', (frame) => {
+        for (const rule of rules) {
+            if (!ruleMatches(rule, frame.type))
+                continue;
+            for (const key of rule.invalidate) {
+                queryClient.invalidateQueries({ queryKey: key });
+            }
+        }
+    });
+    return () => {
+        offStatus();
+        offFrame();
+    };
+}