@lupinum/ginko-content 0.1.0 → 0.1.1

package/README.md

@@ -1,57 +1,78 @@
 # @lupinum/ginko-content
 
-Filesystem-first, provider-neutral content for Nuxt 4.
+Filesystem-first content for Nuxt 4.
 
-`@lupinum/ginko-content` gives you:
+Write Markdown and data files in `content/`, define collections once in
+`content.config.ts`, then use those collection handles for route pages, lists,
+navigation, search, i18n, and sitemap output.
 
-- file-authored pages and navigation from `content/`
-- required typed collections via `content.config.ts`
-- Markdown, MDC, YAML, JSON, and CSV ingestion
-- locale-aware content routing
-- built-in search endpoints and first-class search composables
-- a server-side provider contract for advanced custom sources
+Use it when you want content files to stay simple, but your Nuxt app still
+needs explicit APIs for route resolution, typed frontmatter, localized content,
+and server-side reads.
+
+## Requirements
+
+- Node.js 20 or later
+- Nuxt 4.0 or later
 
 ## Install
 
 ```bash
-pnpm add @lupinum/ginko-content zod
+npx nuxi module add @lupinum/ginko-content
 ```
 
-Add the module to your `nuxt.config.ts`:
+The Nuxt CLI installs the package and registers the module in `nuxt.config.ts`.
+If you prefer to install by hand:
+
+```bash
+pnpm add @lupinum/ginko-content
+```
 
 ```ts
 export default defineNuxtConfig({
-  modules: ['@lupinum/ginko-content']
+  modules: ['@lupinum/ginko-content'],
+  imports: {
+    autoImport: true
+  }
 })
 ```
 
-Ginko is published as `@lupinum/ginko-content` and should be registered under that package name.
+## Quick Start
 
-The default provider reads files from your Nuxt project. The package does not include a CMS UI, Studio, admin panel, or content editing workflow.
+Define a collection:
 
-## Compatibility
+```ts
+// content.config.ts
+import { defineCollection, defineContentConfig } from '@lupinum/ginko-content/config'
 
-`@lupinum/ginko-content@2.13.4` targets Nuxt `>=4.0.0` and is verified against
-Nuxt `4.4.6`. It is compatible with the first Ginko CMS release line:
-`@lupinum/ginko-cms@0.1.0`, `@lupinum/ginko-cms-convex@0.1.0`, and
-`@lupinum/ginko-cms-contract@0.1.0`.
+export const pages = defineCollection('pages', {
+  type: 'page',
+  source: '**/*.md'
+})
 
-The CMS boundary uses `./cms-contract` and `./cms-import`. Those subpaths are
-runtime-neutral seams for package integration, not a bundled CMS runtime.
+export default defineContentConfig({
+  collections: {
+    pages
+  }
+})
+```
 
-## Basic usage
+Create `content/index.md`:
 
-Create content files:
+```md
+---
+title: Welcome
+---
 
-```text
-content/
-  index.md
-  guide/getting-started.md
+# Welcome
+
+This file renders at `/`.
 ```
 
-Render content in a catch-all page:
+Render the current route through the collection:
 
 ```vue
+<!-- pages/[...slug].vue -->
 <script setup lang="ts">
 import { pages } from '~/content.config'
 
@@ -63,28 +84,37 @@ const { page } = await useContentPage(pages)
 </template>
 ```
 
-Define the collection in `content.config.ts`:
+## Features
 
-```ts
-import { defineCollection, defineContentConfig, fields } from '@lupinum/ginko-content/config'
-import { z } from 'zod'
+- file-authored pages and navigation from `content/`
+- collection definitions as the source of truth for content shape and source
+  files
+- Markdown, MDC, YAML, JSON, and CSV ingestion
+- locale-aware content routing
+- route-aware page loading with `useContentPage(handle)`
+- server reads through `one`, `many`, `paginate`, `resolveOne`, `tree`, and
+  `neighbors`
+- Vue composables for the same read model
+- search helpers for MiniSearch, Pagefind, and provider-owned search
+- sitemap integration for public content routes
+- a server-side provider contract for advanced custom sources
 
-export const pages = defineCollection('pages', {
-  type: 'page',
-  source: ['index.md', 'guide/**/*.md'],
-  schema: z.object({
-    title: fields.text()
-  })
-})
+## Scope
 
-export default defineContentConfig({
-  collections: {
-    pages
-  }
-})
-```
+The default provider reads files from your Nuxt project. The package does not
+include a CMS UI, Studio, admin panel, or content editing workflow.
 
 ## Docs
 
 - Documentation: [ginko-content.nuxt.dev](https://ginko-content.nuxt.dev)
 - Repository: [github.com/lupinum-dev/ginko-content](https://github.com/lupinum-dev/ginko-content)
+
+## Credits
+
+Ginko Content is its own implementation, with clear inspiration from
+[Nuxt Content](https://content.nuxt.com/), [Nuxt UI](https://ui.nuxt.com/), and
+[Comark](https://comark.dev/), the successor to the previous MDC work.
+
+## License
+
+[MIT](./LICENSE)

package/compatibility.json

@@ -1,10 +1,10 @@
 {
   "name": "Ginko Content release compatibility",
   "releaseStack": {
-    "@lupinum/ginko-content": "0.1.0",
-    "@lupinum/ginko-cms": "0.1.0",
-    "@lupinum/ginko-cms-convex": "0.1.0",
-    "@lupinum/ginko-cms-contract": "0.1.0"
+    "@lupinum/ginko-content": "0.1.1",
+    "@lupinum/ginko-cms": "0.1.2",
+    "@lupinum/ginko-cms-convex": "0.1.1",
+    "@lupinum/ginko-cms-contract": "0.1.1"
   },
   "tracked": {
     "@convex-dev/better-auth": ["^0.12.2", "0.12.2"],

package/dist/cli.mjs

@@ -99,6 +99,93 @@ const lockfileNames = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.
 const localeCodePattern = /^[a-z]{2}(?:-[A-Z]{2})?$/;
 const toRelativePath = (rootDir, file) => relative(rootDir, file) || ".";
 const countSitemapUrls = (text) => (text.match(/<url>/g) || []).length;
+function findMatchingBrace(text, start) {
+  let depth = 0;
+  let quote;
+  let escaped = false;
+  let lineComment = false;
+  let blockComment = false;
+  for (let index = start; index < text.length; index++) {
+    const char = text[index];
+    const next = text[index + 1];
+    if (lineComment) {
+      if (char === "\n") {
+        lineComment = false;
+      }
+      continue;
+    }
+    if (blockComment) {
+      if (char === "*" && next === "/") {
+        blockComment = false;
+        index++;
+      }
+      continue;
+    }
+    if (quote) {
+      if (escaped) {
+        escaped = false;
+      } else if (char === "\\") {
+        escaped = true;
+      } else if (char === quote) {
+        quote = void 0;
+      }
+      continue;
+    }
+    if (char === "/" && next === "/") {
+      lineComment = true;
+      index++;
+      continue;
+    }
+    if (char === "/" && next === "*") {
+      blockComment = true;
+      index++;
+      continue;
+    }
+    if (char === "'" || char === '"' || char === "`") {
+      quote = char;
+      continue;
+    }
+    if (char === "{") {
+      depth++;
+    } else if (char === "}") {
+      depth--;
+      if (depth === 0) {
+        return index;
+      }
+    }
+  }
+  return text.length - 1;
+}
+function findCollectionDefinitions(text) {
+  const definitions = [];
+  const callPattern = /\bdefineCollection\s*\(/g;
+  for (const match of text.matchAll(callPattern)) {
+    const callStart = match.index || 0;
+    const argsStart = callStart + match[0].length;
+    const args = text.slice(argsStart);
+    const namedMatch = args.match(/^\s*(['"])([^'"]+)\1\s*,\s*\{/);
+    if (namedMatch) {
+      const bodyStart = argsStart + namedMatch[0].lastIndexOf("{");
+      const bodyEnd = findMatchingBrace(text, bodyStart);
+      definitions.push({
+        name: namedMatch[2],
+        block: text.slice(bodyStart, bodyEnd + 1)
+      });
+      continue;
+    }
+    const objectMatch = args.match(/^\s*\{/);
+    const propertyMatch = text.slice(0, callStart).match(/([a-z_$][\w$]*)\s*:\s*$/i);
+    if (objectMatch && propertyMatch) {
+      const bodyStart = argsStart + objectMatch[0].lastIndexOf("{");
+      const bodyEnd = findMatchingBrace(text, bodyStart);
+      definitions.push({
+        name: propertyMatch[1],
+        block: text.slice(bodyStart, bodyEnd + 1)
+      });
+    }
+  }
+  return definitions;
+}
 async function collectFiles(dir, rootDir, files = []) {
   const entries = await readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
@@ -372,25 +459,21 @@ async function inspectI18nCollections(rootDir) {
       suggestion: "Declare i18n collections with defineContentConfig({ collections })."
     }];
   }
-  const matches = [...text.matchAll(/([A-Za-z_$][\w$]*)\s*:\s*defineCollection\s*\(\s*\{/g)];
-  if (!matches.length) {
+  const collections = findCollectionDefinitions(text);
+  if (!collections.length) {
     return [];
   }
   const findings = [];
-  matches.forEach((match, index) => {
-    const collectionName = match[1];
-    const start = match.index || 0;
-    const end = matches[index + 1]?.index || text.length;
-    const collectionBlock = text.slice(start, end);
-    if (!/\bi18n\s*:\s*(true|\{)/.test(collectionBlock)) {
+  for (const collection of collections) {
+    if (!/\bi18n\s*:\s*(true|\{)/.test(collection.block)) {
       findings.push({
         severity: "error",
         file: "content.config.ts",
-        message: `Collection "${collectionName}" is not marked as i18n-aware.`,
-        suggestion: `Add i18n: true to the ${collectionName} collection or provide collection-level i18n locales.`
+        message: `Collection "${collection.name}" is not marked as i18n-aware.`,
+        suggestion: `Add i18n: true to the ${collection.name} collection or provide collection-level i18n locales.`
       });
     }
-  });
+  }
   return findings;
 }
 async function inspectI18nContentFolders(rootDir, locales) {

package/dist/integrations/nitro/context.d.ts

@@ -13,14 +13,13 @@
  *
  * The context is attached to `event.context.__contentRuntime` and created
  * lazily on first access. Memoization uses `memoizeRuntimeValue` so the
- * `graph` / `contents` caches are shared across helpers within a single
+ * expensive per-request values are shared across helpers within a single
  * request but torn down with the event.
  */
 import type { H3Event } from 'h3';
 import type { Storage } from 'unstorage';
 import type { ParsedContent } from '../../types/content';
 import type { ContentContext as RuntimeContentConfig } from '../../types/module';
-import type { ContentGraph } from '../../core/content/graph';
 import type { ContentCacheStore } from '../../core/cache';
 import type { ContentCacheHint } from '../../public/provider';
 /**
@@ -41,16 +40,13 @@ export interface ContentRuntimeContext {
         cacheStorage: Storage;
         cacheParsedStorage: Storage;
     };
-    memo: {
-        contents?: ParsedContent[] | Promise<ParsedContent[]>;
-        graph?: ContentGraph | Promise<ContentGraph>;
-    };
+    memo: Record<string, unknown | Promise<unknown> | undefined>;
     caches?: ContentCacheStore<ParsedContent>;
     cacheHint?: ContentCacheHint | false;
 }
 export declare const getContentRuntimeContext: (event: H3Event) => ContentRuntimeContext;
 /**
- * Memoize an expensive per-request value (typically `contents` or `graph`).
+ * Memoize an expensive per-request value.
  *
  * Concurrent callers within a single request that hit the same key all await
  * the one `create()` promise — we do not start a second compute. The cache
@@ -60,4 +56,4 @@ export declare const getContentRuntimeContext: (event: H3Event) => ContentRuntim
  * you cannot use this helper — mutate `runtime.memo[key]` directly. In
  * practice, nothing we build mid-request invalidates the graph.
  */
-export declare const memoizeRuntimeValue: <T>(event: H3Event, key: keyof ContentRuntimeContext["memo"], create: () => Promise<T>) => Promise<T>;
+export declare const memoizeRuntimeValue: <T>(event: H3Event, key: string, create: () => Promise<T>) => Promise<T>;

package/dist/module.d.mts

@@ -141,8 +141,7 @@ interface ContentCollectionConfig<TSchema extends ZodType | undefined = ZodType
     cms?: ContentCmsCollectionConfig;
 }
 type ContentCollectionKind = 'page' | 'data';
-type BuiltinContentProviderName = 'filesystem' | 'cms' | 'ginko-cms' | 'ginko';
-type ContentProviderName = BuiltinContentProviderName | (string & {});
+type ContentProviderName = 'filesystem' | (string & {});
 type DefineCollectionOptions<TSchema extends ZodType | undefined = ZodType | undefined> = Omit<ContentCollectionConfig<TSchema>, 'source' | 'exclude'>;
 interface DefineCollectionObject<TSchema extends ZodType | undefined = ZodType | undefined> extends DefineCollectionOptions<TSchema> {
     /**
@@ -162,14 +161,13 @@ interface DefineCollectionObject<TSchema extends ZodType | undefined = ZodType |
  */
 interface ContentConfig<TCollections extends Record<string, ContentCollectionConfig> = Record<string, ContentCollectionConfig>> {
     /**
-     * Content backing implementation. `filesystem` is the default. `cms`,
-     * `ginko-cms`, and `ginko` resolve to the official Ginko CMS provider when
-     * `@lupinum/ginko-cms` is installed.
+     * Content backing implementation. `filesystem` is the default. Provider
+     * modules can register named implementations, for example `cms`.
      */
     provider?: ContentProviderName;
     /**
-     * External provider modules keyed by provider name. Built-in providers do not
-     * need to be registered here.
+     * External provider modules keyed by provider name. First-party provider
+     * modules register themselves, so app configs usually do not need this.
      */
     providers?: Record<string, string>;
     /**
@@ -1012,6 +1010,7 @@ interface ContentSitemapImage {
 interface ContentSitemapEntry {
     loc: string;
     _sitemap?: string;
+    lastmod?: string;
     alternatives?: ContentSitemapAlternative[];
     images?: ContentSitemapImage[];
 }
@@ -1886,12 +1885,13 @@ interface ModuleOptions {
     /**
      * Backing implementation for public content reads.
      *
-     * `filesystem` is the default. `cms`, `ginko-cms`, and `ginko` resolve to the
-     * official Ginko CMS provider when `@lupinum/ginko-cms` is installed.
+     * `filesystem` is the default. Provider modules can register named
+     * implementations, for example `cms`.
      */
     provider?: ContentProviderName;
     /**
-     * External provider modules keyed by provider name.
+     * External provider modules keyed by provider name. First-party provider
+     * modules register themselves, so app configs usually do not need this.
      */
     providers?: Record<string, string>;
     /**
@@ -1973,7 +1973,8 @@ declare function createSearchRuntimeConfig(search: Exclude<ModuleOptions$1['sear
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions$1, ModuleOptions$1, false>;
 
 interface ModuleHooks {
-    'content:context'(ctx: ContentContext$1): void;
+    'content:providers'(providers: Record<string, string>): void | Promise<void>;
+    'content:context'(ctx: ContentContext$1): void | Promise<void>;
 }
 interface ModulePublicRuntimeConfig {
     experimental: {
@@ -2041,4 +2042,4 @@ declare module 'nitropack' {
 }
 
 export { _default as default };
-export type { BacklinkFields, BacklinkSource, BacklinksOptions, BacklinksResult, BuiltinContentProviderName, CollectionQueryBuilder, CollectionQueryOperator, CollectionQueryValue, CollectionSchema, ContentCacheArtifact, ContentCmsCollectionConfig, ContentCmsFieldConfig, ContentCmsFieldType, ContentCmsRelationConfig, ContentCollectionConfig, ContentCollectionHandle, ContentCollectionI18nConfig, ContentCollectionI18nMap, ContentCollectionItem, ContentCollectionItemSurroundingsOptions, ContentCollectionKind, ContentCollectionMap, ContentCollectionName, ContentCollectionNavigationOptions, ContentCollectionPageOptions, ContentCollectionRouteConfig, ContentCollectionRouteMetaOptions, ContentCollectionSearchSectionsOptions, ContentCollectionSource, ContentCollectionSourceObject, ContentConfig, ContentContext, ContentI18nOptions, ContentLocaleEntry, ContentLocaleRoute, ContentManifest, ContentMiniSearchOptions, ContentNavigationItem, ContentPageResult, ContentPreviewOptions, ContentProviderName, ContentProviderSearchRequest, ContentQueryBuilder, ContentQueryBuilderParams, ContentQueryBuilderWhere, ContentQueryFetcher, ContentQueryRequest, ContentQuerySortFields, ContentQuerySortOptions, ContentQuerySortParams, ContentReferenceSchema, ContentResolvedMeta, ContentRevalidateOptions, ContentRouteMeta, ContentSearchEngine, ContentSearchIndexRecord, ContentSearchOptions, ContentSearchPublicRuntimeConfig, ContentSearchResult, ContentSearchSection, ContentSelector, ContentSeoImage, ContentSeoMeta, ContentSitemapAlternative, ContentSitemapAssertOptions, ContentSitemapAssertSitemapOptions, ContentSitemapEntry, ContentSitemapImage, ContentSitemapOptions, ContentTransformer, ContentTreeItem, ContentVariant, DefineCollectionObject, DefineCollectionOptions, DocumentFromHandle, LocaleFallback, LocalePathEntry, LocalizedDoc, ManifestVariant, ManyOptions, MarkdownNode, MarkdownOptions, MarkdownParsedContent, MarkdownPluginDescriptor, MarkdownPluginOptions, MarkdownRoot, ModuleHooks, ModuleOptions, MountOptions, NavItem, NeighborsOptions, NeighborsResult, OneOptions, PaginationOptions, PaginationResult, ParseContentOptions, ParsedContent, ParsedContentInternalMeta, ParsedContentMeta, PopulateFromOptions, PopulateSpec, PopulatedDocument, QueryGroupBuilder, QueryGroupFunction, QueryMatchOperator, QueryOperators, QueryOrderDirection, QueryOrderOptions, QueryWhere, ResolutionEnvelope, ResolveContentReferenceOptions, ResolveOneOptions, ResolveOneResult, ResolvedContentI18nOptions, ResolvedMarkdownPlugin, ResolvedVariant, SortDirection, SortSpec, StrictParsedContent, StrictParsedContentMeta, Toc, TocLink, TransformContentOptions, TransformContentSource, TreeOptions, VariantsOptions };
+export type { BacklinkFields, BacklinkSource, BacklinksOptions, BacklinksResult, CollectionQueryBuilder, CollectionQueryOperator, CollectionQueryValue, CollectionSchema, ContentCacheArtifact, ContentCmsCollectionConfig, ContentCmsFieldConfig, ContentCmsFieldType, ContentCmsRelationConfig, ContentCollectionConfig, ContentCollectionHandle, ContentCollectionI18nConfig, ContentCollectionI18nMap, ContentCollectionItem, ContentCollectionItemSurroundingsOptions, ContentCollectionKind, ContentCollectionMap, ContentCollectionName, ContentCollectionNavigationOptions, ContentCollectionPageOptions, ContentCollectionRouteConfig, ContentCollectionRouteMetaOptions, ContentCollectionSearchSectionsOptions, ContentCollectionSource, ContentCollectionSourceObject, ContentConfig, ContentContext, ContentI18nOptions, ContentLocaleEntry, ContentLocaleRoute, ContentManifest, ContentMiniSearchOptions, ContentNavigationItem, ContentPageResult, ContentPreviewOptions, ContentProviderName, ContentProviderSearchRequest, ContentQueryBuilder, ContentQueryBuilderParams, ContentQueryBuilderWhere, ContentQueryFetcher, ContentQueryRequest, ContentQuerySortFields, ContentQuerySortOptions, ContentQuerySortParams, ContentReferenceSchema, ContentResolvedMeta, ContentRevalidateOptions, ContentRouteMeta, ContentSearchEngine, ContentSearchIndexRecord, ContentSearchOptions, ContentSearchPublicRuntimeConfig, ContentSearchResult, ContentSearchSection, ContentSelector, ContentSeoImage, ContentSeoMeta, ContentSitemapAlternative, ContentSitemapAssertOptions, ContentSitemapAssertSitemapOptions, ContentSitemapEntry, ContentSitemapImage, ContentSitemapOptions, ContentTransformer, ContentTreeItem, ContentVariant, DefineCollectionObject, DefineCollectionOptions, DocumentFromHandle, LocaleFallback, LocalePathEntry, LocalizedDoc, ManifestVariant, ManyOptions, MarkdownNode, MarkdownOptions, MarkdownParsedContent, MarkdownPluginDescriptor, MarkdownPluginOptions, MarkdownRoot, ModuleHooks, ModuleOptions, MountOptions, NavItem, NeighborsOptions, NeighborsResult, OneOptions, PaginationOptions, PaginationResult, ParseContentOptions, ParsedContent, ParsedContentInternalMeta, ParsedContentMeta, PopulateFromOptions, PopulateSpec, PopulatedDocument, QueryGroupBuilder, QueryGroupFunction, QueryMatchOperator, QueryOperators, QueryOrderDirection, QueryOrderOptions, QueryWhere, ResolutionEnvelope, ResolveContentReferenceOptions, ResolveOneOptions, ResolveOneResult, ResolvedContentI18nOptions, ResolvedMarkdownPlugin, ResolvedVariant, SortDirection, SortSpec, StrictParsedContent, StrictParsedContentMeta, Toc, TocLink, TransformContentOptions, TransformContentSource, TreeOptions, VariantsOptions };

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-content",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "configKey": "content",
   "compatibility": {
     "nuxt": ">=4.0.0"

package/dist/module.mjs

@@ -18,6 +18,7 @@ import { genSafeVariableName, genImport } from 'knitwork';
 import { listen } from 'listhen';
 import { makeIgnored } from '../dist/core/content/ignore';
 import { readFile, readdir } from 'node:fs/promises';
+import { resolveContentSitemapSource, GINKO_SITEMAP_SOURCE_NAME } from '../dist/runtime/utils/sitemap-source';
 import { resolveCollectionI18nConfig } from '../dist/features/localization/config';
 import { globby } from 'globby';
 import { transformContent } from '../dist/parsers/index';
@@ -29,7 +30,7 @@ import { resolveCollection } from '../dist/core/content/collection';
 export { defineCollection, defineContentConfig, reference } from '../dist/types/config';
 
 const name = "@lupinum/ginko-content";
-const version = "0.1.0";
+const version = "0.1.1";
 
 const logger = consola.withTag("@lupinum/ginko-content");
 const CACHE_VERSION = 3;
@@ -643,16 +644,37 @@ function hasNuxtI18nModule(modules = []) {
 function hasNuxtSitemapModule(modules = []) {
   return hasNuxtModule(modules, "@nuxtjs/sitemap");
 }
+function configureNuxtSitemapSource(nuxt, apiBaseURL, sitemapPath = "/sitemap") {
+  if (!hasNuxtSitemapModule(nuxt.options.modules)) {
+    return;
+  }
+  const source = {
+    context: {
+      name: GINKO_SITEMAP_SOURCE_NAME
+    },
+    fetch: resolveContentSitemapSource(apiBaseURL, sitemapPath)
+  };
+  const sitemap = nuxt.options.sitemap ??= {};
+  const sources = Array.isArray(sitemap.sources) ? sitemap.sources : [];
+  sitemap.sources = [
+    ...sources.filter((item) => {
+      if (typeof item === "string") return item !== source.fetch;
+      return item?.fetch !== source.fetch && item?.context?.name !== GINKO_SITEMAP_SOURCE_NAME;
+    }),
+    source
+  ];
+  sitemap.excludeAppSources = true;
+}
 function resolveNuxtSitemapPrerenderRoutes(nuxt) {
   if (!hasNuxtSitemapModule(nuxt.options.modules)) {
     return [];
   }
   const nuxtI18n = nuxt.options.i18n || {};
   if (!hasNuxtI18nModule(nuxt.options.modules) || !Array.isArray(nuxtI18n.locales) || nuxtI18n.locales.length === 0) {
-    return [];
+    return ["/sitemap.xml"];
   }
   const childRoutes = nuxtI18n.locales.map((locale) => typeof locale === "string" ? locale : locale.language || locale.code).filter(Boolean).map((locale) => `/__sitemap__/${locale}.xml`);
-  return Array.from(/* @__PURE__ */ new Set(["/sitemap_index.xml", ...childRoutes]));
+  return Array.from(/* @__PURE__ */ new Set(["/sitemap.xml", "/sitemap_index.xml", ...childRoutes]));
 }
 function resolveModuleI18nOptions(options, nuxt) {
   if (options.i18n === false) {
@@ -1018,9 +1040,7 @@ const collectSitemapCollectionRouteCounts = async (rootDir, contentContext) => {
   return counts;
 };
 const registerContentNitroIntegrationHooks = (nitroConfig, options, contentContext) => {
-  if (contentContext.provider && contentContext.provider !== "filesystem") {
-    return;
-  }
+  const usesFilesystemProvider = !contentContext.provider || contentContext.provider === "filesystem";
   nitroConfig.hooks ||= {};
   if (contentContext.sitemap?.assert?.enabled) {
     appendHook(nitroConfig.hooks, "compiled", async (nitro) => {
@@ -1032,7 +1052,7 @@ const registerContentNitroIntegrationHooks = (nitroConfig, options, contentConte
         await assertGeneratedSitemaps({
           outputPublicDir: nitro.options.output.publicDir,
           options: assertOptions,
-          collectionRouteCounts: await collectSitemapCollectionRouteCounts(options.rootDir, contentContext),
+          collectionRouteCounts: usesFilesystemProvider ? await collectSitemapCollectionRouteCounts(options.rootDir, contentContext) : {},
           logger: nitro.logger
         });
       } catch (error) {
@@ -1044,8 +1064,10 @@ const registerContentNitroIntegrationHooks = (nitroConfig, options, contentConte
     });
   }
   appendHook(nitroConfig.hooks, "prerender:routes", async (routes) => {
-    for (const route of await collectPrerenderRoutes(options.rootDir, contentContext)) {
-      routes.add(route);
+    if (usesFilesystemProvider) {
+      for (const route of await collectPrerenderRoutes(options.rootDir, contentContext)) {
+        routes.add(route);
+      }
     }
     for (const route of options.sitemapPrerenderRoutes || []) {
       routes.add(route);
@@ -1170,10 +1192,11 @@ const module$1 = defineNuxtModule({
       }
     ]));
     options.provider = appContentConfig.provider || options.provider || "filesystem";
-    options.providers = {
+    const providerRegistry = {
       ...options.providers || {},
       ...appContentConfig.providers || {}
     };
+    options.providers = providerRegistry;
     const buildIntegrity = nuxt.options.dev ? void 0 : Date.now();
     const contentContext = {
       ...options,
@@ -1186,6 +1209,9 @@ const module$1 = defineNuxtModule({
       sitemap: resolvedSitemap,
       search: resolvedSearch
     };
+    if (resolvedSitemap !== false) {
+      configureNuxtSitemapSource(nuxt, options.api.baseURL, resolvedSitemap.path);
+    }
     if (resolvedSitemap && resolvedSitemap.assert.enabled) {
       nuxt.hook("sitemap:prerender:done", async ({ sitemaps }) => {
         const assertOptions = contentContext.sitemap?.assert;
@@ -1310,6 +1336,8 @@ const module$1 = defineNuxtModule({
       });
     }
     nuxt.hook("modules:done", async () => {
+      await nuxt.callHook("content:providers", contentContext.providers ||= {});
+      assertConfiguredProviderAvailable(contentContext);
       await nuxt.callHook("content:context", contentContext);
       if (contentContext.search !== false) {
         registerContentSearchServerHandlers(options.api.baseURL, contentContext.search, resolveRuntimeModule);
@@ -1348,6 +1376,15 @@ const module$1 = defineNuxtModule({
     }
   }
 });
+function assertConfiguredProviderAvailable(contentContext) {
+  const provider = contentContext.provider || "filesystem";
+  if (provider === "filesystem") return;
+  if (contentContext.providers?.[provider]) return;
+  if (provider === "cms") {
+    throw new Error('content.config.ts sets provider "cms", but no CMS provider module registered it. Add @lupinum/ginko-cms to nuxt.config.ts modules or remove provider: "cms".');
+  }
+  throw new Error(`content.config.ts sets provider "${provider}", but no provider module registered it. Register a module for "${provider}" or add it to content providers.`);
+}
 function validateRemovedMarkdownOptions(options) {
   if (options.highlight !== void 0) {
     throw new Error("`content.highlight` was removed. Enable syntax highlighting with `content.markdown.plugins`, for example `[['highlight', { ...options }]]`.");

package/dist/runtime/app/components/internal/ContentRendererMarkdown.d.vue.ts

@@ -57,8 +57,8 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: () => {};
     };
 }>> & Readonly<{}>, {
-    data: Record<string, any>;
     excerpt: boolean;
+    data: Record<string, any>;
     components: Record<string, any>;
     prose: boolean;
     tag: string;

package/dist/runtime/app/components/internal/ContentRendererMarkdown.vue.d.ts

@@ -57,8 +57,8 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
         default: () => {};
     };
 }>> & Readonly<{}>, {
-    data: Record<string, any>;
     excerpt: boolean;
+    data: Record<string, any>;
     components: Record<string, any>;
     prose: boolean;
     tag: string;

package/dist/runtime/server/plugins/sitemap.js

@@ -1,7 +1,7 @@
 import { defineNitroPlugin } from "nitropack/runtime";
 import { getContentRuntimeConfig } from "../runtime-config.js";
+import { GINKO_SITEMAP_SOURCE_NAME, resolveContentSitemapSource } from "../../utils/sitemap-source.js";
 const LEGACY_NUXT_CONTENT_V2_SOURCE = "@nuxt/content@v2:urls";
-const GINKO_SOURCE = "@lupinum/ginko-content:urls";
 export default defineNitroPlugin((nitro) => {
   nitro.hooks.hook("sitemap:sources", (ctx) => {
     const runtimeConfig = getContentRuntimeConfig();
@@ -10,13 +10,13 @@ export default defineNitroPlugin((nitro) => {
     if (!sitemap || !apiBaseURL) {
       return;
     }
-    const fetch = `${apiBaseURL}${sitemap.path || "/sitemap"}`;
+    const fetch = resolveContentSitemapSource(apiBaseURL, sitemap.path || "/sitemap");
     ctx.sources = ctx.sources.filter((source) => {
-      return source.context?.name !== LEGACY_NUXT_CONTENT_V2_SOURCE && source.context?.name !== GINKO_SOURCE;
+      return source.context?.name !== LEGACY_NUXT_CONTENT_V2_SOURCE && source.context?.name !== GINKO_SITEMAP_SOURCE_NAME;
     });
     ctx.sources.push({
       context: {
-        name: GINKO_SOURCE
+        name: GINKO_SITEMAP_SOURCE_NAME
       },
       fetch,
       sourceType: "app"

package/dist/runtime/utils/sitemap-source

@@ -0,0 +1 @@
+export * from './sitemap-source.js'

package/dist/runtime/utils/sitemap-source.d.ts

@@ -0,0 +1,2 @@
+export declare const GINKO_SITEMAP_SOURCE_NAME = "@lupinum/ginko-content:urls";
+export declare function resolveContentSitemapSource(apiBaseURL: string, sitemapPath?: string): string;

package/dist/runtime/utils/sitemap-source.js

@@ -0,0 +1,6 @@
+export const GINKO_SITEMAP_SOURCE_NAME = "@lupinum/ginko-content:urls";
+export function resolveContentSitemapSource(apiBaseURL, sitemapPath = "/sitemap") {
+  const base = apiBaseURL.replace(/\/$/, "");
+  const path = sitemapPath.startsWith("/") ? sitemapPath : `/${sitemapPath}`;
+  return `${base}${path}`;
+}

package/dist/types/config.d.ts

@@ -132,8 +132,7 @@ export interface ContentCollectionConfig<TSchema extends ZodType | undefined = Z
     cms?: ContentCmsCollectionConfig;
 }
 export type ContentCollectionKind = 'page' | 'data';
-export type BuiltinContentProviderName = 'filesystem' | 'cms' | 'ginko-cms' | 'ginko';
-export type ContentProviderName = BuiltinContentProviderName | (string & {});
+export type ContentProviderName = 'filesystem' | (string & {});
 export type DefineCollectionOptions<TSchema extends ZodType | undefined = ZodType | undefined> = Omit<ContentCollectionConfig<TSchema>, 'source' | 'exclude'>;
 export interface DefineCollectionObject<TSchema extends ZodType | undefined = ZodType | undefined> extends DefineCollectionOptions<TSchema> {
     /**
@@ -153,14 +152,13 @@ export interface DefineCollectionObject<TSchema extends ZodType | undefined = Zo
  */
 export interface ContentConfig<TCollections extends Record<string, ContentCollectionConfig> = Record<string, ContentCollectionConfig>> {
     /**
-     * Content backing implementation. `filesystem` is the default. `cms`,
-     * `ginko-cms`, and `ginko` resolve to the official Ginko CMS provider when
-     * `@lupinum/ginko-cms` is installed.
+     * Content backing implementation. `filesystem` is the default. Provider
+     * modules can register named implementations, for example `cms`.
      */
     provider?: ContentProviderName;
     /**
-     * External provider modules keyed by provider name. Built-in providers do not
-     * need to be registered here.
+     * External provider modules keyed by provider name. First-party provider
+     * modules register themselves, so app configs usually do not need this.
      */
     providers?: Record<string, string>;
     /**
@@ -245,13 +243,13 @@ export declare function defineCollection<const Name extends string, const TConfi
  * ```ts
  * import { defineCollection, defineContentConfig } from '@lupinum/ginko-content/config'
  *
+ * export const docs = defineCollection('docs', {
+ *   type: 'page',
+ *   source: 'docs/*.md'
+ * })
+ *
  * export default defineContentConfig({
- *   collections: {
- *     docs: defineCollection({
- *       type: 'page',
- *       source: 'docs/*.md'
- *     })
- *   }
+ *   collections: { docs }
  * })
  * ```
  */
@@ -265,9 +263,9 @@ export declare function defineContentConfig<TCollections extends Record<string,
  * @example
  * ```ts
  * import { z } from 'zod'
- * import { defineCollection, reference } from '@lupinum/ginko-content/config'
+ * import { defineCollection, defineContentConfig, reference } from '@lupinum/ginko-content/config'
  *
- * export default defineCollection({
+ * export const blog = defineCollection('blog', {
  *   type: 'page',
  *   source: 'blog/*.md',
  *   schema: z.object({
@@ -275,6 +273,10 @@ export declare function defineContentConfig<TCollections extends Record<string,
  *     related: z.array(reference('blog')).default([])
  *   })
  * })
+ *
+ * export default defineContentConfig({
+ *   collections: { blog }
+ * })
  * ```
  */
 export declare function reference(collection?: string): ContentReferenceSchema;

package/dist/types/module.d.ts

@@ -386,12 +386,13 @@ export interface ModuleOptions {
     /**
      * Backing implementation for public content reads.
      *
-     * `filesystem` is the default. `cms`, `ginko-cms`, and `ginko` resolve to the
-     * official Ginko CMS provider when `@lupinum/ginko-cms` is installed.
+     * `filesystem` is the default. Provider modules can register named
+     * implementations, for example `cms`.
      */
     provider?: ContentProviderName;
     /**
-     * External provider modules keyed by provider name.
+     * External provider modules keyed by provider name. First-party provider
+     * modules register themselves, so app configs usually do not need this.
      */
     providers?: Record<string, string>;
     /**

package/dist/types/query.d.ts

@@ -434,6 +434,7 @@ export interface ContentSitemapImage {
 export interface ContentSitemapEntry {
     loc: string;
     _sitemap?: string;
+    lastmod?: string;
     alternatives?: ContentSitemapAlternative[];
     images?: ContentSitemapImage[];
 }

package/dist/types.d.mts

@@ -8,4 +8,4 @@ export { type defineCollection, type defineContentConfig, type reference } from
 
 export { default } from './module.mjs'
 
-export { type BacklinkFields, type BacklinkSource, type BacklinksOptions, type BacklinksResult, type BuiltinContentProviderName, type CollectionQueryBuilder, type CollectionQueryOperator, type CollectionQueryValue, type CollectionSchema, type ContentCacheArtifact, type ContentCmsCollectionConfig, type ContentCmsFieldConfig, type ContentCmsFieldType, type ContentCmsRelationConfig, type ContentCollectionConfig, type ContentCollectionHandle, type ContentCollectionI18nConfig, type ContentCollectionI18nMap, type ContentCollectionItem, type ContentCollectionItemSurroundingsOptions, type ContentCollectionKind, type ContentCollectionMap, type ContentCollectionName, type ContentCollectionNavigationOptions, type ContentCollectionPageOptions, type ContentCollectionRouteConfig, type ContentCollectionRouteMetaOptions, type ContentCollectionSearchSectionsOptions, type ContentCollectionSource, type ContentCollectionSourceObject, type ContentConfig, type ContentContext, type ContentI18nOptions, type ContentLocaleEntry, type ContentLocaleRoute, type ContentManifest, type ContentMiniSearchOptions, type ContentNavigationItem, type ContentPageResult, type ContentPreviewOptions, type ContentProviderName, type ContentProviderSearchRequest, type ContentQueryBuilder, type ContentQueryBuilderParams, type ContentQueryBuilderWhere, type ContentQueryFetcher, type ContentQueryRequest, type ContentQuerySortFields, type ContentQuerySortOptions, type ContentQuerySortParams, type ContentReferenceSchema, type ContentResolvedMeta, type ContentRevalidateOptions, type ContentRouteMeta, type ContentSearchEngine, type ContentSearchIndexRecord, type ContentSearchOptions, type ContentSearchPublicRuntimeConfig, type ContentSearchResult, type ContentSearchSection, type ContentSelector, type ContentSeoImage, type ContentSeoMeta, type ContentSitemapAlternative, type ContentSitemapAssertOptions, type ContentSitemapAssertSitemapOptions, type ContentSitemapEntry, type ContentSitemapImage, type ContentSitemapOptions, type ContentTransformer, type ContentTreeItem, type ContentVariant, type DefineCollectionObject, type DefineCollectionOptions, type DocumentFromHandle, type LocaleFallback, type LocalePathEntry, type LocalizedDoc, type ManifestVariant, type ManyOptions, type MarkdownNode, type MarkdownOptions, type MarkdownParsedContent, type MarkdownPluginDescriptor, type MarkdownPluginOptions, type MarkdownRoot, type ModuleHooks, type ModuleOptions, type MountOptions, type NavItem, type NeighborsOptions, type NeighborsResult, type OneOptions, type PaginationOptions, type PaginationResult, type ParseContentOptions, type ParsedContent, type ParsedContentInternalMeta, type ParsedContentMeta, type PopulateFromOptions, type PopulateSpec, type PopulatedDocument, type QueryGroupBuilder, type QueryGroupFunction, type QueryMatchOperator, type QueryOperators, type QueryOrderDirection, type QueryOrderOptions, type QueryWhere, type ResolutionEnvelope, type ResolveContentReferenceOptions, type ResolveOneOptions, type ResolveOneResult, type ResolvedContentI18nOptions, type ResolvedMarkdownPlugin, type ResolvedVariant, type SortDirection, type SortSpec, type StrictParsedContent, type StrictParsedContentMeta, type Toc, type TocLink, type TransformContentOptions, type TransformContentSource, type TreeOptions, type VariantsOptions } from './module.mjs'
+export { type BacklinkFields, type BacklinkSource, type BacklinksOptions, type BacklinksResult, type CollectionQueryBuilder, type CollectionQueryOperator, type CollectionQueryValue, type CollectionSchema, type ContentCacheArtifact, type ContentCmsCollectionConfig, type ContentCmsFieldConfig, type ContentCmsFieldType, type ContentCmsRelationConfig, type ContentCollectionConfig, type ContentCollectionHandle, type ContentCollectionI18nConfig, type ContentCollectionI18nMap, type ContentCollectionItem, type ContentCollectionItemSurroundingsOptions, type ContentCollectionKind, type ContentCollectionMap, type ContentCollectionName, type ContentCollectionNavigationOptions, type ContentCollectionPageOptions, type ContentCollectionRouteConfig, type ContentCollectionRouteMetaOptions, type ContentCollectionSearchSectionsOptions, type ContentCollectionSource, type ContentCollectionSourceObject, type ContentConfig, type ContentContext, type ContentI18nOptions, type ContentLocaleEntry, type ContentLocaleRoute, type ContentManifest, type ContentMiniSearchOptions, type ContentNavigationItem, type ContentPageResult, type ContentPreviewOptions, type ContentProviderName, type ContentProviderSearchRequest, type ContentQueryBuilder, type ContentQueryBuilderParams, type ContentQueryBuilderWhere, type ContentQueryFetcher, type ContentQueryRequest, type ContentQuerySortFields, type ContentQuerySortOptions, type ContentQuerySortParams, type ContentReferenceSchema, type ContentResolvedMeta, type ContentRevalidateOptions, type ContentRouteMeta, type ContentSearchEngine, type ContentSearchIndexRecord, type ContentSearchOptions, type ContentSearchPublicRuntimeConfig, type ContentSearchResult, type ContentSearchSection, type ContentSelector, type ContentSeoImage, type ContentSeoMeta, type ContentSitemapAlternative, type ContentSitemapAssertOptions, type ContentSitemapAssertSitemapOptions, type ContentSitemapEntry, type ContentSitemapImage, type ContentSitemapOptions, type ContentTransformer, type ContentTreeItem, type ContentVariant, type DefineCollectionObject, type DefineCollectionOptions, type DocumentFromHandle, type LocaleFallback, type LocalePathEntry, type LocalizedDoc, type ManifestVariant, type ManyOptions, type MarkdownNode, type MarkdownOptions, type MarkdownParsedContent, type MarkdownPluginDescriptor, type MarkdownPluginOptions, type MarkdownRoot, type ModuleHooks, type ModuleOptions, type MountOptions, type NavItem, type NeighborsOptions, type NeighborsResult, type OneOptions, type PaginationOptions, type PaginationResult, type ParseContentOptions, type ParsedContent, type ParsedContentInternalMeta, type ParsedContentMeta, type PopulateFromOptions, type PopulateSpec, type PopulatedDocument, type QueryGroupBuilder, type QueryGroupFunction, type QueryMatchOperator, type QueryOperators, type QueryOrderDirection, type QueryOrderOptions, type QueryWhere, type ResolutionEnvelope, type ResolveContentReferenceOptions, type ResolveOneOptions, type ResolveOneResult, type ResolvedContentI18nOptions, type ResolvedMarkdownPlugin, type ResolvedVariant, type SortDirection, type SortSpec, type StrictParsedContent, type StrictParsedContentMeta, type Toc, type TocLink, type TransformContentOptions, type TransformContentSource, type TreeOptions, type VariantsOptions } from './module.mjs'

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "framework": "vue",
   "name": "@lupinum/ginko-content",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "contributions": {
     "html": {
       "description-markup": "markdown",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-content",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Collection-first content engine for Nuxt",
   "homepage": "https://ginko-content.nuxt.dev",
   "bugs": {