@mshuja288/aksuicore 0.4.1 → 0.4.3

package/dist/index.d.cts

@@ -196,7 +196,20 @@ type ExportColumnRef = {
     key: string;
     header: string;
 };
-declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAdd, addLabel, canAdd, onView, onUpdate, onDelete, canUpdate, canDelete, onDownload, canDownload, downloadBusy, showColumnPicker, columnPrefsKey, visibleColumnKeys, defaultVisibleColumnKeys, onVisibleColumnKeysChange, toolbar, form, }: {
+type BulkImportMode = "insert" | "update" | "upsert";
+type BulkImportError = {
+    row: number;
+    field?: string | null;
+    code: string;
+    message: string;
+};
+type BulkImportResult = {
+    totalRows: number;
+    failed: number;
+    applied: boolean;
+    errors: BulkImportError[];
+};
+declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAdd, addLabel, canAdd, onView, onUpdate, onDelete, canUpdate, canDelete, onDownload, canDownload, canExport, downloadBusy, onBulkImport, canImport, importBusy, showColumnPicker, columnPrefsKey, visibleColumnKeys, defaultVisibleColumnKeys, onVisibleColumnKeysChange, toolbar, form, }: {
     title: string;
     columns: TableColumn<T>[];
     items: T[];
@@ -215,11 +228,20 @@ declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAd
      * Second argument lists currently visible columns (exportKey ?? key).
      */
     onDownload?: (format: ExportDownloadFormat, columns: ExportColumnRef[]) => void;
+    /** Alias for `canDownload` (RBAC). When set, export requires this and `canDownload` to be true. */
+    canExport?: boolean;
     canDownload?: boolean;
     downloadBusy?: boolean;
+    onBulkImport?: (mode: BulkImportMode, file: File) => Promise<BulkImportResult>;
+    canImport?: boolean;
+    importBusy?: boolean;
     /** Column checklist in the side rail. Default true. */
     showColumnPicker?: boolean;
-    /** Persist visible column keys in localStorage under this key. */
+    /**
+     * Persist visible column keys in localStorage under this key.
+     * Also persists filter values at `${columnPrefsKey}.filters`.
+     * Preview + side-rail open/collapsed use a shared key across all tables (`aksui.workspace.chrome`).
+     */
     columnPrefsKey?: string;
     /** Controlled visible column keys. */
     visibleColumnKeys?: string[];
@@ -233,4 +255,4 @@ declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAd
 /** @deprecated Prefer RecordWorkspace — alias kept for configurator migration */
 declare const RecordTable: typeof RecordWorkspace;
 
-export { type AksuiTokenName, AppSelect, type AppSelectOption, AppShell, type AppShellProps, Button, type ButtonVariant, ConfirmDeleteDialog, DateField, Dialog, type ExportColumnRef, type ExportDownloadFormat, FormActions, FormDialog, type MobileNavMode, type PageSizeOption, Pagination, RecordTable, RecordWorkspace, Select, type SelectOption, SideNav, type SideNavItem, Snackbar, StatusMessage, type TableColumn, Topbar, aksuiThemeVersion, aksuiTokens };
+export { type AksuiTokenName, AppSelect, type AppSelectOption, AppShell, type AppShellProps, type BulkImportError, type BulkImportMode, type BulkImportResult, Button, type ButtonVariant, ConfirmDeleteDialog, DateField, Dialog, type ExportColumnRef, type ExportDownloadFormat, FormActions, FormDialog, type MobileNavMode, type PageSizeOption, Pagination, RecordTable, RecordWorkspace, Select, type SelectOption, SideNav, type SideNavItem, Snackbar, StatusMessage, type TableColumn, Topbar, aksuiThemeVersion, aksuiTokens };

package/dist/index.d.ts

@@ -196,7 +196,20 @@ type ExportColumnRef = {
     key: string;
     header: string;
 };
-declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAdd, addLabel, canAdd, onView, onUpdate, onDelete, canUpdate, canDelete, onDownload, canDownload, downloadBusy, showColumnPicker, columnPrefsKey, visibleColumnKeys, defaultVisibleColumnKeys, onVisibleColumnKeysChange, toolbar, form, }: {
+type BulkImportMode = "insert" | "update" | "upsert";
+type BulkImportError = {
+    row: number;
+    field?: string | null;
+    code: string;
+    message: string;
+};
+type BulkImportResult = {
+    totalRows: number;
+    failed: number;
+    applied: boolean;
+    errors: BulkImportError[];
+};
+declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAdd, addLabel, canAdd, onView, onUpdate, onDelete, canUpdate, canDelete, onDownload, canDownload, canExport, downloadBusy, onBulkImport, canImport, importBusy, showColumnPicker, columnPrefsKey, visibleColumnKeys, defaultVisibleColumnKeys, onVisibleColumnKeysChange, toolbar, form, }: {
     title: string;
     columns: TableColumn<T>[];
     items: T[];
@@ -215,11 +228,20 @@ declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAd
      * Second argument lists currently visible columns (exportKey ?? key).
      */
     onDownload?: (format: ExportDownloadFormat, columns: ExportColumnRef[]) => void;
+    /** Alias for `canDownload` (RBAC). When set, export requires this and `canDownload` to be true. */
+    canExport?: boolean;
     canDownload?: boolean;
     downloadBusy?: boolean;
+    onBulkImport?: (mode: BulkImportMode, file: File) => Promise<BulkImportResult>;
+    canImport?: boolean;
+    importBusy?: boolean;
     /** Column checklist in the side rail. Default true. */
     showColumnPicker?: boolean;
-    /** Persist visible column keys in localStorage under this key. */
+    /**
+     * Persist visible column keys in localStorage under this key.
+     * Also persists filter values at `${columnPrefsKey}.filters`.
+     * Preview + side-rail open/collapsed use a shared key across all tables (`aksui.workspace.chrome`).
+     */
     columnPrefsKey?: string;
     /** Controlled visible column keys. */
     visibleColumnKeys?: string[];
@@ -233,4 +255,4 @@ declare function RecordWorkspace<T>({ title, columns, items, rowKey, empty, onAd
 /** @deprecated Prefer RecordWorkspace — alias kept for configurator migration */
 declare const RecordTable: typeof RecordWorkspace;
 
-export { type AksuiTokenName, AppSelect, type AppSelectOption, AppShell, type AppShellProps, Button, type ButtonVariant, ConfirmDeleteDialog, DateField, Dialog, type ExportColumnRef, type ExportDownloadFormat, FormActions, FormDialog, type MobileNavMode, type PageSizeOption, Pagination, RecordTable, RecordWorkspace, Select, type SelectOption, SideNav, type SideNavItem, Snackbar, StatusMessage, type TableColumn, Topbar, aksuiThemeVersion, aksuiTokens };
+export { type AksuiTokenName, AppSelect, type AppSelectOption, AppShell, type AppShellProps, type BulkImportError, type BulkImportMode, type BulkImportResult, Button, type ButtonVariant, ConfirmDeleteDialog, DateField, Dialog, type ExportColumnRef, type ExportDownloadFormat, FormActions, FormDialog, type MobileNavMode, type PageSizeOption, Pagination, RecordTable, RecordWorkspace, Select, type SelectOption, SideNav, type SideNavItem, Snackbar, StatusMessage, type TableColumn, Topbar, aksuiThemeVersion, aksuiTokens };

package/dist/index.js

@@ -867,9 +867,45 @@ var EXPORT_FORMAT_OPTIONS = [
   { format: "xlsx", label: "Excel" },
   { format: "json", label: "JSON" }
 ];
+var BULK_IMPORT_MODE_OPTIONS = [
+  { mode: "insert", label: "Insert" },
+  { mode: "update", label: "Update" },
+  { mode: "upsert", label: "Upsert" }
+];
 function defaultVisibleKeys(columns) {
   return columns.filter((column) => column.defaultVisible !== false).map((column) => column.key);
 }
+var WORKSPACE_CHROME_KEY = "aksui.workspace.chrome";
+function readWorkspaceChrome() {
+  if (typeof window === "undefined") {
+    return { previewEnabled: false, sideOpen: false };
+  }
+  try {
+    const raw = window.localStorage.getItem(WORKSPACE_CHROME_KEY);
+    if (!raw) {
+      return { previewEnabled: false, sideOpen: false };
+    }
+    const parsed = JSON.parse(raw);
+    return {
+      previewEnabled: Boolean(parsed.previewEnabled),
+      sideOpen: Boolean(parsed.sideOpen)
+    };
+  } catch {
+    return { previewEnabled: false, sideOpen: false };
+  }
+}
+function writeWorkspaceChrome(chrome) {
+  if (typeof window === "undefined") {
+    return;
+  }
+  try {
+    window.localStorage.setItem(WORKSPACE_CHROME_KEY, JSON.stringify(chrome));
+  } catch {
+  }
+}
+function filtersPrefsKey(columnPrefsKey) {
+  return columnPrefsKey ? `${columnPrefsKey}.filters` : void 0;
+}
 function readStoredColumnKeys(prefsKey, fallback, allowed) {
   if (!prefsKey || typeof window === "undefined") {
     return fallback;
@@ -898,6 +934,45 @@ function writeStoredColumnKeys(prefsKey, keys) {
   } catch {
   }
 }
+function readStoredFilters(prefsKey, allowed) {
+  if (!prefsKey || typeof window === "undefined") {
+    return {};
+  }
+  try {
+    const raw = window.localStorage.getItem(prefsKey);
+    if (!raw) {
+      return {};
+    }
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return {};
+    }
+    const next = {};
+    for (const [key, value] of Object.entries(parsed)) {
+      if (allowed.has(key) && typeof value === "string" && value.trim()) {
+        next[key] = value;
+      }
+    }
+    return next;
+  } catch {
+    return {};
+  }
+}
+function writeStoredFilters(prefsKey, filters) {
+  if (!prefsKey || typeof window === "undefined") {
+    return;
+  }
+  try {
+    const trimmed = {};
+    for (const [key, value] of Object.entries(filters)) {
+      if (value.trim()) {
+        trimmed[key] = value;
+      }
+    }
+    window.localStorage.setItem(prefsKey, JSON.stringify(trimmed));
+  } catch {
+  }
+}
 function compareColumnValues(column, left, right) {
   const leftRaw = column.display ? column.display(left) : column.value(left);
   const rightRaw = column.display ? column.display(right) : column.value(right);
@@ -943,6 +1018,13 @@ function PreviewIcon() {
     /* @__PURE__ */ jsx("circle", { cx: "10", cy: "10", r: "2.4", fill: "none", stroke: "currentColor", strokeWidth: "1.6" })
   ] });
 }
+function UploadIcon() {
+  return /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 20 20", "aria-hidden": "true", children: [
+    /* @__PURE__ */ jsx("path", { d: "M10 16.5V7.3", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round" }),
+    /* @__PURE__ */ jsx("path", { d: "M6.5 10.8 10 7.2l3.5 3.6", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round" }),
+    /* @__PURE__ */ jsx("path", { d: "M4 4.5h12", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round" })
+  ] });
+}
 function DownloadIcon() {
   return /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 20 20", "aria-hidden": "true", children: [
     /* @__PURE__ */ jsx("path", { d: "M10 3.5v8.2", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round" }),
@@ -992,7 +1074,11 @@ function RecordWorkspace({
   canDelete,
   onDownload,
   canDownload = true,
+  canExport,
   downloadBusy = false,
+  onBulkImport,
+  canImport = true,
+  importBusy = false,
   showColumnPicker = true,
   columnPrefsKey,
   visibleColumnKeys,
@@ -1010,13 +1096,21 @@ function RecordWorkspace({
   const [internalVisibleKeys, setInternalVisibleKeys] = useState(
     () => readStoredColumnKeys(columnPrefsKey, fallbackKeys, allowedKeys)
   );
-  const [filters, setFilters] = useState({});
+  const filterStorageKey = filtersPrefsKey(columnPrefsKey);
+  const [filters, setFilters] = useState(
+    () => readStoredFilters(filterStorageKey, allowedKeys)
+  );
   const [sort, setSort] = useState(null);
-  const [sideOpen, setSideOpen] = useState(false);
+  const [sideOpen, setSideOpen] = useState(() => readWorkspaceChrome().sideOpen);
   const [toolsDrawerOpen, setToolsDrawerOpen] = useState(false);
   const [downloadOpen, setDownloadOpen] = useState(false);
+  const [bulkOpen, setBulkOpen] = useState(false);
+  const [bulkMode, setBulkMode] = useState("upsert");
+  const [bulkFile, setBulkFile] = useState(null);
+  const [bulkReport, setBulkReport] = useState(null);
+  const bulkFileInputRef = useRef(null);
   const [columnsOpen, setColumnsOpen] = useState(false);
-  const [previewEnabled, setPreviewEnabled] = useState(false);
+  const [previewEnabled, setPreviewEnabled] = useState(() => readWorkspaceChrome().previewEnabled);
   const [previewKey, setPreviewKey] = useState(null);
   const [tooltip, setTooltip] = useState(null);
   const [pageSize, setPageSize] = useState("15");
@@ -1031,6 +1125,9 @@ function RecordWorkspace({
     }
     setInternalVisibleKeys(readStoredColumnKeys(columnPrefsKey, fallbackKeys, allowedKeys));
   }, [allowedKeys, columnPrefsKey, fallbackKeys, isControlled]);
+  useEffect(() => {
+    setFilters(readStoredFilters(filtersPrefsKey(columnPrefsKey), allowedKeys));
+  }, [allowedKeys, columnPrefsKey]);
   const resolvedVisibleKeys = useMemo(() => {
     const source = isControlled ? visibleColumnKeys : internalVisibleKeys;
     const filtered2 = source.filter((key) => allowedKeys.has(key));
@@ -1109,7 +1206,9 @@ function RecordWorkspace({
   const start = showAll ? 0 : (currentPage - 1) * numericPageSize;
   const pageItems = showAll ? sorted : sorted.slice(start, start + numericPageSize);
   const showAdd = canAdd && Boolean(onAdd);
-  const showDownload = Boolean(onDownload) && canDownload;
+  const exportAllowed = (canExport ?? true) && canDownload;
+  const showDownload = Boolean(onDownload) && exportAllowed;
+  const showBulkImport = Boolean(onBulkImport) && canImport;
   const showFilters = filterableColumns.length > 0;
   const showColumns = showColumnPicker && columns.length > 0;
   const previewItem = previewKey === null ? null : sorted.find((item) => rowKey(item) === previewKey) ?? null;
@@ -1154,6 +1253,29 @@ function RecordWorkspace({
     onDownload(format, exportColumns);
     setDownloadOpen(false);
   }
+  async function submitBulkImport() {
+    if (!onBulkImport || importBusy || !bulkFile) {
+      return;
+    }
+    setBulkReport(null);
+    try {
+      const report = await onBulkImport(bulkMode, bulkFile);
+      setBulkReport(report);
+      if (report.applied) {
+        setBulkFile(null);
+        if (bulkFileInputRef.current) {
+          bulkFileInputRef.current.value = "";
+        }
+      }
+    } catch {
+      setBulkReport({
+        totalRows: 0,
+        failed: 1,
+        applied: false,
+        errors: [{ row: 0, code: "ImportFailed", message: "Import request failed." }]
+      });
+    }
+  }
   function cellText(column, item) {
     const raw = column.display ? column.display(item) : column.value(item);
     return raw === null || raw === void 0 || raw === "" ? "\u2014" : String(raw);
@@ -1166,13 +1288,22 @@ function RecordWorkspace({
   }
   const previewTitle = previewItem && visibleColumns[0] ? cellText(visibleColumns[0], previewItem) : null;
   function changeFilter(key, value) {
-    setFilters((current) => ({ ...current, [key]: value }));
+    setFilters((current) => {
+      const next = { ...current, [key]: value };
+      writeStoredFilters(filterStorageKey, next);
+      return next;
+    });
     setPage(1);
   }
   function clearFilters() {
     setFilters({});
+    writeStoredFilters(filterStorageKey, {});
     setPage(1);
   }
+  function setSideOpenValue(open) {
+    setSideOpen(open);
+    writeWorkspaceChrome({ previewEnabled, sideOpen: open });
+  }
   function toggleSort(column) {
     if (column.sortable === false) {
       return;
@@ -1190,6 +1321,7 @@ function RecordWorkspace({
   }
   function setPreviewEnabledValue(enabled) {
     setPreviewEnabled(enabled);
+    writeWorkspaceChrome({ previewEnabled: enabled, sideOpen });
     setTooltip(null);
     if (!enabled) {
       setPreviewKey(null);
@@ -1250,7 +1382,7 @@ function RecordWorkspace({
             title: "Columns",
             "aria-label": "Columns",
             onClick: () => {
-              setSideOpen(true);
+              setSideOpenValue(true);
               setColumnsOpen(true);
             },
             children: [
@@ -1268,12 +1400,27 @@ function RecordWorkspace({
             "aria-label": "Download",
             disabled: downloadBusy,
             onClick: () => {
-              setSideOpen(true);
+              setSideOpenValue(true);
               setDownloadOpen(true);
             },
             children: /* @__PURE__ */ jsx(DownloadIcon, {})
           }
         ) : null,
+        showBulkImport ? /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            className: "ghost side-rail-icon",
+            title: "Bulk entry",
+            "aria-label": "Bulk entry",
+            disabled: importBusy,
+            onClick: () => {
+              setSideOpenValue(true);
+              setBulkOpen(true);
+            },
+            children: /* @__PURE__ */ jsx(UploadIcon, {})
+          }
+        ) : null,
         showFilters ? /* @__PURE__ */ jsxs(
           "button",
           {
@@ -1398,6 +1545,77 @@ function RecordWorkspace({
           option.format
         )) }) : null
       ] }) : null,
+      showBulkImport ? /* @__PURE__ */ jsxs("div", { className: "side-rail-bulk", children: [
+        /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            className: "ghost side-rail-bulk-toggle",
+            "aria-expanded": bulkOpen,
+            disabled: importBusy,
+            onClick: () => setBulkOpen((open) => !open),
+            children: [
+              /* @__PURE__ */ jsx(UploadIcon, {}),
+              /* @__PURE__ */ jsx("span", { children: importBusy ? "Importing\u2026" : "Bulk entry" })
+            ]
+          }
+        ),
+        bulkOpen ? /* @__PURE__ */ jsxs("div", { className: "side-rail-bulk-panel", role: "group", "aria-label": "Bulk entry", children: [
+          /* @__PURE__ */ jsxs("label", { className: "side-rail-bulk-mode", children: [
+            "Mode",
+            /* @__PURE__ */ jsx(
+              Select,
+              {
+                value: bulkMode,
+                options: BULK_IMPORT_MODE_OPTIONS.map((option) => ({ value: option.mode, label: option.label })),
+                onChange: (value) => setBulkMode(value)
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsxs("label", { className: "side-rail-bulk-file", children: [
+            "File",
+            /* @__PURE__ */ jsx(
+              "input",
+              {
+                ref: bulkFileInputRef,
+                type: "file",
+                accept: ".csv,.xlsx,.json",
+                disabled: importBusy,
+                onChange: (event) => {
+                  setBulkFile(event.target.files?.[0] ?? null);
+                  setBulkReport(null);
+                }
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: "side-rail-bulk-submit",
+              disabled: importBusy || !bulkFile,
+              onClick: () => void submitBulkImport(),
+              children: importBusy ? "Importing\u2026" : "Import"
+            }
+          ),
+          bulkReport ? /* @__PURE__ */ jsxs("div", { className: "side-rail-bulk-report", role: "status", children: [
+            /* @__PURE__ */ jsx("p", { children: bulkReport.applied ? `Applied ${bulkReport.totalRows} row(s).` : `${bulkReport.failed} error(s) in ${bulkReport.totalRows} row(s).` }),
+            bulkReport.errors.length > 0 ? /* @__PURE__ */ jsxs("ul", { className: "side-rail-bulk-errors", children: [
+              bulkReport.errors.slice(0, 8).map((error, index) => /* @__PURE__ */ jsxs("li", { children: [
+                "Row ",
+                error.row,
+                ": ",
+                error.message
+              ] }, `${error.row}-${error.code}-${index}`)),
+              bulkReport.errors.length > 8 ? /* @__PURE__ */ jsxs("li", { children: [
+                "\u2026and ",
+                bulkReport.errors.length - 8,
+                " more"
+              ] }) : null
+            ] }) : null
+          ] }) : null
+        ] }) : null
+      ] }) : null,
       showFilters ? /* @__PURE__ */ jsxs("div", { className: "side-rail-filters", children: [
         /* @__PURE__ */ jsxs("div", { className: "filter-panel-head", children: [
           /* @__PURE__ */ jsx("h3", { children: "Filters" }),
@@ -1599,7 +1817,7 @@ function RecordWorkspace({
                 className: "ghost side-rail-toggle",
                 "aria-expanded": sideOpen,
                 title: sideOpen ? "Collapse" : "Expand",
-                onClick: () => setSideOpen((open) => !open),
+                onClick: () => setSideOpenValue(!sideOpen),
                 children: [
                   /* @__PURE__ */ jsx(ChevronIcon, { open: sideOpen }),
                   sideOpen ? /* @__PURE__ */ jsx("span", { children: "Collapse" }) : null