@dmsi/wedgekit-react 0.0.1242 → 1.0.0

package/dist/hooks/useTableLayout/storage.d.ts

@@ -0,0 +1,41 @@
+import { PersistedTablePreferences } from './types';
+/**
+ * Get the storage key for the new preference format.
+ */
+export declare function getStorageKey(key: string): string;
+/**
+ * Get the legacy storage key (version 1 - full ColumnDef array).
+ */
+export declare function getLegacyStorageKey(key: string): string;
+/**
+ * Check if stored data is legacy format (version 1 - full ColumnDef array).
+ */
+export declare function isLegacyFormat(data: unknown): data is Array<unknown>;
+/**
+ * Load preferences from localStorage, handling migration from legacy format.
+ * Returns null if no valid preferences exist (user starts with system defaults).
+ */
+export declare function loadPreferences(key: string): PersistedTablePreferences | null;
+/**
+ * Save preferences to localStorage.
+ * Only saves if there are actual user modifications.
+ */
+export declare function savePreferences(key: string, preferences: Omit<PersistedTablePreferences, "version">): void;
+/**
+ * Clear all preferences for a specific key.
+ */
+export declare function clearPreferences(key: string): void;
+/**
+ * Clear ALL legacy table layout data across the entire application.
+ * This is called once on first load after the migration to clear old data.
+ */
+export declare function clearAllLegacyData(): void;
+/**
+ * Check if legacy migration has been performed.
+ */
+export declare function hasPerformedLegacyMigration(): boolean;
+/**
+ * Mark legacy migration as complete.
+ */
+export declare function markLegacyMigrationComplete(): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/hooks/useTableLayout/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTableLayout/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAMzD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAEpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CA4B7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC,GACtD,IAAI,CAqBN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAezC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/hooks/useTableLayout/types.d.ts

@@ -0,0 +1,56 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { SetStateAction } from 'react';
+/**
+ * User preferences that get persisted to localStorage.
+ * Only stores deltas from the system defaults - never the full column definitions.
+ */
+export type PersistedTablePreferences = {
+    /** User's custom column order (array of column IDs) */
+    columnOrder?: string[];
+    /** Columns the user explicitly hid (that were visible by default) */
+    hiddenByUser?: string[];
+    /** Columns the user explicitly showed (that were hidden by default) */
+    shownByUser?: string[];
+    /** Column widths set by user */
+    columnWidths?: Record<string, number>;
+    /** Schema version for migration detection */
+    version: 2;
+};
+/**
+ * Legacy format (version 1) - full ColumnDef array.
+ * Used for migration detection and cleanup.
+ */
+export type LegacyPersistedLayout = Array<{
+    id?: string;
+    meta?: {
+        visible?: boolean;
+    };
+    [key: string]: unknown;
+}>;
+/**
+ * Return type for useTableLayout hook.
+ * Maintains backward compatibility with existing API while adding new features.
+ */
+export type PersistedTableLayout<T> = {
+    /** Final computed columns with user preferences applied */
+    columns: ColumnDef<T>[];
+    /** Update columns - triggers preference extraction and persistence */
+    setColumns: (setter: SetStateAction<ColumnDef<T>[]>) => void;
+    /** Whether the layout has been initialized from storage */
+    isReady: boolean;
+    /** Get raw saved layout (for backward compatibility) */
+    getSavedLayout: () => ColumnDef<T>[] | undefined;
+    /** Hide a column (user action - persisted) */
+    hideColumn: (columnId: string) => void;
+    /** Show a column (user action - persisted) */
+    showColumn: (columnId: string) => void;
+    /** Reorder columns (user action - persisted) */
+    reorderColumns: (columnIds: string[]) => void;
+    /** Set column width (user action - persisted) */
+    setColumnWidth: (columnId: string, width: number) => void;
+    /** Reset all user preferences to defaults */
+    resetToDefaults: () => void;
+    /** Get current user preferences */
+    getUserPreferences: () => PersistedTablePreferences;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/useTableLayout/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTableLayout/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,6CAA6C;IAC7C,OAAO,EAAE,CAAC,CAAC;CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,KAAK,CAAC;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,2DAA2D;IAC3D,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACxB,sEAAsE;IACtE,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7D,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,cAAc,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IACjD,8CAA8C;IAC9C,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,8CAA8C;IAC9C,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,gDAAgD;IAChD,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC9C,iDAAiD;IACjD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,6CAA6C;IAC7C,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,mCAAmC;IACnC,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;CACrD,CAAC"}

package/dist/hooks/useTableLayout/useTableLayout.d.ts

@@ -0,0 +1,23 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { PersistedTableLayout } from './types';
+/**
+ * Custom hook to manage table layout persistence.
+ *
+ * Separates user preferences (persisted) from system state (always authoritative).
+ * - System visibility (ecom params, permissions) ALWAYS wins
+ * - User preferences (order, manual hide/show) are applied on top of system state
+ *
+ * Key behaviors:
+ * - Does NOT save to localStorage on first visit (only when user makes changes)
+ * - System-controlled visibility (via ecom params) cannot be overridden by cached data
+ * - User preferences are preserved when they don't conflict with system settings
+ * - Legacy data from old format is automatically cleared on first load
+ *
+ * @template T The row data type for the table
+ * @param initialColumns System-defined columns (source of truth for structure and default visibility)
+ * @param key Storage key for localStorage (typically the table's test ID)
+ * @param autosync Whether to automatically load/save preferences (default: true)
+ * @returns Table layout state and actions
+ */
+export declare function useTableLayout<T>(initialColumns: Array<ColumnDef<T>>, key?: string, autosync?: boolean): PersistedTableLayout<T>;
+//# sourceMappingURL=useTableLayout.d.ts.map

package/dist/hooks/useTableLayout/useTableLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableLayout.d.ts","sourceRoot":"","sources":["../../../src/hooks/useTableLayout/useTableLayout.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAA6B,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAkB/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EACnC,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,UAAO,GACd,oBAAoB,CAAC,CAAC,CAAC,CA0RzB"}

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+export * from './components/Accordion';
+export * from './components/AccessCard';
+export * from './components/AccessCardGroup';
+export * from './components/AccessChangerTabItem';
+export * from './components/Alert';
+export * from './components/Breadcrumbs';
+export * from './components/Button';
+export * from './components/CalendarRange';
+export * from './components/Caption';
+export * from './components/Card';
+export * from './components/Checkbox';
+export * from './components/CompactImagesPreview';
+export * from './components/ContentTab';
+export * from './components/ContentTabs';
+export { DataTable, type DataTableProps, type OrderRow } from './components/DataTable';
+export * from './components/DataGrid';
+export * from './components/DataGridCell';
+export * from './components/DateInput';
+export * from './components/DateRangeInput';
+export * from './components/DebugJson';
+export * from './components/Display';
+export * from './components/DMSiLogo';
+export * from './components/EditingContext';
+export * from './components/EmblaCarousel';
+export * from './components/EmptyCartIcon';
+export * from './components/FilterGroup';
+export * from './components/FullViewportBox';
+export * from './components/Grid';
+export * from './components/Heading';
+export * from './components/HorizontalDivider';
+export * from './components/Icon';
+export * from './components/ImagePlaceholder';
+export * from './components/Input';
+export * from './components/InputGroup';
+export * from './components/Label';
+export * from './components/Link';
+export * from './components/List';
+export * from './components/ListGroup';
+export * from './components/LiveChatComponent';
+export * from './components/LoadingScrim';
+export * from './components/LogoAgilityTopBar';
+export * from './components/LogoDMSiTopBar';
+export * from './components/LogoMillworkTopBar';
+export * from './components/MainBar';
+export * from './components/MaxViewportBox';
+export * from './components/Menu';
+export * from './components/MenuOption';
+export * from './components/Modal';
+export * from './components/ModalButtons';
+export * from './components/ModalContent';
+export * from './components/ModalHeader';
+export * from './components/ModalScrim';
+export * from './components/MobileDataGrid';
+export * from './components/MobileNavMenu';
+export * from './components/NavigationTab';
+export * from './components/NavigationTabs';
+export * from './components/NestedMenu';
+export * from './components/Notification';
+export * from './components/OptionPill';
+export * from './components/OrderCheckIcon';
+export * from './components/Pagination';
+export * from './components/Paragraph';
+export * from './components/Password';
+export * from './components/PDFViewer';
+export * from './components/ProductImagePreview';
+export * from './components/ProjectBar';
+export * from './components/Radio';
+export * from './components/SearchResultImage';
+export * from './components/Search';
+export * from './components/Select';
+export * from './components/SideMenu';
+export * from './components/SideMenuGroup';
+export * from './components/SideMenuItem';
+export * from './components/SimpleTable';
+export * from './components/SkeletonParagraph';
+export * from './components/Spinner';
+export * from './components/Stack';
+export * from './components/StatusPill';
+export * from './components/Stepper';
+export * from './components/Subheader';
+export * from './components/Swatch';
+export * from './components/Surface';
+export * from './components/Textarea';
+export * from './components/Time';
+export * from './components/Theme';
+export * from './components/Toast';
+export * from './components/Tooltip';
+export * from './components/TopBar';
+export * from './components/Upload';
+export * from './components/WorldpayIframe';
+export { default as NoResultsImg } from './static/no-results-image.png';
+export * from './hooks';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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