@nexia/sdk 0.8.17 → 0.8.18

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/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.18",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",