feat: shrimp-admin v0.1.0 — 从 hand-admin 抽离的框架前端

Shrimp 框架前端 — 一种消费 ShrimpServer + ShrimpTable 契约的经典 Vue3 +
Element Plus 实现。不是框架本身,只是按 shrimp-server 约定写的一份参考解法。

包含:
- ShrimpClient + VueAdmin(factory:createShrimpAdmin)
- 5 个 Shrimp* 组件 + 10 个内置 Field*.vue + PowerTree + LangSwitch
- 4 个内置模块:user / role / operationLog / FieldRelativeTime
- 完整后台壳 views(layout/login/sideM/topbar/userbar/navMenu/App/404/logo)
- composables/useTableUrlSync, locales(zh-cn/en 框架默认), style 全套

API 改造:
- createShrimpAdmin({ config, moduleSources, customFields, locales }) factory
- vueAdmin 改为 Proxy 单例,createShrimpAdmin 调用前访问会抛错
- import.meta.glob 业务字段/模块由消费侧传入(vite 静态扫描机制限制)
- 框架默认 locales 与消费侧 locales 在 i18n 初始化时合并

源码 ship 不打包,消费侧靠 vite 直接吃 .ts/.vue。

src/components/fields/FieldBoolean.vue

@@ -0,0 +1,36 @@
+<template>
+    <el-tag v-if="mode === 'display'" :type="modelValue ? 'success' : 'danger'" size="small">
+        {{ modelValue ? $t('table.yes') : $t('table.no') }}
+    </el-tag>
+    <el-select
+        v-else-if="mode === 'filter'"
+        :model-value="modelValue"
+        @update:model-value="$emit('update:modelValue', $event)"
+        clearable
+        :placeholder="$t('table.unlimited')"
+        style="width: 100%"
+    >
+        <el-option :label="$t('table.yes')" :value="true" />
+        <el-option :label="$t('table.no')" :value="false" />
+    </el-select>
+    <el-switch v-else :model-value="modelValue" @update:model-value="$emit('update:modelValue', $event)" :disabled="disabled" />
+</template>
+
+<script lang="ts" setup>
+import { watch } from 'vue'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+}>()
+
+defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+watch(() => props.field.multiple, (v) => {
+    if (v) console.warn('[FieldBoolean] multiple is not supported, fallback to single value')
+}, { immediate: true })
+</script>

src/components/fields/FieldDate.vue

@@ -0,0 +1,137 @@
+<template>
+    <template v-if="mode === 'display'">
+        <template v-if="Array.isArray(modelValue)">
+            <span v-if="!modelValue.length">-</span>
+            <span v-else class="dt-group">
+                <template v-for="(p, i) in parsedArray" :key="i">
+                    <el-tooltip v-if="p" :content="p.full" placement="top" :show-after="800">
+                        <span class="dt">
+                            <el-icon class="ico"><Calendar /></el-icon>
+                            <span class="d">{{ p.day }}</span>
+                            <span class="t">{{ p.time }}</span>
+                        </span>
+                    </el-tooltip>
+                    <span v-else>-</span>
+                </template>
+            </span>
+        </template>
+        <el-tooltip v-else-if="parsed" :content="parsed.full" placement="top" :show-after="800">
+            <span class="dt">
+                <el-icon class="ico"><Calendar /></el-icon>
+                <span class="d">{{ parsed.day }}</span>
+                <span class="t">{{ parsed.time }}</span>
+            </span>
+        </el-tooltip>
+        <span v-else>-</span>
+    </template>
+    <el-date-picker
+        v-else-if="mode === 'filter'"
+        :model-value="filterModelValue"
+        @update:model-value="onFilterChange($event)"
+        type="datetimerange"
+        :start-placeholder="$t('table.startTime')"
+        :end-placeholder="$t('table.endTime')"
+        style="width: 100%"
+    />
+    <el-date-picker
+        v-else-if="field.multiple"
+        :model-value="modelValue"
+        @update:model-value="$emit('update:modelValue', $event)"
+        :disabled="disabled"
+        type="dates"
+        style="width: 100%"
+    />
+    <el-date-picker v-else :model-value="modelValue" @update:model-value="$emit('update:modelValue', $event)" :disabled="disabled"
+        type="datetime" style="width: 100%" />
+</template>
+
+<script lang="ts" setup>
+import { computed } from 'vue'
+import { Calendar } from '@element-plus/icons-vue'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+function pad(n: number) { return n < 10 ? '0' + n : String(n) }
+
+function parse(v: any): { day: string; time: string; full: string } | null {
+    if (v == null || v === '') return null
+    const d = new Date(v)
+    if (isNaN(d.getTime())) return null
+    const y = d.getFullYear()
+    const mo = pad(d.getMonth() + 1)
+    const da = pad(d.getDate())
+    const h = pad(d.getHours())
+    const mi = pad(d.getMinutes())
+    const se = pad(d.getSeconds())
+    const day = da
+    const time = `${h}:${mi}`
+    const full = `${y}-${mo}-${da} ${h}:${mi}:${se}`
+    return { day, time, full }
+}
+
+const parsed = computed(() => parse(props.modelValue))
+const parsedArray = computed(() => Array.isArray(props.modelValue) ? props.modelValue.map(parse) : [])
+
+const filterModelValue = computed(() => {
+    if (!props.modelValue || typeof props.modelValue !== 'object') return null
+    const { min, max } = props.modelValue
+    if (min != null && max != null) {
+        return [new Date(min), new Date(max)]
+    }
+    return null
+})
+
+function onFilterChange(dates: Date[] | null) {
+    if (dates && dates.length === 2) {
+        emit('update:modelValue', { min: dates[0].getTime(), max: dates[1].getTime() })
+    } else {
+        emit('update:modelValue', null)
+    }
+}
+</script>
+
+<style scoped>
+.dt-group {
+    display: inline-flex;
+    flex-wrap: wrap;
+    gap: 4px;
+}
+.dt {
+    display: inline-flex;
+    align-items: flex-end;
+    width: 100px;
+    height: 24px;
+    box-sizing: border-box;
+    padding: 0 10px 3px;
+    background: var(--el-fill-color-blank);
+    border: 1px solid var(--el-border-color);
+    border-radius: var(--el-border-radius-base);
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap;
+    font-size: 13px;
+    line-height: 1;
+    color: var(--el-text-color-regular);
+    vertical-align: middle;
+}
+.ico {
+    color: var(--el-text-color-placeholder);
+    font-size: 16px;
+    margin-right: 4px;
+}
+.d {
+    color: var(--el-text-color-regular);
+}
+.t {
+    margin-left: auto;
+    color: var(--el-text-color-regular);
+}
+</style>

src/components/fields/FieldJson.vue

@@ -0,0 +1,48 @@
+<template>
+    <template v-if="mode === 'display'">
+        <el-tooltip v-if="modelValue != null" :content="displayValue" placement="top">
+            <span class="json-display">{{ displayValue }}</span>
+        </el-tooltip>
+        <span v-else>-</span>
+    </template>
+    <el-input
+        v-else
+        :model-value="modelValue"
+        @update:model-value="$emit('update:modelValue', $event)"
+        type="textarea"
+        :rows="4"
+        :disabled="disabled"
+        placeholder="请输入 JSON"
+    />
+</template>
+
+<script lang="ts" setup>
+import { computed } from 'vue'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+}>()
+
+defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+const displayValue = computed(() => {
+    if (props.modelValue == null) return ''
+    if (typeof props.modelValue === 'string') return props.modelValue
+    return JSON.stringify(props.modelValue, null, 2)
+})
+</script>
+
+<style scoped>
+.json-display {
+    display: inline-block;
+    max-width: 200px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+</style>

src/components/fields/FieldNumber.vue

@@ -0,0 +1,82 @@
+<template>
+    <template v-if="mode === 'display'">
+        <template v-if="Array.isArray(modelValue)">{{ modelValue.join(', ') || 0 }}</template>
+        <template v-else>{{ modelValue ?? 0 }}</template>
+    </template>
+    <div v-else-if="mode === 'filter'" style="display: flex; gap: 8px; align-items: center; width: 100%">
+        <el-input-number
+            :model-value="modelValue?.min"
+            @update:model-value="emitRange('min', $event)"
+            :placeholder="$t('table.min')"
+            controls-position="right"
+            style="flex: 1"
+        />
+        <span style="color: #999">~</span>
+        <el-input-number
+            :model-value="modelValue?.max"
+            @update:model-value="emitRange('max', $event)"
+            :placeholder="$t('table.max')"
+            controls-position="right"
+            style="flex: 1"
+        />
+    </div>
+    <div v-else-if="field.multiple" class="tags-input">
+        <el-tag v-for="(num, index) in (modelValue || [])" :key="num + '-' + index" closable @close="removeNum(index)">
+            {{ num }}
+        </el-tag>
+        <el-input-number
+            v-model="inputValue"
+            @keyup.enter="addNum"
+            @blur="addNum"
+            :placeholder="$t('table.pressEnterForNumber')"
+            :controls="false"
+            style="width: 120px; flex: 1; min-width: 120px"
+        />
+    </div>
+    <el-input-number v-else :model-value="modelValue" @update:model-value="$emit('update:modelValue', $event)" :disabled="disabled" style="width: 100%" />
+</template>
+
+<script lang="ts" setup>
+import { ref } from 'vue'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+const inputValue = ref<number | undefined>(undefined)
+
+function emitRange(key: 'min' | 'max', val: number | undefined) {
+    const current = props.modelValue || {}
+    emit('update:modelValue', { ...current, [key]: val })
+}
+
+function addNum() {
+    if (inputValue.value == null) return
+    const current = Array.isArray(props.modelValue) ? props.modelValue : []
+    emit('update:modelValue', [...current, inputValue.value])
+    inputValue.value = undefined
+}
+
+function removeNum(index: number) {
+    const current = Array.isArray(props.modelValue) ? [...props.modelValue] : []
+    current.splice(index, 1)
+    emit('update:modelValue', current)
+}
+</script>
+
+<style scoped>
+.tags-input {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 8px;
+    align-items: center;
+    width: 100%;
+}
+</style>

src/components/fields/FieldPassword.vue

@@ -0,0 +1,20 @@
+<template>
+    <template v-if="mode === 'display'">******</template>
+    <template v-else-if="field.multiple">
+        <el-alert type="warning" :title="$t('table.passwordMultipleNotSupported')" :closable="false" />
+    </template>
+    <el-input v-else type="password" show-password :model-value="modelValue" @update:model-value="$emit('update:modelValue', $event)" :disabled="disabled" />
+</template>
+
+<script lang="ts" setup>
+defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit'
+    disabled?: boolean
+}>()
+
+defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+</script>

src/components/fields/FieldRelation.vue

@@ -0,0 +1,94 @@
+<template>
+    <template v-if="mode === 'display'">
+        <template v-if="field.multiple && Array.isArray(displayLabel)">{{ displayLabel.filter(Boolean).join(', ') || '-' }}</template>
+        <template v-else>{{ displayLabel || modelValue || '-' }}</template>
+    </template>
+    <el-select
+        v-else-if="mode === 'filter'"
+        :model-value="stringValue"
+        @update:model-value="$emit('update:modelValue', $event)"
+        multiple clearable filterable remote :remote-method="onSearch" :loading="loading"
+        style="width: 100%"
+    >
+        <el-option v-for="opt in options" :key="opt.value" :label="opt.label" :value="opt.value" />
+    </el-select>
+    <el-select v-else :model-value="stringValue" @update:model-value="$emit('update:modelValue', $event)" :disabled="disabled" :multiple="field.multiple" filterable remote :remote-method="onSearch" :loading="loading" style="width: 100%">
+        <el-option v-for="opt in options" :key="opt.value" :label="opt.label" :value="opt.value" />
+    </el-select>
+</template>
+
+<script lang="ts" setup>
+import { ref, onMounted, computed } from 'vue'
+import { vueAdmin } from '../../VueAdmin'
+import { ITableCrudProto } from 'shrimp-server/types'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+    displayLabel?: string | string[]
+}>()
+
+defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+const options = ref<{ label: string; value: string }[]>([])
+const loading = ref(false)
+
+/** 统一转为字符串值，解决 ObjectId 与 el-select 的匹配问题 */
+const stringValue = computed(() => {
+    // filter 模式强制 multiple，始终返回数组
+    if (props.mode === 'filter' || props.field.multiple) {
+        return Array.isArray(props.modelValue) ? props.modelValue.map(String) : []
+    }
+    return props.modelValue != null ? String(props.modelValue) : undefined
+})
+
+async function onSearch(query: string) {
+    if (!props.field.relation) return
+    loading.value = true
+    try {
+        const api = vueAdmin.getModule<ITableCrudProto<any>>(props.field.relation.moduleKey)
+        const listQuery: any = { keyword: query, pageSize: 20 }
+        if (props.field.filter) {
+            listQuery.filter = props.field.filter
+        }
+        const res = await api.list(listQuery)
+        const list = res.list || res as any
+        options.value = list.map((item: any) => ({
+            label: item[props.field.relation.labelKey],
+            value: String(item._id),
+        }))
+    } catch (e) {
+        console.warn('[FieldRelation] search failed', e)
+    } finally {
+        loading.value = false
+    }
+}
+
+onMounted(async () => {
+    if ((props.mode === 'edit' || props.mode === 'filter') && props.field.relation) {
+        await onSearch('')
+        // 确保当前值在选项中
+        const currentValues = props.field.multiple
+            ? (Array.isArray(props.modelValue) ? props.modelValue.map(String) : [])
+            : (props.modelValue ? [String(props.modelValue)] : [])
+        for (const val of currentValues) {
+            if (val && !options.value.some(o => o.value === val)) {
+                try {
+                    const api = vueAdmin.getModule<ITableCrudProto<any>>(props.field.relation.moduleKey)
+                    const current = await api.get(val)
+                    if (current) {
+                        options.value.unshift({
+                            label: (current as any)[props.field.relation.labelKey],
+                            value: String(val),
+                        })
+                    }
+                } catch { }
+            }
+        }
+    }
+})
+</script>

src/components/fields/FieldSelect.vue

@@ -0,0 +1,65 @@
+<template>
+    <template v-if="mode === 'display'">
+        <template v-if="Array.isArray(modelValue)"
+        >{{ displayLabels.join(', ') || '-' }}</template
+        >
+        <template v-else>{{ displayText }}</template>
+    </template>
+    <el-select
+        v-else-if="mode === 'filter'"
+        :model-value="modelValue"
+        @update:model-value="$emit('update:modelValue', $event)"
+        multiple
+        clearable
+        style="width: 100%"
+    >
+        <el-option v-for="opt in resolvedOptions" :key="opt.value" :label="vueAdmin.t(opt.label)" :value="opt.value" />
+    </el-select>
+    <el-select
+        v-else
+        :model-value="modelValue"
+        @update:model-value="$emit('update:modelValue', $event)"
+        :disabled="disabled"
+        :multiple="field.multiple"
+        style="width: 100%"
+    >
+        <el-option v-for="opt in resolvedOptions" :key="opt.value" :label="vueAdmin.t(opt.label)" :value="opt.value" />
+    </el-select>
+</template>
+
+<script lang="ts" setup>
+import { computed } from 'vue'
+import { vueAdmin } from '../../VueAdmin'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+}>()
+
+defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+const resolvedOptions = computed(() => {
+    const opts = props.field.options
+    if (typeof opts === 'string') {
+        return vueAdmin.globalOptions[opts] || []
+    }
+    return opts || []
+})
+
+const displayText = computed(() => {
+    const label = resolvedOptions.value.find((o: any) => o.value === props.modelValue)?.label
+    return label ? vueAdmin.t(label) : (props.modelValue ?? '-')
+})
+
+const displayLabels = computed(() => {
+    if (!Array.isArray(props.modelValue)) return []
+    return props.modelValue.map((val: any) => {
+        const opt = resolvedOptions.value.find((o: any) => o.value === val)
+        return opt ? vueAdmin.t(opt.label) : val
+    })
+})
+</script>

src/components/fields/FieldString.vue

@@ -0,0 +1,59 @@
+<template>
+    <template v-if="mode === 'display'">
+        <template v-if="Array.isArray(modelValue)">{{ modelValue.join(', ') || '-' }}</template>
+        <template v-else>{{ modelValue ?? '-' }}</template>
+    </template>
+    <div v-else-if="field.multiple" class="tags-input">
+        <el-tag v-for="(tag, index) in (modelValue || [])" :key="tag + index" closable @close="removeTag(index)">
+            {{ tag }}
+        </el-tag>
+        <el-input v-model="inputValue" @keyup.enter="addTag" @blur="addTag" :placeholder="$t('base.pressEnter')" />
+    </div>
+    <el-input v-else :model-value="modelValue" @update:model-value="$emit('update:modelValue', $event)" :disabled="disabled" clearable />
+</template>
+
+<script lang="ts" setup>
+import { ref } from 'vue'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+const inputValue = ref('')
+
+function addTag() {
+    const val = inputValue.value.trim()
+    if (!val) return
+    const current = Array.isArray(props.modelValue) ? props.modelValue : []
+    emit('update:modelValue', [...current, val])
+    inputValue.value = ''
+}
+
+function removeTag(index: number) {
+    const current = Array.isArray(props.modelValue) ? [...props.modelValue] : []
+    current.splice(index, 1)
+    emit('update:modelValue', current)
+}
+</script>
+
+<style scoped>
+.tags-input {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 8px;
+    align-items: center;
+    width: 100%;
+}
+.tags-input .el-input {
+    width: 120px;
+    flex: 1;
+    min-width: 120px;
+}
+</style>

src/components/fields/FieldTab.vue

@@ -0,0 +1,120 @@
+<template>
+    <template v-if="mode === 'display'">
+        <span v-if="!modelValue || typeof modelValue !== 'object'">-</span>
+        <el-tooltip v-else :content="JSON.stringify(modelValue, null, 2)" placement="top">
+            <span class="tab-display">{{ displayText }}</span>
+        </el-tooltip>
+    </template>
+    <div v-else class="field-tab">
+        <el-form-item :label="vueAdmin.t(field.label) + ' - 类型'" :required="field.required">
+            <el-select :model-value="innerValue.type" @update:model-value="onTypeChange" :disabled="disabled">
+                <el-option v-for="tab in field.tabs" :key="tab.key" :label="vueAdmin.t(tab.label)" :value="tab.key" />
+            </el-select>
+        </el-form-item>
+        <div v-if="selectedTab?.fields?.length" class="tab-fields">
+            <template v-for="childField in selectedTab.fields" :key="childField.key">
+                <el-form-item :label="vueAdmin.t(childField.label)" :required="childField.required">
+                    <component :is="vueAdmin.getFieldComponent(moduleKey, childField.type, childField.key)"
+                        :field="childField"
+                        :model-value="innerValue[childField.key]"
+                        @update:model-value="onChildChange(childField.key, $event)"
+                        mode="edit"
+                        :disabled="disabled" />
+                </el-form-item>
+            </template>
+        </div>
+    </div>
+</template>
+
+<script lang="ts" setup>
+import { computed, inject, onMounted } from 'vue'
+import { vueAdmin } from '../../VueAdmin'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+}>()
+
+const emit = defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+const moduleKey = inject('shrimpModuleKey', '')
+
+const displayText = computed(() => {
+    if (!props.modelValue || typeof props.modelValue !== 'object') return '-'
+    const type = props.modelValue.type
+    const tab = props.field.tabs?.find((t: any) => t.key === type)
+    return tab ? vueAdmin.t(tab.label) : String(type)
+})
+
+const selectedTab = computed(() => {
+    const type = props.modelValue?.type
+    return props.field.tabs?.find((t: any) => t.key === type)
+})
+
+const innerValue = computed(() => {
+    const val = props.modelValue
+    if (val != null && typeof val === 'object' && Object.keys(val).length > 0) {
+        return val
+    }
+    return initValue()
+})
+
+function initValue() {
+    const firstTab = props.field.tabs?.[0]
+    if (!firstTab) return {}
+    const obj: any = { type: firstTab.key }
+    firstTab.fields?.forEach((f: any) => {
+        if (f.defaultValue !== undefined) {
+            obj[f.key] = typeof f.defaultValue === 'function' ? f.defaultValue() : f.defaultValue
+        }
+    })
+    return obj
+}
+
+function onTypeChange(type: any) {
+    const tab = props.field.tabs?.find((t: any) => t.key === type)
+    const obj: any = { type }
+    tab?.fields?.forEach((f: any) => {
+        if (f.defaultValue !== undefined) {
+            obj[f.key] = typeof f.defaultValue === 'function' ? f.defaultValue() : f.defaultValue
+        }
+    })
+    emit('update:modelValue', obj)
+}
+
+function onChildChange(key: string, value: any) {
+    emit('update:modelValue', { ...innerValue.value, [key]: value })
+}
+
+onMounted(() => {
+    const val = props.modelValue
+    if (val == null || val === '' || (typeof val === 'object' && Object.keys(val).length === 0)) {
+        emit('update:modelValue', initValue())
+    }
+})
+</script>
+
+<style scoped>
+.tab-display {
+    display: inline-block;
+    max-width: 200px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+
+.field-tab {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.tab-fields {
+    padding-left: 16px;
+    border-left: 2px solid var(--el-border-color-lighter);
+}
+</style>

src/components/fields/FieldTextarea.vue

@@ -0,0 +1,78 @@
+<template>
+    <template v-if="mode === 'display'">
+        <template v-if="Array.isArray(modelValue)">{{ modelValue.join('\n') || '-' }}</template>
+        <template v-else-if="!isLong">{{ text }}</template>
+        <div v-else class="textarea-cell">
+            <span class="text" :class="{ collapsed: !expanded }">{{ text }}</span>
+            <el-link type="primary" underline="never" class="toggle" @click.stop="expanded = !expanded">
+                {{ expanded ? $t('base.collapse') : $t('base.expand') }}
+            </el-link>
+        </div>
+    </template>
+    <template v-else-if="field.multiple">
+        <el-alert type="warning" :title="$t('table.textareaMultipleNotSupported')" :closable="false" />
+    </template>
+    <el-input
+        v-else
+        :type="mode === 'filter' ? 'text' : 'textarea'"
+        :rows="mode === 'filter' ? undefined : 3"
+        :model-value="modelValue"
+        @update:model-value="$emit('update:modelValue', $event)"
+        :disabled="disabled"
+        clearable
+    />
+</template>
+
+<script lang="ts" setup>
+import { ref, computed } from 'vue'
+
+const props = defineProps<{
+    field: any
+    modelValue: any
+    mode: 'display' | 'edit' | 'filter'
+    disabled?: boolean
+    displayLabel?: string
+}>()
+
+defineEmits<{
+    'update:modelValue': [value: any]
+}>()
+
+const text = computed(() => {
+    const v = props.displayLabel ?? props.modelValue
+    return v == null || v === '' ? '-' : String(v)
+})
+
+const isLong = computed(() => {
+    const s = text.value
+    return s.length > 40 || s.includes('\n')
+})
+
+const expanded = ref(false)
+</script>
+
+<style scoped>
+.textarea-cell {
+    display: flex;
+    align-items: flex-start;
+    gap: 6px;
+}
+.text {
+    flex: 1;
+    white-space: pre-wrap;
+    word-break: break-all;
+    min-width: 0;
+}
+.text.collapsed {
+    display: -webkit-box;
+    -webkit-line-clamp: 1;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+    word-break: break-all;
+}
+.toggle {
+    flex-shrink: 0;
+    font-size: 12px;
+    line-height: 1.5;
+}
+</style>