@ui5/webcomponents-tools 0.0.0-f651a470c → 0.0.0-f6676abdd

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 (70) hide show
  1. package/CHANGELOG.md +1346 -0
  2. package/README.md +3 -5
  3. package/assets-meta.js +11 -10
  4. package/components-package/cypress/support/commands.js +66 -0
  5. package/components-package/cypress/support/component-index.html +17 -0
  6. package/components-package/cypress/support/component.d.ts +22 -0
  7. package/components-package/cypress/support/component.js +46 -0
  8. package/components-package/cypress/support/cypress-ct-preact.js +11 -0
  9. package/components-package/cypress.config.js +33 -0
  10. package/components-package/eslint.js +94 -28
  11. package/components-package/nps.js +58 -47
  12. package/components-package/postcss.components.js +1 -21
  13. package/components-package/postcss.themes.js +1 -26
  14. package/components-package/vite.config.js +7 -11
  15. package/components-package/wdio.js +415 -393
  16. package/icons-collection/nps.js +9 -7
  17. package/lib/amd-to-es6/index.js +102 -0
  18. package/lib/amd-to-es6/no-remaining-require.js +33 -0
  19. package/lib/cem/custom-elements-manifest.config.mjs +544 -0
  20. package/lib/cem/event.mjs +168 -0
  21. package/lib/cem/schema-internal.json +1413 -0
  22. package/lib/cem/schema.json +1098 -0
  23. package/lib/cem/types-internal.d.ts +808 -0
  24. package/lib/cem/types.d.ts +736 -0
  25. package/lib/cem/utils.mjs +423 -0
  26. package/lib/cem/validate.js +70 -0
  27. package/lib/create-icons/index.js +8 -6
  28. package/lib/create-illustrations/index.js +51 -30
  29. package/lib/create-new-component/{tsFileContentTemplate.js → Component.js} +15 -25
  30. package/lib/create-new-component/ComponentTemplate.js +12 -0
  31. package/lib/create-new-component/index.js +35 -73
  32. package/lib/css-processors/css-processor-components.mjs +77 -0
  33. package/lib/css-processors/css-processor-themes.mjs +74 -0
  34. package/lib/css-processors/scope-variables.mjs +49 -0
  35. package/lib/css-processors/shared.mjs +56 -0
  36. package/lib/dev-server/custom-hot-update-plugin.js +39 -0
  37. package/lib/dev-server/{dev-server.js → dev-server.mjs} +4 -4
  38. package/lib/dev-server/virtual-index-html-plugin.js +24 -20
  39. package/lib/generate-js-imports/illustrations.js +78 -64
  40. package/lib/generate-json-imports/i18n.js +45 -61
  41. package/lib/generate-json-imports/themes.js +16 -33
  42. package/lib/hbs2lit/src/compiler.js +9 -6
  43. package/lib/hbs2lit/src/litVisitor2.js +42 -17
  44. package/lib/hbs2lit/src/svgProcessor.js +12 -5
  45. package/lib/hbs2ui5/RenderTemplates/LitRenderer.js +39 -6
  46. package/lib/hbs2ui5/index.js +23 -6
  47. package/lib/i18n/defaults.js +3 -2
  48. package/lib/postcss-combine-duplicated-selectors/index.js +12 -5
  49. package/lib/remove-dev-mode/remove-dev-mode.mjs +37 -0
  50. package/lib/scoping/get-all-tags.js +10 -3
  51. package/lib/scoping/lint-src.js +8 -7
  52. package/lib/scoping/scope-test-pages.js +2 -1
  53. package/lib/test-runner/test-runner.js +2 -2
  54. package/package.json +25 -13
  55. package/tsconfig.json +18 -0
  56. package/types/index.d.ts +1 -0
  57. package/components-package/wdio.sync.js +0 -360
  58. package/lib/create-new-component/jsFileContentTemplate.js +0 -77
  59. package/lib/esm-abs-to-rel/index.js +0 -58
  60. package/lib/generate-custom-elements-manifest/index.js +0 -327
  61. package/lib/jsdoc/config.json +0 -29
  62. package/lib/jsdoc/configTypescript.json +0 -29
  63. package/lib/jsdoc/plugin.js +0 -2468
  64. package/lib/jsdoc/preprocess.js +0 -146
  65. package/lib/jsdoc/template/publish.js +0 -4120
  66. package/lib/postcss-css-to-esm/index.js +0 -90
  67. package/lib/postcss-css-to-json/index.js +0 -47
  68. package/lib/postcss-new-files/index.js +0 -36
  69. package/lib/postcss-p/postcss-p.mjs +0 -14
  70. package/lib/replace-global-core/index.js +0 -25
@@ -0,0 +1,168 @@
1
+ import { parse } from "comment-parser";
2
+ import {
3
+ getPrivacyStatus,
4
+ getDeprecatedStatus,
5
+ getSinceStatus,
6
+ getType,
7
+ getTypeRefs,
8
+ validateJSDocComment,
9
+ hasTag,
10
+ findTag,
11
+ findAllTags,
12
+ getReference,
13
+ normalizeDescription,
14
+ normalizeTagType,
15
+ logDocumentationError
16
+ } from "./utils.mjs";
17
+
18
+ const jsDocRegExp = /\/\*\*(.|\n)+?\s+\*\//;
19
+ const ASTFalseKeywordCode = 94;
20
+
21
+ const getParams = (ts, eventDetails, commentParams, classNode, moduleDoc) => {
22
+ return commentParams?.map(commentParam => {
23
+ const { typeName, name } = getType(normalizeTagType(commentParam?.type));
24
+ let type;
25
+
26
+ if (typeName) {
27
+ type = { text: typeName };
28
+
29
+ let typeRefs = name?.split("|")
30
+ ?.map(e => getReference(ts, e.trim(), classNode, moduleDoc.path))
31
+ .filter(Boolean);
32
+
33
+ if (typeRefs?.length) {
34
+ type.references = typeRefs;
35
+ }
36
+ }
37
+
38
+ return {
39
+ type,
40
+ name: commentParam?.name,
41
+ _ui5privacy: "public",
42
+ description: normalizeDescription(commentParam?.description),
43
+ };
44
+ });
45
+ };
46
+
47
+ function processEvent(ts, event, classNode, moduleDoc) {
48
+ const name = event?.expression?.arguments?.[0]?.text;
49
+ const result = {
50
+ name,
51
+ _ui5privacy: "private",
52
+ type: { text: "CustomEvent" }
53
+ };
54
+
55
+ const comment = event.getFullText?.().match(jsDocRegExp)?.[0];
56
+
57
+ if (!comment) {
58
+ return result;
59
+ }
60
+
61
+ const eventParsedComment = parse(comment, { spacing: 'preserve' })[0];
62
+
63
+ validateJSDocComment("event", eventParsedComment, name, moduleDoc);
64
+
65
+ const deprecatedTag = findTag(eventParsedComment, "deprecated");
66
+ const privacy = findTag(eventParsedComment, ["public", "private", "protected"])?.tag || "private";
67
+ const sinceTag = findTag(eventParsedComment, "since");
68
+ const commentParams = findAllTags(eventParsedComment, "param");
69
+ const description = normalizeDescription(eventParsedComment?.description);
70
+ const native = hasTag(eventParsedComment, "native");
71
+ const eventArgs = event?.expression?.arguments;
72
+ let eventBubbles;
73
+ let eventCancelable;
74
+ let eventDetails;
75
+
76
+ eventArgs && eventArgs.forEach(arg => {
77
+ arg.properties?.forEach(prop => {
78
+ if (prop.name?.text === "bubbles") {
79
+ eventBubbles = prop.initializer.kind === ASTFalseKeywordCode ? false : true;
80
+ } else if (prop.name?.text === "cancelable") {
81
+ eventCancelable = prop.initializer.kind === ASTFalseKeywordCode ? false : true;
82
+ } else if (prop.name?.text === "detail") {
83
+ eventDetails = prop.initializer?.properties;
84
+ }
85
+ });
86
+ });
87
+
88
+ result.description = description;
89
+ result._ui5Cancelable = eventCancelable !== undefined ? eventCancelable : false;
90
+ result._ui5allowPreventDefault = result._ui5Cancelable;
91
+ result._ui5Bubbles = eventBubbles !== undefined ? eventBubbles : false;
92
+
93
+ if (native) {
94
+ result.type = { text: "Event" };
95
+ }
96
+
97
+ if (privacy) {
98
+ result._ui5privacy = privacy;
99
+ }
100
+
101
+ if (deprecatedTag?.name) {
102
+ result.deprecated = deprecatedTag.description
103
+ ? `${deprecatedTag.name} ${deprecatedTag.description}`
104
+ : deprecatedTag.name;
105
+ } else if (deprecatedTag) {
106
+ result.deprecated = true;
107
+ }
108
+
109
+ if (sinceTag?.name) {
110
+ result._ui5since = sinceTag?.description
111
+ ? `${sinceTag.name} ${sinceTag.description}`
112
+ : sinceTag.name;
113
+ }
114
+
115
+ const eventDetailType = classNode.members?.find(member => {
116
+ return ts.isPropertyDeclaration(member) && member.name.text === "eventDetails"
117
+ })?.type;
118
+ const eventDetailRef = eventDetailType?.members?.find(member => member.name.text === name) || eventDetailType?.types?.[eventDetailType?.types?.length - 1]?.members?.find(member => member.name.text === name);
119
+ const hasGeneric = !!event?.expression?.typeArguments
120
+
121
+ if (commentParams.length) {
122
+ if (eventDetailRef && hasGeneric) {
123
+ logDocumentationError(moduleDoc.path, `Event details for event '${name}' has to be defined either with generic or with eventDetails.`)
124
+ } else if (eventDetails) {
125
+ if (hasGeneric) {
126
+ const typesText = event?.expression?.typeArguments.map(type => type.typeName?.text).filter(Boolean).join(" | ");
127
+ const typeRefs = (getTypeRefs(ts, event.expression)
128
+ ?.map(e => getReference(ts, e, event, moduleDoc.path)).filter(Boolean)) || [];
129
+
130
+ result.type = { text: `CustomEvent<${typesText}>` };
131
+
132
+ if (typeRefs.length) {
133
+ result.type.references = typeRefs;
134
+ }
135
+ } else if (eventDetailRef) {
136
+ const typesText = eventDetailRef?.type?.typeName?.text;
137
+ const typeRefs = (getTypeRefs(ts, eventDetailRef)
138
+ ?.map(e => getReference(ts, e, event, moduleDoc.path)).filter(Boolean)) || [];
139
+
140
+ result.type = { text: `CustomEvent<${typesText}>` };
141
+
142
+ if (typeRefs.length) {
143
+ result.type.references = typeRefs;
144
+ }
145
+ } else {
146
+ logDocumentationError(moduleDoc.path, `Event details for event '${name}' must be described using generics. Add type via generics to the decorator: @event<TypeForDetails>("${name}", {details}).`)
147
+ }
148
+ } else if (eventDetailRef) {
149
+ const typesText = eventDetailRef?.type?.typeName?.text;
150
+ const typeRefs = (getTypeRefs(ts, eventDetailRef)
151
+ ?.map(e => getReference(ts, e, event, moduleDoc.path)).filter(Boolean)) || [];
152
+
153
+ result.type = { text: `CustomEvent<${typesText}>` };
154
+
155
+ if (typeRefs.length) {
156
+ result.type.references = typeRefs;
157
+ }
158
+ } else {
159
+ logDocumentationError(moduleDoc.path, `Event details for event '${name}' must be described.`)
160
+ }
161
+
162
+ result._ui5parameters = getParams(ts, eventDetails, commentParams, classNode, moduleDoc);
163
+ }
164
+
165
+ return result;
166
+ }
167
+
168
+ export default processEvent;