@aics/vole-app 3.4.4 → 3.6.0

package/type-declarations/aics-image-viewer/components/App/types.d.ts

@@ -26,11 +26,11 @@ export interface AppProps {
     parentImageUrl?: string | MultisceneUrls;
     viewerChannelSettings?: ViewerChannelSettings;
     appHeight: string;
-    cellId: string;
+    cellId?: string;
     visibleControls?: Partial<ControlVisibilityFlags>;
     viewerSettings?: Partial<ViewerState>;
-    imageDownloadHref: string;
-    parentImageDownloadHref: string;
+    imageDownloadHref?: string;
+    parentImageDownloadHref?: string;
     pixelSize?: [number, number, number];
     canvasMargin: string;
     transform?: {

package/type-declarations/aics-image-viewer/components/ChannelsWidget.d.ts

@@ -7,6 +7,9 @@ export type ChannelsWidgetProps = {
     channelDataChannels: Channel[] | undefined;
     channelGroupedByType: ChannelGrouping;
     viewerChannelSettings?: ViewerChannelSettings;
+    scrollContainer?: HTMLElement | null;
+    getDropdownContainer?: () => HTMLElement;
+    controlPanelCollapsed?: boolean;
     saveIsosurface: (channelIndex: number, type: IsosurfaceFormat) => void;
     onApplyColorPresets: (presets: ColorArray[]) => void;
     filterFunc?: (key: string) => boolean;

package/type-declarations/aics-image-viewer/components/ChannelsWidgetRow.d.ts

@@ -8,6 +8,9 @@ interface ChannelsWidgetRowProps {
     channelDataForChannel: Channel;
     saveIsosurface: (channelIndex: number, type: IsosurfaceFormat) => void;
     onColorChangeComplete?: (newRGB: ColorObject, oldRGB?: ColorObject, index?: number) => void;
+    getDropdownContainer?: () => HTMLElement;
+    scrollContainer?: HTMLElement | null;
+    controlPanelCollapsed?: boolean;
 }
 declare const ChannelsWidgetRow: React.FC<ChannelsWidgetRowProps>;
 export default ChannelsWidgetRow;

package/type-declarations/aics-image-viewer/components/ControlPanel/CopySettingsButton.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+export type CopySettingsButtonProps = {
+    imageName?: string;
+    scrollContainer?: HTMLElement | null;
+    hide?: boolean;
+    getDropdownContainer?: () => HTMLElement;
+    hideImportExport?: boolean;
+    channelIndex?: number;
+};
+declare const CopySettingsButton: React.FC<CopySettingsButtonProps>;
+export default CopySettingsButton;

package/type-declarations/aics-image-viewer/components/Toolbar/ViewModeRadioButtons.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { ViewMode } from "../../shared/enums";
+import { ViewMode } from "../../state/types";
 interface ViewModeRadioButtonsProps {
     mode: ViewMode;
     onViewModeChange: (newMode: ViewMode) => void;

package/type-declarations/aics-image-viewer/components/{CellViewerCanvasWrapper → ViewerCanvasWrapper}/index.d.ts

@@ -1,6 +1,6 @@
 import type { View3d, Volume } from "@aics/vole-core";
 import React from "react";
-import type { AxisName, PerAxis } from "../../shared/types";
+import type { AxisName, XYZ } from "../../shared/types";
 import type PlayControls from "../../shared/utils/playControls";
 import "./styles.css";
 type ViewerWrapperProps = {
@@ -8,10 +8,11 @@ type ViewerWrapperProps = {
     loadingImage: boolean;
     appHeight: string;
     image: Volume | null;
-    numSlices: PerAxis<number>;
-    numSlicesLoaded: PerAxis<number>;
+    numSlices: XYZ<number>;
+    numSlicesLoaded: XYZ<number>;
     playControls: PlayControls;
     playingAxis: AxisName | "t" | null;
+    setScrubbingAxis: (axis: AxisName | "t" | null) => void;
     numTimesteps: number;
     numScenes: number;
     visibleControls: {

package/type-declarations/aics-image-viewer/components/dimension_sliders/AxisClipSliders.d.ts

@@ -1,23 +1,24 @@
 import type { Volume } from "@aics/vole-core";
 import React from "react";
-import type { ViewMode } from "../../shared/enums";
-import { type AxisName, type PerAxis } from "../../shared/types";
+import { type AxisName, type XYZ } from "../../shared/types";
 import type PlayControls from "../../shared/utils/playControls";
 import type { ViewerStateActions } from "../../state/store";
+import type { ViewMode } from "../../state/types";
 type AxisClipSlidersProps = {
     mode: ViewMode;
     image: Volume | null;
     changeViewerSetting: ViewerStateActions["changeViewerSetting"];
-    numSlices: PerAxis<number>;
-    numSlicesLoaded: PerAxis<number>;
+    numSlices: XYZ<number>;
+    numSlicesLoaded: XYZ<number>;
     numScenes: number;
-    region: PerAxis<[number, number]>;
-    slices: PerAxis<number>;
+    region: XYZ<[number, number]>;
+    slices: XYZ<number>;
     numTimesteps: number;
     time: number;
     scene: number;
     playingAxis: AxisName | "t" | null;
     playControls: PlayControls;
+    setScrubbingAxis: (axis: AxisName | "t" | null) => void;
 };
 export declare const AxisClipSliders: React.FC<AxisClipSlidersProps>;
 export {};

package/type-declarations/aics-image-viewer/components/dimension_sliders/SliderRows.d.ts

@@ -17,9 +17,8 @@ type DimensionSliderRowProps = SharedSliderRowProps<number[]> & {
     unitSymbol?: string;
 };
 type IndexSliderRowProps = Omit<SharedSliderRowProps, "min">;
-type PlaySliderRowProps = Omit<SharedSliderRowProps, "valReadout" | "min" | "onSlide"> & {
+type PlaySliderRowProps = Omit<SharedSliderRowProps, "valReadout" | "min"> & {
     playing: boolean;
-    updateWhileSliding?: boolean;
     onTogglePlayback: (play: boolean) => void;
 };
 /** A single slider row, with a slider, one or two spinbox inputs, and a max value. */

package/type-declarations/aics-image-viewer/components/shared/ContextualAlert.d.ts

@@ -0,0 +1,29 @@
+import { type AlertProps } from "antd";
+import React from "react";
+type AlertType = AlertProps["type"];
+type AlertContext = {
+    scrollContainer?: HTMLElement | null;
+    hide?: boolean;
+};
+export type ContextualAlertProps = AlertProps & AlertContext & {
+    target: HTMLElement | null;
+};
+export type ContextualAlertOptions = AlertContext & {
+    timeout?: number;
+};
+/**
+ * Antd's `Alert`, but positioned immediately under a `target` element to provide contextual information.
+ *
+ * This is relatively specialized to the use case of attaching to components inside the control panel. Since the
+ * control panel can be vertically scrolled and hidden, it has specific props for responding to both.
+ */
+export declare const ContextualAlert: React.FC<ContextualAlertProps>;
+/**
+ * Creates an `antd` `Alert` element that stays positioned beneath the `target` element, and a function to show
+ * time-limited messages in the `Alert`.
+ *
+ * This is relatively specialized to the use case of attaching to components inside the control panel. Since the
+ * control panel can be vertically scrolled and hidden, it has specific props for responding to both.
+ */
+export declare const useContextualAlert: (target: HTMLElement | null, options: ContextualAlertOptions) => [React.ReactNode, (message: React.ReactNode, messageType?: AlertType) => void];
+export {};

package/type-declarations/aics-image-viewer/components/shared/ControlPanelRow/index.d.ts

@@ -6,6 +6,7 @@ export type ControlPanelRowProps = React.PropsWithChildren<ColorPickerPropPassth
     verticalMargin?: number;
     showColorPicker?: boolean;
     title?: React.ReactNode;
+    icon?: React.ReactNode;
     onClick?: React.MouseEventHandler;
     className?: string;
     highlight?: boolean;

package/type-declarations/aics-image-viewer/components/useVolume.d.ts

@@ -12,6 +12,8 @@ export type UseVolumeOptions = {
     onChannelLoaded?: (image: Volume, channelIndex: number, isInitialLoad: boolean) => void;
     /** Callback for when image loading encounters an error. */
     onError?: (error: unknown, image?: Volume) => void;
+    /** Callback for when scrubbing starts or stops, including the state info needed */
+    onScrub?: (isScrubbing: boolean, image: Volume) => void;
     /** The name of a channel which should be treated as a mask rather than as viewable data. */
     maskChannelName?: string;
 };
@@ -36,6 +38,7 @@ export type ReactiveVolume = {
     imageLoadStatus: ImageLoadStatus;
     setTime: (view3d: View3d, time: number) => void;
     setScene: (scene: number) => void;
+    setScrubbingAxis: (axis: AxisName | "t" | null) => void;
     playControls: PlayControls;
     playingAxis: AxisName | "t" | null;
     channelGroupedByType: ChannelGrouping;

package/type-declarations/aics-image-viewer/shared/constants.d.ts

@@ -1,9 +1,9 @@
 import { type CameraState, type Channel, PrefetchDirection } from "@aics/vole-core";
-import type { ChannelState, ViewerState } from "../state/types";
-import { ViewMode } from "./enums";
+import { type ChannelState, type ViewerState, ViewMode } from "../state/types";
 import type { AxisName } from "./types";
 import type { ColorArray } from "./utils/colorRepresentations";
 import type { ViewerChannelSettings } from "./utils/viewerChannelSettings";
+export declare const VOLEAPP_VERSION: string;
 export declare const // Control panel will automatically close if viewport is less than this width
 CONTROL_PANEL_CLOSE_WIDTH = 970, CLIPPING_PANEL_HEIGHT_DEFAULT = 200, CLIPPING_PANEL_HEIGHT_TALL = 235, BACKGROUND_COLOR_DEFAULT: ColorArray, BOUNDING_BOX_COLOR_DEFAULT: ColorArray, AXIS_MARGIN_DEFAULT: [number, number], SCALE_BAR_MARGIN_DEFAULT: [number, number], LUT_MIN_PERCENTILE = 0.5, LUT_MAX_PERCENTILE = 0.983, ALPHA_MASK_SLIDER_DEFAULT = 0, BRIGHTNESS_SLIDER_LEVEL_DEFAULT = 70, DENSITY_SLIDER_LEVEL_DEFAULT = 50, LEVELS_SLIDER_DEFAULT: ColorArray, INTERPOLATION_ENABLED_DEFAULT = true, OTHER_CHANNEL_KEY = "Other", SINGLE_GROUP_CHANNEL_KEY = "Channels", SINGLE_CHANNEL_MODE_COLOR: ColorArray;
 export declare const TFEDITOR_DEFAULT_COLOR: ColorArray;

package/type-declarations/aics-image-viewer/shared/types.d.ts

@@ -1,7 +1,7 @@
 import type { CSSProperties } from "react";
-import { ViewMode } from "./enums";
+import { ViewMode } from "../state/types";
 export type AxisName = "x" | "y" | "z";
-export type PerAxis<T> = Record<AxisName, T>;
+export type XYZ<T> = Record<AxisName, T>;
 export declare const activeAxisMap: {
     [A in ViewMode]: AxisName | null;
 };

package/type-declarations/aics-image-viewer/shared/utils/controlPointsToLut.d.ts

@@ -35,7 +35,7 @@ export declare function getDefaultLut(histogram: Histogram): Lut;
  * "autoij:0" // use Auto-IJ to calculate min and max.
  * ```
  */
-export declare function parseLutSetting(histogram: Histogram, lutSetting: [string, string] | undefined): Lut | undefined;
+export declare function parseLutSetting(histogram: Histogram, lutSetting: [string | number, string | number] | undefined): Lut | undefined;
 /**
  * Initializes the lookup table (LUT) that maps from volume intensity values to color + opacity and applies the LUT to the volume.
  *

package/type-declarations/aics-image-viewer/shared/utils/parseSnapshot.d.ts

@@ -0,0 +1,49 @@
+import type { MultisceneUrls } from "../../components/App/types";
+import type { ChannelState, ChannelStateSnapshot, ViewerStateSnapshot } from "../../state/types";
+import type { MetadataRecord } from "../types";
+import type { ViewerChannelSettings } from "./viewerChannelSettings";
+/**
+ * A message sent from an external application after this app was opened,
+ * containing data that was too large to pack into the URL.
+ */
+export type ViewerMessage = {
+    /** A (possibly very long) list of scene URLs. */
+    scenes?: (string | string[])[];
+    /** A (likely very large) list of metadata records for each scene. */
+    meta?: Record<string, MetadataRecord>;
+    /** The scene to open once this message arrives. */
+    sceneIndex?: number;
+};
+/** A snapshot of app state, containing (optional) global and per-channel settings. */
+export type StoreSnapshot = ViewerStateSnapshot & {
+    version: string;
+    channels: Record<string, ChannelStateSnapshot>;
+};
+/**
+ * A complete description of a viewer session, containing image URLs, global
+ * and per-channel settings, and optional image metadata.
+ */
+export type SessionSnapshot = StoreSnapshot & ViewerMessage & Required<Pick<ViewerMessage, "scenes">>;
+/** Verifies that the given object is (likely) a `StoreSnapshot`. */
+export declare const isStoreSnapshot: (settings: unknown) => settings is StoreSnapshot;
+/** Verifies that the given object is (likely) a `SessionSnapshot`. */
+export declare const isSessionSnapshot: (settings: unknown) => settings is SessionSnapshot;
+/** Converts an array of `ChannelState`s to a compact JSON representation that can be stringified into the clipboard. */
+export declare const channelStatesToSnapshot: (channelStates: ChannelState[], excludeKeys?: (keyof ChannelState)[]) => StoreSnapshot;
+/** Converts a single `ChannelState` to a compact JSON representation that can be stringified into the clipboard. */
+export declare const singleChannelStateToSnapshot: (channelState: ChannelState, excludeKeys?: (keyof ChannelState)[]) => StoreSnapshot;
+/** Converts a compacted set of `ChannelState`s from the clipboard into a record of channel names and their states. */
+export declare const snapshotToChannelStates: (serialized: StoreSnapshot) => Record<string, Partial<ChannelState>>;
+export declare const snapshotToViewerChannelSettings: (serialized: StoreSnapshot) => ViewerChannelSettings | undefined;
+/**
+ * Parses a `ViewerMessage` into the relevant entries in `AppProps`.
+ *
+ * Optionally accepts the current value of the `imageUrl` prop, for the case where the message contains only metadata
+ * and the image URLs that correspond to the metadata were passed in by other means.
+ */
+export declare function viewerMessageToParams(message: ViewerMessage, propUrl?: string | MultisceneUrls): {
+    imageUrl?: string | MultisceneUrls;
+    metadata?: (MetadataRecord | undefined)[];
+};
+/** Formats the values of the `imageUrl` and `metadata` props to `App` as a `ViewerMessage`. */
+export declare function paramsToViewerMessage(imageUrl: string | MultisceneUrls, metadata?: (MetadataRecord | undefined)[]): ViewerMessage;

package/type-declarations/aics-image-viewer/shared/utils/{urlParsing.d.ts → parseUrl.d.ts}

@@ -1,7 +1,6 @@
-import type { FirebaseFirestore } from "@firebase/firestore-types";
 import type { AppProps } from "../../components/App/types";
 import type { ViewerStore } from "../../state/store";
-import { type ViewerState, ViewerStateParams } from "../../state/types";
+import type { ViewerState, ViewerStateStringified } from "../../state/types";
 import type { MetadataRecord } from "../types";
 /**
  * Channels, matching the pattern `c0`, `c1`, etc. corresponding to the index of the channel being configured.
@@ -33,10 +32,6 @@ declare class DataParams {
      * See `ManifestJson` for the type definition.
      */
     manifest?: string;
-    /** The name of a dataset in the Cell Feature Explorer database. Used with `id`. */
-    dataset?: string;
-    /** The ID of a cell within the loaded dataset. Used with `dataset`. */
-    id?: string;
     /** The key of a collection of scenes stored in local storage. Overrides `url`. */
     collectionid?: string;
     /**
@@ -60,19 +55,7 @@ declare class DeprecatedParams {
     /** Deprecated query parameter for channel colors. */
     colors?: string;
 }
-type AppParams = Partial<ViewerStateParams & DataParams & DeprecatedParams & ChannelParams>;
-/**
- * A message sent from an external application after this app was opened,
- * containing data that was too large to pack into the URL.
- */
-type ViewerMessage = {
-    /** A (possibly very long) list of scene URLs. */
-    scenes?: string[];
-    /** A (likely very large) list of metadata records for each scene. */
-    meta?: Record<string, MetadataRecord>;
-    /** The scene to open once this message arrives. */
-    sceneIndex?: number;
-};
+type AppParams = Partial<ViewerStateStringified & DataParams & DeprecatedParams & ChannelParams>;
 /**
  * Filters a set of URLSearchParams for only the keys that are valid parameters for the viewer.
  * Non-matching keys are discarded.
@@ -89,20 +72,16 @@ export declare function loadFromManifest(manifestUrl: string): Promise<{
 /**
  * Parses a set of URL search parameters into props for the viewer.
  * @param search The query string to parse, which must be valid in the `URLSearchParams constructor
- * @param firestore Optional Firestore instance. If provided, the function can load data from a
- * Firestore dataset if the `dataset` and `id` parameters are provided.
  * @returns An object containing:
  * - `args`: Partial AppProps object.
  * - `viewerSettings`: Partial ViewerState object.
  *
  * `args` can be passed as props to the `ImageViewerApp`, and `viewerSettings` can be passed to `ViewerStateProvider`.
  */
-export declare function parseViewerUrlParams(search: string, firestore?: FirebaseFirestore): Promise<{
+export declare function parseViewerUrlParams(search: string): Promise<{
     args: Partial<AppProps>;
     viewerSettings: Partial<ViewerState>;
 }>;
-/** Adds the data in a newly-arrived `ViewerMessage` to an existing stored `AppProps` instance. */
-export declare function addViewerParamsFromMessage<P extends Pick<AppProps, "imageUrl" | "metadata">>(args: P, message: ViewerMessage): P;
 /**
  * Serializes the ViewerState and ChannelState of a ViewerStateContext into a URLSearchParams object.
  * @param state ViewerStateContext to serialize.

package/type-declarations/aics-image-viewer/shared/utils/permissions.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Try to determine whether attempting to access the clipboard will immediately fail.
+ *
+ * When this function returns `false`, accessing the clipboard *may* be successful, though some browsers require users
+ * to confirm every paste. When it returns `true`, access to the clipboard is definitely blocked.
+ */
+export declare const queryPasteDenied: () => Promise<boolean>;

package/type-declarations/aics-image-viewer/shared/utils/viewerChannelSettings.d.ts

@@ -21,7 +21,7 @@ export type IntensitySettings = {
      * - `autoij` in either the min or max fields will use the "auto" algorithm
      * from ImageJ to select the min and max.
      */
-    lut?: [string, string];
+    lut?: [string | number, string | number];
 };
 /** Settings for a single channel, as passed in via props by App users */
 export interface ViewerChannelSetting {

package/type-declarations/aics-image-viewer/state/deserialize.d.ts

@@ -1,7 +1,7 @@
 import type { Histogram } from "@aics/vole-core";
 import type { ColorArray } from "../shared/utils/colorRepresentations";
 import type { ViewerChannelSetting } from "../shared/utils/viewerChannelSettings";
-import { type ChannelState, type ViewerChannelStateParams, type ViewerState, type ViewerStateParams } from "./types";
+import type { CameraStateSnapshot, CameraStateStringified, ChannelState, ChannelStateSnapshot, ChannelStateStringified, ViewerState, ViewerStateSnapshot, ViewerStateStringified } from "./types";
 /**
  * LEGACY: Matches a COMMA-separated list of control points, where each control point is represented
  * by a triplet of `{x}:{opacity}:{hex color}`.
@@ -19,6 +19,22 @@ export declare const LEGACY_CONTROL_POINTS_REGEX: RegExp;
  *   with `1` to represent white (`ffffff`).
  */
 export declare const CONTROL_POINTS_REGEX: RegExp;
+export declare const enumParser: <E extends string>(enumValues: Record<string, E>) => ((value: string) => E | undefined);
+/**
+ * Converts a `CameraStateStringified` into a `CameraStateSnapshot` by parsing each key from its stringified
+ * representation to its type in `CameraStateSnapshot`.
+ */
+export declare const destringifyCameraStateSnapshot: (stringified: CameraStateStringified) => CameraStateSnapshot;
+/**
+ * Converts a `ViewerStateStringified` into a `ViewerStateSnapshot` by parsing each key from its stringified
+ * representation to its type in `ViewerStateSnapshot`.
+ */
+export declare const destringifyViewerStateSnapshot: (stringified: ViewerStateStringified) => ViewerStateSnapshot;
+/**
+ * Converts a `ChannelStateStringified` into a `ChannelStateSnapshot` by parsing each key from its stringified
+ * representation to its type in `ChannelStateSnapshot`.
+ */
+export declare const destringifyChannelStateSnapshot: (stringified: ChannelStateStringified) => ChannelStateSnapshot;
 /**
  * Parse a string list of comma-separated key:value pairs into
  * a key-value object.
@@ -30,50 +46,68 @@ export declare const CONTROL_POINTS_REGEX: RegExp;
  *  will be decoded using `decodeURIComponent`.
  */
 export declare function parseKeyValueList(data: string): Record<string, string>;
+export declare function parseHexColorAsColorArray(hexColor: unknown): ColorArray | undefined;
+/** Verifies that `value` is a `number`; if it is, clamps it between `min` and `max`. */
+export declare const validateNumber: (value: unknown, min?: number, max?: number) => number | undefined;
+/** Verifies that `value` is a `number`; if it is, truncates it to an integer and clamps it between `min` and `max`. */
+export declare const validateInt: (value: unknown, min?: number, max?: number) => number | undefined;
+type Untrusted<T> = {
+    [K in keyof T]?: unknown;
+};
+/** Parses a `ViewerStateSnapshot` to a `ViewerState`. */
+export declare function snapshotToViewerState(snapshot: Untrusted<ViewerStateSnapshot>): Partial<ViewerState>;
 /**
- * Parses a string to a float and clamps the result to the [min, max] range.
- * Returns `undefined` if the string is undefined or NaN.
- * @param value String to parse as a float. Will be parsed with `Number.parseFloat`.
- * @param min Minimum value, inclusive.
- * @param max Maximum value, inclusive.
- * @returns
- * - The parsed number, clamped to the [min, max] range.
- * - `undefined` if the string is undefined or NaN.
+ * Parses a `ChannelStateSnapshot` to a `ViewerChannelSetting`.
+ * @param channelId Either the index or the name of the channel, to be turned into a `match` value.
+ * @param jsonState The serialized `ViewerChannelSetting` to parse, as an object.
+ * @returns A `ViewerChannelSetting` object.
  */
-export declare function parseStringFloat(value: string | undefined, min: number, max: number): number | undefined;
+export declare function snapshotToViewerChannelSetting(channelId: number | string, jsonState: Untrusted<ChannelStateSnapshot>): ViewerChannelSetting;
 /**
- * Parses a string to an integer and clamps the result to the [min, max] range.
- * @param value String to parse as a float. Assumes base 10, parses with `Number.parseInt(value, 10)`.
- * @param min Minimum value, inclusive.
- * @param max Maximum value, inclusive.
- * @returns
- * - The parsed number, clamped to the [min, max] range.
- * - `undefined` if the string is undefined or NaN.
+ * Parses a `ChannelStateSnapshot` object into a partial `ChannelState`.
+ *
+ * This is used to convert from serialized formats (URL params, JSON) into
+ * internal channel state fields, leaving absent or invalid values undefined.
+ *
+ * This function optionally accepts the target channel's `Histogram`. This
+ * argument is required to parse the following params correctly:
+ *
+ * - `lut`, which contains instructions for how to set the channel's
+ *   intensities *relative to its intensity distribution*.
+ * - `rmp`, the legacy ramp parameter represented as histogram bin indices
+ * - `cps`, the legacy control points parameter where `x` values are
+ *   represented as histogram bin indices
+ *
+ * If `histogram` is left undefined, e.g. because the channel has not yet been
+ * loaded, these params are ignored.
  */
-export declare function parseStringInt(value: string | undefined, min: number, max: number): number | undefined;
+export declare function snapshotToChannelState(jsonState: Untrusted<ChannelStateSnapshot>, histogram?: Histogram): Partial<ChannelState>;
 /**
- * Parses a string to an enum value; if the string is not in the enum, returns the default value.
- * @param value String to parse.
- * @param enumValues Enum. Cannot be a `const enum`, as these are removed at compile time.
- * @param defaultValue Default value to return if the string is not in the enum.
- * @returns A value from the enum or the default value. Note that the return type includes `undefined`
- * if the `defaultValue` is `undefined`.
+ * Parses a stringified viewer state snapshot (`ViewerStateStringified`) to a
+ * `ViewerState`.
+ *
+ * This is equivalent to (and implemented by) calling
+ * `destringifyViewerStateSnapshot`, then `snapshotToViewerState`.
  */
-export declare function parseStringEnum<E extends string, T extends E | undefined>(value: string | undefined, enumValues: Record<string | number | symbol, E>, defaultValue?: T): T;
-export declare function parseHexColorAsColorArray(hexColor: string | undefined): ColorArray | undefined;
-export declare function deserializeViewerState(params: ViewerStateParams): Partial<ViewerState>;
+export declare const stringSnapshotToViewerState: (stringified: ViewerStateStringified) => Partial<ViewerState>;
 /**
- * Parses a ViewerChannelSetting from a JSON object.
+ * Parses a stringified channel state snapshot (`ChannelStateStringified`) to a
+ * `ViewerChannelSetting`.
+ *
+ * This is equivalent to (and implemented by) calling
+ * `destringifyChannelStateSnapshot`, then `snapshotToViewerChannelSetting`.
+ *
  * @param channelIndex Index of the channel, to be turned into a `match` value.
- * @param jsonState The serialized ViewerChannelSetting to parse, as an object.
- * @returns A ViewerChannelSetting object.
+ * @param jsonState The serialized `ViewerChannelSetting` to parse, as an object.
+ * @returns A `ViewerChannelSetting` object.
  */
-export declare function deserializeViewerChannelSetting(channelIndex: number, jsonState: ViewerChannelStateParams): ViewerChannelSetting;
+export declare const stringSnapshotToViewerChannelSetting: (channelIndex: number, jsonState: ChannelStateStringified) => ViewerChannelSetting;
 /**
- * Parses a `ViewerChannelStateParams` object into a partial `ChannelState`.
+ * Parses a stringified channel state snapshot (`ChannelStateStringified`)
+ * into a partial `ChannelState`.
  *
- * This is used to convert raw URL params into internal channel state fields,
- * leaving absent or invalid values undefined.
+ * This is equivalent to (and implemented by) calling
+ * `destringifyChannelStateSnapshot`, then `snapshotToChannelState`.
  *
  * This function optionally accepts the target channel's `Histogram`. This
  * argument is required to parse the following params correctly:
@@ -87,4 +121,5 @@ export declare function deserializeViewerChannelSetting(channelIndex: number, js
  * If `histogram` is left undefined, e.g. because the channel has not yet been
  * loaded, these params are ignored.
  */
-export declare function deserializeChannelState(jsonState: ViewerChannelStateParams, histogram?: Histogram): Partial<ChannelState>;
+export declare const stringSnapshotToChannelState: (jsonState: ChannelStateStringified, histogram?: Histogram) => Partial<ChannelState>;
+export {};

package/type-declarations/aics-image-viewer/state/reset.d.ts

@@ -1,7 +1,7 @@
 import type { StateCreator } from "zustand";
 import type { ViewerChannelSettings } from "../shared/utils/viewerChannelSettings";
-import type { ViewerState } from "../state/types";
 import type { ViewerStore } from "./store";
+import { type ViewerState } from "./types";
 export type ResetStateActions = {
     /**
      * Removes the channel from the list of channels to be reset (as given by

package/type-declarations/aics-image-viewer/state/serialize.d.ts

@@ -1,20 +1,54 @@
 import type { CameraState } from "@aics/vole-core";
-import { ViewMode } from "../shared/enums";
-import type { ChannelState, ViewerChannelStateParams, ViewerState, ViewerStateParams } from "./types";
+import type { CameraStateSnapshot, CameraStateStringified, ChannelState, ChannelStateSnapshot, ChannelStateStringified, ViewerState, ViewerStateSnapshot, ViewerStateStringified } from "./types";
+import { ViewMode } from "./types";
+/**
+ * Serializes an object with `string` keys to a compact `string` representation, where keys and values are separated
+ * by colons (`:`) and entries are separated by commas (`,`).
+ */
 export declare function objectToKeyValueList(obj: Record<string, string | undefined>): string;
-export declare function serializeCameraState(cameraState: Partial<CameraState>, removeDefaults: boolean, viewMode?: ViewMode): string | undefined;
 /**
- * Serializes a single viewer channel setting into a dictionary of URL parameters
- * (`ViewerChannelStateParams`).
+ * Converts a `CameraState` to a `CameraStateSnapshot`, suitable for serialization.
+ * @param cameraState The camera state to serialize.
+ * @param removeDefaults Whether to remove default values.
+ * @param viewMode The current view mode. Default `ViewMode.threeD`.
+ * @returns The resulting `CameraStateSnapshot`, or `undefined` if all values are default.
+ */
+export declare function cameraStateToSnapshot(cameraState: Partial<CameraState> | undefined, removeDefaults: boolean, viewMode?: ViewMode): CameraStateSnapshot | undefined;
+/**
+ * Converts a `ViewerState` to a `ViewerStateSnapshot`, suitable for serialization.
+ */
+export declare function viewerStateToSnapshot(state: Partial<ViewerState>, removeDefaults: boolean): ViewerStateSnapshot;
+export declare function channelStateToSnapshot(state: Partial<ChannelState>, removeDefaults: boolean): ChannelStateSnapshot;
+/**
+ * Converts all keys of a `CameraStateSnapshot` to compact `string` representations,
+ * for serialization to `string` formats.
+ */
+export declare const stringifyCameraStateSnapshot: (snapshot: CameraStateSnapshot) => CameraStateStringified;
+/**
+ * Converts all keys of a `ViewerStateSnapshot` to compact `string` representations,
+ * for serialization to `string` formats.
+ */
+export declare const stringifyViewerStateSnapshot: (snapshot: ViewerStateSnapshot) => ViewerStateStringified;
+/**
+ * Converts all keys of a `ChannelStateSnapshot` to compact `string` representations,
+ * for serialization to `string` formats.
+ */
+export declare const stringifyChannelStateSnapshot: (snapshot: ChannelStateSnapshot) => ChannelStateStringified;
+/**
+ * Converts a single viewer channel setting into a `ChannelStateStringified`.
+ *
+ * This is equivalent to (and implemented by) applying `channelStateToSnapshot`, then `stringifyChannelStateSnapshot`.
  * @param channelSetting The channel state object to serialize.
  * @param removeDefaults Whether to remove properties that match the output of `getDefaultChannelState`.
- * @returns A `ViewerChannelSettingParams` object with the serialized parameters. Undefined values are removed.
+ * @returns A `ChannelStateStringified` object with the serialized parameters. `undefined` values are removed.
  */
-export declare function serializeViewerChannelSetting(channelSetting: Partial<ChannelState>, removeDefaults: boolean): Partial<ViewerChannelStateParams>;
+export declare const channelStateToStringSnapshot: (channelSetting: Partial<ChannelState>, removeDefaults: boolean) => ChannelStateStringified;
 /**
- * Serializes a `ViewerState` object into a dictionary of URL parameters.
+ * Serializes a `ViewerState` object into a `ViewerStateStringified`.
+ *
+ * This is equivalent to (and implemented by) applying `viewerStateToSnapshot`, then `stringifyViewerStateSnapshot`.
  * @param state The `ViewerState` to serialize.
  * @param removeDefaults If true, remove properties that match the output of `getDefaultViewerState`.
- * @returns A `ViewerStateParams` object with the serialized parameters. Undefined values are removed.
+ * @returns A `ViewerStateStringified` object with the serialized parameters. `undefined` values are removed.
  */
-export declare function serializeViewerState(state: Partial<ViewerState>, removeDefaults: boolean): ViewerStateParams;
+export declare const viewerStateToStringSnapshot: (state: Partial<ViewerState>, removeDefaults: boolean) => ViewerStateStringified;