Thay đổi của SDK POS Apps (@pancake-pos/ui-extensions, @pancake-pos/ui, @pancake-pos/app-cli, @pancake-pos/eslint-plugin, create-pos-app). Các gói phát hành cùng số phiên bản.
- App đã deploy không cần làm gì: runtime do POS phục vụ nên sửa lỗi và element mới có hiệu lực ngay. Mọi thay đổi trong
api_version2026-01chỉ thêm, không phá code cũ. - Dự án đang viết nên cập nhật để có type, luật kiểm tra, tài liệu và ví dụ mới cho MCP. CLI tự nhắc khi có bản mới (Cập nhật SDK):
Terminal
npm i @pancake-pos/ui@latest @pancake-pos/ui-extensions@latest
npm i -D @pancake-pos/app-cli@latest @pancake-pos/eslint-plugin@latestDùng MCP thì khởi động lại MCP server sau khi cập nhật.
2026.1.13
pos.apigọi được danh mục địa chỉ của Open API:/geo/provinces,/geo/districts,/geo/communes(trước đây báoinvalid_path). Trang iframe cần build lại bằng SDK này.
2026.1.12
- Trang iframe:
PosModal,PosDrawermở thì POS làm mờ dòng tiêu đề, menu và thanh trên quanh iframe như modal của POS; bấm vùng mờ hay nhấn Esc đóng lớp trên cùng.Modal,Drawercủa antd hay thư viện khác dùngusePosBackdrop(open, onClose). Xem Modal và drawer phủ cả POS. - Runtime API:
pos.page.setBackdrop(on)và sự kiệnbackdrop-dismisscho trang iframe. - Luật mới cho
page/(cảnh báo):Modal,Drawer,Modal.confirmcủa antd chỉ phủ iframe; dùngPosModal/PosDrawer,pos.ui.modal/drawer,pos.ui.confirm. PosModalkhông tự focus nút đóng,PosDrawerkhông vẽ viền focus quanh màn hình, như modal của POS.- Trang iframe đã deploy cần build lại bằng SDK này để có lớp mờ (gói
@pancake-pos/uinằm trong bundle của app).
2026.1.11
Giao diện trang iframe
@pancake-pos/uicó component React cho cả 36 elementpos-*(PosPage,PosSection,PosStat,PosTable…), cùng tên, thuộc tính, sự kiện{ detail }với Worker UI. POS cũng vẽ Worker UI bằng các component này, nên trang iframe giống trang Worker UI tới từng điểm ảnh. Xem Giao diện trang iframe.PosProvidernạp font Inter kèm gói, bỏ thẻ trắng quanh iframe để trang nằm trên nền xám như trang của POS, đưaheading,description, nút củaPosPagelên dòng tiêu đề của POS. Trang đang tự vẽ nền trắng toàn trang:<PosProvider frame="card">giữ như cũ. App đã deploy bằng SDK cũ không đổi.- Token màu, chữ, khoảng cách:
tokens,@pancake-pos/ui/tokens.css,tailwind.css(Tailwind 4),tailwind-preset(Tailwind 3),fonts.css. Có tiếng Lào cho antd.
Runtime API
pos.ui.modal,pos.ui.drawer: mở trang iframe của app trong modal/drawer phủ cả POS từ block, action, trang; trang bên trong cópos.data.presentation, đóng và trả kết quả bằngpos.close(result).pos.page.setHeader(tiêu đề, mô tả, tối đa 5 nút trên dòng tiêu đề; sự kiệnheader-action) vàpos.page.setFramecho trang iframe.connect({ optional: true }),isEmbedded(),PosProvider standalone,usePosOptional(): trang tự host mở được cả ngoài POS.
Kiểm tra, mẫu
- Luật mới cho
page/(cảnh báo): thư viện UI khác, màu ngoài bảng màu POS, tiền tự định dạng, file vào không dùngPosProvider.pos-app checkbáo lỗi<link>,@import,@font-facetrỏ ra ngoài gói (CSP chặn khi chạy). - Trang iframe của
create-pos-appdùngPosPage,PosFilterBar,PosTable.get_examplethêmiframe-reportvàself-hosted.
2026.1.10
pos-app loginkết nối qua trình duyệt: trang Kết nối CLI của POS cho chọn nhiều cửa hàng một lần, không phải sao chép token.login --tokenvẫn dùng cho CI. Dự án đang viết cần cập nhật SDK trước: CLI cũ chưa cóloginqua trình duyệt và bỏ quadeploy --all.- Một app cho nhiều cửa hàng:
deploy --allhoặc--shoplặp lại,versionsliệt kê từng cửa hàng, lệnh mớishopsvàuse,logout --shop. - MCP không gắn một cửa hàng: tool
list_shops;deploynhậnshopshoặcall;get_errorsgộp lỗi mọi cửa hàng;list_shop_meta,sample_contextnhậnshop.
2026.1.9
- CLI nhắc khi có SDK mới:
npm run check,build,deploy,devin lệnh cập nhật; kết quả--jsonvà tool MCP (check_app,deploy,get_errors) có trườngupdateđể AI đề nghị cập nhật. Tắt bằngPOS_APP_NO_UPDATE_CHECK=1. - Luật
pos-app/valid-elements: element, thuộc tính hay sự kiện lạ mà không giống tên nào thì gợi ý cập nhật SDK (thường do code viết theo tài liệu mới hơn). - Trang Có gì mới này.
2026.1.8
Component
- Mới:
pos-switch,pos-radio-group,pos-time-picker,pos-file-input(POS đọc CSV/Excel thành bảng cho app). pos-table:rowsnhận thẳng bản ghi Open API,keycủa cột là đường dẫn (customer.name,items.0.sku); cột "Thao tác"rowActionsvớionRowAction; cộtcopyable.pos-select: tìm qua API bằngonSearchvàloading.pos-date-picker:timeđể chọn cả giờ.pos-modal:width(520, 720, 1000 px). Footer củapos-modal,pos-drawernhận thêmpos-menu-button,pos-link.
API (runtime-api)
pos.api.paginatetải nhiều trang song song trong giới hạn tần suất;pos.api.get(path, { cache })nhớ danh mục.pos.download({ sheet }): POS dựng file.xlsxhoặc.csvtừ cột và dòng.pos.navigate({ resource: 'order', id })mở đơn ở tab mới.pos.formatđịnh dạng số, tiền, ngày như POS.pos.clipboard.copy.
Runtime và công cụ
- Giá trị sai schema (kiểu sai, element đặt sai chỗ, chữ quá dài) không còn dừng extension: POS bỏ phần sai và ghi vào nhật ký lỗi.
- Chế độ phát triển ghi cảnh báo "Màn hình chuẩn" (
standard_screen) vào nhật ký, đọc bằngget_errors. - Tool MCP
get_example: app mẫu hoàn chỉnh (báo cáo, danh sách có panel chi tiết, nhập từ file, block trong form đơn, mẫu in, hook).
2026.1.7
- Element cho màn báo cáo và danh sách:
pos-stat,pos-date-range,pos-menu-button,pos-description-list,pos-timeline,pos-progress,pos-empty,pos-drawer. pos-table: cộtformatbadge, link, percent,tones,subtitle,sortable,fixed,ellipsis;sort,summary,selectable,selected; sự kiệnonSortChange,onSelectionChange,onCellClick.pos-chart: kết hợp cột và đường, biểu đồ ngang, phần trăm.pos-button:icon,tooltip.pos.downloadtải file app tạo.- Luật
pos-app/standard-screen(cảnh báo) theo Màn hình chuẩn; templatecreate-pos-appcó trang báo cáo mẫu. - Tool MCP
search_api,get_apitra endpoint Open API. - Sửa: chế độ phát triển không tải được dữ liệu khi POS gọi API qua
pos.pancake.vn.
2026.1.6
- Tài liệu và template chạy CLI qua
npm run …hoặcnpx @pancake-pos/app-cli …(góipos-apptrên npm không phải của Pancake).
2026.1.5
- Target khách hàng:
customer.details.action,customer.index.action,customer.index.selection-action,customer.index.column.
2026.1.4
- Trang Worker UI (
app.pagevớirender: "worker") và element trang:pos-page,pos-tabs,pos-filter-bar,pos-chart. - Cột trong danh sách (
<resource>.index.column), mẫu in của app (<resource>.print-action), khối hồ sơ khách hàng (customer.details.block).
