@nexia/sdk 0.5.0

package/dist/host.d.ts

@@ -0,0 +1,602 @@
+import type { NxSpreadsheetEditorProps } from "./spreadsheet";
+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 { AppRouteFrameProps, AutoRegisterPackageSurfacesOptions, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, MessageApi, MutationFormError, NxAdaptiveSplitProps, NxActionButtonProps, NxAlertProps, NxButtonProps, NxLinkButtonProps, NxIconButtonProps, NxIconLinkProps, NxCanonicalRoutePaneProps, NxCheckboxProps, NxColumnBrowserProps, NxColumnPickerProps, NxComboboxProps, NxDatePickerProps, NxDateRangePickerProps, NxDetailRowProps, NxEmptyViewProps, NxFieldGroupProps, NxFieldLegendProps, NxFieldsetProps, NxFileDropzoneProps, NxFormFieldProps, NxFormSectionProps, NxDropdownMenuProps, NxInsightFilterBarProps, NxInsightSurfaceProps, NxHelpTooltipProps, NxOverviewBandProps, InsightFilterControls, UseInsightFilterStateOptions, NxLoadingBlockProps, NxModalDialogProps, NxOrgChartProps, NxMissingRequiredReferencesAlertProps, NxPageFrameProps, NxPaginationProps, NxRadioGroupProps, NxRadioProps, NxRefreshControlProps, NxSearchFieldProps, NxSectionCardProps, NxSectionStackProps, NxResponsiveRegionProps, NxSelectProps, NxStatCardProps, NxStatusBadgeProps, NxTabNavProps, NxTextAreaProps, NxTextInputProps, NxTooltipProps, OpenResourceWorkTab, ResourceCreateCompletion, ResourceCreateReceiverRegistration, ResourceInspectorAdapterRegistry, ResourceInspectorAdapterRegistrar, ResourceInspectorPanelProps, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListParams, ResourceListParamsControls, ResourceListToolbarMoreMenuProps, ResourcePrimaryCellProps, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableProps, ResourceTableSort, ResourceTextCellProps, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, TabContextActionRegistration, ToastOptions, WorkSectionProps, FavoriteTarget, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps } from './shell';
+import type { 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 { 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 { 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 { 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 {
+    data: Array<Record<string, unknown>>;
+    xKey: string;
+    series: Array<{
+        key: string;
+        label: string;
+        color: string;
+    }>;
+    stacked?: boolean;
+    height?: number;
+    valueFormatter?: (value: number) => string;
+    xTickFormatter?: (value: string) => string;
+    showLegend?: boolean;
+    ariaLabel?: string;
+    testId?: string;
+}
+export interface NxLineChartProps extends NxBarChartProps {
+    curve?: 'monotone' | 'linear';
+    showDots?: boolean;
+}
+export interface NxDonutChartProps {
+    segments: Array<{
+        key: string;
+        label: string;
+        value: number;
+        color: string;
+    }>;
+    centerLabel?: string;
+    height?: number;
+    valueFormatter?: (value: number) => string;
+    otherLabel?: string;
+    ariaLabel?: string;
+    testId?: string;
+}
+export interface NxHeatmapDatum {
+    x: string;
+    y: string;
+    value: number;
+}
+export interface NxHeatmapProps {
+    data: NxHeatmapDatum[];
+    xCategories: string[];
+    yCategories: string[];
+    min?: number;
+    max?: number;
+    lowColor?: string;
+    highColor?: string;
+    height?: number;
+    valueFormatter?: (value: number) => string;
+    showValues?: boolean;
+    ariaLabel?: string;
+    testId?: string;
+}
+export interface NxGaugeThreshold {
+    value: number;
+    color: string;
+}
+export interface NxGaugeProps {
+    value: number;
+    min?: number;
+    max?: number;
+    label?: string;
+    unit?: string;
+    color?: string;
+    thresholds?: NxGaugeThreshold[];
+    height?: number;
+    valueFormatter?: (value: number) => string;
+    ariaLabel?: string;
+    testId?: string;
+}
+export interface NxSankeyNode {
+    id: string;
+    label?: string;
+    color?: string;
+}
+export interface NxSankeyLink {
+    source: string;
+    target: string;
+    value: number;
+}
+export interface NxSankeyProps {
+    nodes: NxSankeyNode[];
+    links: NxSankeyLink[];
+    orientation?: 'horizontal' | 'vertical';
+    draggable?: boolean;
+    height?: number;
+    valueFormatter?: (value: number) => string;
+    ariaLabel?: string;
+    testId?: string;
+}
+export interface DateTimeFormatter {
+    locale: string;
+    timezone: string;
+    formatDateTime: (value: Date | string | null | undefined) => string;
+    formatDate: (value: Date | string | null | undefined) => string;
+    formatTime: (value: Date | string | null | undefined) => string;
+}
+export interface MutationFormErrorInput {
+    error: unknown;
+    t: (key: string, options?: Record<string, unknown>) => string;
+    fallback: string;
+    fieldLabel: (field: string) => string;
+}
+export interface UserInvitationPayload {
+    email?: string;
+    legal_entity_roles?: string[];
+    operating_unit_public_ids?: string[];
+    operating_unit_roles?: Record<string, string[]>;
+    role?: string;
+    person_party_public_id?: string;
+}
+export interface UserInvitationResponse {
+    invitation: unknown;
+}
+/** Host-owned Operating Unit management workspace embedded in an App route. */
+export interface OperatingUnitManagementSurfaceProps {
+    testId?: string;
+}
+export interface FavoriteButtonProps {
+    target: FavoriteTarget;
+    size?: 'xs' | 'sm' | 'md';
+    testId?: string;
+}
+export interface NexiaAppFrontendHostBindings {
+    api: AxiosInstance;
+    components: {
+        AppRouteFrame: typeof AppRouteFrame;
+        InspectorAction: typeof InspectorAction;
+        InspectorResourceActions: typeof InspectorResourceActions;
+        NxAdaptiveSplit: typeof NxAdaptiveSplit;
+        NxActionButton: typeof NxActionButton;
+        NxAlert: typeof NxAlert;
+        NxButton: typeof NxButton;
+        NxLinkButton: ComponentType<NxLinkButtonProps>;
+        NxIconButton: ComponentType<NxIconButtonProps>;
+        NxIconLink: ComponentType<NxIconLinkProps>;
+        NxCanonicalRoutePane: ComponentType<NxCanonicalRoutePaneProps>;
+        NxCalendar: typeof NxCalendar;
+        NxBarChart: typeof NxBarChart;
+        NxCheckbox: typeof NxCheckbox;
+        NxColumnBrowser: typeof NxColumnBrowser;
+        NxColumnPicker: typeof NxColumnPicker;
+        NxCombobox: <TValue extends string | number>(props: NxComboboxProps<TValue>) => ReactNode;
+        NxOperatingUnitSelector: ComponentType<NxOperatingUnitSelectorProps>;
+        NxOrganizationTargetSelector: ComponentType<NxOrganizationTargetSelectorProps>;
+        NxDatePicker: ComponentType<NxDatePickerProps>;
+        NxDateRangePicker: ComponentType<NxDateRangePickerProps>;
+        NxDetailRow: typeof NxDetailRow;
+        NxDonutChart: typeof NxDonutChart;
+        NxGauge: typeof NxGauge;
+        NxHeatmap: typeof NxHeatmap;
+        NxDropdownMenu: typeof NxDropdownMenu;
+        NxEmptyView: typeof NxEmptyView;
+        NxFieldGroup: typeof NxFieldGroup;
+        NxFieldLegend: typeof NxFieldLegend;
+        NxFieldset: typeof NxFieldset;
+        NxFileDropzone: typeof NxFileDropzone;
+        FavoriteButton: ComponentType<FavoriteButtonProps>;
+        NxFormField: typeof NxFormField;
+        NxFormSection: typeof NxFormSection;
+        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>;
+        NxSpreadsheetEditor: ComponentType<NxSpreadsheetEditorProps>;
+        NxSankey: typeof NxSankey;
+        NxLoadingBlock: typeof NxLoadingBlock;
+        NxModalDialog: typeof NxModalDialog;
+        NxOrgChart: typeof NxOrgChart;
+        NxMissingRequiredReferencesAlert: typeof NxMissingRequiredReferencesAlert;
+        NxOverviewBand: typeof NxOverviewBand;
+        NxPageFrame: typeof NxPageFrame;
+        NxPagination: typeof NxPagination;
+        NxRadio: typeof NxRadio;
+        NxRadioGroup: typeof NxRadioGroup;
+        NxRefreshControl: ComponentType<NxRefreshControlProps>;
+        NxSearchField: typeof NxSearchField;
+        NxSectionCard: typeof NxSectionCard;
+        NxSectionStack: typeof NxSectionStack;
+        NxResponsiveRegion: typeof NxResponsiveRegion;
+        NxSelect: <TValue extends string | number>(props: NxSelectProps<TValue>) => ReactNode;
+        NxStatCard: typeof NxStatCard;
+        NxStatusBadge: typeof NxStatusBadge;
+        NxTabNav: typeof NxTabNav;
+        NxTextArea: typeof NxTextArea;
+        NxTextInput: typeof NxTextInput;
+        NxTooltip: ComponentType<NxTooltipProps>;
+        OperatingUnitManagementSurface: ComponentType<OperatingUnitManagementSurfaceProps>;
+        OperatingUnitScopeField: typeof OperatingUnitScopeField;
+        ResourceInspectorPanel: typeof ResourceInspectorPanel;
+        ResourceInspectorStackHost: typeof ResourceInspectorStackHost;
+        ResourceInspectorStackProvider: typeof ResourceInspectorStackProvider;
+        ResourceInspectorState: typeof ResourceInspectorState;
+        ResourceLink: ComponentType<ResourceLinkProps>;
+        ResourceBoard: typeof ResourceBoard;
+        ResourceListToolbarMoreMenu: <TValue extends string>(props: ResourceListToolbarMoreMenuProps<TValue>) => ReactNode;
+        ResourcePrimaryCell: typeof ResourcePrimaryCell;
+        ResourceRowActionsMenu: typeof ResourceRowActionsMenu;
+        ResourceStatusBadge: typeof ResourceStatusBadge;
+        ResourceSchedule: typeof ResourceSchedule;
+        ResourceTable: <T>(props: ResourceTableProps<T>) => ReactNode;
+        ResourceTextCell: typeof ResourceTextCell;
+        SignatureAuthenticationMethodSelector: ComponentType<SignatureAuthenticationMethodSelectorProps>;
+        SignatureInvitationChannelSelector: ComponentType<SignatureInvitationChannelSelectorProps>;
+        SignatureRequestPreparationEditor: ComponentType<SignatureRequestPreparationEditorProps>;
+        SignatureRequestPreparationExactPreview: ComponentType<SignatureRequestPreparationExactPreviewProps>;
+        SignatureRequestPreparationPlacementEditor: ComponentType<SignatureRequestPreparationPlacementEditorProps>;
+        SignatureSingleRequestDialog: ComponentType<SignatureSingleRequestDialogProps>;
+        WorkSection: typeof WorkSection;
+        WorkSurface: typeof WorkSurface;
+    };
+    hooks: {
+        useContextQuery: () => ContextQueryResult;
+        useAffiliatedOperatingUnits: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, permission: string, enabled?: boolean) => OperatingUnitQueryResult;
+        useAgentToolDataFreshness: (options: AgentToolDataFreshnessInput) => AgentToolDataFreshnessResult;
+        useAgentToolDataInvalidation: (enabled?: boolean) => void;
+        useAssignableOperatingUnits: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, permission: string, enabled?: boolean) => OperatingUnitQueryResult;
+        useAttachments: (tenantId: string | undefined, attachableType: string, attachablePublicId: string | undefined) => AttachmentQueryResult;
+        useApprovalRoutePoliciesQuery: (tenantId: string | undefined, legalEntityPublicId: string | null, enabled?: boolean) => ApprovalRoutePoliciesQueryResult;
+        useApprovalSharedLinesQuery: (tenantId: string | undefined, legalEntityPublicId: string | null, enabled?: boolean) => ApprovalSharedLinesQueryResult;
+        useDateTimeFormatter: (options?: UseDateTimeFormatterOptions) => DateTimeFormatter;
+        useDashboardWidgetAutoHeight: (widgetId: unknown) => DashboardWidgetAutoHeightRef;
+        useDebouncedValue: <T>(value: T, delayMs?: number) => T;
+        useDeleteAttachment: (tenantId: string | undefined, attachableType: string, attachablePublicId: string | undefined) => AttachmentDeleteResult;
+        useInsightFilterState: (options?: UseInsightFilterStateOptions) => InsightFilterControls;
+        useLegalEntitiesQuery: (tenantId: string | undefined) => LegalEntityQueryResult;
+        useLegalEntityApplicabilityQuery: (tenantId: string | undefined, permission: string, enabled?: boolean) => LegalEntityApplicabilityQueryResult;
+        useOrganizationTargetsQuery: (tenantId: string | undefined, permission: string, query?: OrganizationTargetQuery, enabled?: boolean) => OrganizationTargetQueryResult;
+        useOrganizationListScope: (tenantId: string | undefined, permission: string, mode?: OrganizationListScopeMode, enabled?: boolean) => OrganizationListScopeResult;
+        useLegalEntityMembersQuery: (tenantId: string | undefined, legalEntityPublicId: string | null, params?: LegalEntityMemberListParams, enabled?: boolean) => LegalEntityMemberQueryResult;
+        useActiveWorkTabId: () => string | null;
+        useIsActiveWorkTabVisible: () => boolean;
+        useMarkTabDirty: (dirty: boolean) => void;
+        useMessage: () => MessageApi;
+        useOpenResourceWorkTab: (defaultIcon?: string) => OpenResourceWorkTab;
+        useRegisterResourceCreateReceiver: (registration: ResourceCreateReceiverRegistration | null) => void;
+        useResourceCreateCompletion: () => ResourceCreateCompletion;
+        useOperatingUnitScope: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, permission: string, enabled?: boolean) => OperatingUnitScopeResult;
+        useOperatingUnitSelection: (tenantId: string | undefined, legalEntityPublicId: string | null, permission: string, enabled?: boolean) => OperatingUnitSelectionResult;
+        useOperatingUnitsQuery: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, scope?: OperatingUnitQueryScope, permission?: string, enabled?: boolean) => OperatingUnitQueryResult;
+        useParties: (tenantId: string | undefined, params: PartyListParams, enabled?: boolean) => PartyQueryResult;
+        usePermissionsQuery: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, operatingUnitPublicId?: string | null, enabled?: boolean) => PermissionsQueryResult;
+        useResourceProjectionChange: (subscription: ResourceProjectionChangeSubscription) => void;
+        useRegisterTabActions: (actions: TabContextActionRegistration[] | null) => void;
+        useRegisterListLocateAction: <Row>(options: UseRegisterListLocateActionOptions<Row>) => void;
+        useResourceListParams: (options?: UseResourceListParamsOptions) => ResourceListParamsControls;
+        useTrustedAssetsQuery: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, params: TrustedAssetListParams, enabled?: boolean) => TrustedAssetsQueryResult;
+        useUploadAttachment: (tenantId: string | undefined, attachableType: string, attachablePublicId: string | undefined, options?: AttachmentUploadOptions) => AttachmentUploadResult;
+        useUploadFile: () => UploadFileClient;
+        useUploadMedia: (tenantId: string | undefined) => MediaUploadResult;
+        useWorkSurfaceLabels: (input: WorkSurfaceLabelInput) => WorkSurfaceLabels;
+        useWorkTabLabel: (label: string | null | undefined) => void;
+    };
+    runtime: {
+        autoRegisterPackageSurfaces: (options: AutoRegisterPackageSurfacesOptions) => void;
+        firstFieldError: (errors: FormFieldErrors | undefined, field: string) => string | null;
+        keepPreviousResourceListData: <TData>(queryScope: readonly unknown[]) => (previousData: TData | undefined, previousQuery: {
+            readonly queryKey: readonly unknown[];
+        } | undefined) => TData | undefined;
+        parseMutationFormError: (input: MutationFormErrorInput) => MutationFormError;
+        readResourceListParams: (searchParams: URLSearchParams, options?: UseResourceListParamsOptions) => ResourceListParams;
+        registerAgentComponent: (name: string, renderer: AgentComponentRenderer) => void;
+        registerLazyAgentComponent: (name: string, loader: () => Promise<{
+            default: AgentComponentRenderer;
+        }>) => void;
+        withoutFieldError: (errors: FormFieldErrors, field: string) => FormFieldErrors;
+    };
+    registries: {
+        approvalComposerBusinessFormRegistry: ApprovalBusinessFormRegistry;
+        dataMigrationRegistry: DataMigrationRegistry;
+        processUserTaskFormRegistry: ProcessUserTaskFormRegistry;
+        resourceCreateDestinationRegistry: ResourceCreateDestinationRegistry;
+        resourceInspectorAdapterRegistry: ResourceInspectorAdapterRegistry;
+    };
+}
+/**
+ * Installs the host implementation behind the public App frontend contract.
+ * Core calls this once before installed App entries execute.
+ */
+export declare function configureNexiaAppFrontendHost(bindings: NexiaAppFrontendHostBindings): 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.
+ */
+export declare function useDataMigrationBackgroundOperation(): DataMigrationBackgroundOperationClient;
+export declare function AppRouteFrame(props: AppRouteFrameProps): ReactNode;
+export declare function InspectorAction(props: InspectorActionProps): ReactNode;
+export declare function InspectorResourceActions(props: InspectorResourceActionsProps): ReactNode;
+export declare function ResourceLink(props: ResourceLinkProps): ReactNode;
+export declare function NxAdaptiveSplit(props: NxAdaptiveSplitProps): ReactNode;
+export declare function NxActionButton(props: NxActionButtonProps): ReactNode;
+export declare function NxAlert(props: NxAlertProps): ReactNode;
+export declare function NxButton(props: NxButtonProps): ReactNode;
+export declare function NxLinkButton(props: NxLinkButtonProps): ReactNode;
+export declare function NxIconButton(props: NxIconButtonProps): ReactNode;
+export declare function NxIconLink(props: NxIconLinkProps): ReactNode;
+/** Host-rendered action; Apps supply only a stable target. */
+export declare function FavoriteButton(props: FavoriteButtonProps): ReactNode;
+export declare function NxCalendar(props: NxCalendarProps): ReactNode;
+export declare function NxBarChart(props: NxBarChartProps): ReactNode;
+export declare function NxLineChart(props: NxLineChartProps): ReactNode;
+export declare function NxInsightFilterBar(props: NxInsightFilterBarProps): ReactNode;
+export declare function NxInsightSurface(props: NxInsightSurfaceProps): ReactNode;
+export declare function NxOverviewBand(props: NxOverviewBandProps): ReactNode;
+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;
+export declare function NxRadio(props: NxRadioProps): ReactNode;
+export declare function NxRadioGroup(props: NxRadioGroupProps): ReactNode;
+export declare function NxRefreshControl(props: NxRefreshControlProps): ReactNode;
+export declare function NxColumnBrowser(props: NxColumnBrowserProps): ReactNode;
+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 NxDatePicker(props: NxDatePickerProps): ReactNode;
+export declare function NxDateRangePicker(props: NxDateRangePickerProps): ReactNode;
+export declare function NxDetailRow(props: NxDetailRowProps): ReactNode;
+export declare function NxEmptyView(props: NxEmptyViewProps): ReactNode;
+export declare function NxFieldGroup(props: NxFieldGroupProps): ReactNode;
+export declare function NxFieldLegend(props: NxFieldLegendProps): ReactNode;
+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 NxHelpTooltip(props: NxHelpTooltipProps): ReactNode;
+export declare function NxLoadingBlock(props: NxLoadingBlockProps): ReactNode;
+export declare function NxModalDialog(props: NxModalDialogProps): ReactNode;
+export declare function SignatureInvitationChannelSelector(props: SignatureInvitationChannelSelectorProps): ReactNode;
+export declare function SignatureAuthenticationMethodSelector(props: SignatureAuthenticationMethodSelectorProps): ReactNode;
+/** Renders Core's request-local editor through the public App host boundary. */
+export declare function SignatureRequestPreparationEditor(props: SignatureRequestPreparationEditorProps): ReactNode;
+/** Renders the protected exact-PDF review through the public App host boundary. */
+export declare function SignatureRequestPreparationExactPreview(props: SignatureRequestPreparationExactPreviewProps): ReactNode;
+/** Renders the placement-only request editor through the public App host boundary. */
+export declare function SignatureRequestPreparationPlacementEditor(props: SignatureRequestPreparationPlacementEditorProps): ReactNode;
+/** Renders Core's app-neutral single-request flow through the public host boundary. */
+export declare function SignatureSingleRequestDialog(props: SignatureSingleRequestDialogProps): ReactNode;
+export declare function NxCanonicalRoutePane(props: NxCanonicalRoutePaneProps): ReactNode;
+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 NxDatasetExportWorkspace(props: NxDatasetExportWorkspaceProps): ReactNode;
+export declare function NxMissingRequiredReferencesAlert(props: NxMissingRequiredReferencesAlertProps): ReactNode;
+export declare function NxPageFrame(props: NxPageFrameProps): ReactNode;
+export declare function NxResponsiveRegion(props: NxResponsiveRegionProps): ReactNode;
+export declare function NxPagination(props: NxPaginationProps): ReactNode;
+export declare function NxSearchField(props: NxSearchFieldProps): ReactNode;
+export declare function NxSectionCard(props: NxSectionCardProps): 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;
+export declare function NxStatusBadge(props: NxStatusBadgeProps): ReactNode;
+export declare function NxTabNav(props: NxTabNavProps): ReactNode;
+export declare function NxTextArea(props: NxTextAreaProps): ReactNode;
+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 ResourceInspectorPanel(props: ResourceInspectorPanelProps): ReactNode;
+export declare function ResourceInspectorStackHost(props: ResourceInspectorStackHostProps): ReactNode;
+export declare function ResourceInspectorStackProvider(props: ResourceInspectorStackProviderProps): ReactNode;
+export declare function ResourceInspectorState(props: ResourceInspectorStateProps): ReactNode;
+export declare function ResourceBoard(props: ResourceBoardProps): ReactNode;
+export declare function ResourcePrimaryCell(props: ResourcePrimaryCellProps): ReactNode;
+export declare function ResourceListToolbarMoreMenu<TValue extends string = string>(props: ResourceListToolbarMoreMenuProps<TValue>): ReactNode;
+export declare function ResourceRowActionsMenu(props: ResourceRowActionsMenuProps): ReactNode;
+export declare function ResourceStatusBadge(props: ResourceStatusBadgeProps): ReactNode;
+export declare function ResourceSchedule(props: ResourceScheduleProps): ReactNode;
+export declare function ResourceTable<T>(props: ResourceTableProps<T>): ReactNode;
+export declare function ResourceTextCell(props: ResourceTextCellProps): ReactNode;
+export declare function WorkSection(props: WorkSectionProps): ReactNode;
+export declare function WorkSurface(props: WorkSurfaceProps): ReactNode;
+export declare function useContextQuery(): ContextQueryResult;
+export declare function useAffiliatedOperatingUnits(tenantId: string | undefined, legalEntityPublicId: string | null | undefined, permission: string, enabled?: boolean): OperatingUnitQueryResult;
+export declare function useAgentToolDataInvalidation(enabled?: boolean): void;
+export interface AgentToolDataFreshnessInput {
+    enabled: boolean;
+    refreshMs: number;
+    preview?: boolean;
+}
+export interface AgentToolDataFreshnessResult {
+    refetchInterval: number | false;
+    refetchOnWindowFocus: boolean;
+    staleTime: number;
+}
+/**
+ * The freshness half of a widget's useQuery options, resolved by the host.
+ * Polling pauses while the surrounding Work Tab is parked, the host enforces
+ * its dashboard-wide minimum cadence, and slower refresh hints are honored.
+ * Realtime invalidation is a shell-owned accelerator, not the cadence contract.
+ */
+export declare function useAgentToolDataFreshness(options: AgentToolDataFreshnessInput): AgentToolDataFreshnessResult;
+/**
+ * Stable identifier of the Work Tab that owns the surrounding App surface.
+ * Apps can use it to isolate session-only drafts that must survive a route-tree
+ * remount without leaking those drafts into durable browser storage.
+ */
+export declare function useActiveWorkTabId(): string | null;
+/**
+ * Whether the surrounding Work Tab is the visible pane rather than parked
+ * in the surface pool. Gate steady refetchInterval timers with this.
+ */
+export declare function useIsActiveWorkTabVisible(): boolean;
+export declare function useAssignableOperatingUnits(tenantId: string | undefined, legalEntityPublicId: string | null | undefined, permission: string, enabled?: boolean): OperatingUnitQueryResult;
+export declare function useAttachments(tenantId: string | undefined, attachableType: string, attachablePublicId: string | undefined): AttachmentQueryResult;
+/** Active-context Approval route-policy catalog for App-owned reference fields. */
+export declare function useApprovalRoutePoliciesQuery(tenantId: string | undefined, legalEntityPublicId: string | null, enabled?: boolean): ApprovalRoutePoliciesQueryResult;
+/** Shared approval lines always resolve from the stored record Legal Entity. */
+export declare function useApprovalSharedLinesQuery(tenantId: string | undefined, legalEntityPublicId: string | null, enabled?: boolean): ApprovalSharedLinesQueryResult;
+export declare function useDashboardWidgetAutoHeight(widgetId: unknown): DashboardWidgetAutoHeightRef;
+export declare function useDebouncedValue<T>(value: T, delayMs?: number): T;
+export declare function useDeleteAttachment(tenantId: string | undefined, attachableType: string, attachablePublicId: string | undefined): AttachmentDeleteResult;
+export declare function useLegalEntitiesQuery(tenantId: string | undefined): LegalEntityQueryResult;
+/** Active tenant catalog for tenant-owned record applicability; never a Shell switcher source. */
+export declare function useLegalEntityApplicabilityQuery(tenantId: string | undefined, permission: string, enabled?: boolean): LegalEntityApplicabilityQueryResult;
+/** Exact permission-authorized Legal Entity and Operating Unit targets for an App surface. */
+export declare function useOrganizationTargetsQuery(tenantId: string | undefined, permission: string, query?: OrganizationTargetQuery, enabled?: boolean): OrganizationTargetQueryResult;
+/** Page-owned read scope. Invalid or unavailable scope never supplies request parameters. */
+export declare function useOrganizationListScope(tenantId: string | undefined, permission: string, mode?: OrganizationListScopeMode, enabled?: boolean): OrganizationListScopeResult;
+/** Legal Entity-bounded member options for App-owned assignment fields. */
+export declare function useLegalEntityMembersQuery(tenantId: string | undefined, legalEntityPublicId: string | null, params?: LegalEntityMemberListParams, enabled?: boolean): LegalEntityMemberQueryResult;
+export declare function useOperatingUnitScope(tenantId: string | undefined, legalEntityPublicId: string | null | undefined, permission: string, enabled?: boolean): OperatingUnitScopeResult;
+export declare function useOperatingUnitSelection(tenantId: string | undefined, legalEntityPublicId: string | null, permission: string, enabled?: boolean): OperatingUnitSelectionResult;
+export declare function useOperatingUnitsQuery(tenantId: string | undefined, legalEntityPublicId: string | null | undefined, scope?: OperatingUnitQueryScope, permission?: string, enabled?: boolean): OperatingUnitQueryResult;
+export declare function useParties(tenantId: string | undefined, params: PartyListParams, enabled?: boolean): PartyQueryResult;
+export declare function useUploadAttachment(tenantId: string | undefined, attachableType: string, attachablePublicId: string | undefined, options?: AttachmentUploadOptions): AttachmentUploadResult;
+/**
+ * Starts a host-issued upload intent. The host may proxy the bytes or send
+ * them directly to object storage; App code never selects the transport.
+ */
+export declare function useUploadFile(): UploadFileClient;
+/** Lists metadata for assets that the host can safely apply to a bound resource. */
+export declare function useTrustedAssetsQuery(tenantId: string | undefined, legalEntityPublicId: string | null | undefined, params: TrustedAssetListParams, enabled?: boolean): TrustedAssetsQueryResult;
+/** Uploads a standalone Media resource through the configured Nexia host. */
+export declare function useUploadMedia(tenantId: string | undefined): MediaUploadResult;
+/** Sends a host-owned login invitation without exposing Core internals to an App. */
+export declare function sendUserInvitation(payload: UserInvitationPayload): Promise<UserInvitationResponse>;
+export declare function usePermissionsQuery(tenantId: string | undefined, legalEntityPublicId: string | null | undefined, operatingUnitPublicId?: string | null, enabled?: boolean): PermissionsQueryResult;
+/** Refreshes App-owned state when its committed resource projection changes. */
+export declare function useResourceProjectionChange(subscription: ResourceProjectionChangeSubscription): void;
+export declare function useResourceListParams(options?: UseResourceListParamsOptions): ResourceListParamsControls;
+/** URL-backed date range for an Insights destination. */
+export declare function useInsightFilterState(options?: UseInsightFilterStateOptions): InsightFilterControls;
+export interface UseDateTimeFormatterOptions {
+    fallback?: string;
+    dateFormat?: 'locale' | 'iso' | 'medium' | 'long';
+    timeFormat?: 'locale' | '12h' | '24h';
+}
+export declare function useDateTimeFormatter(options?: UseDateTimeFormatterOptions): DateTimeFormatter;
+export declare function useMessage(): MessageApi;
+export interface FeedbackMessage extends Pick<ToastOptions, 'description' | 'duration' | 'action'> {
+    title: string;
+}
+export type FeedbackMessageResolver<TValue, TArguments extends unknown[]> = string | FeedbackMessage | ((value: TValue, arguments_: TArguments) => string | FeedbackMessage);
+export interface FeedbackUndoOptions<TResult, TArguments extends unknown[], TUndoResult = void> {
+    /** Label for the success Toast action, for example "Undo". */
+    label: string;
+    /**
+     * Performs the inverse operation once with the successful result and the
+     * exact argument tuple captured by the original invocation.
+     */
+    operation: (result: TResult, arguments_: TArguments) => Promise<TUndoResult> | TUndoResult;
+    /** Feedback shown after the inverse operation succeeds. */
+    success: FeedbackMessageResolver<TUndoResult, TArguments>;
+    /** Feedback shown after the inverse operation fails. */
+    error: FeedbackMessageResolver<unknown, TArguments>;
+}
+export interface UseFeedbackActionOptions<TResult, TArguments extends unknown[], TUndoResult = void> {
+    success: FeedbackMessageResolver<TResult, TArguments>;
+    error: FeedbackMessageResolver<unknown, TArguments>;
+    /**
+     * Optional one-shot inverse operation exposed on the success Toast. A
+     * custom `success` message action takes precedence because a Toast has one
+     * action slot; existing arbitrary actions therefore keep their behavior.
+     */
+    undo?: FeedbackUndoOptions<TResult, TArguments, TUndoResult>;
+    /**
+     * Stable, namespaced operation identity. Repeated outcomes refresh one
+     * toast. A hook-instance identity is used when this is omitted.
+     */
+    dedupeKey?: string;
+}
+export interface FeedbackAction<TResult, TArguments extends unknown[]> {
+    /**
+     * Runs at most one operation at a time. Failures are presented and resolve
+     * with an undefined result, making this safe for fire-and-forget UI event
+     * handlers.
+     */
+    run: (...arguments_: TArguments) => Promise<TResult | undefined>;
+    /** Runs the same boundary but preserves rejection for advanced workflows. */
+    runOrThrow: (...arguments_: TArguments) => Promise<TResult>;
+    pending: boolean;
+}
+/**
+ * Adds standard pending, duplicate-submission, and result feedback behavior to
+ * an App operation without exposing the Shell message store.
+ *
+ * @example
+ * const save = useFeedbackAction(saveEmployee, {
+ *     success: 'Saved.',
+ *     error: 'Could not save.',
+ *     dedupeKey: 'employees:save',
+ *     undo: {
+ *         label: 'Undo',
+ *         operation: (saved, [input]) => restoreEmployee(saved.id, input),
+ *         success: 'Save undone.',
+ *         error: 'Could not undo the save.',
+ *     },
+ * });
+ *
+ * <NxActionButton
+ *     kind="save"
+ *     label="Save"
+ *     loading={save.pending}
+ *     onClick={() => void save.run(values)}
+ * />
+ */
+export declare function useFeedbackAction<TResult, TArguments extends unknown[], TUndoResult = void>(operation: (...arguments_: TArguments) => Promise<TResult> | TResult, options: UseFeedbackActionOptions<TResult, TArguments, TUndoResult>): FeedbackAction<TResult, TArguments>;
+export declare function useRegisterListLocateAction<Row>(options: UseRegisterListLocateActionOptions<Row>): void;
+export declare function useOpenResourceWorkTab(defaultIcon?: string): OpenResourceWorkTab;
+export declare function useRegisterResourceCreateReceiver(registration: ResourceCreateReceiverRegistration | null): void;
+export declare function useResourceCreateCompletion(): ResourceCreateCompletion;
+export declare function useMarkTabDirty(dirty: boolean): void;
+export declare function useRegisterTabActions(actions: TabContextActionRegistration[] | null): void;
+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.
+ */
+export declare function autoRegisterPackageResourceInspectors(modules: 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;
+export declare function keepPreviousResourceListData<TData>(queryScope: readonly unknown[]): (previousData: TData | undefined, previousQuery: {
+    readonly queryKey: readonly unknown[];
+} | undefined) => TData | undefined;
+export declare function readResourceListParams(searchParams: URLSearchParams, options?: UseResourceListParamsOptions): ResourceListParams;
+export declare function registerAgentComponent(name: string, renderer: AgentComponentRenderer): void;
+/** Register an App-owned Agent renderer without placing it in the App entry chunk. */
+export declare function registerLazyAgentComponent(name: string, loader: () => Promise<{
+    default: AgentComponentRenderer;
+}>): void;
+export declare function can(permissions: string[], permission: string): boolean;
+export declare function serializeResourceTableSort(sort: ResourceTableSort): string;
+export declare function serializeResourceTableSort(sort: ResourceTableSort | null | undefined): string | undefined;
+export declare const approvalComposerBusinessFormRegistry: ApprovalBusinessFormRegistrar;
+export declare const dataMigrationRegistry: DataMigrationRegistrar;
+export declare const processUserTaskFormRegistry: ProcessUserTaskFormRegistrar;
+/** Stable Resource-key resolver for cross-App contextual create flows. */
+export declare const resourceCreateDestinationRegistry: Pick<ResourceCreateDestinationRegistry, 'register' | 'resolve'>;
+export declare const resourceInspectorAdapterRegistry: ResourceInspectorAdapterRegistrar;
+/** Shared spreadsheet editor; the caller owns document persistence. */
+export declare function NxSpreadsheetEditor(props: NxSpreadsheetEditorProps): ReactNode;