@graview/core 0.1.29 → 0.1.32

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.29/dist/document.schema.json",
-  "title": "Graview declaration document, format 1 (@graview/core 0.1.29)",
+  "$id": "https://unpkg.com/@graview/core@0.1.32/dist/document.schema.json",
+  "title": "Graview declaration document, format 1 (@graview/core 0.1.32)",
   "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",
@@ -212,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",
@@ -247,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,
@@ -295,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": {
@@ -325,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": {
@@ -364,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."
                       }
                     }
                   },
@@ -398,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",
@@ -410,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]+)*$"
                       }
                     },
                     {
@@ -441,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",
@@ -508,6 +521,13 @@
           "archives": {
             "type": "boolean",
             "const": false
+          },
+          "tidying": {
+            "type": "string",
+            "enum": [
+              "never",
+              "no-links"
+            ]
           }
         },
         "required": [
@@ -516,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",
@@ -561,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",
@@ -623,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": [
@@ -683,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": {
@@ -716,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": [
@@ -781,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."
                 }
               }
             ]
@@ -812,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",
@@ -987,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": [
@@ -1055,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": [
@@ -1123,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",
@@ -1162,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",
@@ -1217,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",
@@ -1484,13 +1516,388 @@
       "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"
+        "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,
+            "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"
+          }
         },
-        "additionalProperties": {}
+        "additionalProperties": false,
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "timeline"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            },
+            "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
+                        }
+                      ]
+                    }
+                  }
+                }
+              }
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "name": {
+                  "const": "calendar"
+                }
+              },
+              "required": [
+                "name"
+              ]
+            },
+            "then": {
+              "properties": {
+                "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
+                },
+                "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": [
+                "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": {
@@ -1546,42 +1953,153 @@
                   "minLength": 1,
                   "maxLength": 120
                 }
-              }
-            },
-            "additionalProperties": false
-          }
-        }
-      },
-      "additionalProperties": {}
-    },
-    "views": {
-      "type": "object",
-      "propertyNames": {
-        "type": "string"
-      },
-      "additionalProperties": {
-        "anyOf": [
-          {
+              },
+              "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": {}
+                "items": {
+                  "$ref": "#/$defs/ViewBlock"
+                }
               },
               "row": {
+                "description": "The blocks a row draws.",
                 "type": "array",
-                "items": {}
+                "items": {
+                  "$ref": "#/$defs/ViewBlock"
+                }
               },
               "page": {
+                "description": "The blocks a page draws.",
                 "type": "array",
-                "items": {}
+                "items": {
+                  "$ref": "#/$defs/ViewBlock"
+                }
               }
             },
             "additionalProperties": false
           },
           {
+            "description": "The home view's blocks (under `home`).",
             "type": "array",
-            "items": {}
+            "items": {
+              "$ref": "#/$defs/ViewBlock"
+            }
           }
         ]
       }
@@ -1636,9 +2154,25 @@
           ]
         },
         "favicon": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 65536
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 65536
+            },
+            {
+              "type": "object",
+              "properties": {
+                "emoji": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "emoji"
+              ],
+              "additionalProperties": false
+            }
+          ]
         },
         "typography": {
           "type": "object",
@@ -1718,6 +2252,153 @@
         },
         "additionalProperties": {}
       }
+    },
+    "connections": {
+      "description": "Other systems this app is kept in step with, by name: today, Google calendars. `graview serve` and `graview preview` run them, with credentials from the environment; none is ever written here.",
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "system": {
+            "type": "string",
+            "const": "google-calendar"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500
+          },
+          "calendar": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 300
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "env": {
+                    "type": "string",
+                    "pattern": "^[A-Z][A-Z0-9_]*$"
+                  }
+                },
+                "required": [
+                  "env"
+                ],
+                "additionalProperties": false
+              }
+            ]
+          },
+          "auth": {
+            "type": "object",
+            "properties": {
+              "env": {
+                "type": "string",
+                "pattern": "^[A-Z][A-Z0-9_]*$"
+              },
+              "file": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 500
+              }
+            },
+            "required": [
+              "env"
+            ],
+            "additionalProperties": false
+          },
+          "kind": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+          },
+          "fields": {
+            "type": "object",
+            "properties": {
+              "summary": {
+                "type": "string",
+                "pattern": "^[a-z][A-Za-z0-9]*$"
+              },
+              "start": {
+                "type": "string",
+                "pattern": "^[a-z][A-Za-z0-9]*$"
+              },
+              "end": {
+                "type": "string",
+                "pattern": "^[a-z][A-Za-z0-9]*$"
+              },
+              "location": {
+                "type": "string",
+                "pattern": "^[a-z][A-Za-z0-9]*$"
+              },
+              "description": {
+                "type": "string",
+                "pattern": "^[a-z][A-Za-z0-9]*$"
+              }
+            },
+            "required": [
+              "summary",
+              "start",
+              "end"
+            ],
+            "additionalProperties": false
+          },
+          "filter": {
+            "type": "object",
+            "properties": {
+              "color": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 40
+              },
+              "tag": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 40
+              },
+              "keep": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "read",
+              "both"
+            ]
+          },
+          "conflicts": {
+            "type": "string",
+            "enum": [
+              "report",
+              "theirs",
+              "ours"
+            ]
+          },
+          "every": {
+            "type": "integer",
+            "minimum": 2,
+            "maximum": 86400
+          },
+          "paused": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "system",
+          "calendar",
+          "kind",
+          "fields",
+          "direction"
+        ],
+        "additionalProperties": false
+      }
     }
   },
   "required": [
@@ -1726,5 +2407,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
+        }
+      ]
+    }
+  }
 }