@quazardous/qdadm 1.19.3

package/src/components/display/CopyableId.vue

@@ -0,0 +1,84 @@
+<script setup lang="ts">
+/**
+ * CopyableId - Read-only ID field with copy-to-clipboard functionality
+ *
+ * Usage:
+ *   <CopyableId :value="entityId" label="ID" />
+ *   <CopyableId :value="apiKey" label="API Key" />
+ */
+import { ref, inject } from 'vue'
+import Button from 'primevue/button'
+import type { Orchestrator } from '../../orchestrator/Orchestrator'
+
+interface Props {
+  value: string
+  label?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  label: 'ID'
+})
+
+const orchestrator = inject<Orchestrator | null>('qdadmOrchestrator', null)
+const copied = ref(false)
+
+async function copyToClipboard(): Promise<void> {
+  try {
+    await navigator.clipboard.writeText(props.value)
+    copied.value = true
+    orchestrator?.toast.success('Copied', `${props.label} copied to clipboard`, 'CopyableId')
+    setTimeout(() => {
+      copied.value = false
+    }, 2000)
+  } catch {
+    orchestrator?.toast.error('Error', 'Failed to copy to clipboard', 'CopyableId')
+  }
+}
+</script>
+
+<template>
+  <div class="form-field">
+    <label class="form-field-label">{{ label }}</label>
+    <div class="copyable-id">
+      <Button
+        type="button"
+        :icon="copied ? 'pi pi-check' : 'pi pi-copy'"
+        :severity="copied ? 'success' : 'secondary'"
+        size="small"
+        text
+        rounded
+        @click="copyToClipboard"
+        :aria-label="`Copy ${label}`"
+        class="copyable-id-button"
+      />
+      <code class="copyable-id-value">{{ value }}</code>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+/*
+ * Only keep styles here that REQUIRE scoping (:deep, dynamic binding, component-specific overrides).
+ * Generic/reusable styles belong in src/styles/ partials (see _forms.scss, _cards.scss, etc.).
+ */
+.copyable-id {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  background: var(--p-surface-100);
+  padding: 0.5rem 0.75rem;
+  border-radius: 4px;
+  max-width: 100%;
+}
+
+.copyable-id-value {
+  font-family: monospace;
+  font-size: 0.875rem;
+  color: var(--p-surface-700);
+  word-break: break-all;
+}
+
+.copyable-id-button {
+  flex-shrink: 0;
+}
+</style>

package/src/components/display/EmptyState.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+/**
+ * EmptyState - Reusable empty state display
+ *
+ * Usage:
+ *   <EmptyState
+ *     icon="pi-users"
+ *     title="No agents found"
+ *     description="Assign agents from their profile page"
+ *   />
+ *
+ *   <!-- With slot for custom content -->
+ *   <EmptyState icon="pi-inbox" title="No items">
+ *     <Button label="Create Item" @click="create" />
+ *   </EmptyState>
+ */
+
+type SizeVariant = 'sm' | 'md' | 'lg'
+
+defineProps({
+  // PrimeIcon name (without "pi-" prefix if you want, both work)
+  icon: {
+    type: String,
+    default: 'inbox'
+  },
+  // Main message
+  title: {
+    type: String,
+    default: 'No items found'
+  },
+  // Secondary description (optional)
+  description: {
+    type: String,
+    default: ''
+  },
+  // Size variant
+  size: {
+    type: String as () => SizeVariant,
+    default: 'md', // sm, md, lg
+    validator: (v: string) => ['sm', 'md', 'lg'].includes(v)
+  }
+})
+
+// Normalize icon name (accept both "pi-inbox" and "inbox")
+function getIconClass(icon: string): string {
+  if (icon.startsWith('pi-')) {
+    return `pi ${icon}`
+  }
+  return `pi pi-${icon}`
+}
+</script>
+
+<template>
+  <div class="empty-state" :class="`empty-state--${size}`">
+    <i :class="getIconClass(icon)" class="empty-state-icon" />
+    <p class="empty-state-title">{{ title }}</p>
+    <small v-if="description" class="empty-state-description">{{ description }}</small>
+    <div v-if="$slots.default" class="empty-state-actions">
+      <slot />
+    </div>
+  </div>
+</template>

package/src/components/display/IntensityBar.vue

@@ -0,0 +1,190 @@
+<script setup lang="ts">
+import { ref, computed, onMounted, inject } from 'vue'
+
+type SizeVariant = 'sm' | 'md' | 'lg'
+type Severity = 'success' | 'warning' | 'danger'
+
+interface ApiAdapter {
+  request: (method: string, endpoint: string) => Promise<Record<string, unknown>>
+}
+
+interface BarProps {
+  percentage: number
+  tier: number
+  color: string
+  severity: Severity
+  threshold: number
+}
+
+const props = defineProps({
+  value: {
+    type: Number,
+    required: true
+  },
+  showValue: {
+    type: Boolean,
+    default: true
+  },
+  size: {
+    type: String as () => SizeVariant,
+    default: 'md', // sm, md, lg
+    validator: (v: string) => ['sm', 'md', 'lg'].includes(v)
+  },
+  // Threshold configuration
+  threshold: {
+    type: Number as () => number | null,
+    default: null // If provided, use static threshold instead of loading from API
+  },
+  configEndpoint: {
+    type: String as () => string | null,
+    default: null // Endpoint to load threshold config from API
+  },
+  configThresholdKey: {
+    type: String,
+    default: 'threshold' // Key in config response containing threshold value
+  }
+})
+
+// Get API adapter (optional - only needed if loading from endpoint)
+const api = inject<ApiAdapter | null>('apiAdapter', null)
+
+// Threshold value
+const loadedThreshold = ref<number>(8) // default fallback
+const configLoaded = ref<boolean>(false)
+
+// Computed threshold - use prop if provided, otherwise loaded value
+const currentThreshold = computed<number>(() => props.threshold ?? loadedThreshold.value)
+
+// Singleton pattern - load config once for all instances
+let configPromise: Promise<void> | null = null
+
+async function loadConfig(): Promise<void> {
+  // Skip if using static threshold or no endpoint configured
+  if (props.threshold !== null || !props.configEndpoint) {
+    configLoaded.value = true
+    return
+  }
+
+  // Skip if no API adapter
+  if (!api) {
+    console.warn('[IntensityBar] apiAdapter not provided, using default threshold')
+    configLoaded.value = true
+    return
+  }
+
+  if (configPromise) return configPromise
+
+  configPromise = api.request('GET', props.configEndpoint)
+    .then((data: Record<string, unknown>) => {
+      if (data?.[props.configThresholdKey]) {
+        loadedThreshold.value = data[props.configThresholdKey] as number
+      }
+      configLoaded.value = true
+    })
+    .catch(() => {
+      console.warn('[IntensityBar] Could not load config, using defaults')
+      configLoaded.value = true
+    })
+
+  return configPromise
+}
+
+// Calculate bar properties based on threshold tiers
+const barProps = computed<BarProps>(() => {
+  const threshold = currentThreshold.value
+  const tier = Math.floor(props.value / threshold)
+  const withinTier = props.value % threshold
+  const percentage = (withinTier / threshold) * 100
+
+  // Color: green (tier 0), orange (tier 1), red (tier 2+)
+  let color = 'var(--p-green-500)'
+  let severity: Severity = 'success'
+  if (tier === 1) {
+    color = 'var(--p-orange-500)'
+    severity = 'warning'
+  } else if (tier >= 2) {
+    color = 'var(--p-red-500)'
+    severity = 'danger'
+  }
+
+  return { percentage, tier, color, severity, threshold }
+})
+
+// Size classes
+const sizeClass = computed<string>(() => `intensity-bar--${props.size}`)
+
+onMounted(() => {
+  loadConfig()
+})
+</script>
+
+<template>
+  <div class="intensity-container" :class="sizeClass">
+    <div
+      class="intensity-bar"
+      :style="{ '--bar-color': barProps.color, '--bar-width': barProps.percentage + '%' }"
+      :title="`Tier ${barProps.tier} (threshold: ${barProps.threshold})`"
+    >
+      <div class="intensity-bar-fill"></div>
+    </div>
+    <span v-if="showValue" class="intensity-value" :style="{ color: barProps.color }">
+      {{ value.toFixed(2) }}
+    </span>
+  </div>
+</template>
+
+<style scoped>
+/*
+ * Only keep styles here that REQUIRE scoping (:deep, dynamic binding, component-specific overrides).
+ * Generic/reusable styles belong in src/styles/ partials (see _forms.scss, _cards.scss, etc.).
+ */
+.intensity-container {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.intensity-bar {
+  background: var(--p-surface-200);
+  border-radius: 4px;
+  overflow: hidden;
+  /* Default size (md) */
+  width: 80px;
+  height: 8px;
+}
+
+.intensity-bar--sm .intensity-bar {
+  width: 60px;
+  height: 6px;
+}
+
+.intensity-bar--lg .intensity-bar {
+  width: 120px;
+  height: 10px;
+}
+
+.intensity-bar-fill {
+  height: 100%;
+  width: var(--bar-width);
+  background: var(--bar-color);
+  border-radius: 4px;
+  transition: width 0.3s ease, background 0.3s ease;
+}
+
+.intensity-value {
+  font-weight: 600;
+  min-width: 45px;
+}
+
+.intensity-bar--sm .intensity-value {
+  font-size: 0.8em;
+}
+
+.intensity-bar--md .intensity-value {
+  font-size: 0.9em;
+}
+
+.intensity-bar--lg .intensity-value {
+  font-size: 1em;
+}
+</style>

package/src/components/display/RichCardsGrid.vue

@@ -0,0 +1,101 @@
+<script setup lang="ts">
+/**
+ * RichCardsGrid - Grid of rich stat cards with title, value, subtitle
+ *
+ * Props:
+ * - cards: Array of card objects
+ * - columns: Number of columns (2, 3, 4, or 'auto')
+ *
+ * Card object:
+ * {
+ *   name: 'users',           // unique key
+ *   title: 'Users',          // card title
+ *   value: 42,               // main value
+ *   subtitle: '10 active',   // optional subtitle
+ *   icon: 'pi pi-users',     // optional icon
+ *   severity: 'success',     // optional: success, danger, warning, info
+ *   onClick: () => {},       // optional click handler
+ *   to: '/dashboard/users',  // optional router link
+ *   custom: true             // use slot instead
+ * }
+ */
+import { useRouter } from 'vue-router'
+import type { PropType } from 'vue'
+
+type CardSeverity = 'success' | 'danger' | 'warning' | 'info'
+type ColumnsType = 'auto' | 2 | 3 | 4 | 5 | 6
+
+export interface RichCard {
+  name: string
+  title?: string
+  value?: string | number
+  subtitle?: string
+  icon?: string
+  severity?: CardSeverity
+  onClick?: () => void
+  to?: string
+  custom?: boolean
+  class?: string
+}
+
+const router = useRouter()
+
+defineProps({
+  cards: {
+    type: Array as PropType<RichCard[]>,
+    default: () => []
+  },
+  columns: {
+    type: [Number, String] as PropType<ColumnsType>,
+    default: 'auto',
+    validator: (v: ColumnsType) => ['auto', 2, 3, 4, 5, 6].includes(v)
+  }
+})
+
+function handleClick(card: RichCard): void {
+  if (card.onClick) {
+    card.onClick()
+  } else if (card.to) {
+    router.push(card.to)
+  }
+}
+
+function isClickable(card: RichCard): boolean {
+  return !!(card.onClick || card.to)
+}
+
+function getSeverityClass(severity: CardSeverity | undefined): string {
+  if (!severity) return ''
+  return `rich-card--${severity}`
+}
+</script>
+
+<template>
+  <div v-if="cards.length > 0" class="rich-cards-grid" :class="`rich-cards-grid--cols-${columns}`">
+    <template v-for="card in cards" :key="card.name">
+      <!-- Custom card: render slot -->
+      <div v-if="card.custom" class="rich-card rich-card--custom" :class="card.class">
+        <slot :name="`card-${card.name}`" :card="card" ></slot>
+      </div>
+
+      <!-- Rich stat card -->
+      <div
+        v-else
+        class="rich-card"
+        :class="[
+          getSeverityClass(card.severity),
+          { 'rich-card--clickable': isClickable(card) },
+          card.class
+        ]"
+        @click="handleClick(card)"
+      >
+        <div class="rich-card-header">
+          <span class="rich-card-title">{{ card.title }}</span>
+          <i v-if="card.icon" :class="card.icon" class="rich-card-icon"></i>
+        </div>
+        <div class="rich-card-value">{{ card.value }}</div>
+        <div v-if="card.subtitle" class="rich-card-subtitle">{{ card.subtitle }}</div>
+      </div>
+    </template>
+  </div>
+</template>

package/src/components/edit/FormActions.vue

@@ -0,0 +1,78 @@
+<script setup lang="ts">
+/**
+ * FormActions - Reusable form action buttons
+ *
+ * Props:
+ * - isEdit: Boolean - Edit mode (changes labels)
+ * - saving: Boolean - Loading state
+ * - dirty: Boolean - Form has unsaved changes
+ *
+ * Emits:
+ * - save: Save and stay on form
+ * - saveAndClose: Save and navigate back
+ * - cancel: Cancel/close without saving
+ */
+
+import Button from 'primevue/button'
+import { useI18n } from '../../i18n/useI18n'
+
+const { t } = useI18n()
+
+interface Props {
+  isEdit?: boolean
+  saving?: boolean
+  dirty?: boolean
+  showSaveAndClose?: boolean
+}
+
+withDefaults(defineProps<Props>(), {
+  isEdit: false,
+  saving: false,
+  dirty: true,  // Default true for backwards compatibility
+  showSaveAndClose: true
+})
+
+const emit = defineEmits<{
+  'save': []
+  'saveAndClose': []
+  'cancel': []
+}>()
+</script>
+
+<template>
+  <div class="form-actions">
+    <div class="form-actions-left">
+      <Button
+        type="button"
+        :label="isEdit ? t('core.actions.update') : t('core.actions.create')"
+        :loading="saving"
+        :disabled="!dirty || saving"
+        icon="pi pi-check"
+        @click="emit('save')"
+        v-tooltip.top="t('core.tooltips.saveAndContinue')"
+      />
+      <Button
+        v-if="showSaveAndClose"
+        type="button"
+        :label="isEdit ? t('core.actions.updateAndClose') : t('core.actions.createAndClose')"
+        :loading="saving"
+        :disabled="!dirty || saving"
+        icon="pi pi-check-circle"
+        severity="success"
+        @click="emit('saveAndClose')"
+        v-tooltip.top="t('core.tooltips.saveAndReturn')"
+      />
+      <span v-if="dirty" class="dirty-indicator" v-tooltip.top="t('core.tooltips.unsavedChanges')">
+        <i class="pi pi-circle-fill"></i>
+      </span>
+    </div>
+    <Button
+      type="button"
+      :label="t('core.actions.cancel')"
+      severity="secondary"
+      icon="pi pi-times"
+      @click="emit('cancel')"
+      :disabled="saving"
+    />
+  </div>
+</template>

package/src/components/edit/FormField.vue

@@ -0,0 +1,82 @@
+<script setup lang="ts">
+/**
+ * FormField - Wrapper for form fields with automatic dirty state and error display
+ *
+ * Usage:
+ * <FormField name="username" label="Username *">
+ *   <InputText v-model="form.username" />
+ * </FormField>
+ *
+ * The parent form (useEntityItemFormPage) provides:
+ * - isFieldDirty: function to check if field is dirty
+ * - getFieldError: function to get field error message
+ * - handleFieldBlur: function to trigger validation on blur
+ * - formSubmitted: ref indicating if form was submitted
+ */
+import { inject, computed, type Ref, type CSSProperties } from 'vue'
+
+interface Props {
+  name: string
+  label?: string
+  hint?: string
+  fullWidth?: boolean
+  /** Override error message (useful for custom validation) */
+  error?: string | null
+  /** Show error only after form submission */
+  showErrorOnSubmit?: boolean
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  label: '',
+  hint: '',
+  fullWidth: false,
+  error: null,
+  showErrorOnSubmit: false
+})
+
+// Inject from parent form (provided by useEntityItemFormPage)
+const isFieldDirty = inject<(name: string) => boolean>('isFieldDirty', () => false)
+const getFieldError = inject<(name: string) => string | null>('getFieldError', () => null)
+const handleFieldBlur = inject<(name: string) => void>('handleFieldBlur', () => {})
+const formSubmitted = inject<Ref<boolean>>('formSubmitted', { value: false } as Ref<boolean>)
+
+const isDirty = computed((): boolean => isFieldDirty(props.name))
+
+// Get error from prop or from form validation
+const fieldError = computed((): string | null => {
+  if (props.error) return props.error
+  return getFieldError(props.name)
+})
+
+// Show error if: form submitted OR field was touched (validated on blur)
+const showError = computed((): boolean => {
+  if (!fieldError.value) return false
+  if (props.showErrorOnSubmit) return formSubmitted.value
+  return true
+})
+
+const fieldClasses = computed((): (string | Record<string, boolean>)[] => [
+  'form-field',
+  {
+    'field-dirty': isDirty.value,
+    'field-invalid': showError.value
+  }
+])
+
+const fieldStyle = computed((): CSSProperties =>
+  props.fullWidth ? { gridColumn: '1 / -1' } : {}
+)
+
+function onBlur(): void {
+  handleFieldBlur(props.name)
+}
+</script>
+
+<template>
+  <div :class="fieldClasses" :style="fieldStyle">
+    <label v-if="label" :for="name">{{ label }}</label>
+    <slot :onBlur="onBlur"></slot>
+    <small v-if="showError" class="field-error">{{ fieldError }}</small>
+    <small v-else-if="hint" class="field-hint">{{ hint }}</small>
+  </div>
+</template>