{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "relative-ref-clause": {
      "type": "string",
      "minLength": 1,
      "maxLength": 101
    },
    "path-clause": {
      "type": "string",
      "pattern": "^(/[^/]+)+$",
      "minLength": 1,
      "maxLength": 1024
    },
    "path-clause-multiple": {
      "type": "array",
      "items": {
        "$ref": "#/definitions/path-clause"
      },
      "uniqueItems": true,
      "minItems": 1
    },
    "url-clause": {
      "type": "string",
      "pattern": "^[0-9a-z+\\-\\.]+://.+$",
      "minLength": 1,
      "maxLength": 4096
    },
    "startup-clause": {
      "type": "string",
      "pattern": "^(lazy|eager)$"
    },
    "durability-clause": {
      "type": "string",
      "pattern": "^(persistent|transient)$"
    },
    "name-clause": {
      "type": "string",
      "pattern": "^[0-9a-z_\\-\\.]+$",
      "minLength": 1,
      "maxLength": 100
    },
    "storage-type-clause": {
      "type": "string",
      "enum": [
        "data",
        "cache",
        "meta"
      ]
    },
    "rights-clause": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "r*",
          "w*",
          "x*",
          "rw*",
          "rx*",
          "connect",
          "read_bytes",
          "write_bytes",
          "execute",
          "get_attributes",
          "update_attributes",
          "enumerate",
          "traverse",
          "modify_directory",
          "admin"
        ]
      }
    }
  },
  "properties": {
    "program": {
      "type": "object",
      "title": "Program information",
      "description": "Information required to run the program",
      "required": [
        "binary"
      ],
      "properties": {
        "binary": {
          "type": "string",
          "title": "Program binary",
          "description": "The entry point for an executable",
          "examples": [
            "bin/app"
          ]
        },
        "args": {
          "type": "array",
          "title": "Program arguments",
          "description": "The arguments to provide to an executable",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "examples": [
            "--verbose"
          ]
        },
        "env": {
          "type": "object",
          "title": "Environment variables",
          "description": "Environment variables to provide to an executable",
          "items": {
            "type": "string"
          },
          "minItems": 1,
          "examples": [
            {
              "VERBOSITY": "1"
            }
          ]
        }
      }
    },
    "use": {
      "type": "array",
      "title": "Used capabilities",
      "description": "Capabilities that will be installed in this component's namespace",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "oneOf": [
          {
            "required": [
              "service"
            ]
          },
          {
            "required": [
              "protocol"
            ]
          },
          {
            "required": [
              "directory"
            ]
          },
          {
            "required": [
              "storage"
            ]
          },
          {
            "required": [
              "runner"
            ]
          }
        ],
        "properties": {
          "service": {
            "title": "Used service source path",
            "description": "The path under which a service is offered to this component",
            "allOf": [
              {
                "$ref": "#/definitions/path-clause"
              }
            ],
            "examples": [
              "/svc/fuchsia.logger.Log"
            ]
          },
          "protocol": {
            "title": "Used legacy service source path",
            "description": "A path, or a list of paths, under which a legacy service is offered to this component",
            "oneOf": [
              {
                "$ref": "#/definitions/path-clause"
              },
              {
                "$ref": "#/definitions/path-clause-multiple"
              }
            ],
            "examples": [
              "/svc/fuchsia.logger.Log"
            ]
          },
          "directory": {
            "title": "Used directory source path",
            "description": "The path under which a directory is offered to this component",
            "allOf": [
              {
                "$ref": "#/definitions/path-clause"
              }
            ],
            "examples": [
              "/data/assets/widgets"
            ]
          },
          "storage": {
            "title": "Used storage capability",
            "description": "The type of storage which has been offered to this component",
            "allOf": [
              {
                "$ref": "#/definitions/storage-type-clause"
              }
            ],
            "examples": [
              "data"
            ]
          },
          "runner": {
            "title": "Used runner name",
            "description": "The name of a runner offered to this component",
            "allOf": [
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "elf"
            ]
          },
          "from": {
            "title": "Used capability source",
            "pattern": "^(realm|framework)$",
            "description": "The component which is offering the capability to use. Either \"realm\" (default) or \"framework\"\". May not be specified for runners, because the source is implicitly \"realm\" in that case.",
            "examples": [
              "realm",
              "framework"
            ]
          },
          "as": {
            "title": "Used capability target path",
            "description": "The path to which the capability will be installed in the component's incoming namespace. Defaults to \"service\"/\"directory\". May not be specified for runners.",
            "allOf": [
              {
                "$ref": "#/definitions/path-clause"
              }
            ],
            "examples": [
              "/svc/fuchsia.logger.Log"
            ]
          },
          "rights": {
            "title": "Used directory capability rights",
            "description": "The set of capability rights which are required by this component for this use statement.",
            "allOf": [
              {
                "$ref": "#/definitions/rights-clause"
              }
            ],
            "examples": [
              [
                "r*"
              ],
              [
                "r*",
                "write_bytes"
              ]
            ]
          }
        }
      }
    },
    "expose": {
      "type": "array",
      "title": "Capabilities exposed",
      "description": "Capabilities exposed by this component to its containing realm",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "required": [
          "from"
        ],
        "oneOf": [
          {
            "required": [
              "service"
            ]
          },
          {
            "required": [
              "protocol"
            ]
          },
          {
            "required": [
              "directory"
            ]
          },
          {
            "required": [
              "runner"
            ]
          }
        ],
        "properties": {
          "service": {
            "title": "Exposed service source path",
            "description": "The path to the service being exposed. This is either a path in this component's outgoing namespace (if from \"self\"), or the path by which the service was exposed by the child (if from \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/path-clause"
              }
            ],
            "examples": [
              "/svc/fuchsia.ui.scenic.Scenic"
            ]
          },
          "protocol": {
            "title": "Exposed legacy service source path",
            "description": "A path, or a list of paths, to legacy service being exposed. Each path must be from this component's outgoing namespace (if from \"self\"), or must be a protocol path exposed to this component by a child (if from \"#$CHILD\").",
            "oneOf": [
              {
                "$ref": "#/definitions/path-clause"
              },
              {
                "$ref": "#/definitions/path-clause-multiple"
              }
            ],
            "examples": [
              "/svc/fuchsia.ui.scenic.Scenic",
              [
                "/svc/fuchsia.ui.scenic.Scenic",
                "/svc/fuchsia.net.Netstack"
              ]
            ]
          },
          "directory": {
            "title": "Exposed directory source path",
            "description": "The path to the directory being exposed. This is either a path in this component's outgoing namespace (if from \"self\"), or the path by which the directory was exposed by the child (if from \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/path-clause"
              }
            ],
            "examples": [
              "/data/assets/widgets"
            ]
          },
          "runner": {
            "title": "Exposed runner source name",
            "description": "The name of the runner being exposed. This is either a runner provided by the componenet (if from \"self\"), or the name of a runner exposed by a child (if from \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "elf"
            ]
          },
          "from": {
            "title": "Exposed capability source component",
            "pattern": "^(self|framework|#[0-9a-z_\\-\\.]+)$",
            "description": "The component which has the capability to expose. Either \"self\" or \"#$CHILD\".",
            "allOf": [
              {
                "$ref": "#/definitions/relative-ref-clause"
              }
            ],
            "examples": [
              "self",
              "#scenic"
            ]
          },
          "as": {
            "title": "Exposed capability target path or name",
            "description": "The path or name by which the capability will be exposed. Defaults to the source path/name.",
            "oneOf": [
              {
                "$ref": "#/definitions/path-clause"
              },
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "/svc/fuchsia.logger.Log"
            ]
          },
          "to": {
            "title": "Exposed capability target type",
            "description": "The sort of destination that may receive the exposed capability. Either \"realm\" or \"framework\". Defaults to: \"realm\"",
            "pattern": "^(realm|framework)$",
            "examples": [
              "realm",
              "framework"
            ]
          },
          "rights": {
            "title": "Exposed directory capability rights",
            "description": "The set of capability rights which exposed by this component to the destination",
            "allOf": [
              {
                "$ref": "#/definitions/rights-clause"
              }
            ],
            "examples": [
              [
                "r*"
              ],
              [
                "read_bytes",
                "write_bytes"
              ]
            ]
          }
        }
      }
    },
    "offer": {
      "type": "array",
      "title": "Offered capabilities",
      "description": "Capabilities offered by this component to its children",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "required": [
          "from",
          "to"
        ],
        "oneOf": [
          {
            "required": [
              "service"
            ]
          },
          {
            "required": [
              "protocol"
            ]
          },
          {
            "required": [
              "directory"
            ]
          },
          {
            "required": [
              "storage"
            ]
          },
          {
            "required": [
              "runner"
            ]
          }
        ],
        "properties": {
          "service": {
            "title": "Offered service source path",
            "description": "The path to the service being offered. This is either a path in this component's namespace (if from \"self\"), or the path by which the service was exposed or offered from another component (if from \"realm\" or \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/path-clause"
              }
            ],
            "examples": [
              "/svc/fuchsia.ui.scenic.Scenic"
            ]
          },
          "protocol": {
            "title": "Offered legacy service source path",
            "description": "A path, or a list of paths, to legacy services offered to children. Each path must either come from this component's namespace (if from \"self\"), or must be a path which was exposed or offered from another component (if from \"realm\" or \"#$CHILD\").",
            "oneOf": [
              {
                "$ref": "#/definitions/path-clause"
              },
              {
                "$ref": "#/definitions/path-clause-multiple"
              }
            ],
            "examples": [
              "/svc/fuchsia.ui.scenic.Scenic",
              [
                "/svc/fuchsia.ui.scenic.Scenic",
                "/svc/fuchsia.net.Netstack"
              ]
            ]
          },
          "directory": {
            "title": "Offered directory source path",
            "description": "The path to the directory being offered. This is either a path in this component's outgoing namespace (if from \"self\"), or the path by which the directory was exposed or offered from another component (if from \"realm\" or \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/path-clause"
              }
            ],
            "examples": [
              "/svc/fuchsia.ui.scenic.Scenic"
            ]
          },
          "storage": {
            "title": "Offered storage type",
            "description": "The storage type being offered. Must be one of \"data\", \"cache\", or \"meta\".",
            "allOf": [
              {
                "$ref": "#/definitions/storage-type-clause"
              }
            ],
            "examples": [
              "data"
            ]
          },
          "runner": {
            "title": "Offered runner name",
            "description": "The runner being offered. This is either a runner declared by this component (if from \"self\"), or a runner which was exposed or offered from another component (if from \"realm\" or \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "elf"
            ]
          },
          "from": {
            "title": "Offered capability source component",
            "description": "The component which has the capability to offer. For services, directories, and runners one of \"framework\", \"realm\", \"self\" or \"#$CHILD\"; for storage either \"realm\" or \"#$STORAGE_SECTION_NAME\".",
            "pattern": "^(realm|framework|self|#[0-9a-z_\\-\\.]+)$",
            "allOf": [
              {
                "$ref": "#/definitions/relative-ref-clause"
              }
            ],
            "examples": [
              "realm",
              "framework",
              "self",
              "#scenic"
            ]
          },
          "to": {
            "type": "array",
            "title": "Offered capability targets",
            "description": "The components the capability is being offered to",
            "uniqueItems": true,
            "minItems": 1,
            "items": {
              "type": "string",
              "pattern": "^#[a-zA-Z0-9_-]+$",
              "allOf": [
                {
                  "$ref": "#/definitions/relative-ref-clause"
                }
              ],
              "examples": [
                "#scenic"
              ]
            }
          },
          "as": {
            "title": "Offered capability target path or name",
            "description": "The path or name by which the capability will be offered. Must be omitted for storage capabilities.",
            "oneOf": [
              {
                "$ref": "#/definitions/path-clause"
              },
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "/data/assets/widgets",
              "/svc/fuchsia.ui.scenic.Scenic"
            ]
          },
          "rights": {
            "title": "Offered directory capability rights",
            "description": "The set of capability rights which offered by this component to the destination",
            "allOf": [
              {
                "$ref": "#/definitions/rights-clause"
              }
            ],
            "examples": [
              [
                "r*"
              ],
              [
                "read_bytes",
                "write_bytes"
              ]
            ]
          }
        }
      }
    },
    "storage": {
      "type": "array",
      "title": "Storage capabilities",
      "description": "Declared storage capabilities backed by a directories from which data, cache, or meta storage can be offered.",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "required": [
          "name",
          "from",
          "path"
        ],
        "properties": {
          "from": {
            "title": "Offered directory capability source component",
            "description": "The component which has the directory capability to use for storage. Either \"realm\", \"self\" or \"#$CHILD\".",
            "pattern": "^(realm|self|#[0-9a-z_\\-\\.]+)$",
            "allOf": [
              {
                "$ref": "#/definitions/relative-ref-clause"
              }
            ],
            "examples": [
              "realm",
              "self",
              "#scenic"
            ]
          },
          "name": {
            "title": "Storage name",
            "description": "The component's local name for this storage",
            "allOf": [
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "minfs",
              "persistent_storage"
            ]
          },
          "path": {
            "title": "Offered directory capability source path",
            "description": "The path of the directory capability. The path is either a path into the component's outgoing directory (if from \"self\"), or the path by which the capability was exposed or offered from another component (if from \"realm\" or \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/relative-ref-clause"
              }
            ],
            "examples": [
              "/data/storage",
              "/minfs"
            ]
          }
        }
      }
    },
    "children": {
      "type": "array",
      "title": "Child components",
      "description": "The children of this component, including name and launch information",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "required": [
          "name",
          "url"
        ],
        "properties": {
          "name": {
            "title": "Child component name",
            "description": "The parent's local name for the child",
            "allOf": [
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "echo_server",
              "System-logger"
            ]
          },
          "url": {
            "title": "Child component URI",
            "description": "The URI that identifies the child component.",
            "allOf": [
              {
                "$ref": "#/definitions/url-clause"
              }
            ],
            "examples": [
              "fuchsia-pkg://fuchsia.com/echo_server_cpp#meta/echo_server.cml"
            ]
          },
          "startup": {
            "title": "Startup mode",
            "description": "Conditions that trigger the component to start (defaults to \"lazy\")",
            "allOf": [
              {
                "$ref": "#/definitions/startup-clause"
              }
            ],
            "examples": [
              "eager",
              "lazy"
            ]
          }
        }
      }
    },
    "collections": {
      "type": "array",
      "title": "Collections",
      "description": "The collections under this component",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "required": [
          "name",
          "durability"
        ],
        "properties": {
          "name": {
            "title": "Collection name",
            "description": "The parent's local name for the collection",
            "allOf": [
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "modular",
              "tests"
            ]
          },
          "durability": {
            "title": "Durability",
            "description": "The durability of components in the collection. Either \"persistent\" (instances in the collection exist until the parent is destroyed) or \"transient\" (instances in the collection exist until the parent is stopped)",
            "allOf": [
              {
                "$ref": "#/definitions/durability-clause"
              }
            ],
            "examples": [
              "persistent",
              "transient"
            ]
          }
        }
      }
    },
    "facets": {
      "type": "object",
      "title": "Facets",
      "description": "Freeform dictionary containing third-party metadata"
    },
    "runners": {
      "type": "array",
      "title": "Runners",
      "description": "Runners declared by this componenet.",
      "uniqueItems": true,
      "items": {
        "type": "object",
        "required": [
          "name",
          "from",
          "path"
        ],
        "properties": {
          "from": {
            "title": "Runner source component",
            "description": "The component providing the underlying runner service. Either \"realm\", \"self\" or \"#$CHILD\".",
            "pattern": "^(realm|self|#[0-9a-z_\\-\\.]+)$",
            "allOf": [
              {
                "$ref": "#/definitions/relative-ref-clause"
              }
            ],
            "examples": [
              "realm",
              "self",
              "#scenic"
            ]
          },
          "name": {
            "title": "Runner name",
            "description": "The name of this runner.",
            "allOf": [
              {
                "$ref": "#/definitions/name-clause"
              }
            ],
            "examples": [
              "elf"
            ]
          },
          "path": {
            "title": "The path of the capability",
            "description": "The path of the capability providing the runner service. The path is either a path into the component's outgoing directory (if from \"self\"), or the path by which the capability was exposed or offered from another component (if from \"realm\" or \"#$CHILD\").",
            "allOf": [
              {
                "$ref": "#/definitions/relative-ref-clause"
              }
            ],
            "examples": [
              "/elf"
            ]
          }
        }
      }
    }
  }
}