Merge pull request #1068 from limzykenneth/reference-parsing

Reference parsing now also parse META comments

Author: davepagurek

src/layouts/ReferenceItemLayout.astro

@@ -150,12 +150,13 @@ const descriptionParts = description.split(
         examples && (
           <div class="mb-xl">
             <h2 class="text-h3">{t("Examples")}</h2>
-            {examples.map(({ src: exampleCode, classes }, i: number) => {
+            {examples.map(({ src: exampleCode, classes, meta }, i: number) => {
+              const previewable = !classes.norender && !meta.includes('norender');
               return (
                 <CodeEmbed
                   client:load
                   initialValue={exampleCode}
-                  previewable={!classes.norender}
+                  previewable={previewable}
                   editable
                   lazyLoad={false}
                   allowSideBySide={true}

src/pages/_utils.ts

@@ -196,7 +196,11 @@ export const getLibraryLink = (library: CollectionEntry<"libraries">) =>
  * @returns The examples separated into individual strings
  */
  // separateReferenceExamples
-export const parseReferenceExamplesAndMetadata = (examples: string[]): { src: string, classes: Record<string, any> }[] =>
+export const parseReferenceExamplesAndMetadata = (examples: string[]): {
+  src: string,
+  classes: Record<string, any>,
+  meta: string[]
+}[] =>
   examples
     ?.flatMap((example: string) => example.split("</div>"))
     .map((src: string) => {
@@ -210,7 +214,18 @@ export const parseReferenceExamplesAndMetadata = (examples: string[]): { src: st
       }
       return { classes, src }
     })
-    .map(({ src, classes }) => ({ classes, src: src.replace(/<\/?div[^>]*>|<\/?code>/g, "") }))
+    .map(({ src, classes }) => {
+      const metaMatch = src.match(/^\/\/ META:(.+)/);
+      let meta: string[] = [];
+      if(metaMatch !== null){
+        meta = metaMatch?.[1].split(",") ?? [];
+      }
+      return {
+        classes,
+        src: src.replace(/<\/?div[^>]*>|<\/?code>/g, "").replace(/^\/\/ META:(.+)/, ""),
+        meta
+      };
+    })
     .filter(({ src }) => src);
 
 /**