Merge pull request #1422 from samchon/feat/nextra-v3

Adapt nextra v3 update
samchon · Dec 11, 2024 · 1e1ead2 · 1e1ead2
2 parents 768db51 + 52ba5a8
commit 1e1ead2
Show file tree

Hide file tree

Showing 39 changed files with 763 additions and 795 deletions.
diff --git a/website/next-env.d.ts b/website/next-env.d.ts
@@ -2,4 +2,4 @@
 /// <reference types="next/image-types/global" />
 
 // NOTE: This file should not be edited
-// see https://nextjs.org/docs/pages/building-your-application/configuring/typescript for more information.
+// see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.
diff --git a/website/next.config.js → website/next.config.mjs b/website/next.config.js → website/next.config.mjs
@@ -1,4 +1,6 @@
-const withNextra = require("nextra")({
+import nextra from "nextra";
+
+const withNextra = nextra({
   theme: "nextra-theme-docs",
   themeConfig: "./theme.config.tsx",
 });
@@ -18,4 +20,4 @@ const config = {
     },
   ],
 };
-module.exports = config;
+export default config;
diff --git a/website/package.json b/website/package.json
@@ -29,9 +29,9 @@
     "@samchon/openapi": "latest",
     "lz-string": "^1.5.0",
     "monaco-editor": "^0.50.0",
-    "next": "^14.2.3",
-    "nextra": "^2.13.4",
-    "nextra-theme-docs": "^2.13.4",
+    "next": "^15.1.0",
+    "nextra": "^3.2.5",
+    "nextra-theme-docs": "^3.2.5",
     "path": "^0.12.7",
     "prettier": "^3.2.5",
     "react": "^18.2.0",
@@ -49,7 +49,7 @@
     "@types/prettier": "^3.0.0",
     "@types/react": "^18.0.35",
     "gh-pages": "^5.0.0",
-    "next-sitemap": "^4.0.7",
+    "next-sitemap": "^4.2.3",
     "process": "^0.11.10",
     "rimraf": "^5.0.0",
     "ts-loader": "^9.5.1",

diff --git a/website/pages/_meta.js b/website/pages/_meta.js
@@ -0,0 +1,19 @@
+export default {
+  index: {
+    title: "Introduction",
+    type: "page",
+    hidden: true,
+    display: "hidden",
+    theme: {
+      layout: "full",
+    },
+  },
+  docs: {
+    title: "📖 Guide Documents",
+    type: "page",
+  },
+  playground: {
+    title: "💻 Playground",
+    type: "page",
+  },
+};
diff --git a/website/pages/_meta.json b/website/pages/_meta.json
diff --git a/website/pages/docs/_meta.js b/website/pages/docs/_meta.js
@@ -0,0 +1,37 @@
+export default {
+  index: "🙋🏻‍♂️ Introduction",
+  setup: "📦 Setup",
+  pure: "⛲ Pure TypeScript",
+
+  "-- features": {
+    type: "separator",
+    title: "📖 Features",
+  },
+  validators: "Runtime Validators",
+  json: "Enhanced JSON",
+  llm: "LLM Function Calling",
+  protobuf: "Protocol Buffer",
+  random: "Random Generator",
+  misc: "Miscellaneous",
+
+  "-- appendix": {
+    type: "separator",
+    title: "🔗 Appendix",
+  },
+  utilization: "Utilization Cases",
+  api: {
+    title: "⇲ API Documents",
+    href: "/api",
+    newWindow: true,
+  },
+  benchmark: {
+    title: "⇲ Benchmark Result",
+    href: "https://github.com/samchon/typia/tree/master/benchmark/results/AMD%20Ryzen%209%207940HS%20w%20Radeon%20780M%20Graphics",
+    newWindow: true,
+  },
+  articles: {
+    title: "⇲ dev.to Articles",
+    href: "https://dev.to/samchon/series/22474",
+    newWindow: true,
+  },
+};
diff --git a/website/pages/docs/_meta.json b/website/pages/docs/_meta.json
diff --git a/website/pages/docs/json/_meta.js b/website/pages/docs/json/_meta.js
@@ -0,0 +1,5 @@
+export default {
+  schema: "JSON Schema",
+  stringify: "stringify() functions",
+  parse: "parse() functions",
+};
diff --git a/website/pages/docs/json/_meta.json b/website/pages/docs/json/_meta.json
diff --git a/website/pages/docs/json/parse.mdx b/website/pages/docs/json/parse.mdx
@@ -1,4 +1,4 @@
-import { Tabs, Tab } from 'nextra-theme-docs'
+import { Tabs } from 'nextra/components'
 
 ## `parse()` functions
 <Tabs items={[
@@ -7,16 +7,16 @@ import { Tabs, Tab } from 'nextra-theme-docs'
   <code>IValidation.ts</code>,
   <code>Primitive.ts</code>
 ]}>
-  <Tab>
+  <Tabs.Tab>
 ```typescript copy
 export namespace json {
   export function isParse<T>(input: string): Primitive<T> | null;
   export function assertParse<T>(input: string): Primitive<T>;
   export function validateParse<T>(input: string): IValidation<Primitive<T>>;
 }
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```typescript copy
 export class TypeGuardError extends Error {
   public readonly method: string;
@@ -25,8 +25,8 @@ export class TypeGuardError extends Error {
   public readonly value: any;
 }
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```typescript copy
 export type IValidation<T> = IValidation.ISuccess<T> | IValidation.IFailure;
 export namespace IValidation {
@@ -46,8 +46,8 @@ export namespace IValidation {
   }
 }
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```typescript showLineNumbers copy
 /**
  * Primitive type of JSON.
@@ -185,7 +185,7 @@ interface IJsonable<T> {
   toJSON(): T;
 }
 ```
-  </Tab>
+  </Tabs.Tab>
 </Tabs>
 
 Type safe JSON parser.
@@ -201,7 +201,7 @@ If you want to know every type error infos detaily, you can use `typia.json.vali
 Look at the below code, then you may understand how the `typia.json.assertParse<T>()` function works.
 
 <Tabs items={['TypeScript Source Code', 'Compiled JavaScript File']}>
-  <Tab>
+  <Tabs.Tab>
 ```typescript copy filename="examples/src/assertParse.ts" showLineNumbers
 import typia, { tags } from "typia";
 
@@ -219,8 +219,8 @@ interface IMember {
     tags.Maximum<100>;
 }
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```javascript filename="examples/bin/assertParse.js" showLineNumbers
 import * as __typia_transform__randomFormatUuid from "typia/lib/internal/_randomFormatUuid.js";
 import * as __typia_transform__randomFormatEmail from "typia/lib/internal/_randomFormatEmail.js";
@@ -393,8 +393,8 @@ const parsed = (() => {
 })()(json);
 console.log(json === JSON.stringify(parsed)); // true
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```typescript showLineNumbers copy
 /**
  * Primitive type of JSON.
@@ -532,7 +532,7 @@ interface IJsonable<T> {
   toJSON(): T;
 }
 ```
-  </Tab>
+  </Tabs.Tab>
 </Tabs>
 
 
@@ -545,7 +545,7 @@ interface IJsonable<T> {
   <code>IValidation.ts</code>,
   <code>Primitive.ts</code>
 ]}>
-  <Tab>
+  <Tabs.Tab>
 ```typescript copy
 export namespace json {
   export function createIsParse<T>(): (input: string) => Primitive<T> | null;
@@ -555,8 +555,8 @@ export namespace json {
   ) => IValidation<Primitive<T>>;
 }
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```typescript copy
 export class TypeGuardError extends Error {
   public readonly method: string;
@@ -565,8 +565,8 @@ export class TypeGuardError extends Error {
   public readonly value: any;
 }
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```typescript copy
 export type IValidation<T> = IValidation.ISuccess<T> | IValidation.IFailure;
 export namespace IValidation {
@@ -586,7 +586,7 @@ export namespace IValidation {
   }
 }
 ```
-  </Tab>
+  </Tabs.Tab>
 </Tabs>
 
 Reusable `typia.json.isParse<T>()` function generators.
@@ -596,7 +596,7 @@ If you repeat to call `typia.json.isParse<T>()` function on the same type, size
 Just look at the code below, then you may understand how to use it.
 
 <Tabs items={['TypeScript Source Code', 'Compiled JavaScript File']}>
-  <Tab>
+  <Tabs.Tab>
 ```typescript copy filename="examples/src/createIsParse.ts" showLineNumbers
 import typia, { tags } from "typia";
 
@@ -611,8 +611,8 @@ interface IMember {
     tags.Maximum<100>;
 }
 ```
-  </Tab>
-  <Tab>
+  </Tabs.Tab>
+  <Tabs.Tab>
 ```javascript filename="examples/bin/createIsParse.js" showLineNumbers
 import * as __typia_transform__isFormatUuid from "typia/lib/internal/_isFormatUuid.js";
 import * as __typia_transform__isFormatEmail from "typia/lib/internal/_isFormatEmail.js";
@@ -636,5 +636,5 @@ export const parseMember = (() => {
   };
 })();
 ```
-  </Tab>
+  </Tabs.Tab>
 </Tabs>