@jupyterlab/settingregistry 4.0.0-alpha.9 → 4.0.0-beta.1

package/lib/plugin-schema.json

@@ -56,6 +56,13 @@
             },
             "additionalProperties": false
         },
+        "jupyter.lab.metadataforms": {
+            "items": {
+                "$ref": "#/definitions/metadataForm"
+            },
+            "type": "array",
+            "default": []
+        },
         "jupyter.lab.setting-deprecated": {
             "type": "boolean",
             "default": false
@@ -295,6 +302,87 @@
             "required": ["name"],
             "additionalProperties": false,
             "type": "object"
+        },
+        "metadataForm": {
+            "type": "object",
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "description": "The section ID"
+                },
+                "metadataSchema": {
+                    "type": "object",
+                    "items": {
+                        "$ref": "#/definitions/metadataSchema"
+                    }
+                },
+                "uiSchema": {
+                    "type": "object"
+                },
+                "metadataOptions": {
+                    "type": "object",
+                    "items": {
+                        "$ref": "#/definitions/metadataOptions"
+                    }
+                },
+                "label": {
+                    "type": "string",
+                    "description": "The section label"
+                },
+                "rank": {
+                    "type": "integer",
+                    "description": "The rank of the section in the right panel"
+                },
+                "showModified": {
+                    "type": "boolean",
+                    "description": "Whether to show modified values from defaults"
+                }
+            },
+            "required": ["id", "metadataSchema"]
+        },
+        "metadataSchema": {
+            "properties": {
+                "properties": {
+                    "type": "object",
+                    "description": "The property set up by extension",
+                    "properties": {
+                        "title": {
+                            "type": "string"
+                        },
+                        "description": {
+                            "type": "string"
+                        },
+                        "type": {
+                            "type": "string"
+                        }
+                    }
+                }
+            },
+            "type": "object",
+            "required": ["properties"]
+        },
+        "metadataOptions": {
+            "properties": {
+                "customRenderer": {
+                    "type": "string"
+                },
+                "metadataLevel": {
+                    "type": "string",
+                    "enum": ["cell", "notebook"],
+                    "default": "cell"
+                },
+                "cellTypes": {
+                    "type": "array",
+                    "items": {
+                        "type": "string",
+                        "enum": ["code", "markdown", "raw"]
+                    }
+                },
+                "writeDefault": {
+                    "type": "boolean"
+                }
+            },
+            "type": "object"
         }
     }
 }

package/lib/settingregistry.d.ts

@@ -29,18 +29,14 @@ export declare namespace ISchemaValidator {
      * A schema validation error definition.
      */
     interface IError {
-        /**
-         * The path in the data where the error occurred.
-         */
-        dataPath: string;
         /**
          * The keyword whose validation failed.
          */
-        keyword: string;
+        keyword: string | string[];
         /**
          * The error message.
          */
-        message: string;
+        message?: string;
         /**
          * Optional parameter metadata that might be included in an error.
          */
@@ -49,6 +45,26 @@ export declare namespace ISchemaValidator {
          * The path in the schema where the error occurred.
          */
         schemaPath: string;
+        /**
+         * @todo handle new fields from ajv8
+         **/
+        schema?: unknown;
+        /**
+         * @todo handle new fields from ajv8
+         **/
+        instancePath: string;
+        /**
+         * @todo handle new fields from ajv8
+         **/
+        propertyName?: string;
+        /**
+         * @todo handle new fields from ajv8
+         **/
+        data?: unknown;
+        /**
+         * @todo handle new fields from ajv8
+         **/
+        parentSchema?: unknown;
     }
 }
 /**
@@ -137,10 +153,12 @@ export declare class SettingRegistry implements ISettingRegistry {
      *
      * @param plugin - The name of the plugin whose settings are being loaded.
      *
+     * @param forceTransform - An optional parameter to force replay the transforms methods.
+     *
      * @returns A promise that resolves with a plugin settings object or rejects
      * if the plugin is not found.
      */
-    load(plugin: string): Promise<ISettingRegistry.ISettings>;
+    load(plugin: string, forceTransform?: boolean): Promise<ISettingRegistry.ISettings>;
     /**
      * Reload a plugin's settings into the registry even if they already exist.
      *
@@ -228,11 +246,37 @@ export declare class SettingRegistry implements ISettingRegistry {
     private _ready;
     private _timeout;
     private _transformers;
+    private _unloadedPlugins;
+}
+/**
+ * Base settings specified by a JSON schema.
+ */
+export declare class BaseSettings<T extends ISettingRegistry.IProperty = ISettingRegistry.IProperty> {
+    constructor(options: {
+        schema: T;
+    });
+    /**
+     * The plugin's schema.
+     */
+    get schema(): T;
+    /**
+     * Checks if any fields are different from the default value.
+     */
+    isDefault(user: ReadonlyPartialJSONObject): boolean;
+    /**
+     * Calculate the default value of a setting by iterating through the schema.
+     *
+     * @param key - The name of the setting whose default value is calculated.
+     *
+     * @returns A calculated default JSON value for a specific setting.
+     */
+    default(key?: string): PartialJSONValue | undefined;
+    private _schema;
 }
 /**
  * A manager for a specific plugin's settings.
  */
-export declare class Settings implements ISettingRegistry.ISettings {
+export declare class Settings extends BaseSettings<ISettingRegistry.ISchema> implements ISettingRegistry.ISettings {
     /**
      * Instantiate a new plugin settings manager.
      */
@@ -258,18 +302,13 @@ export declare class Settings implements ISettingRegistry.ISettings {
      */
     get isDisposed(): boolean;
     get plugin(): ISettingRegistry.IPlugin;
-    /**
-     * The plugin's schema.
-     */
-    get schema(): ISettingRegistry.ISchema;
     /**
      * The plugin settings raw text value.
      */
     get raw(): string;
     /**
-     * Checks if any fields are different from the default value.
+     * Whether the settings have been modified by the user or not.
      */
-    isDefault(user: ReadonlyPartialJSONObject): boolean;
     get isModified(): boolean;
     /**
      * The user settings.
@@ -283,14 +322,6 @@ export declare class Settings implements ISettingRegistry.ISettings {
      * Return the defaults in a commented JSON format.
      */
     annotatedDefaults(): string;
-    /**
-     * Calculate the default value of a setting by iterating through the schema.
-     *
-     * @param key - The name of the setting whose default value is calculated.
-     *
-     * @returns A calculated default JSON value for a specific setting.
-     */
-    default(key?: string): PartialJSONValue | undefined;
     /**
      * Dispose of the plugin settings resources.
      */