v3.1.0

.github/ISSUE_TEMPLATE/bug-report-v2.yml

@@ -0,0 +1,67 @@
+name: "🐛 Bug report (v2)"
+description: Report a bug to help us improve the module (v2 only).
+labels: ["pending triage", "v2"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please carefully read the contribution docs before creating a bug report
+        👉 https://nuxt.com/docs/community/reporting-bugs
+        Please use one of the templates below to create a minimal reproduction:
+        👉 https://stackblitz.com/github/nuxt/starter/tree/content for general issues
+  - type: markdown
+    attributes:
+      value: |
+        Before reporting a bug, please make sure that you have read through our [v2 documentation](https://v2.content.nuxt.com/).
+  - type: textarea
+    id: env
+    attributes:
+      label: Environment
+      description: You can use `npx nuxi info` to fill this section
+      placeholder: |
+        - Operating System: `Darwin`
+        - Node Version:     `v18.16.0`
+        - Nuxt Version:     `3.7.3`
+        - CLI Version:      `3.8.4`
+        - Nitro Version:    `2.6.3`
+        - Package Manager:  `[email protected]`
+        - Builder:          `-`
+        - User Config:      `-`
+        - Runtime Modules:  `-`
+        - Build Modules:    `-`
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      placeholder: v2
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction
+      description: Please provide a reproduction link. A minimal [reproduction is required](https://antfu.me/posts/why-reproductions-are-required) unless you are absolutely sure that the issue is obvious and the provided information is enough to understand the problem. If a report is vague (e.g. just a generic error message) and has no reproduction, it will receive a "needs reproduction" label. If no reproduction is provided we might close it.
+      placeholder: https://github.com/my/reproduction
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is. If you intend to submit a PR for this issue, tell us in the description.
+    validations:
+      required: true
+  - type: textarea
+    id: additonal
+    attributes:
+      label: Additional context
+      description: If applicable, add any other context or screenshots here.
+  - type: textarea
+    id: logs
+    attributes:
+      label: Logs
+      description: |
+        Optional if provided reproduction. Please try not to insert an image but copy paste the log text.
+      render: shell-script

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,5 +1,5 @@
 name: "\U0001F41E Bug Report"
-description: Create a report to help us improve Nuxt
+description: Create a report to help us improve Nuxt Content
 labels: ["pending triage"]
 body:
   - type: markdown
@@ -9,40 +9,59 @@ body:
         👉 https://nuxt.com/docs/community/reporting-bugs
         Please use one of the templates below to create a minimal reproduction:
         👉 https://stackblitz.com/github/nuxt/starter/tree/content for general issues
-        👉 https://stackblitz.com/github/nuxt/starter/tree/doc-driven for document-driven mode issues
+  - type: markdown
+    attributes:
+      value: |
+        Before reporting a bug, please make sure that you have read through our [documentation](https://content.nuxt.com/).
   - type: textarea
-    id: bug-env
+    id: env
     attributes:
       label: Environment
       description: You can use `npx nuxi info` to fill this section
-      placeholder: Environment
+      placeholder: |
+        - Operating System: `Darwin`
+        - Node Version:     `v18.16.0`
+        - Nuxt Version:     `3.7.3`
+        - CLI Version:      `3.8.4`
+        - Nitro Version:    `2.6.3`
+        - Package Manager:  `[email protected]`
+        - Builder:          `-`
+        - User Config:      `-`
+        - Runtime Modules:  `-`
+        - Build Modules:    `-`
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      placeholder: v2
     validations:
       required: true
   - type: textarea
     id: reproduction
     attributes:
       label: Reproduction
-      description: Please provide a link to a repo that can reproduce the problem you ran into. A [**minimal reproduction**](https://nuxt.com/docs/community/reporting-bugs#create-a-minimal-reproduction) is required unless you are absolutely sure that the issue is obvious and the provided information is enough to understand the problem. If a report is vague (e.g. just a generic error message) and has no reproduction, it will receive a "need reproduction" label. If no reproduction is provided we might close it.
-      placeholder: Reproduction
+      description: Please provide a reproduction link. A minimal [reproduction is required](https://antfu.me/posts/why-reproductions-are-required) unless you are absolutely sure that the issue is obvious and the provided information is enough to understand the problem. If a report is vague (e.g. just a generic error message) and has no reproduction, it will receive a "needs reproduction" label. If no reproduction is provided we might close it.
+      placeholder: https://github.com/my/reproduction
     validations:
       required: true
   - type: textarea
-    id: bug-description
+    id: description
     attributes:
-      label: Describe the bug
-      description: A clear and concise description of what the bug is. If you intend to submit a PR for this issue, tell us in the description. Thanks!
-      placeholder: Bug description
+      label: Description
+      description: A clear and concise description of what the bug is. If you intend to submit a PR for this issue, tell us in the description.
     validations:
       required: true
   - type: textarea
     id: additonal
     attributes:
       label: Additional context
-      description: If applicable, add any other context about the problem here.
+      description: If applicable, add any other context or screenshots here.
   - type: textarea
     id: logs
     attributes:
       label: Logs
       description: |
         Optional if provided reproduction. Please try not to insert an image but copy paste the log text.
-      render: Shell
+      render: shell-script

.github/workflows/ci.yml

@@ -4,16 +4,16 @@ on:
   push:
     branches:
       - main
-      - v3
+      - feat/*
   pull_request:
     branches:
       - main
-      - v3
 
 jobs:
   ubuntu:
     runs-on: ubuntu-latest
-
+    env:
+      COREPACK_DEFAULT_TO_LATEST: 0
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4

CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [3.1.0](https://github.com/nuxt/content/compare/v3.0.1...v3.1.0) (2025-02-03)
+
+### Features
+
+* `node-sqlite3` connector ([#3032](https://github.com/nuxt/content/issues/3032)) ([1188550](https://github.com/nuxt/content/commit/118855015d36193e03320b12c74534591dc6e788))
+* **db:** drop built-in database adapters in favor of db0 connectors ([#3010](https://github.com/nuxt/content/issues/3010)) ([1a7371a](https://github.com/nuxt/content/commit/1a7371a61383d8d2e9b8bde18f89516371e94ef1))
+* integrate with NuxtHub database queries ([#3019](https://github.com/nuxt/content/issues/3019)) ([7b480c5](https://github.com/nuxt/content/commit/7b480c5cc638c6781c5e7209787ff93ee0b89acd))
+* **module:** extend content transformers ([#3056](https://github.com/nuxt/content/issues/3056)) ([5ac8532](https://github.com/nuxt/content/commit/5ac85329ddeb918b89a2cff34d7c69fbf2f36745))
+* **search:** allow filtering contents in search sections ([#3053](https://github.com/nuxt/content/issues/3053)) ([2dc38cf](https://github.com/nuxt/content/commit/2dc38cfcd6eada4aa65d2547d61c5c0b702ba653))
+
+### Bug Fixes
+
+* **changelog:** image size ([7c8e950](https://github.com/nuxt/content/commit/7c8e950a3f78ad8ccaf578ac8d66cc165bb7a58d))
+* convert boolean value to number in query condition ([#2927](https://github.com/nuxt/content/issues/2927)) ([#3018](https://github.com/nuxt/content/issues/3018)) ([c11f90a](https://github.com/nuxt/content/commit/c11f90abe020e804de1620320e16d26c6b9dd5bb))
+* fix broken install link ([#2990](https://github.com/nuxt/content/issues/2990)) ([b8da5ee](https://github.com/nuxt/content/commit/b8da5ee9f9e8a64dc8735654dc60bd67e9c6c618))
+* **highlighter:** support custom languages ([cfc9f43](https://github.com/nuxt/content/commit/cfc9f431d8c3b33377b2a72d8cccc77fbf0091fd)), closes [#3067](https://github.com/nuxt/content/issues/3067)
+* **hmr:** ignore sources without `cwd` ([1a8c2bd](https://github.com/nuxt/content/commit/1a8c2bdf85621722251a097d09931b7483185eb5))
+* invalid sqlite3 connector resolve ([74dd3e1](https://github.com/nuxt/content/commit/74dd3e18efed2f44b88d1e4bc38674a9002ba3a8))
+* migration doc typo ([#3017](https://github.com/nuxt/content/issues/3017)) ([ada613f](https://github.com/nuxt/content/commit/ada613ff32814add0b79e16382018aed86638d68))
+* **module:** clone layers to prevent side-effect ([b4e7dec](https://github.com/nuxt/content/commit/b4e7dec2a96c02ec19125af602766bfa04ce6b14))
+* **module:** collection detection on windown file-watcher ([#3006](https://github.com/nuxt/content/issues/3006)) ([3807fe9](https://github.com/nuxt/content/commit/3807fe983b925ff39955aeca3b734a90713dda72))
+* **module:** content parser error handling ([#3046](https://github.com/nuxt/content/issues/3046)) ([022c385](https://github.com/nuxt/content/commit/022c38588b94b6eb210647734e77a832e6578fe3))
+* **module:** remove `scule` from optimizeDps list ([ddb3bc8](https://github.com/nuxt/content/commit/ddb3bc8c4f1726df44474347b1d3e5883fe0204b)), closes [#3042](https://github.com/nuxt/content/issues/3042)
+* **nuxthub:** ensure database is enabled ([b46fc37](https://github.com/nuxt/content/commit/b46fc378019d77117e301e0099cf1ca0cd039c6f))
+* **nuxthub:** split queries into 1MB chunks ([083a47a](https://github.com/nuxt/content/commit/083a47a1461735a3e0196d04e4df9f828cfc36af))
+* parse new content when file is modified ([5dc3429](https://github.com/nuxt/content/commit/5dc342994ede1993c39fbaae3c61dcf812370f20))
+* **parser:** de-prioritise code highlighter plugin ([#3009](https://github.com/nuxt/content/issues/3009)) ([dc7d866](https://github.com/nuxt/content/commit/dc7d8661c0f8da9f7022999eb92a480fdcd058af))
+* **preview:** draft ready not received event ([a8ee72e](https://github.com/nuxt/content/commit/a8ee72e6aca6d63e32478c014bbc465f129ce545))
+* **preview:** handle index file in prefix folder (i18n) ([37d3008](https://github.com/nuxt/content/commit/37d30083a83ed99e7446b49ecf2fb46debffb751))
+* **preview:** optimize brace-expansion ([e84e7f4](https://github.com/nuxt/content/commit/e84e7f4f7a5188b18117987dad1a3bc933961e92))
+* **preview:** take exclude into account to find collection ([bddd834](https://github.com/nuxt/content/commit/bddd83430667d9852d312325e15c8159a32df417))
+* **query:** handle comments and improve single selection ([8de0f14](https://github.com/nuxt/content/commit/8de0f144008d60f3e2f89d9d2e68bd3087a6e136)), closes [#3054](https://github.com/nuxt/content/issues/3054)
+* **schema:** mark `ZodMap` as json field ([69a14fa](https://github.com/nuxt/content/commit/69a14faf3b915abccf91e7eb426d385a1ffd5a23))
+* **studio:** return when collection not found ([454a22d](https://github.com/nuxt/content/commit/454a22db7143d26b518da0a577994f184a5bff32))
+* **template:** demo url ([#2983](https://github.com/nuxt/content/issues/2983)) ([57ee33d](https://github.com/nuxt/content/commit/57ee33daa72dcd3a8e0e83b1c3f5173b4004c932))
+* **templates:** handle cors form studio ([06b57ac](https://github.com/nuxt/content/commit/06b57aca8e103a11eae87e12e5a850983492f460))
+* **vercel:** default database url ([042c548](https://github.com/nuxt/content/commit/042c5489157702ce832408eb25c8c0fd6a4fda03))
+* **wasm:** ignore OPFS warning as Nuxt Content does not depend on it ([5d5506c](https://github.com/nuxt/content/commit/5d5506ce2f478b944bad68e82a09bafe7ced1f55))
+* **wasm:** override logger functions ([#3024](https://github.com/nuxt/content/issues/3024)) ([99f5ac9](https://github.com/nuxt/content/commit/99f5ac9e9018e8cc1b8d91f3188659b28de0c95c))
+
 ## [3.0.1](https://github.com/nuxt/content/compare/v3.0.0...v3.0.1) (2025-01-27)
 
 ### Bug Fixes

README.md

@@ -12,7 +12,7 @@ Nuxt Content reads the `content/` directory in your project, parses `.md`, `.yml
 
 - [📖  Read the documentation](https://content.nuxt.com)
 - [✨  Intro video](https://www.youtube.com/watch?v=o9e12WbKrd8)
-- [✍️  Nuxt Studio](https://content.nuxt.com/docs/studio)
+- [✍️  Nuxt Studio](https://content.nuxt.com/studio)
 
 ## Features
 
@@ -39,11 +39,11 @@ Nuxt Content reads the `content/` directory in your project, parses `.md`, `.yml
 
 [MIT](./LICENSE) - Made with 💚
 
-[npm-version-src]: https://img.shields.io/npm/v/@nuxt/content/next.svg?style=flat&colorA=18181B&colorB=28CF8D
+[npm-version-src]: https://img.shields.io/npm/v/@nuxt/content/latest.svg?style=flat&colorA=18181B&colorB=28CF8D
 [npm-version-href]: https://npmjs.com/package/@nuxt/content
 
 [npm-downloads-src]: https://img.shields.io/npm/dm/@nuxt/content.svg?style=flat&colorA=18181B&colorB=28CF8D
-[npm-downloads-href]: https://npmjs.com/package/@nuxt/content
+[npm-downloads-href]: https://npm.chart.dev/@nuxt/content
 
 [license-src]: https://img.shields.io/github/license/nuxt/content.svg?style=flat&colorA=18181B&colorB=28CF8D
 [license-href]: https://github.com/nuxt/content/blob/main/LICENSE

docs/_redirects

@@ -0,0 +1,65 @@
+/get-started=/get-started/installation
+/guide/writing/markdown=/docs/files/markdown
+/guide/writing/mdc=/docs/files/markdown
+/guide/writing/json=/docs/files/json
+/guide/writing/yaml=/docs/files/yaml
+/guide/writing/vue-components=/docs/files/markdown#vue-components
+/guide/displaying/rendering=/docs/components/content-renderer
+/guide/displaying/querying=/docs/utils/query-collection
+/guide/displaying/navigation=/docs/utils/query-collection-navigation
+/guide/deploy/node-server=/docs/getting-started/installation
+/guide/deploy/static-hosting=/docs/getting-started/installation
+/api/components/prose=/docs/components/prose
+/api/configuration=/docs/getting-started/configuration
+/recipes/hooks=/docs/advanced/hooks
+
+# Content v2 redirects
+/guide/writing/content-directory=https://v2.content.nuxt.com/usage/content-directory
+/usage/content-directory=https://v2.content.nuxt.com/usage/content-directory
+/guide/writing/csv=https://v2.content.nuxt.com/writing/files
+/writing/files=https://v2.content.nuxt.com/writing/files
+/guide/writing/document-driven=https://v2.content.nuxt.com/document-driven/introduction
+/document-driven/introduction=https://v2.content.nuxt.com/document-driven/introduction
+/guide/displaying/typescript=https://v2.content.nuxt.com/usage/typescript
+/usage/typescript=https://v2.content.nuxt.com/usage/typescript
+/guide/recipes/sitemap=https://v2.content.nuxt.com/recipes/sitemap
+/recipes/sitemap=https://v2.content.nuxt.com/recipes/sitemap
+/guide/migration/from-v1=https://v2.content.nuxt.com/get-started/from-v1
+/get-started/from-v1=https://v2.content.nuxt.com/get-started/from-v1
+/content-v1=https://v2.content.nuxt.com/get-started/from-v1
+/get-started/from-v1=https://v2.content.nuxt.com/get-started/from-v1
+/guide/migration/edge-channel=https://v2.content.nuxt.com/get-started/edge-channel
+/get-started/edge-channel=https://v2.content.nuxt.com/get-started/edge-channel
+/api/components/content-doc=https://v2.content.nuxt.com/components/content-doc
+/components/content-doc=https://v2.content.nuxt.com/components/content-doc
+/api/components/content-list=https://v2.content.nuxt.com/components/content-list
+/components/content-list=https://v2.content.nuxt.com/components/content-list
+/api/components/content-renderer=https://v2.content.nuxt.com/components/content-renderer
+/components/content-renderer=https://v2.content.nuxt.com/components/content-renderer
+/api/components/content-navigation=https://v2.content.nuxt.com/components/content-navigation
+/components/content-navigation=https://v2.content.nuxt.com/components/content-navigation
+/api/components/content-query=https://v2.content.nuxt.com/components/content-query
+/components/content-query=https://v2.content.nuxt.com/components/content-query
+/api/components/markdown=https://v2.content.nuxt.com/components/content-slot
+/components/content-slot=https://v2.content.nuxt.com/components/content-slot
+/api/components/content-slot=https://v2.content.nuxt.com/components/content-slot
+/components/content-slot=https://v2.content.nuxt.com/components/content-slot
+/api/composables/query-content=https://v2.content.nuxt.com/composables/query-content
+/composables/query-content=https://v2.content.nuxt.com/composables/query-content
+/api/composables/fetch-content-navigation=https://v2.content.nuxt.com/composables/fetch-content-navigation
+/composables/fetch-content-navigation=https://v2.content.nuxt.com/composables/fetch-content-navigation
+/api/composables/unwrap=https://v2.content.nuxt.com/composables/use-unwrap
+/composables/use-unwrap=https://v2.content.nuxt.com/composables/use-unwrap
+/api/composables/use-document-driven=https://v2.content.nuxt.com/document-driven/use-content
+/document-driven/use-content=https://v2.content.nuxt.com/document-driven/use-content
+/api/composables/use-content-helpers=https://v2.content.nuxt.com/composables/use-content-helpers
+/composables/use-content-helpers=https://v2.content.nuxt.com/composables/use-content-helpers
+/api/composables/use-content-head=https://v2.content.nuxt.com/composables/use-content-head
+/composables/use-content-head=https://v2.content.nuxt.com/composables/use-content-head
+/examples/**=https://v2.content.nuxt.com/playground
+/playground=https://v2.content.nuxt.com/playground
+/blog/announcing-v2=https://v2.content.nuxt.com/
+/v1=https://v2.content.nuxt.com/v1/getting-started/introduction
+/v1/getting-started/introduction=https://v2.content.nuxt.com/v1/getting-started/introduction
+/document-driven=https://v2.content.nuxt.com/document-driven/introduction
+/document-driven/introduction=https://v2.content.nuxt.com/document-driven/introduction

docs/app/components/AppFooter.vue

@@ -50,7 +50,7 @@ const route = useRoute()
       <UButton
         aria-label="Nuxt Content on Discord"
         icon="i-simple-icons-discord"
-        to="https://go.nuxt.com/discord"
+        to="https://discord.gg/sBXDm6e8SP"
         target="_blank"
         color="neutral"
         variant="ghost"

docs/app/components/AppHeader.vue

@@ -59,14 +59,11 @@ const linksWithoutIcon = computed(() => links.value.map(({ icon, ...link }) => l
         <UContentSearchButton />
       </UTooltip>
 
-      <UTooltip
-        text="Open on GitHub"
-        :kbds="['meta', 'G']"
-      >
+      <UTooltip text="Open on GitHub">
         <UButton
           color="neutral"
           variant="ghost"
-          to="https://github.com/nuxt/content/tree/v3"
+          to="https://github.com/nuxt/content"
           target="_blank"
           icon="i-simple-icons-github"
           aria-label="GitHub"

docs/app/components/post/PostPage.vue

@@ -13,7 +13,10 @@ const siteConfig = useSiteConfig()
 
 const { data } = await useAsyncData(route.path, () => Promise.all([
   queryCollection('posts').path(route.path).first(),
-  queryCollectionItemSurroundings('posts', route.path, { fields: ['title', 'description'] }),
+  queryCollectionItemSurroundings('posts', route.path, { fields: ['title', 'description'] })
+    .where('path', 'LIKE', `/${type}%`)
+    .where('draft', '=', 0)
+    .order('date', 'DESC'),
 ]), {
   transform: ([page, surround]) => ({ page, surround }),
 })
@@ -43,13 +46,13 @@ const links = [
   {
     icon: 'i-simple-icons-bluesky',
     label: 'Follow on Bluesky',
-    to: 'https://bluesky.com/nuxtlabs',
+    to: 'https://go.nuxt.com/bluesky',
     target: '_blank',
   },
   {
     icon: 'i-simple-icons-discord',
     label: 'Chat on Discord',
-    to: 'https://discord.com/invite/sBXDm6e8SP',
+    to: 'https://discord.gg/sBXDm6e8SP',
     target: '_blank',
   },
 ]
@@ -144,7 +147,10 @@ function copyLink() {
           class="text-gray-200 dark:text-gray-800"
         >
 
-        <UContentSurround :surround="surround" />
+        <UContentSurround
+          :surround="surround"
+          :ui="{ linkTitle: 'text-wrap' }"
+        />
       </UPageBody>
 
       <template #right>