type Layout = TextWall | DoubleTextWall | DashboardCard | ReferenceCard;

interface TextWall {
  /** Must be LayoutType.TEXT_WALL. */
  layoutType: LayoutType.TEXT_WALL;

  /** The text content to display. */
  text: string;
}

// You typically won't create this directly, but would use the LayoutManager method
const textWall: TextWall = {
  layoutType: LayoutType.TEXT_WALL,
  text: "This is a simple text wall with a single message."
};

// Using the LayoutManager
appSession.layouts.showTextWall("This is a simple text wall with a single message.");

interface DoubleTextWall {
  /** Must be LayoutType.DOUBLE_TEXT_WALL. */
  layoutType: LayoutType.DOUBLE_TEXT_WALL;

  /** Text for the upper section. */
  topText: string;

  /** Text for the lower section. */
  bottomText: string;
}

// Using the LayoutManager
appSession.layouts.showDoubleTextWall(
  "This is the top section",
  "This is the bottom section"
);

interface ReferenceCard {
  /** Must be LayoutType.REFERENCE_CARD. */
  layoutType: LayoutType.REFERENCE_CARD;

  /** The title text for the card. */
  title: string;

  /** The main body text for the card. */
  text: string;
}

// Using the LayoutManager
appSession.layouts.showReferenceCard(
  "Recipe: Chocolate Chip Cookies",
  "Ingredients:\n- 2 cups flour\n- 1 cup sugar\n- 1/2 cup butter\n..."
);

interface DashboardCard {
  /** Must be LayoutType.DASHBOARD_CARD. */
  layoutType: LayoutType.DASHBOARD_CARD;

  /** Text for the left side (usually a label). */
  leftText: string;

  /** Text for the right side (usually a value). */
  rightText: string;
}

// Using the LayoutManager
appSession.layouts.showDashboardCard("Temperature", "72°F");

interface DisplayRequest extends BaseMessage {
  /** Must be AppToCloudMessageType.DISPLAY_REQUEST. */
  type: AppToCloudMessageType.DISPLAY_REQUEST;

  /** The package name of the App making the request. */
  packageName: string;

  /** The target display area (MAIN or DASHBOARD). */
  view: ViewType;

  /** The specific layout configuration object to display. */
  layout: Layout;

  /** Optional time (in ms) to display the layout before automatically clearing it. */
  durationMs?: number;

  /** Optional flag to attempt to force display even if another app is active (use with caution). */
  forceDisplay?: boolean;
}