@mastra/playground-ui 23.0.2-alpha.2 → 24.0.0-alpha.0

package/dist/src/domains/logs/components/index.d.ts

@@ -0,0 +1,6 @@
+export { LogDetailsView, type LogDetailsViewProps } from './log-details-view';
+export { LogsErrorContent, type LogsErrorContentProps } from './logs-error-content';
+export { LogsLayout, type LogsLayoutProps } from './logs-layout';
+export { LogsListView, type LogsListViewProps } from './logs-list-view';
+export { LogsToolbar, type LogsToolbarProps } from './logs-toolbar';
+export { NoLogsInfo } from './no-logs-info';

package/dist/src/domains/logs/components/log-details-view.d.ts

@@ -0,0 +1,12 @@
+import { LogRecord } from '../types';
+export interface LogDetailsViewProps {
+    log: LogRecord;
+    onClose: () => void;
+    onTraceClick?: (traceId: string) => void;
+    onSpanClick?: (traceId: string, spanId: string) => void;
+    onPrevious?: () => void;
+    onNext?: () => void;
+    collapsed?: boolean;
+    onCollapsedChange?: (collapsed: boolean) => void;
+}
+export declare function LogDetailsView({ log, onClose, onTraceClick, onSpanClick, onPrevious, onNext, collapsed: controlledCollapsed, onCollapsedChange, }: LogDetailsViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/domains/logs/components/logs-error-content.d.ts

@@ -0,0 +1,14 @@
+export interface LogsErrorContentProps {
+    /** The error from a useLogs query. */
+    error: unknown;
+    /** Passed to PermissionDenied (usually 'logs'). */
+    resource: string;
+    /** Title shown on the generic ErrorState fallback. */
+    errorTitle: string;
+}
+/**
+ * Renders the appropriate fallback content for a logs-related query error:
+ * `<SessionExpired />` for 401, `<PermissionDenied />` for 403, otherwise `<ErrorState />`.
+ * Mirror of `TracesErrorContent` for the logs domain.
+ */
+export declare function LogsErrorContent({ error, resource, errorTitle }: LogsErrorContentProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/domains/logs/components/logs-layout.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from '../../../../node_modules/@types/react';
+export interface LogsLayoutProps {
+    /** The logs list (left column). */
+    listSlot: ReactNode;
+    /** The log data panel (right column, top). When null/undefined, the whole right column collapses. */
+    logPanelSlot?: ReactNode;
+    /** The trace data panel (right column, middle). Only rendered when truthy. */
+    tracePanelSlot?: ReactNode;
+    /** The span data panel (right column, bottom). Only rendered when truthy. */
+    spanPanelSlot?: ReactNode;
+    /** When the log panel is collapsed, the right column's grid-rows squash the log row to `auto`. */
+    logCollapsed?: boolean;
+}
+/**
+ * Pure 2-column layout shell for the logs page. Owns no state and fetches no data — pass slots in.
+ * Right-column row template adapts based on which panels are present and whether the log panel is
+ * collapsed.
+ */
+export declare function LogsLayout({ listSlot, logPanelSlot, tracePanelSlot, spanPanelSlot, logCollapsed }: LogsLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/domains/logs/components/logs-list-view.d.ts

@@ -0,0 +1,20 @@
+import { LogRecord } from '../types';
+export interface LogsListViewProps {
+    logs: LogRecord[];
+    isLoading?: boolean;
+    isFetchingNextPage?: boolean;
+    hasNextPage?: boolean;
+    setEndOfListElement?: (element: HTMLDivElement | null) => void;
+    /** Stable per-render id for each log — used for React keys and for matching against `featuredLogId`.
+     *  Build with `useLogsListNavigation`. */
+    logIdMap: Map<LogRecord, string>;
+    /** Currently featured/selected log — its row gets the highlighted background. */
+    featuredLogId?: string | null;
+    /** Called when a row is clicked. The current toggle + trace-sync logic is the consumer's call. */
+    onLogClick: (log: LogRecord) => void;
+}
+/**
+ * Pure presentational list. Renders the LogsDataList primitive with rows, empty state, and
+ * infinite-paging loader. Owns no state and fetches no data.
+ */
+export declare function LogsListView({ logs, isLoading, isFetchingNextPage, hasNextPage, setEndOfListElement, logIdMap, featuredLogId, onLogClick, }: LogsListViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/domains/logs/components/logs-toolbar.d.ts

@@ -0,0 +1,13 @@
+import { PropertyFilterField, PropertyFilterToken } from '../../../ds/components/PropertyFilter/types';
+export interface LogsToolbarProps {
+    onClear?: () => void;
+    onRemoveAll?: () => void;
+    onSave?: () => void;
+    onRemoveSaved?: () => void;
+    isLoading?: boolean;
+    filterFields: PropertyFilterField[];
+    filterTokens: PropertyFilterToken[];
+    onFilterTokensChange: (tokens: PropertyFilterToken[]) => void;
+    autoFocusFilterFieldId?: string;
+}
+export declare function LogsToolbar({ onClear, onRemoveAll, onSave, onRemoveSaved, isLoading, filterFields, filterTokens, onFilterTokensChange, autoFocusFilterFieldId, }: LogsToolbarProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/domains/logs/components/no-logs-info.d.ts

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

package/dist/src/domains/logs/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useLogs } from './use-logs';
+export { useLogsUrlState, type UseLogsUrlStateResult, type UseLogsUrlStateOptions, type LogsFeaturedIds, } from './use-logs-url-state';
+export { useLogsFilterPersistence, type UseLogsFilterPersistenceResult, type LogsFilterPersistenceOptions, } from './use-logs-filter-persistence';
+export { useLogsListNavigation, type UseLogsListNavigationResult } from './use-logs-list-navigation';

package/dist/src/domains/logs/hooks/use-logs-filter-persistence.d.ts

@@ -0,0 +1,22 @@
+import { SetURLSearchParamsLike } from '../../traces/hooks/use-trace-url-state';
+export interface LogsFilterPersistenceOptions {
+    /** Override the localStorage key. Default: 'mastra:logs:saved-filters'. */
+    storageKey?: string;
+    /** Toast text overrides; pass `false` to suppress the toast entirely. */
+    messages?: {
+        saved?: string | false;
+        cleared?: string | false;
+    };
+    /** Skip the once-on-mount hydration from localStorage. Default: false. */
+    skipHydration?: boolean;
+}
+export interface UseLogsFilterPersistenceResult {
+    hasSavedFilters: boolean;
+    handleSave: () => void;
+    handleRemoveSaved: () => void;
+}
+/**
+ * Owns the localStorage save/restore lifecycle for logs filters. Mirrors
+ * `useTraceFilterPersistence` — same pattern, different storage key default.
+ */
+export declare function useLogsFilterPersistence(searchParams: URLSearchParams, setSearchParams: SetURLSearchParamsLike, options?: LogsFilterPersistenceOptions): UseLogsFilterPersistenceResult;

package/dist/src/domains/logs/hooks/use-logs-list-navigation.d.ts

@@ -0,0 +1,22 @@
+import { LogRecord } from '../types';
+import { LogsFeaturedIds } from './use-logs-url-state';
+export interface UseLogsListNavigationResult {
+    /** Map each log in the list to its derived id. Pass to `<LogsListView logIdMap={...}>`. */
+    logIdMap: Map<LogRecord, string>;
+    /** Look up a log's id (undefined if not in the list). */
+    getLogId: (log: LogRecord) => string | undefined;
+    /** The currently featured log resolved from `featuredLogId`, or null. */
+    featuredLog: LogRecord | null;
+    /** Click handler that flips featured selection with toggle behavior, and — when a trace panel is
+     *  open — syncs the trace panel to the new log's trace. Pass to `<LogsListView onLogClick={...}>`. */
+    handleLogClick: (log: LogRecord) => void;
+    /** Undefined when at the start of the list (disable the prev button). */
+    handlePreviousLog: (() => void) | undefined;
+    /** Undefined when at the end of the list (disable the next button). */
+    handleNextLog: (() => void) | undefined;
+}
+/**
+ * Derives id mapping + featured log + prev/next/click handlers for a logs list. Stateless — only
+ * reads from the inputs and calls `onFeaturedChange` on selection changes.
+ */
+export declare function useLogsListNavigation(logs: LogRecord[], featuredLogId: string | null, onFeaturedChange: (ids: LogsFeaturedIds) => void, featuredTraceId?: string | null): UseLogsListNavigationResult;

package/dist/src/domains/logs/hooks/use-logs-url-state.d.ts

@@ -0,0 +1,38 @@
+import { SetURLSearchParamsLike } from '../../traces/hooks/use-trace-url-state';
+import { LogsDatePreset, LogsEntityOptions } from '../log-filters';
+import { PropertyFilterToken } from '../../../ds/components/PropertyFilter/types';
+export interface LogsFeaturedIds {
+    logId?: string | null;
+    traceId?: string | null;
+    spanId?: string | null;
+}
+export interface UseLogsUrlStateOptions {
+    /** Called after `handleRemoveAll` clears all filter URL params. */
+    onRemoveAll?: () => void;
+}
+export interface UseLogsUrlStateResult {
+    searchParams: URLSearchParams;
+    setSearchParams: SetURLSearchParamsLike;
+    datePreset: LogsDatePreset;
+    selectedDateFrom: Date | undefined;
+    selectedDateTo: Date | undefined;
+    datePresetRef: React.MutableRefObject<LogsDatePreset>;
+    featuredLogId: string | null;
+    featuredTraceId: string | null;
+    featuredSpanId: string | null;
+    selectedEntityOption: LogsEntityOptions | undefined;
+    filterTokens: PropertyFilterToken[];
+    /** Partial update of the featured log/trace/span selection. Omitted keys are left as-is. */
+    handleFeaturedChange: (ids: LogsFeaturedIds) => void;
+    handleFilterTokensChange: (nextTokens: PropertyFilterToken[]) => void;
+    handleDateChange: (value: Date | undefined, type: 'from' | 'to') => void;
+    handleDatePresetChange: (preset: LogsDatePreset) => void;
+    handleRemoveAll: () => void;
+    /** Lower-level helper used by `handleClear`: writes a token set and clears the log/trace/span selection. */
+    applyFilterTokens: (tokens: PropertyFilterToken[]) => void;
+}
+/**
+ * Owns all URL-derived state and URL-modifying handlers for the logs page. Routing-agnostic —
+ * pass `searchParams` and `setSearchParams` from whichever router the consumer uses.
+ */
+export declare function useLogsUrlState(searchParams: URLSearchParams, setSearchParams: SetURLSearchParamsLike, options?: UseLogsUrlStateOptions): UseLogsUrlStateResult;