@nexia/sdk 0.7.2 → 0.8.0

package/dist/actions.d.ts

@@ -9,6 +9,10 @@ export interface NxActionsProps {
         id: string;
         label: string;
     }>;
+    /** Declared inputs from the displayed record, such as concurrency tokens.
+     * Captured when confirmation opens; server planning/authorization still apply.
+     * Do not pass credentials or secrets. */
+    inputByAction?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
     legalEntityPublicId?: string | null;
     disabledKeys?: readonly string[];
     onSuccess?: (actionKey: string, response: unknown) => void;

package/dist/host.d.ts

@@ -3,21 +3,20 @@ import { type ComponentType, type ReactNode } from 'react';
 import type { AxiosInstance } from 'axios';
 import type { ApprovalBusinessFormRegistrar, ApprovalBusinessFormRegistry } from './approval';
 import type { ContextQueryResult, PermissionsQueryResult } from './context';
-import type { DataMigrationBackgroundOperationClient, DataMigrationRegistrar, DataMigrationRegistry } from './data-migration';
-import type { ProcessUserTaskFormRegistrar, ProcessUserTaskFormRegistry } from './process';
+import type { DataMigrationBackgroundOperationClient, DataMigrationProviderRegistration, DataMigrationRegistrar, DataMigrationRegistry, DataMigrationStageRegistration, DataMigrationTargetRegistration } from './data-migration';
+import type { ProcessUserTaskFormRegistration, 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, 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, NxInlineResourceCreateProps, NxResourceImportDialogProps, NxResourceTransferActionsProps } from './resources/resource-transfer';
-import type { NxResourceInformationFormProps, NxResourceFormLegalEntityFieldProps, NxResourceInformationViewProps } from './resources/resource-information';
+import type { NxResourceFormLegalEntityFieldProps } from './resources/resource-form';
 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, 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, NxInlineResourceCreateProps, NxResourceImportDialogProps, NxResourceTransferActionsProps, } from './resources/resource-transfer';
 export { projectSignatureCapabilityCatalog, signatureCapabilityIdentity, } from './signature';
@@ -153,6 +152,8 @@ export interface OpenFileOptions {
 }
 export interface NexiaAppFrontendHostBindings {
     api: AxiosInstance;
+    /** Build-bound services; the host selects the backend before an App entry runs. */
+    appServices?: (appKey: string) => NexiaAppRequestServices;
     components: {
         AppRouteFrame: typeof AppRouteFrame;
         InspectorAction: typeof InspectorAction;
@@ -189,15 +190,13 @@ export interface NexiaAppFrontendHostBindings {
         FavoriteButton: ComponentType<FavoriteButtonProps>;
         NxFormField: typeof NxFormField;
         NxFormSection: typeof NxFormSection;
+        NxResourceFormLegalEntityField: ComponentType<NxResourceFormLegalEntityFieldProps>;
         NxHelpTooltip: ComponentType<NxHelpTooltipProps>;
         NxInsightFilterBar: typeof NxInsightFilterBar;
         NxInsightSurface: typeof NxInsightSurface;
         NxLineChart: typeof NxLineChart;
         NxResourceScheduler: typeof NxResourceScheduler;
         NxResourceImportDialog: ComponentType<NxResourceImportDialogProps>;
-        NxResourceFormLegalEntityField: ComponentType<NxResourceFormLegalEntityFieldProps>;
-        NxResourceInformationForm: <TViewContext, TEditContext>(props: NxResourceInformationFormProps<TViewContext, TEditContext>) => ReactNode;
-        NxResourceInformationView: <TViewContext, TEditContext>(props: NxResourceInformationViewProps<TViewContext, TEditContext>) => ReactNode;
         NxResourceTransferActions: ComponentType<NxResourceTransferActionsProps>;
         NxDatasetExportWorkspace: ComponentType<NxDatasetExportWorkspaceProps>;
         NxDatasetImportWorkspace: ComponentType<NxDatasetImportWorkspaceProps>;
@@ -275,6 +274,7 @@ export interface NexiaAppFrontendHostBindings {
         useIsActiveWorkTabVisible: () => boolean;
         useMarkTabDirty: (dirty: boolean, snapshot?: string, initialSnapshot?: string) => void;
         useClearTabDirty: () => () => void;
+        useReauthenticate: () => () => Promise<void>;
         useMessage: () => MessageApi;
         useOpenResourceWorkTab: (defaultIcon?: string) => OpenResourceWorkTab;
         useRegisterResourceCreateReceiver: (registration: ResourceCreateReceiverRegistration | null) => void;
@@ -319,6 +319,34 @@ export interface NexiaAppFrontendHostBindings {
         resourceInspectorAdapterRegistry: ResourceInspectorAdapterRegistry;
     };
 }
+export interface NexiaAppRequestServices {
+    api: AxiosInstance;
+    openFile: (href: string, options?: OpenFileOptions) => Promise<void>;
+    wrapComponent?: <P extends object>(component: ComponentType<P>) => ComponentType<P>;
+}
+/** Used by the SDK build facade, not by application source. Captures a fixed owner. */
+export declare function bindNexiaAppRequestServices(appKey: string): {
+    resourceInspectorAdapterRegistry: ResourceInspectorAdapterRegistrar;
+    autoRegisterPackageResourceInspectors(modules: Record<string, unknown>, contracts?: Record<string, unknown>): void;
+    autoRegisterPackageSurfaces(options: AutoRegisterPackageSurfacesOptions): void;
+    approvalComposerBusinessFormRegistry: ApprovalBusinessFormRegistrar;
+    processUserTaskFormRegistry: {
+        register(registration: ProcessUserTaskFormRegistration): void;
+    };
+    dataMigrationRegistry: {
+        registerProvider: (registration: DataMigrationProviderRegistration) => void;
+        registerTarget: (registration: DataMigrationTargetRegistration) => void;
+        registerStage(registration: DataMigrationStageRegistration): void;
+    };
+    registerAgentComponent(name: string, component: AgentComponentRenderer): void;
+    registerLazyAgentComponent(name: string, load: () => Promise<{
+        default: AgentComponentRenderer;
+    }>): void;
+    api: AxiosInstance;
+    openFile: (href: string, options?: OpenFileOptions) => Promise<void>;
+    sendUserInvitation(payload: UserInvitationPayload): Promise<UserInvitationResponse>;
+    useDataMigrationBackgroundOperation(): DataMigrationBackgroundOperationClient;
+};
 /**
  * Installs the host implementation behind the public App frontend contract.
  * Core calls this once before installed App entries execute.
@@ -356,9 +384,6 @@ export declare function NxDonutChart(props: NxDonutChartProps): ReactNode;
 export declare function NxGauge(props: NxGaugeProps): ReactNode;
 export declare function NxHeatmap(props: NxHeatmapProps): ReactNode;
 export declare function NxResourceScheduler(props: NxResourceSchedulerProps): ReactNode;
-export declare function NxResourceFormLegalEntityField(props: NxResourceFormLegalEntityFieldProps): ReactNode;
-export declare function NxResourceInformationForm<TViewContext, TEditContext>(props: NxResourceInformationFormProps<TViewContext, TEditContext>): ReactNode;
-export declare function NxResourceInformationView<TViewContext, TEditContext>(props: NxResourceInformationViewProps<TViewContext, TEditContext>): ReactNode;
 export declare function NxSankey(props: NxSankeyProps): ReactNode;
 export declare function NxDropdownMenu(props: NxDropdownMenuProps): ReactNode;
 export declare function NxCheckbox(props: NxCheckboxProps): ReactNode;
@@ -381,6 +406,7 @@ export declare function NxFieldset(props: NxFieldsetProps): ReactNode;
 export declare function NxFileDropzone(props: NxFileDropzoneProps): ReactNode;
 export declare function NxFormField(props: NxFormFieldProps): ReactNode;
 export declare function NxFormSection(props: NxFormSectionProps): ReactNode;
+export declare function NxResourceFormLegalEntityField(props: NxResourceFormLegalEntityFieldProps): ReactNode;
 export declare function NxHelpTooltip(props: NxHelpTooltipProps): ReactNode;
 export declare function NxLoadingBlock(props: NxLoadingBlockProps): ReactNode;
 export declare function NxModalDialog(props: NxModalDialogProps): ReactNode;
@@ -586,6 +612,8 @@ export declare function useRegisterResourceCreateReceiver(registration: Resource
 export declare function useResourceCreateCompletion(): ResourceCreateCompletion;
 export declare function useMarkTabDirty(dirty: boolean, snapshot?: string, initialSnapshot?: string): void;
 export declare function useClearTabDirty(): () => void;
+/** Core owns authentication navigation and restores the calling App's host route. */
+export declare function useReauthenticate(): () => Promise<void>;
 export declare function useRegisterTabActions(actions: TabContextActionRegistration[] | null): void;
 export declare function useRegisterDraftAction(options: RegisterDraftActionOptions): void;
 export declare function useWorkTabLabel(label: string | null | undefined): void;

package/dist/host.js

@@ -1,6 +1,76 @@
 import { createElement, useCallback, useEffect, useMemo, useRef, useState, } from 'react';
 import axios from 'axios';
 export { projectSignatureCapabilityCatalog, signatureCapabilityIdentity, } from './signature.js';
+/** Used by the SDK build facade, not by application source. Captures a fixed owner. */
+export function bindNexiaAppRequestServices(appKey) {
+    if (!/^[a-z][a-z0-9-]*$/.test(appKey))
+        throw new Error('Invalid App identity.');
+    const resolve = host().appServices;
+    if (!resolve)
+        throw new Error('This host does not support App-bound frontend services.');
+    const services = resolve(appKey);
+    const wrap = (component) => services.wrapComponent?.(component) ?? component;
+    const loader = (load) => async () => {
+        const module = await load();
+        return { ...module, default: wrap(module.default) };
+    };
+    const inspectors = {
+        register(type, load) {
+            host().registries.resourceInspectorAdapterRegistry.register(type, async () => {
+                const module = await load();
+                const Component = wrap(module.default);
+                return { default: props => createElement(Component, props) };
+            });
+        },
+    };
+    const approvals = {
+        register(registration, legacyLoader) {
+            host().registries.approvalComposerBusinessFormRegistry.register(typeof registration === 'string'
+                ? { formWidgetKey: registration, loader: loader(legacyLoader) }
+                : { ...registration, loader: loader(registration.loader) });
+        },
+    };
+    return {
+        resourceInspectorAdapterRegistry: inspectors,
+        autoRegisterPackageResourceInspectors(modules, contracts = {}) {
+            registerPackageResourceInspectors(modules, contracts, inspectors);
+        },
+        autoRegisterPackageSurfaces(options) {
+            host().runtime.autoRegisterPackageSurfaces({ ...options, appKey,
+                overview: options.overview && loader(options.overview),
+                surfaces: Object.fromEntries(Object.entries(options.surfaces).map(([key, load]) => [key, loader(load)])),
+                overrides: Object.fromEntries(Object.entries(options.overrides ?? {}).map(([key, value]) => [key,
+                    typeof value === 'function' ? loader(value) : { ...value, load: loader(value.load) }])), });
+        },
+        approvalComposerBusinessFormRegistry: approvals,
+        processUserTaskFormRegistry: {
+            register(registration) {
+                host().registries.processUserTaskFormRegistry.register({ ...registration, loader: loader(registration.loader) });
+            },
+        },
+        dataMigrationRegistry: {
+            registerProvider: dataMigrationRegistry.registerProvider,
+            registerTarget: dataMigrationRegistry.registerTarget,
+            registerStage(registration) {
+                host().registries.dataMigrationRegistry.registerStage({ ...registration, ownerAppKey: appKey, loader: loader(registration.loader) });
+            },
+        },
+        registerAgentComponent(name, component) {
+            host().runtime.registerAgentComponent(name, wrap(component));
+        },
+        registerLazyAgentComponent(name, load) {
+            host().runtime.registerLazyAgentComponent(name, loader(load));
+        },
+        api: services.api,
+        openFile: services.openFile,
+        async sendUserInvitation(payload) {
+            return (await services.api.post('/users/invitations', payload)).data;
+        },
+        useDataMigrationBackgroundOperation() {
+            return useBackgroundOperationClient(services.api);
+        },
+    };
+}
 let activeHost = null;
 /**
  * Installs the host implementation behind the public App frontend contract.
@@ -72,6 +142,9 @@ function backgroundOperationClientPath(statusUrl) {
  * cancels the wait; callers retaining a checkpoint can explicitly keep waiting.
  */
 export function useDataMigrationBackgroundOperation() {
+    return useBackgroundOperationClient(api);
+}
+function useBackgroundOperationClient(client) {
     const activeControllers = useRef(new Set());
     const backgroundControllers = useRef(new Set());
     useEffect(() => () => {
@@ -101,7 +174,7 @@ export function useDataMigrationBackgroundOperation() {
             backgroundControllers.current.add(controller);
         try {
             for (;;) {
-                const operation = (await api.get(backgroundOperationClientPath(statusUrl), { signal: controller.signal })).data;
+                const operation = (await client.get(backgroundOperationClientPath(statusUrl), { signal: controller.signal })).data;
                 options.onProgress?.(typeof operation.progress === 'number' ? operation.progress : 0, typeof operation.phase === 'string' ? operation.phase : null);
                 if (operation.status === 'completed') {
                     if (operation.result === undefined) {
@@ -123,7 +196,7 @@ export function useDataMigrationBackgroundOperation() {
             backgroundControllers.current.delete(controller);
             options.signal?.removeEventListener('abort', abortFromCaller);
         }
-    }, []);
+    }, [client]);
     return useMemo(() => ({ wait, cancelAll }), [cancelAll, wait]);
 }
 function render(component, props) {
@@ -196,15 +269,6 @@ export function NxHeatmap(props) {
 export function NxResourceScheduler(props) {
     return render(host().components.NxResourceScheduler, props);
 }
-export function NxResourceFormLegalEntityField(props) {
-    return render(host().components.NxResourceFormLegalEntityField, props);
-}
-export function NxResourceInformationForm(props) {
-    return createElement(host().components.NxResourceInformationForm, props);
-}
-export function NxResourceInformationView(props) {
-    return createElement(host().components.NxResourceInformationView, props);
-}
 export function NxSankey(props) {
     return render(host().components.NxSankey, props);
 }
@@ -271,6 +335,9 @@ export function NxFormField(props) {
 export function NxFormSection(props) {
     return render(host().components.NxFormSection, props);
 }
+export function NxResourceFormLegalEntityField(props) {
+    return render(host().components.NxResourceFormLegalEntityField, props);
+}
 export function NxHelpTooltip(props) {
     return render(host().components.NxHelpTooltip, props);
 }
@@ -721,6 +788,10 @@ export function useMarkTabDirty(dirty, snapshot, initialSnapshot) {
 export function useClearTabDirty() {
     return host().hooks.useClearTabDirty();
 }
+/** Core owns authentication navigation and restores the calling App's host route. */
+export function useReauthenticate() {
+    return host().hooks.useReauthenticate();
+}
 export function useRegisterTabActions(actions) {
     host().hooks.useRegisterTabActions(actions);
 }
@@ -742,14 +813,24 @@ export function autoRegisterPackageSurfaces(options) {
  * lightweight metadata; implementations are loaded only by the registry.
  */
 export function autoRegisterPackageResourceInspectors(modules, resourceContracts = {}) {
+    registerPackageResourceInspectors(modules, resourceContracts, host().registries.resourceInspectorAdapterRegistry);
+}
+function registerPackageResourceInspectors(modules, resourceContracts, registry) {
     const pattern = /^\.\/resources\/[^/]+\/inspector\/register-[^/]+-inspector\.ts$/;
-    for (const path of Object.keys(modules)) {
-        if (!pattern.test(path))
+    const contractPattern = /^\.\/resources\/[^/]+\/[a-zA-Z0-9-]+-resource-contract\.ts$/;
+    const contracts = { ...resourceContracts };
+    for (const [path, module] of Object.entries(modules)) {
+        if (pattern.test(path))
+            continue;
+        if (!contractPattern.test(path))
             throw new Error(`Invalid package inspector registration path [${path}].`);
+        if (Object.hasOwn(contracts, path))
+            throw new Error(`Duplicate Inspector resource contract [${path}].`);
+        contracts[path] = module;
     }
     const registrations = new Map();
-    for (const [path, module] of Object.entries(resourceContracts)) {
-        if (!/^\.\/resources\/[^/]+\/[a-zA-Z0-9-]+-resource-contract\.ts$/.test(path)
+    for (const [path, module] of Object.entries(contracts)) {
+        if (!contractPattern.test(path)
             || module === null || typeof module !== 'object') {
             throw new Error(`Invalid Inspector resource contract [${path}].`);
         }
@@ -770,7 +851,7 @@ export function autoRegisterPackageResourceInspectors(modules, resourceContracts
     }
     // Validate the complete new declaration set before mutating the registry.
     for (const [type, load] of registrations) {
-        host().registries.resourceInspectorAdapterRegistry.register(type, load);
+        registry.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, ResourceFormSaved, AppFormSaveBinding, NxResourceFormLegalEntityFieldProps, ResourceInformationControlProjection, ResourceInformationControlSlot, ResourceInformationCustomProjection, ResourceInformationEditProjection, ResourceInformationEditRenderContext, ResourceInformationField, ResourceInformationFieldSpan, ResourceInformationMode, ResourceInformationReadOnlyProjection, ResourceInformationRequirement, ResourceInformationSchema, ResourceInformationSection, ResourceInformationTranslator, ResourceInformationValue, } from "./resources/resource-information";
+export { resourceFieldValue } from './resources/resource-form';
+export type { AppFormSaveBinding, NxResourceFormLegalEntityFieldProps, ResourceFormBinding, ResourceFormSaved, ResourceFieldValue, ResourceFormLegalEntity, } from "./resources/resource-form";
 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";

package/dist/index.js

@@ -1,5 +1,5 @@
 export { draftStringField } from './resources/draft-field.js';
-export { defineResourceInformationSchema, resourceInformationValue, } from "./resources/resource-information.js";
+export { resourceFieldValue } from './resources/resource-form.js';
 export { createDataMigrationSessionCheckpointStore, dataMigrationUploadAccept, dataMigrationRunPublicId, isDataMigrationOperationAccepted, } from "./data-migration.js";
 export { projectSignatureCapabilityCatalog, signatureCapabilityIdentity, } from "./signature.js";
 export { SIGNATURE_DOCUMENT_DATA_CLASSIFICATIONS, SIGNATURE_DOCUMENT_DATA_FIELD_TYPES, SIGNATURE_DOCUMENT_DATA_FORMATTERS, SIGNATURE_DOCUMENT_DATA_LOOKUP_MODES, SIGNATURE_DOCUMENT_DATA_STATUSES, } from "./signature.js";

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

@@ -0,0 +1,64 @@
+import type { ReactNode } from 'react';
+import type { OrganizationTargetSelectorOption } from '../organization-target';
+/** Authorized organization owner supplied by the RecordSurface, never inferred from route scope. */
+export type ResourceFormLegalEntity = {
+    kind: 'select';
+    value: string | null;
+    options: readonly OrganizationTargetSelectorOption[];
+    onChange: (value: string) => void;
+    disabled?: boolean;
+    error?: ReactNode;
+} | {
+    kind: 'stored';
+    /** Human label from the record or a read-authorized lookup of its owner. */
+    label: ReactNode;
+};
+/** Props for the host-owned organization owner field within a composed Record form. */
+export interface NxResourceFormLegalEntityFieldProps {
+    target: ResourceFormLegalEntity;
+    mode: 'create' | 'edit';
+}
+/** A displayed Resource field value whose emptiness is explicit to its owning surface. */
+export interface ResourceFieldValue {
+    value: ReactNode;
+    empty?: boolean;
+    mono?: boolean;
+}
+/** Keeps an empty string distinct from a displayed Resource field value. */
+export declare function resourceFieldValue(value: ReactNode, options?: Omit<ResourceFieldValue, 'value'>): ResourceFieldValue;
+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>;
+}
+/**
+ * Explicit binding for a composed Resource form. Resource fields and controls
+ * remain App-owned; the host only uses this identity for draft/save actions.
+ */
+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;
+    /** Additional form-owned scope; otherwise use the pane-local route scope. */
+    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-form.js

@@ -0,0 +1,4 @@
+/** Keeps an empty string distinct from a displayed Resource field value. */
+export function resourceFieldValue(value, options = {}) {
+    return { value, ...options };
+}

package/dist/shell.d.ts

@@ -3,7 +3,7 @@ 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 { AppFormSaveBinding, ResourceFormBinding, ResourceFormSaved } from "./resources/resource-information";
+import type { AppFormSaveBinding, ResourceFormBinding, ResourceFormSaved } from "./resources/resource-form";
 import type { ResourceTransferMeta } from "./resources/resource-transfer";
 /** A server-authorized, durable favorite identity. */
 export type FavoriteTarget = {
@@ -793,6 +793,8 @@ export interface NxFormFieldProps {
 export interface NxFormSectionProps {
     /** Explicit unsaved semantics for composed forms; uses published route identity. */
     binding?: ResourceFormBinding;
+    /** Restricts route-derived draft identity to the owning RecordSurface mode. */
+    mode?: "create" | "edit";
     id?: string;
     children: ReactNode;
     onSubmit?: (event: FormEvent<HTMLFormElement>) => void;

package/dist/vite.d.mts

@@ -0,0 +1,9 @@
+export const nexiaHostPeers: readonly string[];
+export function nexiaAppConfig(configUrl: string | URL): Record<string, unknown>;
+export function nexiaAppFrontend(apps: { appKey: string; root: string } | Array<{ appKey: string; root: string }>): {
+    name: string;
+    enforce: 'pre';
+    resolveId(source: string, importer?: string): string | undefined;
+    load(id: string): string | undefined;
+    generateBundle(this: { emitFile(file: { type: 'asset'; fileName: string; source: string }): unknown }, options: unknown, bundle: Record<string, unknown>): void;
+};

package/dist/vite.mjs

@@ -0,0 +1,65 @@
+import path from 'node:path';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+// Only these modules are supplied by Core's import map. Other App dependencies
+// (for example icons or Axios error helpers) stay in the App bundle.
+export const nexiaHostPeers = ['react', 'react/jsx-runtime', 'react/jsx-dev-runtime',
+    '@tanstack/react-query', 'react-router-dom', 'react-i18next', '@nexia/sdk', '@nexia/sdk/host'];
+
+/** The same standalone build contract for generated and existing Apps. */
+export function nexiaAppConfig(configUrl) {
+    const root = fileURLToPath(new URL('.', configUrl));
+    const manifest = JSON.parse(readFileSync(new URL('./nexia.json', configUrl), 'utf8'));
+    return {
+        root, plugins: [nexiaAppFrontend({ appKey: manifest.app.app_key, root })],
+        publicDir: false, envDir: false, esbuild: { jsx: 'automatic' },
+        resolve: { alias: { '#app': path.join(root, 'resources/js'), '#lang': path.join(root, 'resources/lang') } },
+        build: {
+            outDir: 'dist/frontend', emptyOutDir: true, sourcemap: false, manifest: true,
+            lib: { entry: path.join(root, 'resources/js/index.ts'), formats: ['es'], fileName: () => 'index.js' },
+            rollupOptions: {
+                external: (id, importer) => nexiaHostPeers.includes(id)
+                    && (!['@nexia/sdk', '@nexia/sdk/host'].includes(id) || importer?.startsWith('\0nexia-app-services:')),
+            },
+        },
+    };
+}
+
+/** Bind App service imports at build time; App source keeps using the ordinary SDK. */
+export function nexiaAppFrontend(apps) {
+    const owners = (Array.isArray(apps) ? apps : [apps]).map(({ appKey, root }) => {
+        if (!/^[a-z][a-z0-9-]*$/.test(appKey)) throw new Error('Invalid App frontend owner.');
+        return { appKey, root: path.resolve(root).replaceAll('\\', '/') + '/' };
+    });
+    const prefix = '\0nexia-app-services:';
+    return {
+        name: 'nexia:app-services',
+        enforce: 'pre',
+        resolveId(source, importer) {
+            if (!['@nexia/sdk', '@nexia/sdk/host'].includes(source) || !importer || importer.startsWith(prefix)) return;
+            const owner = owners.find(app => importer.replaceAll('\\', '/').startsWith(app.root));
+            if (owner) return prefix + owner.appKey + ':' + source;
+        },
+        load(id) {
+            if (!id.startsWith(prefix)) return;
+            const [appKey, source] = id.slice(prefix.length).split(':');
+            return `export * from ${JSON.stringify(source)};
+import { bindNexiaAppRequestServices } from '@nexia/sdk/host';
+const services = bindNexiaAppRequestServices(${JSON.stringify(appKey)});
+export const { api, openFile, sendUserInvitation, useDataMigrationBackgroundOperation,
+    autoRegisterPackageSurfaces, autoRegisterPackageResourceInspectors,
+    resourceInspectorAdapterRegistry, approvalComposerBusinessFormRegistry,
+    processUserTaskFormRegistry, dataMigrationRegistry,
+    registerAgentComponent, registerLazyAgentComponent } = services;`;
+        },
+        generateBundle(_options, bundle) {
+            // Standalone App builds expose compatibility before executing their entry.
+            if (owners.length === 1) this.emitFile({
+                type: 'asset', fileName: 'nexia-host.json',
+                source: JSON.stringify({ version: 1, app_key: owners[0].appKey,
+                    styles: Object.keys(bundle).filter(file => file.endsWith('.css')) }),
+            });
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.7.2",
+    "version": "0.8.0",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",
@@ -11,6 +11,7 @@
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
     "exports": {
+        "./vite": "./dist/vite.mjs",
         ".": {
             "development": "./dist/index.js",
             "types": "./dist/index.d.ts",
@@ -31,7 +32,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 && node tests/ResourceInspectorRegistrationTest.mjs && node tests/SettingsPrimitivesTest.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 && node tests/AppServicesTest.mjs",
         "test:wire-values": "node tests/WireValuesTest.mjs",
         "typecheck": "tsc -p tsconfig.json --noEmit",
         "test:resource-composition": "pnpm run build && node tests/ResourceCompositionFrontendContractsTest.mjs",

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

@@ -1,164 +0,0 @@
-import type { ReactNode } from "react";
-import type { OrganizationTargetSelectorOption } from "../organization-target";
-/** Surface-owned, authorized form target. Never a page/list scope. */
-export type ResourceFormLegalEntity = {
-    kind: "select";
-    value: string | null;
-    options: readonly OrganizationTargetSelectorOption[];
-    onChange: (value: string) => void;
-    disabled?: boolean;
-    error?: ReactNode;
-} | {
-    kind: "stored";
-    /** Human label from the record or a read-authorized lookup of its owner. */
-    label: ReactNode;
-};
-/** Why a field matters to the Resource lifecycle. */
-export type ResourceInformationRequirement = "save" | "readiness" | "optional";
-/** The projections in which a field occupies its canonical position. */
-export type ResourceInformationMode = "view" | "create" | "edit";
-/** Responsive width hint for the Form projection. View always uses detail rows. */
-export type ResourceInformationFieldSpan = "half" | "full";
-export interface ResourceInformationValue {
-    value: ReactNode;
-    empty?: boolean;
-    mono?: boolean;
-}
-export interface ResourceInformationControlSlot {
-    id: string;
-    describedBy?: string;
-    invalid: boolean;
-}
-export interface ResourceInformationEditRenderContext<TContext> {
-    mode: "create" | "edit";
-    context: TContext;
-}
-export interface ResourceInformationControlProjection<TContext> {
-    kind: "control";
-    render: (context: ResourceInformationEditRenderContext<TContext>, slot: ResourceInformationControlSlot) => ReactNode;
-    error?: (context: ResourceInformationEditRenderContext<TContext>) => ReactNode;
-}
-export interface ResourceInformationReadOnlyProjection<TContext> {
-    kind: "read-only";
-    render: (context: ResourceInformationEditRenderContext<TContext>) => ResourceInformationValue;
-}
-/**
- * Escape hatch for a composite field such as an address editor. The field
- * still has one canonical schema position and one View value, while the App
- * owns the compound Edit control.
- */
-export interface ResourceInformationCustomProjection<TContext> {
-    kind: "custom";
-    render: (context: ResourceInformationEditRenderContext<TContext>) => ReactNode;
-}
-export type ResourceInformationEditProjection<TContext> = ResourceInformationControlProjection<TContext> | ResourceInformationReadOnlyProjection<TContext> | ResourceInformationCustomProjection<TContext>;
-export interface ResourceInformationField<TViewContext, TEditContext> {
-    key: string;
-    labelKey: string;
-    /** Persistent entry guidance rendered below an Edit control. */
-    helpKey?: string;
-    /** Short domain definition rendered from the field label. */
-    definitionKey?: string;
-    requirement?: ResourceInformationRequirement;
-    /** Personal/secret values are excluded from automated form discovery and writes. */
-    sensitive?: boolean;
-    span?: ResourceInformationFieldSpan;
-    /** Defaults to all projections. Omissions must be deliberate and explicit. */
-    modes?: readonly ResourceInformationMode[];
-    /** Context-dependent visibility evaluated after the static mode contract. */
-    visibility?: {
-        view?: (context: TViewContext) => boolean;
-        create?: (context: TEditContext) => boolean;
-        edit?: (context: TEditContext) => boolean;
-    };
-    view: (context: TViewContext) => ResourceInformationValue;
-    edit: ResourceInformationEditProjection<TEditContext>;
-}
-export interface ResourceInformationSection<TViewContext, TEditContext> {
-    key: string;
-    titleKey: string;
-    descriptionKey?: string;
-    /** Form layout only. View remains an ordered, compact definition list. */
-    formColumns?: 1 | 2;
-    /** Optional aggregate or projection owner, for example `resource` or `party`. */
-    source?: string;
-    fields: readonly ResourceInformationField<TViewContext, TEditContext>[];
-}
-/**
- * One ordered Resource information contract projected by both View and Edit.
- * Route loading, mutations, and related-resource actions remain Surface-owned.
- */
-export interface ResourceInformationSchema<TViewContext, TEditContext> {
-    sections: readonly ResourceInformationSection<TViewContext, TEditContext>[];
-}
-export interface ResourceInformationTranslator {
-    (key: string): string;
-}
-export interface NxResourceInformationViewProps<TViewContext, TEditContext = never> {
-    schema: ResourceInformationSchema<TViewContext, TEditContext>;
-    context: TViewContext;
-    translate: ResourceInformationTranslator;
-    emptyValue: ReactNode;
-    visibleEmptyRequirements?: readonly ResourceInformationRequirement[];
-    testIdPrefix?: string;
-}
-/** Place inside the first input section of a custom form. */
-export interface NxResourceFormLegalEntityFieldProps {
-    target: ResourceFormLegalEntity;
-    mode: "create" | "edit";
-}
-export interface NxResourceInformationFormProps<TViewContext, TEditContext> {
-    schema: ResourceInformationSchema<TViewContext, TEditContext>;
-    context: TEditContext;
-    mode: "create" | "edit";
-    /** Explicit owner and effect of this form; control writers remain public callbacks. */
-    binding?: ResourceFormBinding;
-    /** First field of the first schema section, full row width. Omit for tenant-owned forms.
-     * Use `stored` on edit; the host never renders an editable owner in edit mode.
-     * Do not also declare the Legal Entity field in the form schema.
-     */
-    legalEntity?: ResourceFormLegalEntity;
-    translate: ResourceInformationTranslator;
-    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;
-    /** Additional form-owned scope; otherwise use the pane-local route scope. */
-    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[];
-}
-/**
- * Checks a schema once, then deliberately widens it to the stable host
- * contract. Keeping every App field as one deep literal union makes a
- * workspace-wide typecheck retain the complete product catalog in memory.
- */
-export declare function defineResourceInformationSchema<TViewContext, TEditContext>(): (schema: ResourceInformationSchema<TViewContext, TEditContext>) => ResourceInformationSchema<TViewContext, TEditContext>;
-/** Explicit value helper so an empty string is never mistaken for a value. */
-export declare function resourceInformationValue(value: ReactNode, options?: Omit<ResourceInformationValue, "value">): ResourceInformationValue;

package/dist/resources/resource-information.js

@@ -1,12 +0,0 @@
-/**
- * Checks a schema once, then deliberately widens it to the stable host
- * contract. Keeping every App field as one deep literal union makes a
- * workspace-wide typecheck retain the complete product catalog in memory.
- */
-export function defineResourceInformationSchema() {
-    return (schema) => schema;
-}
-/** Explicit value helper so an empty string is never mistaken for a value. */
-export function resourceInformationValue(value, options = {}) {
-    return { value, ...options };
-}