about summary refs log tree commit diff stats
path: root/src/xmpp/stanza.h
blob: 1e375783bca6ba8fbe28790597496743ac43ccd0 (plain) (blame)
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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
/*
 * stanza.h
 *
 * Copyright (C) 2012 - 2016 James Booth <boothj5@gmail.com>
 *
 * This file is part of Profanity.
 *
 * Profanity is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Profanity is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Profanity.  If not, see <http://www.gnu.org/licenses/>.
 *
 * In addition, as a special exception, the copyright holders give permission to
 * link the code of portions of this program with the OpenSSL library under
 * certain conditions as described in each individual source file, and
 * distribute linked combinations including the two.
 *
 * You must obey the GNU General Public License in all respects for all of the
 * code used other than OpenSSL. If you modify file(s) with this exception, you
 * may extend this exception to your version of the file(s), but you are not
 * obligated to do so. If you do not wish to do so, delete this exception
 * statement from your version. If you delete this exception statement from all
 * source files in the program, then also delete it here.
 *
 */

#ifndef XMPP_STANZA_H
#define XMPP_STANZA_H

#include "prof_config.h"

#ifdef PROF_HAVE_LIBMESODE
#include <mesode.h>
#endif
#ifdef PROF_HAVE_LIBSTROPHE
#include <strophe.h>
#endif

#include <xmpp/xmpp.h>

#define STANZA_NAME_ACTIVE "active"
#define STANZA_NAME_INACTIVE "inactive"
#define STANZA_NAME_COMPOSING "composing"
#define STANZA_NAME_PAUSED "paused"
#define STANZA_NAME_GONE "gone"

#define STANZA_NAME_MESSAGE "message"
#define STANZA_NAME_BODY "body"
#define STANZA_NAME_PRESENCE "presence"
#define STANZA_NAME_PRIORITY "priority"
#define STANZA_NAME_X "x"
#define STANZA_NAME_SHOW "show"
#define STANZA_NAME_STATUS "status"
#define STANZA_NAME_IQ "iq"
#define STANZA_NAME_QUERY "query"
#define STANZA_NAME_DELAY "delay"
#define STANZA_NAME_ERROR "error"
#define STANZA_NAME_PING "ping"
#define STANZA_NAME_TEXT "text"
#define STANZA_NAME_SUBJECT "subject"
#define STANZA_NAME_ITEM "item"
#define STANZA_NAME_ITEMS "items"
#define STANZA_NAME_C "c"
#define STANZA_NAME_IDENTITY "identity"
#define STANZA_NAME_FEATURE "feature"
#define STANZA_NAME_INVITE "invite"
#define STANZA_NAME_REASON "reason"
#define STANZA_NAME_GROUP "group"
#define STANZA_NAME_PUBSUB "pubsub"
#define STANZA_NAME_PUBLISH "publish"
#define STANZA_NAME_PUBLISH_OPTIONS "publish-options"
#define STANZA_NAME_FIELD "field"
#define STANZA_NAME_STORAGE "storage"
#define STANZA_NAME_NICK "nick"
#define STANZA_NAME_PASSWORD "password"
#define STANZA_NAME_CONFERENCE "conference"
#define STANZA_NAME_VALUE "value"
#define STANZA_NAME_DESTROY "destroy"
#define STANZA_NAME_ACTOR "actor"
#define STANZA_NAME_ENABLE "enable"
#define STANZA_NAME_DISABLE "disable"

// error conditions
#define STANZA_NAME_BAD_REQUEST "bad-request"
#define STANZA_NAME_CONFLICT "conflict"
#define STANZA_NAME_FEATURE_NOT_IMPLEMENTED "feature-not-implemented"
#define STANZA_NAME_FORBIDDEN "forbidden"
#define STANZA_NAME_GONE "gone"
#define STANZA_NAME_INTERNAL_SERVER_ERROR "internal-server-error"
#define STANZA_NAME_ITEM_NOT_FOUND "item-not-found"
#define STANZA_NAME_JID_MALFORMED "jid-malformed"
#define STANZA_NAME_NOT_ACCEPTABLE "not-acceptable"
#define STANZA_NAME_NOT_ALLOWED "not-allowed"
#define STANZA_NAME_NOT_AUTHORISED "not-authorised"
#define STANZA_NAME_POLICY_VIOLATION "policy-violation"
#define STANZA_NAME_RECIPIENT_UNAVAILABLE "recipient-unavailable"
#define STANZA_NAME_REDIRECT "redirect"
#define STANZA_NAME_REGISTRATION_REQUIRED "registration-required"
#define STANZA_NAME_REMOTE_SERVER_NOT_FOUND "remote-server-not-found"
#define STANZA_NAME_REMOTE_SERVER_TIMEOUT "remote-server-timeout"
#define STANZA_NAME_RESOURCE_CONSTRAINT "resource-constraint"
#define STANZA_NAME_SERVICE_UNAVAILABLE "service-unavailable"
#define STANZA_NAME_SUBSCRIPTION_REQUIRED "subscription-required"
#define STANZA_NAME_UNDEFINED_CONDITION "undefined-condition"
#define STANZA_NAME_UNEXPECTED_REQUEST "unexpected-request"

#define STANZA_TYPE_CHAT "chat"
#define STANZA_TYPE_GROUPCHAT "groupchat"
#define STANZA_TYPE_UNAVAILABLE "unavailable"
#define STANZA_TYPE_SUBSCRIBE "subscribe"
#define STANZA_TYPE_SUBSCRIBED "subscribed"
#define STANZA_TYPE_UNSUBSCRIBED "unsubscribed"
#define STANZA_TYPE_GET "get"
#define STANZA_TYPE_SET "set"
#define STANZA_TYPE_ERROR "error"
#define STANZA_TYPE_RESULT "result"

#define STANZA_ATTR_TO "to"
#define STANZA_ATTR_FROM "from"
#define STANZA_ATTR_STAMP "stamp"
#define STANZA_ATTR_TYPE "type"
#define STANZA_ATTR_CODE "code"
#define STANZA_ATTR_JID "jid"
#define STANZA_ATTR_NAME "name"
#define STANZA_ATTR_SUBSCRIPTION "subscription"
#define STANZA_ATTR_XMLNS "xmlns"
#define STANZA_ATTR_NICK "nick"
#define STANZA_ATTR_ASK "ask"
#define STANZA_ATTR_ID "id"
#define STANZA_ATTR_SECONDS "seconds"
#define STANZA_ATTR_NODE "node"
#define STANZA_ATTR_VER "ver"
#define STANZA_ATTR_VAR "var"
#define STANZA_ATTR_HASH "hash"
#define STANZA_ATTR_CATEGORY "category"
#define STANZA_ATTR_REASON "reason"
#define STANZA_ATTR_AUTOJOIN "autojoin"
#define STANZA_ATTR_PASSWORD "password"

#define STANZA_TEXT_AWAY "away"
#define STANZA_TEXT_DND "dnd"
#define STANZA_TEXT_CHAT "chat"
#define STANZA_TEXT_XA "xa"
#define STANZA_TEXT_ONLINE "online"

#define STANZA_NS_STANZAS "urn:ietf:params:xml:ns:xmpp-stanzas"
#define STANZA_NS_CHATSTATES "http://jabber.org/protocol/chatstates"
#define STANZA_NS_MUC "http://jabber.org/protocol/muc"
#define STANZA_NS_MUC_USER "http://jabber.org/protocol/muc#user"
#define STANZA_NS_MUC_OWNER "http://jabber.org/protocol/muc#owner"
#define STANZA_NS_MUC_ADMIN "http://jabber.org/protocol/muc#admin"
#define STANZA_NS_CAPS "http://jabber.org/protocol/caps"
#define STANZA_NS_PING "urn:xmpp:ping"
#define STANZA_NS_LASTACTIVITY "jabber:iq:last"
#define STANZA_NS_DATA "jabber:x:data"
#define STANZA_NS_VERSION "jabber:iq:version"
#define STANZA_NS_CONFERENCE "jabber:x:conference"
#define STANZA_NS_CAPTCHA "urn:xmpp:captcha"
#define STANZA_NS_PUBSUB "http://jabber.org/protocol/pubsub"
#define STANZA_NS_CARBONS "urn:xmpp:carbons:2"
#define STANZA_NS_HINTS "urn:xmpp:hints"
#define STANZA_NS_FORWARD "urn:xmpp:forward:0"
#define STANZA_NS_RECEIPTS "urn:xmpp:receipts"
#define STANZA_NS_SIGNED "jabber:x:signed"
#define STANZA_NS_ENCRYPTED "jabber:x:encrypted"

#define STANZA_DATAFORM_SOFTWARE "urn:xmpp:dataforms:softwareinfo"

typedef struct caps_stanza_t {
    char *hash;
    char *node;
    char *ver;
} XMPPCaps;

typedef struct presence_stanza_t {
    Jid *jid;
    char *show;
    char *status;
    int priority;
    GDateTime *last_activity;
} XMPPPresence;

typedef enum {
    STANZA_PARSE_ERROR_NO_FROM,
    STANZA_PARSE_ERROR_INVALID_FROM
} stanza_parse_error_t;

xmpp_stanza_t* stanza_create_bookmarks_storage_request(xmpp_ctx_t *ctx);

xmpp_stanza_t* stanza_enable_carbons(xmpp_ctx_t *ctx);

xmpp_stanza_t* stanza_disable_carbons(xmpp_ctx_t *ctx);

xmpp_stanza_t* stanza_create_chat_state(xmpp_ctx_t *ctx,
    const char *const fulljid, const char *const state);

xmpp_stanza_t* stanza_attach_state(xmpp_ctx_t *ctx, xmpp_stanza_t *stanza, const char *const state);
xmpp_stanza_t* stanza_attach_carbons_private(xmpp_ctx_t *ctx, xmpp_stanza_t *stanza);
xmpp_stanza_t* stanza_attach_hints_no_copy(xmpp_ctx_t *ctx, xmpp_stanza_t *stanza);
xmpp_stanza_t* stanza_attach_hints_no_store(xmpp_ctx_t *ctx, xmpp_stanza_t *stanza);
xmpp_stanza_t* stanza_attach_receipt_request(xmpp_ctx_t *ctx, xmpp_stanza_t *stanza);

xmpp_stanza_t* stanza_create_message(xmpp_ctx_t *ctx, char *id,
    const char *const recipient, const char *const type, const char *const message);

xmpp_stanza_t* stanza_create_room_join_presence(xmpp_ctx_t *const ctx,
    const char *const full_room_jid, const char *const passwd);

xmpp_stanza_t* stanza_create_room_newnick_presence(xmpp_ctx_t *ctx,
    const char *const full_room_jid);

xmpp_stanza_t* stanza_create_room_leave_presence(xmpp_ctx_t *ctx,
    const char *const room, const char *const nick);

xmpp_stanza_t* stanza_create_presence(xmpp_ctx_t *const ctx);

xmpp_stanza_t* stanza_create_roster_iq(xmpp_ctx_t *ctx);
xmpp_stanza_t* stanza_create_ping_iq(xmpp_ctx_t *ctx, const char *const target);
xmpp_stanza_t* stanza_create_disco_info_iq(xmpp_ctx_t *ctx, const char *const id,
    const char *const to, const char *const node);

xmpp_stanza_t* stanza_create_last_activity_iq(xmpp_ctx_t *ctx, const char *const id,
    const char *const to);

xmpp_stanza_t* stanza_create_invite(xmpp_ctx_t *ctx, const char *const room,
    const char *const contact, const char *const reason, const char *const password);
xmpp_stanza_t* stanza_create_mediated_invite(xmpp_ctx_t *ctx, const char *const room,
    const char *const contact, const char *const reason);

gboolean stanza_contains_chat_state(xmpp_stanza_t *stanza);

GDateTime* stanza_get_delay(xmpp_stanza_t *const stanza);

gboolean stanza_is_muc_presence(xmpp_stanza_t *const stanza);
gboolean stanza_is_muc_self_presence(xmpp_stanza_t *const stanza,
    const char *const self_jid);
gboolean stanza_is_room_nick_change(xmpp_stanza_t *const stanza);
gboolean stanza_muc_requires_config(xmpp_stanza_t *const stanza);

char* stanza_get_new_nick(xmpp_stanza_t *const stanza);
xmpp_stanza_t* stanza_create_instant_room_request_iq(xmpp_ctx_t *ctx, const char *const room_jid);
xmpp_stanza_t* stanza_create_instant_room_destroy_iq(xmpp_ctx_t *ctx, const char *const room_jid);
xmpp_stanza_t* stanza_create_room_config_request_iq(xmpp_ctx_t *ctx, const char *const room_jid);
xmpp_stanza_t* stanza_create_room_config_cancel_iq(xmpp_ctx_t *ctx, const char *const room_jid);
xmpp_stanza_t* stanza_create_room_config_submit_iq(xmpp_ctx_t *ctx, const char *const room, DataForm *form);
xmpp_stanza_t* stanza_create_room_affiliation_list_iq(xmpp_ctx_t *ctx, const char *const room,
    const char *const affiliation);
xmpp_stanza_t* stanza_create_room_affiliation_set_iq(xmpp_ctx_t *ctx, const char *const room, const char *const jid,
    const char *const affiliation, const char *const reason);
xmpp_stanza_t* stanza_create_room_role_set_iq(xmpp_ctx_t *const ctx, const char *const room, const char *const jid,
    const char *const role, const char *const reason);
xmpp_stanza_t* stanza_create_room_role_list_iq(xmpp_ctx_t *ctx, const char *const room, const char *const role);

xmpp_stanza_t* stanza_create_room_subject_message(xmpp_ctx_t *ctx, const char *const room, const char *const subject);
xmpp_stanza_t* stanza_create_room_kick_iq(xmpp_ctx_t *const ctx, const char *const room, const char *const nick,
    const char *const reason);

int stanza_get_idle_time(xmpp_stanza_t *const stanza);
char* stanza_get_caps_str(xmpp_stanza_t *const stanza);

DataForm* stanza_create_form(xmpp_stanza_t *const stanza);
void stanza_destroy_form(DataForm *form);

void stanza_attach_priority(xmpp_ctx_t *const ctx, xmpp_stanza_t *const presence, const int pri);
void stanza_attach_last_activity(xmpp_ctx_t *const ctx, xmpp_stanza_t *const presence, const int idle);
void stanza_attach_caps(xmpp_ctx_t *const ctx, xmpp_stanza_t *const presence);
void stanza_attach_show(xmpp_ctx_t *const ctx, xmpp_stanza_t *const presence, const char *const show);
void stanza_attach_status(xmpp_ctx_t *const ctx, xmpp_stanza_t *const presence, const char *const status);

const char* stanza_get_presence_string_from_type(resource_presence_t presence_type);
xmpp_stanza_t* stanza_create_software_version_iq(xmpp_ctx_t *ctx, const char *const fulljid);
xmpp_stanza_t* stanza_create_disco_items_iq(xmpp_ctx_t *ctx, const char *const id, const char *const jid);

char* stanza_get_status(xmpp_stanza_t *stanza, char *def);
char* stanza_get_show(xmpp_stanza_t *stanza, char *def);

xmpp_stanza_t* stanza_create_roster_set(xmpp_ctx_t *ctx, const char *const id, const char *const jid,
    const char *const handle, GSList *groups);
xmpp_stanza_t* stanza_create_roster_remove_set(xmpp_ctx_t *ctx, const char *const barejid);

char* stanza_get_error_message(xmpp_stanza_t *const stanza);

GSList* stanza_get_status_codes_by_ns(xmpp_stanza_t *const stanza, char *ns);
gboolean stanza_room_destroyed(xmpp_stanza_t *stanza);
char* stanza_get_muc_destroy_alternative_room(xmpp_stanza_t *stanza);
char* stanza_get_muc_destroy_alternative_password(xmpp_stanza_t *stanza);
char* stanza_get_muc_destroy_reason(xmpp_stanza_t *stanza);
char* stanza_get_actor(xmpp_stanza_t *stanza);
char* stanza_get_reason(xmpp_stanza_t *stanza);

Resource* stanza_resource_from_presence(XMPPPresence *presence);
XMPPPresence* stanza_parse_presence(xmpp_stanza_t *stanza, int *err);
void stanza_free_presence(XMPPPresence *presence);

XMPPCaps* stanza_parse_caps(xmpp_stanza_t *const stanza);
void stanza_free_caps(XMPPCaps *caps);

#endif
cbe4ee1ef8f610411015c30'>b301e0c0 ^
6d12a8c4 ^


805d58c6 ^







6d12a8c4 ^


805d58c6 ^
3ea092f2 ^
6d12a8c4 ^
b301e0c0 ^
6d12a8c4 ^

805d58c6 ^







6d12a8c4 ^











b301e0c0 ^

6d12a8c4 ^

805d58c6 ^
6d12a8c4 ^
b301e0c0 ^
6d12a8c4 ^
805d58c6 ^







4f2adf06 ^
6d12a8c4 ^

805d58c6 ^
6d12a8c4 ^

b301e0c0 ^
6d12a8c4 ^


805d58c6 ^







4f2adf06 ^
6d12a8c4 ^

805d58c6 ^
6d12a8c4 ^

b301e0c0 ^
6d12a8c4 ^

805d58c6 ^







6d12a8c4 ^


b301e0c0 ^
6d12a8c4 ^

b301e0c0 ^
805d58c6 ^
b301e0c0 ^
805d58c6 ^

b301e0c0 ^
94ffc377 ^
805d58c6 ^
6d12a8c4 ^



b301e0c0 ^
6d12a8c4 ^
4a48bedc ^
6d12a8c4 ^
b301e0c0 ^
6d12a8c4 ^





94ffc377 ^
b301e0c0 ^
6d12a8c4 ^

b301e0c0 ^
6d12a8c4 ^
4a48bedc ^
b301e0c0 ^
6d12a8c4 ^

b301e0c0 ^
6d12a8c4 ^











f0c55e6b ^
6d12a8c4 ^
2f02189d ^



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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460




                                                                                          
                                         

                                                
                                                                                                               


                                           


                                                                                                 
                                       
                                      
                             
                               
                            
                              
                                   
                             
                           
                            
                                                        
                              





                               






















                                                                                 


         
                             
                         









                                                                                                                                                    

                                                                                                                                                                                                                                                                                                                                                                                       

                                                                                
                                                     
                                            
                                                                                                                                                                                                                                                              
                                                                  







                                                                                                                                                                                                                                                                                                                                                                                         


                                                                                                             
                                                                                                                         

                                                
                                                                                                                                                                                                                                                                


                                                                                               







                                                                                                                                                                                                                                                                                                                                                                                         


                                                                                                             
                                                                                   

                                                
                                                                                                                                                                                                                                                                

                                                                  







                                                                                                                                                                                                                                                                                                                                                                                         









                                                                                                                                           

                                                                                                                                                                                                                                                                                                                                                                                       

                                                                                
                                                     
                                            
                                                                                                                                                                                                                                                              
                                                                  







                                                                                                                                                                                                                                                                                                                                                                                         


                                                                                                                                     
                                                                                                                         

                                                
                                                                                                                                                                                                                                                                


                                                                                               







                                                                                                                                                                                                                                                                                                                                                                                          


                                                                                                              
                                                                                    

                                                 
                                                                                                                                                                                                                                                                 

                                                                   







                                                                                                                                                                                                                                                                                                                                                                                          


                                             
                                                                                                                                                                                        

                                                                                                
                                                                                                                                                                                         
                                                                                               
                                                                                                                                                                       
                                                                                               
                                                                                                                                                                                                                                                 
                                                                                                                                                                                                                                                                                                 
                                                                                                                           



                                                                                                                            
                                                                                                                                                                                                                                                     
                                                                                     
                                                                                     
                                                                                                           
                                                                                                                                                                                                       





                                                                                                                                                                        
                                                                                                                                                                                                                                      
                                                                                                                                                                                                                          


                                                                                                                                                                          
                                                                                                                                                               

                                           
                                                                                                                                                                                                                                                                       
                                                                                     
                                                                                     
                                                                                                                                                       
                                                                                                                                                                            



                                                                                                                                                                          
                                                                                                                                                                     





                                                                                                                                                                                          
                                                                                                                                                                                                                                    
                                                                                     
                                                                                     

                                                                                                                                                                





                                                                                                                                                                         
                                                                            
                                                                                                                           

                                           
                                                                                                                                                                                                                                                       
                                                                                     
                                                                                     









                                                                                                                                                                                       
                                                                                                                                                                                                           
                                                                                     
                                                                                     

                                                                                                                                                                                                            


                                                                                               
                                                                                                                                                                                                                
                                                                                     
                                                                                     











                                                                                                                                            

                                                                                                                                                                                                                                                                                                                                                                                        

                                                                                 
                                                      
                                             
                                                                                                                                                                                                                                                               
                                                                   







                                                                                                                                                                                                                                                                                                                                                                                          


                                                                                                                                                  


                                                                                                                                                                                       
                                             
                                                 
                                                                                                                                                                                                                                                                 


                                                                                              







                                                                                                                                                                                                                                                                                                                                                                                          


                                                                                                              
                                                                                    
                                             
                                                 
                                                                                                                                                                                                                                                                 

                                                                   







                                                                                                                                                                                                                                                                                                                                                                                          











                                                                                                                                                           

                                                                                                                                                                                                                                                                                                                                                                                        

                                                                                 
                                                      
                                             
                                                                                                                                                                                                                                                               
                                                                   







                                                                                                                                                                                                                                                                                                                                                                                          
                                             

                                                                                                              
                                                                                                                          

                                                 
                                                                                                                                                                                                                                                                 


                                                                                                     







                                                                                                                                                                                                                                                                                        
                                             

                                                                                                                              
                                                                                    

                                                 
                                                                                                                                                                                                                                                                 

                                                                   







                                                                                                                                                                                                                                                                                        


                                             
                                                                                                                                                                                        

                                                                                                          
                                                                                                                                                                                           
                                                                                               
                                                                                                                                                                                           

                                                                                                                                                                                             
                                                                                                                                                                                                                                                                                                   
                                                                                                                                                                                                                                                                                                 
                                                                                                                           



                                                                                                                                                 
                                                                                                                                                                                                                                                       
                                                                                     
                                                                                     
                                                                                                           
                                                                                                                                                                                                       





                                                                                                                                                                        
                                                                                                                                                                                                                                                
                                                                                                                                                                                                     

                                           
                                                                                                                                                                                                                                                                                                 
                                                                                     
                                                                                     
                                                                                                                                                                            

                                                                                                                                                                
                                                                                                                                                                                                                          











                                                                                                                                                                                                     
                                                                                                                      
                                           



                                     
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Mu - edit/006-sandbox-copy.mu</title>
<meta name="Generator" content="Vim/7.4">
<meta name="plugin-version" content="vim7.4_v2">
<meta name="syntax" content="none">
<meta name="settings" content="number_lines,use_css,pre_wrap,no_foldcolumn,expand_tabs,line_ids,prevent_copy=">
<meta name="colorscheme" content="minimal">
<style type="text/css">
<!--
pre { white-space: pre-wrap; font-family: monospace; color: #aaaaaa; background-color: #080808; }
body { font-size: 12pt; font-family: monospace; color: #aaaaaa; background-color: #080808; }
a { color:#eeeeee; text-decoration: none; }
a:hover { text-decoration: underline; }
* { font-size: 12pt; font-size: 1em; }
.muRecipe { color: #ff8700; }
.muScenario { color: #00af00; }
.Special { color: #c00000; }
.Delimiter { color: #800080; }
.SalientComment { color: #00ffff; }
.Constant { color: #00a0a0; }
.LineNr { color: #444444; }
.Comment { color: #9090ff; }
.Comment a { color:#0000ee; text-decoration:underline; }
.muControl { color: #c0a020; }
-->
</style>

<script type='text/javascript'>
<!--

/* function to open any folds containing a jumped-to line before jumping to it */
function JumpToLine()
{
  var lineNum;
  lineNum = window.location.hash;
  lineNum = lineNum.substr(1); /* strip off '#' */

  if (lineNum.indexOf('L') == -1) {
    lineNum = 'L'+lineNum;
  }
  lineElem = document.getElementById(lineNum);
  /* Always jump to new location even if the line was hidden inside a fold, or
   * we corrected the raw number to a line ID.
   */
  if (lineElem) {
    lineElem.scrollIntoView(true);
  }
  return true;
}
if ('onhashchange' in window) {
  window.onhashchange = JumpToLine;
}

-->
</script>
</head>
<body onload='JumpToLine();'>
<pre id='vimCodeElement'>
<span id="L1" class="LineNr">  1 </span><span class="SalientComment">## the 'copy' button makes it easy to duplicate a sandbox, and thence to</span>
<span id="L2" class="LineNr">  2 </span><span class="SalientComment">## see code operate in multiple situations</span>
<span id="L3" class="LineNr">  3 </span>
<span id="L4" class="LineNr">  4 </span><span class="muScenario">scenario</span> copy-a-sandbox-to-editor [
<span id="L5" class="LineNr">  5 </span>  <span class="Constant">local-scope</span>
<span id="L6" class="LineNr">  6 </span>  trace-until <span class="Constant">100/app</span>  <span class="Comment"># trace too long</span>
<span id="L7" class="LineNr">  7 </span>  assume-screen <span class="Constant">100/width</span>, <span class="Constant">10/height</span>
<span id="L8" class="LineNr">  8 </span>  <span class="Comment"># empty recipes</span>
<span id="L9" class="LineNr">  9 </span>  assume-resources [
<span id="L10" class="LineNr"> 10 </span>  ]
<span id="L11" class="LineNr"> 11 </span>  env:&amp;:environment <span class="Special">&lt;-</span> <a href='004-programming-environment.mu.html#L21'>new-programming-environment</a> <a href='../088file.mu.html#L11'>resources</a>, <a href='../081print.mu.html#L16'>screen</a>, <span class="Constant">[add 1, 1]</span>  <span class="Comment"># contents of sandbox editor</span>
<span id="L12" class="LineNr"> 12 </span>  <a href='004-programming-environment.mu.html#L402'>render-all</a> <a href='../081print.mu.html#L16'>screen</a>, env, <a href='001-editor.mu.html#L107'>render</a>
<span id="L13" class="LineNr"> 13 </span>  <span class="Comment"># run it</span>
<span id="L14" class="LineNr"> 14 </span>  assume-console [
<span id="L15" class="LineNr"> 15 </span>    press F4
<span id="L16" class="LineNr"> 16 </span>  ]
<span id="L17" class="LineNr"> 17 </span>  <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L18" class="LineNr"> 18 </span>  screen-should-contain [
<span id="L19" class="LineNr"> 19 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L20" class="LineNr"> 20 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L21" class="LineNr"> 21 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L22" class="LineNr"> 22 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L23" class="LineNr"> 23 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L24" class="LineNr"> 24 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L25" class="LineNr"> 25 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L26" class="LineNr"> 26 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L27" class="LineNr"> 27 </span>  ]
<span id="L28" class="LineNr"> 28 </span>  <span class="Comment"># click at left edge of 'copy' button</span>
<span id="L29" class="LineNr"> 29 </span>  assume-console [
<span id="L30" class="LineNr"> 30 </span>    left-click<span class="Constant"> 3</span>,<span class="Constant"> 69</span>
<span id="L31" class="LineNr"> 31 </span>  ]
<span id="L32" class="LineNr"> 32 </span>  run [
<span id="L33" class="LineNr"> 33 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L34" class="LineNr"> 34 </span>  ]
<span id="L35" class="LineNr"> 35 </span>  <span class="Comment"># it copies into editor</span>
<span id="L36" class="LineNr"> 36 </span>  screen-should-contain [
<span id="L37" class="LineNr"> 37 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L38" class="LineNr"> 38 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L39" class="LineNr"> 39 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L40" class="LineNr"> 40 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L41" class="LineNr"> 41 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L42" class="LineNr"> 42 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L43" class="LineNr"> 43 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L44" class="LineNr"> 44 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L45" class="LineNr"> 45 </span>  ]
<span id="L46" class="LineNr"> 46 </span>  <span class="Comment"># cursor should be in the right place</span>
<span id="L47" class="LineNr"> 47 </span>  assume-console [
<span id="L48" class="LineNr"> 48 </span>    type <span class="Constant">[0]</span>
<span id="L49" class="LineNr"> 49 </span>  ]
<span id="L50" class="LineNr"> 50 </span>  run [
<span id="L51" class="LineNr"> 51 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L52" class="LineNr"> 52 </span>  ]
<span id="L53" class="LineNr"> 53 </span>  screen-should-contain [
<span id="L54" class="LineNr"> 54 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L55" class="LineNr"> 55 </span>   <span class="Constant"> .                                                  ╎0add 1, 1                                        .</span>
<span id="L56" class="LineNr"> 56 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L57" class="LineNr"> 57 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L58" class="LineNr"> 58 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L59" class="LineNr"> 59 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L60" class="LineNr"> 60 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L61" class="LineNr"> 61 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L62" class="LineNr"> 62 </span>  ]
<span id="L63" class="LineNr"> 63 </span>]
<span id="L64" class="LineNr"> 64 </span>
<span id="L65" class="LineNr"> 65 </span><span class="muScenario">scenario</span> copy-a-sandbox-to-editor-2 [
<span id="L66" class="LineNr"> 66 </span>  <span class="Constant">local-scope</span>
<span id="L67" class="LineNr"> 67 </span>  trace-until <span class="Constant">100/app</span>  <span class="Comment"># trace too long</span>
<span id="L68" class="LineNr"> 68 </span>  assume-screen <span class="Constant">100/width</span>, <span class="Constant">10/height</span>
<span id="L69" class="LineNr"> 69 </span>  <span class="Comment"># empty recipes</span>
<span id="L70" class="LineNr"> 70 </span>  assume-resources [
<span id="L71" class="LineNr"> 71 </span>  ]
<span id="L72" class="LineNr"> 72 </span>  env:&amp;:environment <span class="Special">&lt;-</span> <a href='004-programming-environment.mu.html#L21'>new-programming-environment</a> <a href='../088file.mu.html#L11'>resources</a>, <a href='../081print.mu.html#L16'>screen</a>, <span class="Constant">[add 1, 1]</span>  <span class="Comment"># contents of sandbox editor</span>
<span id="L73" class="LineNr"> 73 </span>  <a href='004-programming-environment.mu.html#L402'>render-all</a> <a href='../081print.mu.html#L16'>screen</a>, env, <a href='001-editor.mu.html#L107'>render</a>
<span id="L74" class="LineNr"> 74 </span>  <span class="Comment"># run it</span>
<span id="L75" class="LineNr"> 75 </span>  assume-console [
<span id="L76" class="LineNr"> 76 </span>    press F4
<span id="L77" class="LineNr"> 77 </span>  ]
<span id="L78" class="LineNr"> 78 </span>  <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L79" class="LineNr"> 79 </span>  screen-should-contain [
<span id="L80" class="LineNr"> 80 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L81" class="LineNr"> 81 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L82" class="LineNr"> 82 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L83" class="LineNr"> 83 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L84" class="LineNr"> 84 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L85" class="LineNr"> 85 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L86" class="LineNr"> 86 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L87" class="LineNr"> 87 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L88" class="LineNr"> 88 </span>  ]
<span id="L89" class="LineNr"> 89 </span>  <span class="Comment"># click at right edge of 'copy' button (just before 'delete')</span>
<span id="L90" class="LineNr"> 90 </span>  assume-console [
<span id="L91" class="LineNr"> 91 </span>    left-click<span class="Constant"> 3</span>,<span class="Constant"> 76</span>
<span id="L92" class="LineNr"> 92 </span>  ]
<span id="L93" class="LineNr"> 93 </span>  run [
<span id="L94" class="LineNr"> 94 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L95" class="LineNr"> 95 </span>  ]
<span id="L96" class="LineNr"> 96 </span>  <span class="Comment"># it copies into editor</span>
<span id="L97" class="LineNr"> 97 </span>  screen-should-contain [
<span id="L98" class="LineNr"> 98 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L99" class="LineNr"> 99 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L100" class="LineNr">100 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L101" class="LineNr">101 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L102" class="LineNr">102 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L103" class="LineNr">103 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L104" class="LineNr">104 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L105" class="LineNr">105 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L106" class="LineNr">106 </span>  ]
<span id="L107" class="LineNr">107 </span>  <span class="Comment"># cursor should be in the right place</span>
<span id="L108" class="LineNr">108 </span>  assume-console [
<span id="L109" class="LineNr">109 </span>    type <span class="Constant">[0]</span>
<span id="L110" class="LineNr">110 </span>  ]
<span id="L111" class="LineNr">111 </span>  run [
<span id="L112" class="LineNr">112 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L113" class="LineNr">113 </span>  ]
<span id="L114" class="LineNr">114 </span>  screen-should-contain [
<span id="L115" class="LineNr">115 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L116" class="LineNr">116 </span>   <span class="Constant"> .                                                  ╎0add 1, 1                                        .</span>
<span id="L117" class="LineNr">117 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L118" class="LineNr">118 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L119" class="LineNr">119 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L120" class="LineNr">120 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L121" class="LineNr">121 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L122" class="LineNr">122 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L123" class="LineNr">123 </span>  ]
<span id="L124" class="LineNr">124 </span>]
<span id="L125" class="LineNr">125 </span>
<span id="L126" class="LineNr">126 </span><span class="muRecipe">after</span> <span class="Constant"><a href='004-programming-environment.mu.html#L81'>&lt;global-touch&gt;</a></span> [
<span id="L127" class="LineNr">127 </span>  <span class="Comment"># support 'copy' button</span>
<span id="L128" class="LineNr">128 </span>  <span class="Delimiter">{</span>
<span id="L129" class="LineNr">129 </span>    copy?:bool <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L140'>should-attempt-copy?</a> click-row, click-column, env
<span id="L130" class="LineNr">130 </span>    <span class="muControl">break-unless</span> copy?
<span id="L131" class="LineNr">131 </span>    copy?, env <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L159'>try-copy-sandbox</a> click-row, env
<span id="L132" class="LineNr">132 </span>    <span class="muControl">break-unless</span> copy?
<span id="L133" class="LineNr">133 </span>    <a href='../081print.mu.html#L16'>screen</a> <span class="Special">&lt;-</span> render-sandbox-side <a href='../081print.mu.html#L16'>screen</a>, env, <a href='001-editor.mu.html#L107'>render</a>
<span id="L134" class="LineNr">134 </span>    <a href='../081print.mu.html#L16'>screen</a> <span class="Special">&lt;-</span> <a href='004-programming-environment.mu.html#L468'>update-cursor</a> <a href='../081print.mu.html#L16'>screen</a>, recipes, current-sandbox, sandbox-in-focus?, env
<span id="L135" class="LineNr">135 </span>   <span class="muControl"> loop</span> <span class="Constant">+next-event</span>
<span id="L136" class="LineNr">136 </span>  <span class="Delimiter">}</span>
<span id="L137" class="LineNr">137 </span>]
<span id="L138" class="LineNr">138 </span>
<span id="L139" class="LineNr">139 </span><span class="Comment"># some preconditions for attempting to copy a sandbox</span>
<span id="L140" class="LineNr">140 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L140'>should-attempt-copy?</a> click-row:num, click-column:num, env:&amp;:environment<span class="muRecipe"> -&gt; </span>result:bool [
<span id="L141" class="LineNr">141 </span>  <span class="Constant">local-scope</span>
<span id="L142" class="LineNr">142 </span>  <span class="Constant">load-inputs</span>
<span id="L143" class="LineNr">143 </span>  <span class="Comment"># are we below the sandbox editor?</span>
<span id="L144" class="LineNr">144 </span>  click-sandbox-area?:bool <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L190'>click-on-sandbox-area?</a> click-row, click-column, env
<span id="L145" class="LineNr">145 </span>  <span class="muControl">return-unless</span> click-sandbox-area?, <span class="Constant">0/false</span>
<span id="L146" class="LineNr">146 </span>  <span class="Comment"># narrower, is the click in the columns spanning the 'copy' button?</span>
<span id="L147" class="LineNr">147 </span>  first-sandbox:&amp;:editor <span class="Special">&lt;-</span> get *env, <span class="Constant">current-sandbox:offset</span>
<span id="L148" class="LineNr">148 </span>  assert first-sandbox, <span class="Constant">[!!]</span>
<span id="L149" class="LineNr">149 </span>  sandbox-left-margin:num <span class="Special">&lt;-</span> get *first-sandbox, <span class="Constant">left:offset</span>
<span id="L150" class="LineNr">150 </span>  sandbox-right-margin:num <span class="Special">&lt;-</span> get *first-sandbox, <span class="Constant">right:offset</span>
<span id="L151" class="LineNr">151 </span>  _, _, copy-button-left:num, copy-button-right:num <span class="Special">&lt;-</span> <a href='005-sandbox.mu.html#L376'>sandbox-menu-columns</a> sandbox-left-margin, sandbox-right-margin
<span id="L152" class="LineNr">152 </span>  copy-button-vertical-area?:bool <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L211'>within-range?</a> click-column, copy-button-left, copy-button-right
<span id="L153" class="LineNr">153 </span>  <span class="muControl">return-unless</span> copy-button-vertical-area?, <span class="Constant">0/false</span>
<span id="L154" class="LineNr">154 </span>  <span class="Comment"># finally, is sandbox editor empty?</span>
<span id="L155" class="LineNr">155 </span>  current-sandbox:&amp;:editor <span class="Special">&lt;-</span> get *env, <span class="Constant">current-sandbox:offset</span>
<span id="L156" class="LineNr">156 </span>  result <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L203'>empty-editor?</a> current-sandbox
<span id="L157" class="LineNr">157 </span>]
<span id="L158" class="LineNr">158 </span>
<span id="L159" class="LineNr">159 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L159'>try-copy-sandbox</a> click-row:num, env:&amp;:environment<span class="muRecipe"> -&gt; </span>clicked-on-copy-button?:bool, env:&amp;:environment [
<span id="L160" class="LineNr">160 </span>  <span class="Constant">local-scope</span>
<span id="L161" class="LineNr">161 </span>  <span class="Constant">load-inputs</span>
<span id="L162" class="LineNr">162 </span>  <span class="Comment"># identify the sandbox to copy, if the click was actually on the 'copy' button</span>
<span id="L163" class="LineNr">163 </span>  sandbox:&amp;:sandbox <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L175'>find-sandbox</a> env, click-row
<span id="L164" class="LineNr">164 </span>  <span class="muControl">return-unless</span> sandbox, <span class="Constant">0/false</span>
<span id="L165" class="LineNr">165 </span>  clicked-on-copy-button? <span class="Special">&lt;-</span> copy <span class="Constant">1/true</span>
<span id="L166" class="LineNr">166 </span>  text:text <span class="Special">&lt;-</span> get *sandbox, <span class="Constant">data:offset</span>
<span id="L167" class="LineNr">167 </span>  current-sandbox:&amp;:editor <span class="Special">&lt;-</span> get *env, <span class="Constant">current-sandbox:offset</span>
<span id="L168" class="LineNr">168 </span>  current-sandbox <span class="Special">&lt;-</span> <a href='001-editor.mu.html#L72'>insert-text</a> current-sandbox, text
<span id="L169" class="LineNr">169 </span>  <span class="Comment"># reset scroll</span>
<span id="L170" class="LineNr">170 </span>  *env <span class="Special">&lt;-</span> put *env, <span class="Constant">render-from:offset</span>,<span class="Constant"> -1</span>
<span id="L171" class="LineNr">171 </span>  <span class="Comment"># position cursor in sandbox editor</span>
<span id="L172" class="LineNr">172 </span>  *env <span class="Special">&lt;-</span> put *env, <span class="Constant">sandbox-in-focus?:offset</span>, <span class="Constant">1/true</span>
<span id="L173" class="LineNr">173 </span>]
<span id="L174" class="LineNr">174 </span>
<span id="L175" class="LineNr">175 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L175'>find-sandbox</a> env:&amp;:environment, click-row:num<span class="muRecipe"> -&gt; </span>result:&amp;:sandbox [
<span id="L176" class="LineNr">176 </span>  <span class="Constant">local-scope</span>
<span id="L177" class="LineNr">177 </span>  <span class="Constant">load-inputs</span>
<span id="L178" class="LineNr">178 </span>  curr-sandbox:&amp;:sandbox <span class="Special">&lt;-</span> get *env, <span class="Constant">sandbox:offset</span>
<span id="L179" class="LineNr">179 </span>  <span class="Delimiter">{</span>
<span id="L180" class="LineNr">180 </span>    <span class="muControl">break-unless</span> curr-sandbox
<span id="L181" class="LineNr">181 </span>    start:num <span class="Special">&lt;-</span> get *curr-sandbox, <span class="Constant">starting-row-on-screen:offset</span>
<span id="L182" class="LineNr">182 </span>    found?:bool <span class="Special">&lt;-</span> equal click-row, start
<span id="L183" class="LineNr">183 </span>    <span class="muControl">return-if</span> found?, curr-sandbox
<span id="L184" class="LineNr">184 </span>    curr-sandbox <span class="Special">&lt;-</span> get *curr-sandbox, <span class="Constant">next-sandbox:offset</span>
<span id="L185" class="LineNr">185 </span>   <span class="muControl"> loop</span>
<span id="L186" class="LineNr">186 </span>  <span class="Delimiter">}</span>
<span id="L187" class="LineNr">187 </span> <span class="muControl"> return</span> <span class="Constant">0/not-found</span>
<span id="L188" class="LineNr">188 </span>]
<span id="L189" class="LineNr">189 </span>
<span id="L190" class="LineNr">190 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L190'>click-on-sandbox-area?</a> click-row:num, click-column:num, env:&amp;:environment<span class="muRecipe"> -&gt; </span>result:bool [
<span id="L191" class="LineNr">191 </span>  <span class="Constant">local-scope</span>
<span id="L192" class="LineNr">192 </span>  <span class="Constant">load-inputs</span>
<span id="L193" class="LineNr">193 </span>  current-sandbox:&amp;:editor <span class="Special">&lt;-</span> get *env, <span class="Constant">current-sandbox:offset</span>
<span id="L194" class="LineNr">194 </span>  sandbox-left-margin:num <span class="Special">&lt;-</span> get *current-sandbox, <span class="Constant">left:offset</span>
<span id="L195" class="LineNr">195 </span>  on-sandbox-side?:bool <span class="Special">&lt;-</span> greater-or-equal click-column, sandbox-left-margin
<span id="L196" class="LineNr">196 </span>  <span class="muControl">return-unless</span> on-sandbox-side?, <span class="Constant">0/false</span>
<span id="L197" class="LineNr">197 </span>  first-sandbox:&amp;:sandbox <span class="Special">&lt;-</span> get *env, <span class="Constant">sandbox:offset</span>
<span id="L198" class="LineNr">198 </span>  <span class="muControl">return-unless</span> first-sandbox, <span class="Constant">0/false</span>
<span id="L199" class="LineNr">199 </span>  first-sandbox-begins:num <span class="Special">&lt;-</span> get *first-sandbox, <span class="Constant">starting-row-on-screen:offset</span>
<span id="L200" class="LineNr">200 </span>  result <span class="Special">&lt;-</span> greater-or-equal click-row, first-sandbox-begins
<span id="L201" class="LineNr">201 </span>]
<span id="L202" class="LineNr">202 </span>
<span id="L203" class="LineNr">203 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L203'>empty-editor?</a> editor:&amp;:editor<span class="muRecipe"> -&gt; </span>result:bool [
<span id="L204" class="LineNr">204 </span>  <span class="Constant">local-scope</span>
<span id="L205" class="LineNr">205 </span>  <span class="Constant">load-inputs</span>
<span id="L206" class="LineNr">206 </span>  head:&amp;:<a href='../065duplex_list.mu.html#L3'>duplex-list</a>:char <span class="Special">&lt;-</span> get *editor, <span class="Constant">data:offset</span>
<span id="L207" class="LineNr">207 </span>  first:&amp;:<a href='../065duplex_list.mu.html#L3'>duplex-list</a>:char <span class="Special">&lt;-</span> <a href='../065duplex_list.mu.html#L25'>next</a> head
<span id="L208" class="LineNr">208 </span>  result <span class="Special">&lt;-</span> not first
<span id="L209" class="LineNr">209 </span>]
<span id="L210" class="LineNr">210 </span>
<span id="L211" class="LineNr">211 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L211'>within-range?</a> x:num, low:num, high:num<span class="muRecipe"> -&gt; </span>result:bool [
<span id="L212" class="LineNr">212 </span>  <span class="Constant">local-scope</span>
<span id="L213" class="LineNr">213 </span>  <span class="Constant">load-inputs</span>
<span id="L214" class="LineNr">214 </span>  not-too-far-left?:bool <span class="Special">&lt;-</span> greater-or-equal x, low
<span id="L215" class="LineNr">215 </span>  not-too-far-right?:bool <span class="Special">&lt;-</span> lesser-or-equal x, high
<span id="L216" class="LineNr">216 </span>  result <span class="Special">&lt;-</span> and not-too-far-left? not-too-far-right?
<span id="L217" class="LineNr">217 </span>]
<span id="L218" class="LineNr">218 </span>
<span id="L219" class="LineNr">219 </span><span class="muScenario">scenario</span> copy-fails-if-sandbox-editor-not-empty [
<span id="L220" class="LineNr">220 </span>  <span class="Constant">local-scope</span>
<span id="L221" class="LineNr">221 </span>  trace-until <span class="Constant">100/app</span>  <span class="Comment"># trace too long</span>
<span id="L222" class="LineNr">222 </span>  assume-screen <span class="Constant">100/width</span>, <span class="Constant">10/height</span>
<span id="L223" class="LineNr">223 </span>  <span class="Comment"># empty recipes</span>
<span id="L224" class="LineNr">224 </span>  assume-resources [
<span id="L225" class="LineNr">225 </span>  ]
<span id="L226" class="LineNr">226 </span>  env:&amp;:environment <span class="Special">&lt;-</span> <a href='004-programming-environment.mu.html#L21'>new-programming-environment</a> <a href='../088file.mu.html#L11'>resources</a>, <a href='../081print.mu.html#L16'>screen</a>, <span class="Constant">[add 1, 1]</span>  <span class="Comment"># contents of sandbox editor</span>
<span id="L227" class="LineNr">227 </span>  <a href='004-programming-environment.mu.html#L402'>render-all</a> <a href='../081print.mu.html#L16'>screen</a>, env, <a href='001-editor.mu.html#L107'>render</a>
<span id="L228" class="LineNr">228 </span>  <span class="Comment"># run it</span>
<span id="L229" class="LineNr">229 </span>  assume-console [
<span id="L230" class="LineNr">230 </span>    press F4
<span id="L231" class="LineNr">231 </span>  ]
<span id="L232" class="LineNr">232 </span>  <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L233" class="LineNr">233 </span>  screen-should-contain [
<span id="L234" class="LineNr">234 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L235" class="LineNr">235 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L236" class="LineNr">236 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L237" class="LineNr">237 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L238" class="LineNr">238 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L239" class="LineNr">239 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L240" class="LineNr">240 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L241" class="LineNr">241 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L242" class="LineNr">242 </span>  ]
<span id="L243" class="LineNr">243 </span>  <span class="Comment"># type something into the sandbox editor, then click on the 'copy' button</span>
<span id="L244" class="LineNr">244 </span>  assume-console [
<span id="L245" class="LineNr">245 </span>    left-click<span class="Constant"> 2</span>,<span class="Constant"> 70</span>  <span class="Comment"># put cursor in sandbox editor</span>
<span id="L246" class="LineNr">246 </span>    type <span class="Constant">[0]</span>  <span class="Comment"># type something</span>
<span id="L247" class="LineNr">247 </span>    left-click<span class="Constant"> 3</span>,<span class="Constant"> 70</span>  <span class="Comment"># click 'copy' button</span>
<span id="L248" class="LineNr">248 </span>  ]
<span id="L249" class="LineNr">249 </span>  run [
<span id="L250" class="LineNr">250 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L251" class="LineNr">251 </span>  ]
<span id="L252" class="LineNr">252 </span>  <span class="Comment"># copy doesn't happen</span>
<span id="L253" class="LineNr">253 </span>  screen-should-contain [
<span id="L254" class="LineNr">254 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L255" class="LineNr">255 </span>   <span class="Constant"> .                                                  ╎0                                                .</span>
<span id="L256" class="LineNr">256 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L257" class="LineNr">257 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L258" class="LineNr">258 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L259" class="LineNr">259 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L260" class="LineNr">260 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L261" class="LineNr">261 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L262" class="LineNr">262 </span>  ]
<span id="L263" class="LineNr">263 </span>  <span class="Comment"># cursor should be in the right place</span>
<span id="L264" class="LineNr">264 </span>  assume-console [
<span id="L265" class="LineNr">265 </span>    type <span class="Constant">[1]</span>
<span id="L266" class="LineNr">266 </span>  ]
<span id="L267" class="LineNr">267 </span>  run [
<span id="L268" class="LineNr">268 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L269" class="LineNr">269 </span>  ]
<span id="L270" class="LineNr">270 </span>  screen-should-contain [
<span id="L271" class="LineNr">271 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L272" class="LineNr">272 </span>   <span class="Constant"> .                                                  ╎01                                               .</span>
<span id="L273" class="LineNr">273 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L274" class="LineNr">274 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L275" class="LineNr">275 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L276" class="LineNr">276 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L277" class="LineNr">277 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L278" class="LineNr">278 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L279" class="LineNr">279 </span>  ]
<span id="L280" class="LineNr">280 </span>]
<span id="L281" class="LineNr">281 </span>
<span id="L282" class="LineNr">282 </span><span class="SalientComment">## the 'to recipe' button makes it easy to create a function out of a sandbox</span>
<span id="L283" class="LineNr">283 </span>
<span id="L284" class="LineNr">284 </span><span class="muScenario">scenario</span> copy-a-sandbox-to-recipe-side [
<span id="L285" class="LineNr">285 </span>  <span class="Constant">local-scope</span>
<span id="L286" class="LineNr">286 </span>  trace-until <span class="Constant">100/app</span>  <span class="Comment"># trace too long</span>
<span id="L287" class="LineNr">287 </span>  assume-screen <span class="Constant">100/width</span>, <span class="Constant">10/height</span>
<span id="L288" class="LineNr">288 </span>  <span class="Comment"># empty recipes</span>
<span id="L289" class="LineNr">289 </span>  assume-resources [
<span id="L290" class="LineNr">290 </span>  ]
<span id="L291" class="LineNr">291 </span>  env:&amp;:environment <span class="Special">&lt;-</span> <a href='004-programming-environment.mu.html#L21'>new-programming-environment</a> <a href='../088file.mu.html#L11'>resources</a>, <a href='../081print.mu.html#L16'>screen</a>, <span class="Constant">[add 1, 1]</span>  <span class="Comment"># contents of sandbox editor</span>
<span id="L292" class="LineNr">292 </span>  <a href='004-programming-environment.mu.html#L402'>render-all</a> <a href='../081print.mu.html#L16'>screen</a>, env, <a href='001-editor.mu.html#L107'>render</a>
<span id="L293" class="LineNr">293 </span>  <span class="Comment"># run it</span>
<span id="L294" class="LineNr">294 </span>  assume-console [
<span id="L295" class="LineNr">295 </span>    press F4
<span id="L296" class="LineNr">296 </span>  ]
<span id="L297" class="LineNr">297 </span>  <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L298" class="LineNr">298 </span>  screen-should-contain [
<span id="L299" class="LineNr">299 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L300" class="LineNr">300 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L301" class="LineNr">301 </span><span class="Constant">    .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎─────────────────────────────────────────────────.</span>
<span id="L302" class="LineNr">302 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L303" class="LineNr">303 </span>   <span class="Constant"> .                                                  ╎add 1, 1                                         .</span>
<span id="L304" class="LineNr">304 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L305" class="LineNr">305 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L306" class="LineNr">306 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L307" class="LineNr">307 </span>  ]
<span id="L308" class="LineNr">308 </span>  <span class="Comment"># click at left edge of 'copy' button</span>
<span id="L309" class="LineNr">309 </span>  assume-console [
<span id="L310" class="LineNr">310 </span>    left-click<span class="Constant"> 3</span>,<span class="Constant"> 78</span>
<span id="L311" class="LineNr">311 </span>  ]
<span id="L312" class="LineNr">312 </span>  run [
<span id="L313" class="LineNr">313 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L314" class="LineNr">314 </span>  ]
<span id="L315" class="LineNr">315 </span>  <span class="Comment"># it copies into recipe side</span>
<span id="L316" class="LineNr">316 </span>  screen-should-contain [
<span id="L317" class="LineNr">317 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L318" class="LineNr">318 </span>   <span class="Constant"> .add 1, 1                                          ╎                                                 .</span>
<span id="L319" class="LineNr">319 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L320" class="LineNr">320 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L321" class="LineNr">321 </span>   <span class="Constant"> .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎add 1, 1                                         .</span>
<span id="L322" class="LineNr">322 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L323" class="LineNr">323 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L324" class="LineNr">324 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L325" class="LineNr">325 </span>  ]
<span id="L326" class="LineNr">326 </span>  <span class="Comment"># cursor should be at the top left of the recipe side</span>
<span id="L327" class="LineNr">327 </span>  assume-console [
<span id="L328" class="LineNr">328 </span>    type <span class="Constant">[0]</span>
<span id="L329" class="LineNr">329 </span>  ]
<span id="L330" class="LineNr">330 </span>  run [
<span id="L331" class="LineNr">331 </span>    <a href='004-programming-environment.mu.html#L39'>event-loop</a> <a href='../081print.mu.html#L16'>screen</a>, <a href='../084console.mu.html#L23'>console</a>, env, <a href='../088file.mu.html#L11'>resources</a>
<span id="L332" class="LineNr">332 </span>  ]
<span id="L333" class="LineNr">333 </span>  screen-should-contain [
<span id="L334" class="LineNr">334 </span>   <span class="Constant"> .                                                                                 run (F4)           .</span>
<span id="L335" class="LineNr">335 </span>   <span class="Constant"> .0add 1, 1                                         ╎                                                 .</span>
<span id="L336" class="LineNr">336 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L337" class="LineNr">337 </span>   <span class="Constant"> .                                                  ╎0   edit       copy       to recipe    delete    .</span>
<span id="L338" class="LineNr">338 </span>   <span class="Constant"> .╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╎add 1, 1                                         .</span>
<span id="L339" class="LineNr">339 </span>   <span class="Constant"> .                                                  ╎2                                                .</span>
<span id="L340" class="LineNr">340 </span>   <span class="Constant"> .                                                  ╎─────────────────────────────────────────────────.</span>
<span id="L341" class="LineNr">341 </span>   <span class="Constant"> .                                                  ╎                                                 .</span>
<span id="L342" class="LineNr">342 </span>  ]
<span id="L343" class="LineNr">343 </span>]
<span id="L344" class="LineNr">344 </span>
<span id="L345" class="LineNr">345 </span><span class="muRecipe">after</span> <span class="Constant"><a href='004-programming-environment.mu.html#L81'>&lt;global-touch&gt;</a></span> [
<span id="L346" class="LineNr">346 </span>  <span class="Comment"># support 'copy to recipe' button</span>
<span id="L347" class="LineNr">347 </span>  <span class="Delimiter">{</span>
<span id="L348" class="LineNr">348 </span>    copy?:bool <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L360'>should-copy-to-recipe?</a> click-row, click-column, env
<span id="L349" class="LineNr">349 </span>    <span class="muControl">break-unless</span> copy?
<span id="L350" class="LineNr">350 </span>    modified?:bool <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L375'>prepend-sandbox-into-recipe-side</a> click-row, env
<span id="L351" class="LineNr">351 </span>    <span class="muControl">break-unless</span> modified?
<span id="L352" class="LineNr">352 </span>    *env <span class="Special">&lt;-</span> put *env, <span class="Constant">sandbox-in-focus?:offset</span>, <span class="Constant">0/false</span>
<span id="L353" class="LineNr">353 </span>    <a href='../081print.mu.html#L16'>screen</a> <span class="Special">&lt;-</span> <a href='004-programming-environment.mu.html#L431'>render-recipes</a> <a href='../081print.mu.html#L16'>screen</a>, env, <a href='001-editor.mu.html#L107'>render</a>
<span id="L354" class="LineNr">354 </span>    <a href='../081print.mu.html#L16'>screen</a> <span class="Special">&lt;-</span> <a href='004-programming-environment.mu.html#L468'>update-cursor</a> <a href='../081print.mu.html#L16'>screen</a>, recipes, current-sandbox, sandbox-in-focus?, env
<span id="L355" class="LineNr">355 </span>   <span class="muControl"> loop</span> <span class="Constant">+next-event</span>
<span id="L356" class="LineNr">356 </span>  <span class="Delimiter">}</span>
<span id="L357" class="LineNr">357 </span>]
<span id="L358" class="LineNr">358 </span>
<span id="L359" class="LineNr">359 </span><span class="Comment"># some preconditions for attempting to copy a sandbox into the recipe side</span>
<span id="L360" class="LineNr">360 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L360'>should-copy-to-recipe?</a> click-row:num, click-column:num, env:&amp;:environment<span class="muRecipe"> -&gt; </span>result:bool [
<span id="L361" class="LineNr">361 </span>  <span class="Constant">local-scope</span>
<span id="L362" class="LineNr">362 </span>  <span class="Constant">load-inputs</span>
<span id="L363" class="LineNr">363 </span>  <span class="Comment"># are we below the sandbox editor?</span>
<span id="L364" class="LineNr">364 </span>  click-sandbox-area?:bool <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L190'>click-on-sandbox-area?</a> click-row, click-column, env
<span id="L365" class="LineNr">365 </span>  <span class="muControl">return-unless</span> click-sandbox-area?, <span class="Constant">0/false</span>
<span id="L366" class="LineNr">366 </span>  <span class="Comment"># narrower, is the click in the columns spanning the 'copy' button?</span>
<span id="L367" class="LineNr">367 </span>  first-sandbox:&amp;:editor <span class="Special">&lt;-</span> get *env, <span class="Constant">current-sandbox:offset</span>
<span id="L368" class="LineNr">368 </span>  assert first-sandbox, <span class="Constant">[!!]</span>
<span id="L369" class="LineNr">369 </span>  sandbox-left-margin:num <span class="Special">&lt;-</span> get *first-sandbox, <span class="Constant">left:offset</span>
<span id="L370" class="LineNr">370 </span>  sandbox-right-margin:num <span class="Special">&lt;-</span> get *first-sandbox, <span class="Constant">right:offset</span>
<span id="L371" class="LineNr">371 </span>  _, _, _, _, recipe-button-left:num, recipe-button-right:num <span class="Special">&lt;-</span> <a href='005-sandbox.mu.html#L376'>sandbox-menu-columns</a> sandbox-left-margin, sandbox-right-margin
<span id="L372" class="LineNr">372 </span>  result <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L211'>within-range?</a> click-column, recipe-button-left, recipe-button-right
<span id="L373" class="LineNr">373 </span>]
<span id="L374" class="LineNr">374 </span>
<span id="L375" class="LineNr">375 </span><span class="muRecipe">def</span> <a href='006-sandbox-copy.mu.html#L375'>prepend-sandbox-into-recipe-side</a> click-row:num, env:&amp;:environment<span class="muRecipe"> -&gt; </span>clicked-on-copy-to-recipe-button?:bool, env:&amp;:environment [
<span id="L376" class="LineNr">376 </span>  <span class="Constant">local-scope</span>
<span id="L377" class="LineNr">377 </span>  <span class="Constant">load-inputs</span>
<span id="L378" class="LineNr">378 </span>  sandbox:&amp;:sandbox <span class="Special">&lt;-</span> <a href='006-sandbox-copy.mu.html#L175'>find-sandbox</a> env, click-row
<span id="L379" class="LineNr">379 </span>  <span class="muControl">return-unless</span> sandbox, <span class="Constant">0/false</span>
<span id="L380" class="LineNr">380 </span>  recipe-editor:&amp;:editor <span class="Special">&lt;-</span> get *env, <span class="Constant">recipes:offset</span>
<span id="L381" class="LineNr">381 </span>  recipe-data:&amp;:<a href='../065duplex_list.mu.html#L3'>duplex-list</a>:char <span class="Special">&lt;-</span> get *recipe-editor, <span class="Constant">data:offset</span>
<span id="L382" class="LineNr">382 </span>  <span class="Comment"># make the newly inserted code easy to delineate</span>
<span id="L383" class="LineNr">383 </span>  newline:char <span class="Special">&lt;-</span> copy<span class="Constant"> 10</span>
<span id="L384" class="LineNr">384 </span>  insert newline, recipe-data
<span id="L385" class="LineNr">385 </span>  insert newline, recipe-data
<span id="L386" class="LineNr">386 </span>  <span class="Comment"># insert code from the selected sandbox</span>
<span id="L387" class="LineNr">387 </span>  sandbox-data:text <span class="Special">&lt;-</span> get *sandbox, <span class="Constant">data:offset</span>
<span id="L388" class="LineNr">388 </span>  insert recipe-data, sandbox-data
<span id="L389" class="LineNr">389 </span>  <span class="Comment"># reset cursor</span>
<span id="L390" class="LineNr">390 </span>  *recipe-editor <span class="Special">&lt;-</span> put *recipe-editor, <span class="Constant">top-of-screen:offset</span>, recipe-data
<span id="L391" class="LineNr">391 </span>  *recipe-editor <span class="Special">&lt;-</span> put *recipe-editor, <span class="Constant">before-cursor:offset</span>, recipe-data
<span id="L392" class="LineNr">392 </span>  *recipe-editor <span class="Special">&lt;-</span> put *recipe-editor, <span class="Constant">cursor-row:offset</span>,<span class="Constant"> 1</span>
<span id="L393" class="LineNr">393 </span>  *recipe-editor <span class="Special">&lt;-</span> put *recipe-editor, <span class="Constant">cursor-column:offset</span>,<span class="Constant"> 0</span>
<span id="L394" class="LineNr">394 </span> <span class="muControl"> return</span> <span class="Constant">1/true</span>
<span id="L395" class="LineNr">395 </span>]
</pre>
</body>
</html>
<!-- vim: set foldmethod=manual : -->