@streamoid/settings 0.7.9 → 0.7.10

package/dist/index.d.mts

@@ -737,6 +737,48 @@ interface BuyCreditsResponse {
     availableCredits?: number;
     credits?: number;
 }
+type MemberCreditLimitSource = "override" | "default" | "none";
+/** One member's per-billing-cycle credit limit and usage. */
+interface MemberCreditLimit {
+    /** = `WorkspaceMember.user._id`. */
+    userId: string;
+    /** The EFFECTIVE limit (override, else the workspace default); `null` = unlimited. */
+    limit: number | null;
+    /** Where `limit` comes from. Absent on older servers: treat as no default. */
+    source?: MemberCreditLimitSource;
+    /** `true` only when the member has their own override record. */
+    hasLimit: boolean;
+    /** Credits used this billing cycle. */
+    used: number;
+    /** `null` when unlimited. */
+    remaining: number | null;
+    /** Previous billing cycle usage. */
+    lastCycleUsed: number;
+    setBy?: string;
+    updatedAt?: string;
+}
+interface MemberCreditLimitsResponse {
+    cycle: {
+        start: string;
+        end: string;
+    };
+    previousCycle: {
+        start: string;
+        end: string;
+    };
+    /**
+     * The workspace default per-member limit. `null` / absent = no default set
+     * (members without an override are unlimited); `limit: null` = the default
+     * is Unlimited.
+     */
+    default?: {
+        limit: number | null;
+        setBy?: string;
+        updatedAt?: string;
+    } | null;
+    /** Only members with an override or with usage; the rest follow the default. */
+    users: MemberCreditLimit[];
+}
 /**
  * The API adapter is split into three concern areas (billing / teams /
  * tokens) but kept flat to match the original spec. Methods are grouped with
@@ -852,6 +894,22 @@ interface SettingsApiAdapter {
     getHighestRole?: () => Promise<{
         role: "admin" | "member";
     }>;
+    /**
+     * Per-member credit limits and usage for the current billing cycle. When
+     * omitted, Billing hides the "Per-user usage limits" entry.
+     */
+    fetchMemberCreditLimits?: () => Promise<MemberCreditLimitsResponse>;
+    /** Set a member's limit per billing cycle; `limit: null` means unlimited.
+     *  Rejects with code `LIMIT_BELOW_USAGE` when under the member's usage. */
+    setMemberCreditLimit?: (input: {
+        userId: string;
+        limit: number | null;
+    }) => Promise<void>;
+    /** Remove the override entirely (the member follows the workspace default). */
+    removeMemberCreditLimit?: (userId: string) => Promise<void>;
+    /** Set the workspace default per-member limit; `null` means Unlimited.
+     *  Applies to members without their own override. Throws on error. */
+    setDefaultCreditLimit?: (limit: number | null) => Promise<void>;
     fetchTokens: (params?: {
         showRevoked?: boolean;
     }) => Promise<ApiToken[]>;
@@ -1118,12 +1176,16 @@ type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width'
 };
 declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
-declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, }?: {
+declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, }?: {
     embedded?: boolean;
     /** Controlled "plans" sub-view flag. When provided, the host (settings
      *  wrapper) owns it so it can hide the sub-nav + show the Plans breadcrumb. */
     showPlans?: boolean;
     onShowPlansChange?: (open: boolean) => void;
+    /** Controlled "per-user limits" sub-view flag; same contract as `showPlans`.
+     *  Only reachable when `api.fetchMemberCreditLimits` exists. */
+    showPerUserLimits?: boolean;
+    onShowPerUserLimitsChange?: (open: boolean) => void;
 }): react__default.JSX.Element;
 
 declare function TeamsContent({ embedded, onInviteOpen, onInviteOpenChange, workspaceName, workspaceImageUrl, organizationName, hiddenApps, }?: {
@@ -1481,6 +1543,118 @@ interface ExportDateModalProps {
 }
 declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react.JSX.Element;
 
+type CreditCycleUnit = "month" | "year";
+type CreditLimitValidation = {
+    ok: true;
+    value: number;
+} | {
+    ok: false;
+    reason: string;
+};
+/** A member joined with their (possibly absent) limit record. */
+interface MemberCreditLimitRow {
+    member: WorkspaceMember;
+    userId: string;
+    /** Effective limit: the override, else the workspace default. */
+    limit: number | null;
+    source: MemberCreditLimitSource;
+    /** True only when the member has their own override. */
+    hasLimit: boolean;
+    used: number;
+    lastCycleUsed: number;
+}
+/** "year" for a cycle longer than ~200 days, otherwise "month". */
+declare function creditCycleUnit(cycle?: {
+    start: string;
+    end: string;
+} | null): CreditCycleUnit;
+/** `1000, "month"` → "1,000 credits / month"; `null` → "Unlimited". */
+declare function formatCreditLimit(limit: number | null, unit: CreditCycleUnit): string;
+/**
+ * Credits used, as billing counts them: two decimals. Sums of two-decimal
+ * amounts arrive with float noise (3.0000000000000004), which would otherwise
+ * refuse a limit of 3.
+ */
+declare function roundCredits(value: number): number;
+/** The smallest whole-number limit allowed over `used`: what the input can take. */
+declare function minimumCreditLimit(used: number): number;
+/** Credits for display: grouped, at most two decimals. */
+declare function formatCredits(value: number): string;
+/** The default limit has no usage floor: lowering it under usage is allowed. */
+declare function validateDefaultCreditLimitInput(raw: string): CreditLimitValidation;
+/** Digits-only input, an integer, and not below what was already used. */
+declare function validateCreditLimitInput(raw: string, used: number): CreditLimitValidation;
+/** Why a limit was refused for being under `used`, naming the least it can be. */
+declare function belowUsageReason(used: number): string;
+/** The default limit as text: "500 credits / month", or "Unlimited" (also when unset). */
+declare function describeDefaultLimit(response: MemberCreditLimitsResponse | null | undefined, unit: CreditCycleUnit): string;
+/** A member's effective limit as text: "500 credits / month" or "Unlimited". */
+declare function describeMemberLimit(row: Pick<MemberCreditLimitRow, "limit">, unit: CreditCycleUnit): string;
+/** "Custom" for an override, "Default" when following the default, else null. */
+declare function limitSourceLabel(row: Pick<MemberCreditLimitRow, "source">): "Custom" | "Default" | null;
+/**
+ * Members listed by the server keep its figures. Members it does not list
+ * follow the workspace default (none set = unlimited), with no usage.
+ */
+declare function joinMembersWithLimits(members: WorkspaceMember[], response: MemberCreditLimitsResponse | null | undefined): MemberCreditLimitRow[];
+
+/**
+ * True when a per-user credit limit was rejected for being under what the
+ * member already used this cycle. The raw server code does not survive
+ * `UserFacingError` normalization in `err.code` (that is rewritten to a
+ * category), so the original body is searched too: `code`, `error.code`,
+ * `body.*`, `data.*`, `publicError.*` and `cause`, to a shallow depth.
+ */
+declare function isLimitBelowUsage(failure: unknown): boolean;
+/**
+ * What the server says the member has used, from a `LIMIT_BELOW_USAGE`
+ * rejection: fresher than the figure the list was loaded with, when they have
+ * spent more since. `null` when the failure is not one, or carries no figure.
+ */
+declare function limitBelowUsageUsed(failure: unknown): number | null;
+
+/** Billing sub-view: per-member credit limits for the current billing cycle. */
+declare function PerUserLimitsView(): react.JSX.Element;
+
+interface MemberCreditLimitModalProps {
+    open: boolean;
+    /** Modal title; defaults to "Set custom usage limit". */
+    title?: string;
+    /** Explanatory text under the title block (e.g. for the workspace default). */
+    description?: string;
+    /** Whose limit this is. Omit for the workspace default: no member block, no usage line. */
+    subject?: {
+        name?: string;
+        email: string;
+    };
+    /** Changing this resets the form (a different member, say). */
+    resetKey?: string;
+    /** Credits used this billing cycle; 0 for the default, so no "at least" rule. */
+    used: number;
+    /** Limit to pre-select; `null` = Unlimited. */
+    initialLimit: number | null;
+    /** Whether a stored value exists. When false, saving is always allowed (it creates one). */
+    isSet: boolean;
+    unit: CreditCycleUnit;
+    /** Persist the limit (`null` = Unlimited). Throw on failure. */
+    onSave: (limit: number | null) => Promise<void>;
+    /** Persist removal. When omitted, no Remove button. */
+    onRemove?: () => Promise<void>;
+    /** Remove button label; defaults to "Remove". */
+    removeLabel?: string;
+    /** Muted line explaining what Remove does. */
+    removeHint?: string;
+    saveSuccessMessage?: string;
+    removeSuccessMessage?: string;
+    onClose: () => void;
+    /** Called after a successful save/remove; the parent refetches. */
+    onSaved: () => void;
+    /** Called when the server's figures differ from the ones shown; the parent refetches. */
+    onStale?: () => void;
+}
+/** A fixed number of credits per cycle, or unlimited — for one member or the workspace default. */
+declare function MemberCreditLimitModal({ open, title, description, subject, resetKey, used, initialLimit, isSet, unit, onSave, onRemove, removeLabel, removeHint, saveSuccessMessage, removeSuccessMessage, onClose, onSaved, onStale, }: MemberCreditLimitModalProps): react.JSX.Element | null;
+
 declare function SettingsAdaptersProvider({ adapters, children, }: {
     adapters: SettingsAdapters;
     children: ReactNode;
@@ -1492,4 +1666,4 @@ declare function SettingsAdaptersProvider({ adapters, children, }: {
  */
 declare function useSettingsAdapters(): SettingsAdapters;
 
-export { APP_KEYS, type ApiToken, type AppKey, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, OrganizationModal, type OrganizationView, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, 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 SettingsScope, 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_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, countLabel, groupWorkspaceList, loadWorkspaceOrganization, resolveSettingsTabFromPath, useSettingsAdapters, useWorkspaceOrganization, userLanguageLabel };
+export { APP_KEYS, type ApiToken, type AppKey, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, OrganizationModal, type OrganizationView, type OrganizationWorkspaceItem, PerUserLimitsView, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, 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 SettingsScope, 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_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, countLabel, creditCycleUnit, describeDefaultLimit, describeMemberLimit, formatCreditLimit, formatCredits, groupWorkspaceList, isLimitBelowUsage, joinMembersWithLimits, limitBelowUsageUsed, limitSourceLabel, loadWorkspaceOrganization, minimumCreditLimit, resolveSettingsTabFromPath, roundCredits, useSettingsAdapters, useWorkspaceOrganization, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput };

package/dist/index.d.ts

@@ -737,6 +737,48 @@ interface BuyCreditsResponse {
     availableCredits?: number;
     credits?: number;
 }
+type MemberCreditLimitSource = "override" | "default" | "none";
+/** One member's per-billing-cycle credit limit and usage. */
+interface MemberCreditLimit {
+    /** = `WorkspaceMember.user._id`. */
+    userId: string;
+    /** The EFFECTIVE limit (override, else the workspace default); `null` = unlimited. */
+    limit: number | null;
+    /** Where `limit` comes from. Absent on older servers: treat as no default. */
+    source?: MemberCreditLimitSource;
+    /** `true` only when the member has their own override record. */
+    hasLimit: boolean;
+    /** Credits used this billing cycle. */
+    used: number;
+    /** `null` when unlimited. */
+    remaining: number | null;
+    /** Previous billing cycle usage. */
+    lastCycleUsed: number;
+    setBy?: string;
+    updatedAt?: string;
+}
+interface MemberCreditLimitsResponse {
+    cycle: {
+        start: string;
+        end: string;
+    };
+    previousCycle: {
+        start: string;
+        end: string;
+    };
+    /**
+     * The workspace default per-member limit. `null` / absent = no default set
+     * (members without an override are unlimited); `limit: null` = the default
+     * is Unlimited.
+     */
+    default?: {
+        limit: number | null;
+        setBy?: string;
+        updatedAt?: string;
+    } | null;
+    /** Only members with an override or with usage; the rest follow the default. */
+    users: MemberCreditLimit[];
+}
 /**
  * The API adapter is split into three concern areas (billing / teams /
  * tokens) but kept flat to match the original spec. Methods are grouped with
@@ -852,6 +894,22 @@ interface SettingsApiAdapter {
     getHighestRole?: () => Promise<{
         role: "admin" | "member";
     }>;
+    /**
+     * Per-member credit limits and usage for the current billing cycle. When
+     * omitted, Billing hides the "Per-user usage limits" entry.
+     */
+    fetchMemberCreditLimits?: () => Promise<MemberCreditLimitsResponse>;
+    /** Set a member's limit per billing cycle; `limit: null` means unlimited.
+     *  Rejects with code `LIMIT_BELOW_USAGE` when under the member's usage. */
+    setMemberCreditLimit?: (input: {
+        userId: string;
+        limit: number | null;
+    }) => Promise<void>;
+    /** Remove the override entirely (the member follows the workspace default). */
+    removeMemberCreditLimit?: (userId: string) => Promise<void>;
+    /** Set the workspace default per-member limit; `null` means Unlimited.
+     *  Applies to members without their own override. Throws on error. */
+    setDefaultCreditLimit?: (limit: number | null) => Promise<void>;
     fetchTokens: (params?: {
         showRevoked?: boolean;
     }) => Promise<ApiToken[]>;
@@ -1118,12 +1176,16 @@ type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width'
 };
 declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
-declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, }?: {
+declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, }?: {
     embedded?: boolean;
     /** Controlled "plans" sub-view flag. When provided, the host (settings
      *  wrapper) owns it so it can hide the sub-nav + show the Plans breadcrumb. */
     showPlans?: boolean;
     onShowPlansChange?: (open: boolean) => void;
+    /** Controlled "per-user limits" sub-view flag; same contract as `showPlans`.
+     *  Only reachable when `api.fetchMemberCreditLimits` exists. */
+    showPerUserLimits?: boolean;
+    onShowPerUserLimitsChange?: (open: boolean) => void;
 }): react__default.JSX.Element;
 
 declare function TeamsContent({ embedded, onInviteOpen, onInviteOpenChange, workspaceName, workspaceImageUrl, organizationName, hiddenApps, }?: {
@@ -1481,6 +1543,118 @@ interface ExportDateModalProps {
 }
 declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react.JSX.Element;
 
+type CreditCycleUnit = "month" | "year";
+type CreditLimitValidation = {
+    ok: true;
+    value: number;
+} | {
+    ok: false;
+    reason: string;
+};
+/** A member joined with their (possibly absent) limit record. */
+interface MemberCreditLimitRow {
+    member: WorkspaceMember;
+    userId: string;
+    /** Effective limit: the override, else the workspace default. */
+    limit: number | null;
+    source: MemberCreditLimitSource;
+    /** True only when the member has their own override. */
+    hasLimit: boolean;
+    used: number;
+    lastCycleUsed: number;
+}
+/** "year" for a cycle longer than ~200 days, otherwise "month". */
+declare function creditCycleUnit(cycle?: {
+    start: string;
+    end: string;
+} | null): CreditCycleUnit;
+/** `1000, "month"` → "1,000 credits / month"; `null` → "Unlimited". */
+declare function formatCreditLimit(limit: number | null, unit: CreditCycleUnit): string;
+/**
+ * Credits used, as billing counts them: two decimals. Sums of two-decimal
+ * amounts arrive with float noise (3.0000000000000004), which would otherwise
+ * refuse a limit of 3.
+ */
+declare function roundCredits(value: number): number;
+/** The smallest whole-number limit allowed over `used`: what the input can take. */
+declare function minimumCreditLimit(used: number): number;
+/** Credits for display: grouped, at most two decimals. */
+declare function formatCredits(value: number): string;
+/** The default limit has no usage floor: lowering it under usage is allowed. */
+declare function validateDefaultCreditLimitInput(raw: string): CreditLimitValidation;
+/** Digits-only input, an integer, and not below what was already used. */
+declare function validateCreditLimitInput(raw: string, used: number): CreditLimitValidation;
+/** Why a limit was refused for being under `used`, naming the least it can be. */
+declare function belowUsageReason(used: number): string;
+/** The default limit as text: "500 credits / month", or "Unlimited" (also when unset). */
+declare function describeDefaultLimit(response: MemberCreditLimitsResponse | null | undefined, unit: CreditCycleUnit): string;
+/** A member's effective limit as text: "500 credits / month" or "Unlimited". */
+declare function describeMemberLimit(row: Pick<MemberCreditLimitRow, "limit">, unit: CreditCycleUnit): string;
+/** "Custom" for an override, "Default" when following the default, else null. */
+declare function limitSourceLabel(row: Pick<MemberCreditLimitRow, "source">): "Custom" | "Default" | null;
+/**
+ * Members listed by the server keep its figures. Members it does not list
+ * follow the workspace default (none set = unlimited), with no usage.
+ */
+declare function joinMembersWithLimits(members: WorkspaceMember[], response: MemberCreditLimitsResponse | null | undefined): MemberCreditLimitRow[];
+
+/**
+ * True when a per-user credit limit was rejected for being under what the
+ * member already used this cycle. The raw server code does not survive
+ * `UserFacingError` normalization in `err.code` (that is rewritten to a
+ * category), so the original body is searched too: `code`, `error.code`,
+ * `body.*`, `data.*`, `publicError.*` and `cause`, to a shallow depth.
+ */
+declare function isLimitBelowUsage(failure: unknown): boolean;
+/**
+ * What the server says the member has used, from a `LIMIT_BELOW_USAGE`
+ * rejection: fresher than the figure the list was loaded with, when they have
+ * spent more since. `null` when the failure is not one, or carries no figure.
+ */
+declare function limitBelowUsageUsed(failure: unknown): number | null;
+
+/** Billing sub-view: per-member credit limits for the current billing cycle. */
+declare function PerUserLimitsView(): react.JSX.Element;
+
+interface MemberCreditLimitModalProps {
+    open: boolean;
+    /** Modal title; defaults to "Set custom usage limit". */
+    title?: string;
+    /** Explanatory text under the title block (e.g. for the workspace default). */
+    description?: string;
+    /** Whose limit this is. Omit for the workspace default: no member block, no usage line. */
+    subject?: {
+        name?: string;
+        email: string;
+    };
+    /** Changing this resets the form (a different member, say). */
+    resetKey?: string;
+    /** Credits used this billing cycle; 0 for the default, so no "at least" rule. */
+    used: number;
+    /** Limit to pre-select; `null` = Unlimited. */
+    initialLimit: number | null;
+    /** Whether a stored value exists. When false, saving is always allowed (it creates one). */
+    isSet: boolean;
+    unit: CreditCycleUnit;
+    /** Persist the limit (`null` = Unlimited). Throw on failure. */
+    onSave: (limit: number | null) => Promise<void>;
+    /** Persist removal. When omitted, no Remove button. */
+    onRemove?: () => Promise<void>;
+    /** Remove button label; defaults to "Remove". */
+    removeLabel?: string;
+    /** Muted line explaining what Remove does. */
+    removeHint?: string;
+    saveSuccessMessage?: string;
+    removeSuccessMessage?: string;
+    onClose: () => void;
+    /** Called after a successful save/remove; the parent refetches. */
+    onSaved: () => void;
+    /** Called when the server's figures differ from the ones shown; the parent refetches. */
+    onStale?: () => void;
+}
+/** A fixed number of credits per cycle, or unlimited — for one member or the workspace default. */
+declare function MemberCreditLimitModal({ open, title, description, subject, resetKey, used, initialLimit, isSet, unit, onSave, onRemove, removeLabel, removeHint, saveSuccessMessage, removeSuccessMessage, onClose, onSaved, onStale, }: MemberCreditLimitModalProps): react.JSX.Element | null;
+
 declare function SettingsAdaptersProvider({ adapters, children, }: {
     adapters: SettingsAdapters;
     children: ReactNode;
@@ -1492,4 +1666,4 @@ declare function SettingsAdaptersProvider({ adapters, children, }: {
  */
 declare function useSettingsAdapters(): SettingsAdapters;
 
-export { APP_KEYS, type ApiToken, type AppKey, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, OrganizationModal, type OrganizationView, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, 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 SettingsScope, 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_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, countLabel, groupWorkspaceList, loadWorkspaceOrganization, resolveSettingsTabFromPath, useSettingsAdapters, useWorkspaceOrganization, userLanguageLabel };
+export { APP_KEYS, type ApiToken, type AppKey, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, OrganizationModal, type OrganizationView, type OrganizationWorkspaceItem, PerUserLimitsView, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, 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 SettingsScope, 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_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, countLabel, creditCycleUnit, describeDefaultLimit, describeMemberLimit, formatCreditLimit, formatCredits, groupWorkspaceList, isLimitBelowUsage, joinMembersWithLimits, limitBelowUsageUsed, limitSourceLabel, loadWorkspaceOrganization, minimumCreditLimit, resolveSettingsTabFromPath, roundCredits, useSettingsAdapters, useWorkspaceOrganization, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput };