@thorprovider/blocks 4.1.0 → 4.3.0

package/dist/blocks/designs/order-history/contracts.d.ts

@@ -0,0 +1,295 @@
+import type { ReactNode } from 'react';
+export type Tone = 'neutral' | 'info' | 'success' | 'warning' | 'danger';
+/** Integer minor units. Formatting belongs to the view or the host. */
+export type Money = {
+    amount: number;
+    currency: string;
+};
+export type QuickFilterId = 'all' | 'in-progress' | 'completed' | 'cancelled' | 'attention';
+export declare const QUICK_FILTERS: QuickFilterId[];
+export type SortId = 'newest' | 'oldest' | 'total-desc' | 'total-asc' | 'updated';
+export declare const SORT_IDS: SortId[];
+export type DatePreset = 'today' | '7d' | '30d' | '90d' | 'year' | 'custom';
+export declare const DATE_PRESETS: DatePreset[];
+export type Presentation = 'cards' | 'table';
+export type CommercialStatus = 'pending' | 'processing' | 'completed' | 'cancelled';
+/** `requires-action` is a filter-only pseudo-value derived from attention. */
+export type CommercialFilter = CommercialStatus | 'requires-action';
+export type PaymentStatus = 'unpaid' | 'authorized' | 'partially_paid' | 'paid';
+export type RefundStatus = 'none' | 'partial' | 'full';
+export type FulfilmentStatus = 'unfulfilled' | 'preparing' | 'shipped' | 'partially_delivered' | 'delivered' | 'delayed' | 'ready_for_pickup';
+export type DeliveryMode = 'shipping' | 'pickup' | 'mixed';
+export type ShipmentMode = 'shipping' | 'pickup';
+export type ReturnStatus = 'none' | 'requested' | 'in_progress' | 'completed';
+export type InvoiceStatus = 'not_issued' | 'pending' | 'issued' | 'overdue';
+export type AttentionReason = 'payment-due' | 'delivery-delayed' | 'pickup-ready' | 'approval-pending';
+/** What a cancelled order can still say about money. Never contradicts it. */
+export type CancelledSummaryId = 'refunded' | 'partially-refunded' | 'refund-pending' | 'not-charged';
+/** Buyer-facing status. The dimensions above are never overwritten. */
+export type PresentationStatusId = 'pending' | 'preparing' | 'shipped' | 'delivered' | 'completed' | 'cancelled' | 'partially-delivered' | 'ready-for-pickup' | 'delayed' | 'refunded' | 'partially-refunded' | 'attention';
+export type OrderActionId = 'view' | 'track' | 'reorder' | 'invoice' | 'return' | 'exchange' | 'problem' | 'cancel' | 'pay-balance' | 'support';
+export declare const ORDER_ACTIONS: OrderActionId[];
+export type BulkActionId = 'export' | 'documents';
+export type TableColumnId = 'selection' | 'order' | 'date' | 'buyer' | 'company' | 'purchaseOrder' | 'items' | 'status' | 'payment' | 'fulfilment' | 'total' | 'actions';
+export declare const ALL_COLUMNS: TableColumnId[];
+export declare const DEFAULT_COLUMNS: TableColumnId[];
+export declare const DEFAULT_B2B_COLUMNS: TableColumnId[];
+export type OrderItem = {
+    id: string;
+    name: string;
+    sku: string;
+    variant?: string;
+    quantity: number;
+    /** Optional product image. Without it the view renders a labelled monogram. */
+    image?: string;
+};
+export type ShipmentSummary = {
+    id: string;
+    mode: ShipmentMode;
+    status: FulfilmentStatus;
+    itemCount: number;
+    etaLabel?: string;
+};
+export type OrderBusiness = {
+    company: string;
+    buyer: string;
+    branch?: string;
+    purchaseOrder?: string;
+    costCenter?: string;
+    invoiceStatus?: InvoiceStatus;
+    paymentTerms?: string;
+    approvalPending?: boolean;
+};
+/**
+ * Normalised presentation model. `id` is the backend identity and is never
+ * rendered; `number` is the buyer-facing reference.
+ */
+export type OrderRecord = {
+    id: string;
+    number: string;
+    placedAt: string;
+    updatedAt: string;
+    total: Money;
+    items: OrderItem[];
+    itemCount: number;
+    commercial: CommercialStatus;
+    payment: {
+        status: PaymentStatus;
+        due?: Money;
+        creditTerms: boolean;
+    };
+    refund: RefundStatus;
+    fulfilment: {
+        status: FulfilmentStatus;
+        shipments: ShipmentSummary[];
+    };
+    deliveryMode: DeliveryMode;
+    returns: ReturnStatus;
+    /** A partial cancellation keeps its commercial status and is shown as a note. */
+    partiallyCancelled?: boolean;
+    externalReference?: string;
+    b2b?: OrderBusiness;
+    /** Backend-authorised actions for this order. The view intersects with capabilities. */
+    availableActions: OrderActionId[];
+};
+export type OrderHistoryCapability = 'tableView' | 'shipmentTracking' | 'pickupTracking' | 'returns' | 'exchanges' | 'claims' | 'reorder' | 'invoices' | 'bulkSelection' | 'export' | 'companyOrders' | 'purchaseOrders' | 'paymentTerms' | 'approvals';
+export type OrderHistoryCapabilities = Partial<Record<OrderHistoryCapability, boolean>>;
+export type FilterSelection = {
+    commercial?: CommercialFilter[];
+    payment?: PaymentStatus[];
+    refund?: RefundStatus[];
+    fulfilment?: FulfilmentStatus[];
+    mode?: DeliveryMode[];
+    returns?: ReturnStatus[];
+    invoiceStatus?: InvoiceStatus[];
+    paymentTerms?: string[];
+    company?: string[];
+    buyer?: string[];
+    branch?: string[];
+    products?: string;
+    purchaseOrder?: string;
+    costCenter?: string;
+};
+export type OrdersQuery = {
+    search: string;
+    quick: QuickFilterId;
+    filters: FilterSelection;
+    date?: {
+        preset: DatePreset;
+        from?: string;
+        to?: string;
+    };
+    amount?: {
+        min?: number;
+        max?: number;
+        currency: string;
+    };
+    sort: SortId;
+    page: number;
+    pageSize: number;
+};
+export type OrdersPage = {
+    items: OrderRecord[];
+    /** Matching the full query, quick filter included. */
+    total: number;
+    /** Authorised orders with search and filters cleared. */
+    totalAll: number;
+    pageCount: number;
+    counts?: Record<QuickFilterId, number>;
+    /** Partial failure: the results are still valid. */
+    warning?: boolean;
+};
+export type OrdersDataSource = {
+    list(query: OrdersQuery, options?: {
+        signal?: AbortSignal;
+    }): Promise<OrdersPage>;
+};
+export type BulkSelection = {
+    kind: 'orders';
+    ids: string[];
+    count: number;
+} | {
+    kind: 'query';
+    query: OrdersQuery;
+    count: number;
+};
+export type Scenario = {
+    id: string;
+    name: string;
+    blurb: string;
+    /** Order ids this scenario exposes. Omitted means the whole dataset. */
+    orderIds?: string[];
+    capabilities?: OrderHistoryCapabilities;
+    mode?: 'b2c' | 'b2b';
+    presentation?: Presentation;
+    latencyMs?: number;
+    fail?: boolean;
+    partial?: boolean;
+};
+export type DateBounds = {
+    from: number;
+    to: number;
+};
+export type StatusResolution = {
+    status: PresentationStatusId;
+    tone: Tone;
+};
+export type OrderHistoryLabels = {
+    header: {
+        title: string;
+        description: string;
+        searchLabel: string;
+        searchPlaceholder: string;
+        clearSearch: string;
+        quickFilters: string;
+        clearList: string;
+        sortLabel: string;
+        sort: Record<SortId, string>;
+        viewCards: string;
+        viewTable: string;
+        results: string;
+        resultsOne: string;
+        updating: string;
+        columns: string;
+    };
+    quick: Record<QuickFilterId, string>;
+    status: Record<PresentationStatusId, string>;
+    payment: Record<PaymentStatus, string>;
+    refund: Record<RefundStatus, string>;
+    returns: Record<ReturnStatus, string>;
+    fulfilment: Record<FulfilmentStatus, string>;
+    mode: Record<DeliveryMode, string>;
+    invoiceStatus: Record<InvoiceStatus, string>;
+    card: {
+        order: string;
+        items: string;
+        itemsOne: string;
+        total: string;
+        viewOrder: string;
+        moreActions: string;
+        deliveries: string;
+        readyForPickup: string;
+        itemImage: string;
+        moreItems: string;
+        amountUnavailable: string;
+        partiallyCancelled: string;
+        refundPending: string;
+        notCharged: string;
+    };
+    actions: Record<OrderActionId, string>;
+    bulk: {
+        selected: string;
+        selectAll: string;
+        clear: string;
+        export: string;
+        documents: string;
+    };
+    pagination: {
+        previous: string;
+        next: string;
+        pageOf: string;
+        range: string;
+        pageSize: string;
+    };
+    states: {
+        loading: string;
+        emptyTitle: string;
+        emptyBody: string;
+        noResultsTitle: string;
+        noResultsBody: string;
+        errorTitle: string;
+        errorBody: string;
+        retry: string;
+        partial: string;
+        forbiddenTitle: string;
+        forbiddenBody: string;
+    };
+    table: {
+        caption: string;
+        columns: Record<TableColumnId, string>;
+        sortBy: string;
+    };
+    demo: {
+        title: string;
+        hint: string;
+        scenario: string;
+        mode: string;
+        modeB2c: string;
+        modeB2b: string;
+        capabilities: string;
+        callback: string;
+        noCallback: string;
+        note: string;
+        capabilityLabels: Record<OrderHistoryCapability, string>;
+    };
+};
+export type OrderHistoryProps = {
+    mode: 'b2c' | 'b2b';
+    capabilities: OrderHistoryCapabilities;
+    dataSource: OrdersDataSource;
+    labels: OrderHistoryLabels;
+    locale?: string;
+    formatMoney?: (money: Money) => string;
+    formatDate?: (iso: string) => string;
+    /** Starting view. The surface owns the live switch. */
+    presentation?: Presentation;
+    columns?: TableColumnId[];
+    sortOptions?: SortId[];
+    title?: string;
+    description?: string;
+    breadcrumbs?: ReactNode;
+    headerActions?: ReactNode;
+    pageSize?: number;
+    access?: 'allowed' | 'forbidden';
+    initialQuery?: Partial<OrdersQuery>;
+    onQueryChange?: (query: OrdersQuery) => void;
+    onPresentationChange?: (presentation: Presentation) => void;
+    onOrderSelect?: (orderId: string) => void;
+    /** The selected record, so a host can render its detail without a second read. */
+    onOrderSelectRecord?: (order: OrderRecord) => void;
+    onOrderAction?: (action: OrderActionId, order: OrderRecord) => void;
+    onBulkAction?: (action: BulkActionId, selection: BulkSelection) => void;
+};
+export declare const DEFAULT_PAGE_SIZE = 10;
+export declare const PAGE_SIZES: number[];
+//# sourceMappingURL=contracts.d.ts.map

package/dist/blocks/designs/order-history/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../src/blocks/designs/order-history/contracts.ts"],"names":[],"mappings":"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"}

package/dist/blocks/designs/order-history/contracts.js

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var contracts_exports = {};
+__export(contracts_exports, {
+  ALL_COLUMNS: () => ALL_COLUMNS,
+  DATE_PRESETS: () => DATE_PRESETS,
+  DEFAULT_B2B_COLUMNS: () => DEFAULT_B2B_COLUMNS,
+  DEFAULT_COLUMNS: () => DEFAULT_COLUMNS,
+  DEFAULT_PAGE_SIZE: () => DEFAULT_PAGE_SIZE,
+  ORDER_ACTIONS: () => ORDER_ACTIONS,
+  PAGE_SIZES: () => PAGE_SIZES,
+  QUICK_FILTERS: () => QUICK_FILTERS,
+  SORT_IDS: () => SORT_IDS
+});
+module.exports = __toCommonJS(contracts_exports);
+const QUICK_FILTERS = [
+  "all",
+  "in-progress",
+  "completed",
+  "cancelled",
+  "attention"
+];
+const SORT_IDS = ["newest", "oldest", "total-desc", "total-asc", "updated"];
+const DATE_PRESETS = ["today", "7d", "30d", "90d", "year", "custom"];
+const ORDER_ACTIONS = [
+  "view",
+  "track",
+  "reorder",
+  "invoice",
+  "return",
+  "exchange",
+  "problem",
+  "cancel",
+  "pay-balance",
+  "support"
+];
+const ALL_COLUMNS = [
+  "selection",
+  "order",
+  "date",
+  "buyer",
+  "company",
+  "purchaseOrder",
+  "items",
+  "status",
+  "payment",
+  "fulfilment",
+  "total",
+  "actions"
+];
+const DEFAULT_COLUMNS = [
+  "selection",
+  "order",
+  "date",
+  "status",
+  "fulfilment",
+  "total",
+  "actions"
+];
+const DEFAULT_B2B_COLUMNS = [
+  "selection",
+  "order",
+  "date",
+  "buyer",
+  "company",
+  "purchaseOrder",
+  "status",
+  "fulfilment",
+  "total",
+  "actions"
+];
+const DEFAULT_PAGE_SIZE = 10;
+const PAGE_SIZES = [10, 20, 50];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ALL_COLUMNS,
+  DATE_PRESETS,
+  DEFAULT_B2B_COLUMNS,
+  DEFAULT_COLUMNS,
+  DEFAULT_PAGE_SIZE,
+  ORDER_ACTIONS,
+  PAGE_SIZES,
+  QUICK_FILTERS,
+  SORT_IDS
+});
+//# sourceMappingURL=contracts.js.map

package/dist/blocks/designs/order-history/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/order-history/contracts.ts"],"sourcesContent":["// Contracts shared by the order-history surface. Shapes, ids and constants only:\n// no data, no behaviour, no transport. Every component consumes these through\n// props, and the demo composition is the only reader of `data.ts`.\n\nimport type { ReactNode } from 'react'\n\nexport type Tone = 'neutral' | 'info' | 'success' | 'warning' | 'danger'\n\n/** Integer minor units. Formatting belongs to the view or the host. */\nexport type Money = { amount: number; currency: string }\n\nexport type QuickFilterId = 'all' | 'in-progress' | 'completed' | 'cancelled' | 'attention'\n\nexport const QUICK_FILTERS: QuickFilterId[] = [\n  'all',\n  'in-progress',\n  'completed',\n  'cancelled',\n  'attention',\n]\n\nexport type SortId = 'newest' | 'oldest' | 'total-desc' | 'total-asc' | 'updated'\n\nexport const SORT_IDS: SortId[] = ['newest', 'oldest', 'total-desc', 'total-asc', 'updated']\n\nexport type DatePreset = 'today' | '7d' | '30d' | '90d' | 'year' | 'custom'\n\nexport const DATE_PRESETS: DatePreset[] = ['today', '7d', '30d', '90d', 'year', 'custom']\n\nexport type Presentation = 'cards' | 'table'\n\nexport type CommercialStatus = 'pending' | 'processing' | 'completed' | 'cancelled'\n/** `requires-action` is a filter-only pseudo-value derived from attention. */\nexport type CommercialFilter = CommercialStatus | 'requires-action'\nexport type PaymentStatus = 'unpaid' | 'authorized' | 'partially_paid' | 'paid'\nexport type RefundStatus = 'none' | 'partial' | 'full'\nexport type FulfilmentStatus =\n  | 'unfulfilled'\n  | 'preparing'\n  | 'shipped'\n  | 'partially_delivered'\n  | 'delivered'\n  | 'delayed'\n  | 'ready_for_pickup'\nexport type DeliveryMode = 'shipping' | 'pickup' | 'mixed'\nexport type ShipmentMode = 'shipping' | 'pickup'\nexport type ReturnStatus = 'none' | 'requested' | 'in_progress' | 'completed'\nexport type InvoiceStatus = 'not_issued' | 'pending' | 'issued' | 'overdue'\n\nexport type AttentionReason =\n  | 'payment-due'\n  | 'delivery-delayed'\n  | 'pickup-ready'\n  | 'approval-pending'\n\n/** What a cancelled order can still say about money. Never contradicts it. */\nexport type CancelledSummaryId =\n  | 'refunded'\n  | 'partially-refunded'\n  | 'refund-pending'\n  | 'not-charged'\n\n/** Buyer-facing status. The dimensions above are never overwritten. */\nexport type PresentationStatusId =\n  | 'pending'\n  | 'preparing'\n  | 'shipped'\n  | 'delivered'\n  | 'completed'\n  | 'cancelled'\n  | 'partially-delivered'\n  | 'ready-for-pickup'\n  | 'delayed'\n  | 'refunded'\n  | 'partially-refunded'\n  | 'attention'\n\nexport type OrderActionId =\n  | 'view'\n  | 'track'\n  | 'reorder'\n  | 'invoice'\n  | 'return'\n  | 'exchange'\n  | 'problem'\n  | 'cancel'\n  | 'pay-balance'\n  | 'support'\n\nexport const ORDER_ACTIONS: OrderActionId[] = [\n  'view',\n  'track',\n  'reorder',\n  'invoice',\n  'return',\n  'exchange',\n  'problem',\n  'cancel',\n  'pay-balance',\n  'support',\n]\n\nexport type BulkActionId = 'export' | 'documents'\n\nexport type TableColumnId =\n  | 'selection'\n  | 'order'\n  | 'date'\n  | 'buyer'\n  | 'company'\n  | 'purchaseOrder'\n  | 'items'\n  | 'status'\n  | 'payment'\n  | 'fulfilment'\n  | 'total'\n  | 'actions'\n\nexport const ALL_COLUMNS: TableColumnId[] = [\n  'selection',\n  'order',\n  'date',\n  'buyer',\n  'company',\n  'purchaseOrder',\n  'items',\n  'status',\n  'payment',\n  'fulfilment',\n  'total',\n  'actions',\n]\n\nexport const DEFAULT_COLUMNS: TableColumnId[] = [\n  'selection',\n  'order',\n  'date',\n  'status',\n  'fulfilment',\n  'total',\n  'actions',\n]\n\nexport const DEFAULT_B2B_COLUMNS: TableColumnId[] = [\n  'selection',\n  'order',\n  'date',\n  'buyer',\n  'company',\n  'purchaseOrder',\n  'status',\n  'fulfilment',\n  'total',\n  'actions',\n]\n\nexport type OrderItem = {\n  id: string\n  name: string\n  sku: string\n  variant?: string\n  quantity: number\n  /** Optional product image. Without it the view renders a labelled monogram. */\n  image?: string\n}\n\nexport type ShipmentSummary = {\n  id: string\n  mode: ShipmentMode\n  status: FulfilmentStatus\n  itemCount: number\n  etaLabel?: string\n}\n\nexport type OrderBusiness = {\n  company: string\n  buyer: string\n  branch?: string\n  purchaseOrder?: string\n  costCenter?: string\n  invoiceStatus?: InvoiceStatus\n  paymentTerms?: string\n  approvalPending?: boolean\n}\n\n/**\n * Normalised presentation model. `id` is the backend identity and is never\n * rendered; `number` is the buyer-facing reference.\n */\nexport type OrderRecord = {\n  id: string\n  number: string\n  placedAt: string\n  updatedAt: string\n  total: Money\n  items: OrderItem[]\n  itemCount: number\n  commercial: CommercialStatus\n  payment: { status: PaymentStatus; due?: Money; creditTerms: boolean }\n  refund: RefundStatus\n  fulfilment: { status: FulfilmentStatus; shipments: ShipmentSummary[] }\n  deliveryMode: DeliveryMode\n  returns: ReturnStatus\n  /** A partial cancellation keeps its commercial status and is shown as a note. */\n  partiallyCancelled?: boolean\n  externalReference?: string\n  b2b?: OrderBusiness\n  /** Backend-authorised actions for this order. The view intersects with capabilities. */\n  availableActions: OrderActionId[]\n}\n\nexport type OrderHistoryCapability =\n  | 'tableView'\n  | 'shipmentTracking'\n  | 'pickupTracking'\n  | 'returns'\n  | 'exchanges'\n  | 'claims'\n  | 'reorder'\n  | 'invoices'\n  | 'bulkSelection'\n  | 'export'\n  | 'companyOrders'\n  | 'purchaseOrders'\n  | 'paymentTerms'\n  | 'approvals'\n\nexport type OrderHistoryCapabilities = Partial<Record<OrderHistoryCapability, boolean>>\n\nexport type FilterSelection = {\n  commercial?: CommercialFilter[]\n  payment?: PaymentStatus[]\n  refund?: RefundStatus[]\n  fulfilment?: FulfilmentStatus[]\n  mode?: DeliveryMode[]\n  returns?: ReturnStatus[]\n  invoiceStatus?: InvoiceStatus[]\n  paymentTerms?: string[]\n  company?: string[]\n  buyer?: string[]\n  branch?: string[]\n  products?: string\n  purchaseOrder?: string\n  costCenter?: string\n}\n\nexport type OrdersQuery = {\n  search: string\n  quick: QuickFilterId\n  filters: FilterSelection\n  date?: { preset: DatePreset; from?: string; to?: string }\n  amount?: { min?: number; max?: number; currency: string }\n  sort: SortId\n  page: number\n  pageSize: number\n}\n\nexport type OrdersPage = {\n  items: OrderRecord[]\n  /** Matching the full query, quick filter included. */\n  total: number\n  /** Authorised orders with search and filters cleared. */\n  totalAll: number\n  pageCount: number\n  counts?: Record<QuickFilterId, number>\n  /** Partial failure: the results are still valid. */\n  warning?: boolean\n}\n\nexport type OrdersDataSource = {\n  list(query: OrdersQuery, options?: { signal?: AbortSignal }): Promise<OrdersPage>\n}\n\nexport type BulkSelection =\n  | { kind: 'orders'; ids: string[]; count: number }\n  | { kind: 'query'; query: OrdersQuery; count: number }\n\nexport type Scenario = {\n  id: string\n  name: string\n  blurb: string\n  /** Order ids this scenario exposes. Omitted means the whole dataset. */\n  orderIds?: string[]\n  capabilities?: OrderHistoryCapabilities\n  mode?: 'b2c' | 'b2b'\n  presentation?: Presentation\n  latencyMs?: number\n  fail?: boolean\n  partial?: boolean\n}\n\nexport type DateBounds = { from: number; to: number }\n\nexport type StatusResolution = {\n  status: PresentationStatusId\n  tone: Tone\n}\n\nexport type OrderHistoryLabels = {\n  header: {\n    title: string\n    description: string\n    searchLabel: string\n    searchPlaceholder: string\n    clearSearch: string\n    quickFilters: string\n    clearList: string\n    sortLabel: string\n    sort: Record<SortId, string>\n    viewCards: string\n    viewTable: string\n    results: string\n    resultsOne: string\n    updating: string\n    columns: string\n  }\n  quick: Record<QuickFilterId, string>\n  status: Record<PresentationStatusId, string>\n  payment: Record<PaymentStatus, string>\n  refund: Record<RefundStatus, string>\n  returns: Record<ReturnStatus, string>\n  fulfilment: Record<FulfilmentStatus, string>\n  mode: Record<DeliveryMode, string>\n  invoiceStatus: Record<InvoiceStatus, string>\n  card: {\n    order: string\n    items: string\n    itemsOne: string\n    total: string\n    viewOrder: string\n    moreActions: string\n    deliveries: string\n    readyForPickup: string\n    itemImage: string\n    moreItems: string\n    amountUnavailable: string\n    partiallyCancelled: string\n    refundPending: string\n    notCharged: string\n  }\n  actions: Record<OrderActionId, string>\n  bulk: {\n    selected: string\n    selectAll: string\n    clear: string\n    export: string\n    documents: string\n  }\n  pagination: {\n    previous: string\n    next: string\n    pageOf: string\n    range: string\n    pageSize: string\n  }\n  states: {\n    loading: string\n    emptyTitle: string\n    emptyBody: string\n    noResultsTitle: string\n    noResultsBody: string\n    errorTitle: string\n    errorBody: string\n    retry: string\n    partial: string\n    forbiddenTitle: string\n    forbiddenBody: string\n  }\n  table: {\n    caption: string\n    columns: Record<TableColumnId, string>\n    sortBy: string\n  }\n  demo: {\n    title: string\n    hint: string\n    scenario: string\n    mode: string\n    modeB2c: string\n    modeB2b: string\n    capabilities: string\n    callback: string\n    noCallback: string\n    note: string\n    capabilityLabels: Record<OrderHistoryCapability, string>\n  }\n}\n\nexport type OrderHistoryProps = {\n  mode: 'b2c' | 'b2b'\n  capabilities: OrderHistoryCapabilities\n  dataSource: OrdersDataSource\n  labels: OrderHistoryLabels\n  locale?: string\n  formatMoney?: (money: Money) => string\n  formatDate?: (iso: string) => string\n  /** Starting view. The surface owns the live switch. */\n  presentation?: Presentation\n  columns?: TableColumnId[]\n  sortOptions?: SortId[]\n  title?: string\n  description?: string\n  breadcrumbs?: ReactNode\n  headerActions?: ReactNode\n  pageSize?: number\n  access?: 'allowed' | 'forbidden'\n  initialQuery?: Partial<OrdersQuery>\n  onQueryChange?: (query: OrdersQuery) => void\n  onPresentationChange?: (presentation: Presentation) => void\n  onOrderSelect?: (orderId: string) => void\n  /** The selected record, so a host can render its detail without a second read. */\n  onOrderSelectRecord?: (order: OrderRecord) => void\n  onOrderAction?: (action: OrderActionId, order: OrderRecord) => void\n  onBulkAction?: (action: BulkActionId, selection: BulkSelection) => void\n}\n\nexport const DEFAULT_PAGE_SIZE = 10\nexport const PAGE_SIZES = [10, 20, 50]\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,gBAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,WAAqB,CAAC,UAAU,UAAU,cAAc,aAAa,SAAS;AAIpF,MAAM,eAA6B,CAAC,SAAS,MAAM,OAAO,OAAO,QAAQ,QAAQ;AA8DjF,MAAM,gBAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAkBO,MAAM,cAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,kBAAmC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,sBAAuC;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAsQO,MAAM,oBAAoB;AAC1B,MAAM,aAAa,CAAC,IAAI,IAAI,EAAE;","names":[]}

package/dist/blocks/designs/order-history/contracts.mjs

@@ -0,0 +1,70 @@
+const QUICK_FILTERS = [
+  "all",
+  "in-progress",
+  "completed",
+  "cancelled",
+  "attention"
+];
+const SORT_IDS = ["newest", "oldest", "total-desc", "total-asc", "updated"];
+const DATE_PRESETS = ["today", "7d", "30d", "90d", "year", "custom"];
+const ORDER_ACTIONS = [
+  "view",
+  "track",
+  "reorder",
+  "invoice",
+  "return",
+  "exchange",
+  "problem",
+  "cancel",
+  "pay-balance",
+  "support"
+];
+const ALL_COLUMNS = [
+  "selection",
+  "order",
+  "date",
+  "buyer",
+  "company",
+  "purchaseOrder",
+  "items",
+  "status",
+  "payment",
+  "fulfilment",
+  "total",
+  "actions"
+];
+const DEFAULT_COLUMNS = [
+  "selection",
+  "order",
+  "date",
+  "status",
+  "fulfilment",
+  "total",
+  "actions"
+];
+const DEFAULT_B2B_COLUMNS = [
+  "selection",
+  "order",
+  "date",
+  "buyer",
+  "company",
+  "purchaseOrder",
+  "status",
+  "fulfilment",
+  "total",
+  "actions"
+];
+const DEFAULT_PAGE_SIZE = 10;
+const PAGE_SIZES = [10, 20, 50];
+export {
+  ALL_COLUMNS,
+  DATE_PRESETS,
+  DEFAULT_B2B_COLUMNS,
+  DEFAULT_COLUMNS,
+  DEFAULT_PAGE_SIZE,
+  ORDER_ACTIONS,
+  PAGE_SIZES,
+  QUICK_FILTERS,
+  SORT_IDS
+};
+//# sourceMappingURL=contracts.mjs.map

package/dist/blocks/designs/order-history/contracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/order-history/contracts.ts"],"sourcesContent":["// Contracts shared by the order-history surface. Shapes, ids and constants only:\n// no data, no behaviour, no transport. Every component consumes these through\n// props, and the demo composition is the only reader of `data.ts`.\n\nimport type { ReactNode } from 'react'\n\nexport type Tone = 'neutral' | 'info' | 'success' | 'warning' | 'danger'\n\n/** Integer minor units. Formatting belongs to the view or the host. */\nexport type Money = { amount: number; currency: string }\n\nexport type QuickFilterId = 'all' | 'in-progress' | 'completed' | 'cancelled' | 'attention'\n\nexport const QUICK_FILTERS: QuickFilterId[] = [\n  'all',\n  'in-progress',\n  'completed',\n  'cancelled',\n  'attention',\n]\n\nexport type SortId = 'newest' | 'oldest' | 'total-desc' | 'total-asc' | 'updated'\n\nexport const SORT_IDS: SortId[] = ['newest', 'oldest', 'total-desc', 'total-asc', 'updated']\n\nexport type DatePreset = 'today' | '7d' | '30d' | '90d' | 'year' | 'custom'\n\nexport const DATE_PRESETS: DatePreset[] = ['today', '7d', '30d', '90d', 'year', 'custom']\n\nexport type Presentation = 'cards' | 'table'\n\nexport type CommercialStatus = 'pending' | 'processing' | 'completed' | 'cancelled'\n/** `requires-action` is a filter-only pseudo-value derived from attention. */\nexport type CommercialFilter = CommercialStatus | 'requires-action'\nexport type PaymentStatus = 'unpaid' | 'authorized' | 'partially_paid' | 'paid'\nexport type RefundStatus = 'none' | 'partial' | 'full'\nexport type FulfilmentStatus =\n  | 'unfulfilled'\n  | 'preparing'\n  | 'shipped'\n  | 'partially_delivered'\n  | 'delivered'\n  | 'delayed'\n  | 'ready_for_pickup'\nexport type DeliveryMode = 'shipping' | 'pickup' | 'mixed'\nexport type ShipmentMode = 'shipping' | 'pickup'\nexport type ReturnStatus = 'none' | 'requested' | 'in_progress' | 'completed'\nexport type InvoiceStatus = 'not_issued' | 'pending' | 'issued' | 'overdue'\n\nexport type AttentionReason =\n  | 'payment-due'\n  | 'delivery-delayed'\n  | 'pickup-ready'\n  | 'approval-pending'\n\n/** What a cancelled order can still say about money. Never contradicts it. */\nexport type CancelledSummaryId =\n  | 'refunded'\n  | 'partially-refunded'\n  | 'refund-pending'\n  | 'not-charged'\n\n/** Buyer-facing status. The dimensions above are never overwritten. */\nexport type PresentationStatusId =\n  | 'pending'\n  | 'preparing'\n  | 'shipped'\n  | 'delivered'\n  | 'completed'\n  | 'cancelled'\n  | 'partially-delivered'\n  | 'ready-for-pickup'\n  | 'delayed'\n  | 'refunded'\n  | 'partially-refunded'\n  | 'attention'\n\nexport type OrderActionId =\n  | 'view'\n  | 'track'\n  | 'reorder'\n  | 'invoice'\n  | 'return'\n  | 'exchange'\n  | 'problem'\n  | 'cancel'\n  | 'pay-balance'\n  | 'support'\n\nexport const ORDER_ACTIONS: OrderActionId[] = [\n  'view',\n  'track',\n  'reorder',\n  'invoice',\n  'return',\n  'exchange',\n  'problem',\n  'cancel',\n  'pay-balance',\n  'support',\n]\n\nexport type BulkActionId = 'export' | 'documents'\n\nexport type TableColumnId =\n  | 'selection'\n  | 'order'\n  | 'date'\n  | 'buyer'\n  | 'company'\n  | 'purchaseOrder'\n  | 'items'\n  | 'status'\n  | 'payment'\n  | 'fulfilment'\n  | 'total'\n  | 'actions'\n\nexport const ALL_COLUMNS: TableColumnId[] = [\n  'selection',\n  'order',\n  'date',\n  'buyer',\n  'company',\n  'purchaseOrder',\n  'items',\n  'status',\n  'payment',\n  'fulfilment',\n  'total',\n  'actions',\n]\n\nexport const DEFAULT_COLUMNS: TableColumnId[] = [\n  'selection',\n  'order',\n  'date',\n  'status',\n  'fulfilment',\n  'total',\n  'actions',\n]\n\nexport const DEFAULT_B2B_COLUMNS: TableColumnId[] = [\n  'selection',\n  'order',\n  'date',\n  'buyer',\n  'company',\n  'purchaseOrder',\n  'status',\n  'fulfilment',\n  'total',\n  'actions',\n]\n\nexport type OrderItem = {\n  id: string\n  name: string\n  sku: string\n  variant?: string\n  quantity: number\n  /** Optional product image. Without it the view renders a labelled monogram. */\n  image?: string\n}\n\nexport type ShipmentSummary = {\n  id: string\n  mode: ShipmentMode\n  status: FulfilmentStatus\n  itemCount: number\n  etaLabel?: string\n}\n\nexport type OrderBusiness = {\n  company: string\n  buyer: string\n  branch?: string\n  purchaseOrder?: string\n  costCenter?: string\n  invoiceStatus?: InvoiceStatus\n  paymentTerms?: string\n  approvalPending?: boolean\n}\n\n/**\n * Normalised presentation model. `id` is the backend identity and is never\n * rendered; `number` is the buyer-facing reference.\n */\nexport type OrderRecord = {\n  id: string\n  number: string\n  placedAt: string\n  updatedAt: string\n  total: Money\n  items: OrderItem[]\n  itemCount: number\n  commercial: CommercialStatus\n  payment: { status: PaymentStatus; due?: Money; creditTerms: boolean }\n  refund: RefundStatus\n  fulfilment: { status: FulfilmentStatus; shipments: ShipmentSummary[] }\n  deliveryMode: DeliveryMode\n  returns: ReturnStatus\n  /** A partial cancellation keeps its commercial status and is shown as a note. */\n  partiallyCancelled?: boolean\n  externalReference?: string\n  b2b?: OrderBusiness\n  /** Backend-authorised actions for this order. The view intersects with capabilities. */\n  availableActions: OrderActionId[]\n}\n\nexport type OrderHistoryCapability =\n  | 'tableView'\n  | 'shipmentTracking'\n  | 'pickupTracking'\n  | 'returns'\n  | 'exchanges'\n  | 'claims'\n  | 'reorder'\n  | 'invoices'\n  | 'bulkSelection'\n  | 'export'\n  | 'companyOrders'\n  | 'purchaseOrders'\n  | 'paymentTerms'\n  | 'approvals'\n\nexport type OrderHistoryCapabilities = Partial<Record<OrderHistoryCapability, boolean>>\n\nexport type FilterSelection = {\n  commercial?: CommercialFilter[]\n  payment?: PaymentStatus[]\n  refund?: RefundStatus[]\n  fulfilment?: FulfilmentStatus[]\n  mode?: DeliveryMode[]\n  returns?: ReturnStatus[]\n  invoiceStatus?: InvoiceStatus[]\n  paymentTerms?: string[]\n  company?: string[]\n  buyer?: string[]\n  branch?: string[]\n  products?: string\n  purchaseOrder?: string\n  costCenter?: string\n}\n\nexport type OrdersQuery = {\n  search: string\n  quick: QuickFilterId\n  filters: FilterSelection\n  date?: { preset: DatePreset; from?: string; to?: string }\n  amount?: { min?: number; max?: number; currency: string }\n  sort: SortId\n  page: number\n  pageSize: number\n}\n\nexport type OrdersPage = {\n  items: OrderRecord[]\n  /** Matching the full query, quick filter included. */\n  total: number\n  /** Authorised orders with search and filters cleared. */\n  totalAll: number\n  pageCount: number\n  counts?: Record<QuickFilterId, number>\n  /** Partial failure: the results are still valid. */\n  warning?: boolean\n}\n\nexport type OrdersDataSource = {\n  list(query: OrdersQuery, options?: { signal?: AbortSignal }): Promise<OrdersPage>\n}\n\nexport type BulkSelection =\n  | { kind: 'orders'; ids: string[]; count: number }\n  | { kind: 'query'; query: OrdersQuery; count: number }\n\nexport type Scenario = {\n  id: string\n  name: string\n  blurb: string\n  /** Order ids this scenario exposes. Omitted means the whole dataset. */\n  orderIds?: string[]\n  capabilities?: OrderHistoryCapabilities\n  mode?: 'b2c' | 'b2b'\n  presentation?: Presentation\n  latencyMs?: number\n  fail?: boolean\n  partial?: boolean\n}\n\nexport type DateBounds = { from: number; to: number }\n\nexport type StatusResolution = {\n  status: PresentationStatusId\n  tone: Tone\n}\n\nexport type OrderHistoryLabels = {\n  header: {\n    title: string\n    description: string\n    searchLabel: string\n    searchPlaceholder: string\n    clearSearch: string\n    quickFilters: string\n    clearList: string\n    sortLabel: string\n    sort: Record<SortId, string>\n    viewCards: string\n    viewTable: string\n    results: string\n    resultsOne: string\n    updating: string\n    columns: string\n  }\n  quick: Record<QuickFilterId, string>\n  status: Record<PresentationStatusId, string>\n  payment: Record<PaymentStatus, string>\n  refund: Record<RefundStatus, string>\n  returns: Record<ReturnStatus, string>\n  fulfilment: Record<FulfilmentStatus, string>\n  mode: Record<DeliveryMode, string>\n  invoiceStatus: Record<InvoiceStatus, string>\n  card: {\n    order: string\n    items: string\n    itemsOne: string\n    total: string\n    viewOrder: string\n    moreActions: string\n    deliveries: string\n    readyForPickup: string\n    itemImage: string\n    moreItems: string\n    amountUnavailable: string\n    partiallyCancelled: string\n    refundPending: string\n    notCharged: string\n  }\n  actions: Record<OrderActionId, string>\n  bulk: {\n    selected: string\n    selectAll: string\n    clear: string\n    export: string\n    documents: string\n  }\n  pagination: {\n    previous: string\n    next: string\n    pageOf: string\n    range: string\n    pageSize: string\n  }\n  states: {\n    loading: string\n    emptyTitle: string\n    emptyBody: string\n    noResultsTitle: string\n    noResultsBody: string\n    errorTitle: string\n    errorBody: string\n    retry: string\n    partial: string\n    forbiddenTitle: string\n    forbiddenBody: string\n  }\n  table: {\n    caption: string\n    columns: Record<TableColumnId, string>\n    sortBy: string\n  }\n  demo: {\n    title: string\n    hint: string\n    scenario: string\n    mode: string\n    modeB2c: string\n    modeB2b: string\n    capabilities: string\n    callback: string\n    noCallback: string\n    note: string\n    capabilityLabels: Record<OrderHistoryCapability, string>\n  }\n}\n\nexport type OrderHistoryProps = {\n  mode: 'b2c' | 'b2b'\n  capabilities: OrderHistoryCapabilities\n  dataSource: OrdersDataSource\n  labels: OrderHistoryLabels\n  locale?: string\n  formatMoney?: (money: Money) => string\n  formatDate?: (iso: string) => string\n  /** Starting view. The surface owns the live switch. */\n  presentation?: Presentation\n  columns?: TableColumnId[]\n  sortOptions?: SortId[]\n  title?: string\n  description?: string\n  breadcrumbs?: ReactNode\n  headerActions?: ReactNode\n  pageSize?: number\n  access?: 'allowed' | 'forbidden'\n  initialQuery?: Partial<OrdersQuery>\n  onQueryChange?: (query: OrdersQuery) => void\n  onPresentationChange?: (presentation: Presentation) => void\n  onOrderSelect?: (orderId: string) => void\n  /** The selected record, so a host can render its detail without a second read. */\n  onOrderSelectRecord?: (order: OrderRecord) => void\n  onOrderAction?: (action: OrderActionId, order: OrderRecord) => void\n  onBulkAction?: (action: BulkActionId, selection: BulkSelection) => void\n}\n\nexport const DEFAULT_PAGE_SIZE = 10\nexport const PAGE_SIZES = [10, 20, 50]\n"],"mappings":"AAaO,MAAM,gBAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,WAAqB,CAAC,UAAU,UAAU,cAAc,aAAa,SAAS;AAIpF,MAAM,eAA6B,CAAC,SAAS,MAAM,OAAO,OAAO,QAAQ,QAAQ;AA8DjF,MAAM,gBAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAkBO,MAAM,cAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,kBAAmC;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,sBAAuC;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAsQO,MAAM,oBAAoB;AAC1B,MAAM,aAAa,CAAC,IAAI,IAAI,EAAE;","names":[]}

package/dist/blocks/designs/order-history/engine.d.ts

@@ -0,0 +1,57 @@
+import type { AttentionReason, CancelledSummaryId, DateBounds, OrderHistoryCapabilities, OrderRecord, OrdersPage, OrdersQuery, QuickFilterId, StatusResolution } from './contracts';
+/** Reasons that need the buyer to act. Cancelled orders carry none. */
+export declare function attentionReasons(order: OrderRecord): AttentionReason[];
+export declare function isAttention(order: OrderRecord): boolean;
+/**
+ * Quick filters are presentation categories, not a backend field. An order can
+ * belong to more than one category at a time.
+ */
+export declare function matchesQuickFilter(order: OrderRecord, quick: QuickFilterId): boolean;
+/**
+ * First match wins. Specific fulfilment beats generic attention; a cancellation
+ * beats everything. Refunds only claim the main status once the order is done.
+ */
+export declare function resolvePresentationStatus(order: OrderRecord): StatusResolution;
+/**
+ * A cancelled order never re-reports logistics. This is what it can still say
+ * about money, and the view shows it as the only secondary signal.
+ */
+export declare function resolveCancelledSummary(order: OrderRecord): CancelledSummaryId | null;
+/** Case- and accent-insensitive text used by search and text filters. */
+export declare function normalizeText(value: string): string;
+/** Tokenised AND search over the fields the store authorised. */
+export declare function matchesSearch(order: OrderRecord, query: OrdersQuery, capabilities: OrderHistoryCapabilities): boolean;
+/** Inclusive bounds for a preset. `custom` uses the supplied from/to. */
+export declare function resolveDateBounds(date: OrdersQuery['date'], now: string): DateBounds | null;
+/** OR inside a group, AND across groups. */
+export declare function matchesFilters(order: OrderRecord, query: OrdersQuery, now: string): boolean;
+/** Search AND filters AND the active quick category. */
+export declare function matchesOrder(order: OrderRecord, query: OrdersQuery, capabilities: OrderHistoryCapabilities, now: string): boolean;
+/**
+ * Stable sort. Amount sorts group by currency code first and compare integer
+ * minor units inside a currency: they never convert.
+ */
+export declare function sortOrders(orders: OrderRecord[], sort: OrdersQuery['sort']): OrderRecord[];
+/**
+ * Page slice. Out-of-range pages clamp to the last valid page, so a filter that
+ * shrinks the result set never leaves the surface on a blank page.
+ */
+export declare function paginate(orders: OrderRecord[], page: number, pageSize: number): {
+    items: OrderRecord[];
+    pageCount: number;
+};
+/**
+ * Counters for every quick category. They apply search and any host pre-filter
+ * but ignore the active quick filter, so the numbers never change when switching.
+ */
+export declare function computeCounts(orders: OrderRecord[], query: OrdersQuery, capabilities: OrderHistoryCapabilities, now: string): Record<QuickFilterId, number>;
+export declare function defaultQuery(pageSize?: number): OrdersQuery;
+/**
+ * The complete query pipeline behind one `OrdersPort.list` call: filter (search,
+ * filters and the active quick category), sort stably, slice the requested page
+ * and count every quick category. Pure and deterministic, so a host runner and
+ * the surface itself apply the same rules; the port cannot disagree with the
+ * controls it renders. `now` is injectable for date-preset tests.
+ */
+export declare function queryOrderHistoryPage(orders: OrderRecord[], query: OrdersQuery, capabilities?: OrderHistoryCapabilities, now?: string): OrdersPage;
+//# sourceMappingURL=engine.d.ts.map

package/dist/blocks/designs/order-history/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/blocks/designs/order-history/engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,WAAW,EACX,UAAU,EACV,WAAW,EAEX,aAAa,EACb,gBAAgB,EACjB,MAAM,aAAa,CAAA;AAGpB,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,EAAE,CAmBtE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAepF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB,CA4B9E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,kBAAkB,GAAG,IAAI,CAQrF;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnD;AAoBD,iEAAiE;AACjE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,wBAAwB,GACrC,OAAO,CAQT;AAUD,yEAAyE;AACzE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,GAAG,EAAE,MAAM,GACV,UAAU,GAAG,IAAI,CAwBnB;AAQD,4CAA4C;AAC5C,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CA+CT;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,wBAAwB,EACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAMT;AAKD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,EAAE,CA0B1F;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAM7C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,wBAAwB,EACtC,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAW/B;AAID,wBAAgB,YAAY,CAAC,QAAQ,GAAE,MAA0B,GAAG,WAAW,CAS9E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,EAClB,YAAY,GAAE,wBAA6B,EAC3C,GAAG,GAAE,MAAiC,GACrC,UAAU,CAcZ"}