|
2 | 2 | "metadata": { |
3 | 3 | "toolPackage": "@microsoft/api-extractor", |
4 | 4 | "toolVersion": "[test mode]", |
5 | | - "schemaVersion": 1001, |
| 5 | + "schemaVersion": 1002, |
6 | 6 | "oldestForwardsCompatibleVersion": 1001 |
7 | 7 | }, |
8 | 8 | "kind": "Package", |
9 | | - "containerKey": "api-documenter-test", |
10 | 9 | "docComment": "/**\n * api-extractor-test-05\n *\n * This project tests various documentation generation scenarios and doc comment syntaxes.\n *\n * @packageDocumentation\n */\n", |
11 | 10 | "name": "api-documenter-test", |
12 | 11 | "members": [ |
13 | 12 | { |
14 | 13 | "kind": "EntryPoint", |
15 | | - "containerKey": "", |
16 | 14 | "name": "", |
17 | 15 | "members": [ |
18 | 16 | { |
19 | 17 | "kind": "Variable", |
20 | | - "containerKey": "constVariable|Variable", |
21 | 18 | "docComment": "/**\n * An exported variable declaration.\n *\n * @public\n */\n", |
22 | 19 | "excerptTokens": [ |
23 | 20 | { |
|
42 | 39 | }, |
43 | 40 | { |
44 | 41 | "kind": "Class", |
45 | | - "containerKey": "DocBaseClass|Class", |
46 | 42 | "docComment": "/**\n * Example base class\n *\n * {@docCategory DocBaseClass}\n *\n * @public\n */\n", |
47 | 43 | "excerptTokens": [ |
48 | 44 | { |
|
63 | 59 | "members": [ |
64 | 60 | { |
65 | 61 | "kind": "Constructor", |
66 | | - "containerKey": "|Constructor|1", |
67 | 62 | "docComment": "/**\n * The simple constructor for `DocBaseClass`\n */\n", |
68 | 63 | "excerptTokens": [ |
69 | 64 | { |
|
77 | 72 | }, |
78 | 73 | { |
79 | 74 | "kind": "Constructor", |
80 | | - "containerKey": "|Constructor|2", |
81 | 75 | "docComment": "/**\n * The overloaded constructor for `DocBaseClass`\n */\n", |
82 | 76 | "excerptTokens": [ |
83 | 77 | { |
|
118 | 112 | }, |
119 | 113 | { |
120 | 114 | "kind": "Class", |
121 | | - "containerKey": "DocClass1|Class", |
122 | 115 | "docComment": "/**\n * This is an example class.\n *\n * @remarks\n *\n * These are some remarks.\n *\n * The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `DocClass1` class.\n *\n * @defaultValue\n *\n * a default value for this function\n *\n * {@docCategory DocClass1}\n *\n * @public\n */\n", |
123 | 116 | "excerptTokens": [ |
124 | 117 | { |
|
167 | 160 | "members": [ |
168 | 161 | { |
169 | 162 | "kind": "Method", |
170 | | - "containerKey": "deprecatedExample|Method|instance|0", |
171 | 163 | "docComment": "/**\n * @deprecated\n *\n * Use `otherThing()` instead.\n */\n", |
172 | 164 | "excerptTokens": [ |
173 | 165 | { |
|
199 | 191 | }, |
200 | 192 | { |
201 | 193 | "kind": "Method", |
202 | | - "containerKey": "exampleFunction|Method|instance|1", |
203 | 194 | "docComment": "/**\n * This is an overloaded function.\n *\n * @param a - the first string\n *\n * @param b - the second string\n */\n", |
204 | 195 | "excerptTokens": [ |
205 | 196 | { |
|
278 | 269 | }, |
279 | 270 | { |
280 | 271 | "kind": "Method", |
281 | | - "containerKey": "exampleFunction|Method|instance|2", |
282 | 272 | "docComment": "/**\n * This is also an overloaded function.\n *\n * @param x - the number\n */\n", |
283 | 273 | "excerptTokens": [ |
284 | 274 | { |
|
334 | 324 | }, |
335 | 325 | { |
336 | 326 | "kind": "Method", |
337 | | - "containerKey": "interestingEdgeCases|Method|instance|0", |
338 | 327 | "docComment": "/**\n * Example: \"\\{ \\\\\"maxItemsToShow\\\\\": 123 \\}\"\n *\n * The regular expression used to validate the constraints is /^[a-zA-Z0-9\\\\-_]+$/\n */\n", |
339 | 328 | "excerptTokens": [ |
340 | 329 | { |
|
366 | 355 | }, |
367 | 356 | { |
368 | 357 | "kind": "Property", |
369 | | - "containerKey": "malformedEvent|Property|instance", |
370 | 358 | "docComment": "/**\n * This event should have been marked as readonly.\n *\n * @eventProperty\n */\n", |
371 | 359 | "excerptTokens": [ |
372 | 360 | { |
|
396 | 384 | }, |
397 | 385 | { |
398 | 386 | "kind": "Property", |
399 | | - "containerKey": "modifiedEvent|Property|instance", |
400 | 387 | "docComment": "/**\n * This event is fired whenever the object is modified.\n *\n * @eventProperty\n */\n", |
401 | 388 | "excerptTokens": [ |
402 | 389 | { |
|
430 | 417 | }, |
431 | 418 | { |
432 | 419 | "kind": "Property", |
433 | | - "containerKey": "regularProperty|Property|instance", |
434 | 420 | "docComment": "/**\n * This is a regular property that happens to use the SystemEvent type.\n */\n", |
435 | 421 | "excerptTokens": [ |
436 | 422 | { |
|
460 | 446 | }, |
461 | 447 | { |
462 | 448 | "kind": "Method", |
463 | | - "containerKey": "sumWithExample|Method|static|0", |
464 | 449 | "docComment": "/**\n * Returns the sum of two numbers.\n *\n * @remarks\n *\n * This illustrates usage of the `@example` block tag.\n *\n * @param x - the first number to add\n *\n * @param y - the second number to add\n *\n * @returns the sum of the two numbers\n *\n * @example\n *\n * Here's a simple example:\n * ```\n * // Prints \"2\":\n * console.log(DocClass1.sumWithExample(1,1));\n * ```\n *\n * @example\n *\n * Here's an example with negative numbers:\n * ```\n * // Prints \"0\":\n * console.log(DocClass1.sumWithExample(1,-1));\n * ```\n *\n */\n", |
465 | 450 | "excerptTokens": [ |
466 | 451 | { |
|
543 | 528 | }, |
544 | 529 | { |
545 | 530 | "kind": "Method", |
546 | | - "containerKey": "tableExample|Method|instance|0", |
547 | 531 | "docComment": "/**\n * An example with tables:\n *\n * @remarks\n *\n * <table> <tr> <td>John</td> <td>Doe</td> </tr> </table>\n */\n", |
548 | 532 | "excerptTokens": [ |
549 | 533 | { |
|
591 | 575 | }, |
592 | 576 | { |
593 | 577 | "kind": "Enum", |
594 | | - "containerKey": "DocEnum|Enum", |
595 | 578 | "docComment": "/**\n * Docs for DocEnum\n *\n * {@docCategory SystemEvent}\n *\n * @public\n */\n", |
596 | 579 | "excerptTokens": [ |
597 | 580 | { |
|
612 | 595 | "members": [ |
613 | 596 | { |
614 | 597 | "kind": "EnumMember", |
615 | | - "containerKey": "One", |
616 | 598 | "docComment": "/**\n * These are some docs for One\n */\n", |
617 | 599 | "excerptTokens": [ |
618 | 600 | { |
|
637 | 619 | }, |
638 | 620 | { |
639 | 621 | "kind": "EnumMember", |
640 | | - "containerKey": "Two", |
641 | 622 | "docComment": "/**\n * These are some docs for Two\n */\n", |
642 | 623 | "excerptTokens": [ |
643 | 624 | { |
|
662 | 643 | }, |
663 | 644 | { |
664 | 645 | "kind": "EnumMember", |
665 | | - "containerKey": "Zero", |
666 | 646 | "docComment": "/**\n * These are some docs for Zero\n */\n", |
667 | 647 | "excerptTokens": [ |
668 | 648 | { |
|
689 | 669 | }, |
690 | 670 | { |
691 | 671 | "kind": "TypeAlias", |
692 | | - "containerKey": "ExampleTypeAlias|TypeAlias", |
693 | 672 | "docComment": "/**\n * A type alias\n *\n * @public\n */\n", |
694 | 673 | "excerptTokens": [ |
695 | 674 | { |
|
726 | 705 | }, |
727 | 706 | { |
728 | 707 | "kind": "Class", |
729 | | - "containerKey": "Generic|Class", |
730 | 708 | "docComment": "/**\n * Generic class.\n *\n * @public\n */\n", |
731 | 709 | "excerptTokens": [ |
732 | 710 | { |
|
770 | 748 | }, |
771 | 749 | { |
772 | 750 | "kind": "Function", |
773 | | - "containerKey": "globalFunction|Function|0", |
774 | 751 | "docComment": "/**\n * An exported function\n *\n * @public\n */\n", |
775 | 752 | "excerptTokens": [ |
776 | 753 | { |
|
829 | 806 | }, |
830 | 807 | { |
831 | 808 | "kind": "Interface", |
832 | | - "containerKey": "IDocInterface1|Interface", |
833 | 809 | "docComment": "/**\n * {@docCategory DocBaseClass}\n *\n * @public\n */\n", |
834 | 810 | "excerptTokens": [ |
835 | 811 | { |
|
850 | 826 | "members": [ |
851 | 827 | { |
852 | 828 | "kind": "PropertySignature", |
853 | | - "containerKey": "regularProperty|PropertySignature", |
854 | 829 | "docComment": "/**\n * Does something\n */\n", |
855 | 830 | "excerptTokens": [ |
856 | 831 | { |
|
882 | 857 | }, |
883 | 858 | { |
884 | 859 | "kind": "Interface", |
885 | | - "containerKey": "IDocInterface2|Interface", |
886 | 860 | "docComment": "/**\n * {@docCategory DocBaseClass}\n *\n * @public\n */\n", |
887 | 861 | "excerptTokens": [ |
888 | 862 | { |
|
911 | 885 | "members": [ |
912 | 886 | { |
913 | 887 | "kind": "MethodSignature", |
914 | | - "containerKey": "deprecatedExample|MethodSignature|0", |
915 | 888 | "docComment": "/**\n * @deprecated\n *\n * Use `otherThing()` instead.\n */\n", |
916 | 889 | "excerptTokens": [ |
917 | 890 | { |
|
950 | 923 | }, |
951 | 924 | { |
952 | 925 | "kind": "Interface", |
953 | | - "containerKey": "IDocInterface3|Interface", |
954 | 926 | "docComment": "/**\n * Some less common TypeScript declaration kinds.\n *\n * {@docCategory DocClass1}\n *\n * @public\n */\n", |
955 | 927 | "excerptTokens": [ |
956 | 928 | { |
|
971 | 943 | "members": [ |
972 | 944 | { |
973 | 945 | "kind": "CallSignature", |
974 | | - "containerKey": "|CallSignature|0", |
975 | 946 | "docComment": "/**\n * Call signature\n *\n * @param x - the parameter\n */\n", |
976 | 947 | "excerptTokens": [ |
977 | 948 | { |
|
1021 | 992 | }, |
1022 | 993 | { |
1023 | 994 | "kind": "ConstructSignature", |
1024 | | - "containerKey": "|ConstructSignature|0", |
1025 | 995 | "docComment": "/**\n * Construct signature\n */\n", |
1026 | 996 | "excerptTokens": [ |
1027 | 997 | { |
|
1047 | 1017 | }, |
1048 | 1018 | { |
1049 | 1019 | "kind": "IndexSignature", |
1050 | | - "containerKey": "|IndexSignature|0", |
1051 | 1020 | "docComment": "/**\n * Indexer\n *\n * @param x - the parameter\n */\n", |
1052 | 1021 | "excerptTokens": [ |
1053 | 1022 | { |
|
1100 | 1069 | }, |
1101 | 1070 | { |
1102 | 1071 | "kind": "Interface", |
1103 | | - "containerKey": "IDocInterface4|Interface", |
1104 | 1072 | "docComment": "/**\n * Type union in an interface.\n *\n * {@docCategory DocClass1}\n *\n * @public\n */\n", |
1105 | 1073 | "excerptTokens": [ |
1106 | 1074 | { |
|
1121 | 1089 | "members": [ |
1122 | 1090 | { |
1123 | 1091 | "kind": "PropertySignature", |
1124 | | - "containerKey": "Context|PropertySignature", |
1125 | 1092 | "docComment": "/**\n * Test newline rendering when code blocks are used in tables\n */\n", |
1126 | 1093 | "excerptTokens": [ |
1127 | 1094 | { |
|
1166 | 1133 | }, |
1167 | 1134 | { |
1168 | 1135 | "kind": "PropertySignature", |
1169 | | - "containerKey": "generic|PropertySignature", |
1170 | 1136 | "docComment": "/**\n * make sure html entities are escaped in tables.\n */\n", |
1171 | 1137 | "excerptTokens": [ |
1172 | 1138 | { |
|
1199 | 1165 | }, |
1200 | 1166 | { |
1201 | 1167 | "kind": "PropertySignature", |
1202 | | - "containerKey": "numberOrFunction|PropertySignature", |
1203 | 1168 | "docComment": "/**\n * a union type with a function\n */\n", |
1204 | 1169 | "excerptTokens": [ |
1205 | 1170 | { |
|
1228 | 1193 | }, |
1229 | 1194 | { |
1230 | 1195 | "kind": "PropertySignature", |
1231 | | - "containerKey": "stringOrNumber|PropertySignature", |
1232 | 1196 | "docComment": "/**\n * a union type\n */\n", |
1233 | 1197 | "excerptTokens": [ |
1234 | 1198 | { |
|
1260 | 1224 | }, |
1261 | 1225 | { |
1262 | 1226 | "kind": "Interface", |
1263 | | - "containerKey": "IDocInterface5|Interface", |
1264 | 1227 | "docComment": "/**\n * Interface without inline tag to test custom TOC\n *\n * @public\n */\n", |
1265 | 1228 | "excerptTokens": [ |
1266 | 1229 | { |
|
1281 | 1244 | "members": [ |
1282 | 1245 | { |
1283 | 1246 | "kind": "PropertySignature", |
1284 | | - "containerKey": "regularProperty|PropertySignature", |
1285 | 1247 | "docComment": "/**\n * Property of type string that does something\n */\n", |
1286 | 1248 | "excerptTokens": [ |
1287 | 1249 | { |
|
1313 | 1275 | }, |
1314 | 1276 | { |
1315 | 1277 | "kind": "Interface", |
1316 | | - "containerKey": "IDocInterface6|Interface", |
1317 | 1278 | "docComment": "/**\n * Interface without inline tag to test custom TOC with injection\n *\n * @public\n */\n", |
1318 | 1279 | "excerptTokens": [ |
1319 | 1280 | { |
|
1334 | 1295 | "members": [ |
1335 | 1296 | { |
1336 | 1297 | "kind": "PropertySignature", |
1337 | | - "containerKey": "regularProperty|PropertySignature", |
1338 | 1298 | "docComment": "/**\n * Property of type number that does something\n */\n", |
1339 | 1299 | "excerptTokens": [ |
1340 | 1300 | { |
|
1366 | 1326 | }, |
1367 | 1327 | { |
1368 | 1328 | "kind": "Namespace", |
1369 | | - "containerKey": "OuterNamespace|Namespace", |
1370 | 1329 | "docComment": "/**\n * A top-level namespace\n *\n * @public\n */\n", |
1371 | 1330 | "excerptTokens": [ |
1372 | 1331 | { |
|
1387 | 1346 | "members": [ |
1388 | 1347 | { |
1389 | 1348 | "kind": "Namespace", |
1390 | | - "containerKey": "InnerNamespace|Namespace", |
1391 | 1349 | "docComment": "/**\n * A nested namespace\n */\n", |
1392 | 1350 | "excerptTokens": [ |
1393 | 1351 | { |
|
1408 | 1366 | "members": [ |
1409 | 1367 | { |
1410 | 1368 | "kind": "Function", |
1411 | | - "containerKey": "nestedFunction|Function|0", |
1412 | 1369 | "docComment": "/**\n * A function inside a namespace\n */\n", |
1413 | 1370 | "excerptTokens": [ |
1414 | 1371 | { |
|
1469 | 1426 | }, |
1470 | 1427 | { |
1471 | 1428 | "kind": "Variable", |
1472 | | - "containerKey": "nestedVariable|Variable", |
1473 | 1429 | "docComment": "/**\n * A variable exported from within a namespace.\n */\n", |
1474 | 1430 | "excerptTokens": [ |
1475 | 1431 | { |
|
1496 | 1452 | }, |
1497 | 1453 | { |
1498 | 1454 | "kind": "Class", |
1499 | | - "containerKey": "SystemEvent|Class", |
1500 | 1455 | "docComment": "/**\n * A class used to exposed events.\n *\n * {@docCategory SystemEvent}\n *\n * @public\n */\n", |
1501 | 1456 | "excerptTokens": [ |
1502 | 1457 | { |
|
1517 | 1472 | "members": [ |
1518 | 1473 | { |
1519 | 1474 | "kind": "Method", |
1520 | | - "containerKey": "addHandler|Method|instance|0", |
1521 | 1475 | "docComment": "/**\n * Adds an handler for the event.\n */\n", |
1522 | 1476 | "excerptTokens": [ |
1523 | 1477 | { |
|
0 commit comments