@ahoo-wang/wow-generator 9.2.0-rc.0

package/dist/input/resources.d.cts

@@ -0,0 +1,36 @@
+/** How long a remote document may take before the request is abandoned. */
+export declare const DEFAULT_HTTP_TIMEOUT_MS = 30000;
+/**
+ * Options for loading a resource over HTTP. Files ignore them.
+ */
+export interface LoadResourceOptions {
+    /** Request headers, for example `Authorization`. */
+    readonly headers?: Record<string, string>;
+    /** Milliseconds before the request is abandoned. */
+    readonly timeoutMs?: number;
+    /** Abandons the request when it aborts, as an interrupted run does. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Tells whether a location names an http(s) resource rather than a file.
+ *
+ * @param path - A file path or URL
+ * @returns True for an `http://` or `https://` URL
+ */
+export declare function isHttpLocation(path: string): boolean;
+export declare function loadResource(path: string, options?: LoadResourceOptions): Promise<string>;
+/**
+ * Fetches a resource and returns its body.
+ *
+ * A response outside 2xx is a failure: a 401 or 404 page is not the document
+ * the caller asked for, and parsing it would only fail later with a message
+ * about the page instead of the request.
+ *
+ * @param url - The http(s) URL
+ * @param options - Headers and timeout
+ * @returns The response body as text
+ * @throws Error naming the status, the timeout or the network failure; the
+ * caller names the URL
+ */
+export declare function loadHttpResource(url: string, options?: LoadResourceOptions): Promise<string>;
+export declare function loadFile(path: string): Promise<string>;

package/dist/input/resources.d.ts

@@ -0,0 +1,36 @@
+/** How long a remote document may take before the request is abandoned. */
+export declare const DEFAULT_HTTP_TIMEOUT_MS = 30000;
+/**
+ * Options for loading a resource over HTTP. Files ignore them.
+ */
+export interface LoadResourceOptions {
+    /** Request headers, for example `Authorization`. */
+    readonly headers?: Record<string, string>;
+    /** Milliseconds before the request is abandoned. */
+    readonly timeoutMs?: number;
+    /** Abandons the request when it aborts, as an interrupted run does. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Tells whether a location names an http(s) resource rather than a file.
+ *
+ * @param path - A file path or URL
+ * @returns True for an `http://` or `https://` URL
+ */
+export declare function isHttpLocation(path: string): boolean;
+export declare function loadResource(path: string, options?: LoadResourceOptions): Promise<string>;
+/**
+ * Fetches a resource and returns its body.
+ *
+ * A response outside 2xx is a failure: a 401 or 404 page is not the document
+ * the caller asked for, and parsing it would only fail later with a message
+ * about the page instead of the request.
+ *
+ * @param url - The http(s) URL
+ * @param options - Headers and timeout
+ * @returns The response body as text
+ * @throws Error naming the status, the timeout or the network failure; the
+ * caller names the URL
+ */
+export declare function loadHttpResource(url: string, options?: LoadResourceOptions): Promise<string>;
+export declare function loadFile(path: string): Promise<string>;

package/dist/naming/modelInfo.d.cts

@@ -0,0 +1,10 @@
+import { Named } from '@ahoo-wang/wow-client';
+/**
+ * Where a generated declaration lives: its name, and the directory under the
+ * output directory whose `types.ts` declares it, or the package it is
+ * imported from (a path starting with `@`).
+ */
+export interface ModelInfo extends Named {
+    name: string;
+    path: string;
+}

package/dist/naming/modelInfo.d.ts

@@ -0,0 +1,10 @@
+import { Named } from '@ahoo-wang/wow-client';
+/**
+ * Where a generated declaration lives: its name, and the directory under the
+ * output directory whose `types.ts` declares it, or the package it is
+ * imported from (a path starting with `@`).
+ */
+export interface ModelInfo extends Named {
+    name: string;
+    path: string;
+}

package/dist/naming/naming.d.cts

@@ -0,0 +1,102 @@
+/**
+ * Tells whether a name is a valid identifier as written.
+ *
+ * @param name - The candidate
+ * @returns True when it can name a variable, a parameter or a type
+ */
+export declare function isIdentifier(name: string): boolean;
+/**
+ * Turns a name from the document into a value identifier: a parameter, a
+ * method or a variable.
+ *
+ * A valid identifier is kept as written. Anything else is camel-cased on its
+ * separators (`item-id` → `itemId`), prefixed with `_` when it starts with a
+ * digit, and suffixed with `_` when it is a reserved word (`default` →
+ * `default_`).
+ *
+ * @param name - The name the document uses
+ * @returns A valid identifier
+ */
+export declare function toIdentifier(name: string): string;
+/**
+ * Turns a name from the document into a type identifier: a model, an enum or
+ * a class.
+ *
+ * Each part that starts with an upper-case letter and holds no separator is
+ * kept as written, acronyms included (`MCPListTools` stays `MCPListTools`).
+ * Any other part is pascal-cased on its separators (`order_item` →
+ * `OrderItem`, `Page«User»` → `PageUser`). The result is prefixed with `_`
+ * when it starts with a digit (`1stThing` → `_1stThing`).
+ *
+ * @param name - A name, or the parts of one
+ * @returns A valid type identifier
+ */
+export declare function toTypeIdentifier(name: string | string[]): string;
+export declare function splitName(name: string): string[];
+/**
+ * Splits a name string or array of strings by common naming separators.
+ *
+ * This function takes a string or array of strings and splits them based on common naming
+ * separators including hyphens, underscores, spaces, dots, and before uppercase letters.
+ * If an array is provided, each element is split individually and the results are flattened.
+ *
+ * @param name - A string or array of strings to split by naming separators
+ * @returns An array of string parts split by naming separators
+ */
+export declare function tokenizeName(name: string | string[]): string[];
+/**
+ * Splits camelCase strings properly, keeping consecutive uppercase letters together.
+ *
+ * @param parts - Array of string parts to process
+ * @returns Array of properly split parts
+ */
+export declare function splitCamelCase(parts: string[]): string[];
+/**
+ * Converts a string or array of strings to PascalCase format.
+ *
+ * This function takes a string or array of strings and converts them to PascalCase format
+ * by splitting the input based on common naming separators and capitalizing the first
+ * letter of each part.
+ *
+ * @param name - A string or array of strings to convert to PascalCase
+ * @returns The PascalCase formatted string
+ */
+export declare function pascalCase(name: string | string[]): string;
+/**
+ * Converts a string or array of strings to camelCase format.
+ *
+ * This function first converts the input to PascalCase and then converts the first character to lowercase.
+ *
+ * @param name - A string or array of strings to convert to camelCase
+ * @returns The camelCase formatted string
+ */
+export declare function camelCase(name: string | string[]): string;
+/**
+ * Converts a string or array of strings to UPPER_SNAKE_CASE format.
+ *
+ * This function takes a string or array of strings and converts them to UPPER_SNAKE_CASE format
+ * by splitting the input based on common naming separators, converting each part to uppercase,
+ * and joining them with underscores. It properly handles consecutive uppercase letters
+ * (like acronyms) by treating them as single units.
+ *
+ * @param name - A string or array of strings to convert to UPPER_SNAKE_CASE
+ * @returns The UPPER_SNAKE_CASE formatted string
+ */
+export declare function upperSnakeCase(name: string | string[]): string;
+export declare function resolvePropertyName(name: string): string;
+/**
+ * The member key an enum value prefers, before quoting: its UPPER_SNAKE_CASE
+ * form, `NUM_` and the digits for a number.
+ */
+export declare function enumMemberKey(name: string): string;
+/**
+ * Renders a value as a single-quoted TypeScript string literal.
+ *
+ * A property name is whatever the document says it is, so one carrying a
+ * quote or a backslash has to be escaped rather than wrapped - `owner'sName`
+ * would otherwise close the literal and generate a syntax error.
+ *
+ * @param value - The string to render
+ * @returns The escaped string literal, quotes included
+ */
+export declare function quoteStringLiteral(value: string): string;

package/dist/naming/naming.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Tells whether a name is a valid identifier as written.
+ *
+ * @param name - The candidate
+ * @returns True when it can name a variable, a parameter or a type
+ */
+export declare function isIdentifier(name: string): boolean;
+/**
+ * Turns a name from the document into a value identifier: a parameter, a
+ * method or a variable.
+ *
+ * A valid identifier is kept as written. Anything else is camel-cased on its
+ * separators (`item-id` → `itemId`), prefixed with `_` when it starts with a
+ * digit, and suffixed with `_` when it is a reserved word (`default` →
+ * `default_`).
+ *
+ * @param name - The name the document uses
+ * @returns A valid identifier
+ */
+export declare function toIdentifier(name: string): string;
+/**
+ * Turns a name from the document into a type identifier: a model, an enum or
+ * a class.
+ *
+ * Each part that starts with an upper-case letter and holds no separator is
+ * kept as written, acronyms included (`MCPListTools` stays `MCPListTools`).
+ * Any other part is pascal-cased on its separators (`order_item` →
+ * `OrderItem`, `Page«User»` → `PageUser`). The result is prefixed with `_`
+ * when it starts with a digit (`1stThing` → `_1stThing`).
+ *
+ * @param name - A name, or the parts of one
+ * @returns A valid type identifier
+ */
+export declare function toTypeIdentifier(name: string | string[]): string;
+export declare function splitName(name: string): string[];
+/**
+ * Splits a name string or array of strings by common naming separators.
+ *
+ * This function takes a string or array of strings and splits them based on common naming
+ * separators including hyphens, underscores, spaces, dots, and before uppercase letters.
+ * If an array is provided, each element is split individually and the results are flattened.
+ *
+ * @param name - A string or array of strings to split by naming separators
+ * @returns An array of string parts split by naming separators
+ */
+export declare function tokenizeName(name: string | string[]): string[];
+/**
+ * Splits camelCase strings properly, keeping consecutive uppercase letters together.
+ *
+ * @param parts - Array of string parts to process
+ * @returns Array of properly split parts
+ */
+export declare function splitCamelCase(parts: string[]): string[];
+/**
+ * Converts a string or array of strings to PascalCase format.
+ *
+ * This function takes a string or array of strings and converts them to PascalCase format
+ * by splitting the input based on common naming separators and capitalizing the first
+ * letter of each part.
+ *
+ * @param name - A string or array of strings to convert to PascalCase
+ * @returns The PascalCase formatted string
+ */
+export declare function pascalCase(name: string | string[]): string;
+/**
+ * Converts a string or array of strings to camelCase format.
+ *
+ * This function first converts the input to PascalCase and then converts the first character to lowercase.
+ *
+ * @param name - A string or array of strings to convert to camelCase
+ * @returns The camelCase formatted string
+ */
+export declare function camelCase(name: string | string[]): string;
+/**
+ * Converts a string or array of strings to UPPER_SNAKE_CASE format.
+ *
+ * This function takes a string or array of strings and converts them to UPPER_SNAKE_CASE format
+ * by splitting the input based on common naming separators, converting each part to uppercase,
+ * and joining them with underscores. It properly handles consecutive uppercase letters
+ * (like acronyms) by treating them as single units.
+ *
+ * @param name - A string or array of strings to convert to UPPER_SNAKE_CASE
+ * @returns The UPPER_SNAKE_CASE formatted string
+ */
+export declare function upperSnakeCase(name: string | string[]): string;
+export declare function resolvePropertyName(name: string): string;
+/**
+ * The member key an enum value prefers, before quoting: its UPPER_SNAKE_CASE
+ * form, `NUM_` and the digits for a number.
+ */
+export declare function enumMemberKey(name: string): string;
+/**
+ * Renders a value as a single-quoted TypeScript string literal.
+ *
+ * A property name is whatever the document says it is, so one carrying a
+ * quote or a backslash has to be escaped rather than wrapped - `owner'sName`
+ * would otherwise close the literal and generate a syntax error.
+ *
+ * @param value - The string to render
+ * @returns The escaped string literal, quotes included
+ */
+export declare function quoteStringLiteral(value: string): string;

package/dist/naming/order.d.cts

@@ -0,0 +1,2 @@
+/** Compares two names in the fixed `en-US` order; a comparator for `sort`. */
+export declare function compareNames(left: string, right: string): number;

package/dist/naming/order.d.ts

@@ -0,0 +1,2 @@
+/** Compares two names in the fixed `en-US` order; a comparator for `sort`. */
+export declare function compareNames(left: string, right: string): number;

package/dist/naming/paths.d.cts

@@ -0,0 +1,27 @@
+/**
+ * Joins a relative path onto a base with exactly one `/` between them, as
+ * `@ahoo-wang/fetcher`'s `combineURLs` does, so the generator process need
+ * not load fetcher for it: `('a/', '/b.ts')` → `a/b.ts`. An empty relative
+ * path gives the base, and a URL with a scheme (`https://…`, `//host/…`)
+ * replaces it.
+ *
+ * @param base - The path to join onto
+ * @param relative - The path to join
+ */
+export declare function combinePaths(base: string, relative: string): string;
+/** The file every model of a package is declared in. */
+export declare const MODEL_FILE_NAME = "types.ts";
+/**
+ * The file a model is declared in, relative to the output directory: the
+ * `types.ts` of its package.
+ *
+ * @param model - The model, whose path is its package (`/` for the root)
+ */
+export declare function modelFilePath(model: {
+    readonly path: string;
+}): string;
+/**
+ * The file that declares a bounded context's alias constant, relative to the
+ * output directory.
+ */
+export declare function boundedContextFilePath(contextAlias: string): string;

package/dist/naming/paths.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Joins a relative path onto a base with exactly one `/` between them, as
+ * `@ahoo-wang/fetcher`'s `combineURLs` does, so the generator process need
+ * not load fetcher for it: `('a/', '/b.ts')` → `a/b.ts`. An empty relative
+ * path gives the base, and a URL with a scheme (`https://…`, `//host/…`)
+ * replaces it.
+ *
+ * @param base - The path to join onto
+ * @param relative - The path to join
+ */
+export declare function combinePaths(base: string, relative: string): string;
+/** The file every model of a package is declared in. */
+export declare const MODEL_FILE_NAME = "types.ts";
+/**
+ * The file a model is declared in, relative to the output directory: the
+ * `types.ts` of its package.
+ *
+ * @param model - The model, whose path is its package (`/` for the root)
+ */
+export declare function modelFilePath(model: {
+    readonly path: string;
+}): string;
+/**
+ * The file that declares a bounded context's alias constant, relative to the
+ * output directory.
+ */
+export declare function boundedContextFilePath(contextAlias: string): string;

package/dist/openapi/components.d.cts

@@ -0,0 +1,55 @@
+import { Components, Parameter, Reference, RequestBody, Response, Schema } from '@ahoo-wang/fetcher-openapi';
+/** Prefix for OpenAPI components references */
+export declare const COMPONENTS_PREFIX = "#/components/";
+/** Reference prefix for parameters components */
+export declare const COMPONENTS_PARAMETERS_REF = "#/components/parameters/";
+/** Reference prefix for request bodies components */
+export declare const COMPONENTS_REQUEST_BODIES_REF = "#/components/requestBodies/";
+/** Reference prefix for responses components */
+export declare const COMPONENTS_RESPONSES_REF = "#/components/responses/";
+/** Reference prefix for schemas components */
+export declare const COMPONENTS_SCHEMAS_REF = "#/components/schemas/";
+/**
+ * Represents a schema with its key identifier.
+ */
+export interface KeySchema<T extends Schema | Reference = Schema> {
+    /** The schema key */
+    key: string;
+    /** The schema definition */
+    schema: T;
+}
+/**
+ * Extracts the component key from an OpenAPI reference.
+ * @param reference - The OpenAPI reference object
+ * @returns The component key (last part of the reference path)
+ */
+export declare function extractComponentKey(reference: Reference): string;
+export declare function extractSchema(reference: Reference, components: Components): Schema | undefined;
+/**
+ * Extracts a response from OpenAPI components using a reference.
+ * @param reference - The reference to the response
+ * @param components - The OpenAPI components object
+ * @returns The response if found, undefined otherwise
+ */
+export declare function extractResponse(reference: Reference, components: Components): Response | undefined;
+/**
+ * Extracts a request body from OpenAPI components using a reference.
+ * @param reference - The reference to the request body
+ * @param components - The OpenAPI components object
+ * @returns The request body if found, undefined otherwise
+ */
+export declare function extractRequestBody(reference: Reference, components: Components): RequestBody | undefined;
+/**
+ * Extracts a parameter from OpenAPI components using a reference.
+ * @param reference - The reference to the parameter
+ * @param components - The OpenAPI components object
+ * @returns The parameter if found, undefined otherwise
+ */
+export declare function extractParameter(reference: Reference, components: Components): Parameter | undefined;
+/**
+ * Creates a KeySchema object from a reference and components.
+ * @param reference - The reference to the schema
+ * @param components - The OpenAPI components object
+ * @returns A KeySchema containing the key and resolved schema
+ */
+export declare function keySchema(reference: Reference, components: Components): KeySchema;

package/dist/openapi/components.d.ts

@@ -0,0 +1,55 @@
+import { Components, Parameter, Reference, RequestBody, Response, Schema } from '@ahoo-wang/fetcher-openapi';
+/** Prefix for OpenAPI components references */
+export declare const COMPONENTS_PREFIX = "#/components/";
+/** Reference prefix for parameters components */
+export declare const COMPONENTS_PARAMETERS_REF = "#/components/parameters/";
+/** Reference prefix for request bodies components */
+export declare const COMPONENTS_REQUEST_BODIES_REF = "#/components/requestBodies/";
+/** Reference prefix for responses components */
+export declare const COMPONENTS_RESPONSES_REF = "#/components/responses/";
+/** Reference prefix for schemas components */
+export declare const COMPONENTS_SCHEMAS_REF = "#/components/schemas/";
+/**
+ * Represents a schema with its key identifier.
+ */
+export interface KeySchema<T extends Schema | Reference = Schema> {
+    /** The schema key */
+    key: string;
+    /** The schema definition */
+    schema: T;
+}
+/**
+ * Extracts the component key from an OpenAPI reference.
+ * @param reference - The OpenAPI reference object
+ * @returns The component key (last part of the reference path)
+ */
+export declare function extractComponentKey(reference: Reference): string;
+export declare function extractSchema(reference: Reference, components: Components): Schema | undefined;
+/**
+ * Extracts a response from OpenAPI components using a reference.
+ * @param reference - The reference to the response
+ * @param components - The OpenAPI components object
+ * @returns The response if found, undefined otherwise
+ */
+export declare function extractResponse(reference: Reference, components: Components): Response | undefined;
+/**
+ * Extracts a request body from OpenAPI components using a reference.
+ * @param reference - The reference to the request body
+ * @param components - The OpenAPI components object
+ * @returns The request body if found, undefined otherwise
+ */
+export declare function extractRequestBody(reference: Reference, components: Components): RequestBody | undefined;
+/**
+ * Extracts a parameter from OpenAPI components using a reference.
+ * @param reference - The reference to the parameter
+ * @param components - The OpenAPI components object
+ * @returns The parameter if found, undefined otherwise
+ */
+export declare function extractParameter(reference: Reference, components: Components): Parameter | undefined;
+/**
+ * Creates a KeySchema object from a reference and components.
+ * @param reference - The reference to the schema
+ * @param components - The OpenAPI components object
+ * @returns A KeySchema containing the key and resolved schema
+ */
+export declare function keySchema(reference: Reference, components: Components): KeySchema;

package/dist/openapi/document.d.cts

@@ -0,0 +1,25 @@
+import { Components, OpenAPI } from '@ahoo-wang/fetcher-openapi';
+import { OperationEndpoint } from './operations.cjs';
+/**
+ * A parsed OpenAPI document as the generator reads it: the document itself,
+ * which nothing changes, and its operations, listed once.
+ */
+export interface OpenApiDocument {
+    /** The parsed document. Read only: every stage reads the same one. */
+    readonly openAPI: OpenAPI;
+    /** Its components, if it has any. */
+    readonly components?: Components;
+    /**
+     * Every operation with its method and path, the path item's parameters
+     * merged into its own (an operation's parameter overrides the path item's
+     * one of the same name and location), ordered by operation id, then path,
+     * then method.
+     */
+    readonly endpoints: readonly OperationEndpoint[];
+}
+/**
+ * Reads a parsed document: lists its operations once, for every stage.
+ *
+ * @param openAPI - The parsed document; left unchanged
+ */
+export declare function openApiDocument(openAPI: OpenAPI): OpenApiDocument;

package/dist/openapi/document.d.ts

@@ -0,0 +1,25 @@
+import { Components, OpenAPI } from '@ahoo-wang/fetcher-openapi';
+import { OperationEndpoint } from './operations.js';
+/**
+ * A parsed OpenAPI document as the generator reads it: the document itself,
+ * which nothing changes, and its operations, listed once.
+ */
+export interface OpenApiDocument {
+    /** The parsed document. Read only: every stage reads the same one. */
+    readonly openAPI: OpenAPI;
+    /** Its components, if it has any. */
+    readonly components?: Components;
+    /**
+     * Every operation with its method and path, the path item's parameters
+     * merged into its own (an operation's parameter overrides the path item's
+     * one of the same name and location), ordered by operation id, then path,
+     * then method.
+     */
+    readonly endpoints: readonly OperationEndpoint[];
+}
+/**
+ * Reads a parsed document: lists its operations once, for every stage.
+ *
+ * @param openAPI - The parsed document; left unchanged
+ */
+export declare function openApiDocument(openAPI: OpenAPI): OpenApiDocument;

package/dist/openapi/operations.d.cts

@@ -0,0 +1,78 @@
+import { Components, HTTPMethod, Operation, Parameter, PathItem, Paths, Reference, Response, Schema } from '@ahoo-wang/fetcher-openapi';
+/**
+ * Represents an HTTP method and its associated operation.
+ */
+export interface MethodOperation {
+    /** The HTTP method */
+    method: HTTPMethod;
+    /** The OpenAPI operation */
+    operation: Operation;
+}
+export interface OperationEndpoint extends MethodOperation {
+    path: string;
+}
+export declare function operationEndpointComparator(left: OperationEndpoint, right: OperationEndpoint): number;
+export declare function extractOperationEndpoints(paths: Paths, components?: Components): Array<OperationEndpoint>;
+/**
+ * Extracts all operations from a path item.
+ * @param pathItem - The OpenAPI path item
+ * @returns Array of method-operation pairs
+ */
+export declare function extractOperations(pathItem: PathItem): MethodOperation[];
+/**
+ * Picks the status code of an operation's success response: `200`, else the
+ * lowest other 2xx code, else `2XX`.
+ *
+ * @param operation - The OpenAPI operation
+ * @returns The status code key, or undefined when no 2xx response is declared
+ */
+export declare function okResponseStatus(operation: Operation): string | undefined;
+/**
+ * Extracts the success response from an operation: `200`, else the lowest
+ * other 2xx response, else `2XX`.
+ * @param operation - The OpenAPI operation
+ * @param components - Optional components used to resolve response references
+ * @returns The success response or undefined if not found
+ */
+export declare function extractOkResponse(operation: Operation, components?: Components): Response | Reference | undefined;
+/**
+ * Extracts the JSON schema from the OK response of an operation.
+ * @param operation - The OpenAPI operation
+ * @param components - Optional components used to resolve response references
+ * @returns The JSON schema from the OK response or undefined if not found
+ */
+export declare function extractOperationOkResponseJsonSchema(operation: Operation, components?: Components): Schema | Reference | undefined;
+/**
+ * Extracts the parameters of an operation, references resolved, in document
+ * order.
+ * @param operation - The OpenAPI operation
+ * @param components - The OpenAPI components object used to resolve references
+ * @returns The parameters
+ */
+export declare function extractParameters(operation: Operation, components: Components): Parameter[];
+/**
+ * Extracts path parameters from an operation.
+ * @param operation - The OpenAPI operation to extract path parameters from
+ * @param components - The OpenAPI components object used to resolve references
+ * @returns Array of path parameters
+ */
+export declare function extractPathParameters(operation: Operation, components: Components): Parameter[];
+/**
+ * Orders path parameters as the path holds them, whatever order the document
+ * lists them in: `/cart/{id}/{customerId}` gives `id`, then `customerId`.
+ * A method takes them in this order, so a route that gains a variable keeps
+ * the arguments before it where they were. Parameters the path does not
+ * hold keep their order, after the others.
+ *
+ * @param path - The route, with `{name}` variables
+ * @param parameters - Its path parameters
+ * @returns A new array, sorted
+ */
+export declare function inPathOrder<P extends Pick<Parameter, 'name'>>(path: string, parameters: readonly P[]): P[];
+/**
+ * Resolves the type of a path parameter.
+ * @param parameter - The path parameter to resolve the type for
+ * @returns The resolved primitive type as a string, or the default path parameter type if the schema is missing,
+ *          is a reference, lacks a type, or the type is not primitive
+ */
+export declare function resolvePathParameterType(parameter: Parameter): string;