improvement(tables): surface blocked lock actions as a toast, not a modal

- Replace TableLockedModal with a warning toast carrying a "Lock settings"
  action button for admins. Being told you can't edit shouldn't cost a dismiss
  click, and the button still routes admins straight to the panel
- Dedupe by id so repeated attempts on a locked cell replace one notice
  instead of stacking a column of them
- Move the copy into lock-copy.ts alongside the rest of the lock vocabulary
  and tighten it for toast length

Author: TheodoreSpeaks

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/index.ts

@@ -10,5 +10,4 @@ export * from './sidebar-fields'
 export * from './table-action-bar'
 export * from './table-filter'
 export * from './table-grid'
-export * from './table-locked-modal'
 export * from './workflow-sidebar'

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/table-grid/table-grid.tsx

@@ -21,6 +21,7 @@ import type {
 import { getColumnId } from '@/lib/table/column-keys'
 import { TABLE_LIMITS } from '@/lib/table/constants'
 import { useUserPermissionsContext } from '@/app/workspace/[workspaceId]/providers/workspace-permissions-provider'
+import type { BlockedTableAction } from '@/app/workspace/[workspaceId]/tables/[tableId]/lock-copy'
 import { useTimezone } from '@/hooks/queries/general-settings'
 import {
   useAddTableColumn,
@@ -50,7 +51,6 @@ import type { ColumnConfig } from '../column-config-sidebar'
 import { ContextMenu } from '../context-menu'
 import { NewColumnDropdown } from '../new-column-dropdown'
 import { resolveSelectOptions } from '../select-field'
-import type { BlockedTableAction } from '../table-locked-modal'
 import type { WorkflowConfig } from '../workflow-sidebar'
 import { ExpandedCellPopover } from './cells'
 import { ADD_COL_WIDTH, COL_WIDTH, SELECTION_TINT_BG } from './constants'

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/table-locked-modal/index.ts

@@ -1,6 +1,6 @@
 /**
  * Single source of truth for lock vocabulary shared by the lock settings modal,
- * the locked-action modal, and the table header chip. Kept out of
+ * the blocked-action toast, and the table header chip. Kept out of
  * `lib/table/mutation-locks.ts` — that module is server-tainted (importing it
  * from a client component pulls `next/headers` into the browser bundle).
  */
@@ -65,3 +65,66 @@ export function describeLocks(locks: TableLocks): { name: string; detail: string
   }
   return { name: 'Locked', detail: `${locked.join(', ')} locked.` }
 }
+
+/**
+ * Why a locked-table notice was raised. `'status'` is the informational case
+ * (a non-admin clicking the header lock chip); the rest are actions the user
+ * just tried and couldn't do.
+ */
+export type BlockedTableAction = 'add-row' | 'add-column' | 'delete-column' | 'edit-cell' | 'status'
+
+/**
+ * Copy for the action the user attempted. Explains what is blocked and — for
+ * the append-only manual-entry case — what to do instead, since that one is
+ * blocked by the *update* lock rather than the insert lock.
+ */
+export function describeBlockedAction(
+  action: BlockedTableAction,
+  locks: TableLocks
+): { title: string; text: string } {
+  switch (action) {
+    case 'add-row':
+      if (locks.insertLocked) {
+        return {
+          title: 'Adding rows is locked',
+          text: 'No new rows can be added until an admin unlocks this table.',
+        }
+      }
+      return {
+        title: 'This table is append-only',
+        text: 'Rows can’t be edited once added, so typing one into the grid is unavailable. Import a CSV, or add rows from the API, a workflow, or Sim.',
+      }
+    case 'add-column':
+      return {
+        title: 'Changing columns is locked',
+        text: 'Columns can’t be added, renamed, retyped, or removed until an admin unlocks this table.',
+      }
+    case 'delete-column':
+      // Reachable with the schema lock off but the delete lock on — removing a
+      // column clears its value from every row, so it needs both.
+      return locks.schemaLocked
+        ? {
+            title: 'Changing columns is locked',
+            text: 'Columns can’t be added, renamed, retyped, or removed until an admin unlocks this table.',
+          }
+        : {
+            title: 'Deleting columns is locked',
+            text: 'Removing a column deletes its value from every row, so it’s blocked while deleting is locked.',
+          }
+    case 'edit-cell':
+      return {
+        title: 'Editing rows is locked',
+        text: 'Existing cell values can’t be changed until an admin unlocks this table. Workflow and enrichment columns still populate.',
+      }
+    case 'status': {
+      const nouns = lockedNouns(locks)
+      return {
+        title: 'Table locks',
+        text:
+          nouns.length > 0
+            ? `An admin has locked ${nouns.join(', ')} on this table.`
+            : 'Nothing is locked on this table.',
+      }
+    }
+  }
+}

apps/sim/app/workspace/[workspaceId]/tables/[tableId]/components/table-locked-modal/table-locked-modal.tsx

@@ -44,7 +44,6 @@ import { useSettingsNavigation } from '@/hooks/use-settings-navigation'
 import { useLogDetailsUIStore } from '@/stores/logs/store'
 import type { DeletedRowSnapshot } from '@/stores/table/types'
 import {
-  type BlockedTableAction,
   type ColumnConfig,
   ColumnConfigSidebar,
   EnrichmentDetails,
@@ -57,14 +56,18 @@ import {
   TableActionBar,
   TableFilter,
   TableGrid,
-  TableLockedModal,
   type WorkflowConfig,
   WorkflowSidebar,
 } from './components'
 import { COLUMN_SIDEBAR_WIDTH } from './components/table-grid/constants'
 import { COLUMN_TYPE_ICONS } from './components/table-grid/headers'
 import { useTable, useTableEventStream } from './hooks'
-import { describeLocks, lockedNouns } from './lock-copy'
+import {
+  type BlockedTableAction,
+  describeBlockedAction,
+  describeLocks,
+  lockedNouns,
+} from './lock-copy'
 import {
   DEFAULT_TABLE_DETAIL_SORT_DIRECTION,
   tableDetailParsers,
@@ -83,6 +86,9 @@ const logger = createLogger('Table')
  */
 const tableLocksEnabled = isTruthy(getEnv('NEXT_PUBLIC_TABLE_LOCKS'))
 
+/** Blocked-action toasts carry a button, so they linger past the 5s default. */
+const BLOCKED_TOAST_MS = 8000
+
 interface TableProps {
   /** When set, the table renders without its page header / breadcrumbs / page-level
    *  options bar. Used by the mothership chat panel to embed a table inline. */
@@ -169,7 +175,9 @@ export function Table({
   const [slideout, dispatch] = useReducer(slideoutReducer, { kind: 'none' })
   const [showDeleteTableConfirm, setShowDeleteTableConfirm] = useState(false)
   const [showLockSettings, setShowLockSettings] = useState(false)
-  const [blockedAction, setBlockedAction] = useState<BlockedTableAction | null>(null)
+  // Id of the last blocked-action toast, so a user who keeps typing into a
+  // locked cell replaces one notice rather than stacking a column of them.
+  const blockedToastIdRef = useRef<string | null>(null)
   const [isImportCsvOpen, setIsImportCsvOpen] = useState(false)
   const [editingRow, setEditingRow] = useState<TableRowType | null>(null)
   const [deletingRows, setDeletingRows] = useState<DeletedRowSnapshot[]>([])
@@ -602,6 +610,38 @@ export function Table({
     ]
   )
 
+  // An admin can always reach the settings on a locked table — clearing locks
+  // stays allowed with the flag off, so the kill switch can't strand one. With
+  // the flag off and nothing locked there is nothing to change, so the toast is
+  // a plain notice with no action.
+  const canOpenLockSettings =
+    userPermissions.canAdmin === true &&
+    (tableLocksEnabled || (tableData ? lockedNouns(tableData.locks).length > 0 : false))
+
+  /**
+   * Explains why a table mutation is unavailable. A toast rather than a modal:
+   * being told you can't edit shouldn't cost a dismiss click, and admins still
+   * get a direct route to the settings via the action button.
+   */
+  const showBlockedToast = useCallback(
+    (action: BlockedTableAction) => {
+      if (!tableData) return
+      if (blockedToastIdRef.current) toast.dismiss(blockedToastIdRef.current)
+      const { title, text } = describeBlockedAction(action, tableData.locks)
+      blockedToastIdRef.current = toast.warning(title, {
+        description: text,
+        ...(canOpenLockSettings
+          ? {
+              action: { label: 'Lock settings', onClick: () => setShowLockSettings(true) },
+              // An action would otherwise pin the toast open until dismissed.
+              duration: BLOCKED_TOAST_MS,
+            }
+          : {}),
+      })
+    },
+    [tableData, canOpenLockSettings]
+  )
+
   const headerActions = useMemo(() => {
     if (!tableData) return undefined
     const anyLocked = lockedNouns(tableData.locks).length > 0
@@ -616,7 +656,7 @@ export function Table({
               label: lockLabel,
               icon: Lock,
               onClick: () =>
-                userPermissions.canAdmin ? setShowLockSettings(true) : setBlockedAction('status'),
+                userPermissions.canAdmin ? setShowLockSettings(true) : showBlockedToast('status'),
             },
           ]
         : []),
@@ -641,6 +681,7 @@ export function Table({
     userPermissions.canAdmin,
     handleExportCsv,
     onRequestImportCsv,
+    showBlockedToast,
   ])
 
   // Adding a column is a schema change. The trigger stays visible when the
@@ -651,7 +692,7 @@ export function Table({
       trigger='header'
       disabled={false}
       blocked={!canMutateSchema}
-      onBlocked={() => setBlockedAction('add-column')}
+      onBlocked={() => showBlockedToast('add-column')}
       onPickType={handleAddColumnOfType}
       onPickWorkflow={handleAddWorkflowColumn}
       onPickEnrichment={onOpenEnrichments}
@@ -775,7 +816,7 @@ export function Table({
         tableId={tableId}
         embedded={embedded}
         locks={tableData?.locks}
-        onBlockedAction={setBlockedAction}
+        onBlockedAction={showBlockedToast}
         sidebarReservedPx={sidebarReservedPx}
         onOpenColumnConfig={onOpenColumnConfig}
         onOpenWorkflowConfig={onOpenWorkflowConfig}
@@ -1039,22 +1080,6 @@ export function Table({
           locks={tableData.locks}
         />
       )}
-      {tableData && (
-        <TableLockedModal
-          action={blockedAction}
-          locks={tableData.locks}
-          // An admin can always reach the panel on a locked table — clearing
-          // locks stays allowed with the flag off, so the kill switch can't
-          // strand one. With the flag off and nothing locked there is nothing
-          // to change, so they get the same read-only notice as everyone else.
-          canAdmin={
-            userPermissions.canAdmin === true &&
-            (tableLocksEnabled || lockedNouns(tableData.locks).length > 0)
-          }
-          onClose={() => setBlockedAction(null)}
-          onOpenLockSettings={() => setShowLockSettings(true)}
-        />
-      )}
     </Resource>
   )
 }