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
@@ -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 (!usesCssRamp) window.addEventListener("scroll", applyJsRamp, { passive: true });
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, targetSelector) {
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 (!usesCssRamp) {
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 (!usesCssRamp) window.removeEventListener("scroll", applyJsRamp);
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
- if (trimmed.startsWith(CLAMP_PREFIX)) {
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
- if (isDwellFormat(endResolved)) return {
501
- mode: "dwell",
502
- distancePx: Math.max(0, resolveDwell(endResolved, viewportHeight))
503
- };
504
- if (isAbsoluteFormat(endResolved)) return {
505
- mode: "absolute",
506
- value: resolveAbsolute(endResolved)
507
- };
508
- if (isMaxFormat(endResolved)) {
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
- if (!isAbsoluteFormat(startResolved)) return {
528
- mode: "clause",
529
- anchorOffset: resolveAnchorTop(startResolved, elementHeight, viewportHeight)
530
- };
531
- 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'.`);
532
- return {
533
- mode: "absolute",
534
- value: resolveAbsolute(startResolved)
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.offsetHeight;
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.offsetHeight : 0
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
- this.#scrollMarginSync = createScrollMarginSync(this.#rootElement);
582
- this.#scrollMarginTargets = options.scrollMarginTargets === void 0 ? "[id]" : options.scrollMarginTargets;
583
- if (this.#scrollMarginTargets !== null) try {
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 "${this.#scrollMarginTargets}" is not a valid CSS selector.`);
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
- this.refresh();
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.offsetHeight;
690
- 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'.`);
691
- const topPx = resolveAnchorTop(resolvedStart, triggerHeight, viewportHeight);
692
- const height = (isAbsoluteFormat(resolvedEnd) ? resolveAbsolute(resolvedEnd) : documentTop(layer.endTrigger) - resolveAnchorTop(resolvedEnd, layer.endTrigger.offsetHeight, viewportHeight)) - triggerTop + topPx + triggerHeight;
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, this.#scrollMarginTargets);
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 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.`);
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 = "top top", onKill, ...rest }) {
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 = resolveElement(endTriggerInput, "createStickyPin");
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
- if (isMaxFormat(resolved)) return measureDocumentMaxScroll(viewportHeight) + resolveMaxOffset(resolved, viewportHeight);
894
- if (isAbsoluteFormat(resolved)) return resolveAbsolute(resolved);
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(resolved, element.offsetHeight, viewportHeight);
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: () => this.resolveScrollPosition(endTrigger, 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.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
- 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};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sticky-scroll-trigger",
3
- "version": "0.7.0",
3
+ "version": "0.9.0",
4
4
  "description": "A ScrollTrigger helper that uses native CSS position:sticky instead of GSAP pinning",
5
5
  "license": "MIT",
6
6
  "author": "Kuninori Ogino",