@nexia/sdk 0.8.16 → 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.17/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.17
+date: 2026-10-29
+title: Table menu commands and export restrictions
+description: Extend the shared table menu and describe permission-excluded export columns.
+---
+
+React SDK 0.8.17 adds optional `ResourceListToolbarConfig.moreItems` commands to the standard table menu while retaining export, print and column controls. Transfer metadata can declare `export_restricted_columns` as `{ key, label }` entries so the host explains permission exclusions. Existing callers remain compatible; use the matching Core host and keep row/field authorization in the App export source.
+
+See the [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts) and the [package artifact](https://www.npmjs.com/package/@nexia/sdk/v/0.8.17).

package/changelog/0.8.17/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.17
+date: 2026-10-29
+title: 표 메뉴 작업과 내보내기 권한 안내
+description: 공통 표 메뉴에 작업을 추가하고 권한으로 제외한 내보내기 열을 안내합니다.
+---
+
+React SDK 0.8.17은 선택 항목 `ResourceListToolbarConfig.moreItems`로 기본 내보내기·인쇄·열 설정 메뉴에 앱 작업을 추가합니다. 전송 메타데이터의 `export_restricted_columns`에 `{ key, label }` 항목을 전달하면 호스트가 권한으로 제외된 열을 안내합니다. 기존 호출도 호환됩니다. 대응하는 Core 호스트를 함께 적용하고 앱의 내보내기 조회에서 행·필드 권한을 계속 확인하세요.
+
+[프런트엔드 호스트 가이드](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts)와 [패키지 산출물](https://www.npmjs.com/package/@nexia/sdk/v/0.8.17)을 확인하세요.

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/resources/resource-transfer.d.ts

@@ -25,6 +25,11 @@ export interface ResourceTransferMeta {
         }>;
     };
     schema_hash: string;
+    /** Declared export fields omitted from schema.columns by column permissions. */
+    export_restricted_columns?: Array<{
+        key: string;
+        label: string;
+    }>;
     formats: ResourceTransferFormat[];
     export_formats?: ResourceTransferFormat[];
     import_formats?: ResourceTransferFormat[];
@@ -208,6 +213,8 @@ export interface NxDatasetImportWorkspaceProps {
         onChange: (key: string, value: string) => void;
         busy: boolean;
         previewIsCurrent: boolean;
+        /** Mark changed reference setup as needing review without starting a job. */
+        invalidatePreview: () => void;
         /** Reanalyze the uploaded file with the current App rules. */
         recheck: () => void;
     }) => ReactNode;

package/dist/shell.d.ts

@@ -382,6 +382,8 @@ export interface ResourceListToolbarConfig {
     filters?: ReactNode;
     refresh?: ReactNode;
     more?: ReactNode;
+    /** Commands appended to the standard export/print menu. */
+    moreItems?: NxDropdownMenuItem[];
     testId?: string;
 }
 export interface ResourceListRefreshConfig {
@@ -443,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. */
@@ -1453,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;
@@ -1533,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.16",
+    "version": "0.8.18",
     "description": "Frontend contracts for Nexia App Packages",
     "license": "UNLICENSED",
     "type": "module",