@ramesesinc/platform-core 0.1.5 → 0.1.8

package/dist/components/table/ListHandler.ts

@@ -1,276 +0,0 @@
-/**
- * ListHandler - Functional style implementation for managing data fetching,
- * pagination, filtering, and sorting for DataList, DataTable, or any list-like components.
- */
-
-import { localAPI } from "@ramesesinc/lib/local-api";
-
-export interface ListHandlerConfig {
-  tenant: string;
-  module: string;
-  api: string;
-  params?: Record<string, any>;
-  cols: string[];
-  rowsPerPage?: number;
-  disableTotalCount?: boolean;
-  useCursorPagination?: boolean;
-}
-
-interface QueryParams {
-  cols: string[];
-  start: number;
-  limit: number;
-  sort?: {
-    column: string;
-    direction: "asc" | "desc";
-  };
-  search?: string;
-  skipCount?: boolean;
-  cursor?: string;
-  [key: string]: any;
-}
-
-interface DataResult {
-  data: any[];
-  total?: number;
-  page: number;
-  totalPages?: number;
-  hasMore?: boolean;
-  nextCursor?: string;
-}
-
-export type ListActionHandler = {
-  getData: () => any[];
-  load: () => Promise<void>;
-  reset: () => Promise<void>;
-  moveNextPage: () => Promise<void>;
-  movePrevPage: () => Promise<void>;
-  moveFirstPage: () => Promise<void>;
-  moveLastPage: () => Promise<void>;
-  moveToPage: (page: number) => Promise<void>;
-  setFilter: (filter: Record<string, any>) => Promise<void>;
-  resetFilter: () => Promise<void>;
-  doSearch: (text: string) => Promise<void>;
-  sortAsc: (column: string) => Promise<void>;
-  sortDesc: (column: string) => Promise<void>;
-  setRowsPerPage: (rows: number) => Promise<void>;
-  hasNextPage: () => boolean;
-  hasPrevPage: () => boolean;
-  getTotalPageCount: () => number;
-  getTotalRecordCount: () => number;
-  getCurrentPage: () => number;
-  getCurrentSortedColumn: () => string | null;
-  getCurrentSortDirection: () => "asc" | "desc" | null;
-  getRowsPerPage: () => number;
-  getSearchText: () => string;
-  getCustomFilter: () => Record<string, any>;
-};
-
-// FIX: removed the erroneous second parameter `ListHandlerConfig: any`
-export const ListHandler = (config: ListHandlerConfig): ListActionHandler => {
-  const api = config.api;
-  const cols = config.cols;
-
-  const { filter = {}, ...rest } = config.params ?? {};
-
-  const disableTotalCount = config.disableTotalCount || false;
-  const useCursorPagination = config.useCursorPagination || false;
-
-  let rowsPerPage = config.rowsPerPage || 20;
-  let currentPage = 1;
-  let customFilter: Record<string, any> = {};
-  let searchText = "";
-  let sortColumn: string | null = null;
-  let sortDirection: "asc" | "desc" | null = null;
-  let lastCursor: string | null = null;
-
-  let dataResult: any[] = [];
-  let totalRecordCount = 0;
-  let totalPageCount = 0;
-  let hasMorePages = false;
-
-  const getData = (): any[] => dataResult;
-
-  const load = async (): Promise<void> => {
-    const queryParams: QueryParams = {
-      cols,
-      start: (currentPage - 1) * rowsPerPage,
-      limit: rowsPerPage,
-      filter: {
-        ...filter,
-        ...customFilter,
-      },
-    };
-
-    if (useCursorPagination && lastCursor) {
-      queryParams.cursor = lastCursor;
-    }
-
-    if (disableTotalCount) {
-      queryParams.skipCount = true;
-    }
-
-    if (searchText) {
-      queryParams.search = searchText;
-    }
-
-    if (sortColumn && sortDirection) {
-      queryParams.sort = { column: sortColumn, direction: sortDirection };
-    }
-
-    try {
-      // console.log("datalist pass 1", { api, query: { ...queryParams, ...rest } });
-      const result = await localAPI.exec(`/services/exec/${config.tenant}/${config.module}/${api}`, { ...queryParams, ...rest });
-      // console.log("datalist pass 2", { result });
-      dataResult = result.data ?? result ?? [];
-
-      if (useCursorPagination) {
-        lastCursor = result.nextCursor ?? null;
-        hasMorePages = result.hasMore ?? false;
-      }
-
-      if (!disableTotalCount) {
-        totalRecordCount = result.total || 0;
-        totalPageCount = result.totalPages || Math.ceil(totalRecordCount / rowsPerPage);
-      } else {
-        hasMorePages = result.data && result.data.length === rowsPerPage;
-      }
-    } catch (error) {
-      console.error("Error loading data:", error);
-      dataResult = [];
-      totalRecordCount = 0;
-      totalPageCount = 0;
-      hasMorePages = false;
-      throw error;
-    }
-  };
-
-  const reset = async (): Promise<void> => {
-    currentPage = 1;
-    await load();
-  };
-
-  const moveNextPage = async (): Promise<void> => {
-    if (hasNextPage()) {
-      currentPage++;
-      await load();
-    }
-  };
-
-  const movePrevPage = async (): Promise<void> => {
-    if (hasPrevPage()) {
-      currentPage--;
-      await load();
-    }
-  };
-
-  const moveFirstPage = async (): Promise<void> => {
-    currentPage = 1;
-    await load();
-  };
-
-  const moveLastPage = async (): Promise<void> => {
-    if (disableTotalCount) {
-      console.warn("moveLastPage is not available when total count is disabled");
-      return;
-    }
-    if (totalPageCount > 0) {
-      currentPage = totalPageCount;
-      await load();
-    }
-  };
-
-  const moveToPage = async (page: number): Promise<void> => {
-    if (page >= 1 && page <= totalPageCount) {
-      currentPage = page;
-      await load();
-    } else {
-      console.warn(`Invalid page number: ${page}. Must be between 1 and ${totalPageCount}`);
-    }
-  };
-
-  const setFilter = async (filter: Record<string, any>): Promise<void> => {
-    customFilter = { ...filter };
-    currentPage = 1;
-    await load();
-  };
-
-  const resetFilter = async (): Promise<void> => {
-    customFilter = {};
-    currentPage = 1;
-    await load();
-  };
-
-  const doSearch = async (text: string): Promise<void> => {
-    searchText = text;
-    currentPage = 1;
-    await load();
-  };
-
-  const sortAsc = async (column: string): Promise<void> => {
-    sortColumn = column;
-    sortDirection = "asc";
-    currentPage = 1;
-    await load();
-  };
-
-  const sortDesc = async (column: string): Promise<void> => {
-    sortColumn = column;
-    sortDirection = "desc";
-    currentPage = 1;
-    await load();
-  };
-
-  const setRowsPerPage = async (rows: number): Promise<void> => {
-    if (rows > 0) {
-      rowsPerPage = rows;
-      currentPage = 1;
-      await load();
-    }
-  };
-
-  const hasNextPage = (): boolean => {
-    if (disableTotalCount || useCursorPagination) return hasMorePages;
-    return currentPage < totalPageCount;
-  };
-
-  const hasPrevPage = (): boolean => currentPage > 1;
-
-  const getTotalPageCount = (): number => totalPageCount;
-  const getTotalRecordCount = (): number => totalRecordCount;
-  const getCurrentPage = (): number => currentPage;
-  const getCurrentSortedColumn = (): string | null => sortColumn;
-  const getCurrentSortDirection = (): "asc" | "desc" | null => sortDirection;
-  const getRowsPerPage = (): number => rowsPerPage;
-  const getSearchText = (): string => searchText;
-  const getCustomFilter = (): Record<string, any> => ({ ...customFilter });
-
-  return {
-    getData,
-    load,
-    reset,
-    moveNextPage,
-    movePrevPage,
-    moveFirstPage,
-    moveLastPage,
-    moveToPage,
-    setFilter,
-    resetFilter,
-    doSearch,
-    sortAsc,
-    sortDesc,
-    setRowsPerPage,
-    hasNextPage,
-    hasPrevPage,
-    getTotalPageCount,
-    getTotalRecordCount,
-    getCurrentPage,
-    getCurrentSortedColumn,
-    getCurrentSortDirection,
-    getRowsPerPage,
-    getSearchText,
-    getCustomFilter,
-  };
-};
-
-export default ListHandler;

package/dist/components/table/TableContext.tsx

@@ -1,122 +0,0 @@
-import React, { createContext, useContext, useState, useEffect, useRef, ReactNode } from "react";
-import { ColumnDefinition } from "./DataTable";
-import { ListHandlerConfig, ListActionHandler } from "./ListHandler";
-
-// ============================================================================
-// INTERFACES
-// ============================================================================
-
-export interface DataConfig {
-  api: string;
-  params?: Record<string, any>;
-}
-
-export interface TableContextValue {
-  listHandler: ListActionHandler | null;
-  columns: ColumnDefinition[];
-  setColumns: React.Dispatch<React.SetStateAction<ColumnDefinition[]>>;
-  rows: any[];
-  setRows: React.Dispatch<React.SetStateAction<any[]>>;
-  loading: boolean;
-  setLoading: React.Dispatch<React.SetStateAction<boolean>>;
-}
-
-// ============================================================================
-// CONTEXT
-// ============================================================================
-
-const TableContext = createContext<TableContextValue | null>(null);
-
-export const useTableContext = (): TableContextValue => {
-  const ctx = useContext(TableContext);
-  if (!ctx) throw new Error("useTableContext must be used inside <TableProvider>");
-  return ctx;
-};
-
-// ============================================================================
-// PROVIDER PROPS
-// ============================================================================
-
-export interface TableProviderProps {
-  data: DataConfig;
-  columns?: ColumnDefinition[];
-  rowsPerPage?: number;
-  disableTotalCount?: boolean;
-  useCursorPagination?: boolean;
-  children: ReactNode;
-  listHandlerFactory: (config: ListHandlerConfig) => ListActionHandler;
-  // Resolved by DataList before being passed here — no hooks needed inside Provider
-  tenant: string;
-  module: string;
-  resolvedParams: Record<string, any> | undefined;
-}
-
-// ============================================================================
-// PROVIDER
-// ============================================================================
-
-export const TableProvider: React.FC<TableProviderProps> = ({
-  data,
-  columns: initialColumns = [],
-  rowsPerPage = 20,
-  disableTotalCount = true,
-  useCursorPagination = false,
-  children,
-  listHandlerFactory,
-  tenant,
-  module,
-  resolvedParams,
-}) => {
-  const colIds = initialColumns.map((c) => c.id ?? c.expr ?? "").filter(Boolean);
-
-  // ListHandler created ONCE via ref.
-  // resolvedParams already has all placeholders replaced — passed in from DataList.
-  const listHandlerRef = useRef<ListActionHandler | null>(null);
-  if (listHandlerRef.current === null) {
-    listHandlerRef.current = listHandlerFactory({
-      tenant,
-      module,
-      api: data.api,
-      params: resolvedParams,
-      cols: colIds,
-      rowsPerPage,
-      disableTotalCount,
-      useCursorPagination,
-    });
-  }
-
-  const [columns, setColumns] = useState<ColumnDefinition[]>(initialColumns);
-  const [rows, setRows] = useState<any[]>([]);
-  const [loading, setLoading] = useState(false);
-
-  // Initial data load on mount
-  useEffect(() => {
-    const lh = listHandlerRef.current;
-    if (!lh) return;
-
-    setLoading(true);
-    lh.load()
-      .then(() => setRows([...lh.getData()]))
-      .catch((err) => console.error("TableProvider initial load failed:", err))
-      .finally(() => setLoading(false));
-  }, []);
-
-  return (
-    <TableContext.Provider
-      value={{
-        listHandler: listHandlerRef.current,
-        columns,
-        setColumns,
-        rows,
-        setRows,
-        loading,
-        setLoading,
-      }}
-    >
-      {children}
-    </TableContext.Provider>
-  );
-};
-
-export type { ListHandlerConfig };
-export default TableContext;

package/dist/components/view/ComponentView.tsx

@@ -1,102 +0,0 @@
-import { useEffect, useState } from "react";
-import { useApp } from "../../core/AppContext";
-import { DynamicComponent } from "../../core/DynamicComponent";
-import { usePageContext } from "../../core/PageContext";
-import useDependHandler from "../../core/UIDependHandler";
-import UIComponent, { UIComponentProps } from "../common/UIComponent";
-
-interface ComponentViewProps extends UIComponentProps {
-  // use for dynamic component rendering
-  id?: string;
-
-  // use to get value from page context
-  depends?: string;
-
-  // use to statically set the actual component
-  component?: React.ReactNode;
-}
-
-const ComponentView = (props: ComponentViewProps) => {
-  const { id, name, depends, component } = props ?? {};
-  const [comp, setComp] = useState<React.ReactNode | null>(null);
-  const [error, setError] = useState("");
-  const [forceUpdate, setForceUpdate] = useState({});
-  const { getComponentCache } = useApp();
-  const pageContext = usePageContext();
-
-  const getPreferredName = () => {
-    if (name == null || name.trim() === "") {
-      return depends;
-    }
-    return name;
-  };
-
-  const loadComponentById = async () => {
-    if (id != null && id.trim() !== "") {
-      const cache = await getComponentCache(id);
-      const template: React.ReactNode = cache.template;
-      setComp(template);
-      return template;
-    }
-    return null;
-  };
-
-  const loadComponentByName = () => {
-    const preferredName = getPreferredName();
-    if (preferredName != null && preferredName.trim() !== "") {
-      const info = pageContext?.get(preferredName) as { component: string; attr?: Record<string, any> };
-      const { component, attr = {} } = info ?? {};
-
-      if (component == null || component.trim() === "") {
-        return null;
-      }
-
-      return <DynamicComponent config={{ component, attr }} />;
-    }
-    return null;
-  };
-
-  const loadStaticComponent = () => {
-    if (typeof component === "string") {
-      return <DynamicComponent config={{ component }} />;
-    }
-    return component;
-  };
-
-  const onRefresh = () => {
-    setForceUpdate({});
-  };
-
-  useDependHandler({ name: depends, onRefresh });
-
-  useEffect(() => {
-    const prefName = name ?? depends ?? "";
-
-    const tmpl = loadStaticComponent();
-    if (tmpl != null) {
-      setComp(tmpl);
-      return;
-    }
-
-    loadComponentById()
-      .then((template) => {
-        if (template != null) {
-          setComp(template);
-          return;
-        }
-
-        const tmpl2 = loadComponentByName();
-        if (tmpl2 != null) {
-          setComp(tmpl2);
-        }
-      })
-      .catch((err) => {
-        console.log("error", err);
-        setError(err.message);
-      });
-  }, [forceUpdate]);
-
-  return <UIComponent {...props}>{error ? <div>{error}</div> : <div>{comp}</div>}</UIComponent>;
-};
-
-export default ComponentView;

package/dist/components/view/FilterView.tsx

@@ -1,21 +0,0 @@
-import VPanel from "../../layouts/VPanel";
-import { renderListDef } from "../../lib/utils/SectionProvider";
-
-const FilterView = (props: Record<string, any>) => {
-  const { items = [] } = props ?? {};
-
-  if (items.length === 0) return null;
-
-  const buildPanel = () => {
-    const comps = renderListDef(items);
-    return <VPanel gap={8}>{comps}</VPanel>;
-  };
-
-  return (
-    <>
-      <div>{buildPanel()}</div>
-    </>
-  );
-};
-
-export default FilterView;

package/dist/components/view/HtmlForm.tsx

@@ -1,176 +0,0 @@
-import { localAPI } from "@ramesesinc/lib/local-api";
-import React, { useEffect, useMemo, useState } from "react";
-import { useApp } from "../../core/AppContext";
-import { DynamicComponent } from "../../core/DynamicComponent";
-import useDependHandler from "../../core/UIDependHandler";
-import UIComponent from "../common/UIComponent";
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Types
-// ─────────────────────────────────────────────────────────────────────────────
-
-type HtmlFormProps = {
-  label?: string;
-  depends?: string;
-  templateid?: string;
-};
-
-type SentinelConfig = {
-  component: string;
-  attr: any;
-};
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Attr Parser
-// Handles both strict JSON {"key":"value"} and JS object literals {key: "value"}
-// ─────────────────────────────────────────────────────────────────────────────
-
-function parseAttr(attrStr: string | null): any {
-  if (!attrStr) return {};
-  try {
-    return JSON.parse(attrStr);
-  } catch {
-    try {
-      // eslint-disable-next-line no-new-func
-      // return new Function(`"use strict"; return (${attrStr})`)();
-      const normalized = attrStr.replace(/([{,]\s*)([a-zA-Z_$][a-zA-Z0-9_$]*)(\s*:)/g, '$1"$2"$3').replace(/'([^'\\]*(\\.[^'\\]*)*)'/g, '"$1"');
-      return JSON.parse(normalized);
-    } catch {
-      console.warn("HtmlForm: could not parse attr →", attrStr);
-      return {};
-    }
-  }
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// DOM Attribute → React Prop mapper
-// ─────────────────────────────────────────────────────────────────────────────
-
-const ATTR_MAP: Record<string, string> = {
-  class: "className",
-  colspan: "colSpan",
-  rowspan: "rowSpan",
-  for: "htmlFor",
-  tabindex: "tabIndex",
-  readonly: "readOnly",
-  maxlength: "maxLength",
-  cellpadding: "cellPadding",
-  cellspacing: "cellSpacing",
-};
-
-function styleStringToObject(styleStr: string): Record<string, string> {
-  const style: Record<string, string> = {};
-  styleStr.split(";").forEach((rule) => {
-    const [prop, val] = rule.split(":").map((s) => s.trim());
-    if (prop && val) {
-      const camel = prop.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-      style[camel] = val;
-    }
-  });
-  return style;
-}
-
-function domAttrsToProps(el: Element): Record<string, any> {
-  const props: Record<string, any> = {};
-  for (const attr of Array.from(el.attributes)) {
-    if (["component", "attr"].includes(attr.name)) continue;
-    const reactName = ATTR_MAP[attr.name] ?? attr.name;
-    props[reactName] = attr.name === "style" ? styleStringToObject(attr.value) : attr.value;
-  }
-  return props;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Table structural elements that cannot contain whitespace text nodes
-// ─────────────────────────────────────────────────────────────────────────────
-
-const TABLE_ELEMENTS = new Set(["table", "thead", "tbody", "tfoot", "tr", "colgroup"]);
-
-// ─────────────────────────────────────────────────────────────────────────────
-// DOM Walker
-// Turns a DOM tree into a React element tree.
-// Sentinel <span component="X" attr="..."> becomes <DynamicComponent config={...} />
-// Everything else becomes a plain React element.
-// ─────────────────────────────────────────────────────────────────────────────
-
-let _keyIndex = 0;
-const nextKey = () => `hf_${_keyIndex++}`;
-
-function walkNode(node: ChildNode, parentTag?: string): React.ReactNode {
-  if (node.nodeType === Node.TEXT_NODE) {
-    // Whitespace-only text nodes are invalid inside table structural elements
-    // and cause React's validateDOMNesting warning.
-    if (parentTag && TABLE_ELEMENTS.has(parentTag) && !node.textContent?.trim()) {
-      return null;
-    }
-    return node.textContent || null;
-  }
-
-  if (node.nodeType === Node.ELEMENT_NODE) {
-    const el = node as Element;
-    const tag = el.tagName.toLowerCase();
-    const componentName = el.getAttribute("component");
-
-    // ── Sentinel span → DynamicComponent ──────────────────────────────────
-    if (tag === "span" && componentName) {
-      const attr: any = parseAttr(el.getAttribute("attr"));
-      const config: SentinelConfig = { component: componentName, attr };
-      return <DynamicComponent key={nextKey()} config={config} />;
-    }
-
-    // ── Regular element → recurse ──────────────────────────────────────────
-    const props = { ...domAttrsToProps(el), key: nextKey() };
-    const children: React.ReactNode[] = Array.from(el.childNodes)
-      .map((child) => walkNode(child, tag)) // pass current tag as parentTag
-      .filter((n) => n !== null && n !== undefined);
-
-    return children.length > 0 ? React.createElement(tag, props, ...children) : React.createElement(tag, props);
-  }
-
-  return null;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// HtmlForm
-// ─────────────────────────────────────────────────────────────────────────────
-
-const HtmlForm = (props: HtmlFormProps) => {
-  const { depends, templateid } = props ?? {};
-
-  const [htmlTemplate, setHtmlTemplate] = useState("");
-
-  const { tenant, module } = useApp();
-
-  // ── Load raw HTML from html_forms ──────────────────────────────────────────
-  const loadHtmlContent = async (tempid: string) => {
-    try {
-      const record = await localAPI.useMgmt(tenant!, module!).get("html_templates", tempid);
-      setHtmlTemplate(record?.htmlCode ?? "");
-    } catch (error) {
-      console.error("HtmlForm: error loading html_forms →", error);
-      setHtmlTemplate("");
-    }
-  };
-
-  useDependHandler({ name: depends, onRefresh: () => {} });
-
-  useEffect(() => {
-    if (templateid?.trim()) loadHtmlContent(templateid);
-  }, [templateid]);
-
-  // ── Walk DOM → React tree (only re-runs when htmlTemplate changes) ─────────
-  const reactTree = useMemo(() => {
-    if (!htmlTemplate) return null;
-    _keyIndex = 0;
-    const doc = new DOMParser().parseFromString(htmlTemplate, "text/html");
-    return Array.from(doc.body.childNodes).map((child) => walkNode(child));
-  }, [htmlTemplate]);
-
-  return (
-    <UIComponent {...(props ?? {})}>
-      <div className="h-[calc(100vh-80px)] overflow-y-auto overflow-x-auto">{reactTree}</div>
-    </UIComponent>
-  );
-};
-
-export default HtmlForm;