@jbrowse/core 4.3.0 → 5.0.0-beta.10

package/esm/configuration/configurationSchemaUnion.d.ts

@@ -0,0 +1,39 @@
+import type { ConfigurationSchemaOptions, ConfigurationSchemaType } from './configurationSchema.ts';
+import type { AnyConfigurationSchemaType } from './types.ts';
+import type { IAnyType, ISimpleType, IType, SnapshotIn, SnapshotOut } from '@jbrowse/mobx-state-tree';
+interface NamedTypeSlotDef<NAME extends string> {
+    type: 'stringEnum';
+    model: ISimpleType<NAME>;
+}
+type Named<SCHEMA, NAME extends string> = SCHEMA extends ConfigurationSchemaType<infer D, infer O extends ConfigurationSchemaOptions<any, any>> ? ConfigurationSchemaType<{
+    [K in keyof D]: K extends 'type' ? NamedTypeSlotDef<NAME> : D[K];
+}, O> : never;
+type UnionNode<MEMBERS> = {
+    [K in keyof MEMBERS & string]: Named<MEMBERS[K], K>['Type'];
+}[keyof MEMBERS & string];
+/**
+ * A union of configuration schemas, each member's node reading its `type` as
+ * the key it is listed under — so a `switch` over it narrows to that member's
+ * own slots.
+ */
+export type ConfigurationSchemaUnionType<MEMBERS extends Record<string, AnyConfigurationSchemaType>> = Omit<IType<SnapshotIn<MEMBERS[keyof MEMBERS]>, SnapshotOut<MEMBERS[keyof MEMBERS]>, UnionNode<MEMBERS>>, 'Type'> & {
+    readonly Type: UnionNode<MEMBERS>;
+};
+/**
+ * #api core/configuration
+ * A list entry that is one of several configuration schemas, each keyed by the
+ * `type` it answers to: `types.array(ConfigurationSchemaUnion('Step', { filter,
+ * bin }))`. The keys are the vocabulary, the snapshot's `type` picks the
+ * member, and a `type` naming no member is refused in every build — where a
+ * bare `types.union` would load it as its first member. Each member is an
+ * `explicitlyTyped`, `closed` schema named by its key, so a key belonging to
+ * another member is refused rather than dropped; one that is not throws here.
+ */
+export declare function ConfigurationSchemaUnion<const MEMBERS extends Record<string, AnyConfigurationSchemaType>>(name: string, members: MEMBERS): ConfigurationSchemaUnionType<MEMBERS>;
+/**
+ * #api core/configuration
+ * The `ConfigurationSchemaUnion` an array slot's entries answer to, read off
+ * the slot's MST type, or undefined for any other slot.
+ */
+export declare function arraySlotUnion(slotType: IAnyType): import("./schemaRegistry.ts").ConfigurationSchemaUnionMetadata | undefined;
+export {};

package/esm/configuration/configurationSchemaUnion.js

@@ -0,0 +1,56 @@
+import { asArrayType, types } from '@jbrowse/mobx-state-tree';
+import { getConfigurationSchemaMetadata, getConfigurationSchemaUnion, registerConfigurationSchemaUnion, } from './schemaRegistry.js';
+import { listed } from './snapshotPreprocess.js';
+function memberRefusal(key, member) {
+    const meta = getConfigurationSchemaMetadata(member);
+    return !meta
+        ? 'which is not a configuration schema'
+        : meta.name !== key
+            ? `whose schema names itself "${meta.name}"`
+            : !meta.options.explicitlyTyped
+                ? 'which is not explicitlyTyped, so its snapshot names no type to dispatch on'
+                : !meta.options.closed
+                    ? 'which is not closed, so a key of another member would be dropped in silence'
+                    : undefined;
+}
+/**
+ * #api core/configuration
+ * A list entry that is one of several configuration schemas, each keyed by the
+ * `type` it answers to: `types.array(ConfigurationSchemaUnion('Step', { filter,
+ * bin }))`. The keys are the vocabulary, the snapshot's `type` picks the
+ * member, and a `type` naming no member is refused in every build — where a
+ * bare `types.union` would load it as its first member. Each member is an
+ * `explicitlyTyped`, `closed` schema named by its key, so a key belonging to
+ * another member is refused rather than dropped; one that is not throws here.
+ */
+export function ConfigurationSchemaUnion(name, members) {
+    for (const [key, member] of Object.entries(members)) {
+        const refusal = memberRefusal(key, member);
+        if (refusal) {
+            throw new Error(`${name} lists "${key}", ${refusal}`);
+        }
+    }
+    const names = Object.keys(members);
+    const union = types.union({
+        dispatcher: (snapshot) => {
+            const type = snapshot?.type;
+            if (typeof type === 'string' && Object.hasOwn(members, type)) {
+                return members[type];
+            }
+            throw new Error(`a ${name} names its type, one of ${listed(names)}, ${type === undefined
+                ? 'and names none'
+                : `not ${JSON.stringify(type)}`}`);
+        },
+    }, ...Object.values(members));
+    registerConfigurationSchemaUnion(union, { name, members });
+    return union;
+}
+/**
+ * #api core/configuration
+ * The `ConfigurationSchemaUnion` an array slot's entries answer to, read off
+ * the slot's MST type, or undefined for any other slot.
+ */
+export function arraySlotUnion(slotType) {
+    const array = asArrayType(slotType);
+    return array ? getConfigurationSchemaUnion(array.getChildType()) : undefined;
+}

package/esm/configuration/configurationSlot.d.ts

@@ -1,33 +1,376 @@
-import type { IAnyComplexType, IAnyModelType } from '@jbrowse/mobx-state-tree';
-export interface ConfigSlotDefinition {
+import type { JexlInstance } from '../util/jexlStrings.ts';
+import type { IAnyType } from '@jbrowse/mobx-state-tree';
+declare const slotTypes: {
+    stringArray: {
+        model: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+        fallbackDefault: never[];
+    };
+    expressionArray: {
+        model: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+        fallbackDefault: never[];
+    };
+    colorArray: {
+        model: import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+        fallbackDefault: never[];
+    };
+    stringArrayMap: {
+        model: import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISimpleType<string>>>;
+        fallbackDefault: {};
+    };
+    numberMap: {
+        model: import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").ISimpleType<number>>;
+        fallbackDefault: {};
+    };
+    stringMap: {
+        model: import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+        fallbackDefault: {};
+    };
+    boolean: {
+        model: import("@jbrowse/mobx-state-tree").ISimpleType<boolean>;
+        fallbackDefault: boolean;
+    };
+    color: {
+        model: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        fallbackDefault: string;
+    };
+    integer: {
+        model: import("@jbrowse/mobx-state-tree").ISimpleType<number>;
+        fallbackDefault: number;
+    };
+    number: {
+        model: import("@jbrowse/mobx-state-tree").ISimpleType<number>;
+        fallbackDefault: number;
+    };
+    maybeNumber: {
+        model: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<number>>;
+    };
+    maybeBoolean: {
+        model: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<boolean>>;
+    };
+    maybeColor: {
+        model: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+    };
+    maybeFrozen: {
+        model: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").IType<any, any, any>>;
+    };
+    maybeString: {
+        model: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+    };
+    string: {
+        model: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        fallbackDefault: string;
+    };
+    text: {
+        model: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        fallbackDefault: string;
+    };
+    featureField: {
+        model: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        fallbackDefault: string;
+    };
+    fileLocation: {
+        model: import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").ITypeUnion<import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "LocalPathLocation";
+            localPath: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "BlobLocation";
+            name: string;
+            blobId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "FileHandleLocation";
+            name: string;
+            handleId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "UriLocation";
+            uri: string;
+            baseUri: string | undefined;
+            internetAccountId: string | undefined;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").ModelCreationType<{
+                internetAccountType: string;
+                authInfo: any;
+            }> | undefined;
+        }>, import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"LocalPathLocation">;
+            localPath: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"BlobLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            blobId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"FileHandleLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            handleId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | {
+            locationType: "UriLocation";
+            uri: string;
+            internetAccountId: string | undefined;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+                internetAccountType: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+                authInfo: import("@jbrowse/mobx-state-tree").IType<any, any, any>;
+            }> | undefined;
+        }, import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"LocalPathLocation">;
+            localPath: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"BlobLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            blobId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"FileHandleLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            handleId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"UriLocation">;
+            uri: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            baseUri: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+            internetAccountId: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").IModelType<{
+                internetAccountType: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+                authInfo: import("@jbrowse/mobx-state-tree").IType<any, any, any>;
+            }, {}, import("@jbrowse/mobx-state-tree")._NotCustomized, import("@jbrowse/mobx-state-tree")._NotCustomized>>;
+        }>>, import("../util/types/mst.ts").LegacyFileLocation | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "LocalPathLocation";
+            localPath: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "BlobLocation";
+            name: string;
+            blobId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "FileHandleLocation";
+            name: string;
+            handleId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "UriLocation";
+            uri: string;
+            baseUri: string | undefined;
+            internetAccountId: string | undefined;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").ModelCreationType<{
+                internetAccountType: string;
+                authInfo: any;
+            }> | undefined;
+        }>, import("@jbrowse/mobx-state-tree")._NotCustomized>;
+        fallbackDefault: {
+            uri: string;
+            locationType: string;
+        };
+    };
+    maybeFileLocation: {
+        model: import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").ITypeUnion<import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "LocalPathLocation";
+            localPath: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "BlobLocation";
+            name: string;
+            blobId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "FileHandleLocation";
+            name: string;
+            handleId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "UriLocation";
+            uri: string;
+            baseUri: string | undefined;
+            internetAccountId: string | undefined;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").ModelCreationType<{
+                internetAccountType: string;
+                authInfo: any;
+            }> | undefined;
+        }>, import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"LocalPathLocation">;
+            localPath: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"BlobLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            blobId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"FileHandleLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            handleId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | {
+            locationType: "UriLocation";
+            uri: string;
+            internetAccountId: string | undefined;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").ModelSnapshotType<{
+                internetAccountType: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+                authInfo: import("@jbrowse/mobx-state-tree").IType<any, any, any>;
+            }> | undefined;
+        }, import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"LocalPathLocation">;
+            localPath: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"BlobLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            blobId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"FileHandleLocation">;
+            name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            handleId: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+        }> | import("@jbrowse/mobx-state-tree").ModelInstanceTypeProps<{
+            locationType: import("@jbrowse/mobx-state-tree").ILiteralType<"UriLocation">;
+            uri: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+            baseUri: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+            internetAccountId: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").IModelType<{
+                internetAccountType: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
+                authInfo: import("@jbrowse/mobx-state-tree").IType<any, any, any>;
+            }, {}, import("@jbrowse/mobx-state-tree")._NotCustomized, import("@jbrowse/mobx-state-tree")._NotCustomized>>;
+        }>>, import("../util/types/mst.ts").LegacyFileLocation | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "LocalPathLocation";
+            localPath: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "BlobLocation";
+            name: string;
+            blobId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "FileHandleLocation";
+            name: string;
+            handleId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "UriLocation";
+            uri: string;
+            baseUri: string | undefined;
+            internetAccountId: string | undefined;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").ModelCreationType<{
+                internetAccountType: string;
+                authInfo: any;
+            }> | undefined;
+        }>, import("@jbrowse/mobx-state-tree")._NotCustomized>>, import("../util/types/mst.ts").LegacyFileLocation | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "LocalPathLocation";
+            localPath: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "BlobLocation";
+            name: string;
+            blobId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "FileHandleLocation";
+            name: string;
+            handleId: string;
+        }> | import("@jbrowse/mobx-state-tree").ModelCreationType<{
+            locationType: "UriLocation";
+            uri: string;
+            baseUri: string | undefined;
+            internetAccountId: string | undefined;
+            internetAccountPreAuthorization: import("@jbrowse/mobx-state-tree").ModelCreationType<{
+                internetAccountType: string;
+                authInfo: any;
+            }> | undefined;
+        }> | undefined, import("@jbrowse/mobx-state-tree")._NotCustomized>;
+    };
+    frozen: {
+        model: import("@jbrowse/mobx-state-tree").IType<any, any, any>;
+        fallbackDefault: {};
+    };
+};
+/**
+ * The builtin table's own names — every slot type whose MST model this module
+ * supplies, so excluding the two enum types. Exported for `SlotValueByType` in
+ * `types.ts`, which has to name the same set and is checked against this.
+ */
+export type BuiltinSlotTypeName = keyof typeof slotTypes;
+declare const ENUM_SLOT_TYPES: readonly ['stringEnum', 'maybeStringEnum', 'stringEnumArray'];
+/**
+ * Every legal `type` on a slot definition: the builtin table's own names, plus
+ * the enum types.
+ *
+ * Closed on purpose. A name outside this set still *works* at runtime as long
+ * as a `model` is given — which is exactly the trap: the value round-trips
+ * fine, and the only symptom is that everything keyed off the type name stops
+ * recognising the slot (`slotFacade` hands the editor no `choices`, so an enum
+ * renders as a free text box).
+ */
+export type ConfigSlotType = keyof typeof slotTypes | (typeof ENUM_SLOT_TYPES)[number];
+/**
+ * The same set as `MAYBE_TYPES`, at the type level, and derived from the same
+ * property of the same table so the two cannot disagree: an entry with no
+ * `fallbackDefault` is one whose fixed form is "unset".
+ */
+type MaybeBuiltinSlotTypeName = {
+    [K in keyof typeof slotTypes]: 'fallbackDefault' extends keyof (typeof slotTypes)[K] ? never : K;
+}[keyof typeof slotTypes];
+export type MaybeSlotTypeName = MaybeBuiltinSlotTypeName | 'maybeStringEnum';
+/** Why the slot `name`, of type `type`, refuses `value` on a write. */
+export declare function slotWriteRefusal(name: string, type: string, value: unknown): string;
+interface ConfigSlotDefinitionCommon {
+    /** human-readable description of the slot's meaning */
     description?: string;
-    model?: IAnyModelType | IAnyComplexType;
-    type: string;
-    defaultValue: any;
+    /** custom base MST model for the slot's value */
+    model?: IAnyType;
+    /**
+     * The names a `jexl:` callback in this slot reads. Declaring any is what
+     * makes the slot take a callback; every other slot refuses one.
+     */
     contextVariable?: string[];
+    /**
+     * hide this slot behind a "Show advanced settings" toggle in the config
+     * editor, so common slots aren't crowded out by rarely-changed ones
+     */
+    advanced?: boolean;
 }
-export default function ConfigSlot(slotName: string, { description, model, type, defaultValue, contextVariable, }: ConfigSlotDefinition): import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IModelType<{
-    name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
-    description: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
-    type: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
-    value: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").ITypeUnion<any, any, any>, [undefined]>;
-}, {
-    contextVariable: string[];
-} & {
-    readonly isCallback: boolean;
-} & {
-    readonly expr: any;
-    readonly valueJSON: any[] | Record<string, any> | string | undefined;
-} & {
-    getValue(args?: Record<string, unknown>): any;
-} & {
-    set(newVal: any): void;
-    reset(): void;
-    convertToCallback(): void;
-    convertToValue(): void;
-}, import("@jbrowse/mobx-state-tree").ModelCreationType<import("@jbrowse/mobx-state-tree/dist/internal").ExtractCFromProps<{
-    name: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
-    description: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
-    type: import("@jbrowse/mobx-state-tree").ISimpleType<string>;
-    value: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").ITypeUnion<any, any, any>, [undefined]>;
-}>>, any>, [undefined]>;
+/**
+ * A slot definition, split on whether the slot's type spends `undefined` on
+ * "unset". The type-level twin of `ConfigSlot`'s
+ * `defaultValue === undefined && !MAYBE_TYPES.has(type)` throw, which used to be
+ * the only statement of the rule: a `maybe*` slot has exactly one legal
+ * `defaultValue`, so requiring the field of every slot alike made 81 slots
+ * across the repo carry a `defaultValue: undefined` line that said nothing.
+ *
+ * A `maybe*` slot's only legal `defaultValue` is the sentinel itself, but the
+ * field stays `unknown` rather than being pinned to `undefined`: the spread in
+ * `mergeSchemaDefinition` combines a base and a child whose halves may disagree,
+ * so pinning it forces a cast through the one place slot definitions are
+ * combined. `ConfigSlot` throws on a concrete one instead — and has to anyway,
+ * since no type can see what a `baseConfiguration` merged in, which is the way
+ * this mistake actually happens.
+ *
+ * Stating the sentinel stays meaningful in a subclass override, where the merge
+ * is a spread and an omitted key inherits the base's value. The same spread is
+ * why an enum slot's `model` stays optional here though `ConfigSlot` requires
+ * one: a subclass restating only the default inherits the vocabulary.
+ */
+export type ConfigSlotDefinition = (ConfigSlotDefinitionCommon & {
+    /** a `maybe*` slot type, whose unset state is `undefined` */
+    type: MaybeSlotTypeName;
+    /** optional: unset is the default, and the only value `ConfigSlot` accepts */
+    defaultValue?: unknown;
+}) | (ConfigSlotDefinitionCommon & {
+    /** name of the type of slot, e.g. "string", "number", "stringArray" */
+    type: Exclude<ConfigSlotType, MaybeSlotTypeName>;
+    /** default value of the slot; required, since no other value means "unset" */
+    defaultValue: unknown;
+});
+/**
+ * A configuration slot is a plain MST property holding the slot's value type,
+ * or, where the slot declares a `contextVariable`, that or a `jexl:...`
+ * callback string. Every other slot refuses a `jexl:` string, so a callback
+ * the reader would evaluate is one the schema says it takes. A `featureField`
+ * holds a `jexl:` expression as its value, which the display evaluates per
+ * feature. The value lives directly on the parent configuration model — there
+ * is no per-slot sub-model. `types.stripDefault` omits the property from the
+ * parent snapshot when it equals the default, so saved sessions stay minimal.
+ * Per-slot metadata (type/description/defaultValue/contextVariable) lives in
+ * the schema registry (a WeakMap keyed by the MST type, see
+ * schemaRegistry.ts); jexl callbacks are evaluated on read by
+ * `readConfObject`.
+ *
+ * Interning the returned type on `(type, model, defaultValue)` was prototyped
+ * and declined: a session builds 1197 slot types for 222 distinct ones, and
+ * removing the repeats moves neither the time nor the heap
+ * (`config-schema-construction`, published in `reference/EAGER_BUNDLE.md`).
+ */
+export default function ConfigSlot(definition: ConfigSlotDefinition): import("@jbrowse/mobx-state-tree").IOptionalIType<IAnyType, [undefined]>;
+/**
+ * New value when converting a fixed-value slot to a jexl callback. Already-
+ * callback values are returned unchanged.
+ *
+ * A single JSON.stringify covers every type: `jexl:${42}` and
+ * `jexl:${JSON.stringify(42)}` are identical for numbers/booleans, and the rest
+ * need the quoting/serialization anyway.
+ */
+export declare function toCallbackValue(value: unknown): string;
+/**
+ * New value when converting a jexl callback back to a fixed value: try
+ * evaluating with no args, else fall back to the slot default (and to the slot
+ * type's `fallbackDefault` if the default is itself a callback).
+ */
+export declare function toFixedValue(value: unknown, type: ConfigSlotType, defaultValue: unknown, jexl: JexlInstance): unknown;
+export {};