@solidxai/core-ui 0.1.12-beta.6 → 0.1.12-beta.8

package/dist/helpers/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/helpers/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,SAAS,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,CAAC,IAAM,mBAAmB,GAAG,UAAC,WAAiB,EAAE,YAAkB;IACvE,IAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACtC,IAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAErC,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF,MAAM,CAAC,IAAM,iBAAiB,GAAG,UAAC,MAAc;IAC9C,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAE3B,IAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEhC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAE1D,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC;AAGF,MAAM,CAAC,IAAM,oBAAoB,GAAG,UAAC,WAAgB;IACnD,8DAA8D;IAC9D,IAAM,WAAW,GAAQ,SAAS,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAM,WAAW,GAAQ,SAAS,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAM,WAAW,GAAQ,SAAS,CAAC,WAAW,CAAC,CAAC;IAGhD,sCAAsC;IACtC,IAAM,iBAAiB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAM,iBAAiB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAExC,IAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAE7C,OAAO,EAAE,WAAW,aAAA,EAAE,WAAW,aAAA,EAAE,iBAAiB,mBAAA,EAAE,iBAAiB,mBAAA,EAAE,WAAW,aAAA,EAAE,QAAQ,UAAA,EAAE,UAAU,YAAA,EAAE,CAAC;AAC/G,CAAC,CAAC;AAEF,SAAS,aAAa,CAAC,MAAW;IAChC,kDAAkD;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,UAAC,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACpD,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI;YAAE,OAAO,SAAS,CAAC;QAC7D,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAW;IACnD,IAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE;QAC5B,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC","sourcesContent":["\nimport { camelCase, kebabCase, snakeCase } from \"lodash\";\nimport moment from \"moment\";\nimport pluralize from \"pluralize\";\nimport qs from \"qs\";\n\nexport const calculateDaysOfStay = (checkInDate: Date, checkOutDate: Date) => {\n  const startDate = moment(checkInDate);\n  const endDate = moment(checkOutDate);\n\n  return endDate.diff(startDate, \"days\") + 1;\n};\n\nexport const addCommasToAmount = (amount: string) => {\n  amount = amount.toString();\n\n  const parts = amount.split(\".\");\n\n  parts[0] = parts[0].replace(/\\B(?=(\\d{3})+(?!\\d))/g, \",\");\n\n  return parts.join(\".\");\n};\n\n\nexport const getSingularAndPlural = (displayName: any) => {\n  // Convert display name to kebab-case (lowercase with hyphens)\n  const toKebabCase: any = kebabCase(displayName);\n\n  const toSnakeCase: any = snakeCase(displayName);\n\n  const toCamelCase: any = camelCase(displayName);\n\n\n  // Get the plural form using pluralize\n  const toPluralKebabCase = pluralize(toKebabCase);\n\n  const toPluralCamelCase = pluralize(toCamelCase);\n\n  const toPlural = pluralize(displayName);\n\n  const toSingular = pluralize(displayName, 1);\n\n  return { toKebabCase, toSnakeCase, toPluralKebabCase, toPluralCamelCase, toCamelCase, toPlural, toSingular };\n};\n\nfunction cleanForQuery(values: any) {\n  // remove files, blobs, data: URIs, null/undefined\n  return JSON.parse(JSON.stringify(values, (k, v) => {\n    if (v === null || v === undefined) return undefined;\n    if (v instanceof File || v instanceof Blob) return undefined;\n    if (typeof v === \"string\" && v.startsWith(\"data:\")) return undefined;\n    return v;\n  }));\n}\n\nexport function formikValuestoQueryString(values: any) {\n  const filtered = cleanForQuery(values);\n  return qs.stringify(filtered, {\n    encode: true,\n    arrayFormat: \"brackets\",\n    allowDots: true,\n    skipNulls: true,\n  });\n}"]}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/helpers/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport { camelCase, kebabCase, snakeCase } from \"lodash\";\nimport moment from \"moment\";\nimport pluralize from \"pluralize\";\nimport qs from \"qs\";\n\nexport const calculateDaysOfStay = (checkInDate: Date, checkOutDate: Date) => {\n  const startDate = moment(checkInDate);\n  const endDate = moment(checkOutDate);\n\n  return endDate.diff(startDate, \"days\") + 1;\n};\n\nexport const addCommasToAmount = (amount: string) => {\n  amount = amount.toString();\n\n  const parts = amount.split(\".\");\n\n  parts[0] = parts[0].replace(/\\B(?=(\\d{3})+(?!\\d))/g, \",\");\n\n  return parts.join(\".\");\n};\n\nexport const toTitleCase = (value: any) => {\n  const text = String(value ?? \"\").trim();\n  if (!text) return \"\";\n\n  return text\n    .replace(/[-_]/g, \" \")\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/\\b\\w/g, (char) => char.toUpperCase());\n};\n\n\nexport const getSingularAndPlural = (displayName: any) => {\n  // Convert display name to kebab-case (lowercase with hyphens)\n  const toKebabCase: any = kebabCase(displayName);\n\n  const toSnakeCase: any = snakeCase(displayName);\n\n  const toCamelCase: any = camelCase(displayName);\n\n\n  // Get the plural form using pluralize\n  const toPluralKebabCase = pluralize(toKebabCase);\n\n  const toPluralCamelCase = pluralize(toCamelCase);\n\n  const toPlural = pluralize(displayName);\n\n  const toSingular = pluralize(displayName, 1);\n\n  return { toKebabCase, toSnakeCase, toPluralKebabCase, toPluralCamelCase, toCamelCase, toPlural, toSingular };\n};\n\nfunction cleanForQuery(values: any) {\n  // remove files, blobs, data: URIs, null/undefined\n  return JSON.parse(JSON.stringify(values, (k, v) => {\n    if (v === null || v === undefined) return undefined;\n    if (v instanceof File || v instanceof Blob) return undefined;\n    if (typeof v === \"string\" && v.startsWith(\"data:\")) return undefined;\n    return v;\n  }));\n}\n\nexport function formikValuestoQueryString(values: any) {\n  const filtered = cleanForQuery(values);\n  return qs.stringify(filtered, {\n    encode: true,\n    arrayFormat: \"brackets\",\n    allowDots: true,\n    skipNulls: true,\n  });\n}\n"]}

package/dist/helpers/helpers.ts

@@ -21,6 +21,16 @@ export const addCommasToAmount = (amount: string) => {
   return parts.join(".");
 };
 
+export const toTitleCase = (value: any) => {
+  const text = String(value ?? "").trim();
+  if (!text) return "";
+
+  return text
+    .replace(/[-_]/g, " ")
+    .replace(/([a-z])([A-Z])/g, "$1 $2")
+    .replace(/\b\w/g, (char) => char.toUpperCase());
+};
+
 
 export const getSingularAndPlural = (displayName: any) => {
   // Convert display name to kebab-case (lowercase with hyphens)
@@ -61,4 +71,4 @@ export function formikValuestoQueryString(values: any) {
     allowDots: true,
     skipNulls: true,
   });
-}
+}

package/dist/helpers/menuItemIcons.d.ts

@@ -0,0 +1,34 @@
+import type { SolidIconName } from "../components/shad-cn-ui/SolidIcon";
+type MenuItemModelMeta = {
+    displayName?: string | null;
+    icon?: string | null;
+    pluralName?: string | null;
+    singularName?: string | null;
+    title?: string | null;
+};
+export type MenuItemIconSource = {
+    children?: MenuItemIconSource[] | null;
+    icon?: string | {
+        src?: string;
+    } | null;
+    isSystem?: boolean | null;
+    label?: string | null;
+    model?: MenuItemModelMeta | null;
+    modelMetadata?: MenuItemModelMeta | null;
+    path?: string | null;
+    solidView?: {
+        model?: MenuItemModelMeta | null;
+    } | null;
+    title?: string | null;
+};
+export type ResolvedMenuItemIcon = {
+    kind: "material";
+    name: string;
+} | {
+    kind: "solid";
+    name: SolidIconName;
+    spin?: boolean;
+};
+export declare function resolveMenuItemIcon(item?: MenuItemIconSource | null): ResolvedMenuItemIcon | undefined;
+export {};
+//# sourceMappingURL=menuItemIcons.d.ts.map

package/dist/helpers/menuItemIcons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menuItemIcons.d.ts","sourceRoot":"","sources":["../../src/helpers/menuItemIcons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAIxE,KAAK,iBAAiB,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA8H3D,wBAAgB,mBAAmB,CAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAI,oBAAoB,GAAG,SAAS,CAsCxG"}

package/dist/helpers/menuItemIcons.js

@@ -0,0 +1,144 @@
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { parseSolidIconMeta } from "../components/shad-cn-ui/SolidIcon";
+import { hasSolidMaterialIconName } from "./solidIcons";
+var TITLE_ALIAS_RULES = [
+    { pattern: /\bwhats?\s?app\b/i, icon: { kind: "material", name: "whatsapp" } },
+    { pattern: /\b(user|profile|account|contact)\b/i, icon: { kind: "material", name: "person" } },
+    { pattern: /\b(users|profiles|accounts|contacts|members?|people|teams?|groups?)\b/i, icon: { kind: "material", name: "group" } },
+    { pattern: /\b(roles?|permissions?|access)\b/i, icon: { kind: "material", name: "admin_panel_settings" } },
+    { pattern: /\b(emails?|mail|inbox)\b/i, icon: { kind: "material", name: "email" } },
+    { pattern: /\b(messages?|chats?|conversations?)\b/i, icon: { kind: "material", name: "message" } },
+    { pattern: /\b(forms?|submissions?)\b/i, icon: { kind: "material", name: "dynamic_form" } },
+    { pattern: /\b(reports?|analytics|dashboards?)\b/i, icon: { kind: "material", name: "analytics" } },
+    { pattern: /\b(settings?|configs?|configuration|preferences?)\b/i, icon: { kind: "material", name: "settings" } },
+    { pattern: /\b(files?|documents?|templates?)\b/i, icon: { kind: "material", name: "article" } },
+];
+function normalizeTextValue(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function buildMaterialIconCandidates(value) {
+    var trimmed = normalizeTextValue(value);
+    if (!trimmed) {
+        return [];
+    }
+    var camelSeparated = trimmed.replace(/([a-z0-9])([A-Z])/g, "$1 $2");
+    var snakeCase = camelSeparated
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    var compact = snakeCase.replace(/_/g, "");
+    return Array.from(new Set([trimmed, trimmed.toLowerCase(), snakeCase, compact].filter(Boolean)));
+}
+function resolveMaterialIconName(value) {
+    for (var _i = 0, _a = buildMaterialIconCandidates(value); _i < _a.length; _i++) {
+        var candidate = _a[_i];
+        if (hasSolidMaterialIconName(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function cloneResolvedIcon(icon) {
+    if (icon.kind === "solid") {
+        return {
+            kind: "solid",
+            name: icon.name,
+            spin: icon.spin,
+        };
+    }
+    return {
+        kind: "material",
+        name: icon.name,
+    };
+}
+function getRawIconCandidates(item) {
+    var _a, _b, _c, _d;
+    if (!item) {
+        return [];
+    }
+    var candidates = [
+        typeof item.icon === "string" ? item.icon : "",
+        (_a = item.model) === null || _a === void 0 ? void 0 : _a.icon,
+        (_b = item.modelMetadata) === null || _b === void 0 ? void 0 : _b.icon,
+        (_d = (_c = item.solidView) === null || _c === void 0 ? void 0 : _c.model) === null || _d === void 0 ? void 0 : _d.icon,
+    ];
+    return Array.from(new Set(candidates.map(normalizeTextValue).filter(Boolean)));
+}
+function getAliasTextCandidates(item) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+    if (!item) {
+        return [];
+    }
+    var candidates = __spreadArray([
+        item.title,
+        item.label,
+        (_a = item.model) === null || _a === void 0 ? void 0 : _a.displayName,
+        (_b = item.model) === null || _b === void 0 ? void 0 : _b.pluralName,
+        (_c = item.model) === null || _c === void 0 ? void 0 : _c.singularName,
+        (_d = item.model) === null || _d === void 0 ? void 0 : _d.title,
+        (_e = item.modelMetadata) === null || _e === void 0 ? void 0 : _e.displayName,
+        (_f = item.modelMetadata) === null || _f === void 0 ? void 0 : _f.pluralName,
+        (_g = item.modelMetadata) === null || _g === void 0 ? void 0 : _g.singularName,
+        (_h = item.modelMetadata) === null || _h === void 0 ? void 0 : _h.title,
+        (_k = (_j = item.solidView) === null || _j === void 0 ? void 0 : _j.model) === null || _k === void 0 ? void 0 : _k.displayName,
+        (_m = (_l = item.solidView) === null || _l === void 0 ? void 0 : _l.model) === null || _m === void 0 ? void 0 : _m.pluralName,
+        (_p = (_o = item.solidView) === null || _o === void 0 ? void 0 : _o.model) === null || _p === void 0 ? void 0 : _p.singularName,
+        (_r = (_q = item.solidView) === null || _q === void 0 ? void 0 : _q.model) === null || _r === void 0 ? void 0 : _r.title
+    ], getRawIconCandidates(item), true);
+    return Array.from(new Set(candidates.map(normalizeTextValue).filter(Boolean)));
+}
+function resolveAliasedIcon(item) {
+    var joinedText = getAliasTextCandidates(item).join(" ");
+    if (!joinedText) {
+        return undefined;
+    }
+    for (var _i = 0, TITLE_ALIAS_RULES_1 = TITLE_ALIAS_RULES; _i < TITLE_ALIAS_RULES_1.length; _i++) {
+        var rule = TITLE_ALIAS_RULES_1[_i];
+        if (rule.pattern.test(joinedText)) {
+            return cloneResolvedIcon(rule.icon);
+        }
+    }
+    return undefined;
+}
+export function resolveMenuItemIcon(item) {
+    if (!item) {
+        return undefined;
+    }
+    for (var _i = 0, _a = getRawIconCandidates(item); _i < _a.length; _i++) {
+        var rawIcon = _a[_i];
+        var solidIcon = parseSolidIconMeta(rawIcon);
+        if (solidIcon) {
+            return {
+                kind: "solid",
+                name: solidIcon.name,
+                spin: solidIcon.spin,
+            };
+        }
+        var materialIcon = resolveMaterialIconName(rawIcon);
+        if (materialIcon) {
+            return {
+                kind: "material",
+                name: materialIcon,
+            };
+        }
+    }
+    var derivedMaterialIcon = getAliasTextCandidates(item)
+        .map(resolveMaterialIconName)
+        .find(Boolean);
+    if (derivedMaterialIcon) {
+        return {
+            kind: "material",
+            name: derivedMaterialIcon,
+        };
+    }
+    return resolveAliasedIcon(item);
+}
+//# sourceMappingURL=menuItemIcons.js.map

package/dist/helpers/menuItemIcons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menuItemIcons.js","sourceRoot":"","sources":["../../src/helpers/menuItemIcons.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SolidIconName } from \"../components/shad-cn-ui/SolidIcon\";\nimport { parseSolidIconMeta } from \"../components/shad-cn-ui/SolidIcon\";\nimport { hasSolidMaterialIconName } from \"./solidIcons\";\n\ntype MenuItemModelMeta = {\n  displayName?: string | null;\n  icon?: string | null;\n  pluralName?: string | null;\n  singularName?: string | null;\n  title?: string | null;\n};\n\nexport type MenuItemIconSource = {\n  children?: MenuItemIconSource[] | null;\n  icon?: string | { src?: string } | null;\n  isSystem?: boolean | null;\n  label?: string | null;\n  model?: MenuItemModelMeta | null;\n  modelMetadata?: MenuItemModelMeta | null;\n  path?: string | null;\n  solidView?: { model?: MenuItemModelMeta | null } | null;\n  title?: string | null;\n};\n\nexport type ResolvedMenuItemIcon =\n  | { kind: \"material\"; name: string }\n  | { kind: \"solid\"; name: SolidIconName; spin?: boolean };\n\nconst TITLE_ALIAS_RULES: Array<{pattern: RegExp;icon: ResolvedMenuItemIcon;}> = [\n  { pattern: /\\bwhats?\\s?app\\b/i, icon: { kind: \"material\", name: \"whatsapp\" } },\n  { pattern: /\\b(user|profile|account|contact)\\b/i, icon: { kind: \"material\", name: \"person\" } },\n  { pattern: /\\b(users|profiles|accounts|contacts|members?|people|teams?|groups?)\\b/i, icon: { kind: \"material\", name: \"group\" } },\n  { pattern: /\\b(roles?|permissions?|access)\\b/i, icon: { kind: \"material\", name: \"admin_panel_settings\" } },\n  { pattern: /\\b(emails?|mail|inbox)\\b/i, icon: { kind: \"material\", name: \"email\" } },\n  { pattern: /\\b(messages?|chats?|conversations?)\\b/i, icon: { kind: \"material\", name: \"message\" } },\n  { pattern: /\\b(forms?|submissions?)\\b/i, icon: { kind: \"material\", name: \"dynamic_form\" } },\n  { pattern: /\\b(reports?|analytics|dashboards?)\\b/i, icon: { kind: \"material\", name: \"analytics\" } },\n  { pattern: /\\b(settings?|configs?|configuration|preferences?)\\b/i, icon: { kind: \"material\", name: \"settings\" } },\n  { pattern: /\\b(files?|documents?|templates?)\\b/i, icon: { kind: \"material\", name: \"article\" } },\n];\n\nfunction normalizeTextValue(value?: string | null): string {\n  return typeof value === \"string\" ? value.trim() : \"\";\n}\n\nfunction buildMaterialIconCandidates(value?: string | null): string[] {\n  const trimmed = normalizeTextValue(value);\n\n  if (!trimmed) {\n    return [];\n  }\n\n  const camelSeparated = trimmed.replace(/([a-z0-9])([A-Z])/g, \"$1 $2\");\n\n  const snakeCase = camelSeparated\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  const compact = snakeCase.replace(/_/g, \"\");\n\n  return Array.from(\n    new Set([trimmed, trimmed.toLowerCase(), snakeCase, compact].filter(Boolean))\n  );\n}\n\nfunction resolveMaterialIconName(value?: string | null): string | undefined {\n  for (const candidate of buildMaterialIconCandidates(value)) {\n    if (hasSolidMaterialIconName(candidate)) {\n      return candidate;\n    }\n  }\n\n  return undefined;\n}\n\nfunction cloneResolvedIcon(icon: ResolvedMenuItemIcon): ResolvedMenuItemIcon {\n  if (icon.kind === \"solid\") {\n    return {\n      kind: \"solid\",\n      name: icon.name,\n      spin: icon.spin,\n    };\n  }\n\n  return {\n    kind: \"material\",\n    name: icon.name,\n  };\n}\n\nfunction getRawIconCandidates(item?: MenuItemIconSource | null): string[] {\n  if (!item) {\n    return [];\n  }\n\n  const candidates = [\n    typeof item.icon === \"string\" ? item.icon : \"\",\n    item.model?.icon,\n    item.modelMetadata?.icon,\n    item.solidView?.model?.icon,\n  ];\n\n  return Array.from(\n    new Set(candidates.map(normalizeTextValue).filter(Boolean))\n  );\n}\n\nfunction getAliasTextCandidates(item?: MenuItemIconSource | null): string[] {\n  if (!item) {\n    return [];\n  }\n\n  const candidates = [\n    item.title,\n    item.label,\n    item.model?.displayName,\n    item.model?.pluralName,\n    item.model?.singularName,\n    item.model?.title,\n    item.modelMetadata?.displayName,\n    item.modelMetadata?.pluralName,\n    item.modelMetadata?.singularName,\n    item.modelMetadata?.title,\n    item.solidView?.model?.displayName,\n    item.solidView?.model?.pluralName,\n    item.solidView?.model?.singularName,\n    item.solidView?.model?.title,\n    ...getRawIconCandidates(item),\n  ];\n\n  return Array.from(\n    new Set(candidates.map(normalizeTextValue).filter(Boolean))\n  );\n}\n\nfunction resolveAliasedIcon(item?: MenuItemIconSource | null): ResolvedMenuItemIcon | undefined {\n  const joinedText = getAliasTextCandidates(item).join(\" \");\n\n  if (!joinedText) {\n    return undefined;\n  }\n\n  for (const rule of TITLE_ALIAS_RULES) {\n    if (rule.pattern.test(joinedText)) {\n      return cloneResolvedIcon(rule.icon);\n    }\n  }\n\n  return undefined;\n}\n\nexport function resolveMenuItemIcon( item?: MenuItemIconSource | null ): ResolvedMenuItemIcon | undefined {\n  if (!item) {\n    return undefined;\n  }\n\n  for (const rawIcon of getRawIconCandidates(item)) {\n    const solidIcon = parseSolidIconMeta(rawIcon);\n\n    if (solidIcon) {\n      return {\n        kind: \"solid\",\n        name: solidIcon.name,\n        spin: solidIcon.spin,\n      };\n    }\n\n    const materialIcon = resolveMaterialIconName(rawIcon);\n\n    if (materialIcon) {\n      return {\n        kind: \"material\",\n        name: materialIcon,\n      };\n    }\n  }\n\n  const derivedMaterialIcon = getAliasTextCandidates(item)\n    .map(resolveMaterialIconName)\n    .find(Boolean);\n\n  if (derivedMaterialIcon) {\n    return {\n      kind: \"material\",\n      name: derivedMaterialIcon,\n    };\n  }\n\n  return resolveAliasedIcon(item);\n}"]}

package/dist/helpers/menuItemIcons.ts

@@ -0,0 +1,191 @@
+import type { SolidIconName } from "../components/shad-cn-ui/SolidIcon";
+import { parseSolidIconMeta } from "../components/shad-cn-ui/SolidIcon";
+import { hasSolidMaterialIconName } from "./solidIcons";
+
+type MenuItemModelMeta = {
+  displayName?: string | null;
+  icon?: string | null;
+  pluralName?: string | null;
+  singularName?: string | null;
+  title?: string | null;
+};
+
+export type MenuItemIconSource = {
+  children?: MenuItemIconSource[] | null;
+  icon?: string | { src?: string } | null;
+  isSystem?: boolean | null;
+  label?: string | null;
+  model?: MenuItemModelMeta | null;
+  modelMetadata?: MenuItemModelMeta | null;
+  path?: string | null;
+  solidView?: { model?: MenuItemModelMeta | null } | null;
+  title?: string | null;
+};
+
+export type ResolvedMenuItemIcon =
+  | { kind: "material"; name: string }
+  | { kind: "solid"; name: SolidIconName; spin?: boolean };
+
+const TITLE_ALIAS_RULES: Array<{pattern: RegExp;icon: ResolvedMenuItemIcon;}> = [
+  { pattern: /\bwhats?\s?app\b/i, icon: { kind: "material", name: "whatsapp" } },
+  { pattern: /\b(user|profile|account|contact)\b/i, icon: { kind: "material", name: "person" } },
+  { pattern: /\b(users|profiles|accounts|contacts|members?|people|teams?|groups?)\b/i, icon: { kind: "material", name: "group" } },
+  { pattern: /\b(roles?|permissions?|access)\b/i, icon: { kind: "material", name: "admin_panel_settings" } },
+  { pattern: /\b(emails?|mail|inbox)\b/i, icon: { kind: "material", name: "email" } },
+  { pattern: /\b(messages?|chats?|conversations?)\b/i, icon: { kind: "material", name: "message" } },
+  { pattern: /\b(forms?|submissions?)\b/i, icon: { kind: "material", name: "dynamic_form" } },
+  { pattern: /\b(reports?|analytics|dashboards?)\b/i, icon: { kind: "material", name: "analytics" } },
+  { pattern: /\b(settings?|configs?|configuration|preferences?)\b/i, icon: { kind: "material", name: "settings" } },
+  { pattern: /\b(files?|documents?|templates?)\b/i, icon: { kind: "material", name: "article" } },
+];
+
+function normalizeTextValue(value?: string | null): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function buildMaterialIconCandidates(value?: string | null): string[] {
+  const trimmed = normalizeTextValue(value);
+
+  if (!trimmed) {
+    return [];
+  }
+
+  const camelSeparated = trimmed.replace(/([a-z0-9])([A-Z])/g, "$1 $2");
+
+  const snakeCase = camelSeparated
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "_")
+    .replace(/^_+|_+$/g, "");
+
+  const compact = snakeCase.replace(/_/g, "");
+
+  return Array.from(
+    new Set([trimmed, trimmed.toLowerCase(), snakeCase, compact].filter(Boolean))
+  );
+}
+
+function resolveMaterialIconName(value?: string | null): string | undefined {
+  for (const candidate of buildMaterialIconCandidates(value)) {
+    if (hasSolidMaterialIconName(candidate)) {
+      return candidate;
+    }
+  }
+
+  return undefined;
+}
+
+function cloneResolvedIcon(icon: ResolvedMenuItemIcon): ResolvedMenuItemIcon {
+  if (icon.kind === "solid") {
+    return {
+      kind: "solid",
+      name: icon.name,
+      spin: icon.spin,
+    };
+  }
+
+  return {
+    kind: "material",
+    name: icon.name,
+  };
+}
+
+function getRawIconCandidates(item?: MenuItemIconSource | null): string[] {
+  if (!item) {
+    return [];
+  }
+
+  const candidates = [
+    typeof item.icon === "string" ? item.icon : "",
+    item.model?.icon,
+    item.modelMetadata?.icon,
+    item.solidView?.model?.icon,
+  ];
+
+  return Array.from(
+    new Set(candidates.map(normalizeTextValue).filter(Boolean))
+  );
+}
+
+function getAliasTextCandidates(item?: MenuItemIconSource | null): string[] {
+  if (!item) {
+    return [];
+  }
+
+  const candidates = [
+    item.title,
+    item.label,
+    item.model?.displayName,
+    item.model?.pluralName,
+    item.model?.singularName,
+    item.model?.title,
+    item.modelMetadata?.displayName,
+    item.modelMetadata?.pluralName,
+    item.modelMetadata?.singularName,
+    item.modelMetadata?.title,
+    item.solidView?.model?.displayName,
+    item.solidView?.model?.pluralName,
+    item.solidView?.model?.singularName,
+    item.solidView?.model?.title,
+    ...getRawIconCandidates(item),
+  ];
+
+  return Array.from(
+    new Set(candidates.map(normalizeTextValue).filter(Boolean))
+  );
+}
+
+function resolveAliasedIcon(item?: MenuItemIconSource | null): ResolvedMenuItemIcon | undefined {
+  const joinedText = getAliasTextCandidates(item).join(" ");
+
+  if (!joinedText) {
+    return undefined;
+  }
+
+  for (const rule of TITLE_ALIAS_RULES) {
+    if (rule.pattern.test(joinedText)) {
+      return cloneResolvedIcon(rule.icon);
+    }
+  }
+
+  return undefined;
+}
+
+export function resolveMenuItemIcon( item?: MenuItemIconSource | null ): ResolvedMenuItemIcon | undefined {
+  if (!item) {
+    return undefined;
+  }
+
+  for (const rawIcon of getRawIconCandidates(item)) {
+    const solidIcon = parseSolidIconMeta(rawIcon);
+
+    if (solidIcon) {
+      return {
+        kind: "solid",
+        name: solidIcon.name,
+        spin: solidIcon.spin,
+      };
+    }
+
+    const materialIcon = resolveMaterialIconName(rawIcon);
+
+    if (materialIcon) {
+      return {
+        kind: "material",
+        name: materialIcon,
+      };
+    }
+  }
+
+  const derivedMaterialIcon = getAliasTextCandidates(item)
+    .map(resolveMaterialIconName)
+    .find(Boolean);
+
+  if (derivedMaterialIcon) {
+    return {
+      kind: "material",
+      name: derivedMaterialIcon,
+    };
+  }
+
+  return resolveAliasedIcon(item);
+}

package/dist/helpers/relationDisplay.d.ts

@@ -0,0 +1,3 @@
+export declare const getRelationDisplayText: (value: unknown) => string;
+export declare const getRelatedRecordDisplayText: (record: Record<string, unknown> | null | undefined, userKeyField?: string) => string;
+//# sourceMappingURL=relationDisplay.d.ts.map

package/dist/helpers/relationDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationDisplay.d.ts","sourceRoot":"","sources":["../../src/helpers/relationDisplay.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,sBAAsB,UAAW,OAAO,KAAG,MA8CvD,CAAC;AAEF,eAAO,MAAM,2BAA2B,WAAY,OAAO,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,iBAAiB,MAAM,KAAG,MAUvH,CAAC"}

package/dist/helpers/relationDisplay.js

@@ -0,0 +1,92 @@
+/**
+ * Normalizes relation display values into safe text for UI rendering.
+ *
+ * Relation labels in Solid can come from a configured `userKeyField`, but in
+ * some edge cases that field may contain locale maps or other JSON-shaped
+ * values instead of plain text. These helpers prevent raw objects from being
+ * passed into React by:
+ * - returning scalar values as strings
+ * - collapsing arrays into comma-separated text
+ * - preferring common label-like object keys such as `label` or `displayName`
+ * - falling back through nested object values and finally `JSON.stringify`
+ *
+ * `getRelatedRecordDisplayText` applies that normalization to a related record
+ * and falls back from the configured user-key field to `displayName`, `name`,
+ * and `id` when needed.
+ *
+ * For arbitrary JSON:
+ * - arrays are normalized item-by-item and joined with `, `
+ * - objects return the first readable nested text that can be derived
+ * - if no readable nested text is found, the object is stringified as JSON
+ *
+ * Examples:
+ * - `getRelationDisplayText("Acme")` -> `"Acme"`
+ * - `getRelationDisplayText({ en_US: "Acme", fr_FR: "Acme FR" })` -> `"Acme"`
+ * - `getRelationDisplayText({ label: "Acme", value: 12 })` -> `"Acme"`
+ * - `getRelationDisplayText(["A", { en_US: "B" }])` -> `"A, B"`
+ * - `getRelationDisplayText({ firstName: "Harish", lastName: "Patel" })` -> `"Harish"`
+ * - `getRelationDisplayText({ foo: {}, bar: [] })` -> `"{}"`
+ *   This reaches the final `JSON.stringify` fallback because no readable
+ *   scalar text can be derived from the nested values.
+ * - `getRelatedRecordDisplayText({ code: { en_US: "A-100" }, id: 7 }, "code")` -> `"A-100"`
+ * - `getRelatedRecordDisplayText({ id: 7 }, "missingField")` -> `"7"`
+ */
+var RELATION_DISPLAY_CANDIDATE_KEYS = [
+    "label",
+    "displayName",
+    "name",
+    "title",
+    "value",
+    "text",
+];
+export var getRelationDisplayText = function (value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        return value
+            .map(function (item) { return getRelationDisplayText(item); })
+            .filter(Boolean)
+            .join(", ");
+    }
+    if (typeof value === "object") {
+        var objectValue = value;
+        for (var _i = 0, RELATION_DISPLAY_CANDIDATE_KEYS_1 = RELATION_DISPLAY_CANDIDATE_KEYS; _i < RELATION_DISPLAY_CANDIDATE_KEYS_1.length; _i++) {
+            var key = RELATION_DISPLAY_CANDIDATE_KEYS_1[_i];
+            var candidate = objectValue[key];
+            var candidateText = getRelationDisplayText(candidate);
+            if (candidateText) {
+                return candidateText;
+            }
+        }
+        for (var _a = 0, _b = Object.values(objectValue); _a < _b.length; _a++) {
+            var candidate = _b[_a];
+            var candidateText = getRelationDisplayText(candidate);
+            if (candidateText) {
+                return candidateText;
+            }
+        }
+        try {
+            return JSON.stringify(objectValue);
+        }
+        catch (_c) {
+            return "";
+        }
+    }
+    return String(value);
+};
+export var getRelatedRecordDisplayText = function (record, userKeyField) {
+    var _a, _b;
+    if (!record) {
+        return "";
+    }
+    var rawDisplayValue = userKeyField ? record[userKeyField] : undefined;
+    return getRelationDisplayText((_b = (_a = rawDisplayValue !== null && rawDisplayValue !== void 0 ? rawDisplayValue : record.displayName) !== null && _a !== void 0 ? _a : record.name) !== null && _b !== void 0 ? _b : record.id);
+};
+//# sourceMappingURL=relationDisplay.js.map

package/dist/helpers/relationDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationDisplay.js","sourceRoot":"","sources":["../../src/helpers/relationDisplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,IAAM,+BAA+B,GAAG;IACpC,OAAO;IACP,aAAa;IACb,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;CACT,CAAC;AAEF,MAAM,CAAC,IAAM,sBAAsB,GAAG,UAAC,KAAc;IACjD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE;QACvC,OAAO,EAAE,CAAC;KACb;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC3B,OAAO,KAAK,CAAC;KAChB;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE;QACtF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;KACxB;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACtB,OAAO,KAAK;aACP,GAAG,CAAC,UAAC,IAAI,IAAK,OAAA,sBAAsB,CAAC,IAAI,CAAC,EAA5B,CAA4B,CAAC;aAC3C,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;KACnB;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC3B,IAAM,WAAW,GAAG,KAAgC,CAAC;QAErD,KAAkB,UAA+B,EAA/B,mEAA+B,EAA/B,6CAA+B,EAA/B,IAA+B,EAAE;YAA9C,IAAM,GAAG,wCAAA;YACV,IAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,IAAM,aAAa,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,aAAa,EAAE;gBACf,OAAO,aAAa,CAAC;aACxB;SACJ;QAED,KAAwB,UAA0B,EAA1B,KAAA,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAA1B,cAA0B,EAA1B,IAA0B,EAAE;YAA/C,IAAM,SAAS,SAAA;YAChB,IAAM,aAAa,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,aAAa,EAAE;gBACf,OAAO,aAAa,CAAC;aACxB;SACJ;QAED,IAAI;YACA,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;SACtC;QAAC,WAAM;YACJ,OAAO,EAAE,CAAC;SACb;KACJ;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,IAAM,2BAA2B,GAAG,UAAC,MAAkD,EAAE,YAAqB;;IACjH,IAAI,CAAC,MAAM,EAAE;QACT,OAAO,EAAE,CAAC;KACb;IAED,IAAM,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,OAAO,sBAAsB,CACzB,MAAA,MAAA,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,MAAM,CAAC,WAAW,mCAAI,MAAM,CAAC,IAAI,mCAAI,MAAM,CAAC,EAAE,CACpE,CAAC;AACN,CAAC,CAAC","sourcesContent":["/**\n * Normalizes relation display values into safe text for UI rendering.\n *\n * Relation labels in Solid can come from a configured `userKeyField`, but in\n * some edge cases that field may contain locale maps or other JSON-shaped\n * values instead of plain text. These helpers prevent raw objects from being\n * passed into React by:\n * - returning scalar values as strings\n * - collapsing arrays into comma-separated text\n * - preferring common label-like object keys such as `label` or `displayName`\n * - falling back through nested object values and finally `JSON.stringify`\n *\n * `getRelatedRecordDisplayText` applies that normalization to a related record\n * and falls back from the configured user-key field to `displayName`, `name`,\n * and `id` when needed.\n *\n * For arbitrary JSON:\n * - arrays are normalized item-by-item and joined with `, `\n * - objects return the first readable nested text that can be derived\n * - if no readable nested text is found, the object is stringified as JSON\n *\n * Examples:\n * - `getRelationDisplayText(\"Acme\")` -> `\"Acme\"`\n * - `getRelationDisplayText({ en_US: \"Acme\", fr_FR: \"Acme FR\" })` -> `\"Acme\"`\n * - `getRelationDisplayText({ label: \"Acme\", value: 12 })` -> `\"Acme\"`\n * - `getRelationDisplayText([\"A\", { en_US: \"B\" }])` -> `\"A, B\"`\n * - `getRelationDisplayText({ firstName: \"Harish\", lastName: \"Patel\" })` -> `\"Harish\"`\n * - `getRelationDisplayText({ foo: {}, bar: [] })` -> `\"{}\"`\n *   This reaches the final `JSON.stringify` fallback because no readable\n *   scalar text can be derived from the nested values.\n * - `getRelatedRecordDisplayText({ code: { en_US: \"A-100\" }, id: 7 }, \"code\")` -> `\"A-100\"`\n * - `getRelatedRecordDisplayText({ id: 7 }, \"missingField\")` -> `\"7\"`\n */\nconst RELATION_DISPLAY_CANDIDATE_KEYS = [\n    \"label\",\n    \"displayName\",\n    \"name\",\n    \"title\",\n    \"value\",\n    \"text\",\n];\n\nexport const getRelationDisplayText = (value: unknown): string => {\n    if (value === null || value === undefined) {\n        return \"\";\n    }\n\n    if (typeof value === \"string\") {\n        return value;\n    }\n\n    if (typeof value === \"number\" || typeof value === \"bigint\" || typeof value === \"boolean\") {\n        return String(value);\n    }\n\n    if (Array.isArray(value)) {\n        return value\n            .map((item) => getRelationDisplayText(item))\n            .filter(Boolean)\n            .join(\", \");\n    }\n\n    if (typeof value === \"object\") {\n        const objectValue = value as Record<string, unknown>;\n\n        for (const key of RELATION_DISPLAY_CANDIDATE_KEYS) {\n            const candidate = objectValue[key];\n            const candidateText = getRelationDisplayText(candidate);\n            if (candidateText) {\n                return candidateText;\n            }\n        }\n\n        for (const candidate of Object.values(objectValue)) {\n            const candidateText = getRelationDisplayText(candidate);\n            if (candidateText) {\n                return candidateText;\n            }\n        }\n\n        try {\n            return JSON.stringify(objectValue);\n        } catch {\n            return \"\";\n        }\n    }\n\n    return String(value);\n};\n\nexport const getRelatedRecordDisplayText = (record: Record<string, unknown> | null | undefined, userKeyField?: string): string => {\n    if (!record) {\n        return \"\";\n    }\n\n    const rawDisplayValue = userKeyField ? record[userKeyField] : undefined;\n\n    return getRelationDisplayText(\n        rawDisplayValue ?? record.displayName ?? record.name ?? record.id\n    );\n};\n"]}

package/dist/helpers/relationDisplay.ts

@@ -0,0 +1,101 @@
+/**
+ * Normalizes relation display values into safe text for UI rendering.
+ *
+ * Relation labels in Solid can come from a configured `userKeyField`, but in
+ * some edge cases that field may contain locale maps or other JSON-shaped
+ * values instead of plain text. These helpers prevent raw objects from being
+ * passed into React by:
+ * - returning scalar values as strings
+ * - collapsing arrays into comma-separated text
+ * - preferring common label-like object keys such as `label` or `displayName`
+ * - falling back through nested object values and finally `JSON.stringify`
+ *
+ * `getRelatedRecordDisplayText` applies that normalization to a related record
+ * and falls back from the configured user-key field to `displayName`, `name`,
+ * and `id` when needed.
+ *
+ * For arbitrary JSON:
+ * - arrays are normalized item-by-item and joined with `, `
+ * - objects return the first readable nested text that can be derived
+ * - if no readable nested text is found, the object is stringified as JSON
+ *
+ * Examples:
+ * - `getRelationDisplayText("Acme")` -> `"Acme"`
+ * - `getRelationDisplayText({ en_US: "Acme", fr_FR: "Acme FR" })` -> `"Acme"`
+ * - `getRelationDisplayText({ label: "Acme", value: 12 })` -> `"Acme"`
+ * - `getRelationDisplayText(["A", { en_US: "B" }])` -> `"A, B"`
+ * - `getRelationDisplayText({ firstName: "Harish", lastName: "Patel" })` -> `"Harish"`
+ * - `getRelationDisplayText({ foo: {}, bar: [] })` -> `"{}"`
+ *   This reaches the final `JSON.stringify` fallback because no readable
+ *   scalar text can be derived from the nested values.
+ * - `getRelatedRecordDisplayText({ code: { en_US: "A-100" }, id: 7 }, "code")` -> `"A-100"`
+ * - `getRelatedRecordDisplayText({ id: 7 }, "missingField")` -> `"7"`
+ */
+const RELATION_DISPLAY_CANDIDATE_KEYS = [
+    "label",
+    "displayName",
+    "name",
+    "title",
+    "value",
+    "text",
+];
+
+export const getRelationDisplayText = (value: unknown): string => {
+    if (value === null || value === undefined) {
+        return "";
+    }
+
+    if (typeof value === "string") {
+        return value;
+    }
+
+    if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") {
+        return String(value);
+    }
+
+    if (Array.isArray(value)) {
+        return value
+            .map((item) => getRelationDisplayText(item))
+            .filter(Boolean)
+            .join(", ");
+    }
+
+    if (typeof value === "object") {
+        const objectValue = value as Record<string, unknown>;
+
+        for (const key of RELATION_DISPLAY_CANDIDATE_KEYS) {
+            const candidate = objectValue[key];
+            const candidateText = getRelationDisplayText(candidate);
+            if (candidateText) {
+                return candidateText;
+            }
+        }
+
+        for (const candidate of Object.values(objectValue)) {
+            const candidateText = getRelationDisplayText(candidate);
+            if (candidateText) {
+                return candidateText;
+            }
+        }
+
+        try {
+            return JSON.stringify(objectValue);
+        } catch {
+            return "";
+        }
+    }
+
+    return String(value);
+};
+
+export const getRelatedRecordDisplayText = (record: Record<string, unknown> | null | undefined, userKeyField?: string): string => {
+    if (!record) {
+        return "";
+    }
+
+    const rawDisplayValue = userKeyField ? record[userKeyField] : undefined;
+
+    return getRelationDisplayText(
+        rawDisplayValue ?? record.displayName ?? record.name ?? record.id
+    );
+};

package/dist/helpers/settingsPayload.d.ts

@@ -13,6 +13,7 @@ export type AdminSettingDefinition = {
     encrypted?: boolean;
     label?: string;
     description?: string;
+    helpText?: string;
     placeholder?: string;
     group?: string;
     sortOrder?: number;