add client options and cos

Author: ricardo-devis-agullo

website/static/schema.json

@@ -1,6 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "type": "object",
+  "title": "OpenComponents CLI Configuration",
+  "description": "Configuration file for the OpenComponents CLI tool. Used to configure registries and development mocks.",
   "properties": {
     "$schema": {
       "description": "A field for the [JSON schema](https://json-schema.org/) specification",
@@ -10,27 +12,54 @@
       ]
     },
     "registries": {
+      "description": "List of registry URLs where components will be published. These are the target registries for component deployment.",
       "type": "array",
       "items": {
-        "type": "string"
-      }
+        "type": "string",
+        "description": "URL of an OpenComponents registry (e.g., 'https://my-registry.com')"
+      },
+      "minItems": 1,
+      "example": [
+        "https://my-registry.com",
+        "https://staging-registry.com"
+      ]
+    },
+    "client": {
+      "description": "Custom URL for the oc-client-browser.js file to use during development. If specified, this URL will be used instead of the default bundled client library.",
+      "type": "string",
+      "format": "uri",
+      "example": "https://myregistry.com/oc-client/client.dev.js"
     },
     "mocks": {
+      "description": "Development configuration for mocking plugins that would normally be provided by production registries. Useful for local development and testing.",
       "type": "object",
       "properties": {
         "plugins": {
+          "description": "Plugin mocking configuration. Plugins are shared functions that components can use, provided by registries in production.",
           "type": "object",
           "properties": {
             "dynamic": {
+              "description": "Dynamic plugin mocks. Values are file paths to JavaScript modules that export 'register' and 'execute' functions. Use this when you need custom mock behavior.",
               "type": "object",
               "additionalProperties": {
-                "type": "string"
+                "type": "string",
+                "description": "Path to a JavaScript file that exports register and execute functions"
+              },
+              "example": {
+                "hash": "./mocks/hash-plugin.js",
+                "auth": "./mocks/auth-plugin.js"
               }
             },
             "static": {
+              "description": "Static plugin mocks. Values are static strings that will always be returned by the plugin. Use this for simple value mocking.",
               "type": "object",
               "additionalProperties": {
-                "type": "string"
+                "type": "string",
+                "description": "Static value that the plugin should always return"
+              },
+              "example": {
+                "hash": "mocked-hash-value",
+                "apiKey": "test-api-key-123"
               }
             }
           },
@@ -43,5 +72,24 @@
   "required": [
     "registries"
   ],
-  "additionalProperties": false
+  "additionalProperties": false,
+  "examples": [
+    {
+      "registries": [
+        "https://my-registry.com"
+      ],
+      "client": "https://cdn.example.com/oc-client-browser.js",
+      "mocks": {
+        "plugins": {
+          "static": {
+            "hash": "test-hash-value",
+            "apiKey": "dev-api-key"
+          },
+          "dynamic": {
+            "auth": "./mocks/auth-plugin.js"
+          }
+        }
+      }
+    }
+  ]
 }