view-anchor 0.2.2 → 1.0.0-beta.0

package/dist/measure-loop.d.ts

@@ -1,24 +0,0 @@
-/**
- * Internal helper: animation-frame scheduling and deduplication loop for
- * `createSizeAdvertiser`.
- *
- * Coalesces resize triggers into a single requestAnimationFrame, drops
- * duplicate measurements, and manages disposal.
- */
-export interface MeasureLoop<T> {
-    schedule(): void;
-    emitNow(value: T): void;
-    setActive(on: boolean): void;
-    cancel(): void;
-    dispose(): void;
-}
-export declare function createMeasureLoop<T>(cfg: {
-    /**
-     * Produce the value to emit in the animation frame. Return null to skip
-     * the frame (e.g. for non-finite measurements).
-     */
-    produce: () => T | null;
-    same: (a: T, b: T) => boolean;
-    sink: import('./types.js').Publisher<T>;
-}): MeasureLoop<T>;
-//# sourceMappingURL=measure-loop.d.ts.map

package/dist/measure-loop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"measure-loop.d.ts","sourceRoot":"","sources":["../src/measure-loop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,IAAI,IAAI,CAAA;IAChB,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IACvB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,MAAM,IAAI,IAAI,CAAA;IACd,OAAO,IAAI,IAAI,CAAA;CAChB;AASD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE;IACxC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;IAC7B,IAAI,EAAE,OAAO,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;CACxC,GAAG,WAAW,CAAC,CAAC,CAAC,CAqEjB"}

package/dist/measure-loop.js

@@ -1,89 +0,0 @@
-/**
- * Internal helper: animation-frame scheduling and deduplication loop for
- * `createSizeAdvertiser`.
- *
- * Coalesces resize triggers into a single requestAnimationFrame, drops
- * duplicate measurements, and manages disposal.
- */
-// Terminal-state stand-ins for cfg.produce/same/sink so a retained handle's
-// dispose()d loop does not keep the original closures (or what they
-// captured) alive. Guarded call sites never actually reach these.
-const NOOP_PRODUCE = () => null;
-const NOOP_SAME = () => true;
-const NOOP_SINK = () => false;
-export function createMeasureLoop(cfg) {
-    let produce = cfg.produce;
-    let same = cfg.same;
-    let sink = cfg.sink;
-    let rafId = null;
-    let active = false;
-    let disposed = false;
-    let last = null;
-    let publicationRevision = 0;
-    const deliver = (value) => {
-        // A reentrant dispose() from produce()/same() (invoked by frame() just
-        // before this call) already cleared `last`; do not let this delivery
-        // attempt write over that terminal state.
-        if (disposed)
-            return false;
-        const previous = last;
-        const attempt = ++publicationRevision;
-        last = value;
-        try {
-            const accepted = sink(value) !== false;
-            // A reentrant dispose() during sink() already cleared `last`; do not
-            // resurrect the pre-dispose value over that terminal state.
-            if (!accepted && publicationRevision === attempt && !disposed)
-                last = previous;
-            return accepted;
-        }
-        catch (error) {
-            if (publicationRevision === attempt && !disposed)
-                last = previous;
-            throw error;
-        }
-    };
-    const cancel = () => {
-        if (rafId !== null) {
-            cancelAnimationFrame(rafId);
-            rafId = null;
-        }
-    };
-    const frame = () => {
-        rafId = null;
-        if (disposed || !active)
-            return;
-        const value = produce();
-        if (value === null)
-            return;
-        if (last !== null && same(value, last))
-            return;
-        deliver(value);
-    };
-    return {
-        schedule() {
-            if (disposed || !active || rafId !== null)
-                return;
-            rafId = requestAnimationFrame(frame);
-        },
-        emitNow(value) {
-            if (disposed)
-                return;
-            deliver(value);
-        },
-        setActive(on) {
-            active = on;
-        },
-        cancel,
-        dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            cancel();
-            produce = NOOP_PRODUCE;
-            same = NOOP_SAME;
-            sink = NOOP_SINK;
-            last = null;
-        },
-    };
-}

package/dist/size-advertiser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"size-advertiser.d.ts","sourceRoot":"","sources":["../src/size-advertiser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAQnB;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,qBAAqB,GAC1B,oBAAoB,CA8EtB"}

package/dist/size-advertiser.js

@@ -1,94 +0,0 @@
-import { watchAbort } from './abort.js';
-import { createMeasureLoop } from './measure-loop.js';
-// Replaces a disposed instance's publish callback so a retained handle does
-// not keep the caller's original callback (and whatever it captured) alive.
-const NOOP_PUBLISH = () => false;
-/**
- * Report content size for a single axis back to the host.
- *
- * Runs in a downstream document, reads the content size from
- * `ResizeObserverEntry.borderBoxSize` without triggering reflow, and
- * publishes updates through an animation frame loop (`createMeasureLoop`).
- *
- * Measurements are rounded to integer pixels and clamped to >= 0.
- *
- * Note: `target` should be a shrink-to-fit wrapper on the owned axis.
- * If its size is driven by the host view itself (such as `<body>` or `<html>`),
- * updates will not shrink back to content size.
- */
-export function createSizeAdvertiser(target, opts) {
-    const axis = opts.axis;
-    let publish = opts.publish;
-    let observer = null;
-    let disposed = false;
-    // Latest border-box recorded by the ResizeObserver callback.
-    let latest = null;
-    const produce = () => {
-        if (!latest)
-            return null;
-        const raw = axis === 'block' ? latest.blockSize : latest.inlineSize;
-        if (!Number.isFinite(raw))
-            return null;
-        return Math.max(0, Math.round(raw));
-    };
-    const loop = createMeasureLoop({
-        produce,
-        same: (a, b) => a === b,
-        sink: (extent) => publish({ axis, extent }),
-    });
-    const onResize = (entries) => {
-        // A callback queued before disconnect() can still fire once more; do not
-        // let it write `latest` after dispose() has already cleared it.
-        if (disposed)
-            return;
-        const entry = entries[entries.length - 1];
-        if (entry) {
-            latest = entry.borderBoxSize?.[0] ?? entry.contentBoxSize?.[0] ?? latest;
-        }
-        loop.schedule();
-    };
-    // Warn if measuring body or documentElement, whose size matches the view.
-    const doc = target.ownerDocument;
-    if (target === doc.body || target === doc.documentElement) {
-        console.warn(`[view-anchor] size-advertiser: <${target === doc.body ? 'body' : 'html'}>'s ` +
-            `${axis} size is the view size, not content size. The advertiser will ` +
-            `never shrink to content; measure a shrink-to-fit wrapper instead.`);
-    }
-    let removeAbortListener = () => { };
-    const dispose = () => {
-        if (disposed)
-            return;
-        disposed = true;
-        removeAbortListener();
-        removeAbortListener = () => { };
-        loop.cancel();
-        if (observer) {
-            observer.disconnect();
-            observer = null;
-        }
-        loop.dispose();
-        publish = NOOP_PUBLISH;
-        latest = null;
-    };
-    if (opts.signal?.aborted)
-        dispose();
-    else {
-        removeAbortListener = watchAbort(opts.signal, dispose);
-        loop.setActive(true);
-        observer = new ResizeObserver(onResize);
-        observer.observe(target);
-    }
-    return {
-        update(nextPublish) {
-            if (disposed)
-                return;
-            publish = nextPublish;
-            // Re-publish the current size to the new sink immediately so it is not
-            // empty until the next ResizeObserver tick.
-            const cur = produce();
-            if (cur !== null)
-                loop.emitNow(cur);
-        },
-        dispose,
-    };
-}

package/src/measure-loop.ts

@@ -1,101 +0,0 @@
-/**
- * Internal helper: animation-frame scheduling and deduplication loop for
- * `createSizeAdvertiser`.
- *
- * Coalesces resize triggers into a single requestAnimationFrame, drops
- * duplicate measurements, and manages disposal.
- */
-
-export interface MeasureLoop<T> {
-  schedule(): void
-  emitNow(value: T): void
-  setActive(on: boolean): void
-  cancel(): void
-  dispose(): void
-}
-
-// Terminal-state stand-ins for cfg.produce/same/sink so a retained handle's
-// dispose()d loop does not keep the original closures (or what they
-// captured) alive. Guarded call sites never actually reach these.
-const NOOP_PRODUCE = (): null => null
-const NOOP_SAME = (): true => true
-const NOOP_SINK = (): false => false
-
-export function createMeasureLoop<T>(cfg: {
-  /**
-   * Produce the value to emit in the animation frame. Return null to skip
-   * the frame (e.g. for non-finite measurements).
-   */
-  produce: () => T | null
-  same: (a: T, b: T) => boolean
-  sink: import('./types.js').Publisher<T>
-}): MeasureLoop<T> {
-  let produce = cfg.produce
-  let same = cfg.same
-  let sink = cfg.sink
-  let rafId: number | null = null
-  let active = false
-  let disposed = false
-  let last: T | null = null
-  let publicationRevision = 0
-
-  const deliver = (value: T): boolean => {
-    // A reentrant dispose() from produce()/same() (invoked by frame() just
-    // before this call) already cleared `last`; do not let this delivery
-    // attempt write over that terminal state.
-    if (disposed) return false
-    const previous = last
-    const attempt = ++publicationRevision
-    last = value
-    try {
-      const accepted = sink(value) !== false
-      // A reentrant dispose() during sink() already cleared `last`; do not
-      // resurrect the pre-dispose value over that terminal state.
-      if (!accepted && publicationRevision === attempt && !disposed) last = previous
-      return accepted
-    } catch (error) {
-      if (publicationRevision === attempt && !disposed) last = previous
-      throw error
-    }
-  }
-
-  const cancel = (): void => {
-    if (rafId !== null) {
-      cancelAnimationFrame(rafId)
-      rafId = null
-    }
-  }
-
-  const frame = (): void => {
-    rafId = null
-    if (disposed || !active) return
-    const value = produce()
-    if (value === null) return
-    if (last !== null && same(value, last)) return
-    deliver(value)
-  }
-
-  return {
-    schedule(): void {
-      if (disposed || !active || rafId !== null) return
-      rafId = requestAnimationFrame(frame)
-    },
-    emitNow(value: T): void {
-      if (disposed) return
-      deliver(value)
-    },
-    setActive(on: boolean): void {
-      active = on
-    },
-    cancel,
-    dispose(): void {
-      if (disposed) return
-      disposed = true
-      cancel()
-      produce = NOOP_PRODUCE
-      same = NOOP_SAME
-      sink = NOOP_SINK
-      last = null
-    },
-  }
-}

package/src/size-advertiser.ts

@@ -1,108 +0,0 @@
-import type {
-  AdvertisedSize,
-  Publisher,
-  SizeAdvertiserOptions,
-  SizeAdvertiserHandle,
-} from './types.js'
-import { watchAbort } from './abort.js'
-import { createMeasureLoop } from './measure-loop.js'
-
-// Replaces a disposed instance's publish callback so a retained handle does
-// not keep the caller's original callback (and whatever it captured) alive.
-const NOOP_PUBLISH = (): false => false
-
-/**
- * Report content size for a single axis back to the host.
- *
- * Runs in a downstream document, reads the content size from
- * `ResizeObserverEntry.borderBoxSize` without triggering reflow, and
- * publishes updates through an animation frame loop (`createMeasureLoop`).
- *
- * Measurements are rounded to integer pixels and clamped to >= 0.
- *
- * Note: `target` should be a shrink-to-fit wrapper on the owned axis.
- * If its size is driven by the host view itself (such as `<body>` or `<html>`),
- * updates will not shrink back to content size.
- */
-export function createSizeAdvertiser(
-  target: HTMLElement,
-  opts: SizeAdvertiserOptions,
-): SizeAdvertiserHandle {
-  const axis = opts.axis
-  let publish = opts.publish
-  let observer: ResizeObserver | null = null
-  let disposed = false
-  // Latest border-box recorded by the ResizeObserver callback.
-  let latest: ResizeObserverSize | null = null
-
-  const produce = (): number | null => {
-    if (!latest) return null
-    const raw = axis === 'block' ? latest.blockSize : latest.inlineSize
-    if (!Number.isFinite(raw)) return null
-    return Math.max(0, Math.round(raw))
-  }
-
-  const loop = createMeasureLoop<number>({
-    produce,
-    same: (a, b) => a === b,
-    sink: (extent) => publish({ axis, extent }),
-  })
-
-  const onResize: ResizeObserverCallback = (entries) => {
-    // A callback queued before disconnect() can still fire once more; do not
-    // let it write `latest` after dispose() has already cleared it.
-    if (disposed) return
-    const entry = entries[entries.length - 1]
-    if (entry) {
-      latest = entry.borderBoxSize?.[0] ?? entry.contentBoxSize?.[0] ?? latest
-    }
-    loop.schedule()
-  }
-
-  // Warn if measuring body or documentElement, whose size matches the view.
-  const doc = target.ownerDocument
-  if (target === doc.body || target === doc.documentElement) {
-    console.warn(
-      `[view-anchor] size-advertiser: <${target === doc.body ? 'body' : 'html'}>'s ` +
-        `${axis} size is the view size, not content size. The advertiser will ` +
-        `never shrink to content; measure a shrink-to-fit wrapper instead.`,
-    )
-  }
-
-  let removeAbortListener = (): void => {}
-
-  const dispose = (): void => {
-    if (disposed) return
-    disposed = true
-    removeAbortListener()
-    removeAbortListener = (): void => {}
-    loop.cancel()
-    if (observer) {
-      observer.disconnect()
-      observer = null
-    }
-    loop.dispose()
-    publish = NOOP_PUBLISH
-    latest = null
-  }
-
-  if (opts.signal?.aborted) dispose()
-  else {
-    removeAbortListener = watchAbort(opts.signal, dispose)
-    loop.setActive(true)
-    observer = new ResizeObserver(onResize)
-    observer.observe(target)
-  }
-
-  return {
-    update(nextPublish: Publisher<AdvertisedSize>): void {
-      if (disposed) return
-      publish = nextPublish
-      // Re-publish the current size to the new sink immediately so it is not
-      // empty until the next ResizeObserver tick.
-      const cur = produce()
-      if (cur !== null) loop.emitNow(cur)
-    },
-    dispose,
-  }
-}