@burdenoff/microfe-movethewheels 2026.1031.2 → 2026.1031.4

package/dist/generated/tracking-quality-operations.d.ts

@@ -1073,6 +1073,12 @@ export type MtwDemandForecastVariance = {
     scopeType: DemandForecastScope;
     volumeVariance: Scalars['Int']['output'];
 };
+/** Unit MoveTheWheels shows distances in. */
+export type MtwDistanceUnit = 
+/** Kilometres */
+'KM'
+/** Miles */
+ | 'MI';
 export type MtwDriver = {
     __typename?: 'MtwDriver';
     baseSalary?: Maybe<Scalars['Float']['output']>;
@@ -2034,6 +2040,63 @@ export type MtwFuelVolumeObservationInput = {
     sourceReference?: InputMaybe<Scalars['String']['input']>;
     sourceRevision?: InputMaybe<Scalars['String']['input']>;
 };
+export type MtwImportColumn = {
+    __typename?: 'MtwImportColumn';
+    allowedValues?: Maybe<Array<Scalars['String']['output']>>;
+    description: Scalars['String']['output'];
+    max?: Maybe<Scalars['Float']['output']>;
+    maxLength?: Maybe<Scalars['Int']['output']>;
+    min?: Maybe<Scalars['Float']['output']>;
+    name: Scalars['String']['output'];
+    required: Scalars['Boolean']['output'];
+    type: MtwImportColumnType;
+};
+export type MtwImportColumnType = 'BOOLEAN' | 'DATE' | 'EMAIL' | 'ENUM' | 'INTEGER' | 'JSON' | 'NUMBER' | 'STRING';
+export type MtwImportEntitySpec = {
+    __typename?: 'MtwImportEntitySpec';
+    columns: Array<MtwImportColumn>;
+    entityType: MtwImportEntityType;
+    /** Column that must be unique in the workspace, if any. */
+    keyColumn?: Maybe<Scalars['String']['output']>;
+};
+export type MtwImportEntityType = 'CARGO_ITEM' | 'CUSTOMER' | 'DRIVER' | 'VEHICLE' | 'WAREHOUSE';
+export type MtwImportFormat = 'CSV' | 'JSON';
+export type MtwImportInput = {
+    /** Import the valid rows even when other rows are invalid. */
+    allowPartial?: InputMaybe<Scalars['Boolean']['input']>;
+    /** The CSV (with a header row) or JSON (array of objects) document, at most 2 MB and 1000 rows. */
+    content: Scalars['String']['input'];
+    /** Validate every row without writing anything. */
+    dryRun?: InputMaybe<Scalars['Boolean']['input']>;
+    format: MtwImportFormat;
+};
+export type MtwImportResult = {
+    __typename?: 'MtwImportResult';
+    createdIds: Array<Scalars['ID']['output']>;
+    dryRun: Scalars['Boolean']['output'];
+    entityType: MtwImportEntityType;
+    errors: Array<MtwImportRowError>;
+    /** True when more row errors exist than are returned (the first 500 are returned). */
+    errorsTruncated: Scalars['Boolean']['output'];
+    failedRows: Scalars['Int']['output'];
+    importedRows: Scalars['Int']['output'];
+    status: MtwImportStatus;
+    totalRows: Scalars['Int']['output'];
+    validRows: Scalars['Int']['output'];
+};
+export type MtwImportRowError = {
+    __typename?: 'MtwImportRowError';
+    field?: Maybe<Scalars['String']['output']>;
+    message: Scalars['String']['output'];
+    /** 1-based data row number (the CSV header is not counted). */
+    row: Scalars['Int']['output'];
+};
+/**
+ * DRY_RUN: validated only, nothing written. COMPLETED: every row imported.
+ * PARTIAL: allowPartial was set and some rows failed. REJECTED: some rows were
+ * invalid and allowPartial was not set, so nothing was written.
+ */
+export type MtwImportStatus = 'COMPLETED' | 'DRY_RUN' | 'PARTIAL' | 'REJECTED';
 /** A recorded manual issuer review; workspace privileges do not establish professional qualifications. */
 export type MtwInspectorQualification = {
     __typename?: 'MtwInspectorQualification';
@@ -2189,6 +2252,30 @@ export type MtwMarketplaceStats = {
     providers: Scalars['Int']['output'];
     verifiedProviders: Scalars['Int']['output'];
 };
+/**
+ * Workspace operational defaults for MoveTheWheels (BOFF-10488): how amounts,
+ * distances, weights and times are shown, and what new orders start from.
+ * Company profile, notifications, two-factor authentication and integrations
+ * are platform settings and are not part of this type.
+ */
+export type MtwModuleSettings = {
+    __typename?: 'MtwModuleSettings';
+    /** ISO 4217 code amounts without their own currency are shown in. */
+    defaultCurrency: Scalars['String']['output'];
+    /** Hours from now a new order's suggested delivery time falls (1 to 720). */
+    defaultDeliveryWindowHours: Scalars['Int']['output'];
+    /** Priority a new order starts with. */
+    defaultOrderPriority: DeliveryPriority;
+    distanceUnit: MtwDistanceUnit;
+    /** False until the workspace saves its settings; the values are then the platform defaults. */
+    isCustomized: Scalars['Boolean']['output'];
+    /** IANA time zone dates and times are shown in. Null shows each viewer their own local time. */
+    timezone?: Maybe<Scalars['String']['output']>;
+    updatedAt?: Maybe<Scalars['DateTime']['output']>;
+    updatedBy?: Maybe<Scalars['ID']['output']>;
+    weightUnit: MtwWeightUnit;
+    workspaceId: Scalars['ID']['output'];
+};
 export type MtwMoveReviewSource = {
     __typename?: 'MtwMoveReviewSource';
     reference: Scalars['String']['output'];
@@ -3688,6 +3775,12 @@ export type MtwWarehouseStats = {
     avgUtilization: Scalars['Float']['output'];
     total: Scalars['Int']['output'];
 };
+/** Unit MoveTheWheels shows weights in. */
+export type MtwWeightUnit = 
+/** Kilograms */
+'KG'
+/** Pounds */
+ | 'LB';
 export type Mutation = {
     __typename?: 'Mutation';
     _empty?: Maybe<Scalars['String']['output']>;
@@ -3744,6 +3837,11 @@ export type Mutation = {
     deleteWarehouse: Scalars['Boolean']['output'];
     exportMtwEntities: MtwExportJob;
     holdMtwContainer: MtwContainerHold;
+    importMtwCargoItems: MtwImportResult;
+    importMtwCustomers: MtwImportResult;
+    importMtwDrivers: MtwImportResult;
+    importMtwVehicles: MtwImportResult;
+    importMtwWarehouses: MtwImportResult;
     openMtwContainerCycle: MtwContainerCycle;
     openMtwFreeTimeClock: MtwFreeTimeClock;
     optimizeRoute: MtwRoute;
@@ -3789,6 +3887,8 @@ export type Mutation = {
     updateDriverStatus: MtwDriver;
     updateIntegration: MtwIntegration;
     updateInventoryItem: MtwInventoryItem;
+    /** Save the workspace's MoveTheWheels operational defaults. Every field is validated. */
+    updateMtwModuleSettings: MtwModuleSettings;
     updateRoute: MtwRoute;
     updateServiceOffering: MtwServiceOffering;
     updateServiceProvider: MtwServiceProvider;
@@ -3928,6 +4028,21 @@ export type MutationExportMtwEntitiesArgs = {
 export type MutationHoldMtwContainerArgs = {
     input: HoldMtwContainerInput;
 };
+export type MutationImportMtwCargoItemsArgs = {
+    input: MtwImportInput;
+};
+export type MutationImportMtwCustomersArgs = {
+    input: MtwImportInput;
+};
+export type MutationImportMtwDriversArgs = {
+    input: MtwImportInput;
+};
+export type MutationImportMtwVehiclesArgs = {
+    input: MtwImportInput;
+};
+export type MutationImportMtwWarehousesArgs = {
+    input: MtwImportInput;
+};
 export type MutationOpenMtwContainerCycleArgs = {
     input: OpenMtwContainerCycleInput;
 };
@@ -4073,6 +4188,9 @@ export type MutationUpdateInventoryItemArgs = {
     id: Scalars['ID']['input'];
     input: UpdateInventoryItemInput;
 };
+export type MutationUpdateMtwModuleSettingsArgs = {
+    input: UpdateMtwModuleSettingsInput;
+};
 export type MutationUpdateRouteArgs = {
     id: Scalars['ID']['input'];
     input: UpdateRouteInput;
@@ -4268,6 +4386,15 @@ export type Query = {
     /** Null is not proof of no effect and never authorizes resubmission. Exact original actor/context only. */
     mtwFreightInvoiceComparisonByRequestKey?: Maybe<MtwFreightInvoiceComparison>;
     mtwFreightInvoiceComparisonPage: MtwFreightInvoiceComparisonPage;
+    /**
+     * Columns accepted by each import, for building templates and showing guidance.
+     * This is static reference metadata with no workspace data in it, so it only
+     * needs an authenticated caller; every import mutation enforces its own
+     * entity create permission.
+     */
+    mtwImportSpec: Array<MtwImportEntitySpec>;
+    /** The workspace's MoveTheWheels operational defaults; platform defaults when none were saved. */
+    mtwModuleSettings: MtwModuleSettings;
     mtwPalletGeometryPreview: MtwPalletGeometryPreview;
     mtwPickPreparation: MtwPickPreparation;
     mtwPickReview: MtwPickReview;
@@ -5205,6 +5332,19 @@ export type UpdateInventoryItemInput = {
     safetyStock?: InputMaybe<Scalars['Int']['input']>;
     unitCost?: InputMaybe<Scalars['Float']['input']>;
 };
+/**
+ * Changes to the workspace's MoveTheWheels defaults. Omitted fields keep their
+ * current value. `timezone: null` (or an empty string) clears the time zone so
+ * each viewer sees their own local time.
+ */
+export type UpdateMtwModuleSettingsInput = {
+    defaultCurrency?: InputMaybe<Scalars['String']['input']>;
+    defaultDeliveryWindowHours?: InputMaybe<Scalars['Int']['input']>;
+    defaultOrderPriority?: InputMaybe<DeliveryPriority>;
+    distanceUnit?: InputMaybe<MtwDistanceUnit>;
+    timezone?: InputMaybe<Scalars['String']['input']>;
+    weightUnit?: InputMaybe<MtwWeightUnit>;
+};
 export type UpdateRouteInput = {
     actualDistance?: InputMaybe<Scalars['Float']['input']>;
     actualDuration?: InputMaybe<Scalars['Float']['input']>;

package/dist/hooks/useEntityImport.js

@@ -0,0 +1,68 @@
+import { useMoveTheWheels as e } from "../providers/MoveTheWheelsProvider.js";
+import { executeGraphQL as t } from "../utils/graphqlClient.js";
+import { MTW_IMPORT_SPEC_QUERY as n, importEntity as r, importMutation as i } from "../utils/entityImport.js";
+import { useCallback as a, useEffect as o, useMemo as s, useState as c } from "react";
+//#region src/movethewheels/hooks/useEntityImport.ts
+function l() {
+	let { apiGatewayUrl: t, authToken: n, workspaceToken: r, workspaceId: i, tenantId: a, currentUser: o } = e();
+	return s(() => ({
+		apiGatewayUrl: t,
+		authToken: n,
+		workspaceToken: r,
+		workspaceId: i,
+		tenantId: a,
+		actorId: o?.id
+	}), [
+		t,
+		n,
+		r,
+		i,
+		a,
+		o?.id
+	]);
+}
+function u() {
+	let e = l(), [r, i] = c([]), [a, s] = c(!0), [u, d] = c(null);
+	return o(() => {
+		if (!e.workspaceId) return;
+		let r = !1;
+		return s(!0), t(e, n).then((e) => {
+			r || (i(e.mtwImportSpec), d(null));
+		}).catch((e) => {
+			r || d(e instanceof Error ? e : /* @__PURE__ */ Error("Could not load import columns"));
+		}).finally(() => {
+			r || s(!1);
+		}), () => {
+			r = !0;
+		};
+	}, [e]), {
+		specs: r,
+		isLoading: a,
+		error: u
+	};
+}
+function d() {
+	let e = l(), [n, o] = c(!1);
+	return {
+		run: a(async (n) => {
+			if (new Blob([n.content]).size > 2097152) throw Error("The file is larger than 2 MB. Split it into smaller files.");
+			let { field: a } = r(n.entityType);
+			o(!0);
+			try {
+				let r = (await t(e, i(n.entityType), { input: {
+					format: n.format,
+					content: n.content,
+					dryRun: n.dryRun,
+					allowPartial: n.allowPartial
+				} }, n.dryRun ? "RETRY_TRANSIENT" : "SINGLE_ATTEMPT"))[a];
+				if (!r) throw Error("The import returned no result");
+				return r;
+			} finally {
+				o(!1);
+			}
+		}, [e]),
+		isRunning: n
+	};
+}
+//#endregion
+export { d as useEntityImport, u as useImportSpec };

package/dist/hooks/useOrderDispatch.js

@@ -1,9 +1,9 @@
-import { useTr as e } from "../shared/hooks/useTr.js";
-import { VehicleHoldRefusal as t } from "../utils/orderVehicleHold.js";
+import { VehicleHoldRefusal as e } from "../utils/orderVehicleHold.js";
+import { useTr as t } from "../shared/hooks/useTr.js";
 import { useEffect as n, useRef as r, useState as i } from "react";
 //#region src/movethewheels/hooks/useOrderDispatch.ts
 function a(a) {
-	let o = e(), { order: s, contextKey: c, updateOrder: l, updateOrderStatus: u, refresh: d } = a, f = `movethewheels.order-dispatch.unconfirmed.v1:${c}`, [p, m] = i(() => {
+	let o = t(), { order: s, contextKey: c, updateOrder: l, updateOrderStatus: u, refresh: d } = a, f = `movethewheels.order-dispatch.unconfirmed.v1:${c}`, [p, m] = i(() => {
 		try {
 			return sessionStorage.getItem(f) !== null;
 		} catch {
@@ -28,56 +28,56 @@ function a(a) {
 		x.current = !1, S.current && g(!1);
 	};
 	return {
-		assign: async (e, n) => {
-			if (!e || !n || !s || s.vehicleId === e && s.driverId === n || !E(a.assignmentReady)) return;
+		assign: async (t, n) => {
+			if (!t || !n || !s || s.vehicleId === t && s.driverId === n || !E(a.assignmentReady)) return;
 			let r = !1;
 			try {
 				if (await l(s.id, {
-					vehicleId: e,
+					vehicleId: t,
 					driverId: n
 				}, "SINGLE_ATTEMPT"), r = !0, S.current && b({
 					orderId: s.id,
-					vehicleId: e,
+					vehicleId: t,
 					driverId: n
 				}), T(), !S.current || (!(s.vehicleId && s.driverId) && s.status === "confirmed" && (w(), await u(s.id, "assigned"), T()), !S.current)) return;
 				v(o("movethewheels.order.assignmentSaved", "Assignment saved.")), d();
-			} catch (e) {
-				if (e instanceof t && e.operation === (r ? "updateDeliveryJobStatus" : "updateDeliveryJob")) {
+			} catch (t) {
+				if (t instanceof e && t.operation === (r ? "updateDeliveryJobStatus" : "updateDeliveryJob")) {
 					try {
 						T();
 					} catch {
 						S.current && m(!0);
 					}
 					if (!S.current) return;
-					v(o(e.kind === "driver" ? r ? "movethewheels.order.driverMovementBlocked" : "movethewheels.order.driverAssignmentBlocked" : r ? "movethewheels.order.movementBlocked" : "movethewheels.order.assignmentBlocked", e.kind === "driver" ? r ? "Assignment saved. Driver eligibility blocked movement." : "Assignment blocked by driver eligibility. Choose another driver." : r ? "Assignment saved. Movement blocked." : "Assignment blocked by the recorded vehicle status. Choose another vehicle.")), d();
+					v(o(t.kind === "driver" ? r ? "movethewheels.order.driverMovementBlocked" : "movethewheels.order.driverAssignmentBlocked" : r ? "movethewheels.order.movementBlocked" : "movethewheels.order.assignmentBlocked", t.kind === "driver" ? r ? "Assignment saved. Driver eligibility blocked movement." : "Assignment blocked by driver eligibility. Choose another driver." : r ? "Assignment saved. Movement blocked." : "Assignment blocked by the recorded vehicle status. Choose another vehicle.")), d();
 				} else S.current && (m(!0), v(C(r)));
 			} finally {
 				D();
 			}
 		},
-		changeStatus: async (e) => {
+		changeStatus: async (t) => {
 			if (!(!s || [
 				"delivered",
 				"returned",
 				"cancelled",
 				"failed"
-			].includes(s.status)) && !(e === "assigned" && (!s.vehicleId || !s.driverId)) && !(!E(![
+			].includes(s.status)) && !(t === "assigned" && (!s.vehicleId || !s.driverId)) && !(!E(![
 				"assigned",
 				"picked_up",
 				"in_transit",
 				"out_for_delivery"
-			].includes(e) || a.movementReady) || !s)) try {
-				if (await u(s.id, e), T(), !S.current) return;
+			].includes(t) || a.movementReady) || !s)) try {
+				if (await u(s.id, t), T(), !S.current) return;
 				v(o("movethewheels.order.statusSaved", "Order status updated.")), d();
-			} catch (e) {
-				if (e instanceof t && e.operation === "updateDeliveryJobStatus") {
+			} catch (t) {
+				if (t instanceof e && t.operation === "updateDeliveryJobStatus") {
 					try {
 						T();
 					} catch {
 						S.current && m(!0);
 					}
 					if (!S.current) return;
-					v(o(e.kind === "driver" ? "movethewheels.order.driverStatusBlocked" : "movethewheels.order.statusBlocked", e.kind === "driver" ? "Movement blocked by driver eligibility. Choose another driver." : "Movement blocked by the recorded vehicle status. Choose another vehicle.")), d();
+					v(o(t.kind === "driver" ? "movethewheels.order.driverStatusBlocked" : "movethewheels.order.statusBlocked", t.kind === "driver" ? "Movement blocked by driver eligibility. Choose another driver." : "Movement blocked by the recorded vehicle status. Choose another vehicle.")), d();
 				} else S.current && (m(!0), v(o("movethewheels.order.statusUnknown", "Order status could not be confirmed. Further changes are blocked.")));
 			} finally {
 				D();

package/dist/movethewheels/hooks/useEntityImport.d.ts

@@ -0,0 +1,19 @@
+import { MtwImportEntitySpec, MtwImportEntityType, MtwImportFormat, MtwImportResult } from '../utils/entityImport';
+/** Column specification for every importable entity. */
+export declare function useImportSpec(): {
+    specs: MtwImportEntitySpec[];
+    isLoading: boolean;
+    error: Error | null;
+};
+export interface ImportRequest {
+    entityType: MtwImportEntityType;
+    format: MtwImportFormat;
+    content: string;
+    dryRun: boolean;
+    allowPartial: boolean;
+}
+/** Runs a validation or an import. Writes are sent once: a retry could create rows twice. */
+export declare function useEntityImport(): {
+    run: (request: ImportRequest) => Promise<MtwImportResult>;
+    isRunning: boolean;
+};

package/dist/movethewheels/pages/ImportExportPage.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Import / Export Page (BOFF-3990)
+ *
+ * Bulk data in and out of MoveTheWheels. Import validates a CSV or JSON file
+ * row by row on the server (dry run first, then import) for customers,
+ * vehicles, drivers, warehouses and products. Export starts the same
+ * `exportMtwEntities` job the list pages use and downloads the archive.
+ */
+export default function ImportExportPage(): import('react').JSX.Element;

package/dist/movethewheels/pages/SettingsPage.d.ts

@@ -0,0 +1 @@
+export default function SettingsPage(): import('react').JSX.Element;

package/dist/movethewheels/providers/ModuleSettingsProvider.d.ts

@@ -0,0 +1,17 @@
+import { FC, PropsWithChildren } from 'react';
+import { MtwModuleSettings, MtwModuleSettingsInput } from '../utils/moduleSettings';
+interface ModuleSettingsContextValue {
+    settings: MtwModuleSettings;
+    /** True once the workspace's settings were read (or the read failed). */
+    isLoaded: boolean;
+    error: Error | null;
+    save: (input: MtwModuleSettingsInput) => Promise<MtwModuleSettings>;
+    reload: () => void;
+}
+export declare const ModuleSettingsProvider: FC<PropsWithChildren>;
+/**
+ * The workspace's MoveTheWheels defaults. Outside the provider (stories,
+ * isolated component tests) it returns the platform defaults read-only.
+ */
+export declare function useModuleSettings(): ModuleSettingsContextValue;
+export {};

package/dist/movethewheels/utils/entityImport.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Entity import — client side of wspace-movethewheels-svc's bulk import (BOFF-3990).
+ *
+ * The service owns parsing and validation; this module only picks the right
+ * mutation for an entity, detects the file format, builds CSV templates from
+ * the server's column specification and shapes the result for display.
+ * Kept free of React so the contract can be unit-tested.
+ */
+export declare const MTW_IMPORT_ENTITIES: readonly [{
+    readonly entityType: "CUSTOMER";
+    readonly label: "Customers";
+    readonly noun: "customer";
+    readonly field: "importMtwCustomers";
+}, {
+    readonly entityType: "VEHICLE";
+    readonly label: "Vehicles";
+    readonly noun: "vehicle";
+    readonly field: "importMtwVehicles";
+}, {
+    readonly entityType: "DRIVER";
+    readonly label: "Drivers";
+    readonly noun: "driver";
+    readonly field: "importMtwDrivers";
+}, {
+    readonly entityType: "WAREHOUSE";
+    readonly label: "Warehouses";
+    readonly noun: "warehouse";
+    readonly field: "importMtwWarehouses";
+}, {
+    readonly entityType: "CARGO_ITEM";
+    readonly label: "Products";
+    readonly noun: "product";
+    readonly field: "importMtwCargoItems";
+}];
+export type MtwImportEntityType = (typeof MTW_IMPORT_ENTITIES)[number]['entityType'];
+export type MtwImportFormat = 'CSV' | 'JSON';
+export type MtwImportStatus = 'DRY_RUN' | 'COMPLETED' | 'PARTIAL' | 'REJECTED';
+/** Mirrors the service limits so an oversized file is refused before upload. */
+export declare const MTW_IMPORT_MAX_BYTES: number;
+export declare const MTW_IMPORT_MAX_ROWS = 1000;
+export declare function isImportEntityType(value: string | null | undefined): value is MtwImportEntityType;
+export declare function importEntity(entityType: MtwImportEntityType): {
+    readonly entityType: "CUSTOMER";
+    readonly label: "Customers";
+    readonly noun: "customer";
+    readonly field: "importMtwCustomers";
+} | {
+    readonly entityType: "VEHICLE";
+    readonly label: "Vehicles";
+    readonly noun: "vehicle";
+    readonly field: "importMtwVehicles";
+} | {
+    readonly entityType: "DRIVER";
+    readonly label: "Drivers";
+    readonly noun: "driver";
+    readonly field: "importMtwDrivers";
+} | {
+    readonly entityType: "WAREHOUSE";
+    readonly label: "Warehouses";
+    readonly noun: "warehouse";
+    readonly field: "importMtwWarehouses";
+} | {
+    readonly entityType: "CARGO_ITEM";
+    readonly label: "Products";
+    readonly noun: "product";
+    readonly field: "importMtwCargoItems";
+};
+export declare const IMPORT_MUTATIONS: Record<MtwImportEntityType, string>;
+/** The mutation document for one entity's import. */
+export declare function importMutation(entityType: MtwImportEntityType): string;
+export declare const MTW_IMPORT_SPEC_QUERY = "\n  query MtwImportSpec {\n    mtwImportSpec {\n      entityType\n      keyColumn\n      columns {\n        name\n        type\n        required\n        description\n        allowedValues\n        maxLength\n        min\n        max\n      }\n    }\n  }\n";
+export interface MtwImportColumn {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    allowedValues: string[] | null;
+    maxLength: number | null;
+    min: number | null;
+    max: number | null;
+}
+export interface MtwImportEntitySpec {
+    entityType: MtwImportEntityType;
+    keyColumn: string | null;
+    columns: MtwImportColumn[];
+}
+export interface MtwImportRowError {
+    row: number;
+    field: string | null;
+    message: string;
+}
+export interface MtwImportResult {
+    entityType: MtwImportEntityType;
+    status: MtwImportStatus;
+    dryRun: boolean;
+    totalRows: number;
+    validRows: number;
+    importedRows: number;
+    failedRows: number;
+    createdIds: string[];
+    errorsTruncated: boolean;
+    errors: MtwImportRowError[];
+}
+/** Picks the format from the file name, falling back to the MIME type. */
+export declare function detectImportFormat(fileName: string, mimeType?: string): MtwImportFormat | null;
+/** A CSV template: the header row, required columns first, then optional ones. */
+export declare function buildCsvTemplate(spec: MtwImportEntitySpec): string;
+/** One-line summary of an import result for the status banner. */
+export declare function summariseImport(result: MtwImportResult, noun: string): string;

package/dist/movethewheels/utils/formatters.d.ts

@@ -1,10 +1,28 @@
 import { Address } from '../types';
+/**
+ * Workspace display preferences (BOFF-10488). The module settings provider
+ * applies the workspace's saved MoveTheWheels defaults here once they load,
+ * so every formatter below honours them without each call site passing them.
+ * Until then the platform defaults apply.
+ */
+export interface FormatPreferences {
+    /** ISO 4217 code for amounts that carry no currency of their own. */
+    currency: string;
+    distanceUnit: 'KM' | 'MI';
+    weightUnit: 'KG' | 'LB';
+    /** IANA zone; null formats in the viewer's own local time. */
+    timeZone: string | null;
+}
+export declare const DEFAULT_FORMAT_PREFERENCES: Readonly<FormatPreferences>;
+export declare function setFormatPreferences(next: FormatPreferences): void;
+export declare function getFormatPreferences(): Readonly<FormatPreferences>;
 /**
  * Format an address object into a readable string.
  */
 export declare function formatAddress(address: Partial<Address>): string;
 /**
- * Format a number as currency.
+ * Format a number as currency. Amounts without their own currency use the
+ * workspace default currency.
  */
 export declare function formatCurrency(amount: number, currency?: string): string;
 /**
@@ -34,11 +52,13 @@ export declare function formatNumber(num: number): string;
  */
 export declare function formatPercentage(value: number, decimals?: number): string;
 /**
- * Format weight with appropriate units.
+ * Format a weight given in kilograms, in the workspace weight unit: kg (and
+ * tonnes from 1,000 kg) or lb.
  */
 export declare function formatWeight(kg: number): string;
 /**
- * Format distance with appropriate units.
+ * Format a distance given in kilometres, in the workspace distance unit: km
+ * (metres below 1 km) or mi (feet below 0.1 mi).
  */
 export declare function formatDistance(km: number): string;
 /**

package/dist/movethewheels/utils/moduleSettings.d.ts

@@ -0,0 +1,52 @@
+import { FormatPreferences } from './formatters';
+export type MtwDistanceUnit = 'KM' | 'MI';
+export type MtwWeightUnit = 'KG' | 'LB';
+export type MtwOrderPriority = 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT' | 'CRITICAL';
+export interface MtwModuleSettings {
+    workspaceId: string;
+    defaultCurrency: string;
+    distanceUnit: MtwDistanceUnit;
+    weightUnit: MtwWeightUnit;
+    /** IANA zone; null shows each viewer their own local time. */
+    timezone: string | null;
+    defaultOrderPriority: MtwOrderPriority;
+    defaultDeliveryWindowHours: number;
+    isCustomized: boolean;
+    updatedAt: string | null;
+    updatedBy: string | null;
+}
+export type MtwModuleSettingsInput = Partial<Pick<MtwModuleSettings, 'defaultCurrency' | 'distanceUnit' | 'weightUnit' | 'timezone' | 'defaultOrderPriority' | 'defaultDeliveryWindowHours'>>;
+/** Mirrors the service range for the default delivery window. */
+export declare const DELIVERY_WINDOW_MIN_HOURS = 1;
+export declare const DELIVERY_WINDOW_MAX_HOURS = 720;
+/** The service's platform defaults, shown until the workspace's settings load. */
+export declare function platformDefaults(workspaceId?: string): MtwModuleSettings;
+export declare const MTW_MODULE_SETTINGS_QUERY = "\n  query MtwModuleSettings {\n    mtwModuleSettings {\n      \n  workspaceId\n  defaultCurrency\n  distanceUnit\n  weightUnit\n  timezone\n  defaultOrderPriority\n  defaultDeliveryWindowHours\n  isCustomized\n  updatedAt\n  updatedBy\n\n    }\n  }\n";
+export declare const UPDATE_MTW_MODULE_SETTINGS_MUTATION = "\n  mutation UpdateMtwModuleSettings($input: UpdateMtwModuleSettingsInput!) {\n    updateMtwModuleSettings(input: $input) {\n      \n  workspaceId\n  defaultCurrency\n  distanceUnit\n  weightUnit\n  timezone\n  defaultOrderPriority\n  defaultDeliveryWindowHours\n  isCustomized\n  updatedAt\n  updatedBy\n\n    }\n  }\n";
+/** What the formatters need from the settings. */
+export declare function toFormatPreferences(settings: MtwModuleSettings): FormatPreferences;
+export declare const DISTANCE_UNIT_OPTIONS: ReadonlyArray<{
+    value: MtwDistanceUnit;
+    label: string;
+}>;
+export declare const WEIGHT_UNIT_OPTIONS: ReadonlyArray<{
+    value: MtwWeightUnit;
+    label: string;
+}>;
+export declare const ORDER_PRIORITY_OPTIONS: ReadonlyArray<{
+    value: MtwOrderPriority;
+    label: string;
+}>;
+/** The order form's four priorities for a service priority (CRITICAL shows as urgent). */
+export declare function orderFormPriority(priority: MtwOrderPriority): 'low' | 'normal' | 'high' | 'urgent';
+export declare function currencyOptions(current?: string): string[];
+export declare function currencyLabel(code: string): string;
+export declare function timeZoneOptions(current?: string | null): string[];
+/** The browser's own zone, for the "viewer's local time" option label. */
+export declare function browserTimeZone(): string;
+/** Client-side check of the delivery window before it is sent. */
+export declare function deliveryWindowError(value: string): string | null;
+/** Only the fields that differ from the saved settings. */
+export declare function changedSettings(saved: MtwModuleSettings, draft: MtwModuleSettingsInput): MtwModuleSettingsInput;
+/** A `datetime-local` value `hours` from `from`, in the viewer's clock. */
+export declare function deliveryWindowValue(hours: number, from?: Date): string;

package/dist/node_modules/lucide-react/dist/esm/icons/arrow-down-up.js

@@ -0,0 +1,22 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/arrow-down-up.js
+var t = e("ArrowDownUp", [
+	["path", {
+		d: "m3 16 4 4 4-4",
+		key: "1co6wj"
+	}],
+	["path", {
+		d: "M7 20V4",
+		key: "1yoxec"
+	}],
+	["path", {
+		d: "m21 8-4-4-4 4",
+		key: "1c9v7m"
+	}],
+	["path", {
+		d: "M17 4v16",
+		key: "7dpous"
+	}]
+]);
+//#endregion
+export { t as ArrowDownUp };

package/dist/node_modules/lucide-react/dist/esm/icons/bell.js

@@ -0,0 +1,11 @@
+import { createLucideIcon as e } from "../createLucideIcon.js";
+//#region node_modules/lucide-react/dist/esm/icons/bell.js
+var t = e("Bell", [["path", {
+	d: "M10.268 21a2 2 0 0 0 3.464 0",
+	key: "vwvbt9"
+}], ["path", {
+	d: "M3.262 15.326A1 1 0 0 0 4 17h16a1 1 0 0 0 .74-1.673C19.41 13.956 18 12.499 18 8A6 6 0 0 0 6 8c0 4.499-1.411 5.956-2.738 7.326",
+	key: "11g9vi"
+}]]);
+//#endregion
+export { t as Bell };