@nexia/sdk 0.6.5 → 0.7.0

package/dist/data-migration.d.ts

@@ -3,7 +3,7 @@ export type DataMigrationRunStatus = 'processing' | 'completed' | 'completed_wit
 /** Host-owned asynchronous operation returned by migration analysis/apply APIs. */
 export interface DataMigrationBackgroundOperation<TResult = Readonly<Record<string, unknown>>> {
     ticket: string;
-    status: 'processing' | 'completed' | 'failed' | 'unknown';
+    status: 'processing' | 'completed' | 'failed' | 'cancelled' | 'unknown';
     result?: TResult;
     errors?: string[];
     validation_errors?: Record<string, string[]>;
@@ -19,6 +19,8 @@ export interface DataMigrationOperationAccepted {
 export interface DataMigrationOperationWaitOptions {
     statusUrl?: string;
     signal?: AbortSignal;
+    /** Keep an already submitted operation observable across route unmounts. */
+    continueInBackground?: boolean;
     onProgress?: (progress: number, phase: string | null) => void;
 }
 export interface DataMigrationBackgroundOperationClient {
@@ -62,10 +64,25 @@ export declare function dataMigrationRunPublicId(result: unknown): string | null
 export interface DataMigrationStageCompletion {
     runPublicId: string;
 }
+/** Transient progress from an App-owned migration stage to the host choice list. */
+export interface DataMigrationStageActivityUpdate {
+    attemptId: string;
+    phase: 'analyzing' | 'review_ready' | 'importing' | 'attention' | 'cancelled' | 'completed';
+    ticket?: string | null;
+}
 /** App-owned stage rendered inside the host-owned data migration workspace. */
 export interface DataMigrationStageProps {
     providerKey: string;
+    /** Host-selected draft identity; a new value starts a separate file upload. */
+    draftKey?: string;
+    /** Actor-owned server operation selected by the host when reopening a stage. */
+    resumeOperation?: {
+        ticket: string;
+        kind: 'review' | 'import';
+        attemptId?: string;
+    };
     onCompleted: (completion: DataMigrationStageCompletion) => void;
+    onActivityChange?: (activity: DataMigrationStageActivityUpdate) => void;
 }
 export type DataMigrationStageLoader = () => Promise<{
     default: ComponentType<DataMigrationStageProps>;
@@ -103,6 +120,17 @@ export interface DataMigrationStageRegistration {
     requiredPermissions?: readonly string[];
     permissionMode?: 'all' | 'any';
     prerequisiteStageIds?: readonly string[];
+    /** Ordered schema column keys shown in the host's saved-result table. */
+    resultColumnKeys?: readonly string[];
+    /** Provider-specific file preparation instructions, owned by the registering App. */
+    fileGuideSteps?: readonly {
+        titleKey: string;
+        sections?: readonly {
+            titleKey: string;
+            descriptionKey: string;
+        }[];
+        noteKey?: string;
+    }[];
     loader: DataMigrationStageLoader;
 }
 /** App-facing capability. Inspection and composition remain host-owned. */

package/dist/host.d.ts

@@ -5,21 +5,21 @@ import type { ApprovalBusinessFormRegistrar, ApprovalBusinessFormRegistry } from
 import type { ContextQueryResult, PermissionsQueryResult } from './context';
 import type { DataMigrationBackgroundOperationClient, DataMigrationRegistrar, DataMigrationRegistry } from './data-migration';
 import type { ProcessUserTaskFormRegistrar, ProcessUserTaskFormRegistry } from './process';
-import type { AppRouteFrameProps, AutoRegisterPackageSurfacesOptions, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, MessageApi, MutationFormError, NxAdaptiveSplitProps, NxActionButtonProps, NxAlertProps, NxButtonProps, NxLinkButtonProps, NxIconButtonProps, NxIconLinkProps, NxCanonicalRoutePaneProps, NxCheckboxProps, NxColumnBrowserProps, NxColumnPickerProps, NxComboboxProps, NxDatePickerProps, NxDateRangePickerProps, NxDetailRowProps, NxEmptyViewProps, NxFieldGroupProps, NxFieldLegendProps, NxFieldsetProps, NxFileDropzoneProps, NxFormFieldProps, NxFormSectionProps, NxDropdownMenuProps, NxInsightFilterBarProps, NxInsightSurfaceProps, NxHelpTooltipProps, NxOverviewBandProps, InsightFilterControls, UseInsightFilterStateOptions, NxLoadingBlockProps, NxModalDialogProps, NxOrgChartProps, NxMissingRequiredReferencesAlertProps, NxPageFrameProps, NxPaginationProps, NxRadioGroupProps, NxRadioProps, NxRefreshControlProps, NxSearchFieldProps, NxSectionCardProps, NxSectionStackProps, NxResponsiveRegionProps, NxSelectProps, NxStatCardProps, NxStatusBadgeProps, NxTabNavProps, NxTextAreaProps, NxTextInputProps, NxTooltipProps, OpenResourceWorkTab, ResourceCreateCompletion, ResourceCreateReceiverRegistration, ResourceInspectorAdapterRegistry, ResourceInspectorAdapterRegistrar, ResourceInspectorPanelProps, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListParams, ResourceListParamsControls, ResourceListToolbarMoreMenuProps, ResourcePrimaryCellProps, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableProps, ResourceTableSort, ResourceTextCellProps, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, TabContextActionRegistration, ToastOptions, WorkSectionProps, FavoriteTarget, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps } from './shell';
+import type { AppRouteFrameProps, AutoRegisterPackageSurfacesOptions, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, MessageApi, MutationFormError, NxAdaptiveSplitProps, NxActionButtonProps, NxAlertProps, NxButtonProps, NxLinkButtonProps, NxIconButtonProps, NxIconLinkProps, NxCanonicalRoutePaneProps, NxCheckboxProps, NxColumnBrowserProps, NxColumnPickerProps, NxComboboxProps, NxDatePickerProps, NxDateRangePickerProps, NxDetailRowProps, NxEmptyViewProps, NxFieldGroupProps, NxFieldLegendProps, NxFieldsetProps, NxFileDropzoneProps, NxFormFieldProps, NxFormSectionProps, NxDropdownMenuProps, NxInsightFilterBarProps, NxInsightSurfaceProps, NxHelpTooltipProps, NxOverviewBandProps, InsightFilterControls, UseInsightFilterStateOptions, NxLoadingBlockProps, NxModalDialogProps, NxOrgChartProps, NxMissingRequiredReferencesAlertProps, NxPageFrameProps, NxPaginationProps, NxRadioGroupProps, NxRadioProps, NxRefreshControlProps, NxSearchFieldProps, NxSectionCardProps, SectionRowProps, NxSectionStackProps, NxResponsiveRegionProps, NxSelectProps, NxStatCardProps, NxStatusBadgeProps, NxSwitchProps, NxTabNavProps, NxTextAreaProps, NxTextInputProps, NxTooltipProps, OpenResourceWorkTab, ResourceCreateCompletion, ResourceCreateReceiverRegistration, ResourceInspectorAdapterRegistry, ResourceInspectorAdapterRegistrar, ResourceInspectorPanelProps, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListParams, ResourceListParamsControls, ResourceListToolbarMoreMenuProps, ResourcePrimaryCellProps, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableProps, ResourceTableSort, ResourceTextCellProps, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, TabContextActionRegistration, RegisterDraftActionOptions, ToastOptions, WorkSectionProps, FavoriteTarget, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps } from './shell';
 import type { AgentComponentRenderer, AttachmentDeleteResult, AttachmentQueryResult, AttachmentUploadOptions, AttachmentUploadResult, ApprovalRoutePoliciesQueryResult, ApprovalSharedLinesQueryResult, DashboardWidgetAutoHeightRef, LegalEntityMemberListParams, LegalEntityMemberQueryResult, LegalEntityApplicabilityQueryResult, LegalEntityQueryResult, MediaUploadResult, OperatingUnitQueryResult, OperatingUnitQueryScope, OperatingUnitScopeFieldProps, OperatingUnitScopeResult, OperatingUnitSelectionResult, PartyListParams, PartyQueryResult, TrustedAssetListParams, TrustedAssetsQueryResult, UploadFileClient } from './platform';
 import type { NxOrganizationTargetSelectorProps, NxOperatingUnitSelectorProps, OrganizationListScopeMode, OrganizationListScopeResult, OrganizationTargetQuery, OrganizationTargetQueryResult } from './organization-target';
 import type { NxCalendarProps, NxResourceSchedulerProps, ResourceBoardProps, ResourceScheduleProps } from './resources/resource-projections';
-import type { NxDatasetExportWorkspaceProps, NxDatasetImportWorkspaceProps, NxResourceImportDialogProps, NxResourceTransferActionsProps } from './resources/resource-transfer';
+import type { NxDatasetExportWorkspaceProps, NxDatasetImportWorkspaceProps, NxInlineResourceCreateProps, NxResourceImportDialogProps, NxResourceTransferActionsProps } from './resources/resource-transfer';
 import type { NxResourceInformationFormProps, NxResourceFormLegalEntityFieldProps, NxResourceInformationViewProps } from './resources/resource-information';
 import type { SignatureAuthenticationMethodSelectorProps, SignatureInvitationChannelSelectorProps, SignatureRequestPreparationEditorProps, SignatureRequestPreparationExactPreviewProps, SignatureRequestPreparationPlacementEditorProps, SignatureSingleRequestDialogProps } from './signature';
 import type { ResourceProjectionChangeSubscription } from './resource-reference';
 import type { ResourceCreateDestinationRegistry } from './resource-create-destination';
 export type { ResourceProjectionChangeSubscription } from './resource-reference';
 /** Host-only visual component prop contracts. App packages import these from ./host. */
-export type { AppRoutePrefetchContext, AppRoutePrefetcher, AutoRegisterPackageSurfacesOptions, PackageSurfaceLoader, PackageSurfaceOverride, PackageSurfaceOverrideRegistration, NxAdaptiveSplitAsideWidth, NxAdaptiveSplitBreakpoint, NxAdaptiveSplitDensity, NxAdaptiveSplitProps, NxActionButtonProps, NxAlertProps, NxButtonProps, NxLinkButtonProps, NxIconButtonProps, NxIconLinkProps, NxCanonicalRoutePaneProps, NxCheckboxProps, NxColumnBrowserLabels, NxColumnBrowserProps, NxColumnNode, NxColumnPickerLabels, NxColumnPickerProps, NxComboboxProps, NxDatePickerProps, NxDateRangePickerProps, NxDetailRowProps, NxDropdownMenuProps, NxEmptyViewProps, NxFieldGroupProps, NxFieldLegendProps, NxFieldsetProps, NxFileDropzoneProps, NxFormFieldProps, NxFormSectionProps, NxInsightFilterBarProps, NxInsightSurfaceProps, NxHelpTooltipProps, NxLoadingBlockProps, NxModalDialogProps, NxOrgChartItem, NxOrgChartLabels, NxOrgChartMember, NxOrgChartProps, NxMissingRequiredReferencesAlertProps, NxOverviewBandProps, NxPageFrameProps, NxRadioGroupProps, NxRadioProps, NxRefreshControlProps, NxResponsiveRegionProps, ResourceListToolbarMoreMenuProps, NxSearchFieldProps, NxSectionCardProps, NxSectionStackProps, NxSelectProps, NxStatCardProps, NxStatusBadgeProps, NxTabNavItem, NxTabNavProps, NxTextAreaProps, NxTextInputProps, NxTooltipProps, ResourceListRefreshConfig, ResourceTableDensity, ResourceTableStyle, ResourceTableSummaryRow, } from './shell';
+export type { AppRoutePrefetchContext, AppRoutePrefetcher, AutoRegisterPackageSurfacesOptions, PackageSurfaceLoader, PackageSurfaceOverride, PackageSurfaceOverrideRegistration, NxAdaptiveSplitAsideWidth, NxAdaptiveSplitBreakpoint, NxAdaptiveSplitDensity, NxAdaptiveSplitProps, NxActionButtonProps, NxAlertProps, NxButtonProps, NxLinkButtonProps, NxIconButtonProps, NxIconLinkProps, NxCanonicalRoutePaneProps, NxCheckboxProps, NxColumnBrowserLabels, NxColumnBrowserProps, NxColumnNode, NxColumnPickerLabels, NxColumnPickerProps, NxComboboxProps, NxDatePickerProps, NxDateRangePickerProps, NxDetailRowProps, NxDropdownMenuProps, NxEmptyViewProps, NxFieldGroupProps, NxFieldLegendProps, NxFieldsetProps, NxFileDropzoneProps, NxFormFieldProps, NxFormSectionProps, NxInsightFilterBarProps, NxInsightSurfaceProps, NxHelpTooltipProps, NxLoadingBlockProps, NxModalDialogProps, NxOrgChartItem, NxOrgChartLabels, NxOrgChartMember, NxOrgChartProps, NxMissingRequiredReferencesAlertProps, NxOverviewBandProps, NxPageFrameProps, NxRadioGroupProps, NxRadioProps, NxRefreshControlProps, NxResponsiveRegionProps, ResourceListToolbarMoreMenuProps, NxSearchFieldProps, NxSectionCardProps, SectionRowProps, NxSectionStackProps, NxSelectProps, NxStatCardProps, NxStatusBadgeProps, NxSwitchProps, NxTabNavItem, NxTabNavProps, NxTextAreaProps, NxTextInputProps, NxTooltipProps, ResourceListRefreshConfig, ResourceTableDensity, ResourceTableStyle, ResourceTableSummaryRow, } from './shell';
 export type { NxResourceInformationFormProps, NxResourceFormLegalEntityFieldProps, NxResourceInformationViewProps, ResourceInformationControlProjection, ResourceInformationControlSlot, ResourceInformationCustomProjection, ResourceInformationEditProjection, ResourceInformationEditRenderContext, ResourceInformationField, ResourceInformationFieldSpan, ResourceInformationMode, ResourceInformationReadOnlyProjection, ResourceInformationRequirement, ResourceInformationSchema, ResourceInformationSection, ResourceInformationTranslator, ResourceInformationValue, } from './resources/resource-information';
 export type { NxCalendarActionBinding, NxCalendarActionCommand, NxCalendarActionResult, NxCalendarInteraction, NxCalendarOccurrence, NxCalendarProps, NxCalendarRange, NxCalendarSelection, NxCalendarTemporalRange, NxCalendarView, NxResourceSchedulerActionBinding, NxResourceSchedulerActionCommand, NxResourceSchedulerActionResult, NxResourceSchedulerInteraction, NxResourceSchedulerOccurrence, NxResourceSchedulerProps, NxResourceSchedulerResource, NxResourceSchedulerSelection, NxResourceSchedulerView, ResourceBoardCard, ResourceBoardLabels, ResourceBoardLane, ResourceBoardLoadState, ResourceBoardMoveCommand, ResourceBoardMutationResult, ResourceBoardProjection, ResourceBoardProps, ResourceBoardSummaryField, ResourceProjectionReference, ResourceScheduleActionBinding, ResourceScheduleActionCommand, ResourceScheduleDatePair, ResourceScheduleDateSemantics, ResourceScheduleDependency, ResourceScheduleDependencyType, ResourceScheduleInteraction, ResourceScheduleItem, ResourceScheduleItemType, ResourceScheduleLoadState, ResourceScheduleMutationResult, ResourceScheduleProjection, ResourceScheduleProps, ResourceScheduleTimeUnit, ResourceScheduleView, } from './resources/resource-projections';
-export type { DatasetImportConfirmationSummary, NxDatasetExportWorkspaceProps, NxDatasetImportWorkspaceProps, NxResourceImportDialogProps, NxResourceTransferActionsProps, } from './resources/resource-transfer';
+export type { DatasetImportConfirmationSummary, NxDatasetExportWorkspaceProps, NxDatasetImportWorkspaceProps, NxInlineResourceCreateProps, NxResourceImportDialogProps, NxResourceTransferActionsProps, } from './resources/resource-transfer';
 export { projectSignatureCapabilityCatalog, signatureCapabilityIdentity, } from './signature';
 export type { SignatureAuthenticationCapability, SignatureAuthenticationMethod, SignatureAuthenticationMethodSelectorProps, SignatureCapability, SignatureCapabilityCatalog, SignatureCapabilityKind, SignatureCapabilityStatus, SignatureCapabilityUnavailableReason, SignatureInvitationCapability, SignatureInvitationChannel, SignatureInvitationChannelSelectorProps, SignatureRequestPreparationDocument, SignatureRequestPreparationEditorPreparation, SignatureRequestPreparationEditorProps, SignatureRequestPreparationDataSourceCard, SignatureRequestPreparationEditPolicy, SignatureRequestPreparationExactPreviewPreparation, SignatureRequestPreparationExactPreviewProps, SignatureRequestPreparationInputDefinition, SignatureRequestPreparationInputKind, SignatureRequestPreparationInputValueAuthority, SignatureRequestPreparationPlacementEditorProps, SignatureRequestPreparationPlacementElement, SignatureRequestPreparationPlacementFormElement, SignatureRequestPreparationPlacementFormKind, SignatureRequestPreparationPlacementImageAsset, SignatureRequestPreparationPlacementImageElement, SignatureRequestPreparationPlacementParticipant, SignatureRequestPreparationPlacementStaticCheckboxElement, SignatureRequestPreparationPlacementDataSourceElement, SignatureRequestPreparationPlacementStaticTextElement, SignatureRequestPreparationRect, SignatureRequestPreparationRenderStatus, SignatureRequestPreparationStatus, SignatureRequestPreparationTextElement, SignatureRoutingCapability, SignatureRoutingMode, SignatureTemporalDisplayPart, SignatureSingleRequestDialogProps, SignatureSingleRequestParticipant, SignatureSingleRequestParticipantAssignmentSource, SignatureSingleRequestParticipantCandidate, SignatureSingleRequestParticipantSubmission, SignatureSingleRequestPreparationReference, SignatureSingleRequestSubmission, } from './signature';
 export interface NxBarChartProps {
@@ -194,6 +194,7 @@ export interface NexiaAppFrontendHostBindings {
         NxResourceTransferActions: ComponentType<NxResourceTransferActionsProps>;
         NxDatasetExportWorkspace: ComponentType<NxDatasetExportWorkspaceProps>;
         NxDatasetImportWorkspace: ComponentType<NxDatasetImportWorkspaceProps>;
+        NxInlineResourceCreate: ComponentType<NxInlineResourceCreateProps>;
         NxSpreadsheetEditor: ComponentType<NxSpreadsheetEditorProps>;
         NxSankey: typeof NxSankey;
         NxLoadingBlock: typeof NxLoadingBlock;
@@ -208,11 +209,13 @@ export interface NexiaAppFrontendHostBindings {
         NxRefreshControl: ComponentType<NxRefreshControlProps>;
         NxSearchField: typeof NxSearchField;
         NxSectionCard: typeof NxSectionCard;
+        NxSectionRow: typeof NxSectionRow;
         NxSectionStack: typeof NxSectionStack;
         NxResponsiveRegion: typeof NxResponsiveRegion;
         NxSelect: <TValue extends string | number>(props: NxSelectProps<TValue>) => ReactNode;
         NxStatCard: typeof NxStatCard;
         NxStatusBadge: typeof NxStatusBadge;
+        NxSwitch: typeof NxSwitch;
         NxTabNav: typeof NxTabNav;
         NxTextArea: typeof NxTextArea;
         NxTextInput: typeof NxTextInput;
@@ -275,6 +278,7 @@ export interface NexiaAppFrontendHostBindings {
         usePermissionsQuery: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, operatingUnitPublicId?: string | null, enabled?: boolean) => PermissionsQueryResult;
         useResourceProjectionChange: (subscription: ResourceProjectionChangeSubscription) => void;
         useRegisterTabActions: (actions: TabContextActionRegistration[] | null) => void;
+        useRegisterDraftAction: (options: RegisterDraftActionOptions) => void;
         useRegisterListLocateAction: <Row>(options: UseRegisterListLocateActionOptions<Row>) => void;
         useResourceListParams: (options?: UseResourceListParamsOptions) => ResourceListParamsControls;
         useTrustedAssetsQuery: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, params: TrustedAssetListParams, enabled?: boolean) => TrustedAssetsQueryResult;
@@ -314,8 +318,8 @@ export declare function configureNexiaAppFrontendHost(bindings: NexiaAppFrontend
 /** Axios-compatible host client carrying the active shell CSRF configuration. */
 export declare const api: AxiosInstance;
 /**
- * Polls Core's standard background-operation endpoint and cancels outstanding
- * waits when the owning surface unmounts.
+ * Polls Core's standard background-operation endpoint. By default unmounting
+ * cancels the wait; callers retaining a checkpoint can explicitly keep waiting.
  */
 export declare function useDataMigrationBackgroundOperation(): DataMigrationBackgroundOperationClient;
 export declare function AppRouteFrame(props: AppRouteFrameProps): ReactNode;
@@ -383,6 +387,7 @@ export declare function NxOrgChart(props: NxOrgChartProps): ReactNode;
 export declare function NxResourceImportDialog(props: NxResourceImportDialogProps): ReactNode;
 export declare function NxResourceTransferActions(props: NxResourceTransferActionsProps): ReactNode;
 export declare function NxDatasetImportWorkspace(props: NxDatasetImportWorkspaceProps): ReactNode;
+export declare function NxInlineResourceCreate(props: NxInlineResourceCreateProps): ReactNode;
 export declare function NxDatasetExportWorkspace(props: NxDatasetExportWorkspaceProps): ReactNode;
 export declare function NxMissingRequiredReferencesAlert(props: NxMissingRequiredReferencesAlertProps): ReactNode;
 export declare function NxPageFrame(props: NxPageFrameProps): ReactNode;
@@ -390,6 +395,8 @@ export declare function NxResponsiveRegion(props: NxResponsiveRegionProps): Reac
 export declare function NxPagination(props: NxPaginationProps): ReactNode;
 export declare function NxSearchField(props: NxSearchFieldProps): ReactNode;
 export declare function NxSectionCard(props: NxSectionCardProps): ReactNode;
+export declare function NxSectionRow(props: SectionRowProps): ReactNode;
+export declare function NxSwitch(props: NxSwitchProps): ReactNode;
 export declare function NxSectionStack(props: NxSectionStackProps): ReactNode;
 export declare function NxSelect<TValue extends string | number>(props: NxSelectProps<TValue>): ReactNode;
 export declare function NxStatCard(props: NxStatCardProps): ReactNode;
@@ -567,6 +574,7 @@ export declare function useResourceCreateCompletion(): ResourceCreateCompletion;
 export declare function useMarkTabDirty(dirty: boolean, snapshot?: string, initialSnapshot?: string): void;
 export declare function useClearTabDirty(): () => void;
 export declare function useRegisterTabActions(actions: TabContextActionRegistration[] | null): void;
+export declare function useRegisterDraftAction(options: RegisterDraftActionOptions): void;
 export declare function useWorkTabLabel(label: string | null | undefined): void;
 export declare function useWorkSurfaceLabels(input: WorkSurfaceLabelInput): WorkSurfaceLabels;
 export declare function autoRegisterPackageSurfaces(options: AutoRegisterPackageSurfacesOptions): void;

package/dist/host.js

@@ -64,15 +64,17 @@ function backgroundOperationClientPath(statusUrl) {
     return path;
 }
 /**
- * Polls Core's standard background-operation endpoint and cancels outstanding
- * waits when the owning surface unmounts.
+ * Polls Core's standard background-operation endpoint. By default unmounting
+ * cancels the wait; callers retaining a checkpoint can explicitly keep waiting.
  */
 export function useDataMigrationBackgroundOperation() {
     const activeControllers = useRef(new Set());
+    const backgroundControllers = useRef(new Set());
     useEffect(() => () => {
-        for (const controller of activeControllers.current)
-            controller.abort();
-        activeControllers.current.clear();
+        for (const controller of activeControllers.current) {
+            if (!backgroundControllers.current.has(controller))
+                controller.abort();
+        }
     }, []);
     const cancelAll = useCallback(() => {
         for (const controller of activeControllers.current)
@@ -91,6 +93,8 @@ export function useDataMigrationBackgroundOperation() {
         else
             options.signal?.addEventListener('abort', abortFromCaller, { once: true });
         activeControllers.current.add(controller);
+        if (options.continueInBackground)
+            backgroundControllers.current.add(controller);
         try {
             for (;;) {
                 const operation = (await api.get(backgroundOperationClientPath(statusUrl), { signal: controller.signal })).data;
@@ -101,6 +105,9 @@ export function useDataMigrationBackgroundOperation() {
                     }
                     return operation.result;
                 }
+                if (operation.status === 'cancelled') {
+                    throw new DOMException('Data migration analysis cancelled.', 'AbortError');
+                }
                 if (operation.status === 'failed' || operation.status === 'unknown') {
                     throw new Error(operationFailureMessage(operation));
                 }
@@ -109,6 +116,7 @@ export function useDataMigrationBackgroundOperation() {
         }
         finally {
             activeControllers.current.delete(controller);
+            backgroundControllers.current.delete(controller);
             options.signal?.removeEventListener('abort', abortFromCaller);
         }
     }, []);
@@ -302,6 +310,9 @@ export function NxResourceTransferActions(props) {
 export function NxDatasetImportWorkspace(props) {
     return render(host().components.NxDatasetImportWorkspace, props);
 }
+export function NxInlineResourceCreate(props) {
+    return render(host().components.NxInlineResourceCreate, props);
+}
 export function NxDatasetExportWorkspace(props) {
     return render(host().components.NxDatasetExportWorkspace, props);
 }
@@ -323,6 +334,12 @@ export function NxSearchField(props) {
 export function NxSectionCard(props) {
     return render(host().components.NxSectionCard, props);
 }
+export function NxSectionRow(props) {
+    return render(host().components.NxSectionRow, props);
+}
+export function NxSwitch(props) {
+    return render(host().components.NxSwitch, props);
+}
 export function NxSectionStack(props) {
     return render(host().components.NxSectionStack, props);
 }
@@ -697,6 +714,9 @@ export function useClearTabDirty() {
 export function useRegisterTabActions(actions) {
     host().hooks.useRegisterTabActions(actions);
 }
+export function useRegisterDraftAction(options) {
+    host().hooks.useRegisterDraftAction(options);
+}
 export function useWorkTabLabel(label) {
     host().hooks.useWorkTabLabel(label);
 }

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export type { ResourceListFilterableEntry, ResourceListSchema, } from "./resources/resource-list";
+export { draftStringField } from './resources/draft-field';
 export { defineResourceInformationSchema, resourceInformationValue, } from "./resources/resource-information";
-export type { NxResourceInformationFormProps, NxResourceInformationViewProps, ResourceFormLegalEntity, NxResourceFormLegalEntityFieldProps, ResourceInformationControlProjection, ResourceInformationControlSlot, ResourceInformationCustomProjection, ResourceInformationEditProjection, ResourceInformationEditRenderContext, ResourceInformationField, ResourceInformationFieldSpan, ResourceInformationMode, ResourceInformationReadOnlyProjection, ResourceInformationRequirement, ResourceInformationSchema, ResourceInformationSection, ResourceInformationTranslator, ResourceInformationValue, } from "./resources/resource-information";
-export type { DatasetImportConfirmationSummary, ResourceImportPreview, ResourceImportPreviewRow, ResourceImportResponse, ResourceImportRun, ResourceImportRunStatus, ResourceImportSummary, ResourceTransferFormat, ResourceTransferMessage, ResourceTransferMeta, NxResourceImportDialogProps, NxResourceTransferActionsProps, NxDatasetImportWorkspaceProps, NxDatasetExportWorkspaceProps, } from "./resources/resource-transfer";
+export type { NxResourceInformationFormProps, NxResourceInformationViewProps, ResourceFormLegalEntity, ResourceFormBinding, NxResourceFormLegalEntityFieldProps, ResourceInformationControlProjection, ResourceInformationControlSlot, ResourceInformationCustomProjection, ResourceInformationEditProjection, ResourceInformationEditRenderContext, ResourceInformationField, ResourceInformationFieldSpan, ResourceInformationMode, ResourceInformationReadOnlyProjection, ResourceInformationRequirement, ResourceInformationSchema, ResourceInformationSection, ResourceInformationTranslator, ResourceInformationValue, } from "./resources/resource-information";
+export type { DatasetImportConfirmationSummary, DatasetImportPlanChoice, DatasetImportPlanSection, ResourceImportPreview, ResourceImportPreviewRow, ResourceImportResponse, ResourceImportRun, ResourceImportRunStatus, ResourceImportSummary, ResourceTransferFormat, ResourceTransferMessage, ResourceTransferMeta, NxResourceImportDialogProps, NxResourceTransferActionsProps, NxDatasetImportWorkspaceProps, NxInlineResourceCreateProps, NxDatasetExportWorkspaceProps, } from "./resources/resource-transfer";
 export type { NxCalendarActionBinding, NxCalendarActionCommand, NxCalendarActionResult, NxCalendarInteraction, NxCalendarOccurrence, NxCalendarProps, NxCalendarRange, NxCalendarSelection, NxCalendarTemporalRange, NxCalendarView, NxResourceSchedulerActionBinding, NxResourceSchedulerActionCommand, NxResourceSchedulerActionResult, NxResourceSchedulerInteraction, NxResourceSchedulerOccurrence, NxResourceSchedulerProps, NxResourceSchedulerResource, NxResourceSchedulerSelection, NxResourceSchedulerView, ResourceBoardCard, ResourceBoardLabels, ResourceBoardLane, ResourceBoardLoadState, ResourceBoardMoveCommand, ResourceBoardMutationResult, ResourceBoardProjection, ResourceBoardProps, ResourceBoardSummaryField, ResourceProjectionReference, ResourceScheduleActionBinding, ResourceScheduleActionCommand, ResourceScheduleDatePair, ResourceScheduleDateSemantics, ResourceScheduleDependency, ResourceScheduleDependencyType, ResourceScheduleInteraction, ResourceScheduleItem, ResourceScheduleItemType, ResourceScheduleLoadState, ResourceScheduleMutationResult, ResourceScheduleProjection, ResourceScheduleProps, ResourceScheduleTimeUnit, ResourceScheduleView, } from "./resources/resource-projections";
 export type { ContextQueryResult, ContextResponse, LegalEntityContext, PermissionsQueryResult, PermissionsResponse, TenantContext, UserContext, WorkspaceContext, } from "./context";
-export type { DataMigrationBackgroundOperation, DataMigrationBackgroundOperationClient, DataMigrationOperationAccepted, DataMigrationOperationWaitOptions, DataMigrationProviderRegistration, DataMigrationRegistrar, DataMigrationRegistry, DataMigrationRun, DataMigrationRunStatus, DataMigrationSessionCheckpointStore, DataMigrationStageCompletion, DataMigrationStageLoader, DataMigrationStageProps, DataMigrationStageRegistration, DataMigrationTargetRegistration, } from "./data-migration";
+export type { DataMigrationBackgroundOperation, DataMigrationBackgroundOperationClient, DataMigrationOperationAccepted, DataMigrationOperationWaitOptions, DataMigrationProviderRegistration, DataMigrationRegistrar, DataMigrationRegistry, DataMigrationRun, DataMigrationRunStatus, DataMigrationSessionCheckpointStore, DataMigrationStageCompletion, DataMigrationStageActivityUpdate, DataMigrationStageLoader, DataMigrationStageProps, DataMigrationStageRegistration, DataMigrationTargetRegistration, } from "./data-migration";
 export { createDataMigrationSessionCheckpointStore, dataMigrationUploadAccept, dataMigrationRunPublicId, isDataMigrationOperationAccepted, } from "./data-migration";
 export { projectSignatureCapabilityCatalog, signatureCapabilityIdentity, } from "./signature";
 export type { SignatureDocumentDataBinding, SignatureDocumentDataCandidate, SignatureDocumentDataCardinality, SignatureDocumentDataClassification, SignatureDocumentDataCompatibleSourceBinding, SignatureDocumentDataContractDescriptor, SignatureDocumentDataFieldDescriptor, SignatureDocumentDataFieldMapping, SignatureDocumentDataFieldType, SignatureDocumentDataFixedSourceBinding, SignatureDocumentDataFormatter, SignatureDocumentDataLookupMode, SignatureDocumentDataResourceRef, SignatureDocumentDataSourceCatalog, SignatureDocumentDataSourceCatalogEntry, SignatureDocumentDataSourceDescriptor, SignatureDocumentDataSourceResolution, SignatureDocumentDataStatus, SignatureAuthenticationCapability, SignatureAuthenticationMethod, SignatureAuthenticationMethodSelectorProps, SignatureCapability, SignatureCapabilityCatalog, SignatureCapabilityKind, SignatureCapabilityStatus, SignatureCapabilityUnavailableReason, SignatureInvitationCapability, SignatureInvitationChannel, SignatureInvitationChannelSelectorProps, SignatureRequestPreparationDocument, SignatureRequestPreparationEditorPreparation, SignatureRequestPreparationEditorProps, SignatureRequestPreparationDataSourceCard, SignatureRequestPreparationEditPolicy, SignatureRequestPreparationExactPreviewPreparation, SignatureRequestPreparationExactPreviewProps, SignatureRequestPreparationInputDefinition, SignatureRequestPreparationInputKind, SignatureRequestPreparationInputValueAuthority, SignatureRequestPreparationPlacementEditorProps, SignatureRequestPreparationPlacementElement, SignatureRequestPreparationPlacementFormElement, SignatureRequestPreparationPlacementFormKind, SignatureRequestPreparationPlacementImageAsset, SignatureRequestPreparationPlacementImageElement, SignatureRequestPreparationPlacementParticipant, SignatureRequestPreparationPlacementStaticCheckboxElement, SignatureRequestPreparationPlacementDataSourceElement, SignatureRequestPreparationPlacementStaticTextElement, SignatureRequestPreparationRect, SignatureRequestPreparationRenderStatus, SignatureRequestPreparationStatus, SignatureRequestPreparationTextElement, SignatureRoutingCapability, SignatureRoutingMode, SignatureTemporalDisplayPart, SignatureSingleRequestDialogProps, SignatureSingleRequestParticipant, SignatureSingleRequestParticipantAssignmentSource, SignatureSingleRequestParticipantCandidate, SignatureSingleRequestParticipantSubmission, SignatureSingleRequestPreparationReference, SignatureSingleRequestSubmission, } from "./signature";
@@ -35,7 +36,7 @@ export type { ApprovalActor, ApprovalBodySnapshot, ApprovalBusinessFormControlle
 export { APPROVAL_STATES, APPROVAL_STEP_KINDS } from "./approval";
 export type { BpmnEditorDocument, BpmnEditorElement, BpmnEditorNodeType, BpmnEditorProcess, DmnEditorDocument, DmnEditorHitPolicy, DmnEditorInputClause, DmnEditorOutputClause, DmnEditorRule, DmnEditorValueType, ProcessUserTaskFormController, ProcessUserTaskFormRegistrar, ProcessUserTaskFormRegistration, ProcessUserTaskFormRegistry, ProcessUserTaskFormSlotPropsV1, ProcessUserTaskFormWidgetLoader, ProcessUserTaskResourceRef, } from "./process";
 export { DMN_EDITOR_HIT_POLICIES } from "./process";
-export type { AppRouteFrameProps, AppRoutePrefetchContext, AppRoutePrefetcher, AutoRegisterPackageSurfacesOptions, PackageSurfaceLoader, PackageSurfaceOverride, PackageSurfaceOverrideRegistration, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, ListLocateRecord, MessageApi, MutationFormError, NxCanonicalRoutePaneProps, NxActionKind, NxIconButtonProps, NxComboboxOption, NxComboboxProps, NxRefreshControlProps, NxColumnBrowserLabels, NxColumnBrowserProps, NxColumnNode, NxColumnPickerLabels, NxColumnPickerProps, NxDatePickerLabels, NxDatePickerProps, NxDateRangePickerProps, NxDateRangeValue, NxDropdownMenuItem, NxHelpTooltipProps, InsightFilterControls, InsightFilterState, InsightQueryLike, InsightRangePreset, UseInsightFilterStateOptions, NxOverviewBandCard, NxSelectOption, NxStatDelta, NxStatDeltaDirection, NxStatDeltaTone, NxTabNavItem, NxTabNavProps, NxTooltipAlign, NxTooltipProps, NxTooltipSide, OpenResourceWorkTab, OpenResourceWorkTabOptions, ResourceCreateCompletion, ResourceCreateCompletionInput, ResourceCreateContinuationTarget, ResourceCreateReceiverRegistration, ResourceInspectorAdapter, ResourceInspectorAdapterLoader, ResourceInspectorAdapterProps, ResourceInspectorAdapterRegistry, ResourceInspectorPanelProps, ResourceInspectorStack, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListFilters, ResourceListFilterValue, ResourceListFooterConfig, ResourceListParams, ResourceListParamsControls, ResourceListRefreshConfig, ResourceListToolbarConfig, ResourceListToolbarMoreMenuProps, ResourceListToolbarViewOption, ResourcePrimaryCellProps, ResourceActionDescriptor, ResourceRef, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableColumn, ResourceTableAccess, ResourceTableDensity, ResourceTableProps, ResourceTableStyle, ResourceTableSummaryRow, ResourceTableSort, TabContextActionContext, TabContextActionRegistration, TabContextActionResult, ResourceTextCellProps, ToastOptions, ToastSource, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, WorkSectionProps, FavoriteTarget, WorkTabRef, WorkSurfaceAction, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps, } from "./shell";
+export type { AppRouteFrameProps, AppRoutePrefetchContext, AppRoutePrefetcher, AutoRegisterPackageSurfacesOptions, PackageSurfaceLoader, PackageSurfaceOverride, PackageSurfaceOverrideRegistration, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, ListLocateRecord, MessageApi, MutationFormError, NxCanonicalRoutePaneProps, NxActionKind, NxIconButtonProps, NxComboboxOption, NxComboboxProps, NxRefreshControlProps, NxColumnBrowserLabels, NxColumnBrowserProps, NxColumnNode, NxColumnPickerLabels, NxColumnPickerProps, NxDatePickerLabels, NxDatePickerProps, NxDateRangePickerProps, NxDateRangeValue, NxDropdownMenuItem, NxHelpTooltipProps, InsightFilterControls, InsightFilterState, InsightQueryLike, InsightRangePreset, UseInsightFilterStateOptions, NxOverviewBandCard, NxSelectOption, NxStatDelta, NxStatDeltaDirection, NxStatDeltaTone, NxTabNavItem, NxTabNavProps, NxTooltipAlign, NxTooltipProps, NxTooltipSide, OpenResourceWorkTab, OpenResourceWorkTabOptions, ResourceCreateCompletion, ResourceCreateCompletionInput, ResourceCreateContinuationTarget, ResourceCreateReceiverRegistration, ResourceInspectorAdapter, ResourceInspectorAdapterLoader, ResourceInspectorAdapterProps, ResourceInspectorAdapterRegistry, ResourceInspectorPanelProps, ResourceInspectorStack, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListFilters, ResourceListFilterValue, ResourceListFooterConfig, ResourceListParams, ResourceListParamsControls, ResourceListRefreshConfig, ResourceListToolbarConfig, ResourceListToolbarMoreMenuProps, ResourceListToolbarViewOption, ResourcePrimaryCellProps, ResourceActionDescriptor, ResourceRef, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableColumn, ResourceTableAccess, ResourceTableDensity, ResourceTableProps, ResourceTableStyle, ResourceTableSummaryRow, ResourceTableSort, TabContextActionContext, TabContextActionRegistration, DraftFieldBinding, RegisterDraftActionOptions, TabContextActionResult, ResourceTextCellProps, ToastOptions, ToastSource, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, WorkSectionProps, FavoriteTarget, WorkTabRef, WorkSurfaceAction, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps, } from "./shell";
 export { FavoriteButton } from "./host";
 export type { FavoriteButtonProps } from "./host";
 export { createSpreadsheetWorkbook } from "./spreadsheet";

package/dist/index.js

@@ -1,3 +1,4 @@
+export { draftStringField } from './resources/draft-field.js';
 export { defineResourceInformationSchema, resourceInformationValue, } from "./resources/resource-information.js";
 export { createDataMigrationSessionCheckpointStore, dataMigrationUploadAccept, dataMigrationRunPublicId, isDataMigrationOperationAccepted, } from "./data-migration.js";
 export { projectSignatureCapabilityCatalog, signatureCapabilityIdentity, } from "./signature.js";

package/dist/resources/draft-field.d.ts

@@ -0,0 +1,9 @@
+import type { DraftFieldBinding } from '../shell';
+/** Binds one App-owned text/choice state to a draft action without submitting it. */
+export declare function draftStringField<T extends string>(value: T, initialValue: T, apply: (value: T) => void, rules: {
+    maxLength: number;
+    minLength?: number;
+    trim?: boolean;
+    values?: readonly T[];
+    pattern?: string;
+}): DraftFieldBinding;

package/dist/resources/draft-field.js

@@ -0,0 +1,22 @@
+/** Binds one App-owned text/choice state to a draft action without submitting it. */
+export function draftStringField(value, initialValue, apply, rules) {
+    return {
+        value, initialValue,
+        inputSchema: { type: 'string', maxLength: rules.maxLength,
+            ...(rules.minLength === undefined ? {} : { minLength: rules.minLength }),
+            ...(rules.pattern === undefined ? {} : { pattern: rules.pattern }),
+            ...(rules.values === undefined ? {} : { enum: rules.values }) },
+        parse(input) {
+            if (typeof input !== 'string')
+                throw new Error('Expected text');
+            const parsed = rules.trim ? input.trim() : input;
+            const length = Array.from(parsed).length;
+            if (length > rules.maxLength || length < (rules.minLength ?? 0)
+                || (rules.pattern !== undefined && !new RegExp(rules.pattern, 'u').test(parsed))
+                || (rules.values && !rules.values.includes(parsed)))
+                throw new Error('Invalid field value');
+            return parsed;
+        },
+        apply: next => apply(next),
+    };
+}

package/dist/resources/resource-information.d.ts

@@ -60,6 +60,8 @@ export interface ResourceInformationField<TViewContext, TEditContext> {
     /** Short domain definition rendered from the field label. */
     definitionKey?: string;
     requirement?: ResourceInformationRequirement;
+    /** Personal/secret values are excluded from automated form discovery and writes. */
+    sensitive?: boolean;
     span?: ResourceInformationFieldSpan;
     /** Defaults to all projections. Omissions must be deliberate and explicit. */
     modes?: readonly ResourceInformationMode[];
@@ -109,6 +111,8 @@ export interface NxResourceInformationFormProps<TViewContext, TEditContext> {
     schema: ResourceInformationSchema<TViewContext, TEditContext>;
     context: TEditContext;
     mode: "create" | "edit";
+    /** Explicit owner and effect of this form; control writers remain public callbacks. */
+    binding?: ResourceFormBinding;
     /** First field of the first schema section, full row width. Omit for tenant-owned forms.
      * Use `stored` on edit; the host never renders an editable owner in edit mode.
      * Do not also declare the Legal Entity field in the form schema.
@@ -118,6 +122,17 @@ export interface NxResourceInformationFormProps<TViewContext, TEditContext> {
     emptyValue: ReactNode;
     testIdPrefix?: string;
 }
+export interface ResourceFormBinding {
+    /** Omit identity inside a declared Resource route; the host supplies it. */
+    resourceKey?: string;
+    resourceId?: string | null;
+    /** Additional form-owned scope; otherwise use the pane-local route scope. */
+    scopeKey?: string;
+    effect: "draft" | "autosave";
+    disabled?: boolean;
+    /** Pure cross-field preflight; return rejected keys before any value writer runs. */
+    validateBatch?: (values: Readonly<Record<string, unknown>>) => readonly string[];
+}
 /**
  * Checks a schema once, then deliberately widens it to the stable host
  * contract. Keeping every App field as one deep literal union makes a

package/dist/resources/resource-transfer.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from "react";
-import type { ResourceCreateContinuationTarget } from "../shell";
+import type { ResourceCreateCompletionInput, ResourceCreateContinuationTarget } from "../shell";
 /** Lifecycle states returned by resource import endpoints. */
 export type ResourceImportRunStatus = "queued" | "processing" | "completed" | "completed_with_errors" | "failed";
 export type ResourceTransferFormat = "csv" | "xlsx" | "txt" | "json" | string;
@@ -130,12 +130,23 @@ export interface DatasetImportConfirmationSummary {
     willUpdate: number;
     willReject: number;
 }
+/** Host-rendered create form that returns to its import preview after saving. */
+export interface NxInlineResourceCreateProps {
+    route: string;
+    title: string;
+    progress?: {
+        current: number;
+        total: number;
+    };
+    onClose: () => void;
+    onCreated: (input: ResourceCreateCompletionInput) => void;
+}
 /** Shared mapped-dataset import workspace for App management destinations. */
 export interface NxDatasetImportWorkspaceProps {
     sourceProfileKey?: string;
     showSourceSelector?: boolean;
     resourceKey: string;
-    /** App-owned reference review above the shared editable preview. */
+    /** App-owned reference review within the shared import flow. */
     renderReferenceReview?: (context: {
         rows: Array<{
             line: number;
@@ -150,15 +161,55 @@ export interface NxDatasetImportWorkspaceProps {
                 message_key?: string;
             }>;
         }>;
+        /** App-reported reference issues covering the entire batch, including rows outside the preview sample. */
+        referenceIssues?: Array<{
+            issue: {
+                kind: string;
+                field: string;
+                value: string;
+                reference_kind?: string;
+                reference_value?: string;
+                label_key?: string;
+                message_key?: string;
+            };
+            count: number;
+        }>;
         busy: boolean;
         recheck: () => void;
         /** Open an offered reference editor after preserving the import draft. */
         createReference: (kind: string, seed: string) => void;
+        /** Configure several references of one kind in sequence without leaving the preview. */
+        createReferences: (items: Array<{
+            kind: string;
+            seed: string;
+        }>) => void;
         /** Apply edits to source rows and rerun the existing validation pipeline. */
         applyChanges: (changes: Record<string, Record<string, string | null>>) => Promise<void>;
     }) => ReactNode;
+    /** Place reference setup before the preview, after its plan choices, or below the complete preview. */
+    referenceReviewPlacement?: "before_preview" | "after_plan" | "after_preview";
+    /** App-owned presentation of plan choices, while Core retains preview and commit decisions. */
+    renderPlanChoices?: (context: {
+        /** Authorized target of the current import preview. */
+        legalEntityPublicId?: string | null;
+        referenceIssues?: Parameters<NonNullable<NxDatasetImportWorkspaceProps["renderReferenceReview"]>>[0]["referenceIssues"];
+        choices: DatasetImportPlanChoice[];
+        sections: DatasetImportPlanSection[];
+        values: Record<string, unknown>;
+        /** Decisions used for the plan currently shown, before local edits. */
+        analyzedValues: Record<string, unknown>;
+        onChange: (key: string, value: string) => void;
+        busy: boolean;
+        previewIsCurrent: boolean;
+        /** Reanalyze the uploaded file with the current App rules. */
+        recheck: () => void;
+    }) => ReactNode;
+    /** Use with renderPlanChoices when the App presents its own decision summary. */
+    hidePlanSections?: boolean;
     /** Allowed display values, keyed by import column. Domain lookup remains App-owned. */
     cellOptions?: Record<string, string[]>;
+    /** Allow source-row correction controls in the preview. Defaults to true. */
+    allowRowEditing?: boolean;
     inlineEditing?: boolean;
     onCompleted?: (result: Record<string, unknown>) => void | Promise<void>;
     /** Called when an ordinary Resource Transfer import has been accepted by the queue. */
@@ -176,11 +227,19 @@ export interface NxDatasetImportWorkspaceProps {
     processingLabel?: string;
     /** App-owned title for domain-specific apply semantics; Core supplies only counts. */
     confirmationTitle?: (summary: DatasetImportConfirmationSummary) => string;
+    /** Promote a multiple-choice decision to a selection dialog, then confirm its normalized selection before applying. */
+    confirmationSelection?: {
+        decisionKey: string;
+        title: string;
+        confirmTitle: (selectedValues: string[]) => string;
+    };
     testIdPrefix?: string;
     /** App-owned canonical create actions for reference issues reported by its pipeline. */
     referenceCreateActions?: Record<string, {
         label: string;
-        onCreate: (seed: string) => void;
+        onCreate: (seed: string, legalEntityPublicId?: string) => void;
+        /** Reuse the owning create route inside the import review instead of changing Work Tabs. */
+        inlineRoute?: (seed: string, legalEntityPublicId?: string) => string;
         continuation: ResourceCreateContinuationTarget;
     }>;
     /** Keep stable App-owned decisions while a contextual reference create is completed and rechecked. */
@@ -188,6 +247,29 @@ export interface NxDatasetImportWorkspaceProps {
     /** Drop submitted decisions that the refreshed App plan no longer offers. */
     retainOnlyOfferedDecisions?: boolean;
 }
+export interface DatasetImportPlanChoice {
+    type: "choice";
+    key: string;
+    label_key: string;
+    label_params: Record<string, string | number>;
+    default_value?: string | null;
+    presentation?: "select" | "checkbox";
+    options: Array<{
+        value: string;
+        label_key: string;
+        label_params: Record<string, string | number>;
+    }>;
+}
+export interface DatasetImportPlanSection {
+    heading_key: string | null;
+    heading_params: Record<string, string | number>;
+    items: Array<{
+        label_key: string;
+        label_params: Record<string, string | number>;
+        count: number | null;
+        existing: boolean;
+    }>;
+}
 /** Shared export workspace for an App-contributed dataset. */
 export interface NxDatasetExportWorkspaceProps {
     resourceKey: string;

package/dist/shell.d.ts

@@ -3,6 +3,7 @@ import type { QueryClient } from "@tanstack/react-query";
 import type { PermissionsResponse } from "./context";
 import type { ResourcePickerRevalidation, ResourceReferenceIdentity } from "./resource-reference";
 import type { ResourceListSchema } from "./resources/resource-list";
+import type { ResourceFormBinding } from "./resources/resource-information";
 import type { ResourceTransferMeta } from "./resources/resource-transfer";
 /** A server-authorized, durable favorite identity. */
 export type FavoriteTarget = {
@@ -42,6 +43,8 @@ export interface ResourceCreateCompletion {
     /** Cancel a contextual create flow; returns true when the host returned to its origin. */
     cancel: () => boolean;
     isContextual: boolean;
+    /** The create form is rendered over its caller and can open another inline form. */
+    isInline?: boolean;
 }
 export interface ResourceCreateReceiverRegistration {
     target: ResourceCreateContinuationTarget;
@@ -232,6 +235,11 @@ interface NxComboboxBaseProps<TValue extends string | number> {
     emptyLabel?: ReactNode;
     searchValue?: string;
     onSearchChange?: (query: string) => void;
+    /** Await an authorized query using the same source as the displayed options. */
+    searchOptions?: {
+        scopeKey: string;
+        search: (query: string, signal?: AbortSignal) => Promise<readonly NxComboboxOption<TValue>[]>;
+    };
     loading?: boolean;
     id?: string;
     describedBy?: string;
@@ -614,10 +622,31 @@ export interface NxIconLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorEle
     className?: string;
 }
 export interface NxCheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
+    onCheckedChange?: (checked: boolean) => void;
     inputSize?: "sm" | "md";
     indeterminate?: boolean;
     label?: string;
 }
+export interface NxSwitchProps {
+    inputSize?: "xs" | "sm" | "md";
+    label?: ReactNode;
+    checked?: boolean;
+    defaultChecked?: boolean;
+    disabled?: boolean;
+    className?: string;
+    id?: string;
+    name?: string;
+    value?: string;
+    required?: boolean;
+    "aria-label"?: string;
+    "aria-describedby"?: string;
+    onCheckedChange?: (checked: boolean) => void;
+    onChange?: (event: {
+        target: {
+            checked: boolean;
+        };
+    }) => void;
+}
 export interface NxRadioGroupProps {
     name?: string;
     value?: string;
@@ -732,6 +761,9 @@ export interface NxOrgChartProps {
     testId?: string;
 }
 export interface NxFormFieldProps {
+    /** Canonical field identity; schema forms already supply it and must not repeat it. */
+    fieldKey?: string;
+    sensitive?: boolean;
     label: ReactNode;
     labelTooltip?: ReactNode;
     children: (context: {
@@ -749,6 +781,8 @@ export interface NxFormFieldProps {
     className?: string;
 }
 export interface NxFormSectionProps {
+    /** Explicit unsaved semantics for composed forms; uses published route identity. */
+    binding?: ResourceFormBinding;
     id?: string;
     children: ReactNode;
     onSubmit?: (event: FormEvent<HTMLFormElement>) => void;
@@ -834,6 +868,12 @@ export interface NxSectionCardProps {
 }
 /** Canonical vertical rhythm for sibling sections outside a route frame. */
 export type NxSectionStackProps = HTMLAttributes<HTMLDivElement>;
+export interface SectionRowProps {
+    label: ReactNode;
+    description?: ReactNode;
+    children: ReactNode;
+    className?: string;
+}
 export interface NxSelectOption<TValue extends string | number> {
     value: TValue;
     label: ReactNode;
@@ -1022,12 +1062,15 @@ export interface NxTextAreaProps extends Omit<TextareaHTMLAttributes<HTMLTextAre
     invalid?: boolean;
     autoResize?: boolean;
     resizable?: boolean;
+    onValueChange?: (value: string) => void;
 }
 export interface NxTextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size"> {
     inputSize?: "md" | "lg";
     appearance?: "field" | "title";
     mono?: boolean;
     invalid?: boolean;
+    /** Controlled value writer shared by direct editing and form integrations. */
+    onValueChange?: (value: string) => void;
 }
 export interface NxDatePickerLabels {
     calendar: string;
@@ -1165,12 +1208,36 @@ export interface TabContextActionContext {
     signal?: AbortSignal;
 }
 export interface TabContextActionRegistration {
+    /** Declares read or local draft work; neither saves nor submits. */
+    effect?: "read" | "draft";
     type: string;
     label: string;
     description?: string;
     inputSchema?: Record<string, unknown>;
     run: (payload: Record<string, unknown>, context: TabContextActionContext) => TabContextActionResult | Promise<TabContextActionResult>;
 }
+/** Explicit form-owner binding. Reference resolution and field rules stay in the App. */
+export interface DraftFieldBinding {
+    value: unknown;
+    initialValue: unknown;
+    inputSchema: Record<string, unknown>;
+    /** Return a canonical value or throw for invalid/unresolved input. */
+    parse: (input: unknown) => unknown;
+    apply: (value: unknown) => void;
+}
+export interface RegisterDraftActionOptions {
+    actionType: string;
+    label: string;
+    description?: string;
+    resourceKey: string;
+    resourceId: string | null;
+    /** Local form context identity (for example tenant and selected create owner); never grants authority. */
+    scopeKey?: string;
+    enabled: boolean;
+    fields: Record<string, DraftFieldBinding>;
+    /** Return invalid field keys for App-owned cross-field constraints, before any writer runs. */
+    validateBatch?: (values: Readonly<Record<string, unknown>>) => readonly string[];
+}
 export interface WorkSurfaceLabelInput {
     action: WorkSurfaceAction;
     resourceLabel: string;
@@ -1227,12 +1294,21 @@ export interface ListLocateRecord {
     hint?: string;
     showUrl?: string;
     editUrl?: string;
+    /** Authorized edit destination's draft-only action; the host still verifies
+     * the mounted action, record and completion before reporting success. */
+    editDraft?: {
+        resourceKey: string;
+        action: string;
+        inputSchema: Record<string, unknown>;
+    };
 }
 export interface UseRegisterListLocateActionOptions<Row> {
     actionType: string;
     label: string;
     description?: string;
     enabled: boolean;
+    /** Tenant/authority/organization identity; exclude ordinary search text. */
+    scopeKey?: string;
     schema: ResourceListSchema | undefined;
     params: Pick<ResourceListParamsControls, "setParams" | "perPage">;
     fetchPage: (params: ResourceListParams) => Promise<{

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.6.5",
+    "version": "0.7.0",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",
@@ -31,7 +31,7 @@
     "scripts": {
         "build": "node scripts/build.mjs",
         "prepack": "npm run build",
-        "test": "npm run build && node tests/WireValuesTest.mjs && node tests/ResourceCompositionFrontendContractsTest.mjs && node scripts/organization-target-contract.mjs",
+        "test": "npm run build && node tests/WireValuesTest.mjs && node tests/ResourceCompositionFrontendContractsTest.mjs && node tests/SettingsPrimitivesTest.mjs && node scripts/organization-target-contract.mjs",
         "test:wire-values": "node tests/WireValuesTest.mjs",
         "typecheck": "tsc -p tsconfig.json --noEmit",
         "test:resource-composition": "pnpm run build && node tests/ResourceCompositionFrontendContractsTest.mjs",