annotate lib/ur/basis.urs @ 1814:2d9f831d45c9

Update tutorial for Ur/Web changes
author Adam Chlipala <adam@chlipala.net>
date Mon, 03 Sep 2012 09:51:23 -0400
parents b8558b613abd
children 36428d853c97
rev   line source
adamc@56 1 type int
adamc@56 2 type float
adamc@56 3 type string
adamc@821 4 type char
adamc@436 5 type time
adamc@737 6 type blob
adamc@91 7
adamc@119 8 type unit = {}
adamc@119 9
adamc@186 10 datatype bool = False | True
adamc@186 11
adamc@288 12 datatype option t = None | Some of t
adamc@284 13
adamc@757 14 datatype list t = Nil | Cons of t * list t
adamc@757 15
adamc@91 16
adam@1287 17 (** Polymorphic variants *)
adam@1287 18
adam@1287 19 con variant :: {Type} -> Type
adam@1287 20 val make : nm :: Name -> t ::: Type -> ts ::: {Type} -> [[nm] ~ ts] => t -> variant ([nm = t] ++ ts)
adam@1287 21 val match : ts ::: {Type} -> t ::: Type -> variant ts -> $(map (fn t' => t' -> t) ts) -> t
adam@1287 22
adam@1287 23
adamc@256 24 (** Basic type classes *)
adamc@256 25
adamc@256 26 class eq
adamc@256 27 val eq : t ::: Type -> eq t -> t -> t -> bool
adamc@257 28 val ne : t ::: Type -> eq t -> t -> t -> bool
adamc@256 29 val eq_int : eq int
adamc@394 30 val eq_float : eq float
adamc@256 31 val eq_string : eq string
adamc@821 32 val eq_char : eq char
adamc@256 33 val eq_bool : eq bool
adamc@437 34 val eq_time : eq time
adamc@422 35 val mkEq : t ::: Type -> (t -> t -> bool) -> eq t
adamc@256 36
adamc@389 37 class num
adamc@417 38 val zero : t ::: Type -> num t -> t
adamc@389 39 val neg : t ::: Type -> num t -> t -> t
adamc@389 40 val plus : t ::: Type -> num t -> t -> t -> t
adamc@389 41 val minus : t ::: Type -> num t -> t -> t -> t
adamc@389 42 val times : t ::: Type -> num t -> t -> t -> t
adamc@775 43 val divide : t ::: Type -> num t -> t -> t -> t
adamc@389 44 val mod : t ::: Type -> num t -> t -> t -> t
adamc@389 45 val num_int : num int
adamc@390 46 val num_float : num float
adamc@389 47
adamc@391 48 class ord
adamc@391 49 val lt : t ::: Type -> ord t -> t -> t -> bool
adamc@391 50 val le : t ::: Type -> ord t -> t -> t -> bool
adamc@391 51 val gt : t ::: Type -> ord t -> t -> t -> bool
adamc@391 52 val ge : t ::: Type -> ord t -> t -> t -> bool
adamc@391 53 val ord_int : ord int
adamc@394 54 val ord_float : ord float
adamc@394 55 val ord_string : ord string
adamc@821 56 val ord_char : ord char
adamc@394 57 val ord_bool : ord bool
adamc@437 58 val ord_time : ord time
adamc@961 59 val mkOrd : t ::: Type -> {Lt : t -> t -> bool, Le : t -> t -> bool} -> ord t
adamc@391 60
adamc@256 61
adamc@1061 62 (** Character operations *)
adamc@1061 63
adamc@1061 64 val isalnum : char -> bool
adamc@1061 65 val isalpha : char -> bool
adamc@1061 66 val isblank : char -> bool
adamc@1061 67 val iscntrl : char -> bool
adamc@1061 68 val isdigit : char -> bool
adamc@1061 69 val isgraph : char -> bool
adamc@1061 70 val islower : char -> bool
adamc@1061 71 val isprint : char -> bool
adamc@1061 72 val ispunct : char -> bool
adamc@1061 73 val isspace : char -> bool
adamc@1061 74 val isupper : char -> bool
adamc@1061 75 val isxdigit : char -> bool
adamc@1061 76 val tolower : char -> char
adamc@1061 77 val toupper : char -> char
adamc@1128 78 val ord : char -> int
adamc@1128 79 val chr : int -> char
adamc@1061 80
adamc@283 81 (** String operations *)
adamc@283 82
adamc@828 83 val strlen : string -> int
adam@1388 84 val strlenGe : string -> int -> bool
adamc@283 85 val strcat : string -> string -> string
adamc@821 86 val strsub : string -> int -> char
adamc@821 87 val strsuffix : string -> int -> string
adamc@829 88 val strchr : string -> char -> option string
adamc@829 89 val strindex : string -> char -> option int
adam@1390 90 val strsindex : string -> string -> option int
adamc@1272 91 val strcspn : string -> string -> int
adamc@829 92 val substring : string -> int -> int -> string
adamc@1023 93 val str1 : char -> string
adamc@283 94
adamc@286 95 class show
adamc@286 96 val show : t ::: Type -> show t -> t -> string
adamc@286 97 val show_int : show int
adamc@286 98 val show_float : show float
adamc@286 99 val show_string : show string
adamc@821 100 val show_char : show char
adamc@286 101 val show_bool : show bool
adamc@436 102 val show_time : show time
adamc@452 103 val mkShow : t ::: Type -> (t -> string) -> show t
adamc@286 104
adamc@290 105 class read
adamc@290 106 val read : t ::: Type -> read t -> string -> option t
adamc@292 107 val readError : t ::: Type -> read t -> string -> t
adamc@292 108 (* [readError] calls [error] if the input is malformed. *)
adamc@290 109 val read_int : read int
adamc@290 110 val read_float : read float
adamc@290 111 val read_string : read string
adamc@821 112 val read_char : read char
adamc@290 113 val read_bool : read bool
adamc@436 114 val read_time : read time
adamc@777 115 val mkRead : t ::: Type -> (string -> t) -> (string -> option t) -> read t
adamc@288 116
adamc@283 117
adamc@564 118 (** * Monads *)
adamc@564 119
adamc@711 120 class monad :: (Type -> Type) -> Type
adamc@564 121 val return : m ::: (Type -> Type) -> t ::: Type
adamc@564 122 -> monad m
adamc@564 123 -> t -> m t
adamc@564 124 val bind : m ::: (Type -> Type) -> t1 ::: Type -> t2 ::: Type
adamc@564 125 -> monad m
adamc@564 126 -> m t1 -> (t1 -> m t2)
adamc@564 127 -> m t2
adamc@564 128
adam@1544 129 val mkMonad : m ::: (Type -> Type)
adam@1544 130 -> {Return : t ::: Type -> t -> m t,
adam@1544 131 Bind : t1 ::: Type -> t2 ::: Type -> m t1 -> (t1 -> m t2) -> m t2}
adam@1544 132 -> monad m
adam@1544 133
adamc@456 134 con transaction :: Type -> Type
adamc@564 135 val transaction_monad : monad transaction
adamc@456 136
adamc@565 137 con source :: Type -> Type
adamc@565 138 val source : t ::: Type -> t -> transaction (source t)
adamc@575 139 val set : t ::: Type -> source t -> t -> transaction unit
adamc@601 140 val get : t ::: Type -> source t -> transaction t
adamc@565 141
adamc@565 142 con signal :: Type -> Type
adamc@565 143 val signal_monad : monad signal
adamc@565 144 val signal : t ::: Type -> source t -> signal t
adamc@841 145 val current : t ::: Type -> signal t -> transaction t
adamc@456 146
adamc@456 147
adam@1571 148 (** * Floats *)
adam@1571 149
adam@1571 150 val float : int -> float
adam@1571 151 val ceil : float -> int
adam@1571 152 val trunc : float -> int
adam@1571 153 val round : float -> int
adam@1571 154
adam@1571 155
adamc@1006 156 (** * Time *)
adamc@1006 157
adamc@1006 158 val now : transaction time
adamc@1050 159 val minTime : time
adam@1369 160 val addSeconds : time -> int -> time
adam@1514 161 val toSeconds : time -> int
adam@1514 162 val diffInSeconds : time -> time -> int
adam@1514 163 (* Earlier time first *)
adam@1685 164 val toMilliseconds : time -> int
adam@1685 165 val diffInMilliseconds : time -> time -> int
adam@1359 166 val timef : string -> time -> string (* Uses strftime() format string *)
adam@1372 167 val readUtc : string -> option time
adamc@1006 168
adamc@1006 169
adam@1360 170 (** * Encryption *)
adam@1360 171
adam@1360 172 val crypt : string -> string -> string
adam@1360 173
adam@1360 174
adamc@456 175 (** HTTP operations *)
adamc@456 176
adamc@459 177 con http_cookie :: Type -> Type
adamc@459 178 val getCookie : t ::: Type -> http_cookie t -> transaction (option t)
adamc@1050 179 val setCookie : t ::: Type -> http_cookie t -> {Value : t,
adamc@1050 180 Expires : option time,
adamc@1050 181 Secure : bool} -> transaction unit
adamc@1050 182 val clearCookie : t ::: Type -> http_cookie t -> transaction unit
adamc@459 183
adam@1465 184 type requestHeader
adam@1465 185 val blessRequestHeader : string -> requestHeader
adam@1465 186 val checkRequestHeader : string -> option requestHeader
adam@1465 187 val getHeader : requestHeader -> transaction (option string)
adam@1465 188
adam@1465 189 type responseHeader
adam@1465 190 val blessResponseHeader : string -> responseHeader
adam@1465 191 val checkResponseHeader : string -> option responseHeader
adam@1465 192 val setHeader : responseHeader -> string -> transaction unit
adam@1465 193
adam@1799 194 type envVar
adam@1799 195 val blessEnvVar : string -> envVar
adam@1799 196 val checkEnvVar : string -> option envVar
adam@1799 197 val getenv : envVar -> transaction (option string)
adam@1799 198
adamc@456 199
adamc@566 200 (** JavaScript-y gadgets *)
adamc@566 201
adamc@566 202 val alert : string -> transaction unit
adam@1290 203 val confirm : string -> transaction bool
adamc@694 204 val spawn : transaction unit -> transaction unit
adamc@695 205 val sleep : int -> transaction unit
adamc@566 206
adamc@908 207 val rpc : t ::: Type -> transaction t -> transaction t
adamc@908 208
adamc@566 209
adamc@678 210 (** Channels *)
adamc@678 211
adamc@678 212 con channel :: Type -> Type
adamc@678 213 val channel : t ::: Type -> transaction (channel t)
adamc@678 214 val send : t ::: Type -> channel t -> t -> transaction unit
adamc@678 215 val recv : t ::: Type -> channel t -> transaction t
adamc@678 216
adamc@682 217 type client
adamc@682 218 val self : transaction client
adamc@682 219
adamc@678 220
adamc@203 221 (** SQL *)
adamc@203 222
adamc@705 223 con sql_table :: {Type} -> {{Unit}} -> Type
adamc@753 224 con sql_view :: {Type} -> Type
adamc@753 225
adamc@753 226 class fieldsOf :: Type -> {Type} -> Type
adamc@753 227 val fieldsOf_table : fs ::: {Type} -> keys ::: {{Unit}}
adamc@753 228 -> fieldsOf (sql_table fs keys) fs
adamc@753 229 val fieldsOf_view : fs ::: {Type}
adamc@753 230 -> fieldsOf (sql_view fs) fs
adamc@203 231
adamc@704 232 (*** Constraints *)
adamc@704 233
adamc@707 234 (**** Primary keys *)
adamc@707 235
adamc@707 236 class sql_injectable_prim
adamc@707 237 val sql_bool : sql_injectable_prim bool
adamc@707 238 val sql_int : sql_injectable_prim int
adamc@707 239 val sql_float : sql_injectable_prim float
adamc@707 240 val sql_string : sql_injectable_prim string
adamc@1011 241 val sql_char : sql_injectable_prim char
adamc@707 242 val sql_time : sql_injectable_prim time
adamc@737 243 val sql_blob : sql_injectable_prim blob
adamc@707 244 val sql_channel : t ::: Type -> sql_injectable_prim (channel t)
adamc@707 245 val sql_client : sql_injectable_prim client
adamc@707 246
adamc@1104 247 con serialized :: Type -> Type
adamc@1104 248 val serialize : t ::: Type -> t -> serialized t
adamc@1104 249 val deserialize : t ::: Type -> serialized t -> t
adamc@1104 250 val sql_serialized : t ::: Type -> sql_injectable_prim (serialized t)
adamc@1104 251
adamc@707 252 con primary_key :: {Type} -> {{Unit}} -> Type
adamc@707 253 val no_primary_key : fs ::: {Type} -> primary_key fs []
adamc@707 254 val primary_key : rest ::: {Type} -> t ::: Type -> key1 :: Name -> keys :: {Type}
adamc@707 255 -> [[key1] ~ keys] => [[key1 = t] ++ keys ~ rest]
adamc@707 256 => $([key1 = sql_injectable_prim t] ++ map sql_injectable_prim keys)
adamc@707 257 -> primary_key ([key1 = t] ++ keys ++ rest)
adamc@707 258 [Pkey = [key1] ++ map (fn _ => ()) keys]
adamc@707 259
adamc@707 260 (**** Other constraints *)
adamc@707 261
adamc@705 262 con sql_constraints :: {Type} -> {{Unit}} -> Type
adamc@705 263 (* Arguments: column types, uniqueness implications of constraints *)
adamc@704 264
adamc@705 265 con sql_constraint :: {Type} -> {Unit} -> Type
adamc@704 266
adamc@705 267 val no_constraint : fs ::: {Type} -> sql_constraints fs []
adamc@705 268 val one_constraint : fs ::: {Type} -> unique ::: {Unit} -> name :: Name
adamc@705 269 -> sql_constraint fs unique
adamc@705 270 -> sql_constraints fs [name = unique]
adamc@705 271 val join_constraints : fs ::: {Type}
adamc@705 272 -> uniques1 ::: {{Unit}} -> uniques2 ::: {{Unit}} -> [uniques1 ~ uniques2]
adamc@705 273 => sql_constraints fs uniques1 -> sql_constraints fs uniques2
adamc@705 274 -> sql_constraints fs (uniques1 ++ uniques2)
adamc@705 275
adamc@709 276
adamc@705 277 val unique : rest ::: {Type} -> t ::: Type -> unique1 :: Name -> unique :: {Type}
adamc@705 278 -> [[unique1] ~ unique] => [[unique1 = t] ++ unique ~ rest]
adamc@705 279 => sql_constraint ([unique1 = t] ++ unique ++ rest) ([unique1] ++ map (fn _ => ()) unique)
adamc@704 280
adamc@712 281 class linkable :: Type -> Type -> Type
adamc@712 282 val linkable_same : t ::: Type -> linkable t t
adamc@712 283 val linkable_from_nullable : t ::: Type -> linkable (option t) t
adamc@712 284 val linkable_to_nullable : t ::: Type -> linkable t (option t)
adamc@712 285
adamc@709 286 con matching :: {Type} -> {Type} -> Type
adamc@709 287 val mat_nil : matching [] []
adamc@712 288 val mat_cons : t1 ::: Type -> rest1 ::: {Type} -> t2 ::: Type -> rest2 ::: {Type}
adamc@709 289 -> nm1 :: Name -> nm2 :: Name
adamc@709 290 -> [[nm1] ~ rest1] => [[nm2] ~ rest2]
adamc@712 291 => linkable t1 t2
adamc@712 292 -> matching rest1 rest2
adamc@712 293 -> matching ([nm1 = t1] ++ rest1) ([nm2 = t2] ++ rest2)
adamc@709 294
adamc@709 295 con propagation_mode :: {Type} -> Type
adamc@709 296 val restrict : fs ::: {Type} -> propagation_mode fs
adamc@709 297 val cascade : fs ::: {Type} -> propagation_mode fs
adamc@709 298 val no_action : fs ::: {Type} -> propagation_mode fs
adamc@709 299 val set_null : fs ::: {Type} -> propagation_mode (map option fs)
adamc@709 300
adamc@709 301
adamc@709 302 val foreign_key : mine1 ::: Name -> t ::: Type -> mine ::: {Type} -> munused ::: {Type}
adamc@709 303 -> foreign ::: {Type} -> funused ::: {Type}
adamc@709 304 -> nm ::: Name -> uniques ::: {{Unit}}
adamc@709 305 -> [[mine1] ~ mine] => [[mine1 = t] ++ mine ~ munused]
adamc@709 306 => [foreign ~ funused] => [[nm] ~ uniques]
adamc@709 307 => matching ([mine1 = t] ++ mine) foreign
adamc@709 308 -> sql_table (foreign ++ funused) ([nm = map (fn _ => ()) foreign] ++ uniques)
adamc@709 309 -> {OnDelete : propagation_mode ([mine1 = t] ++ mine),
adamc@709 310 OnUpdate : propagation_mode ([mine1 = t] ++ mine)}
adamc@709 311 -> sql_constraint ([mine1 = t] ++ mine ++ munused) []
adamc@709 312
adam@1778 313 con sql_exp :: {{Type}} -> {{Type}} -> {Type} -> Type -> Type
adam@1778 314 val sql_exp_weaken : fs ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adamc@1072 315 -> fs' ::: {{Type}} -> agg' ::: {{Type}} -> exps' ::: {Type}
adamc@1072 316 -> [fs ~ fs'] => [agg ~ agg'] => [exps ~ exps'] =>
adam@1778 317 sql_exp fs agg exps t
adam@1778 318 -> sql_exp (fs ++ fs') (agg ++ agg') (exps ++ exps') t
adamc@714 319
adamc@714 320 val check : fs ::: {Type}
adam@1778 321 -> sql_exp [] [] fs bool
adamc@714 322 -> sql_constraint fs []
adamc@714 323
adamc@714 324
adamc@204 325 (*** Queries *)
adamc@204 326
adam@1394 327 con sql_query :: {{Type}} -> {{Type}} -> {{Type}} -> {Type} -> Type
adam@1394 328 con sql_query1 :: {{Type}} -> {{Type}} -> {{Type}} -> {{Type}} -> {Type} -> Type
adamc@204 329
adamc@223 330 con sql_subset :: {{Type}} -> {{Type}} -> Type
adamc@223 331 val sql_subset : keep_drop :: {({Type} * {Type})}
adamc@354 332 -> sql_subset
adamc@621 333 (map (fn fields :: ({Type} * {Type}) => fields.1 ++ fields.2) keep_drop)
adamc@621 334 (map (fn fields :: ({Type} * {Type}) => fields.1) keep_drop)
adamc@354 335 val sql_subset_all : tables :: {{Type}} -> sql_subset tables tables
adamc@1072 336 val sql_subset_concat : big1 ::: {{Type}} -> little1 ::: {{Type}}
adamc@1072 337 -> big2 ::: {{Type}} -> little2 ::: {{Type}}
adamc@1072 338 -> [big1 ~ big2] => [little1 ~ little2] =>
adamc@1072 339 sql_subset big1 little1
adamc@1072 340 -> sql_subset big2 little2
adamc@1072 341 -> sql_subset (big1 ++ big2) (little1 ++ little2)
adamc@223 342
adamc@1191 343 con sql_from_items :: {{Type}} -> {{Type}} -> Type
adamc@748 344
adamc@1195 345 val sql_from_nil : free ::: {{Type}} -> sql_from_items free []
adamc@1191 346 val sql_from_table : free ::: {{Type}} -> t ::: Type -> fs ::: {Type}
adamc@753 347 -> fieldsOf t fs -> name :: Name
adamc@1191 348 -> t -> sql_from_items free [name = fs]
adamc@1192 349 val sql_from_query : free ::: {{Type}} -> fs ::: {Type} -> name :: Name
adam@1394 350 -> sql_query free [] [] fs
adamc@1192 351 -> sql_from_items free [name = fs]
adamc@1191 352 val sql_from_comma : free ::: {{Type}} -> tabs1 ::: {{Type}} -> tabs2 ::: {{Type}}
adamc@748 353 -> [tabs1 ~ tabs2]
adamc@1191 354 => sql_from_items free tabs1 -> sql_from_items free tabs2
adamc@1191 355 -> sql_from_items free (tabs1 ++ tabs2)
adamc@1191 356 val sql_inner_join : free ::: {{Type}} -> tabs1 ::: {{Type}} -> tabs2 ::: {{Type}}
adamc@1191 357 -> [free ~ tabs1] => [free ~ tabs2] => [tabs1 ~ tabs2]
adamc@1191 358 => sql_from_items free tabs1 -> sql_from_items free tabs2
adam@1778 359 -> sql_exp (free ++ tabs1 ++ tabs2) [] [] bool
adamc@1191 360 -> sql_from_items free (tabs1 ++ tabs2)
adamc@748 361
adamc@750 362 class nullify :: Type -> Type -> Type
adamc@750 363 val nullify_option : t ::: Type -> nullify (option t) (option t)
adamc@750 364 val nullify_prim : t ::: Type -> sql_injectable_prim t -> nullify t (option t)
adamc@750 365
adamc@1191 366 val sql_left_join : free ::: {{Type}} -> tabs1 ::: {{Type}} -> tabs2 ::: {{(Type * Type)}}
adamc@1191 367 -> [free ~ tabs1] => [free ~ tabs2] => [tabs1 ~ tabs2]
adamc@750 368 => $(map (fn r => $(map (fn p :: (Type * Type) => nullify p.1 p.2) r)) tabs2)
adamc@1191 369 -> sql_from_items free tabs1 -> sql_from_items free (map (map (fn p :: (Type * Type) => p.1)) tabs2)
adam@1778 370 -> sql_exp (free ++ tabs1 ++ map (map (fn p :: (Type * Type) => p.1)) tabs2) [] [] bool
adamc@1191 371 -> sql_from_items free (tabs1 ++ map (map (fn p :: (Type * Type) => p.2)) tabs2)
adamc@750 372
adamc@1191 373 val sql_right_join : free ::: {{Type}} -> tabs1 ::: {{(Type * Type)}} -> tabs2 ::: {{Type}}
adamc@1191 374 -> [free ~ tabs1] => [free ~ tabs2] => [tabs1 ~ tabs2]
adamc@751 375 => $(map (fn r => $(map (fn p :: (Type * Type) => nullify p.1 p.2) r)) tabs1)
adamc@1191 376 -> sql_from_items free (map (map (fn p :: (Type * Type) => p.1)) tabs1) -> sql_from_items free tabs2
adam@1778 377 -> sql_exp (free ++ map (map (fn p :: (Type * Type) => p.1)) tabs1 ++ tabs2) [] [] bool
adamc@1191 378 -> sql_from_items free (map (map (fn p :: (Type * Type) => p.2)) tabs1 ++ tabs2)
adamc@751 379
adamc@1191 380 val sql_full_join : free ::: {{Type}} -> tabs1 ::: {{(Type * Type)}} -> tabs2 ::: {{(Type * Type)}}
adamc@1191 381 -> [free ~ tabs1] => [free ~ tabs2] => [tabs1 ~ tabs2]
adamc@751 382 => $(map (fn r => $(map (fn p :: (Type * Type) => nullify p.1 p.2) r)) (tabs1 ++ tabs2))
adamc@1191 383 -> sql_from_items free (map (map (fn p :: (Type * Type) => p.1)) tabs1)
adamc@1191 384 -> sql_from_items free (map (map (fn p :: (Type * Type) => p.1)) tabs2)
adam@1778 385 -> sql_exp (free ++ map (map (fn p :: (Type * Type) => p.1)) (tabs1 ++ tabs2)) [] [] bool
adamc@1191 386 -> sql_from_items free (map (map (fn p :: (Type * Type) => p.2)) (tabs1 ++ tabs2))
adamc@751 387
adam@1778 388 (** [ORDER BY] and [SELECT] expressions may use window functions, so we introduce a type family for such expressions. *)
adam@1778 389 con sql_expw :: {{Type}} -> {{Type}} -> {Type} -> Type -> Type
adam@1778 390
adamc@1191 391 val sql_query1 : free ::: {{Type}}
adam@1394 392 -> afree ::: {{Type}}
adamc@1191 393 -> tables ::: {{Type}}
adamc@354 394 -> grouped ::: {{Type}}
adamc@354 395 -> selectedFields ::: {{Type}}
adamc@354 396 -> selectedExps ::: {Type}
adamc@1070 397 -> empties :: {Unit}
adamc@1191 398 -> [free ~ tables]
adamc@1191 399 => [free ~ grouped]
adam@1394 400 => [afree ~ tables]
adamc@1191 401 => [empties ~ selectedFields]
adamc@1070 402 => {Distinct : bool,
adamc@1191 403 From : sql_from_items free tables,
adam@1778 404 Where : sql_exp (free ++ tables) afree [] bool,
adamc@748 405 GroupBy : sql_subset tables grouped,
adam@1778 406 Having : sql_exp (free ++ grouped) (afree ++ tables) [] bool,
adamc@1070 407 SelectFields : sql_subset grouped (map (fn _ => []) empties ++ selectedFields),
adam@1778 408 SelectExps : $(map (sql_expw (free ++ grouped) (afree ++ tables) [])
adamc@705 409 selectedExps) }
adam@1394 410 -> sql_query1 free afree tables selectedFields selectedExps
adamc@229 411
adam@1682 412 type sql_relop
adamc@229 413 val sql_union : sql_relop
adamc@229 414 val sql_intersect : sql_relop
adamc@229 415 val sql_except : sql_relop
adamc@1191 416 val sql_relop : free ::: {{Type}}
adam@1394 417 -> afree ::: {{Type}}
adamc@1191 418 -> tables1 ::: {{Type}}
adamc@354 419 -> tables2 ::: {{Type}}
adamc@354 420 -> selectedFields ::: {{Type}}
adamc@354 421 -> selectedExps ::: {Type}
adamc@354 422 -> sql_relop
adam@1427 423 -> bool (* ALL *)
adam@1394 424 -> sql_query1 free afree tables1 selectedFields selectedExps
adam@1394 425 -> sql_query1 free afree tables2 selectedFields selectedExps
adam@1394 426 -> sql_query1 free afree [] selectedFields selectedExps
adam@1394 427 val sql_forget_tables : free ::: {{Type}} -> afree ::: {{Type}} -> tables ::: {{Type}} -> selectedFields ::: {{Type}} -> selectedExps ::: {Type}
adam@1394 428 -> sql_query1 free afree tables selectedFields selectedExps
adam@1394 429 -> sql_query1 free afree [] selectedFields selectedExps
adamc@229 430
adamc@230 431 type sql_direction
adamc@230 432 val sql_asc : sql_direction
adamc@230 433 val sql_desc : sql_direction
adamc@230 434
adam@1778 435 (** This type class supports automatic injection of either regular or window expressions into [sql_expw]. *)
adam@1778 436 class sql_window :: ({{Type}} -> {{Type}} -> {Type} -> Type -> Type) -> Type
adam@1778 437 val sql_window_normal : sql_window sql_exp
adam@1778 438 val sql_window_fancy : sql_window sql_expw
adam@1778 439 val sql_window : tf ::: ({{Type}} -> {{Type}} -> {Type} -> Type -> Type)
adam@1778 440 -> tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adam@1778 441 -> sql_window tf
adam@1778 442 -> tf tables agg exps t
adam@1778 443 -> sql_expw tables agg exps t
adam@1778 444
adamc@234 445 con sql_order_by :: {{Type}} -> {Type} -> Type
adamc@234 446 val sql_order_by_Nil : tables ::: {{Type}} -> exps :: {Type} -> sql_order_by tables exps
adam@1778 447 val sql_order_by_Cons : tf ::: ({{Type}} -> {{Type}} -> {Type} -> Type -> Type) -> tables ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adam@1778 448 -> sql_window tf
adam@1778 449 -> tf tables [] exps t -> sql_direction
adamc@354 450 -> sql_order_by tables exps
adamc@354 451 -> sql_order_by tables exps
adam@1682 452 val sql_order_by_random : tables ::: {{Type}} -> exps ::: {Type}
adam@1682 453 -> sql_order_by tables exps
adamc@230 454
adamc@231 455 type sql_limit
adamc@231 456 val sql_no_limit : sql_limit
adamc@231 457 val sql_limit : int -> sql_limit
adam@1682 458
adamc@232 459 type sql_offset
adamc@232 460 val sql_no_offset : sql_offset
adamc@232 461 val sql_offset : int -> sql_offset
adamc@232 462
adamc@1191 463 val sql_query : free ::: {{Type}}
adam@1394 464 -> afree ::: {{Type}}
adamc@1191 465 -> tables ::: {{Type}}
adamc@354 466 -> selectedFields ::: {{Type}}
adamc@354 467 -> selectedExps ::: {Type}
adamc@1191 468 -> [free ~ tables]
adam@1394 469 => {Rows : sql_query1 free afree tables selectedFields selectedExps,
adamc@1191 470 OrderBy : sql_order_by (free ++ tables) selectedExps,
adamc@354 471 Limit : sql_limit,
adamc@354 472 Offset : sql_offset}
adam@1394 473 -> sql_query free afree selectedFields selectedExps
adamc@204 474
adamc@354 475 val sql_field : otherTabs ::: {{Type}} -> otherFields ::: {Type}
adam@1778 476 -> fieldType ::: Type -> agg ::: {{Type}}
adamc@354 477 -> exps ::: {Type}
adamc@354 478 -> tab :: Name -> field :: Name
adamc@354 479 -> sql_exp
adamc@354 480 ([tab = [field = fieldType] ++ otherFields] ++ otherTabs)
adam@1778 481 agg exps fieldType
adamc@234 482
adam@1778 483 val sql_exp : tabs ::: {{Type}} -> agg ::: {{Type}} -> t ::: Type -> rest ::: {Type}
adamc@354 484 -> nm :: Name
adam@1778 485 -> sql_exp tabs agg ([nm = t] ++ rest) t
adamc@209 486
adamc@221 487 class sql_injectable
adamc@676 488 val sql_prim : t ::: Type -> sql_injectable_prim t -> sql_injectable t
adamc@676 489 val sql_option_prim : t ::: Type -> sql_injectable_prim t -> sql_injectable (option t)
adamc@676 490
adamc@354 491 val sql_inject : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 492 -> t ::: Type
adam@1778 493 -> sql_injectable t -> t -> sql_exp tables agg exps t
adamc@209 494
adamc@470 495 val sql_is_null : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 496 -> t ::: Type
adam@1778 497 -> sql_exp tables agg exps (option t)
adam@1778 498 -> sql_exp tables agg exps bool
adamc@470 499
adam@1602 500 val sql_coalesce : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 501 -> t ::: Type
adam@1778 502 -> sql_exp tables agg exps (option t)
adam@1778 503 -> sql_exp tables agg exps t
adam@1778 504 -> sql_exp tables agg exps t
adam@1602 505
kkallio@1572 506 val sql_if_then_else : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 507 -> t ::: Type
adam@1778 508 -> sql_exp tables agg exps bool
adam@1778 509 -> sql_exp tables agg exps t
adam@1778 510 -> sql_exp tables agg exps t
adam@1778 511 -> sql_exp tables agg exps t
kkallio@1572 512
adamc@559 513 class sql_arith
adam@1427 514 val sql_arith_int : sql_arith int
adam@1427 515 val sql_arith_float : sql_arith float
adam@1427 516 val sql_arith_option : t ::: Type -> sql_arith t -> sql_arith (option t)
adamc@559 517
adamc@220 518 con sql_unary :: Type -> Type -> Type
adamc@220 519 val sql_not : sql_unary bool bool
adamc@354 520 val sql_unary : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 521 -> arg ::: Type -> res ::: Type
adam@1778 522 -> sql_unary arg res -> sql_exp tables agg exps arg
adam@1778 523 -> sql_exp tables agg exps res
adamc@220 524
adamc@559 525 val sql_neg : t ::: Type -> sql_arith t -> sql_unary t t
adamc@559 526
adamc@220 527 con sql_binary :: Type -> Type -> Type -> Type
adamc@220 528 val sql_and : sql_binary bool bool bool
adamc@220 529 val sql_or : sql_binary bool bool bool
adamc@234 530 val sql_binary : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 531 -> arg1 ::: Type -> arg2 ::: Type -> res ::: Type
adam@1778 532 -> sql_binary arg1 arg2 res -> sql_exp tables agg exps arg1
adam@1778 533 -> sql_exp tables agg exps arg2
adam@1778 534 -> sql_exp tables agg exps res
adamc@220 535
adamc@559 536 val sql_plus : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 537 val sql_minus : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 538 val sql_times : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 539 val sql_div : t ::: Type -> sql_arith t -> sql_binary t t t
adamc@559 540 val sql_mod : sql_binary int int int
adamc@559 541
adamc@559 542 val sql_eq : t ::: Type -> sql_binary t t bool
adamc@559 543 val sql_ne : t ::: Type -> sql_binary t t bool
adamc@559 544 val sql_lt : t ::: Type -> sql_binary t t bool
adamc@559 545 val sql_le : t ::: Type -> sql_binary t t bool
adamc@559 546 val sql_gt : t ::: Type -> sql_binary t t bool
adamc@559 547 val sql_ge : t ::: Type -> sql_binary t t bool
adamc@203 548
kkallio@1607 549 val sql_like : sql_binary string string bool
kkallio@1607 550
adam@1778 551 val sql_count : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 552 -> sql_exp tables agg exps int
adamc@235 553
adamc@1187 554 con sql_aggregate :: Type -> Type -> Type
adamc@354 555 val sql_aggregate : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 556 -> dom ::: Type -> ran ::: Type
adam@1778 557 -> sql_aggregate dom ran -> sql_exp agg agg exps dom
adam@1778 558 -> sql_exp tables agg exps ran
adamc@1187 559
adamc@1187 560 val sql_count_col : t ::: Type -> sql_aggregate (option t) int
adamc@236 561
adamc@236 562 class sql_summable
adamc@236 563 val sql_summable_int : sql_summable int
adamc@236 564 val sql_summable_float : sql_summable float
adam@1357 565 val sql_summable_option : t ::: Type -> sql_summable t -> sql_summable (option t)
adam@1777 566 val sql_avg : t ::: Type -> sql_summable t -> sql_aggregate t (option float)
adam@1394 567 val sql_sum : t ::: Type -> nt ::: Type -> sql_summable t -> nullify t nt -> sql_aggregate t nt
adamc@236 568
adamc@236 569 class sql_maxable
adamc@236 570 val sql_maxable_int : sql_maxable int
adamc@236 571 val sql_maxable_float : sql_maxable float
adamc@236 572 val sql_maxable_string : sql_maxable string
adamc@437 573 val sql_maxable_time : sql_maxable time
adam@1357 574 val sql_maxable_option : t ::: Type -> sql_maxable t -> sql_maxable (option t)
adam@1394 575 val sql_max : t ::: Type -> nt ::: Type -> sql_maxable t -> nullify t nt -> sql_aggregate t nt
adam@1394 576 val sql_min : t ::: Type -> nt ::: Type -> sql_maxable t -> nullify t nt -> sql_aggregate t nt
adamc@236 577
adamc@441 578 con sql_nfunc :: Type -> Type
adamc@441 579 val sql_nfunc : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 580 -> t ::: Type
adam@1778 581 -> sql_nfunc t -> sql_exp tables agg exps t
adamc@441 582 val sql_current_timestamp : sql_nfunc time
adamc@441 583
adamc@746 584 con sql_ufunc :: Type -> Type -> Type
adamc@746 585 val sql_ufunc : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 586 -> dom ::: Type -> ran ::: Type
adam@1778 587 -> sql_ufunc dom ran -> sql_exp tables agg exps dom
adam@1778 588 -> sql_exp tables agg exps ran
adamc@746 589 val sql_octet_length : sql_ufunc blob int
adamc@1207 590 val sql_known : t ::: Type -> sql_ufunc t bool
adam@1636 591 val sql_lower : sql_ufunc string string
adam@1636 592 val sql_upper : sql_ufunc string string
adamc@235 593
adam@1778 594 val sql_nullable : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adamc@1081 595 -> sql_injectable_prim t
adam@1778 596 -> sql_exp tables agg exps t
adam@1778 597 -> sql_exp tables agg exps (option t)
adamc@1081 598
adam@1778 599 val sql_subquery : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type} -> nm ::: Name -> t ::: Type -> nt ::: Type
adam@1421 600 -> nullify t nt
adam@1394 601 -> sql_query tables agg [] [nm = t]
adam@1778 602 -> sql_exp tables agg exps nt
adam@1778 603
adam@1778 604 (** Window function expressions *)
adam@1778 605
adam@1778 606 con sql_partition :: {{Type}} -> {{Type}} -> {Type} -> Type
adam@1778 607 val sql_no_partition : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 608 -> sql_partition tables agg exps
adam@1778 609 val sql_partition : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type} -> t ::: Type
adam@1778 610 -> sql_exp tables agg exps t
adam@1778 611 -> sql_partition tables agg exps
adam@1778 612
adam@1778 613 con sql_window_function :: {{Type}} -> {{Type}} -> {Type} -> Type -> Type
adam@1778 614 val sql_window_function : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 615 -> t ::: Type
adam@1778 616 -> sql_window_function tables agg exps t
adam@1778 617 -> sql_partition tables agg exps
adam@1778 618 -> sql_order_by tables exps
adam@1778 619 -> sql_expw tables agg exps t
adam@1778 620
adam@1778 621 val sql_window_aggregate : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 622 -> t ::: Type -> nt ::: Type
adam@1778 623 -> sql_aggregate t nt
adam@1778 624 -> sql_exp tables agg exps t
adam@1778 625 -> sql_window_function tables agg exps nt
adam@1778 626 val sql_window_count : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 627 -> sql_window_function tables agg exps int
adam@1778 628 val sql_rank : tables ::: {{Type}} -> agg ::: {{Type}} -> exps ::: {Type}
adam@1778 629 -> sql_window_function tables agg exps int
adam@1778 630
adamc@1191 631
adamc@243 632 (*** Executing queries *)
adamc@243 633
adamc@354 634 val query : tables ::: {{Type}} -> exps ::: {Type}
adamc@629 635 -> [tables ~ exps] =>
adamc@354 636 state ::: Type
adam@1394 637 -> sql_query [] [] tables exps
adamc@621 638 -> ($(exps ++ map (fn fields :: {Type} => $fields) tables)
adamc@354 639 -> state
adamc@354 640 -> transaction state)
adamc@354 641 -> state
adamc@354 642 -> transaction state
adamc@243 643
adam@1810 644 val show_sql_query : freeTables ::: {{Type}} -> freeAggs ::: {{Type}} -> tables ::: {{Type}} -> exps ::: {Type}
adam@1810 645 -> show (sql_query freeTables freeAggs tables exps)
adam@1810 646
adamc@243 647
adamc@299 648 (*** Database mutators *)
adamc@299 649
adamc@299 650 type dml
adamc@299 651 val dml : dml -> transaction unit
adam@1293 652 val tryDml : dml -> transaction (option string)
adam@1293 653 (* Returns an error message on failure. *)
adamc@299 654
adamc@705 655 val insert : fields ::: {Type} -> uniques ::: {{Unit}}
adamc@705 656 -> sql_table fields uniques
adam@1778 657 -> $(map (fn t :: Type => sql_exp [] [] [] t) fields)
adamc@354 658 -> dml
adamc@299 659
adamc@705 660 val update : unchanged ::: {Type} -> uniques ::: {{Unit}} -> changed :: {Type} ->
adamc@629 661 [changed ~ unchanged] =>
adam@1778 662 $(map (fn t :: Type => sql_exp [T = changed ++ unchanged] [] [] t) changed)
adamc@705 663 -> sql_table (changed ++ unchanged) uniques
adam@1778 664 -> sql_exp [T = changed ++ unchanged] [] [] bool
adamc@354 665 -> dml
adamc@299 666
adamc@705 667 val delete : fields ::: {Type} -> uniques ::: {{Unit}}
adamc@705 668 -> sql_table fields uniques
adam@1778 669 -> sql_exp [T = fields] [] [] bool
adamc@354 670 -> dml
adamc@299 671
adamc@338 672 (*** Sequences *)
adamc@338 673
adamc@338 674 type sql_sequence
adamc@338 675 val nextval : sql_sequence -> transaction int
adamc@1073 676 val setval : sql_sequence -> int -> transaction unit
adamc@338 677
adamc@299 678
adamc@203 679 (** XML *)
adamc@203 680
adamc@721 681 type css_class
adam@1477 682 val show_css_class : show css_class
adam@1567 683 val null : css_class
adam@1567 684 (* No special formatting *)
adam@1292 685 val classes : css_class -> css_class -> css_class
adam@1292 686 (* The equivalent of writing one class after the other, separated by a space, in
adam@1292 687 * an HTML 'class' attribute *)
adamc@718 688
adam@1750 689 type css_value
adam@1750 690 val atom : string -> css_value
adam@1750 691 type url
adam@1750 692 val css_url : url -> css_value
adam@1750 693 type css_property
adam@1750 694 val property : string -> css_property
adam@1750 695 val value : css_property -> css_value -> css_property
adam@1750 696 type css_style
adam@1750 697 val noStyle : css_style
adam@1750 698 val oneProperty : css_style -> css_property -> css_style
adam@1750 699
adamc@720 700 con tag :: {Type} -> {Unit} -> {Unit} -> {Type} -> {Type} -> Type
adamc@91 701
adamc@720 702 con xml :: {Unit} -> {Type} -> {Type} -> Type
adamc@720 703 val cdata : ctx ::: {Unit} -> use ::: {Type} -> string -> xml ctx use []
adam@1358 704 val cdataChar : ctx ::: {Unit} -> use ::: {Type} -> char -> xml ctx use []
adamc@354 705 val tag : attrsGiven ::: {Type} -> attrsAbsent ::: {Type}
adamc@354 706 -> ctxOuter ::: {Unit} -> ctxInner ::: {Unit}
adamc@354 707 -> useOuter ::: {Type} -> useInner ::: {Type}
adamc@354 708 -> bindOuter ::: {Type} -> bindInner ::: {Type}
adamc@629 709 -> [attrsGiven ~ attrsAbsent] =>
adamc@629 710 [useOuter ~ useInner] =>
adamc@629 711 [bindOuter ~ bindInner] =>
adam@1749 712 css_class
adam@1643 713 -> option (signal css_class)
adam@1750 714 -> css_style
adam@1751 715 -> option (signal css_style)
adamc@721 716 -> $attrsGiven
adamc@629 717 -> tag (attrsGiven ++ attrsAbsent)
adamc@720 718 ctxOuter ctxInner useOuter bindOuter
adamc@720 719 -> xml ctxInner useInner bindInner
adamc@720 720 -> xml ctxOuter (useOuter ++ useInner) (bindOuter ++ bindInner)
adam@1682 721 val join : ctx ::: {Unit}
adamc@720 722 -> use1 ::: {Type} -> bind1 ::: {Type} -> bind2 ::: {Type}
adamc@720 723 -> [use1 ~ bind1] => [bind1 ~ bind2] =>
adamc@720 724 xml ctx use1 bind1
adamc@720 725 -> xml ctx (use1 ++ bind1) bind2
adamc@720 726 -> xml ctx use1 (bind1 ++ bind2)
adamc@354 727 val useMore : ctx ::: {Unit} -> use1 ::: {Type} -> use2 ::: {Type}
adamc@720 728 -> bind ::: {Type}
adamc@629 729 -> [use1 ~ use2] =>
adamc@720 730 xml ctx use1 bind
adamc@720 731 -> xml ctx (use1 ++ use2) bind
adamc@91 732
adam@1641 733 con html = [Html]
adam@1641 734 con head = [Head]
adam@1642 735
adam@1642 736 con body' = [MakeForm, Body]
adam@1642 737 con form' = [Body, Form]
adam@1642 738 con subform' = [Body, Subform]
adam@1642 739 con tabl' = [MakeForm, Table]
adam@1642 740 con tr' = [MakeForm, Tr]
adam@1642 741
adam@1642 742 con body = [Dyn] ++ body'
adam@1642 743 con form = [Dyn] ++ form'
adam@1642 744 con subform = [Dyn] ++ subform'
adam@1642 745 con tabl = [Dyn] ++ tabl'
adam@1642 746 con tr = [Dyn] ++ tr'
adam@1641 747
adam@1641 748 con xhtml = xml html
adamc@139 749 con page = xhtml [] []
adam@1641 750 con xbody = xml body [] []
adam@1641 751 con xtable = xml tabl [] []
adam@1641 752 con xtr = xml tr [] []
adam@1641 753 con xform = xml form [] []
adamc@110 754
adamc@718 755
adamc@204 756 (*** HTML details *)
adamc@204 757
adam@1370 758 type queryString
adam@1370 759 val show_queryString : show queryString
adam@1370 760
adamc@1065 761 val show_url : show url
adamc@724 762 val bless : string -> url
adamc@770 763 val checkUrl : string -> option url
adamc@1085 764 val currentUrl : transaction url
adam@1386 765 val currentUrlHasPost : transaction bool
adam@1485 766 val currentUrlHasQueryString : transaction bool
adamc@1065 767 val url : transaction page -> url
adam@1370 768 val effectfulUrl : (option queryString -> transaction page) -> url
adamc@1065 769 val redirect : t ::: Type -> url -> transaction t
adamc@724 770
adam@1556 771 type id
adam@1556 772 val fresh : transaction id
adam@1785 773 val giveFocus : id -> transaction unit
adam@1556 774
adam@1641 775 val dyn : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type} -> [ctx ~ [Dyn]] => unit
adam@1641 776 -> tag [Signal = signal (xml ([Dyn] ++ ctx) use bind)] ([Dyn] ++ ctx) [] use bind
adamc@568 777
adam@1786 778 val active : unit
adam@1786 779 -> tag [Code = transaction xbody] body [] [] []
adam@1786 780
adamc@720 781 val head : unit -> tag [] html head [] []
adamc@720 782 val title : unit -> tag [] head [] [] []
adam@1556 783 val link : unit -> tag [Id = id, Rel = string, Typ = string, Href = url, Media = string] head [] [] []
adamc@110 784
vshabanoff@1709 785 val body : unit -> tag [Onload = transaction unit, Onresize = transaction unit, Onunload = transaction unit, Onhashchange = transaction unit]
adamc@892 786 html body [] []
adamc@354 787 con bodyTag = fn (attrs :: {Type}) =>
adamc@354 788 ctx ::: {Unit} ->
adamc@629 789 [[Body] ~ ctx] =>
adamc@720 790 unit -> tag attrs ([Body] ++ ctx) ([Body] ++ ctx) [] []
adamc@354 791 con bodyTagStandalone = fn (attrs :: {Type}) =>
adamc@354 792 ctx ::: {Unit}
adamc@629 793 -> [[Body] ~ ctx] =>
adamc@720 794 unit -> tag attrs ([Body] ++ ctx) [] [] []
adamc@141 795
adam@1556 796 val br : bodyTagStandalone [Id = id]
adamc@119 797
adamc@892 798 con focusEvents = [Onblur = transaction unit, Onfocus = transaction unit]
adam@1783 799
adam@1783 800 datatype mouseButton = Left | Right | Middle
adam@1783 801
adam@1783 802 type mouseEvent = { ScreenX : int, ScreenY : int, ClientX : int, ClientY : int,
adam@1783 803 CtrlKey : bool, ShiftKey : bool, AltKey : bool, MetaKey : bool,
adam@1783 804 Button : mouseButton }
adam@1783 805
adam@1783 806 con mouseEvents = map (fn _ :: Unit => mouseEvent -> transaction unit)
adam@1783 807 [Onclick, Ondblclick, Onmousedown, Onmousemove, Onmouseout, Onmouseover, Onmouseup]
adam@1783 808
adam@1783 809 type keyEvent = { KeyCode : int,
adam@1783 810 CtrlKey : bool, ShiftKey : bool, AltKey : bool, MetaKey : bool }
adam@1783 811
adam@1783 812 con keyEvents = map (fn _ :: Unit => keyEvent -> transaction unit)
adam@1783 813 [Onkeydown, Onkeypress, Onkeyup]
adam@1783 814
adamc@895 815 (* Key arguments are character codes. *)
adamc@892 816 con resizeEvents = [Onresize = transaction unit]
vshabanoff@1709 817 con scrollEvents = [Onscroll = transaction unit]
adamc@691 818
vshabanoff@1709 819 con boxEvents = focusEvents ++ mouseEvents ++ keyEvents ++ resizeEvents ++ scrollEvents
adamc@892 820 con tableEvents = focusEvents ++ mouseEvents ++ keyEvents
adamc@140 821
adam@1710 822 con boxAttrs = [Id = id, Title = string] ++ boxEvents
adam@1556 823 con tableAttrs = [Id = id, Title = string] ++ tableEvents
adamc@469 824
adamc@1047 825 val span : bodyTag boxAttrs
adamc@1047 826 val div : bodyTag boxAttrs
adamc@140 827
adamc@1047 828 val p : bodyTag boxAttrs
adamc@1047 829 val b : bodyTag boxAttrs
adamc@1047 830 val i : bodyTag boxAttrs
adamc@1047 831 val tt : bodyTag boxAttrs
kkallio@1452 832 val sub : bodyTag boxAttrs
kkallio@1452 833 val sup : bodyTag boxAttrs
adamc@410 834
adamc@1047 835 val h1 : bodyTag boxAttrs
adamc@1047 836 val h2 : bodyTag boxAttrs
adamc@1047 837 val h3 : bodyTag boxAttrs
adamc@1047 838 val h4 : bodyTag boxAttrs
adamc@1047 839 val h5 : bodyTag boxAttrs
adamc@1047 840 val h6 : bodyTag boxAttrs
adamc@717 841
adamc@1047 842 val li : bodyTag boxAttrs
adamc@1047 843 val ol : bodyTag boxAttrs
adamc@1047 844 val ul : bodyTag boxAttrs
adamc@140 845
adamc@1047 846 val hr : bodyTag boxAttrs
adamc@1047 847
vshabanoff@1560 848 val a : bodyTag ([Link = transaction page, Href = url, Target = string] ++ boxAttrs)
adamc@892 849
adam@1419 850 val img : bodyTag ([Alt = string, Src = url, Width = int, Height = int,
adamc@1129 851 Onabort = transaction unit, Onerror = transaction unit,
adamc@1047 852 Onload = transaction unit] ++ boxAttrs)
adam@1682 853
adamc@720 854 val form : ctx ::: {Unit} -> bind ::: {Type}
adam@1642 855 -> [[MakeForm, Form] ~ ctx] =>
adam@1412 856 option css_class
adam@1642 857 -> xml ([Form] ++ ctx) [] bind
adam@1642 858 -> xml ([MakeForm] ++ ctx) [] []
adam@1682 859
adamc@756 860 val subform : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type}
adamc@756 861 -> [[Form] ~ ctx] =>
adamc@756 862 nm :: Name -> [[nm] ~ use] =>
adamc@1004 863 xml ([Form] ++ ctx) [] bind
adamc@756 864 -> xml ([Form] ++ ctx) use [nm = $bind]
adamc@758 865
adamc@758 866 val subforms : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type}
adamc@1004 867 -> [[Form, Subform] ~ ctx] =>
adamc@758 868 nm :: Name -> [[nm] ~ use] =>
adamc@1004 869 xml ([Subform] ++ ctx) [Entry = $bind] []
adamc@758 870 -> xml ([Form] ++ ctx) use [nm = list ($bind)]
adamc@758 871
adamc@758 872 val entry : ctx ::: {Unit} -> bind ::: {Type}
adamc@1004 873 -> [[Subform, Form] ~ ctx] =>
adamc@1004 874 xml ([Form] ++ ctx) [] bind
adamc@758 875 -> xml ([Subform] ++ ctx) [Entry = $bind] []
adamc@758 876
adamc@361 877 con formTag = fn (ty :: Type) (inner :: {Unit}) (attrs :: {Type}) =>
adamc@354 878 ctx ::: {Unit}
adamc@629 879 -> [[Form] ~ ctx] =>
adamc@354 880 nm :: Name -> unit
adamc@720 881 -> tag attrs ([Form] ++ ctx) inner [] [nm = ty]
adamc@1047 882 val hidden : formTag string [] [Id = string, Value = string]
vshabanoff@1709 883 val textbox : formTag string [] ([Value = string, Size = int, Placeholder = string, Source = source string, Onchange = transaction unit,
adamc@1047 884 Ontext = transaction unit] ++ boxAttrs)
adamc@1047 885 val password : formTag string [] ([Value = string, Size = int] ++ boxAttrs)
adamc@892 886 val textarea : formTag string [] ([Rows = int, Cols = int, Onchange = transaction unit,
adamc@1047 887 Ontext = transaction unit] ++ boxAttrs)
adamc@153 888
adamc@1047 889 val checkbox : formTag bool [] ([Checked = bool] ++ boxAttrs)
adamc@190 890
adamc@737 891 type file
adamc@737 892 val fileName : file -> option string
adamc@740 893 val fileMimeType : file -> string
adamc@737 894 val fileData : file -> blob
adamc@737 895
adamc@1047 896 val upload : formTag file [] ([Value = string, Size = int] ++ boxAttrs)
adamc@737 897
adamc@741 898 type mimeType
adamc@741 899 val blessMime : string -> mimeType
adamc@770 900 val checkMime : string -> option mimeType
adamc@741 901 val returnBlob : t ::: Type -> blob -> mimeType -> transaction t
adamc@745 902 val blobSize : blob -> int
adamc@1119 903 val textBlob : string -> blob
adamc@741 904
adam@1347 905 type postBody
adam@1347 906 val postType : postBody -> string
adam@1347 907 val postData : postBody -> string
adam@1347 908
adam@1787 909 type postField
adam@1787 910 val firstFormField : string -> option postField
adam@1787 911 val fieldName : postField -> string
adam@1787 912 val fieldValue : postField -> string
adam@1787 913 val remainingFields : postField -> string
adam@1787 914
adamc@153 915 con radio = [Body, Radio]
adam@1692 916 val radio : formTag (option string) radio [Id = id]
adamc@1068 917 val radioOption : unit -> tag ([Value = string, Checked = bool] ++ boxAttrs) radio [] [] []
adamc@142 918
adamc@154 919 con select = [Select]
adamc@1047 920 val select : formTag string select ([Onchange = transaction unit] ++ boxAttrs)
adamc@720 921 val option : unit -> tag [Value = string, Selected = bool] select [] [] []
adamc@154 922
adamc@720 923 val submit : ctx ::: {Unit} -> use ::: {Type}
adamc@629 924 -> [[Form] ~ ctx] =>
adamc@354 925 unit
adamc@1047 926 -> tag ([Value = string, Action = $use -> transaction page] ++ boxAttrs)
adamc@720 927 ([Form] ++ ctx) ([Form] ++ ctx) use []
adamc@283 928
adam@1517 929 val image : ctx ::: {Unit} -> use ::: {Type}
adam@1517 930 -> [[Form] ~ ctx] =>
adam@1517 931 unit
adam@1517 932 -> tag ([Src = url, Width = int, Height = int, Alt = string, Action = $use -> transaction page] ++ boxAttrs)
adam@1517 933 ([Form] ++ ctx) ([Form] ++ ctx) use []
adam@1517 934
adam@1557 935 val label : bodyTag ([For = id, Accesskey = string] ++ tableAttrs)
adamc@1047 936
adamc@1047 937
adamc@601 938 (*** AJAX-oriented widgets *)
adamc@601 939
adamc@797 940 con cformTag = fn (attrs :: {Type}) (inner :: {Unit}) =>
adamc@601 941 ctx ::: {Unit}
adamc@629 942 -> [[Body] ~ ctx] =>
adamc@797 943 unit -> tag attrs ([Body] ++ ctx) inner [] []
adamc@601 944
vshabanoff@1709 945 val ctextbox : cformTag ([Value = string, Size = int, Source = source string, Placeholder = string, Onchange = transaction unit,
adamc@1047 946 Ontext = transaction unit] ++ boxAttrs) []
adamc@1047 947 val button : cformTag ([Value = string] ++ boxAttrs) []
adamc@797 948
adamc@1047 949 val ccheckbox : cformTag ([Value = bool, Size = int, Source = source bool] ++ boxAttrs) []
adamc@817 950
adamc@797 951 con cselect = [Cselect]
adamc@1047 952 val cselect : cformTag ([Source = source string, Onchange = transaction unit] ++ boxAttrs) cselect
adamc@797 953 val coption : unit -> tag [Value = string, Selected = bool] cselect [] [] []
adamc@601 954
adamc@1099 955 val ctextarea : cformTag ([Value = string, Rows = int, Cols = int, Source = source string, Onchange = transaction unit,
adamc@1099 956 Ontext = transaction unit] ++ boxAttrs) []
adamc@1099 957
adamc@720 958 (*** Tables *)
adamc@720 959
adamc@892 960 val tabl : other ::: {Unit} -> [other ~ [Body, Table]] => unit
adamc@1047 961 -> tag ([Border = int] ++ boxAttrs)
adam@1641 962 ([Body] ++ other) ([Table] ++ other) [] []
adam@1641 963 val tr : other ::: {Unit} -> [other ~ [Table, Tr]] => unit
adamc@1047 964 -> tag tableAttrs
adam@1641 965 ([Table] ++ other) ([Tr] ++ other) [] []
adamc@892 966 val th : other ::: {Unit} -> [other ~ [Body, Tr]] => unit
kkallio@1476 967 -> tag ([Colspan = int, Rowspan = int] ++ tableAttrs)
adam@1641 968 ([Tr] ++ other) ([Body] ++ other) [] []
adamc@892 969 val td : other ::: {Unit} -> [other ~ [Body, Tr]] => unit
kkallio@1476 970 -> tag ([Colspan = int, Rowspan = int] ++ tableAttrs)
adam@1641 971 ([Tr] ++ other) ([Body] ++ other) [] []
adamc@720 972
adamc@283 973
adamc@283 974 (** Aborting *)
adamc@283 975
adamc@726 976 val error : t ::: Type -> xbody -> t
adamc@720 977
adamc@729 978 (* Client-side-only handlers: *)
adamc@726 979 val onError : (xbody -> transaction unit) -> transaction unit
adamc@728 980 val onFail : (string -> transaction unit) -> transaction unit
adamc@729 981 val onConnectFail : transaction unit -> transaction unit
adamc@729 982 val onDisconnect : transaction unit -> transaction unit
adamc@729 983 val onServerError : (string -> transaction unit) -> transaction unit
adamc@727 984
adam@1555 985 (* More standard document-level JavaScript handlers *)
adam@1783 986 val onClick : (mouseEvent -> transaction unit) -> transaction unit
adam@1783 987 val onDblclick : (mouseEvent -> transaction unit) -> transaction unit
adam@1783 988 val onKeydown : (keyEvent -> transaction unit) -> transaction unit
adam@1783 989 val onKeypress : (keyEvent -> transaction unit) -> transaction unit
adam@1783 990 val onKeyup : (keyEvent -> transaction unit) -> transaction unit
adam@1783 991 val onMousedown : (mouseEvent -> transaction unit) -> transaction unit
adam@1791 992 val onMousemove : (mouseEvent -> transaction unit) -> transaction unit
adam@1791 993 val onMouseout : (mouseEvent -> transaction unit) -> transaction unit
adam@1791 994 val onMouseover : (mouseEvent -> transaction unit) -> transaction unit
adam@1783 995 val onMouseup : (mouseEvent -> transaction unit) -> transaction unit
adam@1555 996
adam@1559 997 (* Prevents default handling of current event *)
adam@1559 998 val preventDefault : transaction unit
adam@1559 999 (* Stops propagation of current event *)
adam@1559 1000 val stopPropagation : transaction unit
adam@1559 1001
adamc@727 1002 val show_xml : ctx ::: {Unit} -> use ::: {Type} -> bind ::: {Type} -> show (xml ctx use bind)
adamc@1075 1003
adamc@1075 1004
adamc@1075 1005 (** Tasks *)
adamc@1075 1006
adam@1348 1007 con task_kind :: Type -> Type
adam@1348 1008 val initialize : task_kind unit
adam@1348 1009 val clientLeaves : task_kind client
adam@1349 1010 val periodic : int -> task_kind unit
adamc@1120 1011
adamc@1120 1012
adamc@1199 1013 (** Information flow security *)
adamc@1199 1014
adamc@1199 1015 type sql_policy
adamc@1199 1016
adamc@1214 1017 val sendClient : tables ::: {{Type}} -> exps ::: {Type}
adam@1394 1018 -> [tables ~ exps] => sql_query [] [] tables exps
adamc@1214 1019 -> sql_policy
adamc@1199 1020
adamc@1229 1021 val sendOwnIds : sql_sequence -> sql_policy
adamc@1229 1022
adamc@1220 1023 val mayInsert : fs ::: {Type} -> tables ::: {{Type}} -> [[New] ~ tables]
adam@1394 1024 => sql_query [] [] ([New = fs] ++ tables) []
adamc@1220 1025 -> sql_policy
adamc@1220 1026
adamc@1221 1027 val mayDelete : fs ::: {Type} -> tables ::: {{Type}} -> [[Old] ~ tables]
adam@1394 1028 => sql_query [] [] ([Old = fs] ++ tables) []
adamc@1221 1029 -> sql_policy
adamc@1221 1030
adamc@1223 1031 val mayUpdate : fs ::: {Type} -> tables ::: {{Type}} -> [[Old, New] ~ tables]
adam@1394 1032 => sql_query [] [] ([Old = fs, New = fs] ++ tables) []
adamc@1223 1033 -> sql_policy
adamc@1223 1034
adamc@1240 1035 val also : sql_policy -> sql_policy -> sql_policy
adamc@1199 1036
adamc@1120 1037 val debug : string -> transaction unit
adam@1389 1038 val naughtyDebug : string -> int
adamc@1250 1039
adamc@1250 1040 val rand : transaction int