sticky-scroll-trigger 0.7.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/*!
|
|
2
2
|
* @license
|
|
3
|
-
* StickyScrollTrigger v0.
|
|
3
|
+
* StickyScrollTrigger v0.9.0
|
|
4
4
|
* Copyright (c) 2026 Kuninori Ogino
|
|
5
5
|
* Released under the MIT License
|
|
6
6
|
* https://github.com/kuninori-ogino/sticky-scroll-trigger
|
|
@@ -51,6 +51,15 @@ const measureDocumentMaxScroll = (viewportHeight) => {
|
|
|
51
51
|
const doc = document.documentElement;
|
|
52
52
|
return Math.max(0, (doc.scrollHeight || document.body.scrollHeight) - viewportHeight);
|
|
53
53
|
};
|
|
54
|
+
const measureBorderWidth = (borderStyle, width) => borderStyle === "none" || borderStyle === "hidden" ? 0 : parseFloat(width);
|
|
55
|
+
const measureUsedHeight = (el) => {
|
|
56
|
+
const rounded = el.offsetHeight;
|
|
57
|
+
const style = getComputedStyle(el);
|
|
58
|
+
const height = parseFloat(style.height);
|
|
59
|
+
if (!Number.isFinite(height)) return rounded;
|
|
60
|
+
const measured = style.boxSizing === "border-box" ? height : height + parseFloat(style.paddingTop) + parseFloat(style.paddingBottom) + measureBorderWidth(style.borderTopStyle, style.borderTopWidth) + measureBorderWidth(style.borderBottomStyle, style.borderBottomWidth);
|
|
61
|
+
return rounded > 0 && Math.abs(measured - rounded) >= 1 ? rounded : measured;
|
|
62
|
+
};
|
|
54
63
|
const compareDocumentOrder = (a, b) => {
|
|
55
64
|
const position = a.compareDocumentPosition(b);
|
|
56
65
|
if (position & Node.DOCUMENT_POSITION_FOLLOWING) return -1;
|
|
@@ -112,7 +121,6 @@ const wrapPin = (trigger) => {
|
|
|
112
121
|
if (!trigger.parentNode) throw new Error(`createStickyPin: trigger ${describeElement(trigger)} is not attached to the document`);
|
|
113
122
|
const outer = document.createElement("div");
|
|
114
123
|
const inner = document.createElement("div");
|
|
115
|
-
outer.style.height = "0";
|
|
116
124
|
outer.style.contain = "layout";
|
|
117
125
|
trigger.parentNode.insertBefore(outer, trigger);
|
|
118
126
|
outer.appendChild(inner);
|
|
@@ -190,8 +198,9 @@ const buildStylesheet = (instanceId, scenes) => {
|
|
|
190
198
|
declarations.push(`@supports (animation-timeline: scroll()) {[data-${instanceId}]{animation:${animations.join(",")};animation-timeline:${timelines.join(",")};animation-range:${ranges.join(",")}}}`);
|
|
191
199
|
return declarations.join("");
|
|
192
200
|
};
|
|
193
|
-
const createScrollMarginSync = (rootElement) => {
|
|
201
|
+
const createScrollMarginSync = (rootElement, targetSelector) => {
|
|
194
202
|
const instanceId = `sst${nextInstanceSuffix++}`;
|
|
203
|
+
const usesJsRamp = !usesCssRamp && targetSelector !== null;
|
|
195
204
|
const snapshots = new WeakMap();
|
|
196
205
|
let written = new Set();
|
|
197
206
|
let sheet = null;
|
|
@@ -206,7 +215,7 @@ const createScrollMarginSync = (rootElement) => {
|
|
|
206
215
|
jsHost.style.setProperty(`--${instanceId}-c${index}`, `${consumed}px`);
|
|
207
216
|
});
|
|
208
217
|
};
|
|
209
|
-
if (
|
|
218
|
+
if (usesJsRamp) window.addEventListener("scroll", applyJsRamp, { passive: true });
|
|
210
219
|
const restoreTarget = (target) => {
|
|
211
220
|
const snapshot = snapshots.get(target);
|
|
212
221
|
target.style.scrollMarginTop = snapshot ? snapshot.inline : "";
|
|
@@ -222,7 +231,7 @@ const createScrollMarginSync = (rootElement) => {
|
|
|
222
231
|
jsHost = null;
|
|
223
232
|
};
|
|
224
233
|
return {
|
|
225
|
-
sync(scenes, host
|
|
234
|
+
sync(scenes, host) {
|
|
226
235
|
const ramps = scenes.filter((scene) => scene.freezeEnd > scene.freezeStart);
|
|
227
236
|
if (targetSelector === null || !ramps.length || !host) {
|
|
228
237
|
written.forEach(restoreTarget);
|
|
@@ -235,7 +244,7 @@ const createScrollMarginSync = (rootElement) => {
|
|
|
235
244
|
animationHost = host;
|
|
236
245
|
animationHost.setAttribute(`data-${instanceId}`, "");
|
|
237
246
|
}
|
|
238
|
-
if (
|
|
247
|
+
if (usesJsRamp) {
|
|
239
248
|
jsRamps = ramps;
|
|
240
249
|
jsHost = host;
|
|
241
250
|
applyJsRamp();
|
|
@@ -269,7 +278,7 @@ const createScrollMarginSync = (rootElement) => {
|
|
|
269
278
|
written = next;
|
|
270
279
|
},
|
|
271
280
|
restore() {
|
|
272
|
-
if (
|
|
281
|
+
if (usesJsRamp) window.removeEventListener("scroll", applyJsRamp);
|
|
273
282
|
written.forEach(restoreTarget);
|
|
274
283
|
written = new Set();
|
|
275
284
|
clearAnimation();
|
|
@@ -326,7 +335,7 @@ const signedPx = (sign, value, unit, refSize) => {
|
|
|
326
335
|
const magnitude = unit === "%" ? parseFloat(value) / 100 * refSize : parseFloat(value);
|
|
327
336
|
return sign?.startsWith("-") ? -magnitude : magnitude;
|
|
328
337
|
};
|
|
329
|
-
const CLAUSE_TOKEN_RE = /^(top|center|bottom|(?:\d+(?:\.\d*)?|\.\d+))?(%|px)?(?:([+-]=?)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/;
|
|
338
|
+
const CLAUSE_TOKEN_RE = /^(top|center|bottom|[+-]?(?:\d+(?:\.\d*)?|\.\d+))?(%|px)?(?:([+-]=?)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/;
|
|
330
339
|
const parseClauseToken = (token, refSize) => {
|
|
331
340
|
const match = CLAUSE_TOKEN_RE.exec(token);
|
|
332
341
|
if (!match || !match[1] && !match[3]) {
|
|
@@ -351,12 +360,14 @@ const isAbsoluteFormat = (resolved) => {
|
|
|
351
360
|
};
|
|
352
361
|
const resolveAbsolute = (resolved) => typeof resolved === "number" ? resolved : Number(resolved);
|
|
353
362
|
const CLAMP_PREFIX = "clamp(";
|
|
363
|
+
const assertNotClamped = (trimmed) => {
|
|
364
|
+
if (!trimmed.startsWith(CLAMP_PREFIX)) return;
|
|
365
|
+
const inner = trimmed.slice(6).replace(/\)$/, "").trim();
|
|
366
|
+
throw new Error(`StickyScrollTrigger: unsupported position clause "${trimmed}": GSAP's clamp() wrapper isn't supported here.` + (inner ? ` Did you mean "${inner}"?` : ""));
|
|
367
|
+
};
|
|
354
368
|
const resolveAnchorTop = (position, elementHeight, viewportHeight) => {
|
|
355
369
|
const trimmed = position.trim();
|
|
356
|
-
|
|
357
|
-
const inner = trimmed.slice(6).replace(/\)$/, "").trim();
|
|
358
|
-
throw new Error(`StickyScrollTrigger: unsupported position clause "${trimmed}": GSAP's clamp() wrapper isn't supported here.` + (inner ? ` Did you mean "${inner}"?` : ""));
|
|
359
|
-
}
|
|
370
|
+
assertNotClamped(trimmed);
|
|
360
371
|
const [elementToken, viewportToken = "top"] = trimmed.split(/\s+/);
|
|
361
372
|
const elementClause = parseClauseToken(elementToken, elementHeight);
|
|
362
373
|
const viewportClause = parseClauseToken(viewportToken, viewportHeight);
|
|
@@ -364,6 +375,25 @@ const resolveAnchorTop = (position, elementHeight, viewportHeight) => {
|
|
|
364
375
|
};
|
|
365
376
|
const DWELL_RELATIVE_RE = /^\+=(\d+(?:\.\d*)?|\.\d+)(%|px)?$/;
|
|
366
377
|
const isDwellFormat = (resolved) => typeof resolved === "string" && DWELL_RELATIVE_RE.test(resolved.trim());
|
|
378
|
+
const prefixSpacedRelativeEnd = (start, endResolved) => {
|
|
379
|
+
if (typeof endResolved !== "string") return endResolved;
|
|
380
|
+
const trimmedEnd = endResolved.trim();
|
|
381
|
+
if (!trimmedEnd.startsWith("+=") || !/\s/.test(trimmedEnd)) return endResolved;
|
|
382
|
+
const startResolved = resolveMaybeFn(start);
|
|
383
|
+
if (typeof startResolved !== "string") return endResolved;
|
|
384
|
+
const trimmedStart = startResolved.trim();
|
|
385
|
+
assertNotClamped(trimmedStart);
|
|
386
|
+
const [elementToken] = trimmedStart.split(/\s+/);
|
|
387
|
+
try {
|
|
388
|
+
parseClauseToken(elementToken, 0);
|
|
389
|
+
} catch (error) {
|
|
390
|
+
if (!isAbsoluteFormat(startResolved)) throw error;
|
|
391
|
+
return endResolved;
|
|
392
|
+
}
|
|
393
|
+
parseClauseToken(trimmedEnd.split(/\s+/)[0], 0);
|
|
394
|
+
if (elementToken.includes("=")) throw new Error(`StickyScrollTrigger: end "${endResolved}" can't be resolved against start "${startResolved}": GSAP reads an end that starts with '+=' and holds a space by prefixing it with the start clause's element token, and "${elementToken}" carries an offset of its own, which GSAP resolves by discarding the end's. Give end a complete position clause instead, such as 'top+=100 bottom'.`);
|
|
395
|
+
return elementToken + trimmedEnd;
|
|
396
|
+
};
|
|
367
397
|
const resolveDwell = (resolved, viewportHeight) => {
|
|
368
398
|
const match = DWELL_RELATIVE_RE.exec(String(resolved).trim());
|
|
369
399
|
if (!match) throw new Error(`StickyScrollTrigger: unsupported end format "${resolved}"`);
|
|
@@ -378,6 +408,28 @@ const resolveMaxOffset = (resolved, viewportHeight) => {
|
|
|
378
408
|
const [, sign, value, unit] = match;
|
|
379
409
|
return sign ? signedPx(sign, value, unit, viewportHeight) : 0;
|
|
380
410
|
};
|
|
411
|
+
const classifyPosition = (resolved) => {
|
|
412
|
+
if (typeof resolved === "number") return {
|
|
413
|
+
kind: "absolute",
|
|
414
|
+
value: resolved
|
|
415
|
+
};
|
|
416
|
+
if (isDwellFormat(resolved)) return {
|
|
417
|
+
kind: "dwell",
|
|
418
|
+
value: resolved
|
|
419
|
+
};
|
|
420
|
+
if (isMaxFormat(resolved)) return {
|
|
421
|
+
kind: "max",
|
|
422
|
+
value: resolved
|
|
423
|
+
};
|
|
424
|
+
if (isAbsoluteFormat(resolved)) return {
|
|
425
|
+
kind: "absolute",
|
|
426
|
+
value: resolveAbsolute(resolved)
|
|
427
|
+
};
|
|
428
|
+
return {
|
|
429
|
+
kind: "clause",
|
|
430
|
+
value: resolved
|
|
431
|
+
};
|
|
432
|
+
};
|
|
381
433
|
const gapsBeforeRawPosition = (measurements, paddingHeightsSoFar, previous, rawPosition, ownIndex) => {
|
|
382
434
|
let total = 0;
|
|
383
435
|
measurements.forEach((measurement, i) => {
|
|
@@ -479,65 +531,59 @@ const planLayers = (measurements, deps) => {
|
|
|
479
531
|
plans.forEach((plan, index) => deps.onPlanned(index, plan));
|
|
480
532
|
return plans;
|
|
481
533
|
};
|
|
482
|
-
const EXCLUDED_VAR_KEYS = [
|
|
483
|
-
"trigger",
|
|
484
|
-
"start",
|
|
485
|
-
"end",
|
|
486
|
-
"endTrigger",
|
|
487
|
-
"pin",
|
|
488
|
-
"pinSpacing",
|
|
489
|
-
"anticipatePin",
|
|
490
|
-
"pinnedContainer",
|
|
491
|
-
"pinReparent",
|
|
492
|
-
"pinSpacer",
|
|
493
|
-
"pinType",
|
|
494
|
-
"horizontal",
|
|
495
|
-
"scroller",
|
|
496
|
-
"containerAnimation"
|
|
497
|
-
];
|
|
498
534
|
const resolveEndSpec = (rootElement, viewportHeight, layer, endResolved, ownIndex, endTriggerIndex) => {
|
|
499
535
|
if (endResolved === null) return { mode: "auto" };
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
if (layer.kind !== "cover") throw new Error(`StickyScrollTrigger: createStickyTrigger's trigger ${describeElement(layer.trigger)} has end "${endResolved}". GSAP's 'max' keyword isn't supported here: the layer's own dwell padding adds to the document's max scroll position, so the freeze window would depend on itself. Use createOverlapScroll, which adds no padding, or a dwell distance such as '+=500'.`);
|
|
510
|
-
return {
|
|
511
|
-
mode: "max",
|
|
512
|
-
offsetPx: resolveMaxOffset(endResolved, viewportHeight)
|
|
536
|
+
const classified = classifyPosition(endResolved);
|
|
537
|
+
switch (classified.kind) {
|
|
538
|
+
case "dwell": return {
|
|
539
|
+
mode: "dwell",
|
|
540
|
+
distancePx: Math.max(0, resolveDwell(classified.value, viewportHeight))
|
|
541
|
+
};
|
|
542
|
+
case "absolute": return {
|
|
543
|
+
mode: "absolute",
|
|
544
|
+
value: classified.value
|
|
513
545
|
};
|
|
546
|
+
case "max":
|
|
547
|
+
if (layer.kind !== "cover") throw new Error(`StickyScrollTrigger: createStickyTrigger's trigger ${describeElement(layer.trigger)} has end "${endResolved}". GSAP's 'max' keyword isn't supported here: the layer's own dwell padding adds to the document's max scroll position, so the freeze window would depend on itself. Use createOverlapScroll, which adds no padding, or a dwell distance such as '+=500'.`);
|
|
548
|
+
return {
|
|
549
|
+
mode: "max",
|
|
550
|
+
offsetPx: resolveMaxOffset(classified.value, viewportHeight)
|
|
551
|
+
};
|
|
552
|
+
case "clause": {
|
|
553
|
+
if (layer.kind !== "cover" && endTriggerIndex !== null && endTriggerIndex > ownIndex) throw new Error(`StickyScrollTrigger: createStickyTrigger's trigger ${describeElement(layer.trigger)}'s endTrigger (${describeElement(layer.endTrigger)}) refers to a layer positioned later in DOM order, which isn't supported: this layer's own dwell padding pushes that one down, so the freeze window would depend on its own dwell. Point endTrigger at a layer earlier in DOM order, or use a dwell distance such as '+=500'.`);
|
|
554
|
+
const unregistered = endTriggerIndex === null;
|
|
555
|
+
const insideRoot = rootElement.contains(layer.endTrigger);
|
|
556
|
+
if (unregistered && !insideRoot && layer.kind !== "cover") throw new Error(`StickyScrollTrigger: createStickyTrigger's trigger ${describeElement(layer.trigger)} has an endTrigger (${describeElement(layer.endTrigger)}) outside the shared container: the layer's own dwell keeps pushing it away, so the freeze window never settles. Point endTrigger at an element inside the container, or use a dwell distance such as '+=500'.`);
|
|
557
|
+
return {
|
|
558
|
+
mode: "clause",
|
|
559
|
+
clause: classified.value,
|
|
560
|
+
rawTop: unregistered && insideRoot ? documentTop(layer.endTrigger) : null,
|
|
561
|
+
measureLive: unregistered && !insideRoot
|
|
562
|
+
};
|
|
563
|
+
}
|
|
514
564
|
}
|
|
515
|
-
if (layer.kind !== "cover" && endTriggerIndex !== null && endTriggerIndex > ownIndex) throw new Error(`StickyScrollTrigger: createStickyTrigger's trigger ${describeElement(layer.trigger)}'s endTrigger (${describeElement(layer.endTrigger)}) refers to a layer positioned later in DOM order, which isn't supported: this layer's own dwell padding pushes that one down, so the freeze window would depend on its own dwell. Point endTrigger at a layer earlier in DOM order, or use a dwell distance such as '+=500'.`);
|
|
516
|
-
const unregistered = endTriggerIndex === null;
|
|
517
|
-
const insideRoot = rootElement.contains(layer.endTrigger);
|
|
518
|
-
if (unregistered && !insideRoot && layer.kind !== "cover") throw new Error(`StickyScrollTrigger: createStickyTrigger's trigger ${describeElement(layer.trigger)} has an endTrigger (${describeElement(layer.endTrigger)}) outside the shared container: the layer's own dwell keeps pushing it away, so the freeze window never settles. Point endTrigger at an element inside the container, or use a dwell distance such as '+=500'.`);
|
|
519
|
-
return {
|
|
520
|
-
mode: "clause",
|
|
521
|
-
clause: endResolved,
|
|
522
|
-
rawTop: unregistered && insideRoot ? documentTop(layer.endTrigger) : null,
|
|
523
|
-
measureLive: unregistered && !insideRoot
|
|
524
|
-
};
|
|
525
565
|
};
|
|
526
566
|
const resolveStartSpec = (layer, startResolved, elementHeight, viewportHeight) => {
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
567
|
+
const classified = classifyPosition(startResolved);
|
|
568
|
+
switch (classified.kind) {
|
|
569
|
+
case "absolute":
|
|
570
|
+
if (layer.kind === "cover") throw new Error(`StickyScrollTrigger: createOverlapScroll's trigger ${describeElement(layer.trigger)} has start "${startResolved}", an absolute scroll position (GSAP reads any bare number this way). That isn't supported here: a cover layer's sticky position is computed relative to its own wrapper, so start must be a position clause such as 'bottom bottom'.`);
|
|
571
|
+
return {
|
|
572
|
+
mode: "absolute",
|
|
573
|
+
value: classified.value
|
|
574
|
+
};
|
|
575
|
+
case "max":
|
|
576
|
+
case "dwell":
|
|
577
|
+
case "clause": return {
|
|
578
|
+
mode: "clause",
|
|
579
|
+
anchorOffset: resolveAnchorTop(classified.value, elementHeight, viewportHeight)
|
|
580
|
+
};
|
|
581
|
+
}
|
|
536
582
|
};
|
|
537
583
|
const measureLayer = (rootElement, viewportHeight, layer, ownIndex, indexByTrigger) => {
|
|
538
584
|
const startResolved = resolveMaybeFn(layer.start);
|
|
539
|
-
const endResolved = layer.end === null ? null : resolveMaybeFn(layer.end);
|
|
540
|
-
const elementHeight = layer.trigger
|
|
585
|
+
const endResolved = layer.end === null ? null : prefixSpacedRelativeEnd(startResolved, resolveMaybeFn(layer.end));
|
|
586
|
+
const elementHeight = measureUsedHeight(layer.trigger);
|
|
541
587
|
const endTriggerIsSelf = layer.endTrigger === layer.trigger;
|
|
542
588
|
const endTriggerIndex = indexByTrigger.get(layer.endTrigger) ?? null;
|
|
543
589
|
const end = resolveEndSpec(rootElement, viewportHeight, layer, endResolved, ownIndex, endTriggerIndex);
|
|
@@ -551,9 +597,25 @@ const measureLayer = (rootElement, viewportHeight, layer, ownIndex, indexByTrigg
|
|
|
551
597
|
end,
|
|
552
598
|
endTriggerIsSelf,
|
|
553
599
|
endTriggerIndex,
|
|
554
|
-
endTriggerHeight: end.mode === "clause" ? layer.endTrigger
|
|
600
|
+
endTriggerHeight: end.mode === "clause" ? measureUsedHeight(layer.endTrigger) : 0
|
|
555
601
|
};
|
|
556
602
|
};
|
|
603
|
+
const EXCLUDED_VAR_KEYS = [
|
|
604
|
+
"trigger",
|
|
605
|
+
"start",
|
|
606
|
+
"end",
|
|
607
|
+
"endTrigger",
|
|
608
|
+
"pin",
|
|
609
|
+
"pinSpacing",
|
|
610
|
+
"anticipatePin",
|
|
611
|
+
"pinnedContainer",
|
|
612
|
+
"pinReparent",
|
|
613
|
+
"pinSpacer",
|
|
614
|
+
"pinType",
|
|
615
|
+
"horizontal",
|
|
616
|
+
"scroller",
|
|
617
|
+
"containerAnimation"
|
|
618
|
+
];
|
|
557
619
|
const topToStartClause = (top) => {
|
|
558
620
|
const toClause = (value) => {
|
|
559
621
|
if (!Number.isFinite(value)) throw new Error(`StickyScrollTrigger: createStickyPin's top must be a finite number, got ${value}.`);
|
|
@@ -561,6 +623,13 @@ const topToStartClause = (top) => {
|
|
|
561
623
|
};
|
|
562
624
|
return typeof top === "function" ? () => toClause(top()) : toClause(top);
|
|
563
625
|
};
|
|
626
|
+
const resolvePinReleaseTop = (endTrigger, classifiedEnd, engageTop, viewportHeight) => {
|
|
627
|
+
switch (classifiedEnd.kind) {
|
|
628
|
+
case "dwell": return engageTop + resolveDwell(classifiedEnd.value, viewportHeight);
|
|
629
|
+
case "absolute": return classifiedEnd.value;
|
|
630
|
+
case "clause": return documentTop(endTrigger) - resolveAnchorTop(classifiedEnd.value, measureUsedHeight(endTrigger), viewportHeight);
|
|
631
|
+
}
|
|
632
|
+
};
|
|
564
633
|
const hasDuplicateTrigger = (list, trigger) => list.some((existing) => existing.trigger === trigger);
|
|
565
634
|
var StickyScrollTrigger = class {
|
|
566
635
|
#rootElement;
|
|
@@ -575,16 +644,15 @@ var StickyScrollTrigger = class {
|
|
|
575
644
|
#scrollTriggerClass = null;
|
|
576
645
|
#pinLayers = [];
|
|
577
646
|
#scrollMarginSync;
|
|
578
|
-
#scrollMarginTargets;
|
|
579
647
|
constructor(root, options = {}) {
|
|
580
648
|
this.#rootElement = resolveRoot(root);
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
this.#rootElement.querySelectorAll(this.#scrollMarginTargets);
|
|
649
|
+
const scrollMarginTargets = options.scrollMarginTargets === void 0 ? "[id]" : options.scrollMarginTargets;
|
|
650
|
+
if (scrollMarginTargets !== null) try {
|
|
651
|
+
this.#rootElement.querySelectorAll(scrollMarginTargets);
|
|
585
652
|
} catch {
|
|
586
|
-
throw new Error(`StickyScrollTrigger: scrollMarginTargets "${
|
|
653
|
+
throw new Error(`StickyScrollTrigger: scrollMarginTargets "${scrollMarginTargets}" is not a valid CSS selector.`);
|
|
587
654
|
}
|
|
655
|
+
this.#scrollMarginSync = createScrollMarginSync(this.#rootElement, scrollMarginTargets);
|
|
588
656
|
}
|
|
589
657
|
#unbuild() {
|
|
590
658
|
if (!this.#built) return;
|
|
@@ -609,13 +677,20 @@ var StickyScrollTrigger = class {
|
|
|
609
677
|
});
|
|
610
678
|
}
|
|
611
679
|
#captureScrollTriggerClass(self) {
|
|
680
|
+
if (this.#destroyed) return;
|
|
612
681
|
this.#scrollTriggerClass = self.constructor;
|
|
613
682
|
}
|
|
614
683
|
#createAutoRefreshHandler(userOnRefreshInit) {
|
|
615
684
|
return (self) => {
|
|
616
685
|
this.#captureScrollTriggerClass(self);
|
|
617
686
|
const result = userOnRefreshInit?.(self);
|
|
618
|
-
|
|
687
|
+
try {
|
|
688
|
+
this.refresh();
|
|
689
|
+
} catch (error) {
|
|
690
|
+
queueMicrotask(() => {
|
|
691
|
+
throw error;
|
|
692
|
+
});
|
|
693
|
+
}
|
|
619
694
|
return result;
|
|
620
695
|
};
|
|
621
696
|
}
|
|
@@ -628,6 +703,24 @@ var StickyScrollTrigger = class {
|
|
|
628
703
|
layer.inner = wrapped.inner;
|
|
629
704
|
});
|
|
630
705
|
}
|
|
706
|
+
#reservePinSpace() {
|
|
707
|
+
const wrapped = this.#pinLayers.flatMap(({ outer, inner }) => outer && inner ? [{
|
|
708
|
+
outer,
|
|
709
|
+
inner,
|
|
710
|
+
range: inner.style.height
|
|
711
|
+
}] : []);
|
|
712
|
+
wrapped.forEach(({ outer, inner }) => {
|
|
713
|
+
outer.style.height = "";
|
|
714
|
+
inner.style.height = "";
|
|
715
|
+
});
|
|
716
|
+
const reserved = wrapped.map(({ outer }) => measureUsedHeight(outer));
|
|
717
|
+
wrapped.forEach(({ outer }, index) => {
|
|
718
|
+
outer.style.height = `${reserved[index]}px`;
|
|
719
|
+
});
|
|
720
|
+
wrapped.forEach(({ inner, range }) => {
|
|
721
|
+
inner.style.height = range;
|
|
722
|
+
});
|
|
723
|
+
}
|
|
631
724
|
#unwrapPinLayer(layer) {
|
|
632
725
|
if (!layer.outer) return false;
|
|
633
726
|
unwrapPin(layer.outer, layer.trigger, layer.savedPosition);
|
|
@@ -682,14 +775,16 @@ var StickyScrollTrigger = class {
|
|
|
682
775
|
#refreshPinLayers(viewportHeight) {
|
|
683
776
|
this.#pinLayers.forEach((layer) => {
|
|
684
777
|
if (!layer.inner) return;
|
|
685
|
-
const resolvedEnd = resolveMaybeFn(layer.end);
|
|
686
|
-
if (isMaxFormat(resolvedEnd)) throw new Error(`StickyScrollTrigger: createStickyPin's end "${resolvedEnd}" uses GSAP's 'max' keyword, which isn't supported here: the pin's own spacer height adds to the document's max scroll position, so it would depend on itself. Use a position clause against endTrigger, such as 'top top'.`);
|
|
687
778
|
const resolvedStart = resolveMaybeFn(layer.start);
|
|
779
|
+
const resolvedEnd = prefixSpacedRelativeEnd(resolvedStart, resolveMaybeFn(layer.end));
|
|
780
|
+
const classifiedEnd = classifyPosition(resolvedEnd);
|
|
781
|
+
if (classifiedEnd.kind === "max") throw new Error(`StickyScrollTrigger: createStickyPin's end "${resolvedEnd}" uses GSAP's 'max' keyword, which isn't supported here: the pin's own spacer height adds to the document's max scroll position, so it would depend on itself. Use a position clause against endTrigger, such as 'top top'.`);
|
|
688
782
|
const triggerTop = documentTop(layer.trigger);
|
|
689
|
-
const triggerHeight = layer.trigger
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
const
|
|
783
|
+
const triggerHeight = measureUsedHeight(layer.trigger);
|
|
784
|
+
const classifiedStart = classifyPosition(resolvedStart);
|
|
785
|
+
if (classifiedStart.kind === "absolute") throw new Error(`StickyScrollTrigger: createStickyPin's start "${resolvedStart}" is an absolute scroll position (GSAP reads any bare number this way). A pin can't act on one: it engages when position:sticky engages, so start says where trigger sits in the viewport while pinned. Use the top option (top: ${resolvedStart}) for a px distance from the viewport's top edge, or a position clause such as 'top top'.`);
|
|
786
|
+
const topPx = resolveAnchorTop(classifiedStart.value, triggerHeight, viewportHeight);
|
|
787
|
+
const height = resolvePinReleaseTop(layer.endTrigger, classifiedEnd, triggerTop - topPx, viewportHeight) - triggerTop + topPx + triggerHeight;
|
|
693
788
|
applyStickyPosition(layer.trigger, topPx);
|
|
694
789
|
layer.inner.style.height = `${Math.max(0, height)}px`;
|
|
695
790
|
});
|
|
@@ -743,6 +838,7 @@ var StickyScrollTrigger = class {
|
|
|
743
838
|
this.#restoreCoverLifts();
|
|
744
839
|
try {
|
|
745
840
|
this.#wrapUnwrappedPins();
|
|
841
|
+
this.#reservePinSpace();
|
|
746
842
|
} finally {
|
|
747
843
|
this.#liftCovers();
|
|
748
844
|
}
|
|
@@ -768,7 +864,7 @@ var StickyScrollTrigger = class {
|
|
|
768
864
|
trigger,
|
|
769
865
|
freezeStart,
|
|
770
866
|
freezeEnd
|
|
771
|
-
})), this.#outermostContainer
|
|
867
|
+
})), this.#outermostContainer);
|
|
772
868
|
}
|
|
773
869
|
#assertNoExcludedVars(rest, context) {
|
|
774
870
|
const found = EXCLUDED_VAR_KEYS.filter((key) => key in rest);
|
|
@@ -785,7 +881,7 @@ var StickyScrollTrigger = class {
|
|
|
785
881
|
#assertTriggerNotEnclosingRoot(trigger, context) {
|
|
786
882
|
if (!trigger.contains(this.#rootElement)) return;
|
|
787
883
|
const relation = trigger === this.#rootElement ? "is the shared container itself" : "is an ancestor of the shared container";
|
|
788
|
-
throw new Error(`${context}: trigger ${describeElement(trigger)} ${relation}. A pin
|
|
884
|
+
throw new Error(`${context}: trigger ${describeElement(trigger)} ${relation}. A pin makes trigger itself position:sticky inside a box holding the pin range, so the container and every layer's dwell padding would be pinned along with it. Pin an element that doesn't contain the container.`);
|
|
789
885
|
}
|
|
790
886
|
#registerLayer(layer, onKill, rest) {
|
|
791
887
|
if (this.#destroyed) throw new Error("StickyScrollTrigger: cannot register a new layer after destroy() has been called.");
|
|
@@ -854,12 +950,12 @@ var StickyScrollTrigger = class {
|
|
|
854
950
|
this.#coverRestoreByLayer.set(layer, liftAboveStickyWrapper(coverElement));
|
|
855
951
|
return vars;
|
|
856
952
|
}
|
|
857
|
-
createStickyPin({ trigger: triggerInput, start, top, endTrigger: endTriggerInput, end = "
|
|
953
|
+
createStickyPin({ trigger: triggerInput, start, top, endTrigger: endTriggerInput, end = "bottom top", onKill, ...rest }) {
|
|
858
954
|
this.#assertNoExcludedVars(rest, "createStickyPin");
|
|
859
955
|
if (this.#destroyed) throw new Error("StickyScrollTrigger: cannot register a new pin after destroy() has been called.");
|
|
860
956
|
if (start !== void 0 && top !== void 0) throw new Error("StickyScrollTrigger: createStickyPin accepts either start or top, not both (top: 20 is start: 'top 20px'). Use top for a plain px distance from the viewport's top edge, start for anything else.");
|
|
861
957
|
const trigger = resolveElement(triggerInput, "createStickyPin");
|
|
862
|
-
const endTrigger =
|
|
958
|
+
const endTrigger = resolveEndTrigger(trigger, endTriggerInput, "createStickyPin");
|
|
863
959
|
this.#assertTriggerNotEnclosingRoot(trigger, "createStickyPin");
|
|
864
960
|
this.#assertTriggerAvailable(this.#pinLayers, trigger, `StickyScrollTrigger: ${describeElement(trigger)} is already registered as a pin trigger.`);
|
|
865
961
|
this.#assertTriggerAvailable(this.#layers, trigger, `StickyScrollTrigger: ${describeElement(trigger)} is already registered as a trigger for another layer (createStickyTrigger/createOverlapScroll). Using the same element as both a Scene/Cover trigger and a pin trigger wraps it twice and produces conflicting position:sticky behavior.`);
|
|
@@ -890,15 +986,22 @@ var StickyScrollTrigger = class {
|
|
|
890
986
|
const element = resolveElement(elementInput, "resolveScrollPosition");
|
|
891
987
|
const resolved = resolveMaybeFn(position);
|
|
892
988
|
const viewportHeight = measureViewportHeight();
|
|
893
|
-
|
|
894
|
-
|
|
989
|
+
const classified = classifyPosition(resolved);
|
|
990
|
+
switch (classified.kind) {
|
|
991
|
+
case "max": return measureDocumentMaxScroll(viewportHeight) + resolveMaxOffset(classified.value, viewportHeight);
|
|
992
|
+
case "absolute": return classified.value;
|
|
993
|
+
case "dwell":
|
|
994
|
+
case "clause": return this.#resolveClauseScrollPosition(element, classified.value, viewportHeight);
|
|
995
|
+
}
|
|
996
|
+
}
|
|
997
|
+
#resolveClauseScrollPosition(element, clause, viewportHeight) {
|
|
895
998
|
let gap = 0;
|
|
896
999
|
this.#layers.forEach((layer) => {
|
|
897
1000
|
if (layer.kind !== "scene") return;
|
|
898
1001
|
if (compareDocumentOrder(layer.trigger, element) >= 0) return;
|
|
899
1002
|
gap += layer.freezeEnd - layer.freezeStart;
|
|
900
1003
|
});
|
|
901
|
-
const anchorOffset = resolveAnchorTop(
|
|
1004
|
+
const anchorOffset = resolveAnchorTop(clause, measureUsedHeight(element), viewportHeight);
|
|
902
1005
|
const restoreSceneCoverStickyState = this.#resetSceneCoverStickyState();
|
|
903
1006
|
const result = documentTop(element) + gap - anchorOffset;
|
|
904
1007
|
restoreSceneCoverStickyState();
|
|
@@ -910,7 +1013,7 @@ var StickyScrollTrigger = class {
|
|
|
910
1013
|
if (owner) return owner.resolveScrollPosition(element, "top top");
|
|
911
1014
|
return documentTop(element);
|
|
912
1015
|
}
|
|
913
|
-
createResolvedTrigger({ trigger: triggerInput, start, end, endTrigger: endTriggerInput, ...rest }) {
|
|
1016
|
+
createResolvedTrigger({ trigger: triggerInput, start = "top bottom", end = "bottom top", endTrigger: endTriggerInput, ...rest }) {
|
|
914
1017
|
this.#assertNoExcludedVars(rest, "createResolvedTrigger");
|
|
915
1018
|
const trigger = resolveElement(triggerInput, "createResolvedTrigger");
|
|
916
1019
|
const endTrigger = resolveEndTrigger(trigger, endTriggerInput, "createResolvedTrigger");
|
|
@@ -918,7 +1021,12 @@ var StickyScrollTrigger = class {
|
|
|
918
1021
|
...rest,
|
|
919
1022
|
trigger,
|
|
920
1023
|
start: () => this.resolveScrollPosition(trigger, start),
|
|
921
|
-
end: () =>
|
|
1024
|
+
end: () => {
|
|
1025
|
+
const resolvedEnd = resolveMaybeFn(end);
|
|
1026
|
+
const classifiedEnd = classifyPosition(resolvedEnd);
|
|
1027
|
+
if (classifiedEnd.kind === "dwell") return this.resolveScrollPosition(trigger, start) + resolveDwell(classifiedEnd.value, measureViewportHeight());
|
|
1028
|
+
return this.resolveScrollPosition(endTrigger, prefixSpacedRelativeEnd(start, resolvedEnd));
|
|
1029
|
+
}
|
|
922
1030
|
};
|
|
923
1031
|
}
|
|
924
1032
|
destroy() {
|
|
@@ -931,6 +1039,7 @@ var StickyScrollTrigger = class {
|
|
|
931
1039
|
this.#builtLayers = [];
|
|
932
1040
|
this.#pinLayers.forEach((layer) => this.#unwrapPinLayer(layer));
|
|
933
1041
|
this.#pinLayers.length = 0;
|
|
1042
|
+
this.#scrollTriggerClass = null;
|
|
934
1043
|
}
|
|
935
1044
|
};
|
|
936
1045
|
export { StickyScrollTrigger as default };
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
/*!
|
|
2
2
|
* @license
|
|
3
|
-
* StickyScrollTrigger v0.
|
|
3
|
+
* StickyScrollTrigger v0.9.0
|
|
4
4
|
* Copyright (c) 2026 Kuninori Ogino
|
|
5
5
|
* Released under the MIT License
|
|
6
6
|
* https://github.com/kuninori-ogino/sticky-scroll-trigger
|
|
7
7
|
*/
|
|
8
|
-
const e=e=>{let t=typeof e==`string`?document.querySelector(e):e;if(!t){let t=typeof e==`string`?`"${e}"`:String(e);throw Error(`StickyScrollTrigger: root ${t} not found`)}return t},t=(e,t)=>{let n=typeof e==`string`?document.querySelector(e):e;if(!n){let n=typeof e==`string`?`"${e}"`:String(e);throw Error(`${t}: element ${n} not found`)}return n},n=(e,n,r)=>n===void 0?e:t(n,r),r=e=>{let t=e.id?`#${e.id}`:``,n=e.classList.length>0?`.${Array.from(e.classList).join(`.`)}`:``;return`<${e.tagName.toLowerCase()}${t}${n}>`},i=e=>{let t=0,n=e;for(;n;){t+=n.offsetTop;let e=n.offsetParent;e&&(t+=e.clientTop),n=e}return t},a=()=>{let e=document.createElement(`div`);e.style.height=`100vh`,e.style.position=`absolute`,document.body.appendChild(e);let t=e.offsetHeight||window.innerHeight;return e.remove(),t},o=e=>{let t=document.documentElement;return Math.max(0,(t.scrollHeight||document.body.scrollHeight)-e)},s=(e,t)=>{let n=e.compareDocumentPosition(t);return n&Node.DOCUMENT_POSITION_FOLLOWING?-1:n&Node.DOCUMENT_POSITION_PRECEDING?1:0},c=e=>{e.style.position=``,e.style.top=``},l=(e,t)=>{e.style.position=`sticky`,e.style.top=`${t}px`},u=e=>({position:e.style.position,top:e.style.top}),d=(e,t)=>{e.style.position=t.position,e.style.top=t.top},f=e=>{if(!e.parentNode)throw Error(`StickyScrollTrigger: ${r(e)} is not attached to the document`);let t=document.createElement(`div`),n=document.createElement(`div`),i=document.createElement(`div`);return i.setAttribute(`aria-hidden`,`true`),i.style.pointerEvents=`none`,e.parentNode.insertBefore(t,e),t.appendChild(n),n.appendChild(e),t.appendChild(i),{container:t,wrapper:n,padding:i}},p=e=>{let t=e.parentNode;if(!t)throw Error(`createOverlapScroll: trigger ${r(e)} is not attached to the document`);let n=document.createElement(`div`);for(t.insertBefore(n,t.firstChild);n.nextSibling;){let t=n.nextSibling;if(n.appendChild(t),t===e)break}return n},m=e=>{let t=e.parentNode;if(t){for(;e.firstChild;)t.insertBefore(e.firstChild,e);e.remove()}},h=e=>{if(!e.parentNode)throw Error(`createStickyPin: trigger ${r(e)} is not attached to the document`);let t=document.createElement(`div`),n=document.createElement(`div`);return t.style.height=`0`,t.style.contain=`layout`,e.parentNode.insertBefore(t,e),t.appendChild(n),n.appendChild(e),{outer:t,inner:n}},g=(e,t,n)=>{let r=e.parentNode;d(t,n),r&&r.insertBefore(t,e),e.remove()},_={position:`relative`,zIndex:`1`},v=new WeakMap,y=e=>{let t=[];for(let n=e;n;n=n.nextElementSibling){if(!(n instanceof HTMLElement))continue;let e=n,r=v.get(e);if(r)r.count+=1;else{let t=getComputedStyle(e),n=[];t.position===`static`&&n.push(`position`),t.zIndex===`auto`&&n.push(`zIndex`),n.forEach(t=>{e.style[t]=_[t]}),v.set(e,{count:1,applied:n})}t.push(e)}return()=>{t.forEach(e=>{let t=v.get(e);t&&(--t.count,!(t.count>0)&&(t.applied.forEach(t=>{e.style[t]===_[t]&&(e.style[t]=``)}),v.delete(e)))}),t.length=0}};let b=0;const x=typeof CSS<`u`&&typeof CSS.supports==`function`&&CSS.supports(`animation-timeline`,`scroll()`),S=typeof CSSStyleSheet==`function`&&typeof CSSStyleSheet.prototype.replaceSync==`function`&&typeof document<`u`&&Array.isArray(document.adoptedStyleSheets),C=x&&S,w=(e,t)=>{let n=[],r=[],i=[],a=[];return t.forEach((t,o)=>{let s=`--${e}-c${o}`,c=`${e}-k${o}`;n.push(`@property ${s}{syntax:"<length>";inherits:true;initial-value:0px}`,`@keyframes ${c}{from{${s}:0px}to{${s}:${t.freezeEnd-t.freezeStart}px}}`),r.push(`${c} linear both`),i.push(`scroll(root block)`),a.push(`${t.freezeStart}px ${t.freezeEnd}px`)}),n.push(`@supports (animation-timeline: scroll()) {[data-${e}]{animation:${r.join(`,`)};animation-timeline:${i.join(`,`)};animation-range:${a.join(`,`)}}}`),n.join(``)},T=e=>{let t=`sst${b++}`,n=new WeakMap,r=new Set,i=null,a=null,o=[],c=null,l=()=>{if(!c)return;let e=window.scrollY;o.forEach((n,r)=>{let i=Math.min(Math.max(e-n.freezeStart,0),n.freezeEnd-n.freezeStart);c.style.setProperty(`--${t}-c${r}`,`${i}px`)})};C||window.addEventListener(`scroll`,l,{passive:!0});let u=e=>{let t=n.get(e);e.style.scrollMarginTop=t?t.inline:``},d=()=>{i&&=(document.adoptedStyleSheets=document.adoptedStyleSheets.filter(e=>e!==i),null),a?.removeAttribute(`data-${t}`),a=null,o=[],c=null};return{sync(f,p,m){let h=f.filter(e=>e.freezeEnd>e.freezeStart);if(m===null||!h.length||!p){r.forEach(u),r=new Set,d();return}a!==p&&(a?.removeAttribute(`data-${t}`),a=p,a.setAttribute(`data-${t}`,``)),C?(i||(i=new CSSStyleSheet,document.adoptedStyleSheets=[...document.adoptedStyleSheets,i]),i.replaceSync(w(t,h))):(o=h,c=p,l());let g=Array.from(e.querySelectorAll(m));g.forEach(e=>{let t=n.get(e);t?r.has(e)&&(e.style.scrollMarginTop=t.inline):n.set(e,{inline:e.style.scrollMarginTop})});let _=h.map((e,n)=>`var(--${t}-c${n}, 0px)`).join(` + `);g.forEach(e=>{let t=parseFloat(getComputedStyle(e).scrollMarginTop)||0,n=0;h.forEach(t=>{s(t.trigger,e)>=0||(n+=t.freezeEnd-t.freezeStart)}),e.style.scrollMarginTop=`calc(${t}px + var(--sst-scroll-margin-top-offset, 0px) + ${_} - ${n}px)`});let v=new Set(g);r.forEach(e=>{v.has(e)||u(e)}),r=v},restore(){C||window.removeEventListener(`scroll`,l),r.forEach(u),r=new Set,d()}}},E=e=>{for(let t=1;t<e.length;t+=1)if(s(e[t-1].trigger,e[t].trigger)>0)return!0;return!1},D=(e,t)=>{t.sort((e,t)=>s(e.trigger,t.trigger));for(let e of t)e.kind===`cover`&&(e.wrapper=p(e.trigger));let n=e,r=null;for(let e of t){if(e.kind!==`scene`)continue;let t=f(n);e.container=t.container,e.wrapper=t.wrapper,e.padding=t.padding,n=t.container,r=t.container}return r},O=(e,t,n)=>{n&&(n.parentNode?.insertBefore(e,n),n.remove());for(let e=t.length-1;e>=0;--e){let n=t[e];n.kind===`cover`&&n.wrapper&&m(n.wrapper)}t.forEach(e=>{e.wrapper=null,e.kind===`scene`&&(e.container=null,e.padding=null)})},k=e=>typeof e==`function`?e():e,A={top:0,center:.5,bottom:1},j=(e,t,n,r)=>{let i=n===`%`?parseFloat(t)/100*r:parseFloat(t);return e?.startsWith(`-`)?-i:i},M=/^(top|center|bottom|(?:\d+(?:\.\d*)?|\.\d+))?(%|px)?(?:([+-]=?)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/,N=(e,t)=>{let n=M.exec(e);if(!n||!n[1]&&!n[3])throw B.test(e)?Error(`StickyScrollTrigger: unsupported position clause "${e}": 'max' is GSAP's end-only keyword for the scroller's maximum scroll position.`):Error(`StickyScrollTrigger: unsupported position clause "${e}"`);let[,r,i,a,o,s]=n;if(r!==void 0&&a&&!a.includes(`=`)){let t=`${r}${i??``}${a}=${o}${s??``}`;throw Error(`StickyScrollTrigger: unsupported position clause "${e}": a signed offset needs an explicit '=' when it follows a keyword or number (GSAP needs it to tell "${r}" from the offset). Did you mean "${t}"?`)}let c=r!==void 0&&r in A,l=i===`%`;return{fraction:c?A[r]:l?parseFloat(r)/100:0,offsetPx:(!c&&!l&&r!==void 0?parseFloat(r):0)+(a?j(a,o,s,t):0)}},P=e=>typeof e==`number`||e.trim()!==``&&!Number.isNaN(Number(e)),F=e=>typeof e==`number`?e:Number(e),I=(e,t,n)=>{let r=e.trim();if(r.startsWith(`clamp(`)){let e=r.slice(6).replace(/\)$/,``).trim();throw Error(`StickyScrollTrigger: unsupported position clause "${r}": GSAP's clamp() wrapper isn't supported here.`+(e?` Did you mean "${e}"?`:``))}let[i,a=`top`]=r.split(/\s+/),o=N(i,t),s=N(a,n);return n*s.fraction+s.offsetPx-(t*o.fraction+o.offsetPx)},L=/^\+=(\d+(?:\.\d*)?|\.\d+)(%|px)?$/,R=e=>typeof e==`string`&&L.test(e.trim()),z=(e,t)=>{let n=L.exec(String(e).trim());if(!n)throw Error(`StickyScrollTrigger: unsupported end format "${e}"`);let[,r,i]=n;return j(void 0,r,i,t)},B=/^max(?:([+-]=)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/,V=e=>typeof e==`string`&&B.test(e.trim()),H=(e,t)=>{let n=B.exec(e.trim());if(!n)throw Error(`StickyScrollTrigger: unsupported max-position format "${e}"`);let[,r,i,a]=n;return r?j(r,i,a,t):0},U=(e,t,n,r,i)=>{let a=0;return e.forEach((e,o)=>{if(o===i||e.triggerTop>=r)return;let s=t[o]===void 0?n?n.paddings[o]:null:t[o];s!=null&&(a+=s)}),a},W=(e,{viewportHeight:t,structureTop:n,documentMaxScroll:r,measureLiveEndTriggerTop:i},a)=>{let o=[],s=[],c=0;return{plans:e.map((l,u)=>{let d=l.triggerTop+c,f=l.start.mode===`absolute`?l.start.value:d-l.start.anchorOffset,p;switch(l.end.mode){case`auto`:if(l.start.mode!==`clause`)throw Error(`StickyScrollTrigger: internal error: an absolute start reached 'auto' end mode, which resolveStartSpec should have already rejected.`);p=f+Math.max(0,l.start.anchorOffset+(l.coverTop-l.triggerTop));break;case`dwell`:p=f+l.end.distancePx;break;case`absolute`:p=Math.max(f,l.end.value);break;case`max`:p=Math.max(f,r+l.end.offsetPx);break;case`clause`:{let n;if(l.endTriggerIsSelf)n=d;else{let t=l.endTriggerIndex===null?void 0:o[l.endTriggerIndex]===void 0?a?a.naturalTops[l.endTriggerIndex]:void 0:o[l.endTriggerIndex];n=t===void 0?l.end.measureLive?i(u):l.end.rawTop===null?0:l.end.rawTop+U(e,s,a,l.end.rawTop,u):t}let r=I(l.end.clause,l.endTriggerHeight,t);p=Math.max(f,n-r);break}}let m;if(l.kind===`cover`){if(l.start.mode!==`clause`)throw Error(`StickyScrollTrigger: internal error: a cover layer measurement carries an absolute start, which resolveStartSpec should have already rejected.`);m={freezeStart:f,freezeEnd:p,stickyTop:l.start.anchorOffset-(l.triggerTop-l.wrapperTop),paddingHeight:null}}else m={freezeStart:f,freezeEnd:p,stickyTop:n-f,paddingHeight:Math.max(0,p-f)};return m.paddingHeight!==null&&(c+=m.paddingHeight),o[u]=d,s[u]=m.paddingHeight,m}),naturalTops:o}},G=(e,t)=>{let n=e.some((e,t)=>e.end.mode!==`clause`||e.endTriggerIsSelf?!1:e.endTriggerIndex===null?e.end.rawTop!==null:e.endTriggerIndex>=t),r=new Map,i={...t,measureLiveEndTriggerTop:e=>{let n=r.get(e);if(n!==void 0)return n;let i=t.measureLiveEndTriggerTop(e);return r.set(e,i),i}},{plans:a,naturalTops:o}=W(e,i,null);if(n)for(let t=0;t<e.length;t+=1){let n={paddings:a.map(e=>e.paddingHeight),naturalTops:o},r=W(e,i,n),s=r.plans.every((e,t)=>e.paddingHeight===a[t].paddingHeight);if(a=r.plans,o=r.naturalTops,s)break;if(t===e.length-1)throw Error(`StickyScrollTrigger: could not resolve endTrigger positions: some endTrigger references form a circular structural dependency, each layer's end depending on a layer whose own end depends back on it. Point each endTrigger at a layer that doesn't depend on it.`)}return a.forEach((e,n)=>t.onPlanned(n,e)),a},K=[`trigger`,`start`,`end`,`endTrigger`,`pin`,`pinSpacing`,`anticipatePin`,`pinnedContainer`,`pinReparent`,`pinSpacer`,`pinType`,`horizontal`,`scroller`,`containerAnimation`],q=(e,t,n,a,o,s)=>{if(a===null)return{mode:`auto`};if(R(a))return{mode:`dwell`,distancePx:Math.max(0,z(a,t))};if(P(a))return{mode:`absolute`,value:F(a)};if(V(a)){if(n.kind!==`cover`)throw Error(`StickyScrollTrigger: createStickyTrigger's trigger ${r(n.trigger)} has end "${a}". GSAP's 'max' keyword isn't supported here: the layer's own dwell padding adds to the document's max scroll position, so the freeze window would depend on itself. Use createOverlapScroll, which adds no padding, or a dwell distance such as '+=500'.`);return{mode:`max`,offsetPx:H(a,t)}}if(n.kind!==`cover`&&s!==null&&s>o)throw Error(`StickyScrollTrigger: createStickyTrigger's trigger ${r(n.trigger)}'s endTrigger (${r(n.endTrigger)}) refers to a layer positioned later in DOM order, which isn't supported: this layer's own dwell padding pushes that one down, so the freeze window would depend on its own dwell. Point endTrigger at a layer earlier in DOM order, or use a dwell distance such as '+=500'.`);let c=s===null,l=e.contains(n.endTrigger);if(c&&!l&&n.kind!==`cover`)throw Error(`StickyScrollTrigger: createStickyTrigger's trigger ${r(n.trigger)} has an endTrigger (${r(n.endTrigger)}) outside the shared container: the layer's own dwell keeps pushing it away, so the freeze window never settles. Point endTrigger at an element inside the container, or use a dwell distance such as '+=500'.`);return{mode:`clause`,clause:a,rawTop:c&&l?i(n.endTrigger):null,measureLive:c&&!l}},J=(e,t,n,i)=>{if(!P(t))return{mode:`clause`,anchorOffset:I(t,n,i)};if(e.kind===`cover`)throw Error(`StickyScrollTrigger: createOverlapScroll's trigger ${r(e.trigger)} has start "${t}", an absolute scroll position (GSAP reads any bare number this way). That isn't supported here: a cover layer's sticky position is computed relative to its own wrapper, so start must be a position clause such as 'bottom bottom'.`);return{mode:`absolute`,value:F(t)}},Y=(e,t,n,r,a)=>{let o=k(n.start),s=n.end===null?null:k(n.end),c=n.trigger.offsetHeight,l=n.endTrigger===n.trigger,u=a.get(n.endTrigger)??null,d=q(e,t,n,s,r,u),f=J(n,o,c,t);return{kind:n.kind,start:f,triggerTop:i(n.trigger),wrapperTop:n.wrapper?i(n.wrapper):0,coverTop:n.kind===`cover`?i(n.cover):0,end:d,endTriggerIsSelf:l,endTriggerIndex:u,endTriggerHeight:d.mode===`clause`?n.endTrigger.offsetHeight:0}},X=e=>{let t=e=>{if(!Number.isFinite(e))throw Error(`StickyScrollTrigger: createStickyPin's top must be a finite number, got ${e}.`);return`top ${e}px`};return typeof e==`function`?()=>t(e()):t(e)},Z=(e,t)=>e.some(e=>e.trigger===t);var Q=class{#e;#t=[];#n=[];#r=new WeakMap;#i=!1;#a=!1;#o=null;#s=!1;#c=!1;#l=null;#u=[];#d;#f;constructor(t,n={}){if(this.#e=e(t),this.#d=T(this.#e),this.#f=n.scrollMarginTargets===void 0?`[id]`:n.scrollMarginTargets,this.#f!==null)try{this.#e.querySelectorAll(this.#f)}catch{throw Error(`StickyScrollTrigger: scrollMarginTargets "${this.#f}" is not a valid CSS selector.`)}}#p(){this.#i&&=(O(this.#e,this.#n,this.#o),this.#o=null,!1)}#m(){this.#o=D(this.#e,this.#t),this.#n=[...this.#t],this.#i=!0,this.#a=!1}#h(){this.#c||this.#s||(this.#c=!0,queueMicrotask(()=>{this.#c=!1,!this.#s&&(this.refresh(),typeof this.#l?.refresh==`function`&&this.#l.refresh())}))}#g(e){this.#l=e.constructor}#_(e){return t=>{this.#g(t);let n=e?.(t);return this.refresh(),n}}#v(){this.#u.forEach(e=>{if(e.outer)return;e.savedPosition=u(e.trigger);let t=h(e.trigger);e.outer=t.outer,e.inner=t.inner})}#y(e){return e.outer?(g(e.outer,e.trigger,e.savedPosition),e.outer=null,e.inner=null,!0):!1}#b(){let e=this.#t.map(e=>e.wrapper).filter(e=>e!==null).map(e=>({wrapper:e,position:e.style.position,top:e.style.top}));return e.forEach(({wrapper:e})=>c(e)),()=>{e.forEach(({wrapper:e,position:t,top:n})=>{e.style.position=t,e.style.top=n})}}#x(){let e=this.#u.map(e=>({layer:e,position:u(e.trigger),height:e.inner?e.inner.style.height:``}));return e.forEach(({layer:e})=>{c(e.trigger),e.inner&&(e.inner.style.height=``)}),()=>{e.forEach(({layer:e,position:t,height:n})=>{d(e.trigger,t),e.inner&&(e.inner.style.height=n)})}}#S(e){if(!this.#u.length)return;let t=this.#b(),n=this.#x();try{this.#C(e)}catch(e){throw n(),e}finally{t()}}#C(e){this.#u.forEach(t=>{if(!t.inner)return;let n=k(t.end);if(V(n))throw Error(`StickyScrollTrigger: createStickyPin's end "${n}" uses GSAP's 'max' keyword, which isn't supported here: the pin's own spacer height adds to the document's max scroll position, so it would depend on itself. Use a position clause against endTrigger, such as 'top top'.`);let r=k(t.start),a=i(t.trigger),o=t.trigger.offsetHeight;if(P(r))throw Error(`StickyScrollTrigger: createStickyPin's start "${r}" is an absolute scroll position (GSAP reads any bare number this way). A pin can't act on one: it engages when position:sticky engages, so start says where trigger sits in the viewport while pinned. Use the top option (top: ${r}) for a px distance from the viewport's top edge, or a position clause such as 'top top'.`);let s=I(r,o,e),c=(P(n)?F(n):i(t.endTrigger)-I(n,t.endTrigger.offsetHeight,e))-a+s+o;l(t.trigger,s),t.inner.style.height=`${Math.max(0,c)}px`})}#w(e){if(!this.#t.length)return;let t=this.#t.filter(e=>e.wrapper!==null);if(!t.length)return;let n=this.#b();try{this.#T(e,t)}catch(e){throw n(),e}}#T(e,t){let n=this.#o?i(this.#o):0,r=new Map;t.forEach((e,t)=>{r.set(e.trigger,t)});let a=t.map((t,n)=>Y(this.#e,e,t,n,r)),s=0,c=()=>G(a,{viewportHeight:e,structureTop:n,documentMaxScroll:s,measureLiveEndTriggerTop:e=>i(t[e].endTrigger),onPlanned:(e,n)=>{let r=t[e];r.freezeStart=n.freezeStart,r.freezeEnd=n.freezeEnd,r.wrapper&&(l(r.wrapper,n.stickyTop),r.kind===`scene`&&r.padding&&n.paddingHeight!==null&&(r.padding.style.height=`${n.paddingHeight}px`))}});c();let u=a.some(e=>e.end.mode===`clause`&&e.end.measureLive),d=a.some(e=>e.end.mode===`max`);d&&(s=o(e)),(u||d)&&c()}refresh(){if(this.#s)return;(this.#a||!this.#i||E(this.#t))&&(this.#p(),this.#m()),this.#D();try{this.#v()}finally{this.#O()}let e=this.#t.length||this.#u.length?a():0;this.#w(e),this.#S(e),this.#k()}#E(){return this.#t.filter(e=>e.kind===`cover`)}#D(){this.#E().forEach(e=>this.#r.get(e)?.())}#O(){this.#E().forEach(e=>{let t=this.#u.find(({trigger:t})=>t===e.cover);this.#r.set(e,y(t?.outer??e.cover))})}#k(){this.#d.sync(this.#t.filter(e=>e.kind===`scene`).map(({trigger:e,freezeStart:t,freezeEnd:n})=>({trigger:e,freezeStart:t,freezeEnd:n})),this.#o,this.#f)}#A(e,t){let n=K.filter(t=>t in e);if(n.length!==0)throw Error(`${t}: ${n.join(`, `)} ${n.length>1?`are`:`is`} not supported here; this module handles pinning and the scroll axis itself.`)}#j(e,t,n){if(Z(e,t))throw Error(n)}#M(e,t){if(e===this.#e)throw Error(`${t}: trigger ${r(e)} is the shared container itself. Point trigger at an element inside the container.`);if(!this.#e.contains(e))throw Error(`${t}: trigger ${r(e)} is outside the shared container. Point trigger at an element inside it, or use createStickyPin, which works on either side.`)}#N(e,t){if(!e.contains(this.#e))return;let n=e===this.#e?`is the shared container itself`:`is an ancestor of the shared container`;throw Error(`${t}: trigger ${r(e)} ${n}. A pin wraps trigger in a height:0, contain:layout box, which would pull the container and every layer's dwell padding out of the flow. Pin an element that doesn't contain the container.`)}#P(e,t,n){if(this.#s)throw Error(`StickyScrollTrigger: cannot register a new layer after destroy() has been called.`);return this.#j(this.#t,e.trigger,`StickyScrollTrigger: ${r(e.trigger)} is already registered as a trigger for another layer. Each element can be used once per controller instance, across createStickyTrigger and createOverlapScroll: reusing one makes endTrigger resolution ambiguous.`),this.#j(this.#u,e.trigger,`StickyScrollTrigger: ${r(e.trigger)} is already registered as a pin trigger (createStickyPin). Using the same element as both a Scene/Cover trigger and a pin trigger wraps it twice and produces conflicting position:sticky behavior.`),this.#t.push(e),this.#a=!0,{...n,trigger:e.trigger,start:()=>e.freezeStart,end:()=>e.freezeEnd||.001,invalidateOnRefresh:n.invalidateOnRefresh??!0,onKill:n=>{this.#g(n);let r=this.#t.indexOf(e);r!==-1&&this.#t.splice(r,1),this.#a=!0,this.#h(),t?.(n)},onRefreshInit:this.#_(n.onRefreshInit)}}createStickyTrigger({trigger:e,start:r=`0 0`,end:i=`100% 0`,endTrigger:a,onKill:o,...s}){this.#A(s,`createStickyTrigger`);let c=t(e,`createStickyTrigger`);this.#M(c,`createStickyTrigger`);let l=n(c,a,`createStickyTrigger`);return this.#P({kind:`scene`,trigger:c,endTrigger:l,container:null,wrapper:null,padding:null,start:r,end:i,freezeStart:0,freezeEnd:0},o,s)}createOverlapScroll({trigger:e,cover:i,start:a=`bottom bottom`,end:o=null,endTrigger:s,onKill:c,...l}){this.#A(l,`createOverlapScroll`);let u=t(e,`createOverlapScroll`);this.#M(u,`createOverlapScroll`);let d=n(u,s,`createOverlapScroll`),f=i===void 0?u.nextElementSibling:t(i,`createOverlapScroll`);if(!(f instanceof HTMLElement))throw Error(`createOverlapScroll: cover element (trigger.nextElementSibling) not found for trigger ${r(u)}`);if(f.parentNode!==u.parentNode)throw Error(`createOverlapScroll: cover ${r(f)} must be a sibling of trigger `+r(u));let p={kind:`cover`,trigger:u,endTrigger:d,cover:f,wrapper:null,start:a,end:o,freezeStart:0,freezeEnd:0},m=this.#P(p,e=>{this.#r.get(p)?.(),c?.(e)},l);return this.#r.set(p,y(f)),m}createStickyPin({trigger:e,start:n,top:i,endTrigger:a,end:o=`top top`,onKill:s,...c}){if(this.#A(c,`createStickyPin`),this.#s)throw Error(`StickyScrollTrigger: cannot register a new pin after destroy() has been called.`);if(n!==void 0&&i!==void 0)throw Error(`StickyScrollTrigger: createStickyPin accepts either start or top, not both (top: 20 is start: 'top 20px'). Use top for a plain px distance from the viewport's top edge, start for anything else.`);let l=t(e,`createStickyPin`),d=t(a,`createStickyPin`);this.#N(l,`createStickyPin`),this.#j(this.#u,l,`StickyScrollTrigger: ${r(l)} is already registered as a pin trigger.`),this.#j(this.#t,l,`StickyScrollTrigger: ${r(l)} is already registered as a trigger for another layer (createStickyTrigger/createOverlapScroll). Using the same element as both a Scene/Cover trigger and a pin trigger wraps it twice and produces conflicting position:sticky behavior.`);let f={trigger:l,savedPosition:u(l),outer:null,inner:null,start:i===void 0?n??`top top`:X(i),endTrigger:d,end:o};return this.#u.push(f),{...c,trigger:l,onKill:e=>{this.#g(e);let t=this.#u.indexOf(f);t!==-1&&this.#u.splice(t,1),this.#y(f)&&this.#h(),s?.(e)},onRefreshInit:this.#_(c.onRefreshInit)}}resolveScrollPosition(e,n){let r=t(e,`resolveScrollPosition`),c=k(n),l=a();if(V(c))return o(l)+H(c,l);if(P(c))return F(c);let u=0;this.#t.forEach(e=>{e.kind===`scene`&&(s(e.trigger,r)>=0||(u+=e.freezeEnd-e.freezeStart))});let d=I(c,r.offsetHeight,l),f=this.#b(),p=i(r)+u-d;return f(),p}static getScrollTop(e,n){let r=t(e,`StickyScrollTrigger.getScrollTop`),a=n.find(e=>e.#e.contains(r));return a?a.resolveScrollPosition(r,`top top`):i(r)}createResolvedTrigger({trigger:e,start:r,end:i,endTrigger:a,...o}){this.#A(o,`createResolvedTrigger`);let s=t(e,`createResolvedTrigger`),c=n(s,a,`createResolvedTrigger`);return{...o,trigger:s,start:()=>this.resolveScrollPosition(s,r),end:()=>this.resolveScrollPosition(c,i)}}destroy(){this.#s||(this.#s=!0,this.#d.restore(),this.#D(),this.#p(),this.#t.length=0,this.#n=[],this.#u.forEach(e=>this.#y(e)),this.#u.length=0)}};export{Q as default};
|
|
8
|
+
const e=e=>{let t=typeof e==`string`?document.querySelector(e):e;if(!t){let t=typeof e==`string`?`"${e}"`:String(e);throw Error(`StickyScrollTrigger: root ${t} not found`)}return t},t=(e,t)=>{let n=typeof e==`string`?document.querySelector(e):e;if(!n){let n=typeof e==`string`?`"${e}"`:String(e);throw Error(`${t}: element ${n} not found`)}return n},n=(e,n,r)=>n===void 0?e:t(n,r),r=e=>{let t=e.id?`#${e.id}`:``,n=e.classList.length>0?`.${Array.from(e.classList).join(`.`)}`:``;return`<${e.tagName.toLowerCase()}${t}${n}>`},i=e=>{let t=0,n=e;for(;n;){t+=n.offsetTop;let e=n.offsetParent;e&&(t+=e.clientTop),n=e}return t},a=()=>{let e=document.createElement(`div`);e.style.height=`100vh`,e.style.position=`absolute`,document.body.appendChild(e);let t=e.offsetHeight||window.innerHeight;return e.remove(),t},o=e=>{let t=document.documentElement;return Math.max(0,(t.scrollHeight||document.body.scrollHeight)-e)},s=(e,t)=>e===`none`||e===`hidden`?0:parseFloat(t),c=e=>{let t=e.offsetHeight,n=getComputedStyle(e),r=parseFloat(n.height);if(!Number.isFinite(r))return t;let i=n.boxSizing===`border-box`?r:r+parseFloat(n.paddingTop)+parseFloat(n.paddingBottom)+s(n.borderTopStyle,n.borderTopWidth)+s(n.borderBottomStyle,n.borderBottomWidth);return t>0&&Math.abs(i-t)>=1?t:i},l=(e,t)=>{let n=e.compareDocumentPosition(t);return n&Node.DOCUMENT_POSITION_FOLLOWING?-1:n&Node.DOCUMENT_POSITION_PRECEDING?1:0},u=e=>{e.style.position=``,e.style.top=``},d=(e,t)=>{e.style.position=`sticky`,e.style.top=`${t}px`},f=e=>({position:e.style.position,top:e.style.top}),p=(e,t)=>{e.style.position=t.position,e.style.top=t.top},m=e=>{if(!e.parentNode)throw Error(`StickyScrollTrigger: ${r(e)} is not attached to the document`);let t=document.createElement(`div`),n=document.createElement(`div`),i=document.createElement(`div`);return i.setAttribute(`aria-hidden`,`true`),i.style.pointerEvents=`none`,e.parentNode.insertBefore(t,e),t.appendChild(n),n.appendChild(e),t.appendChild(i),{container:t,wrapper:n,padding:i}},h=e=>{let t=e.parentNode;if(!t)throw Error(`createOverlapScroll: trigger ${r(e)} is not attached to the document`);let n=document.createElement(`div`);for(t.insertBefore(n,t.firstChild);n.nextSibling;){let t=n.nextSibling;if(n.appendChild(t),t===e)break}return n},g=e=>{let t=e.parentNode;if(t){for(;e.firstChild;)t.insertBefore(e.firstChild,e);e.remove()}},_=e=>{if(!e.parentNode)throw Error(`createStickyPin: trigger ${r(e)} is not attached to the document`);let t=document.createElement(`div`),n=document.createElement(`div`);return t.style.contain=`layout`,e.parentNode.insertBefore(t,e),t.appendChild(n),n.appendChild(e),{outer:t,inner:n}},v=(e,t,n)=>{let r=e.parentNode;p(t,n),r&&r.insertBefore(t,e),e.remove()},y={position:`relative`,zIndex:`1`},b=new WeakMap,x=e=>{let t=[];for(let n=e;n;n=n.nextElementSibling){if(!(n instanceof HTMLElement))continue;let e=n,r=b.get(e);if(r)r.count+=1;else{let t=getComputedStyle(e),n=[];t.position===`static`&&n.push(`position`),t.zIndex===`auto`&&n.push(`zIndex`),n.forEach(t=>{e.style[t]=y[t]}),b.set(e,{count:1,applied:n})}t.push(e)}return()=>{t.forEach(e=>{let t=b.get(e);t&&(--t.count,!(t.count>0)&&(t.applied.forEach(t=>{e.style[t]===y[t]&&(e.style[t]=``)}),b.delete(e)))}),t.length=0}};let S=0;const C=typeof CSS<`u`&&typeof CSS.supports==`function`&&CSS.supports(`animation-timeline`,`scroll()`),w=typeof CSSStyleSheet==`function`&&typeof CSSStyleSheet.prototype.replaceSync==`function`&&typeof document<`u`&&Array.isArray(document.adoptedStyleSheets),T=C&&w,E=(e,t)=>{let n=[],r=[],i=[],a=[];return t.forEach((t,o)=>{let s=`--${e}-c${o}`,c=`${e}-k${o}`;n.push(`@property ${s}{syntax:"<length>";inherits:true;initial-value:0px}`,`@keyframes ${c}{from{${s}:0px}to{${s}:${t.freezeEnd-t.freezeStart}px}}`),r.push(`${c} linear both`),i.push(`scroll(root block)`),a.push(`${t.freezeStart}px ${t.freezeEnd}px`)}),n.push(`@supports (animation-timeline: scroll()) {[data-${e}]{animation:${r.join(`,`)};animation-timeline:${i.join(`,`)};animation-range:${a.join(`,`)}}}`),n.join(``)},D=(e,t)=>{let n=`sst${S++}`,r=!T&&t!==null,i=new WeakMap,a=new Set,o=null,s=null,c=[],u=null,d=()=>{if(!u)return;let e=window.scrollY;c.forEach((t,r)=>{let i=Math.min(Math.max(e-t.freezeStart,0),t.freezeEnd-t.freezeStart);u.style.setProperty(`--${n}-c${r}`,`${i}px`)})};r&&window.addEventListener(`scroll`,d,{passive:!0});let f=e=>{let t=i.get(e);e.style.scrollMarginTop=t?t.inline:``},p=()=>{o&&=(document.adoptedStyleSheets=document.adoptedStyleSheets.filter(e=>e!==o),null),s?.removeAttribute(`data-${n}`),s=null,c=[],u=null};return{sync(m,h){let g=m.filter(e=>e.freezeEnd>e.freezeStart);if(t===null||!g.length||!h){a.forEach(f),a=new Set,p();return}s!==h&&(s?.removeAttribute(`data-${n}`),s=h,s.setAttribute(`data-${n}`,``)),r?(c=g,u=h,d()):(o||(o=new CSSStyleSheet,document.adoptedStyleSheets=[...document.adoptedStyleSheets,o]),o.replaceSync(E(n,g)));let _=Array.from(e.querySelectorAll(t));_.forEach(e=>{let t=i.get(e);t?a.has(e)&&(e.style.scrollMarginTop=t.inline):i.set(e,{inline:e.style.scrollMarginTop})});let v=g.map((e,t)=>`var(--${n}-c${t}, 0px)`).join(` + `);_.forEach(e=>{let t=parseFloat(getComputedStyle(e).scrollMarginTop)||0,n=0;g.forEach(t=>{l(t.trigger,e)>=0||(n+=t.freezeEnd-t.freezeStart)}),e.style.scrollMarginTop=`calc(${t}px + var(--sst-scroll-margin-top-offset, 0px) + ${v} - ${n}px)`});let y=new Set(_);a.forEach(e=>{y.has(e)||f(e)}),a=y},restore(){r&&window.removeEventListener(`scroll`,d),a.forEach(f),a=new Set,p()}}},O=e=>{for(let t=1;t<e.length;t+=1)if(l(e[t-1].trigger,e[t].trigger)>0)return!0;return!1},k=(e,t)=>{t.sort((e,t)=>l(e.trigger,t.trigger));for(let e of t)e.kind===`cover`&&(e.wrapper=h(e.trigger));let n=e,r=null;for(let e of t){if(e.kind!==`scene`)continue;let t=m(n);e.container=t.container,e.wrapper=t.wrapper,e.padding=t.padding,n=t.container,r=t.container}return r},A=(e,t,n)=>{n&&(n.parentNode?.insertBefore(e,n),n.remove());for(let e=t.length-1;e>=0;--e){let n=t[e];n.kind===`cover`&&n.wrapper&&g(n.wrapper)}t.forEach(e=>{e.wrapper=null,e.kind===`scene`&&(e.container=null,e.padding=null)})},j=e=>typeof e==`function`?e():e,M={top:0,center:.5,bottom:1},N=(e,t,n,r)=>{let i=n===`%`?parseFloat(t)/100*r:parseFloat(t);return e?.startsWith(`-`)?-i:i},P=/^(top|center|bottom|[+-]?(?:\d+(?:\.\d*)?|\.\d+))?(%|px)?(?:([+-]=?)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/,F=(e,t)=>{let n=P.exec(e);if(!n||!n[1]&&!n[3])throw W.test(e)?Error(`StickyScrollTrigger: unsupported position clause "${e}": 'max' is GSAP's end-only keyword for the scroller's maximum scroll position.`):Error(`StickyScrollTrigger: unsupported position clause "${e}"`);let[,r,i,a,o,s]=n;if(r!==void 0&&a&&!a.includes(`=`)){let t=`${r}${i??``}${a}=${o}${s??``}`;throw Error(`StickyScrollTrigger: unsupported position clause "${e}": a signed offset needs an explicit '=' when it follows a keyword or number (GSAP needs it to tell "${r}" from the offset). Did you mean "${t}"?`)}let c=r!==void 0&&r in M,l=i===`%`;return{fraction:c?M[r]:l?parseFloat(r)/100:0,offsetPx:(!c&&!l&&r!==void 0?parseFloat(r):0)+(a?N(a,o,s,t):0)}},I=e=>typeof e==`number`||e.trim()!==``&&!Number.isNaN(Number(e)),L=e=>typeof e==`number`?e:Number(e),R=e=>{if(!e.startsWith(`clamp(`))return;let t=e.slice(6).replace(/\)$/,``).trim();throw Error(`StickyScrollTrigger: unsupported position clause "${e}": GSAP's clamp() wrapper isn't supported here.`+(t?` Did you mean "${t}"?`:``))},z=(e,t,n)=>{let r=e.trim();R(r);let[i,a=`top`]=r.split(/\s+/),o=F(i,t),s=F(a,n);return n*s.fraction+s.offsetPx-(t*o.fraction+o.offsetPx)},B=/^\+=(\d+(?:\.\d*)?|\.\d+)(%|px)?$/,V=e=>typeof e==`string`&&B.test(e.trim()),H=(e,t)=>{if(typeof t!=`string`)return t;let n=t.trim();if(!n.startsWith(`+=`)||!/\s/.test(n))return t;let r=j(e);if(typeof r!=`string`)return t;let i=r.trim();R(i);let[a]=i.split(/\s+/);try{F(a,0)}catch(e){if(!I(r))throw e;return t}if(F(n.split(/\s+/)[0],0),a.includes(`=`))throw Error(`StickyScrollTrigger: end "${t}" can't be resolved against start "${r}": GSAP reads an end that starts with '+=' and holds a space by prefixing it with the start clause's element token, and "${a}" carries an offset of its own, which GSAP resolves by discarding the end's. Give end a complete position clause instead, such as 'top+=100 bottom'.`);return a+n},U=(e,t)=>{let n=B.exec(String(e).trim());if(!n)throw Error(`StickyScrollTrigger: unsupported end format "${e}"`);let[,r,i]=n;return N(void 0,r,i,t)},W=/^max(?:([+-]=)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/,G=e=>typeof e==`string`&&W.test(e.trim()),K=(e,t)=>{let n=W.exec(e.trim());if(!n)throw Error(`StickyScrollTrigger: unsupported max-position format "${e}"`);let[,r,i,a]=n;return r?N(r,i,a,t):0},q=e=>typeof e==`number`?{kind:`absolute`,value:e}:V(e)?{kind:`dwell`,value:e}:G(e)?{kind:`max`,value:e}:I(e)?{kind:`absolute`,value:L(e)}:{kind:`clause`,value:e},J=(e,t,n,r,i)=>{let a=0;return e.forEach((e,o)=>{if(o===i||e.triggerTop>=r)return;let s=t[o]===void 0?n?n.paddings[o]:null:t[o];s!=null&&(a+=s)}),a},Y=(e,{viewportHeight:t,structureTop:n,documentMaxScroll:r,measureLiveEndTriggerTop:i},a)=>{let o=[],s=[],c=0;return{plans:e.map((l,u)=>{let d=l.triggerTop+c,f=l.start.mode===`absolute`?l.start.value:d-l.start.anchorOffset,p;switch(l.end.mode){case`auto`:if(l.start.mode!==`clause`)throw Error(`StickyScrollTrigger: internal error: an absolute start reached 'auto' end mode, which resolveStartSpec should have already rejected.`);p=f+Math.max(0,l.start.anchorOffset+(l.coverTop-l.triggerTop));break;case`dwell`:p=f+l.end.distancePx;break;case`absolute`:p=Math.max(f,l.end.value);break;case`max`:p=Math.max(f,r+l.end.offsetPx);break;case`clause`:{let n;if(l.endTriggerIsSelf)n=d;else{let t=l.endTriggerIndex===null?void 0:o[l.endTriggerIndex]===void 0?a?a.naturalTops[l.endTriggerIndex]:void 0:o[l.endTriggerIndex];n=t===void 0?l.end.measureLive?i(u):l.end.rawTop===null?0:l.end.rawTop+J(e,s,a,l.end.rawTop,u):t}let r=z(l.end.clause,l.endTriggerHeight,t);p=Math.max(f,n-r);break}}let m;if(l.kind===`cover`){if(l.start.mode!==`clause`)throw Error(`StickyScrollTrigger: internal error: a cover layer measurement carries an absolute start, which resolveStartSpec should have already rejected.`);m={freezeStart:f,freezeEnd:p,stickyTop:l.start.anchorOffset-(l.triggerTop-l.wrapperTop),paddingHeight:null}}else m={freezeStart:f,freezeEnd:p,stickyTop:n-f,paddingHeight:Math.max(0,p-f)};return m.paddingHeight!==null&&(c+=m.paddingHeight),o[u]=d,s[u]=m.paddingHeight,m}),naturalTops:o}},X=(e,t)=>{let n=e.some((e,t)=>e.end.mode!==`clause`||e.endTriggerIsSelf?!1:e.endTriggerIndex===null?e.end.rawTop!==null:e.endTriggerIndex>=t),r=new Map,i={...t,measureLiveEndTriggerTop:e=>{let n=r.get(e);if(n!==void 0)return n;let i=t.measureLiveEndTriggerTop(e);return r.set(e,i),i}},{plans:a,naturalTops:o}=Y(e,i,null);if(n)for(let t=0;t<e.length;t+=1){let n={paddings:a.map(e=>e.paddingHeight),naturalTops:o},r=Y(e,i,n),s=r.plans.every((e,t)=>e.paddingHeight===a[t].paddingHeight);if(a=r.plans,o=r.naturalTops,s)break;if(t===e.length-1)throw Error(`StickyScrollTrigger: could not resolve endTrigger positions: some endTrigger references form a circular structural dependency, each layer's end depending on a layer whose own end depends back on it. Point each endTrigger at a layer that doesn't depend on it.`)}return a.forEach((e,n)=>t.onPlanned(n,e)),a},Z=(e,t,n,a,o,s)=>{if(a===null)return{mode:`auto`};let c=q(a);switch(c.kind){case`dwell`:return{mode:`dwell`,distancePx:Math.max(0,U(c.value,t))};case`absolute`:return{mode:`absolute`,value:c.value};case`max`:if(n.kind!==`cover`)throw Error(`StickyScrollTrigger: createStickyTrigger's trigger ${r(n.trigger)} has end "${a}". GSAP's 'max' keyword isn't supported here: the layer's own dwell padding adds to the document's max scroll position, so the freeze window would depend on itself. Use createOverlapScroll, which adds no padding, or a dwell distance such as '+=500'.`);return{mode:`max`,offsetPx:K(c.value,t)};case`clause`:{if(n.kind!==`cover`&&s!==null&&s>o)throw Error(`StickyScrollTrigger: createStickyTrigger's trigger ${r(n.trigger)}'s endTrigger (${r(n.endTrigger)}) refers to a layer positioned later in DOM order, which isn't supported: this layer's own dwell padding pushes that one down, so the freeze window would depend on its own dwell. Point endTrigger at a layer earlier in DOM order, or use a dwell distance such as '+=500'.`);let t=s===null,a=e.contains(n.endTrigger);if(t&&!a&&n.kind!==`cover`)throw Error(`StickyScrollTrigger: createStickyTrigger's trigger ${r(n.trigger)} has an endTrigger (${r(n.endTrigger)}) outside the shared container: the layer's own dwell keeps pushing it away, so the freeze window never settles. Point endTrigger at an element inside the container, or use a dwell distance such as '+=500'.`);return{mode:`clause`,clause:c.value,rawTop:t&&a?i(n.endTrigger):null,measureLive:t&&!a}}}},Q=(e,t,n,i)=>{let a=q(t);switch(a.kind){case`absolute`:if(e.kind===`cover`)throw Error(`StickyScrollTrigger: createOverlapScroll's trigger ${r(e.trigger)} has start "${t}", an absolute scroll position (GSAP reads any bare number this way). That isn't supported here: a cover layer's sticky position is computed relative to its own wrapper, so start must be a position clause such as 'bottom bottom'.`);return{mode:`absolute`,value:a.value};case`max`:case`dwell`:case`clause`:return{mode:`clause`,anchorOffset:z(a.value,n,i)}}},$=(e,t,n,r,a)=>{let o=j(n.start),s=n.end===null?null:H(o,j(n.end)),l=c(n.trigger),u=n.endTrigger===n.trigger,d=a.get(n.endTrigger)??null,f=Z(e,t,n,s,r,d),p=Q(n,o,l,t);return{kind:n.kind,start:p,triggerTop:i(n.trigger),wrapperTop:n.wrapper?i(n.wrapper):0,coverTop:n.kind===`cover`?i(n.cover):0,end:f,endTriggerIsSelf:u,endTriggerIndex:d,endTriggerHeight:f.mode===`clause`?c(n.endTrigger):0}},ee=[`trigger`,`start`,`end`,`endTrigger`,`pin`,`pinSpacing`,`anticipatePin`,`pinnedContainer`,`pinReparent`,`pinSpacer`,`pinType`,`horizontal`,`scroller`,`containerAnimation`],te=e=>{let t=e=>{if(!Number.isFinite(e))throw Error(`StickyScrollTrigger: createStickyPin's top must be a finite number, got ${e}.`);return`top ${e}px`};return typeof e==`function`?()=>t(e()):t(e)},ne=(e,t,n,r)=>{switch(t.kind){case`dwell`:return n+U(t.value,r);case`absolute`:return t.value;case`clause`:return i(e)-z(t.value,c(e),r)}},re=(e,t)=>e.some(e=>e.trigger===t);var ie=class{#e;#t=[];#n=[];#r=new WeakMap;#i=!1;#a=!1;#o=null;#s=!1;#c=!1;#l=null;#u=[];#d;constructor(t,n={}){this.#e=e(t);let r=n.scrollMarginTargets===void 0?`[id]`:n.scrollMarginTargets;if(r!==null)try{this.#e.querySelectorAll(r)}catch{throw Error(`StickyScrollTrigger: scrollMarginTargets "${r}" is not a valid CSS selector.`)}this.#d=D(this.#e,r)}#f(){this.#i&&=(A(this.#e,this.#n,this.#o),this.#o=null,!1)}#p(){this.#o=k(this.#e,this.#t),this.#n=[...this.#t],this.#i=!0,this.#a=!1}#m(){this.#c||this.#s||(this.#c=!0,queueMicrotask(()=>{this.#c=!1,!this.#s&&(this.refresh(),typeof this.#l?.refresh==`function`&&this.#l.refresh())}))}#h(e){this.#s||(this.#l=e.constructor)}#g(e){return t=>{this.#h(t);let n=e?.(t);try{this.refresh()}catch(e){queueMicrotask(()=>{throw e})}return n}}#_(){this.#u.forEach(e=>{if(e.outer)return;e.savedPosition=f(e.trigger);let t=_(e.trigger);e.outer=t.outer,e.inner=t.inner})}#v(){let e=this.#u.flatMap(({outer:e,inner:t})=>e&&t?[{outer:e,inner:t,range:t.style.height}]:[]);e.forEach(({outer:e,inner:t})=>{e.style.height=``,t.style.height=``});let t=e.map(({outer:e})=>c(e));e.forEach(({outer:e},n)=>{e.style.height=`${t[n]}px`}),e.forEach(({inner:e,range:t})=>{e.style.height=t})}#y(e){return e.outer?(v(e.outer,e.trigger,e.savedPosition),e.outer=null,e.inner=null,!0):!1}#b(){let e=this.#t.map(e=>e.wrapper).filter(e=>e!==null).map(e=>({wrapper:e,position:e.style.position,top:e.style.top}));return e.forEach(({wrapper:e})=>u(e)),()=>{e.forEach(({wrapper:e,position:t,top:n})=>{e.style.position=t,e.style.top=n})}}#x(){let e=this.#u.map(e=>({layer:e,position:f(e.trigger),height:e.inner?e.inner.style.height:``}));return e.forEach(({layer:e})=>{u(e.trigger),e.inner&&(e.inner.style.height=``)}),()=>{e.forEach(({layer:e,position:t,height:n})=>{p(e.trigger,t),e.inner&&(e.inner.style.height=n)})}}#S(e){if(!this.#u.length)return;let t=this.#b(),n=this.#x();try{this.#C(e)}catch(e){throw n(),e}finally{t()}}#C(e){this.#u.forEach(t=>{if(!t.inner)return;let n=j(t.start),r=H(n,j(t.end)),a=q(r);if(a.kind===`max`)throw Error(`StickyScrollTrigger: createStickyPin's end "${r}" uses GSAP's 'max' keyword, which isn't supported here: the pin's own spacer height adds to the document's max scroll position, so it would depend on itself. Use a position clause against endTrigger, such as 'top top'.`);let o=i(t.trigger),s=c(t.trigger),l=q(n);if(l.kind===`absolute`)throw Error(`StickyScrollTrigger: createStickyPin's start "${n}" is an absolute scroll position (GSAP reads any bare number this way). A pin can't act on one: it engages when position:sticky engages, so start says where trigger sits in the viewport while pinned. Use the top option (top: ${n}) for a px distance from the viewport's top edge, or a position clause such as 'top top'.`);let u=z(l.value,s,e),f=ne(t.endTrigger,a,o-u,e)-o+u+s;d(t.trigger,u),t.inner.style.height=`${Math.max(0,f)}px`})}#w(e){if(!this.#t.length)return;let t=this.#t.filter(e=>e.wrapper!==null);if(!t.length)return;let n=this.#b();try{this.#T(e,t)}catch(e){throw n(),e}}#T(e,t){let n=this.#o?i(this.#o):0,r=new Map;t.forEach((e,t)=>{r.set(e.trigger,t)});let a=t.map((t,n)=>$(this.#e,e,t,n,r)),s=0,c=()=>X(a,{viewportHeight:e,structureTop:n,documentMaxScroll:s,measureLiveEndTriggerTop:e=>i(t[e].endTrigger),onPlanned:(e,n)=>{let r=t[e];r.freezeStart=n.freezeStart,r.freezeEnd=n.freezeEnd,r.wrapper&&(d(r.wrapper,n.stickyTop),r.kind===`scene`&&r.padding&&n.paddingHeight!==null&&(r.padding.style.height=`${n.paddingHeight}px`))}});c();let l=a.some(e=>e.end.mode===`clause`&&e.end.measureLive),u=a.some(e=>e.end.mode===`max`);u&&(s=o(e)),(l||u)&&c()}refresh(){if(this.#s)return;(this.#a||!this.#i||O(this.#t))&&(this.#f(),this.#p()),this.#D();try{this.#_(),this.#v()}finally{this.#O()}let e=this.#t.length||this.#u.length?a():0;this.#w(e),this.#S(e),this.#k()}#E(){return this.#t.filter(e=>e.kind===`cover`)}#D(){this.#E().forEach(e=>this.#r.get(e)?.())}#O(){this.#E().forEach(e=>{let t=this.#u.find(({trigger:t})=>t===e.cover);this.#r.set(e,x(t?.outer??e.cover))})}#k(){this.#d.sync(this.#t.filter(e=>e.kind===`scene`).map(({trigger:e,freezeStart:t,freezeEnd:n})=>({trigger:e,freezeStart:t,freezeEnd:n})),this.#o)}#A(e,t){let n=ee.filter(t=>t in e);if(n.length!==0)throw Error(`${t}: ${n.join(`, `)} ${n.length>1?`are`:`is`} not supported here; this module handles pinning and the scroll axis itself.`)}#j(e,t,n){if(re(e,t))throw Error(n)}#M(e,t){if(e===this.#e)throw Error(`${t}: trigger ${r(e)} is the shared container itself. Point trigger at an element inside the container.`);if(!this.#e.contains(e))throw Error(`${t}: trigger ${r(e)} is outside the shared container. Point trigger at an element inside it, or use createStickyPin, which works on either side.`)}#N(e,t){if(!e.contains(this.#e))return;let n=e===this.#e?`is the shared container itself`:`is an ancestor of the shared container`;throw Error(`${t}: trigger ${r(e)} ${n}. A pin makes trigger itself position:sticky inside a box holding the pin range, so the container and every layer's dwell padding would be pinned along with it. Pin an element that doesn't contain the container.`)}#P(e,t,n){if(this.#s)throw Error(`StickyScrollTrigger: cannot register a new layer after destroy() has been called.`);return this.#j(this.#t,e.trigger,`StickyScrollTrigger: ${r(e.trigger)} is already registered as a trigger for another layer. Each element can be used once per controller instance, across createStickyTrigger and createOverlapScroll: reusing one makes endTrigger resolution ambiguous.`),this.#j(this.#u,e.trigger,`StickyScrollTrigger: ${r(e.trigger)} is already registered as a pin trigger (createStickyPin). Using the same element as both a Scene/Cover trigger and a pin trigger wraps it twice and produces conflicting position:sticky behavior.`),this.#t.push(e),this.#a=!0,{...n,trigger:e.trigger,start:()=>e.freezeStart,end:()=>e.freezeEnd||.001,invalidateOnRefresh:n.invalidateOnRefresh??!0,onKill:n=>{this.#h(n);let r=this.#t.indexOf(e);r!==-1&&this.#t.splice(r,1),this.#a=!0,this.#m(),t?.(n)},onRefreshInit:this.#g(n.onRefreshInit)}}createStickyTrigger({trigger:e,start:r=`0 0`,end:i=`100% 0`,endTrigger:a,onKill:o,...s}){this.#A(s,`createStickyTrigger`);let c=t(e,`createStickyTrigger`);this.#M(c,`createStickyTrigger`);let l=n(c,a,`createStickyTrigger`);return this.#P({kind:`scene`,trigger:c,endTrigger:l,container:null,wrapper:null,padding:null,start:r,end:i,freezeStart:0,freezeEnd:0},o,s)}createOverlapScroll({trigger:e,cover:i,start:a=`bottom bottom`,end:o=null,endTrigger:s,onKill:c,...l}){this.#A(l,`createOverlapScroll`);let u=t(e,`createOverlapScroll`);this.#M(u,`createOverlapScroll`);let d=n(u,s,`createOverlapScroll`),f=i===void 0?u.nextElementSibling:t(i,`createOverlapScroll`);if(!(f instanceof HTMLElement))throw Error(`createOverlapScroll: cover element (trigger.nextElementSibling) not found for trigger ${r(u)}`);if(f.parentNode!==u.parentNode)throw Error(`createOverlapScroll: cover ${r(f)} must be a sibling of trigger `+r(u));let p={kind:`cover`,trigger:u,endTrigger:d,cover:f,wrapper:null,start:a,end:o,freezeStart:0,freezeEnd:0},m=this.#P(p,e=>{this.#r.get(p)?.(),c?.(e)},l);return this.#r.set(p,x(f)),m}createStickyPin({trigger:e,start:i,top:a,endTrigger:o,end:s=`bottom top`,onKill:c,...l}){if(this.#A(l,`createStickyPin`),this.#s)throw Error(`StickyScrollTrigger: cannot register a new pin after destroy() has been called.`);if(i!==void 0&&a!==void 0)throw Error(`StickyScrollTrigger: createStickyPin accepts either start or top, not both (top: 20 is start: 'top 20px'). Use top for a plain px distance from the viewport's top edge, start for anything else.`);let u=t(e,`createStickyPin`),d=n(u,o,`createStickyPin`);this.#N(u,`createStickyPin`),this.#j(this.#u,u,`StickyScrollTrigger: ${r(u)} is already registered as a pin trigger.`),this.#j(this.#t,u,`StickyScrollTrigger: ${r(u)} is already registered as a trigger for another layer (createStickyTrigger/createOverlapScroll). Using the same element as both a Scene/Cover trigger and a pin trigger wraps it twice and produces conflicting position:sticky behavior.`);let p={trigger:u,savedPosition:f(u),outer:null,inner:null,start:a===void 0?i??`top top`:te(a),endTrigger:d,end:s};return this.#u.push(p),{...l,trigger:u,onKill:e=>{this.#h(e);let t=this.#u.indexOf(p);t!==-1&&this.#u.splice(t,1),this.#y(p)&&this.#m(),c?.(e)},onRefreshInit:this.#g(l.onRefreshInit)}}resolveScrollPosition(e,n){let r=t(e,`resolveScrollPosition`),i=j(n),s=a(),c=q(i);switch(c.kind){case`max`:return o(s)+K(c.value,s);case`absolute`:return c.value;case`dwell`:case`clause`:return this.#F(r,c.value,s)}}#F(e,t,n){let r=0;this.#t.forEach(t=>{t.kind===`scene`&&(l(t.trigger,e)>=0||(r+=t.freezeEnd-t.freezeStart))});let a=z(t,c(e),n),o=this.#b(),s=i(e)+r-a;return o(),s}static getScrollTop(e,n){let r=t(e,`StickyScrollTrigger.getScrollTop`),a=n.find(e=>e.#e.contains(r));return a?a.resolveScrollPosition(r,`top top`):i(r)}createResolvedTrigger({trigger:e,start:r=`top bottom`,end:i=`bottom top`,endTrigger:o,...s}){this.#A(s,`createResolvedTrigger`);let c=t(e,`createResolvedTrigger`),l=n(c,o,`createResolvedTrigger`);return{...s,trigger:c,start:()=>this.resolveScrollPosition(c,r),end:()=>{let e=j(i),t=q(e);return t.kind===`dwell`?this.resolveScrollPosition(c,r)+U(t.value,a()):this.resolveScrollPosition(l,H(r,e))}}}destroy(){this.#s||(this.#s=!0,this.#d.restore(),this.#D(),this.#f(),this.#t.length=0,this.#n=[],this.#u.forEach(e=>this.#y(e)),this.#u.length=0,this.#l=null)}};export{ie as default};
|