@roomwise/calc-engine 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -51,6 +51,66 @@ function toCents(dollars) {
 	return cents;
 }
 //#endregion
+//#region src/variables/room.ts
+function roomVariables(room) {
+	const perimeter = 2 * (room.lengthM + room.widthM);
+	return {
+		length: room.lengthM,
+		width: room.widthM,
+		height: room.heightM,
+		floorArea: room.lengthM * room.widthM,
+		perimeter,
+		wallArea: perimeter * room.heightM,
+		heatedFloor: room.heatedFloor,
+		roomType: room.roomTypeCode
+	};
+}
+//#endregion
+//#region src/variables/object.ts
+const COUNTED_AS_ROOMS = [
+	"LIVING_ROOM",
+	"BEDROOM",
+	"KITCHEN_LIVING"
+];
+const WET_ROOMS = [
+	"BATHROOM",
+	"KITCHEN",
+	"KITCHEN_LIVING"
+];
+function totalAreaOf(scope, totalAreaSqm, roomsFloorArea) {
+	return scope === "PARTIAL" || totalAreaSqm === null ? roomsFloorArea : totalAreaSqm;
+}
+function objectVariables(configuration) {
+	const rooms = configuration.rooms.map(roomVariables);
+	const sum = (pick) => rooms.reduce((total, room) => total + pick(room), 0);
+	const roomsFloorArea = sum((room) => room.floorArea);
+	return {
+		scope: configuration.scope,
+		totalArea: totalAreaOf(configuration.scope, configuration.totalAreaSqm, roomsFloorArea),
+		balconyArea: configuration.balconyAreaSqm,
+		balconyTiles: configuration.balconyTiles,
+		finishLevel: configuration.finishLevel,
+		roomsCount: configuration.rooms.filter((room) => COUNTED_AS_ROOMS.includes(room.roomTypeCode)).length,
+		bathroomsCount: configuration.rooms.filter((room) => room.roomTypeCode === "BATHROOM").length,
+		roomsFloorArea,
+		roomsWallArea: sum((room) => room.wallArea),
+		roomsPerimeter: sum((room) => room.perimeter),
+		wetRoomsCount: rooms.filter((room) => WET_ROOMS.includes(room.roomType)).length
+	};
+}
+//#endregion
+//#region src/variables/product.ts
+function productVariablesOf(product, wastePercent) {
+	return {
+		price: product.priceCents / 100,
+		waste: wastePercent / 100,
+		unit: product.unit
+	};
+}
+function productVariables(product, category) {
+	return productVariablesOf(product, product.wastePercentOverride ?? category.wastePercent);
+}
+//#endregion
 //#region src/estimate/line.ts
 const MAX_LINE_CENTS = 1e10;
 function createLine(init) {
@@ -80,18 +140,25 @@ function failedLine(init, status, error) {
 	});
 }
 function pricedLine(init, dollars) {
-	if (!Number.isFinite(dollars) || dollars < 0 || dollars * 100 > 1e10) return failedLine(init, "ERROR", {
-		code: "AMOUNT_OUT_OF_RANGE",
-		params: { maxCents: MAX_LINE_CENTS }
-	});
-	return createLine({
+	const amountCents = componentCents(dollars);
+	return amountCents === null ? failedLine(init, "ERROR", outOfRange()) : createLine({
 		...init,
-		amountCents: toCents(dollars)
+		amountCents
 	});
 }
 function roundQuantity(quantity) {
 	return Math.round(quantity * 1e3) / 1e3;
 }
+function componentCents(dollars) {
+	if (!Number.isFinite(dollars) || dollars < 0 || dollars * 100 > 1e10) return null;
+	return toCents(dollars);
+}
+function outOfRange() {
+	return {
+		code: "AMOUNT_OUT_OF_RANGE",
+		params: { maxCents: MAX_LINE_CENTS }
+	};
+}
 //#endregion
 //#region src/estimate/line-id.ts
 function lineId(section, ...parts) {
@@ -107,16 +174,39 @@ function unitQuantity(unit, rooms, pieces) {
 		case "ROOM_SQM": return rooms.reduce((sum, room) => sum + room.lengthM * room.widthM, 0);
 	}
 }
-function optionLine(configuration, option, selection) {
+function optionUnitPriceCents(option, coefficients) {
+	if (option.priceCoefficientKeys.length === 0) return option.priceCents;
+	let dollars = 0;
+	for (const key of option.priceCoefficientKeys) {
+		const value = Object.hasOwn(coefficients, key) ? coefficients[key] : void 0;
+		if (value === void 0) return { missingKey: key };
+		dollars += value;
+	}
+	return componentCents(dollars);
+}
+function optionLine(configuration, option, selection, coefficients = {}) {
 	const init = {
 		id: lineId(option.kind, "option", option.id),
 		section: option.kind,
 		optionId: option.id
 	};
+	if (!option.scopes.includes(configuration.scope)) return failedLine(init, "UNAVAILABLE", {
+		code: "OPTION_SCOPE_NOT_ALLOWED",
+		params: {
+			optionId: option.id,
+			scope: configuration.scope
+		}
+	});
 	if (!option.available) return failedLine(init, "UNAVAILABLE", {
 		code: "PRODUCT_UNAVAILABLE",
 		params: { optionId: option.id }
 	});
+	const unitPriceCents = optionUnitPriceCents(option, coefficients);
+	if (unitPriceCents === null) return failedLine(init, "ERROR", outOfRange());
+	if (typeof unitPriceCents !== "number") return failedLine(init, "ERROR", {
+		code: "UNKNOWN_COEFFICIENT",
+		params: { key: unitPriceCents.missingKey }
+	});
 	const selected = configuration.rooms.filter((room) => selection.roomClientIds?.includes(room.clientId));
 	const allowed = option.roomTypeCodes.length === 0 ? selected : selected.filter((room) => option.roomTypeCodes.includes(room.roomTypeCode));
 	const rejected = selected.filter((room) => !allowed.includes(room));
@@ -125,7 +215,7 @@ function optionLine(configuration, option, selection) {
 		...init,
 		quantity: roundQuantity(quantity),
 		unit: option.unit,
-		unitPriceCents: option.priceCents,
+		unitPriceCents,
 		warnings: rejected.map((room) => ({
 			code: "OPTION_ROOM_TYPE_NOT_ALLOWED",
 			params: {
@@ -133,12 +223,12 @@ function optionLine(configuration, option, selection) {
 				roomTypeCode: room.roomTypeCode
 			}
 		}))
-	}, option.priceCents / 100 * quantity);
+	}, unitPriceCents / 100 * quantity);
 }
 function optionLines(configuration, data, kind) {
 	return configuration.options.flatMap((selection) => {
 		const option = data.options.find((item) => item.id === selection.optionId);
-		return option?.kind === kind ? [optionLine(configuration, option, selection)] : [];
+		return option?.kind === kind ? [optionLine(configuration, option, selection, data.coefficients)] : [];
 	});
 }
 //#endregion
@@ -147,29 +237,6 @@ function additionalLines(configuration, data) {
 	return optionLines(configuration, data, "ADDITIONAL");
 }
 //#endregion
-//#region src/estimate/base.ts
-function baseLine(configuration, data) {
-	const init = {
-		id: lineId("BASE"),
-		section: "BASE"
-	};
-	const area = configuration.totalAreaSqm;
-	const rate = data.baseRates.find((candidate) => candidate.finishLevel === configuration.finishLevel && candidate.areaFromSqm <= area && area < candidate.areaToSqm);
-	if (rate === void 0) return failedLine(init, "NOT_CALCULATED", {
-		code: "BASE_RATE_NOT_FOUND",
-		params: {
-			totalAreaSqm: area,
-			finishLevel: configuration.finishLevel
-		}
-	});
-	return pricedLine({
-		...init,
-		quantity: roundQuantity(area),
-		unit: "SQM",
-		unitPriceCents: rate.rateCentsPerSqm
-	}, rate.rateCentsPerSqm / 100 * area);
-}
-//#endregion
 //#region src/estimate/engineering.ts
 function packageLine(configuration, item) {
 	const init = {
@@ -194,51 +261,7 @@ function packageLine(configuration, item) {
 	}, item.priceCents / 100 * quantity);
 }
 function engineeringLines(configuration, data) {
-	return [...data.packageItems.map((item) => packageLine(configuration, item)), ...optionLines(configuration, data, "ENGINEERING")];
-}
-//#endregion
-//#region src/variables/object.ts
-const COUNTED_AS_ROOMS = [
-	"LIVING_ROOM",
-	"BEDROOM",
-	"KITCHEN_LIVING"
-];
-function objectVariables(configuration) {
-	return {
-		totalArea: configuration.totalAreaSqm,
-		balconyArea: configuration.balconyAreaSqm,
-		balconyTiles: configuration.balconyTiles,
-		finishLevel: configuration.finishLevel,
-		roomsCount: configuration.rooms.filter((room) => COUNTED_AS_ROOMS.includes(room.roomTypeCode)).length,
-		bathroomsCount: configuration.rooms.filter((room) => room.roomTypeCode === "BATHROOM").length
-	};
-}
-//#endregion
-//#region src/variables/product.ts
-function productVariablesOf(product, wastePercent) {
-	return {
-		price: product.priceCents / 100,
-		waste: wastePercent / 100,
-		unit: product.unit
-	};
-}
-function productVariables(product, category) {
-	return productVariablesOf(product, product.wastePercentOverride ?? category.wastePercent);
-}
-//#endregion
-//#region src/variables/room.ts
-function roomVariables(room) {
-	const perimeter = 2 * (room.lengthM + room.widthM);
-	return {
-		length: room.lengthM,
-		width: room.widthM,
-		height: room.heightM,
-		floorArea: room.lengthM * room.widthM,
-		perimeter,
-		wallArea: perimeter * room.heightM,
-		heatedFloor: room.heatedFloor,
-		roomType: room.roomTypeCode
-	};
+	return [...(configuration.scope === "PARTIAL" ? data.packageItems.filter((item) => !item.includedInBase) : data.packageItems).map((item) => packageLine(configuration, item)), ...optionLines(configuration, data, "ENGINEERING")];
 }
 //#endregion
 //#region src/formula/language.ts
@@ -672,13 +695,87 @@ function runNumericFormula(source, scope) {
 	};
 }
 //#endregion
+//#region src/estimate/surfaces.ts
+function surfaceRuleOf(data, surface) {
+	return data.rules.filter((rule) => rule.level === "SURFACE" && rule.surface === surface).sort((a, b) => a.sortOrder - b.sortOrder)[0];
+}
+function failedWith(line, error) {
+	return failedLine({
+		id: line.id,
+		section: line.section,
+		roomClientId: line.roomClientId,
+		categoryId: line.categoryId,
+		productId: line.productId,
+		ruleId: line.ruleId,
+		warnings: line.warnings
+	}, "ERROR", error);
+}
+function withComponent(line, component) {
+	const components = [...line.components ?? [], component];
+	const amountCents = components.reduce((sum, item) => sum + item.amountCents, 0);
+	if (amountCents > 1e10) return failedWith(line, outOfRange());
+	return {
+		...line,
+		components,
+		amountCents
+	};
+}
+function applySurfacePrep(data, room, lines, objectScope) {
+	const result = [...lines];
+	const variables = {
+		...roomVariables(room),
+		...objectScope
+	};
+	const areas = {
+		FLOOR: variables.floorArea,
+		CEILING: variables.floorArea,
+		WALLS: variables.wallArea
+	};
+	const surfaces = /* @__PURE__ */ new Map();
+	lines.forEach((line, index) => {
+		const surface = data.categories.find((category) => category.id === line.categoryId)?.surface;
+		if (line.status === "OK" && surface !== void 0 && surface !== "NONE") surfaces.set(surface, [...surfaces.get(surface) ?? [], index]);
+	});
+	for (const [surface, indexes] of surfaces) {
+		const rule = surfaceRuleOf(data, surface);
+		if (rule === void 0) continue;
+		const outcome = runNumericFormula(rule.costFormula, {
+			variables: {
+				...variables,
+				surfaceArea: areas[surface]
+			},
+			coefficients: data.coefficients
+		});
+		const cents = outcome.ok ? componentCents(outcome.value) : null;
+		const carrierCategoryId = lines[indexes[0]]?.categoryId ?? null;
+		indexes.forEach((index, position) => {
+			const line = lines[index];
+			if (!outcome.ok || cents === null) {
+				result[index] = failedWith(line, outcome.ok ? outOfRange() : outcome.error);
+				return;
+			}
+			result[index] = withComponent(line, position === 0 ? {
+				kind: "PREP",
+				ruleId: rule.id,
+				amountCents: cents
+			} : {
+				kind: "PREP",
+				ruleId: rule.id,
+				amountCents: 0,
+				sharedWithCategoryId: carrierCategoryId ?? void 0
+			});
+		});
+	}
+	return result;
+}
+//#endregion
 //#region src/estimate/materials.ts
 const isMaterialRule = (rule) => rule.quantityFormula !== null;
 function selectRule(data, categoryId, materialTypeId) {
 	const rules = data.rules.filter(isMaterialRule);
 	return rules.find((rule) => rule.level === "MATERIAL_TYPE" && rule.categoryId === categoryId && rule.materialTypeId === materialTypeId) ?? rules.find((rule) => rule.level === "CATEGORY" && rule.categoryId === categoryId);
 }
-function materialLine(configuration, data, room, categoryId, productId) {
+function materialLine(configuration, data, room, categoryId, productId, objectScope) {
 	const init = {
 		id: lineId("MATERIALS", room.clientId, categoryId),
 		section: "MATERIALS",
@@ -710,7 +807,7 @@ function materialLine(configuration, data, room, categoryId, productId) {
 	const variables = {
 		...roomVariables(room),
 		...productVariables(product, category),
-		...objectVariables(configuration)
+		...objectScope
 	};
 	const { coefficients } = data;
 	const ruled = {
@@ -731,32 +828,74 @@ function materialLine(configuration, data, room, categoryId, productId) {
 		coefficients
 	});
 	if (!cost.ok) return failedLine(ruled, "ERROR", cost.error);
-	return pricedLine({
+	const materialCents = componentCents(cost.value);
+	if (materialCents === null) return failedLine(ruled, "ERROR", outOfRange());
+	const components = [{
+		kind: "MATERIAL",
+		ruleId: rule.id,
+		amountCents: materialCents
+	}];
+	const lineWarnings = [...warnings];
+	if (configuration.scope === "PARTIAL") {
+		let laborCents = 0;
+		if (rule.laborFormula === null) lineWarnings.push({
+			code: "LABOR_RATE_MISSING",
+			params: { categoryId }
+		});
+		else {
+			const labor = runNumericFormula(rule.laborFormula, {
+				variables: {
+					...variables,
+					quantity: quantity.value
+				},
+				coefficients
+			});
+			if (!labor.ok) return failedLine(ruled, "ERROR", labor.error);
+			const cents = componentCents(labor.value);
+			if (cents === null) return failedLine(ruled, "ERROR", outOfRange());
+			laborCents = cents;
+		}
+		components.push({
+			kind: "LABOR",
+			ruleId: rule.id,
+			amountCents: laborCents
+		});
+	}
+	const amountCents = components.reduce((sum, component) => sum + component.amountCents, 0);
+	if (amountCents > 1e10) return failedLine(ruled, "ERROR", outOfRange());
+	return createLine({
 		...ruled,
+		warnings: lineWarnings,
 		quantity: roundQuantity(quantity.value),
 		unit: product.unit,
-		unitPriceCents: product.priceCents
-	}, cost.value);
+		unitPriceCents: product.priceCents,
+		amountCents,
+		components
+	});
 }
-function materialLines(configuration, data) {
-	return configuration.rooms.flatMap((room) => room.selections.flatMap(({ categoryId, productId }) => productId === null ? [] : [materialLine(configuration, data, room, categoryId, productId)]));
+function materialLines(configuration, data, objectScope) {
+	return configuration.rooms.flatMap((room) => {
+		const lines = room.selections.flatMap(({ categoryId, productId }) => productId === null ? [] : [materialLine(configuration, data, room, categoryId, productId, objectScope)]);
+		return configuration.scope === "PARTIAL" ? applySurfacePrep(data, room, lines, objectScope) : lines;
+	});
 }
 //#endregion
 //#region src/estimate/object-rules.ts
-function objectRuleLines(configuration, data) {
+function objectRuleLines(configuration, data, section, variables) {
+	if (section === "BASE" && configuration.scope !== "FULL") return [];
 	const scope = {
-		variables: objectVariables(configuration),
+		variables,
 		coefficients: data.coefficients
 	};
-	return data.rules.filter((rule) => rule.level === "OBJECT").sort((a, b) => a.sortOrder - b.sortOrder).map((rule) => {
+	return data.rules.filter((rule) => rule.level === "OBJECT" && rule.baseComponent === (section === "BASE")).sort((a, b) => a.sortOrder - b.sortOrder).map((rule) => {
 		const init = {
-			id: lineId("OBJECT", rule.id),
-			section: "OBJECT",
+			id: lineId(section, rule.id),
+			section,
 			ruleId: rule.id
 		};
 		const outcome = runNumericFormula(rule.costFormula, scope);
 		return outcome.ok ? pricedLine(init, outcome.value) : failedLine(init, "ERROR", outcome.error);
-	});
+	}).filter((line) => section !== "BASE" || line.status !== "OK" || line.amountCents !== 0);
 }
 //#endregion
 //#region src/schemas/common.ts
@@ -764,11 +903,17 @@ const LocalizedTextSchema = zod.z.object({
 	en: zod.z.string(),
 	uk: zod.z.string()
 });
-const FinishLevelSchema = zod.z.enum(["ROUGH", "PRE_FINISH"]);
+const ScopeSchema = zod.z.enum(["FULL", "PARTIAL"]);
+const FinishLevelSchema = zod.z.enum([
+	"ROUGH",
+	"PRE_FINISH",
+	"LIVED_IN"
+]);
 const RuleLevelSchema = zod.z.enum([
 	"OBJECT",
 	"CATEGORY",
-	"MATERIAL_TYPE"
+	"MATERIAL_TYPE",
+	"SURFACE"
 ]);
 const RateSourceSchema = zod.z.enum(["NBU", "MANUAL"]);
 const SurfaceKindSchema = zod.z.enum([
@@ -795,7 +940,9 @@ const RoomTypeCodeSchema = zod.z.enum([
 	"BEDROOM",
 	"KITCHEN",
 	"KITCHEN_LIVING",
-	"BATHROOM"
+	"BATHROOM",
+	"HALLWAY",
+	"STORAGE"
 ]);
 const CurrencySchema = zod.z.enum(["USD", "UAH"]);
 const SectionSchema = zod.z.enum([
@@ -805,6 +952,11 @@ const SectionSchema = zod.z.enum([
 	"ENGINEERING",
 	"ADDITIONAL"
 ]);
+const LineComponentKindSchema = zod.z.enum([
+	"MATERIAL",
+	"LABOR",
+	"PREP"
+]);
 const LineStatusSchema = zod.z.enum([
 	"OK",
 	"INCLUDED",
@@ -848,8 +1000,9 @@ function duplicateIndexes(items, key) {
 	});
 }
 const ConfigurationSchema = zod.z.object({
+	scope: ScopeSchema.default("FULL"),
 	finishLevel: FinishLevelSchema,
-	totalAreaSqm: zod.z.number().positive(),
+	totalAreaSqm: zod.z.number().positive().nullable(),
 	balconyAreaSqm: zod.z.number().min(0),
 	balconyTiles: zod.z.boolean(),
 	rooms: zod.z.array(RoomConfigurationSchema),
@@ -861,6 +1014,11 @@ const ConfigurationSchema = zod.z.object({
 		path,
 		message: "Duplicate"
 	});
+	if (configuration.scope === "FULL" !== (configuration.totalAreaSqm !== null)) ctx.addIssue({
+		code: "custom",
+		path: ["totalAreaSqm"],
+		message: configuration.scope === "FULL" ? "Required" : "Not allowed"
+	});
 	for (const index of duplicateIndexes(configuration.rooms, (room) => room.clientId)) addDuplicate([
 		"rooms",
 		index,
@@ -892,13 +1050,8 @@ const PricingLimitsSchema = zod.z.object({
 	totalAreaSqm: RangeSchema,
 	rooms: RangeSchema,
 	roomSideM: RangeSchema,
-	roomHeightM: RangeSchema
-});
-const BaseRateSchema = zod.z.object({
-	finishLevel: FinishLevelSchema,
-	areaFromSqm: zod.z.number().min(0),
-	areaToSqm: zod.z.number(),
-	rateCentsPerSqm: zod.z.int().positive()
+	roomHeightM: RangeSchema,
+	missingAreaHintSqm: zod.z.number().min(0)
 });
 const PricingRuleSchema = zod.z.object({
 	id: zod.z.string(),
@@ -907,9 +1060,16 @@ const PricingRuleSchema = zod.z.object({
 	materialTypeId: zod.z.string().nullable(),
 	name: LocalizedTextSchema,
 	quantityFormula: zod.z.string().nullable(),
+	surface: zod.z.enum([
+		"FLOOR",
+		"WALLS",
+		"CEILING"
+	]).nullable(),
+	baseComponent: zod.z.boolean(),
 	costFormula: zod.z.string().max(500),
+	laborFormula: zod.z.string().max(500).nullable(),
 	sortOrder: zod.z.int()
-}).refine((rule) => rule.level === "OBJECT" === (rule.quantityFormula === null), { path: ["quantityFormula"] });
+}).refine((rule) => (rule.level === "OBJECT" || rule.level === "SURFACE") === (rule.quantityFormula === null), { path: ["quantityFormula"] }).refine((rule) => rule.level === "SURFACE" === (rule.surface !== null), { path: ["surface"] }).refine((rule) => rule.level !== "SURFACE" || rule.categoryId === null, { path: ["categoryId"] }).refine((rule) => !rule.baseComponent || rule.level === "OBJECT", { path: ["baseComponent"] }).refine((rule) => rule.laborFormula === null || rule.level === "CATEGORY" || rule.level === "MATERIAL_TYPE", { path: ["laborFormula"] });
 const PricingRoomTypeSchema = zod.z.object({
 	id: zod.z.string(),
 	code: zod.z.string()
@@ -946,6 +1106,8 @@ const PricingOptionSchema = zod.z.object({
 	priceCents: CentsSchema,
 	unit: OptionUnitSchema,
 	roomTypeCodes: zod.z.array(zod.z.string()),
+	priceCoefficientKeys: zod.z.array(zod.z.string()),
+	scopes: zod.z.array(ScopeSchema).min(1),
 	minQuantity: zod.z.int().nullable(),
 	maxQuantity: zod.z.int().nullable(),
 	available: zod.z.boolean()
@@ -954,7 +1116,6 @@ const PricingDataSchema = zod.z.object({
 	version: zod.z.string().regex(/^[0-9a-f]{16}$/),
 	exchangeRate: ExchangeRateSchema.nullable(),
 	limits: PricingLimitsSchema,
-	baseRates: zod.z.array(BaseRateSchema),
 	coefficients: zod.z.record(zod.z.string(), zod.z.number()),
 	rules: zod.z.array(PricingRuleSchema),
 	roomTypes: zod.z.array(PricingRoomTypeSchema),
@@ -970,6 +1131,12 @@ const EstimateMessageSchema = zod.z.object({
 	code: zod.z.string(),
 	params: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 });
+const LineComponentSchema = zod.z.object({
+	kind: LineComponentKindSchema,
+	ruleId: zod.z.string(),
+	amountCents: zod.z.number().int().min(0),
+	sharedWithCategoryId: zod.z.string().optional()
+});
 const EstimateLineSchema = zod.z.object({
 	id: zod.z.string(),
 	section: SectionSchema,
@@ -985,6 +1152,7 @@ const EstimateLineSchema = zod.z.object({
 	unitPriceCents: CentsSchema.nullable(),
 	amountCents: CentsSchema,
 	amountUahKopecks: CentsSchema.nullable(),
+	components: zod.z.array(LineComponentSchema).optional(),
 	warnings: zod.z.array(EstimateMessageSchema),
 	error: EstimateMessageSchema.nullable()
 });
@@ -1022,18 +1190,32 @@ const RuleSampleSchema = zod.z.object({
 		unit: ProductUnitSchema,
 		wastePercent: zod.z.number().min(0)
 	}).optional(),
+	surfaceArea: zod.z.number().min(0).optional(),
 	object: zod.z.object({
-		totalAreaSqm: zod.z.number().positive(),
+		scope: ScopeSchema,
+		totalAreaSqm: zod.z.number().positive().nullable(),
 		balconyAreaSqm: zod.z.number().min(0),
 		balconyTiles: zod.z.boolean(),
 		finishLevel: FinishLevelSchema,
 		roomsCount: zod.z.int().min(0),
-		bathroomsCount: zod.z.int().min(0)
+		bathroomsCount: zod.z.int().min(0),
+		roomsFloorArea: zod.z.number().min(0),
+		roomsWallArea: zod.z.number().min(0),
+		roomsPerimeter: zod.z.number().min(0),
+		wetRoomsCount: zod.z.int().min(0)
 	})
+}).superRefine((sample, ctx) => {
+	const { scope, totalAreaSqm } = sample.object;
+	if (scope === "FULL" !== (totalAreaSqm !== null)) ctx.addIssue({
+		code: "custom",
+		path: ["object", "totalAreaSqm"],
+		message: scope === "FULL" ? "Required" : "Not allowed"
+	});
 });
 const RulePreviewSchema = zod.z.object({
 	quantity: zod.z.number().nullable(),
 	amountCents: CentsSchema.nullable(),
+	laborCents: CentsSchema.nullable(),
 	variables: zod.z.record(zod.z.string(), zod.z.union([
 		zod.z.number(),
 		zod.z.boolean(),
@@ -1068,20 +1250,28 @@ function isIncomplete(lines) {
 }
 //#endregion
 //#region src/estimate/warnings.ts
-function roomsAreaWarnings(configuration) {
-	const roomsAreaSqm = Math.round(configuration.rooms.reduce((sum, room) => sum + roomVariables(room).floorArea, 0) * 1e4) / 1e4;
-	return roomsAreaSqm > configuration.totalAreaSqm ? [{
+const roundArea = (value) => Math.round(value * 1e4) / 1e4;
+function roomsAreaWarnings(configuration, limits) {
+	const totalAreaSqm = configuration.totalAreaSqm;
+	if (configuration.scope !== "FULL" || totalAreaSqm === null) return [];
+	const roomsAreaSqm = roundArea(configuration.rooms.reduce((sum, room) => sum + roomVariables(room).floorArea, 0));
+	if (roomsAreaSqm > totalAreaSqm) return [{
 		code: "ROOMS_AREA_EXCEEDS_TOTAL",
 		params: {
 			roomsAreaSqm,
-			totalAreaSqm: configuration.totalAreaSqm
+			totalAreaSqm
 		}
+	}];
+	const missingSqm = roundArea(totalAreaSqm - roomsAreaSqm);
+	return missingSqm > limits.missingAreaHintSqm ? [{
+		code: "ROOMS_AREA_BELOW_TOTAL",
+		params: { missingSqm }
 	}] : [];
 }
-function estimateWarnings(lines, configuration, rate) {
+function estimateWarnings(lines, configuration, rate, limits) {
 	return [
 		...collectWarnings(lines),
-		...roomsAreaWarnings(configuration),
+		...roomsAreaWarnings(configuration, limits),
 		...configuration.currency === "UAH" && rate === null ? [{ code: "EXCHANGE_RATE_UNAVAILABLE" }] : []
 	];
 }
@@ -1095,10 +1285,11 @@ function withKopecks(line, rate) {
 }
 function estimate(configuration, data) {
 	const rate = data.exchangeRate?.rate ?? null;
+	const variables = objectVariables(configuration);
 	const lines = [
-		baseLine(configuration, data),
-		...objectRuleLines(configuration, data),
-		...materialLines(configuration, data),
+		...objectRuleLines(configuration, data, "BASE", variables),
+		...objectRuleLines(configuration, data, "OBJECT", variables),
+		...materialLines(configuration, data, variables),
 		...engineeringLines(configuration, data),
 		...additionalLines(configuration, data)
 	].map((line) => withKopecks(line, rate));
@@ -1108,7 +1299,7 @@ function estimate(configuration, data) {
 		exchangeRate: data.exchangeRate,
 		lines,
 		totals: computeTotals(lines, rate !== null),
-		warnings: estimateWarnings(lines, configuration, rate),
+		warnings: estimateWarnings(lines, configuration, rate, data.limits),
 		incomplete: isIncomplete(lines)
 	};
 }
@@ -1123,8 +1314,9 @@ function checkLimits(configuration, limits, options = []) {
 			max
 		});
 	};
-	check("totalAreaSqm", configuration.totalAreaSqm, limits.totalAreaSqm.min, limits.totalAreaSqm.max);
-	check("balconyAreaSqm", configuration.balconyAreaSqm, 0, configuration.totalAreaSqm);
+	const isFull = configuration.scope === "FULL";
+	if (isFull && configuration.totalAreaSqm !== null) check("totalAreaSqm", configuration.totalAreaSqm, limits.totalAreaSqm.min, limits.totalAreaSqm.max);
+	check("balconyAreaSqm", configuration.balconyAreaSqm, 0, isFull && configuration.totalAreaSqm !== null ? configuration.totalAreaSqm : limits.totalAreaSqm.max);
 	check("rooms", configuration.rooms.length, limits.rooms.min, limits.rooms.max);
 	configuration.rooms.forEach((room, index) => {
 		const path = `rooms[${index}]`;
@@ -1180,17 +1372,33 @@ function referencesOf(sources) {
 }
 function objectScope({ object }) {
 	return {
-		totalArea: object.totalAreaSqm,
+		scope: object.scope,
+		totalArea: totalAreaOf(object.scope, object.totalAreaSqm, object.roomsFloorArea),
 		balconyArea: object.balconyAreaSqm,
 		balconyTiles: object.balconyTiles,
 		finishLevel: object.finishLevel,
 		roomsCount: object.roomsCount,
-		bathroomsCount: object.bathroomsCount
+		bathroomsCount: object.bathroomsCount,
+		roomsFloorArea: object.roomsFloorArea,
+		roomsWallArea: object.roomsWallArea,
+		roomsPerimeter: object.roomsPerimeter,
+		wetRoomsCount: object.wetRoomsCount
 	};
 }
 function scopeOf(level, sample) {
 	if (level === "OBJECT") return { scope: objectScope(sample) };
-	const { room, product } = sample;
+	const { room, product, surfaceArea } = sample;
+	if (level === "SURFACE") {
+		if (room === void 0 || surfaceArea === void 0) return { error: {
+			code: "SAMPLE_INCOMPLETE",
+			params: { missing: room === void 0 ? "room" : "surfaceArea" }
+		} };
+		return { scope: {
+			...roomVariables(room),
+			...objectScope(sample),
+			surfaceArea
+		} };
+	}
 	if (room === void 0 || product === void 0) return { error: {
 		code: "SAMPLE_INCOMPLETE",
 		params: { missing: room === void 0 ? "room" : "product" }
@@ -1206,15 +1414,21 @@ function pick(source, names) {
 }
 function previewRule(input) {
 	const { level, quantityFormula, costFormula, coefficients } = input;
-	const references = referencesOf([quantityFormula, costFormula]);
-	const report = (variables, quantity, amountCents, error) => ({
+	const laborFormula = quantityFormula === null ? null : input.laborFormula ?? null;
+	const references = referencesOf([
+		quantityFormula,
+		costFormula,
+		laborFormula
+	]);
+	const report = (variables, quantity, amountCents, error, laborCents = null) => ({
 		quantity,
 		amountCents,
+		laborCents,
 		variables: pick(variables, references.variables),
 		coefficients: pick(coefficients, references.coefficients),
 		error
 	});
-	if (level === "OBJECT" !== (quantityFormula === null)) return report({}, null, null, { code: "QUANTITY_FORMULA_MISMATCH" });
+	if ((level === "OBJECT" || level === "SURFACE") !== (quantityFormula === null)) return report({}, null, null, { code: "QUANTITY_FORMULA_MISMATCH" });
 	const prepared = scopeOf(level, input.sample);
 	if ("error" in prepared) return report({}, null, null, prepared.error);
 	let variables = prepared.scope;
@@ -1240,7 +1454,15 @@ function previewRule(input) {
 		id: "preview",
 		section: "OBJECT"
 	}, cost.value);
-	return line.error === null ? report(variables, quantity, line.amountCents, null) : report(variables, quantity, null, line.error);
+	if (line.error !== null) return report(variables, quantity, null, line.error);
+	if (laborFormula === null) return report(variables, quantity, line.amountCents, null);
+	const labor = runNumericFormula(laborFormula, {
+		variables,
+		coefficients
+	});
+	if (!labor.ok) return report(variables, quantity, line.amountCents, labor.error);
+	const laborCents = componentCents(labor.value);
+	return laborCents === null ? report(variables, quantity, line.amountCents, outOfRange()) : report(variables, quantity, line.amountCents, null, laborCents);
 }
 //#endregion
 //#region src/formula/suggest.ts
@@ -1312,10 +1534,16 @@ const FORMULA_SCOPE_VARIABLES = {
 		boolean("balconyTiles"),
 		enumeration("finishLevel", FinishLevelSchema.options),
 		number("roomsCount"),
-		number("bathroomsCount")
+		number("bathroomsCount"),
+		enumeration("scope", ScopeSchema.options),
+		number("roomsFloorArea"),
+		number("roomsWallArea"),
+		number("roomsPerimeter"),
+		number("wetRoomsCount")
 	]
 };
 const FORMULA_QUANTITY_VARIABLE = number("quantity");
+const FORMULA_SURFACE_AREA_VARIABLE = number("surfaceArea");
 const FORMULA_VARIABLES = {
 	OBJECT: FORMULA_SCOPE_VARIABLES.object,
 	CATEGORY: [
@@ -1327,9 +1555,14 @@ const FORMULA_VARIABLES = {
 		...FORMULA_SCOPE_VARIABLES.room,
 		...FORMULA_SCOPE_VARIABLES.product,
 		...FORMULA_SCOPE_VARIABLES.object
+	],
+	SURFACE: [
+		...FORMULA_SCOPE_VARIABLES.room,
+		...FORMULA_SCOPE_VARIABLES.object,
+		FORMULA_SURFACE_AREA_VARIABLE
 	]
 };
-const ALL_VARIABLE_NAMES = new Set(FORMULA_VARIABLES.CATEGORY.map((variable) => variable.name));
+const ALL_VARIABLE_NAMES = new Set([...FORMULA_VARIABLES.CATEGORY, ...FORMULA_VARIABLES.SURFACE].map((variable) => variable.name));
 function span(node) {
 	return {
 		position: node.start,
@@ -1353,7 +1586,7 @@ function validateFormula(input) {
 	const knownCoefficients = new Set(input.coefficientKeys);
 	const usedCoefficients = /* @__PURE__ */ new Set();
 	const errors = [];
-	const quantityAllowed = input.kind === "cost" && input.level !== "OBJECT";
+	const quantityAllowed = input.kind !== "quantity" && (input.level === "CATEGORY" || input.level === "MATERIAL_TYPE");
 	function mismatch(node, expected) {
 		errors.push({
 			code: "FORMULA_SYNTAX",
@@ -1541,7 +1774,6 @@ function validateFormula(input) {
 	};
 }
 //#endregion
-exports.BaseRateSchema = BaseRateSchema;
 exports.COEFFICIENT_NAMESPACE = COEFFICIENT_NAMESPACE;
 exports.CentsSchema = CentsSchema;
 exports.ConfigurationSchema = ConfigurationSchema;
@@ -1557,8 +1789,11 @@ exports.FORMULA_FUNCTION_TABLE = FORMULA_FUNCTION_TABLE;
 exports.FORMULA_LIMITS = FORMULA_LIMITS;
 exports.FORMULA_QUANTITY_VARIABLE = FORMULA_QUANTITY_VARIABLE;
 exports.FORMULA_SCOPE_VARIABLES = FORMULA_SCOPE_VARIABLES;
+exports.FORMULA_SURFACE_AREA_VARIABLE = FORMULA_SURFACE_AREA_VARIABLE;
 exports.FORMULA_VARIABLES = FORMULA_VARIABLES;
 exports.FinishLevelSchema = FinishLevelSchema;
+exports.LineComponentKindSchema = LineComponentKindSchema;
+exports.LineComponentSchema = LineComponentSchema;
 exports.LineStatusSchema = LineStatusSchema;
 exports.LocalizedTextSchema = LocalizedTextSchema;
 exports.OptionCodeSchema = OptionCodeSchema;
@@ -1583,6 +1818,7 @@ exports.RoomTypeCodeSchema = RoomTypeCodeSchema;
 exports.RuleLevelSchema = RuleLevelSchema;
 exports.RulePreviewSchema = RulePreviewSchema;
 exports.RuleSampleSchema = RuleSampleSchema;
+exports.ScopeSchema = ScopeSchema;
 exports.SectionSchema = SectionSchema;
 exports.SectionTotalSchema = SectionTotalSchema;
 exports.SurfaceKindSchema = SurfaceKindSchema;
@@ -1599,4 +1835,5 @@ exports.productVariablesOf = productVariablesOf;
 exports.roomVariables = roomVariables;
 exports.suggestNearest = suggestNearest;
 exports.toCents = toCents;
+exports.totalAreaOf = totalAreaOf;
 exports.validateFormula = validateFormula;