@pgcorp/ui-kit 0.1.0

package/src/components/shared/persona/presentation.ts

@@ -0,0 +1,371 @@
+import { validateExactString } from '../../../internal/runtimeContract'
+
+export type PersonaStatusSeverity = 'secondary' | 'success' | 'info' | 'warn' | 'danger'
+
+export type PersonaParameterPresentation = {
+  name: string
+  type?: string | null
+  required?: boolean
+  default?: unknown
+}
+
+export type PersonaDiagnosticPresentationInput = {
+  context?: string | null
+  reason?: string | null
+  severity: string
+}
+
+export type PersonaDiagnosticPresentation = {
+  category: 'scenario_import' | 'component_analysis' | 'support_quality' | 'unclassified'
+  title: string
+  ownerLabel: string
+  impactLabel: string
+  remediation: string
+  statusLabel: string
+  statusSeverity: PersonaStatusSeverity
+}
+
+type PersonaDiagnosticOverviewItem = {
+  category: PersonaDiagnosticPresentation['category']
+}
+
+export function personaDiagnosticPresentation(
+  input: PersonaDiagnosticPresentationInput,
+): PersonaDiagnosticPresentation {
+  const isError = input.severity === 'error' || input.severity === 'blocking'
+  const statusLabel = isError ? 'ошибка' : input.severity === 'warning' ? 'предупреждение' : 'информация'
+  const statusSeverity: PersonaStatusSeverity = isError ? 'danger' : input.severity === 'warning' ? 'warn' : 'info'
+
+  if (input.context === 'native_scenarios') {
+    return {
+      category: 'scenario_import',
+      title: 'Сценарий не импортирован',
+      ownerLabel: 'Исправить в тестовом проекте',
+      impactLabel: 'Сценарий недоступен для запуска',
+      remediation: 'Восстановить отсутствующий модуль или исправить импорт в сценарии.',
+      statusLabel,
+      statusSeverity,
+    }
+  }
+  if (input.context === 'components') {
+    return {
+      category: 'component_analysis',
+      title: 'Компонент не проанализирован',
+      ownerLabel: 'Исправить в тестовом проекте',
+      impactLabel: 'Структура связанных сценариев может быть неполной',
+      remediation: 'Исправить импорт компонента и его зависимостей.',
+      statusLabel,
+      statusSeverity,
+    }
+  }
+  if (input.context === 'support_quality') {
+    const remediation = input.reason === 'page_support_import_non_maintained'
+      ? 'Перенести используемый PageObject из пробной области в поддерживаемую область проекта.'
+      : 'Дать элементу или компоненту устойчивое предметное имя в коде проекта.'
+    return {
+      category: 'support_quality',
+      title: 'Качество PageObject',
+      ownerLabel: 'Исправить в тестовом проекте',
+      impactLabel: 'Не блокирует доступные сценарии',
+      remediation,
+      statusLabel,
+      statusSeverity,
+    }
+  }
+  return {
+    category: 'unclassified',
+    title: 'Неклассифицированное сообщение Persona',
+    ownerLabel: 'Требуется классификация Persona',
+    impactLabel: 'Влияние не указано',
+    remediation: 'Persona должна передать машинно-читаемые владельца, влияние и способ исправления.',
+    statusLabel,
+    statusSeverity,
+  }
+}
+
+export function personaDiagnosticOverviewMessage(
+  availableTests: number,
+  unavailableTests: number,
+  diagnostics: readonly PersonaDiagnosticOverviewItem[],
+): string {
+  const count = (category: PersonaDiagnosticOverviewItem['category']) => (
+    diagnostics.filter((diagnostic) => diagnostic.category === category).length
+  )
+  const totalTests = availableTests + unavailableTests
+  const scenarioImports = count('scenario_import')
+  const componentAnalysis = count('component_analysis')
+  const supportQuality = count('support_quality')
+  const parts = [
+    `Доступно ${availableTests} из ${totalTests} сценариев.`,
+    scenarioImports > 0 ? `${scenarioImports} сценариев не импортируются из-за ошибок в зависимостях тестового проекта.` : null,
+    componentAnalysis > 0
+      ? `${componentAnalysis} сообщений относятся к анализу компонентов, остановленному отсутствующими модулями тестового проекта.`
+      : null,
+    supportQuality > 0 ? `${supportQuality} замечаний качества PageObject не блокируют доступные сценарии.` : null,
+  ]
+  return parts.filter((part): part is string => Boolean(part)).join(' ')
+}
+
+const PERSONA_RUN_STATUSES = [
+  'cancelled',
+  'cancelling',
+  'completed',
+  'degraded',
+  'error',
+  'failed',
+  'passed',
+  'paused',
+  'queued',
+  'running',
+  'skipped',
+  'timed_out',
+  'timeout',
+  'info',
+  'warn',
+  'warning',
+] as const
+type PersonaRunStatus = typeof PERSONA_RUN_STATUSES[number]
+const PERSONA_RUN_STATUS_PRESENTATIONS = {
+  cancelled: { label: 'отменён', severity: 'secondary' },
+  cancelling: { label: 'отменяется', severity: 'warn' },
+  completed: { label: 'завершён', severity: 'success' },
+  degraded: { label: 'требует внимания', severity: 'warn' },
+  error: { label: 'ошибка', severity: 'danger' },
+  failed: { label: 'ошибка', severity: 'danger' },
+  passed: { label: 'пройден', severity: 'success' },
+  paused: { label: 'приостановлен', severity: 'info' },
+  queued: { label: 'в очереди', severity: 'warn' },
+  running: { label: 'выполняется', severity: 'info' },
+  skipped: { label: 'пропущен', severity: 'warn' },
+  timed_out: { label: 'превышено время', severity: 'danger' },
+  timeout: { label: 'превышено время', severity: 'danger' },
+  info: { label: 'информация', severity: 'info' },
+  warn: { label: 'предупреждение', severity: 'warn' },
+  warning: { label: 'предупреждение', severity: 'warn' },
+} as const satisfies Record<PersonaRunStatus, {
+  label: string
+  severity: PersonaStatusSeverity
+}>
+
+function resolvePersonaRunStatus(status: unknown): PersonaRunStatus {
+  return validateExactString('Persona presentation', 'run status', status, PERSONA_RUN_STATUSES)
+}
+
+export function personaRunStatusLabel(status: unknown): string {
+  return PERSONA_RUN_STATUS_PRESENTATIONS[resolvePersonaRunStatus(status)].label
+}
+
+export function personaStatusSeverity(status: unknown): PersonaStatusSeverity {
+  return PERSONA_RUN_STATUS_PRESENTATIONS[resolvePersonaRunStatus(status)].severity
+}
+
+const PERSONA_SEMANTIC_KINDS = [
+  'Action',
+  'CombinedStep',
+  'Expectation',
+  'Fact',
+  'Goal',
+  'Ops',
+  'Step',
+  'action',
+  'check',
+  'combined_step',
+  'expectation',
+  'fact',
+  'get',
+  'goal',
+  'make',
+  'persona_call',
+  'step',
+] as const
+type PersonaSemanticKind = typeof PERSONA_SEMANTIC_KINDS[number]
+const PERSONA_SEMANTIC_KIND_LABELS = {
+    Action: 'Действие',
+    CombinedStep: 'Составной шаг',
+    Expectation: 'Проверка',
+    Fact: 'Данные',
+    Goal: 'Цель',
+    Ops: 'Служебная операция',
+    Step: 'Шаг',
+    action: 'Действие',
+    check: 'Проверка',
+    combined_step: 'Составной шаг',
+    expectation: 'Проверка',
+    fact: 'Данные',
+    get: 'Получение данных',
+    goal: 'Цель',
+    make: 'Действие',
+    persona_call: 'Вызов Persona',
+    step: 'Шаг',
+} as const satisfies Record<PersonaSemanticKind, string>
+
+export function personaSemanticKindLabel(kind: unknown): string {
+  if (kind === null || kind === undefined) return ''
+  const resolvedKind = validateExactString(
+    'Persona presentation',
+    'semantic kind',
+    kind,
+    PERSONA_SEMANTIC_KINDS,
+  )
+  return PERSONA_SEMANTIC_KIND_LABELS[resolvedKind]
+}
+
+export function personaParameterSummary(parameters: readonly PersonaParameterPresentation[]): string {
+  return parameters.map((parameter) => {
+    const type = parameter.type ? `: ${parameter.type}` : ''
+    const hasPrimitiveDefault = typeof parameter.default === 'string'
+      || typeof parameter.default === 'number'
+      || typeof parameter.default === 'boolean'
+    const defaultValue = hasPrimitiveDefault ? ` = ${String(parameter.default)}` : ''
+    return `${parameter.name}${type}${defaultValue}${parameter.required ? ' (обязательный)' : ''}`
+  }).join(', ')
+}
+
+const PERSONA_SEVERITIES = ['blocker', 'critical', 'minor', 'normal', 'trivial'] as const
+type PersonaSeverity = typeof PERSONA_SEVERITIES[number]
+const PERSONA_SEVERITY_PRESENTATIONS = {
+  blocker: { label: 'блокирующий', severity: 'danger' },
+  critical: { label: 'критический', severity: 'danger' },
+  minor: { label: 'низкая критичность', severity: 'secondary' },
+  normal: { label: 'обычная критичность', severity: 'info' },
+  trivial: { label: 'минимальная критичность', severity: 'secondary' },
+} as const satisfies Record<PersonaSeverity, {
+  label: string
+  severity: PersonaStatusSeverity
+}>
+
+function resolvePersonaSeverity(value: unknown): PersonaSeverity {
+  return validateExactString('Persona presentation', 'severity', value, PERSONA_SEVERITIES)
+}
+
+export function personaSeverityLabel(value: unknown): string {
+  return PERSONA_SEVERITY_PRESENTATIONS[resolvePersonaSeverity(value)].label
+}
+
+export function personaSeverityBadge(value: unknown): PersonaStatusSeverity {
+  return PERSONA_SEVERITY_PRESENTATIONS[resolvePersonaSeverity(value)].severity
+}
+
+const PERSONA_REPORT_STATUSES = ['broken', 'failed', 'passed', 'skipped'] as const
+type PersonaReportStatus = typeof PERSONA_REPORT_STATUSES[number]
+const PERSONA_REPORT_STATUS_LABELS = {
+    broken: 'сломан',
+    failed: 'ошибка',
+    passed: 'пройден',
+    skipped: 'пропущен',
+} as const satisfies Record<PersonaReportStatus, string>
+
+export function personaReportStatusLabel(status: unknown): string {
+  const resolvedStatus = validateExactString(
+    'Persona presentation',
+    'report status',
+    status,
+    PERSONA_REPORT_STATUSES,
+  )
+  return PERSONA_REPORT_STATUS_LABELS[resolvedStatus]
+}
+
+const PERSONA_LIFECYCLE_STAGES = [
+  'run_after_scenario',
+  'run_after_test',
+  'run_before_scenario',
+  'run_before_test',
+] as const
+type PersonaLifecycleStage = typeof PERSONA_LIFECYCLE_STAGES[number]
+const PERSONA_LIFECYCLE_STAGE_LABELS = {
+    run_after_scenario: 'после сценария',
+    run_after_test: 'после теста',
+    run_before_scenario: 'перед сценарием',
+    run_before_test: 'перед тестом',
+} as const satisfies Record<PersonaLifecycleStage, string>
+
+export function personaLifecycleStageLabel(stage: unknown): string {
+  const resolvedStage = validateExactString(
+    'Persona presentation',
+    'lifecycle stage',
+    stage,
+    PERSONA_LIFECYCLE_STAGES,
+  )
+  return PERSONA_LIFECYCLE_STAGE_LABELS[resolvedStage]
+}
+
+const PERSONA_EVENT_TYPES = [
+  'cancelled',
+  'completed',
+  'failed',
+  'log',
+  'queued',
+  'running',
+  'started',
+  'timeout',
+  'report.runtime_log',
+  'scenario.accepted',
+  'scenario.cancelled',
+  'scenario.finished',
+  'scenario.started',
+  'worker.started',
+  'worker.stopped',
+] as const
+type PersonaEventType = typeof PERSONA_EVENT_TYPES[number]
+const PERSONA_EVENT_TYPE_LABELS = {
+    cancelled: 'Запуск отменён',
+    completed: 'Запуск завершён',
+    failed: 'Запуск завершён с ошибкой',
+    log: 'Сообщение выполнения',
+    queued: 'Запуск поставлен в очередь',
+    running: 'Запуск начат',
+    started: 'Запуск начат',
+    timeout: 'Время запуска превышено',
+    'report.runtime_log': 'Сообщение выполнения',
+    'scenario.accepted': 'Тест поставлен в очередь',
+    'scenario.cancelled': 'Тест отменён',
+    'scenario.finished': 'Тест завершён',
+    'scenario.started': 'Тест запущен',
+    'worker.started': 'Исполнитель подключён',
+    'worker.stopped': 'Исполнитель остановлен',
+} as const satisfies Record<PersonaEventType, string>
+
+export function personaEventTypeLabel(eventType: unknown): string {
+  const resolvedEventType = validateExactString(
+    'Persona presentation',
+    'event type',
+    eventType,
+    PERSONA_EVENT_TYPES,
+  )
+  return PERSONA_EVENT_TYPE_LABELS[resolvedEventType]
+}
+
+export function personaPayloadMessage(payload: Record<string, unknown> | null): string {
+  if (!payload) return ''
+  for (const key of ['message', 'error_message', 'error', 'reason', 'detail', 'stderr', 'stdout']) {
+    const value = payload[key]
+    if (typeof value === 'string' && value.trim()) return value.trim()
+  }
+  return ''
+}
+
+export function personaDistinctMessage(title: string, message: string | null | undefined): string | null {
+  const normalizedMessage = message?.trim()
+  if (!normalizedMessage) return null
+  const comparable = (value: string) => value.toLocaleLowerCase('ru-RU').replace(/[.!?]+$/u, '').trim()
+  return comparable(title) === comparable(normalizedMessage) ? null : normalizedMessage
+}
+
+export function personaDurationLabel(durationMs: number | null | undefined): string {
+  if (durationMs === null || durationMs === undefined) return 'длительность не определена'
+  if (durationMs < 1000) return `${durationMs} мс`
+  return `${(durationMs / 1000).toLocaleString('ru-RU', { maximumFractionDigits: 2 })} с`
+}
+
+export function personaCountLabel(count: number, forms: [string, string, string]): string {
+  const remainder100 = count % 100
+  const remainder10 = count % 10
+  const form = remainder100 >= 11 && remainder100 <= 14
+    ? forms[2]
+    : remainder10 === 1
+      ? forms[0]
+      : remainder10 >= 2 && remainder10 <= 4
+        ? forms[1]
+        : forms[2]
+  return `${count} ${form}`
+}

package/src/components/shared/persona/types.ts

@@ -0,0 +1,256 @@
+import type { BadgeSeverity } from '../data-display/SBadge.vue'
+import type { ActionListItemBadge } from '../data-display/SActionListItem.vue'
+import type { Severity as MessageSeverity } from '../data-display/SMessage.vue'
+import type { SAsyncStateContract } from '../feedback/SAsyncState.vue'
+
+export type PersonaRunConsoleDensity = 'compact' | 'comfortable'
+
+/** Состояние точного инвентаря без одновременных loading/error/ready веток. / Exact inventory state without concurrent loading/error/ready branches. */
+export type PersonaInventoryPendingState = Extract<
+  SAsyncStateContract,
+  { status: 'loading' | 'error' }
+>
+
+export type PersonaInventoryState<Item> =
+  | PersonaInventoryPendingState
+  | { status: 'ready'; items: Item[] }
+
+/** Состояние точного paginated inventory с явной фазой страницы. / Exact paginated inventory state with an explicit page phase. */
+export type PersonaPaginatedInventoryState<Item> =
+  | PersonaInventoryPendingState
+  | { status: 'ready'; items: Item[]; pagination: 'complete' | 'has-more' }
+  | { status: 'ready'; items: [Item, ...Item[]]; pagination: 'loading-more' }
+
+/** Явная доступность действия без boolean capability fallback. / Explicit action availability without a boolean capability fallback. */
+export type PersonaActionAvailability = 'enabled' | 'disabled'
+
+/** Единственная активная операция private run console. / The single active private run-console operation. */
+export type PersonaRunConsoleOperation =
+  | 'idle'
+  | 'refreshing-events'
+  | 'cancelling-run'
+  | 'appending-events'
+
+/** Capability inventory private run console. / Private run-console capability inventory. */
+export type PersonaRunConsoleCapabilities = {
+  cancelRun: PersonaActionAvailability
+}
+
+/** Стабильный badge-контракт canonical action-list owner. / Stable badge contract shared with the canonical action-list owner. */
+export type PersonaRunConsoleBadge = ActionListItemBadge
+
+export type PersonaRunConsoleFact = {
+  /** Стабильный доменный id, независимый от presentation label и позиции. / Stable domain id independent of presentation label and position. */
+  id: string
+  label: string
+  value: string | number
+}
+
+/** Возвращает стабильный доменный id факта. / Returns the stable domain id of a fact. */
+export function getPersonaRunConsoleFactKey(fact: PersonaRunConsoleFact): string {
+  return fact.id
+}
+
+export type PersonaRunConsoleRun = {
+  id: string
+  title: string
+  meta: string
+  detail?: string | null
+  statusLabel: string
+  statusSeverity: BadgeSeverity
+  artifactLabel?: string | null
+  facts?: PersonaRunConsoleFact[]
+}
+
+export type PersonaRunConsoleItem = {
+  id: string
+  title: string
+  meta: string
+  detail?: string | null
+  statusLabel: string
+  statusSeverity: BadgeSeverity
+  badges?: PersonaRunConsoleBadge[]
+}
+
+export type PersonaRunConsoleEvent = {
+  id: string
+  title: string
+  meta: string
+  message?: string | null
+  badges?: PersonaRunConsoleBadge[]
+}
+
+export type PersonaRunConsoleLabels = {
+  runListTitle: string
+  selectedRunTitle: string
+  itemsTitle: string
+  eventsTitle: string
+  loadMoreRuns: string
+  loadMoreItems: string
+  appendEvents: string
+  loadMoreEvents: string
+  refreshEvents: string
+  cancelRun: string
+  reportSummary: string
+  emptyRun: string
+  noRuns: string
+  noItems: string
+  noEvents: string
+}
+
+export type PersonaCatalogStep = {
+  id: string
+  title: string
+  meta?: string | null
+  detail?: string | null
+  kind?: string | null
+  depth: number
+  badges?: PersonaRunConsoleBadge[]
+}
+
+export type PersonaCatalogLink = {
+  id: string
+  label: string
+  url: string
+}
+
+export type PersonaCatalogTest = {
+  id: string
+  title: string
+  meta: string
+  description?: string | null
+  detail?: string | null
+  workItemId: string
+  scenarioId: string
+  variantId?: string | null
+  sourcePath: string
+  tags?: string[]
+  badges?: PersonaRunConsoleBadge[]
+  facts?: PersonaRunConsoleFact[]
+  links?: PersonaCatalogLink[]
+  statusLabel?: string | null
+  statusSeverity?: BadgeSeverity
+  structureNotice?: PersonaRunWorkbenchNotice | null
+  steps: PersonaCatalogStep[]
+}
+
+export type PersonaRunWorkbenchBinding = {
+  id: string
+  title: string
+  root: string
+  statusLabel: string
+  statusSeverity: BadgeSeverity
+  meta?: string | null
+}
+
+export type PersonaRunWorkbenchWatcher = {
+  statusLabel: string
+  statusSeverity: BadgeSeverity
+  message?: string | null
+}
+
+export type PersonaRunWorkbenchCatalogOverview = {
+  unavailableTests?: number
+  components: number
+  pages: number
+  diagnosticErrors?: number
+  diagnosticWarnings?: number
+  environments?: string[]
+  executionModel?: string | null
+}
+
+export type PersonaRunWorkbenchDiagnostic = {
+  id: string
+  category: 'scenario_import' | 'component_analysis' | 'support_quality' | 'unclassified'
+  title: string
+  message: string
+  meta?: string | null
+  ownerLabel: string
+  impactLabel: string
+  remediation: string
+  statusLabel: string
+  statusSeverity: BadgeSeverity
+}
+
+export type PersonaRunWorkbenchNotice = {
+  title: string
+  message: string
+  severity: MessageSeverity
+}
+
+export type PersonaRunWorkbenchLabels = PersonaRunConsoleLabels & {
+  projectTitle: string
+  discoveryTitle: string
+  catalogTitle: string
+  structureTitle: string
+  runSelected: string
+  runAll: string
+  discover: string
+  watch: string
+  searchPlaceholder: string
+  noCatalogTests: string
+  emptyStructure: string
+  selectedTestTitle: string
+}
+
+/** Единственная активная операция workbench и его private console family. / The single active workbench/private-console-family operation. */
+export type PersonaRunWorkbenchOperation =
+  | PersonaRunConsoleOperation
+  | 'discovering'
+  | 'watching'
+  | 'starting-run'
+
+/** Полный capability inventory workbench. / Complete workbench capability inventory. */
+export type PersonaRunWorkbenchCapabilities = PersonaRunConsoleCapabilities & {
+  discover: PersonaActionAvailability
+  watch: PersonaActionAvailability
+  runSelected: PersonaActionAvailability
+  runAll: PersonaActionAvailability
+}
+
+export type PersonaProjectPickerRoot = {
+  id: string
+  label: string
+  path: string
+}
+
+export type PersonaProjectPickerEntry = {
+  /** Стабильный id проекта/директории в полном listing inventory. / Stable project/directory id in the complete listing inventory. */
+  id: string
+  rootId: string
+  name: string
+  projectName?: string | null
+  relativePath: string
+  requestedRoot: string
+  displayPath: string
+  readiness: 'ready' | 'not_persona' | 'invalid' | 'unreadable'
+  isSelectable: boolean
+  isHidden: boolean
+  diagnosticMessage?: string | null
+}
+
+export type PersonaProjectPickerListing = {
+  root: PersonaProjectPickerRoot
+  current: PersonaProjectPickerEntry
+  parentRelativePath: string | null
+  directories: PersonaProjectPickerEntry[]
+}
+
+export type PersonaProjectPickerConnected = {
+  id: string
+  /** Id соответствующей PersonaProjectPickerEntry. / Id of the matching PersonaProjectPickerEntry. */
+  projectId: string
+  title: string
+  path: string
+  active: boolean
+}
+
+/** Состояние каталога picker; pagination loading допустим только при существующем listing. / Picker directory state; pagination loading is valid only with an existing listing. */
+export type PersonaProjectPickerState =
+  | PersonaInventoryPendingState
+  | { status: 'ready'; listing: null; pagination: 'complete' }
+  | {
+    status: 'ready'
+    listing: PersonaProjectPickerListing
+    pagination: 'complete' | 'has-more' | 'loading-more'
+  }

package/src/composables/uiPreferencesReset.ts

@@ -0,0 +1,52 @@
+/**
+ * Типизированный scoped-controller для сброса UI-предпочтений.
+ * Typed scoped controller for resetting UI preferences.
+ */
+export interface UiPreferencesResetController {
+  /**
+   * Подписывает owner на сброс и возвращает функцию отписки.
+   * Subscribes an owner to reset requests and returns an unsubscribe function.
+   */
+  subscribe(listener: () => void): () => void;
+
+  /**
+   * Синхронно уведомляет всех active owners о сбросе.
+   * Synchronously notifies every active owner about a reset.
+   */
+  requestReset(): void;
+}
+
+/**
+ * Создаёт isolated reset scope без document events и глобальных строковых каналов.
+ * Creates an isolated reset scope without document events or global string channels.
+ */
+export function createUiPreferencesResetController(): UiPreferencesResetController {
+  const listeners = new Set<() => void>();
+
+  return {
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+
+    requestReset() {
+      const errors: unknown[] = [];
+      for (const listener of [...listeners]) {
+        try {
+          listener();
+        } catch (error) {
+          errors.push(error);
+        }
+      }
+
+      if (errors.length === 1) {
+        throw errors[0];
+      }
+      if (errors.length > 1) {
+        throw new AggregateError(errors, 'Не все owners UI-предпочтений смогли обработать сброс.');
+      }
+    },
+  };
+}