@jbrowse/app-core 5.0.0-beta.1 → 5.0.0-beta.3

package/esm/JBrowseConfig/RootConfiguration.d.ts

@@ -163,6 +163,10 @@ export default function RootConfiguration({ pluginManager, extraConfigSlots, }:
             readonly type: "boolean";
             readonly defaultValue: false;
         };
+        readonly developerMode: {
+            readonly type: "boolean";
+            readonly defaultValue: false;
+        };
     }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
     /**
      * #slot configuration.theme

package/esm/JBrowseConfig/index.d.ts

@@ -127,6 +127,10 @@ export declare function JBrowseConfigF({ pluginManager, assemblyConfigSchema, ex
                 readonly type: "boolean";
                 readonly defaultValue: false;
             };
+            readonly developerMode: {
+                readonly type: "boolean";
+                readonly defaultValue: false;
+            };
         }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
         readonly theme: {
             readonly type: "frozen";

package/esm/JBrowseModel/index.d.ts

@@ -116,6 +116,10 @@ export declare function JBrowseModelF({ pluginManager, assemblyConfigSchema, ext
                 readonly type: "boolean";
                 readonly defaultValue: false;
             };
+            readonly developerMode: {
+                readonly type: "boolean";
+                readonly defaultValue: false;
+            };
         }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, undefined>>;
         readonly theme: {
             readonly type: "frozen";

package/esm/JbApi/index.d.ts

@@ -0,0 +1,2 @@
+export { createJbApi, ensureReExports, safeJson, sessionOf, undeliveredNotifications, waitReady, } from './jbApi.ts';
+export type { JbApi } from './jbApi.ts';

package/esm/JbApi/index.js

@@ -0,0 +1 @@
+export { createJbApi, ensureReExports, safeJson, sessionOf, undeliveredNotifications, waitReady, } from './jbApi.js';

package/esm/JbApi/jbApi.d.ts

@@ -0,0 +1,322 @@
+import { getConf, readConfObject } from '@jbrowse/core/configuration';
+import { getFeatureAdapterOrThrow } from '@jbrowse/core/data_adapters/getFeatureAdapter';
+import { getRpcSessionId, parseLocString, renameRegionsIfNeeded } from '@jbrowse/core/util';
+import { createStopToken, stopStopToken } from '@jbrowse/core/util/stopToken';
+import * as mst from '@jbrowse/mobx-state-tree';
+import * as mobx from 'mobx';
+import type PluginManager from '@jbrowse/core/PluginManager';
+import type { AnyConfigurationModel } from '@jbrowse/core/configuration';
+import type { AbstractSessionModel, AbstractViewModel } from '@jbrowse/core/util/types';
+import type { IStateTreeNode } from '@jbrowse/mobx-state-tree';
+/**
+ * What jb.getFeatures may pull before it refuses. An explicit request wins so
+ * an agent can mean it; otherwise the adapter's own declared limit, so this
+ * does not disagree with the size the track's display already refuses to
+ * render; otherwise the default.
+ */
+export declare function agentByteLimit(declaredFetchSizeLimit: unknown, requested?: number): number;
+interface DisplaySelf {
+    type: string;
+    configuration: AnyConfigurationModel;
+    displayPhase?: string;
+    regionTooLargeReason?: string;
+    height?: number;
+    error?: unknown;
+}
+interface TrackSelf extends IStateTreeNode {
+    type: string;
+    configuration: AnyConfigurationModel & {
+        trackId: string;
+    };
+    activeDisplay?: Record<string, unknown> & DisplaySelf;
+}
+export declare function sessionOf(pluginManager: PluginManager | undefined): AbstractSessionModel | undefined;
+export declare function safeJson(value: unknown): string;
+export declare function undeliveredNotifications(session: AbstractSessionModel): {
+    level: string;
+    message: string;
+}[];
+export declare function waitReady(timeoutMs: number, session?: AbstractSessionModel, root?: ParentNode): Promise<{
+    settled: boolean;
+    notifications?: {
+        level: string;
+        message: string;
+    }[] | undefined;
+    notReady?: ({
+        error?: string | undefined;
+        phase?: string | undefined;
+        viewId: string;
+        type: string;
+    } | ({
+        trackId: string;
+    } & Record<"error", unknown>) | ({
+        trackId: string;
+    } & Record<"phase", unknown>))[] | undefined;
+    offscreen?: {
+        pageHeight: number;
+        windowHeight: number;
+        scrollY: number;
+        views: {
+            viewId: string;
+            top: number;
+            bottom: number;
+        }[];
+        note: string;
+    } | undefined;
+} | {
+    settled: boolean;
+    note: string;
+    notifications?: {
+        level: string;
+        message: string;
+    }[] | undefined;
+    notReady?: ({
+        error?: string | undefined;
+        phase?: string | undefined;
+        viewId: string;
+        type: string;
+    } | ({
+        trackId: string;
+    } & Record<"error", unknown>) | ({
+        trackId: string;
+    } & Record<"phase", unknown>))[] | undefined;
+    offscreen?: {
+        pageHeight: number;
+        windowHeight: number;
+        scrollY: number;
+        views: {
+            viewId: string;
+            top: number;
+            bottom: number;
+        }[];
+        note: string;
+    } | undefined;
+}>;
+interface JbRegion {
+    refName: string;
+    start: number;
+    end: number;
+    assemblyName: string;
+}
+interface SlotDescription {
+    type: string;
+    description?: string;
+    defaultValue: unknown;
+}
+declare function describeSlots(conf: AnyConfigurationModel): Record<string, SlotDescription>;
+export declare function ensureReExports(): Promise<void>;
+export declare function createJbApi(pluginManager: PluginManager): {
+    help: string;
+    readonly session: AbstractSessionModel;
+    readonly rootModel: import("@jbrowse/core/util").AbstractRootModel | undefined;
+    require: (lib: string | ((...args: any) => any) | {
+        default: (...args: any) => any;
+    }) => any;
+    ensureRequire: typeof ensureReExports;
+    mst: typeof mst;
+    mobx: typeof mobx;
+    readConfObject: typeof readConfObject;
+    getConf: typeof getConf;
+    describeSlots: typeof describeSlots;
+    parseLocString: typeof parseLocString;
+    getFeatureAdapterOrThrow: typeof getFeatureAdapterOrThrow;
+    getRpcSessionId: typeof getRpcSessionId;
+    renameRegionsIfNeeded: typeof renameRegionsIfNeeded;
+    createStopToken: typeof createStopToken;
+    stopStopToken: typeof stopStopToken;
+    waitReady: (timeoutMs?: number) => Promise<{
+        settled: boolean;
+        notifications?: {
+            level: string;
+            message: string;
+        }[] | undefined;
+        notReady?: ({
+            error?: string | undefined;
+            phase?: string | undefined;
+            viewId: string;
+            type: string;
+        } | ({
+            trackId: string;
+        } & Record<"error", unknown>) | ({
+            trackId: string;
+        } & Record<"phase", unknown>))[] | undefined;
+        offscreen?: {
+            pageHeight: number;
+            windowHeight: number;
+            scrollY: number;
+            views: {
+                viewId: string;
+                top: number;
+                bottom: number;
+            }[];
+            note: string;
+        } | undefined;
+    } | {
+        settled: boolean;
+        note: string;
+        notifications?: {
+            level: string;
+            message: string;
+        }[] | undefined;
+        notReady?: ({
+            error?: string | undefined;
+            phase?: string | undefined;
+            viewId: string;
+            type: string;
+        } | ({
+            trackId: string;
+        } & Record<"error", unknown>) | ({
+            trackId: string;
+        } & Record<"phase", unknown>))[] | undefined;
+        offscreen?: {
+            pageHeight: number;
+            windowHeight: number;
+            scrollY: number;
+            views: {
+                viewId: string;
+                top: number;
+                bottom: number;
+            }[];
+            note: string;
+        } | undefined;
+    }>;
+    sessionSummary: () => {
+        name: string;
+        assemblyNames: string[];
+        views: Record<string, unknown>[];
+    };
+    inspect: (path?: string, maxInspectBytes?: number) => {
+        path: string;
+        modelType?: string | undefined;
+        bytes: number;
+        getters?: string[] | undefined;
+        actions?: string[] | undefined;
+        value: unknown;
+    } | {
+        path: string;
+        modelType?: string | undefined;
+        bytes: number;
+        getters?: string[] | undefined;
+        actions?: string[] | undefined;
+        note: string;
+        items: string[];
+    } | {
+        path: string;
+        modelType?: string | undefined;
+        bytes: number;
+        getters?: string[] | undefined;
+        actions?: string[] | undefined;
+        note: string;
+        keys: {
+            [k: string]: string;
+        };
+    };
+    listTracks: (search?: string, limit?: number) => {
+        total: number;
+        note?: string | undefined;
+        tracks: {
+            trackId: any;
+            name: string;
+            type: any;
+            adapterType?: any;
+            assemblyNames: string[];
+        }[];
+    };
+    view: (viewId?: string) => AbstractViewModel;
+    trackModel: (trackId: string, viewId?: string) => TrackSelf;
+    visibleRegions: (viewId?: string) => Promise<JbRegion[]>;
+    loadSessionSpec: (spec: Record<string, unknown>, settleMs?: number) => Promise<{
+        settled: boolean;
+        notifications?: {
+            level: string;
+            message: string;
+        }[] | undefined;
+        notReady?: ({
+            error?: string | undefined;
+            phase?: string | undefined;
+            viewId: string;
+            type: string;
+        } | ({
+            trackId: string;
+        } & Record<"error", unknown>) | ({
+            trackId: string;
+        } & Record<"phase", unknown>))[] | undefined;
+        offscreen?: {
+            pageHeight: number;
+            windowHeight: number;
+            scrollY: number;
+            views: {
+                viewId: string;
+                top: number;
+                bottom: number;
+            }[];
+            note: string;
+        } | undefined;
+        session?: {
+            name: string;
+            assemblyNames: string[];
+            views: Record<string, unknown>[];
+        } | undefined;
+    } | {
+        settled: boolean;
+        note: string;
+        notifications?: {
+            level: string;
+            message: string;
+        }[] | undefined;
+        notReady?: ({
+            error?: string | undefined;
+            phase?: string | undefined;
+            viewId: string;
+            type: string;
+        } | ({
+            trackId: string;
+        } & Record<"error", unknown>) | ({
+            trackId: string;
+        } & Record<"phase", unknown>))[] | undefined;
+        offscreen?: {
+            pageHeight: number;
+            windowHeight: number;
+            scrollY: number;
+            views: {
+                viewId: string;
+                top: number;
+                bottom: number;
+            }[];
+            note: string;
+        } | undefined;
+        session?: {
+            name: string;
+            assemblyNames: string[];
+            views: Record<string, unknown>[];
+        } | undefined;
+    }>;
+    addTrack: (opts: {
+        location: string | string[];
+        index?: string;
+        assembly?: string;
+        name?: string;
+        show?: boolean;
+        viewId?: string;
+        settleMs?: number;
+    }) => Promise<{
+        trackId: string;
+        trackType: string;
+        adapterType: string;
+        assembly: string;
+    }>;
+    getFeatures: (args: string | {
+        trackId: string;
+        loc?: string;
+        assembly?: string;
+        regions?: JbRegion[];
+        viewId?: string;
+        byteLimit?: number;
+    }, positionalLoc?: string, positionalOpts?: {
+        assembly?: string;
+        viewId?: string;
+        byteLimit?: number;
+    }) => Promise<import("@jbrowse/core/util").Feature[]>;
+};
+export type JbApi = ReturnType<typeof createJbApi>;
+export {};