@danxbot/ui 15.40.0 → 16.0.0

package/dist/types/components/rbac/ProfileForm.d.ts

@@ -11,15 +11,17 @@ export interface ProfileFormSaveInput {
     name: string;
     username?: string;
     email: string;
+    /** Present only when the avatar changed: a URL sets it, `null` removes it. */
+    avatarUrl?: string | null;
 }
 export interface ProfileFormProps {
     account: ProfileFormAccount;
     onSave: (input: ProfileFormSaveInput) => Promise<void>;
+    /** Uploads the file to storage and resolves with its URL. Must NOT change the
+     *  account — the avatar is only persisted by `onSave`. */
     onUploadAvatar: (file: File) => Promise<string>;
-    /** Fired the moment a new avatar finishes uploading (or is removed) — see
-     *  the module header for why the avatar has no separate Save step. */
-    onAvatarChange?: (avatarUrl: string | null) => void;
     saveLabel?: string;
+    discardLabel?: string;
     className?: string;
 }
-export declare function ProfileForm({ account, onSave, onUploadAvatar, onAvatarChange, saveLabel, className, }: ProfileFormProps): import("react").JSX.Element;
+export declare function ProfileForm({ account, onSave, onUploadAvatar, saveLabel, discardLabel, className, }: ProfileFormProps): import("react").JSX.Element;

package/dist/types/components/rbac/ProfilePage.d.ts

@@ -4,8 +4,8 @@ export interface ProfilePageProps {
      *  still locally-editable) `actualUser` display. */
     account?: ProfileFormAccount;
     onSave?: (input: ProfileFormSaveInput) => Promise<void>;
+    /** Uploads the file and resolves with its URL; the avatar is persisted only by `onSave` (DX-4131). */
     onUploadAvatar?: (file: File) => Promise<string>;
-    onAvatarChange?: (avatarUrl: string | null) => void;
     /** DX-4029: `false` omits the page's own title text (the `<h1>` and the
      *  team-name line) so a host layout can own the screen's one `<h1>`. The
      *  read-only avatar (content, not title) stays, and the default `true` is
@@ -13,4 +13,4 @@ export interface ProfilePageProps {
     heading?: boolean;
     className?: string;
 }
-export declare function ProfilePage({ account, onSave, onUploadAvatar, onAvatarChange, heading, className, }: ProfilePageProps): import("react").JSX.Element;
+export declare function ProfilePage({ account, onSave, onUploadAvatar, heading, className, }: ProfilePageProps): import("react").JSX.Element;

package/dist/types/components/rbac/TeamSettingsForm.d.ts

@@ -4,17 +4,19 @@ export interface TeamSettingsFormTeam {
 }
 export interface TeamSettingsFormSaveInput {
     name: string;
+    /** Present only when the logo changed: a URL sets it, `null` removes it. */
+    logoUrl?: string | null;
 }
 export interface TeamSettingsFormProps {
     team: TeamSettingsFormTeam;
     onSave: (input: TeamSettingsFormSaveInput) => Promise<void>;
+    /** Uploads the file to storage and resolves with its URL. Must NOT change the
+     *  team record — the logo is only persisted by `onSave`. */
     onUploadLogo: (file: File) => Promise<string>;
-    /** Fired the moment a new logo finishes uploading (or is removed) — see
-     *  the module header for why the logo has no separate Save step. */
-    onLogoChange?: (logoUrl: string | null) => void;
     /** The viewer lacks `team.update` — every control renders disabled. */
     readOnly?: boolean;
     saveLabel?: string;
+    discardLabel?: string;
     className?: string;
 }
-export declare function TeamSettingsForm({ team, onSave, onUploadLogo, onLogoChange, readOnly, saveLabel, className, }: TeamSettingsFormProps): import("react").JSX.Element;
+export declare function TeamSettingsForm({ team, onSave, onUploadLogo, readOnly, saveLabel, discardLabel, className, }: TeamSettingsFormProps): import("react").JSX.Element;

package/dist/types/components/rbac/stagedForm.d.ts

@@ -0,0 +1,25 @@
+export interface SaveFlow {
+    saving: boolean;
+    /** The last Save resolved and nothing has been edited since. */
+    saved: boolean;
+    error: string | null;
+    /** Run a draft change (an edit, or a Discard) and retire the last outcome. */
+    edit: (change: () => void) => void;
+    /** Run the consumer's `onSave`; a rejection's message (or `failureMessage`) becomes `error`. */
+    save: (run: () => Promise<void>) => Promise<void>;
+}
+export declare function useSaveFlow(failureMessage: string): SaveFlow;
+/** The line under a staged image, naming what Save will do with it. */
+export declare function stagedImageNote(noun: string, saveLabel: string, removed: boolean): string;
+export interface StagedFormActionsProps {
+    onSave: () => void;
+    onDiscard: () => void;
+    /** The draft is valid, changed, and nothing is in flight. */
+    canSave: boolean;
+    /** The draft differs from what is saved in ANY way, including whitespace Save would trim away. */
+    canDiscard: boolean;
+    saving: boolean;
+    saveLabel: string;
+    discardLabel: string;
+}
+export declare function StagedFormActions({ onSave, onDiscard, canSave, canDiscard, saving, saveLabel, discardLabel, }: StagedFormActionsProps): import("react").JSX.Element;

package/dist/types/components/rbac/useStagedImage.d.ts

@@ -0,0 +1,15 @@
+export interface StagedImage {
+    /** What to show: the staged URL (or `null` for a staged removal), else the saved one. */
+    value: string | null;
+    /** The staged value differs from the saved one — the form must send it on Save. */
+    dirty: boolean;
+    /** A pick is mid-upload. */
+    uploading: boolean;
+    /** Stage a URL, or `null` to stage a removal. */
+    stage: (url: string | null) => void;
+    /** Drop the staged value and go back to the saved one. */
+    discard: () => void;
+    /** Pass to `ImageUploadField.onUpload`. */
+    upload: (file: File) => Promise<string>;
+}
+export declare function useStagedImage(saved: string | null | undefined, onUpload: (file: File) => Promise<string>): StagedImage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "15.40.0",
+  "version": "16.0.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",