@danxbot/ui 16.0.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/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": "16.0.0",
+  "version": "16.1.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",