From 3f6d32498043c0998801017914e2a64f7bc22e34 Mon Sep 17 00:00:00 2001
From: GauthierWebDev <gauthier@gauthierdaniels.fr>
Date: Sun, 13 Apr 2025 16:05:56 +0200
Subject: [PATCH] chore: Rename CSRFence to CSRSnippet and add toast in Fence

---
 .../syntax/{CSRFence.tsx => CSRSnippet.tsx}   |  5 +-
 app/components/syntax/Fence.tsx               |  6 +-
 app/components/syntax/Snippet.tsx             | 58 ++++++++++++++++++
 app/data/docs/react/usereducer/page.md        | 13 +---
 .../docs/react/usereducer/reducer-example.jsx | 10 +++
 app/fastify-entry.ts                          |  4 --
 app/layouts/LayoutDefault.tsx                 |  2 +
 app/markdoc/tags.tsx                          | 54 ++++++++++++++++
 app/pages/docs/+data.ts                       |  8 ++-
 app/services/DocsService.ts                   | 59 ++++++++++++------
 app/services/SnippetsService.ts               | 61 +++++++++++++++++++
 11 files changed, 240 insertions(+), 40 deletions(-)
 rename app/components/syntax/{CSRFence.tsx => CSRSnippet.tsx} (96%)
 create mode 100644 app/components/syntax/Snippet.tsx
 create mode 100644 app/data/docs/react/usereducer/reducer-example.jsx
 create mode 100644 app/services/SnippetsService.ts

diff --git a/app/components/syntax/CSRFence.tsx b/app/components/syntax/CSRSnippet.tsx
similarity index 96%
rename from app/components/syntax/CSRFence.tsx
rename to app/components/syntax/CSRSnippet.tsx
index 2b3bc93..3d5513e 100644
--- a/app/components/syntax/CSRFence.tsx
+++ b/app/components/syntax/CSRSnippet.tsx
@@ -3,9 +3,9 @@ import { prismThemes } from "@/data/themes/prism";
 import { Highlight } from "prism-react-renderer";
 import { useTheme } from "@/hooks/useTheme";
 import { Fragment, useMemo } from "react";
+import { toast } from "react-toastify";
 import { Button } from "./Button";
 import Prism from "prismjs";
-import { toast } from "react-toastify";
 
 export default function CSRFence({ children, language }: { children: string; language: string }) {
   const { theme } = useTheme();
@@ -16,7 +16,7 @@ export default function CSRFence({ children, language }: { children: string; lan
 
   const copyToClipboard = () => {
     navigator.clipboard.writeText(children.trimEnd());
-    toast.success("Code copied to clipboard!");
+    toast.success("Code copié dans le presse-papier");
   };
 
   return (
@@ -39,6 +39,7 @@ export default function CSRFence({ children, language }: { children: string; lan
           </pre>
         )}
       </Highlight>
+
       <Button
         className="absolute top-2 right-2 w-8 h-8 aspect-square opacity-0 group-hover:opacity-50 hover:opacity-100 transition-opacity"
         size="sm"
diff --git a/app/components/syntax/Fence.tsx b/app/components/syntax/Fence.tsx
index 0f270f2..87c0d1e 100644
--- a/app/components/syntax/Fence.tsx
+++ b/app/components/syntax/Fence.tsx
@@ -5,7 +5,7 @@ import { Fragment, useMemo } from "react";
 
 import { clientOnly } from "vike-react/clientOnly";
 
-const CSRFence = clientOnly(() => import("./CSRFence"));
+const CSRSnippet = clientOnly(() => import("./CSRSnippet"));
 
 function SSRFence({ children, language }: { children: string; language: string }) {
   const { theme } = useTheme();
@@ -38,9 +38,9 @@ function SSRFence({ children, language }: { children: string; language: string }
 export function Fence({ children, language }: { children: string; language: string }) {
   return (
     <div className="relative group">
-      <CSRFence language={language} fallback={<SSRFence language={language} children={children} />}>
+      <CSRSnippet language={language} fallback={<SSRFence language={language} children={children} />}>
         {children}
-      </CSRFence>
+      </CSRSnippet>
     </div>
   );
 }
diff --git a/app/components/syntax/Snippet.tsx b/app/components/syntax/Snippet.tsx
new file mode 100644
index 0000000..48066b0
--- /dev/null
+++ b/app/components/syntax/Snippet.tsx
@@ -0,0 +1,58 @@
+import type { Data } from "@/pages/docs/+data";
+
+import { snippetsService } from "@/services/SnippetsService";
+import { Highlight, Prism } from "prism-react-renderer";
+import { clientOnly } from "vike-react/clientOnly";
+import { prismThemes } from "@/data/themes/prism";
+import { useData } from "vike-react/useData";
+import { useTheme } from "@/hooks/useTheme";
+import { Fragment, useMemo } from "react";
+
+const CSRSnippet = clientOnly(() => import("./CSRSnippet"));
+
+function SSRSnippet({ language, children }: { language: string; children: string }) {
+  const { theme } = useTheme();
+  const prismTheme = useMemo(() => {
+    return prismThemes[theme];
+  }, [theme]);
+
+  return (
+    <Highlight code={children.trimEnd()} language={language} theme={prismTheme} prism={Prism}>
+      {({ className, style, tokens, getTokenProps }) => (
+        <pre className={className} style={style}>
+          <code>
+            {tokens.map((line, lineIndex) => (
+              <Fragment key={lineIndex}>
+                {line
+                  .filter((token) => !token.empty)
+                  .map((token, tokenIndex) => (
+                    <span key={tokenIndex} {...getTokenProps({ token })} />
+                  ))}
+                {"\n"}
+              </Fragment>
+            ))}
+          </code>
+        </pre>
+      )}
+    </Highlight>
+  );
+}
+
+export function Snippet({ path, language, label }: { path: string; language: string; label?: string }) {
+  const { snippets } = useData<Data>();
+
+  const snippet = snippets.find((snippet) => snippet.path === path);
+  if (!snippet || !snippet.content) return null;
+
+  const props = {
+    language,
+    label,
+    children: snippet.content,
+  };
+
+  return (
+    <div className="relative group">
+      <CSRSnippet {...props} fallback={<SSRSnippet {...props} />} />
+    </div>
+  );
+}
diff --git a/app/data/docs/react/usereducer/page.md b/app/data/docs/react/usereducer/page.md
index 139bcf1..d9119fb 100644
--- a/app/data/docs/react/usereducer/page.md
+++ b/app/data/docs/react/usereducer/page.md
@@ -50,18 +50,7 @@ Parlons dans un premier temps de la signature d'un reducer :
 
 {% tab value="jsx" label="JSX" %}
 
-```jsx
-const reducer = (state, action) => {
-  switch (action.type) {
-    case "TYPE_1":
-      return { ...state /* Nouvel état */ };
-    case "TYPE_2":
-      return { ...state /* Nouvel état */ };
-    default:
-      return state;
-  }
-};
-```
+{% snippet path="data/docs/react/usereducer/reducer-example.jsx" language="jsx" label="test" /%}
 
 {% /tab %}
 
diff --git a/app/data/docs/react/usereducer/reducer-example.jsx b/app/data/docs/react/usereducer/reducer-example.jsx
new file mode 100644
index 0000000..a7ee94f
--- /dev/null
+++ b/app/data/docs/react/usereducer/reducer-example.jsx
@@ -0,0 +1,10 @@
+const reducer = (state, action) => {
+  switch (action.type) {
+    case "TYPE_1":
+      return { ...state /* Nouvel état */ };
+    case "TYPE_2":
+      return { ...state /* Nouvel état */ };
+    default:
+      return state;
+  }
+};
diff --git a/app/fastify-entry.ts b/app/fastify-entry.ts
index 6aad9ab..1bf2846 100644
--- a/app/fastify-entry.ts
+++ b/app/fastify-entry.ts
@@ -5,10 +5,6 @@ import { fileURLToPath } from "node:url";
 import { dirname } from "node:path";
 import Fastify from "fastify";
 
-import { Prism } from "prism-react-renderer";
-(typeof global !== "undefined" ? global : window).Prism = Prism;
-require("prismjs/components/prism-bash");
-
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
diff --git a/app/layouts/LayoutDefault.tsx b/app/layouts/LayoutDefault.tsx
index 00c2b61..d1e8d49 100644
--- a/app/layouts/LayoutDefault.tsx
+++ b/app/layouts/LayoutDefault.tsx
@@ -14,6 +14,7 @@ import "./style.css";
 import "./tailwind.css";
 import "./prism.css";
 import "unfonts.css";
+import { ToastContainer } from "react-toastify";
 
 function GitHubIcon(props: React.ComponentPropsWithoutRef<"svg">) {
   return (
@@ -93,6 +94,7 @@ export default function DefaultLayout({ children }: { children: React.ReactNode
           {children}
         </div>
       </div>
+      <ToastContainer />
     </ThemeProvider>
   );
 }
diff --git a/app/markdoc/tags.tsx b/app/markdoc/tags.tsx
index dae98aa..b03a4ab 100644
--- a/app/markdoc/tags.tsx
+++ b/app/markdoc/tags.tsx
@@ -1,7 +1,14 @@
 import { QuickLink, QuickLinks } from "@syntax/QuickLinks";
 import { TabContent, Tabs } from "@/components/md/Tabs";
+// import { Fence2 } from "@/components/syntax/Fence2";
 import { Callout } from "@syntax/Callout";
+// import fs from "fs/promises";
+// import { Tag } from "./Tag";
 import React from "react";
+import { Snippet } from "@/components/syntax/Snippet";
+// import path from "path";
+
+// const __dirname = path.resolve();
 
 const tags = {
   callout: {
@@ -67,6 +74,53 @@ const tags = {
       value: { type: String },
     },
   },
+  snippet: {
+    render: Snippet,
+    attributes: {
+      language: {
+        type: String,
+        default: "auto",
+      },
+      label: { type: String },
+      path: { type: String },
+    },
+  },
+  // snippet: {
+  //   // render: Fence2,
+  //   attributes: {
+  //     language: {
+  //       type: String,
+  //       default: "auto",
+  //     },
+  //     label: { type: String },
+  //     description: { type: String },
+  //     path: { type: String },
+  //   },
+  //   async transform(node: any, config: any) {
+  //     const attributes = node.transformAttributes(config);
+
+  //     const pathValue = attributes.path;
+
+  //     let language = attributes.language ?? "auto";
+  //     let content = "";
+
+  //     if (!pathValue) {
+  //       console.warn("No path provided for snippet tag");
+  //     } else {
+  //       const absolutePath = path.resolve(__dirname, pathValue);
+  //       // Read the file content
+  //       try {
+  //         content = await fs.readFile(absolutePath, "utf-8");
+  //       } catch (error) {
+  //         console.error("Error reading file:", error);
+  //         content = `Error reading file: ${absolutePath}`;
+  //         language = "plain";
+  //       }
+
+  //       // return new Tag("fence2", { ...attributes, language, content, label: "Temp" });
+  //     }
+  //   },
+  // },
 };
 
 export default tags;
diff --git a/app/pages/docs/+data.ts b/app/pages/docs/+data.ts
index 6cde874..68da945 100644
--- a/app/pages/docs/+data.ts
+++ b/app/pages/docs/+data.ts
@@ -1,5 +1,6 @@
 import type { PageContext } from "vike/types";
 
+import { snippetsService } from "@/services/SnippetsService";
 import { docsService } from "@/services/DocsService";
 import { readingTime } from "reading-time-estimator";
 import { useConfig } from "vike-react/useConfig";
@@ -28,5 +29,10 @@ export async function data(pageContext: PageContext) {
 
   docsService.transform(doc);
 
-  return { doc, estimatedReadingTime: readingTimeObject.text };
+  const snippets = Array.from(doc.snippets).map((snippetPath) => ({
+    path: snippetPath,
+    content: snippetsService.getFromCache(snippetPath),
+  }));
+
+  return { doc, estimatedReadingTime: readingTimeObject.text, snippets };
 }
diff --git a/app/services/DocsService.ts b/app/services/DocsService.ts
index 3270f42..602213b 100644
--- a/app/services/DocsService.ts
+++ b/app/services/DocsService.ts
@@ -1,5 +1,6 @@
 import type { Node } from "@markdoc/markdoc";
 
+import { snippetsService } from "@/services/SnippetsService";
 import { slugifyWithCounter } from "@sindresorhus/slugify";
 import { buildFlexSearch } from "./FlexSearchService";
 import Markdoc from "@markdoc/markdoc";
@@ -9,19 +10,22 @@ import glob from "fast-glob";
 import path from "path";
 import fs from "fs";
 
+const __dirname = path.resolve();
+
 export type FlexSearchData = { key: string; sections: DocSection[] }[];
 
 type DocsCache = Map<string, DocData>;
 type DocSection = [string, string | null, string[]];
-type DocData = { title: string; description: string; content: string; sections: DocSection[] };
+type DocData = { title: string; description: string; content: string; sections: DocSection[]; snippets: string[] };
 type DocExtension = "mdx" | "md";
 
 class DocsService {
-  private static readonly DOCS_PATH = path.resolve("../../app/data");
+  private static readonly DOCS_PATH = path.resolve(path.join(__dirname, "data"));
   private static readonly DOCS_EXTS: DocExtension[] = ["mdx", "md"]; // Order matters
   private static instance: DocsService;
 
   public search: ReturnType<typeof buildFlexSearch> = buildFlexSearch([]);
+
   private slugify = slugifyWithCounter();
   private cache: DocsCache = new Map();
 
@@ -78,27 +82,46 @@ class DocsService {
     }
   }
 
+  public fetchSnippets(content: string) {
+    const identifierResults = snippetsService.identifyNewSnippets(content);
+    if (!identifierResults) return;
+
+    const [snippetsToFetch, allSnippets] = identifierResults;
+
+    for (const snippet of snippetsToFetch) {
+      const absolutePath = path.resolve(__dirname, snippet);
+      const content = fs.readFileSync(absolutePath, "utf-8");
+      snippetsService.setToCache(snippet, content);
+    }
+
+    return allSnippets;
+  }
+
   public async fetchDocs() {
     const docs = glob.sync(DocsService.DOCS_PATH + `/**/*.{${DocsService.DOCS_EXTS.join(",")}}`);
-    const data = docs.map((doc) => {
-      const content = fs.readFileSync(doc, "utf-8");
-      const extension = path.extname(doc).slice(1) as DocExtension;
-      const key = doc
-        .replace(DocsService.DOCS_PATH, "")
-        .replace(`page.${extension}`, "")
-        .replace(`.${extension}`, "")
-        .replace(/\/$/g, "");
+    const data = await Promise.all(
+      docs.map((doc) => {
+        const content = fs.readFileSync(doc, "utf-8");
+        const extension = path.extname(doc).slice(1) as DocExtension;
+        const key = doc
+          .replace(DocsService.DOCS_PATH, "")
+          .replace(`page.${extension}`, "")
+          .replace(`.${extension}`, "")
+          .replace(/\/$/g, "");
 
-      const ast = Markdoc.parse(content);
-      const title = ast.attributes?.frontmatter?.match(/^title:\s*(.*?)\s*$/m)?.[1];
-      const description = ast.attributes?.frontmatter?.match(/^description:\s*(.*?)\s*$/m)?.[1]?.replaceAll('"', "");
-      const sections: DocSection[] = [[title, null, []]];
+        const allSnippets = this.fetchSnippets(content);
 
-      this.extractSections(ast, sections);
-      this.setToCache(key, { title, description, content, sections });
+        const ast = Markdoc.parse(content);
+        const title = ast.attributes?.frontmatter?.match(/^title:\s*(.*?)\s*$/m)?.[1];
+        const description = ast.attributes?.frontmatter?.match(/^description:\s*(.*?)\s*$/m)?.[1]?.replaceAll('"', "");
+        const sections: DocSection[] = [[title, null, []]];
 
-      return { key, sections };
-    });
+        this.extractSections(ast, sections);
+        this.setToCache(key, { title, description, content, sections, snippets: allSnippets || [] });
+
+        return { key, sections };
+      }),
+    );
 
     return data;
   }
diff --git a/app/services/SnippetsService.ts b/app/services/SnippetsService.ts
new file mode 100644
index 0000000..a91393f
--- /dev/null
+++ b/app/services/SnippetsService.ts
@@ -0,0 +1,61 @@
+import path from "path";
+
+type SnippetsCache = Map<string, string>;
+
+class SnippetsService {
+  private static instance: SnippetsService;
+
+  private cache: SnippetsCache = new Map();
+
+  public static getInstance(): SnippetsService {
+    if (!SnippetsService.instance) {
+      SnippetsService.instance = new SnippetsService();
+    }
+
+    return SnippetsService.instance;
+  }
+
+  public getFromCache(key: string): string | undefined {
+    return this.cache.get(key);
+  }
+
+  private doesCacheHas(key: string): boolean {
+    return this.cache.has(key);
+  }
+
+  public setToCache(key: string, value: string): void {
+    this.cache.set(key, value);
+  }
+
+  public showCache(): SnippetsCache {
+    return this.cache;
+  }
+
+  public identifyNewSnippets(content: string): [string[], string[]] | undefined {
+    const regex = /{%\s?snippet.*(path="\S*").*\/%}/g;
+    const snippets = content.match(regex);
+    if (!snippets) return;
+
+    const snippetsPath = snippets
+      .map((snippet) => {
+        const pathMatch = snippet.match(/path="([^"]+)"/);
+
+        const path = pathMatch?.[1];
+        if (!path) return null;
+
+        return path;
+      })
+      .filter((path) => path !== null) as string[];
+
+    const snippetsPathSet = new Set(snippetsPath);
+
+    return [
+      Array.from(snippetsPathSet).filter((snippetPath) => {
+        return this.doesCacheHas(snippetPath) === false;
+      }),
+      Array.from(snippetsPathSet),
+    ];
+  }
+}
+
+export const snippetsService = SnippetsService.getInstance();