@pgcorp/ui-kit 0.8.1 → 0.10.0

package/src/internal/feedbackPresentation.ts

@@ -1,6 +1,8 @@
 import type { Component } from 'vue'
 
 import { AlertTriangle, CheckCircle2, Info, LoaderCircle, XCircle } from '../components/icons/sputnigUiIcons'
+import { createUiKitTranslate, UI_KIT_MESSAGES } from '../locales/messages'
+import type { UiKitStaticMessageKey, UiKitTranslate } from '../locales/locale'
 
 export type FeedbackTone = 'neutral' | 'info' | 'success' | 'warn' | 'danger'
 export type FeedbackSeverity = Exclude<FeedbackTone, 'neutral'>
@@ -37,20 +39,35 @@ export interface FeedbackIndicatorPresentation {
   readonly motion: 'static' | 'spin'
 }
 
-const presentations: Readonly<Record<FeedbackTone, Readonly<FeedbackPresentation>>> = {
-  neutral: { icon: Info, iconName: 'info', fallbackTitle: 'Статус' },
-  info: { icon: Info, iconName: 'info', fallbackTitle: 'Информация' },
-  success: { icon: CheckCircle2, iconName: 'check-circle', fallbackTitle: 'Успех' },
-  warn: { icon: AlertTriangle, iconName: 'alert-triangle', fallbackTitle: 'Предупреждение' },
-  danger: { icon: XCircle, iconName: 'x-circle', fallbackTitle: 'Ошибка' },
+interface FeedbackPresentationSeed {
+  readonly icon: Component
+  readonly iconName: FeedbackPresentation['iconName']
+  readonly fallbackTitleKey: UiKitStaticMessageKey
+}
+
+const presentations: Readonly<Record<FeedbackTone, FeedbackPresentationSeed>> = {
+  neutral: { icon: Info, iconName: 'info', fallbackTitleKey: 'feedback.titleStatus' },
+  info: { icon: Info, iconName: 'info', fallbackTitleKey: 'feedback.titleInformation' },
+  success: { icon: CheckCircle2, iconName: 'check-circle', fallbackTitleKey: 'feedback.titleSuccess' },
+  warn: { icon: AlertTriangle, iconName: 'alert-triangle', fallbackTitleKey: 'feedback.titleWarning' },
+  danger: { icon: XCircle, iconName: 'x-circle', fallbackTitleKey: 'feedback.titleError' },
 }
+const defaultTranslate = createUiKitTranslate(() => UI_KIT_MESSAGES.ru)
 
 /**
  * Возвращает единую icon/title-презентацию для feedback tone.
  * Returns the canonical icon/title presentation for a feedback tone.
  */
-export function resolveFeedbackPresentation(tone: FeedbackTone): Readonly<FeedbackPresentation> {
-  return presentations[tone]
+export function resolveFeedbackPresentation(
+  tone: FeedbackTone,
+  t: UiKitTranslate = defaultTranslate,
+): Readonly<FeedbackPresentation> {
+  const presentation = presentations[tone]
+  return {
+    icon: presentation.icon,
+    iconName: presentation.iconName,
+    fallbackTitle: t(presentation.fallbackTitleKey),
+  }
 }
 
 /**
@@ -59,17 +76,18 @@ export function resolveFeedbackPresentation(tone: FeedbackTone): Readonly<Feedba
  */
 export function resolveFeedbackIndicator(
   state: FeedbackIndicatorState,
+  t: UiKitTranslate = defaultTranslate,
 ): Readonly<FeedbackIndicatorPresentation> {
   if (state === 'progress') {
     return {
       tone: 'info',
       icon: LoaderCircle,
       iconName: 'loader-circle',
-      fallbackTitle: 'Выполняется',
+      fallbackTitle: t('feedback.titleRunning'),
       motion: 'spin',
     }
   }
-  const presentation = resolveFeedbackPresentation(state)
+  const presentation = resolveFeedbackPresentation(state, t)
   return {
     tone: state,
     icon: presentation.icon,
@@ -102,14 +120,15 @@ export function resolveFeedbackLive(
  */
 export function resolveAsyncFeedbackPresentation(
   status: AsyncFeedbackStatus,
+  t: UiKitTranslate = defaultTranslate,
 ): Readonly<AsyncFeedbackPresentation> {
   if (status === 'loading') {
-    const progress = resolveFeedbackIndicator('progress')
+    const progress = resolveFeedbackIndicator('progress', t)
     return {
       tone: progress.tone,
       icon: progress.icon,
       iconName: progress.iconName,
-      fallbackMessage: 'Загрузка…',
+      fallbackMessage: t('feedback.loading'),
       busy: true,
       live: resolveFeedbackLive(progress.tone, 'auto'),
     }
@@ -119,12 +138,12 @@ export function resolveAsyncFeedbackPresentation(
       tone: 'neutral',
       icon: null,
       iconName: null,
-      fallbackMessage: 'Нет данных для отображения.',
+      fallbackMessage: t('feedback.empty'),
       busy: false,
       live: resolveFeedbackLive('neutral', 'auto'),
     }
   }
-  const error = resolveFeedbackIndicator('danger')
+  const error = resolveFeedbackIndicator('danger', t)
   return {
     tone: 'danger',
     icon: error.icon,

package/src/internal/localeContext.ts

@@ -0,0 +1,22 @@
+import { computed, inject, type ComputedRef, type InjectionKey } from 'vue'
+
+import { createUiKitTranslate, UI_KIT_MESSAGES } from '../locales/messages'
+import type { UiKitLocale, UiKitMessages, UiKitTranslate } from '../locales/locale'
+
+export interface UiKitLocaleContext {
+  readonly locale: ComputedRef<UiKitLocale>
+  readonly messages: ComputedRef<Readonly<UiKitMessages>>
+  readonly t: UiKitTranslate
+}
+
+export const UI_KIT_LOCALE_CONTEXT: InjectionKey<UiKitLocaleContext> = Symbol('SUiKitLocaleProvider')
+
+export function createDefaultUiKitLocaleContext(): UiKitLocaleContext {
+  const locale = computed<UiKitLocale>(() => 'ru')
+  const messages = computed<Readonly<UiKitMessages>>(() => UI_KIT_MESSAGES.ru)
+  return Object.freeze({ locale, messages, t: createUiKitTranslate(() => messages.value) })
+}
+
+export function resolveUiKitLocaleContext(): UiKitLocaleContext {
+  return inject(UI_KIT_LOCALE_CONTEXT, null) ?? createDefaultUiKitLocaleContext()
+}

package/src/internal/ownedAttrs.ts

@@ -73,6 +73,7 @@ export const ownedAttributeSchemas = Object.freeze({
     'data-testid': 'data',
   }),
   SPageHeader: defineOwnedAttributeSchema({}),
+  SUiKitLocaleProvider: defineOwnedAttributeSchema({}),
   SPanel: defineOwnedAttributeSchema({
     'data-testid': 'data',
   }),
@@ -268,6 +269,12 @@ export const ownedAttributeSchemas = Object.freeze({
     'aria-labelledby': 'string',
     autofocus: 'boolean-attribute',
   }),
+  SCodeWorkspaceEditor: defineOwnedAttributeSchema({}),
+  SDiffViewer: defineOwnedAttributeSchema({}),
+  SRichDocument: defineOwnedAttributeSchema({}),
+  SScrollViewport: defineOwnedAttributeSchema({
+    'data-testid': 'data',
+  }),
   SCodeSearchPanel: defineOwnedAttributeSchema({}),
   SCopyField: defineOwnedAttributeSchema({}),
   SDocBlock: defineOwnedAttributeSchema({}),
@@ -288,6 +295,7 @@ export const ownedAttributeSchemas = Object.freeze({
   SSectionHeader: defineOwnedAttributeSchema({}),
   SStatus: defineOwnedAttributeSchema({}),
   STable: defineOwnedAttributeSchema({}),
+  SControlledToastViewport: defineOwnedAttributeSchema({}),
   SToastContainer: defineOwnedAttributeSchema({}),
   STooltip: defineOwnedAttributeSchema({}),
   STooltipAnchor: defineOwnedAttributeSchema({

package/src/internal/runtimeContract.ts

@@ -28,15 +28,17 @@ function assertBoundedDomain(
     || (Number.isInteger(domain.minimum) && Number.isInteger(domain.maximum))
   if (validNumbers && validIntegerBounds && domain.minimum <= domain.maximum) return
 
-  const russianKind = integer ? 'целыми числами' : 'конечными числами'
-  const englishKind = integer ? 'integers' : 'finite numbers'
-  throw new TypeError(
-    `runtimeContract: границы domain для ${owner}.${coordinate} должны быть ${russianKind}, `
-    + `где minimum <= maximum; получено minimum=${describeRuntimeValue(domain.minimum)}, `
-    + `maximum=${describeRuntimeValue(domain.maximum)}. / runtimeContract: domain bounds for `
-    + `${owner}.${coordinate} must be ${englishKind} with minimum <= maximum; received `
-    + `minimum=${describeRuntimeValue(domain.minimum)}, maximum=${describeRuntimeValue(domain.maximum)}.`,
-  )
+  throw new TypeError(integer
+    ? `runtimeContract: границы domain для ${owner}.${coordinate} должны быть целыми числами, `
+      + `где minimum <= maximum; получено minimum=${describeRuntimeValue(domain.minimum)}, `
+      + `maximum=${describeRuntimeValue(domain.maximum)}. / runtimeContract: domain bounds for `
+      + `${owner}.${coordinate} must be integers with minimum <= maximum; received `
+      + `minimum=${describeRuntimeValue(domain.minimum)}, maximum=${describeRuntimeValue(domain.maximum)}.`
+    : `runtimeContract: границы domain для ${owner}.${coordinate} должны быть конечными числами, `
+      + `где minimum <= maximum; получено minimum=${describeRuntimeValue(domain.minimum)}, `
+      + `maximum=${describeRuntimeValue(domain.maximum)}. / runtimeContract: domain bounds for `
+      + `${owner}.${coordinate} must be finite numbers with minimum <= maximum; received `
+      + `minimum=${describeRuntimeValue(domain.minimum)}, maximum=${describeRuntimeValue(domain.maximum)}.`)
 }
 
 function assertExactStringDomain(

package/src/internal/semanticSizing.ts

@@ -1,6 +1,7 @@
 import { validateExactString } from './runtimeContract'
 
 const SCROLLABLE_VIEWPORT_MAX_BLOCK_SIZES = ['none', 'sm', 'md', 'lg'] as const
+const SCROLL_VIEWPORT_BLOCK_SIZES = ['sm', 'md', 'lg', 'fill'] as const
 const EXPANDED_CONTENT_MAX_BLOCK_SIZES = ['sm', 'md', 'lg'] as const
 const TABLE_COLUMN_INLINE_SIZES = ['auto', 'content', '2xs', 'xs', 'sm', 'md', 'lg', 'xl', 'fill'] as const
 const TABLE_COLUMN_MIN_INLINE_SIZES = ['2xs', 'xs', 'sm', 'md', 'lg', 'xl'] as const
@@ -11,6 +12,9 @@ const TABLE_COLUMN_MIN_INLINE_SIZES = ['2xs', 'xs', 'sm', 'md', 'lg', 'xl'] as c
  */
 export type ScrollableViewportMaxBlockSize = typeof SCROLLABLE_VIEWPORT_MAX_BLOCK_SIZES[number]
 
+/** Фиксированная semantic block-size рабочей scroll-области. / Fixed semantic block size of a scroll workspace. */
+export type ScrollViewportBlockSize = typeof SCROLL_VIEWPORT_BLOCK_SIZES[number]
+
 /**
  * Максимальный block-size раскрытого текстового content region.
  * Maximum block size for an expanded textual content region.
@@ -32,6 +36,15 @@ export function validateScrollableViewportMaxBlockSize(
   return validateExactString(owner, coordinate, value, SCROLLABLE_VIEWPORT_MAX_BLOCK_SIZES)
 }
 
+/** Проверяет semantic scroll-workspace size без raw CSS-length. / Validates a semantic scroll-workspace size without a raw CSS length. */
+export function validateScrollViewportBlockSize(
+  owner: string,
+  coordinate: string,
+  value: unknown,
+): ScrollViewportBlockSize {
+  return validateExactString(owner, coordinate, value, SCROLL_VIEWPORT_BLOCK_SIZES)
+}
+
 /** Проверяет semantic expanded-content size без CSS-length escape. / Validates a semantic expanded-content size without a CSS-length escape. */
 export function validateExpandedContentMaxBlockSize(
   owner: string,