@jbrowse/plugin-linear-genome-view 4.3.0 → 5.0.0-beta.10

package/esm/FeatureTrack/configSchema.d.ts

@@ -1,85 +1,216 @@
 import type PluginManager from '@jbrowse/core/PluginManager';
-declare const configSchema: (pluginManager: PluginManager) => import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{}, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-    name: {
-        description: string;
-        type: string;
-        defaultValue: string;
-    };
+/**
+ * #config FeatureTrack
+ * #category track
+ * used for basic gene and feature tracks, generally used with LinearBasicDisplay
+ *
+ * #example
+ * A minimal hand-authored entry in the top-level `tracks` array — `adapter`
+ * points at the data file, and the track opens with a `LinearBasicDisplay`:
+ * ```js
+ * {
+ *   type: 'FeatureTrack',
+ *   trackId: 'genes',
+ *   name: 'Genes',
+ *   assemblyNames: ['hg38'],
+ *   adapter: {
+ *     type: 'Gff3TabixAdapter',
+ *     uri: 'https://example.com/genes.sorted.gff.gz',
+ *   },
+ * }
+ * ```
+ *
+ * #example
+ * The same track, colored. Rather than writing out the full `displays` array,
+ * you can put appearance settings in a `displayDefaults` object — JBrowse works
+ * out which display they belong to and applies them for you (here, the track's
+ * `LinearBasicDisplay`), so you don't have to know display names. A `jexl:`
+ * value gives per-feature coloring:
+ * ```js
+ * {
+ *   type: 'FeatureTrack',
+ *   trackId: 'genes',
+ *   name: 'Genes',
+ *   assemblyNames: ['hg38'],
+ *   adapter: {
+ *     type: 'Gff3TabixAdapter',
+ *     uri: 'https://example.com/genes.sorted.gff.gz',
+ *   },
+ *   displayDefaults: { color: "jexl:feature.type=='CDS'?'red':'blue'" },
+ * }
+ * ```
+ */
+declare const configSchema: (pluginManager: PluginManager) => import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+    adapter: import("@jbrowse/core/PluginManager").PluggableConfigSchemaType;
     assemblyNames: {
-        description: string;
-        type: string;
-        defaultValue: string[];
+        type: "stringArray";
+    } & {
+        defaultValue: unknown;
+    };
+    category: {
+        type: "stringArray";
+    } & {
+        defaultValue: unknown;
     };
     description: {
-        description: string;
-        type: string;
+        type: "string";
+    } & {
         defaultValue: string;
     };
-    category: {
-        description: string;
-        type: string;
-        defaultValue: never[];
-    };
+    displays: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/core/PluginManager").PluggableConfigSchemaType>;
+    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, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    formatDetails: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly feature: {
+            type: "frozen";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly subfeatures: {
+            type: "frozen";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly depth: {
+            type: "maybeNumber";
+        };
+        readonly maxDepth: {
+            type: "maybeNumber";
+        };
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
     metadata: {
-        type: string;
-        description: string;
-        defaultValue: {};
+        type: "frozen";
+    } & {
+        defaultValue: unknown;
     };
-    rpcDriverName: {
-        type: string;
-        description: string;
+    name: {
+        type: "string";
+    } & {
         defaultValue: string;
     };
-    adapter: import("@jbrowse/mobx-state-tree").IAnyModelType;
     textSearching: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-        indexingAttributes: {
-            type: string;
-            description: string;
-            defaultValue: string[];
-        };
-        indexingFeatureTypesToExclude: {
-            type: string;
-            description: string;
-            defaultValue: string[];
-        };
-        textSearchAdapter: import("@jbrowse/mobx-state-tree").IAnyModelType;
-    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-    displays: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IAnyModelType>;
-    formatDetails: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-        feature: {
-            type: string;
-            description: string;
-            defaultValue: {};
-            contextVariable: string[];
-        };
-        subfeatures: {
-            type: string;
-            description: string;
-            defaultValue: {};
-            contextVariable: string[];
-        };
-        depth: {
-            type: string;
-            defaultValue: number;
-            description: string;
-        };
-        maxDepth: {
-            type: string;
-            defaultValue: number;
-            description: string;
-        };
-    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
-    formatAbout: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-        config: {
-            type: string;
-            description: string;
-            defaultValue: {};
-            contextVariable: string[];
-        };
-        hideUris: {
-            type: string;
+        readonly indexingAttributes: {
+            type: "stringArray";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly indexingFeatureTypesToExclude: {
+            type: "stringArray";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly indexingFeatureTypesToInclude: {
+            type: "stringArray";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly textSearchAdapter: import("@jbrowse/mobx-state-tree").ITypeUnion<any, any, import("@jbrowse/core/configuration").PluggableConfigNode | undefined>;
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    trackId: {
+        type: "string";
+    } & {
+        defaultValue: string;
+    };
+    type: {
+        type: "string";
+    } & {
+        defaultValue: string;
+    };
+}, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+    readonly name: {
+        type: "string";
+    } & {
+        defaultValue: string;
+    };
+    readonly assemblyNames: {
+        type: "stringArray";
+    } & {
+        defaultValue: unknown;
+    };
+    readonly description: {
+        type: "string";
+    } & {
+        defaultValue: string;
+    };
+    readonly category: {
+        type: "stringArray";
+    } & {
+        defaultValue: unknown;
+    };
+    readonly metadata: {
+        type: "frozen";
+    } & {
+        defaultValue: unknown;
+    };
+    readonly adapter: import("@jbrowse/core/PluginManager").PluggableConfigSchemaType;
+    readonly textSearching: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly indexingAttributes: {
+            type: "stringArray";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly indexingFeatureTypesToExclude: {
+            type: "stringArray";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly indexingFeatureTypesToInclude: {
+            type: "stringArray";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly textSearchAdapter: import("@jbrowse/mobx-state-tree").ITypeUnion<any, any, import("@jbrowse/core/configuration").PluggableConfigNode | undefined>;
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    readonly displays: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/core/PluginManager").PluggableConfigSchemaType>;
+    readonly formatDetails: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
+        readonly feature: {
+            type: "frozen";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly subfeatures: {
+            type: "frozen";
+        } & {
+            defaultValue: unknown;
+        };
+        readonly depth: {
+            type: "maybeNumber";
+        };
+        readonly maxDepth: {
+            type: "maybeNumber";
+        };
+    }, 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>>;
-}, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, "trackId">>, "trackId">>;
+    }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined, undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
+    type: {
+        type: "string";
+    } & {
+        defaultValue: string;
+    };
+    trackId: {
+        type: "string";
+    } & {
+        defaultValue: string;
+    };
+}, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, "trackId", true, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>, "trackId", undefined, import("@jbrowse/core/configuration").ConfigurationSchemaRequirement<Partial<Record<string, string[]>>, string>, any>>;
 export default configSchema;

package/esm/FeatureTrack/configSchema.js

@@ -1,8 +1,54 @@
 import { ConfigurationSchema } from '@jbrowse/core/configuration';
 import { createBaseTrackConfig } from '@jbrowse/core/pluggableElementTypes';
-function x() { }
+/**
+ * #config FeatureTrack
+ * #category track
+ * used for basic gene and feature tracks, generally used with LinearBasicDisplay
+ *
+ * #example
+ * A minimal hand-authored entry in the top-level `tracks` array — `adapter`
+ * points at the data file, and the track opens with a `LinearBasicDisplay`:
+ * ```js
+ * {
+ *   type: 'FeatureTrack',
+ *   trackId: 'genes',
+ *   name: 'Genes',
+ *   assemblyNames: ['hg38'],
+ *   adapter: {
+ *     type: 'Gff3TabixAdapter',
+ *     uri: 'https://example.com/genes.sorted.gff.gz',
+ *   },
+ * }
+ * ```
+ *
+ * #example
+ * The same track, colored. Rather than writing out the full `displays` array,
+ * you can put appearance settings in a `displayDefaults` object — JBrowse works
+ * out which display they belong to and applies them for you (here, the track's
+ * `LinearBasicDisplay`), so you don't have to know display names. A `jexl:`
+ * value gives per-feature coloring:
+ * ```js
+ * {
+ *   type: 'FeatureTrack',
+ *   trackId: 'genes',
+ *   name: 'Genes',
+ *   assemblyNames: ['hg38'],
+ *   adapter: {
+ *     type: 'Gff3TabixAdapter',
+ *     uri: 'https://example.com/genes.sorted.gff.gz',
+ *   },
+ *   displayDefaults: { color: "jexl:feature.type=='CDS'?'red':'blue'" },
+ * }
+ * ```
+ */
 const configSchema = (pluginManager) => ConfigurationSchema('FeatureTrack', {}, {
+    /**
+     * #baseConfiguration
+     */
     baseConfiguration: createBaseTrackConfig(pluginManager),
+    /**
+     * #identifier
+     */
     explicitIdentifier: 'trackId',
 });
 export default configSchema;

package/esm/FeatureTrack/index.js

@@ -1,5 +1,5 @@
 import { TrackType, createBaseTrackModel, } from '@jbrowse/core/pluggableElementTypes';
-import configSchemaF from "./configSchema.js";
+import configSchemaF from './configSchema.js';
 export default function FeatureTrackF(pm) {
     pm.addTrackType(() => {
         const configSchema = configSchemaF(pm);

package/esm/LaunchLinearGenomeView/index.d.ts

@@ -1,2 +1,16 @@
+import type { InitState, LinearGenomeViewLaunchProps } from '../LinearGenomeView/types.ts';
 import type PluginManager from '@jbrowse/core/PluginManager';
+import type { AbstractViewContainer } from '@jbrowse/core/util';
+export type LaunchLinearGenomeViewArgs = Partial<InitState> & LinearGenomeViewLaunchProps & {
+    session: AbstractViewContainer;
+    id?: string;
+};
+declare module '@jbrowse/core/PluginManager' {
+    interface ExtensionPointRegistry {
+        'LaunchView-LinearGenomeView': {
+            args: LaunchLinearGenomeViewArgs;
+            result: LaunchLinearGenomeViewArgs;
+        };
+    }
+}
 export default function LaunchLinearGenomeViewF(pluginManager: PluginManager): void;

package/esm/LaunchLinearGenomeView/index.js

@@ -1,17 +1,11 @@
 export default function LaunchLinearGenomeViewF(pluginManager) {
-    pluginManager.addToExtensionPoint('LaunchView-LinearGenomeView', async ({ session, assembly, loc, tracks = [], tracklist, nav, highlight, }) => {
-        if (!assembly) {
+    /** #extensionPoint LaunchView-LinearGenomeView | async | Programmatically launch a linear genome view */
+    pluginManager.addToExtensionPoint('LaunchView-LinearGenomeView', args => {
+        const { session, ...spec } = args;
+        if (!spec.assembly) {
             throw new Error('No assembly provided when launching linear genome view');
         }
-        session.addView('LinearGenomeView', {
-            init: {
-                assembly,
-                loc,
-                tracks,
-                tracklist,
-                nav,
-                highlight,
-            },
-        });
+        session.addView('LinearGenomeView', spec);
+        return args;
     });
 }

package/esm/LinearGenomeView/afterAttach.d.ts

@@ -1,5 +1,23 @@
 import type { LinearGenomeViewModel } from './model.ts';
+import type { InitState } from './types.ts';
+import type { AbstractSessionModel, AssemblyHost, NotificationSink } from '@jbrowse/core/util';
+/**
+ * Add an init blob's `highlight` entries to the session, coercing each
+ * locstring or wire-format object and reporting a bad one without taking out
+ * its siblings. An entry without an assembly takes the launch's.
+ *
+ * Exported because a LinearSyntenyView row is a LinearGenomeView that does NOT
+ * go through this file's init autorun — the synteny view builds each row's
+ * snapshot and navigates it itself — so the row's own `highlight` had nowhere
+ * to be applied and was dropped in silence.
+ */
+export declare function applyInitHighlights(session: AssemblyHost & NotificationSink & Pick<AbstractSessionModel, 'addHighlight'>, init: Pick<InitState, 'highlight' | 'assembly'>): void;
+/**
+ * Autorun that handles the init state - navigating to initial location,
+ * showing tracks, etc.
+ */
 export declare function setupInitAutorun(self: LinearGenomeViewModel): void;
-export declare function setupCoarseDynamicBlocksAutorun(self: LinearGenomeViewModel): void;
-export declare function setupLocalStorageAutorun(self: LinearGenomeViewModel): void;
+/**
+ * Sets up all afterAttach autoruns for the LinearGenomeView
+ */
 export declare function doAfterAttach(self: LinearGenomeViewModel): void;