Skip to content

Commit 80b3cfd

Browse files
committed
format type parameters as code blocks
1 parent a9be50e commit 80b3cfd

File tree

3 files changed

+106
-100
lines changed

3 files changed

+106
-100
lines changed

packages/components/docs/API.md

Lines changed: 94 additions & 94 deletions
Original file line numberDiff line numberDiff line change
@@ -106,22 +106,22 @@ Generates both static and instance methods for sending messages through WebSocke
106106

107107

108108
<a name="CloseConnection"></a>
109-
## **CloseConnection**
109+
## **CloseConnection()**
110110
Renders a WebSocket close connection method with optional pre- and post-execution logic.
111111

112112

113113
### Parameters
114114

115115
| Name | Type | Description |
116116
|------|------|-------------|
117-
| props | Object | Component props. |
118-
| props.language | Language | Programming language used for method formatting. |
119-
| props.framework | string | Framework used, if any (e.g., &#x27;quarkus&#x27; for Java). |
120-
| props.methodName | string | Name of the method to generate. |
121-
| props.methodParams | Array.<string> | List of parameters for the method. |
122-
| props.preExecutionCode | string | Code to insert before the main function logic. |
123-
| props.postExecutionCode | string | Code to insert after the main function logic. |
124-
| props.indent | number | Indentation level for the method block. |
117+
| props | <code>Object</code> | Component props. |
118+
| props.language | <code>Language</code> | Programming language used for method formatting. |
119+
| props.framework | <code>string</code> | Framework used, if any (e.g., &#x27;quarkus&#x27; for Java). |
120+
| props.methodName | <code>string</code> | Name of the method to generate. |
121+
| props.methodParams | <code>Array.&lt;string&gt;</code> | List of parameters for the method. |
122+
| props.preExecutionCode | <code>string</code> | Code to insert before the main function logic. |
123+
| props.postExecutionCode | <code>string</code> | Code to insert after the main function logic. |
124+
| props.indent | <code>number</code> | Indentation level for the method block. |
125125

126126

127127

@@ -150,17 +150,17 @@ return (
150150

151151

152152
<a name="Connect"></a>
153-
## **Connect**
153+
## **Connect()**
154154
Component that renders WebSocket connection method for the specified programming language.
155155

156156

157157
### Parameters
158158

159159
| Name | Type | Description |
160160
|------|------|-------------|
161-
| props | Object | Component properties. |
162-
| props.language | Language | The programming language for which to generate connection code. |
163-
| props.title | string | The title of the WebSocket server. |
161+
| props | <code>Object</code> | Component properties. |
162+
| props.language | <code>Language</code> | The programming language for which to generate connection code. |
163+
| props.title | <code>string</code> | The title of the WebSocket server. |
164164

165165

166166

@@ -179,19 +179,19 @@ return(
179179

180180

181181
<a name="DependencyProvider"></a>
182-
## **DependencyProvider**
182+
## **DependencyProvider()**
183183
Renders the top-of-file dependency statements for the selected programming language.
184184

185185

186186
### Parameters
187187

188188
| Name | Type | Description |
189189
|------|------|-------------|
190-
| props | Object | Component props. |
191-
| props.language | Language | The programming language for which to render dependency statements. |
192-
| props.framework | string | The framework (e.g., &#x27;quarkus&#x27; for Java). |
193-
| props.role | string | The role (e.g., &#x27;client&#x27;, &#x27;connector&#x27; for Java). |
194-
| props.additionalDependencies | Array.<string> | Optional additional dependencies to include. |
190+
| props | <code>Object</code> | Component props. |
191+
| props.language | <code>Language</code> | The programming language for which to render dependency statements. |
192+
| props.framework | <code>string</code> | The framework (e.g., &#x27;quarkus&#x27; for Java). |
193+
| props.role | <code>string</code> | The role (e.g., &#x27;client&#x27;, &#x27;connector&#x27; for Java). |
194+
| props.additionalDependencies | <code>Array.&lt;string&gt;</code> | Optional additional dependencies to include. |
195195

196196

197197

@@ -217,18 +217,18 @@ return (
217217

218218

219219
<a name="FileHeaderInfo"></a>
220-
## **FileHeaderInfo**
220+
## **FileHeaderInfo()**
221221
Renders a file header with metadata information such as title, version, protocol, host, and path.
222222

223223

224224
### Parameters
225225

226226
| Name | Type | Description |
227227
|------|------|-------------|
228-
| props | Object | Component props. |
229-
| props.info | object | Info object from the AsyncAPI document. |
230-
| props.server | object | Server object from the AsyncAPI document. |
231-
| props.language | Language | Programming language used for comment formatting. |
228+
| props | <code>Object</code> | Component props. |
229+
| props.info | <code>object</code> | Info object from the AsyncAPI document. |
230+
| props.server | <code>object</code> | Server object from the AsyncAPI document. |
231+
| props.language | <code>Language</code> | Programming language used for comment formatting. |
232232

233233

234234

@@ -260,21 +260,21 @@ return (
260260

261261

262262
<a name="HandleMessage"></a>
263-
## **HandleMessage**
263+
## **HandleMessage()**
264264
Renders a WebSocket message handler method with optional pre- and post-execution logic.
265265

266266

267267
### Parameters
268268

269269
| Name | Type | Description |
270270
|------|------|-------------|
271-
| props | Object | Component props. |
272-
| props.language | Language | Programming language used for method formatting. |
273-
| props.methodName | string | Name of the method to generate. |
274-
| props.methodParams | Array.<string> | List of parameters for the method. |
275-
| props.preExecutionCode | string | Code to insert before the main function logic. |
276-
| props.postExecutionCode | string | Code to insert after the main function logic. |
277-
| props.customMethodConfig | Object | Optional overrides for default method configuration. |
271+
| props | <code>Object</code> | Component props. |
272+
| props.language | <code>Language</code> | Programming language used for method formatting. |
273+
| props.methodName | <code>string</code> | Name of the method to generate. |
274+
| props.methodParams | <code>Array.&lt;string&gt;</code> | List of parameters for the method. |
275+
| props.preExecutionCode | <code>string</code> | Code to insert before the main function logic. |
276+
| props.postExecutionCode | <code>string</code> | Code to insert after the main function logic. |
277+
| props.customMethodConfig | <code>Object</code> | Optional overrides for default method configuration. |
278278

279279

280280

@@ -306,27 +306,27 @@ return (
306306

307307

308308
<a name="MethodGenerator"></a>
309-
## **MethodGenerator**
309+
## **MethodGenerator()**
310310
Generic Method rendering component.
311311

312312

313313
### Parameters
314314

315315
| Name | Type | Description |
316316
|------|------|-------------|
317-
| props | Object | Component props. |
318-
| props.language | Language | Programming language used for method formatting. |
319-
| props.methodName | string | Name of the method. |
320-
| props.methodParams | Array.<string> | Method parameters. |
321-
| props.methodDocs | string | Optional documentation string. |
322-
| props.methodLogic | string | Core method logic. |
323-
| props.preExecutionCode | string | Code before main logic. |
324-
| props.postExecutionCode | string | Code after main logic. |
325-
| props.indent | number | Indentation for the method block. |
326-
| props.newLines | number | Number of new lines after method. |
327-
| props.customMethodConfig | Object | Optional custom syntax configuration for the current language. |
328-
| props.methodConfig | Record.<Language, ({methodDocs: (string&#124;undefined), methodLogic: (string&#124;undefined)}&#124;Record.<string, {methodDocs: (string&#124;undefined), methodLogic: (string&#124;undefined)}>)> | Language-level or framework-level configuration. |
329-
| props.framework | string | Framework name for nested configurations (e.g., &#x27;quarkus&#x27; for Java). |
317+
| props | <code>Object</code> | Component props. |
318+
| props.language | <code>Language</code> | Programming language used for method formatting. |
319+
| props.methodName | <code>string</code> | Name of the method. |
320+
| props.methodParams | <code>Array.&lt;string&gt;</code> | Method parameters. |
321+
| props.methodDocs | <code>string</code> | Optional documentation string. |
322+
| props.methodLogic | <code>string</code> | Core method logic. |
323+
| props.preExecutionCode | <code>string</code> | Code before main logic. |
324+
| props.postExecutionCode | <code>string</code> | Code after main logic. |
325+
| props.indent | <code>number</code> | Indentation for the method block. |
326+
| props.newLines | <code>number</code> | Number of new lines after method. |
327+
| props.customMethodConfig | <code>Object</code> | Optional custom syntax configuration for the current language. |
328+
| props.methodConfig | <code>Record.&lt;Language, ({methodDocs: (string&#124;undefined), methodLogic: (string&#124;undefined)}&#124;Record.&lt;string, {methodDocs: (string&#124;undefined), methodLogic: (string&#124;undefined)}&gt;)&gt;</code> | Language-level or framework-level configuration. |
329+
| props.framework | <code>string</code> | Framework name for nested configurations (e.g., &#x27;quarkus&#x27; for Java). |
330330

331331

332332

@@ -353,20 +353,20 @@ return (
353353

354354

355355
<a name="Models"></a>
356-
## **Models**
356+
## **Models()**
357357
Generates and returns an array of model files based on the AsyncAPI document.
358358

359359

360360
### Parameters
361361

362362
| Name | Type | Description |
363363
|------|------|-------------|
364-
| params | Object | The parameters for the function. |
365-
| params.asyncapi | AsyncAPIDocumentInterface | Parsed AsyncAPI document object. |
366-
| params.language | Language | Target programming language for the generated models. |
367-
| params.format | Format | Naming format for generated files. |
368-
| params.presets | object | Custom presets for the generator instance. |
369-
| params.constraints | object | Custom constraints for the generator instance. |
364+
| params | <code>Object</code> | The parameters for the function. |
365+
| params.asyncapi | <code>AsyncAPIDocumentInterface</code> | Parsed AsyncAPI document object. |
366+
| params.language | <code>Language</code> | Target programming language for the generated models. |
367+
| params.format | <code>Format</code> | Naming format for generated files. |
368+
| params.presets | <code>object</code> | Custom presets for the generator instance. |
369+
| params.constraints | <code>object</code> | Custom constraints for the generator instance. |
370370

371371

372372

@@ -399,18 +399,18 @@ return (
399399

400400

401401
<a name="OnClose"></a>
402-
## **OnClose**
402+
## **OnClose()**
403403
Component that renders WebSocket onClose event handler for the specified programming language.
404404

405405

406406
### Parameters
407407

408408
| Name | Type | Description |
409409
|------|------|-------------|
410-
| props | Object | Component properties. |
411-
| props.language | Language | The programming language for which to generate onClose handler code. |
412-
| props.framework | string | Optional framework variant (e.g., &#x27;quarkus&#x27; for java). |
413-
| props.title | string | The title of the WebSocket server. |
410+
| props | <code>Object</code> | Component properties. |
411+
| props.language | <code>Language</code> | The programming language for which to generate onClose handler code. |
412+
| props.framework | <code>string</code> | Optional framework variant (e.g., &#x27;quarkus&#x27; for java). |
413+
| props.title | <code>string</code> | The title of the WebSocket server. |
414414

415415

416416

@@ -435,16 +435,16 @@ return (
435435

436436

437437
<a name="OnError"></a>
438-
## **OnError**
438+
## **OnError()**
439439
Component that renders WebSocket onError event handler for the specified programming language.
440440

441441

442442
### Parameters
443443

444444
| Name | Type | Description |
445445
|------|------|-------------|
446-
| props | Object | Component properties. |
447-
| props.language | Language | The programming language for which to generate onError handler code. |
446+
| props | <code>Object</code> | Component properties. |
447+
| props.language | <code>Language</code> | The programming language for which to generate onError handler code. |
448448

449449

450450

@@ -461,16 +461,16 @@ return (
461461

462462

463463
<a name="OnMessage"></a>
464-
## **OnMessage**
464+
## **OnMessage()**
465465
Component that renders WebSocket onMessage event handler for the specified programming language.
466466

467467

468468
### Parameters
469469

470470
| Name | Type | Description |
471471
|------|------|-------------|
472-
| props | Object | Component properties. |
473-
| props.language | Language | The programming language for which to generate onMessage handler code. |
472+
| props | <code>Object</code> | Component properties. |
473+
| props.language | <code>Language</code> | The programming language for which to generate onMessage handler code. |
474474

475475

476476

@@ -487,18 +487,18 @@ return (
487487

488488

489489
<a name="OnOpen"></a>
490-
## **OnOpen**
490+
## **OnOpen()**
491491
Component that renders WebSocket onOpen event handler for the specified programming language.
492492

493493

494494
### Parameters
495495

496496
| Name | Type | Description |
497497
|------|------|-------------|
498-
| props | Object | Component properties. |
499-
| props.language | Language | The programming language for which to generate onOpen handler code. |
500-
| props.framework | string | Optional framework variant (e.g., &#x27;quarkus&#x27; for java). |
501-
| props.title | string | The title of the WebSocket server. |
498+
| props | <code>Object</code> | Component properties. |
499+
| props.language | <code>Language</code> | The programming language for which to generate onOpen handler code. |
500+
| props.framework | <code>string</code> | Optional framework variant (e.g., &#x27;quarkus&#x27; for java). |
501+
| props.title | <code>string</code> | The title of the WebSocket server. |
502502

503503

504504

@@ -518,18 +518,18 @@ return (
518518

519519

520520
<a name="QueryParamsVariables"></a>
521-
## **QueryParamsVariables**
521+
## **QueryParamsVariables()**
522522
Component for rendering query parameter variables code.
523523

524524

525525
### Parameters
526526

527527
| Name | Type | Description |
528528
|------|------|-------------|
529-
| props | Object | Component props. |
530-
| props.language | Language | The target programming language. |
531-
| props.framework | string | Optional framework for the language. |
532-
| props.queryParams | Array.<Array.<string>> | Array of query parameters, each represented as [paramName, paramType?]. |
529+
| props | <code>Object</code> | Component props. |
530+
| props.language | <code>Language</code> | The target programming language. |
531+
| props.framework | <code>string</code> | Optional framework for the language. |
532+
| props.queryParams | <code>Array.&lt;Array.&lt;string&gt;&gt;</code> | Array of query parameters, each represented as [paramName, paramType?]. |
533533

534534

535535

@@ -568,21 +568,21 @@ return (
568568

569569

570570
<a name="RegisterErrorHandler"></a>
571-
## **RegisterErrorHandler**
571+
## **RegisterErrorHandler()**
572572
Renders a WebSocket error handler registration method with optional pre- and post-execution logic.
573573

574574

575575
### Parameters
576576

577577
| Name | Type | Description |
578578
|------|------|-------------|
579-
| props | Object | Component props. |
580-
| props.language | Language | Programming language used for method formatting. |
581-
| props.methodName | string | Name of the method to generate. |
582-
| props.methodParams | Array.<string> | List of parameters for the method. |
583-
| props.preExecutionCode | string | Code to insert before the main function logic. |
584-
| props.postExecutionCode | string | Code to insert after the main function logic. |
585-
| props.customMethodConfig | Object | Optional overrides for default method configuration. |
579+
| props | <code>Object</code> | Component props. |
580+
| props.language | <code>Language</code> | Programming language used for method formatting. |
581+
| props.methodName | <code>string</code> | Name of the method to generate. |
582+
| props.methodParams | <code>Array.&lt;string&gt;</code> | List of parameters for the method. |
583+
| props.preExecutionCode | <code>string</code> | Code to insert before the main function logic. |
584+
| props.postExecutionCode | <code>string</code> | Code to insert after the main function logic. |
585+
| props.customMethodConfig | <code>Object</code> | Optional overrides for default method configuration. |
586586

587587

588588

@@ -610,20 +610,20 @@ return (
610610

611611

612612
<a name="RegisterMessageHandler"></a>
613-
## **RegisterMessageHandler**
613+
## **RegisterMessageHandler()**
614614
Renders a WebSocket message handler registration method with optional pre- and post-execution logic.
615615

616616

617617
### Parameters
618618

619619
| Name | Type | Description |
620620
|------|------|-------------|
621-
| props | Object | Component props. |
622-
| props.language | Language | Programming language used for method formatting. |
623-
| props.methodName | string | Name of the method to generate. |
624-
| props.methodParams | Array.<string> | List of parameters for the method. |
625-
| props.preExecutionCode | string | Code to insert before the main function logic. |
626-
| props.postExecutionCode | string | Code to insert after the main function logic. |
621+
| props | <code>Object</code> | Component props. |
622+
| props.language | <code>Language</code> | Programming language used for method formatting. |
623+
| props.methodName | <code>string</code> | Name of the method to generate. |
624+
| props.methodParams | <code>Array.&lt;string&gt;</code> | List of parameters for the method. |
625+
| props.preExecutionCode | <code>string</code> | Code to insert before the main function logic. |
626+
| props.postExecutionCode | <code>string</code> | Code to insert after the main function logic. |
627627

628628

629629

@@ -650,7 +650,7 @@ return (
650650

651651

652652
<a name="SendOperations"></a>
653-
## **SendOperations**
653+
## **SendOperations()**
654654
Component for rendering WebSocket send operation methods.
655655
Generates both static and instance methods for sending messages through WebSocket connections.
656656

@@ -659,10 +659,10 @@ Generates both static and instance methods for sending messages through WebSocke
659659

660660
| Name | Type | Description |
661661
|------|------|-------------|
662-
| props | Object | Component props. |
663-
| props.language | Language | The target programming language. |
664-
| props.sendOperations | Array.<Object> | Array of send operations from AsyncAPI document. |
665-
| props.clientName | string | The name of the client class. |
662+
| props | <code>Object</code> | Component props. |
663+
| props.language | <code>Language</code> | The target programming language. |
664+
| props.sendOperations | <code>Array.&lt;Object&gt;</code> | Array of send operations from AsyncAPI document. |
665+
| props.clientName | <code>string</code> | The name of the client class. |
666666

667667

668668

0 commit comments

Comments
 (0)