@ui5/webcomponents-tools 0.0.0-d1315d658 → 0.0.0-d473b9686

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.
Files changed (53) hide show
  1. package/CHANGELOG.md +767 -0
  2. package/README.md +2 -1
  3. package/assets-meta.js +15 -10
  4. package/components-package/eslint.js +2 -0
  5. package/components-package/nps.js +51 -43
  6. package/components-package/postcss.components.js +1 -21
  7. package/components-package/postcss.themes.js +1 -50
  8. package/components-package/wdio.js +414 -400
  9. package/icons-collection/nps.js +7 -5
  10. package/lib/amd-to-es6/index.js +102 -0
  11. package/lib/amd-to-es6/no-remaining-require.js +33 -0
  12. package/lib/cem/custom-elements-manifest.config.mjs +501 -0
  13. package/lib/cem/event.mjs +131 -0
  14. package/lib/cem/schema-internal.json +1357 -0
  15. package/lib/cem/schema.json +1098 -0
  16. package/lib/cem/types-internal.d.ts +796 -0
  17. package/lib/cem/types.d.ts +736 -0
  18. package/lib/cem/utils.mjs +384 -0
  19. package/lib/cem/validate.js +70 -0
  20. package/lib/create-icons/index.js +8 -6
  21. package/lib/create-illustrations/index.js +51 -30
  22. package/lib/create-new-component/index.js +4 -11
  23. package/lib/create-new-component/tsFileContentTemplate.js +3 -12
  24. package/lib/css-processors/css-processor-component-styles.mjs +48 -0
  25. package/lib/css-processors/css-processor-components.mjs +77 -0
  26. package/lib/css-processors/css-processor-themes.mjs +79 -0
  27. package/lib/css-processors/scope-variables.mjs +49 -0
  28. package/lib/{postcss-css-to-esm/index.js → css-processors/shared.mjs} +36 -50
  29. package/lib/dev-server/custom-hot-update-plugin.js +39 -0
  30. package/lib/dev-server/ssr-dom-shim-loader.js +26 -0
  31. package/lib/generate-js-imports/illustrations.js +78 -64
  32. package/lib/generate-json-imports/i18n.js +10 -37
  33. package/lib/generate-json-imports/themes.js +9 -31
  34. package/lib/i18n/defaults.js +1 -1
  35. package/lib/postcss-combine-duplicated-selectors/index.js +12 -5
  36. package/lib/remove-dev-mode/remove-dev-mode.mjs +37 -0
  37. package/lib/scoping/get-all-tags.js +1 -1
  38. package/lib/scoping/lint-src.js +8 -7
  39. package/lib/scoping/scope-test-pages.js +2 -1
  40. package/package.json +11 -10
  41. package/components-package/wdio.sync.js +0 -368
  42. package/lib/create-new-component/jsFileContentTemplate.js +0 -73
  43. package/lib/esm-abs-to-rel/index.js +0 -58
  44. package/lib/generate-custom-elements-manifest/index.js +0 -327
  45. package/lib/jsdoc/config.json +0 -29
  46. package/lib/jsdoc/configTypescript.json +0 -29
  47. package/lib/jsdoc/plugin.js +0 -2468
  48. package/lib/jsdoc/preprocess.js +0 -146
  49. package/lib/jsdoc/template/publish.js +0 -4120
  50. package/lib/postcss-css-to-json/index.js +0 -47
  51. package/lib/postcss-new-files/index.js +0 -36
  52. package/lib/postcss-p/postcss-p.mjs +0 -14
  53. package/lib/replace-global-core/index.js +0 -25
@@ -41,22 +41,24 @@ const copyIconAssetsCommand = (options) => {
41
41
  const getScripts = (options) => {
42
42
  const createJSImportsCmd = createIconImportsCommand(options);
43
43
  const copyAssetsCmd = copyIconAssetsCommand(options);
44
- const tsCommand = options.typescript ? "tsc" : "";
45
- const tsCrossEnv = options.typescript ? "cross-env UI5_TS=true" : "";
44
+ const tsCommand = !options.legacy ? "tsc --build" : "";
45
+ const tsCrossEnv = !options.legacy ? "cross-env UI5_TS=true" : "";
46
46
 
47
47
  const scripts = {
48
48
  clean: "rimraf dist && rimraf src/generated",
49
49
  copy: copyAssetsCmd,
50
+ generate: `${tsCrossEnv} nps clean copy build.i18n build.icons build.jsonImports copyjson`,
51
+ copyjson: "copy-and-watch \"src/generated/**/*.json\" dist/generated/",
50
52
  build: {
51
53
  default: `${tsCrossEnv} nps clean copy build.i18n typescript build.icons build.jsonImports`,
52
54
  i18n: {
53
55
  default: "nps build.i18n.defaultsjs build.i18n.json",
54
56
  defaultsjs: `mkdirp dist/generated/i18n && node "${LIB}/i18n/defaults.js" src/i18n src/generated/i18n`,
55
- json: `mkdirp dist/generated/assets/i18n && node "${LIB}/i18n/toJSON.js" src/i18n dist/generated/assets/i18n`,
57
+ json: `mkdirp src/generated/assets/i18n && node "${LIB}/i18n/toJSON.js" src/i18n src/generated/assets/i18n`,
56
58
  },
57
59
  jsonImports: {
58
- default: "mkdirp dist/generated/json-imports && nps build.jsonImports.i18n",
59
- i18n: `node "${LIB}/generate-json-imports/i18n.js" dist/generated/assets/i18n dist/generated/json-imports`,
60
+ default: "mkdirp src/generated/json-imports && nps build.jsonImports.i18n",
61
+ i18n: `node "${LIB}/generate-json-imports/i18n.js" src/generated/assets/i18n src/generated/json-imports`,
60
62
  },
61
63
  icons: createJSImportsCmd,
62
64
  },
@@ -0,0 +1,102 @@
1
+ const fs = require("fs").promises;
2
+ const path = require("path");
3
+ const basePath = process.argv[2];
4
+ const babelCore = require("@babel/core");
5
+ const babelParser = require("@babel/parser");
6
+ const babelGenerator = require("@babel/generator").default;
7
+ const replaceAsync = require('replace-in-file');
8
+
9
+ const convertSAPUIDefineToDefine = async (filePath) => {
10
+ return replaceAsync({
11
+ files: filePath,
12
+ processor: (input) => {
13
+ return input.replace("sap.ui.define", "define").replace(", /* bExport= */ false", "").replace(", /* bExport= */ true", "");
14
+ }
15
+ })
16
+ }
17
+
18
+ const convertAmdToEs6 = async (code) => {
19
+ return (await babelCore.transformAsync(code, {
20
+ plugins: [['babel-plugin-amd-to-esm', {}]]
21
+ })).code;
22
+ }
23
+
24
+ const convertAbsImportsToRelative = (filePath, code) => {
25
+ let changed = false;
26
+ // console.log("File processing started: ", srcPath);
27
+
28
+ if (code.includes("import(")) {
29
+ // esprima can't parse this, but it's from the project files
30
+ return;
31
+ }
32
+
33
+ const tree = babelParser.parse(code, { sourceType: "module" });
34
+ const importer = filePath.replace(basePath, "");
35
+ const importerDir = path.dirname(importer);
36
+ // console.log("Importer -> ", importer);
37
+
38
+ tree?.program?.body?.forEach(node => {
39
+ if (node.type === "ImportDeclaration") {
40
+ let importee = node.source.value;
41
+ // console.log(importee);
42
+ if (importee.startsWith(".")) {
43
+ // add .js extension if missing
44
+ if (!importee.endsWith(".js")) {
45
+ node.source.value += ".js"
46
+ changed = true;
47
+ }
48
+ return;
49
+ }
50
+ let importeeDir = path.dirname(importee);
51
+ let importeeFile = path.basename(importee);
52
+ let relativePath = path.relative(importerDir, importeeDir);
53
+ if (relativePath.length === 0) {
54
+ relativePath = "."
55
+ }
56
+ if (!relativePath.startsWith(".")) {
57
+ relativePath = "./" + relativePath;
58
+ }
59
+
60
+ relativePath = relativePath.replace(/\\/g, "/"); // the browser expects unix paths
61
+ let relativeImport = `${relativePath}/${importeeFile}.js`;
62
+ // console.log(importee + " --> " + relativeImport);
63
+ node.source.value = relativeImport;
64
+ changed = true;
65
+ }
66
+ });
67
+
68
+ return changed ? babelGenerator(tree).code : code;
69
+ }
70
+
71
+ const replaceGlobalCoreUsage = (filePath, code) => {
72
+ if (!filePath.includes("Configuration")) {
73
+ const replaced = code.replace(/sap\.ui\.getCore\(\)/g, `Core`);
74
+ return code !== replaced ? `import Core from 'sap/ui/core/Core';${replaced}` : code;
75
+ }
76
+
77
+ return code;
78
+ };
79
+
80
+ const transformAmdToES6Module = async (filePath) => {
81
+ await convertSAPUIDefineToDefine(filePath);
82
+
83
+ let code = (await fs.readFile(filePath)).toString();
84
+
85
+ code = await convertAmdToEs6(code);
86
+
87
+ code = replaceGlobalCoreUsage(filePath, code);
88
+
89
+ code = convertAbsImportsToRelative(filePath, code);
90
+
91
+ return fs.writeFile(filePath, code);
92
+ }
93
+
94
+ const transformAmdToES6Modules = async () => {
95
+ const { globby } = await import("globby");
96
+ const fileNames = await globby(basePath.replace(/\\/g, "/") + "**/*.js");
97
+ return Promise.all(fileNames.map(transformAmdToES6Module).filter(x => !!x));
98
+ };
99
+
100
+ transformAmdToES6Modules().then(() => {
101
+ console.log("Success: all amd modules are transformed to es6!");
102
+ });
@@ -0,0 +1,33 @@
1
+ const fs = require("fs").promises;
2
+ const path = require("path");
3
+ const basePath = process.argv[2];
4
+ const babelCore = require("@babel/core");
5
+ const babelParser = require("@babel/parser");
6
+ const babelGenerator = require("@babel/generator").default;
7
+ const walk = require("estree-walk");
8
+
9
+ const checkHasRequire = (filePath, code) => {
10
+ code = code.replace(/sap\.ui\.require/g, "unhandledRequire");
11
+
12
+ const tree = babelParser.parse(code, { sourceType: "module" });
13
+ walk(tree, {
14
+ CallExpression: function (node) {
15
+ if (node.type === "CallExpression" && node?.callee?.name === "unhandledRequire") {
16
+ throw new Error(`sap.ui.require found in ${filePath}`);
17
+ }
18
+ }
19
+ });
20
+ }
21
+
22
+ const checkFile = async (filePath) => {
23
+ let code = (await fs.readFile(filePath)).toString();
24
+ checkHasRequire(filePath, code);
25
+ }
26
+
27
+ const checkAll = async () => {
28
+ const { globby } = await import("globby");
29
+ const fileNames = await globby(basePath.replace(/\\/g, "/") + "**/*.js");
30
+ return Promise.all(fileNames.map(checkFile).filter(x => !!x));
31
+ };
32
+
33
+ checkAll();
@@ -0,0 +1,501 @@
1
+ import { parse } from "comment-parser";
2
+ import processEvent from "./event.mjs";
3
+ import path from "path";
4
+ import fs from 'fs';
5
+ import {
6
+ getDeprecatedStatus,
7
+ getSinceStatus,
8
+ getPrivacyStatus,
9
+ getReference,
10
+ validateJSDocComment,
11
+ findDecorator,
12
+ findAllDecorators,
13
+ hasTag,
14
+ findTag,
15
+ findAllTags,
16
+ getTypeRefs,
17
+ normalizeDescription,
18
+ formatArrays,
19
+ isClass,
20
+ normalizeTagType,
21
+ logDocumentationError,
22
+ displayDocumentationErrors,
23
+ toKebabCase
24
+ } from "./utils.mjs";
25
+ import { generateCustomData } from "cem-plugin-vs-code-custom-data-generator";
26
+ import { customElementJetBrainsPlugin } from "custom-element-jet-brains-integration";
27
+
28
+ const packageJSON = JSON.parse(fs.readFileSync("./package.json"));
29
+
30
+ const extractClassNodeJSDoc = node => {
31
+ const fileContent = node.getFullText();
32
+ const allJSDocsRegExp = new RegExp(`\\/\\*\\*(.|\\n)+?\\s+\\*\\/`, "gm");
33
+ let allJSDocs = [...fileContent.matchAll(allJSDocsRegExp)];
34
+ allJSDocs = allJSDocs.map(match => match[0]); // all /** ..... */ comments
35
+
36
+ // Find where the class is defined in the original file
37
+ const tsClassDefinitionRegExp = new RegExp(`^\\s*(abstract\\s*)?class [\\w\\d_]+`, "gm");
38
+ let tsClassDefinitionMatch = fileContent.match(tsClassDefinitionRegExp);
39
+ if (!tsClassDefinitionMatch) {
40
+ return; // no class defined in this .ts file
41
+ }
42
+ const tsClassDefinition = tsClassDefinitionMatch[0];
43
+ const tsClassDefinitionIndex = fileContent.indexOf(tsClassDefinition);
44
+
45
+ return allJSDocs.find(JSDoc => {
46
+ return isClass(JSDoc) && (fileContent.indexOf(JSDoc) < tsClassDefinitionIndex)
47
+ });
48
+ }
49
+
50
+ function processClass(ts, classNode, moduleDoc) {
51
+ const className = classNode?.name?.text;
52
+ const currClass = moduleDoc?.declarations?.find(declaration => declaration?.name === className);
53
+ const currClassJSdoc = extractClassNodeJSDoc(classNode);
54
+
55
+ if (!currClassJSdoc) return;
56
+
57
+ const customElementDecorator = findDecorator(classNode, "customElement");
58
+ const classParsedJsDoc = parse(currClassJSdoc, { spacing: 'preserve' })[0];
59
+
60
+ validateJSDocComment("class", classParsedJsDoc, classNode.name?.text, moduleDoc);
61
+
62
+ const decoratorArg = customElementDecorator?.expression?.arguments[0];
63
+ currClass.tagName = decoratorArg?.text || (decoratorArg?.properties.find(property => property.name.text === "tag")?.initializer?.text);
64
+ currClass.customElement = !!customElementDecorator || className === "UI5Element" || undefined;
65
+ currClass.kind = "class";
66
+ currClass.deprecated = getDeprecatedStatus(classParsedJsDoc);
67
+ currClass._ui5since = getSinceStatus(classParsedJsDoc);
68
+ currClass._ui5privacy = getPrivacyStatus(classParsedJsDoc);
69
+ currClass._ui5abstract = hasTag(classParsedJsDoc, "abstract") ? true : undefined;
70
+ currClass.description = normalizeDescription(classParsedJsDoc.description || findTag(classParsedJsDoc, "class")?.description);
71
+ currClass._ui5implements = findAllTags(classParsedJsDoc, "implements")
72
+ .map(tag => getReference(ts, normalizeTagType(tag.type), classNode, moduleDoc.path))
73
+ .filter(Boolean);
74
+
75
+
76
+ if (hasTag(classParsedJsDoc, "extends")) {
77
+ const superclassTag = findTag(classParsedJsDoc, "extends");
78
+ currClass.superclass = getReference(ts, superclassTag.name, classNode, moduleDoc.path);
79
+
80
+ if (currClass.superclass?.name === "UI5Element") {
81
+ currClass.customElement = true;
82
+ }
83
+ }
84
+
85
+ if (!currClass._ui5implements.length) delete currClass._ui5implements;
86
+
87
+ // Slots
88
+
89
+ // Slots without accessort (defined in class comment)
90
+ if (hasTag(classParsedJsDoc, "slot") && currClass.slots) {
91
+ const slotTags = findAllTags(classParsedJsDoc, "slot");
92
+
93
+ currClass.slots.forEach(slot => {
94
+ const tag = slotTags.find(tag => tag.name === slot.name);
95
+
96
+ const typeRefs = (normalizeTagType(tag.type)
97
+ ?.replaceAll(/Array<|>|\[\]/g, "")
98
+ ?.split("|")
99
+ ?.map(e => getReference(ts, e.trim(), classNode, moduleDoc.path)).filter(Boolean));
100
+
101
+ slot._ui5privacy = "public";
102
+ slot._ui5type = { text: formatArrays(normalizeTagType(tag.type)) };
103
+ slot.description = normalizeDescription(tag.description)
104
+
105
+ if (typeRefs && typeRefs.length) {
106
+ slot._ui5type.references = typeRefs;
107
+ }
108
+
109
+ delete slot.type
110
+ })
111
+ }
112
+
113
+ // Events
114
+ currClass.events = findAllDecorators(classNode, "event")
115
+ ?.map(event => processEvent(ts, event, classNode, moduleDoc));
116
+
117
+ // Slots (with accessor), methods and fields
118
+ for (let i = 0; i < (currClass.members?.length || 0); i++) {
119
+ const member = currClass.members[i];
120
+ const classNodeMember = classNode.members?.find(nodeMember => nodeMember.name?.text === member?.name && nodeMember.jsDoc?.[0]);
121
+ const classNodeMemberJSdoc = classNodeMember?.jsDoc?.[0];
122
+
123
+ if (!classNodeMember || !classNodeMemberJSdoc) continue;
124
+
125
+ const memberParsedJsDoc = parse(classNodeMemberJSdoc?.getText())[0];
126
+
127
+ member._ui5since = getSinceStatus(memberParsedJsDoc);
128
+ member.deprecated === "true" && (member.deprecated = true)
129
+
130
+ // Slots with accessors are treated like fields by the tool, so we have to convert them into slots.
131
+ if (member.kind === "field") {
132
+ const slotDecorator = findDecorator(classNodeMember, "slot");
133
+ validateJSDocComment(slotDecorator ? "slot" : (member.readonly ? "getter" : "field"), memberParsedJsDoc, classNodeMember.name?.text, moduleDoc);
134
+
135
+ const typeRefs = (getTypeRefs(ts, classNodeMember, member)
136
+ ?.map(e => getReference(ts, e, classNodeMember, moduleDoc.path)).filter(Boolean)) || [];
137
+
138
+ if (member.type?.text) {
139
+ member.type.text = formatArrays(member.type.text);
140
+ }
141
+
142
+ if (member.type && typeRefs.length) {
143
+ member.type.references = typeRefs;
144
+ }
145
+
146
+ if (slotDecorator) {
147
+ if (!currClass.slots) currClass.slots = [];
148
+
149
+ const slot = currClass.members.splice(i, 1)[0];
150
+ const defaultProperty = slotDecorator.expression?.arguments?.[0]?.properties?.find(property => property.name.text === "default");
151
+
152
+ // name of the default slot declared with decorator will be overriden so we to provide it's accessor name
153
+ if (defaultProperty && defaultProperty.initializer?.kind === ts.SyntaxKind.TrueKeyword) {
154
+ slot._ui5propertyName = slot.name;
155
+ slot.name = "default";
156
+ }
157
+
158
+ // Slots don't have type, privacy and kind, so we have do convert them and to clean unused props
159
+ member._ui5type = member.type;
160
+ member._ui5privacy = member.privacy;
161
+ delete member.type;
162
+ delete member.privacy;
163
+ delete slot.kind;
164
+
165
+ currClass.slots.push(slot);
166
+ i--;
167
+ } else {
168
+ const propertyDecorator = findDecorator(classNodeMember, "property");
169
+
170
+ if (propertyDecorator) {
171
+ member._ui5validator = propertyDecorator?.expression?.arguments[0]?.properties?.find(property => ["validator", "type"].includes(property.name.text))?.initializer?.text || "String";
172
+ member._ui5noAttribute = propertyDecorator?.expression?.arguments[0]?.properties?.find(property => property.name.text === "noAttribute")?.initializer?.kind === ts.SyntaxKind.TrueKeyword || undefined;
173
+ }
174
+
175
+ if (currClass.customElement && member.privacy === "public" && !propertyDecorator?.expression?.arguments[0]?.properties?.find(property => property.name.text === "multiple") && !["object"].includes(member._ui5validator?.toLowerCase())) {
176
+ const filename = classNode.getSourceFile().fileName;
177
+ const sourceFile = typeProgram.getSourceFile(filename);
178
+ const tsProgramClassNode = sourceFile.statements.find(statement => ts.isClassDeclaration(statement) && statement.name?.text === classNode.name?.text);
179
+ const tsProgramMember = tsProgramClassNode.members.find(m => ts.isPropertyDeclaration(m) && m.name?.text === member.name);
180
+ const attributeValue = typeChecker.typeToString(typeChecker.getTypeAtLocation(tsProgramMember), tsProgramMember);
181
+
182
+ currClass.attributes.push({
183
+ description: member.description,
184
+ name: toKebabCase(member.name),
185
+ default: member.default,
186
+ fieldName: member.name,
187
+ type: { text: attributeValue },
188
+ deprecated: member.deprecated
189
+ })
190
+ }
191
+
192
+ if (hasTag(memberParsedJsDoc, "formProperty")) {
193
+ member._ui5formProperty = true;
194
+ }
195
+
196
+ const formEventsTag = findTag(memberParsedJsDoc, "formEvents");
197
+ if (formEventsTag) {
198
+ const tagValue = formEventsTag.description ? `${formEventsTag.name} ${formEventsTag.description}` : formEventsTag.name;
199
+ member._ui5formEvents = tagValue.trim().replaceAll(/\s+/g, ",");
200
+ }
201
+
202
+ const defaultTag = findTag(memberParsedJsDoc, "default");
203
+ if (defaultTag) {
204
+ const tagValue = defaultTag.source?.[0]?.tokens?.name || defaultTag.source?.[0]?.tokens?.description || defaultTag.source?.[0]?.tokens?.type || "";
205
+ member.default = tagValue;
206
+ }
207
+
208
+ if (member.privacy === "public" && !member.default) {
209
+ logDocumentationError(moduleDoc.path, `Missing default value for '${member.name}'.`)
210
+ }
211
+
212
+ // Getters are treated as fields so they should not have return, instead of return they should have default value defined with @default
213
+ if (member.readonly) {
214
+ if (member.privacy === "public" && !member.type) {
215
+ logDocumentationError(moduleDoc.path, `Missing return type for read-only field '${member.name}'.`)
216
+ }
217
+
218
+ delete member.return;
219
+ }
220
+ }
221
+ } else if (member.kind === "method") {
222
+ validateJSDocComment("method", memberParsedJsDoc, classNodeMember.name?.text, moduleDoc);
223
+
224
+ member.parameters?.forEach(param => {
225
+ // Treat every parameter that has respective @param tag as public
226
+ param._ui5privacy = findAllTags(memberParsedJsDoc, "param").some(tag => tag.name === param.name) ? "public" : "private";
227
+ if (param._ui5privacy === "public") {
228
+ const paramNode = classNodeMember.parameters?.find(parameter => parameter.name?.text === param.name);
229
+ let type;
230
+
231
+ if (param.optional) {
232
+ const filename = classNode.getSourceFile().fileName;
233
+
234
+ const sourceFile = typeProgram.getSourceFile(filename);
235
+ const tsProgramClassNode = sourceFile.statements.find(statement => ts.isClassDeclaration(statement) && statement.name?.text === classNode.name?.text);
236
+ const tsProgramMember = tsProgramClassNode.members.find(m => ts.isMethodDeclaration(m) && m.name?.text === member.name);
237
+ const tsProgramParameter = tsProgramMember.parameters.find(p => ts.isParameter(p) && p.name?.text === param.name);
238
+
239
+ if (tsProgramParameter) {
240
+ const typeName = typeChecker.typeToString(typeChecker.getTypeAtLocation(tsProgramParameter), tsProgramParameter);
241
+
242
+ if (!param.type) {
243
+ param.type = {};
244
+ param.type.text = typeName;
245
+ }
246
+
247
+ type = typeName.replaceAll(/Array<|>|\[\]/g, "")
248
+ ?.split("|");
249
+ }
250
+ }
251
+
252
+ const typeRefs = ((type || getTypeRefs(ts, (type || paramNode), param))
253
+ ?.map(typeRef => getReference(ts, typeRef, classNodeMember, moduleDoc.path)).filter(Boolean)) || [];
254
+
255
+ if (typeRefs.length) {
256
+ param.type.references = typeRefs;
257
+ }
258
+ }
259
+ });
260
+
261
+ if (member.return) {
262
+ const returnTag = findTag(memberParsedJsDoc, "returns");
263
+ member.return.description = returnTag?.description ? `${returnTag.name} ${returnTag.description}` : returnTag?.name;
264
+ member.return.type.text = formatArrays(classNodeMember?.type?.getFullText?.()?.trim());
265
+ const typeRefs = (getTypeRefs(ts, classNodeMember, member.return)
266
+ ?.map(typeRef => getReference(ts, typeRef, classNodeMember, moduleDoc.path)).filter(Boolean)) || [];
267
+
268
+ if (typeRefs.length) {
269
+ member.return.type.references = typeRefs;
270
+ }
271
+
272
+ if (member.privacy === "public" && !member.return.type.text) {
273
+ logDocumentationError(moduleDoc.path, `Missing return type for function '${member.name}'.`)
274
+ }
275
+ } else if (member.privacy === "public") {
276
+ logDocumentationError(moduleDoc.path, `Missing return type for function '${member.name}'.`)
277
+ }
278
+ }
279
+ }
280
+ }
281
+
282
+ function processInterface(ts, interfaceNode, moduleDoc) {
283
+ const interfaceJSdoc = interfaceNode?.jsDoc?.[0];
284
+ const interfaceName = interfaceNode?.name?.text;
285
+
286
+ if (!interfaceJSdoc) return;
287
+
288
+ const interfaceParsedJsDoc = parse(interfaceJSdoc?.getText(), { spacing: 'preserve' })[0];
289
+
290
+ validateJSDocComment("interface", interfaceParsedJsDoc, interfaceNode.name?.text, moduleDoc);
291
+
292
+ moduleDoc.declarations.push({
293
+ kind: "interface",
294
+ name: interfaceName,
295
+ description: normalizeDescription(interfaceParsedJsDoc?.description),
296
+ _ui5privacy: getPrivacyStatus(interfaceParsedJsDoc),
297
+ _ui5since: getSinceStatus(interfaceParsedJsDoc),
298
+ deprecated: getDeprecatedStatus(interfaceParsedJsDoc),
299
+ });
300
+ }
301
+
302
+ function processEnum(ts, enumNode, moduleDoc) {
303
+ const enumJSdoc = enumNode?.jsDoc?.[0];
304
+ const enumName = enumNode?.name?.text;
305
+
306
+ if (!enumJSdoc) return;
307
+
308
+ const enumParsedJsDoc = parse(enumJSdoc?.getText(), { spacing: 'preserve' })[0];
309
+
310
+ validateJSDocComment("enum", enumParsedJsDoc, enumNode.name?.text, moduleDoc);
311
+
312
+ const result = {
313
+ kind: "enum",
314
+ name: enumName,
315
+ description: normalizeDescription(enumJSdoc?.comment),
316
+ _ui5privacy: getPrivacyStatus(enumParsedJsDoc),
317
+ _ui5since: getSinceStatus(enumParsedJsDoc),
318
+ deprecated: getDeprecatedStatus(enumParsedJsDoc) || undefined,
319
+ members: (enumNode?.members || []).map(member => {
320
+ const memberJSdoc = member?.jsDoc?.[0];
321
+
322
+ if (!memberJSdoc) return;
323
+
324
+ const memberParsedJsDoc = parse(memberJSdoc?.getText())[0];
325
+
326
+ validateJSDocComment("enum", memberParsedJsDoc, member.name?.text, moduleDoc);
327
+
328
+ return {
329
+ kind: "field",
330
+ static: true,
331
+ privacy: getPrivacyStatus(memberParsedJsDoc),
332
+ _ui5since: getSinceStatus(memberParsedJsDoc),
333
+ description: memberJSdoc?.comment,
334
+ default: member.initializer?.text,
335
+ deprecated: getDeprecatedStatus(memberParsedJsDoc),
336
+ name: member.name?.text,
337
+ readonly: true,
338
+ };
339
+ }).filter(Boolean),
340
+ };
341
+
342
+ moduleDoc.declarations.push(result);
343
+ }
344
+
345
+ const processPublicAPI = object => {
346
+ if (!object) {
347
+ return true;
348
+ }
349
+ const keys = Object.keys(object);
350
+ if (!keys.includes("privacy") && !keys.includes("_ui5privacy")) {
351
+ return true;
352
+ }
353
+ for (const key of keys) {
354
+ if ((key === "privacy" && object[key] !== "public") || (key === "_ui5privacy" && object[key] !== "public")) {
355
+ return true;
356
+ } else if (typeof object[key] === "object") {
357
+ if (key === "cssParts" || key === "attributes" || key === "_ui5implements") {
358
+ continue;
359
+ }
360
+
361
+ if (Array.isArray(object[key])) {
362
+ for (let i = 0; i < object[key].length; i++) {
363
+ const shouldRemove = processPublicAPI(object[key][i]);
364
+ if (shouldRemove) {
365
+ object[key].splice(i, 1);
366
+ i--;
367
+ }
368
+ }
369
+ if (object[key].length === 0) {
370
+ delete object[key];
371
+ }
372
+ }
373
+ }
374
+ }
375
+ return false;
376
+ };
377
+
378
+ let typeChecker;
379
+ let typeProgram;
380
+
381
+ export default {
382
+ globs: ["src/!(*generated)/*.ts", "src/!(*bundle)*.ts"],
383
+ outdir: 'dist',
384
+ overrideModuleCreation: ({ ts, globs }) => {
385
+ typeProgram = ts.createProgram(globs, {
386
+ noEmitOnError: false,
387
+ allowJs: true,
388
+ experimentalDecorators: true,
389
+ target: 99,
390
+ downlevelIteration: true,
391
+ module: 99,
392
+ strictNullChecks: true,
393
+ moduleResolution: 2,
394
+ esModuleInterop: true,
395
+ noEmit: true,
396
+ pretty: true,
397
+ allowSyntheticDefaultImports: true,
398
+ allowUnreachableCode: true,
399
+ allowUnusedLabels: true,
400
+ skipLibCheck: true,
401
+ });
402
+ typeChecker = typeProgram.getTypeChecker();
403
+
404
+ return globs.map((glob) => {
405
+ const fullPath = path.resolve(process.cwd(), glob);
406
+ const source = fs.readFileSync(fullPath).toString();
407
+
408
+ return ts.createSourceFile(glob, source, ts.ScriptTarget.ES2015, true);
409
+ });
410
+ },
411
+ plugins: [
412
+ {
413
+ name: 'my-plugin',
414
+ analyzePhase({ ts, node, moduleDoc }) {
415
+ switch (true) {
416
+ case ts.isClassDeclaration(node):
417
+ processClass(ts, node, moduleDoc);
418
+ break;
419
+ case ts.isEnumDeclaration(node):
420
+ processEnum(ts, node, moduleDoc);
421
+ break;
422
+ case ts.isInterfaceDeclaration(node):
423
+ processInterface(ts, node, moduleDoc);
424
+ break;
425
+ }
426
+ },
427
+ moduleLinkPhase({ moduleDoc }) {
428
+ for (let i = 0; i < moduleDoc.declarations.length; i++) {
429
+ const shouldRemove = processPublicAPI(moduleDoc.declarations[i]) || ["function", "variable"].includes(moduleDoc.declarations[i].kind)
430
+ if (shouldRemove) {
431
+ moduleDoc.declarations.splice(i, 1);
432
+ i--;
433
+ }
434
+ }
435
+
436
+ moduleDoc.path = moduleDoc.path?.replace(/^src/, "dist").replace(/\.ts$/, ".js");
437
+
438
+ moduleDoc.exports = moduleDoc.exports.
439
+ filter(e => !(e.kind === "custom-element-definition" && !moduleDoc.declarations?.find(d => d.name === e.name)?.tagName))
440
+
441
+ moduleDoc.exports.forEach(e => {
442
+ const classNode = moduleDoc.declarations.find(c => c.name === e.declaration.name);
443
+
444
+ if (e.declaration && e.declaration.module) {
445
+ e.declaration.module = e.declaration.module.replace(/^src/, "dist").replace(/\.ts$/, ".js");
446
+ }
447
+
448
+ if (classNode?.customElement && classNode.tagName && e.kind !== "custom-element-definition") {
449
+ moduleDoc.exports.push({
450
+ kind: "custom-element-definition",
451
+ name: classNode.tagName,
452
+ declaration: {
453
+ name: e.declaration.name,
454
+ module: e.declaration.module
455
+ }
456
+ })
457
+ }
458
+ })
459
+
460
+ const typeReferences = new Set();
461
+ const registerTypeReference = reference => typeReferences.add(JSON.stringify(reference))
462
+
463
+ moduleDoc.declarations.forEach(declaration => {
464
+ ["events", "slots", "members"].forEach(memberType => {
465
+ declaration[memberType]?.forEach(member => {
466
+ if (member.type?.references) {
467
+ member.type.references.forEach(registerTypeReference)
468
+ } else if (member._ui5type?.references) {
469
+ member._ui5type.references.forEach(registerTypeReference)
470
+ } else if (member.kind === "method") {
471
+ member.return?.type?.references?.forEach(registerTypeReference)
472
+
473
+ member.parameters?.forEach(parameter => {
474
+ parameter.type?.references?.forEach(registerTypeReference)
475
+ })
476
+ }
477
+ })
478
+ })
479
+ });
480
+
481
+ typeReferences.forEach(reference => {
482
+ reference = JSON.parse(reference);
483
+ if (reference.package === packageJSON?.name && reference.module === moduleDoc.path) {
484
+ const hasExport = moduleDoc.exports.some(e => e.declaration?.name === reference.name && e.declaration?.module === reference.module)
485
+
486
+ if (!hasExport) {
487
+ logDocumentationError(moduleDoc.path?.replace(/^dist/, "src").replace(/\.js$/, ".ts"), `Type '${reference.name}' is used to describe a public API but is not exported.`,)
488
+ }
489
+ }
490
+ })
491
+ },
492
+ packageLinkPhase({ context }) {
493
+ if (context.dev) {
494
+ displayDocumentationErrors();
495
+ }
496
+ }
497
+ },
498
+ generateCustomData({ outdir: "dist", cssFileName: null, cssPropertiesDocs: false }),
499
+ customElementJetBrainsPlugin({ outdir: "dist", cssFileName: null, cssPropertiesDocs: false })
500
+ ],
501
+ };