mgv-backoffice 1.37.0 → 1.40.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mgv-backoffice",
-  "version": "1.37.0",
+  "version": "1.40.0",
   "description": "Shared Vue 3 UI component library",
   "type": "module",
   "main": "./dist/ui-lib.umd.cjs",

package/src/components/BaseAuthLayout.test.ts

@@ -0,0 +1,48 @@
+import { describe, it, expect } from 'vitest'
+import { mount, RouterLinkStub } from '@vue/test-utils'
+import BaseAuthLayout from './BaseAuthLayout.vue'
+import BaseBooleanBadge from './BaseBooleanBadge.vue'
+
+const global = { stubs: { RouterLink: RouterLinkStub } }
+
+describe('BaseAuthLayout', () => {
+  it('renders the default logo, title, content and footer', () => {
+    const wrapper = mount(BaseAuthLayout, {
+      props: { title: 'Sign in' },
+      slots: { default: '<form>form</form>', footer: 'No account? <a>Sign up</a>' },
+      global,
+    })
+    expect(wrapper.find('svg').exists()).toBe(true)
+    expect(wrapper.find('h1').text()).toBe('Sign in')
+    expect(wrapper.find('form').text()).toBe('form')
+    expect(wrapper.text()).toContain('No account? Sign up')
+  })
+
+  it('lets the logo slot replace the default logo', () => {
+    const wrapper = mount(BaseAuthLayout, { slots: { logo: '<img alt="brand" />' }, global })
+    expect(wrapper.find('img').exists()).toBe(true)
+    expect(wrapper.find('svg').exists()).toBe(false)
+  })
+
+  it('widens the card with `wide`', () => {
+    const card = (w: ReturnType<typeof mount>) => w.find('.rounded-xl')
+    expect(card(mount(BaseAuthLayout, { global })).classes()).toContain('max-w-md')
+    expect(card(mount(BaseAuthLayout, { props: { wide: true }, global })).classes()).toContain('max-w-3xl')
+  })
+})
+
+describe('BaseBooleanBadge', () => {
+  it('renders a green "Yes" pill for true and a neutral "No" pill for false', () => {
+    const yes = mount(BaseBooleanBadge, { props: { value: true } })
+    expect(yes.text()).toBe('Yes')
+    expect(yes.classes()).toContain('bg-emerald-50')
+    const no = mount(BaseBooleanBadge, { props: { value: false } })
+    expect(no.text()).toBe('No')
+    expect(no.classes()).toContain('bg-slate-100')
+  })
+
+  it('uses custom labels and treats null as false', () => {
+    const w = mount(BaseBooleanBadge, { props: { value: null, trueLabel: 'Verified', falseLabel: 'Not verified' } })
+    expect(w.text()).toBe('Not verified')
+  })
+})

package/src/components/BaseAuthLayout.vue

@@ -0,0 +1,50 @@
+<template>
+  <div class="flex min-h-screen w-full flex-col items-center justify-center bg-slate-50 px-4 py-10 dark:bg-slate-950">
+    <div class="mb-6 flex justify-center">
+      <slot name="logo">
+        <BaseLogo :size="BaseLogoEnum.MEDIUM" />
+      </slot>
+    </div>
+    <div
+      class="w-full rounded-xl border border-slate-200 bg-white p-6 text-left shadow-sm sm:p-8 dark:border-slate-700 dark:bg-slate-900"
+      :class="wide ? 'max-w-3xl' : 'max-w-md'"
+    >
+      <h1 v-if="title" class="mb-1 text-2xl font-bold tracking-tight text-slate-900 dark:text-slate-100">{{ title }}</h1>
+      <p v-if="subtitle" class="text-sm text-slate-500 dark:text-slate-400">{{ subtitle }}</p>
+      <div :class="title || subtitle ? 'mt-6' : ''">
+        <slot />
+      </div>
+      <div
+        v-if="$slots.footer"
+        class="mt-6 border-t border-slate-200 pt-4 text-center text-sm text-slate-500 dark:border-slate-700 dark:text-slate-400"
+      >
+        <slot name="footer" />
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+/**
+ * Full-page, centred shell for sign-in / sign-up / password-recovery screens:
+ * logo on top (defaults to BaseLogo, override via the `logo` slot), then a
+ * bordered card with the title, the page content (default slot) and an
+ * optional `footer` ("Don't have an account? Sign up"). `wide` widens the card
+ * for multi-column forms such as registration.
+ */
+import BaseLogo from './BaseLogo.vue'
+import { BaseLogoEnum } from '../enums/BaseLogoEnum'
+
+interface Props {
+  title?: string
+  subtitle?: string
+  /** max-w-3xl card instead of max-w-md (multi-column forms). */
+  wide?: boolean
+}
+
+withDefaults(defineProps<Props>(), {
+  title: '',
+  subtitle: '',
+  wide: false,
+})
+</script>

package/src/components/BaseBooleanBadge.vue

@@ -0,0 +1,33 @@
+<template>
+  <span
+    class="inline-flex items-center gap-1 rounded-full px-2.5 py-0.5 text-xs font-medium ring-1 ring-inset"
+    :class="value
+      ? 'bg-emerald-50 text-emerald-700 ring-emerald-600/20 dark:bg-emerald-500/10 dark:text-emerald-300 dark:ring-emerald-400/30'
+      : 'bg-slate-100 text-slate-600 ring-slate-500/20 dark:bg-slate-700/50 dark:text-slate-300 dark:ring-slate-400/20'"
+  >
+    <CheckCircleIcon v-if="value" class="h-3.5 w-3.5" aria-hidden="true" />
+    <XCircleIcon v-else class="h-3.5 w-3.5" aria-hidden="true" />
+    {{ value ? trueLabel : falseLabel }}
+  </span>
+</template>
+
+<script setup lang="ts">
+/**
+ * Yes/no status pill for boolean columns ("Verified", "Has API", …):
+ * a green check pill when true, a neutral cross pill when false — so a
+ * `false` reads as a state, not as an error.
+ */
+import { CheckCircleIcon, XCircleIcon } from '@heroicons/vue/20/solid'
+
+interface Props {
+  value?: boolean | null
+  trueLabel?: string
+  falseLabel?: string
+}
+
+withDefaults(defineProps<Props>(), {
+  value: false,
+  trueLabel: 'Yes',
+  falseLabel: 'No',
+})
+</script>

package/src/components/BaseBreadcrumb.vue

@@ -1,68 +1,68 @@
-<template>
-  <nav class="flex px-5 py-3 text-gray-700 border border-gray-200 rounded-lg bg-gray-50 dark:bg-gray-800 dark:border-gray-700" aria-label="Breadcrumb">
-    <ol class="inline-flex items-center space-x-1 md:space-x-3">
-
-      <li class="inline-flex items-center" style="margin-left: 0;">
-        <router-link to="/" class="inline-flex items-center text-sm font-medium text-gray-700 hover:text-blue-600 dark:text-gray-400 dark:hover:text-white transition-colors rounded focus:outline-none focus-visible:ring-2 focus-visible:ring-emerald-500">
-          <HomeIcon class="h-4 w-4 text-gray-500 mr-2" />
-          Home
-        </router-link>
-      </li>
-
-      <li v-for="(crumb, index) in crumbs" :key="index" class="inline-flex items-center" style="margin-left: 0;">
-        <ChevronRightIcon class="h-4 w-4 text-gray-500" />
-        <router-link :to="crumb.url" class="ml-1 text-sm font-medium text-gray-700 hover:text-blue-600 md:ml-2 dark:text-gray-400 dark:hover:text-white transition-colors rounded focus:outline-none focus-visible:ring-2 focus-visible:ring-emerald-500">
-          {{ crumb.name }}
-        </router-link>
-      </li>
-
-    </ol>
-  </nav>
-</template>
-
-<script lang="ts" setup>
-import { computed } from 'vue'
-import { HomeIcon } from '@heroicons/vue/24/solid'
-import { ChevronRightIcon } from '@heroicons/vue/24/outline'
-
-export interface BreadCrumb {
-  name: string
-  url: string
-}
-
-const props = defineProps({
-  items: {
-    type: Array as () => BreadCrumb[],
-    required: false,
-    default: undefined
-  },
-  path: {
-    type: String,
-    required: false,
-    default: undefined
-  }
-})
-
-const crumbs = computed<BreadCrumb[]>(() => {
-  // If explicit items are provided, use them directly
-  if (props.items && props.items.length > 0) {
-    return props.items
-  }
-
-  // Otherwise, auto-generate from the path prop (or current URL)
-  const pathname = props.path ?? (typeof window !== 'undefined' ? window.location.pathname : '/')
-  const segments = pathname.split('/').filter(s => s !== '')
-
-  let accumulated = ''
-  return segments.map(segment => {
-    accumulated += '/' + segment
-
-    const isNumeric = !Number.isNaN(Number(segment))
-    const name = !isNumeric
-      ? (segment.charAt(0).toUpperCase() + segment.slice(1)).replaceAll('-', ' ')
-      : segment
-
-    return { name, url: accumulated }
-  })
-})
-</script>
+<template>
+  <nav class="flex overflow-x-auto px-5 py-3 text-gray-700 border border-slate-200 rounded-xl bg-white shadow-sm dark:bg-slate-900 dark:border-slate-700" aria-label="Breadcrumb">
+    <ol class="inline-flex items-center whitespace-nowrap space-x-1 md:space-x-3">
+
+      <li class="inline-flex items-center" style="margin-left: 0;">
+        <router-link to="/" class="inline-flex items-center text-sm font-medium text-gray-700 hover:text-blue-600 dark:text-gray-400 dark:hover:text-white transition-colors rounded focus:outline-none focus-visible:ring-2 focus-visible:ring-emerald-500">
+          <HomeIcon class="h-4 w-4 text-gray-500 mr-2" />
+          Home
+        </router-link>
+      </li>
+
+      <li v-for="(crumb, index) in crumbs" :key="index" class="inline-flex items-center" style="margin-left: 0;">
+        <ChevronRightIcon class="h-4 w-4 text-gray-500" />
+        <router-link :to="crumb.url" class="ml-1 text-sm font-medium text-gray-700 hover:text-blue-600 md:ml-2 dark:text-gray-400 dark:hover:text-white transition-colors rounded focus:outline-none focus-visible:ring-2 focus-visible:ring-emerald-500">
+          {{ crumb.name }}
+        </router-link>
+      </li>
+
+    </ol>
+  </nav>
+</template>
+
+<script lang="ts" setup>
+import { computed } from 'vue'
+import { HomeIcon } from '@heroicons/vue/24/solid'
+import { ChevronRightIcon } from '@heroicons/vue/24/outline'
+
+export interface BreadCrumb {
+  name: string
+  url: string
+}
+
+const props = defineProps({
+  items: {
+    type: Array as () => BreadCrumb[],
+    required: false,
+    default: undefined
+  },
+  path: {
+    type: String,
+    required: false,
+    default: undefined
+  }
+})
+
+const crumbs = computed<BreadCrumb[]>(() => {
+  // If explicit items are provided, use them directly
+  if (props.items && props.items.length > 0) {
+    return props.items
+  }
+
+  // Otherwise, auto-generate from the path prop (or current URL)
+  const pathname = props.path ?? (typeof window !== 'undefined' ? window.location.pathname : '/')
+  const segments = pathname.split('/').filter(s => s !== '')
+
+  let accumulated = ''
+  return segments.map(segment => {
+    accumulated += '/' + segment
+
+    const isNumeric = !Number.isNaN(Number(segment))
+    const name = !isNumeric
+      ? (segment.charAt(0).toUpperCase() + segment.slice(1)).replaceAll('-', ' ')
+      : segment
+
+    return { name, url: accumulated }
+  })
+})
+</script>

package/src/components/BaseButton.vue

@@ -40,7 +40,7 @@ const props = defineProps({
   color: {
     type: String,
     required: false,
-    default: BaseButtonEnum.BLUE
+    default: BaseButtonEnum.GREEN
   },
   to: {
     type: String,

package/src/components/BaseCard.test.ts

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest'
+import { mount } from '@vue/test-utils'
+import BaseCard from './BaseCard.vue'
+import BaseField from './BaseField.vue'
+
+describe('BaseCard', () => {
+  it('renders the bordered surface with the body slot', () => {
+    const wrapper = mount(BaseCard, { slots: { default: '<p>body</p>' } })
+    expect(wrapper.classes()).toEqual(expect.arrayContaining(['rounded-xl', 'border', 'shadow-sm']))
+    expect(wrapper.find('p').text()).toBe('body')
+    expect(wrapper.find('header').exists()).toBe(false)
+    expect(wrapper.find('footer').exists()).toBe(false)
+  })
+
+  it('renders header (title, subtitle, actions) and footer when given', () => {
+    const wrapper = mount(BaseCard, {
+      props: { title: 'Template', subtitle: 'Edit it' },
+      slots: { actions: '<button>New</button>', footer: '<button>Save</button>' },
+    })
+    expect(wrapper.find('header h2').text()).toBe('Template')
+    expect(wrapper.find('header').text()).toContain('Edit it')
+    expect(wrapper.find('header button').text()).toBe('New')
+    expect(wrapper.find('footer button').text()).toBe('Save')
+  })
+
+  it('supports compact and no body padding', () => {
+    expect(mount(BaseCard, { props: { padding: 'sm' } }).find('section > div').classes()).toContain('p-4')
+    expect(mount(BaseCard, { props: { padding: 'none' } }).find('section > div').classes()).toEqual([])
+  })
+})
+
+describe('BaseField', () => {
+  it('renders label (wired to the control), control and hint', () => {
+    const wrapper = mount(BaseField, {
+      props: { label: 'Name', labelFor: 'name', hint: 'Your name', required: true },
+      slots: { default: '<input id="name" />' },
+    })
+    expect(wrapper.find('label').attributes('for')).toBe('name')
+    expect(wrapper.find('label').text()).toBe('Name*')
+    expect(wrapper.find('input').exists()).toBe(true)
+    expect(wrapper.text()).toContain('Your name')
+  })
+
+  it('shows the error instead of the hint', () => {
+    const wrapper = mount(BaseField, { props: { label: 'Name', hint: 'h', error: 'Required' } })
+    expect(wrapper.find('[role=alert]').text()).toBe('Required')
+    expect(wrapper.text()).not.toContain('h\n')
+  })
+
+  it('uses the small uppercase label and flex growth for filter bars', () => {
+    const wrapper = mount(BaseField, { props: { label: 'Search', compact: true, grow: true } })
+    expect(wrapper.find('label').classes()).toEqual(expect.arrayContaining(['uppercase', 'text-xs']))
+    expect(wrapper.classes()).toContain('flex-1')
+  })
+})

package/src/components/BaseCard.vue

@@ -0,0 +1,48 @@
+<template>
+  <section
+    class="rounded-xl border border-slate-200 bg-white text-left shadow-sm dark:border-slate-700 dark:bg-slate-900"
+  >
+    <header
+      v-if="title || subtitle || $slots.actions"
+      class="flex flex-wrap items-center justify-between gap-3 border-b border-slate-200 px-5 py-3 dark:border-slate-700"
+    >
+      <div class="min-w-0">
+        <h2 v-if="title" class="text-base font-semibold text-slate-900 dark:text-slate-100">{{ title }}</h2>
+        <p v-if="subtitle" class="text-sm text-slate-500 dark:text-slate-400">{{ subtitle }}</p>
+      </div>
+      <div v-if="$slots.actions" class="flex items-center gap-2">
+        <slot name="actions" />
+      </div>
+    </header>
+    <div :class="padding === 'sm' ? 'p-4' : padding === 'none' ? '' : 'p-5'">
+      <slot />
+    </div>
+    <footer
+      v-if="$slots.footer"
+      class="flex flex-wrap items-center justify-end gap-2 border-t border-slate-200 px-5 py-3 dark:border-slate-700"
+    >
+      <slot name="footer" />
+    </footer>
+  </section>
+</template>
+
+<script setup lang="ts">
+/**
+ * Bordered surface card — the shared chrome for forms, filter/search panels
+ * and any grouped content. Optional header (title / subtitle / `actions`
+ * slot), a padded body (default slot) and an optional `footer` slot for
+ * submit / cancel buttons.
+ */
+interface Props {
+  title?: string
+  subtitle?: string
+  /** Body padding: 'md' (p-5, default), 'sm' (p-4, e.g. filter bars) or 'none'. */
+  padding?: 'md' | 'sm' | 'none'
+}
+
+withDefaults(defineProps<Props>(), {
+  title: '',
+  subtitle: '',
+  padding: 'md',
+})
+</script>

package/src/components/BaseDetailList.test.ts

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest'
+import { mount } from '@vue/test-utils'
+import BaseDetailList from './BaseDetailList.vue'
+
+describe('BaseDetailList', () => {
+  it('renders each label with its value', () => {
+    const wrapper = mount(BaseDetailList, {
+      props: { items: [{ label: 'Status', value: 'PUBLISHED' }, { label: 'Count', value: 3 }] },
+    })
+    expect(wrapper.findAll('dt').map((d) => d.text())).toEqual(['Status', 'Count'])
+    expect(wrapper.findAll('dd').map((d) => d.text())).toEqual(['PUBLISHED', '3'])
+  })
+
+  it('shows the empty text for missing values', () => {
+    const wrapper = mount(BaseDetailList, {
+      props: { items: [{ label: 'Link', value: null }, { label: 'Tags', value: '' }], emptyText: 'n/a' },
+    })
+    expect(wrapper.findAll('dd').map((d) => d.text())).toEqual(['n/a', 'n/a'])
+  })
+
+  it('renders href values as external links and applies mono', () => {
+    const wrapper = mount(BaseDetailList, {
+      props: { items: [{ label: 'Link', value: 'open', href: 'https://x.test' }, { label: 'Id', value: 'abc', mono: true }] },
+    })
+    const a = wrapper.find('a')
+    expect(a.attributes('href')).toBe('https://x.test')
+    expect(a.attributes('target')).toBe('_blank')
+    expect(wrapper.findAll('dd')[1].classes()).toContain('font-mono')
+  })
+
+  it('switches the grid columns', () => {
+    expect(mount(BaseDetailList, { props: { items: [], columns: 1 } }).classes()).not.toContain('sm:grid-cols-2')
+    expect(mount(BaseDetailList, { props: { items: [] } }).classes()).toContain('sm:grid-cols-2')
+    expect(mount(BaseDetailList, { props: { items: [], columns: 3 } }).classes()).toContain('lg:grid-cols-3')
+  })
+})

package/src/components/BaseDetailList.vue

@@ -0,0 +1,43 @@
+<template>
+  <dl class="grid grid-cols-1 gap-x-6 gap-y-4 text-left" :class="columns === 2 ? 'sm:grid-cols-2' : columns === 3 ? 'sm:grid-cols-2 lg:grid-cols-3' : ''">
+    <div v-for="item in items" :key="item.label" class="min-w-0">
+      <dt class="text-xs uppercase tracking-wide text-slate-500 dark:text-slate-400">{{ item.label }}</dt>
+      <dd class="mt-1 break-words text-sm text-slate-900 dark:text-slate-100" :class="item.mono ? 'font-mono' : ''">
+        <a
+          v-if="item.href && !isEmpty(item.value)"
+          :href="item.href"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="text-emerald-600 hover:underline dark:text-emerald-400"
+        >{{ item.value }}</a>
+        <span v-else-if="isEmpty(item.value)" class="text-slate-400 dark:text-slate-500">{{ emptyText }}</span>
+        <template v-else>{{ item.value }}</template>
+      </dd>
+    </div>
+  </dl>
+</template>
+
+<script setup lang="ts">
+/**
+ * Read-only label/value grid for detail pages — the "view" counterpart of a
+ * form. Empty values render `emptyText` (—); `href` makes the value an
+ * external link; `mono` sets it in the monospace face (ids, hashes).
+ */
+import type { DetailItem } from '../types/detail'
+
+interface Props {
+  items: readonly DetailItem[]
+  /** Columns from `sm` up (1 column on phones). */
+  columns?: 1 | 2 | 3
+  emptyText?: string
+}
+
+withDefaults(defineProps<Props>(), {
+  columns: 2,
+  emptyText: '—',
+})
+
+function isEmpty(v: DetailItem['value']): boolean {
+  return v === null || v === undefined || v === ''
+}
+</script>

package/src/components/BaseField.vue

@@ -0,0 +1,47 @@
+<template>
+  <div :class="grow ? 'min-w-48 flex-1' : ''" class="text-left">
+    <label
+      v-if="label"
+      :for="labelFor || undefined"
+      class="mb-1 block"
+      :class="compact
+        ? 'text-xs uppercase tracking-wide text-slate-500 dark:text-slate-400'
+        : 'text-sm font-medium text-slate-700 dark:text-slate-200'"
+    >
+      {{ label }}<span v-if="required" class="ml-0.5 text-red-500" aria-hidden="true">*</span>
+    </label>
+    <slot />
+    <p v-if="error" class="mt-1 text-xs font-medium text-red-600 dark:text-red-400" role="alert">{{ error }}</p>
+    <p v-else-if="hint" class="mt-1 text-xs text-slate-500 dark:text-slate-400">{{ hint }}</p>
+  </div>
+</template>
+
+<script setup lang="ts">
+/**
+ * Label + control + message wrapper for forms and filter bars. The control
+ * goes in the default slot (BaseInput, BaseSelect, BaseSearchSelect, …).
+ * `compact` switches to the small uppercase filter-bar label; `grow` makes
+ * the field take the free space in a flex row (filter bars).
+ */
+interface Props {
+  label?: string
+  /** id of the control, wired to the label's `for`. */
+  labelFor?: string
+  required?: boolean
+  /** Validation message (red); replaces the hint while set. */
+  error?: string
+  hint?: string
+  compact?: boolean
+  grow?: boolean
+}
+
+withDefaults(defineProps<Props>(), {
+  label: '',
+  labelFor: '',
+  required: false,
+  error: '',
+  hint: '',
+  compact: false,
+  grow: false,
+})
+</script>

package/src/components/BaseInput.test.ts

@@ -7,7 +7,7 @@ describe('BaseInput', () => {
     const wrapper = mount(BaseInput)
     const input = wrapper.find('input')
     expect(input.classes()).toEqual(
-      expect.arrayContaining(['rounded', 'border', 'w-full', 'px-3', 'py-2', 'text-sm']),
+      expect.arrayContaining(['rounded-lg', 'border', 'w-full', 'px-3', 'py-2', 'text-sm']),
     )
     expect(input.attributes('type')).toBe('text')
   })

package/src/components/BaseInput.vue

@@ -1,46 +1,46 @@
-<template>
-  <!--
-    Themed text/number input. Carries the shared field skin (slate border,
-    slate-50/slate-900 surface); everything else — placeholder, id, disabled,
-    step/min, extra classes like `font-mono` — falls through via attrs and
-    Vue's class merging, so callers keep their one-off styling.
-
-    Dark mode uses `dark:` variants: the consuming app must map the `dark`
-    variant to the `.dark` class useTheme() toggles (all current consumers do).
-  -->
-  <input
-    :value="modelValue"
-    :type="type"
-    class="rounded border border-slate-300 dark:border-slate-600 bg-slate-50 dark:bg-slate-900 text-slate-900 dark:text-slate-100 text-sm placeholder:text-slate-400 dark:placeholder:text-slate-500 transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-emerald-500 focus-visible:border-emerald-500 disabled:opacity-60 disabled:cursor-not-allowed"
-    :class="[block ? 'w-full' : '', size === 'sm' ? 'px-2 py-1.5' : 'px-3 py-2']"
-    @input="onInput"
-  />
-</template>
-
-<script setup lang="ts">
-interface Props {
-  modelValue?: string | number | null
-  /** Native input type ('text', 'number', 'password', …). */
-  type?: string
-  /** 'md' = px-3 py-2 (default); 'sm' = px-2 py-1.5 compact. */
-  size?: 'sm' | 'md'
-  /** Full-width (w-full). Set false for inline fields. */
-  block?: boolean
-}
-
-withDefaults(defineProps<Props>(), {
-  modelValue: '',
-  type: 'text',
-  size: 'md',
-  block: true,
-})
-
-const emit = defineEmits<{
-  /** Raw string value on every input — callers parse numbers themselves. */
-  (e: 'update:modelValue', value: string): void
-}>()
-
-function onInput(e: Event) {
-  emit('update:modelValue', (e.target as HTMLInputElement).value)
-}
-</script>
+<template>
+  <!--
+    Themed text/number input. Carries the shared field skin (slate border,
+    slate-50/slate-900 surface); everything else — placeholder, id, disabled,
+    step/min, extra classes like `font-mono` — falls through via attrs and
+    Vue's class merging, so callers keep their one-off styling.
+
+    Dark mode uses `dark:` variants: the consuming app must map the `dark`
+    variant to the `.dark` class useTheme() toggles (all current consumers do).
+  -->
+  <input
+    :value="modelValue"
+    :type="type"
+    class="rounded-lg border border-slate-300 dark:border-slate-600 bg-white dark:bg-slate-900 text-slate-900 dark:text-slate-100 text-sm placeholder:text-slate-400 dark:placeholder:text-slate-500 transition-colors hover:border-slate-400 dark:hover:border-slate-500 focus:outline-none focus-visible:ring-2 focus-visible:ring-emerald-500/40 focus-visible:border-emerald-500 disabled:opacity-60 disabled:cursor-not-allowed"
+    :class="[block ? 'w-full' : '', size === 'sm' ? 'px-2 py-1.5' : 'px-3 py-2']"
+    @input="onInput"
+  />
+</template>
+
+<script setup lang="ts">
+interface Props {
+  modelValue?: string | number | null
+  /** Native input type ('text', 'number', 'password', …). */
+  type?: string
+  /** 'md' = px-3 py-2 (default); 'sm' = px-2 py-1.5 compact. */
+  size?: 'sm' | 'md'
+  /** Full-width (w-full). Set false for inline fields. */
+  block?: boolean
+}
+
+withDefaults(defineProps<Props>(), {
+  modelValue: '',
+  type: 'text',
+  size: 'md',
+  block: true,
+})
+
+const emit = defineEmits<{
+  /** Raw string value on every input — callers parse numbers themselves. */
+  (e: 'update:modelValue', value: string): void
+}>()
+
+function onInput(e: Event) {
+  emit('update:modelValue', (e.target as HTMLInputElement).value)
+}
+</script>

package/src/components/BaseLogo.test.ts

@@ -0,0 +1,26 @@
+import { describe, it, expect } from 'vitest'
+import { defineComponent, h } from 'vue'
+import { mount, RouterLinkStub } from '@vue/test-utils'
+import BaseLogo from './BaseLogo.vue'
+
+describe('BaseLogo', () => {
+  it('gives each instance its own gradient ids and references them', () => {
+    const Two = defineComponent({ render: () => [h(BaseLogo), h(BaseLogo)] })
+    const wrapper = mount(Two, { global: { stubs: { RouterLink: RouterLinkStub } } })
+
+    const svgs = wrapper.findAll('svg')
+    expect(svgs).toHaveLength(2)
+
+    const ids = svgs.map((svg) => svg.findAll('linearGradient').map((g) => g.attributes('id')))
+    // No id is shared between the two logos.
+    expect(ids[0].filter((id) => ids[1].includes(id))).toEqual([])
+
+    // Every fill in a logo points at a gradient inside that same logo.
+    svgs.forEach((svg, i) => {
+      svg.findAll('path').forEach((path) => {
+        const ref = path.attributes('fill')?.match(/^url\(#(.+)\)$/)?.[1]
+        expect(ids[i]).toContain(ref)
+      })
+    })
+  })
+})