@streamoid/settings 0.3.6 → 0.3.8

package/README.md

@@ -58,7 +58,9 @@ function MySettingsPage() {
       revokeToken: (id) => fetch(`/tokens/${id}`, { method: "DELETE" }).then(() => undefined),
     },
     navigation: {
-      navigateToTab: (tab) => router.push(`/settings/${TAB_TO_URL[tab]}`),
+      // `replace` matters once you wire up `onClose` below — otherwise a
+      // history-based close walks back through every tab the user visited.
+      navigateToTab: (tab) => router.replace(`/settings/${TAB_TO_URL[tab]}`),
       openExternal: (url) => window.open(url, "_blank", "noopener"),
     },
     toast: {
@@ -75,11 +77,35 @@ function MySettingsPage() {
     <SettingsContent
       activeTab={resolveSettingsTabFromPath(location.pathname)}
       adapters={adapters}
+      onClose={() => router.back()}
     />
   );
 }
 ```
 
+## Closing settings
+
+Settings is a full page in every host, so the package cannot decide what
+"closed" means — pass `onClose` (or `adapters.navigation.close`) and the shell
+renders a × button in the header and dismisses on `Escape`. Pass neither and no
+close affordance appears.
+
+Escape defers to anything stacked on top of the panel. `overlay-registry.ts`
+keeps an ordered stack of open modals — only the frontmost one acts on a press,
+and the shell acts only once the stack is empty. The billing **Plans** sub-view
+steps back to billing before the panel itself closes.
+
+Modals added to this package should call `useOverlayOpen(open, onClose)` at the
+top of the component. That is what registers them in the stack; skip it and
+Escape will close the whole panel out from under the modal.
+
+## Explaining the tabs
+
+Every sub-nav destination carries a hover/focus tooltip sourced from the
+exported `TAB_DESCRIPTIONS` map. Override the copy in your host by rendering
+your own nav, or edit the map here so all hosts stay consistent — the latter is
+usually what you want.
+
 ## Adapter surface
 
 | Adapter | Purpose |

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { SVGProps, ReactNode } from 'react';
+import * as react from 'react';
+import react__default, { SVGProps, ReactNode } from 'react';
 
 /**
  * Settings tab identifiers and URL mapping helpers.
@@ -16,6 +16,13 @@ declare const TAB_TO_URL: Record<SettingsTab, string>;
 declare const URL_TO_TAB: Record<string, SettingsTab>;
 /** Human-readable label for each tab (used for breadcrumbs etc.). */
 declare const TAB_LABELS: Record<SettingsTab, string>;
+/**
+ * One-line explanation of what each destination is for, shown on hover over the
+ * settings sub-nav. Kept next to `TAB_LABELS` so a new tab can't get a label
+ * without also getting an explanation — `Record<SettingsTab, string>` makes
+ * omitting one a type error.
+ */
+declare const TAB_DESCRIPTIONS: Record<SettingsTab, string>;
 /**
  * Resolve a `SettingsTab` from a URL pathname. Looks for the last segment that
  * matches a known slug; falls back to `"profile"` (the default Account tab).
@@ -196,6 +203,9 @@ interface OrganizationMember {
     _id: string;
     role: "admin" | "member";
     inviteAccess: boolean;
+    /** Populated user. Rows whose user document was deleted come back from the
+     *  API with a null `user` — OrganizationContent drops those on fetch, so
+     *  every render site can treat this as present. */
     user: {
         _id: string;
         email: string;
@@ -699,6 +709,13 @@ interface SettingsNavigationAdapter {
     getCheckoutReturnUrl?: (kind: "success" | "cancel") => string;
     /** Imperative navigate to another settings tab. */
     navigateToTab: (tab: SettingsTab) => void;
+    /**
+     * Leave settings entirely. Supplying this makes the shell render a close (×)
+     * button and dismiss on Escape. Hosts that would rather pass a callback
+     * directly can use the `onClose` prop on `<SettingsContent>` instead — it
+     * takes precedence over this.
+     */
+    close?: () => void;
     /** External-link navigate (e.g. for "What's new" or referral promo links). */
     openExternal: (url: string) => void;
 }
@@ -726,7 +743,7 @@ type WorkspaceInfo = SettingsWorkspaceListItem & {
     plan?: string;
     ownerEmail?: string;
 };
-declare function ProfileTab(): react_jsx_runtime.JSX.Element;
+declare function ProfileTab(): react.JSX.Element;
 declare function WorkspaceTab({ workspaces, loading, onCreateClick: _onCreateClick, onEditClick, onSwitchClick, onLeaveClick, }: {
     workspaces: WorkspaceInfo[];
     loading: boolean;
@@ -734,21 +751,31 @@ declare function WorkspaceTab({ workspaces, loading, onCreateClick: _onCreateCli
     onEditClick: (ws: WorkspaceInfo) => void;
     onSwitchClick: (ws: WorkspaceInfo) => void;
     onLeaveClick: (ws: WorkspaceInfo) => void;
-}): react_jsx_runtime.JSX.Element;
-declare function ReferralTab(): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
+declare function ReferralTab(): react.JSX.Element;
 interface SettingsContentProps {
     adapters: SettingsAdapters;
     /** Currently active tab. The host owns routing and resolves this from the URL. */
     activeTab?: SettingsTab;
+    /**
+     * Leave settings. When supplied, the shell renders a close (×) button in the
+     * header and dismisses on Escape; the host decides where "closed" goes
+     * (settings is a full route in most hosts, not an overlay).
+     *
+     * Falls back to `adapters.navigation.close` so hosts that already build an
+     * adapter object don't have to thread a second prop through. Omit both and
+     * no close affordance is rendered — that is the pre-0.3.8 behaviour.
+     */
+    onClose?: () => void;
 }
-declare function SettingsContent({ adapters, activeTab }: SettingsContentProps): react_jsx_runtime.JSX.Element;
+declare function SettingsContent({ adapters, activeTab, onClose, }: SettingsContentProps): react.JSX.Element;
 
 type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width' | 'height'> & {
     color?: string;
     strokeWidth?: number | string;
     size?: number | string;
 };
-declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react_jsx_runtime.JSX.Element;
+declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
 declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, }?: {
     embedded?: boolean;
@@ -756,19 +783,19 @@ declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlan
      *  wrapper) owns it so it can hide the sub-nav + show the Plans breadcrumb. */
     showPlans?: boolean;
     onShowPlansChange?: (open: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react__default.JSX.Element;
 
 declare function TeamsContent({ embedded, onInviteOpen, onInviteOpenChange, }?: {
     embedded?: boolean;
     onInviteOpen?: boolean;
     onInviteOpenChange?: (open: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 declare function OrganizationContent({ embedded, onInviteOpen, onInviteOpenChange, }?: {
     embedded?: boolean;
     onInviteOpen?: boolean;
     onInviteOpenChange?: (open: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 declare function TokensContent({ embedded, showRevokedOverride, onShowRevokedChange: _onShowRevokedChange, createOpenOverride, onCreateOpenChange, }?: {
     embedded?: boolean;
@@ -776,7 +803,7 @@ declare function TokensContent({ embedded, showRevokedOverride, onShowRevokedCha
     onShowRevokedChange?: (v: boolean) => void;
     createOpenOverride?: boolean;
     onCreateOpenChange?: (v: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 interface ProfileAvatarProps {
     name: string;
@@ -789,7 +816,25 @@ interface ProfileAvatarProps {
  * Renders a profile/workspace avatar using ScDp.
  * Automatically shows image or initials fallback.
  */
-declare function ProfileAvatar({ name, profileImage, size, initialsClassName, borderRadius, }: ProfileAvatarProps): react_jsx_runtime.JSX.Element;
+declare function ProfileAvatar({ name, profileImage, size, initialsClassName, borderRadius, }: ProfileAvatarProps): react.JSX.Element;
+
+type SettingsTooltipPlacement = "right" | "top" | "bottom";
+interface SettingsTooltipProps {
+    /** Explanation shown on hover / keyboard focus. Falsy renders the child bare. */
+    content?: ReactNode;
+    /** Preferred side. Flips to the opposite side when it would overflow. */
+    placement?: SettingsTooltipPlacement;
+    /** Milliseconds to hover before the tooltip opens. Closing is immediate. */
+    delay?: number;
+    children: ReactNode;
+    className?: string;
+    /**
+     * The wrapper defaults to `display: block` so full-width nav rows keep their
+     * width. Set this for triggers that sit inside a flex row (buttons, chips).
+     */
+    inline?: boolean;
+}
+declare function SettingsTooltip({ content, placement, delay, children, className, inline, }: SettingsTooltipProps): react.JSX.Element;
 
 interface WorkspaceData {
     id: string;
@@ -812,7 +857,7 @@ interface WorkspaceModalProps {
     onLeave?: () => void | boolean | Promise<void | boolean>;
     onDelete?: () => void | boolean | Promise<void | boolean>;
 }
-declare function WorkspaceModal({ open, mode, workspace, onClose, onCreate, onUpdate, onLeave, onDelete, }: WorkspaceModalProps): react_jsx_runtime.JSX.Element | null;
+declare function WorkspaceModal({ open, mode, workspace, onClose, onCreate, onUpdate, onLeave, onDelete, }: WorkspaceModalProps): react.JSX.Element | null;
 
 interface OrganizationData {
     id: string;
@@ -832,7 +877,7 @@ interface OrganizationModalProps {
     onUpdate?: (name: string, imageFile: File | null, imageRemoved: boolean) => void | boolean | Promise<void | boolean>;
     onDelete?: () => void | boolean | Promise<void | boolean>;
 }
-declare function OrganizationModal({ open, mode, organization, onClose, onCreate, onUpdate, onDelete, }: OrganizationModalProps): react_jsx_runtime.JSX.Element | null;
+declare function OrganizationModal({ open, mode, organization, onClose, onCreate, onUpdate, onDelete, }: OrganizationModalProps): react.JSX.Element | null;
 
 type ModalMode$1 = "invite" | "update";
 interface OrganizationInviteModalProps {
@@ -861,7 +906,7 @@ interface OrganizationInviteModalProps {
     }) => void;
     onRemove?: () => void;
 }
-declare function OrganizationInviteModal({ open, mode, userEmail, initialRole, initialInviteAccess, allowSubmitWithoutChanges, canRemove, onClose, onInviteEmail, onInviteDomain, onUpdate, onRemove, }: OrganizationInviteModalProps): react_jsx_runtime.JSX.Element | null;
+declare function OrganizationInviteModal({ open, mode, userEmail, initialRole, initialInviteAccess, allowSubmitWithoutChanges, canRemove, onClose, onInviteEmail, onInviteDomain, onUpdate, onRemove, }: OrganizationInviteModalProps): react.JSX.Element | null;
 
 interface ConfirmLeaveModalProps {
     open: boolean;
@@ -873,7 +918,7 @@ interface ConfirmLeaveModalProps {
     /** Called when user clicks "Go to Teams" in the sole admin variant */
     onGoToTeams?: () => void;
 }
-declare function ConfirmLeaveModal({ open, workspaceName, isSoleAdmin, onClose, onConfirm, onGoToTeams, }: ConfirmLeaveModalProps): react_jsx_runtime.JSX.Element | null;
+declare function ConfirmLeaveModal({ open, workspaceName, isSoleAdmin, onClose, onConfirm, onGoToTeams, }: ConfirmLeaveModalProps): react.JSX.Element | null;
 
 interface ConfirmDeleteModalProps {
     open: boolean;
@@ -881,7 +926,7 @@ interface ConfirmDeleteModalProps {
     onClose: () => void;
     onConfirm: () => void | Promise<void>;
 }
-declare function ConfirmDeleteModal({ open, workspaceName, onClose, onConfirm, }: ConfirmDeleteModalProps): react_jsx_runtime.JSX.Element | null;
+declare function ConfirmDeleteModal({ open, workspaceName, onClose, onConfirm, }: ConfirmDeleteModalProps): react.JSX.Element | null;
 
 interface BuyCreditsModalProps {
     currencySymbol?: string;
@@ -889,7 +934,7 @@ interface BuyCreditsModalProps {
     onClose: () => void;
     onBuy: (credits: number, price: number) => void;
 }
-declare function BuyCreditsModal({ currencySymbol, country, onClose, onBuy, }: BuyCreditsModalProps): react_jsx_runtime.JSX.Element;
+declare function BuyCreditsModal({ currencySymbol, country, onClose, onBuy, }: BuyCreditsModalProps): react.JSX.Element;
 
 interface UserPermissions {
     artifax: boolean;
@@ -937,19 +982,19 @@ interface InviteUpdateModalProps {
     /** Called only in invite mode; receives (permissions, email) */
     onInvite?: (permissions: UserPermissions, email: string) => void;
 }
-declare function InviteUpdateModal({ open, mode, userEmail, stores, allowSubmitWithoutChanges, initialPermissions, onClose, onSave, onRemove, canRemove, onInvite, }: InviteUpdateModalProps): react_jsx_runtime.JSX.Element | null;
+declare function InviteUpdateModal({ open, mode, userEmail, stores, allowSubmitWithoutChanges, initialPermissions, onClose, onSave, onRemove, canRemove, onInvite, }: InviteUpdateModalProps): react.JSX.Element | null;
 
 interface ExportDateModalProps {
     title: string;
     onClose: () => void;
     onExport: (startDate: Date, endDate: Date) => void;
 }
-declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react_jsx_runtime.JSX.Element;
+declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react.JSX.Element;
 
 declare function SettingsAdaptersProvider({ adapters, children, }: {
     adapters: SettingsAdapters;
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /**
  * Read the host-provided adapters from anywhere inside <SettingsContent>.
  * Throws at runtime if used outside the provider — which only happens if a
@@ -957,4 +1002,4 @@ declare function SettingsAdaptersProvider({ adapters, children, }: {
  */
 declare function useSettingsAdapters(): SettingsAdapters;
 
-export { type ApiToken, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, OrganizationInviteModal, type OrganizationInviteModalProps, type OrganizationJoinRequest, type OrganizationMember, OrganizationModal, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCurrent, type SettingsOrganizationListItem, type SettingsTab, type SettingsToastAdapter, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_LABELS, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserPermissions, type WorkspaceData, type WorkspaceInvite, type WorkspaceMember, WorkspaceModal, WorkspaceTab, resolveSettingsTabFromPath, useSettingsAdapters };
+export { type ApiToken, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, OrganizationInviteModal, type OrganizationInviteModalProps, type OrganizationJoinRequest, type OrganizationMember, OrganizationModal, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCurrent, type SettingsOrganizationListItem, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserPermissions, type WorkspaceData, type WorkspaceInvite, type WorkspaceMember, WorkspaceModal, WorkspaceTab, resolveSettingsTabFromPath, useSettingsAdapters };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { SVGProps, ReactNode } from 'react';
+import * as react from 'react';
+import react__default, { SVGProps, ReactNode } from 'react';
 
 /**
  * Settings tab identifiers and URL mapping helpers.
@@ -16,6 +16,13 @@ declare const TAB_TO_URL: Record<SettingsTab, string>;
 declare const URL_TO_TAB: Record<string, SettingsTab>;
 /** Human-readable label for each tab (used for breadcrumbs etc.). */
 declare const TAB_LABELS: Record<SettingsTab, string>;
+/**
+ * One-line explanation of what each destination is for, shown on hover over the
+ * settings sub-nav. Kept next to `TAB_LABELS` so a new tab can't get a label
+ * without also getting an explanation — `Record<SettingsTab, string>` makes
+ * omitting one a type error.
+ */
+declare const TAB_DESCRIPTIONS: Record<SettingsTab, string>;
 /**
  * Resolve a `SettingsTab` from a URL pathname. Looks for the last segment that
  * matches a known slug; falls back to `"profile"` (the default Account tab).
@@ -196,6 +203,9 @@ interface OrganizationMember {
     _id: string;
     role: "admin" | "member";
     inviteAccess: boolean;
+    /** Populated user. Rows whose user document was deleted come back from the
+     *  API with a null `user` — OrganizationContent drops those on fetch, so
+     *  every render site can treat this as present. */
     user: {
         _id: string;
         email: string;
@@ -699,6 +709,13 @@ interface SettingsNavigationAdapter {
     getCheckoutReturnUrl?: (kind: "success" | "cancel") => string;
     /** Imperative navigate to another settings tab. */
     navigateToTab: (tab: SettingsTab) => void;
+    /**
+     * Leave settings entirely. Supplying this makes the shell render a close (×)
+     * button and dismiss on Escape. Hosts that would rather pass a callback
+     * directly can use the `onClose` prop on `<SettingsContent>` instead — it
+     * takes precedence over this.
+     */
+    close?: () => void;
     /** External-link navigate (e.g. for "What's new" or referral promo links). */
     openExternal: (url: string) => void;
 }
@@ -726,7 +743,7 @@ type WorkspaceInfo = SettingsWorkspaceListItem & {
     plan?: string;
     ownerEmail?: string;
 };
-declare function ProfileTab(): react_jsx_runtime.JSX.Element;
+declare function ProfileTab(): react.JSX.Element;
 declare function WorkspaceTab({ workspaces, loading, onCreateClick: _onCreateClick, onEditClick, onSwitchClick, onLeaveClick, }: {
     workspaces: WorkspaceInfo[];
     loading: boolean;
@@ -734,21 +751,31 @@ declare function WorkspaceTab({ workspaces, loading, onCreateClick: _onCreateCli
     onEditClick: (ws: WorkspaceInfo) => void;
     onSwitchClick: (ws: WorkspaceInfo) => void;
     onLeaveClick: (ws: WorkspaceInfo) => void;
-}): react_jsx_runtime.JSX.Element;
-declare function ReferralTab(): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
+declare function ReferralTab(): react.JSX.Element;
 interface SettingsContentProps {
     adapters: SettingsAdapters;
     /** Currently active tab. The host owns routing and resolves this from the URL. */
     activeTab?: SettingsTab;
+    /**
+     * Leave settings. When supplied, the shell renders a close (×) button in the
+     * header and dismisses on Escape; the host decides where "closed" goes
+     * (settings is a full route in most hosts, not an overlay).
+     *
+     * Falls back to `adapters.navigation.close` so hosts that already build an
+     * adapter object don't have to thread a second prop through. Omit both and
+     * no close affordance is rendered — that is the pre-0.3.8 behaviour.
+     */
+    onClose?: () => void;
 }
-declare function SettingsContent({ adapters, activeTab }: SettingsContentProps): react_jsx_runtime.JSX.Element;
+declare function SettingsContent({ adapters, activeTab, onClose, }: SettingsContentProps): react.JSX.Element;
 
 type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width' | 'height'> & {
     color?: string;
     strokeWidth?: number | string;
     size?: number | string;
 };
-declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react_jsx_runtime.JSX.Element;
+declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
 declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, }?: {
     embedded?: boolean;
@@ -756,19 +783,19 @@ declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlan
      *  wrapper) owns it so it can hide the sub-nav + show the Plans breadcrumb. */
     showPlans?: boolean;
     onShowPlansChange?: (open: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react__default.JSX.Element;
 
 declare function TeamsContent({ embedded, onInviteOpen, onInviteOpenChange, }?: {
     embedded?: boolean;
     onInviteOpen?: boolean;
     onInviteOpenChange?: (open: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 declare function OrganizationContent({ embedded, onInviteOpen, onInviteOpenChange, }?: {
     embedded?: boolean;
     onInviteOpen?: boolean;
     onInviteOpenChange?: (open: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 declare function TokensContent({ embedded, showRevokedOverride, onShowRevokedChange: _onShowRevokedChange, createOpenOverride, onCreateOpenChange, }?: {
     embedded?: boolean;
@@ -776,7 +803,7 @@ declare function TokensContent({ embedded, showRevokedOverride, onShowRevokedCha
     onShowRevokedChange?: (v: boolean) => void;
     createOpenOverride?: boolean;
     onCreateOpenChange?: (v: boolean) => void;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 
 interface ProfileAvatarProps {
     name: string;
@@ -789,7 +816,25 @@ interface ProfileAvatarProps {
  * Renders a profile/workspace avatar using ScDp.
  * Automatically shows image or initials fallback.
  */
-declare function ProfileAvatar({ name, profileImage, size, initialsClassName, borderRadius, }: ProfileAvatarProps): react_jsx_runtime.JSX.Element;
+declare function ProfileAvatar({ name, profileImage, size, initialsClassName, borderRadius, }: ProfileAvatarProps): react.JSX.Element;
+
+type SettingsTooltipPlacement = "right" | "top" | "bottom";
+interface SettingsTooltipProps {
+    /** Explanation shown on hover / keyboard focus. Falsy renders the child bare. */
+    content?: ReactNode;
+    /** Preferred side. Flips to the opposite side when it would overflow. */
+    placement?: SettingsTooltipPlacement;
+    /** Milliseconds to hover before the tooltip opens. Closing is immediate. */
+    delay?: number;
+    children: ReactNode;
+    className?: string;
+    /**
+     * The wrapper defaults to `display: block` so full-width nav rows keep their
+     * width. Set this for triggers that sit inside a flex row (buttons, chips).
+     */
+    inline?: boolean;
+}
+declare function SettingsTooltip({ content, placement, delay, children, className, inline, }: SettingsTooltipProps): react.JSX.Element;
 
 interface WorkspaceData {
     id: string;
@@ -812,7 +857,7 @@ interface WorkspaceModalProps {
     onLeave?: () => void | boolean | Promise<void | boolean>;
     onDelete?: () => void | boolean | Promise<void | boolean>;
 }
-declare function WorkspaceModal({ open, mode, workspace, onClose, onCreate, onUpdate, onLeave, onDelete, }: WorkspaceModalProps): react_jsx_runtime.JSX.Element | null;
+declare function WorkspaceModal({ open, mode, workspace, onClose, onCreate, onUpdate, onLeave, onDelete, }: WorkspaceModalProps): react.JSX.Element | null;
 
 interface OrganizationData {
     id: string;
@@ -832,7 +877,7 @@ interface OrganizationModalProps {
     onUpdate?: (name: string, imageFile: File | null, imageRemoved: boolean) => void | boolean | Promise<void | boolean>;
     onDelete?: () => void | boolean | Promise<void | boolean>;
 }
-declare function OrganizationModal({ open, mode, organization, onClose, onCreate, onUpdate, onDelete, }: OrganizationModalProps): react_jsx_runtime.JSX.Element | null;
+declare function OrganizationModal({ open, mode, organization, onClose, onCreate, onUpdate, onDelete, }: OrganizationModalProps): react.JSX.Element | null;
 
 type ModalMode$1 = "invite" | "update";
 interface OrganizationInviteModalProps {
@@ -861,7 +906,7 @@ interface OrganizationInviteModalProps {
     }) => void;
     onRemove?: () => void;
 }
-declare function OrganizationInviteModal({ open, mode, userEmail, initialRole, initialInviteAccess, allowSubmitWithoutChanges, canRemove, onClose, onInviteEmail, onInviteDomain, onUpdate, onRemove, }: OrganizationInviteModalProps): react_jsx_runtime.JSX.Element | null;
+declare function OrganizationInviteModal({ open, mode, userEmail, initialRole, initialInviteAccess, allowSubmitWithoutChanges, canRemove, onClose, onInviteEmail, onInviteDomain, onUpdate, onRemove, }: OrganizationInviteModalProps): react.JSX.Element | null;
 
 interface ConfirmLeaveModalProps {
     open: boolean;
@@ -873,7 +918,7 @@ interface ConfirmLeaveModalProps {
     /** Called when user clicks "Go to Teams" in the sole admin variant */
     onGoToTeams?: () => void;
 }
-declare function ConfirmLeaveModal({ open, workspaceName, isSoleAdmin, onClose, onConfirm, onGoToTeams, }: ConfirmLeaveModalProps): react_jsx_runtime.JSX.Element | null;
+declare function ConfirmLeaveModal({ open, workspaceName, isSoleAdmin, onClose, onConfirm, onGoToTeams, }: ConfirmLeaveModalProps): react.JSX.Element | null;
 
 interface ConfirmDeleteModalProps {
     open: boolean;
@@ -881,7 +926,7 @@ interface ConfirmDeleteModalProps {
     onClose: () => void;
     onConfirm: () => void | Promise<void>;
 }
-declare function ConfirmDeleteModal({ open, workspaceName, onClose, onConfirm, }: ConfirmDeleteModalProps): react_jsx_runtime.JSX.Element | null;
+declare function ConfirmDeleteModal({ open, workspaceName, onClose, onConfirm, }: ConfirmDeleteModalProps): react.JSX.Element | null;
 
 interface BuyCreditsModalProps {
     currencySymbol?: string;
@@ -889,7 +934,7 @@ interface BuyCreditsModalProps {
     onClose: () => void;
     onBuy: (credits: number, price: number) => void;
 }
-declare function BuyCreditsModal({ currencySymbol, country, onClose, onBuy, }: BuyCreditsModalProps): react_jsx_runtime.JSX.Element;
+declare function BuyCreditsModal({ currencySymbol, country, onClose, onBuy, }: BuyCreditsModalProps): react.JSX.Element;
 
 interface UserPermissions {
     artifax: boolean;
@@ -937,19 +982,19 @@ interface InviteUpdateModalProps {
     /** Called only in invite mode; receives (permissions, email) */
     onInvite?: (permissions: UserPermissions, email: string) => void;
 }
-declare function InviteUpdateModal({ open, mode, userEmail, stores, allowSubmitWithoutChanges, initialPermissions, onClose, onSave, onRemove, canRemove, onInvite, }: InviteUpdateModalProps): react_jsx_runtime.JSX.Element | null;
+declare function InviteUpdateModal({ open, mode, userEmail, stores, allowSubmitWithoutChanges, initialPermissions, onClose, onSave, onRemove, canRemove, onInvite, }: InviteUpdateModalProps): react.JSX.Element | null;
 
 interface ExportDateModalProps {
     title: string;
     onClose: () => void;
     onExport: (startDate: Date, endDate: Date) => void;
 }
-declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react_jsx_runtime.JSX.Element;
+declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react.JSX.Element;
 
 declare function SettingsAdaptersProvider({ adapters, children, }: {
     adapters: SettingsAdapters;
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): react.JSX.Element;
 /**
  * Read the host-provided adapters from anywhere inside <SettingsContent>.
  * Throws at runtime if used outside the provider — which only happens if a
@@ -957,4 +1002,4 @@ declare function SettingsAdaptersProvider({ adapters, children, }: {
  */
 declare function useSettingsAdapters(): SettingsAdapters;
 
-export { type ApiToken, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, OrganizationInviteModal, type OrganizationInviteModalProps, type OrganizationJoinRequest, type OrganizationMember, OrganizationModal, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCurrent, type SettingsOrganizationListItem, type SettingsTab, type SettingsToastAdapter, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_LABELS, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserPermissions, type WorkspaceData, type WorkspaceInvite, type WorkspaceMember, WorkspaceModal, WorkspaceTab, resolveSettingsTabFromPath, useSettingsAdapters };
+export { type ApiToken, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, OrganizationInviteModal, type OrganizationInviteModalProps, type OrganizationJoinRequest, type OrganizationMember, OrganizationModal, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCurrent, type SettingsOrganizationListItem, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserPermissions, type WorkspaceData, type WorkspaceInvite, type WorkspaceMember, WorkspaceModal, WorkspaceTab, resolveSettingsTabFromPath, useSettingsAdapters };