@lupinum/ginko-content 1.0.0-beta.1 → 1.0.0-beta.2

package/README.md

@@ -15,7 +15,7 @@
 </p>
 
 > [!WARNING]
-> Version `1.0.0-beta.1` is a prerelease. Install it from npm's `next`
+> Version `1.0.0-beta.2` 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.1
+npx nuxi module add @lupinum/ginko-content@1.0.0-beta.2
 ```
 
 Or install and register the module by hand:
 
 ```bash
-pnpm add @lupinum/ginko-content@1.0.0-beta.1
+pnpm add @lupinum/ginko-content@1.0.0-beta.2
 ```
 
 ```ts

package/dist/features/agent/agent-markdown.d.ts

@@ -20,6 +20,7 @@ export interface AgentMarkdown {
     description: string;
     markdown: string;
     sourceFile?: string;
+    order?: number;
     canonicalUrl: string;
     lastModified?: string;
     publicSignals?: AgentMarkdownPublicSignals;

package/dist/features/agent/walker.js

@@ -21,6 +21,12 @@ const renderChildren = (node, ctx) => (node.children || []).map((child) => rende
 const block = (value) => value.trim() ? `${value.trim()}
 
 ` : "";
+const codeFenceInfo = (node) => {
+  const language = typeof node.props?.language === "string" ? node.props.language.replace(/[\r\n]/g, " ").trim() : "";
+  const filename = typeof node.props?.filename === "string" ? node.props.filename.replace(/[\r\n]/g, " ").trim() : "";
+  const escapedFilename = filename.replace(/\\/g, "\\\\").replace(/\]/g, "\\]");
+  return `${language}${escapedFilename ? ` [${escapedFilename}]` : ""}`;
+};
 const renderList = (node, ctx, ordered = false) => block((node.children || []).map((child, index) => {
   const [first, ...rest] = child.children || [];
   let task = "";
@@ -136,7 +142,7 @@ const renderNode = (node, ctx) => {
     case "code":
       return `\`${node.value || textValue(node)}\``;
     case "pre":
-      return block(`\`\`\`
+      return block(`\`\`\`${codeFenceInfo(node)}
 ${textValue(node)}
 \`\`\``);
     case "a": {

package/dist/module.json

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

package/dist/module.mjs

@@ -33,7 +33,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.1";
+const version = "1.0.0-beta.2";
 const peerDependencies = {
 	nuxt: ">=4.5.1 <5"};
 

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

@@ -26,7 +26,7 @@ const configuredLocales = () => {
 };
 const isRecord = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
 const requireAgentSourceDocument = (value) => {
-  if (!isRecord(value) || typeof value.id !== "string" || typeof value.locale !== "string" || !isRecord(value.route) || typeof value.route.resolvedPath !== "string" || !isRecord(value.resolution) || !isRecord(value.resolution.resolved) || typeof value.resolution.resolved.locale !== "string" || value.title !== void 0 && typeof value.title !== "string" || value.description !== void 0 && typeof value.description !== "string" || value.updated !== void 0 && typeof value.updated !== "string" || value.draft !== void 0 && typeof value.draft !== "boolean" || value.partial !== void 0 && typeof value.partial !== "boolean" || value.navigationFile !== void 0 && typeof value.navigationFile !== "boolean") {
+  if (!isRecord(value) || typeof value.id !== "string" || typeof value.locale !== "string" || !isRecord(value.route) || typeof value.route.resolvedPath !== "string" || !isRecord(value.resolution) || !isRecord(value.resolution.resolved) || typeof value.resolution.resolved.locale !== "string" || value.title !== void 0 && typeof value.title !== "string" || value.description !== void 0 && typeof value.description !== "string" || value.updated !== void 0 && typeof value.updated !== "string" || value.draft !== void 0 && typeof value.draft !== "boolean" || value.partial !== void 0 && typeof value.partial !== "boolean" || value.navigationFile !== void 0 && typeof value.navigationFile !== "boolean" || value.order !== void 0 && typeof value.order !== "number") {
     throw new Error(
       "Agent markdown requires the canonical localized document envelope (`route.resolvedPath` and `resolution.resolved.locale`)."
     );
@@ -87,6 +87,7 @@ const toAgentMarkdown = (collection, page, options) => {
     description,
     markdown: renderAgentMarkdown(page, collection, path, locale, options),
     ...page.file?.path ? { sourceFile: page.file?.path } : {},
+    ...page.order !== void 0 ? { order: page.order } : {},
     canonicalUrl: path,
     ...page.updated ? { lastModified: page.updated } : {},
     metadataFields: options.metadata,
@@ -133,6 +134,7 @@ export async function queryMarkdownEnabledContent(event, options = {}) {
         "description",
         "updated",
         "navigation",
+        "order",
         "robots",
         "sitemap"
       ],
@@ -155,6 +157,7 @@ export async function queryMarkdownEnabledContent(event, options = {}) {
         title,
         description,
         ...row.file?.path ? { sourceFile: row.file?.path } : {},
+        ...row.order !== void 0 ? { order: row.order } : {},
         canonicalUrl: path,
         ...row.updated ? { lastModified: row.updated } : {},
         metadataFields: agentOptions.metadata,

package/dist/runtime/server/agent-site.d.ts

@@ -16,6 +16,8 @@ export interface AgentPage {
     locale: string;
     source: AgentPageSource;
     collection?: string;
+    sourceFile?: string;
+    order?: number;
     updated?: string;
     metadataFields?: readonly AgentMetadataField[];
     includeInIndex: boolean;

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

@@ -88,6 +88,8 @@ const createGinkoAgentPage = (meta, locale, siteUrl) => {
     locale: meta.locale || locale,
     source: "ginko",
     collection: meta.collection,
+    sourceFile: meta.sourceFile,
+    order: meta.order,
     updated: meta.lastModified,
     metadataFields: meta.metadataFields,
     includeInIndex: meta.includeInIndex,
@@ -125,9 +127,18 @@ const createAppOwnedAgentPages = async (locale, siteUrl) => {
   }
   return result;
 };
+const sourcePathCollator = new Intl.Collator("en", { numeric: true, sensitivity: "base" });
 const sortPages = (pages) => pages.sort((a, b) => {
   const sectionDelta = a.sectionOrder - b.sectionOrder;
   if (sectionDelta) return sectionDelta;
+  if (a.sourceFile && b.sourceFile) {
+    const sourceDelta = sourcePathCollator.compare(a.sourceFile, b.sourceFile);
+    if (sourceDelta) return sourceDelta;
+  }
+  if (a.order !== void 0 && b.order !== void 0) {
+    const orderDelta = a.order - b.order;
+    if (orderDelta) return orderDelta;
+  }
   return a.path.localeCompare(b.path);
 });
 const assertUniqueAgentPages = (pages) => {

package/dist/web-types.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lupinum/ginko-content",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "description": "Collection-first content engine for Nuxt",
   "homepage": "https://ginko-content.lupinum.com",
   "bugs": {