@ramesesinc/platform-core 0.1.6 → 0.1.9

package/dist/components/view/HtmlView.tsx

@@ -1,98 +0,0 @@
-import { localAPI } from "@ramesesinc/lib/local-api";
-import { useEffect, useState } from "react";
-import { useApp } from "../../core/AppContext";
-import { usePageContext } from "../../core/PageContext";
-import useDependHandler from "../../core/UIDependHandler";
-import { render } from "../../lib/utils/ExprUtil";
-import UIComponent from "../common/UIComponent";
-
-type HtmlLabelProps = {
-  label?: string;
-  depends?: string;
-  expr?: string;
-  templateid?: string;
-  data?: Record<string, any>;
-};
-
-const Html = (props: HtmlLabelProps) => {
-  const { depends, expr, templateid } = props ?? {};
-
-  const [htmlTemplate, setHtmlTemplate] = useState(""); // raw template
-  const [renderedHtml, setRenderedHtml] = useState(""); // rendered output
-  const pageContext = usePageContext();
-  const binding = pageContext?.binding;
-  const { tenant, module } = useApp();
-
-  // ← single render function used everywhere
-  const renderTemplate = (template: string) => {
-    if (!template) return "";
-    try {
-      const data = pageContext?.getAllData() ?? {};
-      return render(template, data);
-    } catch (error) {
-      console.error("Template render error:", error);
-      return template;
-    }
-  };
-
-  // ← single expression render
-  const renderExpression = (expression: string) => {
-    if (!expression) return "";
-    try {
-      const data = pageContext?.getData() ?? {};
-      return render(expression, { data });
-    } catch (error) {
-      console.error("Expression render error:", error);
-      return expression;
-    }
-  };
-
-  // ← load template only once when templateid changes
-  useEffect(() => {
-    if (templateid == null || templateid.trim() === "") return;
-
-    const loadHtmlContent = async () => {
-      try {
-        const htmlContent = await localAPI.useMgmt(tenant!, module!).get("html_templates", templateid);
-        if (htmlContent != null) {
-          setHtmlTemplate(htmlContent.htmlCode); // ← just store raw template
-        } else {
-          setHtmlTemplate("");
-        }
-      } catch (error) {
-        console.error("Error loading HTML template:", error);
-        setHtmlTemplate("");
-      }
-    };
-
-    loadHtmlContent();
-  }, [templateid]);
-
-  // ← re-render whenever template OR binding data changes
-  useEffect(() => {
-    if (htmlTemplate) {
-      setRenderedHtml(renderTemplate(htmlTemplate));
-    } else if (expr) {
-      setRenderedHtml(renderExpression(expr));
-    }
-  }, [htmlTemplate, binding?.raw]); // ← binding.raw triggers when data changes
-
-  // ← onRefresh called when depends changes
-  const onRefresh = () => {
-    if (htmlTemplate) {
-      setRenderedHtml(renderTemplate(htmlTemplate));
-    } else if (expr) {
-      setRenderedHtml(renderExpression(expr));
-    }
-  };
-
-  useDependHandler({ name: depends, onRefresh });
-
-  return (
-    <UIComponent {...(props ?? {})}>
-      <div className="h-[calc(100vh-80px)] overflow-y-auto overflow-x-auto" dangerouslySetInnerHTML={{ __html: renderedHtml }} />
-    </UIComponent>
-  );
-};
-
-export default Html;

package/dist/components/view/IFrameView.tsx

@@ -1,48 +0,0 @@
-"use client";
-
-import { useEffect, useRef, useState } from "react";
-import { usePageContext } from "../../core/PageContext";
-
-const Iframe = (props: Record<string, any>) => {
-  // console.log(props);
-  const { url = "", name, depends = "page", width = "100%", height = "100%" } = props ?? {};
-  const pageContext = usePageContext();
-  const lastValueRef = useRef<any>();
-  const [iframeUrl, setIframeUrl] = useState(url);
-
-  const dependHandler = (value: any) => {
-    if (lastValueRef.current === value) return; // skip if unchanged
-    lastValueRef.current = value;
-
-    // value is expected to be a URL (string)
-    if (typeof value === "string") {
-      setIframeUrl(value);
-    }
-  };
-
-  useEffect(() => {
-    if (!depends) return;
-    const unsubscribe = pageContext?.dependsTo(depends, dependHandler);
-    return unsubscribe;
-  }, [depends]);
-
-  if (!iframeUrl) return null;
-
-  return (
-    <div className="h-[calc(100vh-60px)]">
-      <iframe
-        src={iframeUrl}
-        name={name}
-        title={name || "iframe"}
-        style={{
-          width,
-          height,
-          border: "none",
-        }}
-        loading="lazy"
-      />
-    </div>
-  );
-};
-
-export default Iframe;

package/dist/components/view/Modal.tsx

@@ -1,72 +0,0 @@
-"use client";
-
-import clsx from "clsx";
-import { MouseEvent, ReactNode, useEffect } from "react";
-
-export type ModalRenderFn = (close: () => void) => ReactNode;
-
-export type ModalProps = {
-  open: boolean;
-  onClose: () => void;
-  children: ReactNode | ModalRenderFn;
-  title?: string;
-  className?: string;
-  width?: string; // e.g. "500px" or "50%"
-  height?: string; // e.g. "400px" or "80%"
-  hideCloseButton?: boolean;
-};
-
-const Modal = ({ open, onClose, title, children, className, width = "600px", height, hideCloseButton = false }: ModalProps) => {
-  useEffect(() => {
-    const handleKey = (e: KeyboardEvent) => {
-      if (e.key === "Escape") {
-        onClose();
-      }
-    };
-
-    if (open) {
-      document.addEventListener("keydown", handleKey);
-    }
-
-    return () => {
-      document.removeEventListener("keydown", handleKey);
-    };
-  }, [open, onClose]);
-
-  if (!open) return null;
-
-  const handleOverlayClick = (e: MouseEvent<HTMLDivElement>) => {
-    // if (e.target === e.currentTarget) {
-    //   onClose();
-    // }
-  };
-
-  return (
-    <div className="fixed inset-0 z-[9999] flex items-center justify-center bg-black/40" onClick={handleOverlayClick}>
-      <div
-        className={clsx("relative bg-white rounded-lg shadow-lg p-2 w-full max-w-[90vw] transition-all duration-300 ease-in-out", className)}
-        style={{ width, height }}
-        role="dialog"
-        aria-modal="true"
-        aria-labelledby={title ? "modal-title" : undefined}
-      >
-        {title && (
-          <h2 id="modal-title" className="text-lg font-semibold mb-4 border-b pb-2 text-gray-800">
-            {title}
-          </h2>
-        )}
-
-        {/* Modal Content */}
-        <div className="overflow-auto">{typeof children === "function" ? children(onClose) : children}</div>
-
-        {!hideCloseButton && (
-          <button onClick={onClose} aria-label="Close modal" className="absolute top-2 right-2 text-gray-500 hover:text-gray-800 transition-colors">
-            ✕
-          </button>
-        )}
-      </div>
-    </div>
-  );
-};
-
-export default Modal;

package/dist/components/view/PageView.tsx

@@ -1,131 +0,0 @@
-"use client";
-
-import React, { forwardRef, memo, useEffect, useImperativeHandle, useRef, useState } from "react";
-import Page from "../../core/Page";
-import { usePageContext } from "../../core/PageContext";
-import { PageViewContextValue, PageViewHandle, PageViewProvider, usePageViewContext } from "../../core/PageViewContext";
-import useDependHandler from "../../core/UIDependHandler";
-import { useUrlParams } from "../../hooks/useUrlParams";
-import UIComponent, { UIComponentProps } from "../common/UIComponent";
-
-type StableShellProps = {
-  uiProps: Record<string, any>;
-  handle: PageViewHandle;
-  slotRef: React.RefObject<PageSlotHandle>;
-  paths: string[]; // ← new
-};
-
-const StableShell = memo((props: StableShellProps) => {
-  const { uiProps, slotRef, handle, paths } = props ?? {};
-  return (
-    <UIComponent {...uiProps}>
-      <PageViewProvider handle={handle} paths={paths ?? []}>
-        <PageSlot ref={slotRef} />
-      </PageViewProvider>
-    </UIComponent>
-  );
-});
-
-interface PageViewProps extends UIComponentProps {
-  depends?: string;
-  url?: string;
-  fallback?: React.ReactNode;
-}
-
-const PageView = memo((props: PageViewProps) => {
-  const { name = "selectedPage", depends, url } = props ?? {};
-  const [forceUpdate, setForceUpdate] = useState({});
-  const providerRef = useRef<PageViewContextValue>({} as PageViewContextValue);
-  const { setAnchorPath } = useUrlParams();
-  const slotRef = useRef<PageSlotHandle>(null);
-  const pageContext = usePageContext();
-  const [ownPaths, setOwnPaths] = useState<string[]>([]);
-  const isEmpty = (value: string | null | undefined) => value == null || value.trim() === "";
-
-  const pageView = usePageViewContext();
-
-  let preferredName = isEmpty(name) ? depends : name;
-  let preferredDepends = isEmpty(depends) ? preferredName : depends;
-
-  const newProps = { ...props, name: preferredName, depends: preferredDepends };
-
-  const propsRef = useRef(newProps);
-  useEffect(() => {
-    propsRef.current = newProps;
-  });
-
-  const getUrl = () => {
-    if (url != null && url.trim() !== "") return url;
-    if (newProps.name) return pageContext.get(newProps.name);
-    return null;
-  };
-
-  const getUrlRef = useRef(getUrl);
-  useEffect(() => {
-    getUrlRef.current = getUrl;
-  });
-
-  // Stable handle — never recreated
-  const pageViewHandleRef = useRef({
-    displayName: "PageView#pageViewHandle",
-    init: (ref: PageViewContextValue) => {
-      providerRef.current = ref;
-      setForceUpdate({});
-    },
-    renderPage: (page: string | null) => {
-      if (page == null || page.trim() === "") {
-        slotRef.current?.update(null, "null");
-        return;
-      }
-      setOwnPaths([page]); // ← track own paths
-      const key = "page-" + Math.random().toString(36).slice(2);
-      const comp = <Page {...propsRef.current} url={page} key={key} />;
-      slotRef.current?.update(comp, page);
-    },
-    isStandalone: () => {
-      return pageView == null ? true : pageView.isStandalone();
-    },
-  });
-
-  const onRefresh = (val?: any) => {
-    setForceUpdate({ val }); // ← carry the value
-  };
-
-  useDependHandler({ name: newProps.depends, onRefresh });
-
-  useEffect(() => {
-    const prov = providerRef.current;
-    if (prov == null || typeof prov.setPage !== "function") return;
-
-    const url = getUrlRef.current();
-    // console.log("pageView forceUpdate", url, providerRef.current);
-    providerRef.current.setPage(url);
-  }, [forceUpdate]);
-
-  return <StableShell uiProps={newProps} handle={pageViewHandleRef.current} slotRef={slotRef} paths={ownPaths} />;
-});
-
-type PageSlotHandle = {
-  update: (content: React.ReactNode, opt?: any) => void;
-};
-const PageSlot = memo(
-  forwardRef<PageSlotHandle>((_, ref) => {
-    const [content, setContent] = useState<React.ReactNode>(null);
-    const [opt, setOpt] = useState<any>(null);
-
-    useImperativeHandle(
-      ref,
-      () => ({
-        update: (content: React.ReactNode, opt?: any) => {
-          setContent(content);
-          setOpt(opt);
-        },
-      }),
-      [],
-    );
-
-    return <>{content == null ? null : content}</>;
-  }),
-);
-
-export default PageView;

package/dist/components/view/PopupView.tsx

@@ -1,160 +0,0 @@
-import { getError } from "@ramesesinc/client";
-import clsx from "clsx";
-import React, { forwardRef, memo, useEffect, useImperativeHandle, useRef, useState } from "react";
-import { twMerge } from "tailwind-merge";
-import { EventHandler } from "../../core";
-import Page from "../../core/Page";
-import { PageViewContextValue, PageViewHandle, PageViewProvider } from "../../core/PageViewContext";
-
-type PopupViewProps = {
-  url: string;
-  popupClassName?: string;
-  onClose?: () => void;
-  eventHandler?: EventHandler | null;
-};
-
-const PopupView = (props: PopupViewProps) => {
-  const { url, popupClassName, onClose = () => {}, eventHandler } = props ?? {};
-
-  const [paths, setPaths] = useState<string[]>([]);
-
-  const providerRef = useRef<PageViewContextValue>({} as PageViewContextValue);
-  const slotRef = useRef<PopupSlotHandle>(null);
-
-  const [newRootPath, setNewRootPath] = useState<string | null>(null);
-  const [reInitPage, setReInitPage] = useState(true);
-
-  const mainPath = useRef("");
-
-  const defaultPopupClass = `bg-white rounded-lg shadow-xl w-[90%] h-[90%] flex flex-col`;
-  const finalPopupClass = twMerge(clsx(defaultPopupClass, popupClassName));
-
-  const loadPage = (path: string | null) => {
-    // console.log("popupview load page", path);
-    let comp = null;
-    try {
-      const key = "page-" + Math.random().toString(36).slice(2);
-      comp = <Page url={path} key={key} />;
-    } catch (error: any) {
-      const e = getError(error);
-      comp = <div>{e.message}</div>;
-    }
-
-    // update the child slot
-    slotRef.current?.update(comp, finalPopupClass, onClose);
-  };
-
-  useEffect(() => {
-    // console.log("popupview change url", url);
-    const paths = (url == null || url.trim() === "" ? "" : url).split("#");
-    const [firstPath] = paths;
-    mainPath.current = firstPath;
-    setPaths(paths);
-  }, [url]);
-
-  useEffect(() => {
-    // this routine is for the initial loading
-    // console.log("popupview change paths", paths);
-    loadPage(mainPath.current);
-    setReInitPage(false);
-  }, [paths]);
-
-  useEffect(() => {
-    if (reInitPage) {
-      // let the initial loading take effect
-      return;
-    }
-
-    loadPage(newRootPath);
-  }, [newRootPath]);
-
-  const pageViewHandle = {
-    displayName: "PopupView#pageViewHandle",
-    init: (ref: PageViewContextValue) => {
-      providerRef.current = ref;
-    },
-    renderPage: (page: string) => {
-      setNewRootPath(page);
-    },
-    isStandalone: () => true,
-  } as PageViewHandle;
-
-  return (
-    <PageViewProvider prefix="popup" paths={paths} handle={pageViewHandle} eventHandler={eventHandler}>
-      <ChildrenSlot ref={slotRef} />
-    </PageViewProvider>
-  );
-};
-
-export default PopupView;
-
-type PopupSlotHandle = {
-  update: (content: React.ReactNode, popupClassName: string, onClose: () => void) => void;
-};
-
-const ChildrenSlot = memo(
-  forwardRef<PopupSlotHandle>((_, ref) => {
-    const [content, setContent] = useState<React.ReactNode>(null);
-
-    const optionsRef = useRef<Record<string, any>>({});
-
-    useImperativeHandle(
-      ref,
-      () => ({
-        update: (content: React.ReactNode, popupClassName: string, onClose: () => void) => {
-          const options = { popupClassName, onClose };
-          setContent(wrapContent(content, options));
-          optionsRef.current = options;
-        },
-      }),
-      [],
-    );
-
-    const handleClose = () => {
-      setContent(null);
-
-      const { onClose } = optionsRef.current;
-      if (onClose != null && typeof onClose === "function") {
-        onClose();
-      }
-    };
-
-    const wrapContent = (comp: React.ReactNode, options: Record<string, any>): React.ReactNode => {
-      if (comp == null) {
-        return null;
-      }
-
-      const { popupClassName } = options;
-      return (
-        <div className="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50">
-          <div className={popupClassName}>
-            {/* Header */}
-            <div className="flex items-center justify-between px-4 py-3 border-b">
-              <h2 className="text-lg font-semibold">Page Viewer</h2>
-              <button onClick={handleClose} className="w-8 h-8 flex items-center justify-center rounded-md hover:bg-gray-100 transition-colors">
-                <svg
-                  xmlns="http://www.w3.org/2000/svg"
-                  width="20"
-                  height="20"
-                  viewBox="0 0 24 24"
-                  fill="none"
-                  stroke="currentColor"
-                  strokeWidth="2"
-                  strokeLinecap="round"
-                  strokeLinejoin="round"
-                >
-                  <line x1="18" y1="6" x2="6" y2="18"></line>
-                  <line x1="6" y1="6" x2="18" y2="18"></line>
-                </svg>
-              </button>
-            </div>
-            {/* Content */}
-            <div className="flex-1 overflow-hidden">{comp}</div>
-          </div>
-        </div>
-      );
-    };
-
-    return <>{content == null ? null : content}</>;
-  }),
-);

package/dist/components/view/RootView.tsx

@@ -1,109 +0,0 @@
-import { getError } from "@ramesesinc/client";
-import { forwardRef, memo, useEffect, useImperativeHandle, useLayoutEffect, useRef, useState } from "react";
-import { EventHandler } from "../../core";
-import Page from "../../core/Page";
-import { PageViewContextValue, PageViewHandle, PageViewProvider } from "../../core/PageViewContext";
-
-type RootViewProps = {
-  url: string;
-  eventHandler?: EventHandler | null;
-  standalone?: boolean;
-};
-
-const RootView = (props: RootViewProps) => {
-  const { url, eventHandler, standalone = true } = props ?? {};
-
-  const [paths, setPaths] = useState<string[]>([]);
-
-  const mainPath = useRef("");
-
-  const [newRootPath, setNewRootPath] = useState<string | null>(null);
-  const [reInitPage, setReInitPage] = useState(true);
-
-  const providerRef = useRef<PageViewContextValue>({} as PageViewContextValue);
-
-  const loadPage = (path: string | null) => {
-    let comp = null;
-    try {
-      // console.log("RootView loadPage", path); // main#tasklist
-      const pageUUID = "page-" + Math.random().toString(36).slice(2);
-      comp = <Page url={path} key={pageUUID} />;
-    } catch (error: any) {
-      const e = getError(error);
-      // console.log("rootview loadpage error", e);
-      comp = <div>{e.message}</div>;
-    }
-    // update provider paths but maintain the rootPath
-    // providerRef.current?.updatePaths(newPaths);
-    // update the child slot
-    slotRef.current?.update(comp);
-  };
-
-  useLayoutEffect(() => {
-    const paths = (url == null || url.trim() === "" ? "" : url).split("#");
-    // console.log("RootView useLayoutEffect ", url, paths);
-    const [firstPath] = paths;
-    mainPath.current = firstPath;
-    setPaths(paths);
-  }, [url]);
-
-  useEffect(() => {
-    // this routine is for the initial loading
-    // pass the original url
-    loadPage(url);
-    setReInitPage(false);
-  }, [paths]);
-
-  useEffect(() => {
-    if (reInitPage) {
-      // let the initial loading take effect
-      return;
-    }
-
-    loadPage(newRootPath);
-  }, [newRootPath]);
-
-  const pageViewHandle = {
-    displayName: "RootView#pageViewHandle",
-    init: (ref: PageViewContextValue) => {
-      providerRef.current = ref;
-    },
-    renderPage: (page: string) => {
-      // console.log("RootView renderPage", page);
-      setNewRootPath(page);
-    },
-    isStandalone: () => standalone,
-  } as PageViewHandle;
-
-  const slotRef = useRef<ChildrenSlotHandle>(null);
-
-  return (
-    <PageViewProvider prefix="root" paths={paths} handle={pageViewHandle} eventHandler={eventHandler}>
-      <ChildrenSlot ref={slotRef} />
-    </PageViewProvider>
-  );
-};
-
-export default RootView;
-
-type ChildrenSlotHandle = {
-  update: (content: React.ReactNode) => void;
-};
-const ChildrenSlot = memo(
-  forwardRef<ChildrenSlotHandle>((_, ref) => {
-    const [content, setContent] = useState<React.ReactNode>(null);
-
-    useImperativeHandle(
-      ref,
-      () => ({
-        update: (content: React.ReactNode) => {
-          // console.log("childrenslot update", content);
-          setContent(content);
-        },
-      }),
-      [],
-    );
-
-    return <>{content == null ? null : content}</>;
-  }),
-);

package/dist/components/view/WizardView.tsx

@@ -1,48 +0,0 @@
-import { useEffect, useRef } from "react";
-import { usePageContext } from "../../core/PageContext";
-import { StepActionHandler, StepHandler } from "../../core/StepHandler";
-import ComponentView from "./ComponentView";
-
-type WizardViewProps = {
-  name: string;
-  items: Record<string, any>[];
-};
-
-const WizardView = (props: WizardViewProps) => {
-  const { name = "wizard", items = [] } = props ?? {};
-  const pageContext = usePageContext();
-  const handlerRef = useRef<StepActionHandler | null>(null);
-
-  if (handlerRef.current == null) {
-    const callback = (item: Record<string, any>) => {
-      const onInit = item.events?.onInit;
-      if (onInit != null && typeof onInit === "function") {
-        onInit();
-      }
-      pageContext?.set(name, item);
-    };
-
-    const handler = StepHandler(items, callback);
-
-    for (const it of items) {
-      const item = it as Record<string, any>;
-      if (item.attr == null) item.attr = {};
-      item.attr.stepHandler = handler;
-      item.attr.events = {};
-    }
-
-    handlerRef.current = handler;
-  }
-
-  useEffect(() => {
-    pageContext?.set(name, items[0]);
-  }, []);
-
-  return (
-    <div>
-      <ComponentView name={name} depends={name} />
-    </div>
-  );
-};
-
-export default WizardView;

package/dist/lib/layouts/BorderLayout.tsx

@@ -1,31 +0,0 @@
-import { ReactNode } from "react";
-import HorizontalLayout from "./HorizontalLayout";
-import PageLayout from "./PageLayout";
-
-type BorderLayoutProps = {
-  layoutid?: string;
-  className?: string;
-  vgap?: number;
-  hgap?: number;
-
-  north?: ReactNode;
-  south?: ReactNode;
-  east?: ReactNode;
-  west?: ReactNode;
-
-  children?: ReactNode;
-};
-
-const BorderLayout = ({ layoutid, className, vgap = 0, hgap = 0, north, south, east, west, children }: BorderLayoutProps) => {
-  const preferredLayoutId = layoutid ?? "" ? layoutid : "borderlayout";
-
-  return (
-    <PageLayout layoutid={`${preferredLayoutId}`} className={className} gap={vgap} header={north} footer={south}>
-      <HorizontalLayout layoutid={`${preferredLayoutId}-center`} gap={hgap} left={west} right={east}>
-        {children}
-      </HorizontalLayout>
-    </PageLayout>
-  );
-};
-
-export default BorderLayout;