@efa-one/sdk 1.26.0 → 1.27.0

package/README.md

@@ -281,6 +281,13 @@ Excel export for such data. No backend or kernel change.
   scrollbar sits above the table and scrolls in sync with the bottom one. Not on
   mobile. The border moved to an outer wrapper.
 
+**1.27.0 — `useRecords`: edit first, read-only without permission.** No kernel or backend change.
+- `editable` (default `true`): `false` opens records read-only, no pencil, no PUT
+  (`editable: can(user, 'write')`).
+- `openIn: 'edit'`: a click on a record opens the form directly (with `editable`); default
+  `'read'` keeps read → pencil → edit.
+- `dialogProps` now carries `mode`, `onModeChange` and `readOnly`; do not pass them yourself.
+
 **1.26.0 — `useRecords`, `ConfirmDeleteDialog`, `Switch`.** No kernel or backend change.
 - `useRecords({ endpoint, apiBase, emptyForm, toForm, toPayload?, required?, validate? })`
   runs the whole records flow: load the list, open for create (`openCreate`) or read

package/frontend/ui/index.d.ts

@@ -11,7 +11,7 @@ export { Skeleton, SkeletonRow } from './Skeleton.js';
 export { RecordDialog, type RecordDialogMode, type RecordDialogProps } from './RecordDialog.js';
 export { ConfirmDeleteDialog, type ConfirmDeleteDialogProps } from './ConfirmDeleteDialog.js';
 export { useRecords, type UseRecordsResult } from './useRecords.js';
-export { createRecordsController, type RecordsController, type RecordsOptions, type RecordsState, type RecordsSaveMode, } from './records.js';
+export { createRecordsController, type RecordsController, type RecordsOptions, type RecordsState, type RecordsSaveMode, type RecordsDialogMode, } from './records.js';
 export { useIsMobile, MOBILE_QUERY } from '../useIsMobile.js';
 export { DataTable, DEFAULT_VIEW_VERSION, type ColumnDef, type FilterDef, type DataTableSelectionProps, } from './DataTable.js';
 export { toCsv, toXlsx, downloadFile, type ExportCell, type ExportTable } from './tableExport.js';

package/frontend/ui/records.d.ts

@@ -1,4 +1,5 @@
 export type RecordsSaveMode = 'create' | 'edit';
+export type RecordsDialogMode = 'read' | 'edit' | 'create';
 export interface RecordsOptions<T, F> {
     endpoint: string;
     apiBase: string | (() => string);
@@ -8,6 +9,8 @@ export interface RecordsOptions<T, F> {
     required?: ReadonlyArray<keyof F>;
     validate?: (form: F, mode: RecordsSaveMode) => string | null | undefined;
     getId?: (row: T) => string;
+    editable?: boolean;
+    openIn?: 'read' | 'edit';
     updateMethod?: 'PUT' | 'PATCH';
     fetchImpl?: typeof fetch;
 }
@@ -19,6 +22,7 @@ export interface RecordsState<T, F> {
         id: string;
         item?: T;
     } | null;
+    mode: RecordsDialogMode;
     form: F;
     saving: boolean;
     saveError: string;
@@ -35,6 +39,7 @@ export interface RecordsController<T, F> {
     openCreate(): void;
     openRecord(row: T): void;
     close(): void;
+    setMode(mode: RecordsDialogMode): void;
     setForm(next: F | ((prev: F) => F)): void;
     setField<K extends keyof F>(key: K, value: F[K]): void;
     isComplete(): boolean;

package/frontend/ui/records.js

@@ -30,6 +30,7 @@ export function createRecordsController(initial) {
         loading: true,
         loadError: '',
         open: null,
+        mode: 'read',
         form: initial.emptyForm(),
         saving: false,
         saveError: '',
@@ -110,6 +111,10 @@ export function createRecordsController(initial) {
         const open = state.open;
         if (!open)
             return;
+        if (mode === 'edit' && options.editable === false) {
+            set({ saveError: 'Keine Berechtigung zum Ändern.' });
+            return;
+        }
         if (!isComplete()) {
             set({ saveError: 'Bitte alle Pflichtfelder ausfüllen.' });
             return;
@@ -195,7 +200,7 @@ export function createRecordsController(initial) {
             set({ loadError: '' });
         },
         openCreate() {
-            set({ open: { id: NEW_ID }, form: options.emptyForm(), saveError: '' });
+            set({ open: { id: NEW_ID }, mode: 'create', form: options.emptyForm(), saveError: '' });
         },
         openRecord(row) {
             const id = tryId(row);
@@ -204,11 +209,17 @@ export function createRecordsController(initial) {
                 set({ loadError: NO_ID });
                 return;
             }
-            set({ open: { id, item: row }, form: options.toForm(row), saveError: '' });
+            const mode = options.openIn === 'edit' && options.editable !== false ? 'edit' : 'read';
+            set({ open: { id, item: row }, mode, form: options.toForm(row), saveError: '' });
         },
         close() {
             set({ open: null, saveError: '' });
         },
+        setMode(mode) {
+            if (mode !== 'edit' || options.editable === false || !state.open?.item || state.mode === 'edit')
+                return;
+            set({ mode: 'edit' });
+        },
         setForm(next) {
             const form = typeof next === 'function' ? next(state.form) : next;
             set({ form });

package/frontend/ui/useRecords.d.ts

@@ -14,7 +14,7 @@ export interface UseRecordsResult<T, F> {
     openCreate(): void;
     openRecord(row: T): void;
     close(): void;
-    dialogProps: Pick<RecordDialogProps, 'open' | 'onOpenChange' | 'onSave' | 'saving' | 'saveDisabled' | 'error' | 'onErrorDismiss'>;
+    dialogProps: Pick<RecordDialogProps, 'open' | 'onOpenChange' | 'mode' | 'onModeChange' | 'readOnly' | 'onSave' | 'saving' | 'saveDisabled' | 'error' | 'onErrorDismiss'>;
     requestDelete(row: T): void;
     deleteTarget: T | null;
     deleteDialogProps: Pick<ConfirmDeleteDialogProps, 'open' | 'deleting' | 'error' | 'onConfirm' | 'onCancel' | 'onErrorDismiss'>;

package/frontend/ui/useRecords.js

@@ -10,6 +10,7 @@ export function useRecords(options) {
     }, [controller, options.endpoint]);
     const state = useSyncExternalStore(controller.subscribe, controller.getState, controller.getState);
     const complete = requiredFilled(state.form, options.required);
+    const readOnly = options.editable === false;
     return useMemo(() => ({
         rows: state.rows,
         loading: state.loading,
@@ -29,6 +30,9 @@ export function useRecords(options) {
                 if (!next)
                     controller.close();
             },
+            mode: readOnly && state.mode === 'edit' ? 'read' : state.mode,
+            onModeChange: controller.setMode,
+            readOnly,
             onSave: controller.save,
             saving: state.saving,
             saveDisabled: !complete,
@@ -45,5 +49,5 @@ export function useRecords(options) {
             onCancel: controller.cancelDelete,
             onErrorDismiss: controller.dismissDeleteError,
         },
-    }), [controller, state, complete]);
+    }), [controller, state, complete, readOnly]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@efa-one/sdk",
-  "version": "1.26.0",
+  "version": "1.27.0",
   "description": "Offizielles SDK für efa-one-Apps: Auth/Session, Service-Discovery, Gateway-Client, Audit/Reporting/Mail/Notifications, Permission- und Capability-Registrierung sowie das Frontend-IPC-/i18n-Toolkit.",
   "license": "Apache-2.0",
   "type": "commonjs",