@datarecce/ui 0.1.41 → 0.2.1-nightly.20260402

package/dist/index-B1IyNkDA.d.ts

@@ -0,0 +1,472 @@
+
+import { t as ApiClient } from "./fetchClient-CTnJ39EA.js";
+import { o as LineageGraphProviderProps } from "./index-C9nBECPv.js";
+import { lt as LineageNodeData, mt as LineageEdgeData } from "./SplitPane-g8w-XF2_.js";
+import { s as RecceActionProviderProps } from "./index-Dh6gw0NG.js";
+import * as _$react from "react";
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { Edge, FitViewOptions, Node } from "@xyflow/react";
+//#region src/components/lineage/LineageCanvas.d.ts
+interface LineageCanvasProps {
+  /** Nodes to display */
+  nodes: Node<LineageNodeData>[];
+  /** Edges connecting nodes */
+  edges: Edge<LineageEdgeData>[];
+  /** Callback when node selection changes */
+  onNodeSelect?: (nodeId: string | null) => void;
+  /** Callback when node is double-clicked */
+  onNodeDoubleClick?: (nodeId: string) => void;
+  /** Whether to show minimap */
+  showMiniMap?: boolean;
+  /** Whether to show controls */
+  showControls?: boolean;
+  /** Whether to show background grid */
+  showBackground?: boolean;
+  /** Height of the graph container */
+  height?: number | string;
+  /** Whether the graph is interactive */
+  interactive?: boolean;
+  /** Minimum zoom level (passed to ReactFlow) */
+  minZoom?: number;
+  /** Maximum zoom level (passed to ReactFlow) */
+  maxZoom?: number;
+  /** Options passed to fitView on initial render */
+  fitViewOptions?: FitViewOptions;
+}
+declare function LineageCanvas({
+  nodes: initialNodes,
+  edges: initialEdges,
+  onNodeSelect,
+  onNodeDoubleClick,
+  showMiniMap,
+  showControls,
+  showBackground,
+  height,
+  interactive,
+  minZoom,
+  maxZoom,
+  fitViewOptions
+}: LineageCanvasProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+//#region src/providers/contexts/CheckContext.d.ts
+interface Check {
+  check_id: string;
+  name: string;
+  type: string;
+  description?: string;
+  is_checked?: boolean;
+}
+interface CheckContextType {
+  checks: Check[];
+  isLoading: boolean;
+  error?: string;
+  selectedCheckId?: string;
+  onSelectCheck?: (checkId: string) => void;
+  onCreateCheck?: (check: Partial<Check>) => Promise<Check>;
+  onUpdateCheck?: (checkId: string, updates: Partial<Check>) => Promise<Check>;
+  onDeleteCheck?: (checkId: string) => Promise<void>;
+  onReorderChecks?: (sourceIndex: number, destIndex: number) => Promise<void>;
+  refetchChecks?: () => void;
+  /** @remarks Alias of selectedCheckId (OSS backward compatibility). */
+  latestSelectedCheckId?: string;
+  /** @remarks Alias of onSelectCheck (OSS backward compatibility). */
+  setLatestSelectedCheckId?: (checkId: string) => void;
+}
+interface CheckProviderProps {
+  children: ReactNode;
+  checks?: Check[];
+  isLoading?: boolean;
+  error?: string;
+  selectedCheckId?: string;
+  onSelectCheck?: (checkId: string) => void;
+  onCreateCheck?: (check: Partial<Check>) => Promise<Check>;
+  onUpdateCheck?: (checkId: string, updates: Partial<Check>) => Promise<Check>;
+  onDeleteCheck?: (checkId: string) => Promise<void>;
+  onReorderChecks?: (sourceIndex: number, destIndex: number) => Promise<void>;
+  refetchChecks?: () => void;
+  /** @remarks Alias of selectedCheckId (OSS backward compatibility). */
+  latestSelectedCheckId?: string;
+  /** @remarks Alias of onSelectCheck (OSS backward compatibility). */
+  setLatestSelectedCheckId?: (checkId: string) => void;
+}
+declare function CheckProvider({
+  children,
+  checks,
+  isLoading,
+  error,
+  selectedCheckId,
+  onSelectCheck,
+  onCreateCheck,
+  onUpdateCheck,
+  onDeleteCheck,
+  onReorderChecks,
+  refetchChecks,
+  latestSelectedCheckId,
+  setLatestSelectedCheckId
+}: CheckProviderProps): _$react_jsx_runtime0.JSX.Element;
+declare function useCheckContext(): CheckContextType;
+//#endregion
+//#region src/providers/contexts/QueryContext.d.ts
+interface QueryResult {
+  columns: string[];
+  data: Record<string, unknown>[];
+  rowCount: number;
+}
+interface QueryContextType {
+  sql: string;
+  isExecuting: boolean;
+  error?: string;
+  baseResult?: QueryResult;
+  currentResult?: QueryResult;
+  onSqlChange?: (sql: string) => void;
+  onExecute?: (sql: string) => Promise<void>;
+  onCancel?: () => void;
+  /** @remarks Alias of sql (OSS backward compatibility). */
+  sqlQuery?: string;
+  /** @remarks Alias of onSqlChange (OSS backward compatibility). */
+  setSqlQuery?: (sql: string) => void;
+  /** Primary key columns for diff matching */
+  primaryKeys?: string[];
+  /** Setter for primary keys */
+  setPrimaryKeys?: (pks: string[] | undefined) => void;
+  /** Whether using custom SQL queries vs model-generated */
+  isCustomQueries?: boolean;
+  /** Setter for isCustomQueries */
+  setCustomQueries?: (isCustom: boolean) => void;
+  /** Base SQL query for diff comparison */
+  baseSqlQuery?: string;
+  /** Setter for base SQL query */
+  setBaseSqlQuery?: (sql: string) => void;
+}
+interface QueryProviderProps {
+  children: ReactNode;
+  sql?: string;
+  isExecuting?: boolean;
+  error?: string;
+  baseResult?: QueryResult;
+  currentResult?: QueryResult;
+  onSqlChange?: (sql: string) => void;
+  onExecute?: (sql: string) => Promise<void>;
+  onCancel?: () => void;
+  sqlQuery?: string;
+  setSqlQuery?: (sql: string) => void;
+  primaryKeys?: string[];
+  setPrimaryKeys?: (pks: string[] | undefined) => void;
+  isCustomQueries?: boolean;
+  setCustomQueries?: (isCustom: boolean) => void;
+  baseSqlQuery?: string;
+  setBaseSqlQuery?: (sql: string) => void;
+}
+declare function QueryProvider({
+  children,
+  sql,
+  isExecuting,
+  error,
+  baseResult,
+  currentResult,
+  onSqlChange,
+  onExecute,
+  onCancel,
+  sqlQuery,
+  setSqlQuery,
+  primaryKeys,
+  setPrimaryKeys,
+  isCustomQueries,
+  setCustomQueries,
+  baseSqlQuery,
+  setBaseSqlQuery
+}: QueryProviderProps): _$react_jsx_runtime0.JSX.Element;
+declare function useQueryContext(): QueryContextType;
+//#endregion
+//#region src/providers/contexts/RoutingContext.d.ts
+/**
+ * Navigation options for route changes
+ */
+interface NavigateOptions {
+  /** Replace current history entry instead of pushing */
+  replace?: boolean;
+  /** Scroll to top after navigation (default: true) */
+  scroll?: boolean;
+}
+/**
+ * Configuration for the routing provider
+ */
+interface RoutingConfig {
+  /** Base path prefix for all routes */
+  basePath?: string;
+  /**
+   * Current pathname (provided by consumer's router)
+   * If not provided, defaults to empty string
+   */
+  pathname?: string;
+  /**
+   * Navigation handler (provided by consumer's router)
+   * Called when components need to navigate programmatically
+   *
+   * @example
+   * ```tsx
+   * // Next.js App Router
+   * const router = useRouter();
+   * <RecceProvider
+   *   routing={{
+   *     pathname: usePathname(),
+   *     onNavigate: (path, options) => {
+   *       options?.replace ? router.replace(path) : router.push(path);
+   *     }
+   *   }}
+   * />
+   * ```
+   */
+  onNavigate?: (path: string, options?: NavigateOptions) => void;
+}
+/**
+ * Routing context value available to consumers
+ */
+interface RoutingContextValue {
+  /** Base path prefix */
+  basePath: string;
+  /** Build a full path with base path prefix */
+  buildPath: (path: string) => string;
+  /** Current pathname (if provided by consumer) */
+  pathname: string;
+  /** Navigate to a path */
+  navigate: (path: string, options?: NavigateOptions) => void;
+}
+/**
+ * Hook to access routing context
+ *
+ * @returns Routing context with path utilities and navigation
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { pathname, navigate, buildPath } = useRouting();
+ *
+ *   return (
+ *     <button onClick={() => navigate(buildPath('/checks'))}>
+ *       Go to Checks
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useRouting(): RoutingContextValue;
+/**
+ * Hook compatible with useAppLocation API
+ *
+ * Returns a tuple of [pathname, setLocation] for easy migration from
+ * the OSS useAppLocation hook.
+ *
+ * @returns [pathname, navigate] tuple
+ *
+ * @example
+ * ```tsx
+ * const [location, setLocation] = useAppLocation();
+ * setLocation('/checks?id=123');
+ * setLocation('/checks', { replace: true });
+ * ```
+ */
+declare function useAppLocation(): [string, (path: string, options?: NavigateOptions) => void];
+//#endregion
+//#region src/providers/RecceProvider.d.ts
+/**
+ * Theme mode selection for RecceProvider.
+ */
+type ThemeMode = "light" | "dark" | "system";
+/**
+ * Props for {@link RecceProvider}.
+ */
+interface RecceProviderProps {
+  children: ReactNode;
+  /**
+   * API configuration - simple config OR custom client.
+   */
+  api: {
+    baseUrl: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+  } | {
+    client: ApiClient;
+  };
+  /**
+   * Theme mode.
+   *
+   * @defaultValue "system"
+   */
+  theme?: ThemeMode;
+  /**
+   * Routing configuration
+   *
+   * @example
+   * ```tsx
+   * // With Next.js App Router
+   * const router = useRouter();
+   * const pathname = usePathname();
+   *
+   * <RecceProvider
+   *   routing={{
+   *     basePath: '/app',
+   *     pathname,
+   *     onNavigate: (path, options) => {
+   *       options?.replace ? router.replace(path) : router.push(path);
+   *     }
+   *   }}
+   * />
+   * ```
+   */
+  routing?: {
+    basePath?: string;
+    pathname?: string;
+    onNavigate?: (path: string, options?: {
+      replace?: boolean;
+      scroll?: boolean;
+    }) => void;
+  };
+  /**
+   * TanStack Query client configuration.
+   */
+  queryClient?: {
+    staleTime?: number;
+    gcTime?: number;
+  };
+  /**
+   * Run action configuration
+   * Props for RecceActionProvider - manages run execution and result display
+   */
+  runActions?: {
+    /** Handler called when a run action is requested */onRunAction?: RecceActionProviderProps["onRunAction"]; /** Handler called when a run result should be shown */
+    onShowRunId?: RecceActionProviderProps["onShowRunId"]; /** Initial run ID to display */
+    initialRunId?: string; /** Initial state for history panel */
+    initialHistoryOpen?: boolean;
+  };
+  /**
+   * Lineage graph configuration
+   * Props for LineageGraphProvider - manages lineage visualization
+   */
+  lineage?: {
+    /** The processed lineage graph data */lineageGraph?: LineageGraphProviderProps["lineageGraph"]; /** Environment information (git, dbt, sqlmesh metadata) */
+    envInfo?: LineageGraphProviderProps["envInfo"]; /** Whether in review mode (read-only checks) */
+    reviewMode?: boolean; /** Whether in cloud mode (recce cloud) */
+    cloudMode?: boolean; /** Whether in file mode (loading from file) */
+    fileMode?: boolean; /** The state file name if in file mode */
+    fileName?: string; /** Whether this is the demo site */
+    isDemoSite?: boolean; /** Whether running in GitHub Codespace */
+    isCodespace?: boolean; /** Loading state */
+    isLoading?: boolean; /** Error message if loading failed */
+    error?: string; /** Supported task types from server */
+    supportTasks?: Record<string, boolean>; /** Callback to refetch the lineage graph */
+    onRefetchLineageGraph?: () => void; /** Pre-aggregated run results by model */
+    runsAggregated?: LineageGraphProviderProps["runsAggregated"]; /** Callback to refetch aggregated runs */
+    onRefetchRunsAggregated?: () => void;
+  };
+  /**
+   * Check management configuration
+   * Props for CheckProvider - manages check CRUD operations
+   */
+  checks?: {
+    /** List of checks */checks?: Check[]; /** Loading state */
+    isLoading?: boolean; /** Error message */
+    error?: string; /** Currently selected check ID */
+    selectedCheckId?: string; /** Handler for check selection */
+    onSelectCheck?: CheckProviderProps["onSelectCheck"]; /** Handler for check creation */
+    onCreateCheck?: CheckProviderProps["onCreateCheck"]; /** Handler for check updates */
+    onUpdateCheck?: CheckProviderProps["onUpdateCheck"]; /** Handler for check deletion */
+    onDeleteCheck?: CheckProviderProps["onDeleteCheck"]; /** Handler for check reordering */
+    onReorderChecks?: CheckProviderProps["onReorderChecks"]; /** Callback to refetch checks */
+    refetchChecks?: () => void;
+  };
+  /**
+   * Query editor configuration
+   * Props for QueryProvider - manages SQL query execution
+   */
+  query?: {
+    /** Current SQL query */sql?: string; /** Whether query is executing */
+    isExecuting?: boolean; /** Error message */
+    error?: string; /** Query result for base environment */
+    baseResult?: QueryResult; /** Query result for current environment */
+    currentResult?: QueryResult; /** Handler for SQL changes */
+    onSqlChange?: QueryProviderProps["onSqlChange"]; /** Handler for query execution */
+    onExecute?: QueryProviderProps["onExecute"]; /** Handler for query cancellation */
+    onCancel?: QueryProviderProps["onCancel"];
+  };
+  /**
+   * Feature flags - control which contexts are enabled
+   * Set to false to skip a context entirely (reduces overhead if unused)
+   */
+  features?: {
+    /** Enable RecceInstanceInfoProvider (instance info and feature toggles) */enableInstance?: boolean; /** Enable IdleTimeoutProvider (session timeout and keep-alive) */
+    enableIdleTimeout?: boolean; /** Enable LineageGraphProvider (lineage visualization) */
+    enableLineage?: boolean; /** Enable RecceActionProvider (run execution) */
+    enableRunActions?: boolean; /** Enable CheckProvider (check management) */
+    enableChecks?: boolean; /** Enable QueryProvider (SQL query editor) */
+    enableQuery?: boolean;
+  };
+}
+/**
+ * RecceProvider - The single entry point for @datarecce/ui
+ *
+ * This provider orchestrates ALL Recce contexts in the correct order.
+ * It follows a props-driven design - pass your data and callbacks, no internal fetching.
+ *
+ * **Architecture:**
+ * - Foundation layer: QueryClient → API → Theme → Routing
+ * - Data layer: Instance → Idle → Lineage → RunActions
+ * - UI layer: Checks → Query
+ *
+ * **Feature Flags:**
+ * Use `features` prop to disable unused contexts and reduce overhead.
+ *
+ * @example
+ * ```tsx
+ * // Minimal setup (only API + Theme)
+ * <RecceProvider api={{ baseUrl: "/api" }}>
+ *   <MyApp />
+ * </RecceProvider>
+ *
+ * // Full setup with all features
+ * <RecceProvider
+ *   api={{ baseUrl: "/api" }}
+ *   theme="dark"
+ *   lineage={{
+ *     lineageGraph: data.lineageGraph,
+ *     envInfo: data.envInfo,
+ *     onRefetchLineageGraph: refetch,
+ *   }}
+ *   runActions={{
+ *     onRunAction: handleRunAction,
+ *     onShowRunId: handleShowRun,
+ *   }}
+ *   checks={{
+ *     checks: checksData,
+ *     onCreateCheck: createCheck,
+ *     onUpdateCheck: updateCheck,
+ *   }}
+ *   features={{
+ *     enableLineage: true,
+ *     enableRunActions: true,
+ *     enableChecks: true,
+ *   }}
+ * >
+ *   <MyApp />
+ * </RecceProvider>
+ * ```
+ */
+declare function RecceProvider({
+  children,
+  api,
+  theme,
+  routing,
+  queryClient: queryClientConfig,
+  runActions,
+  lineage,
+  checks,
+  query,
+  features
+}: RecceProviderProps): _$react.ReactElement<unknown, string | _$react.JSXElementConstructor<any>>;
+//#endregion
+//#region src/types/index.d.ts
+declare const TYPES_API_VERSION = "0.1.0";
+//#endregion
+export { CheckProviderProps as _, RoutingConfig as a, LineageCanvasProps as b, useRouting as c, QueryProviderProps as d, QueryResult as f, CheckProvider as g, CheckContextType as h, NavigateOptions as i, QueryContextType as l, Check as m, RecceProvider as n, RoutingContextValue as o, useQueryContext as p, RecceProviderProps as r, useAppLocation as s, TYPES_API_VERSION as t, QueryProvider as u, useCheckContext as v, LineageCanvas as y };
+//# sourceMappingURL=index-B1IyNkDA.d.ts.map

package/dist/index-B1IyNkDA.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-B1IyNkDA.d.ts","names":[],"sources":["../src/components/lineage/LineageCanvas.tsx","../src/providers/contexts/CheckContext.tsx","../src/providers/contexts/QueryContext.tsx","../src/providers/contexts/RoutingContext.tsx","../src/providers/RecceProvider.tsx","../src/types/index.ts"],"mappings":"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"}

package/dist/index-BJOCIgE1.d.ts

@@ -0,0 +1,148 @@
+
+import { r as DataGridHandle } from "./ScreenshotDataGrid-BAsPWcde.js";
+import * as _$react from "react";
+import { ReactNode, Ref } from "react";
+
+//#region src/components/result/types.d.ts
+/**
+ * Ref types supported by ResultView components
+ */
+type ResultViewRef = DataGridHandle | HTMLDivElement;
+/**
+ * Screenshot wrapper types
+ */
+type ScreenshotWrapperType = "grid" | "box";
+/**
+ * Warning display styles for the toolbar area.
+ *
+ * - 'alert': MUI Alert with severity="warning" (default)
+ * - 'amber': Amber-colored inline warning with icon (matches QueryResultView pattern)
+ */
+type WarningStyle = "alert" | "amber";
+/**
+ * Base props for all ResultView components
+ */
+interface ResultViewProps<TViewOptions = unknown> {
+  run: unknown;
+  viewOptions?: TViewOptions;
+  onViewOptionsChanged?: (options: TViewOptions) => void;
+}
+/**
+ * Configuration for the createResultView factory
+ */
+interface ResultViewConfig<TRun, TViewOptions = unknown, _TRef extends ResultViewRef = DataGridHandle> {
+  displayName: string;
+  typeGuard: (run: unknown) => run is TRun;
+  expectedRunType: string;
+  screenshotWrapper: ScreenshotWrapperType;
+  transformData: (run: TRun, options: ResultViewTransformOptions<TViewOptions>) => ResultViewData | null;
+  emptyState?: ReactNode | string;
+  conditionalEmptyState?: (run: TRun, viewOptions?: TViewOptions) => ReactNode | null;
+}
+/**
+ * Options passed to transformData
+ */
+interface ResultViewTransformOptions<TViewOptions> {
+  viewOptions?: TViewOptions;
+  onViewOptionsChanged?: (options: TViewOptions) => void;
+  /**
+   * Callback when user wants to add run to checklist.
+   * Passed through from component props.
+   */
+  onAddToChecklist?: (run: unknown) => void;
+  /** Whether dark mode is active (from useIsDark hook in createResultView) */
+  isDark: boolean;
+}
+/**
+ * Result of transformData
+ */
+interface ResultViewData {
+  columns?: unknown[];
+  rows?: unknown[];
+  content?: ReactNode;
+  isEmpty?: boolean;
+  /**
+   * Custom empty message to show when isEmpty is true.
+   * When provided along with toolbar/warnings, shows toolbar above this message.
+   * Enables "toolbar-in-empty-state" pattern for components like ValueDiffDetailResultView.
+   */
+  emptyMessage?: ReactNode;
+  header?: ReactNode;
+  footer?: ReactNode;
+  /**
+   * Toolbar controls to render above the content.
+   * Renders on the right side of the toolbar area.
+   */
+  toolbar?: ReactNode;
+  /**
+   * Warning messages to display in the toolbar area.
+   * Renders as alert chips on the left side.
+   */
+  warnings?: string[];
+  /**
+   * Style for rendering warnings.
+   * - 'alert' (default): MUI Alert with severity="warning"
+   * - 'amber': Amber-colored inline warning with icon (like QueryResultView)
+   */
+  warningStyle?: WarningStyle;
+  renderNull?: boolean;
+  /**
+   * Default column options for grid wrapper.
+   * Passed to ScreenshotDataGrid's defaultColumnOptions prop.
+   */
+  defaultColumnOptions?: {
+    resizable?: boolean;
+    maxWidth?: number;
+    minWidth?: number;
+  };
+  /**
+   * Custom message for grid's empty rows state (when rows array exists but is empty).
+   * Passed to EmptyRowsRenderer in ScreenshotDataGrid.
+   */
+  noRowsMessage?: string;
+}
+/**
+ * Props for factory-created ResultView components
+ */
+interface CreatedResultViewProps<TViewOptions = unknown> extends ResultViewProps<TViewOptions> {
+  ref?: Ref<ResultViewRef>;
+  /**
+   * Callback when user wants to add run to checklist.
+   * Used by QueryResultView.
+   */
+  onAddToChecklist?: (run: unknown) => void;
+}
+//#endregion
+//#region src/components/result/createResultView.d.ts
+/**
+ * Factory function to create type-safe ResultView components.
+ *
+ * @remarks
+ * Reduces boilerplate by handling:
+ * - Type guard validation with consistent error messages
+ * - forwardRef setup for screenshot capture
+ * - Dark/light theme handling
+ * - Empty state rendering
+ *
+ * @typeParam TRun - Run payload type validated by the type guard.
+ * @typeParam TViewOptions - Optional view options shape used by the view.
+ * @typeParam TRef - Ref type exposed by the view (defaults to DataGridHandle).
+ *
+ * @example
+ * ```tsx
+ * export const RowCountResultView = createResultView({
+ *   displayName: "RowCountResultView",
+ *   typeGuard: isRowCountRun,
+ *   expectedRunType: "row_count",
+ *   screenshotWrapper: "grid",
+ *   transformData: (run) => ({
+ *     columns: toRowCountGrid(run).columns,
+ *     rows: toRowCountGrid(run).rows,
+ *   }),
+ * });
+ * ```
+ */
+declare function createResultView<TRun, TViewOptions = unknown, TRef extends ResultViewRef = DataGridHandle>(config: ResultViewConfig<TRun, TViewOptions>): _$react.ForwardRefExoticComponent<Omit<CreatedResultViewProps<TViewOptions>, "ref"> & _$react.RefAttributes<TRef>>;
+//#endregion
+export { ResultViewProps as a, ScreenshotWrapperType as c, ResultViewData as i, CreatedResultViewProps as n, ResultViewRef as o, ResultViewConfig as r, ResultViewTransformOptions as s, createResultView as t };
+//# sourceMappingURL=index-BJOCIgE1.d.ts.map

package/dist/index-BJOCIgE1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BJOCIgE1.d.ts","names":[],"sources":["../src/components/result/types.ts","../src/components/result/createResultView.tsx"],"mappings":";;;;;;;;;KAQY,aAAA,GAAgB,cAAA,GAAiB,cAAA;;;;KAKjC,qBAAA;AAAZ;;;;;AAQA;AARA,KAQY,YAAA;;;;UAKK,eAAA;EACf,GAAA;EACA,WAAA,GAAc,YAAA;EACd,oBAAA,IAAwB,OAAA,EAAS,YAAA;AAAA;;;;UAMlB,gBAAA,6CAGD,aAAA,GAAgB,cAAA;EAE9B,WAAA;EACA,SAAA,GAAY,GAAA,cAAiB,GAAA,IAAO,IAAA;EACpC,eAAA;EACA,iBAAA,EAAmB,qBAAA;EACnB,aAAA,GACE,GAAA,EAAK,IAAA,EACL,OAAA,EAAS,0BAAA,CAA2B,YAAA,MACjC,cAAA;EACL,UAAA,GAAa,SAAA;EACb,qBAAA,IACE,GAAA,EAAK,IAAA,EACL,WAAA,GAAc,YAAA,KACX,SAAA;AAAA;;;;UAMU,0BAAA;EACf,WAAA,GAAc,YAAA;EACd,oBAAA,IAAwB,OAAA,EAAS,YAAA;EAb5B;;;;EAmBL,gBAAA,IAAoB,GAAA;EAdN;EAiBd,MAAA;AAAA;;;;UAMe,cAAA;EACf,OAAA;EACA,IAAA;EACA,OAAA,GAAU,SAAA;EACV,OAAA;EAtCoC;;;;;EA6CpC,YAAA,GAAe,SAAA;EAGf,MAAA,GAAS,SAAA;EACT,MAAA,GAAS,SAAA;EA5C6B;;;;EAkDtC,OAAA,GAAU,SAAA;EA/CV;;;;EAqDA,QAAA;EAlDK;;;AAMP;;EAmDE,YAAA,GAAe,YAAA;EAIf,UAAA;EAvD0C;;;;EA6D1C,oBAAA;IACE,SAAA;IACA,QAAA;IACA,QAAA;EAAA;EArDI;;AAMR;;EAsDE,aAAA;AAAA;;;;UAMe,sBAAA,iCACP,eAAA,CAAgB,YAAA;EACxB,GAAA,GAAM,GAAA,CAAI,aAAA;EA5BiB;;;;EAkC3B,gBAAA,IAAoB,GAAA;AAAA;;;;;;AAvItB;;;;;AAKA;;;;;AAQA;;;;;AAKA;;;;;;;;;;iBCuHgB,gBAAA,4CAGD,aAAA,GAAgB,cAAA,CAAA,CAC7B,MAAA,EAAQ,gBAAA,CAAiB,IAAA,EAAM,YAAA,IAAa,OAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,sBAAA,CAAA,YAAA,YAAA,OAAA,CAAA,aAAA,CAAA,IAAA"}