@v1nt1248/3nclient-lib 0.3.8 → 0.3.11

package/dist/utils/copy-to-clipboard.d.ts

@@ -0,0 +1 @@
+export declare function copyToClipboard(text: string): Promise<void>;

package/dist/utils/execute-function.d.ts

@@ -0,0 +1,29 @@
+export type ExtractArgs<F> = F extends (signal: AbortSignal, ...args: infer P) => any ? P : F extends (...args: infer P) => any ? P : never;
+export interface ExecuteFnBaseProps<F extends (...args: any[]) => any, V> {
+    fn: F;
+    fnArgs: ExtractArgs<F>;
+    timeoutValue?: number;
+    retryCount?: number;
+    retryDelay?: number;
+    errorText?: string;
+    actionIfError?: (err?: unknown) => void;
+    actionIfSuccess?: () => void;
+    actionInFinally?: () => void;
+}
+export interface ExecuteFunctionPropsNoCatchError<F extends (...args: any[]) => any, V = Awaited<ReturnType<F>>> extends ExecuteFnBaseProps<F, V> {
+    doesErrorPropagateStop: true;
+    defaultValue: V;
+}
+export interface ExecuteFunctionPropsCatchError<F extends (...args: any[]) => any, V = Awaited<ReturnType<F>>> extends ExecuteFnBaseProps<F, V> {
+    doesErrorPropagateStop?: false;
+    defaultValue?: undefined;
+}
+export type ExecuteFunctionProps<F extends (...args: any[]) => any, V = Awaited<ReturnType<F>>> = ExecuteFunctionPropsCatchError<F, V> | ExecuteFunctionPropsNoCatchError<F, V>;
+export declare class ExecuteFunctionError extends Error {
+    cause: unknown;
+    constructor(message: string, data?: {
+        cause?: unknown;
+        fnArgs?: unknown[];
+    });
+}
+export declare function executeFunc<F extends (...args: any[]) => any, V = Awaited<ReturnType<F>>>(props: ExecuteFunctionProps<F, V>): Promise<V>;

package/dist/utils/index.d.ts

@@ -8,6 +8,9 @@ export * from './round';
 export * from './get-random-id';
 export * from './textarea-max-rows';
 export * from './for-web3n';
+export * from './copy-to-clipboard';
+export * from './execute-function';
+export * from './remove-whitespace-in-string';
 export * from './ui/selection';
 export * from './ui/mark-search';
 export * from './ui/has-slot-content';

package/dist/utils/remove-whitespace-in-string.d.ts

@@ -0,0 +1 @@
+export declare function removeWhitespaceInString(str: string): string;

package/dist/utils/ui/get-element-color.d.ts

@@ -1 +1 @@
-export declare function getElementColor(initials?: string): string;
+export declare function generateColor(str: string): string;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@v1nt1248/3nclient-lib",
   "license": "AGPL-3.0-or-later",
   "author": "v1nt1248",
-  "version": "0.3.8",
+  "version": "0.3.11",
   "description": "Library for 3NWeb clients",
   "type": "module",
   "files": [
@@ -51,63 +51,66 @@
     "docs:preview": "vitepress preview docs"
   },
   "dependencies": {
-    "@floating-ui/dom": "^1.7.6",
+    "@floating-ui/dom": "1.7.6",
     "@floating-ui/vue": "1.1.11",
     "dayjs": "1.11.20",
-    "lodash": "4.17.23",
+    "lodash": "4.18.1",
     "mitt": "3.0.1",
-    "sanitize-html": "2.17.1",
+    "sanitize-html": "2.17.3",
     "vuedraggable": "4.1.0"
   },
   "peerDependencies": {
     "pinia": "3.0.4",
-    "vue": "3.5.30"
+    "vue": "3.5.33"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.3.5",
-    "@eslint/js": "^9.39.1",
+    "@eslint/eslintrc": "3.3.5",
+    "@eslint/js": "10.0.1",
     "@types/lodash": "4.17.24",
-    "@types/node": "22.19.15",
+    "@types/node": "24.12.2",
     "@types/sanitize-html": "2.16.1",
-    "@typescript-eslint/eslint-plugin": "8.57.1",
-    "@typescript-eslint/parser": "8.57.1",
-    "@vitejs/plugin-vue": "6.0.5",
-    "@vue/compiler-core": "3.5.30",
+    "@typescript-eslint/eslint-plugin": "8.59.0",
+    "@typescript-eslint/parser": "8.59.0",
+    "@vitejs/plugin-vue": "6.0.6",
+    "@vue/compiler-core": "3.5.33",
     "@vue/eslint-config-typescript": "14.7.0",
-    "@vue/runtime-core": "3.5.30",
+    "@vue/runtime-core": "3.5.33",
     "@vuedx/typescript-plugin-vue": "0.7.6",
-    "eslint": "9.39.4",
+    "eslint": "10.2.1",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-import": "2.32.0",
     "eslint-plugin-node": "11.1.0",
     "eslint-plugin-prettier": "5.5.5",
     "eslint-plugin-promise": "7.2.1",
-    "eslint-plugin-vue": "10.8.0",
-    "globals": "17.4.0",
+    "eslint-plugin-vue": "10.9.0",
+    "globals": "17.5.0",
     "jackspeak": "4.2.3",
     "path": "0.12.7",
     "pinia": "3.0.4",
     "postcss-html": "1.8.1",
-    "prettier": "3.8.1",
-    "sass": "1.98.0",
-    "stylelint": "17.4.0",
-    "stylelint-config-recommended-scss": "17.0.0",
+    "prettier": "3.8.3",
+    "sass": "1.99.0",
+    "shiki": "^4.0.2",
+    "stylelint": "17.9.0",
+    "stylelint-config-recommended-scss": "17.0.1",
     "stylelint-config-recommended-vue": "1.6.1",
     "stylelint-config-standard": "39.0.1",
     "stylelint-scss": "7.0.0",
     "tslib": "2.8.1",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.57.1",
-    "vite": "8.0.0",
+    "typescript-eslint": "8.59.0",
+    "vite": "8.0.10",
     "vite-plugin-css-injected-by-js": "4.0.1",
     "vite-plugin-dts": "4.5.4",
-    "vite-plugin-vue-devtools": "8.1.0",
+    "vite-plugin-vue-devtools": "8.1.1",
     "vitepress": "1.6.4",
-    "vue": "3.5.30",
+    "vue": "3.5.33",
+    "vue-component-meta": "3.2.7",
+    "vue-docgen-api": "4.79.2",
     "vue-eslint-parser": "10.4.0",
-    "vue-tsc": "3.2.5"
+    "vue-tsc": "3.2.7"
   },
-  "packageManager": "pnpm@10.32.1",
+  "packageManager": "pnpm@10.33.0",
   "pnpm": {
     "peerDependencyRules": {
       "ignoreMissing": [

package/src/components/ui3n-autocomplete/types.ts

@@ -1,43 +1,143 @@
 import { VNode } from 'vue';
 
+/**
+ * Base autocomplete option interface
+ */
 export interface Ui3nAutocompleteOptionBase {
+  /**
+   * Option ID
+   */
   id: string;
+  /**
+   * Option name
+   */
   name?: string;
 }
 
+/**
+ * Autocomplete value type
+ */
 export type Ui3nAutocompleteValue<T extends Ui3nAutocompleteOptionBase> = {
   [Property in keyof T]: T[Property];
 };
 
+/**
+ * Autocomplete component properties
+ */
 export interface Ui3nAutocompleteProps<T extends Ui3nAutocompleteOptionBase> {
+  /**
+   * Whether to show chips
+   * @default false
+   */
   chips?: boolean;
+  /**
+   * Whether to clear input on select
+   * @default false
+   */
   clearOnSelect?: boolean;
+  /**
+   * Custom filter function
+   */
   customFilter?: (value: T, query: string) => boolean;
+  /**
+   * Whether autocomplete is disabled
+   * @default false
+   */
   disabled?: boolean;
+  /**
+   * Filter keys
+   */
   filterKeys?: string[];
+  /**
+   * Whether to hide selected items
+   * @default false
+   */
   hideSelected?: boolean;
+  /**
+   * Items to display
+   */
   items: T[];
+  /**
+   * Property to use as title
+   */
   itemTitle?: keyof T;
+  /**
+   * Property to use as value
+   */
   itemValue?: keyof T;
+  /**
+   * Current autocomplete value
+   */
   modelValue: T[] | Array<T[keyof T]>;
+  /**
+   * Whether to allow adding new values
+   * @default false
+   */
   addNewValue?: boolean;
+  /**
+   * New value validator function
+   */
   newValueValidator?: (value: string) => boolean;
+  /**
+   * Whether to allow multiple selection
+   * @default false
+   */
   multiple?: boolean;
+  /**
+   * Text to show when no data
+   */
   noDataText?: string;
+  /**
+   * Placeholder text
+   */
   placeholder?: string;
+  /**
+   * Whether to return the whole object or just the value
+   * @default false
+   */
   returnObject?: boolean;
 }
 
+/**
+ * Autocomplete component emits
+ */
 export interface Ui3nAutocompleteEmits<T extends Ui3nAutocompleteOptionBase> {
+  /**
+   * Emitted when model value updates
+   */
   (event: 'update:modelValue', value: T[] | Array<T[keyof T]>): void;
+  /**
+   * Emitted when search value updates
+   */
   (event: 'update:search', value: string): void;
+  /**
+   * Emitted when focused state updates
+   */
   (event: 'update:focused', value: boolean): void;
+  /**
+   * Emitted when new value validation status updates
+   */
   (event: 'valid:new-value', value: boolean): void;
 }
 
+/**
+ * Autocomplete component slots
+ */
 export interface Ui3nAutocompleteSlots<T extends Ui3nAutocompleteOptionBase> {
+  /**
+   * Item slot
+   */
   item: (props: { item: T; index: number; query?: string }) => VNode;
+  /**
+   * Chip slot
+   */
   chip: (props: { item: T | T[keyof T]; index: number }) => VNode;
+  /**
+   * No data text slot
+   */
   noDataText: () => VNode;
+  /**
+   * Selection slot
+   */
   selection: (props: { value: T[] | Array<T[keyof T]> }) => VNode;
 }

package/src/components/ui3n-badge/types.ts

@@ -1,14 +1,30 @@
+import type { VNode } from 'vue';
+
 export interface Ui3nBadgeSimpleProps {
+  /** For simple display as a circle */
   dot?: boolean;
+  /** Text displayed inside the circle */
   value?: string | number;
+  /** Background color */
   color?: string;
+  /** Text color  */
   textColor?: string;
 }
 
 export interface Ui3nBadgeProps {
+  /** For simple display as a circle */
   dot?: boolean;
+  /** Text displayed inside the circle */
   value?: string | number;
+  /** Background color */
   color?: string;
+  /** Text color  */
   textColor?: string;
+  /** Positioning of the circle */
   position?: 'right-top' | 'right-bottom' | 'left-top' | 'left-bottom';
 }
+
+export interface Ui3nBadgeSlots {
+  /** Default slot */
+  default: () => VNode;
+}

package/src/components/ui3n-badge/ui3n-badge-simple.vue

@@ -18,6 +18,15 @@ const emits = defineEmits<{
 
 const element = ref<HTMLDivElement | null>(null);
 
+function getElementSize() {
+  nextTick(() => {
+    if (element.value) {
+      emits('change:size', { width: element.value.offsetWidth, height: element.value.offsetHeight });
+    }
+  });
+}
+  
+
 watch(
   () => [props.value, props.dot],
   () => getElementSize(),
@@ -26,14 +35,6 @@ watch(
 onMounted(() => {
   getElementSize();
 });
-
-function getElementSize() {
-  nextTick(() => {
-    if (element.value) {
-      emits('change:size', { width: element.value.offsetWidth, height: element.value.offsetHeight });
-    }
-  });
-}
 </script>
 
 <template>
@@ -57,7 +58,7 @@ function getElementSize() {
   position: relative;
   box-sizing: border-box;
   background-color: v-bind(color);
-  outline: 1px var(--white-100) solid;
+  outline: 1px var(--color-bg-block-primary-default)solid;
 
   &:not(.ui3nBadgeDot) {
     min-height: var(--ui3n-badge-size);

package/src/components/ui3n-badge/ui3n-badge.vue

@@ -1,36 +1,37 @@
 <script lang="ts" setup>
-import { computed, ref, useSlots } from 'vue';
-import get from 'lodash/get';
-import Ui3nBadgeSimple from './ui3n-badge-simple.vue';
-import type { Ui3nBadgeProps } from './types';
+  import { computed, ref, useSlots } from 'vue';
+  import get from 'lodash/get';
+  import Ui3nBadgeSimple from './ui3n-badge-simple.vue';
+  import type { Ui3nBadgeProps, Ui3nBadgeSlots } from './types';
 
-const props = withDefaults(
-  defineProps<Ui3nBadgeProps>(),
-  {
+  const props = withDefaults(defineProps<Ui3nBadgeProps>(), {
     dot: false,
     value: '',
     color: 'var(--color-bg-button-primary-default)',
     textColor: 'var(--color-text-button-primary-default)',
     position: 'right-top',
-  },
-);
+  });
+  defineSlots<Ui3nBadgeSlots>();
 
-const slots = useSlots();
-const badgeElementSize = ref<{
-  width: number;
-  height: number;
-} | never>();
+  const slots = useSlots();
+  const badgeElementSize = ref<
+    | {
+        width: number;
+        height: number;
+      }
+    | never
+  >();
 
-const hasDefaultSlot = computed(() => !!slots.default);
-const style = computed(() => {
-  const [xPosition, yPosition] = props.position.split('-');
-  return {
-    ...(xPosition === 'right' && { right: `-${get(badgeElementSize.value, 'width', 0) / 2}px` }),
-    ...(xPosition === 'left' && { left: `-${get(badgeElementSize.value, 'width', 0) / 2}px` }),
-    ...(yPosition === 'top' && { top: `-${get(badgeElementSize.value, 'height', 0) / 2}px` }),
-    ...(yPosition === 'bottom' && { bottom: `-${get(badgeElementSize.value, 'height', 0) / 2}px` }),
-  };
-});
+  const hasDefaultSlot = computed(() => !!slots.default);
+  const style = computed(() => {
+    const [xPosition, yPosition] = props.position.split('-');
+    return {
+      ...(xPosition === 'right' && { right: `-${get(badgeElementSize.value, 'width', 0) / 2}px` }),
+      ...(xPosition === 'left' && { left: `-${get(badgeElementSize.value, 'width', 0) / 2}px` }),
+      ...(yPosition === 'top' && { top: `-${get(badgeElementSize.value, 'height', 0) / 2}px` }),
+      ...(yPosition === 'bottom' && { bottom: `-${get(badgeElementSize.value, 'height', 0) / 2}px` }),
+    };
+  });
 </script>
 
 <template>
@@ -64,19 +65,19 @@ const style = computed(() => {
 </template>
 
 <style lang="scss" module>
-.ui3nBadge {
-  --ui3n-badge-size: 20px;
+  .ui3nBadge {
+    --ui3n-badge-size: 20px;
 
-  position: relative;
-}
+    position: relative;
+  }
 
-.ui3nBadgeWrapper {
-  position: relative;
-  width: max-content;
-}
+  .ui3nBadgeWrapper {
+    position: relative;
+    width: max-content;
+  }
 
-.ui3nBadgeContent {
-  position: absolute;
-  z-index: 5;
-}
+  .ui3nBadgeContent {
+    position: absolute;
+    z-index: 5;
+  }
 </style>

package/src/components/ui3n-breadcrumbs/types.ts

@@ -1,21 +1,72 @@
 import { VNode } from 'vue';
 
+/**
+ * Breadcrumb component properties
+ */
 export interface Ui3nBreadcrumbProps {
+  /**
+   * Separator between breadcrumbs
+   * @default '/'
+   */
   separator?: string | undefined;
+  /**
+   * Whether the breadcrumb is active
+   * @default false
+   */
   isActive?: boolean;
+  /**
+   * Whether the breadcrumb is disabled
+   * @default false
+   */
   disabled?: boolean;
 }
 
+/**
+ * Breadcrumb component emits
+ */
 export interface Ui3nBreadcrumbEmits {
+  /**
+   * Called when the breadcrumb is clicked
+   */
   (ev: 'click', value: Event): void;
 }
 
+/**
+ * Breadcrumb component slots
+ */
 export interface Ui3nBreadcrumbSlots {
+  /**
+   * Separator slot
+   */
   separator: () => VNode;
+  /**
+   * Default slot
+   */
   default: () => VNode;
 }
 
+/**
+ * Breadcrumbs component properties
+ */
 export interface Ui3nBreadcrumbsProps {
+  /**
+   * Separator between breadcrumbs
+   * @default '/'
+   */
   separator?: string;
+  /**
+   * Whether the breadcrumbs are disabled
+   * @default false
+   */
   disabled?: boolean;
 }
+
+/**
+ * Breadcrumbs component slots
+ */
+export interface Ui3nBreadcrumbsSlots {
+  /**
+   * Default slot
+   */
+  default: () => VNode;
+}