@next-vibe/checker 1.0.11 → 1.0.12

package/src/app/api/[locale]/system/unified-interface/cli/widgets/core/registry.ts

@@ -0,0 +1,309 @@
+/**
+ * Widget Registry
+ * Central registry for CLI widget renderers using switch-based dispatch
+ * Matches React's WidgetRenderer pattern
+ */
+
+import type { UnifiedField } from "@/app/api/[locale]/system/unified-interface/shared/types/endpoint";
+import { WidgetType } from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
+import type {
+  WidgetData,
+  WidgetInput,
+} from "@/app/api/[locale]/system/unified-interface/shared/widgets/types";
+
+import { AccordionWidgetRenderer } from "../implementations/accordion";
+import { AvatarWidgetRenderer } from "../implementations/avatar";
+import { BadgeWidgetRenderer } from "../implementations/badge";
+import { CodeOutputWidgetRenderer } from "../implementations/code-output";
+import { CodeQualityFilesWidgetRenderer } from "../implementations/code-quality-files";
+import { CodeQualityListWidgetRenderer } from "../implementations/code-quality-list";
+import { CodeQualitySummaryWidgetRenderer } from "../implementations/code-quality-summary";
+import { ContainerWidgetRenderer } from "../implementations/container";
+import { DataCardWidgetRenderer } from "../implementations/data-card";
+import { DataCardsWidgetRenderer } from "../implementations/data-cards";
+import { DataListWidgetRenderer } from "../implementations/data-list";
+import { DataTableWidgetRenderer } from "../implementations/data-table";
+import { EditableTextWidgetRenderer } from "../implementations/editable-text";
+import { EmptyStateWidgetRenderer } from "../implementations/empty-state";
+import { ErrorWidgetRenderer } from "../implementations/errors";
+import { GroupedListWidgetRenderer } from "../implementations/grouped-list";
+import { LinkWidgetRenderer } from "../implementations/link";
+import { LinkCardWidgetRenderer } from "../implementations/link-card";
+import { LinkListWidgetRenderer } from "../implementations/link-list";
+import { LoadingWidgetRenderer } from "../implementations/loading";
+import { MarkdownWidgetRenderer } from "../implementations/markdown";
+import { MetricWidgetRenderer } from "../implementations/metric";
+import { SectionWidgetRenderer } from "../implementations/section";
+import { StatsGridWidgetRenderer } from "../implementations/stats-grid";
+import { TabsWidgetRenderer } from "../implementations/tabs";
+import { TextWidgetRenderer } from "../implementations/text";
+import { TitleWidgetRenderer } from "../implementations/title";
+import type {
+  AnyWidgetRenderer,
+  CLIWidgetProps,
+  WidgetRenderContext,
+} from "./types";
+
+// Singleton instances for each renderer
+const textRenderer = new TextWidgetRenderer();
+const titleRenderer = new TitleWidgetRenderer();
+const sectionRenderer = new SectionWidgetRenderer();
+const containerRenderer = new ContainerWidgetRenderer();
+const dataTableRenderer = new DataTableWidgetRenderer();
+const dataCardRenderer = new DataCardWidgetRenderer();
+const dataCardsRenderer = new DataCardsWidgetRenderer();
+const dataListRenderer = new DataListWidgetRenderer();
+const groupedListRenderer = new GroupedListWidgetRenderer();
+const codeQualityListRenderer = new CodeQualityListWidgetRenderer();
+const codeQualitySummaryRenderer = new CodeQualitySummaryWidgetRenderer();
+const codeQualityFilesRenderer = new CodeQualityFilesWidgetRenderer();
+const codeOutputRenderer = new CodeOutputWidgetRenderer();
+const metricRenderer = new MetricWidgetRenderer();
+const statsGridRenderer = new StatsGridWidgetRenderer();
+const linkRenderer = new LinkWidgetRenderer();
+const linkCardRenderer = new LinkCardWidgetRenderer();
+const linkListRenderer = new LinkListWidgetRenderer();
+const markdownRenderer = new MarkdownWidgetRenderer();
+const editableTextRenderer = new EditableTextWidgetRenderer();
+const badgeRenderer = new BadgeWidgetRenderer();
+const avatarRenderer = new AvatarWidgetRenderer();
+const emptyStateRenderer = new EmptyStateWidgetRenderer();
+const errorRenderer = new ErrorWidgetRenderer();
+const loadingRenderer = new LoadingWidgetRenderer();
+const tabsRenderer = new TabsWidgetRenderer();
+const accordionRenderer = new AccordionWidgetRenderer();
+
+/**
+ * Render a widget using switch-based dispatch
+ * Matches React's renderWidget pattern
+ */
+function renderWidget<const TKey extends string>(
+  widgetType: WidgetType,
+  baseProps: {
+    field: UnifiedField<TKey>;
+    value: WidgetData;
+    context: WidgetRenderContext;
+  },
+): string {
+  switch (widgetType) {
+    case WidgetType.TEXT:
+      return textRenderer.render({ ...baseProps, widgetType } as CLIWidgetProps<
+        typeof WidgetType.TEXT,
+        TKey
+      >);
+
+    case WidgetType.TITLE:
+      return titleRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.TITLE, TKey>);
+
+    case WidgetType.SECTION:
+      return sectionRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.SECTION, TKey>);
+
+    case WidgetType.CONTAINER:
+      return containerRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.CONTAINER, TKey>);
+
+    case WidgetType.DATA_TABLE:
+      return dataTableRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.DATA_TABLE, TKey>);
+
+    case WidgetType.DATA_CARD:
+      return dataCardRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.DATA_CARD, TKey>);
+
+    case WidgetType.DATA_CARDS:
+      return dataCardsRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.DATA_CARDS, TKey>);
+
+    case WidgetType.DATA_LIST:
+      return dataListRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.DATA_LIST, TKey>);
+
+    case WidgetType.GROUPED_LIST:
+      return groupedListRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.GROUPED_LIST, TKey>);
+
+    case WidgetType.CODE_QUALITY_LIST:
+      return codeQualityListRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.CODE_QUALITY_LIST, TKey>);
+
+    case WidgetType.CODE_QUALITY_SUMMARY:
+      return codeQualitySummaryRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.CODE_QUALITY_SUMMARY, TKey>);
+
+    case WidgetType.CODE_QUALITY_FILES:
+      return codeQualityFilesRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.CODE_QUALITY_FILES, TKey>);
+
+    case WidgetType.CODE_OUTPUT:
+      return codeOutputRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.CODE_OUTPUT, TKey>);
+
+    case WidgetType.METRIC_CARD:
+      return metricRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.METRIC_CARD, TKey>);
+
+    case WidgetType.STATS_GRID:
+      return statsGridRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.STATS_GRID, TKey>);
+
+    case WidgetType.LINK:
+      return linkRenderer.render({ ...baseProps, widgetType } as CLIWidgetProps<
+        typeof WidgetType.LINK,
+        TKey
+      >);
+
+    case WidgetType.LINK_CARD:
+      return linkCardRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.LINK_CARD, TKey>);
+
+    case WidgetType.LINK_LIST:
+      return linkListRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.LINK_LIST, TKey>);
+
+    case WidgetType.MARKDOWN:
+      return markdownRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.MARKDOWN, TKey>);
+
+    case WidgetType.MARKDOWN_EDITOR:
+      return editableTextRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.MARKDOWN_EDITOR, TKey>);
+
+    case WidgetType.BADGE:
+      return badgeRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.BADGE, TKey>);
+
+    case WidgetType.AVATAR:
+      return avatarRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.AVATAR, TKey>);
+
+    case WidgetType.EMPTY_STATE:
+      return emptyStateRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.EMPTY_STATE, TKey>);
+
+    case WidgetType.ERROR:
+      return errorRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.ERROR, TKey>);
+
+    case WidgetType.LOADING:
+      return loadingRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.LOADING, TKey>);
+
+    case WidgetType.TABS:
+      return tabsRenderer.render({ ...baseProps, widgetType } as CLIWidgetProps<
+        typeof WidgetType.TABS,
+        TKey
+      >);
+
+    case WidgetType.ACCORDION:
+      return accordionRenderer.render({
+        ...baseProps,
+        widgetType,
+      } as CLIWidgetProps<typeof WidgetType.ACCORDION, TKey>);
+
+    // Fallback to text widget
+    default:
+      return textRenderer.render({
+        ...baseProps,
+        widgetType: WidgetType.TEXT,
+      } as CLIWidgetProps<typeof WidgetType.TEXT, TKey>);
+  }
+}
+
+/**
+ * Widget Registry class for compatibility with existing code
+ */
+export class WidgetRegistry {
+  /**
+   * Render a field using the appropriate widget renderer
+   */
+  render<const TKey extends string>(
+    input: WidgetInput<TKey>,
+    context: WidgetRenderContext,
+  ): string {
+    return renderWidget(input.field.ui.type, {
+      field: input.field,
+      value: input.value,
+      context,
+    });
+  }
+
+  /**
+   * Render a widget with proper type dispatch
+   */
+  renderWidget<const TKey extends string>(
+    widgetType: WidgetType,
+    field: UnifiedField<TKey>,
+    value: WidgetData,
+    context: WidgetRenderContext,
+  ): string {
+    return renderWidget(widgetType, { field, value, context });
+  }
+
+  /**
+   * Get renderer for a widget type (for compatibility)
+   */
+  getRenderer(widgetType: WidgetType): AnyWidgetRenderer {
+    return {
+      widgetType,
+      render: (props) =>
+        renderWidget(widgetType, {
+          field: props.field,
+          value: props.value,
+          context: props.context,
+        }),
+    };
+  }
+}
+
+/**
+ * Default widget registry instance
+ */
+export const defaultWidgetRegistry = new WidgetRegistry();

package/src/app/api/[locale]/system/unified-interface/cli/widgets/core/types.ts

@@ -0,0 +1,126 @@
+/**
+ * Widget Types and Interfaces
+ * CLI-specific widget rendering types
+ *
+ * Extends shared types from ../../../shared/widgets/types.ts
+ * Types flow from widget configs in ../../../shared/widgets/configs.ts
+ */
+
+import type {
+  FieldDataType,
+  WidgetType,
+} from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
+import type { CountryLanguage } from "@/i18n/core/config";
+import type { TFunction } from "@/i18n/core/static-types";
+
+import type { UnifiedField } from "../../../shared/types/endpoint";
+import type {
+  BaseWidgetProps,
+  WidgetData,
+  WidgetRenderContext as SharedWidgetRenderContext,
+} from "../../../shared/widgets/types";
+
+/**
+ * CLI rendering options
+ */
+export interface CLIRenderingOptions {
+  useColors: boolean;
+  useEmojis: boolean;
+  maxWidth: number;
+  indentSize: number;
+  locale: CountryLanguage;
+}
+
+/**
+ * CLI-specific widget render context.
+ * Extends the shared context with CLI-specific utilities.
+ */
+export interface CLIWidgetRenderContext extends SharedWidgetRenderContext {
+  options: CLIRenderingOptions;
+  depth: number;
+  t: TFunction;
+  formatValue: <const TKey extends string>(
+    field: UnifiedField<TKey>,
+    value: WidgetData,
+  ) => string;
+  getFieldIcon: (type: FieldDataType) => string;
+  renderEmptyState: (message: string) => string;
+  getRenderer: (widgetType: WidgetType) => AnyWidgetRenderer;
+  /**
+   * Render a widget with proper type dispatch.
+   * Use this instead of getRenderer().render() to avoid union type issues.
+   */
+  renderWidget: <const TKey extends string>(
+    widgetType: WidgetType,
+    field: UnifiedField<TKey>,
+    value: WidgetData,
+  ) => string;
+}
+
+// Alias for backwards compatibility
+export type WidgetRenderContext = CLIWidgetRenderContext;
+
+/**
+ * CLI-specific widget props. Extends base props with CLI context.
+ * Uses the same pattern as ReactWidgetProps for type safety.
+ */
+export interface CLIWidgetProps<
+  T extends WidgetType,
+  TKey extends string = string,
+> extends BaseWidgetProps<TKey, T> {
+  context: CLIWidgetRenderContext;
+}
+
+/**
+ * Widget renderer interface.
+ * Each renderer handles a specific widget type.
+ * TWidget is the specific widget type this renderer handles.
+ */
+export interface WidgetRenderer<TWidget extends WidgetType = WidgetType> {
+  readonly widgetType: TWidget;
+  render(props: CLIWidgetProps<TWidget, string>): string;
+}
+
+/**
+ * Widget renderer type for registry storage.
+ * Uses `any` for widget type like React's WidgetComponent pattern.
+ * Each implementation still has strict types.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type AnyWidgetRenderer = WidgetRenderer<any>;
+
+/**
+ * Maps each WidgetType to CLI-specific props.
+ */
+export type CLIWidgetPropsMap<TKey extends string> = {
+  [T in WidgetType]: CLIWidgetProps<T, TKey>;
+};
+
+/**
+ * Union of all CLI widget props - TypeScript narrows this in switch statements.
+ */
+export type CLIWidgetPropsUnion<TKey extends string> =
+  CLIWidgetPropsMap<TKey>[WidgetType];
+
+/**
+ * Data formatting utilities for CLI output
+ */
+export interface DataFormatter {
+  formatText(value: string, options?: { maxLength?: number }): string;
+  formatNumber(
+    value: number,
+    locale: CountryLanguage,
+    options?: { precision?: number; unit?: string },
+  ): string;
+  formatBoolean(value: boolean): string;
+  formatDate(value: Date | string, locale: CountryLanguage): string;
+  formatArray(
+    value: WidgetData[],
+    options?: { separator?: string; maxItems?: number },
+  ): string;
+  formatObject(
+    value: Record<string, WidgetData>,
+    options?: { maxDepth?: number },
+  ): string;
+  formatDuration(milliseconds: number): string;
+}

package/src/app/api/[locale]/system/unified-interface/cli/widgets/i18n/de/index.ts

@@ -0,0 +1,67 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  post: {
+    title: "Titel",
+    description: "Endpunkt-Beschreibung",
+    form: {
+      title: "Konfiguration",
+      description: "Parameter konfigurieren",
+    },
+    response: {
+      title: "Antwort",
+      description: "Antwortdaten",
+    },
+    errors: {
+      unauthorized: {
+        title: "Nicht autorisiert",
+        description: "Authentifizierung erforderlich",
+      },
+      validation: {
+        title: "Validierungsfehler",
+        description: "Ungültige Anfrageparameter",
+      },
+      server: {
+        title: "Serverfehler",
+        description: "Interner Serverfehler",
+      },
+      unknown: {
+        title: "Unbekannter Fehler",
+        description: "Ein unbekannter Fehler ist aufgetreten",
+      },
+      network: {
+        title: "Netzwerkfehler",
+        description: "Netzwerkfehler aufgetreten",
+      },
+      forbidden: {
+        title: "Verboten",
+        description: "Zugriff verboten",
+      },
+      notFound: {
+        title: "Nicht gefunden",
+        description: "Ressource nicht gefunden",
+      },
+      conflict: {
+        title: "Konflikt",
+        description: "Datenkonflikt aufgetreten",
+      },
+    },
+    success: {
+      title: "Erfolg",
+      description: "Vorgang erfolgreich abgeschlossen",
+    },
+  },
+  helpHandler: {
+    noDescription: "Keine Beschreibung",
+    flagDataDesc: "JSON-Daten-Payload für die Anfrage",
+    flagUserTypeDesc: "Benutzertyp (ADMIN, CUSTOMER, PUBLIC)",
+    flagLocaleDesc: "Gebietsschema für die Anfrage",
+    flagOutputDesc: "Ausgabeformat (json, pretty)",
+    flagVerboseDesc: "Ausführliche Ausgabe anzeigen",
+    flagDryRunDesc: "Anzeigen, was ausgeführt würde, ohne zu laufen",
+    usageLabel: "Verwendung",
+    availableCommandsLabel: "Verfügbare Befehle",
+    globalOptionsLabel: "Globale Optionen",
+    examplesLabel: "Beispiele",
+  },
+};

package/src/app/api/[locale]/system/unified-interface/cli/widgets/i18n/en/index.ts

@@ -0,0 +1,65 @@
+export const translations = {
+  post: {
+    title: "Cli Ui",
+    description: "Cli Ui endpoint",
+    form: {
+      title: "Cli Ui Configuration",
+      description: "Configure cli ui parameters",
+    },
+    response: {
+      title: "Response",
+      description: "Cli Ui response data",
+    },
+    errors: {
+      unauthorized: {
+        title: "Unauthorized",
+        description: "Authentication required",
+      },
+      validation: {
+        title: "Validation Error",
+        description: "Invalid request parameters",
+      },
+      server: {
+        title: "Server Error",
+        description: "Internal server error occurred",
+      },
+      unknown: {
+        title: "Unknown Error",
+        description: "An unknown error occurred",
+      },
+      network: {
+        title: "Network Error",
+        description: "Network error occurred",
+      },
+      forbidden: {
+        title: "Forbidden",
+        description: "Access forbidden",
+      },
+      notFound: {
+        title: "Not Found",
+        description: "Resource not found",
+      },
+      conflict: {
+        title: "Conflict",
+        description: "Data conflict occurred",
+      },
+    },
+    success: {
+      title: "Success",
+      description: "Operation completed successfully",
+    },
+  },
+  helpHandler: {
+    noDescription: "No description",
+    flagDataDesc: "JSON data payload for the request",
+    flagUserTypeDesc: "User type (ADMIN, CUSTOMER, PUBLIC)",
+    flagLocaleDesc: "Locale for the request",
+    flagOutputDesc: "Output format (json, pretty)",
+    flagVerboseDesc: "Show verbose output",
+    flagDryRunDesc: "Show what would be executed without running",
+    usageLabel: "Usage",
+    availableCommandsLabel: "Available Commands",
+    globalOptionsLabel: "Global Options",
+    examplesLabel: "Examples",
+  },
+};

package/src/app/api/[locale]/system/unified-interface/cli/widgets/i18n/pl/index.ts

@@ -0,0 +1,67 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  post: {
+    title: "Tytuł",
+    description: "Opis endpointu",
+    form: {
+      title: "Konfiguracja",
+      description: "Skonfiguruj parametry",
+    },
+    response: {
+      title: "Odpowiedź",
+      description: "Dane odpowiedzi",
+    },
+    errors: {
+      unauthorized: {
+        title: "Brak autoryzacji",
+        description: "Wymagana autoryzacja",
+      },
+      validation: {
+        title: "Błąd walidacji",
+        description: "Nieprawidłowe parametry żądania",
+      },
+      server: {
+        title: "Błąd serwera",
+        description: "Wystąpił wewnętrzny błąd serwera",
+      },
+      unknown: {
+        title: "Nieznany błąd",
+        description: "Wystąpił nieznany błąd",
+      },
+      network: {
+        title: "Błąd sieci",
+        description: "Wystąpił błąd sieci",
+      },
+      forbidden: {
+        title: "Zabronione",
+        description: "Dostęp zabroniony",
+      },
+      notFound: {
+        title: "Nie znaleziono",
+        description: "Zasób nie został znaleziony",
+      },
+      conflict: {
+        title: "Konflikt",
+        description: "Wystąpił konflikt danych",
+      },
+    },
+    success: {
+      title: "Sukces",
+      description: "Operacja zakończona pomyślnie",
+    },
+  },
+  helpHandler: {
+    noDescription: "Brak opisu",
+    flagDataDesc: "Dane JSON dla żądania",
+    flagUserTypeDesc: "Typ użytkownika (ADMIN, CUSTOMER, PUBLIC)",
+    flagLocaleDesc: "Ustawienia regionalne dla żądania",
+    flagOutputDesc: "Format wyjściowy (json, pretty)",
+    flagVerboseDesc: "Pokaż szczegółowe dane wyjściowe",
+    flagDryRunDesc: "Pokaż, co zostałoby wykonane bez uruchamiania",
+    usageLabel: "Użycie",
+    availableCommandsLabel: "Dostępne polecenia",
+    globalOptionsLabel: "Opcje globalne",
+    examplesLabel: "Przykłady",
+  },
+};