@gomusdev/web-components 3.12.0 → 4.1.0

package/dist-js/src/components/shared/quantityStepper/QuantityControl.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-js/src/components/ticketSelection/subcomponents/tickets/subcomponents/segment/SegmentDetails.svelte.d.ts

@@ -8,16 +8,19 @@ export declare class SegmentDetails {
             type: "Ticket" | "Event" | "Coupon";
             product: import('../../../../../../lib/models/cart/types').Product;
             orderAttributes(): {
+                sub_ticket_quantities?: Record<number, number> | undefined;
                 time: string | undefined;
                 quantity: number | undefined;
                 shipped_with_merchandise_id: null;
                 shipping_mode: string;
                 id: number;
+                uuid: string;
             } | {
                 quantity: number | undefined;
                 shipped_with_merchandise_id: null;
                 shipping_mode: string;
                 id: number;
+                uuid: string;
             } | {
                 quantities: {
                     [x: number]: number | undefined;
@@ -25,6 +28,7 @@ export declare class SegmentDetails {
                 shipped_with_merchandise_id: null;
                 shipping_mode: string;
                 id: number;
+                uuid: string;
             };
             uuid: string;
             subUId: string;
@@ -37,6 +41,10 @@ export declare class SegmentDetails {
             total_price_formatted: string;
             quantity?: number | undefined;
             time?: string | undefined;
+            mantle?: {
+                composition: Record<number, number>;
+                key?: string;
+            } | undefined;
             display?: {
                 discounted: boolean;
                 reference_uuid: string;
@@ -50,16 +58,19 @@ export declare class SegmentDetails {
             type: "Ticket" | "Event" | "Coupon";
             product: import('../../../../../../lib/models/cart/types').Product;
             orderAttributes(): {
+                sub_ticket_quantities?: Record<number, number> | undefined;
                 time: string | undefined;
                 quantity: number | undefined;
                 shipped_with_merchandise_id: null;
                 shipping_mode: string;
                 id: number;
+                uuid: string;
             } | {
                 quantity: number | undefined;
                 shipped_with_merchandise_id: null;
                 shipping_mode: string;
                 id: number;
+                uuid: string;
             } | {
                 quantities: {
                     [x: number]: number | undefined;
@@ -67,6 +78,7 @@ export declare class SegmentDetails {
                 shipped_with_merchandise_id: null;
                 shipping_mode: string;
                 id: number;
+                uuid: string;
             };
             uuid: string;
             subUId: string;
@@ -79,6 +91,10 @@ export declare class SegmentDetails {
             total_price_formatted: string;
             quantity?: number | undefined;
             time?: string | undefined;
+            mantle?: {
+                composition: Record<number, number>;
+                key?: string;
+            } | undefined;
             display?: {
                 discounted: boolean;
                 reference_uuid: string;
@@ -94,16 +110,19 @@ export declare class SegmentDetails {
             items: {
                 type: "Ticket" | "Event" | "Coupon";
                 attributes: {
+                    sub_ticket_quantities?: Record<number, number> | undefined;
                     time: string | undefined;
                     quantity: number | undefined;
                     shipped_with_merchandise_id: null;
                     shipping_mode: string;
                     id: number;
+                    uuid: string;
                 } | {
                     quantity: number | undefined;
                     shipped_with_merchandise_id: null;
                     shipping_mode: string;
                     id: number;
+                    uuid: string;
                 } | {
                     quantities: {
                         [x: number]: number | undefined;
@@ -111,6 +130,7 @@ export declare class SegmentDetails {
                     shipped_with_merchandise_id: null;
                     shipping_mode: string;
                     id: number;
+                    uuid: string;
                 };
             }[];
             shipping_address_id: null;

package/dist-js/src/factories/CartItemFactories.d.ts

@@ -1,5 +1,6 @@
 import { EventTicketFactories } from './EventTicketFactories.ts';
 import { TicketFactories } from './TicketFactories.ts';
+export declare const DEFAULT_TIME = "2122-09-18T12:00:00+02:00";
 interface TicketCartItemOptions {
     quantity?: number;
     time?: string;
@@ -12,21 +13,30 @@ interface EventCartItemOptions {
     event_title?: string;
     eventTicket?: Partial<ReturnType<typeof EventTicketFactories.scaled>>;
 }
+interface MantleCartItemOptions {
+    quantity?: number;
+    time?: string;
+    ticket?: Parameters<typeof TicketFactories.mantle>[0];
+    subTicketQuantities?: Record<number, number>;
+}
 export declare const CartItemFactories: {
     timeslot({ quantity, time, ticket }?: TicketCartItemOptions): {
         type: "Ticket" | "Event" | "Coupon";
         product: import('../lib/models/cart/types.ts').Product;
         orderAttributes(): {
+            sub_ticket_quantities?: Record<number, number> | undefined;
             time: string | undefined;
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantities: {
                 [x: number]: number | undefined;
@@ -34,6 +44,7 @@ export declare const CartItemFactories: {
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         };
         uuid: string;
         subUId: string;
@@ -46,6 +57,10 @@ export declare const CartItemFactories: {
         total_price_formatted: string;
         quantity?: number | undefined;
         time?: string | undefined;
+        mantle?: {
+            composition: Record<number, number>;
+            key?: string;
+        } | undefined;
         display?: {
             discounted: boolean;
             reference_uuid: string;
@@ -56,16 +71,66 @@ export declare const CartItemFactories: {
         type: "Ticket" | "Event" | "Coupon";
         product: import('../lib/models/cart/types.ts').Product;
         orderAttributes(): {
+            sub_ticket_quantities?: Record<number, number> | undefined;
+            time: string | undefined;
+            quantity: number | undefined;
+            shipped_with_merchandise_id: null;
+            shipping_mode: string;
+            id: number;
+            uuid: string;
+        } | {
+            quantity: number | undefined;
+            shipped_with_merchandise_id: null;
+            shipping_mode: string;
+            id: number;
+            uuid: string;
+        } | {
+            quantities: {
+                [x: number]: number | undefined;
+            };
+            shipped_with_merchandise_id: null;
+            shipping_mode: string;
+            id: number;
+            uuid: string;
+        };
+        uuid: string;
+        subUId: string;
+        toString(): string;
+        price_cents: number;
+        price_formatted: string;
+        final_price_cents: number;
+        final_price_formatted: string;
+        total_price_cents: number;
+        total_price_formatted: string;
+        quantity?: number | undefined;
+        time?: string | undefined;
+        mantle?: {
+            composition: Record<number, number>;
+            key?: string;
+        } | undefined;
+        display?: {
+            discounted: boolean;
+            reference_uuid: string;
+            originalPrice: number;
+        } | undefined;
+    };
+    mantle({ quantity, time, ticket, subTicketQuantities }?: MantleCartItemOptions): {
+        type: "Ticket" | "Event" | "Coupon";
+        product: import('../lib/models/cart/types.ts').Product;
+        orderAttributes(): {
+            sub_ticket_quantities?: Record<number, number> | undefined;
             time: string | undefined;
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantities: {
                 [x: number]: number | undefined;
@@ -73,6 +138,7 @@ export declare const CartItemFactories: {
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         };
         uuid: string;
         subUId: string;
@@ -85,6 +151,10 @@ export declare const CartItemFactories: {
         total_price_formatted: string;
         quantity?: number | undefined;
         time?: string | undefined;
+        mantle?: {
+            composition: Record<number, number>;
+            key?: string;
+        } | undefined;
         display?: {
             discounted: boolean;
             reference_uuid: string;
@@ -95,16 +165,19 @@ export declare const CartItemFactories: {
         type: "Ticket" | "Event" | "Coupon";
         product: import('../lib/models/cart/types.ts').Product;
         orderAttributes(): {
+            sub_ticket_quantities?: Record<number, number> | undefined;
             time: string | undefined;
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantities: {
                 [x: number]: number | undefined;
@@ -112,6 +185,7 @@ export declare const CartItemFactories: {
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         };
         uuid: string;
         subUId: string;
@@ -124,6 +198,10 @@ export declare const CartItemFactories: {
         total_price_formatted: string;
         quantity?: number | undefined;
         time?: string | undefined;
+        mantle?: {
+            composition: Record<number, number>;
+            key?: string;
+        } | undefined;
         display?: {
             discounted: boolean;
             reference_uuid: string;
@@ -134,16 +212,19 @@ export declare const CartItemFactories: {
         type: "Ticket" | "Event" | "Coupon";
         product: import('../lib/models/cart/types.ts').Product;
         orderAttributes(): {
+            sub_ticket_quantities?: Record<number, number> | undefined;
             time: string | undefined;
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantity: number | undefined;
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         } | {
             quantities: {
                 [x: number]: number | undefined;
@@ -151,6 +232,7 @@ export declare const CartItemFactories: {
             shipped_with_merchandise_id: null;
             shipping_mode: string;
             id: number;
+            uuid: string;
         };
         uuid: string;
         subUId: string;
@@ -163,6 +245,10 @@ export declare const CartItemFactories: {
         total_price_formatted: string;
         quantity?: number | undefined;
         time?: string | undefined;
+        mantle?: {
+            composition: Record<number, number>;
+            key?: string;
+        } | undefined;
         display?: {
             discounted: boolean;
             reference_uuid: string;

package/dist-js/src/factories/QuotaFactories.d.ts

@@ -0,0 +1,16 @@
+import { Quotas } from '@gomus/types';
+interface GatingQuotaOptions {
+    cap: number;
+    /** total_capacities value; defaults to `cap` (an untouched contingent). */
+    total?: number;
+    /** Timeslot key; defaults to the CartItemFactories DEFAULT_TIME so quota and item line up. */
+    time?: string;
+    /** Tickets gated by the quota; defaults to the ticket factories' default id. */
+    ticketIds?: number[];
+    quotaId?: string;
+}
+export declare const QuotaFactories: {
+    /** A single quota of `cap` seats gating `ticketIds` at `time`. */
+    gating({ cap, total, time, ticketIds, quotaId }: GatingQuotaOptions): Quotas;
+};
+export {};

package/dist-js/src/factories/TicketFactories.d.ts

@@ -84,6 +84,48 @@ export declare const TicketFactories: {
         restricted_shop_account: boolean;
         dynamic_prices: null;
     };
+    mantle(options?: Partial<ReturnType<typeof defaultTicket>>): {
+        type: ProductType;
+        id: number;
+        ticket_type: "time_slot";
+        title: string;
+        description: string;
+        selectedTime: string;
+        museum_ids: never[];
+        exhibition_ids: never[];
+        quota_ids: never[];
+        first_entry: number;
+        last_entry: number;
+        personalizeable: boolean;
+        min_persons: number;
+        max_persons: number;
+        bookable: boolean;
+        price_cents: number;
+        discount: number;
+        vat_pct: number;
+        tax_included: boolean;
+        entry_duration: number;
+        attendees: boolean;
+        identification: string;
+        free_timing: boolean;
+        is_collective: boolean;
+        is_upgrade: boolean;
+        is_mantle: boolean;
+        sub_ticket_ids: number[];
+        sub_tickets: {};
+        is_sub_ticket: boolean;
+        created_at: string;
+        updated_at: string;
+        cash_point_order: number;
+        shop_order: number;
+        capacities: {};
+        total_capacities: {};
+        max_capacity: number;
+        max_total_capacity: number;
+        shipped_with_merchandise_id: null;
+        restricted_shop_account: boolean;
+        dynamic_prices: null;
+    };
 };
 declare function defaultTicket(): {
     type: ProductType;

package/dist-js/src/lib/models/capacity/CapacityManager.d.ts

@@ -44,6 +44,7 @@ export declare function createCapacityManager(): {
         precart: Record<string, number>;
         clearPrecart(): void;
         setPrecartItemQuantity(ticketId: number, quantity: number): void;
+        addPrecartItemQuantity(ticketId: number, quantity: number): void;
         getPrecartItemQuantity(ticketId: number): number;
         timeslots(): {
             timeSlot: string;
@@ -62,7 +63,7 @@ export declare function createCapacityManager(): {
             capacity: number;
             totalCapacity: number;
         }[];
-        ticketCapacity(ticketId: number, timeslot: string): number;
+        ticketCapacity(ticketId: number, timeslot: string, ownQuantity?: any): number;
         totalCapacity(ticketId: number, timeslot: string): number;
         timeslotsOn(date: import('@internationalized/date').CalendarDate, ticketIds?: number[]): {
             timeSlot: string;
@@ -74,6 +75,7 @@ export declare function createCapacityManager(): {
     };
     addQuotas(quotas: Quotas, saveToLocalStorage?: boolean): void;
     addSeats(dateId: DateID, seats: Seats, saveToLocalStorage?: boolean): void;
-    capacityPolicy(item: CartItem): "quotas" | "unlimited" | "seats";
+    capacityPolicy(item: CartItem): "quotas" | "mantle" | "unlimited" | "seats";
     capacity(cart: Cart, item: CartItem, preCart: Cart): import('./types.ts').Capacity;
+    subTicketMaxes(cart: Cart, item: CartItem, preCart: Cart): Record<number, number>;
 };

package/dist-js/src/lib/models/capacity/calculators/mantle.d.ts

@@ -0,0 +1,34 @@
+import { CapacityManager } from '../../../../../lib/models/capacity/CapacityManager.ts';
+import { CapacityCalculator } from '../../../../../lib/models/capacity/types.ts';
+import { Cart } from '../../../../../lib/models/cart/cart.svelte.ts';
+import { CartItem } from '../../../../../lib/models/cart/types.ts';
+import { UIMantleTicket } from '../../../../../lib/models/ticket/UITicket.svelte.ts';
+/**
+ * Capacity for a Mantelticket — a verbatim port of the legacy Angular shop
+ * (`gomus-shop` `ticket.service.coffee`: `getNeededCapacityForTicket` +
+ * `getSelectableQuantitiesForTicket`).
+ *
+ * A mantle is gated off its OWN quota, exactly like a normal ticket, except one mantle
+ * draws `Σ(chosen sub-quantities)` capacity instead of one. So:
+ *
+ *   maxMantles = ⌊ mantleHeadroom / Σ(composition) ⌋   (divide only when Σ > 1)
+ *
+ * The sub-tickets' own quotas are never read — the shop API never exposes them, and the
+ * mantle's own quota already reflects the venue/exhibition contingent. The chosen
+ * composition is only the divisor. Best-effort (path a): the backend is the final authority
+ * at checkout for any sub constrained by a separate quota the mantle isn't on.
+ */
+export declare const maxQuantity_Mantle: CapacityCalculator;
+/** Each sub's TicketCombination max_persons — the ceiling when no quota gates the mantle. */
+export declare const combinationSubMaxes: (p: UIMantleTicket) => Record<number, number>;
+/**
+ * Capacity-aware ceilings for a mantle line's sub-ticket selectors, keyed by sub id.
+ *
+ * Growing a sub by one adds `quantity` seats to the line's draw (every mantle in the line gains
+ * one sub), so a sub may grow by at most ⌊spare / quantity⌋ above its CURRENT value, still
+ * bounded by its TicketCombination max_persons. `spare` is the quota headroom left after
+ * netting cart + preCart INCLUDING the sized line's own draw — unlike line sizing, nothing is
+ * credited back, because a mix edit spends seats on top of what the line already holds.
+ * Shrinking is never capacity-gated; min_persons stays the selector's floor.
+ */
+export declare function maxSubQuantities(manager: CapacityManager, cart: Cart, item: CartItem, preCart: Cart): Record<number, number>;

package/dist-js/src/lib/models/capacity/calculators/mantle.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-js/src/lib/models/capacity/calculators/quotaManager/QuotaManager.d.ts

@@ -24,6 +24,7 @@ export declare function createQuotaManager(quotas: Quotas): {
     precart: Record<string, number>;
     clearPrecart(): void;
     setPrecartItemQuantity(ticketId: number, quantity: number): void;
+    addPrecartItemQuantity(ticketId: number, quantity: number): void;
     getPrecartItemQuantity(ticketId: number): number;
     /**
      * a flat list of all timeslots and their capacities, respecting preCart.
@@ -50,7 +51,7 @@ export declare function createQuotaManager(quotas: Quotas): {
         capacity: number;
         totalCapacity: number;
     }[];
-    ticketCapacity(ticketId: number, timeslot: string): number;
+    ticketCapacity(ticketId: number, timeslot: string, ownQuantity?: any): number;
     totalCapacity(ticketId: number, timeslot: string): number;
     timeslotsOn(date: CalendarDate, ticketIds?: number[]): {
         timeSlot: string;

package/dist-js/src/lib/models/capacity/calculators/quotas.d.ts

@@ -1,2 +1,25 @@
 import { CapacityCalculator } from '../../../../../lib/models/capacity/types.ts';
+import { Cart } from '../../../../../lib/models/cart/cart.svelte.ts';
+import { CartItem } from '../../../../../lib/models/cart/types.ts';
+import { QuotaManager } from '../../../../../lib/models/capacity/calculators/quotaManager/QuotaManager.ts';
+/** Σ of a mantle's chosen sub-ticket quantities (the capacity one mantle draws); 0 otherwise. */
+export declare const compositionSum: (item: CartItem) => number;
+/**
+ * Quota capacity one cart item draws — the single source of truth shared by every quota-based
+ * calculator (a verbatim parallel to the Angular shop's `getNeededCapacityForTicket`).
+ *
+ * A mantle draws `qty × Σ(composition)` capacity off its quota; everything else draws `qty`.
+ * Used both to net items out when sizing OTHER tickets on the same quota and as the basis for a
+ * mantle's own count.
+ */
+export declare function neededCapacity(item: CartItem): number;
+/**
+ * Feed cart + preCart into the quota precart as *needed capacity*, so every item sharing a quota is
+ * netted out before sizing `item`. `addPrecartItemQuantity` SUMS draws per id, so two lines of the
+ * same ticket id (e.g. two mantle lines with different mixes) both count instead of the last
+ * overwriting the rest. Returns the draw of the line being sized — captured by reference — so the
+ * caller credits back only its OWN draw via `ticketCapacity(..., ownDraw)`, never a sibling
+ * same-id line's (which must keep consuming, or the two oversell).
+ */
+export declare function feedQuotaPrecart(quotaManager: QuotaManager, cart: Cart, preCart: Cart, item: CartItem): number;
 export declare const maxQuantity_Quotas: CapacityCalculator;

package/dist-js/src/lib/models/cart/CartItem.d.ts

@@ -1,7 +1,19 @@
 import { Product } from '../../../../lib/models/cart/types.ts';
+export declare function _resetMantleKeyForTests(): void;
 interface Options {
     quantity?: number;
     time?: string;
+    /**
+     * Mantelticket only — grouped like `display`. `composition` is the chosen, editable mix
+     * (sub-ticket id → quantity), serialized to the order API as `sub_ticket_quantities`. `key`
+     * is a unique id FROZEN at creation: the line's stable identity (subUId). Every mantle add
+     * gets its own key, so mantles NEVER merge — each is a separate cart line — and editing the
+     * mix later never changes the uuid.
+     */
+    mantle?: {
+        composition: Record<number, number>;
+        key?: string;
+    };
     display: {
         discounted: boolean;
         reference_uuid: string;
@@ -15,16 +27,19 @@ export declare function createCartItem(product: Product, options?: Partial<Optio
      * is passed to the Order API
      */
     orderAttributes(): {
+        sub_ticket_quantities?: Record<number, number> | undefined;
         time: string | undefined;
         quantity: number | undefined;
         shipped_with_merchandise_id: null;
         shipping_mode: string;
         id: number;
+        uuid: string;
     } | {
         quantity: number | undefined;
         shipped_with_merchandise_id: null;
         shipping_mode: string;
         id: number;
+        uuid: string;
     } | {
         quantities: {
             [product.scale_price_id]: number | undefined;
@@ -32,6 +47,7 @@ export declare function createCartItem(product: Product, options?: Partial<Optio
         shipped_with_merchandise_id: null;
         shipping_mode: string;
         id: number;
+        uuid: string;
     };
     uuid: string;
     subUId: string;
@@ -43,7 +59,19 @@ export declare function createCartItem(product: Product, options?: Partial<Optio
     total_price_cents: number;
     total_price_formatted: string;
     quantity?: number | undefined;
-    time?: string | undefined;
+    time?: string
+    /**
+     * Mantelticket only — grouped like `display`. `composition` is the chosen, editable mix
+     * (sub-ticket id → quantity), serialized to the order API as `sub_ticket_quantities`. `key`
+     * is a unique id FROZEN at creation: the line's stable identity (subUId). Every mantle add
+     * gets its own key, so mantles NEVER merge — each is a separate cart line — and editing the
+     * mix later never changes the uuid.
+     */
+     | undefined;
+    mantle?: {
+        composition: Record<number, number>;
+        key?: string;
+    } | undefined;
     display?: {
         discounted: boolean;
         reference_uuid: string;