_sharing.json 4.42 KB
{
  "definitions": {
    "Shared": {
      "description": "Modules that should be shared in the share scope. When provided, property names are used to match requested modules in this compilation.",
      "anyOf": [
        {
          "type": "array",
          "items": {
            "description": "Modules that should be shared in the share scope.",
            "anyOf": [
              {
                "$ref": "#/definitions/SharedItem"
              },
              {
                "$ref": "#/definitions/SharedObject"
              }
            ]
          }
        },
        {
          "$ref": "#/definitions/SharedObject"
        }
      ]
    },
    "SharedConfig": {
      "description": "Advanced configuration for modules that should be shared in the share scope.",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "eager": {
          "description": "Include the provided and fallback module directly instead behind an async request. This allows to use this shared module in initial load too. All possible shared modules need to be eager too.",
          "type": "boolean"
        },
        "import": {
          "description": "Provided module that should be provided to share scope. Also acts as fallback module if no shared module is found in share scope or version isn't valid. Defaults to the property name.",
          "anyOf": [
            {
              "description": "No provided or fallback module.",
              "enum": [false]
            },
            {
              "$ref": "#/definitions/SharedItem"
            }
          ]
        },
        "packageName": {
          "description": "Package name to determine required version from description file. This is only needed when package name can't be automatically determined from request.",
          "type": "string",
          "minLength": 1
        },
        "requiredVersion": {
          "description": "Version requirement from module in share scope.",
          "anyOf": [
            {
              "description": "No version requirement check.",
              "enum": [false]
            },
            {
              "description": "Version as string. Can be prefixed with '^' or '~' for minimum matches. Each part of the version should be separated by a dot '.'.",
              "type": "string"
            }
          ]
        },
        "shareKey": {
          "description": "Module is looked up under this key from the share scope.",
          "type": "string",
          "minLength": 1
        },
        "shareScope": {
          "description": "Share scope name.",
          "type": "string",
          "minLength": 1
        },
        "singleton": {
          "description": "Allow only a single version of the shared module in share scope (disabled by default).",
          "type": "boolean"
        },
        "strictVersion": {
          "description": "Do not accept shared module if version is not valid (defaults to yes, if local fallback module is available and shared module is not a singleton, otherwise no, has no effect if there is no required version specified).",
          "type": "boolean"
        },
        "version": {
          "description": "Version of the provided module. Will replace lower matching versions, but not higher.",
          "anyOf": [
            {
              "description": "Don't provide a version.",
              "enum": [false]
            },
            {
              "description": "Version as string. Each part of the version should be separated by a dot '.'.",
              "type": "string"
            }
          ]
        }
      }
    },
    "SharedItem": {
      "description": "A module that should be shared in the share scope.",
      "type": "string",
      "minLength": 1
    },
    "SharedObject": {
      "description": "Modules that should be shared in the share scope. Property names are used to match requested modules in this compilation. Relative requests are resolved, module requests are matched unresolved, absolute paths will match resolved requests. A trailing slash will match all requests with this prefix. In this case shareKey must also have a trailing slash.",
      "type": "object",
      "additionalProperties": {
        "description": "Modules that should be shared in the share scope.",
        "anyOf": [
          {
            "$ref": "#/definitions/SharedConfig"
          },
          {
            "$ref": "#/definitions/SharedItem"
          }
        ]
      }
    }
  }
}