@solidxai/core-ui 0.1.8-beta.9 → 0.1.9-alpha.0

package/dist/redux/store/solidEntityApiPool.js

@@ -0,0 +1,123 @@
+export var SOLID_ENTITY_API_POOL_LIMIT = 64;
+var activeStore = null;
+var clock = 0;
+var pool = new Map();
+function nextTimestamp() {
+    clock += 1;
+    return clock;
+}
+function log(message, data) {
+    // Centralized logs make pool behavior easy to trace in consuming apps.
+    console.info("[SolidEntityApiPool] ".concat(message), data !== null && data !== void 0 ? data : {});
+}
+function warn(message, data) {
+    console.warn("[SolidEntityApiPool] ".concat(message), data !== null && data !== void 0 ? data : {});
+}
+function getLiveSnapshot() {
+    return Array.from(pool.values()).map(function (entry) { return ({
+        entityName: entry.entityName,
+        reducerPath: entry.api.reducerPath,
+        registeredAt: entry.registeredAt,
+        lastAccessedAt: entry.lastAccessedAt,
+        active: Boolean(activeStore === null || activeStore === void 0 ? void 0 : activeStore.middlewareManager.has(entry.api.reducerPath)),
+    }); });
+}
+function getActiveEntries() {
+    return Array.from(pool.values()).filter(function (entry) { return activeStore === null || activeStore === void 0 ? void 0 : activeStore.middlewareManager.has(entry.api.reducerPath); });
+}
+function hasActiveUsage(entry) {
+    var _a, _b, _c, _d;
+    if (!activeStore)
+        return false;
+    var state = (_a = activeStore.getState()) === null || _a === void 0 ? void 0 : _a[entry.api.reducerPath];
+    if (!state)
+        return false;
+    var hasSubscriptions = Object.values((_b = state.subscriptions) !== null && _b !== void 0 ? _b : {}).some(function (subscription) {
+        return subscription && Object.keys(subscription).length > 0;
+    });
+    var hasPendingQueries = Object.values((_c = state.queries) !== null && _c !== void 0 ? _c : {}).some(function (query) { return (query === null || query === void 0 ? void 0 : query.status) === "pending"; });
+    var hasPendingMutations = Object.values((_d = state.mutations) !== null && _d !== void 0 ? _d : {}).some(function (mutation) { return (mutation === null || mutation === void 0 ? void 0 : mutation.status) === "pending"; });
+    return hasSubscriptions || hasPendingQueries || hasPendingMutations;
+}
+function findEvictionCandidate() {
+    var _a;
+    return (_a = getActiveEntries()
+        .filter(function (entry) { return !hasActiveUsage(entry); })
+        .sort(function (left, right) { return left.lastAccessedAt - right.lastAccessedAt; })[0]) !== null && _a !== void 0 ? _a : null;
+}
+function evictIfNeeded(nextEntityName) {
+    var _a;
+    if (!activeStore)
+        return;
+    var activeEntries = getActiveEntries();
+    if (activeEntries.length < SOLID_ENTITY_API_POOL_LIMIT)
+        return;
+    warn("Pool is full; attempting LRU eviction.", {
+        limit: SOLID_ENTITY_API_POOL_LIMIT,
+        requestedEntityName: nextEntityName,
+        activeCount: activeEntries.length,
+    });
+    var candidate = findEvictionCandidate();
+    if (!candidate) {
+        warn("Pool is full but all entries look active; allowing temporary overflow.", {
+            limit: SOLID_ENTITY_API_POOL_LIMIT,
+            requestedEntityName: nextEntityName,
+            activeCount: activeEntries.length,
+        });
+        return;
+    }
+    var resetApiState = (_a = candidate.api.util) === null || _a === void 0 ? void 0 : _a.resetApiState;
+    if (resetApiState) {
+        activeStore.dispatch(resetApiState());
+    }
+    activeStore.middlewareManager.remove(candidate.api.reducerPath);
+    activeStore.reducerManager.remove(candidate.api.reducerPath);
+    activeStore.replaceReducer(activeStore.reducerManager.reduce);
+    log("Evicted entity API from pool.", {
+        entityName: candidate.entityName,
+        reducerPath: candidate.api.reducerPath,
+        requestedEntityName: nextEntityName,
+    });
+}
+export function setSolidEntityApiStore(store) {
+    activeStore = store;
+}
+export function ensureSolidEntityApiRegistered(entityName, api) {
+    var timestamp = nextTimestamp();
+    var existingEntry = pool.get(entityName);
+    if (existingEntry) {
+        existingEntry.lastAccessedAt = timestamp;
+    }
+    else {
+        pool.set(entityName, {
+            entityName: entityName,
+            api: api,
+            registeredAt: timestamp,
+            lastAccessedAt: timestamp,
+        });
+        log("Created entity API cache entry.", {
+            entityName: entityName,
+            reducerPath: api.reducerPath,
+        });
+    }
+    if (!activeStore || activeStore.middlewareManager.has(api.reducerPath))
+        return;
+    evictIfNeeded(entityName);
+    activeStore.reducerManager.add(api.reducerPath, api.reducer);
+    activeStore.middlewareManager.add(api.reducerPath, api.middleware);
+    log("Dynamically registered entity API reducer and middleware.", {
+        entityName: entityName,
+        reducerPath: api.reducerPath,
+        activeCount: getActiveEntries().length,
+        limit: SOLID_ENTITY_API_POOL_LIMIT,
+    });
+}
+export function getSolidEntityApiPoolSnapshot() {
+    return getLiveSnapshot();
+}
+export function resetSolidEntityApiPoolForTests() {
+    activeStore = null;
+    clock = 0;
+    pool.clear();
+}
+//# sourceMappingURL=solidEntityApiPool.js.map

package/dist/redux/store/solidEntityApiPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solidEntityApiPool.js","sourceRoot":"","sources":["../../../src/redux/store/solidEntityApiPool.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyAction, Dispatch, Middleware, Reducer } from \"@reduxjs/toolkit\";\nimport type { DynamicEntityApiMiddlewareManager } from \"./dynamicEntityApiMiddleware\";\nimport type { DynamicReducerManager } from \"./dynamicReducerManager\";\n\nexport const SOLID_ENTITY_API_POOL_LIMIT = 64;\n\ntype SolidEntityApi = {\n  reducerPath: string;\n  reducer: Reducer;\n  middleware: Middleware;\n  util?: {\n    resetApiState?: () => AnyAction;\n  };\n};\n\ntype SolidEntityApiPoolEntry = {\n  entityName: string;\n  api: SolidEntityApi;\n  registeredAt: number;\n  lastAccessedAt: number;\n};\n\ntype SolidEntityApiStore = {\n  dispatch: Dispatch;\n  getState: () => any;\n  replaceReducer: (nextReducer: Reducer) => void;\n  reducerManager: DynamicReducerManager;\n  middlewareManager: DynamicEntityApiMiddlewareManager;\n};\n\nlet activeStore: SolidEntityApiStore | null = null;\nlet clock = 0;\nconst pool = new Map<string, SolidEntityApiPoolEntry>();\n\nfunction nextTimestamp() {\n  clock += 1;\n  return clock;\n}\n\nfunction log(message: string, data?: Record<string, unknown>) {\n  // Centralized logs make pool behavior easy to trace in consuming apps.\n  console.info(`[SolidEntityApiPool] ${message}`, data ?? {});\n}\n\nfunction warn(message: string, data?: Record<string, unknown>) {\n  console.warn(`[SolidEntityApiPool] ${message}`, data ?? {});\n}\n\nfunction getLiveSnapshot() {\n  return Array.from(pool.values()).map((entry) => ({\n    entityName: entry.entityName,\n    reducerPath: entry.api.reducerPath,\n    registeredAt: entry.registeredAt,\n    lastAccessedAt: entry.lastAccessedAt,\n    active: Boolean(activeStore?.middlewareManager.has(entry.api.reducerPath)),\n  }));\n}\n\nfunction getActiveEntries() {\n  return Array.from(pool.values()).filter((entry) => activeStore?.middlewareManager.has(entry.api.reducerPath));\n}\n\nfunction hasActiveUsage(entry: SolidEntityApiPoolEntry) {\n  if (!activeStore) return false;\n\n  const state = activeStore.getState()?.[entry.api.reducerPath];\n  if (!state) return false;\n\n  const hasSubscriptions = Object.values(state.subscriptions ?? {}).some((subscription: any) => {\n    return subscription && Object.keys(subscription).length > 0;\n  });\n  const hasPendingQueries = Object.values(state.queries ?? {}).some((query: any) => query?.status === \"pending\");\n  const hasPendingMutations = Object.values(state.mutations ?? {}).some((mutation: any) => mutation?.status === \"pending\");\n\n  return hasSubscriptions || hasPendingQueries || hasPendingMutations;\n}\n\nfunction findEvictionCandidate() {\n  return getActiveEntries()\n    .filter((entry) => !hasActiveUsage(entry))\n    .sort((left, right) => left.lastAccessedAt - right.lastAccessedAt)[0] ?? null;\n}\n\nfunction evictIfNeeded(nextEntityName: string) {\n  if (!activeStore) return;\n\n  const activeEntries = getActiveEntries();\n  if (activeEntries.length < SOLID_ENTITY_API_POOL_LIMIT) return;\n\n  warn(\"Pool is full; attempting LRU eviction.\", {\n    limit: SOLID_ENTITY_API_POOL_LIMIT,\n    requestedEntityName: nextEntityName,\n    activeCount: activeEntries.length,\n  });\n\n  const candidate = findEvictionCandidate();\n  if (!candidate) {\n    warn(\"Pool is full but all entries look active; allowing temporary overflow.\", {\n      limit: SOLID_ENTITY_API_POOL_LIMIT,\n      requestedEntityName: nextEntityName,\n      activeCount: activeEntries.length,\n    });\n    return;\n  }\n\n  const resetApiState = candidate.api.util?.resetApiState;\n  if (resetApiState) {\n    activeStore.dispatch(resetApiState());\n  }\n  activeStore.middlewareManager.remove(candidate.api.reducerPath);\n  activeStore.reducerManager.remove(candidate.api.reducerPath);\n  activeStore.replaceReducer(activeStore.reducerManager.reduce);\n\n  log(\"Evicted entity API from pool.\", {\n    entityName: candidate.entityName,\n    reducerPath: candidate.api.reducerPath,\n    requestedEntityName: nextEntityName,\n  });\n}\n\nexport function setSolidEntityApiStore(store: SolidEntityApiStore) {\n  activeStore = store;\n}\n\nexport function ensureSolidEntityApiRegistered(entityName: string, api: SolidEntityApi) {\n  const timestamp = nextTimestamp();\n  const existingEntry = pool.get(entityName);\n\n  if (existingEntry) {\n    existingEntry.lastAccessedAt = timestamp;\n  } else {\n    pool.set(entityName, {\n      entityName,\n      api,\n      registeredAt: timestamp,\n      lastAccessedAt: timestamp,\n    });\n    log(\"Created entity API cache entry.\", {\n      entityName,\n      reducerPath: api.reducerPath,\n    });\n  }\n\n  if (!activeStore || activeStore.middlewareManager.has(api.reducerPath)) return;\n\n  evictIfNeeded(entityName);\n\n  activeStore.reducerManager.add(api.reducerPath, api.reducer);\n  activeStore.middlewareManager.add(api.reducerPath, api.middleware);\n\n  log(\"Dynamically registered entity API reducer and middleware.\", {\n    entityName,\n    reducerPath: api.reducerPath,\n    activeCount: getActiveEntries().length,\n    limit: SOLID_ENTITY_API_POOL_LIMIT,\n  });\n}\n\nexport function getSolidEntityApiPoolSnapshot() {\n  return getLiveSnapshot();\n}\n\nexport function resetSolidEntityApiPoolForTests() {\n  activeStore = null;\n  clock = 0;\n  pool.clear();\n}\n"]}

package/dist/redux/store/solidEntityApiPool.ts

@@ -0,0 +1,167 @@
+import type { AnyAction, Dispatch, Middleware, Reducer } from "@reduxjs/toolkit";
+import type { DynamicEntityApiMiddlewareManager } from "./dynamicEntityApiMiddleware";
+import type { DynamicReducerManager } from "./dynamicReducerManager";
+
+export const SOLID_ENTITY_API_POOL_LIMIT = 64;
+
+type SolidEntityApi = {
+  reducerPath: string;
+  reducer: Reducer;
+  middleware: Middleware;
+  util?: {
+    resetApiState?: () => AnyAction;
+  };
+};
+
+type SolidEntityApiPoolEntry = {
+  entityName: string;
+  api: SolidEntityApi;
+  registeredAt: number;
+  lastAccessedAt: number;
+};
+
+type SolidEntityApiStore = {
+  dispatch: Dispatch;
+  getState: () => any;
+  replaceReducer: (nextReducer: Reducer) => void;
+  reducerManager: DynamicReducerManager;
+  middlewareManager: DynamicEntityApiMiddlewareManager;
+};
+
+let activeStore: SolidEntityApiStore | null = null;
+let clock = 0;
+const pool = new Map<string, SolidEntityApiPoolEntry>();
+
+function nextTimestamp() {
+  clock += 1;
+  return clock;
+}
+
+function log(message: string, data?: Record<string, unknown>) {
+  // Centralized logs make pool behavior easy to trace in consuming apps.
+  console.info(`[SolidEntityApiPool] ${message}`, data ?? {});
+}
+
+function warn(message: string, data?: Record<string, unknown>) {
+  console.warn(`[SolidEntityApiPool] ${message}`, data ?? {});
+}
+
+function getLiveSnapshot() {
+  return Array.from(pool.values()).map((entry) => ({
+    entityName: entry.entityName,
+    reducerPath: entry.api.reducerPath,
+    registeredAt: entry.registeredAt,
+    lastAccessedAt: entry.lastAccessedAt,
+    active: Boolean(activeStore?.middlewareManager.has(entry.api.reducerPath)),
+  }));
+}
+
+function getActiveEntries() {
+  return Array.from(pool.values()).filter((entry) => activeStore?.middlewareManager.has(entry.api.reducerPath));
+}
+
+function hasActiveUsage(entry: SolidEntityApiPoolEntry) {
+  if (!activeStore) return false;
+
+  const state = activeStore.getState()?.[entry.api.reducerPath];
+  if (!state) return false;
+
+  const hasSubscriptions = Object.values(state.subscriptions ?? {}).some((subscription: any) => {
+    return subscription && Object.keys(subscription).length > 0;
+  });
+  const hasPendingQueries = Object.values(state.queries ?? {}).some((query: any) => query?.status === "pending");
+  const hasPendingMutations = Object.values(state.mutations ?? {}).some((mutation: any) => mutation?.status === "pending");
+
+  return hasSubscriptions || hasPendingQueries || hasPendingMutations;
+}
+
+function findEvictionCandidate() {
+  return getActiveEntries()
+    .filter((entry) => !hasActiveUsage(entry))
+    .sort((left, right) => left.lastAccessedAt - right.lastAccessedAt)[0] ?? null;
+}
+
+function evictIfNeeded(nextEntityName: string) {
+  if (!activeStore) return;
+
+  const activeEntries = getActiveEntries();
+  if (activeEntries.length < SOLID_ENTITY_API_POOL_LIMIT) return;
+
+  warn("Pool is full; attempting LRU eviction.", {
+    limit: SOLID_ENTITY_API_POOL_LIMIT,
+    requestedEntityName: nextEntityName,
+    activeCount: activeEntries.length,
+  });
+
+  const candidate = findEvictionCandidate();
+  if (!candidate) {
+    warn("Pool is full but all entries look active; allowing temporary overflow.", {
+      limit: SOLID_ENTITY_API_POOL_LIMIT,
+      requestedEntityName: nextEntityName,
+      activeCount: activeEntries.length,
+    });
+    return;
+  }
+
+  const resetApiState = candidate.api.util?.resetApiState;
+  if (resetApiState) {
+    activeStore.dispatch(resetApiState());
+  }
+  activeStore.middlewareManager.remove(candidate.api.reducerPath);
+  activeStore.reducerManager.remove(candidate.api.reducerPath);
+  activeStore.replaceReducer(activeStore.reducerManager.reduce);
+
+  log("Evicted entity API from pool.", {
+    entityName: candidate.entityName,
+    reducerPath: candidate.api.reducerPath,
+    requestedEntityName: nextEntityName,
+  });
+}
+
+export function setSolidEntityApiStore(store: SolidEntityApiStore) {
+  activeStore = store;
+}
+
+export function ensureSolidEntityApiRegistered(entityName: string, api: SolidEntityApi) {
+  const timestamp = nextTimestamp();
+  const existingEntry = pool.get(entityName);
+
+  if (existingEntry) {
+    existingEntry.lastAccessedAt = timestamp;
+  } else {
+    pool.set(entityName, {
+      entityName,
+      api,
+      registeredAt: timestamp,
+      lastAccessedAt: timestamp,
+    });
+    log("Created entity API cache entry.", {
+      entityName,
+      reducerPath: api.reducerPath,
+    });
+  }
+
+  if (!activeStore || activeStore.middlewareManager.has(api.reducerPath)) return;
+
+  evictIfNeeded(entityName);
+
+  activeStore.reducerManager.add(api.reducerPath, api.reducer);
+  activeStore.middlewareManager.add(api.reducerPath, api.middleware);
+
+  log("Dynamically registered entity API reducer and middleware.", {
+    entityName,
+    reducerPath: api.reducerPath,
+    activeCount: getActiveEntries().length,
+    limit: SOLID_ENTITY_API_POOL_LIMIT,
+  });
+}
+
+export function getSolidEntityApiPoolSnapshot() {
+  return getLiveSnapshot();
+}
+
+export function resetSolidEntityApiPoolForTests() {
+  activeStore = null;
+  clock = 0;
+  pool.clear();
+}

package/dist/resources/globals.css

@@ -211,6 +211,15 @@ a {
   border-left: 1px solid rgba(15, 23, 42, 0.1);
 }
 
+.react-datepicker-popper {
+  z-index: 10000 !important;
+}
+
+#solid-datepicker-portal .react-datepicker-popper,
+.react-datepicker__portal {
+  z-index: 10000;
+}
+
 /* Avatar */
 .avatar {
   display: inline-block;
@@ -2744,6 +2753,10 @@ li.header-li-px {
   height: auto;
 }
 
+.solid-custom-filter-wrapper {
+  z-index: 85;
+}
+
 .custom-filter-button {
   border-right: 0;
   border-top: 0;
@@ -2888,6 +2901,7 @@ li.header-li-px {
 .solid-chip-manager-panel {
   top: calc(100% + 6px);
   left: 0;
+  z-index: 90 !important;
   width: min(360px, 100%);
   background: var(--card);
   border: 1px solid color-mix(in srgb, var(--border) 86%, transparent);
@@ -3871,6 +3885,8 @@ li.header-li-px {
 
 .solid-search-overlay-pannel {
   top: calc(100% + 4px) !important;
+  /* Keep above datatable sticky headers/columns and other elevated surfaces. */
+  z-index: 1004 !important;
   background: var(--card);
   border: 1px solid color-mix(in srgb, var(--border) 86%, transparent) !important;
   border-radius: 10px;
@@ -5103,11 +5119,14 @@ flex-shrink: 0; */
 .solid-kanban-board-wrapper {
   display: flex;
   flex-direction: column;
-  overflow: auto;
+  overflow-x: auto;
+  overflow-y: auto;
   height: calc(100vh - 120px) !important;
   min-height: 0;
   min-width: 0;
   flex: 1 1 auto;
+  -webkit-overflow-scrolling: touch;
+  width: calc(100vw - 300px);
 }
 
 .solid-kanban-board-scroll-context {
@@ -5115,6 +5134,7 @@ flex-shrink: 0; */
   overflow: visible;
   flex: 0 0 auto;
   width: max-content;
+  max-width: none;
   min-width: 100%;
   min-height: 100%;
   height: auto;
@@ -5655,15 +5675,15 @@ html.dark .solid-media-card-widget__kind,
 
 .solid-empty-listview-actions .solid-empty-listview-create-action .p-button,
 .solid-empty-listview-actions .solid-empty-listview-create-action .solid-btn {
-  background: var(--foreground);
-  border-color: var(--foreground);
-  color: var(--background);
+  background: var(--primary);
+  border-color: var(--primary);
+  color: var(--primary-foreground);
 }
 
 .solid-empty-listview-actions .solid-empty-listview-create-action .p-button:hover,
 .solid-empty-listview-actions .solid-empty-listview-create-action .solid-btn:hover {
-  background: color-mix(in srgb, var(--foreground) 90%, transparent);
-  border-color: color-mix(in srgb, var(--foreground) 90%, transparent);
+  background: color-mix(in srgb, var(--primary) 90%, black);
+  border-color: color-mix(in srgb, var(--primary) 90%, black);
 }
 
 .solid-empty-listview-import-button.p-button,