@joewinke/jatui 0.61.0 → 0.63.0

package/dist/components/AmbienceToggle.svelte

@@ -26,12 +26,28 @@
 	 *   - A playing (or paused) scape shows a now-playing block above the
 	 *     volume row (jatui-153tz): for a playlist — the track title, its
 	 *     composer · license attribution, an elapsed/total progress bar and a
-	 *     prev / play-pause / next transport (prev restarts the track when more
-	 *     than 3 s are in, else goes back one; play-pause freezes the station
-	 *     without closing the menu; next skips). Generative scapes (noise /
-	 *     focus) get the play/pause control only. The transport joins the
-	 *     menu's roving order; a paused row stays visible (its play button is
-	 *     the resume) and a stopped one hides.
+	 *     shuffle / prev / play-pause / next transport (shuffle is an
+	 *     aria-pressed IconButton, persisted per station and fresh-shuffled
+	 *     per session with no-repeat — jatui-plbzq; prev restarts the track
+	 *     when more than 3 s are in, else goes back one; play-pause freezes
+	 *     the station without closing the menu; next skips). Generative
+	 *     scapes (noise / focus) get the play/pause control only. A radio
+	 *     station registered with a public `streamUrl` (jatui-plbzq) gets the
+	 *     station name, a `Open station site` attribution link and
+	 *     play/pause — the stream is fetched by the browser from the station
+	 *     itself, never relayed. The transport joins the menu's roving order;
+	 *     a paused row stays visible (its play button is the resume) and a
+	 *     stopped one hides.
+	 *   - Playlists whose licence permits redistribution (jatui-0vxcu: CC0,
+	 *     public domain, CC-BY, CC-BY-SA — never NC/ND unless the manifest
+	 *     marks the track `downloadable: true`) also get a Download button
+	 *     next to the transport: the track url is fetched to a Blob (a plain
+	 *     cross-origin `<a download>` is ignored), saved under
+	 *     "Composer - Title.ext" so attribution travels with the file, and a
+	 *     CORS failure falls back to opening the url in a new tab. The busy
+	 *     spinner never blocks playback. Shared mode: a remote tab downloads
+	 *     the leader's published track url (`SharedAmbienceState.trackDownload`)
+	 *     — or hides the button when the leader published none.
 	 *   - A playing playlist shows its current track's attribution (title,
 	 *     composer, license) under the playlist item and its section row.
 	 *   - With a menu or submenu open, the mouse wheel over that surface
@@ -88,6 +104,14 @@
 		return `${track.title} — ${trackAttribution(track)}`;
 	}
 
+	/** The radio row's attribution href (jatui-plbzq): the scape's site url
+	 *  re-validated with `safeAmbienceHref` — the registry could be hostile
+	 *  on a remote tab too, and the leader is another tab, not a source of
+	 *  trust. Null hides the 'Open station site' link. */
+	export function radioSite(scape: RadioStreamScape | null | undefined): string | null {
+		return scape ? safeAmbienceHref(scape.href) : null;
+	}
+
 	/** "3:07" — m:ss for the now-playing row's elapsed/total (jatui-153tz). */
 	export function formatTrackTime(seconds: number | null | undefined): string {
 		if (
@@ -233,8 +257,19 @@
 	import { getMotionContext } from '../motion/level';
 	import { isAmbienceLink, safeAmbienceHref } from '../ambience/groups';
 	import { isPlaylistScape, type PlaylistState } from '../ambience/scapes/playlist';
+	import { isRadioScape, type RadioStreamScape, type RadioStreamState } from '../ambience/scapes/radio';
+	import {
+		isTrackDownloadable,
+		trackDownloadFilename
+	} from '../ambience/scapes/playlist';
+	import IconButton from './IconButton.svelte';
+	import { safeSharedTrackDownload } from '../ambience/shared';
+	import type {
+		SharedAmbience,
+		SharedAmbienceState,
+		SharedTrackDownload
+	} from '../ambience/shared';
 	import type { Ambience, AmbienceLink, Scape } from '../ambience/types';
-	import type { SharedAmbience, SharedAmbienceState } from '../ambience/shared';
 
 	let {
 		engine,
@@ -252,6 +287,8 @@
 	const menuId = $props.id();
 	const hintId = `${menuId}-hint`;
 	const subId = `${menuId}-sub`;
+	/** The download button's licence/source description line (jatui-0vxcu). */
+	const downloadHintId = `${menuId}-dl`;
 
 	/** Long-press duration for the pointer path to the menu. */
 	const LONG_PRESS_MS = 450;
@@ -299,6 +336,10 @@
 	 *  now-playing row's progress bar. Null on plain/remote tabs without a
 	 *  local playing instance. */
 	let playlist = $state<PlaylistState | null>(null);
+	/** The current radio scape's live snapshot (jatui-plbzq) — its error
+	 *  line (a station that stalls or dies) and status. Null on remote tabs
+	 *  without a local playing instance. */
+	let radioState = $state<RadioStreamState | null>(null);
 	/** The shared player's now-playing line (jatui-lm1mf): published by the
 	 *  leader tab, so a remote tab shows the same track attribution without
 	 *  owning the playlist instance. Null on a plain engine. */
@@ -309,6 +350,17 @@
 	let sharedTitle = $state<string | null>(null);
 	let sharedPosition = $state<number | null>(null);
 	let sharedDuration = $state<number | null>(null);
+	/** The leader's published download info (jatui-0vxcu) — a remote tab's
+	 *  download button reads this; null hides the button (not published, or
+	 *  the licence forbids redistribution). */
+	let sharedDownload = $state<SharedTrackDownload | null>(null);
+	/** The leader's published playlist shuffle state (jatui-plbzq) — a
+	 *  remote tab's Shuffle toggle reads this; null when unknown. */
+	let sharedShuffle = $state<boolean | null>(null);
+	/** True while a download fetch is in flight — the button shows its busy
+	 *  spinner and refuses re-entry. The fetch runs beside playback; nothing
+	 *  here touches the engine. */
+	let downloadBusy = $state(false);
 
 	// Wheel-volume accumulator over the open surfaces (jatui-xomny): carries
 	// the pending partial notch between wheel events so trackpad pixel deltas
@@ -337,13 +389,31 @@
 	 *  published state and routes transport commands to it. */
 	const isRemote = $derived(sharedRole === 'remote');
 	const currentIsPlaylist = $derived(isPlaylistScape(currentItem));
+	/** The current scape is a radio stream (jatui-plbzq): its now-playing
+	 *  row shows the station name + the 'Open station site' attribution
+	 *  link, and play/pause only — no tracks to skip, no download. */
+	const currentIsRadio = $derived(isRadioScape(currentItem));
+	/** The current radio scape, narrowed — carries the validated site url
+	 *  even on a remote tab (the registry is the same everywhere). */
+	const currentRadio = $derived(currentIsRadio ? (currentItem as unknown as RadioStreamScape) : null);
+	const radioSiteHref = $derived(radioSite(currentRadio));
+	/** The radio row's error line — leader/local only (a remote has no
+	 *  local instance to report through). */
+	const radioError = $derived(radioState?.status === 'error' ? (radioState.error ?? '') : '');
+	/** The Shuffle toggle's pressed state (jatui-plbzq): the playing
+	 *  playlist's own truth locally; the leader's published one remotely. */
+	const shufflePressed = $derived(
+		currentIsPlaylist ? (isRemote ? (sharedShuffle ?? playlist?.shuffle ?? false) : (playlist?.shuffle ?? false)) : false
+	);
 	/** The row exists while something is sounding or paused — a paused row
 	 *  must stay (its play button is how you resume); a stopped one hides. */
 	const showNowPlaying = $derived((playing || paused) && !!currentItem);
 	const npTitle = $derived(
-		isRemote
-			? (sharedTitle ?? '')
-			: (playlist?.track?.title ?? (currentIsPlaylist ? '' : (currentLabel ?? '')))
+		currentIsRadio
+			? (currentRadio?.label ?? '')
+			: isRemote
+				? (sharedTitle ?? '')
+				: (playlist?.track?.title ?? (currentIsPlaylist ? '' : (currentLabel ?? '')))
 	);
 	const npAttrib = $derived(
 		isRemote
@@ -360,6 +430,46 @@
 	);
 	const npPercent = $derived(progressPercent(npPosition, npDuration));
 
+	// --- download button (jatui-0vxcu) ---------------------------------------
+	/** What the download button offers right now: the playing (or paused)
+	 *  playlist track's url + ready-made filename + licence, gated by the
+	 *  licence AND by `safeAmbienceHref` — the url has to be an absolute
+	 *  http(s) one, because it is fetched and (on CORS failure) opened in a
+	 *  new tab; a `javascript:`/`data:`/scheme-relative entry means no button.
+	 *  On a remote tab the leader's publication is re-validated the same way
+	 *  (the leader is another tab, not a trusted source) — null → no button.
+	 *  Generative scapes never have one. */
+	const currentDownload = $derived.by(() => {
+		if (!showNowPlaying) return null;
+		if (isRemote) return safeSharedTrackDownload(sharedDownload);
+		const t = currentIsPlaylist ? (playlist?.track ?? null) : null;
+		if (!t || !isTrackDownloadable(t)) return null;
+		const url = safeAmbienceHref(t.url);
+		if (!url) return null;
+		return {
+			url,
+			filename: trackDownloadFilename(t),
+			license: t.license,
+			sourceUrl: t.sourceUrl
+		} satisfies SharedTrackDownload;
+	});
+	/** The button's tooltip: licence + source link — CC-BY needs attribution. */
+	const downloadTooltip = $derived(
+		currentDownload
+			? `Download ${currentDownload.filename} · ${currentDownload.license}${
+					currentDownload.sourceUrl ? ` · source: ${currentDownload.sourceUrl}` : ''
+				}`
+			: ''
+	);
+	/** The sr-only line the button's aria-describedby points at. */
+	const downloadHint = $derived(
+		currentDownload
+			? `Download as ${currentDownload.filename}. Licence: ${currentDownload.license}.${
+					currentDownload.sourceUrl ? ` Source: ${currentDownload.sourceUrl}.` : ''
+				}`
+			: ''
+	);
+
 	const BUTTON_SIZE = $derived(compact ? 'size-10' : 'size-11');
 	const ICON_SIZE = $derived(compact ? 18 : 20);
 
@@ -399,6 +509,8 @@
 			sharedTitle = s.trackTitle;
 			sharedPosition = s.trackPosition;
 			sharedDuration = s.trackDuration;
+			sharedDownload = s.trackDownload ?? null;
+			sharedShuffle = s.trackShuffle;
 		});
 	});
 
@@ -416,16 +528,47 @@
 		return item.subscribe((s) => {
 			playlist = s;
 			track = s.status === 'playing' ? s.track : null;
+			// The download rides the same publication (jatui-0vxcu): only a track
+			// whose licence permits redistribution AND whose url survives
+			// safeAmbienceHref (absolute http/https) is offered to the other tabs.
+			const t = s.status === 'playing' ? s.track : null;
+			const dlUrl = t && isTrackDownloadable(t) ? safeAmbienceHref(t.url) : null;
 			engine.setNowPlaying?.(
-				s.status === 'playing' && s.track ? nowPlayingLine(s.track) : null,
+				s.status === 'playing' && t ? nowPlayingLine(t) : null,
 				s.index,
 				s.status === 'playing' ? s.position : null,
 				s.status === 'playing' ? s.duration : null,
-				s.track?.title ?? null
+				s.track?.title ?? null,
+				t && dlUrl
+					? {
+							url: dlUrl,
+							filename: trackDownloadFilename(t),
+							license: t.license,
+							...(t.sourceUrl ? { sourceUrl: t.sourceUrl } : {})
+						}
+					: null,
+				// The Shuffle toggle's truth (jatui-plbzq): published so a remote
+				// tab renders the leader's shuffle state.
+				s.shuffle
 			);
 		});
 	});
 
+	// The current scape is a radio stream (jatui-plbzq) → follow its state
+	// for the error line (a stream that stalls or dies). The row's station
+	// name and attribution link come from the registered item itself, so a
+	// remote tab needs no publication to render them.
+	$effect(() => {
+		const item = currentItem;
+		if (!isRadioScape(item)) {
+			radioState = null;
+			return;
+		}
+		return item.subscribe((s) => {
+			radioState = s;
+		});
+	});
+
 	// Breathing glyph: follow the engine's shared breath clock while playing,
 	// and only where ambient motion is allowed (getMotionContext().ambient is
 	// false under prefers-reduced-motion AND under data-motion="calm"). The
@@ -682,6 +825,62 @@
 		if (isPlaylistScape(currentItem)) currentItem.skip();
 	}
 
+	/** The Shuffle toggle (jatui-plbzq): flip the playing playlist's
+	 *  shuffle state — the per-station preference persists, and a session's
+	 *  order is freshly shuffled with recently-heard tracks last. A remote
+	 *  routes the command to the leader (its instance owns the running
+	 *  order and the persisted preference). */
+	function onShuffleClick() {
+		const next = !shufflePressed;
+		const e = engine as SharedAmbience;
+		if (isRemote && typeof e.shuffleTrack === 'function' && currentId) {
+			e.shuffleTrack(currentId, next);
+			return;
+		}
+		if (isPlaylistScape(currentItem)) currentItem.setShuffle(next);
+	}
+
+	/**
+	 * The download button (jatui-0vxcu). A cross-origin `<a download>` is
+	 * ignored by browsers, so the file is fetched to a Blob and saved through
+	 * an object URL — the attribution filename was built by the pure helper.
+	 * A failed fetch (CORS) falls back to opening the url in a new tab. Both
+	 * the fetch and the fallback go through `safeAmbienceHref` — a url that
+	 * is not absolute http(s) (a hostile manifest, or a hostile shared-mode
+	 * leader) never reaches `window.open`. The fetch runs beside the engine —
+	 * playback is never blocked or touched.
+	 */
+	async function onDownloadClick() {
+		const info = currentDownload;
+		const href = safeAmbienceHref(info?.url);
+		if (!info || !href || downloadBusy) return;
+		downloadBusy = true;
+		try {
+			const res = await fetch(href);
+			if (!res.ok) throw new Error(`HTTP ${res.status}`);
+			const blob = await res.blob();
+			const objectUrl = URL.createObjectURL(blob);
+			const a = document.createElement('a');
+			a.href = objectUrl;
+			a.download = info.filename;
+			document.body.appendChild(a);
+			a.click();
+			a.remove();
+			// The browser has the blob reference the moment it accepts the
+			// download; the revoke is belt-and-braces housekeeping.
+			setTimeout(() => URL.revokeObjectURL(objectUrl), 10_000);
+		} catch {
+			// CORS refused or the network failed — the url still opens.
+			try {
+				window.open(href, '_blank', 'noopener,noreferrer');
+			} catch {
+				/* a blocked popup is not worth crashing over */
+			}
+		} finally {
+			downloadBusy = false;
+		}
+	}
+
 	// --- wheel volume over the open surfaces (jatui-xomny) -------------------
 	// While the menu (or one of its submenus) is open the wheel adjusts volume
 	// instead of scrolling the page — EXCEPT over a scrollable list that can
@@ -990,7 +1189,45 @@
 					{#if npTitle}
 						<p class="block truncate text-sm font-medium" title={npTitle}>{npTitle}</p>
 					{/if}
-					{#if npAttrib}
+					{#if currentIsRadio}
+						<!-- Radio (jatui-plbzq): the station's own site is the
+						     attribution — a real link, kept even though the stream
+						     now plays right here (it is fetched by the browser from
+						     the station, never relayed). A stream that stalls or
+						     dies says so instead of playing silence. -->
+						<div class="text-2xs mt-0.5 flex items-center gap-2">
+							{#if radioSiteHref}
+								<a
+									href={radioSiteHref}
+									target="_blank"
+									rel="noopener noreferrer"
+									tabindex="-1"
+									class="inline-flex min-w-0 items-center gap-1 text-primary
+										hover:underline focus-visible:underline"
+								>
+									<span class="truncate">Open station site</span>
+									<svg
+										xmlns="http://www.w3.org/2000/svg"
+										viewBox="0 0 24 24"
+										fill="none"
+										stroke="currentColor"
+										stroke-width="2"
+										stroke-linecap="round"
+										stroke-linejoin="round"
+										class="size-3 shrink-0"
+										aria-hidden="true"
+									>
+										<path d="M15 3h6v6" />
+										<path d="M10 14 21 3" />
+										<path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" />
+									</svg>
+								</a>
+							{/if}
+							{#if radioError}
+								<span class="truncate text-error" title={radioError}>{radioError}</span>
+							{/if}
+						</div>
+					{:else if npAttrib}
 						<p class="text-2xs text-base-content/55 block truncate" title={npAttrib}>{npAttrib}</p>
 					{/if}
 					{#if npDuration > 0}
@@ -1011,6 +1248,43 @@
 						</div>
 					{/if}
 					<div class="mt-1.5 flex items-center justify-center gap-1">
+						{#if currentIsPlaylist}
+							<!-- Shuffle (jatui-plbzq): an aria-pressed toggle over the
+						     playlist's fresh-per-session order (recently-heard tracks
+						     last). Persisted per station; a remote routes the toggle
+						     to the leader. -->
+							<IconButton
+								label="Shuffle"
+								variant="ghost"
+								size="sm"
+								shape="circle"
+								tooltip="Shuffle"
+								tooltipPlacement="top"
+								pressed={shufflePressed}
+								tabindex={-1}
+								data-ambience-nav
+								onclick={onShuffleClick}
+							>
+								<svg
+									xmlns="http://www.w3.org/2000/svg"
+									viewBox="0 0 24 24"
+									fill="none"
+									stroke="currentColor"
+									stroke-width="2"
+									stroke-linecap="round"
+									stroke-linejoin="round"
+									class="size-4 {shufflePressed ? 'text-primary' : ''}"
+									aria-hidden="true"
+								>
+									<!-- shuffle, lucide geometry -->
+									<path d="m18 14 4 4-4 4" />
+									<path d="m18 2 4 4-4 4" />
+									<path d="M2 18h1.973a4 4 0 0 0 3.3-1.7l5.454-8.6a4 4 0 0 1 3.3-1.7H22" />
+									<path d="M2 6h1.972a4 4 0 0 1 3.6 2.2" />
+									<path d="M22 18h-6.041a4 4 0 0 1-3.3-1.8l-.359-.45" />
+								</svg>
+							</IconButton>
+						{/if}
 						{#if currentIsPlaylist}
 							<button
 								type="button"
@@ -1064,7 +1338,67 @@
 								</svg>
 							</button>
 						{/if}
+						{#if currentDownload}
+							<!-- Download (jatui-0vxcu): only for tracks whose licence
+							     permits redistribution (or the leader's published url
+							     on a remote tab). aria-describedby points at the
+							     licence line below — the tooltip's own action also
+							     rewrites describedby while it shows, so the line stays
+							     in the row as readable content either way. -->
+							<IconButton
+								label="Download {npTitle}"
+								variant="ghost"
+								size="sm"
+								shape="circle"
+								tooltip={downloadTooltip}
+								tooltipPlacement="top"
+								aria-describedby={downloadHintId}
+								tabindex={-1}
+								data-ambience-nav
+								disabled={downloadBusy}
+								onclick={onDownloadClick}
+							>
+								{#if downloadBusy}
+									<!-- busy: the fetch is in flight (playback unaffected) -->
+									<svg
+										xmlns="http://www.w3.org/2000/svg"
+										viewBox="0 0 24 24"
+										fill="none"
+										stroke="currentColor"
+										stroke-width="2"
+										stroke-linecap="round"
+										class="jatui-dl-spin size-4"
+										aria-hidden="true"
+									>
+										<circle cx="12" cy="12" r="9" opacity="0.25" />
+										<path d="M21 12a9 9 0 0 0-9-9" />
+									</svg>
+								{:else}
+									<!-- download, lucide geometry -->
+									<svg
+										xmlns="http://www.w3.org/2000/svg"
+										viewBox="0 0 24 24"
+										fill="none"
+										stroke="currentColor"
+										stroke-width="2"
+										stroke-linecap="round"
+										stroke-linejoin="round"
+										class="size-4"
+										aria-hidden="true"
+									>
+										<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4" />
+										<polyline points="7 10 12 15 17 10" />
+										<line x1="12" y1="15" x2="12" y2="3" />
+									</svg>
+								{/if}
+							</IconButton>
+						{/if}
 					</div>
+					{#if currentDownload}
+						<!-- The licence + source the download carries — CC-BY needs
+						     attribution, so the filename alone is not enough. -->
+						<p id={downloadHintId} class="sr-only">{downloadHint}</p>
+					{/if}
 				</div>
 			{/if}
 
@@ -1315,5 +1649,20 @@
 		.now-progress-fill {
 			transition: none;
 		}
+		.jatui-dl-spin {
+			animation: none;
+		}
+	}
+
+	/* The download button's busy spinner — task feedback, not ambient motion,
+	 * but it still holds still under reduced motion. */
+	.jatui-dl-spin {
+		animation: jatui-dl-rotate 900ms linear infinite;
+	}
+
+	@keyframes jatui-dl-rotate {
+		to {
+			transform: rotate(360deg);
+		}
 	}
 </style>

package/dist/components/AmbienceToggle.svelte.d.ts

@@ -25,12 +25,28 @@
  *   - A playing (or paused) scape shows a now-playing block above the
  *     volume row (jatui-153tz): for a playlist — the track title, its
  *     composer · license attribution, an elapsed/total progress bar and a
- *     prev / play-pause / next transport (prev restarts the track when more
- *     than 3 s are in, else goes back one; play-pause freezes the station
- *     without closing the menu; next skips). Generative scapes (noise /
- *     focus) get the play/pause control only. The transport joins the
- *     menu's roving order; a paused row stays visible (its play button is
- *     the resume) and a stopped one hides.
+ *     shuffle / prev / play-pause / next transport (shuffle is an
+ *     aria-pressed IconButton, persisted per station and fresh-shuffled
+ *     per session with no-repeat — jatui-plbzq; prev restarts the track
+ *     when more than 3 s are in, else goes back one; play-pause freezes
+ *     the station without closing the menu; next skips). Generative
+ *     scapes (noise / focus) get the play/pause control only. A radio
+ *     station registered with a public `streamUrl` (jatui-plbzq) gets the
+ *     station name, a `Open station site` attribution link and
+ *     play/pause — the stream is fetched by the browser from the station
+ *     itself, never relayed. The transport joins the menu's roving order;
+ *     a paused row stays visible (its play button is the resume) and a
+ *     stopped one hides.
+ *   - Playlists whose licence permits redistribution (jatui-0vxcu: CC0,
+ *     public domain, CC-BY, CC-BY-SA — never NC/ND unless the manifest
+ *     marks the track `downloadable: true`) also get a Download button
+ *     next to the transport: the track url is fetched to a Blob (a plain
+ *     cross-origin `<a download>` is ignored), saved under
+ *     "Composer - Title.ext" so attribution travels with the file, and a
+ *     CORS failure falls back to opening the url in a new tab. The busy
+ *     spinner never blocks playback. Shared mode: a remote tab downloads
+ *     the leader's published track url (`SharedAmbienceState.trackDownload`)
+ *     — or hides the button when the leader published none.
  *   - A playing playlist shows its current track's attribution (title,
  *     composer, license) under the playlist item and its section row.
  *   - With a menu or submenu open, the mouse wheel over that surface
@@ -68,6 +84,11 @@ export type AmbienceScapeGroup = AmbienceSection;
 export declare function groupScapes(items: AmbienceItem[], groups?: ReadonlyArray<ScapeGroup | AmbienceGroupDef>): AmbienceScapeGroup[];
 /** "Gymnopédie No. 1 — Erik Satie · Public domain": a playing track's line. */
 export declare function nowPlayingLine(track: PlaylistTrack | null | undefined): string;
+/** The radio row's attribution href (jatui-plbzq): the scape's site url
+ *  re-validated with `safeAmbienceHref` — the registry could be hostile
+ *  on a remote tab too, and the leader is another tab, not a source of
+ *  trust. Null hides the 'Open station site' link. */
+export declare function radioSite(scape: RadioStreamScape | null | undefined): string | null;
 /** "3:07" — m:ss for the now-playing row's elapsed/total (jatui-153tz). */
 export declare function formatTrackTime(seconds: number | null | undefined): string;
 /** The now-playing progress fill, 0–100, clamped; 0 without a duration. */
@@ -141,8 +162,9 @@ export declare function wheelVolumeSteps(acc: {
  * slider itself would produce for the same value.
  */
 export declare function volumeAfterSteps(volume: number, steps: number, stepPct?: number): number;
-import type { Ambience } from '../ambience/types';
+import { type RadioStreamScape } from '../ambience/scapes/radio';
 import type { SharedAmbience } from '../ambience/shared';
+import type { Ambience } from '../ambience/types';
 type $$ComponentProps = {
     /** The engine instance (from `createAmbience()`). The component never creates one, and never kills it — the host owns the engine's lifecycle. Section order/labels come from the engine's `groups` option. With the cross-tab shared player (jatui-lm1mf, `createAmbience({ shared: true })`) a plain `Ambience` is also accepted: the shared now-playing line is only read when the engine publishes one. */
     engine: Ambience | SharedAmbience;

package/dist/index.d.ts

@@ -417,10 +417,11 @@ export { default as ImageReveal } from './components/ImageReveal.svelte';
 export { imageRevealPhase, imageRevealBusy, imageRevealInitials, imageRevealSize, imageRevealTone, IMAGE_REVEAL_SIZES, IMAGE_REVEAL_RADIUS } from './components/imageReveal';
 export type { ImageRevealPhase, ImageRevealShape, ImageRevealSizeName, ImageRevealToneName, ImageRevealState } from './components/imageReveal';
 export { default as AmbienceToggle, AMBIENCE_GROUP_ORDER } from './components/AmbienceToggle.svelte';
-export { createAmbience, createAmbienceLocal, createSharedAmbience, AMBIENCE_CHANNEL, AMBIENCE_LOCK, createDefaultAmbience, DEFAULT_SCAPES, BreathClock, BREATHS_PER_MINUTE, MASTER, ScapeRegistry, hibiscusScape, focusScape, noiseScapes, brownNoiseScape, pinkNoiseScape, whiteNoiseScape, rain, waves, AMBIENCE_DEFAULT_GROUP_ORDER, AMBIENCE_DEFAULT_GROUP_LABELS, groupAmbienceItems, ambienceGroupLabel, isAmbienceLink, normalizeAmbienceGroups, radioStation, safeAmbienceHref } from './ambience';
-export type { DefaultAmbienceOptions, AmbienceSection } from './ambience';
+export { createAmbience, createAmbienceLocal, createSharedAmbience, AMBIENCE_CHANNEL, AMBIENCE_LOCK, createDefaultAmbience, DEFAULT_SCAPES, BreathClock, BREATHS_PER_MINUTE, MASTER, ScapeRegistry, hibiscusScape, focusScape, noiseScapes, brownNoiseScape, pinkNoiseScape, whiteNoiseScape, rain, waves, AMBIENCE_DEFAULT_GROUP_ORDER, AMBIENCE_DEFAULT_GROUP_LABELS, groupAmbienceItems, ambienceGroupLabel, isAmbienceLink, normalizeAmbienceGroups, radioStation, createRadioStreamScape, isRadioScape, safeAmbienceHref } from './ambience';
+export type { DefaultAmbienceOptions, AmbienceSection, RadioStreamScape, RadioStreamState, RadioStreamScapeOptions, RadioStreamStatus } from './ambience';
 export type { SharedAmbience, SharedAmbienceState, SharedAmbienceOptions } from './ambience';
 export type { Ambience, AmbienceGroupDef, AmbienceItem, AmbienceLink, AmbienceOptions, AmbienceState, BreathState, Scape, ScapeContext, ScapeGroup, ScapeInstance } from './ambience';
 export { createPlaylistScape } from './ambience';
 export { isPlaylistScape, trackAttribution } from './ambience';
+export { trackLicenseAllowsRedistribution, isTrackDownloadable, trackDownloadFilename } from './ambience';
 export type { PlaylistScape, PlaylistScapeOptions, PlaylistManifest, PlaylistState, PlaylistStatus, PlaylistTrack } from './ambience';

package/dist/index.js

@@ -464,8 +464,12 @@ export { imageRevealPhase, imageRevealBusy, imageRevealInitials, imageRevealSize
 // navigation; createDefaultAmbience() pre-registers every shipped scape
 // (hibiscus, focus, brown/pink/white noise, rain, waves).
 export { default as AmbienceToggle, AMBIENCE_GROUP_ORDER } from './components/AmbienceToggle.svelte';
-export { createAmbience, createAmbienceLocal, createSharedAmbience, AMBIENCE_CHANNEL, AMBIENCE_LOCK, createDefaultAmbience, DEFAULT_SCAPES, BreathClock, BREATHS_PER_MINUTE, MASTER, ScapeRegistry, hibiscusScape, focusScape, noiseScapes, brownNoiseScape, pinkNoiseScape, whiteNoiseScape, rain, waves, AMBIENCE_DEFAULT_GROUP_ORDER, AMBIENCE_DEFAULT_GROUP_LABELS, groupAmbienceItems, ambienceGroupLabel, isAmbienceLink, normalizeAmbienceGroups, radioStation, safeAmbienceHref } from './ambience';
+export { createAmbience, createAmbienceLocal, createSharedAmbience, AMBIENCE_CHANNEL, AMBIENCE_LOCK, createDefaultAmbience, DEFAULT_SCAPES, BreathClock, BREATHS_PER_MINUTE, MASTER, ScapeRegistry, hibiscusScape, focusScape, noiseScapes, brownNoiseScape, pinkNoiseScape, whiteNoiseScape, rain, waves, AMBIENCE_DEFAULT_GROUP_ORDER, AMBIENCE_DEFAULT_GROUP_LABELS, groupAmbienceItems, ambienceGroupLabel, isAmbienceLink, normalizeAmbienceGroups, radioStation, createRadioStreamScape, isRadioScape, safeAmbienceHref } from './ambience';
 // Playlist scape (phase 2) — per-host, never in DEFAULT_SCAPES: build with
 // createPlaylistScape() and register on the engine yourself.
 export { createPlaylistScape } from './ambience';
 export { isPlaylistScape, trackAttribution } from './ambience';
+// Download gate + filename builder (jatui-0vxcu) — the licence allowlist
+// (CC0 / public domain / CC-BY / CC-BY-SA), the per-track override and the
+// "Composer - Title.ext" name attribution travels under.
+export { trackLicenseAllowsRedistribution, isTrackDownloadable, trackDownloadFilename } from './ambience';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.61.0",
+  "version": "0.63.0",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",