@danxbot/ui 14.4.0 → 15.1.0

package/dist/types/components/ImageUploadField.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode, type Ref } from "react";
+export type ImageUploadFieldShape = "circle" | "square";
+export type ImageUploadFieldSize = "sm" | "md" | "lg" | "xl";
+export interface ImageUploadFieldProps {
+    /** The current image URL. `undefined`/`null` means nothing is set yet. */
+    value?: string | null;
+    /**
+     * Fired once a pick resolves — either a successful upload (the URL
+     * `onUpload` returned) or a remove (`null`). This is the only way `value`
+     * ever changes; the component holds no persistent state of its own.
+     */
+    onChange?: (url: string | null) => void;
+    /** Uploads the picked file and resolves with its stored URL. Rejecting
+     *  surfaces the rejection's `message` (or the rejection itself, stringified)
+     *  as this field's error. */
+    onUpload: (file: File) => Promise<string>;
+    shape?: ImageUploadFieldShape;
+    size?: ImageUploadFieldSize;
+    /** Hides the remove control even when a value is set — for a slot that must
+     *  always hold *something* (e.g. a required team logo with a seeded
+     *  default). Default `true`. */
+    removable?: boolean;
+    accept?: string;
+    /** Bytes. Forwarded to `FileUpload`'s own limit + rejection message. */
+    maxSize?: number;
+    disabled?: boolean;
+    /** Rendered above the preview. */
+    label?: ReactNode;
+    /** Rendered under the preview, when there is no error to show instead. */
+    description?: ReactNode;
+    /** Accessible name for the replace/pick control — required since the
+     *  control the preview state renders is icon-only. */
+    uploadLabel?: string;
+    removeLabel?: string;
+    className?: string;
+    ref?: Ref<HTMLDivElement>;
+}
+export declare function ImageUploadField({ value, onChange, onUpload, shape, size, removable, accept, maxSize, disabled, label, description, uploadLabel, removeLabel, className, ref, }: ImageUploadFieldProps): import("react").JSX.Element;

package/dist/types/components/PasswordInput.d.ts

@@ -0,0 +1,7 @@
+import { type InputProps } from "./Input";
+export interface PasswordInputProps extends Omit<InputProps, "type" | "trailing"> {
+    /** Hides the show/hide toggle entirely — for a field where the operator
+     *  should never be able to reveal what they typed (rare; default `true`). */
+    revealable?: boolean;
+}
+export declare function PasswordInput({ revealable, autoComplete, ...props }: PasswordInputProps): import("react").JSX.Element;

package/dist/types/components/PasswordRequirements.d.ts

@@ -0,0 +1,11 @@
+import type { Ref } from "react";
+export interface PasswordRequirementRule {
+    label: string;
+    met: boolean;
+}
+export interface PasswordRequirementsProps {
+    rules: PasswordRequirementRule[];
+    className?: string;
+    ref?: Ref<HTMLUListElement>;
+}
+export declare function PasswordRequirements({ rules, className, ref }: PasswordRequirementsProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,26 @@
+import type { ReactNode } from "react";
+export interface ApiToken {
+    id: number;
+    name: string;
+    /** ISO instant. */
+    createdAt: string;
+    /** ISO instant, or `null`/omitted if it has never been used. */
+    lastUsedAt?: string | null;
+    /** ISO instant, or `null`/omitted for a token with no expiry. */
+    expiresAt?: string | null;
+}
+export interface ApiTokensPanelProps {
+    tokens: ApiToken[];
+    onCreate: (input: {
+        name: string;
+        expiresInDays?: number | null;
+    }) => Promise<{
+        token: string;
+    }>;
+    onRevoke: (id: number) => Promise<void>;
+    /** The id of a token currently mid-revoke. Disables just that row. */
+    busyId?: number | null;
+    emptyState?: ReactNode;
+    className?: string;
+}
+export declare function ApiTokensPanel({ tokens, onCreate, onRevoke, busyId, emptyState, className }: ApiTokensPanelProps): import("react").JSX.Element;

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

@@ -0,0 +1,11 @@
+import { type PasswordRequirementRule } from "../PasswordRequirements";
+export interface ChangePasswordFormProps {
+    /** Pure — recomputed against the current draft of the new password on every
+     *  render. See the module header for why this is a function rather than a
+     *  precomputed `rules[]`. */
+    passwordRules: (nextPassword: string) => PasswordRequirementRule[];
+    onSubmit: (current: string, next: string) => Promise<void>;
+    submitLabel?: string;
+    className?: string;
+}
+export declare function ChangePasswordForm({ passwordRules, onSubmit, submitLabel, className, }: ChangePasswordFormProps): import("react").JSX.Element;

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

@@ -0,0 +1,25 @@
+export interface ProfileFormAccount {
+    name: string;
+    /** Omit entirely for a consumer whose account model has no separate
+     *  username concept — the field simply does not render (see `types.ts`'s
+     *  own `User.username` doc for the same optional-field convention). */
+    username?: string;
+    email: string;
+    avatarUrl?: string | null;
+}
+export interface ProfileFormSaveInput {
+    name: string;
+    username?: string;
+    email: string;
+}
+export interface ProfileFormProps {
+    account: ProfileFormAccount;
+    onSave: (input: ProfileFormSaveInput) => Promise<void>;
+    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;
+    className?: string;
+}
+export declare function ProfileForm({ account, onSave, onUploadAvatar, onAvatarChange, saveLabel, className, }: ProfileFormProps): import("react").JSX.Element;

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

@@ -1 +1,11 @@
-export declare function ProfilePage(): import("react").JSX.Element;
+import { type ProfileFormAccount, type ProfileFormSaveInput } from "./ProfileForm";
+export interface ProfilePageProps {
+    /** The identity fields to edit. Omit to keep the original read-only (but
+     *  still locally-editable) `actualUser` display. */
+    account?: ProfileFormAccount;
+    onSave?: (input: ProfileFormSaveInput) => Promise<void>;
+    onUploadAvatar?: (file: File) => Promise<string>;
+    onAvatarChange?: (avatarUrl: string | null) => void;
+    className?: string;
+}
+export declare function ProfilePage({ account, onSave, onUploadAvatar, onAvatarChange, className }: ProfilePageProps): import("react").JSX.Element;

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

@@ -0,0 +1,28 @@
+import type { Role } from "./types";
+export interface RoleEditorDialogSubmitInput {
+    label: string;
+    description: string;
+    /** Only ever sent from CREATE mode — see this file's own header. `undefined` when no clone-from role was picked. */
+    cloneFromRoleId?: string;
+}
+export interface RoleEditorDialogProps {
+    mode: "create" | "edit";
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /**
+     * CREATE mode only — the roles offered as "clone permissions from" (a
+     * consumer typically hands every role the matrix already shows, owner
+     * included: cloning owner's COMPUTED set is a legitimate way to seed a
+     * near-owner role). Omitted or empty simply hides the field — a consumer
+     * with nothing to clone from does not owe this dialog an empty array.
+     */
+    cloneFromRoles?: Role[];
+    /** EDIT mode — the role's current values, so the fields open pre-filled rather than blank. */
+    initialLabel?: string;
+    initialDescription?: string;
+    /** Disables the form and shows a busy submit button while a save is in flight. */
+    loading?: boolean;
+    onSubmit: (input: RoleEditorDialogSubmitInput) => void;
+    className?: string;
+}
+export declare function RoleEditorDialog({ mode, open, onOpenChange, cloneFromRoles, initialLabel, initialDescription, loading, onSubmit, className, }: RoleEditorDialogProps): import("react").JSX.Element;

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

@@ -2,5 +2,20 @@ import type { Permission, Role } from "./types";
 export interface RolePermissionMatrixProps {
     roles: Role[];
     permissions: Permission[];
+    /**
+     * DX-3414 — turns each cell into a toggle. Defaults to `false` (the
+     * original read-only matrix, unchanged pixel-for-pixel and test-for-test).
+     * A `role.locked` column stays READ-ONLY even when `editable` — see
+     * `Role.locked`'s own doc comment (`types.ts`): a consumer's rules forbid
+     * touching that role at all, and the matrix has no business knowing why.
+     */
+    editable?: boolean;
+    /**
+     * Fired when an editable, unlocked cell is toggled. `granted` is the NEW
+     * value the caller should persist — the matrix holds no state of its own
+     * (PLN-13 R-3: presentational, no fetch); a consumer wires this to its own
+     * mutation and re-renders with the updated `roles` once it lands.
+     */
+    onChange?: (roleId: string, permissionKey: string, granted: boolean) => void;
 }
-export declare function RolePermissionMatrix({ roles, permissions }: RolePermissionMatrixProps): import("react").JSX.Element;
+export declare function RolePermissionMatrix({ roles, permissions, editable, onChange, }: RolePermissionMatrixProps): import("react").JSX.Element;

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

@@ -1 +1,22 @@
-export declare function RolesPermissionsPage(): import("react").JSX.Element;
+import { type RoleEditorDialogSubmitInput } from "./RoleEditorDialog";
+import type { Permission, Role } from "./types";
+export interface RolesPermissionsPageProps {
+    roles: Role[];
+    permissions: Permission[];
+    /** Gates the "New role" button, the manage-roles list, and the matrix's own `editable`. Defaults to `false` — read-only, pixel-identical to the page before this card. */
+    editable?: boolean;
+    /** Fired when an editable, unlocked matrix cell is toggled. Required to make the matrix respond; omit alongside `editable={false}`. */
+    onChangePermission?: (roleId: string, permissionKey: string, granted: boolean) => void;
+    onCreateRole?: (input: RoleEditorDialogSubmitInput) => void;
+    onRenameRole?: (roleId: string, input: {
+        label: string;
+        description: string;
+    }) => void;
+    onDeleteRole?: (roleId: string) => void;
+    /** Restores a SYSTEM role's seeded permission set — offered only for a role with `role.system` true (never `locked`; see `Role.locked`'s own doc comment for why owner never reaches this list at all). */
+    onResetRole?: (roleId: string) => void;
+    /** The id of a role currently mid-mutation. Disables just that row's controls, not the whole page. */
+    busyRoleId?: string | null;
+    className?: string;
+}
+export declare function RolesPermissionsPage({ roles, permissions, editable, onChangePermission, onCreateRole, onRenameRole, onDeleteRole, onResetRole, busyRoleId, className, }: RolesPermissionsPageProps): import("react").JSX.Element;

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

@@ -0,0 +1,26 @@
+import type { ReactNode } from "react";
+export interface Session {
+    id: number;
+    /** A human label for the session — "Chrome on macOS", "iPhone app", whatever
+     *  the consumer's own backend derives from the user agent. */
+    name: string;
+    /** ISO instant. */
+    createdAt: string;
+    /** ISO instant. */
+    lastUsedAt: string;
+    /** ISO instant, or `null`/omitted for a session with no expiry. */
+    expiresAt?: string | null;
+    userAgent?: string;
+    ip?: string;
+    /** True for exactly one row — the session this UI is currently running in. */
+    current: boolean;
+}
+export interface SessionsListProps {
+    sessions: Session[];
+    onRevoke: (id: number) => Promise<void>;
+    /** The id of a session currently mid-revoke. Disables just that row. */
+    busyId?: number | null;
+    emptyState?: ReactNode;
+    className?: string;
+}
+export declare function SessionsList({ sessions, onRevoke, busyId, emptyState, className }: SessionsListProps): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined>;

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

@@ -5,6 +5,11 @@ export * from "./AccountMenu";
 export * from "./TeamSwitcher";
 export * from "./DevToolsPopover";
 export * from "./RolePermissionMatrix";
+export * from "./RoleEditorDialog";
+export * from "./ProfileForm";
 export * from "./ProfilePage";
 export * from "./RolesPermissionsPage";
 export * from "./MembersPanel";
+export * from "./ChangePasswordForm";
+export * from "./SessionsList";
+export * from "./ApiTokensPanel";

package/dist/types/index.d.ts

@@ -28,6 +28,8 @@ export { InlineMarkdownEdit, type InlineMarkdownEditProps } from "./components/I
 export type { EditActivation } from "./components/edit/activation";
 export type { EditCommit, EditOutcome, EditRefusal } from "./components/edit/outcome";
 export { SecretField, type SecretFieldProps, type SecretValue } from "./components/SecretField";
+export { PasswordInput, type PasswordInputProps } from "./components/PasswordInput";
+export { PasswordRequirements, type PasswordRequirementsProps, type PasswordRequirementRule, } from "./components/PasswordRequirements";
 export { SettingRow, SettingGroup, type SettingRowProps, type SettingGroupProps, type SettingRowControlRenderProps, } from "./components/SettingRow";
 export { DescriptionList, DescriptionListItem, type DescriptionListProps, type DescriptionListItemProps, type DescriptionListEntry, } from "./components/DescriptionList";
 export { ConnectionCard, type ConnectionCardProps, type ConnectionHealth, } from "./components/ConnectionCard";
@@ -40,6 +42,7 @@ export { Menu, MenuItem, MenuGroup, MenuRadioGroup, MenuRadioItem, MenuSeparator
 export { ThemeMenu, type ThemeMenuProps } from "./components/ThemeMenu";
 export { AppShell, type AppShellProps, type NavItem, type NavSection, } from "./components/AppShell";
 export { FileUpload, type FileUploadProps, type UploadFile } from "./components/FileUpload";
+export { ImageUploadField, type ImageUploadFieldProps, type ImageUploadFieldShape, type ImageUploadFieldSize, } from "./components/ImageUploadField";
 export { DatePicker, type DatePickerProps, type DateRange } from "./components/DatePicker";
 export { DateCalendar, type DateCalendarProps } from "./components/DateCalendar";
 export { DateField, DateTimeField, type DateFieldProps, type DateTimeFieldProps, } from "./components/DateField";
@@ -124,7 +127,7 @@ export { cellLabel, eventLabel, formatDateRange, longDate, monthTitle, timeOfDay
 export { initialFocusDay, isInMonth, nextDayForKey, useGridNavigation, type GridNavigation, type GridNavigationOptions, } from "./components/calendar/use-grid-navigation";
 export { AmbiguousTimeError, addDays, addDuration, addMonths, atMidnight, atTime, comparePlainDate, dayFraction, dayLengthMs, dayOfWeek, daysBetween, daysInMonth, endOfMonth, hoursInDay, instantAtFraction, instantToPlainDate, instantToPlainDateTime, isSameDate, isoDateString, isoDateTimeString, monthGridDays, nextDay, offsetAt, parsePlainDate, plainDateTimeToInstant, relativeAge, startOfDay, startOfMonth, startOfWeek, weekDays, type CalendarDuration, type Disambiguation, type Instant, type PlainDate, type PlainDateTime, type TimeZone, } from "./lib/time";
 export { allDayBandSegment, dayKey, daySlots, isAllDay, packBand, packLanes, snapFractionToInstant, timeSegments, timedBandSegment, type AllDayEvent, type BandInput, type BandOptions, type BandPlacement, type BandResult, type BandSegment, type CalendarEvent, type CalendarEventId, type CalendarView, type DaySlot, type DragKind, type EventDraft, type EventPalette, type LaneInput, type LaneOptions, type LanePlacement, type PaletteEntry, type TimeSegment, type TimedEvent, type VisibleRange, } from "./lib/calendar";
-export { RBACProvider, useRBAC, Can, useHasPermission, AccountMenu, TeamSwitcher, DevToolsPopover, RolePermissionMatrix, ProfilePage, RolesPermissionsPage, MembersPanel, type RBACProviderProps, type RBACHookResult, type CanProps, type AccountMenuProps, type TeamSwitcherProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type MembersPanelProps, type MembersPanelMember, type Permission, type Role, type User, type Team, type TeamMembership, } from "./components/rbac";
+export { RBACProvider, useRBAC, Can, useHasPermission, AccountMenu, TeamSwitcher, DevToolsPopover, RolePermissionMatrix, RoleEditorDialog, ProfileForm, ProfilePage, RolesPermissionsPage, MembersPanel, ChangePasswordForm, SessionsList, ApiTokensPanel, type RBACProviderProps, type RBACHookResult, type CanProps, type AccountMenuProps, type TeamSwitcherProps, type DevToolsPopoverProps, type RolePermissionMatrixProps, type RoleEditorDialogProps, type RoleEditorDialogSubmitInput, type ProfileFormProps, type ProfileFormAccount, type ProfileFormSaveInput, type ProfilePageProps, type RolesPermissionsPageProps, type MembersPanelProps, type MembersPanelMember, type ChangePasswordFormProps, type SessionsListProps, type Session, type ApiTokensPanelProps, type ApiToken, type Permission, type Role, type User, type Team, type TeamMembership, } from "./components/rbac";
 export { UseCaseCard, RoadmapItemCard, RoadmapSwimlaneBoard, UseCaseLedgerPage, RoadmapPage, PhaseManager, TrackManager, deriveRoadmapItemStatus, isFullyBuilt, isUnbuilt, trackIds, trackProgress, toneForIndex, CATEGORY_TONES, type Domain, type Phase, type Track, type RoadmapItem, type RoadmapItemStatus, type UseCase, type UseCaseStatus, type UseCaseDecision, type UseCaseCardProps, type RoadmapItemCardProps, type RoadmapSwimlaneBoardProps, type UseCaseLedgerPageProps, type RoadmapPageProps, type PhaseManagerProps, type TrackManagerProps, } from "./components/roadmap";
 export { ProvenanceDisclosure, ProvenanceDetail, ProvenanceBadge, ConfidenceReadout, ConfidenceMeter, ConfidenceBar, provenanceStateLabel, confidenceBand, confidenceScore, scoredConfidence, ratedConfidence, type ProvenanceRecord, type ProvenanceState, type ProvenanceSource, type ProvenanceCheck, type ProvenanceCall, type ProvenanceSignoff, type ConfidenceBand, type ConfidenceScore, type ProvenanceConfidence, type ConfidenceReadoutProps, type ConfidenceBarProps, type ConfidenceBarSize, type ProvenanceDisclosureProps, type ProvenanceDetailProps, type ProvenanceDetailTitleAs, type ProvenanceTriggerBadge, type ProvenanceBadgeProps, type ProvenanceBadgeAppearance, type ConfidenceMeterProps, } from "./components/provenance";
 export { confidenceLevel, CONFIDENCE_LEVEL_LABELS, type ConfidenceLevel } from "./lib/confidence";

package/package.json

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