devextreme-internal-tools 19.2.15 → 20.0.0

package/ts/discoverer/parsing.d.ts

@@ -0,0 +1,26 @@
+import { ID } from '../common/id';
+import type { CompilerOptions } from 'typescript';
+import type { EnumLikeType, GenericParamDeclaration, TypeDeclaration } from './data-model';
+import type { GeneralType } from './types';
+import type { DocTag } from '../common/tags/types';
+export type { CompilerOptions } from 'typescript';
+export type Descriptor = OptionDescriptor | WidgetDescriptor;
+interface OptionDescriptor extends DescriptorBase {
+    kind: 'option';
+    optional: boolean;
+    type?: GeneralType;
+}
+export interface WidgetDescriptor extends DescriptorBase {
+    kind: 'widget';
+    optionsType: string;
+}
+interface DescriptorBase {
+    [ID]: string;
+    exported: boolean;
+    tags: DocTag[];
+    location?: {
+        file: string;
+    };
+    typeParameters?: Record<string, GenericParamDeclaration>;
+}
+export declare function parseFiles(files: string[], baseDir: string, compilerOptions: CompilerOptions | undefined): [Descriptor[], Record<string, TypeDeclaration | EnumLikeType>];

package/ts/discoverer/parsing.js

@@ -0,0 +1,338 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFiles = parseFiles;
+const node_path_1 = require("node:path");
+const typescript_1 = require("typescript");
+const discovering_error_1 = require("./discovering-error");
+const common_resolving_1 = require("../common/common-resolving");
+const id_1 = require("../common/id");
+const tags_1 = require("../common/tags");
+const enum_collecting_1 = require("./parsing/enum-collecting");
+const file_reader_1 = require("./parsing/file-reader");
+const widget_parsing_1 = require("./parsing/widget-parsing");
+const merging_1 = require("../common/tags/merging");
+const ts_type_resolving_1 = require("../common/ts-type-resolving");
+const ts_utils_1 = require("../common/ts-utils");
+const utils_1 = require("../common/utils");
+const logging_1 = require("../logging");
+function parseFiles(files, baseDir, compilerOptions) {
+    const program = (0, typescript_1.createProgram)(files, compilerOptions !== null && compilerOptions !== void 0 ? compilerOptions : {});
+    const descriptors = [];
+    const tsTypes = {};
+    const checker = program.getTypeChecker();
+    const processTypes = (0, ts_type_resolving_1.createTypeProcessor)(checker, baseDir);
+    const { addEnum, toRecord } = (0, enum_collecting_1.createEnumsCollector)(baseDir);
+    files.forEach((filePath) => {
+        processFile(filePath);
+    });
+    function addDescriptor(descriptor, file) {
+        if (descriptor === undefined)
+            return;
+        descriptors.push({
+            ...descriptor,
+            location: descriptor.location || { file },
+        });
+    }
+    function processFile(filePath) {
+        const sourceFile = program.getSourceFile(filePath);
+        if (sourceFile.text.length === 0)
+            throw new Error(`Empty file: ${filePath}`);
+        const file = (0, utils_1.toInvariantPath)((0, node_path_1.relative)(baseDir, filePath));
+        const addFileDescriptor = (d) => addDescriptor(d, file);
+        for (const member of (0, file_reader_1.getDiscoverableSymbols)(sourceFile, checker)) {
+            proccessMemberDescriptors(member, sourceFile.fileName, checker, baseDir, addFileDescriptor);
+            if (!file.includes('renovation')) {
+                addEnum(member);
+            }
+            if ((0, common_resolving_1.hasTag)(member, 'docid') || (0, ts_type_resolving_1.isPublicType)(member)) {
+                processTypes(member, tsTypes);
+            }
+        }
+    }
+    return [descriptors, { ...tsTypes, ...toRecord() }];
+}
+function proccessMemberDescriptors(member, fileName, checker, baseDir, addDescriptor) {
+    const [moduleName, exportName] = getModuleAndExport(member, baseDir);
+    const moduleAndExportTags = [
+        { name: 'module', value: moduleName },
+        { name: 'export', value: exportName },
+    ];
+    const reportDuplicateTag = (message, lvl = 'warn') => {
+        (0, logging_1.log)(message, { lvl, node: member.declarations[0] });
+    };
+    const exportedDescriptors = getExportedDescriptors(member, fileName, checker, baseDir).filter((d) => !!(d === null || d === void 0 ? void 0 : d.tags.length));
+    exportedDescriptors.forEach((d) => {
+        const descriptor = { ...d };
+        if (descriptor.exported) {
+            descriptor.tags = (0, merging_1.mergeTags)(descriptor.tags, moduleAndExportTags, reportDuplicateTag);
+        }
+        addDescriptor(descriptor);
+    });
+    if (hasMultipleDeclarations(member))
+        return;
+    const descriptor = getDescriptorFromSymbol(member, checker, baseDir);
+    if (descriptor === null || descriptor === void 0 ? void 0 : descriptor.tags.length) {
+        descriptor.tags = (0, merging_1.mergeTags)(descriptor.tags, moduleAndExportTags, reportDuplicateTag);
+        addDescriptor(descriptor);
+    }
+}
+function getExportedDescriptors(member, fileName, checker, baseDir) {
+    const declarations = member.declarations.filter((d) => d.getSourceFile().fileName === fileName);
+    if (declarations.length > 1) {
+        return declarations
+            .map((d) => (0, typescript_1.isFunctionDeclaration)(d)
+            ? getMemberFromFunctionDeclaration(d, checker, baseDir)
+            : undefined)
+            .filter((d) => d);
+    }
+    const declaration = member.declarations[0];
+    if ((0, typescript_1.isExportSpecifier)(declaration))
+        return [getMemberFromExportSpecifier(declaration, baseDir)];
+    if ((0, typescript_1.isExportAssignment)(declaration)) {
+        return getMembersFromExportAssignment(checker, declaration, baseDir);
+    }
+    if ((0, typescript_1.isTypeAliasDeclaration)(declaration)) {
+        return getMembersFromTypeAliasDeclaration(declaration, checker, baseDir);
+    }
+    return getMembersFromDeclaration(declaration, checker, baseDir);
+}
+function getDescriptorFromSymbol(symbol, checker, baseDir) {
+    if (hasMultipleDeclarations(symbol))
+        return undefined;
+    const declaration = symbol.declarations[0];
+    const tags = (0, tags_1.getSymbolTags)(checker, symbol, baseDir);
+    if (!(tags === null || tags === void 0 ? void 0 : tags.length))
+        return undefined;
+    const id = (0, id_1.getIdFromSymbol)(symbol, baseDir);
+    const { isWidget, optionsType, tags: widgetTags, } = (0, widget_parsing_1.parseWidgetExtras)(declaration, tags, checker, baseDir);
+    if (!id) {
+        throw new Error(`Unable to build ID for ${JSON.stringify(tags)}`);
+    }
+    const typeParameters = getTypeParameters(checker, symbol, baseDir);
+    if (isWidget) {
+        return {
+            [id_1.ID]: id,
+            kind: 'widget',
+            exported: true,
+            tags: widgetTags,
+            typeParameters,
+            optionsType,
+        };
+    }
+    return {
+        [id_1.ID]: id,
+        kind: 'option',
+        exported: true,
+        tags,
+        typeParameters,
+        optional: false,
+    };
+}
+function getMembersFromDeclaration(declaration, checker, baseDir) {
+    if ((0, typescript_1.isFunctionDeclaration)(declaration)) {
+        return [getMemberFromFunctionDeclaration(declaration, checker, baseDir)];
+    }
+    if ((0, typescript_1.isVariableDeclaration)(declaration) ||
+        (0, typescript_1.isTypeLiteralNode)(declaration) ||
+        (0, typescript_1.isClassDeclaration)(declaration) ||
+        (0, typescript_1.isInterfaceDeclaration)(declaration)) {
+        return (0, ts_utils_1.getNestedSymbols)(checker.getTypeAtLocation(declaration))
+            .map((s) => {
+            const members = getMembersFromSymbol(s, checker, baseDir);
+            return members.map((m) => ({ ...m, exported: false }));
+        })
+            .flat();
+    }
+    return [];
+}
+function getMemberFromFunctionDeclaration(declaration, checker, baseDir) {
+    return {
+        [id_1.ID]: (0, id_1.getIdFromNode)(declaration, baseDir),
+        kind: 'option',
+        exported: true,
+        tags: (0, tags_1.getSignatureDeclarationTags)(checker, declaration, baseDir),
+        optional: false,
+    };
+}
+function getMembersFromTypeAliasDeclaration(declaration, checker, targetDir) {
+    return getMembersFromPropType(checker.getTypeAtLocation(declaration.type), checker, declaration.getSourceFile().fileName, targetDir);
+}
+function getMembersFromSymbol(symbol, checker, baseDir) {
+    if (!symbol.declarations) {
+        return [];
+    }
+    const propDeclarations = [];
+    const result = [];
+    const id = (0, id_1.getIdFromSymbol)(symbol, baseDir);
+    for (const declaration of symbol.declarations) {
+        if (!registerDeclaration(declaration)) {
+            continue;
+        }
+        if ((0, typescript_1.isMethodDeclaration)(declaration) || (0, typescript_1.isMethodSignature)(declaration)) {
+            result.push({
+                [id_1.ID]: (0, id_1.getIdFromNode)(declaration, baseDir),
+                kind: 'option',
+                exported: true,
+                tags: (0, tags_1.getSignatureDeclarationTags)(checker, declaration, baseDir),
+                optional: (0, ts_utils_1.isOptional)(symbol),
+                location: {
+                    file: (0, utils_1.toInvariantPath)((0, node_path_1.relative)(baseDir, declaration.getSourceFile().fileName)),
+                },
+            });
+        }
+        else {
+            const propType = checker.getTypeAtLocation(declaration);
+            if ((0, ts_utils_1.isStructuredType)(propType)) {
+                result.push(...getMembersFromPropType(propType, checker, declaration.getSourceFile().fileName, baseDir));
+            }
+            propDeclarations.push(declaration);
+        }
+    }
+    if (id && propDeclarations.length !== 0) {
+        result.push({
+            [id_1.ID]: id,
+            kind: 'option',
+            exported: true,
+            tags: (0, tags_1.getSymbolTags)(checker, symbol, baseDir),
+            type: extractType(propDeclarations, checker, baseDir),
+            optional: (0, ts_utils_1.isOptional)(symbol),
+            location: {
+                file: (0, utils_1.toInvariantPath)((0, node_path_1.relative)(baseDir, symbol.declarations[0].getSourceFile().fileName)),
+            },
+        });
+    }
+    return result;
+}
+function getMembersFromPropType(type, checker, targetFileName, targetDir) {
+    const symbols = (0, ts_utils_1.getTypeSymbols)(type);
+    const declarations = symbols
+        .map((symbol) => symbol.getDeclarations())
+        .filter(Boolean)
+        .flat()
+        .filter((declaration) => targetFileName === declaration.getSourceFile().fileName);
+    return declarations.flatMap((declaration) => getMembersFromDeclaration(declaration, checker, targetDir));
+}
+function getMemberFromExportSpecifier(exportSpecifier, baseDir) {
+    const adjacentExportSpecifiers = getAdjacentExportSpecifiers(exportSpecifier);
+    const isSingleExport = adjacentExportSpecifiers && adjacentExportSpecifiers.length === 1;
+    if (!isSingleExport)
+        return undefined;
+    const declaration = exportSpecifier.parent.parent;
+    const tags = (0, typescript_1.getJSDocTags)(declaration);
+    if (!(tags === null || tags === void 0 ? void 0 : tags.length))
+        return undefined;
+    return {
+        [id_1.ID]: (0, id_1.getIdFromNode)(exportSpecifier, baseDir),
+        kind: 'option',
+        exported: true,
+        tags: tags.map(tags_1.normalizeTag),
+        optional: false,
+    };
+}
+function getAdjacentExportSpecifiers(node) {
+    if (!node.parent)
+        return undefined;
+    const exportsListNodes = node.parent
+        .getChildren()
+        .filter((n) => n.kind === typescript_1.SyntaxKind.SyntaxList);
+    if (exportsListNodes.length !== 1)
+        return undefined;
+    return exportsListNodes[0]
+        .getChildren()
+        .filter((n) => n.kind === typescript_1.SyntaxKind.ExportSpecifier);
+}
+function getMembersFromExportAssignment(checker, declaration, baseDir) {
+    const result = [];
+    if (declaration.expression.kind !== typescript_1.SyntaxKind.Identifier)
+        return result;
+    const declarationSymbol = checker.getSymbolAtLocation(declaration.expression);
+    const declarationId = (0, id_1.getIdFromSymbol)(declarationSymbol, baseDir);
+    if (declarationId &&
+        declarationSymbol &&
+        !hasMultipleDeclarations(declarationSymbol)) {
+        result.push({
+            [id_1.ID]: declarationId,
+            kind: 'option',
+            exported: true,
+            tags: (0, tags_1.getSymbolTags)(checker, declarationSymbol, baseDir),
+            optional: false,
+        });
+    }
+    const type = checker.getTypeAtLocation(declaration.expression);
+    result.push(...getMembersFromPropType(type, checker, declaration.getSourceFile().fileName, baseDir));
+    return result;
+}
+function hasMultipleDeclarations(symbol) {
+    var _a;
+    return ((_a = symbol.getDeclarations()) === null || _a === void 0 ? void 0 : _a.length) > 1;
+}
+const visitedDeclarations = new Set();
+function registerDeclaration(d) {
+    const name = `${d.getSourceFile().fileName}|${d.getStart().toString()}`;
+    if ((0, ts_type_resolving_1.isExternalDeclaration)(d) || visitedDeclarations.has(name)) {
+        return false;
+    }
+    visitedDeclarations.add(name);
+    return true;
+}
+function getModuleAndExport(symbol, baseDir) {
+    const moduleName = (0, ts_utils_1.getModule)(symbol.declarations[0], baseDir);
+    const exportName = symbol.escapedName.toString();
+    return [moduleName, exportName];
+}
+function getTypeParameters(checker, member, baseDir) {
+    const typeParams = getGenericParameters(member);
+    if (!typeParams.length)
+        return undefined;
+    return Object.fromEntries(typeParams.map((p) => [
+        p.name.escapedText.toString(),
+        getGenericParamDeclaration(p, checker, baseDir),
+    ]));
+}
+function extractType(declarations, checker, targetDir) {
+    const symbol = extractTypeSymbol(declarations, checker, targetDir);
+    const targetFlags = typescript_1.SymbolFlags.Interface |
+        typescript_1.SymbolFlags.TypeAlias |
+        typescript_1.SymbolFlags.Class |
+        typescript_1.SymbolFlags.Enum;
+    if ((symbol === null || symbol === void 0 ? void 0 : symbol.flags) & targetFlags) {
+        const file = (0, utils_1.toInvariantPath)((0, node_path_1.relative)(targetDir, symbol.declarations[0].getSourceFile().fileName));
+        return {
+            cat: 'custom',
+            name: symbol.name,
+            file,
+        };
+    }
+    return undefined;
+}
+function extractTypeSymbol(nodes, checker, targetDir) {
+    const symbol = (0, ts_utils_1.getTypeSymbol)(checker.getTypeAtLocation(nodes[0]));
+    if (!symbol)
+        return undefined;
+    if (symbol.flags & typescript_1.SymbolFlags.TypeLiteral)
+        return undefined;
+    if (!symbol.declarations)
+        throw new discovering_error_1.DiscoveringError('Unable to find type declaration', nodes);
+    const file = (0, node_path_1.relative)(targetDir, symbol.declarations[0].getSourceFile().fileName);
+    if (/node_modules\\typescript\\.*\\lib\..*\.d\.ts/.test(file) ||
+        /node_modules\/typescript\/.*\/lib\..*\.d\.ts/.test(file))
+        return undefined;
+    return symbol;
+}
+function getGenericParamDeclaration(genericParam, checker, baseDir) {
+    return {
+        defaultValue: genericParam.default
+            ? (0, ts_type_resolving_1.resolveType)(genericParam.default, checker, baseDir)
+            : undefined,
+    };
+}
+function getGenericParameters(member) {
+    const declaration = member.declarations[0];
+    if (((0, typescript_1.isTypeAliasDeclaration)(declaration) ||
+        (0, typescript_1.isInterfaceDeclaration)(declaration)) &&
+        declaration.typeParameters) {
+        return [...declaration.typeParameters];
+    }
+    return [];
+}
+//# sourceMappingURL=parsing.js.map

package/ts/discoverer/parsing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../../ts/discoverer/parsing.ts"],"names":[],"mappings":"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"}

package/ts/discoverer/types.d.ts

@@ -0,0 +1,20 @@
+interface Standard {
+    name: 'string' | 'number' | 'any' | 'Array' | 'Record';
+}
+interface Custom {
+    name: string;
+    file: string;
+}
+interface Generic {
+    params: GeneralType[];
+}
+export type GeneralType = ({
+    cat: 'standard';
+} & Standard) | ({
+    cat: 'standard-generic';
+} & Standard & Generic) | ({
+    cat: 'custom';
+} & Custom) | ({
+    cat: 'custom-generic';
+} & Custom & Generic);
+export {};

package/ts/discoverer/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/ts/discoverer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../ts/discoverer/types.ts"],"names":[],"mappings":""}

package/ts/logging.d.ts

@@ -0,0 +1,16 @@
+import type { Node } from 'typescript';
+export type Level = keyof typeof levels;
+declare const levels: {
+    readonly trace: 5;
+    readonly debug: 4;
+    readonly info: 3;
+    readonly warn: 2;
+    readonly error: 1;
+    readonly fatal: 0;
+};
+declare const log: (msg: unknown, options?: {
+    lvl?: Level;
+    node?: Node;
+    e?: unknown;
+}) => void, logStart: () => () => void, setLogDir: (dir: string) => void, setAreaName: (areaName: string) => void;
+export { log, logStart, setAreaName, setLogDir };

package/ts/logging.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLogDir = exports.setAreaName = exports.logStart = exports.log = void 0;
+const node_path_1 = require("node:path");
+const node_perf_hooks_1 = require("node:perf_hooks");
+const winston_1 = require("winston");
+const levels = {
+    trace: 5,
+    debug: 4,
+    info: 3,
+    warn: 2,
+    error: 1,
+    fatal: 0,
+};
+const colors = {
+    trace: 'white',
+    debug: 'white',
+    info: 'white',
+    warn: 'yellow',
+    error: 'red',
+    fatal: 'white redBG',
+};
+function init() {
+    let errorCount = 0;
+    let warnCount = 0;
+    let areaName = '';
+    let fileName = '';
+    const startTime = node_perf_hooks_1.performance.now();
+    const separation = '================================================================';
+    const logger = (0, winston_1.createLogger)({
+        levels,
+        format: winston_1.format.combine(winston_1.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss.SSSS' }), winston_1.format.printf((info) => `${info.timestamp} | ${info.level[0].toUpperCase() + info.level.slice(1)} | ${areaName}\n${info.message}`)),
+        transports: [
+            new winston_1.transports.Console({
+                level: 'info',
+                format: winston_1.format.colorize({ all: true, colors }),
+            }),
+        ],
+    });
+    return {
+        log(message, { lvl = 'info', node, e } = {}) {
+            if (lvl === 'warn') {
+                warnCount += 1;
+            }
+            if (lvl === 'error' || lvl === 'fatal') {
+                errorCount += 1;
+            }
+            const paragraphs = [
+                typeof message === 'string' ? message : JSON.stringify(message),
+            ];
+            if (node)
+                paragraphs.push(stringifyNode(node));
+            if (e)
+                paragraphs.push(stringifyException(e));
+            logger.log(lvl, paragraphs.join('\n\n'));
+        },
+        setLogDir(dir) {
+            fileName = (0, node_path_1.resolve)(dir, 'internal-tools-log.txt');
+            logger.info(`Path to log file: ${fileName}`);
+            logger.add(new winston_1.transports.File({
+                filename: fileName,
+                level: 'trace',
+            }));
+        },
+        setAreaName(name) {
+            areaName = name;
+        },
+        logStart() {
+            const message = '\n' + `${separation}\n` + `${areaName} Started\n` + `${separation}\n`;
+            logger.log('trace', message);
+            return () => {
+                const elapsed = node_perf_hooks_1.performance.now() - startTime;
+                const seconds = Math.floor(elapsed / 1000);
+                const milis = Math.round(elapsed % 1000);
+                const resultMessage = errorCount > 0 ? 'FAILED' : 'SUCCEEDED';
+                const logLevel = errorCount > 0 ? 'error' : 'info';
+                const startMessage = '\n' +
+                    `${separation}\n` +
+                    `\n${areaName} ${resultMessage}\n` +
+                    `\nWarnings: ${warnCount}\n` +
+                    `Errors: ${errorCount}\n` +
+                    `Elapsed time: ${seconds}.${milis} sec\n` +
+                    '\n';
+                errorCount = 0;
+                warnCount = 0;
+                logger.log(logLevel, startMessage);
+            };
+        },
+    };
+}
+function stringifyNode(node) {
+    const text = `\n${node.getText()}\n\nSyntaxKind: ${node.kind}`;
+    const sourceFile = node.getSourceFile();
+    if (sourceFile) {
+        const pos = sourceFile.getLineAndCharacterOfPosition(node.pos);
+        return `${text}\n${sourceFile.fileName}:${pos.line}:${pos.character}`;
+    }
+    return text;
+}
+function stringifyException(e) {
+    if (e instanceof Error)
+        return e.message;
+    if (typeof e === 'string')
+        return e;
+    return 'Unknown exception';
+}
+const { log, logStart, setLogDir, setAreaName } = init();
+exports.log = log;
+exports.logStart = logStart;
+exports.setLogDir = setLogDir;
+exports.setAreaName = setAreaName;
+//# sourceMappingURL=logging.js.map

package/ts/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../ts/logging.ts"],"names":[],"mappings":"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"}

package/ts/modules-meta-generator/modules-meta-generator.d.ts

@@ -0,0 +1,3 @@
+import type { CompilerOptions } from 'typescript';
+export declare function generateModulesMeta(targetFiles: string[], targetDir: string, output: string, compilerOptions: CompilerOptions | undefined, toolsVersion?: string): void;
+export declare function getModulesData(fileNames: string[], baseDir: string, compilerOptions?: CompilerOptions): Record<string, Record<string, unknown>>;

package/ts/modules-meta-generator/modules-meta-generator.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateModulesMeta = generateModulesMeta;
+exports.getModulesData = getModulesData;
+const node_fs_1 = require("node:fs");
+const typescript_1 = require("typescript");
+const common_resolving_1 = require("../common/common-resolving");
+const ts_utils_1 = require("../common/ts-utils");
+const logging_1 = require("../logging");
+function generateModulesMeta(targetFiles, targetDir, output, compilerOptions, toolsVersion) {
+    (0, logging_1.log)('Discovering modules');
+    const modulesData = getModulesData(targetFiles, targetDir, compilerOptions);
+    const modulesCount = Object.entries(modulesData).length;
+    if (!modulesCount)
+        throw new Error('No modules found');
+    (0, logging_1.log)(`${modulesCount} modules discovered`);
+    const metaData = {
+        ToolsVersion: toolsVersion,
+        Modules: modulesData,
+    };
+    (0, node_fs_1.writeFileSync)(output, JSON.stringify(metaData, null, 2));
+}
+function getModulesData(fileNames, baseDir, compilerOptions) {
+    const program = (0, typescript_1.createProgram)(fileNames, compilerOptions !== null && compilerOptions !== void 0 ? compilerOptions : {});
+    const checker = program.getTypeChecker();
+    return fileNames.reduce((modules, module) => {
+        const sourceFile = program.getSourceFile(module);
+        if (!sourceFile) {
+            return modules;
+        }
+        const moduleName = (0, ts_utils_1.getModule)(sourceFile, baseDir);
+        if (!moduleName) {
+            return modules;
+        }
+        const fileSymbol = checker.getSymbolAtLocation(sourceFile);
+        if (!fileSymbol) {
+            return modules;
+        }
+        const exports = getModuleExports(fileSymbol);
+        if (Object.entries(exports).length) {
+            modules[moduleName] = exports;
+        }
+        return modules;
+    }, {});
+    function getModuleExports(fileSymbol) {
+        return checker.getExportsOfModule(fileSymbol).reduce((exports, symbol) => {
+            if (hasPublicTags(symbol) || hasDeclarationsWithPublicTags(symbol)) {
+                exports[symbol.escapedName.toString()] = {};
+            }
+            return exports;
+        }, {});
+    }
+    function hasDeclarationsWithPublicTags(symbol) {
+        return symbol.declarations.filter(typescript_1.isExportAssignment).some((d) => {
+            const exportedSymbol = checker.getSymbolAtLocation(d.expression);
+            return !!exportedSymbol && hasPublicTags(exportedSymbol);
+        });
+    }
+    function hasPublicTags(symbol) {
+        return (0, common_resolving_1.hasTag)(symbol, 'public') || (0, common_resolving_1.hasTag)(symbol, 'docid');
+    }
+}
+//# sourceMappingURL=modules-meta-generator.js.map

package/ts/modules-meta-generator/modules-meta-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules-meta-generator.js","sourceRoot":"","sources":["../../../ts/modules-meta-generator/modules-meta-generator.ts"],"names":[],"mappings":"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"}

package/ts/program.d.ts

@@ -0,0 +1,3 @@
+import type { UnknownConfig } from './config';
+import type { DataTypes } from './config/metadata';
+export declare function initProgram<T extends DataTypes.Custom, TNodeMetadata>(area: string, config: UnknownConfig<T, TNodeMetadata>): void;

package/ts/program.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initProgram = initProgram;
+const typescript_1 = require("typescript");
+const utils_1 = require("./common/utils");
+const config_1 = require("./config");
+const logging_1 = require("./logging");
+function initProgram(area, config) {
+    (0, utils_1.ensureDir)(config.args.artifacts);
+    (0, logging_1.setLogDir)(config.args.artifacts);
+    (0, logging_1.setAreaName)(area);
+    (0, logging_1.log)(`Tools version: ${config_1.TOOLS_VERSION}\nTS version: ${typescript_1.version}`);
+    (0, logging_1.log)(`Args: ${JSON.stringify(config.args)}`, { lvl: 'debug' });
+}
+//# sourceMappingURL=program.js.map

package/ts/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../ts/program.ts"],"names":[],"mappings":";;AASA,kCASC;AAlBD,2CAAkD;AAElD,0CAA2C;AAC3C,qCAAyC;AACzC,uCAAwD;AAKxD,SAAgB,WAAW,CACzB,IAAY,EACZ,MAAuC;IAEvC,IAAA,iBAAS,EAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,IAAA,mBAAS,EAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,IAAA,qBAAW,EAAC,IAAI,CAAC,CAAC;IAClB,IAAA,aAAG,EAAC,kBAAkB,sBAAa,iBAAiB,oBAAS,EAAE,CAAC,CAAC;IACjE,IAAA,aAAG,EAAC,SAAS,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC"}