@final-commerce/command-frame 0.2.0-beta.6 → 0.3.0-beta.5

package/dist/actions/update-cart-item-quantity/mock.js

@@ -1,11 +1,11 @@
 import { MOCK_CART, mockPublishEvent } from "../../demo/database";
-export const mockUpdateCartItemQuantity = async (params) => {
+export const mockUpdateCartItemQuantity = (params) => {
     console.log("[Mock] updateCartItemQuantity called", params);
     if (!params?.internalId) {
-        throw new Error('internalId is required');
+        throw new Error("internalId is required");
     }
     if (params.quantity === undefined || params.quantity === null) {
-        throw new Error('quantity is required');
+        throw new Error("quantity is required");
     }
     const { internalId, quantity } = params;
     // Find the product in the cart
@@ -25,16 +25,16 @@ export const mockUpdateCartItemQuantity = async (params) => {
         MOCK_CART.amountToBeCharged = MOCK_CART.total;
         MOCK_CART.remainingBalance = MOCK_CART.total;
         // Publish product-deleted event
-        mockPublishEvent('cart', 'product-deleted', {
+        mockPublishEvent("cart", "product-deleted", {
             product: product,
             internalId: internalId
         });
-        return {
+        return Promise.resolve({
             success: true,
             internalId: internalId,
             quantity: 0,
             timestamp: new Date().toISOString()
-        };
+        });
     }
     // Update quantity
     const quantityDelta = quantity - previousQuantity;
@@ -46,15 +46,15 @@ export const mockUpdateCartItemQuantity = async (params) => {
     MOCK_CART.amountToBeCharged = MOCK_CART.total;
     MOCK_CART.remainingBalance = MOCK_CART.total;
     // Publish product-updated event
-    mockPublishEvent('cart', 'product-updated', {
+    mockPublishEvent("cart", "product-updated", {
         product: product,
         previousQuantity: previousQuantity,
         newQuantity: quantity
     });
-    return {
+    return Promise.resolve({
         success: true,
         internalId: internalId,
         quantity: quantity,
         timestamp: new Date().toISOString()
-    };
+    });
 };

package/dist/demo/database.d.ts

@@ -2,7 +2,7 @@
  * Mock Database for Standalone/Demo Mode
  * Stores mock data that mimics the Render environment
  */
-import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails } from "../CommonTypes";
+import { CFActiveCompany, CFActiveUser, CFActiveStation, CFActiveOutlet, CFActiveOrder, CFCustomer, CFProduct, CFActiveCart, CFCategory, CFActiveProduct, CFSession, CFActiveRefundDetails, CFSmartGridLayout } from "../CommonTypes";
 export * from "./mocks";
 /** Replace mock catalog / context data in place (same array references mock handlers use). */
 export interface MockDatabaseConfig {
@@ -34,29 +34,32 @@ export declare const MOCK_CATEGORY_SPECIALTY: CFCategory;
 export declare const MOCK_CATEGORY_BASIC: CFCategory;
 export declare const MOCK_CATEGORY_VEGAN: CFCategory;
 export declare const MOCK_CATEGORY_SPICY: CFCategory;
-export declare const MOCK_PRODUCT_BASIL_ALMOND: CFProduct;
-export declare const MOCK_PRODUCT_BEER: CFProduct;
-export declare const MOCK_PRODUCT_BEET: CFProduct;
-export declare const MOCK_PRODUCT_CARAMELIZED: CFProduct;
-export declare const MOCK_PRODUCT_GARLIC_ONION: CFProduct;
-export declare const MOCK_PRODUCT_GARLIC: CFProduct;
-export declare const MOCK_PRODUCT_GINGER_LIME: CFProduct;
-export declare const MOCK_PRODUCT_LEMON: CFProduct;
-export declare const MOCK_PRODUCT_RED_PEPPER: CFProduct;
-export declare const MOCK_PRODUCT_ROASTED_TOMATO: CFProduct;
-export declare const MOCK_PRODUCT_MINT_LEMON: CFProduct;
-export declare const MOCK_PRODUCT_CHILI_GARLIC: CFProduct;
-export declare const MOCK_PRODUCT_HABANERO: CFProduct;
-export declare const MOCK_PRODUCT_BLACK_GARLIC: CFProduct;
+export declare const MOCK_PRODUCT_BASIL_ALMOND: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_BEER: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_BEET: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_CARAMELIZED: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_GARLIC_ONION: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_GARLIC: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_GINGER_LIME: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_LEMON: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_RED_PEPPER: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_ROASTED_TOMATO: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_MINT_LEMON: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_CHILI_GARLIC: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_HABANERO: import("@final-commerce/common/pos-types").FullProduct;
+export declare const MOCK_PRODUCT_BLACK_GARLIC: import("@final-commerce/common/pos-types").FullProduct;
 export declare const MOCK_ORDER_1: CFActiveOrder;
 export declare const MOCK_ORDER_2: CFActiveOrder;
-export declare const MOCK_USERS: CFActiveUser[];
-export declare const MOCK_STATIONS: CFActiveStation[];
-export declare const MOCK_OUTLETS: CFActiveOutlet[];
-export declare const MOCK_CUSTOMERS: CFCustomer[];
-export declare const MOCK_CATEGORIES: CFCategory[];
-export declare const MOCK_PRODUCTS: CFProduct[];
-export declare const MOCK_ORDERS: CFActiveOrder[];
+export declare const MOCK_ORDER_3: CFActiveOrder;
+export declare const MOCK_PARKED_ORDER_1: CFActiveOrder;
+export declare const MOCK_PARKED_ORDER_2: CFActiveOrder;
+export declare const MOCK_USERS: import("@final-commerce/common/pos-types").ActiveUser[];
+export declare const MOCK_STATIONS: import("@final-commerce/common/pos-types").ActiveStation[];
+export declare const MOCK_OUTLETS: import("@final-commerce/common/pos-types").ActiveOutlet[];
+export declare const MOCK_CUSTOMERS: import("@final-commerce/common/pos-types").ActiveCustomer[];
+export declare const MOCK_CATEGORIES: import("@final-commerce/common/pos-types").Category[];
+export declare const MOCK_PRODUCTS: import("@final-commerce/common/pos-types").FullProduct[];
+export declare const MOCK_ORDERS: import("@final-commerce/common/pos-types").ActiveOrder[];
 export declare const MOCK_PARKED_ORDERS: CFActiveOrder[];
 export declare let MOCK_USER: CFActiveUser;
 export declare let MOCK_STATION: CFActiveStation;
@@ -64,6 +67,7 @@ export declare let MOCK_OUTLET: CFActiveOutlet;
 export declare let MOCK_CART: CFActiveCart;
 export declare let MOCK_ACTIVE_PRODUCT: CFActiveProduct;
 export declare const setMockActiveProduct: (activeProduct: CFActiveProduct) => void;
+export declare const MOCK_SMART_GRID_LAYOUTS: Record<string, CFSmartGridLayout>;
 export declare const resetMockCart: () => void;
 /**
  * Replace in-memory mock data used by default mock handlers. Arrays are mutated in place
@@ -75,3 +79,10 @@ type MockEventCallback = (event: any) => void;
 export declare const mockPublishEvent: (topic: string, eventType: string, data: any) => void;
 export declare const mockSubscribeToTopic: (topic: string, callback: MockEventCallback) => void;
 export declare const createOrderFromCart: (paymentType: string, amount: number, processor?: string) => CFActiveOrder;
+/**
+ * Apply a (possibly partial) payment of `amount` minor units to the active cart.
+ * Decrements the remaining balance; when it reaches zero the sale completes
+ * (creates the order, resets the cart, returns it). Otherwise the cart stays
+ * open with `amountToBeCharged` reset to what's left, and returns null.
+ */
+export declare const applyMockPayment: (amount: number, paymentType: string, processor?: string) => CFActiveOrder | null;

package/dist/demo/database.js

@@ -6,7 +6,7 @@ import { CFProductType, CFUserTypes, CurrencyCode } from "../CommonTypes";
 export * from "./mocks";
 // Asset Imports - Using Remote URLs to avoid build complexity with asset copying
 const ASSETS_BASE_URL = "https://raw.githubusercontent.com/Final-Commerce/command-frame/refs/heads/main/src/demo/assets";
-const logo = `${ASSETS_BASE_URL}/logo.png`;
+const logo = "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA5OCAxMDQiIGZpbGw9Im5vbmUiPjxwYXRoIGQ9Ik01NS4yOTk4IDUwLjE2NjJMMzcuNzQyMiA0MC4wMjkzTDMxLjcyNzQgNTAuNDQ3MkwzOC45MjQyIDU0LjYwMjJMNTUuMjk5OCA1MC4xNjYyWiIgZmlsbD0iI0E1NjhCQyIvPjxwYXRoIGQ9Ik0zMS45OTYzIDcwLjQ1MDZMNDkuNTU2OCA4MC41ODkxTDU1LjU3MTUgNzAuMTcxM0w0OC4zNzE4IDY2LjAxNDVMMzEuOTk2MyA3MC40NTA2WiIgZmlsbD0iI0E1NjhCQyIvPjxwYXRoIGQ9Ik0zNi4zNTQyIDM0LjI1NzJDMzYuMzU0MiAzNC4yNTcyIDM2LjM1ODMgMzQuMjYzNSAzNi4zNTY3IDM0LjI2NjRDMzcuMTg2OSAzNC4wNjk3IDM4LjA5MTkgMzQuMTU5NiAzOC44ODUxIDM0LjYxNzVMNjIuNjQ4NiA0OC4zMzc0TDU0LjE3MjkgMjkuOTA0OUwzNi4zNDk2IDM0LjI1ODRMMzYuMzU0MiAzNC4yNTcyWiIgZmlsbD0iI0ZDODc1MyIvPjxwYXRoIGQ9Ik0zMy4wOTg4IDE4Ljk1MDdMMzYuMzc3MiAzNC4yNDczTDE4Ljc1MjUgMzkuMzM3M0wyOC45MzcxIDIxLjY5N0MyOS44NDUzIDIwLjEyMzkgMzEuNDE1MiAxOS4xNzYxIDMzLjA5ODggMTguOTUwN1oiIGZpbGw9IiM0MkQzQTkiLz48cGF0aCBkPSJNMTguNzUzMiAzOS4zNDA2TDIwLjY4MjQgNTkuNTE3MUw0LjU3NjA3IDYzLjg5NjJMMTguNzUzMiAzOS4zNDA2WiIgZmlsbD0iIzI3OTdFOCIvPjxwYXRoIGQ9Ik0zNi4zNzc5IDM0LjI0MDNDMzYuMzc3OSAzNC4yNDAzIDM2LjM3NzQgMzQuMjQ3OCAzNi4zODAzIDM0LjI0OTVDMzUuNTYyNCAzNC40OTE5IDM0LjgyMzkgMzUuMDE5NiAzNC4zNjczIDM1LjgxMDVMMjAuNjg2OSA1OS41MDU2TDE4Ljc1NzcgMzkuMzI5MUwzNi4zODI0IDM0LjIzOTFMMzYuMzc3OSAzNC4yNDAzWiIgZmlsbD0iIzFEQkFDQiIvPjxwYXRoIGQ9Ik01NS45MzUyIDEwMS41NDNMNTEuMDgxOSA4Ni42NjU5TDMzLjI1ODcgOTEuMDE5NEw1MC45NDk5IDEwMS4yMzNDNTIuNTI3NiAxMDIuMTQ0IDU0LjM2MzggMTAyLjE4NSA1NS45MzUyIDEwMS41NDNaIiBmaWxsPSIjRkQ1MjYzIi8+PHBhdGggZD0iTTMzLjI1NDkgOTEuMDE0TDI0Ljc4MjEgNzIuNTgzMkw4LjYzMTM1IDc2Ljc5NzVMMzMuMjU0OSA5MS4wMTRaIiBmaWxsPSIjRkZDRjIzIi8+PHBhdGggZD0iTTUxLjA3OSA4Ni42NjM5QzUxLjA3OSA4Ni42NjM5IDUxLjA3NDkgODYuNjU3NiA1MS4wNzY2IDg2LjY1NDdDNTAuMjQ2NCA4Ni44NTE0IDQ5LjM0MTQgODYuNzYxNSA0OC41NDgyIDg2LjMwMzZMMjQuNzg0NiA3Mi41ODM3TDMzLjI2MDQgOTEuMDE2MUw1MS4wODM2IDg2LjY2MjdMNTEuMDc5IDg2LjY2MzlaIiBmaWxsPSIjRkM4NzUzIi8+PHBhdGggZD0iTTU0LjMzNDIgMTAxLjk2OUw1MS4wNTU4IDg2LjY3MjRMNjguNjgwNSA4MS41ODI0TDU4LjQ5NTkgOTkuMjIyN0M1Ny41ODc3IDEwMC43OTYgNTYuMDE3OCAxMDEuNzQ0IDU0LjMzNDIgMTAxLjk2OVoiIGZpbGw9IiM0MkQzQTkiLz48cGF0aCBkPSJNNjguNjgwMSA4MS41ODk5TDY2Ljc0OTMgNjEuNDE2Mkw4Mi44NTU2IDU3LjAzNzJMNjguNjgwMSA4MS41ODk5WiIgZmlsbD0iIzI3OTdFOCIvPjxwYXRoIGQ9Ik01MS4wNTU3IDg2LjY3ODZDNTEuMDU1NyA4Ni42Nzg2IDUxLjA1NjIgODYuNjcxMSA1MS4wNTMyIDg2LjY2OTVDNTEuODcxMSA4Ni40MjcxIDUyLjYwOTcgODUuODk5NCA1My4wNjYzIDg1LjEwODVMNjYuNzQ2NyA2MS40MTMzTDY4LjY3NTkgODEuNTg5OEw1MS4wNTExIDg2LjY3OThMNTEuMDU1NyA4Ni42Nzg2WiIgZmlsbD0iIzFEQkFDQiIvPjxwYXRoIGQ9Ik00Ny44OTQ5IDI2LjI3NjhDNDcuODc4IDI2LjM1OTcgNDcuODUyIDI2LjQ0NTEgNDcuODA2OCAyNi41MjM0TDQ3LjYyNzggMjYuODMzM0M0Ni43ODY1IDI4LjI5MDYgNDQuOTIzMiAyOC43ODY5IDQzLjQ2MTggMjcuOTQzMkM0Mi4wMDA0IDI3LjA5OTQgNDEuNDk4NiAyNS4yMzc2IDQyLjMzOTkgMjMuNzgwNEw0Mi41MTg5IDIzLjQ3MDRDNDIuNTY0MSAyMy4zOTIyIDQyLjYyNSAyMy4zMjY5IDQyLjY4ODQgMjMuMjcwOEwzNi40ODUzIDE5LjY4OTRDMzQuOTA3NiAxOC43Nzg2IDMzLjA3MTQgMTguNzM4MiAzMS41IDE5LjM3OTlMMzYuMzUzMyAzNC4yNTY5TDU0LjE3NjUgMjkuOTAzNUw0Ny44OTQ5IDI2LjI3NjhaIiBmaWxsPSIjRkQ1MjYzIi8+PHBhdGggZD0iTTc1LjYzODYgNDIuMzAyN0M3NS42MjE3IDQyLjM4NTcgNzUuNTk1NiA0Mi40NzExIDc1LjU1MDUgNDIuNTQ5M0w3NS4zNzE1IDQyLjg1OTNDNzQuNTMwMiA0NC4zMTY1IDcyLjY2NjkgNDQuODEyOSA3MS4yMDU0IDQzLjk2OTFDNjkuNzQ0IDQzLjEyNTQgNjkuMjQyMyA0MS4yNjM2IDcwLjA4MzYgMzkuODA2M0w3MC4yNjI2IDM5LjQ5NjNDNzAuMzA3NyAzOS40MTgxIDcwLjM2ODYgMzkuMzUyOSA3MC40MzIgMzkuMjk2N0w1NC4xNzYxIDI5LjkxMTRMNjIuNjUxOSA0OC4zNDM5TDc4LjgwMjYgNDQuMTI5NUw3NS42NDE1IDQyLjMwNDRMNzUuNjM4NiA0Mi4zMDI3WiIgZmlsbD0iI0ZGQ0YyMyIvPjxwYXRoIGQ9Ik03NS42MDU4IDQwLjgyMTlMNzUuNjQ0MiA0MC43NTUyQzc4LjE0ODEgMzYuNDE4MyA3OC42NDY1IDMxLjQ0ODggNzcuNDMwOSAyNi45MzgzQzc2LjIxNTMgMjIuNDI3OCA3My4yODQ3IDE4LjM3MTggNjguOTM1MiAxNS44NjA3QzY0LjU4NTggMTMuMzQ5NSA1OS42MDc5IDEyLjgzOTUgNTUuMDkzOSAxNC4wNDJDNTAuNTc5OSAxNS4yNDQ2IDQ2LjUyNTMgMTguMTYwOSA0NC4wMjE0IDIyLjQ5NzhMNDIuOTkxMSAyNC4yODI0QzQyLjM3MzkgMjUuMzUxNCA0Mi43NDQyIDI2LjcxNjMgNDMuODEzNCAyNy4zMzM2QzQ0Ljg4MjYgMjcuOTUwOSA0Ni4yNTE0IDI3LjU4NjIgNDYuODY2OSAyNi41MjAxTDQ3Ljg5NzMgMjQuNzM1NUM0OS43ODU3IDIxLjQ2NDcgNTIuODQ0MSAxOS4yNjczIDU2LjI1NDggMTguMzU4N0M1OS42NjU0IDE3LjQ1MDEgNjMuNDE5MSAxNy44MzI3IDY2LjY5OTQgMTkuNzI2NkM2OS45Nzk2IDIxLjYyMDQgNzIuMTg3OSAyNC42Nzk5IDczLjEwNjMgMjguMDg3OUM3NC4wMjQ4IDMxLjQ5NiA3My42NTEgMzUuMjQzNCA3MS43NjI2IDM4LjUxNDFMNzEuNzI0MSAzOC41ODA4TDcwLjczMzkgNDAuMjk1OEM3MC4xMTY3IDQxLjM2NDkgNzAuNDg3IDQyLjcyOTcgNzEuNTU2MiA0My4zNDdDNzIuNjI1NCA0My45NjQ0IDczLjk5NDIgNDMuNTk5NyA3NC42MDk4IDQyLjUzMzZMNzUuNTk5OSA0MC44MTg1TDc1LjYwNTggNDAuODIxOVoiIGZpbGw9IiMzRDRDNjYiLz48L3N2Zz4="; // crisp vector mark (was logo.png — pixelated when scaled)
 const basilAlmondImg = `${ASSETS_BASE_URL}/basil-almond-paste.png`;
 const beerImg = `${ASSETS_BASE_URL}/beer-paste.png`;
 const beetImg = `${ASSETS_BASE_URL}/beet-paste.png`;
@@ -167,39 +167,46 @@ export const MOCK_CUSTOMER_5 = {
 };
 // --- CATEGORIES ---
 export const MOCK_CATEGORY_PASTES = {
-    _id: "cat_pastes",
+    id: "cat_pastes",
+    createdAt: "2024-01-01T00:00:00.000Z",
+    updatedAt: "2024-01-01T00:00:00.000Z",
     name: "Pastes",
     externalId: "ext_cat_pastes",
     companyId: MOCK_COMPANY.id,
-    parentId: null
 };
 export const MOCK_CATEGORY_SPECIALTY = {
-    _id: "cat_specialty",
+    id: "cat_specialty",
+    createdAt: "2024-01-01T00:00:00.000Z",
+    updatedAt: "2024-01-01T00:00:00.000Z",
     name: "Specialty",
     externalId: "ext_cat_specialty",
     companyId: MOCK_COMPANY.id,
     parentId: "cat_pastes"
 };
 export const MOCK_CATEGORY_BASIC = {
-    _id: "cat_basic",
+    id: "cat_basic",
+    createdAt: "2024-01-01T00:00:00.000Z",
+    updatedAt: "2024-01-01T00:00:00.000Z",
     name: "Basic",
     externalId: "ext_cat_basic",
     companyId: MOCK_COMPANY.id,
     parentId: "cat_pastes"
 };
 export const MOCK_CATEGORY_VEGAN = {
-    _id: "cat_vegan",
+    id: "cat_vegan",
+    createdAt: "2024-01-01T00:00:00.000Z",
+    updatedAt: "2024-01-01T00:00:00.000Z",
     name: "Vegan",
     externalId: "ext_cat_vegan",
     companyId: MOCK_COMPANY.id,
-    parentId: null
 };
 export const MOCK_CATEGORY_SPICY = {
-    _id: "cat_spicy",
+    id: "cat_spicy",
+    createdAt: "2024-01-01T00:00:00.000Z",
+    updatedAt: "2024-01-01T00:00:00.000Z",
     name: "Spicy",
     externalId: "ext_cat_spicy",
     companyId: MOCK_COMPANY.id,
-    parentId: null
 };
 // --- PRODUCTS ---
 const createInventory = (stock) => [{ warehouse: "main", outletId: MOCK_OUTLET_MAIN.id, stock }];
@@ -221,7 +228,7 @@ const createSimpleProduct = (id, name, price, image, categories, description) =>
         taxTable: "tax_standard",
         description,
         images: [image],
-        categories: categories.map(c => c._id),
+        categories: categories.map(c => ({ name: c.name, externalId: c.externalId ?? c.id })),
         attributes: [],
         variants: [
             {
@@ -256,7 +263,7 @@ const createVariableProduct = (id, name, basePrice, largePrice, image, categorie
         taxTable: "tax_standard",
         description,
         images: [image],
-        categories: categories.map(c => c._id),
+        categories: categories.map(c => ({ name: c.name, externalId: c.externalId ?? c.id })),
         attributes: [{ name: "Size", values: ["Small", "Large"] }],
         variants: [
             {
@@ -314,12 +321,13 @@ const createLineItem = (product, variantIndex = 0, quantity = 1) => {
         price: variant.price,
         taxes: [],
         discount: {
-            itemDiscount: { percentage: 0, amount: 0 },
+            itemDiscounts: [],
             cartDiscount: { percentage: 0, amount: 0 }
         },
-        fee: { itemFee: { percentage: 0, amount: 0, tax: 0, taxTableId: "" } },
+        fee: { itemFees: [] },
         totalTax: 0,
         total: variant.price * quantity,
+        lineNetWithFees: variant.price * quantity,
         metadata: [],
         image: product.images?.[0] || "",
         sku: variant.sku,
@@ -341,7 +349,7 @@ export const MOCK_ORDER_1 = {
     customer: MOCK_CUSTOMER_1,
     summary: {
         total: 2100,
-        subTotal: 2100,
+        subtotalAfterFees: 2100,
         discountTotal: 0,
         shippingTotal: 0,
         totalTaxes: 0,
@@ -391,7 +399,7 @@ export const MOCK_ORDER_2 = {
     customer: MOCK_CUSTOMER_2,
     summary: {
         total: 3000,
-        subTotal: 3000,
+        subtotalAfterFees: 3000,
         discountTotal: 0,
         shippingTotal: 0,
         totalTaxes: 0,
@@ -427,6 +435,140 @@ export const MOCK_ORDER_2 = {
     station: MOCK_STATION_2,
     createdAt: new Date(Date.now() - 3600000).toISOString()
 };
+export const MOCK_ORDER_3 = {
+    _id: "order_1003",
+    currency: CurrencyCode.USD,
+    minorUnits: 2,
+    receiptId: "1001-0003",
+    companyId: MOCK_COMPANY.id,
+    externalId: null,
+    status: "refunded",
+    paymentState: "refunded",
+    fulfillmentState: "fulfilled",
+    displayState: "Refunded",
+    customer: MOCK_CUSTOMER_3,
+    summary: {
+        total: 1500,
+        subtotalAfterFees: 1500,
+        discountTotal: 0,
+        shippingTotal: 0,
+        totalTaxes: 0,
+        taxes: [],
+        isTaxInclusive: false
+    },
+    cartDiscount: null,
+    cartFees: [],
+    paymentMethods: [
+        {
+            transactionId: "trans_card_2",
+            paymentType: "credit_card",
+            amount: 1500,
+            timestamp: new Date(Date.now() - 7200000).toISOString(),
+            processor: "stripe"
+        }
+    ],
+    source: "pos",
+    posData: {
+        outlet: MOCK_OUTLET_MAIN.id,
+        station: MOCK_STATION_1._id,
+        employee: MOCK_USER_MARIO.id
+    },
+    sessionId: "sess_3",
+    metadata: [],
+    billing: null,
+    shipping: null,
+    lineItems: [createLineItem(MOCK_PRODUCT_BEET, 0, 1)],
+    customSales: [],
+    balance: 0,
+    user: MOCK_USER_MARIO,
+    outlet: MOCK_OUTLET_MAIN,
+    station: MOCK_STATION_1,
+    createdAt: new Date(Date.now() - 7200000).toISOString()
+};
+export const MOCK_PARKED_ORDER_1 = {
+    _id: "parked_2001",
+    currency: CurrencyCode.USD,
+    minorUnits: 2,
+    receiptId: "PARK-0001",
+    companyId: MOCK_COMPANY.id,
+    externalId: null,
+    status: "parked",
+    paymentState: "unpaid",
+    fulfillmentState: "pending",
+    displayState: "Parked",
+    customer: MOCK_CUSTOMER_4,
+    summary: {
+        total: 2100,
+        subtotalAfterFees: 2100,
+        discountTotal: 0,
+        shippingTotal: 0,
+        totalTaxes: 0,
+        taxes: [],
+        isTaxInclusive: false
+    },
+    cartDiscount: null,
+    cartFees: [],
+    paymentMethods: [],
+    source: "pos",
+    posData: {
+        outlet: MOCK_OUTLET_MAIN.id,
+        station: MOCK_STATION_1._id,
+        employee: MOCK_USER_LUIGI.id
+    },
+    sessionId: "sess_park_1",
+    metadata: [],
+    billing: null,
+    shipping: null,
+    lineItems: [createLineItem(MOCK_PRODUCT_LEMON, 0, 2)],
+    customSales: [],
+    balance: 2100,
+    user: MOCK_USER_LUIGI,
+    outlet: MOCK_OUTLET_MAIN,
+    station: MOCK_STATION_1,
+    createdAt: new Date(Date.now() - 1800000).toISOString()
+};
+export const MOCK_PARKED_ORDER_2 = {
+    _id: "parked_2002",
+    currency: CurrencyCode.USD,
+    minorUnits: 2,
+    receiptId: "PARK-0002",
+    companyId: MOCK_COMPANY.id,
+    externalId: null,
+    status: "parked",
+    paymentState: "unpaid",
+    fulfillmentState: "pending",
+    displayState: "Parked",
+    customer: null,
+    summary: {
+        total: 2500,
+        subtotalAfterFees: 2500,
+        discountTotal: 0,
+        shippingTotal: 0,
+        totalTaxes: 0,
+        taxes: [],
+        isTaxInclusive: false
+    },
+    cartDiscount: null,
+    cartFees: [],
+    paymentMethods: [],
+    source: "pos",
+    posData: {
+        outlet: MOCK_OUTLET_MAIN.id,
+        station: MOCK_STATION_2._id,
+        employee: MOCK_USER_MARIO.id
+    },
+    sessionId: "sess_park_2",
+    metadata: [],
+    billing: null,
+    shipping: null,
+    lineItems: [createLineItem(MOCK_PRODUCT_CARAMELIZED, 0, 1), createLineItem(MOCK_PRODUCT_GINGER_LIME, 0, 1)],
+    customSales: [],
+    balance: 2500,
+    user: MOCK_USER_MARIO,
+    outlet: MOCK_OUTLET_MAIN,
+    station: MOCK_STATION_2,
+    createdAt: new Date(Date.now() - 900000).toISOString()
+};
 // --- EXPORT COLLECTIONS ---
 export const MOCK_USERS = [MOCK_USER_MARIO, MOCK_USER_LUIGI];
 export const MOCK_STATIONS = [MOCK_STATION_1, MOCK_STATION_2];
@@ -449,8 +591,8 @@ export const MOCK_PRODUCTS = [
     MOCK_PRODUCT_HABANERO,
     MOCK_PRODUCT_BLACK_GARLIC
 ];
-export const MOCK_ORDERS = [MOCK_ORDER_1, MOCK_ORDER_2];
-export const MOCK_PARKED_ORDERS = [];
+export const MOCK_ORDERS = [MOCK_ORDER_1, MOCK_ORDER_2, MOCK_ORDER_3];
+export const MOCK_PARKED_ORDERS = [MOCK_PARKED_ORDER_1, MOCK_PARKED_ORDER_2];
 // Compatibility Exports (reassigned by setMockDatabase)
 export let MOCK_USER = MOCK_USERS[0];
 export let MOCK_STATION = MOCK_STATIONS[0];
@@ -469,6 +611,10 @@ export let MOCK_ACTIVE_PRODUCT;
 export const setMockActiveProduct = (activeProduct) => {
     MOCK_ACTIVE_PRODUCT = activeProduct;
 };
+// In-memory smart-grid layouts keyed by gridId. Used by mockGetSmartGridLayout /
+// mockSaveSmartGridLayout so the standalone builder (no command-frame host) can
+// round-trip layouts within a session.
+export const MOCK_SMART_GRID_LAYOUTS = {};
 // Helper to reset cart
 export const resetMockCart = () => {
     MOCK_CART = {
@@ -587,12 +733,13 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
             price: p.price,
             taxes: [],
             discount: {
-                itemDiscount: { percentage: 0, amount: 0, const: "0" },
-                cartDiscount: { percentage: 0, amount: 0, const: "0" }
+                itemDiscounts: [],
+                cartDiscount: { percentage: 0, amount: 0 }
             },
-            fee: { itemFee: { percentage: 0, amount: 0, tax: 0, taxTableId: "" } },
+            fee: { itemFees: [] },
             totalTax: 0,
             total: p.price * p.quantity,
+            lineNetWithFees: p.price * p.quantity,
             metadata: [],
             image: p.images?.[0] || "",
             sku: p.sku || "",
@@ -615,7 +762,7 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
         customer: MOCK_CART.customer ? MOCK_CART.customer : null,
         summary: {
             total: totalNum,
-            subTotal: totalNum,
+            subtotalAfterFees: totalNum,
             discountTotal: 0,
             shippingTotal: 0,
             totalTaxes: 0,
@@ -657,3 +804,26 @@ export const createOrderFromCart = (paymentType, amount, processor = "cash") =>
     mockPublishEvent("cart", "cart-created", {});
     return newOrder;
 };
+/**
+ * Apply a (possibly partial) payment of `amount` minor units to the active cart.
+ * Decrements the remaining balance; when it reaches zero the sale completes
+ * (creates the order, resets the cart, returns it). Otherwise the cart stays
+ * open with `amountToBeCharged` reset to what's left, and returns null.
+ */
+export const applyMockPayment = (amount, paymentType, processor = "cash") => {
+    const remainingBefore = MOCK_CART.remainingBalance ?? MOCK_CART.total;
+    const charge = Math.min(Math.max(0, amount || remainingBefore), remainingBefore);
+    const remainingAfter = Math.max(0, remainingBefore - charge);
+    if (remainingAfter > 0) {
+        // Partial payment — keep the cart open, queue the rest for the next tender.
+        MOCK_CART.remainingBalance = remainingAfter;
+        MOCK_CART.amountToBeCharged = remainingAfter;
+        mockPublishEvent("cart", "partial-payment-applied", { charged: charge, remaining: remainingAfter });
+        return null;
+    }
+    // Fully paid — create the completed order (this also resets the cart).
+    const orderTotal = MOCK_CART.total;
+    const order = createOrderFromCart(paymentType, orderTotal, processor);
+    mockPublishEvent("payments", "payment-done", { order });
+    return order;
+};