@joewinke/jatui 0.54.1 → 0.55.0

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

@@ -5,16 +5,25 @@
  *
  * Interaction contract:
  *   - Click (or Space/Enter) = play / stop the last scape. A gesture-gated
- *     engine call, made synchronously inside the click handler.
- *   - The scape menu (menu button pattern) opens with ArrowDown/ArrowUp,
- *     a press-and-hold (~450 ms) or a right-click (Android/Chrome fire
+ *     engine call, made synchronously inside the click handler. With no
+ *     playable scape registered (links only) the click opens the menu.
+ *   - The menu (menu button pattern) opens with ArrowDown/ArrowUp, a
+ *     press-and-hold (~450 ms) or a right-click (Android/Chrome fire
  *     contextmenu on touch holds; iOS may cancel the pointer instead —
- *     the keyboard path always works). It lists every
- *     registered scape grouped meditation / focus / noise / nature / music
- *     (`menuitemradio` items, current scape checked), carries a volume
- *     slider wired to `engine.setVolume`, and shows each scape's
- *     `description` as its secondary line — playlist scapes put their
- *     track attribution there.
+ *     the keyboard path always works). Top level: a volume slider wired to
+ *     `engine.setVolume`, then one row per section — Radio / Focus /
+ *     Noise / Meditation … in the host's order (`AmbienceOptions.groups`,
+ *     jatui-mdq2p) — each opening a submenu of its items. Right / Enter /
+ *     Space open a submenu and move focus into it; Left / Escape close it
+ *     and return focus to its row (the ContextMenu submenu pattern); a
+ *     mouse hover opens a row's submenu without moving focus.
+ *   - Scapes are `menuitemradio` (current one checked; its section row
+ *     carries a dot and the scape's name). Link items (radio stations) are
+ *     real `<a target="_blank">` menu items with an external-link glyph:
+ *     the station's own site or player opens in a new tab. Nothing is
+ *     relayed — we never proxy a third-party stream.
+ *   - A playing playlist shows its current track's attribution (title,
+ *     composer, license) under the playlist item and its section row.
  *
  * A11y: the trigger is `aria-pressed` while playing and carries the full
  * menu-button wiring (`aria-expanded` / `aria-haspopup` / `aria-controls`).
@@ -27,24 +36,24 @@
  * Token-only theming (DaisyUI + `--jatui-*` + `--motion-*`). SSR-safe: the
  * engine is lazy and nothing here touches `window` at import.
  */
-import type { Ambience, Scape, ScapeGroup } from '../ambience/types';
-/** Canonical menu group order (the Scape contract's groups). */
+import type { AmbienceGroupDef, AmbienceItem, ScapeGroup } from '../ambience/types';
+import { type AmbienceSection } from '../ambience/groups';
+import { type PlaylistTrack } from '../ambience/scapes/playlist';
+/** Default menu section order (when the host configures no `groups`). */
 export declare const AMBIENCE_GROUP_ORDER: readonly ScapeGroup[];
-/** Human labels for the canonical groups. */
-export declare const GROUP_LABELS: Readonly<Record<ScapeGroup, string>>;
-/** One grouped section of the scape menu. */
-export interface AmbienceScapeGroup {
-    group: ScapeGroup;
-    label: string;
-    scapes: Scape[];
-}
+/** Human labels for the library's own groups. */
+export declare const GROUP_LABELS: Readonly<Record<string, string>>;
+/** One section of the menu: a top-level row and its submenu. */
+export type AmbienceScapeGroup = AmbienceSection;
 /**
- * Group scapes for the menu: canonical group order, registration order
- * within a group, empty groups omitted. A group outside the union (a
- * registry from a newer engine) still renders, after the known ones, in
- * first-seen order — a menu never silently drops a registered scape.
+ * Group items for the menu: the host's section order (or the default),
+ * registration order within a section, empty sections omitted. A group
+ * missing from the order still renders, after the ordered ones, in
+ * first-seen order — a menu never silently drops a registered item.
  */
-export declare function groupScapes(scapes: Scape[]): AmbienceScapeGroup[];
+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 live label — "Ambience: Hibiscus, playing" while sounding,
  * "Ambience: Hibiscus, stopped" once a scape has been selected but is not
@@ -61,8 +70,30 @@ export declare const PLAY_ERROR_LABEL = "Ambience: couldn't start \u2014 tap aga
  * and settles on the exhale — 6% total, clamped against out-of-range input.
  */
 export declare function breathScale(value: number): number;
+/** Submenu width (px) — matches the `w-64` class on the submenu panel. */
+export declare const SUBMENU_WIDTH = 256;
+/**
+ * Where a submenu goes, in viewport px. Beside the menu panel on the
+ * preferred side (the side the menu already extends to), else the other
+ * side, else — a phone, no room either side — overlapping the panel just
+ * below its row, clamped inside the viewport.
+ */
+export declare function placeSubmenu(row: {
+    top: number;
+    bottom: number;
+}, panel: {
+    left: number;
+    right: number;
+}, viewport: {
+    width: number;
+}, prefer: 'left' | 'right', width?: number, gap?: number, margin?: number): {
+    x: number;
+    y: number;
+    side: 'left' | 'right' | 'over';
+};
+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. */
+    /** 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. */
     engine: Ambience;
     /** Smaller app-shell footprint: 40px trigger with an 18px glyph (default 44px / 20px). Never below the 40px touch floor. */
     compact?: boolean;

package/dist/index.d.ts

@@ -408,8 +408,9 @@ 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, createDefaultAmbience, DEFAULT_SCAPES, BreathClock, BREATHS_PER_MINUTE, MASTER, ScapeRegistry, hibiscusScape, focusScape, noiseScapes, brownNoiseScape, pinkNoiseScape, whiteNoiseScape, rain, waves } from './ambience';
-export type { DefaultAmbienceOptions } from './ambience';
-export type { Ambience, AmbienceOptions, AmbienceState, BreathState, Scape, ScapeContext, ScapeGroup, ScapeInstance } from './ambience';
+export { createAmbience, 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 type { Ambience, AmbienceGroupDef, AmbienceItem, AmbienceLink, AmbienceOptions, AmbienceState, BreathState, Scape, ScapeContext, ScapeGroup, ScapeInstance } from './ambience';
 export { createPlaylistScape } from './ambience';
+export { isPlaylistScape, trackAttribution } from './ambience';
 export type { PlaylistScape, PlaylistScapeOptions, PlaylistManifest, PlaylistState, PlaylistStatus, PlaylistTrack } from './ambience';

package/dist/index.js

@@ -457,7 +457,8 @@ 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, createDefaultAmbience, DEFAULT_SCAPES, BreathClock, BREATHS_PER_MINUTE, MASTER, ScapeRegistry, hibiscusScape, focusScape, noiseScapes, brownNoiseScape, pinkNoiseScape, whiteNoiseScape, rain, waves } from './ambience';
+export { createAmbience, 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';
 // 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';

package/package.json

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