@posx/core 5.5.258 → 5.5.260

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/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';
@@ -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' {
   /**