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.7.0
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
@@ -52,6 +52,15 @@ var StickyScrollTrigger = (function() {
52
52
  const doc = document.documentElement;
53
53
  return Math.max(0, (doc.scrollHeight || document.body.scrollHeight) - viewportHeight);
54
54
  };
55
+ const measureBorderWidth = (borderStyle, width) => borderStyle === "none" || borderStyle === "hidden" ? 0 : parseFloat(width);
56
+ const measureUsedHeight = (el) => {
57
+ const rounded = el.offsetHeight;
58
+ const style = getComputedStyle(el);
59
+ const height = parseFloat(style.height);
60
+ if (!Number.isFinite(height)) return rounded;
61
+ const measured = style.boxSizing === "border-box" ? height : height + parseFloat(style.paddingTop) + parseFloat(style.paddingBottom) + measureBorderWidth(style.borderTopStyle, style.borderTopWidth) + measureBorderWidth(style.borderBottomStyle, style.borderBottomWidth);
62
+ return rounded > 0 && Math.abs(measured - rounded) >= 1 ? rounded : measured;
63
+ };
55
64
  const compareDocumentOrder = (a, b) => {
56
65
  const position = a.compareDocumentPosition(b);
57
66
  if (position & Node.DOCUMENT_POSITION_FOLLOWING) return -1;
@@ -113,7 +122,6 @@ var StickyScrollTrigger = (function() {
113
122
  if (!trigger.parentNode) throw new Error(`createStickyPin: trigger ${describeElement(trigger)} is not attached to the document`);
114
123
  const outer = document.createElement("div");
115
124
  const inner = document.createElement("div");
116
- outer.style.height = "0";
117
125
  outer.style.contain = "layout";
118
126
  trigger.parentNode.insertBefore(outer, trigger);
119
127
  outer.appendChild(inner);
@@ -191,8 +199,9 @@ var StickyScrollTrigger = (function() {
191
199
  declarations.push(`@supports (animation-timeline: scroll()) {[data-${instanceId}]{animation:${animations.join(",")};animation-timeline:${timelines.join(",")};animation-range:${ranges.join(",")}}}`);
192
200
  return declarations.join("");
193
201
  };
194
- const createScrollMarginSync = (rootElement) => {
202
+ const createScrollMarginSync = (rootElement, targetSelector) => {
195
203
  const instanceId = `sst${nextInstanceSuffix++}`;
204
+ const usesJsRamp = !usesCssRamp && targetSelector !== null;
196
205
  const snapshots = new WeakMap();
197
206
  let written = new Set();
198
207
  let sheet = null;
@@ -207,7 +216,7 @@ var StickyScrollTrigger = (function() {
207
216
  jsHost.style.setProperty(`--${instanceId}-c${index}`, `${consumed}px`);
208
217
  });
209
218
  };
210
- if (!usesCssRamp) window.addEventListener("scroll", applyJsRamp, { passive: true });
219
+ if (usesJsRamp) window.addEventListener("scroll", applyJsRamp, { passive: true });
211
220
  const restoreTarget = (target) => {
212
221
  const snapshot = snapshots.get(target);
213
222
  target.style.scrollMarginTop = snapshot ? snapshot.inline : "";
@@ -223,7 +232,7 @@ var StickyScrollTrigger = (function() {
223
232
  jsHost = null;
224
233
  };
225
234
  return {
226
- sync(scenes, host, targetSelector) {
235
+ sync(scenes, host) {
227
236
  const ramps = scenes.filter((scene) => scene.freezeEnd > scene.freezeStart);
228
237
  if (targetSelector === null || !ramps.length || !host) {
229
238
  written.forEach(restoreTarget);
@@ -236,7 +245,7 @@ var StickyScrollTrigger = (function() {
236
245
  animationHost = host;
237
246
  animationHost.setAttribute(`data-${instanceId}`, "");
238
247
  }
239
- if (!usesCssRamp) {
248
+ if (usesJsRamp) {
240
249
  jsRamps = ramps;
241
250
  jsHost = host;
242
251
  applyJsRamp();
@@ -270,7 +279,7 @@ var StickyScrollTrigger = (function() {
270
279
  written = next;
271
280
  },
272
281
  restore() {
273
- if (!usesCssRamp) window.removeEventListener("scroll", applyJsRamp);
282
+ if (usesJsRamp) window.removeEventListener("scroll", applyJsRamp);
274
283
  written.forEach(restoreTarget);
275
284
  written = new Set();
276
285
  clearAnimation();
@@ -327,7 +336,7 @@ var StickyScrollTrigger = (function() {
327
336
  const magnitude = unit === "%" ? parseFloat(value) / 100 * refSize : parseFloat(value);
328
337
  return sign?.startsWith("-") ? -magnitude : magnitude;
329
338
  };
330
- const CLAUSE_TOKEN_RE = /^(top|center|bottom|(?:\d+(?:\.\d*)?|\.\d+))?(%|px)?(?:([+-]=?)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/;
339
+ const CLAUSE_TOKEN_RE = /^(top|center|bottom|[+-]?(?:\d+(?:\.\d*)?|\.\d+))?(%|px)?(?:([+-]=?)(\d+(?:\.\d*)?|\.\d+)(%|px)?)?$/;
331
340
  const parseClauseToken = (token, refSize) => {
332
341
  const match = CLAUSE_TOKEN_RE.exec(token);
333
342
  if (!match || !match[1] && !match[3]) {
@@ -352,12 +361,14 @@ var StickyScrollTrigger = (function() {
352
361
  };
353
362
  const resolveAbsolute = (resolved) => typeof resolved === "number" ? resolved : Number(resolved);
354
363
  const CLAMP_PREFIX = "clamp(";
364
+ const assertNotClamped = (trimmed) => {
365
+ if (!trimmed.startsWith(CLAMP_PREFIX)) return;
366
+ const inner = trimmed.slice(6).replace(/\)$/, "").trim();
367
+ throw new Error(`StickyScrollTrigger: unsupported position clause "${trimmed}": GSAP's clamp() wrapper isn't supported here.` + (inner ? ` Did you mean "${inner}"?` : ""));
368
+ };
355
369
  const resolveAnchorTop = (position, elementHeight, viewportHeight) => {
356
370
  const trimmed = position.trim();
357
- if (trimmed.startsWith(CLAMP_PREFIX)) {
358
- const inner = trimmed.slice(6).replace(/\)$/, "").trim();
359
- throw new Error(`StickyScrollTrigger: unsupported position clause "${trimmed}": GSAP's clamp() wrapper isn't supported here.` + (inner ? ` Did you mean "${inner}"?` : ""));
360
- }
371
+ assertNotClamped(trimmed);
361
372
  const [elementToken, viewportToken = "top"] = trimmed.split(/\s+/);
362
373
  const elementClause = parseClauseToken(elementToken, elementHeight);
363
374
  const viewportClause = parseClauseToken(viewportToken, viewportHeight);
@@ -365,6 +376,25 @@ var StickyScrollTrigger = (function() {
365
376
  };
366
377
  const DWELL_RELATIVE_RE = /^\+=(\d+(?:\.\d*)?|\.\d+)(%|px)?$/;
367
378
  const isDwellFormat = (resolved) => typeof resolved === "string" && DWELL_RELATIVE_RE.test(resolved.trim());
379
+ const prefixSpacedRelativeEnd = (start, endResolved) => {
380
+ if (typeof endResolved !== "string") return endResolved;
381
+ const trimmedEnd = endResolved.trim();
382
+ if (!trimmedEnd.startsWith("+=") || !/\s/.test(trimmedEnd)) return endResolved;
383
+ const startResolved = resolveMaybeFn(start);
384
+ if (typeof startResolved !== "string") return endResolved;
385
+ const trimmedStart = startResolved.trim();
386
+ assertNotClamped(trimmedStart);
387
+ const [elementToken] = trimmedStart.split(/\s+/);
388
+ try {
389
+ parseClauseToken(elementToken, 0);
390
+ } catch (error) {
391
+ if (!isAbsoluteFormat(startResolved)) throw error;
392
+ return endResolved;
393
+ }
394
+ parseClauseToken(trimmedEnd.split(/\s+/)[0], 0);
395
+ 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'.`);
396
+ return elementToken + trimmedEnd;
397
+ };
368
398
  const resolveDwell = (resolved, viewportHeight) => {
369
399
  const match = DWELL_RELATIVE_RE.exec(String(resolved).trim());
370
400
  if (!match) throw new Error(`StickyScrollTrigger: unsupported end format "${resolved}"`);
@@ -379,6 +409,28 @@ var StickyScrollTrigger = (function() {
379
409
  const [, sign, value, unit] = match;
380
410
  return sign ? signedPx(sign, value, unit, viewportHeight) : 0;
381
411
  };
412
+ const classifyPosition = (resolved) => {
413
+ if (typeof resolved === "number") return {
414
+ kind: "absolute",
415
+ value: resolved
416
+ };
417
+ if (isDwellFormat(resolved)) return {
418
+ kind: "dwell",
419
+ value: resolved
420
+ };
421
+ if (isMaxFormat(resolved)) return {
422
+ kind: "max",
423
+ value: resolved
424
+ };
425
+ if (isAbsoluteFormat(resolved)) return {
426
+ kind: "absolute",
427
+ value: resolveAbsolute(resolved)
428
+ };
429
+ return {
430
+ kind: "clause",
431
+ value: resolved
432
+ };
433
+ };
382
434
  const gapsBeforeRawPosition = (measurements, paddingHeightsSoFar, previous, rawPosition, ownIndex) => {
383
435
  let total = 0;
384
436
  measurements.forEach((measurement, i) => {
@@ -480,65 +532,59 @@ var StickyScrollTrigger = (function() {
480
532
  plans.forEach((plan, index) => deps.onPlanned(index, plan));
481
533
  return plans;
482
534
  };
483
- const EXCLUDED_VAR_KEYS = [
484
- "trigger",
485
- "start",
486
- "end",
487
- "endTrigger",
488
- "pin",
489
- "pinSpacing",
490
- "anticipatePin",
491
- "pinnedContainer",
492
- "pinReparent",
493
- "pinSpacer",
494
- "pinType",
495
- "horizontal",
496
- "scroller",
497
- "containerAnimation"
498
- ];
499
535
  const resolveEndSpec = (rootElement, viewportHeight, layer, endResolved, ownIndex, endTriggerIndex) => {
500
536
  if (endResolved === null) return { mode: "auto" };
501
- if (isDwellFormat(endResolved)) return {
502
- mode: "dwell",
503
- distancePx: Math.max(0, resolveDwell(endResolved, viewportHeight))
504
- };
505
- if (isAbsoluteFormat(endResolved)) return {
506
- mode: "absolute",
507
- value: resolveAbsolute(endResolved)
508
- };
509
- if (isMaxFormat(endResolved)) {
510
- 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'.`);
511
- return {
512
- mode: "max",
513
- offsetPx: resolveMaxOffset(endResolved, viewportHeight)
537
+ const classified = classifyPosition(endResolved);
538
+ switch (classified.kind) {
539
+ case "dwell": return {
540
+ mode: "dwell",
541
+ distancePx: Math.max(0, resolveDwell(classified.value, viewportHeight))
542
+ };
543
+ case "absolute": return {
544
+ mode: "absolute",
545
+ value: classified.value
514
546
  };
547
+ case "max":
548
+ 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'.`);
549
+ return {
550
+ mode: "max",
551
+ offsetPx: resolveMaxOffset(classified.value, viewportHeight)
552
+ };
553
+ case "clause": {
554
+ 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'.`);
555
+ const unregistered = endTriggerIndex === null;
556
+ const insideRoot = rootElement.contains(layer.endTrigger);
557
+ 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'.`);
558
+ return {
559
+ mode: "clause",
560
+ clause: classified.value,
561
+ rawTop: unregistered && insideRoot ? documentTop(layer.endTrigger) : null,
562
+ measureLive: unregistered && !insideRoot
563
+ };
564
+ }
515
565
  }
516
- 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'.`);
517
- const unregistered = endTriggerIndex === null;
518
- const insideRoot = rootElement.contains(layer.endTrigger);
519
- 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'.`);
520
- return {
521
- mode: "clause",
522
- clause: endResolved,
523
- rawTop: unregistered && insideRoot ? documentTop(layer.endTrigger) : null,
524
- measureLive: unregistered && !insideRoot
525
- };
526
566
  };
527
567
  const resolveStartSpec = (layer, startResolved, elementHeight, viewportHeight) => {
528
- if (!isAbsoluteFormat(startResolved)) return {
529
- mode: "clause",
530
- anchorOffset: resolveAnchorTop(startResolved, elementHeight, viewportHeight)
531
- };
532
- 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'.`);
533
- return {
534
- mode: "absolute",
535
- value: resolveAbsolute(startResolved)
536
- };
568
+ const classified = classifyPosition(startResolved);
569
+ switch (classified.kind) {
570
+ case "absolute":
571
+ 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'.`);
572
+ return {
573
+ mode: "absolute",
574
+ value: classified.value
575
+ };
576
+ case "max":
577
+ case "dwell":
578
+ case "clause": return {
579
+ mode: "clause",
580
+ anchorOffset: resolveAnchorTop(classified.value, elementHeight, viewportHeight)
581
+ };
582
+ }
537
583
  };
538
584
  const measureLayer = (rootElement, viewportHeight, layer, ownIndex, indexByTrigger) => {
539
585
  const startResolved = resolveMaybeFn(layer.start);
540
- const endResolved = layer.end === null ? null : resolveMaybeFn(layer.end);
541
- const elementHeight = layer.trigger.offsetHeight;
586
+ const endResolved = layer.end === null ? null : prefixSpacedRelativeEnd(startResolved, resolveMaybeFn(layer.end));
587
+ const elementHeight = measureUsedHeight(layer.trigger);
542
588
  const endTriggerIsSelf = layer.endTrigger === layer.trigger;
543
589
  const endTriggerIndex = indexByTrigger.get(layer.endTrigger) ?? null;
544
590
  const end = resolveEndSpec(rootElement, viewportHeight, layer, endResolved, ownIndex, endTriggerIndex);
@@ -552,9 +598,25 @@ var StickyScrollTrigger = (function() {
552
598
  end,
553
599
  endTriggerIsSelf,
554
600
  endTriggerIndex,
555
- endTriggerHeight: end.mode === "clause" ? layer.endTrigger.offsetHeight : 0
601
+ endTriggerHeight: end.mode === "clause" ? measureUsedHeight(layer.endTrigger) : 0
556
602
  };
557
603
  };
604
+ const EXCLUDED_VAR_KEYS = [
605
+ "trigger",
606
+ "start",
607
+ "end",
608
+ "endTrigger",
609
+ "pin",
610
+ "pinSpacing",
611
+ "anticipatePin",
612
+ "pinnedContainer",
613
+ "pinReparent",
614
+ "pinSpacer",
615
+ "pinType",
616
+ "horizontal",
617
+ "scroller",
618
+ "containerAnimation"
619
+ ];
558
620
  const topToStartClause = (top) => {
559
621
  const toClause = (value) => {
560
622
  if (!Number.isFinite(value)) throw new Error(`StickyScrollTrigger: createStickyPin's top must be a finite number, got ${value}.`);
@@ -562,6 +624,13 @@ var StickyScrollTrigger = (function() {
562
624
  };
563
625
  return typeof top === "function" ? () => toClause(top()) : toClause(top);
564
626
  };
627
+ const resolvePinReleaseTop = (endTrigger, classifiedEnd, engageTop, viewportHeight) => {
628
+ switch (classifiedEnd.kind) {
629
+ case "dwell": return engageTop + resolveDwell(classifiedEnd.value, viewportHeight);
630
+ case "absolute": return classifiedEnd.value;
631
+ case "clause": return documentTop(endTrigger) - resolveAnchorTop(classifiedEnd.value, measureUsedHeight(endTrigger), viewportHeight);
632
+ }
633
+ };
565
634
  const hasDuplicateTrigger = (list, trigger) => list.some((existing) => existing.trigger === trigger);
566
635
  var StickyScrollTrigger = class {
567
636
  #rootElement;
@@ -576,16 +645,15 @@ var StickyScrollTrigger = (function() {
576
645
  #scrollTriggerClass = null;
577
646
  #pinLayers = [];
578
647
  #scrollMarginSync;
579
- #scrollMarginTargets;
580
648
  constructor(root, options = {}) {
581
649
  this.#rootElement = resolveRoot(root);
582
- this.#scrollMarginSync = createScrollMarginSync(this.#rootElement);
583
- this.#scrollMarginTargets = options.scrollMarginTargets === void 0 ? "[id]" : options.scrollMarginTargets;
584
- if (this.#scrollMarginTargets !== null) try {
585
- this.#rootElement.querySelectorAll(this.#scrollMarginTargets);
650
+ const scrollMarginTargets = options.scrollMarginTargets === void 0 ? "[id]" : options.scrollMarginTargets;
651
+ if (scrollMarginTargets !== null) try {
652
+ this.#rootElement.querySelectorAll(scrollMarginTargets);
586
653
  } catch {
587
- throw new Error(`StickyScrollTrigger: scrollMarginTargets "${this.#scrollMarginTargets}" is not a valid CSS selector.`);
654
+ throw new Error(`StickyScrollTrigger: scrollMarginTargets "${scrollMarginTargets}" is not a valid CSS selector.`);
588
655
  }
656
+ this.#scrollMarginSync = createScrollMarginSync(this.#rootElement, scrollMarginTargets);
589
657
  }
590
658
  #unbuild() {
591
659
  if (!this.#built) return;
@@ -610,13 +678,20 @@ var StickyScrollTrigger = (function() {
610
678
  });
611
679
  }
612
680
  #captureScrollTriggerClass(self) {
681
+ if (this.#destroyed) return;
613
682
  this.#scrollTriggerClass = self.constructor;
614
683
  }
615
684
  #createAutoRefreshHandler(userOnRefreshInit) {
616
685
  return (self) => {
617
686
  this.#captureScrollTriggerClass(self);
618
687
  const result = userOnRefreshInit?.(self);
619
- this.refresh();
688
+ try {
689
+ this.refresh();
690
+ } catch (error) {
691
+ queueMicrotask(() => {
692
+ throw error;
693
+ });
694
+ }
620
695
  return result;
621
696
  };
622
697
  }
@@ -629,6 +704,24 @@ var StickyScrollTrigger = (function() {
629
704
  layer.inner = wrapped.inner;
630
705
  });
631
706
  }
707
+ #reservePinSpace() {
708
+ const wrapped = this.#pinLayers.flatMap(({ outer, inner }) => outer && inner ? [{
709
+ outer,
710
+ inner,
711
+ range: inner.style.height
712
+ }] : []);
713
+ wrapped.forEach(({ outer, inner }) => {
714
+ outer.style.height = "";
715
+ inner.style.height = "";
716
+ });
717
+ const reserved = wrapped.map(({ outer }) => measureUsedHeight(outer));
718
+ wrapped.forEach(({ outer }, index) => {
719
+ outer.style.height = `${reserved[index]}px`;
720
+ });
721
+ wrapped.forEach(({ inner, range }) => {
722
+ inner.style.height = range;
723
+ });
724
+ }
632
725
  #unwrapPinLayer(layer) {
633
726
  if (!layer.outer) return false;
634
727
  unwrapPin(layer.outer, layer.trigger, layer.savedPosition);
@@ -683,14 +776,16 @@ var StickyScrollTrigger = (function() {
683
776
  #refreshPinLayers(viewportHeight) {
684
777
  this.#pinLayers.forEach((layer) => {
685
778
  if (!layer.inner) return;
686
- const resolvedEnd = resolveMaybeFn(layer.end);
687
- 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'.`);
688
779
  const resolvedStart = resolveMaybeFn(layer.start);
780
+ const resolvedEnd = prefixSpacedRelativeEnd(resolvedStart, resolveMaybeFn(layer.end));
781
+ const classifiedEnd = classifyPosition(resolvedEnd);
782
+ 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'.`);
689
783
  const triggerTop = documentTop(layer.trigger);
690
- const triggerHeight = layer.trigger.offsetHeight;
691
- if (isAbsoluteFormat(resolvedStart)) 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'.`);
692
- const topPx = resolveAnchorTop(resolvedStart, triggerHeight, viewportHeight);
693
- const height = (isAbsoluteFormat(resolvedEnd) ? resolveAbsolute(resolvedEnd) : documentTop(layer.endTrigger) - resolveAnchorTop(resolvedEnd, layer.endTrigger.offsetHeight, viewportHeight)) - triggerTop + topPx + triggerHeight;
784
+ const triggerHeight = measureUsedHeight(layer.trigger);
785
+ const classifiedStart = classifyPosition(resolvedStart);
786
+ 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'.`);
787
+ const topPx = resolveAnchorTop(classifiedStart.value, triggerHeight, viewportHeight);
788
+ const height = resolvePinReleaseTop(layer.endTrigger, classifiedEnd, triggerTop - topPx, viewportHeight) - triggerTop + topPx + triggerHeight;
694
789
  applyStickyPosition(layer.trigger, topPx);
695
790
  layer.inner.style.height = `${Math.max(0, height)}px`;
696
791
  });
@@ -744,6 +839,7 @@ var StickyScrollTrigger = (function() {
744
839
  this.#restoreCoverLifts();
745
840
  try {
746
841
  this.#wrapUnwrappedPins();
842
+ this.#reservePinSpace();
747
843
  } finally {
748
844
  this.#liftCovers();
749
845
  }
@@ -769,7 +865,7 @@ var StickyScrollTrigger = (function() {
769
865
  trigger,
770
866
  freezeStart,
771
867
  freezeEnd
772
- })), this.#outermostContainer, this.#scrollMarginTargets);
868
+ })), this.#outermostContainer);
773
869
  }
774
870
  #assertNoExcludedVars(rest, context) {
775
871
  const found = EXCLUDED_VAR_KEYS.filter((key) => key in rest);
@@ -786,7 +882,7 @@ var StickyScrollTrigger = (function() {
786
882
  #assertTriggerNotEnclosingRoot(trigger, context) {
787
883
  if (!trigger.contains(this.#rootElement)) return;
788
884
  const relation = trigger === this.#rootElement ? "is the shared container itself" : "is an ancestor of the shared container";
789
- throw new Error(`${context}: trigger ${describeElement(trigger)} ${relation}. 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.`);
885
+ 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.`);
790
886
  }
791
887
  #registerLayer(layer, onKill, rest) {
792
888
  if (this.#destroyed) throw new Error("StickyScrollTrigger: cannot register a new layer after destroy() has been called.");
@@ -855,12 +951,12 @@ var StickyScrollTrigger = (function() {
855
951
  this.#coverRestoreByLayer.set(layer, liftAboveStickyWrapper(coverElement));
856
952
  return vars;
857
953
  }
858
- createStickyPin({ trigger: triggerInput, start, top, endTrigger: endTriggerInput, end = "top top", onKill, ...rest }) {
954
+ createStickyPin({ trigger: triggerInput, start, top, endTrigger: endTriggerInput, end = "bottom top", onKill, ...rest }) {
859
955
  this.#assertNoExcludedVars(rest, "createStickyPin");
860
956
  if (this.#destroyed) throw new Error("StickyScrollTrigger: cannot register a new pin after destroy() has been called.");
861
957
  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.");
862
958
  const trigger = resolveElement(triggerInput, "createStickyPin");
863
- const endTrigger = resolveElement(endTriggerInput, "createStickyPin");
959
+ const endTrigger = resolveEndTrigger(trigger, endTriggerInput, "createStickyPin");
864
960
  this.#assertTriggerNotEnclosingRoot(trigger, "createStickyPin");
865
961
  this.#assertTriggerAvailable(this.#pinLayers, trigger, `StickyScrollTrigger: ${describeElement(trigger)} is already registered as a pin trigger.`);
866
962
  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.`);
@@ -891,15 +987,22 @@ var StickyScrollTrigger = (function() {
891
987
  const element = resolveElement(elementInput, "resolveScrollPosition");
892
988
  const resolved = resolveMaybeFn(position);
893
989
  const viewportHeight = measureViewportHeight();
894
- if (isMaxFormat(resolved)) return measureDocumentMaxScroll(viewportHeight) + resolveMaxOffset(resolved, viewportHeight);
895
- if (isAbsoluteFormat(resolved)) return resolveAbsolute(resolved);
990
+ const classified = classifyPosition(resolved);
991
+ switch (classified.kind) {
992
+ case "max": return measureDocumentMaxScroll(viewportHeight) + resolveMaxOffset(classified.value, viewportHeight);
993
+ case "absolute": return classified.value;
994
+ case "dwell":
995
+ case "clause": return this.#resolveClauseScrollPosition(element, classified.value, viewportHeight);
996
+ }
997
+ }
998
+ #resolveClauseScrollPosition(element, clause, viewportHeight) {
896
999
  let gap = 0;
897
1000
  this.#layers.forEach((layer) => {
898
1001
  if (layer.kind !== "scene") return;
899
1002
  if (compareDocumentOrder(layer.trigger, element) >= 0) return;
900
1003
  gap += layer.freezeEnd - layer.freezeStart;
901
1004
  });
902
- const anchorOffset = resolveAnchorTop(resolved, element.offsetHeight, viewportHeight);
1005
+ const anchorOffset = resolveAnchorTop(clause, measureUsedHeight(element), viewportHeight);
903
1006
  const restoreSceneCoverStickyState = this.#resetSceneCoverStickyState();
904
1007
  const result = documentTop(element) + gap - anchorOffset;
905
1008
  restoreSceneCoverStickyState();
@@ -911,7 +1014,7 @@ var StickyScrollTrigger = (function() {
911
1014
  if (owner) return owner.resolveScrollPosition(element, "top top");
912
1015
  return documentTop(element);
913
1016
  }
914
- createResolvedTrigger({ trigger: triggerInput, start, end, endTrigger: endTriggerInput, ...rest }) {
1017
+ createResolvedTrigger({ trigger: triggerInput, start = "top bottom", end = "bottom top", endTrigger: endTriggerInput, ...rest }) {
915
1018
  this.#assertNoExcludedVars(rest, "createResolvedTrigger");
916
1019
  const trigger = resolveElement(triggerInput, "createResolvedTrigger");
917
1020
  const endTrigger = resolveEndTrigger(trigger, endTriggerInput, "createResolvedTrigger");
@@ -919,7 +1022,12 @@ var StickyScrollTrigger = (function() {
919
1022
  ...rest,
920
1023
  trigger,
921
1024
  start: () => this.resolveScrollPosition(trigger, start),
922
- end: () => this.resolveScrollPosition(endTrigger, end)
1025
+ end: () => {
1026
+ const resolvedEnd = resolveMaybeFn(end);
1027
+ const classifiedEnd = classifyPosition(resolvedEnd);
1028
+ if (classifiedEnd.kind === "dwell") return this.resolveScrollPosition(trigger, start) + resolveDwell(classifiedEnd.value, measureViewportHeight());
1029
+ return this.resolveScrollPosition(endTrigger, prefixSpacedRelativeEnd(start, resolvedEnd));
1030
+ }
923
1031
  };
924
1032
  }
925
1033
  destroy() {
@@ -932,6 +1040,7 @@ var StickyScrollTrigger = (function() {
932
1040
  this.#builtLayers = [];
933
1041
  this.#pinLayers.forEach((layer) => this.#unwrapPinLayer(layer));
934
1042
  this.#pinLayers.length = 0;
1043
+ this.#scrollTriggerClass = null;
935
1044
  }
936
1045
  };
937
1046
  return StickyScrollTrigger;
@@ -1,8 +1,8 @@
1
1
  /*!
2
2
  * @license
3
- * StickyScrollTrigger v0.7.0
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
- var StickyScrollTrigger=(function(){let 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}},b=0,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);return 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)}}})();
8
+ var StickyScrollTrigger=(function(){let 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}},S=0,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);return 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)}}})();