@skyux/docs-tools 9.0.0-alpha.0 → 9.0.0-alpha.1

package/esm2022/modules/type-definitions/typedoc-types.mjs

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZWRvYy10eXBlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3Byb2plY3RzL2RvY3MtdG9vbHMvc3JjL21vZHVsZXMvdHlwZS1kZWZpbml0aW9ucy90eXBlZG9jLXR5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgaW50ZXJmYWNlIFR5cGVEb2NDb21tZW50IHtcbiAgc2hvcnRUZXh0Pzogc3RyaW5nO1xuXG4gIHRhZ3M/OiB7XG4gICAgcGFyYW0/OiBzdHJpbmc7XG4gICAgdGFnOlxuICAgICAgfCAnZGVmYXVsdCdcbiAgICAgIHwgJ2RlZmF1bHRWYWx1ZSdcbiAgICAgIHwgJ2RlcHJlY2F0ZWQnXG4gICAgICB8ICdleGFtcGxlJ1xuICAgICAgfCAncGFyYW0nXG4gICAgICB8ICdyZXF1aXJlZCc7XG4gICAgdGV4dDogc3RyaW5nO1xuICB9W107XG5cbiAgdGV4dD86IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUeXBlRG9jU291cmNlIHtcbiAgZmlsZU5hbWU6IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUeXBlRG9jU2lnbmF0dXJlIHtcbiAgY29tbWVudD86IFR5cGVEb2NDb21tZW50O1xuXG4gIGtpbmRTdHJpbmc/OiAnQ2FsbCBzaWduYXR1cmUnIHwgJ0NvbnN0cnVjdG9yIHNpZ25hdHVyZScgfCAnSW5kZXggc2lnbmF0dXJlJztcblxuICBuYW1lOiBzdHJpbmc7XG5cbiAgcGFyYW1ldGVycz86IFR5cGVEb2NQYXJhbWV0ZXJbXTtcblxuICByZXR1cm5UeXBlPzogVHlwZURvY1R5cGU7XG5cbiAgdHlwZT86IFR5cGVEb2NUeXBlO1xuXG4gIHR5cGVQYXJhbWV0ZXI/OiBUeXBlRG9jVHlwZVBhcmFtZXRlcltdO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFR5cGVEb2NUeXBlUGFyYW1ldGVyIHtcbiAgbmFtZTogc3RyaW5nO1xuICBraW5kU3RyaW5nOiAnVHlwZSBwYXJhbWV0ZXInO1xuICB0eXBlPzogVHlwZURvY1R5cGU7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVHlwZURvY1R5cGUge1xuICBjb25zdHJhaW50Pzoge1xuICAgIG5hbWU6IHN0cmluZztcbiAgfTtcblxuICBjYWxsU2lnbmF0dXJlPzogVHlwZURvY1NpZ25hdHVyZTtcblxuICBkZWNsYXJhdGlvbj86IHtcbiAgICBjaGlsZHJlbj86IFR5cGVEb2NFbnRyeUNoaWxkW107XG4gICAgaW5kZXhTaWduYXR1cmU/OiBUeXBlRG9jU2lnbmF0dXJlO1xuICAgIHNpZ25hdHVyZXM/OiBUeXBlRG9jU2lnbmF0dXJlW107XG4gIH07XG5cbiAgZWxlbWVudFR5cGU/OiBUeXBlRG9jVHlwZTtcblxuICBuYW1lPzogc3RyaW5nO1xuXG4gIG9wZXJhdG9yPzogJ2tleW9mJztcblxuICB0YXJnZXQ/OiB7XG4gICAgbmFtZTogc3RyaW5nO1xuICB9O1xuXG4gIHR5cGU/OlxuICAgIHwgJ2FycmF5J1xuICAgIHwgJ2ludHJpbnNpYydcbiAgICB8ICdsaXRlcmFsJ1xuICAgIHwgJ3JlZmVyZW5jZSdcbiAgICB8ICdyZWZsZWN0aW9uJ1xuICAgIHwgJ3R5cGVQYXJhbWV0ZXInXG4gICAgfCAndHlwZU9wZXJhdG9yJ1xuICAgIHwgJ3VuaW9uJ1xuICAgIHwgJ3Vua25vd24nO1xuXG4gIHR5cGVBcmd1bWVudHM/OiBUeXBlRG9jVHlwZVtdO1xuXG4gIHR5cGVzPzogVHlwZURvY1R5cGVbXTtcblxuICB2YWx1ZT86IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUeXBlRG9jUGFyYW1ldGVyIHtcbiAgY29tbWVudD86IFR5cGVEb2NDb21tZW50O1xuXG4gIGRlZmF1bHRWYWx1ZT86IHN0cmluZztcblxuICBraW5kU3RyaW5nOiAnUGFyYW1ldGVyJztcblxuICBuYW1lOiBzdHJpbmc7XG5cbiAgdHlwZTogVHlwZURvY1R5cGU7XG5cbiAgZmxhZ3M/OiB7XG4gICAgaXNPcHRpb25hbD86IGJvb2xlYW47XG4gIH07XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVHlwZURvY0VudHJ5Q2hpbGQge1xuICBjb21tZW50PzogVHlwZURvY0NvbW1lbnQ7XG5cbiAgZGVjb3JhdG9ycz86IHtcbiAgICBhcmd1bWVudHM/OiB7XG4gICAgICBiaW5kaW5nUHJvcGVydHlOYW1lPzogc3RyaW5nO1xuICAgIH07XG4gICAgbmFtZTogJ0lucHV0JyB8ICdPdXRwdXQnO1xuICAgIHR5cGU6IFR5cGVEb2NUeXBlO1xuICB9W107XG5cbiAgZGVmYXVsdFZhbHVlPzogc3RyaW5nO1xuXG4gIGZsYWdzPzoge1xuICAgIGlzT3B0aW9uYWw/OiBib29sZWFuO1xuICAgIGlzU3RhdGljPzogYm9vbGVhbjtcbiAgfTtcblxuICBraW5kU3RyaW5nPzpcbiAgICB8ICdBY2Nlc3NvcidcbiAgICB8ICdDYWxsIHNpZ25hdHVyZSdcbiAgICB8ICdDb25zdHJ1Y3RvcidcbiAgICB8ICdDb25zdHJ1Y3RvciBzaWduYXR1cmUnXG4gICAgfCAnSW5kZXggc2lnbmF0dXJlJ1xuICAgIHwgJ0VudW1lcmF0aW9uIG1lbWJlcidcbiAgICB8ICdQYXJhbWV0ZXInXG4gICAgfCAnUHJvcGVydHknXG4gICAgfCAnTWV0aG9kJztcblxuICBnZXRTaWduYXR1cmU/OiB7XG4gICAgY29tbWVudDogVHlwZURvY0NvbW1lbnQ7XG4gICAgbmFtZTogc3RyaW5nO1xuICAgIHR5cGU6IFR5cGVEb2NUeXBlO1xuICB9W107XG5cbiAgbmFtZT86IHN0cmluZztcblxuICBzZXRTaWduYXR1cmU/OiB7XG4gICAgY29tbWVudDogVHlwZURvY0NvbW1lbnQ7XG4gICAgbmFtZTogc3RyaW5nO1xuICAgIHBhcmFtZXRlcnM/OiBUeXBlRG9jUGFyYW1ldGVyW107XG4gICAgdHlwZTogVHlwZURvY1R5cGU7XG4gIH1bXTtcblxuICBzaWduYXR1cmVzPzogVHlwZURvY1NpZ25hdHVyZVtdO1xuXG4gIHNvdXJjZXM/OiBUeXBlRG9jU291cmNlW107XG5cbiAgdHlwZT86IFR5cGVEb2NUeXBlO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFR5cGVEb2NFbnRyeSB7XG4gIGFuY2hvcklkPzogc3RyaW5nO1xuXG4gIGNoaWxkcmVuPzogVHlwZURvY0VudHJ5Q2hpbGRbXTtcblxuICBjb21tZW50PzogVHlwZURvY0NvbW1lbnQ7XG5cbiAgZGVjb3JhdG9ycz86IHtcbiAgICBhcmd1bWVudHM/OiB7XG4gICAgICBvYmo/OiBzdHJpbmc7XG4gICAgfTtcbiAgICBuYW1lOiAnQ29tcG9uZW50JyB8ICdEaXJlY3RpdmUnIHwgJ0luamVjdGFibGUnIHwgJ05nTW9kdWxlJyB8ICdQaXBlJztcbiAgICB0eXBlOiBUeXBlRG9jVHlwZTtcbiAgfVtdO1xuXG4gIGtpbmRTdHJpbmc/OiAnQ2xhc3MnIHwgJ0VudW1lcmF0aW9uJyB8ICdJbnRlcmZhY2UnIHwgJ1R5cGUgYWxpYXMnO1xuXG4gIGluZGV4U2lnbmF0dXJlPzogVHlwZURvY1NpZ25hdHVyZTtcblxuICBuYW1lPzogc3RyaW5nO1xuXG4gIHNvdXJjZXM/OiBUeXBlRG9jU291cmNlW107XG5cbiAgdHlwZT86IFR5cGVEb2NUeXBlO1xuXG4gIHR5cGVQYXJhbWV0ZXI/OiBUeXBlRG9jVHlwZVBhcmFtZXRlcltdO1xufVxuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZWRvYy10eXBlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3Byb2plY3RzL2RvY3MtdG9vbHMvc3JjL21vZHVsZXMvdHlwZS1kZWZpbml0aW9ucy90eXBlZG9jLXR5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgaW50ZXJmYWNlIFR5cGVEb2NDb21tZW50IHtcbiAgc3VtbWFyeT86IHsga2luZDogc3RyaW5nOyB0ZXh0OiBzdHJpbmcgfVtdO1xuXG4gIGJsb2NrVGFncz86IHtcbiAgICBwYXJhbT86IHN0cmluZztcbiAgICBjb250ZW50PzogeyBraW5kOiBzdHJpbmc7IHRleHQ6IHN0cmluZyB9W107XG4gICAgdGFnOlxuICAgICAgfCAnQGRlZmF1bHQnXG4gICAgICB8ICdAZGVmYXVsdFZhbHVlJ1xuICAgICAgfCAnQGRlcHJlY2F0ZWQnXG4gICAgICB8ICdAZXhhbXBsZSdcbiAgICAgIHwgJ0BwYXJhbSdcbiAgICAgIHwgJ0ByZXF1aXJlZCc7XG4gIH1bXTtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUeXBlRG9jU291cmNlIHtcbiAgZmlsZU5hbWU6IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUeXBlRG9jU2lnbmF0dXJlIHtcbiAgY29tbWVudD86IFR5cGVEb2NDb21tZW50O1xuXG4gIGtpbmRTdHJpbmc/OiAnQ2FsbCBzaWduYXR1cmUnIHwgJ0NvbnN0cnVjdG9yIHNpZ25hdHVyZScgfCAnSW5kZXggc2lnbmF0dXJlJztcblxuICBuYW1lOiBzdHJpbmc7XG5cbiAgcGFyYW1ldGVycz86IFR5cGVEb2NQYXJhbWV0ZXJbXTtcblxuICByZXR1cm5UeXBlPzogVHlwZURvY1R5cGU7XG5cbiAgdHlwZT86IFR5cGVEb2NUeXBlO1xuXG4gIHR5cGVQYXJhbWV0ZXI/OiBUeXBlRG9jVHlwZVBhcmFtZXRlcltdO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIFR5cGVEb2NUeXBlUGFyYW1ldGVyIHtcbiAgbmFtZTogc3RyaW5nO1xuICBraW5kU3RyaW5nOiAnVHlwZSBwYXJhbWV0ZXInO1xuICB0eXBlPzogVHlwZURvY1R5cGU7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVHlwZURvY1R5cGUge1xuICBjb25zdHJhaW50Pzoge1xuICAgIG5hbWU6IHN0cmluZztcbiAgfTtcblxuICBjYWxsU2lnbmF0dXJlPzogVHlwZURvY1NpZ25hdHVyZTtcblxuICBkZWNsYXJhdGlvbj86IHtcbiAgICBjaGlsZHJlbj86IFR5cGVEb2NFbnRyeUNoaWxkW107XG4gICAgaW5kZXhTaWduYXR1cmU/OiBUeXBlRG9jU2lnbmF0dXJlO1xuICAgIHNpZ25hdHVyZXM/OiBUeXBlRG9jU2lnbmF0dXJlW107XG4gIH07XG5cbiAgZWxlbWVudFR5cGU/OiBUeXBlRG9jVHlwZTtcblxuICBuYW1lPzogc3RyaW5nO1xuXG4gIG9wZXJhdG9yPzogJ2tleW9mJztcblxuICB0YXJnZXQ/OiB7XG4gICAgbmFtZTogc3RyaW5nO1xuICB9O1xuXG4gIHR5cGU/OlxuICAgIHwgJ2FycmF5J1xuICAgIHwgJ2ludHJpbnNpYydcbiAgICB8ICdsaXRlcmFsJ1xuICAgIHwgJ3JlZmVyZW5jZSdcbiAgICB8ICdyZWZsZWN0aW9uJ1xuICAgIHwgJ3R5cGVQYXJhbWV0ZXInXG4gICAgfCAndHlwZU9wZXJhdG9yJ1xuICAgIHwgJ3VuaW9uJ1xuICAgIHwgJ3Vua25vd24nO1xuXG4gIHR5cGVBcmd1bWVudHM/OiBUeXBlRG9jVHlwZVtdO1xuXG4gIHR5cGVzPzogVHlwZURvY1R5cGVbXTtcblxuICB2YWx1ZT86IHN0cmluZztcbn1cblxuZXhwb3J0IGludGVyZmFjZSBUeXBlRG9jUGFyYW1ldGVyIHtcbiAgY29tbWVudD86IFR5cGVEb2NDb21tZW50O1xuXG4gIGRlZmF1bHRWYWx1ZT86IHN0cmluZztcblxuICBraW5kU3RyaW5nOiAnUGFyYW1ldGVyJztcblxuICBuYW1lOiBzdHJpbmc7XG5cbiAgdHlwZTogVHlwZURvY1R5cGU7XG5cbiAgZmxhZ3M/OiB7XG4gICAgaXNPcHRpb25hbD86IGJvb2xlYW47XG4gIH07XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVHlwZURvY0VudHJ5Q2hpbGQge1xuICBjb21tZW50PzogVHlwZURvY0NvbW1lbnQ7XG5cbiAgZGVjb3JhdG9ycz86IHtcbiAgICBhcmd1bWVudHM/OiB7XG4gICAgICBiaW5kaW5nUHJvcGVydHlOYW1lPzogc3RyaW5nO1xuICAgIH07XG4gICAgbmFtZTogJ0lucHV0JyB8ICdPdXRwdXQnO1xuICAgIHR5cGU6IFR5cGVEb2NUeXBlO1xuICB9W107XG5cbiAgZGVmYXVsdFZhbHVlPzogc3RyaW5nO1xuXG4gIGZsYWdzPzoge1xuICAgIGlzT3B0aW9uYWw/OiBib29sZWFuO1xuICAgIGlzU3RhdGljPzogYm9vbGVhbjtcbiAgfTtcblxuICBraW5kU3RyaW5nPzpcbiAgICB8ICdBY2Nlc3NvcidcbiAgICB8ICdDYWxsIHNpZ25hdHVyZSdcbiAgICB8ICdDb25zdHJ1Y3RvcidcbiAgICB8ICdDb25zdHJ1Y3RvciBzaWduYXR1cmUnXG4gICAgfCAnSW5kZXggc2lnbmF0dXJlJ1xuICAgIHwgJ0VudW1lcmF0aW9uIG1lbWJlcidcbiAgICB8ICdQYXJhbWV0ZXInXG4gICAgfCAnUHJvcGVydHknXG4gICAgfCAnTWV0aG9kJztcblxuICBnZXRTaWduYXR1cmU/OiB7XG4gICAgY29tbWVudDogVHlwZURvY0NvbW1lbnQ7XG4gICAgbmFtZTogc3RyaW5nO1xuICAgIHR5cGU6IFR5cGVEb2NUeXBlO1xuICB9O1xuXG4gIG5hbWU/OiBzdHJpbmc7XG5cbiAgc2V0U2lnbmF0dXJlPzoge1xuICAgIGNvbW1lbnQ6IFR5cGVEb2NDb21tZW50O1xuICAgIG5hbWU6IHN0cmluZztcbiAgICBwYXJhbWV0ZXJzPzogVHlwZURvY1BhcmFtZXRlcltdO1xuICAgIHR5cGU6IFR5cGVEb2NUeXBlO1xuICB9O1xuXG4gIHNpZ25hdHVyZXM/OiBUeXBlRG9jU2lnbmF0dXJlW107XG5cbiAgc291cmNlcz86IFR5cGVEb2NTb3VyY2VbXTtcblxuICB0eXBlPzogVHlwZURvY1R5cGU7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVHlwZURvY0VudHJ5IHtcbiAgYW5jaG9ySWQ/OiBzdHJpbmc7XG5cbiAgY2hpbGRyZW4/OiBUeXBlRG9jRW50cnlDaGlsZFtdO1xuXG4gIGNvbW1lbnQ/OiBUeXBlRG9jQ29tbWVudDtcblxuICBkZWNvcmF0b3JzPzoge1xuICAgIGFyZ3VtZW50cz86IHtcbiAgICAgIG9iaj86IHN0cmluZztcbiAgICB9O1xuICAgIG5hbWU6ICdDb21wb25lbnQnIHwgJ0RpcmVjdGl2ZScgfCAnSW5qZWN0YWJsZScgfCAnTmdNb2R1bGUnIHwgJ1BpcGUnO1xuICAgIHR5cGU6IFR5cGVEb2NUeXBlO1xuICB9W107XG5cbiAga2luZFN0cmluZz86ICdDbGFzcycgfCAnRW51bWVyYXRpb24nIHwgJ0ludGVyZmFjZScgfCAnVHlwZSBhbGlhcyc7XG5cbiAgaW5kZXhTaWduYXR1cmU/OiBUeXBlRG9jU2lnbmF0dXJlO1xuXG4gIG5hbWU/OiBzdHJpbmc7XG5cbiAgc291cmNlcz86IFR5cGVEb2NTb3VyY2VbXTtcblxuICB0eXBlPzogVHlwZURvY1R5cGU7XG5cbiAgdHlwZVBhcmFtZXRlcj86IFR5cGVEb2NUeXBlUGFyYW1ldGVyW107XG59XG4iXX0=

package/fesm2022/skyux-docs-tools.mjs

@@ -1479,9 +1479,7 @@ class SkyDocsTypeDefinitionsFormatService {
     escapeSpecialCharacters(value) {
         return value.replace(/</g, '&lt;').replace(/>/g, '&gt;');
     }
-    getFormattedCallSignature(callSignature, config = {
-        escapeSpecialCharacters: true,
-    }) {
+    getFormattedCallSignature(callSignature, config) {
         const returnType = this.getFormattedType(callSignature.returnType, config);
         if (!callSignature.parameters) {
             return `() => ${returnType}`;
@@ -2311,7 +2309,14 @@ class SkyDocsTypeDocAdapterService {
             return [];
         }
         const definitions = entry.children
-            .filter((child) => child.kindString === 'Property' || child.kindString === 'Accessor')
+            .filter((child) => 
+        // We only want properties (both with or without a getter/setter)
+        child.kindString === 'Property' || child.kindString === 'Accessor')
+            .filter((child) => 
+        // We only want accessors that don't have a setter if they are not inputs
+        child.kindString !== 'Accessor' ||
+            child.setSignature ||
+            this.getDecorator(child)?.name !== 'Input')
             .map((child) => {
             let definition = {
                 isOptional: true,
@@ -2321,18 +2326,21 @@ class SkyDocsTypeDocAdapterService {
             let defaultValue;
             /* Ensure we are properly capturing definitions which use a getter/setter. Final check is a sanity check */
             if (child.kindString === 'Accessor' &&
-                !child.comment?.shortText &&
-                (child.setSignature?.length > 0 || child.getSignature.length > 0)) {
+                !child.comment?.summary
+                    ?.map((item) => item.text)
+                    .join('')
+                    .trim() &&
+                (child.setSignature || child.getSignature)) {
                 const mainTags = this.getCommentTags(child.comment);
                 this.applyCommentTagValues(definition, mainTags);
-                if (child.getSignature?.length > 0) {
-                    const getTags = this.getCommentTags(child.getSignature[0].comment);
+                if (child.getSignature) {
+                    const getTags = this.getCommentTags(child.getSignature.comment);
                     definition.isOptional = !getTags.extras.required;
                     this.applyCommentTagValues(definition, getTags);
                     defaultValue = this.getDefaultValue(child, getTags);
                 }
-                if (child.setSignature?.length > 0) {
-                    const setTags = this.getCommentTags(child.setSignature[0].comment);
+                if (child.setSignature) {
+                    const setTags = this.getCommentTags(child.setSignature.comment);
                     this.applyCommentTagValues(definition, setTags);
                     definition.isOptional =
                         definition.isOptional && !setTags.extras.required;
@@ -2346,7 +2354,10 @@ class SkyDocsTypeDocAdapterService {
             else {
                 let tags;
                 if (child.kindString === 'Property' &&
-                    !child.comment?.shortText &&
+                    !child.comment?.summary
+                        ?.map((item) => item.text)
+                        .join('')
+                        .trim() &&
                     child.type.declaration?.signatures?.length > 0 &&
                     child.type.declaration.signatures[0].comment) {
                     tags = this.getCommentTags(child.type.declaration.signatures[0].comment);
@@ -2419,6 +2430,10 @@ class SkyDocsTypeDocAdapterService {
             if (child.kindString === 'Method' && child.signatures.length > 0) {
                 tags = this.getCommentTags(child.signatures[0].comment);
             }
+            else if (child.type.type === 'reflection' &&
+                child.type?.declaration?.signatures?.length > 0) {
+                tags = this.getCommentTags(child.type.declaration.signatures[0].comment);
+            }
             else {
                 tags = this.getCommentTags(child.comment);
             }
@@ -2466,9 +2481,9 @@ class SkyDocsTypeDocAdapterService {
         switch (kindString) {
             case 'Accessor':
                 if (child.setSignature) {
-                    return this.getTypeDefinition(child.setSignature[0].parameters[0]);
+                    return this.getTypeDefinition(child.setSignature.parameters[0]);
                 }
-                return this.getTypeDefinition(child.getSignature[0]);
+                return this.getTypeDefinition(child.getSignature);
             case 'Method':
                 definition = {
                     callSignature: this.getCallSignatureDefinition(child.signatures[0], this.getCommentTags(child.comment)),
@@ -2599,38 +2614,58 @@ class SkyDocsTypeDocAdapterService {
         let parameters;
         const extras = {};
         if (comment) {
-            if (comment.tags) {
-                comment.tags.forEach((tag) => {
+            if (comment.blockTags) {
+                comment.blockTags.forEach((tag) => {
                     switch (tag.tag) {
-                        case 'deprecated':
-                            deprecationWarning = tag.text.trim();
+                        case '@deprecated':
+                            deprecationWarning = tag.content
+                                .map((item) => item.text)
+                                .join('')
+                                .trim();
                             break;
-                        case 'default':
-                        case 'defaultValue':
-                            defaultValue = tag.text.trim();
+                        case '@default':
+                        case '@defaultValue':
+                            defaultValue = tag.content
+                                .map((item) => item.text)
+                                .join('')
+                                .trim();
                             break;
-                        case 'example':
-                            codeExample = tag.text.trim().split('```')[1].trim();
+                        case '@example':
+                            codeExample = tag.content
+                                .map((item) => item.text)
+                                .join('')
+                                .trim()
+                                .split('```')[1]
+                                .trim();
                             const language = codeExample.split('\n')[0];
                             if (language === 'markup' || language === 'typescript') {
                                 codeExample = codeExample.slice(language.length).trim();
                                 codeExampleLanguage = language;
                             }
                             break;
-                        case 'param':
+                        case '@param':
                             parameters = parameters || [];
                             parameters.push({
                                 name: tag.param,
-                                description: tag.text.trim(),
+                                description: tag.content
+                                    .map((item) => item.text)
+                                    .join('')
+                                    .trim(),
                             });
                             break;
+                        case '@required':
+                            extras['required'] = true;
+                            break;
+                        /* istanbul ignore next */
                         default:
-                            extras[tag.tag] = tag.text;
                             break;
                     }
                 });
             }
-            description = (comment.shortText || comment.text || '').trim();
+            description = comment.summary
+                ?.map((item) => item.text)
+                .join('')
+                .trim();
         }
         return {
             codeExample,
@@ -2769,7 +2804,7 @@ class SkyDocsTypeDefinitionsService {
                 console.warn(`Type definitions were not found for location: ${requestedDir}`);
             }
             typeDefinitions.forEach((item) => {
-                const decorator = item.decorators && item.decorators[0].name;
+                const decorator = item.decorators && item.decorators[0]?.name;
                 const kindString = item.kindString;
                 switch (decorator) {
                     case 'Component':