@lupinum/ginko-content 0.1.3 → 0.1.5

package/compatibility.json

@@ -1,7 +1,7 @@
 {
   "name": "Ginko Content release compatibility",
   "releaseStack": {
-    "@lupinum/ginko-content": "0.1.3",
+    "@lupinum/ginko-content": "0.1.5",
     "@lupinum/ginko-cms": "0.1.2",
     "@lupinum/ginko-cms-convex": "0.1.1",
     "@lupinum/ginko-cms-contract": "0.1.1"

package/dist/core/content/graph.d.ts

@@ -16,7 +16,7 @@
  *  - **`byRoute`**: route path (user-visible URL) → content id. Used by the
  *    page resolver when the request arrives as a localized URL.
  *  - **`byRef`**: normalized ref string → canonical key. This is how
- *    `[link](ref:authors/evan)` finds its target without a scan.
+ *    markdown links such as `[Ada]($authors.ada)` find their target without a scan.
  *  - **`referenceTargets`**: the `buildReferenceTargets` map — every shape
  *    the user might plausibly write to point at a document (canonical
  *    name, locale-prefixed path, short slug) pre-resolved to a canonical

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

@@ -28,4 +28,23 @@ export declare const parseRefLink: (value: string) => {
 } | null;
 export declare const collectMarkdownRefLinks: (node: unknown) => string[];
 export declare const rewriteMarkdownRefLinks: <T>(node: T, resolvedRefs?: Record<string, string>) => T;
+export interface MarkdownQuickLinkTarget {
+    route: string;
+    params?: Record<string, string | number>;
+    query?: Record<string, string | number | boolean | undefined>;
+}
+export type MarkdownQuickLinks = Record<string, Record<string, MarkdownQuickLinkTarget>>;
+export type ResolveQuickLinkRoute = (route: {
+    name: string;
+    hash?: string;
+    params?: Record<string, string | number>;
+    query?: Record<string, string | number | boolean | undefined>;
+}) => string;
+export declare const resolveConfiguredQuickLink: (href: string, links: MarkdownQuickLinks | undefined, resolveRoute: ResolveQuickLinkRoute) => string | undefined;
+export declare const resolveConfiguredQuickLinks: (hrefs: string[], links: MarkdownQuickLinks | undefined, resolveRoute: ResolveQuickLinkRoute) => {
+    [k: string]: string;
+};
+export declare const resolveMarkdownRenderRefs: (node: unknown, resolvedRefs: Record<string, string> | undefined, links: MarkdownQuickLinks | undefined, resolveRoute: ResolveQuickLinkRoute) => {
+    [x: string]: string;
+};
 export declare const buildReferenceTargets: (contents: ParsedContent[], locales?: string[]) => Map<string, string>;

package/dist/core/references/resolve.js

@@ -1,5 +1,6 @@
 import { isMarkdownRoot, mapMarkdownNode } from "../markdown/tree.js";
 export const CONTENT_REF_LINK_PREFIX = "$";
+const MARKDOWN_LINK_PROP_KEYS = ["href", "to"];
 export const normalizeReferenceValue = (value) => String(value).replace(/^\/+|\/+$/g, "");
 export const parseRefLink = (value) => {
   if (typeof value !== "string" || !value.startsWith(CONTENT_REF_LINK_PREFIX)) {
@@ -17,6 +18,17 @@ export const parseRefLink = (value) => {
 };
 export const collectMarkdownRefLinks = (node) => {
   const refs = /* @__PURE__ */ new Set();
+  const collectProps = (props) => {
+    if (!props || typeof props !== "object") {
+      return;
+    }
+    for (const key of MARKDOWN_LINK_PROP_KEYS) {
+      const value = props[key];
+      if (typeof value === "string" && parseRefLink(value)) {
+        refs.add(value);
+      }
+    }
+  };
   const visit = (current) => {
     if (!current || typeof current !== "object") {
       return;
@@ -27,10 +39,7 @@ export const collectMarkdownRefLinks = (node) => {
     }
     if (current.type === "element") {
       const markdownNode = current;
-      const href2 = markdownNode.tag === "a" && typeof markdownNode.props?.href === "string" ? markdownNode.props.href : void 0;
-      if (href2 && parseRefLink(href2)) {
-        refs.add(href2);
-      }
+      collectProps(markdownNode.props);
       markdownNode.children?.forEach(visit);
       return;
     }
@@ -38,16 +47,27 @@ export const collectMarkdownRefLinks = (node) => {
       current.forEach(visit);
       return;
     }
-    const href = typeof current.props?.href === "string" && current.tag === "a" ? current.props.href : void 0;
-    if (href && parseRefLink(href)) {
-      refs.add(href);
-    }
+    collectProps(current.props);
     visit(current.children);
   };
   visit(node);
   return Array.from(refs);
 };
 export const rewriteMarkdownRefLinks = (node, resolvedRefs = {}) => {
+  const rewriteProps = (props) => {
+    if (!props || typeof props !== "object") {
+      return void 0;
+    }
+    let next;
+    for (const key of MARKDOWN_LINK_PROP_KEYS) {
+      const value = props[key];
+      if (typeof value === "string" && resolvedRefs[value]) {
+        next ||= { ...props };
+        next[key] = resolvedRefs[value];
+      }
+    }
+    return next || props;
+  };
   const visit = (current) => {
     if (!current || typeof current !== "object") {
       return current;
@@ -60,16 +80,13 @@ export const rewriteMarkdownRefLinks = (node, resolvedRefs = {}) => {
     }
     if (current.type === "element") {
       return mapMarkdownNode(current, (markdownNode) => {
-        const href2 = typeof markdownNode.props?.href === "string" && markdownNode.tag === "a" ? markdownNode.props.href : void 0;
-        if (!href2 || !resolvedRefs[href2]) {
+        const props2 = rewriteProps(markdownNode.props);
+        if (props2 === markdownNode.props) {
           return markdownNode;
         }
         return {
           ...markdownNode,
-          props: {
-            ...markdownNode.props,
-            href: resolvedRefs[href2]
-          }
+          props: props2
         };
       });
     }
@@ -77,12 +94,9 @@ export const rewriteMarkdownRefLinks = (node, resolvedRefs = {}) => {
       return current.map((item) => visit(item));
     }
     const next = { ...current };
-    const href = typeof next.props?.href === "string" && next.tag === "a" ? next.props.href : void 0;
-    if (href && resolvedRefs[href]) {
-      next.props = {
-        ...next.props,
-        href: resolvedRefs[href]
-      };
+    const props = rewriteProps(next.props);
+    if (props !== next.props) {
+      next.props = props;
     }
     if (Array.isArray(next.children)) {
       next.children = next.children.map((child) => visit(child));
@@ -91,6 +105,44 @@ export const rewriteMarkdownRefLinks = (node, resolvedRefs = {}) => {
   };
   return visit(node);
 };
+export const resolveConfiguredQuickLink = (href, links, resolveRoute) => {
+  const parsed = parseRefLink(href);
+  if (!parsed || !links) {
+    return void 0;
+  }
+  const separator = parsed.ref.indexOf(".");
+  if (separator <= 0 || separator === parsed.ref.length - 1) {
+    return void 0;
+  }
+  const namespace = parsed.ref.slice(0, separator);
+  const key = parsed.ref.slice(separator + 1);
+  const target = links[namespace]?.[key];
+  if (!target?.route) {
+    return void 0;
+  }
+  return resolveRoute({
+    name: target.route,
+    ...target.params ? { params: target.params } : {},
+    ...target.query ? { query: target.query } : {},
+    ...parsed.hash ? { hash: parsed.hash } : {}
+  });
+};
+export const resolveConfiguredQuickLinks = (hrefs, links, resolveRoute) => {
+  return Object.fromEntries(hrefs.flatMap((href) => {
+    const resolved = resolveConfiguredQuickLink(href, links, resolveRoute);
+    return resolved ? [[href, resolved]] : [];
+  }));
+};
+export const resolveMarkdownRenderRefs = (node, resolvedRefs, links, resolveRoute) => {
+  const quickRefs = resolveConfiguredQuickLinks(collectMarkdownRefLinks(node), links, resolveRoute);
+  const concreteContentRefs = Object.fromEntries(
+    Object.entries(resolvedRefs || {}).filter(([href, value]) => value && value !== href)
+  );
+  return {
+    ...quickRefs,
+    ...concreteContentRefs
+  };
+};
 export const buildReferenceTargets = (contents, locales = []) => {
   const targets = /* @__PURE__ */ new Map();
   for (const document of contents) {

package/dist/module.d.mts

@@ -1405,6 +1405,21 @@ interface ContentRevalidateOptions {
      */
     allowUnsigned?: boolean;
 }
+interface ContentLinkRouteTarget {
+    /**
+     * Nuxt route name passed to Nuxt I18n `localePath()`.
+     */
+    route: string;
+    /**
+     * Static route params forwarded to Nuxt I18n `localePath()`.
+     */
+    params?: Record<string, string | number>;
+    /**
+     * Static query params forwarded to Nuxt I18n `localePath()`.
+     */
+    query?: Record<string, string | number | boolean | undefined>;
+}
+type ContentLinksOptions = Record<string, Record<string, ContentLinkRouteTarget>>;
 interface ContentAgentRouteOptions {
     routes?: boolean;
     linkHeaders?: boolean;
@@ -1454,6 +1469,15 @@ interface ModuleOptions {
      * `x-ginko-revalidate-token` or `authorization: Bearer <token>`.
      */
     revalidate?: false | ContentRevalidateOptions;
+    /**
+     * Writer-facing markdown quick links. Values point at Nuxt route names;
+     * localized paths stay owned by Nuxt I18n.
+     *
+     * @example
+     * content.links.main.pricing = { route: 'pricing' }
+     * markdown: [Pricing]($main.pricing)
+     */
+    links?: ContentLinksOptions;
     /**
      * First-class agent markdown and LLM route features.
      */
@@ -1673,6 +1697,7 @@ interface ModulePublicRuntimeConfig {
     locales: ContentContext$1['locales'];
     provider: ContentContext$1['provider'];
     providers: ContentContext$1['providers'];
+    links: ContentContext$1['links'];
     collections: Record<string, {
         source: ContentCollectionConfig$1['source'];
         exclude?: ContentCollectionConfig$1['exclude'];
@@ -1726,4 +1751,4 @@ interface ModuleHooks {
 }
 
 export { _default as default, normalizeContentConfigCollectionNames };
-export type { AgentMetadataField, AgentMetadataFieldList, BacklinkFields, BacklinkSource, BacklinksOptions, BacklinksResult, CollectionQueryBuilder, CollectionQueryField, CollectionQueryFieldValue, CollectionQueryKey, CollectionQueryOperator, CollectionQueryValue, CollectionSchema, ContentAgentAppPageConfig, ContentAgentAppPageContext, ContentAgentCollectionConfig, ContentAgentConfig, ContentAgentLocalizedValue, ContentAgentMarkdownMetadataConfig, ContentAgentMarkdownOptions, ContentAgentMarkdownPolicyConfig, ContentAgentRouteOptions, ContentAgentSectionConfig, ContentAgentSiteConfig, 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, LocalizedContentDocument, 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, ResolvedContentContext, ResolvedContentI18nOptions, ResolvedMarkdownPlugin, ResolvedVariant, SortDirection, SortSpec, StrictParsedContent, StrictParsedContentMeta, Toc, TocLink, TransformContentOptions, TransformContentSource, TreeOptions, VariantsOptions };
+export type { AgentMetadataField, AgentMetadataFieldList, BacklinkFields, BacklinkSource, BacklinksOptions, BacklinksResult, CollectionQueryBuilder, CollectionQueryField, CollectionQueryFieldValue, CollectionQueryKey, CollectionQueryOperator, CollectionQueryValue, CollectionSchema, ContentAgentAppPageConfig, ContentAgentAppPageContext, ContentAgentCollectionConfig, ContentAgentConfig, ContentAgentLocalizedValue, ContentAgentMarkdownMetadataConfig, ContentAgentMarkdownOptions, ContentAgentMarkdownPolicyConfig, ContentAgentRouteOptions, ContentAgentSectionConfig, ContentAgentSiteConfig, 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, ContentLinkRouteTarget, ContentLinksOptions, 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, LocalizedContentDocument, 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, ResolvedContentContext, 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.3",
+  "version": "0.1.5",
   "configKey": "content",
   "compatibility": {
     "nuxt": ">=4.0.0"

package/dist/module.mjs

@@ -3,8 +3,6 @@ import { defu } from 'defu';
 import fs, { existsSync } from 'fs';
 import { join, relative, resolve, isAbsolute } from 'pathe';
 import jiti from 'jiti';
-import { createRequire } from 'node:module';
-import { pathToFileURL } from 'node:url';
 import { genSafeVariableName, genImport } from 'knitwork';
 import { hash } from 'ohash';
 import 'unstorage/drivers/fs';
@@ -25,13 +23,14 @@ import { resolveCollectionI18n, prefixPathWithLocale } from '../dist/features/lo
 import { resolveContentSitemapSource, GINKO_SITEMAP_SOURCE_NAME } from '../dist/runtime/utils/sitemap-source';
 import { normalizeRouteMounts, normalizeContentPath } from '../dist/core/content/path';
 import { mkdirSync, writeFileSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
 import { withTrailingSlash } from 'ufo';
 import { normalizeContentConfigCollectionNames } from '../dist/types/config';
 export { agentMetadataFields, defineAgentAppPage, defineAgentMarkdownPolicy, defineAgentMetadataFields, defineAgentSection, defineCollection, defineContentConfig, reference } from '../dist/types/config';
 import { collectTopLevelReferenceFieldsByTarget } from '../dist/core/references/schema';
 
 const name = "@lupinum/ginko-content";
-const version = "0.1.3";
+const version = "0.1.5";
 
 const CONFIG_FILES = [
   "content.config.ts",
@@ -53,8 +52,6 @@ async function loadContentConfig(nuxt) {
   return loaded?.default || loaded || {};
 }
 
-const require$1 = createRequire(import.meta.url);
-const jitiImportSpecifier = pathToFileURL(require$1.resolve("jiti")).href;
 const createVirtualContentTemplates = (contentContext, nuxt, contentConfigPath, addTemplateImpl) => {
   const transformersTemplate = addTemplateImpl({
     filename: "content/virtual-transformers.mjs",
@@ -77,10 +74,8 @@ const createVirtualContentTemplates = (contentContext, nuxt, contentConfigPath,
     filename: "content/virtual-config.mjs",
     write: true,
     getContents: () => contentConfigPath ? [
-      `import jiti from ${JSON.stringify(jitiImportSpecifier)}`,
-      `const importer = jiti(import.meta.url, { interopDefault: true })`,
-      `const config = await importer.import(${JSON.stringify(contentConfigPath)})`,
-      "export default config?.default || config || {}"
+      `import config from ${JSON.stringify(contentConfigPath)}`,
+      "export default config || {}"
     ].join("\n") : "export default {}"
   }).dst;
   const virtualProvidersTemplate = addTemplateImpl({
@@ -307,8 +302,9 @@ const registerContentI18nTemplate = (addTemplateImpl, hasNuxtI18nModule) => {
     filename: "content-i18n.mjs",
     write: true,
     getContents: () => hasNuxtI18nModule ? [
-      "export { useRouteBaseName, useSetI18nParams, useSwitchLocalePath } from '#i18n'"
+      "export { useLocalePath, useRouteBaseName, useSetI18nParams, useSwitchLocalePath } from '#i18n'"
     ].join("\n") : [
+      "import { useRouter } from '#imports'",
       "const routeNameLocaleRE = /___([^_]+)$/",
       "const resolveName = (value) => {",
       "  if (typeof value === 'string') {",
@@ -319,6 +315,24 @@ const registerContentI18nTemplate = (addTemplateImpl, hasNuxtI18nModule) => {
       "  }",
       "  return undefined",
       "}",
+      "const normalizeRoutePath = (value) => value.startsWith('/') ? value : `/${value}`",
+      "const definedRecord = value => value && typeof value === 'object'",
+      "  ? Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined))",
+      "  : undefined",
+      "export const useLocalePath = () => {",
+      "  const router = useRouter()",
+      "  return (value) => {",
+      "    if (typeof value === 'string') return normalizeRoutePath(value)",
+      "    const name = resolveName(value)",
+      "    if (!name) return ''",
+      "    return router.resolve({",
+      "      name,",
+      "      ...(definedRecord(value.params) ? { params: definedRecord(value.params) } : {}),",
+      "      ...(definedRecord(value.query) ? { query: definedRecord(value.query) } : {}),",
+      "      ...(typeof value.hash === 'string' ? { hash: value.hash } : {})",
+      "    }).href",
+      "  }",
+      "}",
       "export const useRouteBaseName = () => (value) => {",
       "  const name = resolveName(value)",
       "  return typeof name === 'string' ? name.replace(routeNameLocaleRE, '') : undefined",
@@ -331,6 +345,7 @@ const registerContentI18nTemplate = (addTemplateImpl, hasNuxtI18nModule) => {
     filename: "content-i18n.d.mts",
     write: true,
     getContents: () => [
+      "export function useLocalePath(): (route: string | { name?: string, hash?: string, params?: Record<string, unknown>, query?: Record<string, unknown> }, locale?: string) => string",
       "export function useRouteBaseName(): (route: { name?: unknown } | unknown) => string | undefined",
       "export function useSetI18nParams(): (params: Record<string, unknown>) => void",
       "export function useSwitchLocalePath(): (locale: string) => string"
@@ -340,6 +355,7 @@ const registerContentI18nTemplate = (addTemplateImpl, hasNuxtI18nModule) => {
     filename: "types/content-i18n.d.ts",
     getContents: () => [
       "declare module '#build/content-i18n.mjs' {",
+      "  export function useLocalePath(): (route: string | { name?: string, hash?: string, params?: Record<string, unknown>, query?: Record<string, unknown> }, locale?: string) => string",
       "  export function useRouteBaseName(): (route: { name?: unknown } | unknown) => string | undefined",
       "  export function useSetI18nParams(): (params: Record<string, unknown>) => void",
       "  export function useSwitchLocalePath(): (locale: string) => string",
@@ -1314,11 +1330,6 @@ const collectRawMarkdownRoutesFromGeneratedFrontmatter = (markdown) => {
   return Array.from(links);
 };
 const publicOutputPath = (publicDir, route) => join(publicDir, normalizeStaticRoutePath(route).replace(/^\//, ""));
-const rawMarkdownIndexRouteForRawRoute = (route) => {
-  if (!route.startsWith("/raw/") || !route.endsWith(".md")) return null;
-  const pageRoute = route.replace(/^\/raw/, "").replace(/\.md$/, "");
-  return pageRoute === "/index" ? "/index.md" : `${pageRoute}/index.md`;
-};
 
 const hookNuxtBoundary$2 = (nuxt, name, callback) => {
   const hook = nuxt.hook;
@@ -1391,12 +1402,6 @@ const registerStaticOutputGeneration = ({
             const outputPath = publicOutputPath(publicDir, route);
             mkdirSync(dirname(outputPath), { recursive: true });
             writeFileSync(outputPath, body, "utf8");
-            const indexRoute = rawMarkdownIndexRouteForRawRoute(route);
-            if (indexRoute) {
-              const indexPath = publicOutputPath(publicDir, indexRoute);
-              mkdirSync(dirname(indexPath), { recursive: true });
-              writeFileSync(indexPath, body, "utf8");
-            }
           }
         }
       });
@@ -1499,8 +1504,7 @@ const registerContentNitroConfig = ({
         for (const route of routes) {
           const normalized = route === "/" ? "/" : `/${route.replace(/^\/+|\/+$/g, "")}`;
           nitroConfig.prerender.routes.push(
-            normalized === "/" ? "/raw/index.md" : `/raw${normalized}.md`,
-            normalized === "/" ? "/index.md" : `${normalized}/index.md`
+            normalized === "/" ? "/raw/index.md" : `/raw${normalized}.md`
           );
         }
       }
@@ -1574,6 +1578,7 @@ const contentModuleDefaults = {
   watch: true,
   sources: {},
   ignores: [],
+  links: {},
   collections: {},
   markdown: {
     plugins: [],
@@ -1678,6 +1683,7 @@ const applyContentRuntimeConfig = (nuxt, options, contentContext, runtimeCollect
     translatedSlugs: contentContext.translatedSlugs ?? false,
     strictTranslatedSlugs: contentContext.strictTranslatedSlugs ?? false,
     collections: runtimeCollections,
+    links: contentContext.links || {},
     integrity: buildIntegrity,
     experimental: {
       stripQueryParameters: options.experimental.stripQueryParameters
@@ -1806,6 +1812,7 @@ const module$1 = defineNuxtModule({
     const resolveRuntimeModule = (path) => resolve("./runtime", path);
     const runtimeInlineDependencies = ["comark", "@comark/vue"];
     validateRemovedMarkdownOptions(options);
+    nuxt.options.experimental.payloadExtraction ??= false;
     nuxt.options.build.transpile ||= [];
     for (const dependency of runtimeInlineDependencies) {
       if (!nuxt.options.build.transpile.includes(dependency)) {

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

@@ -4,7 +4,8 @@ import { useRuntimeConfig } from "#imports";
 import { useContentPreview } from "../../composables/preview";
 import { useUnwrap } from "../../composables/useUnwrap";
 import MarkdownRenderer from "./MarkdownRenderer.js";
-import { rewriteMarkdownRefLinks } from "../../../../integrations/vue/markdown-refs";
+import { useLocalePath } from "../../composables/content-i18n";
+import { resolveMarkdownRenderRefs, rewriteMarkdownRefLinks } from "../../../../core/references/resolve";
 import { loadContentComponentEntries } from "../../../../integrations/vue/content-components";
 import { resolveMarkdownRendererComponents } from "../../../markdown/plugins";
 import { isMarkdownRoot } from "../../../../core/markdown/tree";
@@ -39,14 +40,19 @@ const props = defineProps({
   }
 });
 const debug = import.meta.dev || useContentPreview().isEnabled();
-const runtimeContent = useRuntimeConfig().public.content;
+const runtimeContent = useRuntimeConfig().public?.content || {};
 const attrs = useAttrs();
 const { unwrap: unwrapRoot } = useUnwrap();
+const localePath = useLocalePath();
 const locale = computed(() => props.value.locale || props.value._resolvedLocale || props.value._locale);
+const linkLocale = computed(() => props.value._requestedLocale || locale.value);
 const defaultLocale = computed(() => props.value.defaultLocale || runtimeContent.defaultLocale);
 const locales = computed(() => {
   const variantLocales = Array.isArray(props.value.variants) ? props.value.variants.map((variant) => variant.locale).filter((locale2) => Boolean(locale2)) : [];
-  return variantLocales.length ? variantLocales : runtimeContent.locales || [];
+  return Array.from(/* @__PURE__ */ new Set([
+    ...runtimeContent.locales || [],
+    ...variantLocales
+  ]));
 });
 const body = computed(() => {
   let body2 = props.value.body || props.value;
@@ -56,7 +62,13 @@ const body = computed(() => {
   if (!isMarkdownRoot(body2)) {
     return null;
   }
-  return props.value._resolvedRefs ? rewriteMarkdownRefLinks(body2, props.value._resolvedRefs) : body2;
+  const resolvedRefs = resolveMarkdownRenderRefs(
+    body2,
+    props.value._resolvedRefs,
+    runtimeContent.links,
+    (route) => localePath(route, linkLocale.value)
+  );
+  return Object.keys(resolvedRefs).length ? rewriteMarkdownRefLinks(body2, resolvedRefs) : body2;
 });
 const renderedBody = computed(() => {
   if (!body.value) {
@@ -70,7 +82,7 @@ const resolvedComponents = computed(() => {
   }
   return {
     ...Object.fromEntries(loadContentComponentEntries(renderedBody.value, runtimeContent.markdown?.tags || {})),
-    ...resolveMarkdownRendererComponents(runtimeContent.markdown.plugins),
+    ...resolveMarkdownRendererComponents(runtimeContent.markdown?.plugins || []),
     ...props.components
   };
 });

package/dist/runtime/app/composables/content-i18n.js

@@ -1 +1 @@
-export { useRouteBaseName, useSetI18nParams, useSwitchLocalePath } from "#build/content-i18n.mjs";
+export { useLocalePath, useRouteBaseName, useSetI18nParams, useSwitchLocalePath } from "#build/content-i18n.mjs";

package/dist/runtime/server/agent-markdown.js

@@ -24,7 +24,7 @@ const routeMarkdownPathForHref = (href, locale, currentPath = "/") => {
   if (isExternalHref(withoutHash)) return href;
   if (withoutHash.endsWith(".md")) return href;
   const target = withoutHash.startsWith("/") ? prefixLocalizedHref(withoutHash, locale) : new URL(withoutHash, `https://agent.local${normalizeAgentRoutePath(currentPath)}`).pathname;
-  return `${agentMarkdownPathForRoute(target)}${hash}`;
+  return `${agentRawPathForRoute(target)}${hash}`;
 };
 export const getMarkdownProp = (node, name) => {
   const props = isRecord(node.props) ? node.props : {};

package/dist/runtime/server/agent-site.js

@@ -263,7 +263,6 @@ export const collectAgentMarkdownPrerenderRoutes = async (event) => {
     const pages = await buildAgentPageIndex(event, locale);
     for (const page of pages) {
       routes.add(page.rawPath);
-      routes.add(page.markdownPath);
     }
     const prefix = locale === defaultLocale() ? "" : `/${locale}`;
     routes.add(prefix ? `${prefix}/llms.txt` : "/llms.txt");

package/dist/runtime/server/middleware/agent-link-headers.js

@@ -1,6 +1,6 @@
 import { defineEventHandler, getRequestURL, setHeader } from "h3";
 import { getAgentLocales, localeFromAgentPath, resolveMarkdownForPublicRoute } from "../agent-site.js";
-import { agentMarkdownPathForRoute, agentRawPathForRoute, normalizeAgentRoutePath } from "../../agent-paths.js";
+import { agentRawPathForRoute, normalizeAgentRoutePath } from "../../agent-paths.js";
 import { appendResponseHeader } from "../agent-http.js";
 import { contentConfig } from "../storage-access.js";
 const shouldAdvertise = (pathname) => !pathname.startsWith("/_") && !pathname.startsWith("/api/") && !pathname.endsWith(".css") && !pathname.endsWith(".js") && !pathname.endsWith(".png") && !pathname.endsWith(".jpg") && !pathname.endsWith(".jpeg") && !pathname.endsWith(".webp") && !pathname.endsWith(".svg") && !pathname.endsWith(".ico");
@@ -26,8 +26,7 @@ export default defineEventHandler(async (event) => {
   const page = canAdvertisePageAlternate(pathname) ? await resolveMarkdownForPublicRoute(event, pathname, locale) : null;
   const pagePath = normalizeAgentRoutePath(pathname);
   const pageLinks = page ? [
-    `<${agentRawPathForRoute(pagePath)}>; rel="alternate"; type="text/markdown"`,
-    `<${agentMarkdownPathForRoute(pagePath)}>; rel="alternate"; type="text/markdown"`
+    `<${agentRawPathForRoute(pagePath)}>; rel="alternate"; type="text/markdown"`
   ] : [];
   appendResponseHeader(
     event,

package/dist/runtime/virtual.d.ts

@@ -1,4 +1,5 @@
 declare module '#build/content-i18n.mjs' {
+  export function useLocalePath(): (route: string | { name?: string, hash?: string, params?: Record<string, unknown>, query?: Record<string, unknown> }, locale?: string) => string
   export function useRouteBaseName(): (route: { name?: unknown } | unknown) => string | undefined
   export function useSetI18nParams(): (params: Record<string, unknown>) => void
   export function useSwitchLocalePath(): (locale: string) => string

package/dist/storage/references.js

@@ -1,12 +1,20 @@
 import { collectMarkdownRefLinks, parseRefLink } from "../core/references/resolve";
+import { projectContentPathToLocale } from "../features/localization/path";
 import { contentConfig } from "./driver.js";
-import { getContentManifest, resolveVariant } from "./manifest.js";
-const prefixLocaleRoute = (path, locale) => {
-  const defaultLocale = contentConfig().defaultLocale;
-  if (!locale || locale === defaultLocale) {
-    return path;
+import { resolveCanonicalKey, resolveVariant } from "./manifest.js";
+const isConfiguredQuickLink = (href) => {
+  const parsed = parseRefLink(href);
+  if (!parsed) {
+    return false;
   }
-  return path === "/" ? `/${locale}` : `/${locale}${path}`;
+  const separator = parsed.ref.indexOf(".");
+  if (separator <= 0 || separator === parsed.ref.length - 1) {
+    return false;
+  }
+  const namespace = parsed.ref.slice(0, separator);
+  const key = parsed.ref.slice(separator + 1);
+  const links = contentConfig().links;
+  return Boolean(links?.[namespace]?.[key]);
 };
 const resolveDocumentRefLinks = async (event, content, requestedLocale) => {
   if (!content || content._type !== "markdown" || !content.body) {
@@ -16,14 +24,16 @@ const resolveDocumentRefLinks = async (event, content, requestedLocale) => {
   if (!hrefs.length) {
     return void 0;
   }
-  const manifest = await getContentManifest(event);
   const entries = await Promise.all(hrefs.map(async (href) => {
     const parsed = parseRefLink(href);
     if (!parsed) {
       return null;
     }
-    const canonicalKey = manifest.byRef[parsed.ref];
+    const canonicalKey = await resolveCanonicalKey(event, parsed.ref);
     if (!canonicalKey) {
+      if (isConfiguredQuickLink(href)) {
+        return [href, href];
+      }
       if (import.meta.dev) {
         console.warn(`[content] Could not resolve markdown ref "${href}" in "${content._file || content._id}"`);
       }
@@ -39,7 +49,8 @@ const resolveDocumentRefLinks = async (event, content, requestedLocale) => {
     if (import.meta.dev && requestedLocale && variant.resolvedLocale && variant.resolvedLocale !== requestedLocale) {
       console.warn(`[content] Markdown ref "${href}" in "${content._file || content._id}" fell back from locale "${requestedLocale}" to "${variant.resolvedLocale}"`);
     }
-    return [href, `${prefixLocaleRoute(variant.path, variant.resolvedLocale)}${parsed.hash}`];
+    const routeLocale = variant.fallback && requestedLocale ? requestedLocale : variant.resolvedLocale;
+    return [href, `${projectContentPathToLocale(variant.path, routeLocale, contentConfig().defaultLocale)}${parsed.hash}`];
   }));
   const resolvedRefs = Object.fromEntries(entries.filter((entry) => Boolean(entry)));
   return Object.keys(resolvedRefs).length ? resolvedRefs : void 0;

package/dist/types/module.d.ts

@@ -264,6 +264,21 @@ export interface ContentRevalidateOptions {
      */
     allowUnsigned?: boolean;
 }
+export interface ContentLinkRouteTarget {
+    /**
+     * Nuxt route name passed to Nuxt I18n `localePath()`.
+     */
+    route: string;
+    /**
+     * Static route params forwarded to Nuxt I18n `localePath()`.
+     */
+    params?: Record<string, string | number>;
+    /**
+     * Static query params forwarded to Nuxt I18n `localePath()`.
+     */
+    query?: Record<string, string | number | boolean | undefined>;
+}
+export type ContentLinksOptions = Record<string, Record<string, ContentLinkRouteTarget>>;
 export interface ContentAgentRouteOptions {
     routes?: boolean;
     linkHeaders?: boolean;
@@ -313,6 +328,15 @@ export interface ModuleOptions {
      * `x-ginko-revalidate-token` or `authorization: Bearer <token>`.
      */
     revalidate?: false | ContentRevalidateOptions;
+    /**
+     * Writer-facing markdown quick links. Values point at Nuxt route names;
+     * localized paths stay owned by Nuxt I18n.
+     *
+     * @example
+     * content.links.main.pricing = { route: 'pricing' }
+     * markdown: [Pricing]($main.pricing)
+     */
+    links?: ContentLinksOptions;
     /**
      * First-class agent markdown and LLM route features.
      */

package/dist/types.d.mts

@@ -8,4 +8,4 @@ export { type agentMetadataFields, type defineAgentAppPage, type defineAgentMark
 
 export { default, type normalizeContentConfigCollectionNames } from './module.mjs'
 
-export { type AgentMetadataField, type AgentMetadataFieldList, type BacklinkFields, type BacklinkSource, type BacklinksOptions, type BacklinksResult, type CollectionQueryBuilder, type CollectionQueryField, type CollectionQueryFieldValue, type CollectionQueryKey, type CollectionQueryOperator, type CollectionQueryValue, type CollectionSchema, type ContentAgentAppPageConfig, type ContentAgentAppPageContext, type ContentAgentCollectionConfig, type ContentAgentConfig, type ContentAgentLocalizedValue, type ContentAgentMarkdownMetadataConfig, type ContentAgentMarkdownOptions, type ContentAgentMarkdownPolicyConfig, type ContentAgentRouteOptions, type ContentAgentSectionConfig, type ContentAgentSiteConfig, 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 ContentCollectionStringName, type ContentCollectionTarget, 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 LocalizedContentDocument, 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 ResolvedContentContext, 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 AgentMetadataField, type AgentMetadataFieldList, type BacklinkFields, type BacklinkSource, type BacklinksOptions, type BacklinksResult, type CollectionQueryBuilder, type CollectionQueryField, type CollectionQueryFieldValue, type CollectionQueryKey, type CollectionQueryOperator, type CollectionQueryValue, type CollectionSchema, type ContentAgentAppPageConfig, type ContentAgentAppPageContext, type ContentAgentCollectionConfig, type ContentAgentConfig, type ContentAgentLocalizedValue, type ContentAgentMarkdownMetadataConfig, type ContentAgentMarkdownOptions, type ContentAgentMarkdownPolicyConfig, type ContentAgentRouteOptions, type ContentAgentSectionConfig, type ContentAgentSiteConfig, 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 ContentCollectionStringName, type ContentCollectionTarget, type ContentConfig, type ContentContext, type ContentI18nOptions, type ContentLinkRouteTarget, type ContentLinksOptions, 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 LocalizedContentDocument, 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 ResolvedContentContext, 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.3",
+  "version": "0.1.5",
   "contributions": {
     "html": {
       "description-markup": "markdown",

package/package.json

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