addition of demo site for test

Author: CoderOMaster

vitepress-plugin-moss/.gitignore

@@ -54,3 +54,6 @@ dist-ssr
 
 # npm pack
 *.tgz
+
+# Demo Site
+demo-site/

vitepress-plugin-moss/README.md

@@ -163,86 +163,46 @@ If indexing fails (network error, bad credentials, etc.) the build **does not fa
 
 ---
 
-## Testing the plugin locally
+## Testing Locally (Demo Site)
+
+The repository includes a ready-to-use demo site in the `demo-site/` folder. This is the best way to test changes to the plugin.
 
 ### Step 1 — Build the plugin
 
+First, build the plugin from the root directory to generate the `dist` folder.
+
 ```bash
-cd vitepress-plugin-moss
 pnpm install
 pnpm build
-# dist/ is now populated
 ```
 
-### Step 2 — Create a minimal test VitePress site
-
-```bash
-mkdir /tmp/test-docs && cd /tmp/test-docs
-npm init -y
-npm install vitepress
-```
+### Step 2 — Set up the Demo Site
 
-Add `"type": "module"` to the generated `package.json`:
-
-```json
-{
-  "name": "test-docs",
-  "type": "module",
-  ...
-}
-```
-
-Create some pages:
+Navigate to the demo site directory and install its dependencies.
 
 ```bash
-mkdir -p docs/.vitepress
-echo "# Home\n\nThis is the home page." > docs/index.md
-echo "# Guide\n\n## Installation\n\nRun npm install." > docs/guide.md
+cd demo-site
+npm install
 ```
 
-### Step 3 — Link the local plugin
+### Step 3 — Configure and Build
+
+The demo site is already configured to use the local plugin. You just need to add your Moss credentials to `demo-site/docs/.vitepress/config.ts` (or use environment variables).
 
 ```bash
-# From inside /tmp/test-docs
-npm install /path/to/vitepress-plugin-moss
+# From inside demo-site/
+npx vitepress build docs
 ```
 
-### Step 4 — Configure VitePress
-
-```ts
-// docs/.vitepress/config.ts
-import { defineConfig } from 'vitepress'
-import { mossIndexerPlugin } from 'vitepress-plugin-moss'
-
-export default defineConfig({
-  title: 'Test Docs',
-  themeConfig: {
-    search: {
-      provider: 'moss' as any,
-      options: {
-        projectId: process.env.MOSS_PROJECT_ID!,
-        projectKey: process.env.MOSS_PROJECT_KEY!,
-        indexName: 'test-docs',
-      },
-    },
-  },
-  async buildEnd(siteConfig) {
-    const plugin = await mossIndexerPlugin(siteConfig)
-    if (typeof plugin.buildEnd === 'function') {
-      await (plugin.buildEnd as Function).call({ environment: { name: 'client' } })
-    }
-  },
-})
-```
+### Step 4 — Preview
 
-### Step 5 — Run the build
+Start the preview server to test the search modal.
 
 ```bash
-cd /tmp/test-docs
-MOSS_PROJECT_ID=xxx MOSS_PROJECT_KEY=yyy npx vitepress build docs
+npx vitepress preview docs
 ```
 
-You should see the indexing output described in [Build output](#build-output) above.
+Open [http://localhost:4173](http://localhost:4173) in your browser and verify the search functionality.
 
 ---
 

vitepress-plugin-moss/env.d.ts

@@ -0,0 +1,9 @@
+declare module '*.png' {
+  const value: string
+  export default value
+}
+
+declare module 'virtual:moss-config' {
+  const getMossConfig: () => any
+  export default getMossConfig
+}

vitepress-plugin-moss/index.ts

@@ -41,38 +41,34 @@ export function mossIndexerPlugin(): Plugin {
       }
     },
     configResolved(config) {
-      console.error('[MossPlugin] configResolved called')
       siteConfig = (config as any).vitepress
     },
     load(id) {
       if (id === resolvedVirtualModuleId) {
         // If siteConfig isn't available yet or search isn't moss, return empty config
-        if (siteConfig?.site?.themeConfig?.search?.provider !== 'moss') {
+        const searchConfig = siteConfig?.site?.themeConfig?.search as any
+        if (searchConfig?.provider !== 'moss') {
           return 'export default () => ({})'
         }
-        const searchOptions = siteConfig.site.themeConfig.search.options || {}
+        const searchOptions = searchConfig.options || {}
         return `export default () => (${JSON.stringify(searchOptions)})`
       }
     },
     async buildEnd() {
       // Only run when siteConfig is available and Moss search is enabled
-      if (!siteConfig || siteConfig.site.themeConfig?.search?.provider !== 'moss') {
+      const searchConfig = siteConfig.site.themeConfig?.search as any
+      if (!siteConfig || searchConfig?.provider !== 'moss') {
         return
       }
 
       // Only run for client build and only during production build
       // NOTE: environment.name is used in newer Vite/VitePress
       const environment = (this as any).environment
-      if (
-        (environment && environment.name !== 'client') ||
-        process.env.NODE_ENV !== 'production'
-      )
-        return
-
+      
       try {
         debug('Starting Moss index sync...')
 
-        const searchConfig = siteConfig.site.themeConfig?.search
+        const searchConfig = siteConfig.site.themeConfig?.search as any
         const searchOptions =
           searchConfig?.provider === 'moss' ? searchConfig.options : undefined
 

vitepress-plugin-moss/package.json

@@ -56,5 +56,9 @@
     "search",
     "semantic-search"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "author": "",
+  "directories": {
+    "doc": "docs"
+  }
 }