@freighttech/ui 0.13.18

package/dist/backend/utils/customFieldDefs.js

@@ -0,0 +1,143 @@
+import * as React from "react";
+import { useQuery } from "@tanstack/react-query";
+import { readApiResultOrThrow } from "./apiCall.js";
+function normalizeEntityIds(entityIds) {
+  if (entityIds == null) return [];
+  const list = Array.isArray(entityIds) ? entityIds : [entityIds];
+  const dedup = /* @__PURE__ */ new Set();
+  const normalized = [];
+  for (const raw of list) {
+    const trimmed = String(raw ?? "").trim();
+    if (!trimmed || dedup.has(trimmed)) continue;
+    dedup.add(trimmed);
+    normalized.push(trimmed);
+  }
+  return normalized;
+}
+function buildDefinitionsQuery(entityIds, options) {
+  const params = new URLSearchParams();
+  entityIds.forEach((id) => {
+    if (id) params.append("entityId", id);
+  });
+  if (options?.fieldset) params.set("fieldset", options.fieldset);
+  return params.toString();
+}
+function normalizeRecord(value) {
+  if (!value || typeof value !== "object") return {};
+  const out = {};
+  for (const [key, raw] of Object.entries(value)) {
+    if (!Array.isArray(raw)) continue;
+    out[key] = raw;
+  }
+  return out;
+}
+function preparePayload(data) {
+  const items = Array.isArray(data?.items) ? [...data.items] : [];
+  items.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+  const fieldsetsByEntity = normalizeRecord(data?.fieldsetsByEntity);
+  const entitySettings = data?.entitySettings && typeof data.entitySettings === "object" ? data.entitySettings : {};
+  return { items, fieldsetsByEntity, entitySettings };
+}
+async function readDefinitionsViaFetch(entityIds, fetchImpl, options) {
+  const query = buildDefinitionsQuery(entityIds, options);
+  const res = await fetchImpl(`/api/entities/definitions?${query}`, {
+    headers: { "content-type": "application/json" }
+  });
+  const data = await res.json().catch(() => ({ items: [] }));
+  return preparePayload(data);
+}
+async function readDefinitionsViaApi(entityIds, options) {
+  const query = buildDefinitionsQuery(entityIds, options);
+  const payload = await readApiResultOrThrow(
+    `/api/entities/definitions?${query}`,
+    { headers: { "content-type": "application/json" } },
+    {
+      errorMessage: "Failed to load custom field definitions",
+      fallback: { items: [] }
+    }
+  );
+  return preparePayload(payload);
+}
+async function fetchCustomFieldDefinitionsPayload(entityIds, fetchImpl, options) {
+  const filtered = normalizeEntityIds(entityIds);
+  if (!filtered.length) return { items: [] };
+  return fetchImpl ? await readDefinitionsViaFetch(filtered, fetchImpl, options) : await readDefinitionsViaApi(filtered, options);
+}
+async function fetchCustomFieldDefs(entityIds, fetchImpl, options) {
+  const payload = await fetchCustomFieldDefinitionsPayload(entityIds, fetchImpl, options);
+  return payload.items ?? [];
+}
+function useCustomFieldDefs(entityIds, options = {}) {
+  const {
+    enabled: enabledOption = true,
+    staleTime,
+    gcTime,
+    keyExtras,
+    fetchImpl,
+    fieldset
+  } = options;
+  const normalizedIds = React.useMemo(() => normalizeEntityIds(entityIds), [entityIds]);
+  const idsSignature = React.useMemo(() => JSON.stringify(normalizedIds), [normalizedIds]);
+  const extrasSignature = React.useMemo(() => JSON.stringify(keyExtras ?? []), [keyExtras]);
+  const normalizedFieldset = typeof fieldset === "string" && fieldset.trim().length ? fieldset.trim() : null;
+  const queryKey = React.useMemo(
+    () => ["customFieldDefs", ...keyExtras ?? [], ...normalizedIds, `fieldset:${normalizedFieldset ?? "default"}`],
+    [idsSignature, extrasSignature, normalizedFieldset]
+  );
+  const enabled = enabledOption && normalizedIds.length > 0;
+  return useQuery({
+    queryKey,
+    queryFn: () => fetchCustomFieldDefs(
+      normalizedIds,
+      fetchImpl,
+      normalizedFieldset ? { fieldset: normalizedFieldset } : void 0
+    ),
+    enabled,
+    staleTime: staleTime ?? 5 * 60 * 1e3,
+    gcTime: gcTime ?? 30 * 60 * 1e3,
+    select: options.select
+  });
+}
+function isDefVisible(def, mode) {
+  switch (mode) {
+    case "list":
+      return def.listVisible !== false;
+    case "form":
+      return def.formEditable !== false;
+    case "filter":
+      return !!def.filterable;
+    default:
+      return true;
+  }
+}
+function filterCustomFieldDefs(defs, mode) {
+  return defs.filter((d) => isDefVisible(d, mode)).sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
+}
+async function invalidateCustomFieldDefs(queryClient, entityIds) {
+  const normalizedIds = normalizeEntityIds(entityIds);
+  const targetPrefixes = /* @__PURE__ */ new Set(["customFieldDefs", "customFieldForms", "dealFormFields"]);
+  if (!normalizedIds.length) {
+    await queryClient.invalidateQueries({
+      predicate: (query) => Array.isArray(query.queryKey) && typeof query.queryKey[0] === "string" && targetPrefixes.has(query.queryKey[0])
+    });
+    return;
+  }
+  await queryClient.invalidateQueries({
+    predicate: (query) => {
+      if (!Array.isArray(query.queryKey)) return false;
+      const [prefix] = query.queryKey;
+      if (typeof prefix !== "string" || !targetPrefixes.has(prefix)) return false;
+      return normalizedIds.every((id) => query.queryKey.includes(id));
+    }
+  });
+}
+export {
+  fetchCustomFieldDefinitionsPayload,
+  fetchCustomFieldDefs,
+  filterCustomFieldDefs,
+  invalidateCustomFieldDefs,
+  isDefVisible,
+  normalizeEntityIds,
+  useCustomFieldDefs
+};
+//# sourceMappingURL=customFieldDefs.js.map

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

@@ -0,0 +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": "AAAA,YAAY,WAAW;AACvB,SAAS,gBAAuD;AAChE,SAAS,4BAA4B;AA2D9B,SAAS,mBAAmB,WAA2D;AAC5F,MAAI,aAAa,KAAM,QAAO,CAAC;AAC/B,QAAM,OAAO,MAAM,QAAQ,SAAS,IAAI,YAAY,CAAC,SAAS;AAC9D,QAAM,QAAQ,oBAAI,IAAY;AAC9B,QAAM,aAAuB,CAAC;AAC9B,aAAW,OAAO,MAAM;AACtB,UAAM,UAAU,OAAO,OAAO,EAAE,EAAE,KAAK;AACvC,QAAI,CAAC,WAAW,MAAM,IAAI,OAAO,EAAG;AACpC,UAAM,IAAI,OAAO;AACjB,eAAW,KAAK,OAAO;AAAA,EACzB;AACA,SAAO;AACT;AAMA,SAAS,sBAAsB,WAAqB,SAAqD;AACvG,QAAM,SAAS,IAAI,gBAAgB;AACnC,YAAU,QAAQ,CAAC,OAAO;AACxB,QAAI,GAAI,QAAO,OAAO,YAAY,EAAE;AAAA,EACtC,CAAC;AACD,MAAI,SAAS,SAAU,QAAO,IAAI,YAAY,QAAQ,QAAQ;AAC9D,SAAO,OAAO,SAAS;AACzB;AAIA,SAAS,gBAAmB,OAAqC;AAC/D,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO,CAAC;AACjD,QAAM,MAA2B,CAAC;AAClC,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,KAAgC,GAAG;AACzE,QAAI,CAAC,MAAM,QAAQ,GAAG,EAAG;AACzB,QAAI,GAAG,IAAI;AAAA,EACb;AACA,SAAO;AACT;AAEA,SAAS,eAAe,MAAwF;AAC9G,QAAM,QAAQ,MAAM,QAAQ,MAAM,KAAK,IAAI,CAAC,GAAG,KAAM,KAAK,IAAI,CAAC;AAC/D,QAAM,KAAK,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,YAAY,EAAE;AAC1D,QAAM,oBAAoB,gBAAmC,MAAM,iBAAiB;AACpF,QAAM,iBAAkB,MAAM,kBAAkB,OAAO,KAAK,mBAAmB,WAC3E,KAAK,iBACL,CAAC;AACL,SAAO,EAAE,OAAO,mBAAmB,eAAe;AACpD;AAEA,eAAe,wBACb,WACA,WACA,SACwC;AACxC,QAAM,QAAQ,sBAAsB,WAAW,OAAO;AACtD,QAAM,MAAM,MAAM,UAAU,6BAA6B,KAAK,IAAI;AAAA,IAChE,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,EAChD,CAAC;AACD,QAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE;AACzD,SAAO,eAAe,IAAI;AAC5B;AAEA,eAAe,sBAAsB,WAAqB,SAAqF;AAC7I,QAAM,QAAQ,sBAAsB,WAAW,OAAO;AACtD,QAAM,UAAU,MAAM;AAAA,IACpB,6BAA6B,KAAK;AAAA,IAClC,EAAE,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,IAClD;AAAA,MACE,cAAc;AAAA,MACd,UAAU,EAAE,OAAO,CAAC,EAAE;AAAA,IACxB;AAAA,EACF;AACA,SAAO,eAAe,OAAO;AAC/B;AAEA,eAAsB,mCACpB,WACA,WACA,SACwC;AACxC,QAAM,WAAW,mBAAmB,SAAS;AAC7C,MAAI,CAAC,SAAS,OAAQ,QAAO,EAAE,OAAO,CAAC,EAAE;AACzC,SAAO,YACH,MAAM,wBAAwB,UAAU,WAAW,OAAO,IAC1D,MAAM,sBAAsB,UAAU,OAAO;AACnD;AAEA,eAAsB,qBACpB,WACA,WACA,SAC8B;AAC9B,QAAM,UAAU,MAAM,mCAAmC,WAAW,WAAW,OAAO;AACtF,SAAO,QAAQ,SAAS,CAAC;AAC3B;AAaO,SAAS,mBACd,WACA,UAA4C,CAAC,GACtB;AACvB,QAAM;AAAA,IACJ,SAAS,gBAAgB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AACJ,QAAM,gBAAgB,MAAM,QAAQ,MAAM,mBAAmB,SAAS,GAAG,CAAC,SAAS,CAAC;AACpF,QAAM,eAAe,MAAM,QAAQ,MAAM,KAAK,UAAU,aAAa,GAAG,CAAC,aAAa,CAAC;AACvF,QAAM,kBAAkB,MAAM,QAAQ,MAAM,KAAK,UAAU,aAAa,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;AACxF,QAAM,qBAAqB,OAAO,aAAa,YAAY,SAAS,KAAK,EAAE,SAAS,SAAS,KAAK,IAAI;AACtG,QAAM,WAAW,MAAM;AAAA,IACrB,MAAM,CAAC,mBAAmB,GAAI,aAAa,CAAC,GAAI,GAAG,eAAe,YAAY,sBAAsB,SAAS,EAAE;AAAA,IAC/G,CAAC,cAAc,iBAAiB,kBAAkB;AAAA,EACpD;AACA,QAAM,UAAU,iBAAiB,cAAc,SAAS;AAExD,SAAO,SAA4C;AAAA,IACjD;AAAA,IACA,SAAS,MACP;AAAA,MACE;AAAA,MACA;AAAA,MACA,qBAAqB,EAAE,UAAU,mBAAmB,IAAI;AAAA,IAC1D;AAAA,IACF;AAAA,IACA,WAAW,aAAa,IAAI,KAAK;AAAA,IACjC,QAAQ,UAAU,KAAK,KAAK;AAAA,IAC5B,QAAQ,QAAQ;AAAA,EAClB,CAAC;AACH;AAIO,SAAS,aAAa,KAAwB,MAAsC;AACzF,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,IAAI,gBAAgB;AAAA,IAC7B,KAAK;AACH,aAAO,IAAI,iBAAiB;AAAA,IAC9B,KAAK;AACH,aAAO,CAAC,CAAC,IAAI;AAAA,IACf;AACE,aAAO;AAAA,EACX;AACF;AAEO,SAAS,sBAAsB,MAA2B,MAAkD;AACjH,SAAO,KACJ,OAAO,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,EACnC,KAAK,CAAC,GAAG,OAAO,EAAE,YAAY,MAAM,EAAE,YAAY,EAAE;AACzD;AAEA,eAAsB,0BACpB,aACA,WACe;AACf,QAAM,gBAAgB,mBAAmB,SAAS;AAClD,QAAM,iBAAiB,oBAAI,IAAI,CAAC,mBAAmB,oBAAoB,gBAAgB,CAAC;AACxF,MAAI,CAAC,cAAc,QAAQ;AACzB,UAAM,YAAY,kBAAkB;AAAA,MAClC,WAAW,CAAC,UAAU,MAAM,QAAQ,MAAM,QAAQ,KAAK,OAAO,MAAM,SAAS,CAAC,MAAM,YAAY,eAAe,IAAI,MAAM,SAAS,CAAC,CAAW;AAAA,IAChJ,CAAC;AACD;AAAA,EACF;AACA,QAAM,YAAY,kBAAkB;AAAA,IAClC,WAAW,CAAC,UAAU;AACpB,UAAI,CAAC,MAAM,QAAQ,MAAM,QAAQ,EAAG,QAAO;AAC3C,YAAM,CAAC,MAAM,IAAI,MAAM;AACvB,UAAI,OAAO,WAAW,YAAY,CAAC,eAAe,IAAI,MAAM,EAAG,QAAO;AACtE,aAAO,cAAc,MAAM,CAAC,OAAO,MAAM,SAAS,SAAS,EAAE,CAAC;AAAA,IAChE;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

package/dist/backend/utils/customFieldFilters.js

@@ -0,0 +1,151 @@
+import * as React from "react";
+import { useCustomFieldDefs } from "./customFieldDefs.js";
+import { mapCustomFieldKindToFilterType } from "./customFieldColumns.js";
+import { filterCustomFieldDefs, fetchCustomFieldDefs as loadCustomFieldDefs } from "./customFieldDefs.js";
+import { apiCall } from "./apiCall.js";
+import { CURRENCY_OPTIONS_URL } from "@open-mercato/shared/modules/entities/kinds";
+function buildOptionsUrl(base, query) {
+  if (!query) return base;
+  try {
+    const isAbsolute = /^([a-z][a-z\d+\-.]*:)?\/\//i.test(base);
+    const origin = typeof window !== "undefined" ? window.location.origin : "http://localhost";
+    const url = isAbsolute ? new URL(base) : new URL(base, origin);
+    if (!url.searchParams.has("query")) url.searchParams.append("query", query);
+    if (!url.searchParams.has("q")) url.searchParams.append("q", query);
+    if (isAbsolute) return url.toString();
+    return `${url.pathname}${url.search}`;
+  } catch {
+    const sep = base.includes("?") ? "&" : "?";
+    if (base.includes("query=")) return `${base}${sep}q=${encodeURIComponent(query)}`;
+    return `${base}${sep}query=${encodeURIComponent(query)}`;
+  }
+}
+async function loadRemoteOptions(url) {
+  try {
+    const call = await apiCall(url, void 0, { fallback: { items: [] } });
+    if (!call.ok) return [];
+    const payload = call.result ?? { items: [] };
+    const items = Array.isArray(payload?.items) ? payload.items : [];
+    return items.map((it) => ({
+      value: String(it?.value ?? it),
+      label: String(it?.label ?? it?.value ?? it)
+    }));
+  } catch {
+    return [];
+  }
+}
+function normalizeOptions(options) {
+  if (!Array.isArray(options)) return [];
+  return options.map((option) => {
+    if (option && typeof option === "object" && "value" in option) {
+      const rawValue = option.value;
+      const rawLabel = option.label ?? rawValue;
+      const value2 = String(rawValue);
+      const label = typeof rawLabel === "string" ? rawLabel : String(rawLabel);
+      return { value: value2, label };
+    }
+    const value = String(option);
+    return { value, label: value.charAt(0).toUpperCase() + value.slice(1) };
+  });
+}
+function buildFilterDefsFromCustomFields(defs) {
+  const f = [];
+  const visible = filterCustomFieldDefs(defs, "filter");
+  const seenKeys = /* @__PURE__ */ new Set();
+  for (const d of visible) {
+    const keyLower = String(d.key).toLowerCase();
+    if (seenKeys.has(keyLower)) continue;
+    seenKeys.add(keyLower);
+    const id = `cf_${d.key}`;
+    const label = d.label || d.key;
+    if (d.kind === "boolean") {
+      f.push({ id, label, type: "checkbox" });
+    } else if (d.kind === "select" || d.kind === "currency" || d.kind === "relation" || d.kind === "dictionary") {
+      const options = normalizeOptions(d.options);
+      const base = { id: d.multi ? `${id}In` : id, label, type: "select", multiple: !!d.multi, options };
+      const optionsUrl = d.kind === "currency" ? CURRENCY_OPTIONS_URL : d.optionsUrl;
+      if (optionsUrl) {
+        ;
+        base.loadOptions = async (query) => {
+          const url = buildOptionsUrl(optionsUrl, query);
+          return loadRemoteOptions(url);
+        };
+      }
+      f.push(base);
+    } else if (d.kind === "text" && d.multi) {
+      const base = {
+        id: `${id}In`,
+        label,
+        type: "tags",
+        // If static options provided, pass them for suggestions
+        options: normalizeOptions(d.options)
+      };
+      if (d.optionsUrl) {
+        ;
+        base.loadOptions = async (query) => {
+          const url = buildOptionsUrl(d.optionsUrl, query);
+          return loadRemoteOptions(url);
+        };
+      }
+      f.push(base);
+    } else {
+      f.push({ id, label, type: "text" });
+    }
+  }
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of f) {
+    if (seen.has(item.id)) continue;
+    seen.add(item.id);
+    out.push(item);
+  }
+  const order = new Map(visible.map((v, idx) => [v.key, idx]));
+  out.sort((a, b) => (order.get(a.id.replace(/^cf_/, "").replace(/In$/, "")) ?? 0) - (order.get(b.id.replace(/^cf_/, "").replace(/In$/, "")) ?? 0));
+  return out;
+}
+function buildAdvancedFilterFieldsFromCustomFields(defs, groupLabel) {
+  const visible = filterCustomFieldDefs(defs, "filter");
+  const seenKeys = /* @__PURE__ */ new Set();
+  const fields = [];
+  for (const d of visible) {
+    const keyLower = String(d.key).toLowerCase();
+    if (seenKeys.has(keyLower)) continue;
+    seenKeys.add(keyLower);
+    const type = mapCustomFieldKindToFilterType(d.kind);
+    const field = {
+      key: `cf_${d.key}`,
+      label: d.label || d.key,
+      type,
+      group: groupLabel ?? "Custom Fields"
+    };
+    if (type === "select") {
+      const opts = normalizeOptions(d.options);
+      if (opts.length) field.options = opts;
+    }
+    fields.push(field);
+  }
+  return fields;
+}
+async function fetchCustomFieldFilterDefs(entityIds, fetchImpl, options) {
+  const defs = await loadCustomFieldDefs(
+    entityIds,
+    fetchImpl,
+    options?.fieldset ? { fieldset: options.fieldset } : void 0
+  );
+  return buildFilterDefsFromCustomFields(defs);
+}
+function useCustomFieldFilterDefs(entityIds, options = {}) {
+  const { select, ...rest } = options;
+  const selectFn = React.useCallback(
+    (defs) => select ? select(defs) : buildFilterDefsFromCustomFields(defs),
+    [select]
+  );
+  return useCustomFieldDefs(entityIds, { ...rest, select: selectFn });
+}
+export {
+  buildAdvancedFilterFieldsFromCustomFields,
+  buildFilterDefsFromCustomFields,
+  fetchCustomFieldFilterDefs,
+  useCustomFieldFilterDefs
+};
+//# sourceMappingURL=customFieldFilters.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/backend/utils/customFieldFilters.ts"],
+  "sourcesContent": ["import * as React from 'react'\nimport { useCustomFieldDefs, type UseCustomFieldDefsOptions } from './customFieldDefs'\nimport { Filter } from '@open-mercato/shared/lib/query/types'\nimport type { FilterDef } from '../FilterOverlay'\nimport type { FilterFieldDef as AdvancedFilterFieldDef, FilterFieldType, FilterOption } from '@open-mercato/shared/lib/query/advanced-filter'\nimport { mapCustomFieldKindToFilterType, normalizeCustomFieldFilterOptions } from './customFieldColumns'\nimport type { CustomFieldDefDto } from './customFieldDefs'\nexport type { CustomFieldDefDto }\nimport { filterCustomFieldDefs, fetchCustomFieldDefs as loadCustomFieldDefs } from './customFieldDefs'\nimport { type UseQueryResult } from '@tanstack/react-query'\nimport { apiCall } from './apiCall'\nimport { CURRENCY_OPTIONS_URL } from '@open-mercato/shared/modules/entities/kinds'\n\nfunction buildOptionsUrl(base: string, query?: string): string {\n  if (!query) return base\n  try {\n    const isAbsolute = /^([a-z][a-z\\d+\\-.]*:)?\\/\\//i.test(base)\n    const origin = typeof window !== 'undefined' ? window.location.origin : 'http://localhost'\n    const url = isAbsolute ? new URL(base) : new URL(base, origin)\n    if (!url.searchParams.has('query')) url.searchParams.append('query', query)\n    if (!url.searchParams.has('q')) url.searchParams.append('q', query)\n    if (isAbsolute) return url.toString()\n    return `${url.pathname}${url.search}`\n  } catch {\n    const sep = base.includes('?') ? '&' : '?'\n    if (base.includes('query=')) return `${base}${sep}q=${encodeURIComponent(query)}`\n    return `${base}${sep}query=${encodeURIComponent(query)}`\n  }\n}\n\ntype OptionsResponse = { items?: unknown[] }\n\nasync function loadRemoteOptions(url: string): Promise<Array<{ value: string; label: string }>> {\n  try {\n    const call = await apiCall<OptionsResponse>(url, undefined, { fallback: { items: [] } })\n    if (!call.ok) return []\n    const payload = call.result ?? { items: [] }\n    const items = Array.isArray(payload?.items) ? payload.items : []\n    return items.map((it: any) => ({\n      value: String(it?.value ?? it),\n      label: String(it?.label ?? it?.value ?? it),\n    }))\n  } catch {\n    return []\n  }\n}\n\ntype RawOption = string | number | { value?: unknown; label?: unknown }\n\nfunction normalizeOptions(options?: RawOption[]): Array<{ value: string; label: string }> {\n  if (!Array.isArray(options)) return []\n  return options.map((option) => {\n    if (option && typeof option === 'object' && 'value' in option) {\n      const rawValue = (option as any).value\n      const rawLabel = (option as any).label ?? rawValue\n      const value = String(rawValue)\n      const label = typeof rawLabel === 'string' ? rawLabel : String(rawLabel)\n      return { value, label }\n    }\n    const value = String(option)\n    return { value, label: value.charAt(0).toUpperCase() + value.slice(1) }\n  })\n}\n\nexport function buildFilterDefsFromCustomFields(defs: CustomFieldDefDto[]): FilterDef[] {\n  const f: FilterDef[] = []\n  const visible = filterCustomFieldDefs(defs, 'filter')\n  const seenKeys = new Set<string>() // case-insensitive de-dupe by key\n  for (const d of visible) {\n    const keyLower = String(d.key).toLowerCase()\n    if (seenKeys.has(keyLower)) continue\n    seenKeys.add(keyLower)\n    const id = `cf_${d.key}`\n    const label = d.label || d.key\n    if (d.kind === 'boolean') {\n      f.push({ id, label, type: 'checkbox' })\n    } else if (d.kind === 'select' || d.kind === 'currency' || d.kind === 'relation' || d.kind === 'dictionary') {\n      const options = normalizeOptions(d.options)\n      const base: FilterDef = { id: d.multi ? `${id}In` : id, label, type: 'select', multiple: !!d.multi, options }\n      // When optionsUrl is provided, allow async options loading for filters too\n      const optionsUrl = d.kind === 'currency' ? CURRENCY_OPTIONS_URL : d.optionsUrl\n      if (optionsUrl) {\n        ;(base as FilterDef).loadOptions = async (query?: string) => {\n          const url = buildOptionsUrl(optionsUrl, query)\n          return loadRemoteOptions(url)\n        }\n      }\n      f.push(base)\n    } else if (d.kind === 'text' && d.multi) {\n      // Multi-text custom field \u2192 use tags input in filters\n      const base: FilterDef = {\n        id: `${id}In`,\n        label,\n        type: 'tags',\n        // If static options provided, pass them for suggestions\n        options: normalizeOptions(d.options),\n      } as any\n      // Enable async suggestions when optionsUrl provided\n      if (d.optionsUrl) {\n        ;(base as any).loadOptions = async (query?: string) => {\n          const url = buildOptionsUrl(d.optionsUrl!, query)\n          return loadRemoteOptions(url)\n        }\n      }\n      f.push(base)\n    } else {\n      f.push({ id, label, type: 'text' })\n    }\n  }\n  // De-duplicate by id in case of overlaps; keep first occurrence\n  const out: FilterDef[] = []\n  const seen = new Set<string>()\n  for (const item of f) {\n    if (seen.has(item.id)) continue\n    seen.add(item.id)\n    out.push(item)\n  }\n  // Preserve the original visible order (already sorted by priority) by mapping back\n  const order = new Map(visible.map((v, idx) => [v.key, idx]))\n  out.sort((a, b) => (order.get(a.id.replace(/^cf_/, '').replace(/In$/, '')) ?? 0) - (order.get(b.id.replace(/^cf_/, '').replace(/In$/, '')) ?? 0))\n  return out\n}\n\nexport function buildAdvancedFilterFieldsFromCustomFields(\n  defs: CustomFieldDefDto[],\n  groupLabel?: string,\n): AdvancedFilterFieldDef[] {\n  const visible = filterCustomFieldDefs(defs, 'filter')\n  const seenKeys = new Set<string>()\n  const fields: AdvancedFilterFieldDef[] = []\n  for (const d of visible) {\n    const keyLower = String(d.key).toLowerCase()\n    if (seenKeys.has(keyLower)) continue\n    seenKeys.add(keyLower)\n    const type = mapCustomFieldKindToFilterType(d.kind)\n    const field: AdvancedFilterFieldDef = {\n      key: `cf_${d.key}`,\n      label: d.label || d.key,\n      type,\n      group: groupLabel ?? 'Custom Fields',\n    }\n    if (type === 'select') {\n      const opts = normalizeOptions(d.options) as FilterOption[]\n      if (opts.length) field.options = opts\n    }\n    fields.push(field)\n  }\n  return fields\n}\n\nexport async function fetchCustomFieldFilterDefs(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: { fieldset?: string },\n): Promise<FilterDef[]> {\n  const defs: CustomFieldDefDto[] = await loadCustomFieldDefs(\n    entityIds,\n    fetchImpl,\n    options?.fieldset ? { fieldset: options.fieldset } : undefined,\n  )\n  return buildFilterDefsFromCustomFields(defs)\n}\n\nexport function useCustomFieldFilterDefs(\n  entityIds: string | string[] | null | undefined,\n  options: UseCustomFieldDefsOptions<FilterDef[]> = {}\n): UseQueryResult<FilterDef[]> {\n  const { select, ...rest } = options\n  const selectFn = React.useCallback(\n    (defs: CustomFieldDefDto[]) => (select ? select(defs) : buildFilterDefsFromCustomFields(defs)),\n    [select]\n  )\n  return useCustomFieldDefs<FilterDef[]>(entityIds, { ...rest, select: selectFn })\n}\n"],
+  "mappings": "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",
+  "names": ["value"]
+}

package/dist/backend/utils/customFieldForms.js

@@ -0,0 +1,169 @@
+import {
+  filterCustomFieldDefs,
+  fetchCustomFieldDefinitionsPayload
+} from "./customFieldDefs.js";
+import { FieldRegistry, loadGeneratedFieldRegistrations } from "../fields/registry.js";
+import { apiCall } from "./apiCall.js";
+import { normalizeCustomFieldOptions } from "@open-mercato/shared/modules/entities/options";
+import { CURRENCY_OPTIONS_URL } from "@open-mercato/shared/modules/entities/kinds";
+let registryReady = null;
+async function ensureFieldRegistryReady() {
+  if (!registryReady) {
+    registryReady = loadGeneratedFieldRegistrations().catch((err) => {
+      registryReady = null;
+      throw err;
+    });
+  }
+  await registryReady;
+}
+function buildOptionsUrl(base, query) {
+  if (!query) return base;
+  try {
+    const isAbsolute = /^([a-z][a-z\d+\-.]*:)?\/\//i.test(base);
+    const origin = typeof window !== "undefined" ? window.location.origin : "http://localhost";
+    const url = isAbsolute ? new URL(base) : new URL(base, origin);
+    if (!url.searchParams.has("query")) url.searchParams.append("query", query);
+    if (!url.searchParams.has("q")) url.searchParams.append("q", query);
+    if (isAbsolute) return url.toString();
+    return `${url.pathname}${url.search}`;
+  } catch {
+    const sep = base.includes("?") ? "&" : "?";
+    if (base.includes("query=")) return `${base}${sep}q=${encodeURIComponent(query)}`;
+    return `${base}${sep}query=${encodeURIComponent(query)}`;
+  }
+}
+async function loadRemoteOptions(url) {
+  try {
+    const call = await apiCall(url, void 0, { fallback: { items: [] } });
+    if (!call.ok) return [];
+    const payload = call.result ?? { items: [] };
+    const items = Array.isArray(payload?.items) ? payload.items : [];
+    return items.map((it) => ({
+      value: String(it?.value ?? it),
+      label: String(it?.label ?? it?.value ?? it)
+    }));
+  } catch {
+    return [];
+  }
+}
+function buildFormFieldFromCustomFieldDef(def, opts) {
+  const id = opts?.bareIds ? def.key : `cf_${def.key}`;
+  const label = def.label || def.key;
+  const required = Array.isArray(def.validation) ? def.validation.some((rule) => rule && rule.rule === "required") : false;
+  const baseProps = {
+    description: def.description,
+    required,
+    ...def.defaultValue !== void 0 && def.defaultValue !== null ? { defaultValue: def.defaultValue } : {}
+  };
+  switch (def.kind) {
+    case "boolean":
+      return { id, label, type: "checkbox", ...baseProps };
+    case "integer":
+    case "float":
+      return { id, label, type: "number", ...baseProps };
+    case "date":
+      return { id, label, type: "datepicker", ...baseProps };
+    case "datetime":
+      return { id, label, type: "datetime", ...baseProps };
+    case "multiline": {
+      let editor = "uiw";
+      if (def.editor === "simpleMarkdown") editor = "simple";
+      else if (def.editor === "htmlRichText") editor = "html";
+      return { id, label, type: "richtext", ...baseProps, editor };
+    }
+    case "select":
+    case "currency":
+    case "relation":
+      return {
+        id,
+        label,
+        type: "select",
+        ...baseProps,
+        options: normalizeCustomFieldOptions(def.options || []).map((option) => ({
+          value: option.value,
+          label: option.label
+        })),
+        multiple: !!def.multi,
+        ...def.kind === "currency" ? {
+          loadOptions: async (query) => {
+            const url = buildOptionsUrl(CURRENCY_OPTIONS_URL, query);
+            return loadRemoteOptions(url);
+          }
+        } : def.optionsUrl ? {
+          loadOptions: async (query) => {
+            const url = buildOptionsUrl(def.optionsUrl, query);
+            return loadRemoteOptions(url);
+          }
+        } : {},
+        ...def.multi && def.input === "listbox" ? { listbox: true } : {}
+      };
+    default: {
+      if (def.kind === "text" && def.multi) {
+        const base = { id, label, type: "tags", ...baseProps };
+        const resolvedOptions = normalizeCustomFieldOptions(def.options || []);
+        if (resolvedOptions.length > 0) {
+          base.options = resolvedOptions.map((option) => ({ value: option.value, label: option.label }));
+        }
+        if (def.optionsUrl) {
+          base.loadOptions = async (query) => {
+            const url = buildOptionsUrl(def.optionsUrl, query);
+            return loadRemoteOptions(url);
+          };
+        }
+        return base;
+      }
+      if (def.kind === "text" && typeof def.editor === "string" && def.editor) {
+        let editor = "uiw";
+        if (def.editor === "simpleMarkdown") editor = "simple";
+        else if (def.editor === "htmlRichText") editor = "html";
+        return { id, label, type: "richtext", ...baseProps, editor };
+      }
+      const input = FieldRegistry.getInput(def.kind);
+      if (input) {
+        return {
+          id,
+          label,
+          type: "custom",
+          ...baseProps,
+          component: (props) => input({ ...props, def })
+        };
+      }
+      return { id, label, type: "text", ...baseProps };
+    }
+  }
+}
+function buildFormFieldsFromCustomFields(defs, opts) {
+  const fields = [];
+  const visible = filterCustomFieldDefs(defs, "form");
+  const seenKeys = /* @__PURE__ */ new Set();
+  for (const def of visible) {
+    const keyLower = String(def.key).toLowerCase();
+    if (seenKeys.has(keyLower)) continue;
+    seenKeys.add(keyLower);
+    const field = buildFormFieldFromCustomFieldDef(def, opts);
+    if (field) fields.push(field);
+  }
+  return fields;
+}
+async function fetchCustomFieldFormStructure(entityIds, fetchImpl, options) {
+  await ensureFieldRegistryReady();
+  const metadata = await fetchCustomFieldDefinitionsPayload(entityIds, fetchImpl);
+  const definitions = Array.isArray(metadata.items) ? metadata.items : [];
+  const fields = buildFormFieldsFromCustomFields(definitions, options);
+  return { fields, definitions, metadata };
+}
+async function fetchCustomFieldFormFields(entityIds, fetchImpl, options) {
+  const { fields } = await fetchCustomFieldFormStructure(entityIds, fetchImpl, options);
+  return fields;
+}
+async function fetchCustomFieldFormFieldsWithDefinitions(entityIds, fetchImpl, options) {
+  return fetchCustomFieldFormStructure(entityIds, fetchImpl, options);
+}
+export {
+  buildFormFieldFromCustomFieldDef,
+  buildFormFieldsFromCustomFields,
+  fetchCustomFieldFormFields,
+  fetchCustomFieldFormFieldsWithDefinitions,
+  fetchCustomFieldFormStructure
+};
+//# sourceMappingURL=customFieldForms.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/backend/utils/customFieldForms.ts"],
+  "sourcesContent": ["import type { CrudField } from '../CrudForm'\nimport type {\n  CustomFieldDefDto,\n  CustomFieldDefinitionsPayload,\n} from './customFieldDefs'\nimport {\n  filterCustomFieldDefs,\n  fetchCustomFieldDefs,\n  fetchCustomFieldDefinitionsPayload,\n} from './customFieldDefs'\nimport { FieldRegistry, loadGeneratedFieldRegistrations } from '../fields/registry'\nimport { apiCall } from './apiCall'\nimport { normalizeCustomFieldOptions } from '@open-mercato/shared/modules/entities/options'\nimport { CURRENCY_OPTIONS_URL } from '@open-mercato/shared/modules/entities/kinds'\n\nlet registryReady: Promise<void> | null = null\n\nasync function ensureFieldRegistryReady() {\n  if (!registryReady) {\n    registryReady = loadGeneratedFieldRegistrations().catch((err) => {\n      registryReady = null\n      throw err\n    })\n  }\n  await registryReady\n}\n\nfunction buildOptionsUrl(base: string, query?: string): string {\n  if (!query) return base\n  try {\n    const isAbsolute = /^([a-z][a-z\\d+\\-.]*:)?\\/\\//i.test(base)\n    const origin = typeof window !== 'undefined' ? window.location.origin : 'http://localhost'\n    const url = isAbsolute ? new URL(base) : new URL(base, origin)\n    if (!url.searchParams.has('query')) url.searchParams.append('query', query)\n    if (!url.searchParams.has('q')) url.searchParams.append('q', query)\n    if (isAbsolute) return url.toString()\n    return `${url.pathname}${url.search}`\n  } catch {\n    const sep = base.includes('?') ? '&' : '?'\n    if (base.includes('query=')) return `${base}${sep}q=${encodeURIComponent(query)}`\n    return `${base}${sep}query=${encodeURIComponent(query)}`\n  }\n}\n\ntype OptionsResponse = { items?: unknown[] }\n\nasync function loadRemoteOptions(url: string): Promise<Array<{ value: string; label: string }>> {\n  try {\n    const call = await apiCall<OptionsResponse>(url, undefined, { fallback: { items: [] } })\n    if (!call.ok) return []\n    const payload = call.result ?? { items: [] }\n    const items = Array.isArray(payload?.items) ? payload.items : []\n    return items.map((it: any) => ({\n      value: String(it?.value ?? it),\n      label: String(it?.label ?? it?.value ?? it),\n    }))\n  } catch {\n    return []\n  }\n}\n\nexport function buildFormFieldFromCustomFieldDef(\n  def: CustomFieldDefDto,\n  opts?: { bareIds?: boolean }\n): CrudField | null {\n  const id = opts?.bareIds ? def.key : `cf_${def.key}`\n  const label = def.label || def.key\n  const required = Array.isArray((def as any).validation)\n    ? ((def as any).validation as any[]).some((rule) => rule && rule.rule === 'required')\n    : false\n  const baseProps = {\n    description: def.description,\n    required,\n    ...(def.defaultValue !== undefined && def.defaultValue !== null ? { defaultValue: def.defaultValue } : {}),\n  }\n\n  switch (def.kind) {\n    case 'boolean':\n      return { id, label, type: 'checkbox', ...baseProps }\n    case 'integer':\n    case 'float':\n      return { id, label, type: 'number', ...baseProps }\n    case 'date':\n      return { id, label, type: 'datepicker', ...baseProps }\n    case 'datetime':\n      return { id, label, type: 'datetime', ...baseProps }\n    case 'multiline': {\n      let editor: 'simple' | 'uiw' | 'html' = 'uiw'\n      if (def.editor === 'simpleMarkdown') editor = 'simple'\n      else if (def.editor === 'htmlRichText') editor = 'html'\n      return { id, label, type: 'richtext', ...baseProps, editor }\n    }\n    case 'select':\n    case 'currency':\n    case 'relation':\n      return {\n        id,\n        label,\n        type: 'select',\n        ...baseProps,\n        options: normalizeCustomFieldOptions(def.options || []).map((option) => ({\n          value: option.value,\n          label: option.label,\n        })),\n        multiple: !!def.multi,\n        ...(def.kind === 'currency'\n          ? {\n              loadOptions: async (query?: string) => {\n                const url = buildOptionsUrl(CURRENCY_OPTIONS_URL, query)\n                return loadRemoteOptions(url)\n              },\n            }\n          : def.optionsUrl\n          ? {\n              loadOptions: async (query?: string) => {\n                const url = buildOptionsUrl(def.optionsUrl!, query)\n                return loadRemoteOptions(url)\n              },\n            }\n          : {}),\n        ...(def.multi && def.input === 'listbox' ? ({ listbox: true } as any) : {}),\n      }\n    default: {\n      if (def.kind === 'text' && def.multi) {\n        const base: any = { id, label, type: 'tags', ...baseProps }\n        const resolvedOptions = normalizeCustomFieldOptions(def.options || [])\n        if (resolvedOptions.length > 0) {\n          base.options = resolvedOptions.map((option) => ({ value: option.value, label: option.label }))\n        }\n        if (def.optionsUrl) {\n          base.loadOptions = async (query?: string) => {\n            const url = buildOptionsUrl(def.optionsUrl!, query)\n            return loadRemoteOptions(url)\n          }\n        }\n        return base\n      }\n      if (def.kind === 'text' && typeof def.editor === 'string' && def.editor) {\n        let editor: 'simple' | 'uiw' | 'html' = 'uiw'\n        if (def.editor === 'simpleMarkdown') editor = 'simple'\n        else if (def.editor === 'htmlRichText') editor = 'html'\n        return { id, label, type: 'richtext', ...baseProps, editor }\n      }\n      const input = FieldRegistry.getInput(def.kind)\n      if (input) {\n        return {\n          id,\n          label,\n          type: 'custom',\n          ...baseProps,\n          component: (props) => input({ ...props, def }),\n        }\n      }\n      return { id, label, type: 'text', ...baseProps }\n    }\n  }\n}\n\nexport function buildFormFieldsFromCustomFields(\n  defs: CustomFieldDefDto[],\n  opts?: { bareIds?: boolean }\n): CrudField[] {\n  const fields: CrudField[] = []\n  const visible = filterCustomFieldDefs(defs, 'form')\n  const seenKeys = new Set<string>()\n  for (const def of visible) {\n    const keyLower = String(def.key).toLowerCase()\n    if (seenKeys.has(keyLower)) continue\n    seenKeys.add(keyLower)\n    const field = buildFormFieldFromCustomFieldDef(def, opts)\n    if (field) fields.push(field)\n  }\n  return fields\n}\n\nexport async function fetchCustomFieldFormStructure(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: { bareIds?: boolean },\n): Promise<{ fields: CrudField[]; definitions: CustomFieldDefDto[]; metadata: CustomFieldDefinitionsPayload }> {\n  await ensureFieldRegistryReady()\n  const metadata = await fetchCustomFieldDefinitionsPayload(entityIds, fetchImpl)\n  const definitions = Array.isArray(metadata.items) ? metadata.items : []\n  const fields = buildFormFieldsFromCustomFields(definitions, options)\n  return { fields, definitions, metadata }\n}\n\nexport async function fetchCustomFieldFormFields(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: { bareIds?: boolean },\n): Promise<CrudField[]> {\n  const { fields } = await fetchCustomFieldFormStructure(entityIds, fetchImpl, options)\n  return fields\n}\n\nexport async function fetchCustomFieldFormFieldsWithDefinitions(\n  entityIds: string | string[],\n  fetchImpl?: typeof fetch,\n  options?: { bareIds?: boolean },\n): Promise<{ fields: CrudField[]; definitions: CustomFieldDefDto[]; metadata: CustomFieldDefinitionsPayload }> {\n  return fetchCustomFieldFormStructure(entityIds, fetchImpl, options)\n}\n"],
+  "mappings": "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",
+  "names": []
+}