@graview/core 0.1.28 → 0.1.30

package/dist/document.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://unpkg.com/@graview/core@0.1.28/dist/document.schema.json",
-  "title": "Graview declaration document, format 1 (@graview/core 0.1.28)",
+  "$id": "https://unpkg.com/@graview/core@0.1.30/dist/document.schema.json",
+  "title": "Graview declaration document, format 1 (@graview/core 0.1.30)",
   "description": "A whole Graview app as one JSON object: its kinds, fields, relations, acts, rules, roles, views and brand. `graview check --document <file>` compiles it and says what is wrong in words; this schema is the same shape, for an editor. Name it in a document's \"$schema\".",
   "type": "object",
   "properties": {
@@ -35,7 +35,8 @@
       "type": "object",
       "propertyNames": {
         "type": "string",
-        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+        "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
       },
       "additionalProperties": {
         "type": "object",
@@ -77,7 +78,8 @@
                   "__proto__",
                   "toLocaleString"
                 ]
-              }
+              },
+              "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
             },
             "additionalProperties": {
               "type": "object",
@@ -97,7 +99,11 @@
                     "url",
                     "email",
                     "image",
-                    "file"
+                    "file",
+                    "app-link",
+                    "phone",
+                    "place",
+                    "duration"
                   ]
                 },
                 "required": {
@@ -143,7 +149,8 @@
                   "enum": [
                     "money",
                     "percent",
-                    "duration"
+                    "duration",
+                    "markdown"
                   ]
                 },
                 "min": {
@@ -158,6 +165,9 @@
                 "renamedFrom": {
                   "type": "string",
                   "pattern": "^[a-z][A-Za-z0-9]*$"
+                },
+                "repeats": {
+                  "type": "boolean"
                 }
               },
               "required": [
@@ -204,7 +214,8 @@
                 }
               ]
             },
-            "minProperties": 1
+            "minProperties": 1,
+            "description": "The kind's fields, by name. Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
           },
           "label": {
             "type": "string",
@@ -239,7 +250,8 @@
                     "__proto__",
                     "toLocaleString"
                   ]
-                }
+                },
+                "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
               },
               "retired": {
                 "minItems": 1,
@@ -287,7 +299,8 @@
                   "__proto__",
                   "toLocaleString"
                 ]
-              }
+              },
+              "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
             }
           },
           "page": {
@@ -317,7 +330,8 @@
                       "__proto__",
                       "toLocaleString"
                     ]
-                  }
+                  },
+                  "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
                 }
               },
               "groups": {
@@ -356,7 +370,8 @@
                             "__proto__",
                             "toLocaleString"
                           ]
-                        }
+                        },
+                        "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
                       }
                     }
                   },
@@ -390,7 +405,8 @@
                   "__proto__",
                   "toLocaleString"
                 ]
-              }
+              },
+              "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
             },
             "additionalProperties": {
               "type": "object",
@@ -402,7 +418,7 @@
                       "type": "array",
                       "items": {
                         "type": "string",
-                        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$|^@(?:https?:\\/\\/[^\\s<>\"'`\\\\#?]+|[A-Za-z0-9][\\w.~-]*(?:\\/[\\w.~-]+)*)\\/[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
                       }
                     },
                     {
@@ -433,13 +449,18 @@
                 },
                 "renamedFrom": {
                   "type": "string"
+                },
+                "tidying": {
+                  "type": "string",
+                  "const": "never"
                 }
               },
               "required": [
                 "to"
               ],
               "additionalProperties": false
-            }
+            },
+            "description": "The kind's relations, by name. Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
           },
           "computed": {
             "type": "object",
@@ -496,6 +517,17 @@
           },
           "people": {
             "type": "boolean"
+          },
+          "archives": {
+            "type": "boolean",
+            "const": false
+          },
+          "tidying": {
+            "type": "string",
+            "enum": [
+              "never",
+              "no-links"
+            ]
           }
         },
         "required": [
@@ -504,7 +536,8 @@
         "additionalProperties": false
       },
       "minProperties": 1,
-      "maxProperties": 40
+      "maxProperties": 40,
+      "description": "The kinds of record, by name. Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
     },
     "computed": {
       "type": "object",
@@ -549,7 +582,8 @@
       "type": "object",
       "propertyNames": {
         "type": "string",
-        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+        "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
       },
       "additionalProperties": {
         "type": "object",
@@ -611,7 +645,8 @@
                   "__proto__",
                   "toLocaleString"
                 ]
-              }
+              },
+              "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
             },
             "additionalProperties": {
               "anyOf": [
@@ -671,7 +706,8 @@
                   "__proto__",
                   "toLocaleString"
                 ]
-              }
+              },
+              "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
             }
           },
           "connects": {
@@ -704,7 +740,8 @@
                   "__proto__",
                   "toLocaleString"
                 ]
-              }
+              },
+              "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
             },
             "additionalProperties": {
               "anyOf": [
@@ -769,7 +806,8 @@
                       "__proto__",
                       "toLocaleString"
                     ]
-                  }
+                  },
+                  "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
                 }
               }
             ]
@@ -800,7 +838,8 @@
                   "__proto__",
                   "toLocaleString"
                 ]
-              }
+              },
+              "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
             },
             "additionalProperties": {
               "type": "object",
@@ -820,7 +859,11 @@
                     "url",
                     "email",
                     "image",
-                    "file"
+                    "file",
+                    "app-link",
+                    "phone",
+                    "place",
+                    "duration"
                   ]
                 },
                 "required": {
@@ -866,7 +909,8 @@
                   "enum": [
                     "money",
                     "percent",
-                    "duration"
+                    "duration",
+                    "markdown"
                   ]
                 },
                 "min": {
@@ -881,6 +925,9 @@
                 "renamedFrom": {
                   "type": "string",
                   "pattern": "^[a-z][A-Za-z0-9]*$"
+                },
+                "repeats": {
+                  "type": "boolean"
                 }
               },
               "required": [
@@ -967,7 +1014,8 @@
                             "__proto__",
                             "toLocaleString"
                           ]
-                        }
+                        },
+                        "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
                       },
                       "additionalProperties": {
                         "anyOf": [
@@ -1035,7 +1083,8 @@
                             "__proto__",
                             "toLocaleString"
                           ]
-                        }
+                        },
+                        "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
                       },
                       "additionalProperties": {
                         "anyOf": [
@@ -1103,7 +1152,8 @@
                           "__proto__",
                           "toLocaleString"
                         ]
-                      }
+                      },
+                      "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
                     },
                     "from": {
                       "type": "string",
@@ -1142,7 +1192,8 @@
                           "__proto__",
                           "toLocaleString"
                         ]
-                      }
+                      },
+                      "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
                     },
                     "from": {
                       "type": "string",
@@ -1197,7 +1248,8 @@
       "type": "object",
       "propertyNames": {
         "type": "string",
-        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+        "description": "Kinds, acts, rules and roles are kebab-case, like \"tool-note\"; fields and relations are camelCase, like \"supersededBy\", so a rule can say them bare. A kind keeps the name it is given, because every record stores it."
       },
       "additionalProperties": {
         "type": "object",
@@ -1425,6 +1477,22 @@
               "via": {
                 "type": "string",
                 "pattern": "^(?:[a-z][a-z0-9]*(?:-[a-z0-9]+)*|[a-z][A-Za-z0-9]*)$"
+              },
+              "fields": {
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                }
+              },
+              "hide": {
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+                }
               }
             },
             "required": [
@@ -1448,140 +1516,663 @@
       "additionalProperties": {}
     },
     "lenses": {
+      "description": "The pictures the app draws beside its lists: each names a lens Graview ships, binds it to the kinds it stands on, and, with a title, is a place of its own.",
       "type": "array",
       "items": {
         "type": "object",
-        "propertyNames": {
-          "type": "string"
-        },
-        "additionalProperties": {}
-      }
-    },
-    "pages": {
-      "type": "object",
-      "properties": {
-        "order": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "hide": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "first": {
-          "type": "string"
-        },
-        "primary": {
-          "maxItems": 40,
-          "type": "array",
-          "items": {
+        "required": [
+          "name"
+        ],
+        "properties": {
+          "name": {
+            "description": "Which lens: timeline, calendar, coverage, board, plan, reach, blocks, columns.",
+            "enum": [
+              "timeline",
+              "calendar",
+              "coverage",
+              "board",
+              "plan",
+              "reach",
+              "blocks",
+              "columns"
+            ]
+          },
+          "title": {
             "type": "string",
             "minLength": 1,
-            "maxLength": 80
+            "maxLength": 80,
+            "description": "With a title, the lens is a place: a pill on the bar and a page of its own."
+          },
+          "on": {
+            "type": "string",
+            "description": "The kind it is a place over, when its bindings do not say."
+          },
+          "options": {
+            "type": "object"
+          },
+          "bindings": {
+            "type": "object"
+          },
+          "binds": {
+            "enum": [
+              "fields",
+              "entities"
+            ]
+          },
+          "requiredRoles": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "provenBy": {
+            "type": "string"
+          },
+          "arrangedBy": {
+            "description": "What the picture opens arranged by, in the arrangement grammar."
+          },
+          "hidden": {
+            "type": "boolean",
+            "description": "Kept off the lists: reached by its address, a link or navigate."
+          },
+          "create": {
+            "type": "boolean"
           }
         },
-        "scene": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 40
-        },
-        "pages": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 40
-        }
-      },
-      "additionalProperties": {}
-    },
-    "views": {
-      "type": "object",
-      "propertyNames": {
-        "type": "string"
-      },
-      "additionalProperties": {
-        "anyOf": [
+        "additionalProperties": false,
+        "allOf": [
           {
-            "type": "object",
-            "properties": {
-              "card": {
-                "type": "array",
-                "items": {}
-              },
-              "row": {
-                "type": "array",
-                "items": {}
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "timeline"
+                }
               },
-              "page": {
-                "type": "array",
-                "items": {}
-              }
+              "required": [
+                "name"
+              ]
             },
-            "additionalProperties": false
+            "then": {
+              "properties": {
+                "options": {
+                  "description": "What the timeline lens takes besides its roles: columns, extent, tick, minWindow, arranging.",
+                  "type": "object",
+                  "properties": {
+                    "columns": {},
+                    "extent": {},
+                    "tick": {},
+                    "minWindow": {},
+                    "arranging": {}
+                  },
+                  "additionalProperties": false
+                },
+                "bindings": {
+                  "description": "Per kind, each role bound to a field — \"start\": \"due\" — or to a field and the values that make it true — { \"field\": \"status\", \"is\": [\"done\"] }. It binds start, end.",
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "field": {
+                              "type": "string"
+                            },
+                            "is": {
+                              "type": "array"
+                            }
+                          },
+                          "required": [
+                            "field",
+                            "is"
+                          ],
+                          "additionalProperties": false
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
           },
           {
-            "type": "array",
-            "items": {}
-          }
-        ]
-      }
-    },
-    "brand": {
-      "type": "object",
-      "properties": {
-        "accent": {
-          "type": "string",
-          "pattern": "^#[0-9a-fA-F]{6}$"
-        },
-        "name": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 60
-        },
-        "currency": {
-          "type": "string",
-          "pattern": "^[A-Z]{3}$"
-        },
-        "locale": {
-          "type": "string",
-          "minLength": 2,
-          "maxLength": 35
-        },
-        "logo": {
-          "anyOf": [
-            {
-              "type": "string",
-              "minLength": 1,
-              "maxLength": 65536
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "calendar"
+                }
+              },
+              "required": [
+                "name"
+              ]
             },
-            {
-              "type": "object",
+            "then": {
               "properties": {
-                "src": {
-                  "type": "string",
-                  "minLength": 1,
-                  "maxLength": 65536
+                "options": {
+                  "description": "What the calendar lens takes besides its roles: today, range, weekStartsOn, perCell, horizon, arranging.",
+                  "type": "object",
+                  "properties": {
+                    "today": {},
+                    "range": {},
+                    "weekStartsOn": {},
+                    "perCell": {},
+                    "horizon": {},
+                    "arranging": {}
+                  },
+                  "additionalProperties": false
                 },
-                "alt": {
-                  "type": "string",
-                  "minLength": 1,
-                  "maxLength": 120
+                "bindings": {
+                  "description": "Per kind, each role bound to a field — \"start\": \"due\" — or to a field and the values that make it true — { \"field\": \"status\", \"is\": [\"done\"] }. It binds start.",
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "field": {
+                              "type": "string"
+                            },
+                            "is": {
+                              "type": "array"
+                            }
+                          },
+                          "required": [
+                            "field",
+                            "is"
+                          ],
+                          "additionalProperties": false
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "coverage"
                 }
               },
               "required": [
-                "src"
-              ],
-              "additionalProperties": false
+                "name"
+              ]
+            },
+            "then": {
+              "properties": {
+                "options": {
+                  "description": "What the coverage lens takes besides its roles: rowRef, rowGroup, groupOrder, requiredGroups, requiredVia, badge, columnGroup, sort, columnSort.",
+                  "type": "object",
+                  "properties": {
+                    "rowRef": {},
+                    "rowGroup": {},
+                    "groupOrder": {},
+                    "requiredGroups": {},
+                    "requiredVia": {},
+                    "badge": {},
+                    "columnGroup": {},
+                    "sort": {},
+                    "columnSort": {}
+                  },
+                  "additionalProperties": false
+                }
+              }
             }
-          ]
+          },
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "board"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            },
+            "then": {
+              "properties": {
+                "options": {
+                  "description": "What the board lens takes besides its roles: fillFrom, slotCode, zones, aspect, emptyLabel, pickTarget, arranging, arrange.",
+                  "type": "object",
+                  "properties": {
+                    "fillFrom": {},
+                    "slotCode": {},
+                    "zones": {},
+                    "aspect": {},
+                    "emptyLabel": {},
+                    "pickTarget": {},
+                    "arranging": {},
+                    "arrange": {}
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "plan"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            },
+            "then": {
+              "properties": {
+                "options": {
+                  "description": "What the plan lens takes besides its roles: hues, aspect, undrawnLabel, strayLabel, draw, place, help.",
+                  "type": "object",
+                  "properties": {
+                    "hues": {},
+                    "aspect": {},
+                    "undrawnLabel": {},
+                    "strayLabel": {},
+                    "draw": {},
+                    "place": {},
+                    "help": {}
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "reach"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            },
+            "then": {
+              "properties": {
+                "options": {
+                  "description": "The reach lens takes no options.",
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": false
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "blocks"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            },
+            "then": {
+              "properties": {
+                "options": {
+                  "description": "What the blocks lens takes besides its roles: blocks.",
+                  "type": "object",
+                  "properties": {
+                    "blocks": {
+                      "description": "The blocks the lens draws, about no one record.",
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/$defs/ViewBlock"
+                      }
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "columns"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            },
+            "then": {
+              "properties": {
+                "options": {
+                  "description": "What the columns lens takes besides its roles: sort.",
+                  "type": "object",
+                  "properties": {
+                    "sort": {}
+                  },
+                  "additionalProperties": false
+                },
+                "bindings": {
+                  "description": "Per kind, each role bound to a field — \"start\": \"due\" — or to a field and the values that make it true — { \"field\": \"status\", \"is\": [\"done\"] }. It binds column.",
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "object",
+                    "additionalProperties": {
+                      "anyOf": [
+                        {
+                          "type": "string"
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "field": {
+                              "type": "string"
+                            },
+                            "is": {
+                              "type": "array"
+                            }
+                          },
+                          "required": [
+                            "field",
+                            "is"
+                          ],
+                          "additionalProperties": false
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "pages": {
+      "type": "object",
+      "properties": {
+        "order": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
         },
-        "favicon": {
+        "hide": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "first": {
+          "type": "string"
+        },
+        "primary": {
+          "maxItems": 40,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 80
+          }
+        },
+        "scene": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 40
+        },
+        "pages": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 40
+        },
+        "lists": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "filters": {
+                "maxItems": 40,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                }
+              },
+              "sort": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "by": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 120
+                      },
+                      "direction": {
+                        "type": "string",
+                        "enum": [
+                          "asc",
+                          "desc"
+                        ]
+                      },
+                      "then": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 120
+                          },
+                          {
+                            "type": "object",
+                            "properties": {
+                              "by": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 120
+                              },
+                              "direction": {
+                                "type": "string",
+                                "enum": [
+                                  "asc",
+                                  "desc"
+                                ]
+                              }
+                            },
+                            "required": [
+                              "by"
+                            ],
+                            "additionalProperties": false
+                          }
+                        ]
+                      }
+                    },
+                    "required": [
+                      "by"
+                    ],
+                    "additionalProperties": false
+                  }
+                ]
+              },
+              "group": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 120
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "by": {
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 120
+                      },
+                      "order": {
+                        "maxItems": 40,
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 80
+                        }
+                      },
+                      "closed": {
+                        "maxItems": 40,
+                        "type": "array",
+                        "items": {
+                          "type": "string",
+                          "minLength": 1,
+                          "maxLength": 80
+                        }
+                      }
+                    },
+                    "required": [
+                      "by"
+                    ],
+                    "additionalProperties": false
+                  }
+                ]
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": {}
+    },
+    "views": {
+      "description": "Each kind's views by kind — its card, row and page, each a list of blocks — and `home`: the home view, a list of blocks about no one record.",
+      "type": "object",
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "type": "object",
+            "properties": {
+              "card": {
+                "description": "The blocks a card draws.",
+                "type": "array",
+                "items": {
+                  "$ref": "#/$defs/ViewBlock"
+                }
+              },
+              "row": {
+                "description": "The blocks a row draws.",
+                "type": "array",
+                "items": {
+                  "$ref": "#/$defs/ViewBlock"
+                }
+              },
+              "page": {
+                "description": "The blocks a page draws.",
+                "type": "array",
+                "items": {
+                  "$ref": "#/$defs/ViewBlock"
+                }
+              }
+            },
+            "additionalProperties": false
+          },
+          {
+            "description": "The home view's blocks (under `home`).",
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/ViewBlock"
+            }
+          }
+        ]
+      }
+    },
+    "brand": {
+      "type": "object",
+      "properties": {
+        "accent": {
+          "type": "string",
+          "pattern": "^#[0-9a-fA-F]{6}$"
+        },
+        "name": {
           "type": "string",
           "minLength": 1,
-          "maxLength": 65536
+          "maxLength": 60
+        },
+        "currency": {
+          "type": "string",
+          "pattern": "^[A-Z]{3}$"
+        },
+        "locale": {
+          "type": "string",
+          "minLength": 2,
+          "maxLength": 35
+        },
+        "logo": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 65536
+            },
+            {
+              "type": "object",
+              "properties": {
+                "src": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 65536
+                },
+                "alt": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 120
+                }
+              },
+              "required": [
+                "src"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "favicon": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 65536
+            },
+            {
+              "type": "object",
+              "properties": {
+                "emoji": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "emoji"
+              ],
+              "additionalProperties": false
+            }
+          ]
         },
         "typography": {
           "type": "object",
@@ -1669,5 +2260,457 @@
     "name",
     "kinds"
   ],
-  "additionalProperties": false
+  "additionalProperties": false,
+  "$defs": {
+    "ViewBlock": {
+      "description": "A block from the closed set every view is written in: title, headline, list, text, badge, field, image, progress, group, when, divider, figure.",
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "title": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 300,
+              "description": "Words with {field} in braces, like \"{name}\" or \"{quote|money}\"."
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "title"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "headline": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 300,
+              "description": "Words with {field} in braces, like \"{name}\" or \"{quote|money}\"."
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "headline"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "list": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2000,
+              "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+            },
+            "sort": {
+              "description": "A key read from each record, lowest first, or { \"by\": key, \"direction\": \"asc\" | \"desc\" | \"choices\" }.",
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 2000,
+                  "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "by": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 2000,
+                      "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+                    },
+                    "direction": {
+                      "enum": [
+                        "asc",
+                        "desc",
+                        "choices"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "by"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            },
+            "limit": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1000
+            },
+            "group": {
+              "description": "A choice field, or { \"by\": field, \"headings\": { choice: words } }.",
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "by": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "headings": {
+                      "type": "object",
+                      "additionalProperties": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "by"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            },
+            "empty": {
+              "type": "string",
+              "minLength": 1
+            },
+            "as": {
+              "enum": [
+                "card",
+                "row"
+              ]
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "list"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "text": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 300,
+              "description": "Words with {field} in braces, like \"{name}\" or \"{quote|money}\"."
+            },
+            "tone": {
+              "description": "good, warn, bad, neutral, accent, or { \"expr\": … } that works one out.",
+              "anyOf": [
+                {
+                  "enum": [
+                    "good",
+                    "warn",
+                    "bad",
+                    "neutral",
+                    "accent"
+                  ]
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "expr": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 2000,
+                      "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+                    }
+                  },
+                  "required": [
+                    "expr"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "text"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "badge": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 300,
+              "description": "Words with {field} in braces, like \"{name}\" or \"{quote|money}\"."
+            },
+            "tone": {
+              "description": "good, warn, bad, neutral, accent, or { \"expr\": … } that works one out.",
+              "anyOf": [
+                {
+                  "enum": [
+                    "good",
+                    "warn",
+                    "bad",
+                    "neutral",
+                    "accent"
+                  ]
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "expr": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 2000,
+                      "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+                    }
+                  },
+                  "required": [
+                    "expr"
+                  ],
+                  "additionalProperties": false
+                }
+              ]
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "badge"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "field": {
+              "type": "string",
+              "description": "A field of the record, drawn as it is declared."
+            },
+            "as": {
+              "enum": [
+                "money",
+                "percent",
+                "date",
+                "relative",
+                "count"
+              ]
+            },
+            "currency": {
+              "type": "string",
+              "minLength": 1
+            },
+            "label": {
+              "type": "string",
+              "minLength": 1
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "field"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "image": {
+              "type": "string",
+              "description": "A field holding pictures."
+            },
+            "as": {
+              "enum": [
+                "thumb",
+                "gallery"
+              ]
+            },
+            "label": {
+              "type": "string",
+              "minLength": 1
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "image"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "progress": {
+              "type": "object",
+              "properties": {
+                "value": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 2000,
+                  "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+                },
+                "max": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 2000,
+                  "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+                }
+              },
+              "required": [
+                "value",
+                "max"
+              ],
+              "additionalProperties": false
+            },
+            "label": {
+              "type": "string",
+              "minLength": 1
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "progress"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "group": {
+              "description": "The blocks drawn together.",
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/ViewBlock"
+              }
+            },
+            "direction": {
+              "enum": [
+                "row",
+                "column"
+              ]
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "group"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "when": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2000,
+              "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+            },
+            "show": {
+              "description": "The blocks shown while the expression holds.",
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/ViewBlock"
+              }
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "when",
+            "show"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "divider": {
+              "const": true
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "divider"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "figure": {
+              "description": "An expression for a number worked out, or true for the kind's picture: {\"figure\": true}.",
+              "anyOf": [
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 2000,
+                  "description": "A line of the rule language, like \"status == 'booked'\" or \"count(all('offer'))\"."
+                },
+                {
+                  "const": true
+                }
+              ]
+            },
+            "as": {
+              "enum": [
+                "number",
+                "money",
+                "percent"
+              ]
+            },
+            "currency": {
+              "type": "string",
+              "minLength": 1
+            },
+            "label": {
+              "type": "string",
+              "minLength": 1
+            },
+            "emphasis": {
+              "enum": [
+                "large"
+              ]
+            },
+            "key": {
+              "type": "string",
+              "description": "What a face claims this block by."
+            }
+          },
+          "required": [
+            "figure"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    }
+  }
 }