@hyperframes/core 0.8.193 → 0.8.194

package/dist/gsapCdn.d.ts

@@ -1,3 +1,6 @@
-export declare function gsapCdnDist(gsapVersion?: string): string;
+export declare const GSAP_BASE_URL_META = "hyperframes-gsap-base-url";
+/** An npm-style mirror root; callers choose configuration without coupling this helper to a host. */
+export declare function normalizeGsapBaseUrl(baseUrl?: string): string;
+export declare function gsapCdnDist(gsapVersion?: string, baseUrl?: string): string;
 /** MotionPathPlugin at the composition's own gsap version; a skew registers with a GSAP warning. */
-export declare function motionPathPluginUrl(gsapVersion?: string): string;
+export declare function motionPathPluginUrl(gsapVersion?: string, baseUrl?: string): string;

package/dist/gsapCdn.js

@@ -1,9 +1,25 @@
 const GSAP_CDN_VERSION = "3.15.0";
-export function gsapCdnDist(gsapVersion) {
+const GSAP_CDN_BASE_URL = "https://cdn.jsdelivr.net/npm";
+export const GSAP_BASE_URL_META = "hyperframes-gsap-base-url";
+/** An npm-style mirror root; callers choose configuration without coupling this helper to a host. */
+export function normalizeGsapBaseUrl(baseUrl) {
+    const value = baseUrl?.trim();
+    if (!value)
+        return GSAP_CDN_BASE_URL;
+    if (!/^https?:\/\//i.test(value) || !URL.canParse(value) || /[?#]/.test(value)) {
+        throw new Error("GSAP base URL must be an absolute HTTP(S) URL without a query or fragment");
+    }
+    const url = new URL(value);
+    if (url.username || url.password) {
+        throw new Error("GSAP base URL must not contain credentials");
+    }
+    return url.href.replace(/\/+$/, "");
+}
+export function gsapCdnDist(gsapVersion, baseUrl) {
     const version = gsapVersion && /^\d+(\.\d+)*$/.test(gsapVersion) ? gsapVersion : GSAP_CDN_VERSION;
-    return `https://cdn.jsdelivr.net/npm/gsap@${version}/dist/`;
+    return `${normalizeGsapBaseUrl(baseUrl)}/gsap@${version}/dist/`;
 }
 /** MotionPathPlugin at the composition's own gsap version; a skew registers with a GSAP warning. */
-export function motionPathPluginUrl(gsapVersion) {
-    return `${gsapCdnDist(gsapVersion)}MotionPathPlugin.min.js`;
+export function motionPathPluginUrl(gsapVersion, baseUrl) {
+    return `${gsapCdnDist(gsapVersion, baseUrl)}MotionPathPlugin.min.js`;
 }