@ocelescope/core 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { MantineStyleProps } from "@mantine/core";
-import { AggregatedAttribute, RelationCountSummary, TypedAttribute, ValueType } from "@ocelescope/api-base";
+import { Select } from "@mantine/core";
+import { AggregatedAttribute, RelationCountSummary, SqlQueryResult, TypedAttribute, ValueType } from "@ocelescope/api-base";
 import { DataTableColumn } from "mantine-datatable";
 import { ComponentProps, SVGProps } from "react";
 import { Dropzone, FileWithPath } from "@mantine/dropzone";
+import { ViewerConfig, ViewerProps } from "@r4pm/components";
 import { GetStaticPaths, GetStaticProps, NextApiRequest, NextApiResponse } from "next";
 //#region src/components/AttributeTable.d.ts
 type OcelVersion$1 = "original" | "filtered";
@@ -16,18 +17,139 @@ declare const AttributesTable: React.FC<{
   ocelVersion?: OcelVersion$1;
   alwaysExpandable?: boolean;
   visibleAttributes?: string[];
+  height?: string | number;
+  className?: string;
+  style?: React.CSSProperties;
 }>;
 //#endregion
 //#region src/components/BarList/BarList.d.ts
-declare const BarList: React.FC<{
+export declare const BarList: React.FC<{
   data: Record<string, number>;
   labelHeader: string;
   valueHeader?: string;
   maxVisibleItems?: number;
 }>;
 //#endregion
+//#region src/components/charts/types.d.ts
+/** One row of a tidy result: a value per column. */
+type Row = Record<string, unknown>;
+/** What every chart is given: rows, and which columns to read them by. */
+interface ChartProps {
+  rows: readonly Row[];
+  /** Column whose values name the categories. */
+  x: string;
+  /** Column, or columns, holding the numbers. */
+  y: string | readonly string[];
+  /** Column unfolded into one series per distinct value. */
+  series?: string;
+  /** Colour for a name, e.g. the one the graph viewers give it. */
+  colorOf?: (name: string) => string;
+  /** A click on a mark, by the name that mark carries. */
+  onSelect?: (name: string, point: unknown) => void;
+}
+/** What the charts drawn against two axes take on top of the rest. */
+interface CartesianChartProps extends ChartProps {
+  /** Hold the x axis to this range instead of fitting it to the rows - so
+   * that several charts share one timeline, or a lone reading does not zoom
+   * the axis down to the millisecond around itself. */
+  xRange?: readonly [unknown, unknown];
+}
+/** One trace's worth of rows: what it is called, and what it draws. */
+interface Series {
+  name: string;
+  labels: string[];
+  /** Numbers where the rows hold numbers, and the text itself where they do
+   * not - an attribute reading "in transit" belongs on its own axis, not at
+   * zero. Plotly decides the axis from what it is given. */
+  values: Array<number | string>;
+}
+//#endregion
+//#region src/components/charts/BarChart.d.ts
+interface BarChartProps extends CartesianChartProps {
+  /** Stack the traces instead of standing them side by side. */
+  stacked?: boolean;
+  /** Bars along the x axis, which long category names need. */
+  horizontal?: boolean;
+}
+//#endregion
+//#region src/components/charts/LineChart.d.ts
+interface LineChartProps extends CartesianChartProps {
+  /** Hold each value until the next one, instead of sloping between them.
+   * What a thing was worth between two readings is what it last read. */
+  step?: boolean;
+  /** Give every line its own overlaid scale. Useful when the series have
+   * different units or ranges. Axes alternate left and right and use the
+   * line colour, so the association stays visible without separate plots. */
+  yAxes?: "shared" | "independent";
+}
+//#endregion
+//#region src/components/charts/PieChart.d.ts
+interface PieChartProps extends ChartProps {
+  /** The hole in the middle, as a share of the radius. 0 for a full pie. */
+  hole?: number;
+}
+//#endregion
+//#region src/components/charts/SunburstChart.d.ts
+interface SunburstChartProps extends ChartProps {
+  /** The rings, innermost first. Defaults to the category, then the series. */
+  path?: readonly string[];
+}
+//#endregion
+//#region src/components/charts/AreaChart.d.ts
+type AreaChartProps = CartesianChartProps;
+//#endregion
+//#region src/components/charts/ScatterChart.d.ts
+type ScatterChartProps = CartesianChartProps;
+//#endregion
+//#region src/components/charts/index.d.ts
+type ChartType = "bar" | "line" | "area" | "scatter" | "pie" | "sunburst";
+/** How a query's result is drawn, when the columns alone should not decide. */
+interface ChartOptions {
+  type?: ChartType;
+  /** Types offered in the header switch. Fewer than two hides it. */
+  types?: ChartType[];
+  /** Category column. Defaults to the first non-numeric column. */
+  x?: string;
+  /** Measure column(s). Defaults to every numeric column. */
+  y?: string | string[];
+  /** Column unfolded into one series per distinct value. */
+  series?: string;
+  /** Sunburst rings, innermost first. Defaults to `[x, series]`. */
+  path?: string[];
+  stacked?: boolean;
+  horizontal?: boolean;
+  /** For line charts, overlay one y scale per line rather than sharing one. */
+  yAxes?: "shared" | "independent";
+  /** Colour through the host's resolver under this scope ("activity",
+   * "objectType"), so a category keeps the colour the graph viewers give it. */
+  colorScope?: string;
+  title?: string;
+  height?: number | string;
+}
+type SqlChartProps = ViewerProps<SqlQueryResult> & ChartOptions;
+interface OcelChartProps extends ChartOptions, ViewerConfig {
+  /** DuckDB SQL over the OCEL's stored tables: `events`, `objects`, `e2o`,
+   * `o2o`, `object_changes`. One `SELECT`; the backend refuses anything else. */
+  sql: string;
+  /** Values bound to the query's `?` placeholders. Bind them here rather than
+   * building the SQL by hand. */
+  parameters?: unknown[];
+  /** Defaults to the filtered log, which is what the rest of the app shows. */
+  ocelVersion?: "filtered" | "original";
+  /** Hold the query back, e.g. until the user has picked an activity. */
+  enabled?: boolean;
+}
+export declare const BarChart: import("react").ComponentType<BarChartProps>;
+export declare const LineChart: import("react").ComponentType<LineChartProps>;
+export declare const AreaChart: import("react").ComponentType<CartesianChartProps>;
+export declare const ScatterChart: import("react").ComponentType<CartesianChartProps>;
+export declare const PieChart: import("react").ComponentType<PieChartProps>;
+export declare const SunburstChart: import("react").ComponentType<SunburstChartProps>;
+export declare const SqlChart: import("react").ComponentType<SqlChartProps>;
+export declare const OcelChart: import("react").ComponentType<OcelChartProps>;
+//#endregion
 //#region src/components/Dropzone/Dropzone.d.ts
-declare const FileDropzone: React.FC<{
+export declare const FileDropzone: React.FC<{
   onUpload: (files: FileWithPath[]) => void;
   accept?: ComponentProps<typeof Dropzone>["accept"];
   content: {
@@ -39,7 +161,7 @@ declare const FileDropzone: React.FC<{
 }>;
 //#endregion
 //#region src/components/Dropzone/FullScreenUpload.d.ts
-declare const FullScreenUpload: React.FC<{
+export declare const FullScreenUpload: React.FC<{
   onSuccess?: () => void;
   accept?: ComponentProps<typeof Dropzone.FullScreen>["accept"];
   label?: React.ReactNode;
@@ -47,10 +169,10 @@ declare const FullScreenUpload: React.FC<{
 }>;
 //#endregion
 //#region src/components/EventHandler.d.ts
-declare const sseHandler: (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
+export declare const sseHandler: (req: NextApiRequest, res: NextApiResponse) => Promise<void>;
 //#endregion
 //#region src/components/HelpModal/HelpModal.d.ts
-declare const HelpModal: React.FC<{
+export declare const HelpModal: React.FC<{
   visible: boolean;
   onClose: () => void;
 }>;
@@ -60,7 +182,7 @@ type Author = {
   name: string;
   link?: string;
 };
-type ModuleDefinition = {
+export type ModuleDefinition = {
   name: string;
   label: string;
   authors: Author[];
@@ -68,28 +190,28 @@ type ModuleDefinition = {
   routes: ModuleRouteDefinition[];
   icon?: React.ComponentType<SVGProps<SVGSVGElement>>;
 };
-type ModuleRouteDefinition = {
+export type ModuleRouteDefinition = {
   name: string;
   label: string;
   requiresOcel?: boolean;
   component: React.ComponentType;
 };
-type OcelescopeConfig = {
+export type OcelescopeConfig = {
   modules?: readonly ModuleDefinition[];
   navbarGroups?: {
     title?: string;
     modulesNames: string[];
   }[];
 };
-declare const defineModule: (def: ModuleDefinition) => ModuleDefinition;
-declare const defineModuleRoute: (def: ModuleRouteDefinition) => ModuleRouteDefinition;
+export declare const defineModule: (def: ModuleDefinition) => ModuleDefinition;
+export declare const defineModuleRoute: (def: ModuleRouteDefinition) => ModuleRouteDefinition;
 //#endregion
 //#region src/components/ModulePage.d.ts
 type ModulePageProps = {
   moduleName: string;
   routeName: string;
 };
-declare const createModulesPage: (config: OcelescopeConfig) => {
+export declare const createModulesPage: (config: OcelescopeConfig) => {
   getStaticPaths: GetStaticPaths;
   getStaticProps: GetStaticProps<ModulePageProps>;
   ModulePage: import("react").FunctionComponent<ModulePageProps> & {
@@ -98,25 +220,131 @@ declare const createModulesPage: (config: OcelescopeConfig) => {
 };
 //#endregion
 //#region src/components/OcelescopeApp.d.ts
-declare const OcelescopeApp: (config: OcelescopeConfig) => React.FC<any>;
+export declare const OcelescopeApp: (config: OcelescopeConfig) => React.FC<any>;
 //#endregion
 //#region src/components/OcelescopeDocument.d.ts
-declare const OcelescopeDocument: React.FC;
+export declare const OcelescopeDocument: React.FC;
 //#endregion
 //#region src/components/OcelSelect/OcelSelect.d.ts
-type OcelSelectProps = {
-  extension?: string;
-  value?: string | null;
-  onChange?: (value: string | null) => void;
-  label?: React.ReactNode;
-  description?: React.ReactNode;
-  error?: React.ReactNode;
+export declare const OcelSelect: ({ value, ...props }: Omit<ComponentProps<typeof Select<string>>, "data">) => import("react").JSX.Element;
+//#endregion
+//#region src/components/pickers/types.d.ts
+/** Which OCEL a picker reads its choices from. */
+interface OcelSource {
+  /** Defaults to the OCEL the app has selected. */
+  ocelId?: string;
+  /** The unfiltered log, for choices that must not shift under a filter. */
+  ocelVersion?: "filtered" | "original";
+}
+/** Picking one name, or none. */
+interface SinglePicker {
+  multiple?: false;
+  value: string | null | undefined;
+  onChange: (value: string | undefined) => void;
+}
+/** Picking any number of names. */
+interface MultiPicker {
+  multiple: true;
+  value: readonly string[];
+  onChange: (value: string[]) => void;
+}
+/** What a picker picks. Single unless it says otherwise. */
+type Selection = SinglePicker | MultiPicker;
+//#endregion
+//#region src/components/pickers/NamePicker.d.ts
+/** A name to pick, and how often it occurs. */
+interface NameItem {
+  key: string;
+  count: number;
+}
+interface NamePickerProps {
+  /** Name to count, or the same as a list. */
+  items: Record<string, number> | readonly NameItem[];
+  label?: string;
+  /** A search box above the list. */
+  searchable?: boolean;
+  /** A bar behind each name, as long as its share of the largest count. */
+  bars?: boolean;
+  /** The count itself, beside each name. */
+  counts?: boolean;
+  /** The rail that drags a cut through the list, taking the top names. */
+  cutoff?: boolean;
+  sort?: "count" | "name";
+  /** Colour scope, so a name keeps the colour the viewers give it. */
+  scope?: string;
+  loading?: boolean;
+  emptyText?: string;
+  disabled?: boolean;
+  autoFocus?: boolean;
+}
+//#endregion
+//#region src/components/pickers/ActivityPicker.d.ts
+type ActivityPickerProps = OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading">;
+//#endregion
+//#region src/components/pickers/EventAttributePicker.d.ts
+type EventAttributePickerProps = OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading"> & {
+  /** Offer only what this activity's events carry. Without it, every
+   * attribute any event in the log carries. */
+  activity?: string;
+};
+//#endregion
+//#region src/components/pickers/IdPicker.d.ts
+interface IdPickerProps {
+  /** The ids to offer. Usually a page of them, from a search. */
+  ids: readonly string[];
+  label?: string;
   placeholder?: string;
-  required?: boolean;
+  /** What the reader has typed, when the caller searches for them. */
+  search?: string;
+  onSearch?: (search: string) => void;
+  loading?: boolean;
+  emptyText?: string;
   disabled?: boolean;
-  w?: MantineStyleProps["w"];
+}
+/**
+ * Picking ids by typing.
+ *
+ * Presentational: a log holds far more events and objects than a list can
+ * show, so the caller decides which ids a search turns up.
+ */
+export declare const IdPicker: ({ ids, label, placeholder, search, onSearch, loading, emptyText, disabled, ...selection }: IdPickerProps & Selection) => import("react").JSX.Element;
+//#endregion
+//#region src/components/pickers/EventPicker.d.ts
+type EventPickerProps = OcelSource & Omit<IdPickerProps, "ids" | "search" | "onSearch" | "loading"> & {
+  /** How many ids a search turns up. */
+  limit?: number;
+};
+/** Events of the log, found by typing part of an id. */
+export declare const EventPicker: ({ ocelId, ocelVersion, limit, ...picker }: EventPickerProps & Selection) => import("react").JSX.Element;
+//#endregion
+//#region src/components/pickers/ObjectAttributePicker.d.ts
+type ObjectAttributePickerProps = OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading"> & {
+  /** Offer only what objects of this type carry. Without it, every
+   * attribute any object in the log carries. */
+  objectType?: string;
 };
-declare const OcelSelect: React.FC<OcelSelectProps>;
+//#endregion
+//#region src/components/pickers/ObjectPicker.d.ts
+type ObjectPickerProps = OcelSource & Omit<IdPickerProps, "ids" | "search" | "onSearch" | "loading"> & {
+  /** How many ids a search turns up. */
+  limit?: number;
+};
+/** Objects of the log, found by typing part of an id. */
+export declare const ObjectPicker: ({ ocelId, ocelVersion, limit, ...picker }: ObjectPickerProps & Selection) => import("react").JSX.Element;
+//#endregion
+//#region src/components/pickers/ObjectTypePicker.d.ts
+type ObjectTypePickerProps = OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading">;
+//#endregion
+//#region src/components/pickers/index.d.ts
+export declare const NamePicker: import("react").ComponentType<NamePickerProps & Selection>;
+export declare const ActivityPicker: import("react").ComponentType<OcelSource & Omit<NamePickerProps, "loading" | "items" | "scope"> & Selection>;
+export declare const ObjectTypePicker: import("react").ComponentType<OcelSource & Omit<NamePickerProps, "loading" | "items" | "scope"> & Selection>;
+export declare const EventAttributePicker: import("react").ComponentType<OcelSource & Omit<NamePickerProps, "loading" | "items" | "scope"> & {
+  activity?: string;
+} & Selection>;
+export declare const ObjectAttributePicker: import("react").ComponentType<OcelSource & Omit<NamePickerProps, "loading" | "items" | "scope"> & {
+  objectType?: string;
+} & Selection>;
 //#endregion
 //#region src/components/RelationTable.d.ts
 type RelationType = "o2o" | "e2o";
@@ -135,52 +363,263 @@ declare const RelationTable: React.FC<{
     source: string;
     target: string;
   }[];
+  height?: string | number;
+  className?: string;
+  style?: React.CSSProperties;
 }>;
 //#endregion
 //#region src/components/UploadModal/UploadModal.d.ts
-declare const UploadModal: React.FC<{
+export declare const UploadModal: React.FC<{
   visible: boolean;
   onClose: () => void;
 }>;
 //#endregion
 //#region src/components/UploadSection/UploadSection.d.ts
-declare const UploadSection: React.FC<{
+export declare const UploadSection: React.FC<{
   onSuccess?: () => void;
 }>;
 //#endregion
 //#region src/hooks/useCurrentOCEL.d.ts
-declare const useCurrentOcel: () => {
+export declare const useCurrentOcel: () => {
   id: string | null;
   setCurrentOcel: (id: string) => void;
 };
 //#endregion
 //#region src/hooks/useDownload.d.ts
-declare const useDownloadFile: () => (path: string) => Promise<void>;
-declare const useDownloadOCEL: () => {
+export declare const useDownloadFile: () => (path: string) => Promise<void>;
+export declare const useDownloadOCEL: () => {
   download: (ocelId: string, params?: import("@ocelescope/api-base").DownloadOCELParams | undefined) => void;
 };
-declare const useDownloadFlatOCEL: () => {
+export declare const useDownloadFlatOCEL: () => {
   download: (ocelId: string | null, params?: import("@ocelescope/api-base").DownloadFlatLogParams | undefined) => void;
 };
-declare const useDownloadVariantFlatLog: () => {
+export declare const useDownloadVariantFlatLog: () => {
   download: (ocelId: string | null, params?: import("@ocelescope/api-base").DownloadVariantFlatLogParams | undefined) => void;
 };
-declare const useDownloadResource: () => {
+export declare const useDownloadResource: () => {
   download: (resourceId: string) => void;
 };
-declare const useDownloadResourceAsPnml: () => {
+export declare const useDownloadResourceAsPnml: () => {
   download: (resourceId: string) => void;
 };
 //#endregion
 //#region src/hooks/useInvalidate.d.ts
 type InvalidationRouteName = "ocels" | "resources" | "tasks" | "plugins" | "discoveryMethods";
-declare const useInvalidate: () => (routeNames: InvalidationRouteName[]) => Promise<void>;
+export declare const useInvalidate: () => (routeNames: InvalidationRouteName[]) => Promise<void>;
+//#endregion
+//#region src/hooks/useOcelQuery.d.ts
+interface OcelQueryOptions {
+  /** DuckDB SQL over the OCEL's stored tables: `events`, `objects`, `e2o`,
+   * `o2o`, `object_changes`. One `SELECT`; the backend refuses anything else. */
+  sql: string;
+  /** Values bound to the query's `?` placeholders. Bind them here rather than
+   * building the SQL by hand. */
+  parameters?: unknown[];
+  /** Defaults to the filtered log, which is what the rest of the app shows. */
+  ocelVersion?: "filtered" | "original";
+  /** Hold the query back, e.g. until the user has picked an activity. */
+  enabled?: boolean;
+}
+/**
+ * Run SQL against the current OCEL.
+ *
+ * `OcelChart` draws with this; use it directly when a module wants the rows
+ * themselves - a list of activities to choose from, a count to show in a
+ * heading.
+ */
+export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: OcelQueryOptions) => {
+  ocelId: string | null;
+  error: unknown;
+  data: import("@ocelescope/api-base").SqlQueryResult;
+  isError: true;
+  isPending: false;
+  isLoading: false;
+  isLoadingError: false;
+  isRefetchError: true;
+  isSuccess: false;
+  isPlaceholderData: false;
+  status: "error";
+  dataUpdatedAt: number;
+  errorUpdatedAt: number;
+  failureCount: number;
+  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  errorUpdateCount: number;
+  isFetched: boolean;
+  isFetchedAfterMount: boolean;
+  isFetching: boolean;
+  isInitialLoading: boolean;
+  isPaused: boolean;
+  isRefetching: boolean;
+  isStale: boolean;
+  isEnabled: boolean;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, import("@ocelescope/api-base").HTTPValidationError$1>>;
+  fetchStatus: import("@tanstack/react-query").FetchStatus;
+  queryKey: readonly unknown[] & {
+    [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
+    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+  };
+} | {
+  ocelId: string | null;
+  error: unknown;
+  data: import("@ocelescope/api-base").SqlQueryResult;
+  isError: false;
+  isPending: false;
+  isLoading: false;
+  isLoadingError: false;
+  isRefetchError: false;
+  isSuccess: true;
+  isPlaceholderData: false;
+  status: "success";
+  dataUpdatedAt: number;
+  errorUpdatedAt: number;
+  failureCount: number;
+  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  errorUpdateCount: number;
+  isFetched: boolean;
+  isFetchedAfterMount: boolean;
+  isFetching: boolean;
+  isInitialLoading: boolean;
+  isPaused: boolean;
+  isRefetching: boolean;
+  isStale: boolean;
+  isEnabled: boolean;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, import("@ocelescope/api-base").HTTPValidationError$1>>;
+  fetchStatus: import("@tanstack/react-query").FetchStatus;
+  queryKey: readonly unknown[] & {
+    [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
+    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+  };
+} | {
+  ocelId: string | null;
+  error: unknown;
+  data: undefined;
+  isError: true;
+  isPending: false;
+  isLoading: false;
+  isLoadingError: true;
+  isRefetchError: false;
+  isSuccess: false;
+  isPlaceholderData: false;
+  status: "error";
+  dataUpdatedAt: number;
+  errorUpdatedAt: number;
+  failureCount: number;
+  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  errorUpdateCount: number;
+  isFetched: boolean;
+  isFetchedAfterMount: boolean;
+  isFetching: boolean;
+  isInitialLoading: boolean;
+  isPaused: boolean;
+  isRefetching: boolean;
+  isStale: boolean;
+  isEnabled: boolean;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, import("@ocelescope/api-base").HTTPValidationError$1>>;
+  fetchStatus: import("@tanstack/react-query").FetchStatus;
+  queryKey: readonly unknown[] & {
+    [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
+    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+  };
+} | {
+  ocelId: string | null;
+  error: unknown;
+  data: undefined;
+  isError: false;
+  isPending: true;
+  isLoading: true;
+  isLoadingError: false;
+  isRefetchError: false;
+  isSuccess: false;
+  isPlaceholderData: false;
+  status: "pending";
+  dataUpdatedAt: number;
+  errorUpdatedAt: number;
+  failureCount: number;
+  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  errorUpdateCount: number;
+  isFetched: boolean;
+  isFetchedAfterMount: boolean;
+  isFetching: boolean;
+  isInitialLoading: boolean;
+  isPaused: boolean;
+  isRefetching: boolean;
+  isStale: boolean;
+  isEnabled: boolean;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, import("@ocelescope/api-base").HTTPValidationError$1>>;
+  fetchStatus: import("@tanstack/react-query").FetchStatus;
+  queryKey: readonly unknown[] & {
+    [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
+    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+  };
+} | {
+  ocelId: string | null;
+  error: unknown;
+  data: undefined;
+  isError: false;
+  isPending: true;
+  isLoadingError: false;
+  isRefetchError: false;
+  isSuccess: false;
+  isPlaceholderData: false;
+  status: "pending";
+  dataUpdatedAt: number;
+  errorUpdatedAt: number;
+  failureCount: number;
+  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  errorUpdateCount: number;
+  isFetched: boolean;
+  isFetchedAfterMount: boolean;
+  isFetching: boolean;
+  isLoading: boolean;
+  isInitialLoading: boolean;
+  isPaused: boolean;
+  isRefetching: boolean;
+  isStale: boolean;
+  isEnabled: boolean;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, import("@ocelescope/api-base").HTTPValidationError$1>>;
+  fetchStatus: import("@tanstack/react-query").FetchStatus;
+  queryKey: readonly unknown[] & {
+    [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
+    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+  };
+} | {
+  ocelId: string | null;
+  error: unknown;
+  data: import("@ocelescope/api-base").SqlQueryResult;
+  isError: false;
+  isPending: false;
+  isLoading: false;
+  isLoadingError: false;
+  isRefetchError: false;
+  isSuccess: true;
+  isPlaceholderData: true;
+  status: "success";
+  dataUpdatedAt: number;
+  errorUpdatedAt: number;
+  failureCount: number;
+  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  errorUpdateCount: number;
+  isFetched: boolean;
+  isFetchedAfterMount: boolean;
+  isFetching: boolean;
+  isInitialLoading: boolean;
+  isPaused: boolean;
+  isRefetching: boolean;
+  isStale: boolean;
+  isEnabled: boolean;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, import("@ocelescope/api-base").HTTPValidationError$1>>;
+  fetchStatus: import("@tanstack/react-query").FetchStatus;
+  queryKey: readonly unknown[] & {
+    [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
+    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+  };
+};
 //#endregion
 //#region src/lib/attributes.d.ts
-declare const formatAttributeValue: (type: ValueType, value: string | number) => string | number;
+export declare const formatAttributeValue: (type: ValueType, value: string | number) => string | number;
 //#endregion
 //#region src/lib/env.d.ts
-declare const env: {
+export declare const env: {
   appVersion: string;
   projectPage: string;
   docsUrl: string;
@@ -195,7 +634,7 @@ declare const env: {
 };
 //#endregion
 //#region src/lib/getModuleRoute.d.ts
-declare const getModuleRoute: ({ moduleName, routeName, query }: {
+export declare const getModuleRoute: ({ moduleName, routeName, query }: {
   moduleName: string;
   routeName?: string;
   query?: Record<string, string>;
@@ -206,4 +645,4 @@ declare const getModuleRoute: ({ moduleName, routeName, query }: {
   pathname: string;
 };
 //#endregion
-export { AttributesTable, BarList, FileDropzone, FullScreenUpload, HelpModal, ModuleDefinition, ModuleRouteDefinition, OcelSelect, OcelescopeApp, OcelescopeConfig, OcelescopeDocument, RelationTable, UploadModal, UploadSection, createModulesPage, defineModule, defineModuleRoute, env, formatAttributeValue, getModuleRoute, sseHandler, useCurrentOcel, useDownloadFile, useDownloadFlatOCEL, useDownloadOCEL, useDownloadResource, useDownloadResourceAsPnml, useDownloadVariantFlatLog, useInvalidate };
+export { type ActivityPickerProps, type AreaChartProps, AttributesTable, type BarChartProps, type CartesianChartProps, type ChartOptions, type ChartProps, type ChartType, type EventAttributePickerProps, type EventPickerProps, type IdPickerProps, type LineChartProps, type MultiPicker, type NameItem, type NamePickerProps, type ObjectAttributePickerProps, type ObjectPickerProps, type ObjectTypePickerProps, type OcelChartProps, type OcelQueryOptions, type OcelSource, type PieChartProps, RelationTable, type Row, type ScatterChartProps, type Selection, type Series, type SinglePicker, type SqlChartProps, type SunburstChartProps };