@jbrowse/app-core 4.3.0 → 5.0.0-beta.10

package/esm/JBrowseConfig/RootConfiguration.d.ts

@@ -1,107 +1,152 @@
 import type PluginManager from '@jbrowse/core/PluginManager';
-export default function RootConfiguration({ pluginManager, }: {
+import type { ConfigurationSchemaDefinition } from '@jbrowse/core/configuration';
+/**
+ * #config JBrowseConfiguration
+ * #category root
+ * this is the entry under the `configuration` key
+ * e.g.
+ * ```json
+ * {
+ *   assemblies,
+ *   tracks,
+ *   configuration: { these entries here  }
+ * }
+ * ```
+ */
+export default function RootConfiguration({ pluginManager, extraConfigSlots, }: {
     pluginManager: PluginManager;
+    extraConfigSlots?: ConfigurationSchemaDefinition;
 }): import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-    rpc: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-        defaultDriver: {
-            type: string;
-            description: string;
+    readonly rpc: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly defaultDriver: {
+            type: "string";
+        } & {
             defaultValue: string;
         };
-        drivers: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").ITypeUnion<import("@jbrowse/mobx-state-tree").ModelCreationType<import("@jbrowse/mobx-state-tree/dist/internal").ExtractCFromProps<Record<string, any>>> | undefined, import("@jbrowse/mobx-state-tree").ModelSnapshotType<Record<string, any>>, ({} & Partial<import("@jbrowse/mobx-state-tree/dist/internal").ExtractCFromProps<Record<string, any>>> & import("@jbrowse/mobx-state-tree/dist/internal").NonEmptyObject) | undefined>>, [undefined]>;
-    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-    highResolutionScaling: {
-        type: string;
-        defaultValue: number;
-    };
-    formatDetails: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-        feature: {
-            type: string;
-            description: string;
-            defaultValue: {};
-            contextVariable: string[];
+        readonly workerCount: {
+            type: "number";
+        } & {
+            defaultValue: number;
         };
-        subfeatures: {
-            type: string;
-            description: string;
-            defaultValue: {};
-            contextVariable: string[];
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    readonly formatDetails: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly feature: {
+            type: "frozen";
+        } & {
+            defaultValue: unknown;
         };
-        depth: {
-            type: string;
-            defaultValue: number;
-            description: string;
+        readonly subfeatures: {
+            type: "frozen";
+        } & {
+            defaultValue: unknown;
         };
-        maxDepth: {
-            type: string;
-            defaultValue: number;
-            description: string;
+        readonly depth: {
+            type: "maybeNumber";
         };
-    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-    formatAbout: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-        config: {
-            type: string;
-            description: string;
-            defaultValue: {};
-            contextVariable: string[];
+        readonly maxDepth: {
+            type: "maybeNumber";
         };
-        hideUris: {
-            type: string;
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    readonly formatAbout: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly config: {
+            type: "frozen";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly hideUris: {
+            type: "boolean";
+        } & {
             defaultValue: boolean;
         };
-    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-    shareURL: {
-        type: string;
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    readonly shareURL: {
+        type: "string";
+    } & {
         defaultValue: string;
     };
-    disableAnalytics: {
-        type: string;
+    readonly disableAnalytics: {
+        type: "boolean";
+    } & {
         defaultValue: boolean;
     };
-    hierarchical: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-        sort: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-            trackNames: {
-                type: string;
+    readonly hierarchical: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly sort: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+            readonly trackNames: {
+                type: "boolean";
+            } & {
                 defaultValue: boolean;
             };
-            categories: {
-                type: string;
+            readonly categories: {
+                type: "boolean";
+            } & {
                 defaultValue: boolean;
             };
-        }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-        defaultFolderCategories: {
-            type: string;
-            description: string;
-            defaultValue: never[];
+        }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+        readonly defaultFolderCategories: {
+            type: "stringArray";
+        } & {
+            defaultValue: unknown;
         };
-        defaultCollapsed: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-            categoryNames: {
-                type: string;
-                defaultValue: never[];
+        readonly defaultCollapsed: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+            readonly categoryNames: {
+                type: "stringArray";
+            } & {
+                defaultValue: unknown;
             };
-            topLevelCategories: {
-                type: string;
+            readonly topLevelCategories: {
+                type: "boolean";
+            } & {
                 defaultValue: boolean;
             };
-            subCategories: {
-                type: string;
+            readonly subCategories: {
+                type: "boolean";
+            } & {
                 defaultValue: boolean;
             };
-        }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-    theme: {
-        type: string;
-        defaultValue: {};
+        }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    readonly preferences: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly animationMode: {
+            type: "stringEnum";
+        } & {
+            model: import("@jbrowse/mobx-state-tree").ISimpleType<"disabled" | "enabled" | "system">;
+        } & {
+            defaultValue: string;
+        };
+        readonly scrollZoom: {
+            type: "boolean";
+        } & {
+            defaultValue: boolean;
+        };
+        readonly numberGrouping: {
+            type: "boolean";
+        } & {
+            defaultValue: boolean;
+        };
+        readonly useWorkspaces: {
+            type: "boolean";
+        } & {
+            defaultValue: boolean;
+        };
+        readonly developerMode: {
+            type: "boolean";
+        } & {
+            defaultValue: boolean;
+        };
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    readonly theme: {
+        type: "frozen";
+    } & {
+        defaultValue: unknown;
     };
-    extraThemes: {
-        type: string;
-        defaultValue: {};
+    readonly extraThemes: {
+        type: "frozen";
+    } & {
+        defaultValue: unknown;
     };
-    logoPath: {
-        type: string;
-        defaultValue: {
-            uri: string;
-            locationType: string;
-        };
+    readonly logoPath: {
+        type: "fileLocation";
+    } & {
+        defaultValue: unknown;
     };
-}, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
+}, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;

package/esm/JBrowseConfig/RootConfiguration.js

@@ -1,40 +1,112 @@
 import { ConfigurationSchema } from '@jbrowse/core/configuration';
 import RpcManager from '@jbrowse/core/rpc/RpcManager';
-import { FormatAboutConfigSchemaFactory, FormatDetailsConfigSchemaFactory, HierarchicalConfigSchemaFactory, } from '@jbrowse/product-core';
-export default function RootConfiguration({ pluginManager, }) {
+import { FormatAboutConfigSchemaFactory, FormatDetailsConfigSchemaFactory, HierarchicalConfigSchemaFactory, PreferencesConfigSchemaFactory, } from '@jbrowse/product-core';
+import { DEFAULT_SHARE_URL } from './defaultShareUrl.js';
+/**
+ * #config JBrowseConfiguration
+ * #category root
+ * this is the entry under the `configuration` key
+ * e.g.
+ * ```json
+ * {
+ *   assemblies,
+ *   tracks,
+ *   configuration: { these entries here  }
+ * }
+ * ```
+ */
+export default function RootConfiguration({ pluginManager, extraConfigSlots = {}, }) {
     return ConfigurationSchema('Root', {
+        ...extraConfigSlots,
+        /**
+         * #slot configuration.rpc
+         * configuration for the RPC system that runs data adapters in web workers,
+         * see RpcOptions
+         */
         rpc: RpcManager.configSchema,
-        highResolutionScaling: {
-            type: 'number',
-            defaultValue: 2,
-        },
+        /**
+         * #slot configuration.formatDetails
+         * jexl callbacks that add, rewrite or hide fields in the feature-details
+         * panel of every track at once. A track can set the same ones on its own
+         * `formatDetails` and override individual keys.
+         */
         formatDetails: FormatDetailsConfigSchemaFactory(),
+        /**
+         * #slot configuration.formatAbout
+         * jexl callbacks that add, rewrite or hide fields in the About dialog of
+         * every track at once. A track can set the same ones on its own
+         * `formatAbout` and override individual keys.
+         */
         formatAbout: FormatAboutConfigSchemaFactory(),
+        /**
+         * #slot configuration.shareURL
+         * URL of the session-sharing backend used by the Share button, a
+         * JBrowse-hosted service by default
+         */
         shareURL: {
             type: 'string',
-            defaultValue: 'https://share.jbrowse.org/api/v1/',
+            defaultValue: DEFAULT_SHARE_URL,
+            advanced: true,
         },
+        /**
+         * #slot configuration.disableAnalytics
+         * disables collection of anonymous usage analytics
+         */
         disableAnalytics: {
             type: 'boolean',
             defaultValue: false,
+            advanced: true,
         },
+        /**
+         * #slot configuration.hierarchical
+         * configuration for the hierarchical track selector, controlling sorting
+         * and default categories, see HierarchicalConfigSchema
+         */
         hierarchical: HierarchicalConfigSchemaFactory(),
+        /**
+         * #slot configuration.preferences
+         * user preferences such as scroll-to-zoom and animation behavior, see
+         * PreferencesConfigSchema
+         */
+        preferences: PreferencesConfigSchemaFactory(),
+        /**
+         * #slot configuration.theme
+         */
         theme: {
             type: 'frozen',
+            description: 'Material UI theme overrides applied to the JBrowse UI',
             defaultValue: {},
         },
+        /**
+         * #slot configuration.extraThemes
+         */
         extraThemes: {
             type: 'frozen',
+            description: 'additional named themes the user can switch between',
             defaultValue: {},
+            advanced: true,
         },
+        /**
+         * #slot configuration.logoPath
+         */
         logoPath: {
             type: 'fileLocation',
+            description: 'path to a custom logo image displayed in the app header',
             defaultValue: {
                 uri: '',
                 locationType: 'UriLocation',
             },
+            advanced: true,
         },
+        /**
+         * #slotAnnot
+         * this is a collection of 'namespaced' configs e.g. configuration.YourPlugin.slot
+         */
         ...pluginManager.pluginConfigurationNamespacedSchemas(),
+        /**
+         * #slotAnnot
+         * this is a collection of 'unnamespaced' configs e.g. configuration.slot
+         */
         ...pluginManager.pluginConfigurationUnnamespacedSchemas(),
     });
 }

package/esm/JBrowseConfig/defaultShareUrl.d.ts

@@ -0,0 +1 @@
+export declare const DEFAULT_SHARE_URL = "https://share.jbrowse.org/api/v1/";

package/esm/JBrowseConfig/defaultShareUrl.js

@@ -0,0 +1,5 @@
+// The JBrowse-hosted session-sharing backend. Single source of truth for both
+// the write path (the root config's `shareURL` default, read via getConf) and
+// the SessionLoader read path (which reads the raw config snapshot before config
+// is initialized), so the two can't drift onto different endpoints.
+export const DEFAULT_SHARE_URL = 'https://share.jbrowse.org/api/v1/';