@ocelescope/core 0.10.0 → 0.10.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Select } from "@mantine/core";
-import { AggregatedAttribute, RelationCountSummary, SqlQueryResult, TypedAttribute, ValueType } from "@ocelescope/api-base";
+import { AggregatedAttribute, RelationCountSummary, TypedAttribute, ValueType } from "@ocelescope/api-base";
 import { DataTableColumn } from "mantine-datatable";
-import { ComponentProps, SVGProps } from "react";
+import { ComponentProps, ComponentType, JSX, SVGProps } from "react";
 import { Dropzone, FileWithPath } from "@mantine/dropzone";
 import { ViewerConfig, ViewerProps } from "@r4pm/components";
 import { GetStaticPaths, GetStaticProps, NextApiRequest, NextApiResponse } from "next";
@@ -33,8 +33,21 @@ export declare const BarList: React.FC<{
 //#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 {
+/** A tidy table: its rows, and the type its source reported per column. */
+interface Table$1 {
+  columns: readonly {
+    name: string;
+    type: string;
+  }[];
+  rows: readonly Row[];
+}
+/**
+ * What every chart is given: rows, and which columns to read them by.
+ *
+ * Colour and selection follow the r4pm viewer contract: `colorOf` and
+ * `onSelect` come from the ambient `ViewerConfig` unless given here.
+ */
+interface ChartProps extends Pick<ViewerConfig, "colorOf" | "onSelect"> {
   rows: readonly Row[];
   /** Column whose values name the categories. */
   x: string;
@@ -42,10 +55,10 @@ interface ChartProps {
   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;
+  /** Scope the marks are coloured and selected under ("activity",
+   * "objectType"), so a name keeps the colour the other viewers give it.
+   * Without one the plot's own colours are used. */
+  colorScope?: string;
 }
 /** What the charts drawn against two axes take on top of the rest. */
 interface CartesianChartProps extends ChartProps {
@@ -54,6 +67,34 @@ interface CartesianChartProps extends ChartProps {
    * the axis down to the millisecond around itself. */
   xRange?: readonly [unknown, unknown];
 }
+type ChartType = "bar" | "histogram" | "line" | "area" | "scatter" | "pie" | "sunburst";
+/** How a table is drawn, when its 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. For a
+   * histogram, the column holding each bin's lower edge. */
+  x?: string;
+  /** Histogram only: the column holding each bin's upper edge. */
+  xEnd?: 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<Table$1> & ChartOptions;
 /** One trace's worth of rows: what it is called, and what it draws. */
 interface Series {
   name: string;
@@ -72,6 +113,15 @@ interface BarChartProps extends CartesianChartProps {
   horizontal?: boolean;
 }
 //#endregion
+//#region src/components/charts/HistogramChart.d.ts
+interface HistogramChartProps extends Omit<ChartProps, "series"> {
+  /** Column holding each bin's upper edge; `x` holds its lower one. A row
+   * without a lower edge counts everything below its upper one, and the
+   * other way round - so outliers get a bar of their own instead of
+   * stretching the axis. */
+  xEnd: string;
+}
+//#endregion
 //#region src/components/charts/LineChart.d.ts
 interface LineChartProps extends CartesianChartProps {
   /** Hold each value until the next one, instead of sloping between them.
@@ -102,31 +152,6 @@ type AreaChartProps = CartesianChartProps;
 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. */
@@ -140,6 +165,7 @@ interface OcelChartProps extends ChartOptions, ViewerConfig {
   enabled?: boolean;
 }
 export declare const BarChart: import("react").ComponentType<BarChartProps>;
+export declare const HistogramChart: import("react").ComponentType<HistogramChartProps>;
 export declare const LineChart: import("react").ComponentType<LineChartProps>;
 export declare const AreaChart: import("react").ComponentType<CartesianChartProps>;
 export declare const ScatterChart: import("react").ComponentType<CartesianChartProps>;
@@ -228,123 +254,194 @@ export declare const OcelescopeDocument: React.FC;
 //#region src/components/OcelSelect/OcelSelect.d.ts
 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 {
+//#region src/components/Pickers/types.d.ts
+/** Picking one value, or none. */
+interface SingleSelection<T> {
   multiple?: false;
-  value: string | null | undefined;
-  onChange: (value: string | undefined) => void;
+  value: T | null | undefined;
+  onChange: (value: T | undefined) => void;
 }
-/** Picking any number of names. */
-interface MultiPicker {
+/** Picking any number of values. */
+interface MultiSelection<T> {
   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;
+  value: readonly T[];
+  onChange: (value: T[]) => void;
 }
-interface NamePickerProps {
-  /** Name to count, or the same as a list. */
-  items: Record<string, number> | readonly NameItem[];
+/** What a picker picks. Single unless `multiple` is set. */
+type Selection<T> = SingleSelection<T> | MultiSelection<T>;
+/** How a picker looks and reads, whatever it picks. */
+interface PickerProps {
+  /**
+   * `"dropdown"` (default) is a compact field that opens a searchable list,
+   * for forms. `"list"` shows every choice at once, with frequency bars, for
+   * side panels and filters.
+   */
+  variant?: "dropdown" | "list";
   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;
+  /** A line of help under the label. */
+  description?: string;
+  /** Trigger text of the dropdown while nothing is picked. */
+  placeholder?: string;
+  /** Shown when there is nothing to pick from. */
   emptyText?: string;
   disabled?: boolean;
+  /** Focus the search on mount (list), or open the dropdown on mount. */
   autoFocus?: boolean;
+  /** The count beside each choice. */
+  counts?: boolean;
+  /** List only: a bar behind each choice, as long as its share of the largest count. */
+  bars?: boolean;
+  /** List only: the rail that drags a cut through the list, taking the top choices. */
+  cutoff?: boolean;
+  sort?: "count" | "name";
 }
+/** 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";
+}
+/** The props of a picker that reads its choices from an OCEL endpoint. */
+type OcelPickerProps<T> = OcelSource & PickerProps & Selection<T>;
+/** How events of a type, or objects of a type, relate to objects of a type. */
+interface Relation {
+  /** The event type (E2O) or object type (O2O) the relation starts from. */
+  source: string;
+  /** The object type it points to. */
+  target: string;
+  qualifier: string;
+}
+/** An attribute of an activity's events, or of an object type's objects. */
+type AttributeRef = {
+  target: "event";
+  activity: string;
+  name: string;
+} | {
+  target: "object";
+  objectType: string;
+  name: string;
+};
 //#endregion
-//#region src/components/pickers/ActivityPicker.d.ts
-type ActivityPickerProps = OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading">;
+//#region src/components/Pickers/ActivityPicker.d.ts
+type ActivityPickerProps = OcelPickerProps<string>;
 //#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. */
+//#region src/components/Pickers/ObjectTypePicker.d.ts
+type ObjectTypePickerProps = OcelPickerProps<string> & {
+  /** Offer only the object types that events of this activity relate to. */
   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;
-  /** What the reader has typed, when the caller searches for them. */
-  search?: string;
-  onSearch?: (search: string) => void;
-  loading?: boolean;
-  emptyText?: string;
-  disabled?: boolean;
-}
-/**
- * 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;
+//#region src/components/Pickers/EventPicker.d.ts
+type EventPickerProps = OcelPickerProps<string> & {
+  /** How many ids a search turns up. */
+  limit?: number;
+};
 //#endregion
-//#region src/components/pickers/EventPicker.d.ts
-type EventPickerProps = OcelSource & Omit<IdPickerProps, "ids" | "search" | "onSearch" | "loading"> & {
+//#region src/components/Pickers/ObjectPicker.d.ts
+type ObjectPickerProps = OcelPickerProps<string> & {
   /** 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;
+//#region src/components/Pickers/EventAttributePicker.d.ts
+type EventAttributePickerProps = OcelPickerProps<string> & {
+  /** Offer only what events of this type carry. Without it, every attribute
+   * any event in the log carries. */
+  activity?: string;
+  /** Offer only attributes of these value types, e.g. `["int", "float"]`. */
+  valueTypes?: readonly ValueType[];
 };
 //#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;
+//#region src/components/Pickers/ObjectAttributePicker.d.ts
+type ObjectAttributePickerProps = OcelPickerProps<string> & {
+  /** Offer only what objects of this type carry. Without it, every attribute
+   * any object in the log carries. */
+  objectType?: string;
+  /** Offer only attributes of these value types, e.g. `["int", "float"]`. */
+  valueTypes?: readonly ValueType[];
 };
-/** 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">;
+//#region src/components/Pickers/AttributePicker.d.ts
+type AttributePickerProps = OcelPickerProps<AttributeRef> & {
+  /** The activity whose attributes, and whose related objects'
+   * attributes, are offered. */
+  activity: string | undefined;
+  /** Offer attributes of only these related object types. Default: all. */
+  objectTypes?: readonly string[];
+  /** Offer only object types every event relates to exactly one object of,
+   * so an object attribute has one value per event. */
+  onlyUniquelyRelated?: boolean;
+  /** Offer only attributes of these value types, e.g. `["int", "float"]`. */
+  valueTypes?: readonly ValueType[];
+};
 //#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, "items" | "scope" | "loading"> & Selection>;
-export declare const ObjectTypePicker: import("react").ComponentType<OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading"> & Selection>;
-export declare const EventAttributePicker: import("react").ComponentType<OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading"> & {
+//#region src/components/Pickers/E2ORelationPicker.d.ts
+type E2ORelationPickerProps = OcelPickerProps<Relation> & {
+  /** Offer only relations of events of this type. Without it, every event
+   * type's, grouped by event type. */
   activity?: string;
-} & Selection>;
-export declare const ObjectAttributePicker: import("react").ComponentType<OcelSource & Omit<NamePickerProps, "items" | "scope" | "loading"> & {
+};
+//#endregion
+//#region src/components/Pickers/O2ORelationPicker.d.ts
+type O2ORelationPickerProps = OcelPickerProps<Relation> & {
+  /** Offer only relations of objects of this type. Without it, every object
+   * type's, grouped by object type. */
   objectType?: string;
-} & Selection>;
+};
+//#endregion
+//#region src/components/Pickers/internal/options.d.ts
+/** A heading that options are shown together under. */
+interface PickerGroup {
+  label: string;
+  color?: string;
+  /** Muted text beside the heading, e.g. "event attributes". */
+  caption?: string;
+}
+/** One choice of a picker. */
+interface PickerOption<T> {
+  value: T;
+  /** What the reader sees. Unique within the option's group. */
+  label: string;
+  /** Muted text beside the label in the dropdown, e.g. a value type. */
+  description?: string;
+  count?: number;
+  color?: string;
+  group?: PickerGroup;
+}
+/** Everything the presentational pickers need, beyond the options. */
+type OptionPickerProps<T> = PickerProps & Selection<T> & {
+  options: readonly PickerOption<T>[];
+  /** Stable identity of a value. Defaults to the value itself for strings,
+   * else its JSON. */
+  idOf?: (value: T) => string;
+  /** Label of a picked value that is not among the options, as with ids a
+   * search no longer turns up. Defaults to its id. */
+  labelOf?: (value: T) => string;
+  loading?: boolean;
+  error?: unknown;
+  /** Set when a choice has to be made elsewhere first, and says which. */
+  missing?: string;
+  /** Server-side search: the options are what `search` turns up, and the
+   * picker only reports what the reader types. */
+  search?: string;
+  onSearch?: (search: string) => void;
+  /** How many there are to pick from, when the options are only the page
+   * of them a search turned up. Defaults to the number of options. */
+  total?: number;
+};
+//#endregion
+//#region src/components/Pickers/index.d.ts
+export declare const OptionPicker: <T>(props: OptionPickerProps<T>) => JSX.Element;
+export declare const ActivityPicker: ComponentType<ActivityPickerProps>;
+export declare const ObjectTypePicker: ComponentType<ObjectTypePickerProps>;
+export declare const EventPicker: ComponentType<EventPickerProps>;
+export declare const ObjectPicker: ComponentType<ObjectPickerProps>;
+export declare const EventAttributePicker: ComponentType<EventAttributePickerProps>;
+export declare const ObjectAttributePicker: ComponentType<ObjectAttributePickerProps>;
+export declare const AttributePicker: ComponentType<AttributePickerProps>;
+export declare const E2ORelationPicker: ComponentType<E2ORelationPickerProps>;
+export declare const O2ORelationPicker: ComponentType<O2ORelationPickerProps>;
 //#endregion
 //#region src/components/RelationTable.d.ts
 type RelationType = "o2o" | "e2o";
@@ -442,7 +539,7 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   dataUpdatedAt: number;
   errorUpdatedAt: number;
   failureCount: number;
-  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  failureReason: unknown;
   errorUpdateCount: number;
   isFetched: boolean;
   isFetchedAfterMount: boolean;
@@ -452,11 +549,11 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   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>>;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, unknown>>;
   fetchStatus: import("@tanstack/react-query").FetchStatus;
   queryKey: readonly unknown[] & {
     [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
-    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+    [dataTagErrorSymbol]: unknown;
   };
 } | {
   ocelId: string | null;
@@ -473,7 +570,7 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   dataUpdatedAt: number;
   errorUpdatedAt: number;
   failureCount: number;
-  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  failureReason: unknown;
   errorUpdateCount: number;
   isFetched: boolean;
   isFetchedAfterMount: boolean;
@@ -483,11 +580,11 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   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>>;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, unknown>>;
   fetchStatus: import("@tanstack/react-query").FetchStatus;
   queryKey: readonly unknown[] & {
     [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
-    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+    [dataTagErrorSymbol]: unknown;
   };
 } | {
   ocelId: string | null;
@@ -504,7 +601,7 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   dataUpdatedAt: number;
   errorUpdatedAt: number;
   failureCount: number;
-  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  failureReason: unknown;
   errorUpdateCount: number;
   isFetched: boolean;
   isFetchedAfterMount: boolean;
@@ -514,11 +611,11 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   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>>;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, unknown>>;
   fetchStatus: import("@tanstack/react-query").FetchStatus;
   queryKey: readonly unknown[] & {
     [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
-    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+    [dataTagErrorSymbol]: unknown;
   };
 } | {
   ocelId: string | null;
@@ -535,7 +632,7 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   dataUpdatedAt: number;
   errorUpdatedAt: number;
   failureCount: number;
-  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  failureReason: unknown;
   errorUpdateCount: number;
   isFetched: boolean;
   isFetchedAfterMount: boolean;
@@ -545,11 +642,11 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   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>>;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, unknown>>;
   fetchStatus: import("@tanstack/react-query").FetchStatus;
   queryKey: readonly unknown[] & {
     [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
-    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+    [dataTagErrorSymbol]: unknown;
   };
 } | {
   ocelId: string | null;
@@ -565,7 +662,7 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   dataUpdatedAt: number;
   errorUpdatedAt: number;
   failureCount: number;
-  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  failureReason: unknown;
   errorUpdateCount: number;
   isFetched: boolean;
   isFetchedAfterMount: boolean;
@@ -576,11 +673,11 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   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>>;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, unknown>>;
   fetchStatus: import("@tanstack/react-query").FetchStatus;
   queryKey: readonly unknown[] & {
     [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
-    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+    [dataTagErrorSymbol]: unknown;
   };
 } | {
   ocelId: string | null;
@@ -597,7 +694,7 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   dataUpdatedAt: number;
   errorUpdatedAt: number;
   failureCount: number;
-  failureReason: import("@ocelescope/api-base").HTTPValidationError$1 | null;
+  failureReason: unknown;
   errorUpdateCount: number;
   isFetched: boolean;
   isFetchedAfterMount: boolean;
@@ -607,11 +704,11 @@ export declare const useOcelQuery: ({ sql, parameters, ocelVersion, enabled }: O
   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>>;
+  refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@ocelescope/api-base").SqlQueryResult, unknown>>;
   fetchStatus: import("@tanstack/react-query").FetchStatus;
   queryKey: readonly unknown[] & {
     [dataTagSymbol]: import("@ocelescope/api-base").SqlQueryResult;
-    [dataTagErrorSymbol]: import("@ocelescope/api-base").HTTPValidationError$1;
+    [dataTagErrorSymbol]: unknown;
   };
 };
 //#endregion
@@ -645,4 +742,4 @@ export declare const getModuleRoute: ({ moduleName, routeName, query }: {
   pathname: string;
 };
 //#endregion
-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 };
+export { type ActivityPickerProps, type AreaChartProps, type AttributePickerProps, type AttributeRef, AttributesTable, type BarChartProps, type CartesianChartProps, type ChartOptions, type ChartProps, type ChartType, type E2ORelationPickerProps, type EventAttributePickerProps, type EventPickerProps, type HistogramChartProps, type LineChartProps, type MultiSelection, type O2ORelationPickerProps, type ObjectAttributePickerProps, type ObjectPickerProps, type ObjectTypePickerProps, type OcelChartProps, type OcelPickerProps, type OcelQueryOptions, type OcelSource, type OptionPickerProps, type PickerGroup, type PickerOption, type PickerProps, type PieChartProps, type Relation, RelationTable, type Row, type ScatterChartProps, type Selection, type Series, type SingleSelection, type SqlChartProps, type SunburstChartProps };