chore(internals): generate custom data references

Signed-off-by: John Yanarella <jyanarella@nvidia.com>

Author: johnyanarella

projects/internals/eslint/src/configs/typescript.js

@@ -159,6 +159,7 @@ const config = {
 reflect: {name: false},
 command: {name: true},
 entrypoint: {name: true},
+documentation: {name: true},
 tags: {name: true},
 aria: {name: true},
 experimental: {name: true},

projects/internals/vite/src/plugins/cem.config.mjs

@@ -41,7 +41,8 @@ function metadataPlugin() {
 'since',
 'axe',
 'entrypoint',
-'example'
+'example',
+'documentation'
 ];
 
 switch(node.kind){

projects/internals/vite/src/plugins/cem.js

@@ -5,6 +5,31 @@ import { generateVsCodeCustomElementData } from 'custom-element-vs-code-integrat
 
 constresolve=rel=>path.join(process.cwd(),rel);
 
+functionnormalizeURL(value){
+if(typeofvalue!=='string'){
+returnnull;
+}
+
+try{
+consturl=newURL(value);
+returnurl.protocol==='https:' ? url.href : null;
+}catch{
+returnnull;
+}
+}
+
+constreferenceNameByMetadataName={
+aria: 'WAI-ARIA Reference',
+documentation: 'Documentation'
+};
+
+functiongenerateVsCodeCustomElementDataReference(manifestMetadataName,manifestMetadataValue){
+constname=referenceNameByMetadataName[manifestMetadataName];
+consturl=normalizeURL(manifestMetadataValue);
+
+returnname&&url ? { name, url } : null;
+}
+
 /**
  * Generates a Custom Elements Manifest on initial build
  */
@@ -41,10 +66,10 @@ export function cem() {
 constdeclaration=vsCodeManifest.modules
 .flatMap(module=>module.declarations)
 .find(d=>d.tagName===tag);
-constreferences=Object.keys(declaration.metadata??{})
-.map(name=>({name,url: declaration.metadata[name]}))
-.filter(ref=>ref.url?.includes&&ref.url.includes('http'));
-returnreferences;
+returnObject.entries(declaration?.metadata??{}).flatMap(([name,value])=>{
+constreference=generateVsCodeCustomElementDataReference(name,value);
+returnreference ? [reference] : [];
+});
 }
 });
 }