sdk/fidl/fuchsia.fonts/events.fidl

// Copyright 2019 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
library fuchsia.fonts;

/// Protocol for listening to possible events that may occur in the `Provider`'s set of fonts.
///
/// Register a listener using [`fuchsia.fonts/Provider.RegisterFontSetEventListener`].
closed protocol FontSetEventListener {
    /// The set of fonts available in the `Provider` has changed. See
    /// [`fuchsia.fonts/FontSetUpdatedEvent`].
    strict OnFontSetUpdated(struct {
        event FontSetUpdatedEvent;
    }) -> ();

    // A future addition might include an event that is triggered when the user changes the mapping
    // for generic font families (e.g. configuring "monospace" to default to "Inconsolata" instead of
    // "Roboto Mono").
};

/// An event indicating that the set of fonts available in the `Provider` has changed. This is most
/// frequently caused by an ephemeral font being downloaded and cached. Clients should consider
/// re-requesting fonts and re-rendering any displayed text.
type FontSetUpdatedEvent = table {
        // No fields at the moment.
        };