@vuu-ui/vuu-shell 3.5.7 → 3.5.8

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.5.7",
+  "version": "3.5.8",
   "description": "VUU UI Shell",
   "main": "./src/index.js",
   "author": "heswell",
@@ -10,23 +10,23 @@
     "type-defs": "node ../../scripts/build-type-defs.mjs"
   },
   "devDependencies": {
-    "@vuu-ui/vuu-data-types": "3.5.7",
-    "@vuu-ui/vuu-protocol-types": "3.5.7",
-    "@vuu-ui/vuu-table-types": "3.5.7"
+    "@vuu-ui/vuu-data-types": "3.5.8",
+    "@vuu-ui/vuu-protocol-types": "3.5.8",
+    "@vuu-ui/vuu-table-types": "3.5.8"
   },
   "dependencies": {
     "@salt-ds/core": "1.54.1",
     "@salt-ds/styles": "0.2.1",
     "@salt-ds/window": "0.1.1",
-    "@vuu-ui/vuu-context-menu": "3.5.7",
-    "@vuu-ui/vuu-data-react": "3.5.7",
-    "@vuu-ui/vuu-data-remote": "3.5.7",
-    "@vuu-ui/vuu-icons": "3.5.7",
-    "@vuu-ui/vuu-layout": "3.5.7",
-    "@vuu-ui/vuu-notifications": "3.5.7",
-    "@vuu-ui/vuu-table": "3.5.7",
-    "@vuu-ui/vuu-ui-controls": "3.5.7",
-    "@vuu-ui/vuu-utils": "3.5.7",
+    "@vuu-ui/vuu-context-menu": "3.5.8",
+    "@vuu-ui/vuu-data-react": "3.5.8",
+    "@vuu-ui/vuu-data-remote": "3.5.8",
+    "@vuu-ui/vuu-icons": "3.5.8",
+    "@vuu-ui/vuu-layout": "3.5.8",
+    "@vuu-ui/vuu-notifications": "3.5.8",
+    "@vuu-ui/vuu-table": "3.5.8",
+    "@vuu-ui/vuu-ui-controls": "3.5.8",
+    "@vuu-ui/vuu-utils": "3.5.8",
     "html-to-image": "^1.11.11"
   },
   "peerDependencies": {

package/types/module-registry/getRegisteredModules.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicFeatureDescriptor } from "@vuu-ui/vuu-utils";
+export type RemoteModules = {
+    modules: DynamicFeatureDescriptor[];
+};
+export declare const getRegisteredModules: (registryUrl: string, bearerToken: string) => Promise<RemoteModules>;

package/types/persistence-manager/LocalWorkspacePersistenceService.d.ts

@@ -0,0 +1,18 @@
+import { type ApplicationSessionV1, type NamedWorkspaceDefinitionV1, type NamedWorkspaceMetadataV1, type WorkspaceSnapshotRecordV1 } from "../workspace-management/workspace-schemas";
+import type { UserPersistenceScope, WorkspacePersistenceService } from "./WorkspacePersistenceService";
+export declare class LocalWorkspacePersistenceService implements WorkspacePersistenceService {
+    #private;
+    readonly scope: UserPersistenceScope;
+    constructor(scope: UserPersistenceScope, storage?: Storage);
+    loadApplicationSession(): Promise<ApplicationSessionV1 | undefined>;
+    saveApplicationSession(session: ApplicationSessionV1): Promise<void>;
+    deleteApplicationSession(): Promise<void>;
+    listWorkspaceSnapshots(): Promise<readonly WorkspaceSnapshotRecordV1[]>;
+    loadWorkspaceSnapshot(workspaceInstanceId: string): Promise<WorkspaceSnapshotRecordV1 | undefined>;
+    saveWorkspaceSnapshot(snapshot: WorkspaceSnapshotRecordV1): Promise<void>;
+    deleteWorkspaceSnapshot(workspaceInstanceId: string): Promise<void>;
+    listNamedWorkspaceMetadata(): Promise<readonly NamedWorkspaceMetadataV1[]>;
+    loadNamedWorkspaceDefinition(id: string): Promise<NamedWorkspaceDefinitionV1 | undefined>;
+    saveNamedWorkspaceDefinition(definition: NamedWorkspaceDefinitionV1): Promise<void>;
+    deleteNamedWorkspaceDefinition(id: string): Promise<void>;
+}

package/types/persistence-manager/RemoteWorkspacePersistenceService.d.ts

@@ -0,0 +1,25 @@
+import { type ApplicationSessionV1, type NamedWorkspaceDefinitionV1, type NamedWorkspaceMetadataV1, type WorkspaceSnapshotRecordV1 } from "../workspace-management/workspace-schemas";
+import type { UserPersistenceScope, WorkspacePersistenceService } from "./WorkspacePersistenceService";
+export type WorkspaceRequestInitProvider = () => RequestInit | Promise<RequestInit>;
+export interface RemoteWorkspacePersistenceOptions {
+    readonly baseUrl: string;
+    readonly requestInit?: RequestInit;
+    readonly requestInitProvider?: WorkspaceRequestInitProvider;
+    readonly fetch?: typeof fetch;
+}
+export declare class RemoteWorkspacePersistenceService implements WorkspacePersistenceService {
+    #private;
+    readonly scope: UserPersistenceScope;
+    constructor(scope: UserPersistenceScope, { baseUrl, requestInit, requestInitProvider, fetch: fetchImplementation, }: RemoteWorkspacePersistenceOptions);
+    loadApplicationSession(): Promise<ApplicationSessionV1 | undefined>;
+    saveApplicationSession(session: ApplicationSessionV1): Promise<void>;
+    deleteApplicationSession(): Promise<void>;
+    listWorkspaceSnapshots(): Promise<readonly WorkspaceSnapshotRecordV1[]>;
+    loadWorkspaceSnapshot(workspaceInstanceId: string): Promise<WorkspaceSnapshotRecordV1 | undefined>;
+    saveWorkspaceSnapshot(snapshot: WorkspaceSnapshotRecordV1): Promise<void>;
+    deleteWorkspaceSnapshot(workspaceInstanceId: string): Promise<void>;
+    listNamedWorkspaceMetadata(): Promise<readonly NamedWorkspaceMetadataV1[]>;
+    loadNamedWorkspaceDefinition(id: string): Promise<NamedWorkspaceDefinitionV1 | undefined>;
+    saveNamedWorkspaceDefinition(definition: NamedWorkspaceDefinitionV1): Promise<void>;
+    deleteNamedWorkspaceDefinition(id: string): Promise<void>;
+}

package/types/persistence-manager/WorkspacePersistenceService.d.ts

@@ -0,0 +1,27 @@
+import type { ApplicationSessionV1, NamedWorkspaceDefinitionV1, NamedWorkspaceMetadataV1, WorkspaceSnapshotRecordV1 } from "../workspace-management/workspace-schemas";
+export interface PersistenceScope {
+    readonly applicationNamespace: string;
+    readonly applicationId: string;
+}
+export interface UserPersistenceScope extends PersistenceScope {
+    readonly userId: string;
+}
+export interface WorkspacePersistenceService {
+    readonly scope: UserPersistenceScope;
+    loadApplicationSession(): Promise<ApplicationSessionV1 | undefined>;
+    saveApplicationSession(session: ApplicationSessionV1): Promise<void>;
+    deleteApplicationSession(): Promise<void>;
+    listWorkspaceSnapshots(): Promise<readonly WorkspaceSnapshotRecordV1[]>;
+    loadWorkspaceSnapshot(workspaceInstanceId: string): Promise<WorkspaceSnapshotRecordV1 | undefined>;
+    saveWorkspaceSnapshot(snapshot: WorkspaceSnapshotRecordV1): Promise<void>;
+    deleteWorkspaceSnapshot(workspaceInstanceId: string): Promise<void>;
+    listNamedWorkspaceMetadata(): Promise<readonly NamedWorkspaceMetadataV1[]>;
+    loadNamedWorkspaceDefinition(id: string): Promise<NamedWorkspaceDefinitionV1 | undefined>;
+    saveNamedWorkspaceDefinition(definition: NamedWorkspaceDefinitionV1): Promise<void>;
+    deleteNamedWorkspaceDefinition(id: string): Promise<void>;
+}
+export declare class WorkspacePersistenceError extends Error {
+    readonly operation: string;
+    readonly status?: number | undefined;
+    constructor(message: string, operation: string, status?: number | undefined);
+}

package/types/shell-layout-templates/context-panel/ApplicationSettingsContextPanel.d.ts

@@ -0,0 +1 @@
+export declare const ApplicationSettingsContextPanel: () => import("react/jsx-runtime").JSX.Element;

package/types/src/ShellContextProvider.d.ts

@@ -0,0 +1,7 @@
+import { ShellContextProps } from "@vuu-ui/vuu-utils";
+import { ReactElement, ReactNode } from "react";
+export interface ShellProviderProps {
+    children: ReactNode;
+    value?: ShellContextProps;
+}
+export declare const ShellContextProvider: ({ children, value, }: ShellProviderProps) => ReactElement;

package/types/src/app-header/AppHeader.d.ts

@@ -0,0 +1,6 @@
+import type { ThemeMode } from "@vuu-ui/vuu-utils";
+import { HTMLAttributes } from "react";
+export interface AppHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    themeMode?: ThemeMode;
+}
+export declare const AppHeader: ({ className: classNameProp, themeMode: _, ...htmlAttributes }: AppHeaderProps) => import("react").JSX.Element;

package/types/src/app-header/index.d.ts

@@ -0,0 +1 @@
+export * from './AppHeader';

package/types/src/application-provider/ApplicationContext.d.ts

@@ -0,0 +1,11 @@
+import type { Settings, VuuUser } from "@vuu-ui/vuu-utils";
+import { VuuRowDataItemType } from "@vuu-ui/vuu-protocol-types";
+import { SettingsSchema } from "../user-settings";
+export interface ApplicationContextProps {
+    onUserSettingChanged: (propertyName: string, value: VuuRowDataItemType) => void;
+    logout?: () => void;
+    userSettings?: Settings;
+    userSettingsSchema?: SettingsSchema;
+    user: VuuUser;
+}
+export declare const ApplicationContext: import("react").Context<ApplicationContextProps>;

package/types/src/application-provider/ApplicationProvider.d.ts

@@ -0,0 +1,17 @@
+import { VuuRowDataItemType } from "@vuu-ui/vuu-protocol-types";
+import { Density, ThemeContextProps } from "@salt-ds/core";
+import { ReactElement, ReactNode } from "react";
+import { ApplicationContextProps } from "./ApplicationContext";
+export interface ApplicationProviderProps extends Partial<Pick<ThemeContextProps, "theme" | "mode">>, Partial<Omit<ApplicationContextProps, "userSettings">> {
+    children: ReactNode;
+    density?: Density;
+}
+export declare const ApplicationProvider: ({ children, density: densityProp, logout, mode, theme, userSettingsSchema: userSettingsSchema, user, }: ApplicationProviderProps) => ReactElement | null;
+export declare const useApplicationUser: () => import("@vuu-ui/vuu-utils").VuuUser;
+export declare const useApplicationSettings: () => {
+    onUserSettingChanged: (propertyName: string, value: VuuRowDataItemType) => void;
+    userSettings: import("@vuu-ui/vuu-utils").Settings | undefined;
+    userSettingsSchema: import("..").SettingsSchema | undefined;
+};
+export declare const useUserSetting: () => import("@vuu-ui/vuu-utils").Settings | undefined;
+export declare const useLogout: () => (() => void) | undefined;

package/types/src/application-provider/index.d.ts

@@ -0,0 +1 @@
+export * from "./ApplicationProvider";

package/types/src/feature/Feature.d.ts

@@ -0,0 +1,10 @@
+import { DynamicFeatureProps } from "@vuu-ui/vuu-utils";
+import React from "react";
+declare function RawFeature<Params extends object | undefined>({ url, css, ComponentProps: params, ...props }: DynamicFeatureProps<Params>): React.JSX.Element;
+/**
+  Feature is a wrapper around React Lazy Loading. It will load a component
+  from the given url. That url must resolve to a javascript bundle with a
+  single default export. That export must be a React component.
+ */
+export declare const Feature: React.MemoExoticComponent<typeof RawFeature>;
+export {};

package/types/src/feature/FeatureErrorBoundary.d.ts

@@ -0,0 +1,13 @@
+import { DynamicFeatureProps } from "@vuu-ui/vuu-utils";
+import React, { ErrorInfo, ReactNode } from "react";
+export interface FeatureErrorBoundaryProps extends DynamicFeatureProps {
+    children: ReactNode;
+}
+export declare class FeatureErrorBoundary extends React.Component<FeatureErrorBoundaryProps, any> {
+    constructor(props: FeatureErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): {
+        errorMessage: string;
+    };
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): string | number | bigint | boolean | React.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.ReactPortal | null | undefined> | null | undefined;
+}

package/types/src/feature/Loader.d.ts

@@ -0,0 +1 @@
+export declare const Loader: () => import("react").JSX.Element;

package/types/src/feature/index.d.ts

@@ -0,0 +1 @@
+export * from './Feature';

package/types/src/feature-and-layout-provider/FeatureAndLayoutProvider.d.ts

@@ -0,0 +1,19 @@
+import { DynamicFeatureDescriptor, DynamicFeatureProps, FilterTableFeatureProps, StaticFeatureDescriptor, SystemLayoutMetadata } from "@vuu-ui/vuu-utils";
+import { ReactElement, ReactNode } from "react";
+export interface FeatureContextProps {
+    dynamicFeatures?: DynamicFeatureProps[];
+    tableFeatures?: DynamicFeatureProps<FilterTableFeatureProps>[];
+    staticFeatures?: StaticFeatureDescriptor[];
+}
+export interface LayoutContextProps {
+    systemLayouts?: SystemLayoutMetadata[];
+}
+export interface FeatureAndLayoutProviderProps extends Partial<FeatureContextProps> {
+    children: ReactNode;
+    dynamicFeatures?: DynamicFeatureDescriptor[];
+    staticFeatures?: StaticFeatureDescriptor[];
+    systemLayouts?: SystemLayoutMetadata[];
+}
+export declare const FeatureAndLayoutProvider: ({ children, dynamicFeatures: dynamicFeaturesProp, staticFeatures, systemLayouts, }: FeatureAndLayoutProviderProps) => ReactElement;
+export declare const useFeatures: () => FeatureContextProps;
+export declare const useLayouts: () => LayoutContextProps;

package/types/src/feature-and-layout-provider/index.d.ts

@@ -0,0 +1 @@
+export * from "./FeatureAndLayoutProvider";

package/types/src/feature-list/FeatureList.d.ts

@@ -0,0 +1,7 @@
+import { DynamicFeatureProps, StaticFeatureDescriptor } from "@vuu-ui/vuu-utils";
+import { HTMLAttributes } from "react";
+export type GroupedFeatureProps<P extends object | undefined = object> = Record<string, DynamicFeatureProps<P>[]>;
+export interface FeatureListProps extends HTMLAttributes<HTMLDivElement> {
+    features: DynamicFeatureProps[] | GroupedFeatureProps | StaticFeatureDescriptor[];
+}
+export declare const FeatureList: ({ features, title, ...htmlAttributes }: FeatureListProps) => import("react").JSX.Element;

package/types/src/feature-list/index.d.ts

@@ -0,0 +1 @@
+export * from "./FeatureList";

package/types/src/get-layout-history.d.ts

@@ -0,0 +1,8 @@
+import type { VuuUser } from "@vuu-ui/vuu-utils";
+export interface LayoutHistoryItem {
+    user: string;
+    id: string;
+    uniqueId: string;
+    lastUpdate: number;
+}
+export declare const getLayoutHistory: (user: VuuUser) => Promise<LayoutHistoryItem[]>;

package/types/src/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./application-provider";
+export * from "./app-header";
+export * from "./feature";
+export * from "./feature-and-layout-provider";
+export * from "./left-nav";
+export { LoginPanel, type LoginPanelProps } from "./login/LoginPanel";
+export * from "./persistence-manager";
+export * from "./shell";
+export * from "./shell-layout-templates";
+export * from "./ShellContextProvider";
+export * from "./feature-list";
+export * from "./theme-switch";
+export * from "./user-settings";
+export * from "./workspace-management";

package/types/src/left-nav/LeftNav.d.ts

@@ -0,0 +1,14 @@
+import { type HTMLAttributes } from "react";
+export type NavDisplayStatus = "menu-full" | "menu-icons" | "menu-full-content" | "menu-icons-content";
+export type NavDisplayStatusHandler = (navDisplayStatus: NavDisplayStatus) => void;
+export interface LeftNavProps extends HTMLAttributes<HTMLDivElement> {
+    "data-path"?: string;
+    defaultActiveTabIndex?: number;
+    defaultExpanded?: boolean;
+    onActiveChange?: (activeTabIndex: number) => void;
+    onTogglePrimaryMenu?: (expanded: boolean) => void;
+    sizeCollapsed?: number;
+    sizeContent?: number;
+    sizeExpanded?: number;
+}
+export declare const LeftNav: (props: LeftNavProps) => import("react").JSX.Element;

package/types/src/left-nav/index.d.ts

@@ -0,0 +1 @@
+export * from "./LeftNav";

package/types/src/login/LoginPanel.d.ts

@@ -0,0 +1,6 @@
+import { HTMLAttributes } from "react";
+export interface LoginPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmit"> {
+    appName?: string;
+    onSubmit: (username: string, password: string) => void;
+}
+export declare const LoginPanel: ({ appName, className, onSubmit, ...htmlAttributes }: LoginPanelProps) => import("react").JSX.Element;

package/types/src/login/VuuLogo.d.ts

@@ -0,0 +1 @@
+export declare const VuuLogo: () => import("react").JSX.Element;

package/types/src/persistence-manager/LocalPersistenceManager.d.ts

@@ -0,0 +1,20 @@
+import { ApplicationJSON, LayoutJSON, Settings, Layout, LayoutMetadata, LayoutMetadataDto } from "@vuu-ui/vuu-utils";
+import { IPersistenceManager } from "./PersistenceManager";
+export declare class LocalPersistenceManager implements IPersistenceManager {
+    #private;
+    constructor(userName: string, urlKey?: string);
+    clearUserSettings(): void;
+    createLayout(metadata: LayoutMetadataDto, layout: LayoutJSON): Promise<LayoutMetadata>;
+    updateLayout(id: string, newMetadata: LayoutMetadataDto, newLayout: LayoutJSON): Promise<void>;
+    deleteLayout(id: string): Promise<void>;
+    loadLayout(id: string): Promise<LayoutJSON>;
+    loadMetadata(): Promise<LayoutMetadata[]>;
+    loadApplicationJSON(): Promise<ApplicationJSON | undefined>;
+    saveApplicationJSON(applicationJSON: ApplicationJSON): Promise<void>;
+    loadLayouts: () => Promise<Layout[]>;
+    saveLayoutsWithMetadata: (layouts: Layout[], metadata: LayoutMetadata[]) => void;
+    validateIds: (id: string) => Promise<void>;
+    validateId: (id: string, dataType: "metadata" | "layout") => Promise<void>;
+    getUserSettings(): Promise<Settings>;
+    saveUserSettings(userSettings: Settings): void;
+}

package/types/src/persistence-manager/PersistenceManager.d.ts

@@ -0,0 +1,71 @@
+import type { ApplicationJSON, LayoutJSON, LayoutMetadata, LayoutMetadataDto, Settings } from "@vuu-ui/vuu-utils";
+export interface IPersistenceManager {
+    /**
+     *  Clear saved user settings/preferences. Right now, this clears ALL saved
+     * settimgs for user. We will introduce a more fine grained scheme here.
+     */
+    clearUserSettings: () => void;
+    /**
+     * Saves a new layout and its corresponding metadata
+     *
+     * @param metadata - Metadata about the layout to be saved
+     * @param layout   - Full JSON representation of the layout to be saved
+     *
+     * @returns Unique identifier assigned to the saved layout
+     */
+    createLayout: (metadata: LayoutMetadataDto, layout: LayoutJSON) => Promise<LayoutMetadata>;
+    /**
+     * Overwrites an existing layout and its corresponding metadata with the provided information
+     *
+     * @param id       - Unique identifier of the existing layout to be updated
+     * @param metadata - Metadata describing the new layout to overwrite with
+     * @param layout   - Full JSON representation of the new layout to overwrite with
+     */
+    updateLayout: (id: string, metadata: LayoutMetadataDto, layout: LayoutJSON) => Promise<void>;
+    /**
+     * Deletes an existing layout and its corresponding metadata
+     *
+     * @param id - Unique identifier of the existing layout to be deleted
+     */
+    deleteLayout: (id: string) => Promise<void>;
+    /**
+     * Retrieves an existing layout
+     *
+     * @param id - Unique identifier of the existing layout to be retrieved
+     *
+     * @returns Full JSON representation of the layout corresponding to the provided ID
+     */
+    loadLayout: (id: string) => Promise<LayoutJSON>;
+    /**
+     * Retrieves metadata for all existing layouts
+     *
+     * @returns an array of all persisted layout metadata
+     */
+    loadMetadata: () => Promise<LayoutMetadata[]>;
+    /**
+     * Retrieves the application JSON. This includes the application layout,
+     * which describes all layouts on screen
+     *
+     * @returns Full JSON representation of the application json
+     */
+    loadApplicationJSON: () => Promise<ApplicationJSON | undefined>;
+    /**
+     * Saves the application JSON.  This includes the application layout,
+     * which describes all layouts on screen
+     *
+     * @param layout - Full JSON representation of the application layout to be saved
+     */
+    saveApplicationJSON: (layout: ApplicationJSON) => Promise<void>;
+    /**
+     * Save user settings. These get saved within the Application JSON.
+     *
+     * @param userSettings
+     */
+    saveUserSettings: (userSettings: Settings) => void;
+    /**
+     * Get the user settings. These are stored within Application JSON.
+     *
+     * @returns userSettings
+     */
+    getUserSettings: () => Promise<Settings>;
+}

package/types/src/persistence-manager/PersistenceProvider.d.ts

@@ -0,0 +1,11 @@
+import { ReactElement, ReactNode } from "react";
+import { IPersistenceManager } from ".";
+export interface PersistenceContextProps {
+    persistenceManager?: IPersistenceManager;
+}
+export declare const PersistenceContext: import("react").Context<PersistenceContextProps>;
+export interface PersistenceProviderProps extends PersistenceContextProps {
+    children: ReactNode;
+}
+export declare const PersistenceProvider: ({ children, persistenceManager, }: PersistenceProviderProps) => ReactElement;
+export declare const usePersistenceManager: () => IPersistenceManager | undefined;

package/types/src/persistence-manager/RemotePersistenceManager.d.ts

@@ -0,0 +1,25 @@
+import { ApplicationJSON, LayoutJSON, LayoutMetadata, LayoutMetadataDto, Settings } from "@vuu-ui/vuu-utils";
+import { IPersistenceManager } from "./PersistenceManager";
+export type CreateLayoutResponseDto = {
+    metadata: LayoutMetadata;
+};
+export type GetLayoutResponseDto = {
+    definition: LayoutJSON;
+};
+export type GetApplicationResponseDto = {
+    definition: ApplicationJSON;
+};
+export declare class RemotePersistenceManager implements IPersistenceManager {
+    private userName;
+    constructor(userName: string);
+    createLayout(metadata: LayoutMetadataDto, layout: LayoutJSON): Promise<LayoutMetadata>;
+    clearUserSettings(): void;
+    updateLayout(id: string, metadata: LayoutMetadataDto, newLayoutJson: LayoutJSON): Promise<void>;
+    deleteLayout(id: string): Promise<void>;
+    loadLayout(id: string): Promise<LayoutJSON>;
+    loadMetadata(): Promise<LayoutMetadata[]>;
+    saveApplicationJSON(applicationJSON: ApplicationJSON): Promise<void>;
+    loadApplicationJSON(): Promise<ApplicationJSON>;
+    getUserSettings(): Promise<{}>;
+    saveUserSettings(userSettings: Settings): void;
+}

package/types/src/persistence-manager/StaticPersistenceManager.d.ts

@@ -0,0 +1,25 @@
+import { ApplicationJSON, LayoutJSON, LayoutMetadata, Settings } from "@vuu-ui/vuu-utils";
+import { IPersistenceManager } from "./PersistenceManager";
+/**
+ * Use in Showcase examples only
+ */
+export declare class StaticPersistenceManager implements IPersistenceManager {
+    #private;
+    constructor({ applicationJSON, applicationLoadDelay, layoutMetadata, }: {
+        applicationJSON?: ApplicationJSON;
+        applicationLoadDelay?: number;
+        layoutMetadata?: LayoutMetadata[];
+    });
+    createLayout(): Promise<LayoutMetadata>;
+    clearUserSettings(): void;
+    updateLayout(): Promise<void>;
+    deleteLayout(): Promise<void>;
+    loadLayout(id: string): Promise<LayoutJSON<{
+        [key: string]: any;
+    }>>;
+    loadMetadata(): Promise<LayoutMetadata[]>;
+    loadApplicationJSON(): Promise<ApplicationJSON | undefined>;
+    saveApplicationJSON(applicationJson: ApplicationJSON): Promise<void>;
+    getUserSettings(): Promise<Settings>;
+    saveUserSettings(userSettings: Settings): void;
+}

package/types/src/persistence-manager/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./PersistenceManager";
+export * from "./PersistenceProvider";
+export * from "./LocalPersistenceManager";
+export * from "./RemotePersistenceManager";
+export * from "./StaticPersistenceManager";

package/types/src/shell-layout-templates/context-panel/ContextPanel.d.ts

@@ -0,0 +1,13 @@
+import { LayoutJSON } from "@vuu-ui/vuu-utils";
+import React, { ReactElement, ReactNode } from "react";
+export interface ContextPanelProps {
+    [key: string]: unknown;
+    className?: string;
+    content?: ReactElement | LayoutJSON;
+    expanded?: boolean;
+    id?: string;
+    onClose?: () => void;
+    overlay?: boolean;
+    title?: ReactNode;
+}
+export declare const ContextPanel: ({ className: classNameProp, expanded, content: contentProp, id, onClose, overlay, title, }: ContextPanelProps) => React.JSX.Element;

package/types/src/shell-layout-templates/context-panel/index.d.ts

@@ -0,0 +1 @@
+export * from "./ContextPanel";

package/types/src/shell-layout-templates/full-height-left-panel/useFullHeightLeftPanel.d.ts

@@ -0,0 +1,2 @@
+import { ShellLayoutTemplateHook } from "../useShellLayout";
+export declare const useFullHeightLeftPanel: ShellLayoutTemplateHook;

package/types/src/shell-layout-templates/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./context-panel";
+export * from "./useShellLayout";
+export * from "./side-panel";

package/types/src/shell-layout-templates/inlay-left-panel/useInlayLeftPanel.d.ts

@@ -0,0 +1,2 @@
+import { ShellLayoutTemplateHook } from "../useShellLayout";
+export declare const useInlayLeftPanel: ShellLayoutTemplateHook;

package/types/src/shell-layout-templates/left-main-tabs/useLeftMainTabs.d.ts

@@ -0,0 +1,2 @@
+import { ShellLayoutTemplateHook } from "../useShellLayout";
+export declare const useLeftMainTabs: ShellLayoutTemplateHook;

package/types/src/shell-layout-templates/side-panel/SidePanel.d.ts

@@ -0,0 +1,8 @@
+import { HTMLAttributes } from "react";
+export interface SidePanelProps extends HTMLAttributes<HTMLDivElement> {
+    open?: boolean;
+    path?: string;
+    sizeOpen?: number;
+    sizeClosed?: number;
+}
+export declare const SidePanel: ({ children, open, sizeClosed, sizeOpen, style: styleProp, ...htmlAttributes }: SidePanelProps) => import("react").JSX.Element;

package/types/src/shell-layout-templates/side-panel/index.d.ts

@@ -0,0 +1 @@
+export * from "./SidePanel";

package/types/src/shell-layout-templates/simple-content-pane/useSimpleContentPane.d.ts

@@ -0,0 +1,2 @@
+import { ShellLayoutTemplateHook } from "../useShellLayout";
+export declare const useSimpleContentPane: ShellLayoutTemplateHook;

package/types/src/shell-layout-templates/useShellLayout.d.ts

@@ -0,0 +1,51 @@
+import { HTMLAttributes, ReactElement, ReactNode } from "react";
+import { SidePanelProps as ShellSidePanelProps } from "./side-panel";
+declare const LayoutHook: {
+    "full-height": ShellLayoutTemplateHook;
+    inlay: ShellLayoutTemplateHook;
+    "left-main-tabs": ShellLayoutTemplateHook;
+    "simple-content-pane": ShellLayoutTemplateHook;
+};
+export type LayoutTemplateId = keyof typeof LayoutHook;
+export type ShellLayoutTemplateProps = Omit<ShellLayoutProps, "layoutTemplateId">;
+export type ShellToolbarProps = {
+    children: ReactNode;
+    position?: "left";
+    width?: number;
+};
+export type ShellLayoutTemplateHook = (props: ShellLayoutTemplateProps) => ReactElement;
+/**
+ * The Shell Layout is the outermost 'chrome' of the appliciation,
+ * enclosing the main content area. It will be rendered by one of
+ * two available templates, determined by the layoutTemplateId,
+ */
+export interface ShellLayoutProps {
+    /**
+     * App Header will be rendered in position determined by layout-template
+     */
+    appHeader?: ReactNode;
+    /**
+     * HTML attributes that will be applied to root div.
+     */
+    htmlAttributes?: HTMLAttributes<HTMLDivElement>;
+    /**
+     * identifier for shell layout template to be used. Default template
+     * will be "inlay"
+     */
+    layoutTemplateId?: LayoutTemplateId;
+    /**
+     * If template renders SidePanel, these props will be provided
+     */
+    SidePanelProps?: ShellSidePanelProps;
+    /**
+     * If template renders Toolbar, these props will be provided
+     */
+    ToolbarProps?: ShellToolbarProps;
+}
+/**
+ * This hook acts as a stub for the actual shell layout
+ * template hooks. It will delegate to the appropriate shell
+ * layout hook, based on the value of layoutTemplateId.
+ */
+export declare const useShellLayout: ({ layoutTemplateId, ...props }: ShellLayoutProps) => ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export {};

package/types/src/shell.d.ts

@@ -0,0 +1,17 @@
+import { VuuUser } from "@vuu-ui/vuu-utils";
+import { type HTMLAttributes, type ReactNode } from "react";
+import { ShellLayoutProps } from "./shell-layout-templates";
+import { SettingsSchema } from "./user-settings";
+import { WorkspaceProps } from "./workspace-management";
+export type LayoutTemplateName = "full-height" | "inlay";
+export interface ShellProps extends HTMLAttributes<HTMLDivElement> {
+    shellLayoutProps?: ShellLayoutProps;
+    userSettingsSchema?: SettingsSchema;
+    workspaceProps?: WorkspaceProps;
+    children?: ReactNode;
+    logout?: () => void;
+    saveUrl?: string;
+    serverUrl?: string;
+    user: VuuUser;
+}
+export declare const Shell: ({ logout, user, userSettingsSchema, workspaceProps, ...props }: ShellProps) => import("react").JSX.Element;

package/types/src/theme-switch/ThemeSwitch.d.ts

@@ -0,0 +1,8 @@
+import { HTMLAttributes } from "react";
+import { ThemeMode } from "@vuu-ui/vuu-utils";
+export interface ThemeSwitchProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    defaultMode?: ThemeMode;
+    mode?: ThemeMode;
+    onChange: (mode: ThemeMode) => void;
+}
+export declare const ThemeSwitch: ({ className: classNameProp, defaultMode: defaultModeProp, mode: modeProp, onChange, ...htmlAttributes }: ThemeSwitchProps) => import("react").JSX.Element;

package/types/src/theme-switch/index.d.ts

@@ -0,0 +1 @@
+export * from "./ThemeSwitch";

package/types/src/user-settings/SettingsForm.d.ts

@@ -0,0 +1,46 @@
+import type { VuuRowDataItemType } from "@vuu-ui/vuu-protocol-types";
+import { type Settings } from "@vuu-ui/vuu-utils";
+import { type DropdownProps } from "@salt-ds/core";
+import { type FormEventHandler, type HTMLAttributes } from "react";
+export interface SettingsSchema {
+    properties: SettingsProperty[];
+}
+export type OptionType<T> = {
+    label: string;
+    value: T;
+};
+export declare const isOption: (value: OptionType<number | string> | number | string) => value is OptionType<number | string>;
+export interface BaseProperty {
+    name: string;
+    label: string;
+}
+export interface StringProperty extends BaseProperty {
+    values?: string[] | OptionType<string>[];
+    defaultValue?: string;
+    type: "string";
+}
+export interface NumericProperty extends BaseProperty {
+    values?: number[] | OptionType<number>[];
+    defaultValue?: number;
+    type: "number";
+}
+export interface BooleanProperty extends BaseProperty {
+    defaultValue?: boolean;
+    type: "boolean";
+}
+export type SettingsProperty = StringProperty | NumericProperty | BooleanProperty;
+export declare const isBooleanProperty: (property: SettingsProperty) => property is BooleanProperty;
+export declare const isStringOrNumber: (value: unknown) => value is string | number;
+export declare function FormControl({ property, changeHandler, selectHandler, inputHandler, currentValue, }: {
+    property: SettingsProperty;
+    changeHandler: FormEventHandler;
+    selectHandler: DropdownProps["onSelectionChange"];
+    inputHandler: FormEventHandler;
+    currentValue: VuuRowDataItemType;
+}): import("react").JSX.Element | null;
+export interface SettingsFormProps extends HTMLAttributes<HTMLDivElement> {
+    settingsSchema: SettingsSchema;
+    settings: Settings;
+    onSettingChanged: (propertyName: string, value: string | number | boolean) => void;
+}
+export declare const SettingsForm: ({ className, settingsSchema, settings, onSettingChanged, ...htmlAttributes }: SettingsFormProps) => import("react").JSX.Element;

package/types/src/user-settings/UserSettingsPanel.d.ts

@@ -0,0 +1,3 @@
+import { HTMLAttributes } from "react";
+export type UserSettingsPanelProps = HTMLAttributes<HTMLDivElement>;
+export declare const UserSettingsPanel: ({ ...htmlAttributes }: UserSettingsPanelProps) => import("react").JSX.Element | null;

package/types/src/user-settings/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./UserSettingsPanel";
+export * from "./SettingsForm";

package/types/src/workspace-management/LayoutList.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from "react";
+export declare const LayoutList: ({ className, title, ...htmlAttributes }: HTMLAttributes<HTMLDivElement>) => import("react").JSX.Element;

package/types/src/workspace-management/LayoutTile.d.ts

@@ -0,0 +1,7 @@
+import { LayoutJSON, LayoutMetadata, SystemLayoutMetadata } from "@vuu-ui/vuu-utils";
+import { HTMLAttributes } from "react";
+export interface LayoutTileProps extends HTMLAttributes<HTMLDivElement> {
+    metadata: LayoutMetadata | SystemLayoutMetadata;
+    onLoadLayout: (layoutId?: string, layoutJSON?: LayoutJSON) => void;
+}
+export declare const LayoutTile: ({ metadata, onLoadLayout, ...htmlAttributes }: LayoutTileProps) => import("react").JSX.Element;

package/types/src/workspace-management/SaveLayoutPanel.d.ts

@@ -0,0 +1,9 @@
+import { LayoutMetadataDto } from "@vuu-ui/vuu-utils";
+type SaveLayoutPanelProps = {
+    componentId?: string;
+    defaultTitle?: string;
+    onCancel: () => void;
+    onSave: (layoutMetadata: LayoutMetadataDto) => void;
+};
+export declare const SaveLayoutPanel: (props: SaveLayoutPanelProps) => import("react").JSX.Element;
+export {};

package/types/src/workspace-management/WorkspaceProvider.d.ts

@@ -0,0 +1,52 @@
+import { LayoutMetadata, LayoutMetadataDto, type ApplicationSetting, type ApplicationSettings, type LayoutJSON } from "@vuu-ui/vuu-utils";
+import { ReactElement } from "react";
+import { type WorkspaceStackProps } from "./defaultWorkspaceJSON";
+export type WorkspaceProps = WorkspaceStackProps & {
+    layoutPlaceholderJSON?: LayoutJSON;
+    /**
+     * layoutJSON defines the default layout to render on first load and until such time as
+     * layout state has been persisted. After that, the persisted state will be rendered.
+     */
+    layoutJSON?: LayoutJSON | LayoutJSON[];
+    activeLayoutIndex?: number;
+    /**
+     * The Vuu workspace is the container into which layouts are loaded. By default, it will be
+     * a Tabbed Panel (Stack + Tabstrip), showing a tab per Layout.
+     */
+    workspaceJSON?: LayoutJSON | LayoutJSON[];
+};
+export interface WorkspaceProviderProps extends WorkspaceProps {
+    children: ReactElement | ReactElement[];
+    /**
+     * layoutPlaceholderJSON defines the layout to render when a new workspace layout is created.
+     */
+    layoutPlaceholderJSON?: LayoutJSON;
+}
+/**
+ * LayoutManagementProvider supplies an API for loading and saving layout documents.
+ * Initial layout is automatically loaded on startup. Because this hook is responsible
+ * only for loading and saving layouts, it only triggers a render when content is loaded.
+ *
+ * Initial layout displays a loading state
+ * User may supply a default layout. This will not be displayed until call has been made to
+ * persistenceManager to retrieve stored layout state. If no stored state is returned, the
+ * default layout provided by user will be set as current state (and hence rendered). If no
+ * default layout has been provided by user, the sysem default will be used (simple PlaceHolder)
+ * If saved layout state has been returned, that will be set as current state (and rendered)
+ *
+ */
+export declare const WorkspaceProvider: ({ TabstripProps, children, layoutJSON, activeLayoutIndex, layoutPlaceholderJSON, showTabs, workspaceJSON: customWorkspaceJSON, }: WorkspaceProviderProps) => import("react").JSX.Element;
+export declare const useWorkspace: () => {
+    layoutMetadata: LayoutMetadata[];
+    layoutPlaceholderJSON?: LayoutJSON;
+    getApplicationSettings: (key?: keyof ApplicationSettings) => ApplicationSettings | ApplicationSetting | undefined;
+    loadLayoutById: (id: string) => void;
+    saveApplicationSettings: (settings: ApplicationSettings | ApplicationSetting, key?: keyof ApplicationSettings) => void;
+    saveLayout: (n: LayoutMetadataDto) => void;
+    saveApplicationLayout: (layout: LayoutJSON) => void;
+    workspaceJSON: LayoutJSON<{
+        [key: string]: any;
+    }>[] | LayoutJSON<{
+        [key: string]: any;
+    }>;
+};

package/types/src/workspace-management/defaultWorkspaceJSON.d.ts

@@ -0,0 +1,10 @@
+import { StackProps } from "@vuu-ui/vuu-layout";
+import { LayoutJSON } from "@vuu-ui/vuu-utils";
+export type WorkspaceStackProps = Pick<StackProps, "showTabs" | "TabstripProps">;
+export declare const warningLayout: LayoutJSON;
+export declare const loadingJSON: Readonly<LayoutJSON>;
+export declare const defaultWorkspaceJSON: LayoutJSON<StackProps & {
+    preserve: boolean;
+}>;
+export declare const getStackWorkspaceJSON: (activeLayoutIndex?: number) => LayoutJSON;
+export declare const getWorkspaceWithLayoutJSON: (customWorkspaceJSON?: LayoutJSON | LayoutJSON[], layoutJSON?: LayoutJSON | LayoutJSON[], activeLayoutIndex?: number, stackProps?: WorkspaceStackProps) => LayoutJSON | LayoutJSON[];

package/types/src/workspace-management/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./SaveLayoutPanel";
+export * from "./LayoutList";
+export * from "./WorkspaceProvider";
+export * from "./defaultWorkspaceJSON";
+export * from "./useWorkspaceContextMenuItems";

package/types/src/workspace-management/screenshot-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Takes a screenshot of the given node and returns the base64 encoded image url
+ * @param node HTMLElement to take screenshot of
+ * @returns Base64 encoded image url
+ */
+export declare const takeScreenshot: (node: HTMLElement) => Promise<string>;

package/types/src/workspace-management/useWorkspaceContextMenuItems.d.ts

@@ -0,0 +1,5 @@
+import { MenuActionHandler, MenuBuilder } from "@vuu-ui/vuu-context-menu";
+export declare const useWorkspaceContextMenuItems: () => {
+    buildMenuOptions: MenuBuilder;
+    handleMenuAction: MenuActionHandler;
+};

package/types/workspace-management/WorkspaceController.d.ts

@@ -0,0 +1,32 @@
+import { GridLayoutDocumentController, type GridComponentRendererRegistry, type GridComponentSettingsRegistry, type GridLayoutDocument, type GridLayoutDocumentChange } from "@vuu-ui/grid-layout";
+import type { WorkspacePersistenceService } from "../persistence-manager";
+import { WorkspacePersistentStateStore } from "./WorkspacePersistentState";
+import { WorkspaceRepository } from "./WorkspaceRepository";
+import { type WorkspaceSnapshotV1 } from "./workspace-schemas";
+export interface WorkspaceControllerOptions {
+    readonly definitionId?: string;
+    readonly instanceId: string;
+    name: string;
+    readonly onError: (error: Error) => void;
+    readonly renderers: GridComponentRendererRegistry;
+    readonly service: WorkspacePersistenceService;
+    readonly settingsCodecs: GridComponentSettingsRegistry;
+    readonly snapshot: WorkspaceSnapshotV1;
+    readonly revision?: number;
+}
+export declare class WorkspaceController {
+    #private;
+    readonly definitionId?: string;
+    readonly documentController: GridLayoutDocumentController;
+    readonly instanceId: string;
+    name: string;
+    readonly persistentState: WorkspacePersistentStateStore;
+    readonly renderers: GridComponentRendererRegistry;
+    readonly repository: WorkspaceRepository;
+    readonly settingsCodecs: GridComponentSettingsRegistry;
+    constructor(options: WorkspaceControllerOptions);
+    get snapshot(): WorkspaceSnapshotV1;
+    handleDocumentChange: (document: GridLayoutDocument, change: GridLayoutDocumentChange) => void;
+    rename(name: string): void;
+    dispose(): Promise<void>;
+}

package/types/workspace-management/WorkspaceHost.d.ts

@@ -0,0 +1 @@
+export declare const WorkspaceHost: () => import("react/jsx-runtime").JSX.Element;

package/types/workspace-management/WorkspacePersistentState.d.ts

@@ -0,0 +1,19 @@
+import { type ReactElement, type ReactNode } from "react";
+import { type ComponentPersistentStateV1 } from "./workspace-schemas";
+export type ComponentStateUpdate = ComponentPersistentStateV1 | ((current: ComponentPersistentStateV1 | undefined) => ComponentPersistentStateV1);
+export declare class WorkspacePersistentStateStore {
+    #private;
+    constructor(initialState?: Readonly<Record<string, ComponentPersistentStateV1>>);
+    getSnapshot: () => Readonly<Record<string, ComponentPersistentStateV1>>;
+    subscribe: (listener: () => void) => (() => void);
+    get(componentInstanceId: string): ComponentPersistentStateV1 | undefined;
+    update(componentInstanceId: string, update: ComponentStateUpdate): void;
+    purge(componentInstanceId?: string): void;
+}
+export interface WorkspacePersistentStateProviderProps {
+    readonly children: ReactNode;
+    readonly store: WorkspacePersistentStateStore;
+}
+export declare const WorkspacePersistentStateProvider: ({ children, store, }: WorkspacePersistentStateProviderProps) => ReactElement;
+export declare const useWorkspacePersistentStateStore: () => WorkspacePersistentStateStore;
+export declare const useComponentPersistentState: (componentInstanceId: string) => readonly [ComponentPersistentStateV1 | undefined, (update: ComponentStateUpdate) => void, () => void];

package/types/workspace-management/WorkspaceRepository.d.ts

@@ -0,0 +1,13 @@
+import type { WorkspacePersistenceService } from "../persistence-manager";
+import { type WorkspaceSnapshotRecordV1, type WorkspaceSnapshotV1 } from "./workspace-schemas";
+export declare class WorkspaceRepositoryDisposedError extends Error {
+    constructor();
+}
+export declare class WorkspaceRepository {
+    #private;
+    constructor(service: WorkspacePersistenceService, workspaceInstanceId: string, initial?: WorkspaceSnapshotRecordV1);
+    get current(): WorkspaceSnapshotRecordV1 | undefined;
+    load(): Promise<WorkspaceSnapshotRecordV1 | undefined>;
+    save(snapshot: WorkspaceSnapshotV1): Promise<WorkspaceSnapshotRecordV1>;
+    dispose(): Promise<void>;
+}

package/types/workspace-management/WorkspaceStartPanel.d.ts

@@ -0,0 +1 @@
+export declare const WorkspaceStartPanel: () => import("react/jsx-runtime").JSX.Element;

package/types/workspace-management/shell-workspace-components.d.ts

@@ -0,0 +1,2 @@
+import type { WorkspaceComponentRegistration } from "./workspace-component-registry";
+export declare const shellWorkspaceComponentRegistrations: readonly WorkspaceComponentRegistration<unknown>[];

package/types/workspace-management/workspace-component-registry.d.ts

@@ -0,0 +1,12 @@
+import { GridComponentRendererRegistry, GridComponentSettingsRegistry, type GridComponentRenderer, type GridComponentSettingsCodec, type JsonValue } from "@vuu-ui/grid-layout";
+export interface WorkspaceComponentRegistration<T> {
+    readonly codec: GridComponentSettingsCodec<T>;
+    readonly render: GridComponentRenderer<T>;
+    readonly type: string;
+}
+export interface WorkspaceComponentRegistries {
+    readonly renderers: GridComponentRendererRegistry;
+    readonly settingsCodecs: GridComponentSettingsRegistry;
+}
+export declare const createWorkspaceComponentRegistries: <T>(registrations: readonly WorkspaceComponentRegistration<T>[]) => WorkspaceComponentRegistries;
+export declare const jsonValueWorkspaceComponentCodec: GridComponentSettingsCodec<JsonValue>;

package/types/workspace-management/workspace-schemas.d.ts

@@ -0,0 +1,69 @@
+import { type GridLayoutDocument, type JsonValue } from "@vuu-ui/grid-layout";
+export declare const WORKSPACE_SNAPSHOT_VERSION = 1;
+export declare const APPLICATION_SESSION_VERSION = 1;
+export declare const NAMED_WORKSPACE_DEFINITION_VERSION = 1;
+export declare const WORKSPACE_SNAPSHOT_RECORD_VERSION = 1;
+export interface ComponentPersistentStateV1 {
+    readonly componentType: string;
+    readonly schemaVersion: number;
+    readonly value: JsonValue;
+}
+export interface WorkspaceSnapshotV1 {
+    readonly version: typeof WORKSPACE_SNAPSHOT_VERSION;
+    readonly layout: GridLayoutDocument;
+    readonly componentState: Readonly<Record<string, ComponentPersistentStateV1>>;
+}
+export interface OpenWorkspaceInstanceV1 {
+    readonly instanceId: string;
+    readonly definitionId?: string;
+    readonly title?: string;
+    readonly snapshotId: string;
+}
+export interface ApplicationSessionV1 {
+    readonly version: typeof APPLICATION_SESSION_VERSION;
+    readonly openWorkspaces: readonly OpenWorkspaceInstanceV1[];
+    readonly workspaceOrder: readonly string[];
+    readonly activeWorkspaceInstanceId: string | null;
+    readonly settings: Readonly<Record<string, JsonValue>>;
+}
+export interface NamedWorkspaceDefinitionV1 {
+    readonly version: typeof NAMED_WORKSPACE_DEFINITION_VERSION;
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly snapshot: WorkspaceSnapshotV1;
+}
+export interface NamedWorkspaceMetadataV1 {
+    readonly version: typeof NAMED_WORKSPACE_DEFINITION_VERSION;
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface WorkspaceSnapshotRecordV1 {
+    readonly version: typeof WORKSPACE_SNAPSHOT_RECORD_VERSION;
+    readonly workspaceInstanceId: string;
+    readonly revision: number;
+    readonly snapshot: WorkspaceSnapshotV1;
+}
+export type WorkspaceSchemaName = "WorkspaceSnapshotV1" | "ApplicationSessionV1" | "NamedWorkspaceDefinitionV1" | "NamedWorkspaceMetadataV1" | "WorkspaceSnapshotRecordV1";
+export interface WorkspaceValidationIssue {
+    readonly code: "INVALID_JSON_VALUE" | "INVALID_VALUE" | "UNEXPECTED_FIELD" | "UNSUPPORTED_VERSION";
+    readonly message: string;
+    readonly path: string;
+}
+export declare class WorkspaceValidationError extends Error {
+    readonly schema: WorkspaceSchemaName;
+    readonly issues: readonly WorkspaceValidationIssue[];
+    constructor(schema: WorkspaceSchemaName, issues: readonly WorkspaceValidationIssue[]);
+}
+export declare const validateWorkspaceSnapshotV1: (value: unknown) => WorkspaceSnapshotV1;
+export declare const validateApplicationSessionV1: (value: unknown) => ApplicationSessionV1;
+export declare const validateNamedWorkspaceDefinitionV1: (value: unknown) => NamedWorkspaceDefinitionV1;
+export declare const validateNamedWorkspaceMetadataV1: (value: unknown) => NamedWorkspaceMetadataV1;
+export declare const validateWorkspaceSnapshotRecordV1: (value: unknown) => WorkspaceSnapshotRecordV1;
+export declare const workspaceMetadata: (definition: NamedWorkspaceDefinitionV1) => NamedWorkspaceMetadataV1;
+export declare const cloneWorkspaceValue: <T>(value: T) => T;