@md-plugins/vite-examples-plugin 0.1.0-alpha.1 → 0.1.0-alpha.2

package/LICENSE.md

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024-present, Jeff Galbraith
+Copyright (c) 2024-present, MD-PLUGINS
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -31,21 +31,21 @@ pnpm add @md-plugins/vite-examples-plugin
 To use the `viteExamplesPlugin`, configure it in your Vite project:
 
 ```js
-import { defineConfig } from 'vite';
-import vue from '@vitejs/plugin-vue';
-import { viteExamplesPlugin } from '@md-plugin/vite-examples-plugin';
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { viteExamplesPlugin } from '@md-plugin/vite-examples-plugin'
 
 export default defineConfig({
   plugins: [vue(), viteExamplesPlugin('/absolute/path/to/examples')],
-});
+})
 ```
 
 ### Manual Chunk Splitting with Vite
 
 ```js
-import { defineConfig } from 'vite';
-import vue from '@vitejs/plugin-vue';
-import { viteExamplesPlugin, viteManualChunks } from 'vite-examples-plugin';
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { viteExamplesPlugin, viteManualChunks } from 'vite-examples-plugin'
 
 export default defineConfig({
   plugins: [vue(), viteExamplesPlugin('/absolute/path/to/examples')],
@@ -57,7 +57,7 @@ export default defineConfig({
       },
     },
   },
-});
+})
 ```
 
 ## Quasar Framework Configuration
@@ -84,10 +84,7 @@ export default defineConfig((ctx) => {
 ### Manual Chunk Splitting with Quasar
 
 ```js
-import {
-  viteExamplesPlugin,
-  viteManualChunks,
-} from '@md-plugins/vite-examples-plugin';
+import { viteExamplesPlugin, viteManualChunks } from '@md-plugins/vite-examples-plugin'
 ```
 
 ```js
@@ -156,12 +153,12 @@ During development, the plugin uses Vite's `import.meta.glob` to dynamically loa
 ```ts
 export const code = import.meta.glob('/src/examples/example1/*.vue', {
   eager: true,
-});
+})
 export const source = import.meta.glob('/src/examples/example1/*.vue', {
   query: '?raw',
   import: 'default',
   eager: true,
-});
+})
 ```
 
 ### Production Mode
@@ -169,10 +166,10 @@ export const source = import.meta.glob('/src/examples/example1/*.vue', {
 In production, the plugin preloads example components and their raw source code, generating import and export statements:
 
 ```ts
-import Example1 from 'app/src/examples/example1/Example1.vue';
-import RawExample1 from 'app/src/examples/example1/Example1.vue?raw';
+import Example1 from 'app/src/examples/example1/Example1.vue'
+import RawExample1 from 'app/src/examples/example1/Example1.vue?raw'
 
-export { Example1, RawExample1 };
+export { Example1, RawExample1 }
 ```
 
 ## Development Notes
@@ -196,7 +193,7 @@ The plugin is structured with the following components:
 If the `targetFolder` is not defined when the plugin is initialized, an error will be thrown:
 
 ```ts
-throw new Error('targetFolder is not defined');
+throw new Error('targetFolder is not defined')
 ```
 
 ## License

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { Plugin } from 'vite';
+
 /**
  * Creates a Vite plugin for handling Markdown examples.
  *
@@ -8,16 +10,9 @@
  * @param path - The path to the directory containing the example files.
  *               This path will be used as the target folder for resolving examples.
  *
- * @returns A function that creates a Vite plugin. This function takes a boolean
- *          parameter indicating whether the build is in production mode and
- *          returns the configured Vite plugin object.
+ * @returns A function that creates a Vite plugin.
  */
-declare function viteExamplesPlugin(path: string): (isProd: boolean) => {
-    name: string;
-    enforce: 'pre';
-    resolveId(id: string): string | undefined;
-    load(id: string): string | undefined;
-};
+declare function viteExamplesPlugin(isProd: boolean, path: string): Plugin;
 
 /**
  * A function to determine the manual chunk name for a given module ID.

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Plugin } from 'vite';
+
 /**
  * Creates a Vite plugin for handling Markdown examples.
  *
@@ -8,16 +10,9 @@
  * @param path - The path to the directory containing the example files.
  *               This path will be used as the target folder for resolving examples.
  *
- * @returns A function that creates a Vite plugin. This function takes a boolean
- *          parameter indicating whether the build is in production mode and
- *          returns the configured Vite plugin object.
+ * @returns A function that creates a Vite plugin.
  */
-declare function viteExamplesPlugin(path: string): (isProd: boolean) => {
-    name: string;
-    enforce: 'pre';
-    resolveId(id: string): string | undefined;
-    load(id: string): string | undefined;
-};
+declare function viteExamplesPlugin(isProd: boolean, path: string): Plugin;
 
 /**
  * A function to determine the manual chunk name for a given module ID.

package/dist/index.mjs

@@ -16,9 +16,7 @@ function prodLoad(id) {
   if (id.startsWith(resolvedIdPrefix)) {
     const exampleId = id.substring(id.indexOf(":") + 1);
     const files = globSync("*.vue", { cwd: join(targetFolder, exampleId) });
-    const importList = files.map(
-      (entry) => entry.substring(0, entry.length - 4)
-    );
+    const importList = files.map((entry) => entry.substring(0, entry.length - 4));
     const importStatements = importList.map(
       (entry) => `import ${entry} from 'app/src/examples/${exampleId}/${entry}.vue'
 import Raw${entry} from 'app/src/examples/${exampleId}/${entry}.vue?raw'`
@@ -46,9 +44,9 @@ function vitePlugin(isProd) {
     load: isProd ? prodLoad : devLoad
   };
 }
-function viteExamplesPlugin(path) {
+function viteExamplesPlugin(isProd, path) {
   targetFolder = path;
-  return vitePlugin;
+  return vitePlugin(isProd);
 }
 
 const vendorRE = /node_modules[\\/](vue|@vue|quasar|vue-router)[\\/](.*)\.(m?js|css|sass)$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@md-plugins/vite-examples-plugin",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.2",
   "description": "A Vite plugin for @md-plugins for handling imported examples in markdown files.",
   "keywords": [
     "markdown-it",
@@ -38,10 +38,11 @@
     "access": "public"
   },
   "dependencies": {
-    "tinyglobby": "^0.2.10"
+    "tinyglobby": "^0.2.10",
+    "vite": "^6.0.6"
   },
   "scripts": {
     "build": "unbuild",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist/ node_modules/"
   }
 }