@multiplatform.one/backoffice 6.4.3 → 6.7.0

package/src/index.ts

@@ -11,6 +11,7 @@
 
 // Provider + config
 export {
+  actionsForDoctype,
   BackofficeProvider,
   useBackofficeCapabilities,
   useBackofficeConfig,
@@ -65,6 +66,8 @@ export {
   listPath,
   newDocPath,
   parseDocDefaults,
+  QUERY_REPORT_BASE,
+  queryReportPath,
   slugToDisplayName,
   toSlug,
   viewPath,
@@ -83,6 +86,10 @@ export { BACKOFFICE_I18N_NAMESPACE, registerBackofficeTranslations } from "./i18
 // Shell
 export { BackofficeShell } from "./shell/BackofficeShell";
 export type { BackofficeShellProps } from "./shell/BackofficeShell";
+export { HomeRedirect } from "./shell/HomeRedirect";
+export { SlugScreen } from "./shell/SlugScreen";
+export type { SlugScreenProps } from "./shell/SlugScreen";
+export { NotFoundScreen } from "./shell/NotFoundScreen";
 export { WORKSPACE_SIDEBAR_WIDTH, WorkspaceSidebar } from "./shell/WorkspaceSidebar";
 export type { WorkspaceSidebarProps } from "./shell/WorkspaceSidebar";
 export { useDefaultWorkspace, useSessionUser, useWorkspaces } from "./shell/useWorkspaces";
@@ -217,3 +224,361 @@ export type {
 export { WorkspaceRecents } from "./workspace/WorkspaceRecents";
 export { WorkspaceScreen } from "./workspace/WorkspaceScreen";
 export type { WorkspaceBlockKind, WorkspaceScreenProps } from "./workspace/WorkspaceScreen";
+
+// Form surface
+// (formActions / sidebar-rpc / sidebar-utils / timeline-utils are deep-import
+// only — `@multiplatform.one/backoffice/src/form/*` — their utility names
+// collide across modules and with the list/shell surfaces.)
+export { buildPermLevelMatrix, canReadLevel, canWriteLevel } from "./form/fieldPermissions";
+export type { LevelPerm, PermLevelMatrix } from "./form/fieldPermissions";
+export { compileDependsOn, evaluateDependsOn } from "./form/dependsOn";
+export type { DependsDoc, DependsEvaluator } from "./form/dependsOn";
+export { applyFetchedValues, buildFetchMap, isFetchLocked } from "./form/fetchFrom";
+export type { FetchMap, FetchRule } from "./form/fetchFrom";
+export { computeDirtyFields, isEmptyValue, isSameValue } from "./form/dirtyTracking";
+export { setCreatePrefill, takeCreatePrefill } from "./form/createPrefill";
+export { normalizeDocPermissions } from "./form/docinfo";
+export {
+  buildCopyValues,
+  buildCreateDefaults,
+  buildFormTabs,
+  isPromptNamed,
+} from "./form/formLayout";
+export type { BuildTabsOptions, FormTab } from "./form/formLayout";
+export {
+  canOpenNewTab,
+  openInNewTab,
+  useBeforeUnloadGuard,
+  useNavigationDirtyGuard,
+  useSaveShortcut,
+} from "./form/platformHooks";
+export { useFormEngine } from "./form/useFormEngine";
+export type { FormEngine } from "./form/useFormEngine";
+export {
+  connectionListFilters,
+  connectionListHref,
+  formatConnectionCount,
+  groupConnectionLinks,
+  useConnectionCounts,
+} from "./form/connections-data";
+export type {
+  ConnectionCount,
+  ConnectionCounts,
+  ConnectionGroup,
+  ConnectionLink,
+} from "./form/connections-data";
+export {
+  buildTimelineFeed,
+  filterTimelineFeed,
+  parseVersionData,
+  versionSummary,
+} from "./form/timeline-entries";
+export type {
+  ParsedVersionData,
+  TimelineDocinfoLike,
+  TimelineFeedEntry,
+  TimelineFeedKind,
+  TimelineFilterValue,
+  TimelineRowLike,
+  TimelineTranslate,
+  TimelineUserInfoLike,
+  VersionFieldChange,
+} from "./form/timeline-entries";
+export { frappeColorToChipColor, FormToolbar, resolveIndicator } from "./form/FormToolbar";
+export type {
+  DocIndicator,
+  DocIndicatorSpec,
+  DocStatusIndicator,
+  FormToolbarMenuItem,
+  FormToolbarProps,
+} from "./form/FormToolbar";
+export { AssignDialog, EmailDialog, RenameDialog } from "./form/FormDialogs";
+export type { AssignDialogProps, EmailDialogProps, RenameDialogProps } from "./form/FormDialogs";
+export { SidebarAvatarStrip, SidebarPeopleList } from "./form/sidebar-people";
+export type {
+  SidebarAvatarStripProps,
+  SidebarPeopleListProps,
+  SidebarPersonItem,
+} from "./form/sidebar-people";
+export { SidebarAttachments } from "./form/sidebar-attachments";
+export type { SidebarAttachmentItem, SidebarAttachmentsProps } from "./form/sidebar-attachments";
+export { SidebarAssignDialog, SidebarShareDialog } from "./form/sidebar-dialogs";
+export type { SidebarAssignDialogProps, SidebarShareDialogProps } from "./form/sidebar-dialogs";
+export { FormHeaderCluster } from "./form/FormHeaderCluster";
+export type { FormHeaderClusterProps } from "./form/FormHeaderCluster";
+export { FormSidebarPanel } from "./form/FormSidebarPanel";
+export type { FormSidebarPanelMetaLike, FormSidebarPanelProps } from "./form/FormSidebarPanel";
+export { FormTimeline } from "./form/FormTimeline";
+export type { FormTimelineProps } from "./form/FormTimeline";
+export { FormConnections } from "./form/FormConnections";
+export type { FormConnectionsProps } from "./form/FormConnections";
+export { DocFormScreen } from "./form/DocFormScreen";
+export type { DocFormActionOverrides, DocFormScreenProps } from "./form/DocFormScreen";
+
+// Quick entry surface
+export {
+  buildQuickEntryDefaults,
+  buildQuickEntrySchema,
+  isEmptyFieldValue,
+  parseServerError,
+  planQuickEntry,
+  PROMPT_NAME_FIELD,
+  resolveCreatedName,
+} from "./quickEntry/quickEntryPlan";
+export type { ParsedServerError, QuickEntryPlan } from "./quickEntry/quickEntryPlan";
+export { QuickEntryDialog } from "./quickEntry/QuickEntryDialog";
+export type { QuickEntryDialogProps } from "./quickEntry/QuickEntryDialog";
+
+// List surface
+export { statusPillColors } from "./list/statusColors";
+export type { StatusPillColors } from "./list/statusColors";
+export {
+  formatDateCell,
+  formatTimeAgo,
+  parseFrappeDate,
+  parseTagsField,
+  parseUserListField,
+} from "./list/listFormat";
+export {
+  frappeFiltersToTableFilters,
+  frappeTupleToFilterValue,
+  sameFilterTuple,
+  tableStateToFrappeFilters,
+  toggleFilterTuple,
+} from "./list/filterConversion";
+export { bulkAddTag, bulkAssign, bulkDelete, toggleLike } from "./list/bulkActions";
+export type { BulkFailure, BulkResult } from "./list/bulkActions";
+export { listFieldsToFetch, listViewFields } from "./list/listFields";
+export {
+  defaultOperatorForKind,
+  DESK_OPERATOR_LABELS,
+  draftToTuple,
+  fieldKind,
+  fieldLabelFor,
+  filterableFieldsFromMeta,
+  filterTupleLabel,
+  operatorsForKind,
+  quickFilterValue,
+  selectOptionsFromField,
+  setFieldFilter,
+  standardDocFilterFields,
+  standardFiltersFromMeta,
+  tupleToDraft,
+} from "./list/filter-fields";
+export type {
+  DeskOperator,
+  FilterFieldDescriptor,
+  FilterFieldKind,
+  FilterRowDraft,
+} from "./list/filter-fields";
+export { FilterChips } from "./list/filter-chips";
+export type { FilterChipsProps } from "./list/filter-chips";
+export { FilterEditorButton, FilterEditorPanel } from "./list/filter-editor";
+export type { FilterEditorButtonProps, FilterEditorPanelProps } from "./list/filter-editor";
+export { sortableFieldsFromMeta, SortControl } from "./list/filter-sort";
+export type { SortControlProps } from "./list/filter-sort";
+export { StandardFilters } from "./list/filter-standard";
+export type { StandardFiltersProps } from "./list/filter-standard";
+export { SavedFiltersControl } from "./list/filter-saved";
+export type { SavedFiltersControlProps } from "./list/filter-saved";
+export { SidebarFacetRow, SidebarSection, SidebarSectionSkeleton } from "./list/sidebar-section";
+export type {
+  SidebarFacetRowProps,
+  SidebarSectionProps,
+  SidebarSectionSkeletonProps,
+} from "./list/sidebar-section";
+export {
+  filtersExcludingField,
+  isFacetFilterActive,
+  NO_TAGS_LABEL,
+  scrubUserFacetRows,
+  toggleFacetFilter,
+  useSidebarStats,
+} from "./list/sidebar-stats";
+export type {
+  SidebarFacetCount,
+  SidebarFacetState,
+  SidebarStatsState,
+  UseSidebarStatsOptions,
+} from "./list/sidebar-stats";
+export { ListSidebar } from "./list/ListSidebar";
+export type { ListSidebarProps, ListSidebarSection } from "./list/ListSidebar";
+export { AddTagsDialog } from "./list/AddTagsDialog";
+export type { AddTagsDialogProps } from "./list/AddTagsDialog";
+export { AssignToDialog } from "./list/AssignToDialog";
+export type { AssignToDialogProps } from "./list/AssignToDialog";
+export {
+  BULK_EDIT_EXCLUDED_FIELDTYPES,
+  bulkEditableFields,
+  BulkEditDialog,
+  bulkSetValue,
+} from "./list/bulk-edit-dialog";
+export type { BulkEditDialogProps, BulkEditValue } from "./list/bulk-edit-dialog";
+export { buildCsv, bulkExportCsv, downloadTextFile, exportFieldnames } from "./list/bulk-export";
+export type { BulkExportResult } from "./list/bulk-export";
+export { bulkSubmitCancel } from "./list/bulk-submit-cancel";
+export type { BulkDocstatusAction, BulkSubmitCancelResult } from "./list/bulk-submit-cancel";
+export { ListBulkActionsBar } from "./list/ListBulkActionsBar";
+export type { ListBulkActionsBarProps } from "./list/ListBulkActionsBar";
+export { ListToolsButton } from "./list/list-tools-sheet";
+export type { ListToolsButtonProps } from "./list/list-tools-sheet";
+export { buildListColumns } from "./list/listColumns";
+export type { BuildListColumnsArgs, ListDoc, ListRow } from "./list/listColumns";
+export { ListFilterBar } from "./list/ListFilterBar";
+export type { ListFilterBarProps } from "./list/ListFilterBar";
+export { DoctypeListScreen } from "./list/DoctypeListScreen";
+export type { DoctypeListScreenProps } from "./list/DoctypeListScreen";
+
+// Views surface
+export {
+  detectCardFields,
+  detectDateFields,
+  detectImageField,
+  detectSelectField,
+  selectFieldOptions,
+  useViewMeta,
+} from "./views/viewMeta";
+export type { AnyDoc, DetectedCardFields, DetectedDateFields } from "./views/viewMeta";
+export { useCalendarViewSettings, useKanbanBoard } from "./views/deskViewConfigs";
+export type {
+  CalendarViewDoc,
+  ConfigDocResult,
+  KanbanBoardColumnConfig,
+  KanbanBoardDoc,
+} from "./views/deskViewConfigs";
+export { useViewConnection } from "./views/connection";
+export type { ViewConnection } from "./views/connection";
+export {
+  kanbanFieldCandidates,
+  KanbanFieldPicker,
+  preferredKanbanField,
+} from "./views/kanban-field-picker";
+export type { KanbanFieldOption, KanbanFieldPickerProps } from "./views/kanban-field-picker";
+export {
+  addKanbanColumn,
+  createKanbanBoard,
+  parseBoardFilters,
+  setKanbanColumnStatus,
+} from "./views/kanbanBoardOps";
+export type { CreateKanbanBoardInput } from "./views/kanbanBoardOps";
+export {
+  CreateBoardDialog,
+  KanbanBoardEnd,
+  KanbanBoardPicker,
+  KanbanColumnMenu,
+} from "./views/kanban-board-controls";
+export type {
+  CreateBoardDialogProps,
+  KanbanBoardEndProps,
+  KanbanBoardPickerProps,
+  KanbanColumnMenuProps,
+} from "./views/kanban-board-controls";
+export {
+  calendarDateFieldCandidates,
+  CalendarFieldSelector,
+} from "./views/calendar-field-selector";
+export type { CalendarFieldSelectorProps } from "./views/calendar-field-selector";
+export {
+  REPORT_NUMERIC_FIELDTYPES,
+  REPORT_PAGE_SIZES,
+  ReportFooter,
+  ReportToolbar,
+} from "./views/report-controls";
+export type {
+  ReportFooterProps,
+  ReportRecordRef,
+  ReportToolbarProps,
+  ReportTotal,
+} from "./views/report-controls";
+export {
+  daysAgoIso,
+  detectStatusField,
+  filteredListHref,
+  isoDate,
+  MAX_STATUS_KPI_CARDS,
+  useWeeklyCreated,
+  WEEKS_WINDOW,
+  weekStart,
+} from "./views/dashboard-data";
+export type { WeeklyCreatedPoint, WeeklyCreatedState } from "./views/dashboard-data";
+export { BackToListButton, ViewError, ViewLoading, ViewUnsupported } from "./views/ViewStates";
+export type { ViewErrorProps, ViewUnsupportedProps } from "./views/ViewStates";
+export { useAvailableViews, useViewLabels, ViewHeader } from "./views/ViewHeader";
+export type { ViewHeaderProps } from "./views/ViewHeader";
+export { parseReportFiltersParam, ReportView } from "./views/ReportView";
+export type { ReportViewProps } from "./views/ReportView";
+export { KanbanView } from "./views/KanbanView";
+export type { KanbanViewProps } from "./views/KanbanView";
+export { CalendarView } from "./views/CalendarView";
+export type { CalendarViewProps } from "./views/CalendarView";
+export { TreeView } from "./views/TreeView";
+export type { TreeViewProps } from "./views/TreeView";
+export { ImageView } from "./views/ImageView";
+export type { ImageViewProps } from "./views/ImageView";
+export { DashboardView } from "./views/DashboardView";
+export type { DashboardViewProps } from "./views/DashboardView";
+export { DoctypeViewScreen } from "./views/DoctypeViewScreen";
+export type { DoctypeViewScreenProps } from "./views/DoctypeViewScreen";
+
+// Query-report surface
+// (reportShapes' `stripHtml` ships as `stripReportHtml` — the plain name
+// belongs to the workspace parseContent module.)
+export {
+  humanizeFrappeError,
+  isEmptyFilterValue,
+  normalizeFilterMeta,
+  normalizeQueryReportColumns,
+  normalizeQueryReportRows,
+  scrubFieldname,
+  stripHtml as stripReportHtml,
+} from "./report/reportShapes";
+export type {
+  QueryReportColumn,
+  QueryReportFilterMeta,
+  QueryReportFilters,
+  QueryReportFixture,
+  QueryReportMeta,
+  QueryReportRow,
+  QueryReportRunMessage,
+} from "./report/reportShapes";
+export { useQueryReport } from "./report/useQueryReport";
+export type { UseQueryReportOptions, UseQueryReportResult } from "./report/useQueryReport";
+export { buildQueryReportColumns } from "./report/queryReportColumns";
+export type { BuildQueryReportColumnsArgs } from "./report/queryReportColumns";
+export { QueryReportScreen } from "./report/QueryReportScreen";
+export type { QueryReportScreenProps } from "./report/QueryReportScreen";
+
+// Doctype report-view surface (desk report-builder parity; mounted for
+// view=report by DoctypeViewScreen). Model names are report-prefixed to
+// stay clear of the list/table filter vocabulary.
+export {
+  buildGridRows as buildReportGridRows,
+  buildReportCsv,
+  columnFilterTuple as reportColumnFilterTuple,
+  columnFilterTuples as reportColumnFilterTuples,
+  computeTotals as computeReportTotals,
+  defaultReportFieldnames,
+  fromDeskReportSettings,
+  orderReportRows,
+  parseDeskOrderBy,
+  reportColumnsFromMeta,
+  resolveSelectedColumns as resolveReportColumns,
+  toDeskReportSettings,
+} from "./report/reportViewModel";
+export type {
+  DeskReportSettings,
+  ReportColumnDef,
+  ReportGridRow,
+  ReportRow,
+  ReportSortState,
+  ReportTotalsCell,
+  ReportViewConfig,
+} from "./report/reportViewModel";
+export { useSavedReports } from "./report/savedReports";
+export type { SavedReportSummary, UseSavedReportsResult } from "./report/savedReports";
+export { ReportGrid } from "./report/report-grid";
+export type { ReportGridProps } from "./report/report-grid";
+export { ReportToolbar as DoctypeReportToolbar } from "./report/report-toolbar";
+export type { ReportToolbarProps as DoctypeReportToolbarProps } from "./report/report-toolbar";
+export { DoctypeReportView } from "./report/DoctypeReportView";
+export type { DoctypeReportViewProps } from "./report/DoctypeReportView";

package/src/list/AddTagsDialog.tsx

@@ -0,0 +1,98 @@
+// Add-tag dialog (desk bulk "Add Tags"): pick or type a tag, then
+// frappe.desk.doctype.tag.tag.add_tag per selected document (the server
+// creates unknown tags). Per-row failures surface in the result toast.
+import React from "react";
+import { ConfirmDialog, Text, YStack, notify } from "@multiplatform.one/components";
+import { Data } from "@multiplatform.one/frappe-ui";
+import { useState } from "react";
+import { useTranslation } from "react-i18next";
+import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useFrappeApp } from "../shared/useFrappeApp";
+import { bulkAddTag } from "./bulkActions";
+
+export interface AddTagsDialogProps {
+  doctype: string;
+  /** Documents to tag. */
+  names: string[];
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  /** Fired after tags were applied (even with partial failures). */
+  onDone?: () => void;
+}
+
+export function AddTagsDialog({ doctype, names, open, onOpenChange, onDone }: AddTagsDialogProps) {
+  const { t } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
+  const app = useFrappeApp();
+  const [tag, setTag] = useState("");
+  const [busy, setBusy] = useState(false);
+
+  const handleConfirm = async () => {
+    if (!app || !tag || names.length === 0) return;
+    setBusy(true);
+    try {
+      const result = await bulkAddTag(app, doctype, names, tag);
+      if (result.failed.length > 0) {
+        notify({
+          severity: "warning",
+          scope: "page",
+          body: t("list.tagPartial", {
+            defaultValue: "Tagged {{ok}} document(s); {{failed}} failed ({{names}})",
+            ok: result.succeeded.length,
+            failed: result.failed.length,
+            names: result.failed.map((failure) => failure.name).join(", "),
+          }),
+        });
+      } else {
+        notify({
+          severity: "success",
+          scope: "page",
+          body: t("list.tagDone", {
+            defaultValue: 'Added tag "{{tag}}" to {{count}} document(s)',
+            tag,
+            count: result.succeeded.length,
+          }),
+        });
+      }
+      setTag("");
+      onOpenChange(false);
+      onDone?.();
+    } catch (error) {
+      notify({
+        severity: "error",
+        scope: "page",
+        body: error instanceof Error ? error.message : t("list.tagFailed", "Tagging failed"),
+      });
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  return (
+    <ConfirmDialog
+      open={open}
+      onOpenChange={onOpenChange}
+      title={t("list.tagTitle", "Add Tags")}
+      confirmLabel={busy ? t("list.tagging", "Tagging…") : t("list.tagConfirm", "Add Tag")}
+      confirmDisabled={!tag || busy}
+      onConfirm={() => {
+        void handleConfirm();
+      }}
+    >
+      <YStack gap="$3" minWidth={280}>
+        <Text color="$color11" fontSize="$3">
+          {t("list.tagBody", {
+            defaultValue: "Tag {{count}} selected document(s)",
+            count: names.length,
+          })}
+        </Text>
+        <Data
+          label={t("list.tagField", "Tag")}
+          placeholder={t("list.tagPlaceholder", "New or existing tag name")}
+          value={tag}
+          onChange={(value) => setTag(value)}
+          required
+        />
+      </YStack>
+    </ConfirmDialog>
+  );
+}

package/src/list/AssignToDialog.tsx

@@ -0,0 +1,97 @@
+// Assign-to dialog (desk bulk "Assign To"): pick a user, optional note,
+// then frappe.desk.form.assign_to.add_multiple across the selection.
+import React from "react";
+import { ConfirmDialog, Text, YStack, notify } from "@multiplatform.one/components";
+import { Link, LongText } from "@multiplatform.one/frappe-ui";
+import { useState } from "react";
+import { useTranslation } from "react-i18next";
+import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useFrappeApp } from "../shared/useFrappeApp";
+import { bulkAssign } from "./bulkActions";
+
+export interface AssignToDialogProps {
+  doctype: string;
+  /** Documents to assign. */
+  names: string[];
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  /** Fired after a successful assignment. */
+  onDone?: () => void;
+}
+
+export function AssignToDialog({
+  doctype,
+  names,
+  open,
+  onOpenChange,
+  onDone,
+}: AssignToDialogProps) {
+  const { t } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
+  const app = useFrappeApp();
+  const [user, setUser] = useState("");
+  const [description, setDescription] = useState("");
+  const [busy, setBusy] = useState(false);
+
+  const handleConfirm = async () => {
+    if (!app || !user || names.length === 0) return;
+    setBusy(true);
+    try {
+      await bulkAssign(app, doctype, names, [user], description || undefined);
+      notify({
+        severity: "success",
+        scope: "page",
+        body: t("list.assignDone", {
+          defaultValue: "Assigned {{count}} document(s) to {{user}}",
+          count: names.length,
+          user,
+        }),
+      });
+      setUser("");
+      setDescription("");
+      onOpenChange(false);
+      onDone?.();
+    } catch (error) {
+      notify({
+        severity: "error",
+        scope: "page",
+        body: error instanceof Error ? error.message : t("list.assignFailed", "Assignment failed"),
+      });
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  return (
+    <ConfirmDialog
+      open={open}
+      onOpenChange={onOpenChange}
+      title={t("list.assignTitle", "Assign To")}
+      confirmLabel={busy ? t("list.assigning", "Assigning…") : t("list.assignConfirm", "Assign")}
+      confirmDisabled={!user || busy}
+      onConfirm={() => {
+        void handleConfirm();
+      }}
+    >
+      <YStack gap="$3" minWidth={280}>
+        <Text color="$color11" fontSize="$3">
+          {t("list.assignBody", {
+            defaultValue: "Assign {{count}} selected document(s)",
+            count: names.length,
+          })}
+        </Text>
+        <Link
+          label={t("list.assignUser", "Assign to user")}
+          doctype="User"
+          value={user}
+          onChange={setUser}
+          required
+        />
+        <LongText
+          label={t("list.assignComment", "Comment")}
+          value={description}
+          onChange={(value) => setDescription(value)}
+        />
+      </YStack>
+    </ConfirmDialog>
+  );
+}