@pancake-pos/ui-extensions 2026.1.4 → 2026.1.5

package/dist/types.d.ts

@@ -1,4 +1,6 @@
 export type Resource = 'order' | 'product' | 'purchase' | 'export' | 'warehouse_transfer';
+/** Resource có danh sách và action: 5 resource có form chi tiết và khách hàng (`customer.*`). */
+export type ListResource = Resource | 'customer';
 export type OrderRef = {
     /** Mã đơn hiển thị (mã tuỳ chỉnh nếu shop dùng, ngược lại là mã hệ thống). */
     id: string | number;
@@ -104,7 +106,7 @@ export type WarehouseTransferDraft = {
         quantity: number;
     }[];
 };
-/** Khách hàng (`customer.details.block`). `id` dùng với Open API: `/shops/{shop_id}/customers/{id}`. */
+/** Khách hàng (`customer.*`). `id` dùng với Open API: `/shops/{shop_id}/customers/{id}`. */
 export type CustomerRef = {
     id: string;
     name: string;
@@ -120,6 +122,7 @@ interface Refs {
     purchase: PurchaseRef;
     export: ExportRef;
     warehouse_transfer: WarehouseTransferRef;
+    customer: CustomerRef;
 }
 interface Drafts {
     order: OrderDraft;
@@ -128,7 +131,7 @@ interface Drafts {
     export: ExportDraft;
     warehouse_transfer: WarehouseTransferDraft;
 }
-export type RefOf<R extends Resource> = Refs[R];
+export type RefOf<R extends ListResource> = Refs[R];
 export type DraftOf<R extends Resource> = Drafts[R];
 /** Form chi tiết: `*.details.action`, `*.details.block`, `*.before_submit`. */
 export type DetailsData<R extends Resource = Resource> = {
@@ -140,12 +143,12 @@ export type DetailsData<R extends Resource = Resource> = {
     draft: DraftOf<R>;
 };
 /** Một dòng của danh sách: `*.index.action`. */
-export type IndexData<R extends Resource = Resource> = {
+export type IndexData<R extends ListResource = ListResource> = {
     resource: R;
     record: RefOf<R>;
 };
 /** Thanh thao tác hàng loạt: `*.index.selection-action` (tối đa 500 bản ghi). */
-export type SelectionData<R extends Resource = Resource> = {
+export type SelectionData<R extends ListResource = ListResource> = {
     resource: R;
     records: RefOf<R>[];
 };
@@ -171,7 +174,7 @@ export type BeforeSubmitResult = {
     ok: false;
     message: string;
 };
-/** Khối trong hồ sơ khách hàng: `customer.details.block`. */
+/** Hồ sơ khách hàng: `customer.details.block`, `customer.details.action` (cùng dạng `IndexData<'customer'>`). */
 export type CustomerData = {
     resource: 'customer';
     record: CustomerRef;
@@ -189,7 +192,7 @@ export type PrintResult = {
     title?: string;
 };
 /** Bản ghi đang hiển thị trên trang danh sách: `<resource>.index.column` (tối đa 500). */
-export type ColumnData<R extends Resource = Resource> = {
+export type ColumnData<R extends ListResource = ListResource> = {
     resource: R;
     records: RefOf<R>[];
 };
@@ -210,10 +213,11 @@ export type PageData = {
     query: Record<string, string>;
 };
 export type DetailsTarget<R extends Resource = Resource> = `${R}.details.action` | `${R}.details.block`;
-export type Target = 'app.page' | DetailsTarget | `${Resource}.index.action` | `${Resource}.index.selection-action` | `${Resource}.before_submit` | `${Resource}.after_save` | `${Resource}.index.column` | `${PrintResource}.print-action` | 'customer.details.block';
-type ResourceOf<T extends string> = T extends `${infer R extends Resource}.${string}` ? R : never;
+export type Target = 'app.page' | DetailsTarget | `${ListResource}.index.action` | `${ListResource}.index.selection-action` | `${Resource}.before_submit` | `${Resource}.after_save` | `${ListResource}.index.column` | `${PrintResource}.print-action` | 'customer.details.block' | 'customer.details.action';
+type ResourceOf<T extends string> = T extends `${infer R extends ListResource}.${string}` ? R : never;
+type FormResourceOf<T extends string> = Extract<ResourceOf<T>, Resource>;
 /** `pos.data` và tham số của module theo target. */
-export type DataOf<T extends Target> = T extends 'app.page' ? PageData : T extends 'customer.details.block' ? CustomerData : T extends `${infer R extends PrintResource}.print-action` ? PrintData<R> : T extends `${string}.index.column` ? ColumnData<ResourceOf<T>> : T extends `${string}.index.selection-action` ? SelectionData<ResourceOf<T>> : T extends `${string}.index.action` ? IndexData<ResourceOf<T>> : T extends `${string}.after_save` ? AfterSaveInput<ResourceOf<T>> : DetailsData<ResourceOf<T>>;
+export type DataOf<T extends Target> = T extends 'app.page' ? PageData : T extends 'customer.details.block' | 'customer.details.action' ? CustomerData : T extends `${infer R extends PrintResource}.print-action` ? PrintData<R> : T extends `${string}.index.column` ? ColumnData<ResourceOf<T>> : T extends `${string}.index.selection-action` ? SelectionData<ResourceOf<T>> : T extends `${string}.index.action` ? IndexData<ResourceOf<T>> : T extends `${string}.after_save` ? AfterSaveInput<FormResourceOf<T>> : DetailsData<FormResourceOf<T>>;
 /** Giá trị module trả về theo target (action có giao diện và block tự render, không trả gì). */
 export type ResultOf<T extends Target> = T extends `${string}.print-action` ? PrintResult : T extends `${string}.index.column` ? ColumnResult : T extends `${string}.before_submit` ? BeforeSubmitResult : T extends `${string}.after_save` | `${string}.details.block` | 'app.page' ? void : HeadlessActionResult;
 export type ToastOptions = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pancake-pos/ui-extensions",
-  "version": "2026.1.4",
+  "version": "2026.1.5",
   "description": "Types for pos and pos-* elements, defineExtension, and connect() for iframe pages of Pancake POS apps",
   "license": "UNLICENSED",
   "type": "module",