@posx/core 5.5.388 → 5.5.390

package/CLAUDE.md

@@ -1,24 +1,24 @@
-# Claude AI Development Guidelines
-
-## Rules you have to follow strictly
-
-- You are top-notch programmer who always write simplest code to achieve the ideal result
-- you are one liner engineers and we believe "The Great Tao is Simple", so try to keep changes small and focused
-- keep the changes as minimal as possible
-- if or else has one line of code, then { } are not needed and it should be wrote into same line
-- DO NOT write uncessary comment do not make newlines within a function and try to make the code compact
-- All crucial code should have proper explanation in English
-- Keep the simplifications as small and focused within the function or scope.
-- Do not overhaul the whole file or codebase which is irrelevant to the current task.
-
-## Best Practices for AI-Assisted Development
-
-1. **在开始编码前先充分讨论和规划架构，确保理解用户的真实需求和使用场景，避免过度设计。**
-
-2. **不要急于提交代码，应该等待用户明确指示后再进行 commit 和 push 操作。**
-
-3. **优先选择简洁的实现方式（如函数导出而非类），并删除冗余的中间层方法以保持代码清晰。**
-
----
-
+# Claude AI Development Guidelines
+
+## Rules you have to follow strictly
+
+- You are top-notch programmer who always write simplest code to achieve the ideal result
+- you are one liner engineers and we believe "The Great Tao is Simple", so try to keep changes small and focused
+- keep the changes as minimal as possible
+- if or else has one line of code, then { } are not needed and it should be wrote into same line
+- DO NOT write uncessary comment do not make newlines within a function and try to make the code compact
+- All crucial code should have proper explanation in English
+- Keep the simplifications as small and focused within the function or scope.
+- Do not overhaul the whole file or codebase which is irrelevant to the current task.
+
+## Best Practices for AI-Assisted Development
+
+1. **在开始编码前先充分讨论和规划架构，确保理解用户的真实需求和使用场景，避免过度设计。**
+
+2. **不要急于提交代码，应该等待用户明确指示后再进行 commit 和 push 操作。**
+
+3. **优先选择简洁的实现方式（如函数导出而非类），并删除冗余的中间层方法以保持代码清晰。**
+
+---
+
 *This file contains guidelines learned from AI-human collaboration to improve development efficiency and code quality.*

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2019 Francisco Hodge
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2019 Francisco Hodge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,85 +1,85 @@
-# 第一阶段
-- 1. 创建，更新，删除都是通过 -> Http API
-- 2. 读取是通过本地数据库 -> 本地， （例外：订单从云端读取）
-
-# 第二阶段 （单机版）
-1. 创建，更新，删除，读取都通过本地数据库，然后进行数据和云端同步(Web Worker)
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- <div align="center">
- <img align="center" width="230" src="https://i.imgur.com/iHgtvmg.png" />
-  <h2>Typescript Library Boilerplate Basic</h2>
-  <blockquote>Minimal Library Starter Kit for your Typescript projects</blockquote>
- 
- <a href="https://www.npmjs.com/package/@hodgef/ts-library-boilerplate-basic"><img src="https://badgen.net/npm/v/@hodgef/ts-library-boilerplate-basic?color=blue" alt="npm version"></a> <a href="https://github.com/hodgef/ts-library-boilerplate"><img src="https://img.shields.io/github/last-commit/hodgef/ts-library-boilerplate" alt="latest commit"></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"><img alt="Build Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Build/badge.svg?color=green" /></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"> <img alt="Publish Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Publish/badge.svg?color=green" /></a>
-
-<strong>For a plain Javascript alternative, check out [js-library-boilerplate-basic](https://github.com/hodgef/js-library-boilerplate-basic).</strong>
-
-</div>
-
-## ⭐️ Features
-
-- Webpack 5
-- Babel 7
-- Hot reloading (`npm start`)
-- Automatic Types file generation (index.d.ts)
-- UMD exports, so your library works everywhere.
-- Jest unit testing
-- Customizable file headers for your build [(Example 1)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/index.js) [(Example2)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/css/index.css)
-- Daily [dependabot](https://dependabot.com) dependency updates
-
-## 📦 Getting Started
-
-```
-git clone https://github.com/hodgef/ts-library-boilerplate-basic.git myLibrary
-npm install
-```
-
-## 💎 Customization
-
-> Before shipping, make sure to:
-
-1. Edit `LICENSE` file
-2. Edit `package.json` information (These will be used to generate the headers for your built files)
-3. Edit `library: "MyLibrary"` with your library's export name in `./webpack.config.js`
-
-## 🚀 Deployment
-
-1. `npm publish`
-2. Your users can include your library as usual
-
-### npm
-
-```
-import MyLibrary from 'my-library';
-const libraryInstance = new MyLibrary();
-...
-```
-
-### self-host/cdn
-
-```
-<script src="build/index.js"></script>
-
-const MyLibrary = window.MyLibrary.default;
-const libraryInstance = new MyLibrary();
-...
-```
-
-## ✅ Libraries built with this boilerplate
-
-> Made a library using this starter kit? Share it here by [submitting a pull request](https://github.com/hodgef/ts-library-boilerplate-basic/pulls)!
-
-- [simple-keyboard](https://github.com/hodgef/simple-keyboard) - Javascript Virtual Keyboard
-- [react-simple-keyboard](https://github.com/hodgef/react-simple-keyboard) - React Virtual Keyboard
-- [simple-keyboard-layouts](https://github.com/hodgef/simple-keyboard-layouts) - Keyboard layouts for simple-keyboard
-- [atlas-monaco](https://github.com/datdao/atlas-monaco) - AtlasHCL for monaco editor
+# 第一阶段
+- 1. 创建，更新，删除都是通过 -> Http API
+- 2. 读取是通过本地数据库 -> 本地， （例外：订单从云端读取）
+
+# 第二阶段 （单机版）
+1. 创建，更新，删除，读取都通过本地数据库，然后进行数据和云端同步(Web Worker)
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+ <div align="center">
+ <img align="center" width="230" src="https://i.imgur.com/iHgtvmg.png" />
+  <h2>Typescript Library Boilerplate Basic</h2>
+  <blockquote>Minimal Library Starter Kit for your Typescript projects</blockquote>
+ 
+ <a href="https://www.npmjs.com/package/@hodgef/ts-library-boilerplate-basic"><img src="https://badgen.net/npm/v/@hodgef/ts-library-boilerplate-basic?color=blue" alt="npm version"></a> <a href="https://github.com/hodgef/ts-library-boilerplate"><img src="https://img.shields.io/github/last-commit/hodgef/ts-library-boilerplate" alt="latest commit"></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"><img alt="Build Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Build/badge.svg?color=green" /></a> <a href="https://github.com/hodgef/ts-library-boilerplate-basic/actions"> <img alt="Publish Status" src="https://github.com/hodgef/ts-library-boilerplate-basic/workflows/Publish/badge.svg?color=green" /></a>
+
+<strong>For a plain Javascript alternative, check out [js-library-boilerplate-basic](https://github.com/hodgef/js-library-boilerplate-basic).</strong>
+
+</div>
+
+## ⭐️ Features
+
+- Webpack 5
+- Babel 7
+- Hot reloading (`npm start`)
+- Automatic Types file generation (index.d.ts)
+- UMD exports, so your library works everywhere.
+- Jest unit testing
+- Customizable file headers for your build [(Example 1)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/index.js) [(Example2)](https://github.com/hodgef/ts-library-boilerplate-basic/blob/master/build/css/index.css)
+- Daily [dependabot](https://dependabot.com) dependency updates
+
+## 📦 Getting Started
+
+```
+git clone https://github.com/hodgef/ts-library-boilerplate-basic.git myLibrary
+npm install
+```
+
+## 💎 Customization
+
+> Before shipping, make sure to:
+
+1. Edit `LICENSE` file
+2. Edit `package.json` information (These will be used to generate the headers for your built files)
+3. Edit `library: "MyLibrary"` with your library's export name in `./webpack.config.js`
+
+## 🚀 Deployment
+
+1. `npm publish`
+2. Your users can include your library as usual
+
+### npm
+
+```
+import MyLibrary from 'my-library';
+const libraryInstance = new MyLibrary();
+...
+```
+
+### self-host/cdn
+
+```
+<script src="build/index.js"></script>
+
+const MyLibrary = window.MyLibrary.default;
+const libraryInstance = new MyLibrary();
+...
+```
+
+## ✅ Libraries built with this boilerplate
+
+> Made a library using this starter kit? Share it here by [submitting a pull request](https://github.com/hodgef/ts-library-boilerplate-basic/pulls)!
+
+- [simple-keyboard](https://github.com/hodgef/simple-keyboard) - Javascript Virtual Keyboard
+- [react-simple-keyboard](https://github.com/hodgef/react-simple-keyboard) - React Virtual Keyboard
+- [simple-keyboard-layouts](https://github.com/hodgef/simple-keyboard-layouts) - Keyboard layouts for simple-keyboard
+- [atlas-monaco](https://github.com/datdao/atlas-monaco) - AtlasHCL for monaco editor

package/build/index.d.ts

@@ -3193,13 +3193,11 @@ interface ILoyaltyProgram {
   inclusive_service_charge: boolean;
   /** Whether tax is inclusive */
   inclusive_tax: boolean;
-}
-interface ICrmConfig {
   /** Default country code for phone numbers */
   default_country_code: string;
 }
+interface ICrmConfig {}
 declare class CrmConfig implements ICrmConfig {
-  default_country_code: string;
   constructor();
 }
 declare class LoyaltyProgram implements ILoyaltyProgram {
@@ -3208,6 +3206,7 @@ declare class LoyaltyProgram implements ILoyaltyProgram {
   rewarded_point_rate: number;
   inclusive_service_charge: boolean;
   inclusive_tax: boolean;
+  default_country_code: string;
   constructor();
 }
 interface ICustomerDisplaySystemConfig {
@@ -3610,6 +3609,8 @@ interface IOrderConfig {
   end_shift_with_open_tables: boolean;
   /** Date time format for humanized dates */
   datetime_format: string;
+  /** Ref ID prefix, default '01', 2-3 digits */
+  ref_prefix: string;
 }
 declare class OrderConfig implements IOrderConfig {
   separation_line: boolean;
@@ -3622,6 +3623,7 @@ declare class OrderConfig implements IOrderConfig {
   hide_categories_when_ordering: boolean;
   end_shift_with_open_tables: boolean;
   datetime_format: string;
+  ref_prefix: string;
   constructor();
 }
 interface IOrderDisplaySystemConfig {
@@ -5777,77 +5779,37 @@ declare function normalizedDate(date: Date): string;
  * Interface for CSV export rows
  *
  * CSV Structure:
- * Type,Name,SKU,Price,Stock,Is Internal,Min Order,Max Order,Image URL,Thumbnail URL,Sequence
- * category,Beverages,,,,,,https://example.com/beverages.jpg,https://example.com/beverages-thumb.jpg,0
- * product,Americano,AME001,4.00,100,false,,,https://example.com/americano.jpg,https://example.com/americano-thumb.jpg,0
- * product,Espresso,ESP001,3.50,50,false,,,https://example.com/espresso.jpg,https://example.com/espresso-thumb.jpg,1
- * modifier_category,Extras,,,,,,1,5,,0
- * modifier,Extra Sugar,SUGAR001,0.50,1000,false,,,,,0
- * modifier,Extra Milk,MILK001,1.00,1000,false,,,,,1
- * category,Food,,,,,,https://example.com/food.jpg,https://example.com/food-thumb.jpg,1
- * product,Burger,BUR001,12.00,25,false,,,https://example.com/burger.jpg,https://example.com/burger-thumb.jpg,0
+ * Type,Name,SKU,Price,Stock,Is Internal,Min Order,Max Order,Image URL,Thumbnail URL,Sequence,Item UID
+ * category,Beverages,,,,,,https://example.com/beverages.jpg,https://example.com/beverages-thumb.jpg,0,
+ * product,Americano,AME001,4.00,100,false,,,https://example.com/americano.jpg,https://example.com/americano-thumb.jpg,0,
+ * combo,Lunch Set,SET001,25.00,,false,,,https://example.com/set.jpg,https://example.com/set-thumb.jpg,1,
+ * combo_group,Choose Main,,,,,1,1,,,0,
+ * combo_item,Burger,,12.00,,,,,,,0,itm_xxx123
+ * combo_item,Pasta,,10.00,,,,,,,1,itm_yyy456
+ * combo_group,Choose Drink,,,,,1,1,,,1,
+ * combo_item,Cola,,3.00,,,,,,,0,itm_zzz789
  */
 interface IExportRow {
-  /**
-   * Type of the row: category, product, modifier_category, or modifier
-   */
-  type: 'category' | 'product' | 'modifier_category' | 'modifier';
-  /**
-   * Name of the category, product, or modifier
-   */
+  /** Type of the row */
+  type: 'category' | 'product' | 'modifier_category' | 'modifier' | 'combo' | 'combo_group' | 'combo_item';
   name: string;
-  /**
-   * SKU (Stock Keeping Unit) - only for products and modifiers
-   */
   sku?: string;
-  /**
-   * Price - only for products and modifiers
-   */
   price?: number;
-  /**
-   * Stock level - only for products and modifiers
-   */
   stock?: number;
-  /**
-   * Is internal flag - only for products and modifiers
-   */
   is_internal?: boolean;
-  /**
-   * Minimum order quantity - only for modifier_categories
-   */
   min_order?: number;
-  /**
-   * Maximum order quantity - only for modifier_categories
-   */
   max_order?: number;
-  /**
-   * Image URL - for categories and products
-   */
   image_url?: string;
-  /**
-   * Image thumbnail URL - for categories and products
-   */
   image_thumbnail_url?: string;
-  /**
-   * Sequence number for sorting
-   */
   sequence?: number;
+  /** Item UID reference for combo_item rows */
+  item_uid?: string;
 }
 //#endregion
 //#region src/utils/csv.utils.d.ts
-/**
- * Create CSV export blob from categories and products
- * @param categories Array of categories
- * @param products Array of products (products contain modifiers and modifier_categories)
- * @param filename Optional filename (default: 'export.csv')
- * @returns Blob object for download
- */
+/** Create CSV export blob from categories and products */
 declare function createCSVExport(categories: ICategory[], products: IItem[], filename?: string): Blob;
-/**
- * Import categories and products from CSV file
- * @param file CSV file to import
- * @returns Promise with categories and products arrays (products include modifiers and modifier_categories)
- */
+/** Import categories and products from CSV file */
 declare function importFromCSV(file: File): Promise<{
   categories: ICategory[];
   products: IItem[];