ribir_core 0.0.1-alpha.5

Ribir is a framework for building modern native/wasm cross-platform user interface applications.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

use super::{ModifyScope, StateRef, Stateful};
use rxrust::{observable, ops::box_it::BoxOp, prelude::BoxIt, subject::Subject};
use std::{convert::Infallible, rc::Rc};

pub enum Readonly<W> {
  Stateful(Stateful<W>),
  Stateless(Rc<W>),
}

pub enum ReadRef<'a, W> {
  Stateful(StateRef<'a, W>),
  Stateless(&'a Rc<W>),
}

impl<W> Readonly<W> {
  /// Readonly never modify the inner data, use a `()` to mock the api.
  #[inline]
  pub fn modify_guard(&self) {}

  #[inline]
  pub fn state_ref(&self) -> ReadRef<W> {
    match self {
      Readonly::Stateful(s) => ReadRef::Stateful(s.state_ref()),
      Readonly::Stateless(w) => ReadRef::Stateless(w),
    }
  }

  #[inline]
  pub fn silent_ref(&self) -> ReadRef<W> {
    // For a read only reference, `state_ref` and `silent_ref` no difference.
    self.state_ref()
  }

  pub fn raw_modifies(&self) -> Subject<'static, ModifyScope, Infallible> {
    match self {
      Readonly::Stateful(s) => s.raw_modifies(),
      Readonly::Stateless(_) => Subject::default(),
    }
  }

  /// Notify when this widget be mutable accessed, no mather if the widget
  /// really be modified, the value is hint if it's only access by silent ref.
  #[inline]
  pub fn modifies(&self) -> BoxOp<'static, (), Infallible> {
    match self {
      Readonly::Stateful(s) => s.modifies(),
      Readonly::Stateless(_) => observable::create(|_| {}).box_it(),
    }
  }

  /// Clone the stateful widget of which the reference point to. Require mutable
  /// reference because we try to early release inner borrow when clone occur.
  #[inline]
  pub fn clone_stateful(&self) -> Readonly<W> { self.clone() }
}

impl<'a, W> ReadRef<'a, W> {
  #[inline]
  pub fn silent(&self) -> &W { self }

  #[inline]
  pub fn raw_modifies(&self) -> Subject<'static, ModifyScope, Infallible> {
    match self {
      ReadRef::Stateful(s) => s.raw_modifies(),
      ReadRef::Stateless(_) => Subject::default(),
    }
  }

  #[inline]
  pub fn modifies(&self) -> BoxOp<'static, (), Infallible> {
    match self {
      ReadRef::Stateful(s) => s.modifies(),
      ReadRef::Stateless(_) => observable::create(|_| {}).box_it(),
    }
  }

  pub fn clone_stateful(&self) -> Readonly<W> {
    match self {
      ReadRef::Stateful(s) => Readonly::Stateful(s.clone_stateful()),
      ReadRef::Stateless(r) => Readonly::Stateless((*r).clone()),
    }
  }
}

impl<W> Clone for Readonly<W> {
  fn clone(&self) -> Self {
    match self {
      Self::Stateful(arg0) => Self::Stateful(arg0.clone()),
      Self::Stateless(arg0) => Self::Stateless(arg0.clone()),
    }
  }
}

impl<'a, W> std::ops::Deref for ReadRef<'a, W> {
  type Target = W;

  fn deref(&self) -> &Self::Target {
    match self {
      ReadRef::Stateful(s) => s.deref(),
      ReadRef::Stateless(r) => r,
    }
  }
}