@open-mercato/ui 0.6.7-develop.6660.1.90e1e2eef6 → 0.6.7-develop.6669.1.40b669666b

package/dist/backend/utils/customFieldDefs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/backend/utils/customFieldDefs.ts"],
-  "sourcesContent": ["import * as React from 'react'\nimport { useQuery, type UseQueryResult, type QueryClient } from '@tanstack/react-query'\nimport { readApiResultOrThrow } from './apiCall'\nimport type { CustomFieldOptionDto } from '@open-mercato/shared/modules/entities/options'\n\nexport type CustomFieldDefDto = {\n  entityId?: string\n  key: string\n  kind: string\n  label?: string\n  description?: string\n  options?: CustomFieldOptionDto[]\n  optionsUrl?: string\n  multi?: boolean\n  filterable?: boolean\n  formEditable?: boolean\n  listVisible?: boolean\n  editor?: string\n  input?: string\n  priority?: number\n  fieldset?: string\n  fieldsets?: string[]\n  group?: { code: string; title?: string; hint?: string }\n  // attachments-specific config\n  maxAttachmentSizeMb?: number\n  acceptExtensions?: string[]\n  // optional validation rules\n  validation?: Array<\n    | { rule: 'required'; message: string }\n    | { rule: 'date'; message: string }\n    | { rule: 'integer'; message: string }\n    | { rule: 'float'; message: string }\n    | { rule: 'lt' | 'lte' | 'gt' | 'gte'; param: number; message: string }\n    | { rule: 'eq' | 'ne'; param: any; message: string }\n    | { rule: 'regex'; param: string; message: string }\n  >\n  dictionaryId?: string\n  dictionaryInlineCreate?: boolean\n  defaultValue?: string | number | boolean | null\n}\n\nexport type CustomFieldsetGroupDto = {\n  code: string\n  title?: string\n  hint?: string\n}\n\nexport type CustomFieldsetDto = {\n  code: string\n  label: string\n  icon?: string\n  description?: string\n  groups?: CustomFieldsetGroupDto[]\n}\n\nexport type CustomFieldDefinitionsPayload = {\n  items?: CustomFieldDefDto[]\n  fieldsetsByEntity?: Record<string, CustomFieldsetDto[]>\n  entitySettings?: Record<string, { singleFieldsetPerRecord?: boolean }>\n}\n\nexport function normalizeEntityIds(entityIds: string | string[] | null | undefined): string[] {\n  if (entityIds == null) return []\n  const list = Array.isArray(entityIds) ? entityIds : [entityIds]\n  const dedup = new Set<string>()\n  const normalized: string[] = []\n  for (const raw of list) {\n    const trimmed = String(raw ?? '').trim()\n    if (!trimmed || dedup.has(trimmed)) continue\n    dedup.add(trimmed)\n    normalized.push(trimmed)\n  }\n  return normalized\n}\n\nexport type CustomFieldDefinitionQueryOptions = {\n  fieldset?: string\n}\n\nfunction buildDefinitionsQuery(entityIds: string[], options?: CustomFieldDefinitionQueryOptions): string {\n  const params = new URLSearchParams()\n  entityIds.forEach((id) => {\n    if (id) params.append('entityId', id)\n  })\n  if (options?.fieldset) params.set('fieldset', options.fieldset)\n  return params.toString()\n}\n\ntype CustomFieldDefinitionsResponse = CustomFieldDefinitionsPayload\n\nfunction normalizeRecord<T>(value: unknown): Record<string, T[]> {\n  if (!value || typeof value !== 'object') return {}\n  const out: Record<string, T[]> = {}\n  for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n    if (!Array.isArray(raw)) continue\n    out[key] = raw as T[]\n  }\n  return out\n}\n\nfunction preparePayload(data: CustomFieldDefinitionsResponse | null | undefined): CustomFieldDefinitionsPayload {\n  const items = Array.isArray(data?.items) ? [...data!.items] : []\n  items.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0))\n  const fieldsetsByEntity = normalizeRecord<CustomFieldsetDto>(data?.fieldsetsByEntity)\n  const entitySettings = (data?.entitySettings && typeof data.entitySettings === 'object'\n    ? data.entitySettings\n    : {}) as CustomFieldDefinitionsPayload['entitySettings']\n  return { items, fieldsetsByEntity, entitySettings }\n}\n\nasync function readDefinitionsViaFetch(\n  entityIds: string[],\n  fetchImpl: typeof fetch,\n  options?: CustomFieldDefinitionQueryOptions,\n): Promise<CustomFieldDefinitionsPayload> {\n  const query = buildDefinitionsQuery(entityIds, options)\n  const res = await fetchImpl(`/api/entities/definitions?${query}`, {\n    headers: { 'content-type': 'application/json' },\n  })\n  const data = await res.json().catch(() => ({ items: [] }))\n  return preparePayload(data)\n}\n\nasync function readDefinitionsViaApi(entityIds: string[], options?: CustomFieldDefinitionQueryOptions): Promise<CustomFieldDefinitionsPayload> {\n  const query = buildDefinitionsQuery(entityIds, options)\n  const payload = await readApiResultOrThrow<CustomFieldDefinitionsResponse>(\n    `/api/entities/definitions?${query}`,\n    { headers: { 'content-type': 'application/json' } },\n    {\n      errorMessage: 'Failed to load custom field definitions',\n      fallback: { items: [] },\n    },\n  )\n  return preparePayload(payload)\n}\n\nexport async function fetchCustomFieldDefinitionsPayload(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: CustomFieldDefinitionQueryOptions,\n): Promise<CustomFieldDefinitionsPayload> {\n  const filtered = normalizeEntityIds(entityIds)\n  if (!filtered.length) return { items: [] }\n  return fetchImpl\n    ? await readDefinitionsViaFetch(filtered, fetchImpl, options)\n    : await readDefinitionsViaApi(filtered, options)\n}\n\nexport async function fetchCustomFieldDefs(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: CustomFieldDefinitionQueryOptions,\n): Promise<CustomFieldDefDto[]> {\n  const payload = await fetchCustomFieldDefinitionsPayload(entityIds, fetchImpl, options)\n  return payload.items ?? []\n}\n\nexport type UseCustomFieldDefsOptions<TData = CustomFieldDefDto[]> = {\n  enabled?: boolean\n  staleTime?: number\n  gcTime?: number\n  /** @deprecated Custom fetch implementations are no longer needed. */\n  fetchImpl?: typeof fetch\n  keyExtras?: Array<string | number | boolean | null | undefined>\n  fieldset?: string\n  select?: (data: CustomFieldDefDto[]) => TData\n}\n\nexport function useCustomFieldDefs<TData = CustomFieldDefDto[]>(\n  entityIds: string | string[] | null | undefined,\n  options: UseCustomFieldDefsOptions<TData> = {}\n): UseQueryResult<TData> {\n  const {\n    enabled: enabledOption = true,\n    staleTime,\n    gcTime,\n    keyExtras,\n    fetchImpl,\n    fieldset,\n  } = options\n  const normalizedIds = React.useMemo(() => normalizeEntityIds(entityIds), [entityIds])\n  const idsSignature = React.useMemo(() => JSON.stringify(normalizedIds), [normalizedIds])\n  const extrasSignature = React.useMemo(() => JSON.stringify(keyExtras ?? []), [keyExtras])\n  const normalizedFieldset = typeof fieldset === 'string' && fieldset.trim().length ? fieldset.trim() : null\n  const queryKey = React.useMemo(\n    () => ['customFieldDefs', ...(keyExtras ?? []), ...normalizedIds, `fieldset:${normalizedFieldset ?? 'default'}`],\n    [idsSignature, extrasSignature, normalizedFieldset]\n  )\n  const enabled = enabledOption && normalizedIds.length > 0\n\n  return useQuery<CustomFieldDefDto[], Error, TData>({\n    queryKey,\n    queryFn: () =>\n      fetchCustomFieldDefs(\n        normalizedIds,\n        fetchImpl,\n        normalizedFieldset ? { fieldset: normalizedFieldset } : undefined\n      ),\n    enabled,\n    staleTime: staleTime ?? 5 * 60 * 1000,\n    gcTime: gcTime ?? 30 * 60 * 1000,\n    select: options.select,\n  })\n}\n\nexport type CustomFieldVisibility = 'list' | 'form' | 'filter'\n\nexport function isDefVisible(def: CustomFieldDefDto, mode: CustomFieldVisibility): boolean {\n  switch (mode) {\n    case 'list':\n      return def.listVisible !== false\n    case 'form':\n      return def.formEditable !== false\n    case 'filter':\n      return !!def.filterable\n    default:\n      return true\n  }\n}\n\nexport function filterCustomFieldDefs(defs: CustomFieldDefDto[], mode: CustomFieldVisibility): CustomFieldDefDto[] {\n  return defs\n    .filter((d) => isDefVisible(d, mode))\n    .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0))\n}\n\nexport async function invalidateCustomFieldDefs(\n  queryClient: QueryClient,\n  entityIds?: string | string[] | null,\n): Promise<void> {\n  const normalizedIds = normalizeEntityIds(entityIds)\n  const targetPrefixes = new Set(['customFieldDefs', 'customFieldForms', 'dealFormFields'])\n  if (!normalizedIds.length) {\n    await queryClient.invalidateQueries({\n      predicate: (query) => Array.isArray(query.queryKey) && typeof query.queryKey[0] === 'string' && targetPrefixes.has(query.queryKey[0] as string),\n    })\n    return\n  }\n  await queryClient.invalidateQueries({\n    predicate: (query) => {\n      if (!Array.isArray(query.queryKey)) return false\n      const [prefix] = query.queryKey\n      if (typeof prefix !== 'string' || !targetPrefixes.has(prefix)) return false\n      return normalizedIds.every((id) => query.queryKey.includes(id))\n    },\n  })\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as React from 'react'\nimport { useQuery, type UseQueryResult, type QueryClient } from '@tanstack/react-query'\nimport { readApiResultOrThrow } from './apiCall'\nimport type { CustomFieldOptionDto } from '@open-mercato/shared/modules/entities/options'\n\nexport type CustomFieldDefDto = {\n  entityId?: string\n  key: string\n  kind: string\n  label?: string\n  description?: string\n  options?: CustomFieldOptionDto[]\n  optionsUrl?: string\n  multi?: boolean\n  filterable?: boolean\n  formEditable?: boolean\n  listVisible?: boolean\n  editor?: string\n  input?: string\n  priority?: number\n  fieldset?: string\n  fieldsets?: string[]\n  group?: { code: string; title?: string; hint?: string }\n  // attachments-specific config\n  maxAttachmentSizeMb?: number\n  acceptExtensions?: string[]\n  // phone-specific config\n  defaultCountryIso2?: string\n  // optional validation rules\n  validation?: Array<\n    | { rule: 'required'; message: string }\n    | { rule: 'date'; message: string }\n    | { rule: 'integer'; message: string }\n    | { rule: 'float'; message: string }\n    | { rule: 'lt' | 'lte' | 'gt' | 'gte'; param: number; message: string }\n    | { rule: 'eq' | 'ne'; param: any; message: string }\n    | { rule: 'regex'; param: string; message: string }\n  >\n  dictionaryId?: string\n  dictionaryInlineCreate?: boolean\n  defaultValue?: string | number | boolean | null\n}\n\nexport type CustomFieldsetGroupDto = {\n  code: string\n  title?: string\n  hint?: string\n}\n\nexport type CustomFieldsetDto = {\n  code: string\n  label: string\n  icon?: string\n  description?: string\n  groups?: CustomFieldsetGroupDto[]\n}\n\nexport type CustomFieldDefinitionsPayload = {\n  items?: CustomFieldDefDto[]\n  fieldsetsByEntity?: Record<string, CustomFieldsetDto[]>\n  entitySettings?: Record<string, { singleFieldsetPerRecord?: boolean }>\n}\n\nexport function normalizeEntityIds(entityIds: string | string[] | null | undefined): string[] {\n  if (entityIds == null) return []\n  const list = Array.isArray(entityIds) ? entityIds : [entityIds]\n  const dedup = new Set<string>()\n  const normalized: string[] = []\n  for (const raw of list) {\n    const trimmed = String(raw ?? '').trim()\n    if (!trimmed || dedup.has(trimmed)) continue\n    dedup.add(trimmed)\n    normalized.push(trimmed)\n  }\n  return normalized\n}\n\nexport type CustomFieldDefinitionQueryOptions = {\n  fieldset?: string\n}\n\nfunction buildDefinitionsQuery(entityIds: string[], options?: CustomFieldDefinitionQueryOptions): string {\n  const params = new URLSearchParams()\n  entityIds.forEach((id) => {\n    if (id) params.append('entityId', id)\n  })\n  if (options?.fieldset) params.set('fieldset', options.fieldset)\n  return params.toString()\n}\n\ntype CustomFieldDefinitionsResponse = CustomFieldDefinitionsPayload\n\nfunction normalizeRecord<T>(value: unknown): Record<string, T[]> {\n  if (!value || typeof value !== 'object') return {}\n  const out: Record<string, T[]> = {}\n  for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n    if (!Array.isArray(raw)) continue\n    out[key] = raw as T[]\n  }\n  return out\n}\n\nfunction preparePayload(data: CustomFieldDefinitionsResponse | null | undefined): CustomFieldDefinitionsPayload {\n  const items = Array.isArray(data?.items) ? [...data!.items] : []\n  items.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0))\n  const fieldsetsByEntity = normalizeRecord<CustomFieldsetDto>(data?.fieldsetsByEntity)\n  const entitySettings = (data?.entitySettings && typeof data.entitySettings === 'object'\n    ? data.entitySettings\n    : {}) as CustomFieldDefinitionsPayload['entitySettings']\n  return { items, fieldsetsByEntity, entitySettings }\n}\n\nasync function readDefinitionsViaFetch(\n  entityIds: string[],\n  fetchImpl: typeof fetch,\n  options?: CustomFieldDefinitionQueryOptions,\n): Promise<CustomFieldDefinitionsPayload> {\n  const query = buildDefinitionsQuery(entityIds, options)\n  const res = await fetchImpl(`/api/entities/definitions?${query}`, {\n    headers: { 'content-type': 'application/json' },\n  })\n  const data = await res.json().catch(() => ({ items: [] }))\n  return preparePayload(data)\n}\n\nasync function readDefinitionsViaApi(entityIds: string[], options?: CustomFieldDefinitionQueryOptions): Promise<CustomFieldDefinitionsPayload> {\n  const query = buildDefinitionsQuery(entityIds, options)\n  const payload = await readApiResultOrThrow<CustomFieldDefinitionsResponse>(\n    `/api/entities/definitions?${query}`,\n    { headers: { 'content-type': 'application/json' } },\n    {\n      errorMessage: 'Failed to load custom field definitions',\n      fallback: { items: [] },\n    },\n  )\n  return preparePayload(payload)\n}\n\nexport async function fetchCustomFieldDefinitionsPayload(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: CustomFieldDefinitionQueryOptions,\n): Promise<CustomFieldDefinitionsPayload> {\n  const filtered = normalizeEntityIds(entityIds)\n  if (!filtered.length) return { items: [] }\n  return fetchImpl\n    ? await readDefinitionsViaFetch(filtered, fetchImpl, options)\n    : await readDefinitionsViaApi(filtered, options)\n}\n\nexport async function fetchCustomFieldDefs(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: CustomFieldDefinitionQueryOptions,\n): Promise<CustomFieldDefDto[]> {\n  const payload = await fetchCustomFieldDefinitionsPayload(entityIds, fetchImpl, options)\n  return payload.items ?? []\n}\n\nexport type UseCustomFieldDefsOptions<TData = CustomFieldDefDto[]> = {\n  enabled?: boolean\n  staleTime?: number\n  gcTime?: number\n  /** @deprecated Custom fetch implementations are no longer needed. */\n  fetchImpl?: typeof fetch\n  keyExtras?: Array<string | number | boolean | null | undefined>\n  fieldset?: string\n  select?: (data: CustomFieldDefDto[]) => TData\n}\n\nexport function useCustomFieldDefs<TData = CustomFieldDefDto[]>(\n  entityIds: string | string[] | null | undefined,\n  options: UseCustomFieldDefsOptions<TData> = {}\n): UseQueryResult<TData> {\n  const {\n    enabled: enabledOption = true,\n    staleTime,\n    gcTime,\n    keyExtras,\n    fetchImpl,\n    fieldset,\n  } = options\n  const normalizedIds = React.useMemo(() => normalizeEntityIds(entityIds), [entityIds])\n  const idsSignature = React.useMemo(() => JSON.stringify(normalizedIds), [normalizedIds])\n  const extrasSignature = React.useMemo(() => JSON.stringify(keyExtras ?? []), [keyExtras])\n  const normalizedFieldset = typeof fieldset === 'string' && fieldset.trim().length ? fieldset.trim() : null\n  const queryKey = React.useMemo(\n    () => ['customFieldDefs', ...(keyExtras ?? []), ...normalizedIds, `fieldset:${normalizedFieldset ?? 'default'}`],\n    [idsSignature, extrasSignature, normalizedFieldset]\n  )\n  const enabled = enabledOption && normalizedIds.length > 0\n\n  return useQuery<CustomFieldDefDto[], Error, TData>({\n    queryKey,\n    queryFn: () =>\n      fetchCustomFieldDefs(\n        normalizedIds,\n        fetchImpl,\n        normalizedFieldset ? { fieldset: normalizedFieldset } : undefined\n      ),\n    enabled,\n    staleTime: staleTime ?? 5 * 60 * 1000,\n    gcTime: gcTime ?? 30 * 60 * 1000,\n    select: options.select,\n  })\n}\n\nexport type CustomFieldVisibility = 'list' | 'form' | 'filter'\n\nexport function isDefVisible(def: CustomFieldDefDto, mode: CustomFieldVisibility): boolean {\n  switch (mode) {\n    case 'list':\n      return def.listVisible !== false\n    case 'form':\n      return def.formEditable !== false\n    case 'filter':\n      return !!def.filterable\n    default:\n      return true\n  }\n}\n\nexport function filterCustomFieldDefs(defs: CustomFieldDefDto[], mode: CustomFieldVisibility): CustomFieldDefDto[] {\n  return defs\n    .filter((d) => isDefVisible(d, mode))\n    .sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0))\n}\n\nexport async function invalidateCustomFieldDefs(\n  queryClient: QueryClient,\n  entityIds?: string | string[] | null,\n): Promise<void> {\n  const normalizedIds = normalizeEntityIds(entityIds)\n  const targetPrefixes = new Set(['customFieldDefs', 'customFieldForms', 'dealFormFields'])\n  if (!normalizedIds.length) {\n    await queryClient.invalidateQueries({\n      predicate: (query) => Array.isArray(query.queryKey) && typeof query.queryKey[0] === 'string' && targetPrefixes.has(query.queryKey[0] as string),\n    })\n    return\n  }\n  await queryClient.invalidateQueries({\n    predicate: (query) => {\n      if (!Array.isArray(query.queryKey)) return false\n      const [prefix] = query.queryKey\n      if (typeof prefix !== 'string' || !targetPrefixes.has(prefix)) return false\n      return normalizedIds.every((id) => query.queryKey.includes(id))\n    },\n  })\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/ui",
-  "version": "0.6.7-develop.6660.1.90e1e2eef6",
+  "version": "0.6.7-develop.6669.1.40b669666b",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -155,13 +155,13 @@
     "remark-gfm": "^4.0.1"
   },
   "peerDependencies": {
-    "@open-mercato/shared": "0.6.7-develop.6660.1.90e1e2eef6",
+    "@open-mercato/shared": "0.6.7-develop.6669.1.40b669666b",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "react-is": ">=18.0.0"
   },
   "devDependencies": {
-    "@open-mercato/shared": "0.6.7-develop.6660.1.90e1e2eef6",
+    "@open-mercato/shared": "0.6.7-develop.6669.1.40b669666b",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/backend/__tests__/custom-field-columns.test.ts

@@ -0,0 +1,28 @@
+import { mapCustomFieldKindToFilterType, supportsCustomFieldColumn } from '../utils/customFieldColumns'
+import type { CustomFieldDefDto } from '../utils/customFieldDefs'
+
+describe('mapCustomFieldKindToFilterType', () => {
+  it('maps phone to a free-text filter (#62)', () => {
+    expect(mapCustomFieldKindToFilterType('phone')).toBe('text')
+  })
+
+  it('keeps the established mappings for other kinds', () => {
+    expect(mapCustomFieldKindToFilterType('boolean')).toBe('boolean')
+    expect(mapCustomFieldKindToFilterType('integer')).toBe('number')
+    expect(mapCustomFieldKindToFilterType('float')).toBe('number')
+    expect(mapCustomFieldKindToFilterType('date')).toBe('date')
+    expect(mapCustomFieldKindToFilterType('select')).toBe('select')
+    expect(mapCustomFieldKindToFilterType('dictionary')).toBe('select')
+    expect(mapCustomFieldKindToFilterType('text')).toBe('text')
+  })
+})
+
+describe('supportsCustomFieldColumn', () => {
+  it('renders a phone value as a normal list column (#62)', () => {
+    expect(supportsCustomFieldColumn({ key: 'work_phone', kind: 'phone' } as CustomFieldDefDto)).toBe(true)
+  })
+
+  it('still excludes attachment columns', () => {
+    expect(supportsCustomFieldColumn({ key: 'files', kind: 'attachment' } as CustomFieldDefDto)).toBe(false)
+  })
+})

package/src/backend/__tests__/custom-field-filters.test.ts

@@ -32,6 +32,7 @@ describe('buildFilterDefsFromCustomFields', () => {
         multi: true,
       },
       { key: 'notes', kind: 'multiline', filterable: true },
+      { key: 'work_phone', kind: 'phone', filterable: true },
       { key: 'hidden', kind: 'text', filterable: false },
     ]
 
@@ -58,6 +59,8 @@ describe('buildFilterDefsFromCustomFields', () => {
     expect(typeof regions.loadOptions).toBe('function')
     // text-like (multiline) => text
     expect(out.find(f => f.id === 'cf_notes')!.type).toBe('text')
+    // phone filters as free text
+    expect(out.find(f => f.id === 'cf_work_phone')!.type).toBe('text')
     // non-filterable omitted
     expect(out.some(f => f.id === 'cf_hidden')).toBe(false)
   })

package/src/backend/__tests__/custom-field-forms.test.ts

@@ -5,6 +5,7 @@ import { FieldRegistry } from '../fields/registry'
 describe('buildFormFieldsFromCustomFields', () => {
   beforeAll(() => {
     FieldRegistry.register('dictionary', { input: () => null })
+    FieldRegistry.register('phone', { input: () => null })
   })
 
   it('maps kinds to CrudField and filters by formEditable', () => {
@@ -33,6 +34,7 @@ describe('buildFormFieldsFromCustomFields', () => {
         filterable: true,
         formEditable: true,
       },
+      { key: 'work_phone', kind: 'phone', filterable: true, formEditable: true },
       { key: 'notes', kind: 'multiline', filterable: false, formEditable: true },
       // text with editor hint should render richtext
       { key: 'desc', kind: 'text', filterable: false, formEditable: true, editor: 'htmlRichText' },
@@ -65,6 +67,8 @@ describe('buildFormFieldsFromCustomFields', () => {
     if (byId['cf_labels']?.type === 'select') {
       expect(byId['cf_labels'].multiple).toBe(true)
     }
+    // Phone resolves to a custom input via the field registry
+    expect(byId['cf_work_phone']?.type).toBe('custom')
     // Multiline now defaults to richtext (markdown editor)
     expect(byId['cf_notes']?.type).toBe('richtext')
     expect(byId['cf_desc']?.type).toBe('richtext')

package/src/backend/fields/__tests__/phone.test.tsx

@@ -0,0 +1,99 @@
+/**
+ * @jest-environment jsdom
+ */
+import * as React from 'react'
+import { fireEvent, render, screen } from '@testing-library/react'
+import { FieldRegistry } from '../registry'
+import '../phone'
+
+jest.mock('@open-mercato/shared/lib/i18n/context', () => {
+  const actual = jest.requireActual('@open-mercato/shared/lib/i18n/context')
+  return {
+    ...actual,
+    useT: () => (key: string, fallback?: string) => fallback ?? key,
+  }
+})
+
+jest.mock('../../inputs/PhoneNumberField', () => ({
+  PhoneNumberField: ({ id, value, onValueChange, disabled, externalError, defaultCountryIso2 }: any) => (
+    <div>
+      <input
+        aria-label="phone"
+        id={id}
+        value={value}
+        disabled={disabled}
+        data-default-country={defaultCountryIso2 ?? ''}
+        onChange={(event) => onValueChange(event.target.value || undefined)}
+      />
+      {externalError ? <span role="alert">{externalError}</span> : null}
+    </div>
+  ),
+  PHONE_COUNTRIES: [
+    { iso2: 'US', dialCode: '+1', label: 'United States', flag: '🇺🇸' },
+    { iso2: 'PL', dialCode: '+48', label: 'Poland', flag: '🇵🇱' },
+  ],
+}))
+
+jest.mock('../../../primitives/select', () => {
+  const Passthrough = ({ children }: { children?: React.ReactNode }) => <>{children}</>
+  return {
+    Select: ({ value, onValueChange, children }: any) => (
+      <select data-testid="country-select" value={value} onChange={(event) => onValueChange(event.target.value)}>
+        {children}
+      </select>
+    ),
+    SelectContent: Passthrough,
+    SelectItem: ({ value }: any) => <option value={value} />,
+    SelectItemLeading: Passthrough,
+    SelectTrigger: () => null,
+    SelectValue: () => null,
+  }
+})
+
+describe('phone custom field', () => {
+  it('registers an input and a definition editor under the "phone" kind', () => {
+    expect(FieldRegistry.getInput('phone')).toBeDefined()
+    expect(FieldRegistry.getDefEditor('phone')).toBeDefined()
+  })
+
+  it('wraps PhoneNumberField and forwards the configured default country', () => {
+    const input = FieldRegistry.getInput('phone')
+    if (!input) throw new Error('phone input not registered')
+    const setValue = jest.fn()
+    render(
+      <>{input({ id: 'cf_work_phone', value: '+1 212 555 1234', setValue, def: { defaultCountryIso2: 'PL' } } as any)}</>,
+    )
+
+    const field = screen.getByLabelText('phone') as HTMLInputElement
+    expect(field.value).toBe('+1 212 555 1234')
+    expect(field).toHaveAttribute('data-default-country', 'PL')
+
+    fireEvent.change(field, { target: { value: '+48 600 700 800' } })
+    expect(setValue).toHaveBeenCalledWith('+48 600 700 800')
+
+    fireEvent.change(field, { target: { value: '' } })
+    expect(setValue).toHaveBeenCalledWith(undefined)
+  })
+
+  it('emits the selected default country from the definition editor', () => {
+    const defEditor = FieldRegistry.getDefEditor('phone')
+    if (!defEditor) throw new Error('phone defEditor not registered')
+    const onChange = jest.fn()
+    render(<>{defEditor({ def: { configJson: {} }, onChange })}</>)
+
+    const select = screen.getByTestId('country-select') as HTMLSelectElement
+    fireEvent.change(select, { target: { value: 'PL' } })
+    expect(onChange).toHaveBeenCalledWith({ defaultCountryIso2: 'PL' })
+  })
+
+  it('clears the default country when auto-detect is chosen', () => {
+    const defEditor = FieldRegistry.getDefEditor('phone')
+    if (!defEditor) throw new Error('phone defEditor not registered')
+    const onChange = jest.fn()
+    render(<>{defEditor({ def: { configJson: { defaultCountryIso2: 'PL' } }, onChange })}</>)
+
+    const select = screen.getByTestId('country-select') as HTMLSelectElement
+    fireEvent.change(select, { target: { value: '__om_phone_auto__' } })
+    expect(onChange).toHaveBeenCalledWith({ defaultCountryIso2: undefined })
+  })
+})

package/src/backend/fields/phone.tsx

@@ -0,0 +1,98 @@
+"use client"
+
+import * as React from 'react'
+import type { CrudCustomFieldRenderProps } from '../CrudForm'
+import { FieldRegistry } from './registry'
+import { PhoneNumberField, PHONE_COUNTRIES } from '../inputs/PhoneNumberField'
+import { useT } from '@open-mercato/shared/lib/i18n/context'
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectItemLeading,
+  SelectTrigger,
+  SelectValue,
+} from '../../primitives/select'
+
+type PhoneFieldConfig = {
+  defaultCountryIso2?: string
+}
+
+type PhoneFieldDef = PhoneFieldConfig & {
+  configJson?: PhoneFieldConfig
+}
+
+type PhoneFieldInputProps = CrudCustomFieldRenderProps & { def?: PhoneFieldDef }
+
+// Sentinel used by the definition editor to represent "no fixed default"
+// because Radix Select cannot use an empty string as an item value.
+const AUTO_COUNTRY_VALUE = '__om_phone_auto__'
+
+function PhoneFieldInput({ id, value, setValue, disabled, error, def }: PhoneFieldInputProps) {
+  const stringValue = typeof value === 'string' ? value : value == null ? '' : String(value)
+  return (
+    <PhoneNumberField
+      id={id}
+      value={stringValue}
+      onValueChange={(next) => setValue(next ?? undefined)}
+      disabled={disabled}
+      externalError={error ?? null}
+      defaultCountryIso2={def?.defaultCountryIso2}
+    />
+  )
+}
+
+function PhoneFieldDefEditor({
+  def,
+  onChange,
+}: {
+  def: { configJson?: PhoneFieldConfig } | undefined
+  onChange: (patch: Partial<PhoneFieldConfig>) => void
+}) {
+  const t = useT()
+  const selected = typeof def?.configJson?.defaultCountryIso2 === 'string' ? def.configJson.defaultCountryIso2 : ''
+  return (
+    <div className="mt-3 space-y-3 rounded border border-dashed border-muted-foreground/40 bg-muted/30 p-3">
+      <div className="space-y-1">
+        <label className="text-xs font-medium text-muted-foreground">
+          {t('ui.customFields.phone.defaultCountry', 'Default country')}
+        </label>
+        <Select
+          value={selected || AUTO_COUNTRY_VALUE}
+          onValueChange={(next) => onChange({ defaultCountryIso2: next === AUTO_COUNTRY_VALUE ? undefined : next })}
+        >
+          <SelectTrigger size="sm">
+            <SelectValue />
+          </SelectTrigger>
+          <SelectContent align="start">
+            <SelectItem value={AUTO_COUNTRY_VALUE}>
+              {t('ui.customFields.phone.defaultCountryAuto', 'Auto-detect from value')}
+            </SelectItem>
+            {PHONE_COUNTRIES.map((country) => (
+              <SelectItem key={`${country.iso2}-${country.dialCode}`} value={country.iso2}>
+                <SelectItemLeading>
+                  <span className="text-base leading-none">{country.flag}</span>
+                </SelectItemLeading>
+                <span className="flex-1 truncate">{country.label}</span>
+                <span className="ml-2 text-xs text-muted-foreground tabular-nums">{country.dialCode}</span>
+              </SelectItem>
+            ))}
+          </SelectContent>
+        </Select>
+        <p className="text-xs text-muted-foreground">
+          {t(
+            'ui.customFields.phone.defaultCountryHint',
+            'Pre-selects a country in the phone editor when the field is empty.',
+          )}
+        </p>
+      </div>
+    </div>
+  )
+}
+
+FieldRegistry.register('phone', {
+  input: (props) => <PhoneFieldInput {...props} />,
+  defEditor: (props) => <PhoneFieldDefEditor {...props} />,
+})
+
+export {}

package/src/backend/fields/registry.generated.ts

@@ -2,6 +2,7 @@
 // This file can be regenerated by module generators. Keep imports side-effectful.
 import '@open-mercato/core/modules/attachments/fields/attachment'
 import '@open-mercato/core/modules/dictionaries/fields/dictionary'
+import './phone'
 
 export function loadAll() {
   // No-op: imports above perform registration via side effects