@nexia/sdk 0.6.6 → 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, RegisterDraftActionOptions, 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;
@@ -315,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;
@@ -384,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;
@@ -391,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;

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);
 }

package/dist/index.d.ts

@@ -2,10 +2,10 @@ export type { ResourceListFilterableEntry, ResourceListSchema, } from "./resourc
 export { draftStringField } from './resources/draft-field';
 export { defineResourceInformationSchema, resourceInformationValue, } from "./resources/resource-information";
 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, ResourceImportPreview, ResourceImportPreviewRow, ResourceImportResponse, ResourceImportRun, ResourceImportRunStatus, ResourceImportSummary, ResourceTransferFormat, ResourceTransferMessage, ResourceTransferMeta, NxResourceImportDialogProps, NxResourceTransferActionsProps, NxDatasetImportWorkspaceProps, NxDatasetExportWorkspaceProps, } from "./resources/resource-transfer";
+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";

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

@@ -43,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;
@@ -625,6 +627,26 @@ export interface NxCheckboxProps extends Omit<InputHTMLAttributes<HTMLInputEleme
     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;
@@ -846,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;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.6.6",
+    "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",