@danxbot/ui 15.9.0 → 15.10.0

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

@@ -0,0 +1,117 @@
+/** A JSON Schema node (or an OpenAPI "Schema Object", which 3.1 defines as
+ * one). Loose on purpose — see the file header. */
+export type OpenApiSchema = Record<string, unknown>;
+export type OpenApiParameterLocation = "path" | "query" | "header" | "cookie";
+export interface OpenApiParameter {
+    readonly name: string;
+    readonly in: OpenApiParameterLocation;
+    readonly required?: boolean;
+    readonly deprecated?: boolean;
+    readonly description?: string;
+    readonly schema?: OpenApiSchema;
+    readonly example?: unknown;
+}
+export interface OpenApiMediaType {
+    readonly schema?: OpenApiSchema;
+    readonly example?: unknown;
+    readonly examples?: Record<string, {
+        readonly summary?: string;
+        readonly value?: unknown;
+    }>;
+}
+export interface OpenApiRequestBody {
+    readonly required?: boolean;
+    readonly description?: string;
+    readonly content: Record<string, OpenApiMediaType>;
+}
+export interface OpenApiResponse {
+    readonly description: string;
+    readonly content?: Record<string, OpenApiMediaType>;
+}
+/** `{securitySchemeName: scopes[]}` — one alternative a caller may satisfy.
+ * An operation's `security` is an array of these; several entries in the
+ * SAME object mean "all of these together", several objects in the array
+ * mean "any one of these". An empty array (`[]` on the operation) means
+ * "no security" and overrides the document-level default. */
+export type OpenApiSecurityRequirement = Record<string, readonly string[]>;
+export interface OpenApiOperation {
+    readonly operationId?: string;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly deprecated?: boolean;
+    readonly parameters?: readonly OpenApiParameter[];
+    readonly requestBody?: OpenApiRequestBody;
+    readonly responses: Record<string, OpenApiResponse>;
+    readonly security?: readonly OpenApiSecurityRequirement[];
+    /** Vendor extensions (`x-...`) ride along unread by name, so a caller can
+     * still reach `operation["x-served-by"]` off the resolved operation this
+     * package hands back from `groupOperations`. */
+    readonly [extension: `x-${string}`]: unknown;
+}
+export declare const HTTP_METHODS: readonly ["get", "put", "post", "delete", "options", "head", "patch", "trace"];
+export type HttpMethod = (typeof HTTP_METHODS)[number];
+export type OpenApiPathItem = Partial<Record<HttpMethod, OpenApiOperation>> & {
+    readonly summary?: string;
+    readonly description?: string;
+    readonly parameters?: readonly OpenApiParameter[];
+};
+export interface OpenApiSecurityScheme {
+    readonly type: "http" | "apiKey" | "oauth2" | "openIdConnect" | "mutualTLS";
+    readonly scheme?: string;
+    readonly bearerFormat?: string;
+    readonly in?: "query" | "header" | "cookie";
+    readonly name?: string;
+    readonly description?: string;
+    readonly openIdConnectUrl?: string;
+    readonly flows?: Record<string, {
+        readonly scopes?: Record<string, string>;
+    }>;
+}
+export interface OpenApiTag {
+    readonly name: string;
+    readonly description?: string;
+}
+export interface OpenApiDocument {
+    readonly openapi: string;
+    readonly info: {
+        readonly title: string;
+        readonly version: string;
+        readonly description?: string;
+    };
+    readonly servers?: readonly {
+        readonly url: string;
+        readonly description?: string;
+    }[];
+    readonly tags?: readonly OpenApiTag[];
+    readonly paths: Record<string, OpenApiPathItem>;
+    readonly components?: {
+        readonly schemas?: Record<string, OpenApiSchema>;
+        readonly securitySchemes?: Record<string, OpenApiSecurityScheme>;
+    };
+    readonly security?: readonly OpenApiSecurityRequirement[];
+}
+/** One operation, already paired with its method + path — `groupOperations`'s
+ * output unit, and `OperationCard`'s own prop. Carrying `path`/`method`
+ * alongside the raw `OpenApiOperation` means every renderer below the group
+ * level can stay a pure function of "one operation", never reaching back up
+ * for context its parent already had. */
+export interface ResolvedOperation {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly operation: OpenApiOperation;
+    /** Parameters declared on the shared `PathItem` (never overridden — 3.1
+     * merges these with the operation's own, operation-level winning on a
+     * `name`+`in` collision — see `resolve.ts#mergedParameters`). */
+    readonly pathParameters: readonly OpenApiParameter[];
+}
+/** One tag/path group of operations, in document order. */
+export interface OperationGroup {
+    /** The tag name, or — when the document declares no tags at all on the
+     * operations it carries — the first non-empty path segment (`resolve.ts`).
+     * Never both in the same document: a document that tags ANY operation is
+     * grouped by tag, with untagged operations falling into `"Other"`. */
+    readonly name: string;
+    readonly description?: string;
+    readonly operations: readonly ResolvedOperation[];
+}

package/dist/types/index.d.ts

@@ -138,6 +138,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, 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 { 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.9.0",
+  "version": "15.10.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",