@nubitio/crud 0.5.16 → 0.5.20

package/dist/index.cjs

@@ -62,6 +62,17 @@ function defineResource(apiUrl, overrides) {
 	return resource;
 }
 //#endregion
+//#region packages/crud/crud/embeddedLinesUrl.ts
+/**
+* Builds a formDetail reload URL for {@code #[EmbeddedLines]} line entities.
+*
+* @example embeddedLinesUrl('/api/sales_document_lines', 'document')
+*          → '/api/sales_document_lines?document={id}'
+*/
+function embeddedLinesUrl(route, parentQueryParam) {
+	return `${route}${route.includes("?") ? "&" : "?"}${parentQueryParam}={id}`;
+}
+//#endregion
 //#region packages/crud/datagrid/DataGridEvents.ts
 const DATA_GRID_EVENTS = {
 	SELECTION_CHANGED: "datagrid:selection.changed",
@@ -3588,6 +3599,17 @@ function normalizeEntityField(row, field, adapter, prependDataByField) {
 	}
 }
 //#endregion
+//#region packages/crud/form/loadDetailRows.ts
+/**
+* Loads embedded line rows for formDetail edit mode. Accepts both plain JSON
+* arrays (nubit embedded-lines endpoint) and Hydra collections.
+*/
+async function loadDetailRows(httpClient, detailUrl, adapter) {
+	const response = await httpClient.get(detailUrl);
+	const { items } = (adapter ?? HydraAdapter).parseListResponse(response.data);
+	return items;
+}
+//#endregion
 //#region packages/crud/form/safeRandomId.ts
 /**
 * Generate a unique-enough id string for internal React keys.
@@ -4648,7 +4670,7 @@ const NativeFormView = (0, react.forwardRef)((options, ref) => {
 		const detailUrl = typeof detailId === "string" || typeof detailId === "number" ? options.detailUrl?.replace("{id}", String(detailId)) : void 0;
 		if (!detailUrl) return;
 		emit(FORM_EVENTS.LOADING, true);
-		httpClient.get(detailUrl).then((response) => setNextDetailRows(response.data)).finally(() => emit(FORM_EVENTS.LOADING, false));
+		loadDetailRows(httpClient, detailUrl, options.adapter).then((rows) => setNextDetailRows(rows)).finally(() => emit(FORM_EVENTS.LOADING, false));
 	}, [
 		captureExistingMedia,
 		emit,
@@ -7444,14 +7466,15 @@ function ResourceSchemaProvider({ children, resolver }) {
 		children
 	});
 }
-function resolveWithRuntimeErrors(resolver, supportedOperations = [], formLayout) {
+function resolveWithRuntimeErrors(resolver, supportedOperations = [], formLayout, workflow) {
 	try {
 		return {
 			fields: resolver(),
 			isLoading: false,
 			error: void 0,
 			supportedOperations,
-			formLayout
+			formLayout,
+			workflow
 		};
 	} catch (runtimeError) {
 		return {
@@ -7459,7 +7482,8 @@ function resolveWithRuntimeErrors(resolver, supportedOperations = [], formLayout
 			isLoading: false,
 			error: runtimeError instanceof Error ? runtimeError : new Error(String(runtimeError)),
 			supportedOperations,
-			formLayout
+			formLayout,
+			workflow
 		};
 	}
 }
@@ -7485,7 +7509,7 @@ function useResolvedResourceFields({ apiUrl, manualFields, overrides, fieldContr
 			baselineFields: baseline.fields,
 			contract: fieldContract,
 			legacyOverrides: fieldContract ? void 0 : overrides
-		}), baseline.supportedOperations, baseline.formLayout);
+		}), baseline.supportedOperations, baseline.formLayout, baseline.workflow);
 	}, [
 		baseline,
 		fieldContract,
@@ -7493,6 +7517,28 @@ function useResolvedResourceFields({ apiUrl, manualFields, overrides, fieldContr
 	]);
 }
 //#endregion
+//#region packages/crud/workflow/buildWorkflowRowActions.ts
+function buildWorkflowRowActions(row, workflow, apiUrl, roles, onDone) {
+	if (!workflow) return [];
+	const current = String(row[workflow.field] ?? "");
+	return workflow.transitions.filter((transition) => transition.from.includes(current)).filter((transition) => !transition.roles?.length || transition.roles.some((role) => roles.includes(role))).map((transition) => ({
+		text: transition.label ?? transition.name,
+		onClick: async () => {
+			const base = apiUrl.replace(/\/$/, "");
+			const id = row.id;
+			const response = await fetch(`${base}/${id}/transition/${transition.name}`, {
+				method: "POST",
+				credentials: "include"
+			});
+			if (!response.ok) {
+				const detail = await response.text().catch(() => "");
+				throw new Error(detail || `Transition "${transition.name}" failed (${response.status})`);
+			}
+			onDone?.();
+		}
+	}));
+}
+//#endregion
 //#region packages/crud/crud/SmartCrudPage.tsx
 function CrudSkeleton() {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -7565,7 +7611,7 @@ function SmartCrudPage({ resource, fieldOverrides, formRef, onSelectionChanged,
 	const effectiveGridRef = gridRef ?? internalGridRef;
 	const resolvedBaseResource = (0, react.useMemo)(() => resolveCrudResource(resource), [resource]);
 	const hasManualFields = !resource.fieldContract && Array.isArray(resource.fields) && resource.fields.length > 0;
-	const { fields, isLoading, error, supportedOperations, formLayout: inferredFormLayout } = useResolvedResourceFields({
+	const { fields, isLoading, error, supportedOperations, formLayout: inferredFormLayout, workflow } = useResolvedResourceFields({
 		apiUrl: resolvedBaseResource.apiUrl,
 		manualFields: hasManualFields ? buildFields(resource.fields) : void 0,
 		overrides: hasManualFields ? void 0 : fieldOverrides,
@@ -7589,21 +7635,29 @@ function SmartCrudPage({ resource, fieldOverrides, formRef, onSelectionChanged,
 	const routingState = useRouting(resource.routing);
 	const { activeOperation, formData, handleFormDataChange, startCreate, startEdit, resetOperation } = useSmartCrudOperation(void 0, routingState);
 	const roles = useSmartCrudRoles();
-	const { gridFields, processedFields, computedValues } = useSmartCrudFields(fields, activeOperation, formData, (0, react.useMemo)(() => roles ?? [], [roles]));
+	const stableRoles = (0, react.useMemo)(() => roles ?? [], [roles]);
+	const { gridFields, processedFields, computedValues } = useSmartCrudFields(fields, activeOperation, formData, stableRoles);
 	const formFields = (0, react.useMemo)(() => applyFormDetailFormFieldOverrides(processedFields, resolvedBaseResource.formDetail), [processedFields, resolvedBaseResource.formDetail]);
 	(0, _nubitio_core.useMercureSubscription)(resource.apiUrl, () => {
 		effectiveGridRef.current?.refresh();
 	}, resolvedBaseResource.mercure !== false);
 	const normalizedApiUrl = resolvedBaseResource.apiUrl.startsWith("/") ? resolvedBaseResource.apiUrl : `/${resolvedBaseResource.apiUrl}`;
-	const resolvedResource = (0, react.useMemo)(() => ({
-		...resolvedBaseResource,
-		...!hasManualFields ? { fields: gridFields } : {},
-		apiUrl: normalizedApiUrl,
-		fields: hasManualFields ? buildFields(resource.fields) : gridFields,
-		formFields,
-		formLayout: resolvedBaseResource.formLayout ?? inferredFormLayout,
-		_supportedOperations: supportedOperations
-	}), [
+	const resolvedResource = (0, react.useMemo)(() => {
+		const rowActions = resolvedBaseResource.rowActions ?? (workflow ? (row) => buildWorkflowRowActions(row, workflow, normalizedApiUrl, stableRoles, () => {
+			effectiveGridRef.current?.refresh();
+		}) : void 0);
+		return {
+			...resolvedBaseResource,
+			...!hasManualFields ? { fields: gridFields } : {},
+			apiUrl: normalizedApiUrl,
+			fields: hasManualFields ? buildFields(resource.fields) : gridFields,
+			formFields,
+			formLayout: resolvedBaseResource.formLayout ?? inferredFormLayout,
+			_supportedOperations: supportedOperations,
+			rowActions
+		};
+	}, [
+		effectiveGridRef,
 		fields,
 		gridFields,
 		hasManualFields,
@@ -7612,7 +7666,9 @@ function SmartCrudPage({ resource, fieldOverrides, formRef, onSelectionChanged,
 		formFields,
 		resolvedBaseResource,
 		resource.fields,
-		supportedOperations
+		stableRoles,
+		supportedOperations,
+		workflow
 	]);
 	if (!hasManualFields && isLoading) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CrudSkeleton, {});
 	if (!hasManualFields && error) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CrudError, {
@@ -8617,6 +8673,7 @@ exports.SmartCrudRolesProvider = SmartCrudRolesProvider;
 exports.ToolbarSelect = ToolbarSelect;
 exports.buildFieldColSpanContext = buildFieldColSpanContext;
 exports.buildFields = buildFields;
+exports.buildWorkflowRowActions = buildWorkflowRowActions;
 exports.checkboxField = checkboxField;
 exports.computeSummaryValue = computeSummaryValue;
 Object.defineProperty(exports, "createCrudEvents", {
@@ -8633,6 +8690,7 @@ exports.datetimeField = datetimeField;
 exports.defineFieldContract = defineFieldContract;
 exports.defineFields = defineFields;
 exports.defineResource = defineResource;
+exports.embeddedLinesUrl = embeddedLinesUrl;
 exports.entityField = entityField;
 exports.enumField = enumField;
 exports.fileField = fileField;

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import React, { ReactElement, ReactNode, RefObject } from "react";
 import { CoreHttpClient, DataGridEventNames, DataRecord, DataRecord as DataRecord$1, DialogEventNames, FormEventNames, GridData, GridData as GridData$1, createCrudEvents } from "@nubitio/core";
 import { AppDropdownOption } from "@nubitio/ui";
+import { WorkflowSchema } from "@nubitio/hydra";
 
 //#region packages/crud/field/FieldType.d.ts
 declare enum FieldType {
@@ -1013,6 +1014,15 @@ declare function defineResource<T extends DataRecord$1>(apiUrl: string, override
   id?: string;
 }): ResourceConfig<T>;
 //#endregion
+//#region packages/crud/crud/embeddedLinesUrl.d.ts
+/**
+ * Builds a formDetail reload URL for {@code #[EmbeddedLines]} line entities.
+ *
+ * @example embeddedLinesUrl('/api/sales_document_lines', 'document')
+ *          → '/api/sales_document_lines?document={id}'
+ */
+declare function embeddedLinesUrl(route: string, parentQueryParam: string): string;
+//#endregion
 //#region packages/crud/crud/CrudPage.d.ts
 interface CrudPageProps<T extends DataRecord$1 = DataRecord$1> {
   resource: ResourceConfig<T>;
@@ -1867,6 +1877,9 @@ interface ColumnPresetState {
 }
 declare function useColumnPreset(resource: ResourceConfig): ColumnPresetState;
 //#endregion
+//#region packages/crud/workflow/buildWorkflowRowActions.d.ts
+declare function buildWorkflowRowActions<T extends DataRecord$1 = DataRecord$1>(row: T, workflow: WorkflowSchema | undefined, apiUrl: string, roles: string[], onDone?: () => void): ResourceToolbarAction[];
+//#endregion
 //#region packages/crud/adapter/HydraAdapter.d.ts
 /**
  * Default backend adapter for API Platform / JSON-LD + Hydra backends.
@@ -1905,6 +1918,7 @@ interface ResourceSchemaResolution {
    * resource publishes one. Explicit `ResourceConfig.formLayout` wins.
    */
   formLayout?: FormLayout;
+  workflow?: WorkflowSchema;
 }
 interface ResourceSchemaResolver {
   useResourceSchema(request: ResourceSchemaRequest): ResourceSchemaResolution;
@@ -1999,4 +2013,4 @@ interface RestQueryDialect {
  */
 declare function createRestResourceStore(dialect?: RestQueryDialect): ResourceStoreFactory;
 //#endregion
-export { type AuditEntry, type AuditFieldLabelResolver, type AuditTrailConfig, AuditTrailPanel, type AuditTrailPanelProps, type BackendAdapter, type BulkAction, type ColSpan, type ColumnPreset, ColumnPresetSelector, type ColumnPresetState, CrudDialogShell, CrudDrawerShell, type CrudDrawerSize, type CrudDrawerViewEvents, type CrudDrawerViewOptions, CrudFormShell, type CrudFormShellProps, CrudPage, CrudPageShell, type CrudPageViewEvents, type CrudPageViewOptions, type CrudViewMode, type CrudViewModeConfig, DATA_GRID_EVENTS, DEFAULT_DRAWER_SIZE, DEFAULT_DRAWER_WIDTH, DRAWER_WIDTHS, type DataGridSelectionChangedEvent, type DataGridSummaryItem, NativeDataGridView as DataGridView, type DataGridViewOptions, type DataRecord, type DetailSummaryOptions, CrudDialogView as DialogView, type DrawerSize, CrudDrawerView as DrawerView, type EnumOption, FORM_EVENTS, type Field, FieldBuilder, type FieldColSpanContext, type FieldDef, type FieldInput, type FieldOverride, FieldType, type FilterRule, type FormHandle, type FormLayout, type FormLayoutHint, type FormOnChangeFn, type FormPresentationContext, type FormPresentationMode, type FormSection, type FormTab, NativeFormView as FormView, type FormViewOptions, type FormatterFn, type GridCellContext, type GridData, type GridHandle, type GridOnChangeFn, HydraAdapter, type ItemFormatterFn, type LoadOption, type OnChangeFn, CrudPageView as PageView, type ResolvedViewMode, type ResourceConfig, type ResourceEmptyState, type ResourceFilterDescriptor, type ResourceFilterRule, type ResourceFormDetail, type ResourceGridDetail, type ResourceLoadOption, type ResourceLoadOptions, type ResourcePermissions, type ResourceRouting, type ResourceRowActions, ResourceSchemaProvider, type ResourceSchemaProviderProps, type ResourceSchemaResolution, type ResourceSchemaResolver, type ResourceSortDescriptor, type ResourceStore, type ResourceStoreFactory, type ResourceStoreOptions, ResourceStoreProvider, type ResourceStoreProviderProps, type ResourceToolbar, type ResourceToolbarAction, type ResourceToolbarActionVariant, type ResourceToolbarContext, type ResourceToolbarItems, RestAdapter, type RestQueryDialect, type SmartCrudFieldContract, type SmartCrudFieldOperation, type SmartCrudFieldPatch, type SmartCrudHydraFieldContract, type SmartCrudHydraFieldDirective, type SmartCrudManualField, type SmartCrudManualFieldContract, type SmartCrudOperation, SmartCrudPage, SmartCrudRolesProvider, type SummaryCalculateContext, type SummaryFormat, type SummaryItem, type SummaryTextContext, type SummaryType, ToolbarSelect, type ToolbarSelectOption, type ToolbarSelectProps, type ValidationRule, buildFieldColSpanContext, buildFields, checkboxField, computeSummaryValue, createCrudEvents, createRestResourceStore, crudRoute, currencyField, dateField, datetimeField, defineFieldContract, defineFields, defineResource, entityField, enumField, fileField, formatSummaryValue, identityField, imageField, isLongTextField, isShortField, noneField, numberField, parseDrawerWidthPx, passwordField, resolveDrawerLayoutBucket, resolveDrawerSize, resolveDrawerWidth, resolveFieldColSpan, resolveFieldsColSpans, resolveSummaryText, resolveViewMode, selectField, switchField, textField, textareaField, useColumnPreset, useResourceStoreFactory, useSmartCrudRoles, validateFieldContract };
+export { type AuditEntry, type AuditFieldLabelResolver, type AuditTrailConfig, AuditTrailPanel, type AuditTrailPanelProps, type BackendAdapter, type BulkAction, type ColSpan, type ColumnPreset, ColumnPresetSelector, type ColumnPresetState, CrudDialogShell, CrudDrawerShell, type CrudDrawerSize, type CrudDrawerViewEvents, type CrudDrawerViewOptions, CrudFormShell, type CrudFormShellProps, CrudPage, CrudPageShell, type CrudPageViewEvents, type CrudPageViewOptions, type CrudViewMode, type CrudViewModeConfig, DATA_GRID_EVENTS, DEFAULT_DRAWER_SIZE, DEFAULT_DRAWER_WIDTH, DRAWER_WIDTHS, type DataGridSelectionChangedEvent, type DataGridSummaryItem, NativeDataGridView as DataGridView, type DataGridViewOptions, type DataRecord, type DetailSummaryOptions, CrudDialogView as DialogView, type DrawerSize, CrudDrawerView as DrawerView, type EnumOption, FORM_EVENTS, type Field, FieldBuilder, type FieldColSpanContext, type FieldDef, type FieldInput, type FieldOverride, FieldType, type FilterRule, type FormHandle, type FormLayout, type FormLayoutHint, type FormOnChangeFn, type FormPresentationContext, type FormPresentationMode, type FormSection, type FormTab, NativeFormView as FormView, type FormViewOptions, type FormatterFn, type GridCellContext, type GridData, type GridHandle, type GridOnChangeFn, HydraAdapter, type ItemFormatterFn, type LoadOption, type OnChangeFn, CrudPageView as PageView, type ResolvedViewMode, type ResourceConfig, type ResourceEmptyState, type ResourceFilterDescriptor, type ResourceFilterRule, type ResourceFormDetail, type ResourceGridDetail, type ResourceLoadOption, type ResourceLoadOptions, type ResourcePermissions, type ResourceRouting, type ResourceRowActions, ResourceSchemaProvider, type ResourceSchemaProviderProps, type ResourceSchemaResolution, type ResourceSchemaResolver, type ResourceSortDescriptor, type ResourceStore, type ResourceStoreFactory, type ResourceStoreOptions, ResourceStoreProvider, type ResourceStoreProviderProps, type ResourceToolbar, type ResourceToolbarAction, type ResourceToolbarActionVariant, type ResourceToolbarContext, type ResourceToolbarItems, RestAdapter, type RestQueryDialect, type SmartCrudFieldContract, type SmartCrudFieldOperation, type SmartCrudFieldPatch, type SmartCrudHydraFieldContract, type SmartCrudHydraFieldDirective, type SmartCrudManualField, type SmartCrudManualFieldContract, type SmartCrudOperation, SmartCrudPage, SmartCrudRolesProvider, type SummaryCalculateContext, type SummaryFormat, type SummaryItem, type SummaryTextContext, type SummaryType, ToolbarSelect, type ToolbarSelectOption, type ToolbarSelectProps, type ValidationRule, buildFieldColSpanContext, buildFields, buildWorkflowRowActions, checkboxField, computeSummaryValue, createCrudEvents, createRestResourceStore, crudRoute, currencyField, dateField, datetimeField, defineFieldContract, defineFields, defineResource, embeddedLinesUrl, entityField, enumField, fileField, formatSummaryValue, identityField, imageField, isLongTextField, isShortField, noneField, numberField, parseDrawerWidthPx, passwordField, resolveDrawerLayoutBucket, resolveDrawerSize, resolveDrawerWidth, resolveFieldColSpan, resolveFieldsColSpans, resolveSummaryText, resolveViewMode, selectField, switchField, textField, textareaField, useColumnPreset, useResourceStoreFactory, useSmartCrudRoles, validateFieldContract };

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import React, { ReactElement, ReactNode, RefObject } from "react";
 import { AppDropdownOption } from "@nubitio/ui";
 import { CoreHttpClient, DataGridEventNames, DataRecord, DataRecord as DataRecord$1, DialogEventNames, FormEventNames, GridData, GridData as GridData$1, createCrudEvents } from "@nubitio/core";
+import { WorkflowSchema } from "@nubitio/hydra";
 
 //#region packages/crud/field/FieldType.d.ts
 declare enum FieldType {
@@ -1013,6 +1014,15 @@ declare function defineResource<T extends DataRecord$1>(apiUrl: string, override
   id?: string;
 }): ResourceConfig<T>;
 //#endregion
+//#region packages/crud/crud/embeddedLinesUrl.d.ts
+/**
+ * Builds a formDetail reload URL for {@code #[EmbeddedLines]} line entities.
+ *
+ * @example embeddedLinesUrl('/api/sales_document_lines', 'document')
+ *          → '/api/sales_document_lines?document={id}'
+ */
+declare function embeddedLinesUrl(route: string, parentQueryParam: string): string;
+//#endregion
 //#region packages/crud/crud/CrudPage.d.ts
 interface CrudPageProps<T extends DataRecord$1 = DataRecord$1> {
   resource: ResourceConfig<T>;
@@ -1867,6 +1877,9 @@ interface ColumnPresetState {
 }
 declare function useColumnPreset(resource: ResourceConfig): ColumnPresetState;
 //#endregion
+//#region packages/crud/workflow/buildWorkflowRowActions.d.ts
+declare function buildWorkflowRowActions<T extends DataRecord$1 = DataRecord$1>(row: T, workflow: WorkflowSchema | undefined, apiUrl: string, roles: string[], onDone?: () => void): ResourceToolbarAction[];
+//#endregion
 //#region packages/crud/adapter/HydraAdapter.d.ts
 /**
  * Default backend adapter for API Platform / JSON-LD + Hydra backends.
@@ -1905,6 +1918,7 @@ interface ResourceSchemaResolution {
    * resource publishes one. Explicit `ResourceConfig.formLayout` wins.
    */
   formLayout?: FormLayout;
+  workflow?: WorkflowSchema;
 }
 interface ResourceSchemaResolver {
   useResourceSchema(request: ResourceSchemaRequest): ResourceSchemaResolution;
@@ -1999,4 +2013,4 @@ interface RestQueryDialect {
  */
 declare function createRestResourceStore(dialect?: RestQueryDialect): ResourceStoreFactory;
 //#endregion
-export { type AuditEntry, type AuditFieldLabelResolver, type AuditTrailConfig, AuditTrailPanel, type AuditTrailPanelProps, type BackendAdapter, type BulkAction, type ColSpan, type ColumnPreset, ColumnPresetSelector, type ColumnPresetState, CrudDialogShell, CrudDrawerShell, type CrudDrawerSize, type CrudDrawerViewEvents, type CrudDrawerViewOptions, CrudFormShell, type CrudFormShellProps, CrudPage, CrudPageShell, type CrudPageViewEvents, type CrudPageViewOptions, type CrudViewMode, type CrudViewModeConfig, DATA_GRID_EVENTS, DEFAULT_DRAWER_SIZE, DEFAULT_DRAWER_WIDTH, DRAWER_WIDTHS, type DataGridSelectionChangedEvent, type DataGridSummaryItem, NativeDataGridView as DataGridView, type DataGridViewOptions, type DataRecord, type DetailSummaryOptions, CrudDialogView as DialogView, type DrawerSize, CrudDrawerView as DrawerView, type EnumOption, FORM_EVENTS, type Field, FieldBuilder, type FieldColSpanContext, type FieldDef, type FieldInput, type FieldOverride, FieldType, type FilterRule, type FormHandle, type FormLayout, type FormLayoutHint, type FormOnChangeFn, type FormPresentationContext, type FormPresentationMode, type FormSection, type FormTab, NativeFormView as FormView, type FormViewOptions, type FormatterFn, type GridCellContext, type GridData, type GridHandle, type GridOnChangeFn, HydraAdapter, type ItemFormatterFn, type LoadOption, type OnChangeFn, CrudPageView as PageView, type ResolvedViewMode, type ResourceConfig, type ResourceEmptyState, type ResourceFilterDescriptor, type ResourceFilterRule, type ResourceFormDetail, type ResourceGridDetail, type ResourceLoadOption, type ResourceLoadOptions, type ResourcePermissions, type ResourceRouting, type ResourceRowActions, ResourceSchemaProvider, type ResourceSchemaProviderProps, type ResourceSchemaResolution, type ResourceSchemaResolver, type ResourceSortDescriptor, type ResourceStore, type ResourceStoreFactory, type ResourceStoreOptions, ResourceStoreProvider, type ResourceStoreProviderProps, type ResourceToolbar, type ResourceToolbarAction, type ResourceToolbarActionVariant, type ResourceToolbarContext, type ResourceToolbarItems, RestAdapter, type RestQueryDialect, type SmartCrudFieldContract, type SmartCrudFieldOperation, type SmartCrudFieldPatch, type SmartCrudHydraFieldContract, type SmartCrudHydraFieldDirective, type SmartCrudManualField, type SmartCrudManualFieldContract, type SmartCrudOperation, SmartCrudPage, SmartCrudRolesProvider, type SummaryCalculateContext, type SummaryFormat, type SummaryItem, type SummaryTextContext, type SummaryType, ToolbarSelect, type ToolbarSelectOption, type ToolbarSelectProps, type ValidationRule, buildFieldColSpanContext, buildFields, checkboxField, computeSummaryValue, createCrudEvents, createRestResourceStore, crudRoute, currencyField, dateField, datetimeField, defineFieldContract, defineFields, defineResource, entityField, enumField, fileField, formatSummaryValue, identityField, imageField, isLongTextField, isShortField, noneField, numberField, parseDrawerWidthPx, passwordField, resolveDrawerLayoutBucket, resolveDrawerSize, resolveDrawerWidth, resolveFieldColSpan, resolveFieldsColSpans, resolveSummaryText, resolveViewMode, selectField, switchField, textField, textareaField, useColumnPreset, useResourceStoreFactory, useSmartCrudRoles, validateFieldContract };
+export { type AuditEntry, type AuditFieldLabelResolver, type AuditTrailConfig, AuditTrailPanel, type AuditTrailPanelProps, type BackendAdapter, type BulkAction, type ColSpan, type ColumnPreset, ColumnPresetSelector, type ColumnPresetState, CrudDialogShell, CrudDrawerShell, type CrudDrawerSize, type CrudDrawerViewEvents, type CrudDrawerViewOptions, CrudFormShell, type CrudFormShellProps, CrudPage, CrudPageShell, type CrudPageViewEvents, type CrudPageViewOptions, type CrudViewMode, type CrudViewModeConfig, DATA_GRID_EVENTS, DEFAULT_DRAWER_SIZE, DEFAULT_DRAWER_WIDTH, DRAWER_WIDTHS, type DataGridSelectionChangedEvent, type DataGridSummaryItem, NativeDataGridView as DataGridView, type DataGridViewOptions, type DataRecord, type DetailSummaryOptions, CrudDialogView as DialogView, type DrawerSize, CrudDrawerView as DrawerView, type EnumOption, FORM_EVENTS, type Field, FieldBuilder, type FieldColSpanContext, type FieldDef, type FieldInput, type FieldOverride, FieldType, type FilterRule, type FormHandle, type FormLayout, type FormLayoutHint, type FormOnChangeFn, type FormPresentationContext, type FormPresentationMode, type FormSection, type FormTab, NativeFormView as FormView, type FormViewOptions, type FormatterFn, type GridCellContext, type GridData, type GridHandle, type GridOnChangeFn, HydraAdapter, type ItemFormatterFn, type LoadOption, type OnChangeFn, CrudPageView as PageView, type ResolvedViewMode, type ResourceConfig, type ResourceEmptyState, type ResourceFilterDescriptor, type ResourceFilterRule, type ResourceFormDetail, type ResourceGridDetail, type ResourceLoadOption, type ResourceLoadOptions, type ResourcePermissions, type ResourceRouting, type ResourceRowActions, ResourceSchemaProvider, type ResourceSchemaProviderProps, type ResourceSchemaResolution, type ResourceSchemaResolver, type ResourceSortDescriptor, type ResourceStore, type ResourceStoreFactory, type ResourceStoreOptions, ResourceStoreProvider, type ResourceStoreProviderProps, type ResourceToolbar, type ResourceToolbarAction, type ResourceToolbarActionVariant, type ResourceToolbarContext, type ResourceToolbarItems, RestAdapter, type RestQueryDialect, type SmartCrudFieldContract, type SmartCrudFieldOperation, type SmartCrudFieldPatch, type SmartCrudHydraFieldContract, type SmartCrudHydraFieldDirective, type SmartCrudManualField, type SmartCrudManualFieldContract, type SmartCrudOperation, SmartCrudPage, SmartCrudRolesProvider, type SummaryCalculateContext, type SummaryFormat, type SummaryItem, type SummaryTextContext, type SummaryType, ToolbarSelect, type ToolbarSelectOption, type ToolbarSelectProps, type ValidationRule, buildFieldColSpanContext, buildFields, buildWorkflowRowActions, checkboxField, computeSummaryValue, createCrudEvents, createRestResourceStore, crudRoute, currencyField, dateField, datetimeField, defineFieldContract, defineFields, defineResource, embeddedLinesUrl, entityField, enumField, fileField, formatSummaryValue, identityField, imageField, isLongTextField, isShortField, noneField, numberField, parseDrawerWidthPx, passwordField, resolveDrawerLayoutBucket, resolveDrawerSize, resolveDrawerWidth, resolveFieldColSpan, resolveFieldsColSpans, resolveSummaryText, resolveViewMode, selectField, switchField, textField, textareaField, useColumnPreset, useResourceStoreFactory, useSmartCrudRoles, validateFieldContract };

package/dist/index.mjs

@@ -38,6 +38,17 @@ function defineResource(apiUrl, overrides) {
 	return resource;
 }
 //#endregion
+//#region packages/crud/crud/embeddedLinesUrl.ts
+/**
+* Builds a formDetail reload URL for {@code #[EmbeddedLines]} line entities.
+*
+* @example embeddedLinesUrl('/api/sales_document_lines', 'document')
+*          → '/api/sales_document_lines?document={id}'
+*/
+function embeddedLinesUrl(route, parentQueryParam) {
+	return `${route}${route.includes("?") ? "&" : "?"}${parentQueryParam}={id}`;
+}
+//#endregion
 //#region packages/crud/datagrid/DataGridEvents.ts
 const DATA_GRID_EVENTS = {
 	SELECTION_CHANGED: "datagrid:selection.changed",
@@ -3564,6 +3575,17 @@ function normalizeEntityField(row, field, adapter, prependDataByField) {
 	}
 }
 //#endregion
+//#region packages/crud/form/loadDetailRows.ts
+/**
+* Loads embedded line rows for formDetail edit mode. Accepts both plain JSON
+* arrays (nubit embedded-lines endpoint) and Hydra collections.
+*/
+async function loadDetailRows(httpClient, detailUrl, adapter) {
+	const response = await httpClient.get(detailUrl);
+	const { items } = (adapter ?? HydraAdapter).parseListResponse(response.data);
+	return items;
+}
+//#endregion
 //#region packages/crud/form/safeRandomId.ts
 /**
 * Generate a unique-enough id string for internal React keys.
@@ -4624,7 +4646,7 @@ const NativeFormView = forwardRef((options, ref) => {
 		const detailUrl = typeof detailId === "string" || typeof detailId === "number" ? options.detailUrl?.replace("{id}", String(detailId)) : void 0;
 		if (!detailUrl) return;
 		emit(FORM_EVENTS.LOADING, true);
-		httpClient.get(detailUrl).then((response) => setNextDetailRows(response.data)).finally(() => emit(FORM_EVENTS.LOADING, false));
+		loadDetailRows(httpClient, detailUrl, options.adapter).then((rows) => setNextDetailRows(rows)).finally(() => emit(FORM_EVENTS.LOADING, false));
 	}, [
 		captureExistingMedia,
 		emit,
@@ -7420,14 +7442,15 @@ function ResourceSchemaProvider({ children, resolver }) {
 		children
 	});
 }
-function resolveWithRuntimeErrors(resolver, supportedOperations = [], formLayout) {
+function resolveWithRuntimeErrors(resolver, supportedOperations = [], formLayout, workflow) {
 	try {
 		return {
 			fields: resolver(),
 			isLoading: false,
 			error: void 0,
 			supportedOperations,
-			formLayout
+			formLayout,
+			workflow
 		};
 	} catch (runtimeError) {
 		return {
@@ -7435,7 +7458,8 @@ function resolveWithRuntimeErrors(resolver, supportedOperations = [], formLayout
 			isLoading: false,
 			error: runtimeError instanceof Error ? runtimeError : new Error(String(runtimeError)),
 			supportedOperations,
-			formLayout
+			formLayout,
+			workflow
 		};
 	}
 }
@@ -7461,7 +7485,7 @@ function useResolvedResourceFields({ apiUrl, manualFields, overrides, fieldContr
 			baselineFields: baseline.fields,
 			contract: fieldContract,
 			legacyOverrides: fieldContract ? void 0 : overrides
-		}), baseline.supportedOperations, baseline.formLayout);
+		}), baseline.supportedOperations, baseline.formLayout, baseline.workflow);
 	}, [
 		baseline,
 		fieldContract,
@@ -7469,6 +7493,28 @@ function useResolvedResourceFields({ apiUrl, manualFields, overrides, fieldContr
 	]);
 }
 //#endregion
+//#region packages/crud/workflow/buildWorkflowRowActions.ts
+function buildWorkflowRowActions(row, workflow, apiUrl, roles, onDone) {
+	if (!workflow) return [];
+	const current = String(row[workflow.field] ?? "");
+	return workflow.transitions.filter((transition) => transition.from.includes(current)).filter((transition) => !transition.roles?.length || transition.roles.some((role) => roles.includes(role))).map((transition) => ({
+		text: transition.label ?? transition.name,
+		onClick: async () => {
+			const base = apiUrl.replace(/\/$/, "");
+			const id = row.id;
+			const response = await fetch(`${base}/${id}/transition/${transition.name}`, {
+				method: "POST",
+				credentials: "include"
+			});
+			if (!response.ok) {
+				const detail = await response.text().catch(() => "");
+				throw new Error(detail || `Transition "${transition.name}" failed (${response.status})`);
+			}
+			onDone?.();
+		}
+	}));
+}
+//#endregion
 //#region packages/crud/crud/SmartCrudPage.tsx
 function CrudSkeleton() {
 	return /* @__PURE__ */ jsxs("div", {
@@ -7541,7 +7587,7 @@ function SmartCrudPage({ resource, fieldOverrides, formRef, onSelectionChanged,
 	const effectiveGridRef = gridRef ?? internalGridRef;
 	const resolvedBaseResource = useMemo(() => resolveCrudResource(resource), [resource]);
 	const hasManualFields = !resource.fieldContract && Array.isArray(resource.fields) && resource.fields.length > 0;
-	const { fields, isLoading, error, supportedOperations, formLayout: inferredFormLayout } = useResolvedResourceFields({
+	const { fields, isLoading, error, supportedOperations, formLayout: inferredFormLayout, workflow } = useResolvedResourceFields({
 		apiUrl: resolvedBaseResource.apiUrl,
 		manualFields: hasManualFields ? buildFields(resource.fields) : void 0,
 		overrides: hasManualFields ? void 0 : fieldOverrides,
@@ -7565,21 +7611,29 @@ function SmartCrudPage({ resource, fieldOverrides, formRef, onSelectionChanged,
 	const routingState = useRouting(resource.routing);
 	const { activeOperation, formData, handleFormDataChange, startCreate, startEdit, resetOperation } = useSmartCrudOperation(void 0, routingState);
 	const roles = useSmartCrudRoles();
-	const { gridFields, processedFields, computedValues } = useSmartCrudFields(fields, activeOperation, formData, useMemo(() => roles ?? [], [roles]));
+	const stableRoles = useMemo(() => roles ?? [], [roles]);
+	const { gridFields, processedFields, computedValues } = useSmartCrudFields(fields, activeOperation, formData, stableRoles);
 	const formFields = useMemo(() => applyFormDetailFormFieldOverrides(processedFields, resolvedBaseResource.formDetail), [processedFields, resolvedBaseResource.formDetail]);
 	useMercureSubscription(resource.apiUrl, () => {
 		effectiveGridRef.current?.refresh();
 	}, resolvedBaseResource.mercure !== false);
 	const normalizedApiUrl = resolvedBaseResource.apiUrl.startsWith("/") ? resolvedBaseResource.apiUrl : `/${resolvedBaseResource.apiUrl}`;
-	const resolvedResource = useMemo(() => ({
-		...resolvedBaseResource,
-		...!hasManualFields ? { fields: gridFields } : {},
-		apiUrl: normalizedApiUrl,
-		fields: hasManualFields ? buildFields(resource.fields) : gridFields,
-		formFields,
-		formLayout: resolvedBaseResource.formLayout ?? inferredFormLayout,
-		_supportedOperations: supportedOperations
-	}), [
+	const resolvedResource = useMemo(() => {
+		const rowActions = resolvedBaseResource.rowActions ?? (workflow ? (row) => buildWorkflowRowActions(row, workflow, normalizedApiUrl, stableRoles, () => {
+			effectiveGridRef.current?.refresh();
+		}) : void 0);
+		return {
+			...resolvedBaseResource,
+			...!hasManualFields ? { fields: gridFields } : {},
+			apiUrl: normalizedApiUrl,
+			fields: hasManualFields ? buildFields(resource.fields) : gridFields,
+			formFields,
+			formLayout: resolvedBaseResource.formLayout ?? inferredFormLayout,
+			_supportedOperations: supportedOperations,
+			rowActions
+		};
+	}, [
+		effectiveGridRef,
 		fields,
 		gridFields,
 		hasManualFields,
@@ -7588,7 +7642,9 @@ function SmartCrudPage({ resource, fieldOverrides, formRef, onSelectionChanged,
 		formFields,
 		resolvedBaseResource,
 		resource.fields,
-		supportedOperations
+		stableRoles,
+		supportedOperations,
+		workflow
 	]);
 	if (!hasManualFields && isLoading) return /* @__PURE__ */ jsx(CrudSkeleton, {});
 	if (!hasManualFields && error) return /* @__PURE__ */ jsx(CrudError, {
@@ -8565,4 +8621,4 @@ function createRestResourceStore(dialect = {}) {
 	};
 }
 //#endregion
-export { AuditTrailPanel, ColumnPresetSelector, CrudDialogShell, CrudDrawerShell, CrudFormShell, CrudPage, CrudPageShell, DATA_GRID_EVENTS, DEFAULT_DRAWER_SIZE, DEFAULT_DRAWER_WIDTH, DRAWER_WIDTHS, NativeDataGridView as DataGridView, CrudDialogView as DialogView, CrudDrawerView as DrawerView, FORM_EVENTS, FieldBuilder, FieldType, NativeFormView as FormView, HydraAdapter, CrudPageView as PageView, ResourceSchemaProvider, ResourceStoreProvider, RestAdapter, SmartCrudPage, SmartCrudRolesProvider, ToolbarSelect, buildFieldColSpanContext, buildFields, checkboxField, computeSummaryValue, createCrudEvents, createRestResourceStore, crudRoute, currencyField, dateField, datetimeField, defineFieldContract, defineFields, defineResource, entityField, enumField, fileField, formatSummaryValue, identityField, imageField, isLongTextField, isShortField, noneField, numberField, parseDrawerWidthPx, passwordField, resolveDrawerLayoutBucket, resolveDrawerSize, resolveDrawerWidth, resolveFieldColSpan, resolveFieldsColSpans, resolveSummaryText, resolveViewMode, selectField, switchField, textField, textareaField, useColumnPreset, useResourceStoreFactory, useSmartCrudRoles, validateFieldContract };
+export { AuditTrailPanel, ColumnPresetSelector, CrudDialogShell, CrudDrawerShell, CrudFormShell, CrudPage, CrudPageShell, DATA_GRID_EVENTS, DEFAULT_DRAWER_SIZE, DEFAULT_DRAWER_WIDTH, DRAWER_WIDTHS, NativeDataGridView as DataGridView, CrudDialogView as DialogView, CrudDrawerView as DrawerView, FORM_EVENTS, FieldBuilder, FieldType, NativeFormView as FormView, HydraAdapter, CrudPageView as PageView, ResourceSchemaProvider, ResourceStoreProvider, RestAdapter, SmartCrudPage, SmartCrudRolesProvider, ToolbarSelect, buildFieldColSpanContext, buildFields, buildWorkflowRowActions, checkboxField, computeSummaryValue, createCrudEvents, createRestResourceStore, crudRoute, currencyField, dateField, datetimeField, defineFieldContract, defineFields, defineResource, embeddedLinesUrl, entityField, enumField, fileField, formatSummaryValue, identityField, imageField, isLongTextField, isShortField, noneField, numberField, parseDrawerWidthPx, passwordField, resolveDrawerLayoutBucket, resolveDrawerSize, resolveDrawerWidth, resolveFieldColSpan, resolveFieldsColSpans, resolveSummaryText, resolveViewMode, selectField, switchField, textField, textareaField, useColumnPreset, useResourceStoreFactory, useSmartCrudRoles, validateFieldContract };

package/dist/style.css

@@ -617,7 +617,7 @@
   font-size: var(--font-size-xs);
 }
 
-.nb-datagrid__filter-operator {
+.nb-datagrid__filter-wrap > .nb-datagrid__filter-operator {
   left: 5px;
   position: absolute;
   top: 50%;
@@ -625,7 +625,7 @@
   width: 30px;
   z-index: 2;
 }
-.nb-datagrid__filter-operator.nb-dropdown .nb-dropdown__trigger {
+.nb-datagrid__filter-wrap > .nb-datagrid__filter-operator.nb-dropdown .nb-dropdown__trigger {
   appearance: none;
   background: color-mix(in srgb, var(--accent-color) 10%, transparent);
   border: 1px solid color-mix(in srgb, var(--accent-color) 20%, transparent);
@@ -641,7 +641,7 @@
   text-align: center;
   width: 30px;
 }
-.nb-datagrid__filter-operator.nb-dropdown .nb-dropdown__caret {
+.nb-datagrid__filter-wrap > .nb-datagrid__filter-operator.nb-dropdown .nb-dropdown__caret {
   display: none;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nubitio/crud",
-  "version": "0.5.16",
+  "version": "0.5.20",
   "type": "module",
   "description": "Declarative CRUD engine with field DSL, forms, datagrids, RBAC, conditional logic and pluggable adapters (Hydra/REST).",
   "license": "MIT",
@@ -56,7 +56,7 @@
     "react-dom": "^19.0.0",
     "react-i18next": "^14.0.0",
     "react-router-dom": "^6.0.0",
-    "@nubitio/core": "^0.5.16",
-    "@nubitio/ui": "^0.5.16"
+    "@nubitio/core": "^0.5.20",
+    "@nubitio/ui": "^0.5.20"
   }
 }