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

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;

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

@@ -1 +1 @@
-{"version":3,"file":"settingsPayload.d.ts","sourceRoot":"","sources":["../../src/helpers/settingsPayload.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,UAAU,GACV,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,uBAAuB,GACvB,uBAAuB,GACvB,eAAe,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,sBAAsB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvD,CAAC;AA0BF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,sBAAsB,EAAE,CAY1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAkBhE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,OAKjD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,UASlD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,UAGhF"}
+{"version":3,"file":"settingsPayload.d.ts","sourceRoot":"","sources":["../../src/helpers/settingsPayload.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,UAAU,GACV,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,GACV,aAAa,GACb,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,uBAAuB,GACvB,uBAAuB,GACvB,eAAe,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,sBAAsB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvD,CAAC;AA0BF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,sBAAsB,EAAE,CAY1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAkBhE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,OAKjD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,UASlD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,UAGhF"}

package/dist/helpers/settingsPayload.js.map

@@ -1 +1 @@
-{"version":3,"file":"settingsPayload.js","sourceRoot":"","sources":["../../src/helpers/settingsPayload.ts"],"names":[],"mappings":"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","sourcesContent":["export type SettingsOptionValue = string | number | boolean;\n\nexport type SettingsControlType =\n  | \"shortText\"\n  | \"longText\"\n  | \"numeric\"\n  | \"boolean\"\n  | \"date\"\n  | \"datetime\"\n  | \"mediaSingle\"\n  | \"selectionStatic\"\n  | \"custom\";\n\nexport type SettingsLevel =\n  | \"system-env\"\n  | \"system-admin-readonly\"\n  | \"system-admin-editable\"\n  | \"internal-user\";\n\nexport type SettingsOption = {\n  label: string;\n  value: SettingsOptionValue;\n};\n\nexport type AdminSettingDefinition = {\n  moduleName: string;\n  key: string;\n  value: any;\n  level: SettingsLevel;\n  encrypted?: boolean;\n  label?: string;\n  description?: string;\n  placeholder?: string;\n  group?: string;\n  sortOrder?: number;\n  controlType?: SettingsControlType;\n  settingsWidget?: string;\n  options?: SettingsOption[];\n  editable?: boolean;\n};\n\nexport type AdminSettingsResponse = {\n  data?: AdminSettingDefinition[] | Record<string, any>;\n};\n\nfunction unwrapSettingsContainer(payload: any): any {\n  if (!payload || typeof payload !== \"object\") {\n    return payload;\n  }\n\n  if (Array.isArray(payload)) {\n    return payload;\n  }\n\n  if (Array.isArray(payload?.data)) {\n    return payload.data;\n  }\n\n  if (\n    payload?.data &&\n    typeof payload.data === \"object\" &&\n    (Array.isArray(payload.data.data) || (payload.data.data && typeof payload.data.data === \"object\"))\n  ) {\n    return unwrapSettingsContainer(payload.data);\n  }\n\n  return payload;\n}\n\nexport function extractSettingsList(payload: any): AdminSettingDefinition[] {\n  const normalizedPayload = unwrapSettingsContainer(payload);\n\n  if (Array.isArray(normalizedPayload?.data)) {\n    return normalizedPayload.data;\n  }\n\n  if (Array.isArray(normalizedPayload)) {\n    return normalizedPayload;\n  }\n\n  return [];\n}\n\nexport function getSettingsMap(payload: any): Record<string, any> {\n  const normalizedPayload = unwrapSettingsContainer(payload);\n\n  if (\n    normalizedPayload?.data &&\n    !Array.isArray(normalizedPayload.data) &&\n    typeof normalizedPayload.data === \"object\" &&\n    !Array.isArray(normalizedPayload.data?.data)\n  ) {\n    return normalizedPayload.data;\n  }\n\n  const list = extractSettingsList(normalizedPayload);\n  if (!list.length) {\n    return {};\n  }\n\n  return Object.fromEntries(list.map((setting) => [setting.key, setting.value]));\n}\n\nexport function toLegacySettingsShape(payload: any) {\n  return {\n    ...payload,\n    data: getSettingsMap(payload),\n  };\n}\n\nexport function humanizeSettingToken(value?: string) {\n  if (!value) return \"\";\n\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .replace(/[-_]+/g, \" \")\n    .replace(/\\s+/g, \" \")\n    .trim()\n    .replace(/\\b\\w/g, (match) => match.toUpperCase());\n}\n\nexport function getSettingOptionLabel(setting: AdminSettingDefinition, value: any) {\n  const option = setting.options?.find((item) => item.value === value);\n  return option?.label ?? String(value ?? \"\");\n}\n"]}
+{"version":3,"file":"settingsPayload.js","sourceRoot":"","sources":["../../src/helpers/settingsPayload.ts"],"names":[],"mappings":"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","sourcesContent":["export type SettingsOptionValue = string | number | boolean;\n\nexport type SettingsControlType =\n  | \"shortText\"\n  | \"longText\"\n  | \"numeric\"\n  | \"boolean\"\n  | \"date\"\n  | \"datetime\"\n  | \"mediaSingle\"\n  | \"selectionStatic\"\n  | \"custom\";\n\nexport type SettingsLevel =\n  | \"system-env\"\n  | \"system-admin-readonly\"\n  | \"system-admin-editable\"\n  | \"internal-user\";\n\nexport type SettingsOption = {\n  label: string;\n  value: SettingsOptionValue;\n};\n\nexport type AdminSettingDefinition = {\n  moduleName: string;\n  key: string;\n  value: any;\n  level: SettingsLevel;\n  encrypted?: boolean;\n  label?: string;\n  description?: string;\n  helpText?: string;\n  placeholder?: string;\n  group?: string;\n  sortOrder?: number;\n  controlType?: SettingsControlType;\n  settingsWidget?: string;\n  options?: SettingsOption[];\n  editable?: boolean;\n};\n\nexport type AdminSettingsResponse = {\n  data?: AdminSettingDefinition[] | Record<string, any>;\n};\n\nfunction unwrapSettingsContainer(payload: any): any {\n  if (!payload || typeof payload !== \"object\") {\n    return payload;\n  }\n\n  if (Array.isArray(payload)) {\n    return payload;\n  }\n\n  if (Array.isArray(payload?.data)) {\n    return payload.data;\n  }\n\n  if (\n    payload?.data &&\n    typeof payload.data === \"object\" &&\n    (Array.isArray(payload.data.data) || (payload.data.data && typeof payload.data.data === \"object\"))\n  ) {\n    return unwrapSettingsContainer(payload.data);\n  }\n\n  return payload;\n}\n\nexport function extractSettingsList(payload: any): AdminSettingDefinition[] {\n  const normalizedPayload = unwrapSettingsContainer(payload);\n\n  if (Array.isArray(normalizedPayload?.data)) {\n    return normalizedPayload.data;\n  }\n\n  if (Array.isArray(normalizedPayload)) {\n    return normalizedPayload;\n  }\n\n  return [];\n}\n\nexport function getSettingsMap(payload: any): Record<string, any> {\n  const normalizedPayload = unwrapSettingsContainer(payload);\n\n  if (\n    normalizedPayload?.data &&\n    !Array.isArray(normalizedPayload.data) &&\n    typeof normalizedPayload.data === \"object\" &&\n    !Array.isArray(normalizedPayload.data?.data)\n  ) {\n    return normalizedPayload.data;\n  }\n\n  const list = extractSettingsList(normalizedPayload);\n  if (!list.length) {\n    return {};\n  }\n\n  return Object.fromEntries(list.map((setting) => [setting.key, setting.value]));\n}\n\nexport function toLegacySettingsShape(payload: any) {\n  return {\n    ...payload,\n    data: getSettingsMap(payload),\n  };\n}\n\nexport function humanizeSettingToken(value?: string) {\n  if (!value) return \"\";\n\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .replace(/[-_]+/g, \" \")\n    .replace(/\\s+/g, \" \")\n    .trim()\n    .replace(/\\b\\w/g, (match) => match.toUpperCase());\n}\n\nexport function getSettingOptionLabel(setting: AdminSettingDefinition, value: any) {\n  const option = setting.options?.find((item) => item.value === value);\n  return option?.label ?? String(value ?? \"\");\n}\n"]}

package/dist/helpers/settingsPayload.ts

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

package/dist/helpers/solidIcons.d.ts

@@ -2,4 +2,6 @@ export declare const solidIcons: {
     category: string;
     icons: string[];
 }[];
+export declare const solidMaterialIconNames: Set<string>;
+export declare function hasSolidMaterialIconName(value?: string | null): boolean;
 //# sourceMappingURL=solidIcons.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"solidIcons.d.ts","sourceRoot":"","sources":["../../src/helpers/solidIcons.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;GAsyDtB,CAAA"}
+{"version":3,"file":"solidIcons.d.ts","sourceRoot":"","sources":["../../src/helpers/solidIcons.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;GAsyDtB,CAAA;AAED,eAAO,MAAM,sBAAsB,aAElC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGvE"}

package/dist/helpers/solidIcons.js

@@ -1828,4 +1828,12 @@ export var solidIcons = [
         ]
     }
 ];
+export var solidMaterialIconNames = new Set(solidIcons.flatMap(function (_a) {
+    var icons = _a.icons;
+    return icons;
+}));
+export function hasSolidMaterialIconName(value) {
+    var normalizedValue = typeof value === "string" ? value.trim() : "";
+    return normalizedValue.length > 0 && solidMaterialIconNames.has(normalizedValue);
+}
 //# sourceMappingURL=solidIcons.js.map