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

package/README.md

@@ -15,7 +15,7 @@
 </p>
 
 > [!WARNING]
-> Version `1.0.0-beta.6` 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?
@@ -40,13 +40,13 @@ output.
 Use the Nuxt CLI:
 
 ```bash
-npx nuxi module add @lupinum/ginko-content@1.0.0-beta.6
+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.6
+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.6",
+  "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.6";
+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" }
 ];

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.6",
+  "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.6",
+  "version": "1.0.0-beta.7",
   "description": "Collection-first content engine for Nuxt",
   "homepage": "https://ginko-content.lupinum.com",
   "bugs": {