@pgcorp/ui-kit 0.3.0 → 0.4.0

package/src/components/shared/data-display/STooltip.vue

@@ -69,6 +69,7 @@ import {
   type VNodeRef,
 } from 'vue';
 import { mergeIdReferences, useOwnedAttrs } from '../../../internal/ownedAttrs';
+import { hasOwn } from '../../../internal/es2020';
 import {
   resolveInteractiveElement,
   type ElementRefTarget,
@@ -202,7 +203,7 @@ function assertDenseArray(coordinate: string, value: unknown): readonly unknown[
     throw triggerContractError(`${coordinate} должен быть массивом. ${coordinate} must be an array.`);
   }
   for (let index = 0; index < value.length; index += 1) {
-    if (!Object.hasOwn(value, index)) {
+    if (!hasOwn(value, index)) {
       throw triggerContractError(`${coordinate}[${index}] отсутствует в sparse array. ${coordinate}[${index}] is missing from a sparse array.`);
     }
   }

package/src/components/shared/data-display/SVirtualList.ts

@@ -1,19 +1,4 @@
 /** Ключ элемента виртуального списка. / Virtual-list item key. */
 export type SVirtualListItemKey = string | number
 
-/**
- * Публичный контракт виртуального списка с измеряемыми строками.
- * Public contract for a virtual list with measured rows.
- */
-export interface SVirtualListProps<Item = unknown> {
-  items: readonly Item[]
-  /** Оценочная высота строки до фактического измерения ResizeObserver. / Estimated row height before ResizeObserver measurement. */
-  itemSize: number
-  overscan?: number
-  height?: number | null
-  /** Устойчивый доменный ключ; индекс массива не является допустимым fallback. / Stable domain key; an array index is not a valid fallback. */
-  itemKey: (item: Item) => SVirtualListItemKey
-  itemLabel: (item: Item, index: number) => string
-  accessibleLabel: string
-  externalScrollTarget?: HTMLElement | null
-}
+export type { SVirtualListProps } from './SVirtualList.vue'

package/src/components/shared/data-display/SVirtualList.vue

@@ -35,6 +35,24 @@
   </div>
 </template>
 
+<script lang="ts">
+import type { SVirtualListItemKey } from './SVirtualList'
+
+/** Публичный контракт virtual list принадлежит source-SFC runtime. / The public virtual-list contract is owned by the source-SFC runtime. */
+export interface SVirtualListProps<Item = unknown> {
+  items: readonly Item[]
+  /** Оценочная высота строки до фактического измерения. / Estimated row height before measurement. */
+  itemSize: number
+  overscan?: number
+  height?: number | null
+  /** Устойчивый доменный ключ; индекс не является fallback. / Stable domain key; the index is not a fallback. */
+  itemKey: (item: Item) => SVirtualListItemKey
+  itemLabel: (item: Item, index: number) => string
+  accessibleLabel: string
+  externalScrollTarget?: HTMLElement | null
+}
+</script>
+
 <script setup lang="ts" generic="T">
 import {
   computed,
@@ -47,8 +65,6 @@ import {
 } from 'vue'
 import { useOwnedAttrs } from '../../../internal/ownedAttrs'
 import { useInteractiveLeafRegistration } from '../../../internal/passiveContentContract'
-import type { SVirtualListItemKey, SVirtualListProps } from './SVirtualList'
-
 defineOptions({ inheritAttrs: false })
 
 type Alignment = 'auto' | 'start' | 'center' | 'end'

package/src/components/shared/data-display/json.ts

@@ -12,7 +12,7 @@ export type JsonValue = JsonScalar | JsonObject | JsonArray
 
 /** Escapes one RFC 6901 reference token. / Экранирует один reference token по RFC 6901. */
 export function escapeJsonPointerToken(token: string): string {
-  return token.replaceAll('~', '~0').replaceAll('/', '~1')
+  return token.replace(/~/gu, '~0').replace(/\//gu, '~1')
 }
 
 /** Appends a reference token to an RFC 6901 JSON Pointer. / Добавляет reference token к JSON Pointer по RFC 6901. */

package/src/components/shared/data-display/table.ts

@@ -1,5 +1,4 @@
 import type {
-  ScrollableViewportMaxBlockSize,
   TableColumnInlineSize,
   TableColumnMinInlineSize,
 } from '../../../internal/semanticSizing'
@@ -12,6 +11,8 @@ export type STableSurface = 'bordered' | 'plain'
 export type STableMinWidth = 'content' | 'md' | 'lg'
 export type STableDensity = 'default' | 'compact'
 export type STableColumnContent = 'field' | 'value' | 'slot'
+export type STableColumnHeaderPresentation = 'visible' | 'assistive'
+export type STableSelectionMode = 'none' | 'multiple'
 export type STableSortDirection = 'ascending' | 'descending'
 
 /** Controlled sort state; consumer owns data ordering. / Управляемое состояние сортировки; порядок данных принадлежит consumer. */
@@ -23,6 +24,7 @@ export interface STableSort<Field extends string = string> {
 interface STableColumnBase<Field extends string> {
   field: Field
   header: string
+  headerPresentation?: STableColumnHeaderPresentation
   width?: TableColumnInlineSize
   minWidth?: TableColumnMinInlineSize
   align?: STableAlignment
@@ -55,31 +57,4 @@ export type STableColumn<
   | STableSlotColumn<Field>
   | (Field extends Extract<keyof Row, string> ? STableFieldColumn<Field> : never)
 
-/** Публичный generic-контракт таблицы. / Public generic table contract. */
-export interface STableProps<
-  Row extends object,
-  RowKey extends STableRowKey,
-  Field extends string,
-> {
-  columns: readonly STableColumn<Row, Field>[]
-  data: readonly Row[]
-  getRowKey: (row: Row) => RowKey
-  loading?: boolean
-  loadingMessage?: string
-  errorMessage?: string
-  emptyMessage?: string
-  selectedRowKey?: RowKey
-  sort?: STableSort<Field> | null
-  maxHeight?: ScrollableViewportMaxBlockSize
-  density?: STableDensity
-  surface?: STableSurface
-  minWidth?: STableMinWidth
-  rowState?: (row: Row) => STableRowState
-  cellState?: (row: Row, column: STableColumn<Row, Field>) => STableCellState
-  /** Accessible name без visible owner. / Accessible name when there is no visible owner. */
-  ariaLabel?: string
-  /** DOM id visible owner, mutually exclusive with ariaLabel. / DOM id of the visible owner, mutually exclusive with ariaLabel. */
-  ariaLabelledby?: string
-  /** DOM id supplemental status/diagnostic owner. / DOM id of a supplemental status/diagnostic owner. */
-  ariaDescribedby?: string
-}
+export type { STableProps } from './STable.vue'

package/src/components/shared/database/SDataGrid.vue

@@ -83,6 +83,13 @@
 </template>
 
 <script lang="ts">
+import type { ScrollableViewportMaxBlockSize } from '../../../internal/semanticSizing'
+import type {
+  SDataGridColumn,
+  SDataGridColumnKey,
+  SDataGridRow,
+} from './dataGrid'
+
 export type {
   SDataGridCell,
   SDataGridCellKind,
@@ -90,14 +97,32 @@ export type {
   SDataGridColumnKey,
   SDataGridCommitInput,
   SDataGridEditPayload,
-  SDataGridProps,
   SDataGridRow,
   SDataGridRowState,
 } from './dataGrid'
+
+/** Публичный контракт data grid принадлежит source-SFC runtime. / The public data-grid contract is owned by the source-SFC runtime. */
+export interface SDataGridProps<Key extends SDataGridColumnKey = SDataGridColumnKey> {
+  columns: readonly SDataGridColumn<Key>[]
+  rows: readonly SDataGridRow<Key>[]
+  title?: string
+  loading?: boolean
+  disabled?: boolean
+  readOnly?: boolean
+  errorMessage?: string
+  emptyMessage?: string
+  selectedRowId?: string
+  maxHeight?: ScrollableViewportMaxBlockSize
+  /** Accessible name без visible title. / Accessible name when there is no visible title. */
+  ariaLabel?: string
+  /** DOM id external visible title. / DOM id of an external visible title. */
+  ariaLabelledby?: string
+}
 </script>
 
 <script setup lang="ts" generic="ColumnKey extends string = string">
 import { computed, reactive, useId, useSlots, watch } from 'vue'
+import { hasOwn } from '../../../internal/es2020'
 import { useOwnedAttrs } from '../../../internal/ownedAttrs'
 import {
   validateScrollableViewportMaxBlockSize,
@@ -121,12 +146,8 @@ import type {
 } from '../data-display/table'
 import type {
   SDataGridCell,
-  SDataGridColumn,
-  SDataGridColumnKey,
   SDataGridCommitInput,
   SDataGridEditPayload,
-  SDataGridProps,
-  SDataGridRow,
 } from './dataGrid'
 
 defineOptions({ inheritAttrs: false })
@@ -266,7 +287,7 @@ const validatedGrid = computed<ValidatedGrid<ColumnKey>>(() => {
       }
     }
     for (const [key, column] of columnByKey) {
-      if (!Object.hasOwn(row.cells, key)) {
+      if (!hasOwn(row.cells, key)) {
         throw new TypeError(
           `SDataGrid: row ${JSON.stringify(rowId)} не содержит cell ${JSON.stringify(key)}. `
           + `/ SDataGrid: row ${JSON.stringify(rowId)} is missing cell ${JSON.stringify(key)}.`,
@@ -358,7 +379,7 @@ function resolveColumn(key: string): SDataGridColumn<ColumnKey> {
 
 function resolveCell(row: SDataGridRow<ColumnKey>, columnKeyValue: string): SDataGridCell {
   const columnKey = resolveColumn(columnKeyValue).key
-  if (Object.hasOwn(row.cells, columnKey)) return row.cells[columnKey]
+  if (hasOwn(row.cells, columnKey)) return row.cells[columnKey]
   throw new TypeError(
     `SDataGrid: row ${JSON.stringify(row.id)} не содержит cell ${JSON.stringify(columnKey)}. `
     + `/ SDataGrid: row ${JSON.stringify(row.id)} is missing cell ${JSON.stringify(columnKey)}.`,
@@ -404,7 +425,7 @@ function editCell(row: SDataGridRow<ColumnKey>, column: SDataGridColumn<ColumnKe
 function validateCommitInput(input: unknown): SDataGridCommitInput {
   assertRecord(input, 'commit input')
   const source = validateExactString('SDataGrid', 'commit input.source', input.source, COMMIT_SOURCES)
-  const hasValue = Object.hasOwn(input, 'value')
+  const hasValue = hasOwn(input, 'value')
   if (source === 'draft' && hasValue) {
     throw new TypeError(
       'SDataGrid: draft commit не должен содержать value. / SDataGrid: draft commit must not contain value.',

package/src/components/shared/database/SSqlEditor.vue

@@ -51,6 +51,7 @@
 
 <script setup lang="ts">
 import { computed, ref, useId, useSlots } from 'vue'
+import { hasOwn } from '../../../internal/es2020'
 import { useOwnedAttrs } from '../../../internal/ownedAttrs'
 import { provideTrustedCodeEditorExtensions } from '../../../internal/codeEditorExtensions'
 import { validateCodeEditorViewport } from '../../../internal/codeEditorContract'
@@ -291,8 +292,8 @@ const validatedDiagnostics = computed<SSqlEditorDiagnostic[]>(() => {
   return props.diagnostics.map((candidate, index) => {
     const runtimeCandidate: unknown = candidate
     const record = assertPlainExactRecord(`SSqlEditor.diagnostics[${index}]`, runtimeCandidate, ['severity', 'message', 'from', 'to', 'line', 'column'])
-    const hasOffset = Object.hasOwn(record, 'from')
-    const hasLine = Object.hasOwn(record, 'line') || Object.hasOwn(record, 'column')
+    const hasOffset = hasOwn(record, 'from')
+    const hasLine = hasOwn(record, 'line') || hasOwn(record, 'column')
     if (hasOffset === hasLine) throw new TypeError(`SSqlEditor: diagnostics[${index}] должен задавать ровно один range: from/to или line/column. / SSqlEditor: diagnostics[${index}] must provide exactly one range: from/to or line/column.`)
     const allowedRangeKeys = hasOffset
       ? ['severity', 'message', 'from', 'to']

package/src/components/shared/database/dataGrid.ts

@@ -1,5 +1,4 @@
 import type {
-  ScrollableViewportMaxBlockSize,
   TableColumnInlineSize,
   TableColumnMinInlineSize,
 } from '../../../internal/semanticSizing'
@@ -43,19 +42,4 @@ export type SDataGridCommitInput =
   | { source: 'draft' }
   | { source: 'value'; value: unknown }
 
-export interface SDataGridProps<Key extends SDataGridColumnKey = SDataGridColumnKey> {
-  columns: readonly SDataGridColumn<Key>[]
-  rows: readonly SDataGridRow<Key>[]
-  title?: string
-  loading?: boolean
-  disabled?: boolean
-  readOnly?: boolean
-  errorMessage?: string
-  emptyMessage?: string
-  selectedRowId?: string
-  maxHeight?: ScrollableViewportMaxBlockSize
-  /** Accessible name без visible title. / Accessible name when there is no visible title. */
-  ariaLabel?: string
-  /** DOM id external visible title. / DOM id of an external visible title. */
-  ariaLabelledby?: string
-}
+export type { SDataGridProps } from './SDataGrid.vue'

package/src/components/shared/navigation/STabs.vue

@@ -58,6 +58,7 @@ import {
   type VNodeChild,
 } from 'vue'
 import { useOwnedAttrs } from '../../../internal/ownedAttrs'
+import { lastItem } from '../../../internal/es2020'
 import {
   tabsContextKey,
   type STabListRegistrationKey,
@@ -425,7 +426,7 @@ function handleTabKeydown(key: STabRegistrationKey, event: KeyboardEvent): void
   }
   let next: TabRecord | undefined
   if (event.key === 'Home') next = enabled[0]
-  else if (event.key === 'End') next = enabled.at(-1)
+  else if (event.key === 'End') next = lastItem(enabled)
   else if (event.key === 'ArrowLeft') next = enabled[(currentIndex - 1 + enabled.length) % enabled.length]
   else if (event.key === 'ArrowRight') next = enabled[(currentIndex + 1) % enabled.length]
   if (!next) return

package/src/composables/uiPreferencesReset.ts

@@ -45,8 +45,9 @@ export function createUiPreferencesResetController(): UiPreferencesResetControll
         throw errors[0];
       }
       if (errors.length > 1) {
-        throw new AggregateError(errors, 'Не все owners UI-предпочтений смогли обработать сброс.');
+        throw createAggregateError(errors, 'Не все owners UI-предпочтений смогли обработать сброс.');
       }
     },
   };
 }
+import { createAggregateError } from '../internal/es2020';

package/src/composables/useClipboard.ts

@@ -28,10 +28,11 @@ export function useClipboard(): ClipboardService {
       const isDomException = typeof DOMException !== 'undefined' && cause instanceof DOMException
       const error = cause instanceof Error || isDomException
         ? cause
-        : new Error('Clipboard API rejected writeText without an Error object', { cause })
+        : withErrorCause(new Error('Clipboard API rejected writeText without an Error object'), cause)
       return { status: 'failed', error }
     }
   }
 
   return { copyText }
 }
+import { withErrorCause } from '../internal/es2020'

package/src/composables/useSidebarPanelState.ts

@@ -1,4 +1,5 @@
 import { computed, getCurrentScope, onScopeDispose, reactive, readonly, watch } from 'vue';
+import { hasOwn, lastItem } from '../internal/es2020';
 
 import {
   assertSidebarSectionsState,
@@ -284,7 +285,7 @@ function preferredFlexibleSectionKey(
     return config?.defaultIsOpen === true && config.defaultSize === null;
   });
   if (defaultFlexibleKey && state[defaultFlexibleKey]?.isOpen) return defaultFlexibleKey;
-  return openKeys.at(-1) ?? null;
+  return lastItem(openKeys) ?? null;
 }
 
 /**
@@ -327,7 +328,7 @@ function decodePersistedDocument(
   if (!isPlainRecord(value)) {
     throw new SidebarPanelStateContractError('$', 'expected an object');
   }
-  if (Object.hasOwn(value, 'version') || Object.hasOwn(value, 'sections')) {
+  if (hasOwn(value, 'version') || hasOwn(value, 'sections')) {
     assertExactKeys(value, ['sections', 'version'], '$');
     if (value.version !== SIDEBAR_PANEL_STATE_SCHEMA_VERSION) {
       throw new SidebarPanelStateContractError(

package/src/internal/es2020.ts

@@ -0,0 +1,50 @@
+/** Проверяет собственное свойство без зависимости от ES2022 Object.hasOwn. / Checks an own property without the ES2022 Object.hasOwn API. */
+export function hasOwn(object: object, key: PropertyKey): boolean {
+  return Object.prototype.hasOwnProperty.call(object, key)
+}
+
+/** Возвращает последний элемент без зависимости от ES2022 Array.at. / Returns the last item without the ES2022 Array.at API. */
+export function lastItem<T>(items: readonly T[]): T | undefined {
+  return items.length > 0 ? items[items.length - 1] : undefined
+}
+
+/** Ошибка с ES2022-compatible cause, доступная в ES2020 runtime. / An ES2022-compatible error cause for ES2020 runtimes. */
+export type ErrorWithCause<T extends Error = Error> = T & { cause: unknown }
+
+/** Добавляет стандартный non-enumerable cause без требования ES2022 lib. / Adds the standard non-enumerable cause without requiring the ES2022 lib. */
+export function withErrorCause<T extends Error>(error: T, cause: unknown): ErrorWithCause<T> {
+  Object.defineProperty(error, 'cause', {
+    configurable: true,
+    value: cause,
+    writable: true,
+  })
+  return error as ErrorWithCause<T>
+}
+
+interface AggregateErrorLike extends Error {
+  readonly errors: readonly unknown[]
+}
+
+interface AggregateErrorConstructorLike {
+  new (errors: Iterable<unknown>, message?: string): AggregateErrorLike
+}
+
+class Es2020AggregateError extends Error implements AggregateErrorLike {
+  readonly errors: readonly unknown[]
+
+  constructor(errors: readonly unknown[], message: string) {
+    super(message)
+    this.name = 'AggregateError'
+    this.errors = [...errors]
+  }
+}
+
+/** Создаёт native AggregateError при наличии и точный ES2020 fallback иначе. / Creates a native AggregateError when available and an exact ES2020 fallback otherwise. */
+export function createAggregateError(errors: readonly unknown[], message: string): AggregateErrorLike {
+  const candidate: unknown = (globalThis as { AggregateError?: unknown }).AggregateError
+  if (typeof candidate === 'function') {
+    const AggregateErrorConstructor = candidate as AggregateErrorConstructorLike
+    return new AggregateErrorConstructor(errors, message)
+  }
+  return new Es2020AggregateError(errors, message)
+}

package/src/internal/inlineTokenEditorContract.ts

@@ -1,4 +1,5 @@
 import { validateBoundedInteger, validateNonEmptyString } from './runtimeContract'
+import { hasOwn, lastItem } from './es2020'
 
 export type InlineTokenEditorSegmentContract =
   | { readonly kind: 'text'; readonly text: string }
@@ -44,7 +45,7 @@ export function parseInlineTokenEditorSource(
   const parsed: InlineTokenEditorSegmentContract[] = []
   const tokenOccurrences = new Map<string, number>()
   for (let index = 0; index < segments.length; index += 1) {
-    if (!Object.hasOwn(segments, index)) {
+    if (!hasOwn(segments, index)) {
       throw new TypeError(`SInlineTokenEditor: segments[${index}] отсутствует в sparse array. / SInlineTokenEditor: segments[${index}] is missing from a sparse array.`)
     }
     const record = assertPlainRecord(`SInlineTokenEditor.segments[${index}]`, segments[index])
@@ -54,7 +55,7 @@ export function parseInlineTokenEditorSource(
         throw new TypeError(`SInlineTokenEditor: segments[${index}].text должен быть непустой строкой. / SInlineTokenEditor: segments[${index}].text must be a non-empty string.`)
       }
       const text = record.text
-      if (parsed.at(-1)?.kind === 'text') {
+      if (lastItem(parsed)?.kind === 'text') {
         throw new TypeError(`SInlineTokenEditor: segments[${index}] является смежным text segment; объедините его в источнике. / SInlineTokenEditor: segments[${index}] is an adjacent text segment; merge it at the source.`)
       }
       parsed.push({ kind: 'text', text })
@@ -122,7 +123,7 @@ export function composeInlineTokenSegments(
   for (const segment of segments) {
     if (segment.kind === 'text') {
       if (segment.text.length === 0) continue
-      const previous = result.at(-1)
+      const previous = lastItem(result)
       if (previous?.kind === 'text') {
         result[result.length - 1] = { kind: 'text', text: previous.text + segment.text }
       } else {

package/src/internal/pointerInteractionLease.ts

@@ -19,7 +19,7 @@ let preservedCursor = ''
 let preservedUserSelect = ''
 
 const applyActiveInteraction = (): void => {
-  const interaction = activeInteractions.at(-1)
+  const interaction = lastItem(activeInteractions)
   if (!lockedBody || !interaction) return
   lockedBody.style.cursor = interaction.cursor
   lockedBody.style.userSelect = 'none'
@@ -79,3 +79,4 @@ export function acquirePointerInteractionLease(
     },
   }
 }
+import { lastItem } from './es2020'

package/src/internal/semanticSizing.ts

@@ -2,8 +2,8 @@ import { validateExactString } from './runtimeContract'
 
 const SCROLLABLE_VIEWPORT_MAX_BLOCK_SIZES = ['none', 'sm', 'md', 'lg'] as const
 const EXPANDED_CONTENT_MAX_BLOCK_SIZES = ['sm', 'md', 'lg'] as const
-const TABLE_COLUMN_INLINE_SIZES = ['auto', 'xs', 'sm', 'md', 'lg', 'xl', 'fill'] as const
-const TABLE_COLUMN_MIN_INLINE_SIZES = ['xs', 'sm', 'md', 'lg', 'xl'] 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
 
 /**
  * Максимальный block-size прокручиваемого viewport; none сохраняет естественный flow.

package/src/styles/tokens.css

@@ -212,6 +212,7 @@
   --s-expanded-content-max-block-size-lg: 28rem;
   --s-table-inline-size-md: 32rem;
   --s-table-inline-size-lg: 42rem;
+  --s-table-column-inline-size-2xs: 3rem;
   --s-table-column-inline-size-xs: 6rem;
   --s-table-column-inline-size-sm: 9rem;
   --s-table-column-inline-size-md: 12rem;