@scalar/api-reference
Version:
Generate beautiful API references from OpenAPI documents
79 lines • 2.97 kB
TypeScript
import type { HttpMethod as HttpMethodType } from '@scalar/helpers/http/http-methods';
import { type AvailableClients } from '@scalar/snippetz';
import type { OperationObject, SecuritySchemeObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
import type { ClientOptionGroup } from '../../../../v2/blocks/scalar-request-example-block/types';
export type RequestExampleProps = {
/**
* List of all http clients formatted into option groups for the client selector
*/
clientOptions: ClientOptionGroup[];
/**
* Pre-selected client, this will determine which client is initially selected in the dropdown
*
* @defaults to shell/curl or a custom sample if one is available
*/
selectedClient?: AvailableClients[number];
/**
* Which server from the spec to use for the code example
*/
selectedServer?: ServerObject | undefined;
/**
* The selected content type from the requestBody.content, this will determine which examples are available
* as well as the content type of the code example
*
* @defaults to the first content type
*/
selectedContentType?: string;
/**
* In case you wish to pre-select an example from the requestBody.content.examples
*/
selectedExample?: string;
/**
* The security schemes which are applicable to this operation
*/
securitySchemes?: SecuritySchemeObject[];
/**
* HTTP method of the operation
*/
method: HttpMethodType;
/**
* Path of the operation
*/
path: string;
/**
* De-referenced OpenAPI Operation object
*/
operation: OperationObject;
/**
* If true and there's no example, we will display a small card with the method and path only
*/
fallback?: boolean;
/**
* A method to generate the label of the block, should return an html string
*/
generateLabel?: () => string;
/**
* If true, render this as a webhook request example
*/
isWebhook?: boolean;
};
/**
* Request Example
*
* The core component for rendering a request example block,
* this component does not have much of its own state but operates on props and custom events
*
* @event scalar-update-selected-client - Emitted when the selected client changes
* @event scalar-update-selected-example - Emitted when the selected example changes
*/
declare const _default: __VLS_WithSlots<import("vue").DefineComponent<RequestExampleProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<RequestExampleProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
header: () => unknown;
footer: () => unknown;
}>;
export default _default;
type __VLS_WithSlots<T, S> = T & {
new (): {
$slots: S;
};
};
//# sourceMappingURL=RequestExample.vue.d.ts.map