@fusion.dev/helix-core 0.56.1 → 0.57.0

package/dist/controllers/cue-controller/cue-controller.d.ts

@@ -0,0 +1,85 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/** One caption track, named as the menu names it. */
+export interface Caption {
+    label: string;
+    language: string;
+}
+/** A `<track>` as the consumer wrote it, reduced to what naming it needs. */
+interface TrackCopy {
+    attrs: Record<string, string>;
+    tag: string;
+}
+/**
+ * The tracks a reader could choose between, in the order they were written.
+ *
+ * Filtered by kind, because `textTracks` also carries `chapters`, `metadata`
+ * and `descriptions`, and a menu offering "Chapters" as a subtitle language
+ * would be offering something that draws no words. Read off the media element
+ * rather than off the slot: a `<track>` added later is in one and not the
+ * other, and the element is the one that has resolved them.
+ */
+export declare const captionTracks: (media: HTMLMediaElement | null) => TextTrack[];
+/**
+ * Shows one track and disables every other, or shows none at `-1`.
+ *
+ * Every other, rather than only the one that was on. Two tracks in `hidden`
+ * both fire `cuechange`, so the rendered cue becomes whichever fired last and
+ * a reader who switched language gets the two interleaved. Measured as two
+ * subtitles alternating line by line.
+ *
+ * `hidden`, never `showing`. Hidden is the mode where a track still fires
+ * `cuechange` and still fills `activeCues`, and the browser draws nothing,
+ * which is exactly what is wanted when something else is doing the drawing.
+ */
+export declare const showCaption: (tracks: readonly TextTrack[], index: number) => void;
+/**
+ * Whether a track the platform started showing is now ours to draw.
+ *
+ * A `<track default>` arrives `showing`, which is the browser drawing it.
+ * Moved to `hidden` so the cues keep coming and we draw them instead. What
+ * comes back is whether captions are on, which is not always "off": a button
+ * that began there reported the opposite of what was on screen.
+ */
+export declare const adoptTrack: (track: TextTrack) => boolean;
+/**
+ * The caption tracks among the copies, before the render that draws them.
+ *
+ * By the platform's own reading of `kind`, which is what makes a `<track>` a
+ * caption at all: missing is `subtitles` and anything it does not know is
+ * `metadata`. Read from the video's tracks after the render instead, the count
+ * arrived a render late and asked for one more. Choosing one still goes
+ * through the video's tracks, which hold them in the same order.
+ */
+export declare const captionsAmong: (media: readonly TrackCopy[]) => Caption[];
+/**
+ * The cue on screen now, as nodes, or nothing between cues.
+ *
+ * Nodes rather than a string, because `VTTCue.text` is the cue's *source*:
+ * WebVTT carries markup, and a caption file in the wild is full of it. `<v
+ * Hildy>` names who is speaking, `<b>` and `<i>` and `<u>` mark emphasis, and
+ * `<c.loud>` classes a line. Rendered as text every one of those arrives on
+ * screen as visible angle brackets.
+ *
+ * `getCueAsHTML` is the platform parsing its own format, so nothing here has
+ * to know the grammar and no cue text is ever treated as HTML: what comes
+ * back is a fragment the browser built, not a string anybody interpolated.
+ */
+export declare const activeCue: (track: TextTrack | undefined) => DocumentFragment | undefined;
+/**
+ * Listens to one track's cues at a time, so the next one can take it off.
+ *
+ * Taken off whatever it was on before adding it here. `follow` runs from
+ * `loadedmetadata`, which fires again for every source a reader moves to, and
+ * a consumer adding a `<track>` later gets another. Added without removing, a
+ * playlist of six left six listeners on tracks that between them fire for
+ * every cue in the video.
+ */
+export declare class CueController implements ReactiveController {
+    private readonly listener;
+    private track;
+    constructor(host: ReactiveControllerHost, listener: () => void);
+    follow(track: TextTrack): void;
+    hostDisconnected(): void;
+    private stop;
+}
+export {};

package/dist/controllers/cue-controller/cue-controller.js

@@ -0,0 +1,45 @@
+export const captionTracks = (media) => {
+    const tracks = media?.textTracks;
+    if (!tracks) {
+        return [];
+    }
+    return [...tracks].filter((one) => one.kind === 'subtitles' || one.kind === 'captions');
+};
+export const showCaption = (tracks, index) => {
+    tracks.forEach((track, at) => {
+        track.mode = at === index ? 'hidden' : 'disabled';
+    });
+};
+export const adoptTrack = (track) => {
+    if (track.mode === 'showing') {
+        track.mode = 'hidden';
+    }
+    return track.mode === 'hidden';
+};
+export const captionsAmong = (media) => media
+    .filter((one) => one.tag === 'track' &&
+    (one.attrs.kind === undefined ||
+        ['captions', 'subtitles'].includes(one.attrs.kind.toLowerCase())))
+    .map((one) => ({ label: one.attrs.label ?? '', language: one.attrs.srclang ?? '' }));
+export const activeCue = (track) => {
+    const active = track?.activeCues?.[0];
+    return active instanceof VTTCue ? active.getCueAsHTML() : undefined;
+};
+export class CueController {
+    constructor(host, listener) {
+        this.listener = listener;
+        host.addController(this);
+    }
+    follow(track) {
+        this.stop();
+        this.track = track;
+        track.addEventListener('cuechange', this.listener);
+    }
+    hostDisconnected() {
+        this.stop();
+    }
+    stop() {
+        this.track?.removeEventListener('cuechange', this.listener);
+        this.track = undefined;
+    }
+}

package/dist/controllers/fullscreen-controller/fullscreen-controller.d.ts

@@ -0,0 +1,32 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/**
+ * Into fullscreen and back, and honest about where the element is.
+ *
+ * The state follows `fullscreenchange` rather than the request, so a refused
+ * request leaves a button that correctly reports "not fullscreen".
+ *
+ * The document, rather than the host, is what the event is read from: the
+ * platform fires it at the document whichever element went full, so a host that
+ * asked and was overruled by another one still hears about it.
+ */
+export declare class FullscreenController implements ReactiveController {
+    private readonly host;
+    private readonly report;
+    constructor(host: ReactiveControllerHost & HTMLElement, report: (full: boolean) => void);
+    /**
+     * Into fullscreen and back, and quiet about being refused.
+     *
+     * `requestFullscreen` rejects rather than returning false, and the two
+     * refusals a consumer will actually meet are a Permissions Policy that does
+     * not grant `fullscreen` to the frame the player is in, and a call without
+     * user activation. Both are `TypeError: Permissions check failed`, which is
+     * the same message for two different causes.
+     *
+     * Caught rather than `void`ed, or a refusal becomes an unhandled rejection
+     * naming neither the element nor the reason.
+     */
+    toggle(): Promise<void>;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private readonly handleChange;
+}

package/dist/controllers/fullscreen-controller/fullscreen-controller.js

@@ -0,0 +1,28 @@
+export class FullscreenController {
+    constructor(host, report) {
+        this.host = host;
+        this.report = report;
+        this.handleChange = () => {
+            this.report(document.fullscreenElement === this.host);
+        };
+        host.addController(this);
+    }
+    async toggle() {
+        try {
+            if (document.fullscreenElement === this.host) {
+                await document.exitFullscreen();
+                return;
+            }
+            await this.host.requestFullscreen();
+        }
+        catch (error) {
+            console.warn(`<${this.host.localName}> could not enter fullscreen. If it is inside an iframe, that frame needs allow="fullscreen".`, error);
+        }
+    }
+    hostConnected() {
+        document.addEventListener('fullscreenchange', this.handleChange);
+    }
+    hostDisconnected() {
+        document.removeEventListener('fullscreenchange', this.handleChange);
+    }
+}

package/dist/controllers/idle-controller/idle-controller.d.ts

@@ -0,0 +1,35 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/**
+ * How long the reader has been still, which is what an overlay hides itself on.
+ *
+ * A wait rather than leaving with the pointer, or a reader moving across a
+ * surface to reach a control watches the control vanish under them. The wait is
+ * only ever about *idling*: whether anything else keeps the overlay up, a
+ * paused player or an open menu, is the host's decision, and this only says
+ * when the reader stopped.
+ *
+ * The delay is asked for on every restart rather than taken once, because it
+ * is a property the consumer can change while the video plays.
+ */
+export declare class IdleController implements ReactiveController {
+    private readonly delay;
+    private readonly report;
+    private timer;
+    constructor(host: ReactiveControllerHost, delay: () => number, report: (idle: boolean) => void);
+    /**
+     * Restarts the wait, on anything that counts as the reader being here.
+     *
+     * Pointer movement and focus both count, and both have to: a reader using the
+     * keyboard never moves a pointer, and a bar that only answered the mouse
+     * would leave them nothing to look at. Zero turns the wait off and the bar
+     * goes immediately; a large number keeps it up for as long as anyone is
+     * likely to look.
+     */
+    readonly stir: () => void;
+    /**
+     * Leaving is the one case that does not wait: the reader has gone somewhere
+     * else, and there is nothing to reach for.
+     */
+    readonly leave: () => void;
+    hostDisconnected(): void;
+}

package/dist/controllers/idle-controller/idle-controller.js

@@ -0,0 +1,24 @@
+export class IdleController {
+    constructor(host, delay, report) {
+        this.delay = delay;
+        this.report = report;
+        this.stir = () => {
+            this.report(false);
+            clearTimeout(this.timer);
+            const delay = this.delay();
+            if (delay > 0) {
+                this.timer = setTimeout(() => {
+                    this.report(true);
+                }, delay);
+            }
+        };
+        this.leave = () => {
+            clearTimeout(this.timer);
+            this.report(true);
+        };
+        host.addController(this);
+    }
+    hostDisconnected() {
+        clearTimeout(this.timer);
+    }
+}

package/dist/controllers/media-session-controller/media-session-controller.d.ts

@@ -0,0 +1,54 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/**
+ * How far a skip control moves, in seconds.
+ *
+ * Ten, which is the number every player that has one uses, and the number the
+ * platform names in `seekbackward` and `seekforward` when it hands over a
+ * default. A different length here would be correct only on this player.
+ */
+export declare const SKIP_SECONDS = 10;
+/** What a headset's buttons do, handed over by the player that owns them. */
+export interface SessionHandlers {
+    /**
+     * Asks for the next item, or `null` where the consumer has named nothing to
+     * skip to: the platform draws the key from whether a handler is set.
+     */
+    next: (() => void) | null;
+    /** And the previous one, under the same rule. */
+    previous: (() => void) | null;
+    seek: (seconds: number) => void;
+    skipBy: (seconds: number) => void;
+    toggle: () => void;
+}
+/**
+ * Holds the page's media session for one player, and tells the platform what
+ * is playing.
+ *
+ * The handlers are what make a headset's play, pause and skip work at all.
+ * Without them a platform falls back to guessing which element was meant,
+ * which is right often enough to hide the fault and wrong exactly when there
+ * are two.
+ */
+export declare class MediaSessionController implements ReactiveController {
+    private readonly host;
+    constructor(host: ReactiveControllerHost & HTMLElement);
+    /**
+     * Takes the session.
+     *
+     * On play rather than on render, which is the ownership rule: a page with two
+     * players gives the session to whichever one the reader started, so a
+     * headset's buttons land on what they are listening to rather than on
+     * whichever came first in the markup.
+     */
+    claim(metadata: {
+        artwork: string;
+        title: string;
+    }, handlers: SessionHandlers): void;
+    /** Tells the platform whether the owner is playing, and nothing if it is not the owner. */
+    report(playing: boolean): void;
+    /**
+     * The page's one media session goes back to nobody, but only if this
+     * element is the one holding it.
+     */
+    hostDisconnected(): void;
+}

package/dist/controllers/media-session-controller/media-session-controller.js

@@ -0,0 +1,49 @@
+let owner;
+export const SKIP_SECONDS = 10;
+export class MediaSessionController {
+    constructor(host) {
+        this.host = host;
+        host.addController(this);
+    }
+    claim(metadata, handlers) {
+        if (typeof navigator === 'undefined' || !navigator.mediaSession) {
+            return;
+        }
+        owner = this.host;
+        const session = navigator.mediaSession;
+        session.metadata = new MediaMetadata({
+            artwork: metadata.artwork === '' ? [] : [{ src: metadata.artwork }],
+            title: metadata.title,
+        });
+        session.setActionHandler('play', handlers.toggle);
+        session.setActionHandler('pause', handlers.toggle);
+        session.setActionHandler('seekto', (details) => {
+            if (details.seekTime !== undefined && details.seekTime !== null) {
+                handlers.seek(details.seekTime);
+            }
+        });
+        session.setActionHandler('seekbackward', (details) => {
+            handlers.skipBy(-(details.seekOffset ?? SKIP_SECONDS));
+        });
+        session.setActionHandler('seekforward', (details) => {
+            handlers.skipBy(details.seekOffset ?? SKIP_SECONDS);
+        });
+        session.setActionHandler('nexttrack', handlers.next);
+        session.setActionHandler('previoustrack', handlers.previous);
+    }
+    report(playing) {
+        if (owner === this.host && typeof navigator !== 'undefined' && navigator.mediaSession) {
+            navigator.mediaSession.playbackState = playing ? 'playing' : 'paused';
+        }
+    }
+    hostDisconnected() {
+        if (owner !== this.host) {
+            return;
+        }
+        owner = undefined;
+        if (typeof navigator !== 'undefined' && navigator.mediaSession) {
+            navigator.mediaSession.metadata = null;
+            navigator.mediaSession.playbackState = 'none';
+        }
+    }
+}

package/dist/controllers/remote-playback-controller/remote-playback-controller.d.ts

@@ -0,0 +1,34 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+/** What the watch reports, as it learns it. */
+export interface RemoteReport {
+    /** Whether anything on the network offers to play this. */
+    available: (available: boolean) => void;
+    /** Whether it is playing somewhere else right now. */
+    connected: (connected: boolean) => void;
+}
+/**
+ * Watches for something to play the media on, and stops on the way out.
+ *
+ * The Remote Playback API is the standard one, and it is what Safari
+ * implements for AirPlay and Chrome for Cast: one call covers both, where the
+ * older `webkitShowPlaybackTargetPicker` covers only the first. Firefox has
+ * neither, and `remote` simply being absent is what turns the control off
+ * there.
+ *
+ * `watchAvailability` returns an id that has to be canceled, or the callback
+ * outlives the element that owns it: a callback holding a removed element is a
+ * leak with a `@state` write on the end.
+ */
+export declare class RemotePlaybackController implements ReactiveController {
+    private readonly report;
+    private media;
+    /** Cancels the availability watch, since it outlives a single render. */
+    private watch;
+    constructor(host: ReactiveControllerHost, report: RemoteReport);
+    /** Starts watching the media element, once there is one. */
+    attach(media: HTMLMediaElement): Promise<void>;
+    /** Opens the platform's own device picker. It has no list of its own. */
+    prompt(): Promise<void>;
+    hostDisconnected(): void;
+    private readonly handleState;
+}

package/dist/controllers/remote-playback-controller/remote-playback-controller.js

@@ -0,0 +1,38 @@
+export class RemotePlaybackController {
+    constructor(host, report) {
+        this.report = report;
+        this.handleState = () => {
+            this.report.connected(this.media?.remote?.state === 'connected');
+        };
+        host.addController(this);
+    }
+    async attach(media) {
+        this.media = media;
+        media.remote?.addEventListener?.('connect', this.handleState);
+        media.remote?.addEventListener?.('disconnect', this.handleState);
+        const remote = media.remote;
+        if (!remote?.watchAvailability) {
+            return;
+        }
+        try {
+            this.watch = await remote.watchAvailability((available) => {
+                this.report.available(available);
+            });
+        }
+        catch {
+        }
+    }
+    async prompt() {
+        try {
+            await this.media?.remote?.prompt();
+        }
+        catch {
+        }
+    }
+    hostDisconnected() {
+        if (this.watch !== undefined) {
+            void this.media?.remote?.cancelWatchAvailability?.(this.watch);
+            this.watch = undefined;
+        }
+    }
+}

package/dist/index.d.ts

@@ -2,14 +2,18 @@ export { AriaForwardController, type AriaForwardOptions, } from './controllers/a
 export { ChartPointerController, type ChartPointerHost, } from './controllers/chart-pointer-controller/chart-pointer-controller.js';
 export { CommandController, type CommandOptions, HelixFallbackCommandEvent, supportsInvokers, } from './controllers/command-controller/command-controller.js';
 export { CopyController, type CopyOptions, } from './controllers/copy-controller/copy-controller.js';
+export { activeCue, adoptTrack, type Caption, CueController, captionsAmong, captionTracks, showCaption, } from './controllers/cue-controller/cue-controller.js';
 export { DisabledCascadeController, type DisabledCascadeOptions, } from './controllers/disabled-cascade-controller/disabled-cascade-controller.js';
 export { DismissController, type DismissOptions, } from './controllers/dismiss-controller/dismiss-controller.js';
 export { DrilldownController, type DrilldownOptions, } from './controllers/drilldown-controller/drilldown-controller.js';
 export { FloatingController, type FloatingOptions, type Placement, type Side, } from './controllers/floating-controller/floating-controller.js';
-export { FocusTrapController } from './controllers/focus-trap-controller/focus-trap-controller.js';
+export { FullscreenController } from './controllers/fullscreen-controller/fullscreen-controller.js';
+export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, type IndicatorOptions, } from './controllers/indicator-controller/indicator-controller.js';
 export { KeyboardNavigationController, type KeyboardNavigationOptions, type NavigableItem, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
+export { MediaSessionController, type SessionHandlers, SKIP_SECONDS, } from './controllers/media-session-controller/media-session-controller.js';
 export { PopoverController, type PopoverOptions, } from './controllers/popover-controller/popover-controller.js';
+export { RemotePlaybackController, type RemoteReport, } from './controllers/remote-playback-controller/remote-playback-controller.js';
 export { SourceController, type SourceHost, } from './controllers/source-controller/source-controller.js';
 export { type TokenColor, TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
 export { type Rendered, VirtualizeController, type VirtualizeOptions, type Window as VirtualizeWindow, } from './controllers/virtualize-controller/virtualize-controller.js';
@@ -44,6 +48,7 @@ export { type DisableableItem, forgetDisabled, inheritDisabled, } from './utils/
 export { inlineStep } from './utils/inline-step/inline-step.js';
 export { type Curve, linePath, type Point } from './utils/line-path/line-path.js';
 export { markRegion, type RegionOptions } from './utils/mark-region/mark-region.js';
+export { copiesOf, type MediaCopy, sameCopies, } from './utils/media-copy/media-copy.js';
 export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
 export { type Row, type RowCell, readRows, readSeries, type Series, type SeriesPoint, } from './utils/read-series/read-series.js';
 export { type Relative, relativeTime, } from './utils/relative-time/relative-time.js';

package/dist/index.js

@@ -2,14 +2,18 @@ export { AriaForwardController, } from './controllers/aria-forward-controller/ar
 export { ChartPointerController, } from './controllers/chart-pointer-controller/chart-pointer-controller.js';
 export { CommandController, HelixFallbackCommandEvent, supportsInvokers, } from './controllers/command-controller/command-controller.js';
 export { CopyController, } from './controllers/copy-controller/copy-controller.js';
+export { activeCue, adoptTrack, CueController, captionsAmong, captionTracks, showCaption, } from './controllers/cue-controller/cue-controller.js';
 export { DisabledCascadeController, } from './controllers/disabled-cascade-controller/disabled-cascade-controller.js';
 export { DismissController, } from './controllers/dismiss-controller/dismiss-controller.js';
 export { DrilldownController, } from './controllers/drilldown-controller/drilldown-controller.js';
 export { FloatingController, } from './controllers/floating-controller/floating-controller.js';
-export { FocusTrapController } from './controllers/focus-trap-controller/focus-trap-controller.js';
+export { FullscreenController } from './controllers/fullscreen-controller/fullscreen-controller.js';
+export { IdleController } from './controllers/idle-controller/idle-controller.js';
 export { IndicatorController, } from './controllers/indicator-controller/indicator-controller.js';
 export { KeyboardNavigationController, } from './controllers/keyboard-navigation-controller/keyboard-navigation-controller.js';
+export { MediaSessionController, SKIP_SECONDS, } from './controllers/media-session-controller/media-session-controller.js';
 export { PopoverController, } from './controllers/popover-controller/popover-controller.js';
+export { RemotePlaybackController, } from './controllers/remote-playback-controller/remote-playback-controller.js';
 export { SourceController, } from './controllers/source-controller/source-controller.js';
 export { TokenColorController, } from './controllers/token-color-controller/token-color-controller.js';
 export { VirtualizeController, } from './controllers/virtualize-controller/virtualize-controller.js';
@@ -44,6 +48,7 @@ export { forgetDisabled, inheritDisabled, } from './utils/inherit-disabled/inher
 export { inlineStep } from './utils/inline-step/inline-step.js';
 export { linePath } from './utils/line-path/line-path.js';
 export { markRegion } from './utils/mark-region/mark-region.js';
+export { copiesOf, sameCopies, } from './utils/media-copy/media-copy.js';
 export { onUnlessFalse } from './utils/on-unless-false/on-unless-false.js';
 export { readRows, readSeries, } from './utils/read-series/read-series.js';
 export { relativeTime, } from './utils/relative-time/relative-time.js';

package/dist/utils/focusable-elements/focusable-elements.d.ts

@@ -1,14 +1,13 @@
 /**
  * Everything inside `root` the reader can reach with Tab, in document order.
  *
- * Separate from the focus trap because finding is the half most callers want:
- * roving tabindex, arrow-key navigation and "focus the first thing" all need
- * this list and none of them traps anything.
+ * Roving tabindex, arrow-key navigation and "focus the first thing" all need
+ * this list, which is why it is a utility rather than part of anything that
+ * asks for it.
  *
  * Visibility is tested with `getClientRects()` rather than `offsetParent`,
- * which is null for anything inside a `position: fixed` container. A drawer is
- * exactly that, so the `offsetParent` test excluded every control in the thing
- * being trapped.
+ * which is null for anything inside a `position: fixed` container, so the
+ * `offsetParent` test excluded every control on a raised surface.
  */
 export declare const focusableElements: (root: HTMLElement) => HTMLElement[];
 /**
@@ -23,13 +22,13 @@ export declare const deepActiveElement: () => Element | null;
  *
  * `Node.contains` walks `parentNode` and a shadow root's `parentNode` is null,
  * so it answers false for anything inside a component. Paired with
- * `deepActiveElement`, which returns exactly such a node, that pairing is a trap
- * of its own: the two look like they belong together and one of them crosses.
+ * `deepActiveElement`, which returns exactly such a node, the pair is a hazard of
+ * its own: the two look like they belong together and one of them crosses.
  *
  * `contains(deepActiveElement())` is the shape to avoid: focus on a
  * `helix-button` reports as the `<button>` in its shadow root, which is in no
- * light-DOM container anywhere, so a trap written that way reads every reader
- * as already outside it.
+ * light-DOM container anywhere, so a containment test written that way reads
+ * every reader as already outside.
  *
  * `host` is reached without naming `ShadowRoot`, which the server has no global
  * for. This runs from a keydown handler and would never execute there, but a

package/dist/utils/media-copy/media-copy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What the consumer slotted, as the plain data a media element can be given.
+ *
+ * A media element runs resource selection over its own child nodes and a slot
+ * is one node, so anything wrapping `<video>` or `<audio>` in a shadow root has
+ * to copy rather than slot. The two questions that copying asks are answered
+ * here: which attributes come across, and whether a fresh read differs from the
+ * set already held. When to read, and what to do with the answer, stay with the
+ * element.
+ *
+ * A read of light DOM and nothing else: no media element, no playback state,
+ * nothing drawn, which is what makes it a utility rather than a controller.
+ */
+/** A `<source>` or `<track>` as the consumer wrote it, reduced to what the copy carries. */
+export interface MediaCopy {
+    attrs: Record<string, string>;
+    tag: 'source' | 'track';
+}
+/** The copies to make of what the default slot is given. */
+export declare const copiesOf: (elements: readonly Element[]) => MediaCopy[];
+/**
+ * Whether two reads describe the same media.
+ *
+ * The same set again is not a change. A video reloads for every new list, and
+ * the first `slotchange` reports the children the element has already read.
+ */
+export declare const sameCopies: (one: readonly MediaCopy[], two: readonly MediaCopy[]) => boolean;

package/dist/utils/media-copy/media-copy.js

@@ -0,0 +1,18 @@
+const CARRIED = {
+    source: ['media', 'sizes', 'src', 'srcset', 'type'],
+    track: ['default', 'kind', 'label', 'src', 'srclang'],
+};
+export const copiesOf = (elements) => elements
+    .filter((node) => node instanceof HTMLSourceElement || node instanceof HTMLTrackElement)
+    .map((node) => {
+    const tag = node instanceof HTMLTrackElement ? 'track' : 'source';
+    const attrs = {};
+    for (const name of CARRIED[tag]) {
+        const value = node.getAttribute(name);
+        if (value !== null) {
+            attrs[name] = value;
+        }
+    }
+    return { attrs, tag };
+});
+export const sameCopies = (one, two) => JSON.stringify(one) === JSON.stringify(two);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.56.1",
+  "version": "0.57.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -34,12 +34,12 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.56.1"
+    "@fusion.dev/helix-icons": "0.57.0"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.56.1",
-    "@fusion.dev/helix-testing": "0.56.1",
+    "@fusion.dev/helix-cem": "0.57.0",
+    "@fusion.dev/helix-testing": "0.57.0",
     "lit": "^3.2.1"
   },
   "homepage": "https://fusion.dev",

package/dist/controllers/focus-trap-controller/focus-trap-controller.d.ts

@@ -1,26 +0,0 @@
-import type { ReactiveController, ReactiveControllerHost } from 'lit';
-/**
- * Keeps Tab inside a container while it is open, and gives focus back after.
- *
- * A dialog that does not trap focus is one a keyboard user tabs straight out
- * of, into a page they cannot see and cannot get back from. Restoring focus on
- * release matters just as much: without it, closing a drawer drops the reader
- * at the top of the document.
- *
- * Finding the focusable elements is `focusableElements`, which is a utility
- * rather than part of this, because that half is what roving tabindex and
- * arrow-key navigation need and neither of them traps anything.
- */
-export declare class FocusTrapController implements ReactiveController {
-    private container;
-    /** The frame waiting to take focus, so a release can call it off. */
-    private frame;
-    private previous;
-    constructor(host: ReactiveControllerHost);
-    private readonly handleKeydown;
-    /** Starts trapping, remembering where focus came from. */
-    activate(container: HTMLElement): void;
-    /** Stops trapping and returns focus to wherever it was. */
-    deactivate(): void;
-    hostDisconnected(): void;
-}