@md-plugins/vite-md-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

@@ -47,16 +47,16 @@ pnpm add @md-plugins/vite-md-plugin
 To use the `viteMdPlugin`, configure it in your Vite project:
 
 ```js
-import { defineConfig } from 'vite';
-import vue from '@vitejs/plugin-vue';
-import { viteMdPlugin } from 'vite-md-plugin';
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { viteMdPlugin } from 'vite-md-plugin'
 
-const menu = []; // Define your navigation menu structure here
-const basePath = '/docs'; // Base path prefix
+const menu = [] // Define your navigation menu structure here
+const basePath = '/docs' // Base path prefix
 
 export default defineConfig({
   plugins: [vue(), viteMdPlugin(basePath, menu)],
-});
+})
 ```
 
 ## Quasar Framework Configuration
@@ -102,7 +102,7 @@ The `viteMdPlugin` allows you to define a navigation structure that can be updat
 const menu = [
   { title: 'Home', path: '/home' },
   { title: 'About', path: '/about' },
-];
+]
 ```
 
 This menu is passed as a parameter to the plugin and can be used to build a dynamic sidebar or navigation bar in your application.
@@ -122,16 +122,16 @@ The `menu` parameter should conform to the following structure:
 
 ```ts
 export interface MenuItem {
-  name: string;
-  path?: string;
-  icon?: string;
-  iconColor?: string;
-  rightIcon?: string;
-  rightIconColor?: string;
-  badge?: string;
-  children?: MenuItem[];
-  external?: boolean;
-  expanded?: boolean;
+  name: string
+  path?: string
+  icon?: string
+  iconColor?: string
+  rightIcon?: string
+  rightIconColor?: string
+  badge?: string
+  children?: MenuItem[]
+  external?: boolean
+  expanded?: boolean
 }
 ```
 

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { Plugin } from 'vite';
+
 interface MenuItem {
     name: string;
     path?: string;
@@ -6,7 +8,7 @@ interface MenuItem {
     rightIcon?: string;
     rightIconColor?: string;
     badge?: string;
-    children?: MenuItem[];
+    children?: MenuItem[] | undefined;
     external?: boolean;
     expanded?: boolean;
 }
@@ -33,18 +35,6 @@ interface RelatedItem {
     path: string;
 }
 
-/**
- * Transforms markdown content into Vue Single File Component (SFC) format.
- *
- * @param code - The markdown content to be transformed.
- * @param id - The identifier (typically the file path) of the markdown file.
- * @returns The transformed Vue SFC content, or null if the file is not a markdown file.
- * @throws Will throw an error if the markdown transformation process fails.
- */
-declare function transform(code: string, id: string): {
-    code: string;
-    map: null;
-} | null;
 /**
  * Creates a Vite plugin for processing Markdown files.
  * This plugin transforms Markdown content into Vue Single File Components (SFCs).
@@ -53,10 +43,6 @@ declare function transform(code: string, id: string): {
  * @param menu - An array of MenuItem objects representing the navigation menu structure.
  * @returns A Vite plugin object with pre-configured settings for Markdown processing.
  */
-declare function viteMdPlugin(path: string, menu: MenuItem[]): {
-    name: string;
-    enforce: string;
-    transform: typeof transform;
-};
+declare function viteMdPlugin(path: string, menu: MenuItem[]): Plugin;
 
 export { type FlatMenu, type FlatMenuEntry, type MenuItem, type MenuNode, type NavItem, type RelatedItem, viteMdPlugin };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Plugin } from 'vite';
+
 interface MenuItem {
     name: string;
     path?: string;
@@ -6,7 +8,7 @@ interface MenuItem {
     rightIcon?: string;
     rightIconColor?: string;
     badge?: string;
-    children?: MenuItem[];
+    children?: MenuItem[] | undefined;
     external?: boolean;
     expanded?: boolean;
 }
@@ -33,18 +35,6 @@ interface RelatedItem {
     path: string;
 }
 
-/**
- * Transforms markdown content into Vue Single File Component (SFC) format.
- *
- * @param code - The markdown content to be transformed.
- * @param id - The identifier (typically the file path) of the markdown file.
- * @returns The transformed Vue SFC content, or null if the file is not a markdown file.
- * @throws Will throw an error if the markdown transformation process fails.
- */
-declare function transform(code: string, id: string): {
-    code: string;
-    map: null;
-} | null;
 /**
  * Creates a Vite plugin for processing Markdown files.
  * This plugin transforms Markdown content into Vue Single File Components (SFCs).
@@ -53,10 +43,6 @@ declare function transform(code: string, id: string): {
  * @param menu - An array of MenuItem objects representing the navigation menu structure.
  * @returns A Vite plugin object with pre-configured settings for Markdown processing.
  */
-declare function viteMdPlugin(path: string, menu: MenuItem[]): {
-    name: string;
-    enforce: string;
-    transform: typeof transform;
-};
+declare function viteMdPlugin(path: string, menu: MenuItem[]): Plugin;
 
 export { type FlatMenu, type FlatMenuEntry, type MenuItem, type MenuNode, type NavItem, type RelatedItem, viteMdPlugin };

package/dist/index.mjs

@@ -55,7 +55,7 @@ function createMarkdownRenderer(options = {}) {
   md2.use(containersPlugin, containers, createContainer);
   md2.use(blockquotePlugin, { blockquoteClass: "markdown-note" });
   md2.use(tablePlugin, {
-    tableClass: "markdown-page-table",
+    tableClass: "markdown-table",
     tableHeaderClass: "text-left",
     tableToken: "q-markup-table",
     tableAttributes: [
@@ -209,18 +209,14 @@ function getVueComponent(rendered, code, id, prefix, menu) {
   }
   const frontmatter = rendered?.frontmatter || {};
   if (frontmatter.editLink !== false) {
-    frontmatter.editLink = id.substring(
-      id.indexOf("src/pages/") + 10,
-      id.length - 3
-    );
+    frontmatter.editLink = id.substring(id.indexOf("src/pages/") + 10, id.length - 3);
   }
   const title = frontmatter.title || rendered.env.title || rendered.title || "Generic Page";
   const desc = frontmatter.desc || false;
+  const fullscreen = frontmatter.fullscreen || false;
   const overline = frontmatter.overline || false;
-  const heading = rendered.env.heading || !!title || false;
-  const related = frontmatter.related && Array.isArray(frontmatter.related) && frontmatter.related.map(
-    (entry) => convertToRelated(prefix, flatMenu, entry, id)
-  ) || false;
+  const heading = rendered.env.heading || false;
+  const related = frontmatter.related && Array.isArray(frontmatter.related) && frontmatter.related.map((entry) => convertToRelated(prefix, flatMenu, entry, id)) || false;
   const nav = frontmatter.nav || false;
   const badge = frontmatter.badge || false;
   const toc = rendered.env.toc || false;
@@ -237,6 +233,7 @@ function getVueComponent(rendered, code, id, prefix, menu) {
   <markdown-page
     title="${title}"
     ${desc !== false ? `desc="${desc}"` : ""}
+    ${fullscreen !== false ? "fullscreen" : ""}
     ${overline !== false ? `overline="${overline}"` : ""}
     ${badge !== false ? `badge="${badge}"` : ""}
     ${heading !== false ? "heading" : ""}
@@ -272,13 +269,9 @@ function mdParse(code, id, prefix, menu) {
     },
     pageScripts: /* @__PURE__ */ new Set()
   };
-  env.pageScripts.add(
-    "import MarkdownPage from 'src/layouts/MarkdownPage.vue'"
-  );
+  env.pageScripts.add("import MarkdownPage from 'src/layouts/MarkdownPage.vue'");
   if (markdownApiRE.test(code) === true) {
-    env.pageScripts.add(
-      "import MarkdownApi from 'components/md/MarkdownApi.vue'"
-    );
+    env.pageScripts.add("import MarkdownApi from 'components/md/MarkdownApi.vue'");
   }
   if (markdownInstallationRE.test(code) === true) {
     env.pageScripts.add(
@@ -286,20 +279,14 @@ function mdParse(code, id, prefix, menu) {
     );
   }
   if (markdownTreeRE.test(code) === true) {
-    env.pageScripts.add(
-      "import MarkdownTree from 'components/md/MarkdownTree.vue'"
-    );
+    env.pageScripts.add("import MarkdownTree from 'components/md/MarkdownTree.vue'");
   }
   const results = md.render(code, env);
   if (env.frontmatter.examples !== void 0) {
-    env.pageScripts.add(
-      "import MarkdownExample from 'components/md/MarkdownExample.vue'"
-    );
+    env.pageScripts.add("import MarkdownExample from 'components/md/MarkdownExample.vue'");
   }
   if (markdownLinkRE.test(code) === true) {
-    env.pageScripts.add(
-      "import MarkdownLink from 'components/md/MarkdownLink.vue'"
-    );
+    env.pageScripts.add("import MarkdownLink from 'components/md/MarkdownLink.vue'");
   }
   const component = getVueComponent(results, code, id, prefix, menu);
   return {
@@ -315,7 +302,8 @@ let globalPrefix = "";
 function transform(code, id) {
   if (!mdRE.test(id)) return null;
   try {
-    return mdParse(code, id, globalPrefix, globalMenu);
+    const result = mdParse(code, id, globalPrefix, globalMenu);
+    return result.code;
   } catch (err) {
     console.error(`Error processing Markdown file: ${id}`, err);
     throw new Error(
@@ -323,11 +311,31 @@ function transform(code, id) {
     );
   }
 }
+function hotUpdate({
+  file,
+  server,
+  modules,
+  timestamp
+}) {
+  if (mdRE.test(file)) {
+    const invalidatedModules = /* @__PURE__ */ new Set();
+    for (const mod of modules) {
+      server.moduleGraph.invalidateModule(mod, invalidatedModules, timestamp, true);
+    }
+    server.ws.send({
+      type: "full-reload",
+      path: "*"
+    });
+  }
+  return [];
+}
 const mdPlugins = {
   name: "md-plugins:vitePlugin",
   enforce: "pre",
   // before vue
-  transform
+  transform,
+  // handleHotUpdate,
+  hotUpdate
 };
 function viteMdPlugin(path, menu) {
   globalMenu = menu;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@md-plugins/vite-md-plugin",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.2",
   "description": "A very opinionated Vite plugin for @md-plugins.",
   "keywords": [
     "markdown-it",
@@ -34,27 +34,28 @@
   "files": [
     "./dist"
   ],
-  "devDependencies": {
+  "dependencies": {
     "@types/markdown-it": "^14.1.2",
     "markdown-it": "^14.1.0",
-    "@md-plugins/shared": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-containers": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-headers": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-frontmatter": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-inlinecode": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-imports": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-table": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-title": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-codeblocks": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-blockquote": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-image": "0.1.0-alpha.1",
-    "@md-plugins/md-plugin-link": "0.1.0-alpha.1"
+    "vite": "^6.0.6",
+    "@md-plugins/md-plugin-blockquote": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-containers": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-codeblocks": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-frontmatter": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-imports": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-image": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-headers": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-link": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-inlinecode": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-table": "0.1.0-alpha.2",
+    "@md-plugins/md-plugin-title": "0.1.0-alpha.2",
+    "@md-plugins/shared": "0.1.0-alpha.2"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "build": "unbuild",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist/ node_modules/"
   }
 }