@nexia/sdk 0.8.12 → 0.8.13

package/README.md

@@ -69,3 +69,76 @@ an SDK-only update does not install server routes.
 Test both a successful call and a denied call through an actual development
 frame or installed App transport. For invitations, use a test mail sink; for
 imports, verify the terminal result as well as the initial 202 response.
+
+## Search and select dialogs
+
+`NxLookupDialog` from `@nexia/sdk/host` presents an owner-authorized server page
+with search, filter slots, sorting and single/multiple selection. Supply
+`NxLookupRow` values with stable IDs, readable labels and column cells. The
+component retains draft selections across page/query changes; `onApply` returns
+the complete selected rows, while `onClose` cancels without changing `value`.
+An empty selection is returned as `[]`; the caller decides whether this means
+no selection or an unrestricted list filter. Select-all applies only to enabled
+rows on the current page, never all matching records on the server.
+
+Keep API calls, debounce/cancellation, permissions, filter semantics and page
+reset in the owner component. Set `loading` while a page/query is changing to
+prevent selection from stale results. Supply `error` and `onRetry` on failure.
+`filters` holds frequent controls and `advancedFilters` the collapsible details;
+`activeFilterCount` keeps active advanced conditions visible when collapsed.
+`maxSelection` bounds a multiple-selection workflow. The host provides localized
+controls, modal focus/dismissal, and a selected-items view. Use the matching Core
+host implementation before adopting this SDK export. Existing comboboxes remain
+appropriate for small option lists; this does not replace every selector.
+
+For a single choice without checkboxes/radios or an Apply step, set
+`multiple={false} applyOnSelect`. Clicking a row (or activating its first-cell
+button with Enter/Space) calls `onApply([row])`, then `onClose()` immediately.
+Disabled/loading rows cannot apply. Cancel/close still leaves the value intact.
+Omit `applyOnSelect` to keep single-selection radio buttons and explicit Apply;
+in multiple-selection mode it is ignored so checking a row never closes the dialog.
+
+## Dedicated lookup fields
+
+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.
+
+`NxLookupField` displays the applied value and opens the shared `NxLookupDialog`.
+It supports typed string/number values, single/multiple selection, create
+continuation, refresh, and optional selected-item chips. Single selection applies
+and closes immediately. Multiple selection stays in a draft until Apply;
+`onChange(values, options)` returns the complete chosen values **and options**,
+including `([], [])` when cleared. Cancel preserves the applied value.
+
+The resource owner supplies authorized `options`, `columns`, optional `getCells`
+(or each option's `cells`), `filters`, `advancedFilters`, `activeFilterCount`, and
+`actions`. Additional buttons belong in `actions`; the shared component retains
+Apply/Cancel. API calls, permissions, filter state, debounce and server sorting
+remain with the owner. `sort`/`onSortChange` expose sortable headers; they do not
+sort a loaded page. `createAction` and `resourceCreateContinuation` keep the
+existing create-and-return contract.
+
+Supply `pagination={{ page, pageSize, total, onPageChange }}` for a server page.
+Without pagination, only the supplied collection is searched/paged locally in
+groups of 25; this does not fetch missing records. Controlled search uses
+`searchValue`/`onSearchChange`; the owner resets server pages when scope, filters
+or search change. Controlled search is retained on close, while local search is
+cleared. Optional `open`/`onOpenChange` can enable a query only while open.
+Provide `loading`, `error`, and `onRetry` for changing pages and recovery.
+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.
+
+| Earlier draft prop | `NxLookupField` prop |
+|---|---|
+| `presentation="dialog"` | Remove; the component always opens a dialog |
+| `lookupColumns` / `lookupCells` | `columns` / `getCells` |
+| `lookupFilters` / `lookupAdvancedFilters` | `filters` / `advancedFilters` |
+| `lookupActiveFilterCount` / `lookupError` | `activeFilterCount` / `error` |
+| Multi `onChange(values, changedOption)` | `onChange(values, selectedOptions)` |
+
+`NxLookupDialog` remains available for composition that already owns its trigger.
+Current-page select-all never means every matching record on the server.

package/changelog/0.8.13/en.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.13
+date: 2026-10-24
+title: Shared lookup and document field contracts
+description: Frontend contracts for reusable lookup and document field selection.
+---
+
+- Use `NxLookupField` contracts for single or multiple selection, columns, filters, pagination and authorized creation.
+- Document data and App catalog types preserve source ownership, versions and field identities.
+- Adopt the matching Core 0.8.152 host adapters before using these contracts. Publication does not establish host availability.

package/changelog/0.8.13/ko.md

@@ -0,0 +1,11 @@
+---
+status: published
+version: 0.8.13
+date: 2026-10-24
+title: 공통 조회와 문서 필드 계약
+description: 재사용 가능한 조회 및 문서 필드 선택용 프런트엔드 계약을 제공합니다.
+---
+
+- `NxLookupField` 계약으로 단일·다중 선택, 열, 필터, 페이지 이동 및 권한에 따른 생성을 연결합니다.
+- 문서 데이터와 앱 카탈로그 타입이 소스 소유자, 버전 및 필드 식별자를 보존합니다.
+- 사용 전 대응 Core 0.8.152 호스트 어댑터를 채택해야 합니다. 패키지 게시만으로 호스트 사용 가능 상태가 보장되지는 않습니다.

package/changelog/unreleased/en.md

@@ -5,3 +5,35 @@ status: draft
 The `organization.workforce` v1 slot lets Apps supply workforce views for an authorized Legal Entity. The detailed guide covers props, registration, scoped permissions, and verification.
 
 [Implement the workforce slot](https://developers.nexia.to/docs/platform-extensions-add-slot-widget)
+
+### Search and select records in context
+
+Apps can use `NxLookupDialog` for paginated record selection with search,
+owner-provided filters, sorting, and single or multiple selection. Draft choices
+survive page and search changes; Apply commits the choices and Cancel preserves
+the caller's previous value. Current-page selection is distinct from selecting
+all records matching a query. Adopt the matching Core host before using this
+new frontend SDK export; queries and access checks remain owner responsibilities.
+
+Single-choice callers can set `multiple={false} applyOnSelect` to hide selection controls and apply/close immediately when a row is chosen.
+
+### Dedicated lookup fields
+
+Use `NxLookupField` for record lookup fields, with owner-defined columns,
+filters, actions and pagination. It preserves applied choices across pages and
+keeps multiple-selection changes pending until Apply. The earlier draft
+`NxCombobox` dialog API is removed: migrate to `NxLookupField`, rename the
+lookup-prefixed props, and receive all selected options in the multiple
+`onChange` callback. Adopt the matching SDK and Core host together; no released
+minimum version is declared by this draft. See the
+[frontend host guide](https://developers.nexia.to/docs/app-sdk-frontend-host-contracts#dedicated-lookup-fields).
+
+
+## Shared document field selection
+
+`NxDocumentDataFieldPicker` accepts an App-owned metadata loader and returns a
+stable field binding. It supports App/source/field browsing, server search, paging
+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).

package/changelog/unreleased/ko.md

@@ -5,3 +5,34 @@ status: draft
 `organization.workforce` v1 슬롯으로 App이 권한 있는 법인의 직원 배치 보기를 제공할 수 있습니다. 상세 문서에서 props, 등록, 범위별 권한과 확인 방법을 설명합니다.
 
 [직원 배치 슬롯 구현하기](https://developers.nexia.to/ko/docs/platform-extensions-add-slot-widget)
+
+### 작업 중 레코드 검색·선택
+
+앱에서 `NxLookupDialog`를 사용해 검색, 앱이 제공하는 필터, 정렬과 페이지
+이동을 갖춘 단일·복수 선택 화면을 구성할 수 있습니다. 검색어나 페이지를
+바꿔도 임시 선택이 유지되며, 적용하면 반영하고 취소하면 기존 값을 유지합니다.
+현재 페이지 선택은 검색 결과 전체 선택과 구분됩니다. 이 프런트엔드 SDK
+내보내기를 사용하기 전에 대응하는 Core 호스트를 적용해야 하며, 조회와
+접근 권한 검사는 데이터를 제공하는 쪽이 계속 담당합니다.
+
+단일 선택에서는 `multiple={false} applyOnSelect`로 선택 표시를 숨기고 항목을 고르는 즉시 적용·닫기 동작을 사용할 수 있습니다.
+
+### 독립 조회 필드
+
+`NxLookupField`로 리소스별 컬럼·필터·추가 버튼·페이지네이션을 갖춘 조회 필드를
+구성합니다. 페이지가 바뀌어도 적용된 선택을 보존하고 다중 선택은 적용 전까지
+임시 상태로 유지합니다. 이전 초안의 `NxCombobox` dialog API를 제거하므로
+`NxLookupField`로 교체하고 조회 전용 속성 이름을 변경하세요. 다중 `onChange`는
+전체 선택 옵션을 반환합니다. 대응하는 SDK와 Core 호스트를 함께 적용해야 하며,
+이 초안에서 출시된 최소 버전은 지정하지 않습니다. 자세한 이관 방법은
+[프런트엔드 호스트 가이드](https://developers.nexia.to/ko/docs/app-sdk-frontend-host-contracts#독립-조회-필드)에 있습니다.
+
+
+## 공통 문서 필드 선택
+
+`NxDocumentDataFieldPicker`는 앱이 제공하는 메타데이터 조회 함수로 앱·소스·필드를
+탐색하고 고정된 필드 연결을 반환합니다. 서버 검색·페이지·재시도를 지원하며,
+`buildAppCatalogTree`는 이미 인가된 선택지의 그룹 구성을 공유합니다.
+대응하는 Core 호스트를 먼저 적용해야 합니다. 이 초안에서 출시된 최소 버전은
+지정하지 않으며 자세한 내용은
+[프런트엔드 호스트 가이드](https://developers.nexia.to/ko/docs/app-sdk-frontend-host-contracts)에 있습니다.

package/dist/app-catalog.d.ts

@@ -0,0 +1,13 @@
+import type { NxColumnNode } from './shell';
+export interface AppCatalogGroup {
+    key: string;
+    label: string;
+    order?: number;
+}
+export interface AppCatalogLeaf {
+    family: AppCatalogGroup;
+    app: AppCatalogGroup;
+    node?: NxColumnNode;
+}
+/** Shared presentation only. Consumers supply their already-authorized choices. */
+export declare function buildAppCatalogTree(entries: readonly AppCatalogLeaf[]): NxColumnNode[];

package/dist/app-catalog.js

@@ -0,0 +1,18 @@
+/** Shared presentation only. Consumers supply their already-authorized choices. */
+export function buildAppCatalogTree(entries) {
+    const families = new Map();
+    for (const entry of entries) {
+        if (!families.has(entry.family.key))
+            families.set(entry.family.key, { group: entry.family, apps: new Map() });
+        const apps = families.get(entry.family.key).apps;
+        if (!apps.has(entry.app.key))
+            apps.set(entry.app.key, { group: entry.app, children: [] });
+        if (entry.node)
+            apps.get(entry.app.key).children.push(entry.node);
+    }
+    const order = (a, b) => (a.group.order ?? 999) - (b.group.order ?? 999)
+        || a.group.key.localeCompare(b.group.key, undefined, { sensitivity: 'base' });
+    return [...families.values()].sort(order).map(({ group, apps }) => ({ value: `family:${group.key}`, label: group.label,
+        children: [...apps.values()].sort(order).map(({ group: app, children }) => ({ value: `app:${app.key}`, label: app.label, children })),
+    }));
+}

package/dist/document-data.d.ts

@@ -0,0 +1,57 @@
+export interface DocumentDataFieldBinding {
+    app_key: string;
+    source_key: string;
+    source_version: number;
+    field_key: string;
+}
+export interface DocumentDataCatalogItem {
+    app_key: string;
+    app_name: string;
+    app_family?: string;
+    app_labels?: Record<string, string>;
+    source_key?: string;
+    source_version?: number;
+    label?: string;
+    label_key?: string;
+    cardinality?: 'one' | 'many';
+    field?: {
+        key: string;
+        label: string;
+        label_key: string;
+        type: string;
+        formatters: string[];
+    };
+    binding?: DocumentDataFieldBinding;
+    sample?: unknown;
+    legacy_source?: string;
+}
+export interface DocumentDataCatalogFilters {
+    stage: 'apps' | 'sources' | 'fields';
+    app_key?: string;
+    source_key?: string;
+    source_version?: number;
+    q?: string;
+    offset?: number;
+    limit?: number;
+}
+export interface DocumentDataCatalogPage {
+    data: DocumentDataCatalogItem[];
+    next_offset: number | null;
+    local_fields?: {
+        source: string;
+        label_key: string;
+    }[];
+}
+export interface NxDocumentDataFieldPickerProps {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    loadPage: (filters: DocumentDataCatalogFilters) => Promise<DocumentDataCatalogPage>;
+    onSelect: (field: DocumentDataCatalogItem | {
+        local_source: string;
+        label: string;
+    }) => void;
+    isDisabled?: (field: DocumentDataCatalogItem) => boolean;
+}
+/** Save this exact tuple, never a list index, label or field-group position. */
+export declare function documentDataFieldIdentity(binding: DocumentDataFieldBinding): string;

package/dist/document-data.js

@@ -0,0 +1,4 @@
+/** Save this exact tuple, never a list index, label or field-group position. */
+export function documentDataFieldIdentity(binding) {
+    return JSON.stringify([binding.app_key, binding.source_key, binding.source_version, binding.field_key]);
+}

package/dist/host.d.ts

@@ -1,3 +1,7 @@
+import type { NxDocumentDataFieldPickerProps } from './document-data';
+export type { NxDocumentDataFieldPickerProps } from './document-data';
+import type { NxLookupDialogProps, NxLookupFieldProps } from "./shell";
+export type { NxLookupDialogProps, NxLookupRow, NxLookupFieldProps, NxLookupOption } from "./shell";
 import type { NxSpreadsheetEditorProps } from "./spreadsheet";
 import { type ComponentType, type ReactNode } from 'react';
 import type { AxiosInstance } from 'axios';
@@ -172,6 +176,9 @@ export interface NexiaAppFrontendHostBindings {
         NxCheckbox: typeof NxCheckbox;
         NxColumnBrowser: typeof NxColumnBrowser;
         NxColumnPicker: typeof NxColumnPicker;
+        NxDocumentDataFieldPicker: (props: NxDocumentDataFieldPickerProps) => ReactNode;
+        NxLookupDialog: (props: NxLookupDialogProps) => ReactNode;
+        NxLookupField: <TValue extends string | number>(props: NxLookupFieldProps<TValue>) => ReactNode;
         NxCombobox: <TValue extends string | number>(props: NxComboboxProps<TValue>) => ReactNode;
         NxOperatingUnitSelector: ComponentType<NxOperatingUnitSelectorProps>;
         NxOrganizationTargetSelector: ComponentType<NxOrganizationTargetSelectorProps>;
@@ -401,6 +408,7 @@ export declare function NxRefreshControl(props: NxRefreshControlProps): ReactNod
 export declare function NxColumnBrowser(props: NxColumnBrowserProps): ReactNode;
 export declare function NxColumnPicker(props: NxColumnPickerProps): ReactNode;
 export declare function NxCombobox<TValue extends string | number>(props: NxComboboxProps<TValue>): ReactNode;
+export declare function NxLookupField<TValue extends string | number>(props: NxLookupFieldProps<TValue>): ReactNode;
 export declare function NxOperatingUnitSelector(props: NxOperatingUnitSelectorProps): ReactNode;
 export declare function NxOrganizationTargetSelector(props: NxOrganizationTargetSelectorProps): ReactNode;
 export declare function NxActions(props: NxActionsProps): ReactNode;
@@ -669,3 +677,5 @@ export declare const resourceInspectorAdapterRegistry: ResourceInspectorAdapterR
 /** Shared spreadsheet editor; the caller owns document persistence. */
 export declare function NxSpreadsheetEditor(props: NxSpreadsheetEditorProps): ReactNode;
 import type { NxActionsProps } from './actions';
+export declare function NxLookupDialog(props: NxLookupDialogProps): ReactNode;
+export declare function NxDocumentDataFieldPicker(props: NxDocumentDataFieldPickerProps): ReactNode;

package/dist/host.js

@@ -299,6 +299,9 @@ export function NxColumnPicker(props) {
 export function NxCombobox(props) {
     return createElement((host().components.NxCombobox), props);
 }
+export function NxLookupField(props) {
+    return createElement((host().components.NxLookupField), props);
+}
 export function NxOperatingUnitSelector(props) {
     return render(host().components.NxOperatingUnitSelector, props);
 }
@@ -947,3 +950,9 @@ export const resourceInspectorAdapterRegistry = {
 export function NxSpreadsheetEditor(props) {
     return render(host().components.NxSpreadsheetEditor, props);
 }
+export function NxLookupDialog(props) {
+    return render(host().components.NxLookupDialog, props);
+}
+export function NxDocumentDataFieldPicker(props) {
+    return render(host().components.NxDocumentDataFieldPicker, props);
+}

package/dist/index.d.ts

@@ -42,3 +42,8 @@ export type { FavoriteButtonProps } from "./host";
 export { createSpreadsheetWorkbook } from "./spreadsheet";
 export type { SpreadsheetWorkbook, SpreadsheetWorksheet, SpreadsheetCell, NxSpreadsheetEditorProps } from "./spreadsheet";
 export type { ActionPlacement, ActionTargets, NxActionsProps } from './actions';
+export type { NxLookupDialogProps, NxLookupRow, NxLookupFieldProps, NxLookupOption } from "./shell";
+export { documentDataFieldIdentity } from './document-data';
+export type { DocumentDataFieldBinding, DocumentDataCatalogItem, DocumentDataCatalogFilters, DocumentDataCatalogPage, NxDocumentDataFieldPickerProps } from './document-data';
+export { buildAppCatalogTree } from './app-catalog';
+export type { AppCatalogGroup, AppCatalogLeaf } from './app-catalog';

package/dist/index.js

@@ -20,3 +20,5 @@ export { APPROVAL_STATES, APPROVAL_STEP_KINDS } from "./approval.js";
 export { DMN_EDITOR_HIT_POLICIES } from "./process.js";
 export { FavoriteButton } from "./host.js";
 export { createSpreadsheetWorkbook } from "./spreadsheet.js";
+export { documentDataFieldIdentity } from './document-data.js';
+export { buildAppCatalogTree } from './app-catalog.js';

package/dist/shell.d.ts

@@ -108,6 +108,10 @@ export interface NxModalDialogProps {
     showClose?: boolean;
 }
 export interface NxColumnNode {
+    section?: {
+        key: string;
+        label: string;
+    };
     value: string;
     label: string;
     children?: NxColumnNode[];
@@ -124,6 +128,10 @@ export interface NxColumnBrowserLabels {
     breadcrumbSeparator?: string;
 }
 export interface NxColumnBrowserProps {
+    onBrowse?: (value: string | null) => void;
+    onSearchChange?: (query: string) => void;
+    remoteSearchResults?: NxColumnNode[];
+    notice?: ReactNode;
     roots: NxColumnNode[];
     value?: string | null;
     selectedValues?: readonly string[];
@@ -147,6 +155,10 @@ export interface NxColumnPickerLabels extends NxColumnBrowserLabels {
     select?: string;
 }
 interface NxColumnPickerBaseProps {
+    onBrowse?: (value: string | null) => void;
+    onSearchChange?: (query: string) => void;
+    remoteSearchResults?: NxColumnNode[];
+    notice?: ReactNode;
     open: boolean;
     onClose: () => void;
     title: string;
@@ -1410,4 +1422,131 @@ export interface MutationFormError {
     formError: string | null;
     fieldErrors: FormFieldErrors;
 }
+/** A bounded server page. Selection survives search and page changes until Apply. */
+export interface NxLookupRow {
+    value: string;
+    label: string;
+    cells: Record<string, ReactNode>;
+    disabled?: boolean;
+    disabledReason?: string;
+}
+/** An authorized choice; the owner may attach resource-specific data. */
+export interface NxLookupOption<TValue extends string | number> {
+    value: TValue;
+    label: ReactNode;
+    meta?: ReactNode;
+    trailing?: ReactNode;
+    searchText?: string;
+    cells?: Record<string, ReactNode>;
+    disabled?: boolean;
+    disabledReason?: string;
+}
+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>[];
+    placeholder: ReactNode;
+    ariaLabel: string;
+    description?: string;
+    id?: string;
+    describedBy?: string;
+    invalid?: boolean;
+    fullWidth?: boolean;
+    disabled?: boolean;
+    size?: "xs" | "sm" | "md";
+    triggerClassName?: string;
+    testId?: string;
+    /** Optional controlled open state, e.g. to enable an owner query on open. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    searchValue?: string;
+    onSearchChange?: (query: string) => void;
+    searchPlaceholder?: string;
+    emptyLabel?: ReactNode;
+    searchOptions?: {
+        scopeKey: string;
+        search: (query: string, signal?: AbortSignal) => Promise<readonly NxLookupOption<TValue>[]>;
+    };
+    /** Omit only when options is the complete authorized collection. */
+    pagination?: {
+        page: number;
+        pageSize: number;
+        total: number;
+        onPageChange: (page: number) => void;
+    };
+    columns?: readonly {
+        key: string;
+        label: string;
+        sortable?: boolean;
+    }[];
+    getCells?: (option: NxLookupOption<TValue>) => Record<string, ReactNode>;
+    filters?: ReactNode;
+    advancedFilters?: ReactNode;
+    activeFilterCount?: number;
+    /** Additional owner actions beside the search/filter controls. */
+    actions?: ReactNode;
+    sort?: string;
+    onSortChange?: (sort: string) => void;
+    loading?: boolean;
+    error?: string | null;
+    onRetry?: () => void;
+    maxSelection?: number;
+    renderSummary?: (selected: NxLookupOption<TValue>[]) => ReactNode;
+    showSelectedItems?: boolean;
+    selectedItemsAriaLabel?: string;
+    removeSelectedItemLabel?: (option: NxLookupOption<TValue>) => string;
+    createAction?: {
+        label: string;
+        onCreate: (query: string) => void;
+        disabled?: boolean;
+    };
+    revalidateOnOpen?: ResourcePickerRevalidation;
+    resourceCreateContinuation?: TValue extends string ? ResourceCreateContinuationTarget : never;
+}
+/** A field that opens a lookup dialog; it has no popover presentation. */
+export type NxLookupFieldProps<TValue extends string | number> = (NxLookupFieldBaseProps<TValue> & {
+    multiple?: false;
+    value: TValue | null;
+    onChange: (value: TValue, option: NxLookupOption<TValue>) => void;
+}) | (NxLookupFieldBaseProps<TValue> & {
+    multiple: true;
+    value: readonly TValue[];
+    /** Complete applied selection, including [] when cleared. */
+    onChange: (values: TValue[], options: NxLookupOption<TValue>[]) => void;
+});
+export interface NxLookupDialogProps {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    description?: string;
+    multiple?: boolean;
+    /** Single selection only: hide selection controls, apply a row immediately, then call onClose. */
+    applyOnSelect?: boolean;
+    value: readonly NxLookupRow[];
+    onApply: (rows: NxLookupRow[]) => void;
+    rows: readonly NxLookupRow[];
+    columns: readonly {
+        key: string;
+        label: string;
+        sortable?: boolean;
+    }[];
+    search: string;
+    onSearchChange: (value: string) => void;
+    searchPlaceholder?: string;
+    emptyLabel?: ReactNode;
+    filters?: ReactNode;
+    actions?: ReactNode;
+    advancedFilters?: ReactNode;
+    activeFilterCount?: number;
+    page: number;
+    pageSize: number;
+    total: number;
+    onPageChange: (page: number) => void;
+    sort?: string;
+    onSortChange?: (sort: string) => void;
+    loading?: boolean;
+    error?: string | null;
+    onRetry?: () => void;
+    maxSelection?: number;
+}
 export {};

package/package.json

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