@applicaster/zapp-react-native-ui-components 16.0.0-rc.33 → 16.0.0-rc.34

package/Components/ModalComponent/AudioPlayer/Components/Item.tsx

@@ -0,0 +1,709 @@
+/**
+ * Modal Building Block — Item (Queue / Playlist)
+ *
+ * Single-file Expo Snack demo. Three item forms driven by configuration + data.
+ *
+ * Green (configurable): background, image, nowPlayingAsset, nowPlayingLabel,
+ *   textLabel1, textLabel2
+ * White (hardcoded): container padding/gutters, nowPlaying container layout,
+ *   button sizes/padding/assets
+ *
+ * Variants (VARIANT_*) are preset configuration bundles — not passed as a field.
+ */
+
+import React from "react";
+import { Image, Platform, StyleSheet, Text, View } from "react-native";
+
+const styles = StyleSheet.create({
+  row: {
+    flexDirection: "row",
+    alignItems: "center",
+  },
+  contentColumn: {
+    flex: 1,
+    justifyContent: "center",
+  },
+  buttonsRow: {
+    flexDirection: "row",
+    alignItems: "center",
+  },
+  demoScreen: {
+    flex: 1,
+    backgroundColor: "#1C1C1E",
+    paddingTop: 64,
+    paddingHorizontal: 0,
+    gap: 16,
+  },
+  demoHeading: {
+    color: "#FFFFFF",
+    fontSize: 20,
+    fontWeight: "600",
+    marginBottom: 8,
+    paddingHorizontal: 16,
+  },
+  demoLabel: {
+    color: "#999999",
+    fontSize: 13,
+    paddingHorizontal: 16,
+  },
+});
+
+// ---------------------------------------------------------------------------
+// Configuration (green fields)
+// ---------------------------------------------------------------------------
+
+export type TextTransform =
+  | "default"
+  | "lowercase"
+  | "uppercase"
+  | "capitalize";
+
+export type BackgroundConfiguration = {
+  defaultColor: string;
+  focusedColor: string;
+  cornerRadius: number;
+};
+
+export type ImageConfiguration = {
+  width: number;
+  height: number;
+  borderWidth: number;
+  borderColor: string;
+  cornerRadius: number;
+};
+
+export type LabelConfiguration = {
+  fontColor: string;
+  focusedFontColor?: string;
+  iosFontFamily: string;
+  androidFontFamily: string;
+  fontSize: number;
+  lineHeight: number;
+  iosLetterSpacing: number;
+  androidLetterSpacing: number;
+  textTransform: TextTransform;
+};
+
+export type NowPlayingAssetConfiguration = {
+  asset?: string;
+};
+
+export type ItemConfiguration = {
+  background: BackgroundConfiguration;
+  image: ImageConfiguration;
+  nowPlayingAsset: NowPlayingAssetConfiguration;
+  nowPlayingLabel: LabelConfiguration;
+  textLabel1: LabelConfiguration;
+  textLabel2: LabelConfiguration;
+};
+
+export interface Action {
+  type: string;
+  payload?: any;
+  options?: any;
+}
+
+export interface Header {
+  title: string;
+  subtitle?: string;
+  icon?: string;
+}
+
+export interface Content {
+  title: string;
+  stickyTitle?: boolean;
+  items: MenuItem[];
+  itemsUrl?: string;
+  action?: Action;
+}
+
+export interface Menu {
+  header?: Header;
+  content: Content;
+  closeButton?: boolean;
+}
+
+export interface PresentSubMenuAction extends Action {
+  menu: Menu;
+}
+
+export interface SecondaryAction {
+  action: Action | PresentSubMenuAction;
+  icon?: string;
+}
+
+export interface MenuItem {
+  title: string;
+  summary?: string;
+  icon?: string;
+  isSelected?: boolean;
+  action?: Action | PresentSubMenuAction;
+  secondaryAction?: SecondaryAction;
+}
+
+export const DEFAULT_TEXT_LABEL_1_CONFIGURATION: LabelConfiguration = {
+  fontColor: "#FFFFFF",
+  focusedFontColor: "#FFFFFF",
+  iosFontFamily: "SFProText-Semibold",
+  androidFontFamily: "Roboto-Medium",
+  fontSize: 15,
+  lineHeight: 18,
+  iosLetterSpacing: -0.2,
+  androidLetterSpacing: 0,
+  textTransform: "default",
+};
+
+export const DEFAULT_TEXT_LABEL_2_CONFIGURATION: LabelConfiguration = {
+  fontColor: "#999999",
+  iosFontFamily: "SFProText-Medium",
+  androidFontFamily: "Roboto-Medium",
+  fontSize: 13,
+  lineHeight: 16,
+  iosLetterSpacing: -0.1,
+  androidLetterSpacing: 0,
+  textTransform: "default",
+};
+
+export const DEFAULT_NOW_PLAYING_LABEL_CONFIGURATION: LabelConfiguration = {
+  fontColor: "#FFFFFF",
+  iosFontFamily: "SFProText-Semibold",
+  androidFontFamily: "Roboto-Medium",
+  fontSize: 13,
+  lineHeight: 16,
+  iosLetterSpacing: 0,
+  androidLetterSpacing: 0,
+  textTransform: "default",
+};
+
+// ---------------------------------------------------------------------------
+// Data
+// ---------------------------------------------------------------------------
+
+export type ItemButtonAction = "playPause" | "drag" | "multiSelect" | "remove";
+
+export type ItemData = {
+  imageUri?: string;
+  textLabel1: string;
+  textLabel2: string;
+  /** When set, shows the Now Playing row (equalizer + label). */
+  nowPlayingLabel?: string;
+  /** Button 2 (left most) — hardcoded action decides icon. */
+  leadingButton?: ItemButtonAction;
+  /** Button 1 (right most) — hardcoded action decides icon. */
+  trailingButton?: ItemButtonAction;
+};
+
+export type ItemProps = {
+  configuration: ItemConfiguration;
+  data: ItemData;
+  focused?: boolean;
+  focusedLeadingButton?: boolean;
+  focusedTrailingButton?: boolean;
+};
+
+// ---------------------------------------------------------------------------
+// Hardcoded (white fields)
+// ---------------------------------------------------------------------------
+
+type ContainerSpec = {
+  paddingTop: number;
+  paddingRight: number;
+  paddingBottom: number;
+  paddingLeft: number;
+  horizontalGutter: number;
+  verticalGutter: number;
+};
+
+type ButtonLayoutSpec = {
+  assetWidth: number;
+  assetHeight: number;
+  paddingTop: number;
+  paddingRight: number;
+  paddingBottom: number;
+  paddingLeft: number;
+};
+
+const CONTAINER_SPEC_LARGE_IMAGE: ContainerSpec = {
+  paddingTop: 8,
+  paddingRight: 20,
+  paddingBottom: 8,
+  paddingLeft: 20,
+  horizontalGutter: 12,
+  verticalGutter: 2,
+};
+
+const CONTAINER_SPEC_DEFAULT: ContainerSpec = {
+  paddingTop: 8,
+  paddingRight: 10,
+  paddingBottom: 8,
+  paddingLeft: 10,
+  horizontalGutter: 12,
+  verticalGutter: 2,
+};
+
+const BUTTONS_CONTAINER_HORIZONTAL_GUTTER = 4;
+
+const NOW_PLAYING_CONTAINER_SPEC = {
+  horizontalGutter: 4,
+  marginTop: 0,
+  marginRight: 0,
+  marginBottom: 6,
+  marginLeft: 0,
+};
+
+const NOW_PLAYING_ASSET_SPEC = {
+  width: 16,
+  height: 16,
+};
+
+const BUTTON_LAYOUT_SPEC: Record<ItemButtonAction, ButtonLayoutSpec> = {
+  playPause: {
+    assetWidth: 44,
+    assetHeight: 44,
+    paddingTop: 0,
+    paddingRight: 0,
+    paddingBottom: 0,
+    paddingLeft: 0,
+  },
+  drag: {
+    assetWidth: 24,
+    assetHeight: 24,
+    paddingTop: 10,
+    paddingRight: 10,
+    paddingBottom: 10,
+    paddingLeft: 10,
+  },
+  multiSelect: {
+    assetWidth: 24,
+    assetHeight: 24,
+    paddingTop: 10,
+    paddingRight: 10,
+    paddingBottom: 10,
+    paddingLeft: 10,
+  },
+  remove: {
+    assetWidth: 24,
+    assetHeight: 24,
+    paddingTop: 10,
+    paddingRight: 10,
+    paddingBottom: 10,
+    paddingLeft: 10,
+  },
+};
+
+const DEFAULT_THUMB_ASSET =
+  "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAAQklEQVR42u3PMQ0AAAgDsEmcfzNggZekRwU0beezCAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAhcLQVXaABdK6k6AAAAAElFTkSuQmCC";
+
+const DEFAULT_EQUALIZER_ASSET =
+  "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAI0lEQVR42mNgGNTgPxTQzwB0DVQ3gKCBowbQwYAhkBIHBAAA9TvPMeOFaLMAAAAASUVORK5CYII=";
+
+const BUTTON_ASSETS: Record<ItemButtonAction, string> = {
+  playPause:
+    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAsCAYAAAAehFoBAAAAdklEQVR42u3ZwRUAERAEUfkn3TaF5TFTrSuCf3CgjZGg6ast7G8YaAlcB8JAj8F1MRR2G63CUNglNAqsRvmB1TAfsBoXcMABV4MFKEci4IADNrkAed2H80R66SHqvUvglh/ktoZcL5H7MHKBx/5xYH+RsP90t5t2UpF6+22a+AAAAABJRU5ErkJggg==",
+  drag: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAAIklEQVR42mNgGAWjYGiC/2SCwWPBaByMxsFoHIyCUTDYAAAqhk7AVXdZJwAAAABJRU5ErkJggg==",
+  multiSelect:
+    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAAWklEQVR42t2VUQ4AIAhCvf+lrQsULJJZbH7GM1cS0Uk5dd0Qqcz4GJSCSs0pSCkAHNoWBfkTgIxpgGK+ujyEKABqRGyn9FO1A+yfrf+qsGxTSx5YEs2WyU9oAKBJKg8Kfq4dAAAAAElFTkSuQmCC",
+  remove:
+    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAAUklEQVR42mNgGPbgPx5AVYOJlSPJcGqrJU8DKXooCVui9FIacXj1UyNl4DWDLhYgc8nA+INpeFgwtCOZ5vmALjmZ5mURXUpTutQHdKnRRgEMAACwjWWprU1B+AAAAABJRU5ErkJggg==",
+};
+
+function getTextTransformStyle(
+  textTransform: TextTransform
+): "none" | "lowercase" | "uppercase" | "capitalize" {
+  return textTransform === "default" ? "none" : textTransform;
+}
+
+function getFontFamily(ios: string, android: string) {
+  return Platform.select({ ios, android, default: android });
+}
+
+/** Hardcoded: large image (72) uses wider horizontal container padding. */
+function resolveContainerSpec(image: ImageConfiguration): ContainerSpec {
+  return image.width >= 72
+    ? CONTAINER_SPEC_LARGE_IMAGE
+    : CONTAINER_SPEC_DEFAULT;
+}
+
+function mapMenuItemToNowPlayingData(item: MenuItem): ItemData {
+  return {
+    imageUri: item.icon,
+    textLabel1: item.title,
+    textLabel2: item.summary ?? "",
+    nowPlayingLabel: "Now Playing",
+    trailingButton: "playPause",
+  };
+}
+
+function mapMenuItemToQueuedData(item: MenuItem): ItemData {
+  return {
+    imageUri: item.icon,
+    textLabel1: item.title,
+    textLabel2: item.summary ?? "",
+    leadingButton: "remove",
+    trailingButton: "drag",
+  };
+}
+
+function mapMenuItemToPlaylistData(item: MenuItem): ItemData {
+  return {
+    imageUri: item.icon,
+    textLabel1: item.title,
+    textLabel2: item.summary ?? "",
+    trailingButton: "multiSelect",
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Inner components
+// ---------------------------------------------------------------------------
+
+type ItemContainerProps = {
+  image: ImageConfiguration;
+  background: BackgroundConfiguration;
+  focused: boolean;
+  children: React.ReactNode;
+};
+
+function ItemContainer({
+  image,
+  background,
+  focused,
+  children,
+}: ItemContainerProps) {
+  const container = resolveContainerSpec(image);
+  const bg = focused ? background.focusedColor : background.defaultColor;
+
+  return (
+    <View
+      style={{
+        backgroundColor: bg,
+        borderRadius: background.cornerRadius,
+        paddingTop: container.paddingTop,
+        paddingRight: container.paddingRight,
+        paddingBottom: container.paddingBottom,
+        paddingLeft: container.paddingLeft,
+      }}
+    >
+      {children}
+    </View>
+  );
+}
+
+type ItemThumbnailProps = {
+  configuration: ImageConfiguration;
+  imageUri?: string;
+};
+
+function ItemThumbnail({ configuration, imageUri }: ItemThumbnailProps) {
+  return (
+    <Image
+      source={{ uri: imageUri ?? DEFAULT_THUMB_ASSET }}
+      style={{
+        width: configuration.width,
+        height: configuration.height,
+        borderWidth: configuration.borderWidth,
+        borderColor: configuration.borderColor,
+        borderRadius: configuration.cornerRadius,
+      }}
+      resizeMode="cover"
+    />
+  );
+}
+
+type ItemLabelProps = {
+  text: string;
+  configuration: LabelConfiguration;
+  focused?: boolean;
+};
+
+function ItemLabel({ text, configuration, focused = false }: ItemLabelProps) {
+  const color =
+    focused && configuration.focusedFontColor
+      ? configuration.focusedFontColor
+      : configuration.fontColor;
+
+  return (
+    <Text
+      style={{
+        color,
+        fontSize: configuration.fontSize,
+        lineHeight: configuration.lineHeight,
+        letterSpacing:
+          Platform.OS === "ios"
+            ? configuration.iosLetterSpacing
+            : configuration.androidLetterSpacing,
+        fontFamily: getFontFamily(
+          configuration.iosFontFamily,
+          configuration.androidFontFamily
+        ),
+        textTransform: getTextTransformStyle(configuration.textTransform),
+      }}
+      numberOfLines={1}
+    >
+      {text}
+    </Text>
+  );
+}
+
+type NowPlayingRowProps = {
+  assetConfiguration: NowPlayingAssetConfiguration;
+  labelConfiguration: LabelConfiguration;
+  label: string;
+};
+
+function NowPlayingRow({
+  assetConfiguration,
+  labelConfiguration,
+  label,
+}: NowPlayingRowProps) {
+  const asset = assetConfiguration.asset ?? DEFAULT_EQUALIZER_ASSET;
+
+  return (
+    <View
+      style={{
+        flexDirection: "row",
+        alignItems: "center",
+        marginTop: NOW_PLAYING_CONTAINER_SPEC.marginTop,
+        marginRight: NOW_PLAYING_CONTAINER_SPEC.marginRight,
+        marginBottom: NOW_PLAYING_CONTAINER_SPEC.marginBottom,
+        marginLeft: NOW_PLAYING_CONTAINER_SPEC.marginLeft,
+      }}
+    >
+      <Image
+        source={{ uri: asset }}
+        style={{
+          width: NOW_PLAYING_ASSET_SPEC.width,
+          height: NOW_PLAYING_ASSET_SPEC.height,
+        }}
+        resizeMode="contain"
+      />
+      <View style={{ width: NOW_PLAYING_CONTAINER_SPEC.horizontalGutter }} />
+      <ItemLabel text={label} configuration={labelConfiguration} />
+    </View>
+  );
+}
+
+type ItemButtonProps = {
+  action: ItemButtonAction;
+  focused?: boolean;
+};
+
+function ItemButton({ action, focused = false }: ItemButtonProps) {
+  const layout = BUTTON_LAYOUT_SPEC[action];
+
+  return (
+    <View
+      style={{
+        paddingTop: layout.paddingTop,
+        paddingRight: layout.paddingRight,
+        paddingBottom: layout.paddingBottom,
+        paddingLeft: layout.paddingLeft,
+        opacity: focused ? 0.7 : 1,
+      }}
+    >
+      <Image
+        source={{ uri: BUTTON_ASSETS[action] }}
+        style={{ width: layout.assetWidth, height: layout.assetHeight }}
+        resizeMode="contain"
+      />
+    </View>
+  );
+}
+
+type ItemButtonsProps = {
+  leadingButton?: ItemButtonAction;
+  trailingButton?: ItemButtonAction;
+  focusedLeadingButton?: boolean;
+  focusedTrailingButton?: boolean;
+};
+
+function ItemButtons({
+  leadingButton,
+  trailingButton,
+  focusedLeadingButton = false,
+  focusedTrailingButton = false,
+}: ItemButtonsProps) {
+  if (!leadingButton && !trailingButton) {
+    return null;
+  }
+
+  return (
+    <View style={styles.buttonsRow}>
+      {leadingButton ? (
+        <>
+          <ItemButton action={leadingButton} focused={focusedLeadingButton} />
+          <View style={{ width: BUTTONS_CONTAINER_HORIZONTAL_GUTTER }} />
+        </>
+      ) : null}
+      {trailingButton ? (
+        <ItemButton action={trailingButton} focused={focusedTrailingButton} />
+      ) : null}
+    </View>
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Item
+// ---------------------------------------------------------------------------
+
+export function Item({
+  configuration,
+  data,
+  focused = false,
+  focusedLeadingButton = false,
+  focusedTrailingButton = false,
+}: ItemProps) {
+  const {
+    background,
+    image,
+    nowPlayingAsset,
+    nowPlayingLabel,
+    textLabel1,
+    textLabel2,
+  } = configuration;
+
+  const container = resolveContainerSpec(image);
+  const showNowPlaying = !!data.nowPlayingLabel;
+
+  return (
+    <ItemContainer image={image} background={background} focused={focused}>
+      <View style={styles.row}>
+        <ItemThumbnail configuration={image} imageUri={data.imageUri} />
+        <View style={{ width: container.horizontalGutter }} />
+        <View style={styles.contentColumn}>
+          {showNowPlaying ? (
+            <>
+              <NowPlayingRow
+                assetConfiguration={nowPlayingAsset}
+                labelConfiguration={nowPlayingLabel}
+                label={data.nowPlayingLabel}
+              />
+              <View style={{ height: container.verticalGutter }} />
+            </>
+          ) : null}
+          <ItemLabel
+            text={data.textLabel1}
+            configuration={textLabel1}
+            focused={focused}
+          />
+          <View style={{ height: container.verticalGutter }} />
+          <ItemLabel text={data.textLabel2} configuration={textLabel2} />
+        </View>
+        <ItemButtons
+          leadingButton={data.leadingButton}
+          trailingButton={data.trailingButton}
+          focusedLeadingButton={focusedLeadingButton}
+          focusedTrailingButton={focusedTrailingButton}
+        />
+      </View>
+    </ItemContainer>
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Variant presets — collections of configuration keys (not a variant field)
+// ---------------------------------------------------------------------------
+
+/** Variant 1 — Now Playing */
+export const VARIANT_NOW_PLAYING: ItemConfiguration = {
+  background: {
+    defaultColor: "transparent",
+    focusedColor: "transparent",
+    cornerRadius: 0,
+  },
+  image: {
+    width: 72,
+    height: 72,
+    borderWidth: 1,
+    borderColor: "rgba(255, 255, 255, 0.1)",
+    cornerRadius: 8,
+  },
+  nowPlayingAsset: {},
+  nowPlayingLabel: DEFAULT_NOW_PLAYING_LABEL_CONFIGURATION,
+  textLabel1: DEFAULT_TEXT_LABEL_1_CONFIGURATION,
+  textLabel2: DEFAULT_TEXT_LABEL_2_CONFIGURATION,
+};
+
+/** Default / Variant 2 — Queued Item */
+export const VARIANT_QUEUED_ITEM: ItemConfiguration = {
+  background: {
+    defaultColor: "transparent",
+    focusedColor: "rgba(62, 62, 62, 1)",
+    cornerRadius: 12,
+  },
+  image: {
+    width: 48,
+    height: 48,
+    borderWidth: 1,
+    borderColor: "rgba(255, 255, 255, 0.1)",
+    cornerRadius: 6,
+  },
+  nowPlayingAsset: {},
+  nowPlayingLabel: DEFAULT_NOW_PLAYING_LABEL_CONFIGURATION,
+  textLabel1: DEFAULT_TEXT_LABEL_1_CONFIGURATION,
+  textLabel2: DEFAULT_TEXT_LABEL_2_CONFIGURATION,
+};
+
+/** Variant 3 — Playlist Item */
+export const VARIANT_PLAYLIST_ITEM: ItemConfiguration = {
+  background: {
+    defaultColor: "transparent",
+    focusedColor: "rgba(62, 62, 62, 1)",
+    cornerRadius: 12,
+  },
+  image: {
+    width: 48,
+    height: 48,
+    borderWidth: 1,
+    borderColor: "rgba(255, 255, 255, 0.1)",
+    cornerRadius: 6,
+  },
+  nowPlayingAsset: {},
+  nowPlayingLabel: DEFAULT_NOW_PLAYING_LABEL_CONFIGURATION,
+  textLabel1: DEFAULT_TEXT_LABEL_1_CONFIGURATION,
+  textLabel2: DEFAULT_TEXT_LABEL_2_CONFIGURATION,
+};
+
+export default function App() {
+  // Hardcoded core mock data objects matching user types framework
+  const sharedMockItem: MenuItem = {
+    title: "Content Title",
+    summary: "Artist",
+    icon: "https://picsum.photos/200",
+    action: { type: "PLAY_AUDIO" },
+    secondaryAction: { action: { type: "OPEN_CONTEXT_MENU" } },
+  };
+
+  const playlistMockItem: MenuItem = {
+    title: "Playlist Name",
+    summary: "12 Songs",
+    icon: "https://picsum.photos/201",
+    isSelected: true,
+    action: { type: "NAVIGATE_PLAYLIST" },
+  };
+
+  return (
+    <View style={styles.demoScreen}>
+      <Text style={styles.demoHeading}>Modal Item Building Block</Text>
+
+      <Text style={styles.demoLabel}>Now Playing</Text>
+      <Item
+        configuration={VARIANT_NOW_PLAYING}
+        data={mapMenuItemToNowPlayingData(sharedMockItem)}
+      />
+
+      <Text style={styles.demoLabel}>Queued Item</Text>
+      <Item
+        configuration={VARIANT_QUEUED_ITEM}
+        data={mapMenuItemToQueuedData(sharedMockItem)}
+        focused
+      />
+
+      <Text style={styles.demoLabel}>Playlist Item</Text>
+      <Item
+        configuration={VARIANT_PLAYLIST_ITEM}
+        data={mapMenuItemToPlaylistData(playlistMockItem)}
+      />
+    </View>
+  );
+}

package/Components/ModalComponent/AudioPlayer/Components/index.ts

@@ -0,0 +1,7 @@
+export { Item as AudioPlayerItem } from "./Item";
+
+export { Item as AudioPlayerHeader } from "./Header";
+
+export { Item as AudioPlayerButton } from "./Button";
+
+export { Item as AudioPlayerAction } from "./Action";