@mshuja288/aksuicore 0.4.1 → 0.4.2

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,8 +228,13 @@ 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. */
@@ -233,4 +251,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,8 +228,13 @@ 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. */
@@ -233,4 +251,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,6 +867,11 @@ 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);
 }
@@ -943,6 +948,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 +1004,11 @@ function RecordWorkspace({
   canDelete,
   onDownload,
   canDownload = true,
+  canExport,
   downloadBusy = false,
+  onBulkImport,
+  canImport = true,
+  importBusy = false,
   showColumnPicker = true,
   columnPrefsKey,
   visibleColumnKeys,
@@ -1015,6 +1031,11 @@ function RecordWorkspace({
   const [sideOpen, setSideOpen] = useState(false);
   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 [previewKey, setPreviewKey] = useState(null);
@@ -1109,7 +1130,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 +1177,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);
@@ -1274,6 +1320,21 @@ function RecordWorkspace({
             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: () => {
+              setSideOpen(true);
+              setBulkOpen(true);
+            },
+            children: /* @__PURE__ */ jsx(UploadIcon, {})
+          }
+        ) : null,
         showFilters ? /* @__PURE__ */ jsxs(
           "button",
           {
@@ -1398,6 +1459,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" }),