@krometra/ui-kit 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krometra/ui-kit",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "UI-kit на Vue 3 со сменными темами, светлой и тёмной схемой; интерактивные компоненты на zag.js",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,7 @@
     "vue": "^3.4.0"
   },
   "dependencies": {
+    "@krometra/easy-data-scroll": "^0.2.0",
     "@zag-js/checkbox": "^1.43.3",
     "@zag-js/combobox": "^1.43.3",
     "@zag-js/dialog": "^1.43.3",

package/src/components/KVirtualList.vue

@@ -0,0 +1,79 @@
+<script setup>
+/**
+ * KVirtualList — длинный список без прыжков на @krometra/easy-data-scroll: в DOM
+ * только строки у экрана, высота строк любая и заранее не нужна. Подгрузка,
+ * картинки, новые строки сверху и снизу не сдвигают то, что читают.
+ *
+ * Пропсы и события — те же, что у InfinityScroll из пакета. Режим выбирается
+ * загрузчиком:
+ *   бесконечный: load-before / load-after (крайний элемент) => массив или { items, done }
+ *   виртуальный: load-range(from, to) => массив или { items, total }, плюс total
+ *
+ *   <KVirtualList :get-key="m => m.id" :load-range="load" :total="total" origin="bottom" height="32rem">
+ *     <template #default="{ item }">…</template>
+ *   </KVirtualList>
+ *
+ * origin="bottom" — чат: начинается снизу и прилипает к низу. Методы (append,
+ * prepend, update, remove, reset, scrollToKey, scrollToIndex, scrollToTop,
+ * scrollToBottom) и сам экземпляр (list) — через ref.
+ */
+import { InfinityScroll } from '@krometra/easy-data-scroll/vue'
+import { computed, useTemplateRef } from 'vue'
+
+const props = defineProps({
+  height: { type: String, default: '' },
+  bordered: { type: Boolean, default: false },
+})
+
+const inner = useTemplateRef('inner')
+const style = computed(() => (props.height ? { height: props.height } : null))
+
+const call = (name) => (...args) => inner.value?.[name](...args)
+
+defineExpose({
+  get list() {
+    return inner.value?.list
+  },
+  append: call('append'),
+  prepend: call('prepend'),
+  update: call('update'),
+  remove: call('remove'),
+  reset: call('reset'),
+  scrollToKey: call('scrollToKey'),
+  scrollToIndex: call('scrollToIndex'),
+  indexOfKey: call('indexOfKey'),
+  scrollToTop: call('scrollToTop'),
+  scrollToBottom: call('scrollToBottom'),
+})
+</script>
+
+<template>
+  <InfinityScroll
+    ref="inner"
+    class="k-virtual-list"
+    :class="{ 'k-virtual-list--bordered': bordered }"
+    :style="style"
+  >
+    <template #default="{ item }">
+      <slot :item="item" />
+    </template>
+  </InfinityScroll>
+</template>
+
+<style scoped>
+.k-virtual-list {
+  --eds-loader-color: var(--k-primary);
+  --eds-loader-bg: var(--k-surface-muted);
+  --eds-gap-color: var(--k-border);
+  --eds-gap-inset: 1rem;
+  --eds-gap-pad: 0.375rem;
+  min-height: 0;
+  color: var(--k-text);
+}
+.k-virtual-list--bordered {
+  background: var(--k-surface);
+  border: 1px solid var(--k-border);
+  border-radius: var(--k-radius);
+  overflow: hidden;
+}
+</style>

package/src/index.js

@@ -53,13 +53,14 @@ import KTextarea from './components/KTextarea.vue'
 import KTimeline from './components/KTimeline.vue'
 import KToast from './components/KToast.vue'
 import KTooltip from './components/KTooltip.vue'
+import KVirtualList from './components/KVirtualList.vue'
 
 export {
   KAlert, KAvatar, KBadge, KButton, KCard, KCheckbox, KChip, KCombobox, KCountdown,
   KDescriptions, KDrawer, KDropdown, KEmpty, KFileUpload, KFilterBar, KGantt, KIcon,
   KInput, KMenuItem, KModal, KMoney, KPage, KPagination, KProgress,
   KRadioGroup, KSegmented, KSelect, KShell, KStat, KSteps, KSwitch, KTable,
-  KTabs, KTextarea, KTimeline, KToast, KTooltip,
+  KTabs, KTextarea, KTimeline, KToast, KTooltip, KVirtualList,
 }
 
 export { iconNames, iconRegistry, registerIcons } from './components/icon-registry.js'
@@ -75,7 +76,7 @@ const components = {
   KDescriptions, KDrawer, KDropdown, KEmpty, KFileUpload, KFilterBar, KGantt, KIcon,
   KInput, KMenuItem, KModal, KMoney, KPage, KPagination, KProgress,
   KRadioGroup, KSegmented, KSelect, KShell, KStat, KSteps, KSwitch, KTable,
-  KTabs, KTextarea, KTimeline, KToast, KTooltip,
+  KTabs, KTextarea, KTimeline, KToast, KTooltip, KVirtualList,
 }
 
 export default {