@krometra/ui-kit 0.0.0-stage → 0.3.0

package/src/components/KFilterBar.vue

@@ -0,0 +1,91 @@
+<script setup>
+/**
+ * KFilterBar — панель поиска и фильтров над списком.
+ *
+ * Слоты: #search (обычно KInput), по умолчанию — сами фильтры, #actions —
+ * кнопки справа. Ниже показываются активные фильтры чипами со сбросом: без
+ * этого пользователь теряет из виду, почему список пуст.
+ *
+ *   active: [{ key, label }]
+ */
+import KIcon from './KIcon.vue'
+
+defineProps({
+  active: { type: Array, default: () => [] },
+})
+
+defineEmits(['remove', 'reset'])
+</script>
+
+<template>
+  <div class="k-filterbar">
+    <div class="k-filterbar__row">
+      <div v-if="$slots.search" class="k-filterbar__search"><slot name="search" /></div>
+      <div class="k-filterbar__fields"><slot /></div>
+      <div v-if="$slots.actions" class="k-filterbar__actions"><slot name="actions" /></div>
+    </div>
+    <div v-if="active.length" class="k-filterbar__chips">
+      <span v-for="chip in active" :key="chip.key" class="k-filterbar__chip">
+        {{ chip.label }}
+        <button class="k-filterbar__chip-x" aria-label="Убрать фильтр" @click="$emit('remove', chip)">
+          <KIcon name="close" :size="12" />
+        </button>
+      </span>
+      <button class="k-filterbar__reset" @click="$emit('reset')">Сбросить всё</button>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.k-filterbar {
+  background: var(--k-surface);
+  border: 1px solid var(--k-border);
+  border-radius: var(--k-radius);
+  box-shadow: var(--k-shadow-sm);
+  padding: 0.875rem 1rem;
+}
+.k-filterbar__row { display: flex; align-items: flex-end; gap: 0.75rem; flex-wrap: wrap; }
+.k-filterbar__search { flex: 1 1 20rem; min-width: 14rem; }
+.k-filterbar__fields { display: flex; align-items: flex-end; gap: 0.75rem; flex-wrap: wrap; }
+.k-filterbar__actions { display: flex; align-items: center; gap: 0.5rem; margin-left: auto; }
+.k-filterbar__chips {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  flex-wrap: wrap;
+  margin-top: 0.75rem;
+  padding-top: 0.75rem;
+  border-top: 1px dashed var(--k-border);
+}
+.k-filterbar__chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.3rem;
+  padding: 0.15rem 0.3rem 0.15rem 0.55rem;
+  background: var(--k-primary-soft);
+  color: var(--k-primary);
+  border-radius: 999px;
+  font-size: 0.75rem;
+  font-weight: 500;
+}
+.k-filterbar__chip-x {
+  display: inline-flex;
+  background: none;
+  border: none;
+  color: inherit;
+  opacity: 0.65;
+  cursor: pointer;
+  padding: 0.1rem;
+}
+.k-filterbar__chip-x:hover { opacity: 1; }
+.k-filterbar__reset {
+  background: none;
+  border: none;
+  font: inherit;
+  font-size: 0.75rem;
+  color: var(--k-text-muted);
+  cursor: pointer;
+  text-decoration: underline;
+}
+.k-filterbar__reset:hover { color: var(--k-text); }
+</style>

package/src/components/KIcon.vue

@@ -0,0 +1,53 @@
+<script setup>
+/**
+ * KIcon — единственная точка входа для иконок кита.
+ *
+ * Оборачивает Lucide (https://lucide.dev, ISC). Компоненты и приложения
+ * ссылаются на иконку по *семантическому* имени ("delete", "settings"), а не
+ * по форме, поэтому набор можно заменить в одном месте — см. icon-registry.js.
+ *
+ *   <KIcon name="settings" :size="16" />
+ *
+ * Иконку, которой нет в реестре, можно передать напрямую компонентом —
+ * так приложение расширяет набор, не форкая кит:
+ *
+ *   <KIcon :component="MyBrandIcon" />
+ */
+import { computed } from 'vue'
+import { iconRegistry } from './icon-registry.js'
+
+const props = defineProps({
+  name: { type: String, default: '' },
+  component: { type: [Object, Function], default: null },
+  size: { type: [Number, String], default: 18 },
+  strokeWidth: { type: [Number, String], default: 2 },
+  spin: { type: Boolean, default: false },
+})
+
+const resolved = computed(() => {
+  if (props.component) return props.component
+  const c = iconRegistry[props.name]
+  if (!c && props.name && import.meta.env?.DEV) {
+    console.warn(`[KIcon] неизвестная иконка "${props.name}" — добавьте её в icon-registry.js или передайте :component`)
+  }
+  return c || null
+})
+</script>
+
+<template>
+  <component
+    :is="resolved"
+    v-if="resolved"
+    class="k-icon"
+    :class="{ 'k-icon--spin': spin }"
+    :size="Number(size)"
+    :stroke-width="Number(strokeWidth)"
+    aria-hidden="true"
+  />
+</template>
+
+<style scoped>
+.k-icon { display: inline-block; vertical-align: -0.15em; flex-shrink: 0; }
+.k-icon--spin { animation: k-icon-spin 1s linear infinite; }
+@keyframes k-icon-spin { to { transform: rotate(360deg); } }
+</style>

package/src/components/KInput.vue

@@ -0,0 +1,108 @@
+<script setup>
+/**
+ * KInput — однострочное поле ввода с подписью, подсказкой и ошибкой.
+ *
+ * Метрики совпадают с KSelect и KButton, поэтому строка фильтров
+ * выравнивается без правок в приложении. Нативные атрибуты (autocomplete,
+ * inputmode, min, @blur, …) прокидываются на <input>.
+ *
+ *   <KInput v-model="query" label="Поиск" prefix-icon="search" :error="err" />
+ */
+import { computed, useAttrs } from 'vue'
+import KIcon from './KIcon.vue'
+
+defineOptions({ inheritAttrs: false })
+
+/*
+ * Атрибуты разделяются: class и style остаются на корне (иначе layout-классы
+ * из родителя не могут задать ширину поля в строке фильтров), остальное —
+ * autocomplete, inputmode, min, обработчики — уходит на сам контрол.
+ */
+const attrs = useAttrs()
+const rootAttrs = computed(() => ({ class: attrs.class, style: attrs.style }))
+const controlAttrs = computed(() => {
+  const { class: _c, style: _s, ...rest } = attrs
+  return rest
+})
+
+defineProps({
+  modelValue: { type: [String, Number], default: '' },
+  label: { type: String, default: '' },
+  placeholder: { type: String, default: '' },
+  type: { type: String, default: 'text' },
+  hint: { type: String, default: '' },
+  error: { type: String, default: '' },
+  prefixIcon: { type: String, default: '' },
+  suffix: { type: String, default: '' },
+  required: { type: Boolean, default: false },
+  disabled: { type: Boolean, default: false },
+  readonly: { type: Boolean, default: false },
+})
+
+defineEmits(['update:modelValue'])
+</script>
+
+<template>
+  <label class="k-input" v-bind="rootAttrs">
+    <span v-if="label" class="k-input__label">
+      {{ label }}<span v-if="required" class="k-input__req">*</span>
+    </span>
+    <span
+      class="k-input__box"
+      :class="{ 'k-input__box--error': error, 'k-input__box--disabled': disabled }"
+    >
+      <KIcon v-if="prefixIcon" :name="prefixIcon" :size="16" class="k-input__icon" />
+      <input
+        class="k-input__field"
+        :type="type"
+        :value="modelValue"
+        :placeholder="placeholder"
+        :required="required"
+        :disabled="disabled"
+        :readonly="readonly"
+        :aria-invalid="error ? 'true' : null"
+        v-bind="controlAttrs"
+        @input="$emit('update:modelValue', $event.target.value)"
+      />
+      <span v-if="suffix" class="k-input__suffix">{{ suffix }}</span>
+    </span>
+    <span v-if="error" class="k-input__error">{{ error }}</span>
+    <span v-else-if="hint" class="k-input__hint">{{ hint }}</span>
+  </label>
+</template>
+
+<style scoped>
+.k-input { display: flex; flex-direction: column; gap: 0.25rem; margin: 0; min-width: 0; }
+.k-input__label { font-size: 0.8125rem; color: var(--k-text-muted); }
+.k-input__req { color: var(--k-danger); margin-left: 2px; }
+.k-input__box {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  height: var(--k-control-h);
+  padding: 0 0.625rem;
+  background: var(--k-surface);
+  border: 1px solid var(--k-border-strong);
+  border-radius: var(--k-radius-sm);
+  transition: border-color 0.15s, box-shadow 0.15s;
+}
+.k-input__box:focus-within { border-color: var(--k-primary); box-shadow: 0 0 0 3px var(--k-primary-soft); }
+.k-input__box--error { border-color: var(--k-danger); }
+.k-input__box--error:focus-within { box-shadow: 0 0 0 3px var(--k-danger-soft); }
+.k-input__box--disabled { background: var(--k-surface-muted); }
+.k-input__icon { color: var(--k-text-faint); }
+.k-input__field {
+  flex: 1;
+  min-width: 0;
+  border: none;
+  background: none;
+  outline: none;
+  font: inherit;
+  font-size: 0.9375rem;
+  color: inherit;
+}
+.k-input__field:disabled { cursor: not-allowed; color: var(--k-text-muted); }
+.k-input__suffix { font-size: 0.875rem; color: var(--k-text-muted); white-space: nowrap; }
+.k-input__hint { font-size: 0.75rem; color: var(--k-text-muted); }
+.k-input__error { font-size: 0.75rem; color: var(--k-danger); }
+</style>

package/src/components/KMenuItem.vue

@@ -0,0 +1,56 @@
+<script setup>
+/**
+ * KMenuItem — пункт меню внутри KDropdown. Рендерится как <router-link>,
+ * если передан `to`, иначе как кнопка. Атрибут data-k-menu-item нужен
+ * дропдауну, чтобы закрыться после выбора.
+ */
+import KIcon from './KIcon.vue'
+
+defineProps({
+  icon: { type: String, default: '' },
+  to: { type: [String, Object], default: null },
+  danger: { type: Boolean, default: false },
+  disabled: { type: Boolean, default: false },
+})
+</script>
+
+<template>
+  <component
+    :is="to ? 'router-link' : 'button'"
+    :to="to"
+    :type="to ? null : 'button'"
+    class="k-menu-item"
+    :class="{ 'k-menu-item--danger': danger }"
+    :disabled="to ? null : disabled"
+    role="menuitem"
+    data-k-menu-item
+  >
+    <KIcon v-if="icon" :name="icon" :size="15" />
+    <span class="k-menu-item__label"><slot /></span>
+  </component>
+</template>
+
+<style scoped>
+.k-menu-item {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  width: 100%;
+  padding: 0.45rem 0.55rem;
+  background: none;
+  border: none;
+  border-radius: var(--k-radius-sm);
+  font: inherit;
+  font-size: 0.875rem;
+  color: var(--k-text);
+  text-align: left;
+  text-decoration: none;
+  cursor: pointer;
+}
+.k-menu-item:hover { background: var(--k-surface-muted); text-decoration: none; }
+.k-menu-item:focus-visible { outline: 2px solid var(--k-primary); outline-offset: -2px; }
+.k-menu-item:disabled { opacity: 0.5; cursor: not-allowed; }
+.k-menu-item--danger { color: var(--k-danger-strong); }
+.k-menu-item--danger:hover { background: var(--k-danger-soft); }
+.k-menu-item__label { flex: 1; min-width: 0; }
+</style>

package/src/components/KModal.vue

@@ -0,0 +1,136 @@
+<script setup>
+/**
+ * KModal — модальное окно на @zag-js/dialog: фокус-трап, блокировка скролла,
+ * закрытие по Esc и возврат фокуса. Открытие управляется v-model.
+ *
+ * Клик по фону по умолчанию не закрывает окно: случайный клик мимо формы не
+ * должен терять введённое. Включается пропом `close-on-outside`.
+ *
+ *   <KModal v-model="open" title="Новый документ" size="md">
+ *     <form @submit.prevent="save">…</form>
+ *     <template #footer><KButton variant="primary" @click="save">Сохранить</KButton></template>
+ *   </KModal>
+ */
+import * as dialog from '@zag-js/dialog'
+import { normalizeProps, useMachine } from '@zag-js/vue'
+import { computed, useId } from 'vue'
+import KIcon from './KIcon.vue'
+
+const props = defineProps({
+  modelValue: { type: Boolean, default: false },
+  title: { type: String, default: '' },
+  subtitle: { type: String, default: '' },
+  size: { type: String, default: 'md' }, // sm | md | lg
+  closable: { type: Boolean, default: true },
+  closeOnOutside: { type: Boolean, default: false },
+})
+
+const emit = defineEmits(['update:modelValue', 'close'])
+
+const service = useMachine(dialog.machine, {
+  id: useId(),
+  get open() {
+    return props.modelValue
+  },
+  get closeOnInteractOutside() {
+    return props.closeOnOutside && props.closable
+  },
+  get closeOnEscape() {
+    return props.closable
+  },
+  onOpenChange({ open }) {
+    emit('update:modelValue', open)
+    if (!open) emit('close')
+  },
+})
+
+const api = computed(() => dialog.connect(service, normalizeProps))
+</script>
+
+<template>
+  <Teleport to="body">
+    <template v-if="api.open">
+      <div class="k-modal__backdrop" v-bind="api.getBackdropProps()" />
+      <div class="k-modal__positioner" v-bind="api.getPositionerProps()">
+        <div class="k-modal__panel" :class="`k-modal__panel--${size}`" v-bind="api.getContentProps()">
+          <header v-if="title || $slots.header" class="k-modal__header">
+            <div class="k-modal__heading">
+              <slot name="header">
+                <h2 class="k-modal__title" v-bind="api.getTitleProps()">{{ title }}</h2>
+                <p v-if="subtitle" class="k-modal__subtitle" v-bind="api.getDescriptionProps()">{{ subtitle }}</p>
+              </slot>
+            </div>
+            <button v-if="closable" class="k-modal__close" aria-label="Закрыть" v-bind="api.getCloseTriggerProps()">
+              <KIcon name="close" :size="18" />
+            </button>
+          </header>
+          <div class="k-modal__body"><slot /></div>
+          <footer v-if="$slots.footer" class="k-modal__footer"><slot name="footer" /></footer>
+        </div>
+      </div>
+    </template>
+  </Teleport>
+</template>
+
+<style scoped>
+.k-modal__backdrop {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  background: var(--k-overlay);
+  backdrop-filter: blur(2px);
+}
+.k-modal__positioner {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 1rem;
+}
+.k-modal__panel {
+  width: min(92vw, var(--k-modal-w, 34rem));
+  max-height: 86vh;
+  display: flex;
+  flex-direction: column;
+  background: var(--k-surface);
+  border-radius: var(--k-radius-lg);
+  box-shadow: var(--k-shadow-lg);
+  overflow: hidden;
+  outline: none;
+}
+.k-modal__panel--sm { --k-modal-w: 24rem; }
+.k-modal__panel--md { --k-modal-w: 34rem; }
+.k-modal__panel--lg { --k-modal-w: 52rem; }
+.k-modal__header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1.125rem 1.25rem;
+  border-bottom: 1px solid var(--k-border);
+}
+.k-modal__title { font-size: 1.0625rem; font-weight: 600; }
+.k-modal__subtitle { margin-top: 0.15rem; font-size: 0.8125rem; color: var(--k-text-muted); }
+.k-modal__close {
+  background: none;
+  border: none;
+  color: var(--k-text-muted);
+  cursor: pointer;
+  padding: 0.15rem;
+  border-radius: var(--k-radius-sm);
+  flex: none;
+}
+.k-modal__close:hover { background: var(--k-surface-muted); color: var(--k-text); }
+.k-modal__body { padding: 1.25rem; overflow-y: auto; }
+.k-modal__footer {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 0.5rem;
+  padding: 0.875rem 1.25rem;
+  border-top: 1px solid var(--k-border);
+  background: var(--k-surface-muted);
+}
+</style>

package/src/components/KMoney.vue

@@ -0,0 +1,44 @@
+<script setup>
+/**
+ * KMoney — денежная сумма в русском формате.
+ *
+ * Вынесено в компонент, потому что суммы обычно встречаются на многих экранах
+ * и должны выглядеть одинаково: неразрывные разряды, символ валюты,
+ * опциональные копейки, табличные цифры для выравнивания в колонке.
+ */
+import { computed } from 'vue'
+
+const props = defineProps({
+  value: { type: [Number, String], default: 0 },
+  currency: { type: String, default: 'RUB' },
+  fraction: { type: Boolean, default: false },
+  compact: { type: Boolean, default: false },
+  tone: { type: String, default: '' }, // '' | muted | success | danger
+  size: { type: String, default: 'md' }, // sm | md | lg
+})
+
+const formatted = computed(() => {
+  const n = Number(props.value)
+  if (!Number.isFinite(n)) return '—'
+  return new Intl.NumberFormat('ru-RU', {
+    style: 'currency',
+    currency: props.currency,
+    minimumFractionDigits: props.fraction ? 2 : 0,
+    maximumFractionDigits: props.fraction ? 2 : 0,
+    notation: props.compact ? 'compact' : 'standard',
+  }).format(n)
+})
+</script>
+
+<template>
+  <span class="k-money" :class="[tone && `k-money--${tone}`, `k-money--${size}`]">{{ formatted }}</span>
+</template>
+
+<style scoped>
+.k-money { font-variant-numeric: tabular-nums; white-space: nowrap; }
+.k-money--sm { font-size: 0.8125rem; }
+.k-money--lg { font-size: 1.25rem; font-weight: 650; letter-spacing: -0.01em; }
+.k-money--muted { color: var(--k-text-muted); }
+.k-money--success { color: var(--k-success); }
+.k-money--danger { color: var(--k-danger); }
+</style>

package/src/components/KPage.vue

@@ -0,0 +1,93 @@
+<script setup>
+/**
+ * KPage — стандартная обвязка экрана: хлебные крошки, заголовок, действия
+ * справа и контент. Используйте как корень каждого маршрута, чтобы отступы и
+ * расположение кнопок не разъезжались между страницами.
+ */
+import KIcon from './KIcon.vue'
+
+defineProps({
+  title: { type: String, default: '' },
+  subtitle: { type: String, default: '' },
+  // [{ label, to? }] — последний элемент отрисуется как текущий, без ссылки
+  breadcrumbs: { type: Array, default: () => [] },
+  back: { type: [String, Object], default: null },
+  width: { type: String, default: 'wide' }, // wide | narrow | full
+})
+</script>
+
+<template>
+  <div class="k-page" :class="`k-page--${width}`">
+    <nav v-if="breadcrumbs.length" class="k-page__crumbs" aria-label="Хлебные крошки">
+      <template v-for="(crumb, i) in breadcrumbs" :key="i">
+        <component
+          :is="crumb.to && i < breadcrumbs.length - 1 ? 'router-link' : 'span'"
+          :to="crumb.to"
+          class="k-page__crumb"
+          :class="{ 'k-page__crumb--current': i === breadcrumbs.length - 1 }"
+        >{{ crumb.label }}</component>
+        <KIcon v-if="i < breadcrumbs.length - 1" name="chevron-right" :size="13" class="k-page__crumb-sep" />
+      </template>
+    </nav>
+
+    <header class="k-page__header">
+      <div class="k-page__heading">
+        <router-link v-if="back" :to="back" class="k-page__back" aria-label="Назад">
+          <KIcon name="back" :size="18" />
+        </router-link>
+        <div class="k-page__titles">
+          <div class="k-page__title-row">
+            <slot name="title"><h1>{{ title }}</h1></slot>
+            <slot name="title-extra" />
+          </div>
+          <p v-if="subtitle" class="k-page__subtitle">{{ subtitle }}</p>
+        </div>
+      </div>
+      <div v-if="$slots.actions" class="k-page__actions"><slot name="actions" /></div>
+    </header>
+
+    <slot />
+  </div>
+</template>
+
+<style scoped>
+.k-page { padding: 1.75rem 2rem 3rem; margin: 0 auto; width: 100%; }
+.k-page--wide { max-width: 1360px; }
+.k-page--narrow { max-width: 880px; }
+.k-page__crumbs { display: flex; align-items: center; gap: 0.3rem; margin-bottom: 0.6rem; font-size: 0.8125rem; }
+.k-page__crumb { color: var(--k-text-muted); text-decoration: none; }
+.k-page__crumb:hover { color: var(--k-primary); }
+.k-page__crumb--current { color: var(--k-text); }
+.k-page__crumb-sep { color: var(--k-text-faint); }
+.k-page__header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 1rem;
+  margin-bottom: 1.5rem;
+}
+.k-page__heading { display: flex; align-items: flex-start; gap: 0.625rem; min-width: 0; }
+.k-page__back {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  margin-top: 0.15rem;
+  border: 1px solid var(--k-border);
+  border-radius: var(--k-radius-sm);
+  background: var(--k-surface);
+  color: var(--k-text-muted);
+  flex: none;
+}
+.k-page__back:hover { background: var(--k-surface-muted); color: var(--k-text); }
+.k-page__titles { min-width: 0; }
+.k-page__title-row { display: flex; align-items: center; gap: 0.6rem; flex-wrap: wrap; }
+.k-page__subtitle { margin-top: 0.25rem; font-size: 0.875rem; color: var(--k-text-muted); }
+.k-page__actions { display: flex; align-items: center; gap: 0.5rem; flex: none; flex-wrap: wrap; justify-content: flex-end; }
+
+@media (max-width: 720px) {
+  .k-page { padding: 1.25rem 1rem 2.5rem; }
+  .k-page__header { flex-direction: column; align-items: stretch; }
+}
+</style>