@questpie/admin 1.1.0 → 2.0.0

package/dist/client/builder/types/widget-types.d.mts

@@ -0,0 +1,563 @@
+import { I18nText } from "../../i18n/types.mjs";
+import { IconComponent, MaybeLazyComponent } from "./common.mjs";
+import { ComponentReference } from "../../../server/augmentation.mjs";
+import "../../../server/index.mjs";
+import * as React$1 from "react";
+
+//#region src/client/builder/types/widget-types.d.ts
+
+/**
+ * Widget card visual variant
+ */
+type WidgetCardVariant = "default" | "compact" | "featured";
+/**
+ * Base widget configuration shared by all widget types
+ */
+interface BaseWidgetConfig {
+  /**
+   * Widget ID
+   */
+  id: string;
+  /**
+   * Widget title
+   */
+  title?: I18nText;
+  /**
+   * Widget description
+   */
+  description?: I18nText;
+  /**
+   * Widget icon
+   */
+  icon?: IconComponent | ComponentReference | string;
+  /**
+   * Card visual variant
+   */
+  cardVariant?: WidgetCardVariant;
+  /**
+   * Widget size
+   */
+  size?: "small" | "medium" | "large" | "full";
+  /**
+   * Column span (1-12)
+   */
+  span?: number;
+  /**
+   * Grid position (for dashboard layouts)
+   */
+  position?: {
+    x?: number;
+    y?: number;
+    w?: number;
+    h?: number;
+  };
+  /**
+   * Data source configuration
+   */
+  dataSource?: WidgetDataSource;
+  /**
+   * Widget-specific options
+   */
+  options?: Record<string, any>;
+  /**
+   * Refresh interval in milliseconds
+   */
+  refreshInterval?: number;
+  /**
+   * Enable realtime invalidation for widget data queries.
+   * Falls back to AdminProvider realtime config when undefined.
+   */
+  realtime?: boolean;
+  /**
+   * Header actions
+   */
+  actions?: WidgetAction[];
+  /**
+   * Custom CSS class
+   */
+  className?: string;
+  /**
+   * Indicates server has a fetchFn for this widget (set by getAdminConfig).
+   * When true, the widget fetches data via the fetchWidgetData RPC endpoint
+   * instead of calling a client-side fetchFn.
+   */
+  hasFetchFn?: boolean;
+}
+/**
+ * Date filter presets for time-based filtering
+ */
+type DateFilterPreset = "today" | "yesterday" | "thisWeek" | "lastWeek" | "thisMonth" | "lastMonth" | "last7days" | "last30days" | "last90days" | "thisYear" | "lastYear";
+/**
+ * Date filter configuration
+ */
+interface DateFilterConfig {
+  /**
+   * Field name to filter on (e.g., "createdAt", "scheduledAt")
+   */
+  field: string;
+  /**
+   * Preset time range
+   */
+  range: DateFilterPreset;
+}
+/**
+ * Stats widget configuration
+ */
+interface StatsWidgetConfig extends BaseWidgetConfig {
+  type: "stats";
+  collection: string;
+  label?: I18nText;
+  /**
+   * Static filter (evaluated at build time)
+   */
+  filter?: Record<string, any>;
+  /**
+   * Dynamic filter function (evaluated at render time)
+   * Use this for filters that depend on current date/time
+   */
+  filterFn?: () => Record<string, any>;
+  /**
+   * Date filter preset (evaluated at render time)
+   * Shorthand for common date-based filters
+   */
+  dateFilter?: DateFilterConfig;
+  variant?: "default" | "primary" | "success" | "warning" | "danger";
+}
+/**
+ * Chart widget configuration
+ */
+interface ChartWidgetConfig extends BaseWidgetConfig {
+  type: "chart";
+  collection: string;
+  field: string;
+  chartType?: "line" | "bar" | "area" | "pie";
+  timeRange?: "7d" | "30d" | "90d" | "1y";
+  label?: I18nText;
+  color?: string;
+  showGrid?: boolean;
+  aggregation?: "count" | "sum" | "average";
+  valueField?: string;
+}
+/**
+ * Recent items widget configuration
+ */
+interface RecentItemsWidgetConfig extends BaseWidgetConfig {
+  type: "recentItems";
+  collection: string;
+  limit?: number;
+  titleField?: string;
+  dateField?: string;
+  subtitleFields?: string[];
+  label?: I18nText;
+}
+/**
+ * Quick action item configuration
+ */
+interface QuickActionItem {
+  /** Action label */
+  label: I18nText;
+  /** Action icon */
+  icon?: IconComponent | ComponentReference | string;
+  /** Link URL */
+  href?: string;
+  /** Click handler */
+  onClick?: () => void;
+  /** Visual variant */
+  variant?: "default" | "primary" | "secondary" | "outline";
+}
+/**
+ * Quick actions widget configuration
+ */
+interface QuickActionsWidgetConfig extends BaseWidgetConfig {
+  type: "quickActions";
+  /** List of quick action items */
+  quickActions: Array<string | QuickActionItem>;
+  /** Layout variant */
+  layout?: "grid" | "list";
+}
+/**
+ * Custom widget configuration
+ */
+interface CustomWidgetConfig extends BaseWidgetConfig {
+  type: "custom";
+  component: MaybeLazyComponent<WidgetComponentProps>;
+  config?: Record<string, any>;
+}
+/**
+ * ClassNames for styling value widget parts
+ */
+interface ValueWidgetClassNames {
+  /** Card container */
+  root?: string;
+  /** Header wrapper */
+  header?: string;
+  /** Label text */
+  label?: string;
+  /** Main icon */
+  icon?: ComponentReference | string;
+  /** Content wrapper */
+  content?: string;
+  /** Main value display */
+  value?: string;
+  /** Trend wrapper + text */
+  trend?: string;
+  /** Trend icon */
+  trendIcon?: string;
+  /** Subtitle text */
+  subtitle?: string;
+  /** Footer text */
+  footer?: string;
+}
+/**
+ * Trend indicator configuration
+ */
+interface ValueWidgetTrend {
+  /** Trend value (e.g., "+15.3%", "-5%") */
+  value: string;
+  /** Optional trend icon */
+  icon?: IconComponent | ComponentReference;
+}
+/**
+ * Result returned by fetchFn
+ */
+interface ValueWidgetResult {
+  /** Main value to display */
+  value: number | string;
+  /** Formatted value (if not provided, value.toLocaleString() is used) */
+  formatted?: string;
+  /** Label/title - supports i18n objects */
+  label?: I18nText | string;
+  /** Subtitle text - supports i18n objects */
+  subtitle?: I18nText | string;
+  /** Footer text - supports i18n objects */
+  footer?: I18nText | string;
+  /** Main icon */
+  icon?: IconComponent | ComponentReference;
+  /** Trend indicator */
+  trend?: ValueWidgetTrend;
+  /** Tailwind classes for each part */
+  classNames?: ValueWidgetClassNames;
+}
+/**
+ * Value widget configuration
+ *
+ * Flexible widget that fetches data via async function and supports
+ * full customization through Tailwind classes.
+ *
+ * @example
+ * ```tsx
+ * {
+ *   type: "value",
+ *   fetchFn: async (client) => {
+ *     const count = await client.collections.appointments.count({
+ *       where: { status: "pending" }
+ *     });
+ *     return {
+ *       value: count,
+ *       label: "Pending",
+ *       icon: Clock,
+ *       classNames: {
+ *         root: count > 10 ? "border-red-300 bg-red-50" : "",
+ *         value: count > 10 ? "text-red-600" : "",
+ *       },
+ *     };
+ *   },
+ * }
+ * ```
+ */
+interface ValueWidgetConfig extends BaseWidgetConfig {
+  type: "value";
+  /**
+   * Async function to fetch and transform data.
+   * Receives the Questpie client and returns widget display data.
+   * Optional when hasFetchFn is true (server provides the data).
+   */
+  fetchFn?: (client: any) => Promise<ValueWidgetResult>;
+  /**
+   * Refresh interval in milliseconds
+   * If set, the widget will refetch data at this interval
+   */
+  refreshInterval?: number;
+}
+/**
+ * Table column configuration with overrides
+ */
+interface TableWidgetColumnConfig {
+  /** Column key (field name) */
+  key: string;
+  /** Override column header label (defaults to field label) */
+  label?: I18nText;
+  /** Column width */
+  width?: number | string;
+  /** Text alignment */
+  align?: "left" | "center" | "right";
+  /** Custom cell renderer (overrides field's cell) */
+  render?: (value: any, row: any) => React$1.ReactNode;
+}
+/**
+ * Table column - can be a simple field key string or full config object
+ *
+ * @example
+ * ```ts
+ * // Simple - just field keys, uses field definitions automatically
+ * columns: ["name", "status", "createdAt"]
+ *
+ * // With overrides
+ * columns: [
+ *   "name",
+ *   { key: "price", align: "right" },
+ *   { key: "rating", render: (v) => `${v}/5` },
+ * ]
+ * ```
+ */
+type TableWidgetColumn = string | TableWidgetColumnConfig;
+/**
+ * Table widget configuration - displays a mini table
+ *
+ * Columns can be simple field keys (strings) or objects with overrides.
+ * Field definitions (label, cell renderer) are automatically pulled
+ * from the collection's admin config.
+ *
+ * @example
+ * ```ts
+ * {
+ *   type: "table",
+ *   id: "recent-orders",
+ *   title: "Recent Orders",
+ *   collection: "orders",
+ *   // Simple - field keys only, auto-uses field labels and cells
+ *   columns: ["orderNumber", "customer", "total", "status"],
+ *   limit: 5,
+ * }
+ *
+ * // With overrides
+ * {
+ *   type: "table",
+ *   collection: "reviews",
+ *   columns: [
+ *     "customer",
+ *     { key: "rating", render: (v) => `${v}/5` },
+ *     "comment",
+ *   ],
+ * }
+ * ```
+ */
+interface TableWidgetConfig extends BaseWidgetConfig {
+  type: "table";
+  /** Collection to fetch from */
+  collection: string;
+  /** Columns to display - field keys or config objects */
+  columns: TableWidgetColumn[];
+  /** Number of rows to show */
+  limit?: number;
+  /** Sort field */
+  sortBy?: string;
+  /** Sort direction */
+  sortOrder?: "asc" | "desc";
+  /** Filter */
+  filter?: Record<string, any>;
+  /** Show row actions */
+  showActions?: boolean;
+  /** Link rows to detail */
+  linkToDetail?: boolean;
+  /** Empty state message */
+  emptyMessage?: I18nText;
+}
+/**
+ * Timeline item configuration
+ */
+interface TimelineItem {
+  /** Item ID */
+  id: string;
+  /** Title */
+  title: string;
+  /** Description */
+  description?: string;
+  /** Timestamp */
+  timestamp: Date | string;
+  /** Icon */
+  icon?: IconComponent | ComponentReference;
+  /** Status/color variant */
+  variant?: "default" | "success" | "warning" | "error" | "info";
+  /** Link URL */
+  href?: string;
+  /** Additional metadata */
+  meta?: Record<string, any>;
+}
+/**
+ * Timeline widget configuration - displays activity/event timeline
+ *
+ * @example
+ * ```ts
+ * {
+ *   type: "timeline",
+ *   id: "recent-activity",
+ *   title: "Recent Activity",
+ *   fetchFn: async (client) => {
+ *     const activities = await client.collections.activities.findMany({
+ *       limit: 10,
+ *       orderBy: { createdAt: "desc" }
+ *     });
+ *     return activities.map(a => ({
+ *       id: a.id,
+ *       title: a.action,
+ *       description: a.description,
+ *       timestamp: a.createdAt,
+ *       variant: a.type === "error" ? "error" : "default"
+ *     }));
+ *   }
+ * }
+ * ```
+ */
+interface TimelineWidgetConfig extends BaseWidgetConfig {
+  type: "timeline";
+  /** Async function to fetch timeline items. Optional when hasFetchFn is true. */
+  fetchFn?: (client: any) => Promise<TimelineItem[]>;
+  /** Max items to show */
+  maxItems?: number;
+  /** Show timestamps */
+  showTimestamps?: boolean;
+  /** Timestamp format */
+  timestampFormat?: "relative" | "absolute" | "datetime";
+  /** Empty state message */
+  emptyMessage?: I18nText;
+}
+/**
+ * Progress widget configuration - displays progress towards a goal
+ *
+ * @example
+ * ```ts
+ * {
+ *   type: "progress",
+ *   id: "monthly-sales",
+ *   title: "Monthly Sales Goal",
+ *   fetchFn: async (client) => ({
+ *     current: 75000,
+ *     target: 100000,
+ *     label: "$75,000 / $100,000"
+ *   })
+ * }
+ * ```
+ */
+interface ProgressWidgetConfig extends BaseWidgetConfig {
+  type: "progress";
+  /** Async function to fetch progress data. Optional when hasFetchFn is true. */
+  fetchFn?: (client: any) => Promise<{
+    current: number;
+    target: number;
+    label?: string;
+    subtitle?: string;
+  }>;
+  /** Progress bar color */
+  color?: string;
+  /** Show percentage */
+  showPercentage?: boolean;
+}
+/**
+ * Widget configuration - discriminated union of all widget types
+ */
+type WidgetConfig = StatsWidgetConfig | ChartWidgetConfig | RecentItemsWidgetConfig | QuickActionsWidgetConfig | CustomWidgetConfig | ValueWidgetConfig | TableWidgetConfig | TimelineWidgetConfig | ProgressWidgetConfig;
+/**
+ * Generic widget configuration (for unknown/custom types registered at runtime)
+ * This is kept separate from WidgetConfig to allow proper type narrowing
+ */
+interface GenericWidgetConfig extends BaseWidgetConfig {
+  type: string;
+  component?: MaybeLazyComponent<WidgetComponentProps>;
+  actions?: WidgetAction[];
+  [key: string]: any;
+}
+/**
+ * Any widget config (union of known configs and generic)
+ */
+type AnyWidgetConfig = WidgetConfig | GenericWidgetConfig;
+/**
+ * Props passed to widget components
+ */
+interface WidgetComponentProps<TData = any> {
+  /**
+   * Widget configuration
+   */
+  config: WidgetConfig | Record<string, any>;
+  /**
+   * Widget data (from data source)
+   */
+  data?: TData;
+  /**
+   * Loading state
+   */
+  isLoading?: boolean;
+  /**
+   * Error state
+   */
+  error?: Error | null;
+  /**
+   * Refresh data
+   */
+  onRefresh?: () => void;
+  /**
+   * Column span for grid layout
+   */
+  span?: number;
+}
+/**
+ * Widget data source configuration
+ */
+interface WidgetDataSource {
+  /**
+   * Data source type
+   */
+  type: "collection" | "global" | "function" | "custom";
+  /**
+   * Collection name (for collection type)
+   */
+  collection?: string;
+  /**
+   * Global name (for global type)
+   */
+  global?: string;
+  /**
+   * Function name (for function type)
+   */
+  function?: string;
+  /**
+   * Query options
+   */
+  query?: Record<string, any>;
+  /**
+   * Custom data fetcher
+   */
+  fetcher?: () => Promise<any>;
+}
+/**
+ * Widget action configuration
+ */
+interface WidgetAction {
+  /**
+   * Action ID
+   */
+  id: string;
+  /**
+   * Action label
+   */
+  label: string;
+  /**
+   * Action icon
+   */
+  icon?: IconComponent | ComponentReference | string;
+  /**
+   * Action handler
+   */
+  onClick?: () => void;
+  /**
+   * Link target
+   */
+  href?: string;
+  /**
+   * Variant
+   */
+  variant?: "default" | "primary" | "secondary" | "destructive";
+}
+//#endregion
+export { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, DateFilterConfig, GenericWidgetConfig, ProgressWidgetConfig, QuickActionItem, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetColumn, TableWidgetColumnConfig, TableWidgetConfig, TimelineItem, TimelineWidgetConfig, ValueWidgetClassNames, ValueWidgetConfig, ValueWidgetResult, ValueWidgetTrend, WidgetAction, WidgetCardVariant, WidgetComponentProps, WidgetConfig, WidgetDataSource };
+//# sourceMappingURL=widget-types.d.mts.map

package/dist/client/builder/types/widget-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-types.d.mts","names":[],"sources":["../../../../src/client/builder/types/widget-types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/client/builder/validation.d.mts

@@ -0,0 +1,3 @@
+import { ZodBuildContext } from "./field/field.mjs";
+import "./proxies.mjs";
+import { z } from "zod";