cynx-lib 1.3.69 → 1.3.70

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cynx-lib",
-  "version": "1.3.69",
+  "version": "1.3.70",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",

package/vue/components/CircularProgress.vue

@@ -0,0 +1,383 @@
+<script setup lang="ts">
+import { computed, ref, onMounted, onBeforeUnmount, watch } from "vue";
+
+const SIZES: Record<string, { svg: number; stroke: number; fontSize: string }> = {
+  xs: { svg: 48, stroke: 4, fontSize: ".7rem" },
+  sm: { svg: 64, stroke: 5, fontSize: ".85rem" },
+  md: { svg: 80, stroke: 6, fontSize: "1rem" },
+  lg: { svg: 100, stroke: 7, fontSize: "1.15rem" },
+  xl: { svg: 120, stroke: 8, fontSize: "1.3rem" },
+};
+
+export interface CircularSegment {
+  value: number;
+  color?: string;
+  label?: string;
+}
+
+const props = withDefaults(
+  defineProps<{
+    value?: number;
+    segments?: CircularSegment[];
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    customSize?: number;
+    color?: string;
+    trackColor?: string;
+    label?: string;
+    centerText?: string | number;
+    showPercent?: boolean;
+    animated?: boolean;
+    rounded?: boolean;
+    indeterminate?: boolean;
+    speed?: number;
+    strokeWidth?: number;
+    gap?: number;
+    className?: string;
+    style?: Record<string, any>;
+  }>(),
+  {
+    value: 0,
+    size: "md",
+    color: "var(--blue, #2782e4)",
+    trackColor: "var(--bd2, #e0e0e4)",
+    label: "",
+    showPercent: true,
+    animated: true,
+    rounded: true,
+    indeterminate: false,
+    speed: 1,
+    gap: 4,
+    className: "",
+    style: () => ({}),
+  }
+);
+
+const base = computed(() => SIZES[props.size] || SIZES.md);
+const svg = computed(() => props.customSize || base.value.svg);
+const stroke = computed(() =>
+  props.strokeWidth ??
+  (props.customSize ? Math.max(3, svg.value * 0.06) : base.value.stroke)
+);
+const fontSize = computed(() =>
+  props.customSize
+    ? `${Math.max(11, svg.value * 0.13)}px`
+    : base.value.fontSize
+);
+const cx = computed(() => svg.value / 2);
+const cy = computed(() => svg.value / 2);
+const r = computed(() => (svg.value - stroke.value) / 2);
+const c = computed(() => 2 * Math.PI * r.value);
+const pct = computed(() => Math.min(100, Math.max(0, props.value || 0)));
+const BIG = computed(() => c.value * 4);
+const isRounded = computed(() => props.rounded !== false);
+const cap = computed(() => (isRounded.value ? "round" : "butt"));
+
+const userGap = computed(() =>
+  props.gap !== undefined
+    ? props.gap
+    : isRounded.value
+    ? c.value * 0.05
+    : c.value * 0.03
+);
+const capOverrun = computed(() => (isRounded.value ? stroke.value : 0));
+const gapSize = computed(() => userGap.value + capOverrun.value);
+const total = computed(() => c.value - 2 * gapSize.value);
+
+const isFull = computed(() => pct.value >= 100);
+const isEmpty = computed(() => pct.value <= 0);
+
+const hasSegments = computed(
+  () => Array.isArray(props.segments) && props.segments.length > 0
+);
+const rawSum = computed(() =>
+  hasSegments.value
+    ? props.segments!.reduce((sum, s) => sum + (Number(s.value) || 0), 0)
+    : 0
+);
+
+const indDash = computed(() => {
+  if (isEmpty.value) return `0,${BIG.value}`;
+  if (isFull.value) return `${c.value + stroke.value * 2},${BIG.value}`;
+  const activeLen = (pct.value / 100) * total.value;
+  return `${activeLen},${BIG.value}`;
+});
+
+const indOffset = computed(() => 0);
+
+const trackDash = computed(() => {
+  if (isEmpty.value) return `${c.value},${BIG.value}`;
+  if (isFull.value) return `0,${BIG.value}`;
+  const activeLen = (pct.value / 100) * total.value;
+  const inactiveLen = total.value - activeLen;
+  return `${inactiveLen},${BIG.value}`;
+});
+
+const trackOffset = computed(() => {
+  if (isEmpty.value || isFull.value) return 0;
+  const activeLen = (pct.value / 100) * total.value;
+  return -(activeLen + gapSize.value);
+});
+
+const indOpacity = computed(() => (isEmpty.value ? 0 : 1));
+
+const computedSegments = computed(() => {
+  if (!hasSegments.value || rawSum.value <= 0) return [];
+  const activeSegs = props.segments!.filter(
+    (seg) => (Number(seg.value) || 0) > 0
+  );
+  const segCount = activeSegs.length;
+  if (segCount === 0) return [];
+
+  const gapPx = props.gap !== undefined ? props.gap : 4;
+  const overrun = isRounded.value ? stroke.value : 0;
+  const gapArc = segCount > 1 ? gapPx + overrun : 0;
+  const availableC = Math.max(0, c.value - segCount * gapArc);
+
+  let accumulatedArc = isRounded.value ? stroke.value / 2 : 0;
+
+  return activeSegs.map((seg, idx) => {
+    const val = Number(seg.value) || 0;
+    const segLen = (val / rawSum.value) * availableC;
+    const currentOffset = accumulatedArc;
+    accumulatedArc += segLen + gapArc;
+
+    return {
+      key: idx,
+      val,
+      color: seg.color || props.color,
+      label: seg.label,
+      strokeDasharray: `${Math.max(0.1, segLen).toFixed(2)}, ${BIG.value}`,
+      strokeDashoffset: (-currentOffset).toFixed(2),
+    };
+  });
+});
+
+const gRef = ref<SVGGElement | null>(null);
+const indRef = ref<SVGCircleElement | null>(null);
+const trackRef = ref<SVGCircleElement | null>(null);
+let raf: number | null = null;
+
+const startIndeterminate = () => {
+  if (raf) cancelAnimationFrame(raf);
+  if (!props.indeterminate) return;
+
+  const capRad = (180 / Math.PI) * (stroke.value / r.value) / 2;
+  const gapRad = (180 / Math.PI) * (gapSize.value / r.value);
+  const gapArcLen = ((capRad + gapRad) / 360) * c.value;
+  let angle = -90;
+  let arcFrac = 0.45;
+  let arcDir = 1;
+  let lastTime = performance.now();
+
+  function tick(now: number) {
+    const dt = (now - lastTime) / 16.67;
+    lastTime = now;
+    angle = (angle + 3.6 * props.speed * dt) % 360;
+    arcFrac += 0.006 * arcDir * props.speed * dt;
+    if (arcFrac >= 0.72) {
+      arcFrac = 0.72;
+      arcDir = -1;
+    }
+    if (arcFrac <= 0.18) {
+      arcFrac = 0.18;
+      arcDir = 1;
+    }
+    const indLen = c.value * arcFrac;
+    const trackLen = Math.max(0, c.value - indLen - gapArcLen * 2);
+
+    if (gRef.value) gRef.value.style.transform = `rotate(${angle}deg)`;
+    if (indRef.value)
+      indRef.value.setAttribute("stroke-dasharray", `${indLen.toFixed(2)},9999`);
+    if (trackRef.value) {
+      trackRef.value.setAttribute(
+        "stroke-dasharray",
+        `${trackLen.toFixed(2)},9999`
+      );
+      trackRef.value.setAttribute(
+        "stroke-dashoffset",
+        `${(-(indLen + gapArcLen)).toFixed(2)}`
+      );
+    }
+    raf = requestAnimationFrame(tick);
+  }
+  raf = requestAnimationFrame(tick);
+};
+
+onMounted(() => {
+  if (props.indeterminate) startIndeterminate();
+});
+
+watch(
+  () => [props.indeterminate, props.speed, c.value, stroke.value, r.value, gapSize.value],
+  () => {
+    if (props.indeterminate) {
+      startIndeterminate();
+    } else if (raf) {
+      cancelAnimationFrame(raf);
+      raf = null;
+    }
+  }
+);
+
+onBeforeUnmount(() => {
+  if (raf) cancelAnimationFrame(raf);
+});
+</script>
+
+<template>
+  <div
+    :class="className"
+    :style="{
+      display: 'inline-flex',
+      flexDirection: 'column',
+      alignItems: 'center',
+      gap: '4px',
+      ...style,
+    }"
+  >
+    <div :style="{ position: 'relative', width: `${svg}px`, height: `${svg}px` }">
+      <svg
+        :width="svg"
+        :height="svg"
+        :viewBox="`0 0 ${svg} ${svg}`"
+      >
+        <template v-if="indeterminate">
+          <g ref="gRef" :style="{ transformOrigin: `${cx}px ${cy}px` }">
+            <circle
+              ref="trackRef"
+              :cx="cx"
+              :cy="cy"
+              :r="r"
+              fill="none"
+              :stroke="trackColor"
+              :stroke-width="stroke"
+              :stroke-linecap="cap"
+            />
+            <circle
+              ref="indRef"
+              :cx="cx"
+              :cy="cy"
+              :r="r"
+              fill="none"
+              :stroke="color"
+              :stroke-width="stroke"
+              :stroke-linecap="cap"
+            />
+          </g>
+        </template>
+
+        <template v-else-if="hasSegments">
+          <circle
+            v-if="rawSum <= 0 || computedSegments.length === 0"
+            :cx="cx"
+            :cy="cy"
+            :r="r"
+            fill="none"
+            :stroke="trackColor"
+            :stroke-width="stroke"
+          />
+          <template v-else>
+            <circle
+              v-for="seg in computedSegments"
+              :key="seg.key"
+              :cx="cx"
+              :cy="cy"
+              :r="r"
+              fill="none"
+              :stroke="seg.color"
+              :stroke-width="stroke"
+              :stroke-linecap="cap"
+              :stroke-dasharray="seg.strokeDasharray"
+              :stroke-dashoffset="seg.strokeDashoffset"
+              :style="{
+                transform: 'rotate(-90deg)',
+                transformOrigin: '50% 50%',
+                transition: animated
+                  ? 'stroke-dasharray .5s cubic-bezier(0.4,0,0.2,1), stroke-dashoffset .5s cubic-bezier(0.4,0,0.2,1)'
+                  : 'none',
+              }"
+            >
+              <title v-if="seg.label">{{ `${seg.label}: ${seg.val}` }}</title>
+            </circle>
+          </template>
+        </template>
+
+        <template v-else>
+          <circle
+            :cx="cx"
+            :cy="cy"
+            :r="r"
+            fill="none"
+            :stroke="trackColor"
+            :stroke-width="stroke"
+            :stroke-linecap="cap"
+            :stroke-dasharray="trackDash"
+            :stroke-dashoffset="trackOffset"
+            :style="{
+              transform: 'rotate(-90deg)',
+              transformOrigin: '50% 50%',
+              transition: animated
+                ? 'stroke-dasharray .5s cubic-bezier(0.4,0,0.2,1), stroke-dashoffset .5s cubic-bezier(0.4,0,0.2,1)'
+                : 'none',
+            }"
+          />
+          <circle
+            :cx="cx"
+            :cy="cy"
+            :r="r"
+            fill="none"
+            :stroke="color"
+            :stroke-width="stroke"
+            :stroke-linecap="cap"
+            :stroke-dasharray="indDash"
+            :stroke-dashoffset="indOffset"
+            :style="{
+              transform: 'rotate(-90deg)',
+              transformOrigin: '50% 50%',
+              opacity: indOpacity,
+              transition: animated
+                ? 'stroke-dasharray .5s cubic-bezier(0.4,0,0.2,1), opacity .2s'
+                : 'none',
+            }"
+          />
+        </template>
+      </svg>
+
+      <div
+        v-if="$slots.default || (showPercent && !indeterminate)"
+        :style="{
+          position: 'absolute',
+          inset: 0,
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'center',
+          fontSize: fontSize,
+          fontWeight: 600,
+          color: 'var(--primary-text, #0f172a)',
+          fontVariantNumeric: 'tabular-nums',
+        }"
+      >
+        <slot>
+          {{
+            centerText !== undefined
+              ? centerText
+              : hasSegments
+              ? rawSum
+              : `${Math.round(pct)}%`
+          }}
+        </slot>
+      </div>
+    </div>
+
+    <span
+      v-if="label"
+      :style="{
+        fontSize: '.6rem',
+        color: 'var(--muted, #797b8d)',
+        fontWeight: 500,
+      }"
+    >
+      {{ label }}
+    </span>
+  </div>
+</template>

package/vue/components/InfoBadge.vue

@@ -0,0 +1,223 @@
+<script setup lang="ts">
+import { computed, useSlots } from "vue";
+
+export interface InfoBadgeItem {
+  id?: string | number;
+  key?: string | number;
+  icon?: any;
+  label?: string | number;
+  value?: string | number;
+  color?: string;
+  title?: string;
+  dot?: boolean;
+  onClick?: (e: MouseEvent) => void;
+}
+
+const SIZES: Record<string, any> = {
+  xs: {
+    height: "24px",
+    padding: "0 8px",
+    fontSize: "10px",
+    iconSize: 12,
+    dotSize: ".65rem",
+    sepHeight: "10px",
+    gap: "6px",
+    borderRadius: "var(--radxs, 6px)",
+  },
+  sm: {
+    height: "28px",
+    padding: "0 10px",
+    fontSize: "11px",
+    iconSize: 13,
+    dotSize: ".7rem",
+    sepHeight: "12px",
+    gap: "8px",
+    borderRadius: "var(--rads, 8px)",
+  },
+  md: {
+    height: "32px",
+    padding: "0 12px",
+    fontSize: "12px",
+    iconSize: 14,
+    dotSize: ".75rem",
+    sepHeight: "14px",
+    gap: "10px",
+    borderRadius: "var(--rad, 10px)",
+  },
+  lg: {
+    height: "36px",
+    padding: "0 14px",
+    fontSize: "13px",
+    iconSize: 16,
+    dotSize: ".8rem",
+    sepHeight: "16px",
+    gap: "12px",
+    borderRadius: "var(--rad, 10px)",
+  },
+};
+
+const VARIANTS: Record<string, any> = {
+  default: {
+    background: "var(--surface, #ffffff)",
+    border: "1px solid var(--border, #d7d8e0)",
+    boxShadow: "var(--shadow, 0 1px 2px rgba(0, 0, 0, 0.05))",
+  },
+  surface: {
+    background: "var(--surface, #ffffff)",
+    border: "1px solid var(--border, #d7d8e0)",
+    boxShadow: "var(--shadow, 0 1px 2px rgba(0, 0, 0, 0.05))",
+  },
+  flat: {
+    background: "var(--grey-1, #f5f5f8)",
+    border: "1px solid var(--border, #d7d8e0)",
+    boxShadow: "none",
+  },
+  ghost: {
+    background: "transparent",
+    border: "1px solid var(--border, #d7d8e0)",
+    boxShadow: "none",
+  },
+};
+
+const props = withDefaults(
+  defineProps<{
+    items?: InfoBadgeItem[];
+    icon?: any;
+    label?: string | number;
+    value?: string | number;
+    color?: string;
+    title?: string;
+    dot?: boolean;
+    size?: "xs" | "sm" | "md" | "lg";
+    variant?: "default" | "surface" | "flat" | "ghost";
+  }>(),
+  {
+    items: undefined,
+    icon: undefined,
+    label: undefined,
+    value: undefined,
+    color: undefined,
+    title: undefined,
+    dot: true,
+    size: "sm",
+    variant: "default",
+  }
+);
+
+const emit = defineEmits<{
+  (e: "click", event: MouseEvent): void;
+}>();
+
+const slots = useSlots();
+const sz = computed(() => SIZES[props.size] || SIZES.sm);
+const vr = computed(() => VARIANTS[props.variant] || VARIANTS.default);
+
+const resolvedItems = computed<InfoBadgeItem[]>(() => {
+  if (Array.isArray(props.items) && props.items.length > 0) {
+    return props.items;
+  }
+  if (props.icon != null || props.value != null || props.label != null) {
+    return [
+      {
+        icon: props.icon,
+        label: props.label,
+        value: props.value,
+        color: props.color,
+        title: props.title,
+      },
+    ];
+  }
+  return [];
+});
+</script>
+
+<template>
+  <div
+    class="inline-flex items-center box-border select-none"
+    :style="{
+      height: sz.height,
+      padding: sz.padding,
+      borderRadius: sz.borderRadius,
+      background: vr.background,
+      border: vr.border,
+      boxShadow: vr.boxShadow,
+      gap: sz.gap,
+    }"
+    :title="title"
+    @click="(e) => emit('click', e)"
+  >
+    <slot v-if="slots.default" />
+    <template v-else>
+      <template v-for="(it, idx) in resolvedItems" :key="it.id || it.key || idx">
+        <div
+          v-if="idx > 0"
+          :style="{
+            width: '1px',
+            height: sz.sepHeight,
+            background: 'var(--border, #d7d8e0)',
+            flexShrink: 0,
+          }"
+        />
+        <div
+          class="inline-flex items-center"
+          :style="{
+            gap: '5px',
+            cursor: it.onClick ? 'pointer' : 'inherit',
+          }"
+          :title="it.title"
+          @click="it.onClick"
+        >
+          <span
+            v-if="it.icon"
+            class="inline-flex items-center justify-center flex-shrink-0"
+            :style="{
+              color: it.color || 'inherit',
+            }"
+          >
+            <component
+              :is="it.icon"
+              v-if="typeof it.icon === 'object' || typeof it.icon === 'function'"
+              :size="sz.iconSize"
+            />
+            <template v-else>{{ it.icon }}</template>
+          </span>
+
+          <span
+            v-if="it.label !== undefined && it.label !== null"
+            :style="{
+              fontSize: sz.fontSize,
+              fontWeight: 600,
+              color: (it.color && it.color !== 'inherit') ? it.color : 'var(--primary-text, #0f111c)',
+            }"
+          >
+            {{ it.label }}
+          </span>
+
+          <span
+            v-if="(it.dot !== undefined ? it.dot : dot) && (it.icon || it.label) && it.value !== undefined && it.value !== null"
+            :style="{
+              fontSize: sz.dotSize,
+              color: 'var(--muted, #9b9daa)',
+              lineHeight: 1,
+            }"
+          >
+            •
+          </span>
+
+          <span
+            v-if="it.value !== undefined && it.value !== null"
+            :style="{
+              fontSize: sz.fontSize,
+              fontWeight: 600,
+              color: 'var(--primary-text, #0f111c)',
+              fontVariantNumeric: 'tabular-nums',
+              lineHeight: 1,
+            }"
+          >
+            {{ it.value }}
+          </span>
+        </div>
+      </template>
+    </template>
+  </div>
+</template>

package/vue/components/StatusTag.vue

@@ -20,16 +20,22 @@ const props = withDefaults(
   }>(),
   {
     status: "",
-    width: 44,
-    height: 24,
+    width: 36,
+    height: 20,
     radius: 6,
   }
 );
 
+const isPrimaryStatus = computed(() => {
+  if (props.color) return true;
+  const key = (props.status || "").toUpperCase().trim();
+  return Boolean(STATUS_COLORS[key]);
+});
+
 const bg = computed(() => {
   if (props.color) return props.color;
-  const key = (props.status || "").toUpperCase();
-  return STATUS_COLORS[key] || "#8B909A";
+  const key = (props.status || "").toUpperCase().trim();
+  return STATUS_COLORS[key] || "transparent";
 });
 
 const boxWidth = computed(() =>
@@ -45,8 +51,8 @@ const borderRadius = computed(() =>
 
 <template>
   <span
-    v-if="status"
-    class="inline-flex items-center justify-center text-[11px] font-extrabold text-white tracking-wide select-none shadow-sm flex-shrink-0"
+    v-if="status && isPrimaryStatus"
+    class="inline-flex items-center justify-center text-[11px] font-bold text-white tracking-wide select-none shadow-sm flex-shrink-0"
     :style="{
       width: boxWidth,
       height: boxHeight,
@@ -56,5 +62,11 @@ const borderRadius = computed(() =>
   >
     {{ status }}
   </span>
+  <span
+    v-else-if="status"
+    class="text-[12px] font-semibold text-[var(--primary-text,inherit)] select-none truncate"
+  >
+    {{ status }}
+  </span>
   <span v-else class="text-slate-400 select-none">-</span>
 </template>

package/vue/index.d.ts

@@ -51,7 +51,13 @@ export declare const Table: DefineComponent<any, any, any>;
 export declare const Pagination: DefineComponent<any, any, any>;
 export declare const Skeleton: DefineComponent<any, any, any>;
 export declare const Modal: DefineComponent<any, any, any>;
+export declare const Drawer: DefineComponent<any, any, any>;
 export declare const Toggle: DefineComponent<any, any, any>;
+export declare const DatePicker: DefineComponent<any, any, any>;
+export declare const LinearProgress: DefineComponent<any, any, any>;
+export declare const CircularProgress: DefineComponent<any, any, any>;
+export declare const StatusTag: DefineComponent<any, any, any>;
+export declare const InfoBadge: DefineComponent<any, any, any>;
 export declare const XTable: DefineComponent<any, any, any>;
 export declare const XThead: DefineComponent<any, any, any>;
 export declare const XTbody: DefineComponent<any, any, any>;

package/vue/index.js

@@ -15,7 +15,9 @@ import Drawer from "./components/Drawer.vue";
 import Toggle from "./components/Toggle.vue";
 import DatePicker from "./components/DatePicker.vue";
 import LinearProgress from "./components/LinearProgress.vue";
+import CircularProgress from "./components/CircularProgress.vue";
 import StatusTag from "./components/StatusTag.vue";
+import InfoBadge from "./components/InfoBadge.vue";
 import { XTable, XThead, XTbody, XTr, XTh, XTd } from "./components/XTable.vue";
 import { useAutoSkeletonRows } from "./composables/useAutoSkeletonRows";
 
@@ -36,7 +38,9 @@ export {
   Toggle,
   DatePicker,
   LinearProgress,
+  CircularProgress,
   StatusTag,
+  InfoBadge,
   XTable,
   XThead,
   XTbody,
@@ -63,7 +67,9 @@ export default {
   Toggle,
   DatePicker,
   LinearProgress,
+  CircularProgress,
   StatusTag,
+  InfoBadge,
   XTable,
   XThead,
   XTbody,