stof 0.9.20

Data that carries its own logic.
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

# Prompt Library (Prompt)
Library for the prompt type, which is a tree of strings that is helpful when working with AI workflows.

## Example Usage
```rust
#[main]
fn main() {
    const p = prompt("hello, world", "msg");
    assert_eq(p as str, "<msg>hello, world</msg>");
}
```

# Prompt.any(prompt: prompt) -> bool
Does this prompt have any sub-prompts?
```rust
const p = prompt('hello', 'greet');
assert(!p.any());
```

# Prompt.at(prompt: prompt, index: int) -> prompt
Get the sub-prompt at a given index (like a list). Will return null if the prompt does not have any sub-prompts.
```rust
const p = prompt('hello', 'greet', prompt('hello there'));
const sub = p[0];
assert_eq(sub, prompt('hello there'));
```

# Prompt.clear(prompt: prompt) -> void
Clear all sub-prompts from this prompt.
```rust
const p = prompt('hello', 'greet');
p.push(', world');
p.clear();
assert_eq(p as str, '<greet>hello</greet>');
```

# Prompt.empty(prompt: prompt) -> bool
Returns true if the prompt does not have any sub-prompts.
```rust
const p = prompt('hello', 'greet');
assert(p.empty());
```

# Prompt.insert(prompt: prompt, index: int, other: prompt) -> void
Insert a sub-prompt into the given index.
```rust
const p = prompt(tag = 'greet');
p.push('hello');
p.insert(1, ', world');
assert_eq(p as str, '<greet>hello, world</greet>');
```

# Prompt.len(prompt: prompt) -> int
The number of sub-prompts contained within this prompt.
```rust
const p = prompt('hello', 'greet', prompt('hello, world'));
assert_eq(p.len(), 1);
```

# Prompt.pop(prompt: prompt) -> prompt
Pop a sub-prompt from the end of the sub-prompt list.
```rust
const p = prompt('hello', 'greet');
p.push(', world');
p.pop();
assert_eq(p as str, '<greet>hello</greet>');
```

# Prompt.prompts(prompt: prompt) -> list
Return this prompts list of sub-prompts.
```rust
const p = prompt('hello', 'greet', prompt('a thing', 'sub'));
assert_eq(p.str(), '<greet>hello<sub>a thing</sub></greet>');
assert_eq(p.prompts(), [prompt('a thing', 'sub')]);
```

# Prompt.push(prompt: prompt, other: prompt | str) -> void
Push a sub-prompt to this prompt.
```rust
const p = prompt('hello', 'greet');
p.push(', world');
assert_eq(p as str, '<greet>hello, world</greet>');
```

# Prompt.remove(prompt: prompt, index: int) -> prompt
Remove a sub-prompt at the given index.
```rust
const p = prompt(tag = 'greet');
p.push('hello');
p.push(', world');
p.remove(1);
assert_eq(p as str, '<greet>hello</greet>');
```

# Prompt.replace(prompt: prompt, index: int, other: prompt) -> void
Replace a sub-prompt at the given index.
```rust
const p = prompt(tag = 'greet');
p.push('hello');
p.replace(0, 'yo');
assert_eq(p as str, '<greet>yo</greet>');
```

# Prompt.reverse(prompt: prompt) -> void
Reverse all sub-prompts in this prompt.
```rust
const p = prompt(tag = 'greet');
p.push(', world');
p.push('hello');
p.reverse();
assert_eq(p as str, '<greet>hello, world</greet>');
```

# Prompt.set_tag(prompt: prompt, tag: str) -> void
Set the tag portion of this prompt. Set to null to clear the tag.
```rust
const p = prompt('hello', 'greet');
p.set_tag('msg');
assert_eq(p.str(), '<msg>hello, world</msg>');
```

# Prompt.set_text(prompt: prompt, text: str) -> void
Set the text portion of this prompt.
```rust
const p = prompt('hello', 'greet');
p.set_text('hello, world');
assert_eq(p.str(), '<greet>hello, world</greet>');
```

# Prompt.str(prompt: prompt) -> str
Convert this prompt into a string, just like a cast to 'str' would do.
```rust
const p = prompt('hello', 'greet');
assert_eq(p.str(), '<greet>hello</greet>');
```

# Prompt.tag(prompt: prompt) -> str
Get the string tag for this prompt, or null if not present.
```rust
const p = prompt('hello', 'greet');
assert_eq(p.tag(), 'greet');
```

# Prompt.text(prompt: prompt) -> str
Get the text portion of this prompt (ignoring any sub-prompts & tag).
```rust
const p = prompt('hello', 'greet');
assert_eq(p.text(), 'hello');
```