@nexia/sdk 0.6.6 → 0.7.1

package/dist/actions.d.ts

@@ -0,0 +1,15 @@
+export type ActionPlacement = 'resource' | 'inspector' | 'report' | 'dashboard' | 'palette' | 'agent';
+export type ActionTargets = 'none' | 'one' | 'many';
+/** Core supplies target selection when a placement has no current records. */
+export interface NxActionsProps {
+    placement: ActionPlacement;
+    resourceKey?: string;
+    actionKeys?: readonly string[];
+    currentTargets?: ReadonlyArray<{
+        id: string;
+        label: string;
+    }>;
+    legalEntityPublicId?: string | null;
+    disabledKeys?: readonly string[];
+    onSuccess?: (actionKey: string, response: unknown) => void;
+}

package/dist/actions.js

@@ -0,0 +1 @@
+export {};

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, ResourceInspectorQueryProps, 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 {
@@ -145,6 +145,12 @@ export interface FavoriteButtonProps {
     size?: 'xs' | 'sm' | 'md';
     testId?: string;
 }
+export interface OpenFileOptions {
+    /** Resolve an App GET endpoint returning { href } before opening the file. */
+    resolveHref?: boolean;
+    /** Show the authorized file in a separate browser window instead of saving it. */
+    preview?: boolean;
+}
 export interface NexiaAppFrontendHostBindings {
     api: AxiosInstance;
     components: {
@@ -152,6 +158,7 @@ export interface NexiaAppFrontendHostBindings {
         InspectorAction: typeof InspectorAction;
         InspectorResourceActions: typeof InspectorResourceActions;
         NxAdaptiveSplit: typeof NxAdaptiveSplit;
+        NxActions: ComponentType<NxActionsProps>;
         NxActionButton: typeof NxActionButton;
         NxAlert: typeof NxAlert;
         NxButton: typeof NxButton;
@@ -194,6 +201,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 +216,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;
@@ -220,6 +230,7 @@ export interface NexiaAppFrontendHostBindings {
         OperatingUnitManagementSurface: ComponentType<OperatingUnitManagementSurfaceProps>;
         OperatingUnitScopeField: typeof OperatingUnitScopeField;
         ResourceInspectorPanel: typeof ResourceInspectorPanel;
+        ResourceInspectorQuery: typeof ResourceInspectorQuery;
         ResourceInspectorStackHost: typeof ResourceInspectorStackHost;
         ResourceInspectorStackProvider: typeof ResourceInspectorStackProvider;
         ResourceInspectorState: typeof ResourceInspectorState;
@@ -286,6 +297,7 @@ export interface NexiaAppFrontendHostBindings {
         useWorkTabLabel: (label: string | null | undefined) => void;
     };
     runtime: {
+        openFile: (href: string, options?: OpenFileOptions) => Promise<void>;
         autoRegisterPackageSurfaces: (options: AutoRegisterPackageSurfacesOptions) => void;
         firstFieldError: (errors: FormFieldErrors | undefined, field: string) => string | null;
         keepPreviousResourceListData: <TData>(queryScope: readonly unknown[]) => (previousData: TData | undefined, previousQuery: {
@@ -312,11 +324,13 @@ export interface NexiaAppFrontendHostBindings {
  * Core calls this once before installed App entries execute.
  */
 export declare function configureNexiaAppFrontendHost(bindings: NexiaAppFrontendHostBindings): void;
+/** The host retains authentication and file bytes outside an isolated App frame. */
+export declare function openFile(href: string, options?: OpenFileOptions): Promise<void>;
 /** 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;
@@ -356,6 +370,7 @@ export declare function NxColumnPicker(props: NxColumnPickerProps): ReactNode;
 export declare function NxCombobox<TValue extends string | number>(props: NxComboboxProps<TValue>): ReactNode;
 export declare function NxOperatingUnitSelector(props: NxOperatingUnitSelectorProps): ReactNode;
 export declare function NxOrganizationTargetSelector(props: NxOrganizationTargetSelectorProps): ReactNode;
+export declare function NxActions(props: NxActionsProps): ReactNode;
 export declare function NxDatePicker(props: NxDatePickerProps): ReactNode;
 export declare function NxDateRangePicker(props: NxDateRangePickerProps): ReactNode;
 export declare function NxDetailRow(props: NxDetailRowProps): ReactNode;
@@ -384,6 +399,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 +407,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;
@@ -401,6 +419,7 @@ export declare function NxTextInput(props: NxTextInputProps): ReactNode;
 export declare function NxTooltip(props: NxTooltipProps): ReactNode;
 export declare function OperatingUnitScopeField(props: OperatingUnitScopeFieldProps): ReactNode;
 export declare function OperatingUnitManagementSurface(props: OperatingUnitManagementSurfaceProps): ReactNode;
+export declare function ResourceInspectorQuery<T>(props: ResourceInspectorQueryProps<T>): ReactNode;
 export declare function ResourceInspectorPanel(props: ResourceInspectorPanelProps): ReactNode;
 export declare function ResourceInspectorStackHost(props: ResourceInspectorStackHostProps): ReactNode;
 export declare function ResourceInspectorStackProvider(props: ResourceInspectorStackProviderProps): ReactNode;
@@ -573,14 +592,11 @@ export declare function useWorkTabLabel(label: string | null | undefined): void;
 export declare function useWorkSurfaceLabels(input: WorkSurfaceLabelInput): WorkSurfaceLabels;
 export declare function autoRegisterPackageSurfaces(options: AutoRegisterPackageSurfacesOptions): void;
 /**
- * Declares the filesystem-owned inspector registration set for an App entry.
- *
- * Vite evaluates an eager `import.meta.glob` before passing the modules here;
- * each generated registration module then registers its lazy inspector loader.
- * Keeping the convention in the SDK means an App never needs to maintain a
- * growing list of side-effect imports in its entry point.
+ * Retains legacy eager registration modules and registers optional resource
+ * contract `resourceInspector: { type, load }` declarations. Contracts contain
+ * lightweight metadata; implementations are loaded only by the registry.
  */
-export declare function autoRegisterPackageResourceInspectors(modules: Record<string, unknown>): void;
+export declare function autoRegisterPackageResourceInspectors(modules: Record<string, unknown>, resourceContracts?: Record<string, unknown>): void;
 export declare function firstFieldError(errors: FormFieldErrors | undefined, field: string): string | null;
 export declare function withoutFieldError(errors: FormFieldErrors, field: string): FormFieldErrors;
 export declare function parseMutationFormError(input: MutationFormErrorInput): MutationFormError;
@@ -604,3 +620,4 @@ export declare const resourceCreateDestinationRegistry: Pick<ResourceCreateDesti
 export declare const resourceInspectorAdapterRegistry: ResourceInspectorAdapterRegistrar;
 /** Shared spreadsheet editor; the caller owns document persistence. */
 export declare function NxSpreadsheetEditor(props: NxSpreadsheetEditorProps): ReactNode;
+import type { NxActionsProps } from './actions';

package/dist/host.js

@@ -15,6 +15,10 @@ function host() {
     }
     return activeHost;
 }
+/** The host retains authentication and file bytes outside an isolated App frame. */
+export function openFile(href, options) {
+    return host().runtime.openFile(href, options);
+}
 const apiProxyTarget = axios.create();
 /** Axios-compatible host client carrying the active shell CSRF configuration. */
 export const api = new Proxy(apiProxyTarget, {
@@ -64,15 +68,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 +97,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 +109,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 +120,7 @@ export function useDataMigrationBackgroundOperation() {
         }
         finally {
             activeControllers.current.delete(controller);
+            backgroundControllers.current.delete(controller);
             options.signal?.removeEventListener('abort', abortFromCaller);
         }
     }, []);
@@ -226,6 +238,9 @@ export function NxOperatingUnitSelector(props) {
 export function NxOrganizationTargetSelector(props) {
     return render(host().components.NxOrganizationTargetSelector, props);
 }
+export function NxActions(props) {
+    return render(host().components.NxActions, props);
+}
 export function NxDatePicker(props) {
     return render(host().components.NxDatePicker, props);
 }
@@ -302,6 +317,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 +341,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);
 }
@@ -353,6 +377,9 @@ export function OperatingUnitScopeField(props) {
 export function OperatingUnitManagementSurface(props) {
     return render(host().components.OperatingUnitManagementSurface, props);
 }
+export function ResourceInspectorQuery(props) {
+    return render((host().components.ResourceInspectorQuery), props);
+}
 export function ResourceInspectorPanel(props) {
     return render(host().components.ResourceInspectorPanel, props);
 }
@@ -710,19 +737,40 @@ export function autoRegisterPackageSurfaces(options) {
     host().runtime.autoRegisterPackageSurfaces(options);
 }
 /**
- * Declares the filesystem-owned inspector registration set for an App entry.
- *
- * Vite evaluates an eager `import.meta.glob` before passing the modules here;
- * each generated registration module then registers its lazy inspector loader.
- * Keeping the convention in the SDK means an App never needs to maintain a
- * growing list of side-effect imports in its entry point.
+ * Retains legacy eager registration modules and registers optional resource
+ * contract `resourceInspector: { type, load }` declarations. Contracts contain
+ * lightweight metadata; implementations are loaded only by the registry.
  */
-export function autoRegisterPackageResourceInspectors(modules) {
+export function autoRegisterPackageResourceInspectors(modules, resourceContracts = {}) {
     const pattern = /^\.\/resources\/[^/]+\/inspector\/register-[^/]+-inspector\.ts$/;
     for (const path of Object.keys(modules)) {
-        if (!pattern.test(path)) {
+        if (!pattern.test(path))
             throw new Error(`Invalid package inspector registration path [${path}].`);
+    }
+    const registrations = new Map();
+    for (const [path, module] of Object.entries(resourceContracts)) {
+        if (!/^\.\/resources\/[^/]+\/[a-zA-Z0-9-]+-resource-contract\.ts$/.test(path)
+            || module === null || typeof module !== 'object') {
+            throw new Error(`Invalid Inspector resource contract [${path}].`);
+        }
+        const declaration = module.resourceInspector;
+        if (declaration === undefined)
+            continue;
+        if (declaration === null || typeof declaration !== 'object') {
+            throw new Error(`Invalid Inspector declaration [${path}].`);
         }
+        const { type, load } = declaration;
+        if (typeof type !== 'string' || type.trim() !== type || type === '' || typeof load !== 'function'
+            || !Object.entries(module).some(([key, value]) => key.endsWith('ResourceType') && value === type)) {
+            throw new Error(`Invalid Inspector identity or loader [${path}].`);
+        }
+        if (registrations.has(type))
+            throw new Error(`Duplicate Inspector declaration [${type}].`);
+        registrations.set(type, load);
+    }
+    // Validate the complete new declaration set before mutating the registry.
+    for (const [type, load] of registrations) {
+        host().registries.resourceInspectorAdapterRegistry.register(type, load);
     }
 }
 export function firstFieldError(errors, field) {

package/dist/index.d.ts

@@ -1,11 +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, 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 { NxResourceInformationFormProps, NxResourceInformationViewProps, ResourceFormLegalEntity, ResourceFormBinding, ResourceFormSaved, AppFormSaveBinding, 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";
@@ -36,8 +36,9 @@ 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, DraftFieldBinding, RegisterDraftActionOptions, 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, ResourceInspectorQueryProps, 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";
 export type { SpreadsheetWorkbook, SpreadsheetWorksheet, SpreadsheetCell, NxSpreadsheetEditorProps } from "./spreadsheet";
+export type { ActionPlacement, ActionTargets, NxActionsProps } from './actions';

package/dist/process.d.ts

@@ -61,7 +61,7 @@ export interface ProcessUserTaskFormController {
     /** Current widget validity; widgets re-register when this value changes. */
     readonly canSubmit: boolean;
     /** Build the App-owned input that Core forwards to the server-side handler. */
-    buildInput: () => Record<string, unknown>;
+    buildInput: () => Record<string, unknown> | Promise<Record<string, unknown>>;
 }
 /** Versioned props for the closed `process.user_task.form` host slot. */
 export interface ProcessUserTaskFormSlotPropsV1 {

package/dist/resource-composition.js

@@ -111,7 +111,7 @@ export function parseCompositionSpec(value) {
     if (sources.length === 1 && relationships.length !== 0)
         fail('relationship_not_allowed', 'relationships', 'Single-source Resource Composition cannot declare relationships.');
     const parsedRelationships = parseGraphRelationships(relationships, aliases);
-    const timezone = identifier(root.timezone, 'timezone', /^[A-Za-z_]+(?:\/[A-Za-z_+-]+)+$/);
+    const timezone = identifier(root.timezone, 'timezone', /^(?:UTC|[A-Za-z_]+(?:\/[A-Za-z_+-]+)+)$/);
     const fields = boundedList(root.fields, 'fields').map((value, index) => {
         node(`fields.${index}`);
         const item = plainObject(value, `fields.${index}`);

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

@@ -122,7 +122,26 @@ export interface NxResourceInformationFormProps<TViewContext, TEditContext> {
     emptyValue: ReactNode;
     testIdPrefix?: string;
 }
+export interface ResourceFormSaved {
+    action: "create" | "update";
+    /** Unmodified business response; decode it using the owning App contract. */
+    response: Readonly<Record<string, unknown>>;
+    submittedValues: Readonly<Record<string, unknown>>;
+    currentValues: Readonly<Record<string, unknown>>;
+}
+/** Explicit App action associated with a page form; grants no execution authority. */
+export interface AppFormSaveBinding {
+    key: string;
+    /** Fixed record/scope arguments. Form fields must not overwrite these keys. */
+    arguments: Readonly<Record<string, unknown>>;
+    /** Decode the App response, preserve newer input, and refresh human-owned queries. */
+    onSaved: (result: Omit<ResourceFormSaved, "action">) => void | Promise<void>;
+}
 export interface ResourceFormBinding {
+    /** Local identity for a form without a Resource. Requires explicit scopeKey; do not combine with resourceKey/resourceId/onSaved. */
+    formKey?: string;
+    /** Only for a formKey-based page; pairs an explicit server action with this form. */
+    saveAction?: AppFormSaveBinding;
     /** Omit identity inside a declared Resource route; the host supplies it. */
     resourceKey?: string;
     resourceId?: string | null;
@@ -130,6 +149,8 @@ export interface ResourceFormBinding {
     scopeKey?: string;
     effect: "draft" | "autosave";
     disabled?: boolean;
+    /** Host-confirmed external save for this mounted form; never performs a write. */
+    onSaved?: (result: ResourceFormSaved) => void | Promise<void>;
     /** Pure cross-field preflight; return rejected keys before any value writer runs. */
     validateBatch?: (values: Readonly<Record<string, unknown>>) => readonly string[];
 }

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

@@ -1,9 +1,9 @@
 import type { AnchorHTMLAttributes, ButtonHTMLAttributes, ComponentType, FieldsetHTMLAttributes, FormEvent, HTMLAttributes, InputHTMLAttributes, ReactElement, ReactNode, TextareaHTMLAttributes } from "react";
-import type { QueryClient } from "@tanstack/react-query";
+import type { QueryClient, UseQueryResult } 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 { AppFormSaveBinding, ResourceFormBinding, ResourceFormSaved } from "./resources/resource-information";
 import type { ResourceTransferMeta } from "./resources/resource-transfer";
 /** A server-authorized, durable favorite identity. */
 export type FavoriteTarget = {
@@ -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;
@@ -193,6 +195,14 @@ export interface NxPaginationProps {
     disabled?: boolean;
     className?: string;
 }
+/** Authorized query presentation shared by record Inspectors. */
+export interface ResourceInspectorQueryProps<T> {
+    query: Pick<UseQueryResult<T>, "data" | "error" | "isError" | "isLoading" | "refetch">;
+    canView: (record: T) => boolean;
+    actions?: (record: T) => ReactNode;
+    children: (record: T) => ReactNode;
+    testId?: string;
+}
 export interface ResourceInspectorPanelProps {
     testId?: string;
     badges?: ReactNode;
@@ -625,6 +635,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;
@@ -756,6 +786,8 @@ export interface NxFormFieldProps {
     /** Does not block Save; marks information needed before the resource is ready to use. */
     readinessRequired?: boolean;
     compact?: boolean;
+    /** Keep an editable field in the same label/value grid as NxDetailRow. */
+    layout?: "stack" | "row";
     className?: string;
 }
 export interface NxFormSectionProps {
@@ -846,6 +878,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;
@@ -1197,19 +1235,30 @@ export interface DraftFieldBinding {
     parse: (input: unknown) => unknown;
     apply: (value: unknown) => void;
 }
-export interface RegisterDraftActionOptions {
+export type RegisterDraftActionOptions = {
+    onSaved?: (result: ResourceFormSaved) => void | Promise<void>;
     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[];
-}
+} & ({
+    resourceKey: string;
+    resourceId: string | null;
+    formKey?: never;
+    saveAction?: never;
+} | {
+    formKey: string;
+    scopeKey: string;
+    resourceKey?: never;
+    resourceId?: never;
+    onSaved?: never;
+    saveAction?: AppFormSaveBinding;
+});
 export interface WorkSurfaceLabelInput {
     action: WorkSurfaceAction;
     resourceLabel: string;
@@ -1322,6 +1371,8 @@ export type PackageSurfaceLoader = () => Promise<{
  * surface is pulled into the package entry chunk and code-splitting is lost.
  */
 export interface PackageSurfaceOverrideRegistration {
+    /** Explicit mode for a page without Resource route metadata; never grants API authority. */
+    mode?: 'list' | 'read' | 'create' | 'edit';
     load: PackageSurfaceLoader;
     routePrefetcher?: AppRoutePrefetcher;
 }
@@ -1331,6 +1382,10 @@ export interface AutoRegisterPackageSurfacesOptions {
     appKey?: string;
     overview?: PackageSurfaceLoader;
     surfaces: Record<string, () => Promise<unknown>>;
+    /** Lazy App-owned resource contract modules, keyed by their glob paths.
+     * When supplied, it replaces the host's installed-contract lookup for this
+     * registration, so isolated/revised Apps never mix installed metadata. */
+    resourceContracts?: Record<string, () => Promise<unknown>>;
     overrides?: Record<string, PackageSurfaceOverride>;
 }
 export interface AppRoutePrefetchContext {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.6.6",
+    "version": "0.7.1",
     "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 scripts/organization-target-contract.mjs && node tests/ResourceInspectorRegistrationTest.mjs && node tests/SettingsPrimitivesTest.mjs",
         "test:wire-values": "node tests/WireValuesTest.mjs",
         "typecheck": "tsc -p tsconfig.json --noEmit",
         "test:resource-composition": "pnpm run build && node tests/ResourceCompositionFrontendContractsTest.mjs",