@lupinum/ginko-content 0.1.1 → 0.1.2

package/README.md

@@ -45,7 +45,7 @@ Define a collection:
 // content.config.ts
 import { defineCollection, defineContentConfig } from '@lupinum/ginko-content/config'
 
-export const pages = defineCollection('pages', {
+export const pages = defineCollection({
   type: 'page',
   source: '**/*.md'
 })
@@ -74,9 +74,7 @@ Render the current route through the collection:
 ```vue
 <!-- pages/[...slug].vue -->
 <script setup lang="ts">
-import { pages } from '~/content.config'
-
-const { page } = await useContentPage(pages)
+const { page } = await useContentPage('pages')
 </script>
 
 <template>
@@ -89,9 +87,10 @@ const { page } = await useContentPage(pages)
 - 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
+- Markdown, Comark component tags, YAML, JSON, and CSV ingestion
 - locale-aware content routing
-- route-aware page loading with `useContentPage(handle)`
+- route-aware page loading with `useContentPage('pages')`
+- semantic previous/next route-page data through `useContentPage('pages', { surround })`
 - server reads through `one`, `many`, `paginate`, `resolveOne`, `tree`, and
   `neighbors`
 - Vue composables for the same read model
@@ -99,6 +98,23 @@ const { page } = await useContentPage(pages)
 - sitemap integration for public content routes
 - a server-side provider contract for advanced custom sources
 
+## I18n, Sitemap, and Prerender Ownership
+
+For localized Nuxt apps, keep one source of truth per route type:
+
+- Static Nuxt page paths belong in Nuxt I18n `i18n.pages`.
+- Content page paths belong in Ginko collection routes and content files.
+- Sitemap XML is generated by `@nuxtjs/sitemap`.
+- Ginko registers the content sitemap source and contributes content prerender
+  routes.
+
+Do not duplicate docs, blog, pricing, privacy, or translated locale paths in
+`sitemap.urls` or app-owned `nitro.prerender.routes` arrays. Use
+`@nuxtjs/sitemap >= 8.0.15` when translated static app slugs such as `/preise`
+and `/en/pricing` need cross-locale sitemap alternates.
+
+See the public guide: [Sitemap and prerender](../../docs/content/docs/6.i18n/4.sitemap-prerender.md).
+
 ## Scope
 
 The default provider reads files from your Nuxt project. The package does not

package/compatibility.json

@@ -1,7 +1,7 @@
 {
   "name": "Ginko Content release compatibility",
   "releaseStack": {
-    "@lupinum/ginko-content": "0.1.1",
+    "@lupinum/ginko-content": "0.1.2",
     "@lupinum/ginko-cms": "0.1.2",
     "@lupinum/ginko-cms-convex": "0.1.1",
     "@lupinum/ginko-cms-contract": "0.1.1"
@@ -13,7 +13,7 @@
     "convex": ["1.38.0", "^1.38.0"],
     "convex-helpers": ["^0.1.117", "0.1.117"],
     "h3": ["1.15.11"],
-    "nuxt": ["^4.4.6", "4.4.6", ">=4.0.0"],
+    "nuxt": ["^4.4.7", "4.4.7", ">=4.4.7"],
     "typescript": ["~6.0.3", "^6.0.3", "6.0.3"],
     "vite": ["^7.3.3", "7.3.3"],
     "vitest": ["^4.1.6", ">=4.1.6"],

package/dist/cli.mjs

@@ -42,32 +42,27 @@ const sourceChecks = [
   {
     pattern: /\bqueryCollectionItemSurroundings\s*\(/,
     message: "Nuxt Content v3 surround helper found.",
-    suggestion: "Use useContentNeighbors(handle, { by: { route } }) in route page components."
+    suggestion: "Use useContentPage('docs', { surround: true }) in route page components."
   },
   {
     pattern: /\bqueryCollectionSearchSections\s*\(/,
     message: "Nuxt Content v3 search sections helper found.",
-    suggestion: "Use useContentSearchData(collection) for UI search data."
+    suggestion: "Use useContentSearchData('docs') for UI search data."
   },
   {
     pattern: /\bqueryCollectionNavigation\s*\(/,
     message: "Nuxt Content v3 navigation helper found.",
-    suggestion: "Use useContentTree(handle) for layout navigation."
+    suggestion: "Use useContentNavigation('docs') for layout navigation."
   },
   {
     pattern: /\bqueryCollection\s*\(/,
     message: "Removed collection query helper found.",
-    suggestion: "Use one(handle, options), many(handle, options), paginate(handle, options), or the matching useContent* composable."
+    suggestion: "Use one('docs', options), many('docs', options), paginate('docs', options), or the matching useContent* composable."
   },
   {
     pattern: /\buseContentList\s*\(/,
     message: "Removed content list composable found.",
-    suggestion: "Use useContentMany(handle, options) or many(handle, options)."
-  },
-  {
-    pattern: /\buseContentNavigation\s*\(/,
-    message: "Removed content navigation composable found.",
-    suggestion: "Use useContentTree(handle) for layout navigation."
+    suggestion: "Use useContentMany('docs', options) or many('docs', options)."
   },
   {
     pattern: /\bcontent\.(database|preview|build)\b/,
@@ -84,15 +79,10 @@ const sourceChecks = [
     message: "ContentRenderer is receiving a document body.",
     suggestion: "Pass the full content document to ContentRenderer, not document.body."
   },
-  {
-    pattern: /<NuxtLink\b[^>]*:to\s*=\s*["'][^"']+\.path["']/,
-    message: "NuxtLink may be using raw query .path.",
-    suggestion: "Use useContentMany(handle, options) for route-safe list items, or link route-page payloads with their explicit path field."
-  },
   {
     pattern: /<NuxtLink\b[^>]*:to\s*=\s*["'][^"']+\._path["']/,
     message: "NuxtLink is using raw content _path.",
-    suggestion: "Use useContentMany(handle, options) for list pages and bind the route-safe item.path field."
+    suggestion: "Use useContentMany('docs', options) for list pages and bind the route-safe item.path field."
   }
 ];
 const lockfileNames = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lockb"];
@@ -156,36 +146,91 @@ function findMatchingBrace(text, start) {
   }
   return text.length - 1;
 }
-function findCollectionDefinitions(text) {
-  const definitions = [];
+function findAuthoredCollectionDefinitions(text) {
+  const definitions = /* @__PURE__ */ new Map();
   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)
-      });
+    const objectMatch = args.match(/^\s*\{/);
+    if (!objectMatch) {
       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)
+    const bodyStart = argsStart + objectMatch[0].lastIndexOf("{");
+    const bodyEnd = findMatchingBrace(text, bodyStart);
+    const block = text.slice(bodyStart, bodyEnd + 1);
+    const prefix = text.slice(0, callStart);
+    const propertyMatch = prefix.match(/([a-z_$][\w$]*)\s*:\s*$/i);
+    if (propertyMatch) {
+      definitions.set(propertyMatch[1], {
+        key: propertyMatch[1],
+        block
       });
+      continue;
+    }
+    const variableMatch = prefix.match(/(?:^|[\s;])(?:export\s+)?(?:const|let|var)\s+([a-z_$][\w$]*)\s*=\s*$/i);
+    if (variableMatch) {
+      definitions.set(variableMatch[1], { block });
     }
   }
   return definitions;
 }
+function findCollectionDefinitions(text) {
+  const authoredCollections = findAuthoredCollectionDefinitions(text);
+  const definitions = /* @__PURE__ */ new Map();
+  for (const block of findObjectPropertyBlocks(text, "collections")) {
+    for (const match of block.matchAll(/([a-z_$][\w$]*)\s*:\s*([a-z_$][\w$]*)\b/g)) {
+      const [, key, identifier] = match;
+      const authored = authoredCollections.get(identifier);
+      if (authored) {
+        definitions.set(key, {
+          name: key,
+          block: authored.block
+        });
+      }
+    }
+    for (const match of block.matchAll(/(?:^|[,{]\s*)([a-z_$][\w$]*)\s*(?=,|\})/g)) {
+      const key = match[1];
+      const authored = authoredCollections.get(key);
+      if (authored) {
+        definitions.set(key, {
+          name: key,
+          block: authored.block
+        });
+      }
+    }
+  }
+  for (const authored of authoredCollections.values()) {
+    if (authored.key) {
+      definitions.set(authored.key, {
+        name: authored.key,
+        block: authored.block
+      });
+    }
+  }
+  return [...definitions.values()];
+}
+function findObjectPropertyBlocks(text, property) {
+  const blocks = [];
+  const pattern = new RegExp(`\\b${property}\\s*:\\s*\\{`, "g");
+  for (const match of text.matchAll(pattern)) {
+    const bodyStart = text.indexOf("{", match.index);
+    if (bodyStart === -1) {
+      continue;
+    }
+    const bodyEnd = findMatchingBrace(text, bodyStart);
+    blocks.push(text.slice(bodyStart, bodyEnd + 1));
+  }
+  return blocks;
+}
+function extractStringArrayProperty(block, property) {
+  const match = block.match(new RegExp(`\\b${property}\\s*:\\s*\\[([\\s\\S]*?)\\]`));
+  if (!match) {
+    return [];
+  }
+  return [...match[1].matchAll(/['"]([^'"]+)['"]/g)].map((item) => item[1]);
+}
 async function collectFiles(dir, rootDir, files = []) {
   const entries = await readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
@@ -261,6 +306,32 @@ async function inspectSourceFiles(rootDir) {
   }
   return findings;
 }
+async function inspectSearchCollections(rootDir) {
+  const contentConfig = await readTextIfPresent(join(rootDir, "content.config.ts"));
+  const nuxtConfig = await readTextIfPresent(join(rootDir, "nuxt.config.ts"));
+  if (!contentConfig || !nuxtConfig) {
+    return [];
+  }
+  const dataCollections = new Set(
+    findCollectionDefinitions(contentConfig).filter((collection) => /\btype\s*:\s*['"]data['"]/.test(collection.block)).map((collection) => collection.name)
+  );
+  if (!dataCollections.size) {
+    return [];
+  }
+  const configuredCollections = new Set(
+    findObjectPropertyBlocks(nuxtConfig, "search").flatMap((block) => extractStringArrayProperty(block, "collections"))
+  );
+  const dataSearchCollections = [...configuredCollections].filter((collection) => dataCollections.has(collection));
+  if (!dataSearchCollections.length) {
+    return [];
+  }
+  return [{
+    severity: "info",
+    file: "nuxt.config.ts",
+    message: `Data-only collections listed in content.search.collections: ${dataSearchCollections.join(", ")}.`,
+    suggestion: "Remove data-only collections from the static public search index, make them route-backed pages, or use provider-backed search with route-safe results."
+  }];
+}
 async function inspectLockfiles(rootDir) {
   const findings = [];
   for (const lockfileName of lockfileNames) {
@@ -510,7 +581,7 @@ async function inspectI18nSourceSmells(rootDir, locales) {
         severity: "error",
         file: relativeFile,
         message: "Hardcoded locale route branch found.",
-        suggestion: "Use @nuxtjs/i18n route helpers, useContentTree(handle), or useContentMany(handle, options) item paths instead of branching on locale codes."
+        suggestion: "Use @nuxtjs/i18n route helpers, useContentNavigation('docs'), or useContentMany('docs', options) item paths instead of branching on locale codes."
       });
     }
     if (/<(?:NuxtLink|U[A-Za-z]+)\b[^>]*:to\s*=\s*["'][^"']+\._path["']/.test(text)) {
@@ -518,7 +589,7 @@ async function inspectI18nSourceSmells(rootDir, locales) {
         severity: "error",
         file: relativeFile,
         message: "UI link is bound to raw content _path.",
-        suggestion: "Use useContentMany(handle, options) for localized list pages and bind item.path."
+        suggestion: "Use useContentMany('docs', options) for localized list pages and bind item.path."
       });
     }
   }
@@ -703,6 +774,7 @@ async function runDoctor(options = {}) {
   const findings = [
     ...await inspectPackageJson(rootDir),
     ...await inspectSourceFiles(rootDir),
+    ...await inspectSearchCollections(rootDir),
     ...await inspectLockfiles(rootDir),
     ...await inspectSitemap(rootDir),
     ...options.i18n ? await inspectI18n(rootDir) : []

package/dist/core/references/schema.d.ts

@@ -5,4 +5,5 @@ export declare const getObjectShape: (schema: any) => Record<string, any>;
 export declare const getReferenceDescriptor: (schema: any) => {
     collection?: string;
 } | null;
+export declare const collectTopLevelReferenceFieldsByTarget: (schema: unknown) => Record<string, string[]>;
 export declare const collectTopLevelReferenceFields: (schema: unknown, targetCollection?: string) => string[];

package/dist/core/references/schema.js

@@ -53,18 +53,41 @@ const getArrayElement = (schema) => {
   const def = getSchemaDef(current);
   return def.element || def.type || null;
 };
-export const collectTopLevelReferenceFields = (schema, targetCollection) => {
+const wildcardReferenceTarget = "*";
+const getTopLevelReferenceDescriptor = (schema) => {
+  const direct = getReferenceDescriptor(schema);
+  if (direct) {
+    return direct;
+  }
+  const arrayElement = getArrayElement(schema);
+  return arrayElement ? getReferenceDescriptor(arrayElement) : null;
+};
+export const collectTopLevelReferenceFieldsByTarget = (schema) => {
   const current = unwrapSchema(schema);
   if (getSchemaTypeName(current) !== "ZodObject") {
-    return [];
+    return {};
   }
-  return Object.entries(getObjectShape(current)).filter(([, childSchema]) => {
-    const direct = getReferenceDescriptor(childSchema);
-    if (direct) {
-      return !direct.collection || !targetCollection || direct.collection === targetCollection;
+  const references = {};
+  for (const [field, childSchema] of Object.entries(getObjectShape(current))) {
+    const descriptor = getTopLevelReferenceDescriptor(childSchema);
+    if (!descriptor) {
+      continue;
     }
-    const arrayElement = getArrayElement(childSchema);
-    const arrayRef = arrayElement ? getReferenceDescriptor(arrayElement) : null;
-    return Boolean(arrayRef && (!arrayRef.collection || !targetCollection || arrayRef.collection === targetCollection));
-  }).map(([field]) => field);
+    const target = descriptor.collection || wildcardReferenceTarget;
+    references[target] ||= [];
+    references[target].push(field);
+  }
+  return references;
+};
+export const collectTopLevelReferenceFields = (schema, targetCollection) => {
+  const references = collectTopLevelReferenceFieldsByTarget(schema);
+  if (!targetCollection) {
+    return [...new Set(Object.values(references).flat())];
+  }
+  return [
+    .../* @__PURE__ */ new Set([
+      ...references[targetCollection] || [],
+      ...references[wildcardReferenceTarget] || []
+    ])
+  ];
 };

package/dist/module.d.mts

@@ -4,8 +4,8 @@ import { ContentCollectionConfig as ContentCollectionConfig$1, ContentCollection
 export { defineCollection, defineContentConfig, reference } from '../dist/types/config';
 import { StorageValue } from 'unstorage';
 import { ModuleOptions as ModuleOptions$1, ContentContext as ContentContext$1, ContentRevalidateOptions as ContentRevalidateOptions$1 } from '../dist/types/module';
-import { ContentSearchPublicRuntimeConfig as ContentSearchPublicRuntimeConfig$1 } from '../dist/types/search';
 import { ZodType, z } from 'zod';
+import { ContentSearchPublicRuntimeConfig as ContentSearchPublicRuntimeConfig$1 } from '../dist/types/search';
 import { ListenOptions } from 'listhen';
 
 /**
@@ -29,6 +29,7 @@ type ContentCollectionSource = string | string[];
  * express roots such as `{ en: '/docs', de: '/dokumentation' }`.
  */
 type ContentCollectionRouteConfig = string | Record<string, string>;
+type ContentCollectionKind = 'page' | 'data';
 type ContentCmsFieldType = 'text' | 'textarea' | 'richtext' | 'slug' | 'email' | 'url' | 'number' | 'range' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'toggle' | 'date' | 'datetime' | 'time' | 'json' | 'object' | 'array' | 'blocks' | 'relation' | 'relations' | 'image' | 'images' | 'file' | 'icon' | 'code' | 'color' | 'divider' | 'section';
 interface ContentCmsRelationConfig {
     collectionId: string;
@@ -88,6 +89,11 @@ interface ContentCollectionSourceObject {
  * Declarative collection definition used by `content.config.ts`.
  */
 interface ContentCollectionConfig<TSchema extends ZodType | undefined = ZodType | undefined> {
+    /**
+     * Collection kind declared in `defineCollection`. Page collections are public
+     * content routes by default; data collections are app-owned records.
+     */
+    type?: ContentCollectionKind;
     /**
      * Source glob or source descriptor understood by the filesystem ingestion
      * layer. CMS-backed projects do not need a runtime source; filesystem
@@ -140,13 +146,13 @@ interface ContentCollectionConfig<TSchema extends ZodType | undefined = ZodType
      */
     cms?: ContentCmsCollectionConfig;
 }
-type ContentCollectionKind = 'page' | 'data';
 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> {
     /**
      * Nuxt Content v3-compatible collection kind. Ginko does not keep separate
-     * page/data collection runtimes; `data` collections default to `sitemap: false`.
+     * page/data query builders, but the kind remains canonical metadata at runtime.
+     * `data` collections default to `sitemap: false`.
      */
     type: ContentCollectionKind;
     /**
@@ -219,6 +225,17 @@ interface ContentCollectionHandle<Name extends string = string, TSchema extends
      */
     readonly __schema: TSchema;
 }
+type IsI18nConfig<TConfig> = TConfig extends {
+    i18n: true | ContentCollectionI18nConfig;
+} ? TConfig['i18n'] extends false ? false : true : false;
+type CollectionNameFromConfigKey<Key extends string, TCollection> = TCollection extends ContentCollectionHandle<infer Name, ZodType | undefined, boolean> ? [Name] extends [never] ? Key : Name : Key;
+type NamedContentCollection<Key extends string, TCollection> = TCollection extends ContentCollectionHandle<infer Name, infer TSchema, infer TI18n> ? Omit<TCollection, 'name' | '__schema' | '__i18n'> & ContentCollectionHandle<[
+    Name
+] extends [never] ? Key : Name, TSchema, TI18n> : TCollection extends ContentCollectionConfig<infer TSchema> ? Omit<TCollection, 'name' | '__schema' | '__i18n'> & ContentCollectionHandle<CollectionNameFromConfigKey<Key, TCollection>, TSchema, IsI18nConfig<TCollection>> : TCollection;
+type NamedContentCollections<TCollections extends Record<string, ContentCollectionConfig>> = {
+    [Key in keyof TCollections]: Key extends string ? NamedContentCollection<Key, TCollections[Key]> : TCollections[Key];
+};
+declare function normalizeContentConfigCollectionNames<TCollections extends Record<string, ContentCollectionConfig>>(collections: TCollections): NamedContentCollections<TCollections>;
 
 type LayoutKey = string;
 interface ContentSeoImage {
@@ -1107,12 +1124,20 @@ interface ContentQueryRequest {
  */
 type ContentQueryFetcher<T> = (query: ContentQueryRequest) => Promise<ContentQueryResponse<T>>;
 type QueryMatchOperator = (item: unknown, condition: unknown) => boolean;
-interface ContentCollectionMap {
+declare global {
+    interface GinkoContentCollectionMap {
+    }
+    interface GinkoContentCollectionI18nMap {
+    }
+}
+interface ContentCollectionMap extends GinkoContentCollectionMap {
 }
-interface ContentCollectionI18nMap {
+interface ContentCollectionI18nMap extends GinkoContentCollectionI18nMap {
 }
-type ContentCollectionName = keyof ContentCollectionMap & string;
+type ContentCollectionName = keyof GinkoContentCollectionMap & string;
 type ContentCollectionItem<K extends ContentCollectionName> = ContentCollectionMap[K];
+type ContentCollectionStringName = [ContentCollectionName] extends [never] ? string : ContentCollectionName;
+type ContentCollectionTarget = ContentCollectionHandle | ContentCollectionStringName;
 /**
  * ============================================================================
  *  Unified Query API — public surface (ADR-0016)
@@ -1203,8 +1228,8 @@ type HandleSchema<H> = H extends {
     __schema: infer S;
 } ? S extends {
     _output: infer O;
-} ? O & StrictParsedContentMeta : StrictParsedContentMeta : StrictParsedContentMeta;
-type SelectFields<H> = H extends string ? ReadonlyArray<string> : ReadonlyArray<Extract<keyof HandleSchema<H>, string>>;
+} ? O & StrictParsedContentMeta : StrictParsedContentMeta : H extends ContentCollectionName ? ContentCollectionMap[H] & StrictParsedContentMeta : StrictParsedContentMeta;
+type SelectFields<H> = string extends H ? ReadonlyArray<string> : ReadonlyArray<Extract<keyof HandleSchema<H>, string>>;
 /**
  * Runtime document shape inferred from a collection handle.
  */
@@ -1212,12 +1237,12 @@ type DocumentFromHandle<H> = H extends {
     __schema: {
         _output: infer O;
     };
-} ? O & ParsedContent : ParsedContent;
+} ? O & StrictParsedContent : H extends ContentCollectionName ? ContentCollectionMap[H] : ParsedContent;
 /**
  * Explicit reference population map. Keys are fields on the source document;
  * values are target collection handles.
  */
-type PopulateSpec = Record<string, ContentCollectionHandle | string>;
+type PopulateSpec = Record<string, ContentCollectionTarget>;
 type PopulatedDocument<T, P> = P extends undefined ? T : P extends PopulateSpec ? string extends keyof P ? T : Omit<T, keyof P> & {
     [K in keyof P & keyof T]: T[K] extends ReadonlyArray<unknown> ? Array<LocalizedDoc<DocumentFromHandle<P[K]>>> : LocalizedDoc<DocumentFromHandle<P[K]>> | null;
 } : T;
@@ -1232,7 +1257,7 @@ type PopulateOption<P extends PopulateSpec | undefined = undefined> = {
  */
 type HandleIsI18n<H> = H extends {
     __i18n: infer I;
-} ? I extends true ? true : false : false;
+} ? I extends true ? true : false : H extends keyof GinkoContentCollectionI18nMap ? true : false;
 /**
  * Locale option made required when the handle is i18n.
  */
@@ -1349,7 +1374,7 @@ interface PaginationResult<T = ParsedContentMeta> {
     nextPage: number | null;
     prevPage: number | null;
 }
-type BacklinkSource = ContentCollectionHandle | string;
+type BacklinkSource = ContentCollectionTarget;
 type SourceName<S> = S extends string ? S : S extends {
     name: infer N;
 } ? Extract<N, string> : string;
@@ -1376,7 +1401,7 @@ type BacklinksOptions<Target = unknown, Source extends BacklinkSource | Readonly
     limit?: number;
     skip?: number;
     fallback?: LocaleFallback;
-    select?: Source extends string ? ReadonlyArray<string> : ReadonlyArray<Extract<keyof DocumentFromSource<Source>, string>>;
+    select?: string extends Source ? ReadonlyArray<string> : ReadonlyArray<Extract<keyof DocumentFromSource<Source>, string>>;
 } & BacklinksLocaleOption<Target, Source> & PopulateOption<P>;
 type BacklinksResult<Source extends BacklinkSource | ReadonlyArray<BacklinkSource> = BacklinkSource | ReadonlyArray<BacklinkSource>, P extends PopulateSpec | undefined = undefined> = Array<LocalizedDoc<PopulatedDocument<DocumentFromSource<Source>, P>>>;
 /**
@@ -1448,7 +1473,7 @@ interface ContentMiniSearchOptions {
     /**
      * Fields copied into search result payloads.
      *
-     * @default ['path', 'title', 'excerpt', 'anchor', 'locale']
+     * @default ['path', 'title', 'excerpt', 'anchor', 'locale', 'collection']
      */
     storeFields: string[];
     /**
@@ -1478,6 +1503,7 @@ interface ContentSearchPublicRuntimeConfig {
 }
 interface ContentSearchIndexRecord {
     id: string;
+    collection: string;
     path: string;
     title: string;
     excerpt: string;
@@ -1488,6 +1514,7 @@ interface ContentSearchIndexRecord {
     [field: string]: unknown;
 }
 interface ContentSearchResult {
+    collection: string;
     path: string;
     title: string;
     excerpt: string;
@@ -1659,6 +1686,36 @@ interface ContentSitemapAssertOptions {
      * @default []
      */
     requiredCollections?: string[];
+    /**
+     * Public URL paths that must appear in generated sitemap loc values.
+     *
+     * Values are compared by URL pathname, so absolute sitemap URLs are
+     * normalized before assertion. Use this for release QA of important route
+     * identities; keep `requiredCollections` for the broader content invariant.
+     *
+     * @default []
+     */
+    requiredPaths?: string[];
+    /**
+     * Public URL path prefixes that must not appear in generated sitemap loc
+     * values.
+     *
+     * Use this to guard against internal/generated routes such as `/_payload`,
+     * `/_nuxt`, API routes, or auth-only sections.
+     *
+     * @default []
+     */
+    forbiddenPathPrefixes?: string[];
+    /**
+     * Fail when generated sitemap URLs use placeholder or local hosts such as
+     * `example.com`, `localhost`, `127.0.0.1`, or `.localhost`.
+     *
+     * Enable this for production-like release checks. It is disabled by default
+     * so local examples and template builds can still generate static output.
+     *
+     * @default false
+     */
+    requireProductionSiteUrl?: boolean;
     /**
      * Optional per-sitemap overrides keyed by sitemap name, for example `en-US`.
      *
@@ -1694,7 +1751,8 @@ interface ContentSearchOptions {
     /**
      * Collections included in the built-in index.
      *
-     * When omitted, all configured collections are indexed.
+     * When omitted, Ginko indexes route-backed public collections only. Data-only
+     * collections are excluded unless listed explicitly.
      */
     collections?: string[];
     /**
@@ -1757,8 +1815,9 @@ interface ModuleOptions {
      * Built-in full-text search configuration.
      *
      * When enabled, Ginko exposes JSON/Pagefind search endpoints under
-     * the content api base route. Import `useContentSearchResults()` from
-     * `@lupinum/ginko-content/client` to consume them from app components.
+     * the content api base route. `useContentSearchData()` and
+     * `useContentSearchResults()` are auto-imported; import the headless
+     * `useContentSearch()` helper from `@lupinum/ginko-content/client`.
      */
     search: false | ContentSearchOptions;
     /**
@@ -2041,5 +2100,5 @@ declare module 'nitropack' {
     }
 }
 
-export { _default as default };
-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 };
+export { _default as default, normalizeContentConfigCollectionNames };
+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, ContentCollectionStringName, ContentCollectionTarget, 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.1",
+  "version": "0.1.2",
   "configKey": "content",
   "compatibility": {
     "nuxt": ">=4.0.0"