@nexia/sdk 0.8.17 → 0.8.19

package/README.md

@@ -103,8 +103,8 @@ in multiple-selection mode it is ignored so checking a row never closes the dial
 Use `NxLookupField` from `@nexia/sdk/host` for a field that opens a record lookup.
 `NxCombobox` now owns only popover list selection. The earlier draft
 `NxCombobox presentation="dialog"` API and its lookup-only props are removed.
-Adopt the matching SDK and Core host together; this draft does not declare a
-released minimum version.
+Use React SDK 0.8.13 and Core 0.8.152 or later together before adopting this
+field. Migrate the earlier dialog-only combobox props as shown below.
 
 `NxLookupField` displays the applied value and opens the shared `NxLookupDialog`.
 It supports typed string/number values, single/multiple selection, create
@@ -149,3 +149,21 @@ SDK and Core host; omitting this optional prop retains the existing picker.
 
 `NxLookupDialog` remains available for composition that already owns its trigger.
 Current-page select-all never means every matching record on the server.
+
+## Released host options
+
+Use the [frontend host guide](https://developers.nexia.to/en/docs/app-sdk-frontend-host-contracts)
+for the complete procedure and current host prerequisites. Existing optional
+props can remain omitted; new options require a compatible Core host.
+
+| React SDK | Capability | Core support |
+| --- | --- | --- |
+| 0.8.14 | Operating-unit lookup, `kind: "dateRange"`, `exportKey` | 0.8.159 |
+| 0.8.15 | `submissionId` and `recordPrint` | 0.8.173 with matching runtime |
+| 0.8.16 | `NEXIA_READ_ONLY_HEADER` | 0.8.167 |
+| 0.8.17 | Toolbar `moreItems`, `export_restricted_columns` | 0.8.170 |
+
+Import `NEXIA_READ_ONLY_HEADER` from `@nexia/sdk` or `@nexia/sdk/host` and
+send `{ [NEXIA_READ_ONLY_HEADER]: 'true' }` only for nonmutating POST queries.
+Never mark a save as read-only. A `submissionId` is an accepted request, not
+proof that a case exists. Keep denied rows/fields excluded from print/export.

package/changelog/0.8.18/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.18
+date: 2026-10-30
+title: Lookup selection and visible columns
+description: Select all authorized lookup results and observe visible table columns.
+---
+
+React SDK 0.8.18 adds `NxLookupField.selectAllOptions`, `NxLookupDialog.selectAllRows` and `ResourceTable.onVisibleColumnsChange`. Selection loaders must return all authorized results for the current query, honor cancellation and reject partial results. Apply/Cancel behavior remains unchanged. Visible columns may guide server search but never replace authorization before pagination. Adopt the matching Core host. See the [UI component guide](https://developers.nexia.to/docs/app-sdk-ui-components) and [package artifact](https://www.npmjs.com/package/@nexia/sdk/v/0.8.18).

package/changelog/0.8.18/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.18
+date: 2026-10-30
+title: 조회 결과 전체 선택과 표시 열
+description: 권한이 있는 조회 결과를 전체 선택하고 표의 표시 열 변경을 받습니다.
+---
+
+React SDK 0.8.18은 `NxLookupField.selectAllOptions`, `NxLookupDialog.selectAllRows`, `ResourceTable.onVisibleColumnsChange`를 추가합니다. 선택 로더는 현재 검색 조건에서 권한이 있는 전체 결과를 반환하고 취소 요청을 처리하며 불완전한 결과를 거부해야 합니다. 적용·취소 동작은 유지됩니다. 표시 열은 서버 검색 범위에 활용할 수 있지만 페이지 분할 전 권한 검사를 대체하지 않습니다. 대응 Core 호스트를 함께 적용하세요. [UI 컴포넌트 안내](https://developers.nexia.to/docs/app-sdk-ui-components)와 [패키지](https://www.npmjs.com/package/@nexia/sdk/v/0.8.18)를 참고하세요.

package/changelog/0.8.19/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.19
+date: 2026-11-02
+title: Import review recovery actions
+description: Offer an App-owned action when import reference review is blocked.
+---
+
+React SDK 0.8.19 adds the optional `onBlockedReviewActionChange` callback to `NxDatasetImportWorkspaceProps`. An App can provide a labeled recovery action, disable it while busy, or pass `null` to hide it. Clear the action when leaving the review. Existing callers remain compatible; unresolved rows still require server validation. Adopt the matching Core host before using this callback. See the [import and export guide](https://developers.nexia.to/docs/building-apps-import-and-export) and [npm package](https://www.npmjs.com/package/@nexia/sdk/v/0.8.19).

package/changelog/0.8.19/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.19
+date: 2026-11-02
+title: 가져오기 검토 복구 동작
+description: 가져오기 기준정보 검토가 막혔을 때 앱이 복구 동작을 제공할 수 있습니다.
+---
+
+React SDK 0.8.19의 `NxDatasetImportWorkspaceProps`에 선택적 `onBlockedReviewActionChange` 콜백을 추가했습니다. 앱은 이름이 있는 복구 동작을 제공하고, 처리 중에는 비활성화하거나 `null`로 숨길 수 있습니다. 검토 화면을 떠날 때 동작을 해제하세요. 기존 호출은 호환되며 해결되지 않은 행은 여전히 서버 검증이 필요합니다. 이 콜백을 사용하기 전에 대응하는 Core 호스트를 함께 적용하세요. [가져오기·내보내기 안내](https://developers.nexia.to/docs/building-apps-import-and-export)와 [npm 패키지](https://www.npmjs.com/package/@nexia/sdk/v/0.8.19)를 참고하세요.

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

@@ -187,6 +187,12 @@ export interface NxDatasetImportWorkspaceProps {
             count: number;
         }>;
         busy: boolean;
+        /** Replace the blocked-review notice actions with an App-owned recovery action. Null hides them. */
+        onBlockedReviewActionChange?: (action: {
+            label: string;
+            disabled: boolean;
+            onClick: () => void;
+        } | null) => void;
         recheck: () => void;
         /** Open an offered reference editor after preserving the import draft. */
         createReference: (kind: string, seed: string) => void;

package/dist/shell.d.ts

@@ -445,6 +445,8 @@ export interface ResourceTableProps<T> {
     labelTooltip?: ReactNode;
     rows: T[];
     columns: ResourceTableColumn<T>[];
+    /** Effective data columns after saved preferences, including host-added columns. */
+    onVisibleColumnsChange?: (keys: string[]) => void;
     /** Opt in to the host's card presentation. Omit for table-only list semantics. */
     renderCard?: (row: T, index: number) => ReactNode;
     /** Initial view when no actor-scoped table preference has been saved. */
@@ -1455,6 +1457,12 @@ interface NxLookupFieldBaseProps<TValue extends string | number> {
     options: readonly NxLookupOption<TValue>[];
     /** Supply applied choices that are absent from the current server page. */
     selectedOptions?: readonly NxLookupOption<TValue>[];
+    /** Complete authorized results for the current search/filters. Change scopeKey when that scope changes.
+     * Must reject on failure; never return a partial collection. Disabled options are excluded by the host. */
+    selectAllOptions?: {
+        scopeKey: string;
+        load: (signal: AbortSignal) => Promise<readonly NxLookupOption<TValue>[]>;
+    };
     placeholder: ReactNode;
     ariaLabel: string;
     description?: string;
@@ -1535,6 +1543,11 @@ export interface NxLookupDialogProps {
     value: readonly NxLookupRow[];
     onApply: (rows: NxLookupRow[]) => void;
     rows: readonly NxLookupRow[];
+    /** Optional complete authorized result loader; selection remains a draft until Apply. */
+    selectAllRows?: {
+        scopeKey: string;
+        load: (signal: AbortSignal) => Promise<readonly NxLookupRow[]>;
+    };
     columns: readonly {
         key: string;
         label: string;

package/package.json

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