@evenicanpm/portal-table-ui 1.4.0 → 1.5.0

package/dist/auth/auth-context.d.ts

@@ -0,0 +1,36 @@
+import { type PropsWithChildren } from "react";
+/**
+ * Powers the auth provider that portal is wrapped in
+ * Aggregates user and session related data that is needed
+ * within the portal
+ */
+interface AuthProviderProps {
+    /** The user details returned from auth framework eg. next-auth **/
+    session: Session;
+    /** how to handle logout **/
+    logout: () => void;
+}
+/**
+ * The context value
+ */
+interface AuthContext {
+    session: Session | null;
+    /** how to handle logout **/
+    logout: (() => void) | null;
+    isAuthenticated: boolean | null;
+}
+interface Session {
+    email: string | null | undefined;
+    name: string | null | undefined;
+    token: string | null | undefined;
+}
+declare const AuthContext: import("react").Context<AuthContext>;
+/**
+ * Used to access auth details and callback handlers within the portal auth context
+ */
+declare const useAuth: () => AuthContext;
+/**
+ *
+ */
+declare const PortalAuthProvider: ({ session, logout, children, }: PropsWithChildren<AuthProviderProps>) => import("react").JSX.Element;
+export { PortalAuthProvider, useAuth, type AuthProviderProps, AuthContext, type Session, };

package/dist/features/settings/index.d.ts

@@ -0,0 +1,2 @@
+declare const PortalSettings: () => import("react").JSX.Element;
+export { PortalSettings };

package/dist/features/table/components/dashboard/table/actions.d.ts

@@ -0,0 +1,14 @@
+import FileDownloadOutlinedIcon from "@mui/icons-material/FileDownloadOutlined";
+import { UseMutationOptions } from "@tanstack/react-query";
+/**
+ *
+ * Map of action types -> MUI Icons
+ *
+ */
+export declare const actionIconMap: Record<string, typeof FileDownloadOutlinedIcon>;
+type MutationFactory = (resourceName: string, docId: string) => UseMutationOptions<any, any, any, any>;
+/**
+ *
+ */
+export declare const actionMutationMap: Record<string, MutationFactory>;
+export {};

package/dist/features/table/components/dashboard/table/data-mask-map.d.ts

@@ -0,0 +1,2 @@
+import * as Table from "../../../types/";
+export declare const dataMaskMap: Table.Handlers.DataMaskMap;

package/dist/features/table/components/dashboard/table/details/details.d.ts

@@ -0,0 +1,27 @@
+import type { Column } from "@evenicanpm/portal-types-schemas";
+import type * as Types from "../../../../types";
+import type { StatusColorMap, StatusTextMap } from "../../../../types/schemas";
+interface DetailsProps {
+    /** What do we do when use clicks back button? */
+    handleBack: () => void;
+    /** What is the id field name */
+    id: string | number;
+    /** The actual pojo of data from the API */
+    documentData: Types.Queries.Row;
+    documentTypeLabel: string;
+    /** Special instructions for how to render certain properties */
+    detailsRenderMap?: Types.Handlers.DetailsRenderMap;
+    /** Data mask map */
+    dataMaskMap: Types.Handlers.DataMaskMap;
+    /** Table columns **/
+    columns: Column[];
+    /** */
+    statusColorMap: StatusColorMap;
+    /** */
+    statusTextMap: StatusTextMap;
+}
+/**
+ * The Details Page
+ */
+declare const Details: ({ id, documentTypeLabel, documentData, handleBack, columns, dataMaskMap, statusColorMap, statusTextMap, }: DetailsProps) => import("react").JSX.Element;
+export { Details };

package/dist/features/table/components/dashboard/table/details/label.d.ts

@@ -0,0 +1,5 @@
+interface Props {
+    label: string;
+}
+declare const DetailsRowLabel: (props: Props) => import("react").JSX.Element;
+export { DetailsRowLabel };

package/dist/features/table/components/dashboard/table/details/rows/downloads.d.ts

@@ -0,0 +1,6 @@
+interface Props {
+    label: string;
+    value: string[];
+}
+declare const DetailsDownloads: ({ value }: Props) => import("react").JSX.Element;
+export { DetailsDownloads };

package/dist/features/table/components/dashboard/table/details/rows/primitive.d.ts

@@ -0,0 +1,6 @@
+interface Props {
+    label: string;
+    value: string | number;
+}
+declare const DetailsPrimitive: (props: Props) => import("react").JSX.Element;
+export { DetailsPrimitive };

package/dist/features/table/components/dashboard/table/details/rows/table.d.ts

@@ -0,0 +1,17 @@
+import type { Column } from "@evenicanpm/portal-types-schemas";
+import type { DataMaskMap } from "../../../../../types/handlers";
+interface Props {
+    column: Column;
+    value: Record<string, string>[];
+    label: string;
+    dataMaskMap: DataMaskMap;
+}
+/**
+ * Simple table that takes an array of records,
+ * builds array of columns from first index and then loops
+ * builds table values from rest of the indexes.
+ * @param props
+ * @returns
+ */
+declare const DetailsTable: (props: Props) => import("react").JSX.Element;
+export { DetailsTable };

package/{src/features/table/components/dashboard/table/details/styles.ts → dist/features/table/components/dashboard/table/details/styles.d.ts}

@@ -1,18 +1,10 @@
 import type { StyledComponent } from "@emotion/styled";
-import { Box, type BoxProps } from "@mui/material";
-import { styled } from "@mui/material/styles";
-
+import { type BoxProps } from "@mui/material";
 /**
  * Explicit type annotation is required here to prevent TS2742.
  * Without it, TypeScript tries to infer complex internal types from nested
  * node_modules (@mui/system), which leads to non-portable type definitions
  * in monorepo or library builds.
  */
-const DetailsRowBox: StyledComponent<BoxProps> = styled(Box)({
-	mb: 2,
-	display: "flex",
-	alignItems: "flex-start",
-	gap: 2,
-});
-
+declare const DetailsRowBox: StyledComponent<BoxProps>;
 export { DetailsRowBox };

package/dist/features/table/components/dashboard/table/filter-render-map.d.ts

@@ -0,0 +1,2 @@
+import * as Table from "../../../types/";
+export declare const filterRenderMapFallback: Table.Handlers.FilterRenderMap;

package/dist/features/table/components/dashboard/table/filters/date-filter.d.ts

@@ -0,0 +1,2 @@
+import * as Table from "../../../../types";
+export declare const DateFilter: (props: Table.Handlers.FilterProps) => import("react").JSX.Element;

package/dist/features/table/components/dashboard/table/filters/status-filter.d.ts

@@ -0,0 +1,2 @@
+import * as Table from "../../../../types/";
+export declare const StatusFilter: (props: Table.Handlers.FilterProps) => import("react").JSX.Element;

package/dist/features/table/components/dashboard/table/no-results.d.ts

@@ -0,0 +1,2 @@
+import * as Table from "../../../types/";
+export declare const NoResultsComponent: Table.Handlers.NoResultsComponent;

package/dist/features/table/components/dashboard/table/status-pill.d.ts

@@ -0,0 +1,8 @@
+import type { StatusColorMap, StatusTextMap } from "../../../types/schemas";
+interface Props {
+    status: number | string | string[];
+    statusTextMap: StatusTextMap;
+    statusColorMap: StatusColorMap;
+}
+declare const StatusPill: (props: Props) => import("react").JSX.Element | null;
+export { StatusPill };

package/dist/features/table/components/dashboard/table/table-header.d.ts

@@ -0,0 +1,16 @@
+import type React from "react";
+import { Column } from "@evenicanpm/portal-types-schemas";
+interface TableHeaderProps {
+    hasActions: boolean;
+    columns: (Column & {
+        ColumnOrder: number;
+    })[] | undefined;
+    loading: boolean;
+}
+/**
+ *
+ * Table handles display and caches it's own data.
+ *
+ */
+export default function TableHeader({ hasActions, columns, loading, }: Readonly<TableHeaderProps>): React.JSX.Element;
+export {};

package/dist/features/table/components/dashboard/table/table-input.d.ts

@@ -0,0 +1,11 @@
+import type { Column } from "@evenicanpm/portal-types-schemas";
+import React from "react";
+interface SearchProps {
+    searchTerm: string;
+    setSearchTerm: React.Dispatch<React.SetStateAction<string>>;
+    setColumn: React.Dispatch<React.SetStateAction<string>>;
+    selectedColumn: string;
+    searchCols: Column[];
+}
+declare const SearchField: React.MemoExoticComponent<({ searchTerm, setSearchTerm, searchCols, selectedColumn, setColumn, }: SearchProps) => React.JSX.Element>;
+export { SearchField };

package/dist/features/table/components/dashboard/table/table-row/action-button.d.ts

@@ -0,0 +1,8 @@
+import { Action } from "@evenicanpm/portal-types-schemas";
+interface ActionButtonProps {
+    docId: string;
+    action: Action;
+    resourceName: string;
+}
+export declare function ActionButton({ action, resourceName, docId, }: Readonly<ActionButtonProps>): import("react").JSX.Element;
+export {};

package/dist/features/table/components/dashboard/table/table-row/table-row.d.ts

@@ -0,0 +1,32 @@
+import type React from "react";
+import type * as Types from "../../../../types";
+import { Action } from "@evenicanpm/portal-types-schemas";
+/**
+ * This is what we transorm the column data into for convenient rendering.
+ */
+type ColumnLogic = {
+    id: string;
+    mask: string | undefined;
+    maskFn: any;
+    cellFn: ((value: string | number | string[]) => React.ReactElement<any, string | React.JSXElementConstructor<any>>) | ((value: string | number) => string | number);
+}[] | undefined;
+export type DocumentTableProps = {
+    /** The row to render */
+    row: Types.Queries.Row;
+    /** The render logic for each column ie data mask functions, cell maps*/
+    columnLogic: ColumnLogic;
+    /** */
+    handleClick: React.Dispatch<React.SetStateAction<string | number | null>>;
+    /** Actions renderer */
+    actions: Action[];
+    /** Does this view config have actions? */
+    /** The id field for the document (used for knowing what to set selected id to) */
+    idField: string;
+};
+/**
+ * A single row (document) in the table. Takes the pre-constructed column logic
+ * and executes all of the cell renders and data map functions. Also handles
+ * rendering the action icons.
+ */
+export default function DataTableRow({ row, columnLogic, handleClick: handleSelectDocument, actions, idField, }: Readonly<DocumentTableProps>): React.JSX.Element;
+export {};

package/dist/features/table/components/dashboard/table/table-row-skeleton.d.ts

@@ -0,0 +1,6 @@
+import type React from "react";
+export type TableRowSkeletonProps = {
+    pageSize: number;
+    colSpan: number;
+};
+export default function TableRowSkeleton({ pageSize, colSpan, }: Readonly<TableRowSkeletonProps>): React.JSX.Element;

package/dist/features/table/components/dashboard/table/table.d.ts

@@ -0,0 +1,18 @@
+import { type QueryKey } from "@tanstack/react-query";
+import type React from "react";
+import type * as Types from "../../../types";
+export type DocumentTableProps = {
+    resource: Types.Schemas.Resource;
+    pageSize: number;
+    setPageSize: React.Dispatch<React.SetStateAction<number>>;
+    viewConfigQuery: (resourceName: string) => {
+        queryKey: QueryKey;
+        queryFn: () => Promise<Types.Queries.TableConfig>;
+    };
+};
+/**
+ *
+ * Table handles display and caches it's own data.
+ *
+ */
+export default function DocumentTable({ resource, pageSize, setPageSize, viewConfigQuery, }: Readonly<DocumentTableProps>): React.JSX.Element;

package/dist/features/table/components/dashboard/table-dashboard.d.ts

@@ -0,0 +1,22 @@
+import type * as Types from "../../types";
+import { QueryKey } from "@tanstack/react-query";
+/**
+ * The main props for top-level table entry-point
+ *
+ *
+ */
+export interface TableProps {
+    viewConfigQuery: (resourceName: string) => {
+        queryKey: QueryKey;
+        queryFn: () => Promise<Types.Queries.TableConfig>;
+    };
+    resources: Types.Schemas.Resource[];
+}
+/**
+ *
+ * The TableDashboard is the main view component for the table feature.
+ * Holds state for the tabs and global pagination for all tables.
+ *
+ * @params props
+ */
+export declare const TableDashboard: ({ resources, viewConfigQuery }: TableProps) => import("react").JSX.Element;

package/{src/features/table/index.ts → dist/features/table/index.d.ts}

@@ -3,12 +3,6 @@
 
  * @packageDocumentation
  */
-
 export type { DocumentTableProps } from "./components/dashboard/table/table";
-export {
-	TableDashboard,
-	type TableProps,
-} from "./components/dashboard/table-dashboard";
-
-// SCHEMAS
+export { TableDashboard, type TableProps, } from "./components/dashboard/table-dashboard";
 export * as Table from "./types";

package/dist/features/table/logic/resolvers.d.ts

@@ -0,0 +1,21 @@
+import type { Column } from "@evenicanpm/portal-types-schemas";
+import type * as Types from "../types";
+/** MULTIMETHOD FOR FILTERS
+ * Allows multiple implementations
+ * based on multiple column properties.
+ * Priotizes column name, but also can
+ * use data type
+ * @internal
+ */
+export declare const resolveFilterUI: import("@arrows/multimethod/internal/types").Multimethod;
+/**
+ * Dispatch identifies which properties are
+ * in handler, then provides corresponding method
+ * @internal
+ */
+export declare const resolveDataMask: import("@arrows/multimethod/internal/types").Multimethod;
+/**
+ * Simpler, doesn't need multimethod cause only dispatches on column name
+ * @internal
+ */
+export declare const resolveCellUI: (col: Column, handlers: Types.Handlers.CellRenderMap) => ((value: string | number | string[]) => React.ReactElement) | ((value: string | number) => string | number);

package/dist/features/table/logic/transformers.d.ts

@@ -0,0 +1,35 @@
+import type { Column } from "@evenicanpm/portal-types-schemas";
+/**
+ * These are pure static functions that include business rules
+ * and data manipulation to get the data into the correct
+ * form for rendering.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Gets filters and returns an array of the
+ * active filters and corresponding options
+ * in FilterRequest
+ */
+export declare const getActiveFilters: (columns: Column[] | undefined) => ({
+    filterName: string;
+    filterOptions: {
+        value: string | number;
+        label: string;
+    }[];
+    filterType: string;
+} | undefined)[] | undefined;
+/**
+ * Filters and sorts visible cols
+ */
+export declare const getVisibleColumns: (columns: Column[] | undefined) => (Column & {
+    ColumnOrder: number;
+})[] | undefined;
+/**
+ *
+ */
+export declare const getVisibleDetails: (columns: Column[] | undefined) => Column[] | undefined;
+/**
+ * Filters and sorts visible cols
+ */
+export declare const getSearchableColumns: (columns: Column[] | undefined) => Column[] | undefined;

package/dist/features/table/logic/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * FILTER REQUEST to RESOLVER
+ */
+export interface FilterRequest {
+    filterName: string;
+    filterOptions: string[];
+    filterType: string;
+}

package/{src/features/table/types/handlers.ts → dist/features/table/types/handlers.d.ts}

@@ -1,15 +1,10 @@
 import type { FilterOption } from "@evenicanpm/portal-types-schemas";
-
 /**
  *
  * @group View Handlers
  */
 export type DataMaskMap = Record<string, MaskingFunction>;
-export type MaskingFunction = (
-	value: string | number,
-	dataMask: string,
-) => string;
-
+export type MaskingFunction = (value: string | number, dataMask: string) => string;
 /**
  * Uses column names as keys and maps out
  * value with specific JSX for specific column names.
@@ -20,19 +15,15 @@ export type MaskingFunction = (
  * @group View Handlers
  */
 export interface CellRenderMap {
-	[ColumnName: string]: (
-		value: string | number | string[],
-	) => React.ReactElement;
+    [ColumnName: string]: (value: string | number | string[]) => React.ReactElement;
 }
-
 export interface FilterProps {
-	filterName: string;
-	filterOptions: FilterOption[];
-	value: Record<string, string>;
-	setValue: React.Dispatch<React.SetStateAction<Record<string, string>>>;
-	resetPagination: () => void;
+    filterName: string;
+    filterOptions: FilterOption[];
+    value: Record<string, string>;
+    setValue: React.Dispatch<React.SetStateAction<Record<string, string>>>;
+    resetPagination: () => void;
 }
-
 /**
  *
  * Provides render methods for particular filter
@@ -45,27 +36,18 @@ export interface FilterProps {
  * @group View Handlers
  */
 export interface FilterRenderMap {
-	[ColumnName: string]: (props: FilterProps) => React.ReactElement;
+    [ColumnName: string]: (props: FilterProps) => React.ReactElement;
 }
-
 /**
  *
  * @group View Handlers
  */
 export interface EmptyStateProps {
-	label: string;
+    label: string;
 }
-
 export type NoResultsComponent = (props: EmptyStateProps) => React.ReactElement;
-
 export interface DetailsRenderMap {
-	[columnName: string]: (props: {
-		[columnName: string]:
-			| string
-			| number
-			| object
-			| string[]
-			| number[]
-			| object[];
-	}) => React.ReactNode;
+    [columnName: string]: (props: {
+        [columnName: string]: string | number | object | string[] | number[] | object[];
+    }) => React.ReactNode;
 }

package/{src/features/table/types/index.ts → dist/features/table/types/index.d.ts}

@@ -64,7 +64,6 @@
  *
  * @packageDocumentation
  */
-
 export * as Handlers from "./handlers";
 export * as Queries from "./queries";
 export * as Schemas from "./schemas";

package/{src/features/table/types/queries.ts → dist/features/table/types/queries.d.ts}

@@ -1,31 +1,24 @@
 import type { ViewConfig } from "@evenicanpm/portal-types-schemas";
-
 /**
  *
  * These are data types returned from API Backend
  *
  */
-
 /**
  *
  * A single row in the data table response object.
  *
  */
-export type Row = Record<
-	string,
-	string | number | string[] | Record<string, string>[] | unknown
->;
-
+export type Row = Record<string, string | number | string[] | Record<string, string>[] | unknown>;
 /**
  *
  * The response type defined in TDD for row data.
  *
  */
 export interface TableRows {
-	items: number;
-	data: Row[];
+    items: number;
+    data: Row[];
 }
-
 /**
  *
  * Response type of data from table config

package/dist/features/table/types/schemas.d.ts

@@ -0,0 +1,31 @@
+import type { TableViewParams } from "@evenicanpm/portal-types-schemas";
+import type { CellRenderMap, DataMaskMap, DetailsRenderMap, FilterRenderMap, NoResultsComponent } from "./handlers";
+import type { TableRows } from "./queries";
+/**
+ * These are primary domain models and the source of truth for table system.
+ */
+/**
+ * Status maps
+ */
+export type StatusTextMap = Record<number | string, string>;
+export type StatusColor = "success" | "primary" | "warning" | "error";
+export type StatusColorMap = Record<number | string, StatusColor>;
+/**
+ * Resource Definition
+ */
+export interface Resource {
+    name: string;
+    label: string;
+    idField: string;
+    rowsQueryFn: (displaySettings: TableViewParams) => {
+        queryKey: readonly unknown[];
+        queryFn: () => Promise<TableRows>;
+    };
+    cellRenderMap?: CellRenderMap;
+    dataMaskMap?: DataMaskMap;
+    filterRenderMap?: FilterRenderMap;
+    noResultsComponent?: NoResultsComponent;
+    detailsRenderMap?: DetailsRenderMap;
+    statusTextMap: StatusTextMap;
+    statusColorMap: StatusColorMap;
+}

package/{src/index.ts → dist/index.d.ts}

@@ -58,8 +58,6 @@
  * ```
  * @module e4 Portal
  */
-
 export type { Session } from "./auth/auth-context";
 export { Portal, type PortalProps } from "./portal";
-
 export { Table } from "./features/table";

package/dist/portal.d.ts

@@ -0,0 +1,38 @@
+import type { PropsWithChildren } from "react";
+import { type AuthProviderProps } from "./auth/auth-context";
+/**
+ * Main Entry point properties into portal package
+ *
+ *
+ */
+interface PortalProps extends AuthProviderProps {
+}
+/**
+ * The main **e4Portal** entry point.
+ * * This is a React Functional Component that provides the core context
+ * and layout for the application. It is required to wrap all components
+ * that use the library's hooks or sub-components.
+ *
+ *
+ * @param props - The properties passed to the Portal component.
+ * @returns A React Element rendering the main application structure.
+ */
+declare const Portal: {
+    ({ session, logout, children, }: PropsWithChildren<PortalProps>): import("react").JSX.Element;
+    /**
+     *
+     * # Feature: Table
+     * This is the table feature component.
+     * @params props
+     *
+     */
+    Table: ({ resources, viewConfigQuery }: import("./features/table/components/dashboard/table-dashboard").TableProps) => import("react").JSX.Element;
+};
+/**
+ *
+ * # Feature: Settings
+ * This is the table feature component.
+ * @params props
+ *
+ */
+export { Portal, type PortalProps };