@hanzo/ui 8.27.3 → 8.27.4

package/dist/backdrop/Backdrop.js

@@ -0,0 +1,418 @@
+'use client';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Backdrop — a still image, one muted video, a list of them, or our own clips,
+ * painted behind whatever a surface renders on top of it.
+ *
+ * The layer takes no pointer and is `aria-hidden`, so nothing about the controls
+ * above it, the focus order or the screen-reader surface changes: it is scenery,
+ * not UI. That is also why nothing here is clickable — a backdrop that could
+ * take a click would be a trap sitting under the conversation.
+ *
+ * NOTHING IS REVEALED UNTIL IT IS ACTUALLY THERE. A video appears only once the
+ * player reports footage rolling, an image only once it has decoded. A video the
+ * provider refuses — taken down, region-blocked, embed throttled — and an image
+ * URL that 404s both simply stay invisible, instead of showing the provider's
+ * error card through the canvas.
+ *
+ * Provider chrome (title, watermark, suggestions) is kept out of frame two ways:
+ * players are built with every control off, and the frame is centre-cropped well
+ * past the viewport (16:9 cover, then overscan), so the strips providers reserve
+ * at the top and bottom land offscreen. The scrim keeps text legible over bright
+ * footage.
+ *
+ * WEB ONLY, and it ships at its own subpath for that reason. A YouTube embed is
+ * an `<iframe>` and a clip is a `<video>`; neither exists off the web, and the
+ * cover crop is written in `vh`/`vw`. `Grid` is off the barrel on the same rule.
+ *
+ * Configuration arrives as PROPS. There is no store here and no context: a
+ * surface holds the scene (in whatever it already uses) and passes it, which is
+ * what lets the same component serve a settings panel, a `/bg` command and a
+ * persona's emotion with one implementation and no adapter between them.
+ */
+import { YStack } from '@hanzo/gui';
+import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+import { slot } from '../backends/gui/slot.js';
+import { DWELL, HOSTS, files, knobs, media, playable, twitch, videoId, youtube, } from './scene.js';
+const ORIGIN = 'https://www.youtube.com';
+/**
+ * Send the origin, never the path.
+ *
+ * The address of a conversation is `/c/<id>`, and a `Referer` carrying it would
+ * hand that id to YouTube, to Twitch, and to whatever host serves a photo
+ * somebody pasted — on every load, to a party with no reason to know which
+ * thread is open. Origin alone is all these embeds need: Twitch checks the
+ * `parent` parameter and YouTube the `origin` one, both passed deliberately.
+ * Chrome's default already stops at the origin; Safari and older engines do not,
+ * which is why this is stated rather than assumed.
+ */
+const REFERRER = 'strict-origin-when-cross-origin';
+/** How long the adaptive ramp is given before anything is revealed: quality
+ *  cannot be forced (embeds have ignored every quality API since 2019), so the
+ *  low-res opening plays out hidden. */
+const RAMP = 4000;
+/** The cover-crop: deliberately larger than the container, and told so twice
+ *  because a page's own `img, iframe, video { max-width: 100% }` reset would
+ *  otherwise clamp the formula and letterbox the footage on a narrow screen. */
+const COVER = {
+    position: 'absolute',
+    left: '50%',
+    top: '50%',
+    width: 'max(177.78vh, 100vw)',
+    height: 'max(56.25vw, 100vh)',
+    maxWidth: 'none',
+    maxHeight: 'none',
+    border: 0,
+};
+/** The cover-crop at a brand's zoom, or the house 1.4. A larger scale pushes a
+ *  corner watermark off-frame. */
+const cover = (zoom) => ({
+    ...COVER,
+    transform: `translate(-50%, -50%) scale(${zoom && zoom > 0 ? zoom : 1.4})`,
+});
+const fade = (shown) => ({
+    opacity: shown ? 1 : 0,
+    transition: 'opacity 1.2s ease',
+});
+/**
+ * Ask a YouTube player to start, through its API. Muted playback started by
+ * script is always allowed, and the API path sidesteps the viewability heuristic
+ * that can leave the autoplay param unhonoured for a player sitting under the
+ * content layer. Repeated because the player ignores commands sent before its
+ * own scripts finish booting.
+ */
+function start(event, rate) {
+    const frame = event.currentTarget;
+    const post = (message) => frame.contentWindow?.postMessage(JSON.stringify(message), ORIGIN);
+    const kick = () => {
+        // The listening handshake makes the player report state back — the reveal
+        // below waits for a real "playing" signal.
+        post({ event: 'listening', id: 'backdrop', channel: 'widget' });
+        // Quality cannot be forced (see the note above); this only skips the low
+        // first rung. Ask for the top one so a 4K display is offered the 2160p
+        // rendition when the source and the bandwidth allow — the size-based auto
+        // picker caps at the viewport otherwise.
+        post({ event: 'command', func: 'setPlaybackQuality', args: ['hd2160'] });
+        // A brand's chosen speed. YouTube quantises to its allowed steps, so an
+        // off-grid value plays at the nearest; sent with the other kicks because a
+        // command before the player boots is dropped.
+        if (rate && rate > 0)
+            post({ event: 'command', func: 'setPlaybackRate', args: [rate] });
+        post({ event: 'command', func: 'playVideo', args: [] });
+    };
+    kick();
+    setTimeout(kick, 1500);
+    setTimeout(kick, RAMP);
+}
+/**
+ * The BROWSER's transport controls, disowned.
+ *
+ * A page that plays media gets a system play/pause/skip overlay — Safari draws
+ * it over the middle of the conversation — and `controls=0` never reaches it,
+ * because that overlay belongs to the user agent, not to the player.
+ * `mediaSession` is where a page says whose media this is: cleared metadata, no
+ * playback state, no handlers, nothing to present.
+ *
+ * This is scenery. It is muted, it loops, and the only controls that mean
+ * anything for it belong to the surface. System skip buttons put furniture over
+ * the page and wire it to nothing.
+ */
+function disown() {
+    try {
+        const ms = navigator.mediaSession;
+        if (!ms)
+            return;
+        ms.metadata = null;
+        ms.playbackState = 'none';
+        const actions = [
+            'play',
+            'pause',
+            'previoustrack',
+            'nexttrack',
+            'seekbackward',
+            'seekforward',
+            'stop',
+        ];
+        for (const action of actions) {
+            try {
+                ms.setActionHandler(action, null);
+            }
+            catch {
+                /* an action this agent does not know */
+            }
+        }
+    }
+    catch {
+        /* no mediaSession here */
+    }
+}
+/** A YouTube player. Revealed on a real `playing` report; calls `onEnd` when the
+ *  player says the video finished, which is how a mixed list advances. */
+function Video({ src, onEnd, rate, zoom, sound = false, }) {
+    const [playing, setPlaying] = useState(false);
+    const [ramped, setRamped] = useState(false);
+    const frame = useRef(null);
+    useEffect(() => {
+        const hear = (event) => {
+            if (event.origin !== ORIGIN)
+                return;
+            try {
+                const state = JSON.parse(event.data)?.info?.playerState;
+                if (state === 1) {
+                    setPlaying(true);
+                    disown();
+                }
+                else if (state === 0) {
+                    onEnd?.();
+                }
+            }
+            catch {
+                /* not the player */
+            }
+        };
+        window.addEventListener('message', hear);
+        const ramp = setTimeout(() => setRamped(true), RAMP);
+        return () => {
+            window.removeEventListener('message', hear);
+            clearTimeout(ramp);
+        };
+    }, [onEnd]);
+    /**
+     * Sound is turned on AFTER the player is playing, never in the URL.
+     *
+     * `mute=1` is what lets the embed start at all — autoplay with sound is
+     * refused by every current browser — so unmuting is a command, and it is only
+     * worth sending once the player has said it is running: commands sent before
+     * its scripts boot are dropped, which is the same reason `start` kicks three
+     * times. Gating on `playing` rides that report instead of racing it.
+     *
+     * It follows the setting both ways while the video is on screen, so turning
+     * the sound back off silences it now rather than at the next reload — the one
+     * direction a person is likely to be in a hurry about.
+     */
+    useEffect(() => {
+        if (!playing)
+            return;
+        const post = (message) => frame.current?.contentWindow?.postMessage(JSON.stringify(message), ORIGIN);
+        post({ event: 'command', func: sound ? 'unMute' : 'mute', args: [] });
+        // Wallpaper, not a concert. Loud enough to hear under a conversation.
+        if (sound)
+            post({ event: 'command', func: 'setVolume', args: [35] });
+    }, [playing, sound]);
+    return (_jsx("iframe", { ref: frame, src: src, title: "", tabIndex: -1, allow: "autoplay; encrypted-media", referrerPolicy: REFERRER, onLoad: (e) => start(e, rate), style: { ...cover(zoom), ...fade(playing && ramped) } }));
+}
+/**
+ * A Twitch player.
+ *
+ * Twitch publishes no state channel for a bare iframe the way YouTube does —
+ * reading playback state means loading their embed script, a third party we
+ * would have to let run — so this reveals on load rather than on a playing
+ * report. The honest consequence: an offline channel shows Twitch's own idle
+ * screen rather than staying hidden. A live stream also never ends, so its turn
+ * in a list is ended by the clock instead of by the player.
+ */
+function Stream({ src, onEnd }) {
+    const [loaded, setLoaded] = useState(false);
+    useEffect(() => {
+        if (!onEnd)
+            return;
+        const turn = setTimeout(onEnd, DWELL);
+        return () => clearTimeout(turn);
+    }, [onEnd]);
+    return (_jsx("iframe", { src: src, title: "", tabIndex: -1, allow: "autoplay; encrypted-media", referrerPolicy: REFERRER, onLoad: () => setLoaded(true), style: { ...cover(), ...fade(loaded) } }));
+}
+/** A still image, revealed once it has decoded — a URL that 404s never fires
+ *  `load`, so it stays invisible for the same reason a refused video does. */
+function Photo({ url }) {
+    const [loaded, setLoaded] = useState(false);
+    return (_jsx("img", { src: url, alt: "", referrerPolicy: REFERRER, onLoad: () => setLoaded(true), style: {
+            position: 'absolute',
+            inset: 0,
+            width: '100%',
+            height: '100%',
+            maxWidth: 'none',
+            maxHeight: 'none',
+            objectFit: 'cover',
+            ...fade(loaded),
+        } }));
+}
+/**
+ * One entry of a list, dispatched to the player its provider needs.
+ *
+ * Twitch is told the bare hostname it is being framed by — it refuses to load
+ * for a `parent` it was not given — while YouTube's API handshake is keyed to
+ * the full origin. Two different values, from the same page, for two different
+ * reasons.
+ */
+function Entry({ entry, onEnd, at }) {
+    if (entry.provider === 'twitch') {
+        return _jsx(Stream, { src: twitch(entry.url, at.host), onEnd: onEnd });
+    }
+    if (entry.provider === 'youtube') {
+        // No loop on a single entry: the list, not the video, decides what repeats.
+        return _jsx(Video, { src: youtube([videoId(entry.url)], false, at.origin), onEnd: onEnd });
+    }
+    // Named, not defaulted. Callers filter by `playable` before they get here, so
+    // this branch should be unreachable — but a dispatch whose LAST case is a
+    // fall-through hands every future provider to whichever player happens to be
+    // written last, and here that would ask YouTube to embed a netflix.com link. A
+    // player has to be chosen on purpose; nothing else gets one.
+    return null;
+}
+/** The list, one entry at a time: a video hands over when it ends, a stream when
+ *  its dwell is up. Runs only when the list is NOT all YouTube — that case is
+ *  handed to YouTube's own playlist player instead. */
+function Rotation({ links, loop, at }) {
+    const [index, setIndex] = useState(0);
+    const [done, setDone] = useState(false);
+    // A changed list is a new rotation, not a continuation of the old one.
+    useEffect(() => {
+        setIndex(0);
+        setDone(false);
+    }, [links]);
+    const advance = useCallback(() => {
+        setIndex((current) => {
+            const next = current + 1;
+            if (next < links.length)
+                return next;
+            if (loop)
+                return 0;
+            setDone(true);
+            return current;
+        });
+    }, [links.length, loop]);
+    const entry = links[index];
+    if (done || !entry)
+        return null;
+    // Keyed by URL so a handover resets the next player's reveal state rather than
+    // inheriting the last one's.
+    return _jsx(Entry, { entry: entry, onEnd: advance, at: at }, entry.url);
+}
+/**
+ * Direct video clips, ours to serve, played as a preloaded crossfade.
+ *
+ * Two stacked `<video>`s take turns: the shown one plays while the hidden one
+ * loads the next clip, and they swap only once the next has reported it is
+ * actually playing — so the canvas crosses one live frame over another and never
+ * flashes black between them. That is the same "nothing is revealed until it is
+ * real" rule the YouTube scene keeps, met with the element's own `playing` event
+ * instead of a postMessage handshake. A clip a host refuses (404, decode error)
+ * fires `error`, not `playing`, so it never appears and hands the turn on.
+ *
+ * A single clip loops itself; a list lets each clip END and advances on it — an
+ * unhurried idle cycle. `preload="auto"` is what makes the handoff seamless: the
+ * next file is already buffered when its turn comes.
+ *
+ * The FIRST clip goes into the hidden slot and is revealed by the same flip
+ * every later clip uses, so there is one reveal path and no black first frame.
+ */
+function Clips({ urls, loop, zoom }) {
+    const [showA, setShowA] = useState(true);
+    const [srcA, setSrcA] = useState(undefined);
+    const [srcB, setSrcB] = useState(undefined);
+    const [lit, setLit] = useState(false);
+    const shown = useRef(true);
+    shown.current = showA;
+    const at = useRef(0);
+    // Load `url` into whichever slot is hidden right now; its `playing` event then
+    // flips which slot is shown, crossing the new frame in over the old. A ref for
+    // `showA` because this is called from timers and event handlers that must read
+    // the current slot, not the one captured when they were created.
+    const cue = useCallback((url) => {
+        if (shown.current)
+            setSrcB(url);
+        else
+            setSrcA(url);
+    }, []);
+    const advance = useCallback(() => {
+        if (urls.length < 2)
+            return;
+        at.current = (at.current + 1) % urls.length;
+        cue(urls[at.current]);
+    }, [urls, cue]);
+    // Head of the list on mount and whenever the list changes (a brand's own
+    // footage arriving, or a persona changing mood). The first clip is cued into
+    // the hidden slot so the reveal below is the only path that ever shows one.
+    useEffect(() => {
+        at.current = 0;
+        setShowA(true);
+        setSrcA(undefined);
+        setSrcB(undefined);
+        setLit(false);
+        if (urls.length)
+            cue(urls[0]);
+    }, [urls, cue]);
+    if (!urls.length)
+        return null;
+    // Only the HIDDEN slot reaching `playing` is a handover — so the flip is
+    // "show whoever just started", never a toggle. The SHOWN slot fires `playing`
+    // again after any stall or seek, and toggling on that would swap a live frame
+    // for a stale one for no reason.
+    const reveal = (isA) => {
+        if (lit && isA === shown.current)
+            return;
+        setLit(true);
+        setShowA(isA);
+    };
+    const slotStyle = (isA) => ({
+        ...cover(zoom),
+        objectFit: 'cover',
+        opacity: lit && isA === showA ? 1 : 0,
+        transition: 'opacity 1.2s ease',
+    });
+    const one = (isA, src) => (_jsx("video", { src: src, autoPlay: true, muted: true, playsInline: true, 
+        // A lone clip repeats itself; a member of a list must be allowed to END so
+        // the next can cross in — looping one would freeze the cycle on it.
+        loop: urls.length < 2 && loop, preload: "auto", onPlaying: () => reveal(isA), onEnded: urls.length > 1 ? advance : undefined, onError: advance, tabIndex: -1, "aria-hidden": true, style: slotStyle(isA) }, isA ? 'a' : 'b'));
+    return (_jsxs(_Fragment, { children: [one(true, srcA), one(false, srcB)] }));
+}
+/** What the scene asks to be painted, or null when that is nothing. */
+function Canvas({ scene, at, zoom }) {
+    const links = useMemo(() => scene.playlist.filter(playable), [scene.playlist]);
+    if (scene.mode === 'clips') {
+        return scene.clips.length ? (_jsx(Clips, { urls: scene.clips, loop: scene.loop, zoom: knobs(scene.clips[0]).zoom ?? zoom })) : null;
+    }
+    if (scene.mode === 'photo')
+        return scene.photo ? _jsx(Photo, { url: scene.photo }) : null;
+    if (scene.mode === 'video') {
+        const id = videoId(scene.video);
+        // start / rate / zoom ride the same URL, so a brand tunes all of them from
+        // one configuration value with no rebuild.
+        const k = knobs(scene.video);
+        return id ? (_jsx(Video, { src: youtube([id], scene.loop, at.origin, k.start), rate: k.rate, zoom: k.zoom ?? zoom, sound: scene.sound })) : null;
+    }
+    if (links.length === 0)
+        return null;
+    // An all-YouTube list is handed to YouTube's own playlist player: it holds the
+    // queue in one frame, so there is no handover gap between videos and no second
+    // player to reveal.
+    if (links.every((entry) => entry.provider === 'youtube')) {
+        return (_jsx(Video, { src: youtube(links.map((entry) => videoId(entry.url)), scene.loop, at.origin), sound: scene.sound }));
+    }
+    return _jsx(Rotation, { links: links, loop: scene.loop, at: at });
+}
+export function Backdrop({ mode = 'off', photo = '', video = '', playlist = [], clips = [], loop = true, sound = false, scrim = 0.5, zoom, hosts = HOSTS, ...props }) {
+    const [at, setAt] = useState(null);
+    useEffect(() => {
+        setAt({ origin: window.location.origin, host: window.location.hostname });
+    }, []);
+    // The gate again, at the render boundary. `merge` guards what a surface STORES;
+    // this guards what actually reaches a `src`, so a caller that builds props by
+    // hand cannot point an element at a host the media policy would refuse.
+    const scene = useMemo(() => ({
+        mode,
+        photo: media(photo, hosts),
+        video,
+        playlist,
+        clips: files(clips, hosts),
+        loop,
+        sound,
+    }), [mode, photo, video, playlist, clips, loop, sound, hosts]);
+    // Off means ABSENT, not hidden: these are third-party frames that autoplay
+    // video, so leaving one mounted at opacity 0 would keep it streaming behind a
+    // setting that says it is off.
+    if (mode === 'off' || !at)
+        return null;
+    return (_jsxs(YStack, { ...slot('backdrop'), "data-mode": mode, fullscreen: true, overflow: "hidden", pointerEvents: "none", "aria-hidden": true, ...props, children: [_jsx(Canvas, { scene: scene, at: at, zoom: zoom }), _jsx(YStack, { fullscreen: true, bg: "$background", opacity: scrim })] }));
+}
+//# sourceMappingURL=Backdrop.js.map

package/dist/backdrop/Backdrop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Backdrop.js","sourceRoot":"","sources":["../../src/backdrop/Backdrop.tsx"],"names":[],"mappings":"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"}

package/dist/backdrop/index.cjs

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.youtube = exports.web = exports.videoId = exports.twitch = exports.scene = exports.provider = exports.playable = exports.merge = exports.media = exports.link = exports.knobs = exports.files = exports.command = exports.channel = exports.PRESETS = exports.HOSTS = exports.DWELL = exports.BLANK = exports.Backdrop = void 0;
+/**
+ * @hanzo/ui/backdrop — ambient scenery behind a surface, on @hanzo/gui.
+ *
+ * `Backdrop` paints it and `scene.ts` decides what may be painted. The split is
+ * the point: every rule about what can play, what a link means and what a typed
+ * command does is decidable from data alone, so a surface answers a `/bg` line,
+ * validates what came back out of storage and seeds a settings panel by CALLING
+ * a function — nothing mounted, nothing measured — and the suite holds all of it
+ * to account without rendering anything.
+ *
+ * Props-in, no store: a surface holds the `Scene` in whatever state it already
+ * has and passes it. `merge` is the ONE gate a change goes through, and
+ * `Backdrop` re-applies the media rule at the render boundary, so a scene that
+ * arrives from storage, from a model's suggestion or from hand-written props is
+ * held to the same rule in every direction.
+ *
+ * WEB ONLY, and off the main barrel for that reason — an embed is an `<iframe>`,
+ * a clip is a `<video>`, and the cover crop is written in `vh`/`vw`. `Grid` sits
+ * at its own subpath on the same rule.
+ *
+ * The rules live in `scene.ts` rather than a `backdrop.ts` beside `Backdrop.tsx`
+ * because the two would emit `backdrop.js` and `Backdrop.js` into one directory,
+ * which is ONE file on macOS. `dist.test.ts` holds that line for the whole
+ * package now; the convention it enforces is the one already here — lowercase
+ * for a module of rules, capitalised for a component.
+ */
+var Backdrop_1 = require("./Backdrop.cjs");
+Object.defineProperty(exports, "Backdrop", { enumerable: true, get: function () { return Backdrop_1.Backdrop; } });
+var scene_1 = require("./scene.cjs");
+Object.defineProperty(exports, "BLANK", { enumerable: true, get: function () { return scene_1.BLANK; } });
+Object.defineProperty(exports, "DWELL", { enumerable: true, get: function () { return scene_1.DWELL; } });
+Object.defineProperty(exports, "HOSTS", { enumerable: true, get: function () { return scene_1.HOSTS; } });
+Object.defineProperty(exports, "PRESETS", { enumerable: true, get: function () { return scene_1.PRESETS; } });
+Object.defineProperty(exports, "channel", { enumerable: true, get: function () { return scene_1.channel; } });
+Object.defineProperty(exports, "command", { enumerable: true, get: function () { return scene_1.command; } });
+Object.defineProperty(exports, "files", { enumerable: true, get: function () { return scene_1.files; } });
+Object.defineProperty(exports, "knobs", { enumerable: true, get: function () { return scene_1.knobs; } });
+Object.defineProperty(exports, "link", { enumerable: true, get: function () { return scene_1.link; } });
+Object.defineProperty(exports, "media", { enumerable: true, get: function () { return scene_1.media; } });
+Object.defineProperty(exports, "merge", { enumerable: true, get: function () { return scene_1.merge; } });
+Object.defineProperty(exports, "playable", { enumerable: true, get: function () { return scene_1.playable; } });
+Object.defineProperty(exports, "provider", { enumerable: true, get: function () { return scene_1.provider; } });
+Object.defineProperty(exports, "scene", { enumerable: true, get: function () { return scene_1.scene; } });
+Object.defineProperty(exports, "twitch", { enumerable: true, get: function () { return scene_1.twitch; } });
+Object.defineProperty(exports, "videoId", { enumerable: true, get: function () { return scene_1.videoId; } });
+Object.defineProperty(exports, "web", { enumerable: true, get: function () { return scene_1.web; } });
+Object.defineProperty(exports, "youtube", { enumerable: true, get: function () { return scene_1.youtube; } });

package/dist/backdrop/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @hanzo/ui/backdrop — ambient scenery behind a surface, on @hanzo/gui.
+ *
+ * `Backdrop` paints it and `scene.ts` decides what may be painted. The split is
+ * the point: every rule about what can play, what a link means and what a typed
+ * command does is decidable from data alone, so a surface answers a `/bg` line,
+ * validates what came back out of storage and seeds a settings panel by CALLING
+ * a function — nothing mounted, nothing measured — and the suite holds all of it
+ * to account without rendering anything.
+ *
+ * Props-in, no store: a surface holds the `Scene` in whatever state it already
+ * has and passes it. `merge` is the ONE gate a change goes through, and
+ * `Backdrop` re-applies the media rule at the render boundary, so a scene that
+ * arrives from storage, from a model's suggestion or from hand-written props is
+ * held to the same rule in every direction.
+ *
+ * WEB ONLY, and off the main barrel for that reason — an embed is an `<iframe>`,
+ * a clip is a `<video>`, and the cover crop is written in `vh`/`vw`. `Grid` sits
+ * at its own subpath on the same rule.
+ *
+ * The rules live in `scene.ts` rather than a `backdrop.ts` beside `Backdrop.tsx`
+ * because the two would emit `backdrop.js` and `Backdrop.js` into one directory,
+ * which is ONE file on macOS. `dist.test.ts` holds that line for the whole
+ * package now; the convention it enforces is the one already here — lowercase
+ * for a module of rules, capitalised for a component.
+ */
+export { Backdrop, type BackdropProps } from './Backdrop.js';
+export { BLANK, DWELL, HOSTS, PRESETS, channel, command, files, knobs, link, media, merge, playable, provider, scene, twitch, videoId, web, youtube, type Link, type Mode, type Preset, type Provider, type Scene, } from './scene.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backdrop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backdrop/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAEzD,OAAO,EACL,KAAK,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,MAAM,EACN,OAAO,EACP,GAAG,EACH,OAAO,EACP,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,KAAK,GACX,MAAM,SAAS,CAAA"}

package/dist/backdrop/index.js

@@ -0,0 +1,29 @@
+/**
+ * @hanzo/ui/backdrop — ambient scenery behind a surface, on @hanzo/gui.
+ *
+ * `Backdrop` paints it and `scene.ts` decides what may be painted. The split is
+ * the point: every rule about what can play, what a link means and what a typed
+ * command does is decidable from data alone, so a surface answers a `/bg` line,
+ * validates what came back out of storage and seeds a settings panel by CALLING
+ * a function — nothing mounted, nothing measured — and the suite holds all of it
+ * to account without rendering anything.
+ *
+ * Props-in, no store: a surface holds the `Scene` in whatever state it already
+ * has and passes it. `merge` is the ONE gate a change goes through, and
+ * `Backdrop` re-applies the media rule at the render boundary, so a scene that
+ * arrives from storage, from a model's suggestion or from hand-written props is
+ * held to the same rule in every direction.
+ *
+ * WEB ONLY, and off the main barrel for that reason — an embed is an `<iframe>`,
+ * a clip is a `<video>`, and the cover crop is written in `vh`/`vw`. `Grid` sits
+ * at its own subpath on the same rule.
+ *
+ * The rules live in `scene.ts` rather than a `backdrop.ts` beside `Backdrop.tsx`
+ * because the two would emit `backdrop.js` and `Backdrop.js` into one directory,
+ * which is ONE file on macOS. `dist.test.ts` holds that line for the whole
+ * package now; the convention it enforces is the one already here — lowercase
+ * for a module of rules, capitalised for a component.
+ */
+export { Backdrop } from './Backdrop.js';
+export { BLANK, DWELL, HOSTS, PRESETS, channel, command, files, knobs, link, media, merge, playable, provider, scene, twitch, videoId, web, youtube, } from './scene.js';
+//# sourceMappingURL=index.js.map

package/dist/backdrop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backdrop/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAA;AAEzD,OAAO,EACL,KAAK,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,MAAM,EACN,OAAO,EACP,GAAG,EACH,OAAO,GAMR,MAAM,SAAS,CAAA"}