Consolidate the buffer information into a single object, and add a new encoding attribute

We initially have the ‘hex’ and ‘base64’ encodings.

We unpublished the 0.2.0 package so we could replace version 2 of the spec with these updates, so we bump the package number to 0.3.0.

Author: jasongrout

jupyter-widgets-schema/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jupyter-widgets-schema",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Schemas for the Jupyter interactive Widgets",
   "main": "index.js",
   "scripts": {

jupyter-widgets-schema/v2/state.schema.json

@@ -14,7 +14,7 @@
             "type": "number"
         },
         "state": {
-            "description": "Model State for All Widget Models",
+            "description": "Model State for All Widget Models - keys are model ids, values are model state",
             "type": "object",
             "additionalProperties" : {
                 "type": "object",
@@ -35,25 +35,37 @@
                         "description" : "Serialized state of the model",
                         "type": "object"
                     },
-                    "buffer_paths": {
-                        "description" : "Array of paths in the state for the corresponding buffers",
-                        "type": "array",
-                        "items": {
-                            "description": "A path for a binary buffer value.",
-                            "type": "array",
-                            "items": {
-                                "description": "An object key or array index",
-                                "anyOf": [{"type": "string"}, {"type": "number"}]
-                            }
-                        }
-                    },
                     "buffers": {
-                        "description" : "Array of base64-encoded binary buffers",
-                        "type": "array",
-                        "items": {
-                            "description": "A base64-encoded binary buffer",
-                            "type": "string"
-                        }
+                        "description": "Binary buffers in the state",
+                        "type": "object",
+                        "properties": {
+                            "paths": {
+                                "description" : "Array of paths in the state for the corresponding buffers",
+                                "type": "array",
+                                "items": {
+                                    "description": "A path for a binary buffer value.",
+                                    "type": "array",
+                                    "items": {
+                                        "description": "An object key or array index",
+                                        "type": ["string", "number"]
+                                    }
+                                }
+                            },
+                            "data": {
+                                "description" : "Array of encoded binary buffers, encoded as specified in the 'encoding' property",
+                                "type": "array"
+                            },
+                            "encoding": {
+                                "description": "The encoding of each item in the data property",
+                                "type": "string",
+                                "oneOf": [
+                                    {"enum": ["hex"], "description": "Base 16 encoding, as specified in RFC 4648, section 8 (https://tools.ietf.org/html/rfc4648#section-8)"},
+                                    {"enum": ["base64"], "description": "Base 64 encoding, as specified in RFC 4648, section 4 (https://tools.ietf.org/html/rfc4648#section-4)"}
+
+                                ]
+                            }
+                        },
+                        "required": ["paths", "data", "encoding"]
                     }
                 },
                 "required": [ "model_name", "model_module", "state" ]