phx-react 1.3.1832 → 1.3.1835

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

@@ -0,0 +1,33 @@
+'use client';
+import { useEffect, useState } from 'react';
+/**
+ * Tracks whether the sticky-header shadow should be visible based on horizontal scroll.
+ *
+ * @param {UseStickyShadowParams} params Dependencies required to recalculate shadow visibility.
+ * @returns {boolean} True when the table has been horizontally scrolled.
+ */
+export const useStickyShadow = ({ scrollContainerRef, columnsLength, rowsLength, stickyHeaderCount, }) => {
+    const [showStickyShadow, setShowStickyShadow] = useState(false);
+    useEffect(() => {
+        const container = scrollContainerRef.current;
+        if (!container)
+            return;
+        /**
+         * Synchronizes the sticky shadow state with the container's horizontal scroll position.
+         *
+         * @returns {void}
+         */
+        const updateStickyShadow = () => {
+            setShowStickyShadow(container.scrollLeft > 0);
+        };
+        updateStickyShadow();
+        container.addEventListener('scroll', updateStickyShadow, { passive: true });
+        window.addEventListener('resize', updateStickyShadow);
+        return () => {
+            container.removeEventListener('scroll', updateStickyShadow);
+            window.removeEventListener('resize', updateStickyShadow);
+        };
+    }, [columnsLength, rowsLength, stickyHeaderCount, scrollContainerRef]);
+    return showStickyShadow;
+};
+//# sourceMappingURL=useStickyShadow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useStickyShadow.js","sourceRoot":"","sources":["../../../../../src/components/TableSchedule/components/useStickyShadow.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAGZ,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAS3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAC9B,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,iBAAiB,GACK,EAAE,EAAE;IAC1B,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAE/D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAA;QAC5C,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB;;;;WAIG;QACH,MAAM,kBAAkB,GAAG,GAAG,EAAE;YAC9B,mBAAmB,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAA;QAC/C,CAAC,CAAA;QAED,kBAAkB,EAAE,CAAA;QACpB,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3E,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAA;QAErD,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAA;YAC3D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAA;QAC1D,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAEtE,OAAO,gBAAgB,CAAA;AACzB,CAAC,CAAA"}

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

@@ -0,0 +1,49 @@
+import { CSSProperties } from 'react';
+import { GridCellVariant, GridColumnAlign, GridRowHeaderAlign } from './types';
+export declare const BORDER = "0.5px solid var(--color-border-tertiary, #e5e7eb)";
+export declare const stickyBase: CSSProperties;
+export declare const thBase: CSSProperties;
+export declare const HEADER_TH_CLASSNAME = "whitespace-nowrap bg-white px-3 py-2 text-xs font-semibold text-gray-900";
+export declare const STICKY_SHADOW_CLASSNAME = "drop-shadow-[4px_0_4px_rgba(0,0,0,0.1)]";
+export declare const LEGEND_WRAPPER_CLASSNAME = "mb-3 flex w-fit items-center gap-2 rounded-lg bg-white p-2";
+export declare const LEGEND_ITEM_CLASSNAME = "ml-2 flex items-center gap-1";
+export declare const LEGEND_LAST_ITEM_CLASSNAME = "ml-2 mr-2 flex items-center gap-1";
+export declare const LEGEND_LABEL_CLASSNAME = "text-xs font-normal text-gray-900";
+export declare const TABLE_SCROLL_CONTAINER_CLASSNAME = "overflow-x-auto rounded-lg bg-white";
+export declare const TABLE_CLASSNAME = "w-full border-collapse";
+export declare const TABLE_SCROLL_CONTAINER_STYLE: CSSProperties;
+export declare const TABLE_STYLE: CSSProperties;
+export declare const ROW_HEADER_CONTENT_CLASSNAME = "flex flex-col";
+export declare const ROW_HEADER_ALIGN_CLASSNAME: Record<GridRowHeaderAlign, string>;
+export declare const ROW_HEADER_TITLE_CLASSNAME = "text-xs font-semibold text-gray-900";
+export declare const ROW_HEADER_DESCRIPTION_CLASSNAME = "text-xs text-gray-600";
+export declare const CELL_BOX_BASE_CLASSNAME = "flex h-[30px] w-[176px] items-center overflow-hidden rounded-lg border-[0.5px] px-2.5 text-left text-xs font-normal shadow-sm";
+export declare const CELL_BOX_VARIANT_CLASSNAME: Record<GridCellVariant, string>;
+export declare const LEGEND_INDICATOR_CLASSNAME: Record<GridCellVariant, string>;
+export declare const CELL_WRAPPER_ALIGN_CLASSNAME: Record<GridColumnAlign, string>;
+/**
+ * Returns the wrapper alignment class for a cell based on the column alignment.
+ *
+ * @param {GridColumnAlign} align The alignment configured for the column.
+ * @returns {string} The Tailwind class used to align the cell wrapper content.
+ */
+export declare const getCellWrapperAlignClassName: (align: GridColumnAlign) => string;
+export declare const TOOLTIP_CONTENT_CLASSNAME = "flex max-w-[320px] flex-col gap-2 text-left";
+export declare const TOOLTIP_TITLE_CLASSNAME = "text-xs font-semibold leading-5 text-gray-800";
+export declare const TOOLTIP_SECTION_CLASSNAME = "flex flex-col gap-0.5";
+export declare const TOOLTIP_LABEL_CLASSNAME = "text-xs leading-5 text-gray-500";
+export declare const TOOLTIP_VALUE_CLASSNAME = "text-xs font-semibold leading-5 text-gray-800";
+export declare const DEFAULT_TOOLTIP_CLASSNAME = "w-fit !px-5 !py-4";
+export declare const SCHEDULE_CELL_CLASSNAME = "flex flex-col gap-2 text-left";
+export declare const SCHEDULE_TITLE_CLASSNAME = "text-sm font-semibold leading-5 text-gray-800";
+export declare const SCHEDULE_TITLE_DOTTED_CLASSNAME = "inline-block w-fit border-b-2 border-dotted border-gray-300 text-sm font-semibold leading-5 text-gray-800";
+export declare const SCHEDULE_SECTION_CLASSNAME = "flex flex-col gap-1";
+export declare const SCHEDULE_SECTION_LABEL_CLASSNAME = "flex items-center gap-1.5 text-xs font-normal leading-5 text-gray-500";
+export declare const SCHEDULE_SECTION_VALUE_CLASSNAME = "text-sm font-semibold leading-5 text-gray-800";
+export declare const SCHEDULE_EMPTY_TITLE_CLASSNAME = "text-sm font-semibold leading-5 text-gray-800";
+export declare const SCHEDULE_EMPTY_DESCRIPTION_CLASSNAME = "text-xs font-normal leading-5 text-gray-500";
+export declare const BOXED_CELL_PADDING_CLASSNAME = "px-1 py-1";
+export declare const PLAIN_CELL_PADDING_CLASSNAME = "px-2 py-1.5";
+export declare const BUTTON_BASE_CLASSNAME = "!shadow-none !flex !w-full !rounded-none !text-left";
+export declare const CELL_CONTENT_BASE_CLASSNAME = "flex w-full text-left";
+export declare const DATA_CELL_BASE_CLASSNAME = "align-middle border-l p-0";

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

@@ -0,0 +1,81 @@
+'use client';
+export const BORDER = '0.5px solid var(--color-border-tertiary, #e5e7eb)';
+export const stickyBase = {
+    position: 'sticky',
+    left: 0,
+    zIndex: 2,
+    background: 'var(--color-background-primary, #fff)',
+    borderRight: BORDER,
+};
+export const thBase = {
+    borderBottom: BORDER,
+    textAlign: 'center',
+};
+export const HEADER_TH_CLASSNAME = 'whitespace-nowrap bg-white px-3 py-2 text-xs font-semibold text-gray-900';
+export const STICKY_SHADOW_CLASSNAME = 'drop-shadow-[4px_0_4px_rgba(0,0,0,0.1)]';
+export const LEGEND_WRAPPER_CLASSNAME = 'mb-3 flex w-fit items-center gap-2 rounded-lg bg-white p-2';
+export const LEGEND_ITEM_CLASSNAME = 'ml-2 flex items-center gap-1';
+export const LEGEND_LAST_ITEM_CLASSNAME = 'ml-2 mr-2 flex items-center gap-1';
+export const LEGEND_LABEL_CLASSNAME = 'text-xs font-normal text-gray-900';
+export const TABLE_SCROLL_CONTAINER_CLASSNAME = 'overflow-x-auto rounded-lg bg-white';
+export const TABLE_CLASSNAME = 'w-full border-collapse';
+export const TABLE_SCROLL_CONTAINER_STYLE = {
+    border: BORDER,
+};
+export const TABLE_STYLE = {
+    width: '100%',
+    borderCollapse: 'collapse',
+};
+export const ROW_HEADER_CONTENT_CLASSNAME = 'flex flex-col';
+export const ROW_HEADER_ALIGN_CLASSNAME = {
+    left: 'items-start text-left',
+    center: 'items-center text-center',
+    right: 'items-end text-right',
+};
+export const ROW_HEADER_TITLE_CLASSNAME = 'text-xs font-semibold text-gray-900';
+export const ROW_HEADER_DESCRIPTION_CLASSNAME = 'text-xs text-gray-600';
+export const CELL_BOX_BASE_CLASSNAME = 'flex h-[30px] w-[176px] items-center overflow-hidden rounded-lg border-[0.5px] px-2.5 text-left text-xs font-normal shadow-sm';
+export const CELL_BOX_VARIANT_CLASSNAME = {
+    default: 'border-gray-500 bg-white text-gray-900',
+    moving: 'border-gray-500 bg-[#FFD6A4] text-gray-900',
+    trogiang: 'border-[#00527C] bg-[#E0F0FF] text-[#00527C]',
+    empty: 'border-gray-500 bg-white text-gray-900',
+};
+export const LEGEND_INDICATOR_CLASSNAME = {
+    default: '',
+    moving: 'bg-[#FFD6A4]',
+    trogiang: 'border-[#00527C] bg-[#E0F0FF]',
+    empty: '',
+};
+export const CELL_WRAPPER_ALIGN_CLASSNAME = {
+    left: 'justify-start',
+    center: 'justify-center',
+    right: 'justify-end',
+};
+/**
+ * Returns the wrapper alignment class for a cell based on the column alignment.
+ *
+ * @param {GridColumnAlign} align The alignment configured for the column.
+ * @returns {string} The Tailwind class used to align the cell wrapper content.
+ */
+export const getCellWrapperAlignClassName = (align) => CELL_WRAPPER_ALIGN_CLASSNAME[align];
+export const TOOLTIP_CONTENT_CLASSNAME = 'flex max-w-[320px] flex-col gap-2 text-left';
+export const TOOLTIP_TITLE_CLASSNAME = 'text-xs font-semibold leading-5 text-gray-800';
+export const TOOLTIP_SECTION_CLASSNAME = 'flex flex-col gap-0.5';
+export const TOOLTIP_LABEL_CLASSNAME = 'text-xs leading-5 text-gray-500';
+export const TOOLTIP_VALUE_CLASSNAME = 'text-xs font-semibold leading-5 text-gray-800';
+export const DEFAULT_TOOLTIP_CLASSNAME = 'w-fit !px-5 !py-4';
+export const SCHEDULE_CELL_CLASSNAME = 'flex flex-col gap-2 text-left';
+export const SCHEDULE_TITLE_CLASSNAME = 'text-sm font-semibold leading-5 text-gray-800';
+export const SCHEDULE_TITLE_DOTTED_CLASSNAME = 'inline-block w-fit border-b-2 border-dotted border-gray-300 text-sm font-semibold leading-5 text-gray-800';
+export const SCHEDULE_SECTION_CLASSNAME = 'flex flex-col gap-1';
+export const SCHEDULE_SECTION_LABEL_CLASSNAME = 'flex items-center gap-1.5 text-xs font-normal leading-5 text-gray-500';
+export const SCHEDULE_SECTION_VALUE_CLASSNAME = 'text-sm font-semibold leading-5 text-gray-800';
+export const SCHEDULE_EMPTY_TITLE_CLASSNAME = 'text-sm font-semibold leading-5 text-gray-800';
+export const SCHEDULE_EMPTY_DESCRIPTION_CLASSNAME = 'text-xs font-normal leading-5 text-gray-500';
+export const BOXED_CELL_PADDING_CLASSNAME = 'px-1 py-1';
+export const PLAIN_CELL_PADDING_CLASSNAME = 'px-2 py-1.5';
+export const BUTTON_BASE_CLASSNAME = '!shadow-none !flex !w-full !rounded-none !text-left';
+export const CELL_CONTENT_BASE_CLASSNAME = 'flex w-full text-left';
+export const DATA_CELL_BASE_CLASSNAME = 'align-middle border-l p-0';
+//# sourceMappingURL=constants.js.map

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

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

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

@@ -0,0 +1 @@
+export * from './PHXScheduleTable';

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

@@ -0,0 +1,2 @@
+export * from './PHXScheduleTable';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,39 @@
+import React from 'react';
+import { GridCellData, GridRowHeader, GridScheduleContent } from './types';
+/**
+ * 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 declare const renderRowHeaderContent: (header: GridRowHeader) => string | number | bigint | true | Iterable<React.ReactNode> | Promise<React.AwaitedReactNode> | React.JSX.Element | null;
+/**
+ * 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 declare const renderCellBoxContent: (cell: GridCellData) => React.JSX.Element;
+/**
+ * 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 declare const renderScheduleContent: (scheduleContent: GridScheduleContent, userDetailPageUrl?: string) => React.JSX.Element;
+/**
+ * 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 declare const renderTooltipContent: (cell: GridCellData, userDetailPageUrl?: string) => string | number | bigint | true | Iterable<React.ReactNode> | Promise<React.AwaitedReactNode> | React.JSX.Element | 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 declare const resolveTooltipClassName: (cell: GridCellData) => string;

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 {};