bridgelist 1.0.8 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/analyzers/array-analyzer.d.ts +14 -0
- package/dist/analyzers/array-analyzer.js +103 -0
- package/dist/analyzers/array-analyzer.js.map +1 -0
- package/dist/analyzers/ast-analyzer.js +11 -65
- package/dist/analyzers/ast-analyzer.js.map +1 -1
- package/dist/analyzers/method-analyzer.d.ts +3 -2
- package/dist/analyzers/method-analyzer.js +91 -89
- package/dist/analyzers/method-analyzer.js.map +1 -1
- package/dist/analyzers/property-access-analyzer.d.ts +3 -6
- package/dist/analyzers/property-access-analyzer.js +62 -58
- package/dist/analyzers/property-access-analyzer.js.map +1 -1
- package/dist/decorators/array-documentation.d.ts +2 -0
- package/dist/decorators/array-documentation.js +9 -0
- package/dist/decorators/array-documentation.js.map +1 -0
- package/dist/decorators/mapping-documentation.js.map +1 -1
- package/dist/generators/array-list-generator.d.ts +1 -0
- package/dist/generators/array-list-generator.js +143 -0
- package/dist/generators/array-list-generator.js.map +1 -0
- package/dist/generators/doc-generator-html.d.ts +1 -0
- package/dist/generators/doc-generator-html.js +375 -0
- package/dist/generators/doc-generator-html.js.map +1 -0
- package/dist/generators/doc-output-registry.d.ts +4 -0
- package/dist/generators/doc-output-registry.js +21 -0
- package/dist/generators/doc-output-registry.js.map +1 -0
- package/dist/generators/mapping-generator.d.ts +2 -0
- package/dist/generators/mapping-generator.js +167 -0
- package/dist/generators/mapping-generator.js.map +1 -0
- package/dist/index.d.ts +9 -3
- package/dist/index.js +18 -6
- package/dist/index.js.map +1 -1
- package/dist/types/index.d.ts +6 -0
- package/dist/utils/array-scanner.d.ts +7 -0
- package/dist/utils/array-scanner.js +53 -0
- package/dist/utils/array-scanner.js.map +1 -0
- package/dist/utils/find-all-ts-files.d.ts +1 -0
- package/dist/utils/find-all-ts-files.js +25 -0
- package/dist/utils/find-all-ts-files.js.map +1 -0
- package/dist/utils/find-decorated-methods.d.ts +16 -0
- package/dist/utils/find-decorated-methods.js +103 -0
- package/dist/utils/find-decorated-methods.js.map +1 -0
- package/dist/utils/mapping-scanner.d.ts +7 -0
- package/dist/utils/mapping-scanner.js +53 -0
- package/dist/utils/mapping-scanner.js.map +1 -0
- package/docs/documentation.html +574 -0
- package/docs/relevantPropertiesArray.html +266 -0
- package/package.json +6 -3
- package/docs/example-mapping.html +0 -1170
|
@@ -1,13 +1,7 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
-
};
|
|
5
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
3
|
exports.PropertyAccessAnalyzer = void 0;
|
|
7
|
-
const
|
|
8
|
-
/**
|
|
9
|
-
* Analyzes property accesses in TypeScript expressions
|
|
10
|
-
*/
|
|
4
|
+
const ts_morph_1 = require("ts-morph");
|
|
11
5
|
class PropertyAccessAnalyzer {
|
|
12
6
|
constructor(parameterNames, decoratorNodes) {
|
|
13
7
|
this.sourceFields = new Set();
|
|
@@ -19,7 +13,6 @@ class PropertyAccessAnalyzer {
|
|
|
19
13
|
}
|
|
20
14
|
findPropertyAccesses(node) {
|
|
21
15
|
this.visit(node);
|
|
22
|
-
// Only add property paths that are not partial paths
|
|
23
16
|
this.allPropertyPaths.forEach(path => {
|
|
24
17
|
if (!this.partialPropertyPaths.has(path)) {
|
|
25
18
|
this.sourceFields.add(path);
|
|
@@ -28,7 +21,6 @@ class PropertyAccessAnalyzer {
|
|
|
28
21
|
return Array.from(this.sourceFields);
|
|
29
22
|
}
|
|
30
23
|
visit(node) {
|
|
31
|
-
// Avoid duplicate processing
|
|
32
24
|
if (this.visitedNodes.has(node)) {
|
|
33
25
|
return;
|
|
34
26
|
}
|
|
@@ -36,87 +28,99 @@ class PropertyAccessAnalyzer {
|
|
|
36
28
|
if (this.isPartOfDecorator(node)) {
|
|
37
29
|
return;
|
|
38
30
|
}
|
|
39
|
-
|
|
40
|
-
|
|
31
|
+
const kind = node.getKind();
|
|
32
|
+
switch (kind) {
|
|
33
|
+
case ts_morph_1.SyntaxKind.PropertyAccessExpression:
|
|
34
|
+
this.processPropertyAccessExpression(node);
|
|
35
|
+
break;
|
|
36
|
+
case ts_morph_1.SyntaxKind.ElementAccessExpression:
|
|
37
|
+
if (this.isRelevantElementAccessExpression(node)) {
|
|
38
|
+
this.processElementAccessExpression(node);
|
|
39
|
+
}
|
|
40
|
+
break;
|
|
41
41
|
}
|
|
42
|
-
|
|
43
|
-
this.processElementAccessExpression(node);
|
|
44
|
-
}
|
|
45
|
-
typescript_1.default.forEachChild(node, child => this.visit(child));
|
|
42
|
+
node.getChildren().forEach(child => this.visit(child));
|
|
46
43
|
}
|
|
47
44
|
isPartOfDecorator(node) {
|
|
48
|
-
return this.decoratorNodes.has(node)
|
|
45
|
+
return this.decoratorNodes.has(node) ||
|
|
46
|
+
node.getAncestors().some(ancestor => this.decoratorNodes.has(ancestor));
|
|
49
47
|
}
|
|
50
48
|
isRelevantElementAccessExpression(node) {
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
49
|
+
if (node.getKind() !== ts_morph_1.SyntaxKind.ElementAccessExpression)
|
|
50
|
+
return false;
|
|
51
|
+
const elemAccess = node.asKindOrThrow(ts_morph_1.SyntaxKind.ElementAccessExpression);
|
|
52
|
+
return elemAccess.getExpression().getKind() === ts_morph_1.SyntaxKind.PropertyAccessExpression;
|
|
54
53
|
}
|
|
55
54
|
processPropertyAccessExpression(node) {
|
|
56
|
-
|
|
55
|
+
const propAccess = node.asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAccessExpression);
|
|
56
|
+
let current = propAccess;
|
|
57
57
|
let isFromParam = false;
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
this.partialPropertyPaths.add(current.expression.getText());
|
|
62
|
-
current = current.expression;
|
|
58
|
+
while (current.getExpression().getKind() === ts_morph_1.SyntaxKind.PropertyAccessExpression) {
|
|
59
|
+
this.partialPropertyPaths.add(current.getExpression().getText());
|
|
60
|
+
current = current.getExpression().asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAccessExpression);
|
|
63
61
|
}
|
|
64
|
-
|
|
65
|
-
if (
|
|
66
|
-
this.parameterNames.has(
|
|
62
|
+
const baseExpr = current.getExpression();
|
|
63
|
+
if (baseExpr.getKind() === ts_morph_1.SyntaxKind.Identifier &&
|
|
64
|
+
this.parameterNames.has(baseExpr.getText())) {
|
|
67
65
|
isFromParam = true;
|
|
68
66
|
}
|
|
69
|
-
// If this is a property access based on a method parameter, add it
|
|
70
67
|
if (isFromParam) {
|
|
71
68
|
this.allPropertyPaths.add(node.getText());
|
|
72
69
|
}
|
|
73
70
|
}
|
|
74
71
|
processElementAccessExpression(node) {
|
|
75
|
-
|
|
72
|
+
const elemAccess = node.asKindOrThrow(ts_morph_1.SyntaxKind.ElementAccessExpression);
|
|
73
|
+
let current = elemAccess.getExpression().asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAccessExpression);
|
|
76
74
|
let isFromParam = false;
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
current = current.expression;
|
|
75
|
+
while (current.getExpression().getKind() === ts_morph_1.SyntaxKind.PropertyAccessExpression) {
|
|
76
|
+
this.partialPropertyPaths.add(current.getExpression().getText());
|
|
77
|
+
current = current.getExpression().asKindOrThrow(ts_morph_1.SyntaxKind.PropertyAccessExpression);
|
|
81
78
|
}
|
|
82
|
-
|
|
83
|
-
if (
|
|
84
|
-
this.parameterNames.has(
|
|
79
|
+
const baseExpr = current.getExpression();
|
|
80
|
+
if (baseExpr.getKind() === ts_morph_1.SyntaxKind.Identifier &&
|
|
81
|
+
this.parameterNames.has(baseExpr.getText())) {
|
|
85
82
|
isFromParam = true;
|
|
86
83
|
}
|
|
87
|
-
// If this is an element access based on a method parameter
|
|
88
84
|
if (isFromParam) {
|
|
89
|
-
this.processArgumentExpression(
|
|
85
|
+
this.processArgumentExpression(elemAccess);
|
|
90
86
|
}
|
|
91
87
|
}
|
|
92
88
|
processArgumentExpression(node) {
|
|
93
|
-
|
|
94
|
-
|
|
89
|
+
const elemAccess = node.asKindOrThrow(ts_morph_1.SyntaxKind.ElementAccessExpression);
|
|
90
|
+
const argExpr = elemAccess.getArgumentExpression();
|
|
91
|
+
if (!argExpr)
|
|
92
|
+
return;
|
|
93
|
+
const argKind = argExpr.getKind();
|
|
94
|
+
if (argKind === ts_morph_1.SyntaxKind.StringLiteral) {
|
|
95
|
+
this.processStringLiteralArgument(elemAccess);
|
|
95
96
|
}
|
|
96
|
-
else if (this.isConcatenationExpression(
|
|
97
|
-
this.processConcatenationArgument(
|
|
97
|
+
else if (this.isConcatenationExpression(argExpr)) {
|
|
98
|
+
this.processConcatenationArgument(elemAccess);
|
|
98
99
|
}
|
|
99
100
|
else {
|
|
100
|
-
this.allPropertyPaths.add(
|
|
101
|
+
this.allPropertyPaths.add(elemAccess.getText());
|
|
101
102
|
}
|
|
102
|
-
|
|
103
|
-
this.partialPropertyPaths.add(node.expression.getText());
|
|
103
|
+
this.partialPropertyPaths.add(elemAccess.getExpression().getText());
|
|
104
104
|
}
|
|
105
105
|
isConcatenationExpression(expr) {
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
106
|
+
if (expr.getKind() !== ts_morph_1.SyntaxKind.BinaryExpression)
|
|
107
|
+
return false;
|
|
108
|
+
const binaryExpr = expr.asKindOrThrow(ts_morph_1.SyntaxKind.BinaryExpression);
|
|
109
|
+
return binaryExpr.getOperatorToken().getKind() === ts_morph_1.SyntaxKind.PlusToken &&
|
|
110
|
+
binaryExpr.getLeft().getKind() === ts_morph_1.SyntaxKind.PropertyAccessExpression &&
|
|
111
|
+
binaryExpr.getRight().getKind() === ts_morph_1.SyntaxKind.StringLiteral;
|
|
110
112
|
}
|
|
111
|
-
processStringLiteralArgument(
|
|
112
|
-
const
|
|
113
|
-
|
|
113
|
+
processStringLiteralArgument(elemAccess) {
|
|
114
|
+
const elemAccessExpr = elemAccess.asKindOrThrow(ts_morph_1.SyntaxKind.ElementAccessExpression);
|
|
115
|
+
const stringLiteral = elemAccessExpr.getArgumentExpression().asKindOrThrow(ts_morph_1.SyntaxKind.StringLiteral);
|
|
116
|
+
this.allPropertyPaths.add(`${elemAccessExpr.getExpression().getText()}['${stringLiteral.getLiteralValue()}']`);
|
|
114
117
|
}
|
|
115
|
-
processConcatenationArgument(
|
|
116
|
-
const
|
|
117
|
-
const
|
|
118
|
-
const
|
|
119
|
-
|
|
118
|
+
processConcatenationArgument(elemAccess) {
|
|
119
|
+
const elemAccessExpr = elemAccess.asKindOrThrow(ts_morph_1.SyntaxKind.ElementAccessExpression);
|
|
120
|
+
const binaryExpr = elemAccessExpr.getArgumentExpression().asKindOrThrow(ts_morph_1.SyntaxKind.BinaryExpression);
|
|
121
|
+
const prefix = binaryExpr.getLeft().getText();
|
|
122
|
+
const suffix = binaryExpr.getRight().asKindOrThrow(ts_morph_1.SyntaxKind.StringLiteral).getLiteralValue();
|
|
123
|
+
this.allPropertyPaths.add(`${elemAccessExpr.getExpression().getText()}[${prefix} + '${suffix}']`);
|
|
120
124
|
}
|
|
121
125
|
}
|
|
122
126
|
exports.PropertyAccessAnalyzer = PropertyAccessAnalyzer;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"property-access-analyzer.js","sourceRoot":"","sources":["../../src/analyzers/property-access-analyzer.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"property-access-analyzer.js","sourceRoot":"","sources":["../../src/analyzers/property-access-analyzer.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.GenerateArrayListDocumentation = GenerateArrayListDocumentation;
|
|
4
|
+
function GenerateArrayListDocumentation(options) {
|
|
5
|
+
return function (target, propertyKey, descriptor) {
|
|
6
|
+
return descriptor;
|
|
7
|
+
};
|
|
8
|
+
}
|
|
9
|
+
//# sourceMappingURL=array-documentation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"array-documentation.js","sourceRoot":"","sources":["../../src/decorators/array-documentation.ts"],"names":[],"mappings":";;AAEA,wEAQC;AARD,SAAgB,8BAA8B,CAAC,OAAsC;IACjF,OAAO,UACH,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mapping-documentation.js","sourceRoot":"","sources":["../../src/decorators/mapping-documentation.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"mapping-documentation.js","sourceRoot":"","sources":["../../src/decorators/mapping-documentation.ts"],"names":[],"mappings":";;AAEA,oEAQC;AARD,SAAgB,4BAA4B,CAAC,OAAoC;IAC7E,OAAO,UACH,MAAW,EACX,WAAmB,EACnB,UAA8B;QAE9B,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;AACN,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function generateArrayDocumentation(destinationPath: string): void;
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
3
|
+
if (k2 === undefined) k2 = k;
|
|
4
|
+
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
5
|
+
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
6
|
+
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
7
|
+
}
|
|
8
|
+
Object.defineProperty(o, k2, desc);
|
|
9
|
+
}) : (function(o, m, k, k2) {
|
|
10
|
+
if (k2 === undefined) k2 = k;
|
|
11
|
+
o[k2] = m[k];
|
|
12
|
+
}));
|
|
13
|
+
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
14
|
+
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
15
|
+
}) : function(o, v) {
|
|
16
|
+
o["default"] = v;
|
|
17
|
+
});
|
|
18
|
+
var __importStar = (this && this.__importStar) || (function () {
|
|
19
|
+
var ownKeys = function(o) {
|
|
20
|
+
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
21
|
+
var ar = [];
|
|
22
|
+
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
23
|
+
return ar;
|
|
24
|
+
};
|
|
25
|
+
return ownKeys(o);
|
|
26
|
+
};
|
|
27
|
+
return function (mod) {
|
|
28
|
+
if (mod && mod.__esModule) return mod;
|
|
29
|
+
var result = {};
|
|
30
|
+
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
31
|
+
__setModuleDefault(result, mod);
|
|
32
|
+
return result;
|
|
33
|
+
};
|
|
34
|
+
})();
|
|
35
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
|
+
exports.generateArrayDocumentation = generateArrayDocumentation;
|
|
37
|
+
const path = __importStar(require("path"));
|
|
38
|
+
const fs = __importStar(require("node:fs"));
|
|
39
|
+
const process = __importStar(require("node:process"));
|
|
40
|
+
const array_scanner_1 = require("../utils/array-scanner");
|
|
41
|
+
const mapping_scanner_1 = require("../utils/mapping-scanner");
|
|
42
|
+
const doc_generator_html_1 = require("./doc-generator-html");
|
|
43
|
+
const doc_output_registry_1 = require("./doc-output-registry");
|
|
44
|
+
function normalize(p) {
|
|
45
|
+
return path.resolve(process.cwd(), p);
|
|
46
|
+
}
|
|
47
|
+
function resolveDestinationPath(destPath, baseDir) {
|
|
48
|
+
return path.resolve(baseDir, destPath);
|
|
49
|
+
}
|
|
50
|
+
function generateArrayDocumentation(destinationPath) {
|
|
51
|
+
const projectRoot = process.cwd();
|
|
52
|
+
const { arraysMain, mappingsMain, baseDir, shared } = setupDocumentationPaths(destinationPath);
|
|
53
|
+
const arrayMethods = (0, array_scanner_1.scanProjectForArrayMethods)(projectRoot);
|
|
54
|
+
const arraysByPath = groupArrayMethodsByPath(arrayMethods, arraysMain, baseDir);
|
|
55
|
+
if (shared) {
|
|
56
|
+
const mappingMethods = (0, mapping_scanner_1.scanProjectForMappingMethods)(projectRoot);
|
|
57
|
+
const mappingsByPath = groupMappingMethodsByPath(mappingMethods, mappingsMain, baseDir);
|
|
58
|
+
generateSharedDocumentation(arraysByPath, mappingsByPath, baseDir);
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
generateSeparateDocumentation(arraysByPath);
|
|
62
|
+
}
|
|
63
|
+
console.log(`Found ${arrayMethods.length} array methods in the project.`);
|
|
64
|
+
}
|
|
65
|
+
function setupDocumentationPaths(destinationPath) {
|
|
66
|
+
const normalizedBase = normalize(destinationPath);
|
|
67
|
+
(0, doc_output_registry_1.setArrayBasePath)(normalizedBase);
|
|
68
|
+
const mappingBase = (0, doc_output_registry_1.getMappingBasePath)();
|
|
69
|
+
// Check if both array and mapping documentation should be generated to the same file
|
|
70
|
+
const shared = mappingBase !== null && mappingBase !== undefined && mappingBase === normalizedBase;
|
|
71
|
+
const baseDir = path.dirname(normalizedBase);
|
|
72
|
+
const sharedPath = normalizedBase;
|
|
73
|
+
const arraysMain = shared ? sharedPath : path.join(baseDir, 'arrays.html');
|
|
74
|
+
const mappingsMain = shared ? sharedPath : path.join(baseDir, 'mappings.html');
|
|
75
|
+
return { arraysMain, mappingsMain, baseDir, shared };
|
|
76
|
+
}
|
|
77
|
+
function groupArrayMethodsByPath(arrayMethods, arraysMain, baseDir) {
|
|
78
|
+
const arraysByPath = new Map();
|
|
79
|
+
arraysByPath.set(arraysMain, []);
|
|
80
|
+
for (const arrayMethod of arrayMethods) {
|
|
81
|
+
const dest = arrayMethod.options.destinationPath;
|
|
82
|
+
if (dest) {
|
|
83
|
+
const absolutePath = resolveDestinationPath(dest, baseDir);
|
|
84
|
+
// Prevent duplicate entries when destination equals main file
|
|
85
|
+
const targetPath = absolutePath === arraysMain ? arraysMain : absolutePath;
|
|
86
|
+
if (!arraysByPath.has(targetPath))
|
|
87
|
+
arraysByPath.set(targetPath, []);
|
|
88
|
+
arraysByPath.get(targetPath).push(arrayMethod);
|
|
89
|
+
}
|
|
90
|
+
else {
|
|
91
|
+
// Methods without specific destination go to main file
|
|
92
|
+
arraysByPath.get(arraysMain).push(arrayMethod);
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
return arraysByPath;
|
|
96
|
+
}
|
|
97
|
+
function groupMappingMethodsByPath(mappingMethods, mappingsMain, baseDir) {
|
|
98
|
+
const mappingsByPath = new Map();
|
|
99
|
+
mappingsByPath.set(mappingsMain, []);
|
|
100
|
+
for (const m of mappingMethods) {
|
|
101
|
+
const dest = m.options.destinationPath;
|
|
102
|
+
if (dest) {
|
|
103
|
+
const absolutePath = resolveDestinationPath(dest, baseDir);
|
|
104
|
+
const targetPath = absolutePath === mappingsMain ? mappingsMain : absolutePath;
|
|
105
|
+
if (!mappingsByPath.has(targetPath))
|
|
106
|
+
mappingsByPath.set(targetPath, []);
|
|
107
|
+
mappingsByPath.get(targetPath).push(m);
|
|
108
|
+
}
|
|
109
|
+
else {
|
|
110
|
+
mappingsByPath.get(mappingsMain).push(m);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
return mappingsByPath;
|
|
114
|
+
}
|
|
115
|
+
function generateSharedDocumentation(arraysByPath, mappingsByPath, baseDir) {
|
|
116
|
+
var _a, _b;
|
|
117
|
+
const allPaths = new Set([
|
|
118
|
+
...arraysByPath.keys(),
|
|
119
|
+
...mappingsByPath.keys(),
|
|
120
|
+
]);
|
|
121
|
+
for (const docPath of allPaths) {
|
|
122
|
+
const as = (_a = arraysByPath.get(docPath)) !== null && _a !== void 0 ? _a : [];
|
|
123
|
+
const ms = (_b = mappingsByPath.get(docPath)) !== null && _b !== void 0 ? _b : [];
|
|
124
|
+
if (as.length === 0 && ms.length === 0)
|
|
125
|
+
continue;
|
|
126
|
+
(0, doc_generator_html_1.generateMappingDocumentationHTML)(docPath, ms, as);
|
|
127
|
+
}
|
|
128
|
+
// Clean up separate files when using shared documentation
|
|
129
|
+
const arraysFile = path.join(baseDir, 'arrays.html');
|
|
130
|
+
const mappingsFile = path.join(baseDir, 'mappings.html');
|
|
131
|
+
if (fs.existsSync(arraysFile))
|
|
132
|
+
fs.unlinkSync(arraysFile);
|
|
133
|
+
if (fs.existsSync(mappingsFile))
|
|
134
|
+
fs.unlinkSync(mappingsFile);
|
|
135
|
+
}
|
|
136
|
+
function generateSeparateDocumentation(arraysByPath) {
|
|
137
|
+
arraysByPath.forEach((methods, docPath) => {
|
|
138
|
+
if (methods.length === 0)
|
|
139
|
+
return;
|
|
140
|
+
(0, doc_generator_html_1.generateMappingDocumentationHTML)(docPath, [], methods);
|
|
141
|
+
});
|
|
142
|
+
}
|
|
143
|
+
//# sourceMappingURL=array-list-generator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"array-list-generator.js","sourceRoot":"","sources":["../../src/generators/array-list-generator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function generateMappingDocumentationHTML(outputPath: string, mappingMethods?: any[], arrayMethods?: any[]): void;
|