@lucablockltd/ultimate-packaging 1.1.0 → 1.3.0

package/dist/AGENTS_README.md

@@ -69,18 +69,186 @@ const pdf = await ref.current.exportDimension();
 ## 2. Auto-Layout (Pack Dielines on Paper)
 
 Use `AUTO_LAYOUT` to automatically arrange dieline pieces on paper sheets.
+The engine calculates the optimal rotation and grid placement to maximize pieces per sheet.
 
-```tsx
-import { AUTO_LAYOUT, calculateAutoLayout } from "@lucablockltd/ultimate-packaging";
-import type {
-  AutoLayoutRef,
-  AutoLayoutConfig,
-  AutoLayoutResult,
+### AutoLayoutConfig — Full Reference
+
+`AutoLayoutConfig` has **3 required fields** and **5 optional print-setting fields**.
+If you omit any optional field, the system uses a sensible default automatically.
+
+```typescript
+interface AutoLayoutConfig {
+  // ─── REQUIRED ───────────────────────────────────────────────
+  papers: AutoLayoutPaper[];  // At least 1 paper size to test
+  model: AutoLayoutModel;     // Which box/bag model and its dimensions
+  quantity: number;            // Total pieces needed (e.g. 1000)
+
+  // ─── OPTIONAL (print settings) ──────────────────────────────
+  // You can omit ALL of these — the system will use defaults.
+  layoutDistance?: number;     // default: 3   — mm gap between piece cut-lines
+  spacing?: number;            // default: 5   — mm margin from paper edges
+  griper?: number;             // default: 10  — mm machine gripper zone
+  colorbarHeight?: number;     // default: 5   — mm height of color test strip
+  isShowColorbar?: boolean;    // default: true — whether to show colorbar
+}
+```
+
+#### Required Field #1: `papers` — Paper sizes to test
+
+An array of paper sizes. The engine will calculate layout for EVERY paper and rank them by efficiency.
+Each paper needs 4 fields — all required:
+
+```typescript
+interface AutoLayoutPaper {
+  paperId: string;      // Unique ID (any string, e.g. "1", "paper-a4", "custom-1")
+  paperName: string;    // Display name (e.g. "20x28\"", "A4", "25x36\"")
+  paperWidth: number;   // Width in millimeters
+  paperHeight: number;  // Height in millimeters
+}
+```
+
+**Common paper sizes (inches → mm, multiply by 25.4):**
+
+| Name     | Inches   | paperWidth (mm) | paperHeight (mm) |
+| -------- | -------- | --------------- | ----------------- |
+| 20x28"   | 20 × 28  | 508             | 711.2             |
+| 25x36"   | 25 × 36  | 635             | 914.4             |
+| 25x12"   | 25 × 12  | 635             | 304.8             |
+| 23x35"   | 23 × 35  | 584.2           | 889               |
+
+**Example:**
+
+```typescript
+const papers: AutoLayoutPaper[] = [
+  { paperId: "1", paperName: '20x28"', paperWidth: 508, paperHeight: 711.2 },
+  { paperId: "2", paperName: '25x36"', paperWidth: 635, paperHeight: 914.4 },
+];
+```
+
+#### Required Field #2: `model` — Which packaging model and its dimensions
+
+```typescript
+interface AutoLayoutModel {
+  modelId: string;                    // Must be one of the supported model IDs (see below)
+  attributes: Record<string, number>; // Dimensions in mm — different per model
+}
+```
+
+**Supported `modelId` values and their required `attributes`:**
+
+| modelId      | Type                    | Required attributes                                              |
+| ------------ | ----------------------- | ---------------------------------------------------------------- |
+| `BECF-1010A` | Tuck End Box Type A     | `length`, `width`, `height`, `glueArea`, `dustFlap`, `tuckFlap`  |
+| `BECF-1030A` | Tuck End Box Type C     | `length`, `width`, `height`, `glueArea`, `dustFlap`, `tuckFlap`  |
+| `BECF-1040A` | Tuck End Box Type B     | `length`, `width`, `height`, `glueArea`, `dustFlap`, `tuckFlap`  |
+| `BECF-11D01` | Standard Box            | `length`, `width`, `height`, `flapHeight`, `glueArea`            |
+| `BECF-12101` | Carton Bag / Shopping Bag Type A | `length`, `width`, `height`, `glueArea`               |
+| `BECF-12109` | Carton Bag / Shopping Bag Type B | `length`, `width`, `height`, `glueArea`               |
+
+**Example — Tuck End Box:**
+
+```typescript
+const model: AutoLayoutModel = {
+  modelId: "BECF-1010A",
+  attributes: {
+    length: 60,     // box length (mm)
+    width: 25,      // box width (mm)
+    height: 100,    // box height (mm)
+    glueArea: 15,   // glue flap width (mm)
+    dustFlap: 15,   // dust flap extension (mm)
+    tuckFlap: 15,   // tuck flap height (mm)
+  },
+};
+```
+
+**Example — Standard Box:**
+
+```typescript
+const model: AutoLayoutModel = {
+  modelId: "BECF-11D01",
+  attributes: {
+    length: 100,
+    width: 50,
+    height: 150,
+    flapHeight: 50,
+    glueArea: 13,
+  },
+};
+```
+
+**Example — Carton Bag:**
+
+```typescript
+const model: AutoLayoutModel = {
+  modelId: "BECF-12101",
+  attributes: {
+    length: 100,    // A — front/back panel width (mm)
+    width: 50,      // B — side panel / gusset (mm)
+    height: 150,    // C — bag body height (mm)
+    glueArea: 13,   // glue flap width (mm)
+  },
+};
+```
+
+**Tip:** You can use pre-defined default attributes instead of hardcoding:
+
+```typescript
+import {
+  BECF_1010A_DEFAULT_ATTRIBUTES,
+  BECF_12101_DEFAULT_ATTRIBUTES,
 } from "@lucablockltd/ultimate-packaging";
 
-const ref = useRef<AutoLayoutRef>(null);
-const [result, setResult] = useState<AutoLayoutResult | null>(null);
+const model: AutoLayoutModel = {
+  modelId: "BECF-1010A",
+  attributes: { ...BECF_1010A_DEFAULT_ATTRIBUTES },
+};
+```
+
+#### Required Field #3: `quantity` — Total pieces needed
+
+A positive integer. The engine calculates how many sheets are needed to produce this quantity.
+
+```typescript
+quantity: 1000  // need 1000 pieces total
+```
+
+#### Optional Print Settings (all have defaults)
+
+These 5 fields control the printing press layout. **You can omit any or all of them.**
 
+| Field            | Type      | Default | What it does                                                                                     |
+| ---------------- | --------- | ------- | ------------------------------------------------------------------------------------------------ |
+| `layoutDistance` | `number`  | `3`     | Gap between piece cut-lines in mm. Creates an offset contour around each piece (half on each side). Set to `0` for pieces touching edge-to-edge. |
+| `spacing`        | `number`  | `5`     | Margin from all paper edges in mm. Reserved border where no pieces are placed.                   |
+| `griper`         | `number`  | `10`    | Machine gripper zone depth in mm. Area reserved for the printing press feed mechanism. Placed on the bottom edge (landscape) or left edge (portrait). |
+| `colorbarHeight` | `number`  | `5`     | Height of the color test strip in mm. A row of colored squares for print registration, placed on the opposite side of the gripper. |
+| `isShowColorbar` | `boolean` | `true`  | Whether to show the colorbar. If `false`, `colorbarHeight` is ignored and that space becomes usable for pieces. |
+
+### Minimal Config Example (only required fields)
+
+This is the **simplest possible config** — all print settings use defaults:
+
+```tsx
+const config: AutoLayoutConfig = {
+  papers: [
+    { paperId: "1", paperName: '20x28"', paperWidth: 508, paperHeight: 711.2 },
+  ],
+  model: {
+    modelId: "BECF-1010A",
+    attributes: { length: 60, width: 25, height: 100, glueArea: 15, dustFlap: 15, tuckFlap: 15 },
+  },
+  quantity: 1000,
+  // layoutDistance → defaults to 3
+  // spacing       → defaults to 5
+  // griper        → defaults to 10
+  // colorbarHeight → defaults to 5
+  // isShowColorbar → defaults to true
+};
+```
+
+### Full Config Example (all fields explicit)
+
+```tsx
 const config: AutoLayoutConfig = {
   papers: [
     { paperId: "1", paperName: '20x28"', paperWidth: 508, paperHeight: 711.2 },
@@ -98,52 +266,153 @@ const config: AutoLayoutConfig = {
     },
   },
   quantity: 1000,
-  layoutDistance: 3, // mm gap between pieces (offset contour)
-  spacing: 5, // mm margin on sides
-  griper: 10, // mm machine gripper zone
-  colorbarHeight: 5, // mm colorbar strip height
+  layoutDistance: 3,
+  spacing: 5,
+  griper: 10,
+  colorbarHeight: 5,
   isShowColorbar: true,
 };
+```
+
+### Using the AUTO_LAYOUT Component (React)
+
+```tsx
+import { AUTO_LAYOUT } from "@lucablockltd/ultimate-packaging";
+import type {
+  AutoLayoutRef,
+  AutoLayoutConfig,
+  AutoLayoutResult,
+} from "@lucablockltd/ultimate-packaging";
+
+const ref = useRef<AutoLayoutRef>(null);
+const [result, setResult] = useState<AutoLayoutResult | null>(null);
 
 <AUTO_LAYOUT ref={ref} config={config} onResult={setResult} />;
 ```
 
 ### AUTO_LAYOUT Props
 
-| Prop               | Type                                         | Required | Description                                                                                                       |
-| ------------------ | -------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
-| `config`           | `AutoLayoutConfig \| null`                   | YES      | Layout configuration (null = no render)                                                                           |
-| `onResult`         | `(result: AutoLayoutResult \| null) => void` | no       | Called when layout is calculated                                                                                  |
-| `onModifiedPapers` | `(papers: AutoLayoutPaperResult[]) => void`  | no       | Called when user modifies layout manually                                                                         |
-| `isShowSummary`    | `boolean`                                    | no       | Show/hide summary panel (default: `true`)                                                                         |
-| `isShowAction`     | `AutoLayoutAction[]`                         | no       | Which action buttons to show. If omitted, all are shown. Values: `"EXPORT_SHEET"`, `"EXPORT_PDF"`, `"MODIFY_LAYOUT"` |
+| Prop               | Type                                         | Required | Default          | Description                                                                                                       |
+| ------------------ | -------------------------------------------- | -------- | ---------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `config`           | `AutoLayoutConfig \| null`                   | YES      | —                | Layout configuration. Pass `null` to clear/hide the layout.                                                       |
+| `onResult`         | `(result: AutoLayoutResult \| null) => void` | no       | —                | Callback fired when layout calculation completes. Receives the full result object.                                |
+| `onModifiedPapers` | `(papers: AutoLayoutPaperResult[]) => void`  | no       | —                | Callback fired when user manually drags/modifies piece positions on the layout.                                   |
+| `isShowSummary`    | `boolean`                                    | no       | `true`           | Show/hide the summary stats panel above each paper (pieces/sheet, waste %, etc.)                                  |
+| `isShowAction`     | `AutoLayoutAction[]`                         | no       | all actions shown | Which action buttons to show. Values: `"EXPORT_SHEET"`, `"EXPORT_PDF"`, `"MODIFY_LAYOUT"`. Omit to show all.     |
 
 ### AUTO_LAYOUT Ref Methods
 
+Access these via `ref.current` after the component mounts:
+
 ```tsx
-// Get calculation result
-ref.current.getResult(); // → AutoLayoutResult
+const ref = useRef<AutoLayoutRef>(null);
+
+// 1. Get the full calculation result
+const result = ref.current.getResult();
+// → AutoLayoutResult | null
+
+// 2. Export a specific paper's layout as PNG image
+const pngBlob = await ref.current.exportImage(0); // 0 = first paper index
+// → Blob (image/png)
 
-// Export layout image (PNG) for specific paper
-const png = await ref.current.exportImage(0); // paper index 0
+// 3. Export a specific paper's layout as PDF
+const pdfBlob = await ref.current.exportPdf(0);
+// → Blob (application/pdf)
 
-// Export layout as PDF
-const pdf = await ref.current.exportPdf(0);
+// 4. Export the dieline pattern as PNG
+const dielineBlob = await ref.current.exportDielineImage();
+// → Blob (image/png)
 
-// Get packed result with dieline + layout image files
+// 5. Get packed result — includes images as File objects (useful for upload/FormData)
 const packed = await ref.current.getPackedResult(0);
-// → { ...paperResult, quantity, dielineFile: File, layoutFile: File }
+// → AutoLayoutPackedResult {
+//     ...all AutoLayoutPaperResult fields,
+//     quantity: number,
+//     dielineFile: File,  // dieline pattern PNG
+//     layoutFile: File,   // layout arrangement PNG
+//   }
 ```
 
-### Programmatic Calculation (No UI)
+### Programmatic Calculation (No UI / No React)
+
+Use `calculateAutoLayout()` to compute layout without rendering any component.
+Same config, same result — just no visual output.
 
 ```tsx
 import { calculateAutoLayout } from "@lucablockltd/ultimate-packaging";
+import type { AutoLayoutConfig, AutoLayoutResult } from "@lucablockltd/ultimate-packaging";
+
+const config: AutoLayoutConfig = {
+  papers: [
+    { paperId: "A", paperName: '20x28"', paperWidth: 508, paperHeight: 711.2 },
+    { paperId: "B", paperName: '25x36"', paperWidth: 635, paperHeight: 914.4 },
+  ],
+  model: {
+    modelId: "BECF-1010A",
+    attributes: { length: 60, width: 25, height: 100, glueArea: 15, dustFlap: 15, tuckFlap: 15 },
+  },
+  quantity: 1000,
+  // print settings are optional — defaults will be used
+};
 
-const result = calculateAutoLayout(config);
-// → AutoLayoutResult { papers, quantity, totalProduced, totalSheets, remainingNeeded, recommendedPaperId }
+const result: AutoLayoutResult = calculateAutoLayout(config);
+
+// Result structure:
+// result.recommendedPaperId  → "B" (best paper by least total area)
+// result.quantity             → 1000
+// result.totalProduced        → 1008 (may exceed quantity due to full sheets)
+// result.totalSheets          → total sheets across all papers
+// result.remainingNeeded      → 0 (if all produced)
+// result.papers               → AutoLayoutPaperResult[] (one per paper, sorted best-first)
+```
+
+### AutoLayoutResult — Output Reference
+
+```typescript
+interface AutoLayoutResult {
+  papers: AutoLayoutPaperResult[];  // Results per paper size, sorted by efficiency (best first)
+  quantity: number;                  // Original requested quantity
+  totalProduced: number;             // Total pieces produced (may exceed quantity)
+  totalSheets: number;               // Total sheets needed across all papers
+  remainingNeeded: number;           // Shortfall (0 if quantity is met)
+  recommendedPaperId: string | null; // paperId of the most efficient paper (least total area)
+}
+
+interface AutoLayoutPaperResult {
+  paperId: string;              // Matches the input paper's paperId
+  paperName: string;            // Display name
+  paperWidth: number;           // mm
+  paperHeight: number;          // mm
+  producedPerSheet: number;     // How many pieces fit on ONE sheet
+  totalSheets: number;          // Sheets needed for the requested quantity
+  totalProduced: number;        // producedPerSheet × totalSheets
+  excessCount: number;          // Overproduction beyond quantity
+  wastePercent: number;         // Unused paper area percentage (0–100)
+  independentSheets: number;    // Sheets needed if ONLY this paper is used
+  independentTotalArea: number; // Total paper area in mm² if only this paper
+  placements: AutoLayoutPlacement[]; // Position of each piece on the sheet
+  gripperSide: GripperSide;     // Which edge the gripper is on
+}
+
+interface AutoLayoutPlacement {
+  x: number;         // mm from paper left edge
+  y: number;         // mm from paper top edge
+  rotation: number;  // 0 | 90 | 180 | 270 degrees
+}
+
+type GripperSide = "top" | "bottom" | "left" | "right";
+// Automatically determined: landscape paper → "bottom", portrait → "left"
 ```
 
+### Layout Algorithm Summary
+
+1. The engine tries all 4 rotations (0°, 90°, 180°, 270°) for each piece on each paper
+2. For each rotation, it packs pieces in a grid within the **usable bounds**
+3. **Usable bounds** = paper area minus: `spacing` (all edges) + `griper` (one edge) + `colorbarHeight` (opposite edge)
+4. The rotation that fits the **most pieces** wins
+5. Papers are sorted by `independentTotalArea` (ascending) — the paper that uses the least total area to fulfill quantity is ranked #1
+6. `recommendedPaperId` = the #1 ranked paper
+
 ---
 
 ## 3. Available Models & Attributes

package/dist/index.d.mts

@@ -10,7 +10,7 @@ interface TuckEndBoxAttributes$2 {
     tuckFlap: number;
 }
 
-interface GetAttributesResult$5 {
+interface GetAttributesResult$7 {
     modelId: string;
     overallWidth: number;
     overallHeight: number;
@@ -21,13 +21,13 @@ interface GetAttributesResult$5 {
     dustFlap: number;
     tuckFlap: number;
 }
-interface ExportImageOptions$5 {
+interface ExportImageOptions$7 {
     isShowDimension: boolean;
     originalSize: boolean;
 }
 interface DieLineBecf1010aRef {
-    getAttributes: () => GetAttributesResult$5;
-    exportImage: (options: ExportImageOptions$5) => Promise<Blob>;
+    getAttributes: () => GetAttributesResult$7;
+    exportImage: (options: ExportImageOptions$7) => Promise<Blob>;
     exportDimension: () => Promise<Blob>;
 }
 interface CanvasBecf1010aRef extends DieLineBecf1010aRef {
@@ -62,7 +62,7 @@ interface TuckEndBoxAttributes$1 {
     tuckFlap: number;
 }
 
-interface GetAttributesResult$4 {
+interface GetAttributesResult$6 {
     modelId: string;
     overallWidth: number;
     overallHeight: number;
@@ -73,13 +73,13 @@ interface GetAttributesResult$4 {
     dustFlap: number;
     tuckFlap: number;
 }
-interface ExportImageOptions$4 {
+interface ExportImageOptions$6 {
     isShowDimension: boolean;
     originalSize: boolean;
 }
 interface DieLineBecf1030aRef {
-    getAttributes: () => GetAttributesResult$4;
-    exportImage: (options: ExportImageOptions$4) => Promise<Blob>;
+    getAttributes: () => GetAttributesResult$6;
+    exportImage: (options: ExportImageOptions$6) => Promise<Blob>;
     exportDimension: () => Promise<Blob>;
 }
 interface CanvasBecf1030aRef extends DieLineBecf1030aRef {
@@ -104,7 +104,7 @@ interface TuckEndBoxAttributes {
     tuckFlap: number;
 }
 
-interface GetAttributesResult$3 {
+interface GetAttributesResult$5 {
     modelId: string;
     overallWidth: number;
     overallHeight: number;
@@ -115,13 +115,13 @@ interface GetAttributesResult$3 {
     dustFlap: number;
     tuckFlap: number;
 }
-interface ExportImageOptions$3 {
+interface ExportImageOptions$5 {
     isShowDimension: boolean;
     originalSize: boolean;
 }
 interface DieLineBecf1040aRef {
-    getAttributes: () => GetAttributesResult$3;
-    exportImage: (options: ExportImageOptions$3) => Promise<Blob>;
+    getAttributes: () => GetAttributesResult$5;
+    exportImage: (options: ExportImageOptions$5) => Promise<Blob>;
     exportDimension: () => Promise<Blob>;
 }
 interface CanvasBecf1040aRef extends DieLineBecf1040aRef {
@@ -145,7 +145,7 @@ interface StandardBoxAttributes {
     glueArea: number;
 }
 
-interface GetAttributesResult$2 {
+interface GetAttributesResult$4 {
     modelId: string;
     overallWidth: number;
     overallHeight: number;
@@ -155,13 +155,13 @@ interface GetAttributesResult$2 {
     flapHeight: number;
     glueArea: number;
 }
-interface ExportImageOptions$2 {
+interface ExportImageOptions$4 {
     isShowDimension: boolean;
     originalSize: boolean;
 }
 interface DieLineBecf11d01Ref {
-    getAttributes: () => GetAttributesResult$2;
-    exportImage: (options: ExportImageOptions$2) => Promise<Blob>;
+    getAttributes: () => GetAttributesResult$4;
+    exportImage: (options: ExportImageOptions$4) => Promise<Blob>;
     exportDimension: () => Promise<Blob>;
 }
 interface CanvasBecf11d01Ref extends DieLineBecf11d01Ref {
@@ -184,7 +184,7 @@ interface CartonBagAttributes {
     glueArea?: number;
 }
 
-interface GetAttributesResult$1 {
+interface GetAttributesResult$3 {
     modelId: string;
     overallWidth: number;
     overallHeight: number;
@@ -199,13 +199,13 @@ interface GetAttributesResult$1 {
     ropeY: number;
     ropeX: number;
 }
-interface ExportImageOptions$1 {
+interface ExportImageOptions$3 {
     isShowDimension: boolean;
     originalSize: boolean;
 }
 interface DieLineBecf12101Ref {
-    getAttributes: () => GetAttributesResult$1;
-    exportImage: (options: ExportImageOptions$1) => Promise<Blob>;
+    getAttributes: () => GetAttributesResult$3;
+    exportImage: (options: ExportImageOptions$3) => Promise<Blob>;
     exportDimension: () => Promise<Blob>;
 }
 interface CanvasBecf12101Ref extends DieLineBecf12101Ref {
@@ -228,7 +228,7 @@ interface CartonBag12109Attributes {
     glueArea?: number;
 }
 
-interface GetAttributesResult {
+interface GetAttributesResult$2 {
     modelId: string;
     overallWidth: number;
     overallHeight: number;
@@ -243,13 +243,13 @@ interface GetAttributesResult {
     ropeY: number;
     ropeX: number;
 }
-interface ExportImageOptions {
+interface ExportImageOptions$2 {
     isShowDimension: boolean;
     originalSize: boolean;
 }
 interface DieLineBecf12109Ref {
-    getAttributes: () => GetAttributesResult;
-    exportImage: (options: ExportImageOptions) => Promise<Blob>;
+    getAttributes: () => GetAttributesResult$2;
+    exportImage: (options: ExportImageOptions$2) => Promise<Blob>;
     exportDimension: () => Promise<Blob>;
 }
 interface CanvasBecf12109Ref extends DieLineBecf12109Ref {
@@ -265,6 +265,96 @@ interface ModelBecf12109Props {
 }
 declare const MODEL_BECF_12109: react.ForwardRefExoticComponent<ModelBecf12109Props & react.RefAttributes<DieLineBecf12109Ref | CanvasBecf12109Ref>>;
 
+interface CartonBagC12101Attributes {
+    length: number;
+    width: number;
+    height: number;
+    glueArea?: number;
+}
+
+interface GetAttributesResult$1 {
+    modelId: string;
+    overallWidth: number;
+    overallHeight: number;
+    length: number;
+    width: number;
+    height: number;
+    glueArea: number;
+    d: number;
+    kulak: number;
+    dip: number;
+    ribbonHW: number;
+    ribbonDX: number;
+    ribbonDY: number;
+    ribbonX: number;
+}
+interface ExportImageOptions$1 {
+    isShowDimension: boolean;
+    originalSize: boolean;
+}
+interface DieLineBecfC12101Ref {
+    getAttributes: () => GetAttributesResult$1;
+    exportImage: (options: ExportImageOptions$1) => Promise<Blob>;
+    exportDimension: () => Promise<Blob>;
+}
+interface CanvasBecfC12101Ref extends DieLineBecfC12101Ref {
+    resetView: () => void;
+    fitView: () => void;
+}
+
+interface ModelBecfC12101Props {
+    attributes: CartonBagC12101Attributes;
+    unit?: "mm" | "cm" | "in";
+    mode?: ModelMode;
+    isShowDimensions?: boolean;
+}
+declare const MODEL_BECF_C_12101: react.ForwardRefExoticComponent<ModelBecfC12101Props & react.RefAttributes<DieLineBecfC12101Ref | CanvasBecfC12101Ref>>;
+
+interface CartonBagC12109Attributes {
+    length: number;
+    width: number;
+    height: number;
+    glueArea?: number;
+}
+
+interface GetAttributesResult {
+    modelId: string;
+    overallWidth: number;
+    overallHeight: number;
+    length: number;
+    width: number;
+    height: number;
+    glueArea: number;
+    d: number;
+    kulak: number;
+    dip: number;
+    ribbonHW: number;
+    ribbonDX: number;
+    ribbonDY: number;
+    ribbonX: number;
+}
+interface ExportImageOptions {
+    isShowDimension: boolean;
+    originalSize: boolean;
+}
+interface DieLineBecfC12109Ref {
+    getAttributes: () => GetAttributesResult;
+    exportImage: (options: ExportImageOptions) => Promise<Blob>;
+    exportDimension: () => Promise<Blob>;
+}
+interface CanvasBecfC12109Ref extends DieLineBecfC12109Ref {
+    resetView: () => void;
+    fitView: () => void;
+}
+
+interface ModelBecfC12109Props {
+    attributes: CartonBagC12109Attributes;
+    unit?: "mm" | "cm" | "in";
+    mode?: ModelMode;
+    isShowDimensions?: boolean;
+}
+declare const MODEL_BECF_C_12109: react.ForwardRefExoticComponent<ModelBecfC12109Props & react.RefAttributes<DieLineBecfC12109Ref | CanvasBecfC12109Ref>>;
+
 type GripperSide = "top" | "bottom" | "left" | "right";
 interface AutoLayoutPaper {
     paperId: string;
@@ -426,6 +516,20 @@ declare const BECF_12109_DEFAULT_ATTRIBUTES: {
     glueArea: number;
 };
 
+declare const BECF_C_12101_DEFAULT_ATTRIBUTES: {
+    length: number;
+    width: number;
+    height: number;
+    glueArea: number;
+};
+
+declare const BECF_C_12109_DEFAULT_ATTRIBUTES: {
+    length: number;
+    width: number;
+    height: number;
+    glueArea: number;
+};
+
 interface ModelThemeConfig {
     colorBackground: string;
     colorDieLine: string;
@@ -453,4 +557,4 @@ interface UltimatePackagingConfig {
 }
 declare function configurePackaging(config: UltimatePackagingConfig): void;
 
-export { AUTO_LAYOUT, AUTO_LAYOUT_THEME_CONFIG, type AutoLayoutConfig, type AutoLayoutModel, type AutoLayoutPaper, type AutoLayoutPaperResult, type AutoLayoutPlacement, type AutoLayoutProps, type AutoLayoutRef, type AutoLayoutResult, type AutoLayoutThemeConfig, BECF_1010A_DEFAULT_ATTRIBUTES, BECF_1030A_DEFAULT_ATTRIBUTES, BECF_1040A_DEFAULT_ATTRIBUTES, BECF_11D01_DEFAULT_ATTRIBUTES, BECF_12101_DEFAULT_ATTRIBUTES, BECF_12109_DEFAULT_ATTRIBUTES, type CartonBag12109Attributes, type CartonBagAttributes, Colorbar, type ColorbarProps, DIE_LINE_LAYOUT, type DieLineLayoutProps, type DieLineLayoutRef, type ExportImageOptions$5 as ExportImageOptions, type GetAttributesResult$5 as GetAttributesResult, Gripper, type GripperProps, type GripperSide, MODEL_BECF_1010A, MODEL_BECF_1030A, MODEL_BECF_1040A, MODEL_BECF_11D01, MODEL_BECF_12101, MODEL_BECF_12109, MODEL_THEME_CONFIG, type ModelBecf1010aProps, type CanvasBecf1010aRef as ModelBecf1010aRef, type ModelBecf1030aProps, type CanvasBecf1030aRef as ModelBecf1030aRef, type ModelBecf1040aProps, type CanvasBecf1040aRef as ModelBecf1040aRef, type ModelBecf11d01Props, type CanvasBecf11d01Ref as ModelBecf11d01Ref, type ModelBecf12101Props, type CanvasBecf12101Ref as ModelBecf12101Ref, type ModelBecf12109Props, type CanvasBecf12109Ref as ModelBecf12109Ref, type ModelMode, type ModelThemeConfig, type PackagingModel, type StandardBoxAttributes, type TuckEndBoxAttributes$2 as TuckEndBoxAttributes, type UltimatePackagingConfig, appendColorbarToSvg, appendGripperToSvg, calculateAutoLayout, configurePackaging, modelList };
+export { AUTO_LAYOUT, AUTO_LAYOUT_THEME_CONFIG, type AutoLayoutConfig, type AutoLayoutModel, type AutoLayoutPaper, type AutoLayoutPaperResult, type AutoLayoutPlacement, type AutoLayoutProps, type AutoLayoutRef, type AutoLayoutResult, type AutoLayoutThemeConfig, BECF_1010A_DEFAULT_ATTRIBUTES, BECF_1030A_DEFAULT_ATTRIBUTES, BECF_1040A_DEFAULT_ATTRIBUTES, BECF_11D01_DEFAULT_ATTRIBUTES, BECF_12101_DEFAULT_ATTRIBUTES, BECF_12109_DEFAULT_ATTRIBUTES, BECF_C_12101_DEFAULT_ATTRIBUTES, BECF_C_12109_DEFAULT_ATTRIBUTES, type CartonBag12109Attributes, type CartonBagAttributes, type CartonBagC12101Attributes, type CartonBagC12109Attributes, Colorbar, type ColorbarProps, DIE_LINE_LAYOUT, type DieLineLayoutProps, type DieLineLayoutRef, type ExportImageOptions$7 as ExportImageOptions, type GetAttributesResult$7 as GetAttributesResult, Gripper, type GripperProps, type GripperSide, MODEL_BECF_1010A, MODEL_BECF_1030A, MODEL_BECF_1040A, MODEL_BECF_11D01, MODEL_BECF_12101, MODEL_BECF_12109, MODEL_BECF_C_12101, MODEL_BECF_C_12109, MODEL_THEME_CONFIG, type ModelBecf1010aProps, type CanvasBecf1010aRef as ModelBecf1010aRef, type ModelBecf1030aProps, type CanvasBecf1030aRef as ModelBecf1030aRef, type ModelBecf1040aProps, type CanvasBecf1040aRef as ModelBecf1040aRef, type ModelBecf11d01Props, type CanvasBecf11d01Ref as ModelBecf11d01Ref, type ModelBecf12101Props, type CanvasBecf12101Ref as ModelBecf12101Ref, type ModelBecf12109Props, type CanvasBecf12109Ref as ModelBecf12109Ref, type ModelBecfC12101Props, type CanvasBecfC12101Ref as ModelBecfC12101Ref, type ModelBecfC12109Props, type CanvasBecfC12109Ref as ModelBecfC12109Ref, type ModelMode, type ModelThemeConfig, type PackagingModel, type StandardBoxAttributes, type TuckEndBoxAttributes$2 as TuckEndBoxAttributes, type UltimatePackagingConfig, appendColorbarToSvg, appendGripperToSvg, calculateAutoLayout, configurePackaging, modelList };