docs: v3 docs structure (#479)

* docs: v3 docs structure

* fix build

* WIP

* WIP

* progress on ORM part

* update

* update embed mechanism

* fix stackblitz embed

* make code tabs sync

* complete filter section

* update docs

* progress on delete

* more progress on ORM API

* ORM docs progress

* query builder docs

* computed fields

* polymorphism

* plugins part

* update plugins part

* add logging

* add inferred types section

* progress

* progress

* prisma migration guide

* update broken links

* update

* copywriting

* zmodel language reference

* update

* fix links

* almost done

* updates

* update

* update

* update

* add feature gap

* update

* use git submodules to implement code snippet loading

* addressing review comments

* update

* v3 LP

* update

* update

* update responsiveness

* update

* update

* update

* update

* nav bar

* update

* update submodules

Author: ymc9

.gitmodules

@@ -0,0 +1,18 @@
+[submodule "code-repos/zenstackhq/v3-doc-orm"]
+	path = code-repos/zenstackhq/v3-doc-orm
+	url = https://github.com/zenstackhq/v3-doc-orm.git
+[submodule "code-repos/zenstackhq/v3-doc-orm-computed-fields"]
+	path = code-repos/zenstackhq/v3-doc-orm-computed-fields
+	url = https://github.com/zenstackhq/v3-doc-orm-computed-fields.git
+[submodule "code-repos/zenstackhq/v3-doc-orm-computed-polymorphism"]
+	path = code-repos/zenstackhq/v3-doc-orm-computed-polymorphism
+	url = https://github.com/zenstackhq/v3-doc-orm-polymorphism.git
+[submodule "code-repos/zenstackhq/v3-doc-orm-typed-json"]
+	path = code-repos/zenstackhq/v3-doc-orm-typed-json
+	url = https://github.com/zenstackhq/v3-doc-orm-typed-json.git
+[submodule "code-repos/zenstackhq/v3-doc-quick-start"]
+	path = code-repos/zenstackhq/v3-doc-quick-start
+	url = https://github.com/zenstackhq/v3-doc-quick-start.git
+[submodule "code-repos/zenstackhq/v3-doc-orm-polymorphism"]
+	path = code-repos/zenstackhq/v3-doc-orm-polymorphism
+	url = https://github.com/zenstackhq/v3-doc-orm-polymorphism.git

code-repos/zenstackhq/v3-doc-orm

@@ -44,6 +44,10 @@ const config = {
                             label: '1.x',
                             banner: 'none',
                         },
+                        '3.x': {
+                            label: '3.0 Beta',
+                            banner: 'none',
+                        },
                     },
                 },
                 blog: false,
@@ -63,6 +67,12 @@ const config = {
     themeConfig:
         /** @type {import('@docusaurus/preset-classic').ThemeConfig} */
         {
+            announcementBar: {
+                id: 'v3_beta',
+                content:
+                    'ZenStack v3 Beta is released 🚀. The new version has replaced Prisma with a brand new query engine. <a href="/v3">Check it out</a>',
+                isCloseable: true,
+            },
             colorMode: {
                 defaultMode: 'light',
                 respectPrefersColorScheme: false,
@@ -99,6 +109,11 @@ const config = {
                         position: 'left',
                         label: 'Handbook',
                     },
+                    {
+                        to: 'v3',
+                        position: 'left',
+                        label: 'V3 Beta 🚀',
+                    },
                     { to: '/blog', label: 'Blog', position: 'left' },
                     {
                         href: 'https://discord.gg/Ykhr738dUe',
@@ -193,6 +208,23 @@ const config = {
                             },
                         ],
                     },
+                    {
+                        title: 'FlatIcon Credits',
+                        items: [
+                            {
+                                label: 'Endure',
+                                href: 'https://www.flaticon.com/free-icons/endure',
+                            },
+                            {
+                                label: 'Diagram by Kiranshastry',
+                                href: 'https://www.flaticon.com/free-icons/diagram',
+                            },
+                            {
+                                href: 'https://www.flaticon.com/free-icons/database',
+                                label: 'Database by kerismaker',
+                            },
+                        ],
+                    },
                 ],
                 copyright: `Copyright © ${new Date().getFullYear()} ZenStack, Inc.`,
             },

code-repos/zenstackhq/v3-doc-orm-computed-fields

@@ -12,7 +12,8 @@
         "serve": "docusaurus serve",
         "write-translations": "docusaurus write-translations",
         "write-heading-ids": "docusaurus write-heading-ids",
-        "typecheck": "tsc"
+        "typecheck": "tsc",
+        "pull-submodules": "git submodule foreach git pull origin main"
     },
     "dependencies": {
         "@algolia/client-search": "^4.22.1",
@@ -22,12 +23,15 @@
         "@docusaurus/theme-mermaid": "3.4.0",
         "@giscus/react": "^2.4.0",
         "@mdx-js/react": "^3.0.1",
+        "@stackblitz/sdk": "^1.11.0",
         "autoprefixer": "^10.4.13",
         "clsx": "^1.2.1",
+        "is-mobile": "^5.0.0",
         "postcss": "^8.4.21",
         "prism-react-renderer": "^2.3.1",
         "prism-svelte": "^0.5.0",
         "prismjs": "^1.29.0",
+        "raw-loader": "^4.0.2",
         "react": "^18.2.0",
         "react-dom": "^18.2.0",
         "react-icons": "^5.0.1",

code-repos/zenstackhq/v3-doc-orm-polymorphism

@@ -0,0 +1,27 @@
+import CodeBlock from '@theme/CodeBlock';
+
+interface GithubCodeBlockProps {
+    repoPath: string;
+    file: string;
+}
+
+const GithubCodeBlock: React.FC<GithubCodeBlockProps> = ({ repoPath, file }) => {
+    const code = require(`!!raw-loader!@site/code-repos/${repoPath}/${file}`).default;
+
+    const getLanguage = (file: string): string => {
+        if (file.endsWith('.ts')) {
+            return 'typescript';
+        } else if (file.endsWith('.zmodel')) {
+            return 'zmodel';
+        } else {
+            return 'plaintext';
+        }
+    };
+    return (
+        <CodeBlock language={getLanguage(file)} title={file}>
+            {code}
+        </CodeBlock>
+    );
+};
+
+export default GithubCodeBlock;