@larkiny/astro-github-loader 0.13.0 → 0.14.1

package/dist/github.content.js

@@ -304,9 +304,11 @@ export async function toCollectionEntry({ context, octokit, options, signal, for
     let processedFiles = allFiles;
     if (options.linkTransform) {
         logger.verbose(`Applying link transformation to ${allFiles.length} files`);
+        // Resolve stripPrefixes with Starlight default
+        const stripPrefixes = options.linkTransform.stripPrefixes ?? ['src/content/docs'];
         // Generate automatic link mappings from pathMappings
         const autoGeneratedMappings = options.includes
-            ? generateAutoLinkMappings(options.includes, options.linkTransform.stripPrefixes)
+            ? generateAutoLinkMappings(options.includes, stripPrefixes)
             : [];
         // Combine auto-generated mappings with user-defined mappings
         const allLinkMappings = [
@@ -315,7 +317,7 @@ export async function toCollectionEntry({ context, octokit, options, signal, for
         ];
         logger.debug(`Generated ${autoGeneratedMappings.length} automatic link mappings from pathMappings`);
         processedFiles = globalLinkTransform(allFiles, {
-            stripPrefixes: options.linkTransform.stripPrefixes,
+            stripPrefixes,
             customHandlers: options.linkTransform.customHandlers,
             linkMappings: allLinkMappings,
             logger,

package/dist/github.types.d.ts

@@ -38,8 +38,8 @@ export interface LinkMapping {
  * Configuration for import link transformation
  */
 export interface ImportLinkTransformOptions {
-    /** Base paths to strip from final URLs (e.g., ["src/content/docs"]) */
-    stripPrefixes: string[];
+    /** Base paths to strip from final URLs. Defaults to ["src/content/docs"] (Starlight convention). */
+    stripPrefixes?: string[];
     /** Custom handlers for special link types */
     customHandlers?: LinkHandler[];
     /** Link mappings to transform URLs in markdown links */
@@ -234,6 +234,8 @@ export interface VersionConfig {
     slug: string;
     /** Display name for this version (e.g., "Latest", "v8.0.0") */
     label: string;
+    /** Git ref this version was sourced from (e.g., "main", "release/v7"). Optional metadata — not used by the loader. */
+    ref?: string;
 }
 /**
  * Represents configuration options for importing content from GitHub repositories.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@larkiny/astro-github-loader",
   "type": "module",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "description": "Load content from GitHub repositories into Astro content collections with asset management and content transformations",
   "keywords": [
     "astro",

package/src/github.content.ts

@@ -434,12 +434,12 @@ export async function toCollectionEntry({
   if (options.linkTransform) {
     logger.verbose(`Applying link transformation to ${allFiles.length} files`);
 
+    // Resolve stripPrefixes with Starlight default
+    const stripPrefixes = options.linkTransform.stripPrefixes ?? ['src/content/docs'];
+
     // Generate automatic link mappings from pathMappings
     const autoGeneratedMappings = options.includes
-      ? generateAutoLinkMappings(
-          options.includes,
-          options.linkTransform.stripPrefixes,
-        )
+      ? generateAutoLinkMappings(options.includes, stripPrefixes)
       : [];
 
     // Combine auto-generated mappings with user-defined mappings
@@ -453,7 +453,7 @@ export async function toCollectionEntry({
     );
 
     processedFiles = globalLinkTransform(allFiles, {
-      stripPrefixes: options.linkTransform.stripPrefixes,
+      stripPrefixes,
       customHandlers: options.linkTransform.customHandlers,
       linkMappings: allLinkMappings,
       logger,

package/src/github.types.ts

@@ -52,8 +52,8 @@ export interface LinkMapping {
  * Configuration for import link transformation
  */
 export interface ImportLinkTransformOptions {
-  /** Base paths to strip from final URLs (e.g., ["src/content/docs"]) */
-  stripPrefixes: string[];
+  /** Base paths to strip from final URLs. Defaults to ["src/content/docs"] (Starlight convention). */
+  stripPrefixes?: string[];
   /** Custom handlers for special link types */
   customHandlers?: LinkHandler[];
   /** Link mappings to transform URLs in markdown links */
@@ -261,6 +261,8 @@ export interface VersionConfig {
   slug: string;
   /** Display name for this version (e.g., "Latest", "v8.0.0") */
   label: string;
+  /** Git ref this version was sourced from (e.g., "main", "release/v7"). Optional metadata — not used by the loader. */
+  ref?: string;
 }
 
 /**