@tomorrowevening/theatre-studio 1.0.4 → 1.0.6

package/dist/TheatreStudio.d.ts

@@ -0,0 +1,426 @@
+import type { IProject, IRafDriver, ISheet, ISheetObject } from '@tomorrowevening/theatre-core';
+import type { Pointer } from '@tomorrowevening/theatre-dataverse';
+import type { VoidFn } from '@tomorrowevening/theatre-shared/utils/types';
+import type { IScrub } from '@tomorrowevening/theatre-studio/Scrub';
+import type { PaneInstanceId } from '@tomorrowevening/theatre-shared/utils/ids';
+import type TheatreSheetObject from '@tomorrowevening/theatre-core/sheetObjects/TheatreSheetObject';
+import type TheatreSheet from '@tomorrowevening/theatre-core/sheets/TheatreSheet';
+import type { __UNSTABLE_Project_OnDiskState } from '@tomorrowevening/theatre-core';
+export interface ITransactionAPI {
+    /**
+     * Set the value of a prop by its pointer. If the prop is sequenced, the value
+     * will be a keyframe at the current sequence position.
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * const obj = sheet.object("box", {x: 0, y: 0})
+     * studio.transaction(({set}) => {
+     *   // set a specific prop's value
+     *   set(obj.props.x, 10) // New value is {x: 10, y: 0}
+     *   // values are set partially
+     *   set(obj.props, {y: 11}) // New value is {x: 10, y: 11}
+     *
+     *   // this will error, as there is no such prop as 'z'
+     *   set(obj.props.z, 10)
+     * })
+     * ```
+     * @param pointer - A Pointer, like object.props
+     * @param value - The value to override the existing value. This is treated as a deep partial value.
+     */
+    set<V>(pointer: Pointer<V>, value: V): void;
+    /**
+     * Unsets the value of a prop by its pointer.
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * const obj = sheet.object("box", {x: 0, y: 0})
+     * studio.transaction(({set}) => {
+     *   // set props.x to its default value
+     *   unset(obj.props.x)
+     *   // set all props to their default value
+     *   set(obj.props)
+     * })
+     * ```
+     * @param pointer - A pointer, like object.props
+     */
+    unset<V>(pointer: Pointer<V>): void;
+    /**
+     * EXPERIMENTAL API - this api may be removed without notice.
+     *
+     * Makes Theatre forget about this object. This means all the prop overrides and sequenced props
+     * will be reset, and the object won't show up in the exported state.
+     */
+    __experimental_forgetObject(object: TheatreSheetObject): void;
+    /**
+     * EXPERIMENTAL API - this api may be removed without notice.
+     *
+     * Makes Theatre forget about this sheet.
+     */
+    __experimental_forgetSheet(sheet: TheatreSheet): void;
+}
+/**
+ *
+ */
+export interface PaneClassDefinition {
+    /**
+     * Each pane has a `class`, which is a string.
+     */
+    class: string;
+    mount: (opts: {
+        paneId: string;
+        node: HTMLElement;
+    }) => () => void;
+}
+export type ToolConfigIcon = {
+    type: 'Icon';
+    svgSource: string;
+    title: string;
+    onClick: () => void;
+};
+export type ToolConfigOption = {
+    value: string;
+    label: string;
+    svgSource: string;
+};
+export type ToolConfigSwitch = {
+    type: 'Switch';
+    value: string;
+    onChange: (value: string) => void;
+    options: ToolConfigOption[];
+};
+export type ToolconfigFlyoutMenuItem = {
+    label: string;
+    onClick?: () => void;
+};
+export type ToolConfigFlyoutMenu = {
+    /**
+     * A flyout menu
+     */
+    type: 'Flyout';
+    /**
+     * The label of the trigger button
+     */
+    label: string;
+    items: ToolconfigFlyoutMenuItem[];
+};
+export type ToolConfig = ToolConfigIcon | ToolConfigSwitch | ToolConfigFlyoutMenu;
+export type ToolsetConfig = Array<ToolConfig>;
+/**
+ * A Theatre.js Studio extension. You can define one either
+ * in a separate package, or within your project.
+ */
+export interface IExtension {
+    /**
+     * Pick a unique ID for your extension. Ideally the name would be unique if
+     * the extension was to be published to the npm repository.
+     */
+    id: string;
+    /**
+     * Set this if you'd like to add a component to the global toolbar (on the top)
+     *
+     * @example
+     * TODO
+     */
+    toolbars?: {
+        [key in 'global' | string]: (set: (config: ToolsetConfig) => void, studio: IStudio) => () => void;
+    };
+    /**
+     * Introduces new pane types.
+     * @example
+     * TODO
+     */
+    panes?: Array<PaneClassDefinition>;
+}
+export type PaneInstance<ClassName extends string> = {
+    extensionId: string;
+    instanceId: PaneInstanceId;
+    definition: PaneClassDefinition;
+};
+export interface IStudioUI {
+    /**
+     * Temporarily hides the studio
+     */
+    hide(): void;
+    /**
+     * Whether the studio is currently visible or hidden
+     */
+    readonly isHidden: boolean;
+    /**
+     * Makes the studio visible again.
+     */
+    restore(): void;
+    renderToolset(toolsetId: string, htmlNode: HTMLElement): () => void;
+}
+export interface _StudioInitializeOpts {
+    /**
+     * The local storage key to use to persist the state.
+     *
+     * Default: "theatrejs:0.4"
+     */
+    persistenceKey?: string;
+    /**
+     * Whether to persist the changes in the browser's temporary storage.
+     * It is useful to set this to false in the test environment or when debugging things.
+     *
+     * Default: true
+     */
+    usePersistentStorage?: boolean;
+    __experimental_rafDriver?: IRafDriver | undefined;
+}
+/**
+ * This is the public api of Theatre's studio. It is exposed through:
+ *
+ * @example
+ * Basic usage:
+ * ```ts
+ * import studio from '@tomorrowevening/theatre-studio'
+ *
+ * studio.initialize()
+ * ```
+ *
+ * @example
+ * Usage with **tree-shaking**:
+ * ```ts
+ * import studio from '@tomorrowevening/theatre-studio'
+ *
+ * if (process.env.NODE_ENV !== 'production') {
+ *   studio.initialize()
+ * }
+ * ```
+ */
+export interface IStudio {
+    readonly ui: IStudioUI;
+    /**
+     * Initializes the studio. Call it once in your index.js/index.ts module.
+     * It silently ignores subsequent calls.
+     */
+    initialize(opts?: _StudioInitializeOpts): void;
+    /**
+     * Runs an undo-able transaction. Creates a single undo level for all
+     * the operations inside the transaction.
+     *
+     * Will roll back if an error is thrown.
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * studio.transaction(({set, unset}) => {
+     *   set(obj.props.x, 10) // set the value of obj.props.x to 10
+     *   unset(obj.props.y) // unset the override at obj.props.y
+     * })
+     * ```
+     */
+    transaction(fn: (api: ITransactionAPI) => void): void;
+    /**
+     * Creates a scrub, which is just like a transaction, except you
+     * can run it multiple times without creating extra undo levels.
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * const scrub = studio.scrub()
+     * scrub.capture(({set}) => {
+     *   set(obj.props.x, 10) // set the value of obj.props.x to 10
+     * })
+     *
+     * // half a second later...
+     * scrub.capture(({set}) => {
+     *   set(obj.props.y, 11) // set the value of obj.props.y to 11
+     *   // note that since we're not setting obj.props.x, its value reverts back to its old value (ie. not 10)
+     * })
+     *
+     * // then either:
+     * scrub.commit() // commits the scrub and creates a single undo level
+     * // or:
+     * scrub.reset() // clear all the ops in the scrub so we can run scrub.capture() again
+     * // or:
+     * scrub.discard() // clears the ops and destroys it (ie. can't call scrub.capture() anymore)
+     * ```
+     */
+    scrub(): IScrub;
+    /**
+     * Creates a debounced scrub, which is just like a normal scrub, but
+     * automatically runs scrub.commit() after `threshhold` milliseconds have
+     * passed after the last `scrub.capture`.
+     *
+     * @param threshhold - How long to wait before committing the scrub
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * // Will create a new undo-level after 2 seconds have passed
+     * // since the last scrub.capture()
+     * const scrub = studio.debouncedScrub(2000)
+     *
+     * // capture some ops
+     * scrub.capture(...)
+     * // wait one second
+     * await delay(1000)
+     * // capture more ops but no new undo level is made,
+     * // because the last scrub.capture() was called less than 2 seconds ago
+     * scrub.capture(...)
+     *
+     * // wait another seonc and half
+     * await delay(1500)
+     * // still no new undo level, because less than 2 seconds have passed
+     * // since the last capture
+     * scrub.capture(...)
+     *
+     * // wait 3 seconds
+     * await delay(3000) // at this point, one undo level is created.
+     *
+     * // this call to capture will start a new undo level
+     * scrub.capture(...)
+     * ```
+     */
+    debouncedScrub(threshhold: number): Pick<IScrub, 'capture'>;
+    /**
+     * Sets the current selection.
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * const sheet1: ISheet = ...
+     * const obj1: ISheetObject<any> = ...
+     *
+     * studio.setSelection([sheet1, obj1])
+     * ```
+     *
+     * You can read the current selection from studio.selection
+     */
+    setSelection(selection: Array<ISheetObject<any> | ISheet>): void;
+    /**
+     * Calls fn every time the current selection changes.
+     */
+    onSelectionChange(fn: (s: Array<ISheetObject<{}> | ISheet>) => void): VoidFunction;
+    /**
+     * The current selection, consisting of Sheets and Sheet Objects
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * console.log(studio.selection) // => [ISheetObject, ISheet]
+     * ```
+     */
+    readonly selection: Array<ISheetObject<{}> | ISheet>;
+    /**
+     * Registers an extension
+     */
+    extend(
+    /**
+     * The extension's definition
+     */
+    extension: IExtension, opts?: {
+        /**
+         * Whether to reconfigure the extension. This is useful if you're
+         * hot-reloading the extension.
+         *
+         * Mind you, that if the old version of the extension defines a pane,
+         * and the new version doesn't, all instances of that pane will disappear, as expected.
+         * _However_, if you again reconfigure the extension with the old version, the instances
+         * of the pane that pane will re-appear.
+         *
+         * We're not sure about whether this behavior makes sense or not. If not, let us know
+         * in the discord server or open an issue on github.
+         */
+        __experimental_reconfigure?: boolean;
+    }): void;
+    /**
+     * Creates a new pane
+     *
+     * @param paneClass - The class name of the pane (provided by an extension)
+     */
+    createPane<PaneClass extends string>(paneClass: PaneClass): PaneInstance<PaneClass>;
+    /**
+     * Returns the Theatre.js project that contains the studio's sheets and objects.
+     *
+     * It is useful if you'd like to have sheets/objects that are present only when
+     * studio is present.
+     */
+    getStudioProject(): IProject;
+    /**
+     * Creates a JSON object that contains the state of the project. You can use this
+     * to programmatically save the state of your projects to the storage system of your
+     * choice, rather than manually clicking on the "Export" button in the UI.
+     *
+     * @param projectId - same projectId as in `core.getProject(projectId)`
+     *
+     * @example
+     * Usage:
+     * ```ts
+     * const projectId = "project"
+     * const json = studio.createContentOfSaveFile(projectId)
+     * const string = JSON.stringify(json)
+     * fetch(`/projects/${projectId}/state`, {method: 'POST', body: string}).then(() => {
+     *   console.log("Saved")
+     * })
+     * ```
+     */
+    createContentOfSaveFile(projectId: string): Record<string, unknown>;
+    __experimental: {
+        /**
+         * Warning: This is an experimental API and will change in the future.
+         *
+         * Disables the play/pause keyboard shortcut (spacebar)
+         * Also see `__experimental_enablePlayPauseKeyboardShortcut()` to re-enable it.
+         */
+        __experimental_disblePlayPauseKeyboardShortcut(): void;
+        /**
+         * Warning: This is an experimental API and will change in the future.
+         *
+         * Disables the play/pause keyboard shortcut (spacebar)
+         */
+        __experimental_enablePlayPauseKeyboardShortcut(): void;
+        /**
+         * Clears persistent storage and ensures that the current state will not be
+         * saved on window unload. Further changes to state will continue writing to
+         * persistent storage, if enabled during initialization.
+         *
+         * @param persistenceKey - same persistencyKey as in `studio.initialize(opts)`, if any
+         */
+        __experimental_clearPersistentStorage(persistenceKey?: string): void;
+        /**
+         * Warning: This is an experimental API and will change in the future.
+         *
+         * This is functionally the same as `studio.createContentOfSaveFile()`, but
+         * returns a typed object instead of a JSON object.
+         *
+         * See {@link __UNSTABLE_Project_OnDiskState} for more information.
+         */
+        __experimental_createContentOfSaveFileTyped(projectId: string): __UNSTABLE_Project_OnDiskState;
+    };
+}
+export default class TheatreStudio implements IStudio {
+    readonly ui: {
+        hide(): void;
+        readonly isHidden: boolean;
+        restore(): void;
+        renderToolset(toolsetId: string, htmlNode: HTMLElement): () => void;
+    };
+    private readonly _cache;
+    __experimental: {
+        __experimental_disblePlayPauseKeyboardShortcut(): void;
+        __experimental_enablePlayPauseKeyboardShortcut(): void;
+        __experimental_clearPersistentStorage(persistenceKey?: string): void;
+        __experimental_createContentOfSaveFileTyped(projectId: string): __UNSTABLE_Project_OnDiskState;
+    };
+    initialize(opts?: Parameters<IStudio['initialize']>[0]): Promise<void>;
+    extend(extension: IExtension, opts?: {
+        __experimental_reconfigure?: boolean;
+    }): void;
+    transaction(fn: (api: ITransactionAPI) => void): void;
+    private _getSelectionPrism;
+    private _getSelection;
+    setSelection(selection: Array<ISheetObject | ISheet>): void;
+    onSelectionChange(fn: (s: (ISheetObject | ISheet)[]) => void): VoidFn;
+    get selection(): Array<ISheetObject | ISheet>;
+    scrub(): IScrub;
+    getStudioProject(): IProject;
+    debouncedScrub(threshold?: number): Pick<IScrub, 'capture'>;
+    createPane<PaneClass extends string>(paneClass: PaneClass): PaneInstance<PaneClass>;
+    destroyPane(paneId: string): void;
+    createContentOfSaveFile(projectId: string): Record<string, unknown>;
+}
+//# sourceMappingURL=TheatreStudio.d.ts.map

package/dist/TheatreStudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TheatreStudio.d.ts","sourceRoot":"","sources":["../../../../studio/src/TheatreStudio.ts"],"names":[],"mappings":"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"}

package/dist/UI/UI.d.ts

@@ -0,0 +1,14 @@
+import type { Studio } from '@tomorrowevening/theatre-studio/Studio';
+export default class UI {
+    readonly studio: Studio;
+    private _rendered;
+    private _nonSSRBits;
+    readonly ready: Promise<void>;
+    constructor(studio: Studio);
+    render(): void;
+    hide(): void;
+    restore(): void;
+    get isHidden(): boolean;
+    renderToolset(toolsetId: string, htmlNode: HTMLElement): () => void;
+}
+//# sourceMappingURL=UI.d.ts.map

package/dist/UI/UI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UI.d.ts","sourceRoot":"","sources":["../../../../../studio/src/UI/UI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,wCAAwC,CAAA;AAQlE,MAAM,CAAC,OAAO,OAAO,EAAE;IAUT,QAAQ,CAAC,MAAM,EAAE,MAAM;IATnC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,WAAW,CAEC;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAG5B;gBAEoB,MAAM,EAAE,MAAM;IAEnC,MAAM;IAgBN,IAAI;IAMJ,OAAO;IAOP,IAAI,QAAQ,YAIX;IAED,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW;CAuBvD"}

package/dist/UI/UINonSSRBits.d.ts

@@ -0,0 +1,10 @@
+export default class UINonSSRBits {
+    readonly containerEl: HTMLDivElement;
+    private _renderTimeout;
+    private _documentBodyUIIsRenderedIn;
+    readonly containerShadow: ShadowRoot & HTMLElement;
+    constructor();
+    render(): void;
+    renderToolset(toolsetId: string, htmlNode: HTMLElement): () => void;
+}
+//# sourceMappingURL=UINonSSRBits.d.ts.map

package/dist/UI/UINonSSRBits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UINonSSRBits.d.ts","sourceRoot":"","sources":["../../../../../studio/src/UI/UINonSSRBits.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,QAAQ,CAAC,WAAW,iBAAgC;IACpD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,2BAA2B,CAAqC;IACxE,QAAQ,CAAC,eAAe,EAAE,UAAU,GAAG,WAAW,CAAA;;IAmClD,MAAM;IAgBN,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW;CAWvD"}

package/dist/UIRoot/PanelsRoot.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+declare const PanelsRoot: React.VFC;
+export default PanelsRoot;
+//# sourceMappingURL=PanelsRoot.d.ts.map

package/dist/UIRoot/PanelsRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelsRoot.d.ts","sourceRoot":"","sources":["../../../../../studio/src/UIRoot/PanelsRoot.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,GAmBvB,CAAA;AAED,eAAe,UAAU,CAAA"}

package/dist/UIRoot/PointerCapturing.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+/** See {@link PointerCapturing} */
+export type CapturedPointer = {
+    release(): void;
+    /** Double check that you still have the current capture and weren't forcibly released */
+    isCapturing(): boolean;
+};
+/**
+ * Introduced `PointerCapturing` for addressing issues with over-shooting easing curves closing the popup preset modal.
+ *
+ * Goal is to be able to determine if the pointer is being captured somewhere in studio (e.g. dragging).
+ *
+ * Some other ideas we considered before going with the PointerCapturing provider and context
+ * - provider: `onPointerCaptureChanged`
+ * - `onDragging={isMouseActive = true}` / `onMouseActive={isMouseActive = true}`
+ * - dragging tracked application wide (ephemeral state) in popover
+ *
+ * Caveats: I wonder if there's a shared abstraction we should use for "releasing" e.g. unsubscribe / untap in rxjs / tapable patterns.
+ */
+export type PointerCapturing = {
+    isPointerBeingCaptured(): boolean;
+    capturePointer(debugReason: string): CapturedPointer;
+};
+/**
+ * See {@link PointerCapturing}.
+ *
+ * This should likely live towards the root of the application.
+ *
+ * Uncertain about whether nesting pointer capturing providers should be cognizant of each other.
+ */
+export declare function ProvidePointerCapturing(props: {
+    children?: React.ReactNode;
+}): React.ReactElement;
+/**
+ * Used to ensure we're locking drag and pointer events to a single place in the UI logic.
+ * Without this, we can much more easily accidentally create multiple drag handlers on
+ * child / parent dom elements which both `useDrag`, for example.
+ *
+ * An example of this helping us was when we first started building the Curve editor popover.
+ * In that activity, we were experiencing a weird issue where the popover would unmount while
+ * dragging away from the popover, and the drag end listener would not be called.
+ * By having "Pointer Capturing" we're able to identify that the pointer was not being properly
+ * released, because there would be a lock contention when trying to drag something else.
+ */
+export declare function usePointerCapturing(forDebugName: string): PointerCapturing;
+//# sourceMappingURL=PointerCapturing.d.ts.map

package/dist/UIRoot/PointerCapturing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointerCapturing.d.ts","sourceRoot":"","sources":["../../../../../studio/src/UIRoot/PointerCapturing.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAA;AAI3D,mCAAmC;AACnC,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,IAAI,IAAI,CAAA;IACf,yFAAyF;IACzF,WAAW,IAAI,OAAO,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sBAAsB,IAAI,OAAO,CAAA;IACjC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAAA;CACrD,CAAA;AAgFD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B,GAAG,KAAK,CAAC,YAAY,CAWrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAc1E"}

package/dist/UIRoot/ProvideTheme.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+declare const ProvideTheme: React.FC<{
+    children?: React.ReactNode;
+}>;
+export default ProvideTheme;
+//# sourceMappingURL=ProvideTheme.d.ts.map

package/dist/UIRoot/ProvideTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProvideTheme.d.ts","sourceRoot":"","sources":["../../../../../studio/src/UIRoot/ProvideTheme.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAOzB,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAC,CAExD,CAAA;AAED,eAAe,YAAY,CAAA"}

package/dist/UIRoot/UIRoot.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export default function UIRoot(props: {
+    containerShadow: ShadowRoot & HTMLElement;
+}): React.JSX.Element | null;
+//# sourceMappingURL=UIRoot.d.ts.map

package/dist/UIRoot/UIRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIRoot.d.ts","sourceRoot":"","sources":["../../../../../studio/src/UIRoot/UIRoot.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAkB,MAAM,OAAO,CAAA;AA6CtC,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAK,EAAE;IACpC,eAAe,EAAE,UAAU,GAAG,WAAW,CAAA;CAC1C,4BAkEA"}

package/dist/UIRoot/useKeyboardShortcuts.d.ts

@@ -0,0 +1,7 @@
+import type { Prism } from '@tomorrowevening/theatre-dataverse';
+import type Sequence from '@tomorrowevening/theatre-core/sequences/Sequence';
+export declare function __experimental_disblePlayPauseKeyboardShortcut(): void;
+export declare function __experimental_enablePlayPauseKeyboardShortcut(): void;
+export default function useKeyboardShortcuts(): void;
+export declare const getIsPlayheadAttachedToFocusRange: (k: Sequence) => Prism<boolean>;
+//# sourceMappingURL=useKeyboardShortcuts.d.ts.map

package/dist/UIRoot/useKeyboardShortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardShortcuts.d.ts","sourceRoot":"","sources":["../../../../../studio/src/UIRoot/useKeyboardShortcuts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,oCAAoC,CAAA;AAG7D,OAAO,KAAK,QAAQ,MAAM,kDAAkD,CAAA;AAI5E,wBAAgB,8CAA8C,SAE7D;AAED,wBAAgB,8CAA8C,SAE7D;AAED,MAAM,CAAC,OAAO,UAAU,oBAAoB,SA6I3C;AAmBD,eAAO,MAAM,iCAAiC,iCAuB7C,CAAA"}

package/dist/checkForUpdates.d.ts

@@ -0,0 +1,2 @@
+export default function checkForUpdates(): Promise<void>;
+//# sourceMappingURL=checkForUpdates.d.ts.map

package/dist/checkForUpdates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkForUpdates.d.ts","sourceRoot":"","sources":["../../../../studio/src/checkForUpdates.ts"],"names":[],"mappings":"AA6BA,wBAA8B,eAAe,kBA0D5C"}

package/dist/css.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+/**
+ * This CSS string is used to correctly set pointer-events on an element
+ * when the pointer is dragging something.
+ * Naming explanation: "NormalMode" as opposed to dragging mode.
+ *
+ * @see PointerEventsHandler - the place that sets `.normal` on #pointer-root
+ */
+export declare const pointerEventsAutoInNormalMode: import("styled-components").FlattenSimpleInterpolation;
+export declare const theme: {
+    panel: {
+        bg: string;
+        head: {
+            title: {
+                color: string;
+            };
+            punctuation: {
+                color: string;
+            };
+        };
+        body: {
+            compoudThing: {
+                label: {
+                    readonly color: string;
+                };
+            };
+        };
+    };
+};
+export declare const panelUtils: {
+    panelBorder: string;
+};
+export declare const PortalLayer: import("styled-components").StyledComponent<"div", any, {}, never>;
+export declare const ProvideStyles: React.FC<{
+    target: undefined | HTMLElement;
+    children: React.ReactNode;
+}>;
+export declare function withStyledShadow<Props extends {}>(Comp: React.ComponentType<Props>): React.ComponentType<Props>;
+//# sourceMappingURL=css.d.ts.map

package/dist/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../../../studio/src/css.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAkC,MAAM,OAAO,CAAA;AAMtD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,wDAOzC,CAAA;AAED,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;CAqBjB,CAAA;AAED,eAAO,MAAM,UAAU;;CAEtB,CAAA;AAuBD,eAAO,MAAM,WAAW,oEAQvB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IACnC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B,CASA,CAAA;AAED,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,EAAE,EAC/C,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,GAC/B,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAM5B"}

package/dist/getStudio.d.ts

@@ -0,0 +1,7 @@
+import type { Studio } from './Studio';
+export declare function setStudio(s: Studio): void;
+/**
+ * This may only be called from modules inside the studio bundle.
+ */
+export default function getStudio(): Studio;
+//# sourceMappingURL=getStudio.d.ts.map

package/dist/getStudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStudio.d.ts","sourceRoot":"","sources":["../../../../studio/src/getStudio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,UAAU,CAAA;AAIpC,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,QAElC;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,IAAI,MAAM,CAE1C"}

package/dist/index.d.ts

@@ -1,18 +1,15 @@
-import { IStudio } from '@tomorrowevening/theatre-studio/TheatreStudio';
-export { IExtension, IStudio, IStudioUI, PaneClassDefinition, PaneInstance, ToolConfig, ToolConfigIcon, ToolConfigSwitch, ToolsetConfig, _StudioInitializeOpts } from '@tomorrowevening/theatre-studio/TheatreStudio';
-export { default as ToolbarDropdownSelect } from './uiComponents/toolbar/ToolbarDropdownSelect';
-export { IScrub } from '@tomorrowevening/theatre-studio/Scrub';
-
 /**
  * The library providing the editor components of Theatre.js.
  *
  * @packageDocumentation
  */
-
+import type { IStudio } from '@tomorrowevening/theatre-studio/TheatreStudio';
 /**
  * The main instance of Studio. Read more at {@link IStudio}
  */
 declare const studio: IStudio;
-//# sourceMappingURL=index.d.ts.map
-
-export { studio as default };
+export default studio;
+export { default as ToolbarDropdownSelect } from './uiComponents/toolbar/ToolbarDropdownSelect';
+export type { IScrub } from '@tomorrowevening/theatre-studio/Scrub';
+export type { IStudio, IExtension, PaneInstance, PaneClassDefinition, IStudioUI, _StudioInitializeOpts, ToolsetConfig, ToolConfig, ToolConfigIcon, ToolConfigSwitch, } from '@tomorrowevening/theatre-studio/TheatreStudio';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../studio/src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,+CAA+C,CAAA;AAK1E;;GAEG;AACH,QAAA,MAAM,MAAM,EAAE,OAAoC,CAAA;AAElD,eAAe,MAAM,CAAA;AAkDrB,OAAO,EAAC,OAAO,IAAI,qBAAqB,EAAC,MAAM,8CAA8C,CAAA;AAW7F,YAAY,EAAC,MAAM,EAAC,MAAM,uCAAuC,CAAA;AACjE,YAAY,EACV,OAAO,EACP,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,+CAA+C,CAAA"}