@next-vibe/checker 1.0.11 → 1.0.13

package/src/app/api/[locale]/system/unified-interface/shared/widgets/logic/errors.ts

@@ -0,0 +1,93 @@
+/**
+ * Error Widget Logic
+ * Shared data extraction and processing for ERROR widget
+ * Used by both React and CLI implementations
+ */
+
+import type { WidgetData } from "../types";
+
+/**
+ * Processed error data structure
+ */
+export interface ProcessedError {
+  title: string;
+  message?: string;
+  code?: string;
+  stack?: string;
+  action?: {
+    label: string;
+    action: string;
+  };
+}
+
+/**
+ * Extract and validate error data from WidgetData
+ */
+export function extractErrorData(value: WidgetData): ProcessedError | null {
+  // Handle string value directly (simple error message)
+  if (typeof value === "string") {
+    return {
+      title: "Error",
+      message: value,
+    };
+  }
+
+  // Handle Error object
+  if (value instanceof Error) {
+    return {
+      title: value.name || "Error",
+      message: value.message,
+      stack: value.stack,
+    };
+  }
+
+  // Handle object value with error properties
+  if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+    const title =
+      "title" in value && typeof value.title === "string"
+        ? value.title
+        : "Error";
+    const message =
+      "message" in value && typeof value.message === "string"
+        ? value.message
+        : undefined;
+    const code =
+      "code" in value && typeof value.code === "string"
+        ? value.code
+        : undefined;
+    const stack =
+      "stack" in value && typeof value.stack === "string"
+        ? value.stack
+        : undefined;
+    const action =
+      "action" in value &&
+      typeof value.action === "object" &&
+      value.action !== null
+        ? {
+            label:
+              "label" in value.action && typeof value.action.label === "string"
+                ? value.action.label
+                : "Retry",
+            action:
+              "action" in value.action &&
+              typeof value.action.action === "string"
+                ? value.action.action
+                : "",
+          }
+        : undefined;
+
+    return {
+      title,
+      message,
+      code,
+      stack,
+      action,
+    };
+  }
+
+  // Default error
+  return {
+    title: "Error",
+    message: "An unknown error occurred",
+  };
+}

package/src/app/api/[locale]/system/unified-interface/shared/widgets/logic/grouped-list.ts

@@ -0,0 +1,448 @@
+/**
+ * Grouped List Widget Logic
+ * Shared data extraction and processing for GROUPED_LIST widget
+ * Used by both React and CLI implementations
+ */
+
+import type { WidgetData } from "../types";
+
+/**
+ * Individual item in a grouped list
+ */
+export interface GroupedListItem {
+  [key: string]: WidgetData;
+  line?: number;
+  column?: number;
+  severity?: string;
+  message?: string;
+  rule?: string;
+  file?: string;
+}
+
+/**
+ * Stat configuration for summary
+ */
+export interface StatConfig {
+  field: string;
+  value: string;
+  label?: string;
+  icon?: string;
+  color?: string;
+}
+
+/**
+ * Grouped list configuration
+ */
+export interface GroupedListConfig {
+  groupBy: string;
+  sortBy: string;
+  showGroupSummary: boolean;
+  maxItemsPerGroup: number;
+  summaryTitle?: string;
+  summaryStats?: StatConfig[];
+  renderMode?: "code-quality" | "simple";
+  hierarchical?: boolean;
+}
+
+/**
+ * Tree node for hierarchical rendering
+ */
+export interface TreeNode {
+  name: string;
+  fullPath: string;
+  items: GroupedListItem[];
+  children: Map<string, TreeNode>;
+}
+
+/**
+ * Processed grouped list data structure
+ */
+export interface ProcessedGroupedList {
+  groups: Array<{
+    key: string;
+    label: string;
+    items: GroupedListItem[];
+    summary?: Record<string, WidgetData>;
+  }>;
+  maxItemsPerGroup?: number;
+  showGroupSummary: boolean;
+}
+
+/**
+ * Get grouped list configuration from field
+ */
+export function getGroupedListConfig(): GroupedListConfig {
+  return {
+    groupBy: "file",
+    sortBy: "severity",
+    showGroupSummary: true,
+    maxItemsPerGroup: 50,
+  };
+}
+
+/**
+ * Group list data by specified field with sorting
+ */
+export function groupListData(
+  data: GroupedListItem[],
+  groupBy: string,
+): Map<string, GroupedListItem[]> {
+  const groups = new Map<string, GroupedListItem[]>();
+
+  for (const item of data) {
+    const groupValue = item[groupBy];
+    let groupKey = "unknown";
+    if (typeof groupValue === "string") {
+      groupKey = groupValue;
+    } else if (typeof groupValue === "number") {
+      groupKey = String(groupValue);
+    } else if (typeof groupValue === "boolean") {
+      groupKey = groupValue ? "true" : "false";
+    } else if (groupValue !== null && groupValue !== undefined) {
+      groupKey = "unknown";
+    }
+    if (!groups.has(groupKey)) {
+      groups.set(groupKey, []);
+    }
+    groups.get(groupKey)!.push(item);
+  }
+
+  // Sort groups by key alphabetically
+  return new Map(
+    [...groups.entries()].toSorted((a, b) => a[0].localeCompare(b[0])),
+  );
+}
+
+/**
+ * Sort grouped items by specified field
+ */
+export function sortGroupedItems(
+  items: GroupedListItem[],
+  sortBy: string,
+): GroupedListItem[] {
+  return items.toSorted((a, b) => {
+    if (sortBy === "severity") {
+      const severityOrder = { error: 0, warning: 1, info: 2 };
+      const aOrder =
+        severityOrder[a.severity as keyof typeof severityOrder] ?? 3;
+      const bOrder =
+        severityOrder[b.severity as keyof typeof severityOrder] ?? 3;
+      if (aOrder !== bOrder) {
+        return aOrder - bOrder;
+      }
+    }
+
+    // Secondary sort by line number
+    if (typeof a.line === "number" && typeof b.line === "number") {
+      return a.line - b.line;
+    }
+
+    return 0;
+  });
+}
+
+/**
+ * Build hierarchical tree structure from flat data
+ */
+export function buildHierarchicalTree(
+  data: GroupedListItem[],
+  groupBy: string,
+): TreeNode {
+  const root: TreeNode = {
+    name: "",
+    fullPath: "",
+    items: [],
+    children: new Map(),
+  };
+
+  // Group items by category path
+  for (const item of data) {
+    const categoryPath = item[groupBy];
+    if (typeof categoryPath !== "string") {
+      continue;
+    }
+
+    const parts = categoryPath.split("/").filter((p) => p.length);
+    let currentNode = root;
+
+    // Build/traverse tree
+    for (let i = 0; i < parts.length; i++) {
+      const part = parts[i];
+      const fullPath = parts.slice(0, i + 1).join("/");
+
+      if (!currentNode.children.has(part)) {
+        currentNode.children.set(part, {
+          name: part,
+          fullPath,
+          items: [],
+          children: new Map(),
+        });
+      }
+      currentNode = currentNode.children.get(part)!;
+    }
+
+    // Add item to leaf node
+    currentNode.items.push(item);
+  }
+
+  return root;
+}
+
+/**
+ * Count items recursively including all children
+ */
+export function countItemsRecursive(node: TreeNode): number {
+  let count = node.items.length;
+  for (const childEntry of node.children) {
+    const child = childEntry[1];
+    count += countItemsRecursive(child);
+  }
+  return count;
+}
+
+/**
+ * Calculate stat count for a specific field/value combination
+ */
+export function calculateStatCount(
+  data: GroupedListItem[],
+  stat: StatConfig,
+): number {
+  if (!stat.field || !stat.value) {
+    return 0;
+  }
+
+  return data.filter((item) => {
+    const fieldValue = item[stat.field];
+    return fieldValue === stat.value;
+  }).length;
+}
+
+/**
+ * Extract and validate grouped list data from WidgetData
+ */
+export function extractGroupedListData(
+  value: WidgetData,
+  config?: { groupBy?: string; sortBy?: string },
+): ProcessedGroupedList | null {
+  // Handle direct array input
+  if (Array.isArray(value)) {
+    const items = value as GroupedListItem[];
+    if (items.length === 0) {
+      return null;
+    }
+
+    // Use groupBy from config, fallback to "status", or create single group
+    const groupByField = config?.groupBy ?? "status";
+    if (groupByField in items[0]) {
+      const grouped = groupListData(items, groupByField);
+      let autoGroups = [...grouped.entries()].map(([key, groupItems]) => ({
+        key,
+        label: key,
+        items: groupItems,
+      }));
+
+      // Apply sorting if sortBy is specified
+      const sortBy = config?.sortBy;
+      if (sortBy) {
+        autoGroups = autoGroups.map((group) => ({
+          ...group,
+          items: sortGroupedItems(group.items, sortBy),
+        }));
+      }
+
+      return {
+        groups: autoGroups,
+        maxItemsPerGroup: undefined,
+        showGroupSummary: false,
+      };
+    }
+    // Single group with all items
+    let allItems = items;
+    if (config?.sortBy) {
+      allItems = sortGroupedItems(items, config.sortBy);
+    }
+
+    return {
+      groups: [
+        {
+          key: "all",
+          label: "All Items",
+          items: allItems,
+        },
+      ],
+      maxItemsPerGroup: undefined,
+      showGroupSummary: false,
+    };
+  }
+
+  // Narrow to object type
+  const isObject =
+    typeof value === "object" && value !== null && !Array.isArray(value);
+
+  if (!isObject) {
+    return null;
+  }
+
+  // Extract properties with explicit checks
+  const groups =
+    "groups" in value && Array.isArray(value.groups) ? value.groups : [];
+  const maxItemsPerGroup =
+    "maxItemsPerGroup" in value && typeof value.maxItemsPerGroup === "number"
+      ? value.maxItemsPerGroup
+      : undefined;
+  const showGroupSummary =
+    "showGroupSummary" in value && typeof value.showGroupSummary === "boolean"
+      ? value.showGroupSummary
+      : false;
+
+  // If no groups found, try to find an array property to auto-group
+  if (!groups || groups.length === 0) {
+    // Look for array properties in the value object (direct or nested)
+    let arrayKeys = Object.keys(value).filter((key) =>
+      Array.isArray(value[key]),
+    );
+
+    // If no direct arrays found, check nested objects (common pattern: { response: { items: [...] } })
+    if (arrayKeys.length === 0) {
+      for (const key of Object.keys(value)) {
+        const nestedValue = value[key];
+        if (
+          typeof nestedValue === "object" &&
+          nestedValue !== null &&
+          !Array.isArray(nestedValue)
+        ) {
+          const nestedArrayKeys = Object.keys(nestedValue).filter((nestedKey) =>
+            Array.isArray(nestedValue[nestedKey]),
+          );
+          if (nestedArrayKeys.length > 0) {
+            // Found nested array, use the nested object as the value
+            return extractGroupedListData(nestedValue, config);
+          }
+        }
+      }
+    }
+
+    if (arrayKeys.length > 0) {
+      // Use the first array found (commonly: leads, items, results, etc.)
+      const arrayKey = arrayKeys[0];
+      const items = value[arrayKey] as GroupedListItem[];
+
+      if (items.length > 0) {
+        // Use groupBy from config, fallback to "status", or create single group
+        const groupByField = config?.groupBy || "status";
+        if (groupByField in items[0]) {
+          const grouped = groupListData(items, groupByField);
+          let autoGroups = [...grouped.entries()].map(([key, groupItems]) => ({
+            key,
+            label: key,
+            items: groupItems,
+          }));
+
+          // Apply sorting if sortBy is specified
+          const sortBy = config?.sortBy;
+          if (sortBy) {
+            autoGroups = autoGroups.map((group) => ({
+              ...group,
+              items: sortGroupedItems(group.items, sortBy),
+            }));
+          }
+
+          return {
+            groups: autoGroups,
+            maxItemsPerGroup,
+            showGroupSummary: false,
+          };
+        }
+        // Single group with all items
+        let allItems = items;
+        if (config?.sortBy) {
+          allItems = sortGroupedItems(items, config.sortBy);
+        }
+
+        return {
+          groups: [
+            {
+              key: "all",
+              label: "All Items",
+              items: allItems,
+            },
+          ],
+          maxItemsPerGroup,
+          showGroupSummary: false,
+        };
+      }
+    }
+
+    return null;
+  }
+
+  // Process and validate groups
+  const processedGroups = groups
+    .map((group: WidgetData) => {
+      if (typeof group !== "object" || group === null) {
+        return null;
+      }
+
+      const groupKey = "key" in group ? String(group.key) : "";
+      const groupLabel = "label" in group ? String(group.label) : "";
+      const groupItems =
+        "items" in group && Array.isArray(group.items) ? group.items : [];
+      const groupSummary =
+        "summary" in group &&
+        typeof group.summary === "object" &&
+        group.summary !== null
+          ? (group.summary as Record<string, WidgetData>)
+          : undefined;
+
+      // Filter items to only valid objects
+      const validItems = groupItems.filter(
+        (item): item is GroupedListItem =>
+          typeof item === "object" && item !== null && !Array.isArray(item),
+      );
+
+      return {
+        key: groupKey,
+        label: groupLabel,
+        items: validItems,
+        summary: groupSummary,
+      };
+    })
+    .filter((group): group is NonNullable<typeof group> => group !== null);
+
+  if (processedGroups.length === 0) {
+    return null;
+  }
+
+  return {
+    groups: processedGroups,
+    maxItemsPerGroup,
+    showGroupSummary,
+  };
+}
+
+/**
+ * Get items to display based on maxItemsPerGroup
+ */
+export function getDisplayItems(
+  items: GroupedListItem[],
+  maxItems: number | undefined,
+  isExpanded: boolean,
+): GroupedListItem[] {
+  if (!maxItems || isExpanded) {
+    return items;
+  }
+  return items.slice(0, maxItems);
+}
+
+/**
+ * Calculate remaining items count
+ */
+export function getRemainingItemsCount(
+  totalItems: number,
+  maxItems: number | undefined,
+): number {
+  if (!maxItems || totalItems <= maxItems) {
+    return 0;
+  }
+  return totalItems - maxItems;
+}

package/src/app/api/[locale]/system/unified-interface/shared/widgets/logic/index.ts

@@ -0,0 +1,38 @@
+/**
+ * Widget Logic Index
+ * Central export for all widget data extraction and processing logic
+ * Used by both React and CLI widget implementations
+ */
+
+export * from "./accordion";
+export * from "./avatar";
+export * from "./badge";
+export * from "./code-output";
+export {
+  type CodeQualityItem,
+  countCodeQualityBySeverity,
+  extractCodeQualityListData,
+  groupCodeQualityItems,
+  type ProcessedCodeQualityList,
+  sortBySeverity,
+} from "./code-quality-list";
+export * from "./container";
+export * from "./data-card";
+export * from "./data-cards";
+export * from "./data-list";
+export * from "./data-table";
+export * from "./editable-text";
+export * from "./empty-state";
+export * from "./errors";
+export * from "./grouped-list";
+export * from "./link";
+export * from "./link-card";
+export * from "./link-list";
+export * from "./loading";
+export * from "./markdown";
+export * from "./metric-card";
+export * from "./section";
+export * from "./stats-grid";
+export * from "./tabs";
+export * from "./text";
+export * from "./title";

package/src/app/api/[locale]/system/unified-interface/shared/widgets/logic/link-card.ts

@@ -0,0 +1,130 @@
+/**
+ * Link Card Widget Logic
+ * Shared data extraction and processing for LINK_CARD widget
+ * Used by both React and CLI implementations
+ */
+
+import type { WidgetData } from "../types";
+
+/**
+ * Processed link card data structure
+ */
+export interface ProcessedLinkCard {
+  url: string;
+  title: string;
+  description?: string;
+  icon?: string;
+  favicon?: string;
+  metadata?: Record<string, string>;
+  snippet?: string;
+  age?: string;
+  source?: string;
+  thumbnail?: string;
+  openInNewTab?: boolean;
+}
+
+/**
+ * Extract and validate link card data from WidgetData
+ */
+export function extractLinkCardData(
+  value: WidgetData,
+): ProcessedLinkCard | null {
+  // Narrow to object type first
+  const isObject =
+    typeof value === "object" && value !== null && !Array.isArray(value);
+
+  if (!isObject) {
+    return null;
+  }
+
+  // Extract required url
+  const url = "url" in value && typeof value.url === "string" ? value.url : "";
+  if (!url) {
+    return null;
+  }
+
+  // Extract optional properties
+  const title =
+    "title" in value && typeof value.title === "string" ? value.title : url;
+  const description =
+    "description" in value && typeof value.description === "string"
+      ? value.description
+      : undefined;
+  const icon =
+    "icon" in value && typeof value.icon === "string" ? value.icon : undefined;
+  const favicon =
+    "favicon" in value && typeof value.favicon === "string"
+      ? value.favicon
+      : undefined;
+
+  // Extract metadata if present
+  let metadata: Record<string, string> | undefined;
+  if (
+    "metadata" in value &&
+    typeof value.metadata === "object" &&
+    value.metadata !== null &&
+    !Array.isArray(value.metadata)
+  ) {
+    metadata = {};
+    for (const [key, val] of Object.entries(value.metadata)) {
+      if (typeof val === "string") {
+        metadata[key] = val;
+      }
+    }
+  }
+
+  // Extract additional optional properties
+  const snippet =
+    "snippet" in value && typeof value.snippet === "string"
+      ? value.snippet
+      : undefined;
+  const age =
+    "age" in value && typeof value.age === "string" ? value.age : undefined;
+  const source =
+    "source" in value && typeof value.source === "string"
+      ? value.source
+      : undefined;
+  const thumbnail =
+    "thumbnail" in value && typeof value.thumbnail === "string"
+      ? value.thumbnail
+      : undefined;
+  const openInNewTab =
+    "openInNewTab" in value && typeof value.openInNewTab === "boolean"
+      ? value.openInNewTab
+      : true;
+
+  return {
+    url,
+    title,
+    description,
+    icon,
+    favicon,
+    metadata,
+    snippet,
+    age,
+    source,
+    thumbnail,
+    openInNewTab,
+  };
+}
+
+/**
+ * Get display URL (shortened for UI)
+ */
+export function getDisplayUrl(url: string, maxLength = 50): string {
+  try {
+    const urlObj = new URL(url);
+    const domain = urlObj.hostname.replace(/^www\./, "");
+    if (domain.length > maxLength) {
+      // oxlint-disable-next-line prefer-template
+      return domain.slice(0, maxLength - 3) + "...";
+    }
+    return domain;
+  } catch {
+    if (url.length > maxLength) {
+      // oxlint-disable-next-line prefer-template
+      return url.slice(0, maxLength - 3) + "...";
+    }
+    return url;
+  }
+}