@nexia/sdk 0.7.0 → 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/host.d.ts

@@ -5,7 +5,7 @@ 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, 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 { 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';
@@ -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;
@@ -223,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;
@@ -289,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: {
@@ -315,6 +324,8 @@ 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;
 /**
@@ -359,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;
@@ -407,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;
@@ -579,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;
@@ -610,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, {
@@ -234,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);
 }
@@ -370,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);
 }
@@ -727,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,7 +1,7 @@
 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 { 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";
@@ -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/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 = {
@@ -195,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;
@@ -778,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 {
@@ -1225,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;
@@ -1350,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;
 }
@@ -1359,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.7.0",
+    "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 tests/SettingsPrimitivesTest.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",