feat: add vitepress site generator

Signed-off-by: Gordon Smith <GordonJSmith@gmail.com>

Author: GordonSmith

.gitignore

@@ -1,6 +1,7 @@
-/build
+/.vitepress/cache
 /.vscode/settings.json
-/cpm_modules
+/build
+/node_modules
 /vcpkg_installed
 /test/wasm/build*
 .DS_Store

.vitepress/config.ts

@@ -0,0 +1,56 @@
+import { defineConfig } from 'vitepress'
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+    title: "Component Model C++",
+    description: " C++ ABI implementation of the WebAssembly Component Model",
+    base: '/component-model-cpp/',
+    srcExclude: ["build/**", "node_modules/**", "ref/**", "vcpkg/**", "vcpkg_overlays/**"],
+
+    themeConfig: {
+        editLink: {
+            pattern: 'https://github.com/GordonSmith/component-model-cpp/edit/main/docs/:path',
+            text: 'Edit this page on GitHub'
+        },
+
+        nav: [
+            { text: 'Home', link: '/' },
+            { text: 'Documentation', link: '/api-examples' },
+            { text: 'GitHub', link: 'https://github.com/GordonSmith/component-model-cpp' },
+            { text: 'Changelog', link: 'https://github.com/GordonSmith/component-model-cpp/blob/trunk/CHANGELOG.md' },
+        ],
+
+        sidebar: [
+
+            {
+                text: 'Documentation',
+                items: [
+                    { text: 'Generated Files Structure', link: '/docs/generated-files-structure' },
+                    { text: 'Generated WAMR Helpers', link: '/docs/generated-wamr-helpers' },
+                    { text: 'Packaging', link: '/docs/PACKAGING' }
+                ]
+            },
+            {
+                text: 'Examples & Guides',
+                items: [
+                    { text: 'Markdown Examples', link: '/markdown-examples' }
+                ]
+            },
+            {
+                text: 'Additional Resources',
+                items: [
+                    { text: 'Samples', link: '/samples/README' },
+                    { text: 'Testing', link: '/test/README' },
+                    { text: 'Grammar', link: '/grammar/README' },
+                    { text: 'WIT Code Generator', link: '/tools/wit-codegen/README' }
+                ]
+            }
+        ],
+
+        socialLinks: [
+            { icon: 'github', link: 'https://github.com/GordonSmith/component-model-cpp' },
+            { icon: 'bluesky', link: 'https://bsky.app/profile/schmoo2k.bsky.social' },
+            { icon: 'linkedin', link: 'https://www.linkedin.com/in/gordon-smith-0b168a6/' },
+        ]
+    }
+})

.vitepress/theme/custom.css

@@ -0,0 +1,20 @@
+/**
+ * Customize default theme styling by overriding CSS variables:
+ * https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css
+ */
+
+/**
+ * Colors - Orange Brand
+ * -------------------------------------------------------------------------- */
+
+:root {
+    --vp-c-brand-1: #c26518;
+    --vp-c-brand-2: #d97616;
+    --vp-c-brand-3: #a54f12;
+}
+
+.dark {
+    --vp-c-brand-1: #d97616;
+    --vp-c-brand-2: #c26518;
+    --vp-c-brand-3: #a54f12;
+}

.vitepress/theme/index.ts

@@ -0,0 +1,4 @@
+import DefaultTheme from 'vitepress/theme'
+import './custom.css'
+
+export default DefaultTheme

docs/api-examples.md

@@ -0,0 +1,49 @@
+---
+outline: deep
+---
+
+# Runtime API Examples
+
+This page demonstrates usage of some of the runtime APIs provided by VitePress.
+
+The main `useData()` API can be used to access site, theme, and page data for the current page. It works in both `.md` and `.vue` files:
+
+```md
+<script setup>
+import { useData } from 'vitepress'
+
+const { theme, page, frontmatter } = useData()
+</script>
+
+## Results
+
+### Theme Data
+<pre>{{ theme }}</pre>
+
+### Page Data
+<pre>{{ page }}</pre>
+
+### Page Frontmatter
+<pre>{{ frontmatter }}</pre>
+```
+
+<script setup>
+import { useData } from 'vitepress'
+
+const { site, theme, page, frontmatter } = useData()
+</script>
+
+## Results
+
+### Theme Data
+<pre>{{ theme }}</pre>
+
+### Page Data
+<pre>{{ page }}</pre>
+
+### Page Frontmatter
+<pre>{{ frontmatter }}</pre>
+
+## More
+
+Check out the documentation for the [full list of runtime APIs](https://vitepress.dev/reference/runtime-api#usedata).

docs/issue-backlog.md

@@ -0,0 +1,85 @@
+# Markdown Extension Examples
+
+This page demonstrates some of the built-in markdown extensions provided by VitePress.
+
+## Syntax Highlighting
+
+VitePress provides Syntax Highlighting powered by [Shiki](https://github.com/shikijs/shiki), with additional features like line-highlighting:
+
+**Input**
+
+````md
+```js{4}
+export default {
+  data () {
+    return {
+      msg: 'Highlighted!'
+    }
+  }
+}
+```
+````
+
+**Output**
+
+```js{4}
+export default {
+  data () {
+    return {
+      msg: 'Highlighted!'
+    }
+  }
+}
+```
+
+## Custom Containers
+
+**Input**
+
+```md
+::: info
+This is an info box.
+:::
+
+::: tip
+This is a tip.
+:::
+
+::: warning
+This is a warning.
+:::
+
+::: danger
+This is a dangerous warning.
+:::
+
+::: details
+This is a details block.
+:::
+```
+
+**Output**
+
+::: info
+This is an info box.
+:::
+
+::: tip
+This is a tip.
+:::
+
+::: warning
+This is a warning.
+:::
+
+::: danger
+This is a dangerous warning.
+:::
+
+::: details
+This is a details block.
+:::
+
+## More
+
+Check out the documentation for the [full list of markdown extensions](https://vitepress.dev/guide/markdown).