@nexia/sdk 0.8.13 → 0.8.15

package/README.md

@@ -132,6 +132,13 @@ Provide `selectedOptions` for applied choices absent from the initial page;
 applied labels are retained across subsequent page changes. Values remain the
 source of truth. Scope changes must clear unauthorized selections in the owner.
 
+For a page scope with `mode="legal-entity-operating-unit-list"`, set
+`operatingUnitPicker="lookup"` on `NxOrganizationTargetSelector` to use a
+lookup dialog for Operating Units while preserving the Legal Entity selector.
+This is a fixed choice made by the page, independent of result count. Exact
+pairs, authority checks and URL query handling are unchanged. Use the matching
+SDK and Core host; omitting this optional prop retains the existing picker.
+
 | Earlier draft prop | `NxLookupField` prop |
 |---|---|
 | `presentation="dialog"` | Remove; the component always opens a dialog |

package/changelog/0.8.14/en.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.14
+date: 2026-10-27
+title: Organization lookup and list contracts
+description: Choose operating units through lookup and declare date filters and export fields.
+---
+
+Use `operatingUnitPicker="lookup"` with the combined organization selector, declare list filters with `kind: "dateRange"`, and map export fields with `ResourceTableColumn.exportKey`. Existing defaults remain compatible. Adopt Core 0.8.159 before using these options; Apps retain filter validation and row authorization. See the [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts).

package/changelog/0.8.14/ko.md

@@ -0,0 +1,9 @@
+---
+status: published
+version: 0.8.14
+date: 2026-10-27
+title: 조직 조회와 목록 계약
+description: 운영조직 조회창과 날짜 필터·내보내기 필드 매핑을 선언합니다.
+---
+
+법인·운영조직 선택기에 `operatingUnitPicker="lookup"`을 지정하고, 목록 필터에 `kind: "dateRange"`, 내보내기 필드에 `ResourceTableColumn.exportKey`를 사용할 수 있습니다. 기존 기본 동작은 유지됩니다. 이 옵션을 사용하기 전에 Core 0.8.159를 적용하고 앱의 필터 검증과 행 권한 검사를 유지하세요. [프런트엔드 호스트 가이드](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts)를 참고하세요.

package/changelog/0.8.15/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.15
+date: 2026-10-28
+title: Approval receipt and record print contracts
+description: Distinguish an accepted approval submission from a case and declare record print layouts.
+---
+
+React SDK 0.8.15 lets an approval business form return either `caseId` or `submissionId`. A `submissionId` means the host accepted work for later processing; it does not mean an Approval Case exists yet. Handle both results when enabling asynchronous approval with matching Core and runtime support. See the [approval contract guide](https://developers.nexia.to/docs/app-sdk-approval-contracts).
+
+Resource table and transfer action props also accept `recordPrint` for an optional per-record print layout. Adopt the matching Core host before using it. See the [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts).

package/changelog/0.8.15/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.15
+date: 2026-10-28
+title: 결재 접수 영수증과 레코드 인쇄 계약
+description: 접수된 결재 요청과 결재 건을 구분하고 레코드별 인쇄 구성을 선언합니다.
+---
+
+React SDK 0.8.15에서 결재 업무 폼은 `caseId` 또는 `submissionId`를 반환할 수 있습니다. `submissionId`는 호스트가 나중에 처리할 작업을 접수했다는 뜻이며, 아직 결재 건이 생성됐다는 뜻은 아닙니다. 비동기 결재를 활성화할 때는 대응하는 Core·런타임과 함께 두 결과를 처리하세요. [결재 계약 안내](https://developers.nexia.to/ko/docs/app-sdk-approval-contracts)를 참고하세요.
+
+리소스 표와 전송 작업 속성에 선택적인 레코드별 인쇄 구성 `recordPrint`가 추가되었습니다. 사용 전에 대응하는 Core 호스트를 적용하세요. [프런트엔드 호스트 안내](https://developers.nexia.to/ko/docs/app-sdk-frontend-host-contracts)를 참고하세요.

package/changelog/unreleased/en.md

@@ -37,3 +37,5 @@ and retry. `buildAppCatalogTree` shares grouping for already-authorized choices.
 Adopt the matching Core host before using these exports; no released minimum
 version is declared by this draft. See the
 [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts).
+
+`NxOrganizationTargetSelector` also accepts `operatingUnitPicker="lookup"` in combined Legal Entity/Operating Unit mode. It changes only the Operating Unit picker and requires the matching host. See the [frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts#dedicated-lookup-fields).

package/changelog/unreleased/ko.md

@@ -36,3 +36,5 @@ status: draft
 대응하는 Core 호스트를 먼저 적용해야 합니다. 이 초안에서 출시된 최소 버전은
 지정하지 않으며 자세한 내용은
 [프런트엔드 호스트 가이드](https://developers.nexia.to/ko/docs/app-sdk-frontend-host-contracts)에 있습니다.
+
+`NxOrganizationTargetSelector`의 법인·운영조직 모드에 `operatingUnitPicker="lookup"`을 지정하면 운영조직 부분만 조회 팝업으로 표시합니다. 대응하는 호스트가 필요합니다. [프런트엔드 호스트 가이드](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts#dedicated-lookup-fields)를 참고하세요.

package/dist/approval.d.ts

@@ -132,9 +132,14 @@ export interface ApprovalBusinessFormController {
 export interface ApprovalBusinessFormDraftResult {
     appDraftRef: string;
 }
-export interface ApprovalBusinessFormSubmitResult {
+/** A receipt is durable acceptance, not a submitted case. */
+export type ApprovalBusinessFormSubmitResult = {
     caseId: string;
-}
+    submissionId?: never;
+} | {
+    submissionId: string;
+    caseId?: never;
+};
 export interface ApprovalBusinessFormTemplate {
     key: string;
     version: number;

package/dist/organization-target.d.ts

@@ -73,6 +73,8 @@ export type NxOrganizationTargetSelectorProps = (OrganizationTargetSelectorBaseP
     onChange: (legalEntityPublicId: string) => void;
 }) | (OrganizationTargetSelectorBaseProps & {
     mode: 'legal-entity-operating-unit-list';
+    /** Fixed picker for Operating Units; Legal Entity controls keep their existing presentation. */
+    operatingUnitPicker?: 'combobox' | 'lookup';
     targets: readonly OrganizationTarget[];
     value: OrganizationTargetQuery;
     onChange: (query: OrganizationTargetQuery) => void;

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

@@ -1,6 +1,8 @@
 /** A filter definition published by a resource list endpoint. */
 export interface ResourceListFilterableEntry {
     key: string;
+    /** Defaults to options. Date ranges encode inclusive bounds as YYYY-MM-DD..YYYY-MM-DD. */
+    kind?: "options" | "dateRange";
     multiple: boolean;
     label: string;
     options: Array<{

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

@@ -118,6 +118,11 @@ export interface NxResourceImportDialogProps {
 }
 /** Host-owned Resource Transfer actions for list and management surfaces. */
 export interface NxResourceTransferActionsProps {
+    recordPrint?: {
+        label: string;
+        title: string;
+        columnKeys: readonly string[];
+    };
     transferMeta: ResourceTransferMeta | null | undefined;
     onImported: () => void | Promise<void>;
     translationPrefix?: string;

package/dist/shell.d.ts

@@ -404,6 +404,8 @@ export interface ResourceListFooterConfig {
     testId?: string;
 }
 export interface ResourceTableColumn<T> {
+    /** Export schema key; defaults to key. Keeps persisted column preferences stable. */
+    exportKey?: string;
     key: string;
     header: ReactNode;
     cell: (row: T, index: number) => ReactNode;
@@ -455,6 +457,12 @@ export interface ResourceTableProps<T> {
     filters?: ResourceListFilters;
     onFiltersChange?: (next: ResourceListFilters) => void;
     transferMeta?: ResourceTransferMeta | null;
+    /** Offer a per-record print layout alongside the selected-column list layout. */
+    recordPrint?: {
+        label: string;
+        title: string;
+        columnKeys: readonly string[];
+    };
     onTransferImported?: () => void | Promise<void>;
     pagination?: {
         current_page: number;

package/package.json

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