@nexia/sdk 0.6.4 → 0.6.6

package/dist/host.d.ts

@@ -5,7 +5,7 @@ import type { ApprovalBusinessFormRegistrar, ApprovalBusinessFormRegistry } from
 import type { ContextQueryResult, PermissionsQueryResult } from './context';
 import type { DataMigrationBackgroundOperationClient, DataMigrationRegistrar, DataMigrationRegistry } from './data-migration';
 import type { ProcessUserTaskFormRegistrar, ProcessUserTaskFormRegistry } from './process';
-import type { AppRouteFrameProps, AutoRegisterPackageSurfacesOptions, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, MessageApi, MutationFormError, NxAdaptiveSplitProps, NxActionButtonProps, NxAlertProps, NxButtonProps, NxLinkButtonProps, NxIconButtonProps, NxIconLinkProps, NxCanonicalRoutePaneProps, NxCheckboxProps, NxColumnBrowserProps, NxColumnPickerProps, NxComboboxProps, NxDatePickerProps, NxDateRangePickerProps, NxDetailRowProps, NxEmptyViewProps, NxFieldGroupProps, NxFieldLegendProps, NxFieldsetProps, NxFileDropzoneProps, NxFormFieldProps, NxFormSectionProps, NxDropdownMenuProps, NxInsightFilterBarProps, NxInsightSurfaceProps, NxHelpTooltipProps, NxOverviewBandProps, InsightFilterControls, UseInsightFilterStateOptions, NxLoadingBlockProps, NxModalDialogProps, NxOrgChartProps, NxMissingRequiredReferencesAlertProps, NxPageFrameProps, NxPaginationProps, NxRadioGroupProps, NxRadioProps, NxRefreshControlProps, NxSearchFieldProps, NxSectionCardProps, 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 { AppRouteFrameProps, AutoRegisterPackageSurfacesOptions, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, MessageApi, MutationFormError, NxAdaptiveSplitProps, NxActionButtonProps, NxAlertProps, NxButtonProps, NxLinkButtonProps, NxIconButtonProps, NxIconLinkProps, NxCanonicalRoutePaneProps, NxCheckboxProps, NxColumnBrowserProps, NxColumnPickerProps, NxComboboxProps, NxDatePickerProps, NxDateRangePickerProps, NxDetailRowProps, NxEmptyViewProps, NxFieldGroupProps, NxFieldLegendProps, NxFieldsetProps, NxFileDropzoneProps, NxFormFieldProps, NxFormSectionProps, NxDropdownMenuProps, NxInsightFilterBarProps, NxInsightSurfaceProps, NxHelpTooltipProps, NxOverviewBandProps, InsightFilterControls, UseInsightFilterStateOptions, NxLoadingBlockProps, NxModalDialogProps, NxOrgChartProps, NxMissingRequiredReferencesAlertProps, NxPageFrameProps, NxPaginationProps, NxRadioGroupProps, NxRadioProps, NxRefreshControlProps, NxSearchFieldProps, NxSectionCardProps, NxSectionStackProps, NxResponsiveRegionProps, NxSelectProps, NxStatCardProps, NxStatusBadgeProps, NxTabNavProps, NxTextAreaProps, NxTextInputProps, NxTooltipProps, OpenResourceWorkTab, ResourceCreateCompletion, ResourceCreateReceiverRegistration, ResourceInspectorAdapterRegistry, ResourceInspectorAdapterRegistrar, ResourceInspectorPanelProps, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListParams, ResourceListParamsControls, ResourceListToolbarMoreMenuProps, ResourcePrimaryCellProps, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableProps, ResourceTableSort, ResourceTextCellProps, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, TabContextActionRegistration, RegisterDraftActionOptions, ToastOptions, WorkSectionProps, FavoriteTarget, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps } from './shell';
 import type { 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';
@@ -262,7 +262,8 @@ export interface NexiaAppFrontendHostBindings {
         useLegalEntityMembersQuery: (tenantId: string | undefined, legalEntityPublicId: string | null, params?: LegalEntityMemberListParams, enabled?: boolean) => LegalEntityMemberQueryResult;
         useActiveWorkTabId: () => string | null;
         useIsActiveWorkTabVisible: () => boolean;
-        useMarkTabDirty: (dirty: boolean) => void;
+        useMarkTabDirty: (dirty: boolean, snapshot?: string, initialSnapshot?: string) => void;
+        useClearTabDirty: () => () => void;
         useMessage: () => MessageApi;
         useOpenResourceWorkTab: (defaultIcon?: string) => OpenResourceWorkTab;
         useRegisterResourceCreateReceiver: (registration: ResourceCreateReceiverRegistration | null) => void;
@@ -274,6 +275,7 @@ export interface NexiaAppFrontendHostBindings {
         usePermissionsQuery: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, operatingUnitPublicId?: string | null, enabled?: boolean) => PermissionsQueryResult;
         useResourceProjectionChange: (subscription: ResourceProjectionChangeSubscription) => void;
         useRegisterTabActions: (actions: TabContextActionRegistration[] | null) => void;
+        useRegisterDraftAction: (options: RegisterDraftActionOptions) => void;
         useRegisterListLocateAction: <Row>(options: UseRegisterListLocateActionOptions<Row>) => void;
         useResourceListParams: (options?: UseResourceListParamsOptions) => ResourceListParamsControls;
         useTrustedAssetsQuery: (tenantId: string | undefined, legalEntityPublicId: string | null | undefined, params: TrustedAssetListParams, enabled?: boolean) => TrustedAssetsQueryResult;
@@ -563,8 +565,10 @@ export declare function useRegisterListLocateAction<Row>(options: UseRegisterLis
 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 useMarkTabDirty(dirty: boolean, snapshot?: string, initialSnapshot?: string): void;
+export declare function useClearTabDirty(): () => 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;
 export declare function useWorkSurfaceLabels(input: WorkSurfaceLabelInput): WorkSurfaceLabels;
 export declare function autoRegisterPackageSurfaces(options: AutoRegisterPackageSurfacesOptions): void;

package/dist/host.js

@@ -688,12 +688,18 @@ export function useRegisterResourceCreateReceiver(registration) {
 export function useResourceCreateCompletion() {
     return host().hooks.useResourceCreateCompletion();
 }
-export function useMarkTabDirty(dirty) {
-    host().hooks.useMarkTabDirty(dirty);
+export function useMarkTabDirty(dirty, snapshot, initialSnapshot) {
+    host().hooks.useMarkTabDirty(dirty, snapshot, initialSnapshot);
+}
+export function useClearTabDirty() {
+    return host().hooks.useClearTabDirty();
 }
 export function useRegisterTabActions(actions) {
     host().hooks.useRegisterTabActions(actions);
 }
+export function useRegisterDraftAction(options) {
+    host().hooks.useRegisterDraftAction(options);
+}
 export function useWorkTabLabel(label) {
     host().hooks.useWorkTabLabel(label);
 }

package/dist/index.d.ts

@@ -1,6 +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, NxResourceFormLegalEntityFieldProps, ResourceInformationControlProjection, ResourceInformationControlSlot, ResourceInformationCustomProjection, ResourceInformationEditProjection, ResourceInformationEditRenderContext, ResourceInformationField, ResourceInformationFieldSpan, ResourceInformationMode, ResourceInformationReadOnlyProjection, ResourceInformationRequirement, ResourceInformationSchema, ResourceInformationSection, ResourceInformationTranslator, ResourceInformationValue, } from "./resources/resource-information";
+export type { NxResourceInformationFormProps, NxResourceInformationViewProps, ResourceFormLegalEntity, ResourceFormBinding, NxResourceFormLegalEntityFieldProps, ResourceInformationControlProjection, ResourceInformationControlSlot, ResourceInformationCustomProjection, ResourceInformationEditProjection, ResourceInformationEditRenderContext, ResourceInformationField, ResourceInformationFieldSpan, ResourceInformationMode, ResourceInformationReadOnlyProjection, ResourceInformationRequirement, ResourceInformationSchema, ResourceInformationSection, ResourceInformationTranslator, ResourceInformationValue, } from "./resources/resource-information";
 export type { DatasetImportConfirmationSummary, ResourceImportPreview, ResourceImportPreviewRow, ResourceImportResponse, ResourceImportRun, ResourceImportRunStatus, ResourceImportSummary, ResourceTransferFormat, ResourceTransferMessage, ResourceTransferMeta, NxResourceImportDialogProps, NxResourceTransferActionsProps, NxDatasetImportWorkspaceProps, NxDatasetExportWorkspaceProps, } from "./resources/resource-transfer";
 export type { 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";
@@ -35,7 +36,7 @@ export type { ApprovalActor, ApprovalBodySnapshot, ApprovalBusinessFormControlle
 export { APPROVAL_STATES, APPROVAL_STEP_KINDS } from "./approval";
 export type { BpmnEditorDocument, BpmnEditorElement, BpmnEditorNodeType, BpmnEditorProcess, DmnEditorDocument, DmnEditorHitPolicy, DmnEditorInputClause, DmnEditorOutputClause, DmnEditorRule, DmnEditorValueType, ProcessUserTaskFormController, ProcessUserTaskFormRegistrar, ProcessUserTaskFormRegistration, ProcessUserTaskFormRegistry, ProcessUserTaskFormSlotPropsV1, ProcessUserTaskFormWidgetLoader, ProcessUserTaskResourceRef, } from "./process";
 export { DMN_EDITOR_HIT_POLICIES } from "./process";
-export type { AppRouteFrameProps, AppRoutePrefetchContext, AppRoutePrefetcher, AutoRegisterPackageSurfacesOptions, PackageSurfaceLoader, PackageSurfaceOverride, PackageSurfaceOverrideRegistration, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, ListLocateRecord, MessageApi, MutationFormError, NxCanonicalRoutePaneProps, NxActionKind, NxIconButtonProps, NxComboboxOption, NxComboboxProps, NxRefreshControlProps, NxColumnBrowserLabels, NxColumnBrowserProps, NxColumnNode, NxColumnPickerLabels, NxColumnPickerProps, NxDatePickerLabels, NxDatePickerProps, NxDateRangePickerProps, NxDateRangeValue, NxDropdownMenuItem, NxHelpTooltipProps, InsightFilterControls, InsightFilterState, InsightQueryLike, InsightRangePreset, UseInsightFilterStateOptions, NxOverviewBandCard, NxSelectOption, NxStatDelta, NxStatDeltaDirection, NxStatDeltaTone, NxTabNavItem, NxTabNavProps, NxTooltipAlign, NxTooltipProps, NxTooltipSide, OpenResourceWorkTab, OpenResourceWorkTabOptions, ResourceCreateCompletion, ResourceCreateCompletionInput, ResourceCreateContinuationTarget, ResourceCreateReceiverRegistration, ResourceInspectorAdapter, ResourceInspectorAdapterLoader, ResourceInspectorAdapterProps, ResourceInspectorAdapterRegistry, ResourceInspectorPanelProps, ResourceInspectorStack, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListFilters, ResourceListFilterValue, ResourceListFooterConfig, ResourceListParams, ResourceListParamsControls, ResourceListRefreshConfig, ResourceListToolbarConfig, ResourceListToolbarMoreMenuProps, ResourceListToolbarViewOption, ResourcePrimaryCellProps, ResourceActionDescriptor, ResourceRef, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableColumn, ResourceTableAccess, ResourceTableDensity, ResourceTableProps, ResourceTableStyle, ResourceTableSummaryRow, ResourceTableSort, TabContextActionContext, TabContextActionRegistration, TabContextActionResult, ResourceTextCellProps, ToastOptions, ToastSource, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, WorkSectionProps, FavoriteTarget, WorkTabRef, WorkSurfaceAction, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps, } from "./shell";
+export type { AppRouteFrameProps, AppRoutePrefetchContext, AppRoutePrefetcher, AutoRegisterPackageSurfacesOptions, PackageSurfaceLoader, PackageSurfaceOverride, PackageSurfaceOverrideRegistration, FormFieldErrors, InspectorActionProps, InspectorResourceActionsProps, ListLocateRecord, MessageApi, MutationFormError, NxCanonicalRoutePaneProps, NxActionKind, NxIconButtonProps, NxComboboxOption, NxComboboxProps, NxRefreshControlProps, NxColumnBrowserLabels, NxColumnBrowserProps, NxColumnNode, NxColumnPickerLabels, NxColumnPickerProps, NxDatePickerLabels, NxDatePickerProps, NxDateRangePickerProps, NxDateRangeValue, NxDropdownMenuItem, NxHelpTooltipProps, InsightFilterControls, InsightFilterState, InsightQueryLike, InsightRangePreset, UseInsightFilterStateOptions, NxOverviewBandCard, NxSelectOption, NxStatDelta, NxStatDeltaDirection, NxStatDeltaTone, NxTabNavItem, NxTabNavProps, NxTooltipAlign, NxTooltipProps, NxTooltipSide, OpenResourceWorkTab, OpenResourceWorkTabOptions, ResourceCreateCompletion, ResourceCreateCompletionInput, ResourceCreateContinuationTarget, ResourceCreateReceiverRegistration, ResourceInspectorAdapter, ResourceInspectorAdapterLoader, ResourceInspectorAdapterProps, ResourceInspectorAdapterRegistry, ResourceInspectorPanelProps, ResourceInspectorStack, ResourceInspectorStackHostProps, ResourceInspectorStackProviderProps, ResourceInspectorStateProps, ResourceLinkProps, ResourceListFilters, ResourceListFilterValue, ResourceListFooterConfig, ResourceListParams, ResourceListParamsControls, ResourceListRefreshConfig, ResourceListToolbarConfig, ResourceListToolbarMoreMenuProps, ResourceListToolbarViewOption, ResourcePrimaryCellProps, ResourceActionDescriptor, ResourceRef, ResourceRowActionsMenuProps, ResourceStatusBadgeProps, ResourceTableColumn, ResourceTableAccess, ResourceTableDensity, ResourceTableProps, ResourceTableStyle, ResourceTableSummaryRow, ResourceTableSort, TabContextActionContext, TabContextActionRegistration, DraftFieldBinding, RegisterDraftActionOptions, TabContextActionResult, ResourceTextCellProps, ToastOptions, ToastSource, UseRegisterListLocateActionOptions, UseResourceListParamsOptions, WorkSectionProps, FavoriteTarget, WorkTabRef, WorkSurfaceAction, WorkSurfaceLabelInput, WorkSurfaceLabels, WorkSurfaceProps, } from "./shell";
 export { FavoriteButton } from "./host";
 export type { FavoriteButtonProps } from "./host";
 export { createSpreadsheetWorkbook } from "./spreadsheet";

package/dist/index.js

@@ -1,3 +1,4 @@
+export { draftStringField } from './resources/draft-field.js';
 export { defineResourceInformationSchema, resourceInformationValue, } from "./resources/resource-information.js";
 export { createDataMigrationSessionCheckpointStore, dataMigrationUploadAccept, dataMigrationRunPublicId, isDataMigrationOperationAccepted, } from "./data-migration.js";
 export { projectSignatureCapabilityCatalog, signatureCapabilityIdentity, } from "./signature.js";

package/dist/resources/draft-field.d.ts

@@ -0,0 +1,9 @@
+import type { DraftFieldBinding } from '../shell';
+/** Binds one App-owned text/choice state to a draft action without submitting it. */
+export declare function draftStringField<T extends string>(value: T, initialValue: T, apply: (value: T) => void, rules: {
+    maxLength: number;
+    minLength?: number;
+    trim?: boolean;
+    values?: readonly T[];
+    pattern?: string;
+}): DraftFieldBinding;

package/dist/resources/draft-field.js

@@ -0,0 +1,22 @@
+/** Binds one App-owned text/choice state to a draft action without submitting it. */
+export function draftStringField(value, initialValue, apply, rules) {
+    return {
+        value, initialValue,
+        inputSchema: { type: 'string', maxLength: rules.maxLength,
+            ...(rules.minLength === undefined ? {} : { minLength: rules.minLength }),
+            ...(rules.pattern === undefined ? {} : { pattern: rules.pattern }),
+            ...(rules.values === undefined ? {} : { enum: rules.values }) },
+        parse(input) {
+            if (typeof input !== 'string')
+                throw new Error('Expected text');
+            const parsed = rules.trim ? input.trim() : input;
+            const length = Array.from(parsed).length;
+            if (length > rules.maxLength || length < (rules.minLength ?? 0)
+                || (rules.pattern !== undefined && !new RegExp(rules.pattern, 'u').test(parsed))
+                || (rules.values && !rules.values.includes(parsed)))
+                throw new Error('Invalid field value');
+            return parsed;
+        },
+        apply: next => apply(next),
+    };
+}

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

@@ -60,6 +60,8 @@ export interface ResourceInformationField<TViewContext, TEditContext> {
     /** 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[];
@@ -109,6 +111,8 @@ 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.
@@ -118,6 +122,17 @@ export interface NxResourceInformationFormProps<TViewContext, TEditContext> {
     emptyValue: ReactNode;
     testIdPrefix?: string;
 }
+export interface ResourceFormBinding {
+    /** 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;
+    /** 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

package/dist/shell.d.ts

@@ -3,6 +3,7 @@ import type { QueryClient } from "@tanstack/react-query";
 import type { PermissionsResponse } from "./context";
 import type { ResourcePickerRevalidation, ResourceReferenceIdentity } from "./resource-reference";
 import type { ResourceListSchema } from "./resources/resource-list";
+import type { ResourceFormBinding } from "./resources/resource-information";
 import type { ResourceTransferMeta } from "./resources/resource-transfer";
 /** A server-authorized, durable favorite identity. */
 export type FavoriteTarget = {
@@ -232,6 +233,11 @@ interface NxComboboxBaseProps<TValue extends string | number> {
     emptyLabel?: ReactNode;
     searchValue?: string;
     onSearchChange?: (query: string) => void;
+    /** Await an authorized query using the same source as the displayed options. */
+    searchOptions?: {
+        scopeKey: string;
+        search: (query: string, signal?: AbortSignal) => Promise<readonly NxComboboxOption<TValue>[]>;
+    };
     loading?: boolean;
     id?: string;
     describedBy?: string;
@@ -614,6 +620,7 @@ export interface NxIconLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorEle
     className?: string;
 }
 export interface NxCheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size" | "type"> {
+    onCheckedChange?: (checked: boolean) => void;
     inputSize?: "sm" | "md";
     indeterminate?: boolean;
     label?: string;
@@ -732,6 +739,9 @@ export interface NxOrgChartProps {
     testId?: string;
 }
 export interface NxFormFieldProps {
+    /** Canonical field identity; schema forms already supply it and must not repeat it. */
+    fieldKey?: string;
+    sensitive?: boolean;
     label: ReactNode;
     labelTooltip?: ReactNode;
     children: (context: {
@@ -749,6 +759,8 @@ export interface NxFormFieldProps {
     className?: string;
 }
 export interface NxFormSectionProps {
+    /** Explicit unsaved semantics for composed forms; uses published route identity. */
+    binding?: ResourceFormBinding;
     id?: string;
     children: ReactNode;
     onSubmit?: (event: FormEvent<HTMLFormElement>) => void;
@@ -1022,12 +1034,15 @@ export interface NxTextAreaProps extends Omit<TextareaHTMLAttributes<HTMLTextAre
     invalid?: boolean;
     autoResize?: boolean;
     resizable?: boolean;
+    onValueChange?: (value: string) => void;
 }
 export interface NxTextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size"> {
     inputSize?: "md" | "lg";
     appearance?: "field" | "title";
     mono?: boolean;
     invalid?: boolean;
+    /** Controlled value writer shared by direct editing and form integrations. */
+    onValueChange?: (value: string) => void;
 }
 export interface NxDatePickerLabels {
     calendar: string;
@@ -1165,12 +1180,36 @@ export interface TabContextActionContext {
     signal?: AbortSignal;
 }
 export interface TabContextActionRegistration {
+    /** Declares read or local draft work; neither saves nor submits. */
+    effect?: "read" | "draft";
     type: string;
     label: string;
     description?: string;
     inputSchema?: Record<string, unknown>;
     run: (payload: Record<string, unknown>, context: TabContextActionContext) => TabContextActionResult | Promise<TabContextActionResult>;
 }
+/** Explicit form-owner binding. Reference resolution and field rules stay in the App. */
+export interface DraftFieldBinding {
+    value: unknown;
+    initialValue: unknown;
+    inputSchema: Record<string, unknown>;
+    /** Return a canonical value or throw for invalid/unresolved input. */
+    parse: (input: unknown) => unknown;
+    apply: (value: unknown) => void;
+}
+export interface RegisterDraftActionOptions {
+    actionType: string;
+    label: string;
+    description?: string;
+    resourceKey: string;
+    resourceId: string | null;
+    /** Local form context identity (for example tenant and selected create owner); never grants authority. */
+    scopeKey?: string;
+    enabled: boolean;
+    fields: Record<string, DraftFieldBinding>;
+    /** Return invalid field keys for App-owned cross-field constraints, before any writer runs. */
+    validateBatch?: (values: Readonly<Record<string, unknown>>) => readonly string[];
+}
 export interface WorkSurfaceLabelInput {
     action: WorkSurfaceAction;
     resourceLabel: string;
@@ -1227,12 +1266,21 @@ export interface ListLocateRecord {
     hint?: string;
     showUrl?: string;
     editUrl?: string;
+    /** Authorized edit destination's draft-only action; the host still verifies
+     * the mounted action, record and completion before reporting success. */
+    editDraft?: {
+        resourceKey: string;
+        action: string;
+        inputSchema: Record<string, unknown>;
+    };
 }
 export interface UseRegisterListLocateActionOptions<Row> {
     actionType: string;
     label: string;
     description?: string;
     enabled: boolean;
+    /** Tenant/authority/organization identity; exclude ordinary search text. */
+    scopeKey?: string;
     schema: ResourceListSchema | undefined;
     params: Pick<ResourceListParamsControls, "setParams" | "perPage">;
     fetchPage: (params: ResourceListParams) => Promise<{

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nexia/sdk",
-    "version": "0.6.4",
+    "version": "0.6.6",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",