@lupinum/ginko-content 1.0.0-beta.5 → 1.0.0-beta.7

package/README.md

@@ -15,7 +15,7 @@
 </p>
 
 > [!WARNING]
-> Version `1.0.0-beta.5` is a prerelease. Install it from npm's `next`
+> Version `1.0.0-beta.7` is a prerelease. Install it from npm's `next`
 > channel. The stable `0.3` line remains on `latest`.
 
 ## Why use this package?
@@ -32,7 +32,7 @@ output.
 
 - Node.js 22.18–22.x, 24.11–24.x, or 26+
 - Nuxt 4.5.1 through Nuxt 4.x
-- Vue 3.5.35 through Vue 3.x
+- Vue 3.5.40 through Vue 3.x
 - ESM; CommonJS `require()` is not supported
 
 ## Installation
@@ -40,13 +40,13 @@ output.
 Use the Nuxt CLI:
 
 ```bash
-npx nuxi module add @lupinum/ginko-content@1.0.0-beta.5
+npx nuxi module add @lupinum/ginko-content@1.0.0-beta.7
 ```
 
 Or install and register the module by hand:
 
 ```bash
-pnpm add @lupinum/ginko-content@1.0.0-beta.5
+pnpm add @lupinum/ginko-content@1.0.0-beta.7
 ```
 
 ```ts

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-content",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "configKey": "content",
   "compatibility": {
     "nuxt": ">=4.5.1 <5"

package/dist/module.mjs

@@ -34,7 +34,7 @@ import { assertCanonicalHighlightOptionNames } from '../dist/parsers/markdown-pl
 import { BUILTIN_MARKDOWN_RENDER_CONTRACTS } from '../dist/core/markdown/builtin-render-contracts.js';
 
 const name = "@lupinum/ginko-content";
-const version = "1.0.0-beta.5";
+const version = "1.0.0-beta.7";
 const peerDependencies = {
 	nuxt: ">=4.5.1 <5"};
 
@@ -252,6 +252,7 @@ const registerContentDevRuntime = (nuxt, options, contentContext) => {
 };
 
 const runtimeAppImportSpecs = [
+  { name: "useContentLocalePath", as: "useContentLocalePath", from: "./app/composables/use-content-locale-path.js" },
   { name: "useContentPage", as: "useContentPage", from: "./app/composables/use-content-page.js" },
   { name: "useContentSearch", as: "useGinkoContentSearch", from: "./app/composables/search.js" }
 ];
@@ -1109,6 +1110,7 @@ const collectRawMarkdownRoutesFromGeneratedFrontmatter = (markdown) => {
 };
 const publicOutputPath = (publicDir, route) => join(publicDir, normalizeStaticRoutePath(route).replace(/^\//, ""));
 
+const runtimeModuleImportURL = (modulePath, toFileURL = pathToFileURL) => toFileURL(modulePath).href;
 const assertPrerenderedContentSnapshot = (buildDir) => {
   const snapshotPath = resolve$1(buildDir, "content-cache/snapshot.json");
   let raw;
@@ -1166,7 +1168,7 @@ ${details}` : "")
           writeFileSync(indexPath, json, "utf8");
           if (searchRuntime.engine === "pagefind") {
             const records = JSON.parse(json);
-            const { writePagefindIndex } = await import(resolveRuntimeModule("./server/pagefind.js"));
+            const { writePagefindIndex } = await import(runtimeModuleImportURL(resolveRuntimeModule("./server/pagefind.js")));
             await writePagefindIndex(records, resolve$1(publicDir, "pagefind"), resolvedI18n.defaultLocale);
           }
         }
@@ -1364,6 +1366,29 @@ const registerContentNitroIntegrationHooks = (nitroConfig, options, contentConte
   });
 };
 
+const NUXT_NITRO_CACHE_DRIVER_SUFFIX = "/node_modules/@nuxt/nitro-server/dist/runtime/utils/cache-driver.mjs";
+const createNuxtWindowsCacheDriverResolver = (platform = process.platform, fromFileURL = fileURLToPath) => {
+  if (platform !== "win32") {
+    return void 0;
+  }
+  return {
+    name: "ginko-content:nuxt-windows-cache-driver",
+    resolveId(id) {
+      if (!id.startsWith("file:")) {
+        return null;
+      }
+      try {
+        const url = new URL(id);
+        if (url.protocol !== "file:" || url.hostname !== "" || url.search !== "" || url.hash !== "" || !url.pathname.toLowerCase().endsWith(NUXT_NITRO_CACHE_DRIVER_SUFFIX)) {
+          return null;
+        }
+        return fromFileURL(url);
+      } catch {
+        return null;
+      }
+    }
+  };
+};
 const hookNuxtBoundary$1 = (nuxt, name, callback) => {
   const hook = nuxt.hook;
   hook(name, callback);
@@ -1414,6 +1439,12 @@ const registerContentNitroConfig = ({
     }
     nitroConfig.bundledStorage = nitroConfig.bundledStorage || [];
     nitroConfig.bundledStorage.push("cache:content");
+    const windowsCacheDriverResolver = createNuxtWindowsCacheDriverResolver();
+    if (windowsCacheDriverResolver) {
+      nitroConfig.rollupConfig ||= {};
+      nitroConfig.rollupConfig.plugins ||= [];
+      nitroConfig.rollupConfig.plugins.push(windowsCacheDriverResolver);
+    }
     nitroConfig.externals = defu(typeof nitroConfig.externals === "object" ? nitroConfig.externals : {}, {
       inline: [
         resolveModuleFile("."),

package/dist/public/client.d.ts

@@ -2,14 +2,16 @@
  * Client-side public API surface (browser + SSR Vue).
  *
  * The unified query API (ADR-0016) is the supported core read path. The
- * public composable surface is exactly `useContentPage` and
- * `useContentSearch`; every other application workflow is
+ * public composable surface includes page loading, locale links, and
+ * search; every other application workflow is
  * ordinary Nuxt composition over the one-shot async query operations below.
  */
 export { one, many, count, paginate, backlinks, resolveOne, surround, navigation } from '../runtime/app/composables/query-api.js';
 export { getCollectionPath } from '../features/query/routes.js';
 export type { CollectionPathOptions } from '../features/query/routes.js';
 export { findFirstNavigationPage } from '../features/navigation/resolve.js';
+export { useContentLocalePath } from '../runtime/app/composables/use-content-locale-path.js';
+export type { ContentLocalePage, UseContentLocalePathOptions } from '../runtime/app/composables/use-content-locale-path.js';
 export { useContentPage } from '../runtime/app/composables/use-content-page.js';
 export type { ContentPageStatus, UseContentPageOptions, UseContentPageReturn } from '../runtime/app/composables/use-content-page.js';
 export type { QueryWhere, QueryOperators, ContentSelector, BacklinkFields, BacklinkSource, BacklinksOptions, BacklinksResult, CountOptions, LocaleFallback, DocumentFromHandle, OneOptions, ManyOptions, PaginationOptions, PaginationResult, PopulateSpec, PopulatedDocument, ResolveOneOptions, ResolveOneResult, LocalizedContentDocument, ResolutionEnvelope, SortSpec, ContentAlternate, ContentDocumentRoute, ContentDocumentResolution, ContentNavigationItem, ContentCollectionName, ContentCollectionTarget, ContentSearchSection, SurroundOptions, SurroundResult, NavigationOptions, ContentNavigationTreeItem, ResolvedContentNavigationItem, PaginationMode, OffsetPaginationResult, CursorPaginationResult } from '../types/query.js';

package/dist/public/client.js

@@ -10,6 +10,7 @@ export {
 } from "../runtime/app/composables/query-api.js";
 export { getCollectionPath } from "../features/query/routes.js";
 export { findFirstNavigationPage } from "../features/navigation/resolve.js";
+export { useContentLocalePath } from "../runtime/app/composables/use-content-locale-path.js";
 export { useContentPage } from "../runtime/app/composables/use-content-page.js";
 export { useContentSearch } from "../runtime/app/composables/search.js";
 export { querySiteData } from "../runtime/app/composables/site-data.js";

package/dist/runtime/app/composables/use-content-locale-path.d.ts

@@ -0,0 +1,10 @@
+import { type MaybeRefOrGetter } from 'vue';
+import type { UseContentPageReturn } from './use-content-page';
+/** The existing page result supplies the facts; no shared state or second query. */
+export type ContentLocalePage = Pick<UseContentPageReturn<unknown>, 'page' | 'status'>;
+export interface UseContentLocalePathOptions<L extends string = string> {
+    /** Used only when the source is undefined (an application-only page). */
+    fallback?: (locale: L) => string | undefined;
+}
+/** Derive interactive locale links from a page result supplied by its owner. */
+export declare function useContentLocalePath<L extends string = string>(source: MaybeRefOrGetter<ContentLocalePage | undefined>, options?: UseContentLocalePathOptions<L>): (locale: L) => string | undefined;

package/dist/runtime/app/composables/use-content-locale-path.js

@@ -0,0 +1,20 @@
+import { toValue } from "vue";
+import { useRoute, useRouter } from "#imports";
+import { pageMatchesRoute } from "./use-content-shared.js";
+import { getContentRuntime } from "./runtime.js";
+export function useContentLocalePath(source, options = {}) {
+  const route = useRoute();
+  const router = useRouter();
+  const runtime = getContentRuntime();
+  return (locale) => {
+    const result = toValue(source);
+    if (!result) return runtime.locales?.includes(locale) ? options.fallback?.(locale) : void 0;
+    if (result.status.value !== "success") return void 0;
+    const document = result.page.value;
+    if (!document || !pageMatchesRoute(document, route.path)) return void 0;
+    const alternates = document.route.alternates;
+    const alternate = alternates.find((item) => item.locale === locale && item.source === "variant") ?? alternates.find((item) => item.locale === locale);
+    if (!alternate) return void 0;
+    return router.resolve({ path: alternate.path, query: route.query, hash: route.hash }).fullPath;
+  };
+}

package/dist/runtime/app/composables/use-content-page.js

@@ -3,21 +3,11 @@ import { useAsyncData, useRoute } from "#imports";
 import { resolveCollectionI18n } from "../../../features/localization/path.js";
 import { one, surround } from "./query-api.js";
 import { getContentRuntime } from "./runtime.js";
-import { contentCollectionName, resolveLocaleFromRoutePath, resolveOptions, stableKey } from "./use-content-shared.js";
-const normalizeRoutePath = (path) => {
-  if (typeof path !== "string") return void 0;
-  const normalized = path.replace(/\/+$/, "");
-  return normalized || "/";
-};
+import { contentCollectionName, normalizeRoutePath, pageMatchesRoute, resolveLocaleFromRoutePath, resolveOptions, stableKey } from "./use-content-shared.js";
 const normalizePageSurround = (surroundOption) => {
   if (!surroundOption) return void 0;
   return surroundOption === true ? {} : surroundOption;
 };
-const pageMatchesRoute = (doc, path) => {
-  if (!doc?.route) return false;
-  const normalizedPath = normalizeRoutePath(path);
-  return normalizeRoutePath(doc.route.requestedPath) === normalizedPath || normalizeRoutePath(doc.route.resolvedPath) === normalizedPath;
-};
 export async function useContentPage(handle, options = {}) {
   const route = useRoute();
   const { surround: surroundOption, ...oneOptions } = options;

package/dist/runtime/app/composables/use-content-shared.d.ts

@@ -11,3 +11,18 @@ export declare const resolveOptions: <T extends Record<string, unknown>>(reactiv
 export declare const stableKey: (prefix: string, name: string, options: unknown) => string;
 export declare const contentCollectionName: (handle: ContentCollectionTarget) => string;
 export declare const resolveLocaleFromRoutePath: (path: string, locales: string[], defaultLocale?: string) => string | undefined;
+export declare const normalizeRoutePath: (path: unknown) => string | undefined;
+/**
+ * A resolved page "matches" the current route when either the exact
+ * selector the app queried with (`route.requestedPath`) or the document's
+ * own canonical public path (`route.resolvedPath`) equals the current route
+ * — the first covers a provider/alias match whose canonical path differs
+ * from the requested one, the
+ * second covers static/prerendered routes served under a normalized path.
+ */
+export declare const pageMatchesRoute: (doc: {
+    route?: {
+        requestedPath?: string;
+        resolvedPath?: string;
+    };
+} | null | undefined, path: string) => boolean;

package/dist/runtime/app/composables/use-content-shared.js

@@ -27,3 +27,13 @@ export const resolveLocaleFromRoutePath = (path, locales, defaultLocale) => {
   const firstSegment = path.split("/").filter(Boolean)[0];
   return firstSegment && locales.includes(firstSegment) ? firstSegment : defaultLocale;
 };
+export const normalizeRoutePath = (path) => {
+  if (typeof path !== "string") return void 0;
+  const normalized = path.replace(/\/+$/, "");
+  return normalized || "/";
+};
+export const pageMatchesRoute = (doc, path) => {
+  if (!doc?.route) return false;
+  const normalizedPath = normalizeRoutePath(path);
+  return normalizeRoutePath(doc.route.requestedPath) === normalizedPath || normalizeRoutePath(doc.route.resolvedPath) === normalizedPath;
+};

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "framework": "vue",
   "name": "@lupinum/ginko-content",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "contributions": {
     "html": {
       "description-markup": "markdown",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-content",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "description": "Collection-first content engine for Nuxt",
   "homepage": "https://ginko-content.lupinum.com",
   "bugs": {
@@ -172,7 +172,7 @@
     "nuxt": ">=4.5.1 <5",
     "pagefind": "^1.5.2",
     "vitest": ">=4.1.6 <5",
-    "vue": "^3.5.35"
+    "vue": "^3.5.40"
   },
   "peerDependenciesMeta": {
     "beautiful-mermaid": {