@md-plugins/quasar-app-extension-q-press 0.1.0-beta.5 → 0.1.0-beta.7

package/README.md

@@ -4,9 +4,9 @@ The Ultimate Markdown Solution for the Quasar Framework.
 
 See the [documentation](https://md-plugins.netlify.app/quasar-app-extensions/qpress/overview) for more information.
 
-> Current beta release: `0.1.0-beta.4`.
+> Current beta release: `0.1.0-beta.7`.
 >
-> Q-Press currently targets Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.19`. TypeScript processing is required.
+> Q-Press currently targets Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.26`. TypeScript processing is required.
 
 ## Features
 
@@ -26,14 +26,12 @@ See the [documentation](https://md-plugins.netlify.app/quasar-app-extensions/qpr
 - `quasar ext add @md-plugins/q-press`
 - Here is what gets installed on a **new** install:
   - `src/.q-press`
-  - `src/q-press.globals.d.ts`
   - `src/components`
   - `src/markdown`
   - `src/examples`
   - `src/siteConfig`
 - Here is what gets installed on an **update** install:
   - `src/.q-press`
-  - `src/q-press.globals.d.ts`
 
 2. Install `markdown-it` and `@types/markdown-it` in your project devDependencies
 
@@ -220,7 +218,7 @@ If you don't have a `.prettierignore` file, create one and add the following:
 
 ## Updating
 
-When you update, only the `src/.q-press` folder will be updated as well as the file `src/q-press.globals.d.ts`. If you want to re-install everything, just remove the `src/siteConfig` folder.
+When you update, only the `src/.q-press` folder will be updated. If you want to re-install everything, just remove the `src/siteConfig` folder.
 
 To make it easier to update, you can use the following command:
 

package/dist/index.js

@@ -5,6 +5,8 @@
  * Docs: https://quasar.dev/app-extensions/development-guide/index-api
  */
 import { defineIndexScript } from '@quasar/app-vite';
+import { fileURLToPath } from 'node:url';
+const qPressGlobalsTsConfigPath = fileURLToPath(new URL('./q-press-globals.d.ts', import.meta.url)).replace(/\\/g, '/');
 function normalizeAlias(alias) {
     if (Array.isArray(alias)) {
         return [...alias];
@@ -25,18 +27,33 @@ function addQuasarSourceAlias(viteConf, appDir) {
         },
     ];
 }
+function addQPressGlobalsToTsConfig(tsConfig) {
+    tsConfig.files ??= [];
+    if (!tsConfig.files.includes(qPressGlobalsTsConfigPath)) {
+        tsConfig.files.push(qPressGlobalsTsConfigPath);
+    }
+}
+function extendTypeScriptConfig(typescriptConfig) {
+    const userExtendTsConfig = typescriptConfig.extendTsConfig;
+    typescriptConfig.extendTsConfig = (tsConfig) => {
+        userExtendTsConfig?.(tsConfig);
+        addQPressGlobalsToTsConfig(tsConfig);
+    };
+}
 export default defineIndexScript((api) => {
     // verify this is a Vite project
     if (!api.hasVite) {
         throw new Error('This extension requires Vite');
     }
     api.compatibleWith('quasar', '^2.0.0');
-    api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.19');
+    api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.26');
     // here we extend /quasar.config, so we can add some Vite/Vue stuff
     api.extendQuasarConf(async (config) => {
         config.build ??= {};
+        config.build.typescript ??= {};
         config.build.viteVuePluginOptions ??= {};
         config.framework ??= {};
+        extendTypeScriptConfig(config.build.typescript);
         // make sure 'vueRouterMode' has 'history' mode
         if (config.build.vueRouterMode !== 'history') {
             console.warn('Changing vueRouterMode to "history" - required for hash links to work correctly');

package/dist/install.js

@@ -11,7 +11,7 @@ export default defineInstallScript(async (api) => {
         throw new Error('This extension requires Vite');
     }
     api.compatibleWith('quasar', '^2.0.0');
-    api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.19');
+    api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.26');
     // project must have pinia installed
     if ((await api.getStorePackageName()) !== 'pinia') {
         console.error('-----------------------------');

package/dist/q-press-globals.d.ts

@@ -0,0 +1,49 @@
+/// <reference types="@quasar/app-vite/client" />
+
+declare module '*.md'
+
+declare global {
+  interface ImportMetaHot {
+    accept(callback?: (..._args: unknown[]) => unknown): void
+  }
+
+  interface ImportMeta {
+    readonly env: ImportMetaEnv
+    glob: <T = unknown>(pattern: string) => Record<string, () => Promise<T>>
+    hot?: ImportMetaHot
+  }
+
+  interface TocMenuItem {
+    id: string
+    level: number
+    title: string
+    link?: string
+    deep?: boolean
+    sub?: boolean
+    onClick?: () => void
+    children?: TocMenuItem[]
+  }
+
+  interface MarkdownModule {
+    title?: string
+    headers?: TocMenuItem[]
+    frontmatter?: Record<string, unknown>
+    filename?: string
+    render: (..._args: unknown[]) => unknown
+  }
+
+  interface MenuItem {
+    name: string
+    path?: string
+    icon?: string
+    iconColor?: string
+    rightIcon?: string
+    rightIconColor?: string
+    badge?: string
+    children?: MenuItem[] | undefined
+    external?: boolean
+    expanded?: boolean
+  }
+}
+
+export {}

package/dist/templates/init/src/_q-press/layouts/MarkdownPage.vue

@@ -94,7 +94,6 @@ import { useRoute } from 'vue-router'
 import { mdiPencil, mdiFlash, mdiLaunch } from '@quasar/extras/mdi-v7'
 
 import type { NavItem, RelatedItem } from '@md-plugins/vite-md-plugin'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 import MarkdownLink from '../components/MarkdownLink.vue'
 import MarkdownPageToc from './MarkdownPageToc.vue'
 
@@ -129,7 +128,7 @@ const props = defineProps({
   },
 
   toc: {
-    type: Array<TocItem>,
+    type: Array<TocMenuItem>,
     default: () => [],
   },
   related: {

package/dist/templates/init/src/_q-press/stores/markdown.ts

@@ -1,7 +1,6 @@
 import { defineStore, acceptHMRUpdate } from 'pinia'
 import { useRoute } from 'vue-router'
 import { useScroll } from '../composables/scroll'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 
 export const useMarkdownStore = defineStore('markdown-store', {
   state: () => ({
@@ -60,7 +59,7 @@ export const useMarkdownStore = defineStore('markdown-store', {
       }
     },
 
-    setToc(toc: TocItem[]) {
+    setToc(toc: TocMenuItem[]) {
       const { scrollTo } = useScroll()
       this.toc =
         toc !== void 0

package/dist/templates/init/src/markdown/getting-started/introduction.md

@@ -21,7 +21,7 @@ Markdown Plugins are a set of tools and extensions designed to enhance the funct
 - **Title Extraction**: Extract the first header in Markdown as the page title.
 - **Script Imports**: Extract and process **<script import>** blocks from Markdown.
 - **Code Block Enhancements**: Enhance code block rendering with syntax highlighting, tabs, and more.
-- **Custom Styling**: Apply custom styles to your Markdown content for a more polished look.
+- **Custom Styling**: Apply custom styles to your Markdown content for a more refined look.
 - **Integration**: Easily integrate with other tools and platforms to streamline your workflow.
 
 ## Why Use Markdown Plugins?
@@ -48,7 +48,7 @@ Here are some examples of what you can achieve with Markdown Plugins:
 
 - **Custom Syntax**: Add custom syntax for specific use cases.
 - **Enhanced Components**: Embed interactive and enhanced components.
-- **Custom Styling**: Apply custom styles to your content for a polished look.
+- **Custom Styling**: Apply custom styles to your content for a refined look.
 - **Frontmatter Support**: Extract and process frontmatter content from your Markdown files.
 - **Header Management**: Extract and process headers for generating ToCs or managing headers.
 - **Inline Code Styling**: Add custom classes to inline code blocks for styling.

package/dist/templates/init/src/markdown/guides/upgrade-guide.md

@@ -7,16 +7,16 @@ related:
   - vite-plugins/vite-md-plugin/overview
 ---
 
-The `0.1.0` beta line moves MD-Plugins and Q-Press to the Quasar CLI Vite 3 beta toolchain. It is the right version to use when your Quasar application is being upgraded to `@quasar/app-vite` `>=3.0.0-beta.19`.
+The `0.1.0` beta line moves MD-Plugins and Q-Press to the Quasar CLI Vite 3 beta toolchain. It is the right version to use when your Quasar application is being upgraded to `@quasar/app-vite` `>=3.0.0-beta.26`.
 
 ::: warning
-Q-Press and the Quasar app extensions now target Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.19`. They are not intended for Webpack projects or JavaScript-only Quasar projects.
+Q-Press and the Quasar app extensions now target Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.26`. They are not intended for Webpack projects or JavaScript-only Quasar projects.
 :::
 
 ## Before You Upgrade
 
 - Make sure your app is already on a Quasar Vite setup.
-- Upgrade the app to `@quasar/app-vite` `>=3.0.0-beta.19`.
+- Upgrade the app to `@quasar/app-vite` `>=3.0.0-beta.26`.
 - Use TypeScript in the consuming Quasar project.
 - Import `defineConfig` in `quasar.config.ts` directly from `@quasar/app-vite`.
 - Use `/// <reference types="@quasar/app-vite/client" />` in `src/env.d.ts`.
@@ -39,15 +39,9 @@ For direct Vite plugin usage, update the packages you consume:
 pnpm up @md-plugins/vite-md-plugin@beta @md-plugins/vite-examples-plugin@beta
 ```
 
-## File Name Check
+## Q-Press Type Globals
 
-Q-Press installs and updates this type shim:
-
-```text
-src/q-press.globals.d.ts
-```
-
-If your project still references `src/q-press.global.d.ts`, rename the reference to the plural `globals` filename.
+Q-Press now provides its shared Markdown, menu and `ImportMeta` globals directly from the app extension package. After upgrading to this release line and running `quasar prepare`, projects no longer need to keep a local `src/q-press.globals.d.ts` file.
 
 ## Environment Variable Changes
 

package/dist/templates/init/src/markdown/quasar-app-extensions/qpress/overview.md

@@ -6,7 +6,7 @@ desc: Q-Press App-Extension for Quasar.
 The Q-Press App Extension is a powerful tool for Quasar developers that simplifies the integration of Markdown content into Quasar applications. It leverages the capabilities of Vite and various Markdown plugins to transform Markdown files into Vue components, enabling a seamless and efficient workflow for content management.
 
 ::: warning
-Q-Press is for Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.19` at this time. TypeScript processing is also required. Do not use if you are using Webpack or have a JavaScript-only project.
+Q-Press is for Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.26` at this time. TypeScript processing is also required. Do not use if you are using Webpack or have a JavaScript-only project.
 :::
 
 ::: tip
@@ -33,14 +33,12 @@ quasar ext add @md-plugins/q-press
 
 - **New Install:**
   - `src/.q-press`
-  - `src/q-press.globals.d.ts`
   - `src/components`
   - `src/markdown`
   - `src/examples`
   - `src/siteConfig`
 - **Update Install:**
   - `src/.q-press`
-  - `src/q-press.globals.d.ts`
 
 ### Additional Dependencies
 
@@ -311,7 +309,7 @@ If you don't have a `.prettierignore` file, create one in the root of your proje
 
 ## Updating
 
-When you update, only the `src/.q-press` folder will be updated as well as the file `src/q-press.globals.d.ts`. If you want to re-install everything, just remove the `src/siteConfig` folder.
+When you update, only the `src/.q-press` folder will be updated. If you want to re-install everything, just remove the `src/siteConfig` folder.
 
 To make it easier to update, you can use the following command:
 

package/dist/templates/init/src/markdown/quasar-app-extensions/vite-md-plugin-app-ext/overview.md

@@ -9,7 +9,7 @@ related:
 The `viteMdPluginAppExt` is a [Quasar App Extension](https://quasar.dev/app-extensions/introduction) that integrates the `viteMdPlugin` into your Quasar project. This extension allows you to use Markdown files as Vue components, enabling a seamless integration of Markdown content into your Quasar application.
 
 ::: warning
-This app extension targets Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.19`.
+This app extension targets Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.26`.
 :::
 
 ## Key Features

package/dist/templates/update/src/_q-press/layouts/MarkdownPage.vue

@@ -94,7 +94,6 @@ import { useRoute } from 'vue-router'
 import { mdiPencil, mdiFlash, mdiLaunch } from '@quasar/extras/mdi-v7'
 
 import type { NavItem, RelatedItem } from '@md-plugins/vite-md-plugin'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 import MarkdownLink from '../components/MarkdownLink.vue'
 import MarkdownPageToc from './MarkdownPageToc.vue'
 
@@ -129,7 +128,7 @@ const props = defineProps({
   },
 
   toc: {
-    type: Array<TocItem>,
+    type: Array<TocMenuItem>,
     default: () => [],
   },
   related: {

package/dist/templates/update/src/_q-press/stores/markdown.ts

@@ -1,7 +1,6 @@
 import { defineStore, acceptHMRUpdate } from 'pinia'
 import { useRoute } from 'vue-router'
 import { useScroll } from '../composables/scroll'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 
 export const useMarkdownStore = defineStore('markdown-store', {
   state: () => ({
@@ -60,7 +59,7 @@ export const useMarkdownStore = defineStore('markdown-store', {
       }
     },
 
-    setToc(toc: TocItem[]) {
+    setToc(toc: TocMenuItem[]) {
       const { scrollTo } = useScroll()
       this.toc =
         toc !== void 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@md-plugins/quasar-app-extension-q-press",
-  "version": "0.1.0-beta.5",
+  "version": "0.1.0-beta.7",
   "description": "QPress - The Ultimate Markdown Solution for Quasar Framework",
   "keywords": [
     "markdown",
@@ -22,6 +22,7 @@
   },
   "type": "module",
   "main": "dist/index.js",
+  "types": "dist/q-press-globals.d.ts",
   "publishConfig": {
     "access": "public"
   },
@@ -29,32 +30,32 @@
     "@types/markdown-it": "^14.1.2",
     "fs-extra": "^11.3.5",
     "markdown-it": "^14.1.1",
-    "@md-plugins/md-plugin-blockquote": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-frontmatter": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-headers": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-containers": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-image": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-codeblocks": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-imports": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-inlinecode": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-link": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-table": "0.1.0-beta.5",
-    "@md-plugins/md-plugin-title": "0.1.0-beta.5",
-    "@md-plugins/shared": "0.1.0-beta.5",
-    "@md-plugins/vite-md-plugin": "0.1.0-beta.5"
+    "@md-plugins/md-plugin-codeblocks": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-containers": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-blockquote": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-image": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-frontmatter": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-headers": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-imports": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-inlinecode": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-table": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-link": "0.1.0-beta.7",
+    "@md-plugins/md-plugin-title": "0.1.0-beta.7",
+    "@md-plugins/shared": "0.1.0-beta.7",
+    "@md-plugins/vite-md-plugin": "0.1.0-beta.7"
   },
   "devDependencies": {
-    "@quasar/app-vite": "3.0.0-beta.20",
+    "@quasar/app-vite": "3.0.0-beta.26",
     "@types/markdown-it": "^14.1.2",
     "vite": "^8.0.14"
   },
   "peerDependencies": {
-    "@quasar/app-vite": ">=3.0.0-beta.20",
+    "@quasar/app-vite": ">=3.0.0-beta.26",
     "markdown-it": "^14.1.0"
   },
   "engines": {
     "node": ">=22.13",
-    "pnpm": ">=11.1.0"
+    "pnpm": ">=11.3.0"
   },
   "scripts": {
     "build": "pnpm exec tsc -p ./tsconfig.build.json && node ./scripts/build.js",

package/src/index.ts

@@ -6,6 +6,7 @@
  */
 
 import { defineIndexScript } from '@quasar/app-vite'
+import { fileURLToPath } from 'node:url'
 
 // import fse from 'fs-extra'
 // import { viteMdPlugin } from '@md-plugins/vite-md-plugin'
@@ -23,6 +24,18 @@ type ViteConfigWithAlias = {
   }
 }
 
+type QuasarTsConfig = {
+  files?: string[]
+}
+
+type QuasarTypescriptConfig = {
+  extendTsConfig?: (tsConfig: QuasarTsConfig) => void
+}
+
+const qPressGlobalsTsConfigPath = fileURLToPath(
+  new URL('./q-press-globals.d.ts', import.meta.url),
+).replace(/\\/g, '/')
+
 function normalizeAlias(alias: ViteAlias | undefined): ViteAliasEntry[] {
   if (Array.isArray(alias)) {
     return [...alias]
@@ -47,6 +60,23 @@ function addQuasarSourceAlias(viteConf: ViteConfigWithAlias, appDir: string): vo
   ]
 }
 
+function addQPressGlobalsToTsConfig(tsConfig: QuasarTsConfig): void {
+  tsConfig.files ??= []
+
+  if (!tsConfig.files.includes(qPressGlobalsTsConfigPath)) {
+    tsConfig.files.push(qPressGlobalsTsConfigPath)
+  }
+}
+
+function extendTypeScriptConfig(typescriptConfig: QuasarTypescriptConfig): void {
+  const userExtendTsConfig = typescriptConfig.extendTsConfig
+
+  typescriptConfig.extendTsConfig = (tsConfig) => {
+    userExtendTsConfig?.(tsConfig)
+    addQPressGlobalsToTsConfig(tsConfig)
+  }
+}
+
 export default defineIndexScript((api) => {
   // verify this is a Vite project
   if (!api.hasVite) {
@@ -54,14 +84,17 @@ export default defineIndexScript((api) => {
   }
 
   api.compatibleWith('quasar', '^2.0.0')
-  api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.19')
+  api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.26')
 
   // here we extend /quasar.config, so we can add some Vite/Vue stuff
   api.extendQuasarConf(async (config) => {
     config.build ??= {}
+    config.build.typescript ??= {}
     config.build.viteVuePluginOptions ??= {}
     config.framework ??= {}
 
+    extendTypeScriptConfig(config.build.typescript)
+
     // make sure 'vueRouterMode' has 'history' mode
     if (config.build.vueRouterMode !== 'history') {
       console.warn(

package/src/install.ts

@@ -14,7 +14,7 @@ export default defineInstallScript(async (api) => {
   }
 
   api.compatibleWith('quasar', '^2.0.0')
-  api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.19')
+  api.compatibleWith('@quasar/app-vite', '>=3.0.0-beta.26')
 
   // project must have pinia installed
   if ((await api.getStorePackageName()) !== 'pinia') {

package/src/q-press-globals.d.ts

@@ -0,0 +1,49 @@
+/// <reference types="@quasar/app-vite/client" />
+
+declare module '*.md'
+
+declare global {
+  interface ImportMetaHot {
+    accept(callback?: (..._args: unknown[]) => unknown): void
+  }
+
+  interface ImportMeta {
+    readonly env: ImportMetaEnv
+    glob: <T = unknown>(pattern: string) => Record<string, () => Promise<T>>
+    hot?: ImportMetaHot
+  }
+
+  interface TocMenuItem {
+    id: string
+    level: number
+    title: string
+    link?: string
+    deep?: boolean
+    sub?: boolean
+    onClick?: () => void
+    children?: TocMenuItem[]
+  }
+
+  interface MarkdownModule {
+    title?: string
+    headers?: TocMenuItem[]
+    frontmatter?: Record<string, unknown>
+    filename?: string
+    render: (..._args: unknown[]) => unknown
+  }
+
+  interface MenuItem {
+    name: string
+    path?: string
+    icon?: string
+    iconColor?: string
+    rightIcon?: string
+    rightIconColor?: string
+    badge?: string
+    children?: MenuItem[] | undefined
+    external?: boolean
+    expanded?: boolean
+  }
+}
+
+export {}

package/src/templates/init/src/_q-press/css/app.scss

@@ -328,33 +328,30 @@ body.q-scroll--lock .q-page > .q-scroll--anchor {
   overflow-anchor: auto;
 }
 
-// Makes scrollbars look better for header drop-downs and search results.
-.markdown-header-menu,
-.markdown-search__results {
-  &::-webkit-scrollbar {
-    height: 12px;
-    width: 14px;
-    background: transparent;
-    z-index: 12;
-    overflow: visible;
-  }
-
-  &::-webkit-scrollbar-thumb {
-    width: 10px;
-    background-color: $brand-primary;
-    border-radius: 10px;
-    z-index: 12;
-    border: 4px solid rgba(0, 0, 0, 0);
-    background-clip: padding-box;
-    transition: background-color $header-quick-transition;
-    margin: 4px;
-    min-height: 32px;
-    min-width: 32px;
-  }
-
-  &::-webkit-scrollbar-thumb:hover {
-    background: $brand-primary;
-  }
+// makes the scroll bar look better for the drop-down menus in the header
+::-webkit-scrollbar {
+  height: 12px;
+  width: 14px;
+  background: transparent;
+  z-index: 12;
+  overflow: visible;
+}
+
+::-webkit-scrollbar-thumb {
+  width: 10px;
+  background-color: $brand-primary;
+  border-radius: 10px;
+  z-index: 12;
+  border: 4px solid rgba(0, 0, 0, 0);
+  background-clip: padding-box;
+  transition: background-color $header-quick-transition;
+  margin: 4px;
+  min-height: 32px;
+  min-width: 32px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: $brand-primary;
 }
 
 .shadow-bottom {

package/src/templates/init/src/_q-press/layouts/MarkdownPage.vue

@@ -94,7 +94,6 @@ import { useRoute } from 'vue-router'
 import { mdiPencil, mdiFlash, mdiLaunch } from '@quasar/extras/mdi-v7'
 
 import type { NavItem, RelatedItem } from '@md-plugins/vite-md-plugin'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 import MarkdownLink from '../components/MarkdownLink.vue'
 import MarkdownPageToc from './MarkdownPageToc.vue'
 
@@ -129,7 +128,7 @@ const props = defineProps({
   },
 
   toc: {
-    type: Array<TocItem>,
+    type: Array<TocMenuItem>,
     default: () => [],
   },
   related: {

package/src/templates/init/src/_q-press/stores/markdown.ts

@@ -1,7 +1,6 @@
 import { defineStore, acceptHMRUpdate } from 'pinia'
 import { useRoute } from 'vue-router'
 import { useScroll } from '../composables/scroll'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 
 export const useMarkdownStore = defineStore('markdown-store', {
   state: () => ({
@@ -60,7 +59,7 @@ export const useMarkdownStore = defineStore('markdown-store', {
       }
     },
 
-    setToc(toc: TocItem[]) {
+    setToc(toc: TocMenuItem[]) {
       const { scrollTo } = useScroll()
       this.toc =
         toc !== void 0

package/src/templates/init/src/markdown/getting-started/introduction.md

@@ -21,7 +21,7 @@ Markdown Plugins are a set of tools and extensions designed to enhance the funct
 - **Title Extraction**: Extract the first header in Markdown as the page title.
 - **Script Imports**: Extract and process **<script import>** blocks from Markdown.
 - **Code Block Enhancements**: Enhance code block rendering with syntax highlighting, tabs, and more.
-- **Custom Styling**: Apply custom styles to your Markdown content for a more polished look.
+- **Custom Styling**: Apply custom styles to your Markdown content for a more refined look.
 - **Integration**: Easily integrate with other tools and platforms to streamline your workflow.
 
 ## Why Use Markdown Plugins?
@@ -48,7 +48,7 @@ Here are some examples of what you can achieve with Markdown Plugins:
 
 - **Custom Syntax**: Add custom syntax for specific use cases.
 - **Enhanced Components**: Embed interactive and enhanced components.
-- **Custom Styling**: Apply custom styles to your content for a polished look.
+- **Custom Styling**: Apply custom styles to your content for a refined look.
 - **Frontmatter Support**: Extract and process frontmatter content from your Markdown files.
 - **Header Management**: Extract and process headers for generating ToCs or managing headers.
 - **Inline Code Styling**: Add custom classes to inline code blocks for styling.

package/src/templates/init/src/markdown/guides/upgrade-guide.md

@@ -7,16 +7,16 @@ related:
   - vite-plugins/vite-md-plugin/overview
 ---
 
-The `0.1.0` beta line moves MD-Plugins and Q-Press to the Quasar CLI Vite 3 beta toolchain. It is the right version to use when your Quasar application is being upgraded to `@quasar/app-vite` `>=3.0.0-beta.19`.
+The `0.1.0` beta line moves MD-Plugins and Q-Press to the Quasar CLI Vite 3 beta toolchain. It is the right version to use when your Quasar application is being upgraded to `@quasar/app-vite` `>=3.0.0-beta.26`.
 
 ::: warning
-Q-Press and the Quasar app extensions now target Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.19`. They are not intended for Webpack projects or JavaScript-only Quasar projects.
+Q-Press and the Quasar app extensions now target Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.26`. They are not intended for Webpack projects or JavaScript-only Quasar projects.
 :::
 
 ## Before You Upgrade
 
 - Make sure your app is already on a Quasar Vite setup.
-- Upgrade the app to `@quasar/app-vite` `>=3.0.0-beta.19`.
+- Upgrade the app to `@quasar/app-vite` `>=3.0.0-beta.26`.
 - Use TypeScript in the consuming Quasar project.
 - Import `defineConfig` in `quasar.config.ts` directly from `@quasar/app-vite`.
 - Use `/// <reference types="@quasar/app-vite/client" />` in `src/env.d.ts`.
@@ -39,15 +39,9 @@ For direct Vite plugin usage, update the packages you consume:
 pnpm up @md-plugins/vite-md-plugin@beta @md-plugins/vite-examples-plugin@beta
 ```
 
-## File Name Check
+## Q-Press Type Globals
 
-Q-Press installs and updates this type shim:
-
-```text
-src/q-press.globals.d.ts
-```
-
-If your project still references `src/q-press.global.d.ts`, rename the reference to the plural `globals` filename.
+Q-Press now provides its shared Markdown, menu and `ImportMeta` globals directly from the app extension package. After upgrading to this release line and running `quasar prepare`, projects no longer need to keep a local `src/q-press.globals.d.ts` file.
 
 ## Environment Variable Changes
 

package/src/templates/init/src/markdown/quasar-app-extensions/qpress/overview.md

@@ -6,7 +6,7 @@ desc: Q-Press App-Extension for Quasar.
 The Q-Press App Extension is a powerful tool for Quasar developers that simplifies the integration of Markdown content into Quasar applications. It leverages the capabilities of Vite and various Markdown plugins to transform Markdown files into Vue components, enabling a seamless and efficient workflow for content management.
 
 ::: warning
-Q-Press is for Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.19` at this time. TypeScript processing is also required. Do not use if you are using Webpack or have a JavaScript-only project.
+Q-Press is for Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.26` at this time. TypeScript processing is also required. Do not use if you are using Webpack or have a JavaScript-only project.
 :::
 
 ::: tip
@@ -33,14 +33,12 @@ quasar ext add @md-plugins/q-press
 
 - **New Install:**
   - `src/.q-press`
-  - `src/q-press.globals.d.ts`
   - `src/components`
   - `src/markdown`
   - `src/examples`
   - `src/siteConfig`
 - **Update Install:**
   - `src/.q-press`
-  - `src/q-press.globals.d.ts`
 
 ### Additional Dependencies
 
@@ -311,7 +309,7 @@ If you don't have a `.prettierignore` file, create one in the root of your proje
 
 ## Updating
 
-When you update, only the `src/.q-press` folder will be updated as well as the file `src/q-press.globals.d.ts`. If you want to re-install everything, just remove the `src/siteConfig` folder.
+When you update, only the `src/.q-press` folder will be updated. If you want to re-install everything, just remove the `src/siteConfig` folder.
 
 To make it easier to update, you can use the following command:
 

package/src/templates/init/src/markdown/quasar-app-extensions/vite-md-plugin-app-ext/overview.md

@@ -9,7 +9,7 @@ related:
 The `viteMdPluginAppExt` is a [Quasar App Extension](https://quasar.dev/app-extensions/introduction) that integrates the `viteMdPlugin` into your Quasar project. This extension allows you to use Markdown files as Vue components, enabling a seamless integration of Markdown content into your Quasar application.
 
 ::: warning
-This app extension targets Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.19`.
+This app extension targets Quasar Vite projects using `@quasar/app-vite` `>=3.0.0-beta.26`.
 :::
 
 ## Key Features

package/src/templates/update/src/_q-press/css/app.scss

@@ -328,33 +328,30 @@ body.q-scroll--lock .q-page > .q-scroll--anchor {
   overflow-anchor: auto;
 }
 
-// Makes scrollbars look better for header drop-downs and search results.
-.markdown-header-menu,
-.markdown-search__results {
-  &::-webkit-scrollbar {
-    height: 12px;
-    width: 14px;
-    background: transparent;
-    z-index: 12;
-    overflow: visible;
-  }
-
-  &::-webkit-scrollbar-thumb {
-    width: 10px;
-    background-color: $brand-primary;
-    border-radius: 10px;
-    z-index: 12;
-    border: 4px solid rgba(0, 0, 0, 0);
-    background-clip: padding-box;
-    transition: background-color $header-quick-transition;
-    margin: 4px;
-    min-height: 32px;
-    min-width: 32px;
-  }
-
-  &::-webkit-scrollbar-thumb:hover {
-    background: $brand-primary;
-  }
+// makes the scroll bar look better for the drop-down menus in the header
+::-webkit-scrollbar {
+  height: 12px;
+  width: 14px;
+  background: transparent;
+  z-index: 12;
+  overflow: visible;
+}
+
+::-webkit-scrollbar-thumb {
+  width: 10px;
+  background-color: $brand-primary;
+  border-radius: 10px;
+  z-index: 12;
+  border: 4px solid rgba(0, 0, 0, 0);
+  background-clip: padding-box;
+  transition: background-color $header-quick-transition;
+  margin: 4px;
+  min-height: 32px;
+  min-width: 32px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: $brand-primary;
 }
 
 .shadow-bottom {

package/src/templates/update/src/_q-press/layouts/MarkdownPage.vue

@@ -94,7 +94,6 @@ import { useRoute } from 'vue-router'
 import { mdiPencil, mdiFlash, mdiLaunch } from '@quasar/extras/mdi-v7'
 
 import type { NavItem, RelatedItem } from '@md-plugins/vite-md-plugin'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 import MarkdownLink from '../components/MarkdownLink.vue'
 import MarkdownPageToc from './MarkdownPageToc.vue'
 
@@ -129,7 +128,7 @@ const props = defineProps({
   },
 
   toc: {
-    type: Array<TocItem>,
+    type: Array<TocMenuItem>,
     default: () => [],
   },
   related: {

package/src/templates/update/src/_q-press/stores/markdown.ts

@@ -1,7 +1,6 @@
 import { defineStore, acceptHMRUpdate } from 'pinia'
 import { useRoute } from 'vue-router'
 import { useScroll } from '../composables/scroll'
-import type { TocItem } from '@md-plugins/md-plugin-headers'
 
 export const useMarkdownStore = defineStore('markdown-store', {
   state: () => ({
@@ -60,7 +59,7 @@ export const useMarkdownStore = defineStore('markdown-store', {
       }
     },
 
-    setToc(toc: TocItem[]) {
+    setToc(toc: TocMenuItem[]) {
       const { scrollTo } = useScroll()
       this.toc =
         toc !== void 0

package/dist/templates/init/src/q-press.globals.d.ts

@@ -1,36 +0,0 @@
-declare module '*.md'
-
-// Define types for headers
-interface TocMenuItem {
-  id: string
-  level: number
-  title: string
-  link?: string
-  deep?: boolean
-  sub?: boolean
-  onClick?: () => void
-  children?: TocMenuItem[]
-}
-
-// Define types for Markdown modules
-interface MarkdownModule {
-  title?: string
-  headers?: TocMenuItem[]
-  frontmatter?: Record<string, unknown>
-  filename?: string
-  render: (..._args: unknown[]) => unknown
-}
-
-// Define types for menu items
-interface MenuItem {
-  name: string
-  path?: string
-  icon?: string
-  iconColor?: string
-  rightIcon?: string
-  rightIconColor?: string
-  badge?: string
-  children?: MenuItem[] | undefined
-  external?: boolean
-  expanded?: boolean
-}

package/dist/templates/update/src/q-press.globals.d.ts

@@ -1,36 +0,0 @@
-declare module '*.md'
-
-// Define types for headers
-interface TocMenuItem {
-  id: string
-  level: number
-  title: string
-  link?: string
-  deep?: boolean
-  sub?: boolean
-  onClick?: () => void
-  children?: TocMenuItem[]
-}
-
-// Define types for Markdown modules
-interface MarkdownModule {
-  title?: string
-  headers?: TocMenuItem[]
-  frontmatter?: Record<string, unknown>
-  filename?: string
-  render: (..._args: unknown[]) => unknown
-}
-
-// Define types for menu items
-interface MenuItem {
-  name: string
-  path?: string
-  icon?: string
-  iconColor?: string
-  rightIcon?: string
-  rightIconColor?: string
-  badge?: string
-  children?: MenuItem[] | undefined
-  external?: boolean
-  expanded?: boolean
-}

package/src/templates/init/src/q-press.globals.d.ts

@@ -1,36 +0,0 @@
-declare module '*.md'
-
-// Define types for headers
-interface TocMenuItem {
-  id: string
-  level: number
-  title: string
-  link?: string
-  deep?: boolean
-  sub?: boolean
-  onClick?: () => void
-  children?: TocMenuItem[]
-}
-
-// Define types for Markdown modules
-interface MarkdownModule {
-  title?: string
-  headers?: TocMenuItem[]
-  frontmatter?: Record<string, unknown>
-  filename?: string
-  render: (..._args: unknown[]) => unknown
-}
-
-// Define types for menu items
-interface MenuItem {
-  name: string
-  path?: string
-  icon?: string
-  iconColor?: string
-  rightIcon?: string
-  rightIconColor?: string
-  badge?: string
-  children?: MenuItem[] | undefined
-  external?: boolean
-  expanded?: boolean
-}

package/src/templates/update/src/q-press.globals.d.ts

@@ -1,36 +0,0 @@
-declare module '*.md'
-
-// Define types for headers
-interface TocMenuItem {
-  id: string
-  level: number
-  title: string
-  link?: string
-  deep?: boolean
-  sub?: boolean
-  onClick?: () => void
-  children?: TocMenuItem[]
-}
-
-// Define types for Markdown modules
-interface MarkdownModule {
-  title?: string
-  headers?: TocMenuItem[]
-  frontmatter?: Record<string, unknown>
-  filename?: string
-  render: (..._args: unknown[]) => unknown
-}
-
-// Define types for menu items
-interface MenuItem {
-  name: string
-  path?: string
-  icon?: string
-  iconColor?: string
-  rightIcon?: string
-  rightIconColor?: string
-  badge?: string
-  children?: MenuItem[] | undefined
-  external?: boolean
-  expanded?: boolean
-}