From 295ad8c8c29f4247c5068d766435cdc2bd3a5395 Mon Sep 17 00:00:00 2001
From: Larkin Young <larkin.young@algorand.foundation>
Date: Fri, 13 Feb 2026 12:33:41 +0000
Subject: [PATCH] Export LoaderContext type from public API

LoaderContext was marked @internal but is needed by downstream consumers
for the multi-loader pattern (context as LoaderContext). Promote it to
the public API and restore the cast in the Quick Start README example.
---
 packages/astro-github-loader/README.md           | 3 ++-
 packages/astro-github-loader/src/github.types.ts | 3 ++-
 packages/astro-github-loader/src/index.ts        | 1 +
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/packages/astro-github-loader/README.md b/packages/astro-github-loader/README.md
index a5d9c3f..a42815b 100644
--- a/packages/astro-github-loader/README.md
+++ b/packages/astro-github-loader/README.md
@@ -21,6 +21,7 @@ import {
   githubLoader,
   createOctokitFromEnv,
   type ImportOptions,
+  type LoaderContext,
 } from "@larkiny/astro-github-loader";
 
 const REMOTE_CONTENT: ImportOptions[] = [
@@ -54,7 +55,7 @@ export const collections = {
             configs: [config],
             clear: config.clear,
             dryRun: false, // Set to true for change detection only
-          }).load(context);
+          }).load(context as LoaderContext);
         }
       },
     },
diff --git a/packages/astro-github-loader/src/github.types.ts b/packages/astro-github-loader/src/github.types.ts
index 1665100..69f5a2e 100644
--- a/packages/astro-github-loader/src/github.types.ts
+++ b/packages/astro-github-loader/src/github.types.ts
@@ -343,7 +343,8 @@ export type FetchOptions = RequestInit & {
 };
 
 /**
- * @internal
+ * Astro loader context extended with optional entry type support.
+ * Use this type when calling `.load(context as LoaderContext)` in multi-loader patterns.
  */
 export interface LoaderContext extends AstroLoaderContext {
   /** @internal */
diff --git a/packages/astro-github-loader/src/index.ts b/packages/astro-github-loader/src/index.ts
index d05d3c3..f4f0878 100644
--- a/packages/astro-github-loader/src/index.ts
+++ b/packages/astro-github-loader/src/index.ts
@@ -14,6 +14,7 @@ export type {
   PathMappingValue,
   EnhancedPathMapping,
   VersionConfig,
+  LoaderContext,
 } from "./github.types.js";
 
 // Public API — types: transforms