xref: /packages/apps/TvSettings/TwoPanelSettingsLib/src/com/android/tv/twopanelsettings/slices/compat/SliceItem.java

/*
 * Copyright (C) 2017 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.android.tv.twopanelsettings.slices.compat;

import static android.app.slice.SliceItem.FORMAT_ACTION;
import static android.app.slice.SliceItem.FORMAT_BUNDLE;
import static android.app.slice.SliceItem.FORMAT_IMAGE;
import static android.app.slice.SliceItem.FORMAT_INT;
import static android.app.slice.SliceItem.FORMAT_LONG;
import static android.app.slice.SliceItem.FORMAT_REMOTE_INPUT;
import static android.app.slice.SliceItem.FORMAT_SLICE;
import static android.app.slice.SliceItem.FORMAT_TEXT;

import static com.android.tv.twopanelsettings.slices.compat.Slice.appendHints;

import android.annotation.SuppressLint;
import android.app.PendingIntent;
import android.app.RemoteInput;
import android.content.Context;
import android.content.Intent;
import android.graphics.Color;
import android.os.Bundle;
import android.os.Parcelable;
import android.text.Annotation;
import android.text.ParcelableSpan;
import android.text.Spannable;
import android.text.SpannableString;
import android.text.SpannableStringBuilder;
import android.text.Spanned;
import android.text.TextUtils;
import android.text.format.DateUtils;
import android.text.style.AlignmentSpan;
import android.text.style.ForegroundColorSpan;
import android.text.style.RelativeSizeSpan;
import android.text.style.StyleSpan;
import android.util.Log;

import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.annotation.RequiresApi;
import androidx.annotation.StringDef;
import androidx.core.graphics.drawable.IconCompat;
import androidx.core.util.ObjectsCompat;
import androidx.core.util.Pair;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.net.URISyntaxException;
import java.util.Arrays;
import java.util.Calendar;
import java.util.List;

/**
 * A SliceItem is a single unit in the tree structure of a {@link Slice}.
 *
 * <p>A SliceItem a piece of content and some hints about what that content means or how it should
 * be displayed. The types of content can be:
 *
 * <ul>
 *   <li>{@link android.app.slice.SliceItem#FORMAT_SLICE}
 *   <li>{@link android.app.slice.SliceItem#FORMAT_TEXT}
 *   <li>{@link android.app.slice.SliceItem#FORMAT_IMAGE}
 *   <li>{@link android.app.slice.SliceItem#FORMAT_ACTION}
 *   <li>{@link android.app.slice.SliceItem#FORMAT_INT}
 *   <li>{@link android.app.slice.SliceItem#FORMAT_LONG}
 * </ul>
 *
 * <p>The hints that a {@link SliceItem} are a set of strings which annotate the content. The hints
 * that are guaranteed to be understood by the system are defined on {@link Slice}.
 *
 * <p>Slice framework has been deprecated, it will not receive any updates moving forward. If you
 * are looking for a framework that handles communication across apps, consider using {@link
 * android.app.appsearch.AppSearchManager}.
 */
public final class SliceItem {
  private static final String TAG = "SliceItem";

  private static final String HINTS = "hints";
  private static final String FORMAT = "format";
  private static final String SUBTYPE = "subtype";
  private static final String OBJ = "obj";
  private static final String OBJ_2 = "obj_2";
  private static final String INTENT = "intent";
  private static final String SLICE_CONTENT = "androidx.slice.content";
  private static final String SLICE_CONTENT_SENSITIVE = "sensitive";

  /** */
  // @RestrictTo(Scope.LIBRARY)
  @StringDef({
    FORMAT_SLICE,
    FORMAT_TEXT,
    FORMAT_IMAGE,
    FORMAT_ACTION,
    FORMAT_INT,
    FORMAT_LONG,
    FORMAT_REMOTE_INPUT,
    FORMAT_LONG,
    FORMAT_BUNDLE
  })
  @Retention(RetentionPolicy.SOURCE)
  public @interface SliceType {}

  /** */
  @NonNull
  @Slice.SliceHint
  String[] mHints = Slice.NO_HINTS;

  @NonNull
  String mFormat = FORMAT_TEXT;

  String mSubType = null;

  @Nullable Object mObj;

  CharSequence mSanitizedText;

  /** */
  @SuppressWarnings("NullableProblems")
  @SuppressLint("UnknownNullness") // obj cannot be correctly annotated
  // @RestrictTo(Scope.LIBRARY_GROUP)
  public SliceItem(
      Object obj,
      @NonNull @SliceType String format,
      @Nullable String subType,
      @NonNull @Slice.SliceHint String[] hints) {
    mHints = hints;
    mFormat = format;
    mSubType = subType;
    mObj = obj;
  }

  /** */
  @SuppressLint("UnknownNullness") // obj cannot be correctly annotated
  // @RestrictTo(Scope.LIBRARY_GROUP)
  public SliceItem(
      Object obj,
      @NonNull @SliceType String format,
      @Nullable String subType,
      @NonNull @Slice.SliceHint List<String> hints) {
    this(obj, format, subType, hints.toArray(new String[hints.size()]));
  }

  /** */
  public SliceItem(
      @NonNull Parcelable intent,
      @Nullable Slice slice,
      @NonNull @SliceType String format,
      @Nullable String subType,
      @NonNull @Slice.SliceHint String[] hints) {
    this(new Pair<Object, Slice>(intent, slice), format, subType, hints);
  }

  /** */
  @SuppressLint("LambdaLast")
  // @RestrictTo(Scope.LIBRARY_GROUP)
  public SliceItem(
      @NonNull ActionHandler action,
      @Nullable Slice slice,
      @NonNull @SliceType String format,
      @Nullable String subType,
      @NonNull @Slice.SliceHint String[] hints) {
    this(new Pair<Object, Slice>(action, slice), format, subType, hints);
  }

  /**
   * Gets all hints associated with this SliceItem.
   *
   * @return Array of hints.
   */
  public @NonNull @Slice.SliceHint List<String> getHints() {
    return Arrays.asList(mHints);
  }

  /** */
  @SuppressWarnings("unused")
  // @RestrictTo(Scope.LIBRARY)
  public @NonNull @Slice.SliceHint String[] getHintArray() {
    return mHints;
  }

  /** */
  // @RestrictTo(Scope.LIBRARY_GROUP)
  public void addHint(@Slice.SliceHint @NonNull String hint) {
    mHints = ArrayUtils.appendElement(String.class, mHints, hint);
  }

  /**
   * Get the format of this SliceItem.
   *
   * <p>The format will be one of the following types supported by the platform:
   *
   * <ul>
   *   <li>{@link android.app.slice.SliceItem#FORMAT_SLICE}
   *   <li>{@link android.app.slice.SliceItem#FORMAT_TEXT}
   *   <li>{@link android.app.slice.SliceItem#FORMAT_IMAGE}
   *   <li>{@link android.app.slice.SliceItem#FORMAT_ACTION}
   *   <li>{@link android.app.slice.SliceItem#FORMAT_INT}
   *   <li>{@link android.app.slice.SliceItem#FORMAT_LONG}
   *   <li>{@link android.app.slice.SliceItem#FORMAT_REMOTE_INPUT}
   * </ul>
   *
   * @see #getSubType() ()
   */
  @NonNull
  public @SliceType String getFormat() {
    return mFormat;
  }

  /**
   * Get the sub-type of this SliceItem.
   *
   * <p>Subtypes provide additional information about the type of this information beyond basic
   * interpretations inferred by {@link #getFormat()}. For example a slice may contain many {@link
   * android.app.slice.SliceItem#FORMAT_TEXT} items, but only some of them may be {@link
   * android.app.slice.Slice#SUBTYPE_MESSAGE}.
   *
   * @see #getFormat()
   */
  @Nullable
  public String getSubType() {
    return mSubType;
  }

  /**
   * @return The text held by this {@link android.app.slice.SliceItem#FORMAT_TEXT} SliceItem
   */
  @Nullable
  public CharSequence getText() {
    return (CharSequence) mObj;
  }

  /**  */
  @Nullable
  public Bundle getBundle() {
    return (Bundle) mObj;
  }

  /**
   * @return The text held by this {@link android.app.slice.SliceItem#FORMAT_TEXT} SliceItem with
   *     ony spans that are unsupported by the androidx Slice renderer removed.
   */
  // @RestrictTo(Scope.LIBRARY_GROUP_PREFIX)
  @Nullable
  public CharSequence getSanitizedText() {
    if (mSanitizedText == null) {
      mSanitizedText = sanitizeText(getText());
    }
    return mSanitizedText;
  }

  /**
   * Get the same content as {@link #getText()} except with content that should be excluded from
   * persistent logs because it was tagged with {@link #createSensitiveSpan()}.
   *
   * @return The text held by this {@link android.app.slice.SliceItem#FORMAT_TEXT} SliceItem
   */
  @Nullable
  public CharSequence getRedactedText() {
    return redactSensitiveText(getText());
  }

  /**
   * @return The icon held by this {@link android.app.slice.SliceItem#FORMAT_IMAGE} SliceItem
   */
  @Nullable
  public IconCompat getIcon() {
    return (IconCompat) mObj;
  }

  /**
   * @return The pending intent held by this {@link android.app.slice.SliceItem#FORMAT_ACTION}
   *     SliceItem
   */
  @Nullable
  @SuppressWarnings("unchecked")
  public PendingIntent getAction() {
    ObjectsCompat.requireNonNull(mObj, "Object must be non-null");
    Object action = ((Pair<Object, Slice>) mObj).first;
    if (action instanceof PendingIntent) {
      return (PendingIntent) action;
    }
    return null;
  }

  /**
   * @return The pending intent held by this {@link android.app.slice.SliceItem#FORMAT_ACTION}
   *     SliceItem
   */
  @Nullable
  @SuppressWarnings("unchecked")
  public Intent getActionIntent() {
    ObjectsCompat.requireNonNull(mObj, "Object must be non-null");
    Object action = ((Pair<Object, Slice>) mObj).first;
    if (action instanceof Intent) {
      return (Intent) action;
    }
    return null;
  }

  @Nullable
  public Parcelable getActionParcelable() {
    ObjectsCompat.requireNonNull(mObj, "Object must be non-null");
    Object action = ((Pair<Object, Slice>) mObj).first;
    if (action instanceof Parcelable) {
      return (Parcelable) action;
    }
    return null;
  }

  @Nullable
  @SuppressWarnings("unchecked")
  private ActionHandler getActionHandler() {
    ObjectsCompat.requireNonNull(mObj, "Object must be non-null");
    Object action = ((Pair<Object, Slice>) mObj).first;
    if (action instanceof ActionHandler) {
      return (ActionHandler) action;
    }
    return null;
  }

  /**
   * Trigger the action on this SliceItem.
   *
   * @param context The Context to use when sending the PendingIntent.
   * @param i The intent to use when sending the PendingIntent.
   */
  public void fireAction(@Nullable Context context, @Nullable Intent i)
      throws PendingIntent.CanceledException {
    fireActionInternal(context, i);
  }

  /** */
  @SuppressWarnings("unchecked")
  // @RestrictTo(Scope.LIBRARY_GROUP_PREFIX)
  public boolean fireActionInternal(@Nullable Context context, @Nullable Intent i)
      throws PendingIntent.CanceledException {
    Parcelable action = getActionParcelable();
    if (action != null) {
      SliceUtils.fireAction(context, action, i);
    }

    ActionHandler handler = getActionHandler();
    if (handler != null) {
      handler.onAction(this, context, i);
    }

    return true;
  }

  /**
   * @return The remote input held by this {@link android.app.slice.SliceItem#FORMAT_REMOTE_INPUT}
   *     SliceItem
   */
  @Nullable
  @RequiresApi(20)
  // @RestrictTo(RestrictTo.Scope.LIBRARY_GROUP_PREFIX)
  public RemoteInput getRemoteInput() {
    return (RemoteInput) mObj;
  }

  /**
   * @return The color held by this {@link android.app.slice.SliceItem#FORMAT_INT} SliceItem
   */
  public int getInt() {
    ObjectsCompat.requireNonNull(mObj, "Object must be non-null for FORMAT_INT");
    return (Integer) mObj;
  }

  /**
   * @return The slice held by this {@link android.app.slice.SliceItem#FORMAT_ACTION} or {@link
   *     android.app.slice.SliceItem#FORMAT_SLICE} SliceItem
   */
  @Nullable
  @SuppressWarnings("unchecked")
  public Slice getSlice() {
    ObjectsCompat.requireNonNull(mObj, "Object must be non-null for FORMAT_SLICE");
    if (FORMAT_ACTION.equals(getFormat())) {
      return ((Pair<Object, Slice>) mObj).second;
    }
    return (Slice) mObj;
  }

  /**
   * @return The long held by this {@link android.app.slice.SliceItem#FORMAT_LONG} SliceItem
   */
  public long getLong() {
    ObjectsCompat.requireNonNull(mObj, "Object must be non-null for FORMAT_LONG");
    return (Long) mObj;
  }

  /**
   * @param hint The hint to check for
   * @return true if this item contains the given hint
   */
  public boolean hasHint(@NonNull @Slice.SliceHint String hint) {
    return ArrayUtils.contains(mHints, hint);
  }

  /** */
  // @RestrictTo(Scope.LIBRARY)
  public SliceItem(@NonNull Bundle in) {
    mHints = in.getStringArray(HINTS);
    mFormat = in.getString(FORMAT);
    mSubType = in.getString(SUBTYPE);
    mObj = readObj(mFormat, in);
  }

  /** */
  @NonNull
  // @RestrictTo(Scope.LIBRARY)
  public Bundle toBundle() {
    Bundle b = new Bundle();
    b.putStringArray(HINTS, mHints);
    b.putString(FORMAT, mFormat);
    b.putString(SUBTYPE, mSubType);
    writeObj(b, mObj, mFormat);
    return b;
  }

  /** */
  @SuppressWarnings("unused")
  // @RestrictTo(Scope.LIBRARY)
  public boolean hasHints(@Nullable @Slice.SliceHint String[] hints) {
    if (hints == null) {
      return true;
    }
    for (String hint : hints) {
      if (!TextUtils.isEmpty(hint) && !ArrayUtils.contains(mHints, hint)) {
        return false;
      }
    }
    return true;
  }

  /** */
  // @RestrictTo(Scope.LIBRARY_GROUP)
  public boolean hasAnyHints(@Nullable @Slice.SliceHint String... hints) {
    if (hints == null) {
      return false;
    }
    for (String hint : hints) {
      if (ArrayUtils.contains(mHints, hint)) {
        return true;
      }
    }
    return false;
  }

  @SuppressWarnings("unchecked")
  private void writeObj(@NonNull Bundle dest, Object obj, @NonNull String type) {
    switch (type) {
      case FORMAT_IMAGE:
        dest.putBundle(OBJ, ((IconCompat) obj).toBundle());
        break;
      case FORMAT_REMOTE_INPUT:
        dest.putParcelable(OBJ, (Parcelable) obj);
        break;
      case FORMAT_SLICE:
        dest.putParcelable(OBJ, ((Slice) obj).toBundle());
        break;
      case FORMAT_ACTION:
        {
          Parcelable action = (Parcelable) ((Pair<Object, Slice>) obj).first;
          if (action instanceof Intent) {
            dest.putString(INTENT, ((Intent) action).toUri(Intent.URI_INTENT_SCHEME));
          } else {
            dest.putParcelable(OBJ, (Parcelable) ((Pair<Object, Slice>) obj).first);
          }
        dest.putBundle(OBJ_2, ((Pair<Object, Slice>) obj).second.toBundle());
        break;
        }
      case FORMAT_TEXT:
        dest.putCharSequence(OBJ, (CharSequence) obj);
        break;
      case FORMAT_INT:
        ObjectsCompat.requireNonNull(mObj, "Object must be non-null for FORMAT_INT");
        dest.putInt(OBJ, (Integer) mObj);
        break;
      case FORMAT_LONG:
        ObjectsCompat.requireNonNull(mObj, "Object must be non-null for FORMAT_LONG");
        dest.putLong(OBJ, (Long) mObj);
        break;
      case FORMAT_BUNDLE:
        dest.putBundle(OBJ, (Bundle) mObj);
    }
  }

  @Nullable
  private static Object readObj(@NonNull String type, @NonNull Bundle in) {
    switch (type) {
      case FORMAT_IMAGE:
        return IconCompat.createFromBundle(in.getBundle(OBJ));
      case FORMAT_REMOTE_INPUT:
        return in.getParcelable(OBJ);
      case FORMAT_SLICE:
        return new Slice(in.getBundle(OBJ));
      case FORMAT_TEXT:
        return in.getCharSequence(OBJ);
      case FORMAT_ACTION:
        String intentUri = in.getString(INTENT);
        if (intentUri == null) {
          return new Pair<>(in.getParcelable(OBJ), new Slice(in.getBundle(OBJ_2)));
        }
        Intent intent;
        try {
          intent = Intent.parseUri(intentUri, 0);
        } catch (URISyntaxException e) {
          Log.e(TAG, "Malformed intent: " + intentUri, e);
          intent = new Intent();
        }
        return new Pair<>(intent, new Slice(in.getBundle(OBJ_2)));
      case FORMAT_INT:
        return in.getInt(OBJ);
      case FORMAT_LONG:
        return in.getLong(OBJ);
      case FORMAT_BUNDLE:
        return in.getBundle(OBJ);
    }
    throw new RuntimeException("Unsupported type " + type);
  }

  /** */
  @NonNull
  // @RestrictTo(Scope.LIBRARY)
  public static String typeToString(@NonNull String format) {
    switch (format) {
      case FORMAT_SLICE:
        return "Slice";
      case FORMAT_TEXT:
        return "Text";
      case FORMAT_IMAGE:
        return "Image";
      case FORMAT_ACTION:
        return "Action";
      case FORMAT_INT:
        return "Int";
      case FORMAT_LONG:
        return "Long";
      case FORMAT_REMOTE_INPUT:
        return "RemoteInput";
    }
    return "Unrecognized format: " + format;
  }

  /**
   * @return A string representation of this slice item.
   */
  @NonNull
  @Override
  public String toString() {
    return toString("");
  }

  /**
   * @return A string representation of this slice item.
   */
  @NonNull
  // @RestrictTo(Scope.LIBRARY)
  @SuppressWarnings("unchecked")
  public String toString(@NonNull String indent) {
    StringBuilder sb = new StringBuilder();
    sb.append(indent);
    sb.append(getFormat());
    if (getSubType() != null) {
      sb.append('<');
      sb.append(getSubType());
      sb.append('>');
    }
    sb.append(' ');
    if (mHints.length > 0) {
      appendHints(sb, mHints);
      sb.append(' ');
    }
    final String nextIndent = indent + "  ";
    switch (getFormat()) {
      case FORMAT_SLICE:
        {
          Slice slice = getSlice();
          ObjectsCompat.requireNonNull(slice, "Slice must be non-null for FORMAT_SLICE");
          sb.append("{\n");
          sb.append(slice.toString(nextIndent));
          sb.append('\n').append(indent).append('}');
          break;
        }
      case FORMAT_ACTION:
        {
          Slice slice = getSlice();
          ObjectsCompat.requireNonNull(mObj, "Object must be non-null for FORMAT_ACTION");
          ObjectsCompat.requireNonNull(slice, "Slice must be non-null for FORMAT_SLICE");
          // Not using getAction because the action can actually be other types.
          Object action = ((Pair<Object, Slice>) mObj).first;
          sb.append('[').append(action).append("] ");
          sb.append("{\n");
          sb.append(getSlice().toString(nextIndent));
          sb.append('\n').append(indent).append('}');
          break;
        }
      case FORMAT_TEXT:
        sb.append('"').append(getText()).append('"');
        break;
      case FORMAT_IMAGE:
        sb.append(getIcon());
        break;
      case FORMAT_INT:
        if (android.app.slice.Slice.SUBTYPE_COLOR.equals(getSubType())) {
          int color = getInt();
          sb.append(
              String.format(
                  "a=0x%02x r=0x%02x g=0x%02x b=0x%02x",
                  Color.alpha(color), Color.red(color), Color.green(color), Color.blue(color)));
        } else if (android.app.slice.Slice.SUBTYPE_LAYOUT_DIRECTION.equals(getSubType())) {
          sb.append(layoutDirectionToString(getInt()));
        } else {
          sb.append(getInt());
        }
        break;
      case FORMAT_LONG:
        if (android.app.slice.Slice.SUBTYPE_MILLIS.equals(getSubType())) {
          if (getLong() == -1L) {
            sb.append("INFINITY");
          } else {
            sb.append(
                DateUtils.getRelativeTimeSpanString(
                    getLong(),
                    Calendar.getInstance().getTimeInMillis(),
                    DateUtils.SECOND_IN_MILLIS,
                    DateUtils.FORMAT_ABBREV_RELATIVE));
          }
        } else {
          sb.append(getLong()).append('L');
        }
        break;
      default:
        sb.append(SliceItem.typeToString(getFormat()));
        break;
    }
    sb.append("\n");
    return sb.toString();
  }

  /**
   * Creates a span object that identifies content that should be redacted when acquired using
   * {@link #getRedactedText()}.
   */
  @NonNull
  public static ParcelableSpan createSensitiveSpan() {
    return new Annotation(SLICE_CONTENT, SLICE_CONTENT_SENSITIVE);
  }

  @NonNull
  private static String layoutDirectionToString(int layoutDirection) {
    switch (layoutDirection) {
      case android.util.LayoutDirection.LTR:
        return "LTR";
      case android.util.LayoutDirection.RTL:
        return "RTL";
      case android.util.LayoutDirection.INHERIT:
        return "INHERIT";
      case android.util.LayoutDirection.LOCALE:
        return "LOCALE";
      default:
        return Integer.toString(layoutDirection);
    }
  }

  private static CharSequence redactSensitiveText(CharSequence text) {
    if (text instanceof Spannable) {
      return redactSpannableText((Spannable) text);
    } else if (text instanceof Spanned) {
      if (!isRedactionNeeded((Spanned) text)) {
        return text;
      }
      Spannable fixedText = new SpannableString(text);
      return redactSpannableText(fixedText);
    } else {
      return text;
    }
  }

  private static boolean isRedactionNeeded(@NonNull Spanned text) {
    for (Annotation span : text.getSpans(0, text.length(), Annotation.class)) {
      if (SLICE_CONTENT.equals(span.getKey()) && SLICE_CONTENT_SENSITIVE.equals(span.getValue())) {
        return true;
      }
    }
    return false;
  }

  @NonNull
  private static CharSequence redactSpannableText(@NonNull Spannable text) {
    Spanned out = text;
    for (Annotation span : text.getSpans(0, text.length(), Annotation.class)) {
      if (!SLICE_CONTENT.equals(span.getKey())
          || !SLICE_CONTENT_SENSITIVE.equals(span.getValue())) {
        continue;
      }
      int spanStart = text.getSpanStart(span);
      int spanEnd = text.getSpanEnd(span);
      out =
          new SpannableStringBuilder()
              .append(out.subSequence(0, spanStart))
              .append(createRedacted(spanEnd - spanStart))
              .append(out.subSequence(spanEnd, text.length()));
    }
    return out;
  }

  @NonNull
  private static String createRedacted(final int n) {
    StringBuilder s = new StringBuilder();
    for (int i = 0; i < n; i++) {
      s.append('*');
    }
    return s.toString();
  }

  @Nullable
  private static CharSequence sanitizeText(@Nullable CharSequence text) {
    if (text instanceof Spannable) {
      fixSpannableText((Spannable) text);
      return text;
    } else if (text instanceof Spanned) {
      if (checkSpannedText((Spanned) text)) {
        return text;
      }
      Spannable fixedText = new SpannableString(text);
      fixSpannableText(fixedText);
      return fixedText;
    } else {
      return text;
    }
  }

  private static boolean checkSpannedText(@NonNull Spanned text) {
    for (Object span : text.getSpans(0, text.length(), Object.class)) {
      if (!checkSpan(span)) {
        return false;
      }
    }
    return true;
  }

  private static void fixSpannableText(@NonNull Spannable text) {
    for (Object span : text.getSpans(0, text.length(), Object.class)) {
      Object fixedSpan = fixSpan(span);
      if (fixedSpan == span) {
        continue;
      }

      if (fixedSpan != null) {
        int spanStart = text.getSpanStart(span);
        int spanEnd = text.getSpanEnd(span);
        int spanFlags = text.getSpanFlags(span);
        text.setSpan(fixedSpan, spanStart, spanEnd, spanFlags);
      }

      text.removeSpan(span);
    }
  }

  // TODO: Allow only highlight color in ForegroundColorSpan.
  // TODO: Cap smallest/largest sizeChange for RelativeSizeSpans, minding nested ones.

  private static boolean checkSpan(Object span) {
    return span instanceof AlignmentSpan
        || span instanceof ForegroundColorSpan
        || span instanceof RelativeSizeSpan
        || span instanceof StyleSpan;
  }

  @Nullable
  private static Object fixSpan(Object span) {
    return checkSpan(span) ? span : null;
  }

  /** */
  // @RestrictTo(Scope.LIBRARY_GROUP_PREFIX)
  public interface ActionHandler {
    /** Called when a pending intent would be sent on a real slice. */
    void onAction(@NonNull SliceItem item, @Nullable Context context, @Nullable Intent intent);
  }
}