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

package/dist/helpers/backendHealthMonitor.ts

@@ -0,0 +1,177 @@
+import { env } from "../adapters/env";
+import { pingBackendAvailability } from "./waitForBackendAvailability";
+
+export type BackendHealthStatus = "online" | "checking" | "offline";
+
+export type BackendHealthState = {
+  status: BackendHealthStatus;
+  firstFailureAt: number | null;
+  lastFailureAt: number | null;
+  unavailableToastDelayMs: number;
+  retryDelayMs: number;
+  message: string;
+  statusCode?: number | string;
+  error?: unknown;
+};
+
+type BackendHealthListener = (state: BackendHealthState) => void;
+
+type BackendHealthConfig = {
+  unavailableToastDelayMs?: number;
+  retryDelayMs?: number;
+};
+
+const DEFAULT_UNAVAILABLE_TOAST_DELAY_MS = 60_000;
+const DEFAULT_RETRY_DELAY_MS = 1_500;
+
+function parsePositiveInteger(value: string, fallback: number) {
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+
+class BackendHealthMonitor {
+  private listeners = new Set<BackendHealthListener>();
+  private pollingPromise: Promise<void> | null = null;
+  private offlineTimer: number | null = null;
+  private config: Required<BackendHealthConfig> = {
+    unavailableToastDelayMs: parsePositiveInteger(
+      env("BACKEND_UNAVAILABLE_TOAST_DELAY_MS", `${DEFAULT_UNAVAILABLE_TOAST_DELAY_MS}`),
+      DEFAULT_UNAVAILABLE_TOAST_DELAY_MS,
+    ),
+    retryDelayMs: parsePositiveInteger(
+      env("BACKEND_RETRY_DELAY_MS", `${DEFAULT_RETRY_DELAY_MS}`),
+      DEFAULT_RETRY_DELAY_MS,
+    ),
+  };
+
+  private state: BackendHealthState = {
+    status: "online",
+    firstFailureAt: null,
+    lastFailureAt: null,
+    unavailableToastDelayMs: this.config.unavailableToastDelayMs,
+    retryDelayMs: this.config.retryDelayMs,
+    message: "",
+  };
+
+  subscribe(listener: BackendHealthListener) {
+    this.listeners.add(listener);
+    listener(this.state);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+
+  getState() {
+    return this.state;
+  }
+
+  configure(nextConfig: BackendHealthConfig = {}) {
+    this.config = {
+      unavailableToastDelayMs: nextConfig.unavailableToastDelayMs ?? this.config.unavailableToastDelayMs,
+      retryDelayMs: nextConfig.retryDelayMs ?? this.config.retryDelayMs,
+    };
+
+    this.state = {
+      ...this.state,
+      unavailableToastDelayMs: this.config.unavailableToastDelayMs,
+      retryDelayMs: this.config.retryDelayMs,
+    };
+    this.emit();
+  }
+
+  reportFailure(payload?: { status?: number | string; message?: string; error?: unknown }) {
+    const now = Date.now();
+
+    this.state = {
+      ...this.state,
+      status: this.state.status === "offline" ? "offline" : "checking",
+      firstFailureAt: this.state.firstFailureAt ?? now,
+      lastFailureAt: now,
+      unavailableToastDelayMs: this.config.unavailableToastDelayMs,
+      retryDelayMs: this.config.retryDelayMs,
+      message: payload?.message || "Unable to reach the server. Reconnecting...",
+      statusCode: payload?.status,
+      error: payload?.error,
+    };
+    this.emit();
+
+    this.scheduleOfflineTimer();
+    void this.ensurePolling();
+  }
+
+  reportSuccess() {
+    if (this.state.status === "online") {
+      return;
+    }
+
+    this.clearOfflineTimer();
+    this.state = {
+      ...this.state,
+      status: "online",
+      firstFailureAt: null,
+      lastFailureAt: null,
+      message: "",
+      statusCode: undefined,
+      error: undefined,
+    };
+    this.emit();
+  }
+
+  private emit() {
+    for (const listener of Array.from(this.listeners)) {
+      listener(this.state);
+    }
+  }
+
+  private scheduleOfflineTimer() {
+    if (this.offlineTimer != null) {
+      return;
+    }
+
+    this.offlineTimer = window.setTimeout(() => {
+      this.offlineTimer = null;
+      if (this.state.status !== "online" && this.state.firstFailureAt != null) {
+        this.state = {
+          ...this.state,
+          status: "offline",
+          message: this.state.message || "Server unavailable.",
+        };
+        this.emit();
+      }
+    }, this.config.unavailableToastDelayMs);
+  }
+
+  private clearOfflineTimer() {
+    if (this.offlineTimer != null) {
+      window.clearTimeout(this.offlineTimer);
+      this.offlineTimer = null;
+    }
+  }
+
+  private async ensurePolling() {
+    if (this.pollingPromise) {
+      return this.pollingPromise;
+    }
+
+    this.pollingPromise = (async () => {
+      while (this.state.status !== "online") {
+        const reachable = await pingBackendAvailability();
+        if (reachable) {
+          this.reportSuccess();
+          break;
+        }
+
+        await new Promise((resolve) => window.setTimeout(resolve, this.config.retryDelayMs));
+      }
+    })();
+
+    try {
+      await this.pollingPromise;
+    } finally {
+      this.pollingPromise = null;
+    }
+  }
+}
+
+export const backendHealthMonitor = new BackendHealthMonitor();
+

package/dist/helpers/helpers.d.ts

@@ -1,5 +1,6 @@
 export declare const calculateDaysOfStay: (checkInDate: Date, checkOutDate: Date) => number;
 export declare const addCommasToAmount: (amount: string) => string;
+export declare const toTitleCase: (value: any) => string;
 export declare const getSingularAndPlural: (displayName: any) => {
     toKebabCase: any;
     toSnakeCase: any;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers/helpers.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,gBAAiB,IAAI,gBAAgB,IAAI,WAKxE,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,WAQ/C,CAAC;AAGF,eAAO,MAAM,oBAAoB,gBAAiB,GAAG;;;;;;;;CAmBpD,CAAC;AAYF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,UAQpD"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers/helpers.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,gBAAiB,IAAI,gBAAgB,IAAI,WAKxE,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,MAAM,WAQ/C,CAAC;AAEF,eAAO,MAAM,WAAW,UAAW,GAAG,WAQrC,CAAC;AAGF,eAAO,MAAM,oBAAoB,gBAAiB,GAAG;;;;;;;;CAmBpD,CAAC;AAYF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,GAAG,UAQpD"}

package/dist/helpers/helpers.js

@@ -13,6 +13,15 @@ export var addCommasToAmount = function (amount) {
     parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ",");
     return parts.join(".");
 };
+export var toTitleCase = function (value) {
+    var text = String(value !== null && value !== void 0 ? value : "").trim();
+    if (!text)
+        return "";
+    return text
+        .replace(/[-_]/g, " ")
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/\b\w/g, function (char) { return char.toUpperCase(); });
+};
 export var getSingularAndPlural = function (displayName) {
     // Convert display name to kebab-case (lowercase with hyphens)
     var toKebabCase = kebabCase(displayName);

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"}