@danxbot/ui 15.40.0 → 16.1.0

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

@@ -2,5 +2,5 @@ export { OpenApiViewer, type OpenApiViewerProps } from "./OpenApiViewer";
 export { OperationCard, type OperationCardProps } from "./OperationCard";
 export { OperationHeader, type OperationHeaderProps, OperationDetail, type OperationDetailProps } from "./OperationCard";
 export { SchemaView, type SchemaViewProps } from "./SchemaView";
-export { groupOperations, isHttpMethod, mergedParameters, operationAnchorId, resolveSchema, schemaToExample, type SchemaResolution, } from "./resolve";
+export { groupOperations, isHttpMethod, mergedParameters, operationAnchorId, resolveSchema, resolveWebhooks, schemaToExample, type SchemaResolution, } from "./resolve";
 export { HTTP_METHODS, type HttpMethod, type OpenApiDocument, type OpenApiMediaType, type OpenApiOperation, type OpenApiParameter, type OpenApiParameterLocation, type OpenApiPathItem, type OpenApiRequestBody, type OpenApiResponse, type OpenApiSchema, type OpenApiSecurityRequirement, type OpenApiSecurityScheme, type OpenApiTag, type OperationGroup, type ResolvedOperation, } from "./types";

package/dist/types/components/openapi/resolve.d.ts

@@ -1,4 +1,4 @@
-import type { HttpMethod, OpenApiDocument, OpenApiParameter, OpenApiSchema, OperationGroup } from "./types";
+import type { HttpMethod, OpenApiDocument, OpenApiParameter, OpenApiSchema, OperationGroup, ResolvedOperation } from "./types";
 export declare function isHttpMethod(key: string): key is HttpMethod;
 /**
  * Resolves a single `{ $ref: "#/components/schemas/Foo" }` against the
@@ -42,10 +42,20 @@ export declare function mergedParameters(pathParameters: readonly OpenApiParamet
  * group by tag".
  */
 export declare function groupOperations(doc: OpenApiDocument): OperationGroup[];
+/**
+ * Every operation of the document's top-level `webhooks` (DX-4178), in
+ * document order, each carrying its webhook NAME as `path` and `webhook:
+ * true`. Webhooks are not grouped by tag: they are a short, named list of the
+ * calls a consumer must receive, shown as their own section.
+ */
+export declare function resolveWebhooks(doc: OpenApiDocument): ResolvedOperation[];
 /** A stable per-operation id for a deep link / anchor — same input, same id,
  * across renders and across documents (used as both the section `id` and the
  * `#fragment` a "copy link" control writes). */
-export declare function operationAnchorId(method: HttpMethod, path: string): string;
+export declare function operationAnchorId(method: HttpMethod, path: string, webhook?: boolean): string;
+/** `operationAnchorId` for a resolved operation — the one place a caller
+ * cannot forget the webhook namespace. */
+export declare function resolvedAnchorId(resolved: ResolvedOperation): string;
 /**
  * Synthesises a representative JSON value from a schema when the document
  * supplies no explicit `example`/`examples` — the same fallback every

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

@@ -85,6 +85,10 @@ export interface OpenApiDocument {
     }[];
     readonly tags?: readonly OpenApiTag[];
     readonly paths: Record<string, OpenApiPathItem>;
+    /** OpenAPI 3.1 top-level `webhooks` (DX-4178): calls the API's server
+     * MAKES to a consumer, keyed by a name rather than a path. Each value is a
+     * Path Item whose operations are the requests the consumer must receive. */
+    readonly webhooks?: Record<string, OpenApiPathItem>;
     readonly components?: {
         readonly schemas?: Record<string, OpenApiSchema>;
         readonly securitySchemes?: Record<string, OpenApiSecurityScheme>;
@@ -104,6 +108,12 @@ export interface ResolvedOperation {
      * merges these with the operation's own, operation-level winning on a
      * `name`+`in` collision — see `resolve.ts#mergedParameters`). */
     readonly pathParameters: readonly OpenApiParameter[];
+    /** DX-4178: true when this is an OpenAPI `webhooks` entry — `path` then
+     * holds the webhook's NAME, not a URL path the API serves. A webhook has no
+     * document-level default security (the document's `security` governs the
+     * calls INTO the API, not the one a consumer's receiver is sent) and its
+     * anchor id is namespaced apart from every path's. */
+    readonly webhook?: true;
 }
 /** One tag/path group of operations, in document order. */
 export interface OperationGroup {

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/dist/types/index.d.ts

@@ -156,7 +156,7 @@ export { NodeCanvas, LAYOUT_DEFAULTS, edgePath, layoutGraph, neighbourhood, type
 export { GraphExplorer, frameBoxFor, layoutExplorerTree, neighbourhoodTree, CAMERA_DEFAULTS, centerOn, clampScale, fitBox, fitBoxWithFloor, toContentPoint, toScreenPoint, unionBox, zoomAtPoint, type GraphExplorerProps, type Box, type CameraState, type FitOptions, type FitWithFloorOptions, type FitWithFloorResult, type FrameOverflow, type Point, type ScaleBounds, type Size, type CrossLink, type ExplorerLayout, type ExplorerNodeRenderContext, type ExplorerNodeRenderer, type ExplorerTree, type GraphExplorerVariant, type TreeNode as ExplorerTreeNode, } from "./components/graph-explorer";
 export { FocusWeb, CENTER_POSITION, PARENT_POSITION, WIDE_RING_THRESHOLD, layoutRing, type FocusNodeRenderContext, type FocusNodeRenderer, type FocusNodeRole, type FocusWebNode, type FocusWebNodeLook, type FocusWebProps, type PlacedRingNode, } from "./components/focus-web";
 export { SequenceDiagram, type SequenceDiagramProps, type SequenceStep, } from "./components/SequenceDiagram";
-export { OpenApiViewer, type OpenApiViewerProps, OperationCard, type OperationCardProps, OperationHeader, type OperationHeaderProps, OperationDetail, type OperationDetailProps, SchemaView, type SchemaViewProps, groupOperations, isHttpMethod, mergedParameters, operationAnchorId, resolveSchema, schemaToExample, type SchemaResolution, HTTP_METHODS, type HttpMethod, type OpenApiDocument, type OpenApiMediaType, type OpenApiOperation, type OpenApiParameter, type OpenApiParameterLocation, type OpenApiPathItem, type OpenApiRequestBody, type OpenApiResponse, type OpenApiSchema, type OpenApiSecurityRequirement, type OpenApiSecurityScheme, type OpenApiTag, type OperationGroup, type ResolvedOperation, } from "./components/openapi";
+export { OpenApiViewer, type OpenApiViewerProps, OperationCard, type OperationCardProps, OperationHeader, type OperationHeaderProps, OperationDetail, type OperationDetailProps, SchemaView, type SchemaViewProps, groupOperations, isHttpMethod, mergedParameters, operationAnchorId, resolveSchema, resolveWebhooks, schemaToExample, type SchemaResolution, HTTP_METHODS, type HttpMethod, type OpenApiDocument, type OpenApiMediaType, type OpenApiOperation, type OpenApiParameter, type OpenApiParameterLocation, type OpenApiPathItem, type OpenApiRequestBody, type OpenApiResponse, type OpenApiSchema, type OpenApiSecurityRequirement, type OpenApiSecurityScheme, type OpenApiTag, type OperationGroup, type ResolvedOperation, } from "./components/openapi";
 export { defineRecordType, resetRecordTypes, useRecord, useRecords, useStaleness, write, writeAll, peekRecord, readState, readStaleness, subscribeToKey, subscribeToStaleness, retainKeys, sweepRecords, setRecordStoreTenant, getRecordStoreTenant, flushRecordNotifications, resetRecordStore, recordStoreStats, UNKNOWN_STATE, normalizeTypeName, normalizeTimestamp, recordKey, isRecordRef, type RecordRef, type ReadOptions, type RecordPayload, type RecordState, type RecordTypeOptions, type RecordTypeToken, type StalenessEntry, type WriteAllResult, type WriteOptions, type WriteResult, type WriteSource, type WriteVerdict, } from "./lib/records";
 export { RealtimeProvider, useRealtime, useRealtimeEpoch, useRealtimeHealth, useRealtimeRegistry, SubscriptionRegistry, normalizeScope, scopeKey, subscriptionKey, readRealtimeEpoch, subscribeToRealtimeEpoch, subscribeToRealtimeEvents, resetRealtimeSignals, type RealtimeChannel, type RealtimeConnectionState, type RealtimeDiagnostic, type RealtimeEvent, type RealtimeHealth, type RealtimeProviderProps, type RealtimeScope, type RealtimeScopeInput, type RealtimeStatus, type RealtimeTransport, type RegistryOptions, type SubscriptionHealth, type SubscriptionLease, type SubscriptionRequest, } from "./lib/realtime";
 export { useRecordRead, useRecordListRead, useRecordStoreSweep, applyMutationResult, optimisticWrite, beginOptimisticWrite, resetOptimisticWrites, type OptimisticHandle, type OptimisticWriteOptions, type OptimisticWriteSpec, type SlotDescriptor, acquireSlot, appendCreated, emptySlotSnapshot, readSlot, resetSlots, slotKeys, subscribeToSlot, writeSlot, RefetchRunner, registerActiveRead, resetActiveReads, type ActiveRead, type ListFetch, type ListFetchResult, type ListReadOptions, type ListReadResult, type ReadError, type RecordFetch, type RecordReadOptions, type RecordReadResult, type RunnerOptions, type SlotSnapshot, } from "./lib/reads";

package/package.json

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