phx-react 1.3.1833 → 1.3.1836

package/dist/esm/components/TableSchedule/renderers.js

@@ -0,0 +1,129 @@
+'use client';
+import React from 'react';
+import { CELL_BOX_BASE_CLASSNAME, CELL_BOX_VARIANT_CLASSNAME, DEFAULT_TOOLTIP_CLASSNAME, ROW_HEADER_ALIGN_CLASSNAME, ROW_HEADER_CONTENT_CLASSNAME, ROW_HEADER_DESCRIPTION_CLASSNAME, ROW_HEADER_TITLE_CLASSNAME, SCHEDULE_CELL_CLASSNAME, SCHEDULE_EMPTY_DESCRIPTION_CLASSNAME, SCHEDULE_EMPTY_TITLE_CLASSNAME, SCHEDULE_SECTION_CLASSNAME, SCHEDULE_SECTION_LABEL_CLASSNAME, SCHEDULE_SECTION_VALUE_CLASSNAME, SCHEDULE_TITLE_CLASSNAME, SCHEDULE_TITLE_DOTTED_CLASSNAME, TOOLTIP_CONTENT_CLASSNAME, TOOLTIP_LABEL_CLASSNAME, TOOLTIP_SECTION_CLASSNAME, TOOLTIP_TITLE_CLASSNAME, TOOLTIP_VALUE_CLASSNAME, } from './constants';
+/**
+ * Checks whether a render value is a structured person-link object.
+ *
+ * @param {ReactNode | GridPersonLink} value The render value to inspect.
+ * @returns {value is GridPersonLink} True when the value matches the person-link contract.
+ */
+const isGridPersonLink = (value) => !!value && typeof value === 'object' && 'type' in value && value.type === 'person-link';
+/**
+ * Renders a person-link value as an external profile anchor when a destination URL exists.
+ *
+ * @param {GridPersonLink} person The person-link payload to render.
+ * @param {string} [userDetailPageUrl] The base URL used to build the person detail link.
+ * @returns {React.ReactNode} The rendered link node, or null when the person has no display name.
+ */
+const renderGridPersonLink = (person, userDetailPageUrl) => {
+    if (!person.name)
+        return null;
+    return (React.createElement("a", { className: 'group inline-flex items-center gap-1 whitespace-nowrap font-semibold text-gray-800 hover:text-blue-500', href: userDetailPageUrl && person.id ? `${userDetailPageUrl}${person.id}` : undefined, rel: 'noopener noreferrer', target: '_blank' },
+        React.createElement("span", null,
+            person.name,
+            person.code ? ` (${person.code})` : ''),
+        person.id && userDetailPageUrl && person.icon));
+};
+/**
+ * Renders a tooltip or schedule value that may contain raw nodes, a person link, or a list of person links.
+ *
+ * @param {ReactNode | GridPersonLink | GridPersonLink[]} value The value payload to render.
+ * @param {string} [userDetailPageUrl] The base URL used to build person detail links.
+ * @returns {React.ReactNode} The rendered value node.
+ */
+const renderRichValue = (value, userDetailPageUrl) => {
+    if (Array.isArray(value)) {
+        return (React.createElement("div", { className: 'flex flex-col gap-1' }, value.map((item, index) => (React.createElement("div", { key: index }, isGridPersonLink(item) ? renderGridPersonLink(item, userDetailPageUrl) : item)))));
+    }
+    return isGridPersonLink(value) ? renderGridPersonLink(value, userDetailPageUrl) : value;
+};
+/**
+ * Renders the content displayed inside a sticky row-header cell.
+ *
+ * @param {GridRowHeader} header The row-header configuration object.
+ * @returns {React.ReactNode} The rendered header content, or null when nothing is configured.
+ */
+export const renderRowHeaderContent = (header) => {
+    if (header.content)
+        return header.content;
+    if (!header.headerContent)
+        return null;
+    const { title, description, align = 'left' } = header.headerContent;
+    return (React.createElement("div", { className: `${ROW_HEADER_CONTENT_CLASSNAME} ${ROW_HEADER_ALIGN_CLASSNAME[align]}` },
+        React.createElement("div", { className: ROW_HEADER_TITLE_CLASSNAME }, title),
+        description && React.createElement("div", { className: ROW_HEADER_DESCRIPTION_CLASSNAME }, description)));
+};
+/**
+ * Renders the boxed visual treatment used by default-layout schedule cells.
+ *
+ * @param {GridCellData} cell The cell data to render.
+ * @returns {React.ReactNode} The boxed content node for the cell.
+ */
+export const renderCellBoxContent = (cell) => {
+    var _a, _b;
+    return (React.createElement("div", { className: `${CELL_BOX_BASE_CLASSNAME} ${CELL_BOX_VARIANT_CLASSNAME[(_a = cell.variant) !== null && _a !== void 0 ? _a : 'default']}` },
+        React.createElement("span", { className: 'block w-full overflow-hidden text-ellipsis whitespace-nowrap' }, (_b = cell.content) !== null && _b !== void 0 ? _b : ' ')));
+};
+/**
+ * Renders the rich schedule layout used by plain schedule cells.
+ *
+ * @param {GridScheduleContent} scheduleContent The structured schedule content to render.
+ * @param {string} [userDetailPageUrl] The base URL used to build person detail links.
+ * @returns {React.ReactNode} The rendered schedule content.
+ */
+export const renderScheduleContent = (scheduleContent, userDetailPageUrl) => {
+    const { title, titleVariant = 'default', sections = [], emptyTitle = 'Trống', emptyDescription = 'Chưa xếp', } = scheduleContent;
+    if (!title && sections.length === 0) {
+        return (React.createElement("div", { className: SCHEDULE_CELL_CLASSNAME },
+            React.createElement("div", { className: SCHEDULE_EMPTY_TITLE_CLASSNAME }, emptyTitle),
+            React.createElement("div", { className: SCHEDULE_EMPTY_DESCRIPTION_CLASSNAME }, emptyDescription)));
+    }
+    return (React.createElement("div", { className: SCHEDULE_CELL_CLASSNAME },
+        title && (React.createElement("div", { className: titleVariant === 'dotted' ? SCHEDULE_TITLE_DOTTED_CLASSNAME : SCHEDULE_TITLE_CLASSNAME }, title)),
+        sections.map((section, sectionIndex) => (React.createElement("div", { key: sectionIndex, className: SCHEDULE_SECTION_CLASSNAME },
+            section.label && (React.createElement("div", { className: SCHEDULE_SECTION_LABEL_CLASSNAME },
+                section.labelPrefix,
+                React.createElement("span", null, section.label))),
+            section.items.map((item, itemIndex) => (React.createElement("div", { key: itemIndex, className: SCHEDULE_SECTION_VALUE_CLASSNAME }, isGridPersonLink(item) ? renderGridPersonLink(item, userDetailPageUrl) : item))))))));
+};
+/**
+ * Renders the grouped tooltip sections for a cell.
+ *
+ * @param {GridTooltipBlock[]} blocks The tooltip blocks to render.
+ * @param {string} [userDetailPageUrl] The base URL used to build person detail links.
+ * @returns {React.ReactNode} The rendered tooltip block list.
+ */
+const renderTooltipBlocks = (blocks, userDetailPageUrl) => (React.createElement("ul", { className: 'text-left' }, blocks.map((block, index) => {
+    var _a;
+    return (React.createElement("li", { key: index, className: index === 0 ? 'list-none' : 'mt-3 list-none border-t border-gray-200 pt-3' },
+        React.createElement("div", { className: TOOLTIP_CONTENT_CLASSNAME },
+            block.title && React.createElement("div", { className: TOOLTIP_TITLE_CLASSNAME }, block.title), (_a = block.sections) === null || _a === void 0 ? void 0 :
+            _a.map((section, sectionIndex) => (React.createElement("div", { key: sectionIndex, className: TOOLTIP_SECTION_CLASSNAME },
+                React.createElement("span", { className: `${TOOLTIP_LABEL_CLASSNAME} inline-flex items-center gap-1.5` },
+                    section.labelPrefix,
+                    React.createElement("span", null, section.label)),
+                React.createElement("span", { className: TOOLTIP_VALUE_CLASSNAME }, renderRichValue(section.value, userDetailPageUrl))))))));
+})));
+/**
+ * Resolves and renders the tooltip content for a data cell.
+ *
+ * @param {GridCellData} cell The cell whose tooltip content should be rendered.
+ * @param {string} [userDetailPageUrl] The base URL used to build person detail links.
+ * @returns {React.ReactNode} The tooltip content, or null when the cell has no tooltip payload.
+ */
+export const renderTooltipContent = (cell, userDetailPageUrl) => {
+    if (cell.tooltip)
+        return cell.tooltip;
+    if (cell.tooltipBlocks && cell.tooltipBlocks.length > 0) {
+        return renderTooltipBlocks(cell.tooltipBlocks, userDetailPageUrl);
+    }
+    return null;
+};
+/**
+ * Resolves the tooltip container class name for a cell.
+ *
+ * @param {GridCellData} cell The cell that may override the tooltip class.
+ * @returns {string} The tooltip class name to apply.
+ */
+export const resolveTooltipClassName = (cell) => { var _a; return (_a = cell.tooltipClassName) !== null && _a !== void 0 ? _a : DEFAULT_TOOLTIP_CLASSNAME; };
+//# sourceMappingURL=renderers.js.map

package/dist/esm/components/TableSchedule/renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers.js","sourceRoot":"","sources":["../../../../src/components/TableSchedule/renderers.tsx"],"names":[],"mappings":"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"}

package/dist/esm/components/TableSchedule/types.d.ts

@@ -0,0 +1,112 @@
+import { ComponentType, CSSProperties, ReactNode } from 'react';
+export type GridCellVariant = 'default' | 'moving' | 'trogiang' | 'empty';
+export type GridPersonLink = {
+    type: 'person-link';
+    id?: number | string | null;
+    name?: ReactNode;
+    code?: ReactNode;
+    icon?: ReactNode;
+};
+export type GridTooltipSection = {
+    label: ReactNode;
+    labelPrefix?: ReactNode;
+    value: ReactNode | GridPersonLink | GridPersonLink[];
+};
+export type GridTooltipBlock = {
+    title?: ReactNode;
+    sections?: GridTooltipSection[];
+};
+export type GridCellLayout = 'boxed' | 'plain';
+export type GridScheduleTitleVariant = 'default' | 'dotted';
+export type GridRowHeaderAlign = 'left' | 'center' | 'right';
+export type GridScheduleSection = {
+    label?: ReactNode;
+    labelPrefix?: ReactNode;
+    items: Array<ReactNode | GridPersonLink>;
+};
+export type GridScheduleContent = {
+    title?: ReactNode;
+    titleVariant?: GridScheduleTitleVariant;
+    sections?: GridScheduleSection[];
+    emptyTitle?: ReactNode;
+    emptyDescription?: ReactNode;
+};
+export type GridCellData = {
+    content?: ReactNode;
+    variant?: GridCellVariant;
+    layout?: GridCellLayout;
+    scheduleContent?: GridScheduleContent;
+    tooltipBlocks?: GridTooltipBlock[];
+    tooltip?: ReactNode;
+    tooltipClassName?: string;
+    cellStyle?: CSSProperties;
+    cellClassName?: string;
+    colSpan?: number;
+    rowSpan?: number;
+    disabled?: boolean;
+    data?: unknown;
+};
+export type GridRowHeaderContent = {
+    title: ReactNode;
+    description?: ReactNode;
+    align?: GridRowHeaderAlign;
+};
+export type GridRowHeader = {
+    content?: ReactNode;
+    headerContent?: GridRowHeaderContent;
+    rowSpan?: number;
+    width?: number;
+    className?: string;
+    style?: CSSProperties;
+};
+export type GridColumnAlign = 'left' | 'center' | 'right';
+export type GridColumn = {
+    key: string;
+    header: ReactNode;
+    minWidth?: number;
+    align?: GridColumnAlign;
+};
+export type GridHeaderGroup = {
+    header: ReactNode;
+    columnKeys: string[];
+};
+export type TooltipComponentType = ComponentType<{
+    content: ReactNode;
+    contentClassName?: string;
+    children: ReactNode;
+}>;
+export type ButtonComponentType = ComponentType<{
+    tertiary?: boolean;
+    noPadding?: boolean;
+    className?: string;
+    onClick?: () => void;
+    children?: ReactNode;
+}>;
+export type ScheduleTableRow = {
+    rowHeader?: GridRowHeader;
+    rowHeaders?: Array<GridRowHeader | null>;
+    cells: Record<string, GridCellData>;
+};
+export type GridLegendItem = {
+    label: ReactNode;
+    variant?: GridCellVariant;
+    indicatorClassName?: string;
+};
+export type PHXScheduleTableProps = {
+    columns: GridColumn[];
+    headerGroups?: GridHeaderGroup[];
+    rows: ScheduleTableRow[];
+    onCellClick?: (params: {
+        rowIndex: number;
+        columnKey: string;
+        cellData: GridCellData;
+    }) => void;
+    stickyColumnWidth?: number;
+    stickyColumnWidths?: number[];
+    defaultCellLayout?: GridCellLayout;
+    legendItems?: GridLegendItem[];
+    userDetailPageUrl?: string;
+    className?: string;
+    TooltipComponent?: TooltipComponentType;
+    ButtonComponent?: ButtonComponentType;
+};

package/dist/esm/components/TableSchedule/types.js

@@ -0,0 +1,3 @@
+'use client';
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/components/TableSchedule/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/TableSchedule/types.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA"}

package/dist/esm/components/TableSchedule/utils.d.ts

@@ -0,0 +1,160 @@
+import { CSSProperties } from 'react';
+import { GridCellData, GridColumn, GridColumnAlign, GridCellLayout, GridRowHeader, PHXScheduleTableProps, ScheduleTableRow } from './types';
+type RowHeaderCellStyleParams = {
+    headerIndex: number;
+    stickyWidths: number[];
+    width: number;
+    isLast: boolean;
+    customStyle?: CSSProperties;
+};
+/**
+ * Builds a lookup of covered cell coordinates created by rowSpan and colSpan values.
+ *
+ * @param {PHXScheduleTableProps['rows']} rows The schedule rows to analyze.
+ * @param {GridColumn[]} columns The column definitions in render order.
+ * @returns {Set<string>} A set of `rowIndex,columnKey` pairs that should be skipped during rendering.
+ */
+export declare const buildSkipMap: (rows: PHXScheduleTableProps["rows"], columns: GridColumn[]) => Set<string>;
+/**
+ * Resolves the effective alignment for a column, defaulting to left alignment.
+ *
+ * @param {GridColumnAlign} [align] The optional alignment configured for the column.
+ * @returns {GridColumnAlign} The resolved column alignment.
+ */
+export declare const getColumnAlign: (align?: GridColumnAlign) => GridColumnAlign;
+/**
+ * Returns the row-header cells that should be rendered for a schedule row.
+ *
+ * @param {ScheduleTableRow} row The schedule row to inspect.
+ * @param {number} stickyColumnWidth The fallback width for single rowHeader entries.
+ * @returns {Array<GridRowHeader | null>} The normalized row-header list for the row.
+ */
+export declare const getRowHeaders: (row: ScheduleTableRow, stickyColumnWidth: number) => Array<GridRowHeader | null>;
+/**
+ * Builds the sticky-column width list used for row headers.
+ *
+ * @param {ScheduleTableRow[]} rows The table rows used to infer sticky header widths.
+ * @param {number} stickyColumnWidth The default width used when no explicit width exists.
+ * @param {number[]} [stickyColumnWidths] Optional explicit sticky widths from the caller.
+ * @returns {number[]} The resolved sticky-column widths.
+ */
+export declare const buildStickyColumnWidths: (rows: ScheduleTableRow[], stickyColumnWidth: number, stickyColumnWidths?: number[]) => number[];
+/**
+ * Calculates the left offset of a sticky column from the widths before it.
+ *
+ * @param {number[]} stickyWidths The ordered list of sticky column widths.
+ * @param {number} index The sticky column index to position.
+ * @returns {number} The computed left offset in pixels.
+ */
+export declare const getStickyLeft: (stickyWidths: number[], index: number) => number;
+/**
+ * Normalizes a cell's row and column spans.
+ *
+ * @param {GridCellData} cell The cell data to inspect.
+ * @returns {{ colSpan: number; rowSpan: number }} The resolved span values with defaults applied.
+ */
+export declare const getCellSpan: (cell: GridCellData) => {
+    colSpan: number;
+    rowSpan: number;
+};
+/**
+ * Composes the class name for a sticky header placeholder cell.
+ *
+ * @param {number} index The sticky column index being rendered.
+ * @param {number} stickyHeaderCount The total number of sticky columns.
+ * @param {boolean} showStickyShadow Whether the sticky shadow should be visible.
+ * @returns {string} The class name applied to the sticky header cell.
+ */
+export declare const getStickyHeaderClassName: (index: number, stickyHeaderCount: number, showStickyShadow: boolean) => string;
+/**
+ * Builds the inline style for a sticky header placeholder cell.
+ *
+ * @param {{
+ *   index: number;
+ *   stickyWidths: number[];
+ *   zIndexBase: number;
+ * }} {
+ *   index,
+ *   stickyWidths,
+ *   zIndexBase,
+ * } The sticky header positioning inputs.
+ * @returns {CSSProperties} The computed sticky header styles.
+ */
+export declare const buildStickyHeaderCellStyle: ({ index, stickyWidths, zIndexBase, }: {
+    index: number;
+    stickyWidths: number[];
+    zIndexBase: number;
+}) => CSSProperties;
+/**
+ * Builds the shared style for grouped header cells.
+ *
+ * @returns {CSSProperties} The computed grouped-header styles.
+ */
+export declare const buildHeaderGroupCellStyle: () => CSSProperties;
+/**
+ * Builds the inline style for a regular column header cell.
+ *
+ * @param {GridColumnAlign} align The text alignment for the column header.
+ * @param {number} [minWidth] The optional minimum width of the column.
+ * @returns {CSSProperties} The computed column-header styles.
+ */
+export declare const buildColumnHeaderCellStyle: (align: GridColumnAlign, minWidth?: number) => CSSProperties;
+/**
+ * Composes the class name for a sticky row-header cell.
+ *
+ * @param {string | undefined} className An optional custom class from the row header definition.
+ * @param {number} headerIndex The sticky header index being rendered.
+ * @param {number} stickyHeaderCount The total number of sticky columns.
+ * @param {boolean} showStickyShadow Whether the sticky shadow should be visible.
+ * @returns {string | undefined} The resolved class name for the row-header cell.
+ */
+export declare const getRowHeaderClassName: (className: string | undefined, headerIndex: number, stickyHeaderCount: number, showStickyShadow: boolean) => string | undefined;
+/**
+ * Builds the inline style for a sticky row-header cell.
+ *
+ * @param {RowHeaderCellStyleParams} params - The row-header positioning and style inputs.
+ * @param {number} params.headerIndex - The zero-based index of this sticky header column.
+ * @param {number[]} params.stickyWidths - The ordered list of sticky column widths used to compute the left offset.
+ * @param {number} params.width - The explicit width applied to this header cell.
+ * @param {boolean} params.isLast - Whether this cell belongs to the last rendered row.
+ * @param {CSSProperties} [params.customStyle] - Optional style overrides merged on top of the base styles.
+ * @returns {CSSProperties} The computed sticky row-header styles.
+ *
+ * @example
+ * buildRowHeaderCellStyle({ headerIndex: 0, stickyWidths: [130], width: 130, isLast: false })
+ * // => { position: 'sticky', left: 0, width: 130, zIndex: 3, ... }
+ */
+export declare const buildRowHeaderCellStyle: ({ headerIndex, stickyWidths, width, isLast, customStyle, }: RowHeaderCellStyleParams) => CSSProperties;
+/**
+ * Composes the class name for an interactive cell wrapper.
+ *
+ * @param {GridCellLayout} layout The layout mode applied to the cell.
+ * @param {string} alignClassName The wrapper alignment class.
+ * @param {boolean} [useButtonStyles=false] Whether button-specific classes should be used.
+ * @returns {string} The class name for the interactive cell wrapper.
+ */
+export declare const getClickableCellClassName: (layout: GridCellLayout, alignClassName: string, useButtonStyles?: boolean) => string;
+/**
+ * Composes the class name for a non-clickable cell wrapper.
+ *
+ * @param {GridCellLayout} layout The layout mode applied to the cell.
+ * @param {string} alignClassName The wrapper alignment class.
+ * @returns {string} The class name for the static cell wrapper.
+ */
+export declare const getStaticCellClassName: (layout: GridCellLayout, alignClassName: string) => string;
+/**
+ * Builds the inline style for a body data cell.
+ *
+ * @param {boolean} isLast Whether the cell belongs to the last rendered row.
+ * @param {CSSProperties} [cellStyle] Optional custom style overrides from the cell data.
+ * @returns {CSSProperties} The computed data-cell styles.
+ */
+export declare const buildDataCellStyle: (isLast: boolean, cellStyle?: CSSProperties) => CSSProperties;
+/**
+ * Composes the class name for a body data cell.
+ *
+ * @param {string} [cellClassName] An optional custom class from the cell data.
+ * @returns {string} The class name applied to the data cell.
+ */
+export declare const getDataCellClassName: (cellClassName?: string) => string;
+export {};