devextreme-internal-tools 19.2.15 → 20.0.0

package/ts/config/metadata/mutations.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explodePattern = explodePattern;
+exports.addMetadata = addMetadata;
+exports.addMember = addMember;
+exports.removeMembers = removeMembers;
+exports.replaceTypes = replaceTypes;
+const UID_REGEXP = /^[\w-]+\/[\w_/.-]+:[\w_.-]+$/;
+const isUid = (str) => {
+    if (typeof str !== 'string') {
+        return false;
+    }
+    const indexOfSlash = str.indexOf('/');
+    const indexOfColon = str.indexOf(':');
+    if (indexOfSlash > 0 && indexOfSlash < indexOfColon) {
+        if (UID_REGEXP.test(str)) {
+            return true;
+        }
+        throw new Error(`Invalid UID format: ${str}`);
+    }
+    return false;
+};
+const FN_NAME_REGEXP = /\s*at (.+) /;
+const LINE_NUM_REGEXP = /:(\d+):\d+\)?$/;
+function getFnNameAndLineNumber(skip) {
+    const obj = {};
+    if ('captureStackTrace' in Error) {
+        Error.captureStackTrace(obj, getFnNameAndLineNumber);
+    }
+    if (!obj.stack) {
+        return null;
+    }
+    const stackLines = obj.stack
+        .split('\n')
+        .slice(1)
+        .slice(skip);
+    const fnNameLine = stackLines[0];
+    const callerLine = stackLines[1];
+    if (!fnNameLine || !callerLine) {
+        return null;
+    }
+    const fnMatch = FN_NAME_REGEXP.exec(fnNameLine);
+    const callerMatch = LINE_NUM_REGEXP.exec(callerLine);
+    if (fnMatch && callerMatch) {
+        const fn = fnMatch[1];
+        const line = parseInt(callerMatch[1], 10);
+        return { fn, line };
+    }
+    return null;
+}
+function isArrayType(type) {
+    return typeof type === 'string' && type.endsWith('[]');
+}
+function getElementType(type) {
+    return type.slice(0, -2);
+}
+function normalizeType(typeOrName) {
+    if (isArrayType(typeOrName)) {
+        const itemType = getElementType(typeOrName);
+        return {
+            kind: 'array',
+            itemTypes: [normalizeType(itemType)],
+        };
+    }
+    if (isUid(typeOrName)) {
+        return { ambient: false, kind: 'uidRef', uid: typeOrName };
+    }
+    if (typeof typeOrName === 'string') {
+        return { kind: typeOrName };
+    }
+    if (typeOrName.kind === 'function') {
+        return {
+            ...typeOrName,
+            isFunction: true,
+        };
+    }
+    return typeOrName;
+}
+const BRACES_REGEXP = /\(([^)]+)\)/g;
+function explodePattern(pattern) {
+    let result = [];
+    let lastIndex = 0;
+    for (const match of pattern.matchAll(BRACES_REGEXP)) {
+        if (lastIndex !== match.index) {
+            if (result.length === 0) {
+                result = [pattern.substring(lastIndex, match.index)];
+            }
+            else {
+                const part = pattern.substring(lastIndex, match.index);
+                result = result.map((r) => r + part);
+            }
+        }
+        lastIndex = match.index + match[0].length;
+        const lastResults = result;
+        result = match[1]
+            .split('|')
+            .flatMap((variant) => lastResults.map((r) => r + variant));
+    }
+    if (lastIndex !== pattern.length) {
+        const part = pattern.substring(lastIndex);
+        if (result.length === 0) {
+            result = [part];
+        }
+        else {
+            result = result.map((r) => r + part);
+        }
+    }
+    return result;
+}
+function withMatch(patternOrList, value) {
+    const loc = getFnNameAndLineNumber(1);
+    if (patternOrList instanceof RegExp) {
+        return { loc, pattern: patternOrList, ...value };
+    }
+    const uids = (Array.isArray(patternOrList) ? patternOrList : [patternOrList]).flatMap(explodePattern);
+    if (uids.length === 0) {
+        return null;
+    }
+    return { loc, uids, ...value };
+}
+function addMetadata(patternOrList, meta) {
+    return withMatch(patternOrList, {
+        kind: 'metadata',
+        meta,
+    });
+}
+function addMember({ uid, name, parent, types, }) {
+    const loc = getFnNameAndLineNumber(0);
+    return { loc, kind: 'add', uid, name, parent, types };
+}
+function removeMembers(patternOrList, replaceRefsWith) {
+    return withMatch(patternOrList, {
+        kind: 'remove',
+        replaceRefsWith: replaceRefsWith
+            ? normalizeType(replaceRefsWith)
+            : undefined,
+    });
+}
+function replaceTypes(patternOrList, what, types) {
+    var _a;
+    return withMatch(patternOrList, {
+        kind: 'replaceTypes',
+        what: (_a = what === null || what === void 0 ? void 0 : what.map(normalizeType)) !== null && _a !== void 0 ? _a : null,
+        types: types.map(normalizeType),
+    });
+}
+//# sourceMappingURL=mutations.js.map

package/ts/config/metadata/mutations.js.map

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

package/ts/config/paths.d.ts

@@ -0,0 +1,6 @@
+export declare const paths: {
+    binDir: string;
+    workDir: string;
+    jsDir: string;
+    artifactsDir: string;
+};

package/ts/config/paths.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paths = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function getAllPaths() {
+    const workDir = process.cwd();
+    const binDir = (0, node_path_1.join)(__dirname, '../../bin');
+    const distBinDir = (0, node_path_1.join)(__dirname, '../../dist/bin');
+    return {
+        binDir: (0, node_fs_1.existsSync)(binDir) ? binDir : distBinDir,
+        workDir,
+        jsDir: (0, node_path_1.join)(workDir, 'js'),
+        artifactsDir: (0, node_path_1.join)(workDir, 'artifacts', 'internal-tools'),
+    };
+}
+exports.paths = getAllPaths();
+//# sourceMappingURL=paths.js.map

package/ts/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../ts/config/paths.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AACrC,yCAAiC;AAEjC,SAAS,WAAW;IAMlB,MAAM,OAAO,GAAW,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,MAAM,GAAW,IAAA,gBAAI,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACpD,MAAM,UAAU,GAAW,IAAA,gBAAI,EAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAE7D,OAAO;QACL,MAAM,EAAE,IAAA,oBAAU,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;QAChD,OAAO;QACP,KAAK,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,IAAI,CAAC;QAC1B,YAAY,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,WAAW,EAAE,gBAAgB,CAAC;KAC3D,CAAC;AACJ,CAAC;AAEY,QAAA,KAAK,GAAG,WAAW,EAAE,CAAC"}

package/ts/discoverer/data-model.d.ts

@@ -0,0 +1,105 @@
+export type EnumLikeType = {
+    kind: 'enum';
+    id: string;
+    valueType: 'string';
+    values: string[];
+} | {
+    kind: 'enum';
+    id: string;
+    valueType: 'number';
+    values: number[];
+};
+export interface Root {
+    members: Member[];
+    types: Record<string, TypeDeclaration | EnumLikeType>;
+}
+export type Member = {
+    id: string;
+    tags: MemberTags;
+    optional?: boolean;
+    type?: TypeRef;
+    optionsType?: string;
+    typeParameters?: Record<string, GenericParamDeclaration>;
+    location?: {
+        file: string;
+    };
+};
+export interface MemberTags {
+    deprecated?: string[];
+    docid?: string[];
+    [key: string]: string[];
+}
+export interface TypeRef {
+    name: string;
+    file?: string;
+}
+export type Typing = ValueTyping | ReferenceTyping | GenericTyping | Union | Intersection | FunctionTyping | LiteralTyping;
+export interface TypingBase {
+    array?: boolean;
+    kind: (typeof TypingKind)[keyof typeof TypingKind];
+}
+export declare const TypingKind: {
+    readonly Value: 0;
+    readonly Reference: 1;
+    readonly Union: 2;
+    readonly Intersection: 3;
+    readonly Literal: 4;
+    readonly GenericArgument: 5;
+    readonly Function: 6;
+};
+export interface NamedTyping extends TypingBase {
+    id: string;
+    args?: Typing[];
+}
+export interface ValueTyping extends NamedTyping {
+    kind: typeof TypingKind.Value;
+}
+export interface ReferenceTyping extends NamedTyping {
+    kind: typeof TypingKind.Reference;
+    memberId?: string;
+}
+export interface GenericTyping extends NamedTyping {
+    kind: typeof TypingKind.GenericArgument;
+    memberId?: string;
+}
+interface CompositeTyping extends TypingBase {
+    types: Typing[];
+}
+export interface Union extends CompositeTyping {
+    kind: typeof TypingKind.Union;
+}
+export interface Intersection extends CompositeTyping {
+    kind: typeof TypingKind.Intersection;
+}
+export interface LiteralTyping extends TypingBase {
+    kind: typeof TypingKind.Literal;
+    value: string | number | null;
+}
+export interface FunctionTyping extends TypingBase {
+    kind: typeof TypingKind.Function;
+    params?: Record<string, FunctionParam>;
+    returnType: Typing;
+}
+interface FunctionParam {
+    type: Typing;
+    spread?: boolean;
+}
+export interface GenericParamDeclaration {
+    defaultValue?: Typing;
+}
+export interface TypeDeclaration {
+    kind: 'object';
+    typeParams?: Record<string, Typing>;
+    props: Record<string, PropDeclaration>;
+}
+export type PropDeclaration = {
+    type: Typing;
+} & (OwnProp | InheritedProp);
+interface OwnProp {
+    readonly?: boolean;
+    optional?: boolean;
+}
+interface InheritedProp {
+    inheritedFrom: string;
+}
+export {};

package/ts/discoverer/data-model.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypingKind = void 0;
+exports.TypingKind = {
+    Value: 0,
+    Reference: 1,
+    Union: 2,
+    Intersection: 3,
+    Literal: 4,
+    GenericArgument: 5,
+    Function: 6,
+};
+//# sourceMappingURL=data-model.js.map

package/ts/discoverer/data-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-model.js","sourceRoot":"","sources":["../../../ts/discoverer/data-model.ts"],"names":[],"mappings":";;;AA2Da,QAAA,UAAU,GAAG;IACxB,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,CAAC;IACf,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,CAAC;IAClB,QAAQ,EAAE,CAAC;CACH,CAAC"}

package/ts/discoverer/discovering-error.d.ts

@@ -0,0 +1,4 @@
+import type { Node } from 'typescript';
+export declare class DiscoveringError extends Error {
+    constructor(message: string, nodes: Node[]);
+}

package/ts/discoverer/discovering-error.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiscoveringError = void 0;
+class DiscoveringError extends Error {
+    constructor(message, nodes) {
+        const extraData = [];
+        for (const node of nodes) {
+            const file = node.getSourceFile();
+            const { line, character } = file.getLineAndCharacterOfPosition(node.getStart());
+            extraData.push(`${file.fileName}:${line}:${character}\n\n${node.getText()}`);
+        }
+        super(`${message}\n\n${extraData.join('\n')}\n\n`);
+    }
+}
+exports.DiscoveringError = DiscoveringError;
+//# sourceMappingURL=discovering-error.js.map

package/ts/discoverer/discovering-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovering-error.js","sourceRoot":"","sources":["../../../ts/discoverer/discovering-error.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe,EAAE,KAAa;QACxC,MAAM,SAAS,GAAG,EAAE,CAAC;QAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAClC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,6BAA6B,CAC5D,IAAI,CAAC,QAAQ,EAAE,CAChB,CAAC;YACF,SAAS,CAAC,IAAI,CACZ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,IAAI,SAAS,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAC7D,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,GAAG,OAAO,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;CACF;AAhBD,4CAgBC"}

package/ts/discoverer/discovering.d.ts

@@ -0,0 +1,4 @@
+import type { Root } from './data-model';
+import type { CompilerOptions } from './parsing';
+export declare function discover(targetFiles: string[], targetDir: string, outputFile: string, toolsVersion?: string, compilerOptions?: CompilerOptions): void;
+export declare function discoverMembers(fileNames: string[], baseDir: string, compilerOptions?: CompilerOptions): Root;

package/ts/discoverer/discovering.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discover = discover;
+exports.discoverMembers = discoverMembers;
+const node_fs_1 = require("node:fs");
+const parsing_1 = require("./parsing");
+const id_1 = require("../common/id");
+const tags_1 = require("../common/tags");
+const utils_1 = require("../common/utils");
+const logging_1 = require("../logging");
+function discover(targetFiles, targetDir, outputFile, toolsVersion, compilerOptions = {}) {
+    (0, logging_1.log)('Discovering members');
+    const normalizedResult = discoverMembers(targetFiles, targetDir, compilerOptions);
+    (0, logging_1.log)(`${normalizedResult.members.length} members descriptors discovered`);
+    (0, node_fs_1.writeFileSync)(outputFile, JSON.stringify({ ToolsVersion: toolsVersion, ...normalizedResult }, null, 2));
+}
+function discoverMembers(fileNames, baseDir, compilerOptions) {
+    const [descriptors, types] = (0, parsing_1.parseFiles)(fileNames, baseDir, compilerOptions);
+    const members = descriptors
+        .filter((e) => Object.entries(e.tags).length > 0)
+        .map((descriptor) => {
+        const member = {
+            id: descriptor[id_1.ID],
+            tags: (0, tags_1.buildMemberTags)(descriptor.tags),
+        };
+        switch (descriptor.kind) {
+            case 'option': {
+                const { type, optional } = descriptor;
+                if (type) {
+                    member.type = { name: type.name };
+                    if (type.cat === 'custom' || type.cat === 'custom-generic')
+                        member.type.file = type.file;
+                }
+                if (optional)
+                    member.optional = true;
+                break;
+            }
+            case 'widget':
+                member.optionsType = descriptor.optionsType;
+                break;
+        }
+        if (descriptor.location)
+            member.location = descriptor.location;
+        if (descriptor.typeParameters)
+            member.typeParameters = descriptor.typeParameters;
+        if (!member.id) {
+            throw new Error(`Empty ID discovered: ${JSON.stringify(member)}`);
+        }
+        return member;
+    })
+        .sort(compare);
+    return {
+        members,
+        types: (0, utils_1.toSortedRecord)(types),
+    };
+}
+function compare(a, b) {
+    const result = compareAttrValues(getNameForComparison(a), getNameForComparison(b));
+    return result !== 0 ? result : compareAttrValues(a.tags.name, b.tags.name);
+}
+function getNameForComparison(doc) {
+    return doc.tags.const || doc.tags.docid;
+}
+function compareAttrValues(a, b) {
+    if (a === undefined && b === undefined)
+        return 0;
+    if (a === undefined)
+        return -1;
+    if (b === undefined)
+        return 1;
+    return a[0].localeCompare(b[0]);
+}
+//# sourceMappingURL=discovering.js.map

package/ts/discoverer/discovering.js.map

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

package/ts/discoverer/parsing/enum-collecting.d.ts

@@ -0,0 +1,6 @@
+import type { Symbol } from 'typescript';
+import type { EnumLikeType } from '../data-model';
+export declare function createEnumsCollector(baseDir: string): {
+    addEnum: (symbol: Symbol) => void;
+    toRecord: () => Record<string, EnumLikeType>;
+};

package/ts/discoverer/parsing/enum-collecting.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEnumsCollector = createEnumsCollector;
+const typescript_1 = require("typescript");
+const id_1 = require("../../common/id");
+const type_resolving_1 = require("../../common/type-resolving");
+const utils_1 = require("../../common/utils");
+const logging_1 = require("../../logging");
+function getValuesFromEnumLikeType(declaration, baseDir) {
+    if ((0, typescript_1.isTypeAliasDeclaration)(declaration)) {
+        const { type } = declaration;
+        const types = (0, typescript_1.isUnionTypeNode)(type) ? [...type.types] : [type];
+        if (types && (0, utils_1.everyOf)(types, typescript_1.isLiteralTypeNode)) {
+            const literals = types.map(type_resolving_1.resolveLiteralType);
+            if ((0, utils_1.everyOf)(literals, type_resolving_1.isStringLiteralMemberType)) {
+                return {
+                    id: (0, id_1.getIdFromNode)(declaration, baseDir),
+                    kind: 'enum',
+                    values: literals.map((l) => l.value),
+                    valueType: 'string',
+                };
+            }
+            if ((0, utils_1.everyOf)(literals, type_resolving_1.isNumberLiteralMemberType)) {
+                return {
+                    id: (0, id_1.getIdFromNode)(declaration, baseDir),
+                    kind: 'enum',
+                    values: literals.map((l) => l.value),
+                    valueType: 'number',
+                };
+            }
+        }
+    }
+    return undefined;
+}
+function createEnumsCollector(baseDir) {
+    const enumLikeTypes = new Map();
+    function update(enumName, enumValues) {
+        const typeName = `Enums.${enumName}`;
+        if (enumLikeTypes.has(typeName)) {
+            const enumType = enumLikeTypes.get(typeName);
+            if (enumType.valueType === 'string' &&
+                enumValues.valueType === 'string') {
+                enumType.values = [...enumType.values, ...enumValues.values];
+            }
+            else if (enumType.valueType === 'number' &&
+                enumValues.valueType === 'number') {
+                enumType.values = [...enumType.values, ...enumValues.values];
+            }
+            else {
+                (0, logging_1.log)(`Enums with the same name ${enumName}, but different values`, {
+                    lvl: 'error',
+                });
+            }
+        }
+        else {
+            enumLikeTypes.set(typeName, enumValues);
+        }
+    }
+    function addEnum(symbol) {
+        const enumValues = symbol.declarations
+            .filter(typescript_1.isTypeAliasDeclaration)
+            .map((declaration) => getValuesFromEnumLikeType(declaration, baseDir))
+            .find(Boolean);
+        if (!enumValues)
+            return;
+        const enumName = symbol.escapedName.toString();
+        update(enumName, enumValues);
+    }
+    function toRecord() {
+        return Object.fromEntries(enumLikeTypes.entries());
+    }
+    return { addEnum, toRecord };
+}
+//# sourceMappingURL=enum-collecting.js.map

package/ts/discoverer/parsing/enum-collecting.js.map

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

package/ts/discoverer/parsing/file-reader.d.ts

@@ -0,0 +1,2 @@
+import type { SourceFile, Symbol, TypeChecker } from 'typescript';
+export declare function getDiscoverableSymbols(sourceFile: SourceFile, checker: TypeChecker): Symbol[];

package/ts/discoverer/parsing/file-reader.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDiscoverableSymbols = getDiscoverableSymbols;
+const typescript_1 = require("typescript");
+const ts_utils_1 = require("../../common/ts-utils");
+function getDiscoverableSymbols(sourceFile, checker) {
+    var _a, _b, _c, _d;
+    const result = new Set();
+    const fileSymbol = checker.getSymbolAtLocation(sourceFile);
+    if (fileSymbol) {
+        for (const symbol of checker.getExportsOfModule(fileSymbol)) {
+            result.add(symbol);
+        }
+    }
+    const notExportedSymbolsWithTags = (_d = (_c = (_b = (_a = sourceFile === null || sourceFile === void 0 ? void 0 : sourceFile.statements) === null || _a === void 0 ? void 0 : _a.filter((n) => {
+        var _a;
+        return (0, ts_utils_1.isStatementWithModifiers)(n)
+            ? !((_a = n.modifiers) === null || _a === void 0 ? void 0 : _a.some((m) => m.kind === typescript_1.SyntaxKind.ExportKeyword))
+            : false;
+    })) === null || _b === void 0 ? void 0 : _b.filter((n) => (0, typescript_1.getJSDocTags)(n).length > 0)) === null || _c === void 0 ? void 0 : _c.map((n) => {
+        if ((0, typescript_1.isTypeAliasDeclaration)(n)) {
+            return checker.getSymbolAtLocation(n.name);
+        }
+        return null;
+    })) === null || _d === void 0 ? void 0 : _d.filter((s) => s);
+    if (notExportedSymbolsWithTags) {
+        for (const symbol of notExportedSymbolsWithTags) {
+            result.add(symbol);
+        }
+    }
+    return Array.from(result);
+}
+//# sourceMappingURL=file-reader.js.map

package/ts/discoverer/parsing/file-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.js","sourceRoot":"","sources":["../../../../ts/discoverer/parsing/file-reader.ts"],"names":[],"mappings":";;AAMA,wDAoCC;AA1CD,2CAA8E;AAE9E,oDAAiE;AAIjE,SAAgB,sBAAsB,CACpC,UAAsB,EACtB,OAAoB;;IAEpB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,MAAM,UAAU,GAAG,OAAO,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,0BAA0B,GAAG,MAAA,MAAA,MAAA,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,UAAU,0CACrD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;;QACb,OAAA,IAAA,mCAAwB,EAAC,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC,CAAA,MAAA,CAAC,CAAC,SAAS,0CAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAU,CAAC,aAAa,CAAC,CAAA;YAChE,CAAC,CAAC,KAAK,CAAA;KAAA,CACV,0CACC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,yBAAY,EAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,0CACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACV,IAAI,IAAA,mCAAsB,EAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,0CACA,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAErB,IAAI,0BAA0B,EAAE,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,0BAA0B,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/ts/discoverer/parsing/widget-parsing.d.ts

@@ -0,0 +1,11 @@
+import type { Node, TypeChecker } from 'typescript';
+import type { DocTag } from '../../common/tags/types';
+export declare function parseWidgetExtras(node: Node, tags: DocTag[], checker: TypeChecker, baseDir: string): {
+    optionsType: string;
+    isWidget: true;
+    tags: DocTag[];
+} | {
+    isWidget: false;
+    optionsType?: undefined;
+    tags?: undefined;
+};

package/ts/discoverer/parsing/widget-parsing.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWidgetExtras = parseWidgetExtras;
+const typescript_1 = require("typescript");
+const common_resolving_1 = require("../../common/common-resolving");
+const id_1 = require("../../common/id");
+const tags_1 = require("../../common/tags");
+const ts_utils_1 = require("../../common/ts-utils");
+function parseWidgetExtras(node, tags, checker, baseDir) {
+    const optionsTag = tags.find((t) => t.name === tags_1.TAG_OPTIONS);
+    if (optionsTag) {
+        const optionsType = !optionsTag.value.includes(':')
+            ? `${(0, id_1.getNodeFilePrefix)(node, baseDir)}:${optionsTag.value}`
+            : optionsTag.value;
+        return {
+            optionsType,
+            isWidget: true,
+            tags: tags.filter((t) => t !== optionsTag),
+        };
+    }
+    const optionsTypeSymbol = getOptionsTypeSymbol(node, checker);
+    if (optionsTypeSymbol) {
+        if (optionsTypeSymbol.declarations.length !== 1) {
+            throw new Error(`Partial declaration of options type not expected: ${optionsTypeSymbol.name}`);
+        }
+        const prefix = (0, id_1.getNodeFilePrefix)(optionsTypeSymbol.declarations[0], baseDir);
+        return {
+            optionsType: `${prefix}:${optionsTypeSymbol.name}`,
+            isWidget: true,
+            tags,
+        };
+    }
+    return { isWidget: false };
+}
+function getOptionsTypeSymbol(node, checker) {
+    var _a;
+    const type = checker.getTypeAtLocation(node);
+    if (!((_a = getAllBaseTypes(type)) === null || _a === void 0 ? void 0 : _a.some(isWrappable)))
+        return undefined;
+    const optionsPropSymbol = type.getProperty('option');
+    if (optionsPropSymbol === undefined)
+        return undefined;
+    const resolvedType = checker.getTypeOfSymbolAtLocation(optionsPropSymbol, optionsPropSymbol.valueDeclaration);
+    if (resolvedType === undefined)
+        return undefined;
+    const returnType = checker
+        .getSignaturesOfType(resolvedType, typescript_1.SignatureKind.Call)
+        .find((s) => s.parameters.length === 0)
+        .getReturnType().symbol;
+    if (returnType === undefined)
+        return undefined;
+    const paramDeclarations = returnType.declarations.filter(typescript_1.isTypeParameterDeclaration);
+    if (paramDeclarations.length === returnType.declarations.length) {
+        if (paramDeclarations.length !== 1)
+            throw new Error('Partial declaration of type parameter not expected');
+        return paramDeclarations[0].default
+            ? checker.getTypeAtLocation(paramDeclarations[0].default).symbol
+            : undefined;
+    }
+    return returnType;
+}
+function getAllBaseTypes(type) {
+    var _a;
+    const baseTypes = (0, ts_utils_1.isTypeReference)(type)
+        ? type.target.getBaseTypes()
+        : type.getBaseTypes();
+    return ((_a = baseTypes === null || baseTypes === void 0 ? void 0 : baseTypes.flatMap((baseType) => [
+        baseType,
+        ...getAllBaseTypes(baseType),
+    ])) !== null && _a !== void 0 ? _a : []);
+}
+function isWrappable(type) {
+    return (0, common_resolving_1.hasTag)(type.symbol, 'wrappable');
+}
+//# sourceMappingURL=widget-parsing.js.map

package/ts/discoverer/parsing/widget-parsing.js.map

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