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

package/esm/JBrowseConfig/index.d.ts

@@ -1,117 +1,183 @@
-import type { PluginDefinition } from '@jbrowse/core/PluginLoader';
 import type PluginManager from '@jbrowse/core/PluginManager';
-import type { AnyConfigurationSchemaType } from '@jbrowse/core/configuration';
-export declare function JBrowseConfigF({ pluginManager, assemblyConfigSchema, }: {
+import type { AnyConfigurationSchemaType, ConfigurationSchemaDefinition } from '@jbrowse/core/configuration';
+import type { PluginDefinition } from '@jbrowse/core/pluginDefinitions';
+export { DEFAULT_SHARE_URL } from './defaultShareUrl.ts';
+/**
+ * #config JBrowseRootConfig
+ * #category root
+ *
+ * this is a config model representing a config.json (for jbrowse-web) or
+ * somefile.jbrowse (for jbrowse-desktop, where configs have the .jbrowse
+ * extension)
+ *
+ * also includes any pluginManager.pluginConfigurationSchemas(), so plugins
+ * that have a configurationSchema field on their class are mixed into this
+ * object
+ */
+export declare function JBrowseConfigF({ pluginManager, assemblyConfigSchema, extraConfigSlots, }: {
     pluginManager: PluginManager;
     assemblyConfigSchema: AnyConfigurationSchemaType;
-    adminMode?: boolean;
+    extraConfigSlots?: ConfigurationSchemaDefinition;
 }): import("@jbrowse/mobx-state-tree").IModelType<{
     configuration: 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>>;
+    /**
+     * #slot
+     * defines plugins of the format
+     * ```typescript
+     * type PluginDefinition=
+     *    { umdUrl: string, name:string } |
+     *    { url: string, name: string } |
+     *    { esmUrl: string } |
+     *    { umdLoc: { uri: string } } |
+     *    { esmLoc: { uri: string } } |
+     *    { storePlugin: string }
+     * ```
+     */
     plugins: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<PluginDefinition, PluginDefinition, PluginDefinition>>;
+    /**
+     * #slot
+     * configuration of the assemblies in the instance, see BaseAssembly
+     */
     assemblies: import("@jbrowse/mobx-state-tree").IArrayType<AnyConfigurationSchemaType>;
+    /**
+     * #slot
+     * track configuration is an array of track config schemas. multiple
+     * instances of a track can exist that use the same configuration.
+     * Always uses frozen for performance - editing creates temporary MST models.
+     */
     tracks: import("@jbrowse/mobx-state-tree").IType<{
         [key: string]: unknown;
         trackId: string;
@@ -122,9 +188,34 @@ export declare function JBrowseConfigF({ pluginManager, assemblyConfigSchema, }:
         [key: string]: unknown;
         trackId: string;
     }[]>;
-    internetAccounts: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IAnyModelType>;
-    aggregateTextSearchAdapters: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IAnyModelType>;
-    connections: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IAnyModelType>;
+    /**
+     * #slot
+     * configuration for internet accounts, see InternetAccounts
+     */
+    internetAccounts: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/core/PluginManager").PluggableConfigSchemaType>;
+    /**
+     * #slot
+     * search indexes covering whole assemblies, as `jbrowse text-index` writes
+     * them or any pluggable text search adapter. A trix index can be just its
+     * `.ix` (`["trix/hg38.ix"]`), which takes the config's assembly when it
+     * has one; with several, write `{ uri, assemblyNames }`.
+     */
+    aggregateTextSearchAdapters: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/core/PluginManager").PluggableConfigSchemaType>;
+    /**
+     * #slot
+     * configuration for connections
+     */
+    connections: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/core/PluginManager").PluggableConfigSchemaType>;
+    /**
+     * #slot
+     * the session loaded when no session is otherwise specified, e.g. the
+     * initial view shown on first load
+     */
     defaultSession: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IType<any, any, any>, [undefined]>;
+    /**
+     * #slot
+     * named sessions bundled with the config that a user can open from the
+     * session selector
+     */
     preConfiguredSessions: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<any, any, any>>;
 }, {}, import("@jbrowse/mobx-state-tree")._NotCustomized, import("@jbrowse/mobx-state-tree")._NotCustomized>;

package/esm/JBrowseConfig/index.js

@@ -1,19 +1,81 @@
 import { types } from '@jbrowse/mobx-state-tree';
-import RootConfiguration from "./RootConfiguration.js";
-export function JBrowseConfigF({ pluginManager, assemblyConfigSchema, }) {
+import RootConfiguration from './RootConfiguration.js';
+export { DEFAULT_SHARE_URL } from './defaultShareUrl.js';
+/**
+ * #config JBrowseRootConfig
+ * #category root
+ *
+ * this is a config model representing a config.json (for jbrowse-web) or
+ * somefile.jbrowse (for jbrowse-desktop, where configs have the .jbrowse
+ * extension)
+ *
+ * also includes any pluginManager.pluginConfigurationSchemas(), so plugins
+ * that have a configurationSchema field on their class are mixed into this
+ * object
+ */
+export function JBrowseConfigF({ pluginManager, assemblyConfigSchema, extraConfigSlots, }) {
     return types.model('JBrowseConfig', {
         configuration: RootConfiguration({
             pluginManager,
+            extraConfigSlots,
         }),
+        /**
+         * #slot
+         * defines plugins of the format
+         * ```typescript
+         * type PluginDefinition=
+         *    { umdUrl: string, name:string } |
+         *    { url: string, name: string } |
+         *    { esmUrl: string } |
+         *    { umdLoc: { uri: string } } |
+         *    { esmLoc: { uri: string } } |
+         *    { storePlugin: string }
+         * ```
+         */
         plugins: types.array(types.frozen()),
+        /**
+         * #slot
+         * configuration of the assemblies in the instance, see BaseAssembly
+         */
         assemblies: types.array(assemblyConfigSchema),
+        /**
+         * #slot
+         * track configuration is an array of track config schemas. multiple
+         * instances of a track can exist that use the same configuration.
+         * Always uses frozen for performance - editing creates temporary MST models.
+         */
         tracks: types.frozen([]),
+        /**
+         * #slot
+         * configuration for internet accounts, see InternetAccounts
+         */
         internetAccounts: types.array(pluginManager.pluggableConfigSchemaType('internet account')),
+        /**
+         * #slot
+         * search indexes covering whole assemblies, as `jbrowse text-index` writes
+         * them or any pluggable text search adapter. A trix index can be just its
+         * `.ix` (`["trix/hg38.ix"]`), which takes the config's assembly when it
+         * has one; with several, write `{ uri, assemblyNames }`.
+         */
         aggregateTextSearchAdapters: types.array(pluginManager.pluggableConfigSchemaType('text search adapter')),
+        /**
+         * #slot
+         * configuration for connections
+         */
         connections: types.array(pluginManager.pluggableConfigSchemaType('connection')),
+        /**
+         * #slot
+         * the session loaded when no session is otherwise specified, e.g. the
+         * initial view shown on first load
+         */
         defaultSession: types.optional(types.frozen(), {
             name: 'New Session',
         }),
+        /**
+         * #slot
+         * named sessions bundled with the config that a user can open from the
+         * session selector
+         */
         preConfiguredSessions: types.array(types.frozen()),
         ...pluginManager.pluginConfigurationRootSchemas(),
     });