From 27d4724ba25197862fcf398c42ab65d033aa30e0 Mon Sep 17 00:00:00 2001
From: Jerry_Wu <409187100@qq.com>
Date: Tue, 9 Dec 2025 15:24:08 +0800
Subject: [PATCH] feat: introduce QRLInternal type and update related exports

---
 .changeset/spicy-rings-check.md                | 5 +++++
 packages/qwik/src/core/internal.ts             | 1 +
 packages/qwik/src/core/qwik.core.api.md        | 5 +++++
 packages/qwik/src/core/shared/qrl/qrl-class.ts | 1 +
 4 files changed, 12 insertions(+)
 create mode 100644 .changeset/spicy-rings-check.md

diff --git a/.changeset/spicy-rings-check.md b/.changeset/spicy-rings-check.md
new file mode 100644
index 00000000000..08547ec703c
--- /dev/null
+++ b/.changeset/spicy-rings-check.md
@@ -0,0 +1,5 @@
+---
+'@qwik.dev/core': patch
+---
+
+FEAT: Introduced the QRLInternal type
diff --git a/packages/qwik/src/core/internal.ts b/packages/qwik/src/core/internal.ts
index 317dff3543d..e81cdd524e6 100644
--- a/packages/qwik/src/core/internal.ts
+++ b/packages/qwik/src/core/internal.ts
@@ -1,4 +1,5 @@
 export { _noopQrl, _noopQrlDEV, _regSymbol } from './shared/qrl/qrl';
+export type { QRLInternal as _QRLInternal } from './shared/qrl/qrl-class';
 // ^ keep this above to avoid circular dependency issues
 
 export {
diff --git a/packages/qwik/src/core/qwik.core.api.md b/packages/qwik/src/core/qwik.core.api.md
index 536b668d225..ae59d987838 100644
--- a/packages/qwik/src/core/qwik.core.api.md
+++ b/packages/qwik/src/core/qwik.core.api.md
@@ -664,6 +664,11 @@ export const qrlDEV: <T = any>(chunkOrFn: string | (() => Promise<any>), symbol:
 // @public
 export type QRLEventHandlerMulti<EV extends Event, EL> = QRL<EventHandler<EV, EL>> | undefined | null | QRLEventHandlerMulti<EV, EL>[];
 
+// Warning: (ae-forgotten-export) The symbol "QRLInternalMethods" needs to be exported by the entry point index.d.ts
+//
+// @internal (undocumented)
+export type _QRLInternal<TYPE = unknown> = QRL<TYPE> & QRLInternalMethods<TYPE>;
+
 // @internal
 export const _qrlSync: <TYPE extends Function>(fn: TYPE, serializedFn?: string) => SyncQRL<TYPE>;
 
diff --git a/packages/qwik/src/core/shared/qrl/qrl-class.ts b/packages/qwik/src/core/shared/qrl/qrl-class.ts
index 1e8a91ac3f6..2e474d78e85 100644
--- a/packages/qwik/src/core/shared/qrl/qrl-class.ts
+++ b/packages/qwik/src/core/shared/qrl/qrl-class.ts
@@ -56,6 +56,7 @@ export type QRLInternalMethods<TYPE> = {
   $setContainer$(containerEl: Element | undefined): Element | undefined;
 };
 
+/** @internal */
 export type QRLInternal<TYPE = unknown> = QRL<TYPE> & QRLInternalMethods<TYPE>;
 
 const resolvedSymbol = Symbol('resolved');