@termix-ssh/plugin-sdk 1.0.2 → 1.0.5

package/dist/host/core-classes.json

@@ -0,0 +1 @@
+["!max-h-[60px]","!mt-0","!opacity-100","!running","**:data-[slot=kbd]:isolate","**:data-[slot=kbd]:relative","**:data-[slot=kbd]:rounded-none","**:data-[slot=kbd]:z-50","*:[a]:hover:text-foreground","*:[a]:underline","*:[a]:underline-offset-3","*:[img:first-child]:rounded-none","*:[img:last-child]:rounded-none","*:[span]:last:flex","*:[span]:last:gap-2","*:[span]:last:items-center","*:data-[slot=alert-description]:text-destructive/90","*:data-[slot=select-value]:flex","*:data-[slot=select-value]:gap-2","*:data-[slot=select-value]:items-center","*:data-[slot=select-value]:line-clamp-1","-bottom-1.5","-left-1.5","-left-px","-mt-0.5","-mt-1","-mt-[3.5px]","-mx-1","-mx-3","-my-1","-right-1.5","-right-2","-right-2.5","-right-px","-top-1.5","-top-[3px]","-translate-x-1/2","-translate-x-px","-translate-y-1/2","2xl:flex","2xl:grid-cols-4","3","@container","@container/card-header","@md:grid-cols-2","[&::-webkit-inner-spin-button]:appearance-none","[&::-webkit-outer-spin-button]:appearance-none","[&::-webkit-scrollbar]:hidden","[&>*:last-child]:border-b-0","[&>*]:h-full","[&>*]:shrink-0","[&>button]:hidden","[&>span:last-child]:truncate","[&>svg]:pointer-events-none","[&>svg]:shrink-0","[&>svg]:size-3","[&>svg]:size-4","[&>svg]:text-current","[&>svg]:text-sidebar-accent-foreground","[&>svg]:translate-y-0.5","[&_[cmdk-group-heading]]:font-medium","[&_[cmdk-group-heading]]:px-2","[&_[cmdk-group-heading]]:py-1.5","[&_[cmdk-group-heading]]:text-muted-foreground","[&_[cmdk-group-heading]]:text-xs","[&_[cmdk-list-sizer]]:flex","[&_[cmdk-list-sizer]]:flex-col","[&_p]:leading-relaxed","[&_svg:not([class*='size-'])]:size-3","[&_svg:not([class*='size-'])]:size-3.5","[&_svg:not([class*='size-'])]:size-4","[&_svg:not([class*='text-'])]:text-muted-foreground","[&_svg]:pointer-events-none","[&_svg]:shrink-0","[&_svg]:size-2.5","[&_svg]:size-3","[&_svg]:size-3.5","[&_svg]:size-4","[.border-b]:pb-4","[.gap-4>&]:border-0","[.gap-4>&]:py-0","[@media(hover:none)]:flex","[[data-side=left][data-collapsible=offcanvas]_&]:-right-2","[[data-side=left][data-state=collapsed]_&]:cursor-e-resize","[[data-side=right][data-collapsible=offcanvas]_&]:-left-2","[[data-side=right][data-state=collapsed]_&]:cursor-w-resize","[a&]:hover:bg-accent","[a&]:hover:bg-destructive/90","[a&]:hover:bg-primary/90","[a&]:hover:bg-secondary/90","[a&]:hover:text-accent-foreground","[a]:hover:bg-primary/80","[animation-duration:900ms]","[appearance:textfield]","[backend:stderr]","[clip-path:inset(0px_-4px_-4px_-4px)]","[contain:content]","[op:http_server_port_conflict]","[scrollbar-width:none]","absolute","accent-[var(--accent-brand)]","active:bg-muted","active:bg-muted/60","active:bg-sidebar-accent","active:cursor-grabbing","active:not-aria-[haspopup]:translate-y-px","active:text-sidebar-accent-foreground","after:-inset-2","after:absolute","after:inset-y-0","after:start-1/2","after:w-[2px]","animate-pulse","animate-spin","appearance-none","aria-disabled:opacity-50","aria-disabled:pointer-events-none","aria-expanded:bg-muted","aria-expanded:bg-secondary","aria-expanded:opacity-100","aria-expanded:text-foreground","aria-expanded:text-secondary-foreground","aria-invalid:border-destructive","aria-invalid:ring-1","aria-invalid:ring-destructive/20","aspect-square","aspect-video","auto-cols-fr","auto-rows-fr","auto-rows-min","before:-top-0.5","before:-top-px","before:absolute","before:bg-accent-brand","before:h-0.5","before:inset-x-0","before:inset-x-1","before:z-20","bg-accent-brand","bg-accent-brand/10","bg-accent-brand/15","bg-accent-brand/20","bg-accent-brand/25","bg-accent-brand/40","bg-accent-brand/5","bg-accent-brand/60","bg-accent-brand/70","bg-accent-brand/[0.07]","bg-accent/30","bg-accent/60","bg-background","bg-background/50","bg-background/60","bg-background/70","bg-background/85","bg-background/90","bg-black","bg-black/10","bg-blue-500/20","bg-border","bg-border/60","bg-canvas","bg-card","bg-clip-padding","bg-destructive","bg-destructive/10","bg-destructive/15","bg-destructive/5","bg-destructive/70","bg-emerald-500","bg-emerald-500/10","bg-foreground","bg-green-500","bg-green-500/10","bg-green-500/70","bg-input","bg-muted","bg-muted-foreground","bg-muted-foreground/15","bg-muted-foreground/20","bg-muted-foreground/25","bg-muted-foreground/30","bg-muted-foreground/40","bg-muted-foreground/50","bg-muted/10","bg-muted/15","bg-muted/20","bg-muted/30","bg-muted/40","bg-muted/50","bg-muted/60","bg-muted/70","bg-muted/[0.08]","bg-overlay","bg-popover","bg-primary","bg-red-400","bg-red-500","bg-red-500/10","bg-red-500/40","bg-secondary","bg-sidebar","bg-sidebar-border","bg-surface","bg-surface-dim/40","bg-surface-dim/60","bg-surface/40","bg-transparent","bg-warning","bg-warning/10","bg-warning/20","bg-warning/40","bg-warning/5","bg-warning/70","block","blur","border","border-0","border-2","border-accent-brand","border-accent-brand/20","border-accent-brand/30","border-accent-brand/40","border-accent-brand/50","border-accent-brand/60","border-accent-brand/70","border-b","border-b-2","border-b-accent-brand","border-border","border-border/30","border-border/40","border-border/50","border-border/60","border-current","border-dashed","border-destructive","border-destructive/20","border-destructive/30","border-destructive/40","border-destructive/50","border-emerald-500/40","border-foreground","border-foreground/10","border-green-500/30","border-green-500/40","border-input","border-l","border-l-2","border-l-transparent","border-muted-foreground/30","border-primary","border-r","border-red-500/40","border-sidebar-border","border-t","border-t-0","border-t-border/40","border-t-muted-foreground/70","border-t-transparent","border-transparent","border-warning/30","border-warning/40","border-x","border-y","bottom-0","bottom-4","break-all","break-words","capitalize","catppuccin","col-span-2","col-start-2","collapse","columns-2","columns-3","com","container","contents","cursor-col-resize","cursor-default","cursor-grab","cursor-not-allowed","cursor-ns-resize","cursor-pointer","cursor-row-resize","dark","dark:aria-invalid:border-destructive/50","dark:aria-invalid:ring-destructive/40","dark:bg-destructive/20","dark:bg-destructive/60","dark:bg-input/30","dark:bg-transparent","dark:border-accent-brand/40","dark:border-input","dark:data-[state=active]:bg-input/30","dark:data-[state=active]:border-input","dark:data-[state=active]:text-foreground","dark:data-[state=checked]:bg-primary","dark:data-[state=checked]:bg-primary-foreground","dark:data-[state=unchecked]:bg-foreground","dark:data-[state=unchecked]:bg-input/80","dark:data-[variant=destructive]:focus:bg-destructive/20","dark:disabled:bg-input/80","dark:focus-visible:ring-destructive/40","dark:hover:bg-accent-brand/10","dark:hover:bg-destructive/10","dark:hover:bg-destructive/30","dark:hover:bg-input/50","dark:hover:bg-muted/50","dark:text-muted-foreground","data-[disabled=true]:opacity-50","data-[disabled=true]:pointer-events-none","data-[disabled]:opacity-50","data-[disabled]:pointer-events-none","data-[orientation=horizontal]:h-1.5","data-[orientation=horizontal]:h-full","data-[orientation=horizontal]:h-px","data-[orientation=horizontal]:w-full","data-[orientation=vertical]:flex-col","data-[orientation=vertical]:h-full","data-[orientation=vertical]:min-h-44","data-[orientation=vertical]:self-center","data-[orientation=vertical]:self-stretch","data-[orientation=vertical]:w-1.5","data-[orientation=vertical]:w-auto","data-[orientation=vertical]:w-full","data-[orientation=vertical]:w-px","data-[placeholder]:text-muted-foreground","data-[selected=true]:bg-muted","data-[selected=true]:text-accent-foreground","data-[side=bottom]:border-t","data-[side=bottom]:bottom-0","data-[side=bottom]:data-closed:slide-out-to-bottom-10","data-[side=bottom]:data-open:slide-in-from-bottom-10","data-[side=bottom]:h-auto","data-[side=bottom]:inset-x-0","data-[side=bottom]:slide-in-from-top-2","data-[side=bottom]:translate-y-1","data-[side=left]:-translate-x-1","data-[side=left]:border-r","data-[side=left]:data-closed:slide-out-to-left-10","data-[side=left]:data-open:slide-in-from-left-10","data-[side=left]:group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]","data-[side=left]:h-full","data-[side=left]:inset-y-0","data-[side=left]:left-0","data-[side=left]:slide-in-from-right-2","data-[side=left]:sm:max-w-sm","data-[side=left]:w-3/4","data-[side=right]:border-l","data-[side=right]:data-closed:slide-out-to-right-10","data-[side=right]:data-open:slide-in-from-right-10","data-[side=right]:group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]","data-[side=right]:h-full","data-[side=right]:inset-y-0","data-[side=right]:right-0","data-[side=right]:slide-in-from-left-2","data-[side=right]:sm:max-w-sm","data-[side=right]:translate-x-1","data-[side=right]:w-3/4","data-[side=top]:-translate-y-1","data-[side=top]:border-b","data-[side=top]:data-closed:slide-out-to-top-10","data-[side=top]:data-open:slide-in-from-top-10","data-[side=top]:h-auto","data-[side=top]:inset-x-0","data-[side=top]:slide-in-from-bottom-2","data-[side=top]:top-0","data-[size=default]:h-9","data-[size=md]:text-xs","data-[size=sm]:gap-2","data-[size=sm]:h-8","data-[size=sm]:has-data-[slot=card-footer]:pb-0","data-[size=sm]:py-3","data-[size=sm]:text-xs","data-[state=active]:animate-in","data-[state=active]:bg-background","data-[state=active]:fade-in-0","data-[state=active]:shadow-sm","data-[state=checked]:bg-primary","data-[state=checked]:border-primary","data-[state=checked]:text-primary-foreground","data-[state=checked]:translate-x-[calc(100%-2px)]","data-[state=closed]:animate-out","data-[state=closed]:fade-out-0","data-[state=closed]:overflow-hidden","data-[state=closed]:zoom-out-95","data-[state=delayed-open]:animate-in","data-[state=delayed-open]:fade-in-0","data-[state=delayed-open]:zoom-in-95","data-[state=inactive]:animate-out","data-[state=inactive]:fade-out-0","data-[state=open]:animate-in","data-[state=open]:fade-in-0","data-[state=open]:zoom-in-95","data-[state=unchecked]:bg-input","data-[state=unchecked]:translate-x-0","data-[variant=destructive]:*:[svg]:text-destructive","data-[variant=destructive]:focus:bg-destructive/10","data-[variant=destructive]:focus:text-destructive","data-[variant=destructive]:text-destructive","data-active:bg-sidebar-accent","data-active:font-medium","data-active:text-sidebar-accent-foreground","data-closed:animate-out","data-closed:fade-out-0","data-closed:zoom-out-95","data-disabled:opacity-50","data-disabled:pointer-events-none","data-inset:pl-7","data-open:animate-in","data-open:bg-accent","data-open:fade-in-0","data-open:hover:bg-sidebar-accent","data-open:hover:text-sidebar-accent-foreground","data-open:text-accent-foreground","data-open:zoom-in-95","delay-75","disabled:bg-input/50","disabled:cursor-not-allowed","disabled:opacity-30","disabled:opacity-40","disabled:opacity-50","disabled:opacity-60","disabled:pointer-events-none","divide-border","divide-x","divide-y","dracula","drop-shadow","duration-100","duration-150","duration-200","duration-500","duration-[450ms]","ease-in-out","ease-linear","ease-out","enabled:hover:text-accent-brand","fade-in","file:bg-transparent","file:border-0","file:font-medium","file:h-6","file:inline-flex","file:text-foreground","file:text-xs","fill-foreground","filter","fixed","flex","flex-1","flex-col","flex-col-reverse","flex-row","flex-wrap","focus-visible:border-destructive/40","focus-visible:border-ring","focus-visible:outline-1","focus-visible:outline-hidden","focus-visible:outline-none","focus-visible:outline-ring","focus-visible:relative","focus-visible:ring-0","focus-visible:ring-1","focus-visible:ring-2","focus-visible:ring-4","focus-visible:ring-[#f59145]/40","focus-visible:ring-[3px]","focus-visible:ring-destructive/20","focus-visible:ring-inset","focus-visible:ring-ring","focus-visible:ring-ring/50","focus-visible:z-10","focus-within:border-ring","focus-within:opacity-100","focus-within:ring-1","focus-within:ring-ring","focus-within:ring-ring/50","focus:**:text-accent-foreground","focus:bg-accent","focus:ring-1","focus:ring-ring","focus:text-accent-brand","focus:text-accent-foreground","focus:text-destructive","font-bold","font-heading","font-medium","font-mono","font-normal","font-semibold","fs-lg","fs-md","fs-sm","fs-xl","fs-xs","gap-0","gap-0.5","gap-1","gap-1.5","gap-2","gap-2.5","gap-3","gap-3.5","gap-4","gap-5","gap-6","gap-[1.75px]","gap-[10.5px]","gap-[2px]","gap-[3.5px]","gap-[3px]","gap-px","gap-x-2","gap-x-3","gap-x-4","gap-x-6","gap-y-0","gap-y-0.5","gap-y-1","gap-y-1.5","gap-y-2","gap-y-3","grid","grid-cols-1","grid-cols-2","grid-cols-3","grid-cols-4","grid-cols-6","grid-cols-8","grid-cols-[0_1fr]","grid-cols-[1fr_5rem]","grid-flow-col","group","group-[.toast]:!border-accent-brand/30","group-[.toast]:!border-destructive/30","group-[.toast]:!text-accent-brand","group-[.toast]:!text-destructive","group-[.toast]:bg-accent-brand","group-[.toast]:bg-muted","group-[.toast]:font-semibold","group-[.toast]:text-muted-foreground","group-[.toast]:text-white","group-[.toaster]:bg-card","group-[.toaster]:border-border","group-[.toaster]:font-mono","group-[.toaster]:rounded-none!","group-[.toaster]:shadow-lg","group-[.toaster]:text-card-foreground","group-data-[collapsible=icon]:-mt-8","group-data-[collapsible=icon]:hidden","group-data-[collapsible=icon]:opacity-0","group-data-[collapsible=icon]:overflow-hidden","group-data-[collapsible=icon]:p-0!","group-data-[collapsible=icon]:p-2!","group-data-[collapsible=icon]:size-8!","group-data-[collapsible=icon]:w-(--sidebar-width-icon)","group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]","group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]","group-data-[collapsible=offcanvas]:after:left-full","group-data-[collapsible=offcanvas]:translate-x-0","group-data-[collapsible=offcanvas]:w-0","group-data-[disabled=true]:opacity-50","group-data-[disabled=true]:pointer-events-none","group-data-[selected=true]:opacity-100","group-data-[side=left]:-right-4","group-data-[side=left]:border-r","group-data-[side=right]:border-l","group-data-[side=right]:left-0","group-data-[side=right]:rotate-180","group-data-[size=sm]/card:[.border-b]:pb-3","group-data-[size=sm]/card:p-3","group-data-[size=sm]/card:px-3","group-data-[size=sm]/card:text-sm","group-data-[variant=floating]:ring-1","group-data-[variant=floating]:ring-sidebar-border","group-data-[variant=floating]:rounded-none","group-data-[variant=floating]:shadow-sm","group-focus-within/folder:flex","group-focus-within/menu-item:opacity-100","group-focus-within/row:flex","group-focus/dropdown-menu-item:text-accent-foreground","group-has-data-[sidebar=menu-action]/menu-item:pr-8","group-hover/btn:bg-accent-brand/20","group-hover/btn:border-accent-brand/40","group-hover/folder:flex","group-hover/folder:opacity-100","group-hover/folder:text-muted-foreground/70","group-hover/menu-item:opacity-100","group-hover/open:text-accent-brand","group-hover/resize:bg-accent-brand/60","group-hover/row:flex","group-hover/row:text-muted-foreground/60","group-hover/tab:opacity-100","group-hover:bg-accent-brand/60","group-hover:hidden","group-hover:max-h-[60px]","group-hover:mt-0","group-hover:opacity-100","group-hover:text-muted-foreground/70","group/btn","group/card","group/dropdown-menu-item","group/folder","group/menu-item","group/open","group/resize","group/row","group/tab","grow","gruvbox","h-0","h-0.5","h-1","h-1.5","h-10","h-11","h-12","h-12.5","h-14","h-16","h-2.5","h-20","h-24","h-28","h-3","h-3.5","h-4","h-5","h-6","h-7","h-8","h-9","h-[1.15rem]","h-[136px]","h-[14px]","h-[2px]","h-[3px]","h-[46%]","h-[calc(100%-1px)]","h-[var(--radix-select-trigger-height)]","h-full","h-px","h-screen","h-svh","has-[>img:first-child]:pt-0","has-[>svg]:gap-x-3","has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr]","has-[[data-state=open]]:opacity-100","has-data-[icon=inline-end]:pr-1.5","has-data-[icon=inline-end]:pr-2","has-data-[icon=inline-start]:pl-1.5","has-data-[icon=inline-start]:pl-2","has-data-[slot=card-action]:grid-cols-[1fr_auto]","has-data-[slot=card-description]:grid-rows-[auto_auto]","has-data-[slot=card-footer]:pb-0","has-data-[slot=kbd]:pr-1.5","has-data-[variant=inset]:bg-sidebar","hidden","host-status-stripe","hover:after:bg-sidebar-border","hover:bg-accent","hover:bg-accent-brand","hover:bg-accent-brand/10","hover:bg-accent-brand/15","hover:bg-accent-brand/20","hover:bg-accent-brand/40","hover:bg-accent-brand/5","hover:bg-accent-brand/90","hover:bg-background/80","hover:bg-destructive/10","hover:bg-destructive/20","hover:bg-destructive/90","hover:bg-foreground/[0.03]","hover:bg-muted","hover:bg-muted-foreground/10","hover:bg-muted/20","hover:bg-muted/30","hover:bg-muted/40","hover:bg-muted/50","hover:bg-muted/60","hover:bg-secondary/80","hover:bg-sidebar-accent","hover:bg-surface","hover:border-accent-brand","hover:border-accent-brand/30","hover:border-accent-brand/40","hover:border-accent-brand/60","hover:border-destructive/40","hover:border-foreground/40","hover:border-muted-foreground","hover:border-ring/60","hover:group-data-[collapsible=offcanvas]:bg-sidebar","hover:opacity-100","hover:ring-4","hover:ring-[#f59145]/40","hover:shadow-[0_0_0_1px_hsl(var(--sidebar-accent))]","hover:text-accent-brand","hover:text-accent-brand/70","hover:text-accent-brand/80","hover:text-accent-foreground","hover:text-destructive","hover:text-destructive/80","hover:text-foreground","hover:text-muted-foreground","hover:text-primary","hover:text-sidebar-accent-foreground","hover:underline","in-data-[side=left]:cursor-w-resize","in-data-[side=right]:cursor-e-resize","inline","inline-block","inline-flex","inset-0","inset-x-0","inset-x-3","inset-y-0","invisible","isolate","italic","items-baseline","items-center","items-end","items-start","items-stretch","justify-between","justify-center","justify-end","justify-items-start","justify-self-end","justify-start","last:border-0","last:border-b-0","leading-[1.4]","leading-[1.7]","leading-[14px]","leading-none","leading-relaxed","leading-snug","leading-tight","left-0","left-1/2","left-2","left-2.5","left-[50%]","lg:block","lg:col-span-2","lg:flex","lg:grid-cols-1","lg:grid-cols-2","lg:grid-cols-3","lg:grid-cols-4","lg:grid-cols-5","lg:hidden","lg:inline","line-clamp-2","line-clamp-3","line-clamp-4","line-through","list-disc","list-inside","lowercase","ltr:-translate-x-1/2","lucide","m-2.5","m-auto","max-h-(--radix-dropdown-menu-content-available-height)","max-h-(--radix-popover-content-available-height)","max-h-(--radix-select-content-available-height)","max-h-0","max-h-24","max-h-40","max-h-56","max-h-64","max-h-96","max-h-[130px]","max-h-[300px]","max-h-[60px]","max-h-[60vh]","max-h-[80dvh]","max-w-(--skeleton-width)","max-w-0","max-w-2xl","max-w-32","max-w-3xl","max-w-40","max-w-48","max-w-5xl","max-w-72","max-w-96","max-w-[120px]","max-w-[160px]","max-w-[180px]","max-w-[200px]","max-w-[260px]","max-w-[380px]","max-w-[50%]","max-w-[560px]","max-w-[5rem]","max-w-[60%]","max-w-[calc(100%-2rem)]","max-w-full","max-w-lg","max-w-md","max-w-sm","max-w-xl","max-w-xs","mb-0.5","mb-1","mb-1.5","mb-2","mb-4","md:-mx-4","md:after:hidden","md:block","md:col-span-1","md:flex","md:flex-row","md:grid-cols-1","md:grid-cols-2","md:grid-cols-3","md:grid-cols-4","md:hidden","md:max-h-none","md:opacity-0","md:overflow-visible","md:overflow-y-auto","md:peer-data-[variant=inset]:m-2","md:peer-data-[variant=inset]:ml-0","md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2","md:peer-data-[variant=inset]:rounded-none","md:peer-data-[variant=inset]:shadow-sm","md:px-3.5","md:px-4","md:size-4","md:static","md:text-2xl","md:text-xs","md:w-44","md:w-48","md:w-56","md:w-60","md:w-72","min-[280px]:inline","min-h-0","min-h-11","min-h-16","min-h-24","min-h-48","min-h-8","min-h-9","min-h-[19px]","min-h-[220px]","min-h-[70vh]","min-h-[80px]","min-h-full","min-h-svh","min-w-(--radix-popover-trigger-width)","min-w-0","min-w-16","min-w-3","min-w-32","min-w-4","min-w-40","min-w-44","min-w-5","min-w-52","min-w-[14px]","min-w-[150px]","min-w-[160px]","min-w-[170px]","min-w-[180px]","min-w-[200px]","min-w-[8rem]","min-w-[96px]","min-w-[var(--radix-select-trigger-width)]","min-w-max","ml-0.5","ml-1","ml-1.5","ml-2","ml-3","ml-3.5","ml-4","ml-8","ml-[27px]","ml-auto","motion-context-enter","motion-fade-enter","motion-interactive","motion-meter","motion-panel-enter","motion-transfer-phase","motion-workspace-enter","motion-workspace-layout","mr-1","mr-1.5","mr-2","mt-0.5","mt-1","mt-1.5","mt-2","mt-2.5","mt-3","mt-4","mt-[1.75px]","mt-auto","mt-px","mx-0.5","mx-2","mx-3.5","mx-4","mx-auto","my-0.5","my-1","my-3","my-auto","nord","normal-case","not-data-[variant=destructive]:focus:**:text-accent-foreground","object-contain","one-dark","opacity-0","opacity-100","opacity-40","opacity-50","opacity-60","opacity-70","opacity-80","origin-(--radix-dropdown-menu-content-transform-origin)","origin-(--radix-popover-content-transform-origin)","origin-(--radix-select-content-transform-origin)","origin-(--radix-tooltip-content-transform-origin)","origin-center","outline","outline-hidden","outline-none","overflow-auto","overflow-hidden","overflow-x-auto","overflow-x-hidden","overflow-y-auto","overflow-y-hidden","overline","p-0","p-0.5","p-1","p-1.5","p-10","p-2","p-2.5","p-3","p-4","p-5","p-6","p-8","p-[3px]","p-px","paused","pb-0","pb-1","pb-1.5","pb-2","pb-3","pb-6","peer","peer-data-[size=default]/menu-button:top-1.5","peer-data-[size=lg]/menu-button:top-2.5","peer-data-[size=sm]/menu-button:top-1","peer-data-active/menu-button:text-sidebar-accent-foreground","peer-disabled:cursor-not-allowed","peer-disabled:opacity-50","peer-hover/menu-button:text-sidebar-accent-foreground","peer/menu-button","pl-1","pl-2","pl-2.5","pl-4","pl-5","pl-5.5","pl-6","pl-7","pl-8","pl-[7px]","pl-[8.75px]","pl-px","placeholder:text-muted-foreground","placeholder:text-muted-foreground/50","pointer-coarse:flex","pointer-coarse:opacity-100","pointer-events-none","pr-0.5","pr-1","pr-1.5","pr-12","pr-2","pr-2.5","pr-7","pr-8","pr-9","pr-[5.25px]","pr-[7px]","pt-0.5","pt-1","pt-1.5","pt-2","pt-2.5","pt-3","pt-4","pt-[15vh]","pt-[3.5px]","pt-[3px]","pt-[5.25px]","px-0","px-0.5","px-1","px-1.5","px-2","px-2.5","px-3","px-3.5","px-4","px-5","px-6","px-[3px]","py-0","py-0.5","py-1","py-1.5","py-10","py-12","py-2","py-2.5","py-3","py-4","py-6","py-8","py-[1px]","py-[2px]","py-[5px]","py-[7px]","py-px","relative","resize","resize-none","right-0","right-1","right-1.5","right-2","right-2.5","right-3","ring","ring-0","ring-1","ring-2","ring-accent-brand","ring-accent-brand/50","ring-border","ring-foreground/10","ring-inset","ring-offset-1","ring-offset-background","ring-sidebar-ring","ring-white/60","rotate-180","rotate-45","rotate-90","rounded","rounded-[inherit]","rounded-full","rounded-none","rounded-sm","row-span-2","row-start-1","rtl:-translate-x-1/2","running","safe-bottom","scale-110","scroll-my-1","scrollbar-none","select-none","self-end","self-start","self-stretch","settings-search-hit","shadow","shadow-2xl","shadow-[0_0_0_1px_hsl(var(--sidebar-border))]","shadow-lg","shadow-md","shadow-none","shadow-sm","shadow-xl","shadow-xs","shrink-0","size-1.5","size-10","size-12","size-2","size-2.5","size-3","size-3.5","size-4","size-5","size-6","size-6.5","size-7","size-8","size-9","size-[10.5px]","size-[17.5px]","size-[19px]","size-[22.75px]","size-full","size-px","sm:border-b-0","sm:border-r","sm:col-span-2","sm:flex","sm:flex-row","sm:grid-cols-12","sm:grid-cols-2","sm:grid-cols-3","sm:grid-cols-4","sm:items-center","sm:justify-end","sm:max-w-lg","sm:max-w-sm","sm:mr-auto","sm:py-14","sm:text-left","solarized","space-y-0.5","space-y-1.5","space-y-2","sr-only","static","sticky","stroke-accent-brand","stroke-border","stroke-muted","supports-backdrop-filter:backdrop-blur-xs","tab-1","tab-2","table","tabular-nums","text-2xl","text-[10px]","text-[11px]","text-[12px]","text-[13px]","text-[9px]","text-accent-brand","text-accent-brand/50","text-accent-brand/80","text-accent-foreground","text-background","text-base","text-blue-400","text-blue-500","text-card-foreground","text-center","text-current","text-destructive","text-destructive/80","text-emerald-500","text-foreground","text-foreground-secondary","text-foreground/70","text-foreground/80","text-green-500","text-left","text-lg","text-muted-foreground","text-muted-foreground/0","text-muted-foreground/20","text-muted-foreground/30","text-muted-foreground/35","text-muted-foreground/40","text-muted-foreground/45","text-muted-foreground/50","text-muted-foreground/60","text-muted-foreground/70","text-muted-foreground/80","text-popover-foreground","text-primary","text-primary-foreground","text-red-500","text-right","text-secondary-foreground","text-sidebar-foreground","text-sidebar-foreground/70","text-sm","text-warning","text-white","text-xl","text-xs","text-xs/relaxed","thin-scrollbar","toast","toaster","tokyo-night","top-0","top-1","top-1.5","top-1/2","top-2","top-20","top-3","top-3.5","top-[50%]","touch-none","tracking-[0.35em]","tracking-[0.3em]","tracking-normal","tracking-tight","tracking-wide","tracking-wider","tracking-widest","transfer-progress-fill","transfer-progress-indeterminate","transfer-progress-stalled","transfer-progress-track","transform","transition","transition-[background-color,border-color,box-shadow,opacity]","transition-[color,background-color,border-color,opacity,box-shadow,transform]","transition-[color,box-shadow]","transition-[height,border-color]","transition-[height]","transition-[left,right,width]","transition-[left,top,width,height]","transition-[margin,opacity]","transition-[max-height,opacity,margin]","transition-[opacity,max-width]","transition-[opacity,width]","transition-[padding]","transition-[stroke-dasharray]","transition-[width,height,padding]","transition-[width]","transition-all","transition-colors","transition-none","transition-opacity","transition-shadow","transition-transform","translate-x-0.5","translate-x-4","translate-x-[-50%]","translate-x-px","translate-y-[-1px]","translate-y-[-50%]","translate-y-[calc(-50%_-_2px)]","truncate","underline","underline-offset-2","underline-offset-4","uppercase","visible","w-(--radix-dropdown-menu-trigger-width)","w-(--sidebar-width)","w-0","w-0.5","w-1","w-1.5","w-1/2","w-1/4","w-10","w-11","w-12","w-12.5","w-2","w-2.5","w-2/3","w-20","w-28","w-3","w-3/4","w-4","w-40","w-48","w-5","w-5/6","w-52","w-56","w-6","w-60","w-64","w-72","w-8","w-9","w-[240px]","w-[2px]","w-[3px]","w-[46%]","w-[min(85vw,360px)]","w-[var(--radix-popover-trigger-width)]","w-auto","w-fit","w-full","w-max","w-px","w-screen","whitespace-normal","whitespace-nowrap","whitespace-pre","whitespace-pre-line","whitespace-pre-wrap","xl:block","xl:flex","xl:grid-cols-1","xl:grid-cols-2","xl:grid-cols-3","xl:grid-cols-4","z-0","z-10","z-20","z-30","z-40","z-50","z-500","z-[10000]","z-[100]","z-[200]","z-[60]","z-[9998]","z-[99999]"]

package/dist/host/{linked-server-DW5P3NLZ.js → linked-server-RWBK427T.js}

@@ -3,7 +3,7 @@ import {
   SYNC_CHANGED_EVENT,
   getLinkedSession,
   notifySyncChanged
-} from "./chunk-LKYAVM4T.js";
+} from "./chunk-OEOKIKXC.js";
 import "./chunk-YC2MAKSP.js";
 export {
   SYNC_CHANGED_EVENT,

package/dist/host/{rbac-api-JKISXZEP.js → rbac-api-UJGGTQVA.js}

@@ -23,7 +23,7 @@ import {
   shareHost,
   updateHostAccess,
   updateRole
-} from "./chunk-LKYAVM4T.js";
+} from "./chunk-OEOKIKXC.js";
 import "./chunk-YC2MAKSP.js";
 export {
   assignRoleToUser,

package/dist/host/testing-host.js

@@ -40,16 +40,16 @@ import {
   setShellCallbacks,
   setShellHosts,
   setShellLayoutProvider
-} from "./chunk-SS43S6VI.js";
+} from "./chunk-VETPF5WI.js";
 import {
   setPermissionsForTesting
-} from "./chunk-XKMRKQFN.js";
+} from "./chunk-KOOUKYW3.js";
 import {
   getTabType,
   listTabTypes,
   setFrontendState,
   setPluginSummaries
-} from "./chunk-LKYAVM4T.js";
+} from "./chunk-OEOKIKXC.js";
 import "./chunk-YC2MAKSP.js";
 
 // src/ui/plugin-host/testing-host.tsx

package/dist/host/types/src/types/credential-sidebar-preferences.d.ts

@@ -2,7 +2,7 @@
  * Credential sidebar preferences model. Shared by the frontend sidebar and
  * the backend preferences endpoint (no framework imports, mirrors
  * ./host-sidebar-preferences.ts's dependency-free convention). Independent
- * from HostSidebarPreferences by design — a separate parallel system, not a
+ * from HostSidebarPreferences by design, a separate parallel system, not a
  * shared blob, matching how credentialSortKey/credentialFilterState were
  * already independently namespaced from hostSortKey/etc. before this port.
  *

package/dist/host/types/src/ui/api/plugins-api.d.ts

@@ -1,5 +1,6 @@
 import type { ChoiceAdjustment, PluginChoice } from "../../types/plugin-onboarding";
 import type { ChangelogRelease, ReleaseNotes } from "@termix-ssh/plugin-sdk/changelog";
+import type { PluginEnvVar } from "@termix-ssh/plugin-sdk/docs";
 export type { PluginChoice };
 export interface PluginTabContribution {
     id: string;
@@ -138,6 +139,10 @@ export interface PluginSummary {
     videoId?: string;
     /** What the plugin does, from the manifest. Admins only. */
     features?: string[];
+    /** https docs link from the manifest. */
+    docs?: string;
+    /** Environment variables the plugin reads. Admins only. */
+    env?: PluginEnvVar[];
     signedBy?: string | null;
 }
 export declare function getPlugins(): Promise<PluginSummary[]>;
@@ -165,6 +170,7 @@ export interface RegistryPluginEntry {
     icon?: string;
     videoId?: string;
     features?: string[];
+    docs?: string;
     versions: RegistryPluginVersion[];
     /** Newest release on the plugin's channel. */
     latestVersion: string | null;

package/dist/host/types/src/ui/components/docs-link.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from "react";
+import { type DocsPage } from "../lib/docs";
+/** A plugin's docs link from its manifest, or null when it has none. */
+export declare function usePluginDocsUrl(pluginId: string | null | undefined, page?: string, anchor?: string): string | null;
+export interface DocsLinkProps {
+    /** A core docs page. */
+    core?: DocsPage;
+    /**
+     * A page of the current plugin's docs, like "setup". Inside a plugin this
+     * resolves against its manifest docs link; "" is its main page.
+     */
+    page?: string;
+    anchor?: string;
+    /** A full URL, used as is. */
+    href?: string | null;
+    /** "text" is a small inline link, "icon" a square header button. */
+    variant?: "text" | "icon";
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * The one way the app links to docs. Renders nothing when there is nowhere
+ * to go, like a community plugin with no docs link.
+ */
+export declare function DocsLink({ core, page, anchor, href, variant, children, className, }: DocsLinkProps): import("react").JSX.Element;

package/dist/host/types/src/ui/components/panel-layout.d.ts

@@ -10,7 +10,7 @@ export declare const PANEL: {
 export type PanelViewMode = "grid" | "list";
 export type PanelDensity = "comfortable" | "compact";
 /** The header, toolbar band and body every tab and panel draws. */
-export declare function PanelShell({ chrome, icon, title, status, leading, actions, toolbar, tabs, footer, scroll, className, children, }: {
+export declare function PanelShell({ chrome, icon, title, status, leading, actions, toolbar, tabs, footer, scroll, docs, className, children, }: {
     /** False inside a sidebar, which draws its own header. */
     chrome?: boolean;
     icon?: React.ReactNode;
@@ -27,6 +27,8 @@ export declare function PanelShell({ chrome, icon, title, status, leading, actio
     footer?: React.ReactNode;
     /** False when the body scrolls itself. */
     scroll?: boolean;
+    /** Docs URL for this screen, shown as a book icon in the header. */
+    docs?: string | null;
     className?: string;
     children: React.ReactNode;
 }): React.JSX.Element;

package/dist/host/types/src/ui/lib/docs.d.ts

@@ -0,0 +1,10 @@
+import DOCS_PAGES from "./docs-pages.json";
+export declare const DOCS_URL = "https://docs.termix.site";
+/**
+ * Every core docs page the app links to. The docs site checks each one
+ * exists, so add new links here rather than writing URLs inline.
+ */
+export type DocsPage = keyof typeof DOCS_PAGES;
+/** Full URL of a core docs page. */
+export declare function docsUrl(page?: DocsPage): string;
+export { DOCS_PAGES };

package/dist/host/types/src/ui/lib/error-message.d.ts

@@ -1,7 +1,7 @@
 /**
  * Extract a stable, human-readable message from an unknown thrown value.
  *
- * A thrown value is not guaranteed to be an `Error` — libraries may throw
+ * A thrown value is not guaranteed to be an `Error`, libraries may throw
  * strings or plain objects, which carry no useful `.message`. When that
  * happens the caller gets `fallback` instead, so error paths never surface a
  * raw `[object Object]` in logs or UI.

package/dist/host/types/src/ui/main-axios.d.ts

@@ -66,7 +66,6 @@ export interface UserInfo {
     is_dual_auth?: boolean;
     password_hash?: string;
     data_unlocked?: boolean;
-    show_donation_modal?: boolean;
     /** On a desktop linked to a server, the account it is signed in to there. */
     linked?: LinkedAccountInfo | null;
 }
@@ -83,6 +82,7 @@ interface UserCount {
     count: number;
 }
 export { isElectron };
+export declare const TRUST_TOKEN_KEY = "termixTrustToken";
 export declare function setCookie(name: string, value: string, days?: number): void | Promise<void>;
 export declare function getCookie(name: string): string | undefined;
 export declare function markUserAuthenticated(): void;
@@ -120,7 +120,6 @@ export declare function logoutUser(): Promise<{
     message: string;
 }>;
 export declare function getUserInfo(): Promise<UserInfo>;
-export declare function dismissDonationModal(): Promise<void>;
 export declare function getCurrentToken(): Promise<string | null>;
 export declare function unlockUserData(password: string): Promise<{
     success: boolean;

package/dist/host/types/src/ui/plugin-host/sdk-ui.d.ts

@@ -87,6 +87,7 @@ export { getAdaptiveResourceBudget, markAdaptiveResourceUsed, runAdaptiveBackgro
 export { getDeviceId } from "../lib/device-id";
 export { createQuickConnectHost } from "../sidebar/quick-connect-host";
 export { BackButton, Facts, GroupHeading, PANEL, PanelSearch, PanelShell, Segmented, ViewToggle, type PanelDensity, type PanelViewMode, } from "../components/panel-layout";
+export { DocsLink, type DocsLinkProps } from "../components/docs-link";
 export { AddButton, FormFooter, ListBadge, ListRow, ListRowAction, ListRowFolder, PanelList, type ListRowTone, } from "../components/list-kit";
 export { DataView, type DataColumn, type GridColumns, } from "../components/data-view";
 export { TabStrip, type TabStripItem } from "../components/tab-strip";

package/dist/host/ui.js

@@ -23,6 +23,7 @@ import {
   Copy,
   Corner,
   Description2,
+  DocsLink,
   ExternalLink,
   Eye,
   EyeOff,
@@ -137,8 +138,8 @@ import {
   useSurfaceKind,
   useTheme,
   verifySecondFactor
-} from "./chunk-SS43S6VI.js";
-import "./chunk-XKMRKQFN.js";
+} from "./chunk-VETPF5WI.js";
+import "./chunk-KOOUKYW3.js";
 import {
   TabProvider,
   buildOriginWsUrl,
@@ -177,7 +178,7 @@ import {
   useTabs,
   useTabsSafe,
   verifyPasswordResetCode
-} from "./chunk-LKYAVM4T.js";
+} from "./chunk-OEOKIKXC.js";
 import "./chunk-YC2MAKSP.js";
 
 // src/ui/components/alert.tsx
@@ -3838,6 +3839,7 @@ function HostPluginSection({
     {
       title: plugin.name,
       icon: /* @__PURE__ */ jsx36(PluginIcon, { name: plugin.icon, className: "size-3.5" }),
+      action: /* @__PURE__ */ jsx36(DocsLink, { href: plugin.docs }),
       children: [
         !running && /* @__PURE__ */ jsx36("div", { className: "my-3 border border-warning/40 bg-warning/10 px-3 py-2 text-xs text-warning", children: t2("settings.featureUnavailable", { name: plugin.name }) }),
         enableKey && /* @__PURE__ */ jsx36(
@@ -4426,6 +4428,13 @@ function syncPlugins(summaries) {
 import.meta.hot?.on("termix:plugins-reloaded", () => {
   if (started) void syncPlugins();
 });
+function installLocaleResolver() {
+  setPluginLocaleResolver((namespace, _language, file) => {
+    const summary = getPluginRecord(namespace)?.summary;
+    if (!summary) return Promise.resolve(null);
+    return currentDeps().loadLocale(summary, file);
+  });
+}
 async function fetchPreLoginPlugins() {
   const response = await fetch(getBackendUrl("/plugins/public-manifest"));
   if (!response.ok) return [];
@@ -4441,11 +4450,7 @@ async function startPreLoginPlugins(options = {}) {
     return;
   }
   if (list.length === 0 || started) return;
-  setPluginLocaleResolver((namespace, _language, file) => {
-    const summary = getPluginRecord(namespace)?.summary;
-    if (!summary) return Promise.resolve(null);
-    return currentDeps().loadLocale(summary, file);
-  });
+  installLocaleResolver();
   await enqueue(async () => {
     if (started) return;
     if (options.retryFailed) {
@@ -5026,6 +5031,10 @@ function Auth({ onLogin }) {
       toast2.error(t2("auth.secondFactorUnavailable"));
       return;
     }
+    if (error?.response?.data?.code === "external_login_required") {
+      toast2.error(t2("auth.externalLoginRequired"));
+      return;
+    }
     toast2.error(
       error?.response?.data?.error || error?.message || t2(fallbackKey)
     );
@@ -31908,6 +31917,7 @@ export {
   DialogPortal,
   DialogTitle,
   DialogTrigger,
+  DocsLink,
   DropdownMenu,
   DropdownMenuCheckboxItem,
   DropdownMenuContent,

package/dist/host/{use-permissions-5CZEA3P4.js → use-permissions-P3DC7ZDR.js}

@@ -7,7 +7,7 @@ import {
   resetPermissionsCache,
   setPermissionsForTesting,
   usePermissions
-} from "./chunk-XKMRKQFN.js";
+} from "./chunk-KOOUKYW3.js";
 import "./chunk-YC2MAKSP.js";
 export {
   hasPermission,

package/dist/host-commands.js

@@ -17,7 +17,7 @@ export function execCommand(client, command, timeoutMs = 30000) {
             if (!settled) {
                 settled = true;
                 cleanup();
-                reject(new Error(`Command timeout after ${timeoutMs}ms: ${command}`));
+                reject(new Error(`Command timeout after ${timeoutMs}ms`));
             }
         }, timeoutMs);
         const cleanup = () => {

package/dist/manifest.d.ts

@@ -9,6 +9,8 @@
  * "permissionGroups" used to validate clean and be silently dropped, which
  * made a manifest look like it declared something it did not.
  */
+import { type PluginEnvVar } from "./docs.js";
+export { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsPage, pluginDocsUrl, pluginEnvVars, type PluginEnvVar, } from "./docs.js";
 /**
  * The plugin API this build implements. A minor bump adds to the API and
  * never removes; a major bump may break plugins.
@@ -17,7 +19,7 @@
  * "^1.2" needs 1.2 or later). engine.termix is checked against the core
  * version by the server.
  */
-export declare const PLUGIN_API_VERSION = "1.1.0";
+export declare const PLUGIN_API_VERSION = "1.2.0";
 /** The API major, the default engine.api for a new plugin. */
 export declare const SUPPORTED_PLUGIN_API_VERSION: string;
 /** Whether this build's plugin API satisfies a manifest's engine.api. */
@@ -425,6 +427,10 @@ export interface PluginManifest {
     video?: string;
     /** Short lines listing what the plugin does, shown on its page. */
     features?: string[];
+    /** Where the plugin's docs live. https only. */
+    docs?: string;
+    /** Environment variables the plugin reads. */
+    env?: PluginEnvVar[];
     engine: PluginEngine;
     /** Catalog capability ids. */
     capabilities: string[];

package/dist/manifest.js

@@ -11,6 +11,8 @@
  */
 import semver from "semver";
 import { isKnownCapability } from "./capabilities.js";
+import { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsUrl, } from "./docs.js";
+export { ENV_NAME_PATTERN, MAX_ENV_DESCRIPTION_LENGTH, pluginDocsPage, pluginDocsUrl, pluginEnvVars, } from "./docs.js";
 /**
  * The plugin API this build implements. A minor bump adds to the API and
  * never removes; a major bump may break plugins.
@@ -19,7 +21,7 @@ import { isKnownCapability } from "./capabilities.js";
  * "^1.2" needs 1.2 or later). engine.termix is checked against the core
  * version by the server.
  */
-export const PLUGIN_API_VERSION = "1.1.0";
+export const PLUGIN_API_VERSION = "1.2.0";
 /** The API major, the default engine.api for a new plugin. */
 export const SUPPORTED_PLUGIN_API_VERSION = String(semver.major(PLUGIN_API_VERSION));
 /** Whether this build's plugin API satisfies a manifest's engine.api. */
@@ -207,6 +209,8 @@ const ALLOWED_TOP_LEVEL = new Set([
     "icon",
     "video",
     "features",
+    "docs",
+    "env",
     "dependencies",
     "optionalDependencies",
     "provides",
@@ -337,6 +341,10 @@ export function validateManifest(manifest) {
         errors.push(`Field "video" must be a YouTube link such as https://www.youtube.com/watch?v=..., got: ${JSON.stringify(m.video)}`);
     }
     validateFeatures(m.features, errors);
+    if ("docs" in m && pluginDocsUrl(m.docs) === null) {
+        errors.push(`Field "docs" must be an https URL, got: ${JSON.stringify(m.docs)}`);
+    }
+    validateEnv(m.env, errors);
     for (const field of ["backend", "frontend", "locales"]) {
         if (field in m && requireString(m[field], field, errors)) {
             requireRelativePath(m[field], field, errors);
@@ -379,6 +387,45 @@ function validateFeatures(features, errors) {
         }
     });
 }
+function validateEnv(env, errors) {
+    if (env === undefined)
+        return;
+    if (!Array.isArray(env)) {
+        errors.push('Field "env" must be an array');
+        return;
+    }
+    const seen = new Set();
+    env.forEach((entry, i) => {
+        const where = `env[${i}]`;
+        if (!isPlainObject(entry)) {
+            errors.push(`Field "${where}" must be an object`);
+            return;
+        }
+        rejectUnknown(entry, ["name", "description", "default", "required", "secret"], where, errors);
+        if (typeof entry.name !== "string" || !ENV_NAME_PATTERN.test(entry.name)) {
+            errors.push(`Field "${where}.name" must be an uppercase name like MY_PLUGIN_URL, got: ${JSON.stringify(entry.name)}`);
+        }
+        else if (seen.has(entry.name)) {
+            errors.push(`Field "${where}.name" repeats ${entry.name}`);
+        }
+        else {
+            seen.add(entry.name);
+        }
+        if (typeof entry.description !== "string" ||
+            entry.description.trim().length === 0 ||
+            entry.description.length > MAX_ENV_DESCRIPTION_LENGTH) {
+            errors.push(`Field "${where}.description" must be a non-empty string of at most ${MAX_ENV_DESCRIPTION_LENGTH} characters`);
+        }
+        if ("default" in entry && typeof entry.default !== "string") {
+            errors.push(`Field "${where}.default" must be a string`);
+        }
+        for (const flag of ["required", "secret"]) {
+            if (flag in entry && typeof entry[flag] !== "boolean") {
+                errors.push(`Field "${where}.${flag}" must be true or false`);
+            }
+        }
+    });
+}
 function validateAuthor(author, errors) {
     if (author === undefined)
         return;

package/dist/openapi.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Builds an OpenAPI spec from the @openapi JSDoc blocks above routes. Core and
+ * every plugin use this, so the docs site renders them all the same way.
+ */
+export interface OpenApiTag {
+    name: string;
+    description?: string;
+}
+export interface BuildOpenApiOptions {
+    title: string;
+    version: string;
+    description?: string;
+    /** Source files or globs holding @openapi blocks. */
+    files: string[];
+    tags?: OpenApiTag[];
+}
+export type OpenApiSpec = Record<string, unknown> & {
+    paths?: Record<string, unknown>;
+};
+/** How every Termix route is signed in to. */
+export declare const TERMIX_SECURITY_SCHEMES: {
+    readonly bearerAuth: {
+        readonly type: "http";
+        readonly scheme: "bearer";
+        readonly bearerFormat: "JWT";
+        readonly description: "Session token sent in the Authorization header as Bearer and the token.";
+    };
+    readonly cookieAuth: {
+        readonly type: "apiKey";
+        readonly in: "cookie";
+        readonly name: "jwt";
+        readonly description: "Session JWT cookie set at sign-in. When present, it takes precedence over the Authorization header.";
+    };
+    readonly apiKeyAuth: {
+        readonly type: "http";
+        readonly scheme: "bearer";
+        readonly bearerFormat: "API key starting with tmx_";
+        readonly description: "API key sent in the Authorization header as Bearer and the key, which starts with tmx_. It acts as the key owner and cannot act as anyone else.";
+    };
+};
+export declare function buildOpenApi(options: BuildOpenApiOptions): Promise<OpenApiSpec>;
+/** Whether a spec documents any route. */
+export declare function hasOpenApiPaths(spec: OpenApiSpec): boolean;

package/dist/openapi.js

@@ -0,0 +1,60 @@
+/**
+ * Builds an OpenAPI spec from the @openapi JSDoc blocks above routes. Core and
+ * every plugin use this, so the docs site renders them all the same way.
+ */
+import swaggerJSDoc from "@deadendjs/swagger-jsdoc";
+/** How every Termix route is signed in to. */
+export const TERMIX_SECURITY_SCHEMES = {
+    bearerAuth: {
+        type: "http",
+        scheme: "bearer",
+        bearerFormat: "JWT",
+        description: "Session token sent in the Authorization header as Bearer and the token.",
+    },
+    cookieAuth: {
+        type: "apiKey",
+        in: "cookie",
+        name: "jwt",
+        description: "Session JWT cookie set at sign-in. When present, it takes precedence over the Authorization header.",
+    },
+    apiKeyAuth: {
+        type: "http",
+        scheme: "bearer",
+        bearerFormat: "API key starting with tmx_",
+        description: "API key sent in the Authorization header as Bearer and the key, which starts with tmx_. It acts as the key owner and cannot act as anyone else.",
+    },
+};
+export async function buildOpenApi(options) {
+    const spec = (await swaggerJSDoc({
+        definition: {
+            openapi: "3.0.3",
+            info: {
+                title: options.title,
+                version: options.version,
+                ...(options.description ? { description: options.description } : {}),
+            },
+            servers: [{ url: "/", description: "Your Termix server" }],
+            components: {
+                securitySchemes: TERMIX_SECURITY_SCHEMES,
+                schemas: {
+                    Error: {
+                        type: "object",
+                        properties: {
+                            error: { type: "string" },
+                            details: { type: "string" },
+                        },
+                    },
+                },
+            },
+            security: [{ bearerAuth: [] }, { cookieAuth: [] }, { apiKeyAuth: [] }],
+            ...(options.tags?.length ? { tags: options.tags } : {}),
+        },
+        apis: options.files.map((f) => f.replace(/\\/g, "/")),
+        failOnErrors: true,
+    }));
+    return spec;
+}
+/** Whether a spec documents any route. */
+export function hasOpenApiPaths(spec) {
+    return Object.keys(spec.paths ?? {}).length > 0;
+}

package/dist/testing/setup.js

@@ -77,6 +77,7 @@ const noop = () => { };
 const offline = () => Promise.reject(new Error("No plugin API in a unit test; mock it"));
 globalThis.__termixTestPluginHost = {
     usePluginId: () => "test-plugin",
+    useDocsUrl: () => null,
     useTranslation: () => ({
         t: (key) => key,
         language: "en",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termix-ssh/plugin-sdk",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "description": "The contract between Termix core and a plugin: types, the capability catalog and the manifest schema.",
   "license": "Apache-2.0",
   "repository": {
@@ -53,6 +53,14 @@
       "types": "./dist/changelog.d.ts",
       "default": "./dist/changelog.js"
     },
+    "./docs": {
+      "types": "./dist/docs.d.ts",
+      "default": "./dist/docs.js"
+    },
+    "./openapi": {
+      "types": "./dist/openapi.d.ts",
+      "default": "./dist/openapi.js"
+    },
     "./settings": {
       "types": "./dist/settings.d.ts",
       "default": "./dist/settings.js"
@@ -102,6 +110,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
+    "@deadendjs/swagger-jsdoc": "^8.1.2",
     "@tailwindcss/node": "^4.2.4",
     "@tailwindcss/oxide": "^4.2.4",
     "esbuild": "^0.28.1",
@@ -139,6 +148,18 @@
     },
     "@testing-library/react": {
       "optional": true
+    },
+    "i18next": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "react-i18next": {
+      "optional": true
+    },
+    "sonner": {
+      "optional": true
     }
   },
   "publishConfig": {