@posx/core 5.5.258 → 5.5.259

package/CLAUDE.md

@@ -0,0 +1,13 @@
+# Claude AI Development Guidelines
+
+## 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

@@ -249,6 +249,8 @@ declare module '@posx/core/index' {
   export * from '@posx/core/libs/escpos.printer';
   export * from '@posx/core/services/ods.service';
   export * from '@posx/core/types/ods.type';
+  export * from '@posx/core/types/csv.type';
+  export { createCSVExport, importFromCSV } from '@posx/core/utils/csv.utils';
   export * from '@posx/core/utils/autoquery.utils';
   export * from '@posx/core/libs/electron.socket';
   export * from '@posx/core/types/condition.type';
@@ -256,17 +258,6 @@ declare module '@posx/core/index' {
   export * from '@posx/core/types/storage.type';
   export * from '@posx/core/types/menu.type';
 
-}
-declare module '@posx/core/libs/FindOptions' {
-  export const Include: (query?: string) => (val: any) => any;
-  export const In: (query?: never[]) => (val: never) => boolean;
-  export const Between: (begin: number, end: number) => (val: number) => boolean;
-  export const Not: (query?: any) => (val: any, values: any) => boolean;
-  export const Raw: (fn: any) => any;
-  export const filterByParams: (params: {
-      [key: string]: any;
-  }) => (values: any) => boolean;
-
 }
 declare module '@posx/core/libs/electron.socket' {
   export class ElectronSocket {
@@ -486,6 +477,17 @@ declare module '@posx/core/libs/escpos.printer' {
       items: IPrintCommandLine[];
   }
 
+}
+declare module '@posx/core/libs/FindOptions' {
+  export const Include: (query?: string) => (val: any) => any;
+  export const In: (query?: never[]) => (val: never) => boolean;
+  export const Between: (begin: number, end: number) => (val: number) => boolean;
+  export const Not: (query?: any) => (val: any, values: any) => boolean;
+  export const Raw: (fn: any) => any;
+  export const filterByParams: (params: {
+      [key: string]: any;
+  }) => (values: any) => boolean;
+
 }
 declare module '@posx/core/service.factory' {
   import { IServiceOptions } from '@posx/core/types/misc.type';
@@ -2076,6 +2078,10 @@ declare module '@posx/core/test/services/report/modifier-sales-report-test/modif
 declare module '@posx/core/test/services/tax/tax-exempt-test/tax-exempt.test' {
   export {};
 
+}
+declare module '@posx/core/test/utils/csv-test/csv-export-import.test' {
+  export {};
+
 }
 declare module '@posx/core/test/utils/query-builder-test/query-builder.test' {
   export {};
@@ -2951,6 +2957,41 @@ declare module '@posx/core/types/config.type' {
       constructor();
   }
 
+}
+declare module '@posx/core/types/csv.type' {
+  /**
+   * Interface for CSV export rows
+   *
+   * CSV Structure:
+   * Type,Name,SKU,Price
+   * category,Beverages,,
+   * product,Americano,AME001,4.00
+   * product,Espresso,ESP001,3.50
+   * modifier_category,Extras,,
+   * modifier,Extra Sugar,SUGAR001,0.50
+   * modifier,Extra Milk,MILK001,1.00
+   * category,Food,,
+   * product,Burger,BUR001,12.00
+   */
+  export 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
+       */
+      name: string;
+      /**
+       * SKU (Stock Keeping Unit) - only for products and modifiers
+       */
+      sku?: string;
+      /**
+       * Price - only for products and modifiers
+       */
+      price?: number;
+  }
+
 }
 declare module '@posx/core/types/employee.type' {
   import { AppCoreModel, IAppCoreModel } from '@posx/core/types/abstract.type';
@@ -4593,6 +4634,8 @@ declare module '@posx/core/types/product.type' {
       is_internal: boolean;
       is_delisted: boolean;
       uid: string;
+      modifiers?: Array<ICoreItem>;
+      modifier_categories?: Array<ICoreCategory>;
       kitchen_printers_uids: any[];
       order_printers_uids: any[];
       label_printers_uids: any[];
@@ -5451,6 +5494,27 @@ declare module '@posx/core/utils/autoquery.utils' {
       search_keywords?: string;
   };
 
+}
+declare module '@posx/core/utils/csv.utils' {
+  import { ICategory, IItem } from '@posx/core/types/product.type';
+  /**
+   * 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
+   */
+  export 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)
+   */
+  export function importFromCSV(file: File): Promise<{
+      categories: ICategory[];
+      products: IItem[];
+  }>;
+
 }
 declare module '@posx/core/utils/http.utils' {
   /**