@emeryld/rrroutes-openapi 2.5.5 → 2.5.7

package/dist/web/v2/components/endpoints/EndpointDetailPanel.d.ts

@@ -1,12 +1,8 @@
-import type { PlaygroundInputs } from '../../stores/clientStore.js';
-import type { EndpointType } from '../../types/types.endpoint.js';
 import { type EndpointTabKey } from '../../utils/endpoints.js';
 type EndpointDetailPanelProps = {
     endpointId?: string | null;
-    onOpenStandalone?: (endpoint: EndpointType, inputs: PlaygroundInputs) => void;
-    hidePlaygroundTab?: boolean;
     activeTab?: EndpointTabKey;
     onTabChange?: (tab: EndpointTabKey) => void;
 };
-export default function EndpointDetailPanel({ endpointId, onOpenStandalone, hidePlaygroundTab, activeTab, onTabChange, }: EndpointDetailPanelProps): import("react/jsx-runtime").JSX.Element;
+export default function EndpointDetailPanel({ endpointId, activeTab, onTabChange, }: EndpointDetailPanelProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/web/v2/components/endpoints/EndpointPlayground.d.ts

@@ -1,16 +1,16 @@
+import { ReactNode } from 'react';
 import { PlaygroundInputs } from '../../stores/clientStore.js';
-import { SerializableSchema } from '../../types/types.endpoint.js';
-import type { MethodType } from '../../types/types.base.js';
+import { PlaygroundRouteMeta } from '../../stores/playgroundStore.js';
 type EndpointPlaygroundProps = {
-    method: MethodType;
-    path: string;
-    contract?: {
-        body?: SerializableSchema;
-        query?: SerializableSchema;
-        params?: SerializableSchema;
-    };
-    summary?: string;
+    initialRoute?: PlaygroundRouteMeta;
+    initialLabel?: string;
     onOpenStandalone?: (inputs: PlaygroundInputs) => void;
+    renderLayout: (slots: {
+        topOverlay: ReactNode;
+        bottomOverlay: ReactNode | null;
+        content: ReactNode;
+        settingsButton: ReactNode;
+    }) => ReactNode;
 };
-export default function EndpointPlayground({ method, path, contract, summary, onOpenStandalone, }: EndpointPlaygroundProps): import("react/jsx-runtime").JSX.Element;
+export default function EndpointPlayground({ initialRoute, initialLabel, onOpenStandalone, renderLayout, }: EndpointPlaygroundProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/web/v2/components/endpoints/KeyValueEditor.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+import { PlaygroundKeyValueRow } from '../../stores/playgroundStore.js';
+type KeyValueEditorProps = {
+    title: string;
+    rows: PlaygroundKeyValueRow[];
+    onChange: (rows: PlaygroundKeyValueRow[]) => void;
+    actions?: ReactNode;
+    defaultExpanded?: boolean;
+    disableAccordion?: boolean;
+    summaryToggleButton?: ReactNode;
+    showFieldMeta?: boolean;
+};
+export default function KeyValueEditor({ title, rows, onChange, actions, defaultExpanded, disableAccordion, summaryToggleButton, showFieldMeta, }: KeyValueEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/web/v2/components/endpoints/PlaygroundEditor.d.ts

@@ -0,0 +1,19 @@
+import { PlaygroundKeyValueRow, PlaygroundTab } from '../../stores/playgroundStore.js';
+import { SerializableSchema } from '../../types/types.endpoint.js';
+import { type EndpointOption } from '../../utils/endpoints.js';
+import type { PlaygroundRunnerResult } from './usePlaygroundRunner.js';
+type PlaygroundEditorProps = {
+    tab: PlaygroundTab;
+    onUpdateTab: (updater: (prev: PlaygroundTab) => PlaygroundTab) => void;
+    endpointOptions: EndpointOption[];
+    isOptionsLoading: boolean;
+    onSearchChange: (term: string) => void;
+    onEndpointSelect: (selection: EndpointOption | string | null) => void;
+    runner: PlaygroundRunnerResult | null;
+};
+export default function PlaygroundEditor({ tab, onUpdateTab, endpointOptions, isOptionsLoading, onSearchChange, onEndpointSelect, runner, }: PlaygroundEditorProps): import("react/jsx-runtime").JSX.Element;
+export declare function mergeRows(baseRows: PlaygroundKeyValueRow[], values?: Record<string, unknown>): PlaygroundKeyValueRow[];
+export declare function buildKeyValueRows(schema?: SerializableSchema): PlaygroundKeyValueRow[];
+export declare function rowsToRecord(rows: PlaygroundKeyValueRow[]): Record<string, string>;
+export declare function formatBodyValue(value: unknown, hasSchema: boolean): string;
+export {};

package/dist/web/v2/components/endpoints/PlaygroundRunPanel.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+import { PlaygroundInputs } from '../../stores/clientStore.js';
+import { PlaygroundTab } from '../../stores/playgroundStore.js';
+type PlaygroundRunPanelProps = {
+    tab: PlaygroundTab;
+    isRunning: boolean;
+    onRun: () => void;
+    onOpenStandalone?: (inputs: PlaygroundInputs) => void;
+    runButtonSlot?: ReactNode;
+};
+export default function PlaygroundRunPanel({ tab, isRunning, onRun, onOpenStandalone, runButtonSlot, }: PlaygroundRunPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/web/v2/components/endpoints/PlaygroundTopTabs.d.ts

@@ -0,0 +1,11 @@
+import type { PlaygroundTab } from '../../stores/playgroundStore.js';
+type PlaygroundTopTabsProps = {
+    tabs: PlaygroundTab[];
+    activeTabId: string | null;
+    isLoading: boolean;
+    onSelect: (tabId: string) => void;
+    onAdd: () => void;
+    onClose: (tabId: string) => void;
+};
+export default function PlaygroundTopTabs({ tabs, activeTabId, isLoading, onSelect, onAdd, onClose, }: PlaygroundTopTabsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/web/v2/components/endpoints/usePlaygroundRunner.d.ts

@@ -0,0 +1,8 @@
+import { PlaygroundTab } from '../../stores/playgroundStore.js';
+export type PlaygroundRunnerResult = {
+    isRunning: boolean;
+    bodyError: string | null;
+    setBodyError: (value: string | null) => void;
+    run: () => Promise<void>;
+};
+export declare function usePlaygroundRunner(tab: PlaygroundTab | null, onUpdateTab: (updater: (prev: PlaygroundTab) => PlaygroundTab) => void): PlaygroundRunnerResult;

package/dist/web/v2/components/inputs/JsonInputWithTools.d.ts

@@ -0,0 +1,10 @@
+type JsonInputWithToolsProps = {
+    value: string;
+    onChange: (next: string) => void;
+    placeholder?: string;
+    minRows?: number;
+    error?: boolean;
+    helperText?: string;
+};
+export default function JsonInputWithTools({ value, onChange, placeholder, minRows, error, helperText, }: JsonInputWithToolsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/web/v2/components/playgroundOverlay/PlaygroundOverlayLayout.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+type PlaygroundOverlayLayoutProps = {
+    top?: ReactNode;
+    bottom?: ReactNode;
+    children: ReactNode;
+};
+/**
+ * Layout component that renders optional fixed overlays above and below
+ * the playground content. It measures overlay heights and applies equivalent
+ * padding so scrollable content never hides underneath them.
+ */
+export default function PlaygroundOverlayLayout({ top, bottom, children, }: PlaygroundOverlayLayoutProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/web/v2/components/playgroundOverlay/useMeasuredElement.d.ts

@@ -0,0 +1,10 @@
+type UseMeasuredElementResult<T extends HTMLElement> = {
+    ref: (node: T | null) => void;
+    height: number;
+};
+/**
+ * Observes an element with ResizeObserver and exposes its current height.
+ * Useful for aligning spacer padding with overlay content height.
+ */
+export declare function useMeasuredElement<T extends HTMLElement>(): UseMeasuredElementResult<T>;
+export {};

package/dist/web/v2/{sockets → components/sockets}/SocketEventDetailModal.d.ts

@@ -1,4 +1,4 @@
-import type { SocketEventType } from '../types/types.socket.js';
+import type { SocketEventType } from '../../types/types.socket.js';
 type SocketEventDetailModalProps = {
     open: boolean;
     event: SocketEventType | null;

package/dist/web/v2/{sockets → components/sockets}/SocketEventsTable.d.ts

@@ -1,4 +1,4 @@
-import type { SocketEventType } from '../types/types.socket.js';
+import type { SocketEventType } from '../../types/types.socket.js';
 type SocketEventsTableProps = {
     events: SocketEventType[];
     onSelect?: (event: SocketEventType, ordered: SocketEventType[]) => void;

package/dist/web/v2/pages/EndpointPlaygroundPage.d.ts

@@ -0,0 +1 @@
+export default function EndpointPlaygroundPage(): import("react/jsx-runtime").JSX.Element;

package/dist/web/v2/stores/clientStore.d.ts

@@ -24,6 +24,11 @@ export type PlaygroundInputs = {
         value: string;
         enabled: boolean;
     }[];
+    headers: {
+        key: string;
+        value: string;
+        enabled: boolean;
+    }[];
     body: string;
 };
 type ClientContextValue = {

package/dist/web/v2/stores/playgroundSettingsStore.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+import type { PlaygroundKeyValueRow } from './playgroundStore.js';
+type PlaygroundSettingsContextValue = {
+    defaultHeaders: PlaygroundKeyValueRow[];
+    setDefaultHeaders: (rows: PlaygroundKeyValueRow[]) => void;
+    resetDefaultHeaders: () => void;
+};
+export declare function PlaygroundSettingsProvider({ children, }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function usePlaygroundSettings(): PlaygroundSettingsContextValue;
+export {};

package/dist/web/v2/stores/playgroundStore.d.ts

@@ -1,5 +1,14 @@
 import { ReactNode } from 'react';
 import type { MethodType } from '../types/types.base';
+import type { SerializableSchema, EndpointType } from '../types/types.endpoint';
+export type PlaygroundKeyValueRow = {
+    id: string;
+    key: string;
+    value: string;
+    enabled: boolean;
+    typeHint?: string;
+    description?: string;
+};
 export type PlaygroundRunRecord = {
     id: string;
     method: MethodType;
@@ -17,7 +26,45 @@ export type PlaygroundRunRecord = {
         headers?: Record<string, string>;
     };
 };
-type PlaygroundRunsContextValue = {
+export type PlaygroundRouteContract = {
+    body?: SerializableSchema;
+    query?: SerializableSchema;
+    params?: SerializableSchema;
+};
+export type PlaygroundRouteMeta = {
+    method: MethodType;
+    path: string;
+    summary?: string;
+    contract?: PlaygroundRouteContract;
+    stability?: EndpointType['stability'];
+};
+export type PlaygroundTab = {
+    id: string;
+    name: string;
+    url: string;
+    method: MethodType;
+    params: PlaygroundKeyValueRow[];
+    query: PlaygroundKeyValueRow[];
+    headers: PlaygroundKeyValueRow[];
+    body: string;
+    latestResponse: PlaygroundRunRecord | null;
+    route?: PlaygroundRouteMeta;
+};
+export type PlaygroundTabsState = {
+    tabs: PlaygroundTab[];
+    activeTabId: string | null;
+};
+export type PlaygroundPrefill = {
+    method?: MethodType;
+    path?: string;
+    params?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    headers?: Record<string, unknown>;
+    leafKey?: string;
+    tabName?: string;
+};
+type PlaygroundContextValue = {
     runs: PlaygroundRunRecord[];
     addRun: (run: PlaygroundRunRecord) => void;
     getLastRun: (args: {
@@ -31,17 +78,12 @@ type PlaygroundRunsContextValue = {
         path?: string;
         leafKey?: string;
     }) => PlaygroundPrefill | null;
+    prefillVersion: number;
+    tabsState: PlaygroundTabsState;
+    updateTabsState: (updater: PlaygroundTabsState | ((prev: PlaygroundTabsState) => PlaygroundTabsState)) => void;
 };
-export type PlaygroundPrefill = {
-    method?: MethodType;
-    path?: string;
-    params?: Record<string, unknown>;
-    query?: Record<string, unknown>;
-    body?: unknown;
-    leafKey?: string;
-};
-export declare function PlaygroundRunsProvider({ children, }: {
+export declare function PlaygroundProvider({ children }: {
     children: ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function usePlaygroundRuns(): PlaygroundRunsContextValue;
+export declare function usePlayground(): PlaygroundContextValue;
 export {};

package/dist/web/v2/utils/dates.d.ts

@@ -0,0 +1 @@
+export declare function nowIso(): string;

package/dist/web/v2/utils/endpoints.d.ts

@@ -1,6 +1,6 @@
 import type { EndpointType } from '../types/types.endpoint.js';
 import { type MethodType } from '../types/types.base.js';
-export type EndpointTabKey = 'request' | 'response' | 'meta' | 'metrics' | 'playground';
+export type EndpointTabKey = 'request' | 'response' | 'meta' | 'metrics';
 export type EndpointPanelLayout = 'split' | 'details' | 'playground';
 export declare const ENDPOINT_TAB_QUERY_KEY = "tab";
 export declare const ENDPOINT_LAYOUT_QUERY_KEY = "layout";

package/dist/web/v2/utils/kvRow.d.ts

@@ -0,0 +1,15 @@
+import type { PlaygroundKeyValueRow } from '../stores/playgroundStore.js';
+export declare function makeRowId(): string;
+type CreateRowArgs = {
+    id?: string;
+    key?: string;
+    value?: string;
+    enabled?: boolean;
+    typeHint?: string;
+    description?: string;
+};
+export declare function createKeyValueRow({ id, key, value, enabled, typeHint, description, }?: CreateRowArgs): PlaygroundKeyValueRow;
+export declare function cloneKeyValueRows(rows: PlaygroundKeyValueRow[], { preserveIds }?: {
+    preserveIds?: boolean;
+}): PlaygroundKeyValueRow[];
+export {};

package/dist/web/v2/utils/schemaDefaults.d.ts

@@ -0,0 +1,7 @@
+import type { PlaygroundKeyValueRow } from '../stores/playgroundStore.js';
+import type { SerializableSchema } from '../types/types.endpoint.js';
+export declare function describeSchemaType(schema?: SerializableSchema): string | undefined;
+export declare function scaffoldBodyFromSchema(schema?: SerializableSchema): unknown;
+export declare function scaffoldKeyValue(schema?: SerializableSchema): string;
+export declare function fillRowDefaults(rows: PlaygroundKeyValueRow[], schema?: SerializableSchema): PlaygroundKeyValueRow[];
+export declare function fillJsonDefaults(existing: unknown, schema?: SerializableSchema): unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-openapi",
-  "version": "2.5.5",
+  "version": "2.5.7",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -17,7 +17,7 @@
     "dist"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-client": "^2.5.0",
+    "@emeryld/rrroutes-client": "^2.5.2",
     "@emeryld/rrroutes-contract": "^2.5.0",
     "@emotion/cache": "^11.14.0",
     "@emotion/react": "^11.14.0",